Web 帳票ツール PrintStream でAdobe Analytics のデータを利用した帳票を作成
PrintStream は株式会社オープンストリームが提供するWeb システムでの帳票印刷、PDF 生成機能を強力にサポートする帳票ツールです。
この記事では、PrintStream と CData ODBC ドライバを使って、PrintStream でAdobe Analytics のデータを利用した帳票を作成する方法を紹介します。
CData ODBC ドライバとは?
CData ODBC ドライバは、以下のような特徴を持ったリアルタイムデータ連携ソリューションです。
- Adobe Analytics をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレミスデータソースに対応
- 多様なアプリケーション、ツールにAdobe Analytics のデータを連携
- ノーコードでの手軽な接続設定
- 標準 SQL での柔軟なデータ読み込み・書き込み
CData ODBC ドライバでは、1.データソースとしてAdobe Analytics の接続を設定、2.PrintStream 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。
CData ODBC ドライバのインストールとAdobe Analytics への接続設定
まずは、本記事右側のサイドバーからAdobeAnalytics ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。
- ODBC DSN に必要な接続プロパティの値を入力します。 組み込みのMicrosoft ODBC データソースアドミニストレーターを使用してDSN を構成できます。 これは、ドライバーのインストール時の最後のステップでも可能です。 Microsoft ODBC データソースアドミニストレータを使用してDSN を作成および設定する方法については、ヘルプドキュメントの「はじめに」の章を参照してください。
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 フローを以下の手順で完了します。
- クライアントクレデンシャルOAuth フローで指定されたOAuthClientId およびOAuthClientSecret を使用して、アクセストークンを取得します
- OAuthSettingsLocation にOAuth 値を保存し、接続間で永続化されるようにします
- トークンが期限切れになった際に、新しいアクセストークンを要求します
- 入力後、接続テストが成功すれば設定は完了です。
PrintStream で帳票をデザインする
それでは PrintStream 側の作業を進めていきます。
- 今回はシンプルに以下のようなAdobe Analytics のデータを一覧表示する帳票を作成します。
- 以下のようにリージョンを配置して、中にレコードとテキストフィールドを配置します。最終的にテキストフィールドにAdobe Analytics のデータをそれぞれマッピングするイメージです。
- 詳しい手順は割愛しますが、ヘルプの「PrintStream」チュートリアルにある「一覧表作成」を参考にしてみてください。
PrintStream でODBC 接続を行う
デザインが完了したらODBC 経由でデータを読み込みます。
- 「印刷データウィザード」を使ってODBC 接続経由でAdobe Analytics のデータを読み込みます。
- データの取得方法から「ODBC データベース」を選択し、「次へ」をクリック
- データベースの「参照」をクリックし
- 「コンピューターデータソース」の一覧から先ほど設定したODBC DSN を選択します。
- データベースの設定が完了したら、データの検索方法から「テーブルまたはビューを選択」もしくは「SQL を記述」を選択します。今回は「テーブルまたはビューを選択」を使ってみます。
- 「テーブルまたはビューを選択」では、最初に任意のテーブルまたはビューを選択します。ここでデータサンプルも表示されるので、Adobe Analytics のデータを確認しながら選ぶことができます。
- 続いて絞り込み条件を指定します。任意の条件を指定してください。
- 併せてソート条件も指定しましょう。
- 最後に帳票デザインに配置した印刷フィールドと読み込んだデータ項目をマッピングします。
印刷プレビュー
印刷プレビューで実際に帳票へデータが取り込めているか確認してみましょう。
- 下図のアイコンもしくは「F5」を押下することでプレビューが実施できます。
- 以下のようにODBC 経由で取り込んでいるデータが表示されればOK です。
Adobe Analytics からPrintStream へのデータ連携には、ぜひCData ODBC ドライバをご利用ください
このようにCData ODBC Driver for AdobeAnalytics とPrintStream を組み合わせることで、簡単にAdobe Analytics のデータを活用した連携を実現できます。ぜひ、30日の無償評価版 をお試しください。
CData ODBC ドライバは日本のユーザー向けに、UI の日本語化、ドキュメントの日本語化、日本語でのテクニカルサポートを提供しています。