v_query – Scoped, Global

Die v_query- API stellt ein skriptfähiges Objekt bereit, das eine Abfrage darstellt, die für eine Remotetabelle ausgeführt wird.

Für diese API muss das Plugin „Remote Tables“ (com.glide.script.vtable) aktiviert sein. Externe Daten mithilfe von Remotetabellen und -skripts abrufen.

Remote-Tabellenzeilen werden mit der v_table- API erstellt.

v_query – getCondition(String field)

Ruft eine codierte Abfragezeichenfolge für das angegebene Feld ab.

Siehe auch v_table- API.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
field	Zeichenfolge	Name des Felds.

Tabelle : 2. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Gibt eine codierte Abfragezeichenfolge für das angegebene Feld zurück.

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

Gibt die Abfrage für eine Remotetabelle als codierte Abfragezeichenfolge zurück

Weitere Informationen finden Sie unter Codierte Abfragezeichenfolgen .

Siehe auch v_table- API.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 4. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Codierte Abfrage als Zeichenfolge.

Das folgende Beispiel ist ein Ausschnitt aus Bestimmte Datensätze aus einer Drittparteiquelle abrufen.

gs.info(v_query.getEncodedQuery());

Ausgabe:

active=true^priority=1

v_query – getParameter(String field)

Ruft den Wert eines Felds in einer Gleichheitsabfragebedingung ab.

Siehe auch:

• Bestimmte Datensätze aus einer Drittanbieterquelle werden abgerufen
• v_table- API

Tabelle : 5. Parameter

Name	Typ	Beschreibung
field	Zeichenfolge	Name des abzufragenden Felds.

Tabelle : 6. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Wert des Felds in der Abfragebedingung. Beispiel: Wenn name=John die codierte Abfrage ist, dann gibt getParameter("name")"John"zurück.

Das folgende Beispiel zeigt, wie der Wert eines Anrufer-ID-Felds abgerufen wird.

v_query.getParameter("caller_id");

Ausgabe:

12345123451234512345123451234501

v_query – getSysId()

Gibt den sys_id-Wert in einer get-Abfrage zurück.

Tabelle : 7. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 8. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Sys_id-Wert in der get-Abfrage. Beispiel: Wenn sys_id=123, gibt diese Methode 123zurück.

Das folgende Beispiel ist ein Ausschnitt aus Bestimmte Datensätze aus einer Drittparteiquelle abrufen.

v_query.getSysId();

Ausgabe:

a3a7ffb6dba41010db2051735e4619b7

v_query – getTextSearch()

Ruft einen Abfrageparameter für die Textsuche ab.

Siehe auch:

• Codierte Abfragezeichenfolgen
• Abfragen von Tabellen im Skript
• v_table- API

Tabelle : 9. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 10. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Abfrageparameter für Textsuche, z. B. E- Mail.

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

Bestimmt, ob die Abfrage eine Get-Abfrage ist, also eine Abfrage, die einen Datensatz nach sys_id abruft.

Siehe auch:

• Bestimmte Datensätze aus einer Drittanbieterquelle werden abgerufen
• v_table- API

Tabelle : 11. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 12. Ergebnisse

Typ	Beschreibung
Boolean	Kennzeichnung gibt an, dass die Abfrage für einen bestimmten Datensatz sys_id= als Abfrageformat hat. Gültige Werte: true: Abfrage enthält Gleichheitsabfragebedingung im Feld sys_id. false: Abfrage enthält keine Gleichheitsabfragebedingung im Feld sys_id.

Wenn im folgenden Beispiel die codierte Abfrage sys_id=d1954c744662010bd7e061e67a6776e lautet, gibt die Methode v_query.isGet() true zurück. Wenn die codierte Abfrage etwas anderes ist, z. B. Number=INC0000001, gibt die Methode v_query.isGet() 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()

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

Siehe auch:

• Codierte Abfragezeichenfolgen
• Abfragen von Tabellen im Skript
• v_table- API

Tabelle : 13. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 14. Ergebnisse

Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob die Abfrage einen Textabfrageparameter enthält. Gültige Werte: true: Abfrage enthält einen Textabfrageparameter. false: Abfrage enthält keinen Textabfrageparameter.

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)

Legt die letzte Fehlermeldung im GlideRecord fest.

Siehe auch:

• Scoped GlideRecord – getLastErrorMessage()
• Bestimmte Datensätze aus einer Drittanbieterquelle werden abgerufen
• v_table- API

Tabelle : 15. Parameter

Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Fehlermeldung.

Tabelle : 16. Ergebnisse

Typ	Beschreibung
Keine

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