第6部：テンプレートとリージョンの使用

Oracle JDeveloperのIDEを操作し、ファセットを使用して新しいテンプレートを作成します。さらに、そのテンプレートを使用して新しいページを作成 し、ページの断片へ既存のタスク・フロー・ページを変換します。

テンプレートの作成：Create JSF Page Templateダイアログを使用して、新しいページおよび既存のページに適用する新しいテンプレートを作成します。

テンプレートを使用したページの作成：Create JSF JSPダイアログを使用して、新しいページの作成時にテンプレートを選択します。

リージョンからのタスク・フローの起動：タスク・フロー・ノードをドラッグして、ページのmainファセッ トにドロップします。

テンプレートの作成

1. アプリケーション・ナビゲータで「 ViewController 」 プロジェクトを選択し、Create JSF Page Templateダイアログを開きます（「 File」→「 New」 →「 Web Tier」→「 JSF」→「 JSF Page Template」）。
2. ファイル名に OrdersTemplate.jspxと入力します。
3. Facet Definitionsタブを前面に表示して、「 Add 」をクリックします。 nameフィー ルドに mainと入力して、「 OK 」をクリックしま す。
   

   ファセットの定義

   ページ・テンプレートは、ページを作成する場合にユーザーや開発者がコンテンツを追加できるページの領域（ファセット）も定義します。 これらの領域（ファセット）にもデフォルトのコンテンツを格納できます。 たとえば、ページの最上部ですべてのアプリケーション・ページが類似したヘッダー（タイトルつき）を共有する場合、ヘッダーを含むページ・テンプレートを 作成して、ページを構築するほかの開発者がそのページ・テンプレートを使用できるようにします。 ほかの開発者はヘッダー・テンプレートに基づいてページを作成します。 [ 詳細はこちら]

4. コンポーネント・パレットのADF Facesページで、「 Layout 」 パネルを開きます。 「 」 Panel Border Layoutをクリックして、テンプレートにドロップします。
5. 「 」 Panel Headerをクリックし て、 Facet - top領域内のページにドロップします。
6. プロパティ・インスペクタで「 Common 」タブを選択し、 Textプロパティに Acme Incを入力します。
7. Appearanceタブで、 Icon ド ロップダウン・メニューを開いて「 Edit 」を選択します。 ページに挿入するため、イメージに移動して選択します。 「 Yes 」をクリック して、ドキュメント・ルートの下にアイコンを追加します。
   

   テンプレートへのイ メージの追加

   イメージに移動して選択し、イメージをテンプレートに追加できます。 [ 詳細はこちら]

8. 「 Style 」タブ、下の「 Background 」タブの順に選択し、カラー・パレットから色 を 選択して background-colorプロパティを設定します。
9. コンポーネント・パレットで、「 」 Panel Boxをクリックして、境界 線レイアウトの中央領域のビジュアル・エディタで OrdersTemplate.jspxペー ジにドロップします。
10. プロパティ・インスペクタのCommonタブで、 Textプロパティを Order Applicationに設定します。 Styleタブで「 Box 」タブをクリックし、 Paddingを 10 pixelsに設定します。
11. コンポーネント・パレットで、「 Common Components 」 パネルを開きます。 「 」 OutputFormattedをクリッ クして、テンプレートの Facet - bottom領域にドロップします。
12. プロパティ・インスペクタのCommonタブで、 outputFormattedコ ンポーネントの Valueプロパティを <em>Copyright © 2007, Acme Inc. All rights reserved.</em>に設定します。
13. コンポーネント・パレットで、「 」 FacetRefをクリックして、パネル・ボックス内のページにドロップします。
14. Insert FacetRefダイアログで、 nameドロップダウン・リストか ら「 main 」を選択します。 「 OK 」 をクリックします。
15. 「 」 Save allを クリックして作業内容を保存します。
    

    IDE内

    ページ・テンプレートの作成ステップが完了すると、テンプレートはビジュアル・エディタで次のように表示されます。 [ 詳細はこちら]

テンプレートを使用したページの作成

1. アプリケーション・ナビゲータで「 Web Content 」→「 Page Flows 」を開き、「 adfc-config 」 をダブルクリックしてデフォルトのページ・フロー・ダイアグラムを開きます。
   

   adfc-config.xml

   adfc-config.xmlファイルは、 Web Applicationテンプレートに基づいてアプリケーションを作成した場合にOracle JDeveloperが提供するデフォルトのページ・フロー・ダイアグラムです。 adfc-config.xmlは、アン バウンド・タスク・フローのデフォルトのファイル名です。 このダイアグラムで、既存の orders-flowタスク・フロー の一部ではないテンプレートに基づいて新しいページを作成できます。 [ 詳細はこちら]

2. コンポーネント・パレットのADF Task FlowページのComponentsパネルで、「 」 Viewをクリックし、ダイアグラムをクリックしてページ・アイコンをダイアグラムに追加します。 デフォルトのページ名を orderMainに変更します。
3. ページ・アイコンをダブルクリックして、Create JSF Pageダイアログを開きます。
4. ファイル名を受け入れて、 Use Page Templateドロップダウン・リ ストから「 OrdersTemplate 」を選択します。 「 OK 」をクリックします。
   

   IDE内

   OrdersTemplateページ・テンプレートに基づいて orderMain.jspxペー ジを作成すると、ビジュアル・エディタで次のように表示されます。 [ 詳細はこちら]

リージョンからのタスク・フローの起動

1. エディタ・ウィンドウで、「 orders-flow.xml」タブをクリックして、ダイアグラムを前面 に表示します。
2. ダイアグラムで、「 browseOrders 」ページ・アイコン と「 editOrders 」ページ・アイコンを選択します。 右クリックして「 Convert to Task Flow With Page Fragments 」を 選択します。 両方のページが一覧表示されていることを確認し、「 OK 」をク リックします。
3. 「 Yes 」をクリックして、変更を確定します。
   

   リージョンおよびタ スク・フロー

   orders-flowタスク・フローは、 Create with page fragmentsオプションの選択を解除して作成されました。 つまり、Create ADF Task Flowウィザードからページの断片の代わりにページがデフォルトで作成されました。 ただし、ページ内のリージョンとしてタスク・フローを使用するには、特別な要件があります。 たとえば、ページではなくページの断片でタスク・フローを構成して、タスク・フローをバウンド・タスク・フローにする必要があります。 このため、タスク・フローをページにドロップする前に、タスク・フロー・エディタ・コンテキスト・メニューの Convert to Task Flow with Page Fragmentsコマンドを使用して、タスク・フローのページをページの断片に変換する 必要があります。 [ 詳細はこちら]

4. 「 」 Save allを クリックして作業内容を保存します。
5. エディタ・ウィンドウの「 orderMain.jspx 」タブをク リックして、ページを前面に表示します。
6. アプリケーション・ナビゲータで「 Page Flows 」→「 orders-flow 」ノードを選択し、 orderMainペー ジの mainファセットにドロップします。
7. Createコンテキスト・メニューから「 Region 」を選択します。
8. 「 adfc-config .xml 」 タブをクリックして、ダイアグラムを前面に表示します。
9. 「 orderMain 」ページ・アイコンを右クリックして、「 Run 」を選択します。
   

   IDE内

   ビジュアル・エディタで、 orderMain.jspxが次のように表示されます。 [ 詳細はこちら]

次のステップ

 

Copyright © 1997, 2008, Oracle. All rights reserved.