Application de scénario de magasin point de vente iseries. Version 5.1 pour Windows

Transcription

1 Application de scénario de magasin point de ente iseries Version 5.1 pour Windows

2

3 Application de scénario de magasin point de ente iseries Version 5.1 pour Windows

4 ii Application de scénario de magasin point de ente iseries

5 Table des matières Ais aux lecteurs canadiens Chapitre 1. Introduction à l application de scénario de magasin point de ente iseries Scénarios basés sur des projets Chapitre 2. Concepts technologiques.. 5 Chapitre 3. Exécution du scénario... 9 Aant de commencer Installation des fichiers exemple Restauration des fichiers.saf Modification de la liste des bibliothèques...11 Importation et exécution de l application dans Deelopment Studio Extraction des fichiers.zip sur otre système local Création des projets Web Importation de fichiers de projet Web Importation de fichiers de projet WebFacing et création du projet WebFacing Configuration du sereur Configuration du projet WebFacing Définition des informations relaties au sereur 17 Exécution de l application dans l atelier Exécution de l application en tant que client dans l atelier Exécution de l application en tant qu administrateur dans l atelier Déploiement de l application de scénario sur WebSphere Application Serer Configuration de WebSphere Application Serer 20 Sécurisation de la page de l administrateur...21 Création de fichiers EAR pour le déploiement iseries WebSphere Application Serer Déploiement des fichiers EAR sur iseries WebSphere Application Serer Exécution de l application sur WebSphere Application Serer Chapitre 4. Module d initiation 1 : Création d un serice Web pour afficher le prix des produits (SV000514) 25 Introduction Aant de commencer Création d un noueau projet Web Définition des informations relaties au sereur iseries Création du programme de serice RPG Création des paramètres et génération du bean Jaa Création d un serice Web à partir du bean Jaa 28 Test du modèle Chapitre 5. Module d initiation 2 : Création d une interface pour afficher le stock et les articles commandés (SV000501) Introduction Aant de commencer Création d un projet WebFacing Conersion de la source DDS Configuration UTF-8 dans l atelier Pour les utilisateurs WAS ersion 4.0 uniquement...34 Configuration UTF-8 pour WebSphere Application Serer Création d une feuille de style (Facultatif) Personnalisation manuelle de la feuille de style en cascade Extension et amélioration de otre projet WebFacing aec une interaction Web Liaison du projet aec une interaction Web Publication des fichiers et redémarrage du sereur 40 Test de l interface Chapitre 6. Module 1 aancé : Création de code HTML, de serlets et de fichiers JSP pour passer des commandes client sur un sereur iseries (SV001585) Introduction Récapitulatif des grandes étapes Aant de commencer Création de la page Web, des serlets et des fichiers JSP Chapitre 7. Module 2 aancé : Création d un projet Web qui utilise les serices Web SV et SV (SV000618) 55 Introduction Aant de commencer Création des pages Web, des serlets, des fichiers JSP et du code RPG Aant le déploiement sur WebSphere Application Serer Chapitre 8. Remarques LICENCE DE COPYRIGHT Informations relaties à l interface de programmation Marques iii

6 i Application de scénario de magasin point de ente iseries

7 Ais aux lecteurs canadiens Le présent document a été traduit en France. Voici les principales différences et particularités dont ous deez tenir compte. Illustrations Les illustrations sont fournies à titre d exemple. Certaines peuent contenir des données propres à la France. Terminologie La terminologie des titres IBM peut différer d un pays à l autre. Reportez-ous au tableau ci-dessous, au besoin. IBM France ingénieur commercial agence commerciale ingénieur technico-commercial inspecteur IBM Canada représentant succursale informaticien technicien du matériel Claiers Les lettres sont disposées différemment : le claier français est de type AZERTY, et le claier français-canadien de type QWERTY. OS/2 et Windows - Paramètres canadiens Au Canada, on utilise : les pages de codes 850 (multilingue) et 863 (français-canadien), le code pays 002, le code claier CF. Nomenclature Les touches présentées dans le tableau d équialence suiant sont libellées différemment selon qu il s agit du claier de la France, du claier du Canada ou du claier des États-Unis. Reportez-ous à ce tableau pour faire correspondre les touches françaises figurant dans le présent document aux touches de otre claier.

8 Breets Il est possible qu IBM détienne des breets ou qu elle ait déposé des demandes de breets portant sur certains sujets abordés dans ce document. Le fait qu IBM ous fournisse le présent document ne signifie pas qu elle ous accorde un permis d utilisation de ces breets. Vous pouez enoyer, par écrit, os demandes de renseignements relaties aux permis d utilisation au directeur général des relations commerciales d IBM, 3600 Steeles Aenue East, Markham, Ontario, L3R 9Z7. Assistance téléphonique Si ous aez besoin d assistance ou si ous oulez commander du matériel, des logiciels et des publications IBM, contactez IBM direct au i Application de scénario de magasin point de ente iseries

9 Chapitre 1. Introduction à l application de scénario de magasin point de ente iseries Ce module de scénario est un modèle d application déeloppé à l aide d IBM WebSphere Deelopment Studio Client for iseries, la technologie Eclipse du sereur iseries. Ce scénario s adresse aux déeloppeurs qui souhaitent utiliser un sereur iseries pour effectuer les tâches suiantes : Déeloppement Jaa Déeloppement Web Gestion et transformation de code RPG en applications Web Cette application comprend deux fichiers.saf que ous deez restaurer sur otre sereur iseries et cinq fichiers.zip que ous deez importer dans le produit client. Ils forment une série de pages Web comprenant des URL désignant différents points du processus. Remarque importante : Pour prendre connaissance de tous les modules de mise à jour, correctifs et autres informations, consultez notre page de support : ibm.com/software/awdtools/wdt400/support/. Ce scénario porte sur différents composants du produit, en particulier sur des composants iseries spécifiques : Outil IBM WebFacing Serices Web Outils de déeloppement Web pour iseries (assistant d interaction Web et assistant d appel de programme inclus) Outils de déeloppement Jaa pour iseries IBM Toolbox for Jaa Le scénario illustre la situation de deux entreprises, un grossiste et un magasin de êtements, qui traaillent ensemble et utilisent leur sereur iseries pour la logique et les données de gestion. Dans le passé, ces entreprises communiquaient par courrier électronique, par téléphone et par fax pour érifier le stock, passer et suire les commandes. A présent, elles enisagent d utiliser le Web pour traiter leurs transactions commerciales standard. Le magasin point de ente souhaite disposer d un site Web où : Les clients peuent acheter des produits Les employés peuent acheter du stock auprès du grossiste Le grossiste souhaite : Receoir en ligne les commandes du détaillant pour le suii Serir de nombreux clients potentiels Dans ce scénario, ous jouerez le rôle du consultant en programmation des deux entreprises en les aidant à mettre leur entreprise sur le Web. L application possède différents points d entrée en fonction du type d utilisateur. Si ous êtes un client, ous commencez par isualiser les produits proposés par le magasin (des êtements de loisirs, dans notre cas). Si ous souhaitez effectuer un 1

