Développement et déploiement d'applications client enrichi HATS

HATS vous offre la possibilité de transformer l'accès à vos applications hôte existantes en utilisant des applications client enrichi avec interface graphique exécutées dans les environnements Eclipse RCP, Lotus Notes ou Lotus Expeditor Client.

Eclipse RCP constitue un sous-ensemble des modules d'extension fournis par la plateforme Eclipse, la plateforme d'outils de source ouverte bien connue. L'introduction de la plateforme client enrichi Eclipse vous permet de bénéficier des fonctionnalités essentielles offertes par Eclipse pour construire des applications client natives ciblées pour le bureau d'un utilisateur. Pour plus d'informations sur la plateforme client enrichi Eclipse, voir la page Web http://www.eclipse.org/home/categories/rcp.php.

Lotus Notes est un logiciel complexe et puissant vous permettant d'accéder instantanément à vos informations essentielles. Lotus Notes permet d'envoyer et de recevoir des messages électroniques, de planifier vos rendez-vous, de naviguer sur le Web, de participer à des groupes de discussion sur Internet et de bénéficier d'un accès simplifié à l'ensemble des informations importantes de la journée via la page d'accueil. Pour plus d'informations, voir le centre de documentation Lotus Notes à l'adresse http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp.

Lotus Expeditor Client fournit un environnement d'exécution client enrichi et des composants middleware intégrés pour étendre de nombreuses applications d'entreprise sur les systèmes de bureau et portables gérés par un serveur. Pour plus d'informations sur le développement et le déploiement d'applications pour Lotus Expeditor Client, reportez-vous au centre de documentation Lotus Expeditor à l'adresse http://publib.boulder.ibm.com/infocenter/ledoc/v6r2/index.jsp.

Remarque :

Sauf indication contraire, les instructions fournies ici concernent le développement et le déploiement d'applications client enrichi HATS dans les environnements Eclipse RCP V3.4, Lotus Notes V8.5.1 et Lotus Expeditor Client V6.2. Pour connaître les instructions qui s'appliquent aux versions antérieures d'Eclipse RCP et de Lotus Expeditor Client, voir les versions antérieures des centres de documentation appropriés.

Un environnement client enrichi offre des fonctionnalités qui ne sont pas disponibles dans un environnement Web traditionnel, notamment :

Pour obtenir plus d'informations sur le développements d'applications client enrichi, consultez le Sommaire de l'aide de Rational SDP. Sélectionnez Aide > Sommaire dans la barre de menus et recherchez rich client (client enrichi).

Lors de la création d'applications client enrichi HATS, les différences entre les environnements Eclipse RCP, Lotus Notes et Lotus Expeditor Client sont minimes. Elles sont décrites tout au long de ce chapitre.

La principale différence au niveau architectural entre une application client enrichi HATS et une application Web HATS réside dans l'emplacement d'initialisation de la connexion socket Telnet. Avec une application client enrichi, la connexion socket est initialisée à partir du poste de travail d'un utilisateur et non à partir de WebSphere Application Server, comme c'est le cas avec une application Web HATS. Comme les applications client enrichi requièrent un client sur le poste de travail de l'utilisateur, elles sont essentiellement ciblées pour les utilisateurs internes, habitués à un émulateur de terminal client complet classique.

Développement d'applications client enrichi HATS

Les étapes d'élaboration et de test d'une application client enrichi HATS sont quasiment les mêmes que pour une application Web HATS. Vous utilisez HATS Toolkit avec les outils proposés dans la perspective HATS pour développer un projet de client enrichi HATS qui servira ensuite de point de départ pour la génération de l'application client enrichi HATS. Vous disposez des mêmes assistants, éditeurs et vues pour exécuter les activités requises durant le développement. Pour créer des applications ciblées pour Lotus Notes ou Lotus Expeditor Client, Lotus Expeditor Toolkit doit être installé et peut être utilisé pour faciliter leur création.

Comme pour l'environnement Web HATS, vous travaillez sur la présentation et le fonctionnement de l'application, notamment la possibilité de personnaliser les paramètres de rendu par défaut, la navigation entre écrans (à l'aide de macros de saut d'écrans), ainsi que les polices de caractères et couleurs utilisées pour le rendu des écrans.

La majorité des fonctions disponibles dans une application Web HATS sont également proposées dans une application client enrichi HATS. Il s'agit entre autres des fonctions suivantes :

Les fonctions disponibles pour les applications Web HATS qui n'existent pas pour les applications client enrichi HATS sont les suivantes :

Un projet de client enrichi HATS est un projet de module d'extension Eclipse. En tant que projet, il existe dans un espace de travail et est développé par un développeur d'applications HATS. Une fois développé et testé, le projet peut être exporté sous la forme d'une application client enrichi HATS, qui est un module d'extension Eclipse pouvant être installé dans un environnement Eclipse. Un module d'extension Eclipse est un composant proposant un certain type de service dans le contexte d'un environnement Eclipse. Dans le cas de HATS, le module d'extension offre le service requis pour transformer une application hôte.

Chaque module d'extension HATS client enrichi dépend de plusieurs modules d'extension d'exécution. Les dépendances sont référencées dans le fichier de manifeste du projet client enrichi, MANIFEST.MF. Vous devez vous assurer que ces modules d'extension obligatoires sont inclus dans l'environnement de test local et dans l'environnement de production déployé pour que votre module d'extension de HATS client enrichi fonctionne correctement. Pour plus d'informations, voir Projet d'extension d'exécution de la plateforme client enrichi HATS, Test des applications client enrichi HATS et Déploiement d'applications client enrichi HATS.

Spécificités de la plateforme cible

Contenu du projet

Lorsque vous créez un projet de client enrichi HATS, vous êtes invité à sélectionner une plateforme cible. Cette sélection indique où vous pensez déployer l'application. Les différences entre un projet ciblé pour le déploiement sur Eclipse RCP, Lotus Notes ou Lotus Expeditor Client sont mineures. Les caractéristiques suivantes sont communes à tous les projets de client enrichi HATS :

Ajout pour les projets dont le déploiement est ciblé sur Eclipse RCP :

Ajouts pour les projets dont le déploiement est ciblé sur Lotus Notes et Lotus Expeditor Client :

Définition du niveau de conformité du compilateur

L'environnement d'exécution Java (JRE) de votre espace de travail SDP Rational et de votre environnement d'exécution souhaité doivent être les mêmes. Par exemple, si vous développez un module d'extension de HATS client enrichi pour une exécution dans un environnement Eclipse exécutant un JRE (Java Runtime Environment), vous devez définir le niveau de conformité du compilateur de votre espace de travail à 1.6. Pour ce faire, dans la barre de menus Rational SDP, sélectionnez Fenêtre > Préférences > Java > Compilateur et définissez l'option Niveau de conformité du compilateur à la valeur 1.6.

Si vous avez d'autres projets de module d'extension ou Java dans votre espace de travail qui nécessitent d'autres niveaux de conformité, vous pouvez définir le niveau de conformité du compilateur individuellement pour chaque projets de module d'extension ou Java. Pour ce faire, cliquez avec le bouton droit sur le projet, puis sélectionnez Propriétés. Dans le panneau Propriétés, sélectionnez Compilateur Java sur la gauche. Sélectionnez ensuite la case Enable project specific settings et définissez Compiler compliance level sur le niveau approprié.

Remarque :
Le projet d'extension d'exécution de la plateforme client enrichi HATS, com.ibm.hats.rcp.runtime.extension, doit avoir le même niveau de conformité du compilateur que votre projet de client enrichi HATS. Voir Projet d'extension d'exécution de la plateforme client enrichi HATS.

Projet d'extension d'exécution de la plateforme client enrichi HATS

Lorsque vous créez un projet HATS client enrichi, un projet pour le module d'extension extension d'exécution de la plateforme client enrichi HATS (désormais désigné sous le nom de module d'extension d'exécution) est créé automatiquement s'il n'existe pas déjà dans l'espace de travail. Le module d'extension d'exécution a pour nom et ID com.ibm.hats.rcp.runtime.extension et pout version initiale 1.0.0.

Le module d'extension d'exécution est une extension du module d'extension module d'exécution de la plateforme client enrichi HATS (com.ibm.hats.rcp.runtime). Le module d'exécution de la plateforme client enrichi HATS contient les classes d'exécution HATS et il doit se trouver dans l'environnement pour que les applications client enrichi HATS puissent fonctionner. Le module d'extension d'exécution permet de configurer les paramètres liés à l'environnement d'exécution.

Ce projet de module d'extension contient les artefacts configurables suivants :

Ce projet est identique à un projet HATS EAR dans l'environnement Web, mais il n'existe qu'un module d'extension de ce type par environnement d'exécution. En d'autres termes, un seul module d'extension d'exécution s'exécute dans l'environnement de l'utilisateur. Chaque fichier plugin.xml du projet de client enrichi HATS déclare une dépendance par rapport à ce fichier. Le module d'extension d'exécution ne fait pas référence aux modules d'extension individuels des applications HATS.

Etant donné qu'une seule copie du module d'extension d'exécution peut être lancée dans l'environnement d'exécution, vous devez vous assurer qu'il n'existe qu'une seule copie du module d'extension dans l'environnement de l'utilisateur. S'il existe plusieurs modules d'extension d'exécution dans l'environnement, celui qui possède le niveau de version le plus élevé est utilisé. Ainsi, vous êtes sûr que le code le plus récent est toujours utilisé.

Le projet d'extension d'exécution n'apparaît pas dans la vue Projets HATS, mais il est consultable dans la vue Navigateur. Il est inclus dans la projet généré au moment de l'exportation. Pour plus d'informations, voir Déploiement d'applications client enrichi HATS.

Remarque :
Ce projet n'est pas supprimé lorsque le dernier projet de client enrichi HATS est supprimé. Vous devez le supprimer manuellement pour qu'un projet d'extension d'exécution soit créé.

Utilisation des projets de client enrichi HATS

