---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# v_query: Bereichsbezogen, global

# v_query: Bereichsbezogen, global {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

Die v_query Die API bietet Methoden zum Abrufen von Informationen zu einem skriptfähigen Objekt, das eine Abfrage darstellt, die für eine Remote-Tabelle ausgeführt wird.

Diese API erfordert die Aktivierung des Plugins „Remotetabellen" (com.Glide.script.vtable). Weitere Informationen finden Sie unter [Externe Daten werden mithilfe von Remotetabellen und Skripts abgerufen](https://www.servicenow.com/docs/access?context=remote-tables&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US).

Remote-Tabellenzeilen werden mit erstellt [v_table](https://servicenow-prod.fluidtopics.net/~wqJdqm06cc3YtwJ_RbGAQ#v_tableAPI "Die v_table Die API bietet Methoden zum Hinzufügen von Zeilen zu einer Remotetabelle über ein skriptfähiges Objekt.")API.

## v_query -- getCondition (Zeichenfolgenfeld) {#ariaid-title2}

Ruft eine codierte Abfragezeichenfolge für das angegebene Feld ab.
Siehe auch [v_table](https://servicenow-prod.fluidtopics.net/~wqJdqm06cc3YtwJ_RbGAQ#v_tableAPI "Die v_table Die API bietet Methoden zum Hinzufügen von Zeilen zu einer Remotetabelle über ein skriptfähiges Objekt.")API.
{#vquery-getCondition_S__table_j3v_xm3_nlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Ausstehend | Zeichenfolge | Name des Felds. |
[Tabelle : 1. Parameter]

{#vquery-getCondition_S__table_j3v_xm3_nlb} {#vquery-getCondition_S__table_k3v_xm3_nlb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Gibt zurück [Codierte Abfragezeichenfolge](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US)Für das angegebene Feld. |
[Tabelle : 2. Rückgaben]

{#vquery-getCondition_S__table_k3v_xm3_nlb}  
Das folgende Beispiel zeigt Ergebnisse für ein Feld mit einer codierten Abfrage von `Nummer=INC0001^Active=wahr `.

    var result = v_query.getCondition("number");
    gs.info(result);

Ausgabe:

    number=INC0001

## v_query -- getEncodedQuery() {#ariaid-title3}

Gibt die Abfrage für eine Remotetabelle als codierte Abfragezeichenfolge zurück
Weitere Informationen finden Sie unter [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US) .{#vquery-getEncodedQuery__link_encoded_query_strings}

Siehe auch [v_table](https://servicenow-prod.fluidtopics.net/~wqJdqm06cc3YtwJ_RbGAQ#v_tableAPI "Die v_table Die API bietet Methoden zum Hinzufügen von Zeilen zu einer Remotetabelle über ein skriptfähiges Objekt.")API.
{#vquery-getEncodedQuery__table_j3v_xm3_nlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 3. Parameter]

{#vquery-getEncodedQuery__table_j3v_xm3_nlb} {#vquery-getEncodedQuery__table_k3v_xm3_nlb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Die codierte Abfrage als Zeichenfolge. |
[Tabelle : 4. Rückgaben]

{#vquery-getEncodedQuery__table_k3v_xm3_nlb}  
Das folgende Beispiel ist ein Fragment aus [Bestimmte Datensätze werden aus einer Drittparteiquelle abgerufen](https://www.servicenow.com/docs/access?context=remote-table-script-def-example2&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US).

    gs.info(v_query.getEncodedQuery());

Ausgabe:

    active=true^priority=1

## v_query -- getParameter(Zeichenfolgenfeld) {#ariaid-title4}

Ruft den Wert eines Felds in einer Gleichheitsabfragebedingung ab.
Siehe auch:

* [Bestimmte Datensätze werden aus einer Drittparteiquelle abgerufen](https://www.servicenow.com/docs/access?context=remote-table-script-def-example2&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US)
* [v_table](https://servicenow-prod.fluidtopics.net/~wqJdqm06cc3YtwJ_RbGAQ#v_tableAPI "Die v_table Die API bietet Methoden zum Hinzufügen von Zeilen zu einer Remotetabelle über ein skriptfähiges Objekt.")API
{#vquery-getParameter_S__ul_y54_hnd_sqb} {#vquery-getParameter_S__table_j3v_xm3_nlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Ausstehend | Zeichenfolge | Name des abzufragenden Felds. |
[Tabelle : 5. Parameter]

{#vquery-getParameter_S__table_j3v_xm3_nlb} {#vquery-getParameter_S__table_k3v_xm3_nlb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Wert des Felds in der Abfragebedingung. Beispiel: Wenn `Name=John `Ist dann die codierte Abfrage GetParameter("Name") Gibt zurück `„John" `. |
[Tabelle : 6. Rückgaben]

{#vquery-getParameter_S__table_k3v_xm3_nlb}  
Das folgende Beispiel zeigt, wie der Wert eines Anrufer-ID-Felds abgerufen wird.

    v_query.getParameter("caller_id");

Ausgabe:

    12345123451234512345123451234501

## v_query -- getSysId() {#ariaid-title5}

Gibt den sys_ID-Wert in einer GET-Abfrage zurück.
{#vquery-getSysId__table_j3v_xm3_nlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 7. Parameter]

{#vquery-getSysId__table_j3v_xm3_nlb} {#vquery-getSysId__table_k3v_xm3_nlb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | SYS_ID-Wert in der GET-Abfrage, z. B. wenn `sys_ID=123 `, Diese Methode gibt zurück 123 . |
[Tabelle : 8. Rückgaben]

{#vquery-getSysId__table_k3v_xm3_nlb}  
Das folgende Beispiel ist ein Fragment aus [Bestimmte Datensätze werden aus einer Drittparteiquelle abgerufen](https://www.servicenow.com/docs/access?context=remote-table-script-def-example2&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US).

    v_query.getSysId();

Ausgabe:

    a3a7ffb6dba41010db2051735e4619b7

## v_query -- getTextSearch() {#ariaid-title6}

Ruft einen Abfrageparameter für die Textsuche ab.
Siehe auch:

* [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US)
* [Tabellen im Skript werden abgefragt](https://www.servicenow.com/docs/access?context=c_UsingGlideRecordToQueryTables&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US)
* [v_table](https://servicenow-prod.fluidtopics.net/~wqJdqm06cc3YtwJ_RbGAQ#v_tableAPI "Die v_table Die API bietet Methoden zum Hinzufügen von Zeilen zu einer Remotetabelle über ein skriptfähiges Objekt.")API
{#vquery-getTextSearch__ul_a2q_rkp_nlb}
{#vquery-getTextSearch__table_j3v_xm3_nlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 9. Parameter]

{#vquery-getTextSearch__table_j3v_xm3_nlb} {#vquery-getTextSearch__table_k3v_xm3_nlb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Beispiel: Abfrageparameter für Textsuche E-Mail . |
[Tabelle : 10. Rückgaben]

{#vquery-getTextSearch__table_k3v_xm3_nlb}  
Im folgenden Beispiel gibt die Methode „wahr" zurück, wenn die Abfrage einen Textabfrageparameter enthält, z. B. `GOTO123TEXTQUERY321=E-Mail `.

    // for query value GOTO123TEXTQUERY321=email
    v_query.getTextSearch();

Ausgabe:

    email

## v_query -- isGet() {#ariaid-title7}

Bestimmt, ob die Abfrage eine GET-Abfrage ist, d. h. eine Abfrage, die einen Datensatz nach sys_ID abruft
Siehe auch:

* [Bestimmte Datensätze werden aus einer Drittparteiquelle abgerufen](https://www.servicenow.com/docs/access?context=remote-table-script-def-example2&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US)
* [v_table](https://servicenow-prod.fluidtopics.net/~wqJdqm06cc3YtwJ_RbGAQ#v_tableAPI "Die v_table Die API bietet Methoden zum Hinzufügen von Zeilen zu einer Remotetabelle über ein skriptfähiges Objekt.")API
{#vquery-isGet__ul_y54_hnd_sqb} {#vquery-isGet__table_j3v_xm3_nlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 11. Parameter]

{#vquery-isGet__table_j3v_xm3_nlb} {#vquery-isGet__table_k3v_xm3_nlb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung gibt an, dass die Abfrage für einen bestimmten Datensatz hat `sys_ID= `Als Abfrageformat. Gültige Werte: * Wahr: Abfrage enthält Gleichheitsabfragebedingung für das Feld „sys_ID". * Falsch: Abfrage enthält keine Gleichheitsabfragebedingung im Feld „sys_ID". {#vquery-isGet__ul_jdl_pfb_add} |
[Tabelle : 12. Rückgaben]

{#vquery-isGet__table_k3v_xm3_nlb}  
Im folgenden Beispiel, wenn die codierte Abfrage lautet `sys_ID=d1954c744662010bd7e061e67a6776e `, v_query.isGet() Methode gibt „wahr" zurück. Wenn die codierte Abfrage etwas anderes ist, z. B. `Nummer=INC0000001 `, v_query.isGet() Methode gibt „falsch" zurück.

    // 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}

Gibt an, ob die Abfrage einen Textabfrageparameter enthält.
Siehe auch:

* [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US)
* [Tabellen im Skript werden abgefragt](https://www.servicenow.com/docs/access?context=c_UsingGlideRecordToQueryTables&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US)
* [v_table](https://servicenow-prod.fluidtopics.net/~wqJdqm06cc3YtwJ_RbGAQ#v_tableAPI "Die v_table Die API bietet Methoden zum Hinzufügen von Zeilen zu einer Remotetabelle über ein skriptfähiges Objekt.")API
{#vquery-isTextSearch__ul_a2q_rkp_nlb}
{#vquery-isTextSearch__table_j3v_xm3_nlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 13. Parameter]

{#vquery-isTextSearch__table_j3v_xm3_nlb} {#vquery-isTextSearch__table_k3v_xm3_nlb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob die Abfrage einen Textabfrageparameter enthält. Gültige Werte: * Wahr: Abfrage enthält einen Textabfrageparameter. * Falsch: Abfrage enthält keinen Textabfrageparameter. {#vquery-isTextSearch__ul_jdl_pfb_add} |
[Tabelle : 14. Rückgaben]

{#vquery-isTextSearch__table_k3v_xm3_nlb}  
Im folgenden Beispiel gibt die Methode „wahr" zurück, wenn die Abfrage einen Textabfrageparameter enthält, z. B. `GOTO123TEXTQUERY321=E-Mail `.

    v_query.isTextSearch();

## v_query -- setLastErrorMessage(Zeichenfolgennachricht) {#ariaid-title9}

Legt die letzte Fehlermeldung im GlideRecord fest.
Siehe auch:

* [Bereichsbezogener GlideRecord -- getLastErrorMessage()](https://servicenow-prod.fluidtopics.net/pr75jggqt1vPfwd6tbA7gQ#c_GlideRecordScopedAPI "Der Umfang ist festgelegt GlideRecord API wird für Datenbankvorgänge verwendet.")
* [Bestimmte Datensätze werden aus einer Drittparteiquelle abgerufen](https://www.servicenow.com/docs/access?context=remote-table-script-def-example2&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US)
* [v_table](https://servicenow-prod.fluidtopics.net/~wqJdqm06cc3YtwJ_RbGAQ#v_tableAPI "Die v_table Die API bietet Methoden zum Hinzufügen von Zeilen zu einer Remotetabelle über ein skriptfähiges Objekt.")API
{#vquery-setLastErrorMessage_S__ul_dbm_rvc_sqb}
{#vquery-setLastErrorMessage_S__table_j3v_xm3_nlb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Nachricht | Zeichenfolge | Fehlermeldung. |
[Tabelle : 15. Parameter]

{#vquery-setLastErrorMessage_S__table_j3v_xm3_nlb} {#vquery-setLastErrorMessage_S__table_k3v_xm3_nlb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 16. Rückgaben]

{#vquery-setLastErrorMessage_S__table_k3v_xm3_nlb}  
Das folgende Beispiel zeigt die grundlegende Struktur, die zum Festlegen einer Fehlermeldung verwendet wird.

    (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);

Das folgende Beispiel zeigt, wie die letzte Fehlermeldung in einer REST-API festgelegt wird.

    (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);