10 achat, ous pouez cliquer sur un lien pour accéder à un écran de commande. Lorsque ous aez passé otre commande, une page récapitulatie est générée et ous pouez poursuire os achats, annuler ou confirmer la commande. Si ous êtes un administrateur, ous disposez d un ID utilisateur sécurisé pour accéder à cette application. Il est donc nécessaire de définir la stratégie de sécurité de cette application lors du déploiement. Votre point d entrée est un écran de connexion, qui ous permet de isualiser os commandes, de isualiser le stock et de commander des produits auprès du grossiste. Vous pouez sélectionner des articles, érifier le prix de gros le plus récent et commander des articles dans la taille et la quantité de otre choix. L application érifie si le grossiste dispose de la taille et de la quantité que ous souhaitez, puis confirme la commande ou indique qu il ne peut pas honorer la commande pour le moment. Dans l ombre, l application exécute de nombreuses actions portant sur les différents composants du produit. Le tableau suiant présente le processus et les composants du produit pour chaque partie de l application. Consultez les informations détaillées sur l exécution de chaque tâche. Tableau 1. Tâches de l application client Afficher les prix des produits Passer une commande auprès du magasin Visualiser la page Web initiale du magasin Tâches de l application administrateur Visualiser le stock Commander des produits au grossiste à l aide de l ID et de la quantité de marchandises Visualiser la page Web initiale du stock Processus sous-jacent Utilisez un programme RPG iseries pour créer un serice Web et des outils de déeloppement Web pour isualiser et afficher les prix. Utilisez les serlets et les fichiers JSP aec les outils de déeloppement Jaa iseries, les outils de déeloppement Web iseries et IBM Toolbox for Jaa pour accéder au stock et l afficher sur un sereur iseries, passer des commandes et afficher un récapitulatif des achats. Utilisez l outil IBM WebFacing pour conertir un programme RPG existant en application Web et utilisez les outils de déeloppement pour personnaliser la page Web. Créez un serice Web qui sera appelé lorsque ous appuyez sur le bouton Acheter. Utilisez les outils de déeloppement Web iseries pour créer les deux pages d accueil. Scénarios basés sur des projets L application de scénario iseries comprend cinq projets, appelés SV000501, SV000514, SV000618, SV et SV Le présent guide explique comment exécuter l application préintégrée. Il comprend également des modules d initiation et des modules aancés, qui ous expliquent comment générer les différents projets. Les modules d initiation s adressent aux déeloppeurs qui débutent dans le 2 Application de scénario de magasin point de ente iseries

11 déeloppement d applications et dans Deelopment Studio. Les modules aancés s adressent aux déeloppeurs qui connaissent bien le déeloppement d applications et Deelopment Studio Client. Remarque : Il existe cinq projets, mais seuls quatre modules sont fournis car les projets SV et SV sont des modules Serices Web combinés. Ce scénario se présente sous la forme de cinq projets : Projet SV : Création d un projet pour afficher les commandes en attente, le stock et les détails des produits Créé à l aide des Outils de déeloppement Web iseries et de l outil IBM WebFacing, ce projet s adresse aux programmeurs RPG connaissant peu le déeloppement d applications Web et souhaitant utiliser l outil IBM WebFacing pour publier leurs applications RPG sur le Web. Projet SV : Création de code HTML, de serlets et de fichiers JSP pour passer des commandes client sur un sereur iseries Ce projet utilise les classes SQL et JDBC d IBM Toolbox for Jaa, le bean RecordIOManager des Outils de déeloppement Jaa iseries et l assistant d appel de programme iseries. Ces éléments présentent différentes méthodes pour accéder et manipuler des données et des programmes résidant sur le sereur iseries. Ce projet s adresse aux programmeurs Jaa et aux déeloppeurs d applications Web souhaitant déelopper des pages Web pour accéder aux données et au code iseries. Par ailleurs, ous deez disposer de connaissances en matière de gestion de sereurs iseries et de programmation RPG. Projet SV : Création d un serice Web iseries pour afficher les prix des produits L assistant de serices Web utilise un bean Jaa généré par l assistant d appel de programme iseries pour appeler une ou plusieurs procédures de programme sur le sereur iseries et renoyer les informations à un naigateur. Ce projet s adresse aux programmeurs RPG souhaitant utiliser Serices Web pour créer des applications modulaires et autonomes pouant être décrites, publiées, localisées et appelées sur le Web. Projet SV : Création d un serice Web pour passer des commandes auprès du grossiste ia un sereur iseries Ce serice Web accepte un ID marchandise et la quantité demandée, puis effectue la commande auprès du grossiste. Ce projet est un composant du projet SV et s adresse aux programmeurs RPG souhaitant créer des serices Web. Projet SV : Création d un projet Web comme interface entre le bon de commande, le formulaire de stock et l ordre d achat générés par l outil IBM WebFacing Ce projet requiert les Outils de déeloppement Web iseries et comprend la création de fichiers HTML et JSP pour utiliser et connecter les serices Web déeloppés dans les projets SV et SV Ce projet s adresse aux déeloppeurs souhaitant utiliser Serices Web et connaissant la programmation RPG et Jaa. Chapitre 1. Introduction à l application de scénario de magasin point de ente iseries 3

12 4 Application de scénario de magasin point de ente iseries

