Tastaturunterstützung aktivieren

Benutzer interagieren mit Hostanwendungen häufig über spezielle Tasten auf der physischen Tastatur, wie zum Beispiel "F1", "Abruf" (Attn), "Zurücksetzen" (Reset) und "Inhalt löschen" (Clear). Es gibt verschiedene Methoden, mit denen die Benutzer Ihrer HATS-Anwendungen Tastatureingaben an den Host senden können:

In diesem Kapitel wird erläutert, wie die Tastaturunterstützung in Ihrem HATS-Projekt definiert wird. Darüber hinaus enthält es Tipps zur Dokumentation der Tastaturunterstützung für Ihre Benutzer.

Zur Verwendung der Tastaturunterstützung in HATS-Webprojekten müssen Sie einen unterstützten Web-Browser haben. Eine Liste der unterstützten Web-Browser sowie Informationen zu Einschränkungen finden Sie im HATS Information Center unter http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp im Abschnitt "HATS prerequisites".

Tastaturunterstützung definieren

Zur Konfiguration der Tastaturunterstützung in einem HATS-Projekt müssen Sie die Tastaturunterstützung in Ihrem Projekt aktivieren. Die Tastaturunterstützung kann auf der Registerkarte Andere Ihrer Projekteinstellungen durch Auswählen der verfügbaren Optionen aktiviert werden. Weitere Informationen dazu finden Sie in Tastaturunterstützung.

Sie können darüber hinaus auch einen Hosttastenblock und einen Anwendungstastenblock definieren. Weitere Informationen dazu finden Sie in Hosttastenblock und Anwendungstastenblock.

Darstellung der Tastenblöcke ändern

Für HATS-Webprojekte verwenden Sie die Einstellungen für den Hosttastenblock und den Anwendungstastenblock auf der Registerkarte Wiedergabe Ihrer Projekteinstellungen, um die anzuzeigenden Tasten zu definieren und festzulegen, ob sie als Knöpfe oder Links angezeigt werden sollen. Weitere Informationen dazu finden Sie in Hosttastenblock und Anwendungstastenblock.

Zum Ändern der Darstellung eines Tastenblocks für ein bestimmtes HATS-Webprojekt ändern Sie das Cascading Style Sheet (die .css-Datei), das dem Tastenblock entspricht. Dies ist das Style-Sheet, das Sie verwenden, wenn Sie Ihr Projekt erstellen. Rufen Sie in der Rational SDP-Workbench die Sicht HATS-Projekte in HATS Toolkit auf, und erweitern Sie den Projektnamen. Erweitern Sie "Webinhalt/Allgemein/Style-Sheets". Weitere Informationen finden Sie in Style-Sheets verwenden.

Zum Ändern des Style-Sheets klicken Sie doppelt auf die .css-Datei, um den Editor zu öffnen. Beachten Sie, dass Ihre Änderungen an Style-Sheets von Schablonen überschrieben werden können. Weitere Informationen zu Cascading Style Sheets finden Sie unter http://www.w3.org/Style/CSS/.

Das Cascading Style Sheet definiert sieben Darstellungsstile:

table.HostKeypad
Hintergrund für Hosttastenblock
table.ApplicationKeypad
Hintergrund für Anwendungstastenblock
input.HostPFKey
PF-Knöpfe für Hosttastenblock
input.HostButton
Knöpfe für Hosttastenblock
input.ApplicationButton
Knöpfe für Anwendungstastenblock
a.HostKeyLink
Links für Hosttastenblock
a.ApplicationKeyLink
Links für Anwendungstastenblock

