---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# v_table -- Champ d'application, global

# v_table -- Champ d'application, global {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute de lecture

L'API v_table fournit des méthodes pour ajouter des lignes à une table distante via un objet pouvant contenir des scripts.

Cette API nécessite l'activation du module d'extension Tables distantes (com.glide.script.vtable). Pour plus d'informations, consultez [Récupération de données externes à l'aide de tables et de scripts distants](https://www.servicenow.com/docs/access?context=remote-tables&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US).

Utilisez [l'objet](https://servicenow-prod.fluidtopics.net/1QUmobLVMDq3JM5y8AmWYw#v_queryAPI "L’API v_query fournit des méthodes permettant d’obtenir des informations sur un objet pouvant contenir des scripts qui représente une requête exécutée sur une table distante.") de script v_query pour interroger les tables distantes.

## v_table : addRow(ligne d'objet) {#ariaid-title2}

Ajoute des lignes à la table distante.
Voir aussi :

* [Créer une définition de script pour une table distante](https://www.servicenow.com/docs/access?context=create-remote-table-script&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)
* [Rechercher des informations à distance dans le système d'enregistrement](https://www.servicenow.com/docs/access?context=fso-int_guide-agt_table_lookup&version=xanadu&pubname=xanadu-financial-services-operations&ft:locale=en-US)
* [Récupération d'enregistrements spécifiques à partir d'une source tierce](https://www.servicenow.com/docs/access?context=remote-table-script-def-example2&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)
* [API v_query](https://servicenow-prod.fluidtopics.net/1QUmobLVMDq3JM5y8AmWYw#v_queryAPI "L’API v_query fournit des méthodes permettant d’obtenir des informations sur un objet pouvant contenir des scripts qui représente une requête exécutée sur une table distante.")
{#v_table-addRow_O__ul_eyp_csw_rqb}
{#v_table-addRow_O__table_udd_bdj_nlb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Ligne | Objet | Objet JavaScript contenant un nom de champ et une carte de valeurs dans laquelle la clé est le nom du champ, par exemple, `{number : << INC0001 >>, sys_id : << a34"}`. { "<field name>": "value" } |
| Valeur ligne.\<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 répertoriant uniquement sys_id champ et valeur : { "sys_id": "<uniqueID>" } |
[Tableau 1. Paramètres]

{#v_table-addRow_O__table_udd_bdj_nlb} {#v_table-addRow_O__table_vdd_bdj_nlb__entry__2}

| 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. {#v_table-addRow_O__ul_jdl_pfb_add} |
[Tableau 2. Renvoie]

{#v_table-addRow_O__table_vdd_bdj_nlb}  
L'exemple suivant montre comment utiliser l'API [RESTMessageV2](https://servicenow-prod.fluidtopics.net/OLMYX~dQmf0PbnPLe5DHkA#c_RESTMessageV2API "L’API RESTMessageV2 fournit des méthodes qui vous permettent d’envoyer des messages REST sortants à l’aide de JavaScript.") 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);