Automation Engine. Exemples. Version: Date: Automic Software GmbH

Transcription

1 Automation Engine Exemples Version: Date: Automic Software GmbH

2 ii Copyright Copyright La marque Automic et le logo Automic sont des marques déposées appartenant à Automic Software GmbH (Automic). L'utilisation de toutes les marques déposées nécessite une autorisation explicite écrite et est soumise aux conditions de la licence. Les logiciels et/ou le programme sont la propriété protégée de la société Automic. L'accès et l'utilisation de ces derniers sont soumis à des conditions de licence devant être approuvées par écrit. Les logiciels et/ou le programme sont également protégés par des droits de reproduction par des contrats internationaux ainsi que par les lois nationales et internationales. Un accès et/ou une utilisation non autorisés peuvent entraîner des poursuites civiles et pénales. La copie non autorisée et d'autres formes de reproduction partielle ou totale, la décompilation, la reproduction, la modification, ou le développement de produits dérivés du logiciel sont strictement interdits. Le non-respect de ces conditions peut entraîner des poursuites pénales. Sous réserve de modifications. Aucune responsabilité ne sera acceptée pour toute modification, omission, erreur d'impression ou de production. Toute reproduction, totale ou partielle, est strictement interdite. Copyright Automic Software GmbH. Tous droits réservés.

3 Automation Engine iii Table des matières 1 Résumé Niveau débutant Niveau avancé 1 2 Dialogue de saisie dynamique pour l'activation de Jobs Exemple Définition d'un masque de saisie Objet script Job Windows Résultat 8 3 Contrôle du comportement de Transfert de Fichier par le biais de conditions dans un Workflow Exemple Résultat 13 4 Exécution d'un MBean Exemple 14 5 Remplissage d'un Groupe Calendrier Exemple 16 6 Alerte avec texte du message variable Exemple 21 7 Affichages à l'aide du Cockpit Exemple 24 8 Maintenance de la base de données avec options Exemple 28 9 Définir un statut de fin à cause du contenu d'un rapport Exemple Détermination du message et du numéro de l'erreur Exemple Réaction à des Evènements externes Exemple Synchronisation de Tâches actives Exemple 40 Glossaire 43

4 1 Chapter 1 Résumé 1 Résumé Ce chapitre contient des exemples expliquant les applications des scripts à l'aide de scripts et d'illustrations. A partir du Service Pack 2 de la version 9.00A, les objets prédéfinis sont préparés au moyen de conteneurs Transport. Vous trouverez une liste de ces Objets dans le document Run Book Templates. Chaque exemple explique le déroulement et apporte les informations suivantes : Objectif - Brève description du but de l'exemple. Objets utilisés - Types d'objet apparaissant dans l'exemple. Scripts utilisés - Nom des instructions et des fonctions de script utilisées. Attention : chaque description de script (voir le manuel de l'utilisateur) doit comporter un lien vers les exemples dans lesquels il apparaît. Vous pouvez donc trouver rapidement un exemple de l'application recherchée. Nous vous conseillons d'étudier les chapitres d'introduction "Premières étapes" et "Script - Introduction" avant de poursuivre la lecture de ce chapitre. Ils apportent les connaissances de base nécessaires pour mieux comprendre les exemples, ainsi que les documents liés Niveau débutant Exemple Alerte avec texte du message variable Affichages à l'aide du Cockpit Maintenance de la base de données avec options Description La notification par objet Alerte doit comprendre un texte dépendant de la Tâche qui l'appelle. Certaines informations sur le statut de l'agent et l'espace disque actuel de la machine s'affichent dans un Cockpit. L'archivage de la base de données UC4 doit être automatisé dans un Workflow. L'Utilisateur peut en entrer la configuration correspondante dans une boîte de dialogue Niveau avancé Exemple Description

5 Automation Engine 2 Dialogue de saisie dynamique pour l'activation de Jobs Contrôle du comportement de Transfert de Fichier par le biais de conditions dans un Workflow Exécution d'un MBean Création d'un masque de saisie permettant de sélectionner un ou plusieurs Agents sur lesquels un Job doit être exécuté. Les Agents qui peuvent être sélectionnés sont déterminés de façon dynamique à partir de la base de données UC4 lors de l'exécution. Un Transfert de Fichier doit être lancé via un Workflow. Il faut pour cela vérifier dans le Workflow s'il existe des fichiers source et cible et si les actions correspondantes sont activées. Le résultat de l'exécution d'un MBean doit être transféré pendant le traitement.

6 3 Chapter 1 Résumé Remplissage d'un Groupe Calendrier Définir un statut de fin à cause du contenu d'un rapport Détermination du message et du numéro de l'erreur Réaction à des Evènements externes Synchronisation de Tâches actives Un script charge les données des jours fériés allemands dans un objet calendrier. De nombreuses clés permettent une application universelle dans vos objets et, par conséquent, les entrées manuelles ne sont plus nécessaires. Le contenu précis d'un rapport de Job doit être analysé lorsque le statut final est défini en fonction du résultat. En cas d'erreur, le texte du message et le numéro correspondants doivent être demandés et transmis par e- mail. Lorsqu'un Evènement SAP est déclenché dans le système UC4, il doit s'afficher pour que l'utilisateur puisse y réagir. Les Jobs déjà actifs doivent être synchronisés manuellement.

7 Automation Engine 4 2 Dialogue de saisie dynamique pour l'activation de Jobs Objectif : Création d'un masque de saisie permettant de sélectionner un ou plusieurs Agents sur lesquels un Job doit être exécuté. Les Agents qui peuvent être sélectionnés sont déterminés de façon dynamique à partir de la base de données UC4 lors de l'exécution. De plus, un objet Queue et une commande du système d'exploitation doivent être définis dans le dialogue de saisie. Vous pouvez pour cela définir en toute confiance dans le dialogue de saisie la commande du système d'exploitation à exécuter et les ordinateurs sur lesquels elle doit l'être. Objets utilisés : PromptSet, Script, Job (Windows), Variable (interne SQL) Eléments de script utilisés: :SET, :PSET, :WHILE :ENDWHILE, :IF :ELSE :ENDIF, LENGTH, SYS_ HOST_ALIVE, ACTIVATE_UC_OBJECT, :PRINT, :DATA, :PUT_ATT Prérequis : Vous devez créer et utiliser des Variables propres à SQL (privilège et paramètre SQLVAR_ INTERNAL = Y dans la Variable UC4 UC_SYSTEM_SETTINGS requis) Cet exemple explique l'utilisation des objets PromptSet, des objets Variables dynamiques, des Variables prédéfinies et des tableaux de script. 2.1 Exemple La saisie des valeurs définies par l'utilisateur s'effectue via un objet PromptSet appelé via un objet script. Les objets Queue pouvant être sélectionnés et les Agents Windows sont recherchés dans la base de données UC4 à l'aide des objets Variables du type SQL interne. Après l'envoi du dialogue PromptSet, un Job est lancé sur chacun des Agents choisis Définition d'un masque de saisie Les objets PromptSet représentent un masque de saisie défini par l'utilisateur ; ils sont appelés via des objets activables. Les éléments d'un objet PromptSet permettent de saisir ou de sélectionner les valeurs, les valeurs autorisées ou sélectionnables étant issues d'un objet Variable (= Variable de référence). Ainsi, les objets Variables de référence doivent tout d'abord être créés : Créez deux objets Variables du type SQLI: VARA.SQLI.AGENT et VARA.SQLI.QUEUE. L'avantage des objets Variables du type SQL interne réside dans le fait que les valeurs sont déterminées de façon dynamique à partir de la base de données pendant l'exécution. Les valeurs actuelles sont ainsi toujours affichées dans l'élément PromptSet. Lorsqu'un nouvel Agent est ajouté, par exemple, il est automatiquement affiché lors de l'appel suivant du masque de saisie. Vous pouvez également naturellement utiliser des Variables statiques dont le contenu peut toutefois être géré manuellement. Une des Variables lit tous les Agents Windows, l'autre lit tous les objets Queue du Client actuel à partir de la base de données UC4. Ajoutez les instructions SQL suivantes dans les objets Variables si vous voulez utiliser une base de données MS SQL Server : VARA.SQLI.AGENT : select OH_Name from oh where oh_otype='host' and OH_HostAttrTypeDst='WINDOWS' order

8 5 Chapter 2 Dialogue de saisie dynamique pour l'activation de Jobs by OH_Name VARA.SQLI.QUEUE : select OH_Name from oh where oh_otype='queue' and OH_Client=&$CLIENT# and OH_ RefIdnr = '0' order by OH_Name Les instructions SQL doivent être modifiées en conséquence pour une autre base de données (Oracle ou DB2). Vérifiez ensuite les instructions SQL à l'aide de la fonction "Prévisualisation". Si les valeurs sont affichées sans erreur, les instructions fonctionnent. La Variable &$CLIENT# est une Variable prédéfinie qui est remplacée lors de l'exécution par le numéro du Client UC4 actuel. Pour résoudre cette Variable, le paramètre VAR_SECURITY_LEVEL = 1 (ou 2 ou 3) au moins est nécessaire dans la Variable UC4 UC_SYSTEM_SETTINGS. Créez ensuite un nouvel objet PromptSet avec le nom : PRPT.AGENT Ouvrez l'objet et allez dans l'onglet Designer. Vous pouvez maintenant déplacer les éléments PromptSet souhaités de la droite vers le milieu à l'aide de la fonction Glisser-déposer. Dans notre exemple, nous devons utiliser les éléments PromptSet suivants avec les propriétés citées: Eléments Description Propriétés

9 Automation Engine 6 Zone de texte Check-list Champ combiné Zone de texte Pour le nom du Job (prédéfini dans notre exemple) Permet de sélectionner un ou plusieurs Agents Windows Permet de sélectionner un objet Queue Saisie d'une commande de système d'exploitation Référence des données : UC_ DATATYPE_STRING Valeur requise Nom de Variable : Job# Légende : Job Verrouillé Valeur par défaut : JOBS.WIN.PROMPT Référence des données : VARA.SQLI.AGENT Valeur requise Sélection multiple, tableau Nom de Variable : agent# Légende : Agent Référence des données : VARA.SQLI.AGENT Nom de Variable : queue# Légende : Queue Valeur par défaut : &$QUEUE# (queue de l'objet script) Référence des données : UC_ DATATYPE_STRING (standard) Valeur requise Nom de Variable : jcl# Légende : JCL Valeur par défaut : dir C:\

