Oracle® Fusion Middleware

WebCenter Sites: Analytics開発者ガイド

11g リリース1 (11.1.1.6.0)

E49683-01(原本部品番号:E39315-01)

2013年7月

Oracle Fusion Middleware WebCenter Sites: Analytics開発者ガイド 11gリリース1 (11.1.1.6.0)

E49683-01

Copyright © 2012, 2013 Oracle and/or its affiliates. All rights reserved.

原本著者:  Will Harris

原本協力著者:  Sean Cearley、Promila Chitkara、Tatiana Kolubayev、Melinda Rubenau

原本協力者:  Kannan Appachi、Avadhani Chandrashekar、Saikat Chaudhuri、Joseph Granato、Ravi Khanuja、Patrice Palau、Vijayalakshmi Rajan

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

タイトルおよび著作権情報

はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

このガイドで説明する新機能

第I部 カスタム・パラメータを使用したAnalyticsレポート作成のチュートリアル

1 Analyticsでのレポート作成について

- 1.1 このチュートリアルについて

- 1.2 NewBrowsersレポート

- 1.3 カスタム・パラメータを使用したレポート作成の前提条件

- 1.4 クイック・リファレンス

2 演習1: データ・キャプチャ用の新規パラメータの追加

- 2.1 概要

- 2.2 イメージ・タグおよびそのJSPへの新規パラメータの追加

- 2.3 次の手順

3 演習2: DetailDefinition表への新規パラメータの追加

- 3.1 概要

- 3.2 カスタム・パラメータのデータベース・エントリの作成

- 3.3 次の手順

4 演習3: 新規Analyticsジョブの開発

- 4.1 Analyticsジョブの作成の概要

- 4.1.1 新規Analyticsジョブの開発例

- 4.1.1.1 NewBrowsersレポートの設計

- 4.1.2 New Browsersレポート用のAnalyticsジョブの開発

- 4.1.2.1 手順1: 入力場所の選択

- 4.1.2.2 手順2: スキーマの拡張

- 4.1.2.3 手順3: Beanの作成

- 4.1.2.4 手順4: マッパー・クラスの作成

- 4.1.2.5 手順5: プロセッサ定義へのBeanおよびマッパーの追加

- 4.1.3 データベース・インジェクションの構成

- 4.1.4 新規Analyticsジョブと既存のHadoop-Jobsコンポーネントの統合

- 4.2 次の手順

5 演習4: 表示するレポートの作成および準備

- 5.1 レポート設計

- 5.1.1 NewBrowsersレポートのコード

- 5.2 表示するNewBrowsersレポートの作成および準備

- 5.2.1 レポート・ファイルの作成および登録

- 5.2.1.1 手順1: XMLファイルの作成

- 5.2.1.2 手順2: XMLファイルのAnalyticsレポート・ディレクトリへの配置

- 5.2.1.3 手順3: レポート・コンポーネントのラベル付け

- 5.2.1.4 手順4: Analyticsユーザーへのレポートの有効化

- 5.2.1.5 手順5: 新規レポートのテスト

- 5.2.2 表の追加

- 5.2.3 期間セレクタの追加

- 5.3 フィルタの追加

- 5.3.1 フィルタの動作

- 5.3.2 フィルタの追加方法

- 5.3.3 チャートの追加

- 5.3.4 完成したNewBrowsersレポートのテスト

第II部 リファレンス

6 様々なタイプのレポートのデータ・キャプチャの有効化

- 6.1 データ・キャプチャの有効化

- 6.1.1 一般情報レポート、コンテンツ情報レポートおよびユーザー情報レポートのデータ・キャプチャの有効化

- 6.1.2 内部検索レポートのデータ・キャプチャの有効化

- 6.1.3 Engageレポートのデータ・キャプチャの有効化

- 6.2 Analyticsインストールのテスト

7 WebCenter Sites: Analyticsのデータベース・スキーマ

- 7.1 L3表

- 7.1.1 CS_L3DATEXSITEXOBJXCOUNT

- 7.1.2 L3_DATEXSITEXCITYXCOUNT

- 7.1.3 L3_WEEKXSITEXCITYXCOUNT

- 7.1.4 L3_MONTHXSITEXCITYXCOUNT

- 7.1.5 L3_DATEXSITEXDLXMIMEXCOUNT

- 7.1.6 L3_DATEXSITEXGROUPXOICOUNT

- 7.1.7 L3_DATEXSITEXGROUPXSESCOUNT

- 7.1.8 L3_DATEXSITEXGROUPXVISCOUNT

- 7.1.9 L3_WEEKXSITEXGROUPXVISCOUNT

- 7.1.10 L3_MONTHXSITEXGROUPXVISCOUNT

- 7.1.11 L3_DATEXSITEXREGIONXCOUNT

- 7.1.12 L3_WEEKXSITEXREGIONXCOUNT

- 7.1.13 L3_MONTHXSITEXREGIONXCOUNT

- 7.1.14 L3_DATEXSITEXJS

- 7.1.15 L3_DATEXSITEXOBJECTXDURATION

- 7.1.16 L3_DATEXSITEXBROWSERXCOUNT

- 7.1.17 L3_DATEXSITEXCOUNTRYXCOUNT

- 7.1.18 L3_WEEKXSITEXCOUNTRYXCOUNT

- 7.1.19 L3_MONTHXSITEXCOUNTRYXCOUNT

- 7.1.20 L3_DATEXSITEXENTRYIDXCOUNT

- 7.1.21 L3_DATEXSITEXEXITIDXCOUNT

- 7.1.22 L3_DATEXSITEXHOSTNAMEXCOUNT

- 7.1.23 L3_DATEXSITEXINTERNALSEARCH

- 7.1.24 L3_DATEXSITEXIPXCOUNT

- 7.1.25 L3_DATEXSITEXISPXCOUNT

- 7.1.26 L3_WEEKXSITEXISPXCOUNT

- 7.1.27 L3_MONTHXSITEXISPXCOUNT

- 7.1.28 L3_DATEXSITEXOBJECTTYPEXCOUNT

- 7.1.29 L3_DATEXSITEXOBJECTXCOUNT

- 7.1.30 L3_AUDIT_TRAIL

- 7.1.31 L3_DATEXSITEXOPTYPEXCOUNT

- 7.1.32 L3_WEEKXSITEXOPTYPEXCOUNT

- 7.1.33 L3_MONTHXSITEXOPTYPEXCOUNT

- 7.1.34 L3_DATEXSITEXOSXCOUNT

- 7.1.35 L3_DATEXSITEXREFERERXCOUNT

- 7.1.36 L3_DATEXSITEXSCREENRESXCOUNT

- 7.1.37 L3_DATEXSITEXSESSION

- 7.1.38 L3_DATEXSITEXSESSIONXQUANTIL

- 7.1.39 L3_DATEXSITEXSEXKEYWORDXCOUNT

- 7.1.40 L3_DATEXSITEXVISITORXCOUNT

- 7.1.41 L3_WEEKXSITEXVISITORXCOUNT

- 7.1.42 L3_MONTHXSITEXVISITORXCOUNT

- 7.1.43 REC_L3_RECXCOUNT

- 7.1.44 REC_L3_RECXSEGXCOUNT

- 7.1.45 REC_L3_RECXSEGXOBJXCOUNT

- 7.2 HELP表

- 7.2.1 HELP_CITY

- 7.2.2 HELP_REGION

- 7.2.3 HELP_COUNTRY

- 7.2.4 HELP_DATES

- 7.2.5 HELP_HOURS

- 7.2.6 HELP_ISP

- 7.3 システムの構成およびメンテナンスの表

- 7.3.1 ACCESSRIGHT

- 7.3.2 BROWSERGROUP

- 7.3.3 BROWSERIDENTIFICATION

- 7.3.4 IP2COUNTRYCITY_BLOCKS

- 7.3.5 IP2ISP_BLOCKS

- 7.3.6 IPQUICKLIST

- 7.3.7 ESAUSER

- 7.3.8 IP2COUNTRY

- 7.3.9 OBJECTTYPEGROUP

- 7.3.10 SETTING

- 7.3.11 OSGROUP

- 7.3.12 OSIDENTIFICATION

- 7.3.13 REC_RECOMMENDATION

- 7.3.14 REC_SEGMENT

- 7.3.15 REPORT

- 7.3.16 REPORT2REPORTGROUP

- 7.3.17 REPORTGROUP

- 7.3.18 REPORTPARAMETER

- 7.3.19 SEARCHENGINEGROUP

- 7.3.20 SEARCHENGINEIDENT

- 7.3.21 SITE

- 7.3.22 SITE2OBJECTTYPEGROUP

- 7.3.23 SITEGROUP

- 7.3.24 PI_SITEXOBJECTTYPE

- 7.3.25 USER2USERGROUP

- 7.3.26 USERGROUP

- 7.3.27 L2_BROWSER

- 7.3.28 L2_GROUP

- 7.3.29 L2_OBJECT

- 7.3.30 L2_OBJECTNAMEHISTORY

- 7.3.31 L2_OBJECTTYPE

- 7.3.32 L2_OS

- 7.3.33 L2_PIOBJECTTYPE

- 7.3.34 L2_SEARCHENGINE

- 7.3.35 L2_VISITOR

- 7.3.36 TASKSTATUSHISTORY

- 7.3.37 HDFSAGENTSTATUSHISTORY

- 7.3.38 DETAILDEFINITION

- 7.4 データベースの索引

はじめに

このガイドでは、Oracle WebCenter Sitesの管理下にある、Webサイトを参照する訪問者に関する人口統計学的レポートを作成する方法について説明します。このガイドの第I部は、カスタムのデータ・キャプチャ・パラメータを使用してレポートを作成するチュートリアルです。第II部は、様々なタイプのOracle WebCenter Sitesアセットおよびレポートのデータ・キャプチャを有効化する方法について説明するリファレンスです。第II部では、サイト訪問者に関する統計情報が格納されるAnalyticsデータベースのスキーマについても説明します。

対象読者

このガイドは、主に開発者を対象としています。開発者は、会社のビジネス・ニーズを把握しており、オンライン・サイトおよびそのバック・エンドの開発における各自の役割を基本的に理解していることが前提です。このガイドは、開発者と協力して、コンテンツ管理サイト、サイト・ユーザー、ワークフロー・プロセス、公開方法およびOracle WebCenter Sitesクライアント・オプションを設定する管理者にとっても役立ちます。

開発者は、Java、JavaServer Pages (JSP)、XMLおよびHTMLを理解している必要があります。管理者は、プログラミングの経験は必要ありませんが、技術的なバックグランドがあることを前提としています。

ドキュメントのアクセシビリティについて

Oracleのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)を参照してください。

Oracle Supportへのアクセス

Oracleサポート・サービスでは、My Oracle Supportを通して電子支援サービスを提供しています。詳細情報は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info) か、聴覚に障害のあるお客様は (http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs)を参照してください。

関連ドキュメント

詳細は、Oracle WebCenter Sites 11gリリース1 (11.1.1.6.0)ドキュメント・セットに含まれる次のドキュメントを参照してください。

- Oracle WebCenter Sites動作保証マトリックス

- Oracle WebCenter Sitesリリース・ノート

- 『Oracle Fusion Middleware WebCenter Sites: Analyticsユーザーズ・ガイド』

- 『Oracle Fusion Middleware WebCenter Sites: Analytics管理者ガイド』

- Oracle Fusion Middleware WebCenter Sites: Analyticsタグ・リファレンス

表記規則

このマニュアルでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック体

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

このガイドで説明する新機能

このガイドは、これまで別々のマニュアルで提供されていたOracle WebCenter Sites: Analyticsの開発者向けドキュメントを1つにまとめたものです。このガイドの構成は次のとおりです。

- 第I部「カスタム・パラメータを使用したAnalyticsレポート作成のチュートリアル」では、開発者を対象に、Oracle WebCenter Sites: Analyticsでレポートを作成および構成する方法について説明します。

- 第II部「リファレンス」では、様々なタイプの公開済WebCenter Sitesアセットの、訪問者による使用に関するデータ・キャプチャを有効化する方法について説明します。この部では、サイト訪問者に関する統計情報が格納されるデータベース表のスキーマの概要も説明します。

第I部

カスタム・パラメータを使用したAnalyticsレポート作成のチュートリアル

この部は、Oracle WebCenter Sites: Analyticsでレポートの作成および構成を行う開発者を支援するチュートリアルで構成されています。

この部の構成は、次のとおりです。

- 第1章「Analyticsでのレポート作成について」

- 第2章「演習1: データ・キャプチャ用の新規パラメータの追加」

- 第3章「演習2: DetailDefinition表への新規パラメータの追加」

- 第4章「演習3: 新規Analyticsジョブの開発」

- 第5章「演習4: 表示するレポートの作成および準備」

1 Analyticsでのレポート作成について

このガイドの第I部は、Oracle WebCenter Sites: Analyticsでのレポートの作成および構成を支援する、演習を含むチュートリアルです。

この章では、チュートリアルの流れの概要を示します。内容は次のとおりです。

- 第1.1項「このチュートリアルについて」

- 第1.2項「NewBrowsersレポート」

- 第1.3項「カスタム・パラメータを使用したレポート作成の前提条件」

- 第1.4項「クイック・リファレンス」

1.1 このチュートリアルについて

このチュートリアルの目標は、Oracle WebCenter Sites: Analyticsでレポートを作成および構成する方法を理解することです。この目標を達成するために、次の演習を行います。

1. 第2章「演習1: データ・キャプチャ用の新規パラメータの追加」。この演習では、データ・キャプチャ用の新しいパラメータをAnalyticsに追加する方法を、順を追って説明します。

2. 第3章「演習2: DetailDefinition表への新規パラメータの追加」。この演習では、新しいパラメータを認識するようにAnalyticsを構成する方法を、順を追って説明します。この演習では、該当のパラメータをDETAILDEFINITION表に追加します。Analyticsジョブがパラメータを処理してレポートに表示できるのは、そのパラメータがDETAILDEFINITION表に定義されている場合のみです。

3. 第4章「演習3: 新規Analyticsジョブの開発」。この演習では、新しいパラメータに基づいてAnalyticsジョブを開発する方法を、順を追って説明します。作成するAnalyticsジョブは、新しいパラメータを処理してレポート(このチュートリアルではNewBrowsersレポート)に表示します。

4. 第5章「演習4: 表示するレポートの作成および準備」。この演習では、カスタムのAnalyticsレポートを構成する方法を、順を追って説明します。レポートにはAnalyticsデータベースの統計データが表示されます。これには次の機能が含まれます。

- 表

- 期間セレクタ

- チャート

- データ・フィルタ

第1.4項「クイック・リファレンス」では、各演習で実行する手順の概要を示します。

注意:

このガイドでは、FirstSite IIサンプル・サイトのみを使用することを前提としています。AnalyticsまたはWebCenter Sitesインタフェースで選択が求められた場合は、このサイトを選択します。

1.2 NewBrowsersレポート

このチュートリアルで作成するレポートは、NewBrowsersレポートと呼ばれます。

注意:

NewBrowsersレポートは、Analyticsインストールに含まれているデフォルトのBrowsersレポートを再現したものです。このチュートリアルでは、構成するBrowsersレポートのxmlファイルおよびレポート名に加えて、Beanクラスおよびマッパー・クラスの名前も、デフォルトのBrowsersレポートを上書きしないように名前が変更されています。デフォルト・レポートを上書きしないように、カスタム・レポートの名前、そのxmlファイル、Beanクラスおよびマッパー・クラスは一意であり、このチュートリアル全体をとおして使用されます。

パラメータを追加してレポートを作成するために実行する必要がある手順を把握するには、第1.4項「クイック・リファレンス」を参照してください。このチュートリアルの演習を完了すると、レポートは図1-1のように表示されます。

図1-1 New Browsersレポート

1.3 カスタム・パラメータを使用したレポート作成の前提条件

このドキュメントに記載されている内容を実行するためには、次の条件を満たしている必要があります。

- データをキャプチャしてレポートを生成するには、Oracle WebCenter Sites: Analyticsの構成および使用に精通している必要があります。

- WebCenter Sitesの次の側面に関して、実用的な知識を持っている必要があります。

- エレメント・コード(JSP)。新しいパラメータを、エレメント・アセット内のAnalyticsイメージ・タグ・コールと、Analyticsイメージ・タグJSPに追加します。

- フレックス・アセット・モデルおよびベーシック・アセット・モデル。追跡用にAnalyticsに渡すアセット属性を理解するために、アセットの構成方法に精通している必要があります。

- データベース表。新しいパラメータをDETAILDEFINITION表に追加し、新しいパラメータで収集された処理済データが格納される新しいL3表を作成することによって、Analyticsデータベース・スキーマを拡張します。

- SQLについて理解している必要があります。レポートにデータを取得するSQLコードを記述および変更します。

- XMLについて理解している必要があります。Analyticsレポートは、レポート機能を定義するXMLタグで構築されています。

注意:

レポート・コードを記述する際は、Oracle Fusion Middleware WebCenter Sites: Analyticsタグ・リファレンスを手元に用意してください。これには、レポートのコードを記述するときに使用するXMLタグと、各タグが使用するパラメータの説明が記載されています。

- 演習の実行時に参照が必要になる場合に備えて、次のドキュメントを手元に用意する必要があります。

- 『Oracle Fusion Middleware WebCenter Sites: Analyticsユーザーズ・ガイド』

- 『Oracle Fusion Middleware WebCenter Sites: Analytics管理者ガイド』

- Hadoop分散ファイル・システムの基本およびHadoop Map/Reduceジョブの作成方法に精通している必要があります。

注意:

Hadoop分散ファイル・システムおよびMap/Reduceジョブの作成方法の詳細は、次のWebサイトを参照してください。

http://hadoop.apache.org/core/docs/current/mapred_tutorial.html

1.4 クイック・リファレンス

参考用に、実行する手順の概要を次に示します。

演習1: 新規パラメータの追加

第2章「演習1: データ・キャプチャ用の新規パラメータの追加」では、新しいパラメータをAnalyticsに追加します。これによって、Analyticsはそのパラメータでデータのキャプチャを開始できます。手順は次のとおりです。

1. Analyticsイメージ・タグおよびそのJSPを変更して、新しいパラメータでのデータ・キャプチャをトリガーします。詳細は、第2.2項「イメージ・タグおよびそのJSPへの新規パラメータの追加」を参照してください。

2. このチュートリアルの次の手順では、新しいパラメータをDETAILDEFINITION表に追加します。詳細は、「演習2: DETAILDEFINITON表への新規パラメータの追加」を参照してください。

演習2: DETAILDEFINITON表への新規パラメータの追加

第3章「演習2: DetailDefinition表への新規パラメータの追加」では、新しいパラメータをDETAILDEFINITION表に追加することによって、そのパラメータを認識するようにAnalyticsを構成します。手順は次のとおりです。

1. 新しいパラメータをDETAILDEFINITION表に追加します。これによってAnalyticsは新しいパラメータ(「演習1: 新規パラメータの追加」で作成済)を認識でき、Analyticsジョブ(「演習3: 新規Analyticsジョブの開発」で作成)はパラメータを処理して、レポート(この例ではNewBrowsersレポート)に表示できます。

2. このチュートリアルの次の手順では、新しいAnalyticsジョブを開発します。次の演習を開始する前に、FSIIサイトを参照して、開発している新しいAnalyticsジョブで処理するデータを作成します。「演習3: 新規Analyticsジョブの開発」に進む前に、Analyticsセンサー、HadoopおよびHDFSエージェントが実行していることを確認します。

演習3: 新規Analyticsジョブの開発

第4章「演習3: 新規Analyticsジョブの開発」では、新しいパラメータがキャプチャするRAWデータを処理するAnalyticsジョブを開発します。手順は次のとおりです。

1. 新しいAnalyticsジョブを開発します。この例では、NewBrowsersレポート(「演習4: レポートの作成および構成」で作成)を使用します。新しいジョブによって、Analyticsは指定のサイトからキャプチャされたRAWデータを処理できます。処理されたデータはデータベースに挿入されます。詳細は、第4.1.2項「New Browsersレポート用のAnalyticsジョブの開発」を参照してください。手順の概要は次のとおりです。

1. レポートの入力データとして使用する場所を選択します。詳細は、第4.1.2.1項「手順1: 入力場所の選択」を参照してください。

2. 処理されたデータを格納するために、新しいL3表を追加します。詳細は、第4.1.2.2項「手順2: スキーマの拡張」を参照してください。

3. 出力データを格納する新しいBeanクラスを作成します。詳細は、第4.1.2.3項「手順3: Beanの作成」を参照してください。

4. レポートの入力データを処理するビジネス・ロジックをカプセル化する、新しいマッパー・クラスを作成します。詳細は、第4.1.2.4項「手順4: マッパー・クラスの作成」を参照してください。

5. プロセッサを構成して、Beanクラスとマッパー・クラスを統合します。詳細は、第4.1.2.5項「手順5: プロセッサ定義へのBeanおよびマッパーの追加」を参照してください。

2. この演習で作成する新しいパラメータが含まれる、NewBrowsersレポートを作成し、構成します。詳細は、「演習4: レポートの作成および構成」を参照してください。

演習4: レポートの作成および構成

第5章「演習4: 表示するレポートの作成および準備」では、次の手順を実行することによって、NewBrowsersレポートを最初から作成します。

注意:

このチュートリアルで作成するNewBrowsersレポートは、Analyticsインストールに含まれているデフォルトのBrowsersレポートを再現したものです。このチュートリアルでは、構成するBrowsersレポートのxmlファイルおよびレポート名に加えて、Beanクラスおよびマッパー・クラスの名前も、デフォルトのレポートを上書きしないように名前が変更されています。

1. 新しいレポート・ファイルを作成し、Analyticsに登録します。詳細は、第5.2.1項「レポート・ファイルの作成および登録」を参照してください。手順の概要は次のとおりです。

1. レポート・コードが含まれるXMLファイルを作成します。詳細は、第5.2.1.1項「手順1: XMLファイルの作成」を参照してください。

2. Analyticsがファイルにアクセスできるように、ファイルをAnalyticsレポート・ディレクトリに配置します。詳細は、第5.2.1.2項「手順2: XMLファイルのAnalyticsレポート・ディレクトリへの配置」を参照してください。

3. モジュール・キャプションや列ヘッダーなどをプロパティ・ファイルに定義し、そのファイルをAnalyticsに登録することによって、レポート・コンポーネントにラベルを付けます。詳細は、第5.2.1.3項「レポート・コンポーネントのラベル付け」を参照してください。

4. Analyticsユーザーがレポートを使用できるようにします。詳細は、第5.2.1.4項「手順4: Analyticsユーザーへのレポートの有効化」を参照してください。

5. レポートをテストして、コーディングが正しいことを確認します。詳細は、第5.2.1.5項「手順5: 新規レポートのテスト」を参照してください。

2. 表を追加します。詳細は、第5.2.2項「表の追加」を参照してください。表は、Analyticsレポートに統計データを表示する基本の方法です。

