29 コンテンツ・プレゼンタ表示テンプレートの作成

コンテンツ・プレゼンタ・タスク・フローによって、権限のあるユーザーはIT部門やソフトウェア開発者のサポートなしで、Content Serverからコンテンツを取得し、WebCenter Portalアプリケーションでリアルタイムでそれを表示できます。たとえば、最近のプレス・リリースのリストを表示して、ユーザーがそれらをブラウズし、クリックして読めるようにします。ポータルには、イメージ(写真や図表など)やテキスト・コンテンツを配置または追加できます。

注意: Content Presenterでは、Content Serverベースのコンテンツのみを使用できます。他のリポジトリ接続タイプは使用できません。

Content Presenterは、選択された表示テンプレートを使用してコンテンツをレンダリングします。この章では、コンテンツ・プレゼンタ表示テンプレートの作成に主な焦点を当てます。特定のコンテンツ・レンダリング要件に合せて、または独自のカスタム・コンテンツ・プロパティに対応する、コンテンツ・プレゼンタ・テンプレートを作成できます。

この章の内容は、次のとおりです。

• 第29.1項「アプリケーションへのコンテンツ・プレゼンタの追加」

• 第29.2項「コンテンツ・プレゼンタ表示テンプレートについて」

• 第29.3項「デフォルト表示テンプレートの使用」

• 第29.4項「コンテンツ・プレゼンタ表示テンプレートの作成」

• 第29.5項「Frameworkアプリケーションにおけるコンテンツ・プレゼンタ表示テンプレートの使用」

• 第29.6項「実行時の処理」

• 第29.7項「コンテンツ・プレゼンタ表示テンプレートのパフォーマンスの考慮点」

29.1 アプリケーションへのコンテンツ・プレゼンタの追加

コンテンツ・プレゼンタ・タスク・フローは、設計時または実行時に追加できます。設計時に(JDevを使用して)コンテンツ・プレゼンタを追加する方法の詳細は、第31章「ポータル・ページへのコンテンツ・タスク・フローおよびドキュメント・コンポーネントの追加」を参照してください。実行時にコンテンツ・プレゼンタを追加および使用する方法の詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのコンテンツ・プレゼンタを使用したコンテンツの公開に関する項を参照してください。

29.2 コンテンツ・プレゼンタ表示テンプレートについて

コンテンツ・プレゼンタ表示テンプレートは、コンテンツ・プレゼンタがポータル・ページ上でコンテンツ・アイテムをレンダリングする方法を定義するJSFFファイル(JSFページ・フラグメント)です。WebCenterにはデフォルトの表示テンプレートがいくつか装備されており、これらを使用してすぐに作業を開始できるほか、独自のテンプレートを作成できます。

ヒント: サンプル表示テンプレートは$ORACLE_HOME/jdeveloper/webcenter/samples/contentpresenterに格納されています。これらのサンプル・ファイルは、Oracle JDeveloperに対するWebCenter Portalの拡張機能の一部としてインストールされています。

表示テンプレートでは充実したADFコンポーネントをすべて使用できるので、コンテンツを表示するために堅牢で人目を引くテンプレートをすばやく簡単に作成できます。ただし、テンプレートでこれらのコンポーネントを使用する必要はありません。

コンテンツ・プレゼンタ表示テンプレートでは、単一コンテンツ・アイテム、複数コンテンツ・アイテムまたは双方の組合せを処理できます。たとえば、複数コンテンツ・アイテムのテンプレートで各アイテムのタブをレンダリングしてから、単一アイテムのテンプレートをコールして選択アイテムの詳細をレンダリングできます。

各コンテンツ・アイテムは、コンテンツ・サーバーのリポジトリで定義された特定コンテンツ・タイプに関連付けらます。コンテンツ・タイプはコンテンツ・アイテムのプロパティを定義します。コンテンツ・タイプはコンテンツ・サーバーのプロファイル定義とSite Studioのリージョン定義にマップできます。タイプはコンテンツ・サーバー上で作成されます。コンテンツ・プレゼンタ表示テンプレートの開発者は、選択されたコンテンツ・アイテムのページ上での表示方法を定義できるように、関連付けられたコンテンツ・タイプに定義されたプロパティの名前を知っておくことが必要です。

ヒント: Content Serverで定義されている既存コンテンツ・タイプのプロパティを判断する1つの方法は、WebCenter Portal: Spacesの「コンテンツ・プレゼンタ構成」ダイアログを使用する方法です。この方法の詳細は、第29.4.5項「コンテンツ・タイプのプロパティ名の発見」を参照してください。

実行時に権限のあるエンド・ユーザーは、「コンテンツ・プレゼンタ構成」ダイアログで表示テンプレートを選択できます。

29.3 デフォルト表示テンプレートの使用

WebCenter Portalには、デフォルトのコンテンツ・プレゼンタ表示テンプレートがいくつか装備されています。こうした事前に構築されているテンプレートは、単一コンテンツ・アイテムと複数コンテンツ・アイテムを表示するためのオプションを提供します。

たとえば、デフォルトのドキュメント詳細ビュー・テンプレートは、単一のコンテンツ・アイテムについて、作成日、変更日、作成ユーザー名、変更ユーザー名、パスおよびコメントといった詳細情報を表示します。図29-0は、実行時にこのテンプレートで表示されるコンテンツ・アイテムを示しています。

図29-1 デフォルトのドキュメント詳細ビュー表示テンプレート

「図29-1 デフォルトのドキュメント詳細ビュー表示テンプレート」の説明

複数コンテンツ・アイテムの表示には、複数のコンテンツ・アイテムをアコーディオン形式で表示するアコーディオン・ビューを始め、いくつかのオプションが提供されています。この形式では、図29-2に示されているように、各アイテムを展開してその詳細を表示できます。

図29-2 アコーディオン・ビュー表示テンプレート

「図29-2 アコーディオン・ビュー表示テンプレート」の説明

デフォルトの表示テンプレートの全リストは、第31.7.1項「コンテンツ・プレゼンタのタスク・フローのパラメータと即時利用可能な表示テンプレート」を参照してください。

ヒント: コンテンツ・プレゼンタ表示テンプレートを作成する場合、デフォルト・テンプレートの1つをコピーして変更することをお薦めします。

29.4 コンテンツ・プレゼンタ表示テンプレートの作成

デフォルトの表示テンプレート(第29.3項「デフォルト表示テンプレートの使用」を参照)がニーズを満たさない場合、カスタムのコンテンツ・プレゼンタ・テンプレートを定義できます。

この項の内容は、次のとおりです。

• 第29.4.1項「概要」

• 第29.4.2項「単一アイテムの表示テンプレートの定義」

• 第29.4.3項「複数アイテムの表示テンプレートの定義」

• 第29.4.4項「EL式を使用したコンテンツ・アイテム情報の取得」

• 第29.4.5項「コンテンツ・タイプのプロパティ名の発見」

29.4.1 概要

コンテンツ・プレゼンタ表示テンプレートの定義方法は、ニーズに応じて異なります。一般的には、コンテンツの特定単一アイテムについて表示テンプレートを定義してから、単一アイテムの表示テンプレートへのコールを含む複数コンテンツ・アイテムの表示テンプレートを定義します。

テンプレート定義には、次のように他の表示テンプレートへのコールを含めることができます。

• 単一コンテンツ・アイテムの表示テンプレートは、別の単一コンテンツ・アイテムの表示テンプレートをコールできます。

• 複数コンテンツ・アイテムの表示テンプレートは、単一コンテンツ・アイテムの表示テンプレートをコールできます(次の例を参照)。

