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 ノードはパレットの「ルーティング」ドロワーに含まれていて、WebSphere® Message Broker Toolkit 内では次のアイコンによって表されます。
サンプルに関する情報は、WebSphere Message Broker Toolkit に統合されているインフォメーション・センター、またはオンライン・インフォメーション・センターを使用する場合にのみ表示できます。 サンプルは、WebSphere Message Broker Toolkit に統合されているインフォメーション・センターを使用する場合にのみ実行できます。
Label ノードのインスタンスをメッセージ・フローに入れると、それを構成することができます。メッセージ・フロー・ノードの構成を参照してください。 ノードのプロパティーが、「プロパティー」ビューに表示されます。 値を入力する必要のある (デフォルト値が定義されていない) すべての必須プロパティーには、アスタリスクが表示されます。
Label ノードのターミナルについては、次の表に説明されています。
ターミナル | 説明 |
---|---|
Out | メッセージがルーティングされる出力ターミナル。 |
以下の表は、ノード・プロパティーについて説明しています。 M の見出しの列は、プロパティーが必須 かどうかを示します (デフォルトが定義されていない場合に値を入力することが必要なら、アスタリスクのマークが付きます)。 C の見出しの列は、プロパティーが構成可能 (メッセージ・フローを BAR ファイルに追加してデプロイするとき、値を変更できる) かどうかを示します。
Label ノードの「説明」プロパティーについては、次の表に説明されています。
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
ノード名 | いいえ | いいえ | ノード・タイプ | ノードの名前。 |
簡略説明 | いいえ | いいえ | ノードの簡単な説明 | |
詳細説明 | いいえ | いいえ | メッセージ・フロー内のノードの目的を説明するテキスト |
Label ノードの「基本」プロパティーについては、次の表に説明されています。
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
ラベル名 | はい | いいえ | ノードの ID。 このプロパティーは、RouteToLabel ノードがルーティングするメッセージのターゲットとして使用されます。 「ラベル名」はノード自体のインスタンスの名前と同じであってはなりません。 ラベル名は、表示されるメッセージ・フローの中で固有でなければなりません。 この Label ノードが属しているサブフローが別のメッセージ・フローに組み込まれる場合は、 インスタンスの名前がWebSphere Message Broker Toolkit によって変更されることがあります。 |
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
イベント | いいえ | いいえ | なし | ノードに対して定義したイベントが、このタブに表示されます。 デフォルトでは、メッセージ・フローのどのノードに対してもモニター・イベントは定義されません。 ノードのモニター・イベントを作成、変更、または削除するには、「追加」、「編集」、および「削除」を使用します。詳しくは、モニター・プロパティーを使用したモニター・イベント・ソースの構成を参照してください。 「使用可能」チェック・ボックスを選択またはクリアすることによって、ここに表示されているイベントを使用可能および使用不可に設定できます。 |