65 WEMフレームワークでのアプリケーションの手動登録

アプリケーションを手動で登録するには、Adminインタフェースを使用してアプリケーションのアセットを作成し、アセットの各ビューにアセットを作成して、ビュー・アセットをアプリケーション・アセットに関連付ける必要があります。登録アセット・タイプFW_ApplicationおよびFW_ViewがAdminSite有効化されます。

WEMフレームワークでのアプリケーションの手動登録の詳細は、次の項を参照してください。

65.1 WEMフレームワークでのアプリケーションの登録

この項では、Articlesサンプル・アプリケーション(「Articlesサンプル・アプリケーションでの作業」を参照)のコードを使用して登録プロセスについて説明します。Articlesには、iframeタイプの単一ビューが含まれます。JavaScriptおよびHTMLのビューにも同じ手順が適用されます。

アプリケーションおよびビューを手動で登録するには::

アプリケーションを表すアイコンを作成または取得します。(アイコンは、アプリケーション・バーに表示されます。)

Articlesサンプル・アプリケーションは、次の場所にあるarticles.pngイメージ・ファイルを使用します: /sample app/articles/src/main/webapp/images/
アプリケーションのレイアウト(つまり各ビュー)をHTMLで指定するファイルを作成し、ビューでレンダリングされるコンテンツを保持するためのプレースホルダ・エレメントを作成します。図59-4 に、アプリケーションとビューの関係を示します。

たとえば、Articlesサンプル・アプリケーションのlayout.jspには次の行が含まれます。
```
<div id="articles" style="float:left;height:100%;width:100%"
  class="wemholder"></div>
```
ビューのコンテンツは、アプリケーションが表示される際にプレースホルダ・エレメント内にレンダリングされます(layout.appがアプリケーションのレイアウトをレンダリングし、home.appがビューをレンダリングします)。

注意:
レイアウト・ファイルの作成時に、プレースホルダ・エレメントに一意のIDを指定します。ビュー・アセットを作成する際には、同じIDを親ノード属性に指定します。プレースホルダ・エレメントにclass="wemholder"を使用します。
ビューおよびアプリケーションを登録します。
1. 一般管理者としてAdminインタフェースにログインし、AdminSiteに移動して「管理」ノードを展開します。このノードでは、FW_ViewおよびFW_Applicationアセット・タイプが有効になります。
  
  (ここでは、ビューおよびアプリケーションのアセットを同一セッション内で作成することを想定しています。この場合、「履歴」タブに両方のアセットが一覧表示されます。アプリケーション・アセットの作成時に、「履歴」タブからビュー・アセットを選択し、アプリケーション・アセットに関連付けます。「履歴」タブの情報は一時的なものであるため、ユーザーのセッションの後にクリアされます。アクティブ・リスト・タブでは、アセットを永続的に配置できます。手順の詳細は、『Oracle WebCenter Sitesの管理』を参照してください。)
2. 次のように、FW_Viewアセット・タイプのインスタンスを作成します。
  
  「新規」をクリックして新規FW_Viewを選択し、図65-1に示すように属性を設定します。(図65-1には、Articlesサンプル・アプリケーションのビュー・アセットの属性値が表示されています。)
  
  図65-1 ビュー・アセットの属性値
  
  「図65-1 ビュー・アセットの属性値」の説明
  
  名前: このビュー・アセットの短くてわかりやすい名前を入力します。
  
  親ノード: (「WEMフレームワークでのアプリケーションの登録」の手順2で定義した)プレースホルダ・エレメントのidを入力します。プレースホルダ・エレメントには、ビューでレンダリングされたコンテンツが保持されます。
  
  ビュー・タイプ: 次のいずれかのオプションを選択して、ビューのコンテンツをプレースホルダでレンダリングする方法を指定します。
  - Iframe: プレースホルダ・エレメントにiframeのビューをレンダリングします。
  - IncludeHTML: プレースホルダ・エレメントにHTMLをレンダリングします。
  - IncludeJavaScript: プレースホルダ・エレメントにJavaScriptをレンダリングします。
  ソースURL: ビューのコンテンツを提供するURLを入力します。たとえば、Articlesサンプル・アプリケーションの「ソースURL」の値は次のようになります: http://localhost:9080/articles-1.0/home.app
3. 次のように、FW_Applicationアセット・タイプのインスタンスを作成します。
  
  「新規」をクリックして新規FW_Applicationを選択し、図65-2に示すように属性を設定します。(図65-2には、Articlesサンプル・アプリケーションのアプリケーション・アセットの属性値が表示されています。)
  
  図65-2 アプリケーション・アセットの属性値
  
  「図65-2 アプリケーション・アセットの属性値」の説明
  
  名前: このアプリケーション・アセットの短くてわかりやすい名前を入力します。
  
  ツールチップ: ユーザーがアプリケーションのアイコンにマウスを重ねたときにアイコン上に表示されるテキストを入力します。
  
  アイコンURL: アプリケーションを表すアイコンのURLを入力します。アイコンは、ログイン・ページおよびWEMインタフェースの上部に表示されます。たとえば、Articlesサンプル・アプリケーションの「アイコンURL」の値は次のようになります: http://localhost:9080/articles-1.0/images/articles.png
  
  ホバー・アイコンのURL: ユーザーがアイコンにマウスを重ねたときにそのアプリケーションを表すアイコンのURLを入力します。
  
  クリック・アイコンのURL: ユーザーがアイコンをクリックしたときにそのアプリケーションを表すアイコンのURLを入力します。
  
  アクティブ・アイコンのURL: アプリケーションが使用中のときにそのアプリケーションを表すアイコンのURLを入力します。
  
  レイアウト・タイプ: LayoutRenderer(デフォルトかつ唯一の値)。レイアウト・タイプは、(次のレイアウトURL属性で指定された)アプリケーションのレイアウト・ページを使用してアプリケーションのビューをレンダリングする際にUIコンテナで使用されます。
  
  レイアウトURL: アプリケーションのレイアウトを表示するページのURLを入力します。レイアウト・ページには、ビューを配置するためのHTMLプレースホルダ・エレメント(divなどの)のみが含まれます。
  
  たとえば、Articlesサンプル・アプリケーションのレイアウトURL値は次のようになります: "http://localhost:9080/articles-1.0/layout.app"(Spring MVCフレームワークで指定した".../layout.jsp"ではありません)。
  
  関連: 関連付けられたFW_View: ビュー: 「WEMフレームワークでのアプリケーションの登録」の手順3で作成したビュー・アセットを選択します(「履歴」タブをクリックしてビュー・アセットを選択し、「選択したアイテムの追加」をクリックします)。