10 7 Chapter 2 Dialogue de saisie dynamique pour l'activation de Jobs Objet script L'objet script permet d'appeler l'objet PromptSet, de lire ses valeurs et d'activer les Jobs. Créez un nouvel objet script: SCRI.START.JOBS Ouvrez l'objet et allez dans l'onglet "Variables & Prompts". Sous "PromptSets", sélectionnez l'objet PromptSet précédemment créé PRPT.AGENT. Si vous le souhaitez, vous pouvez écraser ici les valeurs standard des éléments PromptSet. Accédez à l'onglet Script et ajoutez les lignes suivantes : :SET&LEN# = LENGTH(&AGENT[]) :WHILE &LEN# > 0 : PSET&HOST# = &AGENT[&LEN#] : IFSYS_HOST_ALIVE(&HOST#) = "Y" : SET&RET# = ACTIVATE_UC_OBJECT(&JOB#,,,,,PASS_VALUES,&queue#,"&JOB#_ &HOST#") : P"Lance le Job &JOB# sur l'agent &HOST# avec le RunID &RET#" : ELSE : P"L'Agent &HOST# est inactif!" : ENDIF : SET&LEN# = &LEN# - 1 :ENDWHILE Ce script permet de déterminer combien d'agents ont été sélectionnés dans l'objet PromptSet. Les noms des Agents sont ensuite lus à partir du tableau du script. Si l'agent est actif, le Job Windows est lancé. Pour différencier les exécutions du Job dans les statistiques, un alias est utilisé pour les exécutions. Il se compose des noms du Job et de l'agent. Exemple : JOBS.WIN.PROMPT_WIN Job Windows Créez un objet Job Windows avec le nom ci-après: JOBS.WIN.PROMPT Ouvrez le Job et saisissez dans l'onglet Attribut un objet Login qui fonctionne pour tous les Agents Windows. Accédez ensuite à l'onglet "Pré-traitement" et ajoutez les lignes suivantes: : PUT_ATT HOST = &HOST# L'Agent qui a été transmis par l'objet script au moyen d'une Variable d'objet est ainsi activé de façon dynamique lors de l'exécution. Les lignes suivantes sont requises dans l'onglet Script pour exécuter la commande Windows définie par l'utilisateur : :DATA&jcl# :DATA"@set retcode=%errorlevel%" :DATA"@if NOT %ERRORLEVEL% == 0 goto :retcode"

11 Automation Engine Résultat L'objet script doit être lancé pour appeler la boîte de dialogue de saisie. Sélectionnez l'agent souhaité et un objet Queue. Saisissez dans le champ "JCL" une commande Windows qui doit être exécutée sur les ordinateurs de l'agent sélectionné. Dans ce cas, le Job JOBS.WIN.PROMPT est lancé dans la queue CLIENT_QUEUE sur les Agents WIN01, WIN02 et WIN03. La liste des fichiers de C:\ est demandée sur les ordinateurs de ces Agents. Vous pouvez ainsi exécuter rapidement et simplement des commandes définies par l'utilisateur sur plusieurs ordinateurs. s

12 9 Chapter 3 Contrôle du comportement de Transfert de Fichier par le biais de conditions dans un 3 Contrôle du comportement de Transfert de Fichier par le biais de conditions dans un Workflow Objectif : Un Transfert de Fichier doit être lancé via un Workflow. Il faut pour cela vérifier dans le Workflow s'il existe des fichiers source et cible et si les actions correspondantes sont activées. Objets utilisés : Workflow, Job (Windows), Transfert de Fichier Eléments de script utilisés: SYS_TIME_PHYSICAL, SYS_DATE_PHYSICAL, STR_CUT, STR_FIND, :SET, :PSET, :PRINT, :DATA, :PUT_ATT Cet exemple explique comment les conditions/instructions sont utilisées par les Tâches de Workflow. 3.1 Exemple Un Job Windows (JOBS.WIN.COND) d'un Workflow doit appeler la liste des fichiers d'un répertoire et l'écrire dans un fichier texte. Un Transfert de Fichier (JOBF.CONDITIONS) est ensuite activé via le Workflow, lequel transfère ce fichier sur un autre ordinateur. Le système vérifie ensuite dans le Workflow si des problèmes sont survenus lors du Transfert de Fichier et si les actions correspondantes sont activées. Cette vérification est possible via les onglets Pré-conditions et Post-conditions dans les propriétés des Tâches du Workflow. Le Transfert de Fichier ne doit ensuite être démarré que si le fichier source existe. Sinon, le Workflow est interrompu. Si le fichier cible existe déjà, le Transfert de Fichier est alors interrompu. Le statut d'interruption est reconnu par les conditions du Workflow et un Job qui modifie le nom du fichier cible (JOBS.WIN.COND2) est démarré. Le Transfert de Fichier est ensuite redémarré. Ce mécanisme permet de vérifier qu'aucune erreur n'est survenue et que les fichiers cibles ne sont pas écrasés. Créez d'abord le Workflow : JOBP.CONDITIONS Ouvrez-la et allez dans l'onglet "Variables & Prompts". Saisissez ici les Variables d'objet qui contiennent les valeurs pour les Tâches du Workflow. L'avantage réside dans le fait que les valeurs sont enregistrées à un endroit et peuvent ensuite être facilement modifiées. Nom de Variable Valeur Description &SAGENT# WIN01 Agent source du Transfert de Fichier &DAGENT# WIN02 Agent cible du Transfert de Fichier &SLOGIN# GLOBAL.LOGIN Objet Login pour la connexion à l'ordinateur source &DLOGIN# GLOBAL.LOGIN Objet Login pour la connexion à l'ordinateur cible &DFILE# C:\temp\test2.txt Chemin et nom du fichier cible

13 Automation Engine 10 Créez ensuite les objets du Workflow : Job Windows : JOBS.WIN.COND Ajoutez les lignes de script suivantes dans l'onglet Pré-traitement: :PUT_ATT HOST = &SAGENT# :PUT_ATT LOGIN = &SLOGIN# L'Agent et l'objet Login du Job sont ainsi activés lors de l'exécution. Les Variables d'objet sont héritées du Workflow. Veillez donc à ce que le paramètre Hérite du parent dans l'onglet "Variables & Prompts" soit activé en conséquence. Les lignes suivantes doivent être indiquées dans l'onglet script : :SET&DATE# = SYS_DATE_PHYSICAL("YYYYMMDD") :SET&TIME# = SYS_TIME_PHYSICAL("HHMMSS") :PSET&SFILE# = "C:\temp\&DATE#_&TIME#.txt" :DATA dir C:\ >> &SFILE# retcode=%errorlevel% NOT %ERRORLEVEL% == 0 goto :retcode Ce script permet de créer un fichier texte dont le nom se compose de l'heure et de la date actuelles. Ce fichier texte est rempli avec la liste de fichiers de C:\. Le nom du fichier texte est également enregistré dans une Variable d'objet et transmis au Workflow pour le Transfert de Fichier. Transfert de Fichier : JOBF.CONIDITONS Accédez à l'onglet Transfert de Fichier et activez l'option "Fichier Existe" - "Interrompre". Tous les autres attributs requis sont activés lors de l'exécution à l'aide des Variables d'objet héritées du Workflow. Les lignes ci-dessous sont donc nécessaires dans l'onglet script: :PUT_ATT FT_SRC_HOST = &SAGENT# :PUT_ATT FT_DST_HOST = &DAGENT# :PUT_ATT FT_SRC_LOGIN = &SLOGIN# :PUT_ATT FT_DST_LOGIN = &DLOGIN# :PUT_ATT FT_SRC_FILE = &SFILE# :PUT_ATT FT_DST_FILE = &DFILE# Enregistrez ensuite les objets et ajoutez-les au Workflow. Le Job doit être exécuté avant le Transfert de Fichier.

14 11 Chapter 3 Contrôle du comportement de Transfert de Fichier par le biais de conditions dans un Définissez maintenant les conditions et les instructions du Transfert de Fichier dans le Workflow. Ouvrez pour cela les propriétés de JOBF.CONDITIONS et accédez à l'onglet Pré-conditions. JOBF.CONDITIONS - Onglet Pré-conditions Définissez la condition CHECK FILE avec les paramètres suivants: Agent *OWN,nom de fichier : &SFILE#, condition : existe Définissez RUN TASK comme instruction principale. Un bloc Sinon doit également être ajouté dans CHECK FILE avec l'action CANCEL PROCESSFLOW (Etendue : *OWN, Tâches subordonnées : inclues). Attention : le paramètre Générer à l'exécution ne doit pas être activé dans l'objet Transfert de Fichier. Une erreur due à l'utilisation de la Variable d'objet &SFILE# dans les pré-conditions survient alors. JOBF.CONDITIONS - Onglet Post-conditions Vous définissez dans cet onglet les conditions qui vérifient si le Transfert de Fichier s'est terminé par une interruption (STATUS) et si le fichier cible existe (CHECK FILE). La Variable prédéfinie &$RESTART_ COUNT# indique la fréquence à laquelle la Tâche a été redémarrée via cet onglet. Pour éviter une boucle sans fin, la Tâche soit être interrompue après 3 reprises. Si ce nombre n'est pas encore atteint, le Job JOBS.WIN.COND2, qui renomme le fichier cible existant, est démarré. Aucune donnée n'est ainsi écrasée. Le Transfert de Fichier est ensuite répété (RESTART TASK). Le Job est démarré avec un alias qui se compose du nom de l'agent cible et de l'objet Login, séparés par un tiret. Ces valeurs sont lues à partir de l'alias dans le pré-traitement du Job et saisies dans les attributs.

