Elle s'adresse aux développeurs et chefs de projet en charge de réaliser des applications W4.

Transcription

1 Note technique W4 Engine Acteur automatique Cette note technique décrit le fonctionnement et la programmation de l acteur automatique sous W4 Engine. La programmation de l envoi de mail par l acteur automatique est traitée en détail. Elle s'adresse aux développeurs et chefs de projet en charge de réaliser des applications W4. Sommaire 1 Description de l'acteur automatique 3 2 Débogage de l acteur automatique 11 3 Exemples d utilisation en Java 15 4 Exemples d utilisation en.net 20 5 Exemples d utilisation en COM/ASP 26 6 Scripts en langage W Annexe 1 - Langage W Annexe 2 - Autres commandes de l acteur automatique 46 Référence : W4TN_AUTO_ACTOR_004_FR

2 Note technique W4 Engine Acteur automatique 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.

3 1 Description de l'acteur automatique 1.1 Fonctionnement général Principe de l acteur automatique L acteur automatique W4 est un programme client autonome de W4 Engine. Il est installé avec chaque instance de W4 Engine et s exécute sur la même machine que «son» instance de W4 Engine. L'acteur automatique est lancé automatiquement avec W4 Engine, dans l installation standard par défaut. Veuillez vous reporter au document suivant : Manuel d'exploitation de W4 Engine (section Fichiers de configuration) Le nom de son binaire est wfautomatic(.exe). Il utilise les API C/C++ de W4 Engine. La raison d être de l acteur automatique est d effectuer des traitements informatiques qui lui sont notifiés par l intermédiaire de tâches, tout comme pour un acteur humain. Il apparaît donc, dans la modélisation, comme un rôle spécial automatic - auquel sont assignées les activités représentant des traitements informatiques. Les étapes associées à ces activités ont une icône particulière les distinguant des étapes attribuées à des acteurs humains. Scripts de l acteur automatique La plupart des concepts applicables aux acteurs humains sont applicables dans le contexte de l acteur automatique W4 : il dispose d un compte propre avec identifiant automatic - et mot de passe ; il possède des rôles, une corbeille, etc., à un détail près : si un acteur humain sait interpréter et remplir un formulaire, le programme incarnant l acteur automatique «préfèrera» exécuter un script dans lequel seront décrits les traitements à effectuer. Par exemple : envoi d un mail d information, mise à jour d une base métier, etc. Le modèle (template) associé à une activité destinée à un acteur automatique doit donc être un modèle de script et non un modèle d écran HTML. Pour distinguer ces scripts des formulaires «humains», l acteur automatique se voit affecter la langue conventionnelle auto, les formulaires de cette langue étant en fait des scripts. Le nom d un fichier script acteur automatique a le format suivant : <nom de l activité>.auto.html Notez la présence de l attribut.html bien que le modèle ne soit pas du HTML. Le langage de script de l acteur automatique est décrit plus bas. 3 NOTE TECHNIQUE Description de l'acteur automatique

4 Attention! Les modèles de script de l acteur automatique doivent être sur le serveur supportant l instance de W4 Engine et non sur le serveur de présentation supportant l application W4 (dans le cas où ils sont distincts). Par défaut, les acteurs automatiques de toutes les instances recherchent les modèles selon le même principe que le moteur, soit par défaut sous <W4Engine_Home>/Activities, où <W4Engine_Home> représente le répertoire d installation de W4 Engine, sauf si, pour l instance considérée, le répertoire est redéfini par une ligne <instance>.alias.activities dans le fichier w4server.cfg. Veuillez vous reporter au document suivant : Manuel d'exploitation de W4 Engine (section Fichiers de configuration) Erreur d exécution de script de l acteur automatique En cas d erreur à l exécution du script par l acteur automatique (wfautomatic.exe), la tâche correspondante n est pas terminée mais réassignée par l acteur automatique au responsable du dossier (rôle ou acteur). Dans ce cas, le formulaire de la tâche présentée à l acteur est : <nom de l activité>.<lg>.<attribut>, où <lg> est la langue de l acteur et <attribut> vaut selon le contexte applicatif asp, jsp, aspx ou html. Si ce modèle n existe pas, le modèle <nom de l activité>.<attribut> est présenté. Attention! L absence de modèle pour un acteur humain est une cause d erreur très fréquente. Les modèles de bibliothèques standard livrés avec W4 Studio traitent ce cas. Sérialisation des traitements L acteur automatique traite ses tâches consécutivement. Il n y a pas de parallélisme. En conséquence, si le traitement moyen d une tâche est de 1 s, l utilisation du workflow ne devra pas générer plus de 3600 tâches par heure sous peine de voir la corbeille de l acteur automatique croître indéfiniment. Dans ce cas de figure, il est préférable de réaliser des connecteurs multi-threadés, à l aide du serveur de connecteurs. Compte acteur automatique wfautomatic se connecte avec l identifiant conventionnel du compte de l acteur automatique, automatic (id = 2), mot de passe auto. Le compte du participant d identifiant automatic est décrit et géré, comme tout autre acteur, à travers l interface d administration. Ce compte ne peut être supprimé. On définira donc pour l activité automatique Acti le script Acti.auto.html (notez la présence de l attribut.html bien que le modèle ne soit pas du HTML). Il s'agit d'un utilisateur nommé qui utilise donc une licence de ce type qui lui est réservée (à l'instar du compte d administration d identifiant w4adm). Il peut donc toujours se connecter. Ces 2 licences sont toujours incluses et gratuites. W4 BPM Suite NOTE TECHNIQUE 4 Acteur automatique

