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

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

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

接続と帳票の作成

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

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

     Zoho Books 接続プロパティの取得・設定方法

     以下の接続プロパティを使用して、取得されるZoho Books データを正確に絞り込むことができます。

     • Region：サーバーURL のトップレベルドメイン（TLD）。アカウントが米国以外のドメインにある場合は、リージョンを適宜変更してください。
     • OrganizationId（オプション）：接続先の特定のZoho Books 組織に関連付けられたID。
       • Organization Id の値が接続文字列で指定されていない場合、ドライバーは利用可能なすべての組織を自動的に取得し、最初のOrganization Id をデフォルトとして選択します。

     Zoho Books への認証

     Zoho Books はOAuth 認証標準を使用します。詳しくは、ヘルプドキュメントの「はじめに」セクションを参照してください。

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

     jdbc:zohobooks:OAuthClientId=MyOAuthClientId;OAuthClientSecret=myOAuthClientSecret;CallbackURL=https://localhost:33333;OrganizationId=MyOrganizationId;
   • Custom Driver Class Name：cdata.jdbc.zohobooks.ZohoBooksDriver と入力。
   • User Name：認証するユーザーネーム。
   • Password：認証するパスワード。

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

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

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

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

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