Pentaho Report Designer でZoho CRM のデータを連携利用

CData JDBC Driver for Zoho CRM のデータ を使えば、ダッシュボードやレポートからリアルタイムデータにアクセスできます。この記事では、Zoho CRM のデータにJDBC データソースとして接続し、Pentaho でZoho CRM のデータをもとにしたレポートを公開する方法を説明します。

接続してレポートを作成

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）をクリックし、新しいZoho CRM 接続を作成して、ドライバーで新しいデータソースを作成します。 表示されるダイアログで、以下のように接続プロパティを設定します。

   • Custom Connection URL property：JDBC URL を入力します。JDBC URL はjdbc:zohocrm: で始まり、その後にセミコロン区切りで接続プロパティを指定します。

     Zoho CRM への接続

     それでは、Zoho CRM に接続していきましょう。データに接続するには、以下の接続パラメータを設定します。

     • Region：Zoho CRM サーバーURL のドメインに関連付けられたリージョン
     • Schema：Zoho CRM のバージョン（v2、v2.1、またはv4）。Zoho CRM のバージョンごとに独自のデータモデルがあります

     これらのプロパティに加えて、認可時にサンドボックスまたは開発者インスタンスのいずれかを選択した場合は、InstanceType 接続プロパティでも同じ設定を行ってください。

     Zoho CRM への認証

     Zoho CRM では、データへの認証に2つの方法が用意されています。お使いの環境に応じて適切な方法を選択てください。

     デスクトップ経由で自分のローカルデータに認証を行う場合（非ブラウザ接続）：CData 製品が提供する埋め込みOAuth アプリケーションを使用

     CData 製品はすでにZoho CRM にOAuth アプリケーションとして登録されています。そのため、デスクトップアプリケーションを介したローカルデータへの接続では、自動的に組み込みアプリケーションが使用されます。 OAuth 交換の繰り返しを避け、ローカルデータにアクセスするたびにOAuthAccessToken を手動で設定する手間を省くには、InitiateOAuth をGETANDREFRESH に設定してください。

     ネットワーク経由で共有データに認証を行う場合（ブラウザ接続）：カスタムOAuth アプリケーションを使用

     すべてのOAuth フローで、この認証を有効にするにはAuthScheme をOAuth に設定する必要があります。

     より詳細な認証手順については、ヘルプドキュメントの「Zoho CRM への認証」をご確認ください。

     組み込みの接続文字列デザイナー

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

     java -jar cdata.jdbc.zohocrm.jar
     

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

     

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

     一般的なJDBC URL は次のとおりです：

     jdbc:zohocrm:AuthToken=2ad3b3e719f6bed7368e5e7e26e4f988;

   • Custom Driver Class Name：cdata.jdbc.zohocrm.ZohoCRMDriver を入力します。
   • User Name：認証に使用するユーザー名。
   • Password：認証に使用するパスワード。
   

レポートにZoho CRM のデータを追加

Zoho CRM のデータをもとにレポートを作成する準備が整いました。

1. レポートにZoho CRM のソースを追加します。Data -> Add Data Source -> JDBC をクリックしてデータソースを選択します。

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

   SELECT Account_Name, Annual_Revenue FROM Accounts

   
3. レポートにチャートをドラッグし、ダブルクリックしてチャートを編集します。レポートを実行してチャートを表示します。このクエリの結果を使用して、Accounts テーブルのシンプルなチャートを作成できます。
4. 最後に、レポートを実行してチャートを確認します。