Aller au contenu principal
API PDF4meIntégrationsBase de connaissancesExtensionsTesteur d'APIBlog

Insérer des images - Guide des images dynamiques

PDF4me Permet l'insertion dynamique d'images dans les documents générés, vous permettant ainsi d'enrichir les modèles avec des logos, des photographies, des graphiques, des diagrammes et d'autres contenus visuels provenant de vos sources de données. Les images peuvent être fournies via des sources publiques. URLs ou Base64-chaînes encodées.

Exigences de syntaxe d'image​

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.

Méthodes d'insertion d'images​

PDF4me prend en charge deux méthodes pour fournir des données d'image aux modèles :

Méthode 1 : Image publique URL​

Utiliser une image accessible au public URLs insérer des images provenant de sources web.

Syntaxe:

<<image [imageUrl]>>

Exemple de données :

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

Cas d'utilisation :

  • Logos d'entreprises hébergés sur des serveurs publics
  • Images de produits provenant de plateformes de commerce électronique
  • Graphiques et diagrammes générés et hébergés en ligne
  • Images de ressources publiques

Méthode 2 : Base64 Images encodées​

Insérer des images à l'aide de Base64-représentation sous forme de chaîne de caractères encodée du fichier image.

Syntaxe:

<<image [imageBase64]>>

Exemple de données :

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

Avantages :

  • Fonctionne sans connexion Internet
  • Sécurisé – sans dépendances externes
  • Contrôle total des données d'image
  • Convient aux documents sensibles

Options de mise en forme d'image​

Contrôlez l'affichage des images dans les zones de texte grâce aux options de mise en forme. Ces options déterminent la taille et le rapport hauteur/largeur des images.

Conserver les proportions​

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

Comportement:

  • Préserve la taille de la zone de texte
  • Redimensionne l'image pour qu'elle s'adapte aux limites de la zone de texte.
  • Conserve le format d'image original
  • L'image peut ne pas remplir toute la zone de texte si les proportions diffèrent.

Idéal pour : Logos, icônes et images pour lesquels toute distorsion doit être évitée

Taille adaptée​

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

Comportement:

  • Préserve la largeur de la zone de texte
  • Ajuste la hauteur de la zone de texte pour correspondre au format de l'image.
  • L'image remplit entièrement la zone de texte.
  • Les dimensions de la zone de texte s'adaptent à l'image.

Idéal pour : Images de hauteur variable dans des mises en page flexibles

Largeur d'ajustement​

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

Comportement:

  • Préserve la hauteur de la zone de texte
  • Ajuste la largeur de la zone de texte pour correspondre au format de l'image.
  • L'image remplit entièrement la zone de texte.
  • La largeur de la zone de texte s'adapte à l'image.

Idéal pour : Bannières horizontales, en-têtes à hauteur fixe

Taille​

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

Comportement:

  • Modifie les dimensions de la zone de texte pour correspondre à la taille de l'image
  • Utilise les dimensions de l'image originale
  • L'image s'affiche à sa taille réelle.
  • La zone de texte s'adapte aux dimensions exactes de l'image.

Idéal pour : Quand la taille originale de l'image doit être conservée exactement

Taille limitée​

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

Comportement:

  • Ajuste la zone de texte à la taille de l'image
  • Ne dépassera pas les dimensions d'origine de la zone de texte
  • La zone de texte peut être réduite si l'image est plus petite.
  • Empêche l'agrandissement de la zone de texte

Idéal pour : Limiter la taille maximale des images tout en autorisant des images plus petites

Comparaison de formatage​

Option de formatLargeurHauteurRapport d'aspectTaille de la zone de texte
-keepRatioFixéFixéConservéInchangé
-fitHeightFixéVariableConservéchangements de hauteur
-fitWidthVariableFixéConservéChangements de largeur
-fitSizeVariableVariableConservéLes deux changent
-fitSizeLimVariableVariableConservéContraint

Exemples pratiques​

Exemple 1 : Logo d’entreprise​

Modèle:

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

Données:

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

Exemple 2 : Images de produits​

Modèle:

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

<</foreach>>

Données:

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

Exemple 3 : Image de signature (Base64)​

Modèle:

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

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

Données:

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

