対話管理ガイド

プレースホルダ

プレースホルダは、JSP に 1 つのコンテンツ項目 (BEA の仮想コンテンツリポジトリから動的に取得されたコンテンツ項目) を表示します。プレースホルダで表示するコンテンツは、プレースホルダに定義されているクエリを使用して取得します。

プレースホルダは、クエリを格納し、一度に 1 つのクエリを実行し、そのクエリで取得されたコンテンツ項目の 1 つを表示するバケットと考えることができます。プレースホルダは 2 つの部分で構成されます。1 つは、WebLogic Workshop で作成するプレースホルダファイル、もう 1 つはそれに対応する、処理を実行する JSP タグです。

図 4-1 は、「foo」というプレースホルダファイルと、そのプレースホルダファイルを参照する JSP タグを示しています。

図 4-1 プレースホルダを構成する 2 つの部分 : プレースホルダファイルと JSP タグ

この章では、プレースホルダにクエリを追加する方法と、実行するクエリと表示するコンテンツ項目をプレースホルダが決定する方法について説明します。

この章の内容は以下のとおりです。

プレースホルダが実行するクエリ

プレースホルダは、デフォルトクエリとキャンペーンクエリの 2 つのタイプのクエリを実行できます。どちらのタイプのクエリも構造はまったく同じですが、別の場所から実行されます。

デフォルトクエリ - WebLogic Workshop でプレースホルダファイルを作成するときに、1 つまたは複数のクエリをそのプレースホルダファイルに追加することもできます。ここで追加したクエリは、WebLogic Workshop で変更または削除しない限り、このプレースホルダに含まれたままになります。これが、デフォルトクエリです。デフォルトクエリは、ポータルでそのポートレットまたは JSP を表示しているのが誰であっても、仮想コンテンツリポジトリからコンテンツを返します。この場合はプレースホルダにコンテンツ項目が必ず表示されるので、プレースホルダにはデフォルトクエリを設定することをお勧めします。

プレースホルダを含むページをユーザがロードするたびに、プレースホルダはデフォルトクエリを 1 つ実行できます。たとえば、特定のシェルのヘッダに、プレースホルダを含む JSP ファイルを定義します。そのプレースホルダにデフォルトクエリが含まれている場合、ユーザがデスクトップを表示または更新するたびに、ヘッダに異なるコンテンツが表示されます。

キャンペーンクエリ - WebLogic Workshop でキャンペーンを作成する場合に、デスクトップの特定の場所にキャンペーン固有のコンテンツが表示されるようにすることができます。キャンペーンはプレースホルダを使用して、パーソナライズされたコンテンツを表示します。キャンペーンにコンテンツアクションを定義するときに、手順の 1 つとして、定義したキャンペーンクエリを実行する既存のプレースホルダを選択します。ユーザが特定のユーザセグメントに属するデスクトップにログインするなど、特定のアクション (イベント) が発生すると、キャンペーンによってキャンペーンコンテンツクエリが動的に配置されます。

キャンペーンによってプレースホルダにクエリが配置された場合はデフォルトクエリが実行されないように設定できます。

図 4-2 は、プレースホルダがデフォルトクエリまたはキャンペーンクエリから取得した画像をページ上のどこに表示するかを示しています。これは、クエリによって BEA の仮想コンテンツリポジトリから取得された画像です。プレースホルダはさまざまな係数を使用して、まずどのクエリを実行するかを決定し、次に取得されたどのコンテンツ項目を表示するかを決定します。

図 4-2 デフォルトコンテンツとキャンペーンコンテンツを表示できるプレースホルダ

プレースホルダで表示できるコンテンツのタイプ

プレースホルダは、ドキュメントの MIME タイプ属性を使用してブラウザに必要な HTML タグを生成します。デフォルトでは、プレースホルダは次の MIME タイプについてのみ、適切な HTML タグを生成します。

