Modélisation UML & SysML

Expertise et articles Blog sur UML, SysML, et Enterprise Architect de Sparx Systems

english versionTwitterUMLChannel SparxSystems EA YouTube videosLinkedIn
Générer vos documents Word, synchroniser vos données Excel depuis Enterprise Architect avec eaDocX

Générer vos documents Word, synchroniser vos données Excel depuis Enterprise Architect avec eaDocX

VISEO représente l'éditeur britannique eaDocX pour répondre aux besoins de génération de documentation dédiée à l’outil de modélisation Enterprise Architect de Sparx Systems, dont Viseo est également revendeur officiel en France.

Pourquoi eaDocX ?

Enterprise Architect intègre un générateur RTF de documents avec des fonctionnalités limitées et une utilisation pouvant être fastidieuse.

  • eaDocX permet de générer des documents au format Ms Word à partir du contenu des modèles définis dans EA, et d’un modèle de document (structure, mise en forme, choix du contenu dans chaque chapitre, etc.).
  • eaDocX permet de synchroniser des données avec des feuilles de calculs Excel, par exemple pour mettre à jour des exigences sous Excel puis les synchroniser dans EA. Ce module propose une alternative beaucoup plus complète que l’import / export CSV disponible dans Enterprise Architect.

La solution eaDocX

L’offre de services de VISEO inclut la vente de licences eaDocX, la prestation de conseils et de mise en œuvre de l'outil, ainsi que le cursus de formation défini par l’éditeur.

eaDocX™ est un Add’In pour Enterprise Architect permettant de réaliser la génération de documents sous Microsoft Word, et ainsi d’obtenir des livrables prêts à l’emploi et conformes aux contraintes documentaires de nombreux clients (template documentaire Word de l’entreprise, suivi des versions, etc.).

eadocx word documentation sparx enterprise architect ea

eaDocX s’interface également avec Microsoft Excel via son module eaXL afin de publier ou de synchroniser des éléments dans un tableur Excel.

  • Exporter vos exigences, classes métiers, ou tout autre type d’élément dans Excel pour simplifier leur mise à jour.
  • Importer de nouvelles données ou vos mises à jour à partir d’un fichier Excel. Vérifier au préalable l’impact sur vos modèles par l’exécution d’une comparaison entre EA et Excel.

Remarque : eaDocX permet également l’import et l’export d’attributs ou d’opérations de classes.

 eadocx excel import export synchronize sparx enterprise architect ea

 Simple d’utilisation

  • L’interface utilisateur permet d'utiliser Word ou Excel directement sous un projet EA.
  • Définition du formatage ou style d’affichage pour chaque élément EA ou chaque stéréotype.
  • Plus besoin d’un support RTF ou de scripts.

Qualité des documents

  • Définition de la structure et du contenu de vos modèles documentaires sur sélection de diagrammes, paquetages, éléments, associations entre éléments, et toute autre donnée du projet EA. Cette sélection est réalisée via la création de différents types de "sections".
  • Application de styles et formats Word.
  • Support de graphiques, d’hyperliens, de glossaire.
  • Gestion documentaire pour le suivi de versions.

Améliorez les livrables de votre projet, la partie visible de vos travaux

  • Création de rapports personnalisés afin d’identifier rapidement des informations manquantes ou des doublons (ex : description vide d’un acteur).
  • Utilisation des règles de mise en forme conditionnelle Word pour mettre en évidence des informations spécifiques (ou des écarts).
  • Ces fonctionnalités permettent de maintenir la satisfaction de votre client par rapport aux livrables attendus.

Une gestion efficace de vos documents

  • Mise à jour et synchronisation rapide des données EA avec Excel.
  • Utilisation de modèles différents et adaptés à chaque audience pour générer des livrables avec un contenu et format différents.
  • Mise à jour de la documentation en quelques clics.

Un outil adapté pour tout profil

... pour les analystes et AMOA

Des milliers d’analystes à travers le monde utilisent déjà Enterprise Architect pour organiser leurs projets. En effet Enterprise Architect permet d’appliquer les langages de modélisation standards comme UML ou SysML, ou tout autre notation visuelle (BPMN2) pour formaliser les différents aspects du métier et du système étudié.

