Propriétés globales

Chapter 9 Accès aux objets via VBScript

Propriétés globales

Les propriétés globales suivantes sont disponibles :

Propriétés globales	Utilisation
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
Models As ObjectSet	Collection en lecture seule qui permet de lister les modèles ouverts
MetaModel As BaseObject	Récupère le métamodèle (objet MetaModel)
ActiveWorkspace As BaseObject	Récupère le workspace (objet Workspace
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 or +Abort
UserName As String	Récupère le nom de connexion de l'utilisateur
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
ScriptInputParameters As String	Propriété en lecture seule qui peut le cas échéant être renseignée par celui qui invoque le script
ScriptInputArray As String	Propriété en lecture seule qui peut le cas échéant être renseignée par celui qui invoque le script
ScriptResult As String	Ecrit la propriété à utiliser pour renvoyer le résultat d'une exécution de script

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

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 :

Constante	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