Passa al contenuto principale
PDF4me APIIntegrazioniBase di conoscenzaEstensioniTester APIBlog

Inserisci immagini - Guida dinamica all'inserimento immagini

PDF4me Consente l'inserimento dinamico di immagini all'interno dei documenti generati, permettendo di popolare i modelli con loghi, fotografie, grafici, diagrammi e altri contenuti visivi dalle proprie fonti di dati. Le immagini possono essere fornite tramite fonti pubbliche. URLs O Base64stringhe codificate.

Requisiti di sintassi delle immagini​

The image syntax must be placed inside a Text Box in Word for proper image population. Create a text box at the desired location in your template before adding image merge fields.

Metodi di inserimento immagini​

PDF4me supporta due metodi per fornire dati immagine ai modelli:

Metodo 1: Immagine pubblica URL​

Utilizzare un'immagine accessibile al pubblico. URLs per inserire immagini da fonti web.

Sintassi:

<<image [imageUrl]>>

Esempio di dati:

{
  "imageUrl": "https://public-url/image.png"
}

Casi d'uso:

  • Loghi aziendali ospitati su server pubblici
  • Immagini dei prodotti provenienti da piattaforme di e-commerce
  • Grafici e diagrammi generati e ospitati online
  • immagini di risorse pubbliche

Metodo 2: Base64 Immagini codificate​

Inserisci immagini utilizzando Base64Rappresentazione in stringa codificata del file immagine.

Sintassi:

<<image [imageBase64]>>

Esempio di dati:

{
  "imageBase64": "iVBORw0KGgoAAAANSUhEUgAAAfQAAAH0CAYAAADL1t+KAAAACXBIWXMAABcSAAAXEgFnn9JSAACU6ElEQVR4nOz953tjR5bn+34jtoMn6D2ZSaaRL5lSmR5z5t5/+9xzZqZ7qktSeksmvfcG3mzsveO+2ACVUklKUspMksj1eZ7qqpZECCCZ+CEiVqyljDEGIYQQQlxr+rKfgBBCCCH+OAl0IYQQogtIoAshhBBdQAJdCCGE6AIS6EIIIUQXkEAXQggh..."
}

Vantaggi:

  • Funziona anche senza connessione internet
  • Sicuro - nessuna dipendenza esterna
  • Controllo completo sui dati delle immagini
  • Adatto a documenti sensibili

Opzioni di formattazione dell'immagine​

Controlla come le immagini si adattano alle caselle di testo utilizzando le opzioni di formattazione. Queste opzioni determinano le dimensioni e le proporzioni delle immagini.

Mantieni le proporzioni​

Sintassi: <<image [imageUrl] -keepRatio>>

Comportamento:

  • Mantiene le dimensioni della casella di testo
  • Ridimensiona l'immagine per adattarla ai limiti della casella di testo.
  • Mantiene le proporzioni originali dell'immagine.
  • L'immagine potrebbe non riempire l'intera casella di testo se le proporzioni sono diverse.

Ideale per: Loghi, icone e immagini in cui è necessario evitare distorsioni.

Altezza adatta​

Sintassi: <<image [imageUrl] -fitHeight>>

Comportamento:

  • Mantiene la larghezza della casella di testo
  • Regola l'altezza della casella di testo per adattarla alle proporzioni dell'immagine.
  • L'immagine riempie completamente la casella di testo.
  • Le dimensioni della casella di testo cambiano per adattarsi all'immagine.

Ideale per: Immagini ad altezza variabile in layout flessibili

Larghezza adatta​

Sintassi: <<image [imageUrl] -fitWidth>>

Comportamento:

  • Mantiene l'altezza della casella di testo
  • Regola la larghezza della casella di testo in base alle proporzioni dell'immagine.
  • L'immagine riempie completamente la casella di testo.
  • La larghezza della casella di testo si adatta all'immagine.

Ideale per: Banner orizzontali, intestazioni con altezza fissa

Taglia adatta​

Sintassi: <<image [imageUrl] -fitSize>>

Comportamento:

  • Modifica le dimensioni della casella di testo per adattarle alle dimensioni dell'immagine.
  • Utilizza le dimensioni originali dell'immagine
  • L'immagine viene visualizzata a dimensioni reali.
  • La casella di testo si ridimensiona in base alle dimensioni esatte dell'immagine.

