Les modèles DOCX

Les modèles DOCX

Cet écran présente la création de modèle de documents type DOCX (MS Word champ de fusion).

L’utilisation de “MS Word champ de fusion” est la méthode préconisée pour créer vos modèles. La
déclaration des variables dans un document MS Word se base sur les champs fusion natifs au format .docx. Écrivez votre lettre et insérer vos variables aux points précises.

  • L’utilisateur utilise Word pour rédiger un document à trous qu’il upload dans MailMerge.

  • Les trous s’écrivent en utilisant des champs de fusion faisant référence aux variables à afficher (par exemple “pat_prenom”). 

  • Peut être utilisé par exemple pour pré-rédiger automatiquement un rapport d’alerte.

  • Peut générer un PDF, mais aussi un DOCX modifiable.

Description générale de l'écran

MS Word champ de fusion

1 Pour insérer une variable, aller sur Insertion > QuickPart > Champ…

2 puis sélectionner ChampFusion.

3 Saisir le nom de la variable souhaitée comme varset_name-variable_name. Ne pas formater ce texte, laisser le comme (Aucune). Si vous voulez afficher la date actuelle (la date à laquelle vous générez les documents), mettez l'une des trois fonctions ci-dessous en tant que nom du champ:
__DATE__SHORT__ produira : 13/10/14
__DATE__LONG__ produira : 13 octobre 2014
__DATE__FULL__ produira : lundi 13 octobre 2014
__DATE__YEAR__ produira : 2026
__DATE__MONTH__ produira : 01
__DATE_DAY__ produira : 30

Il est aussi possible de combiner plusieurs variable date.

Pour avoir une date au format YYYY-MM-DD il faut combiner les différentes variables qui contiennent le jour, le mois et l’année. Attention cette combinaison ne dois pas être le résultat d’un seul champ de fusion. Il faut des champs de fusion séparés pour le jour le mois et l’année et créer la combinaison directement dans la feuille Word.
Exemple dans le modèle docx :

image-20260605-142507.png
  • Afficher la date dans une autre langue
    Les formats __DATE__FULL__ et __DATE__LONG__ utilisent les conventions de date associées à la locale.

Pour que la date s’affiche dans une autre langue, il est nécessaire de configurer le fichier DOCX avec la langue souhaitée :

https://epiconcept.atlassian.net/wiki/x/AoCD9g

4 Télécharger la police Windows C39P24DlTt ou C39HrP24DhTt (https://www.wfonts.com) puis l’appliquer au nom de la variable sur la page entre les guillemets.

Pour finir, sauvegarder votre document MS Word en format .docx. Il en est ainsi le fichier à téléverser et qui sera fusionné avec la requête de données ou l'export.

IMPORTANT : Si votre requête de données n'est pas une exportation (une requête faite manuellement avec une propriété personnalisée), ne préfixez pas chaque variable avec le nom du varset. Au lieu de patient-code_postal, vous n'entrez que code_postal.

Démonstration

Utilisation du champ de fusion

Insérer une table dans un modèle MS Word

Mettre des tables de données, par exemple d'une sous-table comme ci-dessous, est possible mais
seulement si vous utilisez Mailmerge comme service web complètement piloté depuis votre application. Votre application doit envoyer les données (un fichier xml) et aussi le document modèle

Affichage de la table

Votre fichier .docx utilise toujours des ChampsFusion comme décrit précédemment, mais pour les listes et tables, il faut utiliser les commandes TableStart: et TableEnd: . Votre document XML comprenant les données va remplir les variables, les listes et les tables.

Voici un exemple.

Exemple du résultat avec une table

Exemple d’un modèle incluant une table

Modèle incluant une table

1 Type de signal : «type_signal» Variable seule, classique. Le type de signal.

2 Signaux dans les communes ci-dessous : Un tableau (array) uni-dimensionnel qui affichera une liste à puces des communes.
«TableStart:Array-communes»
. «commune»
«TableEnd:Array-communes»

3 Communes et les valeurs: référez-vous à la table ci-dessous.

Ci-dessous, le PDF final en intégrant les données envoyées (format XML) à droite.

Table généré à partir du modèle

Les données envoyées au modèle: