Dollar Universe Manager pour Web Services Manuel utilisateur

Transcription

1 Dllar Universe Manager pur Web Services Manuel utilisateur Versin : Date de publicatin : Autmic Sftware GmbH

2 ii Cpyright Cpyright Autmic et les lg Autmic snt des marques dépsées appartenant à Autmic Sftware GmbH (Autmic). L'utilisatin de tutes les marques dépsées nécessite une autrisatin explicite écrite et est sumise aux cnditins de la licence. Les lgiciels et/u le prgramme snt la prpriété prtégée d'autmic Sftware. L'accès et l'utilisatin de ces derniers snt sumis à des cnditins de licence devant être appruvées par écrit. Les lgiciels et/u le prgramme snt également prtégés par des drits de reprductin par des cntrats internatinaux ainsi que par les lis natinales et internatinales. Un accès et/u une utilisatin nn autrisés peuvent entraîner des pursuites civiles et pénales. La cpie nn autrisée et d'autres frmes de reprductin partielle u ttale, la décmpilatin, la reprductin, la mdificatin, u le dévelppement de prduits dérivés du lgiciel snt strictement interdits. Le nn-respect de ces cnditins peut entraîner des pursuites pénales. Sus réserve de mdificatins. Aucune respnsabilité ne sera acceptée pur tute mdificatin, missin, erreur d'impressin u de prductin. Tute reprductin, ttale u partielle, est strictement interdite. Cpyright Autmic Sftware GmbH. Tus drits réservés.

3 Dllar Universe Manager pur Web Services Manuel utilisateur iii Table des matières 1 Release Ntes Intrductin Présentatin Fnctinnalités Fnctinnalités SOAP supprtées Fnctinnalités REST supprtées Sécurité Variables Architecture Installatin Prérequis Installer Dllar Universe Manager pur Web Services Structure des répertires Autmate Java JEE Emplacement des fichiers Mettre à jur Dllar Universe Manager pur Web Services Cnfiguratin Administrer le Manager pur Web Services Activer le Manager pur Java Activer le Manager pur Web Services Licence utilisateur Démarrer/Arrêter le Manager pur Java Désactiver le Manager pur Web Services Désactiver le Manager pur Java Paramètres nœud du Manager pur Java Paramètres du Manager pur Web Services SOAP REST Keystres/Truststres Variables glbales Jurnalisatin du Manager pur Web Services UniViewer Cnsle Caractéristiques cmmunes Expressins régulières Caractères spéciaux Uprcs de type Web Services Uprcs de type Web Services SOAP Uprcs de type Web Services REST Ressurces de type Web Services Ressurces de type Web Services SOAP... 33

4 iv Table des matières Ressurces de type Web Services REST Cnditinner une Uprc sur une ressurce web service Cnditin de ressurce web service Sectin Ressurce Cnditin de ressurce web service Sectin Statut Exécuter un service web à l'aide de Dllar Universe Exécuter un service web Se synchrniser sur l'exécutin d'un service Web Cmmandes Créer une Uprc Web Service SOAP Uprc SOAP Infrmatins générales Uprc SOAP Cnfiguratin spécifique Uprc SOAP Statut Uprc SOAP Dnnées en entrée Uprc SOAP Dnnées en srtie Créer une Ressurce Web Service SOAP Ressurce SOAP Infrmatins générales Ressurce SOAP Cnfiguratin spécifique Ressurce SOAP Dnnées en entrée Cnditinner une Uprc sur une ressurce Web Service SOAP Créer une Uprc Web Service REST Uprc REST Infrmatins générales Uprc REST Gestin des entêtes http Uprc REST Paramètres de l'url Uprc REST Paramètres de fichiers Uprc REST Infrmatins pur la requête Uprc REST Statut Uprc REST Dnnées en srtie Créer une Ressurce Web Service REST Ressurce REST Infrmatins générales Ressurce REST Gestin des entêtes Http Ressurce REST Paramètres de l'url Ressurce REST Paramètres de fichiers Ressurce REST Infrmatins pur la requête Cnditinner une Uprc sur une ressurce Web Service REST Démarrer/Arrêter le service JEE A prps d'autmic, de la cmmunauté et des services La sciété Autmic Sftware La cmmunauté Autmic Centre de téléchargement Supprt technique Frmatin et services... 66

5 Chapitre 1 Release Ntes 5 1 Release Ntes Le tableau ci-dessus récapitule l'histrique des mdificatins. Les infrmatins sur les crrectins de prblèmes et sur les prblèmes cnnus snt dispnibles dans les Release Ntes Wrklad Autmatin u en cntactant le supprt technique d'autmic. Date Fnctinnalités clés Les manuels utilisateurs de Dllar Universe changent de lk pur s'intégrer dans le mnde Autmic Crrectins sur la prcédure d'activatin du Manager

6 6 Chapitre 2 Intrductin 2 Intrductin Bienvenue dans le Manuel Utilisateur de Dllar Universe Manager pur Web Services! Ce manuel est un guide d'utilisatin de Dllar Universe Manager pur Web Services. Il décrit : L implémentatin : l installatin, la cnfiguratin et les cmmandes d administratin, Les interfaces l utilisateur : UniViewer Cnsle et l interface ligne de cmmande. Dllar Universe Manager pur Web Services permet à des Uprcs de Dllar Universe : D'invquer un service web au frmat SOAP u REST De se synchrniser (via les cnditins des ressurces spécifiques Web Services) sur l'exécutin d'un service web au frmat SOAP u REST. 2.1 Présentatin Ce manuel est destiné aux dévelppeurs et pérateurs ayant besin de cmprendre rapidement les fnctins de Dllar Universe Manager pur Web Services. Le lecteur est suppsé être familier avec Dllar Universe et les services web SOAP u REST. Les services web permettent la cnsultatin et la manipulatin à distance d'infrmatins en utilisant les technlgies du Web. Afin de garantir l'interpérabilité des applicatins dévelppées sur le web, deux standards snt apparus, en résumé : L'architecture rientée services (SOAP) qui utilise des messages au frmat XML transprtés à l aide du prtcle http. L'architecture rientée ressurces (REST) qui utilise le prtcle http. Le cntenu puvantêtre sus n imprte quelle frme (XML, JSON, ). Dllar Universe Manager pur Web Services permet l'utilisatin de l'une u l'autre. 2.2 Fnctinnalités Dllar Universe Manager pur Web Services permet l'invcatin synchrne de services web au frmat SOAP u REST et la synchrnisatin sur l'exécutin d'un service web au frmat SOAP u REST sur le serveur Web. L'invcatin d'un service web est réalisée par l'exécutin d'une Uprc de type Web Service SOAP u REST. La synchrnisatin sur l'exécutin d'un service web est réalisée par le cnditinnement d'une Uprc (quelle qu'elle sit) sur une ressurce de type Web Service SOAP u REST. Le service web est identifié par un nm unique, indépendant de sn URL, garantissant ainsi la pérennité du paramétrage dans Dllar Universe indépendamment de l'évlutin des applicatins web. Le paramétrage général du Manager et la prédéfinitin des services web permet de simplifier l'utilisatin des Uprcs et des ressurces Web Services. La cnfiguratin est réalisée dans UniViewer Cnsle, la créatin/mise à jur des Uprcs et des ressurces de type Web Services peut être réalisée dans UniViewer Cnsle u en mde cmmandes.

7 Chapitre 2 Intrductin 7 Lrs de l'utilisatin d'un service web de type SOAP, le fichier de cnfiguratin WSDL est téléchargé par le manager et permet à l'utilisateur de dispser d'une aide à la saisie des valeurs dans UniViewer Cnsle lrs du paramétrage des Uprcs et des ressurces Fnctinnalités SOAP supprtées SOAP Le manager supprte SOAP 1.1 et 1.2. Représentatin WSDL Le manager supprte WSDL 1.1 mais ne supprte pas WSDL 2.0. Représentatin XSD Le manager supprte le schéma de spécificatins XML, cependant certains détails divent être précisés : Les attributs ne peuvent pas avir d'espace de nms. Les éléments "xs:any" et "xs:anyattribute" ne snt pas supprtés et snt ignrés par le manager. Prtcle HTTP Le manager envie des requêtes HTTP v1.1. HTTPS/SSL Le manager supprte HTTPS mais peut avir besin d'un truststre externe si le certificat n'est pas signé par une autrité de certificatin recnnue par Oracle (et déjà présente dans le truststre par défaut). Fichiers jints Le manager ne supprte pas les fichiers jints pur SOAP. XPath Le manager supprte les requêtes standards Xpath. Regex Le manager supprte les expressins régulières DOTALL Fnctinnalités REST supprtées Prtcle HTTP Le manager envie des requêtes HTTP v1.1. HTTPS/SSL Le manager supprte HTTPS mais peut avir besin d'un truststre externe si le certificat n'est pas signé par une autrité de certificatin recnnue par Oracle (et déjà présente dans le truststre par défaut). Fichiers jints Le manager supprte les fichiers jints pur REST utilisant MIME. La taille ttale des fichiers jints ne dit pas dépasser 20 M. Analyse JSON Le manager ne supprte pas tute la syntaxe JSON. La seule syntaxe supprtée est :

8 8 Chapitre 2 Intrductin Expressin a.b a.b[0] Descriptin Extraire la prpriété b de a Extraire le premier élément du tableau placé dans la prpriété b de a XPath Le manager supprte les requêtes standards XPath. Regex Le manager supprte les expressins régulières DOTALL Sécurité Plusieurs niveaux de sécurité peuvent être implémentés pur l'invcatin/la synchrnisatin des services web SOAP : Hradatage L'élément d'hrdatage est supprté. Il est pssible de définir la précisin à la secnde u à la millisecnde. Jetn utilisateur Signature Chiffrement SAML Le jetn utilisateur est supprté. Il est pssible d'ajuter un nnce u la date à laquelle le jetn a été créé. Reprtez-vus à la sectin "Service web SOAP - Sectin Cnfiguratin WS- Security srtante Jetn d'utilisateur" page 19. La signature est supprtée. Les types d'identificatin, les algrithmes de signature, les algrithmes de cannisatin et les algrithmes de hachage supprtés snt listés à la sectin "Service web SOAP - Sectin Cnfiguratin WS-Security srtante Signature" page 19. Le chiffrement est supprté. Les types d'identificatin, les algrithmes de cdage symétriques et les algrithmes de chiffrement supprtés u nn-supprtés snt listés à la sectin "Service web SOAP - Sectin Cnfiguratin WS-Security srtante Chiffrement" page 20. SAML n'est pas supprté. Les requêtes peuvent utiliser SSL seln l'url utilisée : http u https. Les truststres/keystres utilisés snt définis au niveau du manager et peuvent être utilisés par plusieurs services web. Le Manager utilise la spécificatin WSS 1.1 et le Basic Security Prfile 1.1 pur les services web SOAP. La RFC utilisée peut être truvée à l'adresse suivante : UsernameTkenPrfile-01.htm La sécurisatin des web services REST se fait uniquement à l aide de https Variables Des variables utilisables dans les Uprcs u les ressurces Web Services peuvent être définies à plusieurs niveaux :

9 Chapitre 2 Intrductin 9 1. Variables glbales (dans les paramètres du Manager) : "Variables glbales" page Variables d'un service web (dans les paramètres du Manager) : "Service web SOAP - Sectin Variables persnnalisées" page 18 u "Service web REST - Sectin Variables persnnalisées" page Variables de nœud (décrites dans la dcumentatin de Dllar Universe) 4. Variables d'ug 5. Variables d'uprc Lrs de l'exécutin de l'uprc la valeur prise en cmpte est (dans la liste ci-dessus) la dernière définie. La substitutin est réalisée par Dllar Universe puis par le Manager lrs de l'invcatin du service web. Lrs de l'exécutin d'une ressurce, les variables de nœud, d'ug et d'uprc ne snt pas utilisables. Seules les variables du service web (1 et 2) et les variables héritées par l'uprc cnditinnée snt utilisables. Dans les cmmandes, une variable dit être appelée sus la frme!var!. Sus UNIX/Linux, le nm des variables ne dit pas cmmencer par un chiffre (restrictin du système d'explitatin). 2.3 Architecture L'invcatin d'un service web sur un serveur web est réalisée au sein de Dllar Universe seln le schéma présenté ci-dessus : Figure 1 : Sumissin d'un service web par Dllar Universe L'utilisateur définit des Uprcs et des ressurces de type Web Services (SOAP u REST) se basant sur des services web déclarés dans les paramètres du Manager. La sumissin d'une Uprc et l'attente d'une cnditin de ressurce de type Web Service (SOAP u REST) sumet l'invcatin du service web asscié sur le serveur web de façn synchrne.

10 10 Chapitre 2 Intrductin Figure 2 : Cmpte rendu d'exécutin du service web Le Manager analyse le cmpte rendu d'exécutin du service web et, en fnctin du paramétrage de l'uprc u de la cnditin de ressurce, établit le statut de l'exécutin / valide la cnditin. La trace de l'exécutin du service web peut être inscrite dans le jurnal d'exécutin de l'uprc qui a sumis le service web u de la ressurce cnditinnante.

11 Chapitre 3 Installatin 11 3 Installatin Dllar Universe Manager pur Web Services est basé sur le service Java de Dllar Universe. L'installatin de Dllar Universe Manager pur Web Services est dnc réalisée lrs de l'installatin du service Java de Dllar Universe. Une cnfiguratin supplémentaire, décrite ci-dessus, est nécessaire à l'utilisatin des services web. 3.1 Prérequis Pur plus d infrmatins sur les systèmes d explitatin et sur la cmpatibilité avec les autres prduits Dllar Universe, reprtez-vus à la matrice de cmpatibilité ("Cmpatibility Matrix") accessible sur le site web du Service Clients, dans l nglet "Cntent". Dllar Universe Manager pur Web Services/Java requiert un Java Runtime Envirnment (JRE). Si aucun JRE n'est installé, vus puvez le télécharger depuis la page Installer Dllar Universe Manager pur Web Services Dllar Universe Manager pur Web Services est une partie intégrante de Dllar Universe et est supprté par le Manager pur Java. Lrs de l'installatin de Dllar Universe sur la machine, dans le dialgue "Managers installatin" sus Windws u "Usage f the ODB, EJB, JMS, WSC Managers" sus UNIX/Linux, tris ptins snt prpsées pur le service Java : Remve service ("r") : le service Java n'est pas installé. Aucun Manager basé sur le Manager Java ne purra être activé. Keep service ("k") : le service Java est installé mais devra être activé par la suite. Reprtezvus à la sectin "Activer le Manager pur Java " page 13. Activate service ("a") : le service Java est installé et activé. Le chemin d'accès cmplet à un JRE/JDK valide dit être saisi. Par exemple C:\Prgram Files\Java\jre7 sus Windws u /usr/bin/java sus UNIX/Linux. Le service Java est utilisé par le Manager pur Oracle Database, par le Manager pur Micrsft SQL Server, par le Manager pur Java (JMS et EJB) et par le Manager pur Web Services. Si le service Java n'est pas installé, aucun de ces Managers ne purra être activé/utilisé. Une fis l'installatin terminée et le service Java activé, l'utilisateur devra activer le Manager pur Web Services. Reprtez-vus à la sectin "Activer le Manager pur Web Services" page Structure des répertires L installatin cpie les fichiers nécessaires au Manager : Le sus-répertire bin/bin_java de la Sciété, ciblé par la variable UXJEE_DIR_EXEC, cntient tus les binaires. Le sus-répertire data/data_java de la Sciété, ciblé par la variable UXJEE_DIR_DATA, cntient les dnnées et paramètres du Manager. Les fichiers cncernant les Web Services snt préfixés par ws_.

12 12 Chapitre 3 Installatin Le sus-répertire lg de la Sciété, ciblé par la variable UXJEE_DIR_LOG, cntient le fichier jurnal du manager : mgrjava.lg. Le sus-répertire thirdparty de la Sciété cntient les fichiers internes déclarés dans les "Paramètres du Manager pur Web Services" Autmate Java JEE Lrsque Dllar Universe a été installé u mis à jur en versin 6, l'autmate Java JEE a été installé. C'est un prcessus Java lancé par le serveur d'io. Lrsque l'autmate est démarré, il utilise un prt TCP dnt le numér est le numér du prt de base de la Sciété Dllar Universe (par défaut 10600) plus 16, sit par défaut Emplacement des fichiers Fichiers des Uprcs : Les scripts des Uprcs Web Services snt situés dans le répertire: <SOCIETE>\<espace>\upr. Ils snt écrits en XML. Le cdage du nm des Uprcs est décrit dans le Manuel d'administratin de Dllar Universe, sectin "Identifiants des bjets". Fichiers des ressurces : Les fichiers de descriptin des ressurces Web Services snt situés dans le sus-répertire data\res de la Sciété. Ils snt également écrits en XML. Jurnal du Manager : Le fichier jurnal du Manager est nmmé mgrjava.lg, il est situé dans le répertire lg de la Sciété. Jurnaux des exécutins : Cmme pur les autres types d'uprcs, les résultats d exécutin snt affichés dans le jurnal de l'uprc. Les traces d'exécutins du service web peuvent être inscrites par le Manager dans le jurnal d'exécutin de l'uprc si l'utilisateur a cnfiguré l'uprc pur cela. Jurnaux des ressurces Web Services Le jurnal de la ressurce est enregistré dans le sus-répertire lg\<espace> de la Sciété. Il est nmmé ${S_ESPEXE}${S_ID_UG}${S_ID_UPROC}RES.${S_NUMLANC}. Les traces d'exécutins du service web peuvent être inscrites par le Manager dans le jurnal de la ressurce si l'utilisateur a cnfiguré la cnditin de ressurce pur cela. 3.3 Mettre à jur Dllar Universe Manager pur Web Services La mise à jur de Dllar Universe v6 Manager pur Web Services est réalisée lrs de la mise à jur de Dllar Universe v6.

