Manuel Utilisateur > Objets > Liste alphabétique > IF - Workflows

IF - Workflows

L'onglet Logique propre à l'objet est disponible uniquement pour les Workflows de type IF et FOREACH et sa structure varie en fonction du type. Il permet de définir les Workflows, les dépendances et les propriétés de leurs tâches subordonnées. La structure spécifique de l'onglet Logique pour le type de Workflow IF et les autres particularités des Workflows IF sont décrites ci-dessous.

Le type de Workflow est déterminé lors de la création des objets.

L'onglet Logique est similaire à l'onglet workflow disponible uniquement pour les workflows standard. Les autres onglets sont identiques pour tous les Workflows, indépendamment du type.

Les tâches des Workflows IF ont les mêmes propriétés que les tâches des Workflows standard. Vous trouverez une description plus détaillée au chapitre Propriétés des objets.

Vous trouverez des informations sur l'affichage de cet onglet dans la description de l'onglet Workflow.

Informations générales

Les Workflows IF exécutent diverses tâches en fonction des conditions que vous avez spécifiées. L'objet START contient ainsi les conditions permettant de définir les propriétés. Après la boite START, on trouve deux branches parallèles dans lesquelles on peut ajouter des objets activables. Ces branches sont nommées branche True et branche False. La branche True ou la branche False est choisie en fonction de l'exécution ou non de conditions et de leur type. Les deux branches entraînent l'objet FIN.

La structure de l'onglet Logique est fixe et ne peut être modifiée. Cela signifie que les objets ne peuvent être qu'ajoutés aux lignes Vrai et Sinon et sont alors organisés en série. Il est impossible de créer d'autres ramifications ou d'établir des lignes individuelles. Lorsqu'une structure complexe s'avère nécessaire, des Sous-Workflows doivent être utilisés.

Les Workflows IF peuvent intégrer tous les objets activables (y compris d'autres Workflows IF) sauf les Schedules et Cockpits.

Les dépendances externes ne peuvent être utilisées dans les Workflows IF !

Les tâches de la branche à exécuter (True ou False) sont traitées et activées uniquement après évaluation des conditions. Les tâches de l'autre branche ne sont pas traitées. Elles sont affichées en blanc et avec le statut UNPROCESSED dans le Workflow. Aucune activité n'est créée et aucun RunID n'est attribué pour les tâches non exécutées.


Définition de Workflows IF

Définir une/des condition(s)

Afin de définir une ou plusieurs conditions pour un Workflow IF, ouvrez les propriétés de l'objet START et passez à l'onglet Condition. Cet onglet spécial est disponible uniquement pour l'objet START des Workflows IF.

Il est possible d'accéder aux propriétés via le menu contextuel ou en cliquant sur le symbole dans la case.

L'onglet Au plus tôt de l'objet START et dans les propriétés de toutes les tâches de Workflow sont identiques.

L'onglet Condition permet de déterminer la branche (True ou False) du Workflow IF à exécuter, et à quel moment elle doit s'exécuter.

Dans cet onglet, vous pouvez définir diverses conditions et actions qui sont traitées au démarrage du Workflow, avant le traitement des tâches subordonnées. Vous avez également la possibilité d'ajouter des conditions et des instructions dans d'autres blocs de conditions.

L'onglet Condition est similaire aux onglets Pré-conditions et Post-conditions disponibles dans les propriétés de toutes les tâches de Workflow. Les conditions, les actions, le résultat et les tâches concernées sont cependant différents.

Pour créer une instruction ou une condition, sélectionnez-la dans la zone à droite et effectuez un glisser-déposer dans la zone à gauche. Une boîte de dialogue s'affiche ensuite et permet de définir les paramètres et le comportement de l'instruction / condition. Certains paramètres doivent être renseignés, d'autres sont optionnels. En cliquant sur un paramètre, vous pouvez aussi le modifier ultérieurement.

L'instruction finale RUN PATH met un terme à la vérification et démarre la branche True ou False (en fonction de la définition du paramètre).

En cas d'absence d'action finale dans l'onglet Condition, le workflow s'interrompt.

Il est également possible de définir des instructions contenues dans aucune condition et donc toujours exécutées.

Le traitement et le résultat de cet onglet sont journalisés dans le rapport d'activation du Workflow.

Instructions

Nom de l'instruction Description Paramètres Instruction finale
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 s'exécute
Parent - Workflow subordonné à *OWN
Top - Workflow supérieur

-) Interrompre également les tâches du Workflow ?
Valeurs possibles : "Inclusif" ou "Exclusif"

Oui
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 de la tâche qui doit être utilisé à la place du nom de l'objet dans la fenêtre des activités et dans les statistiques .

