プロパティーのプロモート

メッセージ・フローおよびそのノードの保守を単純化し、プロモートされたプロパティーを収束することによりフロー内に複数のノードの共通値を提供するために、ノード・プロパティーをメッセージ・フロー・レベルにプロモートすることができます。

始める前に:
大半のメッセージ・フロー・ノード・プロパティーは、プロモーションが可能ですが、以下のプロパティーはプロモートできません。
  • マッピング・モジュールに名前を付けるプロパティー
  • プロパティー・グループ (ただし個々のプロパティーはプロモートできます)
  • 編集できないプロパティー (例えば MQInput ノードの、Fix プロパティー)
  • 説明プロパティー (簡略説明および詳細説明)

メッセージ・フローのレベルにメッセージ・フロー・ノード・プロパティーをプロモートするには、以下のステップを実行します。

  1. 「ブローカー・アプリケーション開発」パースペクティブに切り替えます。
  2. プロパティーをプロモートするメッセージ・フローを開きます。
  3. プロパティーをプロモートしようとするノードを右クリックして、「プロパティーのプロモート」をクリックします。

    「プロパティーのプロモート」ダイアログ・ボックスが表示されます。

    「プロパティーのプロモート」ダイアログ

    ダイアログ・ボックスの左側に、そのメッセージ・フロー内のすべてのノードに使用可能なすべてのプロパティーがリストされます。 クリックしたノードのプロパティーが展開されます。 最初にクリックしたノードに関係なく、オープン・メッセージ・フローのすべてのノードのプロパティーを展開することができます。

    ダイアログ・ボックスの右側に、オープン・メッセージ・フローの名前と、現在メッセージ・フローにプロモートされているすべてのプロパティーが表示されます。 どのプロパティーもまだプロモートしていない場合には、上の例で示されているように、メッセージ・フロー名だけがプロモートされたプロパティー・ツリーのルートとして表示されます。 このノードからすでにプロパティーをプロモートした場合、プロパティーは左側に表示されず、右側に表示されます。

  4. メッセージ・フローにプロモートするプロパティー (複数可) を選択します。 Ctrl を押したままプロパティーを選択することによって、複数のプロパティーを選択することができます。
  5. 「プロモート」をクリックします。 「ターゲット選択」ダイアログ・ボックスが開き、プロモーションに有効なターゲットが表示されます。
    「ターゲット選択」ダイアログ・ボックス
  6. プロモートするプロパティーの宛先グループまたはプロパティーを選択します。 選択したプロパティーを、既存のグループまたは既存のプロパティーの上にドロップすることにより、メッセージ・フローの、同じまたは異なるノードからの関連したプロパティーをグループにまとめることができます。 または、「新規グループ」「新規プロパティー」をクリックして、プロモーション用の新規ターゲットを作成することができます。 グループまたはプロパティーを選択して「名前変更」をクリックすることによって、グループおよびプロパティーの名前を変更することができます。
  7. 「OK」をクリックして、選択を確認し、「ターゲット選択」ダイアログ・ボックスを閉じます。

    「ターゲット選択」ダイアログ・ボックスを使用して新規グループまたはプロパティーを作成する場合、ダイアログ・ボックスで「キャンセル」を選択しても変更は持続します。 ダイアログ・ボックスを閉じると、「ターゲット選択」ダイアログ・ボックスを使って作成したグループまたはプロパティーが「プロパティーのプロモート」ダイアログ・ボックスに表示されます。 これらのプロパティーはいずれも、選択して「除去」をクリックすることで、「プロパティーのプロモート」ダイアログ・ボックスから除去することができます。

  8. 「OK」をクリックして、変更をコミットし、「プロパティーのプロモート」ダイアログ・ボックスを閉じます。 「適用」をクリックする場合、変更はコミットされますが、ダイアログ・ボックスは開いたままです。

メッセージ・フロー・ノード・プロパティーが、メッセージ・フローにプロモートされます。 プロパティーをプロモートしたとき、ノード・レベルでそのプロパティーに変更を加えることができなくなります。その値はメッセージ・フロー・レベルでのみ更新することができます。 メッセージ・フローのプロパティーを表示するには、メッセージ・フロー・エディターで、メッセージ・フロー (個々のノードではない) を右クリックし、「プロパティー」をクリックして、「プロパティー」ビューまたは「プロパティー」ダイアログ・ボックスを表示します。 プロモートしたプロパティーは、作成したグループに編成されます。 これらのプロパティーのいずれかの値を設定する場合、メッセージ・フローがその他のメッセージ・フロー内に組み込まれるときにはいつでも、その値がプロパティーのデフォルト値として表示されます。