Für HATS-Rich-Client-Projekte verwenden Sie die Einstellungen für den Hosttastenblock auf der Registerkarte Wiedergabe Ihrer Projekteinstellungen, um die anzuzeigenden Tasten zu definieren und festzulegen, ob sie als Knöpfe oder Links angezeigt werden sollen. Weitere Informationen finden Sie in Hosttastenblock. Verwenden Sie die Einstellungen für den Anwendungstastenblock auf der Registerkarte Wiedergabe Ihrer Projekteinstellungen, um die anzuzeigenden Knöpfe auf der Anwendungsebene zu definieren. Verwenden Sie die Einstellungen für die Symbolleiste auf der Registerkarte Wiedergabe, um zu definieren, ob die Knöpfe auf der Anwendungsebene Text, ein Bild oder beides anzeigen sollen. Weitere Informationen finden Sie in Anwendungstastenblock und Symbolleiste  Nur RCP .

Dokumentation für Benutzer bereitstellen

Zur Vereinfachung der Verwendung Ihrer HATS-Anwendung kann es sinnvoll sein, die Tastatureinstellungen für Ihre Benutzer zu dokumentieren. Dies kann entweder in der grafischen Benutzerschnittstelle der Anwendung oder in einer anderen leicht anzuzeigenden Form (z. B. als Link in Ihrer Schablone) erfolgen. Ihre Dokumentation sollte folgende Beschreibungen enthalten:

Tabelle 5. Tastenzuordnung in HATS
Knopf in Knopfleiste Physische Standardtastenbelegung
F1 - F12 F1 - F12
F13 - F24 Umschalttaste + F1 - F12
ENTER Eingabetaste (Enter)
CLEAR Esc
RESET Strg + R
SYSREQ Umschalttaste + Esc
ATTN Pause/Untbr
PAGEUP Bild auf
PAGEDN Bild ab
PA1 Alt + Entf
PA2 Alt + Ende
PA3 Alt + Bild ab
PRINT
Strg + P  Nur Web 
Strg + Umschalt + P  Nur RCP 
HELP Strg + H
Tastatur aktivieren/inaktivieren Strg + K
Standard Alt + Einfg
Aktualisieren Alt + Bild auf
HTML-Formular zurücksetzen Strg + S
Verbindung trennen Strg + D
Druckjobs anzeigen Strg + J
Umkehren Alt + Eingabetaste
Feldexit
Umschalttaste + Eingabetaste  Nur Web 
Eingabetaste (Enter)/num. Block  Nur RCP 
Anmerkung:
Weitere Informationen finden Sie in Spezielle Tastenunterstützung für 5250-Felder.
Feld+
Strg + Plustaste auf num. Block  Nur Web 
Plustaste auf num. Block  Nur RCP 
Feld-
Strg + Minustaste auf num. Block  Nur Web 
Minustaste auf num. Block  Nur RCP 
Anmerkung:
Weitere Informationen finden Sie in Spezielle Tastenunterstützung für 5250-Felder.
Anmerkung:
Die Tastenkombination Strg+R ist der Hostfunktion RESET ("Zurücksetzen") für bidirektionale und nicht bidirektionale Sitzungen zugeordnet. Die Tastenkombination Alt+Eingabetaste ist der Funktion REVERSE ("Umkehren") für bidirektionale Sitzungen zugeordnet.

Spezielle Tastenunterstützung für 5250-Felder

Standardtastenkombinationen für Felder

Nachfolgend sind die Standardfeldtastenkombinationen für HATS-Webanwendungen aufgelistet. Informationen dazu, wie die Tastenbelegung der Tastatur geändert wird, finden Sie in Tastaturzuordnung in einer HATS-Anwendung ändern.

Schneller Feldexit

Die Tastenfunktion für schnellen Feldexit kann für HATS-Webanwendungen verwendet werden, um die Eingabe numerischer Daten für 5250-Anzeigen zu beschleunigen. Diese Tastenfunktion löscht den Inhalt des aktuellen Felds ab der aktuellen Winkelzeichenposition bis zum Ende des Felds und rückt die Cursorposition in das nächste Feld vor. Obwohl diese Tastenfunktion in jedem Feld verwendet werden kann, ist sie insbesondere dort nützlich, wo Benutzer ansonsten die Feldexitfunktion verwenden würden. Die normale Feldexittastenfunktion sendet die Anzeige von Daten an den Host und bewirkt, dass die HATS-Umsetzung erneut gezeichnet wird. Infolgedessen können Anzeigen, die viele Feldexit-AID-Tasteneingaben erfordern, bevor sie übergeben werden, Probleme in Bezug auf den Bedienungskomfort verursachen. Die Tastenfunktion zum schnellen Feldexit erhöht in Kombination mit der Feldexitemulationsfunktion die Geschwindigkeit solcher Anwendungen erheblich.

