Zum Inhalt springen

LDAP-Suchobjekt-Aktivität in Jitterbit Studio

Einführung

Eine LDAP-Suchobjekt-Aktivität gibt Einträge in einem LDAP-Endpunkt zurück und ist dazu gedacht, als Quelle für die Bereitstellung von Daten für eine Operation verwendet zu werden. Nach der Konfiguration einer LDAP-Verbindung können Sie so viele LDAP-Aktivitäten konfigurieren, wie Sie möchten, für jede LDAP-Verbindung.

Erstellen einer LDAP-Aktivität

Eine Instanz einer Aktivität wird aus einer Verbindung unter Verwendung eines Aktivitätstyps erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Entwurfsfläche oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Entwurfsfläche ein. Für weitere Details siehe Erstellen einer Aktivität oder Tool-Instanz in Komponentenwiederverwendung.

Eine vorhandene Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer LDAP-Suchobjekt-Aktivität

Befolgen Sie diese Schritte, um eine LDAP-Suchobjekt-Aktivität zu konfigurieren:

Schritt 1: Geben Sie einen Namen ein und wählen Sie eine strukturelle Klasse aus

  • Endpunktmenü: Wenn Sie mehrere Endpunkte desselben Verbindungstyps konfiguriert haben, zeigt ein Menü oben auf dem Bildschirm den aktuellen Endpunktnamen an. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Ändern des zugewiesenen Endpunkts in Konfigurationsbildschirme.

  • Endpoint bearbeiten: Erscheint, wenn Sie über den aktuellen Endpunktnamen fahren. Klicken Sie, um die Verbindungs-Konfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

  • Name: Geben Sie einen Namen ein, um die LDAP-Suchdateneintrag-Aktivität zu identifizieren. Der Name muss für jede LDAP-Suchdateneintrag-Aktivität eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

  • Strukturelle Klasse auswählen: Dieser Abschnitt zeigt die in dem LDAP-Endpunkt verfügbaren strukturellen Klassen an. Beim erneuten Öffnen einer vorhandenen Aktivitätskonfiguration wird nur die ausgewählte strukturelle Klasse angezeigt, anstatt die gesamte Liste der strukturellen Klassen neu zu laden.

    • Ausgewählte strukturelle Klasse: Nachdem eine strukturelle Klasse ausgewählt wurde, wird sie hier aufgelistet.

    • Suche: Geben Sie den Wert einer Spalte in das Suchfeld ein, um die Liste der strukturellen Klassen zu filtern. Die Suche ist nicht groß-/kleinschreibungsempfindlich. Wenn strukturelle Klassen bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse in Echtzeit mit jedem Tastendruck gefiltert. Um strukturelle Klassen vom Endpunkt beim Suchen neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann, wie unten beschrieben.

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um strukturelle Klassen vom LDAP-Endpunkt neu zu laden. Dies kann nützlich sein, wenn Sie kürzlich strukturelle Klassen zum LDAP-Endpunkt hinzugefügt haben. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten Tabelle der strukturellen Klassen verwendet werden.

    • Auswählen einer strukturellen Klasse: Klicken Sie innerhalb der Tabelle auf eine beliebige Stelle in einer Zeile, um eine strukturelle Klasse auszuwählen. Es kann nur eine strukturelle Klasse ausgewählt werden. Die Informationen, die für jede strukturelle Klasse verfügbar sind, werden vom LDAP-Endpunkt abgerufen:

      • Name: Der Name der strukturellen Klasse vom LDAP-Endpunkt.
      • Beschreibung: Die Beschreibung der strukturellen Klasse vom LDAP-Endpunkt.

    Tipp

    Wenn die Tabelle nicht mit verfügbaren strukturellen Klassen gefüllt wird, könnte die LDAP-Verbindung nicht erfolgreich sein. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldeinformationen erneut testen.

  • Speichern & Beenden: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nach Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen an einem Schritt zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Hilfsklassen auswählen

  • Objektklassen: Dieser Abschnitt wird verwendet, um die Suche weiter einzuschränken, indem Hilfsklassen ausgewählt werden. Dieser Abschnitt ist optional und kann übersprungen werden, indem Weiter ausgewählt wird.

    • Verfügbare Hilfsklassen: Diese Spalte zeigt die Hilfsklassen zur Auswahl an.

      • Suche: Geben Sie den Wert einer Spalte in das Suchfeld ein, um die Liste der Hilfsklassen zu filtern. Die Suche ist nicht groß-/kleinschreibungsempfindlich. Wenn Objektklassen bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse in Echtzeit mit jedem Tastendruck gefiltert. Um Hilfsklassen vom Endpunkt neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann, wie unten beschrieben.

      • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol , um Hilfsklassen vom LDAP-Endpunkt neu zu laden. Dies kann nützlich sein, wenn Sie kürzlich Hilfsklassen zum LDAP-Endpunkt hinzugefügt haben.

      • Hinzufügen einer Hilfsklasse: Klicken Sie innerhalb der Spalte auf eine beliebige Stelle in einer Zeile, um eine oder mehrere Hilfsklassen auszuwählen. Klicken Sie dann auf das Hinzufügen-Symbol , um die ausgewählten Klassen zur Spalte Ausgewählte Hilfsklassen hinzuzufügen.

    • Ausgewählte Hilfsklassen: Diese Spalte zeigt die ausgewählten Hilfsklassen an.

      • Entfernen einer Hilfsklasse: Klicken Sie innerhalb der Spalte auf eine beliebige Stelle in einer Zeile, um eine oder mehrere Hilfsklassen auszuwählen. Klicken Sie dann auf das Entfernen-Symbol , um die ausgewählten Klassen zur Spalte Verfügbare Hilfsklassen zurückzugeben.

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

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern, nachdem Sie Änderungen vorgenommen haben. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 3: Einstellungen angeben

