Skripte prüfen
An verschiedenen Stellen im können Sie Skripte verwenden; beispielsweise bei der Definition von Schemaeigenschaften, im oder wenn Sie Datenoperationen für Systemverbindungen über den definieren. Abhängig von der Skriptsprache, die für das Synchronisationsprojekt festgelegt wurde, können Sie die Skripte als C# Code oder als Visual Basic .NET Code erfassen.
Zur Fehleranalyse können Sie den Skriptcode kompilieren und debuggen.
Kompilieren
Um die Syntax des Skriptcodes zu prüfen
- Öffnen Sie das Skript im .
- Klicken Sie Kompilieren.
Kompilierfehler werden sofort angezeigt und im Fehlerprotokoll des Synchronization Editors aufgezeichnet.
Debuggen
Beim Debuggen wird der Skriptcode in ein Visual Studio Projekt exportiert. Sobald das Projekt ausgeführt wird, wird der Synchronization Editor im Debug-Modus gestartet und das Skript getestet.
Voraussetzungen
- Visual Studio ist auf der Arbeitsstation, auf der der Synchronization Editor ausgeführt wird, installiert.
- Alle Änderungen im Synchronisationsprojekt wurden gespeichert.
- Der Debugger kann genutzt werden in Skripten, die verwendet werden in:
- Schemaeigenschaften
-
- Datenoperationen für Systemverbindungen über den generischen Datenbankkonnektor
Um ein Skript zu debuggen
- Öffnen Sie das Skript im Synchronization Editor.
- Klicken Sie Debuggen.
- Bestätigen Sie die Meldung mit OK.
- Starten Sie das Debugging im Visual Studio Projekt.
- Falls erforderlich, korrigieren Sie den Skriptcode im Standard-Modus des Synchronization Editors.
- Speichern Sie die Änderungen.
Verwandte Themen
Synchronisation starten
Sie können eine auch manuell starten. Dabei können Sie die Synchronisation auf Ihrer Arbeitsstation ausführen oder vom ausführen lassen. Wenn Sie die Synchronisation auf Ihrer Arbeitsstation ausführen, können Sie erst dann wieder mit dem arbeiten, wenn die Synchronisation abgeschlossen ist. Um auch während der Synchronisation mit dem Synchronization Editor arbeiten zu können, lassen Sie die Synchronisation vom Synchronisationsserver ausführen.
Um eine Synchronisation manuell zu starten
-
Öffnen Sie im Synchronization Editor das .
-
Wählen Sie die Kategorie Konfiguration > Startkonfigurationen.
-
Wählen Sie in der Dokumentenansicht eine und klicken Sie Ausführen.
- Bestätigen Sie die Sicherheitsabfrage mit Ja.
Nachgelagerte Prozesse definieren
Bestimmte Aktionen sollen in der One Identity Manager-Datenbank ausgeführt werden, sobald eine abgeschlossen ist. Dafür können an den Tabellen, die die Basisobjekte liefern, zusätzliche definiert werden. Diese zusätzlichen Prozesse werden durch das Ereignis "PostSync" ausgeführt, das im Prozess DPR_DPRProjectionStartInfo_Run_Synchronization ausgelöst wird.
Um einen nachgelagerten Prozess für die Synchronisation zu erstellen
- Wählen Sie im die Kategorie Prozess-Orchestrierung.
- Starten Sie den Prozesseditor über die Aufgabe Einen neuen Prozess erstellen.
Ein neues Element für den Prozess wird erzeugt und im Prozesseditor geöffnet.
- Bearbeiten Sie mindestens folgenden die Prozesseigenschaften.
| Tabelle: |
Tabelle, die das der Synchronisation liefert, beispielsweise ADSDomain. |
| Ereignis: |
PostSync |
- Erstellen Sie die erforderlichen .
Weitere Informationen finden Sie im One Identity Manager Konfigurationshandbuch.
- Speichern Sie die Änderungen.
Beispiele
- Um Personen automatisch an Active Directory Benutzerkonten zuzuordnen, gibt es an der Tabelle ADSDomain den Prozess ADS_ADSDomain_SearchAndCreate_FullSync. Der Prozess wird durch das Ereignis "PostSync" ausgelöst.
- Wenn bei der Synchronisation einer Active Directory Domäne Gruppenmitgliedschaften nicht aufgelöst werden konnten, ermittelt der One Identity Manager die Active Directory SIDs der Benutzerkonten. Dafür gibt es an der Tabelle ADSDomain den Prozess ADS_ADSDomain_PostSync. Der Prozess wird durch das Ereignis "PostSync" ausgelöst.
Synchronisationsschritte verarbeiten
Wenn ein im Ausführungsplan abgearbeitet wird, werden die zu synchronisierenden Objekte folgendermaßen ermittelt und verarbeitet.
- Schlanke Listen der zu synchronisierenden Objekte laden
Aus dem und der One Identity Manager-Datenbank werden die zu synchronisierenden Objekte entsprechend den Object-Matching-Regeln geladen. Dabei werden nur die Schlüsseleigenschaften, die (wenn vorhanden) und einzelne im festgelegte Schemaeigenschaften geladen.
- anwenden
Wenn die zugelassen ist und das Zielsystem die Revisionsfilterung unterstützt, werden die geänderten Objektpaare gefiltert. Der Revisionsfilter wird auf die schlanken Listen, das heißt auf die bereits geladenen Objekte, angewendet. Objekte, die nur in einem der verbundenen Systeme vorhanden sind, werden damit ebenfalls verarbeitet.
- Listen der Objektpaare mit allen Schemaeigenschaften laden
Der One Identity Manager lädt Listen der zu synchronisierenden Objekte und Objektpaare mit allen gemappten Schemaeigenschaften. Die Listen werden in Partitionen mit einer festgelegten Größe geladen. Sobald eine Partition (beispielsweise 1000 Listenpaare) geladen wurde, wird diese asynchron verarbeitet und gleichzeitig bereits die nächste Partition geladen. So befinden sich zu jeder Zeit maximal zwei Partitionen im Hauptspeicher.
- anwenden
Sobald eine Partition (beispielsweise 1000 Listenpaare) geladen wurde, wird für alle Objekte und Objektpaare das Mapping angewendet. Anschließend werden die Verarbeitungsmethoden entsprechend der angegebenen Bedingung ausgeführt.
Wenn für eine eine definiert ist, werden erst alle zu verarbeitenden Objekte aus allen Partitionen geladen, um zu prüfen, ob die Quota überschritten wird. Bei großen Datenmengen kann das die Synchronisationsperformance beeinträchtigen. Wenn die Quota nicht erreicht wird, wird die Verarbeitungsmethode anschließend ausgeführt. Wenn die Quota überschritten wird, wird die Ausführung des Synchronisationsschritts und damit die Synchronisation abgebrochen und eine Meldung ins Synchronisationsprotokoll geschrieben.
Detaillierte Informationen zum Thema
Kompilieren
Debuggen
Das Skript konnte fehlerfrei kompiliert werden.
Das Skript enthält Syntaxfehler.