HATS リッチ・クライアント・アプリケーションの開発とデプロイ

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 リッチ・クライアント・アプリケーションを構築およびテストするためのステップは、基本的に 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 RCP ランタイム拡張プロジェクト com.ibm.hats.rcp.runtime.extension は、HATS リッチ・クライアント・プロジェクトと同じコンパイラー準拠レベルでなければなりません。HATS RCP ランタイム拡張プロジェクト を参照してください。

HATS RCP ランタイム拡張プロジェクト

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 リッチ・クライアント・プロジェクトが削除されるときには削除されません。新規のランタイム拡張プロジェクトを作成する場合は、手動で削除する必要があります。

HATS リッチ・クライアント・プロジェクトの処理

HATS Web プロジェクトと同じように、新規 HATS リッチ・クライアント・プロジェクトを作成すると、HATS ファイルを編成するために利用できる一組のフォルダーが作成されます。以下にデフォルト・プロジェクトの例を示します。 最上位のフォルダーの名前は、作成するプロジェクトに付けた名前と同じです。このフォルダーの中には、HATS プロジェクトで定義したオブジェクトを含む他の上位フォルダーが入っています。 一部のフォルダーは、特定のオブジェクトが作成されるまで表示されません。

図 6. 「HATS リッチ・クライアント・プロジェクト」ビュー
「HATS リッチ・クライアント・プロジェクト」ビュー

プロジェクトのセットアップ方法に応じて、これらのフォルダーの一部またはすべてが「HATS プロジェクト」ビューに表示されます。また、「HATS プロジェクト」ビューに表示するフォルダーや、非表示にするファイル拡張子を指定することもできます。詳しくは、HATS プリファレンスの使用を参照してください。

注:
  1. リッチ・クライアント・プロジェクトは「リッチ・クライアント・コンテンツ」フォルダーを表示します。このフォルダーで、Web プロジェクトは「Web コンテンツ」フォルダーを表示します。
  2. 「リッチ・クライアント・コンテンツ」フォルダーは、リッチ・クライアント・プロジェクトの root レベルに表示されます。ただし、プロジェクトには実際の「リッチ・クライアント・コンテンツ」フォルダーはありません。Web プロジェクト用に表示される「Web コンテンツ」フォルダーとの整合性を作成するためにのみ、1 つのフォルダーが動的に表示されます。
  3. 動的に表示された「リッチ・クライアント・コンテンツ」フォルダーの下に表示されるフォルダーのいくつかは「ソース」フォルダーの下にも表示されます。
  4. 動的に表示されたリッチ・クライアント・フォルダー用のラベル・デコレーターが正しく装飾しないことがあります。これは、それらのフォルダーがプロジェクト内の物理フォルダーにマップしていないためです。

プロジェクトのファイルの編成をわかりやすくするために、これらの上位サブフォルダーの内部にもフォルダーを作成することができます。例えば、プロジェクト用の画面キャプチャーを作成するときに、「Screen Captures」フォルダーの下に、取り込んだ画面を編成してグループ化するためのフォルダーを作成することができます。フォルダーを作成するには、ツリー内の上位フォルダーの 1 つを右マウス・ボタンでクリックし、「新規 HATS」>「フォルダー」を選択します。ファイルを別のフォルダーに移すには、該当ファイルを右マウス・ボタンでクリックして「移動」を選択するか、ドラッグ・アンド・ドロップ方式を使用します。

HATS パースペクティブの「ナビゲーター」ビューに進むと、HATS プロジェクトをチーム環境で共用できます。プロジェクトを右クリックして、「チーム」>「プロジェクトの共用」を選択します。リストからリポジトリー・タイプを選択し、「次へ」をクリックします。Rational SDP は、いくつかのリポジトリーをサポートしています。詳しくは、Rational SDP の資料を参照して「リポジトリー」を検索してください。

Web プロジェクトとリッチ・クライアント・プロジェクトの間でのリソースのコピー

「HATS プロジェクト」ビューのポップアップ・メニューを使用して、リッチ・クライアント・リソースのコピー、貼り付け、削除、移動、および名前変更を行うことができます。以下のリソースを、HATS Web プロジェクトと HATS リッチ・クライアント・プロジェクトの間でコピーまたは移動できます。

注:
変換、変換フラグメント、またはテンプレートを HATS Web プロジェクトと HATS リッチ・クライアント・プロジェクトの間でコピーすることは許可されていません。

異なるタイプのプロジェクトからコピーされたリソースによっては、変更を必要とするものがあります。例えば、HATS Web プロジェクトから HATS リッチ・クライアント・プロジェクトにコピーされたマクロは、有効な SWT Java マクロ・ハンドラーを参照するように更新される必要があります (HATS Web プロジェクトの場合、マクロは JSP マクロ・ハンドラーを参照します)。また、適用アクションで指定された JSP 変換の参照や転送アクションで指定された URL により、画面カスタマイズを更新する必要もあります。問題を検出し、修正するために、警告メッセージが「問題」ビューに表示されます。以下のシナリオには警告が出されます。

HATS Web アプリケーションを HATS RCP アプリケーションにマイグレーションするための組み込み機能はありません。画面のカスタマイズ、マクロ、接続、画面キャプチャー、イメージ、ビジネス・ロジック・ソース・ファイル、およびカスタム・コンポーネント・ソース・ファイルなどの成果物は、最小限の変更を加えるだけで 1 つのプロジェクト・タイプから別のプロジェクト・タイプに手動でマイグレーション可能です。変換、カスタム・ウィジェット、テンプレート、およびカスタム・マクロ・ハンドラーなどの他の成果物は、異なるタイプのプロジェクトで使用するためにより多くの変更を必要とします。

HATS リッチ・クライアント・プロジェクトのエクスポートとインポート

HATS リッチ・クライアント・プロジェクトを Rational SDP がインストールされている別のシステムに移動するか、またはその他の理由でプロジェクトを保存および復元するには、Rational SDP のエクスポートおよびインポート機能を使用できます。

エクスポート

Rational SDP のプロジェクト交換機能を使用して、プロジェクトとその従属プロジェクトを .zip ファイルとしてエクスポートします。この機能には、複数の特長があります。この機能では、複数のプロジェクトと必要なランタイム拡張プロジェクト (com.ibm.hats.rcp.runtime.extension) をすべて同時にエクスポートできます。この場合、プロジェクト交換ファイルをインポートする前に、宛先の HATS Toolkit でプロジェクトを作成する必要はありません。 HATS Toolkit からプロジェクトをプロジェクト交換ファイルとしてエクスポートするには、次の手順を実行します。

  1. メニュー・バーから、「ファイル」>「エクスポート」をクリックして、「エクスポート」ウィザードを開きます。
  2. 「その他」>「プロジェクト交換」を選択し、「次へ」をクリックします。
  3. エクスポートするプロジェクトを選択します。
    注:
    HATS リッチ・クライアント・プロジェクトでは、実行するためにランタイム拡張プロジェクト (com.ibm.hats.rcp.runtime.extension) が必要です。そのため、ランタイム拡張プロジェクトをプロジェクト交換ファイルの一部としてエクスポートするか、または新規の HATS リッチ・クライアント・プロジェクトを作成することによって宛先システム上で新規のランタイム拡張プロジェクトを作成する必要があります。
  4. プロジェクトを保存する .zip ファイルの名前と場所を指定します。
  5. 「完了」をクリックします。

インポート

