Skip to main content
Acessar Studio

Adicionar linha

Adiciona uma nova linha ao final de uma tabela, relacionando os valores aos cabeçalhos das colunas.


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 (intervalo nomeado), por exemplo Clientes.

Valores das colunas​

Adicione os pares de cabeçalho e valor a serem gravados na nova linha. Para cada item, informe o Cabeçalho (nome da coluna, exatamente como aparece no cabeçalho da tabela) e o Valor a ser gravado. Use o botão "Adicionar valor" para incluir mais colunas. Colunas do cabeçalho que não forem informadas ficam em branco na nova linha.

Opções avançadas​

Origem dos valores das colunas​

Escolha entre Cabeçalho e valor (lista de pares construída no formulário) ou Código customizado (substitui a lista por um campo de código). Padrão: Cabeçalho e valor.

Valores das colunas (código)​

Visível apenas quando a origem é Código customizado. Informe um objeto relacionando o nome de cada coluna ao valor desejado — ex., como código: { "Nome": nome.value, "Email": email.value }. Você também pode referenciar a saída de uma ação anterior ou uma variável que já contenha um objeto nesse formato.

Retornos​

Código Javascript​

actions["id-da-acao"].rowNumber // número da linha recém adicionada (Número)
actions["id-da-acao"].row // a linha adicionada, como objeto (Any)

Seleção de campos​

  • rowNumber — Número da linha recém adicionada.
  • row — A linha adicionada, como um objeto relacionando o nome de cada coluna ao seu valor.

Regras e Condições​

  • Os campos Conexão do Google Sheets, ID da planilha e Nome da tabela são obrigatórios.
  • É necessário informar ao menos uma coluna (no modo "Cabeçalho e valor") ou o código de valores (no modo "Código customizado").
  • A tabela informada precisa existir na planilha; caso contrário o robô interrompe a execução com erro de tabela não encontrada.
  • A tabela precisa ter um intervalo de linhas delimitado (com fim definido) e uma linha de cabeçalho; do contrário a execução é interrompida com erro.
  • A linha é adicionada imediatamente após o final do intervalo atual da tabela, e os valores são relacionados aos cabeçalhos das colunas na ordem em que aparecem na tabela.
  • Após a inclusão, o intervalo da tabela é redimensionado automaticamente para passar a incluir a nova linha.