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 :
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.
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).
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 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 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 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 |