Chat now with support
Chat mit Support

Identity Manager 9.3 - Konfigurationshandbuch

Über dieses Handbuch Softwarearchitektur des One Identity Manager Kundenspezifische Änderungen an der One Identity Manager Standardkonfiguration Anpassen der One Identity Manager Basiskonfiguration Grundlagen zum One Identity Manager Schema
Übersicht über das One Identity Manager Schema Tabellenarten und Standardspalten im One Identity Manager Datenmodell Hinweise zur Bearbeitung von Tabellendefinitionen und Spaltendefinitionen Tabellendefinitionen Spaltendefinitionen Tabellenbeziehungen Dynamische Fremdschlüssel Unterstützung von Dateigruppen
Volltextsuche im One Identity Manager Lokalisierung im One Identity Manager Prozess-Orchestrierung im One Identity Manager
Abbildung von Prozessen im One Identity Manager
Bearbeiten von Prozessen mit dem Prozesseditor Definieren von Prozessen Prozessgenerierung simulieren Gültigkeitsprüfung eines Prozesses Kompilieren von Prozessen testen Änderungen von Prozessen übernehmen und kompilieren Verwenden von prozesslokalen Variablen und globalen Variablen für die Prozessdefinition Schwellwerte für die Verarbeitung von Prozessen Festlegen des ausführenden Servers Benachrichtigung zur Verarbeitung von Prozessschritten Automatisierte Ausführung von Prozessen Übersicht über die Prozesskomponenten
Einrichten von Jobservern
Arbeitsweise des One Identity Manager Service Prozessüberwachung zur Nachverfolgung von Änderungen Bedingte Kompilierung mittels Präprozessorbedingungen Skripte im One Identity Manager
Verwendung von Visual Basic .NET-Skripten Hinweise zur Verwendung von Datumswerten Hinweise zur Verwendung von PowerShell Skripten Verwendung der $-Notation Verwendung von base Objekt Aufruf von Funktionen Prä-Skripte zur Verwendung in Prozessen und Prozessschritten Verwendung von Session Services Verwendung der #LD-Notation Anzeigen von Meldungen in der Benutzeroberfläche Referenzieren von Paketen und Dateien in Skripten Skriptbibliothek Unterstützung bei der Bearbeitung von Skripten im Skripteditor Skripte mit dem Skripteditor erstellen und bearbeiten Skripte im Skripteditor kopieren Skripte im Skripteditor testen Kompilieren von Skripten im Skripteditor testen Änderungen von Skripten übernehmen und kompilieren Überschreiben von Skripten Berechtigungen zu Ausführen von Skripten Bearbeiten und Testen von Skriptcode mit dem System Debugger Erweitertes Debugging im Object Browser
One Identity Manager Abfragesprache Bearbeiten der Benutzeroberfläche
Objektdefinitionen für die Benutzeroberfläche Menüführung der Benutzeroberfläche Formulare für die Benutzeroberfläche Statistiken im One Identity Manager Erweitern des Launchpad Methodendefinitionen für die Benutzeroberfläche Anwendungen für die Gestaltung der Benutzeroberfläche Symbole und Bilder für die Gestaltung der Benutzeroberfläche Verwenden vordefinierter Datenbankabfragen
Berichte im One Identity Manager Erweiterung des One Identity Manager Schemas um kundenspezifische Tabellen oder Spalten Webservice Integration One Identity Manager als SCIM 2.0 Serviceprovider Verarbeitung von DBQueue Prozessor-Aufträgen Aufbau der Konfigurationsdatei Jobservice.cfg

Referenzieren von Paketen und Dateien in Skripten

Um Pakete und Dateien in Skripten zu referenzieren, wird die #R-Notation verwendet. Wenn es sich um Pakete handelt, die auch der One Identity Manager verwendet, wird automatisch dieselbe Version des Pakets referenziert.

Alternativ kann eine Version angegeben werden. Dies ist nur für Pakete zulässig, die nicht von One Identity Manager genutzt werden.

Die Dateien aus den referenzierten Paketen werden bei der Kompilierung in den für die automatische Softwareaktualisierung zuständigen Strukturen abgelegt. Die Dateien stehen damit erst nach einer automatischen Softwareaktualisierung in den Skripten zur Verfügung.