Comme pour un projet Web HATS, lorsque vous créez un nouveau projet HATS client enrichi, un ensemble de dossiers est créé afin de vous aider à organiser les fichiers HATS. Vous trouverez ci-dessous un exemple d'un projet par défaut. 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 ne s'affichent qu'à la création de certains objets.

Figure 6. Vue de projet client enrichi HATS
Vue de projet client enrichi HATS

Selon la configuration de votre projet, une partie ou la totalité de ces dossiers peuvent apparaître 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.

Remarques :
  1. Un projet de client enrichi affiche un dossier Contenu de client enrichi, alors qu'un projet Web affiche un dossier Contenu Web.
  2. Le dossier Contenu de client enrichi est affiché au niveau de la racine du projet de client enrichi. Toutefois, le projet ne contient pas de dossier Contenu de client enrichi proprement dit. Un dossier s'affiche de manière dynamique afin d'établir une cohérence avec le dossier Contenu Web affiché pour les projets Web.
  3. Certains dossiers affichés sous le dossier dynamique Contenu de client enrichi s'affichent également sous le dossier Source.
  4. Les décorateurs de libellés des dossiers de client enrichi dynamiques peuvent ne pas fonctionner correctement car ces dossiers ne correspondent pas à des dossiers physiques du projet.

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.

Il est possible de partager les projets HATS pour une équipe en accédant à la vue du navigateur de votre perspective. 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).

Copie des ressources entre des projets Web et des projets de client enrichi

Vous pouvez copier, coller, supprimer, déplacer et renommer les ressources client enrichi à l'aide du menu contextuel de la vue Projets HATS. Les ressources suivantes peuvent être copiées ou déplacées entre les projets Web HATS et client enrichi HATS :

Remarque :
Vous n'êtes pas autorisé à copier des transformations, des fragments de transformation ou des modèles entre des projets Web HATS et client enrichi HATS.

Certaines ressources copiées à partir de projets de types différents nécessiteront une modification. Par exemple, une macro copiée à partir d'un projet Web HATS vers un projet de client enrichi HATS devra être mise à jour afin de faire référence à un gestionnaire de macro Java SWT valide (pour les projets HATS, les macros font référence à un gestionnaire de macro JSP). Les personnalisations d'écran devront également être mises à jour à cause des références aux transformations JSP spécifiées dans l'action "appliquer" et des URL spécifiées dans l'action "réacheminer". Un message d'avertissement s'affiche dans la vue Problèmes afin de vous aider à détecter et résoudre ces problèmes. Les scénarios suivants sont repérés :

Il n'existe pas de fonction intégrée permettant de migrer une application Web HATS vers une application plateforme client enrichi HATS. Certains artefacts, tels que les personnalisations d'écran, les macros, les connexions, les captures d'écran, les images, les fichiers source de logique applicative et les fichiers source de composant personnalisé peuvent être migrés manuellement d'un type de projet à un autre sans devoir faire l'objet de modifications importantes. En revanche, d'autres artefacts, tels que les transformations, les objets fenêtre personnalisés, les modèles et les gestionnaires de macro personnalisés, doivent être modifiés de manière plus significative pour pouvoir fonctionner dans un type de projet différent.

Exportation et importation de projets de client enrichi HATS

Pour déplacer un projet de client enrichi HATS vers un autre système alors que Rational SDP est installé, ou pour enregistrer et restaurer un projet pour un motif quelconque, vous pouvez faire appel aux fonctions d'exportation et d'importation de Rational SDP.

Exportation

Exportez un projet ainsi que ses projets dépendants sous forme de fichier .zip à l'aide de la fonction Project Interchange de Rational SDP. Cette fonction comporte de nombreux avantages. Elle permet d'exporter simultanément plusieurs projets, y compris le projet d'extension d'exécution requis (com.ibm.hats.rcp.runtime.extension). 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 ou les projets à partir de HATS Toolkit sous forme de fichier Project Interchange, procédez comme suit :

  1. Dans la barre de menus, sélectionnez Fichier > Exporter pour ouvrir l'assistant d'exportation.
  2. Sélectionnez Autre > Project Interchange et cliquez sur Suivant.
  3. Sélectionnez le ou les projets à exporter.
    Remarque :
    Un projet d'extension d'exécution (com.ibm.hats.rcp.runtime.extension) est indispensable à l'exécution d'un projet de client enrichi HATS. Vous devez donc exporter le projet d'extension d'exécution comme faisant partie du fichier Project Interchange ou générer un autre projet extension d'exécution sur le système cible en créant un projet de client enrichi HATS.
  4. Indiquez le nom et l'emplacement du fichier .zip dans lequel vous souhaitez sauvegarder les projets.
  5. Cliquez sur Fin.

Importation

Pour importer un fichier .zip Project Interchange dans HATS Toolkit :

  1. Dans la barre de menus, sélectionnez Fichier > Importer pour ouvrir l'assistant d'importation.
  2. Sélectionnez Autre > Project Interchange et cliquez sur Suivant.
  3. Indiquez le fichier .zip à importer dans la zone de provenance du fichier zip.
  4. Spécifiez l'espace de travail dans lequel vous souhaitez importer le fichier .zip dans la zone Project location root.
  5. Sélectionnez les projets dans le fichier Project Interchange que vous voulez importer dans l'espace de travail indiqué.
    Remarque :
    Un projet d'extension d'exécution (com.ibm.hats.rcp.runtime.extension) est indispensable à l'exécution d'un projet de client enrichi HATS. Vous devez donc importer le projet d'extension d'exécution comme faisant partie du fichier Project Interchange ou générer un autre projet extension d'exécution en créant un projet de client enrichi HATS.
  6. Cliquez sur Fin.

Test des applications client enrichi HATS

Configuration de la plateforme cible

Pour tester un module d'extension d'application HATS client enrichi dans un environnement de test local, lancez ce module, ainsi que tous les modules d'extension requis dans une instance de la plateforme cible. La plateforme cible fait référence au produit Eclipse (par exemple, Eclipse RCP, Lotus Notes ou Lotus Expeditor Client) sur lequel le module d'extension en cours de développement sera compilé et testé. Pour configurer la plateforme cible, utilisez la boîte de dialogue Fenêtre > Préférences > Plug-in Development > Plateforme cible de Rational SDP.

Lotus Notes

Pour configurer une plateforme cible Lotus Notes en vue de tests, Lotus Expeditor Toolkit version 6.2.1 ou suivante et Lotus Notes version 8.5.1 ou suivante doivent être installés. Si Lotus Expeditor Toolkit est installé, ainsi que la fonction de configuration de l'environnement de test Lotus Expeditor, la boîte de dialogue de configuration présentée ci-dessous s'affiche lors de la première ouverture de l'espace de travail. Vous pouvez configurer les moments auxquels elle s'ouvre dans les Préférences de configuration de l'environnement de test, affiché ci-dessous. L'Emplacement cible est contenu dans l'emplacement d'installation par défaut de Lotus Notes. Assurez-vous de paramétrer les options Nom VM et Niveau de conformité du compilateur tel qu'indiqué ci-dessous. Si vous sélectionnez l'option Ne jamais afficher, vous pouvez réinitialiser l'option pour afficher cette boîte de dialogue de configuration, en utilisant Fenêtre > Préférences > Services client dans la barre de menus Rational SDP.

Figure 7. Configuration de l'environnement de test Lotus Notes
Configuration de l'environnement de test Lotus Notes

Lotus Expeditor

Pour configurer une plateforme cible Lotus Expeditor en vue de tests, Lotus Expeditor Toolkit et Lotus Expeditor Client for Desktop doivent être installés et la version de l'un et de l'autre doivent correspondre. Si vous utilisez Lotus Expeditor Client for Desktop version 6.2.0 ou antérieure, DRE (Device Runtime Environment) doit également être installé.

Pour Lotus Expeditor Client, les fonctions suivantes doivent être ajoutées à l'installation par défaut :

Dans le client Lotus Expeditor Client, sélectionnez Fichier > Application > Installer > Rechercher des nouvelles fonctions à installer > Ajouter un emplacement de dossier. Naviguez jusqu'au dossier suivant dans les fichiers du produit Lotus Expeditor Client : desktop\updates\platform, puis sélectionnez Terminer. Développez updates/platform et Development. Cochez Lotus Expeditor Desktop Development Utilities. Développez aussi Runtime Components, puis cochez Service Data Objects (SDO) Components. Cliquez ensuite sur Suivant pour continuer dans l'assistant.

Dans Lotus Expeditor Client version 6.2.0 ou suivante, pour installer la fonction Core JVM - J2SE, dans Lotus Expeditor Client sélectionnez Fichier > Application > Installer > Rechercher des nouvelles fonctions à installer > Ajouter un emplacement de dossier. Naviguez jusqu'à l'emplacement du site Desktop Runtime Environment, à savoir le répertoire update.site.dre.client, puis sélectionnez OK. Acceptez le nom de site par défaut, puis sélectionnez OK et Terminer. Développez le site et Composants d'exécution. Cochez Core JVM Feature - J2SE. Sélectionnez Suivant, puis fermez l'assistant.

Si Lotus Expeditor Toolkit est installé, ainsi que la fonction de configuration de l'environnement de test Lotus Expeditor, la boîte de dialogue de configuration présentée ci-dessous s'affiche lors de la première ouverture de l'espace de travail. Vous pouvez configurer les moments auxquels elle s'ouvre dans les Préférences de configuration de l'environnement de test, affiché ci-dessous. L'Emplacement cible est contenu dans l'emplacement d'installation par défaut de Lotus Expeditor Client for Desktop. Assurez-vous de paramétrer les options Nom VM et Niveau de conformité du compilateur tel qu'indiqué ci-dessous. Si vous sélectionnez l'option Ne jamais afficher, vous pouvez réinitialiser l'option pour afficher cette boîte de dialogue de configuration, en utilisant Fenêtre > Préférences > Services client dans la barre de menus Rational SDP.

Remarque :
A la première ouverture de cette boîte de dialogue de configuration, la valeur affichée pour le Nom VM peut être com.ibm.rcp.j2se.win32.x86.
Figure 8. Configuration de l'environnement de test Lotus Expeditor
configuration de l'environnement de test Lotus Expeditor