プロジェクト交換 .zip ファイルを HATS Toolkit にインポートするには、次の手順を実行します。

  1. メニュー・バーから、「ファイル」>「インポート」をクリックして、「インポート」ウィザードを開きます。
  2. 「その他」>「プロジェクト交換」を選択し、「次へ」をクリックします。
  3. 「ソース ZIP ファイル」フィールドに、インポートする .zip ファイルを指定します。
  4. .zip ファイルを「プロジェクト・ロケーション・ルート」フィールドにインポートするワークスペースを指定します。
  5. 指定したワークスペースにインポートする「プロジェクト交換」ファイル内のプロジェクトを選択します。
    注:
    HATS リッチ・クライアント・プロジェクトでは、実行するためにランタイム拡張プロジェクト (com.ibm.hats.rcp.runtime.extension) が必要です。そのため、ランタイム拡張プロジェクトをプロジェクト交換ファイルの一部としてインポートするか、または新規の HATS リッチ・クライアント・プロジェクトを作成することによって新規のランタイム拡張プロジェクトを作成する必要があります。
  6. 「完了」をクリックします。

HATS リッチ・クライアント・アプリケーションのテスト

ターゲット・プラットフォームの構成

HATS リッチ・クライアント・アプリケーション・プラグインをローカル・テスト環境でテストするには、そのプラグインと必要なランタイム・プラグインをターゲット・プラットフォームの 1 つのインスタンスで起動します。ターゲット・プラットフォームは Eclipse 製品 (例えば、Eclipse RCP、Lotus Notes、または Lotus Expeditor Client) を参照し、それに対して開発中のプラグインがコンパイルおよびテストされます。ターゲット・プラットフォームを構成するには、Rational SDP の「ウィンドウ」>「設定」>「プラグイン開発」>「ターゲット・プラットフォーム」ダイアログを使用します。

Lotus Notes

テスト用 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 メニュー・バーで「ウィンドウ」>「設定」>「クライアント・サービス」を使用して、構成ダイアログを表示するようオプションを再設定できます。

図 7. Lotus Notes テスト環境構成
Lotus Notes テスト環境構成

Lotus Expeditor

テスト用 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 メニュー・バーで「ウィンドウ」>「設定」>「クライアント・サービス」を使用して、この構成ダイアログを表示するようオプションを再設定できます。

注:
この構成ダイアログを初めて開いた場合、「VM 名」に com.ibm.rcp.j2se.win32.x86 と表示される可能性があります。

図 8. Lotus Expeditor テスト環境構成
Lotus Expeditor テスト環境構成

ローカル・テスト環境でテストすることに加えて、プロジェクトをアプリケーションとしてエクスポートし、それをランタイム環境で展開して、展開プロセスをテストする必要があります。詳しくは、HATS リッチ・クライアント・アプリケーションのデプロイを参照してください。

ランタイム・プラグインのインストール

HATS リッチ・クライアント・アプリケーション・プラグインがターゲット・プラットフォームのローカル・テスト環境で実行されるには、必要なランタイム・プラグインをターゲット・プラットフォームにインストールする必要があります。新規プロジェクトを作成し、ターゲット・プラットフォームを選択するか、または後でターゲット・プラットフォームを変更する場合、HATS Toolkit は必要なランタイム・プラグインがインストールされており、選択したターゲット・プラットフォームで最新レベルになっているかどうかを検出します。そうなっていない場合、ツールキットにより、最新のランタイム・プラグインをインストールするように求めるプロンプトが出されます。このプロンプトは、HATS プリファレンスを使用して使用可能または使用不可にすることができます。 詳細については、HATS プリファレンスの使用を参照してください。以下は、インストールされている必須のランタイム・プラグインです。

Lotus Notes ターゲット・プラットフォームの場合、以下の Eclipse プラグインもインストールされます。

注:
デフォルトでは、ターゲット・プラットフォームは Rational SDP そのものです。 HATS Toolkit は Rational SDP にインストールされるため、HATS ランタイム・プラグインは既にインストールされており、デフォルトのターゲット・プラットフォームを使用している場合はプロンプトが表示されません。

最新の HATS ランタイム・プラグインをターゲット・プラットフォームにインストールした後、新規のプラグインを再ロードする必要があります。これを実行するには、Rational SDP の「ウィンドウ」>「設定」>「プラグイン開発」>「ターゲット・プラットフォーム」ダイアログを使用して、「再ロード」をクリックします。

デフォルト JRE の設定

ターゲット・プラットフォームを構成し、ランタイム・プラグインをインストールすることに加えて、Rational SDP でワークスペースのデフォルト JRE を設定する必要が生じる可能性があります。

Eclipse RCP

Eclipse RCP ターゲット・プラットフォームでテストする場合は、デフォルト JRE を jdk に設定します。これを実行するには、以下のステップを実行します。

  1. Rational SDP メニュー・バーから、「ウィンドウ」>「設定」>「Java」>「インストール済みの JRE」を選択します。
  2. インストールされた JRE のリストで、jdk の隣のボックスを選択します。
  3. 「OK」をクリックします。

JRE を一致させてください。例えば、Java 1.6 を稼働する Eclipse 環境でテストする場合は、ワークスペースの JRE をランタイム環境の JRE に一致するように更新する必要があります。

Lotus Notes

Lotus Notes ターゲット・プラットフォームでテストするときは、Lotus Expeditor Toolkit 構成ダイアログ (図 7を参照) を使用してワークスペース用のデフォルトの JRE が既に設定されている可能性があります。設定されていない場合は、以下のステップを実行します。

Lotus Expeditor Client

Lotus Expeditor ターゲット・プラットフォームでテストするときは、Lotus Expeditor Toolkit 構成ダイアログ (図 8を参照) を使用してワークスペース用のデフォルトの JRE が既に設定されている可能性があります。設定されていない場合は、以下のステップを実行します。

  1. Rational SDP メニュー・バーから、「ウィンドウ」>「設定」>「Java」>「インストール済みの JRE」を選択します。
  2. 必ず Java SE 6.0 Win32 x86 JRE を選択してください。
    注:
    Java SE 6.0 Win32 x86 JRE が表示されない場合は、クリーンなワークスペースで開始する、つまり新規のワークスペース・ディレクトリーに切り替える必要があります。
  3. 「OK」をクリックします。

プロジェクトの起動

プロジェクトを起動するには、起動構成が必要です。ご使用のプロジェクトの 「実行」または「デバッグ」をクリックすると、HATS により、デフォルトの起動構成が作成されます (以下のセクションの説明を参照してください)。 起動構成は、「実行」または「デバッグ」ダイアログが別のビュー、例えば「パッケージ・エクスプローラー」ビューから開かれているときは、作成されません。デフォルトの起動構成は、「新規プロジェクト」ウィザードまたは「プロジェクト設定」エディターで設定される、プロジェクトのターゲット・プラットフォームに基づいています。デフォルトの起動構成をランタイム・ワークベンチをもはや起動できないポイントに変更すると、起動構成を削除することができ、「実行」または「デバッグ」を再びクリックすると、HATS により、起動構成が再作成されます。プロジェクトを起動するには、以下のセクションのターゲット・プラットフォームについての説明に従ってください。

Eclipse RCP

