Aktivität „Abfrage-AD“

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 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 auf diese Aktivität im Workflow-Editor zuzugreifen, wählen Sie aus Anwenderdefiniert Registerkarte und navigieren Sie dann zu Anwenderdefinierte Aktivitäten > Active Directory > an.
    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. Zum Beispiel 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.errorMessagesVon 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.