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

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

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

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

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

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

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

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

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

• 第28.5項「コンテンツ・プレゼンタ表示テンプレートの使用」

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

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

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

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

28.2 コンテンツ・プレゼンタ表示テンプレートとは

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

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

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

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

各コンテンツ・アイテムは、コンテンツ・サーバーのリポジトリで定義された特定コンテンツ・タイプに関連付けらます。コンテンツ・タイプはコンテンツ・アイテムのプロパティを定義します。コンテンツ・タイプはコンテンツ・サーバーのプロファイル定義とSite Studioのリージョン定義にマップできます。

ヒント: コンテンツ・プレゼンタADFテンプレートを使用して、Site Studioリージョン・テンプレートではなくSite StudioとWebCenter Portalを統合することをお薦めします。推奨フローは次のとおりです。 Site Studioでリージョン定義を開発します。 JDeveloperを使用して、リージョン定義を参照するADFテンプレートを開発します。 コンテンツ・プレゼンタを使用して、コンテンツをレンダリングし、ユーザーがコンテンツを提供できるようにします。

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

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

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

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

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

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

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

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

複数コンテンツ・アイテムの表示には、複数のコンテンツ・アイテムをアコーディオン形式で表示するアコーディオン・ビューを始め、いくつかのオプションが提供されています。この形式では、図28-2に示すように各アイテムを展開して詳細を表示できます。アコーディオン・ビューでは、常に1つのアイテムが開きます。つまり、すべてのアイテムを閉じることはできません。いつでも、どの単一アイテムを開くかのみを変更できます。

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

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

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

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

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

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

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

• 第28.4.1項「概要」

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

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

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

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

28.4.1 概要

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

JSPタグ	説明	例
contentTemplateDef	必須。単一コンテンツ・アイテムのテンプレートを定義します。 属性: var - この表示テンプレートによりレンダリングされるコンテンツ・ノードを指定します。テンプレート定義コードで、第28.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で新しいFrameworkアプリケーションを開くまたは作成し、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. コンポーネント・パレット最上部のドロップダウン・リスト(図28-3)で、次の手順に従います。

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

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

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

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

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

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

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

例28-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>

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

例28-2 別のプレス・リリース・ドキュメントのサンプル・コンテンツ・プレゼンタ・テンプレート

<?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>

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

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

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

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

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

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

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

JSPタグ	説明	例
contentListTemplateDef	必須。複数コンテンツ・アイテムのテンプレートを定義します。 属性: var - この表示テンプレートによりレンダリングされるコンテンツ・ノードを指定します。テンプレート定義コードで、第28.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. 第28.4.2項「単一アイテムの表示テンプレートの定義」の手順1から3の説明に従って、JDeveloperでJSFFファイルを作成し、コンポーネント・パレットを開きます。

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

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

例28-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>

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

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

第28.4.2項「単一アイテムの表示テンプレートの定義」および第28.4.3項「複数アイテムの表示テンプレートの定義」で説明したコンテンツ・プレゼンタ表示テンプレートを定義するときに、次の表で説明するEL式を使用します。これらの式は、表28-1および表28-2で説明したJSPタグとともに使用されます。

この項には次のサブセクションが含まれます:

• 第28.4.4.1項「コンテンツ・アイテムの基本情報の取得」

• 第28.4.4.2項「コンテンツ・アイテムのプロパティおよび値の操作」

• 第28.4.4.3項「コンテンツ・アイテムのアイコンおよびURLの操作」

• 第28.4.4.4項「グループ・スペース情報の操作」

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

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

表28-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}のショートカットです。

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

表28-4および表28-5で説明するEL式を使用して、コンテンツ・アイテムのノード・プロパティおよびプロパティ値でアクションを実行します。

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

表28-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)が付きます。第28.4.7項「カスタム・ビューにおけるSite Studioリージョン要素の参照」も参照してください。

表28-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}

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

表28-6および表28-7に、コンテンツ・アイテムとプロパティに関連付けられたアイコンおよびURLを操作するEL式を示します。

表28-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}" />

表28-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"/>

28.4.4.4 グループ・スペース情報の操作

表28-8および表28-9に、コンテンツ・プレゼンタ・テンプレートでのグループ・スペース情報の操作に使用できるEL式を示します。

