第 16 章登録サービスの管理

登録サービスを利用することで、ユーザーは多くの情報を網羅する興味対象のプロファイルを作成できます。このリリースでサポートされる情報ソースには、カテゴリ、ディスカッション、検索可能ドキュメントが含まれます。ユーザーが登録チャネルにアクセスするたびに、プロファイルは最新の情報で更新されます。登録チャネルは、ユーザーが定義したカテゴリ別ドキュメントやディスカッションのプロファイル項目と一致する関連情報の項目数を要約します。

指定日数の範囲内にターゲットカテゴリで一致する新規ドキュメントの検索とカウント

指定日数の範囲内にディスカッションで一致する新規関連コメントの検索とカウント

保存されている検索に対するドキュメントの検索とカウント

結果は、一致情報の数を示すリンクとしてプロファイルエントリに表示されます。ユーザーがこのリンクをクリックすると、その一致自体の詳細が表示されます。

カテゴリ登録では、ユーザーがリンクをクリックすると検索チャネルが表示されます。ここには、興味対象の特定のドキュメントが標準のカテゴリ検索結果の形式で要約されます。登録チャネルは、より詳細な情報への入り口として機能します。

プロファイラ機能により、指定した興味対象のコンテンツが変更された場合に、メールで通知できます。プロファイラは、Access Manager からユーザーの登録情報を入手し、検索サービスから結果を取り込んで、電子メール通知をユーザーに送信します。プロファイラは、スケジュール設定して組織レベルで特定の時間に実行できます。

登録サービスの管理

管理者は、登録サービスを有効化、または無効化することができます。登録サービスは、次のレベルで管理できます。

ルートレベル

組織レベル

組織ユーザーレベル

ルートレベル

登録サービスのルートレベルの管理では、システム全体を対象に、タイプ別 (カテゴリ、ディスカッション、保存される検索) の登録のデフォルト最大数を設定します。

ルートレベルで登録サービスを定義する

Sun Java System Access Manager 管理コンソールにログインし、「サービス設定」タブを選択します。

左のパネルのリストから「登録」サービスを選択します。

次の項目のデフォルト値を変更します。

カテゴリ登録の最大数: ユーザーが登録できるカテゴリの最大数を指定します。

ディスカッション登録の最大数: ユーザーが登録できるディスカッションの最大数を指定します。

保存される検索の最大数: 保存できる検索の最大数を指定します。

次のボタンを選択します。

指定した値を保存するときは「保存」。

変更した値を元に戻すときは「リセット」。

組織レベル

登録サービスの組織レベルの管理では、システム全体を対象に、タイプ別 (カテゴリ、ディスカッション、保存される検索) の登録のデフォルト最大数を上書きします。

組織レベルで登録サービスを定義する

Sun Java System Access Manager 管理コンソールにログインし、組織の「表示」プルダウンメニューから「サービス」を選択します。

左のパネルのリストから「登録」サービスを選択します。

プロファイラを開始する曜日と時刻 (時間と分) を選択します。

プロファイラを停止する曜日と時刻 (時間と分) を選択します。

次の項目のデフォルト値を変更します。

競合の解決レベル: 「最も高い」、「高め」、「高」、「中」、「低」、「低め」、「最低」に設定できます。

カテゴリ登録の最大数: ユーザーが登録できるカテゴリの最大数を指定します。

ディスカッション登録の最大数: ユーザーが登録できるディスカッションの最大数を指定します。

保存される検索の最大数: 保存できる検索の最大数を指定します。

次のボタンを選択します。

指定した値を保存するときは「保存」。

変更した値を元に戻すときは「リセット」。

「削除」。

組織ユーザーレベル

組織ユーザーレベルでの登録サービスの管理では、ユーザーの登録サービスの設定を編集します。管理者は、ユーザーのサービスデータを次のように管理できます。

ユーザーの登録の更新

ユーザーの登録の削除

ユーザーの登録サービスを管理する

管理コンソールにログインし、組織の「表示」プルダウンメニューから「ユーザー」を選択します。

「ユーザー」を選択します。