• 複数コンテンツ・アイテムの表示テンプレートは、別の複数コンテンツ・アイテムの表示テンプレートをコールできます。

コンテンツ・プレゼンタ表示テンプレートを作成する際の基本的なタスクは、次のとおりです。

• 単一アイテムと複数アイテムのいずれの表示テンプレートを作成するかを決定します。第29.4.2項「単一アイテムの表示テンプレートの定義」と第29.4.3項「複数アイテムの表示テンプレートの定義」を参照してください。

• コンテンツ・アイテムによってどのような情報を表示するかを決定します。WebCenter Portalは、この情報を取得および表示するためにデザインされた一連のEL式を提供しています。付録G「式言語式」と第29.4.4項「EL式を使用したコンテンツ・アイテム情報の取得」を参照してください。

• テンプレートのルック・アンド・フィールをデザインします。表示テンプレートでは、標準JSFF構造に加え、ADFコンポーネントを使用できます。『Oracle Fusion Middleware Oracle Application Development Framework Webユーザー・インタフェース開発者ガイド』を参照してください。

• ポータル・リソースとしてテンプレートをエクスポートします。第29.5.1項「ポータル・リソースとしてのコンテンツ・プレゼンタ表示テンプレートのエクスポート」を参照してください。

29.4.2 単一アイテムの表示テンプレートの定義

コンテンツ・プレゼンタ表示テンプレートを作成する単一コンテンツ・アイテムの例を次に示します。

• ページ上で特定ルック・アンド・フィールで表示する個々のアイテム。

• 特定タイプのアイテムの異なるビュー(例: 記事の短いビューと詳細ビュー)。

• 類似アイテムの異なるバージョン(例: グループ別に異なるプロパティ・セットを使用して異なる方法でフォーマットされるプレス・リリース)。

単一コンテンツ・アイテムの表示テンプレートの定義では、表29-1にリストされているJSPタグを使用します。

表29-1 単一コンテンツ・アイテムのコンテンツ表示テンプレートのタグ

JSPタグ	説明	例
contentTemplateDef	必須。単一コンテンツ・アイテムのテンプレートを定義します。 属性: var: この表示テンプレートによりレンダリングされるコンテンツ・ノードを指定します。テンプレート定義コードで、第29.4.4.1項「コンテンツ・アイテムの基本情報の取得」に記載されているEL式を使用して、ノードに関する必須情報を取得できます。	<dt:contentTemplateDef var="node"> <af:outputText value="#{node.name}" /> </dt:contentTemplateDef>
renderProperty	オプション。指定ノード・プロパティの文字列値をインラインで取得およびレンダリングします。 属性: id: このコンポーネントを識別します。この値は、ネーミング・コンテナである最寄りの親コンポーネント内で一意であることが必要です。 name: 取得するプロパティの名前を指定します。これがシステム・プロパティ(cm_createdBy、cm_createdDate、cm_modifiedDateおよびcm_path)の場合は、ノード上の値が使用されます。指定しないと、primaryPropertyが定義されている場合、これが使用されます。 node: 使用するノードを指定します。この値は、マネージドBeanにバインドされた属性またはリクエスト属性変数のいずれかになります。 blockSize: バイナリ・プロパティのバイト列を読み込むための、ブロック・サイズをバイト数で指定します。デフォルトは2048バイトです。 startIndex: 印刷を開始する位置のインデックス(起点は0)をドキュメントのバイト数で指定します。デフォルトは0です。 endIndex: 印刷を停止する位置のインデックス(起点は0)をドキュメントのバイト数で指定します。デフォルトはblockSizeの値になります。 rendered: (レンダリング・レスポンス・フェーズ中に)このコンポーネントをレンダリングするか以降の任意のフォーム実行時に処理するかどうかを指定します。デフォルト値はtrueです。	<!-- Handling of text-based primary properties (HTML, text, etc.). --> <dt:contentTemplateDef var="node"> <cmf:renderProperty id="rp1" name="#{node.primaryProperty.name}" node="#{node}"/> </dt:contentTemplateDef>
contentTemplate	オプション。contentTemplateDefの下にネストされます。 別の単一アイテム・テンプレートをコールします。 属性: node: 必須。表示される必要があるコンテンツ・リポジトリ・ノードを指定します。 nodesHint: オプション。表示テンプレートが反復コンポーネントでコールされると、すべての可能なテンプレートの事前包含ができます。contentTemplateがcontentTemplateDefタグの内部で使用されている場合は、この属性は必要ありません。 view: オプション。ターゲット・ビュー名を指定します。 id: オプション。JSFコンポーネントIDを指定します。 rendered: オプション。コンポーネントがレンダリングされるかどうかを指定します。	<dt:contentTemplateDef var="node"> <af:outputText value="#{node.name}" > <dt:contentTemplate node="#{node}" view="templates.pressrelease.item" /> </af:outputText> </dt:contentTemplateDef>

単一コンテンツ・アイテムの表示テンプレートを定義する手順は次のとおりです。

1. JDeveloperでJSFFファイルを作成します。

   1. 「ファイル」メニューから「新規」を選択します。

   2. 「新規ギャラリ」ダイアログで、「Web層」を展開し、「JSF」、「JSFページ・フラグメント」の順に選択します。

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

   4. 「新規JSFページ・フラグメントの作成」ダイアログで、表示テンプレート・ファイルの名前を入力します。

   5. ポータルWebプロジェクトのoracle/webcenter/portalapp/pagesフォルダを指すように「ディレクトリ」フィールドを設定します。このディレクトリは正しいルート・パスから設定する必要があります。JDeveloperでは、ルート・パスはPROJECT_NAME > Webコンテンツになります。ファイル・システムの場合、ルート・パスはPROJECT_ROOT/public_htmlです。たとえば、PROJECT_ROOT/public_html/oracle/webcenter/portalapp/pagesになります。最初にpagesにサブフォルダを作成し、そのサブフォルダにJSFFを格納する方法をお薦めします。

2. 「表示」、「コンポーネント・パレット」の順に選択して、コンポーネント・パレットを開きます。

3. コンポーネント・パレット最上部のドロップダウン・リスト(図29-3)で、次の手順に従います。

   • 表示テンプレート・タグのリストは、「WebCenterコンテンツ表示テンプレート」を選択します。

   • renderPropertyタグは、「WebCenterコンテンツ管理フェース」を選択します。

   図29-3 コンポーネント・パレットのコンテンツ表示テンプレート・タグ

   
   「図29-3 コンポーネント・パレットのコンテンツ表示テンプレート・タグ」の説明
   
   

4. 「ソース」ビューで、必要な表示テンプレート・タグをコンポーネント・パレットからページにドラッグ・アンド・ドロップして、テンプレートを定義します。各タグと必要なパラメータ値の情報は、表29-1を参照してください。

例29-1と例29-2は、単一コンテンツ・アイテムの表示テンプレートのサンプル定義を示しています。これらの例は、特定の種類のドキュメント(プレス・リリース)が社内の2つの異なる部門で作成される場合のユース・ケースを示しています。それぞれの部門では、独自のコンテンツ・タイプとプロパティが定義されています。これらのサンプル・コンテンツ・プレゼンタ表示テンプレートによって、この2種類のコンテンツ・タイプを一貫した方法で表示できます。

例29-1で示されたテンプレートでは、xHeadingという名前のプロパティを使用してプレス・リリース・ドキュメントの見出しを記述し、xDestinationUrlを使用してドキュメントの場所を記述するプレス・リリースを処理します。所定のコンテンツ・タイプに対するこうしたプロパティ名の取得方法を学ぶには、第29.4.5項「コンテンツ・タイプのプロパティ名の発見」を参照してください。

