Vous êtes sur la page 1sur 223

Dveloppement des applications WebFacing

Remarque Certaines illustrations de ce manuel ne sont pas disponibles en franais la date d'dition.

Table des matires


Avis aux lecteurs canadiens . . . . . . v Chapitre 1. Prsentation de l'outil WebFacing . . . . . . . . . . . . . 1
Nouveauts de WebFacing . . . . . . . . . . 3 Modification des proprits d'un projet WebFacing Proprits de conversion . . . . . . . . . Schmas de reconnaissance des touches de commande . . . . . . . . . . . . . Libells des boutons des touches . . . . . . Options de code d'dition . . . . . . . . Options MNUDDS . . . . . . . . . . . Mtadonnes de l'enregistrement XML . . . . Proprits d'excution . . . . . . . . . . Proprits du projet . . . . . . . . . . <Commande CL> : proprits . . . . . . . Mappages des objets DDS . . . . . . . . Mappages des objets UIM . . . . . . . . Java EE . . . . . . . . . . . . . . . Actions de touche de commande . . . . . . Ecrans systme . . . . . . . . . . . . Proprits de style . . . . . . . . . . . Couleur de zone DDS . . . . . . . . . . Attributs d'affichage de la zone DDS . . . . . Fentre . . . . . . . . . . . . . . . Sous-fichier . . . . . . . . . . . . . Touches de commande . . . . . . . . . Modification du port utilis par vos applications WebFacing. . . . . . . . . . . . . . Extension de votre application WebFacing l'aide des actions de touches de commande . . . . . Libells des touches de commande et de fonction Dfinition des options d'authentification . . . . Descripteur de dploiement . . . . . . . . Gestion des styles WebFacing . . . . . . . . Cration et modification des styles WebFacing classiques . . . . . . . . . . . . . . Utilisation de la vue Styles WebFacing . . . . Modification du style d'un site Web . . . . . Exemple de style du concepteur de site Web . . Paramtres Web . . . . . . . . . . . . . Utilisation des paramtres Web avec le source DDS . . . . . . . . . . . . . . . . Modification des paramtres Web d'un membre DDS . . . . . . . . . . . . . . . . Description des paramtres Web . . . . . . Remarques sur les paramtres Web . . . . . Cration de fichiers de bibliothque JavaScript personnaliss . . . . . . . . . . . . . . Accessibilit de WebFacing . . . . . . . . . Interfaces utilisateur bidirectionnelles dans WebFacing. . . . . . . . . . . . . . . Dfinition de l'ordre de tabulation pour les applications bidirectionnelles . . . . . . . Dveloppement de vos services WebFacing l'aide d'un diagramme Web . . . . . . . . . . . Vrification de l'accs des utilisateurs l'application WebFacing. . . . . . . . . . . . . . . 29 30 30 30 31 32 32 32 32 35 36 36 36 36 36 37 37 38 39 39 40 41 42 43 43 53 54 56 57 58 60 61 61 63 64 82 84 85 89 91 92 93

Chapitre 2. Configuration de l'outil IBM WebFacing . . . . . . . . . . . . . 5


Configuration de WebSphere Application Server sur votre serveur IBM i . . . . . . . . . . . . 5 Configuration de WebSphere Portal sur le serveur IBM i . . . . . . . . . . . . . . . . . 6 Installation des modifications provisoires du logiciel (PTF) du serveur WebFacing sur le serveur IBM i . . 6 Dmarrage du serveur d'excution WebFacing sur le serveur IBM i . . . . . . . . . . . . . . 6 Transfert des applications converties sur le serveur IBM i . . . . . . . . . . . . . . . . . 7 Dmarrage et arrt du serveur WebFacing sur votre hte IBM i . . . . . . . . . . . . . . . 7 Configuration d'un serveur WebFacing pour plusieurs sous-systmes interactifs . . . . . . . 8 Modification du port utilis par le serveur WebFacing 9 Activation des licences . . . . . . . . . . 10

Chapitre 3. Cration d'un projet Web WebFacing . . . . . . . . . . . . . 13


Ouverture de la perspective WebFacing . . . . . Slection d'un style Web . . . . . . . . . . Slection des membres source convertir . . . . Spcification de commandes CL pour appeler votre application . . . . . . . . . . . . . . Fin du projet et conversion du source DDS . . . . Analyse des journaux de conversion . . . . . . Gestion des ressources d'un projet WebFacing . . . Exploitation d'applications IBM i non WebFacing par le biais de la transformation dynamique du flux de donnes . . . . . . . . . . . . . . Remarques relatives aux performances de WebFacing dans le plan de travail Eclipse . . . . 14 14 15 16 18 18 19

20 21

Chapitre 4. Cration d'un projet WebFacing activ pour HATS . . . . . 23


Liaison d'un projet compatible HATS/WebFacing un projet HATS . . . . . . . . . . . . . 23

Chapitre 5. Cration d'un projet de portlet WebFacing . . . . . . . . . . 25


Diffrences entre un projet de portlet WebFacing et un projet Web WebFacing. . . . . . . . . . 26

Chapitre 6. Personnalisation de vos applications WebFacing . . . . . . . 29 iii

Chapitre 7. Interoprabilit de WebFacing avec HATS et d'autres applications Web . . . . . . . . . . 95


Interoprabilit de WebFacing avec des applications HATS . . . . . . . . . . . . . . . . 96 Rgles relatives aux applications HATS/WebFacing . . . . . . . . . . . 96 Utilisation de la passerelle d'application WebFacing pour l'interaction avec d'autres applications Web . . 99 Appel par programmation d'applications WebFacing depuis d'autres applications Web . . . 102 Paramtres d'URL pouvant tre dtermins de manire dynamique . . . . . . . . . . . 103 Filtrage des commandes d'appel par programmation. . . . . . . . . . . . . 104 Exemples d'URL . . . . . . . . . . . . 104 Mthodes de servlet permettant d'appeler une application WebFacing par programmation . . . 105

Incidents et remarques relatifs la migration des paramtres Web . . . . . . . . . . . . 120

Chapitre 10. Identification et rsolution des incidents dans les applications WebFacing . . . . . . . 121
Collecte de donnes pour les applications WebFacing . . . . . . . . . . . . . . Impossible d'excuter l'application WebFacing partir d'une version antrieure . . . . . . . Dmarrage de l'application impossible . . . . . Prsence d'un problme li l'utilisation d'ID utilisateur aux privilges limits . . . . . . . Dmarrage du serveur WebFacing impossible . . Impossible d'afficher cette page . . . . . . . Impossible d'afficher cette page . . . . . . . Session incorrecte . . . . . . . . . . . . Incohrence entre le membre source DDS et le projet WebFacing . . . . . . . . . . . . L'environnement de test WAS ne peut pas dmarrer correctement l'application WebFacing si le chemin d'accs l'espace de travail utilis est trop long . . . . . . . . . . . . . . . Une racine de contexte contenant un espace ne fonctionne pas sur l'environnement de test WAS . L'application ne fonctionne pas correctement avec le paramtre RSTDSP dfini sur *NO . . . . . Des lments en position absolue apparaissent des emplacements imprvus dans WebFacing . . Prise en charge de la consignation des vnements de base communs pour les applications WebFacing. TFRJOB ou RRTJOB avec WebFacing met fin la tche de l'utilisateur . . . . . . . . . . . Impossible d'accder l'aide tendue sur les crans WebFacing affichage dynamique . . . . . . 121 122 122 124 125 127 127 129 130

Chapitre 8. Test et dploiement des applications WebFacing . . . . . . . 107


Test des applications WebFacing . . . . . . . Dploiement d'applications WebFacing . . . . . Dploiement sur WebSphere Application Server Lancement de l'application dans un navigateur . . Prise en charge WebFacing de plusieurs navigateurs . . . . . . . . . . . . . . Transfert de fichiers l'aide de l'explorateur de systmes distants . . . . . . . . . . . . Cration de ressources partages et mappage d'units rseau . . . . . . . . . . . . . 107 108 108 109 110 112 113

131 131 131 132 133 136 136

Chapitre 9. Migration des projets WebFacing . . . . . . . . . . . . 115


Migration de projets WebFacing . . . . . . Dsinstallation des versions antrieures du produit . . . . . . . . . . . . . Procdure manuelle de migration des projets avec des fichiers personnaliss. . . . . . . 115 . 118 . 118

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS 139

iv

Dveloppement des applications WebFacing

Avis aux lecteurs canadiens


Le prsent document a t traduit en France. Voici les principales diffrences et particularits dont vous devez tenir compte. Illustrations Les illustrations sont fournies titre d'exemple. Certaines peuvent contenir des donnes propres la France. Terminologie La terminologie des titres IBM peut diffrer d'un pays l'autre. Reportez-vous au tableau ci-dessous, au besoin.
IBM France ingnieur commercial agence commerciale ingnieur technico-commercial inspecteur IBM Canada reprsentant succursale informaticien technicien du matriel

Claviers Les lettres sont disposes diffremment : le clavier franais est de type AZERTY, et le clavier franais-canadien de type QWERTY. OS/2 et Windows - Paramtres canadiens Au Canada, on utilise : v les pages de codes 850 (multilingue) et 863 (franais-canadien), v le code pays 002, v le code clavier CF. Nomenclature Les touches prsentes dans le tableau d'quivalence suivant sont libelles diffremment selon qu'il s'agit du clavier de la France, du clavier du Canada ou du clavier des tats-Unis. Reportez-vous ce tableau pour faire correspondre les touches franaises figurant dans le prsent document aux touches de votre clavier.

Brevets Il est possible qu'IBM dtienne des brevets ou qu'elle ait dpos des demandes de brevets portant sur certains sujets abords dans ce document. Le fait qu'IBM vous fournisse le prsent document ne signifie pas qu'elle vous accorde un permis d'utilisation de ces brevets. Vous pouvez envoyer, par crit, vos demandes de renseignements relatives aux permis d'utilisation au directeur gnral des relations commerciales d'IBM, 3600 Steeles Avenue East, Markham, Ontario, L3R 9Z7. Assistance tlphonique Si vous avez besoin d'assistance ou si vous voulez commander du matriel, des logiciels et des publications IBM, contactez IBM direct au 1 800 465-1234.

vi

Dveloppement des applications WebFacing

Chapitre 1. Prsentation de l'outil WebFacing


L'outil IBM WebFacing permet de convertir des interfaces 5250 existantes en interfaces utilisateur graphiques bases sur un navigateur. En apportant peu ou pas de modifications aux applications IBM i d'origine, vous pouvez tendre l'utilisation des programmes Internet ou l'intranet. Qu'il s'agisse d'applications nouvelles ou gnres avant que la fiabilit d'Internet soit reconnue, WebFacing rend vos applications accessibles tous les utilisateurs via un navigateur. WebFacing peut tre utilis avec des applications pour lesquelles le code source DDS a t utilis pour la cration d'crans 5250. Il propose des assistants conviviaux pour faciliter la slection des membres source de l'application d'origine, leur conversion et le dploiement de la nouvelle interface base sur un navigateur pour votre programme sous la forme d'une application Web. La conversion gnre une page d'index, des pages JSP (JavaServer Page) et des fichiers XML qui remplacent le code source original et permettent un accs Web. Une fois le code source converti, vous pouvez accder l'application via un navigateur ou continuer utiliser des crans 5250. Le fait de disposer d'une interface avec les applications qui font appel des pages JavaServer augmente les possibilits de personnalisation de la prsentation. Lorsque vous convertissez le code source, vous slectionnez un style Web pour dterminer la prsentation des pages qui seront gnres automatiquement. Aprs avoir converti le code source via les pages de Proprits de style, vous pouvez continuer personnaliser le style. Les styles permettent de dfinir les attributs des pages Web (graphiques, polices, couleurs et formats). Vous pouvez utiliser les styles fournis ou crer vos propres styles. Si vous souhaitez modifier la prsentation d'un projet converti prcdemment, il vous suffit d'excuter WebFacing une nouvelle fois et de slectionner un nouveau style. Une fois la conversion effectue, vous pouvez continuer modifier l'interface utilisateur de votre application en modifiant les membres DDS l'aide de la vue Paramtres Web de l'environnement de dveloppement intgr et reconvertir les membres modifis l'issue du processus. Vous pouvez galement amliorer le fichier index.jsp gnr via Page Designer. Grce Page Designer, vous pouvez continuer modifier le style, ajouter des graphiques, mettre jour les proprits des pages et personnaliser davantage la prsentation de votre application Web.

Copyright IBM Corp. 1992, 2011

Le diagramme suivant illustre les tches principales impliques dans la conversion Web de vos applications :

Dveloppement des applications WebFacing

Tches associes Chapitre 2, Configuration de l'outil IBM WebFacing, la page 5 Ouverture de la perspective WebFacing, la page 14 Chapitre 3, Cration d'un projet Web WebFacing, la page 13 Slection des membres source convertir, la page 15 Spcification de commandes CL pour appeler votre application, la page 16 Slection d'un style Web, la page 14 Fin du projet et conversion du source DDS, la page 18 Analyse des journaux de conversion, la page 18 Information associe Chapitre 11, Outil WebFacing -- Prise en charge actuelle des mots cls DDS, la page 139

Nouveauts de WebFacing
Nouveaux styles Les styles offrent une apparence cohrente toutes les pages de votre application WebFacing. HATS version 8.0 inclut des nouveaux styles WebFacing offrant des exemples de menus de navigation, de fonds de page, de schmas de couleurs et de graphiques, pour une meilleure ergonomie ds le premier contact. Ces nouveaux styles s'adaptent aux nouveaux modles HATS, et fonctionnent avec les projets Web ainsi qu'avec les projets d'interoprabilit HATS/WebFacing. Ils sont indiqus par un astrisque sur la page de l'assistant Slection d'un style Web. Rfrence associe Prise en charge WebFacing de plusieurs navigateurs, la page 110 Les projets WebFacing peuvent tre excuts dans les navigateurs Microsoft Internet Explorer et Mozilla Firefox. Ce document de rfrence dcrit les diffrences entre l'apparence des pages WebFacing dans Firefox et dans Internet Explorer.

Chapitre 1. Prsentation de l'outil WebFacing

Dveloppement des applications WebFacing

Chapitre 2. Configuration de l'outil IBM WebFacing


Le composant WebFacing fournit une interface graphique permettant de slectionner, de convertir et de tester les interfaces utilisateur converties de votre application initiale. Pour configurer l'outil WebFacing sur les systmes, vous devez excuter les oprations suivantes : v Configuration de WebSphere Application Server sur votre serveur IBM i v Installation des modifications provisoires du logiciel (PTF) du serveur WebFacing sur le serveur IBM i v Dmarrage du serveur WebFacing sur le serveur IBM i v Transfert des applications converties sur le serveur IBM i. Concepts associs Chapitre 1, Prsentation de l'outil WebFacing, la page 1

Configuration de WebSphere Application Server sur votre serveur IBM i


WebSphere Application Server gre l'excution des pages JavaServer et des JavaBeans gnrs pendant le processus de conversion DDS. Pour configurer WebSphere Application Server pour IBM i, consultez la documentation figurant sur les sites Web suivants : IBM WebSphere Application Server version 6.1 for System i http://www.ibm.com/servers/eserver/iseries/software/websphere/ wsappserver/docs/docws61.html IBM WebSphere Application Server - Express version 7.0 for IBM i http://www.ibm.com/software/webservers/appserv/was/library/v70/eibmi/index.html Vous devez excuter au minimum la procdure d'installation. Il est vivement recommand de prendre connaissance de la documentation IBM WebSphere Application Server, notamment les sections relatives l'installation et la cration d'instances du serveur d'applications. Vous pouvez configurer plusieurs instances spares du serveur WebSphere Application Server. Si votre systme est destin des tches de test et de production, il peut tre utile de crer des instances pour les tests et le dveloppement, et d'autres instances pour la production. De la mme manire, si plusieurs dveloppeurs travaillent au dveloppement, leurs rsultats peuvent tre dvelopps et tests sparment en crant des instances supplmentaires. Le port HTTP par dfaut pour WebSphere Application Server est le port 9080. Par dfaut, le numro de port du serveur d'administration est 9060. L'accs aux serveurs d'administration s'effectue via une console base navigateur. Pour crer des instances supplmentaires, consultez les sites Web suivants : Testez la configuration de WebSphere Application Server. Utilisez les liens des sites ci-dessus pour localiser le centre de documentation appropri. Pour plus

d'informations sur le test de la configuration de votre serveur d'applications, consultez la rubrique Vrification de linstallation dans le centre de documentation.

Configuration de WebSphere Portal sur le serveur IBM i


WebSphere Portal gre le fonctionnement des portlets crs partir des projets. Pour configuer WebSphere Portal for IBM i, consultez la documentation figurant sur le site Web suivant : Documentation du produit IBM WebSphere Portal http://www.ibm.com/developerworks/websphere/zones/portal/ proddoc.html Vous devez excuter au minimum la procdure d'installation. Il est vivement recommand de prendre connaissance de la documentation IBM WebSphere Portal, notamment les sections relatives l'installation.

Installation des modifications provisoires du logiciel (PTF) du serveur WebFacing sur le serveur IBM i
Le serveur WebFacing joue le rle de passerelle entre WebSphere Application Server et votre application IBM i initiale. Pour plus d'informations sur les modifications provisoires (PTF) du serveur WebFacing, voir Chapitre 10, Identification et rsolution des incidents dans les applications WebFacing, la page 121. Les modifications provisoires du logiciel (PTF) du serveur WebFacing doivent tre installes sur le serveur IBM i sur lequel votre application sera excute. Hormis sur les derniers modles de serveur IBM i, l'outil WebFacing consomme des cycles interactifs. Mme si le serveur WebSphere Application Server peut tre excut sur le mme systme, il n'est pas ncessaire qu'il soit lanc sur le systme hbergeant votre application. L'interface convertie pour votre application est dploye en tant qu'application WebSphere. Vous pouvez dployer l'application WebFacing WebSphere sur un serveur IBM i, l'application IBM i tant installe sur un autre serveur.

Dmarrage du serveur d'excution WebFacing sur le serveur IBM i


1. Pour dmarrer le serveur d'excution WebFacing sur le serveur IBM i, procdez comme suit : Si vous utilisez OS/400 version 5.2 ou ultrieure, tapez STRTCPSVR SERVER(*WEBFACING) sur la ligne de commande. Pour arrter le serveur WebFacing, tapez ENDTCPSVR SERVER(*WEBFACING). 2. Pour vrifier que le serveur fonctionne correctement, tapez WRKACTJOB. a. Sur la ligne de commande, tapez WRKACTJOB JOB(QQF*) pour afficher la liste des travaux WebFacing : v QQFWFSVR - serveur d'excution WebFacing ET v QQFVTSVR -- serveur terminal virtuel WebFacing (plusieurs travaux QQFVTSVR peuvent tre excuts ; ce comportement est normal) Remarque : Consultez la valeur systme QAUTOVRT. Si elle est gale 0, aucune session de navigateur ne peut tre lance la place de travaux VT (Virtual Terminal). Le serveur d'excution WebFacing s'appuie sur des travaux VT. La valeur de QAUTOVRT dtermine le nombre de travaux VT pouvant tre

Dveloppement des applications WebFacing

dmarrs automatiquement. Si ncessaire, dfinissez la valeur *NOMAX ou une valeur suprieure 0 pour QAUTOVRT. Pour modifier la valeur de QAUTOVRT, utilisez la commande du serveur IBM i WRKSYSVAL permettant d'agir sur les valeurs systme.

Transfert des applications converties sur le serveur IBM i


Le dveloppement d'application est ralis sur un poste de travail. Les artefacts gnrs par l'application doivent tre transfrs ultrieurement sur un serveur IBM i o ils pourront tre dploys par le serveur WebSphere Application Server. Dfinissez une mthode de transfert des applications converties sur votre serveur IBM i. Si vous dployez les applications converties sur le serveur IBM i, vous devez choisir une mthode pour les transfrer sur votre serveur. En fait, les applications sont transfres sous la forme de fichiers EAR, qui reprsentent des packages d'applications Web archivs crs via l'assistant d'exportation. Ils simplifient le dploiement et l'installation de nouvelles applications Web WebFacing sur le serveur WebSphere Application Server. Voici les principales mthodes permettant de transfrer des fichiers : v Perspective Explorateur de systmes distants de l'espace de travail Rational Developer for IBM i v Partage de fichiers IBM i NetServer : grce cette mthode, les fichiers peuvent tre transfrs l'aide de l'assistant d'exportation. v FTP : Grce FTP, les fichiers sont transfrs manuellement. Le partage de fichiers NetServer permet d'associer un dossier du systme de fichiers intgr (IFS) rsidant sur le serveur IBM i la lettre d'une unit de votre poste de travail. Vous pouvez ainsi utiliser l'assistant d'exportation pour transfrer des fichiers sur votre serveur comme si vous copiez des fichiers d'un dossier dans un autre sur votre poste de travail Le serveur FTP doit s'excuter sur votre serveur IBM i pour que vous puissiez l'utiliser dans le but de transfrer des fichiers. Si FTP n'est pas actif, vous pouvez le lancer en entrant la commande STRTCPSVR *FTP.

Dmarrage et arrt du serveur WebFacing sur votre hte IBM i


1. Pour dmarrez le serveur d'excution WebFacing sur le serveur IBM i, procdez comme suit : Tapez la commande CL STRTCPSVR SERVER(*WEBFACING) sur la ligne de commande. Pour arrter le serveur WebFacing, tapez ENDTCPSVR SERVER(*WEBFACING). 2. Pour vrifier que le serveur fonctionne correctement, tapez WRKACTJOB. a. Sur la ligne de commande, tapez WRKACTJOB JOB(QQF*) pour afficher la liste des travaux WebFacing. v QQFWFSVR -- serveur WebFacing ET v QQFVTSVR -- serveur terminal virtuel WebFacing (plusieurs travaux QQFVTSVR peuvent tre excuts ; ce comportement est normal) Remarque : Consultez la valeur systme QAUTOVRT. Si elle est gale 0, aucune session de navigateur ne peut tre lance la place de travaux VT (Virtual Terminal). Le serveur WebFacing s'appuie sur les travaux du terminal virtuel. La valeur de QAUTOVRT dtermine le nombre de travaux VT pouvant tre dmarrs automatiquement. Si ncessaire, dfinissez la valeur *NOMAX ou une valeur suprieure 0 pour QAUTOVRT. Pour modifier la valeur de QAUTOVRT, utilisez la commande du serveur IBM i WRKSYSVAL permettant d'agir sur les valeurs systme.
Chapitre 2. Configuration de l'outil IBM WebFacing

Tches connexes Chapitre 2, Configuration de l'outil IBM WebFacing, la page 5 Configuration d'un serveur WebFacing pour plusieurs sous-systmes interactifs

Configuration d'un serveur WebFacing pour plusieurs sous-systmes interactifs


Selon le nombre d'utilisateurs existants et le nombre de travaux WebFacing crs sur votre systme, vous voudrez peut-tre configurer des sous-systmes interactifs supplmentaires pour traiter les travaux WebFacing. L'utilisation de plusieurs sous-systmes interactifs amliore l'volutivit de WebFacing grce : v Augmentation du nombre total de travaux WebFacing pouvant tre excuts sur votre machine v Equilibrage de la charge de travail : Les travaux WebFacing sont rpartis de manire ce qu'ils se propagent de manire optimale dans les sous-systmes configurs Il est possible de configurer jusqu' 16 sous-systmes supplmentaires pour WebFacing. Si aucun autre sous-systme n'est configur, les travaux WebFacing sont excuts par dfaut dans le sous-systme QINTER. Evaluez votre besoin d'utiliser des sous-systmes supplmentaires en vous appuyant sur le nombre d'utilisateurs existants et de vos capacits matrielles. N'oubliez pas qu'un travail interactif est cr pour chaque connexion utilisateur si cette connexion s'effectue via une session 5250 ou une session WebFacing. Remarque : Lorsque vous configurez des sous-systmes supplmentaires pour WebFacing, QINTER n'est plus utilis pour les travaux interactifs WebFacing. Les travaux interactifs WebFacing sont nomms selon la convention de dnomination d'units QQFn*, o n reprsente le sous-systme utilis dans une squence pouvant compter jusqu' 16 sous-systmes. La valeur n respecte les conventions de numrotation hexadcimales. En numrotation hexadcimale, les 10 premires valeurs n sont reprsentes par des numros compris entre 0 et 9 et les six valeurs suivantes (valeurs 10 15) sont reprsentes par les lettres A F. Par exemple, les noms des travaux du premier sous-systme commencent par QQF0*, tandis que les noms des travaux du douzime sous-systme commencent par QQFB*. Si aucun autre sous-systme n'est configur, les travaux interactifs de WebFacing peuvent tre identifis dans le sous-systme QINTER via les noms qui commencent par la chane QQF0*. 1. Si cela est ncessaire, modifiez le sous-systme QINTER de sorte que les travaux WebFacing n'y soient plus traits. Cela s'avre obligatoire si *ALL est la valeur actuellement utilise dans la zone Nom de la station d'accueil pour les valeurs des postes cran dans QINTER. Utilisez la commande DSPSBSD pour afficher vos paramtres actuels. Si ncessaire, remplacez *ALL par la convention de dnomination d'crans utilise par votre systme. Par exemple, certains systmes utilisent QPADEV*. 2. Crez des sous-systmes interactifs supplmentaires pour les travaux WebFacing. Ces sous-systmes doivent suivre le modle de QINTER. Pour crer ces sous-systmes, crez des descriptions de sous-systmes l'aide de la commande CRTSBSD. 3. Lorsque le serveur WebFacing est install, une zone de donnes appele QQFCONFIG est cre pour ce serveur dans la bibliothque QFTEMP. Remplacez la valeur SBS de la zone de donnes QQFTEMP/QQFCONFIG par

Dveloppement des applications WebFacing

le nombre de sous-systmes interactifs utiliser avec WebFacing. Dans cette zone de donnes, une paire nom par dfaut/valeur de SBS=01; est cre pour dfinir le nombre de sous-systmes interactifs utiliser avec WebFacing. Pour modifier la valeur par dfaut, utilisez la commande WRKDTAARA DTAARA(QQFTEMP/QQFCONFIG). Choisissez l'option 2=Modifier et entrez SBS=nn; dans la zone Nouvelle valeur, o nn reprsente le nombre de sous-systmes que vous utiliserez pour WebFacing. Ce nombre peut tre compris entre 1 et 16. Par exemple, SBS=16;. Mme si vous indiquez la valeur au format dcimal, le programme affichera le nombre SBS au format hexadcimal l'excution. Si vous souhaitez afficher les valeurs actuelles, utilisez la commande DSPDTAARA DTAARA(QQFTEMP/QQFCONFIG). 4. A l'aide de la commande ADDWSE, ajoutez des postes cran pour chaque sous-systme supplmentaire de WebFacing que vous allez utiliser. Dans la zone Nom du poste de travail de l'cran Ajout d'un poste cran, indiquez le nom d'unit WebFacing utiliser pour ce sous-systme. Respectez les conventions de numrotation hexadcimales dcrites ci-dessus pour dterminer les valeurs utiliser. Les valeurs hexadcimales pour les dix premiers sous-systmes sont comprises entre 0 et 9. Les valeurs hexadcimales pour les six sous-systmes suivants (de 10 15) vont de A F. Par exemple, entrez QQF0* sur l'cran ADDWSE du premier sous-systme. Pour le second sous-systme, entrez QQF1*. Pour le seizime sous-systme, entrez QQFF*. 5. Pour appliquer les modifications, arrtez et dmarrez le serveur WebFacing. Pour arrter le serveur WebFacing, utilisez la commande ENDTCPSVR SERVER(*WEBFACING). Pour dmarrer le serveur, utilisez la commande STRTCPSVR SERVER(*WEBFACING).CPSVR SERVER(*WEBFACING).

Modification du port utilis par le serveur WebFacing


Le serveur WebFacing joue le rle de passerelle entre WebSphere Application Server et votre application IBM i initiale. Il coutera sur le port TCP prdfini pour changer les donnes avec les applications WebFacing (Web ou portlet). Toutes les applications WebFacing qui se connectent au serveur sur le mme systme IBM i doivent tre configures pour se connecter au port TCP affect. Par dfaut, le serveur coute sur le port 4004. Vous pouvez indiquer une valeur diffrente l'aide de la commande IBM i WKSRVTBLE pour modifier le service TCP as-WebFacing. Le serveur doit tre redmarr pour que la modification soit prise en compte et toutes les applications WebFacing doivent tre reconfigures en fonction des proprits d'excution des projets WebFacing et redployes. Modification du port d'excution WebFacing du serveur IBM i 1. Accdez l'cran Gestion des entres de table de services. Depuis la ligne de commande d'un serveur IBM i, entrez la commande suivante : WRKSRVTBLE. L'cran Gestion des entres de table de services apparat. 2. Descendez jusqu'au service as-WebFacing. Remarque : Si vous n'avez pas redfini le port WebFacing manuellement auparavant, aucune entre as-WebFacing n'apparat. Si vous n'avez pas dfini manuellement un port WebFacing auparavant, passez l'tape Ajout d'une nouvelle entre pour as-WebFacing. 3. Slectionnez l'option 5=Afficher pour afficher les informations de port du serveur WebFacing. Si vous n'avez pas modifi le port, la valeur par dfaut est 4004. Appuyez sur la touche Entre ou F12 pour revenir l'cran Gestion des entres de table de services.

Chapitre 2. Configuration de l'outil IBM WebFacing

4. Pour modifier le port, vous devez d'abord supprimer une entre existante pour as-WebFacing en slectionnant l'option 4=Supprimer. 5. Ajoutez une nouvelle entre pour as-WebFacing. a. Accdez l'cran Ajout d'un lment de table de services. Slectionnez l'option 1=Ajouter. L'cran Ajout d'un lment de table de services apparat. b. Dans la zone Service, l'intrieur des apostrophes, entrez as-WebFacing. c. Dans la zone Port, entrez le nouveau numro de port utiliser. d. Dans la zone Protocole, l'intrieur des apostrophes, entrez tcp. e. Appuyez sur Entre. Votre nouvelle entre de service WebFacing a t ajoute. Aprs avoir modifi le port d'excution WebFacing sur le serveur IBM i, suivez les tapes prsentes dans Modification du port utilis par vos applications WebFacing, la page 41 pour modifier le port utilis par vos applications WebFacing afin que celles-ci utilisent le nouveau port. Remarque : Ce dernier est utilis uniquement pour les communications entre l'application WebFacing et le serveur WebFacing ; il ne s'agit pas de celui que vous pouvez indiquer sur le navigateur pour accder votre application Web WebFacing.

Activation des licences


Vous devez acheter une licence IBM Rational Host Access Transformation Services (HATS) pour que les applications WebFacing puissent s'excuter dans un environnement de production. Sans une licence valide, vous pouvez excuter jusqu' deux sessions d'essai simultanes de vos applications WebFacing. Pour activer intgralement le module d'excution WebFacing pour une exploitation en mode production conformment votre autorisation d'utilisation du logiciel sous licence, vous devez indiquer vos paramtres de licence dans l'assistant Paramtres de licence. Remarque : Vous devez excuter ce dernier mme pour les projets dont les modules d'excution ont t activs intgralement dans les versions antrieures. Pour excuter l'assistant Paramtres de licence, procdez comme suit : 1. Ouvrez la perspective WebFacing. 2. Cliquez avec le bouton droit n'importe o dans la vue Projets WebFacing et slectionnez Paramtres de licence. 3. Dans le panneau Fichier d'activation d'excution, cliquez sur Parcourir pour accder l'emplacement du fichier. a. Le fichier utilis pour l'activation complte des projets Web HATS, de client enrichi HATS et WebFacing est nomm runtimeenablement8-webrcp.jar. L'assistant active simultanment les environnements HATS et WebFacing en une seule fois. b. Vous devez utiliser le fichier correspondant votre version de WebFacing. Un message d'erreur s'affiche si vous tentez d'employer un fichier qui correspond une version antrieure. 4. Slectionnez le fichier et cliquez sur Ouvrir. 5. Aprs avoir dfini l'emplacement du fichier d'activation du module d'excution, cliquez sur Suivant.

10

Dveloppement des applications WebFacing

6. Dans le panneau Options de licence, les types de projet sont affichs avec une indication spcifiant s'ils seront activs ou non en fonction du fichier d'activation du module d'excution slectionn. Slectionnez l'option de licence spcifie par votre autorisation d'utilisation du logiciel. Les options possibles sont Utilisateur autoris et Unit de valeur. Si vous indiquez Utilisateur autoris, vous devez saisir le nombre de licences acquises. v Slectionnez Apply to all new projects created in any workspace pour activer compltement le module d'excution pour tous les nouveaux projets crs, en fonction du type de licence, dans n'importe quel espace de travail. v Slectionnez Apply to all existing projects in the current workspace pour activer compltement le module d'excution pour tous les projets, conformes au type de licence, qui existent dans l'espace de travail en cours. S'il existe des projets dans d'autres espaces de travail, vous devez lancer l'assistant Paramtres de licence dans chacun de ces espaces de travail. Remarque : Les paramtres de licence des projets WebFacing dans un espace de travail sont vrifis au dmarrage. Si l'un des projets n'est pas conforme aux paramtres de la licence principale, vous tes invit le mettre jour. Pour dsactiver la vrification des paramtres de licence au dmarrage, slectionnez Prfrences > WebFacing > HATS/WebFacing et dslectionnez Contrler les paramtres de licence lors du dmarrage du plan de travail. 7. Cliquez sur Terminer.

Chapitre 2. Configuration de l'outil IBM WebFacing

11

12

Dveloppement des applications WebFacing

Chapitre 3. Cration d'un projet Web WebFacing


Le projet Web WebFacing est bas Struts et utilise Struts 1.3. Le niveau Java EE dpend de la version de WebSphere Application Server cible lors de la cration du projet. Pour WebSphere Application Server Version 6.1, il s'agit de Java EE 1.4. Pour WebSphere Application Server version 7.0, il s'agit de Java EE 5.0. Pour WebSphere Application Server version 8.0, il s'agit de Java EE 6.0. Pour crer un projet Web WebFacing : 1. Cliquez sur Fichier > Nouveau > Projet. 2. Dveloppez WebFacing dans la sous-fentre Assistants, slectionnez Projet Web WebFacing, puis cliquez sur Suivant pour ouvrir l'assistant Projet Web WebFacing. 3. Dans l'assistant Projet Web WebFacing : a. Entrez le nom de votre projet dans la zone Nom du projet. b. Dans la zone Emplacement du projet, lorsque la case Utiliser l'emplacement par dfaut est coche, votre projet sera cr l'emplacement o votre espace de travail se situe sur le systme de fichiers. Pour modifier l'emplacement du systme de fichiers dfini par dfaut, dcochez la case et saisissez le chemin en cliquant sur le bouton Parcourir. c. Slectionnez un serveur dans la zone de liste droulante Environnement d'excution cible. Le choix du serveur dtermine la version Java EE du projet. Notez que cette zone de liste droulante est dsactive si le projet EAR existe dj. Pour tre sr de pouvoir slectionner un serveur, indiquez un nouveau projet EAR l'tape f suivante. Cliquez sur Nouvel environnement d'excution pour dfinir un nouveau serveur. d. Mmorisez la version de Dynamic Web Module de votre projet WebFacing. La version de Dynamic Web Module ajoute des prises en charge pour l'API Java Servlet et correspond au niveau Java EE (2.4 pour Java EE 1.4, 2.5 pour Java EE 5 et 3.0 pour Java EE 6). Vous pouvez modifier ce paramtre dans la page Valeurs de projet. Pour accder cette page, cliquez sur le bouton Modifier situ ct de la zone Configuration. e. Utilisez la configuration par dfaut pour le serveur slectionn ou slectionnez <personnalis> si vous souhaitez configurer vous-mme le projet. Pour modifier la configuration d'un projet, cliquez sur Modifier afin d'afficher la page Valeurs de projet. Cette page vous permet d'ajouter (ou de supprimer) des valeurs au projet. f. Vrifiez que le case Ajouter un projet un projet EAR est bien coche. Un nom par dfaut du projet EAR est propos lorsqu'il s'agit du premier projet que vous crez. Si votre espace de travail contient dj un projet EAR, celui-ci sera slectionn par dfaut. Vous pouvez conserver le nom propos par dfaut ou le modifier. g. Cliquez sur Suivant. Les crans suivants permettent de slectionner le fichier cran et les membres source UIM convertir. Si vous souhaitez crer le projet Web WebFacing sans raliser de conversion, cliquez sur Suivant jusqu' ce que la page Cration du projet WebFacing termine s'affiche et cliquez sur Terminer pour crer le projet.

13

Remarque : Si vous slectionnez Configurer les paramtres avancs, les crans qui suivent vous permettent de dfinir les paramtres avancs du projet, (par exemple, le chemin de gnration Java, les paramtres du module Web et les paramtres Struts). Pour ajouter la prise en charge de WebFacing un projet Web existant : 1. Cliquez avec le bouton droit de la souris sur le projet Web, puis slectionnez Proprits. Accdez la bote de dialogue des proprits de votre projet. 2. Slectionnez le noeud Valeurs de projet. 3. Cliquez sur OK pour crer un projet WebFacing non converti, ou cliquez sur le lien Plus de configuration disponible pour dfinir les paramtres de votre projet WebFacing comme dcrit ci-dessous. 4. Vous pouvez modifier les paramtres Struts ou accepter les valeurs par dfaut. Remarque : Les projets Web WebFacing ncessitent Java EE version 1.4 ou suprieure, et Struts version 1.3. Les portlets WebFacing ncessitent Java EE version 1.4 ou suprieure, et Struts pour IBM Portlets version 6.0. 5. Cliquez sur Suivant. Les crans suivants permettent de slectionner le fichier cran et les membres source UIM convertir. Concepts associs Chapitre 1, Prsentation de l'outil WebFacing, la page 1 Information associe Chapitre 11, Outil WebFacing -- Prise en charge actuelle des mots cls DDS, la page 139

Ouverture de la perspective WebFacing


1. Au dmarrage de l'environnement de dveloppement intgr, le programme affiche la perspective par dfaut ou la dernire perspective utilise. 2. Pour ouvrir la perspective WebFacing, slectionnez Fentre > Ouvrir une perspective > Autre > WebFacing. Si vous disposez de projets existants, vous pouvez les visualiser en slectionnant la vue Projets WebFacing. 3. Utilisez un projet existant ou crez un nouveau projet l'aide de l'assistant de projets WebFacing. Pour lancer l'assistant de projets WebFacing, slectionnez Fichier > Nouveau > Projet > WebFacing > Projet Web WebFacing, puis cliquez sur Suivant. Concepts associs Chapitre 1, Prsentation de l'outil WebFacing, la page 1 Information associe Chapitre 11, Outil WebFacing -- Prise en charge actuelle des mots cls DDS, la page 139

Slection d'un style Web


Deux mthodes permettent de personnaliser les projets Web WebFacing : v Vous pouvez utiliser les outils du concepteur de site Web. v Vous pouvez choisir un des styles prdfinis proposs par l'outil WebFacing, ou personnaliser un style prdfini. Activation du concepteur de site Web Slectionnez Activation du concepteur de site Web si vous souhaitez utiliser les outils du concepteur de site Web pour personnaliser le style de

14

Dveloppement des applications WebFacing

votre projet WebFacing. Le concepteur de site Web vous permet de concevoir facilement un site Web avec un thme cohrent et de l'intgrer WebFacing ou d'autres applications Web ayant le mme style et la mme prsentation. Si vous choisissez Activation du concepteur de site Web, les styles WebFacing prdfinis ne seront plus disponibles pour votre projet. Vous pouvez utiliser les pages de proprits de style pour modifier le style mais vous devez utiliser les outils du concepteur de site Web pour conserver et sauvegarder le style. Pour plus d'informations, voir la rubrique connexe Modification du style d'un site Web, la page 58. Slection d'un style WebFacing classique Vous pouvez choisir un style prdfini ou un style que vous avez cr l'aide des pages de proprits de style. Si vous crez vos styles, vous n'aurez pas besoin de personnaliser ensuite la prsentation de votre application convertie. Par exemple, si vous souhaitez utiliser certains graphiques ou certaines combinaisons de couleurs en crant un style qui les intgre, vous pouvez agir sur l'aspect de plusieurs pages sans avoir les modifier aprs la conversion de votre application. Dans le cas des projets de portlet WebFacing, choisissez un des styles prdfinis spcifiques aux projets de portlet WebFacing proposs par l'outil WebFacing, ou personnalisez un style prdfini spcifique aux projets de portlet WebFacing. La diffrence principale entre les styles disponibles dans les applications de portail rside dans la prsentation des boutons de touche de commande. En fait, la prsentation du portlet WebFacing repose sur le thme du serveur de portail que vous avez choisi. Les styles de portlet WebFacing ne comprennent pas les dclarations spcifiques aux couleurs. Grce cela, l'application applique automatiquement les dclarations de couleur du portail selon le thme que vous avez affect l'application ou la page de portail. Pour remplacer la couleur utilise par les thmes de portail, modifiez simplement les pages de proprits de style ou directement le fichier apparea.css. Sinon, le programme appliquera automatiquement les modifications que vous avez apportes au thme du portail selon le thme choisi. Pour savoir comment personnaliser les thmes de portail, consultez la documentation du portail. Concepts associs Chapitre 1, Prsentation de l'outil WebFacing, la page 1 Information associe Chapitre 11, Outil WebFacing -- Prise en charge actuelle des mots cls DDS, la page 139

Slection des membres source convertir


La page Slectionner les membres source convertir de l'assistant permet de parcourir et de slectionner les membres source que vous souhaitez convertir dans le cadre du projet en cours. Vous pouvez slectionner des membres source DDS et d'aide UIM. 1. Slectionnez votre serveur IBM i. Dans la zone Connexion, slectionnez le nom de la connexion serveur vers le systme IBM i qui contient les membres source convertir. Si aucun serveur n'est disponible dans la liste droulante, dfinissez une nouvelle connexion l'aide du bouton Nouveau.

Chapitre 3. Cration d'un projet Web WebFacing

15

2. Choisissez un filtre de bibliothque. Dans la zone Bibliothque, vous pouvez choisir un filtre prdfini, entrer directement le nom d'une bibliothque ou crer votre propre filtre. Le filtre par dfaut est *LIBL. Vous pouvez utiliser des astrisques pour crer votre propre filtre. Par exemple, si vous avez saisi API*, toutes les bibliothques qui commencent par la chane API apparaissent. 3. Choisissez ou entrez un filtre de fichier. Dans la zone Fichier, le filtre par dfaut est *ALL. Vous pouvez utiliser des astrisques pour crer votre propre filtre. Par exemple, si vous tapez *PG*, tous les noms de fichier comprenant la squence de caractres PG (RPGAPP, par exemple) apparaissent. 4. Choisissez ou entrez un filtre de membre. Dans la zone Membre, le filtre par dfaut est *ALL. Vous pouvez utiliser des astrisques pour crer votre propre filtre. Par exemple, si vous avez saisi ORD*, tous les noms de membre qui commencent par la squence de caractres ORD (par exemple, ORDENTR) apparaissent. 5. Choisissez des types de membre. La zone Types de membre vous permet de choisir les types de membre qui seront affichs, savoir DSPF, MNUDDS, PNLGRP ou les trois. 6. Cliquez sur Rgnrer la liste pour afficher les membres correspondant aux valeurs de filtre que vous avez choisies. A moins que vous ne soyez dj connect, vous serez invit vous connecter au serveur que vous avez slectionn dans la zone Connexion. 7. Ajoutez les membres convertir. Accdez aux membres source en cliquant sur le signe + correspondant la bibliothque et au fichier appropris. Lorsque les membres que vous souhaitez convertir s'affichent, slectionnez-les, puis cliquez sur la flche pour les ajouter dans la sous-fentre de droite. Pour slectionner plusieurs membres la fois, maintenez la touche Ctrl enfonce lors de la slection. Pour ajouter tous les membres d'un fichier la liste de conversion, slectionnez le fichier et cliquez sur la flche. Pour retirer un membre de la sous-fentre de droite, cliquez dessus avec le bouton droit de la souris, puis slectionnez Suppression dans le menu en incrustation. Concepts associs Chapitre 1, Prsentation de l'outil WebFacing, la page 1 Information associe Chapitre 11, Outil WebFacing -- Prise en charge actuelle des mots cls DDS, la page 139

Spcification de commandes CL pour appeler votre application


Utilisez la page Entre de commandes CL pour indiquer les commandes CL utilises pour lancer votre application. Chaque commande CL constitue un point d'entre dans votre application et apparat sous la forme d'un bouton Soumettre dans la page d'accueil gnre par WebFacing. Vous pouvez disposer d'autant de points d'entre que vous le souhaitez. Pour chaque projet, un fichier index.jsp est gnr. Les liens du fichier index.jsp correspondent au texte entr dans la zone Libell de commande. Une fois votre projet dploy dans une application Web, l'application est lance et accessible via le navigateur l'aide de la commande CL correspondante lorsqu'un utilisateur clique sur un bouton. Vous pouvez spcifier les options suivantes pour chaque commande : v Commande CL utilise comme point d'entre dans votre application v Libell de la commande utilis pour le texte du bouton dans la page d'appel

16

Dveloppement des applications WebFacing

v Nom utilis pour identifier l'appel de manire unique v Prfrence l'ouverture d'une session Remarque : Aprs avoir cr le projet, vous pouvez changer les options en modifiant les proprits du projet WebFacing ou en cliquant avec le bouton droit de la souris sur le dossier des commandes CL du projet WebFacing, puis en slectionnant Ajouter. Le programme affiche la bote de dialogue Entre de commandes CL. Dans la page Entre de commandes CL : 1. Entrez la commande dans la zone Commande CL. Par exemple, pour appeler le programme ORDENTR dans la bibliothque APILIB, entrez la commande CALL APILIB/ORDENTR. Si votre programme ncessite la saisie par l'utilisateur de paramtres interactifs, vous pouvez indiquer une commande CL au format suivant : CALL PROGRAM PARM(&PARMNAME). Grce ce format, le programme cre une zone de saisie sur la page d'appel. Il transmet ensuite la valeur des types utilisateur de la zone lorsque l'utilisateur clique sur le bouton d'appel de l'application. 2. Tapez le libell de la commande dans la zone Libell de commande. Le texte du libell devient le texte du bouton sur lequel les utilisateurs cliquent pour appeler votre programme. Si vous laissez cette zone vierge, le texte que vous avez entr dans la zone Commande CL est utilis par dfaut. 3. (Facultatif) En fonction de vos exigences, entrez une valeur unique dans la zone Nom d'appel. En gnral, vous pouvez accepter la valeur affecte par dfaut. Les valeurs par dfaut sont appeles INV1, INV2, et ainsi de suite pour chaque commande que vous entrez. Vous pouvez avoir besoin de spcifier un nom spcifique si vous utilisez l'appel par programmation avec les applications WebFacing. L'appel par programmation vous permet d'appeler des applications WebFacing depuis d'autres applications au moyen d'une srie d'arguments. L'un des arguments est inv. Il se rapporte au nom d'appel de votre commande CL. Si l'une de vos applications utilise l'appel par programmation et que vous avez besoin d'un nom spcifique pour l'argument inv, indiquez ce nom dans la zone Nom d'appel. Pour plus d'informations sur l'appel par programmation, voir Appel par programmation d'applications WebFacing depuis d'autres applications Web, la page 102. 4. Choisissez votre mthode d'ouverture de session. Slectionnez Invite pour ouverture de session ou Dfinir des valeurs d'ouverture de session IBM i. Si vous choisissez Invite pour ouverture de session, les utilisateurs devront taper un ID et un mot de passe utilisateur pour utiliser l'application. Si vous choisissez Dfinir des valeurs d'ouverture de session IBM i, les valeurs saisies dans les zones ID utilisateur et Mot de passe seront envoyes automatiquement lorsque l'utilisateur appelle le programme. Remarque : Vrifiez que la bibliothque qui contient l'objet programme dsign par votre commande est disponible dans la liste de bibliothques pour l'ID utilisateur servant se connecter l'application. 5. Cliquez sur Ajouter. Les valeurs que vous avez choisies sont ajoutes la liste de commandes. Si vous souhaitez modifier l'ordre des liens HTML qui lancent votre programme, slectionnez l'un des lments de la liste de commandes, puis cliquez sur Monter ou Descendre. Si vous souhaitez supprimer ou modifier l'une des commandes, slectionnez l'lment dans la liste de commandes, puis cliquez sur Supprimer ou Modifier.

Chapitre 3. Cration d'un projet Web WebFacing

17

Concepts associs Chapitre 1, Prsentation de l'outil WebFacing, la page 1 Information associe Chapitre 11, Outil WebFacing -- Prise en charge actuelle des mots cls DDS, la page 139

Fin du projet et conversion du source DDS


Utilisez la page Cration du projet WebFacing lorsque vous avez termin la procdure prcdente de l'assistant. Vous pouvez lancer la conversion maintenant ou sauvegarder le projet avec les options que vous avez choisies et effectuer la conversion plus tard. Slectionnez l'option de conversion de votre choix et cliquez sur Fin. Vous revenez alors la perspective WebFacing. Les ressources qui ont t gnres pour le projet sont affiches dans la vue Projets WebFacing. Pour commencer la conversion du source DDS, cliquez avec le bouton droit sur l'icne affichant le nom du projet et cliquez sur Conversion. Concepts associs Chapitre 1, Prsentation de l'outil WebFacing, la page 1 Information associe Chapitre 11, Outil WebFacing -- Prise en charge actuelle des mots cls DDS, la page 139

Analyse des journaux de conversion


Une fois la source DDS et UIM convertie, le journal de conversion apparat dans la sous-fentre de droite. Les journaux suivants sont gnrs : Journal de conversion DSPF Ce journal rpertorie tous les membres de fichier cran convertis, avec les noms des formats d'enregistrement pour un membre donn. Journal de conversion de l'aide UIM Ce journal rpertorie tous les membres de l'aide UIM avec les modules d'aide convertis pour l'aide UIM slectionne. Les informations gnrales sur la conversion sont d'abord affiches sur la page Prsentation. Cette page contient les sections suivantes : Gnral Cette section contient le nom du projet et le nombre total de membres du fichier cran et de membres de l'aide UIM convertis. Pilote WebFacing Cette section fournit des informations sur le niveau du pilote WebFacing utilis pour la conversion. Ces informations peuvent tre utiles pour bnficier du support technique. Informations de conversion Cette section vous permet de fournir des statistiques sur la conversion WebFacing.

18

Dveloppement des applications WebFacing

Section d'alerte Cette section fournit des informations sur la russite de la conversion. Pour plus d'informations sur les erreurs et les avertissements gnrs pendant la conversion, consultez chaque journal. La page Mots cls rfrencs affiche tous les mots cls pour chaque membre, ainsi que le niveau de support WebFacing de chaque mot cl. Slectionnez un membre dans la sous-fentre de gauche pour afficher les mots cls contenus dans ce membre. Les pages Journal de conversion DSPF et Journal de conversion de l'aide UIM contiennent des informations dtailles sur tous les membres du fichier cran et les membres du fichier d'aide convertis. Chaque page comprend une liste de tous les avertissements et de toutes les erreurs de conversion et de compilation. Slectionnez un fichier dans la sous-fentre de gauche pour en afficher les enregistrements dtaills (ou les modules d'aide UIM). Slectionnez un membre, un enregistrement ou un module d'aide pour plus d'informations sur les erreurs ou avertissements survenant pendant la conversion ou la compilation. Concepts associs Chapitre 1, Prsentation de l'outil WebFacing, la page 1 Information associe Chapitre 11, Outil WebFacing -- Prise en charge actuelle des mots cls DDS, la page 139

Gestion des ressources d'un projet WebFacing


Plusieurs ressources sont cres avec un projet WebFacing exemple. Vous pouvez accder ces ressources en cliquant sur l'onglet Projets WebFacing dans l'cran principal du plan de travail. Un projet contient des dossiers qui correspondent aux slections effectues dans l'assistant. Par exemple, il existe des dossiers pour les commandes CL, le source DDS et UIM et le style. Vous pouvez modifier les valeurs que vous avez choisies initialement dans l'assistant. Par exemple, si vous souhaitez ajouter une autre commande CL au dossier de commandes CL de votre projet, cliquez avec le bouton droit sur l'icne Commandes CL, puis cliquez sur Ajouter. Vous utiliserez ensuite directement l'cran Entre de commandes CL de l'assistant de projets WebFacing. Si vous souhaitez ajouter un nouveau membre DDS au dossier DDS, cliquez avec le bouton droit sur le dossier DDS, puis cliquez sur Ajouter. Si vous souhaitez slectionner un autre style, cliquez avec le bouton droit sur le dossier Style, puis cliquez sur Slectionner le style. Si le nom du style affich est Site Web, vous devez utiliser les outils du concepteur de site Web pour modifier le style. Pour utiliser un style Site Web, cliquez avec le bouton droit de la souris sur l'icne .website-config de l'onglet Navigator et slectionnez Ouvrir avec > Web Site Designer. Si vous ajoutez de nouveaux membres DDS ou UIM un projet qui a dj t converti, vous devrez convertir ces nouveaux membres. Pour cela, cliquez avec le bouton droit sur les nouveaux membres source, puis cliquez sur Conversion.

Chapitre 3. Cration d'un projet Web WebFacing

19

Certains dossiers ou objets sont dots de proprits que vous pouvez modifier. Si des proprits particulires sont dfinies, elles s'affichent dans la sous-fentre Proprits sous la sous-fentre Projets WebFacing. Pour modifier les proprits de votre projet, cliquez avec le bouton droit sur l'icne correspondante, puis slectionnez Proprits. Pour afficher une vue fichier de votre projet, cliquez sur l'onglet Navigateur.

Exploitation d'applications IBM i non WebFacing par le biais de la transformation dynamique du flux de donnes
Un projet WebFacing peut comporter des applications contenant des pages non converties. Il se peut par exemple que la source DDS ne soit pas disponible ou qu'il soit ncessaire d'afficher des crans non DDS (c'est--dire de type UIM) ou des crans systme pour lesquels la source n'est pas disponible. Par dfaut, les crans non convertis l'aide de WebFacing peuvent s'afficher par le biais de la transformation dynamique du flux de donnes. Dans le cas des crans DDS, le systme examine le projet WebFacing chaque premire ouverture d'un fichier cran pour dterminer si celui-ci a t converti. Si tous les enregistrements devant apparatre sur l'cran proviennent de fichiers cran convertis, l'cran converti WebFacing s'affiche. Sinon, une transformation dynamique du flux de donnes 5250 est lance pour cet cran et le rsultat s'affiche. La transformation dynamique du flux de donnes de WebFacing est disponible la fois pour les projets Web et de portail. La transformation dynamique du flux de donnes d'crans DDS non convertis est disponible uniquement lors de l'utilisation d'un systme d'exploitation hte V5R4 (ou version suivante). Avec les versions antrieures de ce systme d'exploitation, seuls les crans d'application et de systme UIM peuvent s'afficher. Outre la transformation dynamique du flux de travaux contenue dans WebFacing, les crans non convertis peuvent tre prsents par le biais d'Host Access Transformation Services (HATS) en combinant un projet HATS avec un projet HATS/WebFacing. Pour plus d'informations, voir Interoprabilit de WebFacing avec des applications HATS, la page 96 et Chapitre 4, Cration d'un projet WebFacing activ pour HATS, la page 23. Remarque : Les panneaux d'aide qui sont rfrencs par des crans DDS dans votre application WebFacing doivent tre convertis en mme temps que les autres crans de l'application.

20

Dveloppement des applications WebFacing

Tches associes Chapitre 4, Cration d'un projet WebFacing activ pour HATS, la page 23 Information associe Interoprabilit de WebFacing avec des applications HATS, la page 96 Informations complmentaires sur WebFacing et sur l'affichage des donnes sur l'cran hte

Remarques relatives aux performances de WebFacing dans le plan de travail Eclipse


Cette section dcrit les diffrentes tapes permettant d'amliorer les performances des applications WebFacing dveloppes dans le plan de travail Eclipse. 1. Fermez tous les projets qui ne sont pas actuellement utiliss ou dvelopps afin qu'il ne soient pas regnrs. Ne les ouvrez que si c'est ncessaire. Dans la vue Navigator, cliquez avec le bouton droit sur le projet et slectionnez Quitter projet. 2. Affichez le statut tas et lancez la rcupration de place la demande. Dans le menu Fentre, slectionnez Prfrences> Gnral> Affichez statut tas. Cliquez sur l'icne poubelle en bas du plan de travail pour excuter le rcuprateur de place. 3. Pour supprimer une activit de publication inutile du serveur alors que vous apportez des modifications une application, dfinissez WebSphere Application Server pour ne pas publier automatiquement. Dans la vue Serveurs, double-cliquez sur l'instance du serveur, dveloppez le menu Publication et slectionnez Ne jamais publier automatiquement. Le cas chant, vous devrez cliquez sur Publication chaque fois que vous souhaiterez publier. Par dfaut, sur tous les projets WebFacing, les compilateurs JSP Compilation et Validation sont dsactivs. Ainsi, les performances gnrales des projets WebFacing sont amliores dans le plan de travail Eclipse. Si vous crivez de nouvelles pages JSP pour votre projet ou que vous voulez valider des ressources, comme des fichiers XML, il peut tre ncessaire d'activer ces compilateurs pour voir les ventuelles erreurs dans ces fichiers. Les tapes d'activation/dsactivation de ces compilateurs pour un projet WebFacing sont dcrites ci-dessous. Si vous souhaitez amliorer encore les performances de conversion et de dploiement d'un projet WebFacing, en particulier si le nombre de membres DDS est important, procdez comme suit : 1. Crez votre projet WebFacing sans convertir les membres DDS dans la dernire page de l'assistant de cration de projet. 2. Une fois que le projet est cr, passez en vue Navigateur, cliquez avec le bouton droit de la souris sur le nouveau projet et slectionnez Proprits. Dans la bote de dialogue Proprits, cliquez sur Compilateurs. 3. Dslectionnez tous les compilateurs sauf celui de Java et de WebFacing. 4. Pour savoir ce que fait chaque compilateur, consultez la liste qui suit. Vous pouvez activer certains de ces compilateurs aprs la conversion et le dploiement pour que chaque projet profite des fonctions offertes par le plan de travail Eclipse pour un projet Web. Notez que ces modifications n'ont aucun impact sur les performances d'excution des applications WebFacing dployes. Compilateurs
Chapitre 3. Cration d'un projet Web WebFacing

21

Il est recommand de ractiver les compilateurs accompagns d'un astrisque (*) aprs la conversion et le dploiement. v Compilateur de validation d'un projet facettes * Ce compilateur valide l'intgrit de toutes les valeurs associes au projet. v Validation Cette tche permet de valider diffrents fichiers, y compris les fichiers JSP et XML. Vous pouvez consulter la liste de ces validations en slectionnant Windows > Prfrences, puis en cliquant sur Validation.

22

Dveloppement des applications WebFacing

Chapitre 4. Cration d'un projet WebFacing activ pour HATS


La fonction d'interoprabilit de HATS et de WebFacing permet d'intgrer aisment vos applications Web WebFacing et HATS. Pour plus d'informations, voir Interoprabilit de WebFacing avec des applications HATS, la page 96. Pour tirer parti de cette fonction, crez un projet configur pour prendre en charge HATS/WebFacing et liez-le un projet Web HATS. Vous pouvez ensuite excuter le projet li en tant qu'application d'entreprise unique. Le processus de cration d'un projet configur pour prendre en charge HATS/WebFacing est similaire la cration d'un projet Web WebFacing: 1. Cliquez sur Fichier > Nouveau > Projet. 2. Dveloppez WebFacing dans la sous-fentre Assistants, slectionnez Projet WebFacing activ pour HATS, puis cliquez sur Suivant pour ouvrir l'assistant Projet WebFacing activ pour HATS. 3. Les tapes suivantes sont identiques celles de la procdure de cration d'un projet Web WebFacing, l'exception du fait qu'il ne faut pas dfinir de projet EAR. Remarque : Contrairement aux projets WebFacing autonomes, les projets configurs pour prendre en charge HATS/WebFacing sont conus pour tre excuts en association avec des projets HATS et non de manire autonome. Information associe Interoprabilit de WebFacing avec des applications HATS, la page 96

Liaison d'un projet compatible HATS/WebFacing un projet HATS


L'assistant de cration d'un projet li permet de lier un projet compatible HATS/WebFacing un projet HATS. Vous pouvez ainsi combiner des applications une source convertie et non convertie. Cette interoprabilit transparente permet de tirer parti des avantages conjugus de WebFacing et de HATS. Pour qu'un cran s'affiche sur le navigateur Web, les fichiers source convertis sont recherchs dans le projet li. Si ces derniers sont prsents, la page convertie WebFacing apparat. Dans le cas contraire, la transformation dynamique du flux de donnes HATS s'affiche. Si vous n'avez pas de projet HATS/WebFacing li, il existe une transformation dynamique du flux de donnes interne pour les projets WebFacing permettant d'exploiter la source non convertie. Consultez Exploitation d'applications IBM i non WebFacing par le biais de la transformation dynamique du flux de donnes, la page 20 pour plus d'informations. Pour lier un projet compatible HATS/WebFacing un projet HATS : 1. Dans la vue Projets WebFacing, cliquez avec le bouton droit sur un projet compatible HATS/WebFacing. 2. Dans le menu en incrustation, slectionnez Liaison avec -> Projet HATS.

23

L'assistant de cration d'un projet li s'affiche ; le nom de votre projet WebFacing est spcifi par dfaut et une liste de vos projets HATS s'affiche des fins de slection. Seuls les projets Web HATS dont la connexion est de type 5250 ou 5250W apparaissent dans cette liste. Remarque : Si vous slectionnez un projet HATS dont la connexion est de type 5250, le type de connexion du projet HATS/WebFacing reste 5250W. La page Proprits de connexion permet d'indiquer le nom d'hte, le port, la page de codes et la taille de l'cran. Etant donn que vous avez lanc l'assistant en cliquant avec le bouton droit sur le projet WebFacing, les paramtres de connexion du projet WebFacing sont slectionns par dfaut. Acceptez les paramtres de connexion par dfaut et cliquez sur Terminer pour crer le projet HATS/WebFacing li. Conseil : Si les informations de connexion contenues dans le projet WebFacing diffrent de celles du projet HATS, vous pouvez slectionner un nom d'hte et un port parmi les valeurs saisies pour l'un ou l'autre projet. (Si vous avez ouvert l'assistant en cliquant avec le bouton droit sur un projet HATS, les valeurs de ce dernier sont slectionnes par dfaut comme nom d'hte et port.) Vous pouvez galement fournir de nouvelles valeurs pour le nom d'hte et le port. Les listes Page de codes et Taille d'cran contiennent toutes les options valides, mais elles sont prdfinies l'aide des paramtres du projet HATS. Pour plus d'informations sur les paramtres de cette page de l'assistant, appuyez sur la touche F1 lorsque cette dernire est affiche.

24

Dveloppement des applications WebFacing

Chapitre 5. Cration d'un projet de portlet WebFacing


Remarque : Le support du portail WebFacing est une installation facultative laquelle s'appliquent des conditions requises spcifiques. Pour plus d'informations, voir Installation HATS. Pour crer un projet de portlet WebFacing, procdez comme suit : 1. Cliquez sur Fichier > Nouveau > Projet. 2. Dveloppez WebFacing dans la sous-fentre Assistants, slectionnez Projet de portlet WebFacing, puis cliquez sur Suivant pour ouvrir l'assistant Projet de portlet WebFacing. 3. Dans l'assistant Projet de portlet WebFacing : a. Entrez le nom de votre projet dans la zone Nom du projet. b. Dans la zone Emplacement du projet, lorsque la case Utiliser l'emplacement par dfaut est coche, votre projet sera cr l'emplacement o votre espace de travail se situe sur le systme de fichiers. Pour modifier l'emplacement du systme de fichiers dfini par dfaut, dcochez la case et saisissez le chemin en cliquant sur le bouton Parcourir. c. Slectionnez un serveur de portail dans la zone de liste droulante Environnement d'excution cible. Cliquez sur Nouvel environnement d'excution pour dfinir un nouveau serveur. d. Vrifiez que la case Ajouter un projet un projet EAR est bien coche. Un nom par dfaut est propos. Vous pouvez conserver le nom propos par dfaut ou le modifier. e. Vrifiez que la case Crer un portlet est bien coche. Vous pouvez conserver le nom de portlet propos par dfaut ou le modifier. f. La notification Configuration : IBM ibmportlet.webfacing s'affiche. Cela indique qu'IBM Portlet est l'API de portlet et que ce portlet est de type WebFacing. g. Vrifiez que Fonctions Web 2.0 : Aucune fonction Web 2.0 actuellement active s'affiche. Ne cliquez pas sur Modifier pour activer une fonction Web 2.0. h. Facultatif. Vous pouvez cliquer sur Grer les fonctions si ncessaire pour modifier les facettes qui seront actives pour votre projet. Pour ajouter la prise en charge WebFacing un projet de portlet IBM Struts existant : 1. Cliquez avec le bouton droit de la souris sur le projet de portlet IBM Struts et slectionnez Proprits. La bote de dialogue Proprits du projet s'affiche. 2. Slectionnez le noeud Valeurs de projet. 3. Slectionnez la valeur du portlet WebFacing ainsi que les dpendances telles que Struts pour les portlets IBM 6.0. Si vous souhaitez ajouter une prise en charge WebFacing sans raliser de conversion, cliquez sur OK. Pour slectionner le fichier cran et les membres source de l'aide UIM convertir, cliquez sur Plus de configuration disponible. v Cliquez sur Suivant. Les crans suivants permettent de slectionner le fichier cran et les membres source de l'aide UIM convertir. Si vous souhaitez crer le projet WebFacing sans raliser de conversion, cliquez sur Terminer pour crer le projet.

25

Concepts associs Exploitation d'applications IBM i non WebFacing par le biais de la transformation dynamique du flux de donnes, la page 20

Diffrences entre un projet de portlet WebFacing et un projet Web WebFacing


Cette rubrique prsente les diffrences entre un projet de portlet WebFacing et un projet Web WebFacing. Les listes suivantes prsentent les diffrences que vous devez absolument connatre si vous utilisez un projet de portlet WebFacing plutt qu'un projet Web WebFacing. Excution v Les projets de portlet doivent tre excuts sur un serveur de portail ou dans un environnement de test de portail. Ils ne peuvent en aucun cas tre excuts sur un serveur d'applications Web. v Par dfaut, la saisie de texte au clavier des projets de portlet est effectue via le mode insertion, qui ne peut pas tre configur sur la page Proprits du projet. Dans le cas des projets Web, la saisie de texte au clavier utilise par dfaut le mode remplacement, qui peut toutefois tre configur sur la page Proprits du projet. Dans les deux types de projet (portlet ou Web), vous pouvez activer/dsactiver la touche d'insertion pour utiliser le mode insertion ou remplacement sur la page active. Seuls les projets Web WebFacing conservent le mode que l'utilisateur final avait slectionn sur la page Web prcdente. Si le mode remplacement est configur par dfaut, le programme utilise par dfaut les tabulations automatiques dans les projets Web. Dans les portlets WebFacing, les tabulations automatiques sont actives uniquement si vous basculez la touche d'insertion pour passer en mode remplacement sur la page active. v Si plusieurs applications WebFacing traitent une opration INVITE dans l'environnement de portail, la page du portail comprend un seul temporisateur INVITE, rattach l'application WebFacing qui a trait la dernire requte. v Les projets portlet WebFacing ne prennent pas en charge les fonctions suivantes : Activer la compression de page Web dans les proprits de projet sous Excution > Projet. Interoprabilit avec les projets HATS. Passerelle d'application WebFacing avec un autre projet Web tel qu'EGL Conversion v Dans le cas des projets de portlet WebFacing, les conversions gnrent la mme sortie que les projets Web WebFacing. Toutefois, la page HTML gnre partir des fichiers JSP compils peut diffrer car elle doit tre adapte l'environnement de portail. v Nous avons ajout un paramtre ID unique pour permettre l'excution de plusieurs portlets dans un mme navigateur. Vous devez respecter le mme schma de code que celui qu'utilisent les fonctions JavaScript WebFacing du produit Portal pour garantir le fonctionnement correct des paramtres Web dans les environnements Web et Portal.

26

Dveloppement des applications WebFacing

v Par dfaut, le programme slectionne l'option de conversion Remplacer le texte par le bouton des enregistrements de fentre de la page de proprits Modles de reconnaissance des touches de commande pour crer les projets de portlet WebFacing. En fait, il place les boutons dans les enregistrements de fentre pour qu'ils apparaissent clairement sur la page Web compacte du portail. Pour activer cette fonction dans un projet Web, slectionnez la proprit du projet, faites vos modifications (sous Conversion > Schmas de reconnaissance des touches de commande), enregistrez-les et convertissez de nouveau le projet. Style v Le choix d'un style de portlet WebFacing permet principalement de crer une prsentation homogne du thme du portail en slectionnant le style des boutons, des titres des fentres, des barres de dfilement, des lignes de sous-fichiers et des messages d'erreur qui seront affichs. En effet, le programme applique automatiquement le style des projets de portlet WebFacing, en respectant la prsentation slectionne par l'administrateur du portail. Par exemple, vous n'avez pas besoin de modifier la couleur des boutons : ils seront de la mme couleur que les boutons du portail (quel que soit le style de portlet WebFacing que vous avez choisi). En revanche, vous pouvez modifier la couleur des fentres et des sous-fichiers via la page de proprits Style du projet. Toutefois, nous vous dconseillons d'utiliser cette mthode pour modifier les styles d'un projet de portlet WebFacing. Pour modifier les styles d'un projet de portlet WebFacing, vous pouvez remplacer le style du portail par l'un des styles proposs dans Portal ou par un style Portal dfini par l'utilisateur. Par contre, les projets Web WebFacing doivent tre modifis via les pages des proprits de style du projet ou via le fichier apparea.css de tous les styles. v Dans un projet WebFacing, les slecteurs et les noms de classe des feuilles de style WebFacing (apparea.css) et Portal (Styles.css) sont prciss dans les balises HTML qui doivent tre stylises. Grce cela, le programme peut appliquer les dclarations figurant dans les feuilles de style Portal et WebFacing. Comme la feuille de style Portal est importe avant la feuille de style WebFacing, le programme privilgie la feuille de style. Autrement dit, le programme utilisera la dclaration WebFacing si les deux feuilles de style comprennent la mme dclaration. Il s'appuie sur l'ordre en cascade figurant dans les spcifications CSS. Par exemple, le programme applique le style suivant au titre d'une fentre :
<... class="wdwTitleBar wpsPortletAccentArea">Titre de la fentre

Dans le cas des projets de portlet WebFacing, il appliquera la couleur du thme du portail si aucune couleur n'a t prcise dans le style WebFacing. Pour les projets WebFacing Web, il ignore le style de portail wpsPortletAccentArea et utilise uniquement la classe wdwTitleBar de WebFacing. v Dans le cas des projets de portlet, la proprit Touches de commande de style de projet n'est pas disponible. Pour modifier le style des touches de commande des boutons, vous devez modifier le fichier CmdKeys.jsp du projet de portlet figurant dans le rpertoire WebContent\webfacing\ styles\chrome\html\. Les noms de classe utiliss pour styliser les touches de commande des projets de portlet WebFacing sont exclusivement tirs du fichier Style.css du portail. Autrement dit, le programme n'utilise pas les styles buttonup, buttonover et buttondown

Chapitre 5. Cration d'un projet de portlet WebFacing

27

pour styliser les boutons dans les projets de portlet WebFacing. Ils ont t remplacs par les trois styles pour projets de portlet WebFacing : 3DButtons, ButtonBar et ClickLinks. v Les styles proposs dans les projets de portlet WebFacing diffrent de ceux des projets Web WebFacing. Par consquent, vous ne pouvez pas utiliser un style Web WebFacing dans un projet de portlet WebFacing, de la mme faon que vous ne pouvez pas utiliser le style d'un projet de portlet dans un projet Web WebFacing.

28

Dveloppement des applications WebFacing

Chapitre 6. Personnalisation de vos applications WebFacing


Plusieurs mthodes permettent de personnaliser la prsentation des applications WebFacing converties : v Vous pouvez utiliser les paramtres Web pour personnaliser les membres DDS avant de les reconvertir pour afficher l'interface Web modifie. v Vous pouvez utiliser les proprits de style pour modifier l'interface utilisateur du projet Web aprs l'avoir converti, ou mettre jour la feuille de style directement. v Vous pouvez utiliser Page Designer pour modifier le style, ajouter des graphiques, mettre jour les proprits de la page et crer une prsentation beaucoup plus personnalise. Tches associes Modification des proprits d'un projet WebFacing Modification du style d'un site Web, la page 58 Cration et modification des styles WebFacing classiques, la page 56 Exemple de style du concepteur de site Web, la page 60 Rfrence associe Paramtres Web, la page 61

Modification des proprits d'un projet WebFacing


Pour modifier les proprits d'un projet WebFacing, cliquez avec le bouton droit sur l'icne Projet, Commandes CL, DDS, Aide UIM ou sur le dossier Style dans la vue Projets WebFacing, puis slectionnez Proprits. Vous pouvez modifier trois types de proprit : v Proprits de conversion Schmas de reconnaissance des touches de commande Libells des boutons des touches, la page 30 Options de code d'dition Options MNUDDS Mtadonnes de l'enregistrement XML v Proprits d'excution Proprits du projet <Commande CL> : proprits Mappages des objets DDS Mappages des objets UIM Java EE, la page 36 Actions de touche de commande Ecrans systme v Proprits de style Couleur de zone DDS Attributs d'affichage de la zone DDS Fentre Sous-fichier

29

Touches de commande Concepts associs Descripteur de dploiement, la page 53 Rfrence associe Libells des touches de commande et de fonction, la page 43 La table de priorit permet de dterminer le libell gnr pour chaque touche de commande ou de fonction. Paramtres Web, la page 61 Information associe Chapitre 6, Personnalisation de vos applications WebFacing, la page 29

Proprits de conversion
Utilisez ces crans pour visualiser et modifier les proprits de conversion. Les proprits de conversion contrlent la manire dont les fichiers DSPF et UIM slectionns sont convertis pour une utilisation dans WebFacing. Les valeurs des proprits de conversion sont stockes dans le fichier conversion.rules sous le dossier config du projet WebFacing.

Schmas de reconnaissance des touches de commande


L'onglet Schmas de reconnaissance des touches de commande permet de prciser le mode de dtection du texte des boutons de touche de commande afficher dans un navigateur Web. Une fois converties, les touches de commande s'affichent sous forme de boutons dans les pages Web. Ils ont la mme fonction que les touches de commande correspondantes. Vous pouvez dfinir des schmas de reconnaissance pour contrler le mode d'affichage des touches de commande. Pour dfinir un schma de reconnaissance, indiquez une valeur de prfixe dans la zone Prfixe et une valeur de sparateur dans la zone Sparateur, puis cliquez sur Ajouter. Le schma est alors ajout la liste de schmas de reconnaissance. Lorsqu'un schma est reconnu lors de la conversion, la valeur du texte du bouton de la page Web dpend de l'lment figurant aprs le sparateur dans votre source DDS. Par exemple, un schma de reconnaissance comportant le prfixe F et le sparateur = convertit le source F4=Invite en bouton dont le texte est Invite et le source F5=Rgnration en un bouton dont le texte est Rgnration. Pour supprimer un schma de reconnaissance, slectionnez ce schma dans la liste des schmas et cliquez sur Supprimer. Vous pouvez aussi utiliser les boutons Monter et Descendre pour dplacer les schmas de reconnaissance dans la table selon l'ordre qui vous convient.

Libells des boutons des touches


L'onglet Libells des boutons des touches permet de spcifier le texte par dfaut des touches identifies lors de la conversion mais ne correspondant pas un schma de reconnaissance dfini. Par exemple, si aucun schma de reconnaissance n'a t dfini pour la touche F1=Aide, vous pouvez indiquer la valeur F1 pour la zone Touche et la valeur Aide pour la zone Libell de bouton. Une fois converties, les touches s'affichent sous forme de boutons 'Aide' dans vos pages Web. Les utilisateurs cliquent sur ces boutons pour lancer un vnement dfini dans votre source DDS, par exemple la rgnration de la page ou l'accs l'aide en ligne.

30

Dveloppement des applications WebFacing

A l'aide des zones Touche et Libell de bouton, spcifiez le texte par dfaut des touches, puis cliquez sur Ajouter. La touche et son libell sont alors ajouts la liste des touches. Si vous souhaitez supprimer un libell de touche, slectionnez-le dans la liste des touches et cliquez sur Supprimer. Plusieurs mthodes permettent de dfinir le libell des touches de fonction figurant dans les applications WebFacing. Si plusieurs libells sont affects une touche, les processus de conversion et d'excution WebFacing utiliseront la table de priorit suivante pour dterminer le libell qui apparatra dans le navigateur. Le systme utilisera le libell dont la priorit sera la plus leve.
Tableau 1. Priorits des libells Priorit 1 (la plus leve) 2 3 4 5 Source du texte du libell de touche Actions de touche de commande dans les proprits d'excution du projet WebFacing Paramtres Web Libells des touches dynamiques Paramtres Web Libells des touches Paramtres Web Libells des touches Schmas de reconnaissance des touches de commande dans les proprits de conversion du projet WebFacing. Remarque : Vous ne pouvez pas obtenir les libells des touches de fonction avec cette mthode. Seules les constantes texte des touches de commande sont reconnues avec cette mthode lors de la conversion. Paramtre "texte" dfini dans le fichier DDS et affect au mot cl Paramtre "texte" dfini dans le fichier DDS et affect au mot cl Libells des boutons des touches dans les proprits de conversion du projet WebFacing Domaine d'application Projet

Zone Enregistrer Fichier Enregistrer

6 7 8 (la plus basse)

Enregistrer Fichier Projet

Options de code d'dition


L'onglet Options de code d'dition permet de mapper les codes d'dition. Les codes d'dition dfinis par l'utilisateur ne sont pas pris en charge par l'application WebFacing. Toutefois, vous pouvez les mapper vers l'un des codes d'dition systme disponible. v Chaque code d'dition dfini par l'utilisateur ne peut faire l'objet que d'un seul mappage. v Les valeurs autorises pour les codes d'dition dfinis par l'utilisateur sont comprises entre 5 et 9. v Les valeurs autorises pour les codes d'dition systme sont comprises entre 1 et 4, entre A et D, entre J et Q et entre W et Z. Slectionnez les codes d'dition mapper en vue de leur conversion. Cliquez sur Ajouter. Le mappage apparat dans la liste. Cliquez sur OK lorsque vous avez effectu votre slection.

Chapitre 6. Personnalisation de vos applications WebFacing

31

Options MNUDDS
Si vous avez slectionn des lments DDS de type MNUDDS pour les convertir, utilisez l'onglet Options MNUDDS pour convertir les options de menu en liens hypertexte. Le numro de l'option et tout texte inclus dans la mme zone que ce numro seront convertis en liens hypertexte. L'option de conversion automatique des commandes en liens hypertexte est slectionne par dfaut. Dans la liste droulante Sparateur, indiquez un sparateur pour identifier les options de menu. Le sparateur par dfaut est le point (.). Les autres sparateurs disponibles sont le signe gal (=), le signe deux-points (:) et le tiret (-). Cliquez sur OK lorsque vous avez effectu votre slection.

Mtadonnes de l'enregistrement XML


La conversion WebFacing gnre des fichiers XML qui dcrivent les donnes associes chaque format d'enregistrement. Par dfaut, ces fichiers sont archivs dans des fichiers JAR. L'archivage du XML dans les fichiers JAR peut rendre le dploiement plus efficace. En effet, lorsque le fichier EAR ou WAR de votre projet est install sur un serveur d'applications, un seul fichier JAR est dploy pour les donnes DDS. Certains gros projets peuvent avoir des milliers de fichiers XML, donc le dploiement de tous ces fichiers comme fichiers dsarchivs augmente le temps d'installation de l'application. Toutefois, selon votre projet, vous pouvez ne pas vouloir stocker le XML dans un fichier JAR. L'utilisation de fichiers XML dsarchivs peut faciliter la gestion des modifications. Ce cas de figure peut par exemple se prsenter si plusieurs dveloppeurs travaillent sur un projet WebFacing. Vous pouvez avoir besoin de convertir une partie de la DDS de l'application tandis qu'un autre dveloppeur convertit le reste, et le projet complet est stock dans un rfrentiel de type CVS. Si le XML gnr tait stock dans les fichiers JAR, l'un des fichiers JAR craserait l'autre dans le rfrentiel.

Proprits d'excution
Utilisez ces crans pour visualiser et modifier les proprits d'excution. Les proprits d'excution dterminent le comportement de l'application Web convertie lorsqu'elle est en cours d'utilisation par un utilisateur final.

Proprits du projet
Les valeurs de proprits du projet sont stockes dans le fichier descripteur de dploiement web.xml. L'onglet Gnral comprend les proprits suivantes. Remarque : Dans la plupart des cas, vous devez redmarrer l'application Web ou le serveur d'applications pour que les modifications soient prises en compte. Nom de l'hte Nom d'hte de la machine sur laquelle l'application rside. Cette zone doit tre complte. Remarque : Pour modifier le nom d'hte utilis par un projet HATS/WebFacing li, ditez wfhats.xml dans le fichier EAR du projet. Port de l'hte Port du systme hte que le serveur WebFacing coute. Le port 4004 est

32

Dveloppement des applications WebFacing

utilis par dfaut. Si vous souhaitez utiliser un autre port, voir la rubrique connexe Modification du port utilis par vos applications WebFacing, la page 41. Un port hte est toujours associ un nom d'hte spcifique. Remarque : Pour modifier le nom d'hte utilis par un projet HATS/WebFacing li, ditez wfhats.xml dans le fichier EAR du projet. Traiter comme si le fichier DDS tait compil avec l'option DFRWRT(*YES) Le mot cl DFRWRT permet de contrler l'affichage des enregistrements l'cran (pour une application WebFacing, le navigateur tient lieu d'cran). Dans les applications de type 5250, DFRWRT est parfois dfini sur *NO. Cela signifie que tous les enregistrements sont immdiatement affichs l'cran sans retard apparent. Toutefois, le paramtre *NO peut engendrer des retards importants dans une application convertie pour WebFacing. Si vous utilisez la proprit Grer comme si les fichiers DDS taient compils avec DFRWRT (*YES), la valeur par dfaut de WebFacing diffrera l'affichage. Cela signifie que WebFacing ne procde l'affichage que lorsque l'application lit un enregistrement ou lorsqu'elle affiche un enregistrement ayant pour mot cl FRCDTA. Vous pouvez dsactiver cette proprit dans la page des proprits pour une commande CL spcifique ou dans la page des proprits de votre projet. Le paramtrage de la commande CL remplace le paramtrage du projet. Utiliser le mode insertion pour la saisie de texte au clavier Cette option contrle le mode insertion de texte dans les zones d'entre du navigateur. Dans une application Web standard, le mode insertion est activ. Dans une session 5250 standard, le mode insertion est dsactiv (c'est--dire que le clavier est en mode remplacement). Par dfaut, le mode insertion est dsactiv dans les applications converties pour WebFacing de sorte que l'application se comporte comme l'application d'origine en mode texte. Ainsi, un utilisateur peut entrer des donnes sans slectionner ni supprimer de texte. Remarque : Cette option ne s'applique pas aux projets de portlet WebFacing excuts dans Internet Explorer, ni aux projets WebFacing excuts dans un navigateur Firefox. Firefox ne prenant pas en charge le mode remplacement, le mode insertion est systmatiquement utilis. Inclure le nom de la touche de commande dans le libell de touche Le nom de la touche de commande est inclus dans le libell du bouton utilis pour reprsenter la touche de commande. Par exemple, une touche d'entre peut tre libelle F3=Retour plutt que Retour seulement. Cette option est dsactive par dfaut. Activer la compression de page Web Slectionnez cette option si vous souhaitez activer la compression des donnes pour votre projet WebFacing. La compression des donnes peut faciliter le transfert de pages Web sur votre rseau. Les rseaux les plus lents tireront les meilleurs avantages de la compression, par exemple, si vos utilisateurs utilisent des connexions accs commut. L'activation de cette option exige plus de ressources systme pour la compression des donnes de page. Cette option est active par dfaut. Remarque : Cette option ne convient pas aux projets de portlet WebFacing. Touche de zone suivante Slectionnez cette option, puis une touche dans la liste pour activer une touche de fin de zone. Si un utilisateur appuie sur la touche de fin de
Chapitre 6. Personnalisation de vos applications WebFacing

33

zone, le texte figurant aprs la position du curseur dans la zone d'entre en cours sera supprim et le curseur passera la zone suivante. Modifier le dlai d'attente d'enregistrement maximum (WAITRCD) des fichiers DDS Slectionnez cette option pour modifier le dlai d'attente avant excution d'une opration de lecture sur les priphriques invits. Indiquez ce dlai en secondes ou utilisez *NOMAX pour disposer d'un temps d'attente illimit. Niveau de dtail de l'erreur Il s'agit du niveau de gnration d'erreurs envoy vers le navigateur de l'utilisateur final en cas d'erreur d'excution. Le niveau le plus faible est 1 et le plus lev est 3. Mettre en mmoire cache la date du travail Slectionnez cette option pour obtenir la date systme et l'heure gnres par les mots cls DATE(*SYS) et TIME partir du systme la premire fois que l'un d'entre eux est utilis. Leurs valeurs sont ensuite calcules dans l'application Web (niveau 2) et non sur le systme IBM i. La date du travail gnre par DATE(*JOB) est mise en cache dans le niveau 2 pour amliorer les performances. Cette proprit vous permet de dsactiver ou d'activer la date de travail provenant de DATE(*JOB). Lorsqu'elle est dsactive, WebFacing met en cache la date de travail par dfaut. Lorsque cette option est dfinie sur True, la date du dbut du travail est extraite du systme IBM i une seule fois, lorsque vous demandez d'abord cette valeur avec DATE(*JOB). Les attributs gnraux des travaux (le format de date, par exemple) sont galement extraits du systme IBM i une seule fois, au dmarrage, avant l'affichage des pages Web. La mise en cache de ces autres attributs de travail ne peut pas tre dsactive. Afficher la bote de dialogue d'expiration du dlai pour INVITE Slectionnez cette option pour afficher la bote de dialogue indiquant l'expiration de l'opration INVITE. Si vous ne le prcisez pas, le programme n'affiche pas de bote de dialogue lorsque l'opration expire. Convertir le texte en majuscules/minuscules Katakana (W) en majuscules Slectionnez cette option pour convertir tous les caractres en majuscules Katakana. Les proprits suivantes apparaissent sous l'onglet Authentification. Utiliser l'authentification unique Slectionnez Utiliser l'authentification unique pour permettre aux utilisateurs de se connecter plusieurs plateformes et plusieurs applications l'aide d'un ID utilisateur et d'un mot de passe uniques. Le mappage EIM et le service NAS doivent tre configurs pour utiliser l'authentification unique. Pour plus d'informations, voir Scurisation des applications Web par authentification unique, la page 45. Spcifier la rfrence de la ressource EIM Slectionnez l'option Spcifier la rfrence de la ressource EIM pour prciser le nom de la rfrence de la ressource EIM. Cette valeur doit correspondre au nom de rfrence de ressource indiqu dans le descripteur de dploiement Web. Utiliser l'authentification IBM i Slectionnez Utiliser l'authentification IBM i pour utiliser les profils utilisateur IBM i et authentifier les utilisateurs. Lorsque vous slectionnez cette option, les cases ci-dessous sont coches.

34

Dveloppement des applications WebFacing

Demander une fois l'ID utilisateur et le mot de passe Cochez cette case si vous souhaitez sauvegarder les paramtres d'ID utilisateur et de mot de passe une fois que l'utilisateur les a entrs. Dfinir des valeurs d'ouverture de session Utilisez Dfinir des valeurs d'ouverture de session pour dfinir un ID utilisateur et un mot de passe par dfaut pour votre application WebFacing. Au lieu qu'une invite soit propose l'utilisateur pour qu'il se connecte manuellement, l'ID utilisateur et le mot de passe indiqus seront soumis automatiquement par l'application WebFacing. ID utilisateur ID utilisateur par dfaut qui sera utilis pour connecter la machine sur laquelle l'application d'origine est situe. Mot de passe et Confirmation du mot de passe Il s'agit du mot de passe de l'ID utilisateur par dfaut qui sera utilis pour la connexion la machine sur laquelle l'application d'origine est situe. Ce mot de passe est chiffr et sauvegard dans le fichier descripteur de dploiement web.xml. Les donnes chiffres sont exportes avec votre projet lors de son dploiement sur WebSphere Application Server. Permettre aux utilisateurs de modifier les mots de passe expirs Si cette option est slectionne et si le mot de passe d'un utilisateur a expir lors d'une connexion une application WebFacing dans le navigateur, l'utilisateur peut modifier le mot de passe directement sans avoir ouvrir une session 5250.

<Commande CL> : proprits


Pour chaque commande CL de votre projet WebFacing, une entre est cre dans le fichier invocations.jsp inclus dans le fichier index.jsp. Une section correspondante dans le fichier descripteur de dploiement web.xml est galement cre pour chaque lien. Libell de commande Texte qui apparat dans le lien HTML sur lequel l'utilisateur clique pour accder votre application WebFacing. Commande CL Commande CL relle. Par exemple, si vous avez entr la commande CALL APILIB/ORDENTR (c'est--dire, CALL <BIBLIOTHEQUE>/ <OBJET_PROGRAMME>) dans un cran 5250 pour accder votre application, la mme commande CL sera utilise pour votre application WebFacing. Vous pouvez remplacer les paramtres du projet pour la commande CL en modifiant les proprits accessibles dans Paramtres dfinis pour cette commande CL. Nom d'appel Il s'agit de l'unique identificateur d'appel pour la commande CL. Paramtres dfinis pour cette commande CL Cette proprit vous permet uniquement de spcifier les valeurs d'une commande CL pour Nom de l'hte, Port de l'hte, ID utilisateur et Mot de passe. Si la valeur d'une zone est diffrente de sa valeur initiale, elle est signale par un astrisque. Les valeurs initiales dans cette section sont bases sur les paramtres de votre projet. Les valeurs contenues dans cette section remplacent les valeurs dfinies pour les proprits du projet si elles sont diffrentes des paramtres du projet. Les valeurs sont stockes dans le fichier descripteur de dploiement web.xml.
Chapitre 6. Personnalisation de vos applications WebFacing

35

Mappages des objets DDS


Les valeurs de mappage d'objets DDS sont stockes dans le fichier DSPFObjectMapping.properties, situ l'emplacement \conf\ de votre rpertoire source Java. Les informations sur le mappage d'objets sont disponibles dans la zone commentaires de l'cran correspondant. Elles sont affiches dans la zone de texte modifiable de l'cran.

Mappages des objets UIM


Les valeurs de mappage d'objets UIM sont stockes dans le fichier UIMObjectMapping.properties. La zone de commentaires de l'cran Mappages d'objets UIM contient des informations sur les mappages d'objets UIM et les informations de mappage relles sont affiches dans la zone de texte modifiable de l'cran.

Java EE
Cette option affiche le niveau de spcification Java EE (Java Platform, Enterprise Edition) de votre application WebFacing. Pour modifier le niveau Java EE, cliquez avec le bouton droit de la souris sur le projet et slectionnez Java EE > Assistant de mise niveau des spcifications.

Actions de touche de commande


Voir Extension de votre application WebFacing l'aide des actions de touches de commande, la page 42 dans la section Dveloppement des applications WebFacing > Personnalisation de vos applications WebFacing dans l'aide en ligne WebFacing.

Ecrans systme
Si vous cochez cette case, la transformation dynamique du flux de donnes sera applique tous les crans systme lors de l'excution ou ces derniers seront affichs par le biais des projets HATS ou des projets HATS/WebFacing lis). Ils auront donc tous la mme apparence. Si vous la dcochez, WebFacing utilisera des pages Web intgres pour les crans systme tels que DSPSPLF (permettant d'afficher un fichier spoule), ce qui raccourcira le temps de rponse. Les crans systmes intgrs sont les suivants : v WRKACTJOB v v v v v v v WRKJOB WRKJOBQ WRKJRN WRKLIB WRKMNU WRKMSG WRKMSGD

v WRKMSGQ v WRKOBJ v WRKOBJLCK

36

Dveloppement des applications WebFacing

v v v v v

WRKOUTQ WRKOUTQD WRKPRTSTS WRKSBMJOB WRKSYSSTS

v WRKUSRJOB v WRKUSRPRF v WRKWTR

Proprits de style
Utilisez les crans de proprits de style pour personnaliser la prsentation de vos pages converties. Vous pouvez personnaliser l'aspect de la zone d'application et les touches de commande l'aide des proprits de style. Pour les styles WebFacing classiques, si vous souhaitez modifier l'aspect de la prsentation et du cadre autour de ces zones, vous devez utiliser un diteur CSS pour mettre jour les fichiers de style stocks dans le dossier chrome. Pour plus d'informations sur la modification de la prsentation ou du cadre, voir Cration et modification de styles. Pour les styles du concepteur de site Web, cliquez avec le bouton droit de la souris sur l'icne .websit-config et slectionnez Ouvrir avec > Concepteur de site Web dans l'onglet Navigateur de l'environnement de dveloppement intgr si vous souhaitez modifier l'aspect de la prsentation et du cadre autour des zones. Il ne vous reste plus qu' slectionner l'icne Index et modifier le modle de page pour modifier son aspect et sa prsentation. Pour plus d'informations sur l'utilisation des outils du concepteur de site Web, consultez la rubrique connexe Using the Web Site Designer style. Les modifications de styles effectues directement ou via les pages de proprits s'appliquent uniquement au projet en cours. Sauvegardez les styles WebFacing classiques pour les utiliser dans d'autres projets. Pour ce faire, cliquez avec le bouton droit de la souris sur Style, slectionnez Style > Enregistrer sous et affectez un nom au style. La prochaine fois que vous choisirez un style WebFacing classique pour la cration d'un projet ou que vous slectionnerez un style pour remplacer celui du projet courant, vous pourrez cliquer avec le bouton droit de la souris sur Style et slectionner Style > Slectionner le style. Vous ne pouvez pas sauvegarder un style du concepteur de site Web de cette faon. Vous devez utiliser les outils du concepteur de site Web pour importer le modle et les fichiers de style dans vos projets. Remarque : Il n'est pas ncessaire de reconvertir vos fichiers source pour que les changements de style soient pris en compte.

Couleur de zone DDS


L'cran Couleur de zone DDS permet d'indiquer le mode de traitement souhait pour les couleurs de la zone DDS lorsqu'elles sont converties pour une utilisation sur le Web. Par exemple, vous pouvez dfinir l'affichage d'une zone DDS bleue dans une autre couleur sur le Web. Vous pouvez galement contrler la couleur du texte et de l'arrire-plan de vos zones lorsque vous utilisez l'attribut d'affichage d'image invers.
Chapitre 6. Personnalisation de vos applications WebFacing

37

Pour modifier le mappage d'une couleur de zone DDS dans l'interface Web : 1. Dans la sous-fentre de gauche, slectionnez Couleur de zone DDS sous Style. 2. Dans la liste Couleur de zone DDS, slectionnez la couleur de la zone DDS que vous souhaitez mapper. Les zones de groupe Couleur de zone et Couleur de l'image inverse DSPATR(RI) affichent les couleurs qui seront utilises pour afficher le texte en mode normal ou vido inverse dans l'interface Web. La table prsente le mot cl de couleur utilis ; la ligne par dfaut est utilise lorsque aucun mot cl de couleur n'a t spcifi. 3. Pour modifier le mode de mappage de la couleur de la zone DDS slectionne, cliquez sur le bouton de fonction situ droite de l'une des zones Texte ou de la zone Couleur d'arrire-plan, puis slectionnez la couleur de votre choix dans la fentre de slection. Une fois que vous avez slectionn une couleur et ferm la fentre de slection, les zones vous prsentent un aperu de l'aspect du texte ou de l'arrire-plan de cette zone sur le Web. 4. Cliquez sur OK lorsque vous avez termin.

Attributs d'affichage de la zone DDS


L'cran Attributs d'affichage de la zone DDS permet d'indiquer le mode de traitement souhait pour les attributs d'affichage de la zone DDS lorsqu'ils sont convertis pour une utilisation sur le Web. Par exemple, vous pouvez dfinir l'affichage d'une zone DDS clignotante en caractres italiques sur le Web. Pour modifier le mappage d'un attribut d'affichage de zone DDS dans l'interface Web : 1. Le paramtre Hauteur de ligne fixe permet d'affecter une hauteur de ligne fixe votre application Web. Ce paramtre est utile lorsque vous utilisez le mot cl CLRL ou plusieurs fichiers cran avec les mots cls KEEP et ASSUME dans votre DDS. 2. Pour tous les autres attributs d'affichage, il existe une zone de description et une zone d'exemple. Chaque zone de description vous permet de visualiser la description du mappage par dfaut sur le Web pour cet attribut d'affichage et prsente un exemple dans la partie de droite. 3. Vous pouvez modifier la description par dfaut en cliquant sur le bouton de fonction en regard de la zone de description. Un diteur de police apparat. Faites votre choix, puis cliquez sur OK. La nouvelle description et l'exemple de choix sont affichs dans les zones. 4. Dans le cas des sparateurs de colonnes, slectionnez une image et spcifiez les options de positionnement comme suit : v Dans la zone de nom de fichier d'image, vous pouvez saisir le nom de fichier de l'image utiliser en arrire-plan ou cliquer sur le bouton de fonction pour parcourir le dossier d'images. v Dans la liste droulante Rptition, vous pouvez indiquer si vous souhaitez dupliquer l'image horizontalement (axe x), verticalement, dans les deux directions ou pas du tout. v Dans la liste droulante Position, indiquez l'emplacement souhait pour l'image. 5. Cliquez sur OK.

38

Dveloppement des applications WebFacing

Fentre
L'cran Fentre permet d'indiquer la prsentation souhaite pour les enregistrements WINDOW DDS lorsqu'ils sont convertis pour une utilisation sur le Web. Vous pouvez personnaliser l'aspect du titre, du corps et de l'ombre de la fentre. 1. Dans la liste droulante Zones de fentre, slectionnez la zone de la fentre dont vous souhaitez personnaliser la prsentation. 2. Dans les zones de groupe Avant-plan, personnalisez le texte de la zone de la fentre (titre, corps ou ombre) que vous avez slectionne dans la liste. v Utilisez la zone Couleur pour spcifier la couleur du texte. Cliquez sur le bouton de fonction en regard de cette zone pour afficher le slecteur de couleurs. Une fois que vous avez slectionn une couleur et ferm la fentre de slection, la zone Couleur vous prsente un aperu du texte de cette zone sur le Web. v Utilisez la zone Police pour spcifier la police du texte. Pour modifier la police par dfaut, cliquez sur le bouton de fonction en regard de la zone. Le slecteur de polices apparat. Une fois que vous avez slectionn une police et ferm l'diteur, l'affichage graphique droite vous prsente un aperu du texte de cette zone de la fentre sur le Web. 3. Dans les zones de groupe Arrire-plan, personnalisez l'arrire-plan de la zone de la fentre (titre, corps ou ombre) que vous avez slectionne dans la liste. v Utilisez la zone Couleur pour spcifier la couleur de l'arrire-plan. Cliquez sur le bouton de fonction pour afficher le slecteur de couleurs. Une fois que vous avez slectionn une couleur et ferm la fentre de slection, la zone Couleur vous prsente un aperu du texte de cette zone sur le Web. v Dans la zone Image, vous pouvez saisir le nom de fichier de l'image utiliser en arrire-plan ou cliquer sur le bouton de fonction pour parcourir le dossier d'images. v Dans la liste droulante Rptition, vous pouvez indiquer si vous souhaitez dupliquer l'image horizontalement (axe x), verticalement, dans les deux directions ou pas du tout. v Dans la liste droulante Position, indiquez l'emplacement souhait pour l'image. 4. Utilisez la zone Bordure pour spcifier la couleur de la bordure. 5. Cliquez sur OK.

Sous-fichier
L'cran Sous-fichier permet d'indiquer comment la barre de dfilement et les lignes qui sont utilises pour visualiser un enregistrement de sous-fichier se prsenteront aprs la conversion. 1. Dans la liste droulante Zones de sous-fichier, slectionnez la zone d'affichage du sous-fichier dont vous souhaitez personnaliser la prsentation : Flche vers le haut Elment utilis pour un dfilement vers le haut. Curseur de dfilement Elment se dplaant vers le haut ou vers le bas lors du dfilement. Arrire-plan de la barre de dfilement Zone situe derrire la barre de dfilement.

Chapitre 6. Personnalisation de vos applications WebFacing

39

Flche vers le bas Elment utilis pour un dfilement vers le bas. Enregistrement sous-fichier - ligne impaire Lignes impaires dans les tables de sous-fichier converties. Enregistrement sous-fichier - ligne paire Lignes paires dans les tables de sous-fichier converties. 2. Dans le groupe Arrire-plan, personnalisez la prsentation de la zone que vous avez slectionne dans la liste. Les modifications sont effectues ici de la mme manire que pour le groupe en arrire-plan Fentre dcrit ci-dessus. La zone d'affichage situe droite affichera les choix que vous avez effectus. 3. Cliquez sur OK.

Touches de commande
L'cran Touches de commande permet d'indiquer comment le texte et les boutons de touche de commande dfinis dans le source DDS s'affichent dans un navigateur Web. Une fois converties, les touches de commande s'affichent sous forme de boutons dans les pages Web. Les utilisateurs cliquent sur ces boutons pour lancer un vnement dfini dans votre source DDS, par exemple la rgnration de la page ou l'accs l'aide en ligne. 1. Dans la liste droulante des tats des touches de commande, slectionnez l'tat dont vous souhaitez personnaliser la prsentation : Par dfaut Les boutons tels qu'ils se prsentent leur tat initial Survol Les boutons tels qu'ils apparaissent lorsque l'utilisateur dplace la souris au-dessus. Bouton enfonc Les boutons tels qu'ils se prsentent lorsque l'utilisateur clique dessus. 2. Dans le groupe Avant-plan, personnalisez la prsentation du texte dans l'tat de la touche de commande (Par dfaut, Survol ou Bouton enfonc) que vous avez slectionn dans la liste. v Utilisez la zone Couleur pour spcifier la couleur du texte associ l'tat de la touche de commande slectionn. Cliquez sur le bouton de fonction en regard de cette zone pour afficher le slecteur de couleurs. Une fois que vous avez slectionn une couleur et ferm le slecteur de couleurs, la zone Couleur vous prsente un aperu du texte dans cet tat sur le Web. v Utilisez la zone Police pour spcifier la police pour l'avant-plan de la zone de fentre que vous avez slectionne dans la liste. Pour modifier la slection par dfaut, cliquez sur le bouton de commande. Un diteur de police apparat. Une fois que vous avez slectionn une police et ferm l'diteur, la zone Police vous prsente un aperu du texte dans cet tat sur le Web. v Dans la zone Indentation du texte (en pixels), indiquez la taille du retrait du texte partir du bord gauche du bouton de touche de commande. v Dans la liste droulante Alignement du texte, slectionnez l'option d'alignement horizontal du texte sur le bouton. v Dans la zone Alignement vertical, slectionnez l'option d'alignement vertical du texte sur le bouton. 3. Dans le groupe Arrire-plan, personnalisez la prsentation de l'arrire-plan pour l'tat de touche de commande slectionn dans la liste. Les modifications sont effectues ici de la mme faon que pour le groupe Arrire-plan de la

40

Dveloppement des applications WebFacing

fentre dcrit ci-dessus. Remarque : Vous pouvez slectionner une couleur ou un fichier image utiliser en arrire-plan. 4. Les trois zones d'affichage droite prsentent des exemples des choix que vous avez effectus. Cliquez sur OK. Remarque : Si vous prfrez modifier directement les fichiers CSS (Cascading Style Sheet), vous pouvez utiliser l'diteur CSS fourni avec le plan de travail.

Modification du port utilis par vos applications WebFacing


Le serveur WebFacing joue le rle de passerelle entre WebSphere Application Server et votre application IBM i initiale. Il coutera sur le port TCP prdfini pour changer les donnes avec les applications WebFacing (Web ou portlet). Toutes les applications WebFacing qui se connectent au serveur sur le mme systme IBM i doivent tre configures pour se connecter au port TCP affect. Par dfaut, le serveur coute sur le port 4004. Vous pouvez indiquer une valeur diffrente l'aide de la commande IBM i WKSRVTBLE pour modifier le service TCP as-WebFacing. Si vous avez modifi le port d'coute du serveur WebFacing sur le serveur IBM i (voir Modification du port utilis par le serveur WebFacing, la page 9), vous devez modifier le port utilis par vos applications WebFacing afin que celles-ci utilisent correctement le nouveau port. Modification du numro de port WebFacing dfini dans vos projets WebFacing Le numro de port utilis par une application WebFacing pour communiquer avec le serveur WebFacing peut tre modifi pour l'ensemble du projet ou pour des commandes CL individuelles. Les ports dfinis pour les commandes CL prvalent sur les ports dfinis pour tout le projet. Chaque commande CL utilise par votre application possde un lien distinct vers l'application dans le fichier index.jsp cr par la conversion WebFacing. Si ncessaire, vous pouvez dfinir un hte et un port associ diffrents pour chaque lien. Il peut par exemple tre utile de dfinir des commandes CL utilisant diffrents htes ou ports si vous disposez d'un projet WebFacing accdant des applications sur plusieurs serveurs. Les changements de ports pour votre projet ou les commandes CL sont stocks dans le fichier descripteur de dploiement web.xml. Remarque : Si vous apportez des modifications un paramtre de port utilis par un projet dj dploy, vous devez gnralement le dployer de nouveau, puis redmarrer l'application dans la console d'administration WebSphere. Sinon, vous pouvez rechercher l'emplacement du systme IFS sur le serveur IBM i o le fichier web.xml de l'application Web WebFacing est install et redployer un seul fichier via le plan de travail. Pour raliser cette opration, vous devrez tout de mme redmarrer l'application. Cependant, elle est pratique pour modifier l'ID et le mot de passe dans le cas d'une application volumineuse. Modification du port utilis pour votre projet 1. Ouvrez l'environnement de dveloppement intgr et slectionnez l'onglet Projets WebFacing. 2. Accdez la page des proprits de votre projet. Slectionnez l'icne du projet dont vous souhaitez modifier le port et cliquez dessus avec le bouton droit, puis slectionnez Proprits. La page Proprits s'affiche. 3. Ouvrez la section Excution > Proprits > Projet de la page des proprits. 4. Cliquez sur le bouton Modification en regard de la zone Port hte.

Chapitre 6. Personnalisation de vos applications WebFacing

41

5. Cliquez sur Editer dans la bote de dialogue Slection de l'hte pour modifier le port hte. Cliquez sur OK lorsque vous avez termin. Ces modifications sont sauvegardes dans le fichier web.xml. Modification du port utilis pour une commande CL 1. Ouvrez l'environnement de dveloppement intgr et slectionnez l'onglet Projets WebFacing. 2. Accdez la page des proprits de votre projet. Slectionnez l'icne du projet dont vous souhaitez modifier le port et cliquez dessus avec le bouton droit, puis slectionnez Proprits. La page Proprits s'affiche. 3. Ouvrez la section Excution > Proprits > Projet de la page des proprits. 4. Cliquez sur le libell de la commande CL utiliser. 5. Slectionnez la case Ecraser les paramtres du projet avec cette commande. 6. Cliquez sur le bouton Modification en regard de la zone Port hte. 7. Cliquez sur Editer dans la bote de dialogue Slection de l'hte pour modifier le port hte. Cliquez sur OK lorsque vous avez termin. Ces modifications sont sauvegardes dans le fichier web.xml.

Extension de votre application WebFacing l'aide des actions de touches de commande


Vous pouvez dfinir des touches de commande personnalises dans votre application WebFacing pour appeler un service Web, un fichier JSP ou une page html. Ces touches de commande se substituent aux touches de fonction existantes et peuvent se connecter un identificateur URI d'application Web ou une URL externe. Si vous avez dj dfini un fichier JSP ou un service l'aide d'un diagramme Web, vous pouvez utiliser les actions de touche de commande pour appeler l'objet ou le service correspondant. Pour plus d'informations sur les touches de commande et tches WebFacing associes, voir Utilisation des paramtres Web avec le source DDS, la page 61. Dfinition d'une action de substitution pour une touche de commande : 1. Dans la perspective WebFacing, cliquez avec le bouton droit de la souris sur le projet et slectionnez Proprits et Excution > Actions de touche de commande. 2. Cliquez sur Ajouter. 3. Dans la zone Touche de commande, dfinissez ou slectionnez une touche de fonction (F1 F24). 4. Dans la zone Nom de l'action, dcrivez l'action rsultante. 5. Entrez le chemin du service interne ou externe dans la zone URI ou URL. 6. Indiquez ou slectionnez le cadre cible. Si vous slectionnez *NEW, une nouvelle fentre de navigateur devient le cadre cible. Si vous slectionnez *SAME, la fentre en cours devient le cadre cible. Si vous indiquez un autre nom de fentre, cette fentre est slectionne. 7. Dans la zone Libell du bouton, saisissez le libell de bouton du service. 8. Pour afficher le bouton de manire slective selon la touche de fonction associe, cochez la case Activer uniquement lorsque la touche de commande est active. Pour que le bouton soit affich sur chaque cran, laissez la case dcoche. 9. Cliquez sur OK.

42

Dveloppement des applications WebFacing

10. Redployez votre application WebFacing. 11. Redmarrez le serveur. Remarque : WebFacing ne produit aucune alerte dans le cas o une touche de fonction est dj utilise.

Libells des touches de commande et de fonction


La table de priorit permet de dterminer le libell gnr pour chaque touche de commande ou de fonction.

Fonction
Les touches de commande (par exemple, F3) et les touches de fonction (par exemple, HELP) s'affichent sur les pages Web WebFacing avec un bouton permettant de les soumettre. Le texte du libell est dfini automatiquement lors de la conversion ou de l'excution selon le contenu de votre cran DDS, du paramtre Web que vous avez dfini ou des proprits du projet de votre application WebFacing. Si plusieurs libells sont affects une touche, WebFacing utilise le tableau 2 pour dterminer le libell qui apparatra dans le navigateur.
Tableau 2. Priorits des libells Priorit 1 (la plus leve) 2 3 4 5 Source du texte du libell de touche Actions de touche de commande dans les proprits d'excution du projet WebFacing Paramtres Web Libells des touches dynamiques Paramtres Web Libells des touches Paramtres Web Libells des touches Schmas de reconnaissance des touches de commande dans les proprits de conversion du projet WebFacing. Remarque : Vous ne pouvez pas obtenir les libells des touches de fonction avec cette mthode. Seules les constantes texte des touches de commande sont reconnues avec cette mthode lors de la conversion. Paramtre "texte" dfini dans le fichier DDS et affect au mot cl Paramtre "texte" dfini dans le fichier DDS et affect au mot cl Libells des boutons des touches dans les proprits de conversion du projet WebFacing Domaine d'application Projet

Zone Enregistrer Fichier Enregistrer

6 7 8 (la plus basse)

Enregistrer Fichier Projet

Tches associes Modification des proprits d'un projet WebFacing, la page 29

Dfinition des options d'authentification


Les paramtres Authentification des proprits du projet WebFacing vous permettent de modifier un certain nombre d'options d'authentification pour votre application WebFacing. Vous pouvez demander aux utilisateurs d'entrer un ID utilisateur et un mot de passe pour accder une application WebFacing, de modifier les valeurs d'ouverture de session dj entres l'aide des zones Ouverture de session avec valeurs spcifies de l'cran Entre de commandes CL ou utiliser l'authentification unique pour votre application Web qui permet aux
Chapitre 6. Personnalisation de vos applications WebFacing

43

utilisateurs d'accder plusieurs applications sur plusieurs plateformes l'aide d'un ID utilisateur et d'un mot de passe uniques. Remarque : Si vous modifiez l'ID et le mot de passe associs un projet dj dploy, vous devez gnralement dployer de nouveau, puis redmarrer l'application dans la console d'administration WebSphere. Sinon, vous pouvez rechercher l'emplacement du systme IFS sur le systme IBM i sur lequel le fichier web.xml de l'application Web WebFacing est install et redployer uniquement ce fichier via le plan de travail. Pour raliser cette opration, vous devrez tout de mme redmarrer l'application. Cependant, elle est pratique pour modifier l'ID et le mot de passe dans le cas d'une application volumineuse. Concepts associs Descripteur de dploiement, la page 53

Invite d'ID utilisateur et de mots de passe


Si vous souhaitez demander aux utilisateurs d'entrer un ID utilisateur IBM i et un mot de passe pour accder une application WebFacing, supprimez les valeurs entres pour ID utilisateur et Mot de passe dans la bote de dialogue Proprits de votre projet WebFacing. Le programme remplace les valeurs dans le fichier descripteur de dploiement web.xml du dossier WebContent > WEB-INF. 1. Lorsque vous tes dans la vue Projets WebFacing, cliquez avec le bouton droit de la souris sur votre projet WebFacing, puis slectionnez Proprits. La page Proprits apparat. 2. Ouvrez la section Excution > Projet de la page Proprits. 3. Cliquez sur l'onglet Authentification pour afficher les paramtres d'authentification. 4. Slectionnez le bouton d'option Utiliser l'authentification IBM i. Vous pouvez alors modifier les cases Demander une fois l'ID utilisateur et le mot de passe et Dfinir des valeurs d'ouverture de session. 5. Dcochez la case Dfinir des valeurs d'ouverture de session. 6. Pour que l'utilisateur soit sollicit une fois pendant la session, cochez la case Demander une fois l'ID utilisateur et le mot de passe. 7. Cliquez sur OK. Le fichier web.xml est mis jour.

Modification des ID utilisateur et des mots de passe par dfaut


Les applications WebFacing peuvent s'excuter sous un profil IBM i dot d'un accs 5250. Si un mot de passe et un ID utilisateur de l'application ont t saisis dans les zones Dfinir des valeurs d'ouverture de session de l'cran Entre de commandes CL, ils peuvent tre modifis la page Proprits. Les valeurs sont alors modifies dans le fichier descripteur de dploiement web.xml. 1. Lorsque vous tes dans la vue Projets WebFacing, cliquez avec le bouton droit de la souris sur votre projet WebFacing, puis slectionnez Proprits. La page Proprits apparat. 2. Ouvrez la section Excution > Projet de la page Proprits. 3. Cliquez sur l'onglet Authentification pour afficher les paramtres d'authentification. 4. Sous Utiliser l'authentification IBM i, modifiez les valeurs des zones ID Utilisateur et Mot de passe. 5. Cliquez sur OK. Le fichier web.xml est mis jour.

44

Dveloppement des applications WebFacing

Dfinition d'une protection par mot de passe pour des commandes CL prcises
Il est galement possible de dfinir une protection par mot de passe pour des commandes CL prcises et non pas pour l'ensemble du projet. Les modifications apportes aux commandes CL sont galement stockes dans le fichier web.xml. 1. Lorsque vous tes dans la vue Projets WebFacing, dveloppez votre projet WebFacing et ouvrez le dossier Commandes CL. Le dossier se dveloppe pour afficher la liste des commandes CL de votre projet. 2. Cliquez avec le bouton droit de la souris sur une commande CL et slectionnez Proprits pour ouvrir la section Excution > Projet de la page Proprits. 3. Cochez la case Substitution des paramtres du projet pour cette commande. Vous pourrez ainsi remplacer les paramtres gnraux de l'ID utilisateur et du mot de passe associs au projet. 4. Pour demander l'ID utilisateur et le mot de passe, dcochez la case Dfinir des valeurs d'ouverture de session IBM i. Sinon, entrez l'ID utilisateur et le mot de passe par dfaut utiliser pour l'ouverture de session. 5. Cliquez sur OK. Le fichier web.xml est mis jour.

Activation de l'authentification unique


L'authentification unique permet aux utilisateurs d'accder plusieurs applications et plusieurs plateformes l'aide d'un ID utilisateur et d'un mot de passe uniques. Si vous l'activez, vous devez galement configurer le mappage EIM, le protocole LDAP (Lightweight Directory Access Protocol), la scurit WAS et la scurit de votre application. Le mappage EIM permet de mapper ou d'associer une personne ou une entit aux identits de l'utilisateur appropri dans plusieurs registres dans l'entreprise. Pour activer l'authentification unique pour votre application WebFacing, procdez comme suit : 1. Lorsque vous tes dans la vue Projets WebFacing, cliquez avec le bouton droit de la souris sur votre projet WebFacing, puis slectionnez Proprits. La page Proprits apparat. 2. Ouvrez la section Excution > Projet de la page Proprits. 3. Cliquez sur l'onglet Authentification pour afficher les paramtres d'authentification. 4. Slectionnez le bouton d'option Authentification unique. 5. Cliquez sur OK. Le fichier web.xml est mis jour. Remarque : Si vous slectionnez l'authentification unique, les autres options d'authentification de la page des paramtres d'authentification sont dsactives.

Scurisation des applications Web par authentification unique


L'authentification unique permet aux utilisateurs d'accder plusieurs applications et plusieurs plateformes l'aide d'un ID utilisateur et d'un mot de passe uniques. Par exemple, vous pouvez intgrer les applications WebFacing scurises sur lesquelles l'authentification unique a t configure pour permettre aux utilisateurs de s'authentifier une seule fois. Chaque systme impliqu demande toujours la prsence d'un ID utilisateur distinct. Par ailleurs, les applications de portlet WebFacing sur lesquelles l'authentification unique est active ne demandent pas d'authentification si le serveur de portail l'a dj effectue.

Chapitre 6. Personnalisation de vos applications WebFacing

45

Si vous souhaitez utiliser l'authentification unique sur vos applications, vous devez effectuer les tches suivantes : v Installation et configuration du protocole LDAP (Lightweight Directory Access Protocol) v Activation et configuration de la scurit WAS v Configuration de la scurit sur l'application v Configuration du mappage EIM (Enterprise Identity Mapping) v Configuration des applications pour l'utilisation du mappage EIM Pour raliser ces tches, vous devez installer IBM i Navigator sur un PC client. Les procdures suivantes utilisent IBM i Navigator, (livr avec IBM i Access for Windows), qui peut tre install depuis le serveur IBM i. Vrifiez que vous avez bien install l'ensemble des composants rseau, notamment TCP/IP. Les remarques suivantes prsentent le rle des composants principaux dans le processus d'authentification unique : LDAP La configuration EIM est stocke dans LDAP. En outre, WebSphere Application Server peut utiliser LDAP pour authentifier les utilisateurs Web. Dans notre cas, nous supposons que WebSphere Application Server utilise la mthode d'authentification LDAP. EIM Ce mcanisme permet de mapper l'ID utilis pour l'authentification WebSphere Application Server sur le profil utilis pour appeler l'application rsidant sur le serveur IBM i. En ralit, la configuration EIM cre une association entre les ID. L'ID utilis par WebSphere Application Server reprsente l'identit source tandis que le profil IBM i reprsente l'identit cible.

Application Web configure pour EIM L'application WebFacing doit tre configure pour utiliser un jeton gnr par EIM des fins d'authentification. Cela permet aux utilisateurs de l'application de s'authentifier auprs de WAS l'aide de leur ID LDAP et de laisser EIM mapper cet ID (la source) vers un ID sur le serveur IBM i cible (la cible). Le schma suivant illustre l'association entre les identits utilisateur source et cible sur deux systmes. Sur le systme A, l'utilisateur est authentifi par WebSphere Application Server sous l'identit johnday afin d'appeler une application rsidant sur le systme B. Sur ce dernier, le profil utilis pour excuter l'application sur le systme IBM i est jsd1. Quant John Day, il reprsente l'identificateur EIM utilis pour mapper les deux identificateurs.

46

Dveloppement des applications WebFacing

Rfrez-vous la figure suivante pendant que vous configurez la mthode d'authentification unique :

Authentification unique et projets de portlet WebFacing : Pour utiliser l'authentification unique dans une application WebFacing tournant sur un serveur de portail, procdez comme suit : v Scurisez le serveur de portail. v Configurez la ressource Jeton d'identit fournie (eimIdTokenRA.rar) dans l'environnement de production WebSphere Application Server. v Dfinissez les options d'authentification pour qu'elles utilisent le mappage EIM. Pour scuriser le serveur de portail, vous devez complter la page Scurisation du serveur d'applications et du portail WebSphere avec LDAP de l'assistant. Pour plus d'informations sur la configuration de la ressource Jeton d'identit, sur la configuration de l'application WebFacing pour l'utilisation du mappage EIM et sur la configuration d'EIM, consultez la rubrique sur la configuration d'EIM. N'oubliez pas que vous devez utiliser la console d'administration WebSphere, sous Ressources > Adaptateurs de ressources, pour configurer la ressource Jeton d'identit. Remarque : Si vous utilisez IBM i Portal Server, l'assistant Cration d'un portail WebSphere propose des pages supplmentaires pour configurer la ressource Jeton d'identit. Ds que l'utilisateur s'identifie sur le portail, le programme utilise l'ID utilisateur fourni pour mapper l'ID utilisateur sur celui qu'utilise le systme IBM i pour dmarrer l'application WebFacing. Par consquent, la configuration EIM doit comprendre un mappage entre l'ID utilisateur et le profil utilisateur IBM i appropri.

Chapitre 6. Personnalisation de vos applications WebFacing

47

Installation et configuration du protocole LDAP : Un serveur LDAP (Lightweight Directory Access Protocol) est disponible en tant qu'lment d'IBM i dans le produit Directory Services for IBM i. Le serveur fournit un annuaire de rseau accessible aux clients du rseau utilisant le protocole LDAP. Le protocole LDAP permet de dfinir le transfert et le format des messages utiliss par un client pour accder aux donnes dans un rpertoire semblable X.500. Bien que le protocole LDAP ne dfinisse pas le service d'annuaire proprement dit, les annuaires accessibles l'aide de ce protocole LDAP sont gnralement appels annuaires LDAP. Le serveur d'annuaire permet d'accder un type de base de donnes, qui stocke les informations dans une structure hirarchique semblable l'organisation du systme de fichiers intgr IBM i. Le modle de serveur d'annuaire LDAP repose sur des entres comportant un ou plusieurs attributs (nom ou adresse, type, par exemple). Gnralement, les attributs sont composs de chanes mnmoniques o cn dsigne le nom commun et mail dsigne l'adresse lectronique. Consultez l'exemple suivant pour savoir comment les entres sont stockes dans LDAP. Pour configurer le mappage EIM, vous devez d'abord configurer le protocole LDAP sur un systme IBM i. Les informations de configuration EIM sont stockes dans un annuaire LDAP. Les remarques suivantes dtaillent la procdure de base pour installer et configurer LDAP. Pour savoir comment utiliser LDAP, voir "Rseaux > TCP/IP > Services d'annuaire (LDAP)" sur le site IBM i. Mme si vous pouvez utiliser LDAP sur d'autres systmes d'exploitation, la procdure explique uniquement comment raliser la configuration sur les systmes IBM i. Remarque : Bien qu'un ID LDAP correct permette de consulter des pages protges lorsque vous scurisez votre application, vous devez associer une identit utilisateur EIM l'ID LDAP (ID source) et dsigner un profil IBM i cible pour utiliser l'authentification unique (ID cible). Reposant sur une configuration par dfaut, le serveur d'annuaire est install avec le systme d'exploitation IBM i. Pour reconfigurer le serveur d'annuaire, vous devez disposer des privilges *ALLOBJ et *IOSYSCFG. Pour configurer LDAP : 1. Dans IBM i Navigator, dveloppez Rseau > Serveurs > TCP/IP. 2. Cliquez avec le bouton droit de la souris sur Serveur d'annuaires, puis slectionnez Arrt. 3. Cliquez avec le bouton droit de la souris sur Annuaire, puis slectionnez Configuration. Si vous avez dj configur le serveur d'annuaire, slectionnez Reconfiguration. 4. Utilisez l'assistant de configuration du serveur d'annuaire pour configurer le serveur d'annuaire. Pendant la configuration, notez tous les paramtres que vous utilisez, comme les noms distinctifs (ou suffixes). Certaines de ces valeurs sont obligatoires pour activer la scurit des applications. A l'issue de l'opration, le serveur d'annuaire bnficie d'une configuration de base. Pour savoir comment configurer LDAP, voir "Rseaux > TCP/IP > Services d'annuaire (LDAP)" sur le site IBM i Information Center.

48

Dveloppement des applications WebFacing

Aprs avoir configur le serveur d'annuaire, vous pouvez ajouter des entres l'annuaire LDAP en suivant la mthode de votre choix : v Dans IBM i Navigator, cliquez avec le bouton droit de la souris sur Serveur d'annuaires et slectionnez Outils > Importation. Le programme importe les entres de l'annuaire depuis un fichier LDIF (Lightweight Directory Interchange Format) existant. v Sur les systmes IBM i, excutez la commande ldapadd depuis Qshell. v Utilisez l'outil DMT (Directory Management Tool) pour ajouter d'autres entres. Il rside sur le systme de fichiers intgr, dans le rpertoire \QIBM\ProdData\OS400\DirSrv\User Tools\Windows\setup.exe. L'exemple suivant reprsente un fichier LDAP simple, qui comprend deux entres :
dn: cn=John S. Day, ou=Rochester, o=Big Company, c=US objectclass: top objectclass: person objectclass: organizationalPerson cn: John Day sn: Day uid: johnday telephonenumber: +1 408 555 1212 description: A big sailing fan. dn: cn=Bjorn Jensen, ou=Rochester, o=Big Company, c=US objectclass: top objectclass: person objectclass: organizationalPerson cn: Bjorn Jensen sn: Jensen uid: bjenson telephonenumber: +1 408 555 1212 description:Babs is a big sailing fan, and travels extensively in search of perfect sailing conditions. title: Product Manager, Rod and Reel Division

Pour savoir comment ajouter des entres LDAP, voir "Rseaux > TCP/IP > Services d'annuaire (LDAP)" sur le site IBM i Information Center. Cration d'un serveur WebSphere Application Server scuris (IBM i) : Pour crer un serveur WebSphere Application Server scuris, procdez comme suit : 1. Lancez l'administration Web IBM pour la console IBM i. En rgle gnrale, vous pouvez lancer l'administration Web pour la console IBM i l'adresse http://MYSERVER:2001/HTTPAdmin. 2. Slectionnez Crer un nouveau serveur d'application. 3. Suivez les instructions de l'assistant en acceptant les valeurs par dfaut (ou en les dfinissant selon vos besoins) jusqu' ce que la sous-fentre Configurer la connexion unique du Jeton d'identit pour le Web IBM i Access s'affiche. 4. Slectionnez Configurer les Jetons d'identit et saisissez les valeurs correspondant votre configuration LDAP. 5. 6. 7. 8. Cliquez sur Suivant. Dans la liste droulante slectionnez votre registre source. Suivez les instructions de l'assistant jusqu' la fin. Cliquez sur Terminer pour crer le serveur.

Chapitre 6. Personnalisation de vos applications WebFacing

49

Configurer la fabrique de connexion : Pour configurer la fabrique de connexion, procdez comme suit : 1. Dmarrez le serveur cr et ouvrez sa console d'administration. Cliquez sur Lancez la console d'administration. 2. Dfinissez les proprits de personnalisation de la fabrique de connexion de manire ce qu'elles correspondent votre installation (eimDomainName, ldapHostName, parentDomain et sourceRegistryName). 3. Cliquez sur Sauvegarder pour enregistrer les modifications. Activation et configuration de la scurit WAS : Excutez le procdure suivante pour configurer la scurit WebSphere Application Server. Si vous utilisez une version de WebSphere Application Server antrieure la version 6.1, consultez la section qui suit la prsente procdure. Vous devez crer une instance de WebSphere Application Server avant d'excuter ces tches. 1. Ouvrez la Console d'administration de votre serveur. 2. Dveloppez Scurit et cliquez sur Administration, applications et infrastructure scurises. 3. Cliquez sur le bouton Assistant de Configuration des paramtres de scurit. L'Assistant de configuration des paramtres de scurit s'ouvre. 4. Cochez la case Activer la scurit des applications et vrifiez que l'option Utiliser la scurit Java 2 pour limiter l'accs aux applications par les ressources locales n'est pas slectionne. Cliquez sur Suivant. 5. La page Slectionner le rfrentiel d'utilisateurs s'ouvre. Slectionnez le bouton d'option Registre LDAP autonome et cliquez sur Suivant. 6. La page Slectionner le rfrentiel d'utilisateurs s'ouvre : a. Dans la zone Nom d'utilisateur administratif principal, saisissez l'ID correspond l'administrateur de la configuration LDAP. b. Slectionnez IBM SecureWay Directory Server dans la zone Type de serveur LDAP. c. Saisissez le nom d'hte ou l'adresse IP du systme IBM i dans la zone Hte. d. La zone Port doit conserver sa valeur par dfaut, 389. e. Dans la zone Nom distinctif de base (DN), saisissez le nom de domaine du systme au format paire=valeur. Par exemple, si le nom de domaine de votre systme IBM i est torasbcc.torolab.ibm.com, vous devez saisir le texte suivant dans la zone Nom distinctif de base (DN) :
dc=torasbcc,dc=torolab,dc=ibm,dc=com

f. Laissez blanc les zones Nom distinctif de liaison (DN) et Mot de passe de liaison, puis cliquez sur Suivant. 7. La page Rcapitulatif s'affiche. Cliquez sur Terminer. 8. Enregistrez les modifications et fermez la console d'administration WAS. 9. Redmarrez le serveur. Activation et configuration de la scurit dans les versions de WAS antrieures 6.1 : La procdure de configuration de la scurit WebSphere Application Server est commune aux environnements de production et de test. Si vous utilisez l'environnement de test, vous devez toutefois activer la console d'administration au pralable.

50

Dveloppement des applications WebFacing

1. Dans la vue Configuration de serveur, cliquez deux fois sur la configuration du serveur. 2. Cliquez sur l'onglet Configuration, puis cochez la case Activer la console d'administration. 3. Enregistrez la configuration, puis redmarrez le serveur. 4. Cliquez avec le bouton droit de la souris sur le nom du serveur, puis slectionnez Excuter la console d'administration. 5. Dveloppez Scurit > Registres d'utilisateurs, puis cliquez sur LDAP pour ouvrir la page Configuration de la scurit LDAP pour mettre jour les paramtres de scurit LDAP. Dans cet exemple, nous utilisons un annuaire LDAP, ncessaire l'implmentation de l'authentification unique. Si vous slectionnez le registre IBM i le programme authentifie les utilisateurs par l'intermdiaire des profils utilisateur rsidant sur le systme IBM i. 6. Dfinissez les proprits de scurit LDAP suivantes : v ID utilisateur serveur : ID utilisateur enregistr dans l'annuaire LDAP et utilis par WAS pour accder au serveur LDAP v Mot de passe de l'utilisateur du serveur : Mot de passe v Type : SecureWay v Hte : Nom du systme hte qu'utilisera WebSphere Application Server pour se connecter LDAP (soit le nom de domaine complet) v Port : Numro de port par dfaut (soit 389) v Nom distinctif de base (DN) : Nom spcifique de base du service d'annuaire, sous la forme dc=monsystme, dc=nomsystmehte, dc=masocit, dc=fr (point de dpart utilis par LDAP pour la recherche du service d'annuaire) 7. 8. 9. 10. v Cochez la case Ignorer la distinction maj/min. Cliquez sur OK pour mettre jour les informations. La page Scurit globale apparat. Cochez la case Activ, puis dcochez la case Appliquer la scurit Java 2. Dans la zone Registre d'utilisateurs actif, prcisez LDAP et cliquez sur OK. Enregistrez les modifications et fermez la console d'administration WAS. Redmarrez le serveur.

Configuration de la scurit de votre application : Pour configurer la scurit de votre application, vous devez raliser les tches suivantes : v Dfinitions des rles et contraintes de scurit de votre application via la modification du descripteur de dploiement Web. v Rassemblement des rles utiliss par l'application par le biais de la modification du descripteur de dploiement EAR Les rles de scurit se matrialisent par des groupes logiques d'utilisateurs (employBanque ou responsableBanque, par exemple). Lorsque vous dployez l'application, le programme associe les rles diffrents individus ou groupes d'individus spcifiques. Les contraintes dfinissent les zones de l'application scuriser (servlets et pages JSP) et les rles qui peuvent y accder. Remarque : Si vous dfinissez la scurit d'un projet de portlet WebFacing, n'excutez pas la procdure de la prsente section.

Chapitre 6. Personnalisation de vos applications WebFacing

51

Pour dfinir les rles et les contraintes de scurit : 1. Dans la vue Navigateur, dveloppez le dossier Web du projet et cliquez deux fois sur le fichier descripteur de dploiement Web (web.xml) figurant sous WebContent/WEB-INF ; celui-ci s'ouvre alors dans l'diteur. Si cette vue ne s'affiche pas dans le plan de travail, slectionnez Fentre > Afficher la vue > Autre > Gnral > Navigateur pour l'afficher. 2. Dans la partie infrieure de la zone d'dition, cliquez sur l'onglet Scurit, puis sur le bouton Ajouter de la section Rles de scurit pour insrer un nouveau rle de scurit. Pour cette application, le rle indiquera tous les utilisateurs de l'annuaire LDAP. 3. Dans la bote de dialogue Rles de scurit, tapez Tous les utilisateurs d'applications dans la zone Nom. Cliquez sur Terminer pour sauvegarder le rle. 4. Sous Contraintes de scurit, cliquez sur le bouton Ajouter pour dfinir les contraintes de scurit associes au nouveau rle de scurit. 5. Saisissez le nom de la contrainte, par exemple Contrainte d'accs, dans la bote de dialogue Ajout de contraintes, puis cliquez sur Suivant. 6. Dans la zone Nom de ressource, saisissez le nom de la ressource (par exemple, Toutes les ressources) et cochez les mthodes HTTP pour dterminer les actions que ces utilisateurs pourront raliser (GET et POST, par exemple). Si vous ne cochez aucune case, les utilisateurs pourront raliser toutes les actions. 7. Cliquez sur le bouton Ajouter en regard de la zone Schma, puis tapez /* en guise de schma d'URL. En fait, les utilisateurs auront accs toutes les ressources Web figurant dans l'application. 8. Cliquez sur Terminer pour ajouter la dfinition. 9. Sur la page Scurit, cliquez sur le bouton Ajouter figurant sous Rles autoriss pour ouvrir la bote de dialogue Dfinition d'une contrainte d'autorisation. 10. Dans la zone Description, entrez une brve description de la contrainte d'autorisation. Par exemple, Tout autoriser. 11. Cochez la case Tous les utilisateurs d'applications pour affecter le rle aux collections de ressources Web que vous venez de dfinir et cliquez sur Terminer. Le programme met jour la page Scurit. 12. Enregistrez et fermez le fichier descripteur de dploiement Web. 13. Dans la vue Navigateur, dveloppez le dossier EAR du projet et cliquez deux fois sur le fichier descripteur de dploiement EAR (application.xml) figurant dans le rpertoire META-INF. 14. Cliquez sur l'onglet Scurit, puis sur Rassembler. 15. Slectionnez Tous les utilisateurs d'applications, puis cochez la case Tous les utilisateurs autoriss figurant sous le noeud Liaisons WebSphere. 16. Enregistrez et fermez le fichier descripteur de dploiement EAR. 17. Redmarrez l'application. Dans cette configuration, vous autorisez tous les utilisateurs pouvant tre authentifis via l'annuaire LDAP (Tous les utilisateurs autoriss) accder l'ensemble des ressources du projet (/*). Malgr tout, vous pouvez crer des rles et des contraintes supplmentaires dans votre application pour prciser les utilisateurs (rles) qui peuvent accder des ressources spcifiques.

52

Dveloppement des applications WebFacing

Concepts associs Descripteur de dploiement Configuration des applications pour l'utilisation du mappage EIM : Concepts associs Descripteur de dploiement Configuration des paramtres d'authentification de l'application WebFacing : Si vous utilisez l'outil WebFacing, configurez les paramtres d'authentification dans les proprits d'excution du projet. Pour savoir comment dfinir les options d'authentification des applications WebFacing, voir Dfinition des options d'authentification. 1. Pour ouvrir les proprits du projet WebFacing, cliquez avec le bouton droit de la souris sur le projet, slectionnez la vue Projets WebFacing, puis cliquez sur Proprits. Dans les paramtres du projet, le nom du systme hte du projet correspond au systme contenant le registre cible. 2. Cliquez sur l'onglet Authentification pour afficher les paramtres d'authentification. 3. Cliquez sur le bouton d'option Utiliser l'authentification unique. 4. Dans cet exemple, tapez la chane idTokenRR dans la zone Spcifier la rfrence de la ressource EIM, aprs l'avoir active. Remarque : La chane idTokenRR importe peu. Elle est utilise lors du mappage entre la rfrence de ressource et le nom de l'adaptateur rel configur dans WAS. La chane est soumise la distinction majuscules/minuscules. 5. Cliquez sur OK pour terminer. Ajout d'une rfrence de ressource dans le descripteur de dploiement Web : Mettez jour le descripteur de dploiement Web des applications WebFacing. 1. Dans la vue Navigateur, dveloppez le dossier Web du projet et cliquez deux fois sur le fichier descripteur de dploiement Web (web.xml) dans le dossier WebContent\WEB-INF. 2. Cliquez sur l'onglet Rfrences en bas de la zone d'dition pour configurer les rfrences de ressource. 3. Cliquez sur Ajouter, puis slectionnez Rfrence de ressource pour prciser la rfrence de ressource de l'application. 4. Cliquez sur Suivant. 5. Dans cet exemple, saisissez idTokenRR comme rfrence de ressource, slectionnez javax.jms.ConnectionFactory dans la zone Type, puis slectionnez Conteneur dans la liste Authentification. 6. Cliquez sur Terminer. 7. Sous Liaisons WebSphere, tapez eis/idTokenRoot comme Nom JNDI. Il s'agit du nom que vous avez prcis en configurant le mappage EIM. 8. Enregistrez et fermez le fichier descripteur de dploiement Web.

Descripteur de dploiement
Un descripteur de dploiement est un fichier XML qui dcrit la faon dont un module ou une application doit tre dploy, en spcifiant les options de configuration et de conteneur. web.xml est un fichier descripteur de dploiement pour les applications Web. Les applications WebFacing utilisent web.xml pour
Chapitre 6. Personnalisation de vos applications WebFacing

53

stocker des informations telles que les proprits que vous dfinissez pour votre projet. Par exemple, les proprits que vous choisissez pour la gestion des ID utilisateur et des mots de passe sont stockes dans web.xml. Les applications WebFacing peuvent tre dployes sur WebSphere Application Server ou sur le serveur d'applications Web intgr IBM i. v Utilisez Websphere Application Server Network Deployment (ND) si vous dployez des applications WebFacing devant prendre en charge des fonctions haute disponibilit et de reprise. v Utilisez Websphere Application Server Express ou Base si vous dployez des applications lies WebFacing/HATS ou des applications WebFacing qui utilisent la passerelle d'application. Cette configuration ne prend pas en charge la haute disponibilit et la reprise. v Utilisez le serveur d'applications Web intgr IBM i si vous dployez des applications WebFacing et si vous disposez de ressources systme IBM i limites qui ne permettent pas d'excuter WebSphere Application Server de manire optimale. Cette configuration ne prend pas en charge la haute disponibilit et la reprise. Tches associes Configuration des applications pour l'utilisation du mappage EIM, la page 53 Modification des proprits d'un projet WebFacing, la page 29 Configuration de la scurit de votre application, la page 51 Dfinition des options d'authentification, la page 43 Rubriques connexes Modification des proprits d'un projet WebFacing, la page 29

Gestion des styles WebFacing


L'apparence visuelle de l'application WebFacing est contrle par un style WebFacing. Vous pouvez choisir l'un des styles prdfinis fournis. Vous pouvez galement personnaliser ces styles afin qu'ils rpondent aux besoins uniques de votre application. La figure suivante illustre un cran hte qui utilise le style financier prdfini. Ce style donne un exemple utilisant des menus droulants avec des liens vers d'autres sites Web.

54

Dveloppement des applications WebFacing

My Company
Products Home page 09/10/08 Type choices, press Enter. 2=Change Customer number . . . . . .: Customer name . . . . . . . : Address . . . . . . . . . .: City . . . . . . . . . . . ; Opt Part 2 000006 000068 Description ?
Part numbers not found.

Company Links

Parts Order Entry

TOR

About us Employee Portal Jobs

0001

? Select Part

Articles Site map Click on link to select

Oakley, Annie O 00001 Ave. ABC Bldg 00001 Des_Moines_

Over_Under_Shotgun Motorcycle_Sidecars

Qty Part Description 000071 Snorkle_And_Fins_Set 000072 Zoo_Season_Pass 000073 Downtown_Parking_Permit 000074 Childs_Car_Seat 000075 Old_Wooden_Toothpicks 000076 Italian Food_Cook_Book 000077 AM_FM_Stereo_Car_Radio 000078 Full_Length_Fox_Fur 000079 Junior_College_Books 000080 Old_Wooden_Toothpicks

81 6 997 65 83 75 58 0 89 90

Part number not found

Enter

Cancel

Accept order

Prompt

La figure ci-dessous illustre un cran hte qui utilise le style industriel prdfini. Ce style donne un exemple utilisant des barres de menu pointant vers d'autres sites Web.

My Company
Products Main product
10/02/12 Type choices, press Enter 2=Change Customer number . . . . . .: Customer name . . . . . . . : Address . . . . . . . . . .: City . . . . . . . . . . . ; Opt Part asdf 000072 000057 Description Part number not found COBOL_Programmers_Guide Order n 0001 ? Oakley, Annie O 00001 Ave. ABC Bldg 00001 Des_Moines_ Select Part

Company Links Additional products Downloads Support TORASBCC

Parts Order Entry

Click on link to select


Part 000051 000052 000053 000054 000055 000056 000057 000058 000059 000060 Description Qty 51 52 63 64 54 62 61 49 58 48

Snorkle_And_Fins_Set 10_lb_Test_Fishing_Line Feel_Good_Vitamins Staple_Removers QuartzDigital_Wristwatch Downtown_Parking_Permit COBOL_Programmers_Guide White_Traffic_Lane_Permit Fireplace_Tools Ten_Gallon_Hats

Part number not found.

Enter

Cancel

Accept order

Prompt

Chapitre 6. Personnalisation de vos applications WebFacing

55

Cration et modification des styles WebFacing classiques


Pour crer un nouveau style dans WebFacing, vous devez associer le projet un style WebFacing fourni qui reprsente un style non personnalis standard. Les modifications apportes au style dpendent du style slectionn et ne s'appliquent qu'au projet en cours. Pour enregistrer le style, cliquez avec le bouton droit de la souris sur votre projet, slectionnez Style > Enregistrer sous et affectez un nom au style. Aprs avoir cr un style dfini par l'utilisateur, vous pouvez sauvegarder les modifications ultrieures sous le mme nom. Vous pourrez alors slectionner ce style la prochaine fois que vous choisirez un style lors de la cration d'un projet ou que vous slectionnerez un style pour remplacer le style du projet en cours. Pour remplacer un style, cliquez avec le bouton droit de la souris sur votre projet et choisissez Style > Slectionner le style. Pour afficher la structure du rpertoire dans lequel est stock le style de votre projet, cliquez sur l'onglet Navigateur. Dans la vue Navigateur, le chemin d'accs au rpertoire de styles d'un projet est <nom_projet>/WebContent/webfacing/styles. Si vous souhaitez modifier le style utilis pour la zone d'application et les touches de commande, vous pouvez modifier le fichier apparea.css dans le rpertoire \apparea au moyen de la page des proprits de style, ou utiliser directement les outils fournis dans l'environnement de dveloppement intgr. Ces pages permettent de visualiser plus facilement les modifications apportes et indiquent comment ces modifications s'appliquent aux lments DDS comme les enregistrements de fentres et de sous-fichiers. Les modifications apportes via les pages de proprits du style s'appliquent ensuite aux noms de classe de style correspondants dans le fichier apparea.css. Veuillez noter que toutes les caractristiques de style ne peuvent pas tre modifies avec les pages de proprits WebFacing. Pour utiliser l'diteur CSS de l'environnement de dveloppement intgr, cliquez avec le bouton droit de la souris sur le fichier diter et slectionnez Ouvrir avec > Concepteur CSS. Si vous voulez personnaliser la rgion entourant la zone d'application et les touches de commande, modifiez le fichier CSS dans le rpertoire \chrome (non applicable aux styles du portlet). Pour modifier la prsentation de la page, ditez le fichier PageBuilder.jsp dans \chrome\html. La section de touche de commande est dfinie dans les fichiers CmdKeys.jsp et MenuKeys.jsp (non disponible dans tous les styles).

56

Dveloppement des applications WebFacing

Les proprits des styles sont stockes dans deux rpertoires distincts du dossier styles dans le projet WebFacing :
Fichiers pouvant tre dits pour Partie de page Web modification des Rpertoire contenant laquelle ils styles les fichiers s'appliquent v apparea.css v fichiers image (.gif, .jpg, .png) v PageBuilder.jsp v CmdKeys.jsp v Fichiers .css dfinis par l'utilisateur v <stylename>.css v <stylename>.js v MenuKeys.jsp v fichiers image (.gif, .jpg, .png) \chrome\html et \chrome \apparea v zone d'application v touches de commande v prsentation v touches de commande Non Editable l'aide des pages de proprits ? Oui

Remarque : Il n'est pas ncessaire de reconvertir vos fichiers source pour que les changements de style soient pris en compte. Rfrence associe Paramtres Web, la page 61 Information associe Chapitre 6, Personnalisation de vos applications WebFacing, la page 29

Utilisation de la vue Styles WebFacing


La vue Styles WebFacing propose des solutions pour grer vos styles WebFacing classiques. Vous pouvez l'utiliser pour copier, effacer, renommer, importer et exporter des styles. Vous pouvez travailler avec des styles dfinis par l'utilisateur (styles que vous pouvez crer ou copier sur des styles existants). Vous pouvez galement utiliser des styles dfinis par IBM (fournis avec le plan de travail). Vous ne pouvez pas grer un style Site Web au moyen de la vue Styles WebFacing. Pour ce faire, vous devez utiliser les outils du concepteur de site Web. Pour plus d'informations sur l'utilisation des outils du concepteur de site Web, consultez les rubriques connexes Remarque : Pour modifier le style d'un projet WebFacing, dans la perspective WebFacing, cliquez avec le bouton droit de la souris sur votre projet, puis slectionnez Style > Slectionner le style. Pour afficher la structure du rpertoire dans lequel est stock le style de votre projet, cliquez sur l'onglet Navigateur. Dans la vue Navigateur, le chemin d'accs au rpertoire de styles d'un projet est <nom_projet>/WebContent/webfacing/styles. Rubriques connexes : v Modification du style d'un site Web, la page 58 v Exemple de style du concepteur de site Web, la page 60

Chapitre 6. Personnalisation de vos applications WebFacing

57

Accs la vue Styles WebFacing


Pour accder la vue Styles, slectionnez Fentre > Afficher la vue > Styles WebFacing. La vue s'affiche dans la perspective WebFacing.

Copie de styles
Pour copier un style, cliquez avec le bouton droit de la souris sur le style, puis slectionnez Copier sous. Copier un style permet d'utiliser un style existant comme point de dpart pour la cration d'un nouveau style. Vous pouvez ensuite modifier le nouveau style

Suppression de styles
Pour supprimer un style, cliquez avec le bouton droit de la souris sur le style, puis slectionnez Supprimer. Les styles dfinis par IBM et fournis avec le plan de travail ne peuvent pas tre supprims.

Changement de nom de styles


Pour renommer un style, cliquez avec le bouton droit de la souris sur le style et slectionnez Renommer. Les styles dfinis par IBM et fournis avec le plan de travail ne peuvent pas tre renomms.

Importation de styles
Pour importer un style depuis un autre rpertoire dans le rpertoire de styles WebFacing, cliquez avec le bouton droit de la souris dans la vue Styles, puis slectionnez Importer. Vrifiez que le style importer utilise la mme structure que les styles dfinis par IBM et fournis avec le plan de travail. Par exemple, vrifiez qu'il contient un rpertoire chrome comprenant des fichiers .css et PageBuilder.jsp, ainsi qu'un rpertoire apparea comprenant un fichier apparea.css. Vrifiez galement que les images dsignes par PageBuilder.jsp ou par les fichiers .css se trouvent dans les rpertoires appropris.

Exportation de styles
Pour exporter un style, cliquez avec le bouton droit de la souris sur le style, puis slectionnez Exporter. Vous pouvez alors rechercher le rpertoire dans lequel le fichier va tre export.

Modification du style d'un site Web


Le style Site Web peut tre slectionn pendant la cration du projet au moyen de l'option Activation du concepteur de site Web dans la page Slection d'un style Web de l'assistant de cration de projet. Une fois le style Site Web slectionn, un modle chantillon est appliqu aux pages WebFacing selon les modles dj disponibles pour la slection au moyen des outils du concepteur de site Web. Pour plus d'informations, consultez la documentation Concepteur de site Web. Vous devez utiliser le style Site Web si vous possdez d'autres applications Web utilisant le concepteur de site Web pour appliquer des modles et organiser la navigation dans votre site Web. Le modle chantillon fourni avec le style Site Web n'inclut ni barres de navigation, ni cartes du site. Vous ne devez ajouter ces lments que lorsque l'excution de plusieurs projets WebFacing dans un mme

58

Dveloppement des applications WebFacing

navigateur est prise en charge. Le projet WebFacing peut cependant tre ajout la barre de navigation de vos projets Web et tre modifi pour avoir la mme apparence que le site Web. Remarque : Si votre application requiert une URL relative, le style du concepteur de site Web peut ne pas convenir. Pour afficher l'arborescence du rpertoire dans lequel est stock le style de votre projet, cliquez sur l'onglet Navigateur. Dans la vue Navigateur, les chemins d'accs aux rpertoires de styles d'un projet sont : <nom_projet>\WebContent\webfacing\ styles et <nom_projet>\WebContent\theme. Si vous souhaitez modifier le style utilis pour la zone d'application et les touches de commande, vous pouvez modifier le fichier apparea.css dans le rpertoire \apparea au moyen des pages des proprits Style, ou utiliser directement les outils fournis dans l'environnement de dveloppement intgr. Les pages des proprits Style permettent de visualiser plus facilement les modifications apportes et indiquent comment ces modifications s'appliquent aux lments DDS comme les enregistrements de fentres et de sous-fichiers. Les modifications apportes via les pages de proprits Style s'appliquent ensuite aux noms de classe de style correspondants dans le fichier apparea.css. Pour utiliser l'diteur CSS de l'environnement de dveloppement intgr, cliquez avec le bouton droit de la souris sur le fichier diter et slectionnez Ouvrir avec > Concepteur CSS. Si vous souhaitez modifier le cadre entourant la zone d'application et les touches de commande, vous devez modifier les fichiers dfinis par l'utilisateur au moyen du concepteur de site Web ou slectionner directement les fichiers dans le systme de fichiers des rpertoires \theme et \webfacing\styles\chrome. Pour modifier les fichiers du rpertoire \theme avec l'diteur CSS de l'environnement de dveloppement intgr, cliquez avec le bouton droit de la souris sur le fichier diter et slectionnez Ouvrir avec > Concepteur CSS. Pour modifier la prsentation et le cadre, cliquez avec le bouton droit de la souris sur le fichier WFB_blue.jtpl et slectionnez Ouvrir avec > Page Designer for Template. Pour modifier le fichier PageBuilder.jsp auquel les fichiers de style et de modle sont appliqus, cliquez avec le bouton droit de la souris sur le fichier PageBuilder.jsp dans le rpertoire \webfacing\styles\chrome et slectionnez Ouvrir avec Page Designer. Pour modifier le fichier de modle associ PageBuilder.jsp depuis Page Designer, cliquez avec le bouton droit sur Ouvrir un modle de page avec > Page Designer for Template dans la vue Conception. Cette opration donne le mme rsultat que l'ouverture du fichier WFB_blue.jtpl directement au moyen de Page Designer for Template. Pour modifier le fichier style CSS associ au modle depuis Page Designer for Template, choisissez la vue Styles et cliquez avec le bouton droit sur blue.css > Editer dans le groupe d'onglets Styles. Cette opration donne le mme rsultat que l'ouverture du fichier CSS directement depuis le concepteur CSS. Pour modifier les fichiers de prsentation et de cadre au moyen du concepteur de site Web, activez la vue Projets WebFacing et dveloppez votre projet, puis dveloppez les dossiers Style > Site Web. Cliquez avec le bouton droit sur le fichier .website-config et slectionnez Ouvrir avec > Web Site Designer. Pour modifier le modle, passez la vue Navigateur, puis cliquez avec le bouton droit sur les fichiers *.jtpl sous le rpertoire \theme et slectionnez Ouvrir avec > Page Designer for Template. Pour modifier le style CSS, cliquez avec le bouton droit sur les fichiers *.css sous le rpertoire .\theme et slectionnez Ouvrir avec > CSS Designer.
Chapitre 6. Personnalisation de vos applications WebFacing

59

Les proprits des styles sont stockes dans deux rpertoires distincts du dossier styles dans le projet WebFacing :
Fichiers pouvant tre dits pour Partie de page Web modification des Rpertoire contenant laquelle ils styles les fichiers s'appliquent apparea.css \styles\apparea v zone d'application v touches de commande v PageBuilder.jsp \chrome v prsentation Non Editable l'aide des pages de proprits ? Oui

v Fichiers .css dfinis \chrome\html par l'utilisateur \theme

Remarque : Il n'est pas ncessaire de reconvertir vos fichiers source pour que les changements de style soient pris en compte. Rfrence associe Paramtres Web, la page 61 Information associe Chapitre 6, Personnalisation de vos applications WebFacing, la page 29

Exemple de style du concepteur de site Web


Cet exemple vous montre comment des fichiers d'un mme site Web peuvent se voir appliquer des modles diffrents, ainsi qu'un exemple de modle pour la barre de navigation d'un site Web. Le fichier du modle de navigation contient des liens vers vos pages WebFacing de conception similaire. Cet exemple vous montre galement comment lier d'autres projets Web votre projet WebFacing. Procdez comme suit : 1. Crez un projet WebFacing en veillant choisir l'option Activation du concepteur de site Web dans la page Slection d'un style Web de l'assistant de cration de projet. 2. Slectionnez l'onglet Navigateur pour visualiser l'arborescence de votre projet. Dans la vue Navigateur, cliquez avec le bouton droit de la souris sur <nom_projet>/WebContent/index.jsp et slectionnez Excuter en tant que > Excuter sur le serveur. 3. Un exemple de deux liens de navigation, INV1 et INV2, apparat et ouvre les deux premires commandes CL dfinies dans votre projet. Celles-ci sont fournies en guise d'exemples. Elles ne fonctionnent que si vous les avez nommes INV1 et INV2. Cliquez sur les liens pour excuter l'application. Le programme propose galement les liens d'origine du fichier index.jsp. 4. Slectionnez l'onglet Projets WebFacing, dveloppez votre projet, puis slectionnez Style > Site Web. Cliquez avec le bouton droit de la souris sur le fichier .website-config et slectionnez Ouvrir avec > Web Site Designer. Pour modifier le modle, cliquez avec le bouton droit de la souris sur l'icne Index et slectionnez Dfinir modle > Ouvrir un modle avec > Page Designer for Template. 5. Pour ajouter un nouveau lien de navigation, slectionnez l'onglet Navigateur et copiez le fichier <nom_projet>/WebContent/inv2.jsp, puis placez-le dans le mme rpertoire avec le nom inv3.jsp. Modifiez le fichier inv3.jsp et modifiez

60

Dveloppement des applications WebFacing

les textes se rapportant INV2 en INV3. Faites ensuite glisser le fichier inv3.jsp vers la vue Navigateur du concepteur de site Web et placez-le sous l'icne Index. Vous avez dsormais accs une troisime commande CL nomme INV3. Rfrence associe Paramtres Web Information associe Chapitre 6, Personnalisation de vos applications WebFacing, la page 29

Paramtres Web
Les Paramtres Web permettent d'agir sur l'aspect de vos pages avant qu'elles ne soient cres l'aide de l'assistant WebFacing. Si vous souhaitez modifier vos pages aprs la conversion, vous pouvez utiliser un diteur de texte ou un outil de conception Web tel que Page Designer. Concepts associs Utilisation des paramtres Web avec le source DDS Tches associes Modification des proprits d'un projet WebFacing, la page 29 Modification du style d'un site Web, la page 58 Cration et modification des styles WebFacing classiques, la page 56 Exemple de style du concepteur de site Web, la page 60 Rfrence associe Remarques sur les paramtres Web, la page 82 Information associe Chapitre 6, Personnalisation de vos applications WebFacing, la page 29

Utilisation des paramtres Web avec le source DDS


Si vous personnalisez vos pages l'aide de Paramtres Web, vous bnficiez du fait que les instructions relatives aux personnalisations sont intgres en tant que commentaires dans votre source DDS. Les Paramtres Web font alors partie de votre code source et les modifications que vous effectuez ne sont pas perdues si vous convertissez ensuite un projet WebFacing. Toutefois, vous perdrez toutes les modifications directement apportes un fichier JSP gnr si vous reconvertissez le projet. Si vous ajoutez ou modifiez des paramtres Web d'un projet dj converti, reconvertissez le projet pour inclure les modifications dans votre application WebFacing. Vous pouvez galement ne reconvertir que les membres DDS que vous avez changs. Pour reconvertir des membres spcifiques, ouvrez la perspective WebFacing, cliquez sur l'onglet Projets WebFacing, dveloppez le dossier DDS, cliquez avec le bouton droit sur le membre que vous avez modifi et slectionnez Convertir. Si la vue Projets WebFacing n'apparat pas, slectionnez Fentre > Afficher la vue > Autre > WebFacing > Projets WebFacing. Si plusieurs paramtres Web du mme type sont indiqus dans une zone, un enregistrement ou un fichier unique, alors le comportement n'est pas dfini. En d'autres termes, il est impossible de savoir quel paramtre Web sera appliqu.

Chapitre 6. Personnalisation de vos applications WebFacing

61

Tableau 3. Paramtres Web Objet DDS Niveau fichier Affichage du fichier physique source Enregistrements Enregistrement standard Enregistrement de contrle de sous-fichier v Libells et ordre des touches v Touches dsactives v Taille d'affichage v Insertion de script v Passerelle d'application Constantes Constante de type message Constante date Constante heure Constante utilisateur Constante systme Zones d'entre (y compris les zones pour lesquelles l'option Les deux a t spcifie) Zone alphanumrique Zone non condense Date Heure Horodatage Variable flottante Zone prolonge DBCS Just DBCS ou autre DBCS Open DBCS Graphic Zones de sortie uniquement v Apparence v Substitutions HTML v Emplacement v Libells d'options (uniquement disponibles si la zone d'entre est prcise et accompagne du mot cl VALUES) v Apparence v Substitutions HTML v Emplacement v Libells des touches Icne Paramtres Web disponibles

62

Dveloppement des applications WebFacing

Tableau 3. Paramtres Web (suite) Objet DDS Zone alphanumrique Zone non condense Date Heure Horodatage Variable flottante DBCS Just DBCS ou autre DBCS Open DBCS Graphic Constante texte Zones masques Zone alphanumrique Zone non condense Date Heure Horodatage Variable flottante DBCS Just DBCS ou autre DBCS Open DBCS Graphic v Envoi au navigateur Icne Paramtres Web disponibles v Apparence v Libells des touches dynamiques v Substitutions HTML v Hyperlien v Image v Emplacement

Modification des paramtres Web d'un membre DDS


Si vous ouvrez la perspective WebFacing pour la premire fois, le programme affiche la vue Paramtres Web par dfaut. Elle reste vide tant que vous n'avez pas ouvert de membre source DSPF DDS dans l'diteur LPEX ou dans le Concepteur d'cran. Pour modifier les paramtres Web d'un membre DDS : 1. Dans la perspective WebFacing, dveloppez Projet WebFacing > DDS. 2. Cliquez avec le bouton droit de la souris sur le membre DDS utiliser, puis slectionnez Ouvrir avec > Editeur LPEX de systmes distants. 3. A l'invite, identifiez-vous sur le serveur. Le programme ouvre le fichier dans l'diteur. 4. Cliquez sur un objet DDS dans l'diteur. Le programme affiche la liste des paramtres de l'objet dans la vue Paramtres Web. 5. Dans la liste, cliquez sur un paramtre pour le modifier. Le programme affiche les options du paramtre Web sur la partie droite de la vue Paramtres Web.
Chapitre 6. Personnalisation de vos applications WebFacing

63

6. Si la vue Paramtres Web n'apparat pas, slectionnez Fentre > Afficher la vue > Autre > WebFacing > Paramtres Web pour l'ouvrir. 7. Pour parcourir rapidement les objets spcifiques, slectionnez Fentre > Afficher la vue > Structure pour ouvrir la vue Structure. Ds que vous cliquez sur les objets de la vue Structure, le programme met l'objet en surbrillance dans l'diteur.

Description des paramtres Web


Les Paramtres Web disponibles pour un objet DDS sont diffrents selon l'objet que vous utilisez. La prsente section dcrit chaque paramtre en dtail. Lorsque vous utilisez des Paramtres Web pour un objet, des commentaires spciaux sont ajouts au source DDS qui est ensuite trait par la conversion WebFacing. Les commentaires associs aux Paramtres Web commencent par *%%WB. La liste suivante dtaille la convention de syntaxe des paramtres Web :
*%%WB <numro> <niveau>

o <numro> reprsente le numro du paramtre Web et <niveau>, son niveau ({FIL|REC|FLD}). Pour tendre les paramtres Web sur plusieurs lignes, placez simplement le signe + en guise de caractre non vide la fin de la ligne et placez l'expression *%%WB + au dbut de la ligne suivante. Les sections suivantes dcrivent les paramtres Web par fichier, enregistrement et niveau de zone, mais galement la syntaxe des commentaires ajouts au source DDS de chaque paramtre. Si vous utilisez une version de WebSphere Development Studio Client for iSeries antrieure 6.0, vous devez savoir que certains paramtres Web utilisent une syntaxe diffrente. Si la syntaxe de certains paramtres Web est obsolte, elle est convertie dans la nouvelle syntaxe pendant la conversion WebFacing. Le cas chant, nous avons ajout la syntaxe obsolte de chaque paramtre Web.

Paramtres Web (niveau fichier)


Le seul paramtre Web au niveau fichier est Libells des touches. Libells des touches Pour les touches de fonction ou de commande contenues dans votre source DDS, vous pouvez indiquer les libells utiliser dans vos pages Web pour reprsenter les touches. Pour modifier un libell, slectionnez une touche de fonction ou de commande dans la liste Libells des touches, cliquez deux fois dans la zone Nouveau libell et tapez le nouveau texte de la touche. Pour supprimer un libell que vous avez dfini, cliquez deux fois dans la zone Nouveau libell et supprimez le texte.Sinon, vous pouvez slectionner la ligne approprie et utiliser l'option Modifier l'intitul ou la touche Supprimer. Remarque : Les libells de touche de fonction ne peuvent pas tre supprims. Syntaxe :
A*%%WB 9 FIL <libell_de_touche >["|"<libell_de_touche2> ["|"<libell_de_touche3>[...]]]

Exemple :
A*%%WB 9 FIL 12=Annuler|03=Quitter

64

Dveloppement des applications WebFacing

Paramtres Web (niveau enregistrement)


La liste suivante dtaille les catgories de paramtres Web au niveau enregistrement : v Taille d'affichage v Insertion de script v Libells des touches v Ordre des touches v Touches dsactives v Passerelle d'application Taille d'affichage Le paramtre Taille d'affichage est disponible si une taille d'affichage secondaire a t slectionne pour le fichier cran. Vous pouvez dfinir les tailles d'affichage secondaire en prcisant le mot cl DSPSIZ de niveau fichier. Le paramtre Web Taille d'affichage permet de modifier la taille de la table HTML qui permettra d'afficher votre application dans un navigateur. Ce paramtre Web concerne uniquement les enregistrements comprenant un mot cl DSPMOD conditionnel. Ces enregistrements peuvent tre affichs dans la taille d'affichage primaire ou secondaire, selon la valeur de la condition l'excution, mais la conversion WebFacing cible seulement une taille d'affichage. Si vous souhaitez que l'application affiche l'enregistrement la taille d'affichage secondaire plutt qu' la taille d'affichage primaire par dfaut, vous devez inclure ce paramtre Web. Syntaxe :
A*%%WB 10 REC

Exemple :
A*%%WB 10 REC

Insertion de script Utilisez le paramtre Insertion de script pour personnaliser les fichiers JSP qui sont crs pour des enregistrements classiques ou pour des enregistrements de contrle de sous-fichiers. Par exemple, si vous disposez d'un enregistrement de contrle de sous-fichiers appel LISTCTL, la conversion pour WebFacing crera un fichier JSP correspondant appel LISTCTLJavaScript.jsp. Le code que vous indiquez dans la zone de texte du paramtre Insertion de script sera ajout au fichier LISTCTLJavaScript.jsp pendant sa gnration. Ce paramtre permet d'entrer du code JavaScript ou des scriptlets JSP arbitraires dans les fichiers JSP convertis. Il peut tre utilis pour initialiser des zones ou pour effectuer des travaux requis pour le format d'enregistrement spcifique. Par exemple, vous pourriez ajouter du code dfinissant une valeur pour une zone condition que sa valeur initiale de celle-ci soit indfinie :
if(&{CID.INITIALVALUE} == "") { &{CID.REF}.value = "0001"; }

Dans cet exemple, le code &{CID.INITIALVALUE} dsigne une CID de zone, slectionne via le bouton Insrer l'attribut de zone. Pour savoir comment utiliser les variables de remplacement de zone, voir Dfinition des variables de remplacement de zone, la page 80. Il existe d'autres exemples, tels que le code JSP, qui dtermine l'adresse IP d'un utilisateur
Chapitre 6. Personnalisation de vos applications WebFacing

65

WebFacing, ou encore le code JavaScript, qui affiche la date et l'heure du systme de l'utilisateur. Vous pouvez utiliser le paramtre Insertion de script avec le paramtre Envoi au navigateur. Par exemple, vous pouvez utiliser les valeurs dtermines par vos scripts pour complter les zones masques pour lesquelles vous avez utilis le paramtre Envoi au navigateur. Si vous souhaitez utiliser une zone existant dj dans votre DDS comme partie de votre script, ajoutez-la votre script en cliquant sur le bouton Insrer le nom de zone. Par exemple, vous pouvez slectionner un H ou une zone masque et l'utiliser dans votre script de manire lui affecter une valeur. Syntaxe :
A*%%WB 18 REC 1 <script>

Syntaxe obsolte :
A*%%WB 18 REC <script>

L'option Insertion de script comprend deux formes obsoltes des variables de substitution : &SFLREC{FIELD} qui devient &{SFLREC.FIELD.REF} et &{FIELD} qui devient &{FIELD.REF} Par exemple, l'ancienne option Insertion de script (REC) : A*%%WB 18 REC &{FIELD1}.value=1;&RECORD3{FIELD1}.value=4 devient la nouvelle option Insertion de script (REC 1): A*%%WB 18 REC 1 &{FIELD1.REF}.value=1;&{RECORD3.FIELD1.REF}.value=4 Exemple :
A*%%WB 18 REC 1 &{CUSTCTL.field1.CURRENTVALUE}

Libells des touches Pour les touches de fonction ou de commande contenues dans votre source DDS, vous pouvez indiquer les libells utiliser dans vos pages Web pour reprsenter les touches. Pour modifier un libell, slectionnez une touche dans la liste Libells et ordre des touches, cliquez deux fois dans la zone Nouveau libell et tapez le texte de votre choix. La valeur Nouveau libell est attribue par dfaut au paramtre Web des libells de touches au niveau fichier si l'un d'entre eux est dfini. Pour supprimer un libell que vous avez dfini, cliquez deux fois dans la zone Nouveau libell et supprimez le texte. Sinon, vous pouvez slectionner la ligne approprie et utiliser l'option Modifier le libell ou la touche Supprimer. Le bouton Par dfaut supprime tous les paramtres Web associs (notamment, les libells des touches, l'ordre des touches et les touches dsactives). Remarque : Plusieurs mthodes permettent de dfinir le libell des touches de fonction figurant dans les applications WebFacing. Si plusieurs libells sont affects une touche, les processus de conversion et d'excution WebFacing utilisent une table de priorit particulire pour dterminer le libell qui apparatra dans le navigateur. Pour connatre la priorit utilise pour dterminer les libells de touche, voir Libells des boutons des touches, la page 30.

66

Dveloppement des applications WebFacing

Syntaxe :
A*%%WB 9 REC <libell_de_touche >["|"<libell_de_touche2> ["|"<libell_de_touche3>[...]]]

Exemple :
A*%%WB 9 REC 2=Entre|1=Imprimer

Ordre des touches Dans le cas des touches de fonction ou de commande figurant dans le source DDS, vous pouvez indiquer si un libell de touche est masqu dans les pages Web, ainsi que l'ordre dans lequel les touches seront affiches. Pour masquer une touche, slectionnez la touche dans la liste Libells et ordre des touches et slectionnez Masqu dans la liste droulante de la colonne Etat. Le programme supprime la touche de la liste des boutons sur la page Web mais ne dsactive pas la touche correspondante sur le clavier. Pour dsactiver une touche, slectionnez la touche dans la liste Libells et ordre des touches et slectionnez Dsactiv dans la liste droulante de la colonne Etat. Le programme supprime la touche de la liste des boutons sur la page Web et dsactive la touche correspondante sur le clavier. Si la liste Libells et ordre des touches propose plusieurs touches, vous pouvez modifier l'ordre d'affichage de la touche en cliquant sur le bouton Monter ou Descendre. Le bouton Par dfaut permet de restaurer l'ordre initial des touches. Syntaxe :
A*%%WB 11 REC <touche_caractre_signalisation> [<touche_caractre_signalisation2> [<touche_caractre_signalisation3> [...]]]

O <touche_caractre_signalisation> revient CAnn | CFnn | SFLFOLD[(CAnn|CFnn)] | SFLDROP[(CAnn|CFnn)]. Exemple :


A*%%WB 11 REC CA02 CF14 SFLFOLD(CF10) SFLDROP(CA09)

Si SFLFOLD ou SFLDROP est indiqu sans touche de caractre de signalisation, par exemple :
A*%%WB 11 REC CA02 CF14 SFLFOLD SFLDROP(CA09)

Le programme met jour le paramtre Web sur la valeur suivante :


A*%%WB 11 REC CA02 CF14 SFLFOLD(CF10) SFLDROP(CA09)

en ajoutant le mot cl SFLFOLD prcis via la touche de fonction 10. Touches dsactives Ce paramtre Web fonctionne avec les libells des touches et l'ordre des touches. Il permet de dsactiver une touche de caractre de signalisation active (touche de commande ou de fonction) sur le clavier et ne se contente pas de masquer son libell dans l'interface utilisateur Web. Sur l'interface utilisateur des paramtres Web, vous pouvez dfinir l'tat d'une touche sur l'une des trois valeurs suivantes : v Visible : Le libell de la touche est visible et la touche associe sur le clavier est active.

Chapitre 6. Personnalisation de vos applications WebFacing

67

v Masqu : Le libell de la touche est masqu mais la touche associe sur le clavier est active. v Dsactiv : Le libell de la touche est masqu et la touche associe sur le clavier est dsactive. Les touches sont classes selon le paramtre Web Ordre des touches. Si le paramtre Web Ordre des touches n'est pas spcifi, l'ordre est dtermin selon l'ordre numrique des touches de commande et l'ordre alphabtique des touches de fonction, sachant que les touches de commande viennent toujours avant les touches de fonction. Si une touche est dfinie la fois comme visible dans le paramtre Web Ordre des touches (A*%%WB 11) et dans le paramtre Web Touches dsactives (A*%%WB 41), la squence visible a priorit. Syntaxe
A*%%WB 41 REC <touche_caractre_signalisation> [<touche_caractre_signalisation2> [<touche_caractre_signalisation3> [...]]]

Exemples Touches affectes : CF03 CA01 PRINT HELP 1. Ordre des touches visibles : CA01 HELP Dsactiv : CA01 CF03 Rsultats : (ordre des touches visibles : CA01 HELP ; touches masques mais actives : PRINT ; touches dsactives : CF03) 2. Ordre des touches visibles : aucune Dsactiv : CA01 CF03 Rsultats : (ordre des touches visibles : HELP PRINT ; touches masques mais actives : aucune ; touches dsactives : CA01 CF03) 3. Ordre des touches visibles : CA01 HELP Dsactiv : aucune Rsultats : (ordre des touches visibles : CA01 HELP ; touches masques mais actives : CF03 PRINT ; touches dsactives : aucune) 4. Ordre des touches visibles : aucune Dsactiv : aucune Rsultats : (ordre des touches visibles : CA01 CF03 HELP PRINT ; touches masques mais actives : aucune ; touches dsactives : aucune) Passerelle d'application Pour interagir avec une autre application Web, slectionnez le paramtre Passerelle d'application, puis Utiliser cet enregistrement pour les paramtres de passerelle d'application. Ce paramtre est disponible uniquement pour les enregistrements comportant des zones masques (usage H) ou aucune zone. Dans la zone d'entre, indiquez l'adresse URL de l'application cible. Cette URL est au format "/appContextRoot/appEntryPoint" o appContextRoot correspond la racine de contexte de l'application Web avec laquelle vous voulez interagir et appEntryPoint au point d'entre de cette application Web. Pour plus de dtails sur la procdure suivre pour interagir avec une autre application Web, voir Utilisation de la passerelle d'application WebFacing pour l'interaction avec d'autres applications Web, la page 99.

68

Dveloppement des applications WebFacing

Remarque : v Si vous spcifiez le paramtre Passerelle d'application, tous les autres paramtres contenus dans cet enregistrement et dans toutes les zones de ce dernier ne seront pas disponibles et seront supprims le cas chant. Pour viter cela, utilisez la fonction Annuler ou la combinaison de touches Ctrl-Z pour revenir aux paramtres d'origine. v Les caractres admis dans les noms de zones de l'enregistrement sont limits 'A' 'Z' et '0' '9'. v Les mots cls DATFMT et DATSEP ne doivent pas tre utiliss dans une zone de date masque et les mots cls TIMFMT et TIMSEP dans une zone horaire masque. Syntaxe
A*%%WB 42 REC /appContextRoot/appEntryPoint

Exemple Pour interagir avec une application Web o la racine du contexte correspond webApp et le point d'entre ProcessOrder : A*%%WB 42 REC /webApp/ProcessOrder

Paramtres Web (niveau zone)


La liste suivante dtaille les catgories de paramtres Web au niveau zone : v Aspect v v v v v Libells des touches dynamiques Substitutions HTML Hyperlien Image Emplacement

v Libells des options v Envoi au navigateur Aspect La catgorie Aspect et texte propose plusieurs options, notamment Visibilit, Remplacer la classe de style et Remplacer la valeur de zone : v L'option Visibilit permet de masquer la zone par le biais du paramtre Web Cach. Vous pouvez galement utiliser le paramtre Web Caractres masqus pour indiquer une plage de caractres que vous ne souhaitez pas afficher. Par exemple, vous pouvez masquer les deux premiers caractres pour afficher uniquement le texte de l'option (1. Tches utilisateur - 2. Tches bureau) si l'cran affiche un menu proposant plusieurs options rpertories par numro et que l'utilisateur peut choisir. Dans une situation de ce type, vous devez choisir l'option Caractres masqus et indiquer la plage De 1 2. Si vous utilisez le paramtre Web Cach, la mme zone n'autorise aucun autre paramtre Web. v L'option Remplacer la classe de style permet de prciser la classe de feuille de style utiliser avec la zone. Imaginons que vous souhaitez que toutes les donnes numriques s'affichent dans une police ou une couleur particulire et que vous avez dfini une classe de feuille de style numrique cet effet. Si le programme comporte une zone de numro

Chapitre 6. Personnalisation de vos applications WebFacing

69

de client (numcli, par exemple), vous pouvez cocher la case Remplacer la classe de style et mentionner le nom de la classe de la feuille de style numrique. v Remplacer la valeur de zone vous permet d'indiquer le texte que vous souhaitez afficher la place de la valeur renvoye pour votre zone. Dans le cas des zones de constante, le programme remplace le titre de la case cocher par Remplacer texte et la zone prend par dfaut le texte de la constante. Syntaxe (option Cach) :
A*%%WB 4 FLD

Syntaxe (option Caractres masqus) :


A*%%WB 5 FLD <de> <>

Syntaxe (option Remplacer la classe de style) :


A*%%WB 1 FLD <style> <zone>

Syntaxe (option Remplacer la valeur de zone) :


A*%%WB 3 FLD <longueur>"|"<texte>

Exemple (option Cach) :


A*%%WB 4 FLD

Exemple (option Caractres masqus) :


A*%%WB 5 FLD 1 12

Exemple (option Remplacer la classe de style) :


A*%%WB 1 FLD wf_default wf_field

Exemple (option Remplacer la valeur de zone) :


A*%%WB 3 FLD 10|OOOOOOOOOO

Libells des touches dynamiques Le paramtre Libells des touches dynamiques peut permettre de dterminer le libell du texte d'une touche de commande pendant la phase d'excution. Ce paramtre est disponible uniquement pour les zones de sortie. Grce ce paramtre, une touche de commande est associe la zone de sortie et le texte de la touche de commande est dtermin par la valeur d'excution de la zone. Vous pouvez par exemple utiliser cette fonction si votre application doit prendre en charge plusieurs langues et que vous souhaitez que le texte de la touche de commande apparaisse dans la langue de l'utilisateur. L'une des mthodes consiste disposer d'un MSGF par langue, contenant les chanes de texte utilises par l'application, et placer chaque MSGF dans une bibliothque spcifique la langue. Si la valeur de la zone de sortie est lue depuis le MSGF, vous pouvez modifier la langue du texte affich dans la zone en plaant la bibliothque contenant le MSGF associ la langue de l'utilisateur plus haut dans la liste des bibliothques du profil utilisateur. De cette faon, le libell de la touche de commande apparat dans la langue de l'utilisateur. Pour utiliser ce paramtre, choisissez le paramtre Libells des touches dynamiques et slectionnez l'option Utiliser la valeur de zone en tant que libell de la touche de fonction. Dans la liste, choisissez la touche qui sera associe au texte de la zone de sortie. Sinon, vous pouvez galement

70

Dveloppement des applications WebFacing

choisir l'option *AUTO dans la liste. *AUTO signifie que la valeur de zone est analyse au moment de l'excution pour dterminer quelle touche de commande le libell est associ. Le programme peut ainsi analyser plusieurs libells. Remarque : Plusieurs mthodes permettent de dfinir le libell des touches de fonction figurant dans les applications WebFacing. Si plusieurs libells sont affects une touche, les processus de conversion et d'excution WebFacing utilisent une table de priorit particulire pour dterminer le libell qui apparatra dans le navigateur. Pour connatre la priorit utilise pour dterminer les libells de touche, voir Libells des boutons des touches, la page 30. Remarque : A l'heure actuelle, seul un petit nombre de types de chane sont pris en charge par *AUTO. Dterminez si *AUTO fonctionne avec votre application en fonction des schmas rpertoris dans le tableau des prfixes et des sparateurs ci-dessous et des chanes de libell de touche de commande utilises dans votre application. Le tableau identifie les schmas par un prfixe et un sparateur. Par exemple, le programme utilisera la chane Quitter comme libell de la touche de commande si la chane F3=Quitter constitue la valeur de sortie et si vous avez choisi l'option *AUTO dans la liste. F est considr comme le prfixe, = est le sparateur et le texte aprs le sparateur est utilis comme libell. Si vous prcisez l'option *AUTO, vous pourrez dfinir plusieurs libells dans la zone de sortie.
Prfixe F FP CF CA PF Sparateur = = = = =

Avertissements v *AUTO peut influer sur les performances d'excution. Vous pouvez viter d'utiliser *AUTO en vous assurant que chaque mappage de zone de sortie vers une touche de commande est bien unique. v Si vous utilisez non pas l'option *AUTO, mais des MSGF pour le texte des zones de sortie, le texte du MSGF ne doit pas inclure la touche. Par exemple, pour Quitter, le texte d'un MSGF doit tre Quitter et non F3=Quitter. Syntaxe :
A*%%WB 20 FLD (<numro_touche> | *AUTO)

Exemple :
A*%%WB 20 FLD F12

Substitutions HTML Le paramtre Substitutions HTML vous permet de remplacer le code HTML gnr par du code HTML dfini par l'utilisateur ou d'ajouter votre propre code HTML dans le code HTML gnr. Cliquez sur le bouton d'option Dfini par le programme pour prciser que la valeur de la zone sera utilise en tant que code HTML gnr. Vous
Chapitre 6. Personnalisation de vos applications WebFacing

71

pouvez utiliser ce paramtre si vous souhaitez que le programme d'application calcule le code HTML de la zone plutt que d'utiliser un code quelconque gnr par la conversion WebFacing. Cliquez sur le bouton d'option Dfini par l'utilisateur pour prciser le texte ou les balises HTML qui peuvent tre affichs avec ou la place de la valeur de la zone. Dans la zone d'entre, tapez les balises HTML que vous souhaitez utiliser. Par dfaut, le paramtre Web correspond au script qui reprsente la valeur de la zone ou le texte de la constante. Si vous souhaitez utiliser la valeur de la zone dans le code HTML, cliquez sur le bouton Insrer l'attribut de zone. Pour savoir comment utiliser les variables de remplacement de zone, voir Dfinition des variables de remplacement de zone, la page 80. Par exemple, vous pouvez utiliser ce paramtre si vous souhaitez que la valeur de la zone apparaisse en caractres gras. Pour ce faire, associez la balise <B> au texte &{FIELD.INITIALVALUE}. Dans cet exemple, vous allez modifier la zone d'entre de sorte que le code HTML affiche <B> &{FIELD.INITIALVALUE}</B>. Si le code de &{FIELD.INITIALVALUE} n'est pas prsent par dfaut, vous pouvez l'ajouter en cliquant sur le bouton Insrer l'attribut de zone. Vous pouvez galement ajouter des valeurs spciales (date ou heure du systme, par exemple) au code HTML dfini par l'utilisateur. Pour plus d'informations sur l'utilisation de valeurs spciales dans le code HTML, voir Utilisation de valeurs spciales, la page 81. Cliquez sur le bouton d'option Insrer pour personnaliser les zones en ajoutant du code HTML supplmentaire. Vous pouvez ventuellement ajouter du code HTML Avant, A l'intrieur de ou Aprs la balise HTML qui est gnre automatiquement pour la zone. Imaginons que vous disposez d'une zone d'entre pour les numros d'employ et que dans votre entreprise, tous les numros d'employ comportent le prfixe 64-. Vous pouvez simplifier l'utilisation de la zone en ajoutant du code HTML, par exemple : Avant (%%WB 6) <strong>64- prfixe obligatoire</strong> A l'intrieur de (%%WB 7) value="64-" title="Numro d'employ" Aprs (%%WB 8) <a href="help.htm">Cliquez ici pour plus d'informations sur cette zone</a> Dans cet exemple, le code HTML situ Avant la zone fournit certaines informations sur la zone et utilise la balise <strong> de manire ce que les informations soient mises en vidence par une police en gras. Le code HTML gnr par la conversion utilisant la balise <input> pour les zones d'entre, l'attribut HTML value="64-" peut tre insr l'intrieur de la balise <input> pour que la zone soit dj complte par le prfixe de numro d'employ et que les utilisateurs n'aient pas le saisir. Nous avons galement ajout l'attribut title="Numro d'employ" afin qu'une infobulle d'informations apparaisse lorsque vous survolez la zone avec la souris. Le code HTML situ Aprs la zone dfinit un lien sur lequel les utilisateurs peuvent cliquer pour obtenir plus d'informations sur celle-ci. N'oubliez pas de tester de manire approfondie les pages d'essai que vous modifiez l'aide du paramtre Insertion de HTML. Les modifications

72

Dveloppement des applications WebFacing

effectues peuvent tre incompatibles avec le code HTML qui est gnr par la conversion WebFacing. Pour viter cela, vous pouvez convertir votre programme sans utiliser les Paramtres Web, examiner la source .html ou .jsp qui est gnre pour voir les modifications pouvant tre ralises sans risque l'aide des paramtres Web, les appliquer, puis lancer de nouveau la conversion. Syntaxe (option Dfini par le programme) :
A*%%WB 16 FLD

Syntaxe (option Dfini par l'utilisateur) :


A*%%WB 17 FLD 1 <html> A*%%WB 17 FLD 1 &{FIELD.INITIALVALUE}

Ds que le programme rencontre la syntaxe obsolte %FieldValue, il lui associe la nouvelle forme &{FIELD.INITIALVALUE} :
A*%%WB 17 FLD <html> A*%%WB 17 FLD &FieldValue

Syntaxe (option Avant) :


A*%%WB 6 FLD <html>

Syntaxe (option A l'intrieur de) :


A*%%WB 7 FLD <html>

Syntaxe (option Aprs) :


A*%%WB 8 FLD <html>

Exemple (option Dfini par le programme) :


A*%%WB 16 FLD

Exemple (option Dfini par l'utilisateur) :


A*%%WB 17 FLD 1 <BOLD>&{PARTSFL.STQTY.CURRENTVALUE}</BOLD>

Exemple (option Avant) :


A*%%WB 6 FLD <strong>64- prfixe obligatoire</strong>

Exemple (option A l'intrieur de) :


A*%%WB 7 FLD value="64-"

Exemple (option Aprs) :


A*%%WB 8 FLD <a href="help.htm">Cliquez ici pour plus dinformations sur cette zone.</a>

Hyperlien Le paramtre Hyperlien permet d'afficher la zone sous la forme d'un hyperlien. Aprs avoir format l'hyperlien selon les paramtres DDS ou les paramtres du navigateur, vous pouvez associer le lien une page statique ou raliser des actions. Si vous souhaitez remplacer les paramtres du navigateur pour affecter un autre aspect aux hyperliens, cochez la case Utiliser les paramtres DDS. Si vous associez le paramtre Hyperlien au paramtre Image, la zone peut tre affiche sous la forme d'un graphique pouvant galement jouer le rle d'un hyperlien. Certains des paramtres

Chapitre 6. Personnalisation de vos applications WebFacing

73

acceptent des valeurs de zone en entre. Pour savoir comment utiliser les variables de remplacement de zone, voir Dfinition des variables de remplacement de zone, la page 80. Remarque : Sous certaines conditions, les liens hypertexte Action que vous crez l'aide des paramtres Web ne s'affichent pas dans un navigateur. De cette faon, les conditions d'erreur sont vites lorsque l'hyperlien ne s'applique pas ce qui est actif ou disponible dans le navigateur. Par exemple : v L'hyperlien se trouve dans un enregistrement ne correspondant pas actuellement la fentre suprieure et ne se trouvant pas non plus sur la couche suprieure. v Une touche de fonction que vous avez associe au lien n'est pas active en ce moment. v Une zone rfrence qui constitue une partie du lien n'est pas un enregistrement actif ou n'est pas lisible. Par exemple, l'enregistrement est protg par d'autres enregistrements qui utilisent le mot cl PROTECT. Utiliser les paramtres DDS La plupart des navigateurs suivent une convention pour la couleur et l'apparence des hyperliens sur les pages Web ou utilisent des paramtres modifiables par l'utilisateur pour l'apparence des hyperliens. Par exemple, les liens non visits peuvent tre affichs en bleu et les liens visits peuvent tre affichs en violet. Si vous souhaitez que le navigateur affiche l'hyperlien selon la mme apparence que celle qu'utilise la zone figurant dans le fichier DDS, slectionnez le bouton d'option Utiliser les paramtres DDS. Syntaxe (option Utiliser les paramtres DDS) :
A*%%WB 12 FLD 3 <type_hyperlien> <dtails_hyperlien> 1

Syntaxe (option Utiliser les paramtres du navigateur) :


A*%%WB 12 FLD 3 <type_hyperlien> <dtails_hyperlien>

Exemple :
A*%%WB 12 FLD 3 http://www.ibm.fr| 1

Aller l'URL Si vous souhaitez afficher une URL spcifique dans une zone, slectionnez l'option Aller l'URL. La valeur qui apparatra dans votre zone correspondra au texte affich comme hyperlien. L'emplacement charg par le navigateur lorsqu'un utilisateur clique sur le lien correspond la valeur entre dans la zone URL. Si vous souhaitez que le lien lance une autre fentre de navigateur lorsque l'on clique dessus, entrez le nom de la fentre en question dans la zone Cible. Si vous laissez la zone Cible vide ou si vous tapez la chane *SAME, le programme ouvrira le lien dans la fentre de navigation active. Si vous utilisez un projet de type portlet WebFacing, vous pouvez indiquer *PORTLET dans la zone Cible pour ouvrir le lien dans le portlet. Si le fichier DDS comprend une valeur de zone que vous souhaitez intgrer l'URL, cliquez sur le bouton associ la zone URL et choisissez l'enregistrement, la zone et l'attribut de votre choix. Par

74

Dveloppement des applications WebFacing

exemple, vous pouvez utiliser la valeur de zone Insrer pour construire l'URL si vous souhaitez ajouter des paramtres l'URL http://monsite.com/monapplicationweb/servlet/MonServlet et si le servlet attend des arguments pour les variables parm1 et parm2. Dans cet exemple, l'URL finale ressemblera http://monsite.com/ monapplicationweb/servlet/MonServlet?parm1= &{FIELD1.INITIALVALUE}&parm2=&{FIELD2.INITIALVALUE} o &{FIELD1.INITIALVALUE} et &{FIELD2.INITIALVALUE} reprsentent les paramtres que vous avez ajouts et qui seront remplacs au stade de l'excution. Remarque : Si vous souhaitez utiliser une valeur de zone d'un format d'enregistrement diffrent au sein de l'URL de la zone hyperlien, assurez-vous que la zone est disponible sur la page Web o s'affiche l'hyperlien. Les zones de formats d'enregistrement diffrents peuvent tre identifies dans la bote de dialogue Insrer l'attribut de zone car elles contiennent le nom du format d'enregistrement (&{RECORD2.FIELD1.INITIALVALUE}, par exemple). Si aucun des deux formats d'enregistrement n'est disponible sur la page Web quand l'hyperlien est affich, une erreur apparatra lorsque l'hyperlien sera slectionn. Pour savoir comment utiliser les variables de remplacement de zone, voir Dfinition des variables de remplacement de zone, la page 80. Syntaxe :
A*%%WB 12 FLD 3 <url>"|"<cible>

Syntaxe obsolte :
A*%%WB 12 FLD 1 <url>"|"<cible>

Exemple :
A*%%WB 12 FLD 3 http://serveur/chemin?p2=&{FIELD2.INITIALVALUE}&p1=&{FIELD1.INITIALVALUE+ A*%%WB +}&p3=&{FIELD1.INITIALVALUE}

Syntaxe obsolte :
A*%%WB 12 FLD 1 http://serveur/chemin?p2=&{FIELD2}&p1=&{FIELD1}&p3=&{FIELD1}

Effectuer les actions Le paramtre Effectuer les actions permet de crer un lien, qui place le curseur sur une zone, effectue un envoi et/ou les deux la fois ds qu'un utilisateur clique dessus. Les options Placer le curseur sur la zone et Plus d'actions ont pour valeur celle que vous indiquez. Placer le curseur sur la zone Lorsque vous cliquez sur le lien, la valeur d'excution de l'emplacement du curseur renvoye l'application correspond l'emplacement de la zone que vous indiquez ici. Vous pouvez slectionner une zone dans la liste droulante ou entrer directement un nom pour cette zone. Si vous ne slectionnez pas Placer le curseur sur la zone, le curseur est positionn sur la dernire zone slectionne par l'utilisateur. Cette valeur du curseur ne se rapporte pas au curseur tel qu'il s'affiche dans le navigateur mais la valeur de la phase d'excution de WebFacing pour l'emplacement du curseur en cours dans l'enregistrement DDS. Si vous souhaitez affecter une valeur la zone sur
Chapitre 6. Personnalisation de vos applications WebFacing

75

laquelle le curseur est plac, choisissez une zone ou cochez la case Dfinir la valeur de zone sur et tapez une valeur dans la zone de texte associe. Certains des paramtres acceptent des valeurs de zone en entre. Pour savoir comment utiliser les variables de remplacement de zone, voir Dfinition des variables de remplacement de zone, la page 80. Syntaxe :
A*%%WB 12 FLD 5 fld=<zone>"|"value=<valeur>

Plus d'actions Si vous cochez la case Plus d'actions, vous pouvez choisir une touche de fonction ou une action de soumission d'appel de fonction JavaScript que vous associerez l'hyperlien. Par exemple, vous pouvez choisir ENTREE ou DECONNEXION dans la liste droulante Touche de fonction de soumission ou une touche de fonction que vous aurez pralablement dfinie dans le fichier DDS. Si vous souhaitez utiliser une touche de fonction provenant d'un autre enregistrement DDS, entrez une valeur pour cette touche de fonction. Lorsqu'un utilisateur clique sur un lien que vous avez cr pour une touche de fonction, le programme excute cette fonction. Dans la zone d'appel de fonction JavaScript, vous pouvez entrer le nom d'une fonction JavaScript que vous souhaitez voir excuter lorsque l'on clique sur le lien. Il peut s'agir d'une fonction que vous avez entre l'aide du paramtre Web Appeler JavaScript, d'une fonction que vous avez dfinie dans un fichier externe JavaScript ou d'une fonction insre dans le fichier webface.js l'aide de WebFacing. Si vous crez vos propres fichiers JavaScript externes, mettez-les dans le rpertoire "usr" de votre projet WebFacing. Ce rpertoire est situ dans le chemin d'accs <nom_projet>\ WebContent\ClientScript\usr. Tout script plac dans ce rpertoire est disponible pour votre application WebFacing lors de la phase d'excution. Vous pouvez mme associer les options Placer le curseur sur la zone et Touche de fonction de soumission. Cela vous permet de dfinir la valeur d'une zone spcifique et de la soumettre votre programme. Pour ce faire, cochez la case Placer le curseur sur la zone, choisissez une zone dans la liste droulante (ou tapez une zone), cochez la case Plus d'actions, slectionnez le bouton d'option Touche de fonction de soumission et choisissez ENTREE dans la liste droulante. Pour connatre le format d'entre des zones Placer le curseur sur la zone et Touche de fonction de soumission, consultez la section Placer le curseur sur la zone du prsent document. Syntaxe :
A*%%WB 12 FLD 4 fld=<zone>"|"value=<valeur>"|"func=<touche_fonction>

Syntaxe obsolte :
A*%%WB 12 FLD 2 fld=<zone>"|"value=<valeur>

76

Dveloppement des applications WebFacing

Exemple :
A*%%WB 12 FLD 4 fld=&{FIELD3.REF}|value=1|func=ENTER

Syntaxe obsolte :
A*%%WB 12 FLD 2 fld=FIELD3|value=1

Appeler JavaScript Entrez le nom d'une fonction JavaScript que vous souhaitez voir appeler lorsque vous cliquez sur le lien. Par exemple, entrez maFonction(). Il peut s'agir d'une fonction que vous avez entre l'aide du paramtre Web Insertion de script, d'une fonction que vous avez dfinie dans un fichier externe JavaScript ou d'une fonction insre dans le fichier webface.js l'aide de WebFacing. Si vous crez vos propres fichiers JavaScript externes, mettez-les dans le rpertoire "usr" de votre projet WebFacing. Ce rpertoire est situ dans le chemin d'accs <nom_projet>\WebContent\ ClientScript\usr. Tout script plac dans ce rpertoire est disponible pour votre application WebFacing lors de la phase d'excution. Si vous possdez une fonction JavaScript interne courte, vous pouvez galement entrer la fonction entire dans la zone Appeler JavaScript. Syntaxe (option Touche de fonction de soumission) :
A*%%WB 12 FLD 6 <touche_fonction>

Syntaxe (option Appeler JavaScript) :


A*%%WB 12 FLD 7 <javascript>

Syntaxe (Placer le curseur sur une zone de donnes spcifique et soumettre JavaScript) :
A*%%WB 12 FLD 8 fld=<zone>"|"value=<valeur>"|"func=<javascript>

Syntaxe (option Hyperlien JavaScript):


A*%%WB 12 FLD 9 <javascript>

Remarque : L'option Hyperlien JavaScript est obsolte et a t remplace par l'option Appeler JavaScript. Image Utilisez le paramtre Image si vous souhaitez afficher une image la place de la zone. Ce paramtre peut tre utilis par exemple pour prsenter une base de donnes de produits, avec des images des articles en stock. Compltez la zone Nom de fichier en indiquant le chemin d'accs complet un fichier image situ sur votre poste de travail ou l'adresse URL complte d'un fichier image (par exemple, http://www.ibm.com/ image.gif). La zone Nom de fichier peut tre remplie en entrant directement une valeur ou en utilisant le bouton Parcourir pour trouver un fichier local. Les images locales que vous spcifiez seront copies dans le rpertoire ..\Contenu Web\images\generated de votre projet WebFacing lors de la conversion WebFacing. Les images contenues dans ce rpertoire sont ensuite publies sur le serveur lorsque vous dployez votre projet l'aide de l'assistant d'exportation.

Chapitre 6. Personnalisation de vos applications WebFacing

77

Vous pouvez utiliser les options Largeur et Hauteur si vous connaissez les dimensions d'une image. L'ajout d'informations sur la largeur et la hauteur peut parfois acclrer la restitution des pages Web qui contiennent des images. La zone Texte secondaire permet d'indiquer le texte secondaire de l'image. Si le programme contient des zones qui renvoient des valeurs pouvant appartenir au nom du fichier image ou l'adresse URL complte d'un fichier image, vous pouvez ajouter les valeurs la zone Nom de fichier en cliquant sur le bouton Insrer l'attribut de zone et en slectionnant une zone dans la zone Zone. Par exemple, dans le cas de &{FIELD.INITIALVALUE} qui renvoie la valeur bicyclette1, vous pouvez dsigner une image bicyclette1.gif. Dans cet exemple, commencez par slectionner le bouton d'option Dynamique et compltez la zone Nom de fichier en cliquant sur le bouton Insrer l'attribut de zone et en rajoutant l'extension .gif. Les fichiers que vous identifiez en utilisant un attribut de zone doivent tre copis manuellement dans le rpertoire ..\Contenu Web\images\generated\. Remarque : Le seul attribut de zone autoris pour ce paramtre Web est Valeur initiale. Les images doivent en effet tre entirement rsolues la premire fois qu'une page Web est charge. Pour savoir comment utiliser les variables de remplacement de zone, voir Dfinition des variables de remplacement de zone, la page 80. Syntaxe :
A*%%WB 13 FLD 1 <largeur>"|"<hauteur>"|"<graphique>"|"<texte secondaire>

Syntaxe obsolte :
A*%%WB 13 FLD <largeur>"|"<hauteur>"|"<graphique>

Exemple :
A*%%WB 13 FLD 1 15|34|graphic.gif A*%%WB 13 FLD 1 15|34|graphic.gif|IBM logo A*%%WB 13 FLD 1 3|2|&{FIELD1.INITIALVALUE}.gif

Syntaxe obsolte :
A*%%WB 13 FLD 15|34|graphic.gif A*%%WB 13 FLD 3|2|&{FIELD1}.gif

Emplacement Les options disponibles pour le paramtre Emplacement sont Changer la plage et Changer la position. Une fois que votre source DDS est converti l'aide de l'outil WebFacing, votre application est positionne sur une page Web l'aide d'une table HTML. La table HTML comporte le mme nombre de lignes et de colonnes que l'cran DDS -- 24 par 80 ou 27 par 132. A l'aide des paramtres Emplacement, vous pouvez modifier la manire dont les zones seront positionnes dans la table HTML aprs la conversion du source. v Changer la position vous permet d'indiquer la ligne et la colonne de la table HTML correspondant la position de dbut de votre zone. v Changer la plage vous permet d'indiquer le nombre de lignes et de colonnes qui seront attribues votre zone dans la table HTML. Il est possible d'utiliser l'option Changer la plage pour remplacer les valeurs de texte initialement utilises par votre programme pour remplir la zone

78

Dveloppement des applications WebFacing

par une illustration. Par exemple, 7 colonnes taient peut-tre ncessaires pour le texte de la zone dans le programme initial, alors que l'illustration propose n'utilise que 2 colonnes. La fentre de l'diteur illustre la prsentation des lignes et des colonnes du source DDS. Elle vous donne une ide de la manire dont les zones seront places les unes par rapport aux autres si vous apportez des modifications l'aide des options Changer la position et Changer l'tendue. L'option supplmentaire pour le paramtre Emplacement est Position CSS. Le paramtre de positionnement de la feuille de style en cascade vous permet de placer des zones n'importe quel endroit de la page Web, sans restrictions. v Le paramtre Ligne vous permet de prciser la valeur de ligne de la zone. Vous devez indiquer un entier positif suprieur ou gal 1. v Le paramtre Colonne vous permet de prciser la valeur de colonne de la zone. Vous devez indiquer un entier positif suprieur ou gal 1. v Le paramtre Dcalage vous permet de prciser le nombre de pixels d'ajustement de la zone, en fonction de la valeur de ligne ou de colonne. Vous pouvez indiquer 0 ou un nombre entier positif ou ngatif. v L'option Dsactiver la tabulation vous permet d'indiquer si la zone est accessible par tabulation une fois qu'elle a t dplace. Si vous slectionnez cette option, l'utilisateur ne pourra pas atteindre la zone via une tabulation. Sinon, la zone demeure dans le mme ordre de tabulation qu'avant son dplacement. Syntaxe (option Changer la position) :
A*%%WB 2 FLD <numro_ligne> <numro_colonne>

Syntaxe (option Changer l'tendue) :


A*%%WB 15 FLD <numro_ligne> <numro_colonne>

Syntaxe (option Position CSS) :


A*%%WB 21 FLD <numro_ligne> +/-<dcalage_pixels> | <numro_colonne> +/-<dcalage_pixels> | <dsactiver_la_tabulation>

Remarque : Le dcalage en pixels doit tre prcd du signe + ou -. La valeur de dsactiver_tabulation doit tre true ou false. Exemple (option Changer la position) :
A*%%WB 2 FLD 14 3

Exemple (option Changer l'tendue) :


A*%%WB 15 FLD 1 1

Exemple (option Position CSS) : Pour dplacer une zone d'entre jusqu' la ligne 30, colonne 20 (sans aucun dcalage, ni pour l'une ni pour l'autre) et autoriser la tabulation :
A*%%WB 21 FLD 30 +0 | 20 +0 | false

Pour dsactiver la tabulation et dplacer une zone d'entre jusqu' la ligne 40, colonne 10, en incluant un dcalage de 20 pixels vers le bas et de 5 pixels vers la gauche (respectivement) :
A*%%WB 21 FLD 40 +20 | 10 -5 | true

Libells des options


Chapitre 6. Personnalisation de vos applications WebFacing

79

Le paramtre Libells des options est disponible pour les zones d'entre qui comprennent le mot cl VALUES. Ces zones s'affichent dans les pages Web sous la forme d'une srie de boutons d'option. Les options affiches dans la zone de slection sont les valeurs fournies comme paramtres pour le mot cl VALUES dans votre source DDS. Ce paramtre Web permet de modifier le libell ou le texte prsent l'utilisateur. Par exemple, si l'un des paramtres VALUES attendu par votre programme est "article8", vous pouvez entrer un texte plus descriptif pour l'affichage dans un navigateur, par exemple "cble calibre 8". Le texte affich pour l'utilisateur sera "cble calibre 8" mais la valeur renvoye votre programme restera la valeur "article8" attendue par celui-ci. Pour utiliser ce paramtre Web, cliquez deux fois sur la zone Intitul de l'option et tapez le texte de votre choix. Syntaxe :
A*%%WB 14 FLD <valeur>=<libell>["|"<valeur2>=<libell2>["|"<valeur3>=<libell3>[...]]]

Exemple : Avec des valeurs numriques :


A*%%WB 14 FLD 0=valeur 0|1=valeur 1

Avec des valeurs de texte :


A*%%WB 14 FLD valeur0=valeur 0|valeur1=valeur 1

Envoi au navigateur Le paramtre Envoi au navigateur peut tre utilis pour les zones DDS H ou masques. Ce paramtre modifie les fichiers JSP pour vos enregistrements. Par exemple, si vous avez une zone H appele LISTCTL, alors que ce paramtre est utilis, un lment de type formulaire d'entre HTML sera gnr dans le fichier JSP appel LISTCTL.jsp. Les lments masqus de type formulaire d'entre commencent par le code HTML suivant : <INPUT TYPE="hidden". L'utilisation du paramtre Envoi au navigateur permet une zone H de faire partie de l'environnement du navigateur et aux valeurs d'tre affectes cette zone sur la base de cet environnement. Par exemple, l'adresse IP d'un utilisateur dtermine par un script ajout avec le paramtre Insrer dans le script peut servir renseigner la zone masque. Syntaxe :
A*%%WB 19 FLD

Exemple :
A*%%WB 19 FLD

Dfinition des variables de remplacement de zone


Les paramtres Web Insertion de HTML, Langage HTML dfini par l'utilisateur, Image, Insertion de script, Aller l'URL, Placer le curseur sur la zone et Appeler JavaScript acceptent les variables de remplacement de zone. La liste suivante dtaille les variables de remplacement de zone possibles, notamment les variables obsoltes (mais toujours prises en charge) ventuelles : &{FIELD.CURRENTVALUE} Cette variable reprsente la valeur courante de l'objet zone HTML d'une zone d'entre figurant dans l'enregistrement courant, qui peut tre modifie

80

Dveloppement des applications WebFacing

par l'utilisateur dans le navigateur ou qui est masque tout en utilisant malgr tout le paramtre Web Envoi au navigateur. La variable obsolte est &{FIELD.value}. &{FIELD.INITIALVALUE} Cette variable reprsente la valeur initiale de l'excution WebFacing d'une zone d'entre ou de sortie figurant dans l'enregistrement courant. La variable obsolte est &{FIELD.value}. &{RECORD.FIELD.CURRENTVALUE} Cette variable reprsente la valeur courante de l'objet zone HTML d'une zone d'entre figurant dans l'enregistrement spcifi, qui peut tre modifie par l'utilisateur dans le navigateur. La variable obsolte est &{RECORD.FIELD.value}. &{RECORD.FIELD.INITIALVALUE} Cette variable reprsente la valeur initiale de l'excution WebFacing d'une zone d'entre ou de sortie figurant dans l'enregistrement prcis. La variable obsolte est &{RECORD.FIELD.value}. &{FIELD.REF} Cette variable reprsente une rfrence un objet zone HTML (document.SCREEN.l1_REC1$FIELD1, par exemple). Elle concerne uniquement les zones d'entre ou les zones qui sont masques mais qui utilisent malgr tout le paramtre Web Envoi au navigateur. Dans le cas des zones de sortie uniquement, utilisez la variable &{FIELD.ID}. La variable obsolte est &{FIELD}. &{FIELD.ID} Cette variable reprsente un ID zone HTML (l1_REC1$FIELD1, par exemple). Elle concerne les zones d'entre et de sortie. La variable obsolte est &{FIELD}. &{RECORD.FIELD.REF} Cette variable reprsente une rfrence un objet zone HTML figurant dans l'enregistrement prcis. Elle concerne uniquement les zones d'entre. Dans le cas des zones de sortie uniquement, utilisez la variable &{RECORD.FIELD.ID}. La variable obsolte est &{RECORD.FIELD}. &{RECORD.FIELD.ID} Cette variable reprsente un ID zone HTML figurant dans l'enregistrement spcifi. Elle concerne les zones d'entre et de sortie. La variable obsolte est &{RECORD.FIELD}. &{WEBFACINGFORMID} Cette variable reprsente la valeur de l'attribut ID du formulaire HTML, qui regroupe toutes les zones. Elle peut tre utilise dans le cas du code JavaScript personnalis.

Utilisation de valeurs spciales


Vous pouvez utiliser des valeurs spciales lorsque vous insrez du code HTML dfini par l'utilisateur via le paramtre Web Dfini par l'utilisateur dans

Chapitre 6. Personnalisation de vos applications WebFacing

81

Substitutions HTML. Les valeurs suivantes peuvent tre utilises dans le contexte du paramtre Web Dfini par l'utilisateur sur les zones correspondantes dans votre spcification DDS : &{*SYSNAME} Cette valeur permet d'insrer le nom du systme sur lequel l'application s'excute. Elle ne concerne que la zone SYSNAME. La valeur obsolte tait &SystemName. &{*USER} Cette valeur permet d'insrer l'ID de l'utilisateur actuel. Elle ne concerne que la zone USER. La valeur obsolte tait &UserID. &{*DATE} Cette valeur permet d'insrer la date systme actuelle. Elle ne concerne que la zone DATE. La valeur obsolte tait &Date. &{*TIME} Cette valeur permet d'insrer l'heure actuelle du systme. Elle ne concerne que la zone TIME. La valeur obsolte tait &Time.

Remarques sur les paramtres Web


Les paramtres Web peuvent affecter le comportement de votre application Web, mais pas l'application 5250. La position, la taille et la visibilit d'une zone dans le navigateur Web peuvent tre modifies au moyen des paramtres Web. Ces modifications peuvent influencer la faon dont une zone chevauche d'autres zones, ainsi que la visibilit des zones. La modification de la taille ou de la position d'une zone peut galement augmenter la taille d'un enregistrement, ce qui peut alors affecter la visibilit des enregistrements dans le navigateur Web. Assurez-vous que vous avez bien conscience de ces risques ventuels quand vous utilisez les paramtres Web. Pour dterminer la visibilit des zones et des enregistrements dans un navigateur, WebFacing effectue d'abord les changements de position, de taille et de visibilit en utilisant les paramtres Web. La visibilit des zones et des enregistrements est ensuite dtermine au moyen de rgles identiques celles qui sont prsentes dans les manuels DDS Manual et Application Display Programming Guide. Pour plus d'informations sur la visibilit des zones se chevauchant, voir Keywords for Display Files > Positional Entries > Location dans le manuel DDS. Pour plus d'informations sur la visibilit des enregistrements se chevauchant, voir Keywords for Display Files > OVERLAY dans le manuel DDS et la section Writing Output to the Display du manuel Application Display Programming Guide. Certains paramtres Web settings, tels que Hyperlien ou Substitutions HTML, vous permet d'ajouter des Javascript et HTML personnaliss. Si vous ajoutez un code l'un de ces paramtres Web, vrifiez que le code peut tre excut dans les navigateurs pris en charge. Pour plus de dtails sur les navigateurs pris en charge, voir Prise en charge WebFacing de plusieurs navigateurs, la page 110. Visibilit > Masquer la zone

82

Dveloppement des applications WebFacing

Lorsqu'une zone est masque au moyen des paramtres Web, elle ne chevauche plus les autres zones et la visibilit des zones dans le navigateur peut en tre modifie. Exemple A : FIELDA chevauche FIELDB, comme spcifi dans le source DDS. Sur l'cran 5250, FIELDB n'est pas visible. Si la zone FIELDA a t masque via les paramtres Web, elle ne chevauchera pas la zone FIELDB et celle-ci sera visible dans le navigateur. Emplacement > Modifier l'tendue, Modifier la position Ces paramtres Web modifient l'endroit de l'cran occup par une zone lors de l'affichage dans un navigateur. De ce fait, une zone peut tre amene chevaucher une autre zone. Il peut galement arriver qu'une zone ne chevauche plus les zones qu'elle chevauchait prcdemment. Dans tous les cas, la visibilit des zones dans un navigateur peut tre affecte. Exemple B : Comme spcifi dans le source DDS, FIELDA et FIELDB sont deux zones qui ne se chevauchent pas. Ces deux zones sont visibles sur l'cran 5250. La position de FIELDA dans Paramtres Web est configure de sorte que FIELDA chevauche FIELDB. Dans le navigateur Web, FIELDB n'est plus visible. La modification de l'tendue et de la position d'une zone au moyen des paramtres Web peut galement augmenter le nombre de lignes de l'cran occupes par l'enregistrement. Le chevauchement des enregistrements dans un navigateur peut alors tre affect, ce qui modifie la visibilit des enregistrements. Exemple C : Dans le source DDS, FIELDA est une zone occupant la ligne 13 de RECORD1. RECORD1 occupe les lignes 2 15 de l'cran. Un autre enregistrement, RECORD2, occupe les lignes 16 23 de l'cran DDS. Pour les deux enregistrements RECORD1 et RECORD2, le mot cl OVERLAY est spcifi. FIELDA est dplace la ligne 18 l'aide du paramtre Web position. Maintenant, dans le navigateur Web, RECORD1 occupe les lignes 2 18. L'application affiche RECORD1 puis RECORD2 l'cran. Sur l'cran 5250, les deux enregistrements seraient visibles. Dans le navigateur Web, RECORD1 disparat de l'cran car il est recouvert par RECORD2. Apparence et texte > Remplacer texte constant, Masquer les caractres Le remplacement du texte constant au moyen des paramtres Web peut modifier la longueur de la constante texte. Aussi, spcifier Masquer les caractres dans Paramtres Web peut raccourcir une constante texte. Dans les deux cas, le chevauchement des autres zones dans un navigateur peut tre affect. La visibilit des zones peut alors tre modifie dans le navigateur. Exemple D : Une constante texte de longueur 10 est spcifie dans la DDS. Les 5 derniers caractres du texte chevauchent FIELDA. Sur l'cran 5250, FIELDA n'est pas visible parce qu'elle est recouverte. Le texte constant est remplac au moyen des paramtres Web de sorte que sa longueur soit de 5. Dans un navigateur, FIELDA n'est plus recouverte par la constante texte et est nouveau visible. La dsactivation du texte constant au moyen des paramtres Web peut galement augmenter le nombres de lignes de l'cran occupes par l'enregistrement. Le chevauchement des enregistrements dans un navigateur peut alors tre affect, ce qui modifie la visibilit des enregistrements. Les consquences d'une telle situation peuvent tre observes dans l'exemple C.
Chapitre 6. Personnalisation de vos applications WebFacing

83

Paramtres Web non pris en compte Les paramtres Web (en particulier le remplacement des constantes texte et le changement de l'tendue et de la position) sont ignors s'ils risquent de provoquer l'une des situations suivantes dans le navigateur : v Une zone risque d'tre situe au-del des limites de l'cran. v Une zone qui s'tend sur plus d'une ligne ou qui est situe sur la dernire ligne de l'cran risque de s'tendre au-del des limites de l'cran. v Une zone de contrle de sous-fichier risque de chevaucher la zone cran du sous-fichier associ. v Le nombre de lignes occupes par un enregistrement de sous-fichier risque d'tre plus grand que dans l'cran 5250. v La largeur d'un sous-fichier horizontal risque d'tre plus grande que dans l'cran 5250. Paramtres Web multiples du mme type Si plusieurs paramtres Web du mme type sont indiqus dans une zone, un enregistrement ou un fichier unique, alors le comportement n'est pas dfini. En d'autres termes, il est impossible de savoir quel paramtre Web sera appliqu.

Cration de fichiers de bibliothque JavaScript personnaliss


Cette rubrique vous explique comment inclure vos propres bibliothques JavaScript dans une application WebFacing. Vous pouvez tre amen crer vos propres bibliothques JavaScript lorsque vous personnalisez une application WebFacing. Pour que votre fichier JavaScript soit publi dans votre application WebFacing, vous devez le crer dans le rpertoire usr. Pour localiser le rpertoire usr lorsque vous visualisez le projet WebFacing, ouvrez la vue Navigateur, dveloppez le projet et les dossiers WebContent > webfacing > ClientScript > usr. Placez le fichier contenant votre bibliothque JavaScript (fichier .js) dans le rpertoire usr. Les fichiers contenus dans ce rpertoire seront dsigns comme fichiers inclus dans les pages envoyes au navigateur par votre application WebFacing. La liste des fichiers contenus dans le rpertoire usr est dtermine une seule fois lors du lancement de l'application WebFacing. Cela signifie que les fichiers ajouts ou supprims du rpertoire aprs le lancement de cette dernire ne sont pas pris en compte dans la liste des fichiers figurant sur chaque page. De plus, pour plusieurs fichiers, aucun ordre fixe n'est appliqu aux inclusions gnres. Vous pouvez vous assurer que votre bibliothque JavaScript est incluse en implmentant la fonction init_usr(). Une application WebFacing effectue un appel vers init_usr() aprs avoir achev son traitement du temps de chargement. Pour utiliser cet appel, ajoutez une fonction init_usr() votre fichier de bibliothque JavaScript. Par exemple, si vous ajoutez les lignes suivantes votre fichier .js, une alerte s'affichera lorsqu'un utilisateur accdera l'application WebFacing.
function init_usr() { alert("init_usr() called"); }

84

Dveloppement des applications WebFacing

Accessibilit de WebFacing
L'outil IBM WebFacing fournit l'accessibilit l'application WebFacing qui permet de lever les obstacles auxquels sont confronts certains utilisateurs lors de l'accs vos applications. L'outil WebFacing a cela d'unique qu'il convertit automatiquement une application hte 5250 d'origine en application Web et l'accessibilit de cette dernire est limite par les informations disponibles dans le DDS au moment de la conversion. Ces informations sont le plus souvent insuffisantes, ce qui oblige le dveloppeur WebFacing apporter des modifications supplmentaires une fois la conversion termine afin d'amliorer l'accessibilit de l'application. Le prsent document dcrit les diffrents secteurs que le dveloppeur doit analyser et modifier le cas chant pour rendre l'application plus accessible. Remarque : Etudiez vos personnalisations en cours du point de vue de l'accessibilit et utilisez les prsentes mthodes ou d'autres techniques adaptes. Pour une liste complte des questions relatives l'accessibilit Web, voir Rubriques connexes. v Images Un utilisateur mal-voyant qui accde votre application par le biais d'une technologie d'assistance (AT), telle qu'un lecteur d'cran, doit pouvoir s'appuyer sur un texte secondaire pour donner un sens aux images ou aux graphiques. La zone Texte secondaire a t ajoute au paramtre Web Image de WebFacing pour vous permettre de spcifier ce texte facilement.

Remarque : Si aucun texte secondaire n'est indiqu, la valeur contenue dans la zone est utilise. Pour obtenir des instructions sur la manire de spcifier correctement un texte secondaire, voir la section Rubriques connexes ci-dessous. v Structures Pour que la navigation, l'interprtation et la livraison du contenu soient possibles par le biais des technologies d'assistance, le marquage de l'application doit tre porteur de sens. L'utilisation d'un marquage structurel (plutt que descriptif) prserve la signification smantique pour les utilisateurs n'ayant pas accs un navigateur visuel. Par exemple, dans le langage HTML, les lments <h1> <h5> permettent d'identifier les en-ttes. Etant donn qu'il n'existe pas d'quivalent de ce type dans la construction DDS, la conversion WebFacing ne peut pas dterminer si des zones ou des constantes sont ou non des en-ttes.

Chapitre 6. Personnalisation de vos applications WebFacing

85

Un en-tte tel que Parts Order Entry apparat clairement comme tel lorsqu'il est visualis par un utilisateur sans troubles de la vision. En revanche, cela n'est pas visible pour les utilisateurs ayant recours un lecteur d'cran par exemple.

Le problme est le mme pour le moteur de conversion WebFacing. Vous pouvez cependant utiliser le paramtre Web Substitutions HTML pour insrer des balises d'en-tte de part et d'autre de la zone : 1. Ouvrez le DDS et recherchez le texte identifier comme tant un en-tte. 2. Dans la vue Paramtres Web, slectionnez la catgorie Substitutions HTML puis cochez la case Remplacer le HTML gnr et slectionnez le bouton d'option Insrer. 3. Slectionnez l'onglet Avant et insrez <h3 style="display:inline;">. 4. Basculez ensuite vers l'onglet Aprs et entrez </h3> pour fermer la balise. 5. Enregistrez et convertissez nouveau le DDS. Des techniques similaires peuvent tre utilises pour amliorer l'accessibilit en apportant des modifications pour les listes, les en-ttes de tableau et les guillemets, par exemple. Pour plus de dtails sur la modification du marquage structurel dans une application Web, voir la section Rubriques connexes. v Formulaires Lorsqu'une zone de formulaire doit tre traite par les technologies d'assistance, il est important que le contexte et la description soient disponibles pour que l'utilisateur puisse en connatre le sens. Il est recommand pour cela d'associer les zones leur texte descriptif l'aide de l'lment <label>. Un tel mcanisme n'existe pas dans une application 5250 originale. Les seules indications disponibles sont de type visuel, comme par exemple le positionnement des zones les unes par rapport aux autres.

Le moteur de conversion WebFacing ne peut donc pas crer automatiquement des associations smantiques de ce type dans l'application Web gnre. Les modifications pour l'accessibilit doivent tre apportes par le dveloppeur WebFacing avant le dploiement.

86

Dveloppement des applications WebFacing

Pour dfinir une chane de texte en tant que libell d'une zone de formulaire, utilisez l'lment HTML <label>. La syntaxe gnrale utilise est la suivante :
<form [...] > <label for="inputID" [...] >description</label> <input id="inputID" [...] /> </form>

Dans le cadre de l'application prsente ci-dessus, vous souhaitez indiquer que Customer number est le libell de la zone d'entre situe sa droite. 1. Ouvrez le DDS et recherchez la zone utiliser comme libell. 2. Dans la vue Paramtres Web, slectionnez la catgorie Substitutions HTML, puis cochez la case Remplacer le HTML gnr et slectionnez le bouton d'option Insrer. 3. Slectionnez l'onglet Avant, entrez <label for=""> et placez le curseur entre les guillemets. 4. Cliquez sur le bouton Insrer l'attribut de zone et slectionnez l'identificateur de la zone dont vous voulez indiquer le libell. 5. Cliquez sur Insrer. Le paramtre Web doit tre maintenant au format suivant :
<label for="&{FMT01.CUSTNO.ID}">

6. Basculez ensuite vers l'onglet Aprs et entrez </label> pour fermer la balise. 7. Enregistrez et convertissez nouveau le DDS. Remarque : Il est possible de dfinir plusieurs libells pour une seule zone de formulaire. Dans l'exemple prcdent, la chane F4 for list est un libell supplmentaire possible. v Langue WebFacing Version 7.5 apporte des modifications la requte dynamique et utilise la langue utilise par un travail lors de l'excution sur les serveurs pris en charge. Ce processus exigeant que le travail soit lanc, les informations de langue ne sont pas disponibles avant le lancement dans les pages d'index ou de connexion de l'application ; la langue par dfaut est donc l'anglais. Pour indiquer une langue diffrente dans la page d'index, ouvrez le fichier index.jsp et ajoutez l'attribut lang associ au code de langue appropri la balise <html>, par exemple :
<HTML lang="en">

La mme technique peut tre utilise pour le fichier logon.jsp de la page. Remarque : si votre application inclut des pages qui contiennent plusieurs langues dans le mme cran, vous pouvez utiliser l'attribut lang dans d'autres balises pour identifier la langue. Il convient pour cela d'utiliser le paramtre Web Substitution HTML en slectionnant l'option Insrer et en spcifiant lang=<codage>" dans l'onglet A l'intrieur de. v Tableaux Lorsque vous utilisez un tableau pour afficher les donnes, les relations entre les en-ttes et les lignes ou colonnes peuvent tre assez complexes, ce qui complique la livraison du contenu par le biais des technologies d'assistance. Des modifications apportes par un dveloppeur WebFacing peuvent amliorer l'accessibilit des tableaux dans les applications comme indiqu ci-dessous. L'explicitation des tableaux de donnes est une tche particulirement ardue si l'on ne sait pas comment celles-ci sont organises. L'utilisation du marquage pour identifier les en-ttes des lignes et des colonnes facilite la livraison du contenu de manire comprhensible par le biais des technologies d'assistance.
Chapitre 6. Personnalisation de vos applications WebFacing

87

Pour identifier une cellule de tableau en tant qu'en-tte de colonne ou de ligne, utilisez la balise d'en-tte de tableau, <TH>, en association avec l'attribut scope. Voici un exemple indiquant comment modifier un sous-fichier de cette manire : 1. Ouvrez le fichier JSP appropri (dans le prsent exemple, le fichier JSP ayant t gnr pour l'enregistrement de contrle du sous-fichier). 2. Dans le fichier JSP, recherchez les balises d'en-tte de tableau (indiques par <TD>).

3. Remplacez la balise ouvrante <TD> et la balise fermante </TD> par <TH> et </TH> respectivement.

4. Ajoutez l'attribut scope=col chaque instance.

Remarque : Une valeur scope=row correspondante peut tre utilise s'il existe des en-ttes horizontaux. Ces deux valeurs peuvent tre utilises dans le mme tableau. Lorsque vous remplacez le marquage <TD> par <TH> dans une cellule, vous pouvez constater que le texte est centr ou plac en gras, selon les styles dj appliqus. En testant vos modifications, vous pourrez dterminer rapidement si d'autres modifications sont ncessaires. v Messages d'erreur Pour autoriser l'accs aux messages d'erreur l'aide d'un lecteur d'cran, vous pouvez utiliser une touche de raccourci pour les en-ttes. Le message d'erreur sera lu lors de la lecture suivante de l'ensemble de la page.

88

Dveloppement des applications WebFacing

v Fentres Pour qu'une fentre soit lue par le biais d'une technologie d'assistance au moment o elle s'affiche, un mot cl WDWTITLE doit tre spcifi avec le texte du titre appropri dans l'enregistrement WINDOW. Pour une liste plus complte et dtaille des questions relatives l'accessibilit Web, voir les rubriques connexes ci-dessous. Information associe IBM Web accessibility IBM Web Accessibility Checklist, W3C Web Content Accessibility Guidelines (WCAG) and US Section 508 IBM Human Ability and Accessibility Center Guidelines, references and resources on Web accessibility W3C Web Content Accessibility Guidelines 2.0 W3C Techniques for WCAG 2.0

Interfaces utilisateur bidirectionnelles dans WebFacing


WebFacing permet de conserver la prise en charge bidirectionnelle d'une application 5250 lorsqu'elle est convertie pour le Web. Les systmes informatiques peuvent traiter le texte et les lments des interfaces utilisateur de la gauche vers la droite (comme en franais) ou de la droite vers la gauche. Les logiciels qui prennent en charge ces deux cas sont dits bidirectionnels. La plupart des applications 5250 sont dj bidirectionnelles. Leur conversion ncessite donc l'excution de plusieurs tapes spcifiques pour que le processus WebFacing interprte correctement le sens des crans d'entre. Remarque : La prise en charge bidirectionnelle de WebFacing n'est pas disponible avec le navigateur Firefox.

Considrations bidirectionnelles
Vous trouverez ci-aprs plusieurs exemples d'lments qui changent selon le sens : v affichage de texte bidirectionnel v position relative d'lments HTML, notamment les colonnes des tableaux v ordre des indices de tabulation pour contrler le curseur dans l'interface utilisateur (passage d'une commande la suivante) v progression du curseur dans une zone v position de la barre de dfilement ou des boutons d'aide par rapport la commande qu'ils contrlent Les technologies Web comme les langages HTML et XHTML prennent en charge les lments bidirectionnels grce l'attribut de direction de base dir qui peut avoir la valeur ltr (de gauche droite) ou rtl (de droite gauche). Cet attribut peut tre ajout plusieurs balises. Son influence dpend du type de commande. Les lments enfant l'hritent de leur lment parent. Par exemple, pour dfinir la direction de base du texte dans tout le document HTML de la droite vers la gauche, vous devez ajouter l'attribut suivant la balise <html> : <html dir="rtl">.

Chapitre 6. Personnalisation de vos applications WebFacing

89

Dans DDS, trois mots cls contrlent ce type de comportement : v DSPRL : inversion symtrique de l'affichage des crans pour qu'ils se lisent de la droite vers la gauche. v CHECK(RLTB) : traitement des zones de la droite vers la gauche et de haut en bas. v CHECK(RL) : progression du curseur de la droite vers la gauche dans une zone. L'outil WebFacing applique un ensemble unique de rgles pour la conversion et l'activation d'interfaces utilisateur bidirectionnelles. Les principes fondamentaux sont les suivants : v Le mot cl DSPRL (rarement utilis) n'est pas pris en charge. La direction de la page HTML WebFacing est toujours de la gauche vers la droite. v Si le mot cl CHECK(RLTB) est indiqu, WebFacing attribue les valeurs des indices de tabulation selon une grille (voir ci-aprs). v L'attribut dir="rtl" est affect la sortie HTML de toutes les zones pour lesquelles le mot cl CHECK(RL) tait indiqu.

Grille de prsentation des indices de tabulation


Un indice de tabulation peut tre attribu aux commandes accessibles via la touche de tabulation (comme les zones et les liens hypertexte). La plupart des navigateurs utilisent un ordre d'indices de tabulation par dfaut qui traite toutes les commandes accessibles via la touche de tabulation de la gauche vers la droite et de haut en bas. Si le mot cl CHECK(RLTB) est utilis sur les crans 5250, WebFacing attribue un indice de tabulation pour implmenter correctement l'ordre droite-gauche sur une page HTML gauche-droite. Ces indices de tabulation sont attribus l'aide de la position de ligne et de colonne DDS. Pour laisser l'utilisateur la possibilit de dplacer des zones en dehors de leurs positions DDS, limites 27 lignes et 132 colonnes au maximum, WebFacing utilise une grille de 132 lignes et 250 colonnes. (La valeur maximale de l'attribut tabindex est 32767.)

Vous devez comprendre cette grille d'indices de tabulation dans les circonstances suivantes : v ajout de vos propres commandes accessibles via la touche de tabulation par des paramtres Web ou par modification directe des fichiers JSP WebFacing v utilisation de CSS-P pour dplacer une commande accessible via la touche de tabulation suffisamment pour modifier sa position relative dans l'ordre des indices de tabulation Dans le cas de nouvelles commandes accessibles via la touche de tabulation ajoutes par des paramtres Web, vous pouvez utiliser la variable de substitution &{TABINDEX}. Elle permet de calculer l'ordre des indices de tabulation appropri pour votre commande au moment de la conversion.

90

Dveloppement des applications WebFacing

Limitations des paramtres Web


Remarque : Pour en savoir plus sur les autres limitations, voir la note technique Limitations when Converting and Running BiDirectional Applications with WebFacing. La page de code EBCDIC Arabic 420 ne contient pas les caractres suivants :
\ { } [ ]

La variable de substitution des indices de tabulation n'est donc pas prise en charge pour les membres qui utilisent la page de code Arabic 420, de mme que d'autres constructions Javascript, notamment les tableaux, qui utilisent ces caractres. De plus, les caractres arabes deviennent illisibles car ils sont stocks au format logique dans le membre au format visuel. Tches associes Dfinition de l'ordre de tabulation pour les applications bidirectionnelles WebFacing attribue automatiquement un ordre d'indices de tabulation de la droite vers la gauche, mais si vous ajoutez de nouveaux lments, vous devez galement dfinir leur ordre de tabulation.

Dfinition de l'ordre de tabulation pour les applications bidirectionnelles


WebFacing attribue automatiquement un ordre d'indices de tabulation de la droite vers la gauche, mais si vous ajoutez de nouveaux lments, vous devez galement dfinir leur ordre de tabulation. Commencez avec une application 5250 qui utilise le mot cl CHECK(RLTB). Convertissez-la avec l'outil WebFacing. L'ordre de tabulation des pages Web rsultantes sera dfini de la droite vers la gauche pour les lments accessibles via la touche de tabulation (notamment les zones et les hyperliens). Cet ordre est bas sur une grille de 250 x 131. Si vous dplacez des lments avec les paramtres Web, l'indice de tabulation reflte la position personnalise. Vous pouvez ajouter vos propres lments, notamment des zones et des hyperliens. WebFacing gre les indices de tabulation des paramtres Web Hyperlien, mais si vous crez un hyperlien avec un autre paramtre Web (Insertion de HTML aprs marque, par exemple) ou n'importe quel autre lment accessible via la touche de tabulation, vous devez vous-mme ajouter l'indice de tabulation. Pour ajouter un indice de tabulation : Slectionnez Indice de tabulation de droite gauche dans la bote de dialogue Insrer l'attribut de zone.

Chapitre 6. Personnalisation de vos applications WebFacing

91

Le programme ajoute une variable de substitution votre source DDS pour tous les lments que vous avez ajouts :
&{TABINDEX}

Vous pouvez galement ajouter la variable de substitution &{TABINDEX} directement dans votre source DDS. Cette variable donne le numro appropri. Le code HTML pourrait tre le suivant :
<input tabindex="&{TABINDEX}"/>

Tenez compte des considrations suivantes : v Il est de votre responsabilit d'ajouter cette variable de substitution. v Cette variable est traite au moment de la conversion et ne fonctionne pas pour les modifications apportes au fichier JSP aprs la conversion. v Si vous ajoutez plusieurs lments HTML accessibles via la touche de tabulation sur la mme ligne et la mme colonne (par exemple, en utilisant le paramtre Web Insertion de HTML aprs marque pour ajouter un hyperlien aprs une zone), les deux lments se retrouvent avec le mme indice de tabulation. Les indices de tabulation en conflit sont lus de la gauche vers la droite puisqu'il s'agit de l'ordre du document. Concepts associs Interfaces utilisateur bidirectionnelles dans WebFacing, la page 89 WebFacing permet de conserver la prise en charge bidirectionnelle d'une application 5250 lorsqu'elle est convertie pour le Web.

Dveloppement de vos services WebFacing l'aide d'un diagramme Web


Les graphiques Web vous permettent de crer des services WebFacing l'aide d'un environnement de dveloppement visuel. Le moteur d'excution du contrleur Struts est actif par dfaut pendant la conversion WebFacing, vous pouvez par consquent tendre l'application pour qu'elle comprenne les services WebFacing bass Struts. Vous pouvez ensuite intgrer ces services votre application WebFacing l'aide des actions de touches de commande ou des hyperliens de zone. Vous pouvez visualiser l'objet suivant dans la vue Navigateur : v Projet WebFacing/Web Diagrams/WF Runtime/WFController.gph - Ce diagramme en lecture seule illustre la conception du contrleur Struts WebFacing.

92

Dveloppement des applications WebFacing

Pour crer votre premier diagramme Web au sein de votre projet WebFacing bas Struts : 1. Dans la vue Navigateur, dveloppez Projet WebFacing > Diagramme Web. 2. Cliquez avec le bouton droit de la souris sur le dossier Diagrammes Web et slectionnez Nouveau > Autre > Web > Diagramme Web. 3. Cliquez sur Suivant. 4. Indiquez le nom du nouveau diagramme (MonServiceWF, par exemple). 5. Cliquez sur Terminer pour crer le nouveau diagramme Web. Pour ajouter des objets au diagramme : 1. Cliquez avec le bouton droit de la souris n'importe o dans le diagramme et slectionnez Nouveau > Composants Web > Page Web pour crer une icne qui reprsente la nouvelle page JSP. 2. Affectez un nom au noeud de page Web en prcisant un chemin relatif au dossier WebContent du projet. Pour renommer un noeud, cliquez dessus avec le bouton droit de la souris et slectionnez Renommer. 3. Rptez les tapes 1 et 2 pour ajouter une autre page Web. 4. Cliquez avec le bouton droit de la souris sur le premier noeud de page Web, slectionnez Connexion, puis glissez votre curseur sur le deuxime noeud de page Web afin d'tablir une connexion visuelle entre ces deux noeuds. 5. Pour les deux noeuds de page Web, double-cliquez sur le noeud afin d'appeler un assistant. 6. Parcourez les tapes de l'assistant et cliquez sur Terminer pour crer ou pour raliser le noeud. Maintenant que vous connaissez les bases du dveloppement des diagrammes Web, vous pouvez commencer aller plus loin dans le dveloppement de votre application au sein de l'environnement visuel. Pour reprendre l'endroit o vous aviez commenc, vous pouvez galement dvelopper des mappages d'actions, des beans de formulaires, etc. Aprs avoir dvelopp des services, des fichiers JSP ou d'autres composants dans un diagramme Web, vous pouvez configurer les touches de commande de votre application WebFacing qui appellera un composant spcifique que vous aurez dvelopp l'aide du diagramme Web lorsque l'utilisateur cliquera dessus. Pour plus de dtails, voir Extension de votre application WebFacing l'aide des actions de touches de commande, la page 42.

Vrification de l'accs des utilisateurs l'application WebFacing


L'API d'environnement WebFacing vous permet de vrifier si un utilisateur accde votre application via un navigateur Web ou une mulation 5250. Cette API vous permet de changer le comportement de votre programme en fonction du type d'accs de l'utilisateur. Par exemple, vous souhaitez peut-tre afficher une zone supplmentaire ou un texte diffrent si l'accs au programme s'effectue via un navigateur, mais supprimer l'affichage de ces lments si une mulation 5250 est utilise. L'API d'environnement WebFacing est appele QqfEnvironment. Elle fait partie du module d'excution du serveur WebFacing. Le nom de procdure externe QqfEnvironment tient compte de la distinction majuscules/minuscules. C'est une procdure encapsule dans un programme de service appel QQFENV qui se
Chapitre 6. Personnalisation de vos applications WebFacing

93

trouve dans la bibliothque QSYS. L'API renvoie la valeur 1 si l'application s'excute sous WebFacing et la valeur 0 s'il s'agit d'une mulation 5250. Les exemples ci-aprs indiquent comment utiliser cette API. Dans l'exemple RPG, la procdure externe QqfEnvironment est dfinie avec la spcification D (DSpec) QQFENV. Dans cet exemple, le mme nom a t attribu la spcification D QQFENV qu'au programme de service et il a t dfini comme un entier car la procdure renvoie la valeur 0 ou 1. Une spcification D rc a galement t dfinie pour recevoir la valeur 0 ou 1 lorsque l'instruction Eval rc = QQFENV est excute. Le programme RPG utilise ensuite la valeur rc pour dterminer l'aide de conditions le comportement du programme et ce qui s'affichera sur l'cran DDS. Dans l'exemple de DDS ci-aprs, si la valeur de rc dans le module RPG est diffrente de 1, le texte "L'application ne s'excute pas dans l'environnement WebFacing" apparat. Si la valeur de rc est gale 1, le texte "L'application s'excute dans l'environnement WebFacing" apparat. Lorsque vous crez un programme pour utiliser cette API : 1. Utilisez la commande CRTRPGMOD pour crer un module avec le code RPG qui appelle l'API. Il est ncessaire de crer un module RPG car il utilise une procdure qui ne figure pas dans le programme. 2. Lorsque vous crez votre programme (CRTPGM=), utilisez le mot cl BNDSRVPGM pour lier votre module RPG au programme de service QQFENV dans la bibliothque QSYS.

.........1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 FCHKENVFM CF E Workstn * DQQFENV PR 10I 0 Extproc(QqfEnvironment) * Drc S 10I 0 * C Eval rc = QQFENV C Eval FLD001 = rc * C Dow NOT *IN03 * C If rc = 1 C Eval *in01 = *on * C Else C Eval *IN01 = *off C EndIf * C Exfmt FMT01 C EndDo * C Eval *inlr = *on Figure 1. Exemple RPGLE

94

Dveloppement des applications WebFacing

....+A*..1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 A*%%TS SD 20010924 150104 USERID REL-V4R4M0 5769-PW1 A*%%EC A DSPSIZ(24 80 *DS3) A R FMT01 A*%%TS SD 20010924 150104 USERID REL-V4R4M0 5769-PW1 A CA03(03) A 1 24Test de lAPI denvironnement WebFacing A DSPATR(HI) A 10 3F3=Sortie A COLOR(BLU) A N01 5 13Lapplication ne sexcute pas dans A lenvironnement WebFacing A 01 6 15Lapplication sexcute dans lenvironnement A WebFacing A COLOR(RED) A FLD001 4S 0O 7 39 A 7 22QqfEnvironment: A A*%%GP SCREEN1 01 Figure 2. Exemple DDS

Chapitre 7. Interoprabilit de WebFacing avec HATS et d'autres applications Web


L'outil IBM WebFacing, ainsi que HATS Toolkit, permettent de configurer vos applications mtier de base pour le Web. L'outil IBM WebFacing convertit vos fichiers source DDS, ce qui vous permet de disposer d'une interface utilisateur Web pour vos applications hte 5250. HATS Toolkit convertit les flux de donnes 5250 en HTML de manire dynamique, ce qui permet aux applications d'tre migres vers le Web sans qu'il soit ncessaire d'accder ni de modifier le code source DDS d'origine. Les fonctions d'interoprabilit entre HATS et WebFacing permettent d'exploiter les avantages conjugus des outils WebFacing et HATS en combinant les applications la source DDS convertie et non convertie. Par le biais de cette technologie, vos applications peuvent tre modernises de manire simple et rapide l'aide de WebFacing et de HATS. Si vous souhaitez aller plus loin, vous pouvez ajouter progressivement de nouvelles applications Web afin d'exploiter au mieux les dernires innovations technologiques du Web. La passerelle d'application WebFacing permet de connecter de manire transparente de nouvelles applications Web (qui utilisent EGL pour crer de nouvelles applications Web par exemple) des applications WebFacing et/ou HATS existantes. Cela permet aux applications WebFacing de transfrer le contrle et les donnes vers et depuis d'autres applications Web comme celle crites avec EGL, ce qui permet de combiner les applications HATS, WebFacing et EGL en une seule application. Les avantages de cette technique ne se limitent pas l'obtention des donnes IBM i dans une application Web via un accs direct la base de donnes ou l'appel d'un programme de traitement par lots via un service Web. Vous avez la possibilit de lier votre nouvelle application Web des applications IBM i WebFacing et HATS interactives et de partager les donnes.

95

Pour plus de dtails sur l'implmentation de la passerelle d'application WebFacing, voir le tutoriel Cration d'une passerelle d'application entre une application WebFacing et EGL sur le site Web Education Assistant IBM Rational Host Access Tranformation Services.

Interoprabilit de WebFacing avec des applications HATS


Les fonctions d'interoprabilit entre WebFacing et HATS offrent la possibilit de combiner des applications WebFacing des transformations dynamiques de flux de donnes 5250 par le biais de HATS, au sein de la mme application Web. Dans ce contexte, l'interoprabilit signifie qu'une seule application Web WebFacing interagit ou s'excute en parallle avec une seule application HATS. L'application Web combine possde les fonctions des deux outils, toutefois limites et clairement spares. Pour crer une application Web combine, un seul projet Web WebFacing (de type projet activ HATS/WebFacing) est li un seul projet HATS et intgr sous la forme d'une application d'entreprise ou fichier .ear unique. Cette application contient les programmes d'excution des deux produits ainsi qu'un composant d'excution courant utilis pour crer et interagir avec une connexion partag sur l'hte dorsal 5250. Pour plus de dtails sur l'implmentation des applications d'interoprabilit HATS et WebFacing, voir le tutoriel Cration d'une application lie WebFacing et HATS sur le site Web IBM Rational Host Access Transformation Services Education Assistant. Rfrence associe Rgles relatives aux applications HATS/WebFacing Ce document de rfrence dcrit les rgles techniques et de scurit respecter lors de la cration d'une application lie HATS/WebFacing.

Rgles relatives aux applications HATS/WebFacing


Ce document de rfrence dcrit les rgles techniques et de scurit respecter lors de la cration d'une application lie HATS/WebFacing. Les applications lies HATS/WebFacing doivent respecter un certain nombre de rgles techniques et de scurit. En gnral, toute limitation impose une application HATS ou WebFacing autonome s'applique galement un projet li HATS/WebFacing. En outre, vous devez prendre en compte les informations qui suivent lors de la conception et du dploiement de vos propres projets.

Rgles techniques
v Certaines modifications effectues sur les applications HATS et WebFacing individuelles ne toucheront pas le projet li HATS/WebFacing. En particulier, aprs la cration du projet, les options de configuration indiques dans l'assistant de cration de projet li HATS/WebFacing (comme le nom d'hte ou le port, la page de codes et la taille de l'cran) ne peuvent tre changes que via la modification du fichier wfhats.xml ou le redmarrage de l'assistant de cration

96

Dveloppement des applications WebFacing

de projet. La modification des paramtres de connexion aprs la cration du lien dans le projet HATS ou WebFacing ne touche pas le projet li. v Les macros de connexion HATS s'excutent lorsque l'on accde l'application HATS pour la premire fois ( l'entre initiale dans l'application lie ou l'accs un cran hte qui n'a pas t converti par WebFacing). C'est pourquoi vous ne devez pas crer une macro de connexion destine l'cran de connexion si votre application lie doit dmarrer partir de WebFacing. Les macros de dconnexion ne s'excutent que si l'application lie est arrte partir de l'environnement d'excution HATS. v Les vnements Start et Connect dfinis dans un projet HATS s'excutent lorsque l'on accde l'application HATS pour la premire fois. Si l'application lie est dmarre partir de WebFacing, les actions dfinies dans ces vnements ne seront excutes que lorsque l'utilisateur aura accd un cran hte qui n'a pas t converti par WebFacing. C'est pourquoi vous ne devez pas, par exemple, lancer une macro destine l'cran de connexion dans l'vnement Connect si votre application lie doit dmarrer partir de WebFacing. v Si vous utilisez la console d'administration de HATS pour modifier les paramtres de la licence en tant en mode Excuter sur le serveur, vous devez redmarrer votre application lie pour que ces modifications s'appliquent. Si vous utilisez la console d'administration de HATS pour modifier les paramtres de la licence en tant en mode Dboguer sur le serveur, les modifications ne s'appliqueront pas l'application lie. En effet, la console d'administration HATS modifie le fichier runtime-debug.properties pendant une excution en mode Dbogage et l'application lie utilise le fichier runtime.properties pour dfinir ses paramtres de licence. Notez galement qu'en mode Dboguer sur le serveur, il est recommand de vrifier que les paramtres de licence du fichier runtime.properties correspondent ceux du fichier runtime-debug.properties. v Pour les projets lis HATS/WebFacing, le seul serveur d'applications pris en charge pour le dploiement est IBM WebSphere Application Server. v Pour obtenir la liste des navigateurs Web pris en charge pour les applications HATS/WebFacing lies, voir la section des prrequis HATS du Centre d'information HATS. v Une application lie HATS/WebFacing doit tre compose d'un projet activ HATS/WebFacing et d'un projet Web HATS. Les autres types de projet WebFacing (Web et portlet) et les projets HATS (projets de client enrichi, projets de portail et projets Enterprise JavaBeans) ne peuvent pas tre lis. v L'applet HATS n'est pas prise en charge pour les applications lies HATS/WebFacing. Ne configurez pas votre projet pour qu'il utilise cette applet. v Toute personnalisation d'cran ralise avec HATS restera sans effet si cet cran est galement converti avec WebFacing. En effet, c'est la conversion WebFacing qui sera utilise au moment de l'excution. v Lorsque vous excutez une application lie HATS/WebFacing, le regroupement de connexions HATS n'est pas utilis, mme s'il est configur dans le projet HATS. v Lorsque vous excutez une application lie, la connexion est persistante. Les fonctions non-persistantes, comme la reprise en ligne, ne fonctionnent pas correctement. v La prise en charge de l'ID poste de travail n'est pas disponible pour les applications lies HATS/WebFacing. Vous pouvez lier une application HATS qui est configure pour un ID poste de travail spcifique ; cependant, ce paramtre ne sera pas pris en compte l'excution. v Les projets HATS peuvent avoir la fois une connexion de transformation principale et d'autres connexions d'arrire-plan, un mme hte ou des htes
Chapitre 7. Interoprabilit de WebFacing avec HATS et d'autres applications Web

97

diffrents. Les caractristiques d'un projet li et les paramtres de connexion ne s'appliquent qu' la connexion de transformation principale. v WebFacing prend en charge les utilisateurs aux privilges limits sur IBM i version 6.1 et plus. Pour utiliser un profil avec des privilges limits sur la version 5.4, vous devez dmarrer l'application lie partir de l'interface HATS. v Dans certains cas, il peut tre prfrable de dployer votre application HATS plus d'une fois sur le mme serveur. Par exemple, la mme application HATS peut tre dploye comme application autonome et comme composant d'une application lie. Pour dployer votre application HATS plus d'une fois sur le mme serveur, vous devez fournir une racine de contexte unique pour chaque instance. Pour ce faire : 1. Cliquez avec le bouton droit de la souris sur le projet et slectionnez Proprits. 2. Dans la sous-fentre de gauche, slectionnez l'option des paramtres du projet Web. 3. Saisissez une racine de contexte unique dans la zone Racine de contexte et cliquez sur OK. 4. La bote de dialogue Modification de la racine de contexte s'affiche. Slectionnez Oui pour corriger les liens qui font rfrence cette racine de contexte. 5. Modifiez la valeur <nom_affichage> dans le fichier web.xml du projet. Si vous mettez jour la racine de contexte d'un projet aprs l'avoir li l'autre, vous devrez mettre jour le fichier wfhats.xml pour que ces changements soient pris en compte. Ce fichier est situ dans le dossier principal du projet li HATS/WebFacing. v Vous ne pouvez pas accder simultanment de multiples applications lies dans la mme instance du navigateur. Par exemple, si vous ouvrez le navigateur et que vous lancez l'application A et que vous crez une fentre enfant dans le navigateur, vous ne pouvez pas accder ensuite l'application B dans cette fentre enfant. Une fentre enfant est une fentre ouverte par la commande Ctrl-N ou Fichier->Nouveau->Fentre dans Internet Explorer. La mme rgle s'applique aux onglets d'Internet Explorer version 7. En outre, si vous souhaitez accder l'application A, puis l'application B dans le mme navigateur, vous devez tout d'abord vous dconnecter correctement et quitter l'application A avant d'accder l'application B. Cela n'est valable que si les applications A et B ont la mme racine de contexte. v Vous risquez d'obtenir des rsultats inattendus en accdant une application lie HATS/WebFacing si vous utilisez les boutons Actualiser et Prcdente du navigateur. Consultez la foire aux questions HATS pour plus d'informations. v Bien que les outils de dveloppement HATS vous permettent de crer des macros qui naviguent dans des crans DDS convertis pour WebFacing, ces macros ne pourront pas fonctionner si l'application essaie d'afficher les crans convertis pour WebFacing. Les macros ne peuvent pas grer les crans convertis pour WebFacing si leurs fichiers d'affichage ont t ouverts avant le lancement de la macro. L'application s'arrte alors en gnrant une erreur.

Rgles de scurit
Pour scuriser votre application lie HATS/WebFacing l'aide de Tivoli Access Manager, vous devez dfinir deux options de configuration pour que votre application fonctionne correctement.

98

Dveloppement des applications WebFacing

v Dans le fichier de configuration du dmon WebSEAL (webseald.conf), activez le paramtre preserve-base-href :


preserve-base-href = yes

v Crez toutes les jonctions avec le paramtre -j pour permettre WebSEAL de fournir un cookie d'identification de jonction au navigateur. Pour plus d'informations sur ces options, reportez-vous la documentation de Tivoli Access Manager.

Utilisation de la passerelle d'application WebFacing pour l'interaction avec d'autres applications Web
La plateforme d'application WebFacing permet de connecter de manire transparente de nouvelles applications Web (crites avec EGL par exemple) des applications WebFacing et/ou HATS existantes. Par le biais de cette technologie, vos applications peuvent tre modernises de manire simple et rapide l'aide de WebFacing et/ou HATS et de nouvelles applications Web peuvent tre ajoutes de manire progressive pour bnficier des dernires innovations Web. A l'aide de la passerelle d'application, les applications WebFacing peuvent transfrer le contrle et les donnes vers et depuis d'autres applications Web, telles qu'EGL, ce qui permet de combiner les applications HATS, WebFacing et EGL en une seule application. Les avantages de cette technique ne se limitent pas l'obtention des donnes IBM i dans une application Web via un accs direct la base de donnes ou l'appel d'un programme de traitement par lots via un service Web. Vous avez la possibilit de lier votre nouvelle application Web une application IBM i interactive et de partager les donnes. L'application WebFacing et l'application Web correspondante peuvent tre intgres sous la forme d'un fichier EAR des fins de dploiement. Le fichier EAR peut tre cr l'aide de la perspective Java EE de l'environnement IDE. Les applications WebFacing et l'application Web peuvent cependant tre dployes galement en tant que fichiers EAR distincts au sein de la mme instance de serveur d'applications. Pour autoriser la prise en charge de l'interoprabilit entre une application WebFacing et une autre application Web, un enregistrement de lien DDS doit tre cr et le paramtre Web Passerelle d'application doit tre dfini pour cet enregistrement. Un enregistrement de lien DDS est un enregistrement DDS standard contenant des zones dfinies comme tant masques (usage H) qui permet de transfrer les donnes. Ce n'est pas lui qui apparat l'cran. Il permet simplement de transfrer des donnes et le contrle l'application Web indique dans l'URL de l'application cible du paramtre Web Passerelle d'application lorsque l'application IBM i excute une opration de type WRITE sur l'enregistrement. Pour plus d'informations sur la cration d'un enregistrement de lien DDS, voir le paramtre Web Passerelle d'application dans Utilisation des paramtres Web avec le source DDS, la page 61. La passerelle d'application WebFacing prend en charge le transfert du contrle et des donnes dans les scnarios ci-dessous.

Chapitre 7. Interoprabilit de WebFacing avec HATS et d'autres applications Web

99

1. Une application WebFacing appelle une autre application Web comportant des donnes ; cette dernire renvoie le contrle WebFacing avec les mises jour des donnes. v L'application IBM i excute une opration WRITE sur l'enregistrement de lien WebFaced (transfert du contrle et des donnes une autre application Web) immdiatement suivie d'une opration READ et elle attend le renvoi des donnes. 2. Une application Web appelle une application WebFacing. Cette dernire s'excute et renvoie ensuite les donnes l'autre application Web. v L'application IBM i excute une opration WRITE sur un enregistrement de lien WebFaced avec le mot cl FRCDTA, puis elle s'arrte. Le scnario 1 transmet les donnes de l'application WebFacing vers l'application Web indique dans l'URL de l'application cible du paramtre Web Passerelle d'application lorsque l'application IBM i excute une opration WRITE et READ sur l'enregistrement de lien DDS. L'application WebFacing attend alors une rponse de l'application Web. Cette dernire lit ensuite les donnes via l'attribut de requte "LinkageData", effectue les mises jour ventuelles, puis renvoie ces dernires l'application WebFacing qui reprend alors le contrle. Le scnario 2 est pris en charge par l'appel par programmation WebFacing qui permet de spcifier n'importe quelle commande CL avec ou sans paramtre pour lancer une application WebFacing. L'application WebFacing s'excute, puis retransmet les donnes l'application Web indique dans la zone d'URL de l'application cible du paramtre Web Passerelle d'application lorsque l'application IBM i excute une opration WRITE sur l'enregistrement de lien DDS. Dans ce scnario, le mot cl FRCDTA doit tre spcifi dans l'enregistrement de lien DDS afin que l'application puisse s'arrter avec succs. Pour plus d'informations sur l'appel par programmation, voir Appel par programmation d'applications WebFacing depuis d'autres applications Web, la page 102. La passerelle d'application WebFacing permet d'tablir une interaction entre des applications WebFacing et/ou HATS et d'autres applications Web. HATS est configur pour prendre en charge WebFacing lorsqu'un projet HATS et WebFacing sont lis par le biais de la fonction d'interoprabilit. Dans le cas des projets HATS/WebFacing lis, la passerelle d'application peut tre utilise dans les scnarios ci-dessous. 1. HATS et Web/EGL : seul l'enregistrement de lien est converti/WebFaced dans le projet WebFacing ; permet aux projets HATS de transmettre le contrle et les donnes Web/EGL. 2. WebFacing, HATS et Web/EGL : une partie de l'application est WebFaced et l'autre partie s'excute en tant que projet HATS ; permet WebFacing et/ou aux projets HATS de transmettre le contrle et les donnes Web/EGL. Transmission du contrle de WebFacing une application Web Dans les deux scnarios ci-dessus, une opration WRITE est excute sur un enregistrement de lien DDS dans le but de transmettre le contrle de WebFacing une autre application Web. Pour cela, la mthode de racheminement Java EE est applique l'adresse URL indique dans l'URL de l'application cible du paramtre Web Passerelle d'application. L'application WebFacing utilisera la premire partie de l'adresse URL de l'application cible comme racine du contexte et acheminera l'application WebFacing vers l'autre partie de l'adresse URL. Si l'adresse URL de l'application cible est /appContextRoot/appEntryPoint, l'application WebFacing utilise appContextRoot comme racine du contexte et l'acheminement s'effectue vers

100

Dveloppement des applications WebFacing

appEntryPoint. L'application WebFacing ajoute alors l'attribut de requte "forwarded" la valeur "WF" dans l'objet de requte avant de procder l'acheminement. Le module d'excution de l'application de rception pourra ainsi excuter toute action spciale ncessaire lors de la rception du contrle retransmis. Transmission du contrle d'une autre application Web vers WebFacing Dans le cadre du scnario 1, lors du renvoi du contrle vers l'application WebFacing et pour garantir la transmission des mises jour des donnes, l'application Web doit ajouter l'attribut "forwarded" dans l'objet de requte avant de procder au racheminement. L'attribut de requte doit tre "EGL" pour une requte achemine depuis une application EGL et "CUSTOM" pour une requte achemine depuis une autre application Web. L'application WebFacing de rception peut ainsi excuter toute action spciale ncessaire lors de la rception du contrle retransmis. Le point d'entre de l'application WebFacing est "/webfacing/ WebFacing.do". Echange de donnes entre WebFacing et une autre application Web Les donnes de la passerelle d'application livres par l'enregistrement de lien DDS l'application WebFacing sont sauvegardes dans une Java, le nom de zone tant utilis comme cl dans la HashMap et la valeur de zone comme valeur de la cl associe. Un attribut de requte "LinkageData" est utilis pour fournir l'accs la HashMap. Les valeurs de zone contenues dans l'enregistrement de lien DDS sont stockes en tant que donnes de chane Unicode dans la HashMap. L'autre application Web met alors jour comme il convient les zones de la HashMap et renvoie cette dernire l'application WebFacing via l'attribut de requte "LinkageData". Une valeur de zone doit contenir les caractres admis par le type de donnes DDS correspondantes et avoir la longueur approprie ; sinon, elle est rejete par l'application WebFacing. Prenez connaissance des informations suivantes : 1. Zones de caractres et zones DBCS : aucun formatage n'est appliqu ces types de donnes. 2. Zones numriques : un sparateur dcimal "." est insr l'emplacement appropri dans les donnes si la position dcimale pour une zone est suprieure 0 ; un signe ngatif "-" est ajout au dbut des donnes si la valeur est ngative. Par exemple, -000123.45 est le format appropri pour une valeur numrique dont la longueur est de 8 chiffres et la position dcimale de 2. 3. Zones de donnes : le format ISO AAAA-MM-JJ est utilis. 4. Zones horaires : le format ISO hh:mm:ss est utilis. 5. Zones d'horodatage : le format ISO AAAA-MM-JJThh:mm:ss.uuuuuu est utilis. Remarque : Lorsqu'un enregistrement de lien DDS ne contient pas de zone, la valeur de l'attribut de requte "LinkageData" est nulle.

Chapitre 7. Interoprabilit de WebFacing avec HATS et d'autres applications Web

101

Concepts associs Utilisation des paramtres Web avec le source DDS, la page 61 Information associe Appel par programmation d'applications WebFacing depuis d'autres applications Web

Appel par programmation d'applications WebFacing depuis d'autres applications Web


Vous pouvez appeler par programmation les applications WebFacing depuis d'autres applications Web. Vous pouvez ainsi intgrer des interfaces utilisateur gnres par WebFacing l'aide d'applications Web existantes. Les applications WebFacing sont lances depuis des URL. Dans une application WebFacing, chaque URL de commande CL dfinie se prsente gnralement sous la forme d'un bouton sur lequel l'utilisateur clique pour dmarrer l'application. Pendant la conversion WebFacing, les URL sont crites dans un fichier d'appel .jsp. Une fois l'application dploye, elles deviennent des boutons sur lesquels l'utilisateur clique pour dmarrer l'application. Le contrle de l'appel de WebFacing permet d'avoir recours des mthodes d'authentification alternatives. L'authentification de l'utilisateur peut tre effectue dans un servlet personnalis avant que WebFacing ne soit appel. Le mcanisme d'authentification utilis doit pouvoir fournir l'application WebFacing les donnes d'identification utilisateur IBM i pour lui permettre d'accder aux ressources IBM i. Voici une faon simple de dterminer la commande CL utiliser pour lancer un programme : URL construite par un servlet contrleur : WFInvocation.do?clcmd=call%20ordentr Dans cet exemple, ordentr est le nom du programme lancer. La valeur ordentr peut tre dfinie par un servlet et attribue une variable telle que orderProgram. Votre servlet peut construire la chane URL en utilisant la valeur dtermine par orderProgram et l'affecter une variable newURL l'aide d'une ligne telle que la suivante :
newURL = "WFInvocation.do?clcmd=call " + orderProgram;

newURL peut alors tre utilise comme URL de racheminement ou de redirection de vos mthodes forward() et sendRedirect(). Dans cet exemple, l'URL complte utilise par le navigateur, si c'est une URL de redirection, est du type :
http://<nom_hte>:<port>/<application>/WFInvocation.do?clcmd=call%20ordentr

L'exemple montre l'URL complte commenant par http://<nom_hte>:<port>/ <application>/. La chane qui suit correspond la valeur de la variable newURL, savoir la chane : WFInvocation.do?clcmd=call%20ordentr. Dans un exemple de ce type, la premire partie de l'URL, http://<nom_hte>:<port>/<application>/, correspond l'hte, au port et la racine de contexte de l'application. Si votre servlet contrleur se trouve dans la mme racine de contexte, il n'est pas toujours ncessaire que le servlet dfinisse l'URL complte. Si cela s'avre toutefois ncessaire, vous pouvez coder le servlet afin de construire une chane indiquant l'adresse complte de l'URL.

102

Dveloppement des applications WebFacing

Remarque : Les caractres %20 de l'URL reprsentent un espace cod lors de l'envoi au navigateur. Les espaces ne peuvent gnralement pas tre utiliss de manire explicite dans les URL. Dans l'exemple o la chane de l'URL est en cours de construction, puis attribue la variable newURL, l'espace est prsent dans la chane juste aprs clcmd=call. Cet espace reprsente la commande CL call ordentr. Il n'est pas ncessaire d'ajouter directement %20 dans la chane de l'URL en construction. Le serveur ajoute ce codage si ncessaire.

Paramtres d'URL pouvant tre dtermins de manire dynamique


clcmd Commande CL servant dmarrer le programme. host port Nom de l'hte sur lequel l'application 5250 d'origine est situe. Numro de port du serveur WebFacing sur IBM i.

userid ID utilisateur utilis lors de la connexion l'application. Remarque : Si une mthode forward() est utilise sur votre servlet contrleur, les paramtres de l'URL sont envoys uniquement au niveau du serveur d'applications (niveau intermdiaire). Si vous utilisez la mthode sendRedirect() la place, les paramtres de l'URL sont exposs au navigateur. La mthode sendRedirect() est donc moins scurise car des informations comme l'ID utilisateur ou le mot de passe peuvent tre rvles dans la zone d'emplacement d'un navigateur, ou si un utilisateur affiche les proprits de la page en cours d'utilisation. password Mot de passe utilis lors de la connexion l'application. Remarque : Si une mthode forward() est utilise sur votre servlet contrleur, les paramtres de l'URL sont envoys uniquement au niveau du serveur d'applications (niveau intermdiaire). Si vous utilisez la mthode sendRedirect() la place, les paramtres de l'URL sont exposs au navigateur. La mthode sendRedirect() est donc moins scurise car des informations comme l'ID utilisateur ou le mot de passe peuvent tre rvles dans la zone d'emplacement d'un navigateur, ou si un utilisateur affiche les proprits de la page en cours d'utilisation. inv Nom d'appel de la commande CL WebFacing utilise pour lancer l'application. Si les valeurs telles que l'hte, l'ID utilisateur et le mot de passe sont dfinies pour une commande CL, ces valeurs prvalent sur les valeurs gnrales spcifies pour un projet. Pour visualiser le nom d'appel d'une commande CL, ouvrez la perspective WebFacing dans le plan de travail, cliquez sur l'onglet Projets WebFacing, dveloppez le projet WebFacing, dveloppez le dossier Commandes CL et cliquez sur le libell de la commande. La valeur du nom d'appel peut tre visualise dans la sous-fentre Proprits. Si la sous-fentre Proprits n'est pas affiche dans la perspective WebFacing, cliquez sur Fentre > Afficher la vue > Proprits pour l'ouvrir. Pour modifier le nom d'appel, cliquez avec le bouton droit de la souris sur la commande CL dans la vue Projets WebFacing et slectionnez Proprits.

Chapitre 7. Interoprabilit de WebFacing avec HATS et d'autres applications Web

103

Filtrage des commandes d'appel par programmation


Vous pouvez prciser les prfixes de commande CL qui seront autoriss pour les appels par programmation via le paramtre clcmd. Les appels par programmation utilisant le paramtre clcmd et prcisant une valeur qui ne commence pas par un prfixe autoris par vous ne pourront pas s'excuter. Par dfaut, le systme empche l'excution de tout appel par programmation qui se substitue la commande CL excuter. Pour la migration des projets depuis WebFacing version 6, une valeur spciale *ALL sera incluse, pour permettre l'excution de toutes les commandes CL.
<context-param> <param-name>WFCLCMDAllowed0</param-name> <param-value>*ALL</param-value> </context-param>

Si le paramtre clcmd n'est pas utilis ou si les valeurs clcmd utilises sont connues, vous devez retirer la valeur *ALL et entrer des valeurs selon les indications ci-dessous. Pour prciser les prfixes de commande autoriss, modifiez la source du fichier web.xml de votre application WebFacing. Ajoutez des noms de paramtre comprenant WFCLCMDAllowed, suivi d'un texte permettant de distinguer un paramtre d'un autre. Ajoutez ensuite une valeur chaque paramtre afin de prciser la commande qui sera autorise. L'exemple ci-dessous autorise toutes les commandes commenant par CALL MYCMD et GO MYMENU.
<context-param> <param-name>WFCLCMDAllowed0</param-name> <param-value>GO MYMENU</param-value> <param-name>WFCLCMDAllowed1</param-name> <param-value>CALL MYCMD</param-value> </context-param>

Si ncessaire, affectez des valeurs aux autres paramtres du contexte. Les valeurs de clcmd du type CALL MYCMDisOK ou CALL MYCMD PARAM(ONE) seront autoris, contrairement des valeurs comme CALL MY ou CALL OTHERCMD. Comme pour GO MYMENU, les commandes autorises doivent commencer par la chane prcise. La comparaison ne prend pas en compte la diffrence majuscules/minuscules. Remarque : Seuls les appels par programmation utilisant le paramtre clcmd sont concerns, contrairement aux appels WebFacing utilisant le paramtre inv.

Exemples d'URL
WFInvocation.do?clcmd=call%20ordentr L'hte et le port sont utiliss dans le fichier descripteur de dploiement web.xml. Invitez l'utilisateur se connecter. WFInvocation.do?inv=INV1 L'hte, l'ID utilisateur, le mot de passe et la commande CL sont extraits du fichier descripteur de dploiement web.xml. Le nom d'appel de la commande CL est INV1. Invite uniquement lorsque l'ID utilisateur ou le mot de passe sont manquants ou que l'invite est spcifie. Impression du message d'erreur si l'ID utilisateur ou le mot de passe sont incorrects.

104

Dveloppement des applications WebFacing

WFInvocation.do?inv=INV1&host=SYSTEM1&userid=WEBFACING &password=WEBFACING Le nom d'appel de la commande CL est INV1. L'hte, l'ID utilisateur et le mot de passe sont transmis par l'URL. Les paramtres multiples sont spars par &. WFInvocation.do?clcmd=call%20ordentr&host=SYSTEM1&userid=WEBFACING &password=WEBFACING La commande CL call ordentr est transmise par l'URL. L'hte, l'ID utilisateur et le mot de passe sont transmis par l'URL. Les paramtres multiples sont spars par &. Exemple entirement qualifi http://<nom_hte>:port/<application>/WFInvocation.do?clcmd=call %20ordentr&host=SYSTEM1&port=4004&userid=WEBFACING &password=WEBFACING Remarque : Dans cet exemple, les chanes <nom_hte> et <port> correspondent au nom de l'hte et au port du serveur d'applications sur lequel l'application WebFacing est dploye. <application> est la racine de contexte pour l'application dploye. L'exemple montre les valeurs suivantes transmises par l'URL : la commande CL est call ordentr. L'hte sur lequel l'application 5250 est installe est SYSTEM. L'ID utilisateur est WEBFACING. Le mot de passe est WEBFACING. Les paramtres multiples sont spars par &.

Mthodes de servlet permettant d'appeler une application WebFacing par programmation


Il existe deux mthodes de servlet permettant d'appeler une application WebFacing par programmation, savoir : v forward() -- La mthode forward() se trouve dans la classe javax.servlet.RequestDispatcher. v sendRedirect() -- La mthode sendRedirect() se trouve dans la classe javax.servlet.http.HttpServletResponse. Les diffrences principales entre ces deux mthodes sont listes ci-dessous :
mthode forward() javax.servlet.RequestDispatcher Appel Server-side. Cette mthode appelle l'autre ressource, extrait ses rsultats et les renvoie au client. mthode sendRedirect() javax.servlet.http.HttpServletResponse Envoie le code d'tat HTTP 302 au navigateur. Le navigateur se reconnecte automatiquement l'URL de la ressource. Dans ce cas, le navigateur sait que les rsultats proviennent d'une autre ressource.

Chapitre 7. Interoprabilit de WebFacing avec HATS et d'autres applications Web

105

106

Dveloppement des applications WebFacing

Chapitre 8. Test et dploiement des applications WebFacing


Aprs avoir cr et converti un projet WebFacing l'aide de l'outil WebFacing, vous pouvez le tester avant de le dployer sur un serveur d'applications. Pour plus d'informations sur le test des applications WebFacing, voir Test des applications WebFacing. Aprs avoir test le projet WebFacing, vous devez le dployer sur un serveur d'applications. La procdure de dploiement de WebSphere Application Server comprend trois tches gnrales : 1. Exportez le projet WebFacing sous la forme d'un fichier EAR ou WAR. Un fichier EAR est un fichier d'archive d'application d'entreprise compress. Un fichier WAR est un fichier d'archive d'application Web. 2. Installez le fichier EAR export via la console d'administration WebSphere. 3. Lancez l'application Web. Pour plus d'informations sur le dploiement des applications WebFacing, voir Dploiement d'applications WebFacing, la page 108.

Test des applications WebFacing


L'environnement de test WebSphere constitue un moyen pratique de tester vos applications WebFacing. Il vous permet de tester votre projet WebFacing sur un WebSphere Application Server (WAS) qui s'excute sur votre poste de travail. Comme l'excution de WAS sur IBM i utilise beaucoup de ressources du systme, certains dveloppeurs prfrent utiliser l'environnement de test ds la phase de dveloppement. Pour configurer et utiliser l'environnement de test, procdez comme suit : 1. Aprs avoir converti un projet WebFacing, activez la vue Projets WebFacing. Cliquez avec le bouton droit de la souris sur le projet WebFacing que vous souhaitez tester et slectionnez Excuter > Excuter sur le serveur. 2. La bote de dialogue Excuter sur le serveur s'ouvre. Vous pouvez crer un nouveau serveur ou publier votre projet sur un serveur existant. Si vous utilisez l'environnement de test pour la premire fois, vous tres invit crer un nouveau serveur. Si vous avez dj cr des serveurs, vous pouvez choisir n'importe lequel d'entre eux. Les types de serveur disponibles dpendent des options choisies lors de l'installation d'IBM Software Delivery Platform. Si vous voulez que ce projet se dploie toujours sur le mme serveur, cochez la case Dfinir le serveur comme projet par dfaut (sans invite). Une fois que vous avez slectionn un serveur, cliquez sur Terminer. 3. Si un nouveau serveur est en cours de cration, ce dernier est cr puis lanc. Si vous utilisez un serveur existant, ce dernier est lanc (s'il n'est pas dj en cours d'excution). Votre projet est galement dploy dans l'environnement de test. Une fois l'installation du serveur termine, la console de serveur affiche le message suivant : "Serveur ouvert pour l'e-business" et une zone d'diteur contenant la page index.jsp de votre application WebFacing apparat dans un navigateur Web.

107

Tches connexes Chapitre 8, Test et dploiement des applications WebFacing, la page 107 Lancement de l'application dans un navigateur, la page 109

Dploiement d'applications WebFacing


Les applications WebFacing peuvent tre dployes sur WebSphere Application Server ou sur le serveur d'applications Web intgr IBM i. Quel serveur d'applications faut-il utiliser ? v Utilisez Websphere Application Server Express ou Base si vous dployez des applications WebFacing, des applications lies WebFacing/HATS ou des applications WebFacing qui utilisent la passerelle d'application. v Utilisez Websphere Application Server Network Deployment (ND) si vous dployez des applications WebFacing devant prendre en charge des fonctions haute disponibilit, de reprise en ligne et d'quilibrage de charge du serveur. v Utilisez le serveur d'applications Web intgr IBM i si vous dployez des applications Web WebFacing et si vous disposez de ressources systme IBM i limites qui ne permettent pas d'excuter WebSphere Application Server de manire optimale. Le serveur d'applications Web intgr IBM i ne prend pas en charge la fonction de haute disponibilit et de reprise.

Dploiement sur WebSphere Application Server


1. Exportez le projet WebFacing sous la forme d'un fichier EAR. a. A partir de l'environnement de dveloppement intgr de l'outil WebFacing, slectionnez Fichier > Exportation. L'assistant d'exportation est lanc. b. Dans l'assistant d'exportation, sous Slectionner la destination d'exportation, choisissez Java EE > Fichier EAR. Cliquez sur Suivant. c. Sur l'cran Exportation EAR, slectionnez le projet WebFacing que vous souhaitez exporter dans la zone Projet EAR. d. Prs de la zone Destination, cliquez sur Parcourir pour slectionner le rpertoire dans lequel vous souhaitez exporter le fichier EAR, ainsi que le nom de ce dernier. Slectionnez un Environnement d'excution cible. La console d'administration base sur un navigateur vous permet d'installer les fichiers EAR qui se trouvent sur votre poste de travail ou qui sont dj installs dans le systme de fichiers de votre serveur IBM i. Si vous souhaitez d'abord transfrer vos fichiers dans le systme IFS, vous pouvez le faire soit par FTP, soit en utilisant l'explorateur de systmes distants dans l'espace de travail, soit en crant une ressource partage sur le serveur et en mappant une unit rseau de votre poste de travail sur cette ressource. e. Cliquez sur Fin pour crer le fichier EAR. 2. L'assistant d'installation d'application vous permet d'installer le fichier EAR. a. Connectez-vous la console d'administration s'excutant sur un navigateur. Aprs l'installation de WebSphere Application Server sur le serveur, l'adresse URL de la console d'administration est la suivante : http://nom_serveur:port_admin/admin/ pour WebSphere Application Server. b. Dans la barre de navigation situe gauche de la console d'administration, slectionnez Applications > Nouvelle application > Nouvelle application d'entreprise. c. Si vous voulez installer le fichier WAR ou EAR depuis votre poste de travail, cliquez sur le bouton Systme de fichiers local et recherchez

108

Dveloppement des applications WebFacing

l'emplacement dans lequel le fichier WAR a t export. Si vous avez transfr le fichier WAR ou EAR sur le systme IFS de votre serveur, cliquez sur le bouton Chemin de serveur, puis saisissez le chemin d'accs du fichier. d. Lorsque la question suivante vous est pose, "Comment souhaitez-vous installer l'application ?", slectionnez Raccourci. e. Si vous installez une application WAR, dans la zone Racine de contexte, prcisez le nom par lequel les utilisateurs pourront accder votre application, prfix par une barre oblique. Par dfaut, le nom de la racine de contexte est celui du projet. Par exemple, si vous avez utilis le mme nom que pour votre projet WebFacing, par exemple /webfacing1, les utilisateurs pourront accder votre application via un navigateur en utilisant une adresse du type : http://monserveur/webfacing1. Si vous installez une application EAR, la zone Racine de contexte doit tre laisse blanc. f. Cliquez sur Suivant. Les pages qui suivent affichent les informations supplmentaires sur votre application ; lisez ces informations. Acceptez les valeurs par dfaut, puis cliquez sur Suivant pour continuer. g. Une fois la procdure termine, la console affiche le lien Enregistrer dans la Configuration matre. Cliquez sur ce lien puis sur le bouton Enregistrer. 3. Lancez l'application Web. a. Dans la console d'administration, slectionnez Applications > Types d'application > Applications d'entreprise WebSphere. b. Cochez la case en regard de l'application que vous venez d'installer. c. Cliquez sur le bouton Dmarrer.

Lancement de l'application dans un navigateur


Pour que vous puissiez accder votre application WebFacing via un navigateur, celle-ci doit d'abord tre dmarre dans WebSphere Application Server. Pour plus d'informations sur le dmarrage d'une application dans le serveur d'applications, voir Chapitre 8, Test et dploiement des applications WebFacing, la page 107. Une fois que votre application est lance, vous pouvez y accder via un navigateur l'aide d'une adresse du type :
http://nom_hte:<port_hte>/<racine_contexte>/

Par exemple, si votre serveur est MONHOTE, votre port 9080, et la valeur de la racine de contexte entre pour l'application dans la console d'administration webfacing1, vous pouvez accdez l'application via une adresse du type :
http://MONHOTE:9080/webfacing1/

Pour consulter le nom d'hte de votre systme IBM i, excutez la commande CFGTCP sur une ligne de commande IBM i. Dans le menu Configurer TCP/IP, choisissez l'option 12 Modifier les informations de domaine TCP/IP et notez la valeur du nom d'Hte. Il s'agit de la valeur indiquer comme nom d'hte, en omettant les guillemets. Vous pouvez galement ajouter le nom de fichier index.jsp la fin de vos adresses. Par exemple, vous pouvez utiliser une adresse du type :
http://nom_hte:<port_hte>/<racine_contexte>/index.jsp

Chapitre 8. Test et dploiement des applications WebFacing

109

Le fichier index.jsp est gnr par la conversion WebFacing. Pour la plupart des configurations de serveurs Web, il n'est pas ncessaire de l'inclure dans une URL. Ainsi, pour la plupart des configurations, lorsque l'utilisateur entre une adresse URL se terminant par <racine_contexte>, le serveur par dfaut affiche le fichier index.jsp correspondant. Lorsque vous accdez la page, des liens sont affichs, correspondant aux libells de la commande que vous avez slectionns pour les commandes CL cres dans l'assistant de projets WebFacing. En cliquant sur ces liens, vous lancez les applications correspondantes sur votre serveur IBM i et la sortie de l'application s'affiche dans le navigateur. Vous pouvez crer vos propres pages pour lancer vos applications. Pour cela, utilisez la page webfacing/services/invocation/html/invocations.jsp comme point de dpart ou ajoutez les liens contenus dans le fichier invocations.jsp vos propres pages. Pour utiliser les liens, ouvrez un diteur source et recherchez les balises HTML qui commencent par <a href= et se terminent par </a>. La balise d'ancrage <a> identifie un lien HTML. Le paramtre href est un attribut obligatoire qui indique la destination du lien. Par exemple :
<a href="WFInvocation.do?inv=INV1">CALL ORDENTR</a>Entre initiant le lancement.

Les liens que vous crez varient en fonction de la commande que vous utilisez pour lancer l'application. Pour utiliser ce lien, copiez-le et collez-le dans le code source de vos pages HTML. Pour utiliser ces liens, vous devez copier le code source javascript de la section <head> du fichier index.jsp dans la section <head> de votre page. Ce code commence par la balise <script language="javascript"> et se termine par la balise </script>. Si vous crez vos propres pages, ces balises doivent tre incluses dans l'application Web que vous avez cre pour votre projet WebFacing. Rfrence associe Prise en charge WebFacing de plusieurs navigateurs Les projets WebFacing peuvent tre excuts dans les navigateurs Microsoft Internet Explorer et Mozilla Firefox. Ce document de rfrence dcrit les diffrences entre l'apparence des pages WebFacing dans Firefox et dans Internet Explorer.

Prise en charge WebFacing de plusieurs navigateurs


Les projets WebFacing peuvent tre excuts dans les navigateurs Microsoft Internet Explorer et Mozilla Firefox. Ce document de rfrence dcrit les diffrences entre l'apparence des pages WebFacing dans Firefox et dans Internet Explorer.

Navigateurs actuellement pris en charge


Pour obtenir la liste des versions prises en charge des navigateurs Web Microsoft Internet Explorer et Mozilla Firefox, voir la section des prrequis HATS du Centre d'information HATS.

110

Dveloppement des applications WebFacing

Avertissement : Les personnalisations client ne fonctionnent pas dans Firefox, sauf si elles sont explicitement codes pour la prise en charge de plusieurs navigateurs. Dans vos personnalisations, vitez d'utiliser des fonctions uniquement prises en charge par un navigateur spcifique. Par exemple si vous utilisez document.all() (une fonction d'Internet Explorer) dans une personnalisation, l'application ne fonctionnera pas dans un navigateur Firefox. Pour crire un code de navigateur crois, reportez-vous aux informations de la page http://www-128.ibm.com/developerworks/web/library/wa-ie2mozgd/. Un navigateur qui n'est pas pris en charge est un navigateur pour lequel le produit n'a pas t test. Lorsque vous utilisez un navigateur qui n'est pas pris en charge, vous recevez le message d'erreur WF0095. Si vous voulez excuter votre application WebFacing dans le navigateur qui n'est pas pris en charge sans message d'erreur, dfinissez la variable web.xml WFIgnoreBrowserTypeCheck sur true. Toutefois cette variable ne doit tre utilise que pour le dveloppement et le test de projets. Il est dconseill d'excuter le projet dans un navigateur qui n'est pas pris en charge en production.

Diffrences de comportement WebFacing lors de l'excution dans Internet Explorer et dans Firefox
Selon les navigateurs, la prsentation des pages Web est diffrente, ce qui affecte le comportement et les performances. La liste suivante rpertorie quelques unes des diffrences de prsentation et de comportement des applications WebFacing dans Internet Explorer et dans Firefox. v Fermeture des connexions WebFacing et rutilisation de la session : Lorsque les applications WebFacing sont excutes dans un navigateur Firefox, la fermeture de la fentre de navigation n'est pas dtecte et le travail WebFacing se poursuit. Les fentres de navigation d'Internet Explorer 8 ou de Firefox lances partir du mme raccourci partagent la mme session. WebFacing n'autorise qu'une seule connexion par session et envoie (par dfaut) une Erreur de rutilisation de la session WebFacing lorsque plusieurs connexions sont dtectes. Cet incident est plus frquent avec les navigateurs Firefox sauf si vous quittez de faon explicite les applications WebFacing. v Diffrences de rendu : La prsentation d'un tableau HTML peut tre lgrement diffrente selon les navigateurs. La police de caractres peut lgrement varier d'un navigateur un autre. Des caractres invalides prsents sous forme d'espaces, de cases ou qui n'apparaissent pas du tout dans Internet Explorer peuvent s'afficher sous forme de '?' ou de valeurs hexadcimales dans Firefox. v Dans Internet Explorer, le curseur se place au dbut d'une zone d'entre renseigne. Firefox ne prenant pas en charge le mode remplacement, le curseur se place la fin d'une zone d'entre renseigne. v Les zones formates fonctionnent diffremment dans Internet Explorer et dans Firefox : La position d'origine du caret et le rendu html dans une zone date : - Dans Internet Explorer, le caret apparat au dbut de cette zone et les caractres (mois, jour et anne) sont accols. - Dans Firefox, le caret suit le premier caractre de cette zone et les caractres (mois, jour et anne) sont espacs.

Chapitre 8. Test et dploiement des applications WebFacing

111

Remplacement de caractres : - Dans Internet Explorer, lorsque le caret se trouve au milieu d'une zone d'entre et que vous tes en mode de remplacement, Remarque : si vous tapez un caractre il crase le caractre suivant. Le mode de remplacement est dfini par dfaut pour les projets Web. - Dans Firefox, le caret ne se dplace pas et les caractres ne sont pas modifis. En effet, Firefox ne prend en charge que le mode insertion. Comportement du caret la fin d'une zone : - Dans Internet Explorer, lorsque le curseur se trouve la fin d'un segment renseign et que vous saisissez un caractre (par exemple '4'), il passe automatiquement au segment suivant et crase le premier caractre (par '4'). Si le segment concern comportait '00', il comporte maintenant '40'. - Dans Firefox, lorsque vous saisissez ce caractre avec le curseur la fin d'un segment renseign EDTMSK, il passe automatiquement au segment suivant et remplace l'intgralit du segment (par '4' dans l'exemple prcdent). v La prise en charge bidirectionnelle de WebFacing n'est pas disponible dans Firefox.

Transfert de fichiers l'aide de l'explorateur de systmes distants


Vous pouvez utiliser l'explorateur de systmes distants pour transfrer des fichiers WAR et EAR sur votre hte IBM i. Avec cet explorateur, vous pouvez changer des fichiers entre votre poste de travail et votre serveur sans utiliser FTP ou le partage de fichiers NetServer. Pour les versions 5.1 et plus, la console d'administration de WebSphere Application Server utilise un navigateur. Les fichiers WAR et EAR peuvent tre installs directement depuis votre poste de travail ou depuis un chemin d'accs dans le systme de fichiers de votre serveur s'ils s'y trouvent dj. Pour transfrer des fichiers l'aide de l'explorateur de systmes distants, procdez comme suit : 1. D'abord, exportez le projet WebFacing sous forme de fichier WAR ou EAR. Utilisation des fichiers WAR comme exemple : Dans le plan de travail, slectionnez Fichier > Exportation. Slectionnez Fichier WAR dans la bote de dialogue Slectionner la destination d'exportation. Ensuite, cliquez sur Suivant. Dans la bote de dialogue Exportation WAR, slectionnez votre projet WebFacing dans la zone Module Web. Cliquez sur Parcourir pour choisir l'emplacement de votre systme de fichiers local dans lequel le fichier sera export (par exemple, X:\fichiers-WAR). Cliquez sur Terminer. 2. Ouvrez la perspective Explorateur de systmes distants. Pour ouvrir cette perspective, slectionnez Fentre > Ouvrir la perspective > Explorateur de systmes distants. 3. Etablissez une nouvelle connexion si ncessaire. Lors de la cration de votre projet WebFacing, vous tes invit tablir une connexion votre serveur IBM i si aucune n'existe. Vous pouvez utiliser cette connexion si vous voulez dployer votre fichier WAR sur ce serveur. Si vous voulez tablir une nouvelle connexion (par exemple, si le serveur d'applications est install sur un autre systme IBM i que celui o votre application 5250 d'origine est situe), cliquez avec le bouton droit de la souris dans la vue Systmes distants, slectionnez Nouvelle connexion et choisissez IBM i.

112

Dveloppement des applications WebFacing

4. Transfrez le fichier sur votre serveur. a. Dveloppez l'icne Local pour rechercher dans votre systme de fichiers local le fichier WAR export lors de la premire tape. Cliquez avec le bouton droit de la souris sur le fichier WAR et slectionnez Copier. b. Dveloppez l'icne connexion de votre serveur. Par exemple, si le nom de votre serveur est MONSERVEUR et que vous avez utilis le mme nom pour la connexion, l'icne MONSERVEUR doit apparatre dans la perspective Explorateur de systmes distants. Dveloppez l'icne Fichiers IFS de votre serveur et localisez un dossier dans lequel vous voulez transfrer le fichier WAR. Par exemple, vous pouvez slectionner Fichiers IFS > Systme de fichiers racine > accueil > mon_rpertoire. Cliquez avec le bouton droit de la souris sur le rpertoire dans lequel vous voulez transfrer le fichier, puis slectionnez Coller. Le transfert de vos fichiers WAR et EAR sur votre systme de fichiers IBM i vous permet d'indiquer leur emplacement directement dans la console d'administration du serveur d'applications. Par exemple, si vous avez export votre projet WebFacing dans un fichier nomm wfproj.war et transfr le fichier dans MONSERVEUR > Fichiers IFS > Systme de fichiers racine > accueil > mon_rpertoire, vous pouvez indiquer le chemin d'accs de votre fichier WAR dans la bote de dialogue d'installation d'applications de la console d'administration (/accueil/mon_rpertoire/wfproj.war, par exemple).

Cration de ressources partages et mappage d'units rseau


Ce document fournit des informations de base sur la configuration d'une ressource partage sur le serveur IBM i et sur le mappage de l'identificateur d'unit d'un poste de travail sur cette ressource. Les ressources partages peuvent tre utilises pour transfrer des fichiers depuis votre poste de travail vers votre systme IBM i. Par exemple, vous pouvez les utiliser pour transfrer les fichiers WAR ou EAR crs lors de l'exportation d'un projet WebFacing depuis le plan de travail. Vous pouvez galement dployer les fichiers transfrer en utilisant l'explorateur de systmes distants ou FTP. Gnralement, la procdure est la suivante : 1. NetServer doit tre install sur votre serveur IBM i. Vous trouverez des informations sur NetServer sur le site d'iSeries NetServer. 2. NetServer tant install par dfaut sur de nombreux systmes, l'tape d'installation ne sera peut-tre pas ncessaire. Une fois que NetServer est install, vous devez le dmarrer. Pour lancer NetServer, tapez la commande STRTCPSVR *NETSVR sur la ligne de commande d'un serveur IBM i. 3. Une ressource partage doit tre cre dans le systme de fichiers intgr (IFS) IBM i pour qu'un identificateur d'unit de poste de travail puisse ensuite tre mapp sur cette ressource. Vous pouvez crer des ressources partages dans Operations Navigator du programme Client Access. Vous trouverez plus d'informations sur Client Access et Operations Navigator sur le site i5/OS V5R4 Information Center. Dans Operations Navigator, vous pouvez crer une ressource partage du rpertoire /QIBM. Pour cela, dans Operations Navigator, accdez au rpertoire /QIBM dans le systme IFS, cliquez avec le bouton droit de la souris sur /QIBM, puis slectionnez Sharing > New Share.

Chapitre 8. Test et dploiement des applications WebFacing

113

4. Mappez l'identificateur d'unit d'un poste de travail sur la ressource partage. Par exemple, si l'identificateur Q:\ est disponible sur votre poste de travail, vous pouvez mapper cet identificateur sur le rpertoire /QIBM du systme IFS. De cette manire, tous les fichiers WAS se trouvant dans un chemin d'accs au rpertoire, tel que /QIBM/DonnesUtilisateur/WebASAdv/<nom instance>/hte/hte_par_dfaut, sont accessibles via le rseau sur l'identificateur d'unit Q:\ de votre poste de travail via un chemin d'accs du type : Q:\DonnesUtilisateur\WebASAdv\<nom instance>\hte\ hte_par_dfaut\. Une fois qu'une ressource partage est cre, plusieurs mthodes sont possibles pour mapper un identificateur d'unit sur celle-ci. Plusieurs mthodes sont dcrites ci-aprs. Vous trouverez des informations supplmentaires dans la documentation NetServer et Client Access : v Dans le menu Dmarrer de Windows, slectionnez Rechercher > Autre option de recherche > Ordinateurs ; dans la zone relative au nom de l'ordinateur, entrez le nom de votre serveur IBM i. Lorsque le serveur est dtect, cliquez deux fois dessus et indiquez un nom d'utilisateur et un mot de passe valides pour y accder. Ensuite, explorez le systme de fichiers intgr du serveur qui contient le rpertoire /QIBM de WebSphere Application Server /QIBM pour lequel vous avez cr une ressource partage. Elle est rpertorie sous le nom que vous lui avez attribu dans la bote de dialogue New Share. Cliquez avec le bouton droit sur la ressource partage et slectionnez Connecter un lecteur rseau. Choisissez un identificateur d'unit disponible pour la ressource partage, par exemple Q : v Dans l'Explorateur Windows, slectionnez le menu Outils, puis l'option Connecter un lecteur rseau. Dans la bote de dialogue qui s'affiche, choisissez un identificateur d'unit pour le mappage, entrez \\<nom serveur IBM i>\<nom dossier> dans la zone de chemin d'accs, puis indiquez un nom d'utilisateur et un mot de passe valides. Une fois la connexion tablie, choisissez la ressource partage que vous avez cre l'aide d'Operations Navigator. v Pour mapper les ressources partages, vous pouvez galement utiliser la commande net use de Windows partir d'une fentre d'invite de commande Windows.

114

Dveloppement des applications WebFacing

Chapitre 9. Migration des projets WebFacing


Ces informations indiquent comment migrer vos projets WebFacing partir des versions prcdentes de l'outil IBM WebFacing. La migration est prise en charge partir de la version 6 ou suivante. Gnralement, vous devez migrer votre systme car la technologie sous-jacente a t modifie entre deux ditions. Par exemple, la prsence de nouvelles normes dans l'arborescence des applications Web peut ncessiter une rorganisation complte des vos projets d'une dition l'autre.

Migration de projets WebFacing


Les anciens projets doivent tre migrs pour pouvoir poursuivre le dveloppement de vos applications WebFacing. Par exemple, vous ne pouvez pas convertir du code source DDS ou modifier les proprits de votre projet. Cependant, vous pouvez excuter des projets non migrs. Afin de diffrencier les projets non migrs des projets jour, les projets non migrs sont identifis par des icnes uniques dans la vue Projets WebFacing. La migration d'un projet est divise en deux tapes. La premire tape est ralise par le produit de base pour tout projet Web. La seconde est ralise par l'assistant de migration WebFacing pour les mises jour spcifiques aux projets WebFacing. Important : v WebFacing ne prend en charge que les projets de migration version 7.0 et ultrieure. v Pour obtenir la liste des problmes connus et des rsolutions en rapport avec la migration, ainsi que des mises jour du processus de migration publies aprs la date de publication du prsent document, consultez la section Note technique sur la migration WebFacing.

Migration de base
A l'aide de IBM Installation Manager, commencez par vrifier que les derniers ensembles de correctifs et de mises jour pour tous les produits Rational sont installs. Cette tape est trs importante, car elle permet de vous pargner un grand nombre de problmes. Pour plus de dtails, voir les rubriques Mise jour des modules de produit installs l'adresse http://publib.boulder.ibm.com/ infocenter/radhelp/v8/index.jsp?topic=/com.ibm.rad.install.doc/topics/ t_update.html et Mise jour de l'installation du kit d'outils HATS l'adresse http://publib.boulder.ibm.com/infocenter/hatshelp/v80/topic/com.ibm.hats.doc/ doc/gsinstal.htm#update. Les projets WebFacing doivent tre chargs dans un espace de travail courant avant de pouvoir tre migrs par le biais de l'assistant de migration WebFacing. La migration est irrversible. Nous vous recommandons donc de sauvegarder votre espace de travail ou vos projets. Les prcdents projets WebFacing peuvent tre introduits dans l'espace de travail de niveau courant en ouvrant l'ancien espace de travail ou en important les anciens projets. Les projets existants peuvent tre directement imports partir des

115

dossiers ou fichiers archive, y compris les fichiers d'change du projet (Importer > Gnral > Projets existants dans l'espace de travail, puis slectionnez Slectionner le fichier archive). Une fois le projet ouvert dans l'espace de travail du niveau actuel, l'assistant de migration Rational Desktop Migration apparat. Il vous permet de slectionner les projets mettre jour et vous indique quels seront les fichiers modifis. Utilisez l'assistant pour raliser les modifications ncessaires puis cliquez sur Terminer pour lancer la migration du projet. Lorsque la migration de l'espace de travail est termine, les rsultats s'affichent dans la vue Rsultats de la migration. Pour plus de dtails, voir la rubrique Migration des espaces de travail et des projets l'adresse http://publib.boulder.ibm.com/infocenter/radhelp/v8/index.jsp?topic=/ com.ibm.etools.rad.migration.doc/topics/t_migratefrom70.html. Si les rsultats signalent des erreurs ou que le projet migr en comporte, voir Chapitre 10, Identification et rsolution des incidents dans les applications WebFacing, la page 121 ainsi que le document en ligne Note technique sur la migration WebFacing (mise jour rgulirement). Remarque : Vous pouvez ignorer la bote de dialogue qui apparat une fois que l'assistant de migration de l'espace de travail a termin. Cette erreur sera rsolue plus loin dans ce document. v La validation de la migration sest acheve avec des erreurs. Pour plus dinformations, voir la vue Rsultats de la migration. La vue Rsultats de la migration met en vidence des erreurs telles que celle-ci : La valeur WebSphere "WebSphere Web (Extended) 5.1" est incompatible avec lenvironnement dexcution WebSphere "WebSphere Application Server version X.Y. Aprs la migration de l'espace de travail, vous pouvez rinitialiser la perspective manuellement en cliquant sur Fentre > Rinitialiser la perspective. Vos projets peuvent maintenant tre utiliss dans le nouvel espace de travail. Cependant, ils doivent encore tre migrs avec l'assistant de migration WebFacing.

Utilisation de l'assistant de Migration WebFacing


Prparation d'un projet pour la migration WebFacing Vous devez raliser les tches prparatoires suivantes avant de lancer l'assistant de migration WebFacing. 1. Assurez-vous qu'un serveur valide est slectionn sur la page Environnements d'excution cible. Cette vrification est requise si le serveur cibl initialement n'est plus pris en charge. a. Dans la vue Navigateur, cliquez avec le bouton droit de la souris sur le projet et slectionnez Proprits. b. Ouvrez la page Environnements d'excution cible et slectionnez le niveau de serveur sur lequel sera excut le projet. c. Cliquez sur OK.

2. Si votre projet est au niveau Java EE 1.3, il doit tre migr vers le niveau 1.4 ou plus l'aide de l'assistant Migration des spcifications Java EE avant d'effectuer la migration WebFacing. Consultez la rubrique Migration du niveau

116

Dveloppement des applications WebFacing

de spcification de projets Java EE l'adresse http://publib.boulder.ibm.com/ infocenter/radhelp/v8/index.jsp?topic=/com.ibm.javaee.doc/topics/ tmgv6j2eewiz.html. Remarque : Si une bote de dialogue intitule Fichiers incohrents apparat lors de la migration Java EE, cliquez sur Oui pour la fermer. De mme, si le message La migration sest termine avec des erreurs apparat la fin de l'assistant, cliquez sur le bouton Dtails. Le message suivant peut tre ignor : Erreur : org.eclipse.core.runtime.CoreException : Le module de remplacement Runtime WebSphere Portal version 6.0 ne prend pas en charge la valeur de projet WebFacing 1.0. 3. Rsolvez toutes les erreurs du chemin d'accs aux classes de votre projet. a. Ouvrez la vue Problmes (Fentre > Afficher vue > Autre > Problmes). b. Vrifiez la prsence de chemins d'accs aux classes ou d'erreurs de gnration, par exemple : Le nom de classe ne peut pas tre rsolu [pour un type], Le projet ne peut pas tre gnr tant que les erreurs du chemin de gnration ne sont pas rsolues, ou Variable de chemin daccs aux classes non lie. c. Rsolvez ces erreurs comme dcrit dans la section Note technique sur la migration WebFacing. Excution de l'assistant de Migration WebFacing Puis, utilisez l'assistant Migration de WebFacing pour mettre jour vos projets vers la dernire version. Vous ne pouvez plus migrer les projets en reconvertissant les fichiers DDS. 1. Pour lancer l'assistant Migration de WebFacing, cliquez avec le bouton droit sur votre projet non migr dans la vue Projets de WebFacing et slectionnez Migrer le projet WebFacing. 2. Cliquez sur Terminer pour migrer le projet slectionn vers la version actuelle. 3. Cliquez sur OK si une bote de dialogue Rsultats apparat pour tre averti de la modification de la version de Struts de votre projet. 4. Si votre projet a t migr partir d'une version antrieure la version 7.5.0, il est recommand de reconvertir votre spcification de description de donnes, en particulier si vous envisagez d'utiliser le navigateur Firefox avec vos applications WebFacing. Remarque : Si le projet migr est compatible HATS/WebFacing, le projet HATS correspondant doit galement tre migr. Pour plus de dtails, voir Migration vers la version 8.0 de HATS. Les projets personnaliss peuvent ncessiter une intervention manuelle. Pour plus de dtails, voir Procdure manuelle de migration des projets avec des fichiers personnaliss, la page 118 et Prise en charge WebFacing de plusieurs navigateurs. Une licence HATS est ncessaire pour que les projets WebFacing migrs soient dploys, comme pour les nouveaux projets WebFacing. Si une licence HATS est dj applique, les projets migrs contiendront galement ce paramtre de licence. Pour plus d'informations, voir Activation des licences, la page 10.

Chapitre 9. Migration des projets WebFacing

117

Dsinstallation des versions antrieures du produit


Le processus d'installation ne dsinstalle pas automatiquement les versions antrieures du logiciel. Remarque importante : mme aprs avoir migr votre espace de travail, vous ne pourrez plus l'ouvrir avec une version antrieure de WebFacing. Avant de dsinstaller une version antrieure du produit, nous vous recommandons de noter l'emplacement de votre espace de travail, et d'en faire une copie de sauvegarde. Si vous ne sauvegardez pas votre espace de travail, vous risquez de perdre vos projets. Par dfaut, ces projets ne sont ni dsinstalls, ni supprims.

Procdure manuelle de migration des projets avec des fichiers personnaliss


Une fois la migration termine, les fichiers susceptibles de comporter une personnalisation auront des noms au format suivant : nomfichier_version_bak. Vos personnalisations seront ainsi prserves aprs la migration. Les projets personnaliss peuvent ncessiter une intervention manuelle. Pour plus de dtails, voir Prise en charge WebFacing de plusieurs navigateurs. Certains fichiers cran dans les projets crs avant la version 7.5.0 peuvent ncessiter une conversion aprs migration pour s'afficher dans le navigateur Firefox, comme les zones DSPF qui utilisent les valeurs de remplacement .CURRENTVALUE ou .REF pour leurs paramtres Web. Nous vous recommandons d'effectuer la conversion sur le projet WebFacing migr. Pour convertir une ressource unique, localisez et slectionnez le fichier d'aide DDS ou UIM dans la vue Projets WebFacing. Pour convertir l'intgralit du projet, localisez et slectionnez le projet dans la vue Projet WebFacing. Cliquez avec le bouton droit de la souris, puis slectionnez Convertir. Si vous avez personnalis votre projet WebFacing, vous devrez sans doute fusionner vos personnalisations des fichiers d'origine dans les fichiers suivants : v apparea.css v chrome\stylename.css v PageBuilder.jsp v CmdKeys.jsp v MenuKeys.jsp (non disponible dans tous les styles) v logon.jsp v index.jsp v rtmessages.properties v Si le projet prcdent utilisait Web Site Designer, les fichiers suivants doivent tre mis jour : \WebContent\index.jsp \WebContent\INV1.jsp \WebContent\INV2.jsp \WebContent\theme\WFB_blue.jtpl Remarque : Si le projet Web migr est compatible HATS/WebFacing, le projet HATS correspondant doit tre migr galement.

118

Dveloppement des applications WebFacing

Rendu des styles dans les navigateurs


Selon les navigateurs, le rendu des styles est diffrent. Quelques modifications ont t apportes aux styles d'IBM de manire ce qu'ils soient compatibles avec le navigateur Firefox. Lorsque vous crez un nouveau projet WebFacing, les styles intgrent ces modifications. Cependant, lorsque vous migrez un projet existant cr avant la version 7.5.0 qui utilise un style IBM, les cinq fichiers qui dfinissent le style sont sauvegards (s'ils sont retrouvs) et remplacs par les nouveaux. Ces cinq fichiers sont les suivants : v stylename.css v appearea.css v PageBuilder.jsp v CmdKeys.jsp v MenuKeys.jsp (non disponible dans tous les styles) Il est ncessaire que vous compariez les nouveaux fichiers de style avec les anciens et que vous fusionniez les modifications apportes. Si vous n'utilisez pas de style IBM ou que vous disposez de modifications de style supplmentaires, vous devez intgrer lesdites modifications manuellement. Pour dfinir quelles sont les modifications apportes aux nouveaux fichiers, comparez les anciens fichiers de style avec les fichiers mis jour. Les modifications apportes sont les suivantes : v Toutes les valeurs doivent comporter des units. Dans Internet Explorer, ces valeurs sont considres comme tant des pixels, sauf lorsque qu'une autre valeur est dfinie. Par exemple :
.launchbutton { border-color:black; border-width:1px; text-align:right; }

v Pour certains styles IBM, la syntaxe spcifie pour les marges n'est pas correcte. Internet Explorer accepte cette syntaxe, Firefox non. Par exemple, dans le fichier stylename.css, les virgules de margin : 0px,0px,0px,0px; ont t supprimes : margin : 0px 0px 0px 0px;. Lorsque les quatre marges ont des paramtres identiques, la modification est la suivante : margin : 0px;. v Les expressions CSS uniquement valides avec Internet Explorer (en italique dans l'exemple ci-dessous) ont t supprimes de la classe .wf_layer et remplaces par la couleur d'arrire-plan du corps (en gras dans l'exemple ci-dessous):
.wf_layer { background-image:expression(document.body.currentStyle.backgroundImage); background-color:expression(document.body.currentStyle.backgroundColor); background-repeat:expression(document.body.currentStyle.backgroundRepeat); background-attachment: expression(document.body.currentStyle.backgroundAttachment); background-color: #E3C993; }

v La notation cursor: hand; a t change en cursor: pointer; Pour que les applications WebFacing s'affichent correctement lorsqu'elles sont rendues par le biais d'une dfinition de type de document unique, des modifications supplmentaires doivent tre apportes aux fichiers suivants : v apparea.css :
SPAN.wf_field { width: 100%; border-style: none; display: inline-block; //for all browsers
Chapitre 9. Migration des projets WebFacing

119

display: -moz-inline-block; //for Firefox 2} .scrollbarUpArrow { background-color: transparent; background-image: url("UpArrow.gif"); background-position: bottom; background-repeat: no-repeat; width: 16px; height: 16px; } .scrollbarDownArrow { background-color: transparent; background-image: url("DownArrow.gif"); background-position: top; background-repeat: no-repeat; width: 16px; height: 16px; } .scrollbarSlider { background-color: #73a2bd; background-image: url("CurrentSegment.gif"); background-repeat: repeat-y; } .scrollbarBackground { background-color: transparent; background-image: url("segment.gif"); width: 16px; height: 100%; background-repeat: repeat-y; }

v PageBuilder.jsp La hauteur de certains styles pour lesquels les lments de la page doivent remplir l'espace vertical est ajoute :
<html <wf:lang text="lang="/> style="height:100%"> <head> ... <head> <body style="height:100%"> ...

Incidents et remarques relatifs la migration des paramtres Web


Dans les projets WebFacing, la zone d'entre .value est traite comme une valeur par dfaut et n'est pas mise entre guillemets. Cela est spcifi dans le fichier config\conversion.rules :
<WebSetting> <ValueMigration option="INITIALVALUE"></ValueMigration> <INITIALVALUETransform type="unquoted"></INITIALVALUETransform> </WebSetting>

Le peaufinage de ces paramtres et leur reconversion produiront des rsultats diffrents.

120

Dveloppement des applications WebFacing

Chapitre 10. Identification et rsolution des incidents dans les applications WebFacing
Les informations fournies dans la prsente section facilitent l'identification des incidents qui se produisent dans les applications WebFacing. Vous pouvez galement cliquer sur les liens suivants afin d'obtenir plus d'informations. Conseils pour identifier des incidents dans WebFacing Modifications du logiciel associ l'outil WebFacing Configuration du serveur WebFacing Chapitre 11, Outil WebFacing -- Prise en charge actuelle des mots cls DDS, la page 139 v Rgles relatives aux applications HATS/WebFacing, la page 96 v Paramtres Web, la page 61 v v v v Pour plus d'informations sur l'identification des incidents, ainsi que des conseils d'aide et des mises jour, consultez les Documents de support spcifiques WebFacing en ligne. Avant de contacter le service de support IBM, veuillez lire la section Collecte de donnes pour les applications IBM i WebFacing.

Collecte de donnes pour les applications WebFacing


Si vous suspectez un incident avec WebFacing, veuillez tout d'abord lire la section sur l'identification des incidents WebFacing et visiter les liens qui s'y rapportent. Le fait de collecter les informations suivantes permettra au service de support IBM d'effectuer un meilleur diagnostic et de rsoudre les incidents. 1. Une description claire du symptme, accompagne de captures d'cran reproduisant des instructions, des solutions possibles s'il y en a, ou tout autre document. 2. La version du projet WebFacing. A partir de la vue Projets WebFacing, cliquez avec le bouton droit de la souris sur le projet WebFacing et slectionnez Vue Journal. L'onglet de prsentation du journal contient toutes les informations ncessaires sur la version. 3. Des informations d'excution, s'il y a lieu : v Les journaux de travail de tous les travaux QQF : QQFWFSVR, QQFVTSVR et le(s) travail (travvaux) d'intrt QQF#. v Le fichier journal Eclipse .log trouv dans le dossier .metadata de votre espace de travail. v Les journaux de WebSphere Application Server.

Copyright IBM Corp. 1992, 2011

121

Rfrence associe Prise en charge de la consignation des vnements de base communs pour les applications WebFacing, la page 133

Impossible d'excuter l'application WebFacing partir d'une version antrieure


Les projets WebFacing dvelopps avec des versions antrieures doivent faire l'objet d'une migration correcte. Suivez les instructions fournies dans Migration de projets WebFacing, la page 115. Vous pouvez aussi faire un enregistrement de vos anciens projets et de votre espace de travail avant la migration. Vous devez galement vrifier que les licences sont actives pour l'dition en cours. Pour plus d'informations, voir Activation des licences, la page 10.

Dmarrage de l'application impossible


L'application ne dmarre pas lorsque vous cliquez sur le lien de la page index.jsp. En fait, le navigateur affiche la page sans gnrer de message d'erreur alors que l'application est bloque. Le programme a probablement rencontr un problme avec un ou plusieurs des lments suivants : v Liste des bibliothques v Nom de la commande d'appel prcise dans le projet WebFacing v Configuration de l'hte IBM i Utilisation d'un ID utilisateur aux privilges limits Incohrence entre les niveaux PTF et le niveau d'excution WebFacing Observez la console du serveur d'applications. Si elle n'affiche pas la page Pagebuilder.jsp que vous tentez d'appeler, cela signifie certainement que le programme est introuvable sur le systme hte IBM i. Commencez par dterminer si la commande que vous avez prcise dans le projet WebFacing et l'ID utilisateur que vous avez utilis pour vous connecter l'application WebFacing utilisent un environnement 5250. Pour ce faire, ouvrez une session d'mulation 5250 : 1. Ouvrez la session en utilisant l'ID et le mot de passe utilisateur que vous avez utiliss dans le projet WebFacing pour dmarrer l'application WebFacing. 2. Sur la ligne de commande 5250, tapez la commande que vous avez prcise dans le projet WebFacing. Si vous ne parvenez pas ouvrir l'application dans l'environnement 5250, cela signifie que la liste des bibliothques, ou la commande, est incorrecte : 1. Vrifiez scrupuleusement l'application et faites en sorte qu'elle puisse s'ouvrir dans l'environnement 5250. 2. Dmarrez l'application WebFacing en respectant les mmes paramtres. Slectionnez l'option Proprits WebFacing pour modifier l'ID et le mot de passe utilisateur dans le projet WebFacing, le cas chant.

122

Dveloppement des applications WebFacing

Si vous devez modifier la commande d'appel, slectionnez l'assistant Projet WebFacing pour remplacer l'entre existante par une autre. Pour utiliser l'assistant Projet WebFacing : v Placez-vous dans la vue Projets WebFacing. v Dveloppez le projet WebFacing. v Cliquez avec le bouton droit de la souris sur le noeud Commandes CL, puis slectionnez Ajouter. v Sur la page Entre de commandes CL, slectionnez la commande CL dans la liste Commande CL, puis cliquez sur Supprimer. v Dans la zone Commande CL, tapez la nouvelle commande et cliquez sur Ajouter. v Cliquez sur Fin. v Redmarrez le serveur et l'application. Si la commande fonctionnait parfaitement dans l'environnement 5250 et que le programme avait russi dmarrer l'application, parcourez le journal du travail WebFacing. Il figure sous le noeud Travaux IBM i dans l'explorateur de systmes loigns. Sinon, vous pouvez ouvrir une session 5250 et excuter la commande WRKACTJOB (Utiliser un travail actif). Recherchez le travail QQF commenant par l'ID utilisateur que vous utilisez et consultez le journal correspondant. Si le travail QQF est introuvable, il se peut qu'il soit termin. Dans ce cas, excutez la commande WRKSPLF (Utiliser un fichier spoule) avec l'ID utilisateur que vous avez utilis dans l'application WebFacing pour savoir si certains journaux du travail termin renferment des informations complmentaires.

Contrle du niveau PTF WebFacing


Vrifiez que le dernier niveau de modification provisoire du logiciel (PTF) est bien appliqu sur le systme hte IBM i. Pour plus d'informations, voir WebFacing Tool PTFs. Si le niveau n'est pas jour, chargez et appliquez les niveaux de modification provisoire du logiciel avant de redmarrer le serveur WebFacing : 1. Terminez le serveur WebFacing (ENDTCPSVR *WEBFACING) 2. Chargez et appliquez les niveaux de modification provisoire du logiciel souhaits 3. Dmarrez le serveur WebFacing (STRTCPSVR *WEBFACING) Rexcutez l'application WebFacing. Rubriques connexes Prsence d'un problme li l'utilisation d'ID utilisateur aux privilges limits, la page 124 Un ID utilisateur aux privilges limits sur IBM i est un ID utilisateur dont le paramtre LIMIT CAPABILITIES (LMTCPB) est dfini sur *YES ou *PARTIAL. WebFacing ne prend en charge que les utilisateurs aux privilges limits sur IBM i version 6.1 et plus. Dmarrage du serveur WebFacing impossible, la page 125 Si le programme gnre un message d'erreur lorsque vous cliquez sur le lien pour appeler l'application WebFacing, consultez le descriptif figurant sous le message : il dtaille les causes possibles du problme. Gnralement, le programme indique que le serveur WebFacing n'a pas t dmarr.

Chapitre 10. Identification et rsolution des incidents dans les applications WebFacing

123

Impossible d'afficher cette page, la page 127 Gnralement, le programme gnre ce message d'erreur si le serveur d'applications rencontre un problme ou que l'URL entre est incorrect. Impossible d'afficher cette page, la page 127 Gnralement, le programme gnre ce message d'erreur si le projet WebFacing est endommag, si le projet WebFacing n'a pas t install correctement ou si l'URL utilise est incorrecte. Session incorrecte, la page 129 L'environnement Web n'utilise pas de connexions permanentes entre le navigateur et le serveur HTTP. Si vous excutez l'application WebFacing sans utiliser le navigateur pendant une priode prolonge, la session de l'application risque d'expirer. Incohrence entre le membre source DDS et le projet WebFacing, la page 130 Si vous modifiez le membre source DDS du fichier cran et recompilez le programme pour qu'il utilise le fichier cran modifi, vous devrez galement reconvertir le membre source DDS pour crer les fichiers JSP et XML correspondants dans le projet WebFacing.

Prsence d'un problme li l'utilisation d'ID utilisateur aux privilges limits


Un ID utilisateur aux privilges limits sur IBM i est un ID utilisateur dont le paramtre LIMIT CAPABILITIES (LMTCPB) est dfini sur *YES ou *PARTIAL. WebFacing ne prend en charge que les utilisateurs aux privilges limits sur IBM i version 6.1 et plus. Le problme peut tre vit pour les versions du systme d'exploitation IBM i antrieures la version 6.1. Consultez la page Utilisation d'un ID utilisateur LMTCPB avec WebFacing afin d'obtenir plus d'informations. Rubriques connexes Dmarrage de l'application impossible, la page 122 L'application ne dmarre pas lorsque vous cliquez sur le lien de la page index.jsp. En fait, le navigateur affiche la page sans gnrer de message d'erreur alors que l'application est bloque. Dmarrage du serveur WebFacing impossible, la page 125 Si le programme gnre un message d'erreur lorsque vous cliquez sur le lien pour appeler l'application WebFacing, consultez le descriptif figurant sous le message : il dtaille les causes possibles du problme. Gnralement, le programme indique que le serveur WebFacing n'a pas t dmarr. Impossible d'afficher cette page, la page 127 Gnralement, le programme gnre ce message d'erreur si le serveur d'applications rencontre un problme ou que l'URL entre est incorrect. Impossible d'afficher cette page, la page 127 Gnralement, le programme gnre ce message d'erreur si le projet WebFacing est endommag, si le projet WebFacing n'a pas t install correctement ou si l'URL utilise est incorrecte. Session incorrecte, la page 129 L'environnement Web n'utilise pas de connexions permanentes entre le navigateur et le serveur HTTP. Si vous excutez l'application WebFacing sans utiliser le navigateur pendant une priode prolonge, la session de l'application risque d'expirer.

124

Dveloppement des applications WebFacing

Incohrence entre le membre source DDS et le projet WebFacing, la page 130 Si vous modifiez le membre source DDS du fichier cran et recompilez le programme pour qu'il utilise le fichier cran modifi, vous devrez galement reconvertir le membre source DDS pour crer les fichiers JSP et XML correspondants dans le projet WebFacing.

Dmarrage du serveur WebFacing impossible


Si le programme gnre un message d'erreur lorsque vous cliquez sur le lien pour appeler l'application WebFacing, consultez le descriptif figurant sous le message : il dtaille les causes possibles du problme. Gnralement, le programme indique que le serveur WebFacing n'a pas t dmarr. Excutez la commande STRTCPSVR (Dmarrer le serveur TCP/IP) pour dmarrer le serveur WebFacing.
STRTCPSVR *WEBFACING

Remarque : Assurez-vous que la valeur systme IBM i QAUTVRT est suprieure 0. Puisque le serveur WebFacing repose sur les tches du terminal virtuel, vous devez vrifier que cette valeur systme est dfinie de faon ce que toutes les sessions WebFacing soient prises en charge. Le programme gnrera le mme message si le serveur IBM i que vous avez indiqu n'existe pas. Consultez les proprits du projet WebFacing pour vrifier que le nom du serveur est correct. Faites dfiler le reste du message d'erreur pour connatre l'identit du systme hte IBM i auquel l'application tente d'accder et le numro de port utilis pour la connexion au serveur WebFacing. Vrifiez que les valeurs sont correctes. Par dfaut, le numro de port du serveur WebFacing est 4004. Excutez la commande suivante pour vrifier les numros de port :
NETSTAT *CNN

Appuyez sur F14 pour afficher les numros de port et utilisez l'option 8 pour connatre les travaux qui utilisent le numro de port 4004. Cela doit afficher un travail (QQFWFSVR). Cela signifie que le serveur WebFacing utilise le numro de port 4004. Si le travail affich n'est pas QQFWFSVR, alors le serveur WebFacing n'utilise pas le numro de port 4004. Dans ce cas, procdez comme suit : v Vrifiez le numro de port utilis par le serveur WebFacing en excutant la commande WRKSRVTBLE (Utiliser la table de services). v Dans la liste, recherchez une entre de service libelle "as-WebFacing". Si elle existe, utilisez l'option display pour afficher le numro de port utilis. Remarque : Si aucun service n'utilise le numro de port par dfaut 4004, cela signifie que vous n'avez pas besoin de changer le numro de port. Si deux travaux QQF existent : v Parcourez le journal des deux travaux. v En cas d'erreurs, vrifiez le niveau PTF. Si le serveur est dot des derniers niveaux de modification du logiciel WebFacing, il se peut qu'il y ait un problme. Dans ce cas, contactez le support technique IBM.
Chapitre 10. Identification et rsolution des incidents dans les applications WebFacing

125

Comment savoir si le serveur WebFacing a rpondu une requte ?


Pour savoir si le serveur WebFacing du systme hte IBM i a rpondu une requte, il suffit de contrler le dlai d'inactivit figurant dans la liste Gestion des tats de connexion TCP. Si le dlai d'inactivit est quasiment nul et si vous tes le seul utilisateur excuter les applications WebFacing, cela signifie que le serveur WebFacing a bien reu la dernire requte ; les journaux des travaux devraient vous aider localiser le problme. Si le dlai d'inactivit est lev, cela signifie que la requte n'est pas parvenue au serveur WebFacing. Vrifiez le nom du serveur IBM i indiqu dans le projet WebFacing et contrlez l'authentification. Vous pouvez essayer de dsactiver l'authentification automatique dans les proprits du projet WebFacing pour forcer l'affichage de la bote de dialogue d'ouverture de session. L'apparition de cette bote de dialogue vous prouve que vous avez russi contacter le serveur IBM i et que vous pouvez contrler l'environnement du serveur WebFacing (voir remarques prcdentes). Rubriques connexes Dmarrage de l'application impossible, la page 122 L'application ne dmarre pas lorsque vous cliquez sur le lien de la page index.jsp. En fait, le navigateur affiche la page sans gnrer de message d'erreur alors que l'application est bloque. Prsence d'un problme li l'utilisation d'ID utilisateur aux privilges limits, la page 124 Un ID utilisateur aux privilges limits sur IBM i est un ID utilisateur dont le paramtre LIMIT CAPABILITIES (LMTCPB) est dfini sur *YES ou *PARTIAL. WebFacing ne prend en charge que les utilisateurs aux privilges limits sur IBM i version 6.1 et plus. Impossible d'afficher cette page, la page 127 Gnralement, le programme gnre ce message d'erreur si le serveur d'applications rencontre un problme ou que l'URL entre est incorrect. Impossible d'afficher cette page, la page 127 Gnralement, le programme gnre ce message d'erreur si le projet WebFacing est endommag, si le projet WebFacing n'a pas t install correctement ou si l'URL utilise est incorrecte. Session incorrecte, la page 129 L'environnement Web n'utilise pas de connexions permanentes entre le navigateur et le serveur HTTP. Si vous excutez l'application WebFacing sans utiliser le navigateur pendant une priode prolonge, la session de l'application risque d'expirer. Incohrence entre le membre source DDS et le projet WebFacing, la page 130 Si vous modifiez le membre source DDS du fichier cran et recompilez le programme pour qu'il utilise le fichier cran modifi, vous devrez galement reconvertir le membre source DDS pour crer les fichiers JSP et XML correspondants dans le projet WebFacing.

126

Dveloppement des applications WebFacing

Impossible d'afficher cette page


Gnralement, le programme gnre ce message d'erreur si le serveur d'applications rencontre un problme ou que l'URL entre est incorrect. Si vous recevez ce message d'erreur : v Vrifiez que le serveur d'applications est bien dmarr. v Si le serveur d'applications n'est pas dmarr, dmarrez-le. v Si le serveur d'applications est dj dmarr, arrtez-le. Le serveur d'applications a probablement rencontr un problme. En le redmarrant, vous le rinitialiserez. Fermez le navigateur et essayez de redmarrer l'application. Rubriques connexes Dmarrage de l'application impossible, la page 122 L'application ne dmarre pas lorsque vous cliquez sur le lien de la page index.jsp. En fait, le navigateur affiche la page sans gnrer de message d'erreur alors que l'application est bloque. Prsence d'un problme li l'utilisation d'ID utilisateur aux privilges limits, la page 124 Un ID utilisateur aux privilges limits sur IBM i est un ID utilisateur dont le paramtre LIMIT CAPABILITIES (LMTCPB) est dfini sur *YES ou *PARTIAL. WebFacing ne prend en charge que les utilisateurs aux privilges limits sur IBM i version 6.1 et plus. Dmarrage du serveur WebFacing impossible, la page 125 Si le programme gnre un message d'erreur lorsque vous cliquez sur le lien pour appeler l'application WebFacing, consultez le descriptif figurant sous le message : il dtaille les causes possibles du problme. Gnralement, le programme indique que le serveur WebFacing n'a pas t dmarr. Impossible d'afficher cette page Gnralement, le programme gnre ce message d'erreur si le projet WebFacing est endommag, si le projet WebFacing n'a pas t install correctement ou si l'URL utilise est incorrecte. Session incorrecte, la page 129 L'environnement Web n'utilise pas de connexions permanentes entre le navigateur et le serveur HTTP. Si vous excutez l'application WebFacing sans utiliser le navigateur pendant une priode prolonge, la session de l'application risque d'expirer. Incohrence entre le membre source DDS et le projet WebFacing, la page 130 Si vous modifiez le membre source DDS du fichier cran et recompilez le programme pour qu'il utilise le fichier cran modifi, vous devrez galement reconvertir le membre source DDS pour crer les fichiers JSP et XML correspondants dans le projet WebFacing.

Impossible d'afficher cette page


Gnralement, le programme gnre ce message d'erreur si le projet WebFacing est endommag, si le projet WebFacing n'a pas t install correctement ou si l'URL utilise est incorrecte.

Chapitre 10. Identification et rsolution des incidents dans les applications WebFacing

127

Vrifiez que la page index.jsp existe bien dans le projet WebFacing : 1. Dans la vue Navigateur, recherchez le fichier index.jsp dans le dossier WebContent du projet. 2. Si le fichier reste introuvable, recompilez le projet WebFacing. Vrifiez le fichier web.xml, qui renferme tous les dtails du projet. En effet, le programme peut gnrer ce message d'erreur si le fichier n'a pas t cr correctement. 1. Dans la vue Navigateur, dveloppez WebContent > WEB-INF et cliquez deux fois sur le fichier web.xml. 2. Vrifiez que la liste Servlets et JSP comprend des servlets WebFacing. 3. Si la liste est dpourvue de servlets, cela signifie que le projet est endommag. Essayez de recompiler le projet WebFacing. Si le fichier index.jsp existe et si le fichier web.xml semble correct, cela signifie que l'application n'a probablement pas t installe correctement. Dans l'environnement de test : 1. Arrtez le serveur d'applications. 2. Publiez le serveur. 3. Vrifiez que le programme gnre bien un message de russite. 4. Redmarrez le serveur. 5. Essayez d'excuter l'application. Si vous utilisez un serveur d'applications loign sur un systme hte IBM i ou une autre plateforme ne rsidant pas sur le poste de travail : 1. Vrifiez que l'application est correctement installe, puis utilisez la console du serveur d'applications pour contrler que l'installation est conforme. 2. Vrifiez que l'application est bien dmarre. 3. Redmarrez le serveur pour vrifier qu'il slectionne bien les informations concernant l'application. 4. Redmarrez le serveur d'applications. Rubriques connexes Dmarrage de l'application impossible, la page 122 L'application ne dmarre pas lorsque vous cliquez sur le lien de la page index.jsp. En fait, le navigateur affiche la page sans gnrer de message d'erreur alors que l'application est bloque. Prsence d'un problme li l'utilisation d'ID utilisateur aux privilges limits, la page 124 Un ID utilisateur aux privilges limits sur IBM i est un ID utilisateur dont le paramtre LIMIT CAPABILITIES (LMTCPB) est dfini sur *YES ou *PARTIAL. WebFacing ne prend en charge que les utilisateurs aux privilges limits sur IBM i version 6.1 et plus. Dmarrage du serveur WebFacing impossible, la page 125 Si le programme gnre un message d'erreur lorsque vous cliquez sur le lien pour appeler l'application WebFacing, consultez le descriptif figurant sous le message : il dtaille les causes possibles du problme. Gnralement, le programme indique que le serveur WebFacing n'a pas t dmarr. Impossible d'afficher cette page, la page 127 Gnralement, le programme gnre ce message d'erreur si le serveur d'applications rencontre un problme ou que l'URL entre est incorrect.

128

Dveloppement des applications WebFacing

Session incorrecte L'environnement Web n'utilise pas de connexions permanentes entre le navigateur et le serveur HTTP. Si vous excutez l'application WebFacing sans utiliser le navigateur pendant une priode prolonge, la session de l'application risque d'expirer. Incohrence entre le membre source DDS et le projet WebFacing, la page 130 Si vous modifiez le membre source DDS du fichier cran et recompilez le programme pour qu'il utilise le fichier cran modifi, vous devrez galement reconvertir le membre source DDS pour crer les fichiers JSP et XML correspondants dans le projet WebFacing.

Session incorrecte
L'environnement Web n'utilise pas de connexions permanentes entre le navigateur et le serveur HTTP. Si vous excutez l'application WebFacing sans utiliser le navigateur pendant une priode prolonge, la session de l'application risque d'expirer. Dans cet environnement, le serveur ne peut pas dterminer si une session a t interrompue de manire permanente suite l'apparition de problmes de communication ou en raison du serveur WebSphere Application Server proprement dit. Pour limiter le nombre de sessions incorrectes, le systme limite 30 minutes le dlai d'expiration par dfaut des sessions sur le serveur d'applications. Par dfaut, les sessions sont dsactives aprs un dlai d'inactivit suprieur 30 minutes. Si vous tentez d'utiliser la session aprs 30 minutes d'inactivit, le programme gnrera le message d'erreur suivant : Si l'intervalle de 30 minutes ne convient pas votre environnement, vous pouvez modifier les paramtres du serveur d'applications via la console d'administration et remplacer les dlais d'inactivit. Rubriques connexes Dmarrage de l'application impossible, la page 122 L'application ne dmarre pas lorsque vous cliquez sur le lien de la page index.jsp. En fait, le navigateur affiche la page sans gnrer de message d'erreur alors que l'application est bloque. Prsence d'un problme li l'utilisation d'ID utilisateur aux privilges limits, la page 124 Un ID utilisateur aux privilges limits sur IBM i est un ID utilisateur dont le paramtre LIMIT CAPABILITIES (LMTCPB) est dfini sur *YES ou *PARTIAL. WebFacing ne prend en charge que les utilisateurs aux privilges limits sur IBM i version 6.1 et plus. Dmarrage du serveur WebFacing impossible, la page 125 Si le programme gnre un message d'erreur lorsque vous cliquez sur le lien pour appeler l'application WebFacing, consultez le descriptif figurant sous le message : il dtaille les causes possibles du problme. Gnralement, le programme indique que le serveur WebFacing n'a pas t dmarr. Impossible d'afficher cette page, la page 127 Gnralement, le programme gnre ce message d'erreur si le serveur d'applications rencontre un problme ou que l'URL entre est incorrect. Impossible d'afficher cette page, la page 127 Gnralement, le programme gnre ce message d'erreur si le projet WebFacing est endommag, si le projet WebFacing n'a pas t install correctement ou si l'URL utilise est incorrecte.
Chapitre 10. Identification et rsolution des incidents dans les applications WebFacing

129

Incohrence entre le membre source DDS et le projet WebFacing Si vous modifiez le membre source DDS du fichier cran et recompilez le programme pour qu'il utilise le fichier cran modifi, vous devrez galement reconvertir le membre source DDS pour crer les fichiers JSP et XML correspondants dans le projet WebFacing.

Incohrence entre le membre source DDS et le projet WebFacing


Si vous modifiez le membre source DDS du fichier cran et recompilez le programme pour qu'il utilise le fichier cran modifi, vous devrez galement reconvertir le membre source DDS pour crer les fichiers JSP et XML correspondants dans le projet WebFacing. Dans le cas contraire, vous pouvez recevoir une erreur d'application (avec les messages d'erreur WF0096 et WF0100) lorsque l'cran modifi aurait d s'afficher. Lorsqu'un cran est soumis et qu'une modification a t apporte la dfinition du tampon d'entre, une erreur MCH1236 peut tre gnre depuis/vers QWSGET dans le travail utilisateur. Pour corriger l'une ou l'autre de ces erreurs, vous devez vous assurer que la version de la source DDS l'aide de laquelle l'objet fichier cran a t cr est identique celle de la source DDS convertie pour l'application WebFacing. Si la version de l'cran en mode caractres de l'application fonctionne correctement, il suffit de reconvertir les membres DDS ayant t modifis. Ce problme peut aussi se produire si plus d'un objet "fichier cran" portant le mme nom est utilis. Dans ce cas, le mappage d'objets DDS devra tre mis jour manuellement afin de dfinir de manire explicite la bibliothque dans le mappage des nombreux fichiers d'cran au lieu d'utiliser le mappage de nom de fichier cran par dfaut. Vous pouvez rencontrer ce problme si l'opration de publication a chou. Pour rsoudre cette erreur, arrtez le serveur d'applications, publiez le projet une nouvelle fois et redmarrez le serveur d'applications. Rubriques connexes Dmarrage de l'application impossible, la page 122 L'application ne dmarre pas lorsque vous cliquez sur le lien de la page index.jsp. En fait, le navigateur affiche la page sans gnrer de message d'erreur alors que l'application est bloque. Prsence d'un problme li l'utilisation d'ID utilisateur aux privilges limits, la page 124 Un ID utilisateur aux privilges limits sur IBM i est un ID utilisateur dont le paramtre LIMIT CAPABILITIES (LMTCPB) est dfini sur *YES ou *PARTIAL. WebFacing ne prend en charge que les utilisateurs aux privilges limits sur IBM i version 6.1 et plus. Dmarrage du serveur WebFacing impossible, la page 125 Si le programme gnre un message d'erreur lorsque vous cliquez sur le lien pour appeler l'application WebFacing, consultez le descriptif figurant sous le message : il dtaille les causes possibles du problme. Gnralement, le programme indique que le serveur WebFacing n'a pas t dmarr. Impossible d'afficher cette page, la page 127 Gnralement, le programme gnre ce message d'erreur si le serveur d'applications rencontre un problme ou que l'URL entre est incorrect.

130

Dveloppement des applications WebFacing

Impossible d'afficher cette page, la page 127 Gnralement, le programme gnre ce message d'erreur si le projet WebFacing est endommag, si le projet WebFacing n'a pas t install correctement ou si l'URL utilise est incorrecte. Session incorrecte, la page 129 L'environnement Web n'utilise pas de connexions permanentes entre le navigateur et le serveur HTTP. Si vous excutez l'application WebFacing sans utiliser le navigateur pendant une priode prolonge, la session de l'application risque d'expirer.

L'environnement de test WAS ne peut pas dmarrer correctement l'application WebFacing si le chemin d'accs l'espace de travail utilis est trop long
Vous pouvez rencontrer un problme avec les projets WebFacing qui ne s'excutent pas dans l'environnement de test WebSphere. La console affiche une erreur telle que : 6cb33777 SystemOut O Exception in generateFieldAttributes : java.io.FileNotFoundException: (Le systme ne peut pas trouver le chemin indiqu) Limitation du serveur lie au transport de noms de rpertoires longs. Si vous utilisez un espace de travail dans un rpertoire ayant un chemin d'accs long ou si vous choisissez des noms de projets longs, vous pouvez voir ce message d'erreur apparatre quand vous dmarrez un serveur ou quand vous testez des fichiers sur un serveur. Vous pouvez effectuer l'une des actions suivantes : v Dplacez votre espace de travail vers un emplacement ayant un chemin d'accs plus court, par exemple C:/espacedetravail. v Donnez votre projet d'applications d'entreprise ou un autre projet un nom plus court.

Une racine de contexte contenant un espace ne fonctionne pas sur l'environnement de test WAS
En raison de la non-conformit des spcifications Java EE, il ne faut pas mettre d'espace dans les racines de contexte.

Solution
Si vous souhaitez utiliser un caractre spcial ou un espace dans le nom de votre projet, vous devez vous assurer que sa racine de contexte n'en contient pas. Pour ce faire, slectionnez la vue navigateur dans la perspective WebFacing, cliquez avec le bouton droit de la souris sur le projet, slectionnez les proprits et modifiez la racine de contexte dans la page Paramtres de projet Web. Cette tape est ncessaire si vous voulez excuter les environnements de test WebSphere.

L'application ne fonctionne pas correctement avec le paramtre RSTDSP dfini sur *NO
Les applications WebFacing ne fonctionnent pas correctement lorsque le paramtre RSTDSP des fichiers cran est dfini sur *NO.

Chapitre 10. Identification et rsolution des incidents dans les applications WebFacing

131

RSTDSP est un paramtre de la commande de cration du fichier cran (CRTDSPF) ou de modification du fichier cran (CHGDSPF). Il indique si les donnes que le fichier cran affiche l'cran sont enregistres au moment o le fichier est interrompu (rendu temporairement inactif) afin d'utiliser un fichier cran diffrent pour afficher d'autres donnes sur le mme priphrique. Si les donnes sont enregistres, elles sont restaures et affichs sur le priphrique quand le fichier est de nouveau actif. Lorsque le paramtre de restauration d'affichage (RSTDSP) est dfini sur *YES, alors une image de l'affichage en cours est enregistre quand l'affichage est interrompu. Quand le fichier cran est de nouveau actif, l'application utilise l'image enregistre pour restaurer le dernier affichage juste avant l'interruption. Selon la programmation d'affichage de l'application, le paramtre RSTDSP(*YES) doit tre dfini par les mots cls suivants. Si le paramtre n'est pas dfini, alors les donnes l'cran seront perdues si le fichier est interrompu. Assurez-vous que les enregistrements sur l'cran sont bien les enregistrements auxquels les mots cls se rapportent. Si le fichier cran est interrompu, vous devez restaurer les donnes l'cran afin que les oprations d'criture sur les formats d'enregistrement utilisant ces mots cls soient valides. v CLRL v OVERLAY v PUTOVR v PUTRETAIN v ERRMSG v ERRMSGID Si le paramtre RSTDSP du fichier cran est dfini sur *NO, WebFacing n'a pas d'enregistrement du dernier affichage du fichier cran restaurer. Cela produirait une exception IndexOutOfBoundsException dans la plupart des cas. Dans d'autres cas, l'application peut rester intacte. Cependant, vous pouvez voir des affichages diffrents de l'interface 5250; par exemple, vous pouvez rencontrer un chevauchement de fentres dans WebFacing. Si vous rencontrez ces problmes, assurez-vous que le paramtre RSTDSP est bien dfini sur *YES pour les fichiers cran utiliss dans l'application.

Des lments en position absolue apparaissent des emplacements imprvus dans WebFacing
Des lments qui avaient t personnaliss avec une proprit de position absolue s'affichent dans des emplacements imprvus aprs la migration. WebFacing comprend une option permettant de positionner des lments DDS utilisant la technologie CSS-P (Cascading Style Sheet Positioning). Avec cette option, la zone d'application WebFacing devient un "bloc conteneur". Conformment la spcification CSS, les lments en position absolue sont positionns par rapport ce bloc conteneur. Effectuez l'une des actions suivantes pour placer les lments l'emplacement souhait : v Utilisez l'option de positionnement CSS WebFacing la place de votre propre positionnement absolu. (Recommand)

132

Dveloppement des applications WebFacing

v Utilisez le positionnement relatif ( la place du positionnement absolu) puisque le positionnement relatif est toujours relatif la position d'origine de la zone. v Ajustez les coordonnes de positionnement absolu, en gardant l'esprit que les lments sont positionns relativement au bloc conteneur de la zone d'application. v Supprimez les deux occurrences de style="position:relative" de ScreenBuilder.jsp dans le fichier \WebContent\webfacing\jsp\common\html de votre projet WebFacing si vous ne souhaitez ni modifier vos coordonnes de positionnement absolu, ni utiliser l'option de positionnement CSS WebFacing.

Prise en charge de la consignation des vnements de base communs pour les applications WebFacing
Excution dans WebSphere Application Server
Les applications WebFacing utilisent la consignation des vnements de base communs WebSphere Application Server pour diagnostiquer les problmes lis aux applications d'excution. Lorsque vous excutez une application WebFacing sur un serveur d'applications, les informations consignes sont envoyes par dfaut la console du serveur d'applications. Pour plus d'informations sur la consignation et le traage dans WebSphere Application Server, consultez le centre de documentation associ votre niveau WebSphere Application Server, par exemple, http://publib.boulder.ibm.com/infocenter/wasinfo/v7r0/index.jsp?topic=/ com.ibm.websphere.nd.multiplatform.doc/info/ae/ae/ttrb_addtrace.html. Vous pouvez configurer le niveau de consignation dans le consignateur de l'application WebFacing (com.ibm.etools.iseries.webfacing.nom_racine_contexte) l'aide de la console d'administration de WebSphere Application Server. Pour plus d'informations sur la configuration du consignateur, voir le Centre de documentation associ votre niveau de WebSphere Application Server et recherchez Configuration des proprits du consignateur laide de la console dadministration. Vous pouvez galement configurer le niveau de dtails du consignateur, ainsi que d'autres paramtres du consignateur d'applications WebFacing l'aide du fichier de configuration webfacinglogging.properties. Par dfaut, le message de consignation de WebSphere Application Server est crit sur la console du serveur d'applications, et l'enregistrement de journal crit dans le fichier activity.log de WebSphere Application Server. Si vous activez le traage via la console d'administration du serveur d'applications, les informations de trace sont crites dans le fichier trace.log de l'instance du serveur d'applications. Lorsque le traage est activ, tous les messages de consignation sont consigns dans le fichier trace.log au format texte brut. Tous les enregistrements de journal dots du niveau de consignation CONFIG et suprieur sont galement consigns dans le fichier activity.log au format Common Base Event. Pour plus d'informations sur l'activation du traage de WebSphere Application Server, voir le centre de documentation associ votre niveau de WebSphere Application Server et recherchez Activation du traage au dmarrage du serveur. Vous pouvez galement configurer les paramtres des applications WebFacing pour sparer les informations de consignation et de traage de l'excution en diffrents fichiers au sein du systme sur lequel votre serveur d'applications est excut. Les enregistrements de journal dont le niveau de consignation est suprieur ou gal CONFIG sont crits dans un fichier de consignation, ainsi que dans un fichier de
Chapitre 10. Identification et rsolution des incidents dans les applications WebFacing

133

trace si le traage est activ pour ce consignateur. Les enregistrements de trace dont le niveau de consignation est infrieur CONFIG sont crits dans un fichier de trace. Pour connatre les proprits qui activent cette fonction, voir la section Paramtres de configuration des applications WebFacing ci-dessous. Les fichiers journaux et de trace sont organiss par session HTTP. Le nom du fichier journal est ID_session.log, o ID_session reprsente l'ID de la session du navigateur qui accde l'application WebFacing. De la mme manire, le nom du fichier de trace est ID_session.trace. Le fichier journal li une application WebFacing est crit dans un rpertoire portant le mme nom que le nom de racine contextuel du projet Web qui contient l'application WebFacing. Pour plus d'informations sur la configuration de l'emplacement des fichiers journaux et de trace WebFacing, voir la proprit logFileLocation dans la section Paramtres de configuration des applications WebFacing ci-aprs. Pour plus d'informations sur l'utilisation d'Agent Controller pour IBM i, voir : v Gestion d'Agent Controller v Publication, excution et dbogage d'applications l'aide d'IBM Agent Controller Si vous souhaitez seulement consulter le texte du message de votre enregistrement de journal, configurez les paramtres de sorte que l'enregistrement de journal soit crit sous la forme d'une chane brute. Pour plus d'informations sur le contrle du format de votre enregistrement de journal d'vnement de base commun, voir la proprit useXMLFormatForCBELogging dans la section Paramtres de configuration des applications WebFacing.

Paramtres de configuration des applications WebFacing


Le fichier webfacinglogging.properties, situ au chemin WebContent/WEB-INF/ classes du projet Web WebFacing, permet de configurer les paramtres de consignation et de trace de l'application WebFacing. Voici les paramtres de ce fichier.
# Contrle le niveau de consignation dexcution # Les niveaux, par ordre dcroissant, sont les suivants : # SEVERE (valeur la plus leve) # WARNING # INFO # CONFIG # FINE # FINER # FINEST (valeur la plus faible) # Il existe en outre le niveau OFF qui permet de dsactiver la consignation # et le niveau ALL qui permet dactiver la consignation ou le traage # de tous les messages. # Pour plus dinformations, voir la classe java.util.logging dans la # documentation Java. # Les niveaux suprieurs ou gaux CONFIG sont considrs # comme des niveaux de consignation. # Les niveaux infrieurs CONFIG sont considrs comme des # niveaux de traage. # Le niveau par dfaut est SEVERE. com.ibm.etools.iseries.webfacing.level=SEVERE # # # # # # # Contrle si le niveau de consignation dfini dans ce fichier remplace les paramtres de configuration statistiques des niveaux de dtails du journal dans WAS Les valeurs correctes sont : true - par dfaut false

134

Dveloppement des applications WebFacing

com.ibm.etools.iseries.webfacing.overrideAdminLevelSetting=true # Contrle le rpertoire dans lequel les fichiers journaux et les # fichiers de trace sont crits. # Un sous-rpertoire portant le mme nom que #lapp-web est cr # pour stocker tous les fichiers journaux et de traces dune # application Web spcifique. # Cette valeur est utilise lorsque la proprit "logToFile" # est dfinie sur "true". # "%WASTraceDir" - rpertoire de trace de linstance de serveur WAS. # Il sagit de la variable SERVER_LOG_ROOT dfinie par dfaut # sur le serveur WAS. Cette valeur est utilise comme valeur par dfaut # si lapplication Web est excute dans un environnement WAS. # Si elle nest pas disponible, "%h/iserieslogs" est utilis par # dfaut. # "%h" - valeur de la proprit systme "user.home" # "%h/iserieslogs" est utilis comme valeur par dfaut # "%t" - valeur du rpertoire temporaire du systme # "." - valeur du rpertoire WEB-INF # "/" sparateur dans les noms de chemin locaux # # Exemple de chemin daccs au poste de travail : # "c:\\mon_rpertoire\\mon_rp_journal" # Veuillez noter quil faut utiliser ici une double barre # oblique inverse. # # Exemple de chemin daccs au systme de fichier # intgr pour iSeries # "/home/mon_id/mon_rp_journal" com.ibm.etools.iseries.webfacing.logFileLocation=%WASTraceDir # Contrle lcriture des informations de consignation et de # trace dans les fichiers. # Les valeurs correctes sont : # true # false - par dfaut -- Dans ce cas, les informations sont # crites dans la console. com.ibm.etools.iseries.webfacing.logToFile=false # Contrle lutilisation du gestionnaire de sortie parent # de ce consignateur. # Si cette proprit est dfinie sur false, les informations # de consignation et de trace # ne sont pas crites dans le fichier activity.log ou trace.log de WAS # Les valeurs correctes sont : # true - par dfaut # false com.ibm.etools.iseries.webfacing.useParentHandler=true # Contrle le format des enregistrements du journal Java crits # dans un fichier. # Si cette proprit est dfinie sur true, les enregistrements # du journal crits dans # le fichier journal sont au format XML. # Voir la classe java.util.logging.XMLFormatter dans la documentation Java # pour plus dinformations. # Si cette proprit est dfinie sur false, les enregistrements # du journal crits dans # le fichier journal se prsente sous forme dune chane de texte brut. # Les valeurs correctes sont : # true - par dfaut # false com.ibm.etools.iseries.webfacing.useXMLFormatForJSR47Logging=true # Contrle le format dcriture des enregistrements de journal # dvnement de base commun dans les fichiers.
Chapitre 10. Identification et rsolution des incidents dans les applications WebFacing

135

# Si cette proprit est dfinie sur true, les enregistrements # du journal crits dans le fichier journal sont au format XML # Common Base Event. # Si cette proprit est dfinie sur false, les enregistrements # du journal crits dans le fichier # journal se prsentent sous forme dune chane de texte brut. # Les valeurs correctes sont : # true - par dfaut # false com.ibm.etools.iseries.webfacing.useXMLFormatForCBELogging=true # Contrle le nombre de fichiers journaux crs pour chaque # application Web avant la suppression du fichier journal le plus ancien. com.ibm.etools.iseries.maxlog=3

Remarque : Si le serveur d'applications est excut sur IBM i, il vous faudra peut-tre affecter ce rpertoire les autorisations ncessaires la cration des fichiers journaux dans le systme de fichiers installables. Dans le cas d'IBM WebSphere Application Server, vous devez accorder l'autorisation en criture au profil utilisateur QEJBSVR. Le profil QEJBSVR, plus particulirement, doit disposer des autorisations de lecture, d'criture et d'excution dans le rpertoire de traces du tableau ci-dessus.

TFRJOB ou RRTJOB avec WebFacing met fin la tche de l'utilisateur


Si une tche utilisateur est excute dans l'environnement WebFacing, n'utilisez pas les commandes TFRJOB ou RRTJOB et n'appliquez pas RTGDTA. L'utilisation de commandes TFRJOB ou RRTJOB ou du paramtre RTGDTA pour des valeurs diffrentes de la valeur QCMDI par dfaut n'est pas compatible avec WebFacing. Si une commande TFRJOB ou RRTJOB est excute sur une tche utilisateur en cours d'excution dans l'environnement WebFacing, elle entrane la fin de la tche utilisateur. Lorsqu'elle est excute dans l'environnement WebFacing, des donnes de contrle sont associes au programme de l'utilisateur. Cependant, l'action de routage libre les objets attribus la phase d'activation prcdente et ferme les fichiers ouverts. Une fois cette tape termine pour une tche utilisateur WebFacing, celle-ci est retire de WebFacing avant que le systme d'exploitation IBM i y mette fin.

Impossible d'accder l'aide tendue sur les crans WebFacing affichage dynamique
Par dfaut, l'aide tendue est inaccessible sur les crans WebFacing affichage dynamique car la position de curseur n'est pas active pour les zones protges. Pour activer cette fonction, personnalisez la transformation de faon ce que le curseur puisse tre positionn sur les zones protges telles que les options du menu d'aide. 1. Dans la vue Navigateur, ouvrez le fichier renderingSet.xml situ dans <nom_projet>\src. 2. Recherchez le fichier correspondant au paramtre showLinksForProtectedFields. Il doit se trouver vers la fin du dossier. 3. Modifiez la valeur false du paramtre en true. Vous pourrez ainsi positionner le curseur sur les zones protges en les gnrant sous la forme de liens. Le fait de cliquer sur l'un de ces liens place le curseur sur cet emplacement spcifique. 4. Enregistrez le fichier.

136

Dveloppement des applications WebFacing

5. Republiez et excutez votre projet. Dsormais, vous devez tre capable d'afficher l'aide tendue en cliquant sur l'une des options correspondantes et en appuyant sur Entre.

Chapitre 10. Identification et rsolution des incidents dans les applications WebFacing

137

138

Dveloppement des applications WebFacing

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS
* indique que le comportement du mot cl tel qu'il a t mis en oeuvre par WebFacing, peut prsenter des diffrences ou des limites en comparaison de la mise en oeuvre standard 5250. Cliquez sur le lien du mot cl pour plus d'informations. Remarque : Vous pouvez utiliser l'outil d'enqute de mots cls DDS pour vous aider valuer le niveau de support des mots cls que l'outil WebFacing fournira votre application. L'outil d'enqute sur les mots cls DDS peut tre tlcharg partir d'IBM Support.
Tri par mot cl ALARM ALIAS * ALTHELP * ALTNAME * ALTPAGEDWN * ALTPAGEUP * ALWGPH ALWROL ASSUME (transfert de donnes) ASSUME (pas d'effacement de l'cran) BLANKS * BLINK BLKFOLD * CAnn/CFnn * CCSID CHANGE * CHCACCEL CHCAVAIL CHCCTL CHCSLT CHCUNAVAIL CHECK(ER)/AUTO(RA) CHECK(RB)/AUTO(RAB) * CHECK(RZ)/AUTO(RAZ) * CHECK * CHGINPDFT(FE) * Tri par prise en charge actuelle Non Oui Oui (partiel) Oui Oui (partiel) Oui (partiel) Non Non Non Oui Oui Non Non Oui Non Oui Non Non Non Non Non Oui Oui Oui Oui Oui Tri par catgorie Gnration d'cran Valeurs la compilation Touches de fonction Valeurs la compilation Touches de fonction Touches de fonction Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Tampon d'E-S Curseur Position de zone Touches de fonction Activation NLS Tampon d'E-S Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Validation Tampon d'E-S Validation Validation Apparence

Copyright IBM Corp. 1992, 2011

139

Tri par mot cl

Tri par prise en charge actuelle

Tri par catgorie Validation Apparence Apparence Validation Aspect graphique Activation NLS Touches de fonction Gnration d'cran Gnration d'cran Gnration d'cran Validation Aspect graphique Apparence Validation Curseur Curseur Validation Apparence Constantes Valeurs de zone Valeurs de zone Valeurs de zone Valeurs la compilation Valeurs la compilation Apparence Apparence Apparence Apparence Apparence Apparence Valeurs de zone Apparence Gnration d'cran Gnration d'cran Activation NLS Gnration d'cran Touches de fonction

CHGINPDFT(ME MF LC CS) Oui * CHGINPDFT(RI HI) * CHGINPDFT/ CHGINPDFT(UL/BL) * CHKMSGID CHOICE CHRID CLEAR * CLRL(nn|*END) * CLRL(*ALL) * CLRL(*NO) * CMP * CNTFLD * COLOR * COMP * CSRINPONLY * CSRLOC DATEFMT DATESEP DATE DFT (implicite) * DFTVAL * DFT * DLTCHK * DLTEDT * DSPATR (zone programme systme) DSPATR(BL) DSPATR(MDT) DSPATR(OID) * DSPATR(PC) * DSPATR(PR CS) * Oui Oui Oui Non Non Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Non Oui Oui

DSPATR(SP), la page 188 Oui DSPATR(UL HI RI ND) * DSPMOD (sans condition) * DSPMOD (avec indicateurs d'option) * DSPRL * DSPSIZ * DUP Oui Oui Non Non Oui Non

140

Dveloppement des applications WebFacing

Tri par mot cl EDTCDE(5-9), la page 198* EDTCDE EDTMSK EDTWRD ENTFLDATR ERASEINP ERASE ERRMSGID * ERRMSG * ERRSFL * FLDCSRPRG FLTFIXDEC FLTPCN FRCDTA GETRETAIN GRDATR GRDBOX GRDCLR GRDLIN GRDRCD

Tri par prise en charge actuelle Non Oui Oui Oui Non Non Oui Oui Oui Oui Non Non Non Oui Non Non Non Non Non Non

Tri par catgorie Apparence Apparence Validation Apparence Apparence Gnration d'cran Gnration d'cran Messages Messages Messages Curseur Apparence Tampon d'E-S Gnration d'cran Gnration d'cran Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Touches de fonction Touches de fonction Touches de fonction Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Touches de fonction Aide de l'application Aide de l'application Aide de l'application Aide de l'application Touches de fonction

HELP (mess. 2me niveau) Non , la page 201 HELP (retour au prog.) HELP (avec HLPARA) HLPARA HLPBDY HLPCLR HLPCMDKEY HLPDOC * HLPEXCLD HLPFULL HLPID HLPPNLGRP HLPRCD HLPRTN HLPSCHIDX HLPSEQ HLPSHELF HLPTITLE HOME * Oui Oui Oui Oui Oui Non Non Oui Non Oui Oui Oui Oui Non Oui Non Oui Oui

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

141

Tri par mot cl HTML IGCALTTYP IGCCNV * INDARA INDTXT * INVITE (plusieurs units) * INVITE (unit unique) * INZINP INZRCD KEEP LOCK LOGINP * LOGOUT * LOWER MAPVAL MDTOFF * MLTCHCFLD MNUBARCHC MNUBARDSP MNUBARSEP MNUBARSW MNUBAR MNUCNL MOUBTN MSGALARM MSGCON MSGID MSGLOC NOCCSID OPENPRT OVERLAY * OVRATR/OVRDTA PAGEDOWN/PAGEUP * PASSRCD PRINT(*PGM/ind. rponse) PRINT/PRINT(bib/fichier) PROTECT PSHBTNCHC PSHBTNFLD PULLDOWN

Tri par prise en charge actuelle Non Oui Non Oui Oui Non Oui Non Non Oui Non Oui Oui Oui Non Oui Non Non Non Non Non Non Non Non Non Oui Oui Non Non Non Oui Non Oui Non Oui Non Oui Non Non Non

Tri par catgorie Aspect graphique Activation NLS Activation NLS Indicateurs Indicateurs Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Tampon d'E-S Tampon d'E-S Tampon d'E-S Valeurs de zone Gnration d'cran Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Touches de fonction Messages Constantes Valeurs de zone Messages Activation NLS Gnration d'cran Gnration d'cran Gnration d'cran Touches de fonction Gnration d'cran Touches de fonction Touches de fonction Gnration d'cran Aspect graphique Aspect graphique Aspect graphique

142

Dveloppement des applications WebFacing

Tri par mot cl PUTOVR * PUTRETAIN RANGE (alphanumrique) RANGE (numrique) * REFFLD * REF * RETKEY/RETCMDKEY * RETLCKSTS RMVWDW ROLLUP/ROLLDOWN * RTNCSRLOC(*MOUSE) RTNCSRLOC(*RECNAME| *WINDOW) * RTNDTA SETOF/SETOFF SFLCHCCTL SFLCLR SFLCSRPRG SFLCSRRRN SFLCTL SFLDLT SFLDROP SFLDSPCTL SFLDSP SFLEND * SFLENTER SFLFOLD SFLINZ SFLLIN SFLMLTCHC SFLMODE SFLMSGID SFLMSGKEY SFLMSGRCD SFLMSG SFLNXTCHG SFLPAG SFLPGMQ/SFLMSGKEY/ SFLMSGRCD SFLRCDNBR SFLRNA

Tri par prise en charge actuelle Non Non Non Oui Oui Oui Oui Non Oui Oui Non Oui Oui Oui Non Oui Non Oui Oui Oui Oui Oui Oui Oui Non Oui Oui Oui Non Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui

Tri par catgorie Gnration d'cran Gnration d'cran Validation Validation Valeurs la compilation Valeurs la compilation Touches de fonction Gnration d'cran Fentre Touches de fonction Curseur Curseur Gnration d'cran Tampon d'E-S Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

143

Tri par mot cl SFLROLVAL * SFLRTNSEL SFLSCROLL SFLSIZ SFLSNGCHC SFL * SLNO (*VAR) SLNO(n) SNGCHCFLD SYSNAME TEXT * TIME TIMFMT TIMSEP UNLOCK USER USRDFN USRDSPMGT USRRSTDSP VALNUM * VALUES * VLDCMDKEY WDWBORDER WDWTITLE * WINDOW(dfinition) WINDOW(rfrence) WRDWRAP * (7-16) Paramtres d'environnement (29) Rfrence * (30-34) Longueur (35) Type de donnes (tampon) (35) Type de donnes/Touche Maj du clavier * (36-37) Position dcimale (38) Usage M (38) Emploi (I/O/B/H/P) (39-44) Emplacement *

Tri par prise en charge actuelle Non Non Oui Oui Non Oui Oui Oui Non Oui Oui Oui Oui Oui Non Oui Non Non Non Oui Oui Oui Non Oui Oui (partiel) Oui Oui Oui Oui Oui Oui Oui

Tri par catgorie Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Position de zone Position de zone Aspect graphique Constantes Valeurs la compilation Constantes Validation Apparence Gnration d'cran Constantes Gnration d'cran Gnration d'cran Fentre Validation Validation Touches de fonction Fentre Fentre Fentre Fentre Apparence Indicateurs Valeurs la compilation Apparence Tampon d'E-S Validation

Oui Non Oui Oui

Tampon d'E-S Messages Valeurs de zone Position de zone

144

Dveloppement des applications WebFacing

Concepts associs Chapitre 1, Prsentation de l'outil WebFacing, la page 1 Tches associes Chapitre 3, Cration d'un projet Web WebFacing, la page 13 Ouverture de la perspective WebFacing, la page 14 Slection des membres source convertir, la page 15 Spcification de commandes CL pour appeler votre application, la page 16 Slection d'un style Web, la page 14 Fin du projet et conversion du source DDS, la page 18 Analyse des journaux de conversion, la page 18

Outil WebFacing -- Prise en charge actuelle des mots cls DDS


* indique que le comportement du mot cl tel qu'il a t mis en oeuvre par WebFacing, peut prsenter des diffrences ou des limites en comparaison de la mise en oeuvre standard 5250. Cliquez sur le lien du mot cl pour plus d'informations. Remarque : Vous pouvez utiliser l'outil d'enqute sur les mots cls DDS pour vous aider valuer le niveau de support des mots cls que l'outil WebFacing fournira votre application. L'outil d'enqute sur les mots cls DDS peut tre tlcharg partir d'IBM Support.
Tri par mot cl CHGINPDFT(FE) * CHGINPDFT(RI HI) * CHGINPDFT/ CHGINPDFT(UL/BL) * COLOR * DATESEP DSPATR (zone programme systme) DSPATR(BL) DSPATR(MDT) DSPATR(OID) * DSPATR(PC) * DSPATR(PR CS) * DSPATR(UL HI RI ND) * EDTCDE(5-9) EDTCDE EDTWRD ENTFLDATR FLTFIXDEC TIMSEP WRDWRAP * (30-34) Longueur Tri par prise en charge actuelle Oui Oui Oui Oui Oui Oui Oui Oui Non Oui Oui Oui Non Oui Oui Non Non Oui Oui Oui Tri par catgorie Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

145

Tri par mot cl HLPARA HLPBDY HLPCLR HLPCMDKEY HLPDOC * HLPEXCLD HLPFULL HLPID HLPPNLGRP HLPRCD HLPSCHIDX HLPSEQ HLPSHELF HLPTITLE ALIAS * ALTNAME * DLTCHK * DLTEDT * REFFLD * REF * TEXT * (29) Rfrence * DATE MSGCON SYSNAME TIME USER BLINK CSRINPONLY * CSRLOC FLDCSRPRG RTNCSRLOC(*MOUSE) RTNCSRLOC(*RECNAME| *WINDOW) * BLKFOLD * SLNO (*VAR) SLNO(n) (39-44) Emplacement * DFT (implicite) * DFTVAL *

Tri par prise en charge actuelle Oui Oui Oui Non Non Oui Non Oui Oui Oui Non Oui Non Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Non Oui Oui Non Non Oui Non Oui Oui Oui Oui Oui

Tri par catgorie Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Valeurs la compilation Valeurs la compilation Valeurs la compilation Valeurs la compilation Valeurs la compilation Valeurs la compilation Valeurs la compilation Valeurs la compilation Constantes Constantes Constantes Constantes Constantes Curseur Curseur Curseur Curseur Curseur Curseur Position de zone Position de zone Position de zone Position de zone Valeurs de zone Valeurs de zone

146

Dveloppement des applications WebFacing

Tri par mot cl DFT * DSPATR(SP) MAPVAL MSGID (38) Emploi (I/O/B/H/P) ALTHELP * ALTPAGEDWN * ALTPAGEUP * CAnn/CFnn * CLEAR * DUP HELP (mess. 2me niveau) * HELP (retour au prog.) * HELP (avec HLPARA) * HLPRTN HOME * MOUBTN PAGEDOWN/PAGEUP * PRINT(*PGM/ind. rponse) PRINT/PRINT(bib/fichier) RETKEY/RETCMDKEY * ROLLUP/ROLLDOWN * VLDCMDKEY CHCACCEL CHCAVAIL CHCCTL CHCSLT CHCUNAVAIL CHOICE CNTFLD * GRDATR GRDBOX GRDCLR GRDLIN GRDRCD HTML MLTCHCFLD MNUBARCHC MNUBARDSP MNUBARSEP

Tri par prise en charge actuelle Oui Oui Non Oui Oui Oui (partiel) Oui (partiel) Oui (partiel) Oui Oui Non Non Oui Oui Oui Oui Non Oui Oui Non Oui Oui Oui Non Non Non Non Non Non Oui Non Non Non Non Non Non Non Non Non Non

Tri par catgorie Valeurs de zone Valeurs de zone Valeurs de zone Valeurs de zone Valeurs de zone Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

147

Tri par mot cl MNUBARSW MNUBAR MNUCNL PSHBTNCHC PSHBTNFLD PULLDOWN SNGCHCFLD INDARA INDTXT * (7-16) Paramtres d'environnement BLANKS * CHANGE * CHECK(RB)/AUTO(RAB) * FLTPCN LOGINP * LOGOUT * LOWER SETOF/SETOFF (35) Type de donnes (tampon) (36-37) Position dcimale ERRMSGID * ERRMSG * ERRSFL * MSGALARM MSGLOC (38) Usage M CCSID CHRID DSPRL * IGCALTTYP IGCCNV * NOCCSID ALARM ALWGPH ALWROL ASSUME (transfert de donnes) ASSUME (pas d'effacement de l'cran)

Tri par prise en charge actuelle Non Non Non Non Non Non Non Oui Oui Oui Oui Oui Oui Non Oui Oui Oui Oui Oui Oui Oui Oui Oui Non Non Non Non Non Non Oui Non Non Non Non Non Non Oui

Tri par catgorie Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Indicateurs Indicateurs Indicateurs Tampon d'E-S Tampon d'E-S Tampon d'E-S Tampon d'E-S Tampon d'E-S Tampon d'E-S Tampon d'E-S Tampon d'E-S Tampon d'E-S Tampon d'E-S Messages Messages Messages Messages Messages Messages Activation NLS Activation NLS Activation NLS Activation NLS Activation NLS Activation NLS Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran

148

Dveloppement des applications WebFacing

Tri par mot cl CLRL(nn|*END) * CLRL(*ALL) * CLRL(*NO) * DSPMOD (sans condition) * DSPMOD (avec indicateurs d'option) * DSPSIZ * ERASEINP ERASE * FRCDTA GETRETAIN INVITE (plusieurs units) * INVITE (unit unique) * INZINP INZRCD KEEP LOCK MDTOFF * OPENPRT OVERLAY * OVRATR/OVRDTA PASSRCD PROTECT PUTOVR PUTRETAIN RETLCKSTS RTNDTA UNLOCK USRDFN USRDSPMGT SFLCHCCTL SFLCLR SFLCSRPRG SFLCSRRRN SFLCTL SFLDLT SFLDROP SFLDSPCTL SFLDSP SFLEND *

Tri par prise en charge actuelle Oui Oui Oui Oui Non Oui Non Oui Oui Non Non Oui Non Non Oui Non Oui Non Oui Non Non Oui Non Non Non Oui Non Non Non Non Oui Non Oui Oui Oui Oui Oui Oui Oui

Tri par catgorie Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

149

Tri par mot cl SFLENTER SFLFOLD SFLINZ SFLLIN SFLMLTCHC SFLMODE SFLMSGID SFLMSGKEY SFLMSGRCD SFLMSG SFLNXTCHG SFLPAG SFLPGMQ/SFLMSGKEY/ SFLMSGRCD SFLRCDNBR SFLRNA SFLROLVAL * SFLRTNSEL SFLSCROLL SFLSIZ SFLSNGCHC SFL * CHECK(ER)/AUTO(RA) CHECK(RZ)/AUTO(RAZ) * CHECK *

Tri par prise en charge actuelle Non Oui Oui Oui Non Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Non Non Oui Oui Non Oui Oui Oui Oui

Tri par catgorie Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Validation Validation Validation Validation Validation Validation Validation Validation Validation Validation Validation Validation Validation Validation Validation

CHGINPDFT(ME MF LC CS) Oui * CHKMSGID CMP * COMP * DATEFMT EDTMSK RANGE (alphanumrique) * RANGE (numrique) * TIMFMT VALNUM * VALUES * (35) Type de donnes/Touche Maj du clavier * RMVWDW Oui Oui Oui Oui Oui Non Oui Oui Oui Oui Oui

Oui

Fentre

150

Dveloppement des applications WebFacing

Tri par mot cl USRRSTDSP WDWBORDER WDWTITLE * WINDOW(dfinition) WINDOW(rfrence)

Tri par prise en charge actuelle Non Non Oui Oui (partiel) Oui

Tri par catgorie Fentre Fentre Fentre Fentre Fentre

Outil WebFacing -- Prise en charge actuelle des mots cls DDS


* indique que le comportement du mot cl tel qu'il a t mis en oeuvre par WebFacing, peut prsenter des diffrences ou des limites en comparaison de la mise en oeuvre standard 5250. Cliquez sur le lien du mot cl pour plus d'informations. Remarque : Vous pouvez utiliser l'outil d'enqute sur les mots cls DDS pour vous aider valuer le niveau de support des mots cls que l'outil WebFacing fournira votre application. L'outil d'enqute sur les mots cls DDS peut tre tlcharg partir d'IBM Support.
Tri par mot cl ALIAS * ALTHELP * ALTNAME * ALTPAGEDWN * ALTPAGEUP * ASSUME (pas d'effacement de l'cran) BLANKS * CAnn/CFnn * CHANGE * CHECK(ER)/AUTO(RA) CHECK(RB)/AUTO(RAB) * CHECK(RZ)/AUTO(RAZ) * CHECK * CHECK(FE) * CHGINPDFT(FE) * Tri par prise en charge actuelle Oui Oui (partiel) Oui Oui (partiel) Oui (partiel) Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Tri par catgorie Valeurs la compilation Touches de fonction Valeurs la compilation Touches de fonction Touches de fonction Gnration d'cran Tampon d'E-S Touches de fonction Tampon d'E-S Validation Tampon d'E-S Validation Validation Apparence Apparence Validation Apparence Apparence Validation Touches de fonction Gnration d'cran

CHGINPDFT(ME MF LC CS) Oui * CHGINPDFT(RI HI) * CHGINPDFT/ CHGINPDFT(UL/BL) * CHKMSGID CLEAR * CLRL(nn|*END) Oui Oui Oui Oui Oui

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

151

Tri par mot cl CLRL(*ALL) CLRL(*NO) CMP * CNTFLD * COLOR * COMP * CSRINPONLY * CSRLOC DATE DATEFMT DATESEP DFT (implicite) * DFTVAL * DFT * DLTCHK * DLTEDT * DSPATR(BL) DSPATR(MDT) DSPATR(PC) * DSPATR(PR CS) * DSPATR(SP) DSPATR(UL HI RI ND) * DSPATR (zone programme systme) DSPMOD (sans condition) * DSPSIZ * EDTCDE EDTMSK EDTWRD ERASE ERRMSGID * ERRMSG * ERRSFL * FRCDTA HELP (retour au prog.) * HELP (avec HLPARA) * HLPARA HLPBDY HLPCLR HLPEXCLD

Tri par prise en charge actuelle Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui

Tri par catgorie Gnration d'cran Gnration d'cran Validation Aspect graphique Apparence Validation Curseur Curseur Constantes Validation Apparence Valeurs de zone Valeurs de zone Valeurs de zone Valeurs la compilation Valeurs la compilation Apparence Apparence Apparence Apparence Valeurs de zone Apparence Apparence Gnration d'cran Gnration d'cran Apparence Validation Apparence Gnration d'cran Messages Messages Messages Gnration d'cran Touches de fonction Touches de fonction Aide de l'application Aide de l'application Aide de l'application Aide de l'application

152

Dveloppement des applications WebFacing

Tri par mot cl HLPID HLPPNLGRP HLPRCD HLPRTN HLPSEQ HLPTITLE HOME * IGCALTTYP INDARA INDTXT * INVITE (unit unique) * KEEP LOGINP * LOGOUT * LOWER MDTOFF * MSGCON MSGID OVERLAY * PAGEDOWN/PAGEUP * PRINT(*PGM/ind. rponse) PROTECT RANGE (numrique) * REFFLD * REF * RETKEY/RETCMDKEY * RMVWDW ROLLUP/ROLLDOWN * RTNCSRLOC(*RECNAME| *WINDOW) * RTNDTA SETOF/SETOFF SFLCLR SFLCSRRRN SFLCTL SFLDLT SFLDROP SFLDSPCTL SFLDSP SFLEND *

Tri par prise en charge actuelle Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui

Tri par catgorie Aide de l'application Aide de l'application Aide de l'application Touches de fonction Aide de l'application Aide de l'application Touches de fonction Activation NLS Indicateurs Indicateurs Gnration d'cran Gnration d'cran Tampon d'E-S Tampon d'E-S Tampon d'E-S Gnration d'cran Constantes Valeurs de zone Gnration d'cran Touches de fonction Touches de fonction Gnration d'cran Validation Valeurs la compilation Valeurs la compilation Touches de fonction Fentre Touches de fonction Curseur Gnration d'cran Tampon d'E-S Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

153

Tri par mot cl SFLFOLD SFLINZ SFLLIN SFLMODE SFLMSGID SFLMSGKEY SFLMSGRCD SFLMSG SFLNXTCHG SFLPAG SFLPGMQ/SFLMSGKEY/ SFLMSGRCD SFLRCDNBR SFLRNA SFLSCROLL SFLSIZ SFL * SLNO (*VAR) SLNO(n) SYSNAME TEXT * TIME TIMFMT TIMSEP USER VALNUM * VALUES * VLDCMDKEY WDWTITLE * WINDOW(dfinition) WINDOW(rfrence) WRDWRAP * (7-16) Paramtres d'environnement (29) Rfrence * (30-34) Longueur (35) Type de donnes (tampon) (35) Type de donnes/Touche Maj du clavier *

Tri par prise en charge actuelle Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui (partiel) Oui Oui Oui Oui Oui Oui Oui

Tri par catgorie Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Position de zone Position de zone Constantes Valeurs la compilation Constantes Validation Apparence Constantes Validation Validation Touches de fonction Fentre Fentre Fentre Apparence Indicateurs Valeurs la compilation Apparence Tampon d'E-S Validation

154

Dveloppement des applications WebFacing

Tri par mot cl (36-37) Position dcimale (38) Emploi (I/O/B/H/P) (39-44) Emplacement * ALARM ALWGPH ALWROL ASSUME (transfert de donnes) BLINK BLKFOLD * CCSID CHCACCEL CHCAVAIL CHCCTL CHCSLT CHCUNAVAIL CHOICE CHRID DSPATR(OID) * DSPMOD (avec indicateurs d'option) * DSPRL * DUP EDTCDE(5-9) ENTFLDATR ERASEINP FLDCSRPRG FLTFIXDEC FLTPCN GETRETAIN GRDATR GRDBOX GRDCLR GRDLIN GRDRCD HELP (mess. 2me niveau) * HLPCMDKEY HLPDOC * HLPFULL HLPSCHIDX HLPSHELF

Tri par prise en charge actuelle Oui Oui Oui Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non

Tri par catgorie Tampon d'E-S Valeurs de zone Position de zone Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Curseur Position de zone Activation NLS Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Activation NLS Apparence Gnration d'cran Activation NLS Touches de fonction Apparence Apparence Gnration d'cran Curseur Apparence Tampon d'E-S Gnration d'cran Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Touches de fonction Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

155

Tri par mot cl HTML IGCCNV * INVITE (plusieurs units) * INZINP INZRCD LOCK MAPVAL MLTCHCFLD MNUBARCHC MNUBARDSP MNUBARSEP MNUBARSW MNUBAR MNUCNL MOUBTN MSGALARM MSGLOC NOCCSID OPENPRT OVRATR/OVRDTA PASSRCD PRINT/PRINT(bib/fichier) PSHBTNCHC PSHBTNFLD PULLDOWN PUTOVR PUTRETAIN RANGE (alphanumrique) * RETLCKSTS RTNCSRLOC(*MOUSE) SFLCHCCTL SFLCSRPRG SFLENTER SFLMLTCHC SFLROLVAL * SFLRTNSEL SFLSNGCHC SNGCHCFLD UNLOCK USRDFN

Tri par prise en charge actuelle Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non

Tri par catgorie Aspect graphique Activation NLS Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Valeurs de zone Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Touches de fonction Messages Messages Activation NLS Gnration d'cran Gnration d'cran Gnration d'cran Touches de fonction Aspect graphique Aspect graphique Aspect graphique Gnration d'cran Gnration d'cran Validation Gnration d'cran Curseur Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Aspect graphique Gnration d'cran Gnration d'cran

156

Dveloppement des applications WebFacing

Tri par mot cl USRDSPMGT USRRSTDSP WDWBORDER (38) Usage M

Tri par prise en charge actuelle Non Non Non Non

Tri par catgorie Gnration d'cran Fentre Fentre Messages

Outil WebFacing -- Prise en charge actuelle des mots cls DDS


* indique que le comportement du mot cl tel qu'il a t mis en oeuvre par WebFacing, peut prsenter des diffrences ou des limites en comparaison de la mise en oeuvre standard 5250. Cliquez sur le lien du mot cl pour plus d'informations. Remarque : Vous pouvez utiliser l'outil d'enqute sur les mots cls DDS pour vous aider valuer le niveau de support des mots cls que l'outil WebFacing fournira votre application. L'outil d'enqute sur les mots cls DDS peut tre tlcharg partir d'IBM Support.
Tri par mot cl CHGINPDFT(FE) * CHGINPDFT(RI HI) * CHGINPDFT/ CHGINPDFT(UL/BL) * COLOR * DATESEP DSPATR (zone programme systme) DSPATR(BL) DSPATR(MDT) DSPATR(OID) * DSPATR(PC) * DSPATR(PR CS) * DSPATR(UL HI RI ND) * EDTCDE(5-9) EDTCDE EDTWRD ENTFLDATR FLTFIXDEC TIMSEP WRDWRAP * (30-34) Longueur HLPARA HLPBDY HLPCLR Tri par prise en charge actuelle Oui Oui Oui Oui Oui Oui Oui Oui Non Oui Oui Oui Non Oui Oui Non Non Oui Oui Oui Oui Oui Oui Tri par catgorie Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence Apparence Aide de l'application Aide de l'application Aide de l'application

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

157

Tri par mot cl HLPCMDKEY HLPDOC * HLPEXCLD HLPFULL HLPID HLPPNLGRP HLPRCD HLPSCHIDX HLPSEQ HLPSHELF HLPTITLE ALIAS * ALTNAME * DLTCHK * DLTEDT * REFFLD * REF * TEXT * (29) Rfrence * DATE MSGCON SYSNAME TIME USER BLINK CSRINPONLY * CSRLOC FLDCSRPRG RTNCSRLOC(*MOUSE) RTNCSRLOC(*RECNAME| *WINDOW) * BLKFOLD * SLNO (*VAR) SLNO(n) (39-44) Emplacement * DFT (implicite) * DFTVAL * DFT * DSPATR(SP) MAPVAL

Tri par prise en charge actuelle Non Non Oui Non Oui Oui Oui Non Oui Non Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Non Oui Oui Non Non Oui Non Oui Oui Oui Oui Oui Oui Oui Non

Tri par catgorie Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Valeurs la compilation Valeurs la compilation Valeurs la compilation Valeurs la compilation Valeurs la compilation Valeurs la compilation Valeurs la compilation Valeurs la compilation Constantes Constantes Constantes Constantes Constantes Curseur Curseur Curseur Curseur Curseur Curseur Position de zone Position de zone Position de zone Position de zone Valeurs de zone Valeurs de zone Valeurs de zone Valeurs de zone Valeurs de zone

158

Dveloppement des applications WebFacing

Tri par mot cl MSGID (38) Emploi (I/O/B/H/P) ALTHELP * ALTPAGEDWN * ALTPAGEUP * CAnn/CFnn * CLEAR * DUP HELP (mess. 2me niveau) * HELP (retour au prog.) * HELP (avec HLPARA) * HLPRTN HOME * MOUBTN PAGEDOWN/PAGEUP * PRINT(*PGM/ind. rponse) PRINT/PRINT(bib/fichier) RETKEY/RETCMDKEY * ROLLUP/ROLLDOWN * VLDCMDKEY CHCACCEL CHCAVAIL CHCCTL CHCSLT CHCUNAVAIL CHOICE CNTFLD * GRDATR GRDBOX GRDCLR GRDLIN GRDRCD HTML MLTCHCFLD MNUBARCHC MNUBARDSP MNUBARSEP MNUBARSW MNUBAR MNUCNL

Tri par prise en charge actuelle Oui Oui Oui (partiel) Oui (partiel) Oui (partiel) Oui Oui Non Non Oui Oui Oui Oui Non Oui Oui Non Oui Oui Oui Non Non Non Non Non Non Oui Non Non Non Non Non Non Non Non Non Non Non Non Non

Tri par catgorie Valeurs de zone Valeurs de zone Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Touches de fonction Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

159

Tri par mot cl PSHBTNCHC PSHBTNFLD PULLDOWN SNGCHCFLD INDARA INDTXT * (7-16) Paramtres d'environnement BLANKS * CHANGE * CHECK(RB)/AUTO(RAB) * FLTPCN LOGINP * LOGOUT * LOWER SETOF/SETOFF (35) Type de donnes (tampon) (36-37) Position dcimale ERRMSGID * ERRMSG * ERRSFL * MSGALARM MSGLOC (38) Usage M CCSID CHRID DSPRL * IGCALTTYP IGCCNV * NOCCSID ALARM ALWGPH ALWROL ASSUME (transfert de donnes) ASSUME (pas d'effacement de l'cran) CLRL(nn|*END) * CLRL(*ALL) * CLRL(*NO) *

Tri par prise en charge actuelle Non Non Non Non Oui Oui Oui Oui Oui Oui Non Oui Oui Oui Oui Oui Oui Oui Oui Oui Non Non Non Non Non Non Oui Non Non Non Non Non Non Oui Oui Oui Oui

Tri par catgorie Aspect graphique Aspect graphique Aspect graphique Aspect graphique Indicateurs Indicateurs Indicateurs Tampon d'E-S Tampon d'E-S Tampon d'E-S Tampon d'E-S Tampon d'E-S Tampon d'E-S Tampon d'E-S Tampon d'E-S Tampon d'E-S Tampon d'E-S Messages Messages Messages Messages Messages Messages Activation NLS Activation NLS Activation NLS Activation NLS Activation NLS Activation NLS Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran

160

Dveloppement des applications WebFacing

Tri par mot cl DSPMOD (sans condition) * DSPMOD (avec indicateurs d'option) * DSPSIZ * ERASEINP ERASE * FRCDTA GETRETAIN INVITE (plusieurs units) * INVITE (unit unique) * INZINP INZRCD KEEP LOCK MDTOFF * OPENPRT OVERLAY * OVRATR/OVRDTA PASSRCD PROTECT PUTOVR PUTRETAIN RETLCKSTS RTNDTA UNLOCK USRDFN USRDSPMGT SFLCHCCTL SFLCLR SFLCSRPRG SFLCSRRRN SFLCTL SFLDLT SFLDROP SFLDSPCTL SFLDSP SFLEND * SFLENTER SFLFOLD SFLINZ

Tri par prise en charge actuelle Oui Non Oui Non Oui Oui Non Non Oui Non Non Oui Non Oui Non Oui Non Non Oui Non Non Non Oui Non Non Non Non Oui Non Oui Oui Oui Oui Oui Oui Oui Non Oui Oui

Tri par catgorie Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

161

Tri par mot cl SFLLIN SFLMLTCHC SFLMODE SFLMSGID SFLMSGKEY SFLMSGRCD SFLMSG SFLNXTCHG SFLPAG SFLPGMQ/SFLMSGKEY/ SFLMSGRCD SFLRCDNBR SFLRNA SFLROLVAL * SFLRTNSEL SFLSCROLL SFLSIZ SFLSNGCHC SFL * CHECK(ER)/AUTO(RA) CHECK(RZ)/AUTO(RAZ) * CHECK *

Tri par prise en charge actuelle Oui Non Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Non Non Oui Oui Non Oui Oui Oui Oui

Tri par catgorie Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Validation Validation Validation Validation Validation Validation Validation Validation Validation Validation Validation Validation Validation Validation Validation

CHGINPDFT(ME MF LC CS) Oui * CHKMSGID CMP * COMP * DATEFMT EDTMSK RANGE (alphanumrique) * RANGE (numrique) * TIMFMT VALNUM * VALUES * (35) Type de donnes/Touche Maj du clavier * RMVWDW USRRSTDSP WDWBORDER WDWTITLE * Oui Oui Oui Oui Oui Non Oui Oui Oui Oui Oui

Oui Non Non Oui

Fentre Fentre Fentre Fentre

162

Dveloppement des applications WebFacing

Tri par mot cl WINDOW(dfinition) WINDOW(rfrence)

Tri par prise en charge actuelle Oui (partiel) Oui

Tri par catgorie Fentre Fentre

ALARM
Catgorie Gnration d'cran Autres informations

ALIAS
Catgorie Valeurs la compilation Autres informations Ce mot cl est pris en charge par dfaut. Lors de la compilation d'un programme, le nom de remplacement est insr dans le programme la place du nom de zone DDS. Ces informations sont ensuite rsolues l'aide de l'objet DDS compil avant tout envoi de demande destination de formats d'enregistrement convertis. Les formats d'enregistrement convertis utilisent les noms de zones DDS d'origine.

BLANKS
Catgorie Tampon d'E-S Autres informations Le mme indicateur de rponse ne doit pas tre utilis avec un mot cl BLANKS et un autre mot cl. En effet, le manuel DDS le dconseille et les rsultats risquent d'tre imprvisibles. Un mot cl BLANKS s'appliquant une zone dote des mots cls DSPATR(PR) et DSPATR(ND) pour une zone qui est cache au moyen de paramtres Web risque de ne pas fonctionner comme prvu dans WebFacing. Dans WebFacing, les indicateurs BLANKS de ces zones ne sont pas activs mme si les zones sont vierges ; dans le cas d'une application 5250, ils sont activs. Lorsque BLANKS est indiqu pour une zone d'un enregistrement de sous-fichier et que la zone est envoye l'cran comme une zone vierge, mais qu'aucune zone de l'enregistrement de sous-fichier n'est modifie, l'indicateur de rponse BLANKS n'est pas activ. Sur le 5250, l'indicateur de rponse sera activ. Cet incident n'existe que si (1) BLANKS est indiqu pour une zone de sous-fichier et (2) aucune zone de l'enregistrement de sous-fichier n'est modifie.

IGCCNV
Catgorie Activation NLS Autres informations Ce mot cl fournissant une fonctionnalit qui existe aussi sur la plate-forme
Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

163

langue du PC, il est inutile d'implmenter la conversion pour ce mot cl. L'utilisateur final peut utiliser Windows pour crer des caractres DBCS au lieu d'une mulation de la mthode 5250 permettant cette opration.

INDARA
Catgorie Indicateurs Autres informations

INDTXT
Catgorie Indicateurs Autres informations Le mot cl INDTXT est ignor par la conversion. Ce texte sert uniquement de commentaire dans le fichier ou le programme. Les informations INDTXT associes sont toujours disponibles dans le fichier cran lorsque des commandes telles que DSPFFD sont lances sur le systme IBM i. Cependant, ces commentaires ne sont pas disponibles aprs conversion dans les pages JSP ou les fichiers XML.

INVITE (plusieurs units)


Catgorie Gnration d'cran Autres informations INVITE est pris en charge pour les crans uniques. Les scnarios o l'application invite plusieurs units simultanment ne sont pas admis.

INVITE (unit unique)


Catgorie Gnration d'cran Autres informations L'opration INVITE permet d'envoyer une demande d'entre sur un cran et de revenir au programme sans attendre que l'utilisateur entre les donnes. Avant d'excuter des applications WebFacing faisant appel au mot cl INVITE, vrifiez que vous avez install les modifications provisoires du logiciel (PTF) IBM i associes INVITE pour WebFacing. Vous n'avez pas forcment besoin du mot cl INVITE si vos applications n'utilisent pas d'E-S asynchrones. Dans ce cas, vous pouvez retirer le mot cl INVITE. L'outil WebFacing prend en charge l'opration INVITE d'une manire diffrente des units 5250. La principale diffrence est que le temporisateur de l'opration READ est gr par le navigateur. Cette diffrence est due au fait qu'une application peut craser les enregistrements d'cran affichs sur un cran 5250, mais qu'elle ne peut pas craser la page affiche dans un navigateur sans que le contrle ne soit rendu l'application. L'implmentation du temporisateur dans le navigateur permet ce dernier de rendre le contrle l'application aprs expiration du temporisateur. Par dfaut, l'outil WebFacing utilise la valeur du paramtre WAITRCD pour le temporisateur du navigateur. Cependant, vous pouvez remplacer

164

Dveloppement des applications WebFacing

cette valeur dans les proprits du projet WebFacing. Les paragraphes suivants dcrivent le fonctionnement du temporisateur tel qu'il est implment par l'outil WebFacing. Le tableau ci-dessous prsente en dtails le comportement de l'opration INVITE. Si le paramtre WAITRCD est dfini sur *IMMED, le navigateur expirera immdiatement. Vous pouvez remplacer la valeur de WAITRCD dans les proprits d'excution de votre projet WebFacing pour modifier le dlai pendant lequel le navigateur attend qu'une opration de lecture soit effectue sur les units invites. Dans la page de proprits Excution de votre application WebFacing, slectionnez Projet, cochez la case Modifier le dlai d'attente d'enregistrement maximum (WAITRCD) des fichiers DDS et indiquez le dlai maximum en secondes ou *NOMAX. A l'expiration de l'opration INVITE, une alerte est gnre dans le navigateur si vous avez activ la bote de dialogue d'expiration pour le mot cl INVITE. Dans la page de proprits Excution de votre application WebFacing, slectionnez Projet et cochez la case Afficher la bote de dialogue d'expiration du dlai pour INVITE. Lorsque l'alerte est gnre dans le navigateur, vous avez le choix entre rinitialiser le temporisateur pour l'opration INVITE ou laisser la transaction expirer. A l'expiration de la transaction, les donnes entres par l'utilisateur seront perdues. Si vous ne cochez pas la case Afficher la bote de dialogue d'expiration du dlai pour INVITE dans la page des proprits du projet, aucune alerte ne s'affichera l'expiration du dlai d'attente. Remarque : Si vous spcifiez une valeur suprieure au dlai d'expiration de la session indiqu sur le serveur WAS, la session du navigateur expirera avant l'opration INVITE. Vous devez spcifier une valeur infrieure au dlai d'expiration de la session dfini sur le serveur WAS. Vous pouvez changer le contenu de la bote de dialogue d'avertissement en modifiant le fichier timeout.jsp figurant dans le rpertoire \WebContent\webfacing\jsp\common\html de votre projet WebFacing. Vous pouvez galement modifier la dure d'affichage de l'avertissement. Par exemple, si vous souhaitez que l'avertissement disparaisse immdiatement sans intervention de l'utilisateur, vous pouvez dfinir le deuxime paramtre de la mthode window.setTimeout sur 0. Vous pouvez modifier les paramtres de la bote de dialogue en mettant jour le fichier webface.js correspondant votre dition (par exemple, webfac512.js pour la version 5.1.2) qui figure dans le rpertoire \WebContent\webfacing\ClientScript de votre projet WebFacing. Dans ce fichier, vous pouvez modifier des attributs tels que la taille et la position de la bote de dialogue d'avertissement. Vous pouvez modifier ces attributs en mettant jour les paramtres de la mthode window.showModalDialog. Le tableau suivant prsente les diffrences de traitement de l'opration INVITE entre l'application 5250 et l'outil WebFacing :
5250 Dlai WAITRCD Le dlai WAITRCD commence expirer lorsque l'opration de lecture sur les units invites est ralise par l'application. WebFacing Le dlai WAITRCD commence expirer lorsque l'opration d'criture avec invite est ralise par l'application.

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

165

WAITRCD dfini sur *IMMED

L'utilisateur peut entrer des donnes sans interruption jusqu' ce qu'il appuie sur une touche AID ou que l'opration INVITE en attente soit annule. S'il n'appuie pas sur une touche AID avant que l'application n'effectue une opration de lecture sur les units invites, une exception d'expiration est renvoye l'application, mais l'unit continuera accepter l'entre de donnes. L'utilisateur peut entrer des donnes sans interruption jusqu' ce qu'il appuie sur une touche AID ou que l'opration INVITE en attente soit annule. S'il n'appuie pas sur une touche AID avant que l'application n'effectue une opration de lecture sur les units invites et que le dlai en secondes spcifi pour WAITRCD est coul, une exception d'expiration est renvoye l'application, mais l'unit continuera accepter l'entre de donnes. L'utilisateur peut entrer des donnes sans interruption jusqu' ce qu'il appuie sur une touche AID ou que l'opration INVITE en attente soit annule. L'unit continuera accepter l'entre de donnes.

Le navigateur expirera immdiatement et l'utilisateur ne pourra pas entrer de donnes.

WAITRCD dfini sur une valeur trop faible

Le navigateur expirera une fois le dlai en secondes spcifi pour WAITRCD coul et l'utilisateur ne pourra pas entrer de donnes.

L'application ralise une opration de lecture(attente) (elle attend que l'utilisateur appuie sur une touche AID pour rendre le contrle l'application) au lieu d'une opration de lecture sur les units invites aprs une opration d'criture avec invite L'application ralise une opration de lecture sur les units invites en rponse une opration de lecture sur les units invites expire

Si WAITRCD n'est pas dfini sur *NOMAX, le navigateur risque d'expirer et les donnes entres seront alors perdues. La lecture(attente) entranera le raffichage du format d'enregistrement invit et activera l'entre de donnes, sans les donnes prcdemment entres. Le navigateur expirera et les donnes entres seront alors perdues. Chaque nouvelle opration de lecture sur les units invites entranera le raffichage du format d'enregistrement invit et activera l'entre de donnes, sans les donnes prcdemment entres.

L'utilisateur peut entrer des donnes sans interruption jusqu' ce qu'il appuie sur une touche AID ou que l'opration INVITE en attente soit annule. L'unit continuera accepter l'entre de donnes.

166

Dveloppement des applications WebFacing

Annulation d'une opration INVITE lorsque WAITRCD est dfini sur *NOMAX ou sur une valeur trop leve

La demande INVITE en attente est annule presque immdiatement pour une demande explicite (ENDRCV par exemple) ou implicite (criture d'un autre format d'enregistrement), si la demande est traite avant que l'utilisateur n'appuie sur une touche AID. L'cran continuera accepter l'entre de donnes.

La demande INVITE en attente est annule l'expiration du navigateur ou lorsque l'utilisateur appuie sur une touche AID. Les demandes implicites ne sont ralises qu' l'expiration du navigateur. Si l'utilisateur n'appuie pas sur une touche AID, une demande d'annulation ne peut tre ralise avant la fin du dlai en secondes dfini pour WAITRCD. Si WAITRCD est dfini sur *NOMAX et que l'utilisateur n'appuie sur aucune touche AID, la demande ne sera jamais ralise. La demande de suspension ne peut tre ralise avant la fin du dlai en secondes dfini pour WAITRCD. Si WAITRCD est dfini sur *NOMAX et que l'utilisateur n'appuie sur aucune touche AID, la demande ne sera jamais ralise.

Suspension d'une opration INVITE lorsque WAITRCD est dfini sur *NOMAX ou sur une valeur trop leve

La demande INVITE en attente est presque immdiatement suspendue.

INZINP
Catgorie Gnration d'cran Autres informations

INZRCD
Catgorie Gnration d'cran Autres informations

KEEP
Catgorie Gnration d'cran Autres informations

LOCK
Catgorie Gnration d'cran Autres informations

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

167

LOGINP
Catgorie Tampon d'E-S Autres informations Ce mot cl est totalement pris en charge. Le tampon d'entre est enregistr dans l'historique du travail WebFacing. Remarque : Pour trouver les travaux actifs de WebFacing, recherchez QQFxxxxxxx dans le sous-systme QUINTER.

BLINK
Catgorie Curseur Autres informations

LOGOUT
Catgorie Tampon d'E-S Autres informations Ce mot cl est totalement pris en charge. Le tampon de sortie est enregistr dans l'historique du travail WebFacing. Remarque : Pour trouver les travaux actifs de WebFacing, recherchez QQFxxxxxxx dans le sous-systme QUINTER.

LOWER
Catgorie Tampon d'E-S Autres informations

MAPVAL
Catgorie Valeurs de zone Autres informations

MDTOFF
Catgorie Gnration d'cran Autres informations MDTOFF n'est pris que partiellement en charge. Il est admis dans le cas o il permet de dsactiver une marque de donnes modifies pour que l'indicateur de rponse du mot cl CHANGE ne soit pas dclench. Imaginons par exemple que l'enregistrement RECORD1 est envoy l'cran. L'utilisateur modifie ensuite une zone dans RECORD1, la marque de donnes modifies est donc active. Lorsque RECORD1 est lu, si le mot cl CHANGE est spcifi pour l'enregistrement, l'indicateur de rponse CHANGE est activ. Ensuite, si un autre enregistrement RECORD2 avec

168

Dveloppement des applications WebFacing

spcification du mot cl MDTOFF est crit, la marque de donnes modifies pour la zone de RECORD1 est efface et lors d'une seconde lecture de RECORD1, l'indicateur de rponse CHANGE de cet enregistrement n'est plus activ. Cependant, MDTOFF ne permet pas actuellement d'agir sur le comportement sur cran, par exemple le contrle de validit. Imaginons un enregistrement RECORDA dot d'une zone FIELDA pour laquelle les mots cls VALUES et DSPATR(MDT) sont spcifis. Avant l'envoi de l'enregistrement RECORDA l'cran, une valeur qui n'est pas indique dans le mot cl VALUES associ est attribue FIELDA. L'enregistrement RECORDA est ensuite envoy l'cran et l'utilisateur doit modifier la valeur de FIELDA pour qu'elle corresponde une valeur indique dans le mot cl VALUES associ. Sinon, le contrle de validit choue lorsque l'utilisateur appuie sur "Entre" ou sur une touche CF. Toutefois, si un enregistrement RECORDB accompagn de MDTOFF est envoy l'cran, il efface la marque de donnes modifies dfinie pour FIELDA. Le contrle de validit est alors ignor lorsque l'utilisateur appuie sur "Entre" ou sur une touche CF. Dans WebFacing, les consquences de MDTOFF sur ce type de comportement l'cran ne sont pas prises en charge.

MLTCHCFLD
Catgorie Aspect graphique Autres informations

MNUBAR
Catgorie Aspect graphique Autres informations

MNUBARCHC
Catgorie Aspect graphique Autres informations

MNUBARDSP
Catgorie Aspect graphique Autres informations

MNUBARSEP
Catgorie Aspect graphique Autres informations

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

169

MNUBARSW
Catgorie Aspect graphique Autres informations

BLKFOLD
Catgorie Position de zone Autres informations Sur un cran 5250, les donnes sont par dfaut renvoyes la ligne la fin de la ligne physique. Ce mot cl au niveau de la zone est utilis pour les zones nommes, de sortie seulement (mais pas pour les zones de message ou les zones de programme systme) qui sont dfinies de faon dborder sur les lignes d'affichage suivantes. Ce mot cl provoque le renvoi la ligne lorsqu'un espace est dtect dans les informations, et non pas la fin de la ligne d'affichage. Il permet de faciliter la lecture des zones de texte longues. Sur le Web, les informations ne passent pas la ligne.

MNUCNL
Catgorie Aspect graphique Autres informations

MOUBTN
Catgorie Touches de fonction Autres informations

MSGALARM
Catgorie Messages Autres informations

MSGCON
Catgorie Constantes Autres informations

MSGID
Catgorie Valeurs de zone Autres informations

170

Dveloppement des applications WebFacing

MSGLOC
Catgorie Messages Autres informations

NOCCSID
Catgorie Activation NLS Autres informations

OPENPRT
Catgorie Gnration d'cran Autres informations

OVERLAY
Catgorie Gnration d'cran Autres informations Ce mot cl est totalement pris en charge. Cependant des restrictions peuvent s'appliquer en fonction du niveau de prise en charge des autres mots cls. Par exemple, si un enregistrement pour lequel le mot cl OVERLAY est actif est dj l'cran, il est supprim et rcrit comme nouvel enregistrement, mme si les mots cls PUTOVR, PUTRETAIN ou CLRL sont indiqus. Une difficult se produit lorsqu'un enregistrement se trouve l'cran entre un contrle de sous-fichier et le sous-fichier associ. Par exemple, l'enregistrement RecordA occupe les lignes 10 12, le contrle SFLCTLB occupe les lignes 1 9, et SubfileB (enregistrement de sous-fichier associ SFLCTLB), les lignes 13 23. Si l'enregistrement RecordA est crit, puis le contrle SFLCTLB, RecordA est effac de l'cran. Dans le cas d'un 5250, l'enregistrement RecordA ne serait pas effac de l'cran.

OVRATR/OVRDTA
Catgorie Gnration d'cran Autres informations

CAnn/CFnn
Catgorie Touches de fonction Autres informations Ce mot cl est totalement pris en charge, mais le texte en option est ignor par la conversion. Ce texte sert uniquement de commentaire dans le fichier ou le programme.
Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

171

Les informations d'indicateur associes restent disponibles dans le fichier cran lorsque des commandes telles que DSPFFD sont lances sur le systme IBM i. Cependant, ces commentaires ne sont pas disponibles aprs conversion dans les pages JSP ou les fichiers XML.

PAGEDOWN/PAGEUP
Catgorie Touches de fonction Autres informations Aprs conversion, les mots cls PAGEDOWN/PAGEUP sont reprsents comme des boutons de fonction sur la page Web. Ils remplacent les touches PgAv/PgAr du clavier de l'utilisateur. Si PAGEDOWN ou PAGEUP est dsactiv dans le source DDS, aucun bouton de fonction n'apparat dans la page Web convertie pour le mot cl dsactiv. Le texte en option est ignor par la conversion, mais il figure toujours dans la liste cre au moment de la compilation du programme pour expliquer quel fin l'indicateur est utilis. Ce texte sert uniquement de commentaire dans le fichier ou le programme.

PASSRCD
Catgorie Gnration d'cran Autres informations

PRINT(*PGM/ind rponse)
Catgorie Touches de fonction Autres informations

PRINT/PRINT(bib/fichier)
Catgorie Touches de fonction Autres informations

PROTECT
Catgorie Gnration d'cran Autres informations

PSHBTNCHC
Catgorie Aspect graphique Autres informations

172

Dveloppement des applications WebFacing

PSHBTNFLD
Catgorie Aspect graphique Autres informations

PULLDOWN
Catgorie Aspect graphique Autres informations

PUTOVR
Catgorie Gnration d'cran Autres informations PUTOVR est un mot cl du niveau enregistrement utilis avec OVRATR ou OVRDTA pour autoriser la substitution des attributs d'affichage et/ou du contenu de donnes de zones spcifiques. En utilisant PUTOVR, vous pouvez rduire la quantit de donnes envoyes aux crans 5250. Dans WebFacing, toutes les zones sont envoyes au navigateur Web lorsqu'une page est affiche ; WebFacing ne prend pas en charge la mise jour partielle d'une page Web. L'utilisation de PUTOVR dans WebFacing ne prsente donc pas d'intrt en termes de performances. Ce mot cl n'est pas pris en charge par WebFacing et il sera ignor. Votre application ne fonctionnera donc peut-tre pas comme l'interface 5250. Par exemple, sur une interface de ce type, l'opration de sortie d'un enregistrement comprenant le mot cl PUTOVR ne met jour que l'enregistrement PUTOVR (elle ne met jour que les zones comprenant le mot cl OVRATR ou OVRDTA). Les enregistrements existants de l'cran ne sont pas touchs. Cependant, lorsque la mme opration de sortie est excute dans WebFacing, tous les enregistrements existants de l'cran sont supprims si le mot cl OVERLAY n'a pas t indiqu dans l'enregistrement PUTOVR. Pour viter que les enregistrements existants ne soient supprims, vous pouvez ajouter le mot cl OVERLAY l'enregistrement pour lequel le mot cl PUTOVR est indiqu.

PUTRETAIN
Catgorie Gnration d'cran Autres informations

CCSID
Catgorie Activation NLS Autres informations

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

173

RANGE (alphanumrique)
Catgorie Validation Autres informations

RANGE (numrique)
Catgorie Validation Autres informations Sur le Web, pour les zones numriques, la vrification de RANGE est toujours effectue lorsque la zone est modifie par l'utilisateur ou que la marque de donnes modifies qui lui est associe (MDT) est active l'aide de DSPATR(MDT). La marque MDT n'est pas dsactive lors de la vrification de la zone modifie. Les donnes qui ne font pas partie de la plage de valeurs spcifie par le mot cl RANGE ne peuvent donc pas tre soumises au programme si le mot cl MDT est dsactiv en permanence.

REF
Catgorie Valeurs la compilation Autres informations Pour les mots cls REF ou REFFLD, vous devez vous assurer que la bibliothque contenant les champs de base de donnes rfrencs est rpertorie dans la liste des bibliothques pour le profil utilis au cours de la conversion. Sinon, l'erreur suivante se produit au cours de la conversion et les formats d'enregistrement contenant les champs rfrencs ne sont pas convertis : Le fichier indiqu pour le mot cl REF ou REFFLD est introuvable.

REFFLD
Catgorie Valeurs la compilation Autres informations Pour les mots cls REF ou REFFLD, vous devez vous assurer que la bibliothque contenant les champs de base de donnes rfrencs est rpertorie dans la liste des bibliothques pour le profil utilis au cours de la conversion. Sinon, l'erreur suivante se produit au cours de la conversion et les formats d'enregistrement contenant les champs rfrencs ne sont pas convertis : Le fichier indiqu pour le mot cl REF ou REFFLD est introuvable.

RETKEY/RETCMDKEY
Catgorie Touches de fonction Autres informations Actuellement, les mots cls RETKEY et RETCMDKEY spcifis pour un

174

Dveloppement des applications WebFacing

enregistrement permettent de conserver les touches actives en cours l'cran lorsque l'enregistrement est crit. Cependant les indicateurs de rponse indiqus pour les cls conserves ne sont pas retransmises au programme RPG comme c'est le cas sur le 5250.

RETLCKSTS
Catgorie Gnration d'cran Autres informations

RMVWDW
Catgorie Fentre Autres informations

ROLLUP/ROLLDOWN
Catgorie Touches de fonction Autres informations Aprs conversion, les mots cls ROLLUP/ROLLDOWN sont reprsents comme des boutons de fonction sur la page Web. Ils remplacent respectivement les touches PgAv/PgAr du clavier de l'utilisateur. Si ROLLUP ou ROLLDOWN est dsactiv dans le source DDS, aucun bouton de fonction n'apparat dans la page Web convertie pour le mot cl dsactiv. Le texte en option est ignor par la conversion, mais il figure toujours dans la liste cre au moment de la compilation du programme pour expliquer quel fin l'indicateur est utilis. Ce texte sert uniquement de commentaire dans le fichier ou le programme.

RTNCSRLOC(*RECNAME| *WINDOW)
Catgorie Curseur Autres informations Puisqu'un caret est souvent utilis dans les applications Web au lieu d'un curseur, le troisime paramtre facultatif qui renvoie la position du curseur dans une zone est pris en charge comme suit : v les zones de sortie uniquement renvoient une position de curseur gale 1 quel que soit l'endroit o l'utilisateur clique v les zones d'entre renvoient : L'entier 1 lorsque le caret est plac avant la premire position Un entier compris entre 1 et n lorsque le caret est plac droite de la position du curseur correspondante

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

175

RTNCSRLOC(*MOUSE)
Catgorie Curseur Autres informations

CHANGE
Catgorie Tampon d'E-S Autres informations Ce mot cl est totalement pris en charge, mais le texte en option est ignor par la conversion. Ce texte sert uniquement de commentaire dans le fichier ou le programme. Les informations d'indicateur associes restent disponibles dans le fichier cran lorsque des commandes telles que DSPFFD sont lances sur le systme IBM i. Cependant, ces commentaires ne sont pas disponibles aprs conversion dans les pages JSP ou les fichiers XML.

RTNDTA
Catgorie Gnration d'cran Autres informations

SETOF/SETOFF
Catgorie Tampon d'E-S Autres informations

SFL
Catgorie Sous-fichiers Autres informations Le mot cl SFL est pris en charge. Cependant, des restrictions s'appliquent car tous les mots cls de sous-fichier associs ne sont pas encore totalement pris en charge. Pour connatre les autres restrictions, reportez-vous aux diffrents mots cls de sous-fichier. Remarque : La mise en oeuvre de sous-fichiers WebFacing entrane des diffrences de comportement entre une application 5250 et une application WebFacing. L'application 5250 traite l'enregistrement de contrle du sous-fichier et le sous-fichier comme des entits diffrentes ; l'un des deux peut tre chevauch. WebFacing les traite comme une seule entit, si bien que l'enregistrement de contrle du sous-fichier et le sous-fichier peuvent tre supprims si d'autres enregistrements chevauchent l'un d'entre eux.

176

Dveloppement des applications WebFacing

SFLCHCCTL
Catgorie Sous-fichiers Autres informations

SFLCLR
Catgorie Sous-fichiers Autres informations

SFLCSRPRG
Catgorie Sous-fichiers Autres informations

SFLCSRRRN
Catgorie Sous-fichiers Autres informations

SFLCTL
Catgorie Sous-fichiers Autres informations La mise en oeuvre de sous-fichiers WebFacing entrane des diffrences de comportement entre une application 5250 et une application WebFacing. L'application 5250 traite l'enregistrement de contrle du sous-fichier et le sous-fichier comme des entits diffrentes ; l'un des deux peut tre chevauch. WebFacing les traite comme une seule entit, si bien que l'enregistrement de contrle du sous-fichier et le sous-fichier peuvent tre supprims si d'autres enregistrements chevauchent l'un d'entre eux.

SFLDLT
Catgorie Sous-fichiers Autres informations

SFLDROP
Catgorie Sous-fichiers Autres informations

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

177

CHCACCEL
Catgorie Aspect graphique Autres informations

SFLDSP
Catgorie Sous-fichiers Autres informations

SFLDSPCTL
Catgorie Sous-fichiers Autres informations

SFLEND
Catgorie Sous-fichiers Autres informations Le mot cl SFLEND est pris en charge sous forme de barre de dfilement par dfaut sur le Web. Cette barre fournit les informations suivantes sur le sous-fichier : v L'emplacement o se trouve l'utilisateur dans le sous-fichier. v La taille du sous-fichier. v La proportion du sous-fichier qui est visualise par l'utilisateur. Le signe plus (+) ou du texte (A suivre... ou Fin) ne s'affiche pas sur le Web. Notez que la barre de dfilement affiche sur le Web est diffrente de celle fournie par SFLEND(*SCRBAR) sur le systme 5250. Sur ce dernier, si *SCRBAR est utilis comme paramtre sur SFLEND, c'est une barre de dfilement graphique qui apparatra sur les affichages graphiques. Dans ce cas, si vous cliquez sur les flches vers le haut et vers le bas, vous n'obtiendrez pas le mme rsultat que si vous slectionnez les touches Page suivante et Page prcdente. En cliquant sur les flches vers le haut et vers le bas, vous ne ferez dfiler qu'un seul enregistrement de sous-fichier. Si vous slectionnez les touches Page suivante et Page prcdente, vous ferez dfiler une page de l'enregistrement. Sur le Web, le fait d'appuyer sur les flches vers le haut et vers le bas a le mme impact que le fait d'appuyer sur les touches Page suivante et Page prcdente : une page de l'enregistrement de sous-fichier dfile.

SFLENTER
Catgorie Sous-fichiers Autres informations

178

Dveloppement des applications WebFacing

SFLFOLD
Catgorie Sous-fichiers Autres informations

SFLINZ
Catgorie Sous-fichiers Autres informations

SFLLIN
Catgorie Sous-fichiers Autres informations

SFLMLTCHC
Catgorie Sous-fichiers Autres informations

SFLMODE
Catgorie Sous-fichiers Autres informations

SFLMSG
Catgorie Sous-fichiers Autres informations

CHCAVAIL
Catgorie Aspect graphique Autres informations

SFLMSGID
Catgorie Sous-fichiers Autres informations

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

179

SFLMSGKEY
Catgorie Sous-fichiers Autres informations

SFLMSGRCD
Catgorie Sous-fichiers Autres informations

SFLNXTCHG
Catgorie Sous-fichiers Autres informations

SFLPAG
Catgorie Sous-fichiers Autres informations

SFLPGMQ/SFLMSGKEY/SFLMSGRCD
Catgorie Sous-fichiers Autres informations

SFLRCDNBR
Catgorie Sous-fichiers Autres informations

SFLRNA
Catgorie Sous-fichiers Autres informations

SFLROLVAL
Catgorie Sous-fichiers Autres informations SFLROLVAL n'est gnralement pas implment. Cependant, certains programmeurs DDS affectent la valeur 0 ou une valeur ngative la zone SFLROLVAL pour pouvoir dsactiver les touches PgAr et PgAv (un message d'erreur est mis lorsqu'elles sont utilises) et pour dfinir des

180

Dveloppement des applications WebFacing

touches de fonction personnalises pour contrler le dfilement des pages. Dans ce cas, la zone SFLROLVAL n'est normalement pas affiche. Nous vrifions si la zone SFLROLVAL est invalide (valeur 0 ou ngative) et si l'attribut d'affichage pour la zone SFLROLVAL est conditionn sur "non affichage", nous n'affichons pas la barre de dfilement.

SFLRTNSEL
Catgorie Sous-fichiers Autres informations

CHCCTL
Catgorie Aspect graphique Autres informations

SFLSCROLL
Catgorie Sous-fichiers Autres informations

SFLSIZ
Catgorie Sous-fichiers Autres informations

SFLSNGCHC
Catgorie Sous-fichiers Autres informations

SLNO (*VAR)
Catgorie Position de zone Autres informations

SLNO(n)
Catgorie Position de zone Autres informations

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

181

SNGCHCFLD
Catgorie Aspect graphique Autres informations

SYSNAME
Catgorie Constantes Autres informations

TEXT
Catgorie Valeurs la compilation Autres informations Les informations TEXT associes sont stockes dans l'objet de fichier cran. Aprs la compilation du fichier cran, les informations TEXT associes restent disponibles lorsque des commandes telles que DSPFFD sont lances sur le systme IBM i. Cependant, ces commentaires ne sont pas disponibles aprs conversion dans les pages JSP ou les fichiers XML.

TIME
Catgorie Constantes Autres informations

TIMFMT
Catgorie Validation Autres informations

CHCSLT
Catgorie Aspect graphique Autres informations

TIMSEP
Catgorie Apparence Autres informations

182

Dveloppement des applications WebFacing

UNLOCK
Catgorie Gnration d'cran Autres informations

USER
Catgorie Constantes Autres informations

USRDFN
Catgorie Gnration d'cran Autres informations

USRDSPMGT
Catgorie Gnration d'cran Autres informations

USRRSTDSP
Catgorie Fentre Autres informations

VALNUM
Catgorie Validation Autres informations Sur le Web, ce mot cl provoque le renvoi d'un message d'erreur si l'utilisateur tente d'insrer un espace, un signe plus ou un signe moins entre des caractres numriques dans la zone. Cependant lorsque le signe plus ou le signe moins prcde les caractres numriques, il est admis sur le Web, mais pas sur le systme 5250.

VALUES
Catgorie Validation Autres informations Le mot cl VALUES est pris en charge sur le Web en tant que zone de slection choix unique dans laquelle les valeurs admises sont rpertories. L'utilisateur n'est pas autoris entrer de valeurs qui ne sont pas dans cette liste.

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

183

Si une valeur du programme est envoye dans la zone et qu'elle n'est pas spcifie dans le mot cl VALUES, elle peut tre soumise au programme si l'utilisateur ne modifie pas la zone. Une fois que la zone ou que la marque de donnes (MDT) associe est modifie, seules les entres dfinies par le mot cl VALUES peuvent tre soumises au programme.

VLDCMDKEY
Catgorie Touches de fonction Autres informations

WDWBORDER
Catgorie Fentre Autres informations

ALTHELP
Catgorie Touches de fonction Autres informations Ce mot cl est pris en charge par dfaut. La fonction ALTHELP permettant d'utiliser une touche CA (command attention) comme touche d'aide de remplacement n'est pas ncessaire dans les applications Web et n'est pas prise en charge. Le mot cl HELP tant pris en charge en tant que bouton de fonction, l'aide est disponible dans l'application Web et un deuxime bouton de fonction est inutile.

CHCUNAVAIL
Catgorie Aspect graphique Autres informations

WDWTITLE
Catgorie Fentre Autres informations Les paramtres [texte-titre] et [*CENTER|*LEFT|*RIGHT] sont pris en charge. Les paramtres de type [couleur-texte-titre], [attribut-affichagetexte-titre] et [*TOP|*BOTTOM] ne sont pas pris en charge et seront ignors.

WINDOW(dfinition)
Catgorie Fentre Autres informations

184

Dveloppement des applications WebFacing

Ce mot cl au niveau de l'enregistrement est utilis pour spcifier que le format d'enregistrement dfini s'affichera dans une fentre. Une fentre correspond de l'information qui recouvre une partie de l'affichage. En gnral, la taille d'affichage d'une fentre est plus petite que celle du poste de travail. La fentre peut tre positionne n'importe o sur l'cran. Les paramtres *NOMSGLIN et *RSTCSR ne sont pas pris en charge pour ce mot cl. Le paramtre *NOMSGLIN indique que la ligne de message doit tre retire de la fentre et positionne au bas de l'cran. Le paramtre *RSTCSR indique que les fonctions autorises pour l'utilisateur sont limites lorsque le curseur est en dehors de la fentre.

WINDOW(rference)
Catgorie Fentre Autres informations

WRDWRAP
Catgorie Apparence Autres informations Ce mot cl au niveau du fichier, de l'enregistrement ou de la zone est utilis pour les zones nommes qui sont dfinies de faon dborder sur les lignes d'affichage suivantes ou pour les zones d'entre prolonge. Ce mot cl provoque le passage la ligne lorsqu'un espace est dtect dans les informations, et non pas la fin de la ligne de donnes. Il permet de faciliter la lecture des zones de texte longues. Sur le 5250, les donnes passent par dfaut la ligne la fin de la ligne physique ou du segment de zone d'entre prolonge. L'effet de ce mot cl est le comportement par dfaut dans les applications Web converties.

(7-16) Paramtres d'environnement


Catgorie Indicateurs Autres informations

(29) Rfrence
Catgorie Valeurs la compilation Autres informations Pour les mots cls REF ou REFFLD, vrifiez que la bibliothque contenant les zones de la base de donnes rfrence est ajoute la liste de bibliothques avant de convertir les fichiers source DDS.

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

185

(30-34) Longueur
Catgorie Apparence Autres informations

(35) Type de donnes (tampon)


Catgorie Tampon d'E-S Autres informations

(35) Type de donnes/Touche Maj du clavier


Catgorie Validation Autres informations L'utilisation de cette entre est admise pour toutes les Options clavier l'exception de F (virgule flottante). Numrique sign (S) : Seuls les chiffres de 0 9 et le caractre de soulignement '-' sont admis. Numrique (N) et Numrique seulement (Y) : WebFacing ignore les espaces avant et aprs mais autorise les espaces imbriqus. Sont autoriss : les signes + et - avant et aprs les chiffres et les espaces imbriqus entre les chiffres et ces signes traits comme des espaces de fin. Le comportement 5250 varie lors de l'affichage des donnes. Par exemple, une zone contenant la valeur -5 (longueur 4 et 0 position dcimale) s'affiche sous la forme -0005 au lieu de 000N.

(36-37) Position dcimale


Catgorie Tampon d'E-S Autres informations

CHECK
Catgorie Validation Autres informations Les valeurs suivantes NE SONT PAS prises en charge. v M10F (vrification de modulo 10 lors de l'entre) est prise en charge en tant que M10 v M11F (vrification de modulo 11 lors de l'entre) est prise en charge en tant que M11 v M10/M10F et M11/M11F sont ignores pour les zones alphanumriques.

186

Dveloppement des applications WebFacing

(38) Emploi M
Catgorie Messages Autres informations

(38) Emploi (I/O/B/H/P)


Catgorie Valeurs de zone Autres informations

(39-44) Emplacement
Catgorie Position de zone Autres informations Les zones sont positionnes l'aide de tables HTML. Il existe une table pour l'ensemble de l'cran DDS, qui contient 24 ou 27 lignes et 80 ou 132 colonnes selon la taille d'affichage de l'cran. Les zones sont places dans la cellule de la table qui correspond la ligne et la colonne DDS occupe. Passage la ligne (les zones qui dpassent de l'cran s'tendent sur les lignes suivantes): Pour les zones de sortie uniquement (qui incluent des zones de constante), le passage la ligne s'effectue au mme endroit dans la valeur de la zone que sur l'cran 5250. Une marque SPAN est utilise pour chaque ligne occupe par la zone l'cran. Les zones de sortie uniquement la ligne occupent le mme espace dans la table HTML que dans l'cran 5250. Le mot cl BLKFOLD n'a pas t mis en oeuvre. Pour les zones d'entre prolonge, le passage la ligne s'effectue lorsqu'un espace est dtect dans les informations, et non pas la fin de la ligne de donnes. Ce comportement est identique celui qui est obtenu par la spcification du mot cl WRDWRAP. Sur le 5250, les donnes passent par dfaut la ligne la fin de la ligne physique ou du segment de zone d'entre prolonge. Si les zones d'entre dpassent la limite de droite de la taille d'affichage (80 ou 132 colonnes), elles passent sur plusieurs lignes. Ces zones ne peuvent pas tre reprsentes exactement dans un code HTML qui n'autorise que les zones rectangulaires. La taille maximale du rectangle susceptible de tenir dans l'cran 5250 est dtermine pour la zone. Si le rectangle est sur une seule ligne, une marque INPUT est utilise avec une taille maximale suprieure la taille visuelle. Sinon, une marque TEXTAREA est utilise. Taille d'affichage : WebFacing convertit un enregistrement donn en une taille d'affichage unique. Des informations DSPSIZ supplmentaires sont disponibles dans le document DSPSIZ des tables de support des mots cls DDS de WebFacing.

DSPATR(PR CS)
Catgorie Apparence
Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

187

Autres informations L'attribut d'affichage CS peut varier selon le style que vous avez choisi pour votre application Web.

DSPATR(PC)
Catgorie Apparence Autres informations Il est possible que le curseur ne soit pas positionn sur la zone correcte lorsque le mot cl DSPATR(PC) est spcifi avec : 1. Une zone d'entre pour laquelle les mots cls DSPATR(ND) et DSPATR(PR) sont tous deux spcifis. 2. Une zone d'un sous-fichier avec le mot cl SFLFOLD, lorsque le sous-fichier est en mode troncature et que cette zone n'est donc pas visible.

DSPATR(BL)
Catgorie Apparence Autres informations

DSPATR(SP)
Catgorie Valeurs de zone Autres informations

CHGINPDFT(FE)
Catgorie Apparence Autres informations Ce mot cl s'applique aux commandes clavier des zones concernes admettant les entres tout comme le mot cl de niveau zone CHECK(FE). Sur le systme 5250, les touches de sortie de la zone incluent : Sortie de la zone, Zone+, Zone- et les touches de dplacement du curseur. Sur le Web, seule la touche Sortie de la zone est prise en charge. Vous pouvez activer une touche de sortie de la zone pour votre projet WebFacing. Dans la page de proprits Excution de votre application WebFacing, slectionnez Projet et cochez la case Touche de fin de zone, puis slectionnez une touche dans la liste pour activer la touche de sortie de la zone. Il n'y a pas d'quivalent aux touches Zone+ et Zone-. Vous devez entrer manuellement le signe + ou - devant le chiffre, puis utiliser la touche de tabulation ou la souris ou la touche de sortie de la zone.

CHECK(ER)/AUTO(RA)
Catgorie Validation Autres informations

188

Dveloppement des applications WebFacing

CHECK(RB)/AUTO(RAB)
Catgorie Tampon d'E-S Autres informations Sur le Web, lorsque le curseur n'est plus dans la zone o les donnes ont t entres, elles sont alignes droite avec remplissage par des blancs. Sur le systme 5250, les touches Sortie de la zone, Zone+, Zone- et les touches de dplacement du curseur peuvent tre utilises pour passer la zone d'entre suivante. Sur le Web, seule la touche Sortie de la zone est prise en charge. Vous pouvez activer une touche de sortie de la zone pour votre projet WebFacing. Dans la page de proprits Excution de votre application WebFacing, slectionnez Projet et cochez la case Touche de fin de zone, puis slectionnez une touche dans la liste pour activer la touche de sortie de la zone. Il n'y a pas d'quivalent aux touches Zone+ et Zone-. Vous devez entrer manuellement le signe + ou - devant le chiffre, puis utiliser la touche de tabulation ou la souris ou la touche de sortie de la zone pour passer une autre zone.

CHECK(RZ)/AUTO(RAZ)
Catgorie Validation Autres informations Sur le Web, lorsque le curseur n'est plus dans la zone o les donnes ont t entres, elles sont alignes droite avec remplissage par des blancs. Sur le systme 5250, les touches Sortie de la zone, Zone+, Zone- et les touches de dplacement du curseur peuvent tre utilises pour passer la zone d'entre suivante. Sur le Web, seule la touche Sortie de la zone est prise en charge. Vous pouvez activer une touche de sortie de la zone pour votre projet WebFacing. Dans la page de proprits Excution de votre application WebFacing, slectionnez Projet et cochez la case Touche de fin de zone, puis slectionnez une touche dans la liste pour activer la touche de sortie de la zone. Il n'y a pas d'quivalent aux touches Zone+ et Zone-. Vous devez entrer manuellement le signe + ou - devant le chiffre, puis utiliser la touche de tabulation ou la souris ou la touche de sortie de la zone pour passer une autre zone.

CHGINPDFT(ME MF LC CS)
Catgorie Validation Autres informations L'attribut d'affichage CS peut varier selon le style que vous avez choisi pour votre application Web.

CHGINPDFT(RI HI)
Catgorie Apparence Autres informations Les attributs d'affichage RI et HI peuvent varier selon le style que vous avez choisi pour votre application Web.
Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

189

CHGINPDFT/CHGINPDFT(UL/BL)
Catgorie Apparence Autres informations Ce mot cl s'applique aux attributs d'affichage spcifis des zones concernes admettant les entres. Sur le Web, les zones admettant les entres apparaissent toujours par dfaut comme des encadrs comportant des bordures. Sur un cran 5250, les zones admettant les entres sont affiches comme des zones d'entre et le mot cl DSPATR(UL) s'applique par dfaut aux deux types de zones lorsque CHGINPDFT n'est pas spcifi. CHGINPDFT n'est pas pris en charge pour les zones admettant les entres sur le Web, pour les valeurs de paramtre suivantes:
Valeur de paramtre aucun Mot cl DDS quivalent DSPATR(UL) spcifi mais non slectionn DSPATR(BL) DSPATR(UL) Signification Suppression du soulignement Zone clignotante Soulign Proprits Web La bordure de la zone d'entre n'est pas supprime. Non pris en charge Pris en charge en tant qu'attribut de texte et non de bordure.

BL UL

CHKMSGID
Catgorie Validation Autres informations

CHOICE
Catgorie Aspect graphique Autres informations

ALTNAME
Catgorie Valeurs la compilation Autres informations Ce mot cl est pris en charge par dfaut. Lors de la compilation d'un programme, le nom de remplacement est insr dans le programme la place du nom de format d'enregistrement DDS. Ces informations sont ensuite rsolues l'aide de l'objet DDS compil avant tout envoi de demande destination de formats d'enregistrement convertis. Les formats d'enregistrement convertis utilisent les noms de formats d'enregistrement DDS d'origine.

190

Dveloppement des applications WebFacing

CHRID
Catgorie Activation NLS Autres informations

EFFAC
Catgorie Touches de fonction Autres informations Aprs conversion, le mot cl CLEAR est reprsent comme un bouton de fonction sur la page Web. Ce bouton remplace l'utilisation de la touche d'effacement de l'cran sur le clavier de l'utilisateur. Si CLEAR est dsactiv dans le source DDS, aucun bouton de fonction n'apparat dans la page Web convertie. Le texte en option est ignor par la conversion, mais il figure toujours dans la liste cre au moment de la compilation du programme pour expliquer quel fin l'indicateur est utilis. Ce texte sert uniquement de commentaire dans le fichier ou le programme.

CLRL(nn|*END)
Catgorie Gnration d'cran Autres informations Les enregistrements CLRL sont pris en charge en tant que couches superposes l'cran avec des arrire-plans opaques, par dfaut. Bien que ce comportement ne soit pas standard, il est satisfaisant dans un environnement de navigation. La couleur d'arrire-plan des couches CLRL est identique celle du style que vous avez slectionn. Vous devez utiliser un style avec une couleur d'arrire-plan opaque pour que le texte situ dans les enregistrements sous-jacents n'apparaisse pas en dessous et ne s'affiche pas au mme endroit que les donnes de la couche superpose. Si vous souhaitez modifier l'arrire-plan par dfaut de la couche, vous pouvez mettre jour la classe de style wf_layer dans le fichier apparea.css du rpertoire /WebContent/webfacing/styles/apparea. Vous pouvez utiliser des enregistrements CLRL de sortie seulement pour occuper les lignes situes au-dessus et en dessous des enregistrements pour lesquels l'application attend une entre. Vous ne pouvez pas procder de cette manire dans WebFacing car l'intgralit de l'enregistrement CLRL sera rendue opaque et les parties superposes des enregistrements ne seront ni visibles ni accessibles. La solution de contournement de ce scnario non pris en charge consiste diviser l'enregistrement CLRL de sortie seulement en deux enregistrements contenant les zones situes respectivement au-dessus et en dessous de l'enregistrement d'entre. Le mot cl CLRL n'est pas encore pris en charge pour les formats d'enregistrement avec le mot cl WINDOW et est donc ignor. Simulation de fentre avec CLRL : Si les mots cls CLRL(*NO) ou CLRL(nn) sont utiliss pour mettre en oeuvre un enregistrement de type fentre dans DDS, WebFacing tente de crer une fentre pour ce format

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

191

d'enregistrement afin de prendre en charge cette syntaxe gnrale. Pour CLRL(nn), nn doit tre infrieur la longueur d'enregistrement pour tre reconnu en tant que fentre. Pour qu'un enregistrement soit reconnu en tant que fentre, il ne doit pas contenir de zones hors de la zone rectangulaire destine former la fentre. Une solution de rechange pour les dveloppeurs ayant dfini des labels de touche de fonction (ou d'autres constantes non essentielles) hors de la zone de la fentre consiste masquer lesdites zones l'aide des paramtres Web. WebFacing respectera ces paramtres Web et dtectera correctement le rectangle. L'algorithme de reconnaissance de fentre CLRL est bas sur les modles de fentre CLRL courants. Les rgles suivantes doivent tre respectes pour les bordures suprieure et latrales de la fentre simule afin que la dtection puisse avoir lieu : 1. Pour la bordure suprieure, WebFacing vrifie qu'une zone de constante ou une zone de sortie occupe l'espace de (premire ligne, premire colonne) (premire ligne, dernire colonne) et l'utilise comme titre de fentre. Si une zone de constante est utilise et que le mme caractre est rpt de (premire ligne, premire colonne+1) (premire ligne, dernire colonne-1), les caractres utiliss pour former la bordure suprieure ne seront pas utiliss comme titre et seront simplement supprims. 2. Pour les bordures latrales, WebFacing vrifie la zone de constante de la deuxime ligne de l'enregistrement l'avant-dernire ligne. La mme chane doit tre utilise pour les bordures gauche et droite de la fentre simule. Dans ce cas, les chanes utilises pour former les bordures latrales seront supprimes. Remarque : La bordure infrieure de la fentre simule ne sera pas modifie, car cette ligne est parfois utilise pour afficher des messages. Le comportement 5250 suivant n'est pas intuitif et ne sera pas simul : Un enregistrement CLRL sans zone avec entre n'occupe aucun espace l'cran. Si un enregistrement CLRL(*ALL) sans zones avec entre est crit, l'cran est d'abord effac, puis l'enregistrement s'affiche. Cependant, les enregistrements qui figuraient l'cran prcdemment ne seront pas supprims de la table ART et seront utiliss ultrieurement pour la vrification OVERLAY (de chevauchement). Si un enregistrement de type OVERLAY est crit, il vrifiera d'abord si des enregistrements de la table ART se chevauchent. Dans ce cas, ces enregistrements sont supprims de la table ART et les lignes provenant de ces enregistrements sont effaces avant que l'enregistrement OVERLAY ne soit crit l'cran. La rgle ci-dessus s'applique galement CLRL(nn|*END|*NO). Le comportement de WebFacing est diffrent, car seuls les enregistrements affichs l'cran sont pris en compte lors de la vrification du chevauchement. Les enregistrements qui se trouvent dans la table ART mais qui ne sont pas affichs l'cran ne sont pas pris en compte.

CLRL(*ALL)
Catgorie Gnration d'cran

192

Dveloppement des applications WebFacing

Autres informations Des informations CLRL supplmentaires sont disponibles dans le document CLRL(nn|*END) des tables de support des mots cls DDS de WebFacing.

CLRL(*NO)
Catgorie Gnration d'cran Autres informations Des informations CLRL supplmentaires sont disponibles dans le document CLRL(nn|*END) des tables de support des mots cls DDS de WebFacing.

CMP
Catgorie Validation Autres informations Les mots cls CMP/COMP des zones de type caractre sont admis uniquement pour les oprateurs relationnels EQ et NE. Les valeurs numriques sont totalement prises en charge.

CNTFLD
Catgorie Aspect graphique Autres informations Les zones d'entre prolonge sont converties en zones d'entre unique sous la forme de zones de texte HTML. Dans DDS, si une zone d'entre de 60 caractres est spcifie avec le mot cl CNTFLD(10), vous obtenez 6 lignes de 10 caractres chacune pour la zone et l'utilisateur ne peut entrer que 60 caractres au maximum. La zone de texte est galement dfinie avec 6 lignes et 10 colonnes (par exemple <TEXTAREA rows="6" cols="10">) et l'utilisateur ne peut entrer que 60 caractres au maximum. Toutefois, le nombre de caractres sur chaque ligne et le nombre de lignes affiches dans la zone de texte varient en fonction de la police utilise pour l'application Web. Par exemple, sur un cran 5250, le texte entr dans une zone spcifie avec le mot cl CNTFLD(30) peut prendre l'aspect suivant :
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA AAAAAAAAAAAAAAAAAAAAAAAAAAA

Sur le Web, avec une police de caractres proportionnelle, vous verrez : AAAAAAAAAAAAAAAAAAAAA AAAAAAAAAAAAAAAAAAAAA AAAAAAAAAAAAAAAAAAAAA AAAAAAAAAAAAAAAAAAAAA AAA Remarque : La touche Entre du clavier n'est pas active pour les zones d'entre prolonge.
Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

193

COLOR
Catgorie Apparence Autres informations La couleur indique l'aide de ce mot cl est affiche selon le Style choisi dans l'assistant WebFacing.

COMP
Catgorie Validation Autres informations Les mots cls CMP/COMP des zones de type caractre sont admis uniquement pour les oprateurs relationnels EQ et NE. Les valeurs numriques sont totalement prises en charge.

CSRINPONLY
Catgorie Curseur Autres informations Ce mot cl est pris en charge par dfaut. Le mot cl CSRINPONLY indique que le mouvement du curseur rsultant de l'utilisation des touches de dplacement est limit aux zones admettant les entres. C'est le comportement par dfaut de tous les navigateurs, ce mot cl s'applique donc tous les formats d'enregistrement convertis, mme s'il n'est pas spcifi dans le DDS d'origine.

ALTPAGEDWN
Catgorie Touches de fonction Autres informations Ce mot cl est pris en charge par dfaut. La fonction ALTPAGEDWN permettant d'utiliser une touche CF (command function) comme touche PgAv de remplacement n'est pas ncessaire dans les applications Web et n'est pas prise en charge. Le mot cl PAGEDWN tant pris en charge en tant que bouton de fonction, il est disponible dans l'application Web et un deuxime bouton de fonction est inutile.

CSRLOC
Catgorie Curseur Autres informations

DATE
Catgorie Constantes Autres informations

194

Dveloppement des applications WebFacing

DATEFMT
Catgorie Validation Autres informations

DATESEP
Catgorie Apparence Autres informations

DFT
Catgorie Valeurs de zone Autres informations En utilisation standard, le mot cl DFT peut s'appliquer aux zones d'entre seulement, de sortie seulement et d'entre-sortie. Sous WebFacing, DFT n'accepte que les zones d'entre seulement. Cela est d au fait que pour les zones de sortie seulement et d'entre-sortie, l'utilisateur doit spcifier le mot cl PUTOVR au niveau de l'enregistrement et OVRDTA au niveau de la zone. Mais PUTOVR n'tant pas pris en charge par WebFacing, uniquement les zones d'entre seulement sont possibles.

DFT (implicite)
Catgorie Valeurs de zone Autres informations Les zones de constante non nomme spcifies l'aide du mot cl DFT implicite sont reprsentes sous forme de texte HTML dans les pages JSP de l'enregistrement converti. Elles n'ont pas d'incidence sur le contenu de donnes dynamiques dans les beans enregistrement.

DFTVAL
Catgorie Valeurs de zone Autres informations DFTVAL est totalement pris en charge, mais OVRDTA ne l'est pas encore. Des carts avec le comportement 5250 peuvent tre remarqus dans le scnario suivant : Si l'cran reste en mode PUTOVR pendant 3 critures au moins du mme enregistrement, mais que OVRDTA n'est pas actif pour cette zone, la valeur du programme s'affiche la place de DFTVAL en raison du manque de prise en charge du mot cl OVRTDTA.

DLTCHK
Catgorie Valeurs la compilation

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

195

Autres informations La processus de conversion prend totalement en charge les zones rfrences et ignore le contrle de validit et les mots cls CHKMSGID si DLTCHK est spcifi. Remarque : Lorsque vous utilisez des zones rfrences, vrifiez que la bibliothque contenant la base de donnes rfrence figure dans la liste des bibliothques du profil utilis lors de la conversion.

DLTEDT
Catgorie Valeurs la compilation Autres informations La processus de conversion prend totalement en charge les zones rfrences et ignore les mots cls de mot d'dition et de code d'dition si DLTEDT est spcifi. Remarque : Lorsque vous utilisez des zones rfrences, vrifiez que la bibliothque contenant la base de donnes rfrence figure dans la liste des bibliothques du profil utilis lors de la conversion.

DSPATR (zone programme systme)


Catgorie Apparence Autres informations

ALTPAGEUP
Catgorie Touches de fonction Autres informations Ce mot cl est pris en charge par dfaut. La fonction ALTPAGEUP permettant d'utiliser une touche CF (command function) comme touche PgAr de remplacement n'est pas ncessaire dans les applications Web et n'est pas prise en charge. Le mot cl PAGEUP tant pris en charge en tant que bouton de fonction, il est disponible dans l'application Web et un deuxime bouton de fonction est inutile.

DSPATR(OID)
Catgorie Apparence Autres informations Le lecteur de carte tant spcifique au matriel 5250, cet attribut n'aura pas lieu d'tre dans une application Internet d'un navigateur Web.

DSPATR(MDT)
Catgorie Apparence Autres informations

196

Dveloppement des applications WebFacing

DSPATR(UL HI RI ND)
Catgorie Apparence Autres informations Les attributs indiqus l'aide de ce mot cl sont affichs selon le Style spcifi lors de la conversion.

DSPMOD (sans conditions)


Catgorie Gnration d'cran Autres informations Les mots cls DSPMOD conditionns ne sont pas encore pris en charge. Il n'est donc pas possible de modifier dynamiquement la taille d'affichage dans laquelle un enregistrement doit apparatre lors de l'excution. Il existe un paramtre Web au niveau de l'enregistrement permettant de spcifier la taille d'affichage laquelle un enregistrement doit tre converti.

DSPMOD (avec indicateurs d'option)


Catgorie Gnration d'cran Autres informations Les mots cls DSPMOD conditionns ne sont pas encore pris en charge. Il n'est donc pas possible de modifier dynamiquement la taille d'affichage dans laquelle un enregistrement doit apparatre lors de l'excution. Il existe un paramtre Web au niveau de l'enregistrement permettant de spcifier la taille d'affichage laquelle un enregistrement doit tre converti.

DSPRL
Catgorie Activation NLS Autres informations Les spcialiste du dveloppement Bidi ont indiqu que les cran taient, en rgle gnrale, dj cods de droite gauche et ce mot cl n'est pas ncessaires pour inverser la direction des chanes. Aucune demande concernant ce mot cl n'ayant t signale, il n'est pas prvu de l'implmenter.

DSPSIZ
Catgorie Gnration d'cran Autres informations WebFacing convertit un enregistrement donn en une taille d'affichage unique. Par dfaut, ce sera la taille d'affichage principale (correspondant au premier paramtre du mot cl DSPSIZ). Cette valeur peut tre remplace l'aide d'un mot cl DSPMOD sans conditions. Toutefois, pour les mots cls DSPMOD conditionns, si vous souhaitez utiliser la taille d'affichage secondaire, vous pouvez la spcifier l'aide de la vue Paramtres Web dans l'environnement de dveloppement intgr.
Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

197

L'outil WebFacing ne prend pas en charge la spcification de description des donnes de System/38. IBM i prend en charge les tailles d'affichage suivantes : v *DS3 - 24x80 v *DS4 - 27x132 System/38 prend galement en charge deux autres tailles : v *DS1 - Console v *DS2 - 12x80 Avant la version 6.0 de WebSphere Development Studio Client for iSeries, si une zone contenait plusieurs positions, la position *DS3 ou *DS4 tait utilise pour la conversion. L'exemple ci-aprs contient une constante (Constante de type texte), qui est dfinie sur la ligne infrieure de l'affichage :
A A A A DSPSIZ(*DS2 *DS3) R RECORD1 *DS3 12 1Constante de type texte 24 1

Si vous aviez converti cette source et demand la taille d'affichage *DS3 avant la version 6.0, la constante serait apparue sur la ligne 24. Maintenant elle apparat sur la ligne 12. L'analyseur syntaxique actuel supprime le paramtre *DS2 du mot cl DSPSIZ et considre *DS3 comme taille d'affichage principale. Il utilise donc la position de la constante sur la ligne de dfinition, c'est--dire 12, 1.

DUP
Catgorie Touches de fonction Autres informations

EDTCDE
Catgorie Apparence Autres informations

EDTCDE(5-9)
Catgorie Apparence Autres informations Les codes d'dition dfinis par l'utilisateur ne sont pas pris en charge par l'application WebFacing. Toutefois, vous pouvez les mapper vers l'un des codes d'dition systme disponibles en utilisant Options de code d'dition dans la page des proprits Conversion de l'application WebFacing.

ALWGPH
Catgorie Gnration d'cran Autres informations

198

Dveloppement des applications WebFacing

EDTMSK
Catgorie Validation Autres informations

EDTWRD
Catgorie Apparence Autres informations

ENTFLDATR
Catgorie Apparence Autres informations

ERASE
Catgorie Gnration d'cran Autres informations

ERASEINP
Catgorie Gnration d'cran Autres informations

ERRMSG
Catgorie Messages Autres informations Les zones admettant les entres sont toujours en image inverse, quels que soient les paramtres COLOR ou DSPATR actifs pour la zone concerne. Dans les applications Web, la notion de verrouillage du clavier n'existe pas. Le message est donc simplement affich dans une zone de slection, rien n'empchant l'utilisateur de continuer.

ERRMSGID
Catgorie Messages Autres informations Les zones admettant les entres sont toujours en image inverse, quels que soient les paramtres COLOR ou DSPATR actifs pour la zone concerne. Dans les applications Web, la notion de verrouillage du clavier n'existe pas. Le message est donc simplement affich dans une zone de slection, rien n'empchant l'utilisateur de continuer.
Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

199

Il n'existe pas encore d'aide de second niveau sur le message lorsque l'utilisateur clique sur le bouton Aide, l'erreur tant mise en vidence.

ERRSFL
Catgorie Messages Autres informations Dans un cran 5250, si la ligne de message chevauche un enregistrement qui est dj affich, le mot cl ERRSFL est ignor. Sur le Web, la ligne de message pouvant tout de mme tre affiche, le mot cl ERRSFL est pris en compte. Le mot cl MSGLOC qui permet de positionner la ligne de message est ignor.

FLDCSRPRG
Catgorie Curseur Autres informations

FLTFIXDEC
Catgorie Apparence Autres informations

ALWROL
Catgorie Gnration d'cran Autres informations

FLTPCN
Catgorie Tampon d'E-S Autres informations

FRCDTA
Catgorie Gnration d'cran Autres informations

GETRETAIN
Catgorie Gnration d'cran Autres informations

200

Dveloppement des applications WebFacing

GRDATR
Catgorie Aspect graphique Autres informations

GRDBOX
Catgorie Aspect graphique Autres informations

GRDCLR
Catgorie Aspect graphique Autres informations

GRDLIN
Catgorie Aspect graphique Autres informations

GRDRCD
Catgorie Aspect graphique Autres informations

HELP (mess. 2me niveau)


Catgorie Touches de fonction Autres informations

HELP (retour au prog.)


Catgorie Touches de fonction Autres informations

ASSUME (transfert de donnes)


Catgorie Gnration d'cran Autres informations

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

201

HELP (avec HLPARA)


Catgorie Touches de fonction Autres informations

HLPARA
Catgorie Aide de l'application Autres informations

HLPBDY
Catgorie Aide de l'application Autres informations

HLPCLR
Catgorie Aide de l'application Autres informations

HLPCMDKEY
Catgorie Aide de l'application Autres informations

HLPDOC
Catgorie Aide de l'application Autres informations Ce mot cl indique le nom du document utiliser pour fournir les informations d'aide. Ce type d'aide n'tant pas utilis, le mot cl HLPDOC n'est pas pris en charge.

HLPEXCLD
Catgorie Aide de l'application Autres informations

HLPFULL
Catgorie Aide de l'application Autres informations

202

Dveloppement des applications WebFacing

HLPID
Catgorie Aide de l'application Autres informations

HLPPNLGRP
Catgorie Aide de l'application Autres informations

ASSUME (pas d'effacement de l'cran)


Catgorie Gnration d'cran Autres informations

HLPRCD
Catgorie Aide de l'application Autres informations

HLPRTN
Catgorie Touches de fonction Autres informations

HLPSCHIDX
Catgorie Aide de l'application Autres informations

HLPSEQ
Catgorie Aide de l'application Autres informations

HLPSHELF
Catgorie Aide de l'application Autres informations

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

203

HLPTITLE
Catgorie Aide de l'application Autres informations

HOME
Catgorie Touches de fonction Autres informations Aprs conversion, le mot cl HOME est reprsent comme un bouton de fonction sur la page Web. Ce bouton remplace l'utilisation de la touche de retour du curseur en position 1 sur le clavier de l'utilisateur. Si HOME est dsactiv dans le source DDS, aucun bouton de fonction n'apparat dans la page Web convertie. Sur le clavier, si vous appuyez sur la touche de retour du curseur en position 1 et qu'il ne s'y trouve pas dj, le curseur revient en position 1, que le mot cl HOME soit specifi ou non. Cette fonction n'est pas active lorsque le bouton de fonction HOME est slectionn sur la page Web convertie. Le texte en option est ignor par la conversion. Cependant, il figure toujours dans la liste cre au moment de la compilation du programme pour expliquer quel fin l'indicateur est utilis. Ce texte sert uniquement de commentaire dans le fichier ou le programme.

HTML
Catgorie Aspect graphique Autres informations

IGCALTTYP
Catgorie Activation NLS Autres informations

IGCALTTYP (validation)
Catgorie Validation Autres informations

Outil WebFacing -- Prise en charge actuelle des mots cls DDS


* indique que le comportement du mot cl tel qu'il a t mis en oeuvre par WebFacing, peut prsenter des diffrences ou des limites en comparaison de la mise en oeuvre standard 5250. Cliquez sur le lien du mot cl pour plus d'informations.

204

Dveloppement des applications WebFacing

Remarque : Vous pouvez utiliser l'outil d'enqute de mots cls DDS pour vous aider valuer le niveau de support des mots cls que l'outil WebFacing fournira votre application. L'outil d'enqute sur les mots cls DDS peut tre tlcharg partir d'IBM Support.
Tri par mot cl ALARM ALIAS * ALTHELP * ALTNAME * ALTPAGEDWN * ALTPAGEUP * ALWGPH ALWROL ASSUME (transfert de donnes) ASSUME (pas d'effacement de l'cran) BLANKS * BLINK BLKFOLD * CAnn/CFnn * CCSID CHANGE * CHCACCEL CHCAVAIL CHCCTL CHCSLT CHCUNAVAIL CHECK(ER)/AUTO(RA) CHECK(RB)/AUTO(RAB) * CHECK(RZ)/AUTO(RAZ) * CHECK * CHGINPDFT(FE) * Tri par prise en charge actuelle Non Oui Oui (partiel) Oui Oui (partiel) Oui (partiel) Non Non Non Oui Oui Non Non Oui Non Oui Non Non Non Non Non Oui Oui Oui Oui Oui Tri par catgorie Gnration d'cran Valeurs la compilation Touches de fonction Valeurs la compilation Touches de fonction Touches de fonction Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Tampon d'E-S Curseur Position de zone Touches de fonction Activation NLS Tampon d'E-S Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Validation Tampon d'E-S Validation Validation Apparence Validation Apparence Apparence Validation Aspect graphique Activation NLS Touches de fonction Gnration d'cran

CHGINPDFT(ME MF LC CS) Oui * CHGINPDFT(RI HI) * CHGINPDFT/ CHGINPDFT(UL/BL) * CHKMSGID CHOICE CHRID CLEAR * CLRL(nn|*END) * Oui Oui Oui Non Non Oui Oui

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

205

Tri par mot cl CLRL(*ALL) * CLRL(*NO) * CMP * CNTFLD * COLOR * COMP * CSRINPONLY * CSRLOC DATEFMT DATESEP DATE DFT (implicite) * DFTVAL * DFT * DLTCHK * DLTEDT * DSPATR (zone programme systme) DSPATR(BL) DSPATR(MDT) DSPATR(OID) * DSPATR(PC) * DSPATR(PR CS) *

Tri par prise en charge actuelle Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Non Oui Oui

Tri par catgorie Gnration d'cran Gnration d'cran Validation Aspect graphique Apparence Validation Curseur Curseur Validation Apparence Constantes Valeurs de zone Valeurs de zone Valeurs de zone Valeurs la compilation Valeurs la compilation Apparence Apparence Apparence Apparence Apparence Apparence Valeurs de zone Apparence Gnration d'cran Gnration d'cran Activation NLS Gnration d'cran Touches de fonction Apparence Apparence Validation Apparence Apparence Gnration d'cran Gnration d'cran Messages Messages

DSPATR(SP), la page 188 Oui DSPATR(UL HI RI ND) * DSPMOD (sans condition) * DSPMOD (avec indicateurs d'option) * DSPRL * DSPSIZ * DUP EDTCDE(5-9), la page 198* EDTCDE EDTMSK EDTWRD ENTFLDATR ERASEINP ERASE ERRMSGID * ERRMSG * Oui Oui Non Non Oui Non Non Oui Oui Oui Non Non Oui Oui Oui

206

Dveloppement des applications WebFacing

Tri par mot cl ERRSFL * FLDCSRPRG FLTFIXDEC FLTPCN FRCDTA GETRETAIN GRDATR GRDBOX GRDCLR GRDLIN GRDRCD

Tri par prise en charge actuelle Oui Non Non Non Oui Non Non Non Non Non Non

Tri par catgorie Messages Curseur Apparence Tampon d'E-S Gnration d'cran Gnration d'cran Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Touches de fonction Touches de fonction Touches de fonction Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Touches de fonction Aide de l'application Aide de l'application Aide de l'application Aide de l'application Touches de fonction Aspect graphique Activation NLS Activation NLS Indicateurs Indicateurs Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran

HELP (mess. 2me niveau) Non , la page 201 HELP (retour au prog.) HELP (avec HLPARA) HLPARA HLPBDY HLPCLR HLPCMDKEY HLPDOC * HLPEXCLD HLPFULL HLPID HLPPNLGRP HLPRCD HLPRTN HLPSCHIDX HLPSEQ HLPSHELF HLPTITLE HOME * HTML IGCALTTYP IGCCNV * INDARA INDTXT * INVITE (plusieurs units) * INVITE (unit unique) * INZINP INZRCD Oui Oui Oui Oui Oui Non Non Oui Non Oui Oui Oui Oui Non Oui Non Oui Oui Non Oui Non Oui Oui Non Oui Non Non

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

207

Tri par mot cl KEEP LOCK LOGINP * LOGOUT * LOWER MAPVAL MDTOFF * MLTCHCFLD MNUBARCHC MNUBARDSP MNUBARSEP MNUBARSW MNUBAR MNUCNL MOUBTN MSGALARM MSGCON MSGID MSGLOC NOCCSID OPENPRT OVERLAY * OVRATR/OVRDTA PAGEDOWN/PAGEUP * PASSRCD PRINT(*PGM/ind. rponse) PRINT/PRINT(bib/fichier) PROTECT PSHBTNCHC PSHBTNFLD PULLDOWN PUTOVR * PUTRETAIN RANGE (alphanumrique) RANGE (numrique) * REFFLD * REF * RETKEY/RETCMDKEY * RETLCKSTS RMVWDW

Tri par prise en charge actuelle Oui Non Oui Oui Oui Non Oui Non Non Non Non Non Non Non Non Non Oui Oui Non Non Non Oui Non Oui Non Oui Non Oui Non Non Non Non Non Non Oui Oui Oui Oui Non Oui

Tri par catgorie Gnration d'cran Gnration d'cran Tampon d'E-S Tampon d'E-S Tampon d'E-S Valeurs de zone Gnration d'cran Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Touches de fonction Messages Constantes Valeurs de zone Messages Activation NLS Gnration d'cran Gnration d'cran Gnration d'cran Touches de fonction Gnration d'cran Touches de fonction Touches de fonction Gnration d'cran Aspect graphique Aspect graphique Aspect graphique Gnration d'cran Gnration d'cran Validation Validation Valeurs la compilation Valeurs la compilation Touches de fonction Gnration d'cran Fentre

208

Dveloppement des applications WebFacing

Tri par mot cl ROLLUP/ROLLDOWN * RTNCSRLOC(*MOUSE) RTNCSRLOC(*RECNAME| *WINDOW) * RTNDTA SETOF/SETOFF SFLCHCCTL SFLCLR SFLCSRPRG SFLCSRRRN SFLCTL SFLDLT SFLDROP SFLDSPCTL SFLDSP SFLEND * SFLENTER SFLFOLD SFLINZ SFLLIN SFLMLTCHC SFLMODE SFLMSGID SFLMSGKEY SFLMSGRCD SFLMSG SFLNXTCHG SFLPAG SFLPGMQ/SFLMSGKEY/ SFLMSGRCD SFLRCDNBR SFLRNA SFLROLVAL * SFLRTNSEL SFLSCROLL SFLSIZ SFLSNGCHC SFL * SLNO (*VAR) SLNO(n) SNGCHCFLD

Tri par prise en charge actuelle Oui Non Oui Oui Oui Non Oui Non Oui Oui Oui Oui Oui Oui Oui Non Oui Oui Oui Non Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Non Non Oui Oui Non Oui Oui Oui Non

Tri par catgorie Touches de fonction Curseur Curseur Gnration d'cran Tampon d'E-S Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Position de zone Position de zone Aspect graphique

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

209

Tri par mot cl SYSNAME TEXT * TIME TIMFMT TIMSEP UNLOCK USER USRDFN USRDSPMGT USRRSTDSP VALNUM * VALUES * VLDCMDKEY WDWBORDER WDWTITLE * WINDOW(dfinition) WINDOW(rfrence) WRDWRAP * (7-16) Paramtres d'environnement (29) Rfrence * (30-34) Longueur (35) Type de donnes (tampon) (35) Type de donnes/Touche Maj du clavier * (36-37) Position dcimale (38) Usage M (38) Emploi (I/O/B/H/P) (39-44) Emplacement *

Tri par prise en charge actuelle Oui Oui Oui Oui Oui Non Oui Non Non Non Oui Oui Oui Non Oui Oui (partiel) Oui Oui Oui Oui Oui Oui Oui

Tri par catgorie Constantes Valeurs la compilation Constantes Validation Apparence Gnration d'cran Constantes Gnration d'cran Gnration d'cran Fentre Validation Validation Touches de fonction Fentre Fentre Fentre Fentre Apparence Indicateurs Valeurs la compilation Apparence Tampon d'E-S Validation

Oui Non Oui Oui

Tampon d'E-S Messages Valeurs de zone Position de zone

210

Dveloppement des applications WebFacing

Concepts associs Chapitre 1, Prsentation de l'outil WebFacing, la page 1 Tches associes Chapitre 3, Cration d'un projet Web WebFacing, la page 13 Ouverture de la perspective WebFacing, la page 14 Slection des membres source convertir, la page 15 Spcification de commandes CL pour appeler votre application, la page 16 Slection d'un style Web, la page 14 Fin du projet et conversion du source DDS, la page 18 Analyse des journaux de conversion, la page 18

Outil WebFacing -- Prise en charge actuelle des mots cls DDS


* indique que le comportement du mot cl tel qu'il a t mis en oeuvre par WebFacing, peut prsenter des diffrences ou des limites en comparaison de la mise en oeuvre standard 5250. Cliquez sur le lien du mot cl pour plus d'informations. Remarque : Vous pouvez utiliser l'outil d'enqute sur les mots cls DDS pour vous aider valuer le niveau de support des mots cls que l'outil WebFacing fournira votre application. L'outil d'enqute sur les mots cls DDS peut tre tlcharg partir d'IBM Support.
Tri par mot cl ALIAS * ALTHELP * ALTNAME * ALTPAGEDWN * ALTPAGEUP * ASSUME (pas d'effacement de l'cran) BLANKS * CAnn/CFnn * CHANGE * CHECK(ER)/AUTO(RA) CHECK(RB)/AUTO(RAB) * CHECK(RZ)/AUTO(RAZ) * CHECK * CHECK(FE) * CHGINPDFT(FE) * Tri par prise en charge actuelle Oui Oui (partiel) Oui Oui (partiel) Oui (partiel) Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Tri par catgorie Valeurs la compilation Touches de fonction Valeurs la compilation Touches de fonction Touches de fonction Gnration d'cran Tampon d'E-S Touches de fonction Tampon d'E-S Validation Tampon d'E-S Validation Validation Apparence Apparence Validation Apparence Apparence Validation

CHGINPDFT(ME MF LC CS) Oui * CHGINPDFT(RI HI) * CHGINPDFT/ CHGINPDFT(UL/BL) * CHKMSGID Oui Oui Oui

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

211

Tri par mot cl CLEAR * CLRL(nn|*END) CLRL(*ALL) CLRL(*NO) CMP * CNTFLD * COLOR * COMP * CSRINPONLY * CSRLOC DATE DATEFMT DATESEP DFT (implicite) * DFTVAL * DFT * DLTCHK * DLTEDT * DSPATR(BL) DSPATR(MDT) DSPATR(PC) * DSPATR(PR CS) * DSPATR(SP) DSPATR(UL HI RI ND) * DSPATR (zone programme systme) DSPMOD (sans condition) * DSPSIZ * EDTCDE EDTMSK EDTWRD ERASE ERRMSGID * ERRMSG * ERRSFL * FRCDTA HELP (retour au prog.) * HELP (avec HLPARA) * HLPARA HLPBDY

Tri par prise en charge actuelle Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui

Tri par catgorie Touches de fonction Gnration d'cran Gnration d'cran Gnration d'cran Validation Aspect graphique Apparence Validation Curseur Curseur Constantes Validation Apparence Valeurs de zone Valeurs de zone Valeurs de zone Valeurs la compilation Valeurs la compilation Apparence Apparence Apparence Apparence Valeurs de zone Apparence Apparence Gnration d'cran Gnration d'cran Apparence Validation Apparence Gnration d'cran Messages Messages Messages Gnration d'cran Touches de fonction Touches de fonction Aide de l'application Aide de l'application

212

Dveloppement des applications WebFacing

Tri par mot cl HLPCLR HLPEXCLD HLPID HLPPNLGRP HLPRCD HLPRTN HLPSEQ HLPTITLE HOME * IGCALTTYP INDARA INDTXT * INVITE (unit unique) * KEEP LOGINP * LOGOUT * LOWER MDTOFF * MSGCON MSGID OVERLAY * PAGEDOWN/PAGEUP * PRINT(*PGM/ind. rponse) PROTECT RANGE (numrique) * REFFLD * REF * RETKEY/RETCMDKEY * RMVWDW ROLLUP/ROLLDOWN * RTNCSRLOC(*RECNAME| *WINDOW) * RTNDTA SETOF/SETOFF SFLCLR SFLCSRRRN SFLCTL SFLDLT SFLDROP SFLDSPCTL

Tri par prise en charge actuelle Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui

Tri par catgorie Aide de l'application Aide de l'application Aide de l'application Aide de l'application Aide de l'application Touches de fonction Aide de l'application Aide de l'application Touches de fonction Activation NLS Indicateurs Indicateurs Gnration d'cran Gnration d'cran Tampon d'E-S Tampon d'E-S Tampon d'E-S Gnration d'cran Constantes Valeurs de zone Gnration d'cran Touches de fonction Touches de fonction Gnration d'cran Validation Valeurs la compilation Valeurs la compilation Touches de fonction Fentre Touches de fonction Curseur Gnration d'cran Tampon d'E-S Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

213

Tri par mot cl SFLDSP SFLEND * SFLFOLD SFLINZ SFLLIN SFLMODE SFLMSGID SFLMSGKEY SFLMSGRCD SFLMSG SFLNXTCHG SFLPAG SFLPGMQ/SFLMSGKEY/ SFLMSGRCD SFLRCDNBR SFLRNA SFLSCROLL SFLSIZ SFL * SLNO (*VAR) SLNO(n) SYSNAME TEXT * TIME TIMFMT TIMSEP USER VALNUM * VALUES * VLDCMDKEY WDWTITLE * WINDOW(dfinition) WINDOW(rfrence) WRDWRAP * (7-16) Paramtres d'environnement (29) Rfrence * (30-34) Longueur (35) Type de donnes (tampon)

Tri par prise en charge actuelle Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui (partiel) Oui Oui Oui Oui Oui Oui

Tri par catgorie Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Position de zone Position de zone Constantes Valeurs la compilation Constantes Validation Apparence Constantes Validation Validation Touches de fonction Fentre Fentre Fentre Apparence Indicateurs Valeurs la compilation Apparence Tampon d'E-S

214

Dveloppement des applications WebFacing

Tri par mot cl (35) Type de donnes/Touche Maj du clavier * (36-37) Position dcimale (38) Emploi (I/O/B/H/P) (39-44) Emplacement * ALARM ALWGPH ALWROL ASSUME (transfert de donnes) BLINK BLKFOLD * CCSID CHCACCEL CHCAVAIL CHCCTL CHCSLT CHCUNAVAIL CHOICE CHRID DSPATR(OID) * DSPMOD (avec indicateurs d'option) * DSPRL * DUP EDTCDE(5-9) ENTFLDATR ERASEINP FLDCSRPRG FLTFIXDEC FLTPCN GETRETAIN GRDATR GRDBOX GRDCLR GRDLIN GRDRCD HELP (mess. 2me niveau) * HLPCMDKEY HLPDOC *

Tri par prise en charge actuelle Oui

Tri par catgorie Validation

Oui Oui Oui Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non

Tampon d'E-S Valeurs de zone Position de zone Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Curseur Position de zone Activation NLS Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Activation NLS Apparence Gnration d'cran Activation NLS Touches de fonction Apparence Apparence Gnration d'cran Curseur Apparence Tampon d'E-S Gnration d'cran Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Touches de fonction Aide de l'application Aide de l'application

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

215

Tri par mot cl HLPFULL HLPSCHIDX HLPSHELF HTML IGCCNV * INVITE (plusieurs units) * INZINP INZRCD LOCK MAPVAL MLTCHCFLD MNUBARCHC MNUBARDSP MNUBARSEP MNUBARSW MNUBAR MNUCNL MOUBTN MSGALARM MSGLOC NOCCSID OPENPRT OVRATR/OVRDTA PASSRCD PRINT/PRINT(bib/fichier) PSHBTNCHC PSHBTNFLD PULLDOWN PUTOVR PUTRETAIN RANGE (alphanumrique) * RETLCKSTS RTNCSRLOC(*MOUSE) SFLCHCCTL SFLCSRPRG SFLENTER SFLMLTCHC SFLROLVAL * SFLRTNSEL SFLSNGCHC

Tri par prise en charge actuelle Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non

Tri par catgorie Aide de l'application Aide de l'application Aide de l'application Aspect graphique Activation NLS Gnration d'cran Gnration d'cran Gnration d'cran Gnration d'cran Valeurs de zone Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Aspect graphique Touches de fonction Messages Messages Activation NLS Gnration d'cran Gnration d'cran Gnration d'cran Touches de fonction Aspect graphique Aspect graphique Aspect graphique Gnration d'cran Gnration d'cran Validation Gnration d'cran Curseur Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers Sous-fichiers

216

Dveloppement des applications WebFacing

Tri par mot cl SNGCHCFLD UNLOCK USRDFN USRDSPMGT USRRSTDSP WDWBORDER (38) Usage M

Tri par prise en charge actuelle Non Non Non Non Non Non Non

Tri par catgorie Aspect graphique Gnration d'cran Gnration d'cran Gnration d'cran Fentre Fentre Messages

Chapitre 11. Outil WebFacing -- Prise en charge actuelle des mots cls DDS

217