5 Attention! Il est fortement déconseillé de modifier les attributs de l acteur automatique, notamment sa langue et son mot de passe. Lancement de l acteur automatique L acteur automatique est lancé avec les autres tâches du serveur W4 Engine par l intermédiaire du fichier sys/config.<instance>, soit par sys/config.w4adm pour l instance par défaut. Veuillez vous reporter au document suivant : Manuel d'exploitation de W4 Engine (section Fichier de configuration Config.<instance>) Dès son lancement, wfautomatic.exe se connecte au serveur de workflow, sous son identifiant d acteur, automatic, avec le mot de passe, auto. Il reste connecté tant qu il n est pas arrêté. Rôles L acteur automatique possède deux rôles système : automatic et reassign. automatic est le rôle prédéfini pour l acteur automatique. Il n a aucune propriété système particulière. En revanche, le rôle système reassign donne le droit à un acteur le possédant de réassigner une tâche qui lui est attribuée. Comme expliqué ci-dessus, cette possibilité est utilisée par l acteur automatique quand il détecte une erreur dans le script de la tâche. Il réassigne alors la tâche au responsable (au responsable désigné ou, à défaut, au rôle responsable en mode libre service), c està-dire, en principe, à un acteur interactif. D autres rôles peuvent être assignés si nécessaire. Attention! L acteur consulte uniquement sa corbeille «personnelle» : il recherche les tâches assignées nominativement au compte automatic. Il ne recherche pas les tâches en libre-service pour son ou ses rôles. De plus, il est fortement déconseillé d affecter le rôle automatic à un autre acteur que l acteur automatic. En effet, les étapes destinées à l acteur automatic sont assignées selon le mode Acteur avec la charge de travail la plus faible pour le rôle automatic. Si plusieurs acteurs ont le rôle automatic, les tâches associées pourraient potentiellement être affectées à un autre acteur que celui visé : automatic. Algorithme de l acteur automatique Après son démarrage, l acteur consulte sa corbeille (API SearchTask) et exécute chacune des tâches. Pour chaque tâche, le programme : appelle l API ProcessTask ; 5 NOTE TECHNIQUE Description de l'acteur automatique

6 exécute une à une les lignes du script ; si une erreur survient sur une ligne du script : interrompt l interprétation du script et appelle l API ReassignTask. Les erreurs d exécution du script peuvent être : ligne non reconnue, code retour d une commande appelée non nul ; si l exécution du script s est bien terminée : appelle l API EndTask, sauf si la tâche à changé d état (par exemple, terminée ou «remise» dans la corbeille par un OnHoldTask). Dans ce cas, il considère que le script a pris en charge l état de la tâche automatique et ne s en mêle donc pas. Une fois toutes les tâches traitées (c est-à-dire terminées, réassignées ou «remises» dans la corbeille), l acteur automatique attend T secondes (60 par défaut) puis interroge W4 Engine pour savoir si de nouvelles tâches ont été créées depuis sa dernière interaction grâce à l API CheckNewTask. Notez que cette API est très rapide car elle ne fait pas appel à la base de données, ni même à l ordonnanceur (scheduler) mais à la surveillance de session, qui note au passage si de nouvelles tâches sont créées entre deux appels pour le compte de la session. Si de nouvelles tâches ont été créées il les recherche (API SearchTask) et reprend le traitement décrit ci-dessus, attend à nouveau T secondes et recommence. Il répète cette opération N fois (10 par défaut). Après cela il consulte à nouveau toute sa corbeille. Il retrouve dans sa corbeille les tâches qu il a suspendues pendant les traitements précédents ainsi que les nouvelles tâches arrivées pendant les dernières T secondes. 1.2 Exploitation de l acteur automatique Syntaxe du lancement en ligne de commande : wfautomatic[.exe] <T> <N> Exemples CheckNewTask SearchTask wfautomatic Toutes les 15 s (*) Toutes les 60 x 15s, soit 15 mn (*) wfautomatic Toutes les 60 s (*) Toutes les 60 x 60s, soit 1 h (*) wfautomatic Toutes les 30 s (*) Toutes les 30 x 10s, soit 5 mn (*) (*) en excluant les temps de traitement des tâches. Veuillez vous reporter au document suivant : Manuel d'exploitation de W4 Engine (section Fichier de configuration Config.<instance>) W4 BPM Suite NOTE TECHNIQUE 6 Acteur automatique

7 1.3 Langage de commande Fonctionnement Introduction Les trois principales commandes sont exécution d un script «distant» par appel d un URL ; href=, permet d exécuter une suite d API W4 exprimées au format URL CGI ; system=, soumission d une commande à l interpréteur de la plateforme. Exemple system=ftp -n -i s c:\temp\w4stdin.tmp aberlour Chaque ligne représente une commande que l acteur automatique exécute en séquence. Une ligne vide ou blanche est ignorée. Une ligne non reconnue provoque une erreur fatale. Elle génère un message d erreur dans le fichier journal de l acteur automatique wfautomatic<pid>.log. Un fichier script vide ne génère pas d erreur. Quand l interprétation est terminée, l acteur automatique termine la tâche sauf si l état de la tâche automatique a été modifié, par exemple en la suspendant ou en la terminant : l acteur automatique en conclut que les commandes qu il a exécutées sont la cause de ce changement d état. Il n interfère pas. Dans le cas où l acteur automatique termine la tâche, il le fait sans positionner les variables entrée/sortie et sortie de la tâche. Si des valeurs résultats sont nécessaires, il faut que l une des commandes les positionne en terminant la tâche. En cas d erreur sur une ligne, la séquence d erreur standard est : une journalisation d erreur est faite dans le fichier wfautomatic<pid>.log (selon le mécanisme standard de journalisation du serveur) où <pid> est le process id de l acteur automatique ; le traitement est arrêté à cette ligne ; l acteur automatique réassigne sa tâche à l acteur responsable du dossier ou en libreservice au rôle responsable de la procédure si le responsable du dossier n est pas nommé. Pré-processing Le paramétrage des scripts avec les données contextuelles se fait à l aide du langage propriétaire W4 expliqué ci-dessous (les objets du langage W4 sont repérés par le en tête de leurs identifiants). Avant d interpréter son script, l acteur automatique soumet la totalité du fichier correspondant au «parser» du langage W4 qui substitue aux paramètres leurs valeurs. 7 NOTE TECHNIQUE Description de l'acteur automatique

