#Fonctionnalités avancées

#Pagination

#1. Mise à jour des numéros de page

#Syntaxe

Il suffit de l'insérer dans votre logiciel Office.

#Exemple

Dans Microsoft Word :

• Utilisez la fonction « Insertion → Numéro de page » Dans LibreOffice :
• Utilisez la fonction « Insertion → Champs → Numéro de page »

#Résultat

Dans le rapport généré, les numéros de page de chaque page seront mis à jour automatiquement.

#2. Génération de la table des matières

#Syntaxe

Il suffit de l'insérer dans votre logiciel Office.

#Exemple

Dans Microsoft Word :

• Utilisez la fonction « Insertion → Index et tables → Table des matières » Dans LibreOffice :
• Utilisez la fonction « Insertion → Table des matières et index → Table, index ou bibliographie »

#Résultat

La table des matières du rapport sera mise à jour automatiquement en fonction du contenu du document.

#3. Répétition des en-têtes de tableau

#Syntaxe

Il suffit de l'insérer dans votre logiciel Office.

#Exemple

Dans Microsoft Word :

• Faites un clic droit sur l'en-tête du tableau → Propriétés du tableau → Cochez « Répéter en tant que ligne d'en-tête en haut de chaque page » Dans LibreOffice :
• Faites un clic droit sur l'en-tête du tableau → Propriétés du tableau → Onglet Flux de texte → Cochez « Répéter l'en-tête »

#Résultat

Lorsqu'un tableau s'étend sur plusieurs pages, l'en-tête se répète automatiquement en haut de chaque page.

#Internationalisation (i18n)

#1. Traduction de texte statique

#Syntaxe

Utilisez la balise {t(texte)} pour internationaliser le texte statique :

{t(meeting)}

#Exemple

Dans le modèle :

{t(meeting)} {t(apples)}

Les données JSON ou un dictionnaire de localisation externe (par exemple, pour "fr-fr") fournissent les traductions correspondantes, comme « meeting » → « rendez-vous » et « apples » → « Pommes ».

#Résultat

Lors de la génération du rapport, le texte sera remplacé par la traduction correspondante en fonction de la langue cible.

#2. Traduction de texte dynamique

#Syntaxe

Pour le contenu des données, utilisez le formateur :t, par exemple :

{d.id:ifEQ(2):show({t(monday)}):elseShow({t(tuesday)})}

#Exemple

Dans le modèle :

{d.id:ifEQ(2):show({t(monday)}):elseShow({t(tuesday)})}

Les données JSON et le dictionnaire de localisation fournissent les traductions appropriées.

#Résultat

En fonction de la condition, la sortie sera « lundi » ou « mardi » (en prenant la langue cible comme exemple).

#Mappage clé-valeur

#1. Conversion d'énumération (:convEnum)

#Syntaxe

{données:convEnum(nomEnum)}

Par exemple :

0:convEnum('ORDER_STATUS')

#Exemple

Dans un exemple d'options d'API, les éléments suivants sont fournis :

{
  "enum": {
    "ORDER_STATUS": ["pending", "sent", "delivered"]
  }
}

Dans le modèle :

0:convEnum('ORDER_STATUS')

#Résultat

Affiche « pending » ; si l'index dépasse la plage de l'énumération, la valeur originale est affichée.

#Images dynamiques

2. Faites un clic droit sur cette image, modifiez son « Texte alternatif (Alt Text) » et saisissez l'étiquette du champ d'image que vous souhaitez insérer, par exemple {d.imageUrl} :

3. Utilisez les données d'exemple suivantes pour le rendu :

{
  "name": "Apple",
  "imageUrl": "https://images.pexels.com/photos/206959/pexels-photo-206959.jpeg",
}

4. Dans le résultat rendu, l'image temporaire sera remplacée par l'image réelle :

#Remplacement d'images multiples en boucle

Si vous souhaitez insérer un groupe d'images dans le modèle, comme une liste de produits, vous pouvez également le faire via des boucles. Les étapes spécifiques sont les suivantes :

1. Supposons que vos données soient les suivantes :

{
  "products": [
    {
      "name": "Apple",
      "imageUrl": "https://images.pexels.com/photos/206959/pexels-photo-206959.jpeg",
    },
    {
      "name": "Banana",
      "imageUrl": "https://images.pexels.com/photos/61127/pexels-photo-61127.jpeg",
    },
  ]
}

2. Dans le modèle DOCX, configurez une zone de boucle et insérez des images temporaires dans chaque élément de la boucle avec le texte alternatif défini sur {d.products[i].imageUrl}, comme illustré ci-dessous :

3. Après le rendu, toutes les images temporaires seront remplacées par leurs images de données respectives :

#Insertion d'images dynamiques dans les fichiers XLSX

La méthode d'opération dans les modèles Excel (XLSX) est fondamentalement la même, il suffit de noter les points suivants :

1. Après avoir inséré une image, assurez-vous de sélectionner « image dans la cellule » plutôt que d'avoir l'image flottant au-dessus de la cellule.

2. Après avoir sélectionné la cellule, cliquez pour afficher le « Texte alternatif » afin de renseigner l'étiquette du champ, par exemple {d.imageUrl}.

#Codes-barres

#Génération de codes-barres (tels que les codes QR)

La génération de codes-barres fonctionne de la même manière que les images dynamiques, ne nécessitant que trois étapes :

1. Insérez une image temporaire dans le modèle pour marquer l'emplacement du code-barres.

2. Modifiez le « Texte alternatif » de l'image et saisissez l'étiquette du champ de format de code-barres, par exemple {d.code:barcode(qrcode)}, où qrcode est le type de code-barres (voir la liste des types pris en charge ci-dessous).

3. Après le rendu, l'image de substitution sera automatiquement remplacée par l'image du code-barres correspondant :

#Types de codes-barres pris en charge