右のパネルにユーザー情報が表示されます。

「表示」プルダウンメニューから「登録」を選択します。

ユーザーの登録を編集するためのページが表示されます。

登録の定義を編集します。

登録のタイプごとに、登録を追加または消去します。形式は次のとおりです。

カテゴリ登録

label | target category | scope | lapsed time

各表記の意味は次のとおりです。


label	編集される登録に与えられる論理参照で、文字列として指定する必要があります。必須フィールド。
target category	ABC:DEF:GHI という形式の文字列で指定する必要があります。
scope	検索クエリー。検索演算子を含む有効な検索文字列として指定する必要があります。
lapsed time	次のいずれかの値を指定する必要があります。 0 = すべて 7 = 1 週間以内 30 = 1 ヶ月以内 180 = 6 ヶ月以内 365 = 1 年以内

ディスカッション登録

label | target discussion RD's URL | scope | lapsed time | minimum rating

各表記の意味は次のとおりです。


label	編集される登録に与えられる論理参照で、文字列として指定する必要があります。必須フィールド。
target discussion RD's URL	ディスカッションの URL と一致する文字列を指定する必要があります。ディスカッションの編集時に、ユーザーは登録チャネルを使用してこの値を変更することができません。
scope	検索クエリー。検索演算子を含む有効な検索文字列として指定する必要があります。
lapsed time	次のいずれかの値を指定する必要があります。 0 = すべて 7 = 1 週間以内 30 = 1 ヶ月以内 180 = 6 ヶ月以内 365 = 1 年以内
minimum rating	最小重要度に基づくフィルタです。

保存される検索

label | target category | scope | lapsed time

各表記の意味は次のとおりです。


label	編集される登録に与えられる論理参照で、文字列として指定する必要があります。必須フィールド。
target category	ABC:DEF:GHI という形式の文字列で指定する必要があります。
scope	検索クエリー。検索演算子を含む有効な検索文字列として指定する必要があります。
lapsed time	次のいずれかの値を指定する必要があります。 0 = すべて 7 = 1 週間以内 30 = 1 ヶ月以内 180 = 6 ヶ月以内 365 = 1 年以内

登録チャネルの使用

登録チャネルには、カテゴリ登録、ディスカッション登録、および保存される検索などのタイプ別に登録が表示されます。登録のタイプごとに、次の情報が表示されます。

登録のラベル

特定の登録のヒット件数を示す、登録の詳細情報へのリンク

エンドユーザーは、登録を更新できます。また、登録チャネルの「編集」ボタンを利用して、登録を解除できます。登録の一致するエンドユーザーへの通知は、登録チャネルでグループ化されます。通知は、登録チャネルの更新時に生成されます。

管理者は、チャネルの refreshTime プロパティーを設定して、一定間隔で、コンテンツキャッシュをもとに表示させることができます。エンドユーザーが refreshTime パラメータより短い時間内に登録チャネルのコンテンツを複数回更新しようとしても、コンテンツは実際のデータからは生成されず、キャッシュから読み取られます。refreshTime チャネルのプロパティーの値は、秒単位で設定できます。

ドキュメントが次の条件に一致すると、新規ドキュメントとしてエンドユーザーに通知されます。

登録カテゴリに分類され、検索対象 (scope) と経過時間 (lapsed time) の条件と一致する場合。

登録したディスカッションのコメントであり、検索対象 (scope) と経過時間 (lapsed time) の条件と一致する場合。

基本検索条件または詳細検索条件と一致し、経過時間 (lapsed time) の条件と一致する場合。

カテゴリに登録する

サンプルデスクトップにログインします。

カテゴリには、次の方法で登録できます。

カテゴリを参照する: これには「登録」リンクが含まれます。

カテゴリを示す検索結果: これには「登録」リンクが含まれます。

カテゴリ内の検索結果: これには「カテゴリに登録」リンクが含まれます。

登録するカテゴリの隣にある登録用リンクを選択します。

登録情報を指定するページが表示されます。

次の情報を指定します。

登録の名前: カテゴリの名前

ターゲットカテゴリ: カテゴリの名前