8 Toutes les possibilités du langage W4 peuvent être utilisées. La seule condition est qu en sortie du traitement de substitution, la forme résultat soit valide. Un fichier vide ou des lignes vides ou avec espaces est une forme légale. Exécution déportée Les possibilités du langage propriétaire de W4 étant très limitées en dehors de l accès à W4, la commande du langage est très utilisée. Cette commande, reconnue par l analyseur du langage, permet «d appeler un URL» puis d interpréter le fichier source retourné par l exécution de l URL (noter que ce source est à nouveau «parsé» avant d être rendu à l acteur automatique). Cet URL sera en général un appel paramétré à un script ASP, JSP ou.net. Le texte retourné par l exécution de l URL est usuellement vide. Les paramètres passés incluent généralement le contexte de session de l acteur automatique, session qui peut alors être utilisée dans le script pour accéder au moteur de workflow. Le script de l acteur automatique se réduit alors à cette ligne. Tout le traitement est fait dans le code de l URL. Le traitement est donc fait dans l analyseur du langage W4. Ensuite, puisque son script est vide, l acteur automatique «se contente» de terminer la tâche si elle est toujours dans l état en-cours. L usage de cette commande est décrit plus en détail dans les chapitres suivants : Exemples d utilisation en Java Exemples d utilisation en.net Exemples d utilisation en COM/ASP Exemple Avant substitution skid=@task.name.id&caseid=@task.workcase.id)@/include Après substitution : L URL a été appelé pendant la substitution, et la réponse à la requête (en l occurrence la chaîne vide) se substitue à la )/@include Attention! Une source d erreur commune est que le script de l URL rende «un peu de HTML» de façon plus ou moins volontaire, notamment en cas d erreur (stack Java, message «page not found», message d erreur ODBC, etc.). Ce résultat n a plus une forme valide. L acteur automatique passe en erreur. Référence Commandes usuelles de l acteur automatique : W4 BPM Suite NOTE TECHNIQUE 8 Acteur automatique

9 href="w4 URL" : décrit au chapitre : décrit aux chapitres 4, 5 et 6 system=localshellcommandline : voir ci-dessous outvalue=taskoutvalue : voir ci-dessous logerror=errornumber : voir ci-dessous // comment text : voir ci-dessous Remarque Quelques commandes obsolètes, non conseillées, sont décrites en annexe. Commande system= system=localshellcommandline Soumission à l interpréteur de commande du serveur (typiquement sh sous Unix, cmd.exe sous Windows) de la commande localshellcommandline. L acteur automatique attend la fin de la commande avant de passer à la ligne suivante (la commande est un appel à la fonction system() de la bibliothèque standard C). Attention! Tout code retour non nul de la commande system= est considéré comme une erreur, que la cause en soit une erreur de lancement de la commande (commande non trouvée, shell absent, etc.) ou un exit code non nul retourné par la commande s étant correctement exécutée ou pas. Le traitement standard d erreur est appliqué. Si la commande appelée retourne en fonctionnement normal un exit code non nul, elle doit être «enveloppée» par un script retournant un exit code nul. Exemple Exécution d une commande ftp (ftp mode ligne standard sous Windows). system=ftp -n -i sc:\temp\w4stdin.tmp myhost.myname.com 1>c:\temp\w4stdout.tmp 2>c:\temp\w4stderr.tmp Commande outvalue= outvalue=textstring Positionnement de la valeur de retour de la tâche (ou code retour). Si plusieurs lignes de ce type existent, la dernière prévaut. Si la tâche est déjà terminée (comme conséquence de l exécution d une ligne précédente du script) la ligne n a pas d effet. Commande logerror= logerror=errornumber Arrêt en erreur du traitement. Code d erreur à enregistrer dans le fichier journal wfautomatic<pid>.log. Les lignes suivantes du script sont ignorées. La tâche est réassignée comme sur toute erreur. 9 NOTE TECHNIQUE Description de l'acteur automatique

10 Ligne commentaire // texte commentaire Chaque ligne de commentaire doit être précédée de //. W4 BPM Suite NOTE TECHNIQUE 10 Acteur automatique

11 2 Débogage de l acteur automatique 2.1 Journalisation des erreurs Les erreurs détectées par l acteur automatique sont enregistrées dans le fichier journal wfautomatic<pid>.log où PID est le process identifier (visible dans le gestionnaire de tâches). Un certain nombre de lignes sont générées pour chaque erreur. On donne ci-dessous, en titre, la partie significative. Veuillez vous reporter au document suivant : Manuel d'exploitation de W4 Engine (section Fichiers journaux) Line=début de séquence html L acteur automatique a trouvé un modèle HTML au lieu d un modèle interprétable. Causes possibles : 1. Le modèle n existe pas, l acteur a reçu alors le modèle standard d erreur (qui est en HTML). 2. Le modèle a un nom incorrect, typiquement <acti>.html au lieu de <acti>.auto.html. 3. La langue de l acteur n est pas en accord avec celle du modèle. error 1 Une commande system= a échoué. Causes possibles : 1. La commande est incorrecte (la vérifier en l entrant à la console). 2. La commande n est pas dans le chemin d exécution (variable d environnement $PATH). error 22 Conditions d apparition : Serveur Unix avec des installations cloisonnées. Utilisation de l'acteur automatique avec la syntaxe w4.http.w4servlet?@ctx&template=activities/ftx_delayclosed.auto.jsp& taskid=@task.name.id)@/include 11 NOTE TECHNIQUE Débogage de l acteur automatique

12 Lors de ce type d'utilisation, l'erreur 22 peut survenir (voir ci-dessous) car l'acteur automatique redirige sur le serveur Web Java et doit ABSOLUMENT disposer de la variable d'environnement W4_ADM_DIR. Le log est : W4Engine ( ) - Sun Solaris (A) :23:25 (1) WFGetAdmDir: the software is not properly installed :23:25 (1) error 22 (WFGetAdmDir admtools.c 5001 [4979]) :23:25 (0) error 22 (WFReadGlobalContext admtools.c 3813 [3785]) :23:25 (2) error 11 (WFCloseStorage wfstorage.c 445 [436]) :23:25 (0) error 11 (WFCleanStorage wfstorage.c 505 [505]) :23:25 (0) error 22 (WFInitCgiClient wfcgimain.c 254 [212]) :23:25 (1) WFInitCgiClient: argc= :23:25 (1) WFInitCgiClient: argv[0]=cgi.exe :23:25 (1) WFInitCgiClient: Server side usage: :23:25 (1) WFInitCgiClient: cgi.exe -e <envfilename> < <inputfilename> :23:25 (0) error 22 (main wfcgimain.c 376 [368]) error 33 Ligne de commande incorrecte. La ligne en cause est affichée dans le journal dans le message : WFProcessAutomaticTask: line=ligne incorrecte Exemple 1 : :29:32 (2) WFProcessAutomaticTask: incorrect line :29:32 (2) WFProcessAutomaticTask: line=<!doctype HTML PUBLIC "-//IETF//DTD HTML//EN"> :29:32 (2) error 33 (WFProcessAutomaticTask H:\w4\src\notifier\wfautomatic.c 623 [539]) :29:32 (0) error 33 (main H:\w4\src\notifier\wfautomatic.c 736 [0]) :29:32 (2) main: task #18236 cannot be processed Cause : le modèle (langue «auto») de l activité automatique n existe pas (Acti.auto.html). Le mécanisme de modèle par défaut a joué, fournissant à l acteur automatique un modèle HTML Soit Acti.html, soit Standard.html. W4 BPM Suite NOTE TECHNIQUE 12 Acteur automatique

