Jetty コネクションプールからAct CRM データに連携。

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

CData JDBC Driver for ActCRM は、Java Web アプリケーションに簡単に統合して利用することができます。本記事では、Jetty でドライバーをコネクションプールとして設定することで、効率的にAct CRM データをアプリケーションで連携利用する方法を説明します。Jetty でJNDI resource for ActCRM を設定します。

DBC Driver for ActCRM を JNDI Data Source として設定

次の手順で、Jetty とAct CRM の接続を確立します。

1. Jetty ベースでJNDI モジュールを有効化します。JNDI を有効化するコマンドラインは以下の通り:

   java -jar ../start.jar --add-to-startd=jndi
2. JDBC Driver の.jar ファイルと.lic ファイル（インストールディレクトリのlib フォルダ下）をcontext path のlib フォルダに配置します。
3. リソースおよびスコープを宣言します。リソース宣言で必要な接続プロパティを入力します。この例では、Act CRM データソースをWeb アプリケーションのWEB-INF\jetty-env.xml レベルにdeclare しています。
   <Configure id='actcrmdemo' class="org.eclipse.jetty.webapp.WebAppContext"> <New id="actcrmdemo" class="org.eclipse.jetty.plus.jndi.Resource"> <Arg><Ref refid="actcrmdemo"/></Arg> <Arg>jdbc/actcrmdb</Arg> <Arg> <New class="cdata.jdbc.actcrm.ActCRMDriver"> <Set name="url">jdbc:actcrm:</Set> <Set name="URL">https://myActCRMserver.com</Set> <Set name="User">myUser</Set> <Set name="Password">myPassword</Set> <Set name="ActDatabase">MyDB</Set> </New> </Arg> </New> </Configure>

   Authentication セクションのUser とPassword プロパティに、有効なAct! ユーザー資格情報を設定する必要があります。認証値に加えて、以下も参照してください。

   • Act! Premium への接続

     認証値に加えて、Act! へのURL も設定が必要です。例：https://eup1-iis-04.eu.hosted.act.com/。

     さらに、接続するActDatabase を指定する必要があります。これは、ご自分のアカウントの「About Act! Premium」メニューのページ右上にある「?」で確認することができます。表示されたウィンドウの「Database Name」を使用します。

   • Act! Premium Cloud への接続

     Act! Premium Cloud アカウントに接続するには、ActCloudName プロパティも指定する必要があります。このプロパティはCloud アカウントのURL アドレスで確認できます。例：https://eup1-iis-04.eu.hosted.act.com/ActCloudName/。

   ActCRM メタデータの取得は高負荷になる可能性があることに注意してください。CacheMetadata プロパティを設定して、メタデータをローカルに格納することをお勧めします。

4. Web xml でリソースを設定します:

   jdbc/actcrmdb javax.sql.DataSource Container

5. これで、java:comp/env/jdbc/actcrmdb へのルックアップでAct CRM データにアクセスできます: InitialContext ctx = new InitialContext(); DataSource myactcrm = (DataSource)ctx.lookup("java:comp/env/jdbc/actcrmdb");

Jetty にさらに統合

ここでは、シンプルなコネクションプーリングシナリオでのドライバーの接続について説明しました。追加での連携ケースについては、Jetty ドキュメントのWorking with Jetty JNDI 　参照してください。