En plus du test dans un environnement de test local, vous devez exporter votre projet sous la forme d'une application et la déployer dans un environnement de production afin de tester le processus de déploiement. Pour plus d'informations, voir Déploiement d'applications client enrichi HATS.

Installation des modules d'extension d'exécution

Pour que les modules d'extension d'application client enrichi HATS puissent fonctionner dans l'environnement de test local de la plateforme cible, vous devez installer les modules d'extension d'exécution requis sur cette plateforme. Lorsque vous créez un projet et sélectionnez la plateforme cible, ou modifiez par la suite la plateforme cible, HATS Toolkit détecte si les modules d'extension d'exécution requis sont installés au niveau le plus récent sur la plateforme cible sélectionnée. Si ce n'est pas le cas, le toolkit vous invite à procéder à l'installation des modules d'extension d'exécution requis. Vous pouvez activer ou désactiver cette invite dans les préférences de HATS. Voir Préférences HATS pour plus d'informations. Voici les modules d'extension d'exécution requis qui sont installés :

Pour une plateforme cible Lotus Notes, les modules d'extension Eclipse suivants sont également installés :

Remarque :
Par défaut, la plateforme cible est Rational SDP. Comme HATS Toolkit est installé dans Rational SDP, les modules d'extension d'exécution de HATS sont déjà installés et aucune invite ne s'affiche si vous adoptez la plateforme cible par défaut.

Après avoir installé les modules d'extension d'exécution de HATS les plus récents sur la plateforme cible, vous devez recharger les nouveaux modules d'extension. Pour ce faire, utilisez la boîte de dialogue Fenêtre > Préférences > Développement de plug-in > Plateforme cible dans Rational SDP, puis cliquez sur Recharger.

Définition du JRE par défaut

Outre la configuration de la plateforme cible et l'installation des modules d'extension d'exécution, vous devrez peut-être définir le JRE par défaut pour votre espace de travail dans Rational SDP.

Plateforme client enrichi Eclipse

Lorsque vous effectuez le test sur une plateforme cible Eclipse RCP, définissez le JRE par défaut sur jdk. Pour ce faire, procédez comme suit :

  1. Dans la barre de menus Rational SDP, sélectionnez Fenêtre > Préférences > Java > JRE installés.
  2. Dans la liste des JRE installés, sélectionnez la case en regard de jdk.
  3. Cliquez sur OK.

Assurez-vous que vos JRE correspondent. Ainsi, si vous procédez au test dans un environnement Eclipse qui doit exécuter Java 1.6, vous devez mettre à jour le JRE de votre espace de travail pour qu'il corresponde à celui de l'environnement d'exécution.

Lotus Notes

Lorsque vous effectuez vos tests sur une plateforme cible Lotus Notes, vous avez probablement déjà défini le JRE par défaut pour l'espace de travail à l'aide de la boîte de dialogue de configuration de Lotus Expeditor Toolkit (voir figure 7). Dans le cas contraire, procédez comme suit :

Lotus Expeditor Client

Lorsque vous effectuez vos tests sur une plateforme cible Lotus Expeditor, vous avez probablement déjà défini le JRE par défaut pour l'espace de travail à l'aide de la boîte de dialogue de configuration de Lotus Expeditor Toolkit (voir figure 8). Dans le cas contraire, procédez comme suit :

  1. Dans la barre de menus Rational SDP, sélectionnez Fenêtre > Préférences > Java > JRE installés.
  2. Veillez à sélectionnez le JRE Java SE 6.0 Win32 x86.
    Remarque :
    Si le JRE Java SE 6.0 Win32 x86 n'apparaît pas, il peut s'avérer nécessaire de lancer un espace de travail vierge, c'est-à-dire d'accéder à un nouveau répertoire de travail.
  3. Cliquez sur OK.

lancement de votre projet

Une configuration de lancement est nécessaire pour lancer votre projet. HATS créé une configuration de lancement par défaut lorsque vous cliquez sur Exécuter ou Déboguer dans votre projet (voir les instructions dans les sections ci-dessous). Aucune configuration de lancement n'est créé lorsque les boites de dialogue Exécuter ou Déboguer sont ouvertes à partir d'une autre vue, tel que la vue Explorateur de packages, par exemple. La configuration de lancement par défaut est basée sur la plateforme cible du projet, définie dans l'assistant Nouveau projet ou dans l'éditeur des paramètres du projet. Si vous modifiez la configuration de lancement par défaut de sorte qu'elle ne soit plus en mesure de lancer un espace de travail d'exécution, vous pouvez supprimer la configuration de lancement ; elle sera recréée par HATS lorsque vous cliquerez sur Exécuter ou Déboguer de nouveau. Pour lancer votre projet, suivez les instructions relatives à votre plateforme cible indiquées dans les sections ci-dessous.

Plateforme client enrichi Eclipse

Pour lancer le projet dans l'environnement de test local pour la plateforme client enrichi Eclipse, procédez comme suit :

  1. Dans la vue Projets HATS, cliquez avec le bouton droit sur le projet et sélectionnez Exécuter ou Déboguer.
  2. Si vous avez sélectionné Déboguer, répondez Oui, Non ou Annuler dans la boîte de dialogue Afficher le terminal pour indiquer si vous souhaitez afficher l'écran du terminal hôte pendant le test de l'application.
  3. Dans la boîte de dialogue Run (or Debug) Configurations, HATS crée et configure automatiquement une configuration de lancement par défaut nommée hostaccess.
  4. Dans l'onglet Principal de la section Programme à exécuter, veillez à ce que com.ibm.hats.rcp.runtime.extension.product apparaisse dans la zone Exécuter un produit.
  5. Cliquez sur Exécuter (ou Déboguer) pour lancer la configuration par défaut.
  6. Une nouvelle instance du plan de travail Eclipse est lancée.
  7. La perspective Host Access s'ouvre automatiquement.
  8. Votre application HATS est répertoriée dans la vue Applications. Pour lancer votre application, cliquez deux fois sur son nom ou cliquez avec le bouton droit et sélectionnez Ouvrir.
  9. Une nouvelle instance de l'application sélectionnée est ouverte et sa vue transformation est affichée.

Lotus Notes

Lotus Expeditor Toolkit et Lotus Notes doivent être installés sur le même poste de travail de développement que Rational SDP pour qu'un module d'extension HATS ciblé pour Lotus Notes puisse être testé en local. Pour pouvoir tester votre projet, Lotus Notes ne doit pas être en cours d'exécution, car plusieurs instances de Lotus Notes ne peuvent pas être exécutées simultanément. Voir Configuration de la plateforme cible.

Pour lancer votre projet dans l'environnement de test local de Lotus Notes, procédez comme suit :

  1. Dans la vue Projets HATS, cliquez avec le bouton droit sur le projet et sélectionnezExécuter ou Déboguer.
  2. Si vous avez sélectionné Déboguer, répondez Oui, Non ou Annuler dans la boîte de dialogue Afficher le terminal pour indiquer si vous souhaitez afficher l'écran du terminal hôte pendant le test de l'application.
  3. Dans la boîte de dialogue Run (or Debug) Configurations, HATS crée et configure automatiquement une configuration de lancement par défaut nommée hostaccess.
  4. Dans l'onglet Principal de la section Programme à exécuter, veillez à ce que com.ibm.notes.branding.notes apparaisse dans la zone Exécuter un produit.
  5. Dans l'onglet Principal de la section Java Runtime Environment, assurez-vous que l'environnement Notes 8.5.1 VM est répertorié dans la zone Runtime JRE. Pour plus d'informations, voir Lotus Notes.
  6. Cliquez sur Exécuter (ou Déboguer) pour lancer la configuration.
  7. Une nouvelle instance de Lotus Notes est lancée.
  8. Cliquez sur Ouvrir dans la barre d'outils principale et sélectionnez Host Access.
  9. Votre application HATS est répertoriée dans la vue Applications. Pour lancer votre application, cliquez deux fois sur son nom ou cliquez avec le bouton droit et sélectionnez Ouvrir.
  10. Une nouvelle instance de l'application sélectionnée est ouverte et sa vue transformation est affichée.

Lotus Expeditor Client

Lotus Expeditor Toolkit et Lotus Expeditor Client for Desktop doivent être installés sur le même poste de travail que Rational SDP, pour tester localement un module d'extension HATS ciblé pour Lotus Expeditor. Voir Configuration de la plateforme cible.

Pour lancer votre projet dans l'environnement de test local de Lotus Expeditor Client, procédez comme suit :

  1. Dans la vue Projets HATS, cliquez avec le bouton droit sur le projet, puis sélectionnez Exécuter ou Déboguer
  2. Si vous avez sélectionné Déboguer, répondez Oui, Non ou Annuler dans la boîte de dialogue Afficher le terminal pour indiquer si vous souhaitez afficher l'écran du terminal hôte pendant le test de l'application.
  3. Dans la boîte de dialogue Run (or Debug) Configurations, HATS crée et configure automatiquement une configuration de lancement par défaut nommée hostaccess.
  4. Dans l'onglet Principal de la section Programe à exécuter, veillez à ce que com.ibm.rcp.platform.personality.branding.DefaultProduct apparaisse dans la zone Exécuter un produit.
  5. Dans l'onglet Principal de la section Java Runtime Environment, assurez-vous que Java SE 6.0 Win32 x86 est répertorié dans la zone Runtime JRE. Pour plus d'informations, voir Lotus Expeditor Client.
  6. Cliquez sur Exécuter (ou Déboguer) pour lancer la configuration.
  7. Une nouvelle instance de Lotus Expeditor Client est lancée. Vous pourrez être invité à entrer un nouveau mot de passe lors du premier démarrage du client.
  8. Cliquez sur Ouvrir dans la barre d'outils principale et sélectionnez Host Access.
  9. Votre application HATS est répertoriée dans la vue Applications. Pour lancer votre application, cliquez deux fois sur son nom ou cliquez avec le bouton droit et sélectionnez Ouvrir.
  10. Une nouvelle instance de l'application sélectionnée est ouverte et sa vue transformation est affichée.