例29-1 プレス・リリース・ドキュメントのサンプル・コンテンツ・プレゼンタ表示テンプレート

<?xml version = '1.0'?>
<jsp:root xmlns:jsp="http://java.sun.com/JSP/Page" 
          version="2.1" 
          xmlns:af="http://xmlns.oracle.com/adf/faces/rich" 
          xmlns:dt="http://xmlns.oracle.com/webcenter/content/templates">
   <dt:contentTemplateDef var="node">
      <af:goImageLink text="#{node.propertyMap['xHeading'].value}" 
                      id="gil1" 
                      icon="#{node.icon.smallIcon}" 
                      destination="#{node.propertyMap['xDestinationUrl'].value}"
                      targetFrame="_blank">
      </af:goImageLink>
   </dt:contentTemplateDef>
</jsp:root>

例29-2で示されているテンプレートでは、dDocTitleという名前のプロパティを使用してプレス・リリース・ドキュメントの見出しを記述し、xLinkUrlを使用してドキュメントの場所を記述するプレス・リリースを処理します。

例29-2 もう1つのプレス・リリース・ドキュメントのサンプル・コンテンツ・プレゼンタ・テンプレート

<?xml version = '1.0'?>
<jsp:root xmlns:jsp="http://java.sun.com/JSP/Page" 
          version="2.1" 
          xmlns:af="http://xmlns.oracle.com/adf/faces/rich" 
          xmlns:dt="http://xmlns.oracle.com/webcenter/content/templates">
   <dt:contentTemplateDef var="node">
      <af:goImageLink text="#{node.propertyMap['dDocTitle'].value}" 
                      id="gil1" 
                      icon="#{node.icon.smallIcon}" 
                      destination="#{node.propertyMap['xLinkUrl'].value}"
                      targetFrame="_blank">
      </af:goImageLink>
   </dt:contentTemplateDef>
</jsp:root>

29.4.3 複数アイテムの表示テンプレートの定義

コンテンツ・プレゼンタ表示テンプレートを作成する複数コンテンツ・アイテムの例を次に示します。

• 1つのページに表示する一群の類似アイテム(例: 本のリストや写真による従業員名簿)。

• 問合せ結果(例: 先週変更された全ドキュメント)。

• Content Serverフォルダの全ドキュメントのリスト。

複数コンテンツ・アイテムの表示テンプレートの定義では、表29-2にリストされているJSPタグを使用します。

表29-2 複数コンテンツ・アイテムのコンテンツ表示テンプレートのタグ

JSPタグ	説明	例
contentListTemplateDef	必須。複数コンテンツ・アイテムのテンプレートを定義します。 属性: var: この表示テンプレートによりレンダリングされるコンテンツ・ノードを指定します。テンプレート定義コードで、第29.4.4.1項「コンテンツ・アイテムの基本情報の取得」に記載されているEL式を使用して、ノードに関する必須情報を取得できます。	<dt:contentListTemplateDef var="nodes"> <af:iterator value="#{nodes}" var="node"> <af:outputText value="#{node.name}" /> </af:iterator> </dt:contentListTemplateDef>
contentListTemplate	オプション。contentListTemplateDefの下にネストされます。 別の複数アイテム・テンプレートをコールします。 属性: nodes: 必須。表示する必要があるVCRノードのリストを提供します。 category: 必須。ターゲット・テンプレートのカテゴリを指定します。 view: 必須。ターゲット・ビュー名を指定します。 id: オプション。JSFコンポーネントIDを指定します。 rendered: オプション。コンポーネントがレンダリングされるかどうかを指定します。	<dt:contentListTemplateDef var="nodes"> <!-- Reuse the default bulleted list view, but indent it with a <blockquote> --> <f:verbatim> <blockquote> </f:verbatim> <dt:contentListTemplate nodes="#{nodes}" category="oracle.webcenter.content. templates.default.category" view="oracle.webcenter.content. templates.default.list.bulleted"/> <f:verbatim> </blockquote> </f:verbatim> </dt:contentListTemplateDef>
contentTemplate	オプション。contentListTemplateDefの下にネストされます。 単一アイテム・テンプレートをコールします。 属性: node: 必須。表示される必要があるコンテンツ・リポジトリ・ノードを指定します。 nodesHint: オプション。表示テンプレートが反復コンポーネントでコールされると、すべての可能なテンプレートの事前包含ができます。contentTemplateがcontentListTemplateDefタグの内部で使用されている場合、この属性は通常必要とされます。 view: オプション。ターゲット・ビュー名を指定します。 id: オプション。JSFコンポーネントIDを指定します。 rendered: オプション。コンポーネントがレンダリングされるかどうかを指定します。	<dt:contentListTemplateDef var="nodes"> <af:iterator rows="0" var="node" varStatus="iterator" value="#{nodes}"> <dt:contentTemplate node="#{node}" view="templates.pressrelease.listitem" nodesHint="#{nodes}"/> </af:iterator> </dt:contentListTemplateDef>

複数コンテンツ・アイテムの表示テンプレートを定義する手順は次のとおりです。

1. 第29.4.2項「単一アイテムの表示テンプレートの定義」の手順1から3の説明に従って、JDeveloperでJSFFファイルを作成し、コンポーネント・パレットを開きます。

2. 「ソース」ビューで、必要な表示テンプレート・タグをコンポーネント・パレットからページにドラッグ・アンド・ドロップします。各タグと必要なパラメータ値の情報は、表29-2を参照してください。

例29-3は、複数コンテンツ・アイテムの表示テンプレートのサンプル定義を示しています。

例29-3 複数プレス・リリース表示用のサンプル表示テンプレート定義(press-release-list-view.jsff)

このテンプレート定義では、参照されるビュー(view="mycorp.content.templates.pressrelease.listitem")に従って、表示するように選択されたデータ・アイテムを順に処理します。

<?xml version = '1.0'?>
<jsp:root xmlns:jsp="http://java.sun.com/JSP/Page" version="2.1" 
          xmlns:af="http://xmlns.oracle.com/adf/faces/rich" 
          xmlns:dt="http://xmlns.oracle.com/webcenter/content/templates">
   <dt:contentListTemplateDef var="nodes">
      <af:panelGroupLayout layout="scroll" id="nodeListPanel" valign="middle">
        <af:iterator rows="0" var="node" varStatus="iterator" value="#{nodes}">
           <dt:contentTemplate node="#{node}" 
               view="mycorp.content.templates.pressrelease.listitem" 
               nodesHint="#{nodes}"/>
        </af:iterator>
      </af:panelGroupLayout>
   </dt:contentListTemplateDef>
</jsp:root>

29.4.4 EL式を使用したコンテンツ・アイテム情報の取得

この項では、コンテンツ・アイテムに関する特定情報を取得および表示するためにコンテンツ・プレゼンタ表示テンプレートの定義で使用できるEL式について説明します。

第29.4.2項「単一アイテムの表示テンプレートの定義」と第29.4.3項「複数アイテムの表示テンプレートの定義」の説明に従ってコンテンツ・プレゼンタ表示テンプレートを定義する際、次の表で説明されているEL式を使用します。これらの式は、表29-1と表29-2で説明されているJSPタグとともに使用されます。

29.4.4.1 コンテンツ・アイテムの基本情報の取得

表29-3にリストされているEL式を使用すると、表示テンプレートでコンテンツ・アイテムの基本情報を表示できます。

表29-3 基本コンテンツ情報を取得するためのEL式