プロジェクトを Eclipse RCP 用のローカル・テスト環境で起動するには、以下のステップを実行します。

  1. 「HATS プロジェクト」ビューから、プロジェクトを右クリックし、「実行」または「デバッグ」を選択します。
  2. 「デバッグ」を選択した場合は、「端末の表示」ダイアログで「はい」、「いいえ」、「キャンセル」で応答して、アプリケーションのテスト中にホスト表示端末を表示するかどうかを指定します。
  3. 「実行」(または「デバッグ」) 構成ダイアログで、HATS は hostaccess という名前のデフォルトの起動構成を自動的に作成して構成します。
  4. 「メイン」タブの「実行するプログラム」セクションで、「プロダクトの実行」フィールドに com.ibm.hats.rcp.runtime.extension.product が表示されていることを確認します。
  5. 「実行」 (または「デバッグ」) をクリックして、デフォルト構成を起動します。
  6. Eclipse ワークベンチの新規インスタンスが起動されます。
  7. 「ホスト・アクセス」パースペクティブが自動的に開きます。
  8. ご使用の HATS アプリケーションが「アプリケーション」ビューにリストされます。アプリケーションを開始するには、アプリケーションをダブルクリックするか、または右クリックして「オープン」を選択します。
  9. 選択されたアプリケーションの新規インスタンスがオープンされ、その変換ビューが表示されます。

Lotus Notes

Lotus Notes を対象とした HATS プラグインをローカルにテストするには、Lotus Expeditor Toolkit および Lotus Notes を Rational SDP と同じ開発ワークステーションにインストールする必要があります。同時に実行できる Lotus Notes インスタンスは 1 つのみであるため、プロジェクトをテストしようとするときに Lotus Notes が既に実行されていてはなりません。 ターゲット・プラットフォームの構成を参照してください。

プロジェクトを Lotus Notes 用のローカル・テスト環境で起動するには、以下のステップを実行します。

  1. 「HATS プロジェクト」ビューから、プロジェクトを右クリックし、「実行」または「デバッグ」のいずれかを選択します。
  2. 「デバッグ」を選択した場合は、「端末の表示」ダイアログで「はい」、「いいえ」、または「キャンセル」で応答して、アプリケーションのテスト中にホスト表示端末を表示するかどうかを指定します。
  3. 「実行」(または「デバッグ」) 構成ダイアログで、HATS は hostaccess という名前のデフォルトの起動構成を自動的に作成して構成します。
  4. 「メイン」タブの「実行するプログラム」セクションで、「プロダクトの実行」フィールドに com.ibm.notes.branding.notes が表示されていることを確認します。
  5. 「メイン」タブの「Java ランタイム環境」セクションで、「ランタイム JRE」フィールドに Notes 8.5.1 VM がリストされていることを確認します。詳しくは、Lotus Notesを参照してください。
  6. 「実行」 (または「デバッグ」) をクリックして、構成を起動します。
  7. Lotus Notes の新規インスタンスを起動します。
  8. メイン・ツールバーで「オープン」をクリックし、「ホスト・アクセス」を選択します。
  9. ご使用の HATS アプリケーションが「アプリケーション」ビューにリストされます。アプリケーションを開始するには、アプリケーションをダブルクリックするか、または右クリックして「オープン」を選択します。
  10. 選択されたアプリケーションの新規インスタンスがオープンされ、その変換ビューが表示されます。

Lotus Expeditor Client

Lotus Expeditor を対象とした HATS プラグインをローカルにテストするには、Lotus Expeditor Toolkit および Lotus Expeditor Client for Desktop を Rational SDP と同じ開発ワークステーションにインストールする必要があります。ターゲット・プラットフォームの構成を参照してください。

プロジェクトを Lotus Expeditor Client 用のローカル・テスト環境で起動するには、以下のステップを実行します。

  1. 「HATS プロジェクト」ビューから、プロジェクトを右クリックし、「実行」または「デバッグ」を選択します。
  2. 「デバッグ」を選択した場合は、「端末の表示」ダイアログで「はい」、「いいえ」、「キャンセル」で応答して、アプリケーションのテスト中にホスト表示端末を表示するかどうかを指定します。
  3. 「実行」(または「デバッグ」) 構成ダイアログで、HATS は hostaccess という名前のデフォルトの起動構成を自動的に作成して構成します。
  4. 「メイン」タブの「実行するプログラム」セクションで、「プロダクトの実行」フィールドに com.ibm.rcp.platform.personality.branding.DefaultProduct が表示されていることを確認します。
  5. 「メイン」タブの「Java ランタイム環境」セクションで、「ランタイム JRE」フィールドに「Java SE 6.0 Win32 x86」がリストされていることを確認します。詳しくは、Lotus Expeditor Clientを参照してください。
  6. 「実行」 (または「デバッグ」) をクリックして、構成を起動します。
  7. Lotus Expeditor Client の新規インスタンスを起動します。クライアントが初めて開始するときには、新規パスワードを入力するよう求めるプロンプトが出されます。
  8. メイン・ツールバーで「オープン」をクリックし、「ホスト・アクセス」を選択します。
  9. ご使用の HATS アプリケーションが「アプリケーション」ビューにリストされます。アプリケーションを開始するには、アプリケーションをダブルクリックするか、または右クリックして「オープン」を選択します。
  10. 選択されたアプリケーションの新規インスタンスがオープンされ、その変換ビューが表示されます。

HATS リッチ・クライアント・アプリケーションのデプロイ

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 リッチ・クライアント・アプリケーションをパッケージ化するために使用できます。

配布用の Eclipse クライアント環境のパッケージ化

Rational SDP のベースとなる Eclipse SDK では、HATS アプリケーション・プラグインと他のすべての必要なプラグインを組み込んだ完全な Eclipse クライアントを生成することができます。このクライアントは、個々のクライアント・システムに配布し、スタンドアロンのアプリケーションとして実行可能です。

注:
以下の指示を実行する前に、HATS リッチ・クライアント・プラグイン・プロジェクトがすでに作成され、ローカル・テスト環境で実行されているものとします。

クライアント・パッケージを作成するには、以下のステップを実行します。

  1. 「HATS プロジェクト」ビューで、HATS リッチ・クライアント・プロジェクトを右クリックし、ポップアップ・メニューから「新規 HATS」>「製品構成」を選択します。これにより、「新規製品構成」ウィザードが起動します。また、「ファイル」>「新規」>「その他」>「プラグイン開発」>「製品構成」>「次へ」を選択して、このウィザードを Rational SDP メニュー・バーから起動することもできます。
  2. com.ibm.hats.rcp.runtime.extension プラグイン・プロジェクトのフォルダーを親フォルダーとして選択します。
  3. 「ファイル名」フィールドに hostaccess.product と入力します。
  4. 「起動構成の使用」ラジオ・ボタンを選択して、hostaccess を選択します。
    注:
    この例では、hostaccess は、ローカル・テスト環境でアプリケーションのテストを行ったときに使用した「実行」または「デバッグ」の構成のデフォルト名です。
  5. 「完了」をクリックします。
  6. 製品構成エディターが開いたら、「構成」タブをクリックし、プラグイン・リストから以下の不要なプラグインを除去します。
  7. Rational SDP ツールバーの「保存」アイコンをクリックしてファイルを保存します。
  8. 「概要」タブをクリックし、「Eclipse 製品のエクスポート・ウィザード」のリンクをクリックします。
  9. 「宛先」の下の「ディレクトリー」フィールドに、Eclipse 製品のエクスポート先ディレクトリーの名前を入力します。例えば、c:¥hostaccess と入力します。あるいは、アーカイブ (.zip) ファイルにエクスポートすることもできます。これは、クライアント・パッケージを 1 つのファイル・ダウンロードとして使用できるようにする場合に便利です。
  10. 「完了」をクリックします。