3. 期間セレクタを追加します。詳細は、第5.2.3項「期間セレクタの追加」を参照してください。セレクタを使用すると、レポートに表示される統計データを特定の期間に制限できます。

4. データ・フィルタを追加します。詳細は、第5.3項「フィルタの追加」を参照してください。フィルタを使用すると、レポートに表示される統計データを特定のパラメータ値に制限できます。データのフィルタリングを行うパラメータごとに、個別のフィルタが必要です。

5. チャートを追加します。詳細は、第5.3.3項「チャートの追加」を参照してください。チャートを使用すると、レポート内で統計データを視覚的に表示できます。

6. 完成したNewBrowsersレポートをテストします。この時点で、第5.3.4項「完成したNewBrowsersレポートのテスト」に示されている、機能する完全なレポートが作成されています。

2 演習1: データ・キャプチャ用の新規パラメータの追加

この演習では、データ・キャプチャ用の新しいパラメータをAnalyticsに追加する方法について説明します。

この演習の内容は次のとおりです。

- 第2.1項「概要」

- 第2.2項「イメージ・タグおよびそのJSPへの新規パラメータの追加」

- 第2.3項「次の手順」

2.1 概要

この演習では、FirstSite IIサンプル・サイトに基づいてAnalyticsを構成し、agentという新しいパラメータでのデータ・キャプチャを開始します。新しいagentパラメータを使用して、サイトの訪問者が使用するブラウザに関するRAWデータがキャプチャされます。

新しいagentパラメータをAnalyticsに追加したら、次の演習(第3章「演習2: DetailDefinition表への新規パラメータの追加」)に進み、新しいagentパラメータを認識するようにAnalyticsを構成します。次に、第4章「演習3: 新規Analyticsジョブの開発」の手順に従って、新しいパラメータを統計的に処理してレポート(このチュートリアルではNewBrowsers)に表示する、Analyticsジョブを作成します。処理されたagentパラメータの統計情報は、NewBrowsersレポートを作成するとそのレポートの表の列として表示されます。詳細は、第5章「演習4: 表示するレポートの作成および準備」を参照してください。

注意:

この演習では、FirstSite IIサンプル・サイトのみを使用することを前提としています。AnalyticsまたはWebCenter Sitesインタフェースで選択が求められた場合は、このサイトを選択します。

2.2 イメージ・タグおよびそのJSPへの新規パラメータの追加

最初に、新しいパラメータでデータ・キャプチャを開始できるように、Analyticsにそのパラメータを認識させます。この例では、FSIIWrapperエレメント内のAnalyticsイメージ・タグおよびAddAnalyticsImgTag JSPにパラメータを追加することによって、これを行います。次の手順を実行すると、センサー・サーブレットがパラメータ値のキャプチャを開始し、それらをRAWデータとして格納します。

1. 新しいパラメータを、FSIIWrapperエレメント内のAnalyticsイメージ・タグ・コールに追加します。

1. 管理者またはCSElementアセットを編集できる権限を持つユーザーとして、WebCenter Sites管理インタフェースにログインします。

2. 選択を求められる場合は、FirstSite IIサンプル・サイトを選択します。

3. ボタン・バーで、「検索」をクリックします。

4. アセット・タイプのリストで、CSElementの検索をクリックします。

5. 「検索」フォームで、検索フィールドにFSIIWrapperと入力し、「検索」をクリックします。

6. 結果のリストで、FSIIWrapperアセットの横にある「編集」(鉛筆)アイコンをクリックします。

7. WebCenter Sitesの「編集」フォームにFSIIWrapperアセットが表示されます。

8. フォームの上部にあるセクション・セレクタで、「エレメント」をクリックします。

9. 「編集」フォームの「エレメント」セクションが表示されます。

10. エレメント・コードの編集を簡単に行うには、「エレメント・ロジック」フィールド内のテキストをすべて選択してコピーし、それを任意のテキスト・エディタに貼り付けます。コードを一時ファイルに保存します。

- エレメント・コード内で、次のAnalyticsイメージ・タグへのコールを見つけます。

<render:callelement elementname="Analytics/AddAnalyticsImgTag">
<render:argument name="c" value='<%=ics.GetVar("c")%>'/>
<render:argument name="cid" value='<%=ics.GetVar("cid")%>'/>
<render:argument name="site" value='<%=ics.GetVar("site")%>'/>
<render:argument name="pagename" value='<%=ics.GetVar("childpagename")%>'/>
<render:argument name="recid" value='<%=ics.GetVar("recid")%>'/>
</render:callelement>

- Analyticsイメージ・タグ・コールの末尾で、終了の</render:callelement>タグの前に、次の文を挿入します。

<render:argument name="agent" value='<%= request.getHeader("User-Agent")%>'/>

注意:

agent変数は、Analyticsイメージ・タグがコールされる前に設定される必要があります。

- 変更後のAnalyticsイメージ・タグ・コールは、次のようになります。

<render:callelement elementname="Analytics/AddAnalyticsImgTag">
<render:argument name="c" value='<%=ics.GetVar("c")%>'/>
<render:argument name="cid" value='<%=ics.GetVar("cid")%>'/>
<render:argument name="site" value='<%=ics.GetVar("site")%>'/>
<render:argument name="pagename" value='<%=ics.GetVar("childpagename")%>'/>
<render:argument name="recid" value='<%=ics.GetVar("recid")%>'/>
<render:argument name="agent" value='<%= request.getHeader( "User-Agent" )
%>'/>
</render:callelement>

- ファイルを保存して閉じます。

2. 新しいパラメータを、Analyticsイメージ・タグJSPに追加します。

1. WebCenter Sitesエクスプローラを起動します。

2. WebCenter Sitesエクスプローラの画面で、「ファイル」→コンテンツ・サーバーを開くを選択して、「コンテンツ・サーバー・ログイン」ダイアログ・ボックスを表示します。

3. 次の値を入力します。

- ホスト名またはアドレス: ホスト名またはIPアドレス。このフィールドは空白にしないでください。

- ユーザー名: WebCenter Sitesユーザー名。

- パスワード: WebCenter Sitesパスワード。

- ポート: ポート番号(デフォルトは8080)。

- プロトコル: 通常はHTTP。(WebサーバーがSSLを実行している場合は、HTTPSを選択できます)。

- アプリケーション・サーバーURLパス: CSサーブレット(/cs/CatalogManager)オプションを選択します。

入力済のログイン・フォームは、図2-1のようになります。

図2-1 WebCenter Sitesエクスプローラのログイン・フォーム

4. 「OK」をクリックしてログインします。
Sitesエクスプローラ・ウィンドウが表示されます。

5. 「localhost」ツリーで、「表」→「ElementCatalog」→「Analytics」を開きます。

6. Analytics表で、AddAnalyticsImgTag JSPを開きます。

7. AddAnalyticsImgTag.jspコードをコピーしてテキスト・エディタに貼り付け、次の行を見つけます。

String recid = ics.GetVar("recid");
String siteName = ics.GetVar("site");

8. 次の行を、直前の手順gに示されている2行の後に追加します。

String agent = ics.GetVar("agent");

変更後のセクションは、次のようになります。

String recid = ics.GetVar("recid");
String siteName = ics.GetVar("site");
String agent = ics.GetVar("agent");

9. 次のコード部分を見つけて、太字のコードを、示されているとおりの位置に挿入します。

