Import aus XML-Schemas zum Erstellen von Nachrichtendefinitionen

Sie können eine Nachrichtengruppe mit Nachrichtendefinitionen auffüllen, indem Sie die XML-Schemadateien mit Hilfe des Assistenten für neue Nachrichtendefinitionsdateien oder dem Befehlszeilendienstprogramm mqsicreatemsgdefs importieren.

Mit jeder importierten XML-Schemadatei wird eine neue Nachrichtendefinitionsdatei in der Nachrichtengruppe erstellt. Der Stammname der Nachrichtendefinitionsdatei entspricht standardmäßig dem Namen der XML-Schemadatei. Sie können jedoch mit dem Assistenten für Neue Nachrichtendefinitionsdatei einen anderen Stammdateinamen auswählen.

Wenn die Nachrichtendefinitionsdatei bereits existiert, müssen Sie ein Überschreiben zugelassen haben, damit der Import fortgesetzt werden kann. In diesem Fall wird der vorhandene Inhalt gelöscht und erneut erstellt.

Der Namensbereich, dem die erstellte Nachrichtendefinitionsdatei angehört, richtet sich danach, ob Namensbereiche für die Nachrichtengruppe aktiviert wurden.

Während des Imports wird eine Berichtsdatei erstellt. Sie befindet sich standardmäßig im Ordner log (Protokoll) der Nachrichtengruppe. Standardmäßig übernimmt sie den Namen der Nachrichtendefinitionsdatei mit der Erweiterung .report.txt.

Importieren mit dem Assistenten für neue Nachrichtendefinitionsdateien

Wenn Sie beim Importieren den Assistenten für Neue Nachrichtendefinitionsdatei zu Hilfe nehmen, können Sie angeben, welche globalen Elemente in der importierten XML-Schemadatei Nachrichten in der Nachrichtendefinitionsdatei sein sollen.

Sie können nur immer eine XML-Schemadatei importieren. Wenn Ihre XML-Schemadatei durch Importieren oder Einschließen auf andere XML-Schemadateien verweist, müssen diese XML-Schemadateien in einem separaten Importvorgang in dieselbe Nachrichtengruppe importiert werden.

Importieren mit der Befehlszeile

Wenn Sie mit Hilfe der Befehlszeile importieren, können Sie entweder keine Nachrichten erstellen oder eine Nachricht für jedes globale Element in der importierten XML-Schemadatei. Beim Import werden für jedes globale Element, das Sie angeben, eine Nachricht und die entsprechenden globalen Elemente in einer Nachrichtendefinitionsdatei erstellt. Wenn Sie nicht angeben, dass Nachrichten erstellt werden sollen, müssen Sie sie nach Beendigung des Imports mit Hilfe des Nachrichtendefinitions-Editors manuell erstellen.

Sie können mit jedem Importvorgang mehrere XML-Schemadateien importieren.

Physische Informationen

Neben logischen Informationen kann der Import auch physische Informationen erstellen. Wenn die Nachrichtengruppe physische XML-Formate enthält, werden die physischen Formateigenschaften für alle physischen XML-Formatschichten aufgefüllt. Enthält die Nachrichtengruppe keine physischen XML-Formate, werden nur logische Informationen erstellt. Wenn Sie aus der Befehlszeile importieren, werden standardmäßig ebenfalls nur logische Informationen in der neuen Nachrichtengruppe erstellt. Ausführliche Informationen zum zusätzlichen Erstellen von physischen Informationen finden Sie unter Import von einer Befehlszeile aus.

Die Eigenschaften der physischen CWF- und TDS-Formate werden nicht aufgefüllt und übernehmen daher Standardwerte.

Bei einer oder mehreren CWF- oder TDS-Schichten kann der Import zu Einträgen in der Taskliste führen, die Sie warnen, dass bestimmte CWF- und TDS-Eigenschaften eingerichtet sein müssen, wenn die XML-Strukturen, die Sie importiert haben, in einer CWF- oder TDS-Nachricht angezeigt werden sollten.

Wenn die physischen CWF- oder TDS-Formate nicht auf Ihre XML-Strukturen anwendbar sind, können Sie diese Einträge in die Taskliste ignorieren, da es sich lediglich um Warnungen handelt. Sie verhindern nicht, dass Ihr Modell in einem anderen Format, beispielswiese als Nachrichten-Dictionary, generiert wird.

Befehlszeilenaufruf

Das Befehlszeilendienstprogramm mqsicreatemsgdefs ermöglicht Ihnen, mehrere XML-Schemadateien mit einem einzigen Vorgang zu importieren. Alle XML-Schemadateien müssen sich in einem Verzeichnis befinden, und die Verzeichnisposition muss als Parameter an das Dienstprogramm üb ergeben worden sein.

Wenn Sie in eine Nachrichtengruppe importieren, für die keine Namensbereiche aktiviert sind, kann die für nicht unterstützte Konstrukte auszuführende Aktion unter Verwendung einer XML-Optionsdatei festgelegt werden. Diese muss ein XML-Element namens <XSD_NO_NS> enthalten. In diesem Element befindet sich eine Reihe von Informationen, die für alle XML-Schemadateien gelten, die beim Aufruf des Dienstprogramms importiert wurden. Eine XML-Standardoptionsdatei namens mqsicreatemsgdefs.xml steht zur Verfügung. Wenn Sie verschiedene Informationen auf verschiedene XML-Schemadateien anwenden möchten, müssen Sie mehrere XML-Dateien erstellen und das Dienstprogramm mehrmals ausführen.

Es gibt zwei weitere Optionen, die Sie im Element <XSD_NO_NS> in der XML-Optionsdatei angeben können, wenn Sie in eine Nachrichtengruppe mit inaktivierten Namensbereichen importieren:

Das Dienstprogramm mqsicreatemsgdefs ermöglicht Ihnen zudem, als Teil des Importvorgangs eine neue Nachrichtengruppe zu erstellen, in der die Nachrichtendefinitionsdateien gespeichert werden. Sie können auch festlegen, ob die erstellte Nachrichtengruppe auf einer bestehenden Nachrichtengruppe basieren soll. Mit dieser Funktion können Sie eine leere Nachrichtengruppe vorbereiten, die ein physisches XML-Format und vorab aufgefüllte XML-Eigenschaften auf Nachrichtengruppenebene enthält, die dann in die beim Import erstellte Nachrichtengruppe kopiert werden.

Weitere Informationen zu XML-Schema

Ausführliche Informationen zum XML-Schema finden Sie unter XML Schema Part 0: Primer auf der World Wide Web Consortium (W3C) Website.

Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
ad00834_