LDAP -Sucheintrag-Aktivität

Einführung

Eine LDAP Sucheintrag-Aktivität gibt Einträge in einem LDAP Endpoint zurück und soll als Quelle verwendet werden, um Daten zu 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:

• Die Design-Canvas (siehe Aktionsmenü in Entwurfsfläche).
• Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).

Konfigurieren einer LDAP Sucheintragaktivität

Führen Sie die folgenden Schritte aus, um eine LDAP Sucheintragaktivität zu konfigurieren:

• Schritt 1: Geben Sie einen Namen ein und wählen Sie eine Strukturklasse aus
• Schritt 2: Hilfsklassen auswählen
• Schritt 3: Einstellungen festlegen
• Schritt 4: Überprüfen Sie die Datenschemata

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

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

• Strukturklasse auswählen: Dieser Abschnitt zeigt die Strukturklassen an, die im LDAP Endpoint verfügbar sind. Wenn Beim erneuten Öffnen einer bestehenden Aktivitätskonfiguration wird nur die ausgewählte Strukturklasse angezeigt, statt neu zu laden die gesamte Strukturklassenliste.

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

  • Suchen: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Strukturklassen. Die Suche ist nicht case-sensitiv. Wenn Strukturklassen bereits innerhalb von die Tabelle, die Tabellenergebnisse werden mit jedem Tastendruck in Echtzeit gefiltert. Zum Nachladen von Strukturklassen 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 Strukturklassen vom LDAP Endpoint neu laden. Dies kann nützlich sein, wenn Sie kürzlich hinzugefügt haben Strukturklassen zum LDAP Endpoint. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der Tabelle der in der Konfiguration angezeigten Strukturklassen.

  • Auswählen einer Strukturklasse: Klicken Sie in der Tabelle auf eine beliebige Zeile, um eine Strukturklasse. Es kann nur eine Strukturklasse ausgewählt werden. Die für jede Die Strukturklasse wird vom LDAP Endpoint abgerufen:

    • Name: Der strukturelle Klassenname vom LDAP Endpoint.
    • Beschreibung: Die strukturelle Klassenbeschreibung vom LDAP Endpoint.

  Tipp

  Wenn die Tabelle nicht mit verfügbaren Strukturklassen gefüllt wird, 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.

• Speichern und beenden: Klicken Sie, wenn aktiviert, 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 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, 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: Hilfsklassen auswählen

• Objektklassen: Dieser Abschnitt dient zur weiteren Einschränkung der Suche durch Auswahl von Hilfsklassen. Der Abschnitt ist optional und kann durch Auswahl von Weiter übersprungen werden.

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

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

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol zum Nachladen von Hilfsklassen vom LDAP Endpoint. Dies kann nützlich sein, wenn Sie dem LDAP Endpoint kürzlich Zusatzklassen 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. 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 eine oder mehrere Hilfsklassen auszuwählen. Klassen. Klicken Sie dann auf das Symbol „Entfernen“, um ausgewählte Klassen in die Spalte „Verfügbare Hilfsklassen“ zurückzusetzen:

      

• 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: Einstellungen festlegen

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

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

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

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol , um Attribute aus dem LDAP Endpoint. Dies kann nützlich sein, wenn Sie dem LDAP Endpoint kürzlich Attribute hinzugefügt haben.

  • Hinzufügen eines Attributs: Doppelklicken Sie innerhalb der Spalte irgendwo auf eine Zeile, um das Attribut zum in der Spalte Filterausdruck auf der rechten Seite. Bearbeiten Sie dann den Filterausdruck nach Bedarf, um einen gültigen Ausdruck.

• Filterausdruck: Geben Sie einen Filterausdruck ein.

  Der Filterausdruck muss mindestens die vorab ausgefüllte Strukturklasse enthalten, die in Schritt 1: Geben Sie einen Namen ein und wählen Sie eine Strukturklasse aus. Beim Ändern der ausgewählten Strukturklasse in Schritt 1 wird der vorhandene Filterausdruck vollständig durch den neu vorab ausgefüllte Strukturklasse.

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

  Notiz

  Abhängig von den Anforderungen des LDAP Endpoint müssen Sie möglicherweise die Groß-/Kleinschreibung des vorab ausgefüllten Filterausdrucks für die Strukturklasse ändern. Ändern Sie beispielsweise ObjectClass Zu objectClass.

• Bereich: Geben Sie den Bereich an, der für die Suche verwendet werden soll, entweder Objekt (Basis), Eine Ebene oder Teilbaum:

  • Objekt (Basis): Es wird nur der im Feld Basis-DN angegebene Eintrag durchsucht, untergeordnete Elemente nicht eingeschlossen.

  • Eine Ebene: Es werden nur die unmittelbar untergeordneten Elemente des im Feld Basis-DN angegebenen Eintrags durchsucht. ohne den Basis-DN-Eintrag selbst.

  • Unterbaum: Der im Feld Basis-DN angegebene Eintrag und alle seine untergeordneten Einträge in beliebiger Tiefe werden durchsucht.

• Seitengröße: Geben Sie die Anzahl der Datensätze ein, die für jede Anfrage zurückgegeben werden sollen. Die Aktivität sendet so viele Anfragen wie erforderlich, um alle Datensätze zurückzugeben. Dieser Parameter kann durch die konfigurierte Größenbeschränkung auf dem jeweiligen LDAP Server begrenzt sein.

• 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 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.

Schritt 4: Überprüfen der Datenschemata

• Datenschema: Das Schema für eine LDAP Sucheintrag-Aktivität wird 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:

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

• 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.

• Bearbeiten: Klicken Sie auf das Bearbeitungssymbol über dem Schema, um den Editor aufzurufen. Mit dem Editor können Sie Knoten und Felder hinzufügen, löschen und neu organisieren sowie deren Datentypen ändern. Alle neu hinzugefügten Knoten und Felder werden auf [0, 1]Kardinalität. Änderungen am Schema müssen für den Endpoint akzeptabel sein und sollten nur nach Durchsicht der verfügbaren Dokumentation für den Endpoint vorgenommen werden. Nach der Durchführung von Schema wird oben im entsprechenden Schema ein Datum der letzten Bearbeitung angezeigt, um darauf hinzuweisen, dass das Schema manuell bearbeitet wurde. Durch Aktualisieren des Schema wird das Schema auf seine Standardstruktur zurückgesetzt.

• 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 Sucheintragsaktivität 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 Sucheintrag-Aktivitäten können mit diesen Operation als Quelle verwendet werden:

• Transformation
• Zwei-Ziel-Archivmuster (nur als erste Quelle)
• HTTP-Archivmuster mit zwei Zielen (nur als erste Quelle)
• Zwei-Transformationsmuster (als erste oder zweite Quelle)

Andere Muster sind bei LDAP Sucheintragsaktivitäten 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.

Verwandte Seiten

• LDAP -Konnektor
• LDAP -Verbindung
• LDAP Eintrag hinzufügen
• LDAP Eintrag ändern
• LDAP Eintrag löschen