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

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

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

接続と帳票の作成

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)］とクリックし、新しいMisoca 接続を作成します。ダイアログが表示されたら、次のように接続プロパティを設定します。

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

     まず、OAuth アプリを作成する必要があります。 https://app.misoca.jp/oauth2/applications に移動し、「新しいアプリケーションを作成する」ボタンをクリックしてください。アプリケーション名を入力し、リダイレクトURL を指定して、「登録する」をクリックします。そうすると、クライアントシークレットとクライアントID が表示されます。

     次に、プロファイルをダウンロードしてドライバーがアクセス可能な場所に配置します。こちらからプロファイルをダウンロードして、「C:/profiles/」 などに設置してください。

     以下の接続プロパティを設定した後、接続の準備が整います。

     • AuthScheme：OAuth に設定してください。
     • OAuthClientID：アプリケーション設定で指定されたOAuth クライアントID に設定してください。
     • OAuthClientSecret：アプリケーション設定で指定されたOAuth クライアントシークレットに設定してください。
     • CallbackURL：アプリケーション設定で指定したリダイレクトURI に設定してください。
     • InitiateOAuth：GETANDREFRESH に設定してください。InitiateOAuth を使用して、OAuthAccessToken を取得するプロセスを管理できます。

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

     jdbc:api:Profile=Misoca.apip;Authscheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;
   • Custom Driver Class Name：cdata.jdbc.api.APIDriver と入力。
   • User Name：認証するユーザーネーム。
   • Password：認証するパスワード。

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

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

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

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

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