v_table – Scoped, Global

A API v_table fornece um objeto programável que permite adicionar linhas a uma tabela remota.

Esta API requer que o plug-in Remote Tables (com.glide.script.vtable) seja ativado. Recuperando dados externos usando tabelas e scripts remotos.

Use o objeto programável v_query para consultar tabelas remotas.

v_table - addRow(linha do objeto)

Adiciona linhas à tabela remota.

Consulte também:

• Criar uma definição de script para uma tabela remota
• Pesquisar informações remotas no sistema de registro
• Recuperando registros específicos de uma fonte de terceiros
• API v_query

Tabela 1. Parâmetros

Nome	Tipo	Descrição
linha	Objeto	Objeto JavaScript que contém o nome do campo e o mapa de valor 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 o sys_id no mínimo. Exemplo de listagem somente do campo e valor sys_id: { "sys_id": "<uniqueID>" }

Tabela 2. Retorna

Tipo	Descrição
Booliano	Sinalizador que indica se a linha foi adicionada à tabela remota. Valores válidos: verdadeiro: sucesso. false: a linha não foi adicionada.

O exemplo a seguir mostra como usar a API RESTMessageV2 para criar e executar a chamada REST para uma aplicação bancária 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);