Syntax

#R Package

Beispiel: Referenzierung von NuGet-Paketen

#If Not SCRIPTDEBUGGER Then

#R MimeKit

Imports MimeKit

#End If

Beispiel: Referenzierung von One Identity Manager-Paketen

Referenzen auf One Identity Manager-DLLs werden auf das gleichnamige Paket gesetzt. Damit sind folgende Varianten im entstehenden Code identisch:

#R VI.DB

References VI.DB.dll

Beispiel: Angabe von Versionen

#R My.Package 1.2.3

Skriptbibliothek

Die Skriptbibliothek enthält den Quellcode der im One Identity Manager verwendeten Skripte. Die mitgelieferten Standardskripte sind nicht bearbeitbar. Während der Schemainstallation werden diese Skripte, auch bei Verwendung in kundenspezifischen Skripten, überschrieben.

HINWEIS: Umfangreiche Beispiele für die Syntax und die Verwendung von Skripten finden Sie auf dem Installationsmedium im Verzeichnis QBM\dvd\AddOn\SDK\ScriptSamples. Beispiele für Unittests finden Sie unter QBM\dvd\AddOn\SDK\UnitTestSamples.

Die Skripte werden im Designer in der Kategorie Skriptbibliothek abgebildet. Auf dem Überblicksformular eines Skriptes erhalten Sie Informationen über dessen Verwendung beispielsweise in Spaltendefinitionen, Prozessen oder anderen Skripten.

Skripte erstellen, bearbeiten und testen Sie mit dem Skripteditor. Um umfangreichere Debug- und Bearbeitungsmöglichkeiten des Visual Studio zu nutzen, können die Skripte im den System Debugger bearbeiten und testen.

HINWEIS: Skripte für Synchronisationsprojekte aus der Skriptbibliothek des Synchronization Editors stehen im Designer nicht zur Verfügung. Ausführliche Informationen zur Skriptbibliothek des Synchronization Editors finden Sie im One Identity Manager Referenzhandbuch für die Zielsystemsynchronisation.

Detaillierte Informationen zum Thema

Unterstützung bei der Bearbeitung von Skripten im Skripteditor

Für die Bearbeitung von Skripten wird ein spezielles Eingabefeld verwendet. Das Eingabefeld besitzt einen erweiterten Bearbeitungsmodus, in dem zusätzliche Aktionen möglich sind.

Um in den erweiterten Bearbeitungsmodus zu wechseln

  • Verwenden Sie Strg + Alt + Eingabe oder die Schaltfläche am rechten unteren Rand.

Abbildung 16: Direkte Eingabe einer Datenbankabfrage

Tabelle 91: Bedeutung der Symbole des erweiterten Bearbeitungsmodus
Symbol Bedeutung

Beenden des erweiterten Bearbeitungsmodus.

Zurücksetzen der letzten Änderung.

Wiederherstellen der letzten Änderung.

Ausschneiden des markierten Codes.

Kopieren des markierten Codes in die Zwischenablage.

Einfügen des Codes aus der Zwischenablage.

Löschen des markierten Codes.

Einzug verkleinern.

Einzug vergrößern.

Text automatisch formatieren.

Textauswahl automatisch formatieren.

Zeilennummern einblenden oder ausblenden.

Kommentarzeichen einfügen.

Kommentarzeichen entfernen.

Zeilennummer einfügen oder entfernen.

Automatischen Zeilenumbruch einfügen oder entfernen.

Automatische Vervollständigung bei der Eingabe von Worten aktivieren oder deaktivieren.

Leerzeichen und Tabulatorzeichen einblenden oder ausblenden.

TIPP: Im Designer können Sie über das Menü Optionen > Leerzeichen weitere Einstellungen, wie beispielsweise die Tabulatorbreite, konfigurieren.

Suchen innerhalb des Codes.

Code-Ausschnitt einfügen.

Liste der Objekteigenschaften anzeigen.

Liste mit Wortvervollständigung anzeigen.

Liste mit Parameterinformationen anzeigen.

Zusätzliche Informationen anzeigen.

