Skip to main content
Acessar Studio

Adicionar linha

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


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. 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.

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 exato da coluna, como aparece na primeira linha da aba) 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. A primeira linha da aba é usada como cabeçalho das colunas. 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 (Número)
  • row — a linha adicionada, como um objeto relacionando o nome de cada coluna ao seu valor (Any)

Regras e Condições​

  • Os campos Conexão do Google Sheets, ID da planilha e Nome ou ID da aba são obrigatórios; é necessário informar ao menos uma coluna (modo "Cabeçalho e valor") ou o código de valores (modo "Código customizado").
  • A primeira linha da aba é sempre usada como cabeçalho: os valores informados são relacionados aos nomes de coluna dessa linha, na ordem em que aparecem.
  • Se a aba estiver vazia (sem nenhuma linha de cabeçalho), o robô interrompe a execução com erro (aba sem linha de cabeçalho).
  • A nova linha é sempre adicionada ao final da aba, logo após a última linha com conteúdo.
  • Colunas do cabeçalho que não forem informadas nos Valores das colunas ficam em branco na nova linha; valores informados para nomes de coluna que não existem no cabeçalho são ignorados.
  • Se a aba informada (por nome ou ID) não existir na planilha, o robô interrompe a execução com erro.