13 Chapitre 2. Concepts technologiques Pour pouoir utiliser l application de scénario, ous deez connaître un certain nombre de concepts technologiques, en particulier si ous débutez dans le déeloppement d applications Web. La liste suiante présente certains concepts que ous rencontrerez lors de l utilisation de cette application. Fichier archie d entreprise (EAR) Les fichiers EAR sont des fichiers d archie Jaa (JAR) standard portant une extension.ear. Ils peuent contenir plusieurs projets Web. Vous pouez utiliser ces fichiers pour regrouper et déployer os propres applications Web sur le sereur WAS (WebSphere Administratie Serer). Remarque : Dans l interface graphique de l outil de déploiement d applications J2EE SDK, ous deez créer un fichier EAR et ajouter les fichiers JAR et WAR (Web Archie) au fichier EAR. Si ous utilisez les outils de mise en forme de ligne de commande, ous deez créer dans un premier temps les fichiers JAR et WAR, puis le fichier EAR. Outil IBM WebFacing L Outil WebFacing permet de conertir des interfaces 5250 existantes en interfaces utilisateur graphiques fonctionnant ia un naigateur. En apportant peu ou aucune modification aux applications iseries d origine, ous pouez étendre l utilisation des programmes à Internet ou à l intranet. Fichier d archie Jaa (JAR) Les fichiers JAR sont des modules compressés de fichiers Jaa, semblables à des fichiers.zip. Ils permettent de compresser les fichiers de classe, d images et de son d une applet Jaa dans un seul fichier pour un téléchargement plus rapide dans otre naigateur. Fichiers JSP (Jaa Serer Page) Les fichiers JSP permettent d afficher du contenu dynamique dans des pages HTML statiques. Ces fichiers écrits en Jaa dépendent du sereur et de la plateforme utilisés. En séparant la présentation et le contenu Web, les fichiers JSP facilitent le traail des déeloppeurs deant modifier rapidement l apparence et l affichage de leurs pages Web. Bean d appel de programme Il s agit des beans Jaa générés par l assistant d appel de programme. Le premier type de bean est un bean Jaa ordinaire utilisé par les applications Jaa. L autre type peut être utilisé par l assistant de serices Web pour créer un serice Web. Assistant d appel de programme L assistant d appel de programme ous aide à créer les beans Jaa et le fichier PCML associé requis pour appeler un programme ou une procédure iseries. Il ous inite à entrer des informations concernant des objets programme ou programme de serice, ainsi que les paramètres pour ces objets, puis crée les beans Jaa souhaités (et un fichier PCML). 5

14 Langage RPG (Report Program Generator) Il s agit d un langage de programmation procédural utilisé par les programmeurs iseries. Il ous permet de créer des application de gestion (programmes de facturation et de saisie de demande, par exemple). La dernière ersion, ILE RPG IV, étend les fonctionnalités du langage RPG tout en prenant en charge l expérience des ersions précédentes par le programmeur. Serlet Il s agit de programmes côté sereur écrits en Jaa s exécutant sur des sereurs disposant de fonctions Jaa ou sur des sereurs d applications comme IBM WebSphere Application Serer. Les serlets effectuent les tâches spécifiées par le sereur (en générant une réponse HTML pour répondre à des requêtes, par exemple). Par exemple, ous pouez les utiliser dans une application bancaire en ligne pour répondre à l utilisateur tout en transmettant des données au sereur. Composants Web Les composants Web permettent de définir des objets iseries, notamment des zones de saisie de données et des boutons de fonction, pour échanger des informations entre des programmes de sereur iseries et la page Web. Les déeloppeurs peuent utiliser des composants Web pour enregistrer des éénements client (érification de la syntaxe des zones d entrée et clic de bouton, par exemple). Assistant d interaction Web Cet assistant fait partie des Outils de déeloppement Web iseries. Il permet de créer et de gérer les interactions entre les programmes ILE et les pages Web. L assistant sureille l affichage des données d entrée, de sortie et des messages d erreur, puis dirige les données des zones d entrée et de sortie ers les programmes ILE. Vous pouez également utiliser l assistant d interaction Web pour mapper des messages d erreur sur la zone où l erreur s est produite pour permettre à l utilisateur d identifier facilement la source de l erreur. Serices Web Les serices Web sont des applications conçues et implémentées pour être utilisées ia Internet. Ils sont créés à l aide de normes ouertes comme SOAP, WSDL et XML. Les serices Web peuent être utilisés dans des situations professionnelles ariées, notamment dans un système de gestion des stocks pour permettre aux clients de érifier le nieau des stocks ia Internet ou de suire une commande directement depuis un fournisseur. Langage WDSL (Web Serices Definition Language) Le langage WSDL est un langage XML, qui définit l interface d un serice Web. Il peut interpréter un serice Web et gérer le flux des informations entre le serice Web et le programme de sereur. Par exemple, les déeloppeurs utilisent le langage WSDL pour créer l interface d un site Web qui affiche le cours des actions. 6 Application de scénario de magasin point de ente iseries

15 WebSphere Studio Workbench IBM WebSphere Deelopment Studio Client for iseries s appuie sur WebSphere Studio Workbench, l implémentation IBM de la plateforme Eclipse. Extensible et uniersel, l atelier comprend tous les outils nécessaires pour créer et gérer des applications. Les déeloppeurs peuent utiliser Deelopment Studio pour intégrer de noueaux objets à l enironnement de déeloppement grâce à des plug-ins et ajouter en transparence des fichiers Jaa, des graphiques, de la idéo, etc. Chapitre 2. Concepts technologiques 7

16 8 Application de scénario de magasin point de ente iseries

