- 「ブローカー・アプリケーション開発」パースペクティブに切り替えます。
- 「ナビゲーター」ビューで、メッセージ・フローをダブルクリックして、プロパティーをプロモートしたいメッセージ・フローを開きます。 「ナビゲーター」ビューで、メッセージ・フローを右クリックし、「開く」をクリックすることにより、メッセージ・フローを開くこともできます。 メッセージ・フローの内容が、「エディター」ビュー内に表示されます。
これが開いた最初のメッセージ・フローである場合には、「エディター」ビューの左方に、「メッセージ・フロー・コントロール」ウィンドウおよび
使用可能な組み込みメッセージ・フロー・ノードのリストも表示されます。
- 「エディター」ビューで、プロパティーをプロモートしたいメッセージ・フロー・ノードのシンボルを右クリックします。
- 「プロパティーのプロモート」を選択します。
「プロパティーのプロモート」ダイアログが表示されます。
ダイアログの左側に、そのメッセージ・フロー内のすべてのノードに使用可能なすべての
プロパティーがリストされます。強調表示したノードのプロパティーが展開されます。フロー内の他のすべてのノードのプロパティー (これらは初めは縮小されている) を展開してダイアログを最初に開いたときに選択したノードに関係なく、このダイアログからオープン・メッセージ・フローのすべてのノードのプロパティーにアクセスすることができます。
ダイアログの右側に、オープン・メッセージ・フローの名前と、現在メッセージ・フローにプロモートされているすべてのプロパティーがリストされます。
どのプロパティーもまだプロモートしていない場合には、メッセージ・フロー名だけがプロモートされたプロパティー・ツリーのルートとして右に表示されます。
示されるイメージで、メッセージ・フローにはプロモートされたプロパティーが含まれないため、メッセージ・フローの名前のみが表示されます。
大半のメッセージ・フロー・ノード・プロパティーは、プロモーションが可能ですが、以下のプロパティーはプロモートできません。
- Mapping モジュールを指定しているプロパティー。
- プロパティー・グループ。ただし個々のプロパティーはプロモートできます。
- 編集できないプロパティー (例えば MQInput ノードの、プロパティーの Validate グループ内の Fix プロパティー)。
- 説明プロパティー (簡略説明および詳細説明)。
- メッセージ・フローにプロモートしたいプロパティーを選択します。 左のリストには、はじめに選択されたノードの使用可能なすべてのプロパティーの展開されたリストが表示されます。
このノードからすでにプロパティーをプロモートした場合、プロパティーは左側に表示されず、右側に表示されます。
左のリストには、オープン・メッセージ・フロー内の別のノードも含まれています。
各ノードの下にリストされたプロパティーを展開して、同時にそれらすべてのプロパティーを扱う作業をすることができます。プロパティーのプロモートを続けるために、ダイアログを閉じて「エディター」ビューから別のノードを選択する必要はありません。
1 つのプロパティーを選択し、Ctrl を抑えながらさらに 1 つ以上の他のプロパティーを選択することにより、プロモートするプロパティーを複数選択することができます。
プロモートするプロパティーを複数選択した場合、それら選択したすべてのプロパティーがプロモーションで使用可能でなければなりません。
選択したプロパティーが 1 つでもプロモーションで使用可能でないと、選択したものすべてがプロモーションで使用できなくなり、右側のペインの「プロモート」ボタンがグレー化されます。
- 「プロモート」ボタンをクリックして、プロパティー (複数も可) をプロモートします。
「プロモート」ボタンをクリックすると、「ターゲット選択」ダイアログが起動します。
「ターゲット選択」ダイアログには、前に選択されたプロパティー (複数も可) のプロモーションで有効なターゲットのみが表示されます。
このダイアログで、プロモーションの新規ターゲット (例えば新規グループまたは新規プロパティーなど) を作成できます。
- 「ターゲット選択」ダイアログで、プロモートするプロパティー (複数可) の宛先グループまたはプロパティーを選択します。
選択したプロパティー (複数も可) を、既存のグループまたは既存のグループまたはプロパティーの上にドラッグすることにより、メッセージ・フローの、同じまたは異なるノードからの関連したプロパティーをグループにまとめることができます。
別の方法として、「新規グループ」または「新規プロパティー」をクリックしてプロモーションのターゲットを新規作成することもできます。 グループまたはプロパティーを選択して「名前変更」をクリックするか、またはそれらをダブルクリックすることによって、グループおよびプロパティーの名前を変更することができます。
- 「OK」をクリックして、選択を確認します。
注: 「ターゲット選択」を使用して新規グループまたはプロパティーを作成する場合、ダイアログで「キャンセル」を選択しても変更は持続します。
ダイアログを閉じると、「ターゲット選択」ダイアログを使って作成したグループまたはプロパティーが「プロパティーのプロモート」ダイアログに表示されます。
- メッセージ・フローにプロモートしたいプロパティーを選択したら、「OK」をクリックします。 更新がコミットされ、「プロパティーのプロモート」ダイアログが閉じられます。
「適用」をクリックすると、変更がコミットされますが、ダイアログは開いたままになります。
プロパティーをプロモートしたとき、ノード・プロパティー・ダイアログを介してそのプロパティーに変更を行うことができなくなります。メッセージ・フロー・レベルでその値のみを更新することができます。
注: 「プロパティーのプロモート」ダイアログで、選択されたプロパティー (複数も可) をダイアログの左側のペインから右側のペインにドラッグすることによってもプロパティーをプロモートすることができます。
- プロモートしたいプロパティーを選択します。
1 つのプロパティーを選択し、Ctrl を抑えながらさらに 1 つ以上の他のプロパティーを選択することにより、プロモートするプロパティーを複数選択することができます。
- 以下の方法を使用して、選択したプロパティー (複数も可) を右側のペインにドロップすることができます。
- 選択されたプロパティー (複数も可) を空きスペースにドロップする。
新規のグループが自動的に作成され、プロパティーはその中に入れられ、プロパティーのオリジナルの名前と、その元となったメッセージ・フロー・ノードの名前が、プロパティー項目の真下に表示されます。
作成される最初のグループの名前は、デフォルトの Group1 になります。
Group1 という名前のグループがすでに存在する場合、そのグループの名前は Group2 というように続きます。
グループをダブルクリックして新しいテキストを入力するか、または「プロモートされたプロパティー」ペインからグループを選択して
「名前変更」をクリックすることにより、グループの名前を変更することができます。
注: 新しくプロモートされたプロパティーを作成する際には、入力する名前は、プロパティーがシステム内で知られている名前で、ある特定の Java および XML の命名上の制約を満たしている必要があります。
これらは、ダイアログで強制実行され、無効文字を含む名前を入力する場合、メッセージが表示されます。
例えば、スペース、または二重引用符記号を含めることはできません。
Eclipse プラグインとして送達されるユーザー定義のプロジェクト内にメッセージ・フローを開発する場合には、追加した、プロモートされたプロパティーの変換を追加することができます。
変換された名前には、システム名に制限されるスペースなどの文字を含めることができます。
メッセージ・フロー・プロジェクト内のメッセージ・フローを処理している場合、プロモートされたプロパティー用の変換されたストリングを提供するオプションは使用可能ではありません。
- 選択されたプロパティー (複数も可) を既存のグループ上にドロップして、同じメッセージ・フローの、同じかまたは異なるノードからの関連したプロパティーをグループにまとめる。
例えば、データベース対話に関連したすべてのプロモートされたプロパティーをグループにまとめることができます。
プロモートされたプロパティーが属するグループは、「プロモートされたプロパティー」ペインからプロパティーを選択し、それを別のグループ上にドラッグすることによっていつでも変更することができます。
- 選択されたプロパティー (複数も可) を既存のプロパティーにドロップして、メッセージ・フロー内の同じかまたは異なるノードからの関連したプロパティーを収束する。
例えば、データ・ソースを定義する各ノードのプロパティーをオーバーライドする単一のプロモートされたプロパティーを作成することができます。
プロパティーの収束について詳しくは、複数のプロパティーの収束を参照してください。
これで、メッセージ・フロー・ノード・プロパティーが、メッセージ・フローにプロモートされます。これを確認するには、「ナビゲーター」ビューでメッセージ・フローを右クリックするか、または「エディター」ビューを右クリックして「プロパティー」を選択します。
メッセージ・フローの「プロパティー」ダイアログが表示され、プロモートされたメッセージ・フロー・ノード・プロパティーが、作成したグループに編成されて示されます。これらのプロパティーのいずれかの値を設定する場合、メッセージ・フロー自体がその他のメッセージ・フロー内に組み込まれるときにはいつでも、その値がプロパティーのデフォルト値として表示されます。
プロパティーをプロモートしたとき、ノード・プロパティー・ダイアログを介してそのプロパティーに変更を行うことができなくなります。メッセージ・フロー・レベルでその値のみを更新することができます。
別のメッセージ・フロー (サブフロー) 内の組み込みメッセージ・フローを選択して、そのプロパティーを表示すると、プロモートされたプロパティー値が表示されます。組み込みフローの内部を見る場合 (つまり、「サブフローを開く」を選択する場合)、プロパティーの元の値が表示されます。プロモートされたプロパティーの値は元の
プロパティーを置き換えませんが、メッセージ・フローをデプロイする時に優先されます。