Déploiement d'applications client enrichi 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.

Cette section décrit deux méthodes de déploiement des applications client enrichi HATS. La première permet d'intégrer un environnement client Eclipse complet pour distribution qui comporte tous les éléments nécessaires à l'exécution de votre application client enrichi HATS. La deuxième permet d'intégrer votre application client enrichi HATS pour des clients pour lesquels un environnement Eclipse est déjà installé.

Intégration d'un environnement client Eclipse à des fins de distribution

Eclipse SDK, sur lequel repose Rational SDP, permet de générer un client Eclipse complet qui comprend vos modules d'extension d'application HATS et tous les autres modules requis. Ce client peut être réparti sur des systèmes client individuels et s'exécuter en tant qu'applicationautonome.

Remarque :
Les instructions fournies considèrent qu'un projet de module d'extension de client enrichi HATS a été créé et qu'il s'exécute dans l'environnement de test local.

Pour créer le module client, procédez comme suit :

  1. Dans la vue Projets HATS, cliquez avec le bouton droit de la souris sur votre projet client enrichi HATS, puis sélectionnez Nouveau HATS > Configuration du produit dans le menu contextuel. L'assistant de création d'une configuration de produit apparaît. Vous pouvez aussi lancer l'assistant à partir de la barre de menus Rational SDP, en sélectionnant Fichier > Nouveau > Autre > Développement de plug-in > Configuration du produit > Suivant.
  2. Sélectionnez le dossier du projet de module d'extension com.ibm.hats.rcp.runtime.extension comme dossier parent.
  3. Entrez hostaccess.product dans la zone Nom de fichier.
  4. Cliquez sur le bouton radio Utiliser une configuration de lancement et sélectionnez hostaccess.
    Remarque :
    Dans cet exemple, hostaccess est le nom par défaut utilisé pour la configuration d'exécution ou de débogage que vous avez utilisée lors du test de l'application dans l'environnement de test local.
  5. Cliquez sur Fin.
  6. Lorsque l'éditeur de configuration du produit s'ouvre, cliquez sur l'onglet Configuration et supprimez de la liste les modules d'extension superflus suivants :
  7. Sauvegardez le fichier en cliquant sur l'icône Sauvegarder dans la barre d'outils Rational SDP.
  8. Cliquez sur l'onglet Présentation, puis sur le lien Assistant d'exportation du produit Eclipse.
  9. Dans la zone Cible, entrez le nom du répertoire dans lequel Eclipse doit être exporté. Par exemple c:\hostaccess. Vous pouvez également effectuer l'exportation vers un fichier d'archive (.zip), ce qui permet de fournir le module client sous la forme d'un fichier téléchargeable.
  10. Cliquez sur Fin.

Un environnement client Eclipse complet est créé. Pour tester votre application, accédez au répertoire c:\hostaccess à l'aide de l'Explorateur Windows®. A partir du dossier Eclipse, cliquez deux fois sur eclipse.exe. Ce répertoire peut être compressé et téléchargé vers des postes client individuels. Ces derniers doivent comporter un environnement JRE (Java Runtime Environment) compatible.

Intégration de clients Eclipse existants (Eclipse RCP, Lotus Notes ou Lotus Expeditor Client)

Pour déployer une application client enrichi HATS dans un environnement d'exécution de client Eclipse, procédez comme suit :

Les sections suivantes expliquent comment réaliser chacune de ces tâches.

Exportation de votre projet en tant que fonction Eclipse

Pour déployer votre module d'extension d'application client enrichi HATS dans un environnement d'exécution, vous devez d'abord l'intégrer sous forme de fonction Eclipse. Une fonction Eclipse est un artefact de déploiement utilisé pour grouper les modules d'exécution associés. Pour intégrer votre module d'extention en une fonction Eclipse, procédez comme suit.

  1. Créez un répertoire vide, par exemple c:\myHATS, sur votre disque dur local afin d'y enregistrer la fonction d'application HATS exportée. Vous utiliserez ce même répertoire pour stocker les fonctions de phase d'exécution HATS et le fichier site.xml contenant la définition d'un site de mise à jour. Pour plus d'informations, voir Exportation des fonctions d'exécution de HATS et Création d'un site de mise à jour.
  2. Dans la vue Projets HATS, cliquez avec le bouton droit sur le projet client enrichi, puis sélectionnez Exporter > Exporter la fonction dans le menu déroulant.
    Remarque :

    Si vous n'avez pas spécifié vos paramètres de licence, vous verrez un message indiquant que l'exécution n'est pas activée pour cette application et qu'elle ne peut pas fonctionner dans un environnement de production. Il est possible de tester les applications client enrichi HATS dans un environnement de test local (Eclipse, Lotus Notes, ou Lotus Expeditor Client), mais pas dans un environnement d'exécution (autre qu'un environnement de développement) sans avoir auparavant spécifié les paramètres de licence. En d'autres termes, vous pouvez créer et tester complètement l'application dans l'environnement de développement HATS Toolkit. Vous pouvez également exporter l'application, et il est possible à un utilisateur de l'installer, mais ce dernier ne pourra pas se connecter à l'application. L'exécution est en fait verrouillée et n'autorise aucune connexion. Pour plus d'informations sur la spécification des paramètres de licence, voirActivation de l'exécution HATS et de la configuration de la licence dans HATS - Guide d'initiation. Si vous avez acheté des licences, cliquez sur le bouton Activer l'exécution pour activer l'exécution de votre application. Sinon, cliquez sur Continuer pour poursuivre la procédure d'exportation.

  3. Si votre projet ne fait pas déjà partie d'une fonction, une boîte de dialogue vous invite à créer la fonction immédiatement. Cliquez sur Oui pour lancer l'assistant de création d'un projet de fonction HATS.
  4. Dans cet assistant, complétez les zones ID du dispositif, Nom, Version et Fournisseur.
    Remarque :
    La zone Nom est automatiquement remplie lorsque vous complétez la zone ID du dispositif. Une validation des zones ID du dispositif et Nom est effectuée au moment où vous les complétez. La valeur indiquée pour ID du dispositif correspond au nom utilisé pour le projet de fonction créé et toutes les valeurs sont stockées dans le fichier feature.xml du projet. HATS fournit le nom hostaccess comme valeur par défaut pour les zones ID du dispositif et Nom et la version 1.0.0 comme valeur par défaut pour la zone Version.
  5. La liste des modules d'extension est remplie à partir de tous les projets de modules d'extension de client enrichi HATS figurant dans l'espace de travail. Sélectionnez les modules d'extension à inclure dans la nouvelle fonction. Ces modules d'extension seront installés sur le client au moment où la fonction sera installée. Cliquez sur Fin.
  6. Ensuite l'assistant d'exportation Eclipse apparaît. Dans le panneau Deployable features, sélectionnez votre fonction.
  7. Dans l'onglet Destination, sélectionnez Directory et cliquez sur Parcourir pour localiser et sélectionner votre répertoire d'exportation, par exemple c:\myHATS.
  8. Dans l'onglet Options, sélectionnez Faire des packages en tant qu'archives JAR individuelles (obligatoire pour les sites JNLP et de mise à jour).
  9. Cliquez sur Fin.

La fonction d'application client enrichi HATS exportée HATS comprend le module d'extension d'exécution et inclut automatiquement une dépendance par rapport aux fonctions d'exécution HATS. Le projet de fonction n'est pas affiché dans la vue Projets HATS, mais dans la vue Navigateur.

Pour procéder à une configuration plus poussée de votre fonction d'application client enrichi HATS, vous pouvez utiliser, à la place de l'assistant de création d'un projet de fonction HATS, l'assistant Nouvelle fonction d'Eclipse standard fourni par Eclipse. Pour lancer cet assistant, dans la barre d'outils Rational SDP, sélectionnez Fichier > Nouveau > Autre > Développement de plug-in > Projet de dispositif. Cet assistant effectue à peu près les mêmes opérations que l'assistant de création d'un projet de fonction HATS mais il n'inclut pas automatiquement le module d'extension d'exécution ni les dépendances requises par rapport aux fonctions de la phase d'exécution de HATS.

Exportation des fonctions d'exécution de HATS

Dans un environnement de production, une fonction d'application client enrichi HATS dépend des fonctions de phase d'exécution HATS installées sur le client. Lorsque vous créez une fonction d'application client enrichi HATS à l'aide de l'assistant de création d'un projet de fonction HATS, ce dernier inclut automatiquement une dépendance vers les fonctions d'exécution HATS. Cette dépendance permet d'obtenir que la procédure d'installation et de mise à jour de la fonction déroule automatiquement les fonctions de la phase d'exécution de HATS à partir du site de mise à jour lorsqu'une fonction client enrichi HATS est installée ou mise à jour. Les fonctions de la phase d'exécution de HATS comprennent les fonctions et modules d'extension suivants :

Lorsque la plateforme cible indiquée est Lotus Notes, ajoutez également la fonction Eclipse suivante :

Pour exporter les fonctions de la phase d'exécution de HATS, procédez comme suit :

  1. Dans la vue Projets HATS, cliquez avec le bouton droit sur votre projet client enrichi HATS, puis sélectionnez Exporter > Exporter les fonctions de phase d'exécution HATS dans le menu contextuel. Vous lancez ainsi l'assistant d'exportation des fonctions de phase d'exécution HATS. L'assistant peut également être lancé à partir de la barre de menus de Rational SDP en sélectionnant Fichier > Exportation > HATS > Fonctions de phase d'exécution de HATS.
  2. Dans le panneau Exporter les fonctions de phase d'exécution HATS, pour Deploy as, sélectionnez Directory et cliquez sur Parcourir pour localiser et sélectionner votre répertoire d'exportation, par exemple, c:\myHATS.
    Remarque :
    L'assistant d'exportation des fonctions de phase d'exécution HATS vous permet de définir soit un fichier d'archive soit un répertoire du système de fichiers local pour la sauvegarde des fonctions de phase d'exécution de HATS. Si vous choisissez d'exporter vers un fichier archive, toutes les fonctions et tous les modules d'extension sont regroupés dans un fichier archive .zip unique. La structure de répertoires principale à l'intérieur du fichier archive .zip commence par deux sous-répertoires, l'un nommé features, l'autre, plugins. Si vous choisissez d'exporter vers un répertoire, les fonctions et modules d'extension sont exportés vers le répertoire sélectionné. Les fonctions sont placées dans un sous-répertoire nommé features, tandis que les modules d'extension sont placés dans un sous-répertoire appelé plugins. Sélectionnez Répertoire si vous prévoyez de télécharger les archives vers un répertoire de site de mise à jour sur un serveur Web.
  3. Cliquez sur Fin.

