---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# v_table -- スコープ、グローバル

# v_table -- スコープ、グローバル {#ariaid-title1}

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

v_table API は、スクリプト可能オブジェクトを介してリモートテーブルに行を追加するメソッドを提供します。

この API では、リモートテーブルプラグイン (com.glide.script.vtable) をアクティブ化する必要があります。 詳細については、「 [リモートテーブルとスクリプトを使用した外部データの取得](https://www.servicenow.com/docs/access?context=remote-tables&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)」を参照してください。

[v_query](https://servicenow-prod.fluidtopics.net/~bWrZjItiZLnETjo0oIXYQ#v_queryAPI "v_query API は、リモートテーブルに対して実行中のクエリを表すスクリプト可能オブジェクトに関する情報を取得するためのメソッドを提供します。") スクリプト可能オブジェクトを使用して、リモートテーブルをクエリーします。

## v_table - addRow(オブジェクト row) {#ariaid-title2}

リモートテーブルに行を追加します。
関連項目：

* [リモートテーブルのスクリプト定義の作成](https://www.servicenow.com/docs/access?context=create-remote-table-script&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)
* [SoR でリモート情報をルックアップ](https://www.servicenow.com/docs/access?context=fso-int_guide-agt_table_lookup&version=xanadu&pubname=xanadu-financial-services-operations&ft:locale=en-US)
* [サードパーティソースからの特定のレコードの取得](https://www.servicenow.com/docs/access?context=remote-table-script-def-example2&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)
* [v_query API](https://servicenow-prod.fluidtopics.net/~bWrZjItiZLnETjo0oIXYQ#v_queryAPI "v_query API は、リモートテーブルに対して実行中のクエリを表すスクリプト可能オブジェクトに関する情報を取得するためのメソッドを提供します。")
{#v_table-addRow_O__ul_eyp_csw_rqb}
{#v_table-addRow_O__table_udd_bdj_nlb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| row | オブジェクト | キーがフィールド名であるフィールド名と値のマップを含む JavaScript オブジェクト。例：`{number: "INC0001", sys_id: "a34"}` { "<field name>": "value" } |
| row.\<フィールド値\> | 文字列 | 選択したフィールドの値を表します。必須のフィールドはありませんが、最低でも sys_id は指定してください。 sys_id フィールドと値のみを一覧表示する例： { "sys_id": "<uniqueID>" } |
[表 : 1. パラメーター]

{#v_table-addRow_O__table_udd_bdj_nlb} {#v_table-addRow_O__table_vdd_bdj_nlb__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | 行がリモートテーブルに追加されたかどうかを示すフラグ。 有効な値： * true：成功。 * false：行が追加されなかった。 {#v_table-addRow_O__ul_jdl_pfb_add} |
[表 : 2. 返される内容]

{#v_table-addRow_O__table_vdd_bdj_nlb}  
次の例は、[RESTMessageV2](https://servicenow-prod.fluidtopics.net/dEW26yzz5G5FEsAw7yx4UQ#c_RESTMessageV2API "RESTMessageV2 API には、JavaScript を使用して送信 REST メッセージを送信できるメソッドが用意されています。") API を使用して、外部の銀行アプリケーションへの REST 呼び出しを作成して実行する方法を示しています。このスクリプトが示すのは、addRow() メソッドを使用して、返された結果をリモートテーブルに格納する方法です。

    (function executeQuery (v_table, v_query) {
      // Parameters needed in the request body of the REST endpoint
      var requestBody = {
        'financial_account':v_query.getParameter('financial_account')
      };

      // Instantiate the RESTMessageV2 object
      var request = new sn_ws.RESTMessageV2();
      // Set the HTTP method as "GET"
      request.setHttpMethod('get');
      // URL of the endpoint on the bank application
      request.setEndpoint('https://<yourbankapphost>/api/getTransactionDetails');
      // Request body as a string
      request.setRequestBody(JSON.stringify(requestBody));
      // Call the REST endpoint
      var response = request.execute();
      // Get the response body
      var responseBody = response.getBody();
      // Parse the response body into an object
      var responseObj = JSON.parse(responseBody);

      // Store the response body into a virtual table
      v_table.addRow({
        sys_id: gs.generateGUID(),
        amount: responseObj.amount,
        description: responseObj.description,
        posting_date: responseObj.posting_date,
        transaction_date: responseObj.transaction_date
      });

    }) (v_table, v_query);