検索の範囲: 「検索」テキストフィールドと同様のクエリー文字列

検索対象期間: 指定したカテゴリに登録する期間。「すべて」、「1 週間以内」、「1 ヶ月以内」、「6 ヶ月以内」、「1 年以内」に設定できます。

「完了」ボタンを選択します。

登録のリストにカテゴリが追加されます。

ディスカッションに登録する

サンプルデスクトップにログインします。

ディスカッションへの登録は、ディスカッションを表示するリンクから行えます。これには、「登録」リンクが含まれます。

登録するディスカッションの「登録」リンクを選択します。

登録情報を指定するページが表示されます。

次の情報を指定します。

登録の名前: カテゴリの名前

ターゲットカテゴリ: カテゴリの名前

検索の範囲: 「検索」テキストフィールドと同様のクエリー文字列

検索対象期間: 指定したカテゴリに登録する期間。「すべて」、「1 週間以内」、「1 ヶ月以内」、「6 ヶ月以内」、「1 年以内」に設定できます。

重要度: この重要度以上が登録の対象となるしきい値

「完了」ボタンを選択します。

これで、ディスカッションに登録されます。

検索を保存する

サンプルデスクトップにログインします。

「検索」タブを開き、ドキュメントを検索します。

検索結果のページが表示されます。

結果リストの上に表示される登録のリンクをクリックします。

登録情報を指定するページが表示されます。

次の情報を指定します。

ラベル: 保存される検索のラベル

検索の範囲: 「検索」テキストフィールドと同様のクエリー文字列

検索対象期間: 指定した検索結果を登録する期間。「すべて」、「1 週間以内」、「1 ヶ月以内」、「6 ヶ月以内」、「1 年以内」に設定できます。

「完了」ボタンを選択します。

これで、検索結果が保存されます。

ディスカッション

ディスカッションの概要

DiscussionProvider

チャネルの管理と使用

ディスカッションの概要

ディスカッションは、トピックと特定のドキュメントに関連付けられています。エンドユーザーは、この機能を使用して、既存のドキュメントを追加し、それについて話し合ったり、独自のトピックを作成したりすることができます。特定のドキュメントや新しいトピックに関する情報を共有することができます。

Sun Java System Portal Server ソフトウェアのディスカッション機能には、ディスカッションスレッド、ドキュメントまたは新規トピックに基づくディスカッションの開始、ディスカッションの検索、ディスカッションの重要度設定が含まれます。デフォルトでは、匿名ユーザー用のサンプルポータルでもディスカッションチャネルを利用できます。ただし、匿名ユーザーはディスカッションに登録したり、ディスカッションチャネルを編集したりすることはできません。

DiscussionLite チャネルとディスカッションチャネルは DiscussionProvider に基づいています。検索チャネルの JavaServer Pages^TM (JSP^TM) ファイルと同様に、クエリーの部分と表示の部分があり、デスクトップテーマを使用します。

DiscussionProvider

DiscussionProvider は、デスクトップテーマを使用する JSP プロバイダです。これは、検索タグライブラリと API を使用して、バックエンドの検索サービスからデータを取得します。ディスカッションとコメントは、異なるリソースディスクリプタ (RD) としてディスカッションデータベースに格納されます。DiscussionProvider がサポートする内容は次のとおりです。

次の機能を持つ完全ビュー (ディスカッションチャネル経由) と省略ビュー (DiscussionLite チャネル経由)

ディスカッションチャネルから新しいディスカッションを開始する。

既存のディスカッションに返信する。

検索チャネルからの Web ドキュメントに基づく新しいディスカッションを開始する。

次の機能を持つディスカッションリスト

最終更新日でソートされた主要送信を取得する。

ユーザーが古いディスカッションにアクセスできるようにページ付けを行う。

ディスカッションの各サブツリーを表示するディスカッション表示。主要項目は詳細に表示され、サブツリーは主要項目の下に表示されます。ここに表示される内容には、次の項目が含まれます。

