HATS プロジェクトの変更

HATS の「プロジェクトの作成」ウィザードを使用してプロジェクトを作成すると、ウィザードで選択した設定は、プロジェクト・アプリケーション・ファイル (.hap) に保存されます。プロジェクト・エディターを起動するには、「HATS プロジェクト」ビューで、変更するプロジェクトの名前の下の「プロジェクト設定」をダブルクリックします。

プロジェクト・エディターで表示される設定は、プロジェクト全体に使用される設定です。これらの設定のいずれかを変更する場合は、プロジェクト・エディターのタブを使用します。プロジェクト・エディターで変更した内容を保存すると、テスト環境でプロジェクトを実行する際に、アプリケーション・キーパッドで「最新表示」をクリックするか、 GUI で新しいホスト画面を表示することで、その内容が自動的に認識されます。「最新表示」では接続 (.hco) ファイルに対する変更内容が反映されません。接続設定に対する変更は、アプリケーション・サーバー (またはアプリケーション) が再始動すると、適用されます。

注:
HATS プロジェクト全体に使用する設定を、HATS 全体に適用する設定と混同しないでください。HATS 全体の設定は、「ウィンドウ」>「設定」>「HATS」から適用できます。

以下のセクションでは、プロジェクト・エディターの各タブと、それらのタブを使用してプロジェクト設定を変更する方法について説明します。

概要

プロジェクト・エディターの「概要」タブには、プロジェクトを作成するときに指定したすべての設定の要約が示されます。

「一般情報」セクションには、プロジェクト名と説明、選択されているテンプレートとテーマ、および最終変更日時が記載されています。

注:
モバイル装置用に最適化されたプロジェクトの場合、テーマは表示されません。詳しくは、モバイル装置用の HATS アプリケーションの作成を参照してください。

プロジェクトのテーマを変更するには、 現在のテーマのリンクをクリックします。提供されているオプションは、「標準」、「最新の Web アプリケーション」  Web のみ  または「最新の UI アプリケーション」  RCP のみ 、「従来型端末エミュレーター」、および「カスタム」の 4 つです。設定リストの各機能は、ほかのプロジェクト設定でも有効にできます。このリストは、アプリケーションの外観や振る舞いをテーマとしてまとめて扱うことのできる機能を 1 か所で設定する場合に便利です。

次の表は、各テーマ設定がそれぞれどのようにプロジェクト設定にマップされるかを示したものです。

表 1. テーマ設定のプロジェクト設定へのマップ
テーマ設定 プロジェクト・エディター・タブ プロジェクト設定
矢印キー・ナビゲーション  RCP のみ  その他 「クライアント設定」>「矢印キー・ナビゲーションを使用可能にする」
自動フィールド進行 その他 「クライアント設定」>「自動フィールド進行を使用可能にする」
保護フィールド上にあるカーソル レンダリング 「ウィジェット」>「フィールド」>「保護フィールド上でのカーソル位置決めを許可します」フィールド
フィールド拡張属性 レンダリング 「ウィジェット」>「フィールド」>「拡張属性を使用可能にする」
ホスト・キーパッド レンダリング 「ホスト・キーパッド」>「デフォルトのホスト・キーパッドを表示」
キーボード・サポート その他 「キーボード・サポート」>「キーボード・サポートを使用可能にする」
オペレーター情報域 レンダリング 「オペレーター情報域」>「OIA を表示」
上書きモード (初期) その他 「クライアント設定」>「上書きモード (初期)」
モノスペース・フォントを使用したレンダリング レンダリング 「ウィジェット」>「フィールド」>「モノスペース・フォントを使用してレンダリング」

「標準」のテーマで使用できるのは、HATS プロジェクトを最初に作成したときにデフォルトで有効になっている機能です。「最新」のテーマを選択すると、個別の機能はすべて選択解除されます。「従来型」のテーマを選択すると、すべての機能が選択されます。「カスタム」のテーマを選択すると、機能の組み合わせを任意に選択できます。

注:
DBCS サポートを使用する場合のテーマ設定について詳しくは、プロジェクト・テーマの設定を参照してください。

「テスト」セクションには、プロジェクトのテストに使用できるリンクが含まれています。HATS Web プロジェクトの場合は、次のようなリンクがあります。

HATS ポートレット・プロジェクトの場合は、次のようなリンクがあります。

HATS リッチ・クライアント・プロジェクトの場合は、次のようなリンクがあります。

注:
  1. これらのリンクのいずれかをクリックすると、「HATS プロジェクト」ビューでプロジェクトを右クリックし、 「サーバーで実行」 (リッチ・クライアントの場合は「実行」) または 「サーバーでデバッグ」 (リッチ・クライアントの場合は「デバッグ」) を選択した場合と同じ操作が実行されます。
  2. モードのテストについて詳しくは、「HATS スタートアップ・ガイド」の『プロジェクトのテスト』を参照してください。
  3. HATS ポートレットのテストについて詳しくは、 HATS ポートレットのテストを参照してください。
  4. 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 では、プロジェクトに使用可能な接続を複数指定できます。ウィザードの使用の詳細については、接続の作成を参照してください。

注:
双方向 (bidi) コード・ページを選択した場合は、HATS ファイルへの追加を参照してください。

既存の接続を編集するには、接続を選択して「編集」をクリックし、接続エディターを起動する必要があります。詳しくは、接続エディターを参照してください。

「除去」ボタンをクリックすると、強調表示された接続が削除されます。「最新表示」をクリックすると、リストが更新されます。

テンプレート

「テンプレート」タブには、変換を囲むためのテンプレートが表示されます。

このタブでは、デフォルト・テンプレートとしていずれのテンプレートを使用するかを変更することができます。画面カスタマイズの操作を使用して特定の画面に異なるテンプレートを指定しない限り、これがアプリケーションのすべての画面に使用されます。

注:
新規に提供されたテンプレートには、アスタリスクでマークが付けられています。

デフォルト・テンプレートは、プロジェクトのすべての変換に適用されるテンプレートとなり、不一致画面イベントのデフォルトのアクションとしてデフォルトの変換を使用してこのテンプレートが適用されます。不一致画面イベントのアクションを変更する方法については、アプリケーション・イベントを参照してください。

画面カスタマイズのアクションを作成または変更するときに、別のテンプレートを選択してデフォルト・テンプレートをオーバーライドすることができます。「テンプレート」タブでテンプレートを編集することもできます。

HATS プロジェクト用のテンプレートを独自に作成できます。詳しくは、「テンプレートの作成」ウィザードを参照してください。

レンダリング

「レンダリング」タブには、 デフォルト・レンダリング、グローバル規則、テキスト置換、コンポーネント、ウィジェット、ツールバー  RCP のみ 、アプリケーション・キーパッド、ホスト・キーパッド、およびオペレーター情報域の設定が表示されます。ここでは、HATS プロジェクトのプロジェクト・レベルのデフォルト値を構成できます。

デフォルト・レンダリング

デフォルト・レンダリングは、個別に変換されなかったホスト画面を変換するためのものです。選択済みのデフォルト・レンダリング・セットは、元のホスト画面の構造を保持する一方、GUI の設計の原則を適用することによってアプリケーションの機能を拡張しようとします。つまり、ホスト画面の無保護フィールドを GUI の入力フィールドとしてレンダリングするだけでなく、ファンクション・キーをボタンやリンクに変換したり、選択リストをドロップダウンに変換したり、テーブル領域をテーブルに変換したりすることもできます。

注:
  1. ホスト画面用の個々の変換を作成する場合は、デフォルト・レンダリングを事前にその変換に取り込むことができます。詳しくは、「変換の作成」ウィザードを参照してください。
  2. また、デフォルト・レンダリングをあとで変換に挿入することもできます。詳しくは、デフォルト・レンダリングを挿入を参照してください。

レンダリング・セットは、レンダリング項目の優先順位付きリストを作成することによって構成します。各レンダリング項目は、指定のホスト・コンポーネントを認識し、指定のウィジェットを使用してレンダリングする特定の領域を定義します。例えば、ホスト画面の下部領域にあるファンクション・キーを探し、リンクとしてレンダリングできます。

デフォルトの変換に対して複数のレンダリング・セットを作成できます。レンダリング・セットを追加で作成した場合でも、デフォルトの変換で使用されるレンダリング・セットは、1 つだけです。新規セットを作成するには、「追加」ボタンをクリックして、「レンダリング・セットを追加」ウィンドウを開きます。新しいレンダリング・セットに対して固有の「名前」と 「説明 (オプション)」を指定します。

新規レンダリング・セットをデフォルトにするには、「このレンダリング・セットをデフォルト・レンダリングに使用」チェック・ボックスを選択します。

「空のレンダリング・セットを作成」ボタンを選択してレンダリング・セットをブランクにする (レンダリング項目を定義しない) ことも、「新規レンダリング・セットを既存のセットからコピー」プルダウン・メニューからセットを選択することもできます。リストの横にある「編集」を選択してレンダリング・セットを変更することも、「除去」ボタンを選択して削除することもできます。

以下のリストにあるレンダリング項目は、デフォルト・レンダリング・セットの一部として定義されます。

注:
  1. ENPTUI レンダリング項目は、使用するホストが 5250 または 5250W で、 HATS プロジェクトの初期作成時に「グラフィカル・インターフェース DDS キーワード (ENPTUI) レンダリング・サポートの追加」チェック・ボックスを選択して ENPTUI サポートを使用可能にした場合にのみ表示されます。
  2. ライト・ペン・レンダリング項目は、使用するホストが 3270 または 3270E で、 HATS プロジェクトの初期作成時に「ライト・ペン・レンダリング・サポートの追加」チェック・ボックスを選択してライト・ペン・サポートを使用可能にした場合にのみ表示されます。

このプロジェクトのすべての画面について、選択済みレンダリング・セットに新規レンダリング項目を追加できます。また、編集または除去する既存のレンダリング項目を選択し、テーブルの右側にある該当するボタンを選択して、これらの既存のレンダリング項目を編集または除去することもできます。

「追加」ボタンまたは「編集」ボタンを選択した場合は、レンダリング項目の名前および説明を入力します。次に、レンダリング項目を適用する画面領域を定義し、認識に使用するホスト・コンポーネントおよびレンダリングに使用するウィジェットを指定します。また、レンダリング項目の適用順序を変更することもできます。それには、リストで項目を選択し、「上へ」ボタンまたは「下へ」ボタンをクリックしてリストの上または下に移動させます。ウィザードの最後の 2 つのパネルについては、ホスト・コンポーネントを挿入または ホスト・コンポーネントを編集  Web のみ を参照してください。

注:
ダイアログ・コンポーネントは、ホスト画面でモーダル・フレーム (ポップアップ・フレーム) を認識してレンダリングするための特殊なコンポーネントです。ただし、ダイアログ・コンポーネントを使用して、モーダル・フレーム・ホスト・コンポーネントを各変換に挿入することはできません。

レンダリング・セットを構成するレンダリング項目のリストは番号付きリストです。 リストの下にある別の項目によっても認識されるホスト画面の一部を各レンダリング項目が消費する場合があるため、リストの順序が重要です。レンダリング項目は、リストの上にあるほど優先順位が高くなります。各レンダリング項目の隣にあるチェック・ボックスを使用すると、選択を使用可能または使用不可にすることができます。

コンポーネントは、必ずしも指定した領域全体を消費するとは限りません。例えば、画面全体で選択リストを検索するように選択リスト・コンポーネントを構成したが、画面の中央で 1 つのリストしか検出されなかったとします。ホスト画面の中央の領域のみが「消費済み」としてマークされます。ホスト画面の残りの「未消費」領域は、引き続き優先順位の低いレンダリング項目によって変換されます。