13 Exemple :01:56 (2) WFProcessAutomaticTask: incorrect line :01:56 (2) WFProcessAutomaticTask: line=dir * :01:56 (2) error 33 (WFProcessAutomaticTask H:\w4\src\notifier\wfautomatic.c 618 [534]) :01:56 (0) error 33 (main H:\w4\src\notifier\wfautomatic.c 731 [0]) :01:56 (2) main: task # cannot be processed Cause : l utilisateur a mis dans son fichier de script : dir * au lieu de : system=dir * error 3040 Une erreur a été détectée. La réassignation de la tâche au (rôle) responsable du dossier a échoué. Causes possibles : l acteur automatique n a pas le rôle reassign. Veuillez vous reporter au chapitre suivant : Annexe 1 L acteur automatique s arrête en erreur. Causes possibles : très probablement une ligne href= sans guillemets. Contournement : corriger. Arrêter / redémarrer le serveur W Pièges de l acteur automatique 1 Le mot de passe utilisé par le programme wfautomatic.exe est auto. S il est changé, par l interface d administration web, dans la description de l acteur automatic, le programme wfautomatic.exe ne pourra pas se connecter. 2 Ne pas changer la langue de l acteur automatique (valeur auto) par cette même interface d administration. 3 Bien qu il s agisse d un script, le nom du fichier de script doit comporter l attribut.html, soit pour l activité MyActivity : MyActivity.auto.html. 4 La syntaxe d une ligne est mot-clé=valeur sauf pour le mot-clé href où la syntaxe est href="valeur". L absence de «quote» entourant la valeur provoque une erreur fatale de l acteur automatique. 13 NOTE TECHNIQUE Débogage de l acteur automatique

14 5 Dans le cas d installation multi-instances, la commande href doit stipuler l instance concernée. Sinon les commandes portent sur l instance par défaut. Exemple : href="/cgi.exe?@ctx&cmd=..." est correct est expansé en lg=@lg&id=@id&lid=@lid&wfs=@wfs où wfs identifie l instance à laquelle est connecté l acteur automatique. 6 Tâches d alarmes ou de dépassement non exécutées. Si, en dépit du paramétrage de l acteur automatique, une tâche ne semble pas être exécutée par ce dernier, il faut s assurer que celle-ci n est pas une tâche d alarme ou de dépassement. Dans ce cas, la tâche n est peut-être pas encore créée, car le service de gestion des alarmes (wfbigbrother) «tourne» par défaut sur la base d une vérification toutes les minutes. 7 Vérification de la corbeille de l acteur automatique. On peut aussi vérifier la corbeille de l acteur automatique en se connectant sous son identité. Le fait de choisir une de ses tâches affichera le script. Rien de cela n empêchera l acteur automatique de fonctionner. 8 Une tâche peut ne pas être exécutée par l acteur automatique quand : elle assignée en libre-service pour le rôle automatic (ou un autre rôle qui aurait été attribué au compte automatic). L acteur ne recherche que les tâches assignées nominativement ; l état de la tâche est «en attente». W4 BPM Suite NOTE TECHNIQUE 14 Acteur automatique

15 3 Exemples d utilisation en Java 3.1 Environnement Le modèle standard d application JSP livré avec W4 Studio donne le squelette du code d une activité automatique «écrite» en Java. Modèle activité (activityauto.auto.html) Le modèle livré est vide : // include the script here Au commentaire peut être substitué un include_url appelant un script sur le modèle de celui-ci w4.http.w4servlet?@ctx&template=activities/ftx_delayclosed.auto.jsp& taskid=@task.name.id)@/include Modèle code Java (activityauto.auto.jsp) Ce code comprend la récupération du contexte de session (id, lid, workflow instance) de l acteur automatique pour utilisation par le code, l ouverture et la fermeture d une connexion entre le script et W4 Engine utilisant ce contexte de session de l acteur automatique. <%@ include file="/includes/w4context.jsp" %> <%@ include file="/includes/w4openconnexion.jsp" %> <%@ include file="/includes/w4closeconnexion.jsp" %> 3.2 Envoi d un courrier électronique Attention! Le code est donné à titre indicatif. Il peut ne pas fonctionner dans votre environnement. Ce code nécessite les fichiers suivants : activation.jar, mail.jar, mailapi.jar et smtp.jar. 15 NOTE TECHNIQUE Exemples d utilisation en Java

16 page import="java.util.*,fr.w4.twfexception,fr.w4.basic.*,fr.w4.session.*,fr.w4.search.*,fr.w4.buildtime.basic.*,fr.w4.buildtime.dynamic.*,fr.w4.runtime.dynamic.*,fr.w4.http.*,fr.w4.utils.*,fr.w4.marshal.*,fr. w4.runtime.ref.*,fr.w4.buildtime.ref.*,fr.w4.utils.*" %> page import="java.io.*,java.net.*,javax.mail.*,javax.mail.internet.*" %> include file="../includes/w4context.jsp" %> include file="../tools/w4methods/w4methods.jsp" %> <% int taskid = 0; int loginid= 0; int actorid =0; String lg= ""; // ** Déclaration des variables dont on aura besoin // Les variables multivaluées sont déclarées en String car on utilise la méthode // qui peuple une string String tstringvar s=""; //String tstringvar s=""; String tstringvarexpediteur=""; // String StrVartext="; String tstringvardemandeur=""; String tstringvardatedde=""; String tstringvarmotif=""; String tstringvarmontant=""; try taskid= Integer.parseInt(request.getParameter("taskid")); loginid= Integer.parseInt(request.getParameter("lid")); actorid= Integer.parseInt(request.getParameter("id")); lg = request.getparameter("lg").tostring(); // ** Pour tester la récupération de ces valeurs System.out.println("Ma tâche: "+ taskid); System.out.println("loginid: "+ loginid); System.out.println("actorid: "+ actorid); catch(numberformatexception nfe) System.out.println("\n Exception NumberFormat dans mailinfo.jsp"); nfe.printstacktrace(); TWFfullTaskRef fullcurrenttaskref = null; TWFfullTask fullcurrenttask = null; TWFnativeSession w4session = null; Enumeration actorenum = null; TWFTrawVariable tvariables = null; TWFTrawVariable cvariables = null; W4 BPM Suite NOTE TECHNIQUE 16 Acteur automatique