15 Automation Engine 12 Créez enfin le Job Windows : JOBS.WIN.COND2 Ce Job modifie le nom du fichier cible et n'est démarré qu'en cas d'erreur via les propriétés du Workflow du Transfert de Fichier. Le script suivant de l'onglet Pré-traitement permet de lire l'agent et le Login à partir de l'alias et de les activer via :PUT_ATT. :SET&ALIAS# = &$ALIAS# :SET&STRPOS# = STR_FIND(&ALIAS#,'_') :SET&STRPOS# = &STRPOS#+1 :SET&LOGIN# = STR_CUT(&ALIAS#,&STRPOS#) :SET&STRPOS# = &STRPOS#-2 :SET&AGENT# = STR_CUT(&ALIAS#,1,&STRPOS#) :PUT_ATT HOST = &AGENT# :PUT_ATT LOGIN = &LOGIN# Les lignes de l'onglet script servent à renommer le fichier cible correspondant (nouveau nom de fichier = heure actuelle): :SET&TIME# = SYS_TIME_PHYSICAL("HHMMSS") :DATA rename "C:\temp\test2.txt" &TIME#.txt retcode=%errorlevel% NOT %ERRORLEVEL% == 0 goto :retcode

16 13 Chapter 3 Contrôle du comportement de Transfert de Fichier par le biais de conditions dans un Le nom du fichier cible est transmis de façon non dynamique au Job et peut donc le cas échéant être modifié manuellement Résultat Lorsque le Workflow JOBP.CONDITIONS est lancée, un fichier est créé sur l'ordinateur de l'agent WIN01 par un Job JOBS.WIN.COND. Le Transfert de Fichier doit transférer ce fichier de l'ordinateur (WIN01) vers un autre ordinateur (WIN02). Si le fichier source existe, le Transfert de Fichier n'est pas lancé. Si le fichier cible existe, le Transfert de Fichier est interrompu. Le fichier cible est ensuite renommé et l'opération répétée. Aucun fichier n'est ainsi écrasé et les données enregistrées sont conservées. Il est donc possible d'intercepter certaines erreurs et d'activer les actions correspondantes directement dans le Workflow en exécutant des vérifications définies.

17 Automation Engine 14 4 Exécution d'un MBean Objectif : Le résultat de l'exécution d'un MBean doit être transféré pendant le traitement. Objets utilisés : Job, Workflow et Variable Eléments de script utilisés : :ENDPROCESS, GET_PROCESS_LINE, GET_VAR, JMX_INVOKE, PREP_PROCESS_REPORT, :PROCESS, :PUT_VAR, R3_ACTIVATE_REPORT et R3_MODIFY_ VARIANT 4.1 Exemple A l'aide de l'agent JMX et des fonctions proposées par UC4, vous pouvez établir une connexion au serveur MBean et accéder à ses MBeans. Cet exemple montre comment exécuter un MBean. Le résultat est par la suite transmis à une variante dans SAP avec laquelle un rapport est alors exécuté. Variable En premier, vous avez besoin d'une Variable qui enregistre l'evènement d'exécution du MBean. Créez pour cela un objet Variable statique avec les attributs suivants : Source : Statique Type de donnée : Texte Plage de validité : Index libre Clef non trouvée : Valeur initiale Entrez également une Clef contenant la valeur du MBean. Jobs

18 15 Chapter 4 Exécution d'un MBean Créez ensuite un Job JMX. Sélectionnez la connexion au serveur MBean dans l'onglet de l'hôte, puis utilisez l'onglet "Forme" afin d'entrer la fonction pour l'exécution. L'exemple suivant présente un extrait de l'onglet Script : JMX_INVOKE OPERATIONNAME=conversionRate, MBEAN=UC4:type=CurrencyConverter, SIGNATURE="java.lang.String,java.lang.String", PARAMS="USD,EUR" Le MBean "UC4:type=CurrencyConverter" issu de l'exemple précédent détermine le taux de change dollar-euro et l'écrit dans le rapport de Job. Vous pouvez lire la valeur à l'aide de la fonction script PREP_ PROCESS_REPORT. Utilisez cet élément de script dans l'onglet Post-Script du Job JMX. En voici un exemple : :SET&HND# = PREP_PROCESS_REPORT("JOBS",, "REP",,"COL=DELIMITER", "DELIMITER=*:*") :PROCESS&HND# : SET&RET# = GET_PROCESS_LINE(&HND#0,2) : PUT_VAR VARA.CURRENCY_RATE,"RATE",&RET# :ENDPROCESS L'étape suivante consiste à créer un Job SAP. Celui-ci doit lire le taux de change dans l'objet Variable, modifier une variante et démarrer un rapport. Créez un Job SAP et entrez les instructions de traitement via l'onglet Forme ou directement dans l'onglet script. En voici un exemple : :SET&RATE# = GET_VAR(VARA.CURRENCY_RATE,"RATE") R3_MODIFY_VARIANT REPORT='Z_CURRENCY_ ABAP',VARIANT='VARIANTE1',SELNAME='RATE',KIND='P',LOW='&RATE#' R3_ACTIVATE_REPORT REPORT='Z_CURRENCY_ABAP',VARIANT='VARIANTE1' Attention, la valeur déterminée pour le paramètre LOW est issue de l'objet Variable. Workflow Créer enfin un Workflow contenant les deux Jobs. L'exécution du Workflow nécessite que le MBean utilisé soit enregistré auprès du serveur MBean. Utilisez pour ce faire la fonction script JMX_CREATE_MBEAN une seule fois. A l'inverse, JMX_ UNREGISTER_MBEAN supprime un MBean déjà enregistré.

19 Automation Engine 16 5 Remplissage d'un Groupe Calendrier Objectif : Un script charge les données des jours fériés allemands dans un objet calendrier. De nombreuses entrées de calendrier permettent une application universelle dans vos objets et, par conséquent, les entrées manuelles ne sont plus nécessaires. Objets utilisés : Groupe Calendrier, Variable, Script Eléments de script utilisés : ADD, :BEGINREAD... :ENDREAD, :DELETE_VAR, DIV, FORMAT, :IF... :ELSE... :ENDIF, MID, MULT, :PRINT, :PUT_VAR, :READ, :SET, :SET_CALE, STR_CAT, SUB, :WAIT, :WHILE... :ENDWHILE Auteur du script : Stefan Brede, LSV Gartenbau Exemple Cet exemple montre comment un objet Groupe Calendrier contenant les jours fériés en Allemagne commençant au peut être rempli pour une période que vous aurez choisie. Vous pouvez au besoin utiliser les Calendriers particuliers du Groupe Calendrier dans les Workflows, les Schedules, les Evènements et les Alertes. Variable Créez tout d'abord une Variable VAR_JOURS_FERIES avec les valeurs proposées habituellement. Cette Variable peut être vide, elle sera remplie automatiquement par le script suivant. Groupe Calendrier Créez un nouvel objet Groupe Calendrier avec le nom correspondant. Attention : seuls certains objets Groupe Calendrier sont listés dans la boîte de dialogue de saisie du Script (par exemple : BAYERN et BERLIN). Vous pouvez toutefois agrandir/ajuster cette liste en modifiant le Script afin de pouvoir remplir d'autres objets Groupe Calendrier. Script Pour la prochaine étape, nous avons besoin d'un objet script qui remplira le Groupe Calendrier. Ouvrez pour cela le document le plus proche et enregistrez son contenu dans un fichier XML : Script de remplissage du Groupe Calendrier Le script est disponible comme fichier XML et peut être chargé dans votre système UC4, après enregistrement, avec la commande Import. Exécutez pour cela la commande Importer à partir du menu contextuel ou du menu Fichier de l'interface Utilisateur et entrez le chemin du fichier à importer. Dans cet exemple, l'objet script "SCRI_REMPLIR_CALENDRIER est créé. Lors de son exécution, l'objet script vérifie d'abord si la Variable VAR_JOURS_FERIES contient des valeurs des années précédentes. Si oui, il les efface et adapte les entrées de la période de calendrier actuelle. Le script :BEGINREAD crée ensuite une fenêtre de saisie dans laquelle sont définis le Groupe Calendrier à remplir et sa période de validité. Veillez à ce que l'intervalle de temps choisi ne se trouve pas en dehors de la période de validité générale (sur la base des paramètres NOW_MINUS et NOW_PLUS de la Variable UC4 UC_CLIENT_ SETTINGS) pour les objets Groupe Calendrier. Si le Groupe Calendrier contient déjà des entrées du même nom, la période de validité de ces dernières s'applique. Il est par conséquent recommandé d'indiquer un nouveau objet Groupe Calendrier vierge!

20 17 Chapter 5 Remplissage d'un Groupe Calendrier La fenêtre de dialogue suivante nécessite la saisie des jours fériés de l'année en cours devant être repris dans la Variable VAR_JOURS_FERIES après l'effacement éventuel d'anciennes entrées de Groupe Calendrier par un script. Dans le script, les données des jours fériés sont calculées puis envoyées dans une fenêtre de dialogue pour confirmation. Si des modifications sont nécessaires, vous pouvez les faire à ce moment.

21 Automation Engine 18 Si toutes les données de jours fériés sont correctes, le tout est confirmé avec OK et le script peut continuer. L'objet Groupe Calendrier a maintenant ses jours fériés et un choix important d'entrées de calendrier, qui vous permettent de l'utiliser pour différents buts.

22 19 Chapter 5 Remplissage d'un Groupe Calendrier Entrées de calendriers : LUNDI, MARDI, MERCREDI, JEUDI, VENDREDI, SAMEDI, DIMANCHE JS_LU, JS_MA, JS_ ME, JS_JE, JS_VE Jour ouvert WEEKEND Jours fériés QUOTIDIENNEMENT JODA_01 JODS_01, JODS_02, JODS_03, JODS_04, JODS_05 Description Le jour de la semaine respectif du domaine de validité du Groupe Calendrier est affiché. Jour ouvert de la semaine respectif (lundi à vendredi) sans les jours fériés. Tous les jours ouverts situés dans le domaine de validité du Groupe Calendrier. Weekend, samedi et dimanche Tous les jours fériés définis dans le script Tous les jours du domaine de validité Dernier jour ouvert de l'année Dernier jour ouvert de la semaine, avant-dernier jour ouvert de la semaine, etc...

