Constantes globales

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

Constantes globales

Les constantes globales suivantes sont disponibles :

Constante globale	Utilisation
Version As String	Retourne la version de l'application.
HomeDirectory As String	Retourne le répertoire racine de l'application.
RegistryHome As String	Retourne le chemin racine du registre de l'application.
cls_... As Long	Identifie la classe d'un objet. Cette valeur est utilisée lorsque vous avez besoin de spécifier le type d'un objet dans la méthode de création par exemple. Elle est aussi utilisée par la méthode IsKindOf disponible sur tous les objets de PowerAMC.

Constantes d'ID de classe

Les constantes sont uniques au sein d'un modèle et sont utilisées pour identifier les classes d'objets dans chaque bibliothèque. Tous les identifiants de classes commencent par "cls_" suivi du nom public de l'objet. Par exemple cls_Process identifie la classe d'objet Processus en utilisant le nom public de l'objet.

Toutefois, lorsque vous manipulez plusieurs modèles à la fois, certaines constantes peuvent être communes, par exemple cls_Package.

Pour éviter toute confusion dans le code, vous devez préfixer le nom de la constante par le nom du module, par exemple PdOOM cls_Package. De même, lorsque vous créez un modèle, vous devez préfixer la constante cls_Model par le nom du module.

Méthode IsKindOf

Boolean avec une constante de classe pour vérifier qu'un objet hérite d'un type de classe donné.

Exemple :

Vous pouvez avoir un script doté d'une boucle qui parcourt la collection Classifiers d'un MOO et qui vérifie le type des objets rencontrés (dans le cas d'interfaces ou classes) pour leur appliquer un traitement différent selon leur type.

'Assuming the Activemodel is an OOM model
For each c in Activemodel.Classifiers
If c.IsKindOf(cls_Class) then
Output "Class " & c.name
ElsIf c.IsKindOf(cls_Interface) then
Output "Interface" & c.name
End If
Next

Exemple :

Toutes les collections d'un modèle peuvent contenir des objets d'un type donné mais également des raccourcis d'objets de même type. Vous pouvez avoir un script doté d'une boucle qui parcourt la collection Tables d'un MPD et qui vérifie le type des objets rencontrés (dans ce cas tables ou raccourcis) pour leur appliquer un traitement différent selon leur type.

For each t in Activemodel.Tables
If t.IsKindOf(cls_Table) then
Output t.name
End If
Next