Image dans les tableaux​

Associez l'insertion d'images à des structures de tableaux pour des présentations visuelles organisées.

Tableau du catalogue de produits​

Modèle:

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

Insertion d'images conditionnelles​

N'insérez les images que lorsque les données d'image sont disponibles.

Exemple de logo facultatif​

Modèle:

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

Image de repli par défaut​

Modèle:

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

Plusieurs images dans le document​

Générez des documents contenant plusieurs images dynamiques à partir d'une seule source de données.

Exemple : Rapport avec graphiques​

Modèle:

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>>

Considérations relatives à la qualité d'image​

Meilleures pratiques pour l'image URLs​

  1. Utiliser HTTPS - Sécurisé URLs prévenir les alertes de sécurité
  2. Permanent URLs - Assurer URLs rester accessible
  3. Taille appropriée - Utilisez des images de taille appropriée pour l'impression.
  4. Compatibilité des formats - Formats courants : PNG, JPG, GIF
  5. Hébergement CDN - Utilisez des réseaux de diffusion de contenu fiables

Meilleures pratiques pour Base64 Images​

  1. Optimiser la taille du fichier - Compresser les images avant l'encodage
  2. Utilisez une résolution appropriée - Correspondre à la résolution de sortie prévue
  3. Tenir compte de la taille des données - Grand Base64 Les chaînes de caractères augmentent la taille de la charge utile
  4. Sélection du format - PNG par souci de transparence, JPG pour les photos
  5. Qualité de l'encodage - Assurer le bon fonctionnement Base64 encodage

Configuration des zones de texte dans Word​

Création d'espaces réservés pour les images​

  1. Insérer une zone de texte :

    • Ruban Word → Insertion → Zone de texte
    • Dessinez la zone de texte à l'emplacement souhaité
    • Taillez la zone de texte en fonction des dimensions approximatives de l'image.

  2. Configurer la zone de texte :

    • Supprimez les bordures de la zone de texte si vous le souhaitez
    • Définissez le remplissage de la zone de texte sur « Aucun remplissage » pour la transparence.
    • Configurez le retour à la ligne automatique selon les besoins.

  3. Ajouter la syntaxe de l'image :

    • Cliquez dans la zone de texte
    • Syntaxe du champ de fusion d'images
    • Ajouter une option de mise en forme appropriée

Dépannage de l'insertion d'images​

Problèmes courants​

Problème: L'image n'apparaît pas dans le document généré.
Solution: Vérifiez que la syntaxe de l'image se trouve bien dans une zone de texte et non dans un paragraphe.

Problème: L'image apparaît déformée
Solution: Utiliser -keepRatio pour préserver le rapport d'aspect

Problème: Image trop grande ou trop petite
Solution: Ajustez la taille de la zone de texte ou utilisez l'option d'ajustement appropriée.

Problème: Base64 L'image n'a pas pu être chargée.
Solution: Vérifier Base64 L'encodage est complet et valide

Problème: URL L'image ne se charge pas
Solution: Vérifier URL accessibilité, garantir HTTPS, vérifier le format de l'image

Problème: Position de l'image incorrecte
Solution: Repositionner la zone de texte dans un modèle Word

Techniques d'imagerie avancées​

Dimensionnement adaptatif des images​

Pour les documents susceptibles d'être visualisés à différentes tailles :

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

Cela permet à l'image de se rétrécir si nécessaire, mais elle ne dépassera pas les limites de la zone de texte.

Image avec légende​

Modèle:

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

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

Mise en forme conditionnelle des images​

Choisissez la mise en forme en fonction des propriétés des données :

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

Exemple complet : Fiche produit​

Modèle:

<<[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>>

Optimisation des images

Pour de meilleurs résultats, optimisez les images avant de les inclure dans votre source de données. Redimensionnez-les aux dimensions appropriées et compressez-les pour réduire leur taille tout en préservant leur qualité.

:::

:::avertissement : Obligation relative aux zones de texte

Les images DOIVENT être insérées dans des zones de texte dans les modèles Word. La syntaxe d'image dans les paragraphes ordinaires ne permettra pas un affichage correct des images. Créez toujours une zone de texte pour chaque emplacement d'image dynamique.

:::