完全な Eclipse クライアント環境が作成されます。アプリケーションをテストするには、Windows® Explorer を使用して c:¥hostaccess ディレクトリーにナビゲートします。eclipse フォルダーで、eclipse.exe をダブルクリックします。このディレクトリーは、zip して個々のクライアント・マシンにダウンロードできます。クライアント・システムでは、互換性のある Java ランタイム環境 (JRE) 以外のものは不要です。

既存の Eclipse クライアントのパッケージ化 (Eclipse RCP、Lotus Notes、または Lotus Expeditor Client)

HATS リッチ・クライアント・アプリケーションを既存の Eclipse クライアント・ランタイム環境に展開するには、以下の手順を実行する必要があります。

以下のセクションでは、これらのタスクのそれぞれを実行する方法を説明しています。

プロジェクトを Eclipse フィーチャーとしてエクスポート

HATS リッチ・クライアント・アプリケーション・プラグインをランタイム環境に展開するには、最初にそれを Eclipse フィーチャーにパッケージ化する必要があります。 Eclipse フィーチャーは、関連したプラグインをパッケージ化するために使用するデプロイメント成果物です。プラグインを Eclipse フィーチャーにパッケージ化するには、以下のステップを実行します。

  1. 空のディレクトリー (例えば、c:¥myHATS) をローカル・ハード・ディスク上に作成し、エクスポートした HATS アプリケーション・フィーチャーを保管します。 HATS ランタイム・フィーチャーおよび更新サイトの定義を含む site.xml ファイルを保管するには、この同じディレクトリーを使用します。詳しくは、HATS ランタイム・フィーチャーのエクスポートおよび更新サイトの作成を参照してください。
  2. 「HATS プロジェクト」ビューからリッチ・クライアント・プロジェクトを右クリックし、ポップアップ・メニューから「エクスポート」>「フィーチャーのエクスポート」を選択します。
    注:

    ライセンス設定を指定していない場合、このアプリケーションではランタイムが有効にされておらず、実稼働環境では実行できないというメッセージが表示されます。 HATS リッチ・クライアント・アプリケーションはローカル・テスト環境 (Eclipse、Lotus Notes、または Lotus Expeditor Client) でテストできますが、最初にライセンス設定を指定しなければ、ランタイム (非開発) 環境で実行することはできません。これは、HATS Toolkit 開発環境でアプリケーションを作成し、それを十分にテストできるという意味です。また、アプリケーションをエクスポートし、ユーザーはそれをインストールできますが、アプリケーションに接続することはできません。つまり、ランタイムはロックダウンされ、どんな接続も許可しません。 ライセンス設定の指定の詳細については、「HATS スタートアップ・ガイド」の『HATS ランタイムの使用可能化とライセンス設定 (Enabling HATS runtime and license settings)』を参照してください。ライセンスを購入済みの場合は、「ランタイムの使用可能化」をクリックして、ランタイム・アプリケーションを使用可能にします。まだ購入していない場合は、「続行」をクリックしてエクスポート・プロセスを続行します。

  3. プロジェクトがまだフィーチャーの一部ではないと想定して、ダイアログはフィーチャーをすぐに作成するように要求を出します。 「はい」をクリックして、「HATS フィーチャー・プロジェクトを作成」ウィザードを起動します。
  4. 「HATS フィーチャー・プロジェクトを作成」ウィザードで、「フィーチャー ID」、「名前」、「バージョン」、および「プロバイダー」フィールドを完成させます。
    注:
    「フィーチャー ID」フィールドを入力すると、「名前」フィールドは自動的に入力されます。 「フィーチャー ID」および「名前」フィールドを入力すると、これらのフィールドに対して妥当性検査が実行されます。 「フィーチャー ID」として入力する値は、作成されるフィーチャー・プロジェクトに使用される名前でもあり、すべての値はプロジェクトの feature.xml ファイルに保管されます。HATS は、「フィーチャー ID」フィールド、「名前」フィールド、およびバージョンのデフォルトとして名前 hostaccess を提供し、「バージョン」フィールドのデフォルトとして 1.0.0 を提供します。
  5. プラグイン・リストには、ワークスペース内のすべての HATS リッチ・クライアント・プラグイン・プロジェクトからデータが取り込まれます。プラグインを選択して新規フィーチャーに組み込みます。これらのプラグインは、フィーチャーのインストール時にクライアントにインストールされます。 「完了」をクリックします。
  6. 次に、Eclipse の「エクスポート」ウィザードが表示されます。「デプロイ可能なフィーチャー」パネルで、フィーチャーを選択します。
  7. 「宛先」タブで、「ディレクトリー」を選択して、「参照」をクリックし、エクスポート・ディレクトリー (例えば、c:¥myHATS) を見つけて選択します。
  8. 「オプション」タブで、「個々の JAR アーカイブとしてパッケージ (JNLP およびサイトの更新で必要)」を選択します。
  9. 「完了」をクリックします。

エクスポート済みの HATS リッチ・クライアント・アプリケーション・フィーチャーは、ランタイム拡張プラグインを自動的に組み込み、HATS ランタイム・フィーチャーへの依存関係を自動的に組み込みます。フィーチャー・プロジェクトは「HATS プロジェクト」ビューには表示されませんが、「ナビゲーター」ビューには表示されます。

HATS リッチ・クライアント・アプリケーション・フィーチャーの向上した拡張構成を実行する場合、「HATS フィーチャー・プロジェクトを作成」ウィザードを使用する代わりに、Eclipse によって提供される標準の Eclipse「新規フィーチャー」ウィザードを使用できます。このウィザードを起動するには、Rational SDP ツールバーから「ファイル」>「新規」>「その他」>「プラグイン開発」>「フィーチャー・プロジェクト」を選択します。このウィザードは基本的に、「HATS フィーチャー・プロジェクトを作成」ウィザードと同じ機能を実行します。ただし、ランタイム拡張プラグインを自動的に組み込んだり、HATS ランタイム・フィーチャーへの必要な依存関係を組み込んだりすることはありません。

HATS ランタイム・フィーチャーのエクスポート

実稼働環境では、HATS リッチ・クライアント・アプリケーション・フィーチャーは、クライアントにインストールされている HATS ランタイム・フィーチャーに依存します。 HATS リッチ・クライアント・アプリケーション・フィーチャーを「HATS フィーチャー・プロジェクトを作成」ウィザードを使用して作成すると、HATS ランタイム・フィーチャーに対する依存関係が自動的に組み込まれます。この依存関係は、HATS リッチ・クライアント・アプリケーション・フィーチャーがインストールまたは更新されるときに、フィーチャーのインストールまたは更新プロセスが HATS ランタイム・フィーチャーを更新サイトから自動的にプルダウンするというものです。 HATS ランタイム・フィーチャーには以下のフィーチャーおよびプラグインが含まれています。

Lotus Notes ターゲット・プラットフォームを指定すると、以下の Eclipse フィーチャーも組み込まれます。

