WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

Nachrichtenzuordnung aus einer Datei .msgmap in eine Datei .map umwandeln

Nachrichtenzuordnungen aus früheren Versionen von WebSphere Message Broker müssen in grafische Datenzuordnungen konvertiert werden, damit sie im Editor für grafische Datenzuordnungen bearbeitet werden können.

Vor der Umwandlung einer Nachrichtenzuordnungsdatei muss eine der folgenden Tasks ausgeführt werden: Lesen Sie, bevor Sie beginnen, außerdem die Abschnitte Änderungen im Verhalten von grafischen Datenzuordnungen, die aus Nachrichten konvertiert werden und Überlegungen zur Zuordnung von in Nachrichtengruppen modellierten Nachrichten.

Wenn die Messaging-Lösungen aus WebSphere Message Broker Version 6.1 oder Version 7.0 importiert werden, können Nachrichtenflüsse, die Nachrichtenzuordnungsdateien (.msgmap) verwenden, weiterhin kompiliert und implementiert werden, wenn der Nachrichtenfluss mit der Option compile and in-line resources (Ressourcen kompilieren und integrieren) in einer BAR-Datei erstellt wurde. Allerdings ist in WebSphere Message Broker Version 8.0 und höher nur ein Lesezugriff auf Nachrichtenzuordnungsdateien möglich, diese Dateien können nicht mit dem WebSphere Message Broker Toolkit geändert werden.

In WebSphere Message Broker Version 8.0 und höher muss eine Nachrichtenzuordnung in eine grafische Datenzuordnung (.map-Datei) umgewandelt werden, wenn in der Nachrichtenzuordnung definierte Zuordnungsoperationen geändert werden sollen. Der Konvertierungsprozess ist nicht reversibel.
Wichtig: Bei Umwandlung einer Nachrichtenzuordnung können Nachrichtenflüsse, die auf die nicht umgewandelte Nachrichtenzuordnung verweisen, erst implementiert werden, nachdem jeder einzelne Nachrichtenfluss so geändert wurde, dass er auf die neue grafische Datenzuordnung verweist. Mapping-Knoten und ESQL-Rechenknoten aus früheren Versionen von WebSphere Message Broker müssen durch einen neuen Mapping-Knoten ersetzt werden. ESQL-Rechenknoten werden in grafischen Datenzuordnungen nicht unterstützt, da die scriptgesteuerten Zuordnungen in einer dedizierten Laufzeitengine ausgeführt werden, die nur über einen neuen Mapping-Knoten aufgerufen werden kann. Weitere Informationen finden Sie im Abschnitt Mapping-Knoten der WebSphere Message Broker Version 7.0 ersetzen.