Création d'un site de mise à jour

Après avoir exporté vos fonctions d'application HATS et les fonctions de la phase d'exécution de HATS, vous devez créer un site de mise à jour utilisable par la procédure d'installation et de mise à jour des fonctions pour déployer votre application. Pour créer un site de mise à jour, procédez comme suit :

  1. Dans la vue Projets HATS, cliquez avec le bouton droit sur votre projet client enrichi HATS, puis sélectionnez Nouveau HATS > Mettre à jour le projet de site dans le menu contextuel. L'assistant New Update Site apparaît. Vous pouvez aussi lancer l'assistant à partir de la barre de menus Rational SDP en sélectionnant Fichier > Nouveau > Autre > Plug-in Development > Update Site Project > Suivant.
  2. Dans le panneau Update Site Project :
    1. Attribuez un nom au projet, par exemple myHATUpdateSite.
    2. Désélectionnez la case Utilisation de l'emplacement par défaut et cliquez sur Parcourir pour localiser et sélectionner le répertoire dans lequel vous avez exporté la fonction d'application HATS et les fonctions de la phase d'exécution de HATS, par exemple, c:\myHATS.
    3. Cliquez sur Fin.
  3. Dans la vue de l'éditeur site.xml sur l'onglet Site Map, cliquez sur New Category.
  4. Dans la section Category Properties :
    1. Entrez un nom, HATS par exemple.
    2. Entrez un libellé, HATS par exemple.
    3. Entrez une description (facultatif).
    4. Cliquez sur l'icône Enregistrer dans la barre d'outils de Rational SDP.
  5. Dans la vue de l'éditeur site.xml sur l'onglet Site Map, cliquez sur Add Feature.
  6. Dans le panneau de sélection des fonctions, faites défiler la liste et sélectionnez votre fonction d'application HATS, par exemple hostaccess (nnnn), où nnnn représente le numéro de version de la fonction, puis cliquez sur OK. Pour plus d'informations sur les numéros de version, voir Mise à jour des numéros de version des fonctions et modules d'extension.
    Remarque :
    Si vous commencez à saisir le nom d'une fonction dans la zone de sélection, les données entrées agissent en tant que caractères génériques et la liste des fonctions dans la zone de liste se réduit jusqu'à ce que la fonction souhaitée apparaisse.
  7. Cliquez sur Add Feature pour ajouter chacune des fonctions de la phase d'exécution de HATS :

    Lorsque la plateforme cible indiquée est Lotus Notes, ajoutez également la fonction suivante :

  8. Cliquez sur Build All pour terminer la construction du fichier du site de mise à jour site.xml.
    Remarque :
    Si le message d'erreur suivant s'affiche : erreurs de compilation sont survenues pendant la construction s'affiche. Les journaux se trouvent dans le fichier 'logs.zip' à la racine du projet de site., vérifiez le contenu du fichier logs.zip. S'il ne contient que des avertissements, vous pouvez les ignorer en toute sécurité, puis continuer.

Vous venez de créer un site de mise à jour, c:\myHATS dans cet exemple, comprenant le fichier site.xml indiquant les fonctions et versions de ces fonctions qui pourront être téléchargées à partir de ce site par un client. Vous pouvez maintenant déplacer le répertoire de ce site de mise à jour vers un serveur Web auquel les clients pourront accéder. Pour obtenir les instructions de définition d'un site de mise à jour sur le système client et d'installation des applications client enrichi HATS dans un environnement d'exécution, voir Installation de l'application dans un environnement d'exécution.

Remarque :
Après avoir installé une mise à jour de service HATS, vous devez réexporter et redéployer les fonctions de la phase d'exécution de HATS afin de prendre les modifications en compte. Vous devez modifier le fichier site.xml du site de mise à jour afin de refléter les changements de numéro de version. Les versions sont répertoriées sur le premier panneau de l'assistant Exporter les fonctions de la phase d'exécution de HATS. Pour plus d'informations, voir Mise à jour des numéros de version des fonctions et modules d'extension.

Installation de l'application dans un environnement d'exécution

Vous pouvez exécuter les applications client enrichi HATS dans les environnements Eclipse RCP, Lotus Notes et Lotus Expeditor Client. Les sections ci-après présentent les procédures d'installation d'une applications client enrichi HATS dans chacun de ces environnements.

Plateforme client enrichi Eclipse

Pour télécharger et installer votre application client enrichi HATS dans un environnement client enrichi Eclipse, l'environnement client doit contenir la fonction Eclipse EMF Service Data Objects (SDO) et doit être configuré de sorte à accéder au site de mise à jour qui contient l'application. Par défaut, étant donné que l'installation et la mise à jour automatiques sont désactivées, l'utilisateur ou l'administrateur doit installer manuellement les nouvelles fonctions ou mises à jour à l'aide des fonctions standard Eclipse Software Update. Pour ce faire, exécutez les étapes suivantes sur le système client.

Remarque :
Les procédures ci-dessous s'appliquent à Eclipse version 3.4 ou supérieure. Si vous utilisez une version antérieure d'Eclipse, consultez la documentation Eclipse appropriée pour connaître les procédures d'installation des fonctions à l'aide du gestionnaire de mises à jour.
  1. Dans la barre de menus du client Eclipse, sélectionnez Aide > Mises à jour des logiciels. Sélectionnez ensuite l'onglet Logiciels disponibles.
    Remarque :
    Selon la configuration du client Eclipse, cette option peut apparaître dans un menu différent.
  2. Cliquez sur le bouton Ajouter un site, puis sur le bouton Local.
  3. Naviguez jusqu'à l'emplacement du site de mise à jour que vous avez créé pour le projet HATS, puis cliquez sur OK.
  4. Sélectionnez votre site de mise à jour HATS, puis cliquez sur Installer.
  5. Examinez et confirmez les éléments à installer. Cliquez sur Suivant.
  6. Sélectionnez J'accepte les termes du contrat de licence, puis cliquez sur Terminer.
  7. Votre application HATS est installée.
  8. Lorsque vous êtes invité à redémarrer le plan de travail, cliquez sur Oui.
  9. Vous pouvez ensuite exécuter votre application, en commençant par ouvrir la perspective Host Access (Fenêtre->Ouvrir la perspective-> Host Access). Votre application HATS figure dans la liste de la vue Applications. Pour lancer votre application, cliquez deux fois sur son nom ou cliquez avec le bouton droit et sélectionnez Ouvrir.

Pour plus d'informations sur l'environnement Eclipse RCP, voir http://www.eclipse.org/home/categories/rcp.php.

Lotus Notes

Dans l'environnement Lotus Notes, les applications fournies en tant que fonctions et modules d'extension sont installées à l'aide d'un objet fenêtre. Par la suite, celui-ci peut être publié dans un catalogue d'objets fenêtre et mis ainsi à la disposition des autres utilisateurs. Pour plus d'informations sur les objets fenêtre, voir la section Widgets and Live Text dans le centre de documentation Lotus Notes à l'adresse http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp?topic=/com.ibm.notes85.help.doc/wid_app_overview_c.html .

Pour installer une application client enrichi HATS dans un environnement Lotus Notes, procédez comme suit au niveau du système client :

  1. Lancez le client Lotus Notes et sélectionnez Fichier > Préférences > Objets fenêtre.
  2. Sélectionnez Show Widget Toolbar and the My Widgets Sidebar panel. Cliquez sur OK.
  3. La barre d'outils d'objets fenêtre se présente comme suit :
    Figure 9. Barre d'outils d'objets fenêtre dans Lotus Notes
    Barre d'outils d'objets fenêtre dans Lotus Notes
  4. Le panneau de barre de navigation My Widgets se présente comme suit :
    Figure 10. Panneau de barre de navigation My Widgets
    Panneau de barre de navigation My Widgets
  5. Dans la barre d'outils d'objets fenêtre, sélectionnez Getting Started with Widgets.
  6. Sélectionnez Features and Plugins, puis Next.
  7. Dans la zone Enter the URL, entrez le chemin d'accès au fichier site.xml du site de mise à jour, au format suivant (le chemin doit commencer par file:///) : file:///c:\sitedemiseàjourhats\site.xml. Cliquez sur le bouton Load.
  8. Sous Features to Install, sélectionnez toutes les fonctions et cliquez surNext.
  9. Facultatif : Dans la zone Widget name, vous pouvez indiquer nom approprié pour votre objet fenêtre, par exemple Objet fenêtre pour l'application des accès HATS.
  10. Facultatif : Pour associer une image à l'objet fenêtre, copiez l'image souhaitée vers le dossier du site de mise à jour. Puis, dans la zone
  11. Lorsque vous êtes invité à installer le module d'extension, cliquez sur Oui.

    Le panneau de barre de navigation My Widgets se présentera comme suit :

    Figure 11. Panneau de barre de navigation My Widgets et exemple d'objet fenêtre pour l'application des accès HATS
    Panneau de barre de navigation My Widgets et exemple d'objet fenêtre pour l'application des accès HATS
  12. Redémarrez Lotus Notes lorsque vous y êtes invité.

Vous pouvez exécuter votre application en sélectionnant Ouvrir > Host Access. Votre application HATS est répertoriée dans la vue Applications. Pour lancer votre application, cliquez deux fois sur son nom ou cliquez avec le bouton droit et sélectionnez Ouvrir.

Pour désinstaller l'application HATS, cliquez avec le bouton droit sur votre objet fenêtre (par exemple, Objet fenêtre pour l'application des accès HATS) et sélectionnez Supprimer. Redémarrez Lotus Notes lorsque vous y êtes invité.

