Wichtig: Nach der Erstellung und Bearbeitung eines Skriptes, testen Sie die Kompilierung des Skriptes. Damit ein Skript wirkt, kompilieren Sie die Skripte der Skriptbibliothek.
HINWEIS: Umfangreiche Beispiele für die Syntax und die Verwendung von Skripten finden Sie auf dem Installationsmedium im Verzeichnis QBM\dvd\AddOn\SDK\ScriptSamples.
Um ein neues Skript zu erstellen
-
Wählen Sie im Designer die Kategorie Skriptbibliothek.
-
Starten Sie den Skripteditor über die Aufgabe Ein neues Skript erstellen.
-
Bearbeiten Sie die Stammdaten.
Tabelle 140: Stammdaten des Skript
|
Skript |
Name des Skriptes. Kennzeichnen Sie kundenspezifische Skripte mit dem Präfix CCC_. |
|
Beschreibung |
Nähere Beschreibung zur Funktion des Skriptes |
|
Skriptcode |
Die One Identity Manager-Skripte werden in VB.Net-Syntax abgelegt, was die Nutzung aller VB.Net-Funktionen zulässt. Die zu verarbeitenden Werte werden als Präprozessoranweisungen angegeben. |
|
Gesperrt |
Gibt an, ob das Skript gesperrt ist und nicht verwendet werden darf. Eine Sperrung ist beispielsweise sinnvoll, wenn das Skript noch in Bearbeitung ist. |
Um ein Skript zu bearbeiten
-
Wählen Sie im Designer in der Kategorie Skriptbibliothek das Skript.
-
Wählen Sie die Aufgabe Skript bearbeiten.
-
Bearbeiten Sie die Stammdaten des Skriptes.
Detaillierte Informationen zum Thema
Wichtig: Nach der Erstellung und Bearbeitung eines Skriptes, testen Sie die Kompilierung des Skriptes. Damit ein Skript wirkt, kompilieren Sie die Skripte der Skriptbibliothek.
Um ein vorhandenes Skript zu kopieren
-
Wählen Sie im Designer in der Kategorie Skriptbibliothek das Skript, welches Sie kopieren möchten.
-
Wählen Sie die Aufgabe Skript kopieren.
-
Prüfen Sie im Dialog Skript kopieren die folgenden Informationen und passen Sie diese bei Bedarf an.
Tabelle 141: Kopieren eines Skriptes
|
Alter Skriptname |
Name des kopierten Skriptes. |
|
Skript |
Der Name des neuen Skriptes wird aus dem Präfix CCC_ und dem Namen des alten Skriptes gebildet. Sie können den Namen anpassen. Kennzeichnen Sie kundenspezifische Skripte mit dem Präfix CCC_. |
|
Skriptcode |
Der Skriptcode des originalen Skriptes wird übernommen. Bei Bedarf können Sie den zu kopierenden Skriptcode bereits anpassen. |
-
Um die Kopie zu erstellen, klicken Sie OK.
-
Bearbeiten Sie im Skripteditor die Stammdaten des Skriptes.
Verwandte Themen
Zum Testen eines Skriptes können Sie den Skripteditor verwenden.
Um ein Skript zu testen
-
Wählen Sie im Designer in der Kategorie Skriptbibliothek das Skript.
-
Wählen Sie die Aufgabe Skript bearbeiten.
-
Wählen Sie den Menüeintrag Ansicht > Skript testen.
-
Wählen Sie in der Ansicht Skript testen in der Auswahlliste das Skript und passen Sie die Parameter für das Skript an.
Alle Übergabeparameter des Skriptes und deren Datentyp werden angezeigt und können mit Werten belegt werden. Zusätzlich können die Variablen Base und Value der Skript-Basisklasse als Eingabeparameter vorbelegt werden, um im Skript damit zu arbeiten.
-
Wählen Sie über die Optionen eine oder mehrere der folgenden Optionen zur Ausführung des Tests.
-
Hauptdatenbankverbindung verwenden: Gibt an, ob die Skript-Tests gegen die Hauptdatenbank oder gegen die interne SQLite-Datenbank getestet werden. Skripte, die sich auf den Anwendungsanteil des One Identity Manager-Datenmodells beziehen, sollten Sie immer gegen die Hauptdatenbank ausführen. Skripte für den Systemanteil können Sie gegen die Hauptdatenbank oder die interne SQLite-Datenbank testen.
-
Transaktion verwenden: Gibt an, ob die Ausführung des Skriptes innerhalb einer Transaktion mit anschließendem Rollback erfolgt oder ob das Skript direkt gegen die Datenbank ausgeführt wird.
-
SQL Protokoll aufzeichnen: Gibt an, ob bei der Ausführung des Skriptes die Datenbankaktionen im SQL Protokoll aufzuzeichnen sind. Die Ausgabe erfolgt in einem separaten Dialogfenster. Zusätzlich zum ausgeführten Statement wird die Ausführungszeit des Skriptes ausgegeben.
-
Starten Sie den Test über die Schaltfläche Start.
Nach Ausführung eines Skriptes wird das Ergebnis im Eingabefeld Ergebnis angezeigt.
Verwandte Themen
Haben Sie ein neues Skript erstellt, müssen Sie dieses Skript kompilieren. Erst durch die Kompilierung wird das Skript generierbar. Im Skripteditor können Sie die Skriptkompilierung testen.
Um die Skriptkompilierung zu testen
-
Wählen Sie im Designer in der Kategorie Skriptbibliothek das Skript.
-
Wählen Sie die Aufgabe Skript bearbeiten.
-
Starten Sie den Kompiliervorgang über das Symbol 
, den Menüeintrag Skript > Skript kompilieren oder F9.
Bei der Kompilierung werden alle Skripte übersetzt. Bei der Kompilierung werden die Assemblies erstellt und lokal auf der Arbeitsstation, auf der die Generierung durchgeführt wird, abgelegt. Während der Übersetzung wird eine Gültigkeitskontrolle des Skriptcodes durchgeführt. Der Vorgang kann daher etwas Zeit in Anspruch nehmen.
Fehlermeldungen werden in der Ansicht Compilerfehler ausgegeben. Durch Maus-Doppelklick auf eine Fehlermeldung in der Ansicht wird im Skriptcode zum entsprechenden Eintrag gesprungen. Dieser kann hier angepasst werden.
WICHTIG: Nach dem Testen des Skriptes übernehmen Sie das Skript in die One Identity Manager-Datenbank und führen eine Skriptkompilierung mit dem Database Compiler durch. Ausführliche Informationen finden Sie im One Identity Manager Administrationshandbuch für betriebsunterstützende Aufgaben.
