Manuel Utilisateur > Objets > Liste alphabétique > Onglet Pré-conditions

Onglet Pré-conditions

Cet onglet permet de définir les conditions qui sont vérifiées avant l'exécution de la Tâche. Si une condition survient, les actions correspondantes sont exécutées.

La mise en oeuvre correspond à l'onglet "Post-conditions", également accessible dans les propriétés du Workflow. Les conditions et actions disponibles sont toutefois différentes. En outre, l'onglet Pré-conditions est traité plusieurs fois avant le lancement de la Tâche. Les "Post-conditions" ne sont traitées qu'une seule fois lorsque la Tâche est terminée.

Définition des conditions et des instructions

L'onglet est divisé en deux parties :

Les conditions et les instructions sont listées sur la partie de droite, selon la catégorie sélectionnée. La page de gauche comporte une zone vierge dans laquelle vous pouvez ajouter les conditions et actions de votre choix à l'aide de la fonction Glisser-déposer.

Pour ce faire, procédez comme suit:

Dans la partie de droite, effectuez d'abord une sélection selon que vous voulez ajouter une condition ou une instruction.
Sélectionnez ensuite l'entrée souhaitée tout en maintenant le bouton gauche de la souris enfoncé.
Déplacez le pointeur de la souris vers la partie de gauche.

Il est également possible de créer des instructions sans la condition correspondante. Dans ce cas, l'action est exécutée pour chaque vérification.

Vous pouvez également copier des blocs de conditions et d'instructions ainsi que tous les blocs subordonnés et paramètres renseignés et les ajouter dans l'onglet "Post-conditions". Pour ce faire, utilisez le raccourci clavier CTRL + C et CTRL + V.

Vous pouvez ajouter un grand nombre d'instructions et de conditions supplémentaires de votre choix dans chaque bloc de conditions. Il en résulte alors une profonde inclusion.

Certains paramètres doivent être spécifiés pour chaque bloc de conditions ou d'instructions. Exemple : l'Agent utilisé ou le statut à vérifier. Cliquez pour cela dans le bloc sur le nom du paramètre et indiquez les valeurs dans la boîte de dialogue qui s'ouvre.

Vous pouvez également utiliser des Variables prédéfinies comme valeurs de paramètres. Pour ouvrir la sélection de Variables, cliquez sur le nom de l'élément (= caractères en bleu à côté du champ) dans la boîte de dialogue des paramètres. La zone de saisie associée devient grisée et le bouton en bas à droite est activé; il permet d'appeler la boîte de dialogue de sélection des Variables.

Un menu accessible via l'icône est disponible pour chaque bloc. Vous disposez des options ci-dessous :

Toujours - Vérifier ou exécuter les conditions/instructions pour chaque évaluation. Les blocs sont marqués par l'icône .
Unique - Le bloc est traité une seule fois et est ignoré pour tous les autres cycles d'évaluation. L'icône en haut à droite devient .
Désactiver - Le bloc est toujours ignoré et est donc affiché en grisé. Cela s'applique à toutes les actions et les conditions subordonnées de ce bloc.
Couper/Coller/Supprimer - Déplacer/dupliquer ou supprimer le bloc
Ajouter bloc Sinon - Ajouter la condition Sinon (uniquement pour les conditions)

Il est également possible d'utiliser les variables Objet et PromptSet dans le cadre des Pré-conditions. Il suffit pour cela de s'assurer que les variables sont disponibles lors de l'ouverture des conditions / instructions. Lorsque les variables sont définies dans le Workflow via un ou plusieurs prédécesseurs, il faut tenir compte des points suivants :

Lorsque l'option "Générer à l'exécution" n'est pas activée pour la Tâche avec les Pré-conditions, elle ne doit pas l'être non plus pour les prédécesseurs définissant les variables.
La Variable ne peut être définie via le Post-Script (:PSET) du prédécesseur direct lorsque l'option "Générer à l'exécution" n'est pas activée pour la Tâche avec les Pré-conditions.

Veuillez noter que la valeur *OWN devrait être utilisée pour les conditions de l'Agent uniquement lorsque ce dernier n'a pas été défini uniquement via le Pré-Script. Sinon, la Tâche du Workflow reste en suspens avec le statut "En attente des pré-conditions".

Représentation des conditions / instructions