ページ上の複数のフィルタ。ドキュメントの重要度 (「重要でない (irrelevant)」、「普通 (routine)」、「興味 (interesting)」、「重要 (important)」、「必読 (must read)」) などのフィルタに基づいてドキュメントを表示できます。

スレッド表示とフラット表示の表示設定を選択できます。

展開しきい値を使用すると、サブツリー内の表示を制御しやすくなります。ユーザーは、評価の高いドキュメントだけを展開したり、すべてのドキュメントを展開したり閉じたりすることを選択できます。デフォルト値は「すべて縮小」です。「すべて展開」を選択した場合、フィルタ条件を満たすすべてのコメントが表示されます。また、ディスカッションの説明およびディスカッション評価用メニューが表示されるほか、返信を投稿する仕組みも提供されます。

ディスカッション内の検索に対応しています。

ディスカッションに対してコメント追加し、重要度を設定する。たとえば、ユーザーは次の操作が可能です。

既存のディスカッションにコメントを追加する。

すべてのディスカッションとコメントに重要度を設定する。ただし、ユーザーが設定する重要度はただちには適用されません。重要度の計算は、コメントの重要度が段階的に上下するアルゴリズムに基づいています。たとえば、コメントの重要度を「重要」に引き上げるには、「重要」という設定を 3 回行う必要があります。

ディスカッション内のすべてのディスカッションを検索する。これらの機能は、検索プロバイダにルーティングされます。ユーザーは、詳細検索機能を使用して、重要度による検索も実行できます。

登録。認証されたユーザーは、登録のリンクを選択することで、特定のディスカッションを選択的に登録できます。この要求は、SubscriptionProvider によって処理されます。この機能が必要ない場合は、displaySubscription プロパティーを無効に設定できます (コード例 16-1 を参照)。このプロパティーのデフォルト値は true です。

DiscussionProvider のディスプレイプロファイル XML コード

コード例 16-1 は、DiscussionProvider のディスプレイプロファイル XML コードを示しています。

コード例 16-1 DiscussionProvider プロバイダのディスプレイプロファイル XML コード


<Provider name="DiscussionProvider" class="com.sun.portal.providers.jsp.JSPProvider">
<Properties>
<String name="title" value="* Discussions Provider *"/>
<String name="description" value="* DESCRIPTION *"/>
<String name="refreshTime" value="0" advanced="true"/>
<String name="helpURL" value="en/desktop/discussions.htm" advanced="true"/>
<String name="fontFace1" value="Sans-serif"/>
<String name="productName" value="Sun Java System Portal Server"/>
<String name="contentPage" value="discussionContent.jsp"/>
<String name="editPage" value="discussionEdit.jsp"/>
<String name="processPage" value="discussionDoEdit.jsp"/>
<Boolean name="isEditable" value="true" advanced="true"/>
<String name="editType" value="edit_subset" advanced="true"/>
<Boolean name="showExceptions" value="false"/>
<Boolean name="showErrors" value="true"/>
<String name="width" value="thick"/>
<String name="column" value="2"/>
<String name="searchServer" value=""/>
<String name="dbname" value=""/>
<Integer name="viewHits" value="8"/>
<String name="defaultDiscussionDisplay" value="Threaded"/>
<String name="defaultFilter" value="Irrelevant"/>
<String name="defaultExpansionThreshold" value="Collapse all"/>
<Boolean name="viewDiscussionWindow" value="false"/>
<String name="anonymousAuthor" value="anonymous"/>
<Boolean name="displaySearch" value="true"/>
<Boolean name="showDescription" value="false"/>
<String name="ratingText" value="Irrelevant,Routine,Interesting,Important,Must Read"/>
</Properties>
</Provider>

DiscussionProvider の管理

チャネル編集ページ (ユーザーによる設定が可能)

管理コンソールの DiscussionProvider のチャネルデスクトップの「チャネルおよびコンテナを管理」リンク

検索サービス

DiscussionLite チャネル

