v_query – Scoped, Global

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 3 Minuten Lesedauer

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