Da Rich-Client-Anwendungen eine andere Architektur als Webanwendungen besitzen, ist die Tastenfunktion für schnellen Feldexit in Rich-Client-Anwendungen nicht erforderlich. Für echte Feldexits in Rich-Client-Anwendungen tritt keine Umlaufverzögerung auf.

Schnelle Feld-Minuseingabe

Die Tastenfunktion für schnelle Feld-Minuseingabe kann für HATS-Webanwendungen verwendet werden, um die Eingabe negativer numerischer Daten für 5250-Anzeigen zu beschleunigen. Diese Tastenfunktion löscht den Inhalt des aktuellen Felds ab der aktuellen Winkelzeichenposition bis zum Ende des Felds, setzt dem Feldwert ein Minuszeichen (-) voran und rückt die Cursorposition in das nächste Feld vor. Obwohl diese Tastenfunktion in jedem Feld verwendet werden kann, ist sie nur in numerischen 5250-Feldern mit Vorzeichen nützlich, in denen Benutzer ansonsten eine normale Feld-Minuseingabe verwenden würden. Die normale Tastenfunktion zur Feld-Minuseingabe sendet die Anzeige von Daten an den Host und bewirkt, dass die Umsetzung erneut gezeichnet wird. Infolgedessen können Anzeigen, die viele Feld-Minus-AID-Tasteneingaben erfordern, bevor sie übergeben werden, Probleme in Bezug auf den Bedienungskomfort verursachen. Die Tastenfunktion für schnelle Feld-Minuseingabe erhöht in Kombination mit der Funktion der alternativen Methode zur Eingabe negativer numerischer Werte die Geschwindigkeit solcher Anwendungen erheblich. Die Verwendung der Tastenfunktion für schnelle Feld-Minuseingabe für andere Felder als numerische 5250-Felder mit Vorzeichen kann zu einer nicht ordnungsgemäßen Dateneingabe führen.

Da Rich-Client-Anwendungen eine andere Architektur als Webanwendungen besitzen, ist die Tastenfunktion für schnelle Feld-Minuseingabe in Rich-Client-Anwendungen nicht erforderlich. Für echte Feld-Minuseingaben in Rich-Client-Anwendungen tritt keine Umlaufverzögerung auf.

Alternative Methode zur Eingabe negativer numerischer Werte

Zur Eingabe eines negativen numerischen Werts in ein numerisches 5250-Feld mit Vorzeichen können Benutzer ein Minuszeichen (-) an der ersten Position des Felds eingeben, anstatt eine Feld-Minustaste zu betätigen und einen Umlauf zum Server zu verursachen. Auf diese Weise können große Mengen negativer numerischer Werte in numerische 5250-Felder mit Vorzeichen schneller eingegeben werden. Der HATS-Server emuliert eine Tastenfunktion zur Feld-Minuseingabe für jedes numerische 5250-Feld mit Vorzeichen, in dem ein führendes Minuszeichen eingegeben wird. Alle unerwünschten vorab eingetragenen Daten müssen aus dem Feld gelöscht werden, bevor mit der Tabulatortaste zu einem anderen Feld gesprungen wird. Benutzer sollten nicht ein Minuszeichen an der ersten Position eingeben und außerdem auch Feld Minus, Feld Plus oder Feldexit drücken.

Feldexitemulation