Les conditions et instructions sont représentées sous forme de blocs contenant un texte descriptif et les paramètres. Les paramètres ou leurs valeurs sont soulignés en bleu au sein du texte descriptif.

Les paramètres sont des valeurs ayant un impact sur les conditions ou les instructions (voir description ci-dessus).

Le texte descriptif des conditions / instructions commence par un mot clé écrit en majuscules. Il varie s'il s'agit d'une condition ou d'une instruction et en fonction de la position à laquelle elle se trouve.

Mot clé	Condition / instruction
SI	Condition la plus élevée
ET SI	condition intégrée à une autre condition.
ALORS	Première instruction par bloc
ET ALORS	Instructions suivantes
FINALEMENT	Instruction finale

Le texte des instructions contenues dans une branche ELSE commence par le terme ALORS.

Les instructions finales sont soulignées en vert dans la zone de sélection et de définition.

Evaluation

La vérification des conditions ou l'exécution des actions définies dans l'onglet Pré-conditions a lieu après le traitement de la Tâche précédente et une fois l'heure de lancement au plus tôt atteinte. La vérification (également appelée évaluation) est répétée dans l'intervalle de temps défini avec le paramètre CONDITION_CHECK_INTERVAL dans la Variable UC_SYSTEM_SETTINGS. Ce processus se termine lorsqu'une instruction finale ou une heure de lancement au plus tard est atteinte. La Tâche est d'abord lancée. Le tableau ci-après présente les actions "finales".

Attention: la Tâche ne peut jamais être lancée si l'onglet Pré-conditions ne contient pas d'instruction définitive ni d'heure de lancement au plus tard. Dans ce cas, le cycle d'évaluation est sans cesse répété. Si l'onglet est vierge, il est ignoré.

Si aucune condition ni instruction supplémentaire ne doit être vérifiée ou exécutée avec la fonction "Unique", la Tâche est également lancée!

La Tâche reçoit le statut "En attente de pré-conditions" pendant l'évaluation.

Les options suivantes sont disponibles dans le menu contextuel du moniteur de la Chaîne de traitements et de la Fenêtre d'Activités. Elles sont en relation avec l'onglet Pré-conditions:

Ré-évaluer les Pré-Conditions: n'est disponible que si le Workflow est bloqué par les pré-conditions de la Tâche (instruction: BLOCK). Lève le blocage et répète la vérification des conditions et des instructions.
Evaluer maintenant les Pré-Conditions: pour les Tâches ayant le statut "En attente de pré-conditions". Le cycle de vérification commence alors au début. Le compteur de blocs uniques n'est donc pas réinitialisé.
Ignorer Pré-Conditions: La vérification des pré-conditions est ignorée.

Les conditions peuvent être modifiées lors de l'exécution, comme toutes les autres propriétés, tant que la Tâche n'a pas encore été lancée.

Il est impossible de modifier cet onglet avec le script MODIFY_TASK!

La durée d'évaluation n'est pas incluse dans l'ERT de la Tâche, mais dans celui du Workflow!

