対話管理ガイド

コンテンツ セレクタの作成

コンテンツ セレクタは、ルールを使用して BEA の仮想コンテンツ リポジトリのコンテンツ項目を特定のグループに提供します。コンテンツ セレクタは、コンテンツを返して、表示します。たとえば、ユーザ プロファイルで「読書好き」として識別されるユーザがログインしたら、コンテンツ セレクタを使用して推薦図書の一覧を表示できます。

開発者は Workshop for WebLogic を使用してコンテンツ セレクタを作成し、更新して、JSP に配置することができます。ポータル管理者は、Administration Console を使用して、ポータルにコンテンツを表示するコンテンツ セレクタを変更します。コンテンツ セレクタにある公開コンテンツと非公開コンテンツの両方を取得できます。コンテンツの公開の詳細については、『コンテンツ管理ガイド』の「BEA リポジトリへのコンテンツの追加」を参照してください。

認証済み (ログイン済み) ユーザでなくてもコンテンツ セレクタの対象にすることができます。たとえば、HTTP リクエストまたはセッションの特定のプロパティの有無や、特定の日付や時刻の条件によって、コンテンツの表示をトリガできます。たとえば、12 月にポータルを訪問し、特定のタイプの Web ブラウザでポータルを表示しているユーザに対して、祝日向けのコンテンツを表示できます。

ただし、認証済みのユーザ (および追跡対象の匿名ユーザ) には、ユーザに関連したプロファイル情報があり、この情報を使用して、パーソナライズされたコンテンツを提供できます。「読書好き」は、このタイプのユーザ プロファイルの一例です。

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

コンテンツの表示の設定

コンテンツ セレクタは、コンテンツ プロパティ (通常はテキスト値または数値) を取得します。たとえば、コンテンツ セレクタで本に関する情報を取得できます。書籍コンテンツには、タイトル、作者、出版日、ISBN、出版社の Web サイトへの URL など、多数のプロパティを割り当てることができます。コンテンツ セレクタを使用して、箇条書きのタイトル一覧を表示し、各タイトルを出版社の Web サイトにリンクすることもできます。このリストとリンクは、コンテンツ プロパティのテキスト値のみを使用して作成されます。

書籍コンテンツには、書籍の表紙の画像を格納するバイナリ プロパティも含まれる場合があります。コンテンツ セレクタでは、ShowProperty サーブレットを使用して、バイナリ プロパティも表示できます (実画像の表示)。詳細については、「プレースホルダ ファイルの作成」を参照してください。コンテンツ セレクタで表示できるバイナリ コンテンツのタイプは、設定した MIME タイプによって決まります。デフォルトでは、WebLogic Portal はイメージやその他のタイプのファイルを表示するための MIMEがサポートされています。その他のタイプの詳細については、「プレースホルダでのその他の MIME タイプの表示」を参照してください。

コンテンツ セレクタの作成

コンテンツ セレクタは、エンタープライズ アプリケーションの範囲内にあるので、エンタープライズ アプリケーション内の JSP にコンテンツ セレクタを含めることができます。

コンテンツ セレクタは、次の 2 つの部分で構成されます。

コンテンツ セレクタを作成するときは、次のガイドラインに従います。

<img> HTML タグのソース パスには、仮想コンテンツ リポジトリのコンテンツ項目のパスを使用します。パスには、バイナリ ファイルを表示するための ShowProperty サーブレットが含まれます。node.getPath() メソッドの node は、<utility:forEachInArray> タグの id 属性に格納された特定のコンテンツ項目です。<utility:forEachInArray> id 属性値が foo の場合、メソッドは foo.getPath() のように表示されます。

この節では、次のトピックについて説明します。

コンテンツ セレクタ ファイルの作成

コンテンツ セレクタ ファイルを作成するには、以下の手順を実行します。

図 6-3 は、classic.sel というコンテンツ セレクタ ファイルを示します。コンテンツ セレクタをトリガする条件は、Americas という値を持つプロパティ セット SalesRegion を持つユーザです。取得するコンテンツは、名前に IRACampaign を含む任意のバイナリ ファイル コンテンツです。

認証済みユーザでなくてもコンテンツ セレクタの対象にすることができます。

条件式を使用するコンテンツ クエリの構築

