Pages Variables & Prompts

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 :

Page Variables

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.

Page Variables

Ajouter des variables d'objet

  1. Cliquez sur .
  2. Insère une ligne dans le tableau des variables d'objets

  3. Saisir des valeurs dans les colonnes :
    ColonneDescription
    NomNom 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 , à droite du champ.

    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.

    Valeur de la variable :

    Valeur résolue :

    string1234

    string1234

    'string1234'

    string1234

    "string1234"

    "string1234"

    string'1234

    string'1234

    'string'1234'string
    'string''1234'string'1234

    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 :

    • Nominal (chaîne de caractères)
    • Numérique
    • Horodatage
    • Date
    • Heure
    • Aucune utilisation (ne pas utiliser de variable d'objet pour l'ERT adaptatif)

    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 dans la section appropriée. Cliquez sur les cellules du tableau pour éditer leurs valeurs.

É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 :
&HOTE# = unix01
&DOSSIER# = temp

FILETRANSFER01

VariableEnregistre ou fournit les valeurs dynamiques de l'exécution. Egalement un type d'objet distinct dans Automation Engine. d'objet :
&HOTE# = win01

N/D

WORKFLOW01

Variable d'objet :
&HOTE# = unix02

JOB02

JOB03

Variable d'objet :
&HOTE# = unix03

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#.

Page Variables

Page Prompt Set

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.

Page Prompt Sets

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 : 

  1. Cliquez sur .
  2. La boîte de dialogue Ajouter PromptSet s'ouvre.

  3. À partir de la boîte de dialogue Ajouter PromptSet, accédez au répertoire Automation EngineCe composant commande un système Automation Engine. Il se compose de plusieurs processus serveur. contenant le PromptSet.
  4. 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.

    Page Prompt Sets

  5. Sélectionnez un objet PromptSet, puis cliquez sur OK.
  6. Pour chaque invite n'étant pas en lecture seule, vous avez la possibilité (option) de remplacer la valeur par défaut à partir de la définition d'objet PromptSet.
  7. 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 :

    Une variable prédéfinieVariables fixes qui peuvent être utilisées dans des attributs ou dans des Scripts d'objets activables. Les valeurs se rapportent à l'objet ou au système.

    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 et le champ contient une icône . Vous pouvez l'utiliser pour insérer des variables via la Ajouter variable.

    Ce texte comprend l'une des combinaisons suivantes :

    • Les variables des propriétés système : Les variables de propriétés système ne sont pas des objets. Elles restent les mêmes dans le système.
    • Les variables des propriétés des objets : Les objets de référence des propriétés des objets, qui ne sont pas des objets. Elles sont soit des valeurs de script d'objet renvoyant des codes d'éléments de scripts, soit des attributs d'objets.
    • Les variables Automation : Ces variables sont un sous-ensemble d'objets variable statiques utilisés pour les propriétés du système.
    • Les objets variable : Les objets variable peuvent être statiques ou dynamiques. Les variables statiques enregistrent les valeurs dans leur définition d'objet, tandis que les variables dynamiques extraient les valeurs d'une source de données spécifiée.

    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 et le champ contient une icône .

    N'utilisez pas l'icône , mais saisissez la variable d'objet dans la page Variable du schedule ou workflow parent.

    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 .