v_table – Scoped, Global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 1 min. de leitura
  • . v_table A API 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 Recuperando dados externos usando tabelas e scripts remotos .

    Use v_query objeto programável para consultar tabelas remotas.

    AddRow (linha de objeto)

    Adiciona linhas à tabela remota.

    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, "INC0001", sys_id: "a34" .
    { "<field name>": "value" }
    
    row.<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.

    Campo e valor sys_id de listagem de exemplo somente:

    { "sys_id": "<uniqueID>" }
    
    Tabela 2. Retornos
    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.

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