Aktivität „Abfrage-AD“

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 1 Minute Lesedauer
  • Die Aktivität „Abfrage-AD“ ruft Einträge aus Windows Active Directory basierend auf einem LDAP-Suchfilter ab und speichert die Ergebnisse als JSON-Zeichenfolge, die im Datenbus verwendet werden kann.

    Um im Workflow-Editor auf diese Aktivität zuzugreifen, wählen Sie die Registerkarte Benutzerdefiniert aus und navigieren dann zu Benutzerdefinierte Aktivitäten > Active Directory > .
    Hinweis:
    Diese Aktivität ersetzt eine AD-Aktivität mit demselben Namen, die in Releases vor Geneva verfügbar war. Wenn ein Workflow die veraltete Aktivität verwendet, funktioniert Ihr Workflow nach dem Upgrade auf Istanbul weiterhin normal, und die Abfrageergebnisse werden weiterhin im Scratchpad gespeichert. Alle neuen Workflows müssen jedoch die benutzerdefinierte Version dieser Aktivität verwenden. Diese Aktivität wurde mit der PowerShell-Aktivitäten erstellen erstellt, die Eingabe- und Ausgabevariablen im Datenbus anstatt im Scratchpad speichert.

    Eingabevariablen

    Tabelle : 1. Eingabevariablen für „Abfrage-AD“
    Variable Beschreibung
    DomainController IP-Adresse des Computers mit dem Domänencontroller.
    Properties Eine kommagetrennte Liste der zurückgegebenen Active Directory-Eigenschaften. Beispielsweise givenName,SN,title. Wenn dieses Feld leer ist, werden alle Eigenschaften zurückgegeben.
    SearchFilter Eine LDAP-Filterzeichenfolge, die die Suchparameter definiert. Verwenden Sie beliebige gültige LDAP-Filterkriterien. Um beispielsweise Benutzeraccounts zu suchen, die mit dem ServiceNow-Eingabedatensatz übereinstimmen, verwenden Sie:
    (samaccountname=${workflow.inputs.u_user.user_name})

    Ausgabevariablen

    Tabelle : 2. Ausgabevariablen für „Abfrage-AD“
    Variable Beschreibung
    result Entweder success oder failure
    errorMessage Die executionResult.errorMessages aus den Analysequellen des Aktivitätendesigners.
    Ausgabe Das Ergebnis der Abfrage.

    Bedingungen

    Tabelle : 3. Bedingungen für „Abfrage-AD“
    Bedingung Beschreibung
    Success Die Abfrage wurde wie erwartet abgeschlossen.
    Failure Bei der Verarbeitung der Abfrage ist ein Fehler aufgetreten. Weitere Details sind möglicherweise im Workflow-Protokoll verfügbar.