ユーザーは、ホスト・アプリケーションとの対話で、物理キーボード上の特殊キー (F1、Attn、Reset、Clear など) を頻繁に使用します。HATS アプリケーションのユーザーがキー・ストロークをホストに送信するには、以下のようにさまざまな方法があります。
この章では、HATS プロジェクトでキーボード・サポートを定義する方法について説明します。また、キーボード・サポートを文書化するためのヒントも示します。
HATS Web プロジェクトでキーボード・サポートを使用するには、サポートされる Web ブラウザーが必要です。サポートされる Web ブラウザーと制約事項のリストについては、HATS インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp) の HATS 前提条件のセクションを参照してください。
HATS プロジェクトでキーボード・サポートを構成するには、そのプロジェクトでキーボード・サポートを使用可能にする必要があります。キーボード・サポートを使用可能にするには、「プロジェクト設定」の「その他」タブで使用可能なオプションを選択します。詳しくは、キーボード・サポートを参照してください。
また、ホスト・キーパッドとアプリケーション・アプリケーションを定義できます。詳細については、ホスト・キーパッドおよび アプリケーション・キーパッドを参照してください。
HATS Web プロジェクトの場合は、「プロジェクト設定」の「レンダリング」タブで「ホスト・キーパッド」と「アプリケーション・キーパッド」設定を使用して、表示するキーと、これらのキーをボタンまたはリンクのいずれとして表示するかを定義します。詳細については、ホスト・キーパッドおよび アプリケーション・キーパッドを参照してください。
特定の HATS Web プロジェクトのキーパッドのスタイルを変更するには、そのキーパッドに対応する Cascading Style Sheet (.css ファイル) を変更します。これは、プロジェクトを構築する際に使用するスタイル・シートになります。Rational® SDP ワークベンチで、HATS Toolkit の「HATS プロジェクト」ビューに進み、プロジェクト名を展開します。 Web Content/Common/Stylesheets を展開します。詳しくは、スタイル・シートの使用を参照してください。
スタイル・シートを変更するには、.css ファイルをダブルクリックしてエディターを開きます。テンプレートでは、スタイル・シートの変更をオーバーライドできます。Cascading Style Sheet の詳細については、http://www.w3.org/Style/CSS/ を参照してください。
カスケード・スタイル・シートでは、次の 7 種類のスタイルを定義します。
HATS リッチ・クライアント・プロジェクトの場合は、「プロジェクト設定」の「レンダリング」タブで「ホスト・キーパッド」設定を使用して、表示するキーと、これらのキーをボタンまたはリンクのいずれとして表示するかを定義します。詳細については、ホスト・キーパッドを参照してください。表示するアプリケーション・レベルのボタンを定義するには、「プロジェクト設定」の「レンダリング」タブの「アプリケーション・キーパッド」を使用します。アプリケーション・レベルのボタンにテキストまたはイメージ、あるいはこの両方のいずれを表示するかを設定するには、「レンダリング」タブの「ツールバー」設定を使用します。詳細については、アプリケーション・キーパッドおよび ツールバー RCP のみ を参照してください。
HATS アプリケーションの使用を促進するために、ユーザー向けにキーボード設定に関する資料を作成することがあります。この資料は、アプリケーションのグラフィカル・ユーザー・インターフェースで作成するか、またはその他の簡単に表示できる形式 (テンプレートのリンクなど) で作成します。エンド・ユーザー用資料には、以下の事項に関する説明を含めてください。
| ボタンまたはボタン・バー | デフォルトの物理キー・マッピング |
|---|---|
| F1 から F12 | F1 から F12 |
| F13 から F24 | Shift + F1 から F12 |
| ENTER | Enter |
| クリア | Esc |
| RESET | Ctrl + R |
| システム要求 | Shift + Esc |
| ATTN | Pause/Break |
| 前ページ | Page Up |
| 次ページ | Page Down |
| PA1 | Alt + Delete |
| PA2 | Alt + End |
| PA3 | Alt + Page Down |
| 印刷 |
Ctrl + P Web のみ Ctrl + Shift + P RCP のみ |
| ヘルプ | Ctrl + H |
| キーボード使用可能/使用不可 | Ctrl + K |
| デフォルト | Alt + Insert |
| 最新表示 | Alt + Page Up |
| HTML フォームのリセット | Ctrl + S |
| 切断 | Ctrl + D |
| 印刷ジョブを表示 | Ctrl + J |
| 反転 | Alt + Enter |
| フィールドの終了 |
Shift + Enter Web のみ
テン・キーの Enter RCP のみ 注:
詳しくは、特殊な 5250 フィールド・キー・サポートを参照してください。 |
| Field+ |
Ctrl + テン・キーのプラス (+) Web のみ テン・キーのプラス (+) RCP のみ |
| Field- |
Ctrl + テン・キーのマイナス (-) Web のみ
テン・キーのマイナス (-) RCP のみ 注:
詳しくは、特殊な 5250 フィールド・キー・サポートを参照してください。 |
HATS Web アプリケーションのデフォルトのフィールド・キー押下の組み合わせを以下にリストします。キーボードの再マップ方法について詳しくは、HATS アプリケーションでのキーボードの再マップを参照してください。
HATS Web アプリケーションで「フィールドの高速終了 (Quick Field Exit)」キーの押下を使用することにより、5250 画面での数値データの入力を高速化することができます。このキー押下は、現行フィールドを現在のキャレット位置からフィールドの末尾まで消去し、カーソル位置を次のフィールドに進めます。このキー押下は任意のフィールドで使用できますが、ユーザーが「フィールドの終了」を使用する可能性がある場所で特に有用です。本来の「フィールドの終了」キーの押下は、データの画面をホストに送信し、HATS 変換を再描画させます。そのため、送信される前に多数の「フィールドの終了」援助機能を必要とする画面では、使用可能度の問題が発生する場合があります。「フィールドの高速終了 (Quick Field Exit)」キーの押下を「フィールドの終了エミュレーション (Field Exit Emulation)」フィーチャーと組み合わせて使用することにより、このようなアプリケーションの速度を大幅に高速化することができます。
リッチ・クライアント・アプリケーションは Web アプリケーションとは異なるアーキテクチャーを採用しているため、リッチ・クライアント・アプリケーションでは「フィールドの高速終了 (Quick Field Exit)」キーの押下は必要ありません。リッチ・クライアント・アプリケーションでは、本来の「フィールドの終了」による往復遅延はありません。
HATS Web アプリケーションで「フィールドの高速マイナス (Quick Field Minus)」キーの押下を使用することにより、5250 画面での負の数値データの入力を高速化することができます。このキー押下は、現行フィールドを現在のキャレット位置からフィールドの末尾まで消去し、フィールド値の前に負符号文字 (-) を付加し、カーソル位置を次のフィールドに進めます。このキー押下は任意のフィールドで使用できますが、ユーザーが「フィールドのマイナス」を使用する可能性のある 5250 符号付き数値フィールドでのみ有効です。本来の「フィールドのマイナス」キーの押下は、データの画面をホストに送信し、変換を再描画させます。そのため、送信される前に多数の「フィールドのマイナス」援助機能を必要とする画面では、使用可能度の問題が発生する場合があります。「フィールドの高速マイナス (Quick Field Minus)」キーの押下を、「負の数値の入力の代替方法 (Alternate way to input negative numbers)」フィーチャーと組み合わせて使用することにより、このようなアプリケーションの速度を大幅に高速化することができます。5250 符号付き数値フィールド以外のフィールドで「フィールドの高速マイナス (Quick Field Minus)」キーの押下を使用すると、不適切なデータ入力が行われる可能性があります。
リッチ・クライアント・アプリケーションは Web アプリケーションとは異なるアーキテクチャーを採用しているため、リッチ・クライアント・アプリケーションでは「フィールドの高速マイナス (Quick Field Minus)」キーの押下は必要ありません。リッチ・クライアント・アプリケーションでは、本来の「フィールドのマイナス」による往復遅延はありません。
5250 符号付き数値フィールドに負の数値を入力するには、「フィールドのマイナス」を使用してサーバーへの往復を実行する代わりに、負符号文字 (-) をフィールドの先頭位置に入力できます。これにより、多数の負の数値を 5250 の符号付き数値フィールドへより迅速に入力できるようになります。HATS サーバーにより、負符号文字 (-) を先頭に付けて入力した 5250 符号付き数値フィールドごとに「フィールドのマイナス」キーの押下がエミュレートされます。すべての不要な事前に入力されたデータは、別のフィールドにタブで移動する前にフィールドからクリアされる必要があります。負符号 (-) を先頭位置に入力しないでください。また、「フィールドのマイナス」、「フィールドのプラス」、または「フィールドの終了」も押さないでください。
このフィーチャーは、「フィールドの終了」援助機能キーを、必要に応じてユーザーに自動的に提供します。「フィールドの終了」援助機能キーは、特定のタイプの 5250 フィールドが変更されたときに必要となります。
例えば、ユーザーが「フィールドの高速終了 (Quick Field Exit)」キーの押下を使用してフィールドからフィールドへ移動し、Enter キーまたはその他の非フィールド援助機能キーを使用して画面を送信する場合、画面が送信されたときにカーソルを含むフィールドに対して、「フィールドの終了」が必要になる場合があります。
この場合、必要な「フィールドの終了」が提供されないと、ホストはエラー・メッセージ 「Enter キーはフィールドで使用できません (Enter key not allowed in field)」を表示する場合があります。 HATS サーバーでは、この HATS フィーチャーを使用して、Enter を送信する前に「フィールドの終了」をホストに送信し、このエラー・メッセージを回避します。
このフィーチャーを使用不可に設定する場合は、以下のステートメントを application.hap ファイルに追加してください。
<class name="com.ibm.hats.common.RuntimeSettings">
<setting name="emulateFieldExit" value="false"/>
</class>
この名前の <class> セクションが既に存在する場合、<setting> 行だけをセクション内に追加してください。
各 HATS アプリケーションは、Host On-Demand 製品のコードを組み込んで、クライアントに代わって Telnet サーバーへの接続を処理します。そのため、ユーザーがホスト・セッションでキーを押す操作を表し、ホスト・コンピューターに送信されるニーモニック・キーワードとして、このガイドでは Host On-Demand の用語を採用しています。
| 機能 | ニーモニック・キーワード |
|---|---|
| アテンション | [attn] |
| 代替ビュー | [altview] |
| クリア | [clear] |
| 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] |
| ホーム | [home] |
| PA1 | [pa1] |
| PA2 | [pa2] |
| PA3 | [pa3] |
| リセット | [reset] |
| システム要求 | [sysreq] |
| 機能 | ニーモニック・キーワード |
|---|---|
| アテンション | [attn] |
| 代替ビュー | [altview] |
| クリア | [clear] |
| 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] |
| フィールドの終了 | [fldext] |
| Field+ | [field+] |
| Field- | [field-] |
| ヘルプ | [help] |
| PA1 | [pa1] |
| PA2 | [pa2] |
| PA3 | [pa3] |
| システム要求 | [sysreq] |
| Page Up | [pageup] |
| Page Down | [pagedn] |
| フィールドの高速終了 (Quick Field Exit) | [qfldext] |
| フィールドの高速マイナス (Quick Field Minus) | [qfld-] |
| リセット | [reset] |
| システム要求 | [sysreq] |
| テスト要求 | [test] |
キーボード上のキーのキー・コード値を判別するには、次の HTML コードをファイルに保存し、Internet Explorer のブラウザー・ウィンドウで開きます。ブラウザーでキーを押すと、そのキーのキー・コード値が表示されます。
<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="Hit any key">
</form>
</center>
</body>
</html>
すべての HATS Web アプリケーションには KBS.js というファイルがあります。このファイルは、ユーザーのキーボードにより生成されるキー・コード値と、ホスト・セッションへ送信されるキー・シグナルとのマップを指定します。HATS キーボードを再マップするには、KBS.js ファイルを編集する必要があります。KBS.js を見つけるには、「ナビゲーター」ビューに移動し、project_name/Web Content/Common ディレクトリーを検索します。KBS.js には、キーボードで押されたキーとホストへ送信されるシグナルの関係を決定する値が 3 つあります。3 つの値を次に示します。
var CODE_F2 = 113;(F2 キーの場合の例)
[CODE_F2, 0, 0, 0, '[pf2]']これにより、ユーザーのキーボードで F2 キーが押されたときに pf2 キー・シグナルがホストへ送信されます。
HATS Web アプリケーションでキー・マッピングを変更する場合は、新規キーまたは既存のキーがニーモニック・キーワードを送信できるように組み合わせを変更または追加します。
| Ctrl、Alt、および Shift 修飾キーは再マップできない点に注意してください。HATS は JavaScript™ を使用し、JavaScript では、これらのキーはキープレスではなく修飾子とみなされます。 |
HATS Web アプリケーションでキーを再マップするために必要な処理は、KBS.js ファイルの上部でキー・コードと defaultKeyMappings 変数を変更することだけです。
キーボード上の Ctrl+Home キーの組み合わせをマップする方法の例を以下に示します。Home キーをホスト・セッションへ送信し、またこの機能用のボタンをご使用の変換に組み込むには、KBS.js を編集してから、変換への追加のキーパッド・ボタンの追加で説明するように、この変換を変更する 2 つのステップが必要です。
ホスト・キーを送信するキーの組み合わせを指定するには、以下に太字イタリック で示されている行を追加して KBS.js ファイルを変更します。
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;エントリーが既に存在しているため、実際には、Home キー用の新規キー・コード変数を追加する必要はないことに注意してください。ただし、KBS.js ですでに定義されているキー・コード変数に関連しないキーボード・キーをマップする場合は、このようなエントリーが必要になります。
リッチ・クライアント環境では、デフォルトのキーボード・マッピングは HATS RCP ランタイム拡張プラグインの plugin.xml ファイルに定義されており、同じ環境で実行されるすべての HATS リッチ・クライアント・アプリケーションに適用されます。
常にユーザーに対して使用可能なコマンドを変更するには、Eclipse キーボード・コンテキストを使用します。ユーザーが HATS 変換ビューを使用している場合は、HATS キーボード・コンテキストが使用されます。このコンテキストは、HATS RCP ランタイム拡張プラグインの plugin.xml ファイルに登録されています。以下の例に、この記述を示します。
<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>
デフォルトのキーボード・マッピングも plugin.xml ファイルで定義されています。以下の例は、Eclipse RCP または Lotus® Expeditor で実行される HATS アプリケーション用のキー・マッピングがこのファイルでどのように記述されるかを示しています。
<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>
Lotus Notes® で実行するためのキー・バインディングは、その他のキー・バインディングとは別です。前の例に相当するキー・バインディングは、次のようになります。
<key
commandId="com.ibm.hats.rcp.send_[pf1]"
contextId="com.ibm.hats.rcp.transformationContext"
schemeId="com.ibm.workplace.notes.hannoverConfiguration"
sequence="F1"
</key>
Eclipse RCP または Lotus Expeditor で実行するリッチ・クライアント・アプリケーション用に、Ctrl+Home キーの組み合わせをキーボードにマップする方法の例を以下に示します。まず、以下に示すように [home] 用のコマンド・タグ、および Ctrl+Home 用のキー・タグを HATS RCP ランタイム拡張プラグイン内の plugin.xml ファイルに追加します。
<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>
次に、変換ビューにより新規キー・マッピングが plugin.xml ファイルに登録されたことが認識されるように、変換ビューのコードを更新します。この更新を行うには、ご使用のプロジェクト内の MainView.java ファイルを編集します。このファイルは、「HATS プロジェクト」ビューのプロジェクトの下にある ¥Source¥<project name>¥views フォルダー内にあります。MainView.java ファイルをダブルクリックして、エディターで開きます。MainView メソッドの次に、以下に示す createKeyboardActions メソッドを追加します。
protected void createKeyboardActions() {
super.createKeyboardActions();
addKeyboardAction("[home]", "com.ibm.hats.rcp.send_[home]");
}
| HATS Web アプリケーションと同様に、HATS リッチ・クライアント・アプリケーションでも Ctrl、Alt、および Shift 修飾キーは再マップできない点に注意してください。 |
ユーザーがデフォルト Eclipse キーボード設定を構成するための手段を提供できます。これは通常、メニュー・バーから「ウィンドウ」>「設定」>「ワークベンチ」>「キー」を使用して構成します。ユーザーに対してこのような手段を提供すると、ユーザーは HATS RCP ランタイム拡張プラグインで定義されているキー・マッピングをオーバーライドできます。
デフォルトのホスト・キーパッドに新規ボタンまたはリンクを追加できます。これは、「プロジェクト設定」の「レンダリング」タブの「ホスト・キーパッド」設定で制御されます。新しいボタンまたはリンクは、デフォルトのホスト・キーパッドが使用されるたびに表示されます。単一の変換に新しいボタンまたはリンクを追加するには、変換の編集時に「ホスト・キーパッドを挿入」>「個別キー」機能を使用します。詳細については、個別キーを参照してください。独自のボタンまたはリンクを追加するための GUI には、表題とニーモニックが必要です。この例では、表題が Home で、ニーモニックが [home] です。この新しいボタンに対するキーボード・サポートが必要な場合、KBS.js defaultKeyMappings テーブル (Web アプリケーション) または HATS RCP ランタイム拡張プラグインの plugin.xml ファイル (リッチ・クライアント・アプリケーション) にそのボタンを追加する必要があります。