---
sourceDocument: Yokohama 対話型インターフェース
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/conversational-interfaces

 Release :

    - yokohama

ft:locale :

    - ja-JP

ft:publication_title :

    - Yokohama 対話型インターフェース

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# ルックアップユーティリティ

# ルックアップユーティリティ {#ariaid-title1}

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

仮想エージェントトピックでルックアップ ユーティリティを使用し、ServiceNow レコード クエリを返します。

## ルックアップユーティリティのプロパティ {#va-lookup__section_xwb_mgn_pdb}

{#va-lookup__table_nff_y1b_3db__entry__2}

| 財産 | 説明 |
|-|-|
| ノード名 | トピックフローでこのルックアップユーティリティノードを識別する名前。 |
| 変数名 | スクリプトによって返されたレコードを格納する変数です。変数名は、ノード名プロパティから自動的に作成されます。 |
| テーブル | クエリに使用されるテーブルです。 |
| このテーブルのフィルター手段 | レコードを取得するためのクエリです。条件ビルダーまたはスクリプトを使用して、クエリ条件を指定します。 |
| 詳細 ||
| このノードを非表示 ||
| 次の場合、このノードを条件付きで表示します | 会話でこのノードを表示するための条件を指定するノーコード条件ステートメントまたはローコードスクリプト。条件は true と評価される必要があります。 |
[ ]

{#va-lookup__table_nff_y1b_3db}

## ルックアップ ユーティリティの例 {#va-lookup__section_jxd_nh5_tdb}

図 : 1. ルックアップユーティリティの基本プロパティ

## ルックアップスクリプトの例 {#va-lookup__section_xzk_f3n_vdb}

    (function execute(table) {

           var now_GR = new GlideRecord(table);
           gr.addEncodedQuery('active=true');
           gr.setLimit(1);
           gr.query();
           if(gr.next()) {
              return gr;
        }
    })(table)

この例では、テーブルの最初のアクティブなレコードをクエリします。照会するテーブルは、ルックアップ ユーティリティ コントロールにあるテーブルプロパティで定義します。`setLimit()` メソッドは、単一のレコードだけがデータベースから返されるようにします。レコードが見つかった場合は、そのレコードが返されます。GlideRecord クエリの詳細については、「[スクリプトでのテーブルのクエリ](https://www.servicenow.com/docs/access?context=c_UsingGlideRecordToQueryTables&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)」を参照してください。