Onglet Variable

Chaîne

Illimité

Si le paramètre ''Limitation de texte'' est sélectionné (onglet "Attributs"), cette restriction ne concerne que la première colonne de valeurs. 

Nombre

Entre 0 et 2147483647

Horodatage

Valeur de la date et de l'heure en fonction du format de sortie.

Objet activable

Nom de l'objet Automation Engine.

Il est recommandé d'utiliser les types d'objet suivants avec la variable VARA.EXEC :

• Job, script, job de transfert de fichier, événement, gestionnaire de tâches distantes, Workflow, groupe, notification

Les types d'objets activables suivants ne doivent pas être utilisés avec la variable VARA.EXEC : Schedule et Cockpit.

Notez qu'à ce stade, aucune vérification de l'objet activable n'est réalisée, si le bon type d'objet a été sélectionné. Un message d'erreur sera affiché dès que l'objet est exécuté.

Nom de la variable de script utilisée pour la valeur renvoyée par l'objet activable.

Liste des variables disponibles dans l'objet activable. Leurs valeurs peuvent être :

• des valeurs directes, par exemple 5342 ou
• des variables référencées, par exemple &reftext#.

Connexion à la base de donées

Connexion

Objet connexion de type base de données qui contient les paramètres de connexion pour la base de données.

Objet Login qui enregistre le nom de l'utilisateur de la base de données et le mot de passe associé.

Si aucun objet Login n'est indiqué et si l'option Appliquer le Login utilisateur par défaut n'est pas cochée, les données de connexion sont fournies par l'objet connexion pour l'accès à la base de données. Si aucune information de connexion ne s'y trouve non plus, une erreur survient à la résolution de la variable.

La sélection d'un objet Login pour les variables SQL est aussi possible dans les objets utilisateur. Si le paramètre Appliquer le Login utilisateur par défaut est activé, l'objet Login qui a été attribué à l'utilisateur connecté est utilisé. L'objet Login configuré dans la variable est alors ignoré. Si aucun Login n'est défini ou si un Login non valide est défini dans l'objet utilisateur, l'accès à la variable génère une erreur.

Champ texte pour spécifier des instructions SQL. Ces instructions SQL sont utilisées pour sélectionner des enregistrements de données de la base de données et les attribuer aux valeurs de variable.

Exemple : select * from col

Notez que toutes les instructions SQL sont autorisées dans ce champ texte. Vous pouvez même modifier ou supprimer des entrées de la base de données.

AE ne vérifie pas si les instructions SQL contiennent des erreurs ou sont dangereuses. Elles sont passées à la base de données sans vérification. Une erreur d'exécution ne peut donc survenir que lors de l'accès à la base de données, qui a lieu au moment de la résolution des variables.

Notez que vous devez utiliser le paramètre VAR_SECURITY_LEVEL(UC_SYSTEM_SETTINGS) dans les instructions SQL si vous utilisez des variables prédéfinies ou d'autres objets variable. Sinon, aucun remplacement n'est effectué (par défaut) et une erreur de base de données se produit.

Taille maximale : 4096 caractères

Définition du contenu de la colonne résultat.

La première colonne affichée dans l'aperçu est la colonne résultat. Les autres colonnes contiennent les valeurs des colonnes de la base de données qui ont été retournées par la requête SQL. La colonne de résultat peut se composer d'une combinaison des colonnes de valeurs et d'autres caractères au choix. Ceci est défini par le format du résultat.

Les numéros de colonne qui ont été indiqués entre accolades { } dans le champ Format du résultat sont remplacés par la valeur de la colonne concernée.

Par exemple :
Colonne de valeurs 1 : JOB1
Colonne de valeurs 2 : WIN01
Format du retour : {1}_{2}
Colonne de résultat : JOB01_WIN01

La colonne de résultat correspond à la première colonne de valeur si aucun format du résultat n'est indiqué.

