Exemples d'Interface d'Automatisation: Details de Code


Contenu

  • Introduction
  • Description de code
  • Installation de MS VB pour utiliser Interface d'Automatisation d'Enterprise Architect
  • Concepts de Base
  • Notes

Exigences

  • EA est installé sur la machine
  • Microsoft Word 2000 ou est installé plus tard sur la machine
  • Visual Basic 6.0 est installé sur la machine si vous voulez développer l'application

Introduction
Les détails de code fournissent des informations supplémentaires à la documentation sur l'utilisation de l'Interface d'Automatisation. L'intention est de fournir un exemple en utilisation de Visual Basic pour effectuer des appels à l'Interface d'Automatisation pour récupérer des données d'un dépôt Enterprise Architect.On considère ce code comme une un démarreur pour des utilisateurs de configurer leurs propres dispositions de documentation.

Il est assumé il y aurait une connaissance raisonnable de Visual Basic si des modifications doivent être faites à l'exemple suivant. Les directives sur l'Utilisation de l'Interface d'Automatisation ont été fournies avec Enterprise Architect. (voir Références ).

Description du Code
Le code pour AutInt est un Visual Basic 6.0 .dll écrits à l'interfacer avec Enterprise Architect. En dehors de la principale forme et la classe, tous les autres codes est capable d'être transporté à tout environnement VBA comme MS-Word, etc.

L'application AutInt.dll est chargé lorsque Enterprise Architect commence. Il est référencé dans le registre sous deux paramètres
a) Le DLL entrée
b) L'Enterprise Architect entrée Add-In qui fait référence à l'entrée de DLL. (pour plus information SVP voir Appel d'Applications d'EA).

Concept de Base
Le concept de base derrière le code est qu'il fonctionne dans la hiérarchie d'un référentiel d'Enterprise Architect au niveau du modèle et appelle fonctions de Word pour ajouter les données dans le document. Les principaux points de départ pour la course à travers le référentiel Enterprise Architect sont les routines DumpModel et DumpPackage.

La routine DumpModel passe en courant dans l'ensemble d'arbres de projet (des paquetages) appelant la fonction récursive DumpPackage. Chaque diagramme et l'ensemble d'Éléments/Paquetages sont traités sous ceci.

On passe en appelant le code d'EA et un PacquetageID à travers, la routine DumpPackage est appelée directement et passé le PacquetageID.

Le Cycle d'Appel est comme suit :

 

OpenEA

       CreateDoc

       DumpModel

              DumpPackage

                     DumpDiagrams

                     DumpElement

                            DumpConnections

                            DumpAttributes

                            DumpMethods

.....

       Contents

       Définir Introduction

'Ferme les fichiers ouverts

' Ouvre l'application Word et l'application EA et appelle la suivante ..

' Crée le document

' Analyse le Modèle

' Analyse les Paquetages

' Analys les Diagrammes dans le paquetage

' Analys les Elements dans le paquetage

' Crée une table de connexions

' Crée une table des attributs

' Crée une table des méthodes

 

' Fait Word créer le Contenu

' Configure l'Introduction pré le Contenu

Installation de MS VB pour utiliser l'interface d'Automatisation d'Enterprise Architect
Pour mettre en place le projet Viusaul Basic 6 pour générer la DLL - créer le nouveau projet dans Visual Basic comme un «ActiveX DLL". Voir dans le fichier d'aide EA sous 'automatisation et de script' - "Création addins" pour une description complète de fonder la structure de classe.. Une fois le Dll initial a été créé voir Calling EA Addin pour une decription de régler la référence de registre à la DLL.


Modules
La chose suivante est une description brève du contenu de chacun des modules dans AutInt. Ce code est Téléchargeable

Module Description
frmWordReport a principale forme utilisée pour la sélection d'options et de définir les emplacements des fichiers, etc.
Repository.bas Main code pour générer le document standard Enterprise Architect dans Word.
DetailDocs.bas Les courses de détail de Test et Maintenance (Semblable à Repository.bas)
Document.bas Un ensemble de routines pour manipuler le VB-Word.
UseCase.bas Le code pour produire le Document de Cas d'Utilisation.
EaAddin.cls Les classe d'Enterprise Architect Add-Ins

Une description brève de certaines des Variables Publiques définies dans l'application:

Variable Description
WordApp L'Application Word
EADoc Le Document Word
EaRepos Le cas du courant Enterprise Architect dépôt


Quelques Notes de Word

1) Orthographe et Vérification de Grammaire
Avec le code de CreateDocument, l'orthographe et la vérification dans Word grammaire ont été mis hors d'améliorer l'efficacité.  Si orthographe ou la grammaire vérification est nécessaire, il est préférable de les faire fonctionner comme un événement secondaire pour assurer l'utilisation du processeur est dans des limites raisonnables. Le temps de traitement est proportionnellement plus grande pour Word.

2)  Headers
Une erreur est survenue lors de l'insertion de nombreux "tête 1" têtes. L'insertion de ces provoque régulièrement des problèmes, voir Ref.: 293087 Word 97 rapport de bogue. Une solution est de sauver et mettre à jour régulièrement le fichier pour résoudre le problème SVP Voir: https://support.microsoft.com/default.aspx?scid=kb%3Ben-us%3B293087

Retour à la page Introduction à l'Interface d'Automatisation