17 try w4session = new TWFnativeSession(); w4session.setpriority(101); // ** Renseigner le nom du serveur W4 ("ServerName)et de l'instance ("w4adm" // ou autre) w4session.setactorid(actorid); w4session.setservername("servername"); w4session.setinstancename("w4adm"); w4session.setlanguage(lg); w4session.setloginid(loginid); w4session.openconnection(); TWFTfullTaskFieldName fields = new TWFTfullTaskFieldName(); fields.add(twffulltaskfieldname.casevariables); fullcurrenttask =(new TWFfullTaskRef(taskid)).wfGetFullTask(fields,(null),(null)); // Récupère les variables de tâche tvariables = fullcurrenttask.wfgettaskvariables(true); // Récupère les variables de dossier cvariables= fullcurrenttask.getcasevariables(); // ** Récupère les adresses mail des destinataires // de la variable multivaluée "maildestinataire" - utilisation d'une méthode // définie dans w4methods.jsp ou depuis la variable monovaluée // tstringvar = cvariables.getvalue(" ").tostring(); tstringvar s=w4mvariablevalue(tvariables, "maildestinataire", ","); // ** Récupère les variables de tâches nécessaires au texte et enveloppe // de mail tstringvarexpediteur = tvariables.getvalue("mailexpediteur").tostring(); //StrVartext = cvariables.getvalue("body").tostring(); tstringvardemandeur = tvariables.getvalue("demandeur").tostring(); tstringvardatedde = tvariables.getvalue("datedemande").todate().getday() +"/"+tvariables.getvalue("datedemande").todate().getmonth() +"/"+tvariables.getvalue("datedemande").todate().getyear(); tstringvarmotif = tvariables.getvalue("motif").tostring(); tstringvarmontant = tvariables.getvalue("montant").tostring(); 17 NOTE TECHNIQUE Exemples d utilisation en Java

18 // ** Pour tester la récupération des valeurs System.out.println("destinataires " + tstringvar s); System.out.println("demandeur " + tstringvardemandeur); System.out.println("Date demande " + tstringvardatedde); System.out.println("montant " + tstringvarmontant); System.out.println("motif " + tstringvarmotif); System.out.println("expediteur " + tstringvarexpediteur); */ /************************* Données propres à l'envoi du message String from = tstringvarexpediteur; String host = "tea"; String subject = "Demande d'engagement de dépenses acceptée"; String message = " L'engagement de dépense demandée le "+tstringvardatedde+" par "+tstringvardemandeur+" a été acceptée. Montant de la dépense prévue (en KEuros) : "+tstringvarmontant+". Motif de la demande : "+tstringvarmotif+"."; Properties props = new Properties(); props.put("mail.smtp.host", host); Session masession = Session.getDefaultInstance(props, null); /************************* Pour l'envoi du message */ try MimeMessage msg = new MimeMessage(maSession); msg.setfrom(new InternetAddress(from)); msg.setrecipients(message.recipienttype.to, tstringvar s); // msg.setrecipients(message.recipienttype.cc, "raphael@tea.w4, phil@tea.w4"); msg.setsubject(subject); 15"); // Créer et renseigner la première partie du message MimeBodyPart mbp1 = new MimeBodyPart(); mbp1.settext(message); mbp1.setheader("content-type","text/html; charset=iso Multipart mp = new MimeMultipart(); mp.addbodypart(mbp1); msg.setcontent(mp); // Positionner la date: en-tête msg.setsentdate(new Date()); // Envoyer le message Transport.send(msg); catch(exception e1) W4 BPM Suite NOTE TECHNIQUE 18 Acteur automatique

19 System.out.println("\nException lors de l'envoi du message\n"); e1.printstacktrace(); /************************* Fin des données propres à l'envoi du message */ // Fermer la session W4 ouverte catch(twfexception e) System.out.println("erreur setting des variables"); e.printstacktrace(); finally if(w4session!= null && w4session.getsessionhandle() > 0) try w4session.closeconnection(); catch(twfexception e) e.printstacktrace(); %> 19 NOTE TECHNIQUE Exemples d utilisation en Java