Les limitations des variables (valeur min., valeur max. et limiter le texte) n'influencent pas la colonne de résultat, mais uniquement la première colonne renvoyée. Si la valeur de cette colonne dépasse la plage autorisée, la ligne en question est ignorée et n'est pas disponible via l'objet variable.

Exécute les instructions SQL et affiche le résultat dans une nouvelle fenêtre. Ainsi, les instructions SQL sont vérifiées et d'autres erreurs peuvent être identifiées (par exemple, le type de données de l'objet variable ne correspond pas à celui de la base de données) .

L'agent de base de données envoie les données pour l'aperçu dans un message à l'Automation Engine. Si ce message dépasse la longueur de message maximale acceptée par un processus serveur (paramètre MaxMsgSize= dans le fichier INI de l'Automation Engine, valeur par défaut : 3145 728 octets). Dans ce cas, limitez le résultat à l'aide d'un nombre de lignes maximal ou à l'aide d'instructions SQL.

Connexion à la base de données

Connexion

Objet connexion de type base de données qui contient les paramètres de connexion pour la base de données sélectionnée.

Objet Login qui enregistre le nom de l'utilisateur de la base de données et le mot de passe associé.

Les données de connexion pour l'accès à la base de données sont fournies par l'objet connexion si aucun objet Login n'est indiqué et si l'option Appliquer le Login utilisateur par défaut n'est pas cochée. Une erreur survient à la résolution de la variable et cet objet ne contient aucune information de connexion.

Vous pouvez aussi sélectionner un objet Login pour les variables SQL dans les objets utilisateur. Si le paramètre Appliquer le Login utilisateur par défaut est activé, l'objet Login qui a été attribué à l'utilisateur connecté est utilisé. L'objet Login configuré dans la variable est alors ignoré. Si aucun Login n'est défini ou si un Login non valide est défini dans l'objet utilisateur, l'accès à la variable génère une erreur.

Instructions SQL utilisées pour sélectionner certains éléments de la base de données qui servent de valeurs de variables.

Les variables qui sont indiquées directement dans SQL ne sont pas remplacées. Pour inclure des variables, utilisez les paramètres de liaison.

Taille maximale : 4096 caractères

Tableau contenant les paramètres de liaison.

Utilisez les paramètres de liaison pour ajouter des valeurs de variables aux instructions SQL. Vous pouvez utiliser des variables prédéfinies, des variables PromptSet et des caractères de remplacement pour les objets VARA comme éléments de ce tableau. Chaque ligne représente un paramètre de liaison.

Les paramètres de liaison permettent d'ajouter des valeurs de variables dans les commandes SQL. Vous pouvez utiliser des variables de script, des variables d'objet, des variables prédéfinies et des caractères de remplacement pour les objets VARA que vous saisissez dans cette table. Chaque ligne représente un paramètre de liaison.

La variable VAR_SECURITY_LEVEL (UC_SYSTEM_SETTINGS) n'impose aucune limitation.

Dans les instructions SQL, vous devez utiliser le caractère ? à chaque emplacement où la valeur remplacée d'un paramètre de liaison doit être insérée. Un paramètre de liaison doit exister pour chaque ?. Assurez-vous de maintenir l'ordre correct du tableau. Notez que vous ne pouvez pas utiliser des paramètres de liaison plusieurs fois.

Si une variable indiquée n'existe pas, aucune valeur ne pourra être remplacée. Dans ce cas, le nom de la variable est utilisé, ce qui peut provoquer une erreur lors de la résolution de la variable.

Les paramètres sont numérotés automatiquement et ne peuvent pas être modifiés. Pour supprimer des paramètres de liaison spécifiques, sélectionnez-les et tapez sur la touche SUPPR.

Vous pouvez utiliser des noms de variables comme paramètres de liaison, avec la valeur de votre choix.

Les types de données et les formats de saisie suivants sont pris en charge pour les paramètres de liaison :

• Date : aaaa-mm-jj
• Heure : hh:mm:ss
• Horodatage : aaaa-mm-jj hh:mm:ss
• String : chaîne de caractères au choix
• Booléen : valeurs possibles: 0 / 1 ou vrai / faux
• Nombre : pas de séparateur des milliers, un point en tant que séparateur de décimale