デフォルト・レンダリング設定でテーブル・コンポーネントを使用する場合は注意してください。これは、テーブル・コンポーネントは選択されている領域でほぼすべての画面を認識し、リスト内のこれより下位のレンダリング項目が認識されないためです。

デフォルト・リストの最後のレンダリング項目 (「残りのテキストおよび入力フィールド」) は、残りのすべての「未消費」画面領域を、フィールド・コンポーネントおよびフィールド・ウィジェットを使用して変換します。この項目は、レンダリング・セットの最後の項目でなければなりません。

通常、デフォルト・レンダリング・セットは、GUI の設計原則を適用することによってアプリケーションの機能を拡張しながら、元のホスト画面の構造を保持しようとします。しかし、ホスト画面のデフォルト・レンダリングをモバイル装置上に表示するために、ある程度のコンパクト化が必要になる場合があります。コンパクト化の過程で HTML およびブランク・スペースの量が減らされた結果、元のホスト画面とは異なる構造の表示になる可能性があります。現在選択されているレンダリング・セットでコンパクト化を使用するように指定するには、「コンパクト・レンダリングの使用」 Web のみ  を選択します。

注:
モバイル装置用に最適化された Web プロジェクトには、この設定が選択された場合のデフォルトとして、「コンパクト (compact)」というレンダリング・セットが作成されます。

複数のレンダリング・セットの例

HATS アプリケーションを 1 つ作成し、ユーザーがそのアプリケーションから、互いにまったく異なるように見える 2 つのホスト・アプリケーションにアクセスできるようにしたいと仮定します。この時、各アプリケーションに異なるレンダリング・セットを使用する一方で、HATS のデフォルトのレンダリングを活用して固有の画面カスタマイズをできるだけ少なくしたいと考えたとします。

その場合は、以下の操作によって、これら 2 つのアプリケーション APPA と APPB を呼び出します。

  1. APPA 用に調整したレンダリング・セットを作成します。
  2. APPB 用に調整したレンダリング・セットを作成します。
  3. APPA レンダリング・セットのパラメーターを使用したデフォルトのレンダリング・タグを持つ変換「APPA」を作成します。
  4. APPB レンダリング・セットのパラメーターを使用したデフォルトのレンダリング・タグを持つ変換「APPB」を作成します。
  5. APPA の最初の画面だけを認識し、以下のアクションを実行する画面カスタマイズ APPAfirst を作成します。
    1. グローバル変数「WhichApp」を「APPA」に設定します。
    2. 変換 APPA を適用します。
  6. APPB の最初の画面だけを認識し、以下のアクションを実行する画面カスタマイズ APPBfirst を作成します。
    1. グローバル変数「WhichApp」を「APPB」に設定します。
    2. 変換 APPB を適用します。
  7. グローバル変数「WhichApp」が「APPA」である場合に真であることを認識し、アクションとして変換 APPA を適用する、画面カスタマイズ APPArest を作成します。
  8. グローバル変数「WhichApp」が「APPB」である場合に真であることを認識し、アクションとして変換 APPB を適用する、画面カスタマイズ APPBrest を作成します。
  9. プロジェクト設定の「イベント」タブで画面カスタマイズを APPAfirst、APPBfirst、APPArest、APPBrest の順に並べます。

拡張レンダリング

拡張レンダリング設定を変更するには、デフォルト・レンダリング・ツリーを展開して「拡張」をクリックします。

代替レンダリング

このセクションでは、HATS コンポーネントの変換時にレンダリングの対象が認識されない場合、デフォルト・レンダリングを使用するように指定することができます。この機能は、アプリケーションに含まれる画面に、無保護状態と保護状態を切り替えられるフィールドがある場合には特に便利です。例えば、この機能を使用せず、入力フィールド・コンポーネントによって領域を認識する場合は、フィールドが保護属性状態に切り替わると何も認識されず、レンダリングもされません。

コンポーネント・レンダリングを失敗した際にデフォルト・レンダリングを使用
ホスト・コンポーネントが画面イベント内の領域を認識しない場合に実行されるアクションをプロジェクト・レベルで指定するには、このオプションを使用します。このオプションはデフォルトでは選択されていません。その結果、指定したコンポーネントが領域を認識しない場合は何もレンダリングされません。このオプションを選択すると、領域はデフォルト・レンダリングを使用して変換されます。
レンダリング・セット
このドロップダウンでは、現在定義されているレンダリング・セットのリストから、変換で使用するレンダリング・セットを選択します。
注:
  1. 選択したレンダリング・セットが後でプロジェクトから削除され、実行時には存在しなくなっている場合は、デフォルトのレンダリング・セットが使用されます。
  2. この機能は、画面変換の個々のコンポーネント・レベルで指定することもできます。詳しくは、ホスト・コンポーネントを挿入を参照してください。
HTML テーブル

このセクションでは、整形式の HTML をデフォルト・レンダリングで作成するオプションを選択できます。

デフォルト・レンダリングのテーブル・データと行のタグのクローズ
デフォルト・レンダリングにあるすべてのテーブル・データおよびテーブル行のタグを閉じる (つまり、</td> および </tr> を付ける) ようにプロジェクト・レベルで指定するには、このオプションを選択します。

デフォルト・レンダリングに含まれる HTML の量を減らすために、デフォルトではこのオプションは選択されていません。パフォーマンスが重要になるアプリケーションでは、HTML の量を減らすことが大きな意味を持ちます。しかし、アクセシビリティー用に使用されるスクリーン・リーダー (読み上げソフトウェア) アプリケーションなど、他のアプリケーションではこのオプションの選択が必要になる場合があります。

新規 HATS プロジェクトでデフォルトのレンダリング・カスタマイズを使用可能にする方法

次回に新規 HATS プロジェクトを作成するときにデフォルトのレンダリング・カスタマイズを表示するには、次のステップを実行します。

  1. プロジェクトを作成し、デフォルトのレンダリング・オプションをカスタマイズします。
  2. このプロジェクトの application.hap ファイルを開きます。Web プロジェクトの場合、このファイルは ¥workspace_directory¥project name¥Web Content¥WEB-INF¥profiles¥ にあります。リッチ・クライアント・プロジェクトの場合、このファイルは ¥workspace_directory¥project name¥profiles¥ にあります。
  3. application.hap ファイルの <defaultRendering> タグから </defaultRendering> タグまでのソースをコピーし、インストールされた HATS オファリングの下にある application.hap ファイルの <defaultRendering> タグから </defaultRendering> タグまでのソースに貼り付けます。

    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 のバージョンおよびビルド・レベルです。
    注:
    HATS 保守のインストール後に、この手順を繰り返す必要があります。新規の application.hap ファイルは新しい com.ibm.hats_nnn ディレクトリー構造の下に置かれます。

グローバル規則

グローバル規則を使用すると、ホスト入力フィールドのパターン認識と変換が可能になります。また、 グローバル規則では、カスタマイズした画面、およびカスタマイズしていない (デフォルト・レンダリングの) 画面が処理されます。グローバル規則は、プロジェクト・レベルと、画面レベルの両方で定義できます。プロジェクト・レベルのグローバル規則を指定する場合は、このセクションを使用します。画面レベルのグローバル規則を定義する場合については、グローバル規則を参照してください。

同じ入力フィールドに対してプロジェクト・レベルのグローバル規則と画面レベルのグローバル規則の両方が定義されている場合は、画面レベルの規則が優先されます。

例えば、「Country」というワードが前にあるすべての入力フィールドを、世界各国のコードを含むドロップダウンとしてレンダリングするグローバル規則を作成できます。プロジェクト・レベルのグローバル規則は HATS アプリケーションに対してグローバルです。これらの規則は、レンダリング設定で変換された画面とカスタム変換で変換された画面の両方で機能します。これにより、アプリケーション全体で、変換を一切変更せずにホスト画面の特定のパターンを認識させることができます。

グローバル規則は、構成されたパターン・タイプおよび変換フラグメントから構成されます。パターン・タイプ構成は、ホスト画面で検索するコンテンツの種類を指定します。この操作によって、特定のサイズの特定のフィールドまたはすべてのフィールドを変換したり、指定したストリングに最も近いフィールドを変換できます。例えば、前に「Date」という語がある入力フィールドを認識対象パターンにすることができます。変換フラグメントには、すべての変換におけるパターンのすべての出現箇所を置換する場合に使用されるコンテンツが含まれています。変換フラグメントには、HATS 入力フィールド・コンポーネントおよびカレンダー・ウィジェットを入れることができます。これにより、アプリケーション全体で、前に「Date」という語があるすべての入力フィールドをカレンダー・コントロールとして表示できます。

構成されているグローバル規則は、すべてグローバル規則のテーブルに表示されます。グローバル規則は、すべての「変換を適用」アクションの先頭からこのリストに表示される順序で処理されます。入力フィールドがリストの 1 つのグローバル規則によって認識されると、以降のグローバル規則では認識されなくなります。各項目の隣にあるチェック・ボックスには、項目が使用可能か使用不可かが示されます。

  1. このプロジェクトのグローバル規則のリストにグローバル規則定義を追加するには、「追加」ボタンをクリックします。画面キャプチャーがない場合は、ホスト端末をオープンして画面を取り込むように要求されます。新しいグローバル規則を作成するには、 「名前」、「パッケージ」 (リッチ・クライアント・プロジェクトの場合)、および「説明」を入力し、このグローバル規則を「新規変換フラグメントを作成」と関連付けます。グローバル規則を編集する場合は、「既存の変換フラグメントの使用 (Use an existing transformation fragment)」を実行できます。

  2. 次に、使用するパターン・タイプを選択します。選択できるパターン・タイプは以下のとおりです。

    各パターン・タイプ・コンポーネントは、上記の一連のカスタマイズ可能な設定を含むことができます。設定を変更すると、左側の画面が更新され、一致する入力フィールドが反映されます (複数のフィールドが一致した場合は、複数のフィールドが強調表示されます)。「フィールドの強調表示 (Highlight fields)」オプション以外を選択して、ホスト画面で特定のフィールドを強調表示することもできます。入力フィールドが画面上で定義されている位置を表示するには、「入力」チェック・ボックスを選択します。保護フィールドを表示する場合は、「保護」チェック・ボックスを選択します。隠しフィールドを強調表示するには、「非表示 (Hidden)」チェック・ボックスを選択します。入力フィールド、保護フィールド、または隠しフィールドの強調表示の色を変更する方法については、HATS プリファレンスの使用を参照してください。既存のフラグメントを使用している場合は、「完了」をクリックしてグローバル規則セットを更新し、下記のセクションをスキップします。

  3. 新規フラグメントを作成している場合は、ここで変換フラグメントに挿入する HATS コンポーネントを構成する必要があります。グローバル規則の目的は入力フィールドの検出であるため、入力コンポーネントのみが表示されます。このページの構成に使用するホスト画面領域は、直前のページで最初に一致した入力フィールドを囲む選択ボックスによって示されますが、プロジェクト・レベルのグローバル規則は、このホスト画面とその他すべての画面で一致したすべての入力フィールドに対して影響します。コンポーネントおよびウィジェットを選択して、設定を構成します。詳細については、ホスト・コンポーネントを挿入またはホスト・コンポーネントを編集  Web のみ を参照してください。 「完了」をクリックすると、グローバル規則セットが更新され、新規変換フラグメントが 「変換フラグメント」フォルダーに作成されます。ウィザードを完了したら、必ずプロジェクト設定を保存してください。