20 4 Exemples d utilisation en.net 4.1 Environnement Le modèle standard d application.net (C#) livré avec W4 Studio donne le squelette du code d une activité automatique «écrite» en C#. Ce code comprend la récupération du contexte de session (id, lid) de l acteur automatique pour utilisation par le code, l ouverture et la fermeture d une connexion entre le script et W4 Engine utilisant le contexte de session de l acteur automatique. Modèle activité Les formes $identifiant correspondent au langage W4 Studio. Veuillez vous reporter au document suivant : Manuel de génération de W4 Studio Soit, après une substitution arbitraire du langage W4 Studio tx&taskid=@task.name.id&caseid=@task.workcase.id)@/include Attention! Le service w4 doit pouvoir accéder à la page automatique. Il existe cependant plusieurs façons de faire : 1 Le service w4 doit être démarré sous un compte utilisateur et non pas en tant que «système local» ; ensuite, ce compte doit avoir les droits d exécution (droits sur le système de fichiers) sur les fichiers.aspx et.aspx.cs. 2 Si le service w4 est démarré par le «système local», alors il est nécessaire, via IIS, d autoriser les connexions anonymes soit sur le fichier.aspx (d activité automatique), soit sur le répertoire contenant l activité automatique, soit sur l application. 3 Pour les applications générées à partir de la version 5.5 de W4 Studio, il est nécessaire de configurer le web.config pour qu il autorise l accès direct à la page d activité automatique sans passer par la page de connexion à l application (cf. exemple ci-dessous). W4 BPM Suite NOTE TECHNIQUE 20 Acteur automatique

21 <location path="activities/$activity_name_auto.aspx"> <system.web> <authorization> <allow users="?"/> </authorization> </system.web> </location> Modèle code C# Un total de 5 fichiers est donc nécessaire pour faire fonctionner l activité automatique correctement : le fichier.auto.html à déployer sur le serveur ; les fichiers de la page <Activite_auto> (.aspx et.cs) qui correspondent aux fichiers d exécution du traitement automatique ; les fichiers de la page <Activite> (.aspx et.cs) qui permettent d afficher la tâche assignée au responsable de l application lorsque l activité automatique ne s est pas déroulée correctement (par exemple un message d avertissement). 4.2 Envoi d un courrier électronique Le modèle de code C# inclut le code d envoi d un courrier électronique listé ci-dessous ainsi que la mise à jour de variables du dossier qui sont en sortie de l activité. Attention! Dans L exemple qui suit, les éléments du langage W4 Studio identifiés par $ ne sont pas substitués. Le code est donné à titre indicatif. Il peut ne pas fonctionner dans votre environnement. Fichier.aspx Ce fichier doit contenir uniquement la référence à son «code behind». Aucun code html ne doit être écrit. Son contenu sera donc le suivant : <%@ Page language="c#" Codebehind="$activity_name_auto.aspx.cs" AutoEventWireup="false" Inherits="$sub_directory.Activities.$activity_name_auto" %> 21 NOTE TECHNIQUE Exemples d utilisation en.net

22 Fichier.aspx.cs Toutes les parties «<texte>» doivent être remplacée car elles dépendent de votre environnement et/ou de votre modélisation (il y en a 6 dans l exemple qui suit). using System; using System.Data; using System.Web; using System.Web.Mail; using W4.Session; using W4.Basic; using W4.Runtime; using $sub_directory.utils; using $sub_directory.utils.w4; namespace $sub_directory.activities /// <summary> /// Envoi d'un mail contenant l'ensemble des variables en entrée de tâche /// Mise à jour de trois variables en sortie de tâche /// </summary> public class $activity_name_auto : System.Web.UI.Page private TWFnativeSession _otwfnativesession; private const string w4servername = "<W4ServerName>"; private const string w4instancename = "<W4InstanceName>"; private const string smtpservername = "<smtpservername>"; private void Page_Load(object sender, System.EventArgs e) //Récupération des informations de la request string CaseId = Request.Params["caseId"]; int TaskId = Convert.ToInt32(Request.Params["taskId"]); TWFtaskRef otwftaskref = new TWFtaskRef(TaskId); try _otwfnativesession = getw4session(request); _otwfnativesession.wfopenconnection(); // Création du mail creat (otwftaskref, CaseId); //Terminaison de la tâche avec mise à jour de la variable TWFvariableList otwfvarlist = new TWFvariableList(); otwfvarlist.setvalue("<varnamestr>", "valeur"); otwfvarlist.setvalue("<varnameint>", 12); otwfvarlist.setvalue("<varnamedate>", new TWFdate(1980, 1, 1, 12, 30, 00)); otwftaskref.wfendtask(new TWFname("CodeRetour"), otwfvarlist); catch(exception l_exception) Helper.ManagedError(l_Exception, this, this.context); W4 BPM Suite NOTE TECHNIQUE 22 Acteur automatique

23 finally //Fermeture de la connexion _otwfnativesession.wfcloseconnection(); _otwfnativesession = null; public void creat (twftaskref otwftaskref, string caseid) // Récupération des variables de tâche W4.Runtime.TWFvariableList otwfvarlist = otwftaskref.wfgetvariables(true); string piecesjointes = ""; string taskvar = "<table border='0'>"; taskvar += "<tr><td colspan='2'>variables de tâches</td></tr>"; for (int i = 0; i < otwfvarlist.length; i++) taskvar += "<tr>"; taskvar += "<td align='top'>" + otwfvarlist.item(i).name + "</td>"; taskvar += "<td><b>"; switch (otwfvarlist.item(i).getvaluetype().tostring()) case "System.String": foreach (string val in otwfvarlist.item(i).stringvalues) taskvar += val + "<br>"; break; case "System.Int32": foreach (int val in otwfvarlist.item(i).intvalues) taskvar += val.tostring() + "<br>"; break; case "W4.Basic.TWFdate": foreach (W4.Basic.TWFdate val in otwfvarlist.item(i).datevalues) if (val.year!= 0) taskvar += new DateTime(val.Year, val.month, val.day).tostring("u") + "<br>"; break; case "W4.Runtime.TWFdocumentRef": foreach (W4.Runtime.TWFdocumentRef val in otwfvarlist.item(i).documentvalues) if (val!= null) W4.Runtime.TWFdocument doc = val.wfgetdocument(); taskvar += "Cf pièce jointe : " + doc.str + "<br>"; string virtualpath = doc.accesspath; if (!piecesjointes.equals("")) piecesjointes += ","; 23 NOTE TECHNIQUE Exemples d utilisation en.net

24 break; piecesjointes += virtualpath; taskvar += "</b></td></tr>"; taskvar += "</table>"; // Création du corps du message string body = "<html>"; body += "<body>"; body += taskvar; body += "<br><br>signé : Acteur AUTOMATIQUE"; body += "</body>"; body += "</html>"; string destinataire = "destinataire@w4global.com"; string auteur = "auteur@w4global.com"; string sujet = "W4 - envoi de mail automatique - dossier " + caseid; // Exécution de l'envoi du mail SendMail(destinataire, auteur, sujet, body, piecesjointes); public void SendMail(string mailto, string mailfrom, string mailsubject, string mailbody, string pathofattachments) SmtpMail.SmtpServer = smtpservername; // Instanciation de l'objet "Message" MailMessage objmessage = new MailMessage(); // Paramètres du mail objmessage.to = mailto; objmessage.from = mailfrom; // --> Format du message objmessage.bodyformat = MailFormat.Html; // --> Sujet objmessage.subject = mailsubject; // --> Corps objmessage.body = mailbody; // --> Priorité objmessage.priority = MailPriority.Normal; // --> Pièces Jointes // Construction de la liste de pièces jointes if (pathofattachments!= "") char[] delim = new char[] ','; foreach (string ssubstr in pathofattachments.split(delim)) string adr = Server.MapPath(Request.ApplicationPath) + ssubstr.replace("/", System.IO.Path.DirectorySeparatorChar.ToString()); MailAttachment myattachment = new MailAttachment(adr); objmessage.attachments.add(myattachment); W4 BPM Suite NOTE TECHNIQUE 24 Acteur automatique

25 // Envoi du mail SmtpMail.Send(objMessage); #region Méthode permettant de construire le context et la session private TWFnativeSession getw4session(httprequest objhttprequest) TWFsessionContext _otwfsessioncontext = new W4.Session.TWFsessionContext(); //lecture des informations dans la querystring _otwfsessioncontext.actorid = Convert.ToInt32(objHTTPRequest.QueryString["id"]); _otwfsessioncontext.language = objhttprequest.querystring["lg"]; _otwfsessioncontext.loginid = Convert.ToInt32(objHTTPRequest.QueryString["lid"]); _otwfsessioncontext.instancename = w4instancename; if (! w4servername.equals("")) _otwfsessioncontext.servername = w4servername; TWFnativeSession otwfnativesession = new W4.Session.TWFnativeSession(_oTWFsessionContext); return otwfnativesession; #endregion #region Code généré par le Concepteur Web Form override protected void OnInit(EventArgs e) InitializeComponent(); base.oninit(e); private void InitializeComponent() this.load += new System.EventHandler(this.Page_Load); #endregion 25 NOTE TECHNIQUE Exemples d utilisation en.net

26 5 Exemples d utilisation en COM/ASP 5.1 Environnement Le modèle standard d application ASP livré avec W4 Studio 5.0 donne le squelette du code d une activité automatique «écrite» en ASP. Ce code comprend la récupération du contexte de session (id, lid) de l acteur automatique pour utilisation par le code, l ouverture et la fermeture d une connexion entre le script et W4 Engine utilisant le contexte de session de l acteur automatique. Modèle activité (auto_page_default.auto.html) En langage W4 Studio label='nom du serveur et port : ' default_value='localhost'/$sub_directory/activities/$param label='asp Page with launching processing (without.asp) : ' default_value='activityautoname'.asp?@ctx&taskid=@task.name.id)@/in clude Soit, en langage W4, après une substitution arbitraire du langage W4 Studio askid=@task.name.id)@/include Attention! Le service w4 doit être démarré par un compte utilisateur et non pas le «système local», sinon IIS peut ne pas donner accès à la page.asp. W4 BPM Suite NOTE TECHNIQUE 26 Acteur automatique

