Label ノード

Label ノードを使用して、RouteToLabel ノードから伝搬されたメッセージを処理し、メッセージがメッセージ・フロー内でとる経路を動的に決定します。

このトピックには、以下のセクションが含まれています。

目的

Label ノードを RouteToLabel ノードと共に使用して、メッセージの内容に基づいてメッセージがメッセージ・フロー内でルーティングされるようにします。 RouteToLabel ノードは、メッセージの LocalEnvironment に問い合わせて、 メッセージが次にルーティングされる必要のある Label ノードの ID を判別します。 ESQL を Compute ノード内でコーディングすることにより、または Java™ を JavaCompute またはユーザー定義のノード内でコーディングすることにより、メッセージを伝搬させることができます。

メッセージ・フロー内で Compute ノードまたは JavaCompute ノードを持つ RouteToLabel ノードを先行させて、メッセージの次の処理シーケンスを知らせる 1 つ以上の Label ノードの ID を、メッセージの LocalEnvironment に取り込みます。

メッセージ・フローの設計では、Label ノードは、 論理的にはメッセージ・フロー内で RouteToLabel ノードの後に続きますが、 物理的には RouteToLabel ノードに接続されないようにしてください。 必要な場合には、LocalEnvironment の内容に応じて、ブローカーが接続を作成します。

Label ノードはルーティング決定のターゲットを提供しますが、このノードが扱うメッセージを何らかの方法で処理することはありません。 通常、Label ノードは、特定の方法でそれぞれのメッセージを処理するサブフローに接続し、 出力ノード内または別の RouteToLabel ノード内のいずれかで終了します。

Label ノードを、SOAPExtract ノードと一緒に使用することができ、また、Compute または Database ノードに指定されている PROPAGATE ステートメントのターゲットとして使用することもできます。

Label ノードはパレットの「ルーティング」ドロワーに含まれていて、ワークベンチ内では次のアイコンによって表されます。

Label ノード・アイコン

メッセージ・フロー内でのこのノードの使用

このノードが使用される方法に関しては、次のサンプルを参照してください。 サンプルは、Message Brokers Toolkit と統合されているインフォメーション・センターを使用する場合にのみ表示できます。

ターミナルおよびプロパティー

Label ノードのインスタンスをメッセージ・フローに入れると、それを構成することができます。メッセージ・フロー・ノードの構成を参照してください。 ノードのプロパティーが、「プロパティー」ビューに表示されます。ノードのプロパティーを「プロパティー」ダイアログに表示するには、ノードをダブルクリックするか、またはノードを右クリックしてから「プロパティー」をクリックします。 値を入力する必要のある (デフォルト値が定義されていない) すべての必須プロパティーには、アスタリスクが表示されます。

Label ノードのターミナルについては、次の表に説明されています。

ターミナル 説明
Out メッセージがルーティングされる出力ターミナル。

以下の表は、ノード・プロパティーについて説明しています。 M の見出しの列は、プロパティーが必須 かどうかを示します (デフォルトが定義されていない場合に値を入力することが必要なら、アスタリスクのマークが付きます)。 C の見出しの列は、プロパティーが構成可能 かどうかを示します (メッセージ・フローを BAR ファイルに追加してデプロイするとき、値を変更できます)。

Label ノードの「説明」プロパティーについては、次の表に説明されています。

プロパティー M C デフォルト 説明
ノード名 いいえ いいえ ノード・タイプ ノードの名前。
簡略説明 いいえ いいえ   ノードの簡単な説明
詳細説明 いいえ いいえ   メッセージ・フロー内のノードの目的を説明するテキスト

Label ノードの「基本」プロパティーについては、次の表に説明されています。

プロパティー M C デフォルト 説明
ラベル名 はい いいえ   ノードの ID。 このプロパティーは、RouteToLabel ノードがルーティングするメッセージのターゲットとして使用されます。 「ラベル名」はノード自体のインスタンスの名前と同じであってはなりません。 ラベル名は、表示されるメッセージ・フローの中で固有でなければなりません。 この Label ノードが属しているサブフローが別のメッセージ・フローに組み込まれる場合は、 インスタンスの名前がワークベンチによって変更されることがあります。
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
最終更新 : 2009-02-20 12:42:45

ac04800_