Lotus Expeditor Client

Dans l'environnement Lotus Expeditor Client, la gestion et le déploiement de l'application peuvent être contrôlés par plusieurs éléments :

Pour Lotus Expeditor Client, les fonctions suivantes doivent être ajoutées à l'installation par défaut :

Dans Lotus Expeditor Client, sélectionnez Fichier > Application > Installer > Rechercher des nouvelles fonctions à installer > Ajouter un emplacement de dossier. Naviguez jusqu'au dossier suivant dans les fichiers du produit Lotus Expeditor Client : desktop\updates\platform, puis sélectionnez Terminer. Développez updates/platform et Development. Cochez Lotus Expeditor Desktop Development Utilities. Développez aussi Runtime Components, puis cochez Service Data Objects (SDO) Components. Cliquez ensuite sur Suivant pour continuer dans l'assistant.

Dans Lotus Expeditor Client version 6.2.0 ou suivante, pour installer la fonction Core JVM - J2SE, dans Lotus Expeditor Client sélectionnez Fichier > Application > Installer > Rechercher des nouvelles fonctions à installer > Ajouter un emplacement de dossier. Naviguez jusqu'à l'emplacement du site Desktop Runtime Environment, à savoir le répertoire update.site.dre.client, puis sélectionnez OK. Acceptez le nom de site par défaut, puis sélectionnez OK et Terminer. Développez le site et Composants d'exécution. Cochez Core JVM Feature - J2SE. Sélectionnez Suivant, puis fermez l'assistant.

Pour plus d'informations, reportez-vous à la section Assembling and Deploying Lotus Expeditor Applications dans le centre de documentation Lotus Expeditor, à l'adresse http://publib.boulder.ibm.com/infocenter/ledoc/v6r1/index.jsp.

Pour installer une application client enrichi HATS dans un environnement Lotus Expeditor Client, vous devez configurer le client de telle sorte qu'il puisse accéder au site de mise à jour contenant l'application. Pour ce faire, exécutez les étapes suivantes sur le système client.

  1. Dans le menu principal de Lotus Expeditor Client, sélectionnez File > Application > Install.
  2. Dans le panneau Mises à jour des dispositifs, sélectionnez Rechercher les nouveaux dispositifs à installer et cliquez sur Suivant.
  3. Dans le panneau Application Locations, cliquez sur Add Remote Location ou Add Folder Location, selon le cas.
  4. Dans le panneau Application Locations, sélectionnez votre site de mise à jour HATS et cliquez sur Finish.
  5. Dans le panneau Résultats de la recherche, sélectionnez les fonctions à installer et cliquez sur Suivant.
  6. Dans le panneau Feature License, sélectionnez J'accepte les termes du contrat de licence et cliquez sur Suivant.
  7. Dans le panneau Installation, cliquez sur Terminer.
  8. Votre application HATS est installée.
  9. Lorsque vous êtes invité à redémarrer le plan de travail, cliquez sur Oui.
  10. Vous pouvez ensuite exécuter votre application en commençant par ouvrir Host Access (Ouvrir->Host Access). Votre application HATS figure dans la liste de la vue Applications. Pour lancer votre application, cliquez deux fois sur son nom ou cliquez avec le bouton droit et sélectionnez Ouvrir.
Procédure de mise à jour automatique

L'environnement de client enrichi permet une mise à jour automatique des applications installées. Des préférences vous permettent de contrôler la fréquence à laquelle le serveur recherche les mises à jour. Une fois que vous avez téléchargé une mise à jour d'une application, le client enrichi télécharge et installe cette mise à jour. Un contrôle de version est effectué pour s'assurer que seules les nouvelles mises à jour sont téléchargées et installées. Dans la plupart des cas, l'utilisateur doit redémarrer l'environnement pour activer l'application mise à jour. Pour plus d'informations, voir la documentation Eclipse RCP, Lotus Notes ou Lotus Expeditor, selon le cas.

Mise à jour des numéros de version des fonctions et modules d'extension

Avant de mettre à jour un module d'extension déjà installé, vous devez mettre à jour sa version car c'est à partir de cette dernière qu'Eclipse détermine si un module d'extension a été modifié. Par exemple, si vous ajoutez une personnalisation d'écran ou modifiez une macro dans votre projet, vous devez mettre à jour le numéro de version du module d'extension avant de le réexporter.

Pour mettre à jour la version de votre module d'extension, dans l'éditeur paramètres de votre projet, dans l'onglet Présentation, cliquez sur le lien d'ouverture du manifeste du module d'extension. Dans l'onglet Présentation, sous Informations générales, mettez à jour la version. Une version Eclipse se présente sous la forme majeure.mineure.service. Lorsque vous apportez une modification mineure au projet, mettez à jour le segment service de la version. par exemple, avant d'exporter pour la deuxième fois votre module d'extension, définissez son numéro de version sur 1.0.1.

Comme l'assistant des paramètres de licence met à jour le projet d'extension d'exécution, (com.ibm.hats.rcp.runtime.extension), vous devez mettre à jour la version de ce module d'extension après avoir exécuté cet assistant. Pour ce faire, dans la vue Navigateur, ouvrez le fichier plugin.xml situé à la racine du projet. Dans l'onglet Présentation, sous Informations générales, mettez à jour la version.

Par ailleurs, comme les fonctions sont constituées de modules d'extension (et qu'elles possèdent également des versions), vous devez mettre à jour la version de votre fonction à chaque fois que vous mettez à jour la version de l'un des modules d'extension inclus. Pour ce faire, passez dans la vue Navigateur et ouvrez le fichier feature.xml située dans votre projet de fonction. Par défaut, le nom du projet de fonction est hostaccess. Dans l'onglet Présentation, sous Informations générales, mettez à jour la version. De plus, vérifiez également que la fonction répertorie correctement les nouvelles versions des modules d'exécution en cliquant sur le bouton Versions dans l'onglet Plug-ins et en sélectionnant Copier les versions des manifestes de plug-in et de fragment.

Une fois que la version de la fonction a été mise à jour, devez mettre à jour le fichier site.xml (le cas échéant) afin de vous assurer qu'il mentionne la nouvelle version de la fonction.

Remarque :
Ces étapes ne sont pas obligatoires lorsque vous exécutez ou déboguez votre application dans l'environnement de test local.

Administration des applications client enrichi HATS

Pour les applications client enrichi HATS, les paramètres d'exécution, tels que les paramètres de journalisation et de trace, sont indiqués dans deux fichiers dans le module d'extensionextension d'exécution (com.ibm.hats.rcp.runtime.extension) :

Pour plus d'informations sur les différents modes de test, voir Modes de test des projets client enrichi dans le Guide d'initiation HATS.

Dans HATS Toolkit, vous pouvez éditer ces fichiers afin de modifier des paramètres, tels que les paramètres de trace et de niveau de trace. Les fichiers se trouvent à la racine du projet de module d'extension d'exécution. Sachez que les modifications apportées au fichier runtime.properties dans HATS Toolkit sont conservées et appliquées lors du déploiement de l'application dans un environnement d'exécution. Dans l'environnement d'exécution, le fichier runtime.properties se trouve dans le répertoire du module d'extension d'exécution, par exemple <eclipse_install_dir>/eclipse/plugins/com.ibm.hats.rcp.runtime.extension_1.0.0. Le fichier runtime-debug.properties est ignoré dans l'environnement d'exécution. Pour plus d'informations sur les paramètres de journalisation et de trace contenus dans ces fichiers, voir Annexe A. Fichiers des propriétés d'exécution.

Pour savoir comment l'utilisateur peut configurer les paramètres de journalisation et de trace et collecter des données de résolution d'incidents dans l'environnement d'exécution, voir Préférences.

Il n'y a qu'un seul projet de module d'extension d'exécution dans l'espace de travail et qu'une seule version du module d'extension dans l'environnement d'exécution. Toutefois, dans chaque environnement d'exécution client enrichi HATS, les paramètres de journalisation et de trace sont identiques pour toutes les applications client enrichi HATS.

Les paramètres de configuration de la licence sont également stockés dans le fichier runtime.properties du module d'extension d'exécution (com.ibm.hats.rcp.runtime.extension). Le suivi des licences est effectué au niveau de l'environnement client enrichi et non au niveau de l'application client enrichi HATS individuelle. Des messages d'avertissement s'affichent dans le journal si l'utilisateur dépasse le nombre de licences achetées. Pour plus d'informations sur la spécification des paramètres de licence, voir Activation de l'exécution HATS et de la configuration de la licence dans HATS - Guide d'initiation

Environnement d'exécution

Vue Applications

La vue Applications affiche à l'intention de l'utilisateur toutes les applications client enrichi HATS actives installées dans l'environnement d'exécution. La vue est triée sur les noms d'application affichés. Par défaut, cette vue s'affiche lorsqu'un utilisateur ouvre pour la première fois la perspective Host Access. L'utilisateur démarre une nouvelle instance d'une application HATS en cliquant deux fois sur l'application dans la vue Applications ou en cliquant avec le bouton droit sur le nom de l'application, puis en sélectionnant Ouvrir.

Une fois qu'une nouvelle instance de l'application HATS a été lancée, la vue de transformation correspondante s'affiche. Pour plus d'informations, voir Vue Transformation. Par défaut, le nom de la nouvelle vue transformation ouverte est celui de l'application. Si plusieurs instances de l'application sont démarrées, le nom de la vue transformation combine le nom de l'application plus un nombre indiquant le numéro de l'instance dans la session. Par exemple, le titre de la seconde instance de l'application nommée Saisie des commande sera Saisie des commandes : 2.

Par défaut, un utilisateur est autorisé à lancer plusieurs instances de la même application. Vous pouvez modifier le fichier plugin.xml afin d'interdire le lancement de plusieurs instances. En outre, vous pouvez décider de ne pas afficher la vue Applications et de choisir à la place les vues qui seront proposées à l'utilisateur. Cette procédure permet également de limiter le nombre d'instances d'une application. Pour plus d'informations, voir HATS Rich Client Platform Programmer's Guide.

