Pular para o conteúdo principal

Substituir texto por imagem em n8n

Substituir texto por imagem é um n8n nó por PDF4me que encontra um espaço reservado para texto exato dentro de um PDF e o substitui por um logotipo, assinatura ou imagem do produto com dimensões correspondentes. Use-o para personalização de modelos, inserção de assinatura ou personalização visual automatizada sem edição manual. PDF.

O que este nó faz

PDF4meSubstituir texto por imagem escaneia um PDF Para uma sequência de texto exata, ele substitui cada ocorrência correspondente por uma imagem, dimensionada para a altura e largura escolhidas, nas páginas que você selecionar. Aceita tanto a fonte quanto o texto de origem. PDF e a imagem de substituição via Dados Binários, Base64 Corda, ou URL, de forma independente. Ideal para inserir logotipos, assinaturas, carimbos ou fotos de produtos em modelos predefinidos. PDFs.

Artigos relacionados no blogue
Ainda não há nenhuma publicação no blogue sobre esta funcionalidade — em breve.
Entretanto, explore o blogue da PDF4me para encontrar tutoriais e fluxos de trabalho para todas as plataformas.
Visite o blogue

Autenticando seu API Solicitar

Todo PDF4me nó em n8n requer um válido Credencial para se conectar comCrie ou selecione um que contenha o seu PDF4me API chave para que o fluxo de trabalho possa autenticar a solicitação de substituição com segurança.

Fatos importantes que você não deve perder

O texto a ser substituído deve ser exatamente igual.
PDF4me Realiza correspondência de texto precisa, incluindo espaços, pontuação e maiúsculas. Um marcador de posição como [LOGO_AQUI] Apenas corresponde àquela string exata, não a uma versão parcial ou com distinção entre maiúsculas e minúsculas.
PDF e as entradas de imagem são independentes
PDF O tipo de dados de entrada e o tipo de dados de entrada de imagem são definidos separadamente; um pode vir de dados binários, enquanto o outro vem de um tipo de dado de entrada. URL, útil quando o modelo PDF e o logotipo existem em sistemas diferentes.
Isto é um PDF ação, não a variante da Palavra
Um nó separado, "Substituir Texto por Imagem em Documento do Word", lida com arquivos .docx com marcadores de posição específicos do Word. Use este nó somente quando o documento de origem já for um arquivo .docx. PDF.
O nó n8n "Substituir Texto por Imagem" está configurado com a ação "Substituir Texto por Imagem", o tipo de dados de entrada do PDF é "Dados Binários", o campo do PDF é "Dados Binários", o tipo de dados de entrada da imagem é "Dados Binários", o campo da imagem é "Dados Binários", o texto a ser substituído, a sequência de páginas é "todas", a altura da imagem é 50 e a largura da imagem é 100%.

PDF4me Painel de parâmetros do nó "Substituir texto por imagem" em n8n

Quais parâmetros a função "Substituir texto por imagem" precisa?

Obrigatório: PDF Tipo de dados de entrada, Tipo de dados de entrada da imagem, Texto a ser substituído, Altura da imagem, Largura da imagem e Nome do arquivo de saída. Os campos condicionais aparecem somente quando o Tipo de dados de entrada correspondente é selecionado. Sequência da página. AsyncOs parâmetros `<binary data, 3234 bytes>` e `<binary data, 3234 bytes>` são opcionais e possuem valores padrão funcionais.

ParâmetroObrigatórioO que fazExemplo
PDF Input Data TypeRequiredFormat of the source PDF input. Choose Binary Data (from a previous node), Base64 String, or URL.Binary Data
PDF Binary FieldConditionalName of the binary property on the incoming n8n item that holds the source PDF. Required when PDF Input Data Type is Binary Data.data
Base64 PDF ContentConditionalBase64-encoded source PDF content. Required when PDF Input Data Type is Base64 String.JVBERi0xLjQK...
PDF URLConditionalPublicly reachable HTTPS URL to the source PDF. Required when PDF Input Data Type is URL.https://example.com/sample.pdf
Image Input Data TypeRequiredFormat of the replacement image input. Choose Binary Data, Base64 String, or URL, independent of the PDF input type.Binary Data
Image Binary FieldConditionalName of the binary property on the incoming n8n item that holds the replacement image. Required when Image Input Data Type is Binary Data.data
Base64 Image ContentConditionalBase64-encoded replacement image content. Required when Image Input Data Type is Base64 String./9j/4AAQSkZJRgAB...
Image URLConditionalPublicly reachable HTTPS URL to the replacement image. Required when Image Input Data Type is URL.https://example.com/logo.png
Text to ReplaceRequiredThe exact text string to find and replace with the image, matched precisely including case and punctuation.[LOGO_HERE]
Page SequenceOptionalPages to search for the placeholder. Use all, specific pages (1,3,5), or a range (1-5). Default all.all
Image HeightRequiredHeight in pixels to scale the replacement image to, maintaining aspect ratio.50
Image WidthRequiredWidth in pixels to scale the replacement image to, maintaining aspect ratio.100
Output File NameRequiredFilename for the resulting PDF, must include the .pdf extension.replace_text_with_image.pdf
AsyncOptionalEnables background processing for large PDFs. Default false.false
Binary Data Output NameOptionalName of the binary property the output item exposes. Default is data.data

Campos de saída

Uma corrida bem-sucedida retorna um n8n item carregando JSON metadados e o binário atualizado PDF.

