# mulesoft Microsoft Dynamics AX 2012 Connector (microsoft-dynamics-ax-connector) - Full Documentation # Microsoft Dynamics AX 2012 Connector Microsoft Dynamics AX 2012 Connector v2.0 Microsoft Dynamics AX 2012 用 Anypoint Connector (Dynamics AX 2012 Connector) を使用して、Mule アプリケーションは Microsoft Dynamics AX クエリサービスとやりとりすることができます。 このコネクタは次の操作をサポートしています。 - AOT テーブルに対してクエリを実行する。 - AOT 静的クエリを実行する。 - AIF ドキュメントサービスをコールする。 このコネクタは Microsoft Dynamics AX 2012 をサポートしています。 ## [](#始める前に)始める前に このコネクタを使用するには、以下に精通している必要があります。 - Microsoft Dynamics AX - Mule、Mule の概念、Mule フローの要素、グローバル要素 - Anypoint Connector - Anypoint Studio アプリケーションを作成する前に、以下が必要です。 - 対象リソースへの接続をテストするための Microsoft ログイン情報 - インストール済みの Anypoint Windows ゲートウェイサービス ソフトウェアの要件および互換性情報については、「コネクタリリースノート」を参照してください。 ## [](#pom-ファイル情報)POM ファイル情報 ```xml com.mulesoft.connectors mule-microsoft-dynamics-ax-connector x.x.x mule-plugin ``` `x.x.x`​ を使用しているコネクタに対応するバージョンに置き換えます。 最新の ​`pom.xml`​ ファイル情報を取得するには、​ [Anypoint Exchange](https://www.mulesoft.com/exchange/)​ でコネクタにアクセスし、​**\[Dependency Snippets (連動関係スニペット)\]**​ をクリックします。 ### [](#anypoint-platform-用の-windows-ゲートウェイサービス)Anypoint Platform 用の Windows ゲートウェイサービス Windows ゲートウェイサービスエージェントは、Dynamics AX システムサービスをコールしたときにプロトコル変換を実行します。 Dynamics AX システムサービス (メタデータサービス、クエリサービス) は net.tcp プロトコルを使用しますが、Java には実装されません。 このコネクタは要求を実行するために、下図のとおり、Windows ゲートウェイサービス経由で要求を転送します。 ![\[General (一般)\] タブの Microsoft Dynamics AX Connector の \[Global Elements Properties (グローバル要素プロパティ)\] 設定ウィンドウ](_images/ms-dynamics-ax-protocol-translation.png) 1. コネクタが HTTP 要求を Windows ゲートウェイサービスに送信します。 2. Windows ゲートウェイサービスが HTTP 要求を受け取ります。 3. Windows ゲートウェイサービスが、netTcp プロトコルを使用して、Dynamics AX システムサービスに対して要求を実行します。 4. Windows ゲートウェイサービスエージェントが、Dynamics AX システムサービスから応答を受け取ります。 5. Windows ゲートウェイサービスエージェントが、HTTP 経由で応答をコネクタに送信します。 6. コネクタが応答を受信します。 Anypoint Platform と Windows ゲートウェイサービス間の通信はすべて SSL によって認証され保護されます。 ## [](#anypoint-studio-7-での接続)Anypoint Studio 7 での接続 このコネクタを Anypoint Studio で使用するには、まず Exchange からダウンロードして必要に応じて設定します。 ## [](#studio-プロジェクトへのコネクタの追加)Studio プロジェクトへのコネクタの追加 Anypoint Studio には、Studio プロジェクトにコネクタを追加する 2 つの方法があります。Studio タスクバーの Exchange ボタンから追加するか、\[Mule Palette (Mule パレット)\] ビューから追加します。 ### [](#exchange-を使用してコネクタを追加する)Exchange を使用してコネクタを追加する 1. Studio で Mule プロジェクトを作成します。 2. Studio タスクバーの左上にある Exchange アイコン ​**(X)**​ をクリックします。 3. Exchange で、​**\[Login (ログイン)\]**​ をクリックし、Anypoint Platform のユーザー名とパスワードを指定します。 4. Exchange で、「ax」を検索します。 5. コネクタを選択して ​**\[Add to project (プロジェクトに追加)\]**​ をクリックします。 6. 画面の指示に従ってコネクタをインストールします。 ### [](#studio-でコネクタに追加する)Studio でコネクタに追加する 1. Studio で Mule プロジェクトを作成します。 2. \[Mule Palette (Mule パレット)\] ビューで、​**\[(X) Search in Exchange ((X) Exchange 内を検索)\]**​ をクリックします。 3. **\[Add Modules to Project (モジュールをプロジェクトに追加)\]**​ で、検索項目に「ax」と入力します。 4. **\[Available modules (使用可能なモジュール)\]**​ で、このコネクタの名前をクリックします。 5. **\[Add (追加)\]**​ をクリックします。 6. **\[Finish (完了)\]**​ をクリックします。 ### [](#studio-で設定する)Studio で設定する 1. コネクタの操作を Studio キャンバスにドラッグします。 ![「Query Table 操作」](/mulesoft/current/ja-jp/microsoft-dynamics-ax-connector/latest/_images/ms-dynamics-ax-component.png) 2. 一般設定で次の項目に入力します。 ![「\[Global Element Properties (グローバル要素プロパティ)\] の \[General (一般)\] 設定タブ」](_images/ms-dynamics-ax-any-config.png) - Company (会社): すべてのコール内で使用する会社を設定します。 - Language (言語): すべてのコール内で使用する言語を設定します。 - Log on as user (ユーザーとしてログオン): すべてのコール内で使用するユーザーを設定します。 - Message id (メッセージ ID): すべてのコール内で使用するメッセージ ID を設定します。 - Partition key (パーティションキー): すべてのコール内で使用するパーティションキーを設定します。 接続パラメーター:
パラメーター 説明