13 Chapitre 4 Cnfiguratin 13 4 Cnfiguratin 4.1 Administrer le Manager pur Web Services En mde Administratin d'univiewer Cnsle, les actins suivantes peuvent être effectuées sur le nœud Dllar Universe : Activer le Manager pur Java : le Manager pur Java est le supprt de tutes les pératins Java du nœud Dllar Universe, dnt le Manager pur Web Services. "Activer le Manager pur Web Services" page 13. Mdifier les "Paramètres du Manager pur Web Services" page 17. "Désactiver le Manager pur Web Services" page 15. "Désactiver le Manager pur Java " page 15 En mde Prductin d'univiewer Cnsle : Si Dllar Universe Manager pur Java est activé sur le nœud Dllar Universe : Suivi > Autmates pur afficher si le Manager est démarré u nn. L'autmate Java JEE ne peut être démarré que si Dllar Universe est démarré Activer le Manager pur Java Cette actin est valide si le Manager pur Java est installé mais n est pas actif. Cette actin permet d activer la gestin des pératins Java sur le nœud Dllar Universe. Elle permet également d'activer par la suite les Managers rattachés : EJB, JMS, Web Services, Oracle DB u Micrsft SQL Server. Dans UniViewer Cnsle, en mde Administratin, cliquez sur la sectin Nœuds > Nœuds. Sélectinnez le nœud Dllar Universe v6 et cliquez sur Mdifier. Dans la sectin Cnfiguratin Service, sélectinnez Manager Java, et cliquez sur Activer. Une fenêtre nmmée Activatin : Manager Java est affichée. Saisissez le numér de prt TCP, par défaut le numér de prt du serveur d'io X +16 est prpsé. Saisissez le chemin d'accès cmplet à une cmmande java valide (JRE/JDK), par exemple C:\Prgram Files\Java\jre7\bin\java.exe. Cliquez sur Activer. Une fenêtre "Traitement " affiche les actins en curs. Lrsque l'activatin est terminée ( Fait), vus puvez cliquer sur Fermer. Le message "Succès de la prcédure d'activatin" est affiché. Cliquez sur Ok et enregistrez les mdificatins du nœud DUAS. Lrs de l'activatin, l'autmate JEE est autmatiquement démarré Activer le Manager pur Web Services Cette actin est valide si le Manager pur Java est "Activé" et si le Manager pur Web Services est "Dispnible". Dans UniViewer Cnsle, en mde Administratin, cliquez sur la sectin Nœuds > Nœuds.

14 14 Chapitre 4 Cnfiguratin Sélectinnez le nœud Dllar Universe v6 et cliquez sur Mdifier. Dans la sectin Cnfiguratin Service, sélectinnez Manager Web Services, et cliquez sur Activer. Une fenêtre nmmée Activatin : Manager Web Services est affichée. Saisissez une Licence utilisateur valide. Si une licence de ce Manager existe déjà dans le fichier des licences du nœud Dllar Universe elle est affichée. Cliquez sur Activer. Une fenêtre "Traitement " affiche les actins en curs. Lrsque l'activatin est terminée (" Fait"), vus puvez cliquer sur Fermer. Le message "Succès de la prcédure d'activatin" est affiché. Cliquez sur Ok et enregistrez les mdificatins du nœud DUAS. Le statut du Manager devient "Activé" Licence utilisateur L utilisatin de Dllar Universe v6 Manager pur Web Services est sumise à une licence. La clé de la licence dit être déclarée dans le fichier des licences de Dllar Universe. Ce fichier %UNI_DIR_ROOT%\data\u_fali01.txt est créé par la prcédure d installatin. La licence peut être saisie : Par UniViewer Cnsle : mde Administratin > Nœuds > Nœuds, sélectinnez le nœud Dllar Universe v6 supprtant le Manager > Paramètres nœud > Licence. Ou directement par un éditeur de texte. Cette licence est spécifique au nm de nœud Dllar Universe sur lequel le Manager pur Web Services est situé. Le cde du prduit est WSC; la versin du prduit est 6. Saisissez la licence valide au frmat suivant : neud prduit versin date_expiratin clé DU6_neud DOLLAR_UNIVERSE:WSC ABCDEF La licence du Manager est testée lrs de la sumissin des jbs. Si Dllar Universe est en péride de grâce, une licence WSC n'est pas nécessaire. Si Dllar Universe pssède une licence, le Manager pur Web Services devra en psséder une également, sinn les jbs ne purrnt pas être sumis. Les clés de licence peuvent être btenues depuis le site web du Service Clients u par vtre cntact cmmercial Démarrer/Arrêter le Manager pur Java Dllar Universe Manager pur Java peut être démarré u arrêté avec UniViewer Cnsle : en mde Prductin, sélectinnez l envirnnement du nœud Dllar Universe sur lequel le Manager pur Java est activé. Puis sélectinnez Suivi > Autmates pur afficher la liste des autmates. Le Manager pur Java est nmmé JEE. Il peut être démarré u arrêté (seln sn statut). L'autmate JEE est aussi utilisé par le Manager pur Oracle Database, par le Manager pur SQL Server et par le Manager pur EJB/JMS. Si vus arrêtez l'autmate JEE vus puvez interrmpre l'activité de ces Managers. Le Manager ne peut être démarré que si Dllar Universe est démarré. Dllar Universe Manager pur Java peut être démarré u arrêté à l aide de l interface cmmandes. Reprtez-vus à la sectin "Démarrer/Arrêter le Manager pur Java " page 14.

15 Chapitre 4 Cnfiguratin Désactiver le Manager pur Web Services Si vus n'utilisez plus le Manager pur Web Services, vus puvez le désactiver pur libérer des ressurces. Cette actin n est pssible que si le Manager pur Web Services est actif. Si vus désactivez ce service, la gestin des pératins Web Services définis pur ce nœud Dllar Universe sera interrmpue. Dans UniViewer Cnsle, en mde Administratin, cliquez sur la sectin Nœuds > Nœuds. Sélectinnez le nœud Dllar Universe v6 et cliquez sur Mdifier. Dans la sectin Cnfiguratin Service, sélectinnez Manager Web Services, et cliquez sur Désactiver. Une fenêtre nmmée Désactivatin : Manager Web Services est affichée. Cliquez sur Désactiver. Une fenêtre "Traitement" affiche les actins en curs. Lrsque la désactivatin est terminée, le message "Traitement Fait" est affiché. Cliquez sur Fermer. Le message "Succès de la prcédure de désactivatin" est affiché. Cliquez sur Ok et enregistrez les mdificatins du nœud Dllar Universe. La licence du Manager est cnservée dans le fichier des licences de Dllar Universe Désactiver le Manager pur Java Cette actin n est pssible que si le Manager pur Java est actif. Si vus désactivez ce service, la gestin des pératins Java définis pur ce nœud Dllar Universe sera interrmpue. La désactivatin du Manager pur Java désactive tus les managers rattachés : EJB, JMS, Web Services, Oracle DB et Micrsft SQL Server. Dans UniViewer Cnsle, en mde Administratin, cliquez sur la sectin Nœuds > Nœuds. Sélectinnez le nœud Dllar Universe v6 et cliquez sur Mdifier. Dans la sectin Cnfiguratin Service, sélectinnez Manager Java, et cliquez sur Désactiver. Une fenêtre nmmée Désactivatin : Manager Java est affichée. Cliquez sur Désactiver. Une fenêtre "Traitement " affiche les actins en curs. Lrsque la désactivatin est terminée (" fait"), vus puvez cliquer sur Fermer. Le message "Succès de la prcédure de désactivatin" est affiché. Cliquez sur Ok et enregistrez les mdificatins du nœud Dllar Universe. 4.2 Paramètres nœud du Manager pur Java Le tableau suivant décrit les variables du Manager. Ces variables snt définies dans les Paramètres nœud > Manager pur Java du nœud Dllar Universe v6 supprtant le Manager. Cmme pur Dllar Universe, les variables du Manager snt de type Install (I), Statique (S) u Dynamique (D). Les variables du Manager liées à l installatin de Dllar Universe ne peuvent pas être mdifiées. Elles snt de type Install (I). Les autres variables de type Statique u Dynamique peuvent être mdifiées avec UniViewer Cnsle u avec la cmmande unisetvar. La mdificatin de variables statiques ne sera prise en cmpte qu'après le redémarrage du Manager pur Java. Les variables dynamiques snt prises en cmpte par le Manager sans avir à le redémarrer.

16 16 Chapitre 4 Cnfiguratin Variable / Nm I/S/D Descriptin UXJEE_MINJVMMEM Taille mémire initiale de la zne heap (Mctets) UXJEE_MAXJVMMEM Taille mémire maximum de la zne heap (Mctets) S Valeur par défaut 128 S Valeur par défaut 128 UXJEE_DIR_ROOT Répertire racine du manager Java UXJEE_DIR_EXEC Répertire des binaires du manager Java UXJEE_DIR_DATA Répertire des dnnées du manager Java UXJEE_DIR_LOG Répertire des lgs du manager Java U_LOG_JAVA_LOG4J_FILE Fichier de cnfiguratin lg4j U_LOG_JAVA_LOG_FILE Fichier jurnal du manager java U_LOG_JAVA_LOG_LEVEL Niveau du jurnal du Manager Java I I I I I I D!UNI_DIR_ROOT! Crrespnd au répertire racine de la Sciété Dllar Universe.!UNI_DIR_EXEC!\bin_java Répertire cntenant les exécutables et utils du Manager. Crrespnd à UXJEE_DIR_ROOT/bin/bin_java!UNI_DIR_DATA!\data_java Répertire cntenant tutes les dnnées gérées par le Manager. Crrespnd à UXJEE_DIR_ROOT/data/data_java!UNI_DIR_LOG! Crrespnd au répertire des jurnaux de la Sciété Dllar Universe!UXJEE_DIR_DATA!\lg4j.xml!UXJEE_DIR_LOG!\mgrjava.lg FATAL : erreurs fatales uniquement ERROR : tutes les erreurs WARN : tutes les erreurs et les avertissements INFO (valeur par défaut) : tutes les erreurs, les avertissements et les infrmatins TRACE : tutes les erreurs, les avertissements, les infrmatins et les messages de trace DEBUG : tus les messages U_LOG_JAVA_MAX_SIZE_LOG_FILE Taille maximum du fichier jurnal Java (M) U_LOG_JAVA_ARCH_MAX_NB Nmbre maximum de fichiers jurnaux Java archivés S Minimum 1, valeur par défaut 100 D Minimum 0, valeur par défaut 1 UXJEE_JAVA_EXE Chemin d'accès à la cmmande "java" pur le démarrage du Manager Java D Valeur par défaut "java" Chemin d'accès cmplet à une cmmande java valide (JRE/JDK), par exemple C:\Prgram Files\Java\jdk1.6.0_20\bin\java.exe. UXJEE_SSL_SESSION_CACHE_SIZE Taille du cache de sessins SSL UXJEE_MAIN_MIN_POOL_SIZE Nmbre minimum de threads dans le pl de threads principal UXJEE_MAIN_MAX_POOL_SIZE Nmbre maximum de threads dans le pl de threads principal UXJEE_MAIN_POOL_QUEUE_SIZE Taille de la queue du pl de threads principal (0 pur une taille illimitée) D Valeur par défaut 100 S Minimum 0, valeur par défaut 5 S Minimum 1, valeur par défaut 20 S Minimum 0, valeur par défaut 200 UXJEE_MAIN_POOL_KEEP_ALIVE Temps limite en secndes pendant lequel les S Minimum 0, valeur par défaut 120 secndes

17 Chapitre 4 Cnfiguratin 17 Variable / Nm I/S/D Descriptin threads du pl principal peuvent rester actifs UXJEE_SUBMISSION_MIN_POOL_SIZE Nmbre minimum de threads dans le pl de threads de sumissin UXJEE_SUBMISSION_MAX_POOL_SIZE Nmbre maximum de threads dans le pl de threads de sumissin UXJEE_SUBMISSION_POOL_QUEUE_SIZE Taille de la queue du pl de threads de sumissin (0 pur une taille illimitée) UXJEE_SUBMISSION_POOL_KEEP_ALIVE Temps limite en secndes pendant lequel les threads du pl de sumissin peuvent rester actifs UXJEE_HTTP_CONNECTION_TIMEOUT Valeur du timeut sur cnnexin (en secndes) UXJEE_HTTP_READ_TIMEOUT Valeur du timeut pur attendre les dnnées (en secndes) S Minimum 0, valeur par défaut 1 S Minimum 1, valeur par défaut 100 S Minimum 0, valeur par défaut 100 S S S Minimum 0, valeur par défaut 120 secndes Temps maximum d'attente pur la créatin de la scket. Valeur par défaut 120 secndes Temps maximum d'attente pur une pératin de lecture. Valeur par défaut 120 secndes 4.3 Paramètres du Manager pur Web Services Les paramètres du Manager pur Web Services permettent de cnfigurer la cmmunicatin entre le Manager et les services web. En mde Administratin, affichez la liste des nœuds. Sélectinnez le nœud Dllar Universe v6 sur lequel le Manager Web Services est activé et cliquez Mdifier. Dans la sectin Cnfiguratin service, sélectinnez la ligne Manager Web Services et cliquez Paramètres du Manager. Pur définir l'un des paramètres u ajuter une valeur, sélectinnez l'une des sectins cidessus et cliquez sur le butn Ajuter u duble-cliquez sur une ligne vide. Seln le paramètre sélectinné, le dialgue est différent. Pur mdifier une valeur d'un paramètre, sélectinnez la sectin et le paramètre à mdifier et cliquez sur le butn Mdifier u duble-cliquez sur la ligne à mdifier. Pur supprimer une valeur d'un paramètre, sélectinnez la sectin et le paramètre à mdifier et cliquez sur le butn Supprimer. Une cnfirmatin est demandée avant de supprimer la valeur du paramètre. N'ubliez pas de cliquer sur Enregistrer pur sauvegarder les mdificatins apprtées. La mdificatin des paramètres SOAP et REST ne nécessite pas le redémarrage du service JEE pur être pris en cmpte SOAP Cette liste cntient l'ensemble des services web utilisant le prtcle SOAP qui sernt invqués par des Uprcs u des ressurces de type "Web Services SOAP". Des paramètres snt nécessaires au Manager pur invquer un service web SOAP et réceptinner la répnse; ils snt décrits ci-dessus.

