SAP Crystal Reports で Adobe Analytics ののデータをレポートに出力

Crystal Reports にはリモートデータへのデータ処理をオフロードするためのさまざまなオプションが用意されており、リアルタイムレポートを実現できます。Crystal Reports がJDBC に対応しているため、CData JDBC Driver for Adobe Analytics によってこの機能をCrystal Reports で利用できるようになります。この記事では、レポート実行時にデータを更新するAdobe Analytics のデータレポートを作成する方法を紹介します。

以下の表は、この記事で使用するツールとバージョンです。

JDBC Driver のデプロイ

Crystal Reports のクラスパスにドライバーJAR を含めて、CData JDBC Driver for Adobe Analytics をインストールします。DataDriverCommonElement の下にあるClassPath 要素のパスに、.jar を含むフルファイルパスを追加します。

CRConfig.xml ファイルのデフォルトの場所はC:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\java ですが、インストールによって多少異なる場合があります。ドライバーJAR はインストールディレクトリのlib サブフォルダにあります。

ClassPath にJAR を追加したら、Crystal Reports を再起動します。

Adobe Analytics のデータに接続

Adobe AnalyticsのJDBC Driver をデプロイしたら、レポートウィザードを使用して新しいレポートにAdobe Analytics のデータを追加できます。

1. File -> New -> Standard Report をクリックします。
2. Create New Connection の下にあるJDBC (JNDI) を展開し、Make a New Connection をダブルクリックします。
3. CData JDBC Driver for Adobe Analytics を使用して接続文字列を作成します。

JDBC URL の構成については、Adobe Analytics JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインからjar ファイルを実行します。

java -jar cdata.jdbc.adobeanalytics.jar

Adobe Analytics への接続

それでは、Adobe Analytics に接続していきましょう。接続するには、GlobalCompanyId およびRSID を識別する必要があります。デフォルトでは、ドライバーが会社とレポートスイートの識別を自動で試みますが、これらの値を明示的に指定することも可能です。詳しい手順については、 href="/kb/help/" target="_blank">ヘルプドキュメントの「Adobe Analytics への接続」セクションをご確認ください。

Adobe Analytics への認証

続いて、認証方法を設定しましょう。Adobe Analytics はOAuth 認証標準を利用しており、OAuth またはサービスアカウントで認証できます。

ユーザーアカウント（OAuth）

ユーザーアカウントでの認証では、すべてのフローでAuthScheme をOAuth に設定する必要があります。詳しい認証手順については、 href="/kb/help/" target="_blank">ヘルプドキュメントの「Adobe Analytics への認証」セクションをご参照ください。

サービスアカウント

サービスアカウントではサイレント認証が利用でき、ブラウザでのユーザー認証が不要です。このフローを使用するには、アプリケーションを作成する必要があります。アプリケーションの作成および認可については、ドキュメントの「カスタムOAuth アプリの作成」をご確認ください。これにより、サービスアカウントにアクセス権があるAdobe Analytics データに接続できるようになります。

サービスアカウントを使用したServer-to-Server OAuth で認証するには、AuthScheme をOAuthClient に設定します。接続には以下のプロパティを設定してください。

• InitiateOAuth：GETANDREFRESH に設定
• OAuthClientId：アプリケーション設定のクライアントId に設定
• OAuthClientSecret：アプリケーション設定のクライアントシークレットに設定

接続すると、CData 製品がサービスアカウントでのOAuth フローを以下の手順で完了します。

1. クライアントクレデンシャルOAuth フローで指定されたOAuthClientId およびOAuthClientSecret を使用して、アクセストークンを取得します
2. OAuthSettingsLocation にOAuth 値を保存し、接続間で永続化されるようにします
3. トークンが期限切れになった際に、新しいアクセストークンを要求します

接続プロパティを入力し、接続文字列をクリップボードにコピーします。



JDBC URL を設定する際に、Max Rows 接続プロパティを設定することもできます。これにより返される行数が制限され、レポートやビジュアライゼーションをデザインする際のパフォーマンス向上に役立ちます。

4. ウィザードでJDBC 接続URL を入力します。

   jdbc:adobeanalytics:GlobalCompanyId=myGlobalCompanyId; RSID=myRSID; OAuthClientId=myOauthClientId; OauthClientSecret=myOAuthClientSecret; CallbackURL=myCallbackURL;
   

5. ドライバークラス名を設定します。

   cdata.jdbc.adobeanalytics.AdobeAnalyticsDriver
   

   
6. レポートに必要なテーブルを選択します。
7. SAP Crystal Reports でAdobe Analytics のデータのテーブルをリンクすることもできます。テーブル間のリンクを追加したら、NEXT をクリックします。
8. テーブルを選択したら、選択したテーブルからレポートに表示するフィールドを選び、NEXT をクリックします。
9. レポート上の情報をグループ化するために「Group By」フィールドを選択します。
10. 集計合計に基づいてグループを並べ替え、NEXT をクリックします。

その後、グループ化、並べ替え、集計を設定できます。集計とサマリーを使用してチャートを作成するには、次のセクションを参照してください。

チャートの作成

グループ化するカラムを選択した後、標準レポート作成ウィザードでチャートを作成するオプションが表示されます。以下の手順に従って、Page カラムの値を集計するチャートを作成します。

1. 標準レポート作成ウィザードで、Bar Chart オプションを選択し、「On change of」メニューでグループ化したカラムを選択します。
2. Show Summary メニューで、作成した集計を選択します。
3. 必要に応じてフィルターとテンプレートを選択し、ウィザードを完了します。

レポートのテンプレートを選択すると、完成したレポートをプレビューし、データが入力されたチャートを表示できます。

完成したレポート

レポートに最初に指定したすべてのフィールドが含まれていることを確認できます。

リモートデータの操作

データの更新を確認するには、File をクリックし、「Save Data with Report」オプションをオフにします。レポートを操作すると（例えば、詳細にドリルダウンすると）、Crystal Reports はレポートの表示に必要なデータを取得するためにSQL クエリを実行します。すでに取得したデータを再読み込みするには、レポートを更新または再実行します。

詳細要素を非表示にし、サーバー側グループ化を有効にすることで、ドライバーに処理をオフロードできます。これを行うには、レポート作成ウィザードでグループ化するカラムを選択する必要があります。

1. File -> Report Options をクリックし、「Perform Grouping On Server」オプションを選択します。
2. Report -> Section Expert をクリックし、レポートのDetails セクションを選択します。「Hide (Drill-Down OK)」オプションを選択します。

詳細を非表示にしてレポートをプレビューすると、Crystal Reports はGROUP BY クエリを実行します。チャートのカラムをダブルクリックして詳細にドリルダウンすると、Crystal Reports は必要なデータのみを取得するSELECT WHERE クエリを実行し、読み込み時間を短縮します。

これで、SAP Crystal Reports とCData JDBC Driver を使用して、Adobe Analytics のデータに基づくSAP Crystal レポートが作成できました。CData JDBC Driver for Adobe Analytics の詳細と無料トライアルのダウンロードについては、Adobe Analytics JDBC Driver ページをご覧ください。ご不明な点がございましたら、サポートチームまでお問い合わせください。