v_query: Bereichsbezogen, global

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 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.

    Remotetabellenzeilen werden mit der v_table- API erstellt.

    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 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 an eine Remotetabelle als codierte Abfragezeichenfolge zurück

    Einzelheiten 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 werden von einer Drittanbieterquelle abgerufen.

    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. Wenn beispielsweise „name=John“ die codierte Abfrage ist, gibt getParameter("name")„John“zurück.

    Das folgende Beispiel zeigt, wie Sie den Wert eines Anrufer-ID-Felds abrufen.

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

    Das folgende Beispiel ist ein Ausschnitt aus Bestimmte Datensätze werden von einer Drittanbieterquelle abgerufen.

    v_query.getSysId();

    Ausgabe:

    a3a7ffb6dba41010db2051735e4619b7

    v_query – getTextSearch()

    Ruft einen Textsuchabfrageparameter 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 anhand der 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:
    • „wahr“: Abfrage enthält Gleichheitsabfragebedingung im Feld „sys_id“.
    • „falsch“: Abfrage enthält keine Gleichheitsabfragebedingung im Feld „sys_id“.

    Wenn im folgenden Beispiel die codierte Abfrage sys_id=d1954c744662010bd7e061e67a6776elautet, 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()

    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.
    • „falsch“: 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. Rückgaben
    Typ Beschreibung
    Keine

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