| Oracle Application Development Framework開発者ガイド 10g（10.1.3.0） B40012-02 |
|
 戻る |
 次へ |
個別のWebページやそのソース・コードを詳細に検討する前に、Oracle ADFサービス・リクエスト・デモ（SRDemo）・アプリケーションの機能について理解しておくと役に立ちます。
この章には、次の項が含まれます。
SRDemoアプリケーションは、単純ですが完全なカスタマ・リレーションシップ・マネジメント対応のサンプル・アプリケーションです。家電製品販売会社の顧客は、このアプリケーションを通じてWeb上でサービス関連の問題を解決できます。16のWebページで構成されるこのアプリケーションは、次のフローに基づいて顧客の提出するサービス・リクエストを管理します。
顧客は、Web上のサービス・リクエスト・ポータルにアクセスしてログインします。
マネージャがログインしてリクエストを技術者に割り当てます。
また、ログイン中のマネージャは、サービスを提供するのに適した技術者が存在する製品のリストを参照および調整できます。
技術者がログインして割り当てられたリクエストを確認し、解決策を提示するか、顧客により詳しい情報の提供を求めます。
顧客はサイトに再度アクセスして自分のサービス・リクエストをチェックし、より詳しい情報を提供するか、技術者の解決策により問題が解決したことを確認します。
技術者は未解決だったサービス・リクエストを再度参照し、顧客により解決済と確認されたリクエストを終了します。
リクエストが未解決の間、マネージャは技術者の既存のリクエストを確認し、必要に応じてそのリクエストを別の技術者に割り当てます。
ログイン後の顧客、マネージャまたは技術者には、その役割に合ったアプリケーション機能のみが表示されます。
技術的には、このアプリケーションの設計はModel-View-Controller（MVC）アーキテクチャ・デザイン・パターンに準拠しており、その実装には次のような既存のJ2EEアプリケーション・フレームワークが使用されます。
エンティティ・クラスのアプリケーション・サービスをカプセル化するEJBセッションBean
TopLinkマッピングとデータベース表から作成されるJavaBeanエンティティ・クラス
JavaServer Facesのナビゲーション・ハンドラと宣言的なナビゲーション・ルール
標準的なJSF WebページにおけるOracle ADF Facesのユーザー・インタフェース・コンポーネント
データ・バインディングを提供するOracle ADF Modelレイヤー・コンポーネント
MVCスタイルのすべてのWebアプリケーションと同様に、SRDemoアプリケーションは、第I部「Oracle ADFアプリケーションの基礎」で説明した基本的なアーキテクチャに基づきます。
このガイドでは、各レイヤーにおける実装を詳細に説明します。それぞれの章で、Oracle JDeveloper 10gの各種機能について説明します。また、それらの機能を使用して、エンタープライズJ2EE開発者が使い慣れている技術を通じてJ2EE Webアプリケーションを構築する方法についても説明します。
SRDemoアプリケーションには、次の基本的な要件があります。
サンプル・スキーマ用に任意のエディションのOracleデータベースが必要です。
SRDemoのアプリケーション・スキーマに接続するため、SRDemoという名前のデータベース接続を作成する必要があります。更新センターを使用してSRDemoアプリケーションをインストールした場合、この接続は自動的に作成されます（2.2.3項「Oracle JDeveloperでのデータベース接続の作成」を参照）。
JDeveloperにJUnit拡張機能をインストールする必要があります。更新センターを使用してSRDemoアプリケーションをインストールした場合、この拡張機能も自動的にインストールされます（2.2.5項「JDeveloperでのOracle ADFサービス・リクエスト・デモのユニット・テストの実行」を参照）。
図2-1は、SRDemoアプリケーションのスキーマを示しています。
このスキーマは、5つの表と3つのデータベース順序で構成されています。表には、次のものが含まれます。
USERS: この表には、システムと対話するすべてのユーザー（顧客、技術者およびマネージャ）が格納されます。各ユーザーの電子メール・アドレス、姓と名、番地、市区町村、都道府県、郵便番号、国も格納されます。各ユーザーは、IDによって一意に識別されます。
SERVICE_REQUESTS: この表は、特定の製品に関する内部および外部のアクティビティ・リクエストを示します。すべての場合において、リクエストは、製品に関する問題の解決策に対応します。サービス・リクエストが作成されると、リクエストの日付、リクエストを提出した個人の名前、および関連製品がすべて記録されます。問題の短い説明も格納されます。リクエストが技術者に割り当てられると、技術者の名前と割当て日も記録されます。すべてのサービス・リクエストは、順序の割り当てられたIDによって一意に識別されます。
SERVICE_HISTORIES: 通常、サービス・リクエストごとに多くのイベントが記録されます。リクエストの作成日、リクエストを作成した個人の名前、およびイベントに関する特別な注意がすべて記録されます。サービス・リクエストに関連する内部的なやり取りも追跡されます。各サービス履歴は、サービス・リクエストとその順序番号によって一意に識別されます。
PRODUCTS: この表には、企業によって扱われるすべての製品が格納されます。製品ごとに、名前と説明が記録されます。製品の画像が使用可能であれば、それも格納されます。すべての製品は、順序の割り当てられたIDによって一意に識別されます。
EXPERTISE_AREAS: この表では、各技術者の専門技術の特定領域が定義されます。専門技術領域により、技術者の専門技術に基づいてサービス・リクエストを割り当てることができます。
順序は、次のとおりです。
USERS_SEQ: 新規ユーザーのIDを移入します。
PRODUCTS_SEQ: 各製品のIDを移入します。
SERVICE_REQUESTS_SEQ: 各新規サービス・リクエストのIDを移入します。
この項の手順では、Oracle JDeveloper 10g, Studio Editionのリリース10.1.3.xを実行していると仮定しています。アプリケーションは、これより前のリリースのJDeveloperでは動作しません。JDeveloperは、Oracle Technology Network（OTN）の次のURLでダウンロードできます。
http://www.oracle.com/technology/software/products/jdev/index.html
後述の手順を完了するには、Oracleデータベースにアクセスする権限と、新規ユーザー・アカウントを作成してサンプル・データを設定する権限を保持している必要があります。
SRDemoアプリケーションは、JDeveloperの拡張機能としてインストールできます。JDeveloperの更新の確認ウィザードを使用して、拡張機能をインストールするプロセスを開始します。
更新センターからSRDemoアプリケーションをインストールする手順:
JDeveloperを使用中の場合は、作業内容を保存して閉じます。後で、更新を完了するためにJDeveloperを再起動するよう求められます。
JDeveloperを起動して、「ヘルプ」→「更新の確認」を選択します。
ウィザードで、「次へ」をクリックし、「更新センターの検索」と内部自動更新が両方とも選択されていることを確認します。「次へ」をクリックします。
使用可能な更新の中から、Oracle ADF SRDemo Applicationを見つけて選択します。「次へ」をクリックしてダウンロードを開始します。
更新センターでは、SRDemoサンプル・アプリケーションのバージョンが2つ表示される場合があります。このガイドでは、説明に「EJB 3.0セッションBeanおよびTopLink永続性」と表示されているバージョンを選択すると仮定します。
プロンプトが表示されたら、JDeveloperを再起動します。
JDeveloperを再起動し、「はい」を選択してアプリケーション・ナビゲータでSRDemoアプリケーション・ワークスペースを開きます。
JDeveloperには、サンプル・データに使用するデータベースを識別するSRDemoアプリケーション・スキーマのインストール・ダイアログが表示されます。
SYSTEM DBAアカウントへのアクセス権限を保持しており、サンプル・データをインストールする場合は、サンプルのインストール・ダイアログに接続情報を入力します。
注意: 入力する接続情報の対象は、ローカル・データベースでもリモート・データベースでもかまいません。また、そのデータベースに既存のSRDemoスキーマが含まれているかどうかも無関係です。
SRDemoアプリケーションは、<JDEV_INSTALL>/jdev/samples/SRDemoSampleディレクトリに配置されます。JDeveloperがSRDemoアプリケーション・ワークスペースを作成できるように、更新センターによって拡張機能JARファイル<JDEV_INSTALL>/jdev/extensions/oracle.jdeveloper.srdemo.10.1.3.jarもインストールされます。
SRDemoスキーマは、<JDEV_INSTALL>/jdev/samples/SRDemoSample/DatabaseSchema/scriptsディレクトリに格納された一連のSQLスクリプトにより定義されます。スキーマは、更新センターを使用してアプリケーションをインストールすると自動的に作成されますが、手動での操作によりスキーマをインストールまたは再インストールする方法もいくつか用意されています。
|
注意: JDeveloperの更新センターを使用してSRDemoアプリケーションをインストールし、スキーマ・インストーラを実行した場合、次の手順は省略できます。詳細は、2.2.1項「Oracle ADFサービス・リクエスト・アプリケーションのダウンロードとインストール」を参照してください。 |
手動でSRDemoスキーマを作成するには、次の手順を実行します。
SRDemoスキーマを手動でインストールする手順:
コマンドラインで、SRDemoSampleルート・ディレクトリからSRDemoInstall.bat/.shコマンドライン・スクリプトを実行します。
または
JDeveloperで、SRDemoSampleワークスペースのBuildAndDeployプロジェクトのANTビルド・ファイルbuild.xmlを開き、タスクのポップアップ・メニューで「Antターゲットの実行」を選択してsetupDBOracleタスクを実行します。
または
SQL*Plusで、SYSTEMなどのDBAとして接続し、build.sqlスクリプトを実行します。
setupDBOracleタスクを使用してスキーマを手動でインストールすると、次の質問と選択肢が表示されます。
----------------------------------------------------------- SRDemo Database Schema Install 10.1.3 (c) Copyright 2006 Oracle Corporation. All rights reserved. ----------------------------------------------------------- This script installs the SRDemo database schema into an Oracle database. The script uses the following defaults: Schema name: SRDEMO Schema password: ORACLE Default tablespace for SRDEMO: USERS Temp tablespace for SRDEMO: TEMP DBA account used to create the Schema: SYSTEM If you wish to change these defaults update the file BuildAndDeploy/build.properties with your values -----------------------------------------------------------
この次の処理は、デモがどのようにインストールされているかと、JDeveloperのインストールの種類が完全と基本のどちらであるかに応じて変化します。
SRDemoアプリケーションが手動インストールされており、デフォルトの<JDEV_HOME>/jdev/samples/SRDemoSampleディレクトリに存在しない場合、JDeveloperのホーム・ディレクトリを尋ねるプロンプトが表示されます。
JDeveloperが基本インストール（JDKなしのインストール）である場合、JDK（1.5）の場所を尋ねるプロンプトが表示されます。
SRDemoアプリケーションが更新センターの使用により完全インストールのJDeveloperにインストールされている場合、作業はそのまま続行します。
次に、データベース情報の入力を求めるプロンプトが表示されます。2つのデフォルト・オプションのいずれかを選択するか、明示的に情報を指定します。
Information about your database: --------------------------------------------- Select one of the following database options: 1. Default local install of Oracle Personal, Standard or Enterprise edition Host=localhost, Port=1521, SID=ORCL 2. Default local install of Oracle Express Edition Host=localhost, Port=1521, SID=XE 3. Any other non-default or remote database install Choice [1]:
1または2を選択すると、インストールは最後まで自動的に進みます。3を選択した場合は、次の情報を入力する必要があります（大カッコ内はデフォルト値）。
Host Name or IP Address for your database machine [localhost]: Database Port [1521]: Database SID [orcl]:
最後に、DBAアカウントのパスワードを尋ねられます。
Enter password for the SYSTEM DBA account [manager]:
インストールはそのまま続行します。
サンプル・データ・スキーマに接続するには、SRDemoというデータベース接続を作成する必要があります。更新センターを使用してSRDemoアプリケーションをインストールした場合、この接続は自動的に作成されます。
|
注意: JDeveloperの更新センターを使用してSRDemoアプリケーションをインストールした場合、次の手順は省略できます。その場合、アプリケーションのダウンロード時にデータベース接続が自動的に作成されます。 |
サービス・リクエスト・スキーマに対する新規データベース接続を手動で作成するには、次の手順を実行します。
SRDemoアプリケーションのデータベース接続を手動で作成する手順:
JDeveloperで、「表示」→「接続ナビゲータ」を選択します。
「データベース」ノードを右クリックし、ポップアップ・メニューの「データベース接続の作成」を選択します。
「ようこそ」ページの「次へ」をクリックします。
「接続名」フィールドに、接続名としてSRDemoと入力します。「次へ」をクリックします。
注意: 接続名（SRDemo）は、大文字と小文字が区別されるため、SRDemoアプリケーションの正しい接続名と正確に一致するよう入力してください。
「認証」ページで、次の値を入力します。「次へ」をクリックします。
ユーザー名: SRDEMO
パスワード: Oracle
パスワードを配布: チェック・ボックスを選択
「接続」ページで、次の値を入力します。「次へ」をクリックします。
ホスト名: localhost
JDBCポート: 1521
SID: ORCL（またはXE）
注意: Oracle 10g Express Editionを使用している場合、デフォルトのSIDは「ORCL」ではなく「XE」です。
「接続のテスト」をクリックします。データベースが使用可能で接続の詳細が正しい場合は、次の手順に進みます。問題が発生した場合は、「戻る」ボタンをクリックして入力済の値をチェックします。
「終了」をクリックします。作成した接続が、接続ナビゲータの「データベース接続」ノードの下に表示されます。
これで、JDeveloperからスキーマを調査できます。接続ナビゲータで、「データベース」→「SRDemo」の順に開きます。スキーマのデータベース要素を参照し、それらの要素が2.1.2項「スキーマの概要」で説明したスキーマ定義と一致していることを確認してください。
更新センターを使用してSRDemoアプリケーションをインストールした場合、「ヘルプ」→Open SRDemo Application Workspaceを選択してアプリケーション・ワークスペースを開きます。
JDeveloperでアプリケーションを実行するには、図2-3のようにアプリケーション・ナビゲータでUserInterfaceプロジェクトを選択し、ポップアップ・メニューの「実行」を選択します。
|
ヒント: UserInterfaceプロジェクトでは、index.jspxがデフォルトの実行ターゲットとして定義されています。この情報は、UserInterfaceプロジェクトの「プロジェクト・プロパティ」ダイアログの「実行」ページに表示されます。これにより、プロジェクトがアクティブな状態でJDeveloperのツールバーの実行アイコンをクリックするか、プロジェクトを右クリックして「実行」を選択するだけで済みます。プロジェクトのプロパティを参照するには、ナビゲータでプロジェクトを選択して右クリックし、「プロジェクト・プロパティ」を選択します。 |
index.jspxページをJDeveloper内部から実行すると、Oracle Application Server 10gの埋込みOracle Containers for J2EE（OC4J）サーバーが起動し、デフォルト・ブラウザが開いて次のURLがリクエストされます。
http://130.35.103.198:8988/SRDemo/faces/app/SRWelcome.jspx
すべてが正しく処理されると、index.jspxページの単純なスクリプトレットのresponse.sendRedirect("faces/app/SRWelcome.jspx")により、図2-4のようなSRDemoアプリケーションのログイン・ページにリダイレクトされます。
|
ヒント: 使用中のマシンでDHCPを使用して自動的に割り当てられたIPアドレスを取得している場合、JDeveloperによりデフォルト・ブラウザが起動され、埋込みOC4Jが起動された後に、Webページが存在しないというHTTPエラーが表示されることがあります。この問題を解決するには、ホスト名にlocalhostを指定します。「ツール」メニューの埋込みOC4Jの設定を選択し、「起動」タブの「埋込みOC4Jへの参照に使用されるホスト名またはIPアドレス」プリファレンスで「ホスト名の指定」オプションを使用するよう設定してから、値としてlocalhostを入力します。次に、130.35.103.198のかわりにlocalhostを使用するよう前述のURLを編集します。 |
この開発者ガイドで扱っているWebページの概要は、2.3項「Oracle ADFサービス・リクエスト・デモのクイック・ツアー」を参照してください。また、クイック・ツアーを読むことでSRDemoアプリケーションで使用されているADFの機能について確認してください。クイック・ツアーには、このガイド内に記載されている実装の詳細へのリンクも含まれます。
JUnitは、Javaアプリケーションのリグレッション・テストを作成するための一般的なフレームワークです。Oracle JDeveloper 10gでは、JUnitテストの作成と実行がネイティブ・サポートされます。ただし、この機能は、個別にダウンロードしてインストールするJDeveloperの拡張機能です。JUnit拡張機能がインストール済かどうかを確認するには、JDeveloperのメイン・メニューで「ファイル」→「新規」を選択し、「新規ギャラリ」の「General」トップレベル・カテゴリに「Unit Tests (JUnit)」カテゴリがあるかどうかをチェックします。
JUnit拡張機能がまだインストールされていない場合は、JDeveloperの更新センターを使用してインストールします。
|
注意: JDeveloperの更新センターを使用してSRDemoアプリケーションをインストールした場合、次の手順は省略できます。その場合、アプリケーションのダウンロード時にJUnit拡張機能が自動的にインストールされます。 |
JDeveloperを使用中の場合は、作業内容を保存して閉じます。後で、更新を完了するためにJDeveloperを再起動するよう求められます。
JDeveloperを起動して、「ヘルプ」→「更新の確認」を選択します。
ウィザードで、「次へ」をクリックし、「更新センターの検索」と内部自動更新が両方とも選択されていることを確認します。「次へ」をクリックします。
使用可能な更新の中から、JUnit Integration 10.1.3.xxを見つけて選択します。「次へ」をクリックしてダウンロードを開始します。
プロンプトが表示されたら、JDeveloperを再起動します。
JDeveloperを再起動すると、新規拡張機能が「新規ギャラリ」の「Unit Tests」カテゴリに表示されます。
SRDemoアプリケーション・ワークスペースのUnitTestsプロジェクトには、図2-5のように、AllModelTests.javaクラスで構成された一連のJUnitテストが含まれます。リグレッション・テスト・スイートを実行するには、アプリケーション・ナビゲータでAllModelTests.javaクラスを選択し、ポップアップ・メニューの「実行」を選択します。このクラスはUnitTestsプロジェクトのデフォルトの実行ターゲットとして構成されているため、かわりにアプリケーション・ナビゲータでこのプロジェクト自体を選択し、ポップアップ・メニューの「実行」を選択することも可能です。
JUnitテスト・ランナー・ウィンドウが開き、スイート内のユニット・テストすべての実行結果が表示されます。各テストは、テスト・ケース別にグループ化され、左側にツリー表示されます。実行に成功したスイート内の各テストの横には、緑色のチェックマーク・アイコンが表示されます。また、進捗インジケータにより、完了したテストの割合をビジュアルで確認できます。
|
ヒント: JUnitの詳細は、http://www.junit.org/index.htmのWebページを参照してください。 |
SRDemoアプリケーションは、顧客が適切な技術者から製品サービス情報を得ることのできる実用的なWebポータル・アプリケーションです。顧客が新規サービス・リクエストを提出すると、サービス・マネージャは、そのリクエストを適切な専門技術を有する技術者に割り当てます。技術者は、未解決のリクエストを参照し、顧客が問題を解決する際に役立つと思われる情報でそのサービス・リクエストを更新します。
アプリケーションでは、3つのユーザー・ロール（顧客、マネージャおよび技術者）が区別されます。次からの各項で示すとおり、ユーザーが使用できるアプリケーション機能は、ユーザー・ロールに応じて変化します。
|
注意: この章の残りの部分では、SRDemoアプリケーションを実行したときに表示されるWebページの概要について説明します。このガイドに含まれる実装の詳細は、各項の最後にあるリストから簡単に参照できます。基礎となるビジネス・ロジックの概要は、第3章を参照してください。 |
顧客のログイン情報を次のように入力します。
ユーザー名: dfaviet
パスワード: welcome
Webポータル・ホームページに移動するには、「Sign On」ボタンをクリックします。
Webポータルに移動するには、「Start」ボタンをクリックします。
この操作により、顧客の未解決のサービス・リクエストのリストが図2-6のように表示されます。
顧客としてログインすると、リスト・ページには、2つのタブのみを含むメニューが表示されます（選択された「My Service Requests」のサブタブが表示されます）。
マネージャや技術者としてログインすると、追加のタブが表示されることに注意してください。
メニューの「All Requests」サブタブを選択すると、未解決と解決済の両方のリクエストが表示されます。
リクエストの説明を参照するには、希望するリクエストの行にあるラジオ・ボタンを選択し、「View」をクリックします。
同じ操作は、「Request Id」列のサービス・リクエスト・リンクをクリックしても実行できます。
顧客は、表示されるページを使用して、自分の入力情報でサービス・リクエストを更新できます。現在のサービス・リクエストにメモを追加するには、「Add a note」をクリックします。
図2-7は、顧客によって選択された未解決のサービス・リクエストと、追加されるメモを示しています。テキスト入力フィールドの上のボタンは、ユーザーによって操作されないように、作業が完了するまでグレー表示されることに注意してください。メモ・フィールドの下には、このマスター・サービス・リクエストに対する以前のメモのリストがあります。
実装の詳細の参照先
このガイドには、この項の次の主要機能に関する説明が含まれます。
動的ナビゲーション・メニューの使用: ユーザーがアプリケーションの目的のページにアクセスするためのメニュー・タブおよびサブタブは、各メニュー・コンポーネントをメニュー・モデル・オブジェクトにバインドし、メニュー・モデルを使用して適切なメニュー項目を表示することで宣言的に作成されます。11.2項「動的なナビゲーション・メニューの使用」を参照してください。
表のデータ項目の表示: サービス・リクエストのリストは、コレクションにバインドされたUI表コンポーネントによって書式設定されます。データ・コントロール・パレットを使用して、データ・バインドされたコンポーネントを簡単にページにドロップできます。7.2項「基本表の作成」を参照してください。
パラメータ値の引渡しによるページの表示: ユーザーは、未解決リクエストのリストからサービス・リクエストを選択し、編集ページでその詳細を編集できます。commandLinkは、詳細ページに移動する場合と、詳細ページのデータ表示のためにフォーム作成メソッドにパラメータを送信する場合に使用されます。10.4項「コマンド・コンポーネントを使用したパラメータ値の設定」を参照してください。
フォーム作成のためのパラメータ付きメソッドの使用: ユーザーは、サービスのfinderメソッドを使用して作成される参照フォームをドリルダウンできます。すべてのサービス・リクエストを戻すメソッドとは異なり、このメソッドは、前のページで渡された特定のサービス・リクエストのみを表示します。10.6項「パラメータを取得するメソッドを使用したフォームまたは表の作成」を参照してください。
マスター/ディテール情報の表示: ユーザーは、1つのフォーム内で単一のサービス・リクエストのサービス履歴を参照できます。入力フォームは、データ・コントロール・パレットを使用して作成できます。8.3項「表およびフォームを使用したマスター/ディテール・オブジェクトの表示」を参照してください。
新規サービス・リクエストを作成するには、「New Service Request」タブを選択します。
この操作により、サービス・リクエストを作成するための2ステップのプロセス・トレインにおける最初のページが表示されます。図2-8は、その最初のページを示しています。
ユーザーが必須情報を入力しなかった場合、ページに表示される入力フィールドで検証エラーが発生します。アプリケーションによる検証エラーの処理方法を参照するには、新規サービス・リクエストの問題の説明を入力せずに「Logout」メニュー項目をクリックします。
図2-9は、問題の説明が入力されていないときにサービス・リクエスト作成ページで発生する検証エラーを示しています。問題の説明フィールドの下にエラー・メッセージが表示され、ユーザーに説明の入力を促します。
問題の説明を入力せずに「Continue」ボタンをクリックすると、もう1つの形式の検証エラー処理を参照できます。
図2-10は、問題の説明が入力されない場合にダイアログ内に表示される検証エラーを示しています。
プロセス・トレインの次のページに進むには、問題の説明フィールドに何かテキストを入力してから、ドロップダウン・メニューの「Confirm」を選択するか、「Continue」ボタンをクリックします。
次の手順では、リクエストを送信する前に、入力した情報が正しいかどうかを確認します。図2-11は、最後のページを示しています。ページ最上部のプログレス・バーにより、「Confirm」がこの2ページにわたるサービス・リクエスト作成手順の最後のステップであることがわかります。
「Submit Request」ボタンをクリックすると、新規サービス・リクエストがデータベースに入力されます。新規エントリの作成後に、確認ページが表示されます。このページには、新規作成リクエストに割り当てられたサービス・リクエストIDが表示されます。
マネージャ・ロールとしてアプリケーション操作を続けるため、「Logout」メニュー項目をクリックしてログイン・ページに戻ります。
実装の詳細の参照先
このガイドには、この項の次の主要機能に関する説明が含まれます。
新規レコードの作成: ユーザーは、データをデータソースにコミットするフォームを使用して新規サービス・リクエストを作成します。JDeveloperでは、レコード作成フォームをドロップする方法により、サービスにデフォルトのコンストラクタ・メソッドを簡単に作成できます。別の方法として、サービスでカスタム・メソッドを使用することもできます。10.7項「新規レコード用入力フォームの作成」を参照してください。
複数ページ・プロセス: ADF FacesコンポーネントのprocessTrainおよびprocessChoiceBarにより、ユーザーに新規サービス・リクエスト作成の進行プロセスを示すことができます。11.5項「複数ページ・プロセスの作成」を参照してください。
ページでの検証エラーの表示: ADFアプリケーションでデータ入力検証を処理するには、複数の方法があります。この場合、ADF Modelレイヤーにより提供される検証ルールを使用できます。12.3項「検証の追加」を参照してください。
コマンド・ボタンの使用によるページ・ナビゲーションの処理: ユーザーが「Cancel」または「Submit」ボタンを選択すると、アプリケーションに適切なページが表示されます。ボタンのクリック後に表示されるページは、定義済の結果が設定されたナビゲーション・ルールにより決定されます。9.1項「ページ・ナビゲーションの概要」を参照してください。
マネージャのログイン情報を次のように入力します。
ユーザー名: sking
パスワード: welcome
Webポータル・ホームページに移動するには、「Sign On」ボタンをクリックします。
「Start」ボタンをクリックします。
この操作により、マネージャの未解決のサービス・リクエストのリストが表示されます。リスト・ページには、4つのメニュー・タブが表示されます（選択された「My Service Requests」タブのサブタブが表示されます）。
リクエストの説明を参照するには、希望するリクエストの行にあるラジオ・ボタンを選択し、「View」をクリックします。
図2-12は、未解決のサービス・リクエストを示しています。マネージャとしてログインすると、ページに「Edit」ボタンと「Delete Service History Record」ボタンが表示されます。これら2つの操作は、ロールに基づいており、マネージャのみが使用できます。
現在のサービス・リクエストを編集するには、「Edit」をクリックします。
図2-13は、サービス・リクエストの詳細編集ページを示しています。技術者に表示されるページとは異なり、マネージャは、このページでステータスと割当て済技術者を変更できます。
割り当てる別の技術者を検索するには、割当て済技術者の名前の横にあるアイコンをクリックします。
図2-14は、マネージャがスタッフ・メンバー（マネージャと技術者）を検索できる問合せ条件指定検索ページを示しています。このタイプの検索では、%記号や*記号などのワイルド・カード文字を使用できます。
このサービス・リクエストに別のスタッフ・メンバーを割り当てるには、適切なスタッフ名の横にある選択ボタンを選択します。
選択したスタッフ・メンバーで未解決のサービス・リクエストを更新するには、「Select」ボタンをクリックします。
実装の詳細の参照先
このガイドには、この項の次の主要機能に関する説明が含まれます。
データ・バインドされたドロップダウン・リスト: ADF FacesコンポーネントのselectOneChoiceにより、ユーザーは、サービス・リクエストのステータスを変更するか、検索対象のサービス・リクエストのタイプを選択することができます。11.7項「データ・バインドされたドロップダウン・リストの作成」を参照してください。
レコードの検索: ユーザーは、Query-By-Example（QBE）検索フォームを使用して既存のサービス・リクエストを検索できます。このタイプの問合せの場合、ユーザーは、オブジェクトの既知の属性に基づいてフォームに条件を入力します。ワイルド・カード検索もサポートされます。10.8項「検索ページの作成」を参照してください。
ポップアップ・ダイアログの使用: 必要に応じて、ユーザーが情報をページにポストバックできるような個別のダイアログに情報を表示できます。検索ウィンドウでは、ポップアップ・ダイアログが使用されます（検索機能はページに表示されません）。12.7項「エラー・メッセージの表示」および11.3項「ポップアップ・ダイアログの使用」を参照してください。
部分ページ・レンダリングの使用: ユーザーが懐中電灯アイコン（objectImageコンポーネント付きのcommandLinkコンポーネント）をクリックすると、検索および名前選択を実行できるポップアップ・ダイアログが表示されます。名前が選択されると、ポップアップ・ダイアログは閉じ、選択された名前で「Assigned to」表示専用フィールドがリフレッシュされます（ただし、編集ページの他の部分はリフレッシュされません）。11.4項「部分ページ・レンダリングの有効化」を参照してください。
情報を格納するためのマネージドBeanの使用: 通常、ページでは、正しい情報を表示するために他のページからの情報を必要とします。この情報をページに直接設定する、つまり、本質的に情報をハードコードするかわりに、マネージドBeanに格納できます。たとえば、マネージドBeanを使用すると、SREditページを表示したページをアプリケーションで保存しておき、「Cancel」操作が発生したときに移動するページをその情報を使用して決定できます。10.2項「マネージドBeanを使用した情報の格納」を参照してください。
ページ間でのパラメータの引渡し: commandLinkコンポーネントは、SREditページに移動する場合と、SREditページにデータを表示するフォームを作成するためのfindServiceRequestById(Integer)メソッドに必要なパラメータを設定する場合の両方に使用できます。ADF FacesのsetActionListenerコンポーネントを使用して、パラメータを設定できます。10.4項「コマンド・コンポーネントを使用したパラメータ値の設定」を参照してください。
マネージャ専用ページにアクセスするには、「Management」タブを選択します。
この操作により、ADF Facesのマスター/ディテール・ツリー表コンポーネントにスタッフ・メンバーとそのサービス・リクエストが表示されます。図2-15は、技術者ノードが展開されたツリー表を示しています。
ツリー表の各子ノードは、詳細なサービス・リクエスト・レポートにリンクしています。子ノードのリンクDefroster is not working properlyをクリックすると、次のように詳細が表示されます。
各スタッフ名は、そのスタッフ・メンバーの割当て済スキルの詳細にリンクしています。スタッフ名のリンクAlexander Hunoldをクリックすると、次のように割当て済スキルのリストが表示されます。
スキル割当てページにアクセスするには、「Technician Skills」サブタブを選択します。
この操作により、スタッフ選択ドロップダウン・リストとADF Facesのシャトル・コンポーネントが表示されます。図2-16は、選択されたスタッフ・メンバーのスキルが移入されたシャトル・コンポーネントを示しています。
付属の「Move」、「Move All」、「Remove」または「Remove All」リンクを使用して、2つのリスト間で項目を交互に移動できます。マネージャは、変更をコミットする前に「Assigned Skills」リストに複数の変更を加えることができます。「Save skill changes」ボタンがクリックされるまで、リスト内の変更はコミットされません。
技術者ロールとしてアプリケーション操作を続けるため、「Logout」メニュー項目をクリックしてログイン・ページに戻ります。
実装の詳細の参照先
このガイドには、この項の次の主要機能に関する説明が含まれます。
シャトル・コントロールの作成: マネージャは、ADF FacesコンポーネントのselectManyShuttleを使用して、技術者に製品スキルを割り当てることができます。このコンポーネントでは、2つのリスト・ボックスと複数のボタンがレンダリングされます。各ボタンを使用すると、一方の（使用可能項目の）リスト・ボックスから複数の項目を選択して、他方の（選択済項目の）リスト・ボックスに移動できます（逆方向の移動も可能です）。11.8項「データ・バインドされたシャトルの作成」を参照してください。
ロール・ベースの認可: リソースとユーザーに対して認可ポリシーを設定できます。たとえば、一部のユーザー・グループにのみ、特定のデータの参照、作成、変更や、特定のメソッドの起動を許可できます。または、ユーザーの所属するグループに基づいて、コンポーネントのレンダリングを抑止することも可能です。18.7項「プログラムによる認可の実装」を参照してください。
技術者のログイン情報を次のように入力します。
ユーザー名: ahunold
パスワード: welcome
Webポータル・ホームページに移動するには、「Sign On」ボタンをクリックします。
「Start」ボタンをクリックします。
この操作により、技術者の未解決のサービス・リクエストのリストが表示されます。リスト・ページには、3つのタブが表示されます（選択された「My Service Requests」タブのサブタブが表示されます）。
リクエストを参照するには、希望するリクエストの行にあるラジオ・ボタンを選択し、「View」をクリックします。
技術者は、表示されたページを使用して、自分の入力情報でサービス・リクエストを更新できます。現在のサービス・リクエストにドキュメントを添付するには、「Upload a document」をクリックします。
図2-17は、ファイル・アップロード・ウィンドウを示しています。（SRDemoアプリケーションでは現在、アップロードされたドキュメントの内容を表示することはできません。）
実装の詳細の参照先
ファイルのアップロード: サーブレット、JSP、JSF 1.1.xなどの標準のJ2EEテクノロジでは、ファイルのアップロードは直接サポートされません。ただし、ADF Facesフレームワークでは、inputFileコンポーネントを介してコンポーネント・レベルでファイル・アップロードのサポートが統合されています。11.6項「ファイル・アップロード機能の提供」を参照してください。
アプリケーションのルック・アンド・フィールの変更: スキンを使用することで、アプリケーション内のADF Facesコンポーネントの外観をグローバルに変更できます。スキンは、アプリケーション全体に対して1つの場所に設定するだけでよいグローバル・スタイル・シートです。コンポーネントごとにスタイルを設定したり、ページごとにスタイルシートを挿入することなく、アプリケーション全体に対して1つのスキンを作成できます。14.3項「スキンの使用によるルック・アンド・フィールの変更」を参照してください。
ロケール固有UIの自動翻訳: ADF Facesコンポーネントでは、自動翻訳機能が提供されます。コンポーネントのスキン（このスキンにより、ルック・アンド・フィール以外にコンポーネント内のテキストも決定される）で使用されるリソース・バンドルは、28の言語に翻訳されます。たとえば、ブラウザでドイツ語を使用するよう設定している場合、コンポーネント内に含まれる任意のテキストは自動的にドイツ語で表示されます。14.4項「アプリケーションの国際化」を参照してください。