17 Chapitre 3. Exécution du scénario Aant de commencer Vous pouez exécuter les applications Wholesale et Retail store dans l atelier Deelopment Studio ou sur WebSphere Application Serer pour toutes les plateformes, notamment la plateforme iseries. Pour obtenir une présentation des applications, consultez le Chapitre 1, «Introduction à l application de scénario de magasin point de ente iseries», à la page 1. A la fin de ce chapitre, ous serez à même d effectuer les tâches suiantes : Restaurer les fichiers exemple et les objets Deelopment Studio Client sur otre sereur iseries Créer des projets Web et un projet WebFacing pour stocker les fichiers Importer les fichiers restaurés depuis otre sereur iseries dans Deelopment Studio Client Configurer le sereur WebSphere Application Serer (WAS) Configurer le projet WebFacing Exécuter l application en tant que client dans l enironnement de test WebSphere Exécuter l application en tant qu administrateur dans l enironnement de test WebSphere Configurer otre sereur WebSphere Application Serer Sécuriser la page de l administrateur Créer des fichiers EAR pour le déploiement WAS externe Déployer l application sur le sereur WAS Exécuter l application sur le sereur WAS Pour tester les applications à partir de l atelier, ous deez érifier les points suiants : Installation des fichiers exemple Vous disposez d un sereur iseries V5R1 ou plus récent. Vous aez installé les derniers correctifs WebFacing. Consultez notre page de support pour les correctifs : Vous disposez d un accès NET USE sur le sereur iseries. Pour utiliser l application de scénario iseries, les fichiers suiants sont nécessaires : Wholesale.saf Retailstor.saf Qdtssfl.saf SV zip SV zip SV zip SV zip SV zip 9

18 Les fichiers.saf contiennent des données iseries et des programmes RPG. Les fichiers.zip contiennent les applications Web qui interagissent aec les programmes iseries pour manipuler les données iseries. Dans un premier temps, ous deez restaurer les fichiers.saf sur otre sereur iseries. Vous deez ensuite importer les fichiers.zip dans Deelopment Studio Client et exécuter l application dans l atelier. Restauration des fichiers.saf Pour utiliser les exemples de ce guide, ous deez restaurer les bibliothèques WHOLESALE et RETAILSTOR sur otre sereur iseries. Vous deez le faire même si ous aez déjà restauré les bibliothèques d une ersion précédente du produit, car leur contenu est différent. Remarque : Les fichiers.saf utilisés pour installer l exemple de bibliothèque doient être utilisés aec un sereur iseries V5R1 ou ultérieur. Pour les besoins de ce scénario, les deux bibliothèques sont restaurées sur le même sereur iseries. Si ous déeloppiez cette application pour une entreprise réelle, ous restaureriez les deux bibliothèques sur deux systèmes sereur iseries différents. Vous restaureriez la bibliothèque WHOLESALE sur le sereur iseries qui fournit les serices Web et la bibliothèque RETAILSTOR sur le sereur iseries du magasin point de ente. Pour restaurer le fichier Wholesale.saf, procédez comme suit : 1. Connectez-ous à otre sereur iseries ia un émulateur. a. Créez une bibliothèque pour stocker les fichiers de sauegarde. Pour créer une nouelle bibliothèque dans l émulateur, tapez CRTLIB. b. Nommez otre bibliothèque SCENARIO. c. Passez à la ligne suiante, indiquez *TEST comme type de bibliothèque et appuyez sur Entrée pour enregistrer les modifications. d. Créez deux fichiers de sauegarde à l aide de la commande CRTSAVF, en appuyant sur Entrée entre les deux lignes : CRTSAVF FILE(SCENARIO/WHOLESALE) CRTSAVF FILE(SCENARIO/RETAILSTOR) Ces lignes indiquent que ous souhaitez créer des fichiers de sauegarde dans otre bibliothèque Scenario. 2. Sur le poste de traail, ourez une fenêtre d inite. a. Vous deez ous placer dans le répertoire contenant les fichiers.saf. Par défaut, ous deez entrer cd c:\wdsc\wdscsampl. Si ous aez installé le produit dans un répertoire différent ou si ous aez choisi de ne pas utiliser wdsc comme répertoire principal pour Deelopment Studio Client, placez-ous dans le répertoire wdscsampl où ous aez installé le produit. b. Sur la ligne de commande, entrez : ftp nom_hôte, où nom_hôte représente le nom de otre sereur iseries (PROD400, par exemple). c. Entrez otre ID utilisateur et otre mot de passe pour le sereur iseries. d. Sur la ligne de commande, entrez cd /qsys.lib/scenario.lib pour ous placer dans otre bibliothèque Scenario. e. Entrez les lignes suiantes : bin put WHOLESALE.saf WHOLESALE.saf put RETAILSTOR.saf RETAILSTOR.saf quit 10 Application de scénario de magasin point de ente iseries

19 Ces lignes indiquent que ous souhaitez déplacer les fichiers de sauegarde de otre système local dans le sereur iseries. 3. De retour dans la console iseries, restaurez otre bibliothèque Wholesale : a. Entrez RSTLIB et appuyez sur F4 pour définir le mode de restauration de la bibliothèque. b. Dans la zone Bibliothèque sauegardée, tapez WHOLESALE et appuyez sur la touche de tabulation. c. Dans la zone Unité, tapez *saf et appuyez sur la touche de tabulation. d. Dans la zone suiante, appuyez sur Entrée pour afficher les autres aleurs et appuyez sur la touche de tabulation pour passer à la zone Fichier de sauegarde. e. Dans la zone Fichier de sauegarde, tapez WHOLESALE et appuyez sur la touche de tabulation. f. Dans la zone Bibliothèque, supprimez la aleur et tapez scenario. g. Appuyez sur Entrée pour restaurer la bibliothèque WHOLESALE sur otre sereur iseries. 4. Répétez cette procédure pour le fichier Retailstor.saf : a. Entrez RSTLIB et appuyez sur F4 pour définir le mode de restauration de la bibliothèque. b. Dans la zone Bibliothèque sauegardée, tapez RETAILSTOR et appuyez sur la touche de tabulation. c. Dans la zone Unité, tapez *saf et appuyez sur la touche de tabulation. d. Dans la zone suiante, appuyez sur Entrée pour afficher les autres aleurs et appuyez sur la touche de tabulation pour passer à la zone Fichier de sauegarde. e. Dans la zone Fichier de sauegarde, tapez RETAILSTOR et appuyez sur la touche de tabulation. f. Dans la zone Bibliothèque, supprimez la aleur et tapez scenario. g. Appuyez sur Entrée pour sauegarder otre action et restaurer la bibliothèque RETAILSTOR sur otre sereur iseries. Modification de la liste des bibliothèques Même si ous aez restauré les bibliothèques RETAILSTOR et WHOLESALE sur otre sereur iseries, ous deez érifier qu elles figurent dans la liste des bibliothèques que ous utilisez lorsque ous ous connectez au sereur. Dans le cas contraire, os applications Web risquent de ne pas trouer les bibliothèques et ous risquez de rencontrer des problèmes lors de l exécution ou de la compilation des applications. Vous deez également érifier que la bibliothèque QGPL figure dans la liste des bibliothèques. Pour ce faire, ous deez mettre à jour la description de traail et otre profil utilisateur pour que les modifications apportées à otre liste des bibliothèques deiennent permanentes. Les méthodes utilisées pour modifier les listes des bibliothèques dépendent des utilisateurs. Si ous ne saez pas quelle méthode utiliser, oici un exemple : 1. Sur otre sereur iseries, tapez dsplibl et appuyez sur Entrée pour afficher la liste de os bibliothèques. Chapitre 3. Exécution du scénario 11