Username (ユーザー名)

Dynamics AX に接続するユーザー名。

Password (パスワード)

Dynamics AX に接続するためのパスワード。

AOS Server Name (AOS サーバー名)

アプリケーションオブジェクトサーバーを実行しているサーバーの名前または IP。

AOS Services WSDL Port (AOS サービス WSDL ポート)

サービス WSDL を実行するポート番号。デフォルトは、​8101​ です。

Gateway Router Service Url (ゲートウェイルーターサービス URL)

Windows ゲートウェイサービスのアドレス (ホストとポート)。このアドレスは通常 ​https://myserver.com:9333/router​ のようになります。
高度な接続の場合は、次の項目に入力します。 ![\[Advanced (詳細)\] タブの Microsoft Dynamics AX Connector の \[Global Elements Properties (グローバル要素プロパティ)\] 設定ウィンドウ](_images/ms-dynamics-ax-any-advanced-config.png) - AOS Endpoint Port (AOS エンドポイントポート) (省略可能) - この設定を使用して、サービスの WSDL ドキュメントにあるサービスエンドポイントを上書きします。 - Connect Timeout (接続タイムアウト) - コネクタ要求の接続タイムアウトの設定に使用します。この省略可能な値の単位はミリ秒です (無制限のタイムアウトは 0)。 - Receive timeout (受信タイムアウト) - コネクタ要求の受信タイムアウトの設定に使用します。この値はミリ秒単位で、省略可能です。 ## [](#ユースケース-query-table)ユースケース: Query Table 1. フローに HTTP リスナーを追加します。 2. 緑のプラス記号をクリックして設定します。 3. \[Host (ホスト)\] を「localhost」、\[Port (ポート)\] を「8080」に設定します。 4. \[OK\] をクリックします。 5. Microsoft Dynamics AX パレットから Query Table 操作を追加します。 6. 緑のプラス記号をクリックして接続を設定します。 7. 上記の項目を設定します。 8. \[Query (クエリ)\] パラメーターに「​`dsql:Select Name from ProjTable`​」と入力します。 9. \[Transform Message (メッセージの変換)\] を追加して、次のとおり設定します。 ```dataweave %dw 2.0 output application/json payload ``` 10. `localhost:8080`​ に対して curl を実行します。 ## [](#ユースケース-xml)ユースケース: XML ```xml #[payload] ``` ## [](#関連情報)関連情報 - [Windows Gateway Services Configuration Guide](https://docs.mulesoft.com/connectors/windows-gateway-services/windows-gateway-services-guide-mule4) - Run a query against an [AOT table](https://msdn.microsoft.com/EN-US/library/bb314725.aspx)​ (AOT テーブルに対するクエリの実行) - Run an [AOT static query](https://msdn.microsoft.com/en-us/library/bb394994.aspx)​ (AOT 静的クエリの実行) - Call an [AIF Document Service](https://technet.microsoft.com/EN-US/library/bb496530.aspx)​ (AIF ドキュメントサービスのコール) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Microsoft Dynamics AX 2012 Connector リファレンス Microsoft Dynamics AX 2012 Connector v2.0 リリースノート: [Microsoft Dynamics AX 2012 Connector リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/ms-dynamics-ax-connector-release-notes-mule-4) ## [](#デフォルト設定)デフォルト設定 ### [](#パラメーター)パラメーター
名前 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