画像 - このタイプのドキュメントでは、プレースホルダは、画像を表示するのにブラウザが必要とする属性を含む <img> タグを生成する。画像をクリッカブルにする場合は、ターゲット URL およびその他のリンク関連情報を、コンテンツ管理システム内で ad 属性として指定する必要があります。
Shockwave ファイル - このタイプのドキュメントでは、プレースホルダは Windows 上の Microsoft Internet Explorer がファイルの表示に使用する <OBJECT> タグと、Netscape 互換のプラグインをサポートするブラウザがファイルの表示に使用する <EMBED> タグを生成する。<OBJECT> および <EMBED> タグの属性は、コンテンツ管理システム内で指定できます。
XHTML (フラグメントまたはドキュメント全体) - このタイプのドキュメントでは、プレースホルダが JSP に直接テキストを渡す。

その他の MIME タイプをプレースホルダで使用する場合は、WebLogic Workshop ヘルプシステムの「その他の MIME タイプをサポートする」 (http://edocs.beasys.co.jp/e-docs/workshop/docs81/doc/ja_JP/portal/buildportals/mimetypes.html) を参照してください。

プレースホルダで使用するコンテンツを設定する

コンテンツをプレースホルダでより便利に使用できるように、コンテンツ項目に追加できる特定のプロパティがあります。詳細については、このガイドの「コンテンツの設定」を参照してください。

プレースホルダの作成

プレースホルダを作成するには、WebLogic Workshop でプレースホルダファイルを作成し、それに対応する <ph:placeholder> JSP タグを、関連するすべての JSP で使用します。各 <ph:placeholder> JSP タグに「name」属性を指定して、WebLogic Workshop で作成したプレースホルダを参照する必要があります。

プレースホルダの作成手順については、WebLogic Workshop ヘルプシステムの以下のトピックを参照してください。

「プレースホルダを作成する」 (http://edocs.beasys.co.jp/e-docs/workshop/docs81/doc/ja_JP/portal/buildportals/createPlaceholders.html)
「<ph:placeholder> Tag」 (http://edocs.beasys.co.jp/e-docs/workshop/docs81/doc/ja_JP/portal/taglib/www.bea.com/servers/portal/tags/placeholder/placeholder.html)

コンテンツクエリを構築する

WebLogic Portal は、強力なコンテンツクエリを構築するための高度なコンテンツクエリ機能を備えています。詳細については、WebLogic Workshop ヘルプシステムの「条件式を使用してコンテンツクエリを構築する」 (http://edocs.beasys.co.jp/e-docs/workshop/docs81/doc/ja_JP/portal/buildportals/contentExpression.html) を参照してください。

JSP にプレースホルダを追加する

WebLogic Workshop でプレースホルダファイルを作成した後、WebLogic Workshop でこのプレースホルダを JSP に追加します。いくつかの方法があります。

[アプリケーション] ウィンドウから、開いているポータルファイルのページ上にプレースホルダをドラッグする。この場合、次の 3 つの処理が行われます。

このプレースホルダを表示するポートレットをすばやく作成できるポートレットウィザードが起動する。
作成されたポートレットが自動的にポータルページに追加される。
このプレースホルダに対応する JSP ファイルが自動的に作成される。JSP ファイルには、プレースホルダの JSP タグが含まれ、「name」属性にはプレースホルダの名前が自動的に入力されます。タグライブラリのインクルード文が自動的に追加されます。

プレースホルダを追加する JSP を開き、[アプリケーション] ウィンドウから [デザインビュー] または [ソースビュー] の JSP にプレースホルダをドラッグする。JSP タグが自動的に追加され、「name」属性にはプレースホルダの名前が自動的に入力され、タグライブラリのインクルード文が自動的に追加されます。図 4-1 を参照してください。
[パレット] ウィンドウから <ph:placeholder> JSP タグ ([Portal Content Placeholder] カテゴリにある) を、開いている JSP にドラッグし、タグの「name」属性を手動で入力する。タグライブラリのインクルード文は自動的に追加されます。

プレースホルダがクエリとコンテンツを選択する方法

プレースホルダが表示するコンテンツを選択するときは 2 つの処理が行われます。この節では、以下の事項について説明します。

プレースホルダが実行するクエリを選択する方法

クエリの実行後、プレースホルダがそのクエリ結果から表示するコンテンツ項目を選択する方法

1. プレースホルダがクエリを選択する方法

プレースホルダにデフォルトクエリを追加するか、WebLogic Workshop でキャンペーンクエリを作成した場合、各クエリに優先度 (最高、高、中、低、最低) を割り当てることができます。優先度が高いクエリほど、実行される可能性が他のクエリより高くなります。

クエリがドキュメントを検出しなかった場合、プレースホルダは別のクエリを選択して実行します。

キャンペーンクエリがある場合はデフォルトクエリを実行しないように定義することもできます。詳細については、「プレースホルダでのデフォルトクエリとキャンペーンクエリの併用」を参照してください。

2. プレースホルダが表示するコンテンツ項目を選択する方法

クエリの対象範囲、およびコンテンツ管理システム内のドキュメントの数によっては、クエリが複数のコンテンツ項目を返す場合があります。デフォルトでは、プレースホルダは表示するコンテンツ項目をランダムに選択します。この選択を制御するために、adWeight というプロパティをコンテンツ項目に追加できます。このガイドの「コンテンツの設定」を参照してください。

コンテンツ項目に割り当てる adWeight の数値が大きいほど、そのコンテンツ項目がクエリで取得されたときにプレースホルダで表示される可能性が高くなります。

プレースホルダでのデフォルトクエリとキャンペーンクエリの併用

特に複数のキャンペーンで 1 つのプレースホルダを使用してコンテンツを表示する場合、プレースホルダに含まれるクエリが多すぎることがあります。クエリを削除する特定の操作を行わない限り、プレースホルダに追加できるキャンペーンクエリの数に制限はありません。この節では、不要なクエリをクリアする方法と、プレースホルダに表示されるコンテンツをさらに高度に制御する方法を説明します。

プレースホルダにデフォルトクエリを作成する場合、プレースホルダにキャンペーンクエリがあるときはデフォルトクエリを実行しないように指定できる。WebLogic Workshop で、プレースホルダファイルを開き、デフォルトクエリを選択します。[プロパティエディタ] ウィンドウで、[混合グローバル] プロパティを「false」に設定します。これで、キャンペーンクエリがあるときはデフォルトクエリが実行されません。
キャンペーンにコンテンツアクションを作成するときに、[このキャンペーンで配置された既存のコンテンツを削除する] または [このキャンペーンで配置された既存のコンテンツをすべて削除する] オプションを使用すると、プレースホルダに一度に格納されるクエリの数を最小化できる。
キャンペーンコンテンツアクションの期間 (存続時間) を適切な時間に設定して、それ以降はコンテンツアクションがプレースホルダにクエリを追加しないようにすることができる。
プレースホルダに表示するキャンペーンコンテンツをより厳密に制御するには、発生するイベントごとにコンテンツアクションを作成する。プレースホルダに新しいコンテンツをローテーションで表示する場合は、前の 3 つの方法を使用してください。
プレースホルダに追加されたコンテンツをクリアするには、リセット機能を使用して、前に配置されたコンテンツまたは広告バケットをリセットする。リセット機能については、このガイドの「キャンペーン」の章の「キャンペーンのリセット」を参照してください。

プレースホルダに代わる <ad:adTarget> の使用

JSP にコンテンツ項目を表示するには <ad:adTarget> JSP タグを使用することもできます。このタグは、プレースホルダとは異なり、定義ファイルを使用しません。タグの「query」属性を使用してクエリを追加するだけです。クエリは 1 つまたは複数のコンテンツ項目 (そのプレースホルダで表示できるタイプのコンテンツ項目) を取得し、<ad:adTarget> タグは <ph:placeholder> タグと同じ方法で、表示するコンテンツ項目を選択します。キャンペーンは <ad:adTarget> タグにはクエリを挿入しないため、このタグではパーソナライズされたコンテンツは表示できません。

クエリ構築の詳細については、WebLogic Workshop ヘルプシステムの「条件式を使用してコンテンツクエリを構築する」 (http://edocs.beasys.co.jp/e-docs/workshop/docs81/doc/ja_JP/portal/buildportals/contentExpression.html) を参照してください。

WebLogic Workshop ヘルプシステムの「<ad:adTarget> Tag」 (http://edocs.beasys.co.jp/e-docs/workshop/docs81/doc/ja_JP/portal/taglib/www.bea.com/servers/portal/tags/ad/adTarget.html) を参照してください。