23 Automation Engine 20 JODS01, JODS02, JODS03, JODS04, JODS05 JODM_01 JODM_02 JODM_03 JODM_04 JODM_05 JODM01, JODM02, JODM03, JODM04, JODM05 Premier jour ouvert de la semaine, deuxième jour ouvert de la semaine, etc... Dernier jour ouvert du mois, avant-dernier jour ouvert du mois, etc... Premier jour ouvert du mois, deuxième jour ouvert du mois, etc... Nous vous conseillons de définir sur 50 secondes la valeur de la Variable UC4 UC_SYSTEM_ SETTINGS avec la clé SCR_LOOPCHK_TIME. La valeur par défaut, si une boucle est supposée dans le script, est de 5 secondes. Augmenter la valeur accélère le traitement du script.

24 21 Chapter 6 Alerte avec texte du message variable 6 Alerte avec texte du message variable Objectif : La notification par objet Alerte doit comprendre un texte dépendant de la Tâche qui l'appelle. Objets utilisés : Alerte Eléments de script utilisés : ACTIVATE_UC_OBJECT, :ADD_ATT, GET_ATT, :PUT_ATT, :PUT_ATT_ APPEND, :PUT_READ_BUFFER, :READ, STR_FIND, SYS_ACT_PARENT_NAME, SYS_ACT_ PARENT_NR et SYS_ACT_PARENT_TYPE 6.1 Exemple Les objets Alerte sont utilisés pour la notification par moniteur, ou SNMP. Il est plus pratique de créer un objet Alerte dont le texte contient des informations dépendant de la Tâche qui l'appelle. Cela vous permet une utilisation multiple de l'objet Alerte, dont le contenu s'adapte automatiquement. Tâche Utilisez les lignes de Script suivantes pour démarrer l'objet Alerte à partir d'une Tâche.!Enregistrement du nom de l'agent dans le tampon de lecture :SET&hôte_att# = GET_ATT(HOTE) :PUT_READ_BUFFERhôte# = '&hôte_att#'!activer l'alerte :SET&ret# = ACTIVATE_UC_OBJECT('CALLOP') Comme les attributs peuvent uniquement être déterminés dans l'onglet Traitement de la même Tâche, dans cet exemple, le nom de l'agent sélectionné est défini dans le cache (tampon de lecture). L'objet Alerte peut lire la valeur à cet emplacement et donc l'utiliser pour l'affichage. Alerte Créez maintenant un objet Alerte. Précisez la priorité et le type (requête, message, alerte), ainsi qu'un ou plusieurs Utilisateurs devant être prévenus. Le Script est structuré comme suit. Tout d'abord, le nom de l'agent est lu du le cache. Ensuite, d'autres informations sont transmises à la Tâche (nom, RunID et type d'objet). Cela s'avère utile lorsque vous appliquez certaines conventions à l'attribution de nom des objets. Dans le Script, on vérifie en effet si le nom de la Tâche contient une chaîne de caractères spécifique (ADMIN). Le cas échéant, les utilisateurs que vous avez saisis, ainsi que ceux du groupe "ADMIN", sont avertis. Le texte du message à générer se compose des instructions de Script :PUT_ATT et :PUT_ATT_ APPEND. Vous pouvez créer un saut de ligne avec la fonction UC_CRLF.!Lecture du nom de l'agent de la Tâche :READ&hôte#,, :SET&nom# = SYS_ACT_PARENT_NAME(ACT) :SET&runid# = SYS_ACT_PARENT_NR(ACT) :SET&type# = SYS_ACT_PARENT_TYPE(ACT)

25 Automation Engine 22!Si ADMIN fait partie du nom de la Tâche'... :SET&chaîne# = STR_FIND (&nom#,'admin')!...alors les Utilisateurs avertis sont ceux du Groupe ADMIN. :IF&chaîne# <> '0' : ADD_ATT RECIPIENT, 'ADMIN' :ENDIF!Création du texte :PUT_ATT CALL_TEXT = 'La Tâche suivante n'a pas été exécutée correctement. Veuillez vérifier' :PUT_ATT_APPENDCALL_TEXT = UC_CRLF() :PUT_ATT_APPENDCALL_TEXT = UC_CRLF() :PUT_ATT_APPENDCALL_TEXT = 'Nom de la Tâche : &nom#' :PUT_ATT_APPENDCALL_TEXT = UC_CRLF() :PUT_ATT_APPENDCALL_TEXT = 'RunID de la Tâche : &runid#' :PUT_ATT_APPENDCALL_TEXT = UC_CRLF() :PUT_ATT_APPENDCALL_TEXT = 'Type de Tâche : &type#' :PUT_ATT_APPENDCALL_TEXT = UC_CRLF() :PUT_ATT_APPENDCALL_TEXT = 'Agent : &hôte#' L'illustration suivante présente une Alerte exécutée par la Tâche "ADMIN.MAINTENANCEDB" qui avertit l'utilisateur Henri. Comme il s'agit d'une "Tâche ADMIN", les participants du Groupe ADMIN (Philibert et Meunier) sont également avertis.

26 23 Chapter 6 Alerte avec texte du message variable Rubriques connexes : Alerte - Exécution

27 Automation Engine 24 7 Affichages à l'aide du Cockpit Objectif : Certaines informations sur le statut de l'agent et l'espace disque actuel de la machine s'affichent dans un Cockpit. Objets utilisés : Cockpit, Evènement et Variable Eléments de script utilisés : GET_FILESYSTEM, PUT_VAR et SYS_HOST_ALIVE 7.1 Exemple L'affichage de valeurs dans un Cockpit est réalisé par les objets Variable statiques. Ils contiennent en général les données définies par le script PUT_VAR, mais peuvent être modifiés manuellement. Pour que les informations à afficher correspondent à un statut actuel, un Evènement cyclique transmettant les valeurs régulièrement est sélectionné. Variable Créez tout d'abord une Variable statique (STATIC) avec les attributs suivants : Type de donnée : Texte Plage de validité : Index libre Clef non trouvée : Valeur initiale Cette variable contiendra les données d'un hôte particulier. Evènement Dans un deuxième temps, créez un Evènement cyclique et définissez son intervalle d'exécution dans l'onglet Evènement. Dans l'onglet "! Script", vous devez conserver les étapes de traitement à réaliser périodiquement. Dans cet exemple, il s'agit des lignes de script suivantes.!requête sur l'activité de l'agent WIN01 :SET&hôte_actif# = SYS_HOST_ALIVE('WIN01')!Le statut d'activité est enregistré

28 25 Chapter 7 Affichages à l'aide du Cockpit!en tant que nombre dans l'objet Variable pour son affichage dans le Cockpit. :IF&hôte_actif# = 'Y' : PUT_VAR'HOST_WIN01','HOTE_ACTIF', '1' :ELSE : PUT_VAR'HOTE_WIN01','HOTE_ACTIF', '0' :ENDIF!Requête sur l'espace disque disponible,! et enregistrement de la valeur obtenue dans l'objet Variable. :SET&place_totale# = GET_FILESYSTEM('WIN01','C:\.',FILESYSTEM_SPACE_ TOTAL,GB) :PUT_VAR'HOTE_WIN01','ESPACE_TOTAL', &espace_total# :SET&espace_utilisé# = GET_FILESYSTEM('WIN01','C:\.',FILESYSTEM_SPACE_ USED,GB) :PUT_VAR'HOTE_WIN01','ESPACE_UTILISE', &espace_utilisé# :SET&espace_disponible# = GET_FILESYSTEM('WIN01','C:\.',FILESYSTEM_SPACE_ FREE,GB) :PUT_VAR'HOTE_WIN01','ESPACE_DISPONIBLE', &espace_disponible# On vérifie tout d'abord si l'agent WIN01 est actif. L'affichage du statut est réalisé dans le Cockpit, via une "lampe" ; c'est pourquoi le code retour ("Y"/"N") doit être enregistré sous forme de chiffre dans la Variable. Le script GET_FILESYSTEM permet de trouver des informations sur le système de fichier (espace disque, nombre de fichiers, etc.). Cockpit La dernière étape consiste à créer un Cockpit en utilisant les divers éléments d'affichage. N'oubliez pas d'attribuer la Variable précédemment créée, y compris la clé (menu contextuel "Propriétés"), à chacun d'eux en tant que source de données. Vous pouvez également définir la valeur à partir de laquelle la couleur des éléments d'affichage doit changer.

29 Automation Engine 26 Démarrez maintenant les objets Evènement et Cockpit. L'Evènement remplit la Variable HOST_WIN01 avec les valeurs actuelles. Sélectionnez maintenant l'objet Cockpit dans la Fenêtre d'activités et ouvrez le moniteur (peut être exécuté via la barre d'outils ou le menu contextuel). Les valeurs sont représentées graphiquement, comme auparavant :

30 27 Chapter 7 Affichages à l'aide du Cockpit

31 Automation Engine 28 8 Maintenance de la base de données avec options Objectif : L'archivage de la base de données UC4 doit être automatisé dans un Workflow. L'Utilisateur peut en entrer la configuration correspondante dans une boîte de dialogue. Objets utilisés : Job, Workflow, Script et Variable Eléments de script utilisés : ACTIVATE_UC_OBJECT, :BEGINREAD, GET_VAR, :PRINT, :PUT_VAR et :READ 8.1 Exemple La maintenance régulière de la base de données UC4 représente une part importante de la gestion d'un système UC4. Pour cela, des utilitaires pouvant également être utilisés en mode batch sont à votre disposition. Il est très pratique de créer un Workflow exécutant les étapes de maintenance et recevoir les paramètres (par ex. Client) de l'utilisateur via une boîte de dialogue de saisie. Variable Créez tout d'abord une Variable statique avec les attributs suivants : Type de donnée : Texte Plage de validité : Index libre Clef non trouvée : Valeur initiale Elle contiendra la variable statique, le numéro du Client et les valeurs "J" ou "N" pour chaque étape de la maintenance, selon que l'utilisateur veut l'effectuer ou non. Script Créez ensuite un script ouvrant une boîte de dialogue de saisie à l'aide du script :BEGINREAD, qui reçoit les informations sur le processus de maintenance envoyées par l'utilisateur : Il reçoit de l'utilisateur les informations sur le déroulement de la maintenance :