Si l'application est exécutée dans l'environnement de test local et que vous avez choisi de voir le terminal d'affichage, une fenêtre de terminal d'affichage sera également affichée une fois la connexion établie avec le système. La fenêtre sera refermée à la fin de la session ou si le client est arrêté.

Menu contextuel

Un menu contextuel est fourni pour permettre à l'utilisateur d'exécuter des actions sur une ou plusieurs applications de la vue. Sélectionnez un ou plusieurs noms d'application, puis cliquez avec le bouton droit de la souris pour afficher le menu. Les options suivantes sont disponibles :

Ouvrir
Cette option démarre une nouvelle instance de l'application sélectionnée. Si plusieurs applications sont sélectionnées, une instance de chaque application est ouverte.
Afficher les travaux d'impression
Cette option de menu n'est activée que si au moins une application autorisant l'impression est sélectionnée. Cette option ouvre la vue Travaux d'impression (3270) ou Travaux d'impression (5250), qui affiche la liste des travaux d'impression en file d'attente. Pour plus d'informations, voir Activation du support d'impression.
Propriétés
Cette option de menu n'est activée que si une application au moins est sélectionnée. Cette option permet à l'utilisateur de consulter des informations sur l'application et de configurer des paramètres relatifs à cette application. La boîte de dialogue Propriétés propose les pages suivantes pour l'application sélectionnée :
Info
La page Info affiche des informations sur l'application sélectionnée, notamment son nom, l'ID, la version, et l'emplacement physique du module d'extension. La page mentionne également la version du module d'extension d'exécution HATS utilisé par l'application. Ces informations sont utiles lorsqu'un utilisateur doit communiquer des informations relatives à son environnement à une équipe de support. L'utilisateur ne peut pas modifier les valeurs de cette page. Elles sont fournies pour information uniquement.
Paramètres de connexion
Cette option n'apparaît pas dans la liste si vous avez choisi d'interdire à l'utilisateur de modifier les paramètres de connexion, ce qui est la valeur par défaut. Pour plus d'informations, voir Remplacement de paramètres de connexion.

Si vous autorisez les modifications, cette page permet à l'utilisateur de modifier les paramètres de connexion. Cette fonction est équivalente à celle de la fonction HATS pour les applications Web, qui permet à un utilisateur de modifier les paramètres de connexion au moyen de l'URL lorsque l'utilisateur accède pour la première fois à l'application. l'utilisateur peut par exemple être amené à modifier les paramètres de connexion s'il doit modifier le nom de LU ou l'ID d'un poste de travail.

Pour procéder à la modification, l'utilisateur doit cliquer sur le bouton Ajouter, sélectionner un paramètre dans la liste déroulante pour la zone Nom et spécifier une valeur dans la zone Valeur. Aucune validation n'est effectuée dans la boîte de dialogue pour indiquer à l'utilisateur si le nom du paramètre de connexion fourni peut être modifié. Par défaut, le paramètre peut être modifié lorsqu'il est ajouté à l'origine. Cette possibilité peut être désactivée en désélectionnant la case en regard du nom du paramètre.

Si un utilisateur modifie un paramètre de connexion, les paramètres sont enregistrés dans l'espace de travail local. Les valeurs de paramètre remplacées sont utilisées lorsqu'une instance de la session est démarrée.

Pour obtenir des informations sur le lancement par programme d'une instance d'application client enrichi par le biais de remplacement de paramètres de connexion, voir HATS Rich Client Platform Programmer's Guide.

Variables
Cette option n'apparaît pas dans la liste si vous avez choisi d'interdire à l'utilisateur de modifier les variables globales, ce qui est la valeur par défaut. Pour plus d'informations, voir Remplacement de variables globales.

Si vous autorisez les modifications, cette page permet à l'utilisateur de modifier les variables globales. Cette fonction est équivalente à celle de la fonction HATS pour les applications Web, qui permet à un utilisateur de modifier les variables globales au moyen de l'URL lorsque l'utilisateur accède pour la première fois à l'application.

Cette possibilité permet d'utiliser dans l'application des données variables spécifiques à l'utilisateur. Par exemple, vous pouvez enregistrer une macro invitant l'utilisateur à fournir un nom et un mot de passe parmi les valeurs de variables globales. L'utilisateur peut fournir ces valeurs dans la page de modification des variables. Ces valeurs sont alors utilisées lorsque la macro est exécutée lorsque l'écran de connexion est reconnu.

Pour procéder à un remplacement, l'utilisateur doit cliquer sur le bouton Ajouter, sélectionner un nom de variable dans la liste déroulante pour la zone Nom, spécifier une valeur dans la zone Valeur et indiquer si la variable globale est partagée. Aucune validation n'est effectuée dans la boîte de dialogue pour indiquer à l'utilisateur si le nom de variable globale fourni peut être modifié. Par défaut, le paramètre peut être modifié lorsqu'il est ajouté à l'origine. Cette possibilité peut être désactivée en désélectionnant la case en regard du nom de la variable.

Lorsque l'utilisateur remplace une variable globale, les paramètres sont enregistrés dans le répertoire de données de l'environnement. Les valeurs des variables globales modifiées sont utilisées lorsqu'une instance de session est lancée.

Pour obtenir des informations sur le lancement par programme d'une instance d'application client enrichi par le biais de remplacements de variable globale, voir le manuel HATS Rich Client Platform Programmer's Guide.

Support de l'impression d'écran

Dans l'environnement client enrichi, l'utilisateur a la possibilité d'imprimer la transformation d'écran en cours en sélectionnantImprimer dans le menu Fichier. Par défaut, Eclipse affiche la boîte de dialogue d'impression qui permet à l'utilisateur de sélectionner l'imprimante et de configurer certaines options. Lorsque l'utilisateur clique sur OK, la zone de transformation de la vue transformation est envoyée à l'imprimante sélectionnée.

Remarque :
Sur les systèmes Windows, la transformation est imprimée en totalité, y compris les portions qui ne sont visibles qu'à l'aide de la barre de défilement. Sur les systèmes Linux®, seule la partie visible de la transformation est imprimée, mais pas les portions qui n'apparaissent que lorsque la barre de défilement est utilisée.

Vue Transformation

La vue transformation est la principale zone de transformation dans l'environnement client enrichi. Chaque projet de client enrichi HATS est associé à une vue transformation. La vue est enregistrée dans le fichier plugin.xml du projet au moment de la création du projet. Elle est composée de quatre zones :

Barre d'outils

La barre d'outils de la vue transformation contient les boutons correspondant aux actions applicables au niveau de l'application, ainsi que les boutons fournis par l'objet fenêtre Barre d'outils lors du rendu d'écran. Par défaut, la barre d'outils est affichée et les légendes des boutons ne comportent que du texte. Vous pouvez modifier ces paramètres dans les paramètres du projet. Pour plus d'informations, voir Barre d'outils  plateforme client enrichi uniquement .

La barre d'outils est divisée en deux sections. La partie droite de la barre d'outils correspond au bloc de touches application dans une application Web HATS et contient les boutons du bloc de touches application. Pour savoir comment configurer l'affichage des boutons, voir Bloc de touches application. La partie gauche affiche les boutons fournis par l'objet fenêtre Barre d'outils. Pour plus d'informations, voir Barre d'outils  plateforme client enrichi uniquement .

Une info-bulle fournissant une description de la fonction du bouton est disponible pour tous les boutons du bloc de touches application. Vous pouvez définir le texte de l'info-bulle pour les boutons que vous ajoutez à l'aide de l'objet fenêtre Barre d'outils.

Au-dessus des boutons du bloc de touches application dans la barre d'outils, à côté des icônes de réduction et d'agrandissement, se trouve une icône Menu. Cliquez sur cette icône pour afficher un menu proposant les options suivantes :

Basculer le support clavier
Cette option permet à l'utilisateur d'activer ou de désactiver le support clavier.
Caractéristiques de la connexion
Affiche les caractéristiques de la connexion hôte pour cette application.
Propriétés
Affiche les propriétés de cette application.

Zone de modèle et de transformation

La zone de modèle et de transformation est la partie principale de la vue transformation, dans laquelle s'affichent toutes les transformations d'écran. C'est également là que s'affichent les messages d'erreur, les messages de déconnexion, ainsi que les panneaux du gestionnaire de macro.

Menu contextuel
Un menu contextuel peut s'afficher dans la zone de transformation pour fournir à l'utilisateur des informations relatives à l'application en cours. Les options de menu suivantes sont disponibles :
Propriétés
Affiche la boîte de dialogue des propriétés relative à l'application en cours. Pour plus d'informations, voir Menu contextuel.
Panneaux d'état de la phase d'exécution
Comme pour les applications Web HATS, un panneau s'affiche à l'intention de l'utilisateur si l'application client enrichi HATS est arrêtée, déconnectée, présente une erreur ou est occupée.

Bloc de touches hôte

Le bloc de touches hôte affiche les touches hôte que vous choisissez d'afficher dans les paramètres du projet. Pour savoir comment configurer le bloc de touches hôte, voir Bloc de touches hôte. Par défaut, le bloc de touches hôte n'est pas affiché.

Zone d'informations opérateur

La zone d'informations opérateur affiche des informations relatives à l'état de la session que vous configurez dans les paramètres du projet. Pour savoir comment configurer la zone d'informations opérateur, voir Zone d'informations opérateur.

Fermeture de la vue

La connexion avec le système hôte est interrompue lorsque la vue est fermée. Cette situation se produit lorsque l'utilisateur ferme explicitement la vue ou l'environnement client enrichi. A la fermeture, les actions configurées en tant qu'événements de déconnexion et d'arrêt sont exécutées.

Remarque :
Si l'utilisateur tente de fermer la vue alors que le traitement d'une requête est encore en cours dans HATS, par exemple si l'utilisateur clique sur un bouton déclenchant une macro, un message indique que la session est occupée. Si l'utilisateur continue, la session est arrêtée et les actions définies dans les événements de déconnexion et d'arrêt risquent de ne pas être exécutées.

Invite d'entrée de l'ID du poste de travail