Tabelle 92: Tastenkombinationen für die Bearbeitung von Skripten

Tastenkombination

Beschreibung

Strg + C

In die Zwischenablage kopieren.

Strg + Einfg

In die Zwischenablage kopieren.

Strg + X

Ausschneiden und in die Zwischenablage übernehmen.

Umschalt + Entf

Ausschneiden und in die Zwischenablage übernehmen.

Strg + L

Zeile ausschneiden und in die Zwischenablage übernehmen.

Strg + V

Aus der Zwischenablage einfügen.

Umschalt + Einfg

Aus der Zwischenablage einfügen.

Strg + Y

Aktion wiederholen.

Strg + Umschalt + Z

Aktion wiederholen.

Strg + Z

Aktion rückgängig machen.

Rücktaste

Zeichen vor dem Cursor entfernen.

Umschalt + Rücktaste

Zeichen vor dem Cursor entfernen.

Strg + Rücktaste

Wort vor dem Cursor entfernen.

Entf

Zeichen am Cursor entfernen.

Strg + Umschalt + L

Zeile entfernen.

Strg + Entf

Zeichen bis zum nächsten Wort entfernen.

Eingabe

Zeilenumbruch einfügen.

Umschalt + Eingabe

Zeilenumbruch einfügen.

Strg + Eingabe

Zeile oberhalb einfügen.

Strg + Umschalt + Eingabe

Zeile unterhalb einfügen.

Strg + Leertaste

Automatische Vervollständigung.

Strg + Umschalt + Leertaste

Liste mit Parameterinformationen anzeigen.

Tab

Einzug/Tabstopp einfügen.

Umschalt + Tab

Einzug/Tabstopp entfernen.

Strg + U

Markierte Zeichen in Kleinbuchstaben ändern.

Strg + Umschalt + U

Markierte Zeichen in Großbuchstaben ändern

Einfg

Überschreibmodus einschalten oder ausschalten.

Strg + T

Zeichen vor und nach dem Cursor tauschen.

Strg + Umschalt + T

Wörter vor und nach dem Cursor tauschen.

Umschalt + Alt + T

Zeile mit der vorherigen Zeile tauschen.

Alt + Bild-Auf

Zeile nach oben bewegen.

Alt + Bild-Ab

Zeile nach unten bewegen.

Bild-Ab

Nach oben bewegen.

Bild-Auf

Nach unten bewegen.

Nach-Links-Taste

Nach links bewegen.

Nach-Rechts-Taste

Nach rechts bewegen.

Strg + Nach-Links-Taste

Zum vorherigen Wort bewegen.

Strg + Nach-Rechts-Taste

Zum nächsten Wort bewegen.

Pos1

Zum Zeilenanfang bewegen.

Ende

Zum Zeilenende bewegen.

Strg + Pos1

Zum Anfang des Skripts bewegen.

Strg + Ende

Zum Ende des Skripts bewegen.

Bild-Auf

Seite nach oben bewegen.

Bild-Ab

Seite nach unten bewegen.

Strg + Bild-Auf

Zum sichtbaren Anfang bewegen.

Strg + Bild-Ab

Zum sichtbaren Ende bewegen.

Strg + ]

Zur letzten passenden Klammer bewegen. (nicht auf deutscher Tastatur erreichbar)

Strg + Nach-Unten-Taste

Nach unten scrollen.

Strg + Nach-Oben-Taste

Nach oben scrollen.

Strg + F

Suchendialog öffnen.

F3

Weitersuchen.

Strg + F3

Vorwärts suchen.

Umschalt + F3

Rückwärts suchen.

Strg + Umschalt + F3

Vorherige Auswahl finden.

Strg + H

Ersetzen.

Strg + I

Inkrementelle Suche vorwärts.

Strg + Umschalt + I

Inkrementelle Suche rückwärts.

Strg + Umschalt + Num-

Auswahl des Code-Blocks verringern.

Strg + Umschalt + Num+

Auswahl des Code-Blocks erweitern.

Escape

Auswahl entfernen.

Umschalt + Nach-Unten-Taste

Auswahl nach unten erweitern.

Umschalt + Nach-Oben-Taste

Auswahl nach oben erweitern.