32 29 Chapter 8 Maintenance de la base de données avec options Numéro du Client Possibilité de définir si un archivage, une réorganisation et/ou un déchargement de la base de données doivent être réalisés A l'aide du paramètre du script :BEGINREAD, indiquez que seuls des chiffres compris entre 0 et peuvent être saisis pour les Clients. Concernant les réglages possibles, les valeurs "O" et "N" doivent être sélectionnables. Les options sélectionnées doivent être enregistrées dans l'objet Variable. Utilisez également ce dernier pour entrer automatiquement les options utilisées lors de la dernière maintenance dans la boîte de dialogue de saisie. L'Utilisateur a bien sûr comme avant la possibilité de modifier la configuration. Le script démarre un Workflow chargé de la procédure de maintenance avec la fonction ACTIVATE_UC_ OBJECT. N'oubliez pas de demander avant si la valeur "N" a été sélectionnée pour toutes les options (archivage, réorganisation, déchargement). Le Workflow n'a alors pas besoin d'être démarré.!détermination de la configuration de la dernière maintenance. :SET&valeur_donnée_m# = GET_VAR('VARA.MAINTENANCE BASE DE DONNEES','CLIENT') :SET&valeur_donnée_a# = GET_VAR('VARA.MAINTENANCE BASE DE DONNEES','ARCHIVER') :SET&valeur_donnée_r# = GET_VAR('VARA.MAINTENANCE BASE DE DONNEES','REORGANISER') :SET&valeur_donnée_e# = GET_VAR('VARA.MAINTENANCE BASE DE DONNEES','DECHARGE')!Une fenêtre de dialogue s'affiche dans laquelle l'utilisateur peut entrer les options de maintenance. :BEGINREAD :PRINT"MAINTENANCE DE LA BASE DE DONNEES UC4" :PRINT"

33 Automation Engine " :READ&client#, "0-9999", 'Client (0-9999)', &valeur_donnée_m# :PRINT" " :PRINT"" :PRINT"Archivage" :READ&archiver#, "'J','N'",'Désirez-vous archiver la base de données?', &valeur_donnée_a# :PRINT"" :PRINT"Réorganisation" :READ&réorganiser#, "'J','N'",'Désirez-vous réorganiser la base de données?', &valeur_donnée_r# :PRINT"" :PRINT"Déchargement de la BD" :READ&décharger#, "'O','N'",'Désirez-vous décharger la base de données?',&valeur_donnée_e# :PRINT"" :PRINT" " :ENDREAD!Si l'utilisateur choisit l'option "Non", il n'y aura pas de maintenance. :IF&archiver# = 'N' : IF&réorganiser# = 'N' : IF&décharger# = 'N' : SET&démarrer#= 'N' : ENDIF : ENDIF :ENDIF :IF&démarrer# = 'N' : BEGINREAD : PRINT'La maintenance de la base de données n'est pas effectuée.' : ENDREAD :ELSE : PUT_VAR'VARA.MAINTENANCE BASE DE DONNEES','CLIENT',&client# : PUT_VAR'VARA.MAINTENANCE BASE DE DONNEES','ARCHIVER',&archiver# : PUT_VAR'VARA.MAINTENANCE BASE DE DONNEES','REORGANISER',&réorganiser# : PUT_VAR'VARA.MAINTENANCE BASE DE DONNEES','DECHARGER',&décharge#!Le Workflow pour la maintenance de la base de données démarre. : SET&ret# = ACTIVATE_UC_OBJECT('JOBP.MAINTENANCE BASE DE DONNEES') :ENDIF Si l'option "Générer à l'exécution" est activée dans les attributs du script, la fenêtre de dialogue n'est pas affichée. Dans ce cas, la valeur par défaut sert de paramètre de réglage (s'applique également aux autres objets activables!). Workflow et Jobs Créez un Workflow contenant un Job pour chaque étape de la maintenance. Les scripts sont identiques, sauf pour l'appel de l'utilitaire. Il s'agit tout d'abord de déterminer si l'étape de la maintenance doit être effectuée, et, le cas échéant, le Client concerné. Ensuite, selon que l'utilitaire est exécuté en mode batch ou noté dans le statut d'activation, cela indique que cette étape de maintenance n'est pas exécutée. ARCHIVER.JOBS :SET&archiver# = GET_VAR('VARA.MAINTENANCE BASE DE DONNEES','ARCHIVER') :SET&client# = GET_VAR('VARA.MAINTENANCE BASE DE DONNEES','CLIENT')

34 31 Chapter 8 Maintenance de la base de données avec options :IF&archiver# = 'J' UCYBDBar -B -S&client# :ELSE : PRINT'Pas d'archivage.' :ENDIF REORGANISER.JOBS :SET&réorganiser# = GET_VAR('VARA.MAINTENANCE BASE DE DONNEES','REORGANISER') :SET&client# = GET_VAR('VARA.MAINTENANCE BASE DE DONNEES','CLIENT') :IF&réorganiser# = 'J' UCYBDBar -B -S&client# :ELSE : PRINT'Pas de réorganisation.' :ENDIF DECHARGER.LES.JOBS :SET&décharger#= GET_VAR('VARA.MAINTENANCE BASE DE DONNEES','DECHARGER') :IF&décharger# = 'J' UCYBDBun -BREORG :ELSE : PRINT'Pas de décharge des enregistrements.' :ENDIF Si vous utilisez des Jobs Windows, nous recommandons d'effectuer une recherche d'erreurs après chaque exécution de l'utilitaire, et de modifier le Code Retour en conséquence le cas échéant. Le Job s'interrompt aussi lorsque l'exécution de l'utilitaire échoue, ce qui vous permet d'identifier les erreurs le plus rapidement possible et d'y remédier. Pour cela, il faut insérer les deux lignes JCL suivantes après l'exécution du programme NOT %ERRORLEVEL% == 0 goto :retcode

35 Automation Engine 32 9 Définir un statut de fin à cause du contenu d'un rapport Objectif : Le contenu précis d'un rapport de Job doit être analysé lorsque le statut final est défini en fonction du résultat. Objets utilisés : Job Eléments de script utilisés : :CLOSE_PROCESS, :ENDPROCESS, GET_PROCESS_LINE, :MODIFY_ STATE, PREP_PROCESS_REPORT, :PRINT et :PROCESS 9.1 Exemple Dans certaines situations, le traitement d'un Job dans le système UC4 se fait sans problème (l'agent est actif, les données de connexion sont correctes,...). Il se termine alors sans erreur. Le but du traitement n'est cependant pas réalisé (erreur dans le JCL par exemple). C'est pourquoi il est possible de lire le rapport dans l'onglet Post-traitement et d'adapter le statut final en fonction des résultats, par exemple. Job Dans l'exemple présenté ici, un Job sert à transférer des fichiers utilisés par FTP. La ligne suivante figure dans l'onglet Script : ftp -s:zweigstelle15.ftp Le fichier FTP "zweigstelle15.ftp" contient les commandes pour les fichiers à transférer. Il peut bien sûr arriver qu'un ou plusieurs fichiers soient introuvables. Dans ce cas-là, il est donc utile d'utiliser le script PREP_PROCESS_REPORT pour rechercher d'éventuels messages d'erreur FTP enregistrés dans le rapport.

36 33 Chapter 9 Définir un statut de fin à cause du contenu d'un rapport Le résultat de la fonction PREP_PROCESS_REPORT comporte toutes les lignes du rapport auxquelles le filtrage défini s'adapte et doit donc être évalué ligne par ligne dans une boucle PROCESS. Vous obtenez le contenu d'une ligne avec GET_PROCESS_LINE. Si aucune ligne n'est trouvée dans le rapport, la boucle PROCESS n'est pas non plus exécutée. Si le rapport contient un message d'erreur (par ex. fichier introuvable), vous pouvez y réagir en définissant, à l'aide de MODIFY_STATE, le texte de statut qui s'affiche dans la fenêtre de détails des statistiques et en modifiant le code retour du Job (ce qui influence le statut final). Attention : dans l'onglet Exécution du Job, l'intervalle pendant lequel le Job doit se terminer avec le statut ENDED_OK est défini pour le code retour. Exp : Définition pour ENDED_OK > Code retour <= 0 Code retour :MODIFY_STATE RETCODE = 0 :MODIFY_STATE RETCODE = 5 Résultat Le Job se termine avec ENDED_OK Le Job se termine avec ENDED_NOT_OK Le script qui exécute le processus précédemment expliqué se présente comme suit :!Vérification du rapport déclarant qu'un ou plusieurs fichiers à transmettre sont introuvables.!recherche de lignes contenant le texte "File not found". :SET&hnd# = PREP_PROCESS_REPORT(,,REP,'*File not found*')!chaque ligne trouvée sera incluse dans le rapport de post-traitement :PROCESS&hnd# : SET&ligne# = GET_PROCESS_LINE(&hnd#) : PRINT'&ligne#'!De plus, le statut final du Job est modifié. : MODIFY_STATE RETCODE = 11 : MODIFY_STATE STATUS_TEXT = 'Fichier(s) introuvable(s)!' :ENDPROCESS Si certains fichiers à transférer sont absents, les statistiques se présentent comme suit. Le Job se termine avec "ENDED_NOT_OK-interrompu" et présente le code retour défini 11.

