Objets VARA XML
Les objets VARA XML enregistrent une valeur pour une ou plusieurs clés. Leurs données doivent posséder une structure XML correcte. Ils peuvent être utilisés pour enregistrer provisoirement des données complexes, telles que des structures XML dans le système CA Automic Workload Automation. Ces données peuvent ensuite être référencées et utilisées dans les objets PromptSet, Script et dans d'autres contextes de scripts du système.
L'objet VARA XML vous permet d'extraire une liste de valeurs d'un objet Variable. Utilisez la fonction de script PREP_PROCESS_VAR_XML pour accéder à une partie ou à toutes les entrées d'une variable. Ceci prépare le traitement d'une séquence de données.
You can include PromptSet variables here when using the Rechargement dynamique (prompts Liste déroulante) feature for Combobox prompts. When you use PromptSet variables in a dynamic VARA object, the Preview feature returns an error. This is because the PromptSet variables do not exist in the dynamic VARA object. However, the PromptSet variables will be resolved when objects including the PromptSet are executed.
Cette rubrique contient les sujets suivants :
Considérations importantes sur la base de données
Il est possible d'utiliser des expressions XPath avec l'objet VARA XML, tel que décrit également dans les sections spécifiques des fonctions de script correspondantes. Selon la base de données avec laquelle le système CA Automic Workload Automation est utilisé, certaines expressions XPath peuvent fonctionner différemment. Dans ces cas-là, contactez l'éditeur de la base de données.
Si vous utilisez CA Automic Workload Automation avec une base de données Oracle, les valeurs d'attributs des données XML utilisées dans l'objet VARA ne doivent pas contenir plus de 4 000 caractères.
Les données XML ne peuvent utiliser que du codage de caractères compatible avec celui de la connexion de base de données.
-
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 :