Jetty の接続プールから Sage Intacct のデータ に接続

CData JDBC Driver for Sage Intacct は、Java Web アプリケーションへの統合が簡単です。この記事では、接続プールを設定することで Jetty から Sage Intacct のデータ に効率的に接続する方法を説明します。Jetty で Sage Intacct 用の JNDI リソースを設定していきましょう。

はじめに

---

Salesforce 用の JDBC Driver を JNDI データソースとして設定

以下のステップで Jetty から Salesforce に接続します。

1. Jetty ベースで JNDI モジュールを有効にします。次のコマンドは、コマンドラインから JNDI を有効にします。

   java -jar ../start.jar --add-to-startd=jndi
   

2. インストールディレクトリの lib サブフォルダにある CData およびライセンスファイルを、コンテキストパスの lib サブフォルダに追加します。

3. リソースとそのスコープを宣言します。リソース宣言に必要な接続プロパティを入力します。次の例では、WEB-INF\jetty-env.xml に Web アプリレベルで Sage Intacct データソースを宣言しています。

   
   <Configure id='intacctdemo' class="org.eclipse.jetty.webapp.WebAppContext">
       <New id="intacctdemo" class="org.eclipse.jetty.plus.jndi.Resource">
       <Arg><Ref refid="intacctdemo"/></Arg>
       <Arg>jdbc/intacctdb</Arg>
       <Arg>
         <New class="cdata.jdbc.sageintacct.SageIntacctDriver">
           <Set name="url">jdbc:sageintacct:</Set>
           <Set name="User">myusername</Set>
           <Set name="CompanyId">TestCompany</Set>
           <Set name="Password">mypassword</Set>
           <Set name="SenderId">Test</Set>
           <Set name="SenderPassword">abcde123</Set>
         </New>
       </Arg>
     </New>
   </Configure>
   

   Sage Intacct 接続プロパティの取得・設定方法

   独自のWeb サービスクレデンシャル、埋め込みクレデンシャル（Basic 認証）、またはOkta クレデンシャルのいずれかを使用して、Sage Intacct への接続を確立できます。

   Sage Intacct への認証

   Sage Intacct は2種類の認証をサポートします。Basic およびOkta です。選択した認証方法に関連するプロパティを設定して、接続を構成します。

   Basic 認証

   Basic 認証スキームでは、埋め込みクレデンシャルを使用してデータの読み書きが可能です。オプションとして、独自のWeb サービスクレデンシャルを指定することもできます。

   Basic 認証を使用して認証を行うには、以下のプロパティを設定します。

   • AuthScheme：Basic。
   • CompanyID：Sage Intacct にログインする際に会社を識別するために使用するID。
   • User：Sage Intacct へのログインに使用するログイン名。
   • Password：ログインクレデンシャル用のパスワード。
   • （オプション）SenderID およびSenderPassword：Web サービスのSender ID およびパスワード（独自のWeb サービスクレデンシャルを使用している場合のみ）。

   独自のWeb サービスクレデンシャルではなく、埋め込みクレデンシャルを使用する場合は、以下を実行する必要があります：

   • Web サービスダッシュボードで、会社 -> 会社情報 -> セキュリティタブに移動します。
   • Web サービス認証に"CData" を追加します。これは大文字・小文字が区別されます。これを行うには、会社 -> 会社情報（新しいUI では、設定 -> 会社）-> セキュリティ -> Web サービス認証 / 編集に移動します。
   Okta 認証についてはヘルプドキュメントを参照してください。

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

   
     jdbc/intacctdb
     javax.sql.DataSource
     Container
   
   

5. これで、java:comp/env/jdbc/intacctdb をルックアップして Sage Intacct にアクセスできます。

   InitialContext ctx = new InitialContext();
   DataSource myintacct = (DataSource)ctx.lookup("java:comp/env/jdbc/intacctdb");
   

Jetty 統合の詳細

上記のステップでは、シンプルな接続プールのシナリオでドライバーを設定する方法を説明しました。その他のユースケースや詳細については、Jetty ドキュメントのWorking with Jetty JNDI の章を参照してください。