18 18 Chapitre 4 Cnfiguratin Dans la barre d'utils, le butn Recharger WSDL permet de télécharger à nuveau le fichier de cnfiguratin WSDL des services web sélectinnés dans le cas ù ceux-ci auraient été mdifiés sur le serveur web Service web SOAP - Sectin Général Nm : nm du service web SOAP (limité à 64 caractères) tel qu'il sera invqué dans l'uprc u la ressurce. URL de la descriptin : URL du fichier de cnfiguratin WSDL du service web à invquer. Ce fichier sera téléchargé dans le sus-répertire thirdparty de la Sciété. En cas de mdificatin du fichier sur le serveur web, il devra être téléchargé à nuveau à l'aide du butn Recharger WSDL de la barre d'utils. Récursins max par éléments : nmbre de récursins autrisées pur un élément puvant cntenir un fils de même type. Au-delà de cette prfndeur, les fils snt ignrés dans l aide à la saisie des dnnées de l Uprc. Si un fichier WSDL était utilisé par le Manager et permettait d'exécuter des Uprcs et des ressurces de type Web Service SOAP et si ce fichier est mdifié (s'il cmprte une erreur, si des pératins snt supprimées, etc.) il ne sera pas pssible de revenir à la dernière bnne cnfiguratin cnnue Service web SOAP - Sectin Variables persnnalisées Cette liste cntient l'ensemble des variables persnnalisées pur ce Web Service qui purrnt être utilisées dans les Uprcs et les ressurces sus la frme :!VARIABLE!. Pur ajuter une nuvelle variable, cliquez sur le butn Ajuter u duble-cliquez sur une ligne vide. Dans la fenêtre "Ajut / Mdificatin d'une variable glbale", les champs suivants snt affichés : Variable : saisissez le nm de la variable en majuscules (limité à 64 caractères). Reprtezvus au Manuel de Référence de Dllar Universe, sectin "Utilisatin de variables dans la ligne de cmmande" pur plus de détails sur l'utilisatin des variables. Type : chisissez le type de la variable entre Chaîne et Mt de passe. Le type de la variable détermine le mde d'affichage de la valeur de la variable. Valeur: saisissez la valeur de la variable. La valeur d'une variable de type Chaîne est affichée en clair. La valeur d'une variable de type Mt de passe est cryptée. Des caractères * snt affichés lrs de la saisie, dans le fichier de stckage (fichier ws_sap_services.xml dans le sus-répertire UXJEE_DIR_DATA) et lrs de sn utilisatin. Si cette variable existe déjà dans les variables glbales du Manager, la valeur indiquée ici écrasera la valeur de la variable glbale. Reprtez-vus à la sectin "Variables" page 8. Lrs de la mdificatin d'une variable, seule sa valeur peut être mdifiée. Cliquez sur OK pur valider la créatin u la mdificatin, u sur Annuler pur fermer la fenêtre sans rien mdifier Service web SOAP - Sectin Cnfiguratin http Encdage : définit l'encdage du cntenu du message XML. Sélectinnez dans la liste le type d'encdage utilisé par le service web (liste nn exhaustive des cdages supprtés). Keystre : Cchez la case "Utilisez le keystre " pur spécifier le keystre/truststre à utiliser dans cas d une cnnexin https. Puis dans le champ Keystre sélectinnez un keystre qui aura été préalablement défini dans les paramètres "Keystres/Truststres" du Manager.

19 Chapitre 4 Cnfiguratin 19 Laissez la case " Utilisez le keystre " décchée si vus n utilisez pas https u si vus suhaitez utiliser le truststre par défaut du JRE Service web SOAP - Sectin Entêtes http Cette liste définit les entêtes http qui purrnt être ajutés par défaut lrs de l'invcatin du service web par l'uprc u la ressurce. Cliquez sur Ajuter pur ajuter un entête, sélectinnez une ligne et cliquez sur Mdifier pur mdifier la valeur d'un entête u cliquez sur Supprimer pur supprimer l'entête sélectinné. Nm : saisissez le nm de l'entête qui sera ajutée par défaut au message Valeur : saisissez sa valeur Service web SOAP - Sectin Cnfiguratin WS Security srtante Cette liste permet de définir les paramètres de sécurité pur les requêtes du Manager à destinatin du service web. Le service web visé dit supprter la nrme WSS. Cette cnfiguratin est ptinnelle si le service web visé n exige pas explicitement un cntenu sécurisé à l aide de WSS. Pur ajuter une nuvelle sécurité, cliquez sur le butn Ajuter. Plusieurs chix snt pssibles et cumulables : Hrdatage, Jetn d'utilisateur, Signature u Chiffrement. Seln l'ptin chisie, les infrmatins saisies snt différentes. Service web SOAP - Sectin Cnfiguratin WS Security srtante Hrdatage Cette cnfiguratin permet d'hrdater le message et de lui définir une durée de validité. Durée de vie : saisissez la durée de validité du message en secndes. Précisin : cchez cette case si la précisin demandée est la millisecnde. Dans le cas cntraire une précisin à la secnde sera appliquée. Service web SOAP - Sectin Cnfiguratin WS-Security srtante Jetn d'utilisateur Cette cnfiguratin permet d'ajuter un cntrôle sur l'utilisateur/mt de passe. Nm de l'utilisateur : saisissez le nm de l'utilisateur Mt de passe de l'utilisateur : saisissez le mt de passe de l'utilisateur. Il est autmatiquement crypté dans la cnfiguratin du Manager, mais il sera envyé en clair si la représentatin est "Text". Représentatin du mt de passe : chisissez la méthde de transmissin du mt de passe : Text (en clair), Digest (hachage) u Digest ext (hachage étendu). Ajuter un élément nnce : ajute une partie générée aléatirement dans le jetn Ajuter la date de créatin : ajuter la date de créatin du jetn. Service web SOAP - Sectin Cnfiguratin WS-Security srtante Signature Cette cnfiguratin permet de signer le message émis. La signature est générée à partir d'un keystre et d'un alias. Cette fenêtre détermine les infrmatins nécessaires au service web pur analyser la signature. Les valeurs affichées par les butns d'aide aux valeurs réalisée u celles supprtées par le Manager. snt issues de la cnfiguratin déjà Keystre : sélectinnez dans la liste le keystre qui dit avir été préalablement défini dans la sectin "Keystres/Truststres" des paramètres du Manager. Alias : sélectinnez dans la liste le nm du certificat appruvé dans le keystre qui sera utilisé pur la cnnexin.

20 20 Chapitre 4 Cnfiguratin Type d'indentificatin : tris types d'identifiant de clé peuvent être chisis : Binary security tken : BST_IDENTIFIER Issuer name and serial number : ISSUER_SERIAL Subject key identifier : SKI_KEY_IDENTIFIER Algrithme de signature: algrithmes de calcul de la signature. Les algrithmes supprtés snt les suivants : Algrithme RSA RSA_SHA1 RSA_SHA256 RSA_SHA384 RSA_SHA512 URL Algrithme de cannisatin : les cannisatins supprtées snt les suivantes : Cannisatin C14N_EXCL_OMIT_COMMENTS URL Algrithme de hachage: les algrithmes supprtés snt les suivants : Algrithme SHA1 SHA256 SHA384 SHA512 URL Certificat unique : La signature n utilisera pas la chaine cmplète de certificats (certificat + chaine de certificat CA), mais uniquement le certificat. Signer la ttalité du message : valeur par défaut, la signature est appliquée à tut le message Signer les parties suivantes : sélectinnez cette ptin pur n'appliquer la signature qu'aux espaces de nms indiqués dans la liste. Sélectinnez un champ dans la liste puis cliquez sur Mdifier pur le mdifier u sur Supprimer pur le supprimer. Cliquez sur Ajuter pur ajuter un champ dans la liste, les infrmatins suivantes divent être saisies : Nm : nm de la partie à signer Espace de nms : namespace crrespndant Méthde : sélectinnez Cntent pur signer le cntenu de l'élément u Element pur signer la ttalité de l'élément. Cliquez sur Ok pur valider les infrmatins saisies et ajuter un champ à la liste. Service web SOAP - Sectin Cnfiguratin WS-Security srtante Chiffrement Cette cnfiguratin permet de crypter le message émis. Le message est crypté à partir de la clé publique d'un keystre et d'un alias. Les valeurs affichées par les butns d'aide aux valeurs réalisée u celles supprtées par le Manager. snt issues de la cnfiguratin déjà

21 Chapitre 4 Cnfiguratin 21 Keystre : sélectinnez dans la liste le keystre qui dit avir été préalablement défini dans la sectin "Keystres/Truststres" des paramètres du Manager. Alias : sélectinnez dans la liste le nm du certificat appruvé dans le keystre qui sera utilisé pur la cnnexin. Type d'identificatin : plusieurs types d'identifiant de clé peuvent être chisis : Type d'identificatin BST_IDENTIFIER ENCRYPTED_KEY_SHA1_IDENTIFIER ISSUER_SERIAL SKI_KEY_IDENTIFIER THUMBPRINT_IDENTIFIER Descriptin Binary security tken Encrypted Key SHA1 Identifier Issuer name and serial number Subject key identifier Thumbprint SHA1 Identifier Les clés d'identificatin nn supprtées snt les suivantes : X509_KEY_IDENTIFIER EMBEDDED_KEYNAME EMBED_SECURITY_TOKEN_REF UT_SIGNING CUSTOM_SYMM_SIGNING CUSTOM_SYMM_SIGNING_DIRECT CUSTOM_KEY_IDENTIFIER Algrithme de cdage symétrique : sélectinnez un algrithme de cryptage dans la liste des algrithmes supprtés : Algrithme de cdage symétrique AES_128_CBC AES_192_CBC AES_256_CBC TRIPLE_DES URL Pur utiliser les algrithmes de cryptage symétriques AES_192_CBC et AES_256_CBC, il est nécessaire de cnfigurer la machine virtuelle Java de la machine hébergeant le Manager en installant l extensin : Java Cryptgraphy Extensin (JCE). Ceci dit aussi être réalisé sur la machine hébergeant le web service si celui-ci utilise la machine virtuelle Java. Algrithme de chiffrement : sélectinnez un algrithme de cryptage de la clé dans la liste des algrithmes supprtés : Algrithme de chiffrement KEYTRANSPORT_RSA15 KEYTRANSPORT_RSAOEP URL Ajut de la clé : cchez cette case pur ajuter la clé générée par le Manager dans le message. Chiffrer la ttalité du message : valeur par défaut, la signature est appliquée à tut le message Chiffrer les parties suivantes : sélectinnez cette ptin pur n'appliquer la signature qu'aux Espaces de nms indiqués dans la liste.

22 22 Chapitre 4 Cnfiguratin Imprtant : dans ce cas, les parties désignées divent figurer dans la sectin Paramètres d'entrée de tutes les Uprcs et ressurces de type SOAP. Sélectinnez un champ dans la liste puis cliquez sur Mdifier pur le mdifier u sur Supprimer pur le supprimer. Cliquez sur Ajuter pur ajuter un champ dans la liste, les infrmatins suivantes divent être saisies : Nm : nm de l'élément à signer Espace de nms : nm du namespace à signer Méthde : sélectinnez Cntent pur signer uniquement le cntenu de la balise u Element pur signer le cntenu et la balise. Cliquez sur Ok pur valider les infrmatins saisies et ajuter un champ à la liste Service web SOAP - Sectin Cnfiguratin WS-Security Entrante Ces paramètres définissent la sécurité pur les cmmunicatins du service web vers le Manager (répnse à une requête du Manager). Cette cnfiguratin n'est bligatire que si le service web visé est susceptible d envyer une répnse sécurisée par WSS. Tus les champs snt ptinnels. Keystre pur la signature : sélectinnez dans la liste le keystre, utilisé pur le calcul de la signature, qui dit avir été préalablement défini dans la sectin "Keystres/Truststres" des paramètres du Manager. Keystre pur le décryptage : sélectinnez dans la liste le keystre, utilisé pur le cryptage du message, qui dit avir été préalablement défini dans la sectin "Keystres/Truststres" des paramètres du Manager. Nm du jetn utilisateur : saisissez le nm de l'utilisateur pur le cntrôle du jetn utilisateur du message reçu. Mt de passe du jetn utilisateur: saisissez sn mt de passe REST Cette liste cntient l'ensemble des services web utilisant le prtcle REST qui sernt invqués par des Uprcs u des ressurces de type "Web Services REST". Des paramètres snt nécessaires au Manager pur invquer un service web REST et réceptinner la répnse; ils snt décrits ci-dessus Service web REST - Sectin Général Nm : nm du Web Service REST (limité à 64 caractères) tel qu'il sera invqué dans l'uprc u la ressurce URL de référence : URL de base du service web qui sera cmplétée lrs de l'invcatin du service dans l'uprc u la ressurce. Les paramètres de l'url ne divent pas être saisis dans ce champ mais dans le tableau de la sectin "Service web REST - Sectin Paramètres d'url par défaut" page 23. Nmbre maximum de redirectins : nmbre maximum de redirectins autrisées si l'url de base renvie sur une autre URL (si un cde 3xx est renvyé) Service web REST - Sectin Variables persnnalisées Cette liste cntient l'ensemble des variables persnnalisées pur ce Web Service qui purrnt être utilisées dans les Uprcs et les ressurces sus la frme :!VARIABLE!.

23 Chapitre 4 Cnfiguratin 23 Pur ajuter une nuvelle variable, cliquer sur le butn Ajuter u duble-cliquez sur une ligne vide. Dans la fenêtre "Ajut / Mdificatin d'une variable glbale", les champs suivants snt affichés : Variable : saisissez le nm de la variable en majuscules (limité à 64 caractères). Reprtezvus au Manuel de Référence de Dllar Universe, sectin "Utilisatin de variables dans la ligne de cmmande" pur plus de détails sur l'utilisatin des variables. Type : chisissez le type de la variable entre Chaîne et Mt de passe. Le type de la variable détermine le mde d'affichage de la valeur de la variable. Valeur: saisissez la valeur de la variable. La valeur d'une variable de type Chaîne est affichée en clair. La valeur d'une variable de type Mt de passe est cryptée. Des caractères * snt affichés lrs de la saisie, dans le fichier de stckage (fichier ws_rest_services.xml dans le sus-répertire UXJEE_DIR_DATA) et lrs de sn utilisatin. Si cette variable existe déjà dans les variables glbales du Manager, la valeur indiquée ici écrasera la valeur de la variable glbale. Reprtez-vus à la sectin "Variables" page 8. Lrs de la mdificatin d'une variable, seule sa valeur peut être mdifiée. Cliquez sur OK pur valider la créatin u la mdificatin, u sur Annuler pur fermer la fenêtre sans rien mdifier Service web REST - Sectin Cnfiguratin http Encdage : définit l'encdage du cntenu du message. Sélectinnez dans la liste le type d'encdage utilisé par le service web (liste nn exhaustive des cdages supprtés). Keystre : Cchez la case "Utilisez le keystre " pur spécifier le keystre/truststre à utiliser dans cas d une cnnexin https. Puis dans le champ Keystre sélectinnez un keystre qui aura été préalablement défini dans les paramètres "Keystres/Truststres" du Manager. Laissez la case " Utilisez le keystre " décchée si vus n utilisez pas https u si vus suhaitez utiliser le truststre par défaut du JRE Service web REST - Sectin Entêtes par défaut Cette liste définit les entêtes http qui purrnt être ajutés par défaut lrs de l'invcatin du service web par l'uprc u la ressurce. Cliquez sur Ajuter pur ajuter un entête, sélectinnez une ligne et cliquez sur Mdifier pur mdifier la valeur d'un entête u cliquez sur Supprimer pur supprimer l'entête sélectinné. Nm : saisissez le nm de l'entête qui sera ajuté par défaut au message Valeur : saisissez sa valeur Service web REST - Sectin Paramètres d'url par défaut Liste les paramètres qui sernt ajutés à l'url. La valeur définie par défaut purra être écrasée par la valeur définie dans la ressurce u dans l'uprc. Sélectinnez une ligne et cliquez sur Mdifier pur mdifier la valeur par défaut d'un paramètre u cliquez sur Supprimer pur supprimer le paramètre sélectinné. Cliquez sur Ajuter pur ajuter un nuveau paramètre et sa valeur par défaut, les infrmatins suivantes divent être saisies : Name : nm du paramètre qui sera ajuté à l'url Value : valeur par défaut du paramètre.

24 24 Chapitre 4 Cnfiguratin Le paramètre et sa valeur sernt encdés autmatiquement pur s'appliquer à l'url lrs de l'invcatin du service web Keystres/Truststres Tus les keystres utilisés pur la sécurité des messages (https, signature et cryptage) divent être déclarés dans cette liste. Nm : saisissez le nm du keystre Chemin : saisissez le chemin cmplet du fichier cntenant les certificats Mt de passe du keystre : saisissez le mt de passe nécessaire à l'accès au keystre Alias : si plusieurs certificats snt cntenus dans ce keystre, il faut ajuter un alias et sn mt de passe par certificat. Sélectinnez une ligne et cliquez sur Mdifier pur mdifier le mt de passe u cliquez sur Supprimer pur supprimer l'alias sélectinné. Cliquez sur Ajuter pur ajuter un nuvel alias et sn mt de passe. Vérifier les mts de passe : cliquez sur ce butn pur tester le mt de passe du keystre et le mt de passe de chaque alias déclaré. Si certains alias existent dans le keystre mais n'nt pas été déclarés dans le manager, leur mt de passe n'est pas testé. Le manager différencie un keystre/alias inaccessible (le fichier n'existe pas, n'a pas les drits de lecture u n'est pas un keystre) et un mt de passe faux (u un keystre/alias crrmpu u qui ne respecte pas le frmat attendu) Variables glbales Cette liste cntient l'ensemble des variables glbales du Manager qui purrnt être utilisées dans les Uprcs et les ressurces sus la frme :!VARIABLE!. Pur ajuter une nuvelle variable, cliquer sur le butn Ajuter u duble-cliquez sur une ligne vide. Dans la fenêtre "Ajut / mdificatin d'une variable glbale", les champs suivants snt affichés : Variable : saisissez le nm de la variable en majuscules (limité à 64 caractères). Reprtezvus au Manuel de Référence de Dllar Universe, sectin "Utilisatin de variables dans la ligne de cmmande" pur plus de détails sur l'utilisatin des variables. Type : chisissez le type de la variable entre Chaîne et Mt de passe. Le type de la variable détermine le mde d'affichage de la valeur de la variable. Valeur: saisissez la valeur de la variable. La valeur d'une variable de type Chaîne est affichée en clair. La valeur d'une variable de type Mt de passe est cryptée. Des caractères * snt affichés lrs de la saisie, dans le fichier de stckage (fichier ws_glbal_variables.xml dans le sus-répertire UXJEE_DIR_DATA) et lrs de sn utilisatin. Lrs de la mdificatin d'une variable, seule sa valeur peut être mdifiée. Cliquez sur OK pur valider la créatin u la mdificatin, u sur Annuler pur fermer la fenêtre sans rien mdifier.

25 Chapitre 4 Cnfiguratin Jurnalisatin du Manager pur Web Services Dllar Universe Manager pur Web Services génère des traces afin d aider l administrateur à identifier et résudre des prblèmes éventuels. Vus puvez activer le mde trace du Manager en mdifiant le Paramètre nœud du nœud Dllar Universe > catégrie Manager pur Java > Niveau du jurnal du Manager Java (U_LOG_JAVA_LOG_LEVEL). Les traces snt enregistrées dans le fichier jurnal du Manager nmmé par défaut mgrjava.lg; il est situé dans le répertire lg de la Sciété. Pur afficher le fichier jurnal du Manager, dans UniViewer Cnsle, en mde Administratin, uvrez le dcument Nœuds > Nœuds. Sélectinnez le nœud Dllar Universe v6 et cliquez sur Trace > Jurnal du Manager pur Java.

26 26 Chapitre 5 UniViewer Cnsle 5 UniViewer Cnsle UniViewer Cnsle permet de gérer les Uprcs et les ressurces Web Services : Une Uprc de type SOAP dit être créée dans Dllar Universe pur invquer un service Web SOAP. Une Uprc de type REST dit être créée dans Dllar Universe pur invquer un service Web REST. Une ressurce de type SOAP dit être créée dans Dllar Universe pur se synchrniser sur l'exécutin d'un service web SOAP. Une ressurce de type REST dit être créée dans Dllar Universe pur se synchrniser sur l'exécutin d'un service web REST. 5.1 Caractéristiques cmmunes Expressins régulières Les expressins régulières peuvent être utilisées pur tester le cntenu d'une prpriété, d'un élément u de la répnse. La ttalité du cntenu demandé dit valider l expressin régulière, même si celui-ci pssède plusieurs lignes. Par exemple, pur valider que le cntenu demandé cntient au mins une fis le terme "OK", l expressin régulière dit être la suivante : ".*OK.*". Les expressins régulières utilisées snt de type DOT_ALL, cela signifie que le caractère "." peut crrespndre à un retur à la ligne. Tut caractère puvant présenter une ambiguïté (par exemple?) dit être prtégé par un \ (par exemple : \?) pur ne pas être utilisé cmme une expressin régulière Caractères spéciaux Sus XML, certains caractères divent être prtégés pur ne pas être interprétés par le langage; ces caractères snt les suivants : Caractère " &qut ' > &lt Valeur prtégée &aps < &gt & &amp Chacun de ces caractères sera écrit en utilisant la valeur prtégée à l'intérieur du jurnal de l'exécutin, mais l'utilisateur dit utiliser la valeur nn prtégée pur tester le statut de l'exécutin (service web SOAP u REST si le bdy de la répnse cntient du XML) dans la définitin de l'uprc u dans la définitin de la cnditin de la ressurce.

