v_table – Scoped, Global

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 1 Minute Lesedauer
  • Die v_table- API stellt ein skriptfähiges Objekt bereit, mit dem Sie einer Remotetabelle Zeilen hinzufügen können.

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

    Verwenden Sie das skriptfähige Objekt v_query, um Remotetabellen abzufragen.

    v_table – addRow(Object row)

    Fügt der Remotetabelle Zeilen hinzu.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Zeile Objekt JavaScript-Objekt mit Feldname und Wertzuordnung, in der der Schlüssel der Feldname ist, z. B. {number: "INC0001", sys_id: "a34"}.
    { "<field name>": "value" }
    
    Zeile.<field value> Zeichenfolge Stellt den Wert des ausgewählten Felds dar. Obwohl keine Felder obligatorisch sind, geben Sie mindestens die sys_id an.

    Beispiel, in dem nur das Feld „sys_id“ und sein Wert aufgelistet werden:

    { "sys_id": "<uniqueID>" }
    
    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob die Zeile der Remotetabelle hinzugefügt wurde.
    Gültige Werte:
    • true: Erfolg.
    • false: Zeile wurde nicht hinzugefügt.

    Das folgende Beispiel zeigt, wie die RESTMessageV2- API zum Erstellen und Ausführen des REST-Aufrufs an eine externe Bankanwendung verwendet wird. Das Skript zeigt, wie die addRow()- Methode zum Speichern von Rückgabeergebnissen in einer Remotetabelle verwendet wird.

    (function executeQuery (v_table, v_query) {
      // Parameters needed in the request body of the REST endpoint
      var requestBody = {
        'financial_account':v_query.getParameter('financial_account')
      };
    
      // Instantiate the RESTMessageV2 object
      var request = new sn_ws.RESTMessageV2();
      // Set the HTTP method as "GET"
      request.setHttpMethod('get');
      // URL of the endpoint on the bank application
      request.setEndpoint('https://<yourbankapphost>/api/getTransactionDetails');
      // Request body as a string
      request.setRequestBody(JSON.stringify(requestBody));
      // Call the REST endpoint
      var response = request.execute();
      // Get the response body
      var responseBody = response.getBody();
      // Parse the response body into an object
      var responseObj = JSON.parse(responseBody);
    
      // Store the response body into a virtual table
      v_table.addRow({
        sys_id: gs.generateGUID(),
        amount: responseObj.amount,
        description: responseObj.description,
        posting_date: responseObj.posting_date,
        transaction_date: responseObj.transaction_date
      });
    
    }) (v_table, v_query);