JBoss のコネクションプールから Dynamics 365 のデータ に接続

CData JDBC Driver は、コネクションプーリングの標準手順に従ってJBoss で設定できます。本記事では、JBoss アプリケーションのコネクションプールから Dynamics 365 のデータ にアクセスする方法を解説します。JBoss 管理インターフェースを使用して CData JDBC Driver for Dynamics 365 を設定し、コネクションプールから Dynamics 365 のデータ にアクセスします。

はじめに

---

管理コンソールから Dynamics 365 用のJDBC データソースを作成

以下の手順に従って、ドライバーJAR を追加し、必要な接続プロパティを定義します。

1. Runtime メニューで、管理ドメインにデプロイするかスタンドアロンサーバーにデプロイするかに応じて、Domain またはServer メニューを選択し、「Manage deployments」をクリックしてDeployments ページを開きます。
2. Add をクリックします。表示されるウィザードで、インストールディレクトリのlib サブフォルダにあるドライバーのJAR ファイルとライセンスを追加します。デフォルト設定でウィザードを完了し、ドライバーを選択してEnable をクリックします。
3. Configuration メニューで、Subsystems -> Connector -> Datasources をクリックします。JDBC Datasources ページが開きます。
4. Add をクリックし、表示されるウィザードでドライバーの名前とJNDI 名を入力します。例：

   java:jboss/root/jdbc/Dynamics365

5. 上記で追加したドライバーを選択します。

6. JDBC URL とユーザー名、パスワードを入力します。JDBC URL の構文は、jdbc:dynamics365: の後にセミコロン区切りの接続プロパティを記述します。

   Dynamics 365 接続プロパティの取得・設定方法

   Microsoft Dynamics 365 への接続

   Microsoft Dynamics 365 ドライバーは、以下のMicrosoft Dynamics 365 エディションへの接続をサポートしています。

   • CustomerService
   • FieldService
   • FinOpsOnline （デフォルト）
   • FinOpsOnPremise
   • HumanResources
   • Marketing
   • ProjectOperations
   • Sales

   Notes：

   • Supply Chain Management はFinance and Operations と同一です。これらのいずれかに接続するには、Edition をFinOpsOnline またはFinOpsOnPremise のいずれかに設定します。
   • Microsoft Dynamics 365 Business Central については、個別のMicrosoft Dynamics 365 Business Central ドライバーを使用してください。
   サポートされているMicrosoft Dynamics 365 エディションのいずれか接続するには、次のパラメータを設定します。
   • OrganizationURL：お使いのMicrosoft Dynamics 365 組織のURL。例えば、https://orgcb42e1d0.crm.dynamics.com。
   • Edition：上記のエディション一覧に示すとおり。

   Microsoft Dynamics 365 への認証

   Microsoft Dynamics 365 は、Microsoft Entra ID（Azure AD）、Azure サービスプリンシパル、Azure マネージドID（MSI）を経由する認証をサポートします。これらはすべてOAuth 規格に基づきます。 認証方法の詳細は、ヘルプドキュメントを参照してください。

   組み込みの接続文字列デザイナー

   JDBC URL の作成には、Dynamics 365 JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインからJAR ファイルを実行します。

   java -jar cdata.jdbc.dynamics365.jar
   

   接続プロパティを入力し、接続文字列をクリップボードにコピーします。

   

   一般的な接続文字列は次のとおりです。

   jdbc:dynamics365:OrganizationUrl=https://myaccount.operations.dynamics.com/;Edition=Sales;
   

7. 接続をテストしてウィザードを完了します。Dynamics 365 データソースを選択し、Enable をクリックします。

JBoss のその他の統合

上記の手順は、シンプルなコネクションプーリングシナリオでドライバーを設定する方法を示しています。詳細については、JBoss EAP ドキュメントのData Source Management の章を参照してください。