エクスポートまたはインポートの変換およびそのバインディングを実行するには、トランスポート固有の IBM® Integration Bus メッセージ・フロー・ノードの Passthrough ノードを置き換え、メッセージ・ドメインを構成して、使用するデータ・パーサーを指定する必要があります。さらに、機能セレクターおよび障害処理を手動で実装する必要があります。
始める前に:
IBM Integration Bus のご使用のバージョンのメッセージ・フロー・ノードの使用に適用される制約事項を確認してください。詳しくは、各動作モードに適用される制約事項を参照してください。
IBM Integration Bus で、メッセージ・フロー・ノードを使用してエクスポートまたはインポートおよびそのバインディングを再作成します。データを直列化または非直列化するために使用するパーサーを指定するには、「メッセージ・ドメイン」プロパティーを構成します。障害を処理するには、ノードの Fault ターミナルに接続し、そのロジックを実装します。
エクスポートの場合のみ、WebSphere® Enterprise Service Bus メディエーション・モジュールをアプリケーションに変換するときに、機能セレクターを手動で実装する必要があります。
WebSphere Enterprise Service Bus コールアウト・メディエーション・プリミティブによって参照されるエクスポートまたはインポートの変換をそのバインディングとともにファイナライズするには、以下の手順を実行します。
- 「結果の確認」ビューで、「次の実装クラスがあるバインディングを手動で変換してください: ''{0}''。(Manually convert the binding that has the following implementation class: ''{0}''.)」という予定メッセージをダブルクリックします。
メッセージ・フロー・エディターがメッセージ・フローを開いて、WebSphere Enterprise Service Bus メディエーション・モジュールのエクスポートおよびインポートに対して作成したプレースホルダーを表示します。
- エクスポートまたはインポートの Passthrough ノードを識別します。
Passthrough ノードの名前は、メディエーション・モジュールのエクスポートまたはインポートにちなんだものです。要求/応答操作での応答を表すエクスポート・プレースホルダー・ノードの場合、プレースホルダー・ノードの末尾は _Reply になります。
- エクスポートまたはインポートのバインディング構成を再作成するために、IBM Integration Bus で使用する必要のあるメッセージ・フロー・ノードを識別します。IBM Integration Bus メッセージ・フロー・ノードについて詳しくは、組み込みノードを参照してください。
- 1 つ以上の片方向操作を定義するインターフェースを使用したエクスポートでは、1 つのInput メッセージ・フロー・ノードを識別する必要があります。例えば、WebSphere Enterprise Service Bus でのエクスポートに関連付けられたトランスポートのタイプが MQ バインディングである場合、MQInput ノードを使用してエクスポートを再作成します。
- 少なくとも 1 つの要求/応答操作を定義するインターフェースを使用したエクスポートでは、1 つの Input メッセージ・フロー・ノードと 1 つの応答メッセージ・フロー・ノードを識別する必要があります。例えば、WebSphere Enterprise Service Bus でのエクスポートに関連付けられたトランスポートのタイプが MQ バインディングである場合、MQInput ノードと MQReply ノードを使用してエクスポートを再作成します。
- 同期対話を定義するインポートでは、同期要求および応答対話を処理する 1 つのメッセージ・フロー・ノードを識別する必要があります。例えば、WebSphere Enterprise Service Bus でのインポートに関連付けられたトランスポートのタイプが HTTP バインディングである場合、HTTPRequest ノードを使用してインポートを再作成します。
- 非同期対話を定義するインポートでは、非同期に要求を処理する 1 つのメッセージ・フロー・ノード、および非同期に応答を処理する 1 つのメッセージ・フロー・ノードを識別する必要があります。例えば、WebSphere Enterprise Service Bus でのインポートに関連付けられたトランスポートのタイプが HTTP バインディングである場合、HTTPAsyncRequest ノードと HTTPAsyncResponse ノードを使用してインポートを再作成します。
- 前の手順で識別したメッセージ・フロー・ノード をメッセージ・フローにドラッグ・アンド・ドロップして、それらを構成します。
- エクスポートの場合、以下の手順を順番に実行します。
- エクスポートのために識別した Input ノードをドラッグ・アンド・ドロップします。
- Passthrough ノードを削除します。このノードは、エクスポートにちなんだ名前のノードです。
- 次のようにしてInput ノードの名前を変更します。ノードを選択します。「プロパティー」ビューで「説明」を選択します。「ノード名」プロパティーを編集して、エクスポートの名前を入力します。
- メッセージ・ドメインを構成します。「プロパティー」ビューで「入力メッセージの構文解析」を選択します。メッセージ・ドメインを選択して、「メッセージ・ドメイン」プロパティーを構成します。詳しくは、パーサーを参照してください。
- 他のノードのプロパティーを構成します。
- RouteToLabel ノードをドラッグ・アンド・ドロップして、メッセージがメッセージ・フローでとる経路をその内容に基づいて動的に決定します。
- オプション: エクスポートに 1 つの操作のインターフェースがある場合、Input ノードの出力ターミナルを RouteToLabel ノードの入力ターミナルに接続します。
- オプション: エクスポートに複数の操作のインターフェースがある場合、機能セレクターのロジックを実装する必要があります。
- JavaCompute ノード、Compute ノード、または Mapping ノードをドラッグ・アンド・ドロップします。
- Input ノードの出力ターミナルを JavaCompute ノード、Compute ノード、または Mapping ノードの入力ターミナルに接続します。
- エクスポートに関連付けられた機能セレクター・ロジックを実装します。
- JavaCompute ノード、Compute ノード、または Mapping ノードの出力ターミナルを RouteToLabel ノードの入力ターミナルに接続します。
- YourExportName_Reply (YourExportName はエクスポートの名前) という名前の Passthrough ノードがある場合、前の手順で識別した応答ノードをドラッグ・アンド・ドロップして、Passthrough ノードを置き換えます。
- 次のようにして、応答ノードの名前を変更します。ノードを選択します。「プロパティー」ビューで「説明」を選択します。「ノード名」プロパティーを編集して、YourExportName_Reply と入力します。ここで、YourExportName はエクスポートの名前です。
- 他のノードのプロパティーを構成します。
- 操作サブフローの出力ターミナルを応答ノードの入力ターミナルに接続します。
- 障害バインディング・ロジックを実装します。エラーや例外を処理する方法を理解するために使用可能なノードに関する情報を確認します。例えば、MQInput エラーを処理する方法を理解するには、MQInput エラーの処理を参照してください。
- 変更を保存します。
- 同期対話を定義するインポートの場合、以下の手順を順番に実行します。
- インポートのために識別したノードをドラッグ・アンド・ドロップします。
- Passthrough ノードを削除します。このノードは、インポートにちなんだ名前のノードです。
- Passthrough ノードを接続したのと同じ方法で、ノードを接続します。
- 次のようにして、ノードの名前を変更します。ノードを選択します。「プロパティー」ビューで「説明」を選択します。「ノード名」プロパティーを編集して、インポートの名前を入力します。
- 応答メッセージを構文解析するために使用するメッセージ・ドメインを構成します。「プロパティー」ビューで「応答メッセージの構文解析」を選択します。メッセージ・ドメインを選択して、「メッセージ・ドメイン」プロパティーを構成します。詳しくは、パーサーを参照してください。
- 他のノードのプロパティーを構成します。
- 障害バインディング・ロジックを実装します。エラーや例外を処理する方法を理解するために使用可能なノードに関する情報を確認します。
- 変更を保存します。
- 非同期対話を定義するインポートの場合、以下の手順を順番に実行します。
- インポートのために識別した非同期要求ノードをドラッグ・アンド・ドロップします。
- Passthrough ノードを削除します。このノードは、インポートにちなんだ名前のノードです。
- Passthrough ノードを接続したのと同じ方法で、非同期要求ノードを接続します。非同期要求ノードのみの入力ターミナルを接続します。
- 次のようにして、ノードの名前を変更します。ノードを選択します。「プロパティー」ビューで「説明」を選択します。「ノード名」プロパティーを編集して、インポートの名前を入力します。
- 他のノードのプロパティーを構成します。
- 非同期応答が要求に相関される方法に応じて、非同期要求ノードを追加した同じメッセージ・フロー、または新規メッセージ・フローに、非同期応答ノードをドラッグ・アンド・ドロップできます。
- 要求および応答のノードが同じメッセージ・フローに存在する場合、IBM Integration Bus が要求への応答の相関を処理します。
- 新規メッセージ・フローを作成する場合、要求および応答の相関を手動で実装する必要があります。
- 非同期応答ノードで、応答メッセージを構文解析するために使用するメッセージ・ドメインを構成します。非同期応答ノードの「プロパティー」ビューで、「入力 メッセージの構文解析」または「応答 メッセージの構文解析」を選択します。メッセージ・ドメインを選択して、「メッセージ・ドメイン」プロパティーを構成します。詳しくは、パーサーを参照してください。
- 他のノードのプロパティーを構成します。
- 非同期の要求と応答を処理する 1 つのメッセージ・フローがある場合、Passthrough ノードの出力ターミナルを接続したノードの入力ターミナルに、非同期応答ノードの出力ターミナルを接続します。
- 非同期の要求と応答を処理する複数のメッセージ・フローがある場合、Passthrough ノードの出力ターミナルに接続したメッセージ・フローの一部を新しいメッセージ・フローにコピーします。その後、両方のメッセージ・フローの間の相関ロジックを実装します。
- 障害バインディング・ロジックを実装します。エラーや例外を処理する方法を理解するために使用可能なノードに関する情報を確認します。
- 変更を保存します。
次のステップ:
「結果の確認」ビューで、予定タスクを右クリックします。「完全」を選択します。