LDAP-Abfrage

Aktionen des Typs LDAP-Abfrage ermöglicht es, eine LDAP-Abfrage gegen einen LDAP-Server auszuführen, um Daten von diesem Server abzuholen. Hierzu muss vorher eine LDAP-Verbindung im System konfiguriert worden sein. Weiterhin ist es möglich, die Rückgabewerte zu filtern, sodass nur die benötigten Attribut zurückgegeben werden.

Parameter

Details zur LDAP Abfrage

Konfigurierte LDAP-Abfrage nutzen?

Wenn diese Option ausgewählt wird, kann eine im Backend vorkonfigurierte LDAP-Abfrage ausgewählt werden. Zusätzlichen werden Details zur Abfrage angezeigt.

Mandant-LDAP Verbindung nutzen?

Wenn die Option ausgewählt wird, dann werden die bereits definierten Einstellungen für LDAP unter Mandant verwenden. Dadurch muss keine eigene LDAP-Verbindung eingerichtet werden.

LDAP-Verbindung

LDAP-Verbindung, welche in der Verwaltung vor konfiguriert wurde.

Base DN

Angabe des für die Suche definierten Root-Verzeichnises des Active Directory.

LDAP Abfrage

Textfeld für die eigentliche LDAP Abfrage.

Filter für Rückgabewerte

Attribute können über das Plus-Icon hinzugefügt werden, die bei der LDAP-Abfrage ausgeliefert werden sollen. Ansonsten werden alle Daten ungefiltert zurückgeliefert.

Aktionsplatzhalter

Aktionen vom Typ LDAP Abfrage stellen Aktionsplatzhalter bereit, welche  in darauf folgenden Aktionen verwendet werden können.

Standardplatzhalter

[%$<Aktionsname>.SUCCESS%]

Rückgabe ob Aktion erfolgreich ausgeführt wurde. Liefert Boolean (true/false) zurück.

[%$<Aktionsname>.RESULT%]

Rückgabe aller von der Aktion bereitgestellten Ergebnisse in strukturierter JSON-Form.

[%$<Aktionsname>.ERROR_CODE%]

Der geworfene Fehler-Code im Fehlerfall der Aktion. Leer wenn kein Fehler aufgetreten ist.

[%$<Aktionsname>.ERROR_MESSAGE%]

Die geworfene Fehler-Nachricht im Fehlerfall der Aktion. Leer wenn kein Fehler aufgetreten ist.

Aktionsspezifische Platzhalter

[%$<Aktionsname>.RESULT.rows[i]%]

Enthält die durch die Abfrage ermittelten Ergebnisse in Form eines JSON-Arrays, welches JSON-Objekte enthalten kann. Die Eigenschaften / Attribute eines JSON-Objektes, bestimmt sich aus den zurückgelieferten Eigenschaften des jeweils ermittelten LDAP-Objektes.

Der Parameter i gibt den Index der Zeile an, hierbei ist mit 0 für die erste Zeile zu beginnen. Mittels Punktnotation kann auf die weiteren Attribute zugegriffen werden.

Beispiel RESULT:

Zugriff auf Attribut Mail per Platzhalter: [%$<Aktionsname>.RESULT.rows[0].mail%] 

[%$<Aktionsname>.RESULT.rowsCount%]

Anzahl der durch die Abfrageausführung zurückgelieferten Zeilen. Hat den Wert 0, wenn die Abfrage keine Ergebnisse lieferte oder ein Fehler aufgetreten ist