Oracle® Fusion Middleware Oracle WebCenter Portal開発者ガイド 11g リリース1 (11.1.1.7.0) B72084-02 |
|
前 |
次 |
この章では、設計時にWebCenter Portal: Frameworkアプリケーションにアクティビティ・グラフ・サービスを統合する方法について説明します。
この章には次の項が含まれます:
アクティビティ・グラフ・サービスの管理方法および使用方法の詳細は、次のドキュメントを参照してください。
『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のアクティビティ・グラフ・サービスの管理に関する項
『Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイド』のアクティビティ・グラフ・サービスでの作業に関する項
今日のユーザーは前例のない速度でコンテンツを提供しています。このことを念頭に置くと、FrameworkアプリケーションなどのEnterprise 2.0製品にシームレスに統合された、より効率的な情報取得サービスが必要になっています。アクティビティ・グラフ・サービスでは、集約されたインテリジェント機能を活用することで、検索アプリケーションおよびソーシャル・アプリケーション用のソリューションを提供します。
この項では、アクティビティ・グラフ・サービスの概要、タスク・フロー、メリットおよび基礎となるアーキテクチャについて説明します。次のサブセクションが含まれます:
アクティビティ・グラフ・サービスでは、既存のコネクションやアプリケーション内のオブジェクトへの共通のやり取りに基づいて、ユーザーが関心を寄せている可能性のある人を提案します。また、現在ユーザーが表示しているスペースまたはアイテムでの類似する操作に基づいて、ユーザーが興味を持つ可能性があるスペースやコンテンツも示されます。
アクティビティ・グラフ・サービスでは、アクティビティ・グラフ・エンジンによって収集および分析されたデータに基づいて、これらの提案が提示されます。アクティビティ・グラフ・エンジンは、エンタープライズ・アプリケーションによって収集されるアクションの中央リポジトリを提供します。数学のグラフについて考えると、アプリケーション・ユーザーと彼らがやり取りするエンタープライズ・コンテンツがノードであり、ユーザー間およびユーザーとコンテンツ間のアクションが有向エッジに相当します(図45-1)。
エンタープライズでは、人々と他の人々およびコンテンツとの対話を分析し、表示、編集、タグ付けなどの拡張可能なアクション・セットに基づいてコンテキストに沿った推奨を作成するための類似度スコアを生成しています。たとえば、オンライン・ベンダーの場合、このようなコンテキストに沿った推奨は、お薦めの追加購入の選択肢を提供するうえで役立ちます。ソーシャル・ネットワーク環境では、推奨によって、すでに接続している友人の友人に基づいて追加の接続を提案します。
アクティビティ・グラフ・エンジンは、コンテンツのアクティビティ・ランクも計算し、この情報をOracle Secure Enterprise Searchに渡し、検索結果により関連性の高いコンテンツを表示できるようにします。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のOracle Secure Enterprise Searchのアクティビティ・ランクの設定に関する項を参照してください。
ノード・クラス
アクティビティ・グループ・ノードは、各クラスにグループ化されます。WebCenter Portalのデフォルトのノード・クラスは、次のとおりです。
ユーザー(WC.user
)
スペース(WC.group-space
)
ドキュメント(WC.document
)
Wikiページ(WC.wiki-page
)
ブログ(WC.blog
)
ディスカッション・トピック(WC.topic
)
アクティビティ・グラフ・エンジンを拡張して他のアプリケーションに統合する場合は、これらのアプリケーションのオブジェクトに対応するカスタム・ノード・クラスを作成できます。詳細は、第45.4.1項「カスタム・ノード・クラスの定義」を参照してください。
アクション
アクションは特定のタイプのイベントです。それには、ソースとターゲットがあります。たとえば、Montyというユーザーがドキュメントを見ている場合は、Montyによるview
アクションがソースとなり、ドキュメントがターゲットとなります。ユーザーとアイテム間のその他のアクションには、create
、like
およびtag
があります。たとえば、2人のユーザーが互いにconnect
されている場合は、アクションを2人のユーザー間で実行できます。
表45-1に、WebCenter Portal用に定義されたデフォルト・アクションを示します。
表45-1 WebCenter Portalのデフォルト・アクション
アクションURN | 説明 |
---|---|
|
別のユーザーとのコネクションを持ちます。 |
|
スペース、ドキュメント、Wiki、ブログ、トピックまたはメッセージの作成。 |
|
スペースを除くすべてのアイテムの場合:
スペースの場合:
|
|
ドキュメント、Wikiまたはブログにコメントします |
|
ドキュメント、Wiki、ブログまたはメッセージを気に入ります |
|
ドキュメント、Wikiまたはブログにタグ付けします |
|
スペース・ページ、ドキュメント、Wiki、ブログ・エントリまたはディスカッション・トピックの表示 |
|
ドキュメント、Wikiまたはブログをダウンロードします |
|
ドキュメントの新しいバージョンのチェックイン、Wikiページまたはブログの編集、トピックへの返信、メッセージの編集を行います |
|
ドキュメント、Wikiページ、ブログまたはディスカッション・トピックを表示します |
これらのWebCenter Portalアクションが1つでも発生すると(たとえば、Montyがドキュメントをview
すると)、そのアクションはWebCenter Portal分析のコンポーネントであるイベント・コレクタによって収集され、アクティビティ・データベース(図45-2)のイベント表に格納されます。
アクティビティ・データの収集プロセスが開始されると、分析アクティビティ・プロバイダによって分析イベント表からアクションが読み取られた後、登録済のマッピング・セットが使用されてアクティビティが生成されます(図45-3)。アクティビティとは、1回発生したアクションのことで、集計されたアクションの発生回数であるリレーションの判別に使用されます(リレーション表に格納される)。たとえば、Montyがこの特定のドキュメントを5回表示したという事実はリレーションです。リレーション表の中の情報は、推奨と検索ランクの決定に使用されます。
アクティビティ・グラフ・エンジンを他のアプリケーションに統合する場合は、これらのアプリケーションにおけるユーザーの実行アクションに対応するカスタム・アクションを作成できます。詳細は、第45.4.2項「カスタム・アクションの定義」を参照してください。
類似度計算
アクティビティ・グラフ問合せAPIは、アクティビティ・グラフ・サービス・タスク・フローによって使用されるJava APIで、レシピを使用して関連表で推奨を問い合せます(図45-4)。レシピとは、類似度計算の重み付けされたリストのことです。類似度計算では、特定の条件下で2つのオブジェクトがどの程度類似しているかを指定する類似度スコア(ゼロから1までの数値)が提供されます。それぞれの計算の重み付けによって、その計算が推奨の総合スコアに与える影響が変化します。推奨は、推奨スコアの合計によって順序付けされます。
表45-2に、アクティビティ・グラフ・サービス・タスク・フローによって使用される類似度計算を示します(タスク・フローについては、第45.2.3.1項「アクティビティ・グラフ・サービス・タスク・フロー」を参照してください)。
表45-2 アクティビティ・グラフ・サービスの類似度計算
URN | 適用対象 | 説明 | タスク・フローでの使用 |
---|---|---|---|
|
ドキュメント Wikiページ ブログ トピック |
現在のアイテムを編集したユーザーが推奨アイテムも編集しています |
類似アイテム |
|
ドキュメント Wikiページ ブログ トピック |
現在のアイテムを気に入ったユーザーが推奨アイテムも気に入っています |
類似アイテム |
|
ドキュメント Wikiページ ブログ トピック |
現在のアイテムについてコメントしたユーザーが推奨アイテムについてもコメントしています |
類似アイテム |
|
ドキュメント Wikiページ ブログ トピック |
現在のアイテムにタグ付けしたユーザーが推奨アイテムにもタグ付けしています |
|
|
ドキュメント Wikiページ ブログ トピック |
現在のアイテムとなんらかの方法で(表示など)やり取りしたユーザーが、推奨アイテムともなんらかの方法でやり取りしています |
類似アイテム |
|
ユーザー |
現在のユーザーが推奨ユーザーと複数のコネクションを共有しています |
推奨コネクション |
|
ユーザー |
現在のユーザーが編集したアイテムの一部は、推奨ユーザーも編集しています |
推奨コネクション |
|
ユーザー |
現在のユーザーが気に入ったアイテムの一部は、推奨ユーザーも気に入っています |
推奨コネクション |
|
ユーザー |
現在のユーザーがコメントしたアイテムの一部は、推奨ユーザーもコメントしています |
推奨コネクション |
|
ユーザー |
現在のユーザーがタグ付けしたアイテムの一部は、推奨ユーザーもタグ付けしています |
推奨コネクション |
|
ユーザー |
推奨ユーザーがやり取りしたアイテムの一部と、表示を含めなんらかの方法でやり取りした現在のユーザー |
推奨コネクション |
これらの類似度計算を編集して、重み付けを変更できます。アクティビティ・グラフ・エンジンを他のアプリケーションに統合する場合は、追加の類似度計算を作成できます。詳細は、第45.4.3項「カスタム類似度計算の定義」を参照してください。
問合せ結果ポスト・プロセッサ(QRPP)
特定のオブジェクトの最初の推奨リストが生成された後、結果をフィルタし、ユーザーにとってより適した有用なものにします。これは、問合せ結果ポスト・プロセッサ(QRPP)を使用して実現されます。QRPPは、現在の推奨結果のリストを使用し、出力として変更されたリストを返します。QRPPは、たとえば、現在のユーザーに閲覧が許可されていないオブジェクトの推奨を削除することで推奨をフィルタ除去したり、結果のメタデータを追加または変更したりすることがあります。
WebCenter Portalには、次の3つのQRPPが用意されています(表記されている順序で実行される)。
WebCenter PortalセキュリティQRPP - リソース認可プロバイダをコールすることにより、現在のユーザーが表示権限を持っていないオブジェクトに対する推奨をフィルタ処理で除外します。リソース認可プロバイダは、検索サービスによる表示認可で使用されるのと同じWebCenter Portalコンポーネントです。詳細は、第7.3.1項「リソース・アクション処理フレームワークの概要」を参照してください。
分析メタデータQRPP - 分析表の各推奨オブジェクトについて、追加のメタデータ(説明やアイコンURLなど)を取得します。
WebCenter Portal URL QRPP - リソース・アクション・ハンドラをコールすることにより、各推奨オブジェクトのURLを取得します。リソース・アクション・ハンドラは、検索サービスで使用されるのと同じWebCenter Portalコンポーネントです。
この結果にさらにフィルタ処理を加えたり、アクティビティ・グラフ・エンジンを他のアプリケーションに統合するために独自のQRPPを作成できます。詳細は、第45.4.6項「カスタムQRPPの登録」を参照してください。
アクティビティ・グラフ・サービス・タスク・フロー
ユーザーに対する推奨の提示は、アクティビティ・グラフ・サービス・タスク・フローを介して行われます。アクティビティ・グラフ・サービスには、次のタスク・フローがあります。
注意: 類似スペース・タスク・フローは、WebCenter Portal Spacesアプリケーションでのみ使用可能です。ユーザーが現在のスペースと同様の方法でやり取りするスペースを提案します。 |
詳細は、第45.2.3.1項「アクティビティ・グラフ・サービス・タスク・フロー」を参照してください。
アクティビティ・グラフ・サービスを使用するには、アクティビティ・グラフ・エンジンがインストールおよび構成されている必要があります。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portalインストレーション・ガイド』を参照してください。
また、アプリケーションでWebCenter Portalスキーマおよびアクティビティ・データベースへの接続を作成する必要があります。詳細は、第7.2.2項「データベース接続の設定」を参照してください。
分析イベント・コレクタに使用イベントを送信するように、アプリケーションが構成されている必要があります。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のアプリケーション用の分析コレクタの登録に関する項を参照してください。
アクティビティ・グラフ・サービスで推奨を行うには、まず、アクティビティ・グラフ・エンジンを最低1回は実行して、データ収集と類似度スコアの計算を行っておく必要があります。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のアクティビティ・グラフ・サービス用のデータ準備に関する項を参照してください。
類似アイテム・タスク・フローと推奨データ・コントロールで提案されるアイテムは、アプリケーションで使用可能なツールとサービスによって異なります。たとえば、ドキュメント・サービスが使用可能な場合は、ドキュメントのみが推奨されます。アプリケーションでサービスを使用可能にする方法については、そのサービスに関する該当の章を参照してください。また、そのアイテムを所有するサービスのリソース認可プロバイダでフィルタ処理が行われることによって、アイテムが推奨から除外されることもあります。
実行時には、アクティビティ・グラフ・サービス・タスク・フローで次のようなコンテキストが提供されます。
推奨コネクション・タスク・フローの場合、コンテキストは現在のユーザーになります。
類似アイテム・タスク・フローの場合、コンテキストは、タスク・フロー入力パラメータまたはADF UIイベントを通して渡されるWebCenter Portalリソースになります。
その後、タスク・フローは、アクティビティ・グラフのQuery APIを介して(タスク・フロー・パラメータで指定されているレシピを使用する)アクティビティ・グラフ・データベースの推奨の問合せを行います。Query APIによって返された推奨リストは、QRPPでフィルタ処理してからタスク・フローで表示することもできます。
実行時のサービスの詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイド』のアクティビティ・グラフ・サービスでの作業に関する項を参照してください。
この項では、アクティビティ・グラフ・サービスをアプリケーションに追加するための必要な手順について説明します。次のサブセクションが含まれます:
この項のフローチャート(図45-5)と表(表45-3)は、Frameworkアプリケーション内でアクティビティ・グラフ・サービスを動作させるために必要な前提条件とタスクの概要を示しています。
図45-5 WebCenter Portal: Frameworkアプリケーションに対するアクティビティ・グラフ・サービスの構成
表45-3 WebCenter Portal: Frameworkアプリケーションに対するアクティビティ・グラフ・サービスの構成
アクター | タスク | サブタスク |
---|---|---|
管理者 |
1.分析サービスおよびアクティビティ・グラフ・サービス用のWebCenter Portalコンポーネントとバックエンド・コンポーネントをインストールする |
|
開発者 |
2.アプリケーションにアクティビティ・グラフ・サービスを統合します |
2.a JDeveloperでWebCenter Portalスキーマへの接続を構成する 2.b JDeveloperでアクティビティ・データベースへの接続を構成する 2.c JDeveloperで分析コレクタへの接続を構成する 2.d JDeveloperでページにアクティビティ・グラフ・タスク・フローを追加する |
管理者 |
3.(オプション)アクティビティ・グラフ・エンジンのスケジュールを設定する |
|
開発者/ 管理者 |
4.次のいずれかのツールを使用してアプリケーションをデプロイします:
|
|
5.(オプション)次のいずれかのツールを使用して接続パラメータを追加/変更します:
|
||
エンド・ユーザー/ 管理者 |
6.アプリケーションでアクティビティ・グラフ・データを使用できることをテストします |
6.a アプリケーションにログインし、コンテンツを追加するなどの操作を行う(エンド・ユーザー) 6.b アクティビティ・グラフ・エンジンを実行する(管理者) 6.c アクティビティ・グラフ・タスク・フローで、推奨(たとえば、「プロファイル」ページの推奨コネクション・タスク・フロー)を表示する(エンド・ユーザー) |
WebCenter Portalスキーマ - この接続は、WebCenter Portalのリソース認可プロバイダとリソース・アクション・ハンドラの問合せ中に、WebCenter PortalセキュリティおよびWebCenter Portal URLのQRPPによって使用されます。この接続の作成方法については、第7.2.2項「データベース接続の設定」を参照してください。
アクティビティ・スキーマ - この接続は、推奨の問合せおよびその結果のメタデータの取得に使用されます。これは、分析イベント・コレクタおよびアクティビティ・グラフ・エンジンが使用する接続と同じものです。既存の接続が存在する場合、その接続が使用されます。既存の接続が存在しない場合は、新しい接続を作成する必要があります。この接続の作成方法については、第7.2.2項「データベース接続の設定」を参照してください。
分析イベント・コレクタ - この接続は、分析イベント・コレクタに使用イベントを送信するために使用されます。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のアプリケーション用の分析コレクタの登録に関する項を参照してください。
さらに、類似アイテム・タスク・フローと推奨データ・コントロールで提案されるアイテムは、アプリケーションで使用可能なツールとサービスによって異なります。たとえば、ドキュメントは、ドキュメント・ツールが有効な場合のみお薦めされます。
ドキュメント、Wikiおよびブログを表示するにはコンテンツ・リポジトリへの接続が必要です。
ディスカッションを表示するには、ディスカッション・サーバーへの接続が必要です。
注意: JDeveloperで設計時にバックエンド・サーバーへの接続を設定できますが、デプロイ後の環境でEnterprise Manager Fusion Middleware Controlを使用して、後から接続を追加、削除または変更できます。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』を参照してください。 |
この項では、アクティビティ・グラフ・サービス・タスク・フローおよびアプリケーションへのアクティビティ・グラフ・サービスの追加手順について説明します。次のサブセクションが含まれます:
この項では、アクティビティ・グラフ・サービスで使用可能なタスク・フローについて説明します。
表45-4に、アクティビティ・グラフ・サービスによって提供されるタスク・フローを示します。
表45-4 アクティビティ・グラフ・サービス・タスク・フロー
タスク・フロー | 説明 |
---|---|
推奨コネクション |
このタスク・フローでは、現在のユーザーに類似しているとアクティビティ・グラフ・エンジンの計算によって判断されたユーザーを表示して、そのユーザーとのコネクションを持つことができます。 詳細は、第45.2.3.1.1項「推奨コネクション・タスク・フロー」を参照してください。 |
類似アイテム |
このタスク・フローでは、現在のユーザーが興味を持つ可能性があるとアクティビティ・グラフ・エンジンの計算によって判断されたWebCenter Portalアイテムを表示して、そのアイテムとやり取りできます。 詳細は、第45.2.3.1.2項「類似アイテム・タスク・フロー」を参照してください。 |
注意: 類似スペース・タスク・フローは、WebCenter Portal Spacesアプリケーションでのみ使用可能です。ユーザーが現在のスペースと同様の方法でやり取りするスペースを提案します。 |
推奨コネクション・タスク・フローでは、現在のユーザーに類似していると計算によって判断されたユーザーを表示して、そのユーザーとのコネクションを持つことができます。
推奨コネクション・タスク・フローは、各ユーザーの「プロファイル」ページで、デフォルトで提供されています。
このタスク・フローの実行時における使用方法については、『Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイド』の推奨コネクション・タスク・フローでの作業に関する項を参照してください。
表45-5に、類似度計算と推奨コネクション・タスク・フローのデフォルト・レシピで使用されている重み付けを示します。このレシピは、similarityURNList
タスク・フロー・バインディング・パラメータを編集することで変更できます。詳細は、第45.2.3.3項「アクティビティ・グラフ・サービス・タスク・フロー・パラメータを変更する方法」を参照してください。
表45-5 推奨コネクションのデフォルト・レシピ
類似度計算 | 重み |
---|---|
user-connect |
100 |
user-edit |
50 |
user-like |
50 |
user-comment |
10 |
user-tag |
10 |
user-all |
1 |
推奨の総合スコアが一番高いユーザーが、タスク・フローで最初に表示されます。各推奨ユーザーの最高スコアに関する類似度計算で、関連付けられた理由文字列が存在する場合は、その文字列がユーザー名の下に表示され、なぜそのユーザーを推奨するのかが詳述されます。
最上位の類似度ファンクションに理由文字列が定義されていない場合は、何も表示されません。類似度計算理由文字列は編集したり、文字列を追加したりできます。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』の類似度計算の理由文字列のカスタマイズに関する項を参照してください。
類似アイテム・タスク・フローでは、現在選択しているアイテムのユーザーが興味を持つ可能性があるとアクティビティ・グラフ・エンジンの計算によって判断されたWebCenter Portalアイテムを表示して、そのアイテムとやり取りできます。推奨されるアイテムは、現在のユーザーに固有のものではありませんが、タスク・フローにはそのユーザーが表示権限を持つアイテムのみが示されます。
ユーザーが興味を持つ可能性があるアイテムには、Wikiページ、ブログ・ポスト、ドキュメント、ディスカッション・トピックなどが含まれます。
類似アイテム・タスク・フローでは、ページ上の他のタスク・フローで選択したアイテムに基づいて推奨コンテキストが決定されます。この情報は、タスク・フロー入力パラメータ(通常は、EL式を使用)またはWebCenterResourceSelected
ADF UIイベントを通じて提供されます。類似アイテム・タスク・フローのコンテキストを決定するタスク・フローは、次のとおりです。
次のドキュメント・サービス・タスク・フローです。
最近のドキュメント
ドキュメント・リスト・ビューア
ドキュメント・ナビゲータ
ドキュメント・エクスプローラ
フォルダ・ビューア
ドキュメント・マネージャ
ドキュメント・ブラウザ
ディスカッション・マネージャ・タスク・フロー
類似アイテム・タスク・フローは、ドキュメント・エクスプローラのファイル用の「関連アイテム」ペインにあり、現在表示しているファイルに類似するアイテムが表示されます。
このタスク・フローの実行時における使用方法については、『Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイド』の類似アイテム・タスク・フローでの作業に関する項を参照してください。
表45-6に、類似度計算と類似アイテム・タスク・フローのデフォルト・レシピで使用されている重み付けを示します。このレシピは、similarityURNList
タスク・フロー・バインディング・パラメータを編集することで変更できます。詳細は、第45.2.3.3項「アクティビティ・グラフ・サービス・タスク・フロー・パラメータを変更する方法」を参照してください。
推奨の総合スコアが一番高いアイテムが、タスク・フローで最初に表示されます。各推奨アイテムの最高スコアに関する類似度計算で、関連付けられた理由文字列が存在する場合は、その文字列がアイテム名の下に表示され、なぜそのアイテムを推奨するのかが詳述されます。
最上位の類似度ファンクションに理由文字列が定義されていない場合は、何も表示されません。類似度計算理由文字列は編集したり、文字列を追加したりできます。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』の類似度計算の理由文字列のカスタマイズに関する項を参照してください。
この項では、推奨コネクション・タスク・フローをアプリケーション・ページに追加する方法について説明します。この手順は、すべてのアクティビティ・グラフ・サービス・タスク・フローで同じです。
推奨コネクション・タスク・フローをFrameworkアプリケーションに追加するには:
第45.1.2項「アクティビティ・グラフ・サービスの要件」の説明に従って、アプリケーションを準備します。
タスク・フローを追加するページを開きます。
リソース・パレットで、「カタログ」、「WebCenter Portal - サービス・カタログ」、「タスク・フロー」フォルダの順に開きます。
推奨コネクション・タスク・フロー(または、希望するアクティビティ・グラフ・サービス・タスク・フロー)を、JSF(.jspx
)ページにドラッグ・アンド・ドロップします。
表示されるポップアップ・メニューから、「リージョン」を選択します。
アクティビティ・グラフ・サービスのADFライブラリ(activitygraph-service-view.jar
)をプロジェクトに追加するよう要求される場合があります。「ライブラリの追加」をクリックして確認します。この操作の完了には時間がかかる場合があります。
「タスク・フロー・バインディングの編集」ダイアログにパラメータの値を入力するか、デフォルトを受け入れます。
詳細は、第45.2.3.4項「アクティビティ・グラフ・サービス・タスク・フローおよびタスク・フロー・パラメータ」を参照してください。
「OK」をクリックします。
タスク・フローがページに追加され、プロジェクトのライブラリがタスク・フローを実行するように構成されます。
「設計」ビューでページを右クリックして、「認可の編集」を選択します。「付与先」→「認証済ユーザーの選択」に移動して、「アクション」で、認証済ユーザーにCustomize
、Grant
、Personalize
およびView
という権限を付与します。
ページを保存し、実行します。
各アクティビティ・グラフ・サービス・タスク・フローには、一連の必須およびオプションのタスク・フロー・バインディング・パラメータがあります。これらは、タスク・フローが正常に機能するために役立つ情報を取得する手段を提供します。
タスク・フロー・バインディング・パラメータを使用すると、タスク・フローの正常なレンダリングに必要な値を提供できるのみでなく、タスク・フロー・インスタンスの外観および動作をカスタマイズできます。たとえば、パラメータ値を使用して、ヘッダーとフッターをレンダリングするかどうか、表示する情報の行数や列数、返されたデータにフィルタを適用するかどうかなどを決定できます。
タスク・フロー・バインディング・パラメータの値は、タスク・フローをアプリケーション・ページにドラッグ・アンド・ドロップするときに指定できます。この操作を行うと、「タスク・フロー・バインディング」ダイアログが開きます(詳細は、第45.2.3.2項「アクティビティ・グラフ・サービス・タスク・フローをページに追加する方法」を参照してください)。
ページにタスク・フローを配置した後、タスク・フロー・バインディング・パラメータの値を調整することもできます。
「タスク・フロー・バインディングの編集」ダイアログにアクセスするには:
ページの下部にある「バインディング」タブ(「ソース」タブの横)をクリックして、「バインディング」ビューに移動します。
「実行可能ファイル」の下に、追加したタスク・フローが表示されます。
図45-6に、「実行可能ファイル」セクションの推奨コネクション・タスク・フローの例を示します。
タスク・フローを選択し、「実行可能ファイル」という見出しの横にある、「選択した要素を編集します。」(鉛筆)アイコンをクリックします。
「タスク・フロー・バインディングの編集」ダイアログ(図45-7)で、必要に応じてバインディング・パラメータの値を変更します(詳細は、第45.2.3.4項「アクティビティ・グラフ・サービス・タスク・フローおよびタスク・フロー・パラメータ」を参照してください)。
終了したら、「OK」をクリックします。
ページを保存して実行し、結果を表示します。
表45-7に、アクティビティ・グラフ・サービスに適用できるタスク・フロー・バインディング・パラメータのリストと説明を示します。
表45-7 アクティビティ・グラフ・サービス・タスク・フロー・バインディング・パラメータ
パラメータ | タスク・フロー | 説明 |
---|---|---|
推奨コネクション 類似アイテム |
推奨のコンテキストとして使用する個人、スペースまたはアイテムのID。 コネクションのデフォルト値は、現在ログインしているユーザーの式言語トークンです。 スペースのデフォルト値は、タスク・フローが含まれているスペースのリソースIDの式言語トークンです。 アイテムの値は、選択イベントから導出されます。 |
|
類似アイテム |
コンテキストのノード・クラス。デフォルトでは、情報は選択イベントから導出されます。 |
|
類似アイテム |
推奨のコンテキストとして使用するスペースまたはアイテムの名前。 スペースのデフォルト値は、タスク・フローが含まれているスペースのリソースIDの式言語トークンです。 アイテムの値は、選択イベントから導出されます。 |
|
推奨コネクション 類似アイテム |
登録済類似度計算のカンマ区切りリスト=重みペア。このリストにより、表示される推奨とその順序が決定されます。 各タスク・フローのデフォルト・レシピは、第45.2.3.1項「アクティビティ・グラフ・サービス・タスク・フロー」に示されています。 |
|
類似アイテム |
推奨に含めるノード・クラスのカンマ区切りリスト。非nullの場合、指定したノード・クラスのオブジェクトのみが推奨に含まれます。 デフォルトでは空です。これは、オブジェクトのどのクラスが返されるかについて、制限がないことを意味します。 |
|
推奨コネクション 類似アイテム |
登録済アクションのカンマ区切りリスト。ログインしているユーザーがとった一連のアクションの対象である人物、スペースまたはアイテムがタスク・フローには表示されません。 たとえば、類似アイテム・タスク・フローのデフォルト値は、作成、編集、コメント、タグです。これは、ユーザー自身が作成、編集、コメントまたはタグ付けしたアイテムが推奨されないことを意味します。 WebCenter Portalのデフォルト・アクションは表45-1にリストされています。 |
|
類似アイテム |
オブジェクトのノード・クラスを識別するために、 |
|
類似アイテム |
WebCenter Portalオブジェクトのノード・クラスを識別するために、 たとえば、ドキュメント・サービスでは |
|
類似アイテム |
タスク・フローの各リンクがインライン・ポップアップ( デフォルト値は |
この項では、アクティビティ・グラフ・サービスで使用できる拡張機能について説明します。次のサブセクションが含まれます:
アクティビティ・グラフ・サービスには、サービス用の独自のユーザー・インタフェース(タスク・フロー)の作成を可能にするデータ・コントロールが用意されています。
次のメソッドが公開されます。
getSimilarObjects
- これは、複雑な類似度計算レシピとノード・クラスおよびアクションのフィルタ処理の選択肢とともに、指定されたソースと類似度計算用のSuggestionWrappers
のリストを返します。
queryCommonObjects
- 類似としてアクティビティ・グラフによってお薦めされる特定の2つのオブジェクト。これは2つの類似オブジェクトがやり取りするその他のオブジェクトのリストを返します。このリストは、推奨を生成した対話に関与アプリケーション・オブジェクトへのリンクとその詳細を提供するために使用できます。
recordNotInterested
- これは、ユーザーが指定のオブジェクトとやり取りしていないことを記録します。
たとえば、getSimilarObjects()
メソッドで、レシピitem-edit=100,item-all=1
を使用して現在のユーザーと類似のユーザーのリストを取得できます。推奨は、SuggestionWrapper
オブジェクトの形で返されます。アプリケーションは、SuggestionWrapper
から、推奨の理由を表す文字列と、最高スコアの提案を生成した類似度計算のURNを取得します。現在のユーザーが「bill」で、getSimilarObjects()
から返された最上位推奨ユーザーが「cathy」であるとします。「cathy」のSuggestionWrapper
は、「あなたとCathyは共通の3アイテムを編集しました」などの理由文字列を生成することがあり、最上位類似度計算はitem-edit
になります。
この情報に基づき、アプリケーションは、queryCommonObjects()
をコールし、ソース・オブジェクトとして「bill」、ターゲット・オブジェクトとして「cathy」、類似度URNとしてitem-edit
を渡して、両方のユーザーが編集した3つのドキュメントの名前、アイコンおよびURLを取得できます。名前、アイコンURLおよびアプリケーション・オブジェクトURLは、queryCommonObjects()
から返されたQueryResultWrapper
オブジェクトから取得できます。
通常、データ・コントロールとメソッドのバインディングには、MethodAction
、MethodIterator
(メソッドの結果を反復するため)およびTree
(生成されるデータ構造の各属性を取得するため)という3つの構成要素が必要になります。これらは、ページ定義ファイルで手動で作成したり、より簡単な方法としてJDeveloper付属のウィザードを使用して作成できます。
推奨データ・コントロールのgetSimilarObjects
メソッドまたはqueryCommonObjects
メソッドのいずれかをプロジェクトに追加するには、次の手順を実行します。
推奨データ・コントロールをプロジェクトに追加します(カタログ内でそれを選択し、右クリックして「プロジェクトに追加」を選択するか、またはプロジェクト内でそれをJSPページ(.jspx
)にドラッグ・アンド・ドロップすることで)。
ADF表をJSPページへドラッグします。
要求されたら、「データソースにバインド」チェック・ボックスを選択します。
「推奨データ・コントロール」に移動し、必要なAPIメソッドからのSuggestionWrapper結果を選択します。これにより、メソッド・アクション・バインディングと結果コレクションへのイテレータが自動的に作成されます。
公開するノードを選択します。これにより、提案内の値にアクセスするためのツリーが自動的に作成されます。
メソッド・アクションのパラメータを構成します。通常、これらはpageFlowScope
変数として定義されている式です。
getSimilarObjects
メソッドの場合、次のとおりです。
classURN
- 推奨ソースのノード・クラスのURN。たとえば、WC.user
objectURN
- 推奨ソースのURN。たとえば、#{securityContext.userName}
userCredentialClass
- nullの場合、WebCenter Portalユーザー・タイプが使用されます。
recipe
- 使用される類似度計算とそれらに関連付けられた重みのカンマ区切りリスト。例:
類似アイテム・タスク・フローの場合:
item-edit=100,item-like=50,item-comment=20,item-tag=10,item-all=1
推奨コネクション・タスク・フローの場合:
user-connect=100,user-edit=50,user-like=50,user-comment=10,user-tag=10,user-all=1
classURNRestrictionList
- 結果をフィルタするためのクラスのカンマ区切りリスト。
excludeObjectActionList
- 結果のフィルタに使用するアクションURNのカンマ区切りリスト。
maxResults
- 返される推奨の最大数。
queryCommonObjects
メソッドの場合、次のとおりです。
srcClassURN
- 推奨のソース・オブジェクトのノード・クラスのURN。たとえば、WC.user
srcObjectURN
- 推奨のソース・オブジェクトのURN。たとえば、#{securityContext.userName}
trgClassURN
- ターゲット・オブジェクト(つまり、推奨オブジェクト)のノード・クラスのURN。
trgObjectURN
- ターゲット・オブジェクト(つまり、推奨オブジェクト)のURN。
userCredentialClass
- nullの場合、WebCenter Portalユーザー・タイプが使用されます。
similarityURN
- 推奨に使用される類似度計算のURN。
maxResults
- 返される共通オブジェクトの最大数。結果は最近のアクション発生日別にソートされ、最上位のmaxResultsオブジェクトが返されます。
注意: 便宜上、 |
推奨データ・コントロールのrecordNotInterested
メソッドをプロジェクトに追加するには、次の手順を実行します。
プロジェクト内でボタン・コンポーネントを(ADF Facesから)JSPページ(.jspx
)へドラッグ・アンド・ドロップします。
ボタン・コントロールを右クリックし、「ADFコントロールにバインド」をクリックします。
「ADFコントロールにバインド」ウィンドウで、推奨データ・コントロールを展開し、recordNotInterested()メソッドを選択します。
「OK」をクリックして「ADFコントロールにバインド」ウィンドウを閉じます。
「アクション・バインディングの編集」ウィンドウで次のパラメータの値を入力します。
classURN
- 推奨ソースのノード・クラスのURN。たとえば、WC.user
objectURN
- 推奨ソースのURN。たとえば、#{securityContext.userName}
「OK」をクリックします。
WebCenter Portalには、アクティビティ・グラフ・サービスをサポートするREST APが用意されています。アクティビティ・グラフ・サービスREST APIを使用すると、コネクション、スペースおよびアイテムの推奨を提供するための独自のインタフェースを作成できます。
この項では、アクティビティ・グラフ・サービスに関連付けられているREST APIについて説明します。次のサブセクションが含まれます:
REST APIの概要は、第53章「Oracle WebCenter Portal REST APIの使用」を参照してください。
各RESTサービスは、そのサービスのエントリ・ポイントを提供するリソース索引内にリンク要素を持っています。アクティビティ・グラフ・サービスには、推奨用とアイテム用の2つのエントリ・ポイントがあります。アクティビティ・グラフ・サービスのエントリ・ポイントを検索するには、次のいずれかのresourceType
を使用したリンク要素を検索します。
urn:oracle:webcenter:activitygraph:recommendations urn:oracle:webcenter:activitygraph:items
対応するhref
またはtemplate
要素によって、URIエントリ・ポイントが提供されます。クライアントは、このエントリ・ポイントにHTTPリクエストを送信し、アクティビティ・グラフ・サービスを使用します。
リソース索引の詳細は、第53.5.1項「リソース索引」を参照してください。
リソース・タイプの詳細は、第53.5.2.1項「リソース・タイプ」を参照してください。
クライアントでは、使用するエントリ・ポイントが識別されると、リソース・タイプの分類が精査されて必要な操作が実行されます。個々のリソース・タイプの詳細は、第45.3.2.2項「アクティビティ・グラフのリソース・タイプの分類」の該当箇所を参照してください。
アクティビティ・グラフ・サービスの分類は、次のとおりです。
urn:oracle:webcenter:activitygraph:recommendations urn:oracle:webcenter:activitygraph:recommendations:recommendation urn:oracle:webcenter:activitygraph:items urn:oracle:webcenter:activitygraph:items:item
このサービスでは、セキュリティに関する特定の考慮事項はありません。一般的なセキュリティに関する考慮事項については、第53.8項「WebCenter Portal REST APIのセキュリティに関する考慮事項」を参照してください。
この項では、各リソース・タイプについて知っておく必要があるすべての情報を提供します。次のサブセクションが含まれます:
第45.3.2.4.1項「urn:oracle:webcenter:activitygraph:recommendations」
第45.3.2.4.2「urn:oracle:webcenter:activitygraph:recommendations:recommendation」
このリソースを使用して、指定したオブジェクトに対する類似度に基づいて推奨されたコネクション、スペース、アイテムの取得(GET
)に使用するURIを識別します。GET
操作のレスポンスには、要求されているリストの各オブジェクトが含まれ、各オブジェクトには、そのオブジェクトの操作に使用した各リンクが含まれます。
アクティビティ・グラフに存在する各ノードは、ノード・クラスURNとオブジェクトURNの組合せによって識別されます。
たとえば、montyというユーザーを識別するには、次のように指定できます。
classURN=WC.user
objectURN=monty
デフォルトで提供されるノードは、すべてWebCenter Portalリソース(ユーザー、ドキュメント、スペースなど)であるため、WebCenter PortalサービスとリソースIDを備えています。アクティビティ・グラフREST APIは、serviceId
とobjectURN
(リソースIDを含む)を使用してこれらのデフォルト・ノードを識別するための別の方法を提供します。
たとえば、montyというユーザーを識別するには、次のように指定できます。
serviceId=oracle.webcenter.people
objectURN=monty
サービスのオブジェクトが、ドキュメント・サービスなどのリソース・タイプでさらに分類されている場合、そのリソース・タイプも指定する必要があります。
たとえば、特定のドキュメントを識別するには、次のように指定できます。
serviceId=oracle.webcenter.doclib
resourceType=document
objectURN=document1
作成された新しいノード・クラス(つまり、非ネイティブのWebCenter Portalオブジェクト)はすべて、ノード・クラスとオブジェクトURNを使用して識別する必要があります。
recommendationsへのナビゲーション・パス
この項では、クライアントがハイパーメディアを経由してこのリソースにアクセスする方法を示します:
resourceIndex recommendations
recommendationsでサポートされるメソッド
次のメソッドは、このリソースによりサポートされています:
GET
リクエスト - パラメータ: startIndex
、itemsPerPage
、utoken
。
これらの共通パラメータの情報は、「共通のリクエスト問合せパラメータ」を参照してください。
次の追加パラメータを使用できます。
classURN
- 推奨を要求するオブジェクトのタイプを識別するノード・クラスURN。たとえば、WC.user
、WC.group-document
です。
objectURN
- 推奨を要求するオブジェクトに一意の識別子を提供するオブジェクトURN。たとえば、monty
、1000
です。
recipe
- 推奨オブジェクトを決定するために使用される類似度URNとオプションで関連付けられた重み(コロンで示される)のセミコロン区切りのリスト。たとえば、gs-edit:10;gs-all:1
です。
classURNRestrictions
- 推奨に含めるノード・クラスのカンマ区切りリスト。非nullの場合、指定したノード・クラスのオブジェクトのみが推奨に含まれます。
excludeObjectActions
- 現在のユーザーがオブジェクトにアクションを実行した場合に推奨からオブジェクトを除外するために使用され、アクションURNによって識別されるアクションのカンマ区切りリスト。たとえば、クライアントが推奨スペースを取得する場合は、(ユーザーがそれらのスペースを認識した以降に)クライアント・ユーザーが編集したスペースを除外するためにgs-edit
アクションを指定できます。
serviceId
- 推奨を要求するオブジェクトのタイプを識別するWebCenter PortalサービスID(デフォルト・オブジェクトのclassURN
のかわりにこれを使用できます)。
resourceType
- 推奨をリクエストしているオブジェクトのWebCenter Portalリソース・タイプ。必要に応じて、serviceId
と組み合せて使用します。
userCredentialClassURN
- ユーザー演習用REST APIのノード・クラスURN。デフォルト値はWC.user
です。アクティビティ・グラフ・エンジンを別のアプリケーションに統合する場合、別のノード・クラスへの変更が必要な場合があります。
レスポンス - 本体: 0以上の推奨
詳細は、第53.5.2.5項「テンプレート」を参照してください。
recommendationsからリンクされるリソース・タイプ
表45-8に、クライアントがこのリソースからリンクできるリソース・タイプを示します。
推奨レスポンスには、推奨オブジェクトと、そのオブジェクトへのアクセスに使用するURIが含まれています。
recommendationへのナビゲーション・パス
この項では、クライアントがハイパーメディアを経由してrecommendationリソースにアクセスする方法を示します。
resourceIndex recommendations recommendation
recommendationの読取り専用要素
表45-9に、recommendationsリソースの読取り専用要素を示します。
表45-9 recommendationの読取り専用要素
要素 | タイプ | 説明 |
---|---|---|
|
Float |
リスト内の他の推奨と比較して計算された、この推奨の総合スコア。レシピを構成する個々の類似URNに関連付けられたコンポーネント・スコアの重み付けされた合計で、0から1の浮動小数点数からなります。 |
|
urn:oracle:webcenter:activitygraph:items:item |
推奨されているユーザー、アイテムまたはスペース。 |
|
|
推奨用のレシピ内の各類似URNに関連付けられたコンポーネント・スコアのリスト。コンポーネント・スコアは、理由およびユーザーと推奨オブジェクトがやり取りする共通のアイテムを取得するために使用できるリンクを備えている場合があります。 |
このリソースを使用して、ソース・オブジェクトと推奨オブジェクトの両方に共通するオブジェクトの取得(GET
)に使用するURIを識別します。これにより、特定のオブジェクトがなぜ推奨されたのか、その理由を調べることができます。GET
操作のレスポンスには、このアイテム・コレクションの各アイテムが含まれ、各アイテムには、そのアイテムの操作に使用した各リンクが含まれます。
itemsへのナビゲーション・パス
この項では、クライアントがハイパーメディアを経由してこのリソースにアクセスする方法を示します:
resourceIndex items
itemsでサポートされるメソッド
次のメソッドは、このリソースによりサポートされています:
GET
リクエスト - パラメータ: startIndex
、itemsPerPage
、utoken
。
これらの共通パラメータの情報は、「共通のリクエスト問合せパラメータ」を参照してください。
次の追加パラメータを使用できます。
similarityURN
- オブジェクトが推奨オブジェクトと類似であるか判断するために使用される類似度計算のURN。たとえば、item-tag
、gs-edit
、user-connect
です。
srcClassURN
- 推奨を要求するために使用されたオブジェクトのタイプを識別するノード・クラスURN。たとえば、WC.user
、WC.group-document
です。
srcObjectURN
- 推奨を要求するために使用されたオブジェクトのURN。たとえば、monty
、1000
です。
trgClassURN
- 推奨オブジェクトのタイプを識別するノード・クラスURN。
trgObjectURN
- 推奨オブジェクトの一意の識別子を提供するオブジェクトURN。
userCredentialClassURN
- ユーザー演習用REST APIのノード・クラスURN。デフォルト値はWC.user
です。アクティビティ・グラフ・エンジンを別のアプリケーションに統合する場合、別のノード・クラスへの変更が必要な場合があります。
レスポンス - 本体: 1つ以上のアイテム
詳細は、第53.5.2.5項「テンプレート」を参照してください。
itemsからリンクされるリソース・タイプ
表45-10に、クライアントがこのリソースからリンクできるリソース・タイプを示します。
このリソース・タイプを使用して、推奨の更新(PUT
)に使用するURIを識別します(推奨オブジェクトにユーザーが興味を持ったことを示すためです)。
itemへのナビゲーション・パス
この項では、クライアントがハイパーメディアを経由してitemリソースにアクセスする方法を示します。
resourceIndex recommendations recommendation item resourceIndex items item
itemでサポートされるメソッド
このリソース・タイプによってサポートされるメソッドは次のとおりです。
PUT
リクエスト - 本体: item
レスポンス - 本体: item
itemの書込み可能要素
表45-11に、このリソース・タイプの書込み可能要素を示します。
itemの読取り専用要素
表45-12に、このリソース・タイプの読取り専用要素を示します。これらの要素の中にはオブジェクトで使用できないものもあります。
表45-12 itemの読取り専用要素
要素 | タイプ | 説明 |
---|---|---|
classURN |
String |
オブジェクトのノード・クラス |
objectURN |
String |
オブジェクトの識別子 |
name |
String |
オブジェクトの名前 |
description |
String |
オブジェクトの説明 |
modified |
日付 |
オブジェクトの最終更新日 |
modifiedByUser |
PersonReference |
オブジェクトを最後に更新したユーザーに関するユーザー情報。GUID、ID、表示名およびプロファイル・アイコンへのリンクが含まれます |
author |
PersonReference |
オブジェクトを作成したユーザーに関するユーザー情報。GUID、ID、表示名およびプロファイル・アイコンへのリンクが含まれます |
itemからリンクされるリソース・タイプ
表45-13に、クライアントがこのリソースからリンクできるリソース・タイプを示します。
出荷時のアクティビティ・グラフには、WebCenter Portalサービスのイベント・データをWebCenter Portal分析にマッピングするためのメタデータ定義が含まれています。このメタデータは、アクティビティ・グラフ・エンジン・アプリケーションの最初の起動時に自動的にロードされます。
XMLファイルを操作することでアクティビティ・グラフのメタデータを拡張して、WebCenter Portal分析によるアクションの収集方法を変更できます。これらのXMLファイルは、エクスポートしてテキスト・エディタで編集した後、インポートできます。
アクティビティ・グラフのメタデータ定義を更新するには、まずローカルXMLファイルにエクスポートする必要があります。
アクティビティ・グラフのメタデータ定義をエクスポートする方法については、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のアクティビティ・グラフ・メタデータのエクスポートに関する項を参照してください。
分析マッピングのメタデータ定義をエクスポートする方法については、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のプロバイダ構成のエクスポートに関する項を参照してください。
メタデータ定義を適切なファイルにエクスポートしたら、任意のエディタでファイルを編集して独自の定義を追加できます。変更後は、メタデータ・ファイルを管理対象サーバーにインポートしなおす必要があります。アクティビティ・グラフのメタデータ定義ファイルのインポート方法については、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のアクティビティ・グラフ・メタデータのインポートに関する項を参照してください。
この項には次のサブセクションが含まれます:
アクティビティ・グラフのメタデータでは、ユーザー、スペース、ドキュメントなどのWebCenter Portalオブジェクトを表すノード・クラスが定義されます。WebCenter Portalでサポートされているデフォルトのノード・クラスのリストおよびノード・クラスの定義の詳細は、「ノード・クラス」を参照してください。
アクティビティ・グラフのメタデータ定義をXMLファイルにエクスポートし、そのファイルを編集してから、メタデータをWebCenter Portalにインポートしなおすことで、他のWebCenter Portalオブジェクト用または他のアプリケーションのオブジェクト用に独自のノード・クラスを定義できます。たとえば、CRMアプリケーションをアクティビティ・グラフに統合する場合は、サービス・リクエスト用のノード・クラスを定義できます。
カスタム・ノード・クラスを定義するには:
WLSTコマンドexportAGMetadata
を使用して、アクティビティ・グラフのメタデータをローカルXMLファイルにエクスポートします。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のアクティビティ・グラフのメタデータのエクスポートに関する項を参照してください。
XMLファイルを編集して新しいノード・クラスを定義します。各カスタム・ノード・クラスでは、次のものを指定する必要があります。
URN
- nodeClass
要素の属性。これは、ノード・クラスを一意に識別する文字列です
nodeType
- ノード・クラスによって定義されているオブジェクトがアイテムかユーザーかを示すサブ要素。有効な値はItem
またはUser
です。
numericURNs
- このクラスのオブジェクトのURNが数値かどうかを示すサブ要素。これにより、アクティビティ・グラフを、数値IDを使用するアプリケーションとより効率的に統合できます。有効な値はtrue
またはfalse
です。
properties
- 名前、値ペアのリスト。ノード・クラスのプロパティは、実行時にクラスに関する追加メタデータを提供するために使用できます。たとえば、アクティビティ・グラフでモデル化されているすべてのデフォルトWebCenter Portalオブジェクトが、それぞれのサービスとリソース・タイプに基づいて推奨の表示をカスタマイズするためにアクティビティ・グラフ・タスク・フローによって使用されるserviceID
とresourceType
のプロパティを定義します。
<properties> <property name="oracle.webcenter.resourceType" value="wiki" /> <property name="oracle.webcenter.serviceID" value="oracle.webcenter.doclib" /> </properties>
WLSTコマンドimportAGMetadata
を使用して、更新済のアクティビティ・グラフ・メタデータ・ファイルをFrameworkアプリケーションのデプロイ先の管理対象サーバーにインポートします。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のアクティビティ・グラフのメタデータのインポートに関する項を参照してください。
アクティビティ・グラフには、Frameworkアプリケーションで発生するアクション用のメタデータ定義が含まれています。詳細は、「アクション」を参照してください。
アクティビティ・グラフのメタデータ定義をXMLファイルにエクスポートし、そのファイルを編集してから、メタデータをWebCenter Portalにインポートしなおすことで、WebCenter Portal用または他のアプリケーション用に独自のアクションを定義できます。たとえば、CRMアプリケーションをアクティビティ・グラフに統合する場合は、サービス・リクエストのオープン用、技術サポートへのサービス・リクエストの割当て用、およびサービス・リクエストのクローズ用に新しいアクションを定義できます。
カスタム・アクションを定義するには:
WLSTコマンドexportAGMetadata
を使用して、アクティビティ・グラフのメタデータをローカルXMLファイルにエクスポートします。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のアクティビティ・グラフのメタデータのエクスポートに関する項を参照してください。
XMLファイルを編集して新しいアクションを定義します。各カスタム・アクションでは、次のものを指定する必要があります。
URN
- action
要素の属性。これは、アクションを一意に識別する文字列です
actionType
- サブ要素。有効な値は、次のとおりです:
Simple
- カウントする際に役立つアクション。ソース、ターゲットおよび発生時刻以外のメタデータは存在しません。たとえば、WebCenter Portalには、ユーザーが同一アイテムをクリックするたびに、関連付けられたリレーション値が増加し、時間の経過とともに値が減衰する、事前登録済のview-count
単純アクションが用意されています。
Boolean
- ある事象の発生回数ではなく、発生の有無を確認する際に役立つアクション。Booleanアクションには、それ以外に1つのBooleanがメタデータとして存在します。たとえば、WebCenter Portalには、ユーザーが同一アイテムをクリックしても関連付けられたリレーション値が増加しない、Boolean型のview
アクションが用意されています。このアクションでは、単にユーザーが特定のアイテムをクリックしたかどうかが記録されます。
Non-negative Integer
- 整数を負の数にできないメタデータとして1つの追加整数を持つアクション。評価(複数の星の割当て)は典型的な例です。
Integer
- 1つの追加整数がメタデータとして存在するアクション。負の値の指定が許可されている評価で使用できます。
symmetric
- アクションのソースとターゲットが相互に交換可能かどうかを示すサブ要素。対称アクションの例として、ピープル・コネクション・サービスで2人のユーザーがコネクションを持ったときに発生するconnect
アクションがあげられます。有効な値はtrue
またはfalse
です。
sourceType
- アクションの実行オブジェクトのタイプを識別するサブ要素。有効な値はUser
またはItem
です。
targetType
- アクションの実行対象オブジェクトのタイプを識別するサブ要素。有効な値はUser
またはItem
です。
relationType
- サブ要素。有効な値はSum
またはLastAssigned
です。edit-count
アクションなどのSum
アクションは、発生するたびに増加します。LastAssigned
アクションでは、最近発生したアクションで渡された値が保持されます。create
やedit
などの、カウントではない単純アクションはLastAssigned
アクションです。LastAssigned Integer
アクションの例は評価アクションです。
relationDecayPeriod
- (オプション)アクションの値が失われる(減衰する)までの時間(日数)を示すサブ要素。リレーション値の計算では、アクションの発生後の一定の減衰期間が経過するたびに、各アクションの値が減衰因子で乗算されます。
relationDecayFactor
- (オプション)減衰期間の後アクションの値がどのぐらい減少(または減衰)するかを決定する0と1の間の浮動小数値であるサブ要素。リレーション値の計算では、アクションの発生後の一定の減衰期間が経過するたびに、各アクションの値が減衰因子で乗算されます。
例45-2 アクション定義
<actions> ... <action URN="connect"> <actionType>Boolean</actionType> <symmetric>true</symmetric> <sourceType>User</sourceType> <targetType>User</targetType> <relationType>LastAssigned</relationType> <relationIsNonNegative>true</relationIsNonNegative> </action> ... <action URN="edit-count"> <actionType>Simple</actionType> <symmetric>false</symmetric> <sourceType>User</sourceType> <targetType>Item</targetType> <relationType>Sum</relationType> <relationDecayPeriod>1</relationDecayPeriod> <relationDecayFactor>0.97</relationDecayFactor> </action> ... </actions>
WLSTコマンドimportAGMetadata
を使用して、更新済のアクティビティ・グラフ・メタデータ・ファイルをFrameworkアプリケーションのデプロイ先の管理対象サーバーにインポートします。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のアクティビティ・グラフのメタデータのインポートに関する項を参照してください。
アクティビティ・グラフには、WebCenter Portalで使用されている類似度計算のメタデータ定義が含まれます。詳細は、「類似度計算」を参照してください。
アクティビティ・グラフのメタデータ定義をXMLファイルにエクスポートし、そのファイルを編集してから、メタデータをWebCenter Portalにインポートしなおすことで、WebCenter Portal用または他のアプリケーション用に独自の類似度計算を定義できます。たとえば、CRMアプリケーションをアクティビティ・グラフに統合する場合は、item-assign
類似度計算を定義して、同じユーザーに割り当てられている他のサービス・リクエストの推奨に役立てられます。
カスタム類似度計算を定義するには:
WLSTコマンドexportAGMetadata
を使用して、アクティビティ・グラフのメタデータをローカルXMLファイルにエクスポートします。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のアクティビティ・グラフのメタデータのエクスポートに関する項を参照してください。
XMLファイルを編集して新しい類似度計算を定義します。各類似度計算では、次のものを指定する必要があります。
URN
- 類似度計算要素の属性。これは、類似度計算を一意に識別する文字列です。
similarityFunction
- アイテム間の類似度を計算するファンクションを識別するサブ要素。現時点では、Tanimoto
という類似度ファンクションのみがサポートされています。このファンクションは、2つのアイテム間の類似度を、共通アクション数とアイテムに対する合計アクション数の比率として計算します。
domainClasses
- 類似度スコアの計算対象であるノード・クラスを識別するサブ要素。類似度計算のリレーションの組合せで表されるアクションのターゲットです。
backgroundClasses
- ノード・クラスを識別するサブ要素。類似度計算のリレーションの組合せで表されるアクションのソースです。
relationCombination
- 1つ以上の登録済リレーションを組み合せることにより新しいリレーションを定義するサブ要素。リレーションの組合せには次の2つのタイプがあります。
Boolean OR
(WebCenter Portalの即時利用可能なすべての類似度計算で使用される)。コンポーネント・リレーションのいずれかが正の値である場合、リレーションの組合せの結果値は1
(true)になり、そうでない場合は、0
(false)になります。
Weighted Sum
(WebCenter Portalの即時利用可能なすべてのランク計算で使用される)。リレーションの組合せの結果値は、各コンポーネント・リレーションの重み付けされた値の合計です。
各コンポーネント・リレーションでは、次のものを指定します。
actionURN
- コンポーネント・リレーションのアクションのURN
use inverse
- コンポーネント・リレーションを使用してターゲット・オブジェクトの類似度を直接計算するにはfalse
(デフォルト)に設定し、コンポーネント・リレーションを使用してターゲット・オブジェクトではなくソース・オブジェクトの類似度を計算するにはtrue
に設定します。たとえば、view
リレーションのソース・オブジェクト(user
)がターゲット・オブジェクト(document
)を表示している場合、ドキュメントの類似度を計算するにはuse inverse=false
を設定します。ソース・オブジェクト(users)の類似度を計算するにはuse inverse=true
を設定します。
weight
- (Weighted Sum
リレーションの組合せの場合)浮動小数として表され、コンポーネント・リレーションに適用される重み
例45-3 類似度計算の定義
<similarityCalculations> <similarityCalculation URN="item-edit"> <similarityFunction>Tanamoto</similarityFunction> <domainClasses> <URN>document:wcServiceID=oracle.webcenter.doclib</URN> <URN>wiki-page:wcServiceID=oracle.webcenter.wiki</URN> <URN>blog:wcServiceID=oracle.webcenter.wiki</URN> <URN>topic:wcServiceID=oracle.webcenter.collab.forum</URN> </domainClasses> <backgroundClasses> <URN>user:wcServiceID=oracle.webcenter.people</URN> </backgroundClasses> <relationCombination type="BOOLEAN_OR"> <component inverse="false" actionURN="create" /> <component inverse="false" actionURN="comment" /> <component inverse="false" actionURN="edit" /> </relationCombination> </similarityCalculation> </similarityCalculations>
WLSTコマンドimportAGMetadata
を使用して、更新済のアクティビティ・グラフ・メタデータ・ファイルをFrameworkアプリケーションのデプロイ先の管理対象サーバーにインポートします。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のアクティビティ・グラフのメタデータのインポートに関する項を参照してください。
アクティビティ・グラフには、アクティビティ・グラフ・ランク・エンジンがアクティビティ・グラフ内のノードの重要度を計算するために使用するランク計算のメタデータ定義が含まれます。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のOracle Secure Enterprise Searchのアクティビティ・ランクの設定に関する項を参照してください。
アクティビティ・グラフのメタデータ定義をXMLファイルにエクスポートし、そのファイルを編集してから、メタデータをWebCenter Portalにインポートしなおすことで、WebCenter Portal用または他のアプリケーション用に独自のランク計算を定義できます。
カスタム・ランク計算を定義するには:
WLSTコマンドexportAGMetadata
を使用して、アクティビティ・グラフのメタデータをローカルXMLファイルにエクスポートします。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のアクティビティ・グラフのメタデータのエクスポートに関する項を参照してください。
XMLファイルを編集して新しいランク計算を定義します。各ランク計算では、次のものを指定する必要があります。
URN
- rankCalculation
要素の属性。これは、ランク計算を一意に識別する文字列です。
domainClasses
- ランク計算の適用対象であるノード・クラスのリストを識別するサブ要素。
relationCombination
- 1つ以上の登録済リレーションを組み合せることにより新しいリレーションを定義するサブ要素。リレーションの組合せには次の2つのタイプがあります。
Boolean OR
(WebCenter Portalの即時利用可能なすべての類似度計算で使用される)。コンポーネント・リレーションのいずれかが正の値である場合、リレーションの組合せの結果値は1
(true)になり、そうでない場合は、0
(false)になります。
Weighted Sum
(WebCenter Portalの即時利用可能なすべてのランク計算で使用される)。リレーションの組合せの結果値は、各コンポーネント・リレーションの重み付けされた値の合計です。
各コンポーネント・リレーションでは、次のものを指定します。
actionURN
- コンポーネント・リレーションのアクションのURN
use inverse
- コンポーネント・リレーションを使用してターゲット・オブジェクトの類似度を直接計算するにはfalse
(デフォルト)に設定し、コンポーネント・リレーションを使用してターゲット・オブジェクトではなくソース・オブジェクトの類似度を計算するにはtrue
に設定します。たとえば、view
リレーションのソース・オブジェクト(user
)がターゲット・オブジェクト(document
)を表示している場合、ドキュメントの類似度を計算するにはuse inverse=false
を設定します。ソース・オブジェクト(users)の類似度を計算するにはuse inverse=true
を設定します。
weight
- (Weighted Sum
リレーションの組合せの場合)浮動小数として表され、コンポーネント・リレーションに適用される重み
resultAcceptorClass
- IRankResultAcceptor
インタフェースの実装クラスの完全修飾されたクラス名を識別するサブ要素。このクラスでは、ランク・エンジンから受け取った一連のオブジェクト・ランクが検索エンジンに格納された後、そこで検索問合せの表示ランクを変更するために使用されます。WebCenter Portalには、単一のランク・アクセプタが付属しており、Oracle Secure Enterprise Searchに表示ランクを永続化させます。
例45-4 ランク計算の定義
<rankCalculations> <rankCalculation URN="activity-rank"> <domainClasses> <URN>WC.user</URN> <URN>WC.document</URN> <URN>WC.wiki-page</URN> <URN>WC.blog</URN> </domainClasses> <relationCombination type="WEIGHTED_SUM"> <component actionURN="connect" weight="10.0" /> <component actionURN="edit" weight="20.0" inverse="true" /> <component actionURN="view-count" weight="1.0" /> <component actionURN="create" weight="100.0" inverse="true" /> <component actionURN="create" weight="100.0" /> <component actionURN="edit-count" weight="20.0" /> <component actionURN="download" weight="5.0" /> <component actionURN="tag" weight="10.0" /> <component actionURN="comment" weight="10.0" /> </relationCombination> <resultAcceptorClass> oracle.webcenter.activitygraph.providers.rankAcceptors.ses.SesRankResultAcceptor </resultAcceptorClass> </rankCalculation> </rankCalculations>
WLSTコマンドimportAGMetadata
を使用して、更新済のアクティビティ・グラフ・メタデータ・ファイルをFrameworkアプリケーションのデプロイ先の管理対象サーバーにインポートします。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のアクティビティ・グラフのメタデータのインポートに関する項を参照してください。
アクティビティ・プロバイダは、収集プロセス時にアクションの発生記録からアクティビティを生成する際にアクティビティ・グラフ・エンジンによって使用されます。たとえば、分析アクティビティ・プロバイダは、分析イベント表のアクションを読み取った後、登録済のマッピング・セットを使用してアクティビティを生成します。これらのアクティビティからリレーションが特定され、このリレーションを使用して推奨や検索ランクが決定されます。
他のアプリケーションをアクティビティ・グラフ・エンジンに統合する場合は、これらのアプリケーションからアクティビティを生成するために独自のアクティビティ・プロバイダを作成できます。
アクティビティ・グラフ・エンジンでカスタム・アクティビティ・プロバイダを使用可能にするには、アクティビティ・グラフのメタデータ定義にアクティビティ・プロバイダ割当てを追加して登録する必要があります。アクティビティ・プロバイダ割当てでは、action
、srcClass
およびtrgClass
の3つの方式が、アクティビティ・プロバイダを実装するJavaクラスにマッピングされます。
注意: これらの3つの方式より多くの方式を同じプロバイダ・クラスにマッピングする場合、3つの方式ごとにプロバイダ割当てを行う必要があります。たとえば、出荷時のメタデータでは、3つの方式を |
カスタム・アクティビティ・プロバイダを登録するには:
WLSTコマンドexportAGMetadata
を使用して、アクティビティ・グラフのメタデータをローカルXMLファイルにエクスポートします。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のアクティビティ・グラフのメタデータのエクスポートに関する項を参照してください。
XMLファイルを編集して新しいアクティビティ・プロバイダ割当てを定義します。各アクティビティ・プロバイダ割当てでは、次のものを指定する必要があります。
action
- providerAssignment
要素の属性で、providerClass
にマップされるアクションを指定します。登録済アクションのいずれかを指定します。
srcClass
- providerAssignment
要素の属性で、providerClass
にマップされるソース・クラスを指定します。登録済ノード・クラスのいずれかを指定します。
trgClass
- providerAssignment
要素の属性で、providerClass
にマップされるターゲット・クラスを指定します。登録済ノード・クラスのいずれかを指定します。
providerClass
- 指定したアクション、ソース・クラス、および3つの方式のターゲット・クラスのアクティビティ・プロバイダを実装するJavaクラスの、完全修飾された名前を識別するサブ要素。
WLSTコマンドimportAGMetadata
を使用して、更新済のアクティビティ・グラフ・メタデータ・ファイルをFrameworkアプリケーションのデプロイ先の管理対象サーバーにインポートします。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のアクティビティ・グラフのメタデータのインポートに関する項を参照してください。
WebCenter Portalには、推奨結果をフィルタ処理するための複数のQRPPが用意されています。詳細は、「問合せ結果ポスト・プロセッサ(QRPP)」を参照してください。
独自のQRPPを作成して推奨結果にさらにフィルタ処理を加えたり、アクティビティ・グラフ・エンジンを他のアプリケーションに統合する際に推奨メタデータを表示する機能を提供できます。アクティビティ・グラフ・エンジンでQRPPを使用可能にするには、アクティビティ・グラフのメタデータ定義にQRPP登録を追加して登録する必要があります。
カスタムQRPPを登録するには:
WLSTコマンドexportAGMetadata
を使用して、アクティビティ・グラフのメタデータをローカルXMLファイルにエクスポートします。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のアクティビティ・グラフのメタデータのエクスポートに関する項を参照してください。
XMLファイルを編集して新しいQRPPを登録します。各QRPPでは、次のものを指定する必要があります。
URN
- QRPP
要素の属性。これは、QRPPを一意に識別する文字列です。
priority
- QRPP
要素の属性。これは、他の登録済QRPPに対応して、QRPPがどの順序で実行される必要があるかを示す整数です。
description
- QRPPの実行内容の簡単な説明を提供するサブ要素。
providerClass
- QRPPを実装するJavaクラスの完全修飾された名前を識別するサブ要素。
例45-6 QRPPの定義
<QRPPs> <QRPP priority="1" URN="WebCenter Portal Security QRPP"> <description> Uses the WebCenter Portal Resource Authorizer to perform security filtering. </description> <providerClass> oracle.webcenter.activitygraph.providers.qrpps.security.WCSecurityQueryResultPostProcessor </providerClass> </QRPP> </QRPPs>
WLSTコマンドimportAGMetadata
を使用して、更新済のアクティビティ・グラフ・メタデータ・ファイルをFrameworkアプリケーションのデプロイ先の管理対象サーバーにインポートします。詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のアクティビティ・グラフのメタデータのインポートに関する項を参照してください。
この項では、アクティビティ・グラフ・サービスの使用中に発生する可能性がある問題のトラブルシューティングに役立つ情報を提供します。
トラブルシューティングのソリューションでは、次が前提となります:
アクティビティ・グラフ・エンジンが正しくデプロイされている
WC_Utilities
管理対象サーバーが起動され、稼働中である
プロパティopenusage enabled
がtrue
である
問題
有効なユーザー・アクティビティの実行後でも、タスク・フローに推奨が表示されません。
解決方法
イベントが分析イベント・コレクタによって取得されているかどうかを確認してください。これは、コレクタ・ログを確認することにより検証できます。このログにイベントの取得が記録されていない場合、分析イベント・コレクタに問題があります。
詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』の分析イベント・コレクションの検証に関する項を参照してください。
問題
分析イベント・コレクタのログにはイベントが取得されていることが記録されていますが、タスク・フローには推奨が表示されません。
解決方法
「アクティビティ・グラフのスケジュールとステータス」ページで、アクティビティ・グラフ・エンジンの前回の実行時刻を確認してください。最近のイベントを収集および分析するには、スケジュールの調整かアクティビティ・グラフ・エンジンの即時実行が必要になることがあります。
問題
アクティビティ・グラフ・エンジンが正常に実行されましたが、タスク・フローには推奨が表示されません。
解決方法
アクティビティ・データベース(ActivitiesDS
)のリレーション表にデータが存在するかどうかを確認してください。アクティビティ・グラフ・エンジンが正しく動作している場合は、これらのリレーション表になんらかのデータが存在するはずです。表にデータが存在するのにタスク・フローに推奨がまだ表示されない場合は、タスク・フローが破損している可能性があります。
問題
有効なユーザー操作であるにもかかわらず、一部のユーザーが推奨コネクションとして表示されません。
解決方法
これは、WebCenter Portal: Spacesとサービスが同一のOIDに接続されていない場合に発生する可能性があります。この場合、各サービスの接続先OIDに存在しないユーザーには、推奨コネクションが提案されません。2つのOIDのどちらにも同じユーザーを作成するか、WebCenter Portal: Spacesとサービスを同一のOIDに接続する必要があります。
類似アイテム・タスク・フローに推奨アイテムが表示されるには、推奨アイテムを表示するアイテムがページ上の別のタスク・フロー(ドキュメント・マネージャ・タスク・フローなど)で選択されている必要があります。
問題
有効なユーザー操作の後でも、類似アイテム・タスク・フローでアイテムが提案されません。
解決方法
これは、現在のユーザーにアイテムに対する表示権限がないためです。これが正常な動作です。アイテムに対する十分な権限がない場合、ユーザーにはそのアイテムの推奨が表示されません。アイテムをユーザーに対して表示するには、そのユーザーに十分な権限を付与してください。
問題
特定のアイテム・タイプが表示されません(たとえば、タスク・フローにドキュメント、Wiki、ブログが表示されるが、ディスカッションは表示されません)。
解決方法
特定のサービスのステータスを確認してください。サービスが使用できない場合、そのサービスのアイテムは類似アイテム・タスク・フローに表示されません。
問題
アイテムの提案が一部のユーザーに対してのみ行われます。それ以外のユーザーには、類似アイテム・タスク・フローのアイテムが提案されません。
解決方法
これは、WebCenter Portal: Spacesとサービスが同一のOIDに接続されていない場合に発生する可能性があります。この場合、各サービスの接続先OIDに存在しないユーザーには、そのサービスの推奨アイテムが表示されません。2つのOIDのどちらにも同じユーザーを作成するか、WebCenter Portal: Spacesとサービスを同一のOIDに接続する必要があります。