27 Modèle code ASP (auto_page_default.asp) <% '****** '* '* Attention, le fichier.auto.html appelant celui-ci doit être dans le répertoire W4_HOME/Activities/... '* BE CAREFUL, the file.auto.html used to call this file, must exist in the folder W4_HOME/Activities/... '* '***** '*** '* Reconstitution de la session '* id représente l'acteur automatique '* Aucun retour n'est autorisé (pas de response.write) '* En cas de débogage utilisation de WFsetTrace de l'objet TWFsession '*** set objtwfsession = Server.CreateObject("w4com.TWFsession") objtwfsession.context.modify request("id"),request("lid"),50, request("lg"),"aspclient",request("srv"),request("wfs") ' Prévision en cas de débogage: activation du mode trace 'objtwfsession.context.wfsettrace "+t +mcom" 'objtwfsession.wfopenconnection '********************************************************** ' Code asp de l'acteur automatique avec utilisation de la session ' Utilisation de objtwfsession.wfaddtraceline " my line " pour ' afficher une ligne de trace dans le ficier \temp\w4dll.tra '********************************************************** ' Prévision en cas de débogage: désactivation du mode trace 'objtwfsession.context.wfsettrace "-t +mcom" 'objtwfsession.wfcloseconnection 5.2 Envoi d un courrier électronique Attention! Le code ci-dessous est donné à titre indicatif. Il peut ne pas fonctionner dans votre environnement. Il utilise l objet NewMail de la DLL cdonts.dll. 27 NOTE TECHNIQUE Exemples d utilisation en COM/ASP

28 Le détail des conditions d utilisation de cet objet est donné à la suite du code. <%@ Language=VBScript %> <!-- #include file="../../tools/methods/getitem.asp" --> <% set mysession = Server.CreateObject("w4com.TWFsession") set myautotaskname = server.createobject("w4com.twfname") set mycontext = server.createobject("w4com.twfsessioncontext") myautotaskname.id = Request("taskid") mysession.context.modify request("id"),request("lid"),50, request("lg"),"aspclient",request("srv"),request("wfs") %> <!-- #include file="../../include/w4_openconnexion.asp" --> <% ' Récupère les variables de tâche set mytrawvariables = mysession.wfgetvariables(myautotaskname,true) sendnotification = mytrawvariables.item("sendnotification").value(1).value customer = mytrawvariables.item("customer ").value(1).value Sub subsendmail(strtoname, strsubject) Dim strmybody Dim objmycdontsmail Set objmycdontsmail = CreateObject("CDO.Message") objmycdontsmail.from= "support@w4global.com" objmycdontsmail.to = strtoname objmycdontsmail.subject = strsubject strmybody = strmybody & "Bonjour, " & vbcrlf &vbcrlf strmybody = strmybody & "Nous n'avons pas pu répondre favorablement à votre demande de clé de licence. " & vbcrlf &vbcrlf strmybody = strmybody & "Cordialement. " & vbcrlf strmybody = strmybody & "W4 Support Team. " objmycdontsmail.textbody= strmybody objmycdontsmail.send set objmycdontsmail=nothing End Sub call subsendmail(customer ,"notification refus") %> <!-- #include file="../../include/w4_closeconnexion.asp" --> Installation de la DLL CDONTS Cette DLL n est plus livrée avec Windows pour les versions supérieures à 2000 Server. W4 BPM Suite NOTE TECHNIQUE 28 Acteur automatique

29 Microsoft a décidé de supprimer CDONTS avec IIS 5.1, donc sous Windows XP vous n'aurez pas accès à ce composant. Il vous faudra trouver le fichier cdonts.dll puis l'enregistrer dans la base de registre. Visitez cette page pour de plus amples informations : Le fichier cdonts.dll est à placer dans le répertoire «Windows» (WINNT dans la plupart des cas) puis dans le sous-répertoire System32. Ensuite, faites Démarrer/Exécuter puis saisissez "regsvr32 cdonts.dll" pour enregistrer la DLL dans la base de registre. Ce fichier est aussi disponible sur le CD Rom de Windows 2000 Pro et Server sous la forme cdonts.dl_. En commande DOS, faites un "expand.exe cdonts.dl_ cdonts.dll" puis faites la manipulation comme indiquée plus haut. Sous Windows 2003, la DLL a été renommée ; elle s'appelle CDOSYS.dll (elle est dans \system32 et ne fonctionnera pas sous NT4). Son utilisation ne semble pas trop différer. Éléments d utilisation de l objet NewMail de CDONTS Envoyer un mail <% Dim Mailer Set Mailer = Server.CreateObject("CDONTS.NewMail") ' on crée l'objet CDONTS Mailer.To = "destinataire@ .com" ' du destinataire Mailer.From = "expediteur@ .com" ' de l'expediteur Mailer.Subject = "Titre du message" ' titre du message Mailer.Body = "Le texte qui sera envoyé" ' corps du message Mailer.Send ' on envoie le tout %> On peut également mettre le tout sur une seule ligne qui devrait alors ressembler à : <% ' on crée toujours l'objet avant Mailer.Send "expediteur@ .com","destinataire@ .com","titre d u message","le texte à envoyer" ' et on le ferme toujours après %> 29 NOTE TECHNIQUE Exemples d utilisation en COM/ASP