x

Connection (接続)

Gateway Username Password (ゲートウェイユーザー名/パスワード)

この設定に指定できる接続種別。

x

Expiration Policy (有効期限ポリシー)

ExpirationPolicy

動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Runtime で期限切れに相当するとみなされます。これは、インスタンスが有効期限の対象となった瞬間にプラットフォームでそのインスタンスが期限切れになるということではありません。ランタイムによって適切と判断されたときに、インスタンスが実際にパージされます。
## [](#ゲートウェイユーザー名パスワード接続種別)ゲートウェイユーザー名/パスワード接続種別 ### [](#パラメーター-2)パラメーター
名前 型 説明 デフォルト値 必須

Disable SSL Certificate validation(SSL 証明書検証の無効化)

Boolean (ブール)

HTTPS 証明書を処理するとき、証明書に信頼するパートナーの署名がない場合、サーバーから例外が返されることがあります。これを防止するために、CN (一般名) チェックを無効にすることができます。注意: 本番環境では推奨されません。

false

Gateway Router Service Address (ゲートウェイルーターサービスアドレス)

String (文字列)

CRM インスタンスへの要求を転送するゲートウェイサービスのアドレス (​https://mygateway.com/router​)。

x

Aos Endpoint Port (AOS エンドポイントポート)

String (文字列)

サービスの WSDL で返されるポートを上書きします。

Connection Timeout (接続タイムアウト)

Number (数値)

コネクタ要求の接続タイムアウトの設定に使用します。この省略可能な値の単位はミリ秒です (無制限のタイムアウトは 0)。

Receive Timeout (受信タイムアウト)

Number (数値)

コネクタ要求の受信タイムアウトを設定するために使用します。この省略可能な値の単位はミリ秒です (無制限のタイムアウトは 0)。

Company (会社)

String (文字列)

すべてのコール内で使用する会社を設定します (この設定は「dynamicsax.callcontext.company」送信プロパティを使用して上書きできます)。

Language (言語)

String (文字列)

すべてのコール内で使用する言語を設定します (この設定は「dynamicsax.callcontext.language」送信プロパティを使用して上書きできます)。

Logon As User (ユーザーとしてログオン)

String (文字列)

すべてのコール内で使用するユーザーを設定します (この設定は「dynamicsax.callcontext.logonAsUser」送信プロパティを使用して上書きできます)。

Message Id (メッセージ ID)

String (文字列)

すべてのコール内で使用するメッセージ ID を設定します (この設定は「dynamicsax.callcontext.messageId」送信プロパティを使用して上書きできます)。

Partition Key (パーティションキー)

String (文字列)

すべてのコール内で使用するパーティションキーを設定します (この設定は「dynamicsax.callcontext.partitionKey」送信プロパティを使用して上書きできます)。

Username (ユーザー名)

String (文字列)

x

Password (パスワード)

String (文字列)

x

Aos Server Name (AOS サーバー名)

String (文字列)

アプリケーションオブジェクトサーバー (AOS) WSDL サーバー名。

x

Aos Wsdl Port (AOS WSDL ポート)

String (文字列)

アプリケーションオブジェクトサーバー (AOS) WSDL ポート。

x

Reconnection (再接続)

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。
## [](#関連操作)関連操作 - Invoke Document Service Operation - Query Table - Static Query ## [](#invoke-document-service-operation)Invoke Document Service Operation `` Document Service 操作を実行します。 ### [](#パラメーター-3)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Action Input (アクション入力)

Binary (バイナリ)

#[payload]

Streaming Strategy (ストリーミング戦略)

  • Repeatable In Memory Iterable Type (反復可能なメモリ内イテラブル種別)

  • Repeatable File Store Stream Type (反復可能なファイルストアストリーム種別)

反復可能なストリームとその動作を使用するよう設定します。

Service (サービス)

String (文字列)

サービスグループ名 (第 1 レベルのメタデータキー)。

x

Action (アクション)

String (文字列)

アクション名 (第 2 レベルのメタデータキー)。

x

Target Variable (対象変数)

String (文字列)

操作の出力が格納される変数の名前

Target Value (対象値)

String (文字列)

操作の出力に対して評価する式。その式の結果は対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

  • Reconnect (再接続)

  • Reconnect Forever (繰り返し再接続)

接続エラーが発生した場合の再試行戦略。
### [](#出力)出力

型

Binary (バイナリ)
### [](#次の設定の場合)次の設定の場合 - dynamics-ax-config ### [](#スロー)スロー - MICROSOFT-DYNAMICS-AX:CONNECTIVITY - MICROSOFT-DYNAMICS-AX:INVALID\_SESSION - MICROSOFT-DYNAMICS-AX:RETRY\_EXHAUSTED - MICROSOFT-DYNAMICS-AX:TRANSACTION - MICROSOFT-DYNAMICS-AX:TRANSFORMATION - MICROSOFT-DYNAMICS-AX:UNKNOWN - MICROSOFT-DYNAMICS-AX:VALIDATION ## [](#queryTable)Query Table `` 新規レコードを作成します。 ### [](#パラメーター-4)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Query (クエリ)

String (文字列)

x

Items Per Page (1 ページあたりの項目数)

Number (数値)

x

Streaming Strategy (ストリーミング戦略)

  • Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)

  • Repeatable File Store Iterable (反復可能なファイルストアイテラブル)

