.msgmap ファイルから .map ファイルへの メッセージ・マップ の変換

レガシー メッセージ・マップ (.msgmap 形式) をデプロイまたは変更する前に、それらを グラフィカル・データ・マップ (.map 形式) に変換する必要があります。

始める前に

レガシー・メッセージ・マップを変換する前に、以下のステップを実行します。

  1. WebSphere® Message Brokerからリソースをインポートします。 詳しくは、 旧バージョンのリソースのインポートを参照してください。 あるいは、ツールキットの開発リソースを移行できます。 詳しくは、 開発リソースのマイグレーションを参照してください。
  2. レガシー・メッセージ・マップ によって使用されるリソースを含むすべてのプロジェクトがワークスペースで使用可能であること、およびプロジェクト依存関係が定義されていることを確認します。
  3. レガシー・メッセージ・マップから変換されたメッセージ・マップでの動作の変更 および メッセージ・セットでモデル化されたメッセージのマッピングに関する考慮事項を確認してください。

このタスクの概要

IBM App Connect Enterprise では、 レガシー・メッセージ・マップ.msgmap フォーマット)を展開または変更するには、まずそれをグラフィカル・データ・マップ.map フォーマット)に変換する必要があります。 IBM App Connect Enterprise では、 グラフィカルデータマップメッセージマップと呼ばれています。

注: 変換プロセスは元に戻すことができません。 ただし、 レガシー・メッセージ・マップ の変換は複数回実行できます。 変換されたマップ名から _backup を削除して、変換された レガシー・メッセージ・マップ の名前を変更する必要があります。

変換された レガシー・メッセージ・マップメッセージ・フローで使用するには、レガシー Mapping ノードを新しい Mapping ノードに置き換える必要があります。 詳しくは、 既存の Mapping ノードの置換を参照してください。

手順

IBM App Connect Enterprise ツールキットを使用して、 レガシーメッセージマップメッセージマップに変換するには、以下の手順を実行してください:

  1. 変換プロセスを開始します。 「アプリケーション開発」 ビューで、変換する メッセージ・マップ を右クリックし、 「.msgmap から .map へのメッセージ・マップの変換」をクリックします。

    複数の レガシー・メッセージ・マップを変換するには、1 つ以上のマップが含まれているフォルダー、プロジェクト、アプリケーション、またはライブラリーを右クリックし、 「.msgmap から .map へのメッセージ・マップの変換」をクリックします。

    • 変換された メッセージ・マップ が作成され、 「アプリケーション開発」 ビューに表示されます。
    • レガシー・メッセージ・マップ の名前が MessageMapName.msgmap_backupに変更され、 「アプリケーション開発」 ビューに表示されます。
  2. 変換されたマップを グラフィカル・データ・マッピング・エディターで開きます。 「アプリケーション開発」 ビューで、新しい メッセージ・マップをダブルクリックします。

    グラフィカル・データ・マッピング・エディターメッセージ・マップ が開きます。

  3. 変換プロセスによって作成された変換ロジックを検討し、使用するアプリケーションに対して正しい出力が生成されることを確認します。
    1. Task 変換を確認して置換します。 詳しくは、 変換されたレガシー・メッセージ・マップでの変換エラーの管理を参照してください。

      レガシー・メッセージ・マップ に、変換プロセスで再作成できなかった複雑なマッピング構造が含まれている場合、 メッセージ・マップ には、それらの構造を手動で再作成するのに役立つ Task 変換が含まれています。

      Task 変換は、「問題」ビューにリストされます。

    2. マップ内の変換に関連付けられているすべての変換アノテーション・アイコン () を確認します。 詳しくは、 変換されたレガシー・メッセージ・マップに関する変換警告の管理を参照してください。

      変換アノテーション・アイコンは、 グラフィカル・データ・マッピング・エディターで変換の左下に表示されます。

      シングルクリックで、変換されたマップ内のすべての変換を受諾または拒否できます。

結果

レガシー・メッセージ・マップは、デプロイ可能な メッセージ・マップ に変換されます。これは、 グラフィカル・データ・マッピング・エディターを使用して変更できます。

次のタスク

新しい Mapping ノードが新しい メッセージ・マップを参照するように、 レガシー・メッセージ・マップ を参照する各 メッセージ・フロー を変更します。 詳しくは、 既存の Mapping ノードの置換を参照してください。