Un rapport individuel est généré pour l'onglet Pré-conditions. Il contient des informations sur l'évaluation (dernière évaluation, durée d'évaluation, etc.).

Instructions

Nom de l'instruction	Description	Paramètres	Instruction finale
BLOCK	Donne le statut Bloqué à la Tâche	-) Texte de statut de la Tâche (facultatif) Si le paramètre contient plus de 32 caractères, le texte de statut est tronqué dans la fenêtre de détails de la Tâche. Le texte est en revanche affiché en entier dans le rapport.	Oui
CANCEL PROCESS FLOW	Interrompt le Workflow	-) Workflow qui doit être interrompu. Les valeurs "OWN", "Top" ou "Parent" sont autorisées. OWN - Workflow dans lequel la Tâche se déroule Parent - Workflow subordonné à *OWN Top - Workflow supérieur -) Interrompre également les Tâches du Workflow? Les valeurs "inclusif" ou "exclusif" sont autorisées.	Non
CHANGE QUEUE	Change la queue de la Tâche.	-) Nom de l'objet Queue	Non
CLEAR VARIABLE	Supprime l'entrée d'un objet Variable statique.	-) Nom d'un objet Variable -) Clé Si la clé commence par le caractère &, celui-ci est alors indiqué deux fois.	Non
EXECUTE OBJECT	Lance un objet quelconque dont le statut n'est pas vérifié. Dans le script de cet objet, les Variables UC_CAUSE - Tampon de lecture sont renseignées et peuvent être lues.	-) Nom d'objet -) Alias (facultatif) Nom qui doit être utilisé pour la Tâche à exécuter dans la Fenêtre d'Activités et dans les statistiques à la place du nom de l'objet. Longueur maximale: 200 caractères Caractères autorisés: A-Z, 0-9, $, @, _, . et # -) Paramètres... (facultatif) Ouvre une boîte de dialogue dans laquelle vous pouvez modifier les valeurs PromptSet de l'objet à exécuter. Cette action est possible uniquement lorsqu'un objet PromptSet a été affecté à l'objet. -) Attendre la fin de la Tâche? Les Variables de la Tâche du Workflow sont toujours héritées de l'objet exécuté.	Non
PUBLISH VALUE	Publier une valeur via une Variable d'objet. La Variable d'objet est créée lorsqu'elle n'est pas disponible. Sinon, seule une valeur est attribuée. Ensuite, la variable est mise à disposition du Workflow et des Tâches suivantes. Possède la même fonction que l'instruction SET VALUE, à la seule différence que la Variable d'objet est toujours transmise au Workflow.	-) Valeur -) Nom de la Variable Le nom de la Variable doit être indiqué sans le faire précéder du caractère &. Le nom est également affiché de cette manière dans le rapport "Post-conditions". Toutefois, l'accès à l'objet s'effectue avec le caractère &.	Non
RE-EVALUATE AT	Recommencer l'évaluation à partir d'un moment donné	-) Heure au format +JJ/HH:MM	Oui
RE-EVALUATE IN	Exécuter le cycle d'évaluation depuis le début après expiration d'un certain temps	-) Temps en minutes	Oui
RUN TASK	Lancer une Tâche sans vérifier les autres conditions		Oui
SET VALUE	Définition ou attribution de valeurs d'une Variable d'objet L'utilisation (excepté le post-traitement) de cette Variable d'objet suppose que le paramètre Générer à l'Exécution est activé dans l'objet correspondant, indépendamment du paramètre Etendue (Tâche ou Workflow). Le système a sinon accès à une Variable qui n'existe pas ou à l'ancienne valeur (lorsque la Variable est déjà définie dans l'objet).	-) Nom de la Variable Le nom de la Variable doit être indiqué sans le faire précéder du caractère &. Le nom est également affiché de cette manière dans le rapport "Pré-conditions". Toutefois, l'accès à l'objet s'effectue avec le caractère &. -) Valeur (facultatif) -) Etendue: Tâche ou Workflow	Non
SET VARIABLE	Indique une valeur dans un objet Variable statique. Les valeurs existantes sont écrasées.	-) Nom d'un objet Variable -) Clé Si la clé commence par le caractère &, celui-ci est alors indiqué deux fois. -) Colonne Valeurs possibles: 0 à 5 Si la valeur "0" est appliquée, la valeur est indiquée dans la colonne 1 et les autres colonnes sont réinitialisées! -) Valeur	Non
SKIP TASK	Ignore la Tâche sans vérifier les autres conditions	-) Texte de statut de la Tâche (facultatif) Si le paramètre contient plus de 32 caractères, le texte de statut est tronqué dans la fenêtre de détails de la Tâche. Le texte est en revanche affiché en entier dans le rapport.	Oui

Conditions

