Exemples et Conseils

Exemples

Les instructions d'utilisation de l'interface sont fournies dans un exemple 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 de 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 afin d'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 ouverte
• 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 car les éléments de l'interface utilisateur d' Enterprise Architect (tels que les 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
• Au cours du 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 est incapable de prendre en support d'autres appels d'interface ; si votre programme se termine anormalement, assurez-vous Enterprise Architect n'est pas laissé en arrière-plan (voir l'onglet Windows 'Task Manager / Process')
• 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 le statut actuel de l' Interface Utilisateur , comme l'utilisation de 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 se ferme pas

Une fois que tous les traitements par un contrôleur d'automatisation sont 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 de référentiel sur null.

dépôt. CloseFile ();

repository.Exit();

repository = null;

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

GC.Collect();

GC.WaitForPendingFinalizers();

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