20 2. Vérifiez que les bibliothèques RETAILSTOR, WHOLESALE et QGPL figurent dans otre liste des bibliothèques. Si c est le cas, ous pouez fermer la fenêtre de l émulateur. Si ce n est pas le cas : a. Appuyez sur F12 pour quitter l écran. b. Recherchez le nom de la description de traail. Pour ce faire, tapez dspusrprf nom_utilisateur et appuyez sur Entrée pour afficher otre profil utilisateur (nom_utilisateur est l ID que ous utilisez pour ous connecter au sereur iseries). La description de traail figure sur l une des pages de otre profil utilisateur (faites défiler l écran ers le bas pour y accéder). Lorsque ous l aez trouée, notez son nom et appuyez sur F12 pour quitter l écran. c. Sur la ligne de commande, tapez chgjobd et appuyez sur F4. d. Dans la zone Description de traail, tapez le nom de otre description de traail et appuyez sur F10 pour afficher les autres paramètres. e. Descendez jusqu à Liste des bibliothèques initiale. f. Dans la zone située sous Liste des bibliothèques initiale, la mention + si autres aleurs apparaît. Tapez le signe plus et appuyez sur Entrée. g. Dans la page Spécifiez d autres aleurs, supprimez les entrées éentuelles et tapez RETAILSTOR, WHOLESALE et QGPL, en séparant chaque aleur par une tabulation. Vous deez taper les noms des bibliothèques dans cet ordre car les applications doient d abord trouer la bibliothèque RETAILSTOR. Appuyez sur Entrée. h. Appuyez à noueau sur Entrée pour enregistrer os modifications. i. Sur la ligne de commande, tapez chgusrprf et appuyez sur Entrée. j. Tapez otre nom d utilisateur et appuyez sur Entrée. k. Appuyez sur F10 pour afficher les autres paramètres. l. Descendez jusqu à Description du traail. m. Si le nom de otre description de traail ne correspond pas à la description de tâche que ous aez trouée à l aide de la commande dspusrprf, tapez le nom de la description de traail trouée par cette commande et appuyez sur Entrée pour sauegarder os modifications. Importation et exécution de l application dans Deelopment Studio Les fichiers du programme installé comprennent cinq fichiers zip pour Deelopment Studio Client, qui se trouent par défaut dans le répertoire c:\wdsc\wdscsampl. Ces fichiers sont les suiants : SV zip SV zip SV zip SV zip SV zip Vous derez les importer un pas un dans l atelier Deelopment Studio Client et spécifier un fichier EAR (Enterprise Archie) pour chacun. Les fichiers EAR sont des fichiers d archie Jaa (JAR) standard portant une extension.ear. Ils peuent contenir plusieurs projets Web. Vous pouez utiliser ces fichiers pour regrouper et déployer os propres applications Web sur le sereur WAS (WebSphere Administratie Serer). 12 Application de scénario de magasin point de ente iseries

21 Les quatre premiers fichiers correspondent aux projets Web et le cinquième fichier correspond à un projet WebFacing. Vous deez d abord créer les projets Web, puis le projet WebFacing. Ensuite, importez le contenu des fichiers zip dans les cinq projets. Extraction des fichiers.zip sur otre système local Aant de pouoir importer le contenu des fichiers.zip dans l atelier Deelopment Studio Client, ous deez les extraire dans des répertoires séparés, de façon à pouoir les importer sous forme de systèmes de fichiers au lieu de fichiers.zip. Remarque : Si ous utilisez un programme autre que WinZip, effectuez les tâches comme à otre habitude aec ce programme. 1. Sur otre système local, placez-ous dans c:\wdsc\wdscsampl. Le répertoire c:\wdsc peut être différent si ous aez choisi d installer le programme sur un lecteur ou dans un répertoire de base différent. Si c est le cas, placez-ous dans ce répertoire et recherchez \wdscsampl. 2. Cliquez deux fois sur le fichier SV zip. 3. Cliquez sur le bouton Extraire et placez-ous dans le dossier où se trouent les fichiers zip, par défaut, c:\wdsc\wdscsampl. 4. Sélectionnez le bouton d option Tous les fichiers puis cliquez sur Extraire. 5. Si ous regardez dans otre répertoire wdscsampl, ous errez qu un dossier SV est créé, comportant tous les fichiers nécessaires. 6. Maintenant que tous les fichiers sont extraits dans c:\scenario\sv000501, supprimez le fichier SV zip pour éiter de le sélectionner accidentellement lorsque ous importerez otre système de fichiers. 7. Répétez la même procédure pour les quatre autres fichiers.zip (SV zip, SV zip, SV zip et SV zip). Création des projets Web Dans cette section, ous allez créez les projets Web pour SV000514, SV000618, SV et SV Les procédures de création de chaque projet sont présentées indiiduellement. Même si ces procédures semblent répétities, notez que les quelques différences mineures sont importantes lors de la création des quatre projets (notamment pour saoir quels fichiers EAR sont associés à quels projets). Pour créer les projets Web : 1. Dans le menu Démarrer, ourez IBM WebSphere Deelopment Studio Client for iseries. 2. Dans Deelopment Studio Client, ourez la perspectie Web à partir de la barre de menus en cliquant sur Fenêtre > Ourir une perspectie > Autre > Web et cliquez sur OK. 3. Cliquez sur Fichier > Noueau > Projet Web dynamique. a. Dans la zone Nom du projet, tapez SV b. Cochez la case Configurer les options aancées et cliquez sur Suiant. c. Cliquez sur le bouton Noueau en regard de la zone Projet EAR. d. Dans la zone Nom du projet, tapez SVWholeSaleEAR et cliquez sur Fin dans les deux boîtes de dialogue. 4. Cliquez sur Fichier > Noueau > Projet Web dynamique. a. Dans la zone Nom du projet, entrez SV et cliquez sur Suiant (la case Configurer les options aancées doit se cocher automatiquement). Chapitre 3. Exécution du scénario 13

