Pentaho Report Designer にCvent のデータに連携して分析

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

CData JDBC Driver for Cvent はダッシュボードや帳票ツールからリアルタイムCvent のデータへの連携を可能にします。この記事では、Cvent をJDBC データソースとして接続する方法と、Pentaho でCvent を元に帳票を作成する方法を説明します。

接続と帳票の作成

1. インストールディレクトリの［lib］サブフォルダ内のJAR ファイルをコピーし、Pentaho のディレクトリ内の\Report-Designer\lib\jdbc\ フォルダに配置します。
2. \Report-Designer\ フォルダのreport-designer.bat ファイルを起動し、Report-Designer UI を開きます。

3. 以下の手順でドライバーを新しいデータソースに設定します。［Data］>［Add Data Source］>［Advanced］>［JDBC (Custom)］とクリックし、新しいCvent 接続を作成します。ダイアログが表示されたら、次のように接続プロパティを設定します。

   • Custom Connection URL property：JDBC URL を入力。初めに以下を入力し jdbc:cvent: 次にセミコロン区切りで接続プロパティを入力します。

     Cvent への認証を行う前に、ワークスペースとOAuth アプリケーションを作成する必要があります。

     ワークスペースの作成

     ワークスペースを作成するには：

     1. Cvent にサインインし、App Switcher（ページ右上の青いボタン） -> Admin に移動します。
     2. Admin メニューから、Integrations -> REST API に移動します。
     3. Developer Management の新しいタブが立ち上がります。新しいタブでManage API Access をクリックします。
     4. Workspace を作成し、名前を付けます。開発者にアクセスさせたいスコープを選択します。スコープは、開発者がアクセスできるデータドメインを制御します。
        • All を選択すると、開発者は任意のスコープ、およびREST API にこれから追加されるスコープを選択できます。
        • Custom を選択すると、開発者がOAuth アプリで選択できるスコープを、選択したスコープに制限できます。本製品によって公開されるすべてのテーブルにアクセスするには、次のスコープを設定する必要があります。

          event/attendees:read	event/attendees:write	event/contacts:read
          event/contacts:write	event/custom-fields:read	event/custom-fields:write
          event/events:read	event/events:write	event/sessions:delete
          event/sessions:read	event/sessions:write	event/speakers:delete
          event/speakers:read	event/speakers:write	budget/budget-items:read
          budget/budget-items:write	exhibitor/exhibitors:read	exhibitor/exhibitors:write
          survey/surveys:read	survey/surveys:write

     OAuth アプリケーションの作成

     Workspace を設定して招待すると、開発者はサインアップしてカスタムOAuth アプリを作成できます。手順については、ヘルプドキュメントのカスタムOAuth アプリケーションの作成を参照してください。

     Cvent への接続

     OAuth アプリケーションを作成したら、次の接続プロパティを設定してCvent に接続します。

     • InitiateOAuth：GETANDREFRESH。OAuthAccessToken を自動的に取得およびリフレッシュするために使用します。
     • OAuthClientId：OAuth アプリケーションに関連付けられたClient ID。これは、Cvent Developer Portal のApplications page ページにあります。
     • OAuthClientSecret：OAuth アプリケーションに関連付けられたClient secret。これは、Cvent Developer Portal のApplications page ページにあります。

     以下は一般的なJDBC URL です：

     jdbc:cvent:OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;
   • Custom Driver Class Name：cdata.jdbc.cvent.CventDriver と入力。
   • User Name：認証するユーザーネーム。
   • Password：認証するパスワード。

レポートに Cvent のデータを追加

これで、Cvent の帳票を作成する準備が整いました。

1. 帳票にCvent のデータソースを追加します：［Data］>［Add Data Source］>［JDBC］をクリックし、データソースを選択します。

2. クエリを設定します。この記事では次を使います：

   SELECT Id, Title FROM Events WHERE Virtual = 'true'
3. 帳票にチャートをドラッグし、ダブルクリックしてチャートを編集します。帳票を実行して、チャートを表示します。このクエリ結果を使って、Events テーブルのシンプルなチャートを作成することができます。
4. 帳票を実行して、チャートを見てみましょう。