1. ホームページ
  2. AS2 Connector

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

All Connectors

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

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

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

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

5.x

6.x

変更

6.3

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

  • 複数のパートナーからメッセージを受信する 1 つの AS2 リスナーエンドポイントを設定できるようになりました。

    この機能を実装するために、​[Partners (パートナー)]​ という新しいタブが ​[As 2 listener]​ および ​[As 2 mdn listener]​ グローバル要素に追加されました。このタブには、​[General (一般)]​ タブの ​[Partner Config (パートナー設定)]​ セクションから移動された項目といくつかの新しい項目が含まれます。

    [Listener Mode (リスナーモード)]​ 項目の値によって、リスナーがメッセージを 1 つのパートナーからのみ受信できるか (​[Dedicated Mode (専用モード)]​)、複数のパートナーから受信できるか (​[Shared mode (共有モード)]​) が決まります。

  • Send with Sync MDN​ および ​Send with Async MDN​ 操作を設定するときに、新しい ​[Custom headers (カスタムヘッダー)]​ 項目を使用してアウトバウンド AS2 メッセージでカスタムヘッダーを渡すことができるようになりました。

詳細は、​「AS2 Connector リファレンス」​および​「AS2 Connector の例」​の各トピックを参照してください。

6.2

AS2 Connector 6.2 には、次の新規項目が含まれています。

  • Custom Message ID (カスタムメッセージ ID)​: AS2 ​Send​ 操作のカスタムメッセージ ID を指定できます。

  • Propagate Content Transfer Encoding (コンテンツ転送エンコードを伝播)​: パートナーに送信する AS2 メッセージでコンテンツ転送エンコードを伝播するかどうかを定義できます。

この両方の項目は ​[General (一般)]​ タブにあります。

6.1

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

[Transfer Mode Configuration (転送モード設定)]​ 項目が ​Send Config​ クラスに追加され、​Send​ 操作を使用するときにデータのチャンク転送を有効または無効にできるようになりました。 * 送信メッセージと受信メッセージのデジタル署名付きコピーおよびそれに対応する受信確認は、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​ ファイルを更新する必要があります。

関連情報