22 b. Vérifiez que SWholeSaleEAR est sélectionné dans la zone déroulante Projet EAR. c. Cliquez sur Fin. 5. Cliquez sur Fichier > Noueau > Projet Web dynamique. a. Dans la zone Nom du projet, tapez SV et cliquez sur Suiant. b. Cliquez sur le bouton Noueau en regard de la zone Projet EAR. c. Dans la zone Noueau nom de projet, tapez SVStoreEAR et cliquez sur Fin dans les deux boîtes de dialogue. 6. Cliquez sur Fichier > Noueau > Projet Web dynamique. a. Dans la zone Nom du projet, tapez SV et cliquez sur Suiant. b. Vérifiez que SVStoreEAR est sélectionné dans la zone déroulante Projet EAR. c. Cliquez sur Fin. Importation de fichiers de projet Web Pour importer les systèmes de fichiers dans otre espace de traail, exécutez la procédure suiante pour importer les fichiers SV La procédure est identique pour les trois autres systèmes de fichiers du projet Web (SV001586, SV et SV000618). La section qui suit celle-ci décrit comment créer et importer le projet WebFacing. Pour importer les fichiers : 1. Cliquez aec le bouton droit de la souris sur le dossier SV et sélectionnez Importer. 2. Dans l assistant Importation, cliquez sur Système de fichiers et sur Suiant. 3. Placez-ous dans le répertoire où ous aez extrait les fichiers de scénario ; par défaut, ce derait être c:\wdsc\wdscsampl. 4. Cliquez sur SV000514, puis sur OK. 5. Cliquez sur Sélectionner tout pour sélectionner l ensemble des composants du système de fichiers SV Dans la zone Dans le dossier, entrez SV si ce numéro n apparaît pas par défaut. 7. Cochez la case Remplacer les ressources existantes sans aertissement. 8. Si des boîtes de dialogue ous demandent si ous souhaitez modifier la racine de contexte, cliquez sur Fin et sur Oui. 9. Répétez les étapes 2 à 9 pour les dossiers SV001586, SV et SV en eillant à utiliser les différents noms de projet à mesure que ous exécutez les étapes. Importation de fichiers de projet WebFacing et création du projet WebFacing Le projet SV est différent des quatre projets Web que ous enez de créer car SV est un projet WebFacing. Les projets WebFacing sont différents car ils comprennent des fichiers différents et possèdent une structure unique, spécialement conçue pour le traitement de fichiers DDS sur otre sereur iseries. Pour importer les fichiers et créer un projet WebFacing : 1. Si ous ne ous trouez pas dans la ue du naigateur, cliquez sur l onglet Naigateur de projet. 2. Cliquez aec le bouton droit de la souris sur la ue et sélectionnez Importer. 14 Application de scénario de magasin point de ente iseries

23 3. Dans la fenêtre Importation, sélectionnez Projets WebFacing et cliquez sur Suiant. 4. Placez-ous dans le répertoire où ous aez extrait les fichiers de scénario ; par défaut, ce derait être c:\wdsc\wdscsampl. 5. Sélectionnez SV000501, puis cliquez sur OK. Cliquez sur Suiant. 6. Dans la zone Projets WebFacing troués de la fenêtre, sélectionnez la case à cocher SV Dans la zone Projet d application d entreprise (EAR), tapez SVStoreEAR. 8. Cliquez sur Fin. Maintenant que ous aez importé tous les fichiers, otre espace de traail doit ressembler à l écran suiant : Si des erreurs sont signalées en regard des projets importés (représentées par des marques x rouges), cliquez aec le bouton droit de la souris sur chaque projet et sélectionnez Reconstruire le projet. Selon le contenu de otre espace de traail, cela derait résoudre la plupart des erreurs et permettre à l application de fonctionner correctement. Si des erreurs persistent, cela peut être dû au code, qui n a pas entièrement migré ers la ersion 5.1 de Deelopment Studio Client. Vous pouez poursuire les exercices de ce chapitre pour ous familiariser aec le produit, ou bien passer au chapitre suiant pour essayer de compiler les applications à partir de zéro. Configuration du sereur Maintenant que ous aez importé tous les fichiers source, ous deez configurer le sereur de l enironnement de test WebSphere pour reconnaître les applications SVWholesaleEAR et SVStoreEAR. Pour configurer le sereur de l enironnement de test WebSphere : 1. Ourez la perspectie du sereur. Dans la barre de menus de l atelier, cliquez sur Fenêtre > Ourir une perspectie > Autre > Sereur et sur OK. Chapitre 3. Exécution du scénario 15

24 2. Dans la ue Configuration de sereur, cliquez aec le bouton droit de la souris sur Sereurs et sélectionnez Noueau > Sereur et configuration de sereur. 3. Dans la zone Nom de sereur, tapez Scenario Serer. 4. Dans la zone Dossier, tapez Scenario folder. 5. Dans la zone Type de sereur, déeloppez WebSphere ersion 5.0 et cliquez sur Enironnement de test, si cette option n est pas sélectionnée par défaut. 6. Cliquez sur Fin et sur Oui si ous receez des messages. 7. Pour ajouter des fichiers EAR à la configuration du sereur : a. Déeloppez Sereurs. b. Cliquez aec le bouton droit de la souris sur Scenario Serer et sélectionnez Ajouter > SVWholeSaleEAR. c. Déeloppez Sereurs. d. Cliquez de noueau aec le bouton droit de la souris sur Scenario serer et sélectionnez Ajouter et supprimer des projets. e. Cliquez sur le bouton Ajouter tout pour déplacer SVStoreEAR et SVWholeSaleEAR sur la droite de la fenêtre. f. Cliquez sur Fin. 8. Dans la ue Configuration du sereur, déeloppez Scenario Serer, SVStoreEAR et SVWholeSaleEAR pour afficher toutes les applications : Pour érifier que le sereur a sélectionné les projets : 1. Dans la ue Sereurs, à droite de la ue Configuration du sereur, cliquez aec le bouton droit de la souris sur Scenario serer et sélectionnez Publier. Si la ue Sereurs n apparaît pas, cliquez sur l onglet Sereurs. La boîte de dialogue Publication indique la progression du processus de publication. 2. Cliquez sur OK pour publier os applications dans l enironnement de test WebSphere Application Serer. 3. Une fois la publication terminée, cliquez sur OK dans la boîte de dialogue. 4. Dans la même ue, cliquez à noueau aec le bouton droit de la souris sur Scenario Serer et cliquez sur Démarrer. La ue Console affiche les actiités 16 Application de scénario de magasin point de ente iseries