EL式	説明
#{node.createdBy}	ノードの作成者のユーザー名を返します。
#{node.createdDate}	ノードの作成日を返します。
#{node.hasParentNode}	現在のノードが有効な親ノードIDを持っている場合または親がないノードの場合、trueを返します。
#{node.icon}	現在のWebアプリケーションで定義されたアイコン・サービスを返します。
#{node.id}	ノードの識別子を返します。
#{node.isFolder}	このノードがフォルダまたはコンテナと関連付けられている場合、trueを返します。
#{node.isInherited}	このノードが別のオブジェクト・クラス定義によって継承された場合、trueを返します。
#{node.modifiedBy}	ノードの最終更新者のユーザー名を返します。
#{node.modifiedDate}	ノードの最終更新日を返します。
#{node.name}	ノードの名前を返します。
#{node.parentId}	親ノードの識別子を返します。
#{node.path}	ノードのパスを返します。
#{node.primaryProperty}	ノードの主要プロパティがある場合、それを返します。
#{node.propertyMap}	プロパティ名をキーとする、ラップされたプロパティ・オブジェクトのマップを作成して返します。プロパティには#{node.propertyMap['myProp']}または#{node.propertyMap.myProp}としてアクセスできます。
#{node.url}	このノードの主要プロパティがある場合、そのノード・プロパティURLサービスのインスタンスを返します。デフォルトでは、#{node.url.renderUrl}に解決します。これは#{node.primaryProperty.url}のショートカットです。

29.4.4.2 コンテンツ・アイテムのプロパティおよび値の操作

表29-4と表29-5で説明されているEL式を使用して、コンテンツ・アイテムのノード・プロパティとプロパティ値に対するアクションを実行します。

ヒント: 所定のコンテンツ・タイプに定義されたプロパティ名を判断するには、第29.4.5項「コンテンツ・タイプのプロパティ名の発見」を参照してください。

表29-4 コンテンツ・アイテムのノード・プロパティのEL式

EL式	説明
#{node.propertyMap['myProp']'myProp'].asTextHtml}	タイプがテキストまたはHTMLの場合、テキストまたはHTMLとしてこのプロパティを返します。isHTMLまたはisPlainTextがtrueの場合、テキストまたはHTMLは文字列として返されます。
#{node.propertyMap['myProp'].hasValue}	このプロパティに値が関連付けられている場合、trueを返します。
#{node.propertyMap['myProp'].icon}	現在のWebアプリケーションで定義されたアイコン・サービスを返します。
#{node.propertyMap['myProp'].indexedName}	複数値を持つプロパティのインデックス付き名前を返します。たとえば、colorという名前の複数値を持つノード・プロパティにblue、red、orangeが含まれている場合、red値のインデックス付き名前はcolor[1]になります。 #{node.propertyMap['color[2]'].value.stringValue}というEL式は、このリストのorangeというcolorを参照します。
#{node.propertyMap['myProp'].isAudio}	プロパティのMIMEタイプがaudio/の場合、trueを返します。
#{node.propertyMap['myProp'].isBinary}	現在のプロパティのタイプがProperty.BINARYの場合、trueを返します。
#{node.propertyMap['myProp'].isBoolean}	現在のプロパティのタイプがProperty.BOOLEANの場合、trueを返します。
#{node.propertyMap['myProp'].isCalendar}	現在のプロパティのタイプがProperty.CALENDARの場合、trueを返します。
#{node.propertyMap['myProp'].isDouble}	現在のプロパティのタイプがProperty.DOUBLEの場合、trueを返します。
#{node.propertyMap['myProp'].isExcel}	プロパティのMIMEタイプがapplication/vnd.ms-excel、application/excel、application/x-excelまたはapplication/x-msexcelの場合、trueを返します。
#{node.propertyMap['myProp'].isGIF}	プロパティのMIMEタイプがimage/gifの場合、trueを返します。
#{node.propertyMap['myProp'].isHTML}	プロパティのMIMEタイプがtext/htmlの場合、trueを返します。
#{node.propertyMap['myProp'].isImage}	プロパティのMIMEタイプがimage/の場合、trueを返します。
#{node.propertyMap['myProp'].isJPEG}	プロパティのMIMEタイプがimage/jpegの場合、trueを返します。
#{node.propertyMap['myProp'].isLink}	現在のプロパティのタイプがProperty.LINKの場合、trueを返します。
#{node.propertyMap['myProp'].isLong}	現在のプロパティのタイプがProperty.LONGの場合、trueを返します。
#{node.propertyMap['myProp'].isMSWord}	プロパティのMIMEタイプがapplication/vnd.ms-wordまたはapplication/mswordの場合、trueを返します。
#{node.propertyMap['myProp'].isMultiValued}	このプロパティが複数値を持つ場合、trueを返します。
#{node.propertyMap['myProp'].isNested}	現在のプロパティのタイプがProperty.NESTEDの場合、trueを返します。
#{node.propertyMap['myProp'].isPDF}	プロパティのMIMEタイプがapplication/pdfの場合、trueを返します。
#{node.propertyMap['myProp'].isPlainText}	プロパティのMIMEタイプがtext/plainの場合、trueを返します。
#{node.propertyMap['myProp'].isPNG}	プロパティのMIMEタイプがimage/pngの場合、trueを返します。
#{node.propertyMap['myProp'].isPowerPoint}	プロパティのMIMEタイプがapplication/vnd.ms-powerpoint、application/mspowerpointまたはapplication/x-mspowerpointの場合、trueを返します。
#{node.propertyMap['myProp'].isPrimaryProperty}	このプロパティが主要プロパティの場合、trueを返します。
#{node.propertyMap['myProp'].isRequired}	このプロパティが必須の場合、trueを返します。
#{node.propertyMap['myProp'].isRetricted}	このプロパティが制限付きの場合、trueを返します。
#{node.propertyMap['myProp'].isRichText}	プロパティのMIMEタイプがtext/richtextの場合、trueを返します。
#{node.propertyMap['myProp'].isString}	現在のプロパティのタイプがProperty.STRINGの場合、trueを返します。
#{node.propertyMap['myProp'].isTextBased}	このプロパティがテキスト・ベース(isHTML、isPlainText、isString、isCalendar、isBoolean、isDouble、isLong)の場合、trueを返します。
#{node.propertyMap['myProp'].isVideo}	プロパティのMIMEタイプがvideo/の場合、trueを返します。
#{node.propertyMap['myProp'].isXML}	プロパティのMIMEタイプがtext/xmlの場合、trueを返します。
#{node.propertyMap['myProp'].isZip}	プロパティのMIMEタイプがapplication/zipの場合、trueを返します。
#{node.propertyMap['myRefNode'].linkAsNode}	ノードとしてmyRefNodeプロパティを返します。myRefNodeはリンク・プロパティ・タイプです。プロパティはEL式で参照できます。 例: #{node.propertyMap['myRefNode'].linkAsNode.primaryProperty.url.renderUrl}
#{node.propertyMap['myProp'].name}	プロパティの名前を返します。
#{node.propertyMap['myProp'].nestedProperty}	この単一値プロパティのネストされたプロパティを取得して、プロパティのリストを返します。
#{node.propertyMap['myProp'].type}	このプロパティ値のデータ型を返します。たとえば、String、Integer、Longなどです。
#{node.propertyMap['myProp'].url}	このプロパティのURLサービスを返します。
#{node.propertyMap['myProp'].value}	このプロパティの値サービスを返します。
#{node.propertyMap['myProp'].nestedProperties}	静的リストの要素を返します。次に例を示します。 <af:iterator var="listItem" value="#{node.propertyMap['ARTICLE_RGD:Paragraphs'].nestedProperties}" varStatus="vs"> <af:outputText id="ot1" value='#{listItem[0].value}'/> <af:outputText id="ot3" value="#{listItem[1].value}"/> </af:iterator>
#node.propertyMap['regionDefName:elementName'].asTextHtml}	Site StudioデータをHTMLテキストとして返します。次に例を示します。 #node.propertyMap['RD_NEWS:LEAD'].asTextHtml} 要素名(LEAD)には、接頭辞としてリージョン定義名(RD_NEWS)が付きます。第29.4.7項「カスタム・ビューにおけるSite Studioリージョン要素の参照」も参照してください。

