Microsoft Dynamics NAV Connector のバージョン 3.0 へのアップグレードおよび移行

Microsoft Dynamics NAV Connector 用 Anypoint Connector をバージョン 3.x にアップグレードします。

サポートされているアップグレードパス

開始バージョン 終了バージョン

2.x

3.x

このリリースでの変更

CloudHub 2.0 で Microsoft Dynamics NAV Connector をサポートするには、クライアントは Plain Old Java Objects (POJO) を使用する代わりに未加工の XML 形式で SOAP 要求を提供する必要があります。

次の手順に従って、SOAP 要求を未加工の XML 形式で送受信します。

  1. Mule 4.6.6 以降などの前提条件があることを確認し、WSDL ファイルを取得します。

  2. Microsoft Dynamics NAV SOAP 操作を使用するすべての Mule フローを特定します。

  3. リクエストボディでは、コンテンツタイプを ​application/xml​ に更新し、SOAP 要求を POJO を使用せずに未加工の XML 形式で提供します。

    Page Operation の設定

    SOAP 要求を直接送信するための XML:

    <item:Read xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:item="urn:microsoft-dynamics-schemas/page/item_card">
          <item:No>1000</item:No>
       </item:Read>
    Page Operation の Transform message

    DataWeave 変換メソッドを使用して JSON を XML ペイロードに変換するための XML:

    <ee:transform doc:name="Transform Message" doc:id="52c376d8-70de-44b3-b388-4837f0790795">
           <ee:message>
               <ee:set-payload><![CDATA[%dw 2.0
       output application/xml
       ---
       {
           Read @("xmlns": "urn:microsoft-dynamics-schemas/page/item_card"): {
               No: 1000
           }
       }]]></ee:set-payload>
           </ee:message>
       </ee:transform>
  4. レスポンスボディでは、SOAP 応答を未加工の XML 形式で受信するため、その応答を必要に応じて処理する必要があります。

    SOAP 応答 の XML:

    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:item="urn:microsoft-dynamics-schemas/page/item_card">
       <soapenv:Header/>
       <soapenv:Body>
          <item:Read_Result>
             <item:Item>
                <item:No>Returned_1000</item:No>
                <item:Description>Returned_Awesome_Product</item:Description>
                <item:UnitPrice>100.00</item:UnitPrice>
             </item:Item>
          </item:Read_Result>
       </soapenv:Body>
    </soapenv:Envelope>

    DataWeave メソッドを使用して XML ペイロードを変換するための XML:

    <ee:transform doc:name="Transform Response">
        <ee:message>
            <ee:set-payload><![CDATA[%dw 2.0
    output application/java
    ns soapenv http://schemas.xmlsoap.org/soap/envelope/
    ns item urn:microsoft-dynamics-schemas/page/item_card
    ---
    payload.soapenv#Envelope.soapenv#Body.item#Read_Result.item#Item
    ]]></ee:set-payload>
        </ee:message>
    </ee:transform>

アップグレード前提条件

アップグレードを実行する前に、復元する必要がある場合に備えて、ファイル、データ、および設定のバックアップを作成する必要があります。

アップグレード手順

以下の手順でアップグレードを実行します。

  1. Anypoint Studio で、Mule プロジェクトを作成します。

  2. [Mule Palette (Mule パレット)]​ ビューで、​[Search in Exchange (Exchange 内を検索)]​ をクリックします。

  3. [Add Dependencies to Project (連動関係をプロジェクトに追加)]​ で、検索項目に「​dynamics nav​」と入力します。

  4. [Available modules (使用可能なモジュール)]​ で、​[Microsoft Dynamics NAV]​ を選択して ​[Add (追加)]​ をクリックします。

  5. [Finish (完了)]​ をクリックします。

  6. Mule プロジェクトの ​pom.xml​ ファイルで Microsoft Dynamics NAV Connector の連動関係のバージョンが ​3.0.0​ であることを確認します。

Studio はコネクタを自動的にアップグレードします。

アップグレードを確認する

コネクタの最新バージョンをインストールしたら、次の手順に従ってアップグレードを確認します。

  1. Studio の ​[Problems (問題)]​ または ​[Console (コンソール)]​ ビューでエラーがないことを確認します。

  2. プロジェクトの ​pom.xml​ ファイルに問題がないことを確認します。

  3. 接続をテストして、操作が機能することを確認します。

トラブルシューティング

パラメーターのキャッシュおよびメタデータのキャッシュで問題がある場合、Anypoint Studio の再起動をお試しください。

アップグレードの復元

前のバージョンの Microsoft Dynamics NAV Connector に戻す必要がある場合、プロジェクトの ​pom.xml​ で ​ms-dynamics-nav-connector​ 連動関係バージョン ​3.0.0​ を前のバージョンに変更します。

Anypoint Studio でプロジェクトの ​pom.xml​ を更新する必要があります。