Manipulation des modèles, des collections et des objets (Scripting)

Vous pouvez manipuler le contenu d'un modèle en le créant et en l'ouvrant, puis en descendant depuis la racine du modèle dans les collections d'objets. Des propriétés, constantes et fonctions globales sont disponibles dans n'importe quel contexte afin de servir de point d'entrée pour vos scripts.

Les propriétés globales suivantes permettent d'accéder à l'espace de travail et aux modèles qu'il contient :

ActiveWorkspace - Récupère l'espace de travail courant.
ActiveModel, ActivePackage et ActiveDiagram - Récupère le modèle, le package ou le diagramme correspondant à la vue active.
ActiveSelection - Collection en lecture seule des objets sélectionnés dans le diagramme actif.
Models - Collection en lecture seule des modèles ouverts dans l'espace de travail courant.
RepositoryConnection - Récupère la connexion au référentiel courante (voir Manipulation du référentiel (Scripting)).

Les fonctions globales suivantes sont couramment utilisées pour créer ou ouvrir des modèles et effectuer des actions sur ces derniers :

CreateModel() et OpenModel() - Créent et ouvrent un modèle (voir Création et ouverture de modèles (Scripting)).
Output() - Imprime du texte dans l'onglet Script de la fenêtre Résultats de PowerAMC.
IsKindOf() - Teste la métaclasse de l'objet.
ExecuteCommand() - Lance une application externe.
EvaluateNamedPath() et MapToNamedPath() - Gèrent les chemins nommés dans les fichiers de modèle.
BeginTransaction(), CancelTransaction() et EndTransaction() - Démarrent, annulent et valident des transactions.

Les constantes globales suivantes fournissent des informations sur l'instance de PowerAMC :

UserName - Récupère le nom de connexion de l'utilisateur.
Version - Récupère la version de PowerAMC.
HomeDirectory - Récupère le répertoire racine de l'application.
RegistryHome - Récupère le chemin de la racine de l'application dans le registre.
Viewer - Renvoie True si l'application est une version Visionneuse dotée de fonctionnalités limitées.
ValidationMode - Par défaut, PowerAMC effectue différentes vérifications pour valider vos actions et émet une erreur en cas d'action interdite. Vous pouvez définir ValidationMode = False (qui débranche les règles de validation telles que celles portant sur l'unicité du nom ou celles s'assurant que les liens ont leurs extrémités définies) pour améliorer les performances ou si votre algorithme requiert temporairement un état invalide.
InteractiveMode - Spécifie le niveau d'interaction requis. Vous pouvez choisir l'une des valeurs suivantes :
- im_Batch [défaut] - Supprime l'affichage des boîte de dialogue et utilise systématiquement les valeurs par défaut. Par exemple, si votre modèle contient des raccourcis externes et que le modèle cible pour les raccourcis est fermé, ce mode va automatiquement ouvrir le modèle sans interaction de l'utilisation.
- im_Dialog - Affiche des boîtes de dialogue d'information et de confirmation qui requièrent une action de l'utilisateur pour poursuivre l'exécution du script.
- im_Abort - Supprime les boîtes de dialogue et abandonne l'exécution si une boîte de dialogue est rencontrée.
ShowMode [spécifique-OLE] - Vérifie ou modifie la visibilité de la fenêtre principale de l'application. Renvoie True si la fenêtre principale de l'application est visible et n'est pas réduite.
Locked [spécifique-OLE] - Lorsque définie à True, s'assure que l'application continue à être exécutée après déconnexion du client OLE.

Pour obtenir des informations détaillées sur toutes les propriétés, fonctions et constantes globales, sélectionnez Aide > Aide sur les objets du métamodèle puis sélectionnez Basic Elements.

Création et ouverture de modèles (Scripting)
Vous créez des modèles et ouvrez des modèles existants en utilisant les fonctions globales CreateModel() et OpenModel(). Le modèle actif est accessible via les propriété globale ActiveModelet ceux ouverts dans l'espace de travail sont disponibles via la collection globale Models.
Consultation et modification des collections (Scripting)
La plupart de la navigation dans le métamodèle est effectuée en descendant depuis la racine du modèle via les collections d'objets vers les collections de sous-objets ou les objets associés. Un MOO contient une collection de classes et les classes contiennent des collections d'attributs et d'opérations. Vous pouvez obtenir des informations sur les membres d'une collection et naviguer sur eux par le biais de script, mais aussi ajouter, retirer et déplacer des objets dans la collection.
Accès et modification des objets et propriétés (Scripting)
Vous pouvez utiliser le script pour accéder à n'importe quel objet ou propriété d'objet et les modifier. Les objets n'incluent pas uniquement des objets de modélisation courants (tels que les tables, les classes, les processus et les colonnes), mais également les diagrammes et symboles, ainsi que les objets fonctionnels (tels qu'un rapport ou référentiel). Un objet appartient à une métaclasse du métamodèle de PowerAMC et hérite des propriétés, collections et méthode de cette métaclasse.
Création d'objets (Scripting)
Il est recommandé de créer un objet directement à partir de la collection sous l'objet parent en utilisant la méthode CreateNew(). La méthode CreateObject(type) est également disponible sur les objets de modèle.
Affichage, mise en forme et positionnement des symboles (Scripting)
Lorsque vous créez un objet, celui-ci ne s'affiche pas dans un diagramme, sauf si vous utilisez la méthode AttachObject() ou AttachLinkObject(). Les symboles sont des objets de plein droit qui ne sont accessibles que via des collections sur l'objet ou diagramme parent. Vous pouvez positionner un symbole en utilisant la méthode Position() et changer son format en utilisant LineWidth et d'autres attributs de format.
Suppression d'objets (Scripting)
Vous pouvez supprimer des objets en utilisant la méthode Delete.
Création d'une sélection d'objets (Scripting)
Vous pouvez créer une sélection d'objets en utilisant la méthode CreateSelection(). Vous pouvez effectuer des actions sur la sélection, comme par exemple changer leurs propriétés ou leur format, ou les déplacer dans un autre package.
Contrôle de l'espace de travail (Scripting)
Vous pouvez accéder à l'espace de travail courant en utilisant la propriété globale ActiveWorkspace, ouvrir, enregistrer et fermer des espaces de travail, et y ajouter des dossiers et documents.

Sujet parent : Pilotage de PowerAMC à l'aide de scripts