Oracle JDeveloper 11g製品版を起動するには、以下の手順を実行します。

<JDEV_HOME>\jdeveloper.exeプログラム（たとえば、 c:\oracleFusion\jdeveloper11\jdeveloper.exe） をダブルクリックします。

Oracle JDeveloperは、初期化を開始します。

ロール・ダイアログ表示されたら、「 Default Role」を選択して、「 OK」 をクリックします。

Configure File Type Associationsボックスで、すべてのチェッ ク・ボックスを選択して、「 OK」を押します。

以前のリリースから移行するかどうかのメッセージが表示されたら、「 No」をクリックします。

Tip of the Dayダイアログ・ボックスおよびUpdatesダイアログ・ボックスを閉じます。

次に、Oracle JDeveloperからAntスクリプトを実行して、チュートリアルのデータベース・スキーマを作成します。 最初に、ハードディスク・ドライブの一時的な場所に Infrastructure.zipをダウンロードします。

ファイル・エクスプローラで、「 Infrastructure.zip」ファイルを右クリックし て、「 Winzip」→「 Extract to...」を選択します。

解凍ダイアログで、Infrastructureワークスペースを展開するフォルダ（たとえば、 c:\oracleFusion\tutorial） を入力します。 ファイルは別の場所にも展開できますが、このパスの領域を含む場所には解凍しないようにしてください。

次に、Oracle JDeveloperでビルド・スクリプトを含むワークスペースを開きます。

アプリケーション・ナビゲータで「 Open Application」を選択します。

前の手順でInfrastructure.zipを解凍した場所を参照します。 「 Infrastructure.jws」 を選択して、「 Open」をクリックします。

このワークスペースには、4つのプロジェクトがあります。 プロジェクトとはファイルの論理グループで、Oracle JDeveloperでの作業を保存します。 「 MasterBuildScript」プロジェクトを開きます。

「 Resources」ノードを開き、アプリケーション・ナビゲータの「 build.properties」 をダブルクリックして、Oracle JDeveloperのエディタでファイルを開きます。 このファイルには、Antスクリプトの実行に使用される設定が含まれます。

build.propertiesファイルの次の値を修正し、環境固有の設定をおこないます。下に示されているようにスラッシュを使用 します。

ツールバーの「 Save」アイコンをクリックして、ファイルを保存します。

アプリケーション・ナビゲータで、MasterBuildScriptプロジェクトの「 build.xml」 を右クリックして、「 Run Ant Target」→「 buildAll」を選 択します。

Oracle JDeveloperのAnt Logウィンドウが表示され、データベース・システム・パスワードを要求する別のウィンドウが表示されます。 パスワードを入力して、「 Continue」 をクリックします。 このウィンドウが表示されずにAntログが"setProperties:"で停止している場合は、Oracle JDeveloperを最小化します。ウィンドウはおそらくOracle JDeveloperの後ろに隠れています。

無害のエラーを含め、いくつかのメッセージが表示されます。 次のテキストが表示された場合、"FOD"スキーマが正しくインストールされています。

buildAll:

BUILD SUCCESSFUL
Total time: n minutes nnseconds

最初に、アプリケーション・ナビゲータで「 adfbc_model.entities」 を開き、表ベースのエンティティのOrderItems、Orders、Personsなどを確認します。 「 OrderItems」 をダブルクリックして、エディタで開きます。

エディタで「 Attributes」ノードをクリックして、 Order_Items表のすべての列がエンティティに追加されていることを確認します。 ここで、検証機能などの属性の修正、ほかの表からの属性の追加、およびこのダイアログからの非永続（一時）属性の追加を実行できます。

「 Quantity」属性をダブルクリックして、属性エディタを開きます。

Edit Attributeダイアログで、「 Validation」ノードをクリックします。 「 New...」をクリックして、Quantity属性の新しい検証ルールを作成します（スキーマ・ベースの検証ルー ルはすでに追加されています）。

Rule Typeドロップダウンから「 Range」を選択します。
Operatorとして「 Between」を選択して、Minimum Valueに 1、 Maximum Valueに 10を入力します。

「 Failure Handling」タブをクリックします。

検証の失敗時に処理が停止されるように「 Error」ラジオ・ボタンを選択します。 Message Textウィンドウで、虫メガネ・アイコンをクリックして、リソース・バンドルからテキストを選択します。

Select Text Resourceダイアログで、 Please enter a quantity between 1 and 10 を入力します。 Keyとして entities.OrderItems.Quantity.error を 入力します。

説明テキストを入力します。

「 Save and Select」をクリックします。

