1 つのメッセージ・フロー内のいくつかのノードから、プロパティーをプロモートして、それらすべてのノードに適用される、単一のプロモートされたプロパティーを定義することができます。
プロパティーのプロモートの使用例の 1 つは、データベース・アクセス用です。
メッセージ・フローに、それぞれ同じ物理データベースを参照する 2 つのDatabase・ノードが含まれている場合、メッセージ・フロー上でただ一度、物理データベースを定義することができます。そうするには、それぞれのDatabase・ノードの「データ・ソース」プロパティーをメッセージ・フローにプロモートし、メッセージ・フロー (プロモートされた) レベルでプロパティーを設定します。
複数のノード・プロパティーを単一のプロモートされたプロパティーに収束するには、以下のようにします。
- 「ブローカー・アプリケーション開発」パースペクティブに切り替えます。
- メッセージ・フロー・エディターでメッセージ・フローを開きます。
- プロパティーをプロモートしようとするノードを右クリックして、「プロパティーのプロモート」をクリックします。
「プロパティーのプロモート」ダイアログ・ボックスが表示されます。
- 収束したいプロパティーを選択します。 左のリストには、はじめに選択されたノードの使用可能なすべてのプロパティーの展開されたリストが表示されます。
このノードからすでにプロパティーをプロモートした場合、プロパティーは左側に表示されず、右側に表示されます。
左のリストには、オープン・メッセージ・フロー内の別のノードも含まれています。
各ノードの下にリストされたプロパティーを展開して、同時にそれらすべてのプロパティーを扱う
作業をすることができます。プロパティーのプロモートを続けるために、ダイアログ・ボックスを閉じてメッセージ・フロー・エディターから別のノードを選択する必要はありません。
1 つのプロパティーを選択し、Ctrl を抑えながらさらに 1 つ以上の他のプロパティーを選択することにより、プロモートするプロパティーを複数選択することができます。
収束するプロパティーを複数選択した場合、それら選択したすべてのプロパティーがプロモーションで使用可能でなければなりません。
選択したプロパティーが 1 つでもプロモーションで使用可能でないと、選択したものすべてがプロモーションで使用できなくなり、右側のペインの「プロモート」ボタンが使用不可になります。
- 「プロモート」をクリックして、プロパティー (複数も可) をプロモートします。
「ターゲット選択」ダイアログ・ボックスが開きます。
「ターゲット選択」ダイアログ・ボックスには、前に選択されたプロパティー (複数も可) のプロモーションで有効なターゲットのみが表示されます。
このダイアログ・ボックスで、プロモーションの新規ターゲット (例えば新規グループまたは新規プロパティーなど) を作成できます。
- メッセージ・フロー内の同じまたは異なるノードからのプロパティーを収束するには、ツリーを展開し、既存のプロパティーをクリックします。 プロパティーを選択して「名前変更」をクリックするか、またはグループおよびプロパティーをダブルクリックすることによって、プロパティーの名前を変更することができます。
- 「OK」をクリックして、選択を確認します。
注: 「ターゲット選択」ダイアログ・ボックスを使用して新規グループまたはプロパティーを作成する場合、「キャンセル」をクリックしても変更は持続します。ダイアログ・ボックスを閉じると、「ターゲット選択」ダイアログ・ボックスを使って作成したグループまたはプロパティーが「プロパティーのプロモート」ダイアログ・ボックスに表示されます。
- プロパティーをプロモートするすべてのノードのプロパティー・ツリーを展開します。
- 左方のリストから、収束したいプロパティーの最初のインスタンスをドラッグし、右方のリストの中の適切なグループの上にそれをドロップします。
- そのグループに 1 つ以上のプロモートされたプロパティーがすでに含まれている場合、新しいプロパティーはそのグループの最後に追加されます。
プロパティーをダブルクリックするか、またはプロパティーを選択して「名前変更」をクリックすることにより、新規のプロパティーの名前を変更できます。
- プロモートされたプロパティーが新規のグループ内に現れるようにしたい場合には、既存のグループの下の空きスペースにプロパティーをドラッグして、新規のグループを作成します。代替手段として、次の方法があります。
- プロモートしたいプロパティーを選択して、「プロモート」をクリックします。
「ターゲット選択」ダイアログ・ボックスが開きます。
- 「新規グループ」をクリックし、新規グループの名前を入力します。
- 「OK」をクリックして、変更を確認します。
- 異なるタイプの既存のプロモートされたプロパティー上にプロパティーをドラッグする場合、ノー・エントリー・アイコンが表示されて、プロパティーをドロップすることができなくなります。
これを新規のプロモートされたプロパティーとして作成するか、または互換性のある
既存のプロモートされたプロパティーの上にドロップする必要があります。
プロパティーは、互換性があるように同じプロパティー・エディターと関連付けられていなければなりません。例えば、組み込みノードを使用する場合、同じタイプのプロパティー (ストリングではストリング、ブールではブール) のみを収束することができます。
ユーザー定義のノードを使用する場合、収束したいプロパティーのプロパティー・エディターの互換性をチェックしなければなりません。また、ノード用のコンパイラー・クラスを作成した場合、収束したプロパティーは必ず同じコンパイラー・クラスを持つようにしなければなりません。
- 左方のリスト内のそれぞれのノードから残りのすべてのプロパティーのインスタンスをドラッグし、既存のプロモートされたプロパティーに持っていきます。
既存のプロモートされたプロパティーの下に新規プロパティーが追加され、新規のプロモートされたプロパティーとしては作成されません。
- 「適用」をクリックすると、「プロパティーのプロモーション」ダイアログ・ボックスを閉じずにこの変更を確定します。
「OK」をクリックすると、更新を完了し、ダイアログ・ボックスを閉じます。
「プロパティーのプロモート」ダイアログ・ボックスで、選択されたプロパティー (複数も可) をダイアログ・ボックスの左側のペインから右側のペインにドラッグすることによってもプロパティーを収束することができます。
- プロモートするプロパティーを選択します。 1 つのプロパティーを選択し、Ctrl を抑えながらさらに 1 つ以上の他のプロパティーを選択することにより、プロモートするプロパティーを複数選択することができます。
- 選択されたプロパティー (複数も可) を右側のペインのプロパティーにドロップして、メッセージ・フロー内の同じかまたは異なるノードからの関連したプロパティーを収束します。
例えば、データ・ソースを定義する各ノードのプロパティーをオーバーライドする
単一のプロモートされたプロパティーを作成することができます。
いくつかのノードから、プロパティーをプロモートして、それらすべてのノード用に使用される、単一のプロモートされたプロパティーを定義しました。