LDAP Aktivität „Eintrag ändern“
Einführung
Eine LDAP Aktivität „Eintrag ändern“ ändert Einträge in einem LDAP Endpoint und soll als Ziel verwendet werden, um Daten in einem Operation verbrauchen. Nachdem Sie eine LDAP -Verbindung konfiguriert haben, können Sie so viele LDAP Aktivitäten konfigurieren, wie Sie möchten. wie für jede LDAP Verbindung.
Erstellen einer LDAP Aktivität
Aus einer Verbindung wird mithilfe eines Aktivitätstyps eine Instanz einer Aktivität erstellt.
Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.
Eine vorhandene Aktivität kann von diesen Orten aus bearbeitet werden:
- Die Design-Canvas (siehe Aktionsmenü in Entwurfsfläche).
- Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).
Konfigurieren einer LDAP Aktivität „Eintrag ändern“
Führen Sie die folgenden Schritte aus, um eine LDAP Aktivität „Eintrag ändern“ zu konfigurieren:
- Schritt 1: Geben Sie einen Namen ein und legen Sie die Einstellungen fest
- Schritt 2: Überprüfen Sie die Datenschemata
Schritt 1: Namen eingeben und Einstellungen festlegen
-
Name: Geben Sie einen Namen ein, der zur Identifizierung der LDAP Aktivität „Eintrag ändern“ verwendet werden soll. Der Name muss eindeutig sein für jede LDAP Aktivität „Eintrag ändern“ und darf keine Schrägstriche enthalten (
/
) oder Doppelpunkte (:
). -
Operation: Geben Sie an, wie der Eintrag geändert werden soll, entweder Add_Attribute, Remove_Attribute oder Attribut_ersetzen:
-
Add_Attribute: Fügt einem Eintrag ein Attribut und Werte hinzu.
-
Remove_Attribute: Entfernt ein Attribut und Werte aus einem Eintrag.
-
Replace_Attribute: Ersetzt vorhandene Werte in einem Eintrag.
-
-
Objektklasse auswählen: Dieser Abschnitt zeigt die im LDAP Endpoint verfügbaren strukturellen Objektklassen an. Wenn Beim erneuten Öffnen einer bestehenden Aktivitätskonfiguration wird nur die ausgewählte Objektklasse angezeigt, anstatt die gesamte Objektklassenliste.
-
Ausgewählte Objektklasse: Nachdem eine Objektklasse ausgewählt wurde, wird sie hier aufgelistet.
-
Suchen: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Objektklassen. Die Suche ist nicht case-sensitiv. Wenn Objektklassen bereits innerhalb von die Tabelle, die Tabellenergebnisse werden mit jedem Tastendruck in Echtzeit gefiltert. Zum Nachladen von Objektklassen vom Endpoint der Suche aus, geben Sie Suchkriterien ein und aktualisieren Sie dann, wie unten beschrieben.
-
Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Objektklassen vom LDAP Endpoint neu laden. Dies kann nützlich sein, wenn Sie kürzlich hinzugefügt haben Objektklassen zum LDAP Endpoint. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der Tabelle der in der Konfiguration angezeigten Objektklassen.
-
Auswahl einer Objektklasse: Klicken Sie in der Tabelle auf eine beliebige Zeile, um eine Objektklasse. Es kann nur eine Objektklasse ausgewählt werden. Die für jede Die Objektklasse wird vom LDAP Endpoint abgerufen:
- Name: Der Objektklassenname vom LDAP Endpoint.
- Beschreibung: Die Objektklassenbeschreibung vom LDAP Endpoint.
Tipp
Wenn die Tabelle nicht mit verfügbaren Objektklassen gefüllt ist, wird die LDAP -Verbindung ist möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldeinformationen erneut testen.
-
-
Bei Fehler fortfahren: Wählen Sie diese Option aus, um die Aktivitätsausführung fortzusetzen, wenn bei einem Datensatz in einer Charge-Anforderung ein Fehler auftritt. Wenn Fehler auftreten, werden sie in das Operation geschrieben.
-
Speichern und beenden: Wenn aktiviert, klicken Sie hier, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.
-
Weiter: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die -Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.
-
Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen hier, um die Konfiguration zu schließen, ohne die an einem -Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.
Schritt 2: Überprüfen der Datenschemata
-
Datenschema: Die Anfrage- und Antwortdatenschemata für LDAP werden angezeigt. Wenn die Operation verwendet eine Transformation, die Datenschemata werden später beim Transformation erneut angezeigt, wo Sie mithilfe von Quellobjekten, Scripts, Variablen, benutzerdefinierten Werten und mehr Zielfelder zuordnen können.
Der LDAP Konnektor verwendet die Apache Directory LDAP API Version 1.0.1. Diese API unterstützt alle Arten von LDAP -Servern, nicht nur ApacheDS. Weitere Informationen finden Sie im Apache LDAP API 1.0.1 Dokumentation und Dokumentation zum jeweiligen LDAP Server für Informationen zu den Schema.
Dies sind die Schema, die im Beispiel Screenshot oben angezeigt werden:
-
Anfrage:
Schemafeld/-knoten anfordern Hinweise json Das Format des Schema modifyEntry-request Die Directory Services Markup Language (DSML)-Anforderung Anfrage Die Anfrage an den LDAP Server Artikel Ein Anforderungsartikel dn Der Distinguished Name, der eine Position in einer Hierarchie darstellt Attribute Attribute des LDAP Eintrags userPassword Benutzerpasswort removeAll Ein Boolescher Wert, der angibt, ob Passwörter entfernt werden sollen Werte Benutzerkennwortwerte item Das Benutzerpasswort-Element #text Wert des Benutzerkennwortelements -
Antwort:
Antwortschemafeld/-knoten Hinweise json Das Format des Schema modifyEntry-response Die Directory Services Markup Language (DSML)-Antwort Antwort Die Antwort vom LDAP -Server item Das Antwortelement Erfolg Ein Boolescher Wert, der angibt, ob die Anfrage erfolgreich war errorDetails Die Fehlerdetails errorMsg Eine vom LDAP Server zurückgegebene Fehlermeldung
-
-
Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemata vom LDAP Endpoint neu generieren. Diese Aktion generiert das Schema auch in anderen Stellen im gesamten Projekt, an denen auf dasselbe Schema verwiesen wird, z. B. in einer angrenzenden Transformation.
-
Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.
-
Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.
-
Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen auf, um die Konfiguration zu schließen, ohne die Änderungen an Schritt. Sie werden in einer Meldung aufgefordert zu bestätigen, dass Sie die Änderungen verwerfen möchten.
Nächste Schritte
Nachdem Sie eine LDAP Aktivität „Eintrag ändern“ konfiguriert haben, schließen Sie die Konfiguration der Operation ab, indem Sie Konfigurieren anderer Aktivitäten, Transformations oder Scripts als Operation. Sie können auch die Operation, die die Möglichkeit umfassen, Operationen miteinander zu verketten, die sich im gleichen oder in verschiedenen Workflows.
Nachdem eine LDAP Aktivität erstellt wurde, sind Menüaktionen für diese Aktivität zugänglich aus dem Projektbereich entweder auf den Registerkarten Workflows oder Komponenten und aus der Design-Canvas. Siehe Aktionsmenü für weitere Einzelheiten.
LDAP Aktivitäten zum Ändern von Einträgen können mit den folgenden Operation als Ziel verwendet werden:
- Transformation
- Zwei-Transformationsmuster (als erstes oder zweites Ziel)
Andere Muster sind bei LDAP -Aktivitäten zum Ändern von Einträgen nicht gültig. Siehe die Validierungsmuster auf der Gültigkeit der Operation Seite.
Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie dann diesen temporären Speicherort. Speicherort in der Skriptfunktion.
Wenn Sie bereit sind, führen Sie den Operation aus und validieren Sie das Verhalten durch Überprüfen der Operation.