--- 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_query:スコープ対象、グローバル # v_query:スコープ対象、グローバル {#ariaid-title1} * リリースバージョン: Australia * * 更新日 2026年03月12日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：6分 v_query 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_table](https://servicenow-prod.fluidtopics.net/o89BfxODk_oAdtZJeoRPkQ#v_tableAPI "v_table API は、スクリプト可能オブジェクトを使用してリモートテーブルに行を追加するメソッドを提供します。") API を使用して作成されます。 ## v_query:getCondition(文字列フィールド) {#ariaid-title2} 指定されたフィールドのエンコードされたクエリ文字列を取得します。 「 [v_table](https://servicenow-prod.fluidtopics.net/o89BfxODk_oAdtZJeoRPkQ#v_tableAPI "v_table API は、スクリプト可能オブジェクトを使用してリモートテーブルに行を追加するメソッドを提供します。") API」も参照してください。 {#vquery-getCondition_S__table_j3v_xm3_nlb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | フィールド | 文字列 | フィールドの名前 | [表 : 1. パラメーター] {#vquery-getCondition_S__table_j3v_xm3_nlb} {#vquery-getCondition_S__table_k3v_xm3_nlb__entry__2} | タイプ | 説明 | |-|-| | 文字列 | 指定されたフィールドの [エンコードされたクエリ文字列](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) を返します。 | [表 : 2. 返される内容] {#vquery-getCondition_S__table_k3v_xm3_nlb} 次の例は、 `number=INC0001^active=true` のエンコードクエリを使用したフィールドの結果を示しています。 var result = v_query.getCondition("number"); gs.info(result); 出力: number=INC0001 ## v_query:getEncodedQuery() {#ariaid-title3} リモートテーブルに対するクエリをエンコードされたクエリ文字列として返します 詳細については、「 [エンコードされたクエリ文字列」](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) を参照してください。{#vquery-getEncodedQuery__link_encoded_query_strings} 「 [v_table](https://servicenow-prod.fluidtopics.net/o89BfxODk_oAdtZJeoRPkQ#v_tableAPI "v_table API は、スクリプト可能オブジェクトを使用してリモートテーブルに行を追加するメソッドを提供します。") API」も参照してください。 {#vquery-getEncodedQuery__table_j3v_xm3_nlb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 3. パラメーター] {#vquery-getEncodedQuery__table_j3v_xm3_nlb} {#vquery-getEncodedQuery__table_k3v_xm3_nlb__entry__2} | タイプ | 説明 | |-|-| | 文字列 | 文字列としてのエンコードされたクエリ。 | [表 : 4. 返される内容] {#vquery-getEncodedQuery__table_k3v_xm3_nlb} 次の例は、「 [サードパーティソースから特定のレコードを取得する」](https://www.servicenow.com/docs/access?context=remote-table-script-def-example2&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)の抜粋です。 gs.info(v_query.getEncodedQuery()); 出力: active=true^priority=1 ## v_query:getParameter(文字列フィールド) {#ariaid-title4} 等価クエリ条件のフィールドの値を取得します。 関連項目： * [サードパーティソースから特定のレコードを取得する](https://www.servicenow.com/docs/access?context=remote-table-script-def-example2&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) * [v_table](https://servicenow-prod.fluidtopics.net/o89BfxODk_oAdtZJeoRPkQ#v_tableAPI "v_table API は、スクリプト可能オブジェクトを使用してリモートテーブルに行を追加するメソッドを提供します。") API {#vquery-getParameter_S__ul_y54_hnd_sqb} {#vquery-getParameter_S__table_j3v_xm3_nlb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | フィールド | 文字列 | クエリ対象のフィールドの名前。 | [表 : 5. パラメーター] {#vquery-getParameter_S__table_j3v_xm3_nlb} {#vquery-getParameter_S__table_k3v_xm3_nlb__entry__2} | タイプ | 説明 | |-|-| | 文字列 | クエリ条件のフィールドの値。たとえば、 `name=John` がエンコードされたクエリーである場合、 getParameter("name") は`"John"` を返します。 | [表 : 6. 返される内容] {#vquery-getParameter_S__table_k3v_xm3_nlb} 次の例は、発信者 ID フィールドの値を取得する方法を示しています。 v_query.getParameter("caller_id"); 出力: 12345123451234512345123451234501 ## v_query:getSysId() {#ariaid-title5} get クエリのsys_id値を返します。 {#vquery-getSysId__table_j3v_xm3_nlb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 7. パラメーター] {#vquery-getSysId__table_j3v_xm3_nlb} {#vquery-getSysId__table_k3v_xm3_nlb__entry__2} | タイプ | 説明 | |-|-| | 文字列 | GET クエリの値をSys_idします。たとえば、 `sys_id=123` の場合、このメソッドは 123 を返します。 | [表 : 8. 返される内容] {#vquery-getSysId__table_k3v_xm3_nlb} 次の例は、「 [サードパーティソースから特定のレコードを取得する」](https://www.servicenow.com/docs/access?context=remote-table-script-def-example2&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)の抜粋です。 v_query.getSysId(); 出力: a3a7ffb6dba41010db2051735e4619b7 ## v_query:getTextSearch() {#ariaid-title6} テキスト検索クエリパラメーターを取得します。 関連項目： * [エンコードされたクエリ文字列](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) * [スクリプトでのテーブルのクエリ](https://servicenow-prod.fluidtopics.net/d0~F25Pbj3IA2fvKkDtM9g#c_UsingGlideRecordToQueryTables "GlideRecord API のメソッドを使用すると、テーブルからすべてのレコードを返したり、テーブルから特定の条件を満たすレコードを返したり、テキストインデックスグループ内の単一のテーブルまたは複数のテーブルから文字列を含むレコードを返したりできます。") * [v_table](https://servicenow-prod.fluidtopics.net/o89BfxODk_oAdtZJeoRPkQ#v_tableAPI "v_table API は、スクリプト可能オブジェクトを使用してリモートテーブルに行を追加するメソッドを提供します。") API {#vquery-getTextSearch__ul_a2q_rkp_nlb} {#vquery-getTextSearch__table_j3v_xm3_nlb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 9. パラメーター] {#vquery-getTextSearch__table_j3v_xm3_nlb} {#vquery-getTextSearch__table_k3v_xm3_nlb__entry__2} | タイプ | 説明 | |-|-| | 文字列 | テキスト検索クエリパラメーター ( メールなど)。 | [表 : 10. 返される内容] {#vquery-getTextSearch__table_k3v_xm3_nlb} 次の例では、クエリに `GOTO123TEXTQUERY321=email` などのテキストクエリパラメーターが含まれている場合に、このメソッドは true を返します。 // for query value GOTO123TEXTQUERY321=email v_query.getTextSearch(); 出力: email ## v_query:isGet() {#ariaid-title7} クエリが get クエリーであるか、つまりsys_idによってレコードを取得するクエリーであるかを判断します。 関連項目： * [サードパーティソースから特定のレコードを取得する](https://www.servicenow.com/docs/access?context=remote-table-script-def-example2&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) * [v_table](https://servicenow-prod.fluidtopics.net/o89BfxODk_oAdtZJeoRPkQ#v_tableAPI "v_table API は、スクリプト可能オブジェクトを使用してリモートテーブルに行を追加するメソッドを提供します。") API {#vquery-isGet__ul_y54_hnd_sqb} {#vquery-isGet__table_j3v_xm3_nlb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 11. パラメーター] {#vquery-isGet__table_j3v_xm3_nlb} {#vquery-isGet__table_k3v_xm3_nlb__entry__2} | タイプ | 説明 | |-|-| | ブーリアン | フラグは、特定のレコードのクエリのクエリ形式が `sys_id=` であることを示します。 有効な値： * true:クエリには、sys_idフィールドの等価クエリ条件が含まれています。 * false:クエリにsys_idフィールドの等価クエリ条件が含まれません。 {#vquery-isGet__ul_jdl_pfb_add} | [表 : 12. 返される内容] {#vquery-isGet__table_k3v_xm3_nlb} 次の例では、エンコードされたクエリが `sys_id=d1954c744662010bd7e061e67a6776e` の場合、 v_query.isGet() メソッドは true を返します。エンコードされたクエリがそれ以外のもの ( `Number=INC0000001` など) の場合、 v_query.isGet() メソッドは false を返します。 // Virtual table to query var row = { sys_id: "d1954c744662010bd7e061e67a6776e", number: "INC0000001", short_description: "New laptop request", u_balance: 1200.23 }; v_table.addRow(row); v_query.isGet(); ## v_query:isTextSearch() {#ariaid-title8} クエリにテキストクエリパラメーターが含まれているかどうかを示します。 関連項目： * [エンコードされたクエリ文字列](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) * [スクリプトでのテーブルのクエリ](https://servicenow-prod.fluidtopics.net/d0~F25Pbj3IA2fvKkDtM9g#c_UsingGlideRecordToQueryTables "GlideRecord API のメソッドを使用すると、テーブルからすべてのレコードを返したり、テーブルから特定の条件を満たすレコードを返したり、テキストインデックスグループ内の単一のテーブルまたは複数のテーブルから文字列を含むレコードを返したりできます。") * [v_table](https://servicenow-prod.fluidtopics.net/o89BfxODk_oAdtZJeoRPkQ#v_tableAPI "v_table API は、スクリプト可能オブジェクトを使用してリモートテーブルに行を追加するメソッドを提供します。") API {#vquery-isTextSearch__ul_a2q_rkp_nlb} {#vquery-isTextSearch__table_j3v_xm3_nlb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 13. パラメーター] {#vquery-isTextSearch__table_j3v_xm3_nlb} {#vquery-isTextSearch__table_k3v_xm3_nlb__entry__2} | タイプ | 説明 | |-|-| | ブーリアン | クエリにテキストクエリパラメーターが含まれているかどうかを示すフラグ。 有効な値： * true:クエリにテキストクエリパラメーターが含まれています。 * false:クエリにテキストクエリパラメーターが含まれていません。 {#vquery-isTextSearch__ul_jdl_pfb_add} | [表 : 14. 返される内容] {#vquery-isTextSearch__table_k3v_xm3_nlb} 次の例では、クエリに `GOTO123TEXTQUERY321=email` などのテキストクエリパラメーターが含まれている場合に、このメソッドは true を返します。 v_query.isTextSearch(); ## v_query:setLastErrorMessage(文字列メッセージ) {#ariaid-title9} GlideRecord の最後のエラーメッセージを設定します。 関連項目： * [スコープ付き GlideRecord - getLastErrorMessage()](https://servicenow-prod.fluidtopics.net/sq3Fh7Z2Yb_KuRvql0AZmg#c_GlideRecordScopedAPI "スコープ対象の GlideRecord API は、データベース操作に使用されます。") * [サードパーティソースから特定のレコードを取得する](https://www.servicenow.com/docs/access?context=remote-table-script-def-example2&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) * [v_table](https://servicenow-prod.fluidtopics.net/o89BfxODk_oAdtZJeoRPkQ#v_tableAPI "v_table API は、スクリプト可能オブジェクトを使用してリモートテーブルに行を追加するメソッドを提供します。") API {#vquery-setLastErrorMessage_S__ul_dbm_rvc_sqb} {#vquery-setLastErrorMessage_S__table_j3v_xm3_nlb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | message | 文字列 | エラーメッセージ。 | [表 : 15. パラメーター] {#vquery-setLastErrorMessage_S__table_j3v_xm3_nlb} {#vquery-setLastErrorMessage_S__table_k3v_xm3_nlb__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 16. 返される内容] {#vquery-setLastErrorMessage_S__table_k3v_xm3_nlb} 次の例は、エラーメッセージの設定に使用される基本構造を示しています。 (function executeQuery (v_table, v_query) { try { // Add code to test for errors during execution } catch(ex) { v_query.setLastErrorMessage(ex.message); } }) (v_table, v_query); 次の例は、REST API で最後のエラーメッセージを設定する方法を示しています。 (function executeQuery (v_table, v_query) { try { // call a REST API } catch(ex) { v_query.setLastErrorMessage("Error obtaining results from remote service"); } }) (v_table, v_query);