Les autres types de champ de la base de données et les autres formats ne sont pas pris en charge. Les types de données ne sont pas convertis (pas de conversion d'horodatage à date). Si une valeur non valide est insérée, une erreur survient lors de l'exécution de la commande SQL.

Définition du contenu de la colonne résultat.

La première colonne affichée dans l'aperçu est la colonne résultat. Les autres colonnes contiennent les valeurs des colonnes de la base de données qui ont été retournées par la requête SQL. La colonne de résultat peut se composer d'une combinaison des colonnes de valeurs et d'autres caractères au choix. Ceci est défini par le format du résultat.

Les numéros de colonne qui ont été indiqués entre accolades { } dans le champ Format du résultat sont remplacés par la valeur de la colonne concernée.

Par exemple :
Colonne de valeurs 1 : JOB1
Colonne de valeurs 2 : WIN01
Format du retour : {1}_{2}
Colonne de résultat : JOB01_WIN01

La colonne de résultat correspond à la première colonne de valeur si aucun format du résultat n'est indiqué.

Les limitations des variables (valeur min., valeur max. et limiter le texte) n'influencent pas la colonne de résultat, mais uniquement la première colonne renvoyée. Si la valeur de cette colonne dépasse la plage autorisée, la ligne en question est ignorée et n'est pas disponible via l'objet variable.

Exécute les instructions SQL et affiche le résultat dans une nouvelle fenêtre. Ainsi, les instructions SQL sont vérifiées et d'autres erreurs peuvent être identifiées (par exemple, le type de données de l'objet variable ne correspond pas à celui de la base de données) .

L'agent de base de données envoie les données pour l'aperçu dans un message à l'Automation Engine. Une erreur survient si ce message dépasse la longueur de message maximale acceptée par un processus serveur (paramètre MaxMsgSize= dans le fichier INI de l'Automation Engine, valeur par défaut : 3145 728 octets). Dans ce cas, limitez le résultat à l'aide d'un nombre de lignes maximal ou à l'aide d'instructions SQL.

Champ texte pour spécifier des instructions SQL. Ces instructions SQL permettent de déterminer les enregistrements de données de la base de données AE qui servent de valeurs de variables.

Exemple : select * from OH

Pour exécuter des instructions SQL, le type de base de données AE utilisé doit être sélectionné : SQL Serveur, Oracle ou DB2. Les instructions SQL restent enregistrées pour chaque type de base de données.

Notez que les instructions SQL ne sont pas vérifiées. Vous pouvez même modifier ou supprimer des entrées de la base de données.

AE ne vérifie pas si ces commandes SQL contiennent des erreurs ou sont dangereuses. Elles sont passées à la base de données sans vérification. Une erreur d'exécution ne survient donc que lors de l'accès à la base de données, c'est à dire lors de la résolution des variables.

Notez que pour utiliser des variables prédéfinies ou d'autres objets variable dans les instructions SQL, le paramètre VAR_SECURITY_LEVEL (UC_SYSTEM_SETTINGS) doit être défini en conséquence. Sinon, les variables ne sont pas remplacées (par défaut) et une erreur de base de données se produit.

Taille maximale : 4096 caractères

Définition du contenu de la colonne résultat.

La première colonne affichée dans l'aperçu est la colonne de résultat. Les autres colonnes contiennent les valeurs des colonnes de la base de données qui sont retournées par la requête SQL. La colonne de résultat peut se composer d'une combinaison des colonnes de valeurs et d'autres caractères au choix. Ceci est défini par le format du résultat.

Les numéros de colonne qui ont été indiqués entre accolades { } dans le champ Format du résultat sont remplacés par la valeur de la colonne concernée.

Par exemple :
Colonne de valeurs 1 : JOB1
Colonne de valeurs 2 : WIN01
Format du résultat : {1}_{2}
Colonne de résultat : JOB01_WIN01