Diese Funktion gibt automatisch eine Feldexit-AID-Taste für den Benutzer an, wenn erforderlich. Eine Feldexit-AID-Taste ist erforderlich, wenn bestimmte Typen von 5250-Feldern modifiziert werden.

Wenn zum Beispiel ein Benutzer eine Tastenfunktion "Schneller Feldexit" verwendet, um von Feld zu Feld voranzuschreiten, und die Anzeige durch eine Eingabetaste bzw. eine andere Nicht-Feld-AID-Taste übergibt, kann ein Feldexit für das Feld mit dem Cursor erforderlich sein, wenn die Anzeige übergeben wird.

Wenn in diesem Fall ein erforderlicher Feldexit nicht angegeben wird, könnte der Host mit einer Fehlernachricht (Eingabetaste in Feld nicht zulässig) reagieren. Mit dieser HATS-Funktion sendet der HATS-Server einen Feldexit an den Host, bevor die Eingabetaste gesendet wird, sodass die Fehlernachricht vermieden wird.

Wenn Sie diese Funktion inaktivieren wollen, fügen Sie der Datei "application.hap" die folgenden Anweisungen hinzu:

<class name="com.ibm.hats.common.RuntimeSettings">
        <setting name="emulateFieldExit" value="false"/>
</class>

Wenn bereits ein <class>-Abschnitt mit diesem Namen vorhanden ist, fügen Sie lediglich die <setting>-Zeile innerhalb des Abschnitts ein.

Tastaturzuordnung in einer HATS-Anwendung ändern

Vorausgesetzte Konzepte für das Ändern von HATS-Tastenzuordnungen

Jede HATS-Anwendung bettet Code aus dem Host On-Demand-Produkt ein, um die Verbindung zum Telnet-Server für den Client zu verarbeiten. Aus diesem Grund wird in diesem Handbuch die Host On-Demand-Terminologie für mnemonische Schlüsselwörter verwendet, die möglicherweise an den Host-Computer gesendet werden, um die vom Benutzer in der Hostsitzung gedrückten Tasten darzustellen.

Mnemonische Schlüsselwörter

Tabelle der von HATS unterstützten mnemonischen Schlüsselwörter für 3270
Tabelle 6. Mnemonische Schlüsselwörter für gesendete Tasten (SendKeys)
Funktion Mnemonisches Schlüsselwort (bzw. Zeichen)
Abruf (Attention) [attn]
Alternativsicht (Alternate View) [altview]
Inhalt löschen (Clear) [clear]
Eingabetaste (Enter) [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) [home]
PA1 [pa1]
PA2 [pa2]
PA3 [pa3]
Zurücksetzen (Reset) [reset]
Systemanfrage (System Request) [sysreq]
Tabelle der von HATS unterstützten mnemonischen Schlüsselwörter für 5250
Tabelle 7. Mnemonische Schlüsselwörter für gesendete Tasten (SendKeys)
Funktion Mnemonisches Schlüsselwort (bzw. Zeichen)
Abruf (Attention) [attn]
Alternativsicht (Alternate View) [altview]
Inhalt löschen (Clear) [clear]
Eingabetaste (Enter) [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]
Feldexit (Field Exit) [fldext]
Feld+ (Field+) [field+]
Feld- (Field-) [field-]
Hilfe (Help) [help]
PA1 [pa1]
PA2 [pa2]
PA3 [pa3]
Systemanfrage (System Request) [sysreq]
Bild auf [pageup]
Bild ab [pagedn]
Schneller Feldexit (Quick Field Exit) [qfldext]
Schnelle Feld-Minuseingabe (Quick Field Minus) [qfld-]
Zurücksetzen (Reset) [reset]
Systemanfrage (System Request) [sysreq]
Testanforderung (Test Request) [test]

Tastencodewerte ermitteln

Zur Ermittlung der Tastencodewerte für eine Taste auf der Tastatur speichern Sie den folgenden HTML-Code in einer Datei und öffnen sie in einem Fenster des Browsers Internet Explorer. Der Tastencodewert wird für jede in diesem Browser gedrückte Taste angezeigt.