<script type="text/javascript">
<!--
var jsParam = '';
if(self.StatPixelParamFromPage) {jsParam=StatPixelParamFromPage;};
var color = 'n/a'; var size = 'n/a'; var puri = '';
var java = navigator.javaEnabled();
var nav = navigator.appName;
var agent = navigator.userAgent;
var objValue = '';
var write = (navigator.appName=='Netscape' && (navigator.appVersion.charAt(0)=='2' ||    navigator.appVersion.charAt(0)=='3')) ? false:true;
if (write==true) {
size = screen.width + "x" + screen.height;
color = (nav!='Netscape') ? screen.colorDepth:screen.pixelDepth;
objValue= encodeURIComponent('<%= ics.GetVar("assetname") %>');
puri = '?siteName=<%= siteName %>&objType=<%= UobjType %>&objID=<%= id
%>&objName=' +objValue+'&sessionID=<%= TsessionID %>
&agent=<%= agent %>&Referer=<%= referer
%>&nav='+nav+'&size='+size+'&color='+color+'&java=
'+java+'&js=true'+jsParam;
puri += '<%= recparameter%>';
puri += '<%= urlEncparameter%>';
//alert(puri);
document.write('<img style="display:none;" height="1" width="1" border="0" src="<%= statisticSensorPath%>'+puri+'" alt="pixel" /
>');
}
//-->
</script>
<noscript>
<img style="display:none;" height="1" width="1" src="<%= statisticSensorPath%>?siteName=<%= siteName%>&objType=<%= UobjType%>&objID=<%= id%>&objName=<%= ics.GetVar("assetname")%>&URLENC=<%= ics.GetVar("objUrl")
%>&sessionID=<%= TsessionID%>
&agent=<%= agent %>&Referer=<%= referer%>&js=false"
alt="pixel" />
</noscript>

3. 変更が行われたら、テキスト・エディタ内のすべてのコードを選択してコピーし、それをSitesエクスプローラのフィールドに貼り付けます。

4. 「保存」でファイルを保存して閉じます。

5. アプリケーション・サーバーを再起動して変更を反映します。

2.3 次の手順

第3章「演習2: DetailDefinition表への新規パラメータの追加」では、データ・キャプチャ用のagentパラメータをDETAILDEFINITION表に追加します。これによってAnalyticsはagentパラメータを処理できるため、新しいagentパラメータでキャプチャされたRAWデータを処理するAnalyticsジョブ(第4章「演習3: 新規Analyticsジョブの開発」で作成)でパラメータを使用できるようになります。新しいAnalyticsジョブは、agentパラメータを処理してレポート(このチュートリアルではNewBrowsersレポート)に表示します。処理されたagentパラメータは、NewBrowsersレポートで表の列として表示されます。

3 演習2: DetailDefinition表への新規パラメータの追加

カスタム・パラメータは、Webサイトで訪問者が行う特定の操作に関するデータをキャプチャします。この演習では、データ・キャプチャ用のカスタム・パラメータをDETAILDEFINITION表に追加する方法について説明します。

この演習の内容は次のとおりです。

- 第3.1項「概要」

- 第3.2項「カスタム・パラメータのデータベース・エントリの作成」

- 第3.3項「次の手順」

3.1 概要

カスタム・パラメータに基づいてレポートを作成するには、最初に、データ・キャプチャの対象となるパラメータを作成し、そのパラメータを処理するようにAnalyticsを構成する必要があります。この演習では、agentパラメータ(第2章「演習1: データ・キャプチャ用の新規パラメータの追加」で作成済)のデータベース・エントリをDETAILDEFINITION表に作成することによって、そのパラメータを処理するようにAnalyticsを構成します。

DETAILDEFINITION表で定義されたパラメータをAnalyticsは認識できるため、そのパラメータを処理するように作成されたAnalyticsジョブは、目的のパラメータを使用できます。agentパラメータを処理するAnalyticsジョブの作成は、次の演習(第4章「演習3: 新規Analyticsジョブの開発」)で行います。

3.2 カスタム・パラメータのデータベース・エントリの作成

Analyticsジョブでカスタム・パラメータを処理してレポートに表示するために、データ・キャプチャの対象となるカスタム・パラメータの行(レコード)を、AnalyticsデータベースのDETAILDEFINITION表に追加します。この演習では、agentパラメータ(第2章「演習1: データ・キャプチャ用の新規パラメータの追加」で作成済)の行を追加します。

DETAILDEFINITION表では、追加するパラメータのタイプをエントリとして指定することが求められるため、Analyticsでサポートされるカスタム・パラメータのタイプについて理解している必要があります。

Analyticsでは、次のタイプのカスタム・パラメータがサポートされています。

- セッション関連: 特定のセッションにバインドされているパラメータ。セッション関連パラメータの値は、セッション全体をとおして同じままです。

- OI (オブジェクト・インプレッション)関連: 特定のページ・ビューまたはオブジェクト・インプレッションにバインドされたパラメータ。OI関連パラメータの値は、レンダリングされるページ(オブジェクト・インプレッション)ごとに異なります。

DETAILDEFINITION表に追加するagentパラメータは、セッション関連パラメータです。表3-1は、DETAILDEFINITION表のスキーマを示しています。

表3-1 DETAILDEFINITION表

列名

データ型

説明

Id

NUMBER (22)

主キー。カスタム・パラメータに関してデータベースによって生成される一意の値です。このキーを使用して、このパラメータの行にアクセスします。

Name

VARCHAR2 (64バイト)

カスタム・パラメータの名前。

Key

VARCHAR2 (64バイト)

イメージ・タグを介して渡されるパラメータの名前。通常、Nameパラメータと同じ値です。タグ内でこの名前を使用して、渡される値を識別します。

Objecttypeid

NUMBER (22)

異なるobjecttypeidの繰返し数を追跡するためにAnalyticsが使用するオブジェクト・タイプ識別子。

Siteid

NUMBER (22)

パラメータの構成先であるsiteid (site表の外部キー)。値をNullに設定すると、登録されているすべてのサイトにパラメータが適用されます。

Type

NUMBER (22)

パラメータのタイプを指定します。

使用可能な値: 0はOI関連パラメータを表し、1はセッション関連パラメータを表します。

Groupfunction

VARCHAR2 (64バイト)

このフィールドは、Analyticsデータベース内のL2_SESSIONDET表でのみ使用されます。この演習では、このフィールドの値はNULLです。

Autodef

NUMBER (22)

このフィールドは非推奨です。この演習では、このフィールドの値はNULLです。

agentパラメータで収集されたデータを格納するには、DETAILDEFINITION表に新しいレコードを追加する必要があります。次のSQL文を実行します(サンプルのValuesは、表に挿入するパラメータの値に置き換えます)。

insert into DETAILDEFINITION (ID, NAME, KEY, OBBJECTTYPEID, SITEID, TYPE,
GROUPFUNCTION, AUTODEF) Values(249, 'mime', 'mime', NULL, NULL, 0, NULL, NULL);

注意:

IDは一意であることが必要で、かつ既存の行と重複しないことが必要です。SITEIDは、Analyticsデータベースに登録されているサイトの値である必要があります。

3.3 次の手順

第4章「演習3: 新規Analyticsジョブの開発」では、この演習でDETAILDEFINITION表に追加した新しいagentパラメータでキャプチャされる、RAWデータを処理する新しいAnalyticsジョブを作成します。新しいAnalyticsジョブは、agentパラメータを処理してレポート(このチュートリアルではNewBrowsersレポート)に表示します。処理されたagentパラメータは、NewBrowsersレポートで表の列として表示されます。

新しいAnalyticsジョブの開発に先立ち、次の点に注意してください。

新しいパラメータがAnalyticsデータのキャプチャを開始するには、次のコンポーネントがインストールされ、実行されている必要があります。

- Analyticsセンサー

- Hadoop

- hadoop-jobs

- HDFSエージェント

注意:

新しいAnalyticsジョブを開発する前に、FSIIサイトを参照します。参照することで、新しいAnalyticsジョブ(次の演習で開発)で処理するデータが作成されます。

4 演習3: 新規Analyticsジョブの開発

Analyticsでカスタム・レポートのRAWデータを処理するには、そのデータを処理する新しいAnalyticsジョブを開発する必要があります。処理されたデータはデータベースに挿入されます。

注意:

この演習では、演習1でAnalyticsインストールに追加したパラメータに基づいて新しいAnalyticsジョブを開発する方法を、順を追って説明します。開発するAnalyticsジョブは、Analyticsインストールに含まれているデフォルトのAnalyticsジョブを再現したものです。このチュートリアルでは、この演習におけるAnalyticsジョブの開発で使用されるすべてのBeanクラスおよびマッパー・クラスの名前は、デフォルトのAnalyticsジョブを上書きしないように名前が変更されています。

この演習の内容は次のとおりです。

- 第4.1項「Analyticsジョブの作成の概要」

- 第4.2項「次の手順」

4.1 Analyticsジョブの作成の概要

Analyticsジョブを開発するために必要な手順の概要は、次のとおりです。

1. 入力として最適な場所を選択します。
analyticsディレクトリ内のフォルダから場所を選択します。Analyticsジョブはこれをレポートの入力データとして使用します。特定の場所を入力として選択する基準は、特定のレポートで必要なデータに主に依存します。ほとんどの場合、次の場所はレポートのデータ要件を十分に満たします。

Sesdata: この場所には、すべてのセッションのデータに加えて、訪問者の詳細、オブジェクト・インプレッションおよびセッションに関連するその他の情報が格納されています。

注意:

カスタム・レポートを作成する際は、injectedフォルダ(oiinjected、sesinjected、visinjectedなど)を入力場所として使用しないでください。これらの場所に格納されたデータは、データベース・インジェクション・プロセッサによってデータベースへの挿入で使用されるためです。

場所、プロセッサおよび各場所に格納されるデータのタイプの詳細は、『Oracle Fusion Middleware WebCenter Sites: Analytics管理者ガイド』を参照してください。

2. スキーマを拡張します。
処理されたデータを格納するには、Analytics表に新しいL3表を追加します。

3. 新しいBeanクラスを作成します。

Beanクラスの一番の目的は、出力データを格納することです。フレームワークでは、Beanクラスを使用してジョブの最終出力を格納します。データベース・インジェクション・プロセッサは、各Beanクラスに格納されているデータを取り出し、そのデータをL3表(前の手順で作成済)に挿入します。

新しいBeanクラスは、フレームワークで提供される事前定義済のクラスを拡張したものです。実装の詳細は、第4.1.1項「新規Analyticsジョブの開発例」および第4.1.2項「New Browsersレポート用のAnalyticsジョブの開発」を参照してください。

4. 新しいMapperクラスを作成します。
Mapperクラスは、入力データを処理するビジネス・ロジックをカプセル化します。すべての入力Beanごとに、マッパー・クラスはBeanクラス(手順3で作成済)の新しいインスタンスを作成し、処理されたデータを新しく作成されたインスタンスに格納します。マッパー・クラスの出力はAnalyticsフレームワークによって収集され、処理されてから、最終的に指定の出力場所に書き込まれます。

新しいマッパー・クラスは、フレームワークで提供される事前定義済のクラスを拡張したものです。実装の詳細は、次の項を参照してください。

5. プロセッサを構成します。
新しくコーディングしたBeanクラスとマッパー・クラスをAnalyticsフレームワークに統合するには、それらを既存のプロセッサ構成ファイル(.xmlファイル)に追加する必要があります。

図4-1は、Analytics-Hadoopジョブ・フレームワークに統合されたカスタム・マッパーを使用したジョブの実行フローを示しています。

図4-1 analytics hadoopジョブ・フレームワークに統合されたカスタム・マッパーを使用したジョブの実行フロー・チャート

Mapフェーズでは、プロセッサが入力場所からデータを読み取ります。このデータはカスタム・マッパーに渡されます。カスタム・マッパーは、すべての入力BeanをカスタムBeanに変換します。

Reduceフェーズでは、カスタム・マッパーから収集されたデータは、処理されてから出力場所に書き込まれます。出力場所のコンテンツには、カスタムBeanが含まれます。この集約データは、データベース・インジェクション・プロセッサによってデータベースに格納されます。

4.1.1 新規Analyticsジョブの開発例

この項の内容は、次のとおりです。

- 第4.1.1.1項「NewBrowsersレポートの設計」

- 第4.1.2項「New Browsersレポート用のAnalyticsジョブの開発」

- 第4.1.3項「データベース・インジェクションの構成」

- 第4.1.4項「新規Analyticsジョブと既存のHadoop-Jobsコンポーネントの統合」

4.1.1.1 NewBrowsersレポートの設計

NewBrowsersレポートでは、レポート期間内に訪問者が指定のサイトのページ・ビューにアクセスするときに使用したブラウザを識別します。

ブラウザのカウントは、各ブラウザのセッションのカウントです。セッションの集計値を単純に合計します。ユーザーが選択できる有効なすべての時間範囲について合計を集計すると、集計値があまりに多くなりすぎるので、日単位の合計に焦点を当てます。

データの集計は、単一のMap-Reduceフェーズで行います。(1) 開始点はセッション・データ(SesData場所)です。このデータを使用して、SesProcessed場所内のL3NewBrowserBeanオブジェクトとして格納される、中間/未圧縮のRAWデータを生成します。(2) SessionProcessorプロセッサがSessionBeanオブジェクトを使用してL3NewBrowserBeanオブジェクトを作成します。このオブジェクトには、データベースに挿入できる集計データが格納されます。図4-2は、この実装を示しています。

図4-2 NewBrowsersレポートの実装

- SesData場所には、すべてのセッションのすべてのデータがあります。このデータを、レポート・データを生成するための開始点として使用します。そのデータを追加または変更する必要はありません。既存のSessionBeanオブジェクトを使用できます。

- SessionProcessorプロセッサを拡張して、siteid、dateid、browseridの組合せ(siteid/dateid/browserid組合せ)ごとに、新しいL3NewBrowserBeanオブジェクトを作成します。このオブジェクトは、SessionProcessorプロセッサによってSesinjected場所に格納されます。

- SessionInjectionプロセッサがデータベースにデータを挿入します。新しいBeanは必要ありませんが、データベースに正しく挿入するには、L3 Bean (SessionProcessorで作成済)のフィールドをアグリゲータで適切に注釈付けする必要があります。

注意:

アグリゲータは、集計可能なBeanのフィールドにタグを付けるためのJava注釈です。SumAggregator以外のアグリゲータを使用する必要がある場合は、次のアグリゲータを使用できます。

- AvgAggregator

- CountAggregator

- DistinctCountAggregator

- MaxAggregator

- NullAggregator

- MinAggregator

4.1.2 New Browsersレポート用のAnalyticsジョブの開発

第4.1項「Analyticsジョブの作成の概要」に記載されている一般的な手順に従って、Analyticsジョブを開発します。

第4.1.2.1項「手順1: 入力場所の選択」

第4.1.2.2項「手順2: スキーマの拡張」

第4.1.2.3項「手順3: Beanの作成」

第4.1.2.4項「手順4: マッパー・クラスの作成」

第4.1.2.5項「手順5: プロセッサ定義へのBeanおよびマッパーの追加」

4.1.2.1 手順1: 入力場所の選択

NewBrowsersレポートではセッションのデータを集計するため、入力場所はsesdata場所です。

4.1.2.2 手順2: スキーマの拡張

データを格納するには、新しい表を追加して事前集計済のL3データを格納する必要があります。analyticsユーザーとして次のSQL文を実行します。

CREATE TABLE L3_DATEXSITEXNEWBROWSERXCOUNT ( DATEID NUMBER NOT NULL , SITEID NUMBER(6) , BROWSERID NUMBER , COUNT NUMBER);commit;

4.1.2.3 手順3: Beanの作成

このレポートでは、1つのBeanが必要です。

L3NewBrowserBean: このクラスは、データベース内のL3表にマップされます。L3NewBrowserBeanは、ブラウザ・アクセスの集計カウントを格納するために使用されます。このBeanのコンテンツは、L3_DATEXSITEXNEWBROWSERXCOUNT表に注入されます。

L3NewBrowserBean Beanクラスを作成します。サンプル・コードは、第4.1.2.3項「L3NewBrowserBean.java」の例を参照してください。

例4-1 L3NewBrowserBean.java

1. package com.fatwire.analytics.domain.l3;

2. import javax.persistence.AttributeOverride;

3. import javax.persistence.Column;

4. import javax.persistence.Entity;

5. import javax.persistence.Id;

6. import javax.persistence.Transient;

7. import com.fatwire.analytics.domain.AbstractL3Bean;

8. import com.fatwire.analytics.domain.annotation.Aggregate;

9. import com.fatwire.analytics.domain.annotation.SumAggregator;

10. import com.fatwire.analytics.domain.key.DateSiteEntityKey;

11. /**

12. * this class represents entries in the L3_dateXsiteXnewbrowserXcount table

13. */

14. @Entity(name="L3_dateXsiteXnewbrowserXcount")

15. @AttributeOverride(name = "key.firstEntity", column = @Column(name = "BROWSERID", nullable = false, insertable = false, updatable = false))

16. public class L3NewBrowserBean extends AbstractL3Bean<DateSiteEntityKey> {

17. private static final long serialVersionUID = 1L;

18. /** the primary key definition of the object/table */

19. @Id

20. private DateSiteEntityKey key = new DateSiteEntityKey();

21. /** the count value for the entity */

22. @Aggregate(aggregatorClass = SumAggregator.class)

23. private Long count;

24. /** overwrite constructor to set the hadoop keys

25. public L3NewBrowserBean() {

26. keys = new String[]{"dateid", "siteid", "browserid", "type"};

27. }

28. public Long getBrowserid() {

29. return key.getFirstEntity();

30. }

31. public void setBrowserid(Long browserid) {

32. key.setFirstEntity(browserid);

33. }

34. @Transient

35. public DateSiteEntityKey getKey() {

36. return key;

37. }

38. public void setKey(DateSiteEntityKey key) {

39. this.key = key;

40. }

41. public Long getSiteid() {

42. return key.getSiteid();

43. }

44. public void setSiteid(Long siteid) {

45. key.setSiteid(siteid);

46. }

47. public Long getDateid() {

48. return key.getDateid();

49. }

50. public void setDateid(Long dateid) {

51. key.setDateid(dateid);

52. }

53. public Long getCount() {

54. return count;

55. }

56. public void setCount(Long count) {

57. this.count = count;

58. }

59. }

L3NewBrowserBeanのコードは、次のように分析されます。

- 行2-10: 必要なすべてのパッケージをインポートします。

- 行16: com.fatwire.analytics.domain.AbstractL3Beanクラスを拡張します。

- 行20-23:
プライベート・メンバー変数を宣言します。

- key: 主キー

- count: セッション数

- @Entity注釈によってこのクラスが永続エンティティとして指定され、JPAサービスで使用できるようになります(行14)。name属性の値は、エンティティのマップ先のデータベース表の名前です。

- @Attribute注釈(行15)により、L3_DATEXSITEXNEWBROWSERXCOUNT表は、BROWSERID列にマップされる永続エンティティのkey.firstEntity属性を持ちます。

- L3複数列主キーの実装であるDateSiteEntityキーを使用します(行20)。

注意:

DateSiteEntity実装の使用が望ましくない場合は、次の複数列主キー実装を使用できます。

- DateSiteEntityEntitykey

- DateSiteEntityStringkey

- DateSiteStringkey

ここで、Entityは数値エンティティを表します。

実装の選択は、L3 Beanのコンテンツを格納する表の主キーにのみ依存します。

- @Id注釈(行19)を使用して、DateSiteEntityキー・メンバー変数をエンティティの主キーとして指定します。

- @Aggregate注釈を使用して、countフィールドにSumAggregatorの注釈を付けます。SumAggregator注釈を使用して、各ブラウザのセッション数が合計されます。(行22)

- Beanクラスのどの複数のインスタンスを集計するかに基づいて、コンストラクタでキーを指定します(行25-26)。typeは、Beanクラスの名前を表します。

- getter/setterメソッドを実装して、プライベート・メンバー・フィールドを公開します(行28-57)。

4.1.2.4 手順4: マッパー・クラスの作成

このレポートでは、L3NewBrowserMapper (L3NewBrowserMapper.java)という1つのマッパー・クラスが必要です。

例4-2 L3NewBrowserMapper.java

1. package com.fatwire.analytics.report.mapper;

2. import java.io.IOException;

3. import org.apache.log4j.Logger;

4. import com.fatwire.analytics.domain.SessionBean;

5. import com.fatwire.analytics.domain.l3.L3NewBrowserBean;

6. import com.fatwire.analytics.mapreduce.AbstractAnalyticsMapper;

7. import com.fatwire.analytics.mapreduce.AnalyticsOutputCollector;

8. /**

9. * L3 mapper on New Browser

10. */

11. public class L3NewBrowserMapper extends AbstractAnalyticsMapper<SessionBean, L3NewBrowserBean> {

12. /** initialize logging */

13. private static final Logger logger = Logger.getLogger(L3NewBrowserMapper.class);

14. @Override

15. public void map(SessionBean input, AnalyticsOutputCollector<L3NewBrowserBean> outputCollector) throws IOException {

16. if(logger.isTraceEnabled()) {

17. logger.trace("mapping input bean '"+ input +"' to L3NewBrowserBean");

18. }

19. L3NewBrowserBean output = new L3NewBrowserBean();

20. output.setDateid(input.getDateid());

21. output.setSiteid(input.getSiteid());

22. output.setBrowserid(input.getBrowserid());

23. output.setCount(1L);

24. // collect the output bean

25. outputCollector.collect(output);

26. }

27. }

L3NewBrowserMapperクラスのコードは、次のように分析されます。

- L3NewBrowserMapperクラスはAbstractAnalyticsMapperクラスを拡張して(行11)、mapメソッドをオーバーライドします(行16-17)。

- mapメソッドでは、SessionBeanからL3NewBrowserBeanの値を設定することによって、すべての入力SessionBeanがL3NewBrowserBeanに変換されます(行19-25)。

- L3NewBrowserBeanのcountプロパティは、すべての入力Beanで1Lに設定されます(行26)。

- 作成されたすべてのL3NewBrowserBeanは、出力コレクタ(AnalyticsOutputCollector)によって収集されます(行29)。

- デバッグ文を追加します(行19)。

4.1.2.5 手順5: プロセッサ定義へのBeanおよびマッパーの追加

新しくコーディングしたBeanクラスとマッパー・クラスを有効にするには、それらを既存のプロセッサ定義に追加する必要があります。マッパーの追加は、対応するプロセッサ・フォルダ内のspring-mapper.xmlファイルにマッパーを追加することによって行います。

この演習では、次のものを構成します。

- L3NewBrowserMapper

- L3NewBrowserBean

Beanおよびマッパーをプロセッサ定義に追加するには:

1. L3NewBrowserMapperを構成します。

1. processors/sesprocessor/spring-mapper.xmlファイルをテキスト・エディタで開きます。

2. bean class行(太字で表示)をspring- mapper.xmlファイルに追加します。

<bean id="AnalyticsMapperConfigBean" class="java.util.ArrayList">
<constructor-arg>
<list>
<bean id="clickstreamMapper" class="com.fatwire.analytics.report.mapper.L3ClickstreamMapper"/>
<bean id="newBrowserMapper" class="com.fatwire.analytics.report.mapper.L3NewBrowserMapper"/>
<bean id="osMapper" class="com.fatwire.analytics.report.mapper.L3OperatingsystemMapper"/>
<bean id="sessionEntryidMapper" class="com.fatwire.analytics.report.mapper.L3SessionEntryMapper"/>
<bean id="sessionExitidMapper" class="com.fatwire.analytics.report.mapper.L3SessionExitMapper"/>
<bean id="ipMapper" class="com.fatwire.analytics.report.mapper.L3IpMapper"/>
<bean id="hostnameMapper" class="com.fatwire.analytics.report.mapper.L3HostnameMapper"/>
<bean id="jsMapper" class="com.fatwire.analytics.report.mapper.L3JsMapper"/>
<bean id="searchengineMapper" class="com.fatwire.analytics.report.mapper.L3SearchengineMapper"/>
<bean id="refererMapper" class="com.fatwire.analytics.report.mapper.L3RefererMapper"/>
<bean id="screenresMapper" class="com.fatwire.analytics.report.mapper.L3ScreenresMapper"/>

<bean id="sessionQuantilMapper" class="com.fatwire.analytics.report.mapper.L3SessionQuantilMapper"/>

<bean id="objectDurationMapper" class="com.fatwire.analytics.report.mapper.L3ObjectDurationMapper"/>

<bean id="engageMapper" class="com.fatwire.analytics.report.mapper.L3EngageMapper"/>
</list>
</constructor-arg>
</bean>

2. L3NewBrowserBeanを構成します。

1. processor/sesprocessor/spring-combiner_reducer.xmlファイルをテキスト・エディタで開きます。

2. entry key行(太字で表示)をspring- combiner_reducer.xmlファイルに追加します。

<util:map id="AnalyticsCombinerReducerConfigBean" map-class="java.util.HashMap">
<entry key="com.fatwire.analytics.domain.l3.L3ClickstreamBean" value-ref="analyticsBeanReducer"/>
<entry key="com.fatwire.analytics.domain.l3.L3OperatingsystemBean" value-ref="analyticsBeanReducer"/>
<entry key="com.fatwire.analytics.domain.l3.L3NewBrowserBean" value-ref="analyticsBeanReducer"/>

<entry key="com.fatwire.analytics.domain.l3.L3SessionEntryBean" value-ref="analyticsBeanReducer"/>
<entry key="com.fatwire.analytics.domain.l3.L3SessionExitBean" value-ref="analyticsBeanReducer"/>
<entry key="com.fatwire.analytics.domain.l3.L3IpBean" value-ref="analyticsBeanReducer"/>
<entry key="com.fatwire.analytics.domain.l3.L3HostnameBean" value-ref="analyticsBeanReducer"/>
<entry key="com.fatwire.analytics.domain.l3.L3JsBean" value-ref="analyticsBeanReducer"/>
<entry key="com.fatwire.analytics.domain.l3.L3SearchengineBean" value-ref="analyticsBeanReducer"/>
<entry key="com.fatwire.analytics.domain.l3.L3RefererBean" value-ref="analyticsBeanReducer"/>
<entry key="com.fatwire.analytics.domain.l3.L3ScreenresBean" value-ref="analyticsBeanReducer"/>

<entry key="com.fatwire.analytics.domain.l3.L3SessionQuantilBean" value-ref="analyticsBeanReducer"/>

<entry key="com.fatwire.analytics.domain.l3.L3ObjectDurationBean" value-ref="analyticsBeanReducer"/>

<entry key="com.fatwire.analytics.domain.l3.L3EngageRecBean" value-ref="analyticsBeanReducer"/>
<entry key="com.fatwire.analytics.domain.l3.L3EngageRecSegBean" value-ref="analyticsBeanReducer"/>
<entry key="com.fatwire.analytics.domain.l3.L3EngageRecSegObjBean" value-ref="analyticsBeanReducer"/>
</util:map>

4.1.3 データベース・インジェクションの構成

次の手順を実行して、データベース・インジェクションを構成します。

1. processors/sesinjection/spring-combiner.xmlファイルをテキスト・エディタで開きます。

2. entry key行(太字で表示)をspring-combiner.xmlスニペットに追加します。

<util:map id="AnalyticsCombinerConfigBean" map-class="java.util.HashMap">
<entry key="com.fatwire.analytics.domain.l3.L3ClickstreamBean" value-ref="analyticsBeanReducer"/>
<entry key="com.fatwire.analytics.domain.l3.L3NewBrowserBean" value-ref="analyticsBeanReducer"/>
<entry key="com.fatwire.analytics.domain.l3.L3OperatingsystemBean" value-ref="analyticsBeanReducer"/>
<entry key="com.fatwire.analytics.domain.l3.L3SearchengineBean" value-ref="analyticsBeanReducer"/>

<entry key="com.fatwire.analytics.domain.l3.L3SessionEntryBean" value-ref="analyticsBeanReducer"/>
<entry key="com.fatwire.analytics.domain.l3.L3SessionExitBean" value-ref="analyticsBeanReducer"/>
<entry key="com.fatwire.analytics.domain.l3.L3IpBean" value-ref="analyticsBeanReducer"/>
<entry key="com.fatwire.analytics.domain.l3.L3HostnameBean" value-ref="analyticsBeanReducer"/>
<entry key="com.fatwire.analytics.domain.l3.L3JsBean" value-ref="analyticsBeanReducer"/>
<entry key="com.fatwire.analytics.domain.l3.L3SearchengineBean" value-ref="analyticsBeanReducer"/>
<entry key="com.fatwire.analytics.domain.l3.L3RefererBean" value-ref="analyticsBeanReducer"/>
<entry key="com.fatwire.analytics.domain.l3.L3ScreenresBean" value-ref="analyticsBeanReducer"/>

<entry key="com.fatwire.analytics.domain.l3.L3SessionQuantilBean" value-ref="analyticsBeanReducer"/>

<entry key="com.fatwire.analytics.domain.l3.L3ObjectDurationBean" value-ref="analyticsBeanReducer"/>

<entry key="com.fatwire.analytics.domain.l3.L3EngageRecBean" value-ref="analyticsBeanReducer"/>
<entry key="com.fatwire.analytics.domain.l3.L3EngageRecSegBean" value-ref="analyticsBeanReducer"/>
<entry key="com.fatwire.analytics.domain.l3.L3EngageRecSegObjBean" value-ref="analyticsBeanReducer"/>
</util:map>

3. processors/sesinjection/spring-reducer.xmlファイルをテキスト・エディタで開きます。

4. entry key行(太字で表示)をspring-reducer.xmlスニペットに追加します。

<util:map id="AnalyticsReducerConfigBean" map-class="java.util.HashMap">
<entry key="com.fatwire.analytics.domain.l3.L3ClickstreamBean" value-ref="databaseInjection"/>
<entry key="com.fatwire.analytics.domain.l3.L3NewBrowserBean" value-ref="databaseInjection"/>
<entry key="com.fatwire.analytics.domain.l3.L3OperatingsystemBean" value-ref="databaseInjection"/>
<entry key="com.fatwire.analytics.domain.l3.L3SearchengineBean" value-ref="databaseInjection"/>

<entry key="com.fatwire.analytics.domain.l3.L3SessionEntryBean" value-ref="databaseInjection"/>
<entry key="com.fatwire.analytics.domain.l3.L3SessionExitBean" value-ref="databaseInjection"/>
<entry key="com.fatwire.analytics.domain.l3.L3IpBean" value-ref="databaseInjection"/>
<entry key="com.fatwire.analytics.domain.l3.L3HostnameBean" value-ref="databaseInjection"/>
<entry key="com.fatwire.analytics.domain.l3.L3JsBean" value-ref="databaseInjection"/>
<entry key="com.fatwire.analytics.domain.l3.L3SearchengineBean" value-ref="databaseInjection"/>
<entry key="com.fatwire.analytics.domain.l3.L3RefererBean" value-ref="databaseInjection"/>
<entry key="com.fatwire.analytics.domain.l3.L3ScreenresBean" value-ref="databaseInjection"/>

<entry key="com.fatwire.analytics.domain.l3.L3SessionQuantilBean" value-ref="databaseInjection"/>

<entry key="com.fatwire.analytics.domain.l3.L3ObjectDurationBean" value-ref="databaseInjection"/>

<entry key="com.fatwire.analytics.domain.l3.L3EngageRecBean" value-ref="databaseInjection"/>
<entry key="com.fatwire.analytics.domain.l3.L3EngageRecSegBean" value-ref="databaseInjection"/>
<entry key="com.fatwire.analytics.domain.l3.L3EngageRecSegObjBean" value-ref="databaseInjection"/>
</util:map>

4.1.4 新規Analyticsジョブと既存のHadoop-Jobsコンポーネントの統合

新しいAnalyticsジョブを開発したら、jarファイル(hadoop-jobs.jar)を再作成することによって、開発した新しいジョブと既存のhadoop-jobsコンポーネントを統合します。新しいhadoop-jobs.jarファイルをhadoop-jobsディレクトリにコピーします。jarファイルを再作成することによって、hadoop-jobsコンポーネントは、この演習で開発した新しいAnalyticsジョブでキャプチャされたデータを処理できるようになります。

新しいAnalyticsジョブと既存のhadoop-jobsコンポーネントを統合するには:

1. hadoop-jobs.jarファイルを作成します。

2. hadoop-jobsインストール・ディレクトリにある既存のhadoop-jobs.jarファイルを、作成したばかりのjarファイルに置き換えます。次に、runコマンドが使用する実際のjarである._tmp_hadoop-jobs.jarファイルを削除します。このjarを削除することによって、runコマンドはこれを新しいhadoop-jobs.jarから再構築します。

3. パラメータ(第2章「演習1: データ・キャプチャ用の新規パラメータの追加」で追加済)でキャプチャされたデータを処理するために、hadoop-jobsコンポーネントを実行します。

4.2 次の手順

このチュートリアルの第5章「演習4: 表示するレポートの作成および準備」では、レポート・インタフェースで新しいレポートを作成する方法を、順を追って説明します。例として、ブラウザごとの訪問者数を表示するNewBrowsersレポートを作成します。

注意:

このチュートリアルで作成するNewBrowsersレポートは、Analyticsインストールに含まれているデフォルトのBrowsersレポートを再現したものです。このチュートリアルでは、構成するBrowsersレポートのxmlファイルおよびレポート名に加えて、Beanクラスおよびマッパー・クラスの名前も、デフォルトのBrowsersレポートを上書きしないように名前が変更されています。

5 演習4: 表示するレポートの作成および準備

この演習の目標は、完全かつ使用可能なAnalyticsレポートの構成方法を理解することです。この目標を達成するために、NewBrowsersというカスタム・レポートを構成します。このレポートには、レポート期間内に訪問者が指定のサイトのページ・ビューにアクセスするときに使用したブラウザが表示されます。

注意:

このチュートリアルで作成するNewBrowserレポートは、Analyticsインストールに含まれているデフォルトのBrowsersレポートを再現したものです。このチュートリアルでは、構成するBrowsersレポートのxmlファイルおよびレポート名に加えて、Beanクラスおよびマッパー・クラスの名前も、デフォルトのBrowsersレポートを上書きしないように名前が変更されています。

レポートには、FirstSite IIサンプル・サイトですでにキャプチャされ、Analyticsデータベースに格納されているデータが表示されます。

レポートを作成する際は、最初に、「Hello World」というテキストを表示するテスト・モジュールが含まれる、簡単なレポートを作成します。このテスト・モジュールは、レポートへの機能追加を開始するときに削除します。

注意:

この演習では、FirstSite IIサンプル・サイトのみを使用することを前提としています。AnalyticsまたはWebCenter Sitesインタフェースで選択が求められた場合は、このサイトを選択します。

この演習の内容は次のとおりです。

- 第5.1項「レポート設計」

- 第5.2項「表示するNewBrowsersレポートの作成および準備」

- 第5.3項「フィルタの追加」

5.1 レポート設計

Analyticsレポートは、モジュールで構成されます。モジュールとは、表、チャート、フィルタなど、レポートの特定の機能を実装する一連のコードです。たとえば、この演習で作成するNewBrowsersレポートには、フィルタ、チャート、表および期間セレクタの機能が含まれます(図5-1を参照)。

図5-1 New Browsersレポート

期間セレクタ以外の各機能は、別個のモジュールとして、かつ、ほとんどの場合、自己完結型のモジュールとして実装されます。(フィルタなど、機能によっては、動作するために他のモジュールのコードを変更する必要があります。)表モジュールの構造を見てみましょう。モジュール宣言、データ取得セクションおよび表示セクションがあります。

データベースへの問合せを行ってデータを表示するモジュールには、前述のサンプル・コードに示されているように、<sql>タグおよび<display>タグが含まれます。フィルタ・モジュールなど、データを表示しないモジュールの構造は、次のとおりです。

<filter name="filter-browsername" required="false" type="text" captions="name"   key="filter-browsername" />

チャート・モジュールの構造は、前述の構造と同じです。

レポートの表やチャートなどの機能には、アプリケーション・サーバーのクラスパスでアクセス可能なプロパティ・ファイルに値を定義しておくことによって入力する必要がある、領域(ヘッダー、フィールド名、列ヘッダーなど)が含まれます。たとえば、次の文では、表のブラウザ名列のヘッダーを定義しています。

report_newbrowser_module_browser_column_broname=Name

注意:

参考のために、NewBrowsersレポートのコードを、注釈付きのモジュールごとに、第5.1.1項「NewBrowsersレポートのコード」に示します。

レポートの作成方法を理解したので、先に進み、NewBrowsersレポートを作成します。第5.2項「表示するNewBrowsersレポートの作成および準備」に進みます。

5.1.1 NewBrowsersレポートのコード

NewBrowsersレポートの元となるコードは、次のとおりです。コードには参考用の注釈が含まれています。

<?xml version="1.0" encoding="UTF-8"?>
<!--  <!DOCTYPE report SYSTEM "report.dtd">  -->

<report type="std" visible="true" name="newbrowser" >

<!-- Global parameters (such as sitenames), are defined here-->

<globalparam name="sitenames" />

<!-- After declaring global parameters, start declaring several request parameters like rgrpid, timepreset, sdate, edate etc. sdate, edate enable the time range selector in the report-->
<param type="request" name="rgrpid" key="rgrpid" required="false" />
<param type="request" name="timepreset" key="timepreset" required="false">
<restriction type="listvalue">
<restrictionvalue value="yesterday" />
<restrictionvalue value="lastweek" />
<restrictionvalue value="lastmonth" />
<restrictionvalue value="last7days" />
<restrictionvalue value="last4weeks" />
<restrictionvalue value="last12months" />
</restriction>
</param>
<param type="request" name="siteid" key="siteid" required="true" />
<param type="request" name="sdate" key="sdate" required="true">
<restriction type="isDate" value="dd.MM.yyyy" />
</param>
<param type="request" name="edate" key="edate" required="true">
<restriction type="isDate" value="dd.MM.yyyy" />
</param>

<!—a filter is getting configured here, that will filter the report data by browser name. -->
<filter name="filter-browsername"
required="false"
type="text"
captions="name"
key="filter-browsername"
/>

<!—the following parameter will generate the sum of all sessions that have come from different browsers-->
<param type="sql" name="browsertotal" >
<query>
select
nvl(sum(count), 0) as count
from
help_dates dates
join l3_datexsitexnewbrowserxcount l3 on (dates.id = l3.dateid)
where<![CDATA[
siteid = #siteid# and
dates.dat >= to_date('#sdate#', 'DD-MM-YYYY') and
dates.dat  < to_date('#edate#', 'DD-MM-YYYY')+1 ]]>
</query>
</param>
<!-- The chart module defines your pie chart. -->
<module type="stdchart" name="chartbrowser">
<param type="request" name="charttype" key="chartbrowser_charttype"
default="pie_labeled">
<restriction type="listvalue">
<restrictionvalue value="pie_labeled" />
<restrictionvalue value="bar_labeled" />
</restriction>
</param>

<param type="string" name="chart_max_display" value="10"/>
<param type="string" name="chart_display_rest" value="true"/>
<sql>
<query>
select
bro.id as broid,
bro.name as broname,
nvl(count, 0) as count,
<equals name="browsertotal" value="0">
0 as percent
</equals>
<notEquals name="browsertotal" value="0">
(nvl(count, 0)/#browsertotal#)*100 as percent
</notEquals>
from
l2_browser bro
join (
select
bro2.id as broid,
bro2.name as broname,
sum(count) as count
from
help_dates dates
join l3_datexsitexnewbrowserxcount l3 on
(dates.id = l3.dateid)
join l2_browser bro2 on (l3.browserid = bro2.id
where<![CDATA[
siteid = #siteid# and
dates.dat >= to_date('#sdate#', 'DD-MM-YYYY') and
dates.dat  < to_date('#edate#', 'DD-MM-YYYY')+1 ]]>
group by
bro2.id, bro2.name

) on (bro.id = broid)
<dynamicOrderBy default="count-desc" />
</query>
</sql>
<display type="html">
<value name="xaxis" type="string">
<valueparam name="format" parse="false"/>
<valueparam name="value" value="#broname#" />
</value>

<value name="yaxis" type="number">
<valueparam name="format" parse="false" value="#####0" />
<valueparam name="value" value="#count#" />
</value>
</display>

</module>
<!-- This module defines the table that will show statistics for each browser to the target page.-->
<module type="stdtable" name="browser" >
<sql>
<query>
select
bro.id as broid,
bro.name as broname,
bro.iconpath as broiconpath,
nvl(count, 0) as count,
<equals name="browsertotal" value="0">
0 as percent
</equals>
<notEquals name="browsertotal" value="0">
(nvl(count, 0)/#browsertotal#)*100 as percent
</notEquals>
from
l2_browser bro
join (
select
bro2.id as broid,
bro2.name as broname,
sum(count) as count
from
help_dates dates
join l3_datexsitexnewbrowserxcount l3 on (dates.id = l3.dateid)
join l2_browser bro2 on (l3.browserid = bro2.id)
where<![CDATA[
<!-- The CDATA statement allows the time period selector to limit the data displayed in the table to a specific time period. -->
siteid = #siteid# and
dates.dat >= to_date('#sdate#', 'DD-MM-YYYY') and
dates.dat < to_date('#edate#', 'DD-MM-YYYY')+1 ]]>

<!-- The <notNull> tag ensures that its contents are added to the main query only if they are not null. -->

<notNull name="filter-browsername">
and lower(bro2.name) like lower(replace('#filter-
browsername#','*','%'))
</notNull>
group by
bro2.id, bro2.name

) on (bro.id = broid)
<dynamicOrderBy default="count-desc" />
</query>
<count type="simple" />
</sql>

<display type="html">
<!-- Table columns are defined here.
Each <column> statement defines one column.-->

<column name="broname" columntype="text" sortrscolumn="broname">
<value type="image">
<valueparam name="src" value="#imgpath#/browser/#broiconpath#" />
<valueparam name="alt" value="#broname#" />
<valueparam name="text" value="#broname#" />
<valueparam name="width" value="16" />
<valueparam name="height" value="16" />
</value>
<value type="string">
<valueparam name="value" value=" #broname#" />
</value>
</column>
<column name="count" columntype="number" sortrscolumn="count">
<value type="number">
<valueparam name="format" parse="false" value="#####0" />
<valueparam name="value" value="#count#" />
</value>
</column>
<column name="percent" columntype="number" sortrscolumn="count">
<value type="number">
<valueparam name="format" parse="false" value="#####0.0" />
<valueparam name="value" value="#percent#" />
</value>
</column>
<column name="chart" columntype="string">
<value type="chart">
<valueparam name="format" parse="false" value="#####0" />
<valueparam name="value" value="#percent#" />
<valueparam name="maxvalue" value="100" />
<valueparam name="width" value="100" />
<valueparam name="image" value="#imgpathstyle_branding#graph_
blue.gif" />
</value>
</column>
</display>
</module>
</report>

5.2 表示するNewBrowsersレポートの作成および準備

NewBrowsersレポート(第5.1項「レポート設計」を参照)を作成します。

注意:

この演習では、次に示す順番で、レポートに機能を追加します。レポート・コードに精通している場合は、自分にとって最も都合のよい順番でレポートを作成できます。ただし、フィルタなど、機能によっては、他のモジュールのコードを変更する必要があるので、注意してください。

1. 第5.2.1項「レポート・ファイルの作成および登録」。最初に、レポート・コードが格納されるXMLファイルを作成し、それをAnalyticsに登録します。

2. 第5.2.2項「表の追加」。表には、各ブラウザの一連の統計情報が表示されます(ブラウザ名、セッション、すべてのセッションのパーセント、およびパーセントをグラフィックに表示するチャート)。

3. 第5.2.3項「期間セレクタの追加」。このセレクタを使用すると、レポートに表示されるデータを特定の期間に制限できます。(この機能にモジュールは必要ありません。)

4. 第5.3項「フィルタの追加」。フィルタを使用すると、レポートに表示されるデータを特定のブラウザやセッション数に制限できます。

5. 第5.3.3項「チャートの追加」。NewBrowsersのチャートには、レポート期間内にサイトのページ・ビューへのアクセスで使用された特定のブラウザの頻度が表示されます。

6. 第5.3.4項「完成したNewBrowsersレポートのテスト」。レポートをテストして、外観と動作が意図したとおりであることを確認します。

5.2.1 レポート・ファイルの作成および登録

最初に、レポートの基盤を作成します。これは、レポート・コードが格納されるXMLファイルです。ここでは、テキストのみを表示するHello Worldテスト・モジュールが含まれるレポート・ファイルを作成し、そのレポートをAnalyticsに登録します。

レポート・ファイルを作成および登録する手順は、次のとおりです。

第5.2.1.1項「手順1: XMLファイルの作成」

第5.2.1.2項「手順2: XMLファイルのAnalyticsレポート・ディレクトリへの配置」

第5.2.1.3項「手順3: レポート・コンポーネントのラベル付け」

第5.2.1.4項「手順4: Analyticsユーザーへのレポートの有効化」

第5.2.1.5項「手順5: 新規レポートのテスト」

5.2.1.1 手順1: XMLファイルの作成

最初の手順では、report_newbrowser.xmlという名前のXMLファイルを作成します。

1. テキスト・エディタで、report_newbrowser.xmlという名前の新しいファイルを作成します。

2. 次のコードをファイルに貼り付けます。

<report type="std" name="newbrowser">

<param type="request" name="rgrpid" key="rgrpid" required="false" />
<param type="request" name="siteid" key="siteid" required="true" />

<module type="simpletext" name="helloworld" >
<display type="html">
<text>
<![CDATA[
<div>
Hello World! FatWire is greeting you!
</div>
]]>
</text>
</display>
</module>
</report>

3. ファイルを保存して閉じます。

5.2.1.2 手順2: XMLファイルのAnalyticsレポート・ディレクトリへの配置

レポート・ファイルを、global.xml構成ファイル内のreport_instdirパラメータで定義されるディレクトリにコピーします。これによって、Analyticsはレポート・ファイルにアクセスできます。global.xmlファイルおよびその場所の詳細は、『Oracle Fusion Middleware WebCenter Sitesインストレーション・ガイド』を参照してください。

5.2.1.3 手順3: レポート・コンポーネントのラベル付け

レポート名、モジュール・ヘッダーなど、領域のラベルを定義する必要があります。定義するラベルは、レポートが生成されるとレポート・インタフェースに表示されます。

注意:

Analyticsでのコンポーネント・ラベリングは、ResourceBundle Javaクラスを使用して実装されます。このクラスの詳細は、次のURLを参照してください。

http://java.oracle.com/developers/technicalArticles/Intl/ResourceBundles/

1. テキスト・エディタで、NewBrowsersLocalization.propertiesという名前の新しいファイルを作成します。

2. アプリケーション・サーバーのクラスパス内のディレクトリに、ファイルを保存します。この演習では、アプリケーション・サーバーのanalytics Webアプリケーション・ディレクトリ内のWEB-INF/classesディレクトリに配置します。

3. レポート・インタフェース内でラベルを付けるパラメータ文字列ごとに、プロパティ・ファイルに文を追加します。ここでは、レポート名を指定し、Hello Worldモジュールにヘッダーを指定します。プロパティ・ファイルに次の文を追加します。

report_newbrowser=New Browsers
report_newbrowser_module_helloworld=My first report in Analytics!

注意:

プロパティ・ファイルに文を追加する場合は、次の構文を使用する必要があります。

- レポート名: report_reportName

- モジュール名: report_reportName_module_moduleName

- 表内の列ヘッダー: report _reportName_module_column_columnName

4. 2つの文を追加したら、ファイルを保存して閉じます。

5. プロパティ・ファイルの名前をglobal.xmlファイルに追加することによって、プロパティ・ファイルをAnalyticsに登録します。手順は次のとおりです。

1. テキスト・エディタで、global.xmlファイル(通常は、アプリケーション・サーバーのanalytics Webアプリケーション・ディレクトリ内のWEB-INF/classesディレクトリにあります)を開きます。

2. <locales></locales>セクションを見つけて、次の文をその中に挿入します。
<locale name="NewBrowserLocalization" />

3. ファイルを保存して閉じます。

6. アプリケーション・サーバーを再起動して変更を反映します。

5.2.1.4 手順4: Analyticsユーザーへのレポートの有効化

Analyticsユーザーが新しいレポートを使用できるためには、レポートをAnalyticsに登録し、レポートをレポート・グループに追加し、レポートへのアクセス権限をユーザーに付与する必要があります。

1. 次のURLからcsuser/csuserとして、Analytics管理インタフェースにログインします。

http://<hostname>:<port>/analyticsadmin/Admin?advmode=true

注意:

advmode=trueパラメータを指定すると、管理インタフェースで通常は使用できない高度な構成オプションにアクセスできます。

2. 新しいレポートをAnalyticsに登録します。

1. 左側のペインの「レポート」セクションで、「登録」をクリックします。

2. レポートの追加/編集フォームが表示されます。

3. 「名前」フィールドに、newbrowserと入力します。
これは、レポートのオブジェクト・ハンドルです。ここで入力する値は、コード内でのレポートの参照に使用されます(第5.2.1.3項「レポート・コンポーネントのラベル付け」で、レポートのコンポーネントにラベルを設定するときに、この名前を使用しました)。この名前がレポート・インタフェースに表示されることはありません。

4. 「構成ファイルのパス」フィールドに、report_newbrowser.xmlと入力します。

5. 「保存」をクリックします。

3. 新しいレポートを「お気に入り」レポート・グループに追加します。

1. 左側のペインのレポートとレポート・グループ"セクションで、「割当て」をクリックします。
「レポート・グループ」フォームが表示されます。

2. 「レポート・グループ」ドロップダウン・リストで、「ユーザー」を選択します。

3. レポートのリストで、「newbrowser」の横のチェック・ボックスを選択します。

4. 「レポート・グループ」ドロップダウン・リストで、「お気に入り」を選択します。

5. レポートのリストで、「newbrowser」の横のチェック・ボックスを選択します。

6. 「保存」をクリックします。

4. レポートへのアクセス権限をユーザーに付与します。

1. 左側のペインのアクセス権限セクションで、権限の付与をクリックします。

2. 「ユーザー・グループ」フォームが表示されます。

3. フォームで、「newbrowser」の横のチェック・ボックスを選択します。

4. 「保存」をクリックします。

5.2.1.5 手順5: 新規レポートのテスト

レポートを生成し、その動作が意図したとおりであることを確認します。

1. 次のURLからcsuser/csuserとして、Analyticsレポート管理インタフェースにログインします。

http://<hostname>:<port>/analytics/Reports.do

2. 左側のペインの「グループ」ドロップダウン・リストで、「お気に入り」を選択します。

3. 「レポート」リストで、「New Browsers」をクリックします。
レポートが表示されます。レポートは図5-2のようになります。

図5-2 生成されたNew Browsersレポート

4. レポートがこの図のように表示されない場合やエラーが表示される場合は、手順を再度追って、コードにエラーがないかどうかを確認します。
レポートが意図したとおりに動作することを確認したら、第5.2.2項「表の追加」に進みます。

5.2.2 表の追加

表は、Analyticsレポートにデータを表示するための基本的な方法です。ここでは、NewBrowsersレポートに表を追加して、各種ブラウザに関する様々なカテゴリの情報を表示します。

表の追加方法

レポートに表を追加するには、レポートのコードに表モジュールを挿入します。表モジュールには、2つのセクションがあります(第5.1項「レポート設計」の例を参照)。

- データ取得セクション(行b-aoの<sql>タグで囲まれた部分)。このセクションには、表に表示するデータをAnalyticsデータベースから取得するSQLコードが含まれています。

- 表示セクション(行aq-byの<display>タグで囲まれた部分)。このセクションには、データ取得セクションのコードによってAnalyticsデータベースから取得されたデータを書式設定し、表示するコードが含まれています。表示セクションのコードによって、表のレイアウトおよび各列に適用される書式が定義されます。
ここでは、レポートにNewBrowsers表を追加します。この表は、次の列を表示します。

- Name

- Sessions

- Percent of All Sessions

- Chart

表は、図5-3のようになります。

図5-3 New Browsersレポートの表

レポートに表を追加するには:

1. report_newbrowser.xmlファイルを開き、Hello Worldテスト・モジュールを次のコードに置き換えます。

1. <module type="stdtable" name="browser" >

2. <sql>

3. <query>

4. select

5. bro.id as broid,

6. bro.name as broname,

7. bro.iconpath as broiconpath,

8. nvl(count, 0) as count,

9. <equals name="browsertotal" value="0">

10. 0 as percent

11. </equals>

12. <notEquals name="browsertotal" value="0">

13. (nvl(count, 0)/#browsertotal#)*100 as percent

14. </notEquals>

15. from

16. l2_browser bro

17. join (

18. select

19. bro2.id as broid,

20. bro2.name as broname,

21. sum(count) as count

22. from

23. help_dates dates

24. join l3_datexsitexnewbrowserxcount l3 on (dates.id = l3.dateid)

25. join l2_browser bro2 on (l3.browserid = bro2.id)

26. where<![CDATA[

27. siteid = #siteid# and

28. dates.dat >= to_date('#sdate#', 'DD-MM-YYYY') and

29. dates.dat < to_date('#edate#', 'DD-MM-YYYY')+1 ]]>

30. <notNull name="filter-browsername">

31. and lower(bro2.name) like lower(replace('#filter-

32. browsername#','*','%'))

33. </notNull>

34. group by

35. bro2.id, bro2.name

36. ) on (bro.id = broid)

37. <dynamicOrderBy default="count-desc" />

38. </query>

39. <count type="simple" />

40. </sql>

41. <display type="html">

42. <column name="broname" columntype="text" sortrscolumn="broname">

43. <value type="image">

44. <valueparam name="src" value="#imgpath#/browser/#broiconpath#" />

45. <valueparam name="alt" value="#broname#" />

46. <valueparam name="text" value="#broname#" />

47. <valueparam name="width" value="16" />

48. <valueparam name="height" value="16" />

49. </value>

50. <value type="string">

51. <valueparam name="value" value=" #broname#" />

52. </value>

53. </column>

54. <column name="count" columntype="number" sortrscolumn="count">

55. <value type="number">

56. <valueparam name="format" parse="false" value="#####0" />

57. <valueparam name="value" value="#count#" />

58. </value>

59. </column>

60. <column name="percent" columntype="number" sortrscolumn="count">

61. <value type="number">

62. <valueparam name="format" parse="false" value="#####0.0" />

63. <valueparam name="value" value="#percent#" />

64. </value>

65. </column>

66. <column name="chart" columntype="string">

67. <value type="chart">

68. <valueparam name="format" parse="false" value="#####0" />

69. <valueparam name="value" value="#percent#" />

70. <valueparam name="maxvalue" value="100" />

71. <valueparam name="width" value="100" />

72. <valueparam name="image" value="#imgpathstyle_branding#graph_blue.gif" />

73. </value>

74. </column>

75. </display>

76. </module>
前述のコードは、次のように分析されます。

- データ取得セクションでは、select問合せによって、必要な行(broid、broname、broiconpath、count、percent)がL3_DATEXSITEXNEWBROWSERXCOUNT表およびL2_BROWSER表から取得されます(行d-ao)。これらの値には、表示セクションからシャープ(#)記号で囲んでコールすることによってアクセスします(たとえば、行baのvalue="#broname#")。

- 行alの<dynamicOrderBy>タグによって、行の順序が定義されます。この例では、値"count-desc"によって、行の順番がセッション数の降順であることが指定されます。

- 表示セクションでは、<column>文によって、表を構成する列が定義されます(行ar-bc、bd-bi、bj-boおよびbp-bx)。各列定義は表内の1つの列に対応し、次のパラメータを使用します。
name (必須): 列のオブジェクト・ハンドルを指定します。このハンドルを使用して、NewBrowserLocalization.propertiesファイル内の列のラベルを指定します。

columntype (必須): 列のタイプを指定します。表では数値タイプ、テキスト・タイプおよび文字列タイプの列が使用されます。

sortrscolumn (必須): 列がソート可能かどうか、およびソート可能な場合はデータのソート方法を指定します。

注意:

ソート可能な列の場合、そのヘッダーに小さな矢印が表示され、その値のソート順が示されます。矢印をクリックすると、ソート順が反転します。

- この例では、次の列が定義されます。
テキスト・タイプのbroname列(行ar-bc)には、ブラウザの名前と対応するアイコンが表示されます。テキスト・タイプの列では、イメージ、数値、文字列、日付などのタイプのvalueパラメータ(行as-bb)を使用できます。(パラメータ・タイプはvalueタグで定義されます)。このbroname列は、イメージと文字列の2種類の値で構成されています。イメージ・タイプの値は、src (source path)、alt (alternative text)、width、heightなど、様々なvalueパラメータを含みますが、これらに限定されるものではありません。これらのパラメータがまとめられて、レポート上のイメージのレンディションが定義されます。

数値タイプのcount列(行bd-bi)には、ブラウザに基づくセッション数が表示されます。numberタイプの列には、numberタイプ(パラメータ・タイプはvalueタグで定義)のvalueパラメータ(行as-bb)が必要で、これによって表示するデータ(valueパラメータ、行ba)およびデータの書式(formatパラメータ、行az)が指定されます。

数値タイプのpercent列(行bj-bo)には、異なるすべてのブラウザに基づくすべてのセッションを基準とした、セッションのパーセントが表示されます。

チャート・タイプのchart列(行bp-bx)は、percent列のグラフィック表示です。

2. ファイルを保存して閉じます。

3. 表および列ヘッダーのラベルを次のように指定します。

1. テキスト・エディタで、NewBrowserLocalization.propertiesファイル(この演習の場合、アプリケーション・サーバーのanalyticsアプリケーション・ディレクトリ内のWEB-INF/classesディレクトリにあります)を開きます。

2. ファイルの末尾に次の文を追加します。

# Report New Browser
report_newbrowser=Browsers
report_newbrowser_module_browser_column_broname=Name
report_newbrowser_module_browser_column_count=Sessions
report_newbrowser_module_browser_column_percent=Percent of All Sessions
report_newbrowser_module_browser_column_chart=Chart
report_newbrowser_module_browser=Browsers

3. ファイルを保存して閉じます。

4. アプリケーション・サーバーを再起動して変更を反映します。

4. レポートをテストします。このとき、レポートは図5-4のように表示されます。

図5-4 追加した表が表示されているNew Browsersレポート

5. レポートが図5-4のように表示されない場合やエラーが表示される場合は、手順を再度追って、コードにエラーがないかどうかを確認します。

6. 第5.2.3項「期間セレクタの追加」に進みます。

5.2.3 期間セレクタの追加

NewBrowsersレポートにデータが表示されるようになったので、期間セレクタを追加します。このセレクタは非常に便利な機能です。このセレクタを使用すると、レポートに表示されるデータの量を特定の期間に制限できます。たとえば、特定の日に発生した訪問者のアクティビティや、ある日付にキャプチャされたすべてのアクティビティではなく、ある時間に発生したアクティビティも表示できます。

レポートにアクセスすると、レポート・インタフェースのナビゲーション・ペインに期間セレクタが表示されます。

図5-5 期間セレクタ

レポートで期間を選択できるようにするには:

1. テキスト・エディタで、report_newbrowser.xmlファイル(第5.2.1.2項「手順2: XMLファイルのAnalyticsレポート・ディレクトリへの配置」に記載されているAnalyticsレポート・ディレクトリにあります)を開きます。

2. グローバル・パラメータ・セクションを見つけて、太字で示されている次のパラメータを追加します。

<param type="request" name="rgrpid" key="rgrpid" required="false" />
<param type="request" name="timepreset" key="timepreset" required="false">
<restriction type="listvalue">
<restrictionvalue value="yesterday" />
<restrictionvalue value="lastweek" />
<restrictionvalue value="lastmonth" />
<restrictionvalue value="last7days" />
<restrictionvalue value="last4weeks" />
<restrictionvalue value="last12months" />
</restriction>
</param>
<param type="request" name="siteid" key="siteid" required="true" />
<param type="request" name="sdate" key="sdate" required="true">
<restriction type="isDate" value="dd.MM.yyyy" />
</param>
<param type="request" name="edate" key="edate" required="true">
<restriction type="isDate" value="dd.MM.yyyy" />
</param>

新しいパラメータによって、レポートにアクセスすると、左側のナビゲーション・ペインに「期間」パネルが表示されます。

3. 表モジュールのデータ取得セクションで、次の太字のコードを、示されているとおりの位置に挿入します。

select
bro.id as broid,
bro.name as broname,
bro.iconpath as broiconpath,
nvl(count, 0) as count,
<equals name="browsertotal" value="0">
0 as percent
</equals>
<notEquals name="browsertotal" value="0">
(nvl(count, 0)/#browsertotal#)*100 as percent
</notEquals>
from
l2_browser bro
join (
select
bro2.id as broid,
bro2.name as broname,
sum(count) as count
from
help_dates dates
join l3_datexsitexnewbrowserxcount l3 on (dates.id = l3.dateid)
join l2_browser bro2 on (l3.browserid = bro2.id)
where<![CDATA[
siteid = #siteid# and
dates.dat >= to_date('#sdate#', 'DD-MM-YYYY') and
dates.dat  < to_date('#edate#', 'DD-MM-YYYY')+1 ]]>
group by
bro2.id, bro2.name
) on (bro.id = broid)

4. ファイルを保存して閉じます。

5. レポートをテストします。レポートは、図5-6のようになります。

図5-6 期間セレクタが表示されているNew Browsersレポート

6. 期間セレクタを選択します。

1. 「期間」バーをクリックして、期間セレクタのパネルを開きます。

2. 目的の開始日と終了日を選択します。

3. 「適用」をクリックします。

表に表示されるデータは、選択した期間によって異なります。このように表示されない場合やエラーが表示される場合は、手順を再度追って、コードにエラーがないかどうかを確認します。

7. 第5.3項「フィルタの追加」に進みます。

5.3 フィルタの追加

前の項でレポートに期間セレクタを追加したので、表示されるデータを特定の期間に制限できます。しかし、表示されるデータを時間ではなくパラメータで制限するには、どうしたらよいでしょうか。それには、データ・フィルタを追加します。

5.3.1 フィルタの動作

フィルタ・モジュールによって、レポートのサマリー・セクションに「フィルタ条件」フィールドが追加されて、ユーザーは次の操作を実行できるようになります。

- 特定のデータ・ポイントまたは値(たとえば、特定のブラウザ)を検索できます。

- 表示されるデータを、特定のパラメータ(記録されたセッション数など)の特定の範囲に制限できます。

NewBrowsersレポートに次のフィルタを追加します。

- ブラウザ名フィルタ。このフィルタによって、特定のブラウザを検索したり、表示されるデータを特定の範囲のブラウザ名に制限できます。

5.3.2 フィルタの追加方法

フィルタを実装するには、次の操作が必要です。

- フィルタを定義するフィルタ・モジュールを、レポート・コードに追加します。

- 表示モジュール(表モジュール、チャート・モジュールなど)のデータ取得セクションを変更して、問合せフィルタをサポートします。

レポートにフィルタを追加するには:

1. テキスト・エディタで、report_newbrowser.xmlファイル(第5.2.1.2項「手順2: XMLファイルのAnalyticsレポート・ディレクトリへの配置」に記載されているAnalyticsレポート・ディレクトリにあります)を開きます。

2. 次のモジュール・コードを、表モジュールの後、かつ、終了の</report>要素の前に追加します。

<filter name="filter-browsername" required="false" type="text" captions="name"   key="filter-browsername" />

前述のコードは、次のように分析されます。

注意:

この例に含まれるタグおよびそこで使用されるパラメータの詳細は、Oracle Fusion Middleware WebCenter Sites: Analyticsタグ・リファレンスを参照してください。

フィルタはfilterタグを使用して定義します。このタグでは、次のパラメータが使用されます。

- name (必須): フィルタのオブジェクト・ハンドルを指定します。このパラメータには、次の条件が適用されます。

- このパラメータの値は、filter-で開始する必要があります。これによって、Analyticsはこの定義をフィルタ定義として扱うことができます。

- 値は、次に説明するkeyパラメータの値と同じである必要があります。

注意:

いずれかの条件が満たされない場合、フィルタは機能しません。

- required (必須): レポートが機能するために、次に説明するkeyパラメータに値を割り当てる必要があるかどうかを指定します。この例では、requiredはfalseに設定されます。

- type (必須): フィルタのタイプと同時に、フィルタの入力方法(たとえば、レポート・インタフェースにおけるフィルタの表示方法)を指定します。

- この例では、textタイプのフィルタを使用しています。これによってフィルタはテキスト・フィールドとして出現し、ユーザーはここに1つ以上のフィルタ条件を入力できます。この他に、yesno、radio、dbselect、dateなどのタイプがあります。

- key (オプション、前述のrequiredを参照): ユーザーが「適用」をクリックしたときに、ユーザーが入力したフィルタ値を渡すために、レポート・ページのURL内のパラメータとして使用される名前を指定します。このパラメータには、次の条件が適用されます。

- このパラメータの値は、filter-で開始する必要があります。これによって、Analyticsはこの定義をフィルタ定義として扱うことができます。

- 値は、前述のnameパラメータの値と同じである必要があります。

注意:

2つの条件のいずれかが満たされない場合、フィルタは機能しません。

3. データ取得セクションで、次の太字のコードを、示されているとおりの位置に挿入します。

select
bro.id as broid,
bro.name as broname,
bro.iconpath as broiconpath,
nvl(count, 0) as count,
<equals name="browsertotal" value="0">
0 as percent
</equals>
<notEquals name="browsertotal" value="0">
(nvl(count, 0)/#browsertotal#)*100 as percent
</notEquals>
from
l2_browser bro
join (
select
bro2.id as broid,
bro2.name as broname,
sum(count) as count
from
help_dates dates
join l3_datexsitexnewbrowserxcount l3 on (dates.id = l3.dateid)
join l2_browser bro2 on (l3.browserid = bro2.id)
where<![CDATA[
siteid = #siteid# and
dates.dat >= to_date('#sdate#', 'DD-MM-YYYY') and
dates.dat  < to_date('#edate#', 'DD-MM-YYYY')+1 ]]>

<notNull name="filter-browsername">
and lower(bro2.name) like lower(replace('#filter-browsername#','*','%'))
</notNull>

group by
bro2.id, bro2.name
) on (bro.id = broid)

前述のコードは、次のように分析されます。

- 挿入されたコードにより、フィルタに提供された条件(たとえば、フィルタ値)に基づいてSQL問合せが返す結果が制限されます。

- 各<notNull>タグ内のコードは、<notNull>タグによってコールされるパラメータの値がnullでない場合のみ、問合せに追加されます。

4. レポート・ファイルを保存して閉じます。テキスト・エディタで、NewBrowserLocalization.propertiesファイル(この演習の場合、アプリケーション・サーバーのanalyticsアプリケーション・ディレクトリ内のWEB-INF/classesディレクトリにあります)を開きます。ファイルの末尾に次の行を追加します。

report_newbrowser_filter-browsername=Filter By Browser Name

5. レポートをテストします。図5-7のように、レポートの上部のサマリー・セクションに「フィルタ」フィールドが表示されます。

図5-7 「フィルタ」フィールドが表示されているNew Browsersレポート

レポートがこの図のように表示されない場合やエラーが表示される場合は、手順を再度追って、コードにエラーがないかどうかを確認します。

6. 第5.3.3項「チャートの追加」に進みます。

5.3.3 チャートの追加

この演習の最後の手順では、NewBrowsersレポートにチャートを追加します。チャートによって、レポート内で統計データを視覚的に表示できます。

レポートにチャートを追加するには、レポートのコードにチャート・モジュールを挿入します。チャート・モジュールの構成は、表モジュールの構成と似ています。次の2つのセクションがあります。

- データ取得セクション(手順5を参照)。このセクションには、円グラフに表示するデータをAnalyticsデータベースから取得するSQLコードが含まれています。

- 表示セクション(行6の<display>タグで囲まれた部分)。このセクションには、データ取得セクションのコードによってAnalyticsデータベースから取得されたデータを書式設定し、表示するコードが含まれています。表示セクションのコードによって、チャートのタイプが定義され、チャートの軸にデータが割り当てられます。

この例では、円グラフ(XYチャート、次の手順2を参照)を作成し、すべてのブラウザのセッション数をパーセンテージ形式で表示します。円グラフの各セクションにはブラウザ・データが表示され、チャートの右側には凡例セクションが表示されます。円グラフの各セクションにマウス・ポインタを置くと、ブラウザ名とともにセッション数のパーセンテージが表示されます。

レポートにチャートを追加するには

1. テキスト・エディタで、report_newbrowser.xmlファイル(第5.2.1.2項「手順2: XMLファイルのAnalyticsレポート・ディレクトリへの配置」に記載されているAnalyticsレポート・ディレクトリにあります)を開きます。

2. 次のモジュール宣言を、レポート・コードの先頭で、最後のグローバル・パラメータ定義の直後、かつ、表モジュールの前に追加します。これによって、レポートが生成されたときに、チャートが表の上に表示されます。

注意:

コード内でのモジュールの順番が、レポート・インタフェースに表示される順番になります。(フィルタ・モジュールは例外で、フィルタはレポート上部のサマリー・セクション内でその位置が固定されています。)

<module type="stdchart" name="chartbrowser">
<param type="request"
name="charttype"
key="chartbrowser_charttype"
default="pie_labeled">
<restriction type="listvalue">
<restrictionvalue value="pie_labeled" />
<restrictionvalue value=" bar_labeled " />
</restriction>
</param>

前述のコードは、次のように分析されます。

- stdchartタイプのモジュールで、これがチャート・モジュールとして定義されます。nameパラメータを使用して、モジュールにオブジェクト・ハンドルを割り当てます。この手順の後半では、レポートのローカライゼーション・プロパティ・ファイルに定義することによって、このハンドルを使用してチャート・モジュールにヘッダーを指定します。

- <param>タグは、チャートの目的のスタイルを定義します。typeパラメータのrequestおよびnameパラメータのcharttypeは、keyパラメータに値を割り当てることによってチャート・タイプを指定します。keyパラメータの値は、moduleName_chartstyleの構文に従う必要があります。この例では、chartbrowser_charttypeというチャート・タイプを使用しています。

注意:

使用可能なチャート・スタイルはSwiff Chart Generatorソフトウェアで定義されていて、Analyticsによって参照されます。Swiff Chart Generatorでは、面グラフ、棒グラフ、縦棒グラフ、折れ線グラフおよび円グラフがデフォルトでサポートされています。

- <restriction>タグは、必須パラメータの検証を有効にします。各<restrictionvalue>タグで定義されるパラメータ値のみが許可され、他のすべての値についてはエラー・メッセージが表示されます。

3. チャート・モジュールに次のパラメータを追加します。

<param type="string" name="chart_max_display" value="10"/>
<param type="string" name="chart_display_rest" value="true"/>

4. chart_max_displayパラメータは、円グラフに、人気の上位10ブラウザに対応する10種類の色分けされたセクションが表示されることを示しています。chart_display_restパラメータは、残りのブラウザ・セッション数が1つの円グラフ・セクションに表示されることを示しています。この2つのパラメータはオプションであり、このオプションの指定が省略されている場合は、デフォルト値でチャートのレンダリングが行われます。

5. チャート・モジュールにデータ取得セクションを追加します。次のコードを、前の手順で追加したチャート・モジュール宣言の後に挿入します。

select
bro.id as broid,
bro.name as broname,
nvl(count, 0) as count,
<equals name="browsertotal" value="0">
0 as percent
</equals>
<notEquals name="browsertotal" value="0">
(nvl(count, 0)/#browsertotal#)*100 as percent
</notEquals>
from
l2_browser bro
join (
select
bro2.id as broid,
bro2.name as broname,
sum(count) as count
from
help_dates dates
join l3_datexsitexnewbrowserxcount l3 on (dates.id = l3.dateid)
join l2_browser bro2 on (l3.browserid = bro2.id)
where<![CDATA[
siteid = #siteid# and
dates.dat >= to_date('#sdate#', 'DD-MM-YYYY') and
dates.dat < to_date('#edate#', 'DD-MM-YYYY')+1 ]]>
group by
bro2.id, bro2.name
) on (bro.id = broid)

前述のコードは、次のように分析されます。

SQL問合せによって、円グラフに表示されるデータが取得されます。チャート・モジュールのデータ取得問合せは、表モジュールの問合せと似ています。唯一の違いは、チャート・モジュールのデータ取得問合せにはフィルタ部分がないことです(たとえば、チャートのデータはフィルタ入力によるフィルタ処理を受けません。表データのみがフィルタ処理されます)。ただし、問合せに同じフィルタを追加して、チャート・データにフィルタを適用できます。

6. チャート・モジュールに表示セクション・コードを追加します。次のコードを、前の手順で追加したデータ取得セクションの後に挿入します。

<display type="html">
<value name="xaxis" type="string">
<valueparam name="format" parse="false"/>
<valueparam name="value" value="#broname#" />
</value>

<value name="yaxis" type="number">
<valueparam name="format" parse="false" value="#####0" />
<valueparam name="value" value="#count#" />
</value>
</display>

前述のコードは、次のように分析されます。

表示セクションでは、チャートの軸を定義し、適切なデータを各軸に割り当てます。

Analyticsでは、2つのカテゴリのチャートが区別されます。

- XYチャートは、円グラフのように軸のないチャートで、データ系列の凡例が不要です(そのため、Z軸宣言がありません)。

- XYZチャートには軸があり(折れ線グラフ、棒グラフ、面グラフ、縦棒グラフなど)、Z軸宣言で定義されるデータ系列の凡例が必要です。

この例で定義しているのは円グラフです。これはXYチャートであり、Z軸はありません。しかし、異なるカテゴリ/データ・ポイント(この演習ではブラウザ名)をX軸(value name="xaxis")に割り当て、各カテゴリの値(ここではセッション数)をY軸(value name="yaxis")に割り当てています。

7. ファイルを保存して閉じます。

8. チャートのヘッダーを指定します。手順は次のとおりです。

1. テキスト・エディタで、NewBrowserLocalization.propertiesファイル(この例の場合、アプリケーション・サーバーのanalyticsアプリケーション・ディレクトリ内のWEB-INF/classesディレクトリにあります)を開きます。

2. ファイルの末尾に次の文を追加します。

# Chart Module
report_newbrowser_module_chartvisitordetail=Browsers Chart

3. ファイルを保存して閉じます。

4. アプリケーション・サーバーを再起動して変更を反映します。

9. これで、レポートの作成は完了です。この演習の最後の手順である第5.3.4項「完成したNewBrowsersレポートのテスト」に進み、完成したレポートをテストしてコードを確認します。

5.3.4 完成したNewBrowsersレポートのテスト

お疲れ様でした。初めてのAnalyticsレポートができあがりました。レポートをテストして、コードにエラーがないことを確認します。

1. Analyticsレポート・インタフェースにログインし、NewBrowsersレポートを生成します。
レポートは、図5-8のようになります。

図5-8 完成したNew Browsersレポート

2. レポートがこの図のように表示されない場合やエラーが表示される場合は、手順を再度追って、第5.1.1項「NewBrowsersレポート・コード」のサンプル・コードと比較してコードにエラーがないかどうかを確認します。

第II部

リファレンス

この部では、様々なタイプの公開済WebCenter Sitesアセットに関するデータ・キャプチャを有効化する方法について説明します。この部では、サイト訪問者に関する統計情報が格納されるデータベース表のスキーマの概要も説明します。

この部の構成は、次のとおりです。

- 第6章「様々なタイプのレポートのデータ・キャプチャの有効化」

- 第7章「WebCenter Sites: Analyticsのデータベース・スキーマ」

6 様々なタイプのレポートのデータ・キャプチャの有効化

この章では、Webサイト訪問者、およびOracle WebCenter Sitesで公開されているページの使用に関するデータ・キャプチャを有効化する方法について説明します。この章では、AddAnalyticsImgTagおよび関連するコードを実装して、データ・キャプチャを有効化します。キャプチャされたデータが統計的に処理されると、その結果は、一般情報レポート、コンテンツ情報レポート、ユーザー情報レポート、Engageレポートなど、様々なAnalyticsレポートで使用できます。

この章の内容は、次のとおりです。

- 第6.1項「データ・キャプチャの有効化」

- 第6.2項「Analyticsインストールのテスト」

6.1 データ・キャプチャの有効化

注意:

この項の手順を実行するには、WebCenter Sitesの要素、JavaおよびJSPに関する実用的な知識が必要です。Engageアセットのデータ・キャプチャの有効化を予定している場合は、推奨およびセグメントについても十分に理解ている必要があります。

この章の手順を開始する前に、WebCenter Sites管理者が、AnalyticsとWebCenter Sitesの統合を完了していることを確認してください(『Oracle Fusion Middleware WebCenter Sites: Analytics管理者ガイド』を参照)。

AnalyticsがWebCenter Sitesアセットの使用、訪問者および訪問者の検索についてデータをキャプチャできるのは、公開されているページにデータ・キャプチャのタグが付いている場合のみです。Engageアセットおよび内部検索の場合は、アセット自体にデータ・キャプチャのタグが付いている必要があります。

ここでは、各種レポートのデータ・キャプチャを有効化する方法について説明します。

- 第6.1.1項「一般情報レポート、コンテンツ情報レポートおよびユーザー情報レポートのデータ・キャプチャの有効化」

- 第6.1.2項「内部検索レポートのデータ・キャプチャの有効化」

- 第6.1.3項「Engageレポートのデータ・キャプチャの有効化」

手順を実行すると、すべてのレポート・グループのすべてのレポートでデータ・キャプチャが有効になります。

6.1.1 一般情報レポート、コンテンツ情報レポートおよびユーザー情報レポートのデータ・キャプチャの有効化

ここでは、内部検索およびエンゲージ以外のすべてのレポート・グループのデータ・キャプチャを有効化します。

一般情報レポート、コンテンツ情報レポートおよびユーザー情報レポートのデータ・キャプチャを有効にするには:

アセットが表示されるページにタグを付けます。次のコードを使用します。

<%-- Analytics Image tag
Data capture code for asset uses and user information
--%>
<ics:if condition='<%="true".equalsIgnoreCase(ics.GetProperty("analytics.enabled", "futuretense_xcel.ini", true))%>'>
<ics:then>

<ics:if condition='<%=ics.GetVar("packedargs") != null%>'>

<ics:then>
<render:unpackarg unpack="recid" remove="true"
packed='<%=ics.GetVar("packedargs")%>' outvar="packedargs"/>

</ics:then>

</ics:if>
<render:callelement elementname="Analytics/AddAnalyticsImgTag">
<render:argument name="c" value='<%=ics.GetVar("c")%>'/>
<render:argument name="cid" value='<%=ics.GetVar("cid")%>'/>
<render:argument name="site" value='<%=ics.GetVar("site")%>'/>
<render:argument name="pagename" value='<%=ics.GetVar("childpagename")%>'/>
<render:argument name="recid"
value='<%=ics.GetVar("recid")%>'/>
</render:callelement>
</ics:then>
</ics:if>

パラメータ

- c:
アクセスされるアセットのタイプ

- cid:
指定のタイプのアセットのID

- site:
ページをホストしているコンテンツ管理サイトの名前

- pagename:
アクセスされるページの名前

- pageurl:
アクセスされるページのURL

注意:

- アセット・タイプが登録済であるアセットを表示するページに、タグを付ける必要があります。ページにタグが付いていない場合は、空のレポートが生成されます。登録手順の詳細は、『Oracle Fusion Middleware WebCenter Sites: Analytics管理者ガイド』のアセット・レポートの構成に関する項を参照してください。

- FirstSite IIサンプル・サイトを使用している場合は、他のすべてのページによってコールされるラッパー・ページが使用されていることに注意してください。この項のデータ・キャプチャ・コードは、ラッパー要素(たとえば、ElementCatalog/FSIIWrapper)に追加します。ラッパー・ページを使用する他のサイトでも、同じようにします。ラッパー・ページを使用していないサイトの場合は、c、cid、siteおよびpagenameの各パラメータが、ページからデータ・キャプチャ・コードに適切に渡されることを確認します。

- サイトの開始/終了ページ・レポート(セッションの最初と最後のページを識別)の生成を有効化するには、そのサイトのすべてのページをコーディングするか、他のすべてのページによってコールされるラッパー・ページをコーディングします。

ページ・リクエストのたびに、AnalyticsではFatWire/Analytics/AddAnalyticsImgTagがsensorサーブレットを呼び出して、ページを参照している訪問者に関するデータをキャプチャします。このデータには、訪問者の地理的な場所、IPアドレス、参照テクノロジおよびセッション・パラメータが含まれます。残りのコードで、同じページに表示されるWebCenter Sitesアセットに関する使用情報がキャプチャされます。キャプチャされたデータは、後で統計的に処理されます。統計情報は、一般情報レポート、コンテンツ情報レポートおよびユーザー情報レポートで使用されます。

6.1.2 内部検索レポートのデータ・キャプチャの有効化

内部検索レポートのデータ・キャプチャを有効化するには、検索データをキャプチャする必要があるすべてのページでHTML imgタグをコールします。次のパラメータを渡します。

<img
style="display:none;"
height="1"
width="1"
border="0"
src="<%=statisticsUrl%>
?siteName=<%= ics.GetVar("site")%>
&objType=SEARCH
&query=<SQL_query>
&objID=1
&directhits=<number_of_results>
&maxscore=<relevance_score>
&sessionID=<%=sessionId%>"
alt="pixel"
/>

パラメータ

- src
Analyticsのデータ・キャプチャ・サーブレットのURL。URLは、futuretense.ini内のanalytics.datacaptureurlプロパティで構成されます。次のように、URLを取得します。

<property:get param="analytics.datacaptureurl" inifile="futuretense.ini" varname="datacaptureurl"/>
<% String statisticsUrl=
ics.GetVar("datacaptureurl");%>

- siteName
問合せが入力されるコンテンツ管理サイトの名前。

- objType
内部SQL問合せのオブジェクト名。値はSEARCHである必要があります。

- query
検索フィールドに入力される問合せ。

- objID
ランダム値("1"の値を渡します)。

- directhits
検索問合せで返される結果の数。

- maxscore
(オプション) 最も関連性の高い結果の関連性スコア。

たとえば、88.0という結果は、入力されたキーワードに対して88%の関連性を持つことを表します。

- sessionID
ブラウザ・セッションID。

例:

次の例は、変数が置換された後のimgタグの状態を示しています。

<img
style="display:none;"
height="1"
width="1"
border="0"
src="http://10.120.12.68:7001/analytics/statistics
?siteName=FirstSiteII
&objType=SEARCH
&query=Select * from Activities
&objID=1
&directhits=10
&maxscore=88.0
&sessionID=5E7B9B22F84F0FAB0E68108089AA1609"
alt="pixel"
/>

ページにEngageアセットが含まれていて、データ・キャプチャを有効化するには、第6.1.3項「Engageレポートのデータ・キャプチャの有効化」に進みます。それ以外の場合は、Analyticsの構成はこれで完了です。第6.2項「Analyticsインストールのテスト」の手順に従って、システムをテストします。

6.1.3 Engageレポートのデータ・キャプチャの有効化

Engageアセットには、推奨、推奨アセット(推奨で通知)および推奨が行われるセグメントが含まれます。この項の手順を開始する前に、図6-1の手順を参照して、一般的なフローを把握します。同じ図に、Engageアセットと、対応するRecAskedオブジェクトおよびRecListedオブジェクトの例が示されています。

注意:

セグメントのデータ・キャプチャは、データ・キャプチャを有効化するimgタグ内のsegIDパラメータを介して暗黙的に指定されます。

図6-1 Engageアセットの定義

注意:

次の手順を実行するには、JavaとJSPの経験に加えて、推奨とセグメントについて十分に理解している必要があります。

Engageアセットのデータ・キャプチャを有効化するには:

1. 各推奨のデータ・キャプチャを有効化します(推奨の例については、図6-1を参照)。

1. 推奨の要素に、次の行を追加します。

<%@ taglib prefix="property" uri="futuretense_cs/property.tld"%>
<%@ page import="java.util.*, java.text.*, java.io.*"%>
<%@ page import="at.onetoone.esa.tools.*"%>

注意:

at.onetoone.esa.toolsファイルはanalyticscs.jarにあります。

2. 推奨の要素に、次のHTML imgタグを挿入します。imgタグは、ページが訪問者に表示されると同時に、推奨のIDと名前をキャプチャします。

注意:

FirstSite IIサンプル・サイトを使用している場合は、ElementCatalog/AdvCols/FSIIDetailにimgタグを追加します。

<script type="text/javascript">

pixelreccalled = new Image();
pixelreccalled.src = "<%=statisticsUrl%>?siteName
=<%= ics.GetVar("site")%>
&objType=RecAsked&objID=<%=ics.GetVar("cid")%>
&objName=<%=ics.GetVar("reconame")%>

&segID=<%=segmentidlist%>

&sessionID=<%=sessionId%>

&Referer=<%= referer %>

&size=<%=screenResolution%>";
</script>
<noscript>
<img style="display:none;"
height="1"
width="1"
src="<%=statisticsUrl%>?siteName=<%= ics.GetVar("site")%>
&objType=RecAsked
&objID=<%=ics.GetVar("cid")%>
&objName=<%=ics.GetVar("reconame")%>
&segID=<%=segmentidlist%>
&sessionID=<%=sessionId%>
&Referer=<%= referer %>
&size=<%=screenResolution%>
alt="pixel" />
</noscript>

パラメータ

- src
Analyticsのデータ・キャプチャ・サーブレットのURL。URLは、futuretense.ini内のanalytics:datacaptureurlプロパティで構成されます。次のように、URLを取得します。

<property:get param="analytics.datacaptureurl" inifile="futuretense.ini" varname="datacaptureurl"/>

<% String statisticsUrl=
ics.GetVar("datacaptureurl");%>

- siteName
推奨が表示されるコンテンツ管理サイトの名前。

- objType
表示される推奨のオブジェクト名。値はRecAskedである必要があります。(推奨の例は、図6-1の最初の手順を参照してください。)objTypeを使用して、Engageアセット(推奨およびセグメント)の識別、アセットに関するデータのキャプチャ、およびエンゲージ・レポート・グループでのレポートの作成が行われます。

- objID
推奨のアセットID。

- objName
推奨の名前。

- segID
訪問者が属するセグメントのIDのカンマ区切りリスト、または訪問者がセグメントに属さない場合は0。

- sessionID
ブラウザ・セッションID。

- size
ブラウザ画面解像度。

例

次の例は、変数が置換された後のimgタグの状態を示しています。

<img
style="display:none;"
height="1"
width="1"
src="http://etravel.fatwire.com:80/analytics/statistics
?siteName =FirstSiteII
&objType=RecAsked&objID=1120593564193
&objName=FSIIItemOfTheWeek
&segID=0
&sessionID=B28822803C3843B8CC
&size=1280x1024"
alt="pixel"/>

2. 推奨の各推奨アセット・リストのデータ・キャプチャを有効化します(このようなリストの例は、図6-1を参照)。

この手順では、最初に3つのパラメータをエンコードしてから、前述の手順と同じ推奨要素にHTML imgタグを挿入する必要があります。ただし、渡すパラメータは、推奨アセット・リストに固有です。手順は次のとおりです。

1. 3つのパラメータ(objListName、objListID、objListType)を、analyticscs.jarにあるBase64ファイルを使用して、次のようにエンコードします。

String objListNameValue = Base64.encodeBytes(<comma-separated list of asset names in the recommendation>.getBytes(), Base64.DONT_BREAK_LINES);
String objListIDValue = Base64.encodeBytes(<comma-separated list of asset IDs in the recommendation>.getBytes(), Base64.DONT_BREAK_LINES);
String objListTypeValue = Base64.encodeBytes(<comma-separated list of asset types in the recommendation>.getBytes(), Base64.DONT_BREAK_LINES);

2. 次のパラメータを指定して、HTML imgタグをJSPに挿入します。

注意:

FirstSite IIサンプル・サイトを使用している場合は、ElementCatalog/AdvCols/FSIIDetailにimgタグを追加します。

サンプル・コードは、FSIIDetail.jsp (FatWire Analytics\examples\FirstSiteII\ElementCatalog/AdvColsディレクトリ内)を参照してください。

<script type="text/javascript">

imagereclisted = new Image();

imagereclisted.src = "<%=statisticsUrl%>?siteName=<%
= ics.GetVar("site")%>
&objType=RecListed
&objID=<%=ics.GetVar("cid")%>
&objName=<%=ics.GetVar("reconame")%>
&objListID=<%=objListIDValue%>
&objListName=<%=objListNameValue%>
&objListType=<%=objListTypeValue%>
&segID=<%=segmentidlist%>
&sessionID=<%=sessionId%>
&size=<%=screenResolution%>";
</script>
<noscript>

<img style="display:none;"
height="1"
width="1"
src="<%=statisticsUrl%>
?siteName=<%= ics.GetVar("site")%>
&objType=RecListed
&objID=<%=ics.GetVar("cid")%>
&objName=<%=ics.GetVar("reconame")%>
&objListID=<%=objListIDValue%>
&objListName=<%=objListNameValue%>
&objListType=<%=objListTypeValue%>
&segID=<%=segmentidlist%>
&sessionID=<%=sessionId%>
&size=<%=screenResolution%>"
alt="pixel"
/>

</noscript>

パラメータ

- src
Analyticsのデータ・キャプチャ・サーブレットのURL。URLは、futuretense.ini内のanalytics.datacaptureurlプロパティで構成されます。次のように、URLを取得します。

<property:get param="analytics.datacaptureurl" inifile="futuretense.ini" varname="datacaptureurl"/>

<% String statisticsUrl=
ics.GetVar("datacaptureurl");%>

- siteName
推奨がリストされるコンテンツ管理サイトの名前。

- objType
推奨アセット・リストのオブジェクト名。値はRecListedである必要があります。(推奨アセット・リストの例は、図6-1の2番目の手順を参照してください。)objTypeを使用して、Engageアセット(推奨およびセグメント)の識別、アセットに関するデータのキャプチャ、およびエンゲージ・レポート・グループでのレポートの作成が行われます。

- objID
推奨のアセットID。

- objName
推奨の名前。

- objListName
推奨内のアセット名のカンマ区切りリスト。このパラメータの値は、前の手順でエンコードされた値です。

- objListType
推奨内のアセット・タイプのカンマ区切りリスト。このパラメータの値は、前の手順でエンコードされた値です。

- segID
訪問者が属するセグメントのIDのカンマ区切りリスト、または訪問者がセグメントに属さない場合は0。

- sessionID
ブラウザ・セッションID。

- size
ブラウザ画面解像度。

例:

次の例は、変数が置換された後のimgタグの状態を示しています。

<img
style="display:none;"
height="1"
width="1"
src="http://etravel.fatwire.com:80/analytics/statistics
?siteName=FirstSiteII
&objType=RecListed
&objID=1120593564193
&objName=FSIIItemOfTheWeek
&objListID=MTEzODY2MDI1NjExMQ===
&objListName=Q2hvY29ob2xpYyBXZWVrZW5k=
&objListType=UHJvZHVjdF9D=
&segID=0&sessionID=B28822803C3843B8CC496743D5B132B0
&size=1280x1024"
alt="pixel"
/>

3. 推奨アセット・リストを形成するリンクを生成する要素に、recidパラメータを追加します(各リンクは、推奨から推奨アセットを指します)。また、要素のSiteCatalogエントリのpagecriteria変数にもrecidパラメータを追加します。

注意:

recidは、アセットが属する推奨のIDです。サンプル・コードは、Product_C (FatWire Analytics\examples\FirstSiteII\ElementCatalog\Product_C内)のFSIISummary.jspを参照してください。

3. 各推奨アセットのデータ・キャプチャを有効化します(推奨アセットの例は、図6-1を参照)。

1. 第6.1.1項「一般情報レポート、コンテンツ情報レポートおよびユーザー情報レポートのデータ・キャプチャの有効化」のデータ・キャプチャ・コードが推奨アセットのJSPにない場合は、コードを追加します。

注意:

Engageアセットが表示されるページで、WebCenter Sitesアセットのデータ・キャプチャのコーディングがすでに行われている場合は、データ・キャプチャ・コードが存在します。

2. recidパラメータをデータキャプチャ要素FatWire/Analytics/AddAnalyticsImgTagに渡します。これには、第6.1.1項「一般情報レポート、コンテンツ情報レポートおよびユーザー情報レポートのデータ・キャプチャの有効化」のデータ・キャプチャ・コードに、次の行を挿入します。

<render:argument name="recid" value='<%=ics.GetVar
("recid")%>'/

これによって、Analyticsは選択されたEngageアセットを記録できます。

4. これで、各推奨、その推奨アセットのリストおよび個々の推奨アセットのデータ・キャプチャが有効化されました。imgタグ内のsegIDパラメータを介して、セグメントのデータ・キャプチャも暗黙的に有効化されました。
次の手順に進み、インストールをテストします。

6.2 Analyticsインストールのテスト

Analyticsインストールのテストを自分自身で行うことによって、またはWebCenter Sites管理者や他のユーザーの支援を受けて行うことにより、コードをテストできます。

Analyticsインストールをテストするには:

1. Webサイトに移動し、データ・キャプチャのタグを付けたページにアクセスします。

2. データ分析ジョブにキャプチャ・データの処理を終了させます。

注意:

データ分析ジョブでは、過去24時間にキャプチャされたデータを処理します。データ分析ジョブは、キャプチャされたRAWデータの量によっては完了までに長時間を要する、リソースを集中的に使用するプロセスであることに留意してください。

3. ユーザーが生成しているすべてのレポートを生成します。レポートおよびその生成手順の詳細は、『Oracle Fusion Middleware WebCenter Sites: Analyticsユーザーズ・ガイド』を参照してください。

適切な結果が得られた場合、Analyticsを使用する準備が整ったことになります。

7 WebCenter Sites: Analyticsのデータベース・スキーマ

この付録の構成は、次のとおりです。

- 第7.1項「L3表」

- 第7.2項「HELP表」

- 第7.3項「システムの構成およびメンテナンスの表」

- 第7.4項「データベースの索引」

7.1 L3表

レベル3データベース表には、統計処理された集計データが格納されます。事前に集計されると、レポート生成時にオンデマンドでデータを使用できるようになります。

表名は、格納されるデータのタイプを表します。次に例を示します。

- L3_DATEXSITEXCITYXCOUNTという表には、特定の市区町村の訪問者が参照するサイトの日次データが格納されます。

- L3_WEEKXSITEXCITYXCOUNTという表には、L3_DATEXSITEXCITYXCOUNTと同じタイプのデータが特定の週について格納されます(つまり、L3_WEEKXSITEXCITYXCOUNTには、特定の市区町村の訪問者が参照するサイトの週次データが格納されます)。

- L3_MONTHXSITEXCITYXCOUNTという表には、L3_DATEXSITEXCITYXCOUNTと同じタイプのデータが特定の月について格納されます(つまり、L3_MONTHXSITEXCITYXCOUNTには、特定の市区町村の訪問者が参照するサイトの月次データが格納されます)。

注意:

このリファレンスでは、オブジェクト・インプレッションという用語が使用されます。オブジェクト・インプレッションとは、sensorサーブレットの単一の呼出しです。オブジェクト・インプレッションは、分析用にキャプチャされる生のサイト訪問者データのスナップショットと見なすこともできます。オブジェクト・インプレッションの詳細は、『Oracle Fusion Middleware WebCenter Sites: Analytics管理者ガイド』を参照してください。

- 第7.1.1項「CS_L3DATEXSITEXOBJXCOUNT」

- 第7.1.2項「L3_DATEXSITEXCITYXCOUNT」

- 第7.1.3項「L3_WEEKXSITEXCITYXCOUNT」

- 第7.1.4項「L3_MONTHXSITEXCITYXCOUNT」

- 第7.1.5項「L3_DATEXSITEXDLXMIMEXCOUNT」

- 第7.1.6項「,L3_DATEXSITEXGROUPXOICOUNT」

- 第7.1.7項「L3_DATEXSITEXGROUPXSESCOUNT」

- 第7.1.8項「L3_DATEXSITEXGROUPXVISCOUNT」

- 第7.1.9項「L3_WEEKXSITEXGROUPXVISCOUNT」

- 第7.1.10項「L3_MONTHXSITEXGROUPXVISCOUNT」

- 第7.1.11項「L3_DATEXSITEXREGIONXCOUNT」

- 第7.1.12項「L3_WEEKXSITEXREGIONXCOUNT」

- 第7.1.13項「L3_MONTHXSITEXREGIONXCOUNT」

- 第7.1.14項「L3_DATEXSITEXJS」

- 第7.1.15項「L3_DATEXSITEXOBJECTXDURATION」

- 第7.1.16項「L3_DATEXSITEXBROWSERXCOUNT」

- 第7.1.17項「L3_DATEXSITEXCOUNTRYXCOUNT」

- 第7.1.18項「L3_WEEKXSITEXCOUNTRYXCOUNT」

- 第7.1.19項「L3_MONTHXSITEXCOUNTRYXCOUNT」

- 第7.1.20項「L3_DATEXSITEXENTRYIDXCOUNT」

- 第7.1.21項「L3_DATEXSITEXEXITIDXCOUNT」

- 第7.1.22項「L3_DATEXSITEXHOSTNAMEXCOUNT」

- 第7.1.23項「L3_DATEXSITEXINTERNALSEARCH」

- 第7.1.24項「L3_DATEXSITEXIPXCOUNT」

- 第7.1.25項「L3_DATEXSITEXISPXCOUNT」

- 第7.1.26項「L3_WEEKXSITEXISPXCOUNT」

- 第7.1.27項「L3_MONTHXSITEXISPXCOUNT」

- 第7.1.28項「L3_DATEXSITEXOBJECTTYPEXCOUNT」

- 第7.1.29項「L3_DATEXSITEXOBJECTXCOUNT」

- 第7.1.30項「L3_AUDIT_TRAIL」

- 第7.1.31項「L3_DATEXSITEXOPTYPEXCOUNT」

- 第7.1.32項「L3_WEEKXSITEXOPTYPEXCOUNT」

- 第7.1.33項「L3_MONTHXSITEXOPTYPEXCOUNT」

- 第7.1.34項「L3_DATEXSITEXOSXCOUNT」

- 第7.1.35項「L3_DATEXSITEXREFERERXCOUNT」

- 第7.1.36項「L3_DATEXSITEXSCREENRESXCOUNT」

- 第7.1.37項「L3_DATEXSITEXSESSION」

- 第7.1.38項「L3_DATEXSITEXSESSIONXQUANTIL」

- 第7.1.39項「L3_DATEXSITEXSEXKEYWORDXCOUNT」

- 第7.1.40項「L3_DATEXSITEXVISITORXCOUNT」

- 第7.1.41項「L3_WEEKXSITEXVISITORXCOUNT」

- 第7.1.42項「L3_MONTHXSITEXVISITORXCOUNT」

- 第7.1.43項「REC_L3_RECXCOUNT」

- 第7.1.44項「REC_L3_RECXSEGXCOUNT」

- 第7.1.45項「REC_L3_RECXSEGXOBJXCOUNT」

7.1.1 CS_L3DATEXSITEXOBJXCOUNT

この表には、クリックストリーム・レポート内のチャートのデータが格納されます。ここには、特定の日に行われた、あるオブジェクトから別のオブジェクトへのクリック数が格納されます。

列名

データ型

説明

DATEID

NUMBER

データの日付を参照するHELP_DATES表に対する外部キー。

SITEID

NUMBER

SITE表に対する外部キー。

OBJECTFROMID

NUMBER

移動元オブジェクト。

OBJECTTOID

NUMBER

移動先オブジェクト。

COUNT

NUMBER

クリック数。

7.1.2 L3_DATEXSITEXCITYXCOUNT

内部使用に予約されています。この表には、特定の日における特定の市区町村からのオブジェクト・インプレッション、セッションおよび訪問者の数が格納されます。詳細は、第7.2.1項「HELP_CITY」を参照してください。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

CITYID

NUMBER

HELP_CITY表に対する外部キー。

OICOUNT

NUMBER

該当の日、サイトおよび市区町村のオブジェクト・インプレッション数。

VISCOUNT

NUMBER

該当の日、サイトおよび市区町村の訪問者数。

SESCOUNT

NUMBER

該当の日、サイトおよび市区町村のセッション数。

7.1.3 L3_WEEKXSITEXCITYXCOUNT

内部使用に予約されています。この表には、特定の週における特定の市区町村からのオブジェクト・インプレッション、セッションおよび訪問者の数が格納されます。詳細は、第7.2.1項「HELP_CITY」を参照してください。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

CITYID

NUMBER

HELP_CITY表に対する外部キー。

OICOUNT

NUMBER

該当の週、サイトおよび市区町村のオブジェクト・インプレッション数。

VISCOUNT

NUMBER

該当の週、サイトおよび市区町村の訪問者数。

SESCOUNT

NUMBER

該当の週、サイトおよび市区町村のセッション数。

7.1.4 L3_MONTHXSITEXCITYXCOUNT

内部使用に予約されています。この表には、特定の月における特定の市区町村からのオブジェクト・インプレッション、セッションおよび訪問者の数が格納されます。詳細は、HELP_CITY表を参照してください。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

CITYID

NUMBER

HELP_CITY表に対する外部キー。

OICOUNT

NUMBER

該当の月、サイトおよび市区町村のオブジェクト・インプレッション数。

VISCOUNT

NUMBER

該当の月、サイトおよび市区町村の訪問者数。

SESCOUNT

NUMBER

該当の月、サイトおよび市区町村のセッション数。

7.1.5 L3_DATEXSITEXDLXMIMEXCOUNT

この表には、特定のオブジェクトおよびそのMIMEタイプのオブジェクト・インプレッション数が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

OBJECTID

NUMBER (12)

L2_OBJECT表に対する外部キー。

MIMETYPE

VARCHAR2 (32バイト)

MIMEタイプ。

COUNT

NUMBER

該当の日、サイトおよびMIMEタイプのオブジェクトのオブジェクト・インプレッション数。

7.1.6 L3_DATEXSITEXGROUPXOICOUNT

この表には、グループへのアクセス頻度(オブジェクト・インプレッション数)が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

GROUPID

NUMBER

L2_GROUP表に対する外部キー。

COUNT

NUMBER

オブジェクト・インプレッション数。

7.1.7 L3_DATEXSITEXGROUPXSESCOUNT

この表には、グループへのアクセス頻度(セッション数)が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

GROUPID

NUMBER

L2_GROUP表に対する外部キー。

SESCOUNT

NUMBER

セッション数。

7.1.8 L3_DATEXSITEXGROUPXVISCOUNT

この表には、グループが受信する訪問者数が日単位で格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

GROUPID

NUMBER

L2_GROUP表に対する外部キー。

VISCOUNT

NUMBER

訪問者数。

7.1.9 L3_WEEKXSITEXGROUPXVISCOUNT

この表には、グループが受信する訪問者数が週単位で格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

GROUPID

NUMBER

L2_GROUP表に対する外部キー。

VISCOUNT

NUMBER

訪問者数。

7.1.10 L3_MONTHXSITEXGROUPXVISCOUNT

この表には、グループが受信する訪問者数が月単位で格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

GROUPID

NUMBER

L2_GROUP表に対する外部キー。

VISCOUNT

NUMBER

訪問者数。

7.1.11 L3_DATEXSITEXREGIONXCOUNT

内部使用に予約されています。この表には、各リージョンで日単位で発生するオブジェクト・インプレッション、セッションおよび訪問者の数が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

REGIONID

NUMBER

HELP_REGION表に対する外部キー。

OICOUNT

NUMBER

該当の日、サイトおよびリージョンからのオブジェクト・インプレッション数。

VISCOUNT

NUMBER

該当の日、サイトおよびリージョンからの訪問者数。

SESCOUNT

NUMBER

該当の日、サイトおよびリージョンからのセッション数。

7.1.12 L3_WEEKXSITEXREGIONXCOUNT

内部使用に予約されています。この表には、各リージョンで週単位で発生するオブジェクト・インプレッション、セッションおよび訪問者の数が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

REGIONID

NUMBER

HELP_REGION表に対する外部キー。

OICOUNT

NUMBER

該当の週、サイトおよびリージョンからのオブジェクト・インプレッション数。

VISCOUNT

NUMBER

該当の週、サイトおよびリージョンからの訪問者数。

SESCOUNT

NUMBER

該当の週、サイトおよびリージョンからのセッション数。

7.1.13 L3_MONTHXSITEXREGIONXCOUNT

内部使用に予約されています。この表には、各リージョンで月単位で発生するオブジェクト・インプレッション、セッションおよび訪問者の数が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

REGIONID

NUMBER

HELP_REGION表に対する外部キー。

OICOUNT

NUMBER

該当の月、サイトおよびリージョンからのオブジェクト・インプレッション数。

VISCOUNT

NUMBER

該当の月、サイトおよびリージョンからの訪問者数。

SESCOUNT

NUMBER

該当の月、サイトおよびリージョンからのセッション数。

7.1.14 L3_DATEXSITEXJS

この表には、JavaScriptを使用するクライアント数が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

VALUE

NUMBER

trueまたはfalseが格納されます。

COUNT

NUMBER

該当のVALUEのオブジェクト・インプレッション数。

7.1.15 L3_DATEXSITEXOBJECTXDURATION

この表には、ユーザーがオブジェクトを表示する時間の長さが格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

OBJECTID

NUMBER (12)

L2_OBJECT表に対する外部キー。

DURATION

NUMBER

ユーザーが別のページをコールするまでの秒数。

COUNT

NUMBER

期間の計算の基準となるデータ行数。

7.1.16 L3_DATEXSITEXBROWSERXCOUNT

この表には、あるタイプのブラウザが完了したセッション数が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

BROWSERID

NUMBER (12)

L2_BROWSER表に対する外部キー。

COUNT

NUMBER

ブラウザが完了したセッション数。

7.1.17 L3_DATEXSITEXCOUNTRYXCOUNT

この表には、特定の日付の各国の集計データが格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

COUNTRYID

NUMBER (12)

HELP_COUNTRY表に対する外部キー。

COUNT

NUMBER

該当の日付のこのサイトのセッション数。

OICOUNT

NUMBER

該当の日付のこのサイトのオブジェクト・インプレッション数。

VISCOUNT

NUMBER

該当の日付のこのサイトの訪問者数。

7.1.18 L3_WEEKXSITEXCOUNTRYXCOUNT

この表には、特定の週の各国の集計データが格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

COUNTRYID

NUMBER (12)

HELP_COUNTRY表に対する外部キー。

COUNT

NUMBER

該当の週のこのサイトのセッション数。

OICOUNT

NUMBER

該当の週のこのサイトのオブジェクト・インプレッション数。

VISCOUNT

NUMBER

該当の週のこのサイトの訪問者数。

7.1.19 L3_MONTHXSITEXCOUNTRYXCOUNT

この表には、特定の月の各国の集計データが格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

COUNTRYID

NUMBER (12)

HELP_COUNTRY表に対する外部キー。

COUNT

NUMBER

該当の日付のこのサイトのセッション数。

OICOUNT

NUMBER

該当の日付のこのサイトのオブジェクト・インプレッション数。

VISCOUNT

NUMBER

該当の日付のこのサイトの訪問者数。

7.1.20 L3_DATEXSITEXENTRYIDXCOUNT

この表には、特定の日付の開始ページ・データが格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

OBJECTID

NUMBER

L2_OBJECT表に対する外部キー。

COUNT

NUMBER

このオブジェクトが開始ページとして使用された頻度。

7.1.21 L3_DATEXSITEXEXITIDXCOUNT

この表には、特定の日付の終了ページ・データが格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

OBJECTID

NUMBER

L2_OBJECT表に対する外部キー。

COUNT

NUMBER

このオブジェクトが終了ページとして使用された頻度。

7.1.22 L3_DATEXSITEXHOSTNAMEXCOUNT

この表には、特定の日付の特定のホスト名のセッション数が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

HOSTNAME

VARCHAR2 (64 BYTE)

ホストの名前。

COUNT

NUMBER

該当のホストのセッション数。

7.1.23 L3_DATEXSITEXINTERNALSEARCH

この表には、特定の日付の内部検索の集計データが格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

QUERY

VARCHAR2 (2049 BYTE)

検索された問合せ文字列。

COUNT

NUMBER

問合せが検索された頻度。

AVGHITS

NUMBER

検索結果の平均数。

MAXHITS

NUMBER

検索結果の最大数。

MINHITS

NUMBER

検索結果の最小数。

AVGMAXSCORE

NUMBER

平均最大スコア。

MINSCORE

NUMBER

最小スコア。

MAXSCORE NUMBER

NUMBER

最大スコア。

OBJECTTYPEID

NUMBER

問合せのL2_OBJECTTYPE表に対する外部キー。

7.1.24 L3_DATEXSITEXIPXCOUNT

この表には、特定のIPアドレスおよび日付のセッション数が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

IP

VARCHAR2 (15 BYTE)

IPアドレス。

COUNT

NUMBER

該当の日、サイトおよびIPアドレスのセッション数。

7.1.25 L3_DATEXSITEXISPXCOUNT

この表には、各ISPの日単位のオブジェクト・インプレッション、セッションおよび訪問者の数が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER(6)

SITE表に対する外部キー。

ISPID

NUMBER

HELP_ISP表に対する外部キー。

OICOUNT

NUMBER

該当の日、サイトおよびISPのオブジェクト・インプレッション数。

VISCOUNT

NUMBER

該当の日、サイトおよびISPの訪問者数。

SESCOUNT

NUMBER

該当の日、サイトおよびISPのセッション数。

7.1.26 L3_WEEKXSITEXISPXCOUNT

この表には、各ISPの週単位のオブジェクト・インプレッション、セッションおよび訪問者の数が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER(6)

SITE表に対する外部キー。

ISPID

NUMBER

HELP_ISP表に対する外部キー。

OICOUNT

NUMBER

該当の週、サイトおよびISPのオブジェクト・インプレッション数。

VISCOUNT

NUMBER

該当の週、サイトおよびISPの訪問者数。

SESCOUNT

NUMBER

該当の週、サイトおよびISPのセッション数。

7.1.27 L3_MONTHXSITEXISPXCOUNT

この表には、各ISPの月単位のオブジェクト・インプレッション、セッションおよび訪問者の数が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER(6)

SITE表に対する外部キー。

ISPID

NUMBER

HELP_ISP表に対する外部キー。

OICOUNT

NUMBER

該当の月、サイトおよびISPのオブジェクト・インプレッション数。

VISCOUNT

NUMBER

該当の月、サイトおよびISPの訪問者数。

SESCOUNT

NUMBER

該当の月、サイトおよびISPのセッション数。

7.1.28 L3_DATEXSITEXOBJECTTYPEXCOUNT

この表には、特定の日時の各オブジェクト・タイプの集計データが格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

OBJECTTYPEID

NUMBER (12)

L2_OBJECTTYPE表に対する外部キー。

COUNT

NUMBER

該当の日と時間、サイトおよびオブジェクト・タイプのオブジェクト・インプレッション数。

HOUR

VARCHAR2 (2 BYTE)

オブジェクト・インプレッションの時間。

7.1.29 L3_DATEXSITEXOBJECTXCOUNT

この表には、特定の日付の各オブジェクトの集計データが格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

OBJECTID

NUMBER (12)

L2_OBJECT表に対する外部キー。

COUNT

NUMBER

オブジェクト・インプレッション数。

7.1.30 L3_AUDIT_TRAIL

この表は、アセット変更の監査証跡トラッキングを提供します。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表の外部キー。

OBJECTID

NUMBER

アセット識別子。

SITEID

NUMBER

SITE表の外部キー。

CSUSERID

VARCHAR2(255)

WebCenter Sitesユーザーのユーザー名。

OPTYPE

VARCHAR2(255)

次のいずれかの操作のタイプ。

CREATE|EDIT|DELETE

TIMESTAMP

DATE

変更された日時。

7.1.31 L3_DATEXSITEXOPTYPEXCOUNT

この表には、日単位のアセット変更数が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表の外部キー。

SITEID

NUMBER

SITE表の外部キー。

OPTYPE

VARCHAR2(255)

次のいずれかの操作のタイプ。

CREATE|EDIT|DELETE

COUNT

NUMBER

インシデント数。

7.1.32 L3_WEEKXSITEXOPTYPEXCOUNT

この表には、週単位のアセット変更数が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表の外部キー。

SITEID

NUMBER

SITE表の外部キー。

OPTYPE

VARCHAR2(255)

次のいずれかの操作のタイプ。CREATE|EDIT|DELETE

COUNT

NUMBER

インシデント数。

7.1.33 L3_MONTHXSITEXOPTYPEXCOUNT

この表には、月単位のアセット変更数が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表の外部キー。

SITEID

NUMBER

SITE表の外部キー。

OPTYPE

VARCHAR2(255)

次のいずれかの操作のタイプ。

CREATE|EDIT|DELETE

COUNT

NUMBER

インシデント数。

7.1.34 L3_DATEXSITEXOSXCOUNT

この表には、特定の日付の各オペレーティング・システムのセッション数が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

OSID

NUMBER (12)

L2_OS表に対する外部キー。

COUNT

NUMBER

該当のオペレーティング・システムのセッション数。

7.1.35 L3_DATEXSITEXREFERERXCOUNT

この表には、特定の日付の各リファラURLのセッション数が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

REFERER

VARCHAR2 (500 BYTE)

リファラURL。

COUNT

NUMBER

該当のリファラURLからのセッション数。

7.1.36 L3_DATEXSITEXSCREENRESXCOUNT

この表には、特定の日付の各画面解像度のセッション数が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

SCREENRESOLUTIONID

NUMBER (12)

画面解像度は、VVVVHHHHという単一の値です。VVVVは垂直方向の解像度、HHHHは水平方向の解像度を表します。

COUNT

NUMBER

該当の画面解像度のセッション数。

7.1.37 L3_DATEXSITEXSESSION

この表には、特定の日付の各サイトのセッション情報が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

AVG

NUMBER

回線に含まれるすべてのセッションの平均期間。

DURRATIONQUANTIL

NUMBER

- Null: 有効なセッションIDを持たないセッション。

- 0: 長さが0秒のセッション。

- 1: 1-30秒のセッション。

- 30: 30-120秒のセッション。

- 120: 120-300秒のセッション。

- 300: 300-900秒のセッション。

- 900: 900-1800秒のセッション。

- 1800: 1,800-3,600秒のセッション。

- 3600: 3,600-86,400秒のセッション。

QUANTILCOUNT

NUMBER

該当の変位値のセッション数。

PICOUNT

NUMBER

該当の変位値のオブジェクト・インプレッション数。

7.1.38 L3_DATEXSITEXSESSIONXQUANTIL

この表には、変位値に基づくセッション情報が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

SUM

NUMBER

セッション数。

AVG

NUMBER

これらのセッションの平均期間。

QUAN0

NUMBER

長さが0のセッション数。

QUAN0AVG

NUMBER

該当の変位値のすべてのセッションの平均期間。

QUAN1

NUMBER

長さが1-30秒のセッション数。

QUAN1AVG

NUMBER

該当の変位値のすべてのセッションの平均期間。

QUAN30

NUMBER

長さが31-120秒(2分)のセッション数。

QUAN30AVG

NUMBER

該当の変位値のすべてのセッションの平均期間。

QUAN120

NUMBER

長さが121-300秒(5分)のセッション数。

QUAN120AVG

NUMBER

該当の変位値のすべてのセッションの平均期間。

QUAN300

NUMBER

長さが301-900秒(15分)のセッション数。

QUAN300AVG

NUMBER

該当の変位値のすべてのセッションの平均期間。

QUAN900

NUMBER

長さが901-1800秒(30分)のセッション数。

QUAN900AVG

NUMBER

該当の変位値のすべてのセッションの平均期間。

QUAN1800

NUMBER

長さが1801-3600秒(1時間)のセッション数。

QUAN1800AVG

NUMBER

該当の変位値のすべてのセッションの平均期間。

QUAN3600

NUMBER

長さが3601-86400秒(1週間)のセッション数。

QUAN3600AVG

NUMBER

該当の変位値のすべてのセッションの平均期間。

QUAN86400

NUMBER

長さが86400秒(1週間)を超えるセッション数。

QUAN86400AVG

NUMBER

該当の変位値のすべてのセッションの平均期間。

QUANNULL

NUMBER

長さが0でSESSIONIDがnull (非Cookieセッション)のセッション数。

QUANNULLAVG

NUMBER

内部使用に予約されています。

PICOUNT

NUMBER

該当の変位値のオブジェクト・インプレッション数。

7.1.39 L3_DATEXSITEXSEXKEYWORDXCOUNT

この表には、特定のキーワードで始まる日単位のセッション数が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

SEARCHENGINEID

NUMBER

L2_SEARCHENGINE表に対する外部キー。

KEYWORD

VARCHAR2 (128 BYTE)

検索フレーズ。

COUNT

NUMBER

検索エンジンからリファラおよびフレーズで始まるセッション数。

7.1.40 L3_DATEXSITEXVISITORXCOUNT

この表には、日単位の各訪問者のセッション数が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

COUNT

NUMBER

該当の日のサイトの訪問者数。

SESCOUNT

NUMBER

該当の日のサイトのセッション数。

PICOUNT

NUMBER

該当の日のサイトのオブジェクト・インプレッション数。

NEW

NUMBER

該当の日のサイトの新しい訪問者数。

7.1.41 L3_WEEKXSITEXVISITORXCOUNT

この表には、週単位の各訪問者のセッション数が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

COUNT

NUMBER

該当の週のサイトの訪問者数。

SESCOUNT

NUMBER

該当の週のサイトのセッション数。

PICOUNT

NUMBER

該当の週のサイトのオブジェクト・インプレッション数。

NEW

NUMBER

該当の週のサイトの訪問者数。

7.1.42 L3_MONTHXSITEXVISITORXCOUNT

この表には、月単位の各訪問者のセッション数が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER (6)

SITE表に対する外部キー。

COUNT

NUMBER

該当の月のサイトの訪問者数。

SESCOUNT

NUMBER

該当の月のサイトのセッション数。

PICOUNT

NUMBER

該当の月のサイトのオブジェクト・インプレッション数。

NEW

NUMBER

該当の月のサイトの新しい訪問者数。

7.1.43 REC_L3_RECXCOUNT

この表には、特定の日に表示およびクリックされた推奨数が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER

SITE表に対する外部キー。

RECID

NUMBER (6)

REC_RECOMMENDATION表に対する外部キー。

VIEWCOUNT

NUMBER (12)

推奨が表示された回数。

CLICKCOUNT

NUMBER (12)

推奨がクリックされた回数。

7.1.44 REC_L3_RECXSEGXCOUNT

この表には、特定の日に特定のセグメントで表示およびクリックされた推奨数が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER

SITE表に対する外部キー。

RECID

NUMBER (6)

REC_RECOMMENDATION表に対する外部キー。

SEGID

NUMBER (6)

REC_SEGMENT表に対する外部キー。

VIEWCOUNT

NUMBER (12)

該当のセグメントで推奨が表示された回数。

CLICKCOUNT

NUMBER (12)

該当のセグメントで推奨がクリックされた回数。

7.1.45 REC_L3_RECXSEGXOBJXCOUNT

この表には、特定の日における特定の推奨の特定のセグメントによるオブジェクトのアクセス回数が格納されます。

列名

データ型

説明

DATEID

NUMBER

HELP_DATES表に対する外部キー。

SITEID

NUMBER

SITE表に対する外部キー。

RECID

NUMBER (6)

REC_RECOMMENDATION表に対する外部キー。

SEGID

NUMBER (6)

REC_SEGMENT表に対する外部キー。

OBJID

NUMBER (24)

L2_OBJECT表に対する外部キー。

OBJVIEWEDCOUNT

NUMBER (12)

推奨リスト時にオブジェクトが表示された頻度。

OBJCLICKEDCOUNT

NUMBER (12)

推奨リスト時にオブジェクトがクリックされた頻度。

7.2 HELP表

この項の各表には、様々なジョブおよびレポートで使用される静的データが格納されます。表はインストール時に移入されます。

- 第7.2.1項「HELP_CITY」

- 第7.2.2項「HELP_REGION」

- 第7.2.3項「HELP_COUNTRY」

- 第7.2.4項「HELP_DATES」

- 第7.2.5項「HELP_HOURS」

- 第7.2.6項「HELP_ISP」

7.2.1 HELP_CITY

内部使用に予約されています。

列名

データ型

説明

ID

NUMBER

主キー。

NAME

VARCHAR2 (64)

市区町村の名前。

REGIONID

NUMBER

HELP_REGION表に対する外部キー。

COUNTRYID

NUMBER

HELP_COUNTRY表に対する外部キー。

7.2.2 HELP_REGION

内部使用に予約されています。

列名

データ型

説明

ID

NUMBER

主キー。

NAME

VARCHAR2 (128 BYTE)

リージョンの名前。

COUNTRYID

NUMBER

HELP_COUNTRY表に対する外部キー。

REGIONCODE

VARCHAR2 (2)

HELP_REGION表に対する外部キー。

7.2.3 HELP_COUNTRY

この表には、国に関する詳細情報が格納されます。

列名

データ型

説明

ID

NUMBER

主キー。

CODE

VARCHAR2 (5 BYTE)

2文字の国コード。

NAME

VARCHAR2 (50 BYTE)

国名。

COUNTRY

VARCHAR2(50)

この列は使用されません。

POPULATION

NUMBER (14)

国の人口。

7.2.4 HELP_DATES

この表は、日付ごとに1つのエントリを持ちます。これは、パフォーマンス上の理由で使用および参照されます。

列名

データ型

説明

ID

NUMBER

主キー。

DAT

DATE

日付(午前0時)。

STRDAT

VARCHAR2 (10 BYTE)

yyyy-mm-ddの文字列で表される日付。

7.2.5 HELP_HOURS

この表は、時間(00–23)ごとに1つのエントリを持ちます。これは、パフォーマンス上の理由で使用および参照されます。

列名

データ型

説明

HOUR

NUMBER

時間(0から始まる)。

STRHOUR

VARCHAR2 (2 BYTE)

時間を表す文字列(00から23の間の値)。

7.2.6 HELP_ISP

この表には、インターネット・サービス・プロバイダ・レポートで使用可能なすべてのISPが格納されます。

列名

データ型

説明

ID

NUMBER

主キー。

NAME

VARCHAR2(255)

ISPの名前。

7.3 システムの構成およびメンテナンスの表

この項の各表は、システムの構成およびメンテナンスで使用されます。

- 第7.3.1項「ACCESSRIGHT」

- 第7.3.2項「BROWSERGROUP」

- 第7.3.3項「BROWSERIDENTIFICATION」

- 第7.3.4項「IP2COUNTRYCITY_BLOCKS」

- 第7.3.5項「IP2ISP_BLOCKS」

- 第7.3.6項「IPQUICKLIST」

- 第7.3.7項「ESAUSER」

- 第7.3.8項「IP2COUNTRY」

- 第7.3.9項「OBJECTTYPEGROUP」

- 第7.3.10項「SETTING」

- 第7.3.11項「OSGROUP」

- 第7.3.12項「OSIDENTIFICATION」

- 第7.3.13項「REC_RECOMMENDATION」

- 第7.3.14項「REC_SEGMENT」

- 第7.3.15項「REPORT」

- 第7.3.16項「REPORT2REPORTGROUP」

- 第7.3.17項「REPORTGROUP」

- 第7.3.18項「REPORTPARAMETER」

- 第7.3.19項「SEARCHENGINEGROUP」

- 第7.3.20項「SEARCHENGINEIDENT」

- 第7.3.21項「SITE」

- 第7.3.22項「SITE2OBJECTTYPEGROUP」

- 第7.3.23項「SITEGROUP」

- 第7.3.24項「PI_SITEXOBJECTTYPE」

- 第7.3.25項「USER2USERGROUP」

- 第7.3.26項「USERGROUP」

- 第7.3.27項「L2_BROWSER」

- 第7.3.28項「L2_GROUP」

- 第7.3.29項「L2_OBJECT」

- 第7.3.30項「L2_OBJECTNAMEHISTORY」

- 第7.3.31項「L2_OBJECTTYPE」

- 第7.3.32項「L2_OS」

- 第7.3.33項「L2_PIOBJECTTYPE」

- 第7.3.34項「L2_SEARCHENGINE」

- 第7.3.35項「L2_VISITOR」

- 第7.3.36項「TASKSTATUSHISTORY」

- 第7.3.37項「HDFSAGENTSTATUSHISTORY」

- 第7.3.38項「DETAILDEFINITION」

7.3.1 ACCESSRIGHT

この表では、アクセス権を定義します。ユーザー・グループの1つがサイトのレポートにアクセスできる場合、ユーザーはアクセスが可能です。

列名

データ型

説明

ID

NUMBER (12)

主キー。

SITE

NUMBER (12)

SITE表に対する外部キー。

REPORT

NUMBER (12)

REPORT表に対する外部キー。

USERGROUP

NUMBER (12)

USERGROUP表に対する外部キー。

7.3.2 BROWSERGROUP

この表には、ブラウザ・グループの名前が格納されます。たとえば、Internet Explorerグループには、Internet Explorer 6および7が含まれます。各ブラウザは、L2_BROWSER表に個別にリストされます。

列名

データ型

説明

ID

NUMBER

主キー。

NAME

VARCHAR2 (64 BYTE)

グループの名前。

有効値: 最大64文字の任意の値。

7.3.3 BROWSERIDENTIFICATION

この表は、ブラウザのエージェント文字列に基づいてブラウザを識別する際に使用されます。エージェント文字列にこの表のエントリのパターンが含まれている場合、ブラウザにエージェントが割り当てられます。エージェント文字列がこの表の複数のレコードに一致する場合は、優先順位が最も高いレコードが使用されます。

列名

データ型

説明

ID

INTEGER

主キー。

BROWSERID

INTEGER

パターンが適合する場合にエージェントをブラウザに割り当てる、L2_BROWSERレコードに対する外部キー。

PATTERN

VARCHAR2 (50 BYTE)

ブラウザを識別するパターン。

PRIORITY

INTEGER

エージェント文字列が複数のレコードに適合する場合に使用する優先順位。

7.3.4 IP2COUNTRYCITY_BLOCKS

内部使用に予約されています。この表には、IPアドレス関連の情報が格納されます。

列名

データ型

説明

IPFROM

NUMBER

この値より上のアドレスに情報を制限します。

IPTO

NUMBER

この値より下のアドレスに情報を制限します。

LOCATIONID

NUMBER

この列は使用されません。

COUNTRYID

NUMBER

特定のIPアドレスのHELP_COUNTRYレコードに対する外部キー。

CITYID

NUMBER

特定のIPアドレスのHELP_CITYレコードに対する外部キー。

REGIONID

NUMBER

特定のIPアドレスのHELP_CITYレコードに対する外部キー。

ISPID

NUMBER

カスタム・レポートの開発にのみ使用します。

7.3.5 IP2ISP_BLOCKS

この表には、IPアドレス関連の情報が格納されます。

列名

データ型

説明

IPFROM

NUMBER

この値より上のアドレスに情報を制限します。

IPTO

NUMBER

この値より下のアドレスに情報を制限します。

ISPID

NUMBER

特定のIPアドレスが属するHELP_ISPレコードに対する外部キー。

ISPNAME

VARCHAR2(255)

インターネット・サービス・プロバイダ名。

7.3.6 IPQUICKLIST

この表は、高速アクセス用に、IP2COUNTRYCITY_BLOCKS表から計算された情報をキャッシュします。

列名

データ型

説明

IP

NUMBER

情報が関連するIPアドレス。

ISPID

NUMBER

カスタム・レポートの開発にのみ使用します。

REGIONID

NUMBER

IPアドレスが属するHELP_REGIONレコードに対する外部キー。

CITYID

NUMBER

IPアドレスが属するHELP_CITYレコードに対する外部キー。

COUNTRYID

NUMBER

IPアドレスが属するHELP_COUNTRYレコードに対する外部キー。

7.3.7 ESAUSER

この表には、Analyticsにログインできるすべての有効なユーザーが格納されます。

列名

データ型

説明

ID

NUMBER

主キー。

USERNAME

VARCHAR2 (255 BYTE)

ログインするユーザー名。

FIRSTNAME

VARCHAR2 (255 BYTE)

ユーザーの名。

LASTNAME

VARCHAR2 (255 BYTE)

ユーザーの姓。

PASSWORD

VARCHAR2 (255 BYTE)

ユーザーのパスワード(md5hash)。

DISABLED

NUMBER

ユーザー・アカウントが無効かどうかを指定します。

DELETED

NUMBER

アカウントを無効にします。

ISADMIN

NUMBER

ユーザーが管理者インタフェースを使用できるかどうかを定義します。許可するには、1を使用します。

DEFAULTSITEID

NUMBER

ユーザーがログインするときに使用するSITEレコードに対する外部キー。

7.3.8 IP2COUNTRY

この表には、IPと国のマッピングが格納されます。

列名

データ型

説明

IPFROM

NUMBER (16)

マッピングの開始IPアドレス。

IPTO

NUMBER (16)

マッピングの終了IPアドレス。

REGISTRY

VARCHAR2 (16 BYTE)

内部使用に予約されています。

ASSIGNED

VARCHAR2 (16 BYTE)

内部使用に予約されています。

CTRY

VARCHAR2 (16 BYTE)

内部使用に予約されています。

CNTRY

VARCHAR2 (16 BYTE)

内部使用に予約されています。

COUNTRY

VARCHAR2 (32 BYTE)

HELP_COUNTRY表に対する外部キー。

7.3.9 OBJECTTYPEGROUP

この表では、オブジェクト・タイプ・グループを定義します。

列名

データ型

説明

ID

NUMBER

主キー。

NAME

VARCHAR2 (64 BYTE)

オブジェクト・タイプ・グループの名前。

7.3.10 SETTING

この表には、key=valueスキーマの様々な設定が格納されます。これらは、データベース・ジョブやアプリケーションの他の部分によって使用されます。

列名

データ型

説明

NAME

VARCHAR2 (255 BYTE)

設定の名前。

VALUE

VARCHAR2 (255 BYTE)

設定の値。

ID

NUMBER

主キー。

7.3.11 OSGROUP

この表には、オペレーティング・システム・グループの名前が格納されます。たとえば、Windows NTグループには、Windows NT4、2000およびXPが含まれます。各オペレーティング・システムは、L2_OS表に個別にリストされます。

列名

データ型

説明

ID

NUMBER

主キー。

NAME

VARCHAR2 (64 BYTE)

グループの名前。

有効値: 最大64文字の任意の文字列。

ICONPATH

VARCHAR2 (64 BYTE)

オペレーティング・システム・レポートに表示されるアイコンの名前とパス。このパスは、global.xml構成ファイルで定義されるIMGPATHパラメータに追加されます。

7.3.12 OSIDENTIFICATION

この表は、ブラウザのエージェント文字列に基づいてオペレーティング・システムを識別する際に使用されます。エージェント文字列にこの表のエントリのパターンが含まれている場合、オペレーティング・システムにエージェントが割り当てられます。エージェント文字列がこの表の複数のレコードに一致する場合は、優先順位が最も高いレコードが使用されます。

列名

データ型

説明

ID

INTEGER

主キー。

OSID

INTEGER

パターンが適合する場合にエージェントが割り当てられるオペレーティング・システムの、L2_OSレコードに対する外部キー。

PATTERN

VARCHAR2 (50 BYTE)

オペレーティング・システムを識別するパターン。

PRIORITY

INTEGER

エージェント文字列が複数のレコードに適合する場合に使用する優先順位。

7.3.13 REC_RECOMMENDATION

この表では、Engageレポートのすべての推奨を定義します。

列名

データ型

説明

ID

NUMBER (6)

主キー。

NAME

VARCHAR2 (125 BYTE)

推奨の名前。

DELETED

NUMBER (1)

レコードを削除済とマークします。(0= false、1= true)。

SITEID

NUMBER (12)

この推奨をサイトに一致させる、SITE表に対する外部キー。

RECOMMENDATIONID

VARCHAR2 (21 BYTE)

この推奨のWebCenter Sites推奨アセットID。

DISABLED

NUMBER (1)

0に設定する必要があります。内部使用に予約されています。

7.3.14 REC_SEGMENT

この表では、Engageレポートのすべてのセグメントを定義します。

列名

データ型

説明

ID

NUMBER (6)

主キー。

NAME

VARCHAR2 (124 BYTE)

セグメントの名前。

DELETED

NUMBER (1)

レコードを削除済とマークします。(0= False、1= True)。

SITEID

NUMBER (12)

このセグメントをサイトに一致させる、SITE表に対する外部キー。

SEGMENTID

VARCHAR2 (21 BYTE)

このセグメントのWebCenter Sitesセグメント・アセットID。

DISABLED

NUMBER (1)

0に設定する必要があります。内部使用に予約されています。

7.3.15 REPORT

レポートはこの表で定義されます(1行が1つのレポートに対応)。

列名

データ型

説明

ID

NUMBER (12)

主キー。

NAME

VARCHAR2 (256 BYTE)

レポートの名前。

CONFIGPATH

VARCHAR2 (256 BYTE)

global.xml構成ファイル内のREPORT_INSTDIRパラメータに関連するレポートの、XML構成ファイルを指します。

7.3.16 REPORT2REPORTGROUP

この表には、レポート選択パネル内のレポートとグループの割当てが格納されます。

列名

データ型

説明

ID

NUMBER (12)

主キー。

REPORT

NUMBER (12)

REPORT表に対する外部キー。

REPORTGROUP

NUMBER (12)

REPORTGROUPレコードに対する外部キー。

7.3.17 REPORTGROUP

この表では、レポート選択パネルで使用できるレポート・グループを定義します。

列名

データ型

説明

ID

NUMBER (12)

主キー。

NAME

VARCHAR2 (32 BYTE)

グループの名前。

PRIORITY

NUMBER

グループの優先順位。レポートが複数のグループに割り当てられている場合は、優先順位が最も高いグループがデフォルトで使用されます。

7.3.18 REPORTPARAMETER

この表には、レポートに対する追加パラメータがkey=valueスキーマで格納されます。

列名

データ型

説明

ID

NUMBER

主キー。

NAME

VARCHAR2 (128 BYTE)

パラメータの名前。

VALUE

VARCHAR2 (128 BYTE)

パラメータの値。

REPORTID

NUMBER

REPORTレコードに対する外部キー。

7.3.19 SEARCHENGINEGROUP

この表には、検索エンジン・グループの名前が格納されます(たとえば、Googleグループにはgoogle.com/.ca/.deが含まれます)。各検索エンジンは、L2_SEARCHENGINE表に個別にリストされます。

列名

データ型

説明

ID

NUMBER

主キー。

NAME

VARCHAR2 (64 BYTE)

グループの名前。

有効値: 最大64文字の任意の値。

ICONPATH

VARCHAR2 (64 BYTE)

検索エンジン・レポートに表示されるアイコンの名前とパス。このパスは、global.xml構成ファイルで定義されるimgpathパラメータに追加されます。

7.3.20 SEARCHENGINEIDENT

この表は、検索エンジン・リファラを識別する際に使用されます。リファラにこの表のエントリのパターンが含まれている場合、検索エンジンにセッションが割り当てられます。リファラの文字列がこの表の複数のレコードに一致する場合は、優先順位が最も高いレコードが使用されます。

列名

データ型

説明

ID

INTEGER

主キー。

SEARCHENGINEID

INTEGER

パターンが適合する場合にセッションが割り当てられる検索エンジンの、L2_SEARCHENGINEレコードに対する外部キー。

PRIORITY

INTEGER

リファラ文字列が複数のレコードに適合する場合に使用する優先順位。

PATTERN

VARCHAR2 (50 BYTE)

検索エンジンを識別するパターン。

7.3.21 SITE

この表には、すべての登録済サイトが格納されます。

列名

データ型

説明

ID

NUMBER

主キー。

NAME

VARCHAR2 (64 BYTE)

imageタグから収集されたとおりに記述されたサイトの名前。

LINK

VARCHAR2 (256 BYTE)

http://で始まるサイトのURL。このURLを使用して、Analyticsからサイトへのリンクおよび内部リファラの識別が行われます。

SCREENX

NUMBER

サイトで設計されている画面の幅。これは、画面解像度レポートで使用されます。

SITEGROUPID

NUMBER

この列はカスタム・レポートでのみ使用されます。

COUNTRYID

NUMBER

サイトのHELP_COUNTRYレコードに対する外部キー。

STARTDATE

DATE

サイトがAnalyticsに登録された日付が格納されます。

LONGNAME

VARCHAR2 (64 BYTE)

長くてわかりやすいサイトの名前(オプション)。

USERIDMETHOD

VARCHAR2 (64 BYTE)

ユーザーを識別する方法を定義します。

DELETED

NUMBER (1)

この列は使用されません。

DISABLED

NUMBER (1)

この列は使用されません。

7.3.22 SITE2OBJECTTYPEGROUP

この表では、どのオブジェクト・タイプがどのオブジェクト・タイプ・グループに属するかを定義します。この設定は、サイト固有です。

列名

データ型

説明

ID

NUMBER

主キー。

SITEID

NUMBER

SITEレコードに対する外部キー。

OBJECTTYPEGROUPID

NUMBER

OBJECTTYPEGROUP表に対する外部キー。

OBJECTTYPEID

NUMBER

L2_OBJECTTYPEレコードに対する外部キー。

7.3.23 SITEGROUP

この表はカスタム・レポートでのみ使用されます。

列名

データ型

説明

ID

NUMBER

主キー。

NAME

VARCHAR2 (64 BYTE)

サイト・グループの名前。

7.3.24 PI_SITEXOBJECTTYPE

この表では、サイトのオブジェクト・タイプに対してパフォーマンス・インジケータが有効かどうかを定義します。

列名

データ型

説明

ID

NUMBER (21)

主キー。

SITEID

NUMBER (21)

SITEレコードに対する外部キー。

OBJECTTYPEID

NUMBER (12)

L2_OBJECTTYPEレコードに対する外部キー。

ENABLE

NUMBER (1)

パフォーマンス・インジケータが有効かどうかを定義します。0はfalse、1はtrueです。

7.3.25 USER2USERGROUP

この表には、ESAUSERとUSERGROUPの関係が格納されます。

列名

データ型

説明

ID

NUMBER (12)

主キー。

ESAUSER

NUMBER (12)

ESAUSERレコードに対する外部キー。

USERGROUP

NUMBER (1)

USERGROUPレコードに対する外部キー。

7.3.26 USERGROUP

この表では、ユーザー・グループを定義します。

列名

データ型

説明

ID

NUMBER (12)

主キー。

NAME

VARCHAR (128 BYTE)

ユーザー・グループの名前。

7.3.27 L2_BROWSER

この表には、ブラウザ・レポートで使用する既知のすべてのブラウザに関する情報が格納されます。

列名

データ型

説明

ID

NUMBER (12)

主キー。

NAME

VARCHAR2 (500 BYTE)

ブラウザの名前。

BROWSERGROUPID

NUMBER

BROWSERGROUP表に対する外部キー。内部使用に予約されています。

ICONPATH

VARCHAR2 (64 BYTE)

ブラウザのイメージ・パス。

7.3.28 L2_GROUP

この表はカスタム・レポートでのみ使用されます。

列名

データ型

説明

ID

NUMBER

主キー。

NAME

VARCHAR2 (255 BYTE)

グループの名前。

PATH

VARCHAR2 (1024 BYTE)

グループのパス文字列。

PARENTID

NUMBER

親ノード。これは、L2_GROUP表に対する外部キーです。

EDATE

DATE

追加された日付。

SITEID

NUMBER

SITE表に対する外部キー。

7.3.29 L2_OBJECT

この表には、すべてのオブジェクト(アセット)に関する情報が格納されます。この表は、正規化のデータベース・ジョブによってオンデマンドで移入されます。

列名

データ型

説明

ID

NUMBER (12)

主キー。

OBJECTTYPEID

NUMBER (24)

L2_OBJECTTYPE表に対する外部キー。

NAME

VARCHAR2 (255 BYTE)

オブジェクト(アセット)の名前。この値は、変更されると同時に更新されます。

OBJECTID

VARCHAR2 (255 BYTE)

オブジェクトの識別文字列。通常は、WebCenter SitesのAssetIDです。

URL

VARCHAR2 (256 BYTE)

このオブジェクトにリンクするURL。

SITEID

NUMBER

SITE表に対する外部キー。

7.3.30 L2_OBJECTNAMEHISTORY

この表には、L2_OBJECTレコードの以前の名前が格納されます。

列名

データ型

説明

ID

NUMBER (12)

主キー。

OBJECTID

NUMBER (24)

L2_OBJECT表に対する外部キー。

EDATE

DATE

名前が変更されたときのタイムスタンプ。

NAME

VARCHAR2 (255 BYTE)

前の値。

7.3.31 L2_OBJECTTYPE

この表には、すべてのオブジェクト・タイプの名前が格納されます。これらのオブジェクト・タイプは、WebCenter Sitesではアセット・タイプとして参照されます。

列名

データ型

説明

ID

NUMBER (12)

主キー。

NAME

VARCHAR2 (128 BYTE)

オブジェクト・タイプの名前。

DISABLED

NUMBER (1)

この列は使用されません。

DELETED

NUMBER (1)

この列は使用されません。

7.3.32 L2_OS

この表では、オペレーティング・システム・レポートのオペレーティング・システムを定義します。

列名

データ型

説明

ID

NUMBER (12)

主キー。

NAME

VARCHAR2 (512 BYTE)

オペレーティング・システム名。

OSGROUPID

NUMBER

OSGROUP表に対する外部キー。

7.3.33 L2_PIOBJECTTYPE

この表では、パフォーマンス・インジケータが有効化されているサイトおよびオブジェクト・タイプを定義します。

列名

データ型

説明

SITEID

NUMBER

パフォーマンス・インジケータを有効化するサイトに対する外部キー。

OBJECTTYPEID

NUMBER

パフォーマンス・インジケータを有効化する、L2_OBJECTTYPE表に対する外部キー。

7.3.34 L2_SEARCHENGINE

この表には、外部検索エンジン・レポートで使用される検索エンジンに関する情報が格納されます。

列名

データ型

説明

ID

NUMBER (12)

主キー。

NAME

VARCHAR2 (512 BYTE)

検索エンジンの名前。

SEARCHENGINEGROUPID

NUMBER

SEARCHENGINEGROUP表に対する外部キー。

KEY

VARCHAR2 (16 BYTE)

パラメータの名前。

7.3.35 L2_VISITOR

この表には、訪問者が格納されます。

列名

データ型

説明

ID

NUMBER(12)

主キー。

VISITORID

VARCHAR2(1024 BYTE)

一意の訪問者識別文字列。

7.3.36 TASKSTATUSHISTORY

この表を使用して、Hadoop-jobsスケジューラが処理するワーク・パッケージに関する情報を保持します。

列名

データ型

説明

IDENTFIER

VARCHAR2(255)

ジョブ名識別子。

ENDDATE

VARCHAR2(128)

ジョブが終了または失敗した日時。

INTERNALIDENTIFIER

VARCHAR2(255)

内部のHadoopジョブID。

STARTDATE

VARCHAR2(128)

ジョブが開始された日時。

STATUS

VARCHAR2(128)

タスクの現在のステータス。

TARGET

VARCHAR2(1024)

出力データのターゲット・パス。

TYPE

VARCHAR2(128)

ジョブのタイプ。

WORKPACKAGEPATH

VARCHAR2(1024)

ワーク・パッケージのパス。

7.3.37 HDFSAGENTSTATUSHISTORY

この表を使用して、分析処理を行うためにローカル・ファイル・システムからHDFSに移動されたファイルに関する情報を保持します。

列名

データ型

説明

ID

VARCHAR2(256)

識別子。

DESTFILENAME

VARCHAR2(1020)

HDFSにおける出力のRAWワーク・パッケージ・ファイル。

ENDDATE

VARCHAR2(20)

終了日。

IDENTIFIER

VARCHAR2(128)

内部識別子。

FILESIZE

NUMBER

ファイルのサイズ。

SRCFILENAME

VARCHAR2(1020)

ローカル・ファイル・システムから取得されるソース・ファイル。

STARTDATE

VARCHAR2(20)

転送の開始日。

STATUSNR

NUMBER

内部ステータス・コード。

LOGTIMESTAMP

NUMBER

履歴が登録されたタイムスタンプ。

7.3.38 DETAILDEFINITION

この表を使用して、システムで使用できるURLパラメータを識別します。リストされていないパラメータは無視されます。この表は、カスタム・レポートを作成する場合に特に重要です。処理とレポートの用途でパラメータを保持するためには、タグで生成されたURLパラメータをこの表に入力する必要があります。

列名

データ型

説明

ID

NUMBER(12)

主キー。

NAME

VARCHAR2(64 BYTE)

パラメータの名前。

KEY

VARCHAR2(64 BYTE)

この列には、name列と同じ値を指定する必要があります。

OBJECTTYPEID

NUMBER

このフィールドは非推奨です。

SITEID

NUMBER

このフィールドは非推奨です。

TYPE

NUMBER

DETAILDEFINITIONエントリのタイプ。

GROUPFUNCTION

NVARCHAR2(12)

L2_SESSIONDET (タイプ1)の場合のみ: 値は、first (セッションの最初の値を使用)、last (最後の値を使用)またはall (セッションのすべての値を使用)です。

AUTODEF

NUMBER

このフィールドは非推奨です。

7.4 データベースの索引

この項では、Analyticsデータベース表および索引名を示します。

データベース索引名

表

列

ACCESSRIGHT_PK_IDX

ACCESSRIGHT

ID

IDX$$_55B10002

ACCESSRIGHT

SITE、REPORT

BROWSERGROUP_PK_IDX

BROWSERGROUP

ID

BROWSERIDENTIFICATION_PK_IDX

BROWSERIDENTIFICATION

ID

PK_USER

ESAUSER

ID

CITY_COUNTRYID_IDX

HELP_CITY

COUNTRYID

CITY_ID_IDX

HELP_CITY

ID

CITY_NAME_IDX

HELP_CITY

NAME

COUNTRY_CODE_IDX

HELP_COUNTRY

CODE

COUNTRY_ID_IDX

HELP_COUNTRY

ID

HELP_DATES_DAT_IDX

HELP_DATES

DAT

IDX$$_4C6E0002

HELP_DATES

ID

<AUTO GENERATED VALUE>

HELP_DATES

STRDAT

REGION_COUNTRYID_CODE_IDX

HELP_REGION

COUNTRYID、REGIONCODE

REGION_ID_IDX

HELP_REGION

ID

PK_IPQUICKLIST_IDX

IPQUICKLIST

IP

IP2COUNTRY_IPFROM_IDX

IP2COUNTRY

IPFROM

IP2COUNTRY_IPTO_IDX

IP2COUNTRY

IPTO

PK_IP2COUNTRYCITY_BLOCKS_IDX

IP2COUNTRYCITY_BLOCKS

IPTO、IPFROM

PK_L2_BROWSER

L2_BROWSER

ID

GROUP_ID_IDX

L2_GROUP

ID

L2_OBJECT_NAME_IDX

L2_OBJECT

NAME

L2_OBJECT_OBJECTID_IDX

L2_OBJECT

OBJECTID

L2_OBJECT_OBJECTTYPEID_IDX

L2_OBJECT

OBJECTTYPEID

PK_L2_OBJECT

L2_OBJECT

ID

L2_OJECTNH_OBJECTID_IDX

L2_OBJECTNAMEHISTORY

OBJECTID

PK_L2_OBJECTNAMEHISTORY

L2_OBJECTNAMEHISTORY

ID

L2_OBJECTTYPE_NAME_IDX

L2_OBJECTTYPE

NAME

PK_L2_OBJECTTYPE

L2_OBJECTTYPE

ID

INDEX PK_L2_OS

L2_OS

ID

IDX44_4BFF0003

L3_DATEXSITEXBROWSERXCOUNT

DATEID

L3_CITY_DATE_IDX

L3_DATEXSITEXCITYXCOUNT

DATEID

L3_COUNTRY_DATE_IDX

L3_DATEXSITEXCOUNTRYXCOUNT

DATEID

L3_DL_MIME_IDX

L3_DATEXSITEXDLXMIMEXCOUNT

DATEID

IDX$$_4BFF0005

L3_DATEXSITEXENTRYIDXCOUNT

DATEID

IDX$$_4C6D0001

L3_DATEXSITEXENTRYIDXCOUNT

SITEID

IDX$$_4BFF0006

L3_DATEXSITEXEXITIDXCOUNT

DATEID

IDX$$_4C6E0001

L3_DATEXSITEXEXITIDXCOUNT

SITEID

L3_GROUP_OI_IDX

L3_DATEXSITEXGROUPXOICOUNT

DATEID

L3_GROUP_SES_IDX

L3_DATEXSITEXGROUPXSESCOUNT

DATEID

L3_GROUP_VIS_DATE_IDX

L3_DATEXSITEXGROUPXVISCOUNT

DATEID

IDX$$_4BFF0007

L3_DATEXSITEXHOSTNAMEXCOUNT

DATEID

L3_ISP_DATE_IDX

L3_DATEXSITEXREGIONXCOUNT

DATEID

L3_JS_IDX

L3_DATEXSITEXJS

DATEID

IDX$$_4BFF0002

L3_DATEXSITEXOBJECTTYPEXCOUNT

DATEID

IDX$$_4BFF0001

CS_L3DATEXSITEXOBJXCOUNT

DATEID

IDX$$_4C1D0001

CS_L3DATEXSITEXOBJXCOUNT

OBJECTID

L3_DURATION_IDX

L3_DATEXSITEXOBJECTXDURATION

DATEID

L3_REGION_DATE_IDX

L3_MONTHXSITEXREGIONXCOUNT

DATEID

<AUTO GENERATED VALUE>

L3_DATEXSITEXSESSIONXQUANTIL

DATEID、SITEID

L3_CITY_MONTH_IDX

L3_MONTHXSITEXCITYXCOUNT

DATEID

L3_COUNTRY_MONTH-IDX

L3_MONTHXSITEXCOUNTRYXCOUNT

DATEID

L3_GROUP_VIS_MONTH_IDX

L3_MONTHXSITEXGROUPXVISCOUNT

DATEID

L3_REGION_MONTH_IDX

L3_MONTHXSITEXREGIONXCOUNT

DATEID

L3_CITY_WEEK_IDX

L3_WEEKXSITEXCITYXCOUNT

DATEID

L3_COUNTRY_WEEK_IDX

L3_WEEKXSITEXCOUNTRYXCOUNT

DATEID

L3_GROUP_VIS_WEEK_IDX

L3_WEEKXSITEXGROUPXVISCOUNT

DATEID

OSIDPRIM

OSIDENTIFICATION

ID

<AUTO GENERATED VALUE>

REC_L3_RECXSEGXCOUNT

DATEID、SEGID、RECID

<AUTO GENERATED VALUE>

REC_L3_RECXSEGXOBJXCOUNT

DATEID、SEGID、RECID、OBJID

PK_REC_RECOMMENDATION

REC_RECOMMENDATION

ID

<AUTO GENERATED VALUE>

REC_RECOMMENDATION

RECOMMENDATIONID

REC_RECOMMENDATION

REC_SEGMENT

ID

<AUTO GENERATED VALUE>

REC_SEGMENT

SEGMENTID

PK_REPORT

REPORT

ID

UNIQUE_REPORT_NAME

REPORT

NAME

PK_REPORTPARAMETER

REPORTPARAMETER

ID

UNIQUE_NAME_REPORTID

REPORTPARAMETER

REPORTID、NAME

PK_REPORT2REPORTGROUP

REPORT2REPORTGROUP

ID

PK_SETTING

SETTING

ID

PK_SITE

SITE

ID

<AUTO GENERATED VALUE>

SITE

NAME

PK_STATUSPARAMETER

PI_SITEXOBJECTTYPE

ID

<AUTO GENERATED VALUE>

PI_SITEXOBJECTTYPE

NAME

PK_USERGROUP

USERGROUP

ID

IDX$$_55B10001

USER2USERGROUP

ESAUSER

PK_USER2USERGROUP

USER2USERGROUP

ID

オラクル社の法律上の注意点について

コピーライトについて

Copyright © 1994-2013, Oracle and/or its affiliates.All rights reserved.

商標と登録商標について

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

制限付権利

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

危険な用途への使用について

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション（人的傷害を発生させる可能性があるアプリケーションを含む）への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性（redundancy）、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

ドラフトのアルファ版およびベータ版ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。オラクル社およびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。