表28-8 基本グループ・スペース情報のEL式

EL式	説明
#{spaceContext.currentSpace.metadata.createdBy} #{spaceContext.space[spaceName].metadata.createdBy}	現在のグループ・スペースまたは指定したグループ・スペースを作成したユーザーを返します。
#{spaceContext.currentSpace.metadata.creationDate} #{spaceContext.space[spaceName].metadata.creationDate}	現在のグループ・スペースまたは指定したグループ・スペースが作成された日時を表すjava.util.Calendarオブジェクトを返します。
#{spaceContext.currentSpace.metadata.customAttributes[attributeName]} #{spaceContext.space[spaceName].metadata.customAttributes[attributeName]}	スペースの特定のカスタム属性の値を返します。attributeNameは属性の名前です。
#{spaceContext.currentSpace.metadata.defaultLanguage} #{spaceContext.space[spaceName].metadata.defaultLanguage}	現在のスペースまたは指定したスペースのデフォルト言語を返します。
#{spaceContext.currentSpace.metadata.description} #{spaceContext.space[spaceName].metadata.description}	現在のスペースに関連付けられた説明と表示名を、スペースが作成された言語で返します。スペース名が翻訳されている場合、翻訳された名前は表示されません。 例: #{spaceContext.space['FinanceProject'].metadata.description} 財務活動に従事するすべての複合チームを評価します。
#{spaceContext.currentSpace.metadata.displayName} #{spaceContext.space[spaceName].metadata.displayName}	現在のスペースまたは指定したスペースに関連付けられた表示名を、スペースが作成された言語で返します。スペース名が翻訳されている場合、スペースが作成された名前が表示されます。 例: Web20Spaceというグループ・スペースの表示名が「Web 2.0 Space」である場合: #{spaceContext.space['Web20Space'].metadata.displayName} は、「Web 2.0 Space」と評価されます。
#{spaceContext.currentSpace.metadata.guid} #{spaceContext.space[spaceName].metadata.guid}	現在のスペースまたは指定したスペースに関連付けられた一意のIDを返します。
#{spaceContext.space[spaceName].metadata.icon} #{spaceContext.currentSpace.metadata.icon}	現在のスペースまたは指定したスペースに関連付けられたアイコンへのURLを返します。
#{spaceContext.currentSpace.metadata.keywords} #{spaceContext.space[spaceName].metadata.keywords}	現在のスペースまたは指定したスペースに関連付けられた検索可能なキーワードのカンマ区切りリストを返します。
#{spaceContext.currentSpace.metadata.lastUpdatedDate} #{spaceContext.space[spaceName].metadata.lastUpdatedDate}	現在のグループ・スペースまたは指定したグループ・スペースが最後に更新された日時を表すjava.util.Calendarオブジェクトを返します。
#{spaceContext.space[spaceName].metadata.logo} #{spaceContext.currentSpace.metadata.logo}	現在のスペースまたは指定したスペースのロゴに関連付けられたイメージへのパスを返します。
#{spaceContext.currentSpace.metadata.name} #{spaceContext.space[spaceName].metadata.name}	通常、スペースのバックエンドでプリティURLで使用される、現在のスペースまたは指定したスペースの名前を返します。
#{spaceContext.currentSpace.metadata.groupSpaceURI} #{spaceContext.space[spaceName].metadata.groupSpaceURI}	現在のスペースまたは指定したスペースのプリティURLを返します。
#{spaceContext.currentSpace.metadata.closed} #{spaceContext.space[spaceName].metadata.closed}	スペースが閉じられているかどうかを示すブール値を返します。
#{spaceContext.currentSpace.metadata.discoverable} #{spaceContext.space[spaceName].metadata.discoverable}	ユーザーがスペースの存在を検索または「マイ・スペース」のリストからの取得によって検出できるかどうかを示すブール値を返します。
#{spaceContext.currentSpace.metadata.offline} #{spaceContext.space[spaceName].metadata.offline}	スペースが遮断されているかどうかを示すブール値を返します。
#{spaceContext.currentSpace.metadata.publishRSS} #{spaceContext.space[spaceName].metadata.publishRSS}	スペースがRSSフィードを公開しているかどうかを示すブール値を返します。
#{spaceContext.currentSpace.metadata.selfRegistration} #{spaceContext.space[spaceName].metadata.selfRegistration}	ユーザーによるスペースのサブスクライブが許可されているかどうかを示すブール値を返します。
#{spaceContext.currentSpace.metadata.unsubscriptionApprovalRequired} #{spaceContext.space[spaceName].metadata.unsubscriptionApprovalRequired}	現在のスペースまたは指定したスペースからのサブスクライブ解除に承認が必要かどうかを表すブール値を返します。

