Pular para o conteúdo principal
API PDF4meIntegraçõesBase de conhecimentoExtensõesTestador de APIBlog

Substituir texto por imagem em Word em n8n

Substituir texto por imagem em Word é um PDF4me ação do nó em n8n que encontra um marcador de texto dentro de um .docx e insere uma imagem no lugar. Use-o para inserir uma assinatura em um contrato, um logotipo em um modelo personalizado ou um texto gerado automaticamente. QR Inserir o código em um documento de remessa, sem qualquer edição manual.

O que este nó faz

Esta ação leva duas entradas independentes: a Word documento e uma imagem, cada um com seu próprio menu suspenso de tipo de entradaEle pesquisa o documento pela sequência exata em Texto de pesquisa e substitui a imagem sempre que essa sequência de caracteres aparece no pages você analisa o escopo. O resultado é um novo .docx Com a imagem incorporada, pronta para o próximo nó.

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 solicitações de documentos.

Get your API Key

Fatos importantes que você não deve perder​

Duas fontes, duas listas suspensas
O Word O arquivo e a imagem são configurados separadamente. Deixar a origem da imagem indefinida é o motivo mais comum para uma execução produzir um documento sem alterações.
O texto de pesquisa é o único requisito indispensável.
É o único campo que o nó marca com um aviso de validação quando está vazio. Todos os outros campos do painel vêm com um valor padrão utilizável.
Um zero silencioso não é um erro.
Se o marcador não corresponder, o nó ainda assim terá sucesso e retornará o texto original. Portão ligado substituições feitas em vez de em success.

Word Mala direta versus Substituir texto por imagem: qual devo usar?​

WordA função nativa de mala direta do sistema foi criada para substituir... textoColocar uma imagem normalmente significa aninhar uma INCLUDEPICTURE campo dentro de um MERGEFIELD, apontando para um caminho de arquivo estável e atualizando os campos antes que as imagens apareçam. Isso funciona em um computador desktop, mas é problemático dentro de um pipeline automatizado. Este nó trata o espaço reservado como texto comum do documento e o substitui por uma imagem real, de modo que o arquivo que sai do fluxo de trabalho já tenha a imagem incorporada.

Word Mala direta com INCLUDEPICTUREPDF4me Substituir texto por imagem
Fonte da imagemUm caminho de arquivo que o campo pode alcançar.Dados binários, base64 ou um URL
Atualização de campoFrequentemente necessário antes da renderização das imagens.Não aplicável, a imagem está incorporada.
Funciona sem supervisãoFrágil fora do aplicativo para desktopProjetado para isso
Segmentação por páginaNão está incluídoNúmeros de página mais pular para a primeira página
Vários marcadoresUma passagem de mesclagemEncadeie um nó por marcador.
Qual contra qualEscolha para desktop, fusões pontuaisEscolha para execuções de fluxo de trabalho não supervisionadas.

Como faço para configurar o nó?​

Adicione o PDF4me Substituir texto por imagem em Word ação para o seu n8n fluxo de trabalho. Para a configuração inicial, consulte o n8n Guia de integração.

Pré-requisitos: a PDF4me API credencial, uma n8n fluxo de trabalho, um .docx Contendo o texto do marcador e a imagem a ser inserida.

O painel de parâmetros "Substituir texto por imagem no Word" no n8n, mostrando menus suspensos separados para o tipo de entrada do documento do Word e para a imagem.
Painel de nós. Observe as duas listas suspensas independentes para cada tipo de entrada e a borda vermelha de validação no campo vazio "Texto de pesquisa".

Quais são os parâmetros?​

Os campos aparecem no painel na seguinte ordem. Somente Texto de pesquisa é sinalizado como obrigatório; os demais têm valores padrão ou dependem do modo de entrada escolhido.

