v_table – Champ d’application, global

L’API v_table fournit un objet pouvant contenir des scripts qui vous permet d’ajouter des lignes à une table distante.

Cette API requiert l’activation du module d’extension Remote Tables (com.glide.script.vtable). Récupération de données externes à l’aide de tables distantes et de scripts.

Utilisez l’objet pouvant contenir des scripts v_query pour interroger les tables distantes.

v_table - addRow(Ligne d’objet)

Ajoute des lignes à la table distante.

Voir aussi :

• Créer une définition de script pour une table distante
• Rechercher des informations distantes dans le système d’enregistrement
• Récupération d’enregistrements spécifiques à partir d’une source tierce
• API v_query

Tableau 1. Paramètres

Nom	Type	Description
Ligne	Objet	Objet JavaScript contenant le nom de champ et la carte de valeurs dans laquelle la clé est le nom du champ, par exemple, {number : « INC0001 », sys_id : « a34&quot;}. { "<field name>": "value" }
Valeur ligne.&lt;champ>	Chaîne	Représente la valeur du champ sélectionné. Bien qu’aucun champ ne soit obligatoire, fournissez au minimum les sys_id. Exemple de liste sys_id champ et valeur uniquement : { "sys_id": "<uniqueID>" }

Tableau 2. Renvoie

Type	Description
Booléen	Marqueur indiquant si la ligne a été ajoutée à la table distante. Valeurs valides : true : réussite. false : la ligne n’a pas été ajoutée.

L’exemple suivant montre comment utiliser l’API RESTMessageV2 pour créer et exécuter l’appel REST vers une application bancaire externe. Le script montre comment utiliser la méthode addRow() pour stocker les résultats de retour dans une table distante.

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