HATS は、Eclipse リッチ・クライアント・プラットフォーム (Eclipse RCP) 環境、Lotus Notes® 環境、または Lotus® Expeditor Client 環境で実行するリッチ・クライアント GUI アプリケーションを使用して、既存のホスト・アプリケーションへのアクセスを変換する機能を提供します。
Eclipse RCP は、Eclipse プラットフォーム (オープン・ソースのツール・プラットフォームとして最も良く知られる) によって提供されているプラグインのサブセットです。Eclipse RCP の導入により、Eclipse で提供されるコア機能を使用して、ユーザーのデスクトップを対象としたネイティブ・クライアント・アプリケーションを構築することが可能になります。Eclipse RCP の詳細情報は、http://www.eclipse.org/home/categories/rcp.php にあります。
Lotus Notes は強力なマルチ・ファセットのソフトウェアであり、ユーザーにとって重要な情報すべてに簡単にアクセスできます。Lotus Notes を使用して、インターネット・メールの送受信、予約のスケジュール、Web の参照、インターネット・ニュースグループへの参加、およびホーム・ページを活用した日々の重要な情報すべてのトラッキングを行うことができます。詳しくは、Lotus Notes インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp) を参照してください。
Lotus Expeditor Client は、多数のエンタープライズ・アプリケーションをサーバーが管理するラップトップおよびデスクトップ・システムに拡張するためのリッチ・クライアント・ランタイム環境および統合されたミドルウェア・コンポーネントを提供します。Lotus Expeditor Client のアプリケーションの開発やデプロイの詳細については、http://publib.boulder.ibm.com/infocenter/ledoc/v6r2/index.jsp で、Lotus Expeditor インフォメーション・センターを参照してください。
特に明記しない限り、本章での説明は、Eclipse RCP V3.4 環境、Lotus Notes V8.5.1 環境、および Lotus Expeditor Client V6.2 環境での HATS リッチ・クライアント・アプリケーションの開発と展開に適用されます。前のバージョンの Eclipse RCP および Lotus Expeditor Client に適用される説明については、前のバージョンの適切なインフォメーション・センターを参照してください。
リッチ・クライアント環境は、従来の Web 環境では使用できない、以下のような機能を提供します。
リッチ・クライアント・アプリケーションの開発に関する追加情報およびヘルプは、Rational® SDP のヘルプ目次にあります。メニュー・バーの「ヘルプ」>「ヘルプ目次」を選択して、「リッチ・クライアント」 を検索します。
HATS リッチ・クライアント・アプリケーションを作成する場合、Eclipse RCP 環境、Lotus Notes 環境、および Lotus Expeditor Client 環境の間の違いはごくわずかです。この章全体でその違いについて説明します。
HATS リッチ・クライアント・アプリケーションと HATS Web アプリケーションの間の主なアーキテクチャーの違いは、Telnet ソケット接続をどこで開始するかという点です。リッチ・クライアント・アプリケーションを使用する場合、従来の HATS Web アプリケーションと同様に、ソケット接続は WebSphere Application Server ではなく、ユーザーのワークステーションから開始します。リッチ・クライアント・アプリケーションは、ユーザーのワークステーション上にクライアントを必要とするため、これらのアプリケーションは主に、従来のファット・クライアント端末エミュレーターの使用に慣れた内部ユーザーを対象としています。
HATS リッチ・クライアント・アプリケーションを構築およびテストするためのステップは、基本的に HATS Web アプリケーションの場合と同じです。 HATS Toolkit を HATS パースペクティブで提供されるツールとともに使用して、HATS リッチ・クライアント・プロジェクトを開発し、そこから HATS リッチ・クライアント・アプリケーションが生成されます。開発中に必要な様々なアクティビティーをサポートするために、同じウィザード、エディター、およびビューが提供されています。Lotus Notes または Lotus Expeditor Client を対象としたアプリケーションを構築するには、Lotus Expeditor Toolkit がインストールされている必要があり、補助として使用できます。
Web 環境用の HATS と同様に、アプリケーションの外観および操作方法を開発します。これには、デフォルトのレンダリング設定、画面ナビゲーション (skip screen マクロを使用)、および画面のレンダリングに使用されるフォントと色のカスタマイズが含まれます。
HATS Web アプリケーションで使用可能なフィーチャーの大多数は、HATS リッチ・クライアント・アプリケーションでも使用可能です。これには、以下のものが含まれますが、それに限定されるわけではありません。
HATS リッチ・クライアント・アプリケーションでは使用できないが、HATS Web アプリケーションでは使用可能なフィーチャーは以下のとおりです。
HATS リッチ・クライアント・プロジェクトは、Eclipse プラグイン・プロジェクトです。これはプロジェクトとしてワークスペース内にあり、HATS アプリケーション開発者によって開発されます。プロジェクトが開発およびテストされると、HATS リッチ・クライアント・アプリケーションとしてエクスポートされ、これが、Eclipse 環境にインストールできる Eclipse プラグインとなります。Eclipse プラグインは、Eclipse 環境のコンテキスト内で特定のタイプのサービスを提供するコンポーネントです。HATS で使用する場合、プラグインはホスト・アプリケーションを変換するために必要なサービスを提供します。
それぞれの HATS リッチ・クライアント・アプリケーション・プラグインは、複数のランタイム・プラグインに依存します。依存関係はリッチ・クライアント・プロジェクトのマニフェスト・ファイル、MANIFEST.MF で参照されます。HATS リッチ・クライアント・プラグインが正しく実行されるためには、これらの必須プラグインがローカル・テスト環境および展開済みの実稼働環境に組み込まれていることを確認する必要があります。詳しくは、HATS RCP ランタイム拡張プロジェクト、HATS リッチ・クライアント・アプリケーションのテスト、および HATS リッチ・クライアント・アプリケーションのデプロイを参照してください。
HATS リッチ・クライアント・プロジェクトを作成する場合、ターゲット・プラットフォームを選択するように求めるプロンプトが出されます。この選択は、アプリケーションの展開先を示します。Eclipse RCP への展開を対象としたプロジェクトと Lotus Notes または Lotus Expeditor Client への展開を対象としたプロジェクトの間の違いはごくわずかです。以下の特性は、すべての HATS リッチ・クライアント・プロジェクトに共通です。
Eclipse RCP への展開を対象としたプロジェクトの追加事項:
Lotus Notes および Lotus Expeditor Client への展開を対象としたプロジェクトの追加事項:
Rational SDP ワークスペースと意図しているランタイム環境の両方の Java ランタイム環境 (JRE) が、同じである必要があります。例えば、Java ランタイム環境 (JRE) 1.6 を実行する Eclipse 環境で稼働するように HATS リッチ・クライアント・プラグインを開発している場合は、ワークスペースのコンパイラー準拠レベルを 1.6 に設定する必要があります。これを行うには、Rational SDP メニュー・バーから、「ウィンドウ」>「設定」>「Java」>「コンパイラー」を選択し、「コンパイラー準拠レベル」を 1.6 に設定します。
他の準拠レベルを必要とする他の Java またはプラグイン・プロジェクトがワークスペース内にある場合、個々の Java またはプラグイン・プロジェクトのコンパイラー準拠レベルを設定することができます。これを行うには、プロジェクトを右クリックし、「プロパティー」を選択します。「プロパティー」パネルで、左側の「Java コンパイラー」を選択します。次に、「プロジェクト特定設定を使用可能にする」ボックスを選択し、「コンパイラー準拠レベル」を適切なレベルに設定します。
HATS リッチ・クライアント・プロジェクトを作成すると、HATS RCP ランタイム拡張プラグイン (以後、ランタイム拡張プラグイン) のプロジェクトは、ワークスペース内にまだ存在していない場合には自動的に作成されます。ランタイム拡張プラグインには、com.ibm.hats.rcp.runtime.extension の名前とプラグイン ID があり、初期バージョンは 1.0.0 です。
ランタイム拡張プラグインは、HATS RCP ランタイム (com.ibm.hats.rcp.runtime) プラグインの拡張です。HATS RCP ランタイム・プラグインには HATS ランタイム・クラスが含まれており、HATS リッチ・クライアント・アプリケーションが機能するには、その環境内になければなりません。ランタイム拡張プラグインにより、ランタイム環境に関連した設定を行うことができます。
このプラグイン・プロジェクトには、以下の構成可能な成果物が含まれています。
このプロジェクトは Web 環境の HATS EAR プロジェクトに類似していますが、ランタイム環境ごとにこれらのプラグインのうちの 1 つしかありません。つまり、ユーザーの環境では、ランタイム拡張プラグインが 1 つだけ稼働していることになります。すべての HATS リッチ・クライアント・プロジェクト plugin.xml ファイルは、このプラグインで依存関係を宣言します。 ランタイム拡張プラグインは、個々の HATS アプリケーション・プラグインを参照しません。
ランタイム環境で実行できるランタイム拡張プラグインのコピーは 1 つだけなので、ユーザーの環境にはプラグインのコピーが 1 つだけ存在するようにする必要があります。複数のランタイム拡張プラグインが環境内にある場合は、バージョン番号が最も大きいプラグインがその環境によって使用されます。これによって、最も新しいコードが常に使用されます。
ランタイム拡張プロジェクトは、「HATS プロジェクト」ビューには表示されませんが、「ナビゲーター」ビューには表示されます。これは、エクスポート時に生成されるフィーチャー・プロジェクトの一部として組み込まれます。詳しくは、HATS リッチ・クライアント・アプリケーションのデプロイを参照してください。
HATS Web プロジェクトと同じように、新規 HATS リッチ・クライアント・プロジェクトを作成すると、HATS ファイルを編成するために利用できる一組のフォルダーが作成されます。以下にデフォルト・プロジェクトの例を示します。 最上位のフォルダーの名前は、作成するプロジェクトに付けた名前と同じです。このフォルダーの中には、HATS プロジェクトで定義したオブジェクトを含む他の上位フォルダーが入っています。 一部のフォルダーは、特定のオブジェクトが作成されるまで表示されません。

