Pular para o conteúdo principal
Docs
Acessar Studio
Roberty Studio
RPATabelas

Obter tabela

Obter tabela

Obtém todas as linhas de uma tabela, cada uma como um objeto relacionando o nome da coluna ao seu valor.


Opções​

Conexão do Google Sheets​

Selecione a ação de Conexão do Google Sheets configurada no fluxo.

ID da planilha​

Informe o ID da planilha. O ID pode ser encontrado na URL da planilha: docs.google.com/spreadsheets/d/{spreadsheetId}/edit.

Nome da tabela​

Informe o nome da tabela, por exemplo Clientes. Use Listar tabelas para descobrir os nomes existentes.

Retornos​

Código Javascript​

js
actions["id-da-acao"].rows // linhas de dados da tabela, cada uma como objeto (Lista)
actions["id-da-acao"].headers // nomes das colunas (Lista)
actions["id-da-acao"].rowCount // quantidade de linhas de dados (Número)
actions["id-da-acao"].firstRowNumber // número, na aba, da primeira linha de dados (Número)
actions["id-da-acao"].sheet // nome da aba da tabela (Texto)

Seleção de campos​

  • rows — Lista com as linhas de dados da tabela (sem o cabeçalho). Cada item é um objeto relacionando o nome da coluna ao seu valor, por exemplo { "Nome": "Maria", "Total": "150" }.
  • headers — Lista com os nomes das colunas da tabela.
  • rowCount — Quantidade de linhas de dados obtidas.
  • firstRowNumber — Número, na aba, da primeira linha de dados (logo abaixo do cabeçalho). O item da posição N de rows (começando em 0) está na linha firstRowNumber + N da aba — útil para depois usar Atualizar linha ou Excluir linha.
  • sheet — Nome da aba onde a tabela está.

Regras e Condições​

  • Os campos Conexão do Google Sheets, ID da planilha e Nome da tabela são obrigatórios.
  • A tabela informada precisa existir na planilha; caso contrário o robô interrompe a execução com erro de tabela não encontrada.
  • Uma tabela só com o cabeçalho retorna rows como lista vazia e rowCount igual a 0.
  • Células vazias retornam texto vazio (""). Os valores vêm como aparecem formatados no Google Sheets.