[クエリー AD] アクティビティ

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：1分

    • [クエリー AD] アクティビティは、LDAP 検索フィルターに基づいて Windows Active Directory からエントリーを取得し、この結果をデータバスで使用できる JSON 文字列として保存します。

    ワークフローエディターでこのアクティビティにアクセスするには、[ カスタム ] タブを選択し、 カスタムアクティビティ > Active Directory > .
    注:
    このアクティビティによって、Geneva より前のリリースで使用可能な同じ名前の AD アクティビティが置き換えられます。廃止されたアクティビティを使用するワークフローがある場合、このワークフローは、Instanbul にアップグレードした後も引き続き正常に機能し、クエリー結果をスクラッチパッドに保存し続けます。ただし、新しいワークフローはすべて、このアクティビティのカスタムバージョンを使用する必要があります。このアクティビティは PowerShell アクティビティを作成するで作成されており、スクラッチパッドの代わりに入力変数と出力変数をデータバスに保存します。

    入力変数

    表 : 1. [クエリー AD] 入力変数
    変数 説明
    DomainController ドメインコントローラーマシンの IP アドレス。
    プロパティ 返す Active Directory プロパティのカンマ区切りリスト。givenName,SN,title など。このフィールドが空白の場合は、すべてのプロパティが返されます。
    SearchFilter 検索パラメーターを定義する LDAP フィルター文字列。有効な LDAP フィルタリング条件を使用します。たとえば、ServiceNow 入力レコードと一致するユーザーアカウントを検索するには、次のようになります。
    (samaccountname=${workflow.inputs.u_user.user_name})

    出力変数

    表 : 2. [クエリー AD] 出力変数
    変数 説明
    result success または failure。
    errorMessage アクティビティデザイナーの解析ソースからの executionResult.errorMessages。
    output クエリー結果。

    条件

    表 : 3. [クエリー AD] 条件
    条件 説明
    成功 クエリーが予定どおりに完了しました。
    失敗 クエリーの処理中にエラーが発生しました。詳細がワークフローログに記録されている場合があります。