メッセージ・フロー内の後続のノードで処理する入力メッセージの内容を抽出するには、Extract ノードを使用します。
このトピックには、以下のセクションが含まれています。
Extract ノードを使用すると、入力メッセージの内容のサブセットだけを入れる新しい出力メッセージを作成できます。 出力メッセージは、マッピング・ステートメントを定義して、Extract ノードの構成時に組み込むことを指定した入力メッセージのエレメントのみで構成されます。
このノードは、メッセージ全体を最初に処理した後に、メッセージのサブセットだけを必要とする場合に役立つかもしれません。 例えば、監査のためにメッセージ全体を (Warehouse ノードに) 保管したいものの、後の処理にはメッセージの小さな部分のみ (おそらく注文情報) を伝搬したい場合もあります。
例えば、新規クライアントから注文を受け取り、今後の販売促進のためクライアントの名前と住所を収集したいとします。 Extract ノードを使用して個々の注文書からこの情報を取得し、それを新しいメッセージとして本社に送信します。 これらのメッセージは、次のマーケティング・キャンペーンに顧客詳細を組み込むことができるように本社で処理されます。
Extract ノードのインスタンスをメッセージ・フローに入れたら、そのノードを構成することができます。 詳しくは、メッセージ・フロー・ノードの構成を参照してください。 ノードのプロパティーが、「プロパティー」ビューに表示されます。 (Extract ノードをダブルクリックすると、「新規メッセージ・マップ」ダイアログ・ボックスが開きます。) 値を入力する必要のある (デフォルト値が定義されていない) すべての必須プロパティーには、アスタリスクが表示されます。
Extract ノードのターミナルについては、次の表に説明されています。
ターミナル | 説明 |
---|---|
In | ノードが処理するメッセージを受け入れる入力ターミナル。 |
Failure | 抽出で障害が検出された場合に、入力メッセージがルーティングされる出力ターミナル。 |
Out | 入力メッセージが正常に処理された場合に、変換済みメッセージがルーティングされる出力ターミナル。 |
以下の表は、ノード・プロパティーについて説明しています。 M の見出しの列は、プロパティーが必須 かどうかを示します (デフォルトが定義されていない場合に値を入力することが必要なら、アスタリスクのマークが付きます)。 C の見出しの列は、プロパティーが構成可能 (メッセージ・フローを BAR ファイルに追加してデプロイするとき、値を変更できる) かどうかを示します。
Extract ノードの「説明」プロパティーについては、次の表に説明されています。
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
ノード名 | いいえ | いいえ | Extract | ノードの名前。 |
簡略説明 | いいえ | いいえ | ノードの簡単な説明 | |
詳細説明 | いいえ | いいえ | メッセージ・フロー内のノードの目的を説明するテキスト |
Extract ノードの「基本」プロパティーについては、次の表に説明されています。
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
マッピング・モジュール | はい | いいえ | Extract | メッセージ・ツリーに対して実行されるステートメントが含まれるマッピング・ルーチンの名前。 デフォルトでは、マッピング・ルーチンに割り当てられる名前は、ルーチンが定義されているマッピング・ファイルの名前と同一です。 ファイルのデフォルト名は、メッセージ・フローの名前にメッセージ・フローに組み込む際のノードの名前を連結したものです (例えば、メッセージ・フロー MFlow1 の最初の Extract ノードの場合は、MFlow1_Extract.msgmap)。 スペースを含む値は指定できません。 このノードに関連するマッピング・ルーチンを処理するには、ノードを右クリックして「マッピングを開く」をクリックします。 マッピング・ルーチンが存在しない場合は、デフォルト名で、デフォルト・ファイルの中に作成されます。 このファイルがすでに存在する場合には、「ブローカー開発」ビューで flow_name_node_name.msgmap ファイルを開くこともできます。 マッピング・ルーチンは、関連するノードのタイプに特有のものです。 Extract ノード用に開発したマッピング・ルーチンを、 マッピングを使用する他のノード (DataInsert ノードなど) と一緒に使用することはできません。 マッピング・ルーチンを作成した場合、それを他のマッピング・ルーチンから呼び出すことはできません。 ただし、ESQL ルーチンから呼び出すことは可能です。 マッピング・ファイルでの作業とその内容の定義について詳しくは、グラフィカル・データ・マップの使用を参照してください。 |
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
イベント | いいえ | いいえ | なし | ノードに対して定義したイベントが、このタブに表示されます。 デフォルトでは、メッセージ・フローのどのノードに対してもモニター・イベントは定義されません。 ノードのモニター・イベントを作成、変更、または削除するには、「追加」、「編集」、および「削除」を使用します。詳しくは、モニター・プロパティーを使用したモニター・イベント・ソースの構成を参照してください。 「使用可能」チェック・ボックスを選択またはクリアすることによって、ここに表示されているイベントを使用可能および使用不可に設定できます。 |