37 Automation Engine Détermination du message et du numéro de l'erreur Objectif : En cas d'erreur, le texte du message et le numéro correspondants doivent être demandés et transmis par . Objets utilisés : tout objet activable Eléments de script utilisés : ACTIVATE_UC_OBJECT, GET_MSG_TXT, :ON_ERROR, PRINT, SEND_ MAIL, SYS_ACT_ME_NAME, SYS_ACT_ME_NR, SYS_LAST_ERR_INS, SYS_LAST_ERR_NR, UC_ CRLF, XML_CLOSE, XML_GET_NODE_TEXT et XML_OPEN 10.1 Exemple Si un Script rencontre une erreur au cours du traitement, un message comportant le texte et le numéro correspondant est émis. Vous avez la possibilité d'accéder à ces informations afin de pouvoir utiliser chaque valeur par la suite. Il est donc possible de définir des réactions précises à des erreurs survenues. Tâche L'exemple suivant illustre la manière dont l'ensemble du message d'erreur apparaît et est transféré à un destinataire par . Le point de départ est l'activation d'un objet nommé "GS.FIN". Comme le nom est utilisé à plusieurs endroits, il permet de définir une Variable de Script pour chacun d'entre eux. S'il est impossible d'activer l'objet, la fonction de Script ACTIVATE_UC_OBJECT renvoie la valeur 0. Dans ce cas, les informations relatives à la dernière erreur survenue peuvent être transmises. Pour cela, utilisez le Script suivant : SYS_LAST_ERR_NR - Fournit le numéro d'erreur SYS_LAST_ERR_INS - Fournit la partie variable du texte d'erreur (par ex. RunID) GET_MSG_TXT- Fournit l'ensemble du texte d'erreur en se basant sur le numéro d'erreur et la partie variable Les valeurs peuvent par exemple être envoyées à un destinataire par pour l'avertir. Comme les responsabilités sont souvent réparties entre plusieurs personnes au sein d'un système UC4, l'enregistrement d'un interlocuteur présente un avantage. Il peut être spécifié pour chaque objet dans l'onglet Documentation. Utilisez pour cela les modèles d'objet, afin d'entrer cette information et d'autres encore. Si un objet est créé à l'aide d'un modèle, ce dernier reprend le contenu défini précédemment. L'illustration suivante montre un onglet Documentation structuré. Celui-ci présente l'avantage de pouvoir être lu avec des Scripts spéciaux (XML*).

38 35 Chapter 10 Détermination du message et du numéro de l'erreur La fonction de Script XML_GET_NODE_TEXT vous permet d'indiquer l'interlocuteur. Celui-ci sert de destinataire de l' qui peut être envoyé avec SEND_MAIL. L' contient le nom de l'objet à démarrer, celui de la Tâche contenant la tentative d'activation et le RunID de celle-ci. Conseil sur :ON_ERROR : Pour chaque Script, y compris ACTIVATE_UC_OBJECT, vous pouvez déterminer vous-même si le traitement du Script s'interrompt en cas d'erreur. Dans cet exemple, ":ON_ERROR RESUME" est indiqué pour pouvoir analyser l'erreur survenue. Pour ":ON_ERROR ABEND", le Script serait interrompu par ACTIVATE_UC_OBJECT dans la ligne. Le Script suivant présente chaque étape du processus expliqué précédemment :!Une Alerte doit être envoyée par ,!si l'objet ne peut être activé. :SET&obj_à_démarrer# ='GS.FIN' :ON_ERRORRESUME :SET&démarrage# = ACTIVATE_UC_OBJECT(&obj_à_démarrer#) :IF&démarrage# = 0 : SET&erreur_nr# = SYS_LAST_ERR_NR() : SET&erreur_var# = SYS_LAST_ERR_INS() : SET&message# = GET_MSG_TXT(&erreur_nr#,&erreur_var#) : PRINT'&message#'!Trouver l'interlocuteur : SET&docuxml# = XML_OPEN(,'@description') : SET&contact# = XML_GET_NODE_TEXT(&docuxml#) : XML_CLOSE : SET&nom_obj# = SYS_ACT_ME_NAME() : SET&runid_obj# = SYS_ACT_ME_NR()!Saut de ligne : SET&à#= UC_CRLF() : SET&ret_mail# = SEND_MAIL('&contact#@uc4.at',,'La Tâche &obj_à_démarrer# n'a pas pu être démarrée','nom: &nom_obj# / RunID : &runid_obj#&à#&à# MESSAGE : &message#')

39 Automation Engine 36 :ENDIF Pour pouvoir envoyer l' , la connexion d'un Agent doit être active!

40 37 Chapter 11 Réaction à des Evènements externes 11 Réaction à des Evènements externes Objectif : Lorsqu'un Evènement SAP est déclenché dans le système UC4, il doit s'afficher pour que l'utilisateur puisse y réagir. Objets utilisés : Evènements de console, Alerte Eléments de script utilisés : ACTIVATE_UC_OBJECT, GET_EVENT_INFO, PRINT 11.1 Exemple Parmi les objets, on compte également les Evènements de type "Console". Ils sont disponibles sur quelques-unes des plateformes prises en charge par UC4 (par ex. z/os ou Windows) et surveillent les sorties de console. Reliez cette fonctionnalité à votre système UC4 pour également réagir aux Evènements qui n'ont pas été déclenchés par UC4. L'exemple illustre cette méthode à l'aide d'un Evènement SAP. Un opérateur doit être averti lorsqu'un transport se produit dans un système SAP productif. Evènement En premier, nous avons besoin d'un Evènement de console qui surveille les Evènements SAP déclenchés. Nous souhaitons réagir lorsqu'un transport est exécuté. Dans ce cas, le système SAP déclenche l'evènement "SAP_IMPORT_START". L'Agent l'identifie à l'evènement de console à chaque fois que le!script est exécuté. Cela signifie que nous pouvons réagir à l'evènement SAP déclenché à l'aide d'instructions que nous enregistrons dans le!script. Suivez un Evènement de console. Les principales caractéristiques de cet objet sont configurées dans l'onglet Console. Sélectionnez l'agent relié au système SAP. Dans le tableau situé dans la zone inférieure, vous devez entrer des critères de sélection pour les Evènements SAP à surveiller. Pour cela, il est possible de saisir certains Evènements ou de les entrer à l'aide des caractères génériques "*" et "?". Vous devez définir le filtre. Vous pouvez bien entendu également utiliser plusieurs lignes. En ce qui nous concerne, nous n'avons besoin que d'une seule ligne. Entrez "SAP_IMPORT_START" comme ID de l'evènement et remplissez les champs de paramètres d'evènement et de Serveur d'evènements adaptés à votre système SAP. Dans l'illustration suivante, vous pouvez voir l'onglet "Console" complètement rempli.

41 Automation Engine 38 Alerte Vous pouvez réagir de plusieurs manières à un Evènement SAP déclenché. Vous pouvez par exemple lancer un traitement séquentiel sous forme de Workflows. Dans notre exemple, nous nous sommes limités à en informer un Utilisateur par l'intermédiaire d'un objet Alerte. Créez un objet Alerte. Sélectionnez un Utilisateur devant être informé et formulez un message adapté. La priorité de l'alerte et son type doivent également être définis. Evènement Dans l'evènement de console, passez maintenant à l'onglet "!Script". Nous souhaitons conserver des informations détaillées sur l'evènement SAP dans le rapport et activer l'objet Alerte. Nous y parvenons tout d'abord à l'aide de la fonction script GET_EVENT_INFO. Elle fournit une information précise sur l'evènement SAP en fonction du paramètre transmis. Plusieurs mots clés sont disponibles. L'Agent annonce les Evènements SAP dans un intervalle que l'administrateur UC4 a défini à l'aide du paramètre JOB_CHECKINTERVAL. Ce qui nous intéresse donc, c'est le moment où l'evènement SAP a été déclenché. Nous transmettons toutefois les paramètres d'evènement complets et le Serveur d'evènements, car nous les avons indiqués pour les deux filtres dans l'evènement de console. Enfin, l'objet Alerte que nous avons nommé "CALL.SAP_IMPORT_START" est activé. :SET&marque horaire# = GET_EVENT_INFO(TIMESTAMP) :PRINT"marque horaire : &marque horaire#" :SET&paramètre# = GET_EVENT_INFO(EVENT_PARM) :PRINT"paramètre de l'evènement : &paramètre#" :SET&Serveur# = GET_EVENT_INFO(EVENT_SERVER) :PRINT"Serveur d'evènements : &Serveur#" :SET &ret# = ACTIVATE_UC_OBJECT(CALL.SAP_IMPORT_START) Les informations sur l'evènement SAP peuvent également être transmises à l'alerte. L'exemple "Alerte avec texte du message Variable" vous indique comment cela fonctionne. Le rapport de l'exécution du!script se présente comme suit dans la structure :

42 39 Chapter 11 Réaction à des Evènements externes

43 Automation Engine Synchronisation de Tâches actives Objectif : Les Tâches déjà actives doivent par la suite être synchronisées manuellement. Objets utilisés : Script et Sync Eléments de script utilisés : ADD, :ATTACH_SYNC, :BEGINREAD, FORMAT, GET_SYNC, GET_UC_ OBJECT_NR, :PRINT, :READ, SET_SYNC et :STOP Exemple Les objets Sync servent à synchroniser les Tâches. Ils peuvent être sélectionnés avec vos actions pour chaque objet exécutable. Il est également possible de synchroniser ultérieurement les Tâches déjà actives. Sync Des statuts sont définis dans un objet Sync (par ex : "EXCLUSIV - La base de données est utilisée de façon exclusive"). Vous pouvez définir vous-même leur désignation et leur nombre. L'objet Sync accepte l'un des statuts et le change dès que les actions surviennent. Ces actions sont également définies dans l'objet Sync, puis sont sélectionnables dans les objets. Vous pouvez alors rechercher l'objet Sync dans chaque objet exécutable, puis définir les actions et les moments de leur exécution (par ex. action - "RELEASE" à la fin de la Tâche). La synchronisation de Tâches est autorisée en fonction du statut actuel et de la réaction obtenue. Cet exemple montre comment synchroniser deux Tâches en définissant l'une comme successeur de l'autre. Le processus se présente comme suit : Objet Sync disponible? -> La 1ère Tâche est exécutée-> La 2nde Tâche est exécutée Les statuts "DISPONIBLE", "TACHE1" et "TACHE2" en découlent pour l'objet Sync. Trois actions sont également nécessaires pour contrôler les statuts Sync : "SET_TACHE1", "SET_TACHE2" et "SET_ DISPONIBLE". La corrélation entre l'objet Sync et les Tâches est représentée dans le tableau suivant : Condition préalable : l'objet Sync a le statut "DISPONIBLE" Définition dans... Action Résultat SET_SYNC (dans le script) SET_TACHE1 La Tâche 1 peut démarrer 1. Tâche SET_TACHE2 (à la fin) La Tâche 2 peut démarrer 2. Tâche SET_DISPONIBLE (au début) L'objet Sync est de nouveau disponible

