Azure AD-Aktivität „Benutzerinfo abrufen“

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 1 Minute Lesedauer

    • Die Aktivität „Benutzerinfo abrufen“ gibt die Informationen des angegebenen Benutzers aus Azure Active Directory zurück.

    Um im Workflow-Editor auf diese Aktivität zuzugreifen, wählen Sie die Registerkarte Benutzerdefiniert aus und navigieren dann zu Benutzerdefinierte Aktivitäten > Azure AD. Diese Aktivität wurde mit der REST-Webservice-Aktivitätsvorlage erstellt.

    Wichtig:
    Die für diese Aktivität verwendete REST-Nachricht muss für die Verwendung von OAuth 2.0konfiguriert sein.

    Eingabevariablen

    Tabelle : 1. Eingabevariablen für „Benutzerinfo abrufen“
    Variable Beschreibung
    user_id Die Objekt-ID (GUID) oder der Benutzerprinzipalname des Zielbenutzers. Ein Beispiel für einen Benutzerprinzipalnamen ist someuser@a830edad9050849NDA1.onmicrosoft.com.
    Hinweis:
    Version 2 dieser Aktivität erzwingt die Überprüfung der Eingabe. Wenn die Variable leer ist, wird die folgende Meldung angezeigt: „Pflichtfeld ‚user_id‘ ist leer“.
    .

    Ausgabevariablen

    Tabelle : 2. Ausgabevariablen für „Benutzerinfo abrufen“
    Variable Beschreibung
    Fehler Gibt die Fehlerzeichenfolge aus der REST-Nachricht zurück. Wenn keine Fehler vorliegen, gibt diese Variable einen Nullwert zurück.
    body Enthält einen Zeichenfolgewert, der die Ausgabe der REST-Nachricht darstellt
    status_code Enthält den vom Webservice zurückgegebenen Statuscode
    user_info Das Array user_info enthält Attribute, die von anderen Aktivitäten als Eingaben genutzt werden können. Beispielsweise kann die Benutzer-objectid-Ausgabe (GUID) als Aktivität an die Aktivität „Benutzer zu Gruppe hinzufügen“ als user_id-Eingabe übergeben werden.
    • objectid: Der Azure AD-Bezeichner des Benutzers.
    • accountEnabled: Boolesche Variable, die angibt, ob der Account des Benutzers aktiv oder inaktiv ist.
    • displayName: Anzeigename des Benutzers, z. B. jacinto.gawron.
    • userPrincipalName: Benutzername im E-Mail-Format, z. B. jacinto.gawron@wammo.com.
    • mailNickname: E-Mail-Alias des Benutzers.

    Bedingungen

    Tabelle : 3. Bedingungen für „Benutzerinfo abrufen“
    Bedingung Beschreibung
    User exists Die Aktivität hat den angegebenen Benutzer gefunden.
    Benutzer nicht vorhanden Die Aktivität konnte den angegebenen Benutzer in der Domäne des Kundenmandanten nicht finden.
    Failure Aktivität konnte keine Verbindung zu Azure AD herstellen.