25 du sereur. Le sereur est lancé lorsque la mention Sereur nom_sereur ouert pour e-business apparaît en bas de la ue. Faites défiler l écran pour afficher l ensemble des messages. Configuration du projet WebFacing Aant d exécuter l application ou d utiliser le module SV000501, ous deez démarrer le sereur WebFacing associé à l application à exécuter et configurer le projet pour qu il utilise le sereur iseries approprié. Pour lancer le sereur WebFacing : 1. Ourez un émulateur 5250, puis connectez-ous à l aide de otre ID utilisateur et de otre mot de passe. 2. Sur la ligne de commande, tapez strtcpsr *webfacing. 3. Le message Démarrage du sereur WEBFACING apparaît en bas de l écran. Vous deez maintenant modifier les propriétés WebFacing en reenant à l atelier Deelopment Studio Client : 1. Ourez la perspectie Web (ous pouez passer d une perspectie à l autre en cliquant sur les icônes regroupées à gauche de l écran). 2. Cliquez sur l onglet Naigateur de projet pour afficher les structures des projets. 3. Déeloppez SV et cliquez deux fois sur Descripteur de déploiement Web. 4. Cliquez sur l onglet Paramètres. 5. Cliquez sur WFDefaultHost. 6. Dans la zone Valeur, supprimez la aleur existante et tapez le nom de otre sereur iseries. 7. Dans la barre de menus de l atelier, cliquez sur l icône de sauegarde ou sur Fichier > Sauegarder le descripteur de déploiement Web. Si des messages apparaissent, cliquez sur OK. Fermez le fichier. Définition des informations relaties au sereur Vous deez maintenant définir les informations du sereur iseries pour l ensemble des cinq projets, en érifiant qu ils sont configurés pour être exécutés sur otre sereur iseries aec otre ID utilisateur et otre mot de passe. Pour définir les informations relaties au sereur : 1. Vérifiez que ous ous trouez bien dans la perspectie Web. 2. Dans la ue Naigateur de projet, cliquez aec le bouton droit de la souris sur SV et sélectionnez Spécification de la configuration d exécution des outils Web iseries. 3. Dans la zone Nom de sereur iseries, supprimez la aleur existante et tapez le nom du sereur iseries. 4. Supprimez les autres aleurs, puis tapez otre ID utilisateur et otre mot de passe. 5. Cliquez sur Fin (cliquez à noueau sur Fin, si nécessaire). 6. Répétez les étapes 2 à 5 pour les autres projets (SV000514, SV000618, SV et SV001586). Chapitre 3. Exécution du scénario 17

26 Exécution de l application dans l atelier A ce stade, ous pouez exécuter l application dans l enironnement de test WebSphere de l atelier. Si ous êtes satisfait de son exécution, ous pouez exporter le fichier EAR ers le sereur et le déployer sur le sereur iseries WebSphere Application Serer. Exécution de l application en tant que client dans l atelier En tant que client, ous arriez sur la page Web d achat du magasin point de ente, ous parcourez les articles et ous commandez une quantité et une taille. Remarque : Vous risquez de rencontrer des problèmes si ous tentez d exécuter l application derrière un pare-feu, car otre fichier web.xml recherche le fichier suiant : Pour résoudre ce problème, remplacez l instruction DOCTYPE des fichiers web.xml par la aleur suiante aant d exécuter l application :!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN" "x:/wdsc/eclipse/plugins/com.ibm.etools.j2ee/dtds/web-app_2_2.dtd" Où x:/wdsc représente le répertoire dans lequel ous aez installé le produit. En général, les fichiers web.xml figurent dans Nom de projet > Contenu Web > WEB-INF. Une fois le fichier ouert, cliquez sur l onglet Source pour modifier directement le fichier. Pour exécuter l application en tant que client dans l atelier : 1. Dans la perspectie Web, déeloppez SV > Contenu Web. 2. Cliquez aec le bouton droit de la souris sur shop.html et sélectionnez Exécuter sur le sereur. L application est lancée dans le naigateur de l atelier. 3. Cliquez sur Fin. 4. Ourez l application en cliquant sur l image des tee-shirts. 5. Essayez d entrer des aleurs sur la page suiante. Dans cet exemple, ous allez commander un pull-oer ou un blouson d aiateur, choisir la taille et la quantité, et ajouter des articles à otre panier : 18 Application de scénario de magasin point de ente iseries

27 La page qui affiche le texte your order has been processed correspond à la dernière page de l exemple. Dès que ous êtes satisfait de l exemple, ous pouez fermer le naigateur. Exécution de l application en tant qu administrateur dans l atelier En tant qu administrateur, ous arriez sur la page Web d administration du magasin point de ente, érifiez les commandes ou le stock. Pour exécuter l application en tant qu administrateur dans l atelier : 1. Dans la perspectie Web, déeloppez SV > Contenu Web. 2. Cliquez aec le bouton droit de la souris sur index.html et sélectionnez Exécuter sur le sereur. L application est lancée dans le naigateur de l atelier. 3. Cliquez sur l icône à gauche de Visualiser le stock pour afficher la page suiante, comme si ous étiez un administrateur chargé des achats pour otre magasin : Essayez de cliquer sur les icônes pour afficher les pages d administration. Déploiement de l application de scénario sur WebSphere Application Serer Maintenant que ous aez exécuté l application de scénario iseries dans l enironnement de test de l atelier, ous pouez déployer l application sur WebSphere Application Serer comme si ous exécutiez réellement l application. Aant de déployer l application, ous deez toutefois effectuer quelques ajustements, notamment sécuriser la page de l administrateur et modifier l URL d un serice Web, pour permettre à l application de désigner la page appropriée (comme indiqué dans les sections suiantes). Remarque : Le déploiement sur WebSphere Application Serer est facultatif ; ous pouez passer au chapitre suiant et terminer les modules sans tester l application sur WebSphere Application Serer. Chapitre 3. Exécution du scénario 19

