---
sourceDocument: Yokohama データと自動化
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/integrate-applications

 Release :

    - yokohama

ft:locale :

    - ja-JP

ft:publication_title :

    - Yokohama データと自動化

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

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

# \[クエリー AD\] アクティビティ {#ariaid-title1}

* リリースバージョン: Yokohama
* 
* 更新日 2025年01月30日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：1分

\[クエリー AD\] アクティビティは、LDAP 検索フィルターに基づいて Windows Active Directory からエントリーを取得し、この結果をデータバスで使用できる JSON 文字列として保存します。
ワークフローエディターでこのアクティビティにアクセスするには、\[ カスタム\] タブを選択し、 カスタムアクティビティActive Directory.  
注:  
このアクティビティによって、Geneva より前のリリースで使用可能な同じ名前の AD アクティビティが置き換えられます。廃止されたアクティビティを使用するワークフローがある場合、このワークフローは、Instanbul にアップグレードした後も引き続き正常に機能し、クエリー結果をスクラッチパッドに保存し続けます。ただし、新しいワークフローはすべて、このアクティビティのカスタムバージョンを使用する必要があります。このアクティビティは [PowerShell アクティビティを作成する](https://servicenow-prod.fluidtopics.net/YIFjK9VurG8Gt1MVOuEAJg#t_CreateAPowershellActivity "Microsoft PowerShell を使用してホストからワークフローにデータを返すために、カスタム PowerShell アクティビティを作成します。")で作成されており、スクラッチパッドの代わりに入力変数と出力変数を[データバス](https://servicenow-prod.fluidtopics.net/c4jtr4VawysDg35poR3blw#t_ReuseDataInTheActivityDesigner "ワークフローエディターの [データ] タブには、現在のワークフローで使用されている、データを生成するすべてのカスタムアクティビティがリストされ、そのデータが他のカスタムアクティビティで再利用するために表示されます。")に保存します。

## 入力変数

{#r_QueryAD__table_qjs_44h_dp__entry__2}

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

{#r_QueryAD__table_qjs_44h_dp}

## 出力変数

{#r_QueryAD__table_o54_yc1_ts__entry__2}

| 変数 | 説明 |
|-|-|
| 結果 | success または failure。 |
| errorMessage | [アクティビティデザイナーの解析ソース](https://servicenow-prod.fluidtopics.net/WcjbpLvpo7gVqPKWISlRNQ#r_ActivityDesignerParsingSources "次の表に、各実行テンプレートで使用可能な解析ソースを示します。")からの executionResult.errorMessages。 |
| 出力 | クエリー結果。 |
[表 : 2. \[クエリー AD\] 出力変数]

{#r_QueryAD__table_o54_yc1_ts}

## 条件

{#r_QueryAD__table_r4q_cd1_ts__entry__2}

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

{#r_QueryAD__table_r4q_cd1_ts}