Nachrichtenzuordnung programmgesteuert erstellen

Verwenden Sie die Spezifikationssprache für grafische Datenzuordnungen, um eine Nachrichtenzuordnung programmgesteuert zu erstellen.

Informationen zu dieser Task

Die Datei msl.xsd stellt das XML-Schema bereit, das die Spezifikationssprache für grafische Datenzuordnungen, auch MSL genannt, beschreibt. Diese Datei ist in Graphical Data Mapping Component Version 1040 und neueren Versionen verfügbar.

Sie finden die Datei msl.xsd in der JAR-Datei com.ibm.msl.mapping.api_7.5.0.jar.

Unter IBM® App Connect Enterprise finden Sie die JAR-Datei in einem der folgenden Verzeichnisse:
  • In einer Windows-Plattforminstallation: C:\Program Files\IBM\IIB\10.0.0.0\server\ct\lib\
  • Installation auf einer Linux® -Plattform: install_dir/iib-10.0.0.0/server/ct/lib/

Wenn Sie Metadaten haben, die die Transformationslogik definieren, die zum Erzeugen der Ausgabe auf eine Eingabenachricht angewendet werden muss, können Sie eine Zuordnung programmgesteuert erstellen. Sie können beispielsweise ein JAXB-basiertes Programm schreiben, das die Zuordnung mithilfe von JAXB-Klassen erstellt, die aus dem bereitgestellten MSL-Schema generiert werden. Das Programm liest XML-Daten, die die zuzuordnenden Eingabeelemente und die Ausgabeelemente definieren.

Vorgehensweise

Sie müssen die folgenden Schritte ausführen, um eine Zuordnungsdatei programmgesteuert zu generieren:

  1. Erstellen Sie eine Vorlagenzuordnung in Editor für grafische Datenzuordnung.

    Implementieren und testen Sie Ihre Vorlagenzuordnung in der Laufzeitumgebung, zum sicherzustellen, dass die Nachrichtentransformation korrekt ist.

  2. Überprüfen Sie den MSL-XML-Inhalt in der Vorlagenzuordnung.

    Verwenden Sie das MSL-Schema, um die Zuordnungskonstrukte und die Punktdefinitionsvarianten für die Vorlagenzuordnung zu identifizieren.

  3. Entwickeln Sie die Scripts und Programme, um die MSL-XML für die neuen Zuordnungen zu generieren, die Sie programmgesteuert generieren möchten.

    Wenn Sie einen auf JAXB basierenden Entwicklungsansatz verwenden, stellt die in der JAR-Datei com.ibm.msl.mapping.api_7.5.0.jar verfügbare Datei msl_jaxb_bindings.xml die mindestens erforderlichen Bindungen bereit.

  4. Überprüfen Sie die Syntax jeder generierten Zuordnungsdatei (.map) anhand des bereitgestellten MSL-Schemas msl.xsd.
  5. Importieren Sie jede generierte Zuordnungsdatei in Ihre Entwicklungsumgebung. Überprüfen Sie dann, ob alle referenzierten Ressourcen, wie z. B. xsd-Dateien, in die relevanten Projekttypen importiert werden. Stellen Sie sicher, dass der entsprechende Builder für die semantische Validierung jeder generierten Zuordnungsdatei aufgerufen wird. Überprüfen Sie außerdem mithilfe des Editors für grafische Datenzuordnungen , ob die Transformationen in Ihrer generierten Zuordnung korrekt und fehlerfrei sind.
  6. Packen und implementieren Sie Ihre generierten Zuordnungen programmgesteuert in der Laufzeitumgebung. Testen Sie Ihre Anwendung anschließend, um sicherzustellen, dass die Nachrichtentransformation korrekt ist.

    Vergewissern Sie sich, dass jede generierte Zuordnungsdatei im entsprechenden Implementierungsartefakt erstellt wird.

Nächste Schritte

Implementieren und testen Sie die Nachrichtenzuordnung. Weitere Informationen finden Sie unter Fehlerbehebung bei Nachrichtenzuordnungen.