28 Configuration de WebSphere Application Serer Au début du chapitre, ous aez consulté la section «Exécution de l application dans l atelier» à la page 18. Maintenant que ous aez déployé les fichiers sur le sereur iseries, ous pouez exécuter l application sur otre sereur iseries à l aide de WebSphere Application Serer. Pour déployer l application sur WebSphere Application Serer (facultatif), ous deez érifier les points suiants : Vous aez créé ou aez accès à l instance WebSphere Application Serer ersion 4.0, ersion 5.0 ou WebSphere Application Serer Express sur le sereur iseries, et l instance est en cours d exécution (uniquement si ous souhaitez tester le déploiement sur WebSphere Application Serer). Vous connaissez les numéros de port des instances HTTP et WebSphere Application Serer sur le sereur iseries. La console d administration WebSphere ersion 4.0 ou 5.0 est installée sur otre poste de traail. Remarque : Pour la ersion 5.0 de WAS, la console utilise un naigateur. Vous n aez donc pas besoin d installer une console sur otre poste de traail. Pour plus d informations sur les différentes ersions de WAS, consultez la documentation en ligne. Vos applications iseries compatibles Web utilisent WebSphere Application Serer pour exécuter les serlets Jaa et les fichiers JSP (JaaSerer Page), qui assurent la communication entre le naigateur Web de l utilisateur et les données ou programmes iseries. Pour prendre en charge os pages HTML et os fichiers JSP à partir du même système iseries, un sereur HTTP doit également être installé sur ce système. Nous ous conseillons d utiliser le sereur IBM HTTP motorisé par Apache. La documentation concernant l utilisation de ce sereur est disponible sur le site : IBM HTTP Serer for iseries Documentation Center à l adresse WebSphere Application Serer exécute des pages JSP, des beans Jaa et des serlets Jaa générés pour différents processus. Les principales ressources de documentation pour IBM WebSphere Application Serer for iseries et la console d administration IBM WebSphere pour iseries sont disponibles sur les sites suiants : WebSphere Application Serer IBM ersion 4.0 Adanced Edition pour iseries à l adresse WebSphere Application Serer IBM ersion 4.0 Adanced Single Serer Edition pour iseries à l adresse Nous ous recommandons iement de ous familiariser aec la documentation IBM WebSphere Application Serer, notamment les sections Modules J2EE, Installation de WebSphere Application Serer et Configuration de plusieurs instances du sereur d administration WebSphere. Vous deez au minimum effectuer les étapes du lien Installation. Utilisez le plan du site pour trouer des informations sur l installation, la configuration et les correctifs requis pour la console d administration WebSphere. 20 Application de scénario de magasin point de ente iseries

29 Sécurisation de la page de l administrateur Seules les personnes autorisées doient pouoir accéder à la page de l administrateur, index.html. Cette page doit donc être correctement sécurisée. La sécurisation peut être effectuée par programmation dans la logique d application Web ou ia la fonction de sécurité de WebSphere. Dans ce scénario, nous aons utilisé la fonction de sécurité de WebSphere pour sécuriser la page. Vous noterez que nous aons utilisé WebSphere Application Serer V4.0 Adanced Edition. Pour consulter les informations relaties à WebSphere Application Serer, consultez les sites Web suiants : WebSphere Application Serer IBM ersion 4.0 Adanced Edition pour iseries à l adresse WebSphere Application Serer IBM ersion 4.0 Adanced Single Serer Edition pour iseries à l adresse Page RedBooks pour WebSphere : Recherchez des RedBooks pour WebSphere Application Serer ersion 5.0 et WebSphere Application Serer Express Edition ersion 5.0 à l adresse Si ous utilisez une ersion différente de WebSphere Application Serer, consultez la documentation relatie à cette ersion en matière de sécurisation de ressources Web. Vous pouez configurer la sécurité des ressources Web, notamment des pages Web et des serlets, dans Deelopment Studio ou dans l outil d assemblage de l application. Pour ce scénario, nous allons utiliser Deelopment Studio. Pour passer en reue la configuration et les propriétés de sécurité de cette application Web : 1. Dans Deelopment Studio, ourez la perspectie Web. 2. Dans la ue Naigateur, déeloppez SV > Contenu Web > WEB-INF. 3. Cliquez deux fois sur web.xml pour ourir la ue web.xml. 4. Cliquez sur l onglet Security. 5. Pour sécuriser la page d administration (index.html), une contrainte de sécurité a également été définie. Dans la partie supérieure de la ue, cliquez sur Security Constraints. 6. Dans la liste, cliquez sur la première instance de SecurityContraint. 7. A droite, cliquez sur AdminPage. 8. Cliquez sur Edit pour appeler la boîte de dialogue Web Resource Collections. Les méthodes GET et POST du fichier index.html sont déjà sélectionnées. 9. Cliquez sur OK. Dans la section Security roles, le rôle de sécurité défini est Administrator. Au cours du déploiement, des personnes sont chargées de ce rôle et disposent donc d un accès à la page index.html. Dans la section Authorized roles, nous aons attribué le rôle d accès Administrator à cette contrainte de sécurité. Une fois la sécurité actiée, seuls les utilisateurs disposant du rôle Administrator ont accès à la page index.html à condition d aoir fourni les informations d identification appropriées (ID utilisateur et mot de passe). Lorsqu une ressource est sécurisée, WebSphere Application Serer tente d abord d authentifier l utilisateur. Le système effectue l authentification à l aide de certificats ou demande à l utilisateur Chapitre 3. Exécution du scénario 21