CData JDBC driver for Act CRM は、Java Web アプリケーションに簡単に統合して利用することができます。本記事では、Jetty でドライバーをコネクションプールとして設定することで、効率的にAct CRM データをアプリケーションで連携利用する方法を説明します。Jetty でJNDI resource for Act CRM を設定します。
DBC Driver for Act CRM を JNDI Data Source として設定
次の手順で、Jetty とAct CRM の接続を確立します。
Jetty ベースでJNDI モジュールを有効化します。JNDI を有効化するコマンドラインは以下の通り:
java -jar ../start.jar --add-to-startd=jndi
- JDBC Driver の.jar ファイルと.lic ファイル（インストールディレクトリのlib フォルダ下）をcontext path のlib フォルダに配置します。
-
リソースおよびスコープを宣言します。リソース宣言で必要な接続プロパティを入力します。この例では、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 プロパティを設定して、メタデータをローカルに格納することをお勧めします。
-
Web xml でリソースを設定します:
jdbc/actcrmdb
javax.sql.DataSource
Container
-
これで、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 参照してください。