Docx-template - Historique des versions

Léo le 6 octobre 2022 à 07:44

2022-10-06T07:44:22Z

Damien : /* Injecter du contenu dynamique dans un modèle */

2022-04-08T14:51:08Z

Injecter du contenu dynamique dans un modèle

Damien : améliorer la partie injection

2022-04-08T14:48:52Z

améliorer la partie injection

Léo le 31 août 2020 à 09:57

2020-08-31T09:57:39Z

Léo le 27 août 2020 à 13:42

2020-08-27T13:42:16Z

Léo le 27 août 2020 à 13:35

2020-08-27T13:35:59Z

Léo le 27 août 2020 à 13:35

2020-08-27T13:35:10Z

Léo le 27 août 2020 à 13:30

2020-08-27T13:30:26Z

Léo le 27 août 2020 à 13:22

2020-08-27T13:22:42Z

Léo le 27 août 2020 à 13:20

2020-08-27T13:20:06Z

@@ Ligne 30 : / Ligne 30 : @@
 :: Cette méthode d'injection est simpliste, la valeur de la variable sera injectée telle quelle, puisqu'on est dans le docx, il n'est pas possible d'appliquer des traitements à ce niveau.
-:: — l'injection de l'ensemble du contenu dynamique du [[SmartDoc]]) : <code>${ inject all }</code>.
+:: — l'injection de l'ensemble du contenu dynamique du [[SmartDoc]]) : <code>${ @inject all }</code>.
 :: Le contenu dynamique injecté prendra en compte les niveaux de titres, leur numérotation, et les styles configurés dans le . (voir [[Docx-template#Les styles dans le modèle docx| la rubrique sur les Styles]] ci-dessous).
-:: — l'injection d'un [[SmartDoc/Blocs|bloc]] spécifique du [[SmartDoc]]) : <code>${ inject id-du-bloc }</code>.
+:: — l'injection d'un [[SmartDoc/Blocs|bloc]] spécifique du [[SmartDoc]]) : <code>${ @inject id-du-bloc }</code>.
-:: Si le bloc ciblé doit provenir d'une autre document que celui qui est en train d'être généré, alors il faudra préciser l'identifiant de cet autre document avec la syntaxe suivante : <code>${ inject id-du-doc:id-du-bloc }</code>.
+:: Si le bloc ciblé doit provenir d'une autre document que celui qui est en train d'être généré, alors il faudra préciser l'identifiant de cet autre document avec la syntaxe suivante : <code>${ inject @id-du-doc:id-du-bloc }</code>.
 :: — l'injection d'une métadonnée du [[SmartDoc]], telle que son titre : <code>${ @doctitle }</code>. Le titre d'un document est celui qui est configuré dans la [[DocList]].

@@ Ligne 41 : / Ligne 41 : @@
 === Les styles dans le modèle docx ===
-Pour bien personnaliser les styles du modèles, il est important de bien maîtriser son logiciel de traitement de texte et de sauvegarder le modèle au format <code>.docx</code>.
+Pour bien personnaliser les styles des modèles, il est important de bien maîtriser son logiciel de traitement de texte et de toujours bien sauvegarder le modèle au format <code>.docx</code>.
-Le style par défaut appliqué au paragraphe est nommé "Normal". En modifiant la couleur, la taille ou tout autre propriété, de ce Style dans le fichier de modèle, alors le contenu injecté utilisera automatiquement ce style.
+Le style par défaut appliqué aux paragraphes injectés est généralement nommé "Normal" chez Microsoft Word ou LibreOffice. En modifiant la couleur, la taille (ou tout autre propriété) de ce Style dans le fichier de modèle, alors le contenu injecté utilisera automatiquement la mise en forme choisie dans le document généré.
 Les styles qui seront appliqués sur les titres du document sont des styles de titre proposés par défaut dans la norme ''.docx''.
 Sous Microsoft Word, ils sont nommés "Titre 1", "Titre 2" etc. , mais dans la version Anglaise du logiciel, ils seront nommés "Header 1", "Header 2" …

@@ Ligne 17 : / Ligne 17 : @@
 <p> Le [[SmartDoc]] doit aussi prévoir, dans ses options, qu'il va bénéficier d'une docx-template.<p>
 [[Fichier:Capture d’écran 2020-07-30 à 00.04.31.png|1200px|thumb|néant|Le SmartDoc contrat de travail prévoyant une ligne spécifique dans sa colonne Options pour pouvoir bénéficier d'un docx-template]]
-<h2 id="inject">Principe des injects dans un docx-template</h2>
-<p>'''Intérêt de l'Inject'''</p>
+== Injecter du contenu dynamique dans un modèle ==
-<p>''C'est grâce à l'instruction <code>inject</code>, qui doit directement être placée dans le docx-template, qu'il est possible d'injecter tout ou partie du contenu d'un [[SmartDoc]] dans un docx-template.''</p>
-<h3 id="injectall">Inject de la totalité d'un SmartDoc dans un docx-template</h3>
+Le modèle étant au format docx, son contenu est statique.
-<p>Il suffit d'écrire <code>{ @inject all }</code> dans le docx-template.</p>
+Lors de la génération d'un Document, si un modèle docx est précisé, alors le contenu dynamique va pouvoir y être intégré.
-<p>Dans ce cas, le système injecte dans le docx-template la totalité du SmartDoc.</p>
-<p>Le <code>{ @inject all }</code> est donc utile dans les cas où celui qui paramètre souhaite simplement personnaliser les styles, l'aspect du document, établir une page de garde stylisée, etc ...</p>
+=== La syntaxe de l'injection dynamique dans un modèle ===
-<h3 id="injectsimple">Inject d'une partie d'un SmartDoc dans un docx-template</h4>
-<p>Il est aussi possible d'injecter juste certaines parties du SmartDoc dans le docx-template, dans l'ordre souhaité.</p>
+Les instructions sont toujours sous la forme <code>${ … }</code>. Elles sont de 4 types :
-<p>Pour définir une partie de [[SmartDoc]] à injecter, celle-ci doit être délimitée par un [[SmartDoc/Blocs|Bloc]].</p>
-<p>Il suffit ensuite de prévoir une ligne de ce type dans le docx-template : <code> { @inject NOM_DU_BLOC } </code>.</p>
+:: — une simple injection de variable (variable du Datastore ou même [[Dynvars|variable Dynamique]]). Ex : <code>${ PRENOM }</code>.

@@ Ligne 6 : / Ligne 6 : @@
 <p>Si aucun docx-template n'est spécifié dans le paramétrage du SmartDoc, le système crée automatiquement un docx-template dans lequel il injecte la totalité du SmartDoc.</p>
 [[Fichier:Capture d’écran 2020-07-29 à 23.16.58.png|700px|thumb|néant|Fonctionnement schématisé d'injection entre un SmartDoc et son Docx-template]]
-<h3 id="debut">Avantage de la fonctionnalité</h3>
+<h3 id="debut">Intérêt et avantages</h3>
 <p>L'avantage principal lié au fait de préciser un Docx-template dans le paramétrage est de pouvoir personnaliser totalement le fichier Docx qui fera office de docx-template : styles des titres, interlignes, pied de page, en-tête, filigrane, page de garde stylisé, etc ...</p>
 <p>Le second avantage, de manière générale, est de pouvoir profiter de toutes les fonctionnalités les plus avancées de Word : tableaux, retraits, etc ...</p>

@@ Ligne 19 : / Ligne 19 : @@
 <h2 id="inject">Principe des injects dans un docx-template</h2>
 <p>'''Intérêt de l'Inject'''</p>
-<p>''C'est grâce à l'instruction <code>inject</code>, qui doit directement être placée dans le docx-template, qu'il est possible d'injecter tout ou partie du contenu d'un [[SmartDoc]].''</p>
+<p>''C'est grâce à l'instruction <code>inject</code>, qui doit directement être placée dans le docx-template, qu'il est possible d'injecter tout ou partie du contenu d'un [[SmartDoc]] dans un docx-template.''</p>
 <h3 id="injectall">Inject de la totalité d'un SmartDoc dans un docx-template</h3>
 <p>Il suffit d'écrire <code>{ @inject all }</code> dans le docx-template.</p>

@@ Ligne 21 : / Ligne 21 : @@
 ''A venir''
 <h3 id="injectall">Inject de la totalité d'un SmartDoc dans un docx-template</h3>
-<p>Il suffit d'écrire <code>{ @inject all }</code> dans le docx-template</p>
+<p>Il suffit d'écrire <code>{ @inject all }</code> dans le docx-template.</p>
 <h3 id="injectsimple">Inject d'une partie d'un SmartDoc dans un docx-template</h4>
-<p>Il est possible d'injecter juste certaines parties du SmartDoc, dans l'ordre souhaité</p>
+<p>Il est aussi possible d'injecter juste certaines parties du SmartDoc dans le docx-template, dans l'ordre souhaité</p>
 <p>Pour définir une partie de [[SmartDoc]] à injecter, celle-ci doit être délimitée par un [[SmartDoc/Blocs|Bloc]]</p>
-<p>Il suffit de prévoir une ligne de ce type dans le docx-template : <code> { @inject NOM_DU_BLOC }</p>
+<p>Il suffit ensuite de prévoir une ligne de ce type dans le docx-template : <code> { @inject NOM_DU_BLOC }</p>