反復可能なストリームとその動作を使用するよう設定します。

Target Variable (対象変数)

String (文字列)

操作の出力が格納される変数の名前

Target Value (対象値)

String (文字列)

操作の出力に対して評価する式。その式の結果は対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

  • Reconnect (再接続)

  • Reconnect Forever (繰り返し再接続)

接続エラーが発生した場合の再試行戦略。
### [](#出力-2)出力

型

Array of Object (オブジェクトの配列)
### [](#次の設定の場合-2)次の設定の場合 - dynamics-ax-config ### [](#スロー-2)スロー - MICROSOFT-DYNAMICS-AX:CONNECTIVITY - MICROSOFT-DYNAMICS-AX:INVALID\_SESSION - MICROSOFT-DYNAMICS-AX:TRANSACTION - MICROSOFT-DYNAMICS-AX:TRANSFORMATION - MICROSOFT-DYNAMICS-AX:UNKNOWN - MICROSOFT-DYNAMICS-AX:VALIDATION ## [](#staticQuery)Static Query `` ### [](#パラメーター-5)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Static Query Name (静的クエリ名)

String (文字列)

x

Ranges (範囲)

Object (オブジェクト)

#[payload]

Items Per Page (1 ページあたりの項目数)

Number (数値)

Streaming Strategy (ストリーミング戦略)

  • Repeatable In Memory Stream (反復可能なメモリ内ストリーム)

  • Repeatable File Store Iterable (反復可能なファイルストアイテラブル)

反復可能なストリームとその動作を使用するよう設定します。

Target Variable (対象変数)

String (文字列)

操作の出力が格納される変数の名前

Target Value (対象値)

String (文字列)

操作の出力に対して評価する式。その式の結果は対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

  • Reconnect (再接続)

  • Reconnect Forever (繰り返し再接続)

接続エラーが発生した場合の再試行戦略。
### [](#出力-3)出力

型

Array of Object (オブジェクトの配列)
### [](#次の設定の場合-3)次の設定の場合 - dynamics-ax-config ### [](#スロー-3)スロー - MICROSOFT-DYNAMICS-AX:CONNECTIVITY - MICROSOFT-DYNAMICS-AX:INVALID\_SESSION - MICROSOFT-DYNAMICS-AX:TRANSACTION - MICROSOFT-DYNAMICS-AX:TRANSFORMATION - MICROSOFT-DYNAMICS-AX:UNKNOWN - MICROSOFT-DYNAMICS-AX:VALIDATION ## [](#reconnection-再接続-型)Reconnection (再接続) 型
項目 型 説明 デフォルト値 必須