WebLogic Portal Administration Console で WebLogic Portal の条件式の言語を使用して、コンテンツ クエリを構築することができます。コンテンツに関連する JSP タグから Query の詳細ウィンドウにより、プレースホルダ、キャンペーン、およびコンテンツ セレクタを作成するときにクエリを構築することができます。

クエリは、コンテンツ プロパティとユーザが入力した値を比較します。クエリには、<property><comparator><value> の 3 つの部分があります。

比較の結果が true の場合、一致するすべてのコンテンツ項目が取得されます。

次に例を示します。

通常、クエリは and (&&) および or (||) ロジックを使用する複数の句で構成されます。次に例を示します。

この節では、次のトピックについて説明します。

クエリを構築するルールの使用

クエリを構築する場合は、以下のルールを使用します。

プロパティの選択

コンテンツには、以下の 2 つのタイプのプロパティがあります。

クエリでは、両方のプロパティを使用することができます。

ユーザ定義のコンテンツ プロパティは、WebLogic Portal Administration Console で定義される types というセットに格納されます。たとえば、Book というタイプを作成し、title、author、pub_date、isbn などのプロパティを追加することができます。

システム コンテンツ プロパティは、コンテンツ項目をコンテンツ リポジトリに追加するときに、すべてのコンテンツ項目に自動的に関連付けられ、コンテンツ項目の値が自動的に割り当てられます。システム プロパティを使用して、公開済みコンテンツや非公開コンテンツを取得することができます。これらのプロパティは、com.bea.content.expression.Search クラスにもリストされ、表 6-1 に表示される項目を含みます。

クエリを構築する場合、引用符なしでプロパティ名を指定することができます。たとえば、title <comparator> <value> のように指定します。ただし、プロパティ名にスペース、二重引用符、またはダッシュ記号が含まれる場合は、プロパティ名を toProperty() 内に囲む必要があります。たとえば、toProperty('Favorite Author') <comparator> <value> のように指定します。

クエリは、すべてのコンテンツ タイプのプロパティ名を探して、プロパティ値を持つコンテンツ項目を返します (コンテンツ項目がクエリの条件を満たす場合)。ただし、特定のタイプのプロパティを分離することもできます。たとえば、両方とも title プロパティを持つ book タイプと article タイプを使用する場合、cm_objectClass プロパティを使用して、book タイプ内の特定の title を持つコンテンツ項目を取得することができます。

たとえば、title likeignorecase '*Adventure' && cm_objectClass = 'books' のように指定します。

比較演算子の使用

比較演算子は、クエリのプロパティと入力した値を比較するロジックを持っています。コンテンツ項目がクエリの条件と一致する場合には、そのコンテンツ項目が返されます。表 6-2 に、クエリで使用できる比較演算子を示します。

値の入力

値は、クエリが返す必要のあるコンテンツを表します。クエリに値を入力することにより、コンテンツ項目に格納された値に基づいて、どのコンテンツを取得し、または無視するかをクエリに指示します。

たとえば、title というプロパティを持つ book というコンテンツ タイプを使用する場合、book タイプに関連付けられるすべてのコンテンツ項目は title フィールドを持ちます。各 title 値はユニークであるため、クエリでユニークな値を入力して、特定のコンテンツ項目を取得したり、比較演算子を使用して、特定のコンテンツ項目を無視することができます。

次の 2 つの方法で値を入力できます。

複雑なクエリの作成

クエリ句を and (&&) ロジックおよび or (||) ロジックによって結合し、数式と同様に括弧を使用して評価の順番を制御することにより、複数の独立したクエリ句を組み合わせることができます。これにより、複雑なクエリを作成することができます。また、括弧で囲まれたグループの前に感嘆符を使用して、複雑なクエリに not ロジック (!) を含めることもできます。

クエリの詳細については、『コンテンツ管理ガイド』を参照してください

クエリのサンプルの使用

図 6-4 は、BEA の仮想コンテンツ リポジトリに格納されたブックのプロパティ セットを示します。

表 6-3 のクエリの例は、サンプル コンテンツ項目のプロパティを使用し、各クエリのサンプルの説明は、クエリがコンテンツ項目を取得するかどうかを示します。

JSP タグを使用するコンテンツ セレクタ ファイルの表示

