--- 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_query -- スコープ、グローバル # v_query -- スコープ、グローバル {#ariaid-title1} * リリースバージョン: Xanadu * * 更新日 2024年08月01日 * * ![](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=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)」を参照してください。 リモートテーブルの行は、[v_table](https://servicenow-prod.fluidtopics.net/SGpFRoOpc~CovjcUTzOryQ#v_tableAPI "v_table API は、スクリプト可能オブジェクトを介してリモートテーブルに行を追加するメソッドを提供します。") API を使用して作成されます。 ## v_query - getCondition(文字列 field) {#ariaid-title2} 指定されたフィールドのエンコードされたクエリー文字列を取得します。 「[v_table](https://servicenow-prod.fluidtopics.net/SGpFRoOpc~CovjcUTzOryQ#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=xanadu&pubname=xanadu-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=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) を参照してください。{#vquery-getEncodedQuery__link_encoded_query_strings} 「[v_table](https://servicenow-prod.fluidtopics.net/SGpFRoOpc~CovjcUTzOryQ#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=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)」の抜粋です。 gs.info(v_query.getEncodedQuery()); 出力: active=true^priority=1 ## v_query - getParameter(文字列 field) {#ariaid-title4} 等価性クエリー条件のフィールドの値を取得します。 関連項目： * [サードパーティソースからの特定のレコードの取得](https://www.servicenow.com/docs/access?context=remote-table-script-def-example2&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) * [v_table](https://servicenow-prod.fluidtopics.net/SGpFRoOpc~CovjcUTzOryQ#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=xanadu&pubname=xanadu-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=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) * [スクリプトでのテーブルのクエリ](https://www.servicenow.com/docs/access?context=c_UsingGlideRecordToQueryTables&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US) * [v_table](https://servicenow-prod.fluidtopics.net/SGpFRoOpc~CovjcUTzOryQ#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} | タイプ | 説明 | |-|-| | 文字列 | テキスト検索クエリーのパラメーター (例：email)。 | [表 : 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=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) * [v_table](https://servicenow-prod.fluidtopics.net/SGpFRoOpc~CovjcUTzOryQ#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=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) * [スクリプトでのテーブルのクエリ](https://www.servicenow.com/docs/access?context=c_UsingGlideRecordToQueryTables&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US) * [v_table](https://servicenow-prod.fluidtopics.net/SGpFRoOpc~CovjcUTzOryQ#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(文字列 message) {#ariaid-title9} GlideRecord の最後のエラーメッセージを設定します。 関連項目： * [スコープ対象 GlideRecord - getLastErrorMessage()](https://servicenow-prod.fluidtopics.net/DKnkjnu3r0c8j~e5s2NNhg#c_GlideRecordScopedAPI "スコープ付き GlideRecord API はデータベース操作に使用されます。") * [サードパーティソースからの特定のレコードの取得](https://www.servicenow.com/docs/access?context=remote-table-script-def-example2&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) * [v_table](https://servicenow-prod.fluidtopics.net/SGpFRoOpc~CovjcUTzOryQ#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);