表29-5 コンテンツ・アイテムのノード・プロパティ値のEL式

EL式	説明
#{node.propertyMap['myProp'].value.binaryValue}	バイナリ・プロパティ・タイプまたは添付ファイルのカスタム属性を返します。binaryValueに使用できる属性は次のとおりです。 contentType – バイナリ・コンテンツのMIMEタイプを返します(例: textまたはhtml)。 name – バイナリ・コンテンツのファイル名を返します(例: index.html)。 size – バイナリ・コンテンツのサイズを返します。サイズを返せない場合、-1を返します。
#{node.propertyMap['myProp'].value.booleanValue}	このプロパティの値をjava.lang.Booleanとして返します。
#{node.propertyMap['myProp'].value.calendarValue}	このプロパティの値をjava.util.Calendarとして返します。
#{node.propertyMap['myProp'].value.doubleValue}	このプロパティの値をjava.lang.Doubleとして返します。
#{node.propertyMap['myProp'].value.longValue}	このプロパティの値をjava.lang.Longとして返します。
#{node.propertyMap['myProp'].value.orderedPosition}	プロパティが複数値を持つ場合、プロパティのインデックスを返します。 例: #{node.propertyMap['address[0]'].value.orderedPosition},
#{node.propertyMap['myProp'].value.stringValue}	このプロパティの値をjava.lang.Stringとして返します。 例: #{node.propertyMap['firstName'].value.stringValue}

29.4.4.3 コンテンツ・アイテムのアイコンおよびURLの操作

表29-6と表29-7は、コンテンツ・アイテムとプロパティに関連付けられたアイコンとURLを操作するためのEL式を説明しています。

表29-6 コンテンツ・アイテムのノードまたはプロパティ・アイコンのEL式

EL式	説明
#{node.icon.largeIcon} #{node.propertyMap['myDoc'].icon.largeIcon}	大きいアイコンのイメージ・リソースのURLを返します。 例: <af:image source="#{node.propertyMap['projectFolder'].largeIcon}"/>
#{node.icon.smallIcon} #{node.propertyMap['myDoc'].icon.smallIcon}	小さいアイコンのイメージ・リソースのURLを返します。 例: <af:image source="#{node.icon.smallIcon}" />

表29-7 コンテンツ・アイテムのノードURLのEL式

EL式	説明
#{node.url.downloadUrl}	バイナリ・コンテンツへのURLを作成します。ダウンロードを強制し、オペレーティング・システムはコンテンツ・タイプに基づいてコンテンツをレンダリングします。 例: <af:goLink destination="#{node.url.downloadUrl}" targetFrame="_blank"/>
#{node.url.renderUrl}	バイナリ・コンテンツへのURLを作成します。コンテンツ・タイプに基づいてブラウザがコンテンツをレンダリングできるようにします。 デフォルトでは、#{node.url}は#{node.url.renderUrl}に解決します。 例: <af:goLink destination="#{node.url.renderUrl}" targetFrame="_blank"/>

29.4.5 コンテンツ・タイプのプロパティ名の発見

この項では、コンテンツ・アイテムのコンテンツ・タイプのプロパティ名を知るために役立つテクニックを説明します。

注意: RESTサービスを使用しても、コンテンツ・タイプのプロパティ名を取得できます。詳細はOracle Fusion Middlewareコンテンツ管理RESTサービス開発者ガイドを参照してください。

各コンテンツ・アイテムは、コンテンツ・サーバーのリポジトリで定義された特定コンテンツ・タイプに関連付けらます。コンテンツ・タイプはコンテンツ・サーバーのプロファイル定義とSite Studioのリージョン定義にマップできます。タイプはコンテンツ・サーバー上で作成されます。コンテンツ・タイプはコンテンツ・アイテムのプロパティを定義し(表29-8を参照)、テンプレートの登録時に識別されます。

コンテンツ・プレゼンタ表示テンプレートの開発者は、選択されたコンテンツ・アイテムのページ上での表示方法を定義できるように、関連付けられたコンテンツ・タイプに定義されたプロパティの名前を知っておくことが必要です。

Content Serverで定義されている既存コンテンツ・タイプのプロパティを判断する1つの方法は、WebCenter Portal: Spacesの「コンテンツ・プレゼンタ構成」ダイアログを使用する方法です。

1. 「コンテンツ・プレゼンタ構成」ダイアログを開きます。詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのコンテンツ・プレゼンタ・タスク・フローを使用したコンテンツの表示に関する項を参照してください。

2. 「コンテンツ・プレゼンタ構成」ダイアログの「コンテンツ」タブで、「問合せの結果」を選択してコンテンツ・タイプのリストを表示します。

3. 表示するコンテンツ・アイテムの「コンテンツ・タイプ」を選択します。

4. 「その他の問合せフィルタ」の隣の「追加」をクリックして、選択したコンテンツ・タイプに定義されているすべてのプロパティをリストします(図29-4)。

   
   

   注意: ドロップダウン・リストに表示されるプロパティ名のリスト(図29-4)は表示名のみです。たとえば、表示名Authorは、実際のコンテンツ・タイプ・プロパティ名dDocAuthorに対応します。 表示名に対応する実際のプロパティ名を見つけるには、Content Server管理コンソールを通してアクセスするか、Content Server管理者に問い合せてください。 実際のコンテンツ・タイプ・プロパティを参照する際、先頭にdまたはxを付けて内部Content Serverプロパティ名を参照する必要があります。接頭辞dはシステム・プロパティを識別し、接頭辞xはユーザー・プロパティを識別します。たとえば、dDocAuthorまたはxCollectionIDとなります。

   
   

   図29-4 コンテンツ・タイプのプロパティの識別

   
   「図29-4 コンテンツ・タイプのプロパティの識別」の説明
   
   

29.4.6 表示テンプレートにおける外部ファイルの参照

場合によっては、CSSファイルのような外部ファイルを表示テンプレートで参照する必要があります。このようなすべての参照では、Webアプリケーションのルートへの相対パスか絶対パスを指定します。次に例を示します。

• 絶対パス – http://host:port/mypath/file.css

• 相対パス – /webcenter/mypath/file.css

外部ファイルに対するローカル参照は使用しないでください。第29.5項「Frameworkアプリケーションにおけるコンテンツ・プレゼンタ表示テンプレートの使用」で説明されているように、WebCenter Portal: Spacesアプリケーションにコンテンツ・プレゼンタ表示テンプレートをアップロードする際、外部ファイルへのローカル参照は含まれないので、外部ファイルへのローカル参照は機能しません。

29.4.7 カスタム・ビューにおけるSite Studioリージョン要素の参照

カスタム表示テンプレートを使用してSite Studioリージョン定義要素を表示できます。たとえば、TITLE、LEAD、IMAGEおよびBODYという4つの要素を持つRD_NEWSというSite Studioリージョン定義があると仮定します。コンテンツ・プレゼンタ表示テンプレートでは、次のようなノード・プロパティEL式を使用して、これらの要素を参照できます。

