12.5.1.4.1 Syntaxe du modèle

*Documentation adaptée de https://docxtemplater.readthedocs.io/en/latest/tag_types.html#sections

Les balises sont entre des accolades. Par exemple, étant donné (en .docx):

Cette procedure est pour {Nom}

Et les données (en .json)

{
     "name": "Sales Process"
}

L’Extrant dans le .docx sera
Cette procédure concerne le processus de vente

Sections

Les sections commencent par une livre (#) et se terminent par une barre oblique (/). Par exemple, {#processus} commence une section “process” tandis que {/processus} la termine.

Selon le type de données, les sections se comporteront différemment.

Conditionnels

Les conditions commencent par une livre (#) et se terminent par une barre oblique (/). Les conditions peuvent être utilisées pour afficher le contenu en fonction du fait qu’un attribut soit vrai ou faux.

Compte tenu de cette syntaxe dans le modèle (.docx)

Ce role est {#responsable}Responsable{/responsable}{#Autorisé}Autorisé{/autorisé}

Et ces données (.json)

{
     "responsable": false
     "autorisé": true
     "nom": "Accounting Clerk"
}

Ce qui suit sera rendu

Ce rôle est Autorisé

En plus d’utiliser du texte libre, vous pouvez également utiliser des balises dans des instructions conditionnelles pour afficher dynamiquement des informations. Par exemple, donnez cette syntaxe:

@ Qui est responsable de cette tâche? {#Autorisé}nom{/autorisé}

Et les mêmes données données ci-dessus, ce qui suit sera rendu

Qui est responsable de cette tâche? Commis comptable

Si nous avions remplacé {#Autorisé}...{/autorisé} par {#responsable}...{/responsable} “Commis comptable” n’aurait pas été imprimé, car le responsable est faux.

Boucles

La syntaxe des boucles et des conditions est la même. Les boucles doivent être utilisées lorsque les données sont stockées dans des tableaux. Compte tenu de cette syntaxe (en .docx):

et les données suivantes (en .json)
{
      règles
           {“nom”: “Effectuez une vérification des antécédents”},
           {“nom”: “Signer le contrat le premier jour”},
           {“nom”: “Modifier les mots de passe des employés tous les 3 mois”}
      ]
}

Le rendue sera:

Effectuer des vérifications des antécédents
Signez le contrat le premier jour
Changer les mots de passe des employés tous les 3 mois

Sections inversées

Les sections inversées commencent par un signe d’insertion (^) et se terminent par une barre oblique (/). Une section inversée est essentiellement une instructio. Donnez cette syntaxe (en .docx)

{#objectif} objectif {/objectifl}
{^ objectif} Aucun objectif n’a été défini {/objectif}

et ces données (en .json)
{
      “objectif”: null
}

Le rendu sera:

Aucun objectif n'a été défini