Localizar e substituir texto no Excel usando n8n Ação
PDF4me Substituir texto no Excel Permite operações abrangentes de pesquisa e substituição em documentos do Excel por meio de n8n Fluxos de trabalho automatizados com aplicação de formatação opcional. Processe arquivos do Excel através de n8n gatilhos, dados binários, strings base64 ou públicos URLs Para substituir texto usando correspondência literal ou expressões regulares (regex), com opções de correspondência que diferenciam maiúsculas de minúsculas, correspondência total ou parcial de células, múltiplas frases de substituição em uma única operação e alterações opcionais de formatação (fonte, cor, tamanho, negrito, itálico, sublinhado, tachado, subscrito, sobrescrito). Esta solução é ideal para padronização de dados, atualizações de conteúdo, correção de erros, transformação automatizada de texto e fluxos de trabalho de mascaramento de privacidade que exigem substituição de texto em todas as planilhas com controle abrangente de formatação e integração perfeita.
Configurar
Adicione o PDF4me O nó "Substituir texto" para o seu n8n fluxo de trabalho e configure os parâmetros necessários. Para obter instruções de configuração inicial, consulte nosso n8n Guia de integração.
Pré-requisitos:
- PDF4me API credenciais
- n8n acesso ao fluxo de trabalho
Configuração:
- Adicionar PDF4me nó para fluxo de trabalho
- Selecione a ação "Localizar e substituir texto".
- Configure os parâmetros de entrada (veja abaixo)