#node.propertyMap['RD_NEWS:LEAD'].asTextHtml}

例29-4は、こうしたSite Studioリージョン要素をcontentTemplateDef定義に含める方法を示します。

例29-4 テンプレートにおけるSite Studioリージョン要素の参照

<dt:contentTemplateDef var="node">
   <af:panelGroupLayout layout="vertical" id="pgl3">
     <af:panelGroupLayout layout="horizontal" valign="top" inlineStyle="background-color:#FFF; padding:10px;" id="pgl4">
         <af:panelGroupLayout layout="vertical" id="pgl2" valign="top">
            <af:outputText value="#{node.propertyMap['dInDate'].value.calendarValue}" id="ot3" styleClass="bodytext" converter="javax.faces.DateTime"/>
          </af:panelGroupLayout>
          <af:spacer width="10px;" id="s1" inlineStyle="background-color:#DDD; color:white;"/>
          <af:panelGroupLayout layout="vertical" id="pgl1" valign="top">
             <af:outputText value="#{node.propertyMap['xTargetGroup'].value}" id="ot12" inlineStyle="background-color:#0A9FC0; color:white; text-align:left; padding:5px;"/>
            <af:goLink text="#{node.propertyMap['RD_NEWS:TITLE'].asTextHtml}" id="gil1" 
                destination="#{'/faces/home/news-viewer?news_id='}#{node.propertyMap['dDocName'].value}" styleClass="newstitle"/>
           <af:outputText value="#{node.propertyMap['RD_NEWS:LEAD'].asTextHtml}" id="ot2" styleClass="bodytext"/>  
         </af:panelGroupLayout>
       <af:panelGroupLayout layout="vertical" id="pgl32" valign="top" styleClass="newsimage">
         <af:outputText value="#{node.propertyMap['RD_NEWS:IMAGE'].asTextHtml}" escape="false" id="ot1"  inlineStyle="max-width:100px;"/>
       </af:panelGroupLayout>
     </af:panelGroupLayout>
     <af:panelGroupLayout layout="horizontal" id="aaaa">
     </af:panelGroupLayout>
   </af:panelGroupLayout>
</dt:contentTemplateDef>

