v_table: Bereichsbezogen, global

Die v_table- API bietet Methoden zum Hinzufügen von Zeilen zu einer Remotetabelle über ein skriptfähiges Objekt.

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.

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

v_table - addRow(Object row)

Fügt der Remotetabelle Zeilen hinzu.

Siehe auch:

• Erstellen Sie eine Skriptdefinition für eine Remotetabelle
• Sucht im Erfassungssystem nach Remote-Informationen
• Es werden bestimmte Datensätze aus einer Drittparteiquelle abgerufen
• v_query-API

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Zeile	Objekt	JavaScript-Objekt, das den Feldnamen und die Wertezuordnung enthält, 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 der Wert aufgelistet werden: { "sys_id": "<uniqueID>" }

Tabelle : 2. Rückgaben

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 Sie mit der RESTMessageV2 -API den REST-Aufruf an eine externe Bankanwendung erstellen und ausführen. Das Skript zeigt, wie mit der Methode addRow() Rückgabeergebnisse in einer Remotetabelle gespeichert werden.

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