Tipp

Felder mit einem Variablen-Icon unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben oder indem Sie auf das Variablen-Icon klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.

  • Basis-DN: Geben Sie den Basis-Distinguished-Name ein, der als Ausgangspunkt für die Suche verwendet werden soll.

  • Verfügbare Attribute: Diese Spalte zeigt die auszuwählenden Attribute an.

    • Suche: Geben Sie den Wert einer Spalte in das Suchfeld ein, um die Liste der Attribute zu filtern. Die Suche ist nicht groß-/kleinschreibungsempfindlich. Wenn Attribute bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse in Echtzeit mit jedem Tastendruck gefiltert. Um Attribute vom Endpunkt beim Suchen neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann, wie unten beschrieben.

    • Aktualisieren: Klicken Sie auf das Aktualisieren-Icon , um Attribute vom LDAP-Endpunkt neu zu laden. Dies kann nützlich sein, wenn Sie kürzlich Attribute zum LDAP-Endpunkt hinzugefügt haben.

    • Hinzufügen eines Attributs: Doppelklicken Sie innerhalb der Spalte irgendwo auf eine Zeile, um das Attribut zur Spalte Filterausdruck rechts hinzuzufügen. Bearbeiten Sie dann den Filterausdruck nach Bedarf, um einen gültigen Ausdruck zu erstellen.

  • Filterausdruck: Geben Sie einen Filterausdruck ein.

    Mindestens muss der Filterausdruck die vorausgefüllte strukturelle Klasse enthalten, die in Schritt 1: Geben Sie einen Namen ein und wählen Sie eine strukturelle Klasse ausgewählt wurde. Wenn die ausgewählte strukturelle Klasse in Schritt 1 geändert wird, wird der bestehende Filterausdruck vollständig durch die neu vorausgefüllte strukturelle Klasse ersetzt.

    Sie können Attribute und andere Filter hinzufügen, wie in LDAP-Filtertypen dokumentiert. Das Hinzufügen zusätzlicher struktureller Objektklassen wird nicht unterstützt.

    Hinweis

    Abhängig von den Anforderungen des LDAP-Endpunkts müssen Sie möglicherweise die Groß- und Kleinschreibung des vorausgefüllten Filterausdrucks für die strukturelle Klasse ändern. Ändern Sie beispielsweise ObjectClass in objectClass.

  • Geltungsbereich: Geben Sie den Geltungsbereich an, der für die Suche verwendet werden soll, einer von Objekt (Basis), Eine Ebene oder Unterbaum:

    • Objekt (Basis): Nur der im Feld Basis-DN angegebene Eintrag wird durchsucht, ohne Untergeordnete.

    • Eine Ebene: Nur die unmittelbaren Kinder des im Feld Basis-DN angegebenen Eintrags werden durchsucht, ohne den Eintrag Basis-DN selbst.

    • Unterbaum: Der im Feld Basis-DN angegebene Eintrag und alle seine Untergeordneten bis in jede Tiefe werden durchsucht.

  • Seitenanzahl: Geben Sie die Anzahl der Datensätze an, die für jede Anfrage zurückgegeben werden sollen. Die Aktivität sendet so viele Anfragen, wie nötig sind, um alle Datensätze zurückzugeben. Dieser Parameter kann durch das konfigurierte Größenlimit auf dem spezifischen LDAP-Server begrenzt sein.

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

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Schritt 4: Überprüfen der Datenschemas

  • Datenschema: Das Antwortdatenschema für eine LDAP-Suchobjektaktivität wird angezeigt. Wenn die Operation eine Transformation verwendet, werden die Datenschemas später während des Transformationszuordnungsprozesses erneut angezeigt, wo Sie Zielfelder mithilfe von Quellobjekten, Skripten, Variablen, benutzerdefinierten Werten und mehr zuordnen können.

    Der LDAP-Connector verwendet die Apache Directory LDAP API Version 1.0.1. Diese API unterstützt alle Arten von LDAP-Servern, nicht nur ApacheDS. Weitere Informationen zu den Schemafeldern finden Sie in der Apache LDAP API 1.0.1 Dokumentation und in der Dokumentation zum spezifischen LDAP-Server.

    Dies sind die Schemafelder, die im obigen Beispiel-Screenshot angezeigt werden:

    Antwortschemafeld/-knoten Hinweise
    json Das Format des Antwortschemas
    searchResponse Die Directory Services Markup Language (DSML) Suchantwort
    entries LDAP-Einträge, die jeweils einen Distinguished Name (dn) und eine Liste von Attributen enthalten
    item Ein LDAP-Eintrag
    ObjectClass Eine Definition der Objektklasse
    item Das Objektklassenelement
    #text Wert des Objektklassenelements
    dn Der Distinguished Name, der eine Position in einer Hierarchie darstellt
    attributes Die LDAP-Attribute
    userPassword Das Benutzerpasswort
    item Das Benutzerpasswortelement
    #text Wert des Benutzerpasswortelements

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um die Schemata vom LDAP-Endpunkt neu zu generieren. Diese Aktion regeneriert auch das Schema an anderen Stellen im Projekt, an denen dasselbe Schema referenziert wird, wie beispielsweise in einer benachbarten Transformation.

  • Bearbeiten: Klicken Sie auf das Bearbeitungssymbol über dem Antwortdatenschema, um den Editor zu betreten. Der Editor ermöglicht es Ihnen, Knoten und Felder hinzuzufügen, zu löschen und neu anzuordnen sowie deren Datentypen zu ändern. Alle neu hinzugefügten Knoten und Felder sind auf [0, 1] Kardinalität eingestellt. Änderungen am Antwortdatenschema müssen für den Endpunkt akzeptabel sein und sollten nur nach Konsultation der verfügbaren Dokumentation für den Endpunkt vorgenommen werden. Nach dem Bearbeiten des Schemas wird ein Datum der letzten Bearbeitung oben im entsprechenden Schema angezeigt, um anzuzeigen, dass das Schema manuelle Änderungen erfahren hat. Das Aktualisieren des Schemas setzt das Schema auf seine Standardstruktur zurück.

  • Zurück: Klicken Sie, 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: Nach dem Vornehmen von Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine LDAP-Suchaktivität konfiguriert haben, vervollständigen Sie die Konfiguration der Operation, indem Sie andere Aktivitäten oder Werkzeuge als Operation Schritte hinzufügen und konfigurieren. Sie können auch die Betriebseinstellungen einer Operation konfigurieren, die die Möglichkeit umfassen, Operationen zusammenzuschalten, die sich in denselben oder unterschiedlichen Workflows befinden.

Nachdem eine LDAP-Aktivität erstellt wurde, sind die Menüaktionen für diese Aktivität im Projektbereich entweder in den Registerkarten Workflows oder Komponenten sowie auf der Entwurfskanvas zugänglich. Siehe Aktivitätsaktionsmenü für Details.

LDAP-Suchdatensatz-Aktivitäten können als Quelle mit diesen Betriebsmustern verwendet werden:

Andere Muster sind bei der Verwendung von LDAP-Suchdatensatz-Aktivitäten nicht gültig. Siehe die Validierungsmuster auf der Seite zur Betriebsvalidität.

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 in der Skriptfunktion.

Wenn Sie bereit sind, implementieren Sie den Betrieb und führen Sie ihn aus und validieren Sie das Verhalten, indem Sie die Betriebsprotokolle überprüfen.