Zum Inhalt springen

LDAP Aktivität „Eintrag hinzufügen“

Einführung

Eine LDAP Aktivität „Eintrag hinzufügen“ fügt Einträge in einem LDAP Endpoint hinzu und ist als Ziel für die Nutzung vorgesehen. Daten in einer Operation. Nachdem Sie eine LDAP Verbindung konfiguriert haben, können Sie beliebig viele LDAP Aktivitäten konfigurieren 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:

Konfigurieren einer LDAP Aktivität „Eintrag hinzufügen“

Führen Sie die folgenden Schritte aus, um die Aktivität „LDAP Eintrag hinzufügen“ zu konfigurieren:

Schritt 1: Namen eingeben, Strukturklasse auswählen und Einstellungen festlegen

LDAP Aktivität „Eintrag hinzufügen“, Konfigurationsschritt 1

  • Name: Geben Sie einen Namen ein, der zur Identifizierung der LDAP Aktivität „Eintrag hinzufügen“ verwendet werden soll. Der Name muss eindeutig sein für jede LDAP Aktivität „Eintrag hinzufügen“ und darf keine Schrägstriche enthalten (/) oder Doppelpunkte (:).

  • Strukturklasse auswählen: Dieser Abschnitt zeigt die Strukturobjektklassen an, die im LDAP Endpoint verfügbar sind. Wenn Beim erneuten Öffnen einer bestehenden Aktivitätskonfiguration wird nur die ausgewählte Objektklasse angezeigt, anstatt die gesamte Objektklassenliste.

    • Ausgewählte Strukturklasse: 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.

    • Auswählen einer Strukturklasse: 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: Zusatzklasse auswählen

LDAP Aktivität „Eintrag hinzufügen“, Konfigurationsschritt 2

  • Objektklassen: In diesem Abschnitt können Sie zusätzliche Objektklassen auswählen, um zusätzliche Eigenschaften zu definieren des LDAP Eintrags. Es muss mindestens eine Hilfsobjektklasse ausgewählt werden.

    • Verfügbare Zusatzklassen: In dieser Spalte werden Zusatzklassen zur Auswahl angezeigt.

      Notiz

      Obwohl Symbole für abstrakte und strukturelle Klassen definiert sind, wird nur die Auswahl von Hilfsklassen unterstützt.

      • Suchen: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Objektklassen zu filtern. Die Suche ist nicht case-sensitiv. Wenn in der Tabelle bereits Objektklassen angezeigt werden, werden die Tabellenergebnisse werden mit jedem Tastendruck in Echtzeit gefiltert. Um Objektklassen beim Suchen vom Endpoint neu zu laden, Suchkriterien eingeben und dann aktualisieren, wie unten beschrieben.

      • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol Aktualisierungssymbol, um Objektklassen neu zu laden aus der LDAP Endpoint. Dies kann nützlich sein, wenn Sie vor Kurzem Objektklassen zum LDAP Endpoint hinzugefügt haben.

      • Hinzufügen einer Zusatzklasse: Klicken Sie innerhalb der Spalte irgendwo auf eine Zeile, um ein oder mehrere Objekte auszuwählen Klassen. Klicken Sie dann auf das Symbol „Hinzufügen“, um ausgewählte Klassen zur Spalte Ausgewählte Hilfsklassen hinzuzufügen:

    • Ausgewählte Hilfsklassen: In dieser Spalte werden ausgewählte Hilfsklassen angezeigt.

      • Entfernen einer Hilfsklasse: Klicken Sie innerhalb der Spalte irgendwo auf eine Zeile, um ein oder mehrere Objektklassen auszuwählen. Klassen. Klicken Sie dann auf das Symbol „Entfernen“, um ausgewählte Klassen in die Spalte „Verfügbare Hilfsklassen“ zurückzusetzen:

        Symbol „Entfernen“

  • Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • 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. In einer Meldung werden Sie aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 3: Überprüfen der Datenschemata

LDAP Aktivität „Eintrag hinzufügen“, Konfigurationsschritt 3

  • 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
      addEntryRequest Die Directory Services Markup Language (DSML)-Anforderung
      Element Ein LDAP Eintrag
      dn Der Distinguished Name, der eine Position in einer Hierarchie darstellt
      Attribute Attribute des LDAP Eintrags
      supportedAlgorithms Unterstützte Algorithmen
      item Das unterstützte Algorithmuselement
      #text Wert des unterstützten Algorithmuselements
      userPassword Benutzerpasswort
      item Das Benutzerpasswort-Element
      #text Wert des Benutzerkennwortelements
    • Antwort:

      Antwortschemafeld/-knoten Hinweise
      json Das Format des Schema
      addEntryResponse 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 hinzufügen“ konfiguriert haben, schließen Sie die Konfiguration der Operation ab, indem Sie andere Aktivitäten, Transformations oder Scripts als Operation. Sie können auch die Operation einer Operation konfigurieren Einstellungen, darunter die Möglichkeit, Vorgänge im gleichen oder in unterschiedlichen Workflows miteinander zu verketten.

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 Hinzufügen von Einträgen können mit den folgenden Operation als Ziel verwendet werden:

Andere Muster sind bei LDAP Aktivitäten zum Hinzufügen 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.