IIS での新規ポートの作成およびデプロイメント

Microsoft Dynamics AX コネクターは、Dynamics AX アプリケーション内で作成されたサービスのうち、IIS マネージャー上でホストされるサービスのみを使用します。HTTP アダプターを使用して新規ポートを作成する必要があります。

HTTPS サービスのポートの作成

ポート作成のステップは以下のとおりです。
  1. Microsoft Dynamics AX 2012 アプリケーションを開き、「システム管理」フォームにアクセスします。
  2. 「サービスとアプリケーション統合フレームワーク (Service and Application Integration Framework)」にナビゲートし、「受信ポート」をクリックします。
  3. 「新規」ボタンをクリックします。
  4. 下記のフィールドに入力します。
    1. 「ポート名」 – ポートの固有の名前を入力します。
    2. 「アダプタ」として HTTP を選択します。
    3. URI に対しては、以下のようにします。
      1. ドロップダウンをクリックします。「Web サイトの選択」という小さいポップアップ・ウィンドウが表示されます。
      2. ドロップダウンをクリックし、HTTPS Web サイトを選択します。
      3. OK」をクリックします。
    4. 「構成」ボタン (「URI」ドロップダウンの上にあります) をクリックします。
      1. メッセージが表示された場合は、「はい」をクリックします。
      2. 「構成」セクションの下の「バインド」をクリックします。
      3. 構成セクションの下の「新しいバインド構成の作成 (Create New Binding Configuration)」リンクをクリックします。「新しいバインドの作成」ウィンドウが表示されます。
      4. リストから「basicHttpBinding」オプションをクリックします。
      5. 「OK」をクリックします。
      6. 作成した新しいバインディングを選択します。
      7. 「セキュリティ」タブで、モードのドロップダウン・リストからオプションを選択して、「モード」「トランスポート」を設定します。
      8. 「セキュリティ」セクションで、「トランスポート クライアントの資格情報の種類」にドロップダウン・リストから Ntlm を設定します。
      9. 構成セクションで、「サービス」ノードを展開します。
      10. そこに含まれるサービス・ノードを順番に展開して、「エンドポイント」ノードにアクセスします。
      11. 「エンドポイント」ノードを選択し、右クリックします。
      12. 「新しいサービス エンドポイント」オプションをクリックします。
      13. 新しいサービス・エンドポイント構成で、有効な名前を入力します。
      14. ステップ (iv) で作成した basicHttpBinding を選択します。
      15. バインディングに対して、ステップ (v) で作成した新しいバインディングを選択します。
      16. 「構成」セクションの下の「詳細設定」ノードを展開します。
      17. 「サービス動作」サブノードを展開します。
      18. 「routingServiceBehavior」サブノードを展開します。
      19. 「serviceMetaData」サブノードを選択します。
      20. 「HttpsGetEnabled」の値をデフォルト値の false から true に変更します。
      21. ウィンドウを閉じます。変更を保存するかどうかを確認するポップアップが表示されます。「はい」をクリックします。
    5. 「サービス契約カスタマイズ (Service contract customization)」の下で、「サービス操作」ボタンをクリックします。
      1. 呼び出すサービス操作を選択します。
      2. 「閉じる」をクリックします。
  5. メインメニューで「有効化する」ボタンをクリックし、ポートをアクティブ化します。
  6. ポートのアクティベーションが終了したら、WSDL URI をメモします。例: https://<hostname>:443/MicrosoftDynamicsAXAif60/FixedAssetTest/xppservice.svc
  7. URI に ?wsdl を追加して、ローカル・ブラウザーでこの URI にアクセスできるかどうかを確認します。

HTTP サービスのポートの作成

ポート作成のステップは以下のとおりです。
  1. Microsoft Dynamics AX 2012 アプリケーションを開き、「システム管理」フォームにアクセスします。
  2. 「サービスとアプリケーション統合フレームワーク (Service and Application Integration Framework)」にナビゲートし、「受信ポート」をクリックします。
  3. 「新規」ボタンをクリックします。
  4. 下記のフィールドに入力します。
    1. 「ポート名」 – ポートの固有の名前を入力します。
    2. 「アダプタ」として HTTP を選択します。
    3. URI に対しては、以下のようにします。
      1. ドロップダウンをクリックします。「Web サイトの選択」という小さいポップアップ・ウィンドウが表示されます。
      2. ドロップダウンをクリックし、HTTP Web サイトを選択します。
      3. OK」をクリックします。
    4. 「構成」ボタン (「URI」ドロップダウンの上にあります) をクリックします。
      1. メッセージが表示された場合は、「はい」をクリックします。
      2. 「バインド」を展開し、「basicHttpBinding」を選択します。
      3. 右側のパネルで、「セキュリティ」タブに移動します。「TransportClientCredentialType」Ntlm と設定します。
      4. ウィンドウを閉じます。変更を保存するかどうかを確認するポップアップが表示されます。「はい」をクリックします。
    5. 「サービス契約カスタマイズ (Service contract customization)」の下で、「サービス操作」ボタンをクリックします。
      1. 呼び出すサービス操作を選択します。
      2. 「閉じる」をクリックします。
  5. メインメニューで「有効化する」ボタンをクリックし、ポートをアクティブ化します。
  6. ポートのアクティベーションが終了したら、WSDL URI をメモします。例: http://<hostname>:8085/AXHttpAppPool/AssetConditionService/xppservice.svc
  7. URI に ?wsdl を追加して、ローカル・ブラウザーでこの URI にアクセスできるかどうかを確認します。

エンドポイント詳細

WSDL URI を http://<XYZ>:8085/AXHttpAppPool/AssetConditionService/xppservice.svc?wsdl とした場合、エンドポイント詳細は以下のようになります。
  • ホスト名: XYZ
  • ポート番号: 8085
  • アプリケーション・プール: AXHttpAppPool
  • ポート名: AssetConditionService

認証の詳細を追加します。

必要な場合、プロキシーの詳細を追加します。

HTTPS サービスの場合、「セキュリティー」パネルで詳細を追加します。

「WSDL のダウンロード/更新」ボタンをクリックします。エンドポイントから WSDL をダウンロードしたら、先に進んで、サービスを呼び出すことができます。