[ユーザー情報を取得] Azure AD アクティビティ

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間:2分
  • [ユーザー情報を取得] アクティビティは、Azure Active Directory から名前付きユーザーの情報を返します。

    ワークフローエディターでこのアクティビティにアクセスするには、[ カスタム ] タブを選択し、 カスタムアクティビティ > Azure AD. このアクティビティは、REST Web サービスアクティビティテンプレートを使用して作成されています。

    重要:
    このアクティビティに使用される REST メッセージは、OAuth 2.0 を使用するように設定する必要があります。

    入力変数

    表 : 1. [ユーザーの存在を確認] 入力変数
    変数 説明
    user_id オブジェクト ID (GUID) またはターゲットユーザーのユーザープリンシパル名。ユーザープリンシパル名の例は someuser@a830edad9050849NDA1.onmicrosoft.com です
    注:
    このアクティビティのバージョン 2 では、入力妥当性確認が行われます。空の場合、次のメッセージが表示されます。「Mandatory input 'user_id' is empty」

    出力変数

    表 : 2. [ユーザーの存在を確認] 出力変数
    変数 説明
    エラー REST メッセージからエラー文字列を返します。エラーがない場合、この変数は null 値を返します。
    本文 REST メッセージの出力を表す文字列値が含まれます。
    status_code Web サービスから返されたステータスコードが含まれます。
    user_info user_info アレイには、入力として他のアクティビティで活用できる属性が含まれます。たとえば、ユーザー objectid 出力 (GUID) を [グループにユーザーを追加] アクティビティに user_id 入力として渡すことができます。
    • objectid:ユーザーの Azure AD 識別子。
    • accountEnabled:ユーザーのアカウントがアクティブと非アクティブのどちらであるかを示すブーリアン変数
    • displayNamejacinto.gawron などのユーザーの表示名。
    • userPrincipalNamejacinto.gawron@wammo.com など、メール形式のユーザー名。
    • mailNickname:ユーザーのメールエイリアス。

    条件

    表 : 3. [ユーザーの存在を確認] 条件
    条件 説明
    ユーザーが存在します アクティビティが名前付きユーザーを検出しました。
    ユーザーは存在しません アクティビティが顧客テナントドメインで名前付きユーザーを見つけることができませんでした。
    失敗 アクティビティが Azure AD に接続できませんでした。