プロジェクトのセットアップ方法に応じて、これらのフォルダーの一部またはすべてが「HATS プロジェクト」ビューに表示されます。また、「HATS プロジェクト」ビューに表示するフォルダーや、非表示にするファイル拡張子を指定することもできます。詳しくは、HATS プリファレンスの使用を参照してください。
プロジェクトのファイルの編成をわかりやすくするために、これらの上位サブフォルダーの内部にもフォルダーを作成することができます。例えば、プロジェクト用の画面キャプチャーを作成するときに、「Screen Captures」フォルダーの下に、取り込んだ画面を編成してグループ化するためのフォルダーを作成することができます。フォルダーを作成するには、ツリー内の上位フォルダーの 1 つを右マウス・ボタンでクリックし、「新規 HATS」>「フォルダー」を選択します。ファイルを別のフォルダーに移すには、該当ファイルを右マウス・ボタンでクリックして「移動」を選択するか、ドラッグ・アンド・ドロップ方式を使用します。
HATS パースペクティブの「ナビゲーター」ビューに進むと、HATS プロジェクトをチーム環境で共用できます。プロジェクトを右クリックして、「チーム」>「プロジェクトの共用」を選択します。リストからリポジトリー・タイプを選択し、「次へ」をクリックします。Rational SDP は、いくつかのリポジトリーをサポートしています。詳しくは、Rational SDP の資料を参照して「リポジトリー」を検索してください。
「HATS プロジェクト」ビューのポップアップ・メニューを使用して、リッチ・クライアント・リソースのコピー、貼り付け、削除、移動、および名前変更を行うことができます。以下のリソースを、HATS Web プロジェクトと HATS リッチ・クライアント・プロジェクトの間でコピーまたは移動できます。
異なるタイプのプロジェクトからコピーされたリソースによっては、変更を必要とするものがあります。例えば、HATS Web プロジェクトから HATS リッチ・クライアント・プロジェクトにコピーされたマクロは、有効な SWT Java マクロ・ハンドラーを参照するように更新される必要があります (HATS Web プロジェクトの場合、マクロは JSP マクロ・ハンドラーを参照します)。また、適用アクションで指定された JSP 変換の参照や転送アクションで指定された URL により、画面カスタマイズを更新する必要もあります。問題を検出し、修正するために、警告メッセージが「問題」ビューに表示されます。以下のシナリオには警告が出されます。
HATS Web アプリケーションを HATS RCP アプリケーションにマイグレーションするための組み込み機能はありません。画面のカスタマイズ、マクロ、接続、画面キャプチャー、イメージ、ビジネス・ロジック・ソース・ファイル、およびカスタム・コンポーネント・ソース・ファイルなどの成果物は、最小限の変更を加えるだけで 1 つのプロジェクト・タイプから別のプロジェクト・タイプに手動でマイグレーション可能です。変換、カスタム・ウィジェット、テンプレート、およびカスタム・マクロ・ハンドラーなどの他の成果物は、異なるタイプのプロジェクトで使用するためにより多くの変更を必要とします。
HATS リッチ・クライアント・プロジェクトを Rational SDP がインストールされている別のシステムに移動するか、またはその他の理由でプロジェクトを保存および復元するには、Rational SDP のエクスポートおよびインポート機能を使用できます。
Rational SDP のプロジェクト交換機能を使用して、プロジェクトとその従属プロジェクトを .zip ファイルとしてエクスポートします。この機能には、複数の特長があります。この機能では、複数のプロジェクトと必要なランタイム拡張プロジェクト (com.ibm.hats.rcp.runtime.extension) をすべて同時にエクスポートできます。この場合、プロジェクト交換ファイルをインポートする前に、宛先の HATS Toolkit でプロジェクトを作成する必要はありません。 HATS Toolkit からプロジェクトをプロジェクト交換ファイルとしてエクスポートするには、次の手順を実行します。
プロジェクト交換 .zip ファイルを HATS Toolkit にインポートするには、次の手順を実行します。
HATS リッチ・クライアント・アプリケーション・プラグインをローカル・テスト環境でテストするには、そのプラグインと必要なランタイム・プラグインをターゲット・プラットフォームの 1 つのインスタンスで起動します。ターゲット・プラットフォームは Eclipse 製品 (例えば、Eclipse RCP、Lotus Notes、または Lotus Expeditor Client) を参照し、それに対して開発中のプラグインがコンパイルおよびテストされます。ターゲット・プラットフォームを構成するには、Rational SDP の「ウィンドウ」>「設定」>「プラグイン開発」>「ターゲット・プラットフォーム」ダイアログを使用します。
テスト用 Lotus Notes ターゲット・プラットフォームを構成するには、Lotus Expeditor Toolkit バージョン 6.2.1 以降と Lotus Notes バージョン 8.5.1 以降の両方がインストールされている必要があります。Lotus Expeditor Toolkit が Lotus Expeditor Test Environment Configuration Feature とともにインストールされている場合は、ワークスペースを初めて開いたときに、構成ダイアログ (下図) が表示されます。表示されたときは、次に示す「テスト環境構成」設定を使用して構成できます。 「ターゲット・ロケーション」は、Lotus Notes のデフォルトのインストール・ロケーションに含まれています。次に示すように「VM 名」および 「コンパイラー準拠レベル」を設定してください。「表示しない (Never display)」オプションを選択した場合は、Rational SDP メニュー・バーで「ウィンドウ」>「設定」>「クライアント・サービス」を使用して、構成ダイアログを表示するようオプションを再設定できます。