表28-9 グループ・スペースUI情報のEL式

EL式	説明
#{spaceContext.space[spaceName].metadata.uiMetadata.gsSiteTemplateId} #{spaceContext.currentSpace.metadata.uiMetadata.gsSiteTemplateId}	現在のスペースまたは指定したスペースに関連付けられたページ・テンプレートのIDを返します。
#{spaceContext.space[spaceName].metadata.uiMetadata.rcForGSPages} #{spaceContext.currentSpace.metadata.uiMetadata.rcForGSPages}	現在のスペースまたは指定したスペースに関連付けられたリソース・カタログのIDを返します。
#{spaceContext.space[spaceName].metadata.uiMetadata.rcForGSSiteTemplates} #{spaceContext.currentSpace.metadata.uiMetadata.rcForGSSiteTemplates}	現在のスペースのページ・テンプレートに関連付けられたリソース・カタログのIDを返します。
#{spaceContext.space[spaceName].metadata.uiMetadata.gsSiteStructureId} #{spaceContext.currentSpace.metadata.uiMetadata.gsSiteStructureId}	現在のスペースに関連付けられたナビゲーション・モデルのIDを返します。
#{spaceContext.space[spaceName].metadata.uiMetadata.skin} #{spaceContext.currentSpace.metadata.uiMetadata.skin}	現在のスペースに関連付けられたADF Facesスキン・ファミリを返します。
#{spaceContext.space[spaceName].metadata.uiMetadata.footerHidden} #{spaceContext.currentSpace.metadata.uiMetadata.footerHidden}	スペースのフッターが非表示かどうかを表すブール値を返します。
#{spaceContext.space[spaceName].metadata.uiMetadata.copyrightMessage} #{spaceContext.currentSpace.metadata.uiMetadata.copyrightMessage}	スペースで使用する著作権メッセージを返します。
#{spaceContext.space[spaceName].metadata.uiMetadata.privacyPolicyUrl} #{spaceContext.currentSpace.metadata.uiMetadata.privacyPolicyUrl}	従っているプライバシ・ポリシー・ドキュメントのURLを返します。

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

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

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

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

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

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

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

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

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

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

   
   

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

   
   

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

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

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

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

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

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

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

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

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

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

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

例28-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)を参照してください。

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

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

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

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

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

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

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

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

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

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

この項では、ポータル・リソースとしてコンテンツ・プレゼンタ表示テンプレートをエクスポートする方法を説明します。この手順は、コンテンツ・プレゼンタ表示テンプレートをSpacesまたはデプロイ済Frameworkアプリケーションおよび実行時のコンテンツ・プレゼンタに追加するための前提条件です。

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

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

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

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

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

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

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

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

   
   

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

     
     

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

     
     

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

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

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

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

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

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

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

注意: コンテンツ・プレゼンタ表示テンプレートを開発した設計時のFrameworkアプリケーションとWebCenter Portal: Spacesアプリケーションで、同じリポジトリ接続名と詳細にする必要があります。 また、表示テンプレートの外部ファイルへの参照は、絶対パスまたは相対パス参照で指定する必要があります。第28.4.6項「表示テンプレートにおける外部ファイルの参照」を参照してください。

注意: Spacesアプリケーション内の特定のスペースのスコープからのアップロードは、Spaces管理ツールのアプリケーション・スコープからのアップロードとは異なります。詳細は、第55.3.4項「JDeveloperでのSpacesリソースの編集」の、アプリケーションレベル・リソースとスペースレベル・リソースの項を参照してください。

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

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

   Spacesでは、管理者権限が必要です。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   図28-9 「ドキュメント管理」フォルダを開く手順

   
   「図28-9 「ドキュメント管理」フォルダを開く手順」の説明
   
   

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

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

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

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

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

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

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

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

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

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

28.6 実行時の処理

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

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

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

28.6.1 実行時の概要

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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