Wenn ein Projekt auf andere Projekte im Arbeitsbereich verweist,
wird dies als Projektverweis bezeichnet.
Wenn ein Projekt auf ein anderes verweist, können die Dateien des letzteren Projekts vom verweisenden Projekt verwendet werden. Diese können z. B. zur Konfiguration bestimmter Knoten, zur Erstellung von Bibliotheken aus wieder verwendbaren Nachrichtenflüssen oder zur Aktivierung der Inhaltshilfe im ESQL-Editor verwendet werden.
Die folgenden Szenarien im
WebSphere Message
Broker Toolkit bieten Beispiele für Projektverweise:
- Bei der Konfiguration eines Zuordnungsknoten-Knotens in einem Nachrichtenfluss müssen Sie für die Zuordnung die Quell- und Zielnachrichten auswählen. Die Nachrichten sind in einem oder mehreren Nachrichtengruppen enthalten.
Damit Nachrichten ausgewählt werden können, muss das Nachrichtenbrokerprojekt
einen Verweis auf die Nachrichtengruppenprojekte enthalten. Wenn eine Zuordnung von oder auf eine Datenbank erfolgen soll, benötigen Sie außerdem einen Verweis auf ein Datenentwurfsprojekt.
- Bei der Konfiguration eines Knotens, z. B. eines MQInput-Knotens können Sie die Nachrichtenschablone für den Nachrichtentyp definieren, der den Knoten verarbeitet.
Wenn Sie für die Knoteneigenschaft Message domain (Nachrichtendomäne) MRM, SOAP, XMLNSC, DataObject oder IDOC ausgewählt haben, müssen Sie auch den Namen des Nachrichtensatzes angeben, der die Nachrichtendefinition enthält. Damit die Liste der
Nachrichtengruppen in der Eigenschaft Nachrichtengruppe vorab
ausgefüllt werden kann, muss das Nachrichtenbrokerprojekt einen Verweis auf
die Nachrichtengruppenprojekte enthalten.
- Sie möchten eine Bibliothek mit wiederverwendbaren ESQL-Subroutinen in einem
Nachrichtenbrokerprojekt oder eine Bibliothek mit Nachrichtenflüssen, die in
anderen Nachrichtenflüssen wiederverwendet werden sollen, erstellen. Ein Nachrichtenfluss, in dem
Sie diese Subroutinen oder Nachrichtenflüsse verwenden möchten, muss einen Verweis von seinem
übergeordneten Nachrichtenbrokerprojekt auf das
Nachrichtenbrokerprojekt enthalten.
- Des Weiteren können Sie mithilfe von Projektverweisen
Content-Assist im ESQL-Editor aktivieren. ("Content-Assist" ist eine Kontexthilfe, die gültige Methoden zur Vervollständigung einer Codeanweisung anzeigt.)
Wenn Sie einen Projektverweis von einem Nachrichtenbrokerprojekt mit
ESQL-Code auf ein Nachrichtengruppenprojekt einrichten, kann der ESQL-Editor eine Liste mit
gültigen Nachrichtenverweisen anzeigen.
- Wenn Sie mit dem Musterexplorer eine Musterinstanz aus einer Musterspezifikation erstellen, enthält das erzeugte Musterinstanzprojekt Verweise auf alle anderen mit diesem Muster erzeugten Projekte. Weitere Informationen hierzu finden Sie unter Muster verwenden.
Zur manuellen Erstellung oder zum manuellen Entfernen eines Projektverweises klicken Sie mit der rechten Maustaste in der Ansicht 'Brokerentwicklung' auf den Projektnamen und wählen Sie den Menüpunkt Eigenschaften aus. Wählen Sie im Fenster Eigenschaften Projektverweise aus, damit eine Liste aller festen Projekte im Arbeitsbereich angezeigt wird, aus der Sie Projektverweise auswählen oder löschen können. Nachrichtenfluss-, Nachrichtengruppen- und Musterinstanzprojekte verfügen über den zusätzlichen Menüpunkt Projektverweise hinzufügen oder entfernen, mit dem das Fenster Projektverweise hinzufügen oder entfernen geöffnet wird, in dem Sie Projektverweise auswählen oder löschen können.
Wenn Sie das Projekt, auf das verwiesen wurde, später schließen oder aus ihm ein Objekt löschen, steht dieses Objekt nicht mehr für das Projekt zur Verfügung, das
einen Verweis angibt, und es wird ein Fehler generiert. Diesen Fehler können Sie korrigieren,
wenn Sie das geschlossene Projekt öffnen oder das fehlende Objekt mit dem richtigen Namen
hinzufügen und speichern.