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 l'espace de travail (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

Renvoie 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