注:
リッチ・クライアント・プロジェクトでは、SWT テーブル・ウィジェット付きの入力フィールド・コンポーネントは、グローバル規則ではレンダリングできません。

既存のグローバル規則のコンポーネント設定およびウィジェット設定を変更する必要がある場合は、「レンダリング」タブで「グローバル規則」を選択し、リストから変換フラグメントを選択して、「編集」をクリックします。

最初、変換フラグメントは、「グローバル規則」ウィザードの 3 ページ目で選択した設定に対応する特殊な HATS コンポーネントで作成されます。このコンポーネントは、領域属性を持たない点で特殊です。代わりに、レンダリングする領域を実行時に動的に取得します。このコンポーネントはほかの HATS コンポーネントと同様に編集できますが、ウィザードの最初のページで画面領域ではなくグローバル規則を選択する必要があります。この変換フラグメントには、他の有効な HATS 変換コンテンツを挿入することもできます。

注:
グローバル規則を作成して変換フラグメントを編集する場合は、「設計」タブと「プレビュー」タブのどちらでも出力を表示できません。出力を表示するには、変換フラグメントまたはグローバル規則を適用する全変換の編集中に、「ホスト・コンポーネントを編集」機能から全ページのプレビューを使用します。

グローバル規則に関連付けられた変換フラグメントを手動で変換する場合は、「レンダリング」タブからエディターを使用する前に手動変換してください。こうすると、誤ったタグが読み取られ、すべての変更が削除されます。

プロジェクト・レベルのグローバル規則と該当する画面レベルのグローバル規則は、どちらも画面イベント変換で適用されます。画面イベント・レベルでは、グローバル規則処理をすべて使用不可にすることができます。使用不可にするには、次のステップを実行します。

  1. 「HATS プロジェクト」ビューで、画面イベントが入っている 「画面カスタマイズ」フォルダーまたは「画面組み合わせ」フォルダーを開きます。
  2. 画面イベントをダブルクリックします。
  3. 「アクション」タブに進みます。
  4. 「変換を適用」アクションを選択します。
  5. 「編集」をクリックします。
  6. 「プロジェクト・レベルおよび画面レベルのグローバル規則を適用」チェック・ボックスをクリアします。

テキスト置換

HATS アプリケーションでは、ホスト画面のテキスト・ストリングを別のテキスト・ストリング、HTML コンテンツ  Web のみ 、またはイメージに変換できます。

「テキスト置換」には、置換されるオリジナル・テキストとともに、置換に使用するテキスト、 HTML コンテンツ  Web のみ 、またはイメージを示すテーブルが表示されます。さらに、テキスト検索で大文字と小文字を区別するかどうか、正規表現サポートを使用するかどうかも表示されます。値のテーブルの右側にあるボタンを使用して、テキスト置換の仕様を追加、変更、または除去できます。これらの設定の指定方法の詳細については、テキスト置換を参照してください。

コンポーネントおよびウィジェット

個々のコンポーネントおよびウィジェットについて設定を変更するには、ツリー内で該当項目を展開して、個々のコンポーネントおよびウィジェットを表示します。コンポーネントおよびウィジェットには、カスタマイズ可能な設定がないものもあります。「ホスト・コンポーネントを挿入」ウィザードを使用してカスタマイズできる設定については、コンポーネントおよびウィジェットの設定を参照してください。

コンポーネントおよびウィジェットのプロジェクト設定を変換に挿入するときに、デフォルトのプロジェクト設定をオーバーライドすることができます。これらの変更された設定は、変換内の該当のコンポーネントまたはウィジェットの個別のインスタンスのみに適用されます。プロジェクト内のすべての変換について、そのコンポーネントまたはウィジェット以外のすべてのインスタンスでは、ユーザーが特に変更しない限り、デフォルトのプロジェクト設定が使用されます。例えば、VisualTable コンポーネントに関するデフォルト設定があります。1 つの変換に 2 つの VisualTable コンポーネントを配置し、片方のコンポーネントではプロジェクト設定のデフォルト設定を使用し、もう一方では変更した設定を使用することができます。

コンポーネント

「コンポーネント」には、ホスト画面のエレメントを GUI に表示可能なオブジェクトに変換するために使用するホスト・コンポーネントのリストが表示されます。ホスト・コンポーネントの設定では、そのコンポーネントがホスト画面で認識される方法を指定します。一部のコンポーネントは変更できます。ホスト・コンポーネントの詳細については、ホスト・コンポーネントの設定を参照してください。

ウィジェット

「ウィジェット」を選択すると、ホスト・コンポーネントを GUI に表示するためにプロジェクトで使用できるすべての HATS ウィジェットのリストが表示されます。一部のウィジェットは変更できます。ウィジェットをカスタマイズするのは、ウィジェットが Web ページ上で表示される方法を指定するためです。変更可能なウィジェットおよび設定については、ウィジェット設定を参照してください。

ツールバー  RCP のみ 

「ツールバー」設定パネルでは、リッチ・クライアント・アプリケーションの「変換」ビューのツールバーに関連した設定を変更できます。ツールバーには、アプリケーション・キーパッド・アクション (「最新表示」、「デフォルト」など) に加えて、ツールバー・ウィジェットが提供するアクションも配置されています。ツールバー・ウィジェットの詳細については、ツールバー  RCP のみ を参照してください。

HATS Web アプリケーションでは、アプリケーション・キーパッドは通常はテンプレートの下部またはサイド・バーに配置されます。HATS リッチ・クライアント・アプリケーションでは、アプリケーション・キーパッドにより提供される機能は「変換」ビューのツールバーにボタンとして配置されます。これによって、HATS リッチ・クライアント・アプリケーションを、リッチ・クライアント環境内の他のアプリケーションと適合させることができます。「変換」ビューのツールバーについて詳しくは、 ツールバーを参照してください。

このパネルでは、「ツールバーを表示」チェック・ボックスを選択したり、クリアしたりできます。選択する場合は、ツールバー項目の表示方法 (「テキスト」、「イメージ」、または「テキストとイメージの両方」) を設定できます。この設定は、ツールバーのすべての項目 (ツールバー・ウィジェットが提供する項目も含む) に適用されます。

アプリケーション・キーパッド

デフォルトのアプリケーション・キーパッドは、デフォルト・テンプレートに表示されます。アプリケーション・キーパッドについては、以下の設定をカスタマイズできます。

デフォルトのアプリケーション・キーパッドを表示
ユーザーがアプリケーションと対話するときに、テンプレートまたは変換に定義されたデフォルトのアプリケーション・キーパッドを GUI に表示させる場合は、このチェック・ボックスを選択します。
表示するキーの選択
「デフォルトのアプリケーション・キーパッドを表示」チェック・ボックスを選択した場合、GUI でデフォルトのアプリケーション・キーパッドに含める各キーの隣にあるチェック・ボックスを選択できます。
表示  Web のみ 
選択したキーを、ボタン、リンク、アイコン、またはドロップダウン・リスト項目のいずれとして表示するかを決定する値を選択します。

ホスト・キーパッド

ホスト・キーパッドについては、以下の設定をカスタマイズできます。

デフォルトのホスト・キーパッドを表示
ユーザーがアプリケーションと対話するときに、テンプレートまたは変換に定義されたデフォルトのホスト・キーパッドを GUI に表示させる場合は、このチェック・ボックスを選択します。
表示するキーの選択
「デフォルトのホスト・キーパッドを表示」チェック・ボックスを選択した場合、GUI でデフォルトのホスト・キーパッドに含める各キーの隣にあるチェック・ボックスを選択できます。使用可能なすべてのキーを含めるには、「すべて選択」を選択します。選択されているすべてのボックスをクリアするには、「全選択解除」を選択します。
表示
選択したキーを、ボタン、リンク、またはドロップダウン・リスト項目のいずれとして表示するかを決定する値を、このドロップダウン・リストから選択します。

「追加」ボタンをクリックして 「表題」および「ニーモニック」を入力することによって、カスタム・ホスト・キーを追加することもできます。作業が完了したら、「OK」をクリックします。

オペレーター情報域

オペレーター情報域 (OIA) を使用すると、ホスト・アプリケーションの状態を簡単に判断できます。OIA については、以下の設定をカスタマイズできます。

OIA の表示
このボックスを選択すると、OIA が表示されます。以下のチェック・ボックスを選択すると、表示する項目を指定できます。
セキュア・ホスト接続
HATS 接続を SSL で保護するかどうかを表示するには、このボックスを選択します。
入力禁止標識
キーボードがロックされており、キーボードからの入力を行えないかどうかを表示する場合は、このボックスを選択します。
システム・ロック標識
戻りデータを待機する間システムをロックするかどうかを表示するには、このボックスを選択します。画面を最新表示すると、ロックが解除されます。
メッセージ表示待機標識
メッセージ表示待機標識を表示する場合は、このボックスを選択します。これは 5250 のみのフィーチャーで、これによって、新規メッセージがユーザーを待機中の場合は OIA で標識が表示されます。ユーザーが 5250 ホストの「メッセージの表示」パネルにアクセスすると、標識はクリアされます (別の新規メッセージを受信するまで)。
注:
  1. ユーザーは、自分のメッセージ・キューの送達タイプを *NOTIFY に設定して、メッセージ表示待機標識を受信する必要があります。
  2. このボックスを選択しても、3270 または 3270E の接続には無効です。
非同期更新
非同期更新が使用可能かどうかを表示する場合は、このボックスを選択します。
入力モード
上書きモードが有効かどうか (ブラウザーでサポートされる場合) を表示するには、このボックスを選択します。
絶対的カーソル位置
ホスト・カーソル位置を表示させるには、このボックスを選択します。
カーソル行および列
ホスト・カーソルの行および列位置を表示する場合は、このボックスを選択します。
自動フィールド進行
自動フィールド進行が有効かどうか (ブラウザーでサポートされる場合) を表示する場合は、このボックスを選択します。
フィールド・データ
外部フィールド・データ (「数値のみ」や「フィールドの終了が必要」など) を表示する場合は、このボックスを選択します。
表示域のレイアウト  Web のみ 
水平
(ページ下部に) OIA を水平に表示する場合は、このボタンを選択します。
垂直
(ページのサイド・フレームに) OIA を垂直に表示する場合は、このボタンを選択します。
スタイル・クラス  Web のみ 
OIA の外観を制御する Cascading Stylesheet (CSS) クラス名を入力します。

DBCS

デフォルト接続に DBCS コード・ページが指定されている場合、プロジェクトに DBCS オプションを構成できます。「レンダリング」タブの DBCS 設定について詳しくは、「レンダリング」タブを参照してください。

イベント

「イベント」タブには、アプリケーション・イベントのほか、プロジェクトに含まれる優先順位付けされた画面イベント (画面カスタマイズおよび画面組み合わせ) のリストが表示されます。

画面イベントの名前の横にあるチェック・ボックスが選択されている場合、そのイベントはプロジェクトに対して使用可能になっています。画面イベントが使用可能になっていて、かつ、画面認識基準がホスト画面に一致した場合、HATS はそのイベントに指定されているアクションを実行します。画面イベントについての一致検査はそれ以上行われません。画面イベントが使用不可になっている場合、HATS はイベントを無視します。特定の画面イベントをテストする場合、その他の画面イベントは使用不可にすることができます。画面イベントを使用不可にするには、テスト中にチェック・ボックスをクリアします。

