CData JDBC Driver for Zoho CRM は企業全体のZoho CRM へのデータ連携を可能にします。この記事では、JasperReports server にドライバーを配布してレポーティングドメイン、ビルディングブロックを作成し、ad hoc 帳票を作成する方法を説明します。
Zoho CRM ドライバーのJAR を配布
下記の手順に従って、ドライバーのJAR をJasperReports server に配置します。標準的なプロセスに従って、JNDI データソースをTomcat またはJBoss に配布できます。以下の説明にはZoho CRM およびJasperReports Server にバンドルされたTomcat server の詳細が含まれます。
- インストールディレクトリの［lib］サブフォルダ内のドライバーJAR およびlic ファイルを、apache-tomcat フォルダの［lib］サブフォルダにコピーします。
-
以下のリソースエントリーをjasperserver-pro Web アプリケーションのcontext.xml に追加します。これはアプリケーションの［META-INF］サブフォルダに配置されています。必要な接続プロパティをJDBC URL に指定します。
Zoho CRM はOAuth 認証標準を利用しています。OAuth を使って認証するには、アプリケーションを作成してOAuthClientId、OAuthClientSecret、およびCallbackURL 接続プロパティを取得しなければなりません。認証方法については、ヘルプドキュメントの「OAuth 認証の使用」を参照してください。
Zoho CRM 本製品はパフォーマンスを向上させるためにデフォルトでUseServerSideFiltering がTrue に設定されていますが、誤った結果が返される場合があります。詳しくは、ヘルプドキュメントの「高度な設定」を参照してください。
<Resource name="jdbc/zohocrm" auth="Container" type="javax.sql.DataSource" driverClassName="cdata.jdbc.zohocrm.ZohoCRMDriver" url="jdbc:zohocrm:AuthToken=2ad3b3e719f6bed7368e5e7e26e4f988;" maxActive="20" maxIdle="10" maxWait="-1" factory="com.jaspersoft.jasperserver.tomcat.jndi.JSBasicDataSourceFactory"/>
-
jasperserver-pro Web アプリケーションのweb.xml に以下の参照を追加します。これはアプリケーションの［WEB-INF］サブフォルダに配置されています。
Zoho CRM data JSP
jdbc/zohocrm
javax.sql.DataSource
Container
-
サーバーを再起動します。
Zoho CRM JDBC データソースの作成
ドライバーを配布したら、JNDI 接続を作成してバンドルされたあらゆるドライバーと同じように接続できます。
- JasperReports Server にログインして［Create］>［Data Source］をクリックします。
- ［Type］メニューで［JNDI Data Source］を選択します。
- ［Service Name］ボックスにZoho CRM に定義したJDNI ルックアップを入力します。例では、ルックアップは jdbc/zohocrm です。
ドメイン の作成
データのドメインはJaspersoft のメタデータレイヤです。アドホックな分析および帳票で使うことができます。
- ［Create］>［Domain］をクリックし、ドメインにID を入力します。
- ［Data Source］セクションで［ブラウズ］をクリックし、作成したZoho CRM データソースを選択します。
- ［Domain Design］セクションで［Create with Database Designer］をクリックします。［Select Database Schema］ダイアログが表示されます。
- Zoho CRM データソースを選択します。
- ［Tables］タブの［Data Source］ペインでテーブルを選択し、矢印をクリックして［Selected Tables］に追加します。
- ［Display］タブの［Resources］ペインでZoho CRM エンティティを選択し、矢印をクリックしてリソースを［Sets and Items］ペインに追加します。
ドメインにView Based を作成
ドメインを使ってZoho CRM のビジネスビューを作成したら、データに関連あるサブセットを表示するビューを作成します。下記の手順に従って、［Ad Hoc Editor］の［Ad Hoc view］にビューを作成します。
- ［Create］>［Ad Hoc View］をクリックします。
-
ダイアログが表示されたら、作成したZoho CRM ドメインを選択します。
-
［Choose Data］ページで、ビューで使いたいカラムを選択します。［Select Fields］セクションでは、フィルターおよび入力用のプロンプトユーザーを作成できます。［Display］セクションでは、フィールドおよびフィールド名の並び順を変更できます。
-
ウィザードを完了したら、ビューの種類を選択しビューにカラムを追加できます。JasperSoft はドライバーのメタデータを使って、利用可能なdimensions およびmeasures をデータの種類に基づいて検出します。 ［Columns］ および［Rows］ボックスにdimensions およびmeasures をドラッグします。例えば、チャートを作成するには［Columns］ボックスに［excol#1］を、［Rows］ボックスに［excol#2］をドラッグします。
- ビューを保存します。
帳票の作成
これでドメインから帳票を作成できます：