Parâmetros
Lista completa de parâmetros para a ação Substituir Texto. Configure esses parâmetros para controlar a substituição de texto.
Importante: Os parâmetros marcados com um asterisco (***) são obrigatórios. Esta ação processa todas as folhas de exercícios no arquivo Excel.
| Parâmetro | Tipo | Descrição | Exemplo |
|---|---|---|---|
| Tipo de dados de entrada*** | String | Seleção do formato de entrada do Excel • Escolha o formato da sua entrada de dados no Excel. • PDF4me Suporta vários tipos de entrada • Opções: Dados binários, Base64 Corda, ou URL | Binary Data |
| Campo binário de entrada*** | Binário | Entrada de arquivo Excel binário (Obrigatório se os dados forem binários) • Consulte o arquivo Excel de referência (.xlsx, .xls) anterior. n8n upload de nó ou arquivo • PDF4me Processa arquivos binários do Excel com detecção automática de formato. • Obrigatório quando o tipo de dados de entrada for "Dados binários" | {{ $binary.data }} |
| Conteúdo do Excel em Base64*** | String | Base64 Entrada codificada do Excel (Obrigatório se for uma string Base64) • Fornecer conteúdo do Excel (.xlsx, .xls) como uma string codificada em base64 • PDF4me Decodifica e processa automaticamente o conteúdo do Excel. • Obrigatório quando o tipo de dados de entrada for "String Base64" | UEsDBBQABgAI... |
| URL do Excel*** | String | Excel público URL Entrada (Obrigatório se for URL) • Fornecer uma permissão pública/aberta URL para o arquivo Excel (.xlsx, .xls) • PDF4me Baixa e processa o arquivo Excel fornecido. URL • Obrigatório quando o Tipo de Dados de Entrada for "URL" | https://abc.com/data.xlsx |
| Nome do Excel*** | String | Nome do arquivo de entrada do Excel • Especifique o nome do arquivo Excel de entrada com a extensão correta (.xlsx, .xls) • PDF4me Isso é usado para detecção de formato e otimização de processamento. | data.xlsx |
| Frases*** | String | JSON Conjunto de operações de substituição • JSON string contendo um array de objetos ReplacementPhrase • Cada objeto: Texto de pesquisa* (corda), Texto de Substituição* (string, pode estar vazia para ser excluída), ÉExpressão (bool, padrão: false - true = regex, false = texto literal), Maiúsculas e minúsculas (bool, valor padrão: falso), MatchEntireCell (bool, valor padrão: false - true = correspondência total da célula, false = correspondência parcial), Formatação (Objeto TextFormatting - opcional: FontName, FontColor, FontSize, Negrito/Itálico, Tipo de Sublinhado, Tipo de Tachado, Tipo de Script, etc.) • Deve conter pelo menos uma frase • Processado sequencialmente em ordem de matriz • CorrespondênciaO texto literal usa comparação de strings; expressões regulares suportam padrões e grupos ($1, $2) | [{"SearchText":"old","ReplacementText":"new"}] |
| Nome da saída de dados binários*** | String | Mapeamento de saída de dados binários • Defina o nome da variável para acessar os dados binários gerados no Excel. • Utilizado em ações subsequentes do fluxo de trabalho • Essencial para a automação do fluxo de trabalho | document |
Saída
Parâmetros de saída
| Parâmetro | Tipo | Descrição | Exemplo |
|---|---|---|---|
| nome_do_arquivo | String | Nome do arquivo do documento Excel com texto substituído - O nome do arquivo Excel resultante após a substituição do texto | excel_replaced.xlsx |
| tamanho do arquivo | Número | Tamanho do arquivo em bytes - O tamanho do documento Excel em bytes após a substituição do texto | 212808 |
| sucesso | Boolean | PDF4me status da operação - Boolean Sinalizador indicando o sucesso ou a falha do processo de substituição de texto. PDF4me retornos true para operações bem-sucedidas e false para quaisquer erros | true |
| nome_do_arquivo_original | String | Nome do arquivo original do documento Excel - O nome do arquivo de documento Excel de entrada | myExcelFile.xlsx |
| contagem de operações | Número | Número de operações de substituição - O número total de operações de substituição que foram processadas. | 1 |
| operações | Array | Array de operações de substituição - Array de objetos contendo detalhes sobre cada operação de substituição realizada, incluindo searchText, replacementText, isExpression, matchEntireCell, caseSensitive e formattingApplied | [{"searchText": "old ", "replacementText": "New", "isExpression": false, "matchEntireCell": false, "caseSensitive": false, "formattingApplied": false}] |
| nome_da_cultura | String | Código de cultura/localidade - Código cultural utilizado para o processamento do documento (ex.: "en-US", "de-DE", "fr-FR") | en-US |
| mensagem | String | Mensagem da operação - Mensagem descritiva indicando o resultado da operação de substituição de texto, incluindo o número de operações concluídas. | Text replacement completed successfully with 1 operation(s) |
N8N Resposta à ação
O PDF4me Localizar e substituir texto API Retorna uma resposta que pode ser visualizada em vários formatos. Escolha a visualização que melhor se adapta às suas necessidades:
- JSON
- Table
- Schema
- Binary
JSON Formato de resposta
O bruto JSON resposta do API:
[
{
"fileName": "excel_replaced.xlsx",
"fileSize": 212808,
"success": true,
"originalFileName": "myExcelFile.xlsx",
"operationsCount": 1,
"operations": [
{
"searchText": "old ",
"replacementText": "New",
"isExpression": false,
"matchEntireCell": false,
"caseSensitive": false,
"formattingApplied": false
}
],
"cultureName": "en-US",
"message": "Text replacement completed successfully with 1 operation(s)"
}
]
Visualização em tabela
Dados de resposta em formato de tabela estruturada:
| Parâmetro | Valor |
|---|---|
| nome_do_arquivo | excel_replaced.xlsx |
| tamanho do arquivo | 212808 |
| sucesso | true |
| nome_do_arquivo_original | myExcelFile.xlsx |
| contagem de operações | 1 |
| operações | Array de objetos de operação de substituição |
| nome_da_cultura | en-US |
| mensagem | Text replacement completed successfully with 1 operation(s) |
Detalhes da matriz de operações:
| Parâmetro | Valor |
|---|---|
| texto de pesquisa | old |
| texto de substituição | New |
| éExpressão | false |
| combinarCélulaInteira | false |
| maiúsculas e minúsculas | false |
| formataçãoAplicada | false |
Visão do esquema
A estrutura de dados e os tipos de resposta:
1 item
fileName: T excel_replaced.xlsx
fileSize: # 212808
success: ☑ true
originalFileName: T myExcelFile.xlsx
operationsCount: # 1
operations: [] Array
[0]: {} Object
searchText: T old
replacementText: T New
isExpression: ☑ false
matchEntireCell: ☑ false
caseSensitive: ☑ false
formattingApplied: ☑ false
cultureName: T en-US
message: T Text replacement completed successfully with 1 operation(s)
Indicadores de tipo:
T= String (Texto)#= Número☑= Boolean[]= Array
Visualização de Dados Binários
Os dados e metadados reais do arquivo do documento Excel:
data
─────────────────────────────
File Name: excel_replaced.xlsx
File Extension: xlsx
Mime Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
File Size: 212.8 kB
Acesso a dados binários:
- n8n Objeto Binário:
$binary.data.data - Base64 ContenteDisponível para uso direto.
- Operações com arquivosPronto para download, envio por e-mail ou armazenamento.
Observação: Frases inválidas são registradas como avisos, mas não interrompem o processamento. Outras frases válidas continuam sendo processadas.
Casos de uso
Padronização de dados e conversão de formatos
- Substitua valores inconsistentes por formatos padrão em todos os documentos do Excel.
- Converter datas, números de telefone ou identificadores para formatos padrão.
- Padronizar os símbolos monetários e os formatos numéricos.
Correção de erros e atualizações de conteúdo
- Corrija erros de ortografia e de entrada de dados automaticamente.
- Atualize nomes de produtos, preços ou valores de status em várias planilhas.
- Corrigir erros de digitação comuns e inconsistências de formatação.
Mascaramento de privacidade e proteção de dados
- Substitua dados sensíveis por valores mascarados para compartilhamento externo.
- Máscara PII (Informações de Identificação Pessoal) usando padrões de regex
- Aplicar a anonimização de dados para atender aos requisitos de conformidade e privacidade.