Passa al contenuto principale
PDF4me APIIntegrazioniBase di conoscenzaEstensioniTester APIBlog

Sostituisci il testo con l'immagine in Word In n8n

Sostituisci il testo con l'immagine in Word è un PDF4me azione del nodo in n8n che trova un marcatore di testo all'interno di un .docx e inserisce un'immagine al suo posto. Usalo per inserire una firma in un contratto, un logo in un modello personalizzato o un'immagine generata QR codice inserito in un documento di spedizione, senza alcuna modifica manuale.

Cosa fa questo nodo

Questa azione richiede due ingressi indipendenti: UN Word documento e un'immagine, ciascuno con il proprio menu a tendina di tipo input. Cerca nel documento la stringa esatta in Testo di ricerca e sostituisce l'immagine ovunque appaia quella stringa sul pages tu scopi. Il risultato è un nuovo .docx con l'immagine incorporata, pronta per il nodo successivo.

Articoli correlati del blog
Non ci sono ancora post sul blog dedicati a questa funzionalità — in arrivo a breve.
Nel frattempo, dai un'occhiata al blog di PDF4me per trovare tutorial e procedure operative su tutte le piattaforme.
Visita il blog →

Autenticazione del tuo API Richiesta​

Ogni PDF4me nodo in n8n richiede un valido Credenziali per connettersi con. Crea o selezionane uno che contenga il tuo PDF4me API chiave affinché il flusso di lavoro possa autenticare le richieste di documenti.

Get your API Key

Informazioni importanti da non perdere​

Due fonti, due menu a tendina
IL Word Il file e l'immagine vengono configurati separatamente. Lasciare la sorgente dell'immagine non impostata è la causa più comune per cui un'esecuzione produce un documento invariato.
Il testo di ricerca è l'unico requisito imprescindibile
È l'unico campo che il nodo contrassegna con un avviso di validazione quando è vuoto. Tutti gli altri campi del pannello vengono visualizzati con un valore predefinito utilizzabile.
Uno zero silenzioso non è un errore
Se il marcatore non corrisponde, il nodo ha comunque successo e restituisce il testo originale. Gate on sostituzioni effettuate piuttosto che su success.

Word Stampa unione o sostituzione del testo con immagine: quale utilizzare?​

WordLa funzione di unione di stampa nativa è progettata per sostituire testo. Posizionare un'immagine normalmente significa annidare un INCLUDEPICTURE campo all'interno di un MERGEFIELD, puntando a un percorso file stabile e aggiornando i campi prima che le immagini vengano visualizzate. Questo è fattibile su un computer desktop, ma risulta macchinoso all'interno di una pipeline automatizzata. Questo nodo tratta il segnaposto come normale testo del documento e lo sostituisce con un'immagine reale, in modo che il file che esce dal flusso di lavoro abbia già l'immagine incorporata.

Word stampa unione con INCLUDEPICTUREPDF4me Sostituisci il testo con un'immagine
Fonte dell'immagineUn percorso file raggiungibile dal campoDati binari, base64 o un URL
Aggiornamento del campoSpesso necessario prima del rendering delle immaginiNon applicabile, l'immagine è incorporata
Funziona senza supervisioneFragile al di fuori dell'applicazione desktopProgettato per questo
Targeting per paginaNon integratoNumeri di pagina più salto alla prima pagina
Diversi indicatoriUn passaggio di unioneCatena un nodo per marcatore
Quale contro qualeScelta per desktop, fusioni una tantumSeleziona per l'esecuzione automatica dei flussi di lavoro

Come si configura il nodo?​

Aggiungi il PDF4me Sostituisci il testo con l'immagine in Word azione alla tua n8n flusso di lavoro. Per la configurazione iniziale, vedere il n8n Guida all'integrazione.

Prerequisiti: UN PDF4me API credenziale, un n8n flusso di lavoro, un .docx contenente il testo del marcatore e l'immagine da inserire.

Il pannello dei parametri "Sostituisci testo con immagine in Word" in n8n, che mostra menu a tendina separati per il tipo di input del documento Word e dell'immagine.
Il pannello dei nodi. Si notino i due menu a tendina indipendenti per i tipi di input e il bordo di convalida rosso sul campo di testo di ricerca vuoto.

Quali sono i parametri?​

I campi appaiono nel pannello nell'ordine seguente. Solo Testo di ricerca è contrassegnato come obbligatorio; gli altri hanno valori predefiniti o dipendono dalla modalità di input scelta.

ParametroTipoNecessarioDescrizioneEsempio
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 Sintassi dei numeri di pagina Il campo accetta una singola pagina (3), un elenco separato da virgole (1,4,7), un intervallo con trattino (2-6), o un mix dei due (1,3,5-8). Estendilo al pages che contengano effettivamente il marcatore, in modo che una corrispondenza casuale in un altro punto di un documento lungo non selezioni un'immagine.

:::

Cosa restituisce il nodo?​

CampoTipoDescrizioneEsempio
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 Risposta all'azione​

[
  {
    "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
  }
]

Configurazioni tipiche​

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.

