Lorsque vous créez un projet en utilisant l'assistant HATS Création d'un projet, les paramètres que vous choisissez dans l'assistant sont enregistrés dans un fichier de projet (.hap). Vous pouvez démarrer l'éditeur de projet en cliquant deux fois sur Paramètres de projet sous le nom du projet à modifier dans la vue Projets de HATS .
Les paramètres affichés dans l'éditeur de projet sont ceux utilisés pour la totalité du projet. Pour modifier l'un de ces paramètres, utilisez les onglets disponibles dans l'éditeur. Les modifications effectuées dans l'éditeur de projet et enregistrées sont automatiquement reconnues lorsque vous exécutez votre projet dans un environnement de test en cliquant sur Régénération dans le bloc de touches application ou en affichant un nouvel écran hôte dans l'interface graphique. L'option Régénération ne prend pas en compte les modifications apportées aux fichiers de connexion (.hco). Les modifications apportées aux paramètres de connexion sont appliquées au redémarrage du serveur d'applications (ou de l'application).
Les sections suivantes décrivent chaque onglet de l'éditeur de projet et expliquent comment les utiliser pour modifier les paramètres de projet.
L'onglet Présentation de l'éditeur de projet permet d'obtenir la liste de tous les paramètres spécifiés lors de la création du projet.
La section Informations générales contient le nom du projet et sa description, le modèle et le thème choisi, ainsi que la date de la dernière modification.
Cliquez sur le lien su thème actuel pour modifier le thème du projet. Quatre options sont proposées, Standard, Application Web moderne Web uniquement ou Application d'interface utilisateur moderne plateforme client enrichi uniquement , Emulateur de terminal classique et Personnalisé. Chaque fonction de la liste des paramètres peut être activée à un autre endroit des paramètres du projet. Cette liste offre une méthode pratique pour définir les fonctions en un lieu unique, l'ensemble de ces fonctions constituant un thème définissant l'aspect et le comportement de votre application.
Le tableau suivant indique les associations entre les paramètres du thème et les paramètres individuels du projet.
| Paramètre du thème | Onglet de l'éditeur de projet | Paramètre du projet |
|---|---|---|
| Navigation à l'aide des touches fléchées plateforme client enrichi uniquement | Autre | Paramètres client > Autoriser la navigation à l'aide des touches fléchées |
| Avance de zone automatique | Autre | Paramètres client > Avance de zone automatique |
| Positionnement du curseur dans les zones protégées | Rendu | Objets fenêtre > Zone > Autorise le positionnement du curseur dans les zones protégées |
| Attributs de zone étendus | Rendu | Objets fenêtre > Zone > Activation des attributs étendus |
| Bloc de touches hôte | Rendu | Bloc de touches hôte > Affichage du bloc de touches hôte par défaut |
| Support clavier | Autre | Support clavier > Activer le support clavier |
| Zone d'informations opérateur | Rendu | Zone d'informations opérateur > Affichage de la zone d'informations opérateur |
| Mode remplacement (initial) | Autre | Paramètres client > Mode remplacement (initial) |
| Rendu avec un police monospace | Rendu | Objets fenêtre > Zone > rendu avec une police monospace (espace simple) |
Le thème Standard active les fonctions qui sont activées par défaut lorsque projet HATS est créé pour la première fois. La sélection du thème Moderne annule la sélection de toutes les fonctions individuelles. La sélection du thème Classique sélectionne toutes les fonctions. La sélection du thème Personnalisé vous permet de sélectionner n'importe quelle combinaison de fonctions.
La section Test contient les liens pouvant être utilisés pour le test de votre projet. Pour les projets Web HATS, les liens sont les suivants :
Pour les projets de portlet HATS, les liens sont :
Pour les projets HATS client enrichi, les liens sont les suivants :
La section Déploiement plateforme client enrichi uniquement inclut un menu déroulant Plateforme cible. Servez-vous de ce menu déroulant pour modifier le déploiement cible pour votre projet client enrichi. Cela vous permet de commencer à construire une application ciblée pour une plateforme et de passer à une autre plateforme ultérieurement. Les plateformes prises en charge sont la plateforme client enrichi Eclipse, Lotus Expeditor Client for Desktop et Lotus Notes.
Si vous modifiez la plateforme cible dans la liste déroulante et que celle-ci ne correspond pas à la plateforme cible de l'espace de travail, un message d'information s'affiche. Dans ce cas, suivant la nouvelle plateforme cible du projet, vous devez procéder de l'une des manières suivantes. S'il s'agit d'une plateforme Lotus Expeditor Client ou Lotus Notes, dans la barre de menus Rational SDP, sélectionnez Fenêtre > Préférences > Services client et cliquez sur le bouton Configuration. Dans la fenêtre de configuration de Lotus Expeditor Toolkit, vous pouvez sélectionner la cible dans la liste déroulante Environnement de test. S'il s'agit d'une plateforme Eclipse RCP, sélectionnez Fenêtre > Préférences > Plugin-in Development > Plateforme cible, puis sélectionnez le répertoire d'installation Rational SDP dans la liste déroulante Emplacement (par défaut, le répertoire utilisé est C:\Program Files\IBM\SDP). Lorsque vous êtes invité à recharger la plateforme cible, sélectionnez Oui.
Par ailleurs, la section Déploiement contient un lien Ouvrez le manifeste du module d'extension, qui lance l'éditeur du descripteur du module d'extension du projet (plugin.xml). Le développement de client enrichi avancé requiert des modifications de ce fichier.
Les sections Connexions, Paramètres de rendu et Other Settings récapitulent les paramètres indiqués dans chaque onglet correspondant. Les en-têtes des sections contiennent des liens vers les onglets correspondants, décrits dans les sections suivantes.
L'onglet Connexions affiche les informations relatives aux connexions associées au projet. HATS comporte deux types de connexion : la connexion par défaut (ou connexion de transformation) et la connexion d'arrière-plan. Chaque application HATS possède une connexion par défaut pour l'application hôte dont les écrans seront transformés par HATS. Les connexions d'arrière-plan sont constituées par toutes les connexions d'un projet autres que la connexion par défaut. HATS ne transforme pas les écrans provenant des connexions d'arrière-plan. Pour plus d'informations, voir Gestion des connexions.
Vous pouvez sélectionner la connexion hôte par défaut dans la boîte à liste déroulante Par défaut.
Cet onglet présente également une liste sous forme de tableau affichant toutes les connexions de projet. Cette liste affiche le nom de la connexion, l'hôte, le type d'hôte, le numéro de port et la page de codes. Vous pouvez ajouter des connexions de projet supplémentaires en cliquant sur le bouton Ajout qui lance l'assistant Création d'une connexion. HATS permet d'indiquer plusieurs connexions qui peuvent être utilisées pour un projet. Pour plus d'informations sur l'utilisation de cet assistant, voir Création d'une connexion.
Pour modifier une connexion existante, vous devez sélectionner cette connexion et cliquer sur Edition pour lancer l'éditeur de connexion. Pour plus d'informations, voir Editeur de connexion.
Le bouton Retrait permet de supprimer la connexion mise en évidence. Si vous cliquez sur Régénération, la liste est mise à jour.
L'onglet Modèle permet d'afficher le modèle utilisé pour encadrer une transformation.
Cet onglet permet de modifier le modèle utilisé comme modèle par défaut. Ce modèle sera utilisé pour tous les écrans de votre application, à moins que vous n'indiquiez un autre modèle pour un écran particulier à l'aide d'une action dans une personnalisation d'écran.
Le modèle par défaut est également le modèle appliqué à toutes les transformations du projet. Il est aussi associé à la transformation par défaut en tant qu'action par défaut à entreprendre sur un écran sans correspondance. Pour plus d'informations sur la modification des actions entreprises sur un écran sans correspondance, voir Evénements d'application.
Lors de la création ou de la modification des actions de personnalisation d'écran, vous avez la possibilité de remplacer le modèle par défaut en sélectionnant un autre modèle. L'onglet Modèle permet également d'éditer le modèle.
Vous pouvez créer vos propres modèles et les utiliser avec vos projets HATS. Pour plus d'informations, voir Assistant Création d'un modèle.
L'onglet Rendu permet d'afficher les paramètres concernant le rendu par défaut, les règles globales, le remplacement de texte, les composants, les objets fenêtre, la barre d'outils plateforme client enrichi uniquement , le bloc de touches application, le bloc de touches hôte et la zone d'informations opérateur. Cet onglet permet de configurer les valeurs par défaut au niveau du projet HATS.
Le rendu par défaut définit la transformation des écrans hôte qui n'ont pas été personnalisés individuellement. Les paramètres de rendu par défaut sélectionnés tentent de préserver la structure de l'écran hôte d'origine tout en étendant les fonctionnalités de l'application en appliquant les principes de conception d'interface graphique. Ils n'ont pas pour seul but d'afficher les zones non protégées de l'écran hôte sous forme de zones d'entrée d'interface graphique. Ils peuvent transformer les touches de fonction en boutons ou liens, les listes de sélection en boîtes à liste déroulantes et les zones présentées sous forme de tableau en tableaux.
Pour configurer un paramètre de rendu, créez une liste d'options de rendu avec classement de ces options par priorité. Chaque option de rendu définit une zone spécifique dans laquelle un composant hôte spécifique est reconnu, puis affiché en utilisant un objet fenêtre spécifique. Par exemple, vous pouvez rechercher les touches de fonction situées au bas de l'écran hôte et les transformer en liens.
Vous pouvez créer plusieurs paramètres de rendu pour la transformation par défaut. Si vous créez des paramètres de rendu supplémentaires, seul un jeu de paramètres sera employé dans la transformation par défaut. Pour créer de nouveaux paramètres, cliquez sur le bouton Ajouter pour ouvrir la fenêtre Ajouter les paramètres de rendu. Indiquez un Nom unique, ainsi qu'une Description (facultative) pour les nouveaux paramètres de rendu.
Si vous souhaitez utiliser ces paramètres pour le rendu par défaut, cochez la case Utiliser ces paramètres pour le rendu par défaut.
Vous pouvez créer des paramètres de rendu vierges (ne contenant aucune option de rendu) en cliquant sur le bouton Créer des paramètres de rendu vides ou sélectionner des paramètres à partir du menu déroulant Copier à partir de paramètres existants. Vous avez également la possibilité de modifier ou de supprimer les paramètres de rendu en cliquant respectivement sur les boutons Editer et Retirer, situés en regard de la liste.
La liste suivante répertorie les paramètres de rendu qui font partir du jeu de paramètres par défaut :
Vous pouvez ajouter une nouvelle option de rendu aux paramètres de rendu sélectionnés associés à tous les écrans du projet, ou bien modifier ou supprimer des options de rendu existantes en sélectionnant l'option à modifier ou à supprimer, puis en sélectionnant le bouton approprié à droite du tableau.
Si vous sélectionnez le bouton Ajout ou Edition, entrez un nom et une description pour l'option de rendu. Définissez ensuite la zone de l'écran dans laquelle l'option de rendu sera appliquée, puis désigner le composant hôte à utiliser pour la reconnaissance et l'objet fenêtre à utiliser pour le rendu. Vous pouvez également modifier l'ordre d'application des options de rendu. Pour cela, sélectionnez une option de la liste et cliquez sur les boutons Vers le haut ou Vers le bas pour la déplacer vers le haut ou le bas de la liste. Pour plus de détails sur les deux derniers écrans de l'assistant, voir Insertion d'un composant hôte ou Edition d'un composant hôte Web uniquement .
La liste des options de rendu constituant les paramètres de rendu est une liste ordonnée. L'ordre est important car chaque option de rendu peut utiliser une partie de l'écran hôte qui est également modifiée par une autre option figurant plus bas dans la liste. Plus l'option de rendu se trouve haut dans la liste, plus son niveau de priorité est élevé. La case à cocher située en regard de chaque option de rendu permet d'activer ou de désactiver sa sélection.
Les composants n'utilisent pas toujours la totalité de la zone que vous avez spécifiée. Supposons que vous ayez configuré le composant Liste de sélection pour qu'il recherche les listes de sélection dans la totalité de l'écran, mais qu'il n'en ait trouvé qu'une seule au milieu de cet écran. Seule la zone située au milieu de l'écran hôte sera marquée comme "utilisée". Toutes les zones "inutilisées" restantes de l'écran hôte peuvent être transformées par une autre option de rendu de priorité plus faible.
Une attention particulière doit être apportée si le composant Tableau est utilisé dans les paramètres de rend u par défaut car le composant Tableau va reconnaître quasiment chaque écran de la région sélectionnée et aucun option de priorité plus faible dans la liste ne sera reconnue.
La dernière option de rendu de la liste par défaut, Texte restant et zones d'entrée, transforme toutes les zones d'écran "non utilisées" restantes en utilisant le composant Zone et l'objet fenêtre Zone. Cette option doit être la dernière de la liste des options des paramètre de rendu.
En règle générale, les paramètres de rendu par défaut tentent de préserver la structure de l'écran hôte d'origine tout en étendant les fonctionnalités de l'application en appliquant les principes de conception de l'interface graphique. Cependant, pour permettre l'affichage du rendu par défaut des écrans hôte sur les unités mobiles, vous devez effectuer une compression. Avec la compression, le nombre d'espace et de HTML est réduit, entraînant probablement l'affichage d'une structure différente de l'écran hôte d'origine. Pour indiquer que les paramètres de rendu sélectionnés utilisent la compression, sélectionnez Utiliser le rendu compact Web uniquement .
Supposons que vous souhaitez créer une application HATS et autoriser, à partir de cette application, les utilisateurs à accéder à deux applications hôte ayant un aspect très différent l'une de l'autre. Vous souhaitez utiliser des paramètres de rendu différents pour chacune d'entre elles, mais désirez également faire appel à la puissance du rendu par défaut de HATS et avoir le moins possible de personnalisations d'écran spécifiques.
Nommez une application APPA et l'autre application APPB.
Pour modifier les paramètres de rendu avancé, développez l'arborescence de rendu par défaut et cliquez sur Avancé.
Dans cette section, vous pouvez indiquer que les paramètres de rendu doivent être utilisés si aucun élément n'est reconnu lors de la transformation d'un composant HATS. Cette fonction est particulièrement utile lorsqu'une application contient des écrans comportant des zones pouvant passer alternativement de l'état protégé à non protégé. Ainsi, si cette fonction n'est pas utilisée et qu'un composant de zone de saisie est utilisé pour reconnaître la région, aucun élément ne sera reconnu et rendu si la zone passe à l'état d'attribut protégé.
Dans cette section, vous pouvez sélectionner une option pour créer un code HTML mieux adapté dans le rendu par défaut.
Cette option n'est pas sélectionnée par défaut afin de réduire le nombre de codes HTML inclus dans le rendu par défaut. Cette réduction est nécessaire pour les applications contrôlées par la performance. Cependant, la sélection de cette option peut être requise pour d'autres applications, par exemple, les applications lecteur d'écran utilisées à des fins d'accessibilité.
Si vous souhaitez que les personnalisations que vous avez apportées au rendu par défaut apparaissent la prochaine fois que vous créerez un projet HATS, procédez comme indiqué ci-après.
Pour les projets Web, le chemin complet du fichier est le suivant :
<répertoire_installation_partagé>\plugins\com.ibm.hats_nnn\predefined\ projects\new\Web Content\WEB-INF\profiles\application.hap
Pour les projets client enrichi, le chemin complet du fichier est le suivant :
<répertoire_installation_partagé>\plugins\com.ibm.hats_nnn\predefined\ projects\rcp\new\profiles\application.hapDans les chemins de fichier ci-dessus, répertoire_installation_partagé correspond au répertoire des ressources partagées dans lequel vous avez installé l'offre HATS à l'aide d'IBM® Installation Manager et nnn correspond à la version et au niveau de compilation de HATS.
Les règles globales permettent la reconnaissance et la transformation des masques des zones d'entrée hôte et fonctionnent avec les écrans personnalisés et non personnalisés (rendu par défaut). Elles peuvent être définies au niveau du projet et au niveau de chaque écran. Utilisez cette section pour définir les règles globales au niveau du projet. Voir Règles globales, pour savoir où définir les règles globales au niveau de l'écran.
Si une règle globale est définie au niveau du projet et au niveau d'un écran pour la même zone de saisie, la règle globale de niveau écran est prioritaire.
Vous pouvez, par exemple, créer une règle globale qui affiche toute zone d'entrée précédée du mot Pays sous la forme d'un menu déroulant contenant les codes associés aux divers pays. Les règles globales de niveau projet sont vraiment globales par rapport à l'application HATS. Elles fonctionnent aussi bien dans les écrans transformés avec les paramètres de rendu que dans les transformations personnalisées. Ainsi, la totalité de votre application peut reconnaître un modèle d'écran hôte particulier sans qu'il soit nécessaire de modifier l'une de vos transformations.
Une règle globale se compose d'un type de modèle configuré et d'un fragment de transformation. La configuration du type de modèle spécifie le type de contenu devant être recherché dans l'écran hôte. Elle vous permet de transformer certaines zones d'une taille donnée, ou la totalité d'entre elles, ou les zones situées à proximité d'une chaîne que vous indiquez. Par exemple, le modèle à reconnaître peut être une zone d'entrée précédée du mot Date. Ces fragments de transformation contiennent les données que vous souhaitez utiliser pour remplacer toutes les occurrences d'un masque dans toutes les transformations. Il peut contenir un composant de type zone d'entrée et un objet fenêtre de type agenda. Le résultat obtenu sera alors l'affichage de toutes les zones d'entrée précédées du mot Date sous forme de commande d'agenda, et cela dans toute l'application.
Toutes les règles globales configurées sont affichées dans le tableau des règles globales. L'ordre de traitement des règles globales est l'ordre d'apparition de ces règles dans la liste au début de chaque action Application d'une transformation. Une fois qu'une zone d'entrée a été reconnue par une règle globale de la liste, elle ne peut plus être reconnue par une règle globale en position ultérieure dans la liste. La case à cocher située en regard de chaque option indique si cette option est activée ou désactivée.
Pour ajouter une définition de règle globale à la liste des règles du projet, cliquez sur le bouton Ajout. Si vous ne disposez pas de capture d'écran, vous êtes invité à ouvrir le terminal hôte afin de pouvoir capturer un écran. La création d'une nouvelle règle globale implique la saisie d'un Nom, d'un module (pour les projets client enrichi) et d'une Description, ainsi que l'association avec un nouveau fragment de transformation (Créer un nouveau fragment de transformation). Si vous modifiez une règle globale, vous pouvez Utiliser le fragment de transformation existant.
Sélectionnez ensuite le type de modèle à utiliser. Les types de modèles à votre disposition sont les suivants :
Si vous sélectionnez Toutes les zones d'entrée pour l'option Transformation, la première zone d'entrée répondant aux critères détermine la portée de la région de recherche pour les zones suivantes. L'exemple ci-dessous présente les zones considérées comme étant des correspondances exactes pour toutes les zones d'entrée sous une zone protégée contenant la chaîne Entrée.. L'assistant Paramètres de règle globale met les zones correspondantes en évidence. La première correspondance est la zone portant la légende Alpha field (blue). Les colonnes de début et de fin de cette zone déterminent les zones placées au-dessous qui doivent également être considérées comme des correspondances. Notez que les zones portant les légendes Numeric field (green) et Column separators ne sont pas considérées comme des correspondances car elles sont soit plus longues soit plus courtes que la première zone présentant une correspondance. La zone avec la légende Date field (pink), et les trois zones immédiatement au-dessous, sont considérées comme des correspondances car elles ont les mêmes colonnes de début et de fin que la première zone présentant une correspondance.

