Développement et déploiement d'applications Web HATS
Il existe cinq types d'application HATS : Web, portlet, EJB, client enrichi et console d'administration. Ce chapitre contient des informations relatives aux applications Web HATS. Pour obtenir des informations sur les autres types d'application, voir les chapitres suivants :
En outre, une application Web HATS peut être liée à une application WebFacing, les deux applications étant ensuite combinées en un module unique afin qu'elles interagissent l'une avec l'autre dans le cadre d'une application d'entreprise unique. Pour plus d'informations, voir WebFacing et HATS.
Les applications HATS sont créées à partir de projets HATS par le biais de HATS Toolkit. Lorsque vous créez un projet HATS, un ensemble de dossiers est également créé afin de vous aider à organiser les fichiers d'application HATS. Un exemple d'un projet par défaut est présenté ci-après.
Le dossier de plus haut niveau possède le même nom que celui affecté au projet lors de sa création. Ce dossier contient d'autres dossiers de haut niveau qui renferment
les objets définis dans le projet HATS. Certains dossiers apparaissent uniquement après la création de certains objets.
Figure 2. Vue de projet Web HATS
Selon la façon dont vous configurez le projet HATS, tous ces
dossiers ou seulement certains d'entre eux apparaissent dans la vue
Projets HATS. Vous pouvez aussi indiquer les dossiers qui doivent s'afficher dans la vue Projets HATS ou bien masquer les extensions de fichiers. Pour plus d'informations, voir Préférences HATS.
Remarque :
Les dossiers qui apparaissent sont différents selon les types de projets HATS. Par exemple, l'arborescence d'un projet EJB HATS ne contient aucun
dossier Personnalisations d'écran,
Captures d'écran ou Contenu
Web.
Vous avez la possibilité de créer des sous-dossiers dans ces dossiers de haut niveau afin d'organiser au mieux votre projet. Par exemple, lorsque vous créez des captures d'écran pour le projet, vous pouvez créer des sous-dossiers dans le dossier Captures d'écran afin d'organiser et de regrouper les écrans capturés. Pour créer un dossier, cliquez à l'aide du bouton droit de la souris sur l'un des dossiers de haut niveau de l'arborescence, puis sélectionnez Nouveau > Dossier. Pour déplacer un fichier vers un autre dossier, cliquez sur ce fichier à l'aide du bouton droit de la souris et sélectionnez
Déplacement ou utilisez la méthode de glissement-déplacement.
Remarque :
Il existe des restrictions concernant les sous-dossiers. Les fichiers de transformation et de modèle doivent se trouver dans des sous-dossiers de même niveau. Pour qu'il soit possible d'utiliser une transformation résidant à un certain niveau de sous-dossier (par exemple, \transformations\Callup\), le modèle qui sera couplé avec cette transformation doit se trouver au même niveau de sous-dossier (par exemple, \templates\Callup\).
Il est possible de partager les projets HATS pour une
équipe en accédant à la vue du
navigateur de la perspective HATS.
Cliquez à l'aide du bouton droit de la souris sur le projet et
sélectionnez Team > Share Project. Sélectionnez
le type de référentiel dans la liste, puis cliquez sur
Suivant. Rational SDP prend en charge plusieurs référentiels. Pour plus d'informations, reportez-vous à la documentation Rational SDP et effectuez une recherche sur repository (référentiel).
Les projets Web HATS créés dans HATS Toolkit sont des
extensions des projets Web de l'atelier Rational SDP.
Pour plus d'informations,
cliquez sur Help > Help contents dans la barre de menus Rational SDP, développez Développement, puis
sélectionnez Développement d'applications Web.
Organisation des applications Web HATS
Par défaut, toutes les applications Web HATS sont stockées dans un unique fichier d'archive d'entreprise, par exemple HATS_EAR7.
Lorsque vous exportez les applications et les déployez dansWebSphere Application Server, le fichier HATS .ear contient un fichier d'archive Web (.war) avec les ressources nécessaires à l'exécution de l'application et une copie du code exécutable de HATS. Vous pouvez, si vous le souhaitez, organiser vos applications différemment (par exemple, chacune dans son propre fichier .ear ou de toute autre façon).
Pour l'organisation de vos applications Web, tenez compte des considérations suivantes liées au serveur :
- Espace disque
- Si chaque application est créée dans un fichier .ear qui lui est propre, elle possède sa propre copie du code d'exécution HATS. Le code d'exécution représente environ 25 Mo. Multipliez ce chiffre par le nombre d'applications et vous aurez une idée de l'espace disque consommé sur votre système d'exécution pour l'ensemble de vos applications.
- Déploiement
- Lorsque vous redéployez un fichier HATS .ear, vous redéployez toutes les applications
de ce fichier .ear, même si certaines de ces applications n'ont pas été modifiées.
- Journalisation et trace
-
Le contrôle de la journalisation et de la trace s'effectue au niveau du fichier .ear, et non au niveau de chaque application HATS. Si chaque application HATS se trouve dans son propre fichier .ear, vous pouvez contrôler ses paramètres de journalisation et de trace indépendamment de toutes les autres applications. En revanche, si vous avez plusieurs applications HATS dans un même fichier .ear, les paramètres de journalisation et de trace s'appliquent à toutes les applications HATS de ce fichier .ear. Les messages associés à l'ensemble des applications HATS du fichier .ear sont insérés dans le même fichier journal et les informations de trace associées à l'ensemble des applications HATS sont insérées dans le même fichier de trace.
Vous
pouvez ajouter un mot clé facultatif supplémentaire,
traceLogDirectory, dans le fichier runtime.properties.
Cela vous
permet d'indiquer un répertoire spécifique pour les fichiers de
sortie. Ce fichier se trouve dans le répertoire
rép_was/installedApps/nom_ear
pour une
application d'entreprise HATS.
- Suivi des licences
- Le contrôle du suivi des licences s'effectue également au niveau du fichier .ear, et non au niveau de chaque application HATS. Lorsque chaque application HATS se trouve dans son propre fichier .ear, le suivi des licences associées s'effectue indépendamment des autres applications. Si vous avez plusieurs applications HATS dans un fichier même .ear, le suivi des licences est effectué pour toutes les applications HATS du fichier .ear. Les informations liées à l'utilisation des licences sont conservées pour toutes les applications HATS du fichier .ear et sont insérées dans le même fichier d'utilisation des licences.
Déplacement de projets Web HATS vers un fichier .ear différent
Le fichier .ear dans lequel seront stockés vos fichiers de projet est défini lors de la création du projet. Une fois le projet créé, vous pouvez le déplacer d'un fichier
.ear vers un autre, en procédant comme suit :
Pour ajouter le projet à un fichier .ear :
- Cliquez sur l'onglet Navigateur de HATS Toolkit pour afficher les fichiers .ear.
- Développez l'arborescence jusqu'au fichier .ear auquel vous souhaitez ajouter le projet. Développez
le dossier META-INF et repérez le fichier application.xml.
- Démarrez l'éditeur Rational SDP application.xml en cliquant deux fois sur le fichier application.xml.
- Dans la vue Conception de l'éditeur application.xml, dans le groupe Présentation, sélectionnez Application,
puis cliquez sur Ajouter.
- Dans la boîte de dialogue Add Item, sélectionnez Module et cliquez sur OK.
- Sélectionnez le projet que vous souhaitez ajouter au fichier .ear et cliquez sur Terminer.
- Fermez l'éditeur Rational SDP application.xml.
Pour supprimer le projet d'un fichier .ear :
- Cliquez sur l'onglet Navigateur de HATS Toolkit pour afficher les fichiers .ear.
- Développez l'arborescence jusqu'au fichier .ear dans lequel vous souhaitez supprimer le projet.
Développez
le dossier META-INF et repérez le fichier application.xml.
- Démarrez l'éditeur Rational SDP application.xml en cliquant deux fois sur le fichier application.xml.
- Dans la vue Conception de l'éditeur application.xml, dans le groupe Présentation, sélectionnez le projet que vous souhaitez supprimer du fichier .ear, puis cliquez sur Supprimer.
- Fermez l'éditeur Rational SDP application.xml.
Sauvegarde des projets HATS
Comme pour toute autre activité de développement logiciel, il est conseillé de sauvegarder régulièrement vos projets HATS afin de vous prémunir contre toute perte ou corruption des données.
En plus des sauvegardes créées lors de votre propre cycle de développement, vous devez créer des sauvegardes avant de procéder à l'installation de la maintenance de HATS.
Cette précaution vous permettra de retrouver le niveau de la maintenance précédente en cas de besoin. Pour créer une sauvegarde de votre projet
HATS, utilisez la fonction d'exportation Project Interchange de Rational SDP. Pour plus d'informations, voir Exportation d'un projet Web.
Pour restaurer un projet HATS à partir d'une sauvegarde, utilisez la fonction Project Interchange d'importation. Pour plus d'informations, voir Importation d'un projet Web.
Exportation et importation de projets Web HATS
Exportation d'un projet Web
Vous pouvez exporter vos projets Web HATS pour les enregistrer et les utiliser comme sauvegardes ou pour les déplacer vers un autre système HATS Toolkit. Pour réaliser l'exportation, utilisez la méthode suivante :
Fichier Project Interchange
Cette
fonction comporte de nombreux avantages. Elle permet d'exporter plusieurs projets et les fichiers .ear
associés en une seule fois. En outre, il n'est pas nécessaire de
créer un projet au niveau de la destination HATS Toolkit avant
d'importer le fichier Project Interchange. Pour exporter le projet sous forme de fichier
Project Interchange, procédez comme suit :
- Dans la barre de menus, sélectionnez Fichier > Exporter pour ouvrir l'assistant d'exportation.
- Sélectionnez Autre
> Project Interchange et cliquez sur Suivant.
- Sélectionnez à la fois le projet et le projet EAR associé.
- Indiquez le nom et l'emplacement du fichier .zip dans lequel vous
souhaitez sauvegarder le projet.
- Cliquez sur Fin.
Importation d'un projet Web
Pour importer un fichier Project Interchange dans HATS Toolkit :
- Dans la barre de menus, sélectionnez Fichier > Importer pour ouvrir l'assistant d'importation.
- Sélectionnez Autre
> Project Interchange et cliquez sur Suivant.
- Indiquez le fichier .zip à importer dans la zone de provenance du fichier zip.
- Spécifiez l'espace de travail dans lequel vous souhaitez importer le fichier dans la zone Project location root.
- Sélectionnez les projets dans le fichier Project Interchange que vous voulez importer dans l'espace de travail indiqué.
- Cliquez sur Fin.
Pour plus d'informations sur la migration d'un projet HATS à partir d'une version antérieure de HATS, voir Migration de HATS.
Déploiement d'applications Web HATS
Les termes application Web HATS, application WebSphere et application Java™ EE sont interchangeables car il désignent tous une application Web créée à partir d'un projet HATS. Il s'agit d'une application Web HATS
car elle a été développée dans HATS Toolkit. Il s'agit également d'une
application WebSphere car elle va être installée et exécutée sur
WebSphere Application Server. Il s'agait d'une application Java EE car elle respecte les normes Java EE.
Pour déployer une application Web HATS dans un
environnement d'exécution, procédez comme suit :
- Activer l'exécution HATS.
- Exportez votre projet en tant qu'application Java EE.
- Installez l'application dans un environnement d'exécution.
- Apportez les modifications nécessaires à l'environnement d'exécution.
Les sections suivantes expliquent comment réaliser chacune de ces tâches.
Activation du module d'exécution de HATS
Quel que soit le moyen utilisé pour vous procurer le package HATS (CD HATS, Web, ou fourni avec un
autre produit), vous installez la même version de HATS Toolkit. Il
s'agit d'une version avec utilisation limitée qui vous permet d'évaluer HATS. Pour
activer complètement les environnements d'exécution pour la production conformément
à votre autorisation d'utilisation du logiciel sous licence, vous devez indiquer vos
paramètres de licence dans l'assistant Paramètres de licence de HATS Toolkit.
Pour plus d'informations, voir les sections Evaluation de HATS et Activation de l'exécution HATS et de la configuration de la licence,
dans Guide d’initiation HATS.
Exportation du projet sous forme d'application Java EE
Pour déployer votre application Web HATS dans un environnement d'exécution WebSphere Application
Server, vous devez tout d'abord l'intégrer sous forme d'application Java EE. Pour cela, exportez le projet sous la forme d'un fichier EAR.
Pour exporter le projet, procédez comme suit :
- Sélectionnez le nom du projet dans la vue Projets HATS afin de le mettre en évidence.
- Cliquez sur l'icône Exporter le projet HATS dans la barre d'outil principale ou cliquez à l'aide du bouton droit sur le nom du projet et sélectionnez Exporter le projet.
- Dans la fenêtre d'exportation, choisissez un projet d'application d'entreprise dans la liste déroulante ou entrez son nom dans la zone Projet EAR.
- Indiquez un emplacement cible dans la zone Emplacement cible ou cliquez sur le bouton Parcourir pour sélectionner la cible du fichier .ear exporté.
- Pour exporter les fichiers source du projet en même temps que les fichiers exécutables, cochez la case Exporter les fichiers source. Si vous incluez les fichiers source, un autre développeur peut les extraire de votre fichier .ear. Cela facilite le travail en équipe ou la maintenance, mais vous devez déterminer si cela représente un risque en terme de sécurité.
- Si vous avez déjà exporté ce projet à cet emplacement, un message s'affiche pour vous demander si vous souhaitez remplacer les fichiers existants.
Cela permet d'éviter toute suppression intempestive de fichiers que vous aimeriez conserver dans le cadre de l'archivage d'une version antérieure du projet.
Pour remplacer les fichiers existants sans que le système vous demande confirmation, cochez la case Remplacer les fichiers existants.
- Cliquez sur Fin. Le projet est exporté sous forme d'application JEE (Java EE), représentée par un fichier d'archive d'entreprise doté de l'extension .ear et du nom de répertoire et de fichier que vous avez spécifié.
Installation de l'application dans un
environnement d'exécution
Après avoir exporté le projet HATS sous forme d'application Java EE et transféré le fichier .ear de cette dernière vers le système de production, installez l'application en lançant la Console d’administration WebSphere et recherchez le fichier .ear dans l'arborescence. Pour plus d'informations sur l'installation des applications dans WebSphere Application Server, consultez la bibliothèque de WebSphere Application
Server à l'adresse http://www.ibm.com/software/webservers/appserv/was/library/ et cliquez sur le lien permettant d'accéder au centre de documentation qui concerne votre version du produit.
Dans la
table des matières de votre produit
WebSphere Application Server, reportez-vous au
chapitre consacré au déploiement des applications.
Après avoir installé l'application, testez-la en vous connectant à l'adresse URL à partir du navigateur Web d'un autre système. Vous pouvez ensuite publier cette adresse auprès des utilisateurs. Par exemple, l'adresse URL peut être au format http://nom_hôte/nom_app_hats/ où nom_hôte correspond au nom de l'hôte IP et au domaine dans lequel WebSphere Application Server est installé, et nom_app_hats correspond au nom de l'application HATS.
Remarques :
- Pour plus d'informations sur l'installation des applications HATS sur des plateformes spécifiques, voir le centre de documentation HATS à l'adresse http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp.
- Si vos applications HATS sont déployées dans WebSphere Application
Server alors que la sécurité Java 2 est activée et qu'elles ne démarrent pas, voir Sécurité Java 2 afin d'obtenir plus d'informations.
- HATS prend en charge plusieurs
instances de navigateur qui accèdent à partir du même poste de
travail à la même application HATS. Ces instances multiples ne doivent cependant pas partager le même ID de session HTTP.
Un ID de session HTTP est attribué à la session établie entre le navigateur accédant à l'application HATS et WebSphere Application
Server. Cet ID permet aux demandes ultérieures provenant du même navigateur d'être renvoyées vers la même application HATS. Les demandes ultérieures utilisent la même session Telnet (3270 ou 5250)
établie entre l'application HATS sur le serveur et l'hôte.
Selon le navigateur utilisé, l'ID de session HTTP est implémenté différemment. Dans Microsoft® Internet Explorer, toutes les sessions de navigation du même processus sont censées partager le même ID de session HTTP. Lorsque vous ouvrez une nouvelle fenêtre du navigateur à l'aide du même raccourci, une nouvelle session de navigation est lancée, partageant le même processus et le même ID de session HTTP.
Pour ouvrir un nouveau processus Internet Explorer disposant d'un ID de session HTTP unique, par exemple sous Windows® XP, si Internet Explorer figure dans votre menu Démarrer, vous pouvez sélectionner Démarrer > Internet Explorer. Vous pouvez également sélectionner Démarrer > Tous les programmes > Internet Explorer.
Remarques :
- Le raccourci Ctrl+N d'Internet Explorer ne lance pas un nouveau processus, mais il ouvre une nouvelle fenêtre identifiée par le même ID de processus et le même ID de session HTTP que la fenêtre d'origine.
- Dans Internet Explorer 8, vous pouvez sélectionner Fichier > Nouvelle session pour ouvrir un nouveau navigateur identifié par un ID de session unique.
Remarque :
Dans
Internet Explorer, pour connaître l'ID de session HTTP associé à une fenêtre du navigateur, sélectionnez Affichage > Source dans la barre de menus ou cliquez avec le bouton droit de la souris dans la fenêtre du navigateur Internet Explorer et sélectionnez Affichage Source pour afficher le marquage source de la page. Faites défiler la fenêtre source vers le bas pour atteindre la balise de formulaire HATS, dont le format est similaire au suivant :
<FORM NAME="HATSform" dir="" METHOD="POST"
ACTION="/NomDeVotreApplicationHATS/entrée">.
Dans la balise de formulaire, recherchez le paramètre SESSIONID, dont le format est similaire au suivant :
<INPUT TYPE="HIDDEN" NAME="SESSIONID"
VALUE="PIOncS1GehNWxWo_49VCBzC" />
Remarque :
Lorsque vous accédez à une application HATS qui n'affiche que la transformation par défaut de l'écran et qui ne lance pas de macro à son exécution, le paramètre SESSIONID est défini sur "INVALID." La valeur SESSIONID est affectée lorsque l'utilisateur effectue un envoi vers la hôte, par exemple en appuyant sur la touche Entrée, et qu'il obtient une réponse.
Vous pouvez vérifier si un nouveau processus est lancé en utilisant le gestionnaire des tâches sous Windows. Lancez le gestionnaire des tâches et cliquez sur l'en-tête de colonne 'Nom de l'image' dans l'onglet Processus pour trier l'information par nom de l'image. Défilez vers le bas pour afficher tous les processus 'iexplore.exe'
de la liste. Tentez de lancer de nouvelles fenêtres Internet Explorer
à l'aide du raccourci Démarrer > Internet Explorer.
Si un nouveau processus est lancé, un nouveau processus iexplore.exe s'affiche. Sinon, la nouvelle fenêtre du navigateur est contrôlée par un processus existant.
- HATS requiert le nom affiché de l'application, tel que défini dans le fichier web.xml de l'application,
pour faire la correspondance avec le chemin du contexte de l'application utilisé dans l'URL du navigateur. Si la valeur du nom affiché est modifiée et différente du chemin du contexte de l'application, il se peut que vous soyez
confronté à une erreur java.lang.nullPointerException ou javax.servlet.ServletException, lors de l'exécution de l'application HATS. Par exemple, un projet HATS nommé MyHatsProject a, par défaut, MyHatsProject pour nom affiché. Pour atteindre ce projet, lorsqu'il est déployé sous forme d'application Web, vous devez utiliser une URL semblable à : http://myServer/MyHatsProject/ pour qu'il fonctionne correctement.
La modification du nom affiché pour qu'il soit différent de MyHatsProject, a pour effet de rendre l'application non fonctionnelle.
Modifications à apporter à l'environnement d'exécution
Configuration des règles de chargeur de classe
Lorsque vous déployez vos applications Web HATS ou lorsque vous les exécutez dans l'environnement de test local, vous devez configurer la règle de chargeur de classe WAR sur chaque application Java EE, lorsque vous vous trouvez dans l'une des situations suivantes :
- L'application inclut la logique applicative. Cette dernière peut déclencher une exception ClassNotFoundException.
- L'application inclut des composants ou des objets fenêtre personnalisés.
Ces derniers peuvent déclencher une exception ClassNotFoundException.
HATS automatically configures the class loader policy for
these applications.
Configuration d'applications HATS dans un environnement groupé
Lorsque vous déployez des applications Web HATS dans un environnement groupé verticalement, chaque instance de serveur d'applications crée ses propres fichiers de journalisation, de trace et de suivi des licences. Cela s'effectue par association du nom qualifié complet de l'instance de serveur d'applications aux noms de fichiers de sortie. Par exemple, le modèle par défaut pour le nom du fichier de
journalisation est messages.txt, mais le nom réel du fichier aura la
forme suivante :
messages_Cellule_Noeud_Instanceserveurappl_1.txt.
Par défaut, toutes les instances de serveur consultent le même
fichier runtime.properties pour extraire leurs paramètres. Aussi,
pour contrôler correctement les paramètres d'exécution, vous devez
configurer chaque instance afin qu'elle ait son propre fichier de
propriétés d'exécution (runtime.properties).
Cela vous permet de contrôler la trace de chaque instance
indépendamment et d'éviter toute modification spontanée des
paramètres d'exécution.
Suivez les indications fournies ci-après pour configurer les instances d'application HATS groupées verticalement afin que chacune d'entre elles ait son propre fichier runtime.properties :
- Effectuez une copie du fichier runtime.properties pour chaque instance de serveur d'applications du groupe vertical.
- Localisez le fichier runtime.properties associé à votre application HATS.
Ce fichier doit normalement se trouver dans le sous-répertoire installedApps\nom_app.ear du répertoire dans lequel vous avez installé WebSphere Application Server.
- Effectuez une copie du fichier runtime.properties pour chaque instance. Attribuez un nom unique à chacune et placez-les dans le même répertoire. Par exemple, vous pouvez nommer les fichiers Clone1runtime.properties,
Clone2runtime.properties, etc. Vous pouvez utiliser tout nom de fichier valide, mais ce nom doit tout de même aider l'administrateur à identifier l'instance de serveur d'applications à laquelle le fichier est associé.
- A ce point de la procédure, pour n instances de serveur, vous
avez n fichiers
runtime properties uniques.
- Si l'environnement groupé verticalement contient plusieurs fichiers HATS .ear, répétez cette étape pour chaque fichier.
- Ajoutez un nouveau paramètre de configuration pour identifier le fichier runtime.properties
utilisé par chaque instance. Par exemple, pour WebSphere Application Server V6.x :
- Sélectionnez Serveurs d'applications sous l'option Serveurs située dans le panneau de navigation de gauche de la console d'administration WebSphere Application
Server.
- Sélectionnez l'instance de serveur dans la liste des serveurs d'application.
- Sélectionnez Java et gestion des processus dans l'onglet Configuration du serveur.
- Sélectionnez Définition des processus > Java Virtual Machine > Propriétés personnalisées.
- Dans la fenêtre Propriétés personnalisées, cliquez sur Nouveau.
- Dans la zone Nom, indiquez hats.runtime.properties.
- Dans la zone Valeur, indiquez le nom du fichier properties que vous avez créé pour ce serveur (par exemple, Clone2runtime.properties). N'indiquez pas de noms de répertoire ou de barres obliques dans cette zone.
- Il n'y a aucune donnée à saisir dans la zone Description.
- Cliquez sur Valider.
- Répétez cette procédure pour chaque instance de serveur.
Une fois que vous avez ajouté la nouvelle propriété et que vous avez vérifié que chaque instance de serveur
possède sa propre copie du fichier runtime.properties, vous devez
redémarrer chaque application afin qu'elle utilise les nouveaux fichiers.
La console d'administration de HATS permet de contrôler les paramètres des membres du groupe. Partez du dossier Mise en route dans
l'écran de navigation de la page Web Administration pour sélectionner
l'option Portée de la gestion. Une
fois que vous avez choisi la grappe souhaitée, si vous sélectionnez
Paramètres de la trace, vous êtes
invité à indiquer le membre du groupe que vous souhaitez contrôler.
Remarque :
Des remarques spéciales ont été rédigées quant à l'utilisation des
grappes et des listes des utilisateurs. Pour plus d'informations, voir
Classification et listes d'utilisateurs
Développement d'applications HATS pour les unités mobiles
Vous pouvez développer des applications Web HATS accessibles par des unités mobiles telles des téléphones portables, des terminaux de collecte de données et des assistants électroniques de poche. Ce processus est identique au développement des applications Web HATS. Des considérations doivent toutefois être prises en compte en raison des fonctions de l'unité mobile et de son navigateur Web, par exemple la taille de l'écran et les limites d'interaction.
Pour créer un projet pour votre application destinée aux unités mobiles, lancez l'assistant de création de projet en utilisant l'une des actions suivantes :
- Sélectionnez HATS > Nouveau > Projet dans la barre de menus.
- Sélectionnez Fichier > Nouveau > Projet HATS dans la barre de menus.
- Cliquez sur l'icône Créer un projet HATS dans la barre d'outils.
Dans le panneau Projet HATS de l'assistant de création de projet :
- Entrez un nom pour le projet de l'unité mobile.
- Vous pouvez éventuellement entrer une description.
- Acceptez l'emplacement par défaut.
- Sélectionnez Web pour indiquer qu'il s'agit d'un projet Web.
Remarque :
Si l'option de déploiement Web est désactivée, cela signifie qu'aucun environnement d'exécution serveur n'est défini. Pour en définir un, accédez à Fenêtre > Préférences > Serveur > Environnements d'exécution installés et ajoutez au moins une définition d'environnement d'exécution.
- Pour la zone Serveur cible, sélectionnez l'un des serveurs WebSphere Application pris en charge.
- Pour la zone Projet d'application d'entreprise, entrez le nom du projet EAR à utiliser pour effectuer des tests dans l'environnement de test local.
- Sélectionnez Options d'optimisation des unités mobiles.
- Cliquez sur Suivant et continuez de créer votre projet.
Considérations et restrictions relatives aux unités mobiles
Lorsque vous créez un projet HATS et sélectionnez Options d'optimisation des unités mobiles, HATS initialise le projet avec des options adaptées aux unités mobiles. Certaines options, par exemple l'impression, le clavier, la mise à jour asynchrone ainsi que d'autres options, ne sont pas prises en charge et sont donc désactivées. Gardez à l'esprit les considérations et restrictions suivantes lorsque vous développez votre application pour les unités mobiles.
- Il n'existe pas d'option automatisée qui vous permet de convertir un projet HATS non optimisé pour les unités mobiles en un projet qui l'est, et inversement.
- L'option permettant de spécifier un thème de projet n'est pas fournie. A la place, les options sont automatiquement initialisées afin d'être utilisées par les unités mobiles.
- Seuls les modèles optimisés pour les unités mobiles sont fournis afin d'être utilisés dans le projet.
Remarque :
Si vous ne souhaitez pas avoir de défilement horizontal lorsque vous utilisez le modèle Modern, ajoutez le style overflow: auto; à .roundedcornermodule dans le fichier de modèle Modern.jsp. Par exemple, remplacez .roundedcornermodule
{margin: 0px;} par .roundedcornermodule { margin: 0px; overflow:
auto; }. La page conserve ainsi sa taille d'origine et s'affiche intégralement sur l'écran visuel de l'unité. Notez que dans certains cas, cela peut engendrer une troncation des données sur la page ; c'est donc pour cette
raison que la conception de pages et d'objets fenêtre personnalisés doit tenir compte de la taille de l'écran.
- Un deuxième paramètre de rendu, appelé compact, est créé dans le projet. Il est défini comme étant le paramètre de rendu par défaut. De plus, l'option Utiliser le rendu compact du paramètre de rendu est sélectionné, réduisant ainsi le nombre d'espace et de codes HTML dans le rendu par défaut et entraînant l'affichage d'une structure différente de l'écran hôte d'origine.
- La préférence HATS, Inclure un tableau à présentation libre, qui est activée lors de la création d'une transformation vide, comporte un modificateur additionnel, notamment Sauf lorsque le projet est optimisé pour les unités mobiles. Ce modificateur est sélectionné par défaut. Par conséquent, les transformations vides ajoutées à votre projet mobile ne comporteront pas de tableau à présentation libre par défaut.
- Les touches Fin de la zone, Zone+, Zone- peuvent être utilisées à l'aide de l'option Activer l'option de positionnement du curseur dans les zones d'entrée en association avec les boutons Bloc de touches hôte et Touche hôte.
- L'objet fenêtre de zone propose une option de présentation Séparé pour afficher les résultats à l'aide de balises SPAN en ligne, plutôt que d'utiliser un tableau pour différencier les zones. Cette option permet de réduire le nombre d'espace et de HTML. Il s'agit de l'option par défaut pour les unités mobiles.
- HATS fournit la prise en charge du placement des colonnes pour les sous-fichiers et les objets fenêtre de tableau. Cela s'avère utile lors de l'affichage de données tabulaires sur une unité mobile en permettant la disposition et l'exclusion de colonnes depuis l'affichage ainsi qu'en autorisant des sections Détails pouvant être développées de sorte que la taille de la table puisse être réduite.
Lorsque la section Détails est développée, elle s'affiche directement sous la ligne contenant les colonnes principales de données. Une fois qu'une ligne spécifique est identifiée par l'utilisateur, les détails de cette ligne, lorsqu'ils sont développés, sont affichés dans un format allant vers le bas de l'écran plutôt que vers la droite. Ceci permet aux affichages de petite taille de visualiser les détails requis d'un nombre arbitraire de colonnes sans nécessiter de défilement horizontal.
Les figures ci-après représentent un sous-fichier tel qu'il est affiché sur un écran hôte, une vue primaire du sous-fichier et une vue des caractéristiques du sous-fichier à l'aide du support de placement des colonnes par défaut.
Figure 3. Sous-fichier sur un écran hôte
Figure 4. Vue primaire du sous-fichier à l'aide du support de placement des colonnes par défaut
Figure 5. Vues des caractéristiques d'une ligne de sous-fichier à l'aide du support de placement des colonnes par défaut
En plus d'économiser de l'espace sur l'écran, vous pouvez configurer l'objet fenêtre afin de conserver les colonnes détaillées sur le serveur plutôt que de les envoyer via HTTP vers le navigateur de l'utilisateur. Dans certains cas, ceci permet de réduire la quantité de données transférées car les données détaillées non requises ne sont pas envoyées via HTTP à l'unité de fin.
Seuls les détails spécifiquement demandés par l'utilisateur sont extraits le cas échéant et sont envoyés au navigateur.
Remarque :
Les sous-fichiers configurés pour utiliser le composant de zone afin de reconnaître la partie du sous-fichier contenant les données ne peuvent pas utiliser les fonctions associées aux colonnes principales et détaillées de manière efficace car ces sous-fichiers reconnaissent uniquement les lignes.
En plus des paramètres de sous-fichier Placement des colonnes et des paramètres d'objet fenêtre Tableau décrits dans Paramètres d'objet fenêtre, les paramètres suivants peuvent être utilisés pour personnaliser davantage la présentation des commandes utilisées pour cette option. Ces paramètres ne s'affichent pas dans l'interface HATS Toolkit. Vous devez ajouter ces paramètres à la source de l'objet fenêtre. La source ci-dessous présente des exemples de ces paramètres et utilise un objet fenêtre sous-fichier comme exemple.
<class name="com.ibm.hats.transform.widgets.SubfileWidgetV6">
<setting name="normalColumnLayout" value="1,2"/>
<setting name="extendedColumnLayout" value="3*"/>
<setting name="keepExpansionOnServer" value="true"/>
<setting name="expandHeaderValue" value="fred"/>
<setting name="expandRepresentation" value="button"/>
<setting name="expandValue" value="click me"/>
<setting name="collapseRepresentation" value="image"/>
<setting name="collapseValue" value="/common/images/twisty1.gif"/>
<setting name="collapseAltValue" value="hide"/>
</class>
- expandRepresentation
- Détermine la représentation graphique utilisée pour la commande permettant d'afficher les détails. Définissez button, link ou image.
La valeur par défaut est link.
- expandValue
- Si la valeur associée au paramètre expandRepresentation est button ou link, cette dernière est utilisée comme élément texte dans le bouton ou le lien. Si aucune valeur n'est définie, le signe plus (+) est utilisé par défaut. Une valeur de chaîne vide"" n'est pas admise et le signe plus (+) est utilisé par défaut.
Si la valeur du paramètre expandRepresentation est image, elle correspond au chemin d'accès du fichier image à utiliser ainsi qu'au nom de ce fichier. La recherche du chemin d'accès est effectuée selon le répertoire du contenu Web du projet. Par exemple, si vous souhaitez spécifier twisty1.gif dans le répertoire de contenu Web Content/common/images, définissez expandValue comme suit :
<setting name="expandValue" value="/common/images/twisty1.gif "/>
- expandAltValue
- Ce paramètre fournit un texte secondaire pour l'image. Il est uniquement utilisé lorsque le paramètre expandRepresentation est défini sur image et que le navigateur ne peut pas afficher l'image spécifiée, par exemple, l'option Menu > Afficher > Show Pictures d' Internet
Explorer Mobile n'est pas sélectionnée.
- collapseRepresentation
- Détermine la représentation graphique utilisée pour la commande permettant de masquer les détails. Définissez button, link ou image.
La valeur par défaut est link.
- collapseValue
- Si la valeur associée à collapseRepresentation est button ou link, cette valeur est utilisée comme élément texte dans le bouton ou le lien. Si aucune valeur n'est définie, le signe moins (-) est utilisé par défaut. Une valeur de chaîne vide"" n'est pas autorisée et le signe moins (-) est utilisé par défaut.
Si la valeur du paramètre collapseRepresentation est image, cette valeur correspond au chemin d'accès du fichier image à utiliser ainsi qu'au nom de ce fichier. La recherche du chemin d'accès est effectuée selon le répertoire du contenu Web du projet. Par exemple, si vous souhaitez spécifier twisty1.gif dans le répertoire de contenu Web Content/common/images, vous définissez collapseValue comme suit :
<setting name="collapseValue" value="/common/images/twisty1.gif "/>
- collapseAltValue
- Ce paramètre fournit un texte secondaire pour l'image. Il est uniquement utilisé lorsque le paramètre collapseRepresentation est définie sur image et que le navigateur ne peut pas afficher l'image spécifiée, par exemple, l'option Menu > Afficher > Show Pictures d'Internet
Explorer Mobile n'est pas sélectionnée.
- expandHeaderValue
- Ce paramètre fournit le texte d'en-tête pour la colonne des commandes détaillées. Une valeur définie sous la forme "" crée un en-tête ne comportant pas de texte.
- expandStyle, expandClass, expandHeaderStyle, expandHeaderClass,
expandAreaStyle, expandAreaClass, expandRowStyle, expandRowClass, collapseStyle,
collapseClass, collapseAreaStyle, collapseAreaClass
- Il s'agit de substitutions de classe et de style pour les commandes de cette option. Si ces substitutions ne sont pas définies, les valeurs standard des objets fenêtre sont applicables.
Les styles HTML standard peuvent être utilisés et les classes sont appliquées dans l'ordre.
- Ce paramètre, Activer l'option de positionnement du curseur dans les zones d'entrée, disponible pour les objets fenêtre utilisés pour le rendu des zones d'entrée, permet aux utilisateurs de passer du mode d'entrée de données au mode de positionnement du curseur pour les zones d'entrée. En mode d'entrée de données, l'utilisateur peut entrer des données dans la zone d'entrée. En mode de positionnement du curseur, l'utilisateur peut passer d'un caractère à l'autre à l'aide de la touche de tabulation ou positionner le curseur sur n'importe quel caractère dans la zone d'entrée. Ce paramètre est utile pour les unités ne disposant pas des fonctionnalités de positionnement du curseur.
En plus des paramètres d'objet fenêtre Activer l'option de positionnement du curseur dans les zones d'entrée décrits dans Paramètres d'objet fenêtre, les paramètres suivants peuvent être utilisés pour personnaliser davantage la présentation des commandes utilisées pour cette option. Ces paramètres ne s'affichent pas dans l'interface HATS Toolkit. Vous devez ajouter ces paramètres à la source de l'objet fenêtre. La source ci-dessous présente des exemples de ces paramètres et utilise un objet fenêtre de zone comme exemple.
<class name="com.ibm.hats.transform.widgets.FieldWidget">
<setting name="dataModeCEPRepresentation" value="button"/
<setting name="dataModeCEPValue" value="back"/>
<setting name="dataModeCEPAltValue" value="data entry"/>
<setting name="cursorModeCEPRepresentation" value="image"/>
<setting name="cursorModeCEPValue" value="cursorOn.gif"/>
<setting name="cursorModeCEPAltValue" value="cursor entry"/>
<setting name="cursorCEPRepresentationStyle"
value="text-underline:true"/>
<setting name="useCursorExactPositioningOption" value="true"/>
</class>
- dataModeCEPRepresentation
- Détermine la représentation graphique utilisée pour la commande affichée à côté de la zone d'entrée en mode données. Définissez button, link ou image. La valeur par défaut est link.
- dataModeCEPValue
- Si la valeur du paramètre dataModeCEPRepresentation est button ou link, cette dernière est utilisée comme élément texte dans le bouton ou le lien. Si aucune valeur n'est spécifiée, un astérisque (*) est utilisé par défaut. Une valeur de chaîne vide"" n'est pas admise et l'astérisque (*) est utilisé par défaut.
Si la valeur du paramètre dataModeCEPRepresentation est image, elle correspond au chemin d'accès du fichier image à utiliser ainsi qu'au nom du fichier. La recherche du chemin d'accès est effectuée selon le répertoire du contenu Web du projet. Par exemple, si vous souhaitez spécifier sbarleftblk.gif dans le répertoire de contenu Web Content/common/images, définissez dataModeCEPValue comme suit :
<setting name="dataModeCEPValue"
value="common/images/sbarleftblk.gif"/>
- dataModeCEPAltValue
- Ce paramètre fournit un texte secondaire pour l'image. Il est uniquement utilisé lorsque le paramètre dataModeCEPRepresentation est défini sur image et que le navigateur ne peut pas afficher l'image spécifiée, par exemple l'option Menu > Afficher > Show Pictures d'Internet Explorer Mobile n'est pas sélectionnée.
- dataModeIconClass, dataModeIconStyle
- Il s'agit de substitutions de style et de classe pour l'icône Data mode representation. Si ces substitutions ne sont pas définies, les valeurs standard des objets fenêtre sont applicables. Les styles HTML standard peuvent être utilisés et les classes sont appliquées dans l'ordre.
- cursorModeCEPRepresentation
- Détermine la représentation graphique utilisée pour la commande affichée à côté de la zone d'entrée en mode curseur. Définissez button, link ou image. La valeur par défaut est link.
- cursorModeCEPValue
- Si la valeur associée au paramètre cursorModeCEPRepresentation est button ou link, cette valeur est utilisée comme élément texte dans le bouton ou le lien. Si aucune valeur n'est spécifiée, un astérisque (*) est utilisé par défaut. Une valeur de chaîne vide"" n'est pas admise et l'astérisque (*) est utilisé par défaut.
Si la valeur du paramètre cursorModeCEPRepresentation est image, elle correspond au chemin d'accès du fichier image à utiliser ainsi qu'au nom de ce fichier. La recherche du chemin d'accès est effectuée selon le répertoire du contenu Web du projet. Par exemple, si vous souhaitez spécifier sbarrightblk.gif dans le répertoire de contenu Web Content/common/images, définissez cursorModeCEPValue comme suit :
<setting name="cursorModeCEPValue"
value="common/images/sbarrightblk.gif "/>
- cursorModeCEPAltValue
- Ce paramètre fournit un texte secondaire pour l'image. Il est uniquement utilisé lorsque le paramètre cursorModeCEPRepresentation est défini sur image et que le navigateur ne peut pas afficher l'image spécifiée, par exemple, l'option Menu > Afficher > Show Pictures d'Internet Explorer Mobile n'est pas sélectionnée.
- cursorCEPRepresentationStyle
- Ce style permet de mettre en évidence la position de curseur actuellement sélectionnée. La valeur par défaut est border-bottom: 1px solid green;. Une chaîne vide "" est également valide.
- cursorModeCEPStyle
- Style utilisé dans les zones d'entrée en mode curseur. Le style par défaut est border: 1px solid #999999;
height: 1.75em;. Il est recommandé de ne pas modifier ce style, sauf si nécessaire.
- cursorCEPRepresentationClass, cursorModeIconClass, cursorModeIconStyle,
cursorModeCEPClass, cursorModeCEPTextStyle, cursorModeCEPTextClass
- Il s'agit de substitutions de classe et de style pour les éléments d'association en mode curseur. Si ces substitutions ne sont pas définies, les valeurs standard des objets fenêtre sont applicables. Les styles HTML standard peuvent être utilisés et les classes sont appliquées dans l'ordre.
- dataModeIconClass, dataModeIconStyle
- Il s'agit de substitutions de classe et de style pour les éléments d'association en mode données. Si ces substitutions ne sont pas définies, les valeurs standard des objets fenêtre sont applicables. Les styles HTML standard peuvent être utilisés et les classes sont appliquées dans l'ordre.
- Dans certains cas, lors d'une liaison sans fil, la connexion au routeur ou au serveur HTTP peut être interrompue. Si cela se produit, la page Web peut ne pas être verrouillée et HATS ne peut pas renvoyer d'informations.
Les paramètres suivants sont disponibles pour résoudre ce problème. Les paramètres sont disponibles dans la classe RuntimeSettings
dans la vue source Paramètres du projet (le fichier application.hap).
- usePageUID
- Indique s'il faut activer l'affichage d'un pageUID à l'écran.
Cela permet à l'exécution d'effectuer un suivi de la page pour voir si elle a déjà été envoyée. Si cette valeur est false, la valeur pageSubmitTimeout n'est pas lue. La valeur par défaut est false.
- pageSubmitTimeout
- Indique le temps d'attente (millisecondes) préalable au déverrouillage de la page Web pour qu'elle puisse être utilisée. Une valeur de -1, ou vide, rend cette fonction inactive. La valeur par défaut est -1.
- incorrectPageUIDEvent
- Indique la méthode à adopter lorsque la requête PageUID
sur la page Web de l'utilisateur ne correspond pas au PageUID stocké dans l'exécution pour ce sessionid et cette instance de l'application. Elle propose 2 options : REFRESHCOMMAND ou ERROREVENT. La valeur par défaut est REFRESHCOMMAND.
La source ci-dessous montre des exemples de ces paramètres.
<class name="com.ibm.hats.common.RuntimeSettings">
<setting name="autoEraseFields" value="true"/>
<setting name="enableAutoAdvance" value="false"/>
<setting name="enableAutoTabOn" value="false"/>
<setting name="enableBusyPage" value="false"/>
<setting name="enableCompression" value="false"/>
<setting name="enableOverwriteMode" value="false"/>
<setting name="incorrectPageUIDEvent" value="REFRESHCOMMAND"/>
<setting name="pageSubmitTimeout" value="1000"/>
<setting name="selectAllOnFocus" value="false"/>
<setting name="suppressUnchangedData" value="false"/>
<setting name="usePageUID" value="true"/>
</class>
- La fonction d'interrogation AJAX d'un navigateur exécuté sur un iPhone ou un iPod touch
s'arrête lorsque vous passez du navigateur à une autre application.
Ainsi, lorsque vous passez d'un navigateur accédant à HATS à une autre
application de votre appareil, HATS déconnecte la session du navigateur à
expiration du Délai d'attente de déconnexion (secondes). Par ailleurs, il est possible d'augmenter cet intervalle ou de désactiver la
fonction de déconnexion automatique pour les applications HATS accessibles à partir d'un
iPhone ou d'un iPod touch. Pour plus d'informations, voir Utilisation de la méthode pull du client (AJAX).
- Pour des considérations concernant les caractères DBCS, voir Utilisation des applications unité mobile.
Outre les options automatiquement désactivées par HATS, les fonctions suivantes ne sont pas prises en charge et ne doivent pas être implémentées dans les applications HATS pour les unités mobiles :
- Il n'est pas possible de faire migrer ou de convertir automatiquement des projets Web HATS en projets Web HATS pour unités mobiles.
- Applications client enrichi.
- Applications de portail (standard ou IBM®).
- Interopérabilité avec WebFacing.
- Prise en charge des langues bidirectionnelles.
- Fonctions d'accessibilité.
- Unités dont la taille de l'écran est inférieure à 320x240.
- Prise en charge de la touche Hôte du clavier.
Grâce à cette fonction, le clavier peut être utilisé commeun clavier Web standard, les touches Hôte ne sont pas envoyées, la touche F1 affiche l'aide du navigateur et la touche Entrée n'est pas associée à la touche Entrée de l'hôte.
Par ailleurs, sans la prise en charge du clavier,
JavaScript™ HATS ne peut
pas déterminer si l'utilisateur a entré des données sur la page Web HATS. Par conséquent, la prise en charge de la régénération automatique remplace toutes les données entrées par l'utilisateur dans l'interface graphique de l'application HATS lorsqu'un nouvel écran hôte est reçu de manière asynchrone de l'application hôte.
- Aide spécifique pour une zone, justifier à droite, mettre en majuscules et d'autres attributs.
- Toute autre restriction relative à la saisie de données applicable au matériel ou au logiciel de l'unité.
- Accès à la page de console d'administration HATS par une unité mobile.
- Le paramètre de connexion disconnectOnClose.
- Les combinaisons d'écran.
- Support d'un dossier à onglets.
- Support du tableur.