コンテンツ セレクタ ファイルを作成したら (「コンテンツ セレクタ ファイルの作成」を参照)、<pz:contentSelector> JSP タグを使用してコンテンツを表示する必要があります。図 6-3 に示すように、以下の JSP タグは classic コンテンツ セレクタを使用します。

<pz:contentSelector rule="classic" id="nodes"/>

JSP タグには、2 つの必須属性があります。

他にも、<pz:contentSelector> タグに設定できる属性があります。クラスの詳細については、「JSP Tag Javadoc」を参照してください。

JSP へのコンテンツ セレクタの追加

Workshop for WebLogic でコンテンツ セレクタ ファイルを作成したら、以下の 3 つの方法のいずれかを使用して、Workshop for WebLogic の JSP にコンテンツ セレクタを追加することができます。

コンテンツ セレクタのポータル ファイルへのドラッグ

コンテンツ セレクタを開いているポータル ファイルにドラッグするには、以下の手順を実行します。

複数のコンテンツ セレクタの使用

限定度が最も高いものから順に一致させる場合や、コンテンツ セレクタが相互に排他的である場合は、条件ロジックで複数のコンテンツ セレクタを使用することで、階層的にパーソナライズされたコンテンツを取得できます。コード リスト 6-2 に、パーソナライズされたコンテンツに対して複数のコンテンツ セレクタを使用する方法を示します。

<%@ taglib uri="content.tld" prefix="cm"%>
<%@ taglib uri="http://www.bea.com/servers/p13n/tags/utility" prefix="utility"%>
<%@ taglib uri="http://www.bea.com/servers/portal/tags/ad" prefix="ad"%>
<%@ taglib uri="http://www.bea.com/servers/portal/tags/personalization"
   prefix="pz"%>
<pz:contentSelector rule="FemaleContent" id="nodes" sortBy="cm_nodeName desc"/>
<% if (nodes == null || nodes.length <= 0) { %>
<pz:contentSelector rule="MaleContent" id="nodes" sortBy="cm_nodeName desc"/>
<% }%>
<% if (nodes == null || nodes.length <= 0) { %>
   Sorry, you don't get a free lunch today.
<% }%>
   Found <%=nodes.length%> Node(s):
<dl>
<utility:forEachInArray array="<%=nodes%>" id="node"
   type="com.bea.content.Node">
<dt><cm:getProperty id="node" name="title" conversionType="html"/></dt>
<dd><ad:render id="node" /></dd>
</utility:forEachInArray>
</dl>

コンテンツ セレクタに代わる <pz:div> タグの使用

<pz:div> JSP タグは、インライン HTML パーソナライゼーションを提供できます。インライン コンテンツのセットを JSP に挿入し、このタグでラップできます。このタグは rule 属性を使用します。この属性には既存のユーザ セグメント名を指定できます。該当するユーザ セグメントのメンバーだけがインライン コンテンツを表示できます。たとえば、Workshop for WebLogic で、任意のユーザを bookfan ユーザ プロファイルのプロパティ セットの値が true であるメンバーにする bookfanUserSegment.seg というユーザ セグメントを作成しました。以下のサンプル コードは、この方法を示しています。

<pz:div rule="bookfanUserSegment">
   <p>Only users who are book nerds will see this text!</p>
</pz:div>

ユーザ セグメント ルール (条件) は、コンテンツ セレクタで使用するルールと同じです。したがって、<pz:div> タグは、ほぼ同じレベルのパーソナライゼーションを提供します。相違点は、コンテンツ セレクタでは仮想コンテンツ リポジトリからコンテンツを取得しますが、<pz:div> タグでは JSP 内にインライン コンテンツが含まれることです。

コンテンツ セレクタ クエリの削除

コンテンツ セレクタ クエリを削除すると、そのクエリは Workshop for WebLogic および Administration Console から削除されます。

開発者がコンテンツ セレクタのクエリを削除するには、以下の手順を実行します。

コンテンツ セレクタの削除

コンテンツ セレクタを削除すると、そのコンテンツ セレクタは Workshop for WebLogic と Administration Console から削除されます。

コンテンツ セレクタを削除するには、以下の手順を実行します。

コンテンツ セレクタの変更

以下の方法を使用して、コンテンツ セレクタが表示するコンテンツを編集できます。