30 Une fois le mail envoyé, on n'oublie pas de fermer l'objet Mailer, sinon on ne peut plus en envoyer ultérieurement, avec la commande : <% Set Mailer = Nothing %> Fonctions supplémentaires <% ' importance : 0 = normal, 1 = urgent, 2 = très urgent Mailer.Importance = 0 ' le chemin du fichier qui sera attaché Mailer.AttachFile "\\repertoire\fichier.jpg","fichier.jpg" ' liste des destinataires en CarbonCopy, séparés par une virgule Mailer.Cc = " 1@ .com, 2@ .com" ' liste des destinataires en BlindCarbonCopy (Copie cachée invisible ), séparés par une virgule Mailer.BCc = " 1@ .com, 2@ .com" ' Pour envoyer un mail au format HTML, ajouter ces 2 lignes : Mailer.BodyFormat = 0 Mailer.MailFormat = 0 ' Pour laisser le mail en format PlainText, mettez des 1 pour ces 2 lignes %> W4 BPM Suite NOTE TECHNIQUE 30 Acteur automatique

31 Soit au total l exemple simple suivant : <% '****** '* Attention, le fichier.auto.html appelant celui-ci doit être dans le répertoire W4_HOME/Activities/... '* BE CAREFUL, the file.auto.html used to call this file, must exist in the folder W4_HOME/Activities/... '* '***** '*** '* Reconstitution de la session '* id représente l'acteur automatique '* Aucun retour n'est autorisé (pas de response.write) '* En cas de débogage utilisation de WFsetTrace de l'objet TWFsession '*** set objtwfsession = Server.CreateObject("w4com.TWFsession") objtwfsession.context.modify request("id"),request("lid"),50, request("lg"),"aspclient",request("srv"),request("wfs") '********************************************************** 'Code asp de l'acteur automatique avec utilisation de la session 'utilisation de objtwfsession.wfaddtraceline " my line " pour 'afficher une ligne de trace dans le ficier \temp\w4dll.tra '********************************************************** Sub subsendmail(strtoname, strsubject) Dim strmybody Dim objmycdontsmail Set objmycdontsmail = CreateObject("CDONTS.NewMail") objmycdontsmail.from= "from@ici.com" objmycdontsmail.to = strtoname objmycdontsmail.subject = strsubject strmybody = "Corps du message" & vbcrlf strmybody = strmybody & "Deuxième ligne du corps du message" & vbcrlf strmybody = strmybody & "Troisième ligne du corps du message" objmycdontsmail.body= strmybody objmycdontsmail.send set objmycdontsmail=nothing End Sub %> call subsendmail("moi@ici.com","sujet du mail") 31 NOTE TECHNIQUE Exemples d utilisation en COM/ASP

32 6 Scripts en langage W4 6.1 Présentation Ces scripts, introduits par la commande href=, sont utiles pour les traitements simples. Par ailleurs, ils sont plus rapides que l appel d un script (JSP, ASP,.NET) «derrière» un URL local ou distant via la En contrepartie, ils ne portent que sur les API W4 et peuvent être difficiles à écrire et à mettre au point. href= introduit des URL W4 basés sur les API C/C++ dites API «CGI». Pour une information détaillée, veuillez vous reporter au document suivant : Documentation de référence en ligne des API CGI Les données contextuelles apparaissant dans ces URL sont décrites à l aide du langage W4 présenté de façon assez détaillée dans ce chapitre. Pour une information complémentaire sur le langage W4, veuillez vous reporter au document suivant : Note technique - Langage W4 6.2 Exemples Terminaison de tâche avec positionnement de variables Objet : positionnement des variables de tâche avant terminaison de la tâche. Si la terminaison de tâche est laissée à l acteur automatique, il ne positionne aucune variable. href="/w4/cgi.exe?@ctx&cmd=exittask&command=endtask&taskname.id=@tas k.name.id&statusresponse=@fin.value" Attention! Notez la présence impérative des guillemets entourant la valeur (URL) suivant href=. Commentaires Cmd=ExitTask command=endtask Nom fonction API C ExitTask (sortie de tâche) Type de sortie : terminaison W4 BPM Suite NOTE TECHNIQUE 32 Acteur automatique

33 Identification de la tâche (id) Variable de tâche StatusResponse prend la valeur de la variable «Fin» Création de tâches en fonction d une variable multivaluée Objet : création de tâches selon une valeur multivaluée. A utiliser quand il s agit de distribuer des tâches non selon un rôle mais selon une valeur, par exemple créer autant de tâches de suivi qu il y a de lots à traiter. [W4MAP NbReponses] [W4ENTRY NULL default]href="/w4/cgi.exe?@ctx&cmd=exittask&command=endtask&statutfi n=@fin.value&o(utvalue=fin&taskname.id=@task.name.id"[/w4entry] [W4ENTRY default default]@loop(basessii_toutesreponsesdetaillees) (href="/w4/cgi.exe?@ctx&cmd=init&command=createtask&fin=@fin.value&c [/W4ENTRY] Commentaires Si NbReponses est vide l entrée NULL de la map est utilisée. Le résultat après substitution sera : href="/w4/cgi.exe?@ctx&cmd=exittask&command=endtask&statutfin=@fin.v alue&outvalue=f(in&taskname.id=@task.name.id" (avec les valeurs des substituées) Si NbReponses vaut 2, l entrée default de la map sera prise, soit (href="/w4/cgi.exe?@ctx&cmd=init&command=createtask&fin=@fin.value&c 33 NOTE TECHNIQUE Scripts en langage W4