Tomcat のコネクションプールで CData JDBC Driver for Zoho CRM を構成

CData JDBC Driver は、JVM 上で動作するWeb アプリケーションと連携するための標準JDBC インターフェースをサポートしています。ここでは、Tomcat のコネクションプールから Zoho CRM のデータ に接続する方法を説明します。

Tomcat のコネクションプールから Zoho CRM のデータ に接続

1. CData JAR ファイルと CData .lic ファイルを $CATALINA_HOME/lib にコピーします。CData JAR ファイルは、インストールディレクトリの lib サブフォルダにあります。
2. コンテキストにリソースの定義を追加します。ここでJDBC URL を指定します。

   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 を確認できます。

   
   <Resource name="jdbc/zohocrm"   auth="Container" type="javax.sql.DataSource" driverClassName="cdata.jdbc.zohocrm.ZohoCRMDriver" factory="org.apache.tomcat.jdbc.pool.DataSourceFactory" url="jdbc:zohocrm:AuthToken=2ad3b3e719f6bed7368e5e7e26e4f988;" maxActive="20" maxIdle="10" maxWait="-1" />
   

   特定のアプリケーションのみに Zoho CRM のデータ へのアクセスを許可するには、上記のコードをアプリケーションのMETA-INF ディレクトリにあるcontext.xml に追加します。

   共有リソースの構成の場合は、上記のコードを $CATALINA_BASE/conf にあるcontext.xml に追加します。共有リソースの構成では、すべてのアプリケーションが Zoho CRM に接続できるようになります。

3. アプリケーションの web.xml にリソースへの参照を追加します。

   
     Zoho CRM のデータ JSP
     jdbc/ZohoCRM
     javax.sql.DataSource
     Container
   
   

4. コネクションプールから接続を初期化します。

   Context initContext = new InitialContext();
   Context envContext  = (Context)initContext.lookup("java:/comp/env");
   DataSource ds = (DataSource)envContext.lookup("jdbc/ZohoCRM");
   Connection conn = ds.getConnection();
     

Tomcat との連携について

上記の手順では、シンプルなコネクションプーリングのシナリオで Zoho CRM のデータ に接続する方法を説明しました。その他のユースケースや詳細については、Tomcat のドキュメントに記載されている JNDI Datasource How-To を参照してください。