Activation du support clavier

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.

Définition du support clavier

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.

Modification de la présentation des blocs de touches

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 :

table.HostKeypad
Fond du bloc de touches hôte
table.ApplicationKeypad
Fond du bloc de touches application
input.HostPFKey
Boutons PF du bloc de touches hôte
input.HostButton
Boutons du bloc de touches hôte
input.ApplicationButton
Boutons du bloc de touches application
a.HostKeyLink
Liens du bloc de touches hôte
a.ApplicationKeyLink
Liens du bloc de touches application

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 .

Documentation pour les utilisateurs

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 :

Tableau 5. Affectation des touches dans HATS
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.
Remarque :
La combinaison de touches Ctrl+R correspond à une restauration de l'hôte pour les sessions bidirectionnelles et non bidirectionnelles ; la combinaison de touches Alt+Entrée permet quant à elle d'effectuer une inversion dans le cas de sessions bidirectionnelles.

Support de touche de zone 5250 particulier

Combinaisons de touches de la zone par défaut

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

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.

Quick Field Minus

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.

Méthode alternative pour l'entrée de nombres négatifs

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.

Emulation de fin de 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.

Réaffectation des touches du clavier dans une application HATS

Concepts à connaître avant de réaffecter des touches dans HATS

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.

Mots clés mnémoniques

Tableau des mots clés mnémoniques 3270 pris en charge par HATS
Tableau 6. Mots clés mnémoniques pour touches d'envoi
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]
Tableau des mots clés mnémoniques 5250 pris en charge par HATS
Tableau 7. Mots clés mnémoniques pour touches d'envoi
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]

Détermination des valeurs de code touche

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>

Réaffectation des touches pour les applications Web HATS

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 :

  1. La valeur de code touche correspondant à la touche actionnée, représentée sous la forme d'une variable entière dans le fichier KBS.js. Exemple :
    var CODE_F2        = 113; 
    pour la touche F2
  2. La combinaison de la valeur de code touche et des états Alt, Ctrl et Maj du clavier.
  3. Le mot clé ménmonique Host On-Demand envoyé pour la combinaison valeur de code touche et les états Alt, Ctrl et Maj. Exemple :
    [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.

Remarque :
Il existe des dépendances entre les touches répertoriées dans le fichier KBS.js, l'état du support clavier dans les paramètres de projet, et la présence ou l'absence de boutons de touche indiqués à l'écran. Les règles qui régissent ces dépendances sont décrites ci-après.

  1. Vous pouvez définir le support clavier au niveau des paramètres d'un projet et indiquer s'il doit respecter les règles de HATS version 5 ou antérieure, ou s'il doit prendre en charge toutes les touches affectées, quels que soient les boutons ou les liens affichés. Pour modifier ces paramètres, accédez à la vue Projets HATS et cliquez deux fois sur les Paramètres de projet de votre projet HATS, sélectionnez l'onglet Autre et cliquez sur Support clavier. Pour plus d'informations, voir Support clavier.
  2. Par défaut, HATS affiche le bloc de touches application mais pas le bloc de touches hôte. Pour que HATS affiche le bloc de touches hôte, vous devez accéder à la vue Projets HATS et cliquer deux fois sur Paramètres de projet pour votre projet HATS, sélectionner l'onglet Rendu et cliquer sur Bloc de touches hôte. Vous pouvez ensuite activer une option permettant d'afficher le bloc de touches hôte et de sélectionner les touches à afficher.

Exemple

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]'      ]
 ];
Remarque :
Le nom attribué à chaque nouvelle variable de code touche (CODE_HOSTHOME dans cet exemple) a peu d'importance ; il doit simplement être unique et correspondre à une entrée de la liste de variables defaultKeyMappings. Vous remarquerez également dans cet exemple qu'il n'est pas nécessaire d'ajouter une nouvelle variable de code touche pour la touche Pos1 (Home) car l'entrée
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.

Réaffectation des touches pour les applications HATS client enrichi

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>

Exemple

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.

Ajout de boutons de bloc de touches supplémentaires dans une transformation

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).