<html>
<head>
<script>
document.onkeydown = keydownhandler;
function keydownhandler()
{
	document.testform.displayField.value = "Tastencode: " + window.event.keyCode;
}
</script>
</head>
<body>
	<center>
		<form name="testform">
			<input type="text" name="displayField" value="Beliebige Taste drücken">
		</form>
	</center>
</body>
</html>

Tastenzuordnung für HATS-Webanwendungen ändern

In jeder HATS-Webanwendung befindet sich eine Datei mit dem Namen "KBS.js", die festlegt, wie die von der Tastatur der Benutzer generierten Tastencodewerte Tastensignalen zugeordnet werden, die an die Hostsitzung gesendet werden. Wenn Sie die Tastenzuordnung der HATS-Tastatur ändern wollen, müssen Sie die Datei "KBS.js" bearbeiten. Sie finden die Datei "KBS.js", indem Sie zur Sicht Navigator wechseln und im Verzeichnis projektname/Webinhalt/Allgemein suchen. In der Datei "KBS.js" befinden sich drei Werte, die die Beziehung zwischen einer beliebigen Taste auf der Tastatur, die gedrückt wird, und dem Signal festlegen, das anschließend an den Host gesendet wird. Bei diesen drei Werten handelt es sich um folgende:

  1. Der Tastencodewert für die gedrückte Taste, die als Ganzzahlvariable in der Datei "KBS.js" dargestellt wird. Beispiel:
    var CODE_F2 = 113; 
    für die Taste F2.
  2. Die Kombination des Tastencodewerts mit dem Alt-, Strg- und Umschalttastenstatus der Tastatur.
  3. Das mnemonische Host On-Demand-Schlüsselwort, das für den Kombinationswert aus Tastencode und Alt-, Strg- und Umschalttastenstatus gesendet wird. Beispiel:
    [CODE_F2, 0, 0, 0, '[pf2]']
    Sendet das Tastensignal "pf2" an den Host, wenn die Taste F2 auf der Tastatur des Benutzers gedrückt wird.

Zur Änderung der Tastenzuordnung in Ihrer HATS-Webanwendung können Sie Kombinationen ändern oder hinzufügen, sodass neue oder vorhandene Tasten das mnemonische Schlüsselwort senden können.

Beachten Sie, dass Sie die Zuordnung der Tasten "Strg" und "Alt" sowie der Umschalttaste und der Kombinationstasten nicht ändern können. HATS arbeitet mit JavaScript™, und JavaScript interpretiert diese Tasten nicht als Funktion gedrückter Tasten, sondern als Tastenmodifikatoren.

Zur Änderung der Tastenzuordnung in HATS-Webanwendungen brauchen Sie nur die Variablen "keycode" (Tastencode) und "defaultKeyMappings" (Standardtastenzuordnungen) am Anfang der Datei "KBS.js" zu ändern.

Anmerkung:
Es bestehen Abhängigkeiten zwischen den in der Datei "KBS.js" aufgelisteten Tasten, dem Status der Tastaturunterstützung in den Projekteinstellungen und der An- bzw. Abwesenheit von Tastenknöpfen, die auf der Anzeige dargestellt werden. Die Regeln, die diese Abhängigkeiten steuern, sind nachfolgend aufgeführt.

  1. Die Tastaturunterstützung kann über die Einstellungen auf der Projektebene konfiguriert werden, um anzugeben, ob sie den Regeln von HATS Version 5 oder früheren Versionen entsprechen soll oder ob sie alle zugeordneten Tasten unabhängig von den angezeigten Knöpfen bzw. Links unterstützen soll. Zur Änderung dieser Einstellungen wechseln Sie zur Sicht HATS-Projekte und klicken doppelt auf die Projekteinstellungen Ihres HATS-Projekts. Wählen Sie anschließend die Registerkarte Andere aus, und klicken Sie auf Tastaturunterstützung. Weitere Informationen finden Sie in Tastaturunterstützung.
  2. HATS zeigt standardmäßig den Anwendungstastenblock, jedoch nicht den Hosttastenblock an. Damit HATS den Hosttastenblock anzeigt, müssen Sie zur Sicht HATS-Projekte wechseln, doppelt auf die Projekteinstellungen Ihres HATS-Projekts klicken, die Registerkarte Wiedergabe auswählen und auf Hosttastenblock klicken. Anschließend können Sie sowohl das Markierungsfeld zum Anzeigen des Hosttastenblocks aktivieren als auch die Tasten auswählen, die angezeigt werden sollen.