「 OK」を2回クリックして、OrderItemsエンティティ・エディタに戻ります。 このビジネス・コンポーネント・エンティティを使用して新しい数量が入力されるたびに、この検証ルールが適用されます。 また、UIを作成するクライアントのタイプに関係なく、国際化可能なエラー・メッセージの文字列を使用して、ユーザーにエラーを通知します。 実際のアプリケーションでは、さらに多くの検証ルールを追加してアプリケーションのビジネス・ロジックを作成します。 宣言的な検証ルール（Compare、Length、Rangeなど）ではアプリケーションの検証要件に対応できない場合、Groovyスクリプト、正規 表現、またはJavaメソッドを使用して、エンティティまたは属性の検証ルールを実装することもできます。

一時属性をOrderItemsエンティティに追加して、数量および単価に基づくOrder Itemの合計金額を計算します。

OrderItemsエンティティのAttributesタブで、緑色のプラス記号アイコンをクリックして、エンティティ属性を追加し ます。

New Entity Attributeダイアログで、Nameに LineItemTotalを 入力します。 Typeに Numberを選択します。

「 Persistent」チェック・ボックスの選択を解除します。 式から属性が計算されるので、データベースには保存されません。

Value Typeに「 Expression」を選択します。 「 Edit」 をクリックして、式を作成します。

Edit Expression Editorダイアログで、式として次のGroovyスクリプトを入力します。

((Quantity == null) ? 0 : Quantity) * ((UnitPrice == null) ? 0 : UnitPrice)

「 Always」を選択して、常にこの式を再計算するようにします。
「 Quantity」および「 UnitPrice」を選択領域に移動して、これら の属性名を式で使用できるようにします。

「 OK」をクリックして式エディタを終了すると、再度新しいエンティティ属性を作成できます。

ツールバーの「 Save All」をクリックして作業を保存します。

LineItemTotal属性をOrderItemsViewビュー・オブジェクトに追加しま す。 アプリケーション・ナビゲータで、「 adfbc_model.queries」を展開し、「 OrderItemsView」 をダブルクリックしてエディタで開きます。

エディタで「 Attributes」ノードをクリックして、「 Add from Entity...」をクリックします。

「 LineItemTotal」一時属性を選択して、選択列に 移動します。

「 OK」をクリックします。

アプリケーション・ナビゲータで「 adfbc_model.entities」 を開き、表ベースのエンティティのOrderItems、Orders、Personsなどを確認します。 エンティティ間の関係は関連と呼ばれ、デフォルトで<DetailEntityMasterEntity>FkAssocという名前がつけら れています。

このチュートリアルのシナリオでは、ORDERITEM.PRODUCT_IDとPRODUCTS_BASE.PRODUCT_IDの間に関係があり、こ れは自動的に作成されていません。 ビジネス・コンポーネント・ダイアグラムを使用してこの関係を追加できますが、ここではOracle ADFフレームワークの宣言的機能を使用してタスクを実行します。

「 adfbc_model.entities」を右クリックし て、「 New Association...」を選択します。

Create Associationダイアログで、デフォルトのパッケージ名を受け入れて、Nameに ProductsBaseOrderItemsFkAssocを 入力します。

「 Next」をクリックします。

Select Source Attributeパネルで、「 OrderItems」を開き、「 ProductId」 属性を選択します。 Select Destination Attributeパネルで、「 ProductsBase」 を開き、「 ProductId」属性を選択します。 「 Add」をクリックして、 OrderItemsエンティティおよびProductsBaseエンティティの2つの属性の関連を作成します。

「 Next」を2回クリックし、「 Finish」をクリックす ると関連が作成されます。

「 Save All」をクリックして作業内容を保存します。

ビュー・オブジェクトは、データの"スライス"で、1つ以上のエンティティ・オブジェクト属性の問合せを含みます。 また、SQL問合せに完全に基づくことができます。 ウィザードで生成されたビュー・オブジェクトの場合、エンティティ・オブジェクトごとに1つのビュー・オブジェクトがあり、これはエンティティのすべての 属性を含みます。 実際のアプリケーションでは、これらの属性のサブセットだけを選択したり、1つのエンティティに基づく複数のビュー・オブジェクトを作成したりすることも できます。複数のビュー・オブジェクトを作成した場合、複数の問合せで同じデータにアクセスするようになります。 作成されたビュー・オブジェクトを表示するには、アプリケーション・ナビゲータで「 adfbc_model.queries」 を開きます。

OrderItemsView、OrdersView、PersonsViewなどが表示されており、それらの間のビュー・リンクも表 示されています。 ウィザードによって、1つの外部キー関連に対して1つのビュー・リンクが生成されています。 ここに、前の手順で作成した関連に対するビュー・リンクを追加します。

「 adfbc_model.queries」を右クリックして、「 New View Link...」を選択します。

Create View Linkダイアログで、デフォルトのパッケージ名を受け入れて、名前に ProductsBaseOrderItemsFkLinkを 入力します。

