Skip to main content
Acessar Studio

Localizar e substituir

Localiza e substitui um texto em uma planilha, aba ou intervalo de células.


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.

Localizar​

Informe o texto a ser localizado.

Substituir por​

Informe o texto que substituirá as ocorrências encontradas.

Nome ou ID da aba (opcional)​

Deixe vazio para buscar em toda a planilha. Informe o nome da aba (ex.: Página1) ou, usando o tipo número, o ID numérico da aba.

Opções avançadas​

Campos do intervalo (opcional — padrão: aba inteira) e das configurações avançadas de busca.

Linha inicial​

Opcional. Informe a linha inicial do intervalo de busca (1 = primeira linha). Só tem efeito quando Nome ou ID da aba também for informado.

Linha final​

Opcional. Informe a linha final do intervalo de busca. Só tem efeito quando Nome ou ID da aba também for informado.

Coluna inicial​

Opcional. Informe a coluna inicial do intervalo de busca (1 = primeira coluna). Só tem efeito quando Nome ou ID da aba também for informado.

Coluna final​

Opcional. Informe a coluna final do intervalo de busca. Só tem efeito quando Nome ou ID da aba também for informado.

Diferenciar maiúsculas/minúsculas​

Quando ativado, a busca diferencia letras maiúsculas de minúsculas. Padrão: desativado.

Corresponder ao conteúdo inteiro da célula​

Quando ativado, a substituição só ocorre quando o conteúdo inteiro da célula for igual ao texto buscado. Padrão: desativado.

Buscar usando expressão regular​

Quando ativado, o campo Localizar é interpretado como uma expressão regular. Padrão: desativado.

Buscar também dentro de fórmulas​

Quando ativado, a busca também considera o texto das fórmulas das células, além dos valores exibidos. Padrão: desativado.

Retornos​

Código Javascript​

actions["id-da-acao"].valuesChanged // quantidade de valores alterados (Número)
actions["id-da-acao"].formulasChanged // quantidade de fórmulas alteradas (Número)
actions["id-da-acao"].rowsChanged // quantidade de linhas alteradas (Número)
actions["id-da-acao"].sheetsChanged // quantidade de abas alteradas (Número)
actions["id-da-acao"].occurrencesChanged // quantidade de ocorrências alteradas (Número)

Seleção de campos​

  • valuesChanged — Quantidade de valores alterados.
  • formulasChanged — Quantidade de fórmulas alteradas.
  • rowsChanged — Quantidade de linhas alteradas.
  • sheetsChanged — Quantidade de abas alteradas.
  • occurrencesChanged — Quantidade de ocorrências alteradas.

Regras e Condições​

  • Os campos Conexão do Google Sheets, ID da planilha, Localizar e Substituir por são obrigatórios.
  • Quando Nome ou ID da aba não é informado, a busca e substituição são feitas em toda a planilha (todas as abas).
  • Quando Nome ou ID da aba é informado e nenhum campo de intervalo (linha/coluna) é preenchido, a busca é feita em toda a aba selecionada.
  • Os campos de intervalo (linha/coluna inicial/final) só têm efeito quando Nome ou ID da aba também é informado; se a aba ficar vazia, os campos de intervalo são ignorados e a busca ocorre em toda a planilha.
  • Se a aba informada não for encontrada na planilha, o robô interrompe a execução com erro.
  • As posições de linha e coluna são informadas em base 1 (1 = primeira linha/coluna).