44 41 Chapter 12 Synchronisation de Tâches actives Ces paramètres vous permettent de synchroniser deux Tâches par objet Sync. Dans cet exemple, deux objets Sync sont utilisés, ce qui est suffisant. La synchronisation manuelle n'est utilisée qu'en cas d'exception, par exemple, lorsqu'une Tâche supplémentaire doit être intégrée dans un processus existant. Créez le nombre d'objets Sync nécessaires. L'utilisation d'une désignation fixe plus d'un numéro comme nom d'objet présente un intérêt, car vous pouvez communiquer avec chaque objet Sync à l'aide d'un compteur. Script Comme la synchronisation ultérieure des deux Tâches peut être exécutée avec des scripts, vous devez créer un objet script contenant le déroulement nécessaire. Tout d'abord, une boîte de dialogue de saisie comportant les noms des deux Tâches est créée. Ensuite, il faut contrôler si ces Tâches sont vraiment actives (c'est-à-dire qu'elles possèdent un RunID). Sinon, le script est interrompu. Ensuite, une boucle WHILE vérifie s'il a des objets SYNC disponibles. Une Variable de compteur permet d'étudier les noms des séries (SYNC.JOB.DEPENDANCE_nn). La fonction de script GET_SYNC permet de lire le statut actuel de l'objet Sync, qui doit être "DISPONIBLE" pour utiliser les Tâches. Si aucun objet Sync n'est trouvé, le script s'interrompt. Si un objet Sync est disponible, il peut être entré dans les deux Tâches à l'aide de l'instruction ATTACH_ SYNC.!Nombre d'objets Sync disponibles :SET&nombre_sync# = 2!Saisie de la première Tâche et de la suivante :BEGINREAD'Dépendance dynamique des Tâches' : PRINT'ATTENTION : les Tâches doivent déjà être actives' : PRINT'' : READ&Tâche1#,'00','Nom du prédécesseur',,m : READ&Tâche2#,'00','Nom du successeur',,m

45 Automation Engine 42 :ENDREAD!ITâche1 active? :SET&runid#a1# = GET_UC_OBJECT_NR(JOBS,'&Tâche1#') :IF&runid#a1# = '' : STOP MSG,50,'Prédécesseur (&Tâche1#) inactif' :ENDIF!Tâche2 active? :SET&runid#a2# = GET_UC_OBJECT_NR(JOBS,'&Tâche2#') :IF&runid#a2# = '' : STOP MSG,50,'Successeur (&Tâche2#) inactif' :ENDIF!Détermination avec le compteur d'un objet Sync disponible!(sync.job.dependance_01, SYNC.JOB.DEPENDANCE_02) :SET&statut# = '' :SET&compteur# = 0 :WHILE&statut# <>'DISPONIBLE' : SET&compteur# = ADD(&compteur#,1) : SET&compteur# = FORMAT(&compteur#,'00') : IF&compteur# > &nombre_sync# : STOP MSG,50,'Aucun objet Sync disponible' : ENDIF : SET&statut# = GET_SYNC('SYNC.JOB.DEPENDANCE_&compteur#','STATE') :ENDWHILE!Addition des objets Sync :SET&ret# = SET_SYNC('SYNC.JOB.DEPENDANCE_&compteur#','SET_TACHE1') :ATTACH_SYNCJOBS,&runid#a1#,'SYNC.JOB.DEPENDANCE_&compteur#',,,SET_TACHE2,W :ATTACH_SYNCJOBS,&runid#a2#,'SYNC.JOB.DEPENDANCE_&compteur#',SET_ DISPONIBLE,,W

46 43 Chapter Glossaire Glossaire Ce glossaire contient tous les concepts spécifiques à UC4. A B C D E F G H I J K L M N O P Q R S T U V W X Y Z A 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 UC4. Activation L'activation entraîne l'attribution d'un RunID à la Tâche, l'affichage de la Tâche dans la Fenêtre d'activités et la préparation pour l'exécution.(voir aussi Début) Protocole d'activation Rapport contenant les détails d'activation de la Tâche. JCL généré, modifications de Variables, etc.). Fenêtre d'activités Fenêtre de l'interface Utilisateur dans laquelle s'affichent les objets activés. Alias Nom pour les Tâches qui affichent le moniteur et les statistiques au lieu du nom de l'objet réel dans la Fenêtre d'activités. Possible pour les Tâches de Workflow et les objets qui sont activés de manière unique, périodique ou bien via le script. Processus de travail Composant de l'uc4 Automation Engine. S'occupe du traitement dans un système UC4. (voir aussi le Processus de travail primaire). Tâche Objet exécutable qui a déjà été exécuté. Simulation automatique Indique les Tâches qui seront exécutées dans une période donnée et offre ainsi une prévisualisation détaillée des activités futures. B Mode batch Traitement séquentiel de processus en arrière-plan. Calendrier Partie d'un objet Groupe Calendrier ou Variable (Calendrier ou Clef). Alerte Envoi de messages à un Utilisateur ou un Groupe Utilisateur unique du système UC4. Egalement un type d'objet propre à UC4. Utilisateur Personne utilisant le système UC4. Egalement un type d'objet distinct dans UC4. Groupe Utilisateur Regroupement d'utilisateurs auxquels un profil de droits commun doit être attribué. Egalement un type d'objet distinct dans UC4. C

47 Automation Engine 44 CallAPI Interface de programmation pouvant être exécutée en direct ou à partir d'un autre programme, afin d'exécuter un script dans le système UC4. Enfant, enfants Objets activés par le biais de Tâches supérieures dans l'arborescence (parent). Cockpit Visualise les valeurs et statuts dans UC4 ou à partir des systèmes surveillés et contrôlés. Egalement un type d'objet distinct dans UC4. Table de Code Définit un jeu de caractères complet. Egalement un type d'objet distinct dans UC4. D Séquence de données Liste 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*. Processus de dialogue Partie de l'uc4 Automation Engine et forme particulière de processus de travail. S'occupe des messages provenant de l'interface Utilisateur Utilitaires Prennent en charge les Tâches d'administration d'un système UC4, telles que la réorganisation et l'archivage de la base de données UC4. Documentation Manuels d'utilisation d'uc4. Egalement un type d'objet distinct d'uc4, dans lequel des informations peuvent être enregistrées. Variable dynamique Objet Variable avec l'attribut "Source" - "SQL", "SQL interne", "Multi" ou "Liste de fichier". Pour chaque accès, les valeurs sont récupérées directement dans la source de données et ne sont pas enregistrées dans l'objet. E Connexion Fonctionnalité des Agents Windows et UNIX permettant l'envoi d' s. Enterprise Control Center (ECC) Produit UC4. Application Web permettant d'accéder de manière claire et simple aux fonctions des divers produits/applications UC4. Disponible dans le centre de téléchargement UC4. Evènement Action exécutée lorsque certaines conditions sont remplies. Egalement un type d'objet distinct dans UC4. Event-ID Premier RunID des Evènements de systèmes de fichiers ou de console. Les deux types d'evènements impliquent une communication entre l'uc4 Automation Engine et l'agent UC4. Afin que l'affectation à l'evènement reste possible en cas de changement du fichier log ou de modification liée du RunID, la communication s'effectue par le biais du premier RunID. Explorer Fenêtre de l'interface Utilisateur dans laquelle les objets sont affichés, traités et gérés.

48 45 Chapter Glossaire Dépendance externe Tâche dont le statut de fin est pris en compte dans le déroulement d'un Workflow, bien qu'elle ne soit pas exécutée dans le cadre du Workflow. F Transfert de Fichier Transmission de fichiers entre deux machines. Egalement un type d'objet distinct dans UC4. G Groupe Regroupe des Tâches pour les exécuter ensemble. Egalement un type d'objet distinct dans UC4. H Hôte Ordinateur, système cible Attributs de l'hôte Attributs de l'objet Job, variant en fonction de la plateforme. Aide HTML Format d'aide de Microsoft pour les manuels. L'extension des fichiers d'aide est.chm (voir aussi WebHelp) I Include Script utilisé souvent et dans de nombreux objets. Egalement un type d'objet distinct dans UC4. J JCL Acronyme de "Job Control Language". Il s'agit d'instructions qui forment les étapes de traitement et sont exécutées sur les machines. Job Traitement sur un système cible. Egalement un type d'objet distinct dans UC4. K Groupe Calendrier Rassemblement de jours au sein de Calendriers. Egalement un type d'objet distinct dans UC4. Condition de calendrier Critère d'exécution pour les Tâches basées sur les Calendriers. Calendrier Partie d'un objet Groupe Calendrier dans lequel les jours sont définis.

49 Automation Engine 46 Clef Colonne pour les objets Variable statique par laquelle il est possible d'accéder aux Valeurs d'une ligne spécifique. Processus de communication Composant de l'uc4 Automation Engine. Assure la connexion aux composants UC4. Menu contextuel Menu qui s'affiche parfois en appuyant sur le bouton droit de la souris. L Exécution Durée d'exécution d'une Tâche. C'est la période entre le début et la fin de la Tâche. La période d'activation n'en fait pas partie (voir aussi Activation et Démarrage). Login Données de connexion pour les systèmes cible. Egalement un type d'objet distinct dans UC4. Date logique La date logique est utilisée comme date de comparaison lors de la vérification des conditions de calendrier. M Client Environnement indépendant pour l'exécution de Tâches dans un système UC4. Egalement un type d'objet distinct dans UC4. Fenêtre de message Fenêtre dans l'interface Utilisateur qui affiche avertissements, messages d'information et d'erreur. Moniteur Affichage graphique de l'exécution d'une Tâche. N Processus non-stop Composant de l'uc4 Automation Engine. Ils reprennent le traitement lorsque la machine avec les processus serveur actifs tombe en panne. O Objet Les activités et déroulements que contrôle UC4 sont représentés à l'aide d'objets (voir aussi Tâche). Classe d'objet Tous les objets sont répartis en 4 classes : objets activables, objets actifs, objets passifs et objets système. Type d'objet A chaque activité correspond un objet : Agent, Alerte, Utilisateur, Groupe Utilisateur, Cockpit, Table de Codes, Documentation, Evènement, Transfert de Fichier, Groupe, Include, Job,

