Variables STATIC

Les objets de variables STATIC enregistrent jusqu'à 5 valeurs pour une ou plusieurs clés nommées. Vous pouvez définir les valeurs manuellement avec un élément de scriptEgalement un type d'objet distinct dans l'Automation Engine. ou une action"Voir ""Action en cas de non-respect (AWI Service Orchestrator)""." de condition.

Cliquez pour développer

Les valeurs de variables statiques sont définies et saisies dans deux pages. La page principale VariablesVariables comportant les paramètres de configuration du système AE. vous permet de définir cinq valeurs pour la variable. La page Attributs vous permet de définir la variable elle-même, autrement dit, de déterminer son format et ses paramètres, ainsi que le comportement à adapter si la valeur de variable est introuvable.

Cette rubrique propose les informations suivantes :

Page Variables - Définir les valeurs d'objets variable statiques existants

Vous définissez des valeurs d'objets variable statiqueObjet variable avec le paramètre "Source" - "statique" : Les valeurs des Variables sont saisies par l'Utilisateur ou par un script et restent enregistrées dans l'objet. ;

Les éléments de script suivants, sont disponibles pour les objets variable statique et XML :

Saisir des variables statiques manuellement

Chaque entrée d'une ligne du tableau se compose d'une clé et de 5 valeurs max. Les valeurs autorisées dépendent du type de données et des paramètres de plage spécifiés dans la section Paramètres de variables.

Notez que la clé ne doit pas commencer par le caractère &. Sinon l'objet variable pourra être enregistré, mais une erreur surviendra lors de l'accès à ces lignes par un script.

Une clé peut contenir au maximum 200 caractères.

Selon le type de données sélectionnées dans le champ Type de données de la section Données et format, les plages de valeurs autorisées sont les suivantes:

Type de données

Longueur du contenu

Chaîne

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

Entre 0 et 2147483647

Horodatage

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

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

Le tri des valeurs dépend des paramètres de l'onglet Attributs. Par défaut, la colonne Clé est triée par ordre croissant.

Travailler dans la table Variables

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 .

Un éditeur est disponible pour les colonnes de valeurs des objets VARA statiques. Il permet une édition de contenu simple et conviviale. Cet éditeur est utile particulièrement pour la modification de valeurs longues.

Page Attributs - Définir l'objet variable

Spécifier des paramètres Données et format

Champ

Description

Type de données

Le type de données détermine le format de la valeur des variables dans la première colonne de valeurs. Les autres colonnes de valeurs utilisent toujours le type de données "Texte".

  • Texte : Chaîne de caractères alphanumériques. Les espaces vides à la fin sont supprimés, ceux du début sont conservés. Si la case Limiter la longueur n'est pas cochée, aucune limite ne sera appliquée à la longueur de la chaîne de caractères.

    Vous pouvez formater la chaîne de caractères ainsi :

    • Sélectionnez Limiter la longueur pour afficher le dialogue de saisie Longueur de texte max. vous permettant de limiter la longueur du texte.
      Valeurs possibles : 1 à 1024
    • Sélectionnez Majuscules pour convertir le texte de la variable en majuscules.
  • Nombre : Entier signé, c.-à-d. nombre entre 0 et 2147483647.

    Vous pouvez formater la chaîne de caractères ainsi :

    • Sélectionnez la liste déroulante Format de sortie pour choisir le mode d'affichage du nombre.
    • Sélectionnez Définir la valeur min. pour afficher le dialogue de saisie Valeur min..
      Valeurs autorisées : max. 16 chiffres avant et 16 chiffres après la virgule
    • Sélectionnez Définir la valeur max. pour afficher le dialogue de saisie Valeur max..
  • Heure : Le format de l'heure par défaut est hh:mm:ss. Vous pouvez :
    • Sélectionner un autre format dans la liste déroulante.
    • Définir une valeur minimum et maximum.
  • Date : Le format de date par défaut est aaaa-mm-jj. Vous pouvez :
    • Sélectionner un autre format dans la liste déroulante.
    • Définir une valeur minimum et maximum. Notez que vous ne pouvez pas définir de date avant le 01.01.1980 comme valeur minimum.
  • Horodatage : Le format d'horodatage par défaut est aaaa-mm-jj hh:mm:ss. Vous pouvez :
    • Sélectionner un autre format dans la liste déroulante.
    • Définir une valeur minimum et maximum. Notez que vous ne pouvez pas définir de date avant le 01.01.1980 comme valeur minimum.