ParâmetroTipoObrigatórioDescriçãoExemplo
Word Document Input TypeOptionsRequiredHow the .docx reaches the node: Binary Data, Base64 String, or URL. The matching source field appears directly beneath it.Binary Data
Word Document Binary PropertyStringConditionalName of the binary property holding the Word file. Shown when the input type is Binary Data.data
Base64 Word Document ContentStringConditionalThe .docx as a base64 string. Shown when the input type is Base64 String.UEsDBBQABgAI...
Word Document URLStringConditionalA publicly reachable link to the .docx. Shown when the input type is URL.https://example.com/contract.docx
Word Document NameStringOptionalFilename used for the document being processed. Ships with a placeholder default.document.docx
Image Input TypeOptionsRequiredHow the image reaches the node. This is a separate dropdown from the Word document and is set independently.Binary Data
Image Binary PropertyStringConditionalName of the binary property holding the image. Shown when the image input type is Binary Data.data
Base64 Image ContentStringConditionalThe image as a base64 string. Shown when the image input type is Base64 String.iVBORw0KGgoAAAANS...
Image URLStringConditionalA publicly reachable link to the image. Shown when the image input type is URL.https://example.com/logo.png
Image File NameStringOptionalFilename of the image being inserted. Ships with a placeholder default.image.png
Is First Page SkipToggleOptionalExcludes page one from the search. Ships switched off. Useful when a cover page or letterhead must stay untouched.off
Page NumbersStringOptionalPages to search. Accepts a single page, a comma list, or a hyphenated range. Ships with 1.1
Search TextStringRequiredThe exact marker string to find and replace. The node shows a validation warning while this is empty.[LOGO_PLACEHOLDER]
Output Binary Field NameStringOptionalProperty name the resulting .docx is written to for the next node. Ships with data.data

:::nota Sintaxe de números de página O campo aceita uma única página (3), uma lista separada por vírgulas (1,4,7), um intervalo hifenizado (2-6), ou uma mistura dos dois (1,3,5-8). Defina o escopo para o pages que realmente contenham o marcador, de modo que uma correspondência aleatória em outro lugar em um documento longo não selecione uma imagem. :::

O que o nó retorna?​

CampoTipoDescriçãoExemplo
successBooleanWhether the operation completed. Note that a run which found no matches still returns true.true
messageStringHuman-readable status text, used for error detail when something fails.Text replaced with image successfully
fileNameStringFilename of the generated Word document.document_with_images.docx
mimeTypeStringMIME type of the output, always the .docx type.application/vnd.openxmlformats-officedocument.wordprocessingml.document
fileSizeNumberSize of the generated document in bytes.125430
docNameStringDocument name reference, matching fileName.document_with_images.docx
textReplacementCompletedBooleanConfirms the replacement pass ran to completion.true
replacementsMadeNumberHow many instances of the search text were substituted. This is the field to branch on.3

N8N Resposta à ação​

[
  {
    "success": true,
    "message": "Text replaced with image successfully",
    "fileName": "document_with_images.docx",
    "mimeType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
    "fileSize": 125430,
    "docName": "document_with_images.docx",
    "textReplacementCompleted": true,
    "replacementsMade": 3
  }
]

Configurações típicas​

Signature on a contract
A signing step returns a signature PNG. Point Word Document Input Type at the contract from the previous node, Image Input Type at the signature binary, and set Search Text to your [SIGNATURE] marker.
Logo into a branded template
The template lives in storage and the logo at a fixed URL. Use Binary Data for the document and URL for the image, so the logo is not re-uploaded on every run.
QR code onto a shipping document
A code-generating node produces the image, this node substitutes it for [QR_HERE], and a converter turns the result into a PDF for the carrier.
Per-record images at scale
Loop over a spreadsheet, fetch each row image, and run one node execution per record to produce an individually illustrated document.

Dicas práticas​

  • Ramo em replacementsMade, não success. Uma sequência que não corresponde a nada ainda relata successUm nó IF que verifica se a contagem é maior que zero detecta um modelo corrompido antes que o documento chegue ao cliente.
  • Digite o marcador uma vez e depois copie-o. Se parte de um marcador de posição for digitada ou estilizada novamente em WordO programa divide o conteúdo em execuções de formatação separadas internamente, e a busca deixa de enxergar uma sequência contínua, mesmo que a página pareça inalterada.
  • Escolha marcadores que não ocorram naturalmente. Tokens maiúsculos entre colchetes, como [LOGO_PLACEHOLDER] não irá colidir com o texto do corpo da mesma forma que um texto nu word como Logo pode.
  • Encadeamento de nós para múltiplas imagens. Alimente o documento de saída de cada nó na entrada do próximo nó para acumular um logotipo, uma assinatura e um QR Código em um único arquivo.
  • Preste atenção à formatação do próprio espaço reservado. A imagem é posicionada onde o texto estava, portanto, um marcador centralizado em um parágrafo com espaçamento generoso geralmente produz um resultado melhor do que um marcador inserido no meio de uma frase.
  • Preferência URL Modo para arte estática. O logotipo de uma empresa que nunca muda não precisa percorrer o fluxo de trabalho como dados binários a cada execução.

