v_query: Bereichsbezogen, Global

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 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 „Remote-Tabellen“ (com.Glide.script.vtable). Weitere Informationen finden Sie unter Externe Daten werden mithilfe von Remote-Tabellen und -Skripts abgerufen .

    Remote-Tabellenzeilen werden mit erstellt v_table API.

    v_query – getCondition (Zeichenfolgenfeld)

    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 einen zurück Codierte Abfragezeichenfolge Für das angegebene Feld.

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

    Gibt die Abfrage für eine Remote-Tabelle 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 Fragment aus Abrufen bestimmter Datensätze aus einer Drittparteiquelle .

    gs.info(v_query.getEncodedQuery());

    Ausgabe:

    active=true^priority=1

    v_query – getParameter(Zeichenfolgenfeld)

    Ruft den Wert eines Felds in einer Gleichheitsabfragebedingung ab.

    Siehe auch:
    Tabelle : 5. Parameter
    Name Typ Beschreibung
    field Zeichenfolge Name des abzufragenden Felds.
    Tabelle : 6. Rückgaben
    Typ Beschreibung
    Zeichenfolge Wert des Felds in der Abfragebedingung. Beispiel: Wenn Name=John Ist dann die codierte Abfrage GetParameter("Name") Gibt zurück „John“ .

    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, z. B. wenn sys_ID=123 , Diese Methode gibt zurück 123 .

    Das folgende Beispiel ist ein Fragment aus Abrufen bestimmter Datensätze aus einer Drittparteiquelle .

    v_query.getSysId();

    Ausgabe:

    a3a7ffb6dba41010db2051735e4619b7

    v_query – getTextSearch()

    Ruft einen Abfrageparameter für die Textsuche ab.

    Siehe auch:
    Tabelle : 9. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 10. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Beispiel: Abfrageparameter für Textsuche E-Mail .

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

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

    Siehe auch:
    Tabelle : 11. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 12. Ergebnisse
    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“.

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

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

    Siehe auch:
    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:
    • Wahr: Abfrage enthält einen Textabfrageparameter.
    • Falsch: Abfrage enthält keinen Textabfrageparameter.

    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)

    Legt die letzte Fehlermeldung im GlideRecord fest.

    Siehe auch:
    Tabelle : 15. Parameter
    Name Typ Beschreibung
    Nachricht Zeichenfolge Fehlermeldung.
    Tabelle : 16. Rückgaben
    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);