27 Chapitre 5 UniViewer Cnsle Uprcs de type Web Services Créer une nuvelle Uprc requiert un minimum d'infrmatins : le nm de l'uprc, l'applicatin assciée et le type d'uprc. Sélectinnez le type WS_REST u WS_SOAP puis cliquez sur Editer pur cnfigurer l'invcatin de du service web REST u SOAP Uprcs de type Web Services SOAP Tus les paramètres nécessaires à l'invcatin d'un service web SOAP peuvent être saisis à partir de cette fenêtre. Les paramètres cmmuns au service web nt été saisis dans les paramètres SOAP du Manager. Pur alimenter les champs suivants, saisissez le nm u cliquez sur la flèche un élément dans une liste u sur l'aide aux valeurs dispnibles. pur afficher le détail des éléments pur sélectinner Cliquez sur OK pur enregistrer les paramètres et fermer la fenêtre, puis cliquez sur Enregistrer dans la fenêtre de l'uprc pur enregistrer l'uprc Web Service SOAP Uprc SOAP Sectin Général Cette sectin permet de sélectinner l'pératin SOAP que l'uprc va exécuter. Service SOAP : cliquez sur la flèche pur sélectinner un service web dans la liste. Cette liste prvient des services SOAP déclarés dans les paramètres du Manager. (Administratin > Nœuds > Nœuds > Nœud DU6 supprtant le Manager > Mdifier, dans la sectin Cnfiguratin service, sélectinner Manager Web Services et cliquez Paramètres du Manager puis sélectinnez la catégrie SOAP, reprtez-vus au paragraphe "SOAP" page 17). Opératin : cliquez sur Parcurir pur afficher l'arbre des pératins définies dans le fichier WSDL du service web, puis sélectinnez le service à exécuter. Les champs Prt et Service snt autmatiquement renseignés avec les valeurs extraites du fichier WSDL. Si le fichier WSDL a été mis à jur dans les paramètres du Manager, les infrmatins de l'uprc ne snt pas mises à jur autmatiquement Uprc SOAP Sectin Cnfiguratin spécifique Cette sectin permet de rediriger éventuellement l'appel http différemment de la cnfiguratin du fichier WSDL. Utiliser la destinatin par défaut : utilise l'url définie par défaut dans le fichier WSDL (reprtez-vus au paragraphe "SOAP" page 17). L'avantage de cette méthde est de centraliser la définitin de l'url en un seul pint (dans les paramètres du service SOAP), si elle dit être mdifiée, les Uprcs ne snt pas tuchées. Spécifier une nuvelle destinatin : sélectinnez cette ptin pur spécifier une URL différente de celle définie par défaut dans le fichier WSDL. Des variables peuvent être utilisées dans ce champ, elles sernt substituées par Dllar Universe puis par le manager lrs de l'invcatin du service web. Reprtez-vus à la sectin "Variables" page 8.

28 28 Chapitre 5 UniViewer Cnsle Uprc SOAP Sectin Statut Cette sectin permet de définir le statut de l'uprc en fnctin de la répnse du service web. Ce statut peut ensuite être écrasé par le statut avancé de l'uprc. Terminé si : l'utilisateur peut définir l'un u l'autre des critères suivants pur que l'uprc web service SOAP renvie un statut Terminé à l'autmate : La répnse ne cntient pas d'élément Fault : la répnse ne cntient pas d'élément XML Fault, la gestin du statut est laissée au Manager. XPath : récupère le cntenu du chemin sélectinné dans la répnse du service web. Expressin XPath: cntenu chemin/valeur d'un nœud u d'un attribut. Si l'expressin dit cibler un élément d'un tableau, la syntaxe suivante dit être utilisée (quelle que sit la psitin de l'élément dans l'arbre) : //Name[n] Name étant le nm du tableau et n étant le nième élément du tableau (>0). Si le cntenu sélectinné crrespnd à plusieurs éléments u à un élément pssédant des enfants, la valeur returnée sera la cncaténatin du cntenu des éléments. Le message cntient l'élément désiré : l'élément demandé existe dans la répnse mais sn cntenu n'est pas analysé. Le cntenu de l'élément crrespnd à l'expressin régulière suivante : la ttalité du cntenu de l élément demandé dit valider l expressin régulière du champ suivant, même si celui-ci pssède plusieurs lignes. Reprtez-vus au paragraphe "Expressins régulières" page 26. Par exemple, si la répnse est : <S:Envelpe xmlns:s=" <S:Bdy> <ns2:addbkrespnse xmlns:ns2=" <return>9</return> </ns2:addbkrespnse> </S:Bdy> </S:Envelpe> Le XPath /Envelpe/Bdy/addBkRespnse/return renvie la valeur 9. Les caractères spéciaux divent être saisis tels quels, reprtez-vus au paragraphe "Caractères spéciaux" page Uprc SOAP Sectin Paramètres d'entrée Cette sectin présente tus les paramètres bligatires et facultatifs du service dans l'arbrescence XML. La significatin des clnnes est la suivante : Nm : nm de l'élément Min : nmbre minimum de paramètres de ce type. La valeur 0 indique que le paramètre est facultatif, une valeur 1 u supérieure indique que ce paramètre est bligatire. Max : nmbre maximum de paramètres de ce type. Type : du paramètre issu du fichier WSDL affiché à titre indicatif Valeur : valeur du paramètre. Des variables peuvent être utilisées dans ce champ, elles sernt substituées par Dllar Universe puis par le manager lrs de l'invcatin du service web. Reprtez-vus à la sectin "Variables" page 8. Lrs de la créatin de l'uprc, les paramètres facultatifs n'apparaissent qu'une seule fis dans l'arbrescence même si l'utilisateur peut en indiquer plusieurs. Dans ce cas, pur ajuter :

29 Chapitre 5 UniViewer Cnsle 29 un élément, sélectinnez l'élément parent et cliquez sur le butn Ajuter un enfant, saisissez l'élément en le sélectinnant dans la liste et cliquez sur Ok. L'utilisateur ne peut ajuter que les éléments déclarés dans le fichier WSDL. un attribut à un élément, sélectinnez l'élément et cliquez sur le butn Ajuter un attribut, saisissez l'attribut en le sélectinnant dans la liste et cliquez sur Ok. L'utilisateur ne peut ajuter que les attributs déclarés dans le fichier WSDL. Pur mdifier la valeur d'un élément u d'un attribut, sélectinnez-le dans la liste et cliquez sur Mdifier. Le nm de l'élément et sn Espace de nms (issu du fichier WSDL) snt affichés, saisissez u mdifiez sa valeur dans le champ Valeur; si des valeurs snt prédéfinies dans le fichier WSDL, elles apparaissent en cliquant sur u. Un paramètre facultatif peut être supprimé : sélectinnez le paramètre dans la liste et cliquez sur Supprimer; une cnfirmatin sera demandée avant tute suppressin effective Uprc SOAP Sectin Valeurs de srtie Cette sectin permet de définir ce que dit prduire l'uprc lrs de sa terminaisn : la prpagatin de tutes les variables au sein de la sessin la prpagatin de certaines variables au sein de la sessin la trace de la requête et de la répnse SOAP dans le jurnal de l'exécutin Pur prpager tutes les variables reçues par l'uprc à l'uprc suivante au sein de la Sessin, cchez la case Prpager tutes les variables reçues en entrée par l'uprc dans la srtie de l'uprc. Si la case n'est pas cchée, les variables ne snt pas transmises. Pur ne prpager qu'un sus-ensemble des variables reçues par l'uprc à l'uprc suivante au sein de la sessin, u pur prpager une partie du résultat de la répnse du service web curant à l'uprc suivante, définissez les variables à prpager dans le tableau Srties persnnalisées. Cliquez sur Ajuter pur ajuter une nuvelle variable : Si la variable a été reçue par l'uprc, indiquez sn nm dans le champ Variable et sélectinnez Depuis l'envirnnement dans le champ Type d'expressin. Le champ Expressin XPath est sans bjet. Si la variable dit être créée à partir d'une expressin issue de la répnse du service Web, saisissez sn nm dans le champ Variable, sélectinnez XPath dans le champ Type d'expressin et chisissez l'expressin qui valrisera la variable dans la liste Expressin XPath. Sus UNIX/Linux, le nm des variables ne dit pas cmmencer par un chiffre (restrictin du système d'explitatin). Inclure la requête et la répnse SOAP dans la trace système : cchez cette case pur afficher tutes les infrmatins sur la requête et la répnse du service web dans le jurnal d'exécutin de l'uprc (trace système) Uprcs de type Web Services REST Tus les paramètres nécessaires à l'invcatin d'un service web REST peuvent être saisis à partir de cette fenêtre. Les paramètres cmmuns au service web nt été saisis dans les paramètres REST du Manager. Cliquez sur Ok pur enregistrer les paramètres et fermer la fenêtre, puis cliquez sur Enregistrer dans la fenêtre de l'uprc pur enregistrer l'uprc Web Service REST.

30 30 Chapitre 5 UniViewer Cnsle Uprc REST Sectin REST Général Cette sectin permet de sélectinner l'pératin REST que l'uprc va exécuter. Service REST: cliquez sur la flèche pur sélectinner un service web dans la liste. Cette liste prvient des services REST déclarés dans les paramètres du Manager. (Administratin > Nœuds > Nœuds > Nœud DU6 supprtant le Manager > Mdifier, dans la sectin Service Cnfiguratin, sélectinner Manager Web Services et cliquez Paramètres du Manager puis sélectinnez la catégrie REST, reprtez-vus au paragraphe "REST" page 22). Ressurce HTTP: cmplément de l'url de base indiquée dans la définitin du service web REST au paragraphe "Service web REST - Sectin Général" page 22. Des variables peuvent être utilisées dans ce champ, elles sernt substituées par le Dllar Universe puis par manager lrs de l'invcatin du service web. Reprtez-vus à la sectin "Variables" page 8. Les paramètres de l'url ne divent pas être saisis dans ce champ mais dans le tableau de la sectin "Uprc REST Sectin Paramètres d'url" page 30. Méthde HTTP: sélectinnez dans la liste la méthde utilisée par le service web Uprc REST Sectin Entêtes Tris types d'entêtes http snt utilisés par un service web REST : Les entêtes implicites qui snt gérés directement par le Manager. L'utilisateur n'a pas besin de les saisir mais ils apparaissent dans le jurnal d'exécutin de l'uprc. Cntent_type : type de cntenu User_Agent : (fixe) client du service Accept_Encding : (fixe) gzip, deflate Les entêtes par défaut définis pur ce service web dans les paramètres du Manager (reprtez-vus au paragraphe "Service web REST - Sectin Entêtes par défaut" page 23), n'apparaissent pas dans ce tableau Les entêtes qui peuvent être ajutés par l'uprc lrs de l'invcatin du service web. Si ces entêtes existent déjà dans les paramètres du manager, la valeur définie dans l'uprc écrase celle définie dans les paramètres du manager. Pur ajuter un entête, cliquez sur Ajuter puis saisissez sn nm et sa valeur. Cchez la case Ignrer les valeurs par défaut pur ne pas prendre en cmpte les entêtes définis par défaut dans le service REST (Service web REST - Sectin Entêtes par défaut) lrs de l'exécutin de l'uprc Uprc REST Sectin Paramètres d'url Les paramètres de l'url peuvent être définis à plusieurs niveaux : Dans les paramètres du Manager, pur le Service web REST - Sectin Paramètres d'url par défaut Dans ce tableau Le paramètre et sa valeur sernt encdés autmatiquement pur s'appliquer à l'url lrs de l'invcatin du service web. Si des paramètres définis dans ce tableau existent déjà dans les paramètres d'url du service web REST, la valeur définie ici écrasera la valeur définie dans les paramètres du Manager. Pur ajuter un paramètre, cliquez sur Ajuter puis saisissez sn nm et sa valeur.

31 Chapitre 5 UniViewer Cnsle 31 Cchez la case Ignrer les valeurs par défaut pur ne pas prendre en cmpte les paramètres d'url définis par défaut dans le service REST (Service web REST - Sectin Paramètres d'url par défaut) lrs de l'exécutin de l'uprc Uprc REST Sectin Paramètres du fichier Cette sectin ne s'affiche que si le service web utilise les méthdes POST u PUT. Elle permet de jindre un fichier en paramètre à la requête. Pur ajuter un paramètre, cliquez sur Ajuter puis saisissez le nm du paramètre et le nm cmplet du fichier lcal à transmettre avec la requête. Seul le chemin du fichier est listé dans le jurnal de l'exécutin Uprc REST Sectin Cntenu de la requête Cette sectin ne s'affiche que si le service web utilise les méthdes POST u PUT. Elle permet de définir des infrmatins pur la requête (par exemple envyer du JSON u du XML). Aucun : cchez cette case si aucune infrmatin cmplémentaire ne dit être transmise avec la requête. Cdage URL : cchez cette ptin pur que le cntenu sit cdé seln un frmat URL (applicatin/x-www-frm-urlencded) lrs de l'envi de la requête. Saisissez le nm du paramètre et sa valeur. Le Manager : 1. Substitue les variables (s'il y en a) 2. Cde les caractères spéciaux (y cmpris dans la valeur des variables). Tus les caractères spéciaux snt encdés par le Manager. Cntenu persnnalisé : saisissez les dnnées attendues par le service web au frmat attendu par le service web. Les caractères spéciaux divent être encdés par l'utilisateur. Le champ Type de cntenu dit cntenir le type de cntenu attendu par le service web. Si UniViewer Cnsle recnnait le cntenu au frmat URL (applicatin/x-www-frmurlencded) valide, il sera présenté dans le tableau Cdage URL lrs de la prchaine uverture de l'uprc. Des variables peuvent être utilisées dans ces deux champs, elles sernt substituées par Dllar Universe puis par le manager lrs de l'invcatin du service web. Reprtez-vus à la sectin "Variables" page Uprc REST Sectin Statut Cette sectin permet de définir le statut de l'uprc en fnctin de la répnse du service web. Ce statut peut ensuite être écrasé par le statut avancé de l'uprc. Terminé si : l'utilisateur peut définir les critères suivants pur que le Manager renvie un statut Terminé à l'autmate. Il faut que tus les critères sélectinnés sient vrais pur que le statut sit Terminé. Si aucune sélectin n'est effectuée, le statut sera Terminé si le Manager reçit une répnse du service web, quelle que sit la répnse. Si le Manager ne reçit pas de répnse au but du temps définit par le paramètre nœud UXJEE_HTTP_CONNECTION_TIMEOUT, le statut sera Incidenté. Le statut http est égal à : cchez cette case et saisissez les cdes retur http qui permettrnt à l'uprc de se terminer crrectement. XPath : récupère le cntenu du chemin sélectinné dans la répnse du service web. Expressin XPath : cntenu chemin/valeur d'un nœud u d'un attribut.

32 32 Chapitre 5 UniViewer Cnsle Si l'expressin dit cibler un élément d'un tableau, la syntaxe suivante dit être utilisée (quelle que sit la psitin de l'élément dans l'arbre) : //Name[n] Name étant le nm du tableau et n étant le nième élément du tableau (>0). Si le cntenu sélectinné crrespnd à plusieurs éléments, u à un élément pssédant des enfants, la valeur returnée sera la cncaténatin du cntenu des éléments La répnse cntient l'élément désiré : l'élément demandé existe dans la répnse mais sn cntenu n'est pas analysé. Le cntenu de l'élément crrespnd à l'expressin régulière suivante : la ttalité du cntenu de l élément demandé dit valider l expressin régulière du champ suivant, même si celui-ci pssède plusieurs lignes. Reprtez-vus au paragraphe "Expressins régulières" page 26. Par exemple, si la répnse est : <addbkrespnse> <return>9</return> </addbkrespnse> Le XPath /addbkrespnse/return renvie la valeur 9 JSON: récupère le cntenu de la prpriété sélectinnée dans la répnse du service web. Prpriété : nm de la prpriété recherchée dans la répnse du service web. La répnse cntient la prpriété désirée : l'élément demandé existe dans la répnse mais sn cntenu n'est pas analysé. Le cntenu de la prpriété crrespnd à l'expressin régulière suivante : la ttalité du cntenu de l élément demandé dit valider l expressin régulière du champ suivant, même si celui-ci pssède plusieurs lignes. Reprtez-vus au paragraphe "Expressins régulières" page 26. Le cntenu de la répnse crrespnd à l'expressin régulière suivante : La ttalité de la répnse dit valider l expressin régulière du champ suivant, même si celle-ci pssède plusieurs lignes. Reprtez-vus au paragraphe "Expressins régulières" page 26. La répnse cntient les entêtes suivants : cette ptin permet de définir des règles d'analyse des entêtes http returnés dans la répnse du service web. Cliquez sur Ajuter pur définir une règle d'analyse sur un entête de la répnse. Saisissez le nm de l'entête, sélectinnez la méthde de cmparaisn et la valeur de cmparaisn. Attentin : tutes les règles définies divent être vraies pur que le statut de l'uprc sit Terminé. Le cumul de certaines règles n'a pas de sens (par exemple ccher XPath et JSON). Il revient à l'utilisateur de vérifier la chérence des règles définies Uprc REST Sectin Valeurs de srtie Cette sectin permet de définir ce que dit prduire l'uprc lrs de sa terminaisn : La prpagatin de tutes u de certaines variables d'héritage au sein de la sessin La créatin de nuvelles variables issues de la répnse du service web et leur prpagatin au sein de la sessin La trace de la requête et de la répnse HTTP dans le jurnal de l'exécutin Pur prpager tutes les variables reçues par l'uprc à l'uprc suivante au sein de la Sessin, cchez la case Prpager tutes les variables reçues en entrée par l'uprc dans la srtie de l'uprc. Si la case n'est pas cchée, les variables ne snt pas transmises. Pur ne prpager qu'un sus-ensemble des variables reçues par l'uprc à l'uprc suivante au sein de la sessin, u pur créer de nuvelles variables et prpager une partie du résultat de la répnse

33 Chapitre 5 UniViewer Cnsle 33 du service web curant à l'uprc suivante, définissez les variables à prpager dans le tableau Srties persnnalisées. Cliquez sur Ajuter pur ajuter une nuvelle variable : Si la variable a été reçue par l'uprc, indiquez sn nm dans le champ Variable et sélectinnez Depuis l'envirnnement dans le champ Type d'expressin. Le champ Expressin est sans bjet. Si la variable dit être valrisée en fnctin de la répnse du service Web, saisissez sn nm dans le champ Variable, sélectinnez dans le champ Type d'expressin : JSON pur récupérer la valeur de la prpriété désignée dans le champ Expressin, dans le cas ù la répnse est en JSON ENTETE pur récupérer la valeur du header désigné dans le champ Expressin STATUT HTTP pur récupérer le statut http returné par le service web. Le champ Expressin est sans bjet. XPATH pur récupérer la valeur du chemin désigné dans le champ Expressin, dans le cas ù la répnse est en XML Sus UNIX/Linux, le nm d'une variable ne dit pas cmmencer par un chiffre (restrictin du système d'explitatin). Inclure la requête et la répnse http dans la trace système : cchez cette case pur afficher dans le jurnal d'exécutin de l'uprc (trace système) tutes les infrmatins sur la requête et la répnse du service web. 5.3 Ressurces de type Web Services Deux types de ressurces Dllar Universe peuvent être créées pur synchrniser des Uprcs sur des services web SOAP u REST. La ressurce définit l'appel du service web, la cnditin de ressurce définit la répnse attendue. Lrsqu'une Uprc est en attente d'événement sur une ressurce de type web service, le service web est exécuté à la fréquence de la ressurce (sectin Paramètres > Fréquence dans la définitin de la ressurce) et la répnse du service web est analysée par le Manager à chaque exécutin du service web. Lrsque la répnse crrespnd à la cnditin définie dans l'uprc, l'attente d'événement est réslue et le service web n'est plus exécuté Ressurces de type Web Services SOAP Créez une ressurce. Dans la sectin Général indiquez sn nm, sa descriptin et sélectinnez le type SOAP. Les infrmatins sur le service web SOAP snt saisies dans les sectins décrites cidessus Ressurce SOAP Sectin SOAP général Cette sectin permet de sélectinner l'pératin SOAP que la ressurce va exécuter. Service SOAP : cliquez sur la flèche pur sélectinner un service web dans la liste. Cette liste prvient des services SOAP déclarés dans les paramètres du Manager. (Administratin > Nœuds > Nœuds > Nœud DU6 supprtant le Manager > Mdifier, dans la sectin Cnfiguratin service, sélectinner Manager Web Services et cliquez Paramètres du Manager puis sélectinnez la catégrie SOAP, reprtez-vus au paragraphe "SOAP" page 17).

34 34 Chapitre 5 UniViewer Cnsle Opératin : cliquez sur Parcurir pur afficher l'arbre des pératins définies dans le fichier WSDL du service web, puis sélectinnez le service à exécuter. Les champs Prt et Service snt autmatiquement renseignés avec les valeurs extraites du fichier WSDL. Si le fichier WSDL a été mis à jur dans les paramètres du Manager, les infrmatins de la ressurce ne snt pas mises à jur autmatiquement Ressurce SOAP Sectin Cnfiguratin spécifique Cette sectin permet de rediriger éventuellement l'appel http différemment de la cnfiguratin du fichier WSDL. Utiliser la destinatin par défaut : utilise l'url définie par défaut dans le fichier WSDL (reprtez-vus au paragraphe "SOAP" page 17). L'avantage de cette méthde est de centraliser la définitin de l'url en un seul pint (dans les paramètres du service SOAP), si elle dit être mdifiée, les ressurces ne snt pas tuchées. Spécifier une nuvelle destinatin : sélectinnez cette ptin pur spécifier une URL différente de celle définie par défaut dans le fichier WSDL. Des variables peuvent être utilisées dans ces deux champs, elles sernt substituées par Dllar Universe puis par le manager lrs de l'invcatin du service web. Reprtez-vus à la sectin "Variables" page Ressurce SOAP Sectin Paramètres d'entrée Cette sectin présente tus les paramètres bligatires et facultatifs du service dans l'arbrescence XML. La significatin des clnnes est la suivante : Nm : nm de l'élément Min : nmbre minimum de paramètres de ce type. La valeur 0 indique que le paramètre est facultatif, une valeur 1 u supérieure indique que ce paramètre est bligatire. Max : nmbre maximum de paramètres de ce type. Type : du paramètre issu du fichier WSDL affiché à titre indicatif Valeur : valeur du paramètre. Des variables peuvent être utilisées dans ce champ, elles sernt substituées par Dllar Universe puis par le manager lrs de l'invcatin du service web. Reprtez-vus à la sectin "Variables" page 8. Lrs de la créatin de la ressurce, les paramètres facultatifs n'apparaissent qu'une seule fis dans l'arbrescence même si l'utilisateur peut en indiquer plusieurs. Dans ce cas, pur ajuter : un élément, sélectinnez l'élément parent et cliquez sur le butn Ajuter un enfant, saisissez l'élément en le sélectinnant dans la liste et cliquez sur Ok. L'utilisateur ne peut ajuter que les éléments déclarés dans le fichier WSDL. un attribut à un élément, sélectinnez l'élément et cliquez sur le butn Ajuter un attribut, saisissez l'attribut en le sélectinnant dans la liste et cliquez sur Ok. L'utilisateur ne peut ajuter que les attributs déclarés dans le fichier WSDL. Pur mdifier la valeur d'un élément u d'un attribut, sélectinnez-le dans la liste et cliquez sur Mdifier. Le nm de l'élément et sn Espace de nms (issu du fichier WSDL) snt affichés, saisissez u mdifiez sa valeur dans le champ Value; si des valeurs snt prédéfinies dans le fichier WSDL, elles apparaissent en cliquant sur u. Un paramètre facultatif peut être supprimé; Sélectinnez le paramètre dans la liste et cliquez sur Supprimer; une cnfirmatin sera demandée avant tute suppressin effective.

35 Chapitre 5 UniViewer Cnsle Ressurces de type Web Services REST Créez une ressurce. Dans la sectin Général indiquez sn nm, sa descriptin et sélectinnez le type REST. Les infrmatins sur le service web REST snt saisies dans les sectins décrites cidessus Ressurce REST Sectin REST général Cette sectin permet de sélectinner l'pératin REST que la ressurce va exécuter. Service REST: cliquez sur la flèche pur sélectinner un service web dans la liste. Cette liste prvient des services REST déclarés dans les paramètres du Manager. (Administratin > Nœuds > Nœuds > Nœud DU6 supprtant le Manager > Mdifier, dans la sectin Cnfiguratin service, sélectinner Manager Web Services et cliquez Paramètres du Manager puis sélectinnez la catégrie REST, reprtez-vus au paragraphe "REST" page 22). Ressurce HTTP: cmplément de l'url de base indiquée dans la définitin du service web REST au paragraphe "Service web REST - Sectin Général" page 22. Des variables peuvent être utilisées dans ce champ, elles sernt substituées par Dllar Universe puis par le manager lrs de l'invcatin du service web. Reprtez-vus à la sectin "Variables" page 8. Les paramètres de l'url ne divent pas être saisis dans ce champ mais dans le tableau de la sectin "Uprc REST Sectin Paramètres d'url" page 30. Méthde HTTP: sélectinnez dans la liste la méthde utilisée par le service web Ressurce REST Sectin Entêtes Tris types d'entêtes http snt utilisés par un service web REST : Les entêtes implicites qui snt gérés directement par le Manager. L'utilisateur n'a pas besin de les saisir mais ils apparaissent dans le jurnal d'exécutin de la ressurce. Cntent_type : type de cntenu User_Agent : (fixe) client du service Accept_Encding : (fixe) gzip, deflate Les entêtes par défaut définis pur ce service web dans les paramètres du Manager (reprtez-vus au paragraphe "Service web REST - Sectin Entêtes par défaut" page 23), n'apparaissent pas dans ce tableau Les entêtes qui peuvent être ajutés par la ressurce lrs de l'invcatin du service web. Si ces entêtes existent déjà dans les paramètres du manager, la valeur définie dans la ressurce écrase celle définie dans les paramètres du manager. Pur ajuter un entête, cliquez sur Ajuter puis saisissez sn nm et sa valeur. Cchez la case Ignrer les valeurs par défaut pur ne pas prendre en cmpte les entêtes définis par défaut dans le service REST (Service web REST - Sectin Entêtes par défaut) lrs de l'exécutin de la ressurce Ressurce REST Sectin Paramètres d'url Les paramètres de l'url peuvent être définis à plusieurs niveaux : Dans les paramètres du Manager, pur le Service web REST - Sectin Paramètres d'url par défaut Dans ce tableau

36 36 Chapitre 5 UniViewer Cnsle Le paramètre et sa valeur sernt encdés autmatiquement pur s'appliquer à l'url lrs de l'invcatin du service web. Si des paramètres définis dans ce tableau existent déjà dans les paramètres d'url du service web REST, la valeur définie ici écrasera la valeur définie dans les paramètres du Manager. Pur ajuter un paramètre, cliquez sur Ajuter puis saisissez sn nm et sa valeur. Cchez la case Ignrer les valeurs par défaut pur ne pas prendre en cmpte les paramètres d'url définis par défaut dans le service REST (Service web REST - Sectin Paramètres d'url par défaut) lrs de l'exécutin de la ressurce Ressurce REST Sectin Paramètres du fichier Cette sectin ne s'affiche que si le service web utilise les méthdes POST u PUT. Elle permet de jindre un fichier en paramètre à la requête. Pur ajuter un paramètre, cliquez sur Ajuter puis saisissez le nm du paramètre et le nm cmplet du fichier lcal à transmettre avec la requête. Seul le chemin du fichier est listé dans le jurnal de l'exécutin Ressurce REST Sectin Cntenu de la requête Cette sectin ne s'affiche que si le service web utilise les méthdes POST u PUT. Elle permet de définir des infrmatins pur la requête (par exemple envyer du JSON u du XML). Aucun : cchez cette case si aucune infrmatin cmplémentaire ne dit être transmise avec la requête. Cdage URL : cchez cette ptin pur que le cntenu sit cdé seln un frmat URL (applicatin/x-www-frm-urlencded) lrs de l'envi de la requête. Saisissez le nm du paramètre et sa valeur. Le Manager : 1. Substitue les variables (s'il y en a) 2. Cde les caractères spéciaux (y cmpris dans la valeur des variables). Tus les caractères spéciaux snt encdés par le Manager. Cntenu persnnalisé : saisissez les dnnées attendues par le service web au frmat attendu par le service web. Les caractères spéciaux divent être encdés par l'utilisateur. Le champ Type de cntenu dit cntenir le type de cntenu attendu par le service web (par exemple text/plain). Si UniViewer Cnsle recnnait le cntenu au frmat URL (applicatin/x-www-frmurlencded) valide, il sera présenté dans le tableau Cdage URL lrs de la prchaine uverture de l'uprc. Des variables peuvent être utilisées dans ces champs, elles sernt substituées par Dllar Universe puis par le manager lrs de l'invcatin du service web. Reprtez-vus à la sectin "Variables" page Cnditinner une Uprc sur une ressurce web service La cnditin sur une ressurce de type web service cntient des éléments permettant de tester la répnse du service web. A ce titre, les sectins suivantes de la cnditin de ressurce snt spécifiques aux ressurces web services REST et SOAP.