Folha de dicas​

MetaContexto
Insira uma imagem de assinaturaSearch Text = sua assinatura digital, imagem via Dados Binários
Deixe a capa como está.Is First Page Skip sobre
Somente pesquisa pages 2 a 5Page Numbers = 2-5
Use um logotipo hospedadoImage Input Type = URL, Image URL = o link
Detectar uma correspondência falhadaVerificar replacementsMade igual a 0
Encaminhe o resultado adiante.Leia o nome da propriedade em Output Binary Field Name

Perguntas frequentes​

Por que Word Problemas com imagens na mala direta?

WordA função de mala direta integrada substitui o texto. Inserir uma imagem tradicionalmente significa um INCLUDEPICTURE campo aninhado com um MERGEFIELD, que exige que as imagens estejam em caminhos de arquivo estáveis e, muitas vezes, precisa de uma atualização manual do campo antes de aparecerem. Este nó adota uma abordagem diferente: ele trata o espaço reservado como texto comum no .docx e substitui a imagem original por uma imagem real, de modo que o documento mesclado chegue com a imagem já incorporada.

Faça o Word O documento e a imagem precisam usar o mesmo método de entrada?

Não. Word Tipo de entrada de documento e Tipo de entrada de imagem São duas listas suspensas separadas, configuradas independentemente. Um padrão comum é o uso de Dados Binários para o .docx vindo de um anterior n8n nó e URL Para um logotipo que reside em um endereço fixo, o que evita buscar a mesma imagem a cada execução.

O que acontece se o texto da pesquisa não for encontrado?

A ação é concluída e retorna um documento, mas nada é substituído. Verifique replacementsMade na resposta: um valor de 0 Significa que o marcador nunca correspondeu. A causa usual é Word O texto de exemplo foi dividido em trechos de formatação interna, o que acontece quando parte do marcador foi digitada ou reestilizada, fazendo com que ele deixe de existir como uma string contínua, mesmo que pareça correto na tela.

Uma única execução pode substituir vários marcadores de posição diferentes?

Uma execução lida com uma Texto de pesquisa Valor associado a uma imagem. Um modelo que precisa de um logotipo, uma assinatura e um QR O código é processado encadeando três desses nós, cada um alimentando o documento de saída na entrada do próximo, de modo que as substituições se acumulem em um único arquivo.

Quais campos são realmente obrigatórios?

Texto de pesquisa é o único campo que o nó sinaliza como obrigatório. Word Nome do documento, Nome do arquivo de imagem, Números de página, e Nome do campo binário de saída Todos os pacotes são enviados com configurações padrão funcionando, e as duas listas suspensas de tipo de entrada exigem que o campo de origem corresponda ao modo escolhido.

Como faço para impedir que a página de rosto seja alterada?

Ligue o É a primeira página pular A opção de alternar, que desativa o envio, exclui a primeira página da pesquisa, o que é útil quando um cabeçalho ou página de título contém a mesma redação que o marcador que você está procurando em outra parte do documento.

Ações relacionadas em n8n​

Mesma tarefa em outras plataformas​

Casos de uso​

Identidade visual e identidade de marca para documentos​

Substitua os marcadores de posição por logotipos da empresa ou imagens de produtos para que todos os documentos gerados por um fluxo de trabalho tenham uma identidade visual consistente, sem que ninguém precise abri-los. Word.

Assinaturas e marcas de autenticação​

Inclua imagens de assinaturas, carimbos ou selos em contratos e formulários de aprovação no momento em que o fluxo de trabalho os alcançar, mantendo a etapa de assinatura dentro da automação.

Arte gerada por registro​

Inserir QR codes, códigos de barras ou gráficos que foram produzidos anteriormente no mesmo fluxo de trabalho, que é como um lote de documentos de remessa ou relatórios personalizados acaba ilustrado individualmente.

Leitura complementar​

Obtenha ajuda​

n8n Integration Guiden8n SampleGetting Started