La colonne de résultat correspond à la première colonne de valeur si aucun format du résultat n'est indiqué.

Les limitations des variables (valeur min., valeur max. et limiter le texte) n'influencent pas la colonne de résultat, mais uniquement la première colonne renvoyée. Si des valeurs de cette colonne dépassent la plage autorisée, les lignes en question sont exclues et ne sont pas disponibles via l'objet variable.

Exécute les instructions SQL et affiche le résultat dans une nouvelle fenêtre. Ainsi, les instructions SQL peut être vérifiées et d'autres erreurs peuvent être identifiées (par exemple, le type de données de l'objet variable ne correspond pas à celui de la base de données).

Instructions SQL utilisées pour sélectionner certains éléments de la base de données qui servent de valeurs de variables.

Les variables qui sont indiquées directement dans SQL ne sont pas remplacées. Pour inclure des variables, utilisez les paramètres de liaison.

Taille maximale : 4096 caractères

Tableau contenant les paramètres de liaison.

Les paramètres de liaison permettent d'ajouter des valeurs de variables dans les commandes SQL. Vous pouvez utiliser des variables de script, des variables d'objet, des variables prédéfinies et des caractères de remplacement pour les objets VARA que vous saisissez dans cette table. Chaque ligne représente un paramètre de liaison.

La variable VAR_SECURITY_LEVEL (UC_SYSTEM_SETTINGS) n'impose aucune limitation.

Dans les instructions SQL, vous devez utiliser le caractère ? à chaque emplacement où la valeur remplacée d'un paramètre de liaison doit être insérée. Un paramètre de liaison doit exister pour chaque ?. Assurez-vous de maintenir l'ordre correct du tableau. Notez que vous ne pouvez pas utiliser des paramètres de liaison plusieurs fois.

Si une variable indiquée n'existe pas, aucune valeur ne pourra être remplacée. Dans ce cas, le nom de la variable est utilisé, ce qui peut provoquer une erreur lors de la résolution de la variable.

Les paramètres sont numérotés automatiquement et ne peuvent pas être modifiés . Pour supprimer des paramètres de liaison spécifiques, sélectionnez-les et tapez sur la touche SUPPR.

Vous pouvez utiliser des noms de variables comme paramètres de liaison, avec la valeur de votre choix.

Les types de données et les formats de saisie suivants sont pris en charge pour les paramètres de liaison :

• Date : aaaa-mm-jj
• Heure : hh:mm:ss
• Horodatage : aaaa-mm-jj hh:mm:ss
• String : chaîne de caractères au choix
• Booléen : valeurs possibles: 0 / 1 ou vrai / faux
• Nombre : pas de séparateur des milliers, un point en tant que séparateur de décimale

Les autres types de champ de la base de données et les autres formats ne sont pas pris en charge. Les types de données ne sont pas convertis (pas de conversion d'horodatage à date). Si une valeur non valide est insérée, une erreur survient lors de l'exécution de la commande SQL.

Définition du contenu de la colonne résultat.

La première colonne affichée dans l'aperçu est la colonne de résultat. Les autres colonnes contiennent les valeurs des colonnes de la base de données qui sont retournées par la requête SQL. La colonne de résultat peut se composer d'une combinaison des colonnes de valeurs et d'autres caractères au choix. Ceci est défini par le format du résultat.

Les numéros de colonne qui ont été indiqués entre accolades { } dans le champ Format du résultat sont remplacés par la valeur de la colonne concernée.

Par exemple :
Colonne de valeurs 1 : JOB1
Colonne de valeurs 2 : WIN01
Format du résultat : {1}_{2}
Colonne de résultat : JOB01_WIN01

La colonne de résultat correspond à la première colonne de valeur si aucun format du résultat n'est indiqué.

Les limitations des variables (valeur min., valeur max. et limiter le texte) n'influencent pas la colonne de résultat, mais uniquement la première colonne renvoyée. Si des valeurs de cette colonne dépassent la plage autorisée, les lignes en question sont exclues et ne sont pas disponibles via l'objet variable.

Exécute les instructions SQL et affiche le résultat dans une nouvelle fenêtre. Ainsi, les instructions SQL sont vérifiées et d'autres erreurs peuvent être identifiées (par exemple, le type de données de l'objet variable ne correspond pas à celui de la base de données) .