HATS アプリケーションでは、使用可能になっている画面イベントのリストに対して、各着信ホスト画面を照らし合わせて検査します。指定の画面に一致する画面イベントが複数ある場合は、画面に一致する最初の画面イベントが適用されます。優先順位が高い画面イベントほど、リストの上部にあります。例えば、いくつかの特定の画面を認識する画面イベントと、より一般的な画面セットを認識する画面イベントがあるとします。リスト内で、後者の画面イベントが前者の画面イベントより上にある場合、画面は、より具体的な基準で認識されて前者の画面イベントに関連するアクションが実行されるのではなく、より一般的な画面認識基準で認識されて関連するアクションが実行されます。

画面イベントの優先順位を変更する場合は、対象となるイベントをクリックして強調表示します。 「上へ」または「下へ」をクリックして、そのイベントをリスト内で上下に移動させます。詳しくは、画面イベントの優先順位を参照してください。

注:
特定の次画面を指定する画面イベントがある場合は、その特定の画面が優先されます。詳しくは、次の画面を参照してください。

アプリケーション・イベントを編集する場合は、「アプリケーション・イベント」の下で、編集するイベントのリンクをクリックします。詳しくは、アプリケーション・イベントを参照してください。

画面イベントの優先順位

プロジェクト・エディターの「イベント」タブを使用して、画面イベントの順序を変更できます。詳細については、イベントを参照してください。

HATS アプリケーションの実行中に新規ホスト画面が検出されると、HATS はイベント優先順位リストにある最初の使用可能な画面イベントをチェックして、画面認識基準がホスト画面に一致するかどうかを判断します。一致した場合、画面イベントについてのそれ以上の一致検査は行われず、最初の画面イベントのアクションが実行されます。一致しなかった場合は、リスト内の次の画面イベントをチェックして、画面認識基準がホスト画面に一致するかどうかが判断されます。このようにして、リスト内の最後の画面イベントまでチェックを続行します。

現在のホスト画面に一致する画面認識基準が画面イベントに存在しない場合、HATS にアクションが設定されていて画面がブランクであると、HATS はブランク画面イベントを処理します。それ以外の場合、HATS は一致しない画面イベントを処理します。 HATS の一致しない画面イベントは、ホスト画面に一致する定義済みの画面イベントがない場合にのみ実行される特殊な画面イベントです。このイベントのデフォルト・アクションとして、デフォルト・テンプレートを適用するホスト画面 (デフォルト変換) が表示されます。

ホスト画面がどの画面イベントにも一致しない場合に実行するアクションは変更することができます。例えば、ページが見つからなかったことをユーザーに通知し、ユーザーがその画面に到達した方法についての情報を収集する Web ページを作成することができます。「URL を表示」アクションを使用して、Web ページを表示できます。

一致しない画面イベントのアクションを変更する場合は、「イベント」タブに移動し、「アプリケーション・イベント」セクションの「一致しない画面」をクリックして、エディターを開きます。エディターの下部にある「アクション」タブをクリックしてアクションを表示します。「追加」、「編集」、または「除去」をクリックして、unmatchedScreen.evnt ファイルをカスタマイズします。

アプリケーション・イベント

HATS が使用する規則ベースのアプローチにより、画面認識イベントに特定のアクションを適用して画面をカスタマイズできます。また、アクションを HATS イベントに関連付けることもできます (アプリケーション・イベントと呼びます)。アプリケーション・イベントには、ホスト・サーバーとの接続および切断、HATS アプリケーションの始動または停止、アプリケーションがエラーまたは認識されていないホスト画面を検出した場合などのアプリケーションのイベントが含まれます。これらのアプリケーション・イベントを構成すると、これらの事態が発生した場合に特定のアクションを実行できます。

アプリケーション・イベントにアクセスするには、「HATS プロジェクト」ビューにアクセスして HATS プロジェクトの「プロジェクト設定」をダブルクリックし、「イベント」タブを選択します。「アプリケーション・イベント」セクションの「イベント」タブで、イベントへのリンクをクリックして該当するエディターを開きます。

各アプリケーション・イベントには、さまざまなアクションが関連付けられています。

以下のリストに、HATS アプリケーション・イベントの説明、およびそのイベントと関連するアクションが発生する場合を示します。

開始
開始イベントは、HATS アプリケーションを始動するときに発生します。開始イベントにデフォルトのアクションはありません。

開始イベントには、次のアクションを指定できます。

接続
接続イベントは、HATS アプリケーションがホスト・サーバーに接続するときに発生します。例えば、接続時にマクロを実行して特定の画面をバイパスし、ログオン画面を表示するようにプロジェクトを構成できます。接続イベントのデフォルトのアクションは、接続の取得です。接続イベントのアクションは、常に開始イベントの後に実行されます。

接続イベントには、以下のアクションを指定できます。

ブランク画面
ブランク画面イベントでは、ホスト画面がブランクの場合にデフォルト接続で実行するアクションを指定できます。デフォルトでは、このオプションのイベントにデフォルト・アクションが設定されておらず、このイベントは無視されます。アプリケーションで頻繁にブランク画面が表示され、ユーザーが「最新表示」ボタンを押す必要がある場合は、このイベントに「一時停止」アクションを追加して、ホストがホスト画面の描画を完了するまでの待機時間を延ばすこともできます。このイベントにアクションを指定した場合、画面イベント優先順位リストで指定した画面イベント・リストの終わりに達した後、一致しない画面イベントを実行する直前にこのイベントが検査されます。

ブランク画面イベントには、次のアクションを指定できます。

ホストに最初に接続したときに受信したブランク画面の処理方法を指定できる特殊な設定もあります。詳しくは、画面処理を参照してください。

一致しない画面
一致しない画面イベントは、HATS が、HATS アプリケーションのどの画面イベントにも一致しない画面をホスト・アプリケーションから受信したときに発生します。一部の画面にデフォルト・レンダリングを使用するように HATS アプリケーションを構成した場合は、これは通常の事象です。画面イベントで考えられるすべてのホスト画面の認識作業を終了した後には、一致しない画面イベントを構成し、ユーザーに予期しない画面に到達したことを通知して、その画面への到達方法を尋ね、適切な画面に戻るパスを示す URL を表示するようにすることができます。一致しない画面イベントのデフォルトのアクションは、デフォルト変換の表示です。

一致しない画面イベントには、次のアクションを指定できます。

エラー
エラー・イベントは、HATS がアプリケーション・エラーまたはホスト・エラーを検出したときに発生します。エラー・イベントが発生した場合に GUI でエラーを表示するアクションを追加することもできます。エラー・イベントのデフォルト・アクションでは、 URL (Web アプリケーションの場合は error.jsp) またはコンポジット (リッチ・クライアント・アプリケーションの場合は CustomErrorComposite) が表示されます。

エラー・イベントには、次のアクションを指定できます。

切断
切断イベントは、HATS アプリケーションがホスト・サーバーを切断したときに発生します。切断イベントのデフォルトのアクションは、「デフォルト接続を解放」です。

切断イベントには、以下のアクションを指定できます。

停止
停止イベントは、HATS アプリケーションを停止した後に発生します。停止イベントのデフォルト・アクションは「URL を表示」(Web アプリケーションの場合は stop.jsp)、または「コンポジットを表示」(リッチ・クライアント・アプリケーションの場合は CustomDisconnectComposite) です。

停止イベントには、次のアクションを指定できます。

注:
マクロを切断イベントの一部として実行中にタイムアウトになって完了しない場合は、切断イベントは完了せず、HATS 接続は切断されません。マクロのタイムアウトは、通常は、マクロが未知のホスト画面に遭遇する場合に起こります。この状態になったときに「停止」イベントがホスト接続を正常に終了するように構成するには、以下のステップを実行します。
  1. 「停止」イベントのリンクをクリックして、該当するエディターを開きます。
  2. エディターで、「ソース」タブをクリックします。
  3. <release enabled="true"/> アクションを、<show/> アクションの前に追加します。
  4. 「停止」イベント・ソースは次の例のようになります。
    <?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> 
  5. プロジェクト設定ファイルを保存してアプリケーションを再始動します。

その他

「その他」タブには、キーボード・サポート、クライアント・ロケール、接続パラメーター・オーバーライド、非同期更新、グローバル変数オーバーライド、およびクライアント設定の設定が表示されます。

カスタマイズ設定ツリー内で個々のノードをクリックすることにより、該当のデフォルト・プロジェクト設定をカスタマイズすることができます。

キーボード・サポート

キーボード・サポートについては、以下の設定をカスタマイズできます。

キーボード・サポートを使用可能にする
ユーザーが物理的なキーボード・キーを使用してホストと対話できるようにするには、このチェック・ボックスを選択します。これによりユーザーは、ホスト AID キー (F1 キー、SYSREQ キー、RESET キー、ATTN キーなど) にマップされた特定の物理キーを押すことができます。マップされた物理キーボード・キーを使用してブラウザーと対話する場合は、この機能をオフに切り替えることができます。

HATS Web プロジェクトでキーボード・サポートを使用するには、サポートされている Web ブラウザーが必要です。サポートされる Web ブラウザーと制約事項のリストについては、HATS インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp) の HATS 前提条件のセクションを参照してください。

初期キーボード・サポート状態をオン
最初に GUI が表示されるときにキーボードを使用可能にするには、このチェック・ボックスを選択します。

以下のオプションから、キーボード・サポートをブラウザー・ページに表示されるファンクション・キーに限定するかどうかを指定します。

ホスト・キーパッドに表示されるホスト機能だけをサポート (Support only host functions displayed on host keypad)  Web のみ 
このオプションを選択すると、認識される機能ボタンまたはリンクについてブラウザー・ページがスキャンされます。機能が検出された場合は、それらの機能だけがサポートされます。機能が検出されない場合は、すべての機能がサポートされます。 一部の旧バージョンの HATS では、これがデフォルトの振る舞いでした。これらのバージョンからマイグレーションしたアプリケーションは、以前と同様に機能します。
すべてのマップ済みホスト機能のサポート (Support all mapped host functions)  Web のみ 
ブラウザー・ページに存在するホスト・キー・ボタンやリンクに関係なく、キーボード・サポートをすべてのマップ済み機能と連動させるには、このオプションを選択します。これは、新規の HATS アプリケーションのデフォルトの動作です。

クライアント・ロケール

ボタンの表題とメッセージは、さまざまな言語で表示できます。表示する言語を獲得するには、以下のクライアント・ロケール設定をカスタマイズします。