別のメッセージ・フロー (サブフロー) 内の組み込みメッセージ・フローを選択して、そのプロパティーを表示すると、プロモートされたプロパティー値が表示されます。組み込みフローの内部を見る場合 (「サブフローを開く」を選択することによって)、プロパティーの元の値が表示されます。 プロモートされたプロパティーの値は元の プロパティーを置き換えませんが、メッセージ・フローをデプロイする時に優先されます。

ドラッグによるプロパティーのプロモート

次のステップで説明されているとおり、「プロパティーのプロモート」ダイアログ・ボックスで、選択されたプロパティー(複数も可) を「プロパティーのプロモート」ダイアログ・ボックスの左側のペインから右側のペインにドラッグすることによっても、プロパティーをプロモートすることができます。
  1. プロモートするプロパティーを選択します。 Ctrl を押したままプロパティーを選択することによって、複数のプロパティーを選択することができます。
  2. 次の方法を使用して、選択したプロパティーをプロモートすることができます。
    • 選択されたプロパティー (複数も可) を空きスペースにドロップする。

      メッセージ・フローに新規のグループが自動的に作成され、プロパティーはその中に入れられ、プロパティーのオリジナルの名前と、その元となったメッセージ・フロー・ノードの名前が、プロパティー項目の真下に表示されます。

      作成される最初のグループの名前は、デフォルトの Group1 になります。 Group1 という名前のグループがすでに存在する場合、そのグループの名前は Group2 というように続きます。 グループをダブルクリックして新しいテキストを入力するか、または「プロモートされたプロパティー」ペインからグループを選択して「名前変更」をクリックすることにより、グループの名前を変更することができます。

      新しくプロモートされたプロパティーを作成する際には、入力する名前は、プロパティーがシステム内で知られている名前で、ある特定の Java および XML の命名上の制約を満たしている必要があります。 これらの制約は、ダイアログ・ボックスで強制実行され、無効文字を含む名前を入力する場合、メッセージが表示されます。 例えば、スペースまたは引用符「"」を含めることはできません。

      Eclipse プラグインとして送達されるユーザー定義のプロジェクト内にメッセージ・フローを開発する場合には、追加した、プロモートされたプロパティーの変換を追加することができます。 変換された名前には、システム名に制限されるスペースなどの文字を含めることができます。 メッセージ・フロー・プロジェクト内のメッセージ・フローを処理している場合、プロモートされたプロパティー用の変換されたストリングを提供するオプションは使用可能ではありません。

    • 選択されたプロパティー (複数も可) を既存のグループ上にドロップして、同じメッセージ・フローの、同じかまたは異なるノードからの関連したプロパティーをグループにまとめる。

      例えば、データベース対話に関連したすべてのプロモートされたプロパティーをグループにまとめることができます。 プロモートされたプロパティーが属するグループは、「プロモートされたプロパティー」ペインからプロパティーを選択し、それを別のグループ上にドラッグすることによっていつでも変更することができます。

    • 選択されたプロパティー (複数も可) を既存のプロパティーにドロップして、メッセージ・フロー内の同じかまたは異なるノードからの関連したプロパティーを収束する。

      例えば、データ・ソースを定義する各ノードのプロパティーをオーバーライドする単一のプロモートされたプロパティーを作成することができます。

      プロパティーの収束について詳しくは、複数のプロパティーの収束を参照してください。

必須プロパティーのプロモート

必須のプロパティー (「プロパティー」ビュー内で名前の横にアスタリスクが表示されているもの) をプロモートする場合、プロパティーの必須特性は保存されます。 必須プロパティーがプロモートされる際、その値はノード・レベルで設定されている必要はありません。 プロモートされる必須プロパティーを含むフローがサブフローとして別のフローに含まれている場合、そのプロパティーはそのサブフロー・ノード用に値が取り込まれる必要があります。

メッセージ・フローの階層を介したプロパティーのプロモート

メッセージ・フロー・ノード・プロパティーをプロモートするプロセスを、メッセージ・フローのいくつかのレベルを通して繰り返すことができます。つまり、プロパティーは階層のどのレベルからでも、その 1 つ上のレベルにプロモートでき、階層全体を通して最上位のレベルまで同様にプロモートを実行できます。 プロパティーの値は、メッセージ・フローがブローカーにデプロイされるときに、階層内の最高点から伝搬されて、元のメッセージ・フロー・ノードに至るまで設定されていきます。 元のメッセージ・フロー・ノード上にあるそのプロパティーの値はオーバーライドされます。

関連資料
組み込みノード
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

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

ac02380_