Définition des deux objets variable qui servent de sources de valeurs.

La variable 1 détermine le nombre de colonnes. Les valeurs des colonnes de référence des deux variables sont combinées en fonction de l'opération définie. La colonne de référence dépend de la source de la variable : colonne clé (dans les variables statiques), première colonne de valeurs (source de variables : SQL, SQL interne, Multi) ou bien la colonne Liste de fichiers (source de variables : Liste de fichiers). Les colonnes qui ne sont pas contenues dans la variable 2 ne possèdent aucune valeur pour les entrées correspondantes.

Si les deux objets variable contiennent des entrées du même nom, les valeurs de la variable 1 sont utilisées.

Notez que le type de données de la colonne de référence des variables source doit correspondre au type de données de la variable Multi. Sinon, une erreur survient ou les valeurs ne sont pas disponibles.

Définition du contenu de la colonne résultat.

La première colonne affichée dans l'aperçu est la colonne de résultat. La colonne de résultat affiche une combinaison des colonnes de valeurs et de tout autre caractère. Ceci est défini par le format du résultat.

Les numéros de colonne qui ont été indiqués entre accolades { } dans le champ Format du résultat sont remplacés par la valeur de la colonne concernée.

Par exemple :
Colonne de valeurs 1 : JOB1
Colonne de valeurs 2 : WIN01
Format du résultat : {1}_{2}
Colonne de résultat : JOB01_WIN01

Sans indication d'un format de résultat, la valeur des colonnes Résultat ou Clé est une présomption.

Les valeurs de la colonne de résultat doivent respecter les limitations de la variable (valeur min., valeur max.et limiter le texte à) ou correspondre au format de sortie ou au type de données. Sinon, la colonne de résultat ne contient aucune valeur.

Répertoire dont les noms de fichiers doivent être retournés comme liste de valeurs lors de l'accès à l'objet variable. Le répertoire être accessible sur l'hôte indiqué.

Par exemple pour une machine Windows :


C:\temp

Vous pouvez également limiter la liste aux fichiers ayant un nom ou suffixe donné. Pour configurer ces filtres, utilisez les caractères génériques : * représente plusieurs caractères, ? un seul caractère.

Par exemple :
C:\AUTOMIC\utility\temp\*.txt

