Variables et paramètres
3.
Dans l'onglet Définitions, sélectionnez Variables globales.
4.
Cliquez avec le bouton droit de la souris sur Variables globales et sélectionnez Insérer.
Une nouvelle variable globale s'affiche (par exemple, $NewJobGlobalVariable0). Un cadre de contexte s'affiche et le curseur prend la forme d'une flèche avec un crayon jaune.
5.
Pour modifier le nom d'une variable, cliquez sur la cellule du nom.
Le nom peut contenir des caractères alphanumériques ou des traits de soulignement, mais il ne peut pas contenir d'espace. Le nom doit toujours commencer par un symbole dollar ($).
6.
Cliquez sur la cellule du type de données pour la nouvelle variable et sélectionnez le type de données approprié dans la liste déroulante.
7.
Fermez la fenêtre "Variables et paramètres".
13.4.2 Affichage de variables globales
Les variables globales définies dans un job sont visibles pour les objets relatifs à ce job. Une variable globale définie dans un job ne peut pas être modifiée ou affichée à partir d'un autre job.
Vous pouvez afficher des variables globales dans la fenêtre Variables et paramètres (avec un job en cours dans l'espace de travail) ou dans la boîte de dialogue Propriétés d'un job sélectionné.
13.4.2.1 Pour afficher des variables globales dans un job à partir de la boîte de dialogue Propriétés
1.
Dans la bibliothèque d'objets, sélectionnez l'onglet Jobs.
2.
Cliquez avec le bouton droit de la souris sur le job dont vous voulez afficher les variables globales et sélectionnez Propriétés.
3.
Cliquez sur l'onglet Variable globale.
Les variables globales s'affichent dans cet onglet.
13.4.3 Définition de valeurs de variables globales
Outre la définition d'une variable dans un job à l'aide d'un script d'initialisation, vous pouvez définir et gérer des valeurs de variable globale à l'extérieur d'un job. Les valeurs définies à l'extérieur d'un job sont traitées de la même façon que celles définies dans un script d'initialisation. Cependant, si vous
306 2012-11-22
Variables et paramètres définissez une valeur pour la même variable à l'intérieur et à l'extérieur d'un job, la valeur interne se substituera à la valeur de job externe.
Des valeurs de variables globales peuvent être définies à l'extérieur d'un job :
• Comme propriété de job
• Comme propriété d'exécution ou de planification
Les variables globales sans valeur définie sont également autorisées. Elles sont lues comme valeurs nulles.
Toutes les valeurs définies comme propriétés de job sont affichées dans les boîtes de dialogue Propriétés et Propriétés d'exécution de Designer et dans les pages Options d'exécution et Planification de l'Administrateur. En définissant des valeurs à l'extérieur d'un job, vous pouvez vous référer à ces boîtes de dialogue pour afficher des valeurs définies pour des variables globales et modifier facilement des valeurs lors d'un test ou de la planification d'un job.
Remarque :
Vous ne pouvez pas transférer des variables globales comme arguments de ligne de commande pour des jobs en temps réel.
13.4.3.1 Pour définir une valeur de variable globale comme propriété de job
1.
Cliquez avec le bouton droit de la souris sur la librairie d'objets ou sur la zone de projet
2.
Cliquez sur Propriétés.
3.
Cliquez sur l'onglet Variable globale.
Toutes les variables globales créées dans ce job s'affichent.
4.
Saisissez des valeurs pour les variables globales dans ce job.
Vous pouvez utiliser toute instruction utilisée dans un script avec cette option.
5.
Cliquez sur OK.
Le logiciel sauvegarde les valeurs dans le référentiel comme propriétés de job.
Vous pouvez également afficher et modifier ces valeurs par défaut dans la boîte de dialogue
Propriétés d'exécution de Designer et dans les pages Options d'exécution et Planification de l'Administrateur. Vous pouvez ainsi substituer les valeurs de propriété du job lors de l'exécution.
Rubriques associées
• Guide de référence : Langue de script
307 2012-11-22
Variables et paramètres
308
13.4.3.2 Pour définir une valeur de variable globale comme propriété d'exécution
1.
Exécutez un job à partir de Designer ou bien exécutez ou planifiez un job batch à partir de l'Administrateur.
Remarque :
A des fins de test, vous pouvez exécuter des jobs en temps réel à partir de Designer en mode test.
Vérifiez que vous avez défini les propriétés d'exécution pour un job en temps réel.
2.
Affichez les variables globales dans le job et leurs valeurs par défaut (le cas échéant).
3.
Modifiez les valeurs des variables globales le cas échéant.
4.
Si vous utilisez Designer, cliquez sur OK. Si vous utilisez l'Administrateur, cliquez sur Exécuter ou
Planifier.
Le job est exécuté à l'aide les valeurs que vous saisissez. Les valeurs saisies comme propriétés d'exécution ne sont pas sauvegardées. Les valeurs saisies en tant que propriétés de planification sont sauvegardées mais sont accessibles uniquement depuis l'Administrateur.
13.4.3.3 Classement automatique de valeurs de variables globales dans un job
Si vous utilisez les méthodes décrites à la section précédente et si vous saisissez différentes valeurs pour une seule variable globale, le logiciel sélectionne la valeur de classement la plus élevée pour l'utiliser dans le job. Une valeur saisie comme propriété de job a le plus petit classement. Une valeur définie à l'intérieur d'un job a le classement le plus élevé.
• Si vous définissez une valeur de variable globale à la fois comme job et comme propriété d'exécution, la valeur de propriété d'exécution se substitue à la valeur de propriété de job et devient la valeur par défaut pour l'exécution de job en cours. Vous ne pouvez pas sauvegarder de valeurs de variables globales de propriété d'exécution.
Par exemple, supposez qu'un job, JOB_Test1, ait trois variables globales déclarées : $YEAR,
$MONTH et $DAY. La variable $YEAR est définie comme propriété de job avec une valeur 2003.
Pour l'exécution du job, vous définissez JANVIER et 31 respectivement comme variables $MONTH et $DAY comme propriétés d'exécution. Le logiciel exécute une liste d'instructions contenant des valeurs par défaut pour JOB_Test1 :
$YEAR=2003;
$MONTH='JANUARY';
$DAY=31;
2012-11-22
Variables et paramètres
Pour la deuxième exécution de job, si vous définissez les valeurs 2002 et JANUARY respectivement comme variables $YEAR et $MONTH comme propriétés d'exécution, l'instruction $YEAR=2002 remplacera $YEAR=2003. Le logiciel exécute la liste suivante d'instructions :
$YEAR=2002;
$MONTH='JANUARY';
Remarque :
Dans ce scénario, $DAY n'est pas défini et le logiciel lit cette valeur comme valeur nulle. Vous définissez 31 comme valeur pour $DA, au cours de la première exécution du job , cependant, les propriétés d'exécution pour les valeurs de variables globales ne sont pas sauvegardées.
• Si vous avez défini une valeur de variable globale à la fois pour une propriété de planification et de job, la valeur de propriété de planification se substitue à la valeur de propriété de job et devient la valeur par défaut externe pour l'exécution de job en cours.
Le logiciel sauvegarde les valeurs de propriété de planification dans le référentiel. Cependant, ces valeurs sont uniquement associées à une planification de job, pas au job lui-même. Par conséquent, ces valeurs sont affichées et modifiées dans l'Administrateur.
• Une valeur de variable globale définie à l'intérieur d'un job se substitue toujours à toute valeur externe. Cependant, la substitution n'est pas exécutée tant que le logiciel tente d'appliquer les valeurs externes au job en cours d'exécution avec la valeur interne. Jusque là, le logiciel traite les valeurs d'exécution, de planification ou de propriété comme valeurs par défaut.
Par exemple, supposez un job nommé JOB_Test2 contenant trois workflows, chacun comportant un flux de données. Le deuxième flux de données se trouve dans un workflow précédé d'un script dans lequel la valeur MAY est définie pour $MONTH. Le premier et le troisième flux de données ont la même variable globale sans valeur définie. La propriété d'exécution $MONTH = 'APRIL' constitue la valeur de variable globale.
Dans ce scénario, 'APRIL' devient la valeur par défaut pour le job. 'APRIL' reste la valeur de la variable globale tant qu'elle ne se chevauche pas avec une autre valeur pour la même variable dans le deuxième workflow. La valeur du script se trouvant dans le job, 'MAY' se substitue à 'APRIL' pour la variable $MONTH. Le logiciel continue à traiter le job avec cette nouvelle valeur.
309 2012-11-22
