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

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# v_query: Bereichsbezogen, global

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

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

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

Für diese API muss das Plugin „Remotetabellen" (com.glide.script.vtable) aktiviert sein. Weitere Informationen finden Sie unter [Externe Daten mithilfe von Remotetabellen und -skripts abrufen](https://www.servicenow.com/docs/access?context=remote-tables&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US).

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

## 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/jtTF8X1eacUEbgNMCsCDhw#v_tableAPI "Die v_table- 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 |
|-|-|-|
| field | 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 eine [codierte Abfragezeichenfolge](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) für das angegebene Feld zurück. |
[Tabelle : 2. Ergebnisse]

{#vquery-getCondition_S__table_k3v_xm3_nlb}  
Das folgende Beispiel zeigt Ergebnisse für ein Feld mit der codierten Abfrage `number=INC0001^active=true`.

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

Ausgabe:

    number=INC0001

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

Gibt die Abfrage an eine Remotetabelle als codierte Abfragezeichenfolge zurück
Einzelheiten finden Sie unter [Codierte Abfragezeichenfolgen](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}

Siehe auch [v_table-](https://servicenow-prod.fluidtopics.net/jtTF8X1eacUEbgNMCsCDhw#v_tableAPI "Die v_table- 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 | Codierte Abfrage als Zeichenfolge. |
[Tabelle : 4. Ergebnisse]

{#vquery-getEncodedQuery__table_k3v_xm3_nlb}  
Das folgende Beispiel ist ein Ausschnitt aus [Bestimmte Datensätze werden von einer Drittanbieterquelle abgerufen](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());

Ausgabe:

    active=true^priority=1

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

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

* [Es werden bestimmte Datensätze aus einer Drittparteiquelle abgerufen](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/jtTF8X1eacUEbgNMCsCDhw#v_tableAPI "Die v_table- 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 |
|-|-|-|
| field | 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. Wenn beispielsweise „ `name=John` " die codierte Abfrage ist, gibt getParameter("name")`„John"`zurück. |
[Tabelle : 6. Ergebnisse]

{#vquery-getParameter_S__table_k3v_xm3_nlb}  
Das folgende Beispiel zeigt, wie Sie den Wert eines Anrufer-ID-Felds abrufen.

    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 Abrufabfrage, z. B. wenn `sys_id=123`, gibt diese Methode 123zurück. |
[Tabelle : 8. Ergebnisse]

{#vquery-getSysId__table_k3v_xm3_nlb}  
Das folgende Beispiel ist ein Ausschnitt aus [Bestimmte Datensätze werden von einer Drittanbieterquelle abgerufen](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();

Ausgabe:

    a3a7ffb6dba41010db2051735e4619b7

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

Ruft einen Textsuchabfrageparameter ab.
Siehe auch:

* [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US)
* [Abfragen von Tabellen im Skript](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/jtTF8X1eacUEbgNMCsCDhw#v_tableAPI "Die v_table- 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 | Abfrageparameter für Textsuche, z. B. E- Mail. |
[Tabelle : 10. Ergebnisse]

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

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

Ausgabe:

    email

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

Bestimmt, ob die Abfrage eine Get-Abfrage ist, also eine Abfrage, die einen Datensatz anhand der sys_id abruft.
Siehe auch:

* [Es werden bestimmte Datensätze aus einer Drittparteiquelle abgerufen](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/jtTF8X1eacUEbgNMCsCDhw#v_tableAPI "Die v_table- 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 `„sys_id="` als Abfrageformat hat. Gültige Werte: * „wahr": Abfrage enthält Gleichheitsabfragebedingung im Feld „sys_id". * „falsch": Abfrage enthält keine Gleichheitsabfragebedingung im Feld „sys_id". {#vquery-isGet__ul_jdl_pfb_add} |
[Tabelle : 12. Ergebnisse]

{#vquery-isGet__table_k3v_xm3_nlb}  
Wenn im folgenden Beispiel die codierte Abfrage `sys_id=d1954c744662010bd7e061e67a6776e lautet`, gibt die Methode v_query.isGet() den Wert true zurück. Wenn es sich bei der codierten Abfrage um etwas anderes handelt, z. B. `Number=INC0000001`, gibt die Methode v_query.isGet() den Wert false 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=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US)
* [Abfragen von Tabellen im Skript](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/jtTF8X1eacUEbgNMCsCDhw#v_tableAPI "Die v_table- 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: * true: Abfrage enthält einen Textabfrageparameter. * „falsch": Abfrage enthält keinen Textabfrageparameter. {#vquery-isTextSearch__ul_jdl_pfb_add} |
[Tabelle : 14. Ergebnisse]

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

    v_query.isTextSearch();

## v_query - setLastErrorMessage(String message) {#ariaid-title9}

Legt die letzte Fehlermeldung im GlideRecord fest.
Siehe auch:

* [Scoped GlideRecord -- getLastErrorMessage()](https://servicenow-prod.fluidtopics.net/g1N~QBZ9WXF6q3o57iuLTw#c_GlideRecordScopedAPI "Die bereichsbezogene GlideRecord- API wird für Datenbankvorgänge verwendet.")
* [Es werden bestimmte Datensätze aus einer Drittparteiquelle abgerufen](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/jtTF8X1eacUEbgNMCsCDhw#v_tableAPI "Die v_table- 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. Ergebnisse]

{#vquery-setLastErrorMessage_S__table_k3v_xm3_nlb}  
Das folgende Beispiel zeigt die Grundstruktur, 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);