Le format exact du type de données sélectionné (à l'exception de ''chaîne") peut être défini dans le champ Format de sortie.

Le type de données des valeurs disponibles dans la première colonne est vérifié. Le type de données de la variable doit correspondre à celui de la première colonne renvoyé par les commandes SQL, pour les sources ''SQL'' ou "SQL interne". Les données peuvent aussi être traitées à l'aide d'instructions SQL spécifiques. Une erreur se produit si des variables statiques doivent être enregistrées ou si le type de données ne correspond pas lors de l'accès à des variables dynamiques.

Notez les points suivants si vous modifiez le type de données d'un objet variable statique qui contient déjà des valeurs :

  • Vous pouvez modifier les types "Nombre", "Horodatage", "Heure" et "Date" en "Texte". Les valeurs sont converties sans aucune modification.
  • Un format de sortie doit être sélectionné si "Texte" a été modifié en "Nombre", "Horodatage", "Heure" ou "Date". Lors de l'enregistrement de l'objet variable, le système vérifie que les valeurs correspondent au format spécifié.
  • Vous ne pouvez pas modifier les types de données "Date", "Heure", "Nombre" et "Horodatage". Ils doivent être tout d'abord convertis en type de données "Texte" avant de pouvoir les modifier.

Le type de données des variables "Multi", "SQL" et "SQL interne" peut être modifié à n'importe quel moment.

Le type de données de la variable de scriptCaractères de remplacement d'une valeur dans un Script. en question ("float", "signed", "unsigned" ou "string") n'a pas d'importance pour les valeurs qui sont extraites à partir d'objets variable de type "Nombre" en utilisant l'élément de script GET_VAR. La valeur peut toujours être enregistrée. Les signes et les décimales sont supprimés lorsque le type de données de la variable de script ne les prend pas en charge. Si un autre type de données a été spécifié dans l'objet variable, les valeurs sont toujours transmises au script sous forme de "chaîne".

Format de sortie

Ce paramètre définit le format dans lequel les valeurs sont enregistrées dans l'objet variable (source : variables statiques) ou extraites dans la source de données (variables dynamiques).

Le contenu de ce menu de sélection dépend du type de données. Plusieurs formats différents sont disponibles pour chaque type de données (à l'exception du type ''chaîne").

Le format de sortie ne fait référence qu'à la première colonne. Pour les variables statiques, il s'agit de la colonne Valeur 1, pour les variables multi et base de donnéesUne base de données est un ensemble organisé de données qui comprend plusieurs structures de données pertinentes., il s'agit de la première colonne de base. Notez que les variables Multi utilisent la première colonne de base comme colonne de référence. Cela signifie que le format de sortie de la variable source peut avoir une incidence sur les valeurs extraites.

Le format de sortie des variables statiques pour un type de données déterminé est modifiable à tout moment. Les valeurs sont converties dans le nouveau format. Si les valeurs ne correspondent pas à l'ancien format, il n'est pas possible d'effectuer une conversion dans le nouveau format.

Le format dans lequel les valeurs sont saisies dans les variables statiques n'a pas d'importance tant qu'il s'agit d'un format pris en charge par AE pour le type de données en question. Les valeurs sont ensuite converties dans le format de sortie approprié.

Le type de données "texte" n'affiche pas ce champ.

Type de données Formats disponibles Format par défaut

Horodatage

  • AAAAMMJJHH24MISS
  • AAAA-MM-JJ HH:MM:SS

AAAA-MM-JJ HH:MM:SS

Date

  • JJ-MOI-AAAA
  • JJ-MOI-RR
  • MM-JJ-AAAA
  • AAAAMMJJ
  • MMJJRR
  • JJMMRR
  • MM-JJ-RR
  • MM/JJ/RR
  • AAMMJJ
  • AA.MM.JJ
  • AA-MM-JJ
  • AAAAMMJJ
  • AAAA.MM.JJ
  • AAAA-MM-JJ
  • JJMMAA
  • JJ.MM.AA
  • JJ-MM-AA
  • JJMMAAAA
  • JJ.MM.AAAA
  • JJ-MM-AAAA
  • MMJJAA
  • MMJJAAAA
  • MM/JJ/AA
  • MM/JJ/AAAA

AAMMJJ

Heure
  • HHMMSS
  • HH:MM:SS
  • HHMM
  • HH:MM
  • MMSS
  • MM:SS

HHMMSS

Nombre
  • 0.00
  • +0.00
  • -0.00
  • 0
  • +0
  • -0
  • 16 chiffres
16 chiffres

Certains formats de date contiennent "RR" comme caractères de remplacement pour l'année raccourcie. "AA" et "RR" acceptent différentes conventions de décompte des siècles sur la base des deux caractères de la date raccourcie.
"AA" : si le nombre se situe entre 00 et 80, le siècle actuel s'applique. Pour la plage allant de 81 à 99, c'est le siècle précédent. 
"RR" : si le nombre se situe entre 00 et 49, le siècle actuel s'applique. Pour la plage allant de 50 à 99, c'est le siècle précédent.

Exemple :
Format de date "JJMMAA'" et la date complète qui en résulte :
"010305" correspond au 01 mars 2005
"010365" correspond au 01 mars 2065
"010380" correspond au 01 mars 2080
"010385" correspond au 01 mars 1985

Exemple :
Format de date ''JJMMRR'" et la date complète qui en résulte :
"010305" correspond au 01 mars 2005
"010365" correspond au 01 mars 1965
"010380" correspond au 01 mars 1980
"010385" correspond au 01 mars 1985

Pour le type de données ''Heure'' ou ''Horodatage'', la valeur pour l'heure doit représenter un nombre à quatre ou six chiffres. Les décimales sont supprimées. Un nombre à quatre chiffres est converti en heures et minutes.

Exemple :
Type de données : Heure
Format de sortie : HH:MM:SS
Valeur de l'utilisateurDans Automation Engine, un utilisateur se réfère à une instance d'un objet utilisateur, mais c'est en général une personne qui travaille avec les produits Automic. Chaque utilisateur a son identifiant et un ensemble de droits d'accès aux différentes parties du système Automation Engine et à la suite de produits. Ces droits d'accès se présentent sous la forme d'autorisations et de privilèges dans Automation Engine, de rôles utilisateurs dans Decision, de droits EventBase et de droits des objets pour l'application Web ARA. Vous pouvez les gérer en central avec les fonctions de gestion des utilisateurs d'AWI. Reportez-vous aussi à la gestion des droits des utilisateurs. ou de la source de données : 1234, 1234.5, 123400, 12:34, 12:34:00
Valeur de variable qui en résulte : 12:34:00

Type de données : Horodatage
Format de sortie : AAAA-MM-JJ HH:MM:SS
Valeur de l'utilisateur ou de la source de données : 20110325 2201, 20110325 2201.5, 20110325 220100
Valeur de variable qui en résulte : 2011-03-25 22:01:00

Définir la valeur min.

Valeur min.

Applique une valeur minimale.

Le type de données "texte" n'affiche pas ces champs.

Définir la valeur max.

Valeur max.

Applique une valeur maximale.

Le type de données "texte" n'affiche pas ces champs.

Limiter la longueur

Longueur de texte max.

Applique un nombre maximal de caractères.

Valeurs autorisées : 1 à 1024

Si cette option est désactivée, la valeur est illimitée.

La colonne clé des objets VARA a une limite maximale de 200 caractères. Cette limite existe toujours et il est impossible de l'augmenter ou de la désactiver.

La colonne de résultats des variables dynamiques est illimitée. La longueur dépend des colonnes de valeurs.

Cette limite se réfère à la première colonne de valeurs pour les variables statiques et dynamiques. La clé ou la colonne de résultat n'est pas vérifiée.

Les valeurs qui dépassent la longueur maximale sont exclues.

Seul le type de données "texte" affiche ces champs.

Majuscules

Les minuscules dans les valeurs de variable sont automatiquement transformées en majuscules. Cela ne concerne que la première colonne de valeurs.

Seul le type de données "texte" affiche ce champ.

Trier par colonne

Spécifie la colonne dont les valeurs doivent être utilisées pour trier les saisies.

Options possibles : Clé, 1, 2, 3, 4, ou 5

Ordre de tri

Type de tri.

Options possibles : Descendant ou ascendant

Spécifier les paramètres de la variable

Champ

Description

Type Ce champ en lecture seule affiche le type de variable STATIC. Vous déterminez le type de variable au moment de la création de l'objet. Il ne peut pas être modifié une fois la variable définie.

Plage de validité

Détermine la plage de validité de la variable. Ce paramètre peut être utilisé pour simplifier le script destiné à lire ou écrire les valeurs de variables. La clé doit normalement être indiquée comme paramètre dans l'élément de script :PUT_VAR ou GET_VAR, ce qui rend difficile l'enregistrement de certaines valeurs de façon unique. Si aucune clé n'est définie dans le script, le système choisit automatiquement celle correspondant au paramètre de l'objet variable (tel que le nom de 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"".]" dans un job).

Spécifier des paramètres Accès au script

Vous pouvez spécifier un comportement à adopter lorsque le code est introuvable, via les cases d'option Si code introuvable.

Pour :

Choisir :

Affiche un message d'erreur si un objet tente d'accéder par script à un élément absent lors de l'exécution. Renvoie une erreur
N'utilise pas le résultat du format de sortie si " " Retourne les valeurs initiales

Lecture des valeurs d'objets variable avec la fonction de script GET_VAR

Les valeurs des objets variables statiques et dynamiques peuvent être lues à l'aide de la fonction de script GET_VAR.

Récupérer une liste de valeurs d'objets variable avec la fonction de script PREP_PROCESS_VAR

Utilisez la fonction de script PREP_PROCESS_VARpour accéder à une partie ou à toutes les entrées d'une variable. Ceci prépare le traitement d'une séquence de donnéesListe interne (Exemple : Sorties de console ou lignes d'un objet Variable), dont les lignes peuvent être accessibles grâce à une boucle PROCESS et l'élément de script GET_PROCESS_LINE. Les Séquences de données sont créées avec les éléments de script PREP_PROCESS*..

Utiliser du contenu numérique d'objets variable statiques dans les Cockpits

Le contenu numérique des variables statiques peut être utilisé dans les objets Cockpit.

Ajouter, éditer et supprimer des objets variables statiques avec des éléments de script

En plus de la gestion manuelle des objets variables statiques, vous pouvez également utiliser les éléments de scripts suivants :