Gehen Sie wie folgt vor, um eine Nachrichtenzuordnung über das WebSphere Message Broker Toolkit in eine grafische Datenzuordnung umzuwandeln:

  1. Klicken Sie in der Ansicht Brokerentwicklung mit der rechten Maustaste auf die umzuwandelnde Datei .msgmap und klicken Sie auf Convert Message Map from .msgmap to .map (Nachrichtenzuordnung von .msgmap in .map umwandeln). Wenn Sie mehrere Nachrichtenzuordnungen umwandeln möchten, klicken Sie mit der rechten Maustaste auf einen Ordner, ein Projekt, eine Anwendung oder eine Bibliothek mit einer oder mehreren Dateien .msgmap und klicken Sie auf Convert Message Map from .msgmap to .map, um alle enthaltenen Nachrichtenzuordnungen umzuwandeln. Die neue grafische Datenzuordnung wird erstellt und in der Ansicht Brokerentwicklung angezeigt. Die Nachrichtenzuordnung wird in Name_der_Nachrichtenzuordnung.msgmap_backup umbenannt und in der Ansicht Brokerentwicklung angezeigt.
  2. Klicken Sie in der Ansicht Brokerentwicklung doppelt auf die neue grafische Datenzuordnung (Datei .map). Die grafische Datenzuordnung wird im Editor für grafische Datenzuordnungen geöffnet.
  3. Prüfen Sie, ob die durch die Konvertierung entstandene Transformationslogik die für Ihre Anwendung passende Ausgabe generiert.
  4. Zu den Transformationen Ihrer neuen grafischen Datenzuordnung werden unter Umständen Anmerkungssymbole zur Konvertierung angezeigt. Diese Transformationen sollten unbedingt überprüft werden. Die Anmerkungssymbole befinden sich im Editor für grafische Datenzuordnungen links unten in der Transformation. Gehen Sie wie folgt vor, um eine Warnung bezüglich einer Transformation zu prüfen:
    1. Wählen Sie im Editor für grafische Datenzuordnungen eine Transformation mit einem solchen Anmerkungssymbol aus. In der Ansicht Eigenschaften werden die Transformationseigenschaften angezeigt.
    2. Klicken Sie in der Ansicht Eigenschaften auf die Registerkarte Dokumentation, um Einzelheiten zu der Warnung abzurufen. Der Abschnitt Warnungen zu umgewandelten Transformationen enthält weitere Informationen hierzu.
    3. Klicken Sie im Editor für grafische Datenzuordnungen mit der rechten Maustaste auf die Transformation und wählen Sie entweder Akzeptieren aus, um die Warnung für diese Transformation zu entfernen, oder Zurückweisen, um die Transformation aus der Zuordnung zu entfernen und durch eine Tasktransformation zu ersetzen.
    Nachdem Sie die Transformationen einer konvertierten Zuordnung geprüft haben, können Sie alternativ auch alle Transformationen mit Anmerkungen mittels einer einzigen Menüaktion akzeptieren oder ablehnen. Zum Öffnen des hierfür erforderlichen Kontextmenüs klicken Sie mit der rechten Maustaste auf einen leeren Bereich der Zuordnung, so dass keine Transformation ausgewählt ist.
  5. Wiederholen Sie Schritt 4 für jede Transformation in der Datei .map, zu der es eine Warnung gibt.
  6. Falls Ihre Nachrichtenzuordnung komplexe Zuordnungsstrukturen umfasste, die vom Konvertierungsprozess nicht neu erstellt werden konnten, enthält die neue grafische Datenzuordnung Tasktransformationen zur Unterstützung beim manuellen erneuten Erstellen dieser Strukturen. Die grafische Datenzuordnung kann erst in einer Messaging-Lösung verwendet werden, nachdem Sie jede einzelne Tasktransformation geprüft und ersetzt haben. Tasktransformationen sind in der Ansicht Probleme aufgeführt. Gehen Sie zur Prüfung einer Tasktransformation wie folgt vor:
    1. Wählen Sie im Editor für grafische Datenzuordnungen eine Tasktransformation aus. Die Transformationseigenschaften werden in der Eigenschaftsansicht angezeigt.
    2. Klicken Sie in der Ansicht Eigenschaften auf die Registerkarte Dokumentation, um Einzelheiten zu dem Teil der Zuordnungsstruktur abzurufen, die vom Konvertierungsprozess nicht erneut erstellt wurde.
    3. Ändern Sie im Editor für grafische Datenzuordnungen die Tasktransformation in einen funktionalen Transformationstyp. Klicken Sie dazu auf den Pfeil im Transformationsfenster und wählen Sie einen Eintrag in der Liste der verfügbaren Transformationen aus. Weitere Informationen zur Bearbeitung grafischer Datenzuordnungen finden Sie im Abschnitt Grafische Datenzuordnung bearbeiten.
  7. Wiederholen Sie Schritt 6 für jede Tasktransformation in der Datei .map.
Die Nachrichtenzuordnung wird in eine grafische Datenzuordnung umgewandelt, die im Editor für grafische Datenzuordnungen geändert werden kann.
Nächste Schritte:

Nach der Konvertierung einer Nachrichtenzuordnung muss jeder einzelne Nachrichtenfluss, der auf die Nachrichtenzuordnung verweist, so geändert werden, dass er stattdessen auf die neue grafische Datenzuordnung verweist (siehe Mapping-Knoten der WebSphere Message Broker Version 7.0 ersetzen).

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:23:21


TaskthemaTaskthema | Version 8.0.0.5 | br40806_