Interface d'Automatisation:
Code Details

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 version ultérieure est installé 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. (voyez 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) The 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.

 

The Call Cycle is as follows:

OpenEA

CreateDoc

DumpModel

DumpPackage

DumpDiagrams

DumpElements

DumpConnections

DumpAttributes

DumpMethods

.....

Contenu

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

To set up the Viusaul Basic 6 project to generate the DLL - create the new project in VB as an 'ActiveX DLL'. See in EA's help file under 'Automation and scripting' - 'Creating addins' for a full description of setting up the class structure. Once the initial Dll has been created see Calling EA Addin for a decription of setting the registry reference to the 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 Code principale 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 Le Word Application
EADoc Le word Document
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)  Têtes
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 Voyez: http://support.microsoft.com/default.aspx?scid=kb%3Ben-us%3B293087

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