Label ノード

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

目的

メッセージがその内容に応じてメッセージ・フローでとる経路を動的に決定するには、Label ノードを RouteToLabel ノードと組み合わせて使用します。 RouteToLabel ノードは、メッセージの LocalEnvironment に問い合わせて、メッセージが次にルーティングされる必要のある Label ノードの ID を判別します。

メッセージ・フロー内で、RouteToLabel ノードの前には、メッセージの次の処理シーケンスを知らせる 1 つ以上の Labelノードの ID をメッセージの LocalEnvironment に取り込む Compute ノードが存在 します。

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

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

ワークベンチでは、Label ノードは次のアイコンで表されます。

Label ノード・アイコン

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

このノードが使用される方法に関しては、次のサンプルを参照してください。

Label ノードの構成

Label ノードのインスタンスをメッセージ・フローに入れると、Label ノードを構成することができます。 エディター・ビューでノードを右マウス・ボタンでクリックし、「プロパティー (Properties)」をクリックします。 ノードの基本プロパティーが表示されます。

値を入力する必要のある (デフォルト値が定義されていない) すべての必須プロパティーには、プロパティー・ダイアログにアスタリスクが表示されます。

以下のように、Label ノードを構成します。

  1. RouteToLabel ノード用のターゲットを識別する Label ノード用の単一の必須プロパティー「ラベル名 (Label Name)」があります。 「ラベル名 (Label Name)」はノード自体のインスタンスの名前と同じであってはなりません。 ラベル名は、表示されるメッセージ・フローの中で固有でなければなりません。 この Label ノードが属しているサブフローが別のメッセージ・フローに組み込まれる場合は、インスタンスの名前がワークベンチによって変更されることがあります。
  2. 簡略説明または詳細説明 (あるいはその両方) を入力するには、プロパティー・ダイアログ・ナビゲーターの「説明 (Description)」を選択します。
  3. 「適用」をクリックすると、プロパティー・ダイアログを閉じずに Label ノードが変更されます。 「OK」をクリックすると、変更を適用してプロパティー・ダイアログを閉じます。

    「キャンセル (Cancel)」をクリックすると、ダイアログを閉じてプロパティーの変更をすべて破棄します。

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

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

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

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

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

プロパティー M C デフォルト 説明
ラベル名 (Label Name) はい いいえ   ノードの ID。 このプロパティーは、RouteToLabel ノードがルーティングするメッセージのターゲットとして使用されます。

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

プロパティー M C デフォルト 説明
簡略説明 (Short Description) いいえ いいえ   ノードの簡単な説明
詳細説明 (Long Description) いいえ いいえ   メッセージ・フロー内のノードの目的を説明するテキスト

関連概念
メッセージ・フロー

関連タスク
使用するノードの決定
宛先リストの作成
メッセージ・フローのエラー処理
ノードを使用した意思決定

関連資料
FlowOrder ノード
RouteToLabel ノード