Objets VARA STATIC
Les objets VARA STATIC vous permettent de conserver autant de clés que nécessaire avec un maximum de 5 valeurs chacune. Vous pouvez définir les valeurs manuellement avec un élément de script ou une action de condition. Les valeurs des objets VARA STATIC sont définies et saisies dans deux pages. La page principale Variables vous permet de définir leurs valeurs. La page Attributs vous permet de définir les paramètres spécifiques à l'objet VARA.
Cette rubrique contient les sujets suivants :
Définir des objets VARA STATIC
La définition d'un objet VARA STATIC se compose des pages suivantes :
- Page Général
-
Variables, voir Page Variables ci-dessous.
-
Attributs
Vous permet de définir les paramètres spécifiques aux objets. Certaines sections de cette page sont communes à tous les objets VARA et sont décrites dans des rubriques dédiées :
- Formats et types de données
- Paramètres des variables, voir Page Attributs ci-dessous
- Accès au script
- Objets VARA du client 0 dans d'autres clients
- Page Gestion des versions
- Page Documentation
Il existe plusieurs manières de définir les valeurs de l'objet VARA STATIC :
-
En les saisissant manuellement
Remarques :
-
La clé ne doit pas commencer par le caractère &. Sinon l'objet VARA peut être enregistré, mais une erreur se produit lors de l'accès à ces lignes via un script.
-
Longueur maximale des clés : 200 caractères
-
Les clés avec respect de la casse sont prises en charge.
Exemple : Vous pouvez ajouter les clés "test" et "TEST". Si votre base de données respecte la casse, elle enregistrera les deux clés, sinon, la seconde entrée remplace la première.
-
Selon ce que vous aurez sélectionné dans le champ Type de données (section Données et format), les plages de valeurs autorisées sont les suivantes :
-
Chaîne de caractères
Longueur du contenu : Illimité
Si la case Limiter la longueur est cochée dans la section Données et format, cette restriction ne concerne que la première colonne de valeurs.
-
Nombre
Longueur du contenu : 0 - 2147483647
-
Horodatage
Longueur du contenu : Valeur de la date et de l'heure en fonction du format de sortie
-
Heure
Longueur du contenu : Valeur de l'heure en fonction du format de sortie
-
Date
Longueur du contenu : Valeur de la date en fonction du format de sortie
-
Le tri des valeurs dépend des paramètres de la page Attributs. Par défaut, la colonne Clé est triée par ordre croissant.
-
-
En utilisant la fenêtre Éditeur de cellule
L'éditeur permet d'éditer un contenu de manière simple et conviviale. Il est utile particulièrement pour modifier des valeurs longues. Pour l'ouvrir, cliquez sur l'icône d'éditeur d'une cellule.
-
En définissant une action de condition SET VARIABLE ou CLEAR VARIABLE pour une tâche de workflow. Vous ne pouvez cependant pas définir de nouvel objet VARA avec une action de condition.
Les éléments de script suivants, sont disponibles pour les objets variable statique et XML :
- :PUT_VAR : enregistre les valeurs dans des variables statiques.
- :PUT_VAR_COL : enregistre une valeur dans une colonne spécifique d'un objet variable statique.
- :DELETE_VAR : supprime une ou toutes les valeurs d'un objet variable statique.
-
Type
Lecture seule, toujours STATIC
-
Plage de validité
Ce paramètre peut être utilisé pour simplifier le script qui écrit ou lit les valeurs dans l'objet VARA.
La clé doit normalement être spécifiée comme paramètre dans l'élément de script :PUT_VAR ou GET_VAR. Toutefois, il est alors difficile d'assurer que les valeurs sont stockées avec des clés uniques. En spécifiant une certaine plage de validité, vous pouvez simplifier la conception des scripts qui écrivent ou lisent l'objet VARA.
La clé est facultative pour toutes les valeurs de la plage de validité, sauf en sélection libre. La clé par défaut utilisée pour accéder à l'objet VARA lorsqu'aucune clé n'est spécifiée dépend des caractéristiques de la tâche accédant à l'objet.
Vous disposez des options ci-dessous :
-
Pas de plage de validité
Spécification facultative d'une clé.
Clé par défaut si aucune n'est spécifiée : *
-
Sélection libre
Spécification obligatoire d'une clé.
Clé par défaut si aucune n'est spécifiée : N/A. La spécification d'une clé étant obligatoire, l'erreur d'exécution U00003712 se produit en l'absence de clé.
Si l'objet VARA a la plage de validité Sélection libre, vous devez spécifier le code lorsque vous écrivez ou lisez l'objet VARA.
Exemple :
:SET&VARA_NAME# = "UC0.MAL.TEST#1_1.VARA_STATIC_USERNAME"
:PUT_VAR&VARA_NAME#, &$USER#, "Mercury", "Venus", "Earth", "Mars", "Jupiter"
:SET&VALUE# = GET_VAR(&VARA_NAME#, &$USER# ,1)
:PRINT"Value: &Value#"
-
Hôte - chaque nom d'hôte
Spécification facultative d'une clé.
Clé par défaut si aucune n'est spécifiée : Le nom de l'agent où la tâche est en exécution.
-
Tâche - chaque nom de tâche
Spécification facultative d'une clé.
Clé par défaut si aucune n'est spécifiée : Le nom de l'objet exécutable en exécution.
-
Nom du Workflow - chaque nom de Workflow
Spécification facultative d'une clé.
Clé par défaut si aucune n'est spécifiée : Nom du workflow parent dans lequel la tâche est exécutée.
-
Session de Workflow - chaque session de Workflow
Spécification facultative d'une clé.
Clé par défaut si aucune n'est spécifiée : RunID du workflow parent dans lequel la tâche est exécutée.
-
Utilisateur - chaque nom d'utilisateur
Spécification facultative d'une clé.
Clé par défaut si aucune n'est spécifiée : Le nom de l'utilisateur qui exécute.
Si l'objet VARA a la plage de validité Utilisateur - pour chaque nom d'utilisateur, vous pouvez omettre le code lorsque vous accédez à l'objet VARA.
Exemple :
:SET&VARA_NAME# = "UC0.MAL.TEST#1_1.VARA_STATIC_USERNAME"
:PUT_VAR&VARA_NAME#, , "Mercury", "Venus", "Earth", "Mars", "Jupiter"
:SET&VALUE# = GET_VAR(&VARA_NAME#, &$USER# ,1)
:PRINT"Value: &Value#"
-
Session utilisateur - chaque session d'utilisateur
Spécification facultative d'une clé.
Clé par défaut si aucune n'est spécifiée : RunID de la session utilisateur. L'entrée (ligne) correspondant à la session utilisateur sera effacée lorsque la session de l'utilisateur se terminera.
Les deux plages de validité qui sont les plus utiles sont Session utilisateur - chaque session d'utilisateur et Session de Workflow - chaque session de Workflow. Avec ces deux plages de validité, le code par défaut qui est utilisé si aucun n'est spécifié est l'ID de la session de l'utilisateur ou le l'ID d'exécution du workflow, respectivement. Et de manière importante, avec ces deux plages de validité, les lignes sont supprimées lorsque l'ID d'exécution correspond est désactivé.
Exemple :
Vous souhaitez conserver certaines informations dans un objet VARA, tant qu'un utilisateur est connecté, mais supprimer ces informations dès qu'il se déconnecte. Vous pouvez définir la plage de validité de l'objet VARA sur Session utilisateur - chaque session utilisateur, et mettre les valeurs dans l'objet VARA sans spécifier de clé, comme illustré ici :
:SET&VARA_NAME# = "UC0.MAL.TEST#1_1.VARA_STATIC_USERSESSION"
:PUT_VAR&VARA_NAME#, , "Mercury", "Venus", "Earth", "Mars", "Jupiter"
:SET&VALUE# = GET_VAR(&VARA_NAME#, &$USER# ,1)
:PRINT"Value: &Value#"
La clé utilisée pour écrire les valeurs sera l'ID de session de l'utilisateur exécutant le script. Dans cet exemple, exécuter le script a entraîné l'ajout de la ligne suivante à l'objet VARA :
Clé 1168010
Valeur 1 Mercure
Valeur 2 Venus
Valeur 3 Terre
Valeur 4 Mars
Valeur 5 Jupiter
1168010 est l'ID de session utilisateur. Ces ID sont visibles dans Utilisateurs, dans la Perspective Administration. Lorsque l'utilisateur se déconnecte, cette ligne est supprimée de l'objet VARA.
La plage de validité Session de Workflow - chaque session de Workflow fonctionne d'une manière similaire. Toute ligne écrite à un tel objet VARA (sans un code spécifié) sera automatiquement supprimée aussitôt que le workflow d'exécution est désactivé.
-
Voir aussi :