クライアントのデフォルト・ロケールから (From the client's default locale)
Web アプリケーションの場合、ボタンの表題およびメッセージを表示するのに使用される言語は、ユーザーのブラウザーで指定されている言語によって決定します。リッチ・クライアント・アプリケーションでは、デフォルト・オペレーティング・システムの値、あるいはリッチ・クライアント環境の始動時に指定した値のいずれかによって、言語が決まります。
サーバーの基本ロケールから  Web のみ 
ボタンの表題およびメッセージを表示するのに使用される言語は、アプリケーションが配置されているサーバーのロケールによって決定します。
常に以下の言語を使用
ボタンの表題およびメッセージに使用する言語を、ドロップダウン・リストから選択できます。

接続パラメーターのオーバーライド

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 リッチ・クライアント・プラットフォーム・プログラマーズ・ガイド」を参照してください。

接続パラメーターがある場合に、そのうちのどれをオーバーライド可能にするかを制御するには、以下のいずれかのラジオ・ボタンを選択します。

すべてのデフォルト接続パラメーターをクライアント要求でオーバーライドできるようにする (Allow all default connection parameters to be overridden by client requests)
このボタンを選択すると、テーブル内でリストおよび選択されている接続パラメーターを除くすべての接続パラメーターをオーバーライドできるようになります。
すべてのデフォルト接続パラメーターをクライアント要求でオーバーライドできないようにする (Do not allow any default connection parameters to be overridden by client requests)
このボタンを選択すると、テーブル内でリストおよび選択されている接続パラメーターを除くすべての接続パラメーターをオーバーライドできなくなります。

接続パラメーターを追加または除去することによって、選択内容に例外を設けることができます。使用可能な接続パラメーターのリストを取得するには、「追加」ボタンをクリックします。

パラメーターのオーバーライド時に使用する接続のタイプの選択

実行時に接続パラメーターがオーバーライドされると、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 パラメーターを接続パラメーターのオーバーライドとして指定するには、プロジェクト設定エディターの「接続パラメーターのオーバーライド」ページにある「その他」タブで、このパラメーターをオーバーライドに対して有効にしておく必要があります。

disconnectOnClose パラメーター

HATS では、セッションが切断される前にブラウザーが閉じた場合にホストを自動的に切断する自動切断機能が提供されます。詳しくは、自動切断および最新表示  Web のみ を参照してください。自動切断機能を使用しないアプリケーションでは、disconnectOnClose パラメーターによって同様の機能が実行されます。このパラメーターによって、ユーザーがセッションをホストから手動で切断する前にブラウザーが閉じた場合に、HATS サーバーがホストの Telnet セッションをすぐにリセットできるようになります。ユーザーが「切断」をクリックすると、通常は、切断されます。Telnet セッションのリセットは、元のブラウザーが閉じた場合に新しいブラウザーを起動する隠しフレームをブラウザー内に設定することによって実現されます。新規のブラウザー・ウィンドウは、切断信号を送信してから、閉じます。

この機能は、disconnectOnClose=true が指定されていて、かつ、サポートされているバージョンの Internet Explorer を使用している場合にのみ有効になります。 disconnectOnClose パラメーターの指定には、大/小文字の区別があります。 サンプル URL 要求は、以下のとおりです。

http://hostname/appname/index.jsp?disconnectOnClose=true

appname は、HATS アプリケーションの名前です。

disconnectOnClose parameter パラメーターを使用する場合、以下の条件は真です。

非同期更新  RCP のみ 

HATS リッチ・クライアント・アプリケーションの場合、非同期更新機能はデフォルトで有効になっています。この機能を無効にするには、「非同期更新を使用可能にする」ボックスをクリアします。非同期更新メカニズムの主な目的は、ホストが新しい画面を送信したために基本のホスト画面が変更された場合に、GUI 表示を自動的に更新することです。これには以下の利点があります。

自動切断および最新表示  Web のみ 

HATS Web アプリケーションの場合、自動切断および最新表示機能は、AJAX 実装を使用するクライアント・プル・メソッド、またはアプレット実装を使用するサーバー・プッシュ・メソッドのいずれかで実行できます。AJAX 実装を使用可能にするには、「クライアント・プル (AJAX) を使用可能にする」オプションを選択します。アプレット実装を使用可能にするには、「サーバー・プッシュ (アプレット) を使用可能にする」オプションを選択します。これらの機能を両方とも使用不可にするには、「使用不可」を選択します。デフォルトは「使用不可」です。

クライアント・プル (AJAX) メソッドの使用

HATS Web アプリケーションの場合、クライアント・プル (AJAX) 実装メソッドを構成できます。これには、自動切断機能と自動最新表示機能が含まれます。

自動切断機能は、事前に定義された期間ブラウザーが HATS アプリケーションと接触していない場合を検出する機能を提供します。検出されると、ブラウザー・セッションに関連付けられたリソースをクリーンアップしてサーバーの負荷を減らすために、切断処理が実行されます。これを行うために、切断イベントが実行され、切断マクロ (構成されている場合) が実行されます。

自動最新表示機能の目的は、ホストが新しい画面を送信したために基本のホスト画面が変更された場合に、HATS アプリケーションの Web ページ表示を自動的に最新表示することです。これにより、ホストから非同期で変更された画面を表示するためにユーザーが「最新表示」ボタンをクリックする必要はなくなります。

自動最新表示を使用可能にすると、以下の場合には Web ページ表示は自動的には更新されません。

サーバー・プッシュ (アプレット) 実装メソッドの場合とは異なり、クライアント・プル (AJAX) メソッドは特定のブラウザーの使用を必要としません。代わりに、HATS によってサポートされるすべてのブラウザーをサポートします。また、サーバー・プッシュ (アプレット) メソッドの場合とは異なり、サーバーへの追加の接続は不要であり、HATS 管理者による構成が簡単になります。クライアント・プル (AJAX) メソッドは、サーバー・プッシュ (アプレット) メソッドと相互に排他的です。クライアント・プル (AJAX) 機能のいずれかが使用可能である場合、サーバー・プッシュ (アプレット) 構成は無視されます。

注:
  1. クライアント・プル (AJAX) メソッド (自動切断機能および自動最新表示機能を含む) は、HATS Web 画面変換アプリケーションの場合にのみサポートされます。
  2. このメソッドと以下の HATS 機能の併用はサポートされません。
  3. モバイル装置用に最適化された HATS Web アプリケーションは、キーボード・ホスト・キー・サポートを提供しません。このため、新しいホスト画面がホスト・アプリケーションから非同期で受信されると、ユーザーが HATS アプリケーションの GUI ビューに入力したデータを自動最新表示サポートが上書きします。
  4. iPhone または iPod touch デバイスで実行されているブラウザーから別のアプリケーションに切り替えると、ブラウザーからの AJAX ポーリングが停止します。この結果、HATS にアクセスしているブラウザーから、デバイス上の別のアプリケーションに切り替えたとき、切断を待機する時間 (秒) 間隔が経過した後、HATS によりブラウザー・セッションが切断されます。この間隔を長くするのが適切な場合、あるいは iPhone または iPod touch デバイスからアクセスされる HATS アプリケーションの自動切断機能を無効にするのが適切な場合があります。詳しくは、クライアント・プル (AJAX) の設定を参照してください。
クライアント・プル (AJAX) の設定

自動切断機能および自動最新表示機能を構成するには、以下の設定を使用します。

ポーリング間隔 (秒)
ブラウザーが HATS Web アプリケーションをポーリングして、切断タイマー (使用可能な場合) を再始動し、ホスト画面の更新を確認する、秒単位の間隔。値は、秒単位で、小数点以下第 1 位まで指定します。最小値は 1.0 秒です。デフォルトは 5.0 秒です。 「切断」が選択されている場合、ポーリング間隔値は「切断を待機する時間 (秒)」設定の値より少なくとも 1 秒小さい必要があります。
注:
アプリケーション・サーバーの WebSphere Application Server「セッション管理」設定で「タイムアウトの設定」オプションを選択することにより HTTP セッション・アイドル・タイムアウトが構成されている場合は、HATS Web アプリケーションのブラウザー・ポーリングは効果的に HTTP セッション・アイドル・タイムアウト機能を使用不可にします。このため、HATS ランタイムが責任を持って HTTP セッション・アイドル・タイムアウト期間をモニターし、アイドル時間が経過する前にユーザー・アクティビティーがなければ HATS セッションの切断を開始します。
切断
自動切断機能を使用可能にするには、このオプションを選択します。選択されている場合、「切断を待機する時間 (秒)」フィールドに指定された時間内にクライアントが Web アプリケーションをポーリングしないと、HATS Web アプリケーションは切断処理を開始します。
注:
ブラウザー・セッションに関連付けられたリソースをクリーンアップしてサーバーの負荷を減らすために、切断処理が実行されます。これを行うために、切断イベントが実行され、切断マクロ (構成されている場合) が実行されます。
切断を待機する時間 (秒)
自動切断機能を実行するまでに待機する秒単位での時間。値は、秒単位で、小数点以下第 1 位まで指定します。最小値は 2.0 秒です。デフォルトは 15.0 秒です。
最新表示
自動最新表示機能を使用可能にするには、このオプションを選択します。選択されている場合、ユーザー入力がなく、ホスト画面が変更されたことをポーリング応答が示していると、ブラウザーは最新表示を開始します。

サーバー・プッシュ (アプレット) メソッドの使用

注:
サーバー・プッシュ (アプレット) メソッドは推奨されません。このメソッドは現在はサポートされていますが、IBM は将来のリリースでこの機能を除去する権利を持っています。代わりにクライアント・プル (AJAX) メソッドを使用することをお勧めします。

サーバー・プッシュ (アプレット) 実装メソッド (非同期更新アプレットとも呼ばれる) により実行される機能は 2 つあります。

非同期更新アプレットを使用すると、 HATS サーバーからユーザーのブラウザーに変換済みの端末画面を送信するのに使用される接続に加えて、クライアントで稼働するアプレットと HATS サーバーの間に別にソケット接続が確立されます。このソケット接続は、クライアントとサーバー間で容量の小さいメッセージを受け渡しする場合に使用されます。容量の小さいメッセージとは、ホストからの非同期の画面最新表示や、HATS サーバーに対するブラウザーの終了通知に関するものです。このソケット接続のトラフィック量は、通常は非常に少ないものです。このソケット接続をセットアップすると、次のような一連のイベントが発生します。

  1. ユーザーがブラウザーで HATS アプリケーションの URL にアクセスします (リンクを使用するか、アドレス・バーに URL を入力します)。
  2. HATS サーバーが要求を受信し、ブラウザーに応答を送信します。この応答には非同期更新アプレットの Java™ コードが含まれています。
  3. クライアントがアプレットをダウンロードすると、アプレットは個別のソケット接続を開設して、 HATS サーバーと直接通信しようとします。このソケット接続に使用するクライアント側のローカル・ポートは、使用可能で未使用のポートからランダムに選択され、構成することはできません。アプレットの接続先となるリモート HATS サーバーの IP 名およびポート情報は、アプレットがクライアントにダウンロードされるときにサーバーから提供されます。サーバー側の HATS アプリケーション構成でそのサーバーのポート番号に値 0 が指定されていると、ポート番号が 1024 より大きい未使用のポートが HATS サーバー上でランダムに選択され、パラメーターとしてアプレットに提供されます。サーバーで選択されたポート番号は、ブラウザーで HATS 変換のページ・ソースを表示すると確認できます。ページ・ソースを検索して、PARAM NAME="port" に指定されている値を調べてください。アプレット・パラメーター設定の詳細については、サーバー・プッシュ (アプレット) の設定を参照してください。

アプレットを実行するには、Java 対応ブラウザーが必要です。http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp の HATS インフォメーション・センターで、サポートされるブラウザーの最新リストを確認してください。「Contents」の「HATS prerequisites」の下で、「Detailed System Requirements」を選択します。

注:
このアプレットは、HATS ポートレットでは機能しません。詳しくは、WebSphere Portal と HATSを参照してください。
サーバー・プッシュ (アプレット) の設定

サーバー・プッシュ (アプレット) 実装メソッドを構成するには、以下の設定を使用します。

ホスト名
これは、HATS アプリケーションを実行するサーバーのホスト名または IP アドレスです。サーバーが水平クラスター化された環境にある場合、application.hap ファイルをサーバーで展開した後にこのアプリケーション・ファイルを編集し、ホスト名を変更する必要があります。

ブラウザー側のアプレットでは、TCP/IP ソケットを使用して HATS サーバーと通信します。ソケットを作成するには、HATS アプリケーションをホスティングしているサーバーのホスト名が必要です。HATS がブラウザーの URL によって指定された同じ Web サーバーに配置されている場合、ホスト名パラメーターを指定する必要はありません。アプレットはその Web サーバーの IP アドレスを使用してソケット接続を確立します。 HATS アプリケーションが別のサーバーにある場合、ホスト名パラメーターは、 ホスト名または IP アドレスを使用して指定する必要があります。

サーバー・ソケットのポート
サーバー上のポート。クライアントがこのサーバーと通信するには、このポートを使用する必要があります。ゼロ (0) は、1024 より大きい値のランダムな未使用ポートが使用されることを表します。2043-4544 のようにポートの範囲を指定することもできます。また、3045, 1345, 9596 のようにコンマ (,) で区切ったポート・リストを指定することもできます。
注:
HATS が垂直クラスターになっている (同一の物理サーバー上に複数の HATS インスタンスがある) 場合は、HATS インスタンスごとに別々のポートを使用しなければなりません。ゼロ (0) 以外の値を使用する場合は、少なくとも HATS インスタンスと同じ数のポートを指定する必要があります。各 HATS インスタンスはその始動時に、空いているポートが見つかるまで指定のポート群を試行していきます。
切断を待機する時間 (秒)
ブラウザーが閉じてからユーザーが切断されるまでにアプリケーションが待機する時間 (秒)。ブラウザーからしばらく離れたときに確実にアプリケーションを切断する場合にも、使用できます。値は、秒単位で、小数点以下第 1 位まで指定します。デフォルトは、300.0 秒 (5 分) です。有効な値は 300.0 秒以上の数値です。

アプレットには、ブラウザー固有の設定と 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> 

各パラメーターの概要を以下に示します。

disconnectDelay
このパラメーターは、「サーバー・プッシュ (アプレット) を使用可能にする」設定の GUI で「切断を待機する時間 (秒)」設定から設定されます。ブラウザーを閉じたり、ブラウザーで新しいページをロードしたりするたびに (つまり、ユーザーが HATS アプリケーションを表示しなくなるたびに)、アプレットは、この時間だけ待機した後にホストからユーザーを切断します。値が小さすぎると、アプリケーションでページ間を移動する場合に、ユーザーが切断されることがあります。この値を高く設定しても実害はありませんが、ユーザーがブラウザーをクローズしても、この時間が経過するまではサーバーおよびホストのリソースが保持されます。デフォルト値は、300000 ミリ秒 (5 分) です。
enable
この設定を使用して、どの自動切断および最新表示更新方式を使用するかを構成します。クライアント・プル (AJAX) メソッドを構成するには AJAX を指定し、サーバー・プッシュ (アプレット) メソッドを構成するには true を指定し、両方のメソッドを使用不可にするには false を指定します。デフォルトは false です。true が指定されると、指定されたポートで listen ソケットが確立されます。このアプリケーションに接続する各ブラウザーでは、そのページにアプレット・タグが挿入されます。
hostname
アプレットが HATS サーバーに再度接続できるようにするには、application.hap ファイルで HATS サーバーのホスト名または IP アドレスを構成する必要があります。
注:
水平クラスタリングでは、application.hap ファイルを編集してホスト名を変更する必要があります。.hap ファイルの手動編集は、WebSphere Application Server 管理を使用して (サーバー上に) .ear が展開された後に行う必要があります。
port
クライアントがそのサーバーと通信する際に使用する必要がある、サーバー上のポートを選択します。ゼロ (0) は 1024 より上のランダムなポートを指定します。ポートの範囲 (例えば、2043-4544) を指定することも、コンマ区切りのポート・リスト (例えば、3045,1345,9596) を指定することもできます。デフォルト値はランダムです。
注:
  1. HATS がファイアウォールの後ろにある場合は、値ゼロ (0) を指定しないでください。指定すると、任意のポートがファイアウォールを通過するのが困難になる場合があるためです。
  2. 垂直クラスタリングでは、HATS がファイアウォールの後ろにある場合にポート範囲を指定できます。HATS が Web サーバー上にある場合は、ポート番号の代わりにゼロ (0) または範囲を指定できます。どちらの場合も、Web サーバーで個別にポート番号を指定することを強くお勧めします。

以下のブラウザー関連の設定は、特定のブラウザーまたは環境で使用される機能を決定します。

nonWindows
Windows® 以外のオペレーティング・システムで実行するブラウザーの設定を指定します。指定可能なオプションは disconnect、refresh、local です。このアルゴリズムは l、d、および r を検索し、分離文字は無視します。オプションを適用するには、オプションがオペレーティング・システムの設定とブラウザーの設定の両方にリストされている必要があります (例えば、nonWindows=dr other=dr)。デフォルト値は disconnect|refresh です。
ie
すべてのバージョンの Internet Explorer のための設定を指定します。デフォルト値は disconnect|refresh|local です。
other
その他のブラウザー (例: Opera、Mozilla) で使用する設定を指定します。デフォルト値は disconnect|refresh です。

上にリストしたブラウザー関連の設定に対して、以下の値を使用できます。

disconnect(d)
ブラウザーを閉じると、disconnectDelay タイマーの設定時間 (application.hap ファイルで指定) が経過した後に、この設定によって HATS サーバーからホストへのホスト・サイド接続がクリーンアップされます。この機能は、どの Java 対応ブラウザーでも使用できます。
注:
Internet Explorer 以外のすべてのブラウザーでは、ユーザーが HATS アプリケーションを表示しなくなると、 disconnectDelay タイマーの設定時間経過後に、この設定によってホスト・サイド接続がクリーンアップされます。Internet Explorer の設定について詳しくは、以下の disconnectAlways を参照してください。
disconnectAlways
このフィーチャーにより、Internet Explorer の非同期更新アプレットの切断動作を、他のすべてのブラウザー (Internet Explorer 以外) と同様にすることができます。両者の振る舞いは次のとおりです。 このフィーチャーを使用すれば、Internet Explorer でも、ユーザーがブラウザーを閉じた場合または HATS アプリケーションから表示を切り替えた場合に、 disconnectDelay タイマーで指定した時間が経過するとセッションがクリーンアップされるように指定できます。

Internet Explorer の振る舞いを変更するには、disconnect を disconnectAlways で置き換えます。すると、Internet Explorer のパラメーター・リストは次のように表示されます。

<setting name="ie" value="disconnectAlways|refresh|local"/>
.
refresh(r)
新規コンテンツが使用可能になったときにサーバーがページを自動的に更新できるようにします。これは、Java 対応のブラウザーで機能します。
local(l)
ページの表示スペースのみを最新表示します。これは、Internet Explorer V7、および Internet Explorer V6 の比較的新しいリリースでのみ正常に機能します。他の環境では JavaScript™ エラーが発生してブラウザーが強制終了する場合があります。

非同期更新アプレットのクライアント・サイド・トレースを使用可能にするには、 HATS エントリー・サーブレットの Web アドレスで、HTML パラメーター appletJavaConsoleTrace=true を指定する必要があります。例えば、以下のようになります。

http://myhost/myhats/entry?appletJavaConsoleTrace=true

注:
  1. これは HATS サーバー・サイド・トレースに対するクライアント・サイド・トレースで、サーバー・サイド・トレースを補完してアプレットの問題をデバッグします。
  2. このトレースは、IBM サポート担当員によって要求された場合にのみ使用可能にしてください。

グローバル変数のオーバーライド

この機能を使用して、ユーザーからアプリケーションにデータを渡すことができます。例えば、ユーザーがユーザー 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 つをクリックします。

すべてのグローバル変数をクライアント要求でオーバーライドできるようにする
このボタンにより、テーブル内のリストされたグローバル変数や選択されたグローバル変数以外のすべてのグローバル変数をオーバーライドできます。
すべてのグローバル変数をクライアント要求でオーバーライドできないようにする
このボタンをクリックした場合は、テーブル内のリストされたグローバル変数や選択されたグローバル変数以外のグローバル変数がオーバーライドできません。

グローバル変数の例外を追加するには、「追加」ボタンをクリックします。この画面では、テキスト・ボックスにグローバル変数名を入力するか、ドロップダウン・リストから選択できます。共用可能なグローバル変数であることを示すには、「共用グローバル変数」チェック・ボックスを選択します。詳しくは、グローバル変数との対話を参照してください。

テーブルのエントリーを編集する場合は、「編集」をクリックします。「除去」ボタンを押すと、強調表示されたグローバル変数が例外のリストから削除されます。

注:
HATS V4 からマイグレーションしたアプリケーションに対するデフォルトでは、すべてのグローバル変数をクライアント要求によってオーバーライドできます。この設定は、アプリケーションをインポートした後にこの画面で変更できます。HATS V5 以降の新規アプリケーションの場合、デフォルトでは、クライアント要求によるグローバル変数のオーバーライドは許可されません。

クライアント設定

次のクライアント設定をカスタマイズできます。

HTTP 圧縮を使用可能にする  Web のみ 
このボックスを選択すると、HTTP 圧縮により、HATS ランタイム (WebSphere Application Server で実行されます) とユーザーのブラウザーの間で転送されるバイト数が削減されます。こうすると、 HATS ランタイムとブラウザー間の転送時間が短くなり (応答時間の改善)、ネットワークを流れるバイト数が少なくなります (ネットワーク使用状況の改善)。
注:
  1. 圧縮が正しく機能しているかどうかを判断し、圧縮前と圧縮後のページ・サイズのバイト数を確認するには、runtime.properties ファイル (HATS Toolkit のデバッグ・モードで実行している場合は runtime-debug.properties ファイル) の trace.UTIL 行を更新してトレースを使用可能にします。例: trace.UTIL=7。詳しくは、付録A. ランタイム・プロパティー・ファイルを参照してください。トレース・ファイルで、runtime.filters.CompressionFilter というトレース・エントリーを検索します。例えば、次のようになります。
    +--------------------------------------+
    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 
  2. このフィーチャーは、HATS アプリケーションを WebSphere Portal Server で実行している場合には適用されません。
  3. HATS でページを圧縮する前には、 HTTP ヘッダー "Accept-Encoding" に "gzip" が含まれていることを確認してください。
  4. アプリケーションがサーバーで稼働中に指定した圧縮関連の設定を変更したい場合は、アプリケーション・サーバーを再始動する必要があります。
  5. JavaScript (.js) ファイルおよび Cascading Stylesheet (.css) ファイルは、この新機能では圧縮されません。 HTTP サーバー内の HTTP 圧縮を、これらのファイル・タイプの圧縮に対応するように構成する必要があります。詳しくは、HTTP サーバーの資料を参照してください。
  6. この設定は、プロジェクト・レベルでのみ指定できます。個々の変換 JSP には指定できません。
  7. HATS 5.0.x、6.0、または 6.0.1 からプロジェクトをマイグレーションする場合は、該当するタグの付いた web.xml ファイルを手動で更新する必要があります。詳細については、特別なマイグレーションの考慮事項を参照してください。

未変更フィールドの送信を抑制する  Web のみ 
このボックスを選択すると、変更済みの入力フィールドの内容がホストが提供するデータと同じ場合には、HATS はその入力フィールドのデータをホストに送信しないように指定できます。

このボックスをクリアすると、変更済みの入力フィールドの内容がホストが提供するデータと同じ場合でも、HATS はその入力フィールドのデータを送信します。例えば、ホストがフィールドに ABC を設定していて、ユーザーがそのフィールドに ABC と入力した場合でも、入力されたデータはホストに返されます。

注:
この設定は、プロジェクト・レベルでのみ指定できます。単一の変換 JSP には指定できません。

保護された読み取り専用ラベルをデフォルト・タブ順序に含める  RCP のみ 
このボックスを選択すると、「変換」ビューのフィールドのデフォルトのタブ移動順序に、保護された読み取り専用フィールドが含まれるように指定できます。

このチェック・ボックスをクリアすると、デフォルトのタブ移動順序には保護された読み取り専用フィールドは含まれません。

自動フィールド進行を使用可能にする
このボックスを選択すると、ユーザーが入力フィールドにデータを入れ終えたときに、フォーカスが自動的に次の入力フィールドに移るように指定できます。

Web アプリケーションでは、変換ファイルの </HATS:Form> タグの直後に以下の行を追加することで、個々の変換ごとにこの機能を使用不可にすることもできます。この機能を使用可能にする場合は、false の代わりに true を指定してください。

<script> 
autoAdvance = false;
</script>

リッチ・クライアント・アプリケーションでは、以下のように個々の変換で needsAutoAdvanceSupport メソッドをオーバーライドすることで、変換ごとにこの機能を使用不可にすることができます。この機能を使用可能にする場合は、false の代わりに true を戻します。

public boolean needsAutoAdvanceSupport(boolean preferredValue) {
return false;
}
注:

この設定を使用する場合の DBCS の考慮事項については、 自動フィールド進行を使用可能にするを参照してください。

ホストおよび非ホスト入力フィールドを含める
このボックスを選択すると、自動拡張を有効にしたときに、ホスト画面の入力フィールドの順序に関係なく、変換された画面の入力フィールドの順で、フォーカスが自動的に次の入力フィールドに移るように指定できます。

このボックスをクリアすると、自動拡張を有効にしたときに、ホスト画面の入力フィールドの順で、フォーカスが自動的に次の入力フィールドに移ります。

初期カーソル位置
通常は、ホスト・アプリケーションのカーソルの位置によって、画面変換の初期入力フォーカスの位置が決まります。まれに、ホスト・アプリケーションのカーソル位置を無視し、代わりに変換での最初の項目に初期フォーカスを設定したい場合があります。高度にカスタマイズされた変換で、ホスト入力フィールドの順序が変更された場合がこれに該当します。このフィーチャーを使用可能にすると、初期フォーカスが、ホスト・カーソルがある入力フィールドではなく、画面変換の最初の項目に配置されます。
注:
  1. 「初期カーソル位置」の設定は、 GUI では構成可能な設定として表示されません。変換ファイルのソースで設定する必要があります。

    Web アプリケーションの場合、変換でこのフィーチャーを使用可能にするには、変換の </HATS:Form> タグの直後に以下の行を追加します。

    <script> 
    initialInputFocusFromCursor = false;
    </script>

    リッチ・クライアント・アプリケーションの場合、変換でこのフィーチャーを使用可能にするには、以下のように個々の変換に対して isInitialFocusAtCursorPosition メソッドをオーバーライドします。

    public boolean isInitialFocusAtCursorPosition() {
    return false;
    }
  2. 変換のテストは慎重に行ってください。多くのホスト・アプリケーションでは、正しい振る舞いのためにはカーソル位置が重要です。例えば、変換に配置されたマクロ・ボタンが原因で、呼び出したマクロがホスト・アプリケーションの間違った位置にデータを入力し始めることがあります。これは、カーソルが想定されている位置とは別の位置にあるためです。
nextFieldForDropDown  Web のみ 
この設定を使用して、ドロップダウン・リストから選択した後で次の入力フィールドにカーソル位置を移動することを指定します。HATS V7.5.0.2 以降で作成される新規プロジェクトのデフォルトは、true です。HATS V7.5.0.2 より前のリリースで作成されるプロジェクトのデフォルトは、false です。
注:
  1. GUI では、この設定は構成可能な設定として示されません。これは、次に示すように、application.hap ファイルのソースで設定する必要があります。
    <class name="com.ibm.hats.common.RuntimeSettings">
             <setting name="nextFieldForDropDown" value="true"/>
    </class>
  2. この設定は、「自動フィールド移動を有効にする」が選択されている場合にのみ有効です。

上書きモード (初期)
初期状態で上書きモード (ブラウザーがサポートしている場合) を有効にする場合は、このボックスを選択します。上書きモードを使用可能にすると、入力フィールドにテキストを入力した場合、カーソル位置にあるテキストが一度に 1 文字ずつ上書きされます。これを使用不可にすると、入力フィールドに入力したテキストはカーソル位置に挿入され、既存のテキストは先送りされます。ユーザーは、Insert (挿入) キーを使用してこの初期設定を切り替えることができます。
注:

この設定を使用する場合の DBCS の考慮事項については、上書きモード (初期)を参照してください。

フォーカスされたテキストをすべて選択する
Web アプリケーションでよく見られるように、フィールドがフォーカスされた場合にそのフィールド内のテキストがすべて選択されるようにしたい場合は、このボックスを選択します。端末エミュレーターでよく見られるように、フィールドがフォーカスされた場合にテキストが選択されないようにしたい場合は、このボックスをクリアします。
注:
  1. Web アプリケーションの場合:
    • デフォルトが選択されています。
    • この設定は、「上書きモード (初期)」設定の動作には影響しません。
    • この設定は、Internet Explorer がアプリケーション用のブラウザーとして使用される場合にのみ有効です。
  2. リッチ・クライアント・アプリケーションの場合:
    • デフォルトではクリアされています。
    • 選択すると、この設定は「上書きモード (初期)」設定のように機能します。ユーザーがフィールドに入力を行うと文字が上書きされていきます。
    • テキストは、フィールドにタブで移動するためにキーボードを使用した場合にのみ選択されます。フィールドでマウスをクリックしたときは、テキストは選択されません。
  3. この設定を使用する場合の DBCS の考慮事項については、フォーカスされたテキストをすべて選択するを参照してください。

使用中のページを有効にする  Web のみ 
このボックスを選択すると、最初の要求の処理が完了する前にユーザーによって複数の要求がサブミットされたときに、使用中ページのメッセージが表示されます。使用中ページのメッセージを表示させない場合は、このボックスをクリアします。クリアされている場合は、サーバーが応答を戻すまでは追加の要求を送信できません。

矢印キー・ナビゲーションを使用可能にする  RCP のみ 
レンダリングされた画面上の無保護ホスト・フィールド間を上下左右の矢印キーを使用してナビゲートできるようにするには、このボックスを選択します。「レンダリング」タブのフィールド・ウィジェットで、「保護フィールド上でのカーソルの位置決めを許可します」設定も選択されている場合は、矢印キーを使用して、無保護と保護の両方のホスト・フィールドにナビゲートすることができます。これは、端末エミュレーター・アプリケーションの標準動作です。矢印キーをナビゲーションに使用しない場合は、このボックスをクリアします。

各変換の needsArrowKeyNavigationSupport メソッドを以下のようにオーバーライドすることにより、この機能を個々の変換について選択的に無効化することができます。

public boolean needsArrowKeyNavigationSupport(boolean preferredValue) {
return false;
}

この機能を使用可能にする場合は、false の代わりに true を戻します。

注:
  1. ナビゲーションは、フィールドの UI 位置ではなく、常にホスト・フィールドの位置が基準になります。
  2. 複数の画面と組み合わせてこの機能を使用した場合、次の入力フィールドを判断するアルゴリズムは、まず、現在のフィールドと同じ画面にある対象フィールドへとナビゲートしようとします。対象フィールドがない場合には、次の画面 (画面の ID を基準に判断) に対象となる入力フィールドがないか探します。

ポートレットの設定

これらの設定は、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 エディターを使用してプロパティーを除去できます。

注:
WSDL ファイルからプロパティーを除去しなければ、HATS ポートレットは現状のまま正常に稼働します。

ソース

「ソース」タブには、プロジェクト内のすべての設定 (自分で選択したもの、またはデフォルトを受け入れたもの) について、application.hap ファイルのタグと値が表示されます。プロジェクト・エディターの他のタブを変更すると、「ソース」タブに表示されるタグと値もそれに合わせて変化します。

「ソース」タブのソースを編集することにより、application.hap ファイルのタグと値を直接変更することもできます。この変更は、プロジェクト・エディターの適切なタブに反映されます。

HATS プリファレンスの使用

「HATS プリファレンス」を使用して、HATS Toolkit の外観および動作を制御できます。これらのプリファレンスによって、HATS Toolkit へのアクセスが容易になり、プログラミング・タスクが単純化されます。HATS プリファレンスを処理するには、「ウィンドウ」>「設定」をクリックして、ツリー・ビューで「HATS」を選択します。プリファレンスに関する即時ヘルプを参照するには、その場所にカーソルを置いて F1 を押します。

以下のプリファレンスを変更できます。

既知のファイル・タイプのファイル拡張子は非表示
デフォルトでは、「HATS プロジェクト」ビューに .jsp などの一般的なファイル拡張子は表示されません。例えば、Templates フォルダーのファイルの拡張子はすべて .jsp です。「HATS プロジェクト」ビューにすべてのファイル拡張子を表示させる場合は、このチェック・ボックスをクリアします。
HATS のヒントを表示
HATS のヒントは、新規ユーザーに役立つ提案を表示します。HATS Toolkit を使用するときに HATS のヒントを表示させないようにする場合は、このチェック・ボックスをクリアします。
マイグレーション警告の表示
HATS V7.5.1 プロジェクトにマイグレーションされていないプロジェクトを HATS が検出した場合に、マイグレーションの警告を表示させるかどうかを指定できます。
端末ウィンドウを表示するためのプロンプト
「サーバーでデバッグ」(Web プロジェクトの場合) または「デバッグ」(リッチ・クライアント・プロジェクトの場合) を使用してプロジェクトをテストする際に、ディスプレイ端末をオンにするか尋ねるダイアログを、HATS で表示するかどうかを決定できます。ダイアログ上のチェック・ボックスをポップアップ表示されたときに選択することによって、この機能をオフにすることもできます。
隠しフィールド抽出の警告を表示 (Show extract hidden fields warning)
以下のイベントのいずれかが発生した場合、 キャプチャーされた画面で HATS が隠しフィールドを検出した場合にダイアログによる警告を表示するかどうかを指定できます。
リッチ・クライアント成果物の完全修飾 Java クラス名を表示する
このボックスを選択すると、HATS Java ソース成果物 (例えば、リッチ・クライアント・テンプレートやリッチ・クライアント変換) の完全修飾パッケージ名が、 「HATS プロジェクト」ビューに表示されます。このボックスはデフォルトでは選択されていないので、「HATS プロジェクト」ビューには成果物の Java クラス名のみが表示されます。例えば、リッチ・クライアント・プロジェクトに myProj.transformations.SignOn という完全修飾名の変換が含まれているとします。デフォルトでは、「HATS プロジェクト」ビューの 「変換」フォルダーには SignOn しか表示されません。このボックスが選択されていると、SignOn (myProj.transformations) と表示されます。

この設定は、Java「HATS プロジェクト」ビューの 「Java ソース」フォルダーの表示内容には影響を与えません。

JRE の非互換性に関する警告を表示
HATS では、非互換の JRE を検出したとき、メッセージにより警告を出すことができます。現行 JRE が HATS と非互換であるという警告ダイアログを表示する場合は、このボックスを選択してください。 JRE を手動で変更する必要があります。警告ダイアログを表示しない場合は、このボックスをクリアしてください。
ワークベンチの始動時にライセンス設定検査を実行する

HATS はワークスペースの始動時にプロジェクトのライセンス設定をチェックし、マスター・ライセンス設定と一致しないプロジェクトがある場合は、ユーザーにライセンス設定の更新を求めるプロンプトを表示します。このチェック・ボックスをクリアすると、始動時にライセンス設定を確認することはできません。

選択フィルター
このチェック・ボックスのリストにより、「HATS プロジェクト」ビューに表示させるファイルのタイプを選択できます。例えば、共通イメージやスタイル・シートを処理しない場合は、このチェック・ボックスをクリアして「HATS プロジェクト」ビューに表示されないようにすることができます。経験の少ないユーザーにマクロや Java ソース・ファイルを処理させたくない場合、該当するチェック・ボックスをクリアして、それらのファイルが表示されないようにすることができます。
ホスト端末プリファレンス
マクロのデバッグ前にすべてのマクロ・プロンプトを表示 (Prompt for all macro prompts before debugging a macro)
これを選択した場合、マクロを最初にデバッグするときにダイアログが表示され、すべてのプロンプトに対する値を一度に入力できます。選択しない場合、マクロが実行している現在のプロンプトの値のみを要求するダイアログがプロンプト表示されます。この場合、各プロンプトの値を 1 つずつ入力する必要があります。このプリファレンスは、マクロのデバッグ時だけに使用され、HATS Toolkit でマクロを再生する場合、またはマクロや HATS アプリケーションを実行する場合には影響ありません。
マクロ・プロンプト/抽出名の警告を表示
このボックスは、統合オブジェクトとの使用には無効なマクロ・プロンプトまたは抽出名を入力したときに HATS に警告させる場合に選択します。
固定フォント・サイズ
このプリファレンスは、視覚障害のあるユーザーのために設計されています。ウィンドウを拡張したり縮小したりした場合でもホスト端末のテキストのサイズを変更しないように指定できます。例えば、文字を大きくする必要がある場合は、大きな固定フォント・サイズを設定し、スクロール・バーを使用してホスト端末画面を参照できます。
画面キャプチャーの強調表示時の色
色を使用して、パターンに一致する入力フィールド、保護フィールド、隠しフィールド、および画面領域を識別します。これらの目的に使用する色を変更するには、これらのプリファレンスを使用します。

HATS に関連した動作を制御するためのプリファレンスはほかにもあります。これらのプリファレンスを使用するには、プリファレンス・ツリーで HATS を展開し、以下のサブカテゴリーの 1 つをクリックします。

アクセシビリティー
音響アラームによる認識エラーのアラート
認識エラーが発生した場合 (例えば、「サブファイル」コンポーネント設定ページなどで) に音響アラート (ビープ音) を再生するには、このボックスを選択します。これは、スクリーン・リーダー (読み上げソフトウェア) を使用してメッセージ領域を読み上げるよう、開発者に警告しなければならない場合に便利です。

BMS のインポート (BMS Import)
これらの設定は、BMS インポート・ウィザードを使用せずに、BMS ソース・ファイルを HATS プロジェクト内の Maps フォルダーに追加した場合だけに使用されます。
ホスト・コード・ページ
インポートする BMS マップで使用されるコード・ページ。
BMS ファイル・コード・ページ
BMS ファイルをワークステーションに転送するときに使用されるコード・ページ

デフォルト Java パッケージ
このパネルを使用すると、Java ソース・ファイルである HATS 成果物 (リッチ・クライアント変換、リッチ・クライアント・テンプレート、リッチ・クライアント・マクロ・ハンドラー、ビジネス・ロジック、カスタム・コンポーネント、およびカスタム・ウィジェット) のデフォルト Java パッケージ名が構成されます。パッケージ名は、完全修飾 Java クラス名の最初の部分です (例えば、Java クラス名が com.myCompany.MyClass であれば、パッケージ名は com.myCompany です)。

新規成果物にパッケージ名を作成する場合、 {project name} にはプロジェクトの名前が入ります。このような置換が行われるのは、有効なパッケージ名を確実に作成するためです (例えば、スペースは下線に変換されます)。

ホスト・シミュレーション
TCP/IP ポートの範囲
トレースの記録および再生中に、HATS ホスト・シミュレーション機能はポートの範囲を使用して、ホスト端末または HATS アプリケーションとのホスト通信を記録または再生します。ポートの範囲を使用すると、複数のセッションで同時にトレースを記録または再生することができます。ポートの範囲を設定するには、次のフィールドを使用します。デフォルトの範囲開始ポートは 7021、デフォルトの終了ポートは 7050 です。
時間遅延設定
遅延
このドロップダウンの各オプションは、ホスト・シミュレーションが、再生中にホスト端末または HATS アプリケーションからの要求応答するまでの時間遅延を設定するために使用します。オプションは、「遅延なし」(ホスト・シミュレーションは次の画面ですぐに応答します)、「ランダム」(ホスト・シミュレーションが応答するまでに、あらかじめ定義された最小時間と最大時間の間でランダムに遅延が発生します)、および「実」(ホスト・シミュレーションは、記録中に画面を表示する場合に実際にかかる時間だけ待機します) です。デフォルトは「遅延なし」です。 「ランダム」を選択した場合は、「最小」フィールドと「最大」フィールドで遅延値の範囲を設定します。
最小 (ms)
「遅延」設定が「ランダム」の場合は、このフィールドで、ホスト・シミュレーションが再生中に次の画面で応答するまでの遅延の最小値 (ミリ秒) を設定します。
最大
「遅延」設定が「ランダム」の場合は、このフィールドで、ホスト・シミュレーションが再生中に次の画面で応答するまでの遅延の最大値 (ミリ秒) を設定します。

統合オブジェクト (Integration Object)
マクロ保存時に統合オブジェクトを自動的に生成
マクロを保存するたびに統合オブジェクトを生成する場合は、このチェック・ボックスを選択します。手動で統合オブジェクトを作成する場合は、このチェック・ボックスをクリアします。マクロから統合オブジェクトを作成する方法については、統合オブジェクトの使用を参照してください。
統合オブジェクトの作成時に HATS EJB プロジェクトで EJB Access Bean を自動生成する (Automatically generate EJB Access Bean in HATS EJB Project when an Integration Object is created)
統合オブジェクトを作成するたびに HATS EJB プロジェクトに EJB Access Bean を生成する場合は、このチェック・ボックスを選択します。「マクロ保存時に統合オブジェクトを自動的に生成」プリファレンスを選択した場合、マクロの作成時または変更時に、統合オブジェクトとともに EJB Access Bean が作成されます。
統合オブジェクトの生成に使用するテンプレート
統合オブジェクトの新規テンプレートを作成する場合は (「HATS Web アプリケーション・プログラマーズ・ガイド」を参照)、この設定で、統合オブジェクト・ファイルの作成時に使用するテンプレートを指定します。
統合オブジェクト BeanInfo の生成に使用するテンプレート
統合オブジェクトの新規テンプレートを作成する場合は (「HATS Web アプリケーション・プログラマーズ・ガイド」を参照)、この設定で、統合オブジェクト BeanInfo ファイルの定義時に使用するテンプレートを指定します。

ターゲット・プラットフォーム  RCP のみ 
HATS ランタイム・プラグインをターゲット・プラットフォームにインストールするためのプロンプト (リッチ・クライアントのみ)
HATS リッチ・クライアント・プラグインをターゲット・プラットフォームのローカル・テスト環境でテストするためには、HATS ランタイム・プラグインをターゲット・プラットフォームにインストールする必要があります。新規プロジェクトを作成してターゲット・プラットフォームを選択する場合、またはあとでターゲット・プラットフォームを変更する場合、HATS Toolkit は、選択されているターゲット・プラットフォームに HATS ランタイム・プラグインがインストールされているかどうかを検出します。このボックスを選択すると、ターゲット・プラットフォームでランタイム・プラグインが検出されない場合、ランタイム・プラグインをインストールするように求めるプロンプトがツールキットから出されます。

変換
これらのプリファレンスは、新規のブランク変換を作成する際に使用されます。
フリー・レイアウト・テーブルを含める (Web のみ)
ブランクの変換を作成する場合、テーブルのデフォルトの高さと幅がこの設定から取得されます。デフォルトでは、特に別の指定をしない限り、この設定が 100% で初期化されます。ドロップダウン・メニューから「ピクセル」を選択すると、これらの値をピクセルで指定することもできます。
注:
変換でテーブルの後ろにホスト・コンポーネントが挿入されると、サーバーで実行したときに、レンダリングされたそのコンポーネントは表示されません。これは、画面の 100% がテーブルに使用されるためです。
プロジェクトがモバイル装置用に最適化されている場合を除く
モバイル装置用に最適化されているプロジェクトの新規ブランク変換にフリー・レイアウト・テーブルを組み込まないようにするには、このプリファレンスを選択します。
ホスト・コンポーネントの挿入後にプロパティー・ビューをオープン
変換へのホスト・コンポーネントの挿入後に「プロパティー」ビューをオープンするには、このボックスを選択します。

Visual Macro Editor
デフォルトで画面アクションを表示
デフォルトでマクロ画面オブジェクトにアクションを表示する場合は、この設定を選択してください。デフォルトでアクションを非表示にする場合は、この設定をクリアしてください。マクロ画面上のアクション・トグルをクリックすると、特定の画面のアクションを表示したり、非表示にしたりできます。この設定は、Visual Macro Editor で初めて開くマクロのみに作用します。デフォルトが選択されています。
表示する画面アクション数の制限
1 つのマクロ画面オブジェクトに対して表示するアクションの最大数を指定します。これは、すべてのアクションを表示するとインターフェースが複雑になりすぎる、複雑なマクロで有用です。デフォルトは 5 です。

HATS プリファレンスを変更した場合、「適用」をクリックして即時 HATS Toolkit にその結果を表示することができます。新しいプリファレンスを保存して「プリファレンス」ウィンドウをクローズするには「OK」をクリックします。保存せずに終了するには「キャンセル」をクリックします。「キャンセル」 をクリックした場合は、「適用」をクリックした後に行った変更内容のみがキャンセルされます。

HATS プリファレンスを初期値に戻すには、「デフォルトの復元 (Restore defaults)」をクリックします。

ある HATS Toolkit で HATS プリファレンスを構成し、そのプリファレンスをほかの開発ワークステーションにコピーする場合、Rational SDP メニュー・バーから「ファイル」>「エクスポート」>「一般」>「設定」を選択して、プリファレンスを .epf ファイルとして保存します。このファイルを使用する各ワークステーションに転送したり、ネットワーク経由で使用可能にすることができます。「ファイル」>「インポート」>「一般」>「設定」を選択し、設定ファイルをインポートします。

その他の Rational SDP プリファレンスの使用

HATS Toolkit の外観と振る舞いは、Rational SDP で選択できる他のプリファレンスを使用することによって影響を受ける場合もあります。

例えば、「ラベル装飾」プリファレンスを使用すると、他のツールキット (Java コンパイルおよび CVS など) で、「HATS プロジェクト」ビューに表示される HATS ラベルおよびイメージを装飾することができます。エラーが発生した場合に、ファイルの横に赤いマークを表示することができます。CVS リポジトリーからファイルをチェックアウトする場合に、ファイル名の横にバージョン番号を表示できます。Rational Application Developer で「ラベル装飾」プリファレンスにアクセスする手順は次のとおりです。

  1. メニュー・バーから、「ウィンドウ」>「設定」を選択します。
  2. 「一般」>「外観」の順に、ツリー・ビューを展開します。
  3. 「ラベル装飾」を選択します。
    注:
    1. 装飾のプリファレンスは、Rational SDP の他のバージョンでも同じ場所にあります。
    2. 詳しくは、Rational SDP のヘルプ・システムで「ラベル装飾」を検索してください。