HATS ランタイム・フィーチャーをエクスポートするには、以下のステップを実行します。

  1. 「HATS プロジェクト」ビューで、HATS リッチ・クライアント・プロジェクトを右クリックし、ポップアップ・メニューから「エクスポート」>「HATS Runtime のフィーチャーをエクスポート」を選択します。これにより、「HATS Runtime のフィーチャーをエクスポート」ウィザードが起動します。また、「ファイル」>「エクスポート」>「HATS」>「HATS Runtime のフィーチャーをエクスポート」を選択して、このウィザードを Rational SDP メニュー・バーから起動することもできます。
  2. 「HATS Runtime のフィーチャーをエクスポート」パネルで、「次の項目としてデプロイ」に「ディレクトリー」を選択し、「参照」をクリックして、エクスポート・ディレクトリー (例えば、c:¥myHATS) を見つけて選択します。
    注:
    「HATS Runtime のフィーチャーをエクスポート」ウィザードでは、HATS ランタイム・フィーチャーを保存するためのアーカイブ・ファイルまたはディレクトリーを、ローカル・ファイル・システム上で指定することができます。 「アーカイブ」ファイルへのエクスポートを選択する場合、すべてのフィーチャーとプラグインが単一の .zip アーカイブにパッケージ化されます。 .zip アーカイブ内のルート・ディレクトリー構造は 2 つのサブディレクトリーで始まり、1 つは features、もう 1 つは plugins という名前が付けられています。 「ディレクトリー」へのエクスポートを選択する場合、フィーチャーおよびプラグインは選択したディレクトリーにエクスポートされます。フィーチャーは features というサブディレクトリーに置かれ、プラグインは plugins というサブディレクトリーに置かれます。アーカイブを Web サーバーの更新サイト・ディレクトリーにアップロードする計画の場合は、「ディレクトリー」を選択します。
  3. 「完了」をクリックします。

更新サイトの作成

HATS アプリケーション・フィーチャーと HATS ランタイム・フィーチャーの両方をエクスポートした後、アプリケーションを展開するために、フィーチャーのインストールおよび更新プロセスで使用される更新サイトを作成する必要があります。更新サイトを作成するには、以下のステップを実行します。

  1. 「HATS プロジェクト」ビューで、HATS リッチ・クライアント・プロジェクトを右クリックし、ポップアップ・メニューから「新規 HATS」>「更新サイト・プロジェクト」を選択します。これにより、「新規更新サイト」ウィザードが起動します。また、「ファイル」>「新規」>「その他」>「プラグイン開発」>「更新サイト・プロジェクト」>「次へ」 を選択して、このウィザードを Rational SDP メニュー・バーから起動することもできます。
  2. 「更新サイト・プロジェクト」パネルで、以下のようにします。
    1. プロジェクトに名前を付けます (例えば、myHATSUpdateSite)。
    2. 「デフォルト・ロケーションの使用」チェック・ボックスのチェックを外し、「参照」をクリックして、HATS アプリケーション・フィーチャーおよび HATS ランタイム・フィーチャーをエクスポートしたディレクトリー (例えば、c:¥myHATS) を見つけて選択します。
    3. 「完了」をクリックします。
  3. 「サイト・マップ」タブの site.xml エディター・ビューで、「新規カテゴリー」をクリックします。
  4. 「カテゴリー・プロパティー」セクションで、以下のようにします。
    1. 「名前」を入力します (例えば、HATS)。
    2. 「ラベル」を入力します (例えば、HATS)。
    3. オプションで「説明」を入力します。
    4. Rational SDP ツールバーの「保存」アイコンをクリックします。
  5. 「サイト・マップ」タブの site.xml エディター・ビューで、「フィーチャーの追加」をクリックします。
  6. 「フィーチャー選択」パネルで、スクロールダウンして、ご使用の HATS アプリケーション・フィーチャーを選択し (例えば、hostaccess (nnnn)。nnnn はフィーチャーのバージョン番号を表します)、「OK」をクリックします。 バージョン番号の詳細については、プラグインおよびフィーチャーのバージョン番号の更新を参照してください。
    注:
    「フィーチャーの選択」フィールドにフィーチャー名の入力を始める場合、入力するデータはワイルドカードの働きをし、リスト・ボックス内のフィーチャーのリストは、希望するフィーチャーが表示されるまで絞り込まれます。
  7. 「フィーチャーの追加」をクリックして、HATS ランタイム・フィーチャーのそれぞれを追加します。

    指定されたターゲット・プラットフォームが Lotus Notes である場合は、次のフィーチャーも追加します。

  8. 「すべてビルド」をクリックして、更新サイト site.xml ファイルのビルドを完了します。
    注:
    「コンパイル・エラーがビルド中に発生しました。ログは、サイト・プロジェクトのルートにある 'logs.zip' で見ることができます。」 というエラー・メッセージが表示されたときは、logs.zip ファイルを確認してください。このファイルに警告のみが含まれている場合は、無視して安全であり、続行できます。

更新サイトが作成されました (この例では c:¥myHATS)。これには、どのフィーチャーおよびそれらのフィーチャーのどのバージョンを、クライアントがダウンロードするためのサイトから使用できるかを示す site.xml ファイルが含まれます。これで、クライアントからアクセス可能な Web サーバーに、この更新サイト・ディレクトリーを移動できます。 クライアント・システムで更新サイトを定義し、HATS リッチ・クライアント・アプリケーションをランタイム環境にインストールする方法については、ランタイム環境でのアプリケーションのインストールを参照してください。

注:
HATS サービスの更新をインストールした後、変更を有効にするには、HATS ランタイム・フィーチャーを再エクスポートして再デプロイする必要があります。更新サイトの site.xml ファイルを、バージョン番号の変更を反映するように変更する必要があります。バージョンは、「HATS Runtime のフィーチャーをエクスポート」ウィザードの最初のパネルにリストされます。詳しくは、プラグインおよびフィーチャーのバージョン番号の更新を参照してください。

ランタイム環境でのアプリケーションのインストール

HATS リッチ・クライアント・アプリケーションは、Eclipse RCP 環境、Lotus Notes 環境、および Lotus Expeditor Client 環境で実行できます。以下のセクションでは、これらの環境のそれぞれに HATS リッチ・クライアント・アプリケーションをインストールする方法を説明します。

Eclipse RCP

HATS リッチ・クライアント・アプリケーションを Eclipse リッチ・クライアント 環境にダウンロードおよびインストールするには、クライアント環境に Eclipse の EMF サービス・データ・オブジェクト (SDO) フィーチャーが含まれており、そのアプリケーションを含む更新サイトにアクセスするようにクライアントを構成する必要があります。デフォルトでは、自動インストールおよび更新は使用不可にされているため、ユーザーまたは管理者が標準の Eclipse Software Update 機能を使用して新規のフィーチャーまたは更新を手動でインストールする必要があります。これを実行するには、クライアント・システムで以下のステップを実行します。

注:
以下の説明は、Eclipse 3.4 以降を対象にしています。それより前のバージョンの Eclipse を使用している場合は、その Update Manager を使用するための適切な Eclipse 資料に従ってフィーチャーをインストールする必要があります。
  1. Eclipse クライアントのメニュー・バーで、「ヘルプ」>「ソフトウェア更新」を選択します。次に、「使用可能なソフトウェア」タブを選択します。
    注:
    Eclipse クライアントの構成によっては、このメニュー項目が別のメニューの下に配置されています。
  2. 「サイトの追加」ボタンをクリックしてから、「ローカル」ボタンをクリックします。
  3. HATS プロジェクト用に作成した更新サイトの場所まで参照して行き、 「OK」をクリックします。
  4. HATS 更新サイトを選択し、「インストール」をクリックします。
  5. インストールされる項目を検討し、確認します。「次へ」をクリックします。
  6. 「使用条件の条項に同意します」を選択し、「終了」をクリックします。
  7. HATS アプリケーションがインストールされました。
  8. ワークベンチを再始動するプロンプトが表示されたら、「はい」をクリックします。
  9. これで、まずホスト・アクセス・パースペクティブを開くことによりアプリケーションを実行できます (「ウィンドウ」->「パースペクティブを開く」->「ホスト・アクセス」)。ご使用の HATS アプリケーションが「アプリケーション」ビューにリストされます。アプリケーションを開始するには、アプリケーションをダブルクリックするか、または右クリックして「オープン」を選択します。

