HATS Web アプリケーションの開発および展開
HATS アプリケーションのタイプには、Web、ポートレット、EJB、リッチ・クライアント、および管理コンソールの 5 つがあります。この章では、HATS Web アプリケーションについて説明します。他のタイプのアプリケーションについては、以下の章を参照してください。
また、HATS Web アプリケーションを WebFacing アプリケーションと関連付け、両方を一緒にパッケージ化して、単一エンタープライズ・アプリケーションで相互運用することができます。詳しくは、WebFacing と HATSを参照してください。
HATS アプリケーションは、HATS Toolkit を使用して HATS プロジェクトから作成されます。新規の HATS プロジェクトを作成すると、HATS アプリケーション・ファイルを編成するために利用できる一組のフォルダーが作成されます。以下にデフォルト・プロジェクトの例を示します。最上位のフォルダーの名前は、作成するプロジェクトに付けた名前と同じです。このフォルダーの中には、HATS プロジェクトで定義したオブジェクトを含む他の上位フォルダーが入っています。
一部のフォルダーは、特定のオブジェクトが作成されるまで表示されません。
図 2. 「HATS Web プロジェクト」ビュー
HATS プロジェクトのセットアップ方法に応じて、これらのフォルダーの一部またはすべてが「HATS プロジェクト」ビューに表示されます。
「HATS プロジェクト」ビューに表示するフォルダーや、ファイル拡張子の非表示を指定することもできます。詳しくは、HATS プリファレンスの使用を参照してください。
注:
HATS プロジェクトのタイプによって、表示されるフォルダーは異なります。例えば、HATS EJB プロジェクトのディレクトリー・ツリーには、Screen Customization、Screen Captures、または Web Content フォルダーはありません。
プロジェクトのファイルの編成をわかりやすくするために、これらの上位サブフォルダーの内部にもフォルダーを作成することができます。例えば、プロジェクト用の画面キャプチャーを作成するときに、「Screen Captures」フォルダーの下に、取り込んだ画面を編成してグループ化するためのフォルダーを作成することができます。フォルダーを作成するには、ツリー内の上位フォルダーの 1 つを右マウス・ボタンでクリックし、「新規 HATS」>「フォルダー」を選択します。ファイルを別のフォルダーに移すには、該当ファイルを右マウス・ボタンでクリックして「移動」を選択するか、ドラッグ・アンド・ドロップ方式を使用します。
注:
サブフォルダーには制限事項があります。変換ファイルおよびテンプレート・ファイルは、同じレベルのサブフォルダーに格納する必要があります。あるレベルのサブフォルダー (¥transformations¥Callup¥ など) にある変換を使用するには、この変換と組になるテンプレートが同じレベルのサブフォルダー (¥templates¥Callup¥ など) になければなりません。
HATS パースペクティブの「ナビゲーター」ビューに進むと、HATS プロジェクトをチーム環境で共有できます。プロジェクトを右クリックして、「チーム」>「プロジェクトの共用」を選択します。リストからリポジトリー・タイプを選択し、「次へ」をクリックします。Rational® SDP は、いくつかのリポジトリーをサポートしています。詳しくは、Rational SDP の資料を参照して「リポジトリー」を検索してください。
HATS Toolkit で作成された HATS Web プロジェクトは、Rational SDP ワークベンチ内の Web プロジェクトの拡張版です。詳細については、Rational SDP メニュー・バーで「ヘルプ」>「ヘルプ目次」をクリックして、「開発 (Developing)」を展開し、「Web アプリケーションの開発 (Developing Web applications)」を選択してください。
HATS Web アプリケーションの編成
デフォルトでは、すべての HATS Web アプリケーションが 1 つのエンタープライズ・アーカイブ・ファイル (HATS_EAR7 など) に保管されます。アプリケーションをエクスポートして WebSphere® Application Server に配置すると、HATS .ear ファイルには、Web アーカイブ (.war) ファイルと各アプリケーションの実行に必要なリソース、および HATS ランタイム実行可能コードの 1 つのコピーが格納されます。必要があれば、各アプリケーションをそれぞれ専用の .ear ファイルに入れたり、いくつかを組み合わせて 1 つの .ear ファイルにしたりするなど、別の編成方式も使用できます。
Web アプリケーションの配置方法を決定する際には、以下の事項がサーバーに与える影響を考慮してください。
- ディスク・スペース
- 各アプリケーションをそれぞれ専用の .ear ファイル内に作成する場合は、それぞれに専用の HATS ランタイム・コードのコピーがあります。ランタイム・コードのサイズは約 25 MB です。ランタイム・システムでご使用のアプリケーションのすべてに消費されるディスク・スペースの量を確認する必要がある場合は、25 にアプリケーションの数を掛けます。
- デプロイメント
- HATS .ear ファイルを再展開すると、その .ear ファイル内で一部のアプリケーションが未変更であっても、.ear ファイル内のすべてのアプリケーションが再展開されます。
- ロギングとトレース
-
ロギングとトレースは、個々の HATS アプリケーション・レベルではなく、.ear ファイルのレベルで制御されます。各 HATS アプリケーションがそれぞれ専用の .ear ファイルに格納されている場合は、個々のアプリケーションのログとトレースの設定を、他のアプリケーションから切り離して制御することができます。
1 つの .ear ファイルに複数の HATS アプリケーションが格納されている場合は、ログとトレースの設定は、その .ear ファイル内のすべての HATS アプリケーションに適用されます。
1 つの .ear ファイル内のすべての HATS アプリケーションに関するメッセージは、同じログ・ファイルに記録され、またすべての HATS アプリケーションに関するトレース情報が同じトレース・ファイルに記録されます。
オプションのキーワード、traceLogDirectory を runtime.properties ファイルに追加できます。この操作により、出力ファイルに対して特定のディレクトリーを指定できます。このファイルは HATS Enterprise Application の was_dir/installedApps/ear_name ディレクトリーに格納されています。
- ライセンス追跡
- ライセンス追跡も、個々の HATS アプリケーション・レベルではなく、.ear ファイルのレベルで制御されます。各 HATS アプリケーションがそれぞれ専用の .ear ファイルに格納されている場合は、ライセンス追跡は他のアプリケーションから切り離して行われます。1 つの .ear ファイルに複数の HATS アプリケーションが入っている場合は、その .ear ファイル内のすべての HATS アプリケーションについてライセンス追跡が行われます。同じ .ear ファイル内のすべての HATS アプリケーションについてライセンス使用に関する情報が保持され、同じライセンス使用状況ファイルに入れられます。
HATS Web プロジェクトを別の .ear ファイルに移動させる
プロジェクト・ファイルがどの .ear ファイルに入るかは、プロジェクトの作成時に決定されます。プロジェクトを作成した後、そのプロジェクトをある .ear から別の .ear に移すには、以下の手順を実行します。
プロジェクトを .ear ファイルに追加するには、以下の手順を実行します。
- HATS Toolkit の「ナビゲーター」タブをクリックして、.ear ファイルを表示します。
- プロジェクトの追加先とする .ear ファイルを展開します。META-INF フォルダーを展開し、application.xml ファイルを見つけます。
- application.xml ファイルをダブルクリックして、Rational SDP application.xml エディターを始動します。
- application.xml エディターの「設計」ビューの「概要」グループで、「アプリケーション」を選択し、「追加」をクリックします。
- 「項目の追加 (Add Item)」ダイアログで、「モジュール」を選択し、「OK」をクリックします。
- .ear ファイルに追加するプロジェクトを選択し、「終了」をクリックします。
- Rational SDP application.xml エディターを閉じます。
プロジェクトを .ear ファイルから除去するには、以下の手順を実行します。
- HATS Toolkit の「ナビゲーター」タブをクリックして、.ear ファイルを表示します。
- プロジェクトを除去する .ear ファイルを展開します。
META-INF フォルダーを展開し、application.xml ファイルを見つけます。
- application.xml ファイルをダブルクリックして、Rational SDP application.xml エディターを始動します。
- application.xml エディターの「設計」ビューの「概要」グループで、.ear ファイルから除去するプロジェクトを選択し、「除去」をクリックします。
- Rational SDP application.xml エディターを閉じます。
HATS プロジェクトのバックアップ
ソフトウェア開発活動の場合と同じく、データの損失や破損に備えて HATS プロジェクトのバックアップをとっておくとよいでしょう。開発サイクル中にバックアップを作成するほかに、HATS 保守をインストールする前にもバックアップを作成する必要があります。これにより、必要な場合は、以前にインストールした保守レベルに戻すことができます。HATS プロジェクトのバックアップを作成するには、Rational SDP のプロジェクト交換のエクスポート機能を使用します。詳しくは、Web プロジェクトのエクスポートを参照してください。
バックアップから HATS プロジェクトをリストアするには、プロジェクト交換のインポート機能を使用します。詳しくは、Web プロジェクトのインポートを参照してください。
HATS Web プロジェクトのエクスポートとインポート
Web プロジェクトのエクスポート
HATS Web プロジェクトをエクスポートすると、保存してバックアップとして使用したり、別の HATS Toolkit システムに移したりできます。エクスポートを実行するには、以下の方法を使用します。
プロジェクト交換ファイル
この機能には、複数の特長があります。この機能では、複数のプロジェクトと関連する .ear ファイルをすべて同時にエクスポートできます。この場合、プロジェクト交換ファイルをインポートする前に、宛先の HATS Toolkit でプロジェクトを作成する必要はありません。プロジェクトをプロジェクト交換ファイルとしてエクスポートするには、以下の手順を実行します。
- メニュー・バーから、「ファイル」>「エクスポート」を選択して、「エクスポート」ウィザードを開きます。
- 「その他」>「プロジェクト交換」を選択し、「次へ」をクリックします。
- プロジェクトと、その関連 EAR プロジェクトの両方を選択します。
- プロジェクトを保存する .zip ファイルの .zip ファイル名と場所を指定します。
- 「完了」をクリックします。
Web プロジェクトのインポート
プロジェクト交換ファイル内のプロジェクトを HATS Toolkit にインポートするには、次の手順を実行します。
- メニュー・バーから、「ファイル」>「インポート」をクリックして、「インポート」ウィザードを開きます。
- 「その他」>「プロジェクト交換」を選択し、「次へ」をクリックします。
- 「ソース ZIP ファイル」フィールドに、インポートする .zip ファイルを指定します。
- ファイルのインポート先ワークスペースを「プロジェクト・ロケーション・ルート」フィールドに指定します。
- 指定したワークスペースにインポートする「プロジェクト交換」ファイル内のプロジェクトを選択します。
- 「完了」をクリックします。
前のリリースの HATS から HATS プロジェクトをマイグレーションする方法について詳しくは、HATS のマイグレーションを参照してください。
HATS Web アプリケーションの展開
HATS Web アプリケーション、WebSphere アプリケーション、および Java™ EE アプリケーション という用語は、同義で使用され、HATS プロジェクトから作成された Web アプリケーションを指します。HATS Toolkit で開発されているため、これは HATS Web アプリケーションです。また、WebSphere Application Server にインストールされて実行されるので、WebSphere アプリケーションでもあります。Java EE 標準に準拠するため、Java EE アプリケーションです。
HATS Web アプリケーションをランタイム環境に展開するには、以下を行う必要があります。
- HATS ランタイムを使用可能にします。
- プロジェクトを Java EE アプリケーションとしてエクスポートします。
- ランタイム環境でのアプリケーションのインストール
- ランタイム環境で必要な変更
以下のセクションでは、これらのタスクのそれぞれを実行する方法を説明しています。
HATS ランタイムの使用可能化
HATS パッケージをどこで取得するかには関係なく (HATS CD、Web、または別の製品とのパッケージ)、同じバージョンの HATS Toolkit をインストールします。これは、HATS の評価に使用できる使用制限付きバージョンです。取得済みライセンス証書に合わせて実稼働環境のランタイムを完全に使用可能にするには、HATS Toolkit に組み込まれている「ライセンス設定」ウィザードを使用して、ライセンス設定を指定する必要があります。詳しくは、「HATS スタートアップ・ガイド」のセクション『HATS の評価』および『HATS ランタイムの使用可能化とライセンス設定 (Enabling HATS runtime and license settings)』を参照してください。
プロジェクトを Java EE アプリケーションとしてエクスポート
HATS Web アプリケーションを WebSphere Application Server ランタイム環境に展開するには、まず最初にこれを Java EE アプリケーションにパッケージ化する必要があります。このパッケージ化を行うには、プロジェクトを EAR ファイルとしてエクスポートします。
プロジェクトをエクスポートするには、以下のステップを実行します。
- 「HATS プロジェクト」ビュー内のプロジェクトの名前を強調表示 (シングルクリック) します。
- メイン・ツールバーの「HATS プロジェクトをエクスポート」アイコンをクリックするか、またはプロジェクト名を右クリックして、「プロジェクトをエクスポート」を選択します。
- 「エクスポート」ウィンドウで、ドロップダウン・リストからエンタープライズ・アプリケーション・プロジェクトを選択するか、または「EAR プロジェクト」フィールドにエンタープライズ・アプリケーション・プロジェクトの名前を入力します。
- 「宛先」フィールドに宛先の場所を入力するか、または「参照」ボタンをクリックしてエクスポートされる .ear ファイルの宛先を選択します。
- プロジェクトのソース・ファイルを実行可能ファイルとともにエクスポートする場合は、「ソース・ファイルのエクスポート」ボックスを選択します。ソース・ファイルを含めた場合は、別の開発者が .ear ファイルからこのソース・ファイルを抽出できます。これにより、コラボレーションまたはサービスがより容易になる可能性がありますが、このためにセキュリティー・リスクが生じるかどうかを判断する必要もあります。
- 以前に、このプロジェクトを指定した場所にエクスポートしたことがある場合は、エクスポート処理で既存のファイルを上書きするかどうかが確認されます。この確認は、プロジェクトの前のバージョンを保持またはアーカイブしたいファイルを誤って上書きしないようにすることを目的としています。この確認なしで前のファイルを上書きする場合は、「既存ファイルの上書き」ボックスを選択してください。
- 「完了」をクリックします。プロジェクトが、拡張子 .ear を持つエンタープライズ・アーカイブ・ファイルによって表される Java EE アプリケーションとして、指定したディレクトリーとファイル名でエクスポートされます。
ランタイム環境でのアプリケーションのインストール
HATS プロジェクトを Java EE アプリケーションとしてエクスポートし、アプリケーションの .ear ファイルを実動システムに転送した後、WebSphere 管理コンソールを起動してそれをインストールし、.ear ファイルの場所を参照します。
WebSphere Application Server 上へのアプリケーションのインストールについて詳しくは、http://www.ibm.com/software/webservers/appserv/was/library/ の WebSphere Application Server のライブラリーを参照して、ご使用の WebSphere Application Server のバージョン用のインフォメーション・センターのリンクを選択してください。ご使用の WebSphere
Application Server 製品のコンテンツで、アプリケーションの展開に関する章を参照してください。
アプリケーションがインストールされた後、別のシステム上の Web ブラウザーでこの URL を指定して開いて、これをテストします。問題がなければ、この URL をユーザーに公開することができます。URL は、例えば http://hostname/hatsappname/ というようになります。ここで、hostname が WebSphere Application Server がインストールされている IP ホスト名とドメインで、hatsappname がご使用の HATS アプリケーションの名前です。
注:
- 特定のプラットフォーム上への HATS アプリケーションのインストールについての詳細は、HATS インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp) を参照してください。
- HATS アプリケーションを Java 2 セキュリティーを使用可能にして WebSphere Application Server に展開した際にアプリケーションが開始しない場合、詳細については、Java 2 セキュリティーを参照してください。
- HATS は、同じ HATS アプリケーションにアクセスする同じワークステーションからの複数のブラウザー・インスタンスをサポートします。ただし、これらの複数のブラウザー・インスタンスは、同じ HTTP セッション ID を共有してはなりません。
HATS アプリケーションにアクセスするブラウザーと WebSphere Application Server の間のセッションには、HTTP セッション ID が割り当てられます。この HTTP セッション ID によって、同じブラウザーからの後続の要求を同じ HATS アプリケーションに戻すことができます。後続の要求は、サーバー上の HATS アプリケーションとホストの間に存在する同じ Telnet (3270 または 5250) セッションを使用します。
さまざまなブラウザーが、さまざまな方法で HTTP セッション ID を実装しています。Microsoft® Internet
Explorer は、同じプロセス内のすべてのブラウザー・セッションが同じ HTTP セッション ID を共用することを想定しています。同じショートカットを使用して新規ブラウザー・ウィンドウを起動すると、新規ブラウザー・セッションが開始され、同じプロセスと同じ HTTP セッション ID を共用します。
固有の HTTP セッション ID を持つ新しい Internet Explorer プロセスを開く 1 つの方法は、例えば、Windows® XP で、Internet Explorer がスタート・メニューにある場合、「スタート」>「Internet Explorer」を選択することです。「スタート」>「すべてのプログラム」>「Internet Explorer」を選択しても、固有の HTTP セッション ID を持つ新しい Internet Explorer プロセスが開始されます。
注:
- Internet Explorer の Ctrl-N 機能では、新しいプロセスは開始されません。これは、発生元のウィンドウと同じプロセス ID と同じ HTTP セッション ID を持つ新しいウィンドウが開かれるためです。
- Internet Explorer 8 の場合、「ファイル」>「新規セッション」を使用して、固有のセッション ID を持つ新しいブラウザーを開くことができます。
注:
Internet Explorer では、メニュー・バーから「表示」>「ソース」を選択するか、または Internet Explorer ブラウザー・ウィンドウで右クリックして「ソースの表示」を選択し、ページのソース・タグ設定を表示することにより、ブラウザー・ウィンドウの HTTP セッション ID を見つけることができます。ソース・ウィンドウで、次に示すような HATS Form タグまでスクロールダウンします。
<FORM NAME="HATSform" dir="" METHOD="POST"
ACTION="/YourHATSAppName/entry">.
その Form タグ内で、次に示すような SESSIONID パラメーターを見つけます。
<INPUT TYPE="HIDDEN" NAME="SESSIONID"
VALUE="PIOncS1GehNWxWo_49VCBzC" />
注:
開始時に画面のデフォルト変換の表示のみを行い、マクロは実行しない HATS アプリケーションにアクセスすると、SESSIONID の値は「INVALID」です。SESSIONID 値は、ホストに対して何かを送信 (Enter キーを押すなど) して応答を取得したときに割り当てられます。
Windows でタスク・マネージャーを使用することにより、新しいプロセスが開始されているかどうかを確認できます。タスク・マネージャーを開始し、「プロセス」タブの「イメージ名」列見出しをクリックして情報をイメージ名でソートします。スクロールダウンして、リスト内に「iexplore.exe」プロセスがいくつあるかを確認します。「スタート」>「Internet Explorer」ショートカットを使用して、新しい Internet Explorer ウィンドウをいくつか開始してみてください。 新しいプロセスが開始されると、新しい iexplore.exe プロセスが表示に追加されます。それ以外の場合は、既存のプロセスが新しいブラウザー・ウィンドウを制御しています。
- HATS では、アプリケーションの web.xml ファイルに定義されているアプリケーションの表示名が、ブラウザーの URL で使用する Web アプリケーションのコンテキスト・パスと一致している必要があります。表示名値をアプリケーションのコンテキスト・パスと異なる値に変更すると、HATS アプリケーションを実行したときに java.lang.nullPointerException エラーまたは javax.servlet.ServletException エラーが発生することがあります。例えば、MyHatsProject という名前の HATS プロジェクトでは、MyHatsProject がデフォルトの表示名です。このプロジェクトを Web アプリケーションとしてデプロイしたときに正しく作動させるには、http://myServer/MyHatsProject/ のような URL でアクセスできる必要があります。表示名を MyHatsProject 以外の何らかの値に変更すると、アプリケーションが作動不能になります。
ランタイム環境で必要な変更
クラス・ローダー・ポリシーの構成
HATS Web アプリケーションをデプロイするか、これらのアプリケーションをローカル・テスト環境で実行する場合は、以下のいずれかの状態に対して、 Java EE アプリケーションごとを基準として、WAR クラス・ローダー・ポリシーを構成する必要があります。
- アプリケーションにビジネス・ロジックが組み込まれている。このビジネス・ロジックにより、ClassNotFoundException が発生する可能性があります。
- アプリケーションにカスタム・コンポーネントまたはカスタム・ウィジェットが組み込まれている。このコンポーネントまたはウィジェットにより、ClassNotFoundException が発生する可能性があります。
HATS は、これらのアプリケーションのクラス・ローダー・ポリシーを自動的に構成します。
クラスター環境での HATS アプリケーションの構成
縦方向にクラスター化された環境に HATS Web アプリケーションを配置すると、各アプリケーション・サーバー・インスタンスは、ロギング、トレース、およびライセンス追跡用の独自のファイルを作成します。これは、出力ファイルの名前にアプリケーション・サーバー・インスタンスの完全修飾名を付け足すことによって実行されます。例えば、ロギング・ファイルのデフォルト・パターンは messages.txt ですが、実際のファイル名は messages_myCell_myNode_myAppServerInstance_1.txt のようになります。
デフォルトでは、すべてのサーバー・インスタンスが同じ runtime.properties ファイルの設定を読み取ります。ランタイム設定を正しく制御するには、各インスタンスが専用のランタイム・プロパティー・ファイルを持つように構成する必要があります。これにより、各インスタンスのトレースを個別に制御できるようになり、ランタイム設定が意図せず変更されるのを防ぐことができます。
縦方向にクラスター化された HATS アプリケーションのインスタンスがそれぞれ専用の runtime.properties ファイルを持つように構成するには、次の手順を実行します。
- 縦方向のクラスター内のアプリケーション・サーバー・インスタンスごとに、runtime.properties ファイルのコピーを作成します。
- ご使用の HATS アプリケーションの runtime.properties ファイルを見つけます。このファイルは、WebSphere Application Server をインストールしたディレクトリーの下の installedApps¥app_name.ear ディレクトリーにあります。
- 各インスタンスで、runtime.properties ファイルのコピーを作成します。そのファイルは固有の名前が付けられ、同じディレクトリーに配置されます。例えば、ファイル Clone1runtime.properties、Clone2runtime.properties などの名前を付けます。有効なファイル名であれば何でもかまいませんが、このファイルに関連するアプリケーション・サーバー・インスタンスを管理者が特定できるような名前にしてください。
- この時点で、n 個のサーバー・インスタンスに対して固有のランタイム・プロパティー・ファイルを n 個保持しています。
- 縦方向にクラスター化された環境内に複数の HATS .ear ファイルがある場合は、各 .ear ファイルのディレクトリーでこの手順を繰り返します。
- 新規構成設定を追加して、各インスタンスで使用する runtime.properties ファイルを識別します。
例えば、WebSphere Application Server V6.x の場合は、以下のようにします。
- WebSphere Application
Server 管理コンソールの左側のナビゲーション・ペインにある「サーバー」項目の「アプリケーション・サーバー」を選択します。
- アプリケーション・サーバーのリストからサーバー・インスタンスを選択します。
- サーバーの「構成」タブから、「Java およびプロセス管理」を選択します。
- 「プロセス定義」>「Java 仮想マシン」>「カスタム・プロパティー」を選択します。
- 「カスタム・プロパティー」ウィンドウで、「新規」をクリックします。
- 「名前」フィールドに hats.runtime.properties と入力します。
- 「値」フィールドで、Clone2runtime.properties など、このサーバーに対して作成したプロパティー・ファイルの名前を入力します。この値でディレクトリー名やスラッシュは指定しないでください。
- 「説明」フィールドには値は必要ありません。
- 「適用」をクリックします。
- 各サーバー・インスタンスに対してこの手順を繰り返します。
新規カスタム・プロパティーを追加して、各サーバー・インスタンスに固有の名前の付いた専用の runtime.properties ファイルのコピーがあることを確認したら、新規ファイルの使用を開始するように各アプリケーションを再始動する必要があります。
HATS 管理コンソールは、クラスター・メンバーの設定を制御するのに使用できます。「管理 Web (Administration Web)」ページの「ナビゲーション (Navigation)」パネルの「スタートアップ・ガイド」フォルダーを使用して、「管理の有効範囲」を選択します。クラスターを選択した後、「トレース設定」の表示を選択すると、制御する特定のクラスター・メンバーの入力を要求されます。
注:
クラスタリングとユーザー・リストを使用する場合は、以下のような特別な考慮事項があります。詳しくは、
クラスタリングとユーザー・リストを参照してください。
モバイル装置用の HATS アプリケーションの作成
携帯電話、データ収集端末、および携帯情報端末 (PDA) などのモバイル装置からアクセス可能な HATS Web アプリケーションを開発することができます。開発プロセスは、HATS Web アプリケーションを開発する場合と同じですが、画面サイズや対話の制限など、モバイル装置とその Web ブラウザーの機能に関するいくつかの考慮事項があります。
モバイル装置用のアプリケーションのプロジェクトを作成するには、次のいずれかの操作によって「プロジェクトの作成」ウィザードを起動します。
- メニュー・バーから「HATS」>「新規」>「プロジェクト」を選択します。
- メニュー・バーから「ファイル」>「新規」>「HATS プロジェクト」を選択します。
- ツールバーの「HATS プロジェクトを作成」アイコンをクリックします。
「プロジェクトの作成」ウィザードの「HATS プロジェクト」パネルで、以下のようにします。
- モバイル装置プロジェクトの名前を入力します。
- オプションで、説明を入力します。
- デフォルトの場所をそのまま使用します。
- 「Web」を選択して、これが Web プロジェクトであることを示します。
注:
Web デプロイメント・オプションが使用不可になっている場合、サーバー・ランタイムが定義されていないことを示しています。サーバー・ランタイムを定義するには、「ウィンドウ」>「設定」>「サーバー」>「インストール済みランタイム」と移動して、少なくとも 1 つのランタイム定義を追加します。
- 「ターゲット・サーバー」フィールドで、サポートされるいずれかの WebSphere Application Server を選択します。
- 「エンタープライズ・アプリケーション・プロジェクト」フィールドに、ローカル・テスト環境でのテストに使用する EAR プロジェクトの名前を入力します。
- 「モバイル装置用にオプションを最適化」を選択します。
- 「次へ」をクリックして、プロジェクトの作成を通常どおりに続行します。
モバイル装置に関する考慮事項および制約事項
ユーザーが HATS プロジェクトを作成し、「モバイル装置用にオプションを最適化」を選択すると、HATS は、モバイル装置に最も適したオプションを使用してプロジェクトを初期化します。印刷、キーボード、非同期更新などの一部のオプションはサポートされていないため、使用不可に設定されています。モバイル装置用のアプリケーションを開発する場合は、次の考慮事項と制約事項に注意してください。
- モバイル装置用に最適化されていない HATS プロジェクトを、モバイル装置用に最適化された HATS プロジェクトに変換 (またはその反対) できるようにする自動化されたオプションはありません。
- プロジェクトのテーマを指定するためのオプションは提供されていません。代わりに、モバイル装置で最適に機能するようにオプションが自動的に初期化されます。
- プロジェクトで使用するために、モバイル装置用に最適化されたテンプレートのみ提供されています。
注:
Modern テンプレートを使用するときに水平スクロールが不要な場合は、Modern.jsp テンプレート・ファイルの .roundedcornermodule に overflow: auto; スタイルを追加してください。例えば、.roundedcornermodule
{margin: 0px;} を .roundedcornermodule { margin: 0px; overflow:
auto; } に変更します。これにより、ページが元のサイズを保持するよう強制され、装置上の可視画面内に入るよう強制されます。この結果、場合によっては、ページ上のデータが切り捨てられることがあります。したがって、カスタマイズされたページとウィジェット選択の設計では、画面サイズを考慮する必要があることに注意してください。
- 「コンパクト (compact)」 という第 2 レンダリング・セットがプロジェクトで作成されます。このレンダリング・セットは、デフォルト・レンダリング・セットとして指定されます。また、「コンパクト・レンダリングの使用」 オプションが選択されており、デフォルト・レンダリングでの HTML と空白スペースの量が削減されるため、順に元のホスト画面とは異なる構造が表示される場合があります。
- HATS 設定の「フリー・レイアウト・テーブルを含める」は、新規ブランク変換を作成する際に有効になりますが、追加の修飾子として、「プロジェクトがモバイル装置用に最適化されている場合を除く」を持っています。この修飾子はデフォルトで選択されています。そのため、モバイル・プロジェクトに追加されたブランク変換には、デフォルトではフリー・レイアウト・テーブルは含まれません。
- 「フィールドの終了」、「フィールド+」、および「フィールド-」は、「入力フィールドのカーソル位置オプションを使用可能にする」オプションを「ホスト・キーパッド」または「ホスト・キー」ボタンと組み合わせることで使用できます。
- フィールド・ウィジェットには、テーブルではなくインライン・スパン・タグを使用して出力をレンダリングし、フィールド間の識別を行うための、「分離」レイアウト・オプションが用意されています。このオプションを使用する目的は、HTML および空白スペースの量を減らすことです。これはモバイル・プロジェクトのデフォルト設定です。
- HATS には、サブファイル・ウィジェットおよびテーブル・ウィジェット用の 「列の配置」サポートが用意されています。このサポートは、モバイル装置にテーブル・データを表示する際に有用であり、ディスプレイで列の配置や除外を行ったり、拡張可能な詳細セクションを使用して、テーブルをより小さなスペースに収めたりすることができます。
詳細セクションは、拡張時にデータの基本列を含む行のすぐ下に表示されます。該当する特定の行がユーザーにより識別されると、その行の詳細は、拡張されたときに画面の右方向ではなく下方向に続く形式で表示されます。これにより、小さな画面でも、水平スクロールを使用せずに、任意の数の列からなる必要な詳細を表示できるようになります。
以下の図は、ホスト画面上に表示されるサブファイルを示しており、その次の図はそれぞれ、デフォルトの「列の配置」サポートを使用したときのサブファイルの基本ビューおよびサブファイルの詳細ビューを示しています。
図 4. デフォルトの「列の配置」サポートを使用したときのサブファイルの基本ビュー
図 5. デフォルトの「列の配置」サポートを使用したときのサブファイル行の詳細ビュー
画面のサイズの保存に加えて、詳細の列を、HTTP を使用してユーザーのブラウザーに送信せずに、要求されるまでサーバー上に保持しておくようウィジェットを構成できます。これにより、不要な詳細データが HTTP を介して終端装置に送られることがなくなるため、転送されるデータの量を削減できる場合があります。ユーザーによって具体的に要求された詳細のみが、オンデマンドで取り出されて、ブラウザーに送信されます。
注:
サブファイルのデータ部分を認識するためのフィールド・コンポーネントを使用するよう構成されたサブファイルは、基本列機能および詳細列機能を有効に使用することはできません。これは、このようなサブファイルは行しか識別できず、列は識別できないからです。
ウィジェット設定で説明されている「列の配置」サブファイルおよびテーブル・ウィジェットの設定に加えて、次の設定を使用して、このオプションで使用するコントロールの外観をさらにカスタマイズすることができます。これらの設定は、HATS Toolkit GUI には表示されません。代わりに、ウィジェットのソースにこれらの設定を追加する必要があります。以下のソースは、例としてサブファイル・ウィジェットを使用したときのこれらの設定のサンプルです。
<class name="com.ibm.hats.transform.widgets.SubfileWidgetV6">
<setting name="normalColumnLayout" value="1,2"/>
<setting name="extendedColumnLayout" value="3*"/>
<setting name="keepExpansionOnServer" value="true"/>
<setting name="expandHeaderValue" value="fred"/>
<setting name="expandRepresentation" value="button"/>
<setting name="expandValue" value="click me"/>
<setting name="collapseRepresentation" value="image"/>
<setting name="collapseValue" value="/common/images/twisty1.gif"/>
<setting name="collapseAltValue" value="hide"/>
</class>
- expandRepresentation
- 詳細を表示するコントロールに使用するグラフィカル表現を決定します。「button」、「link」、または「image」を指定します。デフォルトは「link」です。
- expandValue
- expandRepresentation が「button」または「link」の場合、この値はボタンまたはリンク上のテキストとして使用されます。値を指定しない場合は、デフォルトで正符号 (+) が使用されます。空ストリング値 "" は使用できず、デフォルトで正符号 (+) に設定されます。
expandRepresentation が「image」の場合は、この値は使用するイメージ・ファイルのパスおよび名前です。パスは、プロジェクトの Web コンテンツ・ディレクトリーを基準にして検索されます。例えば、Web Content/common/images ディレクトリーに twisty1.gif を指定する場合、次のように expandValue を設定します。
<setting name="expandValue" value="/common/images/twisty1.gif "/>
- expandAltValue
- この設定はイメージの代替テキストを提供します。これは、expandRepresentation が 「image」 に設定され、ブラウザーが指定されたイメージを表示できない場合にのみ使用されます。例えば、Internet Explorer Mobile の「メニュー」>「表示」>「画像を表示する」オプションが選択されていない場合などです。
- collapseRepresentation
- 詳細を隠すコントロールに使用するグラフィカル表現を決定します。「button」、「link」、または「image」を指定します。デフォルトは「link」です。
- collapseValue
- collapseRepresentation が「button」または「link」の場合、この値はボタンまたはリンク上のテキストとして使用されます。値を指定しない場合は、デフォルトで負符号 (-) が使用されます。空ストリング値 "" は使用できず、デフォルトで負符号 (-) に設定されます。
collapseRepresentation が「image」の場合は、この値は使用するイメージ・ファイルのパスおよび名前です。パスは、プロジェクトの Web コンテンツ・ディレクトリーを基準にして検索されます。例えば、Web Content/common/images ディレクトリーに twisty1.gif を指定する場合、次のように collapseValue を設定します。
<setting name="collapseValue" value="/common/images/twisty1.gif "/>
- collapseAltValue
- この設定はイメージの代替テキストを提供します。これは、collapseRepresentation が 「image」 に設定され、ブラウザーが指定されたイメージを表示できない場合にのみ使用されます。例えば、Internet
Explorer Mobile の「メニュー」>「表示」>「画像を表示する」オプションが選択されていない場合などです。
- expandHeaderValue
- この設定では、詳細コントロールの列のヘッダー・テキストを指定します。"" と指定された値は、テキストのないヘッダーを作成します。
- expandStyle、expandClass、expandHeaderStyle、expandHeaderClass、
expandAreaStyle、expandAreaClass、expandRowStyle、expandRowClass、
collapseStyle、collapseClass、collapseAreaStyle、collapseAreaClass
- これらの設定は、当該オプションのコントロールのクラスおよびスタイルのオーバーライドです。指定しない場合は、ウィジェットの標準値が適用されます。標準 HTML スタイルを使用でき、クラスは順番に適用されます。
- 「入力フィールドのカーソル位置オプションを使用可能にする」設定は、入力フィールドのレンダリングに使用するウィジェットで使用でき、ユーザーはこの設定を使用して、入力フィールドでデータ入力モードからカーソル位置決めモードに切り替えることができます。データ入力モードでは、ユーザーは入力フィールドにデータを入力できます。カーソル位置決めモードでは、ユーザーはタブまたはその他の方法により、入力フィールド内の任意の文字上にカーソルを置くことができます。この設定は、他のカーソル位置決め機能がない装置を使用する場合に役立ちます。
ウィジェット設定で説明されている「入力フィールドのカーソル位置オプションを使用可能にする」 ウィジェット設定に加えて、次の設定を使用して、このオプションで使用するコントロールの外観をさらにカスタマイズできます。これらの設定は、HATS Toolkit GUI には表示されません。代わりに、ウィジェットのソースにこれらの設定を追加する必要があります。以下のソースは、例としてフィールド・ウィジェットを使用したときのこれらの設定のサンプルです。
<class name="com.ibm.hats.transform.widgets.FieldWidget">
<setting name="dataModeCEPRepresentation" value="button"/
<setting name="dataModeCEPValue" value="back"/>
<setting name="dataModeCEPAltValue" value="data entry"/>
<setting name="cursorModeCEPRepresentation" value="image"/>
<setting name="cursorModeCEPValue" value="cursorOn.gif"/>
<setting name="cursorModeCEPAltValue" value="cursor entry"/>
<setting name="cursorCEPRepresentationStyle"
value="text-underline:true"/>
<setting name="useCursorExactPositioningOption" value="true"/>
</class>
- dataModeCEPRepresentation
- データ・モードの場合に、入力フィールドの横に表示されるコントロールに使用するグラフィカル表現を決定します。「button」、「link」、または「image」を指定します。デフォルトは「link」です。
- dataModeCEPValue
- dataModeCEPRepresentation が「button」または「link」の場合、この値はボタンまたはリンク上のテキストとして使用されます。値を指定しない場合は、デフォルトでアスタリスク文字 (*) が使用されます。空ストリング値 "" は使用できず、デフォルトでアスタリスク文字 (*) に設定されます。
dataModeCEPRepresentation が「image」の場合は、この値は使用するイメージ・ファイルのパスおよび名前です。パスは、プロジェクトの Web コンテンツ・ディレクトリーを基準にして検索されます。例えば、Web Content/common/images ディレクトリーに sbarleftblk.gif を指定する場合、次のように dataModeCEPValue を設定します。
<setting name="dataModeCEPValue"
value="common/images/sbarleftblk.gif"/>
- dataModeCEPAltValue
- この設定はイメージの代替テキストを提供します。これは、dataModeCEPRepresentation が 「image」 に設定され、ブラウザーが指定されたイメージを表示できない場合にのみ使用されます。例えば、Internet
Explorer Mobile の「メニュー」>「表示」>「画像を表示する」オプションが選択されていない場合などです。
- dataModeIconClass、dataModeIconStyle
- これらの設定は、データ・モード表示アイコンのスタイルおよびクラスのオーバーライドです。指定しない場合は、ウィジェットの標準値が適用されます。標準 HTML スタイルを使用でき、クラスは順番に適用されます。
- cursorModeCEPRepresentation
- カーソル・モードの場合に、入力フィールドの横に表示されるコントロールに使用するグラフィカル表現を決定します。「button」、「link」、または「image」を指定します。デフォルトは「link」です。
- cursorModeCEPValue
- cursorModeCEPRepresentation が「button」または「link」の場合、この値はボタンまたはリンク上のテキストとして使用されます。値を指定しない場合は、デフォルトでアスタリスク文字 (*) が使用されます。空ストリング値 "" は使用できず、デフォルトでアスタリスク文字 (*) に設定されます。
cursorModeCEPRepresentation が「image」の場合は、この値は使用するイメージ・ファイルのパスおよび名前です。パスは、プロジェクトの Web コンテンツ・ディレクトリーを基準にして検索されます。例えば、Web Content/common/images ディレクトリーに sbarrightblk.gif を指定する場合、次のように cursorModeCEPValue を設定します。
<setting name="cursorModeCEPValue"
value="common/images/sbarrightblk.gif "/>
- cursorModeCEPAltValue
- この設定はイメージの代替テキストを提供します。これは、cursorModeCEPRepresentation が 「image」に設定され、ブラウザーが指定されたイメージを表示できない場合にのみ使用されます。例えば、Internet Explorer Mobile の「メニュー」>「表示」>「画像を表示する」オプションが選択されていない場合などです。
- cursorCEPRepresentationStyle
- このスタイルは、現在選択されているカーソル位置を強調表示する場合に使用されます。デフォルトは「border-bottom: 1px solid green;」です。ただし、空ストリング "" は有効です。
- cursorModeCEPStyle
- これは、カーソル・モードの場合に、入力フィールドで使用されるスタイルです。デフォルトのスタイルは、「border: 1px solid #999999; height: 1.75em;」です。必要な場合以外は、このスタイルを変更しないようにしてください。
- cursorCEPRepresentationClass、cursorModeIconClass、cursorModeIconStyle、
cursorModeCEPClass、cursorModeCEPTextStyle、cursorModeCEPTextClass
- これらの設定は、カーソル・モード領域の要素を修飾するためのクラスおよびスタイルのオーバーライドです。指定しない場合は、ウィジェットの標準値が適用されます。標準 HTML スタイルを使用でき、クラスは順番に適用されます。
- dataModeIconClass、dataModeIconStyle
- これらの設定は、データ・モード領域の要素を修飾するためのクラスおよびスタイルのオーバーライドです。指定しない場合は、ウィジェットの標準値が適用されます。標準 HTML スタイルを使用でき、クラスは順番に適用されます。
- ワイヤレス接続の際に、ルーターまたは HTTP サーバーへの接続が失われた、複数のインスタンスがあります。これが発生すると、Web ページがロックされることがあり、HATS で情報を再送できません。この問題を解決するために、以下の設定を使用できます。これらの設定は、「プロジェクト設定」ソース・ビュー (application.hap ファイル) の RuntimeSettings クラスで使用できます。
- usePageUID
- pageUID の画面配置を有効にするかどうかを指定します。これにより、ランタイムで、ページが送信済みであるかどうかを追跡できます。この値が false の場合は、pageSubmitTimeout 値が読み取られません。デフォルト値は false です。
- pageSubmitTimeout
- Web ページのロックを解除してユーザーが使用できるようにするまでの待ち時間をミリ秒単位で指定します。値に -1 を指定するか空にすると、この機能が非アクティブになります。デフォルト値は -1 です。
- incorrectPageUIDEvent
- ユーザーの Web ページによる HTTP 要求の PageUID が、該当のセッション ID およびアプリケーション・インスタンスのランタイムに保管されている PageUID と一致しない 場合の対処方法を指定します。REFRESHCOMMAND または ERROREVENT の 2 つのオプションがあります。デフォルトは REFRESHCOMMAND です。
以下のソースは、これらの設定のサンプルを示しています。
<class name="com.ibm.hats.common.RuntimeSettings">
<setting name="autoEraseFields" value="true"/>
<setting name="enableAutoAdvance" value="false"/>
<setting name="enableAutoTabOn" value="false"/>
<setting name="enableBusyPage" value="false"/>
<setting name="enableCompression" value="false"/>
<setting name="enableOverwriteMode" value="false"/>
<setting name="incorrectPageUIDEvent" value="REFRESHCOMMAND"/>
<setting name="pageSubmitTimeout" value="1000"/>
<setting name="selectAllOnFocus" value="false"/>
<setting name="suppressUnchangedData" value="false"/>
<setting name="usePageUID" value="true"/>
</class>
- iPhone または iPod touch デバイスで実行されているブラウザーから別のアプリケーションに切り替えると、ブラウザーからの AJAX ポーリングが停止します。この結果、HATS にアクセスしているブラウザーから、デバイス上の別のアプリケーションに切り替えたとき、切断を待機する時間 (秒) 間隔が経過した後、HATS によりブラウザー・セッションが切断されます。この間隔を長くするのが適切な場合、あるいは iPhone または iPod touch デバイスからアクセスされる HATS アプリケーションの自動切断機能を無効にするのが適切な場合があります。詳しくは、クライアント・プル (AJAX) メソッドの使用を参照してください。
- DBCS の考慮事項について詳しくは、モバイル装置アプリケーションの操作を参照してください。
HATS が自動的に使用不可に設定するオプションの他に、以下の機能はサポートされていないため、モバイル装置用の HATS アプリケーションにはインプリメントしないでください。
- HATS Web プロジェクトをモバイル装置用 HATS Web プロジェクトにマイグレーションまたは自動変換することはできません。
- リッチ・クライアント・アプリケーション。
- ポータル・アプリケーション (標準または IBM®)。
- WebFacing との相互運用性。
- 双方向言語サポート。
- アクセシビリティー機能。
- 320x240 より小さい画面サイズのあらゆる装置。
- キーボード・ホスト・キー・サポート。
その結果、キーボードの使用は通常の Web キーボードと同様に機能しますが、ホスト・キーは送信されず、代わりに F1 キーでブラウザー・ヘルプを起動します。また、Enter キーはホスト Enter キーにマップされません。
また、キーボード・サポートがないため、HATS JavaScript™ はユーザーが HATS Web ページにデータを入力したことを判別できません。このため、新しいホスト画面がホスト・アプリケーションから非同期で受信されると、ユーザーが HATS アプリケーションの GUI ビューに入力したデータを自動最新表示サポートが上書きします。
- フィールド固有のヘルプ、右寄せ、先頭文字の大文字化、またはその他の属性。
- 装置のハードウェアまたはソフトウェアが原因の、その他のあらゆるデータ入力制限。
- モバイル装置による HATS 管理コンソール・ページへのアクセス。
- disconnectOnClose 接続パラメーター。
- 画面組み合わせ。
- タブ付きフォルダーのサポート。
- スプレッドシートのサポート。