Pular para o conteúdo principal
Docs
Acessar Studio
Roberty Studio
RPALinhas

Encontrar linhas

Encontrar linhas

Encontra todas as linhas em que uma coluna combina com um valor informado e retorna uma lista com elas.


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​

js
actions["id-da-acao"].rows // lista de linhas encontradas, cada uma com rowNumber e row (Lista)
actions["id-da-acao"].rows[0].rowNumber // número da primeira linha encontrada (Número)
actions["id-da-acao"].rows[0].row // a primeira linha encontrada, como objeto (Any)

Seleção de campos​

  • rows — lista com as linhas encontradas (vazia se nenhuma combinar). Cada item tem rowNumber (o número da linha na aba) e row (a linha como um objeto relacionando o nome de cada coluna ao seu valor) (Lista)

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.
  • Todas as linhas correspondentes são retornadas, em ordem de número de linha; a primeira ocorrência fica em rows[0].
  • 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 e rows vem vazia; confira se a lista tem itens antes de usar rows[0].