Longueur maximale : 200 caractères
Caractères autorisés : A-Z, 0-9, $, @, _, -, ..

-) 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 passées à l'objet exécuté.

Non
RUN PATH

Démarre les tâches de la branche True ou False.

Achève l'évaluation des conditions et actions de cet onglet immédiatement et ignore les tâches de l'autre branche.

Disponible uniquement dans les propriétés de l'objet START des Workflows IF !

-) True / False
Indique quelle branche doit être exécutée.

-) Alias
Le nom qui représente la branche Vrai dans l'onglet Workflow. Vous pouvez utiliser une valeur de votre choix.

Oui
SET VALUE

Définition ou attribution de valeurs d'une Variable d'objet

Pour utiliser cette variable d'objet, vous devez activer l'option Générer à l'exécution (excepté dans le post-traitement) indépendamment des paramètres qui sont définis dans la tâche ou le 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

Conditions

Nom de la condition Description Paramètres
CHECK ACTIVITIES Vérifie combien de fois une tâche est disponible dans la fenêtre des activités avec un statut ou un ensemble de statuts particuliers.

-) 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 ni interrompue (statuts Actif, Bloqué, conditions d'attente et d'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 (codes de retour du système: 1560, 1561, 1562, 1563, 1564, 1898)
  • ANY_RUNNING : la tâche est active et non en condition d'attente
  • ANY_STOPPED : la tâche a été arrêtée (codes retour du système: 1561, 1562, 1563, 1564)
  • ANY_WAITING : la tâche est en condition d'attente
  • WAITING_AGENT : la tâche attend un agent (code retour du système: 1696)
  • WAITING_AGENT_OR_AGENTGROUP : la tâche attend un agent ou un agent d'un groupe d'agents (codes retour du système: 1686, 1687, 1688, 1696)
  • WAITING_AGENTGROUP : la tâche attend un agent ou un agent d'un groupe d'agents (codes retour du système: 1686, 1687, 1688)
  • WAITING_EXTERNAL : la tâche attend une dépendance externe (code retour du système: 1690)
  • WAITING_GROUP : la tâche attend un groupe pour démarrer (code retour du système: 1710)
  • WAITING_QUEUE : la tâche attend un objet queue (code retour du système: 1684)
  • WAITING_SYNC : la tâche attend une condition en raison des conditions Sync (code retour du 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! Une erreur apparait si la tâche est un job SAP et que vous sélectionnez *OWN pour l'agent.


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

Cette condition ne fonctionne pas pour les statistiques d'une version Automation Engine antérieure.

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

La valeur *OWN pour l'agent ou l'objet Login indique que les attributs de la tâche sont utilisés (possible uniquement pour le transfert de fichiers et les jobs). Les valeurs de la source sont récupérées lors des transferts de fichiers.

.

CURRENT TIME Vérifie si une heure donnée se situe avant ou après l'heure (physique) actuelle, convertie dans le fuseau horaire utilisé pour démarrer cette tâche.

-) "Avant" ou "Après"

-) Heure de comparaison 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.

Ajouter des tâches

Pour ajouter des tâches à un Workflow IF, glissez-déposez un ou plusieurs objets de l'exploreur dans la branche concernée (True ou False) du Workflow ouvert.

Notez que vous ne pouvez pas lier les tâches manuellement. Les tâches sont liées automatiquement les unes aux autres quand elles sont ajoutées. Le Traceur de Ligne n'est donc pas disponible dans l'onglet Logique !

Supprimer des tâches

Sélectionnez les tâches à supprimer dans la branche True ou False et utilisez la commande du menu contextuel Supprimer ou la touche Suppr.

Veuillez noter que les lignes sont fixes dans les Workflows IF et ne peuvent donc être supprimées !

Déplacer les tâches

Vous pouvez changer l'ordre dans lequel les tâches sont arrangées comme vous voulez. Vous pouvez aussi déplacer des tâches dans une autre branche.

Notez que les tâches d'une branche ne peuvent être arangées qu'en série.


Exécution

Modification de Workflows IF actifs

Les modifications des Workflows actifs sont également disponibles pour les Workflows de type IF et FOREACH, mais avec les restrictions suivantes :

Simulation

La branche qui présente la plus longue durée totale est utilisée pour le calcul de simulations.

Redémarrage

Lors de la reprise, les conditions / instructions de l'objet START sont à nouveau évaluées. Par conséquent, en fonction des conditions et des circonstances qui peuvent se produire, il est possible que l'autre branche de tâches soit exécutée. La reprise fonctionne alors comme un démarrage normal.