HATS の「プロジェクトの作成」ウィザードを使用してプロジェクトを作成すると、ウィザードで選択した設定は、プロジェクト・アプリケーション・ファイル (.hap) に保存されます。プロジェクト・エディターを起動するには、「HATS プロジェクト」ビューで、変更するプロジェクトの名前の下の「プロジェクト設定」をダブルクリックします。
プロジェクト・エディターで表示される設定は、プロジェクト全体に使用される設定です。これらの設定のいずれかを変更する場合は、プロジェクト・エディターのタブを使用します。プロジェクト・エディターで変更した内容を保存すると、テスト環境でプロジェクトを実行する際に、アプリケーション・キーパッドで「最新表示」をクリックするか、 GUI で新しいホスト画面を表示することで、その内容が自動的に認識されます。「最新表示」では接続 (.hco) ファイルに対する変更内容が反映されません。接続設定に対する変更は、アプリケーション・サーバー (またはアプリケーション) が再始動すると、適用されます。
以下のセクションでは、プロジェクト・エディターの各タブと、それらのタブを使用してプロジェクト設定を変更する方法について説明します。
プロジェクト・エディターの「概要」タブには、プロジェクトを作成するときに指定したすべての設定の要約が示されます。
「一般情報」セクションには、プロジェクト名と説明、選択されているテンプレートとテーマ、および最終変更日時が記載されています。
プロジェクトのテーマを変更するには、 現在のテーマのリンクをクリックします。提供されているオプションは、「標準」、「最新の Web アプリケーション」 Web のみ または「最新の UI アプリケーション」 RCP のみ 、「従来型端末エミュレーター」、および「カスタム」の 4 つです。設定リストの各機能は、ほかのプロジェクト設定でも有効にできます。このリストは、アプリケーションの外観や振る舞いをテーマとしてまとめて扱うことのできる機能を 1 か所で設定する場合に便利です。
次の表は、各テーマ設定がそれぞれどのようにプロジェクト設定にマップされるかを示したものです。
| テーマ設定 | プロジェクト・エディター・タブ | プロジェクト設定 |
|---|---|---|
| 矢印キー・ナビゲーション RCP のみ | その他 | 「クライアント設定」>「矢印キー・ナビゲーションを使用可能にする」 |
| 自動フィールド進行 | その他 | 「クライアント設定」>「自動フィールド進行を使用可能にする」 |
| 保護フィールド上にあるカーソル | レンダリング | 「ウィジェット」>「フィールド」>「保護フィールド上でのカーソル位置決めを許可します」フィールド |
| フィールド拡張属性 | レンダリング | 「ウィジェット」>「フィールド」>「拡張属性を使用可能にする」 |
| ホスト・キーパッド | レンダリング | 「ホスト・キーパッド」>「デフォルトのホスト・キーパッドを表示」 |
| キーボード・サポート | その他 | 「キーボード・サポート」>「キーボード・サポートを使用可能にする」 |
| オペレーター情報域 | レンダリング | 「オペレーター情報域」>「OIA を表示」 |
| 上書きモード (初期) | その他 | 「クライアント設定」>「上書きモード (初期)」 |
| モノスペース・フォントを使用したレンダリング | レンダリング | 「ウィジェット」>「フィールド」>「モノスペース・フォントを使用してレンダリング」 |
「標準」のテーマで使用できるのは、HATS プロジェクトを最初に作成したときにデフォルトで有効になっている機能です。「最新」のテーマを選択すると、個別の機能はすべて選択解除されます。「従来型」のテーマを選択すると、すべての機能が選択されます。「カスタム」のテーマを選択すると、機能の組み合わせを任意に選択できます。
「テスト」セクションには、プロジェクトのテストに使用できるリンクが含まれています。HATS Web プロジェクトの場合は、次のようなリンクがあります。
HATS ポートレット・プロジェクトの場合は、次のようなリンクがあります。
HATS リッチ・クライアント・プロジェクトの場合は、次のようなリンクがあります。
「デプロイメント」 RCP のみ セクションには、「ターゲット・プラットフォーム」ドロップダウンがあります。リッチ・クライアント・プロジェクトのターゲット・デプロイメントを変更するには、このドロップダウンを使用します。これにより、あるプラットフォームをターゲットとしてビルドを開始したアプリケーションを、後で別のプラットフォーム用に切り替えることができます。サポートされるプラットフォームは、Eclipse リッチ・クライアント・プラットフォーム、Lotus Expeditor Client for Desktop、および Lotus Notes です。
ここで、ターゲット・プラットフォームを変更し、それがワークスペースのターゲット・プラットフォームに一致しない場合、これを通知するメッセージが表示されます。この場合に実行するアクションは、このプロジェクトについて変更したプラットフォームによって異なります。Lotus® Expeditor Client または Lotus Notes® の場合は、Rational® SDP メニュー・バーから、menu bar select 「ウィンドウ」>「設定」>「クライアント・サービス」を選択し、「構成」ボタンをクリックします。「Lotus Expeditor Toolkit 構成 (Lotus Expeditor Toolkit Configuration)」ウィンドウで、「テスト環境 (Test Environment)」ドロップダウン・リストからターゲットを選択できます。Eclipse リッチ・クライアント・プラットフォームの場合、「ウィンドウ」>「設定」>「プラグイン開発 (Plugin-in Development)」>「ターゲット・プラットフォーム」を選択し、「場所」ドロップダウン・リストから Rational SDP インストール・ディレクトリー (デフォルトは C:¥Program Files¥IBM¥SDP) を選択します。ターゲット・プラットフォームを再ロードするようにプロンプトが出されたら、「はい」を選択します。
また、「デプロイメント」セクションには「プラグイン・マニフェストをオープンしてください」というリンクもあり、これで、プロジェクトのプラグイン記述子 (plugin.xml) のエディターが起動します。拡張リッチ・クライアントを開発する場合は、このファイルを変更する必要があります。
「接続」セクション、「レンダリング設定」セクション、および「各種設定」セクションは、それぞれの対応するタブで指定されている設定を要約します。見出し自体が、以下のセクションで説明する対応するタブへのリンクです。
「接続」タブには、プロジェクト接続に関する情報が表示されます。HATS には、デフォルト接続 (変換接続とも呼ばれる) とバックグラウンド接続の 2 つの接続のタイプがあります。各 HATS アプリケーションでは、HATS によって変換される画面を持つホスト・アプリケーション用のデフォルト接続を 1 つ保持しています。バックグラウンド接続とは、プロジェクト内にある、デフォルト接続以外のすべての接続です。 HATS では、バックグラウンド接続からの画面の変換は実行されません。詳しくは、接続の管理を参照してください。
「デフォルト」ドロップダウン・リストからデフォルト・ホスト接続を選択できます。
また、すべてのプロジェクト接続を表示したリスト・テーブルもあります。リストには、接続名、ホスト、ホスト・タイプ、ポート番号、およびコード・ページが表示されます。「追加」ボタンをクリックして追加のプロジェクト接続を追加すると、「接続の作成」ウィザードが起動します。HATS では、プロジェクトに使用可能な接続を複数指定できます。ウィザードの使用の詳細については、接続の作成を参照してください。
既存の接続を編集するには、接続を選択して「編集」をクリックし、接続エディターを起動する必要があります。詳しくは、接続エディターを参照してください。
「除去」ボタンをクリックすると、強調表示された接続が削除されます。「最新表示」をクリックすると、リストが更新されます。
「テンプレート」タブには、変換を囲むためのテンプレートが表示されます。
このタブでは、デフォルト・テンプレートとしていずれのテンプレートを使用するかを変更することができます。画面カスタマイズの操作を使用して特定の画面に異なるテンプレートを指定しない限り、これがアプリケーションのすべての画面に使用されます。
デフォルト・テンプレートは、プロジェクトのすべての変換に適用されるテンプレートとなり、不一致画面イベントのデフォルトのアクションとしてデフォルトの変換を使用してこのテンプレートが適用されます。不一致画面イベントのアクションを変更する方法については、アプリケーション・イベントを参照してください。
画面カスタマイズのアクションを作成または変更するときに、別のテンプレートを選択してデフォルト・テンプレートをオーバーライドすることができます。「テンプレート」タブでテンプレートを編集することもできます。
HATS プロジェクト用のテンプレートを独自に作成できます。詳しくは、「テンプレートの作成」ウィザードを参照してください。
「レンダリング」タブには、 デフォルト・レンダリング、グローバル規則、テキスト置換、コンポーネント、ウィジェット、ツールバー RCP のみ 、アプリケーション・キーパッド、ホスト・キーパッド、およびオペレーター情報域の設定が表示されます。ここでは、HATS プロジェクトのプロジェクト・レベルのデフォルト値を構成できます。
デフォルト・レンダリングは、個別に変換されなかったホスト画面を変換するためのものです。選択済みのデフォルト・レンダリング・セットは、元のホスト画面の構造を保持する一方、GUI の設計の原則を適用することによってアプリケーションの機能を拡張しようとします。つまり、ホスト画面の無保護フィールドを GUI の入力フィールドとしてレンダリングするだけでなく、ファンクション・キーをボタンやリンクに変換したり、選択リストをドロップダウンに変換したり、テーブル領域をテーブルに変換したりすることもできます。
レンダリング・セットは、レンダリング項目の優先順位付きリストを作成することによって構成します。各レンダリング項目は、指定のホスト・コンポーネントを認識し、指定のウィジェットを使用してレンダリングする特定の領域を定義します。例えば、ホスト画面の下部領域にあるファンクション・キーを探し、リンクとしてレンダリングできます。
デフォルトの変換に対して複数のレンダリング・セットを作成できます。レンダリング・セットを追加で作成した場合でも、デフォルトの変換で使用されるレンダリング・セットは、1 つだけです。新規セットを作成するには、「追加」ボタンをクリックして、「レンダリング・セットを追加」ウィンドウを開きます。新しいレンダリング・セットに対して固有の「名前」と 「説明 (オプション)」を指定します。
新規レンダリング・セットをデフォルトにするには、「このレンダリング・セットをデフォルト・レンダリングに使用」チェック・ボックスを選択します。
「空のレンダリング・セットを作成」ボタンを選択してレンダリング・セットをブランクにする (レンダリング項目を定義しない) ことも、「新規レンダリング・セットを既存のセットからコピー」プルダウン・メニューからセットを選択することもできます。リストの横にある「編集」を選択してレンダリング・セットを変更することも、「除去」ボタンを選択して削除することもできます。
以下のリストにあるレンダリング項目は、デフォルト・レンダリング・セットの一部として定義されます。
このプロジェクトのすべての画面について、選択済みレンダリング・セットに新規レンダリング項目を追加できます。また、編集または除去する既存のレンダリング項目を選択し、テーブルの右側にある該当するボタンを選択して、これらの既存のレンダリング項目を編集または除去することもできます。
「追加」ボタンまたは「編集」ボタンを選択した場合は、レンダリング項目の名前および説明を入力します。次に、レンダリング項目を適用する画面領域を定義し、認識に使用するホスト・コンポーネントおよびレンダリングに使用するウィジェットを指定します。また、レンダリング項目の適用順序を変更することもできます。それには、リストで項目を選択し、「上へ」ボタンまたは「下へ」ボタンをクリックしてリストの上または下に移動させます。ウィザードの最後の 2 つのパネルについては、ホスト・コンポーネントを挿入または ホスト・コンポーネントを編集 Web のみ を参照してください。
レンダリング・セットを構成するレンダリング項目のリストは番号付きリストです。 リストの下にある別の項目によっても認識されるホスト画面の一部を各レンダリング項目が消費する場合があるため、リストの順序が重要です。レンダリング項目は、リストの上にあるほど優先順位が高くなります。各レンダリング項目の隣にあるチェック・ボックスを使用すると、選択を使用可能または使用不可にすることができます。
コンポーネントは、必ずしも指定した領域全体を消費するとは限りません。例えば、画面全体で選択リストを検索するように選択リスト・コンポーネントを構成したが、画面の中央で 1 つのリストしか検出されなかったとします。ホスト画面の中央の領域のみが「消費済み」としてマークされます。ホスト画面の残りの「未消費」領域は、引き続き優先順位の低いレンダリング項目によって変換されます。
デフォルト・レンダリング設定でテーブル・コンポーネントを使用する場合は注意してください。これは、テーブル・コンポーネントは選択されている領域でほぼすべての画面を認識し、リスト内のこれより下位のレンダリング項目が認識されないためです。
デフォルト・リストの最後のレンダリング項目 (「残りのテキストおよび入力フィールド」) は、残りのすべての「未消費」画面領域を、フィールド・コンポーネントおよびフィールド・ウィジェットを使用して変換します。この項目は、レンダリング・セットの最後の項目でなければなりません。
通常、デフォルト・レンダリング・セットは、GUI の設計原則を適用することによってアプリケーションの機能を拡張しながら、元のホスト画面の構造を保持しようとします。しかし、ホスト画面のデフォルト・レンダリングをモバイル装置上に表示するために、ある程度のコンパクト化が必要になる場合があります。コンパクト化の過程で HTML およびブランク・スペースの量が減らされた結果、元のホスト画面とは異なる構造の表示になる可能性があります。現在選択されているレンダリング・セットでコンパクト化を使用するように指定するには、「コンパクト・レンダリングの使用」 Web のみ を選択します。
HATS アプリケーションを 1 つ作成し、ユーザーがそのアプリケーションから、互いにまったく異なるように見える 2 つのホスト・アプリケーションにアクセスできるようにしたいと仮定します。この時、各アプリケーションに異なるレンダリング・セットを使用する一方で、HATS のデフォルトのレンダリングを活用して固有の画面カスタマイズをできるだけ少なくしたいと考えたとします。
その場合は、以下の操作によって、これら 2 つのアプリケーション APPA と APPB を呼び出します。
拡張レンダリング設定を変更するには、デフォルト・レンダリング・ツリーを展開して「拡張」をクリックします。
このセクションでは、HATS コンポーネントの変換時にレンダリングの対象が認識されない場合、デフォルト・レンダリングを使用するように指定することができます。この機能は、アプリケーションに含まれる画面に、無保護状態と保護状態を切り替えられるフィールドがある場合には特に便利です。例えば、この機能を使用せず、入力フィールド・コンポーネントによって領域を認識する場合は、フィールドが保護属性状態に切り替わると何も認識されず、レンダリングもされません。
このセクションでは、整形式の HTML をデフォルト・レンダリングで作成するオプションを選択できます。
デフォルト・レンダリングに含まれる HTML の量を減らすために、デフォルトではこのオプションは選択されていません。パフォーマンスが重要になるアプリケーションでは、HTML の量を減らすことが大きな意味を持ちます。しかし、アクセシビリティー用に使用されるスクリーン・リーダー (読み上げソフトウェア) アプリケーションなど、他のアプリケーションではこのオプションの選択が必要になる場合があります。
次回に新規 HATS プロジェクトを作成するときにデフォルトのレンダリング・カスタマイズを表示するには、次のステップを実行します。
Web プロジェクトの場合、完全なファイル・パスは次のとおりです。
<shared_install_directory>¥plugins¥com.ibm.hats_nnn¥predefined¥ projects¥new¥Web Content¥WEB-INF¥profiles¥application.hap
リッチ・クライアント・プロジェクトの場合、完全なファイル・パスは次のとおりです。
<shared_install_directory>¥plugins¥com.ibm.hats_nnn¥predefined¥ projects¥rcp¥new¥profiles¥application.hap上記のファイル・パスで、shared_install_directory は IBM® Installation Manager を使用して HATS オファリングをインストールした共用リソース・ディレクトリー、nnn は HATS のバージョンおよびビルド・レベルです。
グローバル規則を使用すると、ホスト入力フィールドのパターン認識と変換が可能になります。また、 グローバル規則では、カスタマイズした画面、およびカスタマイズしていない (デフォルト・レンダリングの) 画面が処理されます。グローバル規則は、プロジェクト・レベルと、画面レベルの両方で定義できます。プロジェクト・レベルのグローバル規則を指定する場合は、このセクションを使用します。画面レベルのグローバル規則を定義する場合については、グローバル規則を参照してください。
同じ入力フィールドに対してプロジェクト・レベルのグローバル規則と画面レベルのグローバル規則の両方が定義されている場合は、画面レベルの規則が優先されます。
例えば、「Country」というワードが前にあるすべての入力フィールドを、世界各国のコードを含むドロップダウンとしてレンダリングするグローバル規則を作成できます。プロジェクト・レベルのグローバル規則は HATS アプリケーションに対してグローバルです。これらの規則は、レンダリング設定で変換された画面とカスタム変換で変換された画面の両方で機能します。これにより、アプリケーション全体で、変換を一切変更せずにホスト画面の特定のパターンを認識させることができます。
グローバル規則は、構成されたパターン・タイプおよび変換フラグメントから構成されます。パターン・タイプ構成は、ホスト画面で検索するコンテンツの種類を指定します。この操作によって、特定のサイズの特定のフィールドまたはすべてのフィールドを変換したり、指定したストリングに最も近いフィールドを変換できます。例えば、前に「Date」という語がある入力フィールドを認識対象パターンにすることができます。変換フラグメントには、すべての変換におけるパターンのすべての出現箇所を置換する場合に使用されるコンテンツが含まれています。変換フラグメントには、HATS 入力フィールド・コンポーネントおよびカレンダー・ウィジェットを入れることができます。これにより、アプリケーション全体で、前に「Date」という語があるすべての入力フィールドをカレンダー・コントロールとして表示できます。
構成されているグローバル規則は、すべてグローバル規則のテーブルに表示されます。グローバル規則は、すべての「変換を適用」アクションの先頭からこのリストに表示される順序で処理されます。入力フィールドがリストの 1 つのグローバル規則によって認識されると、以降のグローバル規則では認識されなくなります。各項目の隣にあるチェック・ボックスには、項目が使用可能か使用不可かが示されます。
このプロジェクトのグローバル規則のリストにグローバル規則定義を追加するには、「追加」ボタンをクリックします。画面キャプチャーがない場合は、ホスト端末をオープンして画面を取り込むように要求されます。新しいグローバル規則を作成するには、 「名前」、「パッケージ」 (リッチ・クライアント・プロジェクトの場合)、および「説明」を入力し、このグローバル規則を「新規変換フラグメントを作成」と関連付けます。グローバル規則を編集する場合は、「既存の変換フラグメントの使用 (Use an existing transformation fragment)」を実行できます。
次に、使用するパターン・タイプを選択します。選択できるパターン・タイプは以下のとおりです。
「変換」オプションで 「すべての入力フィールド」を選択すると、基準に一致する最初の入力フィールドによって、それ以後のフィールドの検索領域の有効範囲が決まります。次の例では、Enter. というストリングを含む保護フィールドの下にあるすべての入力フィールドに一致すると見なされるフィールドが表示されています。「グローバル規則設定」ウィザードでは、一致するフィールドがすべて強調表示されます。最初に一致したフィールドには、Alpha field (blue) というキャプションが付きます。このフィールドの開始列と終了列によって、その下にあるフィールドのうち、同様に一致と見なされるフィールドが決まります。キャプションが Numeric field (green) のフィールドと Column separators のフィールドは、最初に一致したフィールドより長かったり短かったりするので、一致とは見なされません。キャプションが Date field (pink) のフィールドと、そのすぐ下の 3 つのフィールドは、開始列と終了列が最初に一致したフィールドと同じなので、一致と見なされます。