テスト用 Lotus Expeditor ターゲット・プラットフォームを構成するには、Lotus Expeditor Toolkit と Lotus Expeditor Client for Desktop の両方がインストールされている必要があります。ツールキットとクライアントが同じバージョンである必要があります。Lotus Expeditor Client for Desktop バージョン 6.2.0 以前を使用する場合、Device Runtime Environment もインストールする必要があります。
Lotus Expeditor Client では、デフォルト・インストールに以下のフィーチャーを追加する必要があります。
Lotus Expeditor Client で、「ファイル」>「アプリケーション」>「インストール」>「インストールする新しいフィーチャーの検索」>「フォルダー・ロケーションの追加」を選択します。Lotus Expeditor Client 製品ファイルの desktop¥updates¥platform フォルダーまで参照して行き、「終了」を選択します。「updates/platform」および「Development」を展開します。「Lotus Expeditor デスクトップ開発ユーティリティー」の横のチェック・マークにマークを付けます。「ランタイム・コンポーネント」も展開し、 「サービス・データ・オブジェクト (SDO) コンポーネント」の横のチェック・マークにマークを付けます。「次へ」を選択し、ウィザードを完了します。
Lotus Expeditor Client バージョン 6.2.0 以前の場合、コア JVM フィーチャー - J2SE をインストールするには、Lotus Expeditor Client で、「ファイル」>「アプリケーション」>「インストール」>「インストールする新しいフィーチャーの検索」>「フォルダー・ロケーションの追加」を選択します。Desktop Runtime Environment サイトの場所 (update.site.dre.client ディレクトリー) まで参照して行き、「OK」を選択します。デフォルトのサイト名を受け入れ、「OK」および「終了」を選択します。このサイトおよび「ランタイム・コンポーネント (Runtime Components)」を展開します。「Core JVM フィーチャー -JSE (Core JVM Feature - J2SE)」の横のチェック・マークにマークを付けます。「次へ」を選択し、ウィザードを完了します。
Lotus Expeditor Toolkit が Lotus Expeditor Test Environment Configuration Feature とともにインストールされている場合は、ワークスペースを初めて開いたときに、構成ダイアログ (下図) が表示されます。表示されたときは、次に示す「テスト環境構成」設定を使用して構成できます。 「ターゲット・ロケーション」は、 Lotus Expeditor Client for Desktop のデフォルトのインストール・ロケーションに含まれています。次に示すように「VM 名」および 「コンパイラー準拠レベル」を設定してください。「表示しない (Never display)」オプションを選択した場合は、 Rational SDP メニュー・バーで「ウィンドウ」>「設定」>「クライアント・サービス」を使用して、この構成ダイアログを表示するようオプションを再設定できます。