Ideale per: Quando le dimensioni originali dell'immagine devono essere mantenute esattamente

Vestibilità limitata​

Sintassi: <<image [imageUrl] -fitSizeLim>>

Comportamento:

  • Adatta la casella di testo alle dimensioni dell'immagine
  • Non supererà le dimensioni originali della casella di testo.
  • È possibile ridurre le dimensioni della casella di testo se l'immagine è più piccola.
  • Impedisce l'ingrandimento della casella di testo

Ideale per: Limitare le dimensioni massime delle immagini, consentendo al contempo immagini più piccole.

Confronto di formattazione​

Opzione di formatoLarghezzaAltezzaRapporto d'aspettoDimensioni della casella di testo
-keepRatioFissoFissoConservatoInvariato
-fitHeightFissoVariabileConservatocambiamenti di altezza
-fitWidthVariabileFissoConservatoVariazioni di larghezza
-fitSizeVariabileVariabileConservatoEntrambi cambiano
-fitSizeLimVariabileVariabileConservatoCostretto

Esempi pratici​

Esempio 1: Logo aziendale​

Modello:

[Create a text box in header]
<<image [companyLogo] -keepRatio>>

Dati:

{
  "companyLogo": "https://company.com/images/logo.png"
}

Esempio 2: Immagini del prodotto​

Modello:

<<foreach [product in products]>>
Product: <<[product.name]>>
[Text box:] <<image [product.imageUrl] -fitHeight>>
Price: $<<[product.price]>>

<</foreach>>

Dati:

{
  "products": [
    {
      "name": "Laptop Pro",
      "imageUrl": "https://example.com/laptop.jpg",
      "price": "1299.99"
    },
    {
      "name": "Wireless Mouse",
      "imageUrl": "https://example.com/mouse.jpg",
      "price": "29.99"
    }
  ]
}

Esempio 3: Immagine della firma (Base64)​

Modello:

Authorized Signature:
[Text box:] <<image [signatureBase64] -fitSizeLim>>

Name: <<[signatoryName]>>
Date: <<[signatureDate]:"dd.MM.yyyy">>

Dati:

{
  "signatureBase64": "iVBORw0KGgoAAAANSUhEUgA...[truncated]",
  "signatoryName": "John Smith",
  "signatureDate": "2024/01/15"
}

Immagine nelle tabelle​

Combina l'inserimento di immagini con le strutture tabellari per presentazioni visive organizzate.

Tabella del catalogo prodotti​

Modello:

Product | Image | Price
<<foreach [item in catalog]>>
<<[item.name]>> | [Text box: <<image [item.imageUrl] -keepRatio>>] | $<<[item.price]>>
<</foreach>>

Inserimento condizionale dell'immagine​

Inserisci le immagini solo se i dati dell'immagine sono disponibili.

Esempio di logo opzionale​

Modello:

<<if [logoUrl != null]>>
[Text box:] <<image [logoUrl] -keepRatio>>
<</if>>

Immagine di fallback predefinita​

Modello:

<<if [productImage != null]>>
[Text box:] <<image [productImage] -fitHeight>>
<<else>>
[Text box:] <<image [defaultProductImage] -fitHeight>>
<</if>>

Immagini multiple nel documento​

Genera documenti con più immagini dinamiche a partire da un'unica fonte di dati.

Esempio: Report con grafici​

Modello:

Sales Report - <<[reportMonth]:"MMMM yyyy">>

Revenue Chart:
[Text box:] <<image [revenueChartUrl] -fitWidth>>

Expense Chart:
[Text box:] <<image [expenseChartUrl] -fitWidth>>

Growth Chart:
[Text box:] <<image [growthChartUrl] -fitWidth>>

Considerazioni sulla qualità dell'immagine​

Migliori pratiche per le immagini URLs​

  1. Utilizzo HTTPS - Sicuro URLs prevenire avvisi di sicurezza
  2. Permanent URLs - Garantire URLs rimanere accessibili
  3. Dimensioni appropriate - Utilizzare immagini di dimensioni appropriate per l'output
  4. Compatibilità del formato - Formati comuni: PNG, JPG, GIF
  5. hosting CDN - Utilizzare reti di distribuzione dei contenuti affidabili

