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