ローカル・テスト環境でテストすることに加えて、プロジェクトをアプリケーションとしてエクスポートし、それをランタイム環境で展開して、展開プロセスをテストする必要があります。詳しくは、HATS リッチ・クライアント・アプリケーションのデプロイを参照してください。
HATS リッチ・クライアント・アプリケーション・プラグインがターゲット・プラットフォームのローカル・テスト環境で実行されるには、必要なランタイム・プラグインをターゲット・プラットフォームにインストールする必要があります。新規プロジェクトを作成し、ターゲット・プラットフォームを選択するか、または後でターゲット・プラットフォームを変更する場合、HATS Toolkit は必要なランタイム・プラグインがインストールされており、選択したターゲット・プラットフォームで最新レベルになっているかどうかを検出します。そうなっていない場合、ツールキットにより、最新のランタイム・プラグインをインストールするように求めるプロンプトが出されます。このプロンプトは、HATS プリファレンスを使用して使用可能または使用不可にすることができます。 詳細については、HATS プリファレンスの使用を参照してください。以下は、インストールされている必須のランタイム・プラグインです。
Lotus Notes ターゲット・プラットフォームの場合、以下の Eclipse プラグインもインストールされます。
最新の HATS ランタイム・プラグインをターゲット・プラットフォームにインストールした後、新規のプラグインを再ロードする必要があります。これを実行するには、Rational SDP の「ウィンドウ」>「設定」>「プラグイン開発」>「ターゲット・プラットフォーム」ダイアログを使用して、「再ロード」をクリックします。
ターゲット・プラットフォームを構成し、ランタイム・プラグインをインストールすることに加えて、Rational SDP でワークスペースのデフォルト JRE を設定する必要が生じる可能性があります。
Eclipse RCP ターゲット・プラットフォームでテストする場合は、デフォルト JRE を jdk に設定します。これを実行するには、以下のステップを実行します。
JRE を一致させてください。例えば、Java 1.6 を稼働する Eclipse 環境でテストする場合は、ワークスペースの JRE をランタイム環境の JRE に一致するように更新する必要があります。
Lotus Notes ターゲット・プラットフォームでテストするときは、Lotus Expeditor Toolkit 構成ダイアログ (図 7を参照) を使用してワークスペース用のデフォルトの JRE が既に設定されている可能性があります。設定されていない場合は、以下のステップを実行します。
Lotus Expeditor ターゲット・プラットフォームでテストするときは、Lotus Expeditor Toolkit 構成ダイアログ (図 8を参照) を使用してワークスペース用のデフォルトの JRE が既に設定されている可能性があります。設定されていない場合は、以下のステップを実行します。
プロジェクトを起動するには、起動構成が必要です。ご使用のプロジェクトの 「実行」または「デバッグ」をクリックすると、HATS により、デフォルトの起動構成が作成されます (以下のセクションの説明を参照してください)。 起動構成は、「実行」または「デバッグ」ダイアログが別のビュー、例えば「パッケージ・エクスプローラー」ビューから開かれているときは、作成されません。デフォルトの起動構成は、「新規プロジェクト」ウィザードまたは「プロジェクト設定」エディターで設定される、プロジェクトのターゲット・プラットフォームに基づいています。デフォルトの起動構成をランタイム・ワークベンチをもはや起動できないポイントに変更すると、起動構成を削除することができ、「実行」または「デバッグ」を再びクリックすると、HATS により、起動構成が再作成されます。プロジェクトを起動するには、以下のセクションのターゲット・プラットフォームについての説明に従ってください。
プロジェクトを Eclipse RCP 用のローカル・テスト環境で起動するには、以下のステップを実行します。
Lotus Notes を対象とした HATS プラグインをローカルにテストするには、Lotus Expeditor Toolkit および Lotus Notes を Rational SDP と同じ開発ワークステーションにインストールする必要があります。同時に実行できる Lotus Notes インスタンスは 1 つのみであるため、プロジェクトをテストしようとするときに Lotus Notes が既に実行されていてはなりません。 ターゲット・プラットフォームの構成を参照してください。
プロジェクトを Lotus Notes 用のローカル・テスト環境で起動するには、以下のステップを実行します。
Lotus Expeditor を対象とした HATS プラグインをローカルにテストするには、Lotus Expeditor Toolkit および Lotus Expeditor Client for Desktop を Rational SDP と同じ開発ワークステーションにインストールする必要があります。ターゲット・プラットフォームの構成を参照してください。
プロジェクトを Lotus Expeditor Client 用のローカル・テスト環境で起動するには、以下のステップを実行します。
HATS パッケージをどこで取得するかには関係なく (HATS CD、Web、または別の製品とのパッケージ)、同じバージョンの HATS Toolkit をインストールします。これは、HATS の評価に使用できる使用制限付きバージョンです。取得済みライセンス証書に合わせて実稼働環境のランタイムを完全に使用可能にするには、HATS Toolkit に組み込まれている「ライセンス設定」ウィザードを使用して、ライセンス設定を指定する必要があります。詳しくは、「HATS スタートアップ・ガイド」のセクション『HATS の評価』および『HATS ランタイムの使用可能化とライセンス設定 (Enabling HATS runtime and license settings)』を参照してください。
このセクションでは、HATS リッチ・クライアント・アプリケーションを展開するための 2 つの異なる手法を説明します。最初の手法は、HATS リッチ・クライアント・アプリケーションを実行するために必要なすべてを備えた配布用の完全な Eclipse クライアント環境をパッケージ化するために使用できます。2 つ目の手法は、すでに Eclipse 環境がインストール済みのクライアント用に HATS リッチ・クライアント・アプリケーションをパッケージ化するために使用できます。
Rational SDP のベースとなる Eclipse SDK では、HATS アプリケーション・プラグインと他のすべての必要なプラグインを組み込んだ完全な Eclipse クライアントを生成することができます。このクライアントは、個々のクライアント・システムに配布し、スタンドアロンのアプリケーションとして実行可能です。
クライアント・パッケージを作成するには、以下のステップを実行します。
完全な Eclipse クライアント環境が作成されます。アプリケーションをテストするには、Windows® Explorer を使用して c:¥hostaccess ディレクトリーにナビゲートします。eclipse フォルダーで、eclipse.exe をダブルクリックします。このディレクトリーは、zip して個々のクライアント・マシンにダウンロードできます。クライアント・システムでは、互換性のある Java ランタイム環境 (JRE) 以外のものは不要です。
HATS リッチ・クライアント・アプリケーションを既存の Eclipse クライアント・ランタイム環境に展開するには、以下の手順を実行する必要があります。
以下のセクションでは、これらのタスクのそれぞれを実行する方法を説明しています。
HATS リッチ・クライアント・アプリケーション・プラグインをランタイム環境に展開するには、最初にそれを Eclipse フィーチャーにパッケージ化する必要があります。 Eclipse フィーチャーは、関連したプラグインをパッケージ化するために使用するデプロイメント成果物です。プラグインを Eclipse フィーチャーにパッケージ化するには、以下のステップを実行します。
ライセンス設定を指定していない場合、このアプリケーションではランタイムが有効にされておらず、実稼働環境では実行できないというメッセージが表示されます。 HATS リッチ・クライアント・アプリケーションはローカル・テスト環境 (Eclipse、Lotus Notes、または Lotus Expeditor Client) でテストできますが、最初にライセンス設定を指定しなければ、ランタイム (非開発) 環境で実行することはできません。これは、HATS Toolkit 開発環境でアプリケーションを作成し、それを十分にテストできるという意味です。また、アプリケーションをエクスポートし、ユーザーはそれをインストールできますが、アプリケーションに接続することはできません。つまり、ランタイムはロックダウンされ、どんな接続も許可しません。 ライセンス設定の指定の詳細については、「HATS スタートアップ・ガイド」の『HATS ランタイムの使用可能化とライセンス設定 (Enabling HATS runtime and license settings)』を参照してください。ライセンスを購入済みの場合は、「ランタイムの使用可能化」をクリックして、ランタイム・アプリケーションを使用可能にします。まだ購入していない場合は、「続行」をクリックしてエクスポート・プロセスを続行します。
エクスポート済みの HATS リッチ・クライアント・アプリケーション・フィーチャーは、ランタイム拡張プラグインを自動的に組み込み、HATS ランタイム・フィーチャーへの依存関係を自動的に組み込みます。フィーチャー・プロジェクトは「HATS プロジェクト」ビューには表示されませんが、「ナビゲーター」ビューには表示されます。
HATS リッチ・クライアント・アプリケーション・フィーチャーの向上した拡張構成を実行する場合、「HATS フィーチャー・プロジェクトを作成」ウィザードを使用する代わりに、Eclipse によって提供される標準の Eclipse「新規フィーチャー」ウィザードを使用できます。このウィザードを起動するには、Rational SDP ツールバーから「ファイル」>「新規」>「その他」>「プラグイン開発」>「フィーチャー・プロジェクト」を選択します。このウィザードは基本的に、「HATS フィーチャー・プロジェクトを作成」ウィザードと同じ機能を実行します。ただし、ランタイム拡張プラグインを自動的に組み込んだり、HATS ランタイム・フィーチャーへの必要な依存関係を組み込んだりすることはありません。
実稼働環境では、HATS リッチ・クライアント・アプリケーション・フィーチャーは、クライアントにインストールされている HATS ランタイム・フィーチャーに依存します。 HATS リッチ・クライアント・アプリケーション・フィーチャーを「HATS フィーチャー・プロジェクトを作成」ウィザードを使用して作成すると、HATS ランタイム・フィーチャーに対する依存関係が自動的に組み込まれます。この依存関係は、HATS リッチ・クライアント・アプリケーション・フィーチャーがインストールまたは更新されるときに、フィーチャーのインストールまたは更新プロセスが HATS ランタイム・フィーチャーを更新サイトから自動的にプルダウンするというものです。 HATS ランタイム・フィーチャーには以下のフィーチャーおよびプラグインが含まれています。
Lotus Notes ターゲット・プラットフォームを指定すると、以下の Eclipse フィーチャーも組み込まれます。
HATS ランタイム・フィーチャーをエクスポートするには、以下のステップを実行します。
HATS アプリケーション・フィーチャーと HATS ランタイム・フィーチャーの両方をエクスポートした後、アプリケーションを展開するために、フィーチャーのインストールおよび更新プロセスで使用される更新サイトを作成する必要があります。更新サイトを作成するには、以下のステップを実行します。
指定されたターゲット・プラットフォームが Lotus Notes である場合は、次のフィーチャーも追加します。
更新サイトが作成されました (この例では c:¥myHATS)。これには、どのフィーチャーおよびそれらのフィーチャーのどのバージョンを、クライアントがダウンロードするためのサイトから使用できるかを示す site.xml ファイルが含まれます。これで、クライアントからアクセス可能な Web サーバーに、この更新サイト・ディレクトリーを移動できます。 クライアント・システムで更新サイトを定義し、HATS リッチ・クライアント・アプリケーションをランタイム環境にインストールする方法については、ランタイム環境でのアプリケーションのインストールを参照してください。
HATS リッチ・クライアント・アプリケーションは、Eclipse RCP 環境、Lotus Notes 環境、および Lotus Expeditor Client 環境で実行できます。以下のセクションでは、これらの環境のそれぞれに HATS リッチ・クライアント・アプリケーションをインストールする方法を説明します。
HATS リッチ・クライアント・アプリケーションを Eclipse リッチ・クライアント 環境にダウンロードおよびインストールするには、クライアント環境に Eclipse の EMF サービス・データ・オブジェクト (SDO) フィーチャーが含まれており、そのアプリケーションを含む更新サイトにアクセスするようにクライアントを構成する必要があります。デフォルトでは、自動インストールおよび更新は使用不可にされているため、ユーザーまたは管理者が標準の Eclipse Software Update 機能を使用して新規のフィーチャーまたは更新を手動でインストールする必要があります。これを実行するには、クライアント・システムで以下のステップを実行します。
Eclipse RCP 環境の詳細については、http://www.eclipse.org/home/categories/rcp.php を参照してください。
Lotus Notes 環境では、フィーチャーおよびプラグインとして提供されるアプリケーションのインストールにウィジェットが使用されます。ウィジェットを後でウィジェット・カタログに公開して、その他で使用できるようにすることができます。ウィジェットの詳細については、Lotus Notes インフォメーション・センターの『ウィジェットおよび Live Text』のセクション (http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp?topic=/com.ibm.notes85.help.doc/wid_app_overview_c.html) を参照してください。
HATS リッチ・クライアント・アプリケーションを Lotus Notes 環境にダウンロードおよびインストールするには、クライアント・システムで以下のステップを実行します。


