テンプレートを使用すると、会社の Web サイトやアプリケーションのスタイル、またはその他のガイドラインに一致するようにテンプレートをカスタマイズすることにより、HATS アプリケーションの外観を細かく制御できます。テンプレートとは、HATS Web プロジェクトでの JSP ファイル、または HATS リッチ・クライアント・プロジェクトでの Java™ SWT コンポジット・クラスのことです。テンプレートは、HATS 変換によってレンダリングされるホスト画面用に予約されている領域です。テンプレートには、会社のロゴや情報を収容できます。HATS Web テンプレートの場合には、他の Web ページへのリンクも組み込むことができます。また、テンプレートは、変換されたホスト画面が表示されるエリアの背景色、イメージ、その両方を定義します。
テンプレート・ウィザードを起動すると、ブランク・テンプレート、または HATS に付属しているいずれかのテンプレートに基づくテンプレートを作成できます。 HATS Web プロジェクトの場合、テンプレートを Web ページ (URL またはファイル) に基づかせることもできます。既存の Web ページを会社の Web サイトに基づくテンプレートとしてインポートすることもできます。HATS リッチ・クライアント・プロジェクトの場合は、Java ソース・ファイルをプロジェクトにコピーするか、Eclipse インポート・ウィザードを使用すれば、テンプレートを Java ソース・ファイルとして他のプロジェクトからインポートできます。
HATS は、ユーザーのプロジェクトに使用できるテンプレートを備えています。これらのテンプレートの名前を表示するには、「Web コンテンツ」 Web のみ フォルダーまたは「リッチ・クライアント・コンテンツ」 RCP のみ フォルダーを展開し、「HATS プロジェクト」ビューの「テンプレート」フォルダーを選択します。付属のテンプレートには、以下の定義の一部またはすべてが組み込まれています。
このセクションでは、HATS に付属の一部のテンプレートについて説明します。
図 60 は、HATS Web アプリケーションで使用するために付属している finance.jsp テンプレートを使用したホスト画面を示しています。このテンプレートは、他の Web サイトへのリンクを持つドロップダウン・メニュー、および下部のアプリケーション・キーパッドを使用する例を提供します。

図 61 は、HATS Web アプリケーションで使用するために付属している industry.jsp テンプレートを使用したホスト画面を示しています。このテンプレートは、他の Web サイトへのメニュー・バー・リンク、および下部のアプリケーション・キーパッドを使用する例を提供します。

図 62 は、HATS リッチ・クライアント・アプリケーションで使用するために付属している modern.java テンプレートを使用したホスト画面を示しています。このテンプレートは、ボタン、リンクなどの全体的に共通の外観をランタイム環境 (例えば、Eclipse RCP、Lotus Notes®、Lotus® Expeditor など) が提供するという前提に基づいて、比較的簡単な、サイドバーのみの構成になっています。

