---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# v_table -- Scoped, Global

# v_table -- Scoped, Global {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

A API v_table fornece métodos para adicionar linhas a uma tabela remota por meio de um objeto programável.

Esta API requer que o plug-in Tabelas remotas (com.glide.script.vtable) seja ativado. Para obter informações adicionais, consulte [Recuperação de dados externos usando tabelas e scripts remotos](https://www.servicenow.com/docs/access?context=remote-tables&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US).

Use o objeto programável [v_query](https://servicenow-prod.fluidtopics.net/SAjnr_8ihpbTm_fnzW6M0w#v_queryAPI "A API v_query fornece métodos para obter informações sobre um objeto programável que representa uma consulta em execução em uma tabela remota.") para consultar tabelas remotas.

## v_table - addRow(linha de objeto) {#ariaid-title2}

Adiciona linhas à tabela remota.
Consulte também:

* [Criar uma definição de script para uma tabela remota](https://www.servicenow.com/docs/access?context=create-remote-table-script&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)
* [Pesquisar informações remotas no sistema de registro](https://www.servicenow.com/docs/access?context=fso-int_guide-agt_table_lookup&version=xanadu&pubname=xanadu-financial-services-operations&ft:locale=en-US)
* [Recuperando registros específicos de uma origem de terceiros](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/SAjnr_8ihpbTm_fnzW6M0w#v_queryAPI "A API v_query fornece métodos para obter informações sobre um objeto programável que representa uma consulta em execução em uma tabela remota.")
{#v_table-addRow_O__ul_eyp_csw_rqb}
{#v_table-addRow_O__table_udd_bdj_nlb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| linha | Objeto | Objeto JavaScript que contém o nome do campo e o mapa de valores no qual a chave é o nome do campo, por exemplo, `{number: "INC0001", sys_id: "a34"}`. { "<field name>": "value" } |
| linha.\<field value\> | Cadeia de caracteres | Representa o valor do campo selecionado. Embora nenhum campo seja obrigatório, forneça pelo menos o sys_id. Exemplo de listagem somente do campo e valor sys_id: { "sys_id": "<uniqueID>" } |
[Tabela 1. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se a linha foi adicionada à tabela remota. Valores válidos: * verdadeiro: sucesso. * falso: a linha não foi adicionada. {#v_table-addRow_O__ul_jdl_pfb_add} |
[Tabela 2. Retorna]

{#v_table-addRow_O__table_vdd_bdj_nlb}  
O exemplo a seguir mostra como usar a API [RESTMessageV2](https://servicenow-prod.fluidtopics.net/cJV1SplpBR7sVkkmKItkCg#c_RESTMessageV2API "A API RESTMessageV2 fornece métodos que permitem enviar mensagens REST de saída usando JavaScript.") para criar e executar a chamada REST para uma aplicação de banco externa. O script mostra como usar o método addRow() para armazenar resultados de retorno em uma tabela remota.

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