Nom de la condition	Description	Paramètres
CHECK ACTIVITIES	Vérifie combien de fois une Tâche avec un statut ou une zone de statut particuliers est présente dans la Fenêtre d'Activités.	-) Nom de l'alias ou de l'objet -) Correspond à "Plus grand", "Plus petit", "Egal" ou "Différent" -) Nombre d'exécutions de cet objet -) Statut Seuls les statuts pour lesquels la Tâche n'est pas encore terminée ou n'est pas interrompue (statuts Actif, Bloqué, Attendre et Arrêté) sont disponibles. ANY_ACTIVE - La Tâche est active ANY_BLOCKED - La Tâche est bloquée (code retour système : 1560, 1898) ANY_BLOCKED_OR_STOPPED - La Tâche a été arrêtée ou bloquée (code retour système : 1560, 1561, 1562, 1563, 1564, 1898) ANY_RUNNING - La Tâche est active et non en attente ANY_STOPPED - La tâche a été arrêtée (code retour système : 1561, 1562, 1563, 1564) ANY_WAITING - La Tâche est en attente WAITING_AGENT - La Tâche attend un Agent (code retour système : 1696) WAITING_AGENT_OR_AGENTGROUP - La Tâche attend un Agent ou l'Agent d'un groupe d'agents (code retour système : 1686, 1687, 1688, 1696) WAITING_AGENTGROUP - La Tâche attend l'Agent d'un groupe d'agents (code retour système : 1686, 1687, 1688) WAITING_EXTERNAL - La Tâche attend une dépendance externe (code retour système : 1690) WAITING_GROUP - La Tâche attend le démarrage d'un groupe (code retour système : 1710) WAITING_QUEUE - La Tâche attend un objet Queue (code retour système : 1684) WAITING_SYNC - La Tâche est en attente en raison de conditions Sync (code retour système : 1697)
CHECK CONNECTION	Vérifie si un Agent particulier est actif. Pour les Agents SAP et Base de données, un objet COnnexion peut également être indiqué. Cette condition possède la même fonction que l'élément de script SYS_HOST_ALIVE.	-) Agent -) Objet Connexion (en option) Pour ne pas indiquer d'objet Connexion, sélectionnez la valeur vide dans le champ de combinaison. La valeur par défaut <CONNECTION> n'est pas valide !
CHECK FILE	Vérifie s'il existe un fichier donné	-) Agent Si la valeur OWN est indiquée, l'Agent de la Tâche est utilisé (lors du Transfert de Fichiers de l'Agent source). Ce paramètre n'est pris en charge que pour les Jobs et les Transferts de Fichiers! Attention: la vérification des fichiers ne peut être exécutée que par les Agents du système d'exploitation! Ainsi, cela entraîne par exemple une erreur lorsqu'il s'agit d'un Job SAP pour cette Tâche et que vous sélectionnez l'Agent OWN ! -)Chemin et nom de fichier -) "Existe" ou "N'existe pas"
CHECK HISTORY	Vérifie si un objet avec un statut donné s'est terminé dans une période donnée. La période est exprimée en jours, heures et minutes et s'étend du moment présent dans le passé. L'instruction ne fonctionne pas pour les statistiques d'une version Automation Engine plus ancienne!	-) Nom de l'alias ou de l'objet -) Statut -) Jours -) Heure au format HH:MM
CHECK PROCESS	Vérifie si un processus donné fonctionne sur un ordinateur. Uniquement possible avec les plateformes Windows et UNIX !	-) Processus : PID (Processus ID) ou nom du processus Il est également possible d'indiquer seulement une partie du nom du processus, avec ou sans caractères génériques (). Lorsqu'une chaîne de caractères est saisie sans caractères génériques, la recherche s'applique malgré tout au nom du processus. -) Statut "Fonctionne" ou "Ne fonctionne pas" -) Agent Agent UNIX ou Windows -) objet Login Les attributs de la Tâche sont utilisés avec la valeur OWN pour l'Agent ou l'objet Login (possible uniquement pour le Transfert de Fichiers et les Jobs). Les valeurs de la source sont déterminées lors des Transferts de Fichiers.
CURRENT QUEUE	Vérifie la queue dans laquelle la Tâche fonctionne	-) Nom de l'objet Queue
CURRENT TIME	Vérifie si une heure donnée se situe avant ou après l'heure (physique) actuelle, convertie dans le fuseau horaire avec lequel la Tâche a été lancée.	-) "Avant" ou "Après" -) Heure de comparaison au format HH:MM:SS
TIME SINCE ACTIVATION	Vérifie le temps écoulé depuis l'activation de la Tâche	-) "Inférieur à" ou "Supérieur à" -) Durée au format HH:MM
USER DEFINED	Compare 2 valeurs l'une avec l'autre	-) Valeur 1 (littéral de script, Variables prédéfinies) -) Opérateur: '>', '>=', '=', '<','<=' ou '<>' -) Valeur 2 (littéral de script, Variables prédéfinies) Seules les Variables prédéfinies dont les valeurs sont disponibles au moment de l'accès sont donc résolues. Il est possible d'utiliser des Variables pour les valeurs du système, de l'objet et de l'objet Variable.