Skip to main content
Acessar Studio

Encontrar linha

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


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.

Coluna onde buscar​

O nome exato da coluna, como aparece na primeira linha (cabeçalho) da aba.

Valor a ser buscado​

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

Retornos​

Código Javascript​

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

Seleção de campos​

  • rowNumber — número da linha encontrada (Número)
  • row — a linha encontrada, 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, Nome ou ID da aba, Coluna onde buscar e Valor a ser buscado são obrigatórios.
  • A primeira linha da aba é sempre usada como cabeçalho, e é a partir dela que o campo row relaciona cada valor ao nome da respectiva coluna.
  • Apenas a primeira linha correspondente (a de menor número) é retornada, mesmo que existam outras linhas com o mesmo valor na coluna pesquisada.
  • A comparação de valores é feita como texto; por exemplo, o número 10 e o texto "10" são considerados equivalentes.
  • Se a coluna informada não existir no cabeçalho da aba — incluindo o caso em que a aba não possui nenhuma linha de cabeçalho — o robô interrompe a execução com erro.
  • Se nenhuma linha corresponder ao valor informado, a ação não interrompe a execução; trate esse cenário no fluxo antes de usar os campos rowNumber/row retornados.