---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

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

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

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](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=australia&pubname=australia-servicenow-platform&ft:locale=en-US)」を参照してください。

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

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

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

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

| 名前 | タイプ | 説明 |
|-|-|-|
| 行 | オブジェクト | キーがフィールド名であるフィールド名と値マップを含む JavaScript オブジェクト ( `例:{number: "INC0001", sys_id: "a34"}`)。 { "<field name>": "value" } |
| row.\<field 値\> | 文字列 | 選択したフィールドの値を表します。必須フィールドはありませんが、少なくとも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/H0scYs6D9UlVcvOgvQwKzw#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);