「HATS プロジェクト」ビューで HATS リソースのコピーを作成するには、任意のフォルダーを開いてリソースを右クリックし、「コピー」を選択します。 リソースの 「貼り付け」先フォルダーを選択すると、HATS から名前の入力を求められます。これは個人用テンプレートの作成を開始するときのバックアップとして役立ちます。
HATS Toolkit でプロジェクトを作成する場合、プロジェクトのデフォルト・テンプレートとして使用するテンプレートを選択します。このテンプレートは「HATS プロジェクト」ビューに異なるアイコンで表示され、このアイコンの横には「デフォルト」という文字が表示されます。デフォルト・テンプレートを変更するには、「HATS プロジェクト」ビューに移動し、Web Content/Templates Web のみ 、または Rich Client Content/Template RCP のみ に置かれているテンプレートを右クリックして、「デフォルト・テンプレートとして設定」を選択します。 もう 1 つの方法では、「HATS プロジェクト」ビューで、HATS プロジェクトの「プロジェクト設定」をダブルクリックします。 「テンプレート」タブに移動し、リストで選択します。
画面カスタマイズを作成するときに、アクションが変換の適用または URL の表示である場合、変換の適用時に使用するテンプレートを選択できます。ホスト・アプリケーションがすべての画面で一貫性を保つようにするには、プロジェクトのデフォルト・テンプレートとして選択したテンプレートを変換にも使用します。これを行うには、このプロジェクトのデフォルト・テンプレートとして使用するテンプレートを選択します。
個人が使用する機能や会社のスタイル・ガイドラインに合った個人用のカスタム・テンプレートを作成できます。プロジェクト用のカスタム・テンプレートは、HATS Toolkit 内でウィザードとエディターを使用してデザインできます。HATS は、作成するすべてのテンプレートに、色およびフォント、HATS のデフォルト・アプリケーション・キーパッド、および変換でレンダリングされるホスト画面用の領域を含めるのに必要なコードを自動的に追加します。
「テンプレートの作成」ウィザードを使用して、新規テンプレートを作成します。ウィザードにアクセスするには、以下のようにさまざまな方法があります。
ウィザードで、プロジェクトを指定して、テンプレートに名前を付けます。テンプレートがリッチ・クライアント・プロジェクト用である場合、「パッケージ」フィールドには、デフォルトの Java パッケージの HATS プリファレンスで規定されているデフォルトのパッケージ名が事前に入力されています。詳細については、HATS プリファレンスの使用を参照してください。「参照」ボタンを使用すると、別のパッケージを探して選択できます。必要に応じて、テンプレートに説明を設定し、「次へ」をクリックして、以下のいずれかのオプションを選択します。
このオプションを選択して、ブランク・テンプレートを作成します。
既存のテンプレートを基にして新規のテンプレートを事前に設定するには、このオプションを選択します。既存のテンプレートの名前を選択します。 実際には、この操作によって「テンプレートの作成」ウィザードの始動時に指定した名前を使用して、既存のテンプレートのコピーが作成されます。下のウィンドウに選択したテンプレートのプレビューが表示されます。
既存の Web ページ (会社の既存の Web サイトなど) または特定のファイルを基にして新規のテンプレートを事前に設定するには、このオプションを選択します。テキスト・ボックスに URL またはファイル名を入力するか、「参照」ボタンをクリックして検索します。「プレビュー」をクリックすると、選択したテンプレートが表示されます。
Web ページのほか、リンクされたファイル (例: イメージ、スタイル・シート) が Web からダウンロードされます。ファイルへのリンクは、ユーザーの HATS プロジェクト内の対応するパスに合わせて変更されます。
新規テンプレートをプロジェクトのデフォルト・テンプレートにするには、「このプロジェクトのデフォルト・テンプレートとして設定」チェック・ボックスを選択します。
「完了」をクリックします。これにより、新規のテンプレートに変更や修正を加えることができる適切なエディターが起動します。
プロジェクト内のオブジェクトに加える変更は、そのプロジェクトにのみ影響するので注意してください。別のプロジェクト用に作成したテンプレートを使用する場合は、そのテンプレートを、変更したスタイル・シートまたはイメージとともに、作成する新規プロジェクトにコピーする必要があります。
HATS Web プロジェクトで、独自のテンプレートを HATS Toolkit 環境の外部に作成する場合は、以下のステートメントを組み込んであることを確認してください。
HATS Web プロジェクト内のテンプレートは JSP ファイルで、デフォルトでは Page Designerを使用して編集します。 HATS リッチ・クライアント・プロジェクト内のテンプレートは Java SWT コンポジットで、Java クライアント・アプリケーション・エディター (VE) フィーチャーが Rational® SDP にインストールされていると想定すると、Visual Editor を使用して編集されます。
すべてのテンプレート (HATS に付属のテンプレートと作成したテンプレート) を参照するには、「HATS プロジェクト」ビューの「Web コンテンツ」の下にある「テンプレート」フォルダーを展開します。 Rational SDP に組み込まれている Page Designer を使用してテンプレートを編集するには、テンプレートの名前をダブルクリックします。使用可能なその他のエディターを参照するには、テンプレートの名前を右クリックして、「オープン先を指定」を選択します。 メニュー・バーの「ヘルプ」>「ヘルプ目次」を選択して「Page Designer」を検索することにより、Page Designerに関する Rational SDP 資料を参照してください。
テンプレートの編集には、次の制限が適用されます。
次のセクションでは、Page Designerの各タブを説明します。
テンプレートを変更すると、Page Designerの「デザイン」タブには、そのテンプレートの現在のビューが表示されます。このタブでは、Rational SDP ツールバーから追加の編集オプションが使用できます。例えば、ツールバーから「挿入」ドロップダウン・メニューを使用して、イメージ、写真、テキスト、テキスト・フォーマット制御などを挿入したり、「パレット」から HATS コンポーネントをドラッグすることができます。テンプレートが表示されたときに演奏される音楽の追加、レイアウト・フレームの作成、および HTML タグの追加を行うことができます。
グローバル変数、マクロ・キー、ホストおよびアプリケーション・キーパッド、または個別のキーを挿入することもできます。HATS Toolkit メニュー・バーの「HATS ツール」メニューを使用すると、これらの項目を挿入できます。
イメージをプロジェクトに追加する場合は、イメージをプロジェクトの Web Content/Common/Images ディレクトリーにインポートしてください。イメージをインポートするには、「ファイル」>「インポート」>「一般」>「ファイル・システム」をクリックして「インポート」ウィザードを開きます。「ソース・ディレクトリー (From directory)」フィールドで、インポートするイメージ・ソース・ファイルの場所を選択します。project_name/Web Content/common/images ディレクトリーを、宛先となる「ターゲット・フォルダー (Into Folder)」として選択します。イメージ・ソース・ファイルがインポートされたら、Images フォルダーを右マウス・ボタンでクリックし、右下ウィンドウの「サムネール (Thumbnail)」タブで「サムネールを表示」を選択して、フォルダー内のイメージを表示します。イメージは、テンプレートの「デザイン」タブ表示にドラッグ・アンド・ドロップしてコピーできます。
「HATS ツール」メニューの「ホスト・コンポーネントを挿入」、「マクロの挿入」、または「グローバル変数を挿入」項目をクリックすると、変換時にそれらの項目を定義する場所にウィザードが現れます。これらのウィザードの詳細については、ホスト・コンポーネントを挿入、マクロ・キーを挿入、および グローバル変数を挿入を参照してください。
Cascading Style Sheet とは、HTML のレンダリングを制御するスタイル規則の階層セットを定義するファイルです。このファイルを使用すると、HATS によりレンダリングされた画面領域とテンプレートのスタイルとの整合性を維持するために、フォント色、サイズ、背景色などの出力要素を制御できます。
HATS は、カラー・スキームとフォント・サイズを変更するスタイル・シートを備えています。これらのスタイル・シートの少なくとも 1 つがテンプレートに適用されます。「デザイン」タブでテンプレートを表示して、これらのスタイル・シートをテンプレートに適用できます。
「HATS プロジェクト」ビューの Web Content/Common/Stylesheets フォルダーに移動すると、編集するスタイル・シートをダブルクリックできます。 デフォルトでは、これで CSS Designer エディター・ウィンドウおよびプレビュー・ウィンドウにスタイル・シートが開かれ、スタイル・シート内のスタイルのサンプルが表示されます。
CSS Designer エディター・ウィンドウ内の特定のスタイルをクリックすると、スタイルのサンプルがプレビュー・ウィンドウに表示されます。
ホスト画面のフィールドの色を変更したいことはよくあります。問題は、その特定のホスト・フィールドに適用されているスタイルを確認することです。これを判別するには、ホスト・フィールドが表示されているときに Web ページのソースを表示し、そのソースを調べることにより、適用されているスタイルを判別できます。
HATS プロジェクトのサインオン画面の「ユーザー」および「パスワード」テキストに使用されているテキストを変更するとします。Web ページのソースを表示するには、実際の Web ブラウザーで該当のフィールドが表示されるまで HATS プロジェクトを実行します。Rational SDP に組み込まれている Web ブラウザーは使用しないでください (Rational SDP のテスト・サーバー上で HATS プロジェクトを実行できますが、Internet Explorer を使用してプロジェクトにアクセスする必要があります)。
該当のフィールドが表示されたら、ブラウザーのメニュー・バーにある「表示」をクリックし、ドロップダウン・メニューから「ソース」をクリックします。
テキスト・ファイルで、変更するフィールドまたはそれに近いフィールド内のテキスト (この例では、「ユーザー」) を検索します。 ソース内のテキストの直前に、CLASS= ステートメントがあります。このステートメントは、テキストに適用されている CLASS またはスタイルを規定します。そこで、テンプレートまたはスタイル・シートに移動してスタイルを編集すると、希望する効果を得られます。
このスタイル変更は、このスタイルが使用される HATS アプリケーション全体に適用されます。デフォルト・アプリケーションを作成する場合、そのアプリケーションではすべてのホスト画面にデフォルト・テンプレートが適用され、すべての画面でこのスタイルが使用されます。スタイルを 1 つのホスト画面のみに適用したい場合、その特定のホスト画面に適用するテンプレートを作成する必要があります。
Cascading Style Sheet の詳細については、http://www.w3.org/Style/CSS/ を参照してください。
HATS には以下のスタイル・シートが付属し、作成する各新規プロジェクトに組み込まれます。
| 名前 | 説明 |
|---|---|
| blacktheme | 黒の背景。前景色はホスト画面の色と一致します。 |
| calendar | カレンダー・ポップアップのスタイル |
| commontheme | すべてのスタイル・シートに共通の要素を定義します。メイン・スタイル・シート (blacktheme、 graytheme、 monochrometheme、 tantheme、 whitetheme) によりインポートされます。 |
| finance | Finance.jsp テンプレート用のスタイル・シート |
| graytheme | グレーの背景。前景色はさまざまな色調のグレーです。 |
| industry | Industry.jsp テンプレート用のスタイル・シート |
| inlineCalendar | カレンダー・ウィジェットの inlineCalendar オプション用のスタイル・シート |
| largeFont | ブラウザー設定およびクラス関数に関連して生成されたすべての出力のフォント・サイズ |
| monochrometheme | 白の背景。前景色はさまざまな色調のグレー、リンクは青です。 |
| nonFixedFont | 白の背景。フォント・サイズはさまざまです。 |
| normalFont | ブラウザー設定およびクラス関数に関連して生成されたすべての出力のフォント・サイズ |
| PrintJobWindow | 「印刷ジョブ」ウィンドウのスタイル |
| reverseVideoBlack | blacktheme スタイル・シートの前景色と背景色を反転します。 |
| reverseVideoGray | graytheme スタイル・シートの前景色と背景色を反転します。 |
| reverseVideoMono | monochrometheme スタイル・シートの前景色と背景色を反転します。 |
| reverseVideoTan | tantheme スタイル・シートの前景色と背景色を反転します。 |
| reverseVideoWhite | whitetheme スタイル・シートの前景色と背景色を反転します。 |
| scaleableFont | 生成されたすべての出力のフォント・サイズはブラウザーに応じて調整されます。 |
| slickWhiteBackground | 白の背景。SlickMonoGray および Eagle テンプレートで使用されます。 |
| smallFont | ブラウザー設定およびクラス関数に関連して生成されたすべての出力のフォント・サイズ |
| tantheme | 黄褐色の背景。前景色はさまざまな色調のグレーと青です。 |
| whitetheme | 白の背景。前景色はホスト画面の色と一致します。 |
| xlargeFont | ブラウザー設定およびクラス関数に関連して生成されたすべての出力のフォント・サイズ |
| xsmallFont | ブラウザー設定およびクラス関数に関連して生成されたすべての出力のフォント・サイズ |
「ソース」タブには、テンプレートのすべての部分について JSP ファイル内の HTML タグと JSP タグが表示されます。Page Designerの別のタブで変更を行うと、ソース・ファイルに表示されるタグと属性もそれに合わせて変更されます。
ソース・ファイル内のタグや属性を変更することもできます。変更すると、Page Designerの他のタブに反映されます。
「分割」タブには、「設計」ビューと「ソース」ビューの両方が一緒に表示されます。
「プレビュー」タブでは、<HATS:Component > (およびすべての <HATS:xxxx>) タグをレンダリングする時に静的な HTML コンテンツを表示する変換のブラウザー・プレビューが提供されます。このタブは「デザイン」タブに似ていますが、このタブでは変更を行うことはできません。このプレビューには変換が含まれません。
HATS では、カスタマイズされたテンプレート、スタイル・シート、およびイメージを共用できます。
<workspace_directory>\project name\Web Content\templatesこれを以下にコピーします。
<shared_install_directory>¥plugins¥com.ibm.hats_nnn¥predefined¥ projects¥language¥new¥Web Content¥templatesここで、shared_install_directory は IBM® Installation Manager を使用して HATS オファリングをインストールした共用リソース・ディレクトリーを、nnn は HATS のバージョンおよびビルド・レベルを表し、language は英語の場合は en です。
<workspace_directory>¥project name¥Web Content¥common¥scriptsから
<shared_install_directory>¥plugins¥com.ibm.hats_nnn¥predefined¥ projects¥new¥Web Content¥common¥scriptsにコピーする必要もあります。
<workspace_directory>\project name\Web Content\common\stylesheetsこれを以下にコピーします。
<shared_install_directory>¥plugins¥com.ibm.hats_nnn¥predefined¥ projects¥new¥Web Content¥common¥stylesheets
<workspace_directory>\project name\Web Content\common\imagesこれを以下にコピーします。
<shared_install_directory>¥plugins¥com.ibm.hats_nnn¥predefined¥ projects\new\Web Content\common\images
これらのファイルをコピーすると、次に新規プロジェクトを作成するときに、新規のテンプレート、スタイル・シート、またはイメージを選択できます。
HATS リッチ・クライアント・テンプレートは、特定の Java インターフェースを実装している特殊な Java SWT コンポジット・クラスです。このインターフェースを使用すると、リッチ・クライアント環境で HATS テンプレートとして使用される Java ソース・ファイルを HATS で検出して使用できます。HATS リッチ・クライアント・テンプレートは、単純なヘッダーまたはサイドバーのみで、フッターのない、きわめて基本的な構成になっています。この理由は、ランタイム環境 (例えば、Eclipse RCP、Lotus Notes、Lotus Expeditor など) は、全体的に共通の外観、および共通のボタンやリンクなどの領域を備えていることが前提となるためです。
テンプレートは、ホスト・コンポーネント (ComponentRendering コンポジット)、デフォルト・レンダリング・コンポジット、またはグローバル変数コントロールを含むことができませんが、変換はそれらを含むことができます。
すべてのテンプレート (HATS に付属のテンプレートと作成したテンプレート) を参照するには、「HATS プロジェクト」ビューの「リッチ・クライアント・コンテンツ」の下にある「テンプレート」フォルダーを展開します。
デフォルト・エディターを使用してテンプレートを編集するには、テンプレートの名前をダブルクリックします。使用可能なエディターを参照するには、テンプレートの名前を右クリックして、「オープン先を指定」を選択します。
Java クライアント・アプリケーション・エディター (VE) フィーチャーが Rational SDP にインストールされていると想定すると、Visual Editor を使用してテンプレートを編集できます。このセクションの情報に加えて、「HATS リッチ・クライアント・プラットフォーム・プログラマーズ・ガイド」の章『テンプレート』を参照してください。また、ご使用の Rational SDP 製品のインフォメーション・センターも参照してください。例えば、http://publib.boulder.ibm.com/infocenter/radhelp/v7r5/index.jsp を参照し、visual editor を検索します。
Visual Editor の 2 つの領域は、通常は上段の領域として表示される「デザイン」ビューと、通常は下段の領域として表示される「ソース」ビューです。画像などの項目は、「パレット」ビューで使用できるコントロールを使用することにより、テンプレートに追加されます。
例えば、テンプレートに画像を追加するには、以下の手順に従います。
Visual Editor を使用して、フォント、画像、色などのリソースを HATS の変換またはテンプレートに手動で追加する場合は、これらのリソースをクリーンアップするコードも手動で追加する必要があります。詳しくは、HATS リッチ・クライアントの考慮事項と制限を参照してください。
アプリケーション・キーパッドには、アプリケーション・レベルの機能を表すキー (「最新表示」、「デフォルト」、「印刷ジョブを表示」など) が含まれています。これらのキーは、HATS アプリケーション内の機能を制御します。アプリケーション・キーパッドのキーには以下のものがあります。
デフォルトでは、HATS はアプリケーション・キーパッドを表示します。アプリケーション・キーパッドを非表示にするには、「HATS プロジェクト」ビューに移動して HATS プロジェクトの「プロジェクト設定」をダブルクリックし、「レンダリング」タブを選択して「アプリケーション・キーパッド」をクリックします。 次に、チェック・ボックスをクリアして、キーパッドを非表示にします。
キーボード・サポートおよびキーパッドの設定の詳細については、HATS プロジェクトの変更を参照してください。