Agent de système d'exploitation permettant l'accès au répertoire indiqué. La sélection d'un groupe d'agents n'est pas possible.
Le système utilise automatiquement l'agent de la tâche qui a déclenché l'accès à la variable (pour les transferts de fichiers : l'hôte source) si aucun hôte n'est sélectionné.

Une erreur d'exécution se produit si la variable est utilisée dans un objet auquel aucun agent ni Login n'a été attribué.

Si l'objet transfert de fichier est utilisé comme source : si vous n'attribuez pas d'hôte à la variable, l'hôte du système cible de l'objet transfert de fichier sera utilisé.

Si cette option est activée, l’agent de la tâche qui accède à la variable est utilisé.

Agent sur la machine où la commande doit être exécutée.

Ce paramètre déploie l'agent de la tâche qui accède à l'objet variable.

Si cette option est définie, l'agent de la tâche est utilisé. Si la tâche ne possède pas d'agent (par ex. pour les objets script), l'agent de la variable est utilisé (voir "Agent"). Si aucun agent n'est défini sur ces deux emplacements, une erreur survient lors de l'exécution de la variable.

Ce paramètre déploie le Login de la tâche utilisant la variable.

Si cette option est définie, l'objet Login de la tâche est utilisé. Si la tâche ne possède pas de Login (par ex. pour les objets script), celui de la variable est utilisé (voir "Login"). Si aucun objet Login n'est défini sur ces deux emplacements, une erreur survient lors de l'exécution de la variable.

Tableau pour la définition des commandes par système d'exploitation

Sous Windows, il ne s'agit pas de lignes batch. Ceci signifie que le programme spécifique à exécuter doit être défini. 

Exemples :
Lister les répertoires : cmd /c dir C:\temp
Exécuter un ping : ping localhost -n 10

Il est possible d'enregistrer des commandes pour plusieurs systèmes d'exploitation dans la même variable. Le système utilise automatiquement les commandes du système d'exploitation de l'agent approprié lors de la résolution des variables.

Dans les colonnes Nom d'OS et Version, il est possible de filtrer les noms (par ex. un UNIX déterminé) et la version du système d'exploitation. Ici aussi, les lignes adaptées à l'agent spécifié sont utilisées automatiquement lors de l'exécution de la variable.

La première ligne qui correspond au système d'exploitation, nom d'OS et version de l'agent est utilisée.

Notez qu'une variable de type Backend ne peut exécuter qu'une seule commande.

Sous UNIX, l'utilisateur spécifié dans l'objet Login doit avoir les droits pour exécuter la commande correspondante. Sous Linux, les droits root sont par exemple requis pour les commandes "chkconfig" et "runlevel".

Filtre sur le nom du système d'exploitation

Il est possible d'utiliser le caractère générique *. Il s'agit d'un caractère de remplacement pour un nombre de caractères au choix.

Le nom d'OS fait référence au nom du système d'exploitation de l'agent qui est affiché dans la colonne de la Supervision système > Agent > SW.

Filtre sur la version du système d'exploitation

La version fait référence à la version du système d'exploitation de l'agent qui est affiché dans la colonne de la Supervision système > Agent > SW.

Commande du système d'exploitation

Sous Windows, seules les commandes Powershell sont prises en charge.

Définition de la répartition du résultat dans les colonnes.

Syntaxe :
Nom de colonne :position de début(longueur) [ ;nom de colonne :position de début(longueur)  . . .] 

Nom de la colonne : nom de la colonne défini par l'utilisateur
Position de début : position du caractère à partir duquel la colonne commence.
Longueur : nombre de caractères qui définit la taille de la colonne.

Le point-virgule (;) ne doit être utilisé qu'entre des colonnes. Un point-virgule n'est pas nécessaire à la fin de la définition.

Vous devez définir au moins une valeur de colonne (minimum requis).

Par exemple :
process:1(20);pid:25(10)

l'exemple ci-dessus divise la sortie de la commande en deux colonnes :
La colonne process commence au premier caractère et contient 20 caractères, "pid" commence par au 25ème caractère et a une longueur de 10 caractères.

Définition du contenu de la colonne résultat.

La première colonne affichée dans l'aperçu est la colonne de résultat. La colonne de résultat peut se composer d'une combinaison de colonnes de valeurs et de tout caractère, ceci est déterminé par le format du résultat.

Les numéros de colonne qui sont indiqués entre accolades { } dans le champ Format de résultat sont remplacés par la valeur de la colonne concernée.

Par exemple :
Colonne de valeurs 1 : JOB1
Colonne de valeurs 2 : WIN01
Format du résultat : {1}_{2}
Colonne de résultat : JOB01_WIN01

Si aucun format du résultat n'est indiqué, la colonne de résultat correspond à la première colonne de valeurs.

Les valeurs de la colonne de résultat doivent respecter les limitations de la variable (valeur min., valeur max.et limiter le texte à) ou correspondre au format de sortie ou au type de données. Sinon, la colonne de résultat ne contient aucune valeur.

Liste les processus actifs.

La longueur maximale du nom de processus peut différer en fonction du système UNIX correspondant. Ajustez la longueur de la colonne de l'objet variable, si nécessaire.

Liste tous les utilisateurs du système d'exploitation

Windows : Active Directory pour Powershell doit être installé sur l'ordinateur approprié