Les utilisateurs interagissent souvent avec les applications hôte au moyen de touches spéciales sur le clavier physique (par exemple F1, Attn, Rest ou Effac). Les utilisateurs de vos applications HATS peuvent envoyer des séquences touches à l'hôte de plusieurs manières :
Le présent chapitre explique comment définir le support clavier dans votre projet HATS. Il contient également des suggestions concernant la documentation relative au support clavier pour les utilisateurs.
Pour pouvoir utiliser le support clavier dans les projets HATS Web, vous devez disposer d'un navigateur Web pris en charge. Pour obtenir une 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.
Pour configurer le support clavier dans un projet HATS, vous devez d'abord l'activer dans votre projet. Pour activer le support clavier, accédez à l'onglet Autre des Paramètres de projet et sélectionnez les options disponibles. Pour plus d'informations, voir Support clavier
Vous pouvez également définir un bloc de touches hôte et un bloc de touches application. Pour plus d'informations, voir Bloc de touches hôte et Bloc de touches application.
Pour les projets Web HATS, utilisez les paramètres Bloc de touches hôte et Bloc de touches application de l'onglet Rendu des Paramètres du projet afin d'indiquer les touches à afficher et si elles doivent être affichées sous la forme de boutons ou de liens. Pour plus d'informations, voir Bloc de touches hôte et Bloc de touches application.
Pour modifier le style du bloc de touches d'un projet Web HATS spécifique, modifiez la feuille de style en cascade (fichier .css) qui correspond à ce bloc. Il s'agit de la feuille de style que vous utilisez lors de la génération de votre projet. Dans Rational SDP Workbench, cliquez sur la vue Projets HATS de HATS Toolkit et développez le nom du projet. Développez ensuite l'arborescence Web Content/Common/Stylesheets. Pour plus d'informations, voir Utilisation de feuilles de style.
Pour modifier la feuille de style, cliquez deux fois sur le fichier .css afin d'ouvrir l'éditeur. N'oubliez pas que des modèles peuvent remplacer les modifications apportées à votre feuille de style. Pour plus d'informations sur les feuilles de style en cascade, allez à l'adresse http://www.w3.org/Style/CSS/.
La feuille de style en cascade définit les sept styles suivants :
Pour les projets HATS client enrichi, utilisez les paramètres Bloc de touches hôte de l'onglet Rendu des Paramètres du projet afin d'indiquer les touches à afficher et si elles doivent être affichées sous la forme de boutons ou de liens. Pour plus d'informations, voir Bloc de touches hôte. Utilisez les paramètres Bloc de touches application de l'onglet Rendu des Paramètres du projet pour définir les boutons à afficher au niveau de l'application. Servez-vous des paramètres Barre d'outils de l'onglet Rendu pour indiquer quels boutons au niveau de l'application afficheront du texte, une image ou les deux. Pour plus d'informations, voir Bloc de touches application et Barre d'outils plateforme client enrichi uniquement .
Afin de simplifier l'utilisation de votre application HATS, il est recommandé de présenter en détail les paramètres clavier aux utilisateurs, soit dans l'interface utilisateur de l'application, soit sous une autre forme aisément consultable (par exemple, un lien dans votre modèle). Cette documentation doit indiquer :
| Boutons de la barre d'outils | Touches physiques correspondantes par défaut |
|---|---|
| F1 - F12 | F1 - F12 |
| F13 - F24 | Maj + F1 - F12 |
| ENTREE | Entrée |
| EFFAC | Echap |
| REST | Ctrl + R |
| APPELSYS | Maj + Echap |
| ATTN | Pause/Attn |
| PAGEPREC | Page précédente |
| PAGESUIV | Page suivante |
| PA1 | Alt + Suppr |
| PA2 | Alt + Fin |
| PA3 | Alt + Page suivante |
| IMPR |
Ctrl + P Web uniquement Ctrl + Maj + P Plateforme client enrichi uniquement |
| Aide | Ctrl + H |
| Activation/Désactivation clavier | Ctrl + K |
| Défaut | Alt + Inser |
| Régénération | Alt + PageAv |
| Restauration du formulaire HTML | Ctrl + S |
| Déconnexion | Ctrl + D |
| Affichage des travaux d'impression | Ctrl + J |
| Inversion | Alt + Entrée |
| Fin de la zone |
Maj + Entrée Web uniquement
Touche Entrée du pavé numérique Plateforme client enrichi uniquement Remarque :
Pour plus d'informations, voir Support de touche de zone 5250 particulier. |
| Zone+ |
Ctrl + Touche Plus du pavé numérique Web uniquement Touche Plus du pavé numérique Plateforme client enrichi uniquement |
| Zone- |
Ctrl + Touche Moins du pavé numérique
Web uniquement Touche Moins du pavé numérique Plateforme client enrichi uniquement Remarque :
Pour plus d'informations, voir Support de touche de zone 5250 particulier. |
Les combinaisons de touches associées à la zone par défaut des applications Web HATS sont répertoriées ci-dessous. Pour plus d'informations sur la réaffectation des touches du clavier, voir Réaffectation des touches du clavier dans une application HATS.
Quick Field Exit peut être utilisé avec les applications Web Hats afin d'augmenter la vitesse de saisie des données numériques pour les écrans 5250. Cette touche efface tout le contenu de la zone actuelle (du caret à la fin de la zone) et positionne le curseur sur la zone suivante. Elle peut être utilisée dans n'importe quelle zone et peut également être utilisée à la place de la touche de fin de zone. Une touche de fin de zone envoie l'écran de données vers l'hôte et crée un nouveau dessin de la transformation HATS. Par conséquent, les écrans nécessitant plusieurs éléments de fin de zone avant leur soumission peuvent générer des problèmes d'utilisation. La combinaison de la touche Quick Field Exit et de la fonction Field Exit Emulation augmente la vitesse de ces applications de manière conséquente.
Etant donné que l'architecture des applications client enrichi est différente de celle des applications Web, une touche Quick Field Exit n'est pas requise pour les applications client enrichi. Les applications client enrichi ne disposent pas de délai du parcours circulaire pour une touche de fin de zone.
La touche Quick Field Minus peut être utilisée avec les applications Web Hats afin d'augmenter la vitesse de saisie des données numériques négatives pour les écrans 5250. Cette touche efface tout le contenu de la zone actuelle (du caret à la fin de la zone), ajoute le signe moins (-) au début de la valeur de la zone et positionne le curseur sur la zone suivante. Bien qu'elle peut être utilisée dans n'importe quelle zone, elle est utilisable uniquement dans les zones numériques 5250 signées, où les utilisateurs peuvent également utiliser une zone Moins. Une touche Zone négative envoie l'écran de données vers l'hôte et crée un nouveau dessin de la transformation. Par conséquent, les écrans nécessitant plusieurs éléments de Zone négative avant leur soumission peuvent générer des problèmes d'utilisation. La combinaison de la touche Quick Field Minus et de la fonction Alternate way to input negative numbers augmente la vitesse de ces applications de manière conséquente. L'utilisation de la touche Quick Field Minus dans les zones numériques 5250 signées peut entraîner une entrée de données incorrecte.
Etant donné que l'architecture des applications client enrichi est différente de celle des applications Web, une touche Quick Field Minus n'est pas requise pour les applications client enrichi. Les applications client enrichi ne disposent pas de délai du parcours circulaire pour une touche Zone négative.
Pour spécifier une valeur négative dans une zone numérique 5250 signée, vous pouvez entrer le signe moins (-) en première position de la zone au lieu d'utiliser une Zone négative et de provoquer un aller-retour vers le serveur. Cela accélère la saisie d'une plus grande quantité de valeurs négatives dans des zones numériques 5250 signées. Le serveur HATS émule l'activation d'une touche Zone négative pour chaque zone numérique 5250 signée que vous entrez en la faisant précéder d'un signe moins. Toute donnée qui ne doit pas être préremplie doit être supprimée de la zone avant d'accéder à une zone différente. Les utilisateurs ne doivent pas entrer un signe moins en première position et doivent également appuyer sur les touches Zone négative, Zone positive ou Fin de la zone.
Cette fonction fournit automatiquement à l'utilisateur une touche d'aide de zone de sortie, le cas échéant. Cette touche est requise lors de la modification de certains types de zone 5250.
Par exemple, si un utilisateur active la touche Quick Field Exit pour passer d'une zone à l'autre, et soumet l'écran à l'aide d'une touche Entrée ou d'une touche d'aide qui n'est pas associée à une zone, une touche de fin de zone est peut-être requise pour la zone contenant le curseur lors de la soumission de l'écran.
Dans ce cas, si la touche de zone de fin requise n'est pas fournie, le message d'erreur suivant peut être généré par l'hôte Enter key not allowed in field. Avec cette fonction HATS, le serveur HATS envoie une touche de fin de zone au système hôte avant d'envoyer la touche Entrée, évitant ainsi la génération du message d'erreur.
Si vous souhaitez activer cette fonction, ajoutez les instructions suivantes au fichier application.hap :
<class name="com.ibm.hats.common.RuntimeSettings">
<setting name="emulateFieldExit" value="false"/>
</class>
Si une section <class> existe déjà, ajoutez la ligne <setting> à la section.
Chaque application HATS inclut du code provenant du produit Host On-Demand pour gérer la connexion au serveur Telnet à la place du client. Le présent guide utilise donc la terminologie Host On-Demand pour les mnémoniques de touche qui peuvent être envoyés à l'ordinateur hôte pour représenter l'utilisation de touches par un utilisateur dans une session hôte.
| Fonction | Mot clé mnémonique |
|---|---|
| Attention | [attn] |
| Vue secondaire | [altview] |
| Effacement | [clear] |
| Entrée | [enter] |
| F1 | [pf1] |
| F2 | [pf2] |
| F3 | [pf3] |
| F4 | [pf4] |
| F5 | [pf5] |
| F6 | [pf6] |
| F7 | [pf7] |
| F8 | [pf8] |
| F9 | [pf9] |
| F10 | [pf10] |
| F11 | [pf11] |
| F12 | [pf12] |
| F13 | [pf13] |
| F14 | [pf14] |
| F15 | [pf15] |
| F16 | [pf16] |
| F17 | [pf17] |
| F18 | [pf18] |
| F19 | [pf19] |
| F20 | [pf20] |
| F21 | [pf21] |
| F22 | [pf22] |
| F23 | [pf23] |
| F24 | [pf24] |
| Pos1 | [home] |
| PA1 | [pa1] |
| PA2 | [pa2] |
| PA3 | [pa3] |
| Restauration | [reset] |
| Appel système | [sysreq] |
| Fonction | Mot clé mnémonique |
|---|---|
| Attention | [attn] |
| Vue secondaire | [altview] |
| Effacement | [clear] |
| Entrée | [enter] |
| F1 | [pf1] |
| F2 | [pf2] |
| F3 | [pf3] |
| F4 | [pf4] |
| F5 | [pf5] |
| F6 | [pf6] |
| F7 | [pf7] |
| F8 | [pf8] |
| F9 | [pf9] |
| F10 | [pf10] |
| F11 | [pf11] |
| F12 | [pf12] |
| F13 | [pf13] |
| F14 | [pf14] |
| F15 | [pf15] |
| F16 | [pf16] |
| F17 | [pf17] |
| F18 | [pf18] |
| F19 | [pf19] |
| F20 | [pf20] |
| F21 | [pf21] |
| F22 | [pf22] |
| F23 | [pf23] |
| F24 | [pf24] |
| Fin de la zone | [fldext] |
| Zone+ | [field+] |
| Zone- | [field-] |
| Aide | [help] |
| PA1 | [pa1] |
| PA2 | [pa2] |
| PA3 | [pa3] |
| Appel système | [sysreq] |
| Page précédente | [pageup] |
| Page suivante | [pagedn] |
| Quick Field Exit | [qfldext] |
| Quick Field Minus | [qfld-] |
| Restauration | [reset] |
| Appel système | [sysreq] |
| Demande de test | [test] |
Pour déterminer le code touche d'une touche donnée sur le clavier, sauvegardez le code HTML suivant dans un fichier et ouvrez ce dernier dans une fenêtre Internet Explorer. Vous connaîtrez ainsi le code touche correspondant à chaque touche utilisée dans le navigateur.
<html>
<head>
<script>
document.onkeydown = keydownhandler;
function keydownhandler()
{
document.testform.displayField.value = "Keycode: " + window.event.keyCode;
}
</script>
</head>
<body>
<center>
<form name="testform">
<input type="text" name="displayField" value="Appuyez sur une touche">
</form>
</center>
</body>
</html>
Un fichier appelé KBS.js figure également dans chaque application Web HATS. Ce fichier détermine comment les valeurs de code touche générées par les utilisateurs sont mises en correspondance avec les signaux de touche envoyés à la session hôte. Pour réaffecter le clavier HATS, vous devez éditer le fichier KBS.js. Pour localiser le fichier KBS.js, affichez la vue Navigateur et effectuez une recherche dans le répertoire nom_projet/Web Content/Common. Trois valeurs dans le fichier KBS.js déterminent les relations entre les touches actionnées sur le clavier et le signal qui est ensuite envoyé à l'hôte. Ces trois valeurs sont les suivantes :
var CODE_F2 = 113;pour la touche F2
[CODE_F2, 0, 0, 0, '[pf2]']envoie le signal de touche pf2 à l'hôte lorsque la touche F2 est actionnée sur le clavier de l'utilisateur.
Pour modifier les affectations de touche dans votre application Web HATS, vous pouvez changer ou ajouter des combinaisons de sorte que des touches nouvelles ou existantes envoient le mot clé mnémonique.
| Gardez à l'esprit que vous ne pouvez pas réaffecter les touches de modification Ctrl, Alt et Maj. HATS utilise JavaScript™, qui ne considère pas ces touches comme de simples touches du clavier, mais comme des modificateurs. |
Pour réaffecter des touches dans les applications Web HATS, il vous suffit de modifier le code touche et les variables defaultKeyMappings au début du fichier KBS.js.
Voici un exemple d'affectation de la combinaison de touches Ctrl+Pos1 sur le clavier. Pour envoyer la touche Pos1 à la session hôte et placer un bouton correspondant à cette fonction dans votre transformation, vous devez obligatoirement effectuer les deux étapes suivantes : édition du fichier KBS.js puis modification de votre transformation comme indiqué dans Ajout de boutons de bloc de touches supplémentaires dans une transformation.
Pour spécifier la combinaison de touches qui permet d'envoyer la touche hôte, modifiez le fichier KBS.js en ajoutant les lignes définies en gras et en italique ci-dessous :
var CODE_BACKSPACE = 8; var CODE_TAB = 9; var CODE_ENTER = 13; var CODE_PAUSE = 19; var CODE_ESC = 27; var CODE_PAGEUP = 33; var CODE_PAGEDOWN = 34; var CODE_END = 35; var CODE_HOME = 36; var CODE_INSERT = 45; var CODE_DELETE = 46; var CODE_A = 65; var CODE_B = 66; var CODE_C = 67; var CODE_D = 68; var CODE_E = 69; var CODE_F = 70; var CODE_G = 71; var CODE_H = 72; var CODE_I = 73; var CODE_J = 74; var CODE_K = 75; var CODE_L = 76; var CODE_M = 77; var CODE_N = 78; var CODE_O = 79; var CODE_P = 80; var CODE_Q = 81; var CODE_R = 82; var CODE_S = 83; var CODE_T = 84; var CODE_U = 85; var CODE_V = 86; var CODE_W = 87; var CODE_X = 88; var CODE_Y = 89; var CODE_Z = 90; var CODE_HOSTHOME = 36; var CODE_F1 = 112; var CODE_F2 = 113; var CODE_F3 = 114; var CODE_F4 = 115; var CODE_F5 = 116; var CODE_F6 = 117; var CODE_F7 = 118; var CODE_F8 = 119; var CODE_F9 = 120; var CODE_F10 = 121; var CODE_F11 = 122; var CODE_F12 = 123; var HostKey =1; var ApplicationKey =2; /*********************************************************** * NOTICE: DO NOT MODIFY THE ABOVE VARIABLES!! ***********************************************************/ var defaultKeyMappings = [ // KEYCODE, ALT, CTRL, SHIFT, MNEMONIC //============ command key mappings ================ [CODE_ENTER, 0, 0, 0, '[enter]' ], [CODE_PAUSE, 0, 0, 0, '[attn]' ], [CODE_ESC, 0, 0, 0, '[clear]' ], [CODE_ESC, 0, 0, 1, '[sysreq]' ], [CODE_PAGEUP, 0, 0, 0, '[pageup]' ], [CODE_PAGEUP, 1, 0, 0, 'refresh' ], [CODE_PAGEDOWN, 0, 0, 0, '[pagedn]' ], [CODE_HOSTHOME, 0, 1, 0, '[home]' ], [CODE_PAGEDOWN, 1, 0, 0, '[pa3]' ], [CODE_END, 1, 0, 0, '[pa2]' ], [CODE_INSERT, 1, 0, 0, 'default' ], [CODE_DELETE, 1, 0, 0, '[pa1]' ], [CODE_D, 0, 1, 0, 'disconnect' ], [CODE_H, 0, 1, 0, '[help]' ], [CODE_P, 0, 1, 0, '[printhost]' ], [CODE_J, 0, 1, 0, 'printjobs' ], [CODE_ENTER, 1, 0, 0, 'reverse' ], [CODE_K, 0, 1, 0, 'toggle' ], [CODE_S, 0, 1, 0, 'ResetButton' ], //============ function key mappings =============== [CODE_F1, 0, 0, 0, '[pf1]' ], [CODE_F1, 0, 0, 1, '[pf13]' ], [CODE_F2, 0, 0, 0, '[pf2]' ], [CODE_F2, 0, 0, 1, '[pf14]' ], [CODE_F3, 0, 0, 0, '[pf3]' ], [CODE_F3, 0, 0, 1, '[pf15]' ], [CODE_F4, 0, 0, 0, '[pf4]' ], [CODE_F4, 0, 0, 1, '[pf16]' ], [CODE_F5, 0, 0, 0, '[pf5]' ], [CODE_F5, 0, 0, 1, '[pf17]' ], [CODE_F6, 0, 0, 0, '[pf6]' ], [CODE_F6, 0, 0, 1, '[pf18]' ], [CODE_F7, 0, 0, 0, '[pf7]' ], [CODE_F7, 0, 0, 1, '[pf19]' ], [CODE_F8, 0, 0, 0, '[pf8]' ], [CODE_F8, 0, 0, 1, '[pf20]' ], [CODE_F9, 0, 0, 0, '[pf9]' ], [CODE_F9, 0, 0, 1, '[pf21]' ], [CODE_F10, 0, 0, 0, '[pf10]' ], [CODE_F10, 0, 0, 1, '[pf22]' ], [CODE_F11, 0, 0, 0, '[pf11]' ], [CODE_F11, 0, 0, 1, '[pf23]' ], [CODE_F12, 0, 0, 0, '[pf12]' ], [CODE_F12, 0, 0, 1, '[pf24]' ] ];
var CODE_HOME = 36;figure déjà pour ce code touche. Néanmoins, l'ajout de cette entrée serait nécessaire si vous affectiez une touche de clavier qui n'est associée à aucune variable de code touche déjà définie dans KBS.js.
Dans l'environnement client enrichi, les affectations de touches par défaut sont définies dans le fichier plugin.xml du module d'extension d'exécution de la plateforme client enrichi HATS et s'appliquent à toutes les applications HATS client enrichi qui s'exécutent dans le même environnement.
Un contexte de clavier Eclipse est utilisé pour influer sur les commandes disponibles pour l'utilisateur à tout moment. Lorsque l'utilisateur se sert d'une vue de transformation HATS, le contexte de clavier HATS est utilisé. Ce contexte est enregistré dans le fichier plugin.xml du module d'extension d'exécution de la plateforme client enrichi HATS. L'exemple suivant montre la présentation :
<extension
point="org.eclipse.ui.contexts">
<context
name="%KEYBOARD_CONTEXT_NAME"
description="%KEYBOARD_CONTEXT_NAME"
id="com.ibm.hats.rcp.transformationContext"
parentId="org.eclipse.ui.contexts.window">
</context>
</extension>
Les affectations de clavier par défaut sont également définies dans le fichier plugin.xml. L'exemple suivant montre la présentation d'une affectation de touche pour une application HATS exécutée dans Eclipse RCP ou dans Lotus Expeditor dans le fichier plugin.xml :
<extension
point="org.eclipse.ui.commands">
<category
name="%COMMAND_CATEGORY_NAME"
description"%COMMAND_CATEGORY_NAME"
id="com.ibm.hats.rcp.transformationCategory"
</category>
<command
name="[pf1]"
category="com.ibm.hats.rcp.transformationCategory"
id="com.ibm.hats.rcp.send_[pf1]">
</command>
...
</extension>
<extension
point="org.eclipse.ui.bindings">
<key
commandId="com.ibm.hats.rcp.send_[pf1]"
contextId="com.ibm.hats.rcp.transformationContext"
configuration="org.eclipse.ui.defaultAcceleratorConfiguration"
sequence="F1"
</key>
...
</extension>
Les raccourcis clavier personnalisés utilisés pour l'exécution dans Lotus Notes sont séparésdes autres raccourcis clavier personnalisés. Voici les raccourcis clavier équivalents pour l'exemple précédent :
<key
commandId="com.ibm.hats.rcp.send_[pf1]"
contextId="com.ibm.hats.rcp.transformationContext"
schemeId="com.ibm.workplace.notes.hannoverConfiguration"
sequence="F1"
</key>
Voici un exemple d'affectation de la combinaison de touches du clavier Ctrl+Pos1 pour une application client enrichi exécutée dans Eclipse RCP ou dans Lotus Expeditor. Ajoutez d'abord la balise de commande correspondant à [home], et la balise de touche Ctrl+Pos1 au fichier plugin.xml contenu dans le module d'extension d'exécution de la plateforme client enrichi HATS ci-dessous :
<extension
point="org.eclipse.ui.commands">
...
<command
name="[home]"
category="com.ibm.hats.rcp.transformationCategory"
id="com.ibm.hats.rcp.send_[home]">
</command>
...
</extension>
<extension
point="org.eclipse.ui.bindings">
...
<key
commandId="com.ibm.hats.rcp.send_[home]"
contextId="com.ibm.hats.rcp.transformationContext"
configuration="org.eclipse.ui.defaultAcceleratorConfiguration"
sequence="Ctrl+Home"
</key>
...
</extension>
Mettez ensuite à jour le code de la vue de transformation afin que cette dernière sache qu'une nouvelle affectation de touches est enregistrée dans le fichier plugin.xml. Pour cela, modifiez le fichier MainView.java dans votre projet. Ce fichier se trouve dans le dossier \Source\<nom de projet>\views, sous votre projet situé dans la vue Projets HATS. Cliquez deux fois sur le fichier MainView.java pour l'ouvrir dans l'éditeur. Ajoutez la méthode createKeyboardActions à la suite de la méthode MainView comme indiqué ci-dessous :
protected void createKeyboardActions() {
super.createKeyboardActions();
addKeyboardAction("[home]", "com.ibm.hats.rcp.send_[home]");
}
| Comme pour les applications Web HATS, sachez que vous ne pouvez pas réaffecter les touches de modification Ctrl, Alt et Maj pour les applications HATS client enrichi. |
Vous pouvez offrir aux utilisateurs un moyen de configurer les préférences de clavier Eclipse par défaut. Elles sont normalement configurées à partir de la barre de menus à l'aide de Fenêtre > Préférences > Plan de travail > Touches. Si vous offrez cette possibilité aux utilisateurs, ils pourront remplacer les affectations de touches définies dans le module d'extension d'exécution de la plateforme client enrichi HATS.
Vous pouvez ajouter un bouton ou un lien dans le bloc de touches hôte par défaut. Pour ce faire, cliquez sur Paramètres de projet dans l'onglet Rendu, puis sur Bloc de touches hôte. Ce nouveau bouton ou lien s'affichera lors de l'utilisation du bloc de touches par défaut. Pour ajouter un un bouton ou un lien dans un fichier de transformation unique, sélectionnez Insérer le bloc de touches hôte > Touche individuelle lors de l'édition de ce fichier transformation. Pour plus d'informations, voir Touche individuelle. L'interface graphique d'ajout d'un bouton ou d'un lien nécessite un titre et un mnémonique. Dans l'exemple, le titre est Home et le mnémonique est [home]. Si vous souhaitez un support clavier pour ce nouveau bouton, vous devez l'ajouter dans le tableau defaultKeyMappings de KBS.js (pour les applications Web) ou le fichier plugin.xml du module d'extension d'exécution de plateforme client enrichi HATS (pour les applications client enrichi).