Propriétés globales

Chapter 2 Accès aux objets à l'aide de scripts

Propriétés globales

Les propriétés globales suivantes sont disponibles :

Type	Propriétés globales	Utilisation
Accesseur global	ActiveModel As BaseObject ActivePackage As BaseObject ActiveDiagram As BaseObject	Récupère le modèle, le package ou le diagramme correspondant à la vue active.
	ActiveSelection As ObjectSet	Collection en lecture seule qui permet de récupérer la liste des objets sélectionnés dans le diagramme actif .
	ActiveWorkspace As BaseObject	Récupère le workspace (objet Workspace) de l'application
	MetaModel As BaseObject	Récupère le métamodèle (objet MetaModel) de l'application.
	Models As ObjectSet	Collection en lecture seule qui permet de lister les modèles ouverts.
	RepositoryConnection As BaseObject	Récupère la connexion courante du référentiel qui est l'objet qui gère la connexion au serveur du référentiel, puis fournit un accès aux documents et objets stockés sous le référentiel.
Mode d'exécution	ValidationMode As Boolean	Active ou désactive le mode de validation (True/False).
	InteractiveMode As long	Gère l'intervention de l'utilisateur en affichant ou non des boîtes de dialogue à l'aide des constantes suivantes : im_+Batch, +Dialog ou +Abort
Application	UserName As String	Récupère le nom de connexion de l'utilisateur.
	Viewer As Boolean	Renvoie True si l'application en cours d'exécution est une version Visionneuse dotée de fonctionnalités limitées.
	Version As String	Envoie la version de PowerAMC.
Spécifique à OLE	ShowMode As	Vérifie ou modifie le statut de visibilité de la fenêtre d'application principale de la façon suivant : La valeur renvoyée est True si la fenêtre principale de l'application est visible et non réduite La valeur renvoyée est False dans le cas contraire
	Locked As Boolean	Peut être défini à True pour assurer que l'application continue à s'exécuter après qu'un client OLE se soit déconnecté, dans le cas contraire l'application se ferme.

Exemple :

'Create a new table in a model
'Get the active model in MyModel variable
Set MyModel = ActiveModel

Vous pouvez utiliser deux types de mode d'exécution lorsque vous lancez un script dans l'éditeur. Vous pouvez spécifier une valeur par défaut pour chacun des modes :

Validation mode (mode de validation)
Interactive mode (mode interactif)

Mode de validation

Le mode de validation est activé par défaut (sa valeur est égale à True), mais vous pouvez choisir de désactiver temporairement ce mode en fixant sa valeur à False.

Etat	Constante	Code	Utilisation
Activé (valeur par défaut)	True	ValidationMode = True	Chaque fois que vous manipulez un objet de PowerAMC, toutes les méthodes internes de PowerAMC sont invoquées pour vérifier la validité de vos actions. Dans le cas d'une action non permise, une erreur survient. Ce mode est très utile pour déboguer mais limite nécessairement les performances du système.
Désactivé	False	ValidationMode = False	Vous l'utilisez lorsque vous souhaitez optimiser les performances de votre système ou parce que votre algorithme requiert un état temporairement invalide. Notez toutefois que dans ce cas les règles de validation telles que l'unicité du nom ou la nécessité pour un lien d'avoir des extrémités ne sont pas appliquées dans le modèle.

Exemple :

ValidationMode = true

Mode interactif

La constante Batch est la valeur par défaut dans le mode interactif.

Ce mode prend en charge les constantes suivantes :

Constant	Code	Description
im_Batch	InteractiveMode = im_Batch	N'affiche jamais les boîtes de dialogue et utilise toujours les valeurs par défaut. Cette constante s'utilise pour des scripts d'automatisation qui ne requièrent aucune action de l'utilisateur.
im_Dialog	InteractiveMode = 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	InteractiveMode = im_Abort	N'affiche jamais les boîtes de dialogue et abandonne l'exécution du script au lieu d'utiliser les valeurs par défaut à chaque fois qu'un dialogue s'impose.

Déclaration Option Explicit

Nous vous recommandons d'utiliser la déclaration Option Explicit pour déclarer vos variables. Vous éviterez ainsi toute confusion dans l'écriture de votre code car cette option est désactivée par défaut dans VBScript.

Exemple :

Option Explicit
ValidationMode = True
InteractiveMode = im_Batch
' get the current active model
Dim mdl ' the current model
Set mdl = ActiveModel