WebSphere Message Broker バージョン 8.0.0.5 オペレーティング・システム: AIX、HP-Itanium、Linux、Solaris、Windows、z/OS

製品の最新バージョンについては、IBM Integration Bus バージョン 9.0 をご覧ください。

Select 変換におけるデータベースの失敗の処理

SQL データベース例外を明示的に処理するためにメッセージ・マップで定義する Select 変換ごとに Failure 変換を構成することができます。デフォルトでは、Mapping ノードは、メッセージ・フロー内でその他のノードによって処理できるデータベース例外をスローします。

始める前に

メッセージ・マップで Select 変換を構成します。詳しくは、メッセージ・マップでの Select 変換の構成を参照してください。

このタスクについて

デフォルトでは、Mapping ノードは、SOAPInput ノードが catch して、クライアントに返す SOAP 障害をビルドするために自動的に使用するデータベース例外をスローします。

このシナリオでは、オプションの Failure 変換を使用して、Select 変換データベース・トランザクションからスローされる可能性がある最初の SQL 例外を処理します。データベース例外の詳細と、失敗したアドレスの検索に使用される Name エレメントと Country エレメントが組み込まれた SOAPFault をビルドします。

Failure 変換にはネストされたマップがあります。このネストされたマップが、失敗を処理する方法を定義するためにメッセージ・アセンブリーの入力エレメントと出力エレメントを変換する場所になります。

手順

シナリオで Failure 変換を構成するには、以下のステップを実行します。

  1. 「Select」を右クリックして、「データベース」 > 「失敗の処理」を選択します。

    以下の図は、Failure 変換を Select 変換に追加するためのパスの選択項目をグラフィカルに示しています。

    この図は、Failure 変換を Select 変換に追加するためのパスの選択項目をグラフィカルに示しています。「データベース」を選択してから、「失敗の処理」を選択します。

    Failure 変換が Select 変換に追加されます。

    この図は、Select 変換に関連付けられた Failure 変換を示しています。

  2. メッセージ・アセンブリー・エレメント NameFailure 変換に接続します。

    以下の図は、Failure 変換に接続されたエレメント Name を示しています。

    この図は、Failure 変換に接続されたエレメント Name を示しています。

  3. メッセージ・アセンブリー・エレメント CountryFailure 変換に接続します。

    以下の図は、Failure 変換に接続されたエレメント Country を示しています。

    この図は、Failure 変換に接続されたエレメント Country を示しています。

  4. Failure 変換を出力エレメント Fault に接続します。
    この図は、出力メッセージ・アセンブリー内の出力 Fault セクションに接続された Failure 変換を示しています。

  5. 「Failure」を選択します。

    Failure 変換のネストされたマップが開きます。

    この図は、変換が定義される前の Failure 変換のネストされたマップを示しています。

  6. ネストされたマップ内の入力エレメントとメッセージ・アセンブリー出力エレメントの間の変換を定義します。以下のステップを実行します。
    1. Move 変換を使用して、メッセージ・アセンブリー本文セクション Fault で入力エレメント Name を出力エレメント Name に接続します。
    2. Move 変換を使用して、メッセージ・アセンブリー本文セクション Fault で入力エレメント Country を出力エレメント Country に接続します。
    3. Move 変換を使用して、メッセージ・アセンブリー本文セクション Fault でデータベース例外エレメント Message を出力エレメント value に接続します。
  7. Move 変換の「プロパティー」タブでデータベース・エレメント Message のカーディナリティー索引を 1 に設定します。

    以下の図は、エレメント CITYMove 変換の「プロパティー」タブを示しています。

    この図は、エレメント Message の Move 変換の「プロパティー」タブを示しています。

タスクの結果

シナリオの開発ステップが正常に完了しました。

実行時に JDBC 接続を構成します。詳しくは、実行時に使用可能にするデータベースの構成を参照してください。