Crystal Reports から Adobe Analytics のデータに接続

Mohsin Turki
Technical Marketing Engineer

CData Connect AI を使用して Crystal Reports からライブAdobe Analytics のデータに接続してレポートを作成します。

Crystal Reports は SAP のビジネスインテリジェンスアプリケーションで、適切にフォーマットされた、ピクセルパーフェクトな複数ページレポートでデータを分析できるように設計されています。CData Connect AI と組み合わせることで、Crystal Reports からライブAdobe Analytics のデータにアクセスできます。この記事では、Connect AI を使用して Adobe Analytics に接続し、Crystal Reports でAdobe Analytics のデータのレポートを作成する方法を説明します。

CData Connect AI は Adobe Analytics に接続するための純粋な SQL Server インターフェースを提供し、ネイティブ対応データベースにデータをレプリケーションすることなく Adobe Analytics からデータをクエリできます。CData Connect AI は最適化されたデータ処理機能を備えており、フィルタや JOIN などのサポート対象のすべての SQL 操作を Adobe Analytics に直接プッシュダウンします。サーバーサイド処理を活用することで、要求されたAdobe Analytics のデータを迅速に取得できます。

Crystal Reports 用に Adobe Analytics への接続を設定

Crystal Reports から Adobe Analytics への接続は CData Connect AI を介して行います。Crystal Reports でAdobe Analytics のデータを操作するには、まず Adobe Analytics への接続を作成・設定します。

Connect AI にログインして「Sources」をクリック、次に「 Add Connection」をクリック

接続を追加パネルから「Adobe Analytics」を選択

Adobe Analytics に接続するために必要な認証プロパティを入力します。
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. トークンが期限切れになった際に、新しいアクセストークンを要求します
「Save & Test」をクリック
Adobe Analytics 接続の追加ページで「Permissions」タブに移動し、ユーザーベースのアクセス許可を設定します。

Personal Access Token の作成

REST API、OData API、または Virtual SQL Server を介して Connect AI に接続する場合、Personal Access Token（PAT）を使用して Connect AI への接続を認証します。アクセスの粒度を維持するために、サービスごとに個別の PAT を作成することをお勧めします。

Connect AI アプリの右上にある歯車アイコン（）をクリックして設定ページを開きます。
設定ページで「Access Tokens」セクションに移動し、「 Create PAT」をクリックします。
PAT に名前を付けて「Create」をクリックします。
Personal Access Token は作成時にのみ表示されるため、必ずコピーして安全な場所に保存してください。

接続と PAT が設定できたので、Crystal Reports からAdobe Analytics のデータに接続する準備が整いました。

Connect AI を使用して Crystal Reports から Adobe Analytics に接続

Crystal Reports から CData Connect AI への接続を確立するには、JDBC ドライバーをダウンロードする必要があります。

CData Connect AI の Client Tools ページを開きます。
JDBC を検索して選択します。
セットアップファイルをダウンロードして実行します。
インストールが完了したら、JDBC ドライバーのインストールディレクトリで JDBC Connect JAR ファイルを見つけます（例: C:\Program Files\CData\JDBC Driver for CData Connect\lib）。
JDBC Connect JAR ファイル（cdata.jdbc.connect.jar）をコピーします。

JDBC CData Connect JAR ファイルをコピーしたら、Crystal Reports のインストール場所に貼り付けて Connect AI への接続を設定する必要があります。

Crystal Reports のインストールディレクトリを見つけます（例: C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\java\lib）
JDBC Connect JAR ファイルを Crystal Reports のインストールディレクトリに貼り付けます。
親の java フォルダに移動します（例: C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\java）。このフォルダには CRConfig ファイルが含まれているはずです。
CRConfig をテキストエディタで開きます。
CRConfig ファイルのに JDBC CData Connect JAR ファイルへのパスを追加します（例: C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\java\lib）
Crystal Reports にログインし、空白のレポートを開始します。
Database Expert ダイアログで「Create New Connection」をクリックします。
JDBC データソースと追加するテーブルを選択します。「OK」をクリックします。
Connection ダイアログで Connection URL（例: jdbc:connect:AuthScheme=Basic;user=username;password=PAT;）と Database Classname（例: cdata.jdbc.connect.ConnectDriver）を入力します。
「Finish」をクリックします。Database Expert ダイアログに利用可能なすべての接続が表示されます。