Manuel Utilisateur > Objets > Liste alphabétique > Utilisation d'objets Variable

Utilisation d'objets Variable

L'utilisation d'objets Variable est possible à plusieurs emplacements du système AE. Dans ce cadre, quelques spécificités doivent être observées.

Les objets Variable et leurs valeurs peuvent être utilisés aux emplacements suivants :

Utilisation directe dans les objets

Avec les Variables prédéfinies, il est possible d'utiliser des valeurs d'objets Variable lors de l'exécution dans des objets exécutables. On se sert pour cela du nom de Variable suivant, composé à partir du nom de l'objet VARA :
{ Objet Variable [, Clé [, Numéro de colonne ]] }

Ce caractère de remplacement est remplacé par la valeur correspondante de l'objet Variable lors de l'exécution de l'objet. La Clé et le numéro de colonne sont facultatifs. Si aucune colonne précise n'est indiquée, la valeur se réfère automatiquement à la colonne de résultat (pour les Variables dynamiques) ou à la première colonne de valeurs (pour les Variables statiques). Lorsque la Clé n'est pas indiquée, la première ligne est utilisée.

Les Variables prédéfinies peuvent être ajoutées dans l'Interface Utilisateur via le dialogue Sélection de Variables.

Le comportement adopté lorsque l'objet Variable indiqué ou la Clé/Colonne est introuvable peut être déterminé par le paramètre VARA_ERROR_ON_REPLACEMENT dans la Variable UC_CLIENT_SETTINGS. Par défaut, le processus s'interrompt.

L'utilisation de ce caractère de remplacement n'est pas possible dans les onglets Formes ! Dans les formes, seules les Variables prédéfinies pour les valeurs système et objet sont prises en charge.

Le caractère de remplacement pour les objets Variable n'est pas pris en charge dans le script ! L'accès aux objets Variable est possible avec l'élément de script GET_VAR. Dans ce cadre, les valeurs des Variables dynamiques sont toujours directement déterminées par la source de données. L'utilisation des scripts :PUT_VAR, :PUT_VAR_COL et :DELETE _VAR n'est possible que pour les Variables statiques.

Calcul de Variables dynamiques

Lors du calcul des objets Variable dynamique, les valeurs sont directement récupérées à partir de la source de données (base de données, Variable, Agent) et mises à la disposition de l'objet. Ce processus est réalisé pour l'accès à chaque Variable, car les valeurs ne sont pas enregistrées dans l'objet. Le même comportement s'applique à la reprise des Tâches.

Le calcul se fait lors de la génération de la Tâche qui utilise la Variable et dépend donc du paramètre "Générer à l'Exécution".

Lors de la résolution des Variables AE, elles sont tout d'abord recherchées dans le Client actuel, avant d'accéder au Client système.

Veuillez noter qu'aucun calcul ne se produit lorsqu'un attribut est lu avec l'élément de script GET_ATT qui contient un caractère de remplacement de Variable. La valeur de l'attribut est récupérée comme indiqué.

Si aucun Agent n'est disponible lors de l'exécution pour les types de Variable "SQL' et "Liste fichiers", la Tâche passe à un statut d'attente ("Attendre le service de Variable"). En cas d'indications de répertoire ou d'instructions SQL non valides, la Tâche s'interrompt avec une erreur. Veuillez donc vérifier les paramètres de l'objet Variable et vous assurer que l'Agent a été démarré.

Statut de la Tâche Description
Calcul de Variables Les objets Variable dynamique qui sont utilisés dans l'objet sont en train d'être calculés.
Attendre la poursuite du calcul de Variable Statut d'attente d'une Tâche qui ne peut pas exécuter le calcul de Variables dynamiques, car soit l'Agent ou la source de données n'est pas disponible, soit des données incorrectes ont été saisies dans l'objet Connexion.

