Les pages VariablesVariables comportant les paramètres de configuration du système AE. & Prompts sont spécifiques aux objets exécutables. Vous pouvez utiliser la page Variables pour définir les variables d'objet"Caractères de remplacement des valeurs définies dans l'onglet ""Variables & Prompts"" d'un objet." et la page Prompt Set, pour ajouter des objets PromptSet et remplacer les valeurs d'invites.
La section Variables & Prompts se compose de deux pages :
La page Variables vous permet de définir les variables d'un objet exécutable. Les variables d'objet définies ici contiennent des valeurs pouvant être utilisées pour tout l'objet et ses Pages Traitement.
Ajouter des variables d'objet
Insère une ligne dans le tableau des variables d'objets
Colonne | Description | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Nom | Nom de la variable d'objet. Les variables d'objet commencent par & et se terminent par # , par exemple : &AGENT# . | ||||||||||||||
Valeur | Valeur de la variable (optionnel). Pour utiliser un éditeur de cellule afin de définir votre variable, cliquez sur l'icône Les valeurs des variables d'objet peuvent être indiquées avec ou sans guillemets. Si vous utilisez des guillemets simples, les apostrophes doivent apparaître en double à l'intérieur de la chaîne, sinon, un ou plusieurs caractères risquent d'être supprimés. Vous pouvez également utiliser les guillemets. Ils sont systématiquement considérés comme des caractères normaux et ne sont pas supprimés.
| ||||||||||||||
Utilisation pour ERT adaptatif | Vous pouvez définir les variables d'objets en tant que facteurs externes pour le calcul de l'ERT adaptatif. Sélectionnez le type de données correspondant à la valeur de la variable, parmi les éléments suivants :
Cette variable sera prise en compte lors du processus de calcul de l'ERT adaptatif. |
Travailler dans la table Variable
Pour : | Procédez comme suit : |
---|---|
Ajouter une ligne à un tableau |
Cliquez sur |
Éditer une cellule dans une ligne du tableau |
Cliquez sur la cellule du tableau et modifiez sa valeur. |
Supprimer une ou plusieurs lignes du tableau |
Cochez la case de la ou des lignes, puis cliquez sur |
Supprimer toutes les lignes du tableau |
Cochez la case de l'en-tête de colonne, puis cliquez sur |
Couper une ou plusieurs lignes et les coller dans le presse-papiers AWIProduit Automic : interface Web, simple et claire, qui permet l'+char(39)+'accès aux différentes fonctionnalités d'+char(39)+'Automation Engine. |
Cochez la case de la ou des lignes, puis cliquez sur |
Copier une ou plusieurs lignes et les coller dans le presse-papiers AWI |
Cochez la case de la ou des lignes, puis cliquez sur |
Coller la ou les lignes du pesse-papiers AWI en bas du tableau. |
Cliquez sur ![]() |
Les variables définies ici sont immédiatement utilisées pour le scriptEgalement un type d'objet distinct dans l'Automation Engine. des Pages Traitement d'objets exécutables. L'exemple suivant utilise la variable d'objet pour terminer l'agent"Programme permettant l'exécution de Traitements sur des systèmes cible comme un ordinateur ou des solutions d'entreprise. Egalement un type d'objet distinct dans l'Automation Engine. [Anciennement appelé ""Exécuteur de tâches"".]".
:IF SYS_HOST_ALIVE(&AGENT#) = "N"
: SEND_MSG "ADMIN","AE","Agent &AGENT# is not active!"
:ENDIF
Hériter des objets parents
Le paramètre Hériter du parentUn objet peut être activé de différentes façons. L'initiateur de l'activation s'appelle Tâche de niveau supérieur (parent). (voir aussi Enfant, Enfants) détermine si les variables d'objet héritent des objets parents. Lorsqu'un objet exécutable est utilisé comme tâcheObjet exécutable qui a déjà été exécuté. de ScheduleDémarre des objets activables à intervalles périodiques. Egalement un type d'objet distinct dans l'Automation Engine. ou de WorkflowLes workflows sont utilisés pour effectuer des déploiements physiques. Un workflow décrit toutes les étapes nécessaires au déploiement de votre application. Votre application étant composée de différents éléments, le niveau le plus élevé du workflow (workflow d'application) représente l'architecture de votre application, et les workflows de composants sont utilisés pour déployer chacun des composants. Vous pouvez définir votre workflow de composants rapidement grâce à des actions prédéfinies. , il peut utiliser des variables d'objets Schedule ou Workflow. Ceci simplifie la maintenance, car les valeurs n'ont pas besoin d'être enregistrées ni gérées dans des objets distincts.
Paramètre | Description |
---|---|
Toutes les variables | Propose toutes les variables d'objets de la tâche parent (par défaut). |
Valeurs définies seulement | Ne propose que les variables d'objets de la tâche parent ayant été définies dans la page Variables. Les variables PromptSet n'hériteront que si l'objet PromptSet coïncide avec ces valeurs et si la valeur à remplacer n'a pas été modifiée dans la page Variables. |
Aucune variable | L'objet n'hérite d'aucune variable de sa tâche parent. |
Les variables d'objets (ainsi que les variables d'invites, utilisant le même nom de variable que la variable d'objet parent) sont transmises aux :
Les variables d'objets (ainsi que les variables d'invites, utilisant le même nom de variable que la variable d'objet parent) sont transmises aux :
Les valeurs des objets activés via ACTIVATE_UC_OBJECT et le paramètre PASS_VALUES héritent indépendamment du paramètre Hériter du parent.
Les variables d'objets et variables PromptSet n'héritent pas si la tâche enfantTâche subordonnée (par ex. tâche fonctionnant à l'intérieur d'un workflow). possède une variable PromptSet du même nom, indépendamment du paramètre Hériter du parent.
Les variables d'objets et variables PromptSet héritées remplacent les variables d'objets existantes si elles portent le même nom. Par contre, les variables PromptSet ne sont jamais remplacées.
Le paramètre Hériter du parent a une grande influence sur toutes les autres tâches enfant de l'objet. Les valeurs sont directement transmises d"une tâche à ses tâches enfant. Si, pour un certain objet, vous décidez de n'hériter aucune valeur ou uniquement des valeurs définies, alors les tâches enfant d'une tâche ne peuvent plus accéder à toutes les variables d'"objets grands-parents". A l'aide des exemples ci-dessous, vous pouvez voir l'effet de ces paramètres.
Les variables d'objets et variables PromptSet peuvent également être utilisées pour définir certains attributs sans devoir utiliser :PUT_ATT.
L'instruction de script :PSET crée une nouvelle entrée dans la page Variables pendant la durée de l'exécutionDurée d'exécution d'une Tâche. C'est la période entre le début et la fin de la Tâche. La période d'activation n'en fait pas partie (voir aussi Activation et Démarrage)., si la variable d'objet n'existe pas encore. Si une variable d'objet du même nom existe déjà, sa valeur sera écrasée par la nouvelle valeur.
Si la variable d'objet est modifiée par les scripts :SET, :RSET ou :READ, la valeur est disponible dans l'objet qui a été attribué en dernier (dans les onglets Traitement, Post-traitement et Post-traitement enfant). Il n'est pas nécessaire d'affecter cette valeur explicitement avec l'élément de script :RSET (dans l'onglet Post-traitement, par exemple).
Si vous créez une variable d'objet avec l'instruction de script :PSET, cette dernière est automatiquement transmise à l'objet parent. Si l'objet parent contient déjà une variable d'objet ou une variable PromptSet du même nom, la valeur de cette dernière sera remplacée. Les tâches suivantes du parent peuvent alors accéder à cette variable.
Lorsque vous redémarrez un objet, les valeurs de la page Variables seront utilisées pour les variables d'objets si elles sont définies dans cet onglet. Les valeurs de certaines exécutions de l'objet n'ont par conséquent pas de signification en cas de repriseRépétition d'une exécution d'objet déjà créée pour laquelle plusieurs particularités s'appliquent au redémarrage.. La raison de ce comportement est que lorsqu'une erreur survient en raison de la variable d'objet, le système peut corriger la valeur de l'objet et cette valeur sera alors également utilisée pour le redémarrage.
Contrairement aux variables de script, les variables d'objets et variables PromptSet ne possèdent pas de Data Types spécifique. La fonction script CONVERT vous permet d'attribuer un type de données spécifique aux variables.
Exemple : Activer un transfert de fichier par un Schedule
Un transfert de fichierTransmission de fichiers entre deux machines. Egalement un type d'objet distinct dans l'Automation Engine. est activé par un schedule. Les objets variables d'objet suivantes sont utilisés :
Schedule :
Transfert de fichiers :
Le script du transfert de fichier accède aux variables &FILE#, &HOST# and &PATH#. La valeur attribuée à ces variables change en fonction des paramètres configurés dans l'onglet Variables & Prompts de l'objet transfert de fichier :
Hérite du parent |
Contenu des variables |
Raison |
---|---|---|
Toutes les variables (par défaut) |
&FICHIER# = clôture_hebdomadaire.txt |
La valeur du schedule remplace celle du transfert de fichier. |
&HOTE# = win01 |
Toutes les valeurs du schedule héritent. Ainsi, le transfert de fichier peut également accéder à &HOST#. |
|
&CHEMIN# = C:\Temp |
Cette variable d'objet fait déjà partie du transfert de fichier. |
|
Uniquement les variables définies |
&FICHIER# = clôture_hebdomadaire.txt |
La valeur du Schedule remplace celle du transfert de fichier, étant donné qu'il contient également une variable d'objet nommée &FILE#. |
&HOTE# = "" |
La valeur de &HOST# n'hérite pas, étant donné qu'aucune variable d'objet du même nom n'est disponible dans le transfert de fichier. L'activation d'une tâche est interrompue si vous cherchez à accéder dans le script à une variable d'objet qui n'existe pas ou qui n'hérite pas. |
|
&CHEMIN# = C:\Temp |
Cette variable d'objet fait déjà partie du transfert de fichier. |
|
Aucune valeur |
&FICHIER# = résultat_du_jour.txt |
Aucune valeur n'est héritée. C'est donc la variable d'objet du transfert de fichier qui est utilisée. |
&HOTE# = "" |
La valeur de &HOTE# n'est pas héritée. Elle ne peut donc pas être utilisée. L'activation d'une tâche est interrompue si vous cherchez à accéder dans le script à une variable d'objet qui n'existe pas ou qui n'hérite pas. |
|
&CHEMIN# = C:\Temp |
Cette variable d'objet fait déjà partie du transfert de fichier. |
Exemple : Héritage de valeurs par les enfants et petits-enfants
Cet exemple montre comment les valeurs sont héritées dans un workflow enfant et au delà.
Le workflow PARENTWF01 contient les objets FILETRANSFER01 et WORKFLOW01. WORKFLOW01 contient deux jobs. L'héritage des valeurs entre le workflow principal et le transfert de fichier s'effectue comme expliqué dans l'exemple 1.
Parent | Enfants | Petits-enfants |
---|---|---|
PARENTWF01 Variables d'objets : |
FILETRANSFER01 VariableEnregistre ou fournit les valeurs dynamiques de l'exécution. Egalement un type d'objet distinct dans Automation Engine. d'objet : |
N/D |
WORKFLOW01 Variable d'objet : |
JOB02 | |
JOB03 Variable d'objet : |
Différentes situations sont présentées ci-dessous et décrivent comment WORKFLOW01 et ses paramètres affectent les deux jobs :
Exemple : Une combinaison des fonctions d'héritage
L'exemple suivant contient les différentes combinaisons et particularités de l'héritage de variables d'objet et PromptSet.
Dans le workflow, cinq tâches (tâche 1, 2, 3, 4 et 6) sont exécutées les unes après les autres. La tâche 5 est activée via le script de la tâche 4.
Le Workflow possède les variables d'objet &VAR1#, &VAR2# et les variables PromptSet &TEXT1#, &COMBO1#.
Les objets PromptsSet vous permettent de définir une ou plusieurs invites. Vous pouvez ajouter un ou plusieurs objets PromptsSets à un objet exécutable sur sa page Prompt Set dans Variables & Prompts. Lors de l'ajout de PromptSets à des objets exécutables, les invites transmettent les valeurs sous forme de variables d'invites aux Pages Traitement.
Le volet Prompt Sets de gauche affiche une liste de tous les objets PromptSets ajoutés à l'objet exécutable.
Ajout de PromptSets à un objet exécutable
Pour ajouter un PromptSet à un objet exécutable :
La boîte de dialogue Ajouter PromptSet s'ouvre.
Vous pouvez également spécifier (optionnel) une recherche dans le champ Rechercher pour limiter les résultats qui s'afficheront.
La recherche n'est pas sensible à la casse.
Le remplacement d'une définition d'invite affecte les invites de l'objet exécutable concerné. Cela n'affecte pas les valeurs par défaut dans la définition d'objet PromptSet. Il y a plusieurs manières de remplacer les valeurs d'invites.
Pour remplacer une valeur d'invite par : | Procédez comme suit : |
---|---|
ou Une chaîne de caractères contenant une ou plusieurs variables prédéfinies |
Cliquez sur le titre de l'invite. En cliquant sur le titre de l'invite, le champ se transforme en champ de saisie directe ou variable. La figure ci-dessous montre une invite de liste modifiable par saisie directe. ![]() En cliquant sur le titre Tous les objets, il se transforme en champ de saisie variable. Le titre s'affiche sur fond gris avec l'icône
Ce texte comprend l'une des combinaisons suivantes :
Les variables de propriétés système et objet se caractérisent par un & au début et un # à la fin. Les objets variable (y compris les variables Automation) se caractérisent par un { au début et un } à la fin. Ces conventions de texte vous permettent d'utiliser n'importe quel type de variable avec du texte supplémentaire si l'invite le permet. Il est ainsi possible d'avoir une valeur d'invite de {PREFIX}_&$CLIENT#. |
La valeur du workflow parent ou de la variable d'objet de schedule |
Cliquez sur le titre de l'invite pour qu'il se transforme en champ de saisie variable.
En cliquant sur le titre de l'invite, il se transforme en champ de saisie variable. Le titre s'affiche sur fond gris avec l'icône N'utilisez pas l'icône |
Texte de champ de texte ou de zone de liste modifiable |
Saisissez un texte dans le champ de texte ou la zone de liste modifiable.
|
Options sélectionnables dans un champ de texte |
Certaines invites vous permettent de sélectionner une ou plusieurs valeurs, ou des noms de fichiers dans la liste. Ces champs contiennent un bouton ... à droite. Cliquez dessus pour ouvrir une boîte de dialogue contextuelle et sélectionner un ou plusieurs valeurs (selon la définition de l'invite).
|
Option d'une zone de liste modifiable |
Option de la zone de liste modifiable.
|
Options de cases à cocher |
Options de cases à cocher.
|
Option de case d'option |
Option de case d'option.
|
Nombre |
Nombre.
|
Date et / ou heure |
Date et / ou heure.
|
Réorganiser les invites
S'il y a plusieurs objets PromptSet pour un objet exécutable, ils s'activent de haut en bas. Pour réorganiser des PromptSets, utilisez la fonction glisser-déposer ou les boutons et
.
Supprimer des invites
Pour supprimer des invites, sélectionnez-les, puis cliquez sur le bouton .