Umschalt + Nach-Links-Taste

Auswahl nach links erweitern.

Umschalt + Nach-Rechts-Taste

Auswahl nach rechts erweitern.

Strg + Umschalt + Nach-Links-Taste

Auswahl bis zum vorherigen Wort erweitern.

Strg + Umschalt + Nach-Rechts-Taste

Auswahl bis zum nächsten Wort erweitern.

Umschalt + Pos1

Auswahl bis zum Zeilenanfang erweitern.

Umschalt + Ende

Auswahl bis zum Zeilenende erweitern

Strg + Umschalt + Pos1

Auswahl bis zum Anfang des Skriptes erweitern.

Strg + Umschalt + Ende

Auswahl bis zum Ende des Skriptes erweitern.

Umschalt + Bild-Auf

Auswahl eine Seite nach oben erweitern.

Umschalt + Bild-Ab

Auswahl eine Seite nach unten erweitern.

Strg + Umschalt + Bild-Auf

Auswahl bis zum sichtbaren Anfang erweitern.

Strg + Umschalt + Bild-Ab

Auswahl bis zum sichtbaren Ende erweitern.

Strg + A

Alles auswählen.

Strg + Umschalt + W

Wort auswählen.

Strg + Umschalt + ]

Auswahl bis zur nächsten Klammer erweitern. (nicht auf deutscher Tastatur erreichbar)

Umschalt + Alt + Nach-Unten-Taste

Ausgewählten Block nach unten erweitern.

Umschalt + Alt + Nach-Oben-Taste

Ausgewählten Block nach oben erweitern.

Umschalt + Alt + Nach-Links-Taste

Ausgewählten Block nach links erweitern.

Umschalt + Alt + Nach-Rechts-Taste

Ausgewählten Block nach rechts erweitern.

Strg + Umschalt + Alt + Nach-Links-Taste

Ausgewählten Block bis zum vorherigen Wort erweitern.

Strg + Umschalt + Alt + Nach-Rechts-Taste

Ausgewählten Block bis zum nächsten Wort erweitern.

Strg + Mausrad

Schriftgröße anpassen.

Für die Erstellung des Skriptcodes werden zusätzliche Eingabehilfen angeboten.

Syntaxhervorhebung

Die Eingabefelder unterstützen abhängig vom Syntaxtyp die Syntaxhervorhebung.

Automatische Vervollständigung

