Skip to main content
Acessar Studio

Atualizar linha

Encontra a primeira linha em que uma coluna combina com um valor informado e a atualiza.


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.

Localizar a linha por​

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

Quando "Coluna e valor"​

Coluna onde buscar​

O nome exato da coluna, como aparece na primeira linha (cabeçalho) da aba. A primeira linha que combinar essa coluna/valor será atualizada.

Valor a ser buscado​

Informe o valor que deve ser comparado com o conteúdo da coluna, para cada linha da aba.

Quando "Número da linha"​

Número da linha (1 = linha do cabeçalho)​

Informe o número da linha a ser atualizada, considerando a linha 1 como o cabeçalho da aba (portanto o menor número de linha de dados válido é 2).

Novos valores das colunas​

Adicione os pares de cabeçalho e valor a serem gravados na linha localizada. Para cada item, informe o Cabeçalho (nome exato da coluna, como aparece no cabeçalho da aba) e o novo Valor. Use o botão "Adicionar valor" para incluir mais colunas. Colunas do cabeçalho que não forem informadas mantêm seu 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 (Número)
  • row — a linha após a atualização, 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 em Novos valores das colunas (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, tanto para localizar a linha quanto para relacionar os Novos valores das colunas.
  • Ao localizar por Coluna e valor: ambos os campos são obrigatórios; se nenhuma linha corresponder, o robô interrompe a execução com erro; se mais de uma linha corresponder, a execução também é interrompida com erro — nesse caso, utilize uma coluna com valores únicos ou localize a linha pelo número.
  • Ao localizar por Número da linha: o valor mínimo aceito é 2 (a linha 1 é o cabeçalho e não pode ser atualizada por este meio); se a linha informada não existir na aba, o robô interrompe a execução com erro.
  • Ao menos um dos nomes informados em Novos valores das colunas precisa corresponder exatamente (inclusive maiúsculas/minúsculas) a uma coluna existente no cabeçalho da aba; caso contrário, o robô interrompe a execução com erro listando as colunas disponíveis na aba.
  • Colunas do cabeçalho não incluídas nos Novos valores das colunas mantêm seu valor atual — não são apagadas.
  • Se a aba não tiver nenhuma linha de cabeçalho, ou se a aba informada (por nome ou ID) não existir na planilha, o robô interrompe a execução com erro.