Skip to main content
Acessar Studio

Atualizar linha

Atualiza uma linha da tabela, localizada pelo número da linha ou por um filtro de coluna/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 (intervalo nomeado), por exemplo Clientes.

Localizar a linha por​

Escolha como a linha a ser atualizada será localizada: Coluna e valor (padrão) ou Número da linha.

Coluna onde buscar​

Visível quando a localização é por Coluna e valor. Informe o nome exato da coluna, como aparece no cabeçalho da tabela, por exemplo Email. A primeira linha que combinar essa coluna/valor será atualizada.

Valor a ser buscado​

Visível quando a localização é por Coluna e valor. Informe o valor a ser buscado na coluna informada.

Número da linha​

Visível quando a localização é por Número da linha. Informe o número da linha a ser atualizada, considerando a linha de cabeçalho da tabela como linha 1.

Novos valores das colunas​

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

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.

Novos valores das colunas (código)​

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

Retornos​

Código Javascript​

actions["id-da-acao"].rowNumber // número da linha atualizada (Número)
actions["id-da-acao"].row // a linha após a atualização, como objeto (Any)

Seleção de campos​

  • rowNumber — Número da linha atualizada.
  • row — A linha após a atualização, 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.
  • Quando a localização é por Coluna e valor, os campos Coluna onde buscar e Valor a ser buscado são obrigatórios. Quando é por Número da linha, o campo Número da linha é obrigatório.
  • É necessário informar ao menos uma coluna a atualizar (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.
  • Ao localizar por Coluna e valor: se nenhuma linha combinar, o robô interrompe a execução com erro de linha não encontrada; se mais de uma linha combinar, o robô interrompe a execução com erro de ambiguidade (é necessário usar uma coluna com valores únicos, ou atualizar pelo número da linha).
  • Ao localizar por Número da linha: se a linha não existir dentro dos limites da tabela, o robô interrompe a execução com erro de linha não encontrada.
  • Ao menos um dos cabeçalhos informados em Novos valores das colunas precisa combinar exatamente (diferenciando maiúsculas/minúsculas) com um cabeçalho existente na tabela; caso contrário o robô interrompe a execução com erro de mapeamento de colunas.
  • Colunas da tabela que não forem informadas em Novos valores das colunas mantêm o valor atual da linha.