Principe

Parfois la combinaison de documents grâce au plan-type Book ne suffit pas. Par exemple, si vous souhaitez rajouter un message ou une image à un endroit particulier de votre document généré.

Pour ce type de cas, Modelio Document Publisher vous apporte la solution suivante :

  • Ajouter une note supplémentaire à l’élément de votre choix. Le type de cette note déterminera où elle sera insérée dans le document généré;

  • Complétez le contenu de la note avec le chemin du fichier;

  • Ajouter un stéréotype «ExternalDocument» à la note.

Insertion d’un document

Document Publisher utilise le format cible du document dans la gestion du type de fichier inséré. Par exemple, vous pouvez insérer un fichier ".txt" dans les documents aux formats HTML et OpenXML, mais les fichiers ".docx" ne peuvent être insérés que dans les documents au format OpenXML. Selon la configuration de votre système, il se peut que vous ayez à actualiser le contenu de votre document (F9 pour Word et habituellement F5 pour les navigateurs web) afin de voir les fichiers insérés.

L’image ci-dessous montre l’insertion d’une image dans la documentation générée pour un cas d’utilisation.

1
Insertion d’une image

Légende :

  1. Ajouter une note à votre élément de modèle

  2. Indiquez le chemin de votre document externe dans la note

  3. Ajoutez le stéréotype «ExternalDocument» à votre note via l’onglet "Elément".

  4. Définissez les propriétés pour ce document externe

Lors de la génération du document, l’image est alors insérée au même endroit que la note "description" courante :

Documentpublisher  documentpublisher advanced inserting external documents docpubFR 014
L’image insérée dans le document généré

Insertion d’un lien

Une note «ExternalDocument» peut également être générée en tant que lien plutôt qu’en tant qu’insertion directe.

Pour ce faire, il suffit de cocher la case "Est un lien" dans la vue "Elément", et puis de rajouter une étiquette si vous ne voulez pas que le lien hypertexte soit explicite, comme le montre la capture d’écran ci-dessous :

Documentpublisher  documentpublisher advanced inserting external documents docpubFR 013
Insertion en tant que lien

Lors de la génération du document, un lien hypertexte est inséré à la place de l’image, et son étiquette affichée.

Documentpublisher  documentpublisher advanced inserting external documents docpubFR 015
Le lien inséré dans le document généré