Configurer une région répétée

À quoi ça sert

Une région répétée sert à imprimer une liste dans le document : un tableau de produits chiffrés, une liste d'équipements, les lignes d'un tableau d'une fiche CRM. Le document déclare la région une seule fois, et Deltia la répète autant de fois qu'il y a de lignes sur le contrat.

Vous décidez ici d'où viennent les lignes — les produits du catalogue, ou les lignes d'un tableau d'une fiche CRM — et ce que chaque placeholder de la région doit imprimer.

Cette configuration se fait dans la section « Champs » du modèle, sur un champ de type « Région répétée ».

Concepts clés

• Région — dans le document Word, un bloc encadré par {#produits} et {/}. Deltia détecte ces blocs à l'import et propose alors le type « Région répétée » sur le champ correspondant.
• Placeholder de la région — une variable écrite à l'intérieur du bloc, par exemple {libelle} ou {prix}. C'est ce qui est imprimé sur chaque ligne.
• Ligne — une itération de la région : un produit sélectionné sur le contrat, ou une ligne du tableau CRM choisi.
• Correspondance — l'association entre chaque placeholder de la région et ce qui doit l'alimenter. Un placeholder laissé de côté reste vide.
• Modèle de cellule — le gabarit qui assemble plusieurs attributs, et éventuellement des montants de ligne, en une seule valeur imprimée.
• Région imbriquée — une région déclarée à l'intérieur d'une autre. Elle n'est pas alimentée.

Comment faire

Déclarer une région dans le document Word

1. Dans le document, écrivez {#produits} au début du bloc à répéter et {/} à sa fin.
2. Pour répéter une ligne de tableau, placez {#produits} dans la première cellule de la ligne et {/} dans la dernière : c'est ce qui fait répéter la ligne entière plutôt que le contenu d'une seule cellule.
3. À l'intérieur du bloc, écrivez les placeholders à imprimer sur chaque ligne, avec les mots de votre choix : {libelle}, {quantite}, {prix}.
4. Importez ou remplacez le document dans le modèle.

Le nom de la région (produits ici) devient un champ du modèle, comme les autres variables.

Alimenter une région avec les produits du catalogue

1. Ouvrez le modèle, section « Champs », sélectionnez le champ portant le nom de la région.
2. Choisissez le type « Région répétée ».
3. Dans « Source de données », laissez « Catalogue ».
4. Choisissez la « Catégorie de produit ». Elle décide des produits que l'utilisateur pourra sélectionner, et des champs personnalisés proposés à l'étape suivante.
5. Dépliez « Filtre des cibles » si vous voulez restreindre davantage les produits proposés.
6. Sous « Correspondance des placeholders », dépliez chaque placeholder et cochez les attributs du produit à imprimer.
7. Renseignez le « Modèle » de la cellule si vous combinez plusieurs attributs ou un montant de ligne.
8. Enregistrez.

À la création d'un contrat, l'utilisateur choisit les produits et leurs quantités ; le document imprime une ligne par produit.

Alimenter une région avec un tableau d'une fiche CRM

1. Sur le champ « Région répétée », réglez « Source de données » sur « CRM (tableau) ».
2. Choisissez l'« Entité CRM ».
3. Choisissez le « Champ tableau ». Si l'entité n'en a pas : « Cette entité n'a aucun champ de type tableau. »
4. Sous « Correspondance des placeholders », dépliez chaque placeholder et cochez les « Colonnes » à imprimer.
5. Renseignez le « Modèle » de la cellule si vous en combinez plusieurs.
6. Enregistrez.

À la création d'un contrat, l'utilisateur choisit la fiche dont le tableau alimente la région ; le document imprime une ligne par ligne du tableau.

Imprimer un montant sur chaque ligne

1. Ouvrez le placeholder concerné dans « Correspondance des placeholders ».
2. Sans cocher aucun attribut, saisissez le jeton voulu dans le « Modèle », par exemple {unitPrice}.
3. Enregistrez.

« Combinez les attributs cochés et les montants de la ligne (jetons colorés). Un jeton absent reste vide. » Ces montants ne sont proposés que sur une région alimentée par le catalogue.

Combiner plusieurs valeurs dans une cellule

1. Ouvrez le placeholder et cochez les attributs voulus.
2. Dans le « Modèle », composez la valeur avec les jetons affichés au-dessus, par exemple {name} — {unitPrice}.
3. Enregistrez.

Le résumé affiché à côté du placeholder, une fois replié, reprend le modèle saisi ou la liste des attributs cochés. « Non renseigné » signale un placeholder laissé de côté.

Imprimer une image sur chaque ligne

1. Dans le document Word, à l'intérieur du bloc {#produits}…{/}, écrivez la variable en tag brut, par exemple {@photo}, seule dans son paragraphe.
2. Importez ou remplacez le document dans le modèle.
3. Sur la région alimentée par le catalogue, dépliez le placeholder {@photo} sous « Correspondance des placeholders ».
4. Choisissez le champ personnalisé de type Image de la catégorie. Sans champ Image sur la catégorie : « Aucun champ image sur cette catégorie ».
5. Renseignez la « Largeur maximale (mm) » de la colonne si vous voulez borner la taille de l'image. « La page n'est pas la cellule : sans borne, la photo déborde de sa colonne. »
6. Enregistrez.

Un placeholder en tag brut n'accepte qu'un champ Image et ne propose ni attributs à cocher ni « Modèle » : il imprime l'image telle quelle sur chaque ligne. Cette possibilité n'existe que sur une région alimentée par le catalogue, pas sur une région alimentée par un tableau CRM.

Référence

Sources d'une région répétée

Jetons de montant, sur une région catalogue

Ils viennent de la ligne du contrat, pas de la fiche produit : la quantité est celle qui a été saisie, et le prix unitaire est celui qui a été figé au choix du produit.

Attributs proposés sur une région catalogue

Les mêmes que sur un champ lié au catalogue : les « Champs standards » (« Nom », « Référence », « Description », « Type », « Unité », « Prix de vente », « Prix d'achat », « TVA (%) », « Statut ») et les « Champs personnalisés » de la catégorie choisie. Voir Lier un champ au CRM ou au catalogue.

Ce qui rend une région configurée

La correspondance des placeholders peut rester partielle : un placeholder non renseigné est simplement imprimé vide.

Limites connues

• Une région déclarée à l'intérieur d'une autre n'est pas alimentée : « Les régions imbriquées (…) ne sont pas encore alimentées et resteront vides. »
• Aucune mise en forme n'est possible à l'intérieur d'une ligne : le contenu imprimé est du texte simple.
• Les montants sont toujours formatés en euros et à la française, quelle que soit la langue du document.
• Une variable de signature électronique placée à l'intérieur d'une région empêche l'activation du modèle : elle serait imprimée autant de fois qu'il y a de lignes.
• Si la région ne contient aucun placeholder : « La région ne contient aucun placeholder à alimenter. »

Questions fréquentes

Le type « Région répétée » n'apparaît pas dans la liste des types

Il n'est proposé que sur un champ dont le nom est déclaré comme région dans le document Word. Vérifiez que le document écrit bien {#nom} et {/} autour du bloc, puis remplacez le fichier du modèle.

Une région peut-elle rester une simple condition d'affichage ?

Oui. La même syntaxe sert aussi à n'afficher un bloc que si un champ est rempli. Dans ce cas, ne choisissez pas le type « Région répétée » : laissez au champ un type simple, par exemple « Texte ».

Puis-je écrire mes placeholders dans une autre langue que le catalogue ?

Oui. Les noms des placeholders sont les vôtres : c'est la correspondance que vous établissez ici qui dit ce que chacun contient. Un document en allemand peut écrire {bezeichnung} là où le document français écrit {libelle}.

Que se passe-t-il si aucun produit n'est sélectionné ?

Rendez le champ optionnel : « Si aucune ligne n'est sélectionnée, toute la région est masquée dans le document. » Sans cela, l'absence de ligne est traitée comme un champ obligatoire non rempli.

Le total imprimé sous le tableau se calcule-t-il tout seul ?

Oui, avec un champ de type « Total catalogue » qui agrège la liste de produits de cette région. Voir Lier un champ au CRM ou au catalogue.