分析サービスを使用すると、Frameworkアプリケーションの使用状況およびパフォーマンスのメトリックを表示できます。Frameworkを使用して作成したアプリケーションに分析サービスを統合する方法について説明します。Spacesユーザーズ・ガイド』の分析サービスの使用に関する項を参照してください。Portalの分析データベース・スキーマ」を参照してください。分析サービスは、ポータルのリアルタイムの使用状況およびアクティビティのレポートを提供します。この項では、分析サービス、タスク・フローおよび使用方法の概要を説明します。Portalアプリケーション内のトラフィックおよび使用状況を追跡し、分析できます。分析サービスの基本的な機能は次のとおりです。分析サービスでは、コミュニティ、ページ、ポートレットおよびドキュメント・ヒットを含む、一般的なポータル機能のメトリックを収集してレポートします。Portalメトリックを分析して、ページのアクセス時間や使用時間などの使用パターンを判断できます。分析サービスを使用して、メトリック情報とユーザー・プロファイル情報との相関関係を示すことができます。使用状況トラッキング・レポートを表示し、国、会社、役職などのユーザー・プロファイル・データでフィルタ処理できます。開発者およびビジネス・ユーザーは、分析データを問い合せるカスタム・レポートを作成できます。詳細は、第46.3.1項「SQLデータ・コントロールの使用」を参照してください。Portalで使用可能な分析タスク・フローを示しています。これらのタスク・フローは、SpacesアプリケーションおよびFrameworkアプリケーションで同様に動作します。Spacesユーザーズ・ガイド』のSpacesの分析タスク・フローの理解に関する項を参照してください。Portalトラフィックポータル内の共通イベントの概要表示です。ページ・トラフィックポータル内でページにアクセスしたユーザーの人数(重複を除く)とページ・ヒット数を表示します。ログイン・メトリックポータル・ログインをレポートします。ポートレット・トラフィックポートレットの使用状況データを表示します。ポートレット・レスポンス時間ポートレットのパフォーマンス・データを表示します。ポートレット・インスタンス・トラフィックポートレット・インスタンス*の使用状況データを表示します。ポートレット・インスタンス・レスポンス時間ポートレット・インスタンス*のパフォーマンス・データを表示します。検索メトリックポータル検索を追跡します。ドキュメント・メトリックドキュメント・ビューを追跡します。Wikiメトリック最も人気のあるWikiや最も人気のないWikiを追跡します。ブログ・メトリック最も人気のあるブログや最も人気のないブログを追跡します。ディスカッション・メトリック最も人気のあるディスカッションや最も人気のないディスカッションを追跡します。複数の異なるページに同じポートレットが表示される場合、配置されている各ポートレットをポートレット・インスタンスと呼びます。分析サービスでは、分析スキーマ(ACTIVITIES)が適切なデータベースに設定され実行されている必要があります。Portalの分析コレクタがWC_Utilities管理対象サーバーで起動されて実行中である必要もあります。Portalインストレーション・ガイド』を参照してください。インストール時に、分析コレクタは、インストール・デフォルトを使用してイベントを受信するようにデフォルトで構成されます。Controlを使用して別の値を設定する必要が生じることがあります。Portal管理者ガイド』の分析コレクタ設定の構成に関する項を参照してください。分析タスク・フローを介して使用状況およびパフォーマンスのメトリックを表示するには、Frameworkアプリケーションのイベント生成を有効にし、分析データベース(ACTIVITIES)への接続を設定する必要があります。JDeveloperでこれを行う方法の詳細は、第46.2.2項「分析サービスの接続の設定」を参照してください。実行時には、Frameworkアプリケーションでのユーザー・アクティビティによってイベント・データが生成されます。ユーザー・ログイン、ディスカッション・トピックの参照、ドキュメントの表示などが行われるたびに、イベントが記録されます。APIは、ユーザー・データグラム・プロトコル(UDP)を使用してイベント・メトリックを分析コレクタに送信し、イベント・データは分析データベース(ACTIVITIES)に格納されます。クラスタ環境でない場合、Frameworkアプリケーションはコレクタの場所で構成され、すべてのイベントはその場所に送信されます。注意:現在のリリースでは、分析コレクタはクラスタ化できません。Frameworkアプリケーションに含まれる分析タスク・フローおよびカスタム分析レポート(SQLデータ・コントロールに基づく)では、実行時の分析データベースへの問合せによって、標準イベントに関して収集されたメトリックを表示します。Spacesユーザーズ・ガイド』の分析タスク・フローの使用に関する項を参照してください。分析サービスの基本構成この項では、Frameworkアプリケーションに分析サービスを統合する方法について説明します。第46.1.2項「分析サービスの要件」も参照してください。分析サービスの構成ロードマップ図46-1と図46-2に示されたフロー・チャートは、Frameworkアプリケーション内で分析サービスを動作させるために必要な前提条件とタスクの概要を提供しています。分析サービスでは、Frameworkアプリケーションが分析データベース(ACTIVITIES)に接続している必要があります。イベント情報を特定の分析コレクタに送信するように、Frameworkアプリケーションを構成する必要もあります。Controlを使用して、後から接続を追加、削除または変更できます。Portal管理者ガイド』の分析サービスの管理に関する項を参照してください。分析サービスでは、分析イベント・データが格納される分析データベース(ACTIVITIES)への接続が必要です。分析データベースへの接続を設定するには:ACTIVITIESデータベースが稼働中であることを確認します。第46.1.2項「分析サービスの要件」を参照してください。アプリケーション・ナビゲータで、「アプリケーション・リソース」パネルを開きます。「接続」を右クリックし、「接続の作成」を選択し、「データベース」を選択します。「データベース接続の作成」ダイアログで、データベース接続について次の情報を入力します。(分析データベースがインストールされている場所。(データベースのシステム識別子)「接続のテスト」をクリックし、成功した場合は、「OK」をクリックします。「データソースへの関連付け」ダイアログで、「ActivitiesDS」を選択します(図46-2)。分析データベースへの接続これによってACTIVITIESスキーマへのデータ・ソースが作成され、設計時にFrameworkアプリケーションで分析をテストできます。「OK」をクリックします。「アプリケーション・リソース」ペインで、「接続」の下に接続がノードとして表示されます。分析コレクタのプロパティを設定する方法デフォルトでは、分析コレクタはWC_Utilities管理対象サーバーにインストールされ、次のデフォルト値を使用してイベントを受信するように構成されます。Controlを使用して適切な値を構成できます。Portal管理者ガイド』の分析コレクタ設定の構成に関する項を参照してください。Portalイベントを収集する分析コレクタへの接続が必要であり、Frameworkアプリケーション内でOpenUsageが有効になっている必要があります。JVMプロパティを使用します。APIを使用して分析コレクタに送信するかどうかを指定します。有効な値はtrueおよびfalseです。デフォルト値はfalseです。クラスタ化された分析コレクタにマルチキャスト・モードでイベントを送信するかどうか、またはユニキャスト通信を使用した単一の分析コレクタが必要かどうかを指定します。有効な値はtrueおよびfalseです。(ユニキャスト)です。現在、クラスタはサポートされていないため、ここではtrueのみを指定します。コレクタ・クラスタの名前または分析コレクタのホスト名。現時点ではクラスタはサポートされていないため、ここにはホスト名のみを指定します。デフォルト値はlocalhostです。分析コレクタがイベントをリスニングするポート。デフォルト値は31314です。コレクタ・サービスをマルチキャスト・モードで使用できる時間(秒単位)。デフォルト値は30秒です。管理」の順に選択します。「プロジェクト・プロパティ」ダイアログ・ボックスで、「デフォルト」の実行構成を選択し、「編集」をクリックします。「起動設定」セクションで、次のOpenUsageオプションを「Javaオプション」フィールドに追加します。注意:現在のリリースでは、oracle.wc.openusage.unicast値はtrueに設定する必要があります。このリリースでは分析コレクタをクラスタ化できないため、マルチキャストはサポートされません。ここでは太字で示されている、指定する値が、自分の分析コレクタ・インストールに適合することを確認します。「OK」をクリックしてデフォルトの実行構成を保存し、再び「OK」をクリックします。ServerでOpenUsageが使用できます。Serverが稼働中の場合は、再起動して新しい設定を反映する必要があります。ServerへのFrameworkアプリケーションのデプロイ」を参照してください。大部分のイベントはデフォルトで構成されているため、イベントを送信するためにアプリケーション内で追加のコーディングを行う必要はありません。唯一の例外はページ・ビュー・イベントで、このイベントについては、第46.2.3.1項「ページ・ビュー用のイベント・コードの追加」に記載されている追加のコードが必要です。ページ・ビュー用のイベント・コードの追加ページ・イベントを送信するには、各ページにイベント・コードを追加する必要があります。次は、ページ上でクライアントJavaScriptイベントを使用して、実際のイベントを送信するためのJava分析APIをコールしている例です。この例を実装するには、<af:document>タグのすぐ下に次のコードを追加し、イベントを送信するページの名前でpageName値を置き換えます。method="#{AnalyticsInstrumentation.sendPageEvent}"/>前述の例は、ADFドキュメントがロードされるときにクライアント・イベントを生成し、定義されたサーバー・リスナーが実際にイベントを送信します。Beanは次のとおりです。分析タスク・フローではMDSを使用して、ユーザーが作成したカスタマイズを格納し、これらのカスタマイズは分析固有のMDSネームスペースに格納されます。Frameworkアプリケーションで分析タスク・フローに対するユーザー・カスタマイズを有効にするには、分析メタデータのネームスペースをadf-config.xmlで構成する必要があります。注意:さらに、各タスク・フローでは、ユーザー・カスタマイズの詳細が格納される一意のMDSドキュメントを指定する必要があります。第46.2.5.4項「分析タスク・フローの実行時のカスタマイズをエンド・ユーザーに許可する方法」を参照してください。分析メタデータのネームスペースを構成するには:adf-config.xmlを開きます。「アプリケーション・リソース」パネルを使用して、このファイルに移動します。META-INFフォルダにあります。<metadata-namespaces>要素の下に、次のXMLフラグメントを追加します。metadata-store-usage="WebCenterFileMetadataStore"/>ファイルを保存します。第22章「コンポーザ固有のMDS構成の実行」も参照してください。分析タスク・フローの設計時の追加この項では、分析サービス・タスク・フローについて説明し、分析タスク・フローをアプリケーションに追加する方法について説明します。Portalで使用可能な分析タスク・フローを示しています。Spacesユーザーズ・ガイド』のSpacesの分析タスク・フローの理解に関する項を参照してください。Portalトラフィックポータル内の共通イベントの概要表示です。ページ・トラフィックポータル内でページにアクセスしたユーザーの人数(重複を除く)とページ・ヒット数を表示します。ログイン・メトリックポータル・ログインをレポートします。ポートレット・トラフィックポートレットの使用状況データを表示します。ポートレット・レスポンス時間ポートレットのパフォーマンス・データを表示します。ポートレット・インスタンス・トラフィックポートレット・インスタンス*の使用状況データを表示します。ポートレット・インスタンス・レスポンス時間ポートレット・インスタンス*のパフォーマンス・データを表示します。検索メトリックポータル検索を追跡します。ドキュメント・メトリックドキュメント・ビューを追跡します。Wikiメトリック最も人気のあるWikiや最も人気のないWikiを追跡します。ブログ・メトリック最も人気のあるブログや最も人気のないブログを追跡します。ディスカッション・メトリック最も人気のあるディスカッションや最も人気のないディスカッションを追跡します。分析タスク・フローをFrameworkアプリケーションに追加するには:第46.1.2項「分析サービスの要件」の説明に従って、アプリケーションを準備します。ポートレット、ディスカッション、ドキュメント、検索など、分析イベント・データを使用できるサービスがアプリケーションに含まれていることを確認します。注意:アプリケーションを実行したときに使用状況データがない場合は、分析タスク・フローから「表示するデータがありません」というメッセージが表示されます。タスク・フローを追加するJSFページ(.jspx)を開きます。サービス・カタログ」を開き、「タスク・フロー」フォルダを開きます(図46-3)。「分析」タスク・フローを、ページの<af:form>タグの内側にドラッグ・アンド・ドロップします。「作成」ポップアップ・メニューから、「リージョン」を選択します。分析サービスのADFライブラリ(analytics-reporting-service-view.jar)をプロジェクトに追加するよう要求される場合があります。「ライブラリの追加」をクリックして確認します(図46-4)。「タスク・フロー・バインディングの編集」ダイアログで、分析タスク・フロー・パラメータの値を入力します。オプション詳細は、第46.2.5.5項「分析タスク・フローおよびタスク・フロー・パラメータ」を参照してください。「OK」をクリックします。タスク・フローがページに追加され、タスク・フローを実行するようにViewControllerプロジェクトのライブラリが構成されます。プロジェクトを保存し、ページを実行して、Frameworkアプリケーション内でタスク・フローが動作することを確認します。アプリケーションを実行したときに使用状況データがない場合は、分析タスク・フローから「表示するデータがありません」というメッセージが表示されます。テスト中のタスク・フローに関連するアクションを実行することで、表示する分析タスク・フローのデータを作成できます。ディスカッション・メトリックをテストするには、ディスカッションを作成および表示したり、ページ・メトリックをテストするには、ページを作成および表示したりするといった具合です。各分析タスク・フローには、一連の必須およびオプションのタスク・フロー・バインディング・パラメータがあります。必須パラメータは強制的なものではありませんが、これを使用すると、タスク・フローが正しく動作するために必要な情報を取得できます。特定のタスク・フロー・インスタンスに対するユーザー・カスタマイズをMDSに格納する場合は、必要なMDSドキュメントを指定する必要があります。タスク・フロー・バインディング・パラメータを使用すると、タスク・フロー・インスタンスの外観と動作もカスタマイズできます。パラメータ値を使用して、分析データの上に表示されるタイトルを指定できます。タスク・フロー・バインディング・パラメータの値は、タスク・フローをアプリケーション・ページにドラッグ・アンド・ドロップするときに指定できます。この操作を行うと、「タスク・フロー・バインディング」ダイアログが開きます(詳細は、第46.2.5.2項「分析タスク・フローをページに追加する方法」を参照してください)。ページにタスク・フローを配置した後、タスク・フロー・バインディング・パラメータの値を実行時に調整することもできます。Spacesユーザーズ・ガイド』の分析タスク・フロー・プロパティの設定に関する項を参照してください。「タスク・フロー・バインディングの編集」ダイアログにアクセスするには:ページの下部にある「バインディング」タブ(「ソース」タブの横)をクリックして、「バインディング」ビューに移動します。「実行可能ファイル」には、ページに追加したタスク・フローのリストが表示されます。分析タスク・フローを選択します(図46-5)。分析タスク・フローの入力パラメータへのアクセス「実行可能ファイル」という見出しの横にある、「選択した要素を編集します。」アイコン(鉛筆)をクリックします。「タスク・フロー・バインディングの編集」ダイアログ(図46-6)で、必要に応じてバインディング・パラメータ値を指定します詳細は、第46.2.5.5項「分析タスク・フローおよびタスク・フロー・パラメータ」を参照してください。終了したら、ページを保存し実行して、結果を確認します。Idパラメータを使用して指定する必要があります。IDは一意である必要があるため、<app_name>_<page_name>_<task_flow>_<sequence>のような、一貫性のある命名パターンの使用を検討します。ページ・トラフィック・タスク・フローの場合は、analyticsResourceIdパラメータをmyapp_analyticspage_pagetraffic_1に設定します。詳細は、第46.2.5.3項「分析タスク・フローのパラメータを変更する方法」を参照してください。分析タスク・フローおよびタスク・フロー・パラメータ表46-4は、分析サービスに適用可能なタスク・フロー・バインディング・パラメータをリストし説明しています。説明analyticsReportTitleすべて分析データの上に表示されるタイトルを指定します。デフォルトのレポート・タイトルを上書きできます。例」も参照してください。analyticsResourceId*すべてタスク・フロー・インスタンスに対するユーザー・カスタマイズ/アプリケーション・カスタマイズをMDSに格納するために生成されるMDSドキュメントを指定します。mymainloginmetricsと入力します。applicationName*すべて分析データを表示する対象のFrameworkアプリケーションの名前を指定します。MyPortalApplicationと入力します。分析データベースを使用して複数のアプリケーションのイベント・データを格納できるため、このパラメータは、表示するアプリケーション・データの特定に必要です。省略した場合、タスク・フローではすべてのアプリケーションの分析データが表示されます。maxDataPointsPerSeriesすべて棒グラフまたは折れ線グラフに表示されるデータ・ポイントの最大数を指定します。1から1000の範囲の値を入力します。デフォルト値は25です。データ・ポイントの数が多いほど、グラフの表示に時間がかかる場合があります。例」も参照してください。分析タスク・フローの目的は、容量計画、サービス品質(QoS)分析、投資収益率(ROI)分析、検索の最良のカスタマイズなど、特定のビジネス機能を実行する限られた一連の管理ユーザーに対して、使用状況メトリックを表示することです。分析用の使用状況データはポータル分析にとって重要ですが、ポータル・ユーザーにとって個人的または機密的な場合があります。検索、ドキュメントおよびポートレットの各レポートは、電子メール・アドレス、名、姓などのユーザー・プロパティに基づく、特定のユーザーのアクティビティ・メトリックを表示するように構成できます。分析タスク・フローおよびカスタム・レポートに関連するセキュリティとプライバシの問題を保護する方法は、次のとおりです。分析タスク・フロー、カスタム・レポートおよび機密的な使用状況データを表示するページへの管理者アクセスを管理します。分析タスク・フローのページへの追加、カスタム分析データ・コントロールに基づくレポートの作成、または機密的な使用状況メトリックを表示するように設定されているページの参照を行える管理ユーザーの数を限定するには、新しい管理グループを作成し、それに応じてグループ・メンバーシップを管理します。分析タスク・フローへのユーザー・アクセスを管理します。必要でないかぎり、分析タスク・フローおよびカスタム・レポートには、プライベート・データや機密データを含めないようにします。レポート内のメトリックにプライベート・データや機密データが含まれる場合、該当の指定ユーザーのみがタスク・フローまたはページにアクセスできるようにセキュリティを構成します。設計時に開発者は、管理者でないユーザーにページへの適切な権限を与えることによって、分析タスク・フローを公開できます。開発者は、デプロイ前にレポートをカスタマイズして、特定のレポート・オプション(時間枠、グラフのタイプ、ユーザー・プロパティ・フィルタ、グループ化基準オプションなど)を非表示/表示および事前定義できます。管理者は実行時に同じ操作、つまり、ページ・アクセスの付与および表示される情報のカスタマイズを行えます。管理者でないユーザーも、表示が許可されているレポートをパーソナライズできますが、管理者が行ったカスタマイズを変更できません。認証されていないユーザーが分析タスク・フローをページに追加したり、機密データを表示できないようにします。分析レポートの作成デフォルトの分析タスク・フローでは、一般的な分析イベント・メトリックを固有の表示形式で表示します。分析データを異なる方法で表示したり、カスタムのイベント・データを表示する場合は、SQLを使用してカスタム分析レポートを作成できます。Portalの分析データベース・スキーマ」を参照してください。分析データベースから取得する情報をSQL問合せ文で定義するには、SQLデータ・コントロールを使用します。データ・コントロールをページに公開する場合、分析データをグラフ、表またはフォームで表示するかどうかを選択でき、バインド・パラメータなどの表示オプションも構成できます。設計時にJDeveloperを使用してSQLデータ・コントロールを作成できます。Fusion開発者ガイド』を参照してください。実行時のリソース管理機能が有効な場合は、実行中のFrameworkアプリケーションでもデータ・コントロールを作成できます。Spacesユーザーズ・ガイド』のSQLデータ・コントロールの作成に関する項を参照してください。Portal管理者ガイド』のアプリケーション・リソースの管理に関する項を参照してください。Frameworkアプリケーションで分析データベースからデータをフェッチし、分析データを表示するには、SQLデータ・コントロールを使用します。図46-9は、Spacesにおける「SQLデータ・コントロールの作成/編集」ダイアログ内のサンプルSQL問合せを示しています。分析データベース(ActivitiesDS)へのデータベース接続が必要であり、有効なデータベース・パスワードを指定する必要があります。SpacesにおけるSQLデータ・コントロールを作成するためのダイアログバインド・パラメータは必要に応じて追加できます。パラメータを追加する場合、指定するパラメータ値に基づいて、データ・ソースから取得されるデータを制限できます。この例はSpacesアプリケーション用なので、図46-10に示すように、アプリケーションの名前はwebcenterに設定し、個人用ページ(ホーム・スペース内のページ)をレポートに含めます。説明appnamewebcenter対応するアプリケーション名、Spacesの場合は常にwebcenterです。その他のFrameworkアプリケーションは異なる名前です。ispersonal0または1Spacesの場合、ホーム・スペースに作成されたページをレポートに含めるかどうかを決定します。hh24Oracleデータベース内の有効な日付パターン。取得するデータによって異なるため、パターンのすべてのコンポーネントがオプションです。startdate01/01/2010必要なデータの開始日を決定します。enddate01/01/2011必要なデータの終了日を決定します。図46-9は、グラフとして表示されるカスタム・レポートを示しています。使用できる分析レポートのSQL文この項では、カスタム・レポートの出発点として使用できるSQL文について説明します。これらの文は、フィルタの追加やグループ化など、様々な方法でカスタマイズできます。Portalの分析データベース・スキーマ」を参照してください。ユーザー・メトリックについての問合せのサンプルこの項では、ユーザー固有のメトリックについての問合せのサンプルを示します。次のサンプルがあります。Portalの分析データベース・スキーマ」の第G.5項「分析ユーザー・プロパティ」を参照してください。次の問合せは、Sales部門のユーザーがアクセスしたページの名前と、その各ページのビュー数を返します。次の問合せは、ページ・ビューの総数を部門別に返します。特定のメトリックについての分析データベース問合せのサンプルこの項では、特定のメトリックについての問合せのサンプルを示します。次のサンプルがあります。Portalの分析データベース・スキーマ」を参照してください。ユーザー・アクティビティ次の問合せは、特定の期間に特定のユーザーによって実行されたすべてのアクティビティのリストを返します。スペース・アクティビティ次の問合せは、特定のスペースで実行されたすべてのアクティビティのリストを返します。特定の期間のスペース・アクティビティ次の問合せは、特定の期間に特定のスペースにおいて実行されたすべてのアクティビティのリストを返します。特定の期間でのサービスのアクティビティ次の問合せは、特定の期間における特定のサービス(この例の場合はログイン・サービス)のアクティビティを返し、結果をユーザー単位にグループ化します。検索フレーズ次の問合せは、特定の期間に検索されたフレーズを返し、各検索の実行回数をリストします。次の問合せは、特定の期間に特定のユーザーによって表示されたページを返します。reserved.法律上の注意点ライブラリ。