50 47 Chapter Glossaire Workflow, Groupe Calendrier, Login, Client, RemoteTaskManager, Schedule, script, Serveur, Sync, Variable et Fuseau horaire. Variables d'objet Caractères de remplacement des valeurs définies dans l'onglet "Variables & Prompts" d'un objet. P Parent Un objet peut être activé de différentes façons. L'initiateur de l'activation s'appelle Tâche de niveau supérieur (parent). (voir aussi Enfant, Enfants) Conteneur de périodes Contrôle l'exécution des Tâches périodiques. Tâches périodiques Sont planifiées sans objet Schedule et couvrent la plupart du temps une période inférieure à un jour. Perspective Domaine de fonction propre de l'enterprise Control Center (ECC) - interface Web. Les perspectives "Service Catalog", "Process Monitoring" und "Process Assembly" mettent à disposition des fonctionnalités de l'uc4 Automation Platform. Processus de Travail Primaire Le processus de travail primaire exécute des Tâches centrales des processus de travail qui ne permettent aucune répartition (base horaire, gestion des processus, etc.) Process Assembly Perspective de l'enterprise Control Center. Permet la création, la définition et la modification de Workflows. Process Automation Ancien nom de la perspective Service Catalog. Process Monitoring Perspective de l'enterprise Control Center. Enumère les activités de tous les utilisateurs et permet de les influencer (interrompre, désactiver,...). Simulation Estimation de la durée d'une Tâche sur la base des exécutions précédentes. PromptSet Masque de saisie défini par l'utilisateur pour les objets activables. Egalement un type d'objet distinct dans UC4. Elément PromptSet Champs/ éléments de contrôle permettant de demander des valeurs de l'utilisateur. Forment le contenu d'un masque de saisie d'un PromptSet. Variable PromptSet Enregistre la valeur d'un élément PromptSet. Ainsi, il peut s'agir selon la situation de celle indiquée par l'utilisateur ou d'une valeur par défaut. Elles se comportent comme des Variables d'objet. Q Queue Définit le nombre maximal de Tâches exécutées en parallèle, leur priorité et l'ordre des objets à exécuter.egalement un type d'objet distinct dans UC4. R

51 Automation Engine 48 Rapid Automation (RA) Technologie générique capable de prendre en charge des solutions différentes. Composé d'un Agent RA et d'une Solution RA. Agent RA Agent UC4 Agent pouvant être associé à une Solution RA définie et mettre ainsi ses fonctionnalités à disposition d'un système UC4. Il représente ainsi l'interface entre un système / une application / une plateforme externes et un système UC4. Solution RA Solution basée sur la technologie Rapid Automation Technologie permettant à UC4 d'accéder à un système / une application / une plateforme externes. Il s'agit ici d'un fichier JAR à charger dans la base de données UC4 et à associer à un Agent RA. Après le chargement de la solution, les objets RA spécifiques (Jobs, Connexions, Agent) sont disponibles dans le système UC4. Date réelle Date utilisée pour la vérification de la surveillance de la durée d'exécution ou des conditions temporelles dans les propriétés des Tâches de Workflow. La date réelle correspond au moment de l'activation du Workflow supérieur et est transmise à toutes les tâches subordonnées. RemoteTaskManager Surveille et contrôle les Jobs externes qui n'ont pas été démarrés par UC4. Egalement un type d'objet distinct dans UC4. Rapport Rapport contenant les détails d'activation d'une Tâche ou d'un composant UC4. Colonne Résultat Première colonne d'objets Variable avec la source SQL, "SQL interne"et "Multi". Le contenu de cette colonne est déterminé par le Format du résultat. RunID Abréviation du numéro d'identification unique. Il s'agit plus précisément d'un nombre qui identifie clairement l'exécution d'une Tâche. Le RunID peut comporter entre 7 et 10 caractères. Ils sont attribués par l'uc4 Automation Engine. Code retour Valeur représentant le résultat des Tâches et des fonctions de script. S Schedule Démarre des objets activables à intervalles périodiques. Egalement un type d'objet distinct dans UC4. Script Instructions de traitement dans le langage de script d'uc4. Egalement un type d'objet distinct dans UC4. Variable de script Caractères de remplacement d'une valeur dans un script. Processus serveur Base de l'uc4 Automation Engine. Il existe plusieurs types de processus serveur : processus de communication, processus de travail, processus de dialogue et processus non-stop. ServiceManager Programme permettant de démarrer et d'arrêter des composants UC4. Service Catalog Perspective de l'enterprise Control Center. Permet à l'utilisateur de démarrer les objets de son dossier Favoris et de surveiller de manière générale leur exécution. Début Début de l'exécution d'une Tâche. (voir aussi Activation)

52 49 Chapter Glossaire Variable statique objet 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. Statistiques Liste des exécutions précédentes d'une Tâche. Statut Statut d'une Tâche (par ex. active, bloquée, génération en cours, etc.). Sous-Workflow Workflow faisant partie d'un autre Workflow. Sync Synchronise les objets activables en fonction de statuts et d'actions définis. Egalement un type d'objet distinct dans UC4. Supervision système Fenêtre de l'interface Utilisateur contenant des informations sur le système UC4. T Les Transferts de Fichiers avec caractères génériques Transferts de fichiers qui transfèrent plusieurs fichiers à l'aide de caractères génériques. Temps dépassé Intervient après écoulement d'une durée définie. U Tâche de niveau supérieur Un objet peut être activé de différentes façons. L'initiateur de l'activation s'appelle Tâche de niveau supérieur (parent). L'UC4 Automation Engine commande un système UC4. Il repose sur plusieurs processus serveur. Plateforme UC4 Automation Produit UC4. Contient les composants nécessaires à l'exploitation d'un système UC4 (Automation Engine, interface utilisateur, Agents, interface Web, etc.). Disponible dans le centre de téléchargement UC4. UC4 ClearView Produit UC4. Outil d'analyse graphique : Regroupe, pour chaque client d'un système UC4, les données de simulation, d'activités et de statistiques dans un diagramme à barre et permet ainsi le calcul du chemin critique. Disponible dans le centre de téléchargement UC4. Base de données UC4 Système de gestion de base de données relationnelles, permettant la gestion centralisée de toutes les données de planification. Elle contient définitions d'objet, paramètres système, données statistiques, rapports de Job, etc. UC4 Insight Produit UC4. Outil d'analyse graphique complexe dédié aux données des systèmes de l'uc4 Automation Platform, comme par exemple les Tâches. Disponible dans le centre de téléchargement UC4. Composants UC4 Regroupe tous les programmes UC4, notamment l'interface Utilisateur, Automation Engine, les Agents, les ServiceManager, les utilitaires, etc.

53 Automation Engine 50 UC4 Policy Orchestrator (PCO) Produit UC4. Définition et gestion des règles Business et déclenchement d'évènements. Disponible dans le centre de téléchargement UC4. Priorité UC4 La priorité UC4 est influencée par le traitement des Tâches au sein du système UC4. UC4 Application Release Automation Produit UC4. Permet de définit, gérer et activer des processus d'installation/intégration et de gérer les versions/dépendances des diverses applications. Les processus de déploiement sont exécutés via l'uc4 Automation Platform. Disponible dans le centre de téléchargement UC4. Script UC4 Langage de script utilisé par UC4. Serveur UC4 Ancien terme pour le composant UC4 Automation Engine (v8 et inférieures). UC4 Service Orchestrator (SVO) Produit UC4. Service Orchestrator est une perspective de l'uc4 Enterprise Control Centers (ECC) qui permet de gérer, de surveiller et d'analyser la performance des SLA (Service Level Agreements). Système UC4 Environnement contrôlé par les composants UC4. Variables UC4 Variables comportant les paramètres de configuration du système UC4. Interface Utilisateur Interface utilisateur graphique d'uc4. UTC UC4 utilise UTC (Universal Time Coordinated) en interne en raison de sa clarté universelle. Pour l'affichage de l'heure et pour son utilisation dans les Tâches et les éléments de script, il est possible de créer des objets Fuseau horaire correspondants, convertis dans un fuseau horaire local. V Variable Enregistre ou fournit les valeurs dynamiques de l'exécution. Egalement un type d'objet distinct dans UC4. Gestion des Versions Version protégée d'un objet qui peut être créée lors des modifications et restaurée ultérieurement. Les Transferts de Fichiers avec caractères qualifiés Transferts de Fichiers sans caractères génériques. Uniquement un fichier spécifique est transféré. Variable prédéfinie Variables fixes qui peuvent être utilisées dans des attributs ou dans des scripts d'objets activables. Les valeurs se rapportent à l'objet ou au système. Enregistré en attente Statut d'une Tâche qui est exécutée dans un Groupe et attend son démarrage. W WebHelp Format d'aide pour les manuels qui peut être ouvert via un navigateur web. (voir aussi l'aide HTML) Interface Web Interface utilisateur d'uc4 que l'on peut ouvrir via un navigateur web.

54 51 Chapter Glossaire Reprise Répétition d'une exécution d'objet déjà créée pour laquelle plusieurs particularités s'appliquent au redémarrage. Caractères génériques Caractères de remplacement des données de filtre (? = un caractère exactement, * = chaîne de caractères). Workflow Déroulement de Traitements. Egalement un type d'objet propre à UC4. X Fichier XML Format d'importation et d'exportation. Contient la structure des objets. Z Fuseau Horaire Définit l'heure locale. Egalement un type d'objet distinct dans UC4.