複数のテンプレートでSite Studioリージョン要素を参照する方法を示す完全なエンドツーエンドの例は、WebCenterアーキテクチャ・チームのブログ・エントリ(http://blogs.oracle.com/ATEAM_WEBCENTER/entry/content_presenter_cmis_complete)を参照してください。

29.4.8 コンテンツ・プレゼンタ表示テンプレートの使用

コンテンツ・タスク・フローにおける表示テンプレートの使用の詳細は、第31.5項「コンテンツ・タスク・フローのページへの追加」を参照してください。また、第31.7.1項「コンテンツ・プレゼンタのタスク・フローのパラメータと即時利用可能な表示テンプレート」も参照してください。WebCenter Portal: Frameworkアプリケーションへの表示テンプレートの統合の詳細は、次の第29.5項「Frameworkアプリケーションにおけるコンテンツ・プレゼンタ表示テンプレートの使用」を参照してください。

注意: コンテンツ・プレゼンタの表示テンプレートを使用してWikiページをFrameworkアプリケーションで表示すると、デフォルトでそのWikiページ内のリンクがドキュメント・ビューアで表示されます。コンテンツ・プレゼンタを使用してWikiページのリンクを表示する場合、adf-config.xmlファイルを編集する必要があります。詳細は、第32.3.5項「コンテンツ・プレゼンタでのWikiページ・リンクの表示」を参照してください。

29.5 Frameworkアプリケーションにおけるコンテンツ・プレゼンタ表示テンプレートの使用

この項では、Frameworkアプリケーションのコンテンツ・プレゼンタでコンテンツ・プレゼンタ表示テンプレートを使用する方法を説明します。

• 第29.5.1項「ポータル・リソースとしてのコンテンツ・プレゼンタ表示テンプレートのエクスポート」

• 第29.5.2項「新しいコンテンツ・プレゼンタ表示テンプレートのアップロード」

• 第29.5.3項「新しいコンテンツ・プレゼンタ表示テンプレートのテスト」

注意: ローカルで構成されたJDev環境を使用してFrameworkアプリケーションを開発する場合、アプリケーションでコンテンツ・プレゼンタ表示テンプレートを使用するには、第29.5.1項「ポータル・リソースとしてのコンテンツ・プレゼンタ表示テンプレートのエクスポート」の説明に従ってポータル・リソースとしてエクスポートします。第29.5.2項「新しいコンテンツ・プレゼンタ表示テンプレートのアップロード」で説明されているアップロード・タスクの実行は不要です。

29.5.1 ポータル・リソースとしてのコンテンツ・プレゼンタ表示テンプレートのエクスポート

この項では、ポータル・リソースとしてコンテンツ・プレゼンタ表示テンプレートをエクスポートする方法を説明します。この手順は、デプロイされているWebCenter Portal: Spacesアプリケーションとコンテンツ・プレゼンタに実行時にコンテンツ・プレゼンタ表示テンプレートを追加する際に必要です。

1. 前述の第29.4項「コンテンツ・プレゼンタ表示テンプレートの作成」の説明に従ってコンテンツ・プレゼンタ表示テンプレートを作成します。

2. アプリケーション・ナビゲータで、コンテンツ・プレゼンタ表示テンプレート・ファイル(JSFFファイル)を右クリックし、「ポータル・リソースの作成」を選択します。

3. 「ポータル・リソースの作成」ダイアログに入力します。このダイアログは、単一アイテムと複数アイテムのどちらのテンプレートを作成するかによって異なります。単一アイテムのテンプレートのダイアログは図29-5に示されています。複数アイテムのテンプレートのダイアログは図29-6に示されています。

   図29-5 単一アイテムのテンプレートの「ポータル・リソースの作成」ダイアログ

   
   「図29-5 単一アイテムのテンプレートの「ポータル・リソースの作成」ダイアログ」の説明
   
   

   図29-6 複数アイテムのテンプレートの「ポータル・リソースの作成」ダイアログ

   
   「図29-6 複数アイテムのテンプレートの「ポータル・リソースの作成」ダイアログ」の説明
   
   

   通常は「ポータル・リソースの作成」ダイアログのデフォルト設定で十分ですが、「ビューID:*」フィールドに一意の値を入力する必要があります。「表示名」は、実行時に表示テンプレートのドロップダウン・メニューに表示される名前です。

   
   

   ビューIDパラメータは人間が判読可能な形式を意図しているので、自動的には生成されません。たとえば、ビューIDを使用して、あるテンプレートを別のテンプレートからプログラムによって参照できます。たとえば、複数コンテンツ・アイテムのテンプレートで各アイテムのタブをレンダリングし、選択されたタブの下で使用される単一アイテムのテンプレートをコールして、選択されたアイテムの詳細をレンダリングできます。また、たとえば、コンテンツ・プレゼンタ・タスク・フローのパラメータとしてビューIDを渡すことで、あるテンプレートを別のテンプレートに含めることができます。後者のユース・ケースを示す詳細な例は、WebCenterアーキテクチャ・チームのブログ・エントリ(http://blogs.oracle.com/ATEAM_WEBCENTER/entry/content_presenter_cmis_complete)を参照してください。第29.4.7項「カスタム・ビューにおけるSite Studioリージョン要素の参照」も参照してください。

   単一アイテムのテンプレート用の「ポータル・リソースの作成」ダイアログには、他に次の属性が含まれます。

   • テンプレート・タイプ:* – テンプレートが単一アイテムと複数アイテムのどちらのテンプレートかを反映します。

   • コンテンツ・リポジトリ名:* – デフォルトでは、ポータル・リソースは、アプリケーションのデフォルト・コンテンツ接続に関連付けられたリポジトリを使用します。WebCenter Portal: Spacesアプリケーションで使用するためにポータル・リソースをエクスポートする場合、WebCenter Portal: Spaces接続名で使用されるものと一致するリポジトリを選択する必要があります。

   • コンテンツ・タイプ – テンプレートが有効なコンテンツ・タイプを選択できます。メニューに表示されるコンテンツ・タイプのリストは、選択されたコンテンツ・リポジトリに応じて異なります。

   • コンテンツ・タイプのデフォルト・ビュー:* – 「True」に設定すると、表示テンプレートが、リポジトリとコンテンツ・タイプの所定の組合せに使用するデフォルト・テンプレートであることを指定します。

   • ビューID:* – この項で前述したように、テンプレートをプログラム的に参照するために使用する一意の値。

   複数アイテムのテンプレート用の「ポータル・リソースの作成」ダイアログには、他に次の属性が含まれます。

   • テンプレート・タイプ:* – テンプレートが単一アイテムと複数アイテムのどちらのテンプレートかを反映します。

   • カテゴリ名 – 表示テンプレートのカテゴリに指定する名前。カテゴリを説明する名前を指定するか、「デフォルトのテンプレート」のカテゴリ名を使用できます。

   • カテゴリID – カテゴリのID。カテゴリ名として「デフォルトのテンプレート」を選択すると、このフィールドは読取り専用となり、oracle.webcenter.content.templates.default.categoryが設定されます。新しいカテゴリを作成する場合、この値には一意の文字列を指定できます。たとえば、oracle.webcenter.content.templates.pressrelease.categoryを指定できます。2つのリソースが同じIDを持つ場合、それらはユーザー・インタフェースで同じグループにまとめられます。

   • ビューID:* – この項で前述したように、テンプレートをプログラム的に参照するために使用する一意の値。

     
     

     注意: 「ポータル・リソースの作成」ダイアログの他のフィールドの詳細は、第17.4.3項「ポータル・リソースをJDeveloperからエクスポートする方法」を参照してください。

     
     

4. 終了したら、ダイアログで「OK」をクリックします。

5. コンテンツ・プレゼンタ表示テンプレート(JSFF)ファイルを再度右クリックして、今回は「ポータル・リソースのエクスポート」を選択します。

6. 「ポータル・リソースのエクスポート」ダイアログで、エクスポートしたポータル・リソース・ファイルを配置するディレクトリを入力するか参照します。このファイルはファイル・システムの任意の場所に配置できます。

7. 「ポータル・リソースのエクスポート」ダイアログで「OK」をクリックします。

これで、ポータル・リソースとしてコンテンツ・プレゼンタ表示テンプレートがエクスポートされます。次の手順は、WebCenter Portal: Spacesアプリケーションにこれをアップロードすることです。アップロードした表示テンプレート・ポータル・リソースは、ポータル・ページにコンテンツ・プレゼンタを追加すると、表示テンプレートのリストで利用できます。

29.5.2 新しいコンテンツ・プレゼンタ表示テンプレートのアップロード

新しい表示テンプレートは、リソース・マネージャを含むデプロイ済みのWebCenter Portal: FrameworkまたはWebCenter Portal: Spacesアプリケーションにアップロードできます。WebCenter Portal: FrameworkまたはWebCenter Portal: Spacesアプリケーションにコンテンツ・プレゼンタ表示テンプレートをアップロードする手順は次のとおりです。

注意: コンテンツ・プレゼンタ表示テンプレートを開発した設計時のFrameworkアプリケーションとWebCenter Portal: Spacesアプリケーションで、同じリポジトリ接続名と詳細にする必要があります。

注意: 表示テンプレートにおける外部ファイルへの参照は、絶対パスまたは相対パスの参照であることが必要です。第29.4.6項「表示テンプレートにおける外部ファイルの参照」を参照してください。

1. WebCenter Portal: FrameworkまたはWebCenter Portal: Spacesアプリケーションを起動します。

2. コンテンツ・プレゼンタ表示テンプレートの追加先ページに移動します。

3. 「管理」をクリックします。

4. 「リソース」タブを選択します。

5. 「外観とレイアウト」という見出し(Webページの右側)の下の「コンテンツ・プレゼンタ」をクリックします。

6. 図29-7に示された「アップロード」を選択します。

   図29-7 表示テンプレート・ポータル・リソースのアップロード

   
   「図29-7 表示テンプレート・ポータル・リソースのアップロード」の説明
   
   

7. 「アップロード」ダイアログで、ファイル・システム上に保存したポータル・リソース・ファイルにナビゲートします。

8. テンプレート・ファイルを選択して「OK」をクリックします。操作が成功すると、情報ダイアログに「リソースは正常にアップロードされました。」というメッセージが表示されます。

9. 図29-8に示されているように、「リソース」タブのリスト・ビューからコンテンツ・プレゼンタ表示テンプレートを見つけて選択します。

   図29-8 テンプレートの表示と非表示の状態の切替え

   
   「図29-8 テンプレートの表示と非表示の状態の切替え」の説明
   
   

10. テンプレートの状態が現在非表示の場合、「編集」メニューから「表示」を選択します。テンプレートが非表示の場合、コンテンツ・プレゼンタで使用できません。

これで、新しいコンテンツ・プレゼンタ表示テンプレートを、WebCenter Portal: Spacesアプリケーションのコンテンツ・プレゼンタで使用する準備が整いました。

29.5.3 新しいコンテンツ・プレゼンタ表示テンプレートのテスト

この項では、コンテンツ・プレゼンタを使用してコンテンツ・プレゼンタ表示テンプレートをテストする方法を説明します。

1. コンテンツ・プレゼンタ表示テンプレートを追加したWebCenter Portal: Spacesアプリケーションを現在実行中でない場合、これを起動します。このアプリケーションには、コンテンツ・プレゼンタが使用できるContent Server接続が必要です。前の項で説明されている設定手順を完了したばかりの場合、「管理」ページの右上隅の「スペースに戻る」リンクをクリックします。

2. 新しいコンテンツ・プレゼンタ表示テンプレートを使用するスペースに移動します。これを行うには、「スペース」タブを選択して、所有するスペースまたは編集可能なスペースを選択します。

3. オプションとして、表示テンプレートをテストするために新しいページを作成します。「ページ・アクション」メニューから「新規ページの作成」を選択します。「保存」と「閉じる」を選択します。

4. 新規ページまたは既存のページで、「ページ・アクション」メニューから「ページの編集」を選択します。

5. コンテンツ・プレゼンタを追加するページの部分で「コンテンツの追加」ボタンを選択します。

6. 図29-9に示されているように、「コンテンツの追加」ダイアログで、「コンテンツ管理」フォルダを開きます。

   図29-9 ドキュメント管理フォルダのオープン

   
   「図29-9 ドキュメント管理フォルダのオープン」の説明
   
   

7. 「コンテンツの追加」ダイアログで、コンテンツ・プレゼンタの隣の「追加」ボタンをクリックします。

8. 「コンテンツの追加」ダイアログを閉じます。

9. コンテンツ・プレゼンタ・ツール・バーでタスク・フローの「編集」アイコンを選択します(図29-10を参照)。

   図29-10 「編集」アイコンの選択

   
   「図29-10 「編集」アイコンの選択」の説明
   
   

10. 「コンテンツ・プレゼンタ構成」ウィンドウで、「テンプレート」タブを選択します。

11. 図29-11に示されているように、「テンプレート」メニューからコンテンツ・プレゼンタ表示テンプレートを選択します。

    図29-11 コンテンツ・プレゼンタ表示テンプレートの選択

    
    「図29-11 コンテンツ・プレゼンタ表示テンプレートの選択」の説明
    
    

このコンテンツ・プレゼンタ・テンプレートが、コンテンツ・プレゼンタ・インスタンスに適用されます。コンテンツ・プレゼンタと表示テンプレートの使用の詳細は、第31.2項「ドキュメント・サービスのタスク・フローの概要」と第29.3項「デフォルト表示テンプレートの使用」を参照してください。

29.6 実行時の処理

この項の内容は、次のとおりです。

• 第29.6.1項「実行時の概要」

• 第29.6.2項「選択されたコンテンツ・アイテムの表示テンプレートの識別」

29.6.1 実行時の概要

コンテンツ・プレゼンタ表示テンプレートを定義したら、コンテンツ・プレゼンタ・タスク・フロー・パラメータでコンテンツと表示テンプレートを指定して、アプリケーションのページにコンテンツ・プレゼンタ・タスク・フローを追加できます(第31.6項「コンテンツ・タスク・フローのパラメータの変更」と第29.3項「デフォルト表示テンプレートの使用」を参照)。

アプリケーションにドキュメント・サービスを統合する場合(第30章「ドキュメント・サービスの統合」を参照)、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのコンテンツ・プレゼンタを使用したコンテンツの公開に関する項で説明されているように、アプリケーションのエンド・ユーザーは「コンテンツ・プレゼンタ構成」ダイアログでコンテンツとコンテンツ・プレゼンタ表示テンプレートを選択して、アプリケーションの編集可能なページにコンテンツを含めることができます。「コンテンツ・プレゼンタ構成」ダイアログで公開する表示テンプレートをコンテンツ・プレゼンタが識別する方法については、第29.6.2項「選択されたコンテンツ・アイテムの表示テンプレートの識別」を参照してください。

29.6.2 選択されたコンテンツ・アイテムの表示テンプレートの識別

実行時にユーザーが「コンテンツ・プレゼンタ構成」ダイアログでコンテンツを選択すると、コンテンツ・プレゼンタはリソース・マネージャをチェックして、選択されたコンテンツ・アイテムに適した表示テンプレートを識別し、ユーザーが選択できるように「コンテンツ・プレゼンタ構成」ダイアログの「テンプレート」ページに有効なテンプレートのリストを公開します。第17章「リソース・マネージャの追加および使用」も参照してください。

単一コンテンツ・アイテムのテンプレートの場合は、コンテンツ・プレゼンタは次の優先順位に従って有効なテンプレートのリストを生成します。

1. リソース・マネージャで、コンテンツ・アイテムのコンテンツ・リポジトリとコンテンツ・タイプに一致するテンプレート定義をチェックします。

2. デフォルトのコンテンツ・リポジトリ(*)と指定のコンテンツ・タイプに一致するテンプレート定義を追加します。

3. 継承されたコンテンツ・タイプに一致するテンプレート定義を追加します。

4. デフォルトのコンテンツ・リポジトリ(*)とデフォルトのコンテンツ・タイプ(*)に一致するテンプレート定義を追加します。

複数コンテンツ・アイテムのテンプレートの場合は、コンテンツ・プレゼンタは次の優先順位に従って有効なテンプレートのリストを生成します。

1. リソース・マネージャで、選択されたテンプレート・カテゴリに関連付けられたテンプレート定義をチェックします。

2. デフォルト・カテゴリ(*)に関連付けられたテンプレート定義を追加します。

たとえば、ユーザーが複数コンテンツ・アイテム(フォルダの複数の子、検索の複数の結果など)を選択した場合、「コンテンツ・プレゼンタ構成」ダイアログには、コンテンツ・アイテムのリポジトリに基づいて、カテゴリのリストとそのカテゴリおよびデフォルト・カテゴリに関連付けられたテンプレートのリストが表示されます。

注意: 「コンテンツ・プレゼンタ構成」ダイアログでユーザーがテンプレートを選択すると、そのテンプレートを使用して実行中のアプリケーションで選択されたコンテンツ・アイテムが表示されます。後でなんらかの理由でそのテンプレートがリソース・マネージャから削除された場合、コンテンツ・プレゼンタは前述の優先順位に従ってコンテンツ・アイテムを表示するために最も一致度の高いテンプレートを自動的に選択します。

29.7 コンテンツ・プレゼンタ表示テンプレートのパフォーマンスの考慮点

コンテンツ・プレゼンタ表示テンプレートで表示するためにコンテンツ・ノードを取得すると、ほとんどのコンテンツ・アイテム・ノード・プロパティ値はノードとともに即座に取得されますが、一部の値は後で必要な場合のみロードされます。ノード・プロパティ値の選別的なロードは、パフォーマンスの違いをもたらすほか、ユーザーや開発者に透過的です。

コンテンツ・プレゼンタ表示テンプレートの開発者は、異なるプロパティ値がロードされたことに気付いた場合、テンプレートのパフォーマンスを最適化できます。たとえば、一般的なリストの表示テンプレートの場合、ノードを最初に取得したときに即座にロードされるプロパティのみを参照して、後で必要なときにロードされるプロパティを避けると、より高速にレンダリングされます。

2番目の考慮点は、ノードの取得方法(検索または親IDによるフェッチ)によって決まります。検索(「問合せの結果」など)のためのノード取得時には即座にロードされるプロパティが、他の取得方法(「フォルダの下のコンテンツ」など)では後でロードされる可能性があります。表29-8は、取得メカニズム別に、ノード取得時にノード・プロパティが即座にロードされるかどうかを示しています。

表29-8にリストされたノード・プロパティの詳細は、Oracle WebCenter Content Idocスクリプト・リファレンス・ガイドを参照してください。

表29-8 ノード取得メカニズム別のノード・プロパティのロード

OCSグローバル・プロファイル・プロパティ	ノードの初回取得時にロードするか
	親IDによる取得(「フォルダの下のコンテンツ」)	検索(「問合せの結果」)	UUIDによる取得(「単一のコンテンツ・アイテム」と「アイテムのリスト」)
VaultFileSize	N	Y	Y
dCheckoutUser	Y	N	Y
dCreateDate	Y	Y	Y
dDocAccount	Y	Y	Y
dDocAuthor	Y	Y	Y
dDocName	Y	Y	Y
dDocTitle	Y	Y	Y
dDocType	Y	Y	Y
dFormat	Y	Y	Y
dID	Y	Y	Y
dInDate	Y	Y	Y
dIsCheckedOut	Y	N	Y
dOutDate	Y	Y	Y
dReleaseDate	Y	N	Y
dReleaseState	Y	N	Y
dRevClassID	Y	N	Y
dRevLabel	Y	Y	Y
dRevRank	Y	N	Y
dRevisionID	Y	Y	Y
dSecurityGroup	Y	Y	Y
dStatus	Y	N	Y
dWebExtension	Y	Y	Y
dWorkflowState	N	N	Y
idcPrimaryFile	Y	Y	Y
idcRenditions	N	N	Y
xCollectionID	Y	Y	Y
xComments	Y	Y	Y
xForceFolderSecurity	Y	Y	Y
xHidden	Y	Y	Y
xInihibitUpdate	Y	Y	Y
xReadOnly	Y	Y	Y