Chaque composant Type de modèle peut contenir un ensemble de paramètres personnalisables comme décrit précédemment. Au fur et à mesure que vous modifiez ces paramètres, l'écran situé à gauche est mis à jour pour indiquer les zones d'entrée correspondant aux paramètres (notez que plusieurs zones sont mises en évidence si plusieurs zones correspondent aux paramètres). Vous pouvez également mettre en évidence certaines zones de l'écran hôte en sélectionnant différentes options situées en regard de Mettre en évidence les zones. Pour voir où sont définies des zones d'entrée dans l'écran, cochez la case Entrée. Pour visualiser les zones d'entrée protégées, cochez la case Protégées. Pour mettre en évidence des zones masquées, cochez la case Masquées. Pour modifier les couleurs des zones d'entrée, ainsi que des zones protégées ou masquées, voir Préférences HATS. Si vous utilisez un fragment existant, cliquez sur Fin pour mettre à jour l'ensemble des règles globales et ne tenez pas compte de la section suivante.
Si vous créez un nouveau fragment, vous devez dès à présent configurer le composant HATS à insérer dans le fragment de transformation. Le but des règles globales est de rechercher des zones d'entrée. Aussi, seuls les composants d'entrée sont affichés. La zone de l'écran hôte qui est utilisée pour la configuration de cette page est signalée par la boîte de sélection qui encadre la première zone d'entrée de la page précédente possédant une correspondance, mais n'oubliez-pas que la règle globale de niveau projet agit sur toutes les zones d'entrée possédant une correspondance, sur cet écran hôte et sur tous les autres. Sélectionnez un composant et un objet fenêtre et configurez leurs paramètres. Pour plus de détails, voir Insertion d'un composant hôte ou Edition d'un composant hôte Web uniquement . Cliquez sur Fin pour mettre à jour l'ensemble de règles globales et créer un nouveau fragment de transformation dans le dossier Fragments de transformation. Prenez soin d'enregistrer les paramètres du projet une fois que vous avez fini d'utiliser l'assistant.
Si vous souhaitez modifier les paramètres des composants et des objets fenêtre d'une règle globale existante, accédez à l'onglet Rendu, sélectionnez Règles globales, sélectionnez le fragment de transformation dans la liste et cliquez sur Editer.
Le fragment de transformation est initialement créé avec un composant HATS spécial qui correspond aux paramètres choisis sur la troisième page de l'assistant de définition de règle globale. Ce composant est spécial car il ne contient pas d'attributs de zone. En réalité, il obtient de façon dynamique la région à rendre au moment de l'exécution. Vous pouvez modifier ce composant comme vous le feriez pour n'importe quel autre composant HATS mais, sur la première page de l'assistant, vous devez sélectionner une règle globale au lieu de sélectionner une zone d'écran. Vous pouvez aussi insérer d'autres contenus de transformation HATS corrects dans ce fragment de transformation.
Si vous choisissez de modifier manuellement le fragment de transformation associé à une règle globale, vous ne devez pas effectuer de modifications après avoir utilisé l'éditeur à partir de l'onglet Rendu. Si vous procédez ainsi, la mauvaise balise est lue et toutes les modifications apportées sont supprimées.
Les règles globales du niveau projet et du niveau écran applicable sont toutes appliquées dans une transformation événement d'écran. Vous pouvez désactiver le traitement de toutes les règles globales au niveau de la événement d'écran. Pour désactiver les règles globales, procédez comme indiqué ci-après.
Les applications HATS peuvent convertir des chaînes de texte contenues dans les écrans hôte en chaînes de texte différentes, en contenu Web uniquement HTML ou en images.
La fonction Remplacement de texte affiche un tableau dans lequel vous pouvez indiquer le texte à remplacer et le texte, contenu HTML Web uniquement , ou image de remplacement. Elle indique également si la recherche de texte est sensible à la casse et si les caractères génériques sont pris en charge. Vous pouvez ajouter, modifier ou supprimer toute spécification de remplacement de texte à l'aide des boutons situés à droite du tableau des valeurs. Pour plus d'informations sur la spécification de ces paramètres, voir Remplacement de texte.
Pour modifier les paramètres des composants et objets fenêtre individuels, vous devez les développer dans l'arborescence. Certains composants et objets fenêtre ne disposent pas de paramètres personnalisables. Pour plus d'informations sur les paramètres personnalisables à partir de l'assistant Insertion d'un composant hôte, voir Paramètres des composants et des objets fenêtre.
Vous avez la possibilité de remplacer les paramètres de projet par défaut des composants et objets fenêtre lors de leur insertion dans les transformations. Ces paramètres modifiés s'appliquent uniquement aux instances individuelles des composants hôte et des objets fenêtre dans la transformation concernée. Toutes les autres instances des composants et objets fenêtre dans toute autre transformation du projet continuent à utiliser les paramètres de projet par défaut, sauf si vous les modifiez. Considérons par exemple les paramètres par défaut du composant VisualTable. Dans une transformation, vous pouvez avoir deux composants VisualTable, l'un utilisant les paramètres par défaut du projet et l'autre utilisant des paramètres modifiés.
La fonction Composants affiche une liste des composants hôte qui peuvent être utilisés pour convertir les éléments d'un écran hôte en objets qui pourront être affichés dans une interface graphique. Les paramètres d'un composant hôte précisent la façon dont ce composant devra être reconnu dans l'écran hôte. Vous pouvez modifier certains composants. Pour plus d'informations sur les composants hôte, voir Paramètres de composant hôte.
Si vous sélectionnez la fonction Objets fenêtre, vous voyez s'afficher une liste de tous les objets fenêtre HATS que votre projet peut utiliser pour afficher les composants hôte dans une interface graphique. Vous pouvez modifier certains objets fenêtre. Lorsque vous personnalisez un objet fenêtre, vous définissez la façon dont ce dernier s'affichera sur la page Web. Pour plus d'informations sur les objets fenêtre et sur les paramètres que vous pouvez modifier, voir Paramètres d'objet fenêtre.
Le panneau des paramètres de la barre d'outils vous permet de modifier les paramètres liés à la barre d'outils dans la vue Transformation de votre application client enrichi. La barre d'outils contient des actions du bloc de touches application, par exemple Régénérer et Par défaut, ainsi que les actions fournies par l'objet fenêtre Barre d'outils. Pour plus d'informations sur l'objet fenêtre Barre d'outils, voir Barre d'outils plateforme client enrichi uniquement .
Dans les applications Web HATS, le bloc de touches application est généralement situé en bas ou dans la barre d'options latérale du modèle. Pour les applications client enrichi HATS, les fonctions fournies par le bloc de touches application existent sous la forme de boutons dans la barre d'outils Transformation. Ceci facilite l'intégration de l'application client enrichi HATS avec les autres applications de l'environnement client enrichi. Pour plus d'informations sur la barre d'outils de la vue Transformation, voir Barre d'outils.
Dans ce panneau, vous pouvez sélectionner ou non la case à cocher Afficher la barre d'outils. Si vous la sélectionnez, vous pouvez indiquer comment les options de la barre d'outils doivent être affichées, sous la forme de Texte, Image, ou Texte et image. Ce paramètre s'applique à toutes les options de la barre d'outils (y compris celles fournies par l'objet fenêtre de la Barre d'outils).
Le bloc de touches application par défaut s'affiche dans le modèle par défaut. Voici les paramètres du bloc de touches application que vous pouvez personnaliser :
Voici les paramètres du bloc de touches hôte que vous pouvez personnaliser :
Vous avez également la possibilité d'ajouter une touche hôte personnalisée en cliquant sur le bouton Ajout et en indiquant le Titre et la Mnémonique. Cliquez sur OK lorsque vous avez terminé.
La zone d'informations opérateur vous permet de déterminer facilement l'état de l'application hôte. Vous pouvez personnaliser les paramètres suivants de la zone d'informations opérateur :
Vous pouvez configurer des options impliquant le jeu de caractères codé sur deux octets pour votre projet si la connexion par défaut indique une page de codes avec un jeu de caractères codé sur deux octets. Pour plus d'informations sur les paramètres DBCS de l'onglet Rendu, voir Onglet Rendu.
L'onglet Evénements affiche une liste des événements d'écran (ordonnés selon leur priorité) (personnalisations d'écran et combinaisons d'écran) contenus dans le projet, ainsi que des événements d'application.
Si vous cochez la case située en regard du nom d'un événement d'écran cet événement sera activé pour le projet. Lorsqu'un événements d'écran est activé et que le critère de reconnaissance d'écran correspond à l'écran hôte, HATS exécute les actions définies pour cet événement et plus aucune reconnaissance de événements d'écran n'est effectuée. Lorsqu'un événement d'écran est désactivé, HATS n'en tient pas compte. Pour pouvoir tester uniquement certains événements d'écran, il vous suffit de désactiver les autres événements d'écran. Pour désactiver un événement d'écran, désélectionnez la case à cocher correspondante pendant le test.
Les applications HATS comparent chaque écran hôte entrant à la liste des événements d'écran activés. Si plusieurs événements d'écran correspondent à un écran donné, c'est le premier qui est appliqué. L'événement d'écran possédant la priorité la plus élevée doit se trouver en haut de la liste. Par exemple, vous pouvez avoir un événement d'écran qui reconnaît quelques écrans spécifiques et un second qui reconnaît un ensemble plus générique d'écrans. Si le second événement d'écran se trouve en position prioritaire par rapport au premier dans la liste, un écran pourra être reconnu par le critère de reconnaissance d'écran le plus général et les actions correspondantes seront effectuées (la reconnaissance de l'écran par les critères plus spécifiques ne sera pas effectuée et les actions correspondant au premier événement d'écran ne seront pas appliquées).
Pour modifier la priorité d'un événement d'écran, sélectionnez-le en cliquant dessus. Cliquez ensuite sur Vers le haut ou Vers le bas pour déplacer l'événement vers le haut ou vers la bas de la liste. Pour plus d'informations, voir Priorité des événements d'écran.
Pour modifier un événement d'application, cliquez sur le lien associé à l'événement situé sous Evénements liés à l'application que vous souhaitez modifier. Pour plus d'informations, voir Evénements d'application.
Vous avez la possibilité de modifier l'ordre des événements d'écran à partir de l'onglet Evénements de l'éditeur de projet. Pour plus d'informations, voir Evénements.
Lorsqu'une application HATS s'exécute et qu'un nouvel écran hôte est rencontré, HATS contrôle le premier événement d'écran activé dans la liste de priorité des événements pour déterminer si l'écran hôte répond aux critères de reconnaissance d'écran. Si tel est le cas, plus aucune événements d'écran n'est effectuée sur les événements d'écran et les actions associées au premier événement d'écran sont exécutées. Dans le cas contraire, l'événement d'écran suivant dans la liste est contrôlé afin de déterminer si l'écran hôte remplit les critères de reconnaissance d'écran. Cette procédure se poursuit jusqu'à ce que le dernier événement d'écran de la liste ait été contrôlé.
Si aucun des critères de reconnaissance d'écran associés aux événements d'écran n'est rempli par l'écran hôte en cours, HATS traite l'événement d'écran vierge si des actions sont définies et que l'écran est vierge. Sinon, HATS effectue le traitement associé à l'événement d'écran sans correspondance. L'événement d'écran sans correspondance HATS est un événement d'écran particulier qui ne s'exécute que lorsqu'aucun événement d'écran défini ne correspond à l'écran hôte. L'action par défaut exécutée dans le cadre de cet événement est l'affichage de l'écran hôte (transformation par défaut) qui s'applique au modèle par défaut.
Vous avez la possibilité de modifier les actions à exécuter si un écran hôte ne correspond à aucun des événements d'écran. Par exemple, vous pouvez créer une page Web qui indique à l'utilisateur que la page est introuvable et qui contient les informations d'accès à cet écran. Vous pouvez utiliser l'action Affichage d'une adresse URL pour afficher la page Web.
Pour modifier l'action de l'événement d'écran sans correspondance, accédez à l'onglet Evénements et cliquez sur Ecran sans correspondance sous la section Evénements liés à l'application pour ouvrir l'éditeur associé. Cliquez sur l'onglet Actions situé dans la partie inférieure de la fenêtre de l'éditeur afin d'afficher la page correspondante. Cliquez ensuite sur Ajout, Edition ou Retrait pour personnaliser le fichier unmatchedScreen.evnt.
La technique basée sur des règles utilisée par HATS vous permet de personnaliser des écrans en appliquant certaines actions à l'issue de l'événement de reconnaissance d'écran. Vous pouvez également associer des actions à d'autres événements HATS appelés événements liés à l'application. Les événements d'application incluent des occurrences de type application telles que la connexion au serveur hôte et la déconnexion de ce dernier, le démarrage ou l'arrêt de l'application HATS, ou la rencontre d'une erreur ou d'un écran hôte non reconnu. Vous avez la possibilité de configurer ces événements liés à l'application afin qu'ils exécutent certaines actions lors de leur intervention.
Pour accéder aux événements d'application, affichez la vue Projets HATS, cliquez deux fois sur l'option Paramètres de projet du projet HATS et sélectionnez l'onglet Evénements. Dans l'onglet Evénements de la section Evénements d'application, cliquez sur le lien d'un événement afin d'ouvrir l'éditeur associé.
Chaque événement d'application est associé à diverses actions. .
Vous trouverez ci-après les descriptions des événements liés à une application HATS et les conditions dans lesquelles ils peuvent intervenir, ainsi que les actions associées.
Vous pouvez indiquer les actions suivantes pour l'événement de démarrage :
Vous pouvez indiquer les actions suivantes pour l'événement de connexion :
Vous pouvez indiquer les actions suivantes pour l'événement d'écran vierge :
Vous pouvez également indiquer des paramètres spéciaux pour préciser le mode de réception d'un écran vierge lors de la connexion initiale à l'hôte existant. Pour plus d'informations, voir Gestion de l'écran.
Vous pouvez indiquer les actions suivantes pour l'événement d'écran sans correspondance :
Vous pouvez indiquer les actions suivantes pour l'événement d'erreur :
Vous pouvez indiquer les actions suivantes pour l'événement de déconnexion :
Vous pouvez indiquer les actions suivantes pour l'événement d'arrêt :
<?xml version="1.0" encoding="UTF-8"?>
<event description="" type="stop">
<actions>
<release enabled="true"/>
<show enabled="true" page="stop.jsp" url="/stop.jsp"/>
</actions>
</event> L'onglet Autre affiche les paramètres concernant le support clavier, l'environnement local client, le remplacement de paramètre de connexion, la mise à jour asynchrone, le remplacement de variable globale et les paramètres du client..
Vous pouvez personnaliser les valeurs par défaut de chacun de ces paramètres en cliquant sur le noeud correspondant situé dans l'arborescence des paramètres de personnalisation.
Voici les paramètres du support clavier que vous pouvez personnaliser :
Pour pouvoir utiliser le support clavier dans les projets Web HATS, vous devez disposer d'un navigateur Web pris en charge. Pour obtenir la liste des navigateurs Web pris en charge et des limitations correspondantes, voir la section Prérequis pour HATS dans le centre de documentation HATS à l'adresse http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp.
Choisissez l'une des options suivantes et indiquez si le support du clavier sera limité aux touches de fonction affichées dans la page du navigateur :
Il est possible d'afficher les titres de bouton et les messages en plusieurs langues. Pour configurer la langue d'affichage, personnalisez les paramètres de l'environnement local client :
HATS autorise l'utilisation de paramètres de session Host On-Demand en tant que paramètres de connexion pour les connexions hôte HATS. Pour plus d'informations sur ces paramètres, voir le centre de documentation Host On-Demand à l'adresse http://publib.boulder.ibm.com/infocenter/hodhelp/v10r0/index.jsp et recherchez paramètres de session (session parameters). Vous trouverez des informations supplémentaires sur ces paramètres à l'adresse http://www-01.ibm.com/support/docview.wss?uid=swg21251884.
Pour les applications Web HATS, ces paramètres de connexion peuvent être remplacés dans l'URL permettant d'accéder à l'application HATS. Par exemple, l'URL suivante peut être saisie :
http://servername:port/appname/index.jsp?host=9.42.141.26&sessionType=1&port=523& LUName=LU00001&TNEnhanced=true
Après avoir spécifié le nom de serveur, le port et le nom de l'application HATS, indiquez le fichier index.jsp de la page de bienvenue, suivi par un point d'interrogation (?) et les paires name=value des paramètres, séparées par des perluètes (&). Il s'agit de valeurs de texte définies par le produit Host On-Demand et non des valeurs utilisées ailleurs dans le fichier application.hap. Par exemple, sessionType=1 pour 3270 et sessionType=2 pour 5250.
Outre les paramètres de session Host On-Demand, les paramètres SSLP12FilePath et SSLP12Password peuvent également être remplacés. Les paramètres SSLP12FilePath et SSLP12Password indiquent l'emplacement et le mot de passe du fichier de clés PKCS12 utilisé pour les connexions SSL. Pour plus d'informations, voir Sécurité.
Pour plus d'informations sur comment remplacer les connexions de paramètre pour les portlets HATS, voir Remplacement de paramètres de connexion et de variables globales.
Pour plus d'informations sur la manière dont l'utilisateur d'une application client enrichi remplace les paramètres de connexion à l'aide de l'élément Propriétés du menu en incrustation de la vue Applications, voir Paramètres de connexion. Pour obtenir des informations sur le lancement par programme d'une instance d'application client enrichi par le biais de remplacements de paramètre de connexion, voir le manuel HATS Rich Client Platform Programmer's Guide.
Pour contrôler les paramètres de connexion qui, le cas échéant, peuvent être remplacés, sélectionnez l'un des boutons d'option suivants :
Vous pouvez ajouter des exceptions aux options sélectionnées en ajoutant ou en supprimant des paramètres de connexion. Pour obtenir la liste des paramètres de connexion disponibles, cliquez sur le bouton Ajouter.
Si des paramètres de connexion sont remplacés au moment de l'exécution, HATS utilise les valeurs de remplacement pour créer une connexion de transformation différente de celle définie lors de la création de l'application. Vous devez définir le paramètre de connexion connectionName avant de sélectionner la connexion HATS qui utilisera un modèle pour créer la connexion de transformation :
Lorsque HATS crée une connexion de transformation de base, certaines des fonctions sont désactivées mêmes si elles ont été activées pour la connexion choisie comme connexion modèle. Dans la connexion de base, le regroupement est toujours désactivé et les délais d'attente et les macros de la connexion et de la déconnexion sont ignorés. Les paramètres de connexion HOD de la connexion modèle tels le nom d'hôte et le port sont copiés à partir de la connexion modèle et toutes les substitutions de paramètres de connexion fournies sont appliquées pour la création de la connexion de transformation de base. Notez que les connexions de base sont toujours basées sur la connexion de transformation par défaut de l'application.
Lorsque HATS crée une connexion de transformation complète, tous les paramètres de connexion associés à la connexion définie par le paramètre connectionName sont utilisés, y compris les paramètres de regroupement, les macros ainsi que les délais d'attente de la connexion et de la déconnexion. Les substitutions de paramètre de connexion, s'il en existe, sont alors appliquées pour créer la spécification de pool utilisée pour créer la connexion de transformation.
Si vous indiquez le nom d'une connexion d'arrière-plan comme valeur du paramètre connectionName et que vous ne spécifiez pas d'autres valeurs de substitution, vous modifiez de manière efficace la connexion à utiliser comme connexion de transformation pour cette instance d'application.
Toutes les connexions HATS sont basées sur une spécification de pool. Ce type de spécification correspond à un objet interne décrivant les propriétés de toutes les connexions créées à partir de l'objet lui-même. HATS Toolkit crée des spécifications de pool et l'environnement d'exécution utilise ces fichiers de connexion, par exemple main.hco, pour créer des connexions Telnet lors de l'exécution. Lorsque vous spécifiez des substitutions de paramètres de connexion, l'environnement d'exécution HATS crée un objet de spécification de pool de manière dynamique, le cas échéant, pour décrire les propriétés de la nouvelle connexion. Ces spécifications sont visibles dans le panneau d'administration HATS des applications Web. Les spécifications de pool créées de manière dynamique lors de la définition des substitutions de paramètre, que le paramètre connectionName soit spécifié ou non, sont automatiquement détruites lorsque la dernière connexion active est désactivée, selon si le regroupement est désactivé.
Les substitutions de paramètre de connexion peuvent être différentes pour chaque utilisateur accédant à une application HATS. Par exemple, si chaque utilisateur indique une substitution LUName différente, l'environnement d'exécution HATS crée une spécification de pool différente pour chaque utilisateur. Vérifiez que le regroupement est désactivé pour la connexion d'origine afin que la spécification de pool soit détruite automatiquement. Si plusieurs utilisateurs indiquent les mêmes valeurs de substitution, une seule spécification de pool sera créée et réutilisée pour créer plusieurs connexions Telnet dont la configuration est identique. Par exemple, si plusieurs utilisateurs indiquent une substitution de nom d'hôte particulière, une seule spécification de pool sera créée, puis détruite lorsque cette spécification ne sera plus utilisée par des connexions.
Pour spécifier le paramètre connectionName en tant que substitution de paramètre de connexion, le paramètre doit être activé pour les substitutions figurant sur la page Remplacement des paramètres de connexion dans l'onglet Autre de l'éditeur de paramètres de projet.
HATS fournit des fonctions de déconnexion automatique permettant de déconnecter automatiquement l'hôte si le navigateur est fermé avant la déconnexion de la session. Pour plus d'informations, voir Déconnexion et régénération automatique Web uniquement . Pour les applications qui n'utilisent pas ces fonctions, le paramètre disconnectOnClose effectue une opération similaire. Il permet au serveur HATS de réinitialiser immédiatement la session Telnet hôte si le navigateur est fermé avant que l'utilisateur déconnecte manuellement la session à partir de l'hôte. La déconnexion a généralement lieu lorsque l'utilisateur clique sur Déconnecter. La réinitialisation de la session Telnet est effectuée à l'aide d'un cadre masqué du navigateur qui lance un nouveau navigateur lorsque le navigateur d'origine est fermé. La fenêtre du nouveau navigateur envoie un signal de déconnexion, puis se ferme elle-même.
Cette fonctionnalité est uniquement activée si vous indiquezdisconnectOnClose=true et que vous utilisez une version d'Internet Explorer prise en charge. La spécification du paramètre disconnectOnClose est soumise à la distinction majuscules/minuscules. Voici un exemple de demande d'URL :
http://hostname/appname/index.jsp?disconnectOnClose=true
où appname représente le nom de votre application HATS.
Les conditions d'utilisation du paramètre disconnectOnClose sont les suivantes :
La fonction de mise à jour asynchrone des applications client enrichi HATS est activée par défaut. Vous pouvez désactiver cette fonction en décochant la case Activer les mises à jour asynchrones. Le principal objectif du mécanisme de mise à jour asynchrone est de mettre automatiquement à jour la vue de l'interface graphique si l'écran hôte sous-jacent change parce que l'hôte a envoyé un nouvel écran. Ceci a pour avantage :
Pour les applications Web HATS, les fonctions de déconnexion et de régénération automatiques peuvent être exécutées soit par une méthode pull du client à l'aide d'une implémentation AJAX, soit par une méthode push du serveur à l'aide d'une implémentation d'applet. Pour activer l'implémentation AJAX, sélectionnez l'option Activer la commande pull du client (AJAX). Pour activer l'implémentation d'applet, sélectionnez l'option Activer la commande push du serveur (applet). Pour désactiver ces deux fonctions, sélectionnez Désactivé. La valeur par défaut est Désactivé.
Pour les applications Web HATS, vous pouvez configurer la méthode d'implémentation de la commande pull du client (AJAX), qui inclut les fonctions de déconnexion et régénération automatiques.
La fonction de déconnexion automatique permet de détecter l'absence de contact entre le navigateur et votre application HATS pendant une période prédéfinie. Le processus de déconnexion est alors déclenché pour nettoyer les ressources associées à la session du navigateur et réduire ainsi la charge sur le serveur. Pour ce faire, l'événement de déconnexion ainsi que la macro de déconnexion (si celle-ci est configurée) sont exécutés.
L'objectif de la fonction de régénération automatique est de mettre automatiquement à jour la vue de la page Web de l'application HATS si l'écran hôte sous-jacent change parce que l'hôte a envoyé un nouvel écran. Grâce à cette fonction, l'utilisateur ne doit plus cliquer sur le bouton Régénérer pour afficher les écrans de l'hôte modifiés de façon asynchrone.
Lorsque la régénération automatique est activée, une vue de page Web n'est pas automatiquement mise à jour si :
<script> browserRefreshEnabled = false; </script>
A la différence de l'implémentation de la méthode push du serveur qui ne peut utiliser que certains navigateurs, la méthode pull du client (AJAX) prend en charge tous les navigateurs pris en charge par HATS. De même, à la différence de la méthode push (applet) du serveur, il n'est pas nécessaire d'utiliser une connexion supplémentaire au serveur, ce qui facilité la configuration pour l'administrateur HATS. La méthode pull du client (AJAX) et la méthode push (applet) du serveur s'excluent mutuellement. Si l'une des fonctions de la méthode pull du client (AJAX) est activée, la configuration de la méthode push (applet) du serveur n'est alors pas prise en compte.
Pour configurer les fonctions de déconnexion et de régénération automatique, utilisez les paramètres suivants :
La méthode d'implémentation push (applet) du serveur, également appelée applet de mise à jour asynchrone, exécute deux fonctions :
Lorsque l'applet de mise à jour asynchrone est utilisée, outre la connexion employée pour envoyer les écrans du terminal transformés du serveur HATS vers le navigateur de l'utilisateur, une connexion de socket distincte est établie entre l'applet exécutée sur le client et le serveur HATS. Cette connexion socket distincte permet de transférer de petits messages entre le client et le serveur, relatifs aux régénérations d'écran asynchrones à partir de l'hôte, ainsi qu'une notification au serveur HATS que le navigateur a été fermé. En principe, le trafic transitant sur cette connexion socket distincte est très faible. Les événements nécessaires pour mettre en place cette connexion socket distincte se produisent dans l'ordre suivant :
Pour exécuter cette applet, vous devez disposer d'un navigateur compatible Java. Consultez le Centre d'information HATS à l'adresse http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp pour connaître la liste actualisée des navigateurs pris en charge. Dans le sommaire sous les prérequis pour HATS, sélectionnez Detailed System Requirements.
Pour configurer la méthode d'implémentation push (applet) du serveur, utilisez les paramètres suivants ::
L'applet côté serveur utilise un socket TCP/IP pour communiquer avec le serveur HATS. Le nom d'hôte du serveur hébergeant l'application HATS est requis pour la création du socket. Si HATS est déployé sur le même serveur Web que celui indiqué par l'URL du navigateur, il n'est pas nécessaire de préciser le paramètre du nom d'hôte ; l'applet utilise l'adresse IP du serveur Web pour établir la connexion socket. Si le serveur HATS se trouve sur un autre serveur, vous devez indiquer le paramètre du nom d'hôte, soit via un nom d'hôte Internet visible pour le navigateur, soit via une adresse IP.
Vous pouvez indiquer des paramètres supplémentaires spécifiques au navigateur, ainsi que des paramètres de masque non Windows pour l'applet. Ces paramètres peuvent être modifiés en éditant le fichier application.hap.
Lorsque vous créez un nouveau projet, une balise est générée dans le fichier Web Content/WEB-INF/profiles/application.hap dans la balise <classSettings>. Les paramètres par défaut de l'applet sont les suivants :
<class name="com.ibm.hats.common.AppletSettings"> <setting name="disconnectDelay" value="300000"/> <setting name="enable" value="false"/> <setting name="hostname" value=""/> <setting name="ie" value="disconnect|refresh"/> <setting name="nonWindows" value="disconnect|refresh"/> <setting name="other" value="disconnect|refresh"/> <setting name="port" value="0"/> </class>
Voici une brève description de chaque paramètre :
Les paramètres de navigateur suivants déterminent les fonctions à utiliser pour un navigateur ou un environnement donné :
Les paramètres de navigateur décrits ci-dessus peuvent avoir les valeurs suivantes :
Pour modifier le comportement d'Internet Explorer, remplacez disconnect par disconnectAlways. La liste des paramètres pour Internet Explorer se présente alors comme suit :
<setting name="ie" value="disconnectAlways|refresh|local"/>.
Pour activer la fonction de trace côté client de l'applet de mise à jour asynchrone, vous devez spécifier un paramètre HTML, appletJavaConsoleTrace=true, dans l'adresse Web du servlet d'entrée HATS. Exemple :
http://myhost/myhats/entry?appletJavaConsoleTrace=true
Vous pouvez utiliser cette fonction pour transmettre des données depuis le navigateur de l'utilisateur à l'application. Vous pouvez ainsi autoriser l'utilisateur à indiquer un ID utilisateur et un mot de passe et les employer pour exécuter une macro.
Pour les applications HATS client enrichi, l'utilisateur remplace les variables globales à l'aide de l'option Propriétés du menu contextuel de la vue Applications. Pour plus d'informations, voir Variables.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.
Pour plus d'informations sur la manière dont les variables globales peuvent être remplacées pour les portlets HATS, voir Remplacement de paramètres de connexion et de variables globales.
Pour les applications Web HATS, pour remplacer une variable locale globale, ajoutez un paramètres HTML hatsgv_nomVariable=nouvelleValeur à la requête HTTP du client. Pour remplacer une variable globale partagée, indiquez le paramètre hatssharedgv_nomVariable.
Pour autoriser l'utilisateur à créer et définir la valeur d'une variable globale partagée nommée UserID, vous pouvez fournir une zone d'entrée en ajoutant l'instruction suivante dans le corps de la balise <HATS:Form> d'un fichier JSP de transformation :
<INPUT name="hatssharedgv_UserID" type="TEXT" size="10">
La valeur indiquée par l'utilisateur devient la nouvelle valeur de la variable partagée UserID. Si vous créez la valeur via JavaScript et que vous ne souhaitez pas que l'utilisateur puisse saisir la nouvelle valeur, vous pouvez utiliser une zone d'entrée masquée et indiquer vous-même la valeur :
<INPUT name="hatssharedgv_UserID" size="10" type="HIDDEN" value="alice">
Pour créer une variable globale ou modifier la valeur de la variable globale dans l'URL, vous pouvez indiquer une ligne similaire à la ligne suivante dans une requête GET :
http://hostname/appname/entry?hatsgv_UserID=bob
Pour contrôler les variables globales HATS qui, le cas échéant, peuvent être créées ou modifiées par une demande client de l'utilisateur, sélectionnez l'un des boutons d'option suivants :
Vous pouvez ajouter des exceptions aux variables globales en cliquant sur le bouton Ajout. Vous pouvez alors entrer un nom de variable globale dans la zone de texte ou le sélectionner dans la boîte à liste déroulante. Sélectionnez la case Variable globale partagée pour indiquer une variable globale qui peut être partagée. Pour plus d'informations, voir Interaction avec les variables globales.
Si vous souhaitez modifier une entrée de tableau, cliquez sur Edition. Le bouton Retrait permet de supprimer la variable globale sélectionnée dans la liste des exceptions.
Voici les paramètres client que vous pouvez personnaliser :
+--------------------------------------+ Text UTIL runtime.filters.CompressionFilter.doFilter() 17.50.10.140 11/27/06 Servlet.Engine.Transports : 1 enable compression: true 0000CBAx-81SRWWVmQfQ8-_47oK:-1 +--------------------------------------+ Text UTIL runtime.filters.CompressionFilter.doFilter() 17.50.10.140 11/27/06 Servlet.Engine.Transports : 1 size before: 25315 0000CBAx-81SRWWVmQfQ8-_47oK:-1 +--------------------------------------+ Text UTIL runtime.filters.CompressionFilter.doFilter() 17.50.10.140 11/27/06 Servlet.Engine.Transports : 1 size after: 4264 0000CBAx-81SRWWVmQfQ8-_47oK:-1
Désélectionnez cette case si HATS doit envoyer les données des zones d'entrée modifiées même si le contenu de la zone est identique aux données fournies par l'hôte. Par exemple, si l'hôte a rempli une zone avec les données ABC et que l'utilisateur tape ABC dans la zone, les données tapées sont renvoyées à l'hôte.
Désélectionnez cette case si l'ordre des onglets par défaut ne doit pas inclure les zones en lecture seule protégées.
Pour les applications Web, vous pouvez désactiver individuellement cette fonction pour chaque transformation en ajoutant les lignes suivantes juste après la balise </HATS:Form> dans le fichier de transformation. Pour activer cette fonction de manière sélective, spécifiez true au lieu de false.
<script> autoAdvance = false; </script>
Pour les applications client enrichi, vous pouvez désactiver individuellement cette fonction pour chaque transformation en remplaçant la méthode needsAutoAdvanceSupport de chaque transformation comme indiqué ci-dessous. Pour activer cette fonction de manière sélective, spécifiez true au lieu de false.
public boolean needsAutoAdvanceSupport(boolean preferredValue) {
return false;
}
Pour les remarques relatives à l'utilisation de DBCS avec ce paramètre, voir Activer l'avance de zone automatique.
Désélectionnez cette case pour indiquer que, si l'avance automatique est activée, la mise en évidence doit passer automatiquement à la zone d'entrée suivante dans l'ordre des zones d'entrée sur l'écran hôte.
Pour les applications Web, vous pouvez activer cette fonction pour une transformation en ajoutant les lignes suivantes juste après la balise </HATS:Form> dans votre transformation :
<script> initialInputFocusFromCursor = false; </script>
Pour les applications client enrichi, vous pouvez activer cette fonction pour une transformation en remplaçant la méthode isInitialFocusAtCursorPosition dans la transformation individuelle, comme indiqué ci-après.
public boolean isInitialFocusAtCursorPosition() {
return false;
}<class name="com.ibm.hats.common.RuntimeSettings">
<setting name="nextFieldForDropDown" value="true"/>
</class>Pour les remarques relatives à l'utilisation de DBCS avec ce paramètre, voir Mode remplacement (initial).
Pour les remarques relatives à l'utilisation de DBCS avec ce paramètre, voir Sélectionner tout le texte mis en évidence.
Vous pouvez désactiver individuellement cette fonction pour chaque transformation en remplaçant la méthode needsArrowKeyNavigationSupport de chaque transformation comme indiqué ci-dessous.
public boolean needsArrowKeyNavigationSupport(boolean preferredValue) {
return false;
}
Pour activer cette fonction de manière sélective, spécifiez true au lieu de false.
Ces paramètres s'appliquent uniquement aux projets de type portlet HATS standard (JSR 168). Ils peuvent être utilisés pour le développement d'une solution de communication entre portlets. Pour plus d'informations, voir Communication entre portlets.
Ces paramètres permettent de définir les propriétés reçues via WebSphere Portal des autres portlets JSR 168 (HATS ou non HATS) sur le serveur de portail. Cliquez sur Ajouter pour ajouter une nouvelle propriété. Dans la zone Propriété, entrez le nom de la propriété reçue. Ce nom doit correspondre au nom de propriété utilisé par le portlet source, par exemple au nom de propriété utilisé par l'action Envoyer une variable globale dans un portlet source HATS JSR 168. Dans la zone Variable globale, entrez le nom de la variable globale à utiliser pour stocker la valeur de la propriété reçue. Si la variable globale est indexée, entrez l'index à utiliser. Cochez la case Partagé si la variable globale est une variable globale partagée.
Lorsque vous cliquez sur Terminer, la propriété est ajoutée au fichier application.hap du projet. De plus, un fichier WSDL (Web Services Description Language) est créé, s'il n'en existe pas déjà, et une propriété reçue est définie dans ce fichier. Le nom du fichier WSDL est <project_name>.wsdl. Le fichier WSDL est requis pour la connexion des portlets à l'aide de l'outil de connexion WebSphere Portal. Le fichier portlet.xml est mis à jour afin de faire référence à l'emplacement du fichier WSDL.
Si vous cliquez sur Supprimer, la propriété est supprimée du fichier application.hap du projet, mais est conservée dans le fichier WSDL. Vous pouvez modifier le fichier WSDL et utiliser l'éditeur WSDL pour supprimer la propriété.
L'onglet Source affiche les balises et valeurs du fichier application.hap associées à tous les paramètres sélectionnés ou pour lesquels vous avez accepté les valeurs par défaut dans le projet. Au fur et à mesure que vous modifiez les autres balises dans l'éditeur de projet, les balises et valeurs affichées dans l'onglet Source sont mises à jour pour refléter vos modifications.
Vous pouvez également modifier les balises et valeurs du fichier application.hap en modifiant directement la source dans l'onglet Source. Ces modifications seront prises en compte dans les onglets appropriés de l'éditeur de projet.
Les préférences HATS vous permettent de contrôler l'apparence et le comportement de HATS Toolkit. Ces préférences permettent de rendre HATS Toolkit plus accessible ou de simplifier les tâches de programmation. Pour utiliser les préférences HATS, cliquez sur Fenêtre > Préférences et sélectionnez HATS dans l'arborescence. Pour obtenir de l'aide sur une préférence, placez le curseur sur cette dernière et appuyez sur F1.
Vous avez la possibilité de modifier les préférences suivantes :
Cette préférence n'affecte pas l'affichage sous le dossier Source Java de la vue Projets HATS.
HATS vérifie les paramètres de licence des projets d'un espace de travail au démarrage et invite l'utilisateur à mettre à jour les paramètres si l'un des projets ne correspond pas aux paramètres de la licence principale. Désélectionnez cette case pour désactiver la vérification des paramètres de licence au démarrage.
Il existe d'autres préférences qui régissent les comportements liés à HATS. Pour utiliser ces préférences, développez HATS dans l'arborescence des préférences et cliquez sur l'une des sous-catégories suivantes :
Si un nom de module est créé pour un nouvel artefact, le nom du projet est inséré à la place de {nom du projet}. Une mise en forme de ce remplacement est effectuée afin que le nom de module créé soit valide (par exemple, les espaces sont convertis en traits de soulignement).
Lorsque vous modifiez les préférences HATS, vous avez la possibilité de cliquer sur Appliquer pour afficher immédiatement les résultats de vos modifications dans HATS Toolkit. Cliquez ensuite sur OK pour enregistrer les nouvelles préférences et fermer la fenêtre Préférences ou sur Annuler pour quitter sans sauvegarder. Si vous cliquez sur Annuler, seules les modifications effectuées après avoir cliqué sur Appliquer sont annulées.
Vous pouvez restaurer les valeurs initiales des préférences HATS en cliquant sur l'option Restaurer les valeurs par défaut.
Si vous configurez les préférences HATS pour une instance de HATS Toolkit et que vous souhaitez les copier sur d'autres postes de travail de développement, sélectionnez l'option Fichier > Exporter > Général > Préférences dans la barre de menus Rational SDP pour enregistrer les préférences dans un fichier .epf. Transférez ensuite le fichier sur chaque poste de travail sur lequel vous souhaitez l'utiliser ou mettez-le à disposition sur le réseau. Sélectionnez Fichier > Importer > Général > Préférences pour importer le fichier de préférences.
L'aspect et le comportement de HATS Toolkit peuvent également être affectés par l'utilisation d'autres préférences proposées dans Rational SDP.
Par exemple, vous pouvez utiliser la préférence Décorations de libellé pour activer d'autres kits d'outils tels que Java Compile et CVS afin de décorer les libellés HATS et les images affichées dans la vue Projets HATS. En cas d'erreur, une marque rouge peut être affichée en regard du fichier concerné. Lors de l'extraction de fichiers à partir d'un référentiel CVS, les numéros de version peuvent être affichés en regard des noms de fichier. Pour accéder à la préférence Décorations de libellé dans Rational Application Developer :