Exemples et Conseils

Exemples

Les instructions d'utilisation de l'interface sont fournies sous forme d'exemples de code. Il existe plusieurs séries d'exemples :

• Des exemples VB 6 et C# sont disponibles dans le dossier Exemples de code sous votre installation Enterprise Architect
  (par défaut : C:\Program Files\ Sparx Systems \EA\Code Samples)
• Enterprise Architect peut être configuré pour appeler une application externe
• Plusieurs extraits de code VB.NET sont fournis dans la section de référence
• Un exemple complet d'utilisation de Visual Basic pour créer une documentation MS Word ^TM est disponible sur Internet à l' adresse sparxsystems.com/resources/developers/autint_vb.html
• Des échantillons supplémentaires sont disponibles sur le site Web Sparx Systems ; voir la rubrique Ressources disponibles

Conseils et astuces

note également ces trucs et astuces :

• Une instance du processus Enterprise Architect (EA.exe) est exécutée lorsque vous initialisez un nouvel object de référentiel - ce processus doit rester en cours d'exécution pour effectuer des tâches d'automatisation ; si la fenêtre principale est visible, vous pouvez la réduire en toute sécurité, mais elle doit rester en cours d'exécution
• L'interface ActiveX Enterprise Architect est une interface fonctionnelle plutôt qu'une interface de données ; lorsque vous chargez des données via l'interface, il y a un délai notable pendant lequel les éléments de l'interface utilisateur Enterprise Architect (tels que Windows et les menus) sont chargés et la connexion à la base de données spécifiée est établie
• Les collections utilisent un index de base zéro ; par exemple, Référentiel .Models(0) représente le premier modèle du référentiel
• Pendant le développement de votre logiciel client, votre programme peut se terminer de manière inattendue et laisser EA.exe s'exécuter dans un état tel qu'il ne peut plus support d'autres appels d'interface ; si votre programme se termine de manière anormale, assurez-vous qu'Enterprise Enterprise Architect ne reste pas exécuté en arrière-plan (voir l'onglet « Gestionnaire des tâches / Processus » Windows )
• Un handle vers une instance en cours d'exécution d' Enterprise Architect peut être obtenu via l'utilisation d'un appel GetObject() (voir la page de référence pour l' object App) ; l'accès à votre modèle Enterprise Architect via l' object App permet d'interroger l'état actuel Interface Utilisateur , par exemple en utilisant GetContextItem() sur l' object Référentiel pour détecter la sélection actuelle par l'utilisateur, permettant un prototypage et des tests rapides

Enterprise Architect ne ferme pas

Une fois tous les traitements effectués par un contrôleur d'automatisation terminés, il est recommandé d'appeler CloseFile () et Exit() sur l' object Référentiel , puis de définir toutes les références à l' object référentiel sur null.

référentiel. CloseFile ();

référentiel.Exit();

repository = null;

Si votre contrôleur d'automatisation a été écrit à l'aide du framework .NET , Enterprise Architect ne se ferme pas même après avoir libéré toutes vos références. Pour forcer la libération des pointeurs COM, appelez les fonctions de gestion de la mémoire :

GC.Collect();

GC.WaitForPendingFinalizers();

Des problèmes supplémentaires surviennent lors du contrôle d'une instance en cours d'exécution d' Enterprise Architect qui charge Add-Ins . Consultez la rubrique Astuces et pièges pour plus de détails.