65.2 リファレンス: 登録アセット・タイプ

この項には次のトピックが含まれます:

65.2.1 FW_Viewアセット・タイプ

このアセット・タイプはアプリケーションのビューを登録する際に使用します。各ビューに対してFW_Viewのインスタンスを作成します。Adminインタフェースに表示されるFW_Viewの属性は、表65-1およびOracle WebCenter Sites REST API Beanリファレンスを参照してください。このアセット・タイプは、AdminSiteという名前のサイトで有効になります。

表65-1 FW_View アセット・タイプの属性

属性: WebCenter Sitesインタフェース	属性: REST API	説明
名前	`name`	このビュー・アセットの短くてわかりやすい名前。
説明	`description`	このビュー・アセットの説明。
親ノード	`parentnode`	アプリケーションのレイアウト・ファイルにおけるプレースホルダ・エレメントのID。プレースホルダ・エレメントには、ビューでレンダリングされるコンテンツが保持されます。レイアウト・ファイルには、ビューを配置するためのHTMLプレースホルダ・エレメント(`div`など)のみが含まれます。
ビュー・タイプ	`viewtype`	ビューをレンダリングする方法。次のビュー・タイプを使用できます。 `Iframe`: プレースホルダ・エレメントにiframeのビューをレンダリングします。 `IncludeHTML`: プレースホルダ・エレメントにHTMLをレンダリングします。 `IncludeJavaScript`: プレースホルダ・エレメントにJavaScriptをレンダリングします。
ソースURL	`sourceurl`	ビューのコンテンツを提供するURL。
JavaScript	`javascriptcontent`	ビュー・タイプが`IncludeJavaScript`で、「ソースURL」を指定しない場合は必須です。ビュー・タイプで`IncludeJavaScript`を指定した場合、この属性で指定した内容がスクリプト・タグに組み込まれます。ビュー・タイプで`IncludeJavaScript`を指定した場合は、`「ソースURL」`を指定するか、`「JavaScript」`属性でコードを指定する必要があります。
コンテンツ	`includecontent`	ビュー・タイプが`IncludeHTML`で、`「ソースURL」`を指定しない場合は必須です。ビュー・タイプで`IncludeHTML`を指定した場合、この属性で指定した内容がプレースホルダ・エレメント・タグに組み込まれます。ビュー・タイプで`IncludeHTML`を指定した場合は、`「ソースURL」`を指定するか、`「コンテンツ」`属性でコードを指定する必要があります。

65.2.2 FW_Applicationアセット・タイプ

このアセット・タイプはアプリケーションを登録する際に使用します。アセット・タイプは、AdminSiteで有効になります。Adminインタフェースに表示されるFW_Applicationの属性は、表65-2およびOracle WebCenter Sites REST API Beanリファレンスを参照してください。

表65-2 FW_Applicationアセット・タイプの属性

属性: WebCenter Sitesインタフェース	属性: REST API	説明
名前	`name`	このアプリケーション・アセットの短くてわかりやすい名前。
説明	`description`	このアプリケーション・アセットの説明。
ツールチップ	`tooltip`	ユーザーがアプリケーションのアイコンにマウスを重ねたときにアイコン上に表示されるテキスト。
アイコンURL	`iconurl`	WEMフレームワークでこのアプリケーションを表すアイコンのURL。
ホバー・アイコンのURL	`iconurlhover`	ユーザーがアイコンにマウスを重ねたときにこのアプリケーションを表すアイコンのURL。
クリック・アイコンのURL	`clickiconurl`	ユーザーがアイコンをクリックしたときにこのアプリケーションを表すアイコンのURL。
アクティブ・アイコンのURL	`iconurlactive`	このアプリケーションが使用中のときにアプリケーションを表すアイコンのURL。
レイアウト・タイプ	`layouttype`	レイアウトのタイプ。値は`LayoutRenderer`です。レイアウト・タイプは、(レイアウトURL属性で指定された)アプリケーションのレイアウト・ページを使用してアプリケーションのビューをレンダリングする際に使用されます。
レイアウトURL	`layouturl`	アプリケーションのレイアウトが表示されるページのURL。このページには、ビューを配置するためのHTMLプレースホルダ・エレメント(`div`など)のみが含まれます。
関連: 関連付けられたFW_Application: 拡張	`parentnode`	現在のアプリケーションを拡張する親アプリケーション。
関連: 関連付けられたFW_View: ビュー	`views`	このアプリケーションで使用されるビュー・アセットのリスト。