La version 3.7 du générateur Word/Excel eaDocX vient d'être publiée avec une plusieurs évolutions, souvent issues de demandes d'utilisateurs.
Support des modèles "Master et Model documents" du générateur RTF de Sparx EA
Avant de basculer vers eaDocX pour générer les documents et livrables, il est possible que des modèles documentaires aient été définies avec le générateur RTF intégré à Sparx EA au travers de "master documents ou model documents".
eaDocX 3.7 permet d'utiliser les master et model document RTF EA pour générer des documents eaDocX. Les documents RTF EA existants peuvent ainsi être intégrés dans eaDocX afin de bénéficier de toutes ses fonctionnalités, par exemple l'intégration et le formattage Ms Word. Son fonctionnement consiste à ouvrir eaDocX sous EA, et rajouter un master/model document dans une section de document.
Comme pour tout autre contenu EA, eaDocX propose automatiquement de formater le contenu attendu. eaDocX analyse les éléments, paquetages, matrices, et diagrammes présents dans cette section, et présente une liste complète d'options de formattage Word. Pour plus d'informations, voir l'Aide eaDocX (en anglais).
Au contenu du document model ou master RTF, eaDocX permet de rajouter des sections de différents types :
- tableau ou graphique Excel généré à partir des données du projet EA
- rapports d'éléments
- rapports de références croisées
- diagrammes avec ou sans le contenu des objets affichés
- contenu liés à une vue du modèle (Model View EA)
- et bien d'autres encore...
Fonction Quick Document sur les Model Documents RTF EA
La fonction Quick Document d'eaDocX peut être exécutée via un clic droit sur un model document RTF de Sparx EA. Cette fonctionnalité a pour effet de créer un profile selon le contenu du modèle.
Documents internes : stockage des documents Word dans le projet EA
Les documents générés par eaDocX sont des fichiers Word intégrant un profil eaDocX, stockés sur votre disque dur.
Mais lorqu'un projet Enterprise Architect donne lieu à de nombreux documents impliquant plusieurs auteurs, savoir où se trouve chaque fichier généré peut rapidement être problématique. Dans ce contexte, certains utilisateurs ont déposé leurs documents sous SharePoint, et cela a encore plus complexifié la situation. Par exemple un "nettoyage" dans Sharepoint peut facilement supprimer les références vers les documents.
eaDocX propose donc une option permettant de stocker les documents Word dans le projet EA. Cette fonctionnalité est uniquement disponible avec EA 12 Build 1215 ou supérieur. En effet eaDocX utilise une nouvelle méthode de l'API Sparx (v12) permettant de compresser le contenu d'un document, puis de le stocker dans la base de données du projet EA.
Cette approche a pour effet d'augmenter de quelques Mo la taille du projet, sans impacter la performance dans EA. Cette évolution permet d'éviter la perte de documents.
Générateur HTML
Comme indiqué lors de la sortie d'eaDocX 3.5, eaDocX permet de générer un contenu HTML afin d'être consultable depuis un navigateur web. Ce générateur a été réalisé pour eaDocX Collaboration Edition, et mis à disposition en tant que fonction indépendante (cf. menu eaDocx | Save as HTML).
En comparaison avec l'export HTML de Sparx EA, le nombre de fichiers générés est grandement réduit :
- un seul fichier HTML pour le document,
- un fichier CSS, généré à partir des propriétés du document Word,
- et un fichier pour chaque diagramme.
Paramétrage des dimensions du diagramme
Générer des diagrammes dans un document ne produit parfois pas le résultat attendu :
- lorsque le diagramme est très grand, eaDocX présente le diagramme sur une page et la légende sur la page suivante,
- si le mode paysage est activé, la légende du diagramme se retrouve sur une page vierge.
eaDocX 3.7 propose alors de nouveaux paramètres dans le menu Document Settings | Diagram Settings :
- Hauteur maximum du diagramme en mode paysage (Maximum Diagram Height Landscape).
- Hauteur maximum du diagramme en mode portrait (Maximum Diagram Height Portrait).
Les valeurs de ces paramètres peuvent être modifiées afin d'obtenir le résultat attendu.
Filtres diagrammes
Les filtres sur les diagrammes ont été initialement ajoutés pour un client dont le document comportait de nombreux diagrammes. Ce client a exprimé le besoin de générer par exemple tous les diagrammes avec l'option 'Diagram+contents'.
Les filtres agissent comme un "Profile" permettant par exemple aux utilisateurs "d'appliquer l'option diagram+contents pour tous les diagrammes avec le stéréotype Doc", ou de "ne pas générer les diagrammes avec le stéréotype private". Cette fonctionnalité a pour objectif de simplifier la configuration de documents comportant de nombreux diagrammes.
Les "Diagram Filters" peuvent être définis dans les Settings eaDocX.
Dans la capture d'écran suivante, les diagrammes de type Use Case diagrams avec le stéréotype "Doc" sont associés au filtre suivant : générer le diagramme et son contenu.
Pour plus d'informations, voir l'aide eaDocX.
Affichage des notes de connecteurs dans le rapport de Matrice
Le rapport de matrice (Matrix Report) disponible dans le générateur Word eaDocX permet d'afficher dans les cellules du tableau des symboles, le nom du connecteur, ou son stéréotype. Des options de formatage conditionnel sont également disponibles.
eaDocX 3.7 permet de rajouter le champs "Notes" du connecteur dans chaque cellule. Cette évolution répond la demande d'un utilisateur qui utilise ce champ.