Migliori pratiche per Base64 Immagini​

  1. Ottimizza le dimensioni del file - Comprimere le immagini prima della codifica
  2. Utilizzare una risoluzione appropriata - Corrispondere alla risoluzione di output desiderata
  3. Considera la dimensione dei dati - Grande Base64 le stringhe aumentano la dimensione del payload
  4. Selezione del formato - PNG per trasparenza, JPG per le fotografie
  5. Qualità della codifica - Assicurarsi che sia adeguato Base64 codifica

Impostazione della casella di testo in Word​

Creazione di segnaposto per immagini​

  1. Inserisci casella di testo:

    • Barra multifunzione Word → Inserisci → Casella di testo
    • Disegna una casella di testo nella posizione desiderata
    • Ridimensiona la casella di testo in modo che corrisponda approssimativamente alle dimensioni dell'immagine.

  2. Configura la casella di testo:

    • Se lo desideri, puoi rimuovere i bordi della casella di testo.
    • Imposta il riempimento della casella di testo su "Nessun riempimento" per la trasparenza
    • Configurare l'a capo automatico del testo secondo necessità

  3. Sintassi per aggiungere un'immagine:

    • Fai clic all'interno della casella di testo
    • Sintassi del campo di unione immagine tipo
    • Aggiungi l'opzione di formattazione appropriata

Inserimento di immagini per la risoluzione dei problemi​

Problemi comuni​

Problema: L'immagine non compare nel documento generato.
Soluzione: Verificare che la sintassi dell'immagine sia all'interno di una casella di testo e non di un paragrafo normale.

Problema: L'immagine appare distorta
Soluzione: Utilizzo -keepRatio per preservare le proporzioni

Problema: Immagine troppo grande o troppo piccola
Soluzione: Regola le dimensioni della casella di testo o utilizza l'opzione di adattamento appropriato

Problema: Base64 Impossibile caricare l'immagine
Soluzione: Verifica Base64 la codifica è completa e valida

Problema: URL l'immagine non si carica
Soluzione: Controllo URL accessibilità, garantire HTTPS, verificare il formato dell'immagine

Problema: Immagine errata
Soluzione: Riposizionare la casella di testo nel modello di Word

Tecniche di elaborazione delle immagini avanzate​

Ridimensionamento adattivo delle immagini​

Per i documenti che possono essere visualizzati in diverse dimensioni:

[Large text box:] <<image [headerImage] -fitSizeLim>>

Ciò consente all'immagine di ridursi se necessario, ma non di espandersi oltre i limiti della casella di testo.

Immagine con didascalia​

Modello:

[Text box:] <<image [chartUrl] -fitWidth>>

Figure <<[$index + 1]>>: <<[chartTitle]>>
Source: <<[chartSource]>>

Formattazione condizionale dell'immagine​

Scegli la formattazione in base alle proprietà dei dati:

<<if [imageOrientation == "landscape"]>>
[Wide text box:] <<image [imageUrl] -fitWidth>>
<<else>>
[Tall text box:] <<image [imageUrl] -fitHeight>>
<</if>>

Esempio completo: Scheda prodotto​

Modello:

<<[productName]:caps>>

Product Image:
[Text box 300x300:] <<image [productImageUrl] -keepRatio>>

Specifications:
• Model: <<[modelNumber]>>
• Category: <<[category]>>
• Price: $<<[price]:"F2">>

Additional Images:
<<foreach [img in additionalImages]>>
[Text box 150x150:] <<image [img.url] -keepRatio>>
<<[img.caption]>>
<</foreach>>

Company Logo:
[Text box 200x60:] <<image [companyLogoBase64] -fitHeight>>

:::Suggerimento per l'ottimizzazione delle immagini Per ottenere risultati ottimali, ottimizza le immagini prima di includerle nella tua fonte dati. Ridimensiona le immagini alle dimensioni appropriate e comprimile per ridurre le dimensioni del file mantenendo la qualità.

:::

:::Avviso: Requisiti della casella di testo Le immagini DEVONO essere inserite all'interno di caselle di testo nei modelli di Word. La sintassi delle immagini nei paragrafi normali non visualizzerà correttamente le immagini. Creare sempre un segnaposto per la casella di testo per ogni posizione di immagine dinamica.

:::