Fails Deployment (デプロイメントに失敗)

Boolean (ブール)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

Reconnection Strategy (再接続戦略)

  • Reconnect (再接続)

  • Reconnect Forever (繰り返し再接続)

使用する再接続戦略。
### [](#reconnect)Reconnect (再接続)
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

Count (数)

Number (数値)

再接続の試行回数。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true
### [](#reconnect-forever)Reconnect Forever (繰り返し再接続)
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true
## [](#ExpirationPolicy)Expiration Policy (有効期限ポリシー) 型
項目 型 説明 デフォルト値 必須

Max Idle Time (最大アイドル時間)

Number (数値)

有効期限の対象とみなされるまで、動的設定インスタンスがアイドル状態を維持できる最大時間のスカラー時間値

Time Unit (時間単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

maxIdleTime 属性の時間単位
## [](#repeatable-in-memory-stream)Repeatable In Memory Stream Type (反復可能なメモリ内ストリーム種別)
項目 型 説明 デフォルト値 必須

Initial Buffer Size (初期バッファサイズ)

Number (数値)

これは、ストリームをコンシュームし、ストリームへのランダムアクセスを提供する目的で割り当てられるメモリの容量です。ストリームに含まれているデータがこのバッファに適合できる量を超えている場合、bufferSizeIncrement 属性に従って拡張され、上限は maxInMemorySize となります。

Buffer Size Increment (バッファサイズ増分)

Number (数値)

バッファサイズが初期サイズを超えた場合に、どれくらい拡張されるか。値を 0 以下に設定すると、バッファが拡張されません。つまり、バッファがフルになると、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。

Max Buffer Size (最大バッファサイズ)

Number (数値)

使用するメモリの最大量。これを超えると、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。0 以下の値は無制限を意味します。

Buffer Unit (バッファ単位)

Enumeration (列挙)。次のいずれかになります。

  • BYTE (バイト)

  • KB

  • MB

  • GB

これらのすべての属性の単位
## [](#repeatable-file-store-stream)Repeatable File Store Stream Type (反復可能なファイルストアストリーム種別)
項目 型 説明 デフォルト値 必須

Max In Memory Size (最大メモリ内サイズ)

Number (数値)

データをメモリ内に保持するためにストリームで使用する最大メモリを定義します。これを超えると、ディスクへのコンテンツのバッファが開始されます。

Buffer Unit (バッファ単位)

Enumeration (列挙)。次のいずれかになります。

  • BYTE (バイト)

  • KB

  • MB

  • GB

maxInMemorySize で表される単位
## [](#repeatable-in-memory-iterable)Repeatable In Memory Iterable Type (反復可能なメモリ内イテラブル種別)
項目 型 説明 デフォルト値 必須

Initial Buffer Size (初期バッファサイズ)

Number (数値)

ストリームをコンシュームし、ストリームへのランダムアクセスを提供するために最初にメモリ内に保持できるインスタンスの数。ストリームのデータ量がこのバッファサイズを超える場合は、bufferSizeIncrement 属性に従って、maxInMemorySize を上限としてバッファが拡張されます。デフォルト値は 100 インスタンスです。

Buffer Size Increment (バッファサイズ増分)

Number (数値)

バッファサイズが初期サイズを超えた場合に、どれだけ拡張するか。値を 0 以下に設定すると、バッファが拡張されず、バッファがフルになると、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。デフォルト値は 100 インスタンスです。

Max Buffer Size (最大バッファサイズ)

Number (数値)

使用するメモリの最大量。これを超えると、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。0 以下の値は無制限を意味します。
## [](#repeatable-file-store-iterable)Repeatable File Store Iterable (反復可能なファイルストアイテラブル) 型
項目 型 説明 デフォルト値 必須

Max In Memory Size (最大メモリ内サイズ)

Number (数値)

メモリ内に保持されるインスタンスの最大量。これ以上の量が必要な場合、コンテンツはディスク上にバッファされます。

Buffer Unit (バッファ単位)

Enumeration (列挙)。次のいずれかになります。

  • BYTE (バイト)

  • KB

  • MB

  • GB

maxInMemorySize で表される単位
## [](#関連情報)関連情報 [MuleSoft ヘルプセンター](https://help.mulesoft.com)