Après avoir créé ou modifié une connexion hôte, vous pouvez spécifier que l'utilisateur doit être invité à entrer un ID de poste de travail pour la connexion à un hôte 5250. Pour plus d'informations, voir Création d'une connexion. Si vous configurez une invite d'entrée de l'ID du poste de travail, une boîte de dialogue invite l'utilisateur à saisir cet ID lorsqu'il établit la connexion avec l'hôte pour la première fois. L'utilisateur peut alors saisir l'ID du poste de travail dans la zone ID poste de travail.

Une case à cocher permet de demander la mémorisation de l'ID du poste de travail pour éviter de le saisir à nouveau par la suite. Si cette case est cochée, il est possible de restaurer ultérieurement l'affichage de la boîte de dialogue d'invite en désactivant la modification du paramètre de connexion workstationID dans les propriétés de l'application. Pour plus d'informations, voir Paramètres de connexion.

Invite d'entrée du nom de LU

Après avoir créé ou modifié une connexion hôte, vous pouvez spécifier que l'utilisateur doit être invité à entrer un nom de LU pour la connexion à un hôte 3270E. Pour plus d'informations, voir Création d'une connexion. Si vous configurez une invite d'entrée du nom de LU, une boîte de dialogue invite l'utilisateur à saisir ce nom lorsqu'il établit la connexion avec l'hôte pour la première fois. L'utilisateur doit alors indiquer le nom de LU dans la zone Nom de LU.

Une case à cocher permet de demander la mémorisation du nom de LU pour éviter de le saisir à nouveau par la suite. Si cette case est cochée, il est possible de restaurer ultérieurement l'affichage de la boîte de dialogue d'invite en désactivant la modification du paramètre de connexion LUName dans les propriétés de l'application. Pour plus d'informations, voir Paramètres de connexion.

Préférences

Par défaut, les utilisateurs peuvent accéder aux préférences en sélectionnant Fichier > Préférences > Host Access dans la barre de menus de la plateforme d'exécution. Les pages affichées sont enregistrées dans le module d'extension d'exécution. Si vous ne voulez pas offrir ces fonctions à l'utilisateur, vous pouvez supprimer les déclarations applicables du fichier plugin.xml du module d'extension d'exécution. Pour plus d'informations sur cette procédure, voir la description de l'ID du point d'extension org.eclipse.ui.preferencePages dans la section Module d'extension d'exécution HATS du manuel HATS Rich Client Platform Programmer's Guide. Les paramètres de préférences suivants peuvent être sélectionnés :

Préférences d'impression

Les préférences d'impression suivantes peuvent être définies par l'utilisateur pour les applications prenant en charge l'impression 3270 :

Actions du travail d'impression par défaut
On start
Les préférences suivantes peuvent être définies au lancement d'un travail d'impression :
  • Activer la vue des travaux d'impression
  • Afficher un message

    Un message indique à l'utilisateur que le travail d'impression a démarré.

  • Aucun
On complete
Les préférences suivantes peuvent être définies à la fin d'un travail d'impression :
  • Activer la vue des travaux d'impression
  • Afficher un message

    Le message, le travail d'impression {0} est terminé., s'affiche. {0} correspond au nom du travail d'impression.

  • Ouvrir
  • Aucun
On error
Les préférences suivantes peuvent être définies en cas d'échec d'un travail d'impression :
  • Activer la vue des travaux d'impression
  • Afficher un message

    Le message, Le travail d'impression {0} a rencontré une erreur, s'affiche. {0} correspond au nom du travail d'impression.

  • Supprimer
  • Aucun
Suppression des travaux d'impression en quittant
Lorsque cette option est sélectionnée, les travaux d'impression sont automatiquement supprimés lorsque l'environnement est fermé. Cette option peut être utile pour les utilisateurs qui partagent un poste de travail avec d'autres utilisateurs.

>Préférences d'identification des incidents

Les préférences de résolution d'incidents ci-dessous peuvent être définies par l'utilisateur. Pour plus d'informations sur les paramètres de journalisation et de trace, voir Administration des applications client enrichi HATS.

Paramètres de la trace
Les traces d'exécution HATS suivantes peuvent être activées par l'utilisateur :
Activer la fonction de trace de l'exécution
Permet d'activer la fonction de trace pour les connexions de l'application.
Activer la fonction de trace de l'objet fenêtre
Permet d'activer la fonction de trace pour les objets fenêtre de l'application.
Activer la fonction de trace de l'action
Permet d'activer des actions d'événement dans l'application.
Activer la fonction de trace HOD
Permet d'activer la fonction de trace Host On-Demand dans votre application.
Activer la fonction de trace du composant
Permet d'activer la fonction de trace pour les composants de l'application.
Activer la fonction de trace de l'utilitaire
Permet d'activer la fonction de trace pour les utilitaires d'exécution de l'application.
Activer la fonction de trace de macro
Effectue une trace lors de l'exécution des macros. En raison des effets de cette fonction sur les performances du système, activez-la uniquement pour déboguer les macros.
Afficher la fenêtre du terminal d'affichage
Sélectionnez cette case pour afficher une vue de l'application hôte sur le terminal d'affichage lorsque l'application HATS est en cours d'exécution.
Activer l'enregistrement de la simulation hôte
Cochez cette case pour activer l'enregistrement de la simulation hôte lors de l'exécution. L'enregistrement débute au prochain démarrage de l'application client enrichi et se termine à la fermeture de la session hôte, par exemple, lorsque l'utilisateur clique sur le bouton de déconnexion dans la barre d'outils de la vue transformation.

Le fichier de trace est enregistré dans le dossier des simulations hôte dans l'environnement client enrichi. Par exemple, dans l'environnement plateforme client enrichi sous Windows, il est enregistré dans le <répertoire d'installation d'Eclipse>\plugins\<version_NomApplication>\profiles\hostsimulations\. Dans l'environnement Lotus Notes sous Windows, il est enregistré dans <répertoire d'installation Lotus Notes >\Data\workspace\applications\eclipse\plugins\<NomApplication_version>\profiles\hostsimulations\. Dans l'environnement Lotus Expeditor Client sous Windows, il est enregistré dans <répertoire d'installation Lotus Expeditor Client>\shared\eclipse\plugins\<NomApplication_version>\profiles\hostsimulations\. Dans l'environnement Lotus Expeditor Client sous Linux, il est enregistré dans /opt/IBM/Lotus/Expeditor/shared/eclipse/plugins/<ApplicationName_version>/profiles/hostsimulations/.

Les noms des fichiers de trace suivent le modèle suivant : NomApplication_NomConnexion_Date(aaaammjj)_Heure(hhmmss)_Numéro, par exemple, MonApplication_principal_20060101_134543_1.

Onglet Sortie de trace
Nom de fichier
Nom utilisé comme modèle pour la génération de jeux de fichiers de trace uniques pour chaque environnement d'exécution. La valeur par défaut est trace.txt.
Taille de fichier maximale
Indique la taille de fichier maximale en Ko. La valeur par défaut est 10240.
Nombre maximal de fichiers
Indique le nombre maximal de fichiers de trace. La valeur par défaut est 5.
Bouton de visualisation
Cliquez sur ce bouton pour provoquer l'ouverture des fichiers de trace dans l'éditeur système par défaut. Tous les fichiers de trace correspondant au nom de fichier modèle indiqué sont combinés en un seul fichier qui est alors ouvert. Par exemple, si trace.txt est le nom de fichier modèle, et que les fichiers trace1.txt, trace2.txt et trace3.txt existent, ils sont combinés en un seul fichier, dans l'ordre approprié, puis le fichier est ouvert. Si aucun éditeur par défaut n'est configuré, un message d'erreur s'affiche.
Bouton d'effacement
Cliquez sur ce bouton pour que le système vous invite à effacer le fichier de trace en cours.
Onglet Sortie des messages
Nom de fichier
Nom utilisé comme modèle pour la génération de jeux de fichiers journaux uniques pour chaque environnement d'exécution. La valeur par défaut est messages.txt.
Taille de fichier maximale
Indique la taille de fichier maximale en Ko. La valeur par défaut est 512.
Nombre maximal de fichiers
Indique le nombre maximal de fichiers de trace. La valeur par défaut est 2.
Bouton de visualisation
Cliquez sur ce bouton pour provoquer l'ouverture du fichier journal en cours dans l'éditeur système par défaut. Tous les fichiers journaux correspondant au nom de fichier modèle indiqué sont combinés en un seul fichier qui est alors ouvert. Par exemple, si messages.txt est le nom de fichier modèle, et que les fichiers messages1.txt, messages2.txt et messages3.txt existent, ils sont combinés en un seul fichier, dans l'ordre approprié, puis le fichier est ouvert. Si aucun éditeur par défaut n'est configuré, un message d'erreur s'affiche.
Bouton d'effacement
Cliquez sur ce bouton pour que le système vous invite à effacer le fichier journal en cours.
Onglet Sortie de simulation
Nombre maximal de fichiers
Lorsque la case Activer l'enregistrement de la simulation hôte est cochée, cette zone indique le nombre maximal de fichiers de sortie de simulation. La valeur par défaut est 10. Si un nouveau fichier de simulation excède le nombre de fichiers autorisé, le fichier de simulation le plus ancien est supprimé.
Bouton de regroupement
Cliquez sur ce bouton pour regrouper tous les artefacts requis par le support IBM® pour diagnostiquer un incident. Dans l'assistant Regrouper des informations relatives à l'identification des incidents, cochez la case correspondant à l'application pour laquelle vous souhaitez collecter des informations et indiquez le fichier .zip de destination. Les informations suivantes sont collectées et regroupées dans le fichier .zip de destination :
Bouton Restaurer les valeurs par défaut
Cliquez sur ce bouton pour redonner leurs valeurs par défaut à tous les paramètres du panneau.
Bouton Appliquer
Cliquez sur ce bouton pour enregistrer les paramètres du fichier runtime.properties dans le module d'extension d'exécution.

Remarques et restrictions concernant le client enrichi HATS

Lorsque vous utilisez des applications client enrichi HATS, tenez compte des considérations et des restrictions suivantes :