Consigli pratici​

  • Filiale su replacementsMade, non success. Una corsa che non corrisponde a nulla segnala comunque successUn nodo IF che verifica che il conteggio sia maggiore di zero individua un modello errato prima che il documento raggiunga il cliente.
  • Digita il marcatore una volta, poi copialo. Se parte di un segnaposto viene riscritto o rimodellato in WordIl programma lo suddivide internamente in sequenze di formattazione separate e la ricerca non vede più una stringa contigua, anche se la pagina appare invariata.
  • Scegliete marcatori che non possono trovarsi in natura. Token maiuscoli tra parentesi quadre come [LOGO_PLACEHOLDER] non si scontrerà con la copia del corpo come un nudo word Piace Logo Potere.
  • Catena di nodi per immagini multiple. Inserisci il documento di output di ciascun nodo nell'input del nodo successivo per accumulare un logo, una firma e un QR codice in un unico file.
  • Presta attenzione alla formattazione del segnaposto. L'immagine viene posizionata dove si trovava il testo, quindi un indicatore inserito in un paragrafo centrato e con un'adeguata spaziatura generalmente produce un risultato migliore rispetto a uno nascosto a metà frase.
  • Prefer URL modalità per opere d'arte statiche. Un logo aziendale che non cambia mai non ha bisogno di essere trasmesso come dato binario attraverso il flusso di lavoro a ogni esecuzione.

Foglio riassuntivo​

ObiettivoCollocamento
Inserisci un'immagine della firmaSearch Text = il tuo indicatore di firma, immagine tramite dati binari
Non modificare la pagina di copertina.Is First Page Skip SU
Cerca soltanto pages da 2 a 5Page Numbers = 2-5
Utilizzare un logo ospitatoImage Input Type = URL, Image URL = il collegamento
Rileva una corrispondenza non riuscitaControllo replacementsMade uguale 0
Trasmetti il risultatoLeggi la proprietà denominata in Output Binary Field Name

Domande frequenti​

Perché Word Problemi con la stampa unione e le immagini?

WordLa funzione di stampa unione integrata sostituisce il testo. Ottenere un'immagine in modo tradizionale significa un INCLUDEPICTURE campo annidato con un MERGEFIELD, che richiede che le immagini si trovino in percorsi di file stabili e spesso necessita di un aggiornamento manuale del campo prima che vengano visualizzate. Questo nodo segue una strada diversa: tratta il segnaposto come testo normale nel .docx e sostituisce l'immagine con un'immagine reale, in modo che il documento unito risulti avere l'immagine già incorporata.

Fare il Word Il documento e l'immagine devono utilizzare lo stesso metodo di input?

NO. Word Tipo di input del documento E Tipo di input immagine sono due menu a tendina separati configurati indipendentemente. Uno schema comune è Dati binari per il .docx proveniente da un precedente n8n nodo e URL per un logo che risiede a un indirizzo fisso, il che evita di scaricare la stessa immagine a ogni esecuzione.

Cosa succede se il testo cercato non viene trovato?

L'azione viene completata e restituisce un documento, ma non viene effettuato alcun cambio. Verifica replacementsMade nella risposta: un valore di 0 significa che il marcatore non ha mai corrisposto. La causa usuale è Word avendo suddiviso il segnaposto in più iterazioni di formattazione interna, cosa che accade quando parte del marcatore è stata riscritta o rimodellata, quindi non esiste più come un'unica stringa continua anche se appare corretta sullo schermo.

È possibile che una singola esecuzione sostituisca diversi segnaposto?

Un'esecuzione gestisce una Testo di ricerca valore abbinato a un'immagine. Un modello che necessita di un logo, una firma e un QR Il codice viene gestito concatenando tre di questi nodi, ognuno dei quali alimenta il proprio documento di output con l'input del nodo successivo, in modo che le sostituzioni si accumulino in un unico file.

Quali campi sono effettivamente obbligatori?

Testo di ricerca è l'unico campo che il nodo contrassegna come obbligatorio. Word Nome reale, Nome del file immagine, Numeri di pagina, E Nome del campo binario di output Tutti i modelli vengono forniti con impostazioni predefinite funzionanti e i due menu a tendina relativi al tipo di input richiedono ciascuno il campo sorgente corrispondente alla modalità selezionata.

Come posso impedire che la pagina di copertina venga modificata?

Accendi il Salta la prima pagina Interruttore che si attiva e disattiva. Esclude la prima pagina dalla ricerca, il che è utile quando la carta intestata o il frontespizio contengono la stessa dicitura del marcatore che si sta cercando in un'altra parte del documento.

Azioni correlate in n8n​

Stessa attività su altre piattaforme​

Casi d'uso​

Documentare il branding e l'identità visiva​

Sostituisci i token segnaposto con i loghi aziendali o le immagini dei prodotti in modo che ogni documento prodotto da un flusso di lavoro abbia un marchio coerente, senza che nessuno lo apra Word.

Firme e marchi di autenticazione​

Inserisci immagini di firme, timbri o sigilli nei contratti e nei moduli di approvazione nel punto in cui il flusso di lavoro li raggiunge, mantenendo la fase di firma all'interno dell'automazione.

Grafica generata per ogni record​

Insert QR codescodici a barre o grafici prodotti in precedenza nello stesso flusso di lavoro, ed è così che un lotto di documenti di spedizione o report personalizzati finisce per essere illustrato individualmente.

Per approfondire​

Richiedi assistenza​

n8n Integration Guiden8n SampleGetting Started