Salesforce Docs Portal

AS2 Connector のバージョン 6.x へのアップグレードおよび移行

新しい機能を利用するには、AS2 用 Anypoint Connector (AS2 Connector) をバージョン 5.x からバージョン 6.x にアップグレードします。

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

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

5.x

6.x

変更

6.1

[Transfer Mode Configuration (転送モード設定)]​ パラメーターが ​Send Config​ クラスに追加され、​Send​ 操作を使用するときにデータのチャンク転送を有効または無効にできるようになりました。

6.1

AS2 Connector 6.1 には、次の変更が含まれています。

  • 送信メッセージと受信メッセージのデジタル署名ありコピーおよびそれに対応する受信確認は、AS2 Connector の操作とソースで設定および有効化されている限り、非否認目的で保存できます。

  • 新しい Mule ソース ​Non repudiation listener​ は、ユーザー定義の永続化戦略を介して、AS2 Connector の操作とソースによって提供される非否認情報を永続化するようにユーザー設定されている必要があります。

  • 特定の属性オブジェクト項目の名前が変更され、非推奨の項目が削除されました。
    これらの変更の概要は、​「アップグレード手順」​を参照してください。

要件

移行する前に、次の要件を満たしていることを確認します。

  • Mule 4.3.0 以降

  • Java 8

アップグレード手順

次の手順に従って、AS2 バージョン 6.x へのアップグレードを実行します。

  1. Exchange から AS2 Connector 6.x.x をダウンロードします。

  2. アップグレードする Mule フローに適切なソースまたは操作を配置します。

AS2 Listener および AS2 MDN Listener の変更

AS2 Listener および AS2 MDN Listener を使用または設定する方法は変更されていません。

Send with Sync MDN および Send with Async MDN 操作の変更

Send with Sync MDN​ および ​Send with Async MDN​ 操作には、次の変更があります。

  • バージョン 6.1.0 で、​com.mulesoft.connector.as2.api.AS2MdnAttributes​ 型の属性オブジェクトが変更されました。
    項目 ​com.mulesoft.connector.as2.api.AS2SendAttributes.as2MdnAttributes​ は ​com.mulesoft.connector.as2.api.AS2MdnAttributes​ 型です。

  • MultiMap ​dispositionContent​ は、MDN の配置通知部分の情報をパラメーターに分割する、​DispositionNotification​ というオブジェクトに変換されます。
    DispositionNotification​ は、​DispositionNotificationReport​ オブジェクト内にあります。

これらの属性を使用している Mule フローを適宜修正します。

AS2 MDN 属性の変更

5.x 項目名 6.x 項目名 5.x 型 6.x 型

dispositionContent

dispositionContent

MultiMap<String, String>

DispositionNotificationReport

mdnMic

DispositionNotificationReport.DispositionNotification.receivedContentMic

String (文字列)

String (文字列)

mdnMicAlg

DispositionNotificationReport.DispositionNotification.receivedContentMicAlgorithm

HashAlgorithm

HashAlgorithm

mdnProcessed

DispositionNotificationReport.DispositionNotification.dispositionType

boolean (ブール)

String (文字列)

originalAS2MessageId

DispositionNotificationReport.DispositionNotification.originalMessageID

String (文字列)

String (文字列)

reportText

項目を削除

String (文字列)

項目を削除

アップグレード後の手順

アップグレードの手順を実行したら、次の手順に従ってアップグレードを完了します。

  1. 起動時に例外がないことを確認してコネクタが機能していることを確認し、AS2 パートナーに対してテストします。

  2. 使用している HTTP Listener に対応する新しい URL (ポート) 設定をパートナーに通知します。

トラブルシューティング

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

アップグレードの復元

以前のバージョンの as2MdnAttributes Connector に戻す必要がある場合、プロジェクトの ​pom.xml​ ファイルの ​as2-connector​ 連動関係バージョンを前のバージョンに変更します。

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

関連情報