「 Next」をクリックします。

Select Source Attributeパネルで、「 OrderItemsView」を開 き、「 ProductsBaseOrderItemsFkAssoc」を選択します。 Select Destination Attributeパネルで、「 ProductsBaseView」を開き、「 ProductsBaseOrderItemsFkAssoc」 を選択します。 「 Add」をクリックして、関連に基づくビュー・リンクを作成します。

「 Next」を2回クリックし、「 Finish」をクリックす ると関連が作成されます。

ビュー・オブジェクトおよびビュー・リンクは、データの表示方法を定義します。 ビュー・オブジェクトにアクセスするクライアント（Web、モバイル、またはSwing）は、データ・モデルにアクセスしてデータを表示します。 Oracle ADFのデータ・モデルはアプリケーション・モジュールに格納されています。 このため、アプリケーション・モジュールは、サービスのタイプの1つになります。 WebサービスやEJBなどの他のサービスのデータも使用するクライアントが存在することもあるでしょう。 Oracle ADFでは、データ・モデルをテストできるOracle ADF Business Componentテスターが用意されています。

さらにデータ・モデルを定義するには、アプリケーション・ナビゲータで「 adfbc_model.service」 を開き、「 FusionOrderApp」をダブルクリックして、アプリケーション・モジュール・エディタを開きま す。

エディタで「 Data Model」タブを選択します。 データ・モデル・エディタの右側に表示されているProductsBaseView1、ProductImagesView1、 OrderItemsView1などのマスター・オブジェクトを確認します。 高レベルのビュー・オブジェクトには"1"が追加されます。これは、特定のビュー・オブジェクトの最初のインスタンスだからです。 従属ビュー・オブジェクト（ビュー・リンクに基づくオブジェクト）の場合、インスタンス番号が適宜増加します。 たとえば、OrdersView1は、ビュー・リンクによって関連づけられているOrderItemsView2のマスター・オブジェクトです。

前の手順で作成したProductsBaseOrderItemsFkLinkのこのOrderItemsView2インスタンスに新 しいインスタンスを追加します。 エディタの右側の「 OrderItemsView2」を選択します。 エディタの左側で、「 OrderItemsView」を開き、「 ProductsBaseView via ProductsBaseOrderItemsFkLink」を選択します。 New View Instanceフィールドにインスタンス名（この場合、ProductsBaseView2）が表示されます。 これらのインスタンスに任意の名前をつけられることを確認するため、New View Instanceの名前を OrderItemProductDetailに 変更します。

最後に、インスタンスを右側に移動して、データ・モデルに追加します。

これで、Orders、Order Items、およびProduct Detailsへの問合せを自動的にリンクするデータ・モデルが作成および公開されました。

次に、アプリケーションの要件に応じてビュー・オブジェクトをさらにカスタマイズします。 ここでは、個々の顧客専用のOrdersを表示します。顧客がアプリケーションにログインすると、自分の注文しか見られなくなります。

アプリケーション・ナビゲータで、「 adfbc_model.queries」を展開し、「 OrdersView」 をダブルクリックしてビュー・オブジェクト・エディタを開きます。 「 Query」タブを選択し、エディタの右上の鉛 筆アイコンをクリックして、問合せを修正します。

問合せエディタで、WHERE句に以下を入力します。

Orders.CUSTOMER_ID = :custId

「 Bind Variables」ノードをクリックして、custIdバインド変数を定義します。 「 New」をクリックします。 Variableタブで、Nameに custId、 Typeに Numberを指定します。

「 Control Hints」タブを選択して、Label Textに Customer Id と入 力します。 UIコンポーネントにこの変数がバインドされるとラベルが使用されます。

「 OK」をクリックすると、ビュー・オブジェクトのWHERE句をが修正されます。

「 Save All」をクリックして作業内容を保存します。

データ・モデルの変更をテストするには、Oracle ADF Business Componentテスターを実行します。 「 FusionOrderApp」 を右クリックして、「 Run」を選択します。

「 Connect」をクリックして、FOD接続をおこないます。

Business Components Browserで、「 OrdersView1」をダブル クリックします。 バインド変数を作成したので、テスターが値の入力を要求します。 108と入力し、「 OK」 をクリックします。

矢印を使用すると、注文の行を移動します。 OrdersView1の下にネストされている「 OrderItemsOrdersFkLink1」 ビュー・リンクをダブルクリックし、「 OK」をクリックすると、同じバインド変数値を使用します。

作成したリンクの「 ProductsBaseOrderItemsFkLink1」をダブルクリッ クして、現在選択されている注文および注文項目の製品データを表示します。 ProductsBaseViewには多くの属性が含まれるので、ウィンドウおよび列のサイズを調整してデータを表示する必要がある場合があります。

終了したらBusiness Components Browserを閉じます。