DiscussionLite チャネルは、上位 20 のディスカッションタイトル (再設定可能) と日付を表示します。ディスカッションは、作成日 (最終更新日) でソートされ、もっとも新しいディスカッションが先頭に表示されます。DiscussionLite チャネルの表示には、各ディスカッションを表示するリンク、ディスカッションチャネルをターゲットとするすべてのディスカッションを表示するリンク、ディスカッションを開始するリンクがあります。デフォルトでは、チャネルは単一のコンテナ内に表示され、すべてのリンクは JSPDynamicSingleContainer に持ち込まれます。

プロパティーは、管理コンソールから設定できます。デフォルトでは、このチャネルのプロパティーをユーザーが編集することはできません。

ディスカッションは、ディスプレイプロファイルの dbname プロパティーで指定されるディスカッションデータベースに格納されます。ディスプレイプロファイルでは、検索サーバーホスト (searchServer プロパティー)、データベース名 (dbname プロパティー)、表示するディスカッションの数 (viewHits プロパティー) を設定できます (コード例 16-2 を参照)。

コード例 16-2 DiscussionLiteProvider のディスプレイプロファイル XML コード


<Channel name="DiscussionLite" provider="DiscussionProvider">
<Properties>
<String name="title" value="Recent Discussions"/>
<String name="description" value="This is a DiscussionLite provider example"/>
<String name="contentPage" value="discussionLiteContent.jsp"/>
<String name="editPage" value=""/>
<String name="processPage" value=""/>
<String name="width" value="thin"/>
<String name="searchServer" value=""/>
<String name="db" value="discussion"/>
<Integer name="viewHits" value="20"/>
</Properties>
</Channel>

ディスカッションチャネル

ディスカッションチャネルによる完全な表示には、次の機能が含まれます。

discussionLiteContent.jsp	JSP コンテンツページ。
query.jsp	検索クエリーを設定、実行する。
display.jsp	結果を表示する。
error.jsp	例外とエラーメッセージを表示する。

降順にソートされた上位 8 ディスカッションの詳細な説明を表示する。これは、チャネル編集ページで再設定できます。

ユーザーがすべてのディスカッションを表示するためのページ付けを行う。

検索をサポートする。検索は、ディスカッションとコメントの結果を返します。

ディスカッションチャネルのプロパティーは、Sun Java System 管理コンソールから設定できます。

コード例 16-3 ディスカッションチャネルのディスプレイプロファイル XML コード


<Channel name="Discussions" provider="DiscussionProvider">
<Properties>
<String name="title" value="Discussions"/>
<String name="description" value="This is a Discussion provider example"/>
<String name="searchServer" value=""/>
<String name="dbname" value="discussions"/>
<Integer name="viewHits" value="8"/>
</Properties>
</Channel>

ディスカッションチャネルでは、次の JSP が使用されます。


discussionContent.jsp	JSP コンテンツページ
discussionEdit.jsp	編集ページ
discussionDoEdit.jsp	プロセス編集ページ
declare.jsp
portal.jsp	ディスプレイプロファイルデータを抽出
fullDiscussion.jsp	完全な表示を処理
fullDiscussionDisplay.jsp	すべてのディスカッションページのユーザーインタフェース
searchUI.jsp	すべてのディスカッションページに表示される検索フォーム
viewDiscussion.jsp	ディスカッションを表示
viewDiscussionBar.jsp	ディスカッション表示ページ中央の水平バーで、すべてのフィルタが含まれる
viewDiscussionDisplay.jsp	ディスカッション表示ページのユーザーインタフェース
viewDiscussionHeader.jsp	ディスカッション表示ページに表示されるヘッダーコメント
viewDiscussionNavigation.jsp	ディスカッション表示ページのヘッダーの上下に表示されるナビゲーションバー
feedback.jsp	コメント、フィードバック、重要度の各機能を提供
feedbackDisplay.jsp	フィードバックを表示
feedbackForm.jsp	フィードバックフォームを提供
feedbackProcess.jsp	フィードバックを処理
error.jsp	例外とエラーメッセージを表示
query.jsp	検索クエリーの設定と実行
pageFooter.jsp	ページ付け

チャネルの管理と使用

DiscussionProvider チャネルの管理