Beispiel

Das folgende Beispiel zeigt, wie die Tastenkombination "Strg+Pos1" auf der Tastatur zugeordnet wird. Wenn die Taste "Pos1" (Home) an die Hostsitzung gesendet und außerdem ein Knopf für diese Funktion in Ihrer Umsetzung angezeigt werden soll, sind zwei Schritte erforderlich: Bearbeiten Sie die Datei "KBS.js", und ändern Sie anschließend Ihre Umsetzung wie in Weitere Tastenblockknöpfe einer Umsetzung hinzufügen beschrieben.

Zur Angabe der Tastenkombination, die die Hosttaste sendet, ändern Sie die Datei "KBS.js", indem Sie die nachfolgend fett und kursiv hervorgehobenen Zeilen hinzufügen:

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;
/***********************************************************
 * HINWEIS: ÄNDERN SIE DIE OBIGEN VARIABLEN NICHT!!
 ***********************************************************/

 var defaultKeyMappings = [
 // KEYCODE,       ALT, CTRL, SHIFT, MNEMONIC
 //============ Befehlstastenzuordnungen ============
   [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' ],   
 //============ Funktionstastenzuordnungen ==========
   [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]'      ]
 ];
Anmerkung:
Der Name, der einer neuen Tastencodevariablen (in diesem Beispiel CODE_HOSTHOME) gegeben wird, ist nicht wichtig. Wichtig ist, dass er eindeutig ist und mit dem entsprechenden Eintrag in der Variablenliste "defaultKeyMappings" übereinstimmt. Beachten Sie in diesem Beispiel außerdem, dass das Hinzufügen einer neuen Tastencodevariablen für die Taste "Pos1" (Home) eigentlich nicht erforderlich ist, da der Eintrag
var CODE_HOME = 36;
für den Tastencode der Taste "Pos1" (Home) bereits vorhanden ist. Wenn Sie allerdings eine Tastaturtaste zuordnen wollen, die keiner bereits in der Datei "KBS.js" definierten Tastencodevariablen zugeordnet ist, ist ein solcher Eintrag erforderlich.

Tastenzuordnung für HATS-Rich-Client-Anwendungen ändern

In der Rich-Client-Umgebung sind Standardtastaturzuordnungen in der Datei "plugin.xml" des Plug-ins von HATS RCP Runtime Extension definiert und gelten für alle HATS-Rich-Client-Anwendungen, die in derselben Umgebung ausgeführt werden.

Ein Eclipse-Tastaturkontext dient zur Bestimmung, welche Befehle für den Benutzer zu einem bestimmten Zeitpunkt verfügbar sind. Wenn ein Benutzer eine HATS-Umsetzungssicht verwendet, wird der HATS-Tastaturkontext verwendet. Dieser Kontext ist in der Datei plugin.xml des Plug-ins von HATS RCP Runtime Extension registriert. Das folgende Beispiel zeigt, wie dies aussieht:

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

Die Standardtastaturzuordnungen sind ebenfalls in der Datei plugin.xml definiert. Das folgende Beispiel zeigt, wie eine Tastenzuordnung bei einer in Eclipse RCP oder Lotus Expeditor ausgeführten HATS-Anwendung in dieser Datei aussieht:

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

Die Tastenbelegungen bei der Ausführung in Lotus Notes erfolgen separat von den anderen Tastenbelegungen. Die entsprechende Tastenbelegung für das vorherige Beispiel würde folgendermaßen lauten:

   <key
         commandId="com.ibm.hats.rcp.send_[pf1]"
         contextId="com.ibm.hats.rcp.transformationContext"
         schemeId="com.ibm.workplace.notes.hannoverConfiguration"
         sequence="F1"
   </key>

Beispiel

Das folgende Beispiel zeigt, wie die Tastenkombination "Strg+Pos1" auf der Tastatur für eine Rich-Client-Anwendung zugeordnet wird, die in Eclipse RCP oder Lotus Expeditor ausgeführt wird. Zunächst fügen Sie den "command"-Tag für [home] ("Pos1") und den "key"-Tag für die Tastenkombination "Strg-Pos1" (Ctrl+Home) der Datei "plugin.xml" im Plug-in von HATS RCP Runtime Extension wie nachfolgend gezeigt hinzu:

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

Als Nächstes aktualisieren Sie den Code der Umsetzungssicht, sodass der Sicht mitgeteilt wird, dass eine neue Tastenzuordnung in der Datei "plugin.xml" registriert wurde. Dazu bearbeiten Sie die Datei "MainView.java" in Ihrem Projekt. Diese Datei befindet sich im Ordner \Quelle\<projektname>\views unter Ihrem Projekt in der Sicht "HATS-Projekte". Klicken Sie doppelt auf die Datei "MainView.java", um sie im Editor zu öffnen. Fügen Sie nach der Methode "MainView" die Methode "createKeyboardActions" wie folgt ein:

protected void createKeyboardActions() {
    super.createKeyboardActions();
    addKeyboardAction("[home]", "com.ibm.hats.rcp.send_[home]");
}
Wie auch bei HATS-Webanwendungen sollten Sie beachten, dass die Zuordnung der Tasten "Strg" und "Alt" sowie der Umschalttaste und der Kombinationstasten für HATS-Rich-Client-Anwendungen nicht ändern können.

Sie können eine Methode bereitstellen, mit der Ihre Benutzer die Eclipse-Standardbenutzervorgaben für die Tastatur konfigurieren können. Diese Konfiguration erfolgt normalerweise über die Optionen Fenster > Benutzervorgaben > Workbench > Tasten der Menüleiste. Wenn Sie diese Möglichkeit für Ihre Benutzer bereitstellen, können diese die im Plug-in von HATS RCP Runtime Extension definierten Tastenzuordnungen überschreiben.

Weitere Tastenblockknöpfe einer Umsetzung hinzufügen

Sie können dem Standardhosttastenblock einen neuen Knopf bzw. einen Link hinzufügen. Das Steuerelement für diese Funktion befindet sich unter den Projekteinstellungen auf der Registerkarte Wiedergabe in den Einstellungen für Hosttastenblock. Der neue Knopf bzw. Link wird angezeigt, wenn der Standardhosttastenblock verwendet wird. Sie können einer einzelnen Umsetzung einen neuen Knopf bzw. einen Link hinzufügen, indem Sie die Funktion Hosttastenblock einfügen > Einzelner Knopf/Link bei der Bearbeitung der Umsetzung verwenden. Weitere Informationen finden Sie in Einzelne Taste. Die grafische Benutzerschnittstelle (GUI) zum Hinzufügen eines eigenen Knopfs bzw. Links erfordert eine Beschriftung und ein mnemonisches Zeichen (d. h. ein mnemonisches Schlüsselwort). In diesem Beispiel ist die Beschriftung Home und das mnemonische Zeichen [home]. Wenn Sie die Tastaturunterstützung für diesen neuen Knopf aktivieren wollen, müssen Sie ihn der Tabelle "defaultKeyMappings" in der Datei "KBS.js" (für Webanwendungen) bzw. der Datei "plugin.xml" des Plug-ins von HATS RCP Runtime Extension (für Rich-Client-Anwendungen) hinzufügen.