37 Chapitre 5 UniViewer Cnsle Cnditin de ressurce web service Sectin Ressurce Inclure la requête et la répnse http dans la trace ressurce : cchez cette case pur inclure la trace de l'exécutin du service web dans le jurnal de la ressurce Cnditin de ressurce web service Sectin Statut Cette sectin permet de définir les règles pur valider la cnditin de ressurce en fnctin de la répnse du service web. Terminé si : Il faut que tus les critères sélectinnés sient vrais pur que la cnditin sit validée. La répnse ne cntient pas d'élément Fault : (ressurce SOAP uniquement) la répnse ne cntient pas d'élément XML Fault, la gestin du statut est laissée au Manager. Le statut http est égal à : (ressurce REST uniquement) cchez cette case et saisissez les cdes retur http qui permettrnt à la cnditin de ressurce d'être validée. XPath: récupère le cntenu du chemin sélectinné dans la répnse du service web. Expressin XPath : cntenu chemin/valeur d'un nœud u d'un attribut. Si l'expressin dit cibler un élément d'un tableau, la syntaxe suivante dit être utilisée (quelle que sit la psitin de l'élément dans l'arbre) : //Name[n] Name étant le nm du tableau et n étant le nième élément du tableau (>0). Si le cntenu sélectinné crrespnd à plusieurs éléments, u à un élément pssédant des enfants, la valeur returnée sera la cncaténatin du cntenu des éléments La répnse cntient l'élément désiré : l'élément demandé existe dans la répnse mais sn cntenu n'est pas analysé. Le cntenu de l'élément crrespnd à l'expressin régulière suivante : la ttalité du cntenu de l élément demandé dit valider l expressin régulière du champ suivant, même si celui-ci pssède plusieurs lignes. Reprtez-vus au paragraphe "Expressins régulières" page 26. Par exemple, si la répnse est : <S:Envelpe xmlns:s=" <S:Bdy> <ns2:addbkrespnse xmlns:ns2=" <return>9</return> </ns2:addbkrespnse> </S:Bdy> </S:Envelpe> Le XPath /Envelpe/Bdy/addBkRespnse/return renvie la valeur 9 Les caractères spéciaux divent être saisis tels quels, reprtez-vus au paragraphe "Caractères spéciaux" page 26. JSON: (ressurce REST uniquement) récupère le cntenu de la prpriété sélectinnée dans la répnse du service web. Prpriété: nm de la prpriété recherchée dans la répnse du service web. La répnse cntient la prpriété désirée : l'élément demandé existe dans la répnse mais sn cntenu n'est pas analysé. Le cntenu de la prpriété crrespnd à l'expressin régulière suivante : la ttalité du cntenu de la prpriété demandé dit valider l expressin régulière du champ suivant, même si celui-ci pssède plusieurs lignes. Reprtez-vus au paragraphe "Expressins régulières" page 26.

38 38 Chapitre 5 UniViewer Cnsle Le cntenu de la répnse crrespnd à l'expressin régulière suivante : (ressurce REST uniquement) La ttalité de la répnse dit valider l expressin régulière du champ suivant, même si celle-ci pssède plusieurs lignes. Reprtez-vus au paragraphe "Expressins régulières" page 26. La répnse cntient les entêtes suivants : (ressurce REST uniquement) cette ptin permet de définir des règles d'analyse des entêtes http returnés dans la répnse du service web. Cliquez sur Add pur définir une règle d'analyse sur un entête de la répnse. Saisissez le nm de l'entête, sélectinnez la méthde de cmparaisn et la valeur de cmparaisn. Attentin : tutes les règles définies divent être vraies pur que le statut de l'uprc sit Terminé. Le cumul de certaines règles n'a pas de sens (par exemple ccher XPath et JSON). Il revient à l'utilisateur de vérifier la chérence des règles définies. 5.5 Exécuter un service web à l'aide de Dllar Universe Exécuter un service web Pur exécuter un service web SOAP, l'utilisateur dit le déclarer dans les paramètres "SOAP" du manager et créer une Uprc de Type Web Service SOAP sur ce service web. Pur exécuter un service web REST, l'utilisateur dit le déclarer dans les paramètres "REST" du manager et créer une Uprc de Type Web Service SOAP sur ce service web. Puis, il suffit de créer un lancement de la nuvelle Uprc à partir d'univiewer Cnsle > mde Prductin > Suivi > Exécutins jbs. Cmme pur les autres types d'uprcs, les résultats d exécutin snt affichés dans le lg de l'uprc. Le jurnal d'exécutin de l'uprc peut cntenir les traces de l'invcatin du service web si l'utilisateur a cnfiguré l'uprc pur cela (reprtez-vus aux sectins "Uprc SOAP Sectin Valeurs de srtie" u "Uprc REST Sectin Valeurs de srtie"). La terminaisn de l'uprc dépend du paramétrage qui a été défini par l'utilisateur dans la sectin "Uprc SOAP Sectin Statut" u "Uprc REST Sectin Statut", ce statut puvant être écrasé par le statut avancé de l'uprc. Jurnal d'exécutin d'une Uprc WS_SOAP ayant un statut Terminé _!================================================ _!** $!** PROCEDURE.. : DOLLAR_UNIVERSE_WS $!** VERSION...: 000 $!** EXECUTION.. : _!** _!** PROCESS DATE : 07/31/2013 _!** _! $!** PARAMETERS. : Nne _! _!** VARIABLES _! $!** INHERITANCE VARIABLES _!================================================ Request t manager: successful. WS SOAP jb status: OK.

39 Chapitre 5 UniViewer Cnsle 39 >>>>>>> request >>>>>>> [HTTP Infmatin] Endpint: Headers: Cntent-Type: text/xml SapActin: "" [/HTTP Infmatin] [SOAP Transfer lg] <?xml versin="1.0" encding="utf-8"?> <SOAP-ENV:Envelpe xmlns:soap- ENV=" <SOAP-ENV:Header/> <SOAP-ENV:Bdy> <p1:lgin xmlns:p1=" <p1:uvms> <p1:uvmshst>lcalhst</p1:uvmshst> <p1:uvmsprt>4184</p1:uvmsprt> <p1:uvmsuser>admin</p1:uvmsuser> <p1:uvmspasswrd>*****</p1:uvmspasswrd> </p1:uvms> </p1:lgin> </SOAP-ENV:Bdy> </SOAP-ENV:Envelpe> [/SOAP Transfer lg] <<<<<<< respnse <<<<<<< [HTTP Infmatin] Http Status: 200 [/HTTP Infmatin] [SOAP Transfer lg] <?xml versin="1.0" encding="utf-8"?> <sap:envelpe xmlns:sap=" <sap:bdy> <ns2:lginrespnse xmlns:ns2=" <ns2:tken>35a5849a9253c83d3f </ns2:tken> </ns2:lginrespnse> </sap:bdy> </sap:envelpe> [/SOAP Transfer lg] La requête et la répnse snt séparées dans deux sectins distinctes Jurnal d'exécutin d'une Uprc WS_REST ayant un statut Terminé _!================================================ _!** $!** PROCEDURE.. : ECA_REST_OK $!** VERSION...: 001 $!** EXECUTION.. : _!** _!** PROCESS DATE : 07/29/2013 _!** _! $!** PARAMETERS. : Nne _! _!** VARIABLES _! $!** INHERITANCE VARIABLES _!================================================ Request t manager: successful. WS REST jb status: OK. >>>>>>> request >>>>>>> [HTTP Transfer lg] GET /Sme/Resurce/get/jsn HTTP/1.1 header_by_rest_service: value f header by REST service and a bcdefghijklmnpqrstuvwxyz @+)&~"'{'([- `_^@)]=+}{([ `_,?.;/:!$\ User-Agent: Dllar Universe HTTP client / (build 1) Accept-Encding: gzip,deflate Hst: lcalhst:9080

40 40 Chapitre 5 UniViewer Cnsle Cnnectin: Keep-Alive [/HTTP Transfer lg] <<<<<<< respnse <<<<<<< [HTTP Transfer lg] HTTP/ OK Server: Apache-Cyte/1.1 Cntent-Type: applicatin/jsn Transfer-Encding: chunked Date: Mn, 29 Jul :21:17 GMT {"blist":[{"year":"2005","title":{"title":"everyday Italian","lang":"en"},"categry":"COOKING","authr":["Giada De Laurentiis"],"price":"30.00"},{"year":"2005","title":{"title":"Harry Ptter","lang":"en"},"categry":"CHILDREN","authr":["J K. Rwling"],"price":"29.99"},{"year":"2003","title":{"title":"XQuery Kick Start","lang":"en"},"categry":"WEB","authr":["James McGvern","Per Bthner","Kurt Cagle","James Linn","Vaidyanathan Nagarajan"],"price":"49.99"},{"year":"2003","title":{"title":"Everyday Italian","lang":"en"},"categry":"COOKING","authr":["Erik T. Ray"],"price":"39.99"}]} [/HTTP Transfer lg] La requête et la répnse snt séparées dans deux sectins distinctes Jurnal d'exécutin d'une Uprc WS_SOAP ayant un statut Incidenté _!================================================ _!** $!** PROCEDURE.. : QA_SOAP_TS295_PARSE_XPATH_DU_LOGIN_BADPWD_03_KO_NUM $!** VERSION...: 001 $!** EXECUTION.. : _!** _!** PROCESS DATE : 08/29/2013 _!** _! $!** PARAMETERS. : Nne _! _!** VARIABLES _! $!** INHERITANCE VARIABLES _!================================================ Request t manager: successful. WS SOAP jb status: KO. Errr message: The value [200] f the element [/Envelpe/Bdy/Fault/detail/DuwsExceptin/errrCde] des nt match the expected regex [400] >>>>>>> request >>>>>>> [HTTP Infmatin] Endpint: Headers: Cntent-Type: text/xml SapActin: "" value f header by SOAP service and a bcdefghijklmnpqrstuvwxyz @+)&~"'{'([- `_^@)]=+}{([ `_,?.;/:!$\: value f header by SOAP service and a bcdefghijklmnpqrstuvwxyz @+)&~"'{'([- `_^@)]=+}{([ `_,?.;/:!$\ [/HTTP Infmatin] [SOAP Transfer lg] <?xml versin="1.0" encding="utf-8"?> <SOAP-ENV:Envelpe xmlns:soap- ENV=" <SOAP-ENV:Header/> <SOAP-ENV:Bdy> <p1:lgin xmlns:p1=" <p1:uvms> <p1:uvmspasswrd>bad_pwd</p1:uvmspasswrd>

41 Chapitre 5 UniViewer Cnsle 41 <p1:uvmsuser>admin</p1:uvmsuser> <p1:uvmshst>frstm2k8ws01.rsyptst.cm</p1:uvmshst> <p1:uvmsprt>4184</p1:uvmsprt> </p1:uvms> </p1:lgin> </SOAP-ENV:Bdy> </SOAP-ENV:Envelpe> [/SOAP Transfer lg] <<<<<<< respnse <<<<<<< [HTTP Infmatin] Http Status: 500 [/HTTP Infmatin] [SOAP Transfer lg] <?xml versin="1.0" encding="utf-8"?> <sap:envelpe xmlns:sap=" <sap:bdy> <sap:fault> <faultcde>sap:server</faultcde> <faultstring>cm.rsyp.universeexceptin: cm.rsyp.std.icnnectinexceptin: Access denied: Invalid passwrd-> Cause exceptin message: Access denied: Invalid passwrd</faultstring> <detail> <ns1:duwsexceptin xmlns:ns1=" <errrcde xmlns:ns2=" xmlns:xs=" xmlns:xsi=" xsi:type="xs:int">200</errrcde> </ns1:duwsexceptin> </detail> </sap:fault> </sap:bdy> </sap:envelpe> [/SOAP Transfer lg] Se synchrniser sur l'exécutin d'un service Web Pur se synchrniser sur l'exécutin d'un service web SOAP, il faut le déclarer dans les paramètres "SOAP" du manager, créer une ressurce de Type Web Service SOAP sur ce service web, et cnditinner une Uprc sur cette ressurce. Pur se synchrniser sur l'exécutin d'un service web REST, il faut le déclarer dans les paramètres "REST" du manager, créer une ressurce de Type Web Service REST sur ce service web, et cnditinner une Uprc sur cette ressurce. Puis, il suffit de créer un lancement de cette Uprc à partir d'univiewer Cnsle > mde Prductin > Suivi > Exécutins jbs. Lrsque l'uprc est en attente d'exécutin du service web de la ressurce, la trace autmate affiche les infrmatins relatives à l'événement attendu. Exemple de trace autmate de l'uprc pur l'attente d'une ressurce web service SOAP Start Cnditin Check Mdified directly in the Engine by peratr : administratr Prcessing Date Resurce Cnd. 001 Prp. 01 : Resu.: ECA_SOAP WSP Missing *** Task launch refused *** Lrsque la cnditin de ressurce sur le service web a été réslue, l'utilisateur peut afficher le jurnal de la ressurce pur afficher les différentes étapes hrdatées de la réslutin de la cnditin.

42 42 Chapitre 5 UniViewer Cnsle Ce jurnal peut cntenir les traces de l'invcatin du service web si l'utilisateur a cnfiguré la cnditin de ressurce pur cela (reprtez-vus à la sectin Cnditin de ressurce web service Sectin Ressurce). Exemple de jurnal d'une ressurce de type web service SOAP :25:58 QA_SOAP_TS312_RES_CST_VAR_DU_GETLISTUPROC_ Scan Number 1 Checking SOAP resurce >>>>>>> request >>>>>>> [HTTP Infmatin] Endpint: Headers: Cntent-Type: text/xml SapActin: "" [/HTTP Infmatin] [SOAP Transfer lg] <?xml versin="1.0" encding="utf-8"?><soap-env:envelpe xmlns:soap- ENV=" <SOAP-ENV:Header/> <SOAP-ENV:Bdy> <p1:getlistuprc xmlns:p1=" <p1:cntext> <p1:tken>263a44e7c171bcdba </p1:tken> <p1:cntext> <p1:envir> <p1:cmpany>du6wsm</p1:cmpany> <p1:nde>frstm2k8ws01</p1:nde> <p1:area>x</p1:area> <p1:status/> <p1:versin/> </p1:envir> </p1:cntext> </p1:cntext> <p1:filter> <p1:uprc>uproc_cst_var_01</p1:uprc> </p1:filter> </p1:getlistuprc> </SOAP-ENV:Bdy> </SOAP-ENV:Envelpe>[/SOAP Transfer lg] <<<<<<< respnse <<<<<<< [HTTP Infmatin] Http Status: 200 [/HTTP Infmatin] [SOAP Transfer lg] <?xml versin="1.0" encding="utf-8"?><sap:envelpe xmlns:sap=" <sap:bdy> <ns2:getlistuprcrespnse xmlns:ns2=" <ns2:uprclist> <ns2:ident> <ns2:uprc>uproc_cst_var_01</ns2:uprc> <ns2:uprcversin>000</ns2:uprcversin> </ns2:ident> <ns2:label/> <ns2:dmain>i</ns2:dmain> <ns2:applicatin>u_</ns2:applicatin> </ns2:uprclist> </ns2:getlistuprcrespnse> </sap:bdy> </sap:envelpe>[/soap Transfer lg] :25:58 QA_SOAP_TS312_RES_CST_VAR_DU_GETLISTUPROC_ Scan Number 1 SOAP resurce cnditin is valid :25:59 QA_SOAP_TS312_RES_CST_VAR_DU_GETLISTUPROC_ Scan Number 2 Checking SOAP request result

43 Chapitre 5 UniViewer Cnsle :25:59 QA_SOAP_TS312_RES_CST_VAR_DU_GETLISTUPROC_ Scan Number 2 Check OK Le jurnal de la ressurce est nmmé ${S_ESPEXE}${S_ID_UG}${S_ID_UPROC}RES.${S_NUMLANC} et est situé dans le répertire des jurnaux de l'espace.

44 44 Chapitre 6 Cmmandes 6 Cmmandes Les cmmandes utilisées pur créer de nuvelles ressurces et cnditinner des Uprcs sur ces ressurces snt les cmmandes habituelles de Dllar Universe. Seules les spécificités liées au Manager pur Web Services snt présentées ci-après. A la différence d'univiewer Cnsle qui centralise des infrmatins dans les paramètres du Manager, les mettant ensuite à dispsitin des utilisateurs pur la cnceptin des Uprcs et des ressurces, le mde cmmande ne dispse pas d'aide à la saisie, tutes les infrmatins nécessaires divent dnc être saisies pur cibler le service web requis. Reprtez-vus au manuel de l'interface Cmmandes de Dllar Universe pur plus de détails sur les spécificatins générales des cmmandes. 6.1 Créer une Uprc Web Service SOAP La cmmande uxadd UPR ajute une Uprc à la liste des Uprcs. Le type d'uprc (UPT) dit être SOAP. uxadd UPR EXP UPR=SOAP_UPR LABEL=\"My SOAP web service\" UPT=SOAP FPERIOD=D APPL=WS MEMO=O NBPER=1 Plusieurs cmmandes uxupd UPR snt nécessaires pur créer une Uprc SOAP cmplète. La première partie de la cmmande est identique à la cmmande uxupd UPR standard (elle est utilisée pur sélectinner une Uprc particulière) : Item Frmat Défaut NODE= 64c S_NOEUD EXP SIM INT APP 3c S_ESPEXE UPR= 64c * VUPR= 3n * Plusieurs familles de paramètres snt nécessaires à la définitin des paramètres de l'uprc SOAP : Familles Cmplément Descriptin SOAP SOAP_CONF SOAP_STATUS SOAP_INPUT SOAP_OUTPUT add upd dlt Infrmatins générales bligatires sur le service web et l'uprc SOAP Cnfiguratin spécifique du service web Règles de gestin du statut de l'uprc Dnnées en entrée du service web Gestin des dnnées en srtie de l'uprc Ajut de dnnées en srtie Mdificatin des dnnées en srtie Suppressin de dnnées en srtie Uprc SOAP Infrmatins générales SOAP : infrmatins générales du service web SOAP. Tutes les infrmatins en gras snt bligatires.

45 Chapitre 6 Cmmandes 45 WSID= 512 c Nm du service tel qu'il est défini dans les paramètres du Manager WSOPR= 512 c Opératin du service web WSSERVICE= 512 c Nm du service web WSNAMESPACE= 512 c Espace de nms du service web WSPORT= 512 c Numér de prt utilisé par le service web TRACE= ON OFF OFF Saisissez la valeur ON pur afficher tutes les infrmatins sur la requête et la répnse du service web dans le jurnal d'exécutin de l'uprc (trace système) uxupd UPR EXP UPR=SOAP_UPR SOAP WSID="Web Services DU" WSOPER=lgin WSSERVICE=DUWebServices WSNAMESPACE=DUNamespace WSPORT=DUWebServicesPrt TRACE=ON Uprc SOAP Cnfiguratin spécifique SOAP_CONF : cnfiguratin spécifique du service web SOAP CONF= 512 c Utilisez cet item pur spécifier une URL différente de celle définie par défaut dans le fichier WSDL. Des Variables peuvent être utilisées dans ce champ sus la frme!var!, elles sernt substituées par Dllar Universe puis par le manager lrs de l'invcatin du service web uxupd UPR EXP UPR=SOAP_UPR SOAP_CONF CONF= Uprc SOAP Statut SOAP_STATUS : règles de calcul du statut de l'uprc en fnctin de la répnse du service web. Ce statut peut ensuite être écrasé par le statut avancé de l'uprc. NOFAULT EXIST MATCH NOFAULT NOFAULT : le service web n'a pas returné d'erreur, la gestin du statut est laissée au Manager. EXIST : utilisable avec XPATH uniquement MATCH : utilisable avec XPATH et REGEX XPATH= path Incmpatible avec NOFAULT Saisissez le cntenu du chemin d'un nœud u d'un attribut. Récupère dans la répnse du service web le cntenu du chemin saisi. Utilisé avec EXIST : l'élément demandé dit exister dans la répnse mais sn cntenu n'est pas analysé Utilisé avec MATCH : l'élément demandé dit exister dans la répnse et sn cntenu dit crrespndre à l'expressin régulière REGEX

46 46 Chapitre 6 Cmmandes REGEX= regex Incmpatible avec NOFAULT Saisissez une expressin régulière. Reprtez-vus au paragraphe "Expressins régulières" page 26. Utilisable avec MATCH uniquement : le cntenu de l'élément demandé dit crrespndre à l'expressin régulière indiquée. Les caractères spéciaux divent être saisis tels quels, reprtezvus au paragraphe "Caractères spéciaux" page 26. uxupd UPR EXP UPR=SOAP_UPR SOAP_STATUS EXIST XPATH=//result Uprc SOAP Dnnées en entrée SOAP_INPUT : dnnées en entrée du service web SOAP INPUT= 512 c Nm cmplet du fichier au frmat XML décrivant tus les paramètres en entrée nécessaires au service web. Des Variables peuvent être utilisées dans ce champ, elles sernt substituées par Dllar Universe puis par le manager lrs de l'invcatin du service web. Le frmat du fichier est décrit ci-dessus. uxupd UPR EXP UPR=SOAP_UPR SOAP_INPUT INPUT=C:\temp\SOAP_INPUT.xml Frmat du fichier : <rt> <header> <leaf name="" namespace="" value="" /> </header> <bdy> <nde name="" namespace=""> <leaf name="" namespace="" value="" /> <attribute name="" value="" /> <leaf name="" namespace="" value="" /> <nde name="" namespace=""> <leaf name="" namespace="" value="" /> </nde> </nde> <leaf name="" namespace="" value="" /> </bdy> </rt> Uprc SOAP Dnnées en srtie SOAP_OUTPUT : gestin des variables d'héritage

47 Chapitre 6 Cmmandes 47 KEEP_INPUT= ON OFF ON Si rien n'est spécifié (ON), les variables d'héritages reçues en entrée de l'uprc snt autmatiquement prpagées à l'uprc suivante de la sessin. Il est tutefis pssible d'ajuter des variables d'héritage dans l'uprc (ADD), de les mdifier (UPD) u de les supprimer (DLT). OFF : interrmpt l'héritage de tutes les variables au sein de la sessin. Il est tutefis pssible avec des cmmandes ADD de chisir manuellement quelles variables divent être prpagées. uxupd UPR EXP UPR=SOAP_UPR SOAP_OUTPUT KEEP_INPUT=OFF ADD : ajuter une variable en srtie de l'uprc NAME= 512 c Nm de la nuvelle variable TYPE= ENV XPATH Si la variable a été reçue par l'uprc, saisissez ENV (par exemple pur prpager une variable d'héritage dans le cas u KEEP_INPUT=OFF). Saisissez XPATH pur récupérer la valeur du chemin désigné dans VALUE VALUE= 512 c Utilisable avec XPATH uniquement. Saisissez le nm du chemin Sus UNIX/Linux, le nm des variables ne dit pas cmmencer par un chiffre (restrictin du système d'explitatin). uxupd UPR EXP UPR=SOAP_UPR SOAP_OUTPUT ADD NAME=TOKEN TYPE=XPATH VALUE=lcatin UPD : mdifie une variable en srtie de l'uprc NAME= 512 c Nm de la variable à mdifier TYPE= ENV XPATH Saisissez ENV pur une variable reçue par l'uprc. Saisissez XPATH pur récupérer la valeur du chemin désigné dans VALUE VALUE= 512 c Utilisable avec XPATH uniquement. Saisissez le nm du chemin uxupd UPR EXP UPR=SOAP_UPR SOAP_OUTPUT UPD NAME=TOKEN TYPE=XPATH VALUE=rtObject.security.tken DLT : supprime une variable en srtie de l'uprc NAME= 512 c Nm de la variable dnt l'héritage dit être interrmpu uxupd UPR EXP UPR=SOAP_UPR SOAP_OUTPUT DLT NAME=TOKEN 6.2 Créer une Ressurce Web Service SOAP La cmmande uxadd RES ajute une ressurce à la liste des ressurces.

48 48 Chapitre 6 Cmmandes La nature de la ressurce dit être SOAP. La fréquence (exprimée en secndes) crrespnd à la fréquence d'exécutin du service web par le Manager lrsqu'une Uprc est en attente d'événement sur cette ressurce jusqu'à ce que la cnditin de ressurce sit validée. uxadd RES RES=SOAP_RES LABEL=\"My SOAP web service\" NATURE=SOAP FREQ=120 Plusieurs cmmandes uxupd RES snt nécessaires pur créer une ressurce SOAP cmplète. La première partie de la cmmande est identique à la cmmande uxupd RES standard (elle est utilisée pur sélectinner une ressurce particulière) : Item Frmat Défaut NODE= 64c S_NOEUD RES= 64c * Plusieurs familles de paramètres snt nécessaires à la définitin des paramètres de la ressurce SOAP : Familles SOAP SOAP_CONF SOAP_INPUT Descriptin Infrmatins générales bligatires sur le service web Cnfiguratin spécifique du service web Dnnées en entrée du service web Ressurce SOAP Infrmatins générales SOAP : infrmatins générales du service web SOAP. Tutes ces infrmatins snt bligatires. WSID= 512 c Nm du service tel qu'il est défini dans les paramètres du Manager WSOPR= 512 c Opératin du service web WSSERVICE= 512 c Nm du service web WSNAMESPACE= 512 c Namespace du service web WSPORT= 512 c Numér de prt utilisé par le service web uxupd RES RES=SOAP_RES SOAP WSID="Web Services DU" WSOPER=lgin WSSERVICE=DUWebServices WSNAMESPACE=namespace WSPORT=DUWebServicesPrt Ressurce SOAP Cnfiguratin spécifique SOAP_CONF : cnfiguratin spécifique du service web SOAP CONF= 512 c Utilisez cet item pur spécifier une URL différente de celle définie par défaut dans le fichier WSDL. uxupd RES RES=SOAP_RES SOAP_CONF CONF=

49 Chapitre 6 Cmmandes Ressurce SOAP Dnnées en entrée SOAP_INPUT : dnnées en entrée du service web SOAP INPUT= 512 c Nm cmplet du fichier au frmat XML décrivant tus les paramètres en entrée nécessaires au service web. Le frmat du fichier est décrit ci-dessus. uxupd RES RES=SOAP_RES SOAP_INPUT INPUT=C:\temp\SOAP_INPUT.xml Frmat du fichier : <rt> <header> <leaf name="" namespace="" value="" /> </header> <bdy> <nde name="" namespace=""> <leaf name="" namespace="" value="" /> <attribute name="" value="" /> <leaf name="" namespace="" value="" /> <nde name="" namespace=""> <leaf name="" namespace="" value="" /> </nde> </nde> <leaf name="" namespace="" value="" /> </bdy> </rt> 6.3 Cnditinner une Uprc sur une ressurce Web Service SOAP Pur cnditinner l'exécutin d'une Uprc (quelcnque) par le résultat d'exécutin d'un service web SOAP, il faut : Créer une ressurce Web Service SOAP pur ce service web (sectin ci-dessus) Mdifier l'uprc qui dit être cnditinnée par cette ressurce : Ajuter une cnditin sur la ressurce Web Service (bjet de ce paragraphe) Mdifier la frmule de lancement pur prendre en cmpte la nuvelle cnditin (reprtezvus au manuel de l'interface Cmmandes de Dllar Universe). Pur créer une nuvelle cnditin de ressurce dans une Uprc, la cmmande uxupd UPR dit être utilisée suivie de la famille RESCON add. Ces cmmandes snt décrites dans le manuel de l'interface Cmmandes de Dllar Universe. uxupd UPR EXP UPR=HELLO_WORLD RESCON add CONDNO=01 RES=SOAP_RES Pur les ressurces de type Web Service SOAP, cette cmmande peut être cmplétée par les infrmatins ci-dessus, permettant de définir les règles seln lesquelles la cnditin de ressurce sera validée en fnctin de la répnse du service web.

50 50 Chapitre 6 Cmmandes NOFAULT EXIST MATCH NOFAULT NOFAULT : la cnditin sera validée si le service web ne returne pas d'erreur. EXIST : utilisable avec XPATH uniquement MATCH : utilisable avec XPATH et REGEX XPATH= path Incmpatible avec NOFAULT Saisissez le chemin d'un nœud u d'un attribut. Récupère dans la répnse du service web le cntenu du chemin saisi Utilisé avec EXIST : la cnditin sera validée si l'élément demandé existe dans la répnse (mais sn cntenu n'est pas analysé). Utilisé avec MATCH : la cnditin sera validée si l'élément demandé existe dans la répnse et si sn cntenu crrespnd à l'expressin régulière REGEX. REGEX= regex Incmpatible avec NOFAULT Saisissez une expressin régulière. Utilisable avec MATCH uniquement : la cnditin sera validée si le cntenu de l'élément demandé crrespnd à l'expressin régulière indiquée. Les caractères spéciaux divent être saisis tels quels, reprtezvus au paragraphe "Caractères spéciaux" page 26. uxupd UPR EXP UPR=HELLO_WORLD RESCON add CONDNO=01 RES=SOAP_RES EXIST XPATH=//result REGEX=[A-Z0-9]+ Pur que l'uprc sit valide, la frmule de lancement dit intégrer cette nuvelle cnditin, par exemple : uxupd UPR EXP UPR=HELLO_WORLD FORMULA LFORM=\"=C01\" Reprtez-vus au paragraphe "Expressins régulières" page Créer une Uprc Web Service REST La cmmande uxadd UPR ajute une Uprc à la liste des Uprcs. Le type d'uprc (UPT) dit être REST. uxadd UPR EXP UPR=REST_UPR LABEL=\"My REST web service\" UPT=REST FPERIOD=D APPL=WS MEMO=O NBPER=1 Plusieurs cmmandes uxupd UPR snt nécessaires pur créer une Uprc REST cmplète. La première partie de la cmmande est identique à la cmmande uxupd UPR standard (elle est utilisée pur sélectinner une Uprc particulière) : Item Frmat Défaut NODE= 64c S_NOEUD EXP SIM INT APP 3c S_ESPEXE UPR= 64c * VUPR= 3n * Plusieurs familles de paramètres snt nécessaires à la définitin des paramètres de l'uprc REST :

51 Chapitre 6 Cmmandes 51 Familles Cmplément Descriptin REST REST_HEADER REST_URLPRM REST_FILPRM REST_BODY REST_STATUS REST_OUTPUT add upd dlt add upd dlt add upd dlt HEADER add HEADER upd HEADER dlt add upd dlt Infrmatins générales bligatires sur le service web et l'uprc REST Gestin des entêtes utilisés par le service web Ajute un entête Mdifie un entête Supprime un entête Gestin des paramètres de l'url Ajute un paramètre Mdifie un paramètre Supprime un paramètre Gestin des paramètres de fichier Ajute un paramètre Mdifie un paramètre Supprime un paramètre Infrmatins pur la requête Règles de gestin du statut de l'uprc Ajute une règle d'analyse des entêtes de la répnse Mdifie une règle d'analyse des entêtes de la répnse Supprime une règle d'analyse des entêtes de la répnse Gestin des dnnées en srtie de l'uprc Ajut de dnnées en srtie Mdificatin des dnnées en srtie Suppressin de dnnées en srtie Uprc REST Infrmatins générales REST : infrmatins générales du service web REST. Tutes les infrmatins en gras snt bligatires. URLID= 512 c Nm du service web cnnu du Manager HTTPRES= 512 c Cmplément de l'url de base indiquée dans la définitin du service web REST dans les paramètres du Manager. Des Variables peuvent être utilisées dans ce champ sus la frme!var!, elles sernt substituées par Dllar Universe puis par le manager lrs de l'invcatin du service web. HTTPMETH= GET POST PUT HEAD DELETE Saisissez la méthde utilisée par le service web TRACE= ON OFF OFF Saisissez la valeur ON pur afficher tutes les infrmatins sur la requête et la répnse du service web dans le jurnal d'exécutin de l'uprc (trace système) uxupd UPR EXP UPR=REST_UPR REST URLID="URL HTTPRES=/persn/!PERSON_ID! HTTPMETH=GET TRACE=ON

52 52 Chapitre 6 Cmmandes Uprc REST Gestin des entêtes http REST_HEADER : Gestin des entêtes http IGNORE_DEFAULT= ON OFF OFF Si rien n'est spécifié (OFF), les entêtes définis par défaut dans les paramètres du Manager (reprtez-vus au paragraphe "Service web REST - Sectin Entêtes par défaut" page 23) snt utilisés par la requête. Si ON est spécifié, les entêtes définis par défaut sernt ignrés. uxupd UPR EXP UPR=REST_UPR REST_HEADER IGNORE_DEFAULT=ON ADD : ajute un entête http à la requête NAME= 512 c Nm de l'entête à ajuter à la requête VALUE= 512 c Valeur assciée à l'entête uxupd UPR EXP UPR=REST_UPR REST_HEADER ADD NAME=Accept VALUE=applicatin/jsn UPD : mdifie un entête http NAME= 512 c Nm de l'entête qui dit être mdifié VALUE= 512 c Nuvelle valeur de l'entête. Si l'entête existe déjà dans les paramètres du manager, la valeur définie dans l'uprc écrase celle définie dans les paramètres du manager. uxupd UPR EXP UPR=REST_UPR REST_HEADER UPD NAME=Accept VALUE=applicatin/xml DLT : supprime un entête http NAME= 512 c Nm de l'entête qui dit être supprimé uxupd UPR EXP UPR=REST_UPR REST_HEADER DLT NAME=Accept Uprc REST Paramètres de l'url REST_URLPRM : Gestin des paramètres de l'url du service web IGNORE_DEFAULT= ON OFF OFF Si rien n'est spécifié (OFF), les paramètres définis par défaut dans les paramètres du Manager (sectin Service web REST - Sectin Paramètres d'url par défaut) snt utilisés par la requête. Si ON est spécifié, les paramètres définis par défaut sernt ignrés. uxupd UPR EXP UPR=REST_UPR REST_URLPRM IGNORE_DEFAULT=ON

53 Chapitre 6 Cmmandes 53 ADD : ajuter un paramètre à l'url NAME= 512 c Nm du paramètre à ajuter à l'url VALUE= 512 c Valeur assciée au paramètre uxupd UPR EXP UPR=REST_UPR REST_URLPRM ADD NAME=Api_versin VALUE=1 UPD : mdifie un paramètre de l'url NAME= 512 c Nm du paramètre qui dit être mdifié VALUE= 512 c Nuvelle valeur du paramètre. Si ce paramètre existe déjà dans les paramètres d'url du service web REST, la valeur définie ici écrasera la valeur définie dans les paramètres du Manager. uxupd UPR EXP UPR=REST_UPR REST_URLPRM UPD NAME=Api_versin VALUE=2 DLT : supprime un paramètre de l'url NAME= 512 c Nm du paramètre qui dit être supprimé uxupd UPR EXP UPR=REST_UPR REST_URLPRM DLT NAME=Api_versin Uprc REST Paramètres de fichiers REST_FILPRM : Gestin des paramètres de fichiers du service web Cette famille ne peut être utilisée que si le service web utilise une méthde POST u PUT. Elle permet de jindre un fichier en paramètre à la requête. ADD : ajuter un paramètre de fichier NAME= 512 c Nm du paramètre à ajuter VALUE= 512 c Nm cmplet du fichier lcal à transmettre avec la requête uxupd UPR EXP UPR=REST_UPR REST_FILPRM ADD NAME=file VALUE=\"C:\temp\fichier.txt\" UPD : mdifie un paramètre de fichier NAME= 512 c Nm du paramètre qui dit être mdifié VALUE= 512 c Nuvelle valeur du paramètre. Si ce paramètre existe déjà dans les paramètres de fichier du service web REST, la valeur définie ici écrasera la valeur définie dans les paramètres du Manager. uxupd UPR EXP UPR=REST_UPR REST_FILPRM UPD NAME=file VALUE=\"C:\temp\file.txt\" DLT : supprime un paramètre de fichier

54 54 Chapitre 6 Cmmandes NAME= 512 c Nm du paramètre qui dit être supprimé uxupd UPR EXP UPR=REST_UPR REST_FILPRM DLT NAME=file Uprc REST Infrmatins pur la requête REST_BODY : utilisé avec les méthdes POST u PUT. Cette famille permet de définir des infrmatins pur la requête (par exemple envyer du JSON u du XML). TYPE= 512 c Type de cntenu du bdy au frmat applicatin/frmat. par exemple, saisissez : Pur une URL : applicatin/x-www-frum-urlencded Pur du texte : text/plain FILE= 512 c Nm cmplet du fichier cntenant le bdy Des Variables peuvent être utilisées dans ces deux champs sus la frme!var!. Elles sernt substituées par Dllar Universe puis par le manager lrs de l'invcatin du service web. Pur le type "applicatin/x-www-frum-urlencded", le frmat du fichier est : "Variable=valeur", une variable par ligne. uxupd RES RES=REST_RES REST_BODY TYPE=applicatin/x-www-frum-urlencded FILE=c:\temp\urlencded.txt Cntenu du fichier c:\temp\urlencded.txt : Variable1=valeur1 Variable2=valeur2 Variable3=valeur Uprc REST Statut REST_STATUS : règles de calcul du statut de l'uprc en fnctin de la répnse du service web. Ce statut peut ensuite être écrasé par le statut avancé de l'uprc. Il faut que tus les critères indiqués sient vrais pur que le statut de l'uprc sit Terminé. Si aucune règle de gestin du statut n'est saisie, le statut sera Terminé si le Manager reçit une répnse du service web, quelle que sit la répnse. Si le Manager ne reçit pas de répnse au but du temps définit par le paramètre nœud UXJEE_HTTP_CONNECTION_TIMEOUT, le statut sera Incidenté. HTTPSTATUS= (status1,status2 ) Saisissez (entre parenthèses bligatirement) les cdes retur http qui permettrnt à l'uprc de se terminer crrectement. NOHTTPSTATUS NOHTTPSTATUS Désactive la recherche HTTPSTATUS XPATH= 512 c Saisissez le chemin (d'un nœud u d'un attribut) qui sera recherché dans la répnse du service web. Si XPATHREGEX n'est pas valrisé, le chemin dit exister dans la répnse mais sn cntenu n'est pas analysé.

55 Chapitre 6 Cmmandes 55 XPATHREGEX= 512 c Utilisable avec XPATH Saisissez une expressin régulière. (1) Récupère dans la répnse du service web le cntenu du chemin XPATH. Le cntenu dit crrespndre à l'expressin régulière indiquée. NOXPATH NOXPATH Désactive la recherche XPATH et XPATHREGEX JSON= 512 c Saisissez le nm de la prpriété qui sera recherchée dans la répnse du service web. Si JSONREGEX n'est pas valrisé, la prpriété dit exister dans la répnse mais sn cntenu n'est pas analysé. JSONREGEX= 512 c Utilisable avec JSON Saisissez une expressin régulière (1) simple. Récupère dans la répnse du service web le cntenu de la prpriété JSON. Le cntenu dit crrespndre à l'expressin régulière indiquée. NOJSON NOJSON Désactive la recherche JSON et JSONREGEX BODY= 512 c Saisissez une expressin régulière. (1) La répnse returnée par le service web dit crrespndre exactement à l'expressin régulière saisie. NOBODY NOBODY Désactive la recherche BODY NOHEADER NOHEADER Désactive la recherche HEADER (ci-après) (1): Expressin régulière : reprtez-vus au paragraphe "Expressins régulières" page 26. Les caractères spéciaux divent être saisis tels quels, reprtez-vus au paragraphe "Caractères spéciaux" page 26. uxupd UPR EXP UPR=REST_UPR REST_STATUS HTTPSTATUS=(202) XPATH=//result XPATHREGEX=[A-Z0-9]+ HEADER : cette sus-famille définit des règles d'analyse des entêtes http returnés dans la répnse du service web. Tutes les règles définies divent être vraies pur que le statut de l'uprc sit Terminé. ADD : ajute une règle d'analyse sur un entête http de la répnse NAME= 512 c Nm de l'entête à analyser COMPARISON= Saisissez un des mts clés ci-dessus: G : la valeur de l'entête est supérieure à GE : la valeur de l'entête est supérieure u égale à L : la valeur de l'entête est inférieure à LE : la valeur de l'entête est inférieure u égale à NUMEQ : la valeur numérique de l'entête est égale à REGEX : l'entête crrespnd exactement à l'expressin régulière (1) CONTAINS : la chaîne de caractères de l'entête cntient EQUALS : la chaîne de caractères de l'entête est égale à VALUE= 512 c Saisissez la valeur de cmparaisn

56 56 Chapitre 6 Cmmandes uxupd UPR EXP UPR=REST_UPR REST_STATUS HEADER ADD NAME=OK COMPARISON=NUMEQ VALUE=10 OK dit être égal à 10 pur que cette règle sit validée. UPD : mdifie une règle d'analyse sur un entête http de la répnse NAME= 512 c Nm de l'entête à analyser COMPARISON= Saisissez un des mts clés ci-dessus: G : la valeur de l'entête est supérieure à GE : la valeur de l'entête est supérieure u égale à L : la valeur de l'entête est inférieure à LE : la valeur de l'entête est inférieure u égale à NUMEQ : la valeur numérique de l'entête est égale à REGEX : l'entête crrespnd exactement à l'expressin régulière (1) CONTAINS : la chaîne de caractères de l'entête cntient EQUALS : la chaîne de caractères de l'entête est égale à VALUE= 512 c Saisissez la valeur de cmparaisn Reprtez-vus au paragraphe "Expressins régulières" page 26. uxupd UPR EXP UPR=REST_UPR REST_STATUS HEADER UPD NAME=OK COMPARISON=L VALUE=10 OK dit être inférieur à 10 pur que cette règle sit validée. DLT : supprime une règle d'analyse sur un entête http de la répnse NAME= 512 c Nm de l'entête à analyser uxupd UPR EXP UPR=REST_UPR REST_STATUS HEADER DLT NAME=OK Uprc REST Dnnées en srtie REST_OUTPUT : Gestin des variables d'héritage KEEP_INPUT= ON OFF ON Si rien n'est spécifié (ON), les variables d'héritages reçues en entrée de l'uprc snt autmatiquement prpagées à l'uprc suivante de la sessin. Il est tutefis pssible d'ajuter des variables d'héritage dans l'uprc (ADD), de les mdifier (UPD) u de les supprimer (DLT). OFF : interrmpt l'héritage de tutes les variables au sein de la sessin. Il est tutefis pssible avec des cmmandes ADD de chisir manuellement quelles variables divent être prpagées. uxupd UPR EXP UPR=REST_UPR REST_OUTPUT KEEP_INPUT=OFF ADD : ajute une variable en srtie de l'uprc

57 Chapitre 6 Cmmandes 57 NAME= 512 c Nm de la nuvelle variable d'héritage TYPE= ENV XPATH HTTPSTATUS JSON HEADER Si la variable a été reçue par l'uprc, saisissez ENV (par exemple pur prpager une variable d'héritage dans le cas u KEEP_INPUT=OFF). Si la variable dit être créée à partir d'une expressin issue de la répnse du service Web : Saisissez XPATH pur récupérer la valeur du chemin désigné dans VALUE, si la répnse est en XML Saisissez JSON pur récupérer la valeur de la prpriété désignée dans VALUE, si la répnse est en JSON Saisissez HEADER pur récupérer la valeur de l'entête désigné dans VALUE Saisissez HTTPSTATUS pur récupérer la valeur du statut http returnée par le service web VALUE= 512 c Incmpatible avec ENV et HTTPSTATUS Utilisé avec XPATH : saisissez le nm du chemin Utilisé avec JSON : saisissez le nm de la prpriété Utilisé avec HEADER : saisissez le nm de l'entête Sus UNIX/Linux, le nm d'une variable ne dit pas cmmencer par un chiffre (restrictin du système d'explitatin). uxupd UPR EXP UPR=REST_UPR REST_OUTPUT ADD NAME=LOCATION TYPE=HEADER VALUE=lcatin UPD : mdifie une variable en srtie de l'uprc NAME= 512 c Nm de la variable d'héritage à mdifier TYPE= JSON HEADER HTTPSTATUS ENV XPATH Saisissez ENV pur une variable reçue par l'uprc Si la variable dit être mdifiée pur récupérer une expressin issue de la répnse du service Web : Saisissez XPATH pur récupérer la valeur du chemin désigné dans VALUE, si la répnse est en XML Saisissez JSON pur récupérer la valeur de la prpriété désignée dans VALUE, si la répnse est en JSON Saisissez HEADER pur récupérer la valeur de l'entête désigné dans VALUE Saisissez HTTPSTATUS pur récupérer la valeur du statut http returnée par le service web VALUE= 512 c Incmpatible avec ENV et HTTPSTATUS Utilisé avec XPATH : saisissez le nm du chemin Utilisé avec JSON : saisissez le nm de la prpriété Utilisé avec HEADER : saisissez le nm de l'entête uxupd UPR EXP UPR=REST_UPR REST_OUTPUT NAME=LOCATION TYPE=HEADER VALUE=rtObject.security.tken DLT : supprime une variable en srtie de l'uprc NAME= 512 c Nm de la variable dnt l'héritage dit être interrmpu

58 58 Chapitre 6 Cmmandes uxupd UPR EXP UPR=REST_UPR REST_OUTPUT NAME=LOCATION 6.5 Créer une Ressurce Web Service REST La cmmande uxadd RES ajute une ressurce à la liste des ressurces. La nature de la ressurce dit être REST. La fréquence (exprimée en secndes) crrespnd à la fréquence d'exécutin du service web par le Manager lrsqu'une Uprc est en attente d'événement sur cette ressurce jusqu'à ce que la cnditin de ressurce sit validée. uxadd RES RES=REST_RES LABEL=\"My REST web service\" NATURE=REST FREQ=120 Plusieurs cmmandes uxupd RES snt nécessaires pur créer une ressurce REST cmplète. La première partie de la cmmande est identique à la cmmande uxupd RES standard (elle est utilisée pur sélectinner une ressurce particulière) : Item Frmat Défaut NODE= 64c S_NOEUD RES= 64c * Plusieurs familles de paramètres snt nécessaires à la définitin des paramètres de la ressurce REST : Familles Cmplément Descriptin REST REST_HEADER REST_URLPRM REST_FILPRM REST_BODY add upd dlt add upd dlt add upd dlt Infrmatins générales bligatires sur le service web Gestin des entêtes utilisés par le service web Ajute un entête Mdifie un entête Supprime un entête Gestin des paramètres de l'url Ajute un paramètre Mdifie un paramètre Supprime un paramètre Gestin des paramètres de fichiers Ajute un paramètre Mdifie un paramètre Supprime un paramètre Infrmatins pur la requête Ressurce REST Infrmatins générales REST : infrmatins générales bligatires du service web REST.

59 Chapitre 6 Cmmandes 59 URLID= 512 c Nm du service web cnnu du Manager HTTPRES= 512 c Cmplément de l'url de base indiquée dans la définitin du service web REST dans les paramètres du Manager. Des Variables peuvent être utilisées dans ce champ sus la frme!var!, elles sernt substituées par Dllar Universe puis par le manager lrs de l'invcatin du service web. HTTPMETH= GET POST PUT HEAD DELETE Saisissez la méthde utilisée par le service web uxupd RES RES=REST_RES REST URLID="URL HTTPRES=/persn/!PERSON_ID! HTTPMETH=GET Ressurce REST Gestin des entêtes Http REST_HEADER : gestin des entêtes http IGNORE_DEFAULT= ON OFF OFF Si rien n'est spécifié (OFF), les entêtes définis par défaut dans les paramètres du Manager (reprtez-vus au paragraphe "Service web REST - Sectin Entêtes par défaut" page 23) snt utilisés par la requête. Si ON est spécifié, les entêtes définis par défaut sernt ignrés. uxupd RES RES=REST_RES REST_HEADER IGNORE_DEFAULT=ON ADD : ajute un entête http à la requête NAME= 512 c Nm de l'entête à ajuter à la requête VALUE= 512 c Valeur assciée à l'entête uxupd RES RES=REST_RES REST_HEADER ADD NAME=Accept VALUE=applicatin/jsn UPD : mdifie un entête http NAME= 512 c Nm de l'entête qui dit être mdifié VALUE= 512 c Nuvelle valeur de l'entête. Si l'entête existe déjà dans les paramètres du manager, la valeur définie dans l'uprc écrase celle définie dans les paramètres du manager. uxupd RES RES=REST_RES REST_HEADER UPD NAME=Accept VALUE=applicatin/xml DLT : supprime un entête http NAME= 512 c Nm de l'entête qui dit être supprimé uxupd RES RES=REST_RES REST_HEADER DLT NAME=Accept

60 60 Chapitre 6 Cmmandes Ressurce REST Paramètres de l'url REST_URLPRM : Gestin des paramètres de l'url du service web IGNORE_DEFAULT= ON OFF OFF Si rien n'est spécifié (OFF), les paramètres définis par défaut dans les paramètres du Manager (Service web REST - Sectin Paramètres d'url par défaut) snt utilisés par la requête. Si ON est spécifié, les paramètres définis par défaut sernt ignrés. uxupd RES RES=REST_RES REST_URLPRM IGNORE_DEFAULT=ON ADD : ajuter un paramètre à l'url NAME= 512 c Nm du paramètre à ajuter à l'url VALUE= 512 c Valeur assciée au paramètre uxupd RES RES=REST_RES REST_URLPRM ADD NAME=Api_versin VALUE=1 UPD : mdifie un paramètre de l'url NAME= 512 c Nm du paramètre qui dit être mdifié VALUE= 512 c Nuvelle valeur du paramètre. Si ce paramètre existe déjà dans les paramètres d'url du service web REST, la valeur définie ici écrasera la valeur définie dans les paramètres du Manager. uxupd RES RES=REST_RES REST_URLPRM UPD NAME=Api_versin VALUE=2 DLT : supprime un paramètre de l'url NAME= 512 c Nm du paramètre qui dit être supprimé uxupd RES RES=REST_RES REST_URLPRM DLT NAME=Api_versin Ressurce REST Paramètres de fichiers REST_FILPRM : Gestin des paramètres de fichiers du service web Cette famille ne peut être utilisée que si le service web utilise les méthdes POST u PUT. Elle permet de jindre un fichier en paramètre à la requête. ADD : ajuter un paramètre de fichier NAME= 512 c Nm du paramètre à ajuter VALUE= 512 c Nm cmplet du fichier lcal à transmettre avec la requête uxupd RES RES=REST_RES REST_FILPRM ADD NAME=file VALUE=\"C:\temp\fichier.txt\"

61 Chapitre 6 Cmmandes 61 UPD : mdifie un paramètre de fichier NAME= 512 c Nm du paramètre qui dit être mdifié VALUE= 512 c Nuvelle valeur du paramètre. Si ce paramètre existe déjà dans les paramètres de fichier du service web REST, la valeur définie ici écrasera la valeur définie dans les paramètres du Manager. uxupd RES RES=REST_RES REST_FILPRM UPD NAME=file VALUE=\"C:\temp\file.txt\" DLT : supprime un paramètre de fichier NAME= 512 c Nm du paramètre qui dit être supprimé uxupd RES RES=REST_RES REST_FILPRM DLT NAME=file Ressurce REST Infrmatins pur la requête REST_BODY : utilisé avec les méthdes POST u PUT. Cette famille permet de définir des infrmatins pur la requête (par exemple envyer du JSON u du XML). TYPE= 512 c Type de cntenu du bdy au frmat applicatin/frmat. par exemple, saisissez : Pur une URL : applicatin/x-www-frum-urlencded Pur du texte : text/plain FILE= 512 c Nm cmplet du fichier cntenant le bdy Des Variables peuvent être utilisées dans ces deux champs sus la frme!var!. Elles sernt substituées par Dllar Universe puis par le manager lrs de l'invcatin du service web. Pur le type "applicatin/x-www-frum-urlencded", le frmat du fichier est : "Variable=valeur", une variable par ligne. uxupd RES RES=REST_RES REST_BODY TYPE=applicatin/x-www-frum-urlencded FILE=c:\temp\urlencded.txt Cntenu du fichier c:\temp\urlencded.txt : Variable1=valeur1 Variable2=valeur2 Variable3=valeur3 6.6 Cnditinner une Uprc sur une ressurce Web Service REST Pur cnditinner l'exécutin d'une Uprc (quelcnque) par le résultat d'exécutin d'un service web REST, il faut : Créer une ressurce Web Service REST pur ce service web (paragraphe ci-dessus). Mdifier l'uprc qui dit être cnditinnée par la ressurce Web Service REST :

62 62 Chapitre 6 Cmmandes Ajuter une cnditin sur la ressurce Web Service (bjet de ce paragraphe). Mdifier la frmule de lancement pur prendre en cmpte la nuvelle cnditin (reprtezvus au manuel de l'interface Cmmandes de Dllar Universe). Pur créer une nuvelle cnditin de ressurce dans une Uprc, la cmmande uxupd UPR dit être utilisée suivie de la famille RESCON add. Ces cmmandes snt décrites dans le manuel de l'interface Cmmandes de Dllar Universe. uxupd UPR EXP UPR=HELLO_WORLD RESCON add CONDNO=02 RES=REST_RES Pur les ressurces de type Web Service REST, cette cmmande peut être cmplétée des infrmatins ci-dessus, permettant de définir les règles seln lesquelles la cnditin de ressurce sera validée en fnctin de la répnse du service web. Il faut que tus les critères indiqués sient vrais pur que la cnditin sit validée. Si aucune règle de réslutin du statut n'est saisie, la cnditin sera validée si le Manager reçit une répnse du service web, quelle que sit la répnse. TRACE ON OFF OFF Saisissez ON pur afficher tutes les infrmatins sur la requête et la répnse du service web dans le jurnal de la ressurce HTTPSTATUS= (status1,status2 ) Saisissez les cdes retur http (entre parenthèses bligatirement) qui permettrnt à la cnditin d'être validée. NOHTTPSTATUS NOHTTPSTATUS Désactive la recherche HTTPSTATUS XPATH= 512 c Saisissez le chemin (d'un nœud u d'un attribut) qui sera recherché dans la répnse du service web. XPATHREGEX= 512 c Utilisable avec XPATH Si XPATHREGEX n'est pas valrisé, le chemin dit exister dans la répnse mais sn cntenu n'est pas analysé. Saisissez une expressin régulière. (2) Récupère dans la répnse du service web le cntenu du chemin XPATH. Le cntenu dit crrespndre à l'expressin régulière indiquée. NOXPATH NOXPATH Désactive la recherche XPATH et XPATHREGEX JSON= 512 c Saisissez le nm de la prpriété qui sera recherchée dans la répnse du service web. JSONREGEX= 512 c Utilisable avec JSON Si JSONREGEX n'est pas valrisé, la prpriété dit exister dans la répnse mais sn cntenu n'est pas analysé. Saisissez une expressin régulière (2) simple. Récupère dans la répnse du service web le cntenu de la prpriété JSON. Le cntenu dit crrespndre à l'expressin régulière indiquée. NOJSON NOJSON Désactive la recherche JSON et JSONREGEX BODY= 512 c Saisissez une expressin régulière. (2) La répnse returnée par le service web dit crrespndre exactement à l'expressin régulière saisie. NOBODY NOBODY Désactive la recherche BODY

63 Chapitre 6 Cmmandes 63 NOHEADER NOHEADER Désactive la recherche HEADER (ci-après) (2): Expressin régulière : Reprtez-vus au paragraphe "Expressins régulières" page 26. Les caractères spéciaux divent être saisis tels quels, reprtez-vus au paragraphe "Caractères spéciaux" page 26. uxupd UPR EXP UPR=HELLO_WORLD RESCON add CONDNO=02 RES=REST_RES HTTPSTATUS=(202) XPATH=//result XPATHREGEX=[A-Z0-9]+ HEADER : cette sus-famille permet de définir des règles d'analyse des entêtes http returnés dans la répnse du service web. Tutes les règles définies divent être vraies pur que la cnditin sit validée. L'utilisatin de cette sus-famille met en œuvre une cmmande du type : uxupd UPR UPR=xxx RESCON upd La mdificatin d'une cnditin de ressurce en mde cmmande n'est pssible que dans ce cntexte uniquement. ADD : ajute une règle d'analyse sur un entête http de la répnse NAME= 512 c Nm de l'entête à analyser COMPARISON= Saisissez un des mts clés ci-dessus: G : la valeur de l'entête est supérieure à GE : la valeur de l'entête est supérieure u égale à L : la valeur de l'entête est inférieure à LE : la valeur de l'entête est inférieure u égale à NUMEQ : la valeur numérique de l'entête est égale à REGEX : l'entête crrespnd exactement à l'expressin régulière (2) CONTAINS : la chaîne de caractères de l'entête cntient EQUALS : la chaîne de caractères de l'entête est égale à VALUE= 512 c Saisissez la valeur de cmparaisn uxupd UPR EXP UPR=HELLO_WORLD RESCON upd CONDNO=02 ADD_HEADER NAME=OK COMPARISON=NUMEQ VALUE=10 OK dit être égal à 10 pur que cette règle sit validée. UPD : mdifie une règle d'analyse sur un entête http de la répnse NAME= 512 c Nm de l'entête à analyser COMPARISON= Saisissez un des mts clés ci-dessus: G : la valeur de l'entête est supérieure à GE : la valeur de l'entête est supérieure u égale à L : la valeur de l'entête est inférieure à LE : la valeur de l'entête est inférieure u égale à NUMEQ : la valeur numérique de l'entête est égale à REGEX : l'entête crrespnd exactement à l'expressin régulière (2) CONTAINS : la chaîne de caractères de l'entête cntient EQUALS : la chaîne de caractères de l'entête est égale à VALUE= 512 c Saisissez la valeur de cmparaisn

64 64 Chapitre 6 Cmmandes uxupd UPR EXP UPR=HELLO_WORLD RESCON upd CONDNO=02 UPD_HEADER NAME=OK COMPARISON=L VALUE=10 OK dit être inférieur à 10 pur que cette règle sit validée. DLT : supprime une règle d'analyse sur un entête http de la répnse NAME= 512 c Nm de l'entête à analyser uxupd UPR EXP UPR=HELLO_WORLD RESCON upd CONDNO=02 DLT_HEADER NAME=OK Pur que l'uprc sit valide, la frmule de lancement dit intégrer la nuvelle cnditin, par exemple : uxupd UPR EXP UPR=HELLO_WORLD FORMULA LFORM=\"=C01 AND =C02\" 6.7 Démarrer/Arrêter le service JEE Les cmmandes standards de Dllar Universe uxlst, uxstr et uxend peuvent aussi être utilisées pur démarrer et arrêter l'autmate JEE. L'autmate JEE est partagé par plusieurs Managers : Java (EJB u JMS), Web Services, Micrsft SQL Server et Oracle Database. Exécutez tut d abrd l envirnnement lgique de Dllar Universe. Puis déplacez-vus dans le répertire des binaires. Par exemple : cd /var/pt/duas/univ6x_saturn../unienv.ksh cd bin Le service JEE ne peut être démarré que si Dllar Universe est démarré. Vérificatin du statut du JEE uxlst fnc fnc=jee Cmmand : uxlst fnc fnc=jee exp FNC COMPANY NODE AREA STATUS START AT STOP AT ACTIVE AT PID CYCLE JEE UNIV6X FRWPMDEV53 X Started 10/25/ Démarrage du JEE uxstr fnc fnc=jee Cmmand : uxstr fnc fnc=jee exp Arrêt du JEE uxend fnc fnc=jee Cmmand : uxend fnc fnc=jee exp Les cmmandes uxstr fnc, uxend fnc et uxlst fnc snt décrites dans le manuel d installatin de Dllar Universe et peuvent être utilisées pur tus les services de Dllar Universe : techniques u fnctinnels.

65 Chapitre 7 A prps d'autmic, de la cmmunauté et des services 65 7 A prps d'autmic, de la cmmunauté et des services Ce sujet présente la sciété Autmic Sftware et cmment tirer parti de tutes les slutins que nus vus prpsns. Vus puvez également accéder à la dcumentatin en ligne d'autmic à l'adresse dcs.autmic.cm. 7.1 La sciété Autmic Sftware Autmic Sftware est dédiée à l'autmatisatin de l'entreprise. Autmic est la platefrme la plus cmplète pur l'autmatisatin de l'entreprise. Fndée en 1985, Autmic a lancé la plate-frme d'autmatisatin indépendante la plus vaste, déplyée à l'échelle mndiale qui renfrce les applicatins l'infrastructure et l'entreprise. Maintenant que la cnsumérisatin de l'infrmatique s'accélère, Autmic ré-imagine cmment les rganisatins s'intègrent dans les mdèles de services de nuvelle génératin cmme le Clud, Big Data et DevOps. Aujurd'hui, ns lgiciels autmatisent des dizaines de millins d'pératins par jur pur plus de 2000 clients dans le mnde entier. Nus défins la pensée cnventinnelle, permettant à ns clients d'être plus rapides, plus intelligents dans le cntrôle des pératins. Autmic le standard dans l'autmatisatin de l'entreprise. Pur en savir plus, visitez ntre site web La cmmunauté Autmic Vus vulez cmmuniquer avec d'autres utilisateurs Autmic pur cmparer des idées u apprendre cmment d'autres s'attaquent aux prblèmes que vus rencntrez? Partagez avec d'autres utilisateurs du mnde entier pur apprendre cmment ils ptimisent l'autmatisatin de l'entreprise à l'aide d'autmic. Dialguez avec l'équipe Autmic pur btenir des trucs et astuces directement de la surce. Rejignez la cmmunauté Autmic et devenez un initié Autmic pur être parmi les premiers à recevir des nuvelles sur les nuveaux prduits et événements, parfis même avant qu'ils ne sient annncés! 7.3 Centre de téléchargement Assurez-vus que vus utilisez tut le ptentiel de ns prduits. Le Centre de téléchargement est l'emplacement ù vus truverez les téléchargements des prduits, la dcumentatin et les infrmatins sur les nuvelles mises à jur et la réslutin des prblèmes de vtre slutin Autmic. Tut est regrupé : les mises à jur, les release ntes et tus les manuels utilisateurs. Vus truverez également la descriptin des patchs, les prblèmes cnnus et les slutins de cnturnement.

66 66 Chapitre 7 A prps d'autmic, de la cmmunauté et des services 7.4 Supprt technique Vus puvez faire cnfiance à ntre équipe de supprt. Ntre équipe de prfessinnels est à vtre service, n'imprte ù et n'imprte quand. Plusieurs centres de supprts situés en Eurpe, en Amérique du nrd et en Asie Pacifique cnstituent le cœur de l'rganisatin du supprt Autmic. Vs experts Autmic de ns équipes de supprt technique snt au plus à quelques heures de vl, quel que sit le cntinent sur lequel vs filiales et vs centres de dnnées snt situés. Autmic Sftware est cnçue pur furnir une cnnectivité mndiale à des entreprises internatinales. Vus utilisez les lgiciels Autmic à l'échelle mndiale, vus puvez dnc vus attendre à un service mndial. 7.5 Frmatin et services Vus vulez en savir plus sur les slutins Autmic? Nus prpsns une gamme de frmatins sur la façn de tirer le meilleur parti de vtre slutin Autmic. Seln vtre lcalisatin, vus puvez participer aux sessins de frmatins rganisées au centre de frmatin d'autmic u nus puvns rganiser des sessins de frmatin persnnalisées sur le site de vtre entreprise, seln ce qui vus cnvient le mieux. Visitez le site du centre de frmatin pur btenir des infrmatins détaillées sur les curs prpsés.

67