Bei der Erstellung von Skriptcode kann die automatische Vervollständigung genutzt werden. Die automatische Vervollständigung können Sie in den Eingabefeldern im erweiterten Bearbeitungsmodus über Schaltfläche aktivieren. Damit wird die automatische Vervollständigung bereits bei der Eingabe der Schlüsselwörter angeboten. Wird im Quellcode an einer Stelle ein Schlüsselwort erwartet, wird die automatische Vervollständigung nach einigen Buchstaben automatisch geöffnet. Nach einigen Zeichen, wie beispielsweise Punkt (.) oder Klammer ((), wird die Autovervollständigung hingegen immer angeboten. Alternativ können Sie die automatische Vervollständigung über die Tastenkombination Strg + Leertaste an geeigneten Stellen der Eingabefelder aufrufen.

Durch die Einblendung verwendbarer Bezeichnungen von Eigenschaften oder Funktionen, wird die Menge des manuell einzutragenden Skriptcodes verringert. Welche Inhalte zur Auswahl angeboten werden, wird über Schlüsselwörter im Skriptcode bestimmt.

Eingabe von Code-Ausschnitten

Eingabefelder, die den Syntaxtyp VB.Net erfordern, unterstützen die Eingabe von Code-Ausschnitten. In der Kategorie Visual Basic werden allgemeine Code-Ausschnitte angeboten. Die Kategorie Object Layer enthält spezielle Code-Ausschnitte für die One Identity Manager-Objektschicht. In der Kategorie SQL Formatter werden Code-Ausschnitte für Datenbankabfragen aus VB.Net bereitgestellt.

Code-Ausschnitte können Sie über folgende Varianten einfügen:

  1. Eingabe über Symbol

    1. Wählen Sie in der Menüleiste das Symbol .

    2. Wählen Sie die Kategorie Object Layer, SQL Formatter oder Visual Basic.

    3. Wählen Sie den Code-Ausschnitt aus.

  2. Eingabe über Tastenkombination

    1. Drücken Sie die Taste F2.

    2. Wählen Sie die Kategorie Object Layer, SQL Formatter oder Visual Basic.

    3. Wählen Sie den Code-Ausschnitt aus.

  3. Einfügen über Verknüpfungsnamen

    1. Geben Sie einen Verknüpfungsnamen ein.

    2. Über Tab wird der Code-Ausschnitt eingefügt.

      HINWEIS: Beachten Sie bei der Eingabe der Verknüpfungsnamen die Groß- und Kleinschreibung.

HINWEIS: Bei direkter Auswahl eines Code-Ausschnittes über Tastenkombination oder über das Symbol werden eine Kurzbeschreibung sowie der Verknüpfungsname als Tooltip angezeigt.

Kundendefinierte Code-Ausschnitte

Sie können kundenspezifische Code-Ausschnitte verwenden. Erstellen Sie dazu im Installationsverzeichnis des One Identity Manager ein Verzeichnis CustomSnippets, in welches Sie die Dateien für die Code-Ausschnitte einfügen. Für die Entwicklung eigener Code-Ausschnitte nutzen Sie die Dokumentation von Visual Studio.

Eingabe von Werten in $-Notation

In Eingabefeldern, die einen VB.Net-Ausdruck erwarten, wird bei Eingabe von $ eine Eingabehilfe geöffnet. Alle Eigenschaften des aktuellen Objektes werden angezeigt. Zusätzlich wird ein Tooltip mit einer näheren Beschreibung der Eigenschaft eingeblendet. Wenn Sie eine Fremdschlüssel (FK)-Spalte auswählen, können Sie mit den Pfeiltasten zu den Spalten der zugehörigen Tabelle navigieren. Beenden Sie die Auswahl auf der Zielspalte mit Eingabe oder Doppelklick. In der Eingabespalte wird nun die vollständige $-Notation für Ihre Auswahl angezeigt. Um die Eingabehilfe ohne Datenübernahme zu schließen, verwenden Sie Esc oder verlassen Sie das Eingabefeld.

Abbildung 17: Eingabehilfe für $-Notation

Tabelle 93: Bedeutung der verwendeten Symbole in der Eingabehilfe für $-Notation
Symbol Bedeutung

Eigenschaft des aktuellen Objektes.

Primärschlüssel (PK).

Fremdschlüssel (FK).

Dynamischer Fremdschlüssel.

Tabelle.

Spezielle Eigenschaften.

Skript.

Tabelle 94: Funktionen der Eingabehilfe für die $-Notation
Tastenkombination Aktion

Nach-Unten-Taste

Öffnen der Eingabehilfe.

Nach-Oben-Taste, Nach-Unten-Taste

Wechsel zum vorherigen oder nächsten Eintrag.

Nach-Links-Taste, Nach-Rechts-Taste

Wechsel über Fremdschlüssel zum übergeordneten Objekt oder zum untergeordneten Objekt.

Eingabe

Übernahme des Wertes in $-Notation.

Skripte mit dem Skripteditor erstellen und bearbeiten

Wichtig: Nach der Erstellung und Bearbeitung eines Skriptes, testen Sie die Kompilierung des Skriptes. Damit ein Skript wirkt, kompilieren Sie die Datenbank.

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

  1. Wählen Sie im Designer die Kategorie Skriptbibliothek.

  2. Starten Sie den Skripteditor über die Aufgabe Ein neues Skript erstellen.

  3. Bearbeiten Sie die Stammdaten.

    Tabelle 95: Stammdaten des Skript
    Eigenschaft Beschreibung

    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

  1. Wählen Sie im Designer in der Kategorie Skriptbibliothek das Skript.

  2. Wählen Sie die Aufgabe Skript bearbeiten.

  3. Bearbeiten Sie die Stammdaten des Skriptes.

Detaillierte Informationen zum Thema
Verwandte Dokumente

The document was helpful.

Bewertung auswählen

I easily found the information I needed.

Bewertung auswählen