Skip to main content
Acessar Studio

Criar tabela

Cria uma tabela (intervalo nomeado) em uma aba, a partir de uma linha de cabeçalho.


Opções​

Conexão do Google Sheets​

Selecione a ação de Conexão configurada no fluxo.

ID da planilha​

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

Nome ou ID da aba​

Informe o nome da aba (ex.: Página1) ou, usando o tipo número, o ID numérico da aba.

Nome da tabela​

Usado para referenciar essa tabela nas próximas ações, por exemplo Clientes.

Cabeçalhos das colunas​

Opcional. Deixe vazio para usar o que já estiver escrito na primeira linha do intervalo como cabeçalho. Utilize o botão Adicionar cabeçalho para incluir uma entrada para cada coluna da tabela.

Opções avançadas​

Linha inicial (padrão: 1)​

Opcional. Informe o número da linha, na aba, onde o cabeçalho da tabela começa.

Coluna inicial (padrão: 1)​

Opcional. Informe o número da coluna, na aba, onde a tabela começa.

Retornos​

Código Javascript​

actions["id-da-acao"].namedRangeId // ID da tabela (intervalo nomeado) recém criada (Texto)
actions["id-da-acao"].name // Nome da tabela recém criada (Texto)
actions["id-da-acao"].startRow // Primeira linha da tabela (Número)
actions["id-da-acao"].endRow // Última linha da tabela (Número)
actions["id-da-acao"].startColumn // Primeira coluna da tabela (Número)
actions["id-da-acao"].endColumn // Última coluna da tabela (Número)
actions["id-da-acao"].headers // Lista com os cabeçalhos das colunas da tabela (Lista)

Seleção de campos​

  • namedRangeId — ID da tabela (intervalo nomeado) recém criada (Texto)
  • name — Nome da tabela recém criada (Texto)
  • startRow — Primeira linha da tabela (Número)
  • endRow — Última linha da tabela (Número)
  • startColumn — Primeira coluna da tabela (Número)
  • endColumn — Última coluna da tabela (Número)
  • headers — Lista com os cabeçalhos das colunas da tabela (Lista)

Regras e Condições​

  • Os campos Conexão do Google Sheets, ID da planilha, Nome ou ID da aba e Nome da tabela são obrigatórios.
  • Se Cabeçalhos das colunas não for informado, o robô utiliza o que já estiver escrito na primeira linha do intervalo (considerando a linha e a coluna iniciais) como cabeçalho da tabela. Se essa linha estiver vazia, a execução é interrompida com erro.
  • Se Cabeçalhos das colunas for informado, esses valores são gravados na linha de cabeçalho antes da criação da tabela, sobrescrevendo o que já estiver escrito ali.
  • A largura da tabela é definida pela quantidade de cabeçalhos. A altura é ajustada automaticamente para incluir qualquer dado já existente logo abaixo do cabeçalho, com no mínimo uma linha.
  • Linha inicial e Coluna inicial são opcionais e assumem o valor 1 (primeira linha/coluna da aba) quando não informadas.
  • Se a criação falhar do lado do Google (por exemplo, resposta sem identificador da tabela), o robô interrompe a execução com erro.