Les Tâches au statut "En attente de calcul de Variable" ne peuvent pas être interrompues ! Dans ce cas, vérifiez si l'Agent est actif et si les paramètres dans les objets correspondent (en fonction du type de Variable : objet Variable, Login et/ou Connexion).
Le calcul de Variable se poursuit dès que l'Agent est à nouveau actif. Si le problème se situait au niveau de l'objet Connexion ou de la base de données (pour les Variables avec la source SQL, la vérification est répétée selon l'intervalle de temps défini avec VARIABLE_SERVICE_CHECK_INTERVAL (UC_SYSTEM_SETTINGS).

Attributs pour les Variables prédéfinies

La liste suivante montre les attributs d'objet qui prennent en charge l'utilisation des caractères de remplacement pour les objets Variable.

Attributs généraux

[ Attributs généraux ] [ Attributs Transfert de Fichier ] [ Attributs d'Evènement ] [ Attributs spécifiques au Job ]

Attribut Nom d'attribut Types d'objets
ARCHIVE_KEY1 Index d'archivage 1 CALL, CPIT, EVNT, JOBF, JOBG, JOBP, JOBQ, JOBS, JSCH, SCRI
ARCHIVE_KEY2 Index d'archivage 2 CALL, CPIT, EVNT, JOBF, JOBG, JOBP, JOBQ, JOBS, JSCH, SCRI
ATTACH_FILE Joindre le fichier CALL
ATTACH_REPORTS_RUNID Joindre les rapports à partir de CALL
AUTO_DEACT_ERROR_FREE Statut sans erreur JOBF, JOBP, JOBS
CALL_TEXT Message CALL
CO_RISING_NAME Escalade : Alerte CALL
CODE Code JOBS
FSC_HOST Ecraser l'hôte de la vérification (en option) - Hôte JOBF, JOBQ, JOBS
FSC_LOGIN Ecraser l'hôte de la vérification (en option) - Login JOBF, JOBQ, JOBS
HOST Hôte EVNT (système de fichiers, console), JOBS, JOBQ
INT_ACCOUNT, INT_ACC, K Compte interne CALL, EVNT, JOBF, JOBP, JOBQ, JOBS, JSCH, SCRI
LOGIN Login JOBS
MAX_RET_EXECUTE Evaluation des résultats par Tâche - Sinon JOBQ
MAX_RETCODE Code retour CALL, CPIT, EVNT, JOBF, JOBG, JOBP, JOBQ, JOBS, JSCH, SCRI
GROUP, S Groupe CALL, EVNT, JOBF, JOBP, JOBS, JSCH, SCRI
SUBJECT Concerne CALL
TIMEZONE Fuseau horaire CALL, EVNT, JOBF, JOBG, JOBP, JOBQ, JOBS, JSCH, SCRI

Attributs Transfert de Fichier

[ Attributs généraux] [ Attributs Transfert de Fichier ] [ Attributs d'Evènement ] [ Attributs spécifiques au Job ]

Attribut Nom d'attribut
FT_DST_CODE A - Code
FT_DST_FILE A - Fichier
FT_DST_FILE_ATTRIBUTES A - Attributs de fichier
FT_DST_HOST A - Hôte
FT_DST_LOGIN A - Login
FT_SRC_CODE De - Code
FT_SRC_FILE De - Fichier
FT_SRC_FILE_ATTRIBUTES De - Attributs de fichier
FT_SRC_HOST De - Hôte
FT_SRC_LOGIN De - Login

Attributs d'Evènement

[ Attributs généraux ] [ Attributs Transfert de Fichier ] [ Attributs d'Evènement ] [ Attributs spécifiques au Job ]

Attribut Nom d'attribut Type d'Evènement
EVENT_FILE_PATH Chemin Système de fichiers
EVENT_SOURCE Source (Windows uniquement) Console
OPERAND1_SQL_AGENT Valeur 1 - Hôte Base de données
OPERAND1_SQL_DATABASE_NAME Valeur 1 - Base de données Base de données
OPERAND1_SQL_LOGIN Valeur 1 - Login Base de données
OPERAND1_SQL_QUERY Valeur 1 - SQL Base de données
OPERAND1_SQL_SERVER_NAME Valeur 1 - Serveur Base de données
OPERAND1_STATIC_VALUE Valeur 1 - Valeur statique Base de données
OPERAND1_VARA_KEYWORD Valeur 1 - Clé Base de données
OPERAND1_VARA_NAME Valeur 1 - Variable Base de données
OPERAND2_SQL_AGENT Valeur 2 - Hôte Base de données
OPERAND2_SQL_DATABASE_NAME Valeur 2 - Base de données Base de données
OPERAND2_SQL_LOGIN Valeur 2 - Login Base de données
OPERAND2_SQL_QUERY Valeur 2 - SQL Base de données
OPERAND2_SQL_SERVER_NAME Valeur 2 - Serveur Base de données
OPERAND2_STATIC_VALUE Valeur 2 - Valeur statique Base de données
OPERAND2_VARA_KEYWORD Valeur 2 - Clé Base de données

Attributs spécifiques au Job

[ Attributs généraux ] [ Attributs Transfert de Fichier ] [ Attributs d'Evènement ] [ Attributs spécifiques au Job ]

  Attribut Nom d'attribut Plateforme
AGENT_ID Serveur Mbean - ID Agent JMX
DATA_SOURCE Connexion - Nom de Fichier Base de données
DATABASE_NAME Connexion - Base de données Base de données
ENTER_PARAMS, ENTER_PAR, EP Option d'Exécution - Paramètre en Entrée BS2000
ENTERPRISE_SERVER Paramètre de démarrage - Serveur Entreprise Siebel
GATEWAY_SERVER Paramètre de démarrage - Serveur Gateway Siebel
GCOS8_IDENT Paramètre de démarrage - IDENT GCOS8
GCOS8_JCLJOB Paramètre de démarrage - Job Include GCOS8
HOME_TERMINAL Paramètre de démarrage - Terminal virtuel NSK
INITIAL_CONTEXT_FACTORY Serveur Mbean - Initial Context Factory JMX
JCL_SOURCE Option d'exécution - Nom du fichier z/OS z/OS
JOB_CLASS, JC Option d'Exécution - Classe du Job BS2000
  JOB_NAME, JN Paramètre de démarrage/Option d'Exécution - Nom du Répertoire/Nom du Job BS2000, MPE, z/OS, OS/400, SAP, VMS
MPE_OTHER Option d'Exécution - Autre MPE
MPE_QUEUE Option d'Exécution - Queue MPE
MVS_ACCOUNT Option d'Exécution - Compte z/OS
MVS_JOB_PARAMS Option d'Exécution - Paramètres du Job z/OS
MVS_NOTIFY Option d'Exécution - Alertes z/OS
MVS_PROG_NAME Option d'Exécution - Nom Prog. z/OS
OA_APPL_NAME Responsabilité - Nom Court d'App. OracleApplications
OA_RESP_NAME Responsabilité - Clef OracleApplications
OS400_JOBD Option d'Exécution - Description du Job OS/400
OS400_JOBQ Option d'Exécution - File d'attente Job OS/400
OS400_RTGDTA Option d'Exécution - Donnée initiale OS/400
SAP_DST_SYSTEM Paramètre de démarrage - Système cible SAP
SAP_RECIPIENT Destinataire de la Liste - Adresse SAP
SERVER_NAME Connexion - Serveur Base de données
SERVER_URL Serveur Mbean - URL Serveur JMX
SIEBEL_SERVERS Paramètre de démarrage - Serveurs Siebel Siebel
UNIX_CMD Paramètre de démarrage - Commande UNIX
UNIX_SHELL_OPTIONS Paramètre de démarrage - Options du Shell UNIX
VMS_QUEUE_NAME Paramètre de démarrage - Nom de Queue VMS
WIN_CMD Paramètre de démarrage - Commande Windows
WIN_WORK_DIR Paramètre de démarrage - Répertoire de travail Windows