En complétant ces fonctionnalités avec celles d’eaDocX, les analystes peuvent réduire les efforts nécessaires à la gestion et génération de documents Word, tout en améliorant la qualité des livrables. Le module Excel d’eaDocX permet de très facilement importer, publier ou maintenir des listes d’exigences, classes métiers, ou tout autre listes d’éléments de leur projet EA.

... pour les architectes

Définir la cartographie du SI (i.e. Enterprise Architecture en anglais) est une tâche d’envergure, aussi le choix d’un outil adapté à ce besoin est primordial. Sparx Enterprise Architect est l’un des outils les plus répandus pour formaliser et structurer dans un référentiel l’ensemble des connaissances, non seulement par des modèles UML, la notation ArchiMate, mais également à l’aide de framework d’architecture comme TOGAF, DoDAF/MODAF ou Zachman.

Après avoir capitalisé la connaissance de votre entreprise dans Enterprise Architect, il est essentiel de pouvoir publier les informations de ce projet aux architectes, concepteurs, chefs de projet, responsables MOA, etc. Le faible cout de licence Sparx EA permet à tous ceux qui en ont besoin d’installer EA pour consulter les modèles. Pour ceux qui n’utilisent pas EA, les documents sont nécessaires pour communiquer et diffuser l’information ; eaDocX permet de générer des documents Word de qualité avec un contenu riche et adapté.

... pour les consultants

Les consultants démarrant un nouveau projet font souvent face à de nombreux challenges, et ainsi doivent être en mesure :

  • de démontrer et clarifier le contexte du projet,
  • de commencer à montrer leur capacité à faire la différence par des propositions pour rectifier la situation avec une vision cible et des actions associées,
  • de mettre en évidence pour le client un service unique et à forte valeur ajoutée au projet et aux équipes.

eaDocX peut faire la différence par la génération d’une documentation complète et exhaustive sur tous les aspects du projet : exigences, cas d’utilisations et périmètre fonctionnel, architecture et conception, risques et problèmes, etc.

… pour les programmeurs/concepteurs

Le concepteur profite souvent de toute l’étendue des fonctionnalités d’Enterprise Architect, non seulement par le support de tous les types de diagrammes UML, mais également par les fonctions de retro-ingénierie sur le code ou une base de données, la génération de code, la transformation de modèles, etc.

Toute la conception peut etre capitalisée dans un référentiel avec la possibilité d’associer ses éléments avec les exigences, ce qui permet d’obtenir un niveau très élevé de traçabilité!

eaDocX permet d’exploiter pleinement l'ensemble de ce travail en générant une documentation adaptée et mettant en avant tous les bénéfices de la conception.

... pour les chefs de projet

Alors que les analystes, concepteurs, et architectes utilisent Enterprise Architect et eaDocX, les chefs de projet peuvent également bénéficier de cette suite d’outils pour suivre l’avancement des tâches et fonctionnalités, communiquer et partager une vision commune avec le client contrôler la qualité du travail réalisé.

 

eaDocX Collaboration Edition