「My Widgets サイドバー」パネルは、次のようになります。

「オープン」>「ホスト・アクセス」を選択することにより、アプリケーションを実行できます。ご使用の HATS アプリケーションが「アプリケーション」ビューにリストされます。アプリケーションを開始するには、アプリケーションをダブルクリックするか、または右クリックして「オープン」を選択します。
HATS アプリケーションをアンインストールするには、HATS Provisioning Widget (または、それに指定した任意の名前) を右クリックし、「除去」を選択します。要求されたら、Lotus Notes を再始動します。
Lotus Expeditor Client 環境では、アプリケーションの管理および展開を以下のいくつかの方法で制御できます。
Lotus Expeditor Client では、デフォルト・インストールに以下のフィーチャーを追加する必要があります。
Lotus Expeditor Client で、「ファイル」>「アプリケーション」>「インストール」>「インストールする新しいフィーチャーの検索」>「フォルダー・ロケーションの追加」を選択します。Lotus Expeditor Client 製品ファイルの desktop¥updates¥platform フォルダーまで参照して行き、「終了」を選択します。「updates/platform」および「Development」を展開します。「Lotus Expeditor デスクトップ開発ユーティリティー」の横のチェック・マークにマークを付けます。「ランタイム・コンポーネント」も展開し、 「サービス・データ・オブジェクト (SDO) コンポーネント」の横のチェック・マークにマークを付けます。「次へ」を選択し、ウィザードを完了します。
Lotus Expeditor Client バージョン 6.2.0 以前の場合、コア JVM フィーチャー - J2SE をインストールするには、Lotus Expeditor Client で、「ファイル」>「アプリケーション」>「インストール」>「インストールする新しいフィーチャーの検索」>「フォルダー・ロケーションの追加」を選択します。Desktop Runtime Environment サイトの場所 (update.site.dre.client ディレクトリー) まで参照して行き、「OK」を選択します。デフォルトのサイト名を受け入れ、「OK」および「終了」を選択します。このサイトおよび「ランタイム・コンポーネント (Runtime Components)」を展開します。「Core JVM フィーチャー -JSE (Core JVM Feature - J2SE)」の横のチェック・マークにマークを付けます。「次へ」を選択し、ウィザードを完了します。
詳しくは、Lotus Expeditor インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/ledoc/v6r2/index.jsp) の『Lotus Expeditor アプリケーションのアセンブルおよびデプロイ』セクションを参照してください。
HATS リッチ・クライアント・アプリケーションを Lotus Expeditor Client 環境にダウンロードおよびインストールするには、そのアプリケーションを含む更新サイトにアクセスするようにクライアントを構成する必要があります。これを実行するには、クライアント・システムで以下のステップを実行します。
リッチ・クライアント環境により、インストールされたアプリケーションの自動更新が可能になります。サーバーの更新が検査される頻度を制御するために、プリファレンスを使用できます。更新をアプリケーションにアップロードしたら、リッチ・クライアントは更新をダウンロードしてインストールします。新規更新のみがダウンロードされてインストールされたことを確認するために、バージョン検査が実行されます。たいていの場合、ユーザーは環境を再始動して、更新されたアプリケーションをアクティブ化する必要があります。詳細については、適切な Eclipse RCP、Lotus Notes、または Lotus Expeditor の資料を参照してください。
すでにインストールされているプラグインを更新するには、その前にプラグインのバージョンを更新する必要があります。これは Eclipse が、そのバージョンを使用してプラグインが変更されたかどうかを判別するためです。例えば、プロジェクト内で画面カスタマイズを追加するか、またはマクロを変更する場合、プロジェクトを再エクスポートする前にプラグインのバージョンを更新する必要があります。
プラグインのバージョンを更新するには、そのプロジェクトの「プロジェクト設定」エディターで、「概要」タブの「プラグイン・マニフェストをオープンしてください。」リンクをクリックします。 「概要」タブの「一般情報」の下で、バージョンを更新します。Eclipse バージョンの形式は major.minor.service です。プロジェクトに対して小さい変更を行う場合は、バージョンの service セグメントを更新します。例えば、プラグインを二度目にエクスポートする前に、プラグインのバージョンを 1.0.1 に設定します。
「ライセンス設定」ウィザードは、ランタイム拡張プロジェクト (com.ibm.hats.rcp.runtime.extension) を更新するため、ウィザードを実行した後、このプラグインのバージョンを更新する必要があります。これを行うには、「ナビゲーター」ビューで、プロジェクトのルートにある plugin.xml ファイルを開きます。 「概要」タブの「一般情報」の下で、バージョンを更新します。
また、フィーチャーはプラグインで構成されている (さらに、フィーチャーにはバージョンもある) ため、組み込まれたプラグインのいずれかのバージョンを更新する場合は、必ずフィーチャーのバージョンも更新する必要があります。これを行うには、「ナビゲーター」ビューに切り替え、フィーチャー・プロジェクト内にある feature.xml ファイルを開きます。デフォルトでは、フィーチャー・プロジェクトの名前は hostaccess です。 「概要」タブの「一般情報」の下で、バージョンを更新します。また、フィーチャーがプラグインの新規バージョンを正しくリストしていることを確認してください。それには、「プラグイン」タブの「バージョン」ボタンをクリックし、「プラグインとフラグメント・マニフェストからバージョンをコピー」を選択します。
フィーチャーのバージョンを更新した後、フィーチャーの新規バージョンがリストされることを確認するために、site.xml ファイルを更新する必要があります (該当する場合)。
HATS リッチ・クライアント・アプリケーションの場合、ログ設定やトレース設定などのランタイム設定は、ランタイム拡張プラグイン (com.ibm.hats.rcp.runtime.extension) の 2 つのファイルで指定されます。
さまざまなテスト・モードでの実行方法の詳細については、「HATS スタートアップ・ガイド」の『リッチ・クライアント・プロジェクトのテスト・モード』を参照してください。
HATS Toolkit で、これらのファイルを編集して、設定 (トレースやトレース・レベルの設定など) を変更できます。ファイルは、ランタイム拡張プラグイン・プロジェクトのルートにあります。HATS Toolkit で runtime.properties ファイルが変更された場合、その変更は保持され、HATS アプリケーションをランタイム環境に展開するときに有効になります。ランタイム環境では、runtime.properties ファイルがランタイム拡張プラグイン・ディレクトリー (例えば、<eclipse_install_dir>/eclipse/plugins/com.ibm.hats.rcp.runtime.extension_1.0.0) にあります。 runtime-debug.properties ファイルは、ランタイム環境では無視されます。これらのファイルでのログ設定とトレース設定について詳しくは、付録A. ランタイム・プロパティー・ファイルを参照してください。
ログ設定とトレース設定を構成し、ランタイム環境で問題判別データを収集する方法について詳しくは、プリファレンスを参照してください。
ワークスペース内には、1 つのランタイム拡張プラグイン・プロジェクトがあり、ランタイム環境にはプラグインの 1 つのバージョンだけがあります。そのため、単一の HATS リッチ・クライアント・ランタイム環境では、ログおよびトレース設定は、すべての HATS リッチ・クライアント・アプリケーションで同じです。
ライセンス設定は、ランタイム拡張プラグイン (com.ibm.hats.rcp.runtime.extension) の runtime.properties ファイルにも保管されます。そのため、ライセンスのトラッキングは、個々の HATS リッチ・クライアント・アプリケーションのレベルではなく、リッチ・クライアント環境レベルで実行されます。ユーザーが購入済みのライセンス数を超えた場合、ログに警告メッセージが表示されます。 ライセンス設定の指定については、「HATS スタートアップ・ガイド」の『HATS ランタイムの使用可能化とライセンス設定 (Enabling HATS runtime and license settings)』を参照してください。
「アプリケーション」ビューは、ランタイム環境にインストールされたすべてのアクティブな HATS リッチ・クライアント・アプリケーションをユーザーに表示します。ビューはアプリケーション表示名でソートされます。デフォルトでは、このビューは、ユーザーが初めて「ホスト・アクセス」パースペクティブを開くときに表示されます。ユーザーは、「アプリケーション」ビューでアプリケーションをダブルクリックするか、またはアプリケーション名を右クリックして「オープン」を選択することにより、HATS アプリケーションの新規インスタンスを開始します。
HATS アプリケーションの新規インスタンスが開始すると、その「変換」ビューが表示されます。 詳細については、「変換」ビューを参照してください。デフォルトでは、新規にオープンした「変換」ビューの名前がアプリケーションの名前になります。アプリケーションの複数のインスタンスが開始される場合、「変換」ビューの名前は、アプリケーションの名前とセッションのインスタンスを示す番号の組み合わせになります。例えば、Order Entry という名前のアプリケーションの 2 番目のインスタンスのタイトルは、Order entry : 2 となります。
デフォルトでは、ユーザーは同じアプリケーションの複数インスタンスを起動できます。複数インスタンスの起動を使用不可にするように plugin.xml ファイルを変更できます。また、「アプリケーション」ビューを表示しないで、代わりにユーザーが使用可能なビューを制御するように決定することもできます。これにより、アプリケーションのインスタンスの数も制限できます。 詳しくは、「HATS リッチ・クライアント・プラットフォーム・プログラマーズ・ガイド」を参照してください。
アプリケーションがローカル・テスト環境で実行されており、表示端末を表示することを選択した場合、システムに対する接続が行われると、「端末の表示」ウィンドウが表示されます。セッションが終了するとき、またはクライアントがシャットダウンされる場合、このウィンドウはクローズします。
ポップアップ・メニューは、ユーザーがビュー内の 1 つ以上のアプリケーションに対してアクションを実行できるように提供されます。メニューを表示するには、1 つ以上のアプリケーション名を選択し、右クリックします。以下のメニュー項目を使用できます。
オーバーライドを許可する場合、このページでユーザーは接続パラメーターをオーバーライドすることができます。この機能は Web アプリケーション用の HATS 機能に相当します。この HATS 機能は、最初にアプリケーションにアクセスするときに URL を使用して接続パラメーターをオーバーライドできるようにします。接続パラメーターのオーバーライドを使用する例は、ユーザーがワークステーション ID または LU 名をオーバーライドする必要がある場合です。
ユーザーがオーバーライドを設定するには、「追加」ボタンをクリックし、「名前」フィールドのドロップダウン・リストからパラメーターを選択して、「値」フィールドに値を設定します。提供された接続パラメーター名をオーバーライドできるかどうかをユーザーに警告するために、ダイアログ内の妥当性検査は実行されません。デフォルトでは、最初に追加されるときにオーバーライド設定が使用可能になります。パラメーター名の隣のチェック・ボックスをクリアすると、この設定を使用不可にすることができます。
ユーザーが接続パラメーターをオーバーライドすると、設定はローカル・ワークスペースに保存されます。セッションのインスタンスが開始されるときに、オーバーライドされたパラメーター値が使用されます。
接続パラメーターのオーバーライドを使用してリッチ・クライアント・アプリケーションのインスタンスをプログラマチックに開始する方法については、「HATS リッチ・クライアント・プラットフォーム・プログラマーズ・ガイド」を参照してください。
オーバーライドを許可する場合、このページでユーザーはグローバル変数をオーバーライドすることができます。この機能は Web アプリケーション用の HATS 機能に相当します。この HATS 機能は、最初にアプリケーションにアクセスするときに URL を使用してグローバル変数および共用グローバル変数をオーバーライドできるようにします。
この機能は、ユーザー固有の変数データをアプリケーションで使用できるようにします。例えば、グローバル変数の値から提供されたユーザー名およびパスワードを要求するマクロを記録できます。ユーザーは変数のオーバーライド・ページでこれらの値を提供することができます。サインオン画面が認識されるときにマクロが実行されると、これらの値が使用されます。
ユーザーがオーバーライドを設定するには、「追加」ボタンをクリックし、「名前」フィールドのドロップダウン・リストから変数名を選択して、「値」フィールドに値を設定します。さらに、グローバル変数が「共用」 かどうかを指定します。提供されたグローバル変数名をオーバーライドできるかどうかをユーザーに警告するために、ダイアログ内の妥当性検査は実行されません。デフォルトでは、最初に追加されるときにオーバーライド設定が使用可能になります。変数名の隣のチェック・ボックスをクリアすると、この設定を使用不可にすることができます。
ユーザーがグローバル変数をオーバーライドすると、設定は環境のデータ・ディレクトリーに保管されます。セッションのインスタンスが開始されるときに、オーバーライドされたグローバル変数値が使用されます。
グローバル変数のオーバーライドを使用してリッチ・クライアント・アプリケーション・インスタンスをプログラマチックに開始する方法については、「HATS リッチ・クライアント・プラットフォーム・プログラマーズ・ガイド」を参照してください。
リッチ・クライアント環境では、ユーザーは、「ファイル」 メニューから「印刷」を選択することにより、現行の画面変換を印刷できます。デフォルトでは、Eclipse は「印刷」ダイアログを表示します。このダイアログで、ユーザーはプリンターを選択したり、またその他のオプションを構成したりできます。ユーザーが「OK」をクリックした後、変換ビューの変換領域が選択したプリンターに送信されます。
「変換」ビューは、リッチ・クライアント環境内の変換のメイン領域です。それぞれの HATS リッチ・クライアント・プロジェクトには、1 つの変換ビューが関連付けられます。プロジェクトが作成されると、そのプロジェクトの plugin.xml ファイルにビューが登録されます。ビューは以下の 4 つの領域で構成されます。
変換ビュー・ツールバーには、アプリケーション・レベルのアクション用のボタンと、画面レンダリング中にツールバー・ウィジェットによって提供されるアクション用のボタンが含まれます。デフォルトでは、ツールバーが表示され、テキストのみの表題が付いたボタンが表示されます。これらの設定はプロジェクト設定で変更できます。詳細については、ツールバー RCP のみ を参照してください。
ツールバーは 2 つのセクションに分割されます。ツールバーの右側は、HATS Web アプリケーションのアプリケーション・キーパッドに相当し、アプリケーション・キーパッド・ボタンがあります。表示するボタンの構成方法については、アプリケーション・キーパッドを参照してください。左側には、ツールバー・ウィジェットによって提供されるボタンが表示されます。詳細については、ツールバー RCP のみ を参照してください。
ボタンの機能の説明を提供するツールチップ・テキストが、すべてのアプリケーション・キーパッド・ボタンで使用できます。ツールバー・ウィジェットを使用して、追加するボタン上にツールチップ・テキストを設定できます。
ツールバーのアプリケーション・キーパッド・ボタンの上にある「最小化」および「最大化」アイコンの隣が「メニュー」アイコンです。このアイコンをクリックすると、以下のメニュー項目を持つメニューが表示されます。
テンプレートおよび変換領域は変換ビューのメイン部分で、ここにすべての画面変換が表示されます。また、エラー・メッセージ、切断メッセージ、およびマクロ・ハンドラー・パネルが表示される領域です。
ホスト・キーパッドには、プロジェクト設定で表示することを選択したホスト・キーが表示されます。ホスト・キーパッドの構成方法については、ホスト・キーパッドを参照してください。デフォルトでは、ホスト・キーパッドは表示されません。
OIA 状況域には、プロジェクト設定で構成したセッションの状態に関する情報が表示されます。 OIA 状況域の構成方法については、オペレーター情報域を参照してください。
ビューがクローズされると、ホスト・システムへの接続がクローズされます。これは、ユーザーがビューを明示的にクローズしたり、リッチ・クライアント環境をクローズする場合に発生します。クローズされると、切断および停止イベントで定義されたアクションのセットが処理されます。
ホスト接続を作成または編集するときに、ユーザーに対して 5250 ホストに接続するためのワークステーション ID の入力を求めるプロンプトが表示されるように指定できます。詳細については、接続の作成を参照してください。ワークステーション ID のプロンプト表示を指定する場合、最初にホストへの接続を行うときに、ユーザーにプロンプト・ダイアログが表示されます。そこで、ユーザーは「ワークステーション ID」フィールドにワークステーション ID を入力できます。
選択した場合にワークステーション ID が保存され、今後はプロンプトが表示されないようにするチェック・ボックスが提供されます。チェック・ボックスが選択される場合、後でこのプロンプト表示を復元するには、アプリケーションのプロパティーで workstationID 接続パラメーターのオーバーライドを使用不可にします。詳細については、接続パラメーターを参照してください。
ホスト接続を作成または編集するときに、ユーザーに対して 3270E ホストに接続するための LU 名の入力を求めるプロンプトが表示されるように指定できます。詳細については、接続の作成を参照してください。LU 名のプロンプト表示を指定する場合、最初にホストへの接続を行うときに、ユーザーにプロンプト・ダイアログが表示されます。ユーザーは、「LU 名」フィールドに LU 名を入力する必要があります。
選択した場合に LU 名が保存され、今後はプロンプトが表示されないようにするチェック・ボックスが提供されます。チェック・ボックスが選択される場合、後でこのプロンプト表示を復元するには、アプリケーションのプロパティーで LUName 接続パラメーターのオーバーライドを使用不可にします。詳細については、接続パラメーターを参照してください。
デフォルトでは、ランタイム・プラットフォームのメニュー・バーから「ファイル」>「プリファレンス」>「ホスト・アクセス」を選択することにより、ユーザーはプリファレンスにアクセスできます。表示されるページは、ランタイム拡張プラグインに登録されます。これらの機能をユーザーに提供しない場合、ランタイム拡張プラグインの plugin.xml ファイル内の該当する宣言を除去できます。これを行う方法について詳しくは、「HATS リッチ・クライアント・プラットフォーム・プログラマーズ・ガイド」の『HATS ランタイム拡張プラグイン』セクションにある org.eclipse.ui.preferencePages 拡張ポイント ID の説明を参照してください。以下の設定が選択されています。
以下の印刷プリファレンスは、3270 印刷をサポートするアプリケーションのユーザーが設定できます。
印刷ジョブが開始されていることをユーザーに示すメッセージが表示されます。
「印刷ジョブ {0} が完了しました。」というメッセージが表示されます。ここで、{0} は、印刷ジョブ名です。
「印刷ジョブ {0} でエラーが発生しました。」というメッセージが表示されます。ここで、{0} は、印刷ジョブ名です。
以下のトラブルシューティング・プリファレンスは、ユーザーが設定できます。ログ設定とトレース設定について詳しくは、HATS リッチ・クライアント・アプリケーションの管理を参照してください。
トレース・ファイルはリッチ・クライアント環境のホスト・シミュレーション・フォルダーに保存されます。例えば、Windows の Eclipse RCP 環境では、<Eclipse installation directory>¥plugins¥<ApplicationName_version>¥profiles¥hostsimulations¥ に保存されます。Windows の Lotus Notes 環境では、<Lotus Notes installation directory>¥Data¥workspace¥applications¥eclipse¥plugins¥<ApplicationName_version>¥profiles¥hostsimulations¥に保存されます。 Windows の Lotus Expeditor Client 環境では、<Lotus Expeditor Client installation directory>\shared\eclipse\plugins\<ApplicationName_version>\profiles\hostsimulations に保存されます。Linux の Lotus Expeditor Client 環境では、/opt/IBM/Lotus/Expeditor/shared/eclipse/plugins/<ApplicationName_version>/profiles/hostsimulations/に保存されます。
トレース・ファイル名は、ApplicationName_ConnectionName_Date(yyyymmdd)_Time(hhmmss)_Number というテンプレートを使用して指定されます (例えば、MyApplication_main_20060101_134543_1)。
HATS リッチ・クライアント・アプリケーションを使用する際の考慮事項と制限のリストを次に示します。
これは、https://bugs.eclipse.org/bugs/show_bug.cgi?id=100144 の Bug 100144: Need a pattern for cleaning up font/image/color resources で解説されている既知の問題です。この問題があるため、フォント、イメージ、または色のリソースを HATS リッチ・クライアントのテンプレートまたは変換に追加する場合は、クリーンアップ・ロジックを手動で追加する必要があります。システムの色を追加する場合にクリーンアップ・ロジックを追加する必要はありません。これはシステムによって割り振られます。
例えば、Visual Editor を使用して新規の色リソースを追加し、以下のコードが生成される場合、
sideBarArea.setBackground(new Color(Display.getCurrent(), 221, 228, 255));
以下のコード行を手動で追加して、ウィジェットが破棄されるときに色をクリーンアップする必要があります。
sideBarArea.addDisposeListener(new DisposeListener(){
public void widgetDisposed(DisposeEvent e){
Color background = sideBarArea.getBackground();
if (background != null && !background.isDisposed()) {
background.dispose();
}
}
});
HATS が提供する ColorManager クラスを使用する場合、色リソースをクリーンアップする必要はありません。しかし、Visual Editor が提供する Properties Editor の代わりに Java エディターを使用してコードを作成する必要があります。以下は、ColorManager を使用するサンプル・コードです。
sideBarArea.setBackground(com.ibm.hats.rcp.ui.misc.ColorManager.
getInstance(Display.getCurrent()).getColor(221, 228, 255));
別の例として、Visual Editor を使用してイメージをテンプレートに手動で追加する場合、イメージを追加するコードとイメージ・リソースをクリーンアップするコードは以下のようになります。
label = new Label(bannerArea, SWT.RIGHT);
gridData = new GridData(SWT.END, SWT.CENTER, true, true);
label.setImage(new Image(Display.getCurrent(),
getClass().getResourceAsStream("/images/myimage.gif")));
label.setLayoutData(gridData);
label.addDisposeListener(new DisposeListener() {
public void widgetDisposed(DisposeEvent e){
Image image = label.getImage();
if (image != null && !image.isDisposed()) {
image.dispose();
}
}
});