Eclipse RCP 環境の詳細については、http://www.eclipse.org/home/categories/rcp.php を参照してください。

Lotus Notes

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 環境にダウンロードおよびインストールするには、クライアント・システムで以下のステップを実行します。

  1. Lotus Notes クライアントを開始し、「ファイル」>「プリファレンス」>「ウィジェット」を選択します。
  2. 「Widget ツールバーと「My Widgets サイドバー」パネルを表示 (Show Widget Toolbar and the My Widgets Sidebar panel)」を選択します。「OK」をクリックします。
  3. Widget ツールバーは次のようになります。
    図 9. Lotus Notes Widget ツールバー
    Lotus Notes Widget ツールバー
  4. 「My Widgets サイドバー」パネルは、次のようになります。
    図 10. My Widgets サイドバー
    My Widgets サイドバー
  5. Widget ツールバーから「ウィジェット入門 (Getting Started with Widgets)」を選択します。
  6. 「フィーチャーとプラグイン (Features and Plugins)」を選択してから、「次へ」を選択します。
  7. 「URL を入力 (Enter the URL)」フィールドに、次のフォーマット (file:/// で始まる必要がある) を例として使用して、更新サイトの site.xml ファイルへのパスを入力します: file:///c:¥hatsupdatesite¥site.xml。 「ロード」ボタンをクリックします。
  8. 「インストールするフィーチャー (Features to Install)」で、すべてのフィーチャーを選択し、「次へ」を選択します。
  9. オプション: 「ウィジェット名 (Widget name)」フィールドに、HATS Provisioning Widget または別の適切な名前を入力できます。
  10. オプション: ウィジェットにイメージを関連付ける必要がある場合は、必要なイメージを更新サイトのフォルダーにコピーします。次に、「イメージ URL (Image URL)」フィールドに、次のフォーマット (file:/// で始まる必要がある) を例として使用して、イメージへのパスを入力します: file:///c:¥hatsupdatesite¥myhatsimage.png。
  11. 要求されたら、プラグインをインストールすることを選択します。

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

    図 11. 例として HATS Provisioning Widget が指定された My Widgets サイドバー
    例として HATS Provisioning Widget が指定された My Widgets サイドバー
  12. 要求されたら、Lotus Notes を再始動します。

「オープン」>「ホスト・アクセス」を選択することにより、アプリケーションを実行できます。ご使用の HATS アプリケーションが「アプリケーション」ビューにリストされます。アプリケーションを開始するには、アプリケーションをダブルクリックするか、または右クリックして「オープン」を選択します。

HATS アプリケーションをアンインストールするには、HATS Provisioning Widget (または、それに指定した任意の名前) を右クリックし、「除去」を選択します。要求されたら、Lotus Notes を再始動します。

Lotus Expeditor Client

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 環境にダウンロードおよびインストールするには、そのアプリケーションを含む更新サイトにアクセスするようにクライアントを構成する必要があります。これを実行するには、クライアント・システムで以下のステップを実行します。

  1. Lotus Expeditor Client のメインメニューで、「ファイル」>「アプリケーション」>「インストール」を選択します。
  2. 「フィーチャーの更新」パネルで、「インストールする新規フィーチャーを検索」を選択し、「次へ」をクリックします。
  3. 「アプリケーションのロケーション」パネルで、「リモート・ロケーションの追加」または「フォルダー・ロケーションの追加」のうち該当する項目をクリックします。
  4. 「アプリケーションのロケーション」パネルで、HATS 更新サイトを選択し、「完了」をクリックします。
  5. 「検索結果」パネルで、インストールするフィーチャーを選択し、「次へ」をクリックします。
  6. 「フィーチャー・ライセンス」パネルで、「使用条件の条項に同意します」 を選択し、「次へ」をクリックします。
  7. 「インストール」パネルで、「完了」をクリックします。
  8. HATS アプリケーションがインストールされました。
  9. ワークベンチを再始動するプロンプトが表示されたら、「はい」をクリックします。
  10. これで、まずホスト・アクセスを開くことによりアプリケーションを実行できます (「開く」->「ホスト・アクセス」)。ご使用の HATS アプリケーションが「アプリケーション」ビューにリストされます。アプリケーションを開始するには、アプリケーションをダブルクリックするか、または右クリックして「オープン」を選択します。
自動更新処理

リッチ・クライアント環境により、インストールされたアプリケーションの自動更新が可能になります。サーバーの更新が検査される頻度を制御するために、プリファレンスを使用できます。更新をアプリケーションにアップロードしたら、リッチ・クライアントは更新をダウンロードしてインストールします。新規更新のみがダウンロードされてインストールされたことを確認するために、バージョン検査が実行されます。たいていの場合、ユーザーは環境を再始動して、更新されたアプリケーションをアクティブ化する必要があります。詳細については、適切な 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 リッチ・クライアント・アプリケーションの管理

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 つ以上のアプリケーション名を選択し、右クリックします。以下のメニュー項目を使用できます。

オープン
このメニュー項目を選択すると、選択されたアプリケーションの新規インスタンスが開始されます。複数のアプリケーションが選択される場合、選択された各アプリケーションのインスタンスが開始されます。
印刷ジョブを表示
このメニュー項目は、少なくとも 1 つの印刷対応アプリケーションが選択される場合にのみ使用可能になります。 このメニュー項目を選択すると、「印刷ジョブ (3270)」または「印刷ジョブ (5250)」ビューのいずれかが開きます。このビューには、キューに入れられた印刷ジョブのリストが表示されます。 詳細については、印刷サポートの使用可能化を参照してください。
プロパティー
このメニュー項目は、1 つのアプリケーションだけが選択された場合に使用可能になります。 このメニュー項目を選択すると、ユーザーはそのアプリケーションに関する情報を表示するだけでなく、アプリケーションに関連した設定を構成することができます。以下のページは、選択したアプリケーションの「プロパティー」ダイアログで提供されます。
情報
「情報」ページには、選択したアプリケーションに関する情報が表示されます。これには、その名前、ID、バージョン、およびプラグインの物理的な場所が含まれます。また、アプリケーションによって使用されている HATS ランタイム・プラグインのバージョンも示されます。この情報は、ユーザーが環境に関する情報をサポート・チームと通信する必要がある場合に役立ちます。ユーザーはこのページの値を変更できません。これは通知目的のみです。
接続パラメーター
ユーザーが接続パラメーターをオーバーライドできないようにすることを選択した場合、この項目はリストに表示されません。これがデフォルトです。詳細については、接続パラメーターのオーバーライドを参照してください。

オーバーライドを許可する場合、このページでユーザーは接続パラメーターをオーバーライドすることができます。この機能は Web アプリケーション用の HATS 機能に相当します。この HATS 機能は、最初にアプリケーションにアクセスするときに URL を使用して接続パラメーターをオーバーライドできるようにします。接続パラメーターのオーバーライドを使用する例は、ユーザーがワークステーション ID または LU 名をオーバーライドする必要がある場合です。

ユーザーがオーバーライドを設定するには、「追加」ボタンをクリックし、「名前」フィールドのドロップダウン・リストからパラメーターを選択して、「値」フィールドに値を設定します。提供された接続パラメーター名をオーバーライドできるかどうかをユーザーに警告するために、ダイアログ内の妥当性検査は実行されません。デフォルトでは、最初に追加されるときにオーバーライド設定が使用可能になります。パラメーター名の隣のチェック・ボックスをクリアすると、この設定を使用不可にすることができます。

ユーザーが接続パラメーターをオーバーライドすると、設定はローカル・ワークスペースに保存されます。セッションのインスタンスが開始されるときに、オーバーライドされたパラメーター値が使用されます。

接続パラメーターのオーバーライドを使用してリッチ・クライアント・アプリケーションのインスタンスをプログラマチックに開始する方法については、「HATS リッチ・クライアント・プラットフォーム・プログラマーズ・ガイド」を参照してください。

変数
ユーザーがグローバル変数をオーバーライドできないようにすることを選択した場合、この項目はリストに表示されません。これがデフォルトです。詳細については、グローバル変数のオーバーライドを参照してください。

オーバーライドを許可する場合、このページでユーザーはグローバル変数をオーバーライドすることができます。この機能は Web アプリケーション用の HATS 機能に相当します。この HATS 機能は、最初にアプリケーションにアクセスするときに URL を使用してグローバル変数および共用グローバル変数をオーバーライドできるようにします。

この機能は、ユーザー固有の変数データをアプリケーションで使用できるようにします。例えば、グローバル変数の値から提供されたユーザー名およびパスワードを要求するマクロを記録できます。ユーザーは変数のオーバーライド・ページでこれらの値を提供することができます。サインオン画面が認識されるときにマクロが実行されると、これらの値が使用されます。

ユーザーがオーバーライドを設定するには、「追加」ボタンをクリックし、「名前」フィールドのドロップダウン・リストから変数名を選択して、「値」フィールドに値を設定します。さらに、グローバル変数が「共用」 かどうかを指定します。提供されたグローバル変数名をオーバーライドできるかどうかをユーザーに警告するために、ダイアログ内の妥当性検査は実行されません。デフォルトでは、最初に追加されるときにオーバーライド設定が使用可能になります。変数名の隣のチェック・ボックスをクリアすると、この設定を使用不可にすることができます。

ユーザーがグローバル変数をオーバーライドすると、設定は環境のデータ・ディレクトリーに保管されます。セッションのインスタンスが開始されるときに、オーバーライドされたグローバル変数値が使用されます。

グローバル変数のオーバーライドを使用してリッチ・クライアント・アプリケーション・インスタンスをプログラマチックに開始する方法については、「HATS リッチ・クライアント・プラットフォーム・プログラマーズ・ガイド」を参照してください。

印刷画面サポート

リッチ・クライアント環境では、ユーザーは、「ファイル」 メニューから「印刷」を選択することにより、現行の画面変換を印刷できます。デフォルトでは、Eclipse は「印刷」ダイアログを表示します。このダイアログで、ユーザーはプリンターを選択したり、またその他のオプションを構成したりできます。ユーザーが「OK」をクリックした後、変換ビューの変換領域が選択したプリンターに送信されます。

注:
Windows システムでは、スクロール・バーを使用することによってのみ表示される部分を含む、変換全体が印刷されます。Linux® システムでは、表示される変換部分のみが印刷され、スクロールして表示する必要がある非表示部分は印刷されません。

「変換」ビュー

「変換」ビューは、リッチ・クライアント環境内の変換のメイン領域です。それぞれの HATS リッチ・クライアント・プロジェクトには、1 つの変換ビューが関連付けられます。プロジェクトが作成されると、そのプロジェクトの plugin.xml ファイルにビューが登録されます。ビューは以下の 4 つの領域で構成されます。

ツールバー

変換ビュー・ツールバーには、アプリケーション・レベルのアクション用のボタンと、画面レンダリング中にツールバー・ウィジェットによって提供されるアクション用のボタンが含まれます。デフォルトでは、ツールバーが表示され、テキストのみの表題が付いたボタンが表示されます。これらの設定はプロジェクト設定で変更できます。詳細については、ツールバー  RCP のみ を参照してください。

ツールバーは 2 つのセクションに分割されます。ツールバーの右側は、HATS Web アプリケーションのアプリケーション・キーパッドに相当し、アプリケーション・キーパッド・ボタンがあります。表示するボタンの構成方法については、アプリケーション・キーパッドを参照してください。左側には、ツールバー・ウィジェットによって提供されるボタンが表示されます。詳細については、ツールバー  RCP のみ を参照してください。

ボタンの機能の説明を提供するツールチップ・テキストが、すべてのアプリケーション・キーパッド・ボタンで使用できます。ツールバー・ウィジェットを使用して、追加するボタン上にツールチップ・テキストを設定できます。

ツールバーのアプリケーション・キーパッド・ボタンの上にある「最小化」および「最大化」アイコンの隣が「メニュー」アイコンです。このアイコンをクリックすると、以下のメニュー項目を持つメニューが表示されます。

キーボード・サポートの切り替え
ユーザーはキーボード・サポートを使用可能にしたり、使用不可にしたりできます。
接続の詳細
このアプリケーションのホスト接続の詳細を表示します。
プロパティー
このアプリケーションのプロパティーを表示します。

テンプレートおよび変換領域

テンプレートおよび変換領域は変換ビューのメイン部分で、ここにすべての画面変換が表示されます。また、エラー・メッセージ、切断メッセージ、およびマクロ・ハンドラー・パネルが表示される領域です。

ポップアップ・メニュー
ポップアップ・メニューは、ユーザーが現行アプリケーションに関する情報を表示できるようにする変換領域に提供されます。以下のメニュー項目を使用できます。
プロパティー
この項目を選択すると、現行アプリケーションのプロパティー・ダイアログが開きます。詳細については、ポップアップ・メニューを参照してください。
ランタイム状況表示パネル
HATS Web アプリケーションと同様に、HATS リッチ・クライアント・アプリケーションが停止または切断されたり、エラーが検出されたり、あるいは使用中である場合、ユーザーに対してパネルが表示されます。

ホスト・キーパッド

ホスト・キーパッドには、プロジェクト設定で表示することを選択したホスト・キーが表示されます。ホスト・キーパッドの構成方法については、ホスト・キーパッドを参照してください。デフォルトでは、ホスト・キーパッドは表示されません。

OIA 状況域

OIA 状況域には、プロジェクト設定で構成したセッションの状態に関する情報が表示されます。 OIA 状況域の構成方法については、オペレーター情報域を参照してください。

ビューのクローズ

ビューがクローズされると、ホスト・システムへの接続がクローズされます。これは、ユーザーがビューを明示的にクローズしたり、リッチ・クライアント環境をクローズする場合に発生します。クローズされると、切断および停止イベントで定義されたアクションのセットが処理されます。

注:
HATS がまだ要求を処理している間にユーザーがビューをクローズしようとすると (例えば、マクロの再生を開始したボタンをユーザーがクリックした場合)、セッションが使用中であることを示すメッセージが表示されます。ユーザーが続行する場合、セッションは終了され、切断および停止イベントのアクションは実行されない場合があります。

ワークステーション ID のプロンプト表示

ホスト接続を作成または編集するときに、ユーザーに対して 5250 ホストに接続するためのワークステーション ID の入力を求めるプロンプトが表示されるように指定できます。詳細については、接続の作成を参照してください。ワークステーション ID のプロンプト表示を指定する場合、最初にホストへの接続を行うときに、ユーザーにプロンプト・ダイアログが表示されます。そこで、ユーザーは「ワークステーション ID」フィールドにワークステーション ID を入力できます。

選択した場合にワークステーション ID が保存され、今後はプロンプトが表示されないようにするチェック・ボックスが提供されます。チェック・ボックスが選択される場合、後でこのプロンプト表示を復元するには、アプリケーションのプロパティーで workstationID 接続パラメーターのオーバーライドを使用不可にします。詳細については、接続パラメーターを参照してください。

LU 名のプロンプト表示

ホスト接続を作成または編集するときに、ユーザーに対して 3270E ホストに接続するための LU 名の入力を求めるプロンプトが表示されるように指定できます。詳細については、接続の作成を参照してください。LU 名のプロンプト表示を指定する場合、最初にホストへの接続を行うときに、ユーザーにプロンプト・ダイアログが表示されます。ユーザーは、「LU 名」フィールドに LU 名を入力する必要があります。

選択した場合に LU 名が保存され、今後はプロンプトが表示されないようにするチェック・ボックスが提供されます。チェック・ボックスが選択される場合、後でこのプロンプト表示を復元するには、アプリケーションのプロパティーで LUName 接続パラメーターのオーバーライドを使用不可にします。詳細については、接続パラメーターを参照してください。

プリファレンス

デフォルトでは、ランタイム・プラットフォームのメニュー・バーから「ファイル」>「プリファレンス」>「ホスト・アクセス」を選択することにより、ユーザーはプリファレンスにアクセスできます。表示されるページは、ランタイム拡張プラグインに登録されます。これらの機能をユーザーに提供しない場合、ランタイム拡張プラグインの plugin.xml ファイル内の該当する宣言を除去できます。これを行う方法について詳しくは、「HATS リッチ・クライアント・プラットフォーム・プログラマーズ・ガイド」の『HATS ランタイム拡張プラグイン』セクションにある org.eclipse.ui.preferencePages 拡張ポイント ID の説明を参照してください。以下の設定が選択されています。

印刷プリファレンス

以下の印刷プリファレンスは、3270 印刷をサポートするアプリケーションのユーザーが設定できます。

デフォルト印刷ジョブ・アクション
開始時
印刷ジョブの開始時に、以下のプリファレンスを設定できます。
  • 印刷ジョブ・ビューのアクティブ化
  • メッセージの表示

    印刷ジョブが開始されていることをユーザーに示すメッセージが表示されます。

  • なし
完了時
印刷ジョブの完了時に、以下のプリファレンスを設定できます。
  • 印刷ジョブ・ビューのアクティブ化
  • メッセージの表示

    「印刷ジョブ {0} が完了しました。」というメッセージが表示されます。ここで、{0} は、印刷ジョブ名です。

  • オープン
  • なし
エラー時
印刷ジョブの失敗時に、以下のプリファレンスを設定できます。
  • 印刷ジョブ・ビューのアクティブ化
  • メッセージの表示

    「印刷ジョブ {0} でエラーが発生しました。」というメッセージが表示されます。ここで、{0} は、印刷ジョブ名です。

  • 削除
  • なし

終了時に印刷ジョブを削除
選択した場合、環境がクローズされると、印刷ジョブは自動的に削除されます。これは、ワークステーションを他のユーザーと共有するユーザーにとって便利です。

トラブルシューティング・プリファレンス

以下のトラブルシューティング・プリファレンスは、ユーザーが設定できます。ログ設定とトレース設定について詳しくは、HATS リッチ・クライアント・アプリケーションの管理を参照してください。

トレース設定
次の HATS ランタイム・トレースはユーザーが有効にすることができます。
ランタイムのトレースを使用可能にする
アプリケーション内の接続のトレースを使用可能にします。
ウィジェットのトレースを使用可能にする
アプリケーション内のウィジェットのトレースを使用可能にします。
アクションのトレースを使用可能にする
アプリケーション内のイベント・アクションのトレースを使用可能にします。
HOD のトレースを使用可能にする
アプリケーション内の Host On-Demand トレースを使用可能にします。
コンポーネントのトレースを使用可能にする
アプリケーション内のコンポーネントのトレースを使用可能にします。
ユーティリティーのトレースを使用可能にする
アプリケーション内のランタイム・ユーティリティーのトレースを使用可能にします。
マクロのトレースを使用可能にする
マクロ実行をトレースします。システム・パフォーマンスに影響するため、このトレースはマクロのデバッグでのみ使用してください。
表示端末の表示
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)。

「トレース出力」タブ
ファイル名
各ランタイム環境に固有の一連のトレース・ファイルを生成するためのテンプレートとして使用される名前。デフォルトは trace.txt です。
最大ファイル・サイズ
最大のファイル・サイズを指定します (KB 単位)。デフォルトは 10240 です。
ファイルの最大数
トレース・ファイルの最大数を指定します。デフォルトは 5 です。
「表示」ボタン
トレース・ファイルがデフォルトのシステム・エディターで開かれるようにするには、このボタンをクリックします。指定されたテンプレート・ファイル名に一致するすべてのトレース・ファイルが単一のファイルに結合されてから開かれます。例えば、trace.txt がテンプレート・ファイル名であり、trace1.txt、trace2.txt、および trace3.txt が存在する場合、それらはすべて単一のファイルに正しい順序で結合されてから、開かれます。デフォルト・エディターが構成されていない場合、エラー・メッセージが表示されます。
「クリア」ボタン
現行のトレース・ファイルをクリアするかどうかを指示するには、このボタンをクリックします。
「メッセージ出力」タブ
ファイル名
各ランタイム環境に固有の一連のログ・ファイルを生成するためのテンプレートとして使用される名前。デフォルトは messages.txt です。
最大ファイル・サイズ
最大のファイル・サイズを指定します (KB 単位)。デフォルトは 512 です。
ファイルの最大数
トレース・ファイルの最大数を指定します。デフォルトは 2 です。
「表示」ボタン
現行のログ・ファイルがデフォルトのシステム・エディターで開かれるようにするには、このボタンをクリックします。指定されたテンプレート・ファイル名に一致するすべてのログ・ファイルが単一のファイルに結合されてから、開かれます。例えば、messages.txt がテンプレート・ファイル名であり、messages1.txt、messages2.txt、および messages3.txt が存在する場合、それらはすべて単一のファイルに正しい順序で結合されてから、開かれます。デフォルト・エディターが構成されていない場合、エラー・メッセージが表示されます。
「クリア」ボタン
現行のログ・ファイルをクリアするかどうかを指示するには、このボタンをクリックします。
「シミュレーション出力」タブ
ファイルの最大数
「ホスト・シミュレーションの記録を使用可能にする」チェック・ボックスが選択される場合、このフィールドはシミュレーション出力ファイルの最大数を指定します。デフォルトは 10 です。新規シミュレーション・ファイルが最大設定値を超える場合、最も古いシミュレーション・ファイルが削除されます。
「収集」ボタン
問題を診断するために IBM® サポートが必要とするすべての成果物を収集するには、このボタンをクリックします。「問題判別情報の収集」ウィザードで、情報の収集対象となるアプリケーションのチェック・ボックスを選択し、宛先 .zip ファイルを指定します。以下の情報が収集され、宛先 .zip ファイルに集められます。
「デフォルトの復元」ボタン
パネル内のすべての設定をデフォルトに戻すには、このボタンをクリックします。
「適用」ボタン
ランタイム拡張プラグインの runtime.properties ファイルの設定を保存するには、このボタンをクリックします。

HATS リッチ・クライアントの考慮事項と制限

HATS リッチ・クライアント・アプリケーションを使用する際の考慮事項と制限のリストを次に示します。