Home

W4 Engine - Manuel d`exploitation

1. REMARQUE SUR LE PARAM TRE TMPDIR STICKY BIT DU R PERTOIRE TEMPORAIRE W4Engineutilise des fichiers temporaires pour la communication entre le client et le serveur Ces fichiers sont cr s sous le r pertoire tmp ou var tmp En g n ral sur les syst mes UNIX le sticky bit de ce r pertoire est positionn ce qui emp che un utilisateur de supprimer les fichiers cr s par un autre Dans les applications W4 le client cr e le fichier temporaire qui est ensuite supprim apr s lecture par W4 Engine Si l utilisateur qui lance le serveur d applications est diff rent de celui qui lance W4 Engine les fichiers cr s par l un ne peuvent pas tre supprim s par l autre Les logs produits sont de ce type 2004 08 10 09 40 04 1 error 30 WFRemoveFile os c 239 231 2004 08 10 09 40 04 1 WFRemoveFile unable to remove file var tmp WFjniClient11506 log errno 13 2004 08 10 09 40 04 0 error 30 WFPurgeDirectory admtools c 2278 2275 L implication en termes de performances est la suivante chaque appel client un fichier temporaire de nom unique est cr Ce nom est g n r en fonction des noms des fichiers d j existants dans le r pertoire En cons quence plus il y a de fichiers plus le temps de cr ation du nom unique est important Trois solutions sont possibles d marrer W4 Engine et le serveur d applications avec le m me utilisateur ou m configurer le r pertoire temporaire tmp o
2. C wdeimport gt wdeimport w4adm W w4adm i w4adm WaeimportSamples wde ex true mr Root Procedure UpperRole Root Procedure Role Sub Procedure Rol Sub Sub Procedure Rol mp Sub Sub Procedure Sub Procedure Root Procedur Sub Sub Procedure Role MODIFIED ROLE OK Root Procedure Role MODIFIED ROLE OK Sub Procedure Role MODIFIED ROLE OK Root Procedure UpperRole MODIFIED ROLE OK Sub Sub Procedure MODIFIED PROCEDURE OK Sub Procedure MODIFIED PROCEDURE OK Root Procedure MODIFIED PROCEDURE OK D EC IMPORTANT Pour pouvoir modifier une proc dure le fichier w4e doit avoir t constitu sous Process Composer par une extraction de la proc dure partir du serveur de production de telle sorte que les identificateurs des objets du fichier soient ceux du serveur Dans le cas contraire l erreur Error Server 2115 est retourn e et seule la r vision de la proc dure est possible Script de r vision Probl matique les proc dures de l application sont r vis es Des r les peuvent tre cr s ou modifi s et de nouvelles activit s cr es Le script de r vision est le suivant dans l exemple il s agit d une r vision de proc dures sans cr ation de r les ni d activit s REM La propri t Upper Role du r le Root Procedure Role a t r tablie wdeimport 1 w4adm w wdadm i w4ad
3. D finit un r pertoire de stockage des logs diff rent du r pertoire par d faut Valeur par d faut m UNIX var adm w4 1log m Windows lt softwareHome gt adm log Exemple d utilisation du param tre w4adm logDir c Program Files w4 log mail Protocole de mail utilis par d faut sur Windows MAPI Valeur par d faut aucune Exemple d utilisation du param tre w4adm mail SMTP mail command PARAM TRE DESCRIPTION UNIX Param tre de configuration de l envoi de courrier Commande utilis e pour l envoi de courrier Valeur par d faut mail1x mailDir R pertoire de pick up utilis en protocole SMTP Valeur par d faut aucune param tre positionner obligatoirement si le param tre mail est positionn Exemple d utilisation du param tre w4adm mailDir C InetPub MailRoot Pickup mail optionsOnCommandlLine UNIX Param tre de configuration de l envoi de courrier D finit si les options sujet destinataires sont pass es sur la ligne de commande ou dans le corps du message Valeur par d faut TRUE si le param tre mail command est positionn mail FALSE sinon mail subjectOption UNIX Param tre de configuration de l envoi de courrier Mot cl pour l option sujet Valeur par d faut s si le param tre mail command est positionn mail s sinon mailSuffix Extension des messages post s dans le
4. Big Brother wfbigbrother 5 1 Automatic wfautomatic l Q Q Q o 01H amp NH Dans cet exemple on souhaite mesurer le co t des appels wf destination du programme wfdataminer responsable des fonctions search notamment Apr s avoir red marr W4 Engine et lanc un premier test applicatif on obtient un fichier dataminer prf sous le r pertoire 109 de W4 Engine dont le contenu a le format suivant 1 GetActor 0 01 1 GetActor 0 04 1 GetActor 0 01 1 GetActor OO 1 SearchRole 0 15 1 SearchActor 0 12 1 SearchServer 0 00 1 CheckRoleOfActor 0 00 1 GetActor OO 1 SearchCase 012 1 SearchCase 1 42 Le poids r el des API c t serveur est mesur ainsi au 1 100i me de seconde pr s Par exemple ici 2 searchCase sont faits dont le deuxi me est plus de 10 fois plus co teux que le 1er Gr ce ces mesures on peut valuer les requ tes redondantes boucles etc et calculer le co t global d une section de code appelant les API workflow On peut placer l option p sur le service wfscheduler pour valuer les appels de scheduling OnHoldTask EndTask 4 2 7 4 3 4 3 1 Check list V rifier le nombre d appels au moteur W4 Engine Avant de solliciter le moteur W4 Engine assurez vous que l information n est pas d j disponible dans un objet en m moire Employez si possible des m thodes du type get lt OBJECT gt lors de la recherche d un objet identifi Pensez util
5. o lt moduleName gt d signe un module unit de d veloppement de W4 Engine dont le nom est fourni par le support technique W4 Exemple wfadministrator t m objects Cette commande positionne les traces sur le module objects du processus administrator IMPORTANT Cette option si elle n est pas utilis e conjointement l option t n active pas les traces Retrait d un module dans la liste des l ments tracer m lt moduleName gt ou m lt moduleName gt o lt moduleName gt d signe un module unit de d veloppement de W4 Engine dont le nom est fourni par le support technique WA IMPORTANT Cette option si elle n est pas utilis e conjointement l option t ne d sactive pas les traces 3 9 2 4 392 25 Ajout de tous les modules dans la liste des l ments tracer all Exemple w4 trace cgi t all Cette commande positionne les traces sur tous les modules du processus CGI Retrait de tous les modules de la liste des l ments tracer all Ordre des options de trace Veillez respecter l ordre suivant pour les options de trace 1 option de traces de performances p p 2 option d activation ou de d sactivation des traces t t 3 option de d cryptage ou de cryptage d d 4 option d ajout ou de retrait de modules m m all all Visualisation de l tat des traces Fichier d tat des traces L tat des options de trace pour le processus CGI est
6. Archival Online Archeve Panoccal Offine Date of the first archiving 18 1 2005 Administration Coordination Work Items Home page Time whenthe archiving was executed Frequency month s Logout List of persans to be informed D Later Archivol A Concel Fig 3 10 Archivage online p riodique 3 3 Cet cran vous permet de d finir les param tres de l archivage Table 3 8 Archivage online p riodique 2 2 CHAMPS DU FORMULAIRE DIELO Intitul Intitul du dossier d archive 9 Chapitre 3 Administration CHAMPS DU FORMULAIRE DESCRIPTION Description Description du dossier fonctionnement d tails etc Date du premier archivage utilise les crit res d finis dans la section Date du premier archivage Le pr c dente Heure d ex cution de Date laquelle la t che d archivage p riodique sera effectu e pr f rer une l archivage heure laquelle peu d utilisateurs se connectent W4 Engine Fr quence P riodicit de l archivage Liste des personnes Une t che de notification est envoy e apr s chaque archivage Veuillez informer s lectionner l ensemble des coordinateurs int ress s par cette information Les actions suivantes peuvent tre effectu es sur cette t che Archivage imm diat Les dossiers correspondant aux crit res sont archiv s imm diatement L archivage suivant est d fini par la fr quence Archivage u
7. Chapitre 3 Administration 3 7 3 3 7 4 S lectionner le bouton modifier le dossier L cran est le m me que pour la d finition des crit res Archivage offline Objet Archivage des dossiers un moment ponctuel vers des fichiers Seuls les dossiers termin s ou annul s peuvent tre archiv s Depuis la version 5 0 de W4 Engine il est possible d archiver offline des dossiers archiv s online Les fichiers d archive sont nomm s lt caseName gt lt procedureName gt lt caseEndDate day gt lt caseEndDate month gt lt caseEndDate y ear gt ARCH Les fichiers d archivage offline peuvent tre nomm s workcase lt caseld gt arch Il faut alors configurer le param tre archFileName useCasela du fichier waserver cfg Menu Archivage offline Archiver La page Archivage offline s affiche Cette page est identique la page d archivage online voir ci dessus Restauration Objet Restauration des fichiers d archive dossiers archiv s offline vers les tables W4 Menu Archivage offline Restaurer La page Archivage offline s affiche Les champs sont identiques ceux de la page d archivage online voir ci dessus L action S lection avant restauration r pertorie les dossiers correspondant aux crit res avant restauration effective L action S lection pour restauration imm diate restaure directement les dossiers correspondant aux crit res L action effacer r initialise les crit res du fo
8. Description L utilitaire wfwatchsrv surveille les services W4 et relance ceux dont le nombre est inf rieur au nombre initial sp cifi dans le fichier de configuration Config lt instanceName gt Le fichier Config lt instanceName gt est d crit dans le chapitre suivant 2 1 Fichiers de configuration page 20 IMPORTANT L utilitaire wfwatchsrv ne lit pas directement le fichier de configuration mais demande cette information au serveur W4 Engine Si le fichier de configuration a t modifi depuis le d marrage cette modification n est pas prise en compte Utilisation Ajoutez la ligne suivante dans le fichier de configuration w server cfg situ sous lt softwareHome gt sys C WatchSrv wfwatchsrv 1 Exemple surveillance du serveur toutes les 30 secondes C Watchsrv wfwatchsrv 30 1 Options interval Cette option d finit l intervalle de temps en secondes utilis entre deux surveillances Par d faut 60 secondes traceArgs Arguments de trace 9 9 2 921 39 2 2 Les traces sont d crites dans le chapitre suivant 3 2 2 races page 113 Traces IMPORTANT Le m canisme des traces doit tre mis en uvre sur demande du support technique W4 En dehors de ce cas il est d conseill d activer les traces celles ci ayant un impact sur les performances des processus trac s l exception de l option de d cryptage voir ci dessous Mode d activation Les traces sont activables par pro
9. Fig 3 8 Archivage online p riodique 1 3 S lectionnez Nouveau dossier d archive L cran de d finition des crit res s affiche Il se d compose en 2 parties a S lection des dossiers archiver s Param trage de l archivage Chapitre 3 Administration u3 w4adm w4adm Archival Online archive Penodical Offline Administration Coordination Work Items Home page Logout Archival Periodical Selecting work cases to be archived state M gt done v nse unse unel unse O variable Ovakve Clvariabie Dvate O Work cases completed before M 18 Ml januay m2005 O Work cases done for more than days month s vear s maxiruen count 10 sorted by unset sort order oscendng M Fig 3 9 Archivage online p riodique 2 3 Cet cran vous permet de d finir les crit res de s lection des dossiers W4 Engine archiver Ces crit res sont restrictifs op rateur AND entre chaque crit re Table 3 7 Archivage online p riodique 1 2 CHAMPS DU FORMULAIRE DESCRIPTION 1 re ligne Recherche les dossiers en fonction de leurs tats termin ou annul 2e 3e 4e lignes Recherche des dossiers en fonction d un nom de dossier d un nom d acteur d un nom de proc dure d un nom de responsable d un nom d initiateur d un nom d v nement ou d un nom de serveur 5e ligne Recherche des
10. SQL gt begin dbms_stats gather schema stats ownname gt W4 cascade gt TRUE end o w4 est le nom du sch ma de base W4 Engine IMPORTANT Cette derni re commande peut prendre un certain temps Elle peut tre lanc e tout moment et il n est pas n cessaire d arr ter la base Taille du database block size W4 pr conise une taille minimale de 8 KB 8192 octets R utilisation des curseurs WA pr conise de placer le param tre CURSOR_SHARING la valeur SIMILAR ou FORCE pour les versions d Oracle au moins gales 9iR2 Ce param tre permet de r duire l analyse des requ tes lorsque celles ci pr sentent peu de diff rences ce qui est le cas pour les requ tes W4 Engine Enfin la modification de ce param tre peut permettre de r duire l utilisation de la m moire 4 4 2 44 3 Microsoft SQL Server Fragmentation des index W4 pr conise de d fragmenter r guli rement les index de la base de donn es W4 Engine afin d viter des lectures disque inutiles La commande DBCC DBREINDEX permet de reconstruire les index de toutes les tables La commande DBCC INDEXDEFRAG d fragmente les index associ s une table M moire W4 pr conise de modifier le param tre max worker threads de la valeur 255 32 Ce param tre indique le nombre maximum de connexions la base de donn es Or W4 Engine n utilise que 5 connexions La r duction de la valeur par d faut permet de gagner un peu de m moire De m
11. Visualisation des v nements d finis sur les dossiers Coordinator Le menu Archivage donne acc s aux commandes d archivage online d archivage offline et de restauration des dossiers Table 3 3 Menu Archivage ACTION R LE MINIMUM REQUIS Online Archiver Archivage de dossiers un moment ponctuel vers les tables d archive de la base de donn es W4 Engine Coordinator Online P riodique D finition des param tres d un archivage p riodique vers les tables d archive de la base de donn es W4 Engine IMPORTANT Pour utiliser la fonctionnalit d archivage p riodique en Java vous devez imp rativement mettre jour la proc dure Archivage Coordinator Offline Archiver W4 Engine Man uel d exploitation ACTION R LE MINIMUM REQUIS Archivage des dossiers un moment ponctuel vers des fichiers Coordinator Offline Restaurer Restauration des fichiers d archive vers les tables W4 Engine Coordinator L archivage est d crit dans le chapitre suivant 3 7 Archivages page 92 Le menu Corbeille donne acc s aux cinq derni res t ches toutes proc dures confondues Table 3 4 Menu Corbeille T che Acc s aux t ches en cours et aux t ches en libre service Acteur connect Dossier Modification de dossiers Annulation de dossiers Suppression de dossiers R le responsable de la proc dure associ e Mo
12. licences utilisateurs concurrentes galement d sign es licences flottantes licences utilisateurs d clar s licences mixtes Licences utilisateurs concurrentes Chaque utilisateur log est d compt pour une licence Quand il se d loge ou quand sa session expire sa licence est lib r e Si un nouvel utilisateur demande se loger et qu il ne reste plus de licence libre le syst me recherche parmi les sessions suspendues ventuelles la plus proche de son d lai d expiration et force son expiration lib rant ainsi une licence La session est cr e avec un nouveau lid Si toutes les sessions sont actives la connexion est refus e Pour l utilisateur d log dans ces conditions le syst me se comporte comme pour une expiration normale NOTE Ilest souhaitable que les sites en licences concurrentes offrent des proc dures dont les crans mettent bien en vidence l op ration de d connexion 3 8 5 2 3 8 5 2 1 3 8 5 2 2 Licences utilisateurs d clar s La d claration des acteurs se fait au moyen d un r le pr d fini declared Un acteur est dit d clar s il poss de le r le declared I n y a pas de limite au nombre d acteurs qui peuvent tre d clar s Cependant l acc s au serveur n est garanti que pour un nombre d acteurs dans la limite de la capacit de la licence Au d marrage le serveur tablit la liste des acteurs d clar s Il attribue chacun de ces acteurs une entr e dans le
13. lt init param gt lt init param gt lt param name gt pool size lt param name gt lt param value gt 10 lt param value gt lt init param gt lt init param gt lt param name gt pool serverName lt param name gt lt param value gt w4Server lt param value gt lt init param gt lt init param gt lt param name gt pool instanceName lt param name gt 4 2 3 3 4 2 4 lt param value gt w4Prod lt param value gt lt init param gt Lors de l arr t du serveur d application le servlet W4 ferme automatiquement les connexions du pool Contraintes d utilisation Au sein d une m me JVM un mode mixte cumulant le pool et les connexions syst matiques n est pas possible Au sein d une m me JVM seule l instance du serveur W4 Engine sur laquelle le pool est configur est accessible Fermeture des connexions avec le serveur W4 Engine IMPORTANT Valable uniquement si un pool de connexion n est pas utilis La communication physique entre un client C Java Com Net et le serveur W4 Engine s appuie sur les IPC sous Linux ou Unix et sur les tubes nomm s sous les plateformes Win32 Qu il s agisse des IPC ou des tubes nomm s ce sont des ressources syst me limit es Il faut donc veiller ne pas les puiser en les lib rant correctement sous peine de voir les performances de l application se d grader puis le serveur tomber Les exemples de code ci dessous exploitent au maximum la capacit des langage
14. IMPORTANT Augmenter la valeur de ce param tre risque de mobiliser le moteur plus longtemps pour chaque notification Valeur par d faut 1 Exemple d utilisation du param tre w amp 4adm HTTPNotifTimeOut second 1 includeUriTimeOut UNIX seulement positionne un timeout en secondes sur l instruction include_url Valeur par d faut 900 Exemple d utilisation du param tre w amp adm includeUrlTimeOut 60 initialCapacity Taille initiale de la table interne des logins du CMD dans le cas o la licence a une capacit illimit e Valeur par d faut 1000 Commentaire la table s accro t automatiquement le cas ch ant insertEmptyString Lorsque ce param tre d instance est positionn TRUE les valeurs de type cha nes de caract res sont initialis es vide et non null SQL Server Valeur par d faut FALSE instanceHome R pertoire d installation de l instance Valeur par d faut aucune param tre positionner obligatoirement Exemple d utilisation du param tre waadm instanceHome c Program Files w4 ipcQueueRights PARAM TRE DESCRIPTION Droits n cessaires un programme client pour communiquer avec W4 Engine en environnement UNIX serveur d application par exemple Valeur par d faut 0600 Exemples d utilisation du param tre waadm ipcQueueRights 0660 waadm ipcQueueRights 0666 Commentaire 0660 le propri taire d
15. Only actors already existing in W4 est s lectionn e aucun acteur n est cr et les acteurs d j existants dans W4 Engine sont mis jour Siles champs Base Filtre LDAP LDAP filter et Scope ne sont pas renseign s les valeurs par d faut sont utilis es Si le champ Nom de l acteur Actor s name est renseign seuls les champs de cet acteur d j existant dans W4 Engine seront mis jour Description de la configuration Si le dossier LDAP a d j t cr un menu est disponible sous la corbeille au centre de la page ce menu comporte entre autres le lien Description de la configuration S lectionnez ce lien pour afficher la page de description de la configuration W4 Engine Manuel d exploitation 50 2 2 5l You ses connected s v sdm L 12 Rephcate object s Administrator Dataminer Scheduler LDAP Exclusive LDAP Exchange attributes during connection connection Connec bon Authentication Authentication directory creation Yes ves ves No No No yes Referentials used for GatActor and Getfiole W4 attributes only LDAP client ibrary libidapssi141 50 Server address 127 168 0 160 Port Number 389 ON used for W4 authentication Use the logging in actor s DN No Ldap bind tm eout ms 500 Ldap search timeout s 5 Actors Create actors on the fly Yes Update role assignation Yes Update actors attnbutes at each logn No Use fiter ves Accapt only ctors whoa are members of a group No Laft
16. S lectionnez cette case cocher si l annuaire utilis est Exchange test effectu avec Exchange 5 5 SP4 pour Windows NT Dans ce cas l authentification est faite avec le DN dans lequel le cn a t remplac par le nom de compte Cette option n est utile qu en authentification LDAP 225 5 R pliquer les attributs des objets lors de leur cr ation Replicate object s attributes during creation S lectionnez cette case cocher si vous souhaitez que les attributs des acteurs et des r les soient r pliqu s lors de leur cr ation dans W4 Engine 225 16 Version du protocole Protocol version S lectionnez le bouton d option correspondant la version du protocole support par l annuaire utilis V2 ou V3 225 17 R f rentiels utilis s pour les GetActor et GetRole Referentials used for GetActor and GetRole Si vous avez s lectionn la case cocher Connexion du dataminer plusieurs possibilit s existent pour le fonctionnement des fonctions GetActor et GetRole S lectionnez l un des boutons d options suivants LDAP et W4 si les attributs doivent tre recherch s dans LDAP et dans W4 Engine s LDAP seulement si les attributs doivent tre recherch s uniquement dans LDAP a W4 seulement si les attributs doivent tre recherch s uniquement dans W4 Engine 225 18 Librairie cliente LDAP LDAP client library Dans ce champ de saisie renseignez les biblioth ques LDAP utilis es Sur UNIX la biblioth que util
17. ceux de la base de donn es technique utilis e par le moteur La d marche propos e ici s appuie sur le fait qu une application W4 est compos e de trois l ments application serveur W4 Engine base de donn es Le probl me des performances doit tre envisag dans son ensemble c est dire par rapport chacun de ces l ments Ce document pr sente donc un certain nombre de guides pour s assurer que la couche applicative est performante s le serveur W4 Engine est bien configur s la base de donn es est correctement dimensionn e et bien configur e De plus on trouve dans ce chapitre une section sur les pratiques avanc es du produit tels que l archivage et l utilisation d un serveur de connecteurs Optimisation de l applicafif Une application performante est une application qui minimise au maximum le nombre d allers et retours avec W4 Engine Une application performante est aussi une application qui utilise les interfaces de W4 les plus optimis es possibles 4 2 1 4 2 2 Minimiser le nombre d allers et retours entre l applicatif et W4 Engine NOTE Dansles environnements COM et Java les m thodes des composants ou classes sollicitant le moteur W4 Engine sont pr fix es par les lettres wf Avant tout appel au moteur W4 Engine il faut toujours v rifier que l information que l on s appr te r cup rer n est pas d j disponible en m moire Exemple 1 sollicitation inutile de W4 Engine i
18. un acteur ou utilis dans le mode d assignation d une activit Activit Modification des activit s Suppression des activit s Author Author IMPORTANT lIlestimpossible de supprimer une activit associ e une proc dure existante Proc dure Modification des proc dures Suppression des proc dures Author Author IMPORTANT lIlestimpossible de supprimer une proc dure pour laquelle il existe des dossiers Script Cr ation d un script Author Suppression d un script Author Dictionnaire Cr ation d un dictionnaire Author Modification d un dictionnaire Author Suppression d un dictionnaire Author Langage Cr ation d un langage Author Modification d un langage Author Suppression d un langage Author Serveur H ACTION R LE MINIMUM REQUIS R f rencement d un serveur Modification d un serveur Suppression d un serveur Administrator Administrator Administrator Le menu Coordination permet de g rer les objets dynamiques Table 3 2 Menu Coordination ACTION R LE MINIMUM REQUIS T che Modification des t ches Annulation des t ches R affectation des t ches Cr ation des t ches r le Responsable de la proc dure associ e ou r le Coordinator Dossier Modification des dossiers Annulation des dossiers Suppression des dossiers r le Responsable de la proc dure associ e ou r le Coordinator v nement
19. 3 3 99 W4 Engine Manuel d exploitation Illustrations 158 159 Illustrations Modification des crit res d un dossier p riodique en cours 1 2 101 Modification des crit res d un dossier p riodique en cours 2 2 101 Recherche d un dossier archiv 103 Installation de l application Welcome Screens 1 2 137 Installation de l application Welcome Screens 2 2 138 Mise en uvre de W4 Engine en UTF 8 155 Index Numerics 104 ERROR_PIPE_BUSY 128 105 Error WFERR_IPC_WRITE 85 106 Error WFERR_IPC_READ 85 4 WFERR_EXEC W4 Engine 31 437 54 511 WFERR_ROUT_CONF_LOAD 31 613 Error WFERR_ROUT_EXPIRED_LOGIN 105 614 Error WFERR_ROUT_SUSPENDED_LOGIN 105 621 Error WFERR_ROUT_ACTOR_TABLE_FULL 110 Acteur absent 43 Acteur automatique 109 Acteur w4adm 109 Acteurs non d clar s W4 Engine 106 Acteurs rempla ant 43 Activit du serveur W4 Engine 19 Activit supprimer W4 Engine 77 Administrator service de W4 Engine 12 AL32UTF8 154 Alias W4Public W4 Engine 74 alias Activities param tre d instance W4 Engine 23 alias Templates param tre d instance W4 Engine 24 alias Templates Mail param tre d instance W4 Engine 24 Annuaire LDAP configuration W4 Engine 16 Annuaires LDAP 16 API NET ti API buildtime 12 API C 11 API Java 11 API runtime 12 Applications W4 BPM Suite optimisation 120 W4 Engine Manuel d exploitation 160 161 Index archFileName useCaseld param tre d instance W4 Eng
20. Disconnect from the W4 server console w4 80 Distributeur central de messages W4 Engine 11 enableRevisionNumberControl param tre d instance W4 Engine 30 enableTransactionControl param tre d instance W4 Engine 30 enableTransactionControl param tre d instance W4 Engine 13 Erreur 2003 w4eimport 145 147 149 Erreur 2005 w eimport 144 147 Erreur 2052 w4eimport 146 Erreur 2098 w4eimport 147 149 Erreur 2102 w4eimport 147 149 Erreur 2115 w4eimport 148 152 Erreur 9051 w4eimport 147 Expiration date W4 Engine 86 expirationDelay param tre d instance W4 Engine 32 expirationDelay param tre d instance W4 Engine 106 W4 Engine Manuel d exploitation 162 Export contents option du programme d installation W4 Engine 91 extensionConnectorPort param tre d instance W4 Engine 32 extensionRmiPort param tre d instance W4 Engine 32 Fichier 16 Fichier de configuration Config instanceName 16 Fichier de configuration Config instanceName W4 Engine 20 Fichier de configuration w4server cfg 16 Fichier de configuration w4server cfg W4 Engine 23 Fichiers arch W4 Engine 90 93 Fichiers env W4 Engine 90 Fichiers in W4 Engine 90 Fichiers 1og W4 Engine 90 Fichiers prf W4 Engine 90 Fichiers tra W4 Engine 90 Fichiers archive W4 Engine 90 Fichiers d archive W4 Engine 18 Fichiers journaux W4 Engine 18 88 Fichiers temporaires W4 Engine 18 87 Fichiers traces W4 Engine 18 89 Forward server W4 Engine
21. Les entr es sont s par es par une espace Dans ce cas si la connexion au premier annuaire choue une connexion au deuxi me annuaire est tent e et ainsi de suite 2251 1DN Utilis pour l authentification de W4 aupr s de l annuaire Mot de passe DN used for W4 authentication Password W4 Engine doit s authentifier pour effectuer des recherches dans l annuaire LDAP Il existe deux possibilit s fournir le DN et le mot de passe d un acteur qui poss de des droits en lecture dans l annuaire a fournir le DN de l acteur qui tente de se connecter W4 Engine 2251 Utiliser le DN de l acteur qui se loge Use the login in actor s DN Cette option n est active que lors d une mise jour la connexion Si les champs DN utilis pour l authentification de W4 aupr s de l annuaire et Mot de passe ne sont pas renseign s et si la case cocher Utiliser le DN de l acteur qui se loge n est pas s lectionn e la connexion de W4 Engine l annuaire sera anonyme Lorsque cette option est active un DN complet est construit par concat nation des valeurs des champs base gauche login et base selon le mod le suivant lt valeur du champ base gauche gt lt valeur du champ login gt lt valeur du champ base gt Lorsque cette option n est pas active on retrouve un acteur dans LDAP lorsqu il se connecte W4 en construisant un filtre de type nom valeur o nom est le nom d un attribut LDAP qui doit tre renseign dans le cha
22. ProcessComposerTutorial validation CREATED ACTIVITY OK ProcessComposerTutorial emission CREATED ACTIVITY OK ProcessComposerTutorial refus CREATED ACTIVITY OK ProcessComposerTutorial alarme CREATED ACTIVITY OK ProcessComposerTutorial CREATED PROCEDURE KO Error Server 2003 Si la modification du r le a r ussi le message MODIFIED ROLE OK est retourn C w4eimport gt w4eimport wiadm W w4adm f ProcessComposerTutorial w4 mr serviceAchat ex true serviceAchat MODIFIED ROLE OK Cr ation d activit s Dans la commande w4eimport sp cifiez en plus des param tres obligatoires Chapitre 6 Chargement d objets de mod lisation par script w4eimport 1 51 a l option ca suivie du nom de l activit ou de la liste des activit s cr er l option ex true si les autres objets du fichier ne doivent pas tre cr s IMPORTANT Les activit s cr er ne doivent pas exister sur le serveur au moment de l import Si l une des activit s existe sur le serveur au moment de l import et si vous avez positionn l option ex true seules les activit s situ es avant cette activit dans le fichier w4e sont cr es et l erreur Error Server 2052 est retourn e C wdeimport gt wdeimport w4adm W w4adm f ProcessComposerTutorial w4e ex true ProcessComposerTutorial alarme Process
23. dure et ses sous proc dures ventuelles a entre deux r les li s par une propri t Upper Role La syntaxe suivante est donc proscrire w4eimport cp lt sous procedure gt cp lt procedure gt x tru Pour obvier ce probl me quand il se pose la solution consiste ex cuter plusieurs commandes w4eimport Par exemple pour une d pendance entre proc dures w4eimport cp lt sous procedure gt x tru w4eimport cp lt procedure gt x tru NOTE w4eimport sait traiter le cas des proc dures r cursives d pendantes donc d elles m mes Ces conditions d utilisation sont soigneusement d taill es par la suite Erreurs de syntaxe possibles a Sila syntaxe est incorrecte par exemple si une option sp cifi e est erron e l erreur Error Server 2 est retourn e Dans ce cas aucun objet n est cr m me si l une des options sp cifi es est correcte Si vous sp cifiez une liste d objets en argument d une option les l ments de la liste doivent tre s par s par une virgule sans espace Si vous ins rez une espace seuls les objets sp cifi s avant 6 3 6 3 l espace sont cr s L objet suivant l espace tant consid r comme un argument par la commande l import s arr te et une erreur signalant la pr sence d un argument erron est retourn e Si le chemin ou le nom du fichier w4e est erron dans l argument pass l option f l erreur Error Server 32 est retourn e Dans
24. e Utile pour le support NOTE Cesfichiers taient suffix s en err dans les versions ant rieures la version 2 02 00 Localisation UNIX var adm w4 log Windows lt softwareHome gt adm log Nommage UNIX lt processName gt lt PID gt 1og o PID est le process identifier du processus tel que fourni par la commande ps Windows lt processName gt lt PID gt log o PID est le process identifier du processus tel que fourni par le Gestionnaire de t ches Exemple UNIX var adm w4 log wfbroadcaster813 log processus wfbroadcaster de PID 813 Windows lt softwareHome gt adm log wfbroadcaster813 log processus wfbroadcaster exe de PID 813 Format des fichiers log lt date gt lt heure gt lt niveau d erreur gt error lt num ro erreur gt lt nom fonction gt lt fichier de la fonction gt lt n ligne de report incident dans fichier gt lt n ligne d tection incident gt Exemple de fichier log 1998 04 29 11 31 30 2 error 107 WFReceiveIPCMessag H w4 src ipcapi ipcemd32 c 622 577 1998 04 29 11431530 2 error 412 WFReceiveMessag H w4 src msgapi msgrouter c 667 648 Fichiers de traces IMPORTANT Lecontenu de ces fichiers est destin au support technique WA Objet Les fichiers de traces enregistrent le d roulement de tout processus dont la trace a t activ e la demande du support technique WA Les traces sont d crites dans le chapitre suivant 3 9 2 Traces page 11
25. f ProcessComposerTutorial w4e r ProcessComposerTutorial ex true ProcessComposerTutorial REVISED PROCEDURE KO Error Server 2102 L erreur Error Server 2003 est retourn e tant que les r les d pendant de la proc dure ne sont pas cr s sur le serveur C w4eimport gt w4eimport w4adm W w4adm ProcessComposerTutorial w4e r ProcessComposerTutorial ex true ProcessComposerTutorial REVISED PROCEDURE KO Error Server 2003 L erreur Error Server 2098 est retourn e tant que les activit s d pendant de la proc dure ne sont pas cr es sur le serveur C wdeimport gt wdeimport 1 w4adm W w4adm f ProcessComposerTutorial w4e r ProcessComposerTutorial ex true ProcessComposerTutorial REVISED PROCEDURE KO Error Server 2098 Si la r vision de la proc dure a r ussi le message REVISED PROCEDURE OK est retourn C w4eimport gt w4eimport 1 w4adm W w4adm f ProcessComposerTutorial w4e r ProcessComposerTutorial ex true ProcessComposerTutorial REVISED PROCEDURE OK NOTE Si vous tentez de r viser une proc dure qui n existe pas sur le serveur la proc dure est cr e en r vision 1 Cas d utilisation Cette section d crit en d tail les cas d utilisation les plus courants de w4eimport Dans les exemples ci dessous on utilise un fichier w4e repr sentatif le fichier W 4eimportSamples wd4e r alis sous
26. faut o PARAM TRE DESCRIPTION caseSensitive Activation du mode sensible la casse lors de la manipulation des noms d objets W4 Valeur possible TRUE FULL FALSE Pour plus de d tails sur l utilisation de ces valeurs veuillez consulter le chapitre suivant 4 Optimisation des performances page 120 Valeur par d faut FALSE Exemple d utilisation du param tre w4adm caseSensitive TRUE Commentaire l utilisation des index de base de donn es se fait alors correctement checkDelegationPri vileges Lorsque ce param tre d instance est positionn FALSE tout acteur quels que soient ses droits peut d l guer toute t che sans rencontrer l erreur 3040 WFERR_SCHD_INSUFF_PRIVILEGES Valeur par d faut TRUE Exemple d utilisation du param tre w4adm checkDelegationPrivileges FALSE cmdTimeOut Pose un d lai maximum d attente pour le CMD exprim en secondes Lors de l attente de l arriv e d un nouveau message si le d lai est d pass le CMD s arr te Lors de l envoi d un message si le CMD se bloque il s arr te Valeur par d faut o infini Exemple d utilisation du param tre waadm cmdTimeOut 60 databaselnstance F LE 51 PARAM TRE DESCRIPTION ODBC nom de la base de donn es Oracle nom de l instance de la base de donn es locale ignor si le param tre databaseServer est positionn Valeur par d faut ODB
27. me fichier de configuration w4server cfg peut donc tre utilis pour les machines du cluster listen Ce param tre d instance permet W4 Engine d couter les connexions entrantes sur une IP particuli re de la machine o il est install Il prend pour valeur une IP valide pour la machine ou un nom symbolique correspondant cette IP localhost par exemple Lorsque ce param tre n est pas positionn W4 Engine coute sur toutes les IP de la machine Valeur par d faut aucune quivaut toutes les adresses IP Exemple d utilisation du param tre w adm listen localhost listenerUseThreads F d z1 PARAM TRE DESCRIPTION Cr ation de filaments pour la gestion des connexions entrantes Valeur par d faut true Exemple d utilisation du param tre w 4adm listenerUseThreads true Lorsque le param tre d instance listenerUseThreads vaut la valeur true le programme concierge wflistener cr e des filaments pour g rer les connexions distantes Lorsque le param tre est absent ou vaut la valeur false le concierge cr e des processus en lieu et place des filaments Dans ce dernier cas lors de la mont e en charge sur Windows les connexions distantes peuvent provoquer des erreurs 19119 dues la surcharge en nombre de processus cr s lockingDelay D lai de verrouillage Valeur par d faut 1 heure Exemple d utilisation du param tre w amp adm lockingDelay minute 30 logDir
28. param tre d instance W4 Engine 36 java_xms param tre d instance W4 Engine 36 java_xmx param tre d instance W4 Engine 36 java_xnoclassgc param tre d instance W4 Engine 36 jconnector_port param tre d instance W4 Engine 36 jconnector param tre d instance W4 Engine 36 Journaux de trace CGI W4 Engine 90 Journaux de traces conditionnelles W4 Engine 90 JVM 123 LDAP Acteurs n existant que dans W4 W4 Engine 61 LDAP acteurs W4 Engine 56 LDAP adresse du serveur W4 Engine 54 LDAP annuaire Exchange W4 Engine 53 LDAP assignation des r les W4 Engine 62 LDAP attribut LDAP qui contient des DNs de groupes W4 Engine 59 LDAP attribut LDAP qui contient des DNs de r les W4 Engine 59 LDAP attribut LDAP qui contient des noms de r les W4 Engine 59 LDAP attribut Idap qui contient le login de l acteur W4 Engine 58 LDAP attributs W4 d pendant d une requ te LDAP W4 Engine 60 LDAP authentification exclusivement LDAP W4 Engine 53 LDAP Authentification LDAP W4 Engine 53 LDAP base gauche W4 Engine 58 LDAP base W4 Engine 58 LDAP comment retrouver les groupes dans LDAP W4 Engine 65 LDAP comment retrouver les r les dans LDAP W4 Engine 63 LDAP configuration de la s curit W4 Engine 56 LDAP configuration g n rale W4 Engine 52 W4 Engine Manuel d exploitation 164 LDAP configuration pour la mise jour automatique W4 Engine 66 LDAP configuration W4 Engine 46 LDAP connexion de l administrateur W4 Engin
29. viter au maximum que des acteurs ne puissent plus se loger sur le serveur W4 Engine En effet avec une telle licence un acteur non d clar n a aucun acc s au serveur Il faut malgr tout prendre garde que si le nombre d acteurs existants dans la base est sup rieur la capacit de la licence les avertissements suscit s seront mis au d marrage du serveur Il appartient alors l administrateur du serveur de retirer le r le declared aux acteurs n ayant pas l usage du serveur W4 Engine Sur les serveurs munis d une licence flottante ou mixte le r le declared est attribu aux seuls acteurs w4adm et automatic Il appartient l administrateur du serveur de d clarer les acteurs appropri s Cette op ration peut tre faite progressivement apr s la remise en service du serveur W4 Engine La mise niveau d un serveur se fait automatiquement lors de la mise jour du logiciel On effectue alors les mises jour suivantes s cr ation du r le declared s attribution de ce r le aux acteurs w4adm et automatic s sila licence est exclusivement pour des acteurs d clar s attribution du r le declared tous les acteurs existants Licences mixtes L exp rience montre qu un syst me de workflow comprend une base d utilisateurs r guliers compl t e le cas ch ant d un ensemble d utilisateurs occasionnels Par ailleurs l usage du workflow s tendant certains utilisateurs occasionnels peuvent voluer en utilisateurs
30. wdeimport 1 w4adm w w4adm i w4adm f WdeimportSamples wde ex true cr Root Procedure UpperRol REM Les autres r les peuvent ensuite tre cr s en une seul commande w4eimport l1 w4adm w w4adm i w4adm f W4eimportSamples w4e ex true Gf Root Procedure Role Sub Procedure Role Sub Sub Procedure Rol REM Cr ation des activit s aucun ordre n est respecter les r les peuvent tre cr s en une ou plusieurs commandes w4eimport l1 w4adm w w4adm i w4adm f WdeimportSamples wde ex true ca Root Procedure Activity w4eimport l w4adm w w4adm i w4adm f W4eimportSamples w4e ex true ca Sub Procedure Activity Sub Sub Procedure Activity REM Lorsque les r les et les activit s sont cr s on peut cr er les proc dures On cr e d abord la sous proc dure Sub Sub procedur car elle d pend de la sous proc dure Sub Procedure wdeimport l w4adm w wdadm i wdadm f WdeimportSamples w4de ex true cp Sub Sub Procedur REM On cr e ensuite la sous procedure Sub Procedure car ell d pend de la proc dure Root Procedur w4eimport l w4adm w w4adm i w4adm f W4eimportSamples w4e ex true cp Sub Procedure REM Lorsque les sous proc dures sont cr es on peut cr er la proc dure w4eimport l1 w4adm w w4adm i w4adm f W4eimportSamples w4e ex true cp Root Procedure l ex cution du fichier de commandes les messages suivants s affichent l cr
31. 106 Concurrent logins W4 Engine 86 Configuration de l annuaire LDAP 16 Configuration des calendriers W4 Engine 17 Configuration LDAP W4 Engine 46 Connect to the W4 server console w4 80 Connexion des utilisateurs W4 Engine 19 Connexion W4 Engine fermeture 123 Connexion W4 Engine ouverture 123 Console d administration W4 18 Console W4 130 Console W4 commande w4 forward stop W4 Engine 87 Console W4 commande w4 license show W4 Engine 85 Console W4 commande w4 license W4 Engine 85 Console W4 W4 Engine 80 Contexte de session W4 Engine 104 Corbeilles des t ches optimisation 124 Courrier lectronique notification W4 Engine 17 Curseurs 132 Data Miner service de W4 Engine 13 Database block size dimensionner 132 databaselnstance param tre d instance W4 Engine 27 databaseOwner param tre d instance W4 Engine 28 databasePassword param tre d instance W4 Engine 28 databaseReadOnlyCursorTemplate param tre d instance W4 Engine 28 databaseServer param tre d instance W4 Engine 29 databaseUTF8Encoding param tre d instance W4 Engine 29 156 dbHint actorPool useExists param tre d instance W4 Engine 30 Declared actors W4 Engine 86 declared r le W4 Engine 109 110 defaultTaskHistory param tre d instance W4 Engine 30 D lai d expiration W4 Engine 105 106 107 D lai de suspension W4 Engine 105 106 107 D lai de verrouillage W4 Engine 107 D lais W4 Engine 19 D marrage du serveur W4 Engine 18
32. 8 4 3 8 4 1 3 8 4 2 peuvent tre adapt s au besoin de chaque site Par exemple le template LoginExpired html livr peut tre modifi pour ramener automatiquement l utilisateur sur la page d accueil Gestion des d lais Le serveur W4 Engine g re des d lais concernant les acteurs log s qui n ont pas interagi avec le serveur depuis un certain temps Ces d lais ont des fins de s curit et vitent l encombrement inutile du serveur Ils peuvent tre configur s et modifi s dynamiquement On distingue trois d lais s d lai d expiration s d lai de suspension a d lai de verrouillage D lai d expiration Un acteur connect qui reste inactif est d connect syst matiquement par le serveur la fin du d lai d expiration exactement comme s il s tait d connect explicitement par la commande logout La valeur par d faut de ce d lai est de 1 jour Il peut tre configur gr ce au param tre d instance expirationDelay et modifi dynamiquement par l acteur w4adm au moyen de la commande SetExpirationDelay La valeur courante peut tre obtenue par la commande GetExpirationDelay IMPORTANT La fonction SetExpirationDelay ne modifie le d lai d expiration que pour la dur e de la session en cours Elle ne modifie pas le fichier de configuration C est donc le d lai inscrit dans le fichier de configuration qui sera pris en compte au prochain red marrage du serveur Exemple configuration d un d lai d expirat
33. 87 G rer mes processus W4 BPM Workspace 79 G rer mon quipe W4 BPM Workspace 79 Gestion des d lais W4 Engine 19 Gestion des licences W4 Engine 18 19 Gestion des sessions W4 Engine 19 Gestion des utilisateurs W4 Engine 19 GetExpirationDelay W4 Engine 106 GetLockingDelay W4 Engine 107 GetSuspensionDelay W4 Engine 107 HTTPNotiflemplate param tre d instance W4 Engine 32 HTTPNotifTimeOut second param tre d instance W4 Engine 33 includeUriTimeOut param tre d instance W4 Engine 34 initialCapacity param tre d instance W4 Engine 34 insertEmptyString param tre d instance W4 Engine 34 Installation cloisonn e W4 Engine 82 163 Index Installation multi instances W4 Engine 82 Instance W4 Engine cr ation en UTF 8 156 instanceHome param tre d instance W4 Engine 34 Interface d administration Java JSP 17 Interface d administration CGI 17 Interface d administration CGI menu Administration W4 Engine 76 Interface d administration CGI menu Archivage W4 Engine 78 Interface d administration CGI menu Coordination W4 Engine 78 Interface d administration CGI menu Corbeille W4 Engine 79 Interface d administration CGI W4 Engine 74 IPC 127 ipcQueueRights param tre d instance W4 Engine 34 ISO 8859 1 154 java_classpath param tre d instance W4 Engine 35 java_home param tre d instance W4 Engine 35 java_other_param param tre d instance W4 Engine 35 java_sleepTime param tre d instance W4 Engine 35 java_xdebug
34. Utilisation du pool de connexion environnement Java 122 Initialisation d un pool en Java pur 122 Initialisation d un pool mode Web 122 Contraintes d utilisation 123 Fermeture des connexions avec le serveur W4 Engine 123 W4 Engine Manuel d exploitation 6 Exemples d optimisation 124 Corbeilles des t ches 124 Lancement d une t che 125 Outil de mesure de performances des API 126 Check list 127 Optimisation de W4 Engine 127 Rappel sur l architecture 127 Configuration des param tres d instance 128 Communication locale sous NT 128 Activation du mode case sensitive 128 D sactivation de la fonction upper role 129 Scalabilit interne de W4 Engine 130 Identification des services en surcharge 130 Configuration du nombre de services 130 Conclusion 131 Gestion du r pertoire tmp sous UNIX 131 Ma trise du mode d assignation Acteur avec la charge de travail la plus faible 131 Optimisation BD 132 Oracle 132 Microsoft SQL Server 133 IBM DB2 1733 Utilisation avanc e 134 Installation de l application Welcome Screens Chargement d objets de mod lisation par script w4eimport 11 Installation 140 Syntaxe 141 R f rence 143 Import implicite d un fichier w4e 143 Import explicite d un fichier w4e 144 Cas d utilisation 149 Script de cr ation 150 Script de modification 151 Script de r vision 152 7 Sommaire Mise en uvre de W4 Engine en UTF 8 Cr ation de l instance Oracle 154 Cr ation de la varia
35. Web Nom du processus associ wfbabel exe galement d sign service de traduction Transforme chaque commande d appel de dictionnaire en un texte correspondant la langue de l utilisateur et au contexte wfengine Nom du processus associ wfengine exe Programme impl mentant les services sachant traiter toute requ te Si le param tre d instance enableTransactionControl vaut TRUE le CMD utilise des services sachant traiter toute requ te en lieu et place des services sp cialis s Pour plus de d tails reportez vous la description du param tre d instance enableTransactionControl au chapitre suivant 2 1 2 Fichier de configuration w server cfg page 23 Processus client W4 Engine poss de galement un certain nombre de modules clients d crits ci dessous Listener Nom du service Listener Nom du processus associ wflistener exe galement d sign programme concierge service de client distant 1 13 Est l coute des connexions par socket IP sur le port sp cifi dans la configuration serveur par d faut 2511 D s qu il re oit une connexion distante par exemple en provenance d un serveur d application via les biblioth ques clientes W4 Engine il la traite et demande la cr ation d un filament qui prend en charge la communication avec la machine distante Ainsi il y a toujours un et un seul programme concierge l coute pour connecter les clients distants des filamen
36. Windows w4eimport s appuie sur le fichier WFcLink dil dont le chemin d acc s doit donc tre pr sent dans le PATH au lancement de w4eimport POUR V RIFIER LE BON FONCTIONNEMENT DE W4EIMPORT Ouvrez une fen tre de commandes et positionnez vous sous le r pertoire w4eimport contenant les fichiers programmes ji Ex cutez la commande w4eimport Le menu suivant s affiche pr c d de la ligne Usage expliquant le mode d utilisation de la commande w4eimport C w4eimport w4eimport Usage w4eimport l lt login gt w lt password gt i lt instanceName gt f lt W4eFile gt lt traceOptions gt options where options include cr lt role list separated by gt Create Roles cr lt role list separated by gt Create Roles ca lt activity list separated by gt Create Activities ca lt activity list separated by gt Create Activities cp lt procedure list separated by gt Create Procedures cp lt procedure list separated by gt Create Procedures mr lt role list separated by gt Modify Roles mr lt role list separated by gt Modify Roles mp lt procedure list separated by gt Modify Procedures mp lt procedure list separated by gt Modify Procedures r lt procedure list separated by gt Revise Procedures r lt procedure list separated by gt Revise Procedures ex lt truelfalse gt If true the object not listed on command line are ignored else they are created lt default value false gt x lt tru
37. bool en 0 ou 1 Il existe une proc dure W4 Engine W4Engine Home Procedures archivage W4e qui permet de planifier et ex cuter en backoffice l archivage selon des crit res et une p riodicit d finir Archivage off line toutes les informations relatives aux dossiers dossier t ches variables commentaires sont export es dans un fichier au format propri taire W4 Engine stock sous lt W4Engine Home gt archive Seules quelques informations sont conserv es en ligne afin d identifier les dossiers archiv s et ventuellement les restaurer archived case W4 recommande l utilisation de ces fonctions le plus r guli rement possible Serveur de connecteurs Lorsqu une proc dure utilise de nombreuses t ches automatiques W4 pr conise l utilisation de connecteurs Dans le cas o N activit s automatiques diff rentes doivent tre ex cut es par l acteur automatique W4 Engine s rialise leur ex cution ce qui peut tre contraignant si certaines t ches prennent plus de temps que d autres Si ces t ches automatiques sont transform es en t ches pour N connecteurs les traitements sont ex cut s en parall le d o un fort gain de performance na Installation de l application Welcome Screens Cette annexe ne concerne que les serveurs ant rieurs la version 4 1 pour lesquels le chargement de la proc dure d administration Welcome Screens n est pas syst matique lors de l installation du serveur Depuis la v
38. dans le champ Attribut LDAP d une entr e r les qui contient des DNs de r les ou d acteurs LDAP attribute of a role entry containing actor or role DNs l attribut d une entr e dans LDAP d finissant un r le qui contient des DN d acteur dans le champ Nom de l attribut LDAP qui contient le nom du r le LDAP attribute containing the role s name le nom de l attribut LDAP qui contient le nom du r le dans W4 Engine attribut name dans W4 Engine dans le champ Base la base pour les recherches dans le champ Filtre LDAP LDAP filter le filtre conditionnant la validit d un r le pour W4 Engine filtre pour les recherches dans la liste d roulante Scope le scope pour les recherches 1 13 rI 7 You ses connected sz v sdm A LDAP attribute W4 atinbute Acton description descripton W attribute LDAP value w4 value Action description LDAP vake W4 value Action administrator sdministraioe coordinstor Fig 2 11 LDAP R les et groupes 2 3 22544 Correspondance entre attributs LDAP et W4 LDAP and W4 attributes mapping Les correspondances entre attributs dans LDAP et attributs dans W4 Engine sont d finies de la m me fa on que pour les acteurs 22545 Correspondance entre valeur dans LDAP et valeur dans W4 LDAP and W4 values mapping Les correspondances entre valeurs dans LDAP et valeurs dans W4 Engine sont d finies de la m me fa on que pour les acteurs 22 5 46 Correspondance entre nom
39. de traces Utilitaires Les utilitaires Audit et WatchSrv peuvent tre configur s pour surveiller l activit du serveur Ces utilitaires sont d crits dans le chapitre suivant 3 9 1 Utilitaires page 111 Traces Le support technique W4 peut tre amen demander l activation des traces sur certains processus du serveur L activation des traces est d crite dans le chapitre suivant 3 9 2 Traces page 113 2 1 2 11 Configuration Ce chapitre d crit les param tres de configuration du serveur W4 Engine le mode de configuration de l annuaire LDAP le mode de configuration des calendriers Fichiers de configuration W4 Engine poss de deux fichiers de configuration fichier Config lt instanceName gt fichier w server cfg Fichier de configuration Config lt instanceName gt Objet Ce fichier de configuration est utilis au d marrage par W4 Engine pour conna tre le nombre d instances lancer pour chaque processus NOTE Sil option e est sp cifi e lors du d marrage ce fichier n est pas utilis Pour plus de d tails sur cette option reportez vous au chapitre suivant 3 3 2 D marrage du serveur page 81 CHAMP DESCRIPTION Localisation Ce fichier est situ sous lt softwareHome gt sys soit typiquement a sous Unix w4 sys Config w4adm a sous Windows C Program Files w4 sys Config w4adm Format l installation ce fichier est copi partir du mod le lt softw
40. dossiers en fonction de leurs niveaux de priorit 6e 7e ligne Recherche de dossiers en fonction de valeurs de variables de type cha ne de caract res Dossiers termin s avant Archivage des dossiers termin s avant une date sp cifi e dans ce champ Le dossier d archivage se termine lorsqu il n y a plus de dossier r pondant aux crit res s lectionn s Dossiers termin s depuis plus de Archivage des dossiers termin s depuis une dur e sp cifi e dans ce champ W4 Engine Manuel d exploitation 98 CHAMPS DU FORMULAIRE DESCRIPTION L archivage est effectu par paquets du nombre pr cis dans ce champ Le syst me it re tant qu il a des dossiers r pondant aux crit res s lectionn s La date de l archivage suivant est ensuite calcul e en fonction de la fr quence r d finie dans le champ Fr quence voir ci dessous Nombre maximum Ce crit re est d finir avec votre administrateur de base de donn es un nombre trop important pourrait poser des probl mes de tailles des Rollback Segments Tri des dossiers s lectionn s en fonction du nom de dossier de la date de Tri par cr ation de fin de d passement d alarme de la priorit de l tat de la proc dure associ e de l initiateur du responsable ou du r le du responsable Ordre de tri Tri des dossiers s lectionn s en ordre ascendant ou descendant Archiving s parameter setting vetadm w acm
41. me la d sactivation de la gestion dynamique de la m moire en modifiant les param tres min server memory max server memoryetset working set size peut permettre de gagner un peu de temps IBM DB2 Fragmentation W4 pr conise de v rifier r guli rement la fragmentation de la base de donn es W4 Engine gr ce la commande REORGCHK M moire La m moire cache positionn e lors de l installation de W4 Engine est tr s faible Les bufferpool peuvent tre augment s d un facteur 10 d s que la volum trie de la base augmente Par d faut la valeur est 250 pages de 8 ko par bufferpool soit 2 Mo Verrous Dans le cas d une mont e en charge importante il peut tre n cessaire d augmenter la m moire affect e aux verrous Le param tre LockList peut tre modifi de la valeur par d faut 128 2500 pour un serveur de production l unit tant la page de 4 ko La commande est alors db2 update database configuration for W4 using locklist 2500 o w4 est le nom de la base de donn es 4 5 Tris Dans le cas d une mont e en charge importante il peut tre n cessaire d augmenter l espace li aux tris afin de ne pas utiliser les tris sur disque tr s p nalisants en termes de temps de r ponse Il faut alors augmenter le param tre SortHeap qui contient un nombre de pages de 4 ko La valeur par d faut est 247 La commande pour modifier la valeur est db2 update database configuration for W4 using sortheap
42. moteur W4 Engine en RPC w eimport ne fonctionne qu en connexion directe IPC avec le serveur partir de l import d un fichier w4e w4eimport permet sur un serveur W4 Engine sur lequel Process Composer n est pas install de cr er ou modifier un r le ou une liste de r les cr er une activit ou une liste d activit s s cr er modifier ou r viser une proc dure ou une liste de proc dures L utilitaire w eimport reprend donc toutes les fonctionnalit s de d ploiement sur le serveur W4 Engine de Process Composer L utilitaire w eimport est d crit dans le chapitre suivant 6 Chargement d objets de mod lisation par script w4eimport page 140 Commandes en mode ligne Le programme w4 en mode ligne galement d sign console d administration ou console W4 donne acc s aux commandes suivantes arr t et d marrage du serveur gestion des licences s d marrage et arr t en mode CGI forward lorsque le serveur Web et le serveur W4 Engine sont situ s sur des machines distinctes a positionnement des traces visualisation des logins et processus de la session en cours Les commandes du programme w4 sont d crites dans le chapitre suivant 3 3 Commandes en mode ligne page 80 Fichiers li s l activit du serveur L exploitation du serveur W4 Engine g n re les types de fichiers suivants fichiers temporaires fichiers journaux a fichiers traces fichiers d archive Ces fic
43. objet cr C wdeimport gt wdeimport w4adm W w4adm f ProcessComposerTutorial w4e responsableDossierAchat CREATED ROLE OK responsableAchat CREATED ROLE OK serviceAchat CREATED ROLE OK ProcessComposerTutorial saisie CREATED ACTIVITY OK ProcessComposerTutorial validation CREATED ACTIVITY OK ProcessComposerTutorial emission CREATED ACTIVITY OK ProcessComposerTutorial refus CREATED ACTIVITY OK ProcessComposerTutorial alarme CREATED ACTIVITY OK ProcessComposerTutorial CREATED PROCEDURE OK 1j E 13 tae 6 3 2 NOTE Dans cet exemple le fichier w4e est situ sous le m me r pertoire que l outil w4eimport Il n est donc pas n cessaire de faire pr c der le nom du fichier w4e par son chemin dans la commande w4eimport IMPORTANT L import s arr te la premi re tentative de cr ation d un objet existant Par exemple tant donn que w4eimport cr e d abord les r les si le premier r le cr er existe d j sur le serveur l import s arr te sur cette premi re tentative de cr ation et aucun objet n est cr Le message lt nom de l objet gt CREATED lt type de l objet gt KO s affiche et l erreur Error Server 2005 est retourn e C wd4eimport gt wdeimport w adm W w4adm f ProcessComposerTutorial w4e responsableDossierAchat CREATED ROLE KO Error Server 2005 NOTE Vous o
44. proc dures d administration sont install es par d faut pour les serveurs d valuation et les serveurs de production Installation de la proc dure Calendar Sous Process Composer installez la proc dure Calendar en utilisant le fichier Calendar w4e fourni dans le r pertoire lt softwareHome gt Procedures Cr ation d une ic ne pour l application Calendar sur la page des services W4 Connectez vous l interface d administration CGI du serveur W4 Engine en tant qu un acteur du r le Administrator via un navigateur par l URL http lt server gt W4Public o lt server gt repr sente le nom ou l adresse IP du serveur Web Une fois connect sur la page des services W4 dans la section Services s lectionnez Ecrans d accueil Welcome Screens Cr ez un nouvel cran d accueil poss dant les caract ristiques suivantes 13 2 3 2 new welcome screen Create or modify welcome screen English Title Calender French Title Calendrier Spanish Title German Title Italian Title Type List of roles Select procedure Template no extension cslenderwelcome Presentation order 1 99 highest are first presented so Icon Miimages calender Horoge ot wW Terminate w On hold dd comment view Comments Fig 2 13 Configuration des calendriers L acc s l application Calendar est d sormais possible partir de la page des services W4 Acc s la corbeille de la proc dure Calendar Sur la page des
45. processName repr sente le nom du processus sur lequel est activ e la trace de performances sous le r pertoire des fichiers journaux de W4 Engine RAPPEL Le r pertoire des fichiers journaux de W4 Engine est le r pertoire log situ sous lt softwareHome gt lt instanceName gt pour Windows et var adm w4 pour UNIX L option p est d crite dans le document suivant 4 Optimisation des performances page 120 D sactivation de la trace des performances p Activation de la trace E D sactivation de la trace D cryptage des adresses URL processus CGI uniquement d Par d faut pour des raisons de s curit la partie des requ tes CGI qui appara t dans la barre d adresse du navigateur est crypt e soit par exemple http monServeur W4 cgi exe arg AsfkljtkjlgsfjsfdAsfjhsqfqsd12a78GCHS56dgsg hjfs46 En mode d crypt on obtiendrait http monServeur W4 cgi exe lg fr amp cmd Login amp error LoginError amp confirm true Le mode d crypt permet de valider les champs pass s dans la ligne Cette option est la seule qui puisse tre utilis e en dehors d une intervention du support technique W4 Elle permet de contr ler le contenu des arguments pass s aux programmes CGI via une page HTML et facilite ainsi le travail des auteurs D sactivation du d cryptage des adresses URL processus CGI Uniquement d Ajout d un module dans la liste des l ments tracer m lt moduleName gt ou m lt moduleName gt
46. r guliers W4 propose une structure de licences utilisateurs adapt e ces deux usages du workflow Dans cette structure de licence les utilisateurs r guliers sont chacun titulaires d une licence nominale dite utilisateur d clar tandis que les utilisateurs occasionnels partagent un certain nombre de licences dites flottantes Les deux types de licences peuvent cohabiter Le but des licences mixtes est de garantir l acc s au serveur W4 Engine un certain nombre d acteurs r guliers dits d clar s dans la limite de la capacit de la licence Les autres acteurs occasionnels peuvent acc der au serveur gr ce au partage des licences flottantes Pour eux l acc s au serveur W4 n est pas garanti dans la mesure o le nombre d acteurs occasionnels simultan ment actifs ne peut exc der la capacit des licences flottantes Une tentative infructueuse rend le code d erreur 621 trop de participants connect s Contr le de l activit du serveur Pour surveiller l activit du serveur W4 Engine les administrateurs ont leur disposition plusieurs utilitaires ainsi qu un m canisme de traces 9 1 SM Utilitaires Les utilitaires wfaudit et wfwatchsrv surveillent respectivement l activit des instances W4 Engine et les services W4 wfaudit surveillance du serveur Synopsis w faudit interval traceArgs Description L utilitaire wfaudit surveille et enregistre l activit d une instance W4 Engine intervalles r gu
47. stock dans le fichier lt instanceName gt trc sous lt softwareHome gt adm pour Windows et sous var adm w4 pour UNIX soit typiquement w4adm trc Console W4 Commande w4 trace w4 trace show puis validez par Entr e quivalent menu 9 puis validez pour afficher le sous menu Server trace 1 puis validez par Entr e Le r sultat de cette commande donne l tat des traces pour le processus CGI Pour chacun de ces processus laligne Time logging fournit le positionnement de l option p laligne Crypt ing fournit le positionnement de l option s laligne Trace fournit le positionnement de l option t a laligneList of traced modules fournit le positionnement des options met a11 3 9 2 6 Dans l illustration ci dessous aucune option de trace n est positionn e pour le processus CGI W4 Server wdadm on machine roussette Options for the cgi processes Time logging is off Crypting is on Trace is off List of traced modules None Dans l illustration ci dessous les traces sont activ es sur le processus CGl W4 Server wdadm on machine roussette Options for the cgi processes Time logging is off Crypting is on Trace is on List of traced modules objects msgapi ipcapi Les modules concern s sont list s Il s agit de objects msgapi et ipcapi Exemples Options d d pour le processus CGI CGl en mode d crypt w4 trace cgi d CGI en mode crypt w4 trace cgi d Optio
48. suivante dans le fichier de configuration w4server cfg w adm lockingDelay minute 15 NOTE Lorsque l authentification est externe W4 Engine le d verrouillage d un logement s effectue de fa on transparente et l acteur n a pas fournir de mot de asse au niveau de W4 Engine Ce d lai n est donc significatif que lorsque authentification est g r e par WA Modification des d lais Les valeurs par d faut des d lais peuvent tre modifi es Il est par ailleurs possible de moduler le d lai de suspension mais non le d lai d expiration par acteur et par r le Au cas o plusieurs d lais 3 8 5 3 8 5 1 de suspension doivent tre pris en compte par exemple un acteur ayant deux r les avec des d lais diff rents le d lai le plus long est retenu NOTE Les API de manipulation des d lais ne sont pas disponibles dans des crans HTML L administrateur peut entrer la commande la main dans la barre d adresse du navigateur ou encore utiliser un cran HTML ad hoc qu il aura d fini ou enfin crire un petit programme C Les API concern es sont les suivantes a SetActorSuspDelay SetRoleSuspDelay GetSuspensionDelay SetSuspensionDelay GetExpirationDelay SetExpirationDelay Les API GetActorSuspDelay et GetRoleSuspDelay n existent pas Un contournement consiste consulter la propri t suspensionDelay de l acteur ou du r le Contr le des licences Il existe trois types de licences
49. 112 W4 Engine Manuel d exploitation 170 171 Index u W4 ENGINE MANUEL D EXPLOITATION R f rence WANG OPERATING 020 FR Pour toute remarque ou suggestion concernant ce document vous pouvez contacter le support technique W4 en pr cisant la r f rence du document a par le service de traitement des dossiers Supportflow sur MyWA4 com l adresse suivante http support myw4 com a Par courrier lectronique support w4global com a Par t l phone 33 0 820 320 762
50. 3 Les fichiers de traces sont de trois types ra Journaux de traces conditionnelles suffix s par tra Les fichiers tra ne contiennent que des lignes de niveau de rapport 5 Journaux de trace CGI suffix par in et env lorsque la trace des processus CGI est active Ils permettent de capturer le contenu de l entr e standard et de l environnement d ex cution d un processus CGI Fichiers utiles l auteur de proc dures ou au concepteur d crans Enfin si des mesures de performances sont activ es la demande du support technique W4 des fichiers suffix s prf peuvent tre pr sents Localisation lt softwareHome gt adm log Nommage w4 lt processName gt lt PID gt lt tra inenv prf gt Exemple lt softwareHome gt adm log w42184 tra Format des fichiers tra Format identique aux fichiers log voir ci dessus Fichiers archive Objet Au d marrage du serveur W4 Engine les fichiers log tra et prf existants correspondant la derni re session du serveur sont archiv s dans un fichier archive suffix par arch par simple concat nation avec s parateur sans compression comme le nom pourrait l induire Les fichiers in et env sont quant eux supprim s Les fichiers archives ne sont jamais d truits par le serveur W4 Engine En principe l administrateur peut d truire les archives des sessions ant rieures il est cependant pr f rable de les garder quelques jours pour pouvoir exploiter
51. 512 Utilisation avanc e Archivage des dossiers workflow Au cours de la dur e de vie d un workflow les tables W4 Engine grossissent en permanence et les requ tes prennent logiquement plus de temps s ex cuter Notamment les objets relatifs aux dossiers termin s et en cours t ches variables dossiers etc cohabitent dans les m mes tables et d une fa on g n rale les performances des requ tes BD d pendent du nombre de dossiers d j trait s dans le temps Cela s av re tre une solution instable en termes de performances long terme Afin de maintenir la puissance d une application au cours du temps on a recours l archivage des donn es Deux types d archivage sont disponibles au niveau du serveur W4 Engine l archivage on line et l archivage off line Les archivages sont activables via l interface Web workflow classique Archivage on line toutes les informations relatives aux dossiers dossier t ches variables commentaires sont d plac es dans d autres tables de la base de donn es online archived case online archived task online archived case var cequi d charge le volume des tables les plus sollicit es vorkcase task case variable Ces tables appartiennent un tablespace diff rent qui peut tre plac sur un disque diff rent Ainsi tous les l ments des dossiers archiv s on line peuvent tre consult s comme les dossiers non archiv s Le crit re de recherche est WF CRIT ARCHIVE
52. C lt databaseOwner gt en majuscule ORACLE variable d environnement ORACLE SID Exemple d utilisation du param tre w adm databaselnstance W4ORA databaseOwner Identifiant de l utilisateur de base de donn es propri taire du sch ma Valeur par d faut aucune param tre positionner obligatoirement Exemple d utilisation du param tre w adm databaseOwner w4 databasePassword Mot de passe crypt de l utilisateur de base de donn es propri taire du sch ma Valeur par d faut aucune param tre positionner obligatoirement Exemple d utilisation du param tre w4adm databasePassword 7ieh databaseReadOnlyCursorTemplate PARAM TRE DESCRIPTION D finition d un mod le personnalis pour la d claration des curseurs en lecture seule SQL Server Valeur par d faut aucune Si le param tre databaseReadOnlyCursorTemplate est utilis la valeur de ce param tre est utilis e comme mod le pour la d claration des curseurs Les mots cursorName et selectStatement cf param tre d instance SQLDialect doivent alors tre remplac s par le symbole s Exemple d utilisation du param tre w4adm databaseReadOnlyCursorTemplate DECLARE s CURSOR FORWARD_ONLY STATIC READ ONLY FOR s Dans cet exemple le mod le utilis sera DECLARE cursorName CURSOR FORWARD_ONLY STATIC READ_ONLY FOR selectStatement IMPORTANT Une mauvaise valeur de ce param tre peut entra ner des dysfon
53. ComposerTutorial emission ProcessComposerTuto E rial validation ProcessComposerTutorial refus ProcessComposerTu torial saisie ProcessComposerTutorial saisie CREATED ACTIVITY OK ProcessComposerTutorial validation CREATED ACTIVITY OK ProcessComposerTutorial emission CREATED ACTIVITY KO Error Server 2052 T Si l option ex est positionn e false les r les et les activit s situ s avant cette activit dans le fichier w4e sont cr s et l erreur Error Server 2052 est retourn e C w4eimport gt w4eimport w4adm W w4adm f ProcessComposerTutorial w4e ex false Ca ProcessComposerTutorial alarme ProcessComposerTutorial emission ProcessComposerTut E orial validation ProcessComposerTutorial refus ProcessComposerT utorial saisie E responsableDossierAchat CREATED ROLE OK responsableAchat CREATED ROLE OK serviceAchat CREATED ROLE OK ProcessComposerTutorial saisie CREATED ACTIVITY OK ProcessComposerTutorial validation CREATED ACTIVITY OK ProcessComposerTutorial emission CREATED ACTIVITY KO Error Server 2052 E Si la cr ation de l activit a r ussi le message CREATED ACTIVITY OK est retourn C wdeimport gt wdeimport w4adm W w4adm Sa w4adm f ProcessComposerTutorial w4e ex false lt ProcessComposerTutorial alarme ex true ProcessComposerTutorial alarme CREA
54. FERR_ROUT_CONF_LOAD valeur 511 Il est noter que le diagnostic associ cette erreur est consign explicitement dans le journal d erreur du CMD soit le fichier broadcaster log 13 PARAM TRE DESCRIPTION expirationDelay D lai d expiration en jours heures minutes secondes Pour plus de d tails sur les d lais veuillez consulter le chapitre suivant 3 8 4 Gestion des d lais page 106 Valeur par d faut 1 jour Exemple d utilisation du param tre w amp 4adm expirationDelay hour 3 Commentaire fixe le d lai d expiration 3 heures extensionConnectorPort Port de la machine h te de W4 Extension Bus sur lequel sont envoy es les notifications mises par W4 Engine Port d coute du BPM Server pour la communication entre W4 Engine et l API Java wfjlib jar utilis par exemple par les applications fond es sur les mod les Java Valeur par d faut 7797 Voir galement le param tre d instance extensionRmiPort extensionRmiPort Port d coute du BPM Server pour la communication entre W4 Engine et W4 BPM API utilis par exemple par les applications fond es sur le mod le JSF Valeur par d faut 7507 Voir galement le param tre d instance extensionConnectorPort HTTPNotiflemplate PARAM TRE DESCRIPTION Mod le utilis pour la notification des t ches sur les n uds syst me http n uds d tape robot de type SystemFlow La noti
55. HTTPNot ifTimeOut second Le jeton d authentification id lid transmis dans la notification permet de se connecter W4 Engine sans avoir effectuer de login Les droits associ s ce jeton sont restreints aux recherches toutes fonctions et aux actions associ es la t che notifi e exclusivement terminaison annulation suspension mise en attente compl tion Il n est pas n cessaire de poss der des r les particuliers pour effectuer ces actions W4 Engine utilise l acteur system pour effectuer ces actions ne pas confondre avec le user system de certains SGBD L utilisation de ce jeton pour toute autre requ te par exemple assignation d un r le un acteur cr ation d un dossier ou action sur une autre t che que la t che notifi e provoque une erreur 612 identification invalide L utilisation de ce jeton pour l ex cution d une action valide mais sur une autre t che que la t che notifi e provoque une erreur 3040 insufficient privileges S il est n cessaire de renseigner le nom du serveur et le num ro de port dans le cas d une installation en mode cloisonn ajoutez le param tre srv la syntaxe fournie ci dessus soit par exemple amp srv localhost 1234 HTTPNotifTimeOut second F d z1 PARAM TRE DESCRIPTION Configuration du temps imparti pour recevoir l accus de r ception de la notification des t ches sur les n uds syst me http n uds d tape robot de type SystemFlow
56. NUmber telephoneNumber phoneNumber co country avec un mapping co language avec un mapping postalAddress addressLine2 postalCode postalCode addressLine4 Company addressLine1 manager manager la valeur de l attribut LDAP doit tre un DN Il est possible de faire la recherche des acteurs en passant par l attribut assoc nt account qui contient l identifiant interne de l acteur 23 Configuration des calendriers Les dates d alarme et de d passement sont d finies en ajoutant la dur e renseign e dans les champs Dur e de l inspecteur de n ud de Process Composer la date de cr ation de la t che ou en ajoutant la dur e renseign e dans les champs Dur e de l inspecteur de proc dure de Process Composer la date de cr ation du dossier Si la case cocher Utiliser le calendrier des jours ouvr s a t s lectionn e dans ce m me inspecteur le calcul prend en compte le calendrier d fini pour la proc dure La configuration des calendriers se fait via une proc dure sp cialis e la proc dure d administration Calendar livr e avec les serveurs W4 Engine de d veloppement et de production 2 6 1 PAER 222 Pr alables IMPORTANT Ces pr alables concernent uniquement les serveurs W4 Engine ant rieurs la version 4 1 pour lesquels le chargement de la proc dure d administration Calendar n est pas syst matique lors de l installation du serveur Depuis la version 4 1 de W4 Engine les
57. P II ne faudra donc pas supprimer les assignations concernant ces r les Dans le champ de saisie renseignez un par un chacun de ces r les 22548 R les LDAP ignor s par W4 LDAP roles ignored by W4 Certains r les peuvent exister dans LDAP et cependant ne pas tre assign s dans W4 Engine ils doivent tre ignor s par W4 Engine Dans le champ de saisie renseignez un par un chacun de ces r les 22549 Comment retrouver les groupes dans LDAP How to retrieve groups in LDAP La recherche des r les dans LDAP est expliqu e ci dessus Une autre fa on de rechercher les r les est utilis e en parall le Les groupes sont des entr es qui contiennent des membres Ils peuvent tre utilis s comme des r les Le m canisme est identique celui utilis pour les r les ceci pr s qu il n y a pas de mapping FF ds Chapitre 2 Configuration ta possible pour les groupes Les r les ainsi trouv s sont galement pris en compte pour l assignation S il existe des doublons entre les r les ceux ci sont ignor s Renseignez le champ Nom de l attribut LDAP qui contient le nom du groupe LDAP attribute containing the group s name le champ Attribut LDAP d une entr e groupe de r les qui contient des DNs de groupes ou d acteurs LDAP attribute containing members les groupes de r les sont des entr es qui pointent vers d autres groupes ou des acteurs dans le champ Base la base pour les recherches dans le champ F
58. Process Composer et contenant trois proc dures Une proc dure Root Procedure Cette proc dure comporte l activit Root Procedure Activity ainsi que deux r les Root Procedure UpperRole et Root Procedure Role dont la propri t Upper Role a pour valeur le r le Root Procedure UpperRole Une proc dure Sub Procedure sous proc dure de Root Procedure Cette proc dure comporte l activit Sub Procedure Activity et le r le Sub Procedure Role m s3 6 4 1 a Une proc dure r cursive Sub Sub Procedure sous proc dure de Sub Procedure Cette proc dure comporte l activit Sub Sub Procedure Activity et le r le Sub Sub Procedure Role Pour importer ces objets nous avons regroup des commandes w eimport dans les scripts ci dessous pour une ex cution par lots NOTE Les exemples ci dessous sont donn s pour Windows 2000 mais fonctionnent galement sous les plates formes UNIX Script de cr ation Probl matique l application est cr er sur le serveur de production Les r les activit s et proc dures n existent pas sur le serveur ventuellement certains objets du fichier w4e peuvent faire r f rence des r les activit s ou sous proc dures d j pr sents sur le serveur ce n est pas le cas dans l application exemple Le script de cr ation est le suivant REM Le r le Root procedure UpperRole d sign par la propri t Upper Role du r le Root Procedure Role doit tre cr en premier
59. TED ACTIVITY OK RAPPEL SUR LE VERSIONNEMENT DES ACTIVIT S DANS PROCESSCOMPOSER Uneactivit pouvant tre attach e plusieurs tapes dans une m me proc dure ou dans des proc dures diff rentes sa modification risque d impacter d autres tapes et risque d emp cher le fonctionnement d autres proc dures Dans la plupart des cas il est donc impossible de modifier une activit sur le serveur car elle est d j li e d autres tapes de proc dures du serveur Pour contourner cette limite il est n cessaire de g rer les versions des activit s de fa on manuelle Par exemple le nom de l activit peut tre suffix par le num ro de version soit nomActivit _01 W4 Engine Manuel d exploitation 146 Cr ation de proc dures Dans la commande w4eimport sp cifiez en plus des param tres obligatoires l option cp suivie du nom de la proc dure ou de la liste des proc dures cr er l option ex true si les autres objets du fichier ne doivent pas tre cr s RAPPEL m Pour pouvoir cr er une proc dure les r les et les activit s r f renc s dans cette proc dure doivent exister sur le serveur au moment de l import m Les sous proc dures ventuelles doivent tre cr es avant les proc dures dont elles d pendent IMPORTANT Sivous importez une proc dure seule en positionnant l option ex true les r les et les activit s qui d pendent de la proc dure doivent exister sur le serveur au moment de l imp
60. TLS LDAP through TLS LDAP par SSL LDAP through SSL Windows Si vous avez s lectionn LDAP par TLS dans le champ Autorit de validation du certificat serveur LDAP LDAP server certificate validation entity conservez l option par d faut W4 Engine pas de validation W4 Engine no validation si aucune v rification d authenticit ne doit tre effectu e ou s lectionnez l option Magasin de certificats Windows Windows internal certification authorities store si W4 Engine doit valider le certificat par le magasin principal de certificats de Windows IMPORTANT Vous devez pr alablement avoir import le certificat d autorit correspondant Windows Si vous avez s lectionn LDAP par SSL vous avez la possibilit de configurer une temporisation dans le champ Timeout sur le SSL connect s SSL connect timeout s Pour une utilisation standard W4 recommande de laisser ce champ vide Acteurs L cran Acteurs Actors se pr sente ainsi 97 2 2 5 3 1 e role t ca O R LDAP attribute containing actor gir sn Base ou Paopla o4 LDAP filter restricting access to W4 chjectClsssminetOrgPerson pe LDAP_ SCOFE_SUBTREE Fig 2 7 LDAP Acteurs 1 3 Cet cran comporte les sections suivantes Cr ation et assignation des r les Creation and role assignation 3 Comment retrouver les acteurs dans LDAP How to retrieve actors in LDAP Correspondance entre attributs LDAP et W4 LDAP and W4 attribu
61. Tri des dossiers s lectionn s en fonction du nom de dossier de la date de Tri par cr ation de fin de d passement d alarme de la priorit de l tat de la proc dure associ e de l initiateur du responsable ou du r le du responsable Ordre de tri Tri des dossiers s lectionn s en ordre ascendant ou descendant a711 S lection avant archivage L action S lection avant archivage affiche les dossiers correspondant aux crit res d finis avant archivage effectif d select all cases Archive in database soi ae eme see w 4adm 1023 Welcome Screens canceled frere O weL w4adm 1055 1055 welcome Screens cancelled nline Archeye Periodc al offne Administration Coordination Work Items Home page Logout Fig 3 5 S lection avant archivage 1 3 S lectionnez la case cocher des dossiers archiver Le cas ch ant cliquez sur le lien S lectionnez tous les dossiers Cliquez sur le lien Archiver dans la base pour archiver online les dossiers s lectionn s Un message d avertissement s affiche PF ds 95 Chapitre 3 Administration Y 7 Se 3 7 1 3 97 2 Microsoft Internet Explorer Fig 3 6 S lection avant archivage 2 3 Confirmez votre choix par OK En cas d archivage r ussi un message de confirmation s affiche Microsoft Internet Explorer A Command ArchiveTCase successful Fig 3 7 S lection avant archivage 3 3 S lection pour archivage o
62. W4 ENGINE Les prochaines mises jour de ce document seront disponibles sur WWW myw4 com W4 ENGINE MANUEL D EXPLOITATION R f rence WANG OPERATING 020 FR 2003 2010 W4 Tous droits r serv s L acquisition du pr sent document conf re un droit d utilisation incessible non exclusif et personnel et non un droit de propri t L utilisation la copie la reproduction et la distribution du pr sent document sont permises condition 1 que la mention de droits d auteur ci dessus figure sur toutes les copies et que cette mention de droits d auteur et la pr sente mention d autorisation apparaissent conjointement 2 que le pr sent document ne soit utilis qu des fins d information et non commerciales 3 que le pr sent document ne soit modifi de quelque mani re que ce soit Tous les produits et marques cit s sont la propri t de leurs titulaires respectifs Les informations contenues dans ce document pourront faire l objet de modifications sans pr avis Sommaire Vue d ensemble de l exploitation de W4 Engine o Pr sentation de W4 Engine 10 W4 Engine et les autres produits W4 10 Produits compagnons de W4 Engine 11 Processus services et modules de W4 Engine 11 Broadcaster 11 Processus serveur 12 Processus client 13 Configuration de W4 Engine 15 Fichiers de configuration 16 Configuration de l annuaire LDAP 16 Configuration des calendriers 17 Notification par courrier lectronique 17 Administratio
63. acteur correspond au nom d un r le W4 Engine exemple un acteur a dans LDAP un attribut dont les valeurs sont coordinator et administrator et ou un r le est une entr e dans l annuaire W4 Engine Manuel d exploitation 62 et ou un groupe LDAP peut servir de r le Dans le premier cas chaque r le retrouv dans l entr e d finissant un acteur sera assign cet acteur si la case cocher Mise jour de l assignation des r les est s lectionn e Dans les deuxi me et troisi me cas l assignation se passe de la fa on suivante un attribut du r le pointe vers un acteur cet attribut contient le DN d un acteur Lorsqu un acteur est r pliqu une recherche des r les est effectu e dans LDAP Cette recherche utilise la base le filtre et le scope d finis pour les r les Pour chaque r le si ce r le pointe vers l acteur il peut lui tre assign Il est galement possible de faire en sorte que tous les r les qui pointent directement ou indirectement vers le r le pr c dent soient assign s Enfin on peut faire en sorte que seul le r le le plus haut dans la hi rarchie soit assign Et ou un attribut de l acteur pointe vers un r le cet attribut contient le DN d un r le 22542 Cr ation Creation S lectionnez la case cocher Cr er les r les la vol e pour que les r les soient cr s la vol e 22543 Comment retrouver les r les dans LDAP How to retrieve roles in LDAP Renseignez
64. allation standard d une instance Oracle 72 Cr ation de la variable d environnement NLS LANG Cr ez une variable d environnement syst me nomm e NLS_ LANG de valeur AMERICAN AL32UTF8 pour l utilisateur ex cutant W4 Engine 73 Conversion des fichiers SQL du r pertoire WAEngine_Home instail Si W4 Engine n est pas encore install proc dez son installation en ex cutant le fichier setup exe situ dans le r pertoire Setup w4 instal1 du CD ROM d installation A l invite Do you want to create a W4 Engine instance choisissez l option No I 11 do that later Convertissez en UTF 8 les fichiers d extension sql pr sents dans le r pertoire W4Engine Home install PEL 155 Chapitre 7 Mise en uvre de W4 Engine en UTF 8 4 7 A 75 Par exemple sous UNIX utilisez la commande suivante exemple pour le fichier dictionary sql iconv f ISO 8859 1 t UTF 8 o dictionary sql utf8 lt dictionary sql Cette commande a pour effet de produire un fichier d extension ut 8 Renommez ce fichier pour remplacer le fichier d origine Proc dez de m me pour chaque fichier sql pr sent dans le r pertoire W4Engine Home install Cr ation de l instance W4 Engine Sous W4Engine Home install ex cutez le programme ora92install exe ou ora102install exe pour cr er l instance de W4 Engine Dans le menu Installation qui s affiche saisissez 4 puis validez par Entr e A l invite local database sp cifiez le nom de l instance Oracl
65. amme s utilise soit en mode ligne soit en mode console via la console W4 Pour acc der au programme w4 sous le r pertoire lt softwareHome gt bin ex cutez directement la commande souhait e liste et syntaxe ci dessous ou passez par la console W4 Pour ouvrir la console ex cutez la commande w4 Le menu principal de la console Server Administration s affiche W4 Engine 8 0 0 0 Server Administration Server state running connected Connect to the W4 server inactive 3 Disconnect from the W4 server 4 Start options none Start inactive 6 Stop Forward server none 8 License 9 Trace 10 Logins 11 Actors 12 Processes 13 EXIT Your choice Les lignes non num rot es indiquent des commandes non disponibles dans le contexte d ex cution Pour ex cuter une commande saisissez le num ro correspondant puis validez par Entr e La premi re ligne Server state n est pas une commande mais une information sur l tat du serveur elle indique running connected sile serveur W4 Engine est d marr et la console W4 est connect e au serveur W4 Engine s not running disconnected sile serveur W4 Engine est arr t running disconnected sile serveur W4 Engine est d marr et la console W4 est d connect e du serveur W4 Engine Les commandes 2 Connect to the W4 serveret3 Disconnect from the W4 server fonctionnant en mode bascule permettent respectivement de connecter et
66. an C w4eimport gt w4eimport wiadm W w4adm w4adm f W4 Engine Manuel d exploitation WaeimportSamples w4 x Cru cr Root Procedure UpperRol Root Procedure UpperRole CREATED ROLE OK C wdeimport gt wdeimport l w4adm W w4adm m w4adm f W4eimportSamples w4e ex true T Root Procedure Role Sub Procedure Role Sub Sub Procedure Rol Sub Sub Procedure Role CREATED ROLE OK Root Procedure Role CREATED ROLE OK Sub Procedure Role CREATED ROLE OK C wdeimport gt wdeimport zi w4adm W w4adm i w4adm f W4eimportSamples w4 x tru ca Root Procedure Activity Root Procedure Activity CREATED ACTIVITY OK C wdeimport gt wdeimport l w4adm W w4adm i w4adm f W4eimportSamples w4e ex true Cca Sub Procedure Activity Sub Sub Procedure Activity Sub Sub Procedure Activity CREATED ACTIVITY OK Sub Procedure Activity CREATED ACTIVITY OK C wdeimport gt wdeimport I w4adm W w4adm A w4adm f W4eimportSamples w4 x tru cp Sub Sub Procedur Sub Sub Procedure CREATED PROCEDURE OK C wdeimport gt wdeimport I w4adm W w4adm w4adm f W4eimportSamples w4 x tru cp Sub Procedure Sub Procedure CREATED PROCEDURE OK C w4eimport gt w4eimport l w4adm W w4adm i w4adm f W4eimportSamples w4 x tru cp Root Procedure Root Proc
67. anc 0 du processus Une seule instance doit tre lanc e par processus Ces quatre champs sont obligatoires Table 2 2 Champs pour un processus client dans le fichier Config lt instanceName gt CHAMP DESCRIPTION Premier champ invariable d un service client serviceName Nom du service Il peut tre francis processName Commande de d marrage du processus client CHAMP DESCRIPTION 1 le processus client est lanc au d marrage du serveur 0 le processus client n est pas lanc 2 1 2 IMPORTANT W4 Engine doit tre red marr pour que les modifications apport es au fichier Config lt instanceName soient prises en compte Pour plus de d tails sur l utilisation de ce fichier reportez vous au chapitre suivant 3 3 2 D marrage du serveur page 81 Fichier de configuration w4server cfg Objet Ce fichier de configuration stocke les param tres d instance Localisation Ce fichier est situ sous lt softwareHome gt sys soit typiquement a Sous Unix w4 sys waserver cfg a sous Windows C Program Files w4 sys wa4server cfg Format Les lignes du fichier poss dent le format suivant lt instanceName gt lt param tre gt lt valeur gt Les param tres du fichier de configuration w4server cfg sont r pertori s dans le tableau ci dessous IMPORTANT W4 Engine doit red marrer pour que les modifications apport es au fichier w server cfg so
68. anc es du programme 3 S lectionnez l option I Import file 4 S lectionnez l option Oo Other file 5 A l invite Database Contents File saisissez le nom du fichier exp puis validez 6 S lectionnez l option M Main menu pour retourner au menu principal du programme 7 S lectionnez l option I Install Archivages Les fonctionnalit s d archivage sont les suivantes archivage online archivage online p riodique s archivage offline restauration d archives m m L ensemble de ces fonctionnalit s est disponible dans les deux interfaces d administration Web de W4 Engine IMPORTANT Pour utiliser la fonctionnalit d archivage p riodique en Java vous devez imp rativement mettre jour la proc dure Archivage NOTE Les actions ci dessous sont d crites pour l interface d administration CGI 3 7 1 Archivage online Toutesles informations relatives au dossier dossier t ches variables commentaires sont d plac es dans des tables sp cifiques de la base de donn es online_archived_case online_archived_task online_archived_case_var archived_case_comments archived_case_ancillary ce qui d charge le volume des tables les plus sollicit es Ces tables appartiennent un tablespace diff rent W4_ARCH Tous les l ments des dossiers archiv s online peuvent tre consult s comme les dossiers non archiv s Le crit re de recherche est WF_CRIT_ARCHIVE bool en 0 ou 1 et peut tre utilis lor
69. areHome gt sys Config dont le contenu est le suivant 2 Administrator wfadministrator 1 1 10 3 Scheduler wfscheduler 1 1 30 4 Data Miner wfdataminer 1 1 20 5 Archiver w farchiv 1 1 10 6 Babel Web wfbabel 1 1 10 C Listener TCP wflistener w4 l C Big Brother wfbigbrother 1 C Automatic wfautomatic 1l C Audit wfaudit 0 C WatchSrv wfwatchsrv 0 Le premier champ de chaque ligne du fichier sert distinguer les processus serveur et client valeur num rique pour un processus serveur lettre C pour un processus client Une ligne concernant un processus serveur poss de le format suivant lt i gt lt serviceName gt lt processName gt lt j gt lt k gt lt 1l gt o i indique que la ligne concerne un processus service attach au serveur W4 Engine j indique le nombre maximal de processus pr sents simultan ment un instantt k indique le nombre total de processus lanc s au d marrage du serveur 1 indique le nombre total de requ tes acceptables par le processus dans sa file d attente Ces six champs sont obligatoires RED MARRAGE AUTOMATIQUE DES PROCESSUS INITIAUX Tout processus client r f renc dans le fichier Config lt instanceName gt wflistener wfautomatic wfbigbrother wfaudit et wfwatchsrv est red marr automatiquement par W4 Engine en cas d arr t inopin de ce processus Table 2 1 Champs pour un processus serveur dans le fichier Config lt instanceName gt Num ro du
70. arr t en mode forward 87 Positionnement et tat des traces 87 Fichiers d exploitation 87 Fichiers temporaires 87 Fichiers journaux 88 Fichiers de traces 89 Fichiers archive 90 Sauvegardes 97 Archivages 92 Archivage online 93 5 Sommaire ag S lection avant archivage 95 S lection pour archivage online imm diat 96 Effacer 96 Archivage online p riodique 96 Modification des crit res d un dossier p riodique en cours 100 Archivage offline 102 Restauration 102 Recherche d un dossier archiv 103 Gestion des utilisateurs 103 Modes d authentification des utilisateurs 104 Connexion des utilisateurs 104 Sessions 105 tats des sessions 105 crans de reconnexion CGl 105 Gestion des d lais 106 D lai d expiration 106 D lai de suspension 106 D lai de verrouillage 107 Modification des d lais 107 Contr le des licences 108 Licences utilisateurs concurrentes 108 Licences utilisateurs d clar s 109 Licences mixtes 110 Contr le de l activit du serveur 110 Utilitaires 117 wfaudit surveillance du serveur 111 wfwatchsrv surveillance des services 712 Traces 113 Mode d activation 113 Syntaxe 113 Options de trace 114 Ordre des options de trace 116 Visualisation de l tat des traces 116 Exemples 117 Optimisation des performances 2 Pr sentation 120 Optimisation de l applicatif 120 Minimiser le nombre d allers et retours entre l applicatif et W4 Engine 127 Choisir la bonne m thode getObject Vs searchObject 121
71. ation s proc dure a tapes activit s s d finitions de variable a acteurs a r les s serveurs Il assure aussi l identification des acteurs lors d une ouverture de session ou d une reconnexion Scheduler Nom du service Scheduler Nom du processus associ wfscheduler exe galement d sign service d ordonnancement s quenceur G re tous les objets dynamiques API runtime cr s lors de l ex cution des proc dures dossiers a t ches a variables a r f rences de document a commentaires v nements Il assure en particulier l ordonnancement des t ches l assignation des t ches aux acteurs et l enregistrement de toutes les actions relatives au d roulement des dossiers 1 1 3 3 wifdataminer Nom du service Data Miner Nom du processus associ wfdataminer exe galement d sign service de recherche Acc de la base de donn es pour obtenir les attributs d un objet ou d une liste d objets v rifiant certains crit res Il ne modifie jamais la base de donn es Archiver Nom du service Archiver Nom du processus associ wfarchiv exe galement d sign service d archivage Permet d exporter l historique des processus termin s soit dans un fichier d archives avec possibilit de restaurer s lectivement les archives archivage offline soit dans d autres tables de la base de donn es archivage online Babel Web Nom du service Babel
72. ation gt Actor manager select for role display Role Activity server v Dtocal server reset Procedure n Script last name keyword Mao p Language language email Server company country Coordination pany Loo di Archival i ir D to maximum count 99 sorted by login M sort order escendng M Home page Logout Fig 3 2 Interface d administration CGI 2 2 La partie gauche de la page comporte les menus de l interface d administration Les menus principaux sont les suivants E E E E c Administration Coordination Archivage Corbeille es quatre menus principaux s ajoutent le menu Page d accueil Home page pour retourner la page des services W4 et le menu Quitter W4 Logout pour retourner la page de connexion l interface d administration 31 2 Description des menus Le menu Administration permet de g rer les objets statiques Table 3 1 Menu Administration ACTION R LE MINIMUM REQUIS Acteur W4 Engine Manuel d exploitation 76 ACTION R LE MINIMUM REQUIS Cr ation des acteurs Aucun Assignation des r les aux acteurs Administrator Modification des acteurs Administrator Suppression des acteurs Administrator R le Cr ation des r les Assignation des r les aux acteurs Aucun Modification des r les PA Administrator Suppression des r les P pp Administrator IMPORTANT llest impossible de supprimer Administrator un r le attribu
73. ations de workflow et aux modules de supervision fonctionnelle 1 12 1 1 3 LSA W4 Control Center modules de BAM Business Activity Monitoring et de BI Business Intelligence W4 Connectors for SAP connecteur d interaction entre W4 Engine et SAP fonctionnant sur le serveur de connecteurs Java Toutes les fonctionnalit s de W4 Engine sont disponibles sous formes d API C Java et NET Produits compagnons de W4 Engine L utilisateur acc de W4 Engine au travers d un serveur de pr sentation moteur de servlets serveur Web ou serveur d application via un navigateur Web Sur le serveur de pr sentation est install un contr leur qui transf re les ordres de l utilisateur au moteur gr ce une API W4 Engine est client transactionnel d une base de donn es relationnelle qui stocke les donn es de travail Le serveur de base de donn es peut tre situ sur la machine h bergeant le serveur W4 Engine ou tre distant W4 Engine supporte les annuaires LDAP r utilisant ainsi les donn es du syst me d informations relatives aux utilisateurs Processus services et modules de W4 Engine Le serveur W4 Engine est compos d un distributeur central de messages d un ensemble de services de workflow connect s en permanence la base de donn es et d un ensemble de services clients Broadcaster Nom du service Broadcaster Nom du processus associ wfbroadcaster exe galement d sign CMD Central Message D
74. base LDAP attribute containing actor s lagin in Fig 2 5 LDAP Description de la configuration Cette page reprend les informations de la page de configuration Idap create en mode visualisation Aucune modification n est possible sur cette page La page comporte dans sa partie inf rieure droite les boutons Modifier Modify et Supprimer Delete S lectionnez le bouton Supprimer Delete pour supprimer le dossier S lectionnez le bouton Modifier Modify pour modifier la configuration La page ldap create s affiche Cette page est d crite en d tail dans le chapitre suivant 2 2 5 Configuration page 51 Configuration La configuration s effectue via le formulaire Idap create obtenu en s lectionnant Nouvelle instance New instance dans la partie sup rieure gauche de la corbeille du dossier LDAP Ce formulaire comprend trois parties principales Configuration g n rale General configuration Acteurs Actors a R les et groupes Roles and groups FF Chapitre 2 Configuration ta IMPORTANT La configuration ne sera prise en compte qu une fois s lectionn le bouton Terminer dans la partie inf rieure du formulaire De plus en pr sence d une configuration pr voyant plusieurs processus par service plusieurs processus wfadministrator wfscheduler ou wfdataminer le red marrage de W4 Engine est indispensable pour prendre en compte les modifications de configuration 2251 Configuration g n ra
75. ble d environnement NLS_LANG 155 Conversion des fichiers SQL du r pertoire W4Engine_Home install 155 Cr ation de l instance W4 Engine 156 Edition du fichier w4server cfg 156 W4 Engine Manuel d exploitation 8 9 Sommaire ua Vue d ensemble de l exploitation de W4 Engine Ce chapitre d crit succinctement les composants du serveur W4 Engine et pr sente les t ches de configuration et d administration qui seront d velopp es dans les chapitres suivants Pr sentation de W4 Engine Pour administrer correctement W4 Engine il est n cessaire de comprendre sa place au sein du syst me d information W4 Engine et les autres produits W4 W4 Engine est le moteur de workflow Les autres produits W4 sont les suivants W4 Admin for Java interface web de supervision des instances de processus et d administration des utilisateurs et des r les W4 Extension bus extension de W4 Engine pour l ex cution de traitements complexes tels que les interactions avec des GED W4 SystemFlow serveur d int gration de flux EAI W4 Connectors serveurs de connecteurs Java et NET pour l int gration avec les applications d entreprise gr ce laquelle les applications du syst me d information deviennent des acteurs part enti re du workflow Process Composer outil de d finition graphique des proc dures et de g n ration des applications web pour le suivi et l ex cution de ces proc dures W4 BPM Workspace portail d acc s aux applic
76. btenez le m me type de message si vous tentez d importer cons cutivement le m me fichier w4e Import explicite d un fichier w4e Cr ation de r les Dans la commande w4eimport sp cifiez en plus des param tres obligatoires l option cr suivie du nom du r le ou de la liste des r les cr er a l option ex true si les autres objets du fichier ne doivent pas tre cr s RAPPEL Pour pouvoir cr er un r le d fini dans Process Composer avec une propri t Upper Role le r le d sign par la propri t Upper Role doit tre pr alablement cr Si vous tentez de cr er un r le qui existe d j sur le serveur au moment de l import l erreur Error Server 2005 est retourn e C w4eimport gt w4eimport 1 w4adm W w4adm f ProcessComposerTutorial w4e cr responsableDossierAchat ex true responsableDossierAchat CREATED ROLE KO Error Server 2005 Si la cr ation du r le a r ussi le message CREATED ROLE OK est retourn C wdeimport gt wdeimport 1 w4adm W w4adm f ProcessComposerTutorial wde cr responsableDossierAchat ex true responsableDossierAchat CREATED ROLE OK Modification de r les Dans la commande w4eimport sp cifiez en plus des param tres obligatoires 145 a l option mr suivie du nom du r le ou de la liste des r les modifier a l option ex true si les autres objets du fichier ne doivent pas tre cr s IMPORTANT lIln est pas possible de modifier
77. ce cas aucun objet n est cr Si dans le cas d un import explicite le nom d un objet sp cifi est erron le message suivant est retourn lt nom de l objet saisi gt this lt type de l objet gt doesn t exist in w4e file Dans ce cas seuls les objets correctement nomm s sont cr s IMPORTANT m Veillez respecter la casse dans les noms des objets m Les objets cr s sous Process Composer ne doivent pas comporter de caract res accentu s m Veillez ne pas omettre l extension w4e en sp cifiant le nom du fichier R f rence Cette section d taille le mode de fonctionnement de chaque option Veuillez vous reporter la section suivante pour une description des cas classiques d utilisation Import implicite d un fichier w4e Pour proc der un import implicite les objets du fichier w4e ne doivent tre li s par aucune d pendance aucun r le du fichier ne doit avoir t d fini avec une propri t Upper Role et aucune proc dure du fichier ne doit poss der de sous proc dure moins que tous les r les d sign s par une propri t Upper Role et toutes les sous proc dures soient d j pr sents sur le serveur Par ailleurs aucun objet du fichier ne doit exister sur le serveur puisque chaque objet du fichier se voit appliquer implicitement l option de cr ation l ex cution de la commande le message lt nom de l objet gt CREATED lt type de l objet gt OK s affiche l cran pour chaque
78. ceName gt page 20 Automatic Nom du service Automatic Nom du processus associ wfautomatic exe galement d sign module d acteur automatique Assure les fonctions d un acteur sp cial appel automatic auquel sont affect es des t ches ne demandant pas d interaction humaine une mise jour de base de donn es par exemple 1 2 Si par erreur cet acteur re oit une t che qu il ne peut pas r aliser il la r affecte au responsable du dossier ou l administrateur Audit Nom du service Audit Nom du processus associ wfaudit exe Surveille et enregistre l activit d une instance W4 Engine intervalles r guliers WatchSrv Nom du service WatchSrv Nom du processus associ wfwatchsrv exe L utilitaire WatchSrv surveille les services W4 et relance ceux dont le nombre est inf rieur au nombre initial donn dans la configuration Config lt instanceName gt Service Manager Windows uniquement Nom du service Service Manager Nom du processus associ wfsvrmgr exe Ex cutable qui assure le lien entre le Service Manager de Windows et le serveur W4 Engine Il re oit via le Service Manager des ordres qu il transmet au serveur W4 Engine Il poss de galement un r le de surveillance si le CMD s arr te alors qu aucun arr t n a t demand il notifie cet arr t et relance le CMD Mailer Nom du service Mailer Nom du processus associ wfsendmail exe Sous processu
79. cessus serveur Les traces sur le CMD sont activables via la commande de d marrage start Les traces sur le processus CGI sont activables via les commandes ou les menus de la console W4 Les traces sur les processus lanc s par le fichier de configuration Config lt instanceName gt sont activables via ce m me fichier Syntaxe Dans les syntaxes d crites ci dessous lt traceOptions gt d signe une option de traces ou une suite d options de traces d crites dans le chapitre Options de trace ci dessous Certaines lignes de commande poss dent un quivalent dans les menus de la console W4 Dans ce cas celui ci est indiqu Processus CMD Pour activer les traces sur le processus CMD le cas ch ant arr tez le serveur W4 Engine positionnez vous sur le r pertoire lt softwareHome gt bin puis ex cutez la commande suivante w4 i lt instanceName gt start lt traceOptions gt Processus CGI Pour activer les traces sur le processus CGI positionnez vous sur le r pertoire lt softwareHome gt bin puis ex cutez la commande suivante w4 i lt instanceName gt trace cgi lt traceOptions gt quivalent menu dans la console W4 9 puis validez par Entr e pour afficher le sous menu Server trace 2 puis validez par Entr e dans le sous menu Server trace pour positionner les traces CGI s l invite Cgi options saisissez les lt traceOptions gt puis validez par Entr e 3 9 2 3 a 4 puis validez par Entr e pour revenir au me
80. croissement significatif de la taille de la table case_variable Attention aux performances sur les recherches enableRevisionNumberControl Contr le du num ro de version des proc dures Valeur par d faut FALSE Exemple d utilisation du param tre w4adm enableRevisionNumberControl false Commentaire lorsque ce param tre d instance est positionn TRUE W4 Engine ne d termine pas lui m me le num ro de r vision d une proc dure lors de sa cr ation ou de sa r vision W4 Engine utilise alors le num ro transmis sauf si celui ci est n gatif ou nul De m me lorsque le param tre est positionn il est possible de modifier le num ro de r vision via les fonctions de modification Si la r vision existe d j pour la proc dure donn e la cr ation ou la modification choue et l erreur 2053 WFERR_ADM_DUP_ PROCEDURE est retourn e enableTransactionControl PARAM TRE DESCRIPTION Contr le des transactions par les applications utilisant le serveur W4 Engine Valeur par d faut FALSE Exemple d utilisation du param tre w4adm enableTransactionControl false Commentaire offre au concepteur d applications la possibilit de contr ler les limites des transactions en encapsulant une suite d appels au serveur W4 Engine typiquement CreateCase SetCaseVariables StartCase dans une seule et m me transaction Lorsqu une erreur survient lors de l un des appels l ensemble des actions est annu
81. ctionnements importants du moteur Reportez vous la rubrique R f rence Transact SQL de la MSDN pour la norme de d claration des curseurs Sauf avis du support technique W4 il est d conseill d utiliser ce param tre databaseServer ODBC nom de la source de donn e Oracle cha ne de connexion Net Services Valeur par d faut m ODBC W4DB ORACLE aucune connexion locale Exemple d utilisation du param tre w4adm databaseServer DISTW4 databaseUTF8Encoding Sauvegarde des cha nes de caract res sur le serveur de donn es au format UTF 8 Valeur par d faut FALSE Exemple d utilisation du param tre w4adm databaseUTF8Encoding true Pour mettre en oeuvre W4 Engine en mode UTF 8 veuillez suivre les actions d crites au chapitre suivant 7 Mise en uvre de W4 Engine en UTF 8 page 154 F ka d 53 PARAM TRE DESCRIPTION dbHint actorPool useExists Provoque l utilisation de clauses exists dans les requ tes SQL pour toutes les recherches de t ches utilisant le crit re WF_CRIT_ACTOR_POOL m thodes SearchTask et SearchFullTask si la valeur est true Valeur par d faut FALSE Exemple d utilisation du param tre w4adm dbHint actorPool useExists true defaultTaskHistory Sauvegarde des donn es de t ches termin es Valeur par d faut FALSE Exemple d utilisation du param tre w4adm defaultTaskHistory false Commentaire provoque un ac
82. d connecter la console W4 du serveur W4 Engine 8 3 1 33 2 Affichage de la liste des commandes Commande w4 usage Les commandes disponibles sont fournies avec leur syntaxe W4 Engine 08 00 00 Server Administration Usage w4 usage w4 start lt startOption gt w4 stop w4 forward lt serverHost gt w4 forward stop w4 license show w4 license add lt licenseNumber gt w4 trace show w4 trace lt processName gt lt traceOption gt lt traceOption gt C Program Files w4 bin gt Si W4 Engine n est pas correctement install un message d erreur appara t en lieu et place de la liste des commandes disponibles Le message est du type suivant C Program Files w4 bin w4 exe error detected the program is run from a not properly installed copy Error log follows lt w4 log gt W4Engine 4 1 0 2003 40 Microsoft Windows NT C 2004 10 26 09 37 20 1 error 22 WFGetGlobalContext H w4 src utils admtools c 3665 3593 2004 10 26 09 37 20 1 instanceName 0x0042ED7C 2004 10 26 09 37 20 1 instanceName w4adm 2004 10 26 09 37 20 1 instance home not found in the configuration file 2004 10 26 09 37 20 1 the instance is not properly installed 2004 10 26 09 37 20 1 install the instance first wdinstall program 2004 10 26 09 437 320 0 error 22 WFInitConsole H w4 src sysadm wfsysadm c 307 278 file C TEMP w41092 1og Hit lt Return gt to e
83. dans un m me temps ces canaux sont tous occup s et une tentative de connexion se solde par l erreur 104 erreur Win32 231 ERROR_PIPE_BUSY c t client le serveur ne voit pas cette tentative Pour viter cette erreur il faut augmenter le nombre de canaux d coute de la fa on suivante Rajouter dans le fichier lt W4Engine Home gt sys w4server cfg la ligne ici pour 10 canaux w adm maxPendingConnections 10 Activation du mode case sensitive L utilisation du mode case sensitive optimise largement les acc s la base de donn es oracle version 8 1 7 et sup rieure dans la mesure o ce mode permet de profiter pleinement des index En configuration de base W4 Engine ne fait pas de distinction entre les minuscules et les majuscules Toutes les recherches Oracle sont faites en UPPER Cela induit une mauvaise utilisation des index pos s sur les tables Oracle L activation de ce mode am liore donc les temps de r ponse du service de recherche mais a un impact sur l application d velopp e avant activation ou sur la mani re de la d velopper En effet il faut nommer la casse pr s tous les objets lors des requ tes vers le moteur W4 Engine d s qu un objet est nomm tels que nom d une proc dure de dossier de variable d acteur il doit respecter la casse dans laquelle il a t cr De plus 2 objets identiques la casse pr s deviennent 2 objets diff rents Exemple 8 casse des variables Supposons
84. deimport w4adm W w4adm i w4adm f ProcessComposerTutorial w4e mp ProcessComposerTutorial ex true ProcessComposerTutorial MODIFIED PROCEDURE KO Error Server 2115 La proc dure modifier doit exister sur le serveur au moment de l import Si vous tentez de modifier une proc dure qui n existe pas sur le serveur au moment de l import le message THIS PROCEDURE DOESN T EXIST est retourn C w4eimport gt w4eimport w adm W w4adm f ProcessComposerTutorial w4e mp ProcessComposerTutorial ex true ProcessComposerTutorial THIS PROCEDURE DOESN T EXIST Si la modification de la proc dure a r ussi le message MODIFIED PROCEDURE OK est retourn C w4eimport gt w4eimport w4adm W w4adm f ProcessComposerTutorial w4e mp ProcessComposerTutorial ex true ProcessComposerTutorial MODIFIED PROCEDURE OK R vision de proc dures Dans la commande w4eimport sp cifiez en plus des param tres obligatoires a l option r suivie du nom de la proc dure ou de la liste des proc dures r viser a l option ex true si les autres objets du fichier ne doivent pas tre cr s IMPORTANT Les r les et activit s de la proc dure r viser doivent exister sur le serveur au moment de l import 6 4 Dans le cas contraire l erreur Error Server 2102 est retourn e tant que le r le responsable de la proc dure n est pas cr sur le serveur C wdeimport gt wdeimport w4adm W w4adm
85. dules de supervision fonctionnelle de W4 BPM Workspace W4 BPM Workspace est le portail donnant acc s aux modules de supervision fonctionnelle le modules G rer mon quipe et le modules G rer mes processus Le module G rer mon quipe est le module de supervision fonctionnelle des acteurs offrant l utilisateur une vue m tier des actions qu il peut effectuer sur les acteurs dont il a la responsabilit Dans ce module l utilisateur pourra g rer la charge de travail de ses collaborateurs g rer les absences de ses collaborateurs visualiser un tableau r capitulatif de la charge de travail des acteurs dont il est responsable diff rencier les acteurs absents des acteurs pr sents diff rencier les proc dures dont il est responsable m Le module G rer mes processus est le module de supervision fonctionnelle des processus offrant l utilisateur une vue m tier des actions qu il peut effectuer sur les t ches et dossiers workflow dont il est responsable Dans ce module l utilisateur pourra diff rencier les proc dures actives inactives en test A Le s visualiser le nombre de dossiers par statut de publication des proc dures s acc der au d tail d une proc dure et au suivi du dossier Pour plus de d tails veuillez consulter le Manuel de supervision fonctionnelle de W4 BPM Workspace Commandes en mode ligne Certaines commandes du serveur sont accessibles via le programme w4 Ce progr
86. e ORACLE_SID que vous avez cr e en mode UTF 8 puis validez par Entr e Pour le reste de cr ation de l instance proc dez comme pour une installation standard de W4 Engine sur Oracle Edition du fichier wd4server cig Sous W4Engine Home sys ditez le fichier de configuration waserver cfa Ajoutez le param tre databaseUTF8Encoding et positionnez le sur la valeur true soit par exemple waadm databaseUTF8Encoding true Notez que W4 Engine doit red marrer pour que les modifications apport es au fichier waserver cfg soient prises en compte Installation de la proc dure LDAP 47 Acc s la corbeille de la proc dure LDAP 48 R plication des acteurs et des r les 1 2 49 R plication des acteurs et des r les 2 2 50 LDAP Description de la configuration 51 LDAP Configuration g n rale 52 LDAP Acteurs 1 3 57 LDAP Acteurs 2 3 59 LDAP Acteurs 3 3 61 LDAP R les et groupes 1 3 62 LDAP R les et groupes 2 3 64 LDAP R les et groupes 3 3 65 Configuration des calendriers 70 Acc s la corbeille de la proc dure Calendar 71 Interface d administration CGI 1 2 75 Interface d administration CGI 2 2 76 Processus W4 Engine dans le gestionnaire des t ches 84 Archivage online 94 S lection avant archivage 1 3 95 S lection avant archivage 2 3 96 S lection avant archivage 3 3 9 Archivage online p riodique 1 3 97 Archivage online p riodique 2 3 98 Archivage online p riodique
87. e 52 LDAP connexion du dataminer W4 Engine 53 LDAP connexion du scheduler W4 Engine 53 LDAP correspondance entre attributs LDAP et W4 W4 Engine 59 64 LDAP correspondance entre noms des r les dans LDAP et noms des r les dans W4 W4 Engine 64 LDAP correspondance entre valeur dans LDAP et valeur dans W4 W4 Engine 60 64 LDAP cr ation et assignation des r les W4 Engine 57 LDAP cr ation W4 Engine 63 LDAP Cr er les acteurs la vol e W4 Engine 57 LDAP Filtre LDAP qui restreint l acc s W4 W4 Engine 58 LDAP librairie cliente LDAP W4 Engine 54 LDAP mappings possibles pour Active Directory W4 Engine 67 LDAP mappings possibles pour Exchange 5 5 W4 Engine 68 LDAP mappings possibles pour quelques classes LDAP W4 Engine 66 LDAP Mettre jour l assignation des r les W4 Engine 57 LDAP Mise jour des attributs de l acteur chaque login W4 Engine 58 LDAP N autoriser que les acteurs qui sont membres d un groupe W4 Engine 58 LDAP num ro de port W4 Engine 54 LDAP r f rentiels utilis s pour les GetActor et GetRole W4 Engine 54 LDAP r plication des acteurs et des r les W4 Engine 48 LDAP r pliquer les attributs des objets lors de leur cr ation W4 Engine 53 LDAP r les et groupes W4 Engine 62 LDAP r les LDAP ignor s par W4 W4 Engine 65 LDAP r les LDAP ne devant pas tre d sassign s W4 Engine 65 LDAP scope W4 Engine 58 LDAP Timeout sur le bind W4 Engine 55 LDAP Utiliser
88. e la commande start pour activer les traces sur le processus CMD La visualisation et le positionnement des traces sont d crits dans le chapitre suivant 3 9 Contr le de l activit du serveur page 110 La commande start lance le CMD Ce dernier interpr te le contenu d un fichier de configuration Config lt instanceName gt pour lancer les autres processus du serveur sauf si l option e est utilis e voir ci dessous Cependant m me au cas o l option e est utilis e ce fichier est analys pour conna tre notamment le nombre d instances maximum de chaque service Pour plus de d tails sur ce fichier de configuration veuillez consulter le chapitre suivant 2 1 1 Fichier de configuration Config lt instanceName gt page 20 En cas de d marrage r ussi le message de sortie indique le r pertoire de stockage des fichiers journaux soit par exemple sous UNIX Pour plus de d tails sur ce fichier de configuration veuillez consulter le chapitre suivant 2 1 1 Fichier de configuration Config lt instanceName gt page 20 En cas de d marrage r ussi le message de sortie indique le r pertoire de stockage des fichiers journaux soit par exemple sous UNIX Launching Server launched Please check log files that may appear in the log directory var adm w4 log Le message quivalent sous Windows est le suivant Launching Server launched Please check log files that may appear i
89. e niveau de recherche des acteurs dans l annuaire LDAP s LDAP_SCOPE_BASE la recherche se fait au niveau de la base LDAP_SCOPE_ONELEVEL la recherche se fait au niveau directement inf rieur la base LDAP_SCOPE_SUBTREE la recherche se fait au niveau de la base et tous les niveaux inf rieurs Attribut LDAP qui contient des noms de r les LDAP attribute containing role names Un attribut LDAP peut contenir des noms de r les Les r les correspondants seront assign s l acteur si la case cocher Mettre jour l assignation des r les a t s lectionn e Attribut LDAP qui contient des DNs de r les LDAP attribute containing role DNs Un attribut LDAP peut contenir des DN de r les Les r les correspondant ces DN seront assign s l acteur si la case cocher Mettre jour l assignation des r les a t s lectionn e Attribut LDAP qui contient des DNs de groupes LDAP afttribute containing group DNs Un attribut LDAP peut contenir des DN de groupes Ces groupes au sens LDAP sont consid r s comme des r les qui seront assign s l acteur I n y a pas de correspondance entre attributs LDAP et attributs W4 Engine pour les groupes Pour le reste le fonctionnement est identique 22533 Correspondance entre attributs LDAP et W4 LDAP and W4 attributes mapping Dans le champ de saisie Attribut LDAP LDAP attribute renseignez un nom d attribut LDAP Dans la liste d roulante Attribut W4 W4 att
90. e sous menu Export file 4 A l invite export file lt default w4base exp gt conserver ou modifier le nom du fichier par d faut 5 A l invite description lt default no description saisissez une description facultative pour le fichier par exemple Export de la base W4 du JJ MM AAAA 6 De retour dans le menu Advanced options v rifiez le chemin le nom et la description du fichier 7 S lectionnez l optionM Main menu pour retourner au menu principal du programme 8 S lectionnez l option E Export contents r Les messages de sortie de la commande sont du type suivant Exporting data to the D W4Stress Stress wAStress exp file Connected to the database zsqls as zsqls map table exported 20 rows languages table exported 8 rows map entry table exported 1276 rows scripts table exported 90 rows L online archived case var table exported 0 row archived case ancillary table exported 0 row archived case comments table exported 0 row Press lt Return gt to continue Le fichier est cr sous le r pertoire lt softwareHome gt install Ce fichier peut ensuite tre import sur tout serveur W4 Engine quelle que soit la base de donn es lors de la cr ation d une nouvelle instance POUR IMPORTER LE FICHIER EXP 1 Sur la machine cible lancez le programme wainstall 2 S lectionnez l option A Advanced options pour afficher le sous menu des options av
91. ect D termine le mod le de d claration des curseurs en lecture seule parmi trois mod les pr d finis SQL Server Valeur par d faut aucune Valeurs possibles m aucune utilisation du mod le par d faut DECLARE cursorName CURSOR FOR selectStatement m SQL92 utilisation du mod le DECLARE cursorName CURSOR FOR selectStatement FOR READ ONLY m MSSQL utilisation du mod le DECLARE cursorName CURSOR FAST FORWARD FOR selectStatement Remarque si le param tre poss de une valeur erron e il est ignor et le mod le par d faut est donc utilis Pour la d finition d un mod le personnalis pour la d claration des curseurs en lecture seule voir le param tre databaseReadOnlyCursorTemplate W4 Engine Manuel d exploitation 42 PARAM TRE DESCRIPTION substituteMaxDepth Nombre de niveaux de recherche pour les acteurs rempla ants avant que W4 Engine n applique les r gles d assignation automatique La valeur par d faut de ce param tre est 1 ce qui signifie que la recherche ne comporte qu un seul niveau soit le comportement historique W4 Engine recherche le rempla ant de l acteur absent mais ne poursuit pas par la recherche du rempla ant de ce rempla ant de rang 1 si lui m me tait absent Une valeur de 0 signifie que les niveaux de recherche ne sont pas limit s W4 Engine recherche le rempla ant de l acteur absent puis le rempla ant du rempla ant de rang 1 si ce derni
92. edure CREATED PROCEDURE OK 45 Script de modification Probl matique l application doit tre modifi e sur le serveur de production Tout ou partie des proc dures doivent tre modifi es sans changement de num ro de version Les r les sont galement modifi s cette occasion La modification de proc dure peut entra ner la cr ation de nouvelles activit s li es de nouveaux n uds Cet aspect n est pas pris en compte dans l exemple ci dessous Si cela avait t le cas la commande aurait comport le param tre ca pour la cr ation de nouvelles activit s contenues dans le fichier w4e Le script de modification est le suivant REM Aucun ordre n est respecter car dans notre exemple tous les objets existent d j sur le serveur Il est donc possible de n utiliser qu une seule commande pour modifier les r les les activit s et les proc dures Cependant la propri t Upper Rol du r le Root Procedure Role a t supprim e pour pouvoir proc der sa modification 151 Chapitre 6 Chargement d objets de mod lisation par script w4eimport de 6 6 waeimport wiadm W w4adm i w4adm f W4eimportSamplesUpdated w4e ex true mr Root Procedure UpperRole Root Procedure Role Sub Procedure Rol Sub Sub Procedure Rol mp Sub Sub Procedure Sub Procedure Root Procedur l ex cution du fichier de commandes les messages suivants s affichent l cran
93. el false gt If true the object not listed on command line are ignored else they are created lt default value false gt Syntaxe La commande w4eimport accepte les param tres suivants m E L option lI L minuscule pour sp cifier l identifiant du compte d administration du serveur W4 Engine cible obligatoire L option w pour sp cifier le mot de passe du compte d administration obligatoire L option f pour sp cifier le chemin et le nom du fichier w4e importer obligatoire L option i pour sp cifier le nom de l instance si vous disposez de plusieurs instances sur votre serveur W4 Engine Par d faut la commande prend la valeur i w4adm Les options pour sp cifier la modalit d import d un objet o l option cr pour cr er un r le ou une liste de r les o l option ca pour cr er une activit ou une liste d activit s o l option cp pour cr er une proc dure ou une liste de proc dures o l option mr pour modifier un r le ou une liste de r les o l option mp pour modifier une proc dure ou une liste de proc dures o l option r pour r viser une proc dure ou une liste de proc dures En argument de ces options vous devez nommer explicitement l objet ou la liste des objets que vous souhaitez importer ua a L option d import explicite ou implicite ex lt truelfalse gt Cette option est positionner true pour effectuer un import explicite d un fichier w4e dans ce cas seuls les objets dont vou
94. ence est inexistante Il en va ainsi de la version d valuation Acteurs sp cifiques Deux acteurs sont syst matiquement d clar s les acteurs w4adm et automatic Par souci de coh rence on leur attribue le r le declared mais cet attribut est purement informatif ils sont consid r s comme d clar s de toute fa on De plus l acc s au serveur leur est garanti m me en cas de d passement de la capacit de la licence Ces deux acteurs n entrent pas dans le d compte de la licence Cependant si plusieurs acteurs administrateurs ou automatiques sont cr s ces acteurs suppl mentaires entrent dans le d compte de la licence Mise jour des serveurs Les cl s de licence existantes acteurs exclusivement d clar s ou flottants restent valides Les cl s de licence mixte ne sont lues correctement que par les versions g rant les licences mixtes 02 06 00 et ult rieures Cependant les versions ant rieures tablissent l quivalence d une licence mixte en licence pour acteurs d clar s sur la base de 10 acteurs d clar s pour 1 acteur flottant Par exemple sur un tel serveur une cl de licence mixte pour 15 acteurs d clar s et 3 flottants est vue comme une cl de licence pour 45 acteurs d clar s 15 3 x 10 3 6 5 3 ce Lors de la mise jour d un serveur ayant une licence pour acteurs d clar s exclusivement on attribue le r le declared tous les acteurs existants Cette op ration a pour but d
95. ent exister dans W4 Engine et pas dans LDAP Si on souhaite que ces acteurs puissent se loger sans authentification LDAP leurs logins doivent tre renseign s dans ces champs de saisie Il n est pas utile de nommer ici les acteurs w4adm et automatic FF Chapitre 2 Configuration ta 2254 R lES et groupes 2 2 5 4 1 L cran Roles et groupes Roles and groups se pr sente ainsi member LOAP attribute contaming the rola s name em Base Ou Foles o yW4 cope LOAP_SOOFE_SUBTREE Fig 2 10 LDAP R les et groupes 1 3 Cet cran comporte les sections suivantes Assignation des r les Role assignation Cr ation Creation Comment retrouver les r les dans LDAP How to retrieve roles in LDAP Correspondance entre attributs LDAP et W4 LDAP and W4 attributes mapping Correspondance entre valeur dans LDAP et valeur dans W4 LDAP and W4 values mapping Correspondance entre noms des r les dans LDAP et noms des r les dans W4 LDAP and W4 roles name mapping R les LDAP ne devant pas tre d sassign s Roles that mustn t be unassigned R les LDAP ignor s par W4 LDAP roles ignored by W4 Comment retrouver les groupes dans LDAP How to retrieve groups in LDAP Configuration pour la mise jour automatique Configuration for automatic update Assignation des r les Role assignation La repr sentation des r les dans LDAP peut tre de trois types la valeur d un attribut LDAP d une entr e d finissant un
96. er tait galement absent et ainsi de suite jusqu ce qu un rempla ant pr sent soit trouv Lorsque W4 Engine rencontre une boucle d acteurs absents il applique les r gles d assignation automatique Valeur par d faut 1 Exemple d utilisation du param tre w4adm substituteMaxDepth 5 NOTE Ce param tre fournit galement le nombre de niveaux de recherche pour le rempla ant de l acteur responsable d un dossier dans le cadre des r gles d assignation automatique Pour plus de d tails sur les r gles d assignation automatique veuillez consulter le Manuel de r f rence de Process Composer suspensionDelay D lai de suspension Valeur par d faut 1 heure Exemple d utilisation du param tre waadm suspensionDelay day 1 threadChannelMaxSize Windows seulement taille du tampon des demandes de service en provenance du Service Manager de Windows Valeur par d faut 16 tmpDir F LE 51 PARAM TRE DESCRIPTION D finit un r pertoire de stockage des fichiers temporaires diff rent du r pertoire par d faut Valeur par d faut m UNIX var tmp m Windows C Temp Exemple d utilisation du param tre w adm tmpDir d data w4 temp Commentaire voir remarque ci dessous sur le sticky bit tryNb Nombre de tentatives de connexion au d marrage de W4 Engine Valeur par d faut 15 Exemple d utilisation du param tre w aadm tryNb 100 Commen
97. erarchy du sch ma W4 Engine lors des recherches corbeille de t ches avec un crit re sur les r les Pour ce faire dans w4server cfg la ligne suivante doit tre ajout e lt instanceName gt useDynRoles false W4 Engine doit alors tre red marr r 4 3 3 4 3 3 1 4 3 3 2 Scalabilit interne de W4 Engine Lors du d marrage d une instance W4 Engine les services se connectant la base de donn es entre autres wfadministrator wfscheduler wfdataminer sont configur s pour accepter un nombre maximal de requ tes simultan es dernier param tre dans le fichier Config lt instanceName gt Le processus central serveur wfbroadcaster route les messages correspondants aux requ tes clientes connexion recherche modification d tat administration vers les services nomm s pr c demment Ces services traitent les appels envoy s par wfbroadcaster dans leur ordre d arriv e Le moteur offre la possibilit de parall liser n instances d un m me process afin de r partir plus quitablement la charge demand e par l appel des API w x Identification des services en surcharge Pour identifier la charge pr sente au niveau de chaque service il faut soit utiliser la console W4 disponible dans W4Engine_Home bin w4 exe sous win32 et sous W4HOME bin w4 sous Unix et Linux ou l outil wfaudit disponible dans le r pertoire W4Engine Home bin Lorsque W4 Engine est d marr l option 12 de la console permet de visual
98. ersion 4 1 de W4 Engine les proc dures d administration sont install es par d faut pour les serveurs d valuation et les serveurs de production 1 Sous l outil de mod lisation Process Composer installez la proc dure Welcome Screens fichier lt softwareHome gt Procedures Welcome w4e 2 Connectez vous l interface d administration en tant que w4adm 3 Cr ez un nouveau dossier sous l interface classique pour la proc dure Welcome Screens dans le sous menu Corbeille Workitems s lectionnez Dossier Case La page Cr er un dossier Create a workcase s affiche r M w4adm Create a workcase w4adm Work Items Procedure LArchivege _ s Case averdue date procedure overdue M 1 Le Case nome lmdodm Custom overdue year month hay Case r Case priority procedure prior M Case alarm date procedure alom We Coordination L f 1 f VET Administration Custom priority Custom alarm year manth Hay Archival Home page create morkcase and Start initial task Reset Logout Fig 5 1 Installation de l application Welcome Screens 1 2 dans le bandeau s lectionnez Cr er Create Dans la liste d roulante Proc dure Procedure s lectionnez Welcome Screens a s lectionnez Cr er un dossier et d marrer la t che initiale Create workcase and start initial task L cran de la premi re t che de cr ation des crans d accueil s affiche Fri ds 137 Chapitre 5 Installation de l application We
99. es t ches La configuration de la notification par courrier lectronique est d crite dans la Note technique Notification par courrier lectronique Administration de W4 Engine L administration du serveur se fait via deux interfaces Web un utilitaire en mode ligne et une console Interfaces et outils d administration Deux interfaces d administration l une en Java JSP l autre en CGI sont utilis es pour l administration des objets statiques et dynamiques g r s par le serveur W4 Engine Un outil en mode ligne w4eimport peut tre utilis en lieu et place de l outil de mod lisation en mode graphique Process Composer pour installer les proc dures sur le serveur W4 Engine Des commandes d administration sont galement accessibles via le programme en mode ligne w4 Interface d administration Java JSP et interface d administration CGI Ces interfaces d administration permettent de g rer les objets statiques et dynamiques du serveur W4 Engine L acc s ces interfaces se fait via un serveur HTTP pouvant se trouver soit directement sur le serveur W4 Engine soit sur une autre machine physique Les interfaces d administration CGI est d crite dans le chapitre suivant 3 1 Interface d administration page 74 1 3 2 L interface d administration Java JSP de W4 Engine est d crite dans le Manuel d utilisation de W4 Admin for Java Utilitaire w4eimport la diff rence de Process Composer qui peut se connecter au
100. eur par d faut aucune Commentaire ajoute l option Xms lt value gt lors du d marrage du serveur de connecteurs java_xmx Maximum Heap Size de la JVM Valeur par d faut aucune Commentaire ajoute l option Xmx lt value gt lors du d marrage du serveur de connecteurs java_xnoclassgc Inhibe la GC des classes Valeur par d faut aucune Commentaire ajoute l option Xnoclassgc lors du d marrage du serveur de connecteurs jconnector Bool en qui sp cifie le d marrage ou non du serveur de connecteurs Valeur par d faut FALSE Exemple d utilisation du param tre waadm jconnector true jconnector_port PARAM TRE DESCRIPTION Port d coute du serveur de connecteurs Valeur par d faut aucune param tre positionner obligatoirement si le param tre jconnector est positionn TRUE Exemple d utilisation du param tre w4adm jconnector_port 7777 licenseKey Cl de licence Valeur par d faut aucune Exemple d utilisation du param tre w4adm licenseKey lt licenseKey gt o lt licenseKey gt repr sente la valeur de la cl de licence Pour plusieurs machines en cluster partageant la m me arborescence W4 Engine il est possible d enregister les cl s de licence sous la forme w adm lt primaryKey gt licenseKey lt licenseKey gt o lt primaryKey gt repr sente la valeur de la cl primaire d une machine du cluster Un m
101. faut la mention none si la cl de licence d finitive n est pas renseign e ce qui est le cas pour une version d valuation Pour obtenir une cl de licence d finitive reportez vous au Manuel d installation de W4 Engine L entr e Declared actors indique le nombre de licences d clar es L entr e Concurrent logins indique le nombre de licences concurrentes Les licences sont d crites dans le chapitre suivant 3 8 5 Contr le des licences page 108 L entr e Expiration date indique la date d expiration de la licence d faut la mention none si une cl de licence d finitive a t renseign e Enregistrement d une cl de licence Commande w4 i lt instanceName gt license add lt licenseKey gt puis validez par Entr e o licensekey d signe la cl de licence d finitive fournie par le support technique W4 Equivalent menu 8 et validez par Entr e pour afficher le sous menu Server License 6 et validez par Entr e pour saisir la cl de licence l invite Licence key renseignez la cl de licence et validez par Entr e Pour obtenir une cl de licence d finitive reportez vous au Manuel d installation de W4 Engine 3 4 4 Le 3 5 1 D marrage et arr t en mode forward IMPORTANT Ces commandes sont utiliser avec l assistance du support technique W4 Commande w4 forward start w4 forward stop puis validez par Entr e Equivalent menu 7 puis validez par Entr e l invite Forward server rensei
102. fication est envoy e via http lorsque les t ches sont assign es en libre service sur le r le automatic Valeur par d faut http nodeProperty P HTTP SERVER nodeProperty P HTTP ALIAS mgrqispi94 dll appname IFS amp prgname W4Trigger amp name nodeProperty P_ HTTP ARGUMENT amp arguments AW4 1 Commentaire dans ce mod le les champs nodeProperty sont remplac s par les valeurs effectives des propri t s des n uds correspondants Des l ments du contexte sont ajout s ce mod le id lid pour l authentification wfs nom de l instance W4 Engine taskld et caseld W4 Engine suspend la t che si la substitution des propri t s choue mod le invalide ou propri t inconnue par exemple La t che est maintenue l tat offerte si la notification HTTP est accept e par le serveur HTTP W4 Engine consid re la notification accept e s il re oit en retour un document texte commen ant par OK Dans tous les autres cas W4 Engine suspend la t che sur un v nement de classe OTHER notamment si le serveur HTTP retourne un document commen ant par Rejected ou par tout autre texte que OK m retourne une erreur HTTP m est absent ou occup pas de r ponse la demande de connexion m ne retourne pas de document dans le temps imparti Par d faut le temps imparti pour recevoir l accus de r ception est de 1 seconde Ce temps est configurable Pour cette configuration voir le param tre d instance
103. gnez le nom ou l adresse IP du serveur h bergeant W4 Engine 5 puis validez par Entr e Ces commandes ex cut es sur le serveur h bergeant le serveur Web servent au d marrage et l arr t du mode forward lorsque le serveur Web et le serveur W4 Engine sont h berg s sur des machines distinctes Positionnement et tat des traces La console W4 permet de visualiser l tat des traces et de positionner les traces sur le processus CGI La visualisation et le positionnement des traces sont d crits dans le chapitre suivant 3 9 Contr le de l activit du serveur page 110 Fichiers d exploitation Les fichiers d exploitation sont de quatre types fichiers temporaires fichiers journaux s fichiers de traces s fichiers d archives Fichiers temporaires Objet Les fichiers temporaires sont cr s pour g rer les changes inter processus du CMD quand n cessaire les contextes de retour backup context des crans des proc dures de workflow en CGI Pour plus de d tails veuillez vous reporter aux guides de programmation de W4 Engine Localisation UNIX var tmp Windows TEMP Nommage UNIX lt nom d instance gt lt 6 caract res al atoires gt Windows w4a lt 3 caract res al atoires gt tmp Exemple UNIX var tmp w4admLVw6Ua Windows C WINNTNTEMP w4a29C tmp Dur e d utilisation Les fichiers d changes inter processus ont une dur e d utilisation tr s courte correspondant au temps de t
104. hiers sont d crits dans le chapitre suivant 3 5 Fichiers d exploitation page 87 1 3 4 T ches d administration L administration du serveur W4 Engine implique l ex cution de t ches de sauvegarde de la base de donn es d archivage des donn es et de gestion des utilisateurs du workflow Sauvegardes Pour sauvegarder la base de donn es de W4 Engine il est possible d exporter son contenu dans un fichier de format propri taire W4 ind pendant de la base de donn es puis d importer ce fichier sur tout serveur W4 Engine lors de la cr ation d une nouvelle instance Une autre possibilit consiste en l utilisation des fonctions natives d import export du syst me de gestion de bases de donn es Archivages Afin de ne pas nuire aux performances les objets relatifs aux dossiers termin s et annul s t ches variables dossiers etc peuvent tre archiv s vers des tables d archive ou vers un support externe L archivage est d crit dans le chapitre suivant 3 7 Archivages page 92 Gestion des utilisateurs La gestion des utilisateurs inclut le mode d authentification et la connexion des utilisateurs la gestion des sessions des d lais et des licences Ces t ches sont d crites dans le chapitre suivant 3 8 Gestion des utilisateurs page 103 Contr le de l activit du serveur Pour surveiller l activit du serveur W4 Engine les administrateurs ont leur disposition plusieurs utilitaires ainsi qu un m canisme
105. i n est pas contr l Si toutefois un identifiant est fourni en param tre 1 il prend le dessus sur l identifiant externe et l on se retrouve dans le cas d une authentification interne Le mot de passe doit alors tre fourni Si l authentification est interne l utilisateur doit fournir son identifiant 1 et son mot de passe 2 tels qu enregistr s dans le workflow L authentification acquise l utilisateur se voit attribuer un contexte de session identifi de fa on unique par un login identifier ou lid L utilisateur peut se connecter plusieurs fois de suite sous le m me identifiant ventuellement sur des stations diff rentes Toutes les sessions ouvertes auront le m me lid 3 8 3 3 8 3 1 3 8 3 2 IMPORTANT Siun Logout est effectu sur l une des sessions toutes les sessions sont ferm es Que l authentification soit interne ou externe l utilisateur peut forcer la cr ation d une nouvelle session en positionnant le param tre de for age 3 Dans ce cas la nouvelle session est cr e avec un nouveau lid tous les crans de toutes les sessions pr c dentes sont de fait invalid s Un utilisateur se d connecte du serveur de workflow en ex cutant la commande logout Sessions Pour pr venir les oublis de d connexion deux d lais sont associ s chaque session le d lai de suspension par d faut 1 heure et le d lai d expiration par d faut 24 heures Ils sont r arm s apr s chaque interaction de
106. ication des acteurs et des r les Si le dossier LDAP a d j t cr un menu est disponible sous la corbeille au centre de la page ce menu comporte entre autres les liens Mise jour des acteurs Actors update et Mise jour des r les Roles update W4 Engine Manuel d exploitation 48 4 o PEP Ner instance 7 Leg sa You a connected as v adm LDAP 2465 Fig 2 3 R plication des acteurs et des r les 1 2 S lectionnez Mise jour des acteurs Actors update pour r pliquer les acteurs S lectionnez Mise jour des r les Roles update pour r pliquer les r les NOTE L explication ci dessous est fournie pour les acteurs le principe est le m me pour les r les La page Mise jour des acteurs Actors update s affiche Chapitre 2 Configuration u3 2 2 4 b 1 w Actors update Base ou Peopile o W4 LDAP fiter objectcioss inatOrgPerson Scope LOAP SCOPE_SUBTREE Fig 2 4 R plication des acteurs et des r les 2 2 Cette page permet de saisir les param tres d une recherche dans l annuaire LDAP et de r pliquer les acteurs r sultant de la recherche Si un acteur existe dans W4 Engine et n est pas pr sent dans l annuaire LDAP un message est consign dans le fichier journal du processus concern parmi les processus de W4 Engine connect s l annuaire LDAP voir Configuration g n rale ci dessous Si l option Seulement les acteurs qui sont d j dans W4
107. ient prises en compte Param tres du fichier w4server cfg Les param tres du fichier de configuration w4server cfg sont les suivants Table 2 3 Param tres du fichier w server cfg PARAM TRE DESCRIPTION alias Activities N na Chapitre 2 Configuration PARAM TRE DESCRIPTION Redirige le r pertoire lt softwareHome gt Activities vers un autre r pertoire Valeur par d faut lt softwareHome gt Activitites Exemple d utilisation du param tre ww4adm alias Activities MonProjet F MP commun Appli MonProjet Act ivities Commentaire une activit du type MonProjet Init aura son template d activit s sous F MP commun Activities alias Templates Redirige le r pertoire lt softwareHome gt Templates Vers un autre r pertoire Valeur par d faut lt softwareHome gt Templates Exemple d utilisation du param tre waadm alias Templates MonProjet F MP commun Appli MonProjet Temp lates Commentaire les pages du projet MonProjet MonProjet Workitem html seront retrouv es sous F MP commun Templates alias Templates Mail Redirige le r pertoire lt softwareHome gt Templates Mail vers un autre r pertoire Valeur par d faut lt softwareHome gt Templates Mail Exemple d utilisation du param tre waadm alias Templates Mail F MP commun Mail archFileName useCaseld Les fichiers d archivage offline peuvent tre nomm s workcase lt caseld gt archsila valeur e
108. il la plus faible 131 Mode non interactif W4 Engine 82 Modification d une proc dure W4 Studio 148 152 Module d acteur automatique W4 Engine 14 Module de surveillance W4 Engine 14 msgSize param tre d instance W4 Engine 41 netConnectorHost param tre d instance W4 Engine 41 netConnectorPort param tre d instance W4 Engine 41 NLS_LANG variable d environnement 155 Nombre de services configurer W4 Engine 130 not running disconnected console w4 80 Notification par courrier lectronique 17 Optimisation de la base Oracle 132 Optimisation des applications W4 BPM Suite 120 Option p W4 Engine 126 Option e d marrage de W4 Engine 20 Option e W4 Engine 83 Performances des API W4 Engine 126 Pool de connexion 122 123 Pool de connexion code d initialisation 122 Port d coute du listener W4 Engine 14 Primary key W4 Engine 86 Proc dure d administration Archivage 78 92 Proc dure d administration Calendar 17 Proc dure d administration Calendar W4 Engine 69 Proc dure d administration LDAP 16 W4 Engine Manuel d exploitation 166 167 Index Proc dure modifier W4 Studio 148 152 Proc dure supprimer W4 Engine 77 Process Composer pr sentation 10 Processus central serveur W4 Engine 11 130 Processus client W4 Engine 13 Processus serveur W4 Engine 12 Processus wfbroadcaster W4 Engine 130 Programme concierge W4 Engine 13 Programme w4 18 80 R gles d assignation automatique 43 R pertoi
109. iltre LDAP LDAP filter le filtre utilis pour les recherches dans l annuaire s dans la liste d roulante Scope le scope pour les recherches 225410CoOnfiguration pour la mise jour automatique Configuration for automatic update Ces param tres permettent de contr ler une activit automatique de la proc dure LDAP Cette activit lance un ex cutable wfbatch qui r plique les acteurs Dans les champs Heure de l update Update time saisissez l heure laquelle la mise jour doit tre effectu e heures minutes et secondes Dans les champs P riode pour la mise jour Update period saisissez l intervalle s parant deux mises jour jours heures et minutes La premi re mise jour se fait au plus t t l heure pr vue c est dire le jour m me ou le lendemain Cette mise jour concerne toutes les entr es de l annuaire qui sont trouv es partir de la base et du scope Les acteurs cr s ainsi auront comme mot de passe W4 Si un acteur existe dans W4 Engine et n est pas pr sent dans LDAP un message est consign dans le fichier journal S lectionnez la case cocher Mise jour automatique si vous souhaitez utiliser le traitement batch d crit ci dessus 224 Mappings possibles pour quelques classes LDAP Table 2 4 Mappings possibles pour quelques classes LDAP ATTRIBUT LDAP ATTRIBUT W4 Classe Person Sn lastName description description telephoneNumber phoneNumber Classe organi
110. ine Exemple 7 code de lancement d une t che optimis TWFtaskRef taskRef new TWFtaskRef 1200 taskRef wfProcessTask R cup ration en un appel des variables de t ch t de dossier TWFTfullTaskFieldName fields new TWFTfullTaskFieldName fields add TWFfullTaskFieldName TASKVARIABLES fields add TWrfullTaskFieldName CASEVARIABLES TWFfullTask fullTask taskRef wfGetFullTask fields null null R cup ration du dossier TWFTrawVariable taskVariables fullTask getTaskVariables TWFTrawVariable caseVariables fullTask getCaseVariables ri 125 Chapitre 4 Optimisation des performances are 4 2 6 Le code ci dessus r alise les m mes op rations mais il sollicite uniquement deux fois le moteur W4 Engine Outil de mesure de performances des API Afin de d terminer la charge d un ensemble d appels workflow API wf au sein d une m me page ou d un m me programme client une option est param trable dans un des fichiers de configuration de W4 Engine qui permet de mesurer en secondes le temps d ex cution des API serveur On rajoute l option p p comme performance dans le fichier lt W4Engine Home gt sys Config lt instanceName gt comme le montre le fichier ci dessous Mill wfmill 1 1 10 Administrator wfadministrator 1 1 10 Scheduler wfscheduler 1 1 30 Data Miner wfdataminer p 1 1 20 Archiver wfarchiv 1 1 10 Babel Web wfbabel 1 1 10 Listener TCP wflistener w4d 1
111. ine 24 Archivage off line 134 Archivage offline W4 Engine 93 102 Archivage on line 134 Archivage online p riodique W4 Engine 93 96 Archivage online W4 Engine 93 Archivages W4 Engine 19 92 Archiver service de W4 Engine 13 Arr t du serveur W4 Engine 18 attachJVM param tre d instance W4 Engine 25 Audit service de W4 Engine 15 auditLogin param tre d instance W4 Engine 25 auditLoginFileName param tre d instance W4 Engine 25 Authentification des utilisateurs W4 Engine 19 104 Authentification externe W4 Engine 104 Authentification interne W4 Engine 104 automatic acteur 109 automatic r le 110 Automatic service de W4 Engine 14 automaticRestartPeriod param tre d instance W4 Engine 26 Babel Web service de W4 Engine 13 Base de donn es de W4 Engine export 19 Big Brother service de W4 Engine 14 Broadcaster service de W4 Engine 11 Calendar proc dure d administration W4 Engine 69 Calendrier configuration W4 Engine 71 Calendriers configuration W4 Engine 17 68 caseSensitive param tre d instance W4 Engine 27 caseSensitive param tre d instance W4 Engine 129 Cconsole W4 18 CGI forward W4 Engine 18 checkDelegationPrivileges param tre d instance W4 Engine 27 CMD Central Message Dispatcher W4 Engine 11 CMD mode exclusif W4 Engine 82 cmdTimeOut param tre d instance W4 Engine 27 Commande login param tre de for age W4 Engine 105 Commande login W4 Engine 104 Commande logout W4 Engine
112. ion de 1 jour et 4 heures Ins rer les lignes suivantes dans le fichier de configuration w4server cfg w4adm expirationDelay day 1 w4adm expirationDelay hour 4 D lai de suspension Ce d lai ne concerne que les acteurs non d clar s Un acteur non d clar log qui reste inactif pendant la dur e de ce d lai voit son logement devenir candidat r attribution On dit alors que son logement est suspendu Il peut alors tre d log par le serveur si un autre acteur non d clar se loge et qu aucun jeton de licence flottante n est disponible dans ce cas l acteur effectivement d log est l acteur suspendu inactif depuis le plus longtemps Si l acteur n est pas d log pendant qu il est suspendu et qu il interagit nouveau avec le serveur il redevient actif Ce d lai est sp cifiable a par acteur commande SetActorSuspDelay 3 8 4 3 3 8 4 4 a par r le commande SetRoleSuspDelay a globalement La valeur par d faut du d lai de suspension global est de 1 heure Il peut tre configur gr ce au param tre d instance suspensionDelay et modifi dynamiquement par l acteur w4adm au moyen de la commande SetSuspensionDelay La valeur courante peut tre obtenue par la commande GetSuspensionDelay IMPORTANT La fonction SetSuspensionDelay ne modifie le d lai de suspension que pour la dur e de la session en cours Elle ne modifie pas le fichier de configuration C est donc le d lai inscrit dans le fichier de co
113. is e est 1ib1dap so Le r pertoire contenant ce fichier doit tre r f renc dans la variable d environnement LD LIBRARY PATH OU LIBPATH Pour plus de d tails veuillez consulter le Manuel d installation de W4 Engine NOTE Uneincompatibilit entre la biblioth que cliente LDAP libldap so et la biblioth que cliente Oracle libcintsh so a t constat e et peut sur certaines plates formes provoquer une erreur 437 Si vous rencontrez ce probl me veuillez sp cifier m dans ce champ le nom de la biblioth que cliente Oracle soit libcintsh so dans le champ Protocole la version 3 du protocole Sur Windows la librairie Microsoft est utilis e wldap32 411 22519 Adresse du serveur Server address Dans ce champ de saisie renseignez le nom ou l adresse IP de la machine h bergeant l annuaire LDAP 225110Num ro de port Port number Dans ce champ de saisie renseignez le port d coute du serveur LDAP Il s agit g n ralement du port 389 NOTE m Le num ro de port peut galement tre renseign dans le champ Adresse du serveur de la fa on suivante lt nom adresse IP machine gt lt num ro port gt Dans ce cas si un num ro de port est galement saisi dans le champ Num ro de port ce dernier est ignor m l est galement possible de sp cifier les adresses de plusieurs annuaires de la fa on suivante lt nomjad IP mach 1 gt lt num port gt lt nomlad IP mach 2 gt lt num port gt
114. iser l tat des services de W4 Engine ainsi que celui des clients connect s Configuration du nombre de services Pour un m me serveur W4 Engine on multiplie ainsi les process serveurs se connectant la base de donn es en g n ral seuls wfadministrator wfscheduler et wfdataminer sont concern s Ces derniers tant les plus consommateurs de ressources machine La configuration du nombre de services s effectue via le fichier Config lt instanceName gt pr sent dans le r pertoire sys du r pertoire W4Engine Home Exemple de fichier config w4adm Mill wfmill 1 1 10 Administrator wfadministrator 1 1 10 Scheduler wfscheduler 3 3 30 Data Miner wfdataminer 3 3 20 Archiver wfarchiv 1 1 10 Babel Web wfbabel 1 1 10 Listener TCP wflistener w4d 1 Big Brother wfbigbrother 5 1 Automatic wfautomatic l AQQS UES NH k lt nom service gt wf lt nom process gt i j maxkRq i correspond au nombre maximal de process simultan ment pr sents un instant t j correspond au nombre de process total lanc s au d marrage du serveur maxkRq correspond au nombre total de requ tes acceptables par process 4333 Conclusion 4 3 4 4 3 5 Tant que tous les process ont au moins trait une requ te on consid re qu ils sont tous utiles et incr menter leur nombre peut s av rer b n fique On arrive de proche en proche d terminer le nombre d instances n cessaires pour un service donn en exploitation d s lo
115. iser la m thode wfGetFullTask Pensez utiliser la m thode wfGetFullCase Pensez utiliser la m thode wfSearchFullTask IMPORTANT Cette API 2 utilis e pour un nombre de variables param tres taskvariables inf rieur ou gal 5 Si l on doit ramener plus de 5 bles il faut plut t utiliser l instruction suivante fields add TWFfullTaskFieldName TASKVARTABLES Pensez utiliser la m thode wfSearchFullCase Pensez utiliser le pool de connexions valuez le co t des requ tes wf Optimisation de W4 Engine Cette section couvre notamment les l ments d optimisation suivants param trage du nombre de connexions simultan es W4 Engine activation du mode case sensitive d sactivation de la fonction upperRole optimisation du nombre de services connect s la base configuration des d mons acteur automatique et big brother Rappel sur l architecture W4 Engine est compos de plusieurs services Ces services communiquent entre eux via IPC et RPC sous Unix Linux respectivement en mode local et mode distant ou via les tubes nomm s sous Windows 2000 4 3 2 4 3 2 1 4 3 2 2 Configuration des param tres d instance Cette section pr sente l utilisation des param tres maxPendingConnection caseSensitive et useDynRoles Communication locale sous NT Le serveur W4 Engine ouvre par d faut 5 canaux pour l coute des connexions Lorsqu un nombre important de connexions simultan es arrive
116. ispatcher distributeur central de messages processus central serveur Permet de d marrer et arr ter le syst me de conna tre les utilisateurs connect s ainsi que l tat des files d attente canaux des services de lancer de nouvelles instances d un service et de les arr ter Il est charg de r ceptionner tous les messages requ tes et r ponses et de les transmettre aux destinataires via les canaux appropri s Il g re galement la liste des sessions ouvertes ce qui permet un utilisateur d j connect de soumettre une requ te sans s authentifier de nouveau 1 13 113 2 Processus serveur Les processus serveur sont les suivants a notification a administration a ordonnancement a recherche archivage traduction l exception du module de notification les processus serveur sont connect s en permanence la base de donn es Ces services traitent par ordre d arriv e les requ tes re ues sur leur canal de communication Pour s adapter la charge du syst me et aux ressources disponibles plusieurs instances d un m me service l exception du module de notification peuvent tre activ es simultan ment Administrator Nom du service Administrator Nom du processus associ wfadministrator exe galement d sign service d administration G re tous les objets statiques API buildtime cr s lors de la d finition de la proc dure ou lors de la mod lisation de l organis
117. l et non pas seulement l action en cours Lorsque le param tre enableTransactionControl est positionn TRUE le CMD utilise des services sachant traiter toute requ te en lieu et place des services sp cialis s IMPORTANT Le programme wfengine exe impl mentant ces services sp cialis s doit tre pr sent dans le r pertoire lt W4Engine_Home gt bin sans quoi le serveur W4 Engine ne d marre pas et l erreur 4 WFERR_EXEC est retourn e Lorsque le param tre enableTransactionControl est positionn TRUE les entr es suivantes du fichier de configuration du CMD 2 Administrator w fadministrator 1 1 10 3 Scheduler wfscheduler 1 1 30 4 Data Miner wfdataminer 1 1 20 5 Archiver wfarchiv 1 1 10 6 Babel web wfbabel 1 1 10 sont interpr t es comme si elles taient remplac es par l entr e unique E Engine wfengine 5 5 30 Les nombres maximum et initial d instances du service wfengine sont respectivement gaux aux sommes de ces m mes nombres pour les diff rents services sp cialis s Le nombre maximum de requ tes en attente par instance est gal au maximum de ces m mes nombres pour les diff rents services sp cialis s M me si elle n est pas n cessaire la modification de la configuration du CMD est possible pour des raisons de lisibilit IMPORTANT Des entr es num rot es ne doivent pas coexister avec des entr es marqu es E auquel cas le CMD ne d marre pas et retourne l erreur W
118. l gier Ces fonctions ont la forme suivante search lt OBJECT gt ra 4 2 3 4 2 3 1 IMPORTANT Ilfaut viter au maximum d utiliser une m thode de type search lorsque cela est possible Utilisation du pool de connexion environnement Java A partir de la version 4 1 une nouvelle fonctionnalit du moteur est disponible en environnement Java qui am liore sensiblement les performances de connexions simultan es Le principe est le suivant cr er N connexions tuyaux entre un client et une instance W4 Engine Un pool de connexions a pour objectif de diminuer le co t d tablissement et de fermeture d une connexion Dans le mode classique W4 toutes les ouvertures et fermetures de connexions sont symbolis es par l appel des m thodes openConnection et closeConnection des objets d rivant la classe TWFsession Initialisation d un pool en Java pur Avant toute interaction avec les API Java ins rer le code suivant permet d ouvrir un pool de connexion try TWFconnectionPool init 10 wAServer w4Prod catch TWFexception wfe System out println n Failed to create the connection pool wWfe printStackTrace System exit l 4232 Initidlisation d un pool mode Web Les param tres du pool de connexions sont renseign s dans le fichier web xm1 de l application lt init param gt lt param name gt pool mode lt param name gt lt param value gt true lt param value gt
119. l utilisateur avec le serveur W4 Engine tats des sessions Session active Si la dur e entre deux interactions est inf rieure au d lai de suspension la session est active et aucun contr le n est effectu Session suspendue Si la dur e entre deux interactions exc de le d lai de suspension la session a t suspendue par le workflow L erreur 614 est lev e L utilisateur se voit proposer de confirmer son mot de passe ou d abandonner sa session Si l utilisateur choisit de confirmer son mot de passe les sessions en cours sont restaur es avec le m me lid et tous les crans associ s restent valides Session expir e Si la dur e entre deux interactions exc de le d lai d expiration le workflow refuse l interaction La session a expir L erreur 613 est lev e Tous les crans associ s sont invalid s La r utilisation de ces crans provoque une erreur L utilisateur doit se reconnecter l issue de sa r authentification une nouvelle session avec un lid diff rent sera cr e Les d lais ont la m me origine il y a donc par d faut 23 heures entre l ch ance du d lai de suspension et du d lai d expiration crans de reconnexion CGI Le mod le d cran template pr sent sur suspension est LoginSuspended html Sur expiration il s agit de LoginExpired html Les templates LoginSuspended html et LoginExpired html et plus g n ralement tous les templates de gestion des connexions Login html 3
120. lcome Screens us Create or modify welcome screen English Title Welcome Screens French Title Ecrens d accueil Spanish Title German Title Italian Title Type Profile Le List of roles A scministrator __ outhor outomatx chessPiayer Select procedure Welcome Screens M Template no extension Welcome WelcomeScreans Presentation order 1 99 highest are first presented gp Icon W mages welcome git Terminate on hold 22 Add comment View Comments Fig 5 2 Installation de l application Welcome Screens 2 2 Renseignez letitre de l application dans la les langue s souhait e s EVITER LES APOSTROPHES a letype profil leou les r les qui auront acc s cette application via l ic ne d acc s dans leur cran de navigation administrator a la proc dure Welcome Screens a la page HTML template d accueil de la proc dure Welcome WelcomeScreens l ordre de pr sentation 60 99 pour les profils 50 pour les services 1 40 pour miscellaneous a l ic ne W4lmages welcome gif m S lectionnez Terminer Terminate L acc s l application de gestion des crans d accueils est d sormais possible partir de la page des services W4 W4 Engine Manuel d exploitation 138 139 Chapitre 5 Installation de l application Welcome Screens 6 1 Chargement d objets de mod lisation par script w eimpori Cette annexe pr sente w4eimport utilitaire en mode ligne servant charger
121. le L cran Configuration g n rale General configuration se pr sente ainsi Vou sre connected s w4 adrm AGmirustrator Dataminer Scheduler LDAP connection connection connection Authentication B B 3 D Protocol version Referentals used for GetActor and GetRole LDAP chent library Server address Port Number DN used for W4 authentication Password Use the logging in actor s ON Ldap bind timeout ms Ldap search timeout s Exch je LDAP Exchange Replicate object s attributes Authen catdon directory duning creation o o B v2 va O LDAP and Ws LDAP only 4 only Le libidapssl1 41 5o 127 168 0 180 389 500 Fig 2 6 LDAP Configuration g n rale 22511 Connexion de l administrateur Connexion du dataminer Connexion du scheduler Pour utiliser les fonctionnalit s de W4 Engine pour LDAP et quelles que soient les fonctionnalit s utilis es il faut s lectionner une ou plusieurs des options suivantes Connexion de l administrateur Administrator Connection S lectionnez cette case cocher pour que le service Administrator utilise LDAP Ce service peut authentifier les acteurs contre LDAP et g re les mises jour automatiques W4 Engine Manuel d exploitation 52 Connexion du dataminer Dataminer Connection S lectionnez cette case cocher pour que le service Data Miner utilise LDAP La connectivit de ce service avec LDAP est d crite dans le champ R f rentiels utilis s po
122. le DN de l acteur qui se loge W4 Engine 55 LDAP version du protocole W4 Engine 54 Licence flottante W4 Engine 106 108 Licence mixte W4 Engine 109 110 Licences utilisateurs concurrentes W4 Engine 108 Licences utilisateurs d clar s W4 Engine 109 Licences W4 Engine 18 19 108 License key W4 Engine 86 licenseKey param tre d instance W4 Engine 37 listen param tre d instance W4 Engine 37 Listener service de W4 Engine 13 listenerUseThreads param tre d instance W4 Engine 37 lockingDelay param tre d instance W4 Engine 38 lockingDelay param tre d instance W4 Engine 107 logDir param tre d instance W4 Engine 38 mail param tre d instance W4 Engine 38 mail command param tre d instance W4 Engine 38 mail optionsOnCommandLine param tre d instance W4 Engine 39 165 Index mail subjectOption param tre d instance W4 Engine 39 mail toOption param tre d instance W4 Engine 39 mailDir param tre d instance W4 Engine 39 Mailer service de W4 Engine 15 mailSuffix param tre d instance W4 Engine 39 mailx 17 MAPI 17 mapiDLL param tre d instance W4 Engine 40 mapiPassword param tre d instance W4 Engine 40 mapiProfile param tre d instance W4 Engine 40 maxConnectionNb param tre d instance W4 Engine 40 maxPendingConnections param tre d instance W4 Engine 40 maxPendingConnections param tre d instance W4 Engine 128 Mode case sensitive W4 Engine 128 Mode d assignation Acteur avec la charge de trava
123. les objets d un fichier w4e r alis sous le logiciel de mod lisation Process Composer sur le serveur W4 Engine de la machine sur laquelle il est install connexion locale uniquement w eimport s utilise via une fen tre de commandes Sa principale raison d tre est de pouvoir charger manuellement ou automatiquement par script un fichier w4e sur un serveur de production W4 Engine sur lequel Process Composer n est pas install Avec w eimport il est possible de cr er ou modifier un r le ou une liste de r les cr er une activit ou une liste d activit s s cr er modifier ou r viser une proc dure ou une liste de proc dures Installation Sous Windows w4eimport demande la version 4 0 10 ou ult rieure de WEcLink dil Fichiers w4e cr s avec W4 Auteur et non avec Process Composer l auteur de la proc dure est renseign par W4 Auteur Si l auteur est renseign son compte doit tre cr sur le serveur W4 Engine pour que la cr ation modification de proc dure fonctionne Process Composer ne renseignant pas ce champ cette contrainte n existe pas sous Process Composer Pour les versions 4 0 11 et ant rieures de W4 Engine w4eimport est livr ind pendamment de W4 Engine par le support W4 Dans les versions ult rieures la version 4 0 11 w4eimport est pr sent sur le CD ROM d installation de W4 Engine dans le r pertoire suivant w4 tools lt nom de votre plate forme gt w4eimport 6 2 Sous
124. les traces des erreurs qui ne sont pas d tect es ou non r percut es l administrateur imm diatement Localisation lt softwareHome gt adm log Nommage lt nom_instance_ serveur_w4 gt lt MM gt lt JJ gt lt HH gt lt MM gt lt SS gt arch 3 6 o MM JJ HH MM SS sont le mois le jour l heure la minute la seconde tous sur deux chiffres de la constitution du fichier archive et donc du d marrage du serveur W4 Engine Exemple lt softwareHome gt adm log w4adm0306130826 arch Format L en t te du fichier contient la version du processus le syst me d exploitation et le cas ch ant la base de donn es utilis e soit par exemple lt w4_log gt W4Engine 4 1 5 3 2004 13 Microsoft Windows NT C W4 on Microsoft SQL Server Le corps du fichier poss de le format suivant nom de fichier journal ou trace contenu du fichier nom de fichier journal ou trace contenu du fichier etc Sauvegardes Le programme wdinstall situ sous lt softwareHome gt install comporte une option E Export contents permettant d exporter le contenu de la base W4 dans un fichier de format propri taire W4 extension exp ind pendant de la base de donn es POUR EXPORTER LE CONTENU DE LA BASE DE DONN ES 1 Lancez le programme wainstall 2 S lectionnez l option A Advanced options pour afficher le sous menu des options avanc es du programme 3 S lectionnez l option E Export file pour afficher l
125. liers Il est situ l emplacement suivant lt softwareHome gt bin Sont enregistr es la liste des acteurs log s telle qu elle appara t dans la console W4 entr e 10 Logins s la liste des processus connect s telle qu elle appara t dans la console W4 entr e 12 Processes Ces listes sont tablies pour la premi re fois une minute apr s le d marrage de l outil puis intervalles r guliers L enregistrement s effectue dans le journal d erreur du processus L outil s arr te l arr t du serveur W4 Engine ou lorsqu une erreur se produit Utilisation L outil wfaudit peut tre d marr en mode interactif ou via le fichier de configuration Config lt instanceName gt Exemple en mode int ractif surveillance du serveur toutes les 10 secondes wfaudit 10 Pour un d marrage via le fichier de configuration ditez la ligne suivante C Audit wfaudit 0 Exemple surveillance du serveur toutes les 30 secondes C Audit wfaudit 30 1 Options interval Cette option d finit l intervalle de temps en secondes utilis entre deux audits Par d faut 60 secondes lt E AP traceArgs Arguments de trace Les traces sont d crites dans le chapitre suivant 3 9 2 traces page 113 Statut de fin de programme Les valeurs suivantes sont retourn es 0 Pas d erreur gt 0 Une erreur est survenue wWfwatchsrv surveillance des services Synopsis w watchsrv interval traceArgs
126. lt rieur Les dossiers correspondant aux crit res seront archiv s la date du premier archivage Suspendre Aucun archivage n est effectu Le dossier est mis en suspens et accessible en s lectionnant A traiter dans la partie sup rieure de la page Annuler Annule le dossier d archivage 3721 Modification des crit res d un dossier p riodique en cours Acc dez au menu Suivi partir de la corbeille de l archivage p riodique S lectionnez le dossier modifier l aide du module de recherche 101 Archival Periodical w4adm z w4adm Tite s maximum count 10 sorted by nama M sort order ascending Archival Participants wdacim Soart all the work cases Online all the done mork cases Archive all the running mork cases Penodical Offline creation date x v z Administration a Ds Date of the first archiving Le M E F w LL i Ma ssia Date of the next archiving L_ ac j Logout Selected work cases i archivage 2515 18 01 2005 10 Fig 3 11 Modification des crit res d un dossier p riodique en cours 1 2 Cliquez sur le dossier modifier Archival Periodical w4adm w4adm pes of the archiving criteria Archivol Modifying the archiving criteria Online Archive Periodical Offline Administration Coordination Work Items Home page Logout Fig 3 12 Modification des crit res d un dossier p riodique en cours 2 2
127. m f WdeimportSamples w4de ex Cru r Sub Sub Procedure Sub Procedure Root Procedur l ex cution du fichier de commandes les messages suivants s affichent l cran C wd4eimport gt wdeimport w4adm W w4adm i w4adm f W4eimportSamples w4e ex true Sub Sub Procedure Sub Procedure Root Procedur Sub Sub Procedure REVISED PROCEDURE OK Sub Procedure REVISED PROCEDURE OK Root Procedure REVISED PROCEDURE OK W4 Engine Manuel d exploitation 152 153 Chapitre 6 Chargement d objets de mod lisation par script wdeimport 7 1 Mise en uvre de W4 Engine en UTF 8 Par d faut W4 Engine utilise le format d encodage ISO 8859 1 Cette annexe a pour objectif de d crire les actions n cessaires pour mettre en uvre W4 Engine en mode UTF 8 Cette possibilit s applique aux plateformes de W4 Engine version 6 2 et ult rieures utilisant le SGBD Oracle De plus seules les applications fond es sur l API NET de W4 Engine w4net dll sont concern es Cr ation de l instance Oracle Avant de proc der l installation de l instance W4 Engine vous devez avoir install une instance d Oracle en UTF 8 A l tape 5 du Database configuration assistant onglet Charsets s lectionnez le bouton d option Use Unicode AL32UTF8 r Fig 7 1 Mise en uvre de W4 Engine en UTF 8 Pour le reste de l installation proc dez comme pour une inst
128. mp Attribut Idap qui contient le login de l acteur et valeur est le login que l acteur saisi lors de sa connexion W4 Engine 225 1 13T1IMmeOUT sur le bind ms Timeout sur les recherches s LDAP bind timeout ms LDAP search timeout s Il est possible de sp cifier des timeouts sur les binds et sur les recherches LDAP Les timeouts rendent les appels W4 Engine vers LDAP non bloquants Si le temps imparti est d pass le bind ou la recherche est annul lib rant ainsi W4 Engine Une erreur est alors consign e dans le journal Deux nouvelles erreurs LDAP ont t cr es et sont document es dans la liste des erreurs de W4 Engine Ensuite W4 Engine continue fonctionner au mieux par exemple si l authentification se fait contre LDAP l utilisateur ne pourra pas se connecter W4 Engine En revanche si LDAP est utilis uniquement pour la mise jour des attributs et des r les de l acteur l utilisateur pourra se connecter mais les modifications ventuelles de ses attributs et de ses r les dans l annuaire LDAP ne seront pas prises en compte dans W4 Engine Dans le champ Timeout sur le bind saisissez une valeur en millisecondes pour le bind de l annuaire Un bind LDAP prend en g n ral quelques millisecondes une valeur raisonnable est une valeur inf rieure 1000 ms 225 2 22 58 Dans le champ Timeout sur les recherches saisissez une valeur en secondes pour le timeout sur les recherches La dur e d u
129. n pr sentation 10 W4 BPM Workspace 79 W4 BPM Workspace pr sentation 10 W4 Connectors pr sentation 10 W4 Control Center pr sentation 11 WA Engine modules 11 W4 Engine processus 11 W4 Engine produits compagnons 11 W4 Engine services 11 W4 Extension bus pr sentation 10 w4 forward start console w4 87 w4 license add console w4 86 w4 license show console w4 85 w4 license console w4 85 W4 SAP Connector pr sentation 11 w4 start console w4 81 w4 stop console w4 84 W4 SystemFlow pr sentation 10 w4 term console w4 85 w4 usage console w4 81 w4adm acteur 109 w4adm r le 110 w eimport 18 w4eimport syntaxe 141 w eimport utilitaire W4 Engine 140 w4install 91 W4Public alias W4 Engine 74 WatchSrv service de W4 Engine 15 webProtocol param tre d instance W4 Engine 45 WEF_CRIT_ARCHIVE 93 wf prefixe W4 Engine 121 wfadministrator processus W4 Engine 12 wfarchiv processus W4 Engine 13 wfaudit 130 wfaudit processus W4 Engine 15 wfaudit utilitaire W4 Engine 19 111 wfautomatic processus W4 Engine 14 wfbabel processus W4 Engine 13 wfbigbrother processus W4 Engine 14 wfbroadcaster processus W4 Engine 11 wfdataminer processus W4 Engine 13 wfengine processus W4 Engine 13 wflistener processus W4 Engine 13 wfscheduler processus W4 Engine 12 wfsendmail processus W4 Engine 15 wfsvrmgr processus W4 Engine 15 wfwatchsrv processus W4 Engine 15 wfwatchsrv utilitaire W4 Engine 19 111
130. n de W4 Engine 17 Interfaces et outils d administration 17 Fichiers li s l activit du serveur 18 T ches d administration 19 Contr le de l activit du serveur 19 Configuration z Fichiers de configuration 20 Fichier de configuration Config lt instanceName gt 20 Fichier de configuration w4server cfg 23 Configuration de l annuaire LDAP 46 Pr alables 46 Acc s la corbeille de la proc dure LDAP 47 W4 Engine Manuel d exploitation 4 R plication des acteurs et des r les 48 Description de la configuration 50 Configuration 57 Configuration g n rale 52 Configuration de la s curit 56 Acteurs 56 R les et groupes 62 Mappings possibles pour quelques classes LDAP 66 Mappings possibles pour Active Directory 67 Mappings possibles pour Exchange 5 5 68 Configuration des calendriers 68 Pr alables 69 Installation de la proc dure Calendar 69 Cr ation d une ic ne pour l application Calendar sur la page des services WA 69 Acc s la corbeille de la proc dure Calendar 70 Configuration d un calendrier 71 Administration 7 Interface d administration 74 ACC S 74 Description des menus 76 Modules de supervision fonctionnelle de W4 BPM Workspace 79 Commandes en mode ligne 80 Affichage de la liste des commandes 87 D marrage du serveur 81 Arr t du serveur 84 Arr t du serveur UNIX 85 Gestion des licences 85 Visualisation des informations relatives aux licences 85 Enregistrement d une cl de licence 86 D marrage et
131. n the log directory C Program Files w4 adm log Pour v rifier que les processus sont bien lanc s UNIX Ex cutez la commande ps ef grep wf Vous obtenez un r sultat du type suivant ps ef grep wf 1 w4adm 16828 0 Apr 06 pts 5 0 00 wfbroadcaster w aadm 17608 16828 0 Apr 06 pts 5 0 00 wfautomatic w adm 17614 16828 0 Apr 06 pts 5 0 00 wfscheduler w4adm 18898 16828 0 Apr 06 pts 5 0 00 wfbabel waadm 19152 16828 0 Apr 06 pts 5 0 00 wfdataminer w adm 20428 16828 0 Apr 06 pts 5 0 00 wfadministrator w adm 20432 16828 0 Apr 06 pts 5 0 00 wfarchiv w adm 20454 16828 0 Apr 06 pts 5 0 00 wfbigbrother w adm 21480 16828 0 Apr 06 pts 5 0 00 wflistener w4 root 22764 231780 2 13 46 11 pts 6 0 00 grep wf Windows Ouvrez le Gestionnaire des t ches puis s lectionnez l onglet Processus ua 3 3 3 Windows Task Manager Ele Options View ShutDown Help svchost exe LOCAL SERVICE svchost exe SYSTEM System SYSTEM System Ide Process SYSTEM ES Wig wfardhiv exe SYSTEM wfautomatic exe SYSTEM wfbabel exe SYSTEM wfbigbrother exe SYSTEM wfbrosdcaster exe SYSTEM wfdstaminer exe SYSTEM wflistener exe SYSTEM w scheduler exe SYSTEM wfsvcmgr exe SYSTEM winlogon exe SYSTEM wuauck exe w4 88328 88888888888 Chou ir catts Fos dise Processes 32 CPU Usage 12 Commit Charge 172148K 3152 Fig 3 3 Processus W4 Engine dans le gestionnaire des t ches Vous devez obtenir la liste des proce
132. ne recherche d pend du nombre d entr es dans l annuaire et des filtres utilis s pour r cup rer les acteurs et les r les Le timeout ne s applique pas aux recherches provenant d une mise jour par batch Configuration de la s curit Cette section n est pr sente que pour les versions 6 7 10 0 et ult rieures de la proc dure LDAP MISE JOUR DE LA PROC DURE LDAP W4 ENGINE La proc dure de mise jour de W4 Engine ne g re pas la mise jour de la proc dure LDAP Cette mise jour s effectue manuellement W4 vous recommande de suivre les tapes suivantes Enregistrez ou imprimez la page de configuration pour retrouver facilement vos param tres de configuration lors de la cr ation de la nouvelle configuration m Dans le menu Coordination Dossiers supprimez tous les dossiers bas s sur l ancienne version de la proc dure LDAP m Dans le menu Administration Proc dures supprimez l ancienne version de la proc dure LDAP d faut supprimez la proc dure via la vue serveur de Process Composer m Dans le menu Administration Activit s supprimez les activit s de l ancienne version de la proc dure LDAP d faut supprimez les activit s via la vue serveur de Process Composer m Via Process Composer transf rez la nouvelle proc dure LDAP sur votre serveur W4 Engine e une nouvelle configuration LDAP Dans le champ Protocole de communication Communication protocol s lectionnez LDAP LDAP par
133. nfiguration qui sera pris en compte au prochain red marrage du serveur Exemple configuration d un d lai de suspension de 30 minutes Ins rer la ligne suivante dans le fichier de configuration w4server cfg w adm suspensionDelay minute 30 Le d lai de suspension applicable un acteur est d termin de la fa on suivante d lai attach l acteur s il a t d fini d faut le plus long des d lais attach s aux r les qui lui sont attribu s si l un au moins de ces d lais a t d fini d faut le d lai global D lai de verrouillage Un acteur log qui reste inactif pendant la dur e de ce d lai voit son logement devenir verrouill Toute requ te mise n est alors honor e que si l acteur d verrouille son logement en fournissant nouveau son mot de passe La valeur par d faut de ce d lai est de 1 heure Il peut tre configur gr ce au param tre d instance lockingDelay et modifi dynamiquement par l acteur w4adm au moyen de la commande SetLockingDelay La valeur courante peut tre obtenue par la commande GetLockingDelay IMPORTANT La fonction SetLockingDelay ne modifie le d lai de verrouillage que pour la dur e de la session en cours Elle ne modifie pas le fichier de configuration C est donc le d lai inscrit dans le fichier de configuration qui sera pris en compte au prochain red marrage du serveur Exemple configuration d un d lai de verrouillage de 15 minutes Ins rer la ligne
134. nline imm diat L action S lection pour archivage online imm diat archive directement online les dossiers correspondant aux crit res sans passer par la page de s lection d crite ci dessus Les messages d avertissement et de confirmation s affichent voir ci dessus Effacer L action effacer r initialise les crit res du formulaire leurs valeurs par d faut Archivage online p riodique Objet D finition des param tres d un archivage p riodique vers les tables d archive de la base de donn es W4 Engine Cette fonctionnalit est bas e sur la proc dure d administration Archivage Cette proc dure permet de d finir les crit res d archivage de dossiers W4 Engine et d y associer une p riodicit La t che d archivage des dossiers W4 Engine devient alors automatique W4 Engine Manuel d exploitation 96 97 Il est tout fait possible de cr er plusieurs dossiers d archivage pour d finir une p riode d archivage diff rente selon chaque proc dure par exemple Seuls les dossiers termin s ou annul s peuvent tre archiv s Menu Archivage online P riodique La page Archivage Periodical correspondant la corbeille des t ches du dossier s affiche wdadm w4adm Archival Online Archeye Periodc al offline Administration Coordination Work Items Home page Logout Archival Penodical TASKS TO BE PERFORMED C CS CS a CE Aucune t che traiter 2001 W4 1801 2005 4 165
135. ns t all m m pour le CMD Activation de la trace pour le module msgapi t mmsgapi Activation de la trace pour tous les modules sauf ipcapi t all mipcapi IMPORTANT L ordre des options est important Options t t m m pour le processus CGI Activation de la trace dans le processus CGI pour le module objects w4 trace cgi t mobjects 43 Ajout du module msgapi w4 trace cgi mmsgapi La trace est alors active pour objects et msgapi D sactivation de la trace w4 trace cgi t Ajout du module ipcapi et retrait du module msgapi w4 trace cgi mipcapi mmsgapi Cette commande ne r active pas la trace R activation de la trace w4 trace t La trace est alors active pour les modules objects et ipcapi Options t m pour le processus wfdataminer L exemple ci dessous active les traces sur le module objects du processus wfdataminer Trace du processus wfdataminer Penser red marrer le serveur 3H 4A Data Miner wfdataminer t m objects 4 1 20 Dievi Les options les plus couramment pr conis es par le support technique W4 sont t all mstorage mbuffer mos W4 Engine Manuel d exploitation 118 119 Chapitre 3 Administration 4 1 4 2 Optimisation des performances Ce chapitre d crit les principales possibilit s d optimisation des performances Pr sentation Ce chapitre s adresse la fois aux d veloppeurs W4 aux administrateurs W4 ainsi qu
136. nt case id task getWorkcaseRef wfGetCase getId Dans l exemple ci dessus il est inutile d appeler la m thode wfGetCase La m thode getWorkcasekRef retourne en effet un objet de classe TnFworkcaseRef dont la m thode getIid retourne l identifiant du dossier Exemple 2 substituer par des appels m moire int case id taskRef getWorkcaseRef getId Il faut donc viter les appels W4 Engine dans une boucle Choisir la bonne m thode getObject Vs searchObject Pour le d veloppeur la principale question se poser est quelle fonction doit tre utilis e pour effectuer le traitement d sir Pour r pondre cette question il faut tout d abord qu il value les donn es en sa possession Pour ce faire il existe une m thode simple et efficace consistant d terminer si l on dispose ou non de l identifiant les objets W4 sont toujours au moins identifi s par un num ro unique et ils poss dent tr s souvent galement un nom unique de l objet sur lequel on souhaite r aliser une op ration Dans l affirmative il faut alors se tourner vers l utilisation d une fonction r pondant la forme suivante get lt OBJECT gt int id OU get lt OBJECT gt TWFname name Exemple 3 r cup ration de la t che dont l identifiant est 1200 en Java TWFtaskRef taskRef new TWFtaskRef 1200 taskRef wfGetTask Si tel n est pas le cas l utilisation des fonctions de recherche de W4 Engine est alors privi
137. nu principal de la console W4 ou 5 puis validez par Entr e pour fermer la console WA Il est inutile de red marrer le serveur W4 Engine Processus lanc s par Config lt instanceName gt Pour activer les traces sur les processus lanc s par le fichier de configuration Config lt instanceName vous devez diter ce fichier Rappel sur le format du fichier Config lt instanceName lt i C gt lt serviceName gt lt processName gt lt j gt lt k gt lt l gt o i indique que la ligne concerne un processus service attach au serveur W4 Engine C indique que la ligne concerne un processus client j indique le nombre total de processus lanc s au d marrage du serveur k indique le nombre maximal de processus pr sents simultan ment un instant t 1 indique le nombre total de requ tes acceptables par le processus Les options de traces doivent tre renseign es dans le 3e champ la suite du nom du processus soit par exemple pour la ligne du processus wfdataminer 4 Data Miner wfdataminer lt traceOptions gt 1 1 20 Apr s l dition du fichier red marrez le serveur W4 Engine Options de trace Les options de trace des processus du serveur sont les suivantes Activation de la trace des performances p Cette option permet de mesurer le temps d ex cution des API serveur Apr s avoir red marr W4 Engine et lanc un premier test applicatif on obtient un fichier lt processName gt lt PID gt prf o
138. o are members of a group Un moyen de restreindre l acc s W4 Engine est de sp cifier que les acteurs autoris s doivent appartenir un groupe donn Si cette case cocher est s lectionn e seuls les acteurs appartenant un ou plusieurs des groupes r sultant de la recherche dont les param tres sont d finis plus bas seront autoris s dans W4 Engine Base gauche Left base Ce champ concerne les annuaires structure plane Une valeur possible pour ce champ est cn Attribut Idap qui contient le login de l acteur LDAP attribute containing actor login Dans ce champ de saisie renseignez obligatoirement le nom d un attribut LDAP qui sera utilis comme login dans W4 Engine Chaque valeur doit tre unique Base La base correspond l endroit de l arbre o commencent les recherches Cette base est utilis e dans le traitement batch et la recherche des acteurs Filtre LDAP qui restreint l acc s W4 LDAP filter restricting access to W4 Il est possible que certains acteurs ne soient pas destin s utiliser le workflow W4 Engine Un filtre LDAP peut tre d fini pour restreindre l acc s W4 Engine La valeur du filtre ne doit pas tre incluse entre parenth ses Ainsi le filtre objectclass user est correct alors que le filtre objectclass user ne l est pas Ce filtre peut galement tre utile dans le cas o les acteurs et les groupes sont m lang s Scope Dans cette liste d roulante sp cifiez l
139. on Ajouter Add pour valider La date sp cifi e pour le jour f ri est ajout e au niveau du champ Liste des jours f ri s jj mm aaaa Pour supprimer un jour f ri s lectionnez le bouton Supprimer Delete droite du jour f ri concern Pour prendre en compte la configuration du calendrier s lectionnez Terminer Terminate Au d marrage le serveur scheduler charge en m moire les dossiers workflow sur la proc dure Calendar a 71 Chapitre 2 Configuration Les calendriers sont galement charg s lors de toute modification Si plusieurs dossiers de la proc dure Calendar se rapportent la m me proc dure WA le serveur prend en compte celui dont la priorit est la plus lev e 73 Chapitre 2 Configuration 3 1 3 1 1 Administration Ce chapitre d crit les principales t ches d administration du serveur W4 Engine en mode graphique via l interface d administration et en mode ligne de commande via la console WA Interface d administration Ce chapitre concerne l interface d administration CGI de W4 Engine L interface d administration Java JSP de W4 Engine est d crite dans le Manuel d utilisation de W4 Admin for Java ACC S Acc dez l interface d administration CGI via l alias Web W4Public d fini lors de l installation de WA Engine Saisissez l URL suivant dans la barre d adresse de votre navigateur http lt server gt W4Public o lt server gt repr sente le nom ou l ad
140. orsqu un nombre important de connexions simultan es occupe ces canaux toute tentative de connexion se solde par l erreur 104 c t client le serveur ne voit pas cette tentative Le param trage de cette option permet d viter cette erreur Valeur par d faut 5 Exemple d utilisation du param tre w4adm maxPendingConnections 10 msgSize IPC uniquement taille des messages transmis entre clients locaux et serveur Augmenter la taille vite les fichiers temporaires mais encombre davantage les ressources IPC Valeur par d faut 256 netConnectorHost Machine h te du serveur de connecteurs NET laquelle sont envoy es les notifications sur activation d une tape robot de type Connecteur Valeur par d faut localhost Voir galement le param tre d instance netConnectorPort netConnectorPort Port de la machine h te du serveur de connecteurs NET laquelle sont envoy es les notifications sur activation d une tape robot de type Connecteur Valeur par d faut 7787 Voir galement le param tre d instance netConnectorHost sleepTime Temps d attente en secondes entre 2 tentatives de connexion au d marrage de W4 Engine Valeur par d faut 10 Exemple d utilisation du param tre waadm sleepTime 30 Commentaire vite que W4 Engine tente de se lancer avant que la base de donn es ne soit op rationnelle F d 54 PARAM TRE DESCRIPTION SQLDial
141. ort Dans le cas contraire l erreur Error Server 2102 est retourn e tant que le r le responsable de la proc dure n est pas cr sur le serveur C wdeimport gt wdeimport w4adm W w4adm f ProcessComposerTutorial w4e cp ProcessComposerTutorial ex true ProcessComposerTutorial CREATED PROCEDURE KO Error Server 2102 L erreur Error Server 2003 est retourn e tant que les r les d pendant de la proc dure ne sont pas cr s sur le serveur C wd4eimport gt wdeimport w adm W w4adm f ProcessComposerTutorial w4e cp ProcessComposerTutorial ex true ProcessComposerTutorial CREATED PROCEDURE KO Error Server 2003 L erreur Error Server 2098 est retourn e tant que les activit s d pendant de la proc dure ne sont pas cr es sur le serveur C w4eimport gt w4eimport w adm W w4adm f ProcessComposerTutorial w4e cp ProcessComposerTutorial ex true ProcessComposerTutorial CREATED PROCEDURE KO Error Server 2098 NOTE L erreur Error Server 9051 est retourn e si vous tentez d importer avec l option ex true une proc dure qui existe d j sur le serveur Si l option ex est positionn e false l erreur retourn e est Error Server 2005 car l import s arr te la premi re tentative de cr ation d un r le Si la cr ation de la proc dure a r ussi le message CREATED PROCEDURE OK est retourn C wd4eimport gt wdeimport 1
142. pickup en SMTP Valeur par d faut txt Exemple d utilisation du param tre waadm mailSuffix eml mail toOption F LE 51 PARAM TRE DESCRIPTION UNIX Param tre de configuration de l envoi de courrier Mot cl pour l option destinataires Valeur par d faut aucune valeur positionn e si le param tre mail command est positionn mail t sinon mapiDLL Nom de la biblioth que MAPI Valeur par d faut MAPI32 DLL mapiProfile Profil de messagerie utilis en configuration MAPI Valeur par d faut aucune Exemple d utilisation du param tre w4adm mapiProfile W4Mail mapiPassword Mot de passe n cessaire pour le profil de messagerie param tr Valeur par d faut aucune Exemple d utilisation du param tre w4adm mapiPassword motDePasse maxConnectionNb Nombre maximal de connexions physiques simultan es Le serveur W4 Engine accepte par d faut un maximum de 256 connexions simultan es Lorsque ce nombre est atteint toute nouvelle tentative de connexion se solde par l erreur 413 c t serveur Le param trage de cette option permet d viter cette erreur Valeur par d faut 256 Exemple d utilisation du param tre waadm maxConnectionNb 512 maxPendingConnections PARAM TRE DESCRIPTION Windows seulement nombre de tubes l coute Le serveur W4 Engine ouvre par d faut 5 canaux pour l coute des connexions L
143. pth param tre d instance W4 Engine 43 suspensionDelay param tre d instance W4 Engine 43 suspensionDelay param tre d instance W4 Engine 107 Synchronisation LDAP W4 Engine 16 Table archived_case_ancillary W4 Engine 93 Table archived_case_ comments W4 Engine 93 Table archived_case_variable W4 Engine 93 Table archived_case W4 Engine 93 Table online_archived_case_var W4 Engine 93 Table online_archived_case W4 Engine 93 Table online_archived_task W4 Engine 93 Tables d archive W4 Engine 19 Tablespace W4_ARCH W4 Engine 93 threadChannelMaxSize param tre d instance W4 Engine 43 tmpDir param tre d instance W4 Engine 43 Traces options 114 Traces processus CGI 113 Traces processus CMD 113 Traces processus lanc s par configuration 114 Traces W4 Engine 18 19 82 113 tryNb param tre d instance W4 Engine 44 Tubes nomm s 127 Upper role d sactiver 129 Upper Role propri t des r les 145 useDynRoles param tre d instance W4 Engine 44 useDynRoles param tre d instance W4 Engine 129 useMailTemplate param tre d instance W4 Engine 44 useODBCResultSets param tre d instance W4 Engine 44 UTF 8 mise en oeuvre de W4 Engine en UTF 8 154 Utilitaire Audit W4 Engine 19 Utilitaire w eimport 18 Utilitaire w4eimport W4 Engine 140 Utilitaire wfaudit W4 Engine 111 Utilitaire wfwatchsrv W4 Engine 19 111 112 W4 Engine Manuel d exploitation 168 169 Index Variable d environnement NLS_LANG 155 W4 Admi
144. que lors de la mod lisation trois variables pour l activit A1 aient t nomm es comme suit NomDuDemandeur AgeDuDemandeur et emploi Si le code suivant est utilis le moteur ne conservera aucune valeur car il ne pourra pas faire la correspondance avec ces variables TWFtaskRef taskRef new TWFtaskRef 1200 TWFTrawVariable variables new TWEFTrawVariable variables addRaw nomdudemandeur Ernest Clarck variables addRaw ageDuDemandeur 35 variables addRaw Emploi d veloppeur Java exp riment taskRef wfEndTask null variables 4 3 2 3 Exemple 9 casse des noms des objets La sensibilit de la casse entre galement en jeu par exemple lors de la recherche de dossiers Supposons que l on souhaite r cup rer la liste des dossiers concernant la proc dure testProc Si le code suivant est utilis le moteur ne retournera aucun dossier puisqu il fait une diff rence entre testProc et Testproc TWFTworkcaseSelection tSelection new TWFTworkcaseSelection tSelection addSelection TWFworkcaseCriEt WF CRIT PROCEDURE TWFoperator WF EQUAL TestProc TWFTworkcase tcase TWFTworkcase wfSearchCase tSelection TWFworkcaseSortBy WF NOSORT TWFsortMode WF NOSORT short 0 Le mode case sensitive concerne donc le nommage des objets techniques workflow Son utilisation concerne donc essentiellement le d veloppeur et l administrateur W4 Engine Il ne touche absolument en rien a
145. r sente le nom ou l adresse IP du serveur Web Une fois connect sur la page des services W4 dans la section Services s lectionnez Ecrans d accueil Welcome Screens Cr ez un nouvel cran d accueil poss dant les caract ristiques suivantes new welcome screen j Create or modify welcome screen English Title LDAP Configuration French Title Configuration LDAP Spanish Title e German Title Fe 5 italian Title Type Protle _ H List of roles EE author F automatic chessPleyer v Select procedure LDAP i Template no extension es i Presentation order 1 99 highest are first presented go Icon dep z Terminate On hold Add comment view Comments Fig 2 1 Installation de la proc dure LDAP L acc s l application LDAP est d sormais possible partir de la page des services WA 222 ACC S la corbeille de la proc dure LDAP Sur la page des services W4 s lectionnez l ic ne LDAP La corbeille de t ches de l application LDAP s affiche FF 47 Chapitre 2 Configuration s3 2 2 3 T Pinto PeP You ses connected ar 6 sdn Fig 2 2 Acc s la corbeille de la proc dure LDAP Pour cr er un dossier sur la proc dure LDAP s lectionnez Nouvelle instance New Instance dans la partie sup rieure droite de la page La page de configuration Idap create s affiche Cette page est d crite en d tail dans le chapitre suivant 2 2 5 Configuration page 51 R pl
146. rName new TWFTname tTaskVarName add new TWFname maString tTaskVarName add new TWFname maString2 tTaskVarName add new TWFname maString3 lancement de la recherche TWET ullTask tFullTask TWEFTfullTask wfSearchFullTask tSort fields tTaskVarName null null tSel short 0 CI r 4252 Lancement d une t che Lors du lancement d une t che l objectif est de signaler au moteur W4 Engine que la t che change d tat puis g n ralement d afficher un formulaire de saisie Dans ce formulaire les champs peuvent tre remplis partir des donn es que l utilisateur aura ventuellement pr c demment entr es lors de la suspension d une t che les donn es sont conserv es dans la base technique de W4 Le formulaire peut galement pr senter des donn es propres au dossier L exemple de code ci dessous montre comment r aliser ces op rations Exemple 6 code de lancement d une t che non optimis TWFtaskRef taskRef new TWFtaskRef 1200 taskRef wfProcessTask R cup ration des variables de dossier TWFTrawVariable taskVariables taskRef wfGetTaskVariables true R cup ration du dossier TWFworkcase case taskRef wfGetTask getWorkcaseRef wfGetCase TWFTrawVariable caseVariables case wfGetCaseVariables true Ce code est parfaitement fonctionnel mais il n est absolument pas optimis puisqu il comporte cinq appels au moteur W4 Eng
147. raitement d une requ te Ils sont supprim s apr s la fin du traitement de la requ te Les fichiers contextes de retour ont une dur e d utilisation gale la dur e d une session utilisateur entre le login et le logout Si l utilisateur ne se d loge pas le contexte de session est pr serv jusqu 24 heures et plus Pour plus de d tails veuillez vous reporter au chapitre suivant 3 8 2 Connexion des utilisateurs page 104 IMPORTANT Ces fichiers ne sont supprim s qu l arr t du serveur Fichiers journaux Objet Les journaux standard suffix s en log enregistrent tous les incidents survenus du c t serveur s curit manque de m moire appels de fonction comportant des param tres incorrects etc Chaque processus cr e son fichier quand n cessaire Les fichiers log ne contiennent que des lignes de niveau de rapport 1 4 Les niveaux d erreur sont les suivants 5 trace conditionnelle activ e explicitement 4 s curit Exemple mot de passe incorrect 3 support de niveau 3 Demande une modification du binaire Exemples d tection d un tat incoh rent fonction interne appel e avec de mauvais arguments 2 support de niveau 2 R soluble par l utilisateur Exemples appel incorrect d une API saturation Oracle 1 support niveau 1 R soluble ou compr hensible par l administrateur syst me Exemples plus de m moire licence temporaire expir e 0 suite d erreurs d j identifi
148. re tmp W4 Engine 131 Restauration d archive W4 Engine 102 Restauration d archives W4 Engine 93 R le automatic 110 R le declared W4 Engine 109 110 R le declared W4 Engine declared r le W4 Engine 109 R le responsable d sactiver 129 R le w4adm 110 R le supprimer W4 Engine 77 RPC 127 running connected console w4 80 running disconnected console w4 80 Sauvegarde de la base de donn es W4 Engine 19 Sauvegardes W4 Engine 91 Scheduler service W4 Engine 12 S lection avant archivage W4 Engine 95 S lection pour archivage online imm diat W4 Engine 96 S quenceur W4 Engine 12 Server state console w4 80 Service d administration W4 Engine 12 Service d archivage W4 Engine 13 Service d ordonnancement W4 Engine 12 Service de client distant W4 Engine 13 Service de recherche W4 Engine 13 Service de traduction W4 Engine 13 Service Manager service de W4 Engine 15 Services en surcharge W4 Engine 130 Services W4 74 Session active W4 Engine 105 Session expir e W4 Engine 105 Session suspendue W4 Engine 105 Sessions W4 Engine 19 SetActorSuspDelay W4 Engine 106 SetExpirationDelay W4 Engine 106 SetLockingDelay W4 Engine 107 SetRoleSuspDelay W4 Engine 107 SetSuspensionDelay W4 Engine 107 Signal SIGTERM 85 sleepTime param tre d instance W4 Engine 41 SMTP 17 SQLDialect param tre d instance W4 Engine 42 start console w4 82 Statistiques optimisation de la base Oracle 132 substituteMaxDe
149. resse IP du serveur Web La page de connexion l interface d administration s affiche Saisissez votre identifiant et votre mot de passe puis s lectionnez Commencer Start La page des services W4 s affiche r M n Administrator Server Administration Profile PT Welcome Screens Calendars LDAP configuration Calendar Services dd X Classic Tutorial Procurement Miscellaneous Chess Game Logout Fig 3 1 Interface d administration CGI 1 2 Le bandeau de cette page indique Services W4 lt instanceName gt Les ic nes des sections Profils Profiles accessible des r les particuliers Services accessible tous et Loisirs accessible tous donnent acc s aux corbeilles de t ches des proc dures d administration livr es avec W4 Engine La section Services comporte galement l ic ne Classique donnant acc s aux commandes d administration et de coordination pour les acteurs ne poss dant pas le r le Administrator Dans la section Administration uniquement accessible l utilisateur w4adm s lectionnez Administration du serveur Server Administration pour acc der aux commandes d administration Par d faut la page d administration des acteurs s affiche FF 75 Chapitre 3 Administration ta AA S m LA w r login present mildcards char and 7 can be used Jabsent serect w4adm check one box st most w4adm role Ono role w Select for role assignment Administr
150. ribute s lectionnez l attribut W4 Engine correspondant 3 CE 4a Lon san 7 You ses connected s v sdm A LDAP attribute W4 attnbute Acton substitute substituts Remove email smail descnption desoipion telephonenumber p oneNumber givenNeme rstNome en lastName presenca nding in a LDAP regi LDAP attribute W4 attribute Base LDAP fiter Scope Action hast sarver ouvAgplicetans a W4 nomeswW4 LDAP_SCOPE_SUBTA presence Fig 2 8 LDAP Acteurs 2 3 FF ds 5 Chapitre 2 Configuration EE 2 2 5 3 4 2 2 5 3 5 S lectionnez le bouton Ajouter Add pour valider La ligne renseign e passe en mode visualisation S lectionnez le bouton Supprimer Delete l extr mit droite de la ligne pour supprimer la correspondance Une fois l acteur retrouv dans LDAP la valeur de ses attributs permet de mettre jour les attributs W4 Engine correspondants Les champs manager et substitute doivent contenir des DN Si les acteurs correspondants n existent pas encore dans W4 Engine ils seront cr s de mani re r cursive sans mot de passe I n est pas possible de donner une correspondance pour les attributs hourlyBillingRate et suspensionDelay Attributs W4 d pendant d une requ te LDAP W4 attributes depending in an LDAP request Si une entr e d un annuaire LDAP poss de un attribut pouvant servir d attribut commun pour tous les acteurs W4 Engine il faut d finir s dans le champ A
151. rmulaire leurs valeurs par d faut NOTE Les dossiers archiv s online avant leur archivage offline sont restaur s vers les tables d archivage online 375 Recherche d un dossier archiv Pour rechercher des dossiers archiv s online dans l cran de s lection des dossiers sous la coordination de l interface classique s lectionnez le crit re rechercher dans l archive Re v 4 1 DE o i vwtadm roset unsat M Lure waans unset Coordination at H Task Case unset Event unsat B 5 Administration Archival unset v B 01 january 2005 Work Items Home page unset sS Logout D value a v maximum count 10 sorted by unset i sort order ascendng Fig 3 13 Recherche d un dossier archiv Par les API W4 SearchCase et SearchFullCase ce crit re est accessible via le bool en WF_CRIT_ARCHIVE 383 Gestion des utilisateurs La gestion des utilisateurs concerne le mode d authentification externe ou interne ainsi que la gestion des connexions des sessions et des d lais FF 103 Chapitre 3 Administration u3 3 8 1 3 8 2 Modes d authentification des utilisateurs L authentification des utilisateurs peut tre externe ou interne au serveur W4 Engine Authentification externe L authentification externe est r alis e par le serveur Web ou le serveur d application authentification HTTP sous UNIX et Windows ou authentification Microsoft sous Windows L iden
152. rs que l une des instances affiche un nombre nul de Tot Rq process Gestion du r pertoire tmp sous UNIX W4 Engine utilise des fichiers temporaires pour la communication entre le client et le serveur Ces fichiers sont cr s sous le r pertoire tmp ou var tmp Il s av re que ce r pertoire temporaire a en g n ral sur les syst mes Unix le sticky bit positionn ce qui emp che un utilisateur de supprimer les fichiers cr s par un autre Dans les applications W4 le client cr e le fichier temporaire qui est ensuite supprim apr s lecture par W4 Engine Si l utilisateur qui lance le serveur d applications ou le serveur web n est pas le m me que celui qui lance W4 Engine alors les fichiers cr s par l un ne peuvent pas tre supprim s par l autre L implication en termes de performance est la suivante chaque appel client un fichier temporaire de nom UNIQUE est cr Ce nom est g n r en fonction des noms des fichiers d j existants dans le r pertoire Donc plus il y a de fichiers plus le temps de cr ation du nom unique est important Trois solutions sont possibles d marrer W4 Engine et le serveur d applications ou serveur web avec le m me utilisateur a configurer le r pertoire temporaire tmp ou var tmp sans le sticky bit cette solution est en g n ral rejet e par les administrateurs syst me s configurer dans W4 Engine un autre r pertoire temporaire avec les droits lecture criture pour tou
153. s Dans le fichier waEngine Home sys w4server cfg il faut ajouter la ligne suivante lt instanceName gt tmpDir lt chemin complet du r pertoire temporaire gt Une relance de W4 Engine est n cessaire pour la prise en compte de cette option Ma trise du mode d assignation Acteur avec la charge de travail la plus faible Ce mode d assignation fonctionne soit sur une variable contenant des noms d acteurs soit sur un r le 44 44 1 Un calcul de la charge de travail de chaque acteur est effectu Ce calcul se fait en additionnant la dur e de chaque t che active affect e l acteur la dur e tant celle d finie au niveau de l activit associ e la t che Si le r le ne contient qu un seul acteur pr f rez alors le mode d assignation distribution ce qui vitera d ex cuter la requ te de calcul de la charge qui peut tre co teuse En revanche si la variable ne contient qu un seul nom d acteur aucune requ te de calcul de charge ne sera lanc e et la t che sera affect e directement cet acteur Optimisation BD Cette section pr sente plusieurs l ments d optimisation pour Oracle MS SQL server et IBM DB2 Oracle Activation des statistiques Les statistiques BD permettent de profiter de la r gularit des requ tes mises gr ce la mise en m moire tampon de celles ci Dans Oracle on active les statistiques par la commande SQL gt execute sys dbms utility analyze schema W4 COMPUTE ou
154. s ph m re lanc et utilis par wfscheduler L envoi d un courrier pouvant tre bloquant cette op ration est g r e par ce processus sp cialis qui s il est bloqu n affecte pas les autres processus Configuration de W4 Engine Pour profiter de toutes les fonctionnalit s du serveur une tape de configuration doit succ der l tape d installation d crite dans le Manuel d installation de W4 Engine La configuration s effectue selon le cas via des fichiers de configuration ou encore via des proc dures sp cialis es livr es en standard avec W4 Engine 1 11 122 Fichiers de configuration W4 Engine utilise deux fichiers de configuration Config lt instanceName gt et w4server cfg situ s dans le r pertoire lt softwareHome gt sys Fichier de configuration Config lt instanceName gt Lors du d marrage le serveur W4 Engine utilise le fichier de configuration Config lt instanceName gt pour conna tre le nombre d instances lancer pour chaque processus La configuration de ce fichier est d crite dans le chapitre suivant 2 1 1 Fichier de configuration Config lt instanceName gt page 20 Fichier de configuration w4server cfg Le fichier de configuration w4server cfg g re une cinquantaine de param tres d instance La configuration de ce fichier est d crite dans le chapitre suivant 2 1 2 Fichier de configuration w4server cfg page 23 Configuration de l annuaire LDAP La proc dure d admini
155. s avez sp cifi la modalit d import en param tre de la commande w4eimport sont pris en compte o Par d faut l option ex est positionn e false ce qui implique que tous les objets du fichier w4e sont cr s implicitement L option t si vous souhaitez activer les traces utiliser sur demande et en rapport avec le support W4 NOTE a l est possible d utiliser plusieurs options d import explicite dans la m me commande w4eimport pour cr er simultan ment par exemple un r le et une activit m n est pas n cessaire de laisser une espace entre le nom de l option et son argument Se m Les options peuvent tre sp cifi es dans un ordre quelconque IMPORTANT w4eimport traite les objets par classe dans l ordre suivant r les activit s et proc dures Ensuite pour chaque classe w4eimport traite les objets dans leur ordre de pr sence dans le fichier w4e en leur appliquant la modalit d import d finie w4eimport ignore donc l ordre dans lequel les objets sont sp cifi s dans les param tres de la commande qu ils apparaissent dans une liste en argument d une option d import explicite ou qu ils apparaissent s par ment dans une suite d options identiques d import explicite tant donn que l ordre d apparition des objets dans le fichier w4e n est pas contr lable cela pose probl me s il existe des d pendances entre objets de m me classe Les deux cas de d pendance intra classe sont a entre une proc
156. s de la manipulation des API SearchCase et SearchFullCase Archivage online p riodique La proc dure d administration Archivage permet de planifier et d ex cuter en backoffice l archivage selon des crit res de s lection des dossiers et de p riodicit Archivage offline Toutes les informations relatives au dossier dossier t ches variables commentaires sont stock es dans un fichier au format W4 d extension ARCH dans le r pertoire lt softwareHome gt archive Seules quelques informations sont conserv es dans la base de donn es tables archived_case archived_case_variable afin de pouvoir conna tre les dossiers archiv s et effectuer ventuellement une restauration Restauration d archives Les dossiers archiv s offline peuvent tre restaur s dans la base W4 NOTE Quelque soitle mode d archivage les documents associ s aux dossiers ne sont pas d plac s Archivage online Objet Archivage ponctuel des dossiers vers les tables d archive de la base de donn es W4 Engine Seuls les dossiers termin s ou annul s peuvent tre archiv s Menu Archivage online Archiver La page Archivage online s affiche r hw wtadm w acm Archival Online rc eve Pernocal Offine Administration Coordination Work Items Home page Logout selection before archival nm Selection for direct online archival V reset siate gt M done unset v 5 unset v 5 unset b 5
157. s des r les dans LDAP et noms des r les dans W4 LDAP and W4 roles name mapping Les noms des r les dans LDAP peuvent tre diff rents des noms que l on veut donner aux r les dans W4 Engine il est possible de sp cifier que tel nom de r le dans LDAP correspond tels noms de r les dans W4 Engine Dans le champ Valeur dans LDAP LDAP value saisissez le nom du r le dans LDAP par exemple responsable r seau Dans le champ Valeur dans W4 W4 value saisissez les noms des r les correspondants dans W4 Engine par exemple administrator author W4 Engine Manuel d exploitation 64 65 r M You sa connected s v sdm LDAP attribute containing the group s name on LDAP attribute containing members member Base o People o W4 LDAP filter obecdass goup Scope LOAF_SCOPE_SUBTREE gt BP Co Update tima Me 25 o Update pariod 1 Days 0 Kauris o Mnute s Automatic update za Fig 2 12 LDAP R les et groupes 3 3 IMPORTANT Lesnoms des r les dans W4 Engine doivent tres s par s par un point virgule sans espace avant et apr s Ainsi dans notre exemple si un acteur poss de dans LDAP le r le responsable r seau lui seront affect s dans W4 Engine les r les administrator et author 22 5 47 R les LDAP ne devant pas tre d sassign s Roles that mustn t be unassigned Certains r les notamment les r les W4 Engine tels que author administrator etc n existeront probablement pas dans LDA
158. s modernes assurer que m me lorsqu une exception survient une portion de code est toujours ex cut e Exemple 4 ouverture et fermeture de la connexion physique dans une m me m thode TWFsession w4Session new TWFnativeSession null w4adm try w Session openConnection TWFtaskRef taskRef new TWFtaskRef 1200 taskRef wfGetTask catch TWFexception e e printStackTrace catch Throwable t finally if w4Session null amp amp w4Session getSessionHandle gt 0 tEY P taae 4 2 5 4 2 5 1 w4Session closeConnection catch Throwable t Exemple 5 ouverture et fermeture de la connexion physique dans deux m thodes s par es TWFtaskRef taskRef new TWFtaskRef 1200 taskRef wfGetTask Exemples d optimisation Cette section pr sente des exemples d optimisation s dela corbeille des t ches s du lancement des t ches Corbeilles des t ches La corbeille de t che est l l ment essentiel d une application workflow C est aussi la page qui prend le plus de temps s ex cuter On pr f rera l API SearchFrul1Task l API de SearchTask si l on souhaite afficher des informations sur des variables L exemple ci dessous ex cute une recherche sur toutes les t ches en ramenant 3 variables de t ches ainsi que les informations sur les acteurs le dossier et la t che Les APIs SearchFul1 permettent de retourner les objet
159. s recherch s r pondant aux crit res sp cifi s ainsi que des informations relatives ces objets Exemple l API SearchFullCase permet de retrouver des dossiers et de retourner galement l historique de toutes ses t ches IMPORTANT Cette richesse pouss e l extr me retourner toutes les t ches toutes les variables tous les m triques li s une liste de dossiers peut entra ner des requ tes SQL complexes et donc des performances en baisse TWFsession nSes null ouverture d une connexion vers le serveur W4 en s appuyant sur le contexte workflow nSes TWrsessionFactory createSession context nSes openConnection cr ation des crit res de recherche des t ches tWFTtaskSelection tSel new TWFTtaskSelection qui ne sont pas termin es tSel addSelection TWFtaskCrit WF CRIT STATE TWFoperator WF LT n ew Integer 7 restriction de la recherche aux t ches de l acteur courant tSel addSelection TWFtaskCrit WF CRIT ACTOR POOL TWFoperator WF _EQUAL new TWFid context getActorId qui concerne la proc dure testProc tSel addSelection TWFtaskCrit WF CRIT PROCEDURE TWFoperator WF_ EQUAL testProc champs de fullTask r cup rer TWFT ullTaskFieldName fields new TWFTfullTaskFieldName fields add TWFfullTaskFieldName TASK fields add TWFfullTaskFieldName WORKCAS variable de t che r cup rer TWFTname tTaskVarName null tTaskVa
160. s relatives aux licences ainsi que d enregistrer les cl s de licence W4 Engine Visualisation des informations relatives aux licences Commande w4 i lt instanceName gt license OUw4 i lt instanceName gt license show puis validez par Entr e Equivalent menu 8 puis validez par Entr e Le sous menu Server License s affiche W4 Engine 04 01 00 Server Licens Software wdServer Major Release Number 4 ra 3 4 2 Machine identifier roussette Instance name w4adm Primary key XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 6 License key YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY Declared actors 50 Concurrent logins 50 Expiration date none 10 Main menu Dans l illustration ci dessus la valeur de la cl primaire entr e Primary key est repr sent e par une suite de caract res X la valeur de la cl de licence d finitive entr e License key est repr sent e par une suite de caract res Y L entr e Primary key indique la cl primaire obtenue l installation du serveur Cette cl contient l identification de la machine h te et le nom de l instance instanceName utilis s l installation par d faut w4adm Pour des raisons d int grit elle est cod e sous la forme de chiffres et de lettres repr sentant une valeur hexad cimale ainsi les erreurs de transmission sont imm diatement rep r es L entr e License key indique la cl de licence d finitive obtenue du support technique WA d
161. serveur dans la limite de la capacit de la licence Si le nombre d acteurs d clar s est sup rieur cette limite le choix des acteurs auxquels on attribue une entr e est al atoire Le serveur met alors un avertissement via son journal d erreurs dans lequel il cite les acteurs n ayant pas re u d entr e Ces acteurs sont alors consid r s comme occasionnels Si la limite de capacit n est pas atteinte au d marrage du serveur les entr es libres restent disponibles pour les acteurs qui seront d clar s au cours de la session du serveur W4 Engine un acteur nouvellement d clar se voit attribuer une entr e et se voit ainsi garantir l acc s au serveur pour ses connexions ult rieures Lorsqu en d clarant un nouvel acteur la limite de la capacit de la licence est d pass e un avertissement est mis via le journal d erreur pour signaler ce d passement l inverse il est impossible de lib rer une entr e attribu e un acteur d clar m me en lui retirant son r le declared Si une telle modification survient elle ne prendra effet qu au d marrage de la prochaine session du serveur IMPORTANT Surun serveur muni d une licence pour acteurs d clar s exclusivement il est imp ratif d attribuer le r le declared un acteur apr s l avoir cr si l on veut lui permettre de se loger sur le serveur Dans le cas contraire l acc s au serveur lui sera syst matiquement interdit puisque la partie flottante de la lic
162. service IMPORTANT Ne modifiez jamais ce champ serviceName Nom du service Ce nom appara t en sortie de certaines commandes d administration Il peut tre francis processName 1 13 CHAMP DESCRIPTION Nom du processus Commande de d marrage du processus Des param tres peuvent tre ajout s dans ce champ pour mettre un service sp cifique en mode trace Pour plus de d tails sur les traces reportez vous au chapitre suivant 3 9 2 lraces pade 113 Nombre maximal d instances du processus Une fois le serveur W4 Engine lanc de nouvelles instances d un processus de service peuvent tre cr es sans arr ter le serveur cependant ce nombre ne pourra jamais d passer le maximum indiqu ici Nombre initial d instances de processus du service lanc es au d marrage du serveur Nombre maximal de requ tes en attente Une instance de service traitant de fa on s quentielle les requ tes qui lui sont soumises les nouvelles requ tes sont mises en attente Lorsque leur nombre atteint la limite indiqu e ici toute requ te suppl mentaire en provenance d un client est rejet e L erreur 441 est alors lev e Une ligne concernant un processus client poss de le format suivant lt C gt lt serviceName gt lt processName gt lt i gt o C indique que la ligne concerne un processus client i est un bool en indiquant l tat lanc 1 ou non l
163. services W4 s lectionnez l ic ne Calendrier Calendar La corbeille de t ches de l application Calendar Calendar s affiche Pour cr er un dossier sur la proc dure Calendar s lectionnez D finir un nouveau calendrier New calendar La page D finir un nouveau calendrier New calendar s affiche W4 Engine Manuel d exploitation 70 Start time men Eng time Pin min 1 1 2005 Remowe 5 h2 205 Remove holday dd VYYV 1 S01 S 2005 Ada Onhold Terminate Fig 2 14 Acc s la corbeille de la proc dure Calendar 233 Configuration d un calendrier Dans le champ Nom du calendrier Calendar s lectionnez la proc dure laquelle doit tre associ le calendrier d faut s lectionnez l l ment g n rique standard pour indiquer que le calendrier sera associ toutes les proc dures pour lesquelles aucun calendrier n a t explicitement associ Dans les champs de saisie situ s aux intersections des lignes Plage de travail du dimanche Sunday slot Plage de travail du samedi Saturday slot et des colonnes Heure de d but hh mm Start time hh mm et Heure de fin hh mm End time hh mm saisissez les heures de d but et de fin pour les jours travaill s de la semaine Dans les listes d roulantes Ajouter un jour f ri jj mm aaaa Add a holiday dd mm yyyy s lectionnez le jour le mois et l ann e de chaque jour f ri sp cifier S lectionnez le bout
164. ssus d clar s dans le fichier de configuration Config lt instanceName dont les noms commencent par wf Arr t du serveur Commande w4 stop puis validez par Entr e Equivalent menu 6 puis validez par Entr e Si l arr t se passe sans erreur le message suivant s affiche Server stopped Please check log files that may appear in the log directory var adm w4 log Ex cuter la commande d arr t sur un serveur d j arr t donne le message suivant w4 error detected cannot stop Error log follows 1998 04 15 14 24 35 1 WFStop the workflow server is not running 1998 04 15 14 24 35 0 error 1 main wfsysadm c 1881 1756 file var adm w4 log w423972 1log W4 Engine Manuel d exploitation 84 3 4 3 4 1 Hit lt Return gt to exit NOTE L arr t des processus wfbigbrother et wfautomatic prend un certain temps Lorsque le serveur W4 Engine s arr te le processus Broadcaster pr vient les modules serveur mais non les modules client Ceux ci ne se rendent compte de l arr t du serveur qu leur requ te suivante il logent alors une erreur 105 ou 106 puis s arr tent Arr t du serveur UNIX Commande w4 term puis validez par Entr e Equivalent menu Aucun Sous UNIX cette commande arr te rapidement le serveur W4 Engine de fa on propre en envoyant un signal SIGTERM 15 au processus wfbroadcaster Gestion des licences Le programme w4 permet de visualiser les information
165. st true Si ce param tre de configuration n est pas pr sent ou s il a une valeur diff rente de true les fichiers d archive sont nomm s lt caseName gt lt procedureName gt lt caseEndDate day gt lt caseEndDate month gt lt caseEndDate year gt ARCH Valeur par d faut FALSE Exemple d utilisation du param tre wa4adm archFileName useCaseld true Commentaire les dossiers dont les noms contiennent des barres obliques peuvent donc tre archiv s offline PARAM TRE DESCRIPTION attachJVM Utilise une JVM ind pendante du moteur si la valeur est TRUE Dans le cas contraire une JVM est cr e au d marrage du serveur W4 Engine Valeur par d faut FALSE auditLogin Activation de l audit des actions de login et logout Valeur par d faut FALSE Exemple d utilisation du param tre w4adm auditLogin TRUE auditLoginFileName na 25 Chapitre 2 Configuration PARAM TRE DESCRIPTION D finition du nom du fichier cr sous le r pertoire de log de W4 Engine contenant la trace des actions de login et de logout Valeur par d faut connectionReport csv Exemple d utilisation du param tre w4adm auditLoginFileName auditW4 csv Les informations suivantes y sont mentionn es a date et heure de l action a action r alis e login ou logout a nom et identifiant de l acteur a type de jeton de licence utilis fixe ou flottant a nombre de jetons utilis s par
166. stration LDAP livr e avec les serveurs W4 Engine de d veloppement et de production est utilis e pour configurer l interface entre les annuaires LDAP et W4 Engine pour authentifier les acteurs contre LDAP r cup rer les attributs des acteurs r cup rer les r les des acteurs La synchronisation LDAP W4 Engine est modulaire authentification s et ou attributs et ou r les De m me elle peut concerner tout ou partie des r les La synchronisation peut tre r alis e en bloc et ou la connexion d un acteur et ou sur demande de l administrateur et ou chaque r f rence un acteur inconnu dans l ordonnancement des t ches La configuration LDAP est d crite dans le chapitre suivant 2 2 Configuration de l annuaire LDAP page 46 1 2 3 1 2 4 Configuration des calendriers La proc dure d administration Calendar livr e avec les serveurs W4 Engine de d veloppement et de production est utilis e pour configurer des calendriers d finissant les plages de travail hebdomadaires et les jours f ri s sur lesquels W4 Engine se fonde pour calculer les dates d alarme et de d passement La configuration des calendriers est d crite dans le chapitre suivant 2 3 Configuration des calendriers page 68 Notification par courrier lectronique W4 Engine s appuie sur les interfaces de messageries MAPI mailx et SMTP pour notifier aux utilisateurs du workflow l existence de nouvell
167. taire vite que W4 Engine tente de se lancer avant que la base de donn es ne soit op rationnelle useDynRoles S il n existe pas d assignation en libre service sur une variable multivalu e contenant des noms d acteurs cette option doit tre d sactiv e pour viter des jointures suppl mentaires sur la table role_hierarchy du sch ma W4 lors des recherches sur un crit re de r les corbeille Valeur par d faut TRUE Exemple d utilisation du param tre w adm useDynRoles false useODBCResultSets Lorsque ce param tre est positionn sur true il permet d viter l utilisation des curseurs Transact SQL Ce param tre fonctionne sur SQL Server 2005 uniquement Valeur par d faut FALSE Exemple d utilisation du param tre waadm useODBCResultSets true useMailTemplate PARAM TRE DESCRIPTION Avertit le syst me que les contenus des messages doivent tre constitu s partir de templates de mail situ s sous lt softwareHome gt Templates Mail et non partir de la description de l tape associ e la t che Valeur par d faut FALSE Exemple d utilisation du param tre w4adm useMailTemplate true webProtocol Fixe le protocole utilis en technologie CGI lors de l enregistrement des documents et donc des URL d acc s Valeur par d faut https si variable d environnement HTTPS ON sinon http Exemple d utilisation du param tre w adm webProtocol https
168. tes mapping Attributs W4 d pendant d une requ te LDAP W4 attributes depending in an LDAP request Correspondance entre valeur dans LDAP et valeur dans W4 LDAP and W4 values mapping Acteurs n existant que dans W4 Actors existing in W4 only Cr ation et assignation des r les Creation and role assignation Cr er les acteurs la vol e Create actors on the fly S lectionnez cette case cocher pour cr er les acteurs dans W4 Engine la vol e Un acteur qui tente de se connecter pour la premi re fois W4 Engine sera ainsi cr dans W4 Engine s il est authentifi Un acteur auquel une t che est assign e explicitement sera galement cr Mettre jour l assignation des r les Update role assignation S lectionnez cette case cocher pour mettre jour l assignation des r les des acteurs lors de chacune de leurs connexions W4 Engine La case cocher Mettre jour les attributs chaque login voir ci dessous doit alors tre galement s lectionn e LA Chapitre 2 Configuration es 2 2 5 3 2 Mise jour des attributs de l acteur chaque login Update actor s attributes at each login S lectionnez cette case cocher pour mettre jour dans la base W4 les attributs des acteurs lors de chacune de leurs connexions W4 Engine Comment retrouver les acteurs dans LDAP How to retrieve actors in LDAP N autoriser que les acteurs qui sont membres d un groupe Accept only actors wh
169. tifiant fourni par l utilisateur au serveur Web ou au serveur d application est transmis de fa on transparente pour l utilisateur au serveur W4 Engine via son mode d authentification SSO En CGI vous devez configurer IIS cliquez droit sur l alias W4 et dans le menu contextuel s lectionnez Propri t s S lectionnez l onglet S curit du r pertoire puis dans la section Connexions anonymes et contr le d identification s lectionnez le bouton Modifier Dans la fen tre M thode d authentification d s lectionnez la case cocher Connexion anonyme puis s lectionnez la case cocher Authentification int gr e Windows Cela a pour effet de positionner la variable HTTP REMOTE_USER Authentification interne En l absence d authentification externe l authentification est faite automatiquement par le serveur WA Engine NOTE Sous Windows l authentification HTTP est dite de base Connexion des utilisateurs La commande login connecte un utilisateur au serveur W4 Engine Cette commande poss de 3 param tres 1 identifiant de l acteur 2 mot de passe 3 for age Si l authentification est externe aucun param tre n est n cessaire La commande de login se contente de v rifier que l identifiant de l utilisateur fourni en externe transmis de fa on transparente au workflow correspond bien un identifiant d acteur d clar Le mot de passe ventuellement d clar dans le workflow est alors redondant et s il est fourn
170. ts passerelles Lorsque le serveur Web et le serveur W4 Engine sont install s sur deux machines distinctes le programme passerelle machine du serveur Web utilise le serveur W4 Engine distant via un appel RMI ou RPC plus classique Il se connecte via un concierge pr sent sur la machine du serveur W4 Engine qui coute sur un port d termin par d faut 2511 Ce filament est charg de transmettre les informations de la passerelle vers le Broadcaster et inversement Big Brother Nom du service Big Brother Nom du processus associ wfbigbrother exe galement d sign module de surveillance Envoie p riodiquement des requ tes au service de recherche pour conna tre les dates d alarme et de d passement expir es ainsi que les v nements survenus Dans le cas d un d passement il demande au service d ordonnancement de prendre les mesures n cessaires pour le traiter Dans le cas d un v nement survenu il demande ce m me service de r veiller les t ches ou dossiers en attente de cet v nement Par d faut le module de surveillance scrute toutes les 60 secondes Pour modifier cette valeur par d faut ditez la ligne suivante dans le fichier Config lt instanceName gt C Big Brother wfbigbrother 1 Par exemple pour scruter toutes les heures C Big Brother wfbigbrother 3600 1 Ce fichier de configuration est d crit dans le chapitre suivant 2 1 1 Fichier de configuration Config lt instan
171. ttribut LDAP le nom de l attribut dans LDAP s dans le champ Attribut W4 le nom de l attribut dans W4 la requ te LDAP permettant de retrouver cette entr e savoir o le champ Base le champ Filtre LDAP LDAP filter o le champ Scope Correspondance entre valeur dans LDAP et valeur dans W4 LDAP and W4 values mapping Certains attributs dans LDAP peuvent avoir une valeur qui ne peut pas tre utilis e directement dans WA Engine 6l 2 2 5 3 6 nn fau are connected az w4 adm W4 attribute LOAP value W4 value Action cour 5 France longuoge 3 presence hd ctors name lorsch f Fig 2 9 LDAP Acteurs 3 3 Par exemple si l attribut countryCode dans LDAP vaut 33 cet attribut peut servir renseigner le champ country de W4 Engine en rempla ant la valeur 33 par la valeur France pour cet attribut W4 Engine Si on ne donne pas de correspondance entre valeur dans LDAP et valeur dans W4 Engine la valeur dans LDAP est utilis e Les correspondances ne sont pas utilis es pour le champ manager le champ substitute ni pour la valeur de l attribut contenant les r les Dans l exemple ci dessus il faudrait renseigner a dans la liste d roulante Attribut W4 W4 attribute country a dans le champ de saisie Valeur dans LDAP LDAP value 33 a dans le champ de saisie Valeur dans W4 W4 value France Acteurs n existant que dans W4 Actors existing in W4 only Certains acteurs peuv
172. type a nombre de jetons disponibles par type a nombre de jetons total par type Ce fichier est g n r dans le r pertoire de logs habituel du serveur Il est au format csv pour tre directement exploitable sous Microsoft Excel et chaque ligne est du type date heure action nomDeConnection identifiantActeur typeDeLicense licencesFlottantesUtilis es licencesFlottantesDisponibles licencesFixesUtilis es licencesFixesTotales totalActeursConnect s totalActeurs Les cas d erreur ne sont pas pris en compte Cependant ils donnent d j lieu des logs par le processus de service wfadministrator Cette fonctionnalit est configur e par les param tres suivants du fichier w4server cfg a auditLogin TRUE FALSE m auditLoginFileName nomdefichier NOTE m Les caract res et espace ne sont pas support s dans la valeur de nomdefichier a Sile param tre auditLogin n est pas convenablement renseign la valeur utilis e par d faut est FALSE De m me si le param tre auditLoginFileName n est pas convenablement renseign la valeur utilis e par d faut est connectionReport csv automaticRestartPeriod Intervalle de temps au del duquel l acteur automatique processus wfautomatic ach ve son ex cution avant d tre imm diatement red marr par le processus wfbroadcaster pour des raisons de performances Ce param tre ne doit tre activ que sur demande du support W4 Valeur par d
173. u var tmp sans le sticky bit cette solution est en g n ral refus e par les administrateurs syst me ou m configurer dans W4 Engine un autre r pertoire temporaire avec les droits en lecture et criture pour tous par le positionnement du param tre tmpDir du fichier de configuration w4server cfg H 22 2 2 1 Configuration de l annuaire LDAP La configuration de l utilisation des annuaires LDAP par W4 Engine se fait l aide du dossier d une proc dure sp cialis e la proc dure d administration LDAP livr e avec les serveurs W4 Engine de d veloppement et de production Pr alables IMPORTANT Ces pr alables concernent uniquement les serveurs W4 Engine ant rieurs la version 4 1 pour lesquels le chargement de la proc dure d administration LDAP n est pas syst matique lors de l installation du serveur Depuis la version 4 1 de W4 Engine les proc dures d administration sont install es par d faut pour les serveurs d valuation et les serveurs de production Installation de la proc dure LDAP Sous Process Composer installez la proc dure LDAP en utilisant le fichier LDAP w4e fourni dans le r pertoire lt softwareHome gt Procedures Cr ation d une ic ne pour l application LDAP sur la page des services W4 Connectez vous l interface d administration CGI du serveur W4 Engine en tant qu un acteur du r le Administrator via un navigateur par l URL http lt server gt W4Public O lt server rep
174. u programme client a le m me groupe id que l utilisateur qui lance W4 Engine 0666 le propri taire du programme client n a pas le m me groupe id que l utilisateur qui lance W4 Engine java_classpath Classpath utilis au lancement de la JVM Valeur par d faut aucune param tre positionner obligatoirement si le param tre jconnector est positionn TRUE et si le param tre attachJVM est positionn FALSE Exemple d utilisation du param tre w aadm java classpath C Program Files w4 connector lib saxon jar java_home Chemin d acc s la JVM utiliser pour le serveur de connecteurs Valeur par d faut aucune param tre positionner obligatoirement si le param tre jconnector est positionn TRUE et si le param tre attachJVM est positionn FALSE Exemple d utilisation du param tre w aadm java home C j2sdk1 4 1 01 java_other_param Param tre pass la JVM Exemple d utilisation du param tre waadm java other param Djava endorsed dirs C Program Files w4 connector lib java_sleepTime D lai d attente en secondes permettant la JVM de d marrer Valeur par d faut 30 F d 54 PARAM TRE DESCRIPTION java_xdebug Permet le d bogage de la JVM Valeur par d faut aucune Commentaire ajoute l option Xdebug lors du d marrage du serveur de connecteurs java_xms Minimum Heap Size de la JVM Val
175. un r le dont la propri t Upper Role est d finie Dans ce cas l erreur Error Server 2003 est retourn e C wdeimport gt wdeimport I w4adm W w4adm f ProcessComposerTutorial w4e ex true mr Root Procedure UpperRole Root Procedure Role Sub Procedure Rol Sub Sub Procedure Rol mp Sub Sub Procedure Sub Procedure Root Procedur Sub Sub Procedure Role MODIFIED ROLE OK Sub Procedure Role MODIFIED ROLE OK Root Procedure UpperRole MODIFIED ROLE OK Root Procedure Role MODIFIED ROLE KO Error Server 2003 IMPORTANT Le r le doit exister sur le serveur au moment de l import Si vous tentez de modifier un r le inexistant et vous avez positionn l option ex true l erreur Error Server 2003 est retourn e C wdeimport gt wdeimport w4adm W w4adm f ProcessComposerTutorial w4 mr serviceAchat ex true T serviceAchat THIS ROL DOESN T EXIST Si vous tentez de modifier un r le inexistant et si l option ex est positionn e false l erreur Error Server 2003 est retourn e mais tous les objets du fichier l exception de ce r le et de la proc dure sont cr s C w4eimport gt w4eimport w4adm W w4adm f ProcessComposerTutorial w4 mr serviceAchat responsableDossierAchat CREATED ROLE OK responsableAchat CREATED ROLE OK serviceAchat THIS ROLE DOESN T EXIST ProcessComposerTutorial saisie CREATED ACTIVITY OK
176. unset v S un et v 01 january 2005 unset X Cl variable C value s v O variable Ovalve v maximum count 10 sorted by unse Mi sort order ascendng Fig 3 4 Archivage online Cet cran d finit les crit res de s lection des dossiers W4 Engine archiver Ces crit res sont restrictifs op rateur AND entre chaque crit re 1 re ligne Table 3 6 Champs du formulaire Archivage online CHAMPS DU FORMULAIRE DESCRIPTION Recherche des dossiers en fonction de leurs tats termin ou annul 2e 3e 4e lignes Recherche des dossiers en fonction d un nom de dossier d un nom d acteur d un nom de proc dure d un nom de responsable d un nom d initiateur d un nom d v nement ou d un nom de serveur 5e ligne Recherche des dossiers en fonction de leurs niveaux de priorit Sline Recherche des dossiers en fonction de leur date de cr ation de fin d alarme 9 ou de d passement ele Recherche des dossiers pour lesquels la date d alarme de d passement a expir ou pour lesquels au moins une t che est en retard 8e 9e 10e 11e lignes Recherche des dossiers en fonction de valeurs de variables de type cha ne de caract res Nombre maximum Nombre maximum de dossiers archiv s La valeur 0 utilis e dans ce champ archive tous les dossiers correspondant aux crit res W4 Engine Manuel d exploitation 94 CHAMPS DU FORMULAIRE DESCRIPTION
177. ur les GetActor et GetRole ci dessous Connexion du scheduler Scheduler Connection S lectionnez cette case cocher pour que le service Scheduler utilise LDAP Ce service peut cr er un acteur la vol e si une t che est assign e t ches assign es un acteur dont le nom est dans une variable cet acteur alors que cet acteur n est pas encore r pliqu dans W4 Engine Le fonctionnement est identique pour les r les IMPORTANT Siaucune de ces options n est s lectionn e la configuration ne sera prise en compte par aucun des services 2251 2 AUthentification LDAP LDAP authentication S lectionnez cette case cocher pour authentifier les acteurs contre LDAP NOTE m L authentification LDAP n est pas obligatoire m Les acteurs w4adm et automatic sont consid r s comme des exceptions ils ne sont pas concern s par l authentification LDAP 225 13 AUthentification exclusivement LDAP Exclusive LDAP authentication S lectionnez cette case cocher si W4 Engine ne doit accepter que des connexions apr s authentification LDAP Si cette case cocher n est pas s lectionn e un essai sera d abord effectu en v rifiant l authentification LDAP Si celle ci choue une authentification classique W4 sera tent e Ainsi les deux modes d authentification peuvent cohabiter NOTE L authentification SSO prime sur l authentification LDAP et l authentification W4 Engine 22514 ANNUA re Exchange Exchange directory
178. ux fonctionnalit s apport es par W4 Engne l utilisateur ce dernier s int ressant non pas aux noms des objets mais leur valeur Pour activer le support complet du case sensitive il est n cessaire de positionner l entr e suivante dans le fichier w4server cfg situ sous le r pertoire sys lt instanceName gt caseSensitive full Il est galement possible de n activer qu un support partiel du case sensitive seuls les APIs SearchFullet Searchsontimpact s Pour ce faire modifiez le fichier w4server cfg comme suit lt instanceName gt caseSensitive true NOTE m Seul le mode complet case sensitive est support lorsque DB2 est utilis comme base de donn es technique m Lorsqu Oracle est utilis comme base de donn es techniques passer au mode case sensitive n cessite une validation fonctionnelle des applications d j install es ce qui peut se r v ler difficile Une alternative consiste ne pas activer le mode case sensitive mais cr er des index fonctionnels sur les colonnes en jeu Exemple CREATE INDEX inx workcase upper name ON workcase UPPER name D sactivation de la fonction upper role Si dans les processus d velopp s sur W4 Engine il n existe pas d assignation en libre service sur une variable multivalu e contenant des noms de r les alors il est int ressant de d sactiver l option useDynRoles pour viter de faire une jointure suppl mentaire sur la table ro1e hi
179. w4adm W w4adm f ProcessComposerTutorial w4e cp ProcessComposerTutorial ex true ProcessComposerTutorial CREATED PROCEDURE OK un Modification de proc dures Dans la commande w4eimport sp cifiez en plus des param tres obligatoires a l option mp suivie du nom de la proc dure ou de la liste des proc dures modifier l option ex true si les autres objets du fichier ne doivent pas tre cr s IMPORTANT Vous pouvez modifier une proc dure si dans Process Composer vous avez modifi des attributs ou d plac des n uds En revanche la suppression d un n ud de la proc dure rend impossible toute modification Il faut alors r viser la proc dure pour prendre en compte les modifications La modification impose d utiliser dans le fichier w4e les m mes identificateurs d objets que sur le serveur Pour effectuer une modification il faut donc proc der ainsi extraire la proc dure du serveur de production et l enregistrer dans un fichier w4e l aide de Process Composer apporter les modifications dans ce m me fichier sous Process Composer recharger le fichier sur le serveur de production avec w4eimport les identificateurs du serveur et du fichier w4e tant en correspondance le serveur admet les modifications m Si vous tentez de modifier une proc dure avec un fichier w4e qui ne correspond pas la derni re version l erreur Error Server 2115 est retourn e C wd4eimport gt w
180. xit D marrage du serveur IMPORTANT Lesyst me de gestion de base de donn es doit imp rativement tre actif avant le lancement de W4 Engine Commande w4 start lt e n i s gt lt traceoptions gt puis validez par Entr e Chapitre 3 Administration a iae Equivalent menu m 4 puis validez par Entr e pour sp cifier les options de d marrage m 5 puis validez par Entr e Options Les options de d marrage sont les suivantes Table 3 5 Options de d marrage OPTION DESCRIPTION e Lance le processus CMD wfbroadcaster exe en mode exclusif le fichier de configuration Config lt instanceName gt est ignor IMPORTANT Cette option est utiliser sur demande du support technique W4 En cas de d faut de d marrage du serveur W4 Engine l utilisation de cette option permet de lancer les processus individuellement par ligne de commande afin d identifier le processus d faillant Exemple w4 start e wfdataminer n Lancement du serveur en mode non interactif Cette option est utile pour l ex cution de scripts i D marrage d une instance diff rente de l instance par d faut w4adm Cette option est utile dans le cas d une installation multi instances Indication du r pertoire d installation de W4 Engine Cette option est utile dans le cas d une installation cloisonn e lt traceOptions gt Il est possible de passer des options de traces en arguments d
181. zationalPerson postalAddress addressLine2 ATTRIBUT LDAP ATTRIBUT W4 postalCode postalCode telexNumber telexNumber Classe inetOrgPerson givenName firstName mail email manager manager la valeur de l attribut LDAP doit tre un DN preferredLanguage language avec un mapping roomNumber room 227 Mappings possibles pour Active Directory Les mappings ci dessous concernent Microsoft Active Directory W4 ne garantit pas qu ils conviennent pour toutes les configurations Table 2 5 Mappings possibles pour Active Directory ATTRIBUT LDAP ATTRIBUT W4 givenName firstName streetAddress addressLine2 countryCode ou c country dans le cas de countryCode il faudra d finir un mapping countryCode ou c language avec un mapping mail email postalCode postalCode name ou sn lastName description description manager manager la valeur de l attribut LDAP doit tre un DN preferredLanguage language avec un mapping roomNumber room L attribut contenant le login est sAMAccountName H 223 Mappings possibles pour Exchange 5 5 Les mappings ci dessous concernent Exchange 5 5 W4 ne garantit pas qu ils conviennent pour toutes les configurations Table 2 6 Mappings possibles pour Exchange 5 5 ATTRIBUT LDAP ATTRIBUT W4 rfc822Mailbox email info description givenName firstName sn lastName GARE D F

W4 Engine - Manuel d`exploitation

Contents

Download Pdf Manuals

Related Search

Related Contents