あるプロジェクトがワークスペース内の別のプロジェクトを参照することを、「プロジェクト参照」といいます。
あるプロジェクトが別のプロジェクトを参照する場合、参照元のプロジェクトは参照先プロジェクトのファイルを使用できます。 これは例えば、特定のノードの構成、再使用可能なメッセージ・フローのライブラリーの作成、ESQL エディターでのコンテンツ・アシストの有効化などで役立ちます。
プロジェクト参照の例として、
WebSphere® Message Broker Toolkit における以下のようなシナリオがあります。
- メッセージ・フローで Mapping ノードを構成するとき、マップのソースおよびターゲット・メッセージを選択する必要があります。 メッセージは、1 つ以上の メッセージ・モデル・スキーマ・ファイル の中に含まれています。 メッセージを選択するためには、メッセージ・モデル・スキーマ・ファイル への参照がメッセージ・ブローカー・プロジェクトに存在する必要があります。
さらに、データベースとの間でマップするためには、データ設計プロジェクトへの参照も必要です。
- ノード (MQInput ノードなど) を構成するとき、ノードで処理されるメッセージ・タイプ用のメッセージ・テンプレートを定義できます。
ノードの「メッセージ・ドメイン」プロパティーとして MRM、SOAP、XMLNSC、DataObject、または IDOC を選択した場合には、メッセージ・モデルを含んでいるメッセージ・モデル・スキーマ・ファイルの名前も指定する必要があります。 「メッセージ」プロパティーにおいてメッセージ・モデル・スキーマ・ファイルのリストにデータを事前に取り込むには、メッセージ・ブローカー・プロジェクトにメッセージ・モデル・スキーマ・ファイルへの参照が存在する必要があります。
- 再使用可能な ESQL サブルーチンのライブラリーをメッセージ・ブローカー・プロジェクトで作成したり、他のフローで再使用するためのメッセージ・フローのライブラリーを作成したい場合があります。 これらのサブルーチンやメッセージ・フローの使用場所となるメッセージ・フローでは、親メッセージ・ブローカー・プロジェクトからメッセージ・ブローカー・プロジェクトへの参照が必要です。
- また、ESQL エディターでコンテンツ・アシストを使用可能にするためにプロジェクト参照を使用することもできます。 (「コンテンツ・アシスト」は、コード・ステートメントを完成させる有効な方法を表示するコンテキスト・ヘルプです。)
ESQL コードが入っているメッセージ・ブローカー・プロジェクトから メッセージ・モデル・スキーマ・ファイル へのプロジェクト参照をセットアップすると、ESQL エディターは有効なメッセージ参照のリストを表示できます。
- パターン・エクスプローラーを使用して、パターン仕様からパターン・インスタンスを生成した場合は、その生成したパターン・インスタンス・プロジェクトに、そのパターンから生成された他のすべてのプロジェクトへの参照が組み込まれます。
パターンの使用を参照してください。
プロジェクト参照を手動で作成または削除するには、「ブローカー開発」ビューでプロジェクト名を右クリックし、「プロパティー」メニュー項目を選択します。 「プロパティー」ウィンドウで「プロジェクト参照」を選択すると、ワークスペース内のすべての標準プロジェクトのリストが表示され、そこでプロジェクト参照を選択またはクリアできます。 メッセージ・フロー・プロジェクト、メッセージ・モデル・スキーマ・ファイル、パターン・インスタンス・プロジェクトにある追加のメニュー項目「プロジェクト参照の追加または除去」を使用すると、「プロジェクト参照の追加または除去」ウィンドウが起動し、そのウィンドウでプロジェクト参照を選択/クリアできるようになります。
その後、参照先プロジェクトを閉じるか削除した場合、またはその中のオブジェクトを削除した場合には、参照元プロジェクトはそれを使用できなくなり、エラーが生成されます。 閉じているプロジェクトを開くことにより、
または不足しているオブジェクトに適切な名前を付けて追加および保管することにより、エラーを訂正できます。