各パターン・タイプ・コンポーネントは、上記の一連のカスタマイズ可能な設定を含むことができます。設定を変更すると、左側の画面が更新され、一致する入力フィールドが反映されます (複数のフィールドが一致した場合は、複数のフィールドが強調表示されます)。「フィールドの強調表示 (Highlight fields)」オプション以外を選択して、ホスト画面で特定のフィールドを強調表示することもできます。入力フィールドが画面上で定義されている位置を表示するには、「入力」チェック・ボックスを選択します。保護フィールドを表示する場合は、「保護」チェック・ボックスを選択します。隠しフィールドを強調表示するには、「非表示 (Hidden)」チェック・ボックスを選択します。入力フィールド、保護フィールド、または隠しフィールドの強調表示の色を変更する方法については、HATS プリファレンスの使用を参照してください。既存のフラグメントを使用している場合は、「完了」をクリックしてグローバル規則セットを更新し、下記のセクションをスキップします。
新規フラグメントを作成している場合は、ここで変換フラグメントに挿入する HATS コンポーネントを構成する必要があります。グローバル規則の目的は入力フィールドの検出であるため、入力コンポーネントのみが表示されます。このページの構成に使用するホスト画面領域は、直前のページで最初に一致した入力フィールドを囲む選択ボックスによって示されますが、プロジェクト・レベルのグローバル規則は、このホスト画面とその他すべての画面で一致したすべての入力フィールドに対して影響します。コンポーネントおよびウィジェットを選択して、設定を構成します。詳細については、ホスト・コンポーネントを挿入またはホスト・コンポーネントを編集 Web のみ を参照してください。 「完了」をクリックすると、グローバル規則セットが更新され、新規変換フラグメントが 「変換フラグメント」フォルダーに作成されます。ウィザードを完了したら、必ずプロジェクト設定を保存してください。
既存のグローバル規則のコンポーネント設定およびウィジェット設定を変更する必要がある場合は、「レンダリング」タブで「グローバル規則」を選択し、リストから変換フラグメントを選択して、「編集」をクリックします。
最初、変換フラグメントは、「グローバル規則」ウィザードの 3 ページ目で選択した設定に対応する特殊な HATS コンポーネントで作成されます。このコンポーネントは、領域属性を持たない点で特殊です。代わりに、レンダリングする領域を実行時に動的に取得します。このコンポーネントはほかの HATS コンポーネントと同様に編集できますが、ウィザードの最初のページで画面領域ではなくグローバル規則を選択する必要があります。この変換フラグメントには、他の有効な HATS 変換コンテンツを挿入することもできます。
グローバル規則に関連付けられた変換フラグメントを手動で変換する場合は、「レンダリング」タブからエディターを使用する前に手動変換してください。こうすると、誤ったタグが読み取られ、すべての変更が削除されます。
プロジェクト・レベルのグローバル規則と該当する画面レベルのグローバル規則は、どちらも画面イベント変換で適用されます。画面イベント・レベルでは、グローバル規則処理をすべて使用不可にすることができます。使用不可にするには、次のステップを実行します。
HATS アプリケーションでは、ホスト画面のテキスト・ストリングを別のテキスト・ストリング、HTML コンテンツ Web のみ 、またはイメージに変換できます。
「テキスト置換」には、置換されるオリジナル・テキストとともに、置換に使用するテキスト、 HTML コンテンツ Web のみ 、またはイメージを示すテーブルが表示されます。さらに、テキスト検索で大文字と小文字を区別するかどうか、正規表現サポートを使用するかどうかも表示されます。値のテーブルの右側にあるボタンを使用して、テキスト置換の仕様を追加、変更、または除去できます。これらの設定の指定方法の詳細については、テキスト置換を参照してください。
個々のコンポーネントおよびウィジェットについて設定を変更するには、ツリー内で該当項目を展開して、個々のコンポーネントおよびウィジェットを表示します。コンポーネントおよびウィジェットには、カスタマイズ可能な設定がないものもあります。「ホスト・コンポーネントを挿入」ウィザードを使用してカスタマイズできる設定については、コンポーネントおよびウィジェットの設定を参照してください。
コンポーネントおよびウィジェットのプロジェクト設定を変換に挿入するときに、デフォルトのプロジェクト設定をオーバーライドすることができます。これらの変更された設定は、変換内の該当のコンポーネントまたはウィジェットの個別のインスタンスのみに適用されます。プロジェクト内のすべての変換について、そのコンポーネントまたはウィジェット以外のすべてのインスタンスでは、ユーザーが特に変更しない限り、デフォルトのプロジェクト設定が使用されます。例えば、VisualTable コンポーネントに関するデフォルト設定があります。1 つの変換に 2 つの VisualTable コンポーネントを配置し、片方のコンポーネントではプロジェクト設定のデフォルト設定を使用し、もう一方では変更した設定を使用することができます。
「コンポーネント」には、ホスト画面のエレメントを GUI に表示可能なオブジェクトに変換するために使用するホスト・コンポーネントのリストが表示されます。ホスト・コンポーネントの設定では、そのコンポーネントがホスト画面で認識される方法を指定します。一部のコンポーネントは変更できます。ホスト・コンポーネントの詳細については、ホスト・コンポーネントの設定を参照してください。
「ウィジェット」を選択すると、ホスト・コンポーネントを GUI に表示するためにプロジェクトで使用できるすべての HATS ウィジェットのリストが表示されます。一部のウィジェットは変更できます。ウィジェットをカスタマイズするのは、ウィジェットが Web ページ上で表示される方法を指定するためです。変更可能なウィジェットおよび設定については、ウィジェット設定を参照してください。
「ツールバー」設定パネルでは、リッチ・クライアント・アプリケーションの「変換」ビューのツールバーに関連した設定を変更できます。ツールバーには、アプリケーション・キーパッド・アクション (「最新表示」、「デフォルト」など) に加えて、ツールバー・ウィジェットが提供するアクションも配置されています。ツールバー・ウィジェットの詳細については、ツールバー RCP のみ を参照してください。
HATS Web アプリケーションでは、アプリケーション・キーパッドは通常はテンプレートの下部またはサイド・バーに配置されます。HATS リッチ・クライアント・アプリケーションでは、アプリケーション・キーパッドにより提供される機能は「変換」ビューのツールバーにボタンとして配置されます。これによって、HATS リッチ・クライアント・アプリケーションを、リッチ・クライアント環境内の他のアプリケーションと適合させることができます。「変換」ビューのツールバーについて詳しくは、 ツールバーを参照してください。
このパネルでは、「ツールバーを表示」チェック・ボックスを選択したり、クリアしたりできます。選択する場合は、ツールバー項目の表示方法 (「テキスト」、「イメージ」、または「テキストとイメージの両方」) を設定できます。この設定は、ツールバーのすべての項目 (ツールバー・ウィジェットが提供する項目も含む) に適用されます。
デフォルトのアプリケーション・キーパッドは、デフォルト・テンプレートに表示されます。アプリケーション・キーパッドについては、以下の設定をカスタマイズできます。
ホスト・キーパッドについては、以下の設定をカスタマイズできます。
「追加」ボタンをクリックして 「表題」および「ニーモニック」を入力することによって、カスタム・ホスト・キーを追加することもできます。作業が完了したら、「OK」をクリックします。
オペレーター情報域 (OIA) を使用すると、ホスト・アプリケーションの状態を簡単に判断できます。OIA については、以下の設定をカスタマイズできます。
デフォルト接続に DBCS コード・ページが指定されている場合、プロジェクトに DBCS オプションを構成できます。「レンダリング」タブの DBCS 設定について詳しくは、「レンダリング」タブを参照してください。
「イベント」タブには、アプリケーション・イベントのほか、プロジェクトに含まれる優先順位付けされた画面イベント (画面カスタマイズおよび画面組み合わせ) のリストが表示されます。
画面イベントの名前の横にあるチェック・ボックスが選択されている場合、そのイベントはプロジェクトに対して使用可能になっています。画面イベントが使用可能になっていて、かつ、画面認識基準がホスト画面に一致した場合、HATS はそのイベントに指定されているアクションを実行します。画面イベントについての一致検査はそれ以上行われません。画面イベントが使用不可になっている場合、HATS はイベントを無視します。特定の画面イベントをテストする場合、その他の画面イベントは使用不可にすることができます。画面イベントを使用不可にするには、テスト中にチェック・ボックスをクリアします。
HATS アプリケーションでは、使用可能になっている画面イベントのリストに対して、各着信ホスト画面を照らし合わせて検査します。指定の画面に一致する画面イベントが複数ある場合は、画面に一致する最初の画面イベントが適用されます。優先順位が高い画面イベントほど、リストの上部にあります。例えば、いくつかの特定の画面を認識する画面イベントと、より一般的な画面セットを認識する画面イベントがあるとします。リスト内で、後者の画面イベントが前者の画面イベントより上にある場合、画面は、より具体的な基準で認識されて前者の画面イベントに関連するアクションが実行されるのではなく、より一般的な画面認識基準で認識されて関連するアクションが実行されます。
画面イベントの優先順位を変更する場合は、対象となるイベントをクリックして強調表示します。 「上へ」または「下へ」をクリックして、そのイベントをリスト内で上下に移動させます。詳しくは、画面イベントの優先順位を参照してください。
アプリケーション・イベントを編集する場合は、「アプリケーション・イベント」の下で、編集するイベントのリンクをクリックします。詳しくは、アプリケーション・イベントを参照してください。
プロジェクト・エディターの「イベント」タブを使用して、画面イベントの順序を変更できます。詳細については、イベントを参照してください。
HATS アプリケーションの実行中に新規ホスト画面が検出されると、HATS はイベント優先順位リストにある最初の使用可能な画面イベントをチェックして、画面認識基準がホスト画面に一致するかどうかを判断します。一致した場合、画面イベントについてのそれ以上の一致検査は行われず、最初の画面イベントのアクションが実行されます。一致しなかった場合は、リスト内の次の画面イベントをチェックして、画面認識基準がホスト画面に一致するかどうかが判断されます。このようにして、リスト内の最後の画面イベントまでチェックを続行します。
現在のホスト画面に一致する画面認識基準が画面イベントに存在しない場合、HATS にアクションが設定されていて画面がブランクであると、HATS はブランク画面イベントを処理します。それ以外の場合、HATS は一致しない画面イベントを処理します。 HATS の一致しない画面イベントは、ホスト画面に一致する定義済みの画面イベントがない場合にのみ実行される特殊な画面イベントです。このイベントのデフォルト・アクションとして、デフォルト・テンプレートを適用するホスト画面 (デフォルト変換) が表示されます。
ホスト画面がどの画面イベントにも一致しない場合に実行するアクションは変更することができます。例えば、ページが見つからなかったことをユーザーに通知し、ユーザーがその画面に到達した方法についての情報を収集する Web ページを作成することができます。「URL を表示」アクションを使用して、Web ページを表示できます。
一致しない画面イベントのアクションを変更する場合は、「イベント」タブに移動し、「アプリケーション・イベント」セクションの「一致しない画面」をクリックして、エディターを開きます。エディターの下部にある「アクション」タブをクリックしてアクションを表示します。「追加」、「編集」、または「除去」をクリックして、unmatchedScreen.evnt ファイルをカスタマイズします。
HATS が使用する規則ベースのアプローチにより、画面認識イベントに特定のアクションを適用して画面をカスタマイズできます。また、アクションを HATS イベントに関連付けることもできます (アプリケーション・イベントと呼びます)。アプリケーション・イベントには、ホスト・サーバーとの接続および切断、HATS アプリケーションの始動または停止、アプリケーションがエラーまたは認識されていないホスト画面を検出した場合などのアプリケーションのイベントが含まれます。これらのアプリケーション・イベントを構成すると、これらの事態が発生した場合に特定のアクションを実行できます。
アプリケーション・イベントにアクセスするには、「HATS プロジェクト」ビューにアクセスして HATS プロジェクトの「プロジェクト設定」をダブルクリックし、「イベント」タブを選択します。「アプリケーション・イベント」セクションの「イベント」タブで、イベントへのリンクをクリックして該当するエディターを開きます。
各アプリケーション・イベントには、さまざまなアクションが関連付けられています。
以下のリストに、HATS アプリケーション・イベントの説明、およびそのイベントと関連するアクションが発生する場合を示します。
開始イベントには、次のアクションを指定できます。
接続イベントには、以下のアクションを指定できます。
ブランク画面イベントには、次のアクションを指定できます。
ホストに最初に接続したときに受信したブランク画面の処理方法を指定できる特殊な設定もあります。詳しくは、画面処理を参照してください。
一致しない画面イベントには、次のアクションを指定できます。
エラー・イベントには、次のアクションを指定できます。
切断イベントには、以下のアクションを指定できます。
停止イベントには、次のアクションを指定できます。
<?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> 「その他」タブには、キーボード・サポート、クライアント・ロケール、接続パラメーター・オーバーライド、非同期更新、グローバル変数オーバーライド、およびクライアント設定の設定が表示されます。
カスタマイズ設定ツリー内で個々のノードをクリックすることにより、該当のデフォルト・プロジェクト設定をカスタマイズすることができます。
キーボード・サポートについては、以下の設定をカスタマイズできます。
HATS Web プロジェクトでキーボード・サポートを使用するには、サポートされている Web ブラウザーが必要です。サポートされる Web ブラウザーと制約事項のリストについては、HATS インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp) の HATS 前提条件のセクションを参照してください。
以下のオプションから、キーボード・サポートをブラウザー・ページに表示されるファンクション・キーに限定するかどうかを指定します。
ボタンの表題とメッセージは、さまざまな言語で表示できます。表示する言語を獲得するには、以下のクライアント・ロケール設定をカスタマイズします。
HATS では、HATS ホスト接続の接続パラメーターとして Host On-Demand セッション・パラメーターを使用することができます。このパラメーターの詳細については、 Host On-Demand インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/hodhelp/v10r0/index.jsp) にアクセスして「セッション・パラメーター」で検索してください。これらのパラメーターに関する情報は、http://www-01.ibm.com/support/docview.wss?uid=swg21251884 にある資料でも入手できます。
HATS Web アプリケーションの場合、これらの接続パラメーターは、HATS プログラムへのアクセスに使用する URL 上でオーバーライドできます。例えば、以下のような URL を入力できます。
http://servername:port/appname/index.jsp?host=9.42.141.26&sessionType=1&port=523& LUName=LU00001&TNEnhanced=true
サーバー名、ポート、および HATS アプリケーション名に続けて開始ページの index.jsp を指定し、その後に疑問符 (?) を付けて、各パラメーターの名前/値の組 (name=value) をアンパーサンド (&) で区切って指定します。これらの値は、application.hap ファイルの他の場所で使用されている値ではなく、Host On-Demand によって定義されたテキスト値です。例えば、3270 の場合は sessionType=1、5250 の場合は sessionType=2 になります。
Host On-Demand セッション・パラメーターに加え、 SSLP12FilePath パラメーターおよび SSLP12Password パラメーターもオーバーライド可能です。 SSLP12FilePath パラメーターおよび SSLP12Password パラメーターでは、SSL 接続に使用される PKCS12 鍵ストア・ファイルの場所とパスワードを指定します。詳しくは、セキュリティーを参照してください。
HATS ポートレットの接続パラメーターをオーバーライドする方法については、接続パラメーターおよびグローバル変数のオーバーライドを参照してください。
リッチ・クライアント・アプリケーションのユーザーが、「アプリケーション」ビューのポップアップ・メニューにある「プロパティー」項目を使用して接続パラメーターをオーバーライドする方法については、接続パラメーターを参照してください。接続パラメーターのオーバーライドを使用してリッチ・クライアント・アプリケーション・インスタンスをプログラマチックに開始する方法については、「HATS リッチ・クライアント・プラットフォーム・プログラマーズ・ガイド」を参照してください。
接続パラメーターがある場合に、そのうちのどれをオーバーライド可能にするかを制御するには、以下のいずれかのラジオ・ボタンを選択します。
接続パラメーターを追加または除去することによって、選択内容に例外を設けることができます。使用可能な接続パラメーターのリストを取得するには、「追加」ボタンをクリックします。
実行時に接続パラメーターがオーバーライドされると、HATS はそのオーバーライド値を使用して、アプリケーションの作成時に定義されたものとは異なる変換接続を作成します。 HATS がこの新規の変換接続を作成するためのテンプレートとしてどの接続を選択するかは、connectionName 接続パラメーターを指定したかどうかによって決まります。
HATS が基本変換接続を作成する場合は、一部の機能が無効になります (テンプレート接続として選択された接続で有効になっている場合も含む)。基本接続ではプールが常に無効になります。また、接続マクロおよび切断マクロと同様、接続タイムアウトおよび切断タイムアウトが無視されます。テンプレート接続の HOD 接続パラメーター (ホスト名など) およびポートがテンプレート接続からコピーされ、接続パラメーターに対して指定されているすべてのオーバーライドが適用されて、新規の基本変換接続が作成されます。基本接続は常にアプリケーションのデフォルト変換接続を基にしていることに注意してください。
HATS が完全変換接続を作成する場合は、connectionName パラメーターで指定された接続に関連付けられているすべての接続設定 (プール設定、接続マクロおよび切断マクロ、接続タイムアウトおよび切断タイムアウトなど) が使用されます。その後、接続パラメーターのオーバーライドがある場合にはそれらが適用されて、新規の変換接続の作成に使用されるプール仕様が作成されます。
connectionName パラメーターの値としてバックグラウンド接続の名前を指定し、その他のオーバーライドは指定しなかった場合は、事実上、そのアプリケーション・インスタンスの変換接続として使用する接続を切り替えていることになります。
すべての HATS 接続は、プール仕様に基づいています。プール仕様は、その仕様を基に作成されるすべての接続のプロパティーを記述した内部オブジェクトです。実際には HATS Toolkit でプール仕様を作成し、ランタイムではこれらの接続ファイル (main.hco など) を使用して、実際の Telnet 接続を実行時に作成します。接続パラメーターのオーバーライドを指定した場合、HATS ランタイムは新規接続のプロパティーを記述した新規のプール仕様オブジェクトを、必要に応じて動的に作成します。プール仕様は、Web アプリケーションの HATS 管理パネルで参照することができます。プールが無効になっている場合、パラメーターのオーバーライド指定があるために動的に作成されたプール仕様は、connectionName パラメーターが指定されているかどうかとは無関係に、最後のアクティブ接続が終了するとともに自動的に破棄されます。
接続パラメーターのオーバーライドは、HATS アプリケーションにアクセスするユーザーごとに別々に指定することができます。例えば、各ユーザーがそれぞれ別の LUName オーバーライドを指定している場合、HATS ランタイムはユーザーごとに異なるプール仕様を作成します。プール仕様が自動的に破棄されるようにするには、元の接続に対してプールを無効にしてください。複数のユーザーが全く同じオーバーライドを指定した場合はプール仕様が 1 つだけ作成され、それを再利用することで、同一構成を持つ多数の Telnet 接続が作成されます。例えば、複数のユーザーが所属する部門全体で、ある特定のホスト名のオーバーライドが指定されている場合は、新規のプール仕様が 1 つだけ作成され、その仕様を使用する接続がなくなった時点で破棄されます。
connectionName パラメーターを接続パラメーターのオーバーライドとして指定するには、プロジェクト設定エディターの「接続パラメーターのオーバーライド」ページにある「その他」タブで、このパラメーターをオーバーライドに対して有効にしておく必要があります。
HATS では、セッションが切断される前にブラウザーが閉じた場合にホストを自動的に切断する自動切断機能が提供されます。詳しくは、自動切断および最新表示 Web のみ を参照してください。自動切断機能を使用しないアプリケーションでは、disconnectOnClose パラメーターによって同様の機能が実行されます。このパラメーターによって、ユーザーがセッションをホストから手動で切断する前にブラウザーが閉じた場合に、HATS サーバーがホストの Telnet セッションをすぐにリセットできるようになります。ユーザーが「切断」をクリックすると、通常は、切断されます。Telnet セッションのリセットは、元のブラウザーが閉じた場合に新しいブラウザーを起動する隠しフレームをブラウザー内に設定することによって実現されます。新規のブラウザー・ウィンドウは、切断信号を送信してから、閉じます。
この機能は、disconnectOnClose=true が指定されていて、かつ、サポートされているバージョンの Internet Explorer を使用している場合にのみ有効になります。 disconnectOnClose パラメーターの指定には、大/小文字の区別があります。 サンプル URL 要求は、以下のとおりです。
http://hostname/appname/index.jsp?disconnectOnClose=true
appname は、HATS アプリケーションの名前です。
disconnectOnClose parameter パラメーターを使用する場合、以下の条件は真です。
HATS リッチ・クライアント・アプリケーションの場合、非同期更新機能はデフォルトで有効になっています。この機能を無効にするには、「非同期更新を使用可能にする」ボックスをクリアします。非同期更新メカニズムの主な目的は、ホストが新しい画面を送信したために基本のホスト画面が変更された場合に、GUI 表示を自動的に更新することです。これには以下の利点があります。
HATS Web アプリケーションの場合、自動切断および最新表示機能は、AJAX 実装を使用するクライアント・プル・メソッド、またはアプレット実装を使用するサーバー・プッシュ・メソッドのいずれかで実行できます。AJAX 実装を使用可能にするには、「クライアント・プル (AJAX) を使用可能にする」オプションを選択します。アプレット実装を使用可能にするには、「サーバー・プッシュ (アプレット) を使用可能にする」オプションを選択します。これらの機能を両方とも使用不可にするには、「使用不可」を選択します。デフォルトは「使用不可」です。
HATS Web アプリケーションの場合、クライアント・プル (AJAX) 実装メソッドを構成できます。これには、自動切断機能と自動最新表示機能が含まれます。
自動切断機能は、事前に定義された期間ブラウザーが HATS アプリケーションと接触していない場合を検出する機能を提供します。検出されると、ブラウザー・セッションに関連付けられたリソースをクリーンアップしてサーバーの負荷を減らすために、切断処理が実行されます。これを行うために、切断イベントが実行され、切断マクロ (構成されている場合) が実行されます。
自動最新表示機能の目的は、ホストが新しい画面を送信したために基本のホスト画面が変更された場合に、HATS アプリケーションの Web ページ表示を自動的に最新表示することです。これにより、ホストから非同期で変更された画面を表示するためにユーザーが「最新表示」ボタンをクリックする必要はなくなります。
自動最新表示を使用可能にすると、以下の場合には Web ページ表示は自動的には更新されません。
<script> browserRefreshEnabled = false; </script>
サーバー・プッシュ (アプレット) 実装メソッドの場合とは異なり、クライアント・プル (AJAX) メソッドは特定のブラウザーの使用を必要としません。代わりに、HATS によってサポートされるすべてのブラウザーをサポートします。また、サーバー・プッシュ (アプレット) メソッドの場合とは異なり、サーバーへの追加の接続は不要であり、HATS 管理者による構成が簡単になります。クライアント・プル (AJAX) メソッドは、サーバー・プッシュ (アプレット) メソッドと相互に排他的です。クライアント・プル (AJAX) 機能のいずれかが使用可能である場合、サーバー・プッシュ (アプレット) 構成は無視されます。
自動切断機能および自動最新表示機能を構成するには、以下の設定を使用します。
サーバー・プッシュ (アプレット) 実装メソッド (非同期更新アプレットとも呼ばれる) により実行される機能は 2 つあります。
非同期更新アプレットを使用すると、 HATS サーバーからユーザーのブラウザーに変換済みの端末画面を送信するのに使用される接続に加えて、クライアントで稼働するアプレットと HATS サーバーの間に別にソケット接続が確立されます。このソケット接続は、クライアントとサーバー間で容量の小さいメッセージを受け渡しする場合に使用されます。容量の小さいメッセージとは、ホストからの非同期の画面最新表示や、HATS サーバーに対するブラウザーの終了通知に関するものです。このソケット接続のトラフィック量は、通常は非常に少ないものです。このソケット接続をセットアップすると、次のような一連のイベントが発生します。
アプレットを実行するには、Java 対応ブラウザーが必要です。http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp の HATS インフォメーション・センターで、サポートされるブラウザーの最新リストを確認してください。「Contents」の「HATS prerequisites」の下で、「Detailed System Requirements」を選択します。
サーバー・プッシュ (アプレット) 実装メソッドを構成するには、以下の設定を使用します。
ブラウザー側のアプレットでは、TCP/IP ソケットを使用して HATS サーバーと通信します。ソケットを作成するには、HATS アプリケーションをホスティングしているサーバーのホスト名が必要です。HATS がブラウザーの URL によって指定された同じ Web サーバーに配置されている場合、ホスト名パラメーターを指定する必要はありません。アプレットはその Web サーバーの IP アドレスを使用してソケット接続を確立します。 HATS アプリケーションが別のサーバーにある場合、ホスト名パラメーターは、 ホスト名または IP アドレスを使用して指定する必要があります。
アプレットには、ブラウザー固有の設定と Windows 以外のマスクの設定を追加で指定できます。これらの設定を変更するには、application.hap ファイルを編集します。
新規プロジェクトを作成する場合は、<classSettings> タグの Web Content/WEB-INF/profiles/application.hap ファイルにタグが生成されます。 アプレットのデフォルト設定は次のとおりです。
<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>
各パラメーターの概要を以下に示します。
以下のブラウザー関連の設定は、特定のブラウザーまたは環境で使用される機能を決定します。
上にリストしたブラウザー関連の設定に対して、以下の値を使用できます。
Internet Explorer の振る舞いを変更するには、disconnect を disconnectAlways で置き換えます。すると、Internet Explorer のパラメーター・リストは次のように表示されます。
<setting name="ie" value="disconnectAlways|refresh|local"/>.
非同期更新アプレットのクライアント・サイド・トレースを使用可能にするには、 HATS エントリー・サーブレットの Web アドレスで、HTML パラメーター appletJavaConsoleTrace=true を指定する必要があります。例えば、以下のようになります。
http://myhost/myhats/entry?appletJavaConsoleTrace=true
この機能を使用して、ユーザーからアプリケーションにデータを渡すことができます。例えば、ユーザーがユーザー ID とパスワードを入力し、それを使用してマクロを実行するようにできます。
HATS リッチ・クライアント・アプリケーションでは、ユーザーは、「アプリケーション」ビューのポップアップ・メニューの「プロパティー」項目を使用してグローバル変数をオーバーライドします。詳しくは、変数を参照してください。グローバル変数のオーバーライドを使用してリッチ・クライアント・アプリケーション・インスタンスをプログラマチックに開始する方法について詳しくは、「HATS リッチ・クライアント・プラットフォーム・プログラマーズ・ガイド」を参照してください。
HATS ポートレットのグローバル変数をオーバーライドする方法については、接続パラメーターおよびグローバル変数のオーバーライドを参照してください。
HATS Web アプリケーションの場合、ローカル・グローバル変数をオーバーライドするには、HTML パラメーター hatsgv_varName=newValue をクライアントの HTTP 要求に追加します。共用グローバル変数をオーバーライドするには、パラメーター名を hatssharedgv_varName にします。
ユーザーが UserID という名前の共用グローバル変数の値を作成および設定できるようにするには、変換 JSP の <HATS:Form> タグの本文に以下の記述を追加して、入力フィールドを用意します。
<INPUT name="hatssharedgv_UserID" type="TEXT" size="10">
ユーザーが入力した値が、共用変数 UserID の新規の値になります。 JavaScript によって値を作成し、ユーザーに新規の値を入力させない場合は、隠し入力フィールドを使用して値を自動的に設定します。
<INPUT name="hatssharedgv_UserID" size="10" type="HIDDEN" value="alice">
グローバル変数を新規作成したり、URL 内のグローバル変数の値を変更したりするには、GET 要求で次の URL のような URL を使用できます。
http://hostname/appname/entry?hatsgv_UserID=bob
ユーザーのクライアント要求によって作成または変更できる HATS グローバル変数を制御するには (存在する場合)、以下のラジオ・ボタンの 1 つをクリックします。
グローバル変数の例外を追加するには、「追加」ボタンをクリックします。この画面では、テキスト・ボックスにグローバル変数名を入力するか、ドロップダウン・リストから選択できます。共用可能なグローバル変数であることを示すには、「共用グローバル変数」チェック・ボックスを選択します。詳しくは、グローバル変数との対話を参照してください。
テーブルのエントリーを編集する場合は、「編集」をクリックします。「除去」ボタンを押すと、強調表示されたグローバル変数が例外のリストから削除されます。
次のクライアント設定をカスタマイズできます。
+--------------------------------------+ 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
このボックスをクリアすると、変更済みの入力フィールドの内容がホストが提供するデータと同じ場合でも、HATS はその入力フィールドのデータを送信します。例えば、ホストがフィールドに ABC を設定していて、ユーザーがそのフィールドに ABC と入力した場合でも、入力されたデータはホストに返されます。
このチェック・ボックスをクリアすると、デフォルトのタブ移動順序には保護された読み取り専用フィールドは含まれません。
Web アプリケーションでは、変換ファイルの </HATS:Form> タグの直後に以下の行を追加することで、個々の変換ごとにこの機能を使用不可にすることもできます。この機能を使用可能にする場合は、false の代わりに true を指定してください。
<script> autoAdvance = false; </script>
リッチ・クライアント・アプリケーションでは、以下のように個々の変換で needsAutoAdvanceSupport メソッドをオーバーライドすることで、変換ごとにこの機能を使用不可にすることができます。この機能を使用可能にする場合は、false の代わりに true を戻します。
public boolean needsAutoAdvanceSupport(boolean preferredValue) {
return false;
}
この設定を使用する場合の DBCS の考慮事項については、 自動フィールド進行を使用可能にするを参照してください。
このボックスをクリアすると、自動拡張を有効にしたときに、ホスト画面の入力フィールドの順で、フォーカスが自動的に次の入力フィールドに移ります。
Web アプリケーションの場合、変換でこのフィーチャーを使用可能にするには、変換の </HATS:Form> タグの直後に以下の行を追加します。
<script> initialInputFocusFromCursor = false; </script>
リッチ・クライアント・アプリケーションの場合、変換でこのフィーチャーを使用可能にするには、以下のように個々の変換に対して isInitialFocusAtCursorPosition メソッドをオーバーライドします。
public boolean isInitialFocusAtCursorPosition() {
return false;
}<class name="com.ibm.hats.common.RuntimeSettings">
<setting name="nextFieldForDropDown" value="true"/>
</class>
この設定を使用する場合の DBCS の考慮事項については、上書きモード (初期)を参照してください。
この設定を使用する場合の DBCS の考慮事項については、フォーカスされたテキストをすべて選択するを参照してください。
各変換の needsArrowKeyNavigationSupport メソッドを以下のようにオーバーライドすることにより、この機能を個々の変換について選択的に無効化することができます。
public boolean needsArrowKeyNavigationSupport(boolean preferredValue) {
return false;
}
この機能を使用可能にする場合は、false の代わりに true を戻します。
これらの設定は、HATS 標準 (JSR 168) ポートレット・プロジェクトにのみ適用されます。これらは、ポートレット通信ソリューションを開発する手助けとして使用できます。詳しくは、ポートレット通信を参照してください。
これらの設定を使用して、ポータル・サーバー上の他の JSR 168 ポートレット (HATS または非 HATS) から WebSphere Portal を介して受信するプロパティーを定義します。新規プロパティーを追加するには、「追加」をクリックします。「プロパティー」フィールドに、受信するプロパティーの名前を入力します。 名前は、送信ポートレットで使用されるプロパティー名に一致する必要があります。例えば、HATS JSR 168 送信ポートレットの「グローバル変数の送信」アクションで使用されているプロパティー名と同じにします。 「グローバル変数」フィールドに、受信したプロパティーの値を格納するために使用するグローバル変数の名前を入力します。グローバル変数が索引付きである場合は、使用する索引を入力します。グローバル変数が共用グローバル変数である場合は、「共用」チェック・ボックスを選択します。
「完了」をクリックすると、プロジェクトの application.hap ファイルにプロパティーが追加されます。また、Web サービス記述言語 (WSDL) ファイルがまだない場合は作成され、その WSDL ファイルに受信プロパティーが定義されます。 WSDL ファイルの名前は <project_name>.wsdl です。 WSDL ファイルは、WebSphere Portal ワイヤリング・ツールを使用してポートレットをワイヤリングするために必要です。 portlet.xml ファイルは、WSDL ファイルの場所を参照するように更新されます。
「除去」をクリックした場合、プロジェクトの application.hap ファイルからはプロパティーが除去されますが、WSDL ファイルからは除去されません。 WSDL ファイルを編集し、WSDL エディターを使用してプロパティーを除去できます。
「ソース」タブには、プロジェクト内のすべての設定 (自分で選択したもの、またはデフォルトを受け入れたもの) について、application.hap ファイルのタグと値が表示されます。プロジェクト・エディターの他のタブを変更すると、「ソース」タブに表示されるタグと値もそれに合わせて変化します。
「ソース」タブのソースを編集することにより、application.hap ファイルのタグと値を直接変更することもできます。この変更は、プロジェクト・エディターの適切なタブに反映されます。
「HATS プリファレンス」を使用して、HATS Toolkit の外観および動作を制御できます。これらのプリファレンスによって、HATS Toolkit へのアクセスが容易になり、プログラミング・タスクが単純化されます。HATS プリファレンスを処理するには、「ウィンドウ」>「設定」をクリックして、ツリー・ビューで「HATS」を選択します。プリファレンスに関する即時ヘルプを参照するには、その場所にカーソルを置いて F1 を押します。
以下のプリファレンスを変更できます。
この設定は、Java「HATS プロジェクト」ビューの 「Java ソース」フォルダーの表示内容には影響を与えません。
HATS はワークスペースの始動時にプロジェクトのライセンス設定をチェックし、マスター・ライセンス設定と一致しないプロジェクトがある場合は、ユーザーにライセンス設定の更新を求めるプロンプトを表示します。このチェック・ボックスをクリアすると、始動時にライセンス設定を確認することはできません。
HATS に関連した動作を制御するためのプリファレンスはほかにもあります。これらのプリファレンスを使用するには、プリファレンス・ツリーで HATS を展開し、以下のサブカテゴリーの 1 つをクリックします。
新規成果物にパッケージ名を作成する場合、 {project name} にはプロジェクトの名前が入ります。このような置換が行われるのは、有効なパッケージ名を確実に作成するためです (例えば、スペースは下線に変換されます)。
HATS プリファレンスを変更した場合、「適用」をクリックして即時 HATS Toolkit にその結果を表示することができます。新しいプリファレンスを保存して「プリファレンス」ウィンドウをクローズするには「OK」をクリックします。保存せずに終了するには「キャンセル」をクリックします。「キャンセル」 をクリックした場合は、「適用」をクリックした後に行った変更内容のみがキャンセルされます。
HATS プリファレンスを初期値に戻すには、「デフォルトの復元 (Restore defaults)」をクリックします。
ある HATS Toolkit で HATS プリファレンスを構成し、そのプリファレンスをほかの開発ワークステーションにコピーする場合、Rational SDP メニュー・バーから「ファイル」>「エクスポート」>「一般」>「設定」を選択して、プリファレンスを .epf ファイルとして保存します。このファイルを使用する各ワークステーションに転送したり、ネットワーク経由で使用可能にすることができます。「ファイル」>「インポート」>「一般」>「設定」を選択し、設定ファイルをインポートします。
HATS Toolkit の外観と振る舞いは、Rational SDP で選択できる他のプリファレンスを使用することによって影響を受ける場合もあります。
例えば、「ラベル装飾」プリファレンスを使用すると、他のツールキット (Java コンパイルおよび CVS など) で、「HATS プロジェクト」ビューに表示される HATS ラベルおよびイメージを装飾することができます。エラーが発生した場合に、ファイルの横に赤いマークを表示することができます。CVS リポジトリーからファイルをチェックアウトする場合に、ファイル名の横にバージョン番号を表示できます。Rational Application Developer で「ラベル装飾」プリファレンスにアクセスする手順は次のとおりです。