CampoTipoO que contém
successBooleanTrue when the replacement succeeded. Use to route error-handling branches.
messageStringHuman-readable status message for the replacement result.
fileNameStringGenerated filename, matching Output File Name.
mimeTypeStringMIME type of the output, always application/pdf.
fileSizeNumberSize of the resulting PDF in bytes.
pagesProcessedNumberNumber of pages searched for the placeholder text.
Binary (data)BinaryThe updated PDF under Binary Data Output Name (default data). Pass into Write Binary File, Email, or any cloud-storage upload.

Como faço para configurar a substituição de texto por imagem em n8n?

  1. Adicionar PDF4me para o seu n8n fluxo de trabalho e escolha o Substituir texto por imagem Ação.
  2. Em Credencial para se conectar com, selecione o seu PDF4me credencial ou clique Criar nova credencial e cole o seu API chave.
  3. Definir PDF Tipo de dados de entrada e fornecer a fonte PDF via PDF Campo Binário, Base64 PDF Contente, ou PDF URL.
  4. Definir Tipo de dados de entrada de imagem e forneça a imagem de substituição através de Campo binário da imagem, Base64 Conteúdo da imagem, ou Imagem URL.
  5. Digitar Texto a ser substituído exatamente como aparece no PDFe definir Sequência de páginas Se você precisar segmentar páginas específicas.
  6. Definir Altura da imagem e Largura da imagem para dimensionar a imagem de substituição e definir Nome do arquivo de saída.
  7. Habilitar Async para grandes PDFs Se necessário, execute o nó e direcione a rota atualizada. PDF para a próxima etapa.

Configurações típicas

Exemplos de fluxo de trabalhoCommon n8n workflow patterns using Replace Text With Image.
Inserção do logotipo do cliente em um modelo de proposta
  1. Um webhook de CRM é acionado quando uma nova proposta é gerada para um cliente.
  2. PDF4me A opção "Substituir texto por imagem" é executada com o texto a ser substituído definido como [LOGOTIPO DO CLIENTE] e Tipo de Dados de Entrada de Imagem URL apontando para o logotipo do cliente.
  3. A proposta personalizada é enviada por e-mail ao representante de vendas para revisão final.
Carimbo de assinatura em contrato gerado
  1. Um contrato é gerado através de PDF4me Gerar documento com um [ASSINATURA] Espaço reservado.
  2. PDF4me A opção "Substituir Texto por Imagem" utiliza a imagem da assinatura do signatário, enquanto a opção "Sequência de Páginas" direciona a ação apenas para a página final.
  3. O contrato, que parece ter sido assinado, está arquivado em SharePoint.
Troca de imagem do produto em um catálogo PDF
  1. Um nó "Loop Over Items" itera sobre os registros de produtos de um banco de dados de inventário.
  2. PDF4me A função "Substituir Texto por Imagem" é executada item por item, substituindo um [IMAGEM_DO_PRODUTO] Espaço reservado com a foto de cada produto armazenada na nuvem.
  3. Cada página de catálogo personalizada é combinada posteriormente em um único arquivo distribuível. PDF.
Carimbo de aprovação gráfico após a assinatura.
  1. Um webhook de aprovação é acionado assim que um gerente marca um documento como aprovado em uma ferramenta interna.
  2. PDF4me A opção Substituir Texto por Imagem é executada com um [CARIMBO_DE_APROVAÇÃO] O texto de exemplo foi substituído por um gráfico de aprovação.
  3. A versão finalizada PDF O arquivo é arquivado com a data de aprovação no nome do arquivo.

Dicas práticas

Use a distinctive placeholder string
A unique token like [CLIENT_LOGO] avoids accidentally matching unrelated text elsewhere in the document.
Match Image Height/Width to the source aspect ratio
Mismatched dimensions can stretch or squash the inserted image; check the source image proportions first.
Narrow Page Sequence when possible
Targeting only the pages that contain the placeholder is faster and avoids unintended matches on other pages.
PDF and image sources can differ
Pull the template PDF from Binary Data while sourcing the logo from a URL, or any other combination that fits your workflow.
Enable Async for large PDFs
Large documents benefit from asynchronous processing so the workflow execution does not time out.
Use the Word variant for .docx files
This node processes PDFs; for Word documents use the separate Replace Text With Image in Word Document node.

Folha de dicas

CampoValor
ActionReplace Text With Image
PDF Input Data TypeBinary Data
PDF Binary Fielddata
Image Input Data TypeBinary Data
Image Binary Fielddata
Text to Replace[LOGO_HERE]
Page Sequenceall
Image Height50
Image Width100
Output File Namereplace_text_with_image.pdf
CredentialsPDF4me API credential

Perguntas frequentes

Does Text to Replace need to match exactly?+
Yes. PDF4me performs precise text matching, so Text to Replace must match the placeholder in the PDF exactly, including spaces, punctuation, and capitalization, similar to the exact-match requirements described in community discussions on replacing content inside a PDF.
Can I replace text on only some pages?+
Yes. Page Sequence accepts all, specific page numbers such as 1,3,5, or ranges such as 1-5, so you can target only the pages that contain the placeholder.
What image formats can replace the text?+
JPG, PNG, GIF, and BMP. Supply the image via Image Binary Field, Base64 Image Content, or Image URL depending on Image Input Data Type.
Does the image keep its aspect ratio?+
PDF4me scales the image to the Image Height and Image Width you specify while maintaining aspect ratio, so choose dimensions that match the source image's proportions, the same general scaling consideration covered in Adobe's guidance on placing graphics onto a PDF page.
Is this the same as the Word variant of this action?+
No. This action operates on PDF documents. A separate Replace Text With Image in Word Document node exists in n8n for .docx files, using Word-specific merge-field style placeholders instead of exact-text matching.

Ações relacionadas

Mesma tarefa em outras plataformas

Obtenha ajuda