製品をチェック

Dynamics 365 Business Central Driver の30日間無償トライアルをダウンロード

 ダウンロードはこちら

製品の詳細

Dynamics 365 Business Central (NAV) アイコン Dynamics 365 Business Central JDBC Driver 相談したい

Items、Sales Orders、Purchase Orders などのDynamics 365 Business Central アカウントデータを組み込んだパワフルなJava アプリケーションを短時間・低コストで作成して配布できます。

JDBI からDynamics 365 Business Central データ のデータアクセスオブジェクトを作成

JDBI でDynamics 365 Business Central データ 用のSQL オブジェクトAPIを作成する方法を概説します。

加藤龍彦
ウェブデベロッパー

最終更新日:2022-05-25
d365businesscentral ロゴ

CData

jdbc ロゴ画像
JDBI ロゴ

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

JDBI は、Fluent スタイルとSQL オブジェクトスタイルという2つの異なるスタイルAPI を公開する、Java 用のSQL コンビニエンスライブラリです。CData JDBC Driver for D365BusinessCentral は、Java アプリケーションとリアルタイムDynamics 365 Business Central データ のデータ連携を実現します。これらの技術を組み合わせることによって、Dynamics 365 Business Central データ へのシンプルなコードアクセスが可能になります。ここでは、基本的なDAO(Data Access Object )とそれに付随するDynamics 365 Business Central データ の読み書きのためのコードの作成について説明します。

Dynamics 365 Business Central Accounts Entity のDAO を作成

以下のインターフェースは、実装されるSQL ステートメントごとに単一のメソッドを作成するためのSQL オブジェクトの正しい動作を宣言します。

public interface MyAccountsDAO { //insert new data into Dynamics 365 Business Central @SqlUpdate("INSERT INTO Accounts (Name, Name) values (:name, :name)") void insert(@Bind("name") String name, @Bind("name") String name); //request specific data from Dynamics 365 Business Central (String type is used for simplicity) @SqlQuery("SELECT Name FROM Accounts WHERE Name = :name") String findNameByName(@Bind("name") String name); /* * close with no args is used to close the connection */ void close(); }

Dynamics 365 Business Central への接続を開く

必要な接続プロパティを収集し、Dynamics 365 Business Central に接続するための適切なJDBC URL を作成します。

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

Dynamics 365 Business Central への認証には、User およびAccessKey プロパティが必要です。

データに接続するには、OrganizationUrl を指定します。OrganizationUrl は、 http://businesscentral.dynamics.com/abc123/ などのBusiness Central アカウントへのエンドポインであるか、Web サービスのルートを参照する必要があります。OrganizationUrl を指定する方法 および利用可能なエンドポイントについての詳細は、Business Central エンドポイント を参照してください。組織内に複数の会社がある場合は、どの会社に接続するかを特定するためにCompany を指定する必要があります。 会社が1つだけの場合は、Company を指定する必要はありません。

Dynamics 365 Business Central に認証するには、User およびAccessKey 接続プロパティを指定します。Microsoft では、これらをテストおよび開発目的で推奨します。ただし、運用環境での使用は推奨していません。User およびAccessKey の値を取得するには、Dynamics 365 Business Central の「ユーザー」ページに移動して「編集」をクリックします。User Name および Web Service Access Key の値は、User およびPassword 接続文字列プロパティとして入力する値です。User Name はE メールアドレス ではありません。短縮されたユーザー名です。

Microsoft では、OAuth 認証を使用する本番ユースケースを推奨します。詳細については、ヘルプドキュメントの「OAuth 認証の使用」を参照してください。

ビルトイン接続文字列デザイナー

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

java -jar cdata.jdbc.d365businesscentral.jar

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

Using the built-in connection string designer to generate a JDBC URL (Salesforce is shown.)

Dynamics 365 Business Central の接続文字列は、通常次のようになります。

jdbc:d365businesscentral:OrganizationUrl=https://myaccount.financials.dynamics.com/;

構成済みのJDBC URL を使用して、DAO インターフェースのインスタンスを取得します。以下に示す特定のメソッドはインスタンスにバインドされたハンドルを開くため、ハンドルとバインドされたJDBC 接続を開放するには、インスタンスを明示的に閉じる必要があります。

DBI dbi = new DBI("jdbc:d365businesscentral:OrganizationUrl=https://myaccount.financials.dynamics.com/;"); MyAccountsDAO dao = dbi.open(MyAccountsDAO.class); //do stuff with the DAO dao.close();

Dynamics 365 Business Central データ について

Dynamics 365 Business Central への接続を開いた状態で以前定義したメソッドを呼び出すだけで、Dynamics 365 Business Central のAccounts エンティティからデータを取得できます。

//disply the result of our 'find' method String name = dao.findNameByName("MyAccount"); System.out.println(name);

Dynamics 365 Business Central データ の書き方

以前定義した方法を使用すれば、Dynamics 365 Business Central にデータを書き込むことも簡単になります。

//add a new entry to the Accounts entity dao.insert(newName, newName);

JDBI ライブラリはJDBC 接続を処理できるため、CData JDBC Driver for D365BusinessCentral と統合することで、SQL Object API for D365BusinessCentral を簡単に作成できます。今すぐ無料トライアルをダウンロードし、Java アプリケーションでリアルタイムDynamics 365 Business Central を操作しましょう。

関連コンテンツ

トライアル・お問い合わせ

30日間無償トライアルで、CData のリアルタイムデータ連携をフルにお試しいただけます。記事や製品についてのご質問があればお気軽にお問い合わせください。