DiscussionProvider チャネルの管理は、デスクトップのディスプレイプロファイルと、Sun Java System Access Manager 管理コンソール上の検索サービスに分散して行われます。プロバイダに固有の情報は、ディスプレイプロファイルに格納されます。ディスカッションドキュメントとデータベースに関連する管理は、検索サービスで行う必要があります。

ディスカッションはディスカッションデータベースに格納されます。ディスカッションデータベースは、ディスカッションとコメントが特定のスキーマで構成されていることを前提としています。この機能のために、schema.rdm ファイルに新たにスキーマのフィールドが追加されました。データベースの管理とデバッグには、検索コマンド rdmgr を使用します。たとえば、すべてのコメントをダンプするには、次のように入力します。

DiscussionProvider チャネルのサンプルは、デフォルトの検索サーバーを使用するように設定されています。ディスカッションデータベースとチャネルにインポートされるいくつかのサンプルディスカッションは、すぐに使用できます。

サンプルが、PortalServer-base/SUNWps/samples/discussions/ ディレクトリに格納されています。サンプルは次のとおりです。

管理者は、ディスカッションへのエンドユーザーのアクセスを制御して、読み取り専用にしたり、完全な非表示にしたりすることができます。

DiscussionProvider からチャネルを作成する

discussions.soif	ディスカッションデータベースにロードされるサンプル SOIF ファイル。
dp-org.xml	ディスカッションチャネルのディスプレイプロファイル XML コード。
dp-providers.xml	ディスカッションプロバイダのディスプレイプロファイル XML コード。
dp-anon.xml	認証なしの匿名ユーザー用の XML コード。サンプルポータルのインストール時にロードされる。

Sun Java System Access Manager 管理コンソールにログインし、「表示」プルダウンメニューから「サービス」を選択します。

左のパネルにサービスのリストが表示されます。

「ポータルデスクトップ」、「チャネルおよびコンテナを管理」の順に選択します。

右のパネルに「チャネルおよびコンテナを管理」リンクが表示されます。

「チャネル」の下の「新規」ボタンを選択します。

追加するチャネルのタイプを指定するページが表示されます。

「チャネル名」テキストボックスにチャネルの名前を入力し、「プロバイダ」プルダウンメニューから「DiscussionProvider」を選択します。

「了解」を選択します。

これにより、指定したプロバイダに基づいてチャネルが作成されます。「キャンセル」ボタンをクリックすると、新しいチャネルを作成せずに「チャネルおよびコンテナを管理」ページに戻ります。

チャネルテーブルで新たに作成したチャネルの隣にある「編集」リンクをクリックします。

チャネルのデフォルト値を設定するページが表示されます。

プロパティーを編集し、「保存」ボタンを選択して編集内容を保存します。

次のディスプレイプロファイルプロパティーは、このプロバイダに固有のプロパティーです。


searchServer	検索サーバーへのパス。デフォルト値は portal/searchです。
dbname	任意の有効なデータベース。
viewHits	表示するディスカッションの数。
defaultDiscussionDisplay	flat または threaded に設定し、コメントサブツリーの表示をフラットまたはスレッドに設定できます。
defaultFilter	ディスカッションの検索と表示に適用されるフィルタ。サブツリーの表示を制御します。「重要でない (irrelevant)」、「普通 (routine)」、「興味 (interesting)」、「重要 (important)」、「必読 (must read)」などの重要度に基づく設定が可能です。デフォルト値は「重要でない」なので、「重要でない」以上の重要度が指定されたすべてのコメントが表示されます。「必読」フィルタは、重要度が高く設定されたコメントを強調表示します。
defaultExpansionThreshold	「すべて展開」または「すべて縮小」に設定可能。デフォルト値は「すべて縮小」です。「すべて展開」に設定すると、フィルタリングされたすべてのコメント、説明、重要度メニューが表示されます。また、ユーザーはリンクをクリックして返信できます。
anonymousAuthor
viewDiscussionWindow
displaySearch
showDescription	ディスカッションチャネル用にこのプロパティーを設定可能。
ratingText	ディスカッションのデフォルトの重要度として「重要でない」、「普通」、「興味」、「重要」、または「必読」を設定可能。