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

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

アプリケーションを手動で登録する場合、Adminインタフェースでアプリケーションのアセットを作成し、アセットの各ビューにアセットを作成して、ビュー・アセットをアプリケーション・アセットに関連付けます。登録アセット・タイプFW_ApplicationおよびFW_ViewをAdminSiteで有効化できます。

トピック:

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

Articlesサンプル・アプリケーションおよびそのビューを登録して、アプリケーションおよびそのビューを登録する方法を学習します。

Articlesサンプル・アプリケーションでの作業を参照してください。Articlesには、iframeタイプの単一ビューが含まれます。JavaScriptおよびHTMLのビューにも同じステップが適用されます。

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

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

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

たとえば、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 Fusion Middleware Oracle WebCenter Sitesの管理』を参照してください。)
2. 次のように、FW_Viewアセット・タイプのインスタンスを作成します。
  
  「新規」をクリックして、新規FW_Viewを選択し、属性を設定します。(次の図には、Articlesサンプル・アプリケーションのビュー・アセットの属性値が表示されています。)
  
  図54-1 ビュー・アセットの属性値
  
  「図54-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を選択し、属性を設定します。(次の図には、Articlesサンプル・アプリケーションのアプリケーション・アセットの属性値が表示されています。)
  
  図54-2 アプリケーション・アセットの属性値
  
  「図54-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で作成したビュー・アセットを選択します(「履歴」タブをクリックしてビュー・アセットを選択し、「選択したアイテムの追加」をクリックします)。

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

FW_Viewアセット・タイプでは、アプリケーションのビューを登録できます。そして、FW_Applicationアセット・タイプを使用して、アプリケーションを登録できます。

トピック:

FW_Viewアセット・タイプ

このアセット・タイプはアプリケーションのビューを登録する際に使用します。各ビューに対してFW_Viewのインスタンスを作成します。「管理」インタフェースに表示されるFW_Viewの属性は、次の表に一覧表示されています。このアセット・タイプは、AdminSiteという名前のサイトで有効になります。

表54-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`を指定するか、`コンテンツ`属性でコードを指定する必要があります。

FW_Applicationアセット・タイプ

このアセット・タイプはアプリケーションを登録する際に使用します。アセット・タイプは、AdminSiteで有効になります。「管理」インタフェースに表示されるFW_Applicationの属性は、次の表に一覧表示されています。

表54-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`	このアプリケーションで使用されるビュー・アセットのリスト。