Un nouveau module eaDocX est disponible depuis 2015 (eaDocX 3.6) : l'édition collaborative d'eaDocX.

  • eaDocX Collaboration Edition permet de consulter un document généré depuis Enterprise Architect via une interface web afin de faciliter la validation documentaire par les destinataires. Chacun peut alors consulter à tout moment le contenu d'un document depuis son PC, smartphone, ou tablette.
  • La relecture et les échanges entre l'auteur et les validateurs sont grandement facilités via une interface interactive ; chacun peut saisir des commentaires, répondre à des questions, vérifier des points de conformité, et voter. L'ensemble de ces informations sont stockées et accessibles dans le projet EA.
  • Les destinataires peuvent consulter les remarques des autres destinataires, offrant un gain de temps et permettant des échanges en direct (les retours n'ont plus à passer par l'auteur).
  • La consolidation des retours dans les modèles est simplifiée : l'auteur peut traiter chaque commentaire ou réponse en modifiant l'élément ou diagramme concerné directement sous EA.
  • Les commentaires sont conservés d'une version à une autre, permettant ainsi de conserver un historique sur les retours et décisions.
  • eaDocX Collaboration Edition est disponible via une nouvelle licence (cf. tarifs

eadocx collaboration edition sparx ea 

 

Cliquer ici pour consulter les fonctionnalités et tarifs eaDocX. 

 

eadocx 4

eaDocX 4.1 est disponible avec de nouvelles améliorations sur le générateur documentaire Word. Cette version intègre une refonte complète du module d'import/export Excel pour Sparx Enterprise Architect, eaXL :

  • Les fonctions Excel sont disponibles dans un menu dédié, eaXL.
  • Option pour enregistrer et gérer les fichiers Excel comme éléments dans le project browser afin de pouvoir les ouvrir depuis EA.
  • Gestion des tagged values d'attributs de classes.
  • Gestion des connecteurs entre éléments : mise à jour, création, suppression.
  • Ajouter les éléments ou connecteurs présents dans un diagramme.
  • Support d'onglets multiples avec la possibilité de les renommer.
  • Nouvelle interface utilisateur.

excel eadocx 4

eadocx model expert for sparx enterprise architect

Model Expert est un nouvel add-in pour Enterprise Architect réalisé par l'éditeur eaDocX ; son objectif est de faciliter la qualité et la cohérence de vos projets de modélisation Enterprise Architect via des fonctions d'analyse, de correction et d'optimisation du contenu.

 

lundi, 06 juin 2016 21:42

eaDocX : actualités Juin 2016

Plusieurs améliorations et nouveaux outils en cours de réalisation viennent d'être annoncés par l'équipe eaDocX.

  • eaDocX 3.9
  • eaDocX Collaboration
  • eaDocX 4
  • Model Expert

 

 

module generation documentaire word avec eadocx disponible dans la formation enterprise architect viseo

La formation Sparx Systems Enterprise Architect de VISEO propose depuis cette année le complément eaDocX en alternative au générateur documentaire embarqué dans Enterprise Architect. J'aurais le plaisir d'animer cette version pour la première fois le mois prochain.

Contenu du complément "Générer un document Word avec eaDocX" de la formation Sparx Systems Enterprise Architect :

  • Présentation et comparaison eaDocX avec le générateur Sparx EA
  • Accès aux fonctionnalités, création d'un nouveau modèle, présentation de l'environnement eaDocX
  • Fonctions eaDocX : preview, sections, profils, gestion des versions
  • Configuration et options eaDocX
  • Générer un document
  • Utilisation de scripts pour les besoins particuliers

Contactez moi sur guillaume[at]umlchannel.com pour plus d'informations ou si vous souhaitez organiser une session de formation.

eadocx 3.7

Contexte

La documentation et gestion de livrables est bien souvent un processus fastidieux, néanmoins nécessaire pour de nombreux projets et clients. Une documentation adaptée au contexte permet de garantir ou à minima contribuer à la compréhension, qualité et pérennisation d'une application logicielle testée, livrée et déployée.

La génération documentaire à partir des modèles maintenus dans un référentiel Enterprise Architect simplifie ce processus :

  • La mise à jour des informations est réalisée dans un référentiel de modèles, assurant une cohérence globale.
    • La modification d'éléments du modèle est automatiquement répercutée à travers les descriptions et diagrammes. Exemples : le nouveau nom d'une classe est automatiquement visible sur l'ensemble des diagrammes qui l'utilisent, la modification d'une méthode d'interface est visible sur les diagrammes de séquences UML, le nouveau titre d'une exigence est visible sur les cas d'utilisations qui la réalisent, etc. 
  • Le générateur eaDocX s'appuie sur un modèle documentaire qui comprend les sections dans lesquelles le contenu et les diagrammes doivent être mis à jour/générés. Cela évite de nombreux copier/coller de diagrammes UML, BPMN, SysML, ArchiMate ou autre dans un document Word externe.
  • Cette approche donne lieu à une gestion dynamique des livrables documentaires : elle remplace la mise à jour manuelle d'un document Word après un atelier ou une réunion où l'auteur essaie de répercuter au mieux les modifications demandées (nécessitant souvent la mise à jour de diagrammes Visio ou autres pour être ensuite copiés/collés dans Word). Avec Sparx EA et eaDocX, les modèles peuvent être mis à jour en direct avec les participants (sous EA ou Excel), ou après la séance. Le résultat obtenu dans le document généré correspond alors exactement à ce qui a été exprimé par l'équipe.

Problématique

Malgré les fonctionnalités fournies par les divers générateurs documentaires EA que j'ai eu l'occasion d'utiliser, la gestion de la mise en page des diagrammes a bien souvent été problématique. En effet les diagrammes générés dans le document doivent souvent être redimensionnés, entraînant ainsi de nombreuses actions manuelles, consommatrices de temps.

Une évolution présente dans la dernière version 3.7 d'eaDocX propose une solution à ce problème ; un nouveau paramétrage permet de définir un hauteur maximum pour les diagrammes en mode portrait ou paysage.

 

jeudi, 12 novembre 2015 00:00

eaDocX 3.7 disponible

eadocx 3.5La 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
  • Fonction quick document sur les Model Documents RTF EA
  • Documents internes : stockage des documents Word dans le projet EA
  • Générateur HTML des documents
  • Paramétrage des dimensions du diagramme
  • Filtres diagrammes
  • Affichage des notes de connecteurs dans le rapport de Matrice

eaDocX Collaboration EditionLa nouvelle version 3.6 d'eaDocX est disponible ; des évolutions et corrections sur le générateur Word et le module Excel (eaXL) ont été intégrées dans eaDocX 3.6.
Une nouvelle édition, eaDocX Collaboration Edition, a également fait son apparition. Ce nouveau module sera présenté au prochain EAUG à Paris le 17 Septembre (plus d'informations sur l'EAUG sont disponibles ici).

 eadocx collaboration edition sparx ea

lundi, 20 juillet 2015 00:00

Article publié dans Programmez!

Mon article sur l'utilisation d'une approche par les modèles (model-driven) pour répondre à un appel d'offre (ex : RFP, RFI...) a été publié dans l'édition de Juillet/Août du magazine Programmez! (no 187).

article eadocx Excel programmez

Le contenu de cet article est également disponible ici.

eadocx article eaxl import en masse d'exigences

Le module eaXL d'eaDocX permet de synchroniser des informations stockées au format Excel avec un projet de modélisation Sparx Enterprise Architect, par exemple pour importer et exporter des exigences, des classes (avec leurs attributs ou opérations), des cas d'utilisations, etc..

Cet article présente un retour d'expérience (REX) sur l'utilisation d'eaXL dans le cadre d'une réponse à appel d'offre, où les nombreuses exigences du client ont été importées dans un projet Enterprise Architect afin de faciliter l'analyse des besoins et l'élaboration d'une réponse via une approche par les modèles. Les étapes permettant d'importer en masse les exigences du client sont détaillées dans cet article.

Remarque : le module Excel est disponible dans l'édition Corporate d'eaDocX, dont les fonctionnalités et tarifs publics sont accessibles ici.

 

mercredi, 29 octobre 2014 00:00

eaDocX 3.5 disponible

eadocx 3.5

La version finale d’eaDocX 3.5 est désormais disponible (version actuelle : 3.5.1.1). Cette nouvelle version embarque un générateur HTML ainsi qu'un certain nombre d'améliorations et re-factorisations en vue de futures fonctionnalités.

SparxSystems Enterprise Architect permet de générer au format HTML les diagrammes et éléments du modèle, néanmoins le générateur HTML d'eaDocX a été conçu pour améliorer le contenu et les fichiers générés (Enterprise Architect génère de nombreux répertoires et fichiers HTML).

eaDocX 3.5 intègre également :

  • Le "Document Management" peut être temporairement désactivé (cette fonctionnalité permet de tracer les changements effectués par chaque auteur entre différentes versions)
  • Des filtres peuvent être définis sur les diagrammes, pour exclure par exemple des types de diagrammes
  • Une correction dans eaXL sur l'enregistrement de caractères Unicode, le support de dates.
  • Le champ "notes" peut désormais être édité au format HTML sous Excel via le module eaXL.
  • Un support eaDocX/eaXL "limité" de PostgreSQL (l'utilisation de ce serveur de base de données fonctionne suite aux corrections apportées, néanmoins il peut subsister des anomalies qui n'ont pas été identifiées)

 

dimanche, 14 septembre 2014 08:52

eaDocX 3.5 disponible en version Bêta

eaDocX 3.5


L’éditeur eaDocX a annoncé la disponibilité en version bêta d’eaDocX 3.5, embarquant un générateur HTML ainsi qu'un certain nombre d'améliorations et re-factorisations en vue de futures fonctionnalités.

SparxSystems Enterprise Architect permet de générer au format HTML les diagrammes et éléments du modèle, néanmoins le générateur HTML d'eaDocX a été conçu pour améliorer le contenu et les fichiers générés (Enterprise Architect génère de nombreux répertoires et fichiers HTML).

eaDocX 3.5 intègre également :

  • Le "Document Management" peut être temporairement désactivé (cette fonctionnalité permet de tracer les changements effectués par chaque auteur entre différentes versions)
  • Des filtres peuvent être définis sur les diagrammes, pour exclure par exemple des types de diagrammes
  • Une correction dans eaXL sur l'enregistrement de caractères Unicode.
  • Un support eaDocX/eaXL "limité" de PostgreSQL (l'utilisation de ce serveur de base de données fonctionne suite aux corrections apportées, néanmoins il peut subsister des anomalies qui n'ont pas été identifiées)

 

mercredi, 21 mai 2014 14:20

eaDocX 3.4 disponible

eaDocX 3.4

La nouvelle version eaDocX 3.4 est disponible.

Principales évolutions :

  • Créer des documents Word avec les "Model Views" d'Enterprise Architect. L'utilisation du Model View facilite la gestion du contenu lorsque le document porte sur différents paquetages, éléments et diagrammes éparpillés dans votre modèle. En effet cette fonctionnalité évite de créer une section eaDocX pour chaque partie du modèle à inclure (Editions Professional et Corporate).
  • Scripts de génération pour eaDocX : vous pouvez écrire vos propres scripts EA personnalisés pour générer des documents très compliqués, impliquant des exigences de génération particulières (Edition Corporate uniquement).
  • Exécution de scripts "post-processing" pour eaXL : vous pouvez définir le lancement de scripts EA personnalisés après avoir importé des données dans Enterprise Architect à l'aide d'eaXL. Vous pouvez par exemple créer des associations, lancer des recherches, et bien plus via des scripts EA (Edition Corporate uniquement).
  • Impression du Gap Matrix TOGAF : les utilisateurs d'EA 11 peuvent imprimer le Gap Matrix tel qu'il apparaît dans EA, et avec des hyperliens vers les éléments de gap  (Editions Professional et Corporate + Sparx EA v11).
  • Gestion des Instance Classifier (Editions Professional et Corporate).
  • Support des Charts d'Enterprise Architect 11 (Editions Professional et Corporate).

 

mercredi, 05 mars 2014 12:40

eaDocX 3.4 disponible en version Bêta

eadocx 3.4 beta

L’éditeur eaDocX a annoncé la disponibilité en version bêta d’eaDocX 3.4, corrigeant plusieurs bugs et anomalies, et intégrant de nouvelles fonctionnalités pour améliorer la génération de documents MS Word. La partie MS Excel (module eaXL) de l’outil est impactée avec le support de scripts.

Les évolutions incluent le support de scripts Enterprise Architect "mini-générateurs eaDocX", l'utilisation du Model View d'Enterprise Architect pour faciliter la gestion du contenu de vos documents, et la possibilité d'exploiter les "Instance Classifiers" de votre modèle.

eaDocX est principalement un outil pour générer de la documentation au format Word depuis vos modèles Enterprise Architect, mais cet outil comporte également un module de synchronisation avec Ms Excel ; eaXL. Ce module d'eaDocX permet d'ouvrir Excel directement sous Enterprise Architect (note : eaDocX est un plug-in commercial d'Enterprise Architect réalisé par la société britannique eaDocX, dont Objet Direct est revendeur).

Cet article présente par un exemple simple une utilisation d'eaDocX pour gérer un référentiel d'exigences dans un cas nominal, permettant de dépasser les limites d'un fichier CSV exporté avec Enterprise Architect en exploitant pleinement Ms Excel.

eadocx

comparaison excel eadocx

jeudi, 10 octobre 2013 00:00

Tarifs publics et fonctionnalités eaDocX

eadocx generateur word excel

Les tarifs publics pour les licences fixes et flottantes des éditions Corporate, Professional, et Collaboration d'eaDocX sont disponibles dans cet article (dernière mise à jour effectuée le 19 Juin 2015).

Cliquez ici pour découvrir les tarifs et fonctionnalités des licences et éditions eaDocX.