La présentation est en train de télécharger. S'il vous plaît, attendez

La présentation est en train de télécharger. S'il vous plaît, attendez

Www.adonix.fr Formation Web Services Adonix. Groupe ADONIX // 2 www.adonix.fr Sommaire 1. Présentation 1. Présentation 2. Principe de fonctionnement 2.

Présentations similaires


Présentation au sujet: "Www.adonix.fr Formation Web Services Adonix. Groupe ADONIX // 2 www.adonix.fr Sommaire 1. Présentation 1. Présentation 2. Principe de fonctionnement 2."— Transcription de la présentation:

1 Formation Web Services Adonix

2 Groupe ADONIX // 2 Sommaire 1. Présentation 1. Présentation 2. Principe de fonctionnement 2. Principe de fonctionnement 3. Installation & configuration 3. Installation & configuration 4. Mise en œuvre 4. Mise en œuvre 5. Intégration dans lapplication cliente 5. Intégration dans lapplication cliente

3 1.Présentation 1.1.Généralités sur les services web 1.2.Les services web ADONIX 1.3.Méthodes des services web ADONIX Le Service Web Objet Le Service Web Sous programme Le Service Web Liste Méthode commune Formation Web Services Adonix

4 Groupe ADONIX // Généralités sur les services web Quest-ce quun service web ? Quest-ce quun service web ? Un service web est une technologie qui permet à une application de souvrir vers lextérieur pour proposer des fonctionnalités à dautres applications, en dialoguant à distance via Internet. Ceci, indépendamment des plates-formes et des langages sur lesquelles elles reposent. Chaque service web propose un ensemble de fonctionnalités (leur savoir- faire) appelé méthodes. Les services Web s'appuient sur un ensemble de protocoles (SOAP) standardisant les échanges. La technologie des Services Web est aujourd'hui de plus en plus incontournable, cette technologie englobe de nombreux concepts et tend à s'imposer comme le nouveau standard en terme d'intégration et d'échanges B2B et B2C.

5 Groupe ADONIX // Les Services web ADONIX Les services web adonix repose sur des standards définis et non sur un protocole propriétaire. Ils remplacent la version ADAPI de la V130. Ils permettent à dautres application de communiquer avec X3. Les services web adonix repose sur des standards définis et non sur un protocole propriétaire. Ils remplacent la version ADAPI de la V130. Ils permettent à dautres application de communiquer avec X3. Ces applications peuvent couvrir de nombreux domaines : Ces applications peuvent couvrir de nombreux domaines : Site Internet E-Commerce Application métier Application commerciale déportée de type terrain … Chacune des ces applications ont des points communs : Chacune des ces applications ont des points communs : Un fort besoin dinteractivité avec lERP : ŸMise à disposition dinformations « up to date » ŸMise à jour de lERP en temps réel Une sécurité accrue ŸPas de fichier ASCII transitant sur des disques durs

6 Groupe ADONIX // Méthodes des services web ADONIX Les services web adonix sont au nombre de trois : Les services web adonix sont au nombre de trois : 1.Service Web Objet : permet daccéder à X3 via les objets « métier » du progiciel. 2.Service Web Sous Programme : permet lexécution de programmes développés dans X3. 3.Service Web Liste : permet la consultation dinformations basées sur le paramétrage des objets « métier » (liste gauche des objets).

7 Groupe ADONIX // Le Service Web Objet / Description Le Service Web Objet permet daccéder aux objets « métier » du progiciel. Tels que : Le Service Web Objet permet daccéder aux objets « métier » du progiciel. Tels que : Commandes de ventes Articles Clients … Tout objet X3 est éligible Lobjet des commandes de vente est le seul certifié par Adonix comme étant totalement compatible avec ce mode dutilisation. Les autres objets sont adaptables à la demande. La contrainte principale est que lensemble des informations saisies doivent lêtre dans la fenêtre principale de lobjet, aucune ouverture complémentaire de fenêtre nest possible. Ce service WEB est unique quelque soit lobjet utilisé, il sera toujours disponible même si lobjet évolue ( patch, changement de version … )

8 Groupe ADONIX // Le Service Web Objet /Méthodes Voici les méthodes proposées dans ce service WEB. Voici les méthodes proposées dans ce service WEB. 1.Lecture denregistrements : read(objet,clé) On demande à X3 de lire un enregistrement, on donne la ou les valeurs de clé. Cela revient à consulter une fiche dans une gestion objet, lenregistrement nest cependant pas verrouillé. X3 nous répond en nous donnant les valeurs de lensemble des champs des écrans de lobjet concerné. 2.Création denregistrements : save(objet,flux) On demande à X3 de créer un enregistrement, on lui transmet tous les champs nécessaires ainsi que ceux rendus obligatoires dans les écrans. Lensemble des contrôles applicatifs sont déclenchés. Cest léquivalent du bouton créer de la gestion objet. X3 nous répond en nous donnant la valeurs de tous les champs des écrans et les messages derreurs éventuels, on sait si la création a été effectuée ou non.

9 Groupe ADONIX // 9 3.Suppression denregistrements : delete(objet,clé) On demande à X3 de supprimer un enregistrement, on lui transmet les valeurs de clés. Lensemble des contrôles applicatifs est déclenché. Cest léquivalent du bouton supprimer de la gestion objet X3 nous répond en nous donnant les messages derreurs éventuels, on sait si la suppression a été effectuée ou non. 4.Mise à jour denregistrements : modify(objet,clé,flux) On transmet à X3 les valeurs de clé ainsi que les champs devant être mis à jour. X3 effectue la mise à jour nous répond en nous donnant les messages derreurs éventuels. Les tables annexes sont mise à jours. Cest léquivalent du bouton enregistrer de la gestion objet. 5.Exécution doption : actionObject(objet,option,flux) On va demander à X3 deffectuer une fonction liée à un menu ou un bouton ajouté à un objet. Par ce biais on peut exécuter une tâche particulière comme valoriser la commande sans la créer. X3 nous répond en nous donnant le contenu de chaque champ de lécran de lobjet concerné Le Service Web Objet /Méthodes

10 Groupe ADONIX // 10 Le Service Web Sous Programme permet dexécuter des traitements L4G Le Service Web Sous Programme permet dexécuter des traitements L4G Ex : Ex : Demander un prix Obtenir la photo dun produit Interroger le stock Mettre à jour des réservations client … … Tout sous programme X3 est éligible Une fois la description du sous programme enregistré dans le dictionnaire X3, celui – ci peut être déclenché dans X3 par ce web service. Une fois la description du sous programme enregistré dans le dictionnaire X3, celui – ci peut être déclenché dans X3 par ce web service. Un contrainte existe cependant : il ne doit pas nécessiter lintervention de lutilisateur pour sexécuter. Il doit être autonome avec les paramètres transmis lors de son appel. Un contrainte existe cependant : il ne doit pas nécessiter lintervention de lutilisateur pour sexécuter. Il doit être autonome avec les paramètres transmis lors de son appel Le Service Web Sous Programme / Description

11 Groupe ADONIX // 11 Ce service WEB propose la méthode runXml(sous programme, flux des paramètres). Celle-ci demande lexécution dun sous programme X3. Ce service WEB propose la méthode runXml(sous programme, flux des paramètres). Celle-ci demande lexécution dun sous programme X3. Exemple sur une demande de tarif. Exemple sur une demande de tarif. On demande à X3 dexécuter le sous programme « TARIF » en transmettant le code de larticle, le code du client. X3 nous répond en nous transmettant tous les paramètres du sous programme décrits dans le dictionnaire : code de larticle, code du client et enfin le prix. Il ne reste plus qua exploiter ce prix dans lapplication cliente Le Service Web Sous Programme / Méthodes

12 Groupe ADONIX // 12 Le Service Web Liste permet la consultation dinformations basées sur le paramétrage des listes gauches. Le Service Web Liste permet la consultation dinformations basées sur le paramétrage des listes gauches. Ex : Ex : Demander la liste des commandes dun client Demander la liste des articles dune catégorie donnée Toutes les listes gauches des objets peuvent être interrogées par ce service web. Toutes les listes gauches des objets peuvent être interrogées par ce service web. Les critères utilisés pour construire le filtre sont cependant limités aux colonnes présentes dans le paramétrage de la liste gauche. Les critères utilisés pour construire le filtre sont cependant limités aux colonnes présentes dans le paramétrage de la liste gauche. La liste interrogée est la liste principale de lobjet, les autres tiroirs ne sont pas disponibles. La liste interrogée est la liste principale de lobjet, les autres tiroirs ne sont pas disponibles Le Service Web Liste / Description

13 Groupe ADONIX // 13 Ce service WEB propose la méthode query(objet,clé,nombre de lignes). Celle-ci interroge la liste gauche dun objet dans X3. Ce service WEB propose la méthode query(objet,clé,nombre de lignes). Celle-ci interroge la liste gauche dun objet dans X3. Exemple sur la liste gauche des articles : Exemple sur la liste gauche des articles : On demande à X3 de nous donner le contenu de la liste gauche de lobjet des articles. On lui transmet les critères dinterrogation de cette liste : ŸArticle commençant par L : L* ŸDe la catégorie « fragile » : FRL X3 nous répond en nous transmettant un tableau avec toutes les colonnes paramétrées dans la liste gauche dont les lignes correspondent aux critères demandés Le Service Web Liste / Méthodes

14 Groupe ADONIX // 14 Chacun de ces trois service web propose une méthode particulière Chacun de ces trois service web propose une méthode particulière Il sagit de la méthode GetDescription(objet ou sousprogramme) Cette méthode permet : De vérifier si un objet, une liste ou un programme a été publié en mode WEB Service. De recharger la dernière version de la publication dans le cache du serveur WEB Dobtenir un certains nombre dinformation : ŸPour une liste, les noms et type des colonnes ŸPour un objet les noms et type des champs des écrans ŸPour un sous programme les nom et type des paramètres Méthode commune

15 Groupe ADONIX // 15 En résumé … Si lon désire gérer des enregistrements dans X3, en tenant compte des règles de gestion et des contrôles applicatifs. Si lon désire gérer des enregistrements dans X3, en tenant compte des règles de gestion et des contrôles applicatifs. Lutilisation du service web objet est tout a fait indiqué. La contrainte essentielle est bien entendu que lobjet existe dans X3 et que celui-ci nouvre pas de fenêtre complémentaires. Aucun développement nest à priori nécessaire dans X3, seule la conformité de lobjet est a vérifier dans ce mode dexploitation. Si lon désire consulter des listes en tenant compte des restrictions liées au paramétrage des habilitations utilisateurs et des rôles Si lon désire consulter des listes en tenant compte des restrictions liées au paramétrage des habilitations utilisateurs et des rôles Lutilisation du service web liste est une des solutions possibles. Il y a deux contraintes : Les informations devant être consultées par lapplication tierce doivent être paramétrées dans préalablement dans X3. Et celle-ci doivent exister sous la forme dun objet Un nouvel objet peut cependant être créé uniquement pour sa liste gauche

16 Groupe ADONIX // 16 En résumé … Si lon désire exécuter des tâches particulières nétant pas disponibles sous la forme dobjet dans X3 Si lon désire exécuter des tâches particulières nétant pas disponibles sous la forme dobjet dans X3 Le service web sous-programme est le seul permettant de répondre cette demande. La contrainte principale est que le sous programme doit être autonome ( pas dinteraction avec lutilisateur ) Et bien entendu quil soit décrit dans le dictionnaire X3

17 2.Principe de fonctionnement 2.1.Architecture de la solution ADONIX & connexion cliente 2.2.Zoom sur le serveur WEB 2.3.Traitement dune requête web / service 2.4.Fonctionnement du pool de connexion Formation Web Services Adonix

18 Groupe ADONIX // 18 Notion de « solution » Avec la 140 est arrivé la notion de solution, les web services sont liés a ce nouveau concept : Avec la 140 est arrivé la notion de solution, les web services sont liés a ce nouveau concept : Une installation Adonix comprend un et un seul dossier mère et n dossiers fils qui héritent des éléments définis dans les dossiers de niveau supérieur selon les règles de propagation Adonix. Chaque dossier de larborescence possède des tables dans la base de données et un ensemble de répertoires sur disque. Il est possible de localiser les éléments sur disque sous différentes racines en utilisant le concept dadxvolume. Pour chaque installation le nom de dossier est discriminant, mais il est possible davoir sur la même machine (ou sur des machines différentes) des installations différentes comportant des dossiers de même nom que lon souhaite publier sur le même serveur Web. Il convient donc de différencier ces éléments en caractérisant chaque « installation ». Une installation prend pour nom une solution Adonix et est caractérisée par un code alphanumérique défini au niveau de la console. Ce code est stocké dans le fichier de configuration solution.xml qui se trouve au dessus du répertoire racine du dossier mère (classiquement dans le répertoire DOSSIERS sur une installation Windows) 2. Principe de fonctionnement

19 Groupe ADONIX // 19 Serveur de données Base oracle / sql Serveur Serveur dapplication X3 2.1 Architecture solution Adonix & connexion cliente X3 DEMO Dossiers … Solution Adonix Serveurs complémentaires Serveur dédition Serveur WEB Connexion cliente Client lourd Client légers Client W/S Serveur(s) de connexion

20 Groupe ADONIX // Zoom sur le serveur WEB Serveur WEB X3 Apache Serveur HTTP Tomcat Serveur de cache Serveur de session Serveur de connexion Pool de connexion Serveur de web service Sérialisation XML Dé sérialisation XML Conteneur de servlets Servlets Connexion sur X3 Connexion application tierce

21 Groupe ADONIX // 21 Serveur dapplication X3 Site WEB Internet / Intranet Protocole Adonix Internautes 1.Linternaute demande une page du site 2.Le site web invoque le service WEB X3 3.Le serveur WEB X3 contacte le serveur X3 4.Le serveur X3 exécute le traitement 5.Le serveur X3 donne le résultat au serveur WEB X3 6.Le serveur WEB transmet la demande au site WEB 7.Le site WEB actualise la page et la transmet à linternaute Traitement dune requête Web Service Serveur WEB Pool de connexion HTTPHTTP

22 Groupe ADONIX // Traitement dune requête Web Service détail des échanges 1. 1.Linternaute demande une page du site Il demande une page dans laquelle il y a une interaction avec X3 ( création dune commande, consultation dun tarif … ) 2. 2.Le site web invoque le service WEB X3 Pour répondre à la demande de linternaute, il faut dans le code du site WEB avoir au préalable intégré un des services WEB X3, on linvoque en faisant varier les paramètres des méthodes quil contient. Linvoquer reviens à construire le message SOAP et le mettre dans une requête HTTP à destination du serveur WEB X Le serveur WEB X3 contacte le serveur X3 Le serveur WEB X3 décode le message et le met sous une forme compréhensible par le serveur X3, il lui transmet linformation via lune des connexions déjà établie Le serveur X3 exécute le traitement Le serveur X3 exécute un programme wrapper qui se charge de garnir les champs des écrans et de déclencher le scénario objet ou dexécuter le programme demandé 5. 5.Le serveur X3 donne le résultat au serveur WEB X3 Pour le serveur X3 il ny a pas de différence entre une connexion de ce type et une connexion de type client/serveur classique, il dialogue avec le serveur WEB comme il le fait avec le client graphique X Le serveur WEB transmet la demande au site WEB Le serveur WEB encode la réponse dX3 pour la mettre sous la forme dun message SOAP Le message SOAP est encapsulé dans une requête HTTP et envoyé au site WEB 7. 7.Le site WEB actualise la page et la transmet à linternaute

23 Groupe ADONIX // Fonctionnement du pool de connexion Le pool de connexion est le système qui permet : Détablir les connexions sur le serveur X3 De gérer les files dattentes des demandes Étape 1 - Démarrage du pool de connexion Soit automatique lors du démarrage du serveur WEB Soit par une demande de démarrage explicite Pool de connexion Serveur X3 Dans cet exemple le pool de connexion démarre et lance 4 sessions sur le serveur X3 sur le dossier APP et 1 sur le dossier TEST. Au total 5 licences de type web service sont consommées Dossier APP Dossier TEST Entrée APP Entrée TEST Serveur WEB X3

24 Groupe ADONIX // Serveur de web service Pool de connexion Site WEB Serveur X3 Étape 2 – Le pool est sollicité, une ou plusieurs requêtes sont arrivées Plusieurs requêtes arrivent en même temps du site web 2.Le pool de connexion va distribuer les requêtes selon les connexions disponibles Si aucune connexion nest disponible le pool empile la requête Les requêtes sont dépilées (FIFO) au fur et à mesure de la disponibilité des connexions 3.Le serveur WEB X3 utilise une des connexions pour traiter la demande Le nombre de connexion dépend du paramétrage du serveur de web service Et du nombre total de licence web service disponible sur le serveur X3 Requête 1 Requête 2 Requête 3 Requête 4 Requête 5 Requête 1 Requête 2 Requête 3 Requête 4 Requête Fonctionnement du pool de connexion


Télécharger ppt "Www.adonix.fr Formation Web Services Adonix. Groupe ADONIX // 2 www.adonix.fr Sommaire 1. Présentation 1. Présentation 2. Principe de fonctionnement 2."

Présentations similaires


Annonces Google