Validierung von Dokumenten und Schemata (DataStage)
Die XML-Ausgabe bietet eine Option zum Ausführen von zwei XML-Gültigkeitsprüfungen zur Laufzeit:
- Sucht nach korrekt formatierter XML.
- Prüft, ob Elemente und Attribute jedem XML-Schema entsprechen, auf das im Dokument verwiesen wird.
Wenn Sie sich für die Option entscheiden, werden beide Validierungen ausgeführt. Andernfalls findet keine Validierung statt.
Um auf ein Schema in Ihrem XML-Dokument zu verweisen, verwenden Sie das Attribut schemaLocation im Stammelementtag.
Informationen zum Aktivieren der Validierung für ein Schema finden Sie unter Stage-Eigenschaften.
Einstellen von XML-Schemaoptionen
Um die Validierung zu aktivieren, verwenden Sie die Option Strict. Um die Validierung zu deaktivieren, verwenden Sie die Option Default.
Der XML-Parser kompiliert das validierende Schema, um eine Schemagrammatik zu erstellen. Während der Validierung der Grammatik kann der Parser zusätzliche Schritte durchführen, die als vollständige Schemaeinschränkungsprüfung bezeichnet werden, was die Verarbeitungszeit erhöhen und speicherintensiv sein kann.
Wenn Ihr Auftrag zwei oder mehr XML-Dokumente erzeugt, die dasselbe Schema verwenden, können Sie die Neukompilierung des Schemas vermeiden, indem Sie die Grammatik zwischenlagern.
Informationen zur Aktivierung der Schemavalidierung finden Sie unter Stufen-Eigenschaften.
Validierungseinstellungen für XML-Schemata in DataStage
Legen Sie unter Eigenschaften die Eigenschaften für die Validierung der XML-Daten, die Protokollierung von Fehlern und die Zwischenspeicherung der Grammatik fest. In der XML-Phase wird geprüft, ob die Daten wohlgeformtes XML sind, und optional wird geprüft, ob sie einem referenzierten XML-Schema entsprechen. Um Standardwerte für Elemente und Attribute in den Ausgabedaten zu verwenden, müssen Sie in Ihren XML-Eingabedaten über das Attribut schemaLocation im Tag des Wurzelelements ein Schema angeben.
Der XML-Parser kompiliert das validierende Schema, um eine Schemagrammatik zu erstellen. Während der Validierung der Grammatik kann der Parser zusätzliche Schritte durchführen, die als vollständige Schemaeinschränkungsprüfung bezeichnet werden, was die Verarbeitungszeit erhöhen und speicherintensiv sein kann. Um diese Prüfung zu aktivieren, wählen Sie die Option Streng unter XML-Validierungsebene. Um diese Art der Validierung zu deaktivieren, verwenden Sie die Option Standard.
Wenn Ihr Job zwei oder mehr XML-Dokumente verarbeitet, die dasselbe Schema verwenden, können Sie die Neukompilierung des Schemas vermeiden, indem Sie die Grammatik zwischenlagern. Wählen Sie Grammatik-Caching aktivieren, um die Grammatik zwischenzuspeichern.
Definieren Sie Mappings zwischen dem Xalan XSLT Prozessor und DataStage, um festzulegen, wie Parsing-Meldungen und fehlerhafte XML-Dokumente verarbeitet werden. Ordnen Sie schwerwiegende Fehler, nicht schwerwiegende Fehler und Warnungen einer der in der folgenden Tabelle aufgeführten Fehlerstufen zu.
| DataStage Fehlerstufe | Ergebnis |
|---|---|
| Zurückweisen | Fehlerhafte Dokumentzeilen und Nachrichten können in eine Ablehnungs-Verknüpfung geschrieben werden, sofern eine solche existiert. Sie können die Meldungen auch an das Auftragsprotokoll senden. |
| Fatal | Der Auftrag wird beendet, und die Meldungen werden in das Auftragsprotokoll geschrieben. |
| Warnung | Eine Warnmeldung wird in das Auftragsprotokoll geschrieben. |
| Information | Eine Informationsmeldung wird in das Auftragsprotokoll geschrieben. |
| Trace | Debug- und Überwachungsinformationen werden in das Auftragsprotokoll geschrieben. |
Zuordnung von Validierungsfehlern zu DataStage Fehlern
Der XML-Parser meldet drei Arten von Bedingungen: fatal, error und warning.
- Fatale Fehler werden ausgelöst, wenn die XML-Datei nicht wohlgeformt ist.
- Nicht schwerwiegende Fehler werden ausgelöst, wenn die XML-Datei gegen eine Gültigkeitsbedingung verstößt. Zum Beispiel wird das Root-Element im Dokument nicht im validierenden XML-Schema gefunden.
- Es können Warnungen ausgegeben werden, wenn das Schema doppelte Definitionen enthält.
Weitere Informationen zu diesen Bedingungen finden Sie in den XML- und XML-Schema-Spezifikationen auf der Website des Worldwide Web Consortium.
Durch die Zuordnung von Parsing-Meldungen zu DataStage® Fehlerebenen entscheiden Sie, wie Parsing-Meldungen und fehlerhafte XML-Dokumente verarbeitet werden.
Die folgende Tabelle beschreibt, wie die einzelnen DataStage-Fehlerstufen verarbeitet werden.
| DataStage Fehlerstufe | Ergebnis |
|---|---|
| Zurückweisen | Fehlerhafte Dokumentzeilen und Nachrichten können in eine Ablehnungs-Verknüpfung geschrieben werden, sofern eine solche existiert. Sie können die Meldungen auch an das Auftragsprotokoll senden. Weitere Informationen zur Verarbeitung von Nachrichten und Dokumenten finden Sie unter Verwendung von Ablehnungslinks. |
| Fatal | Der Serverauftrag wird beendet, und die Meldungen werden in das Auftragsprotokoll geschrieben. |
| Warnung | Eine Warnmeldung wird in das Auftragsprotokoll geschrieben. |
| Information | Eine Informationsmeldung wird in das Auftragsprotokoll geschrieben. |
| Trace | Wenn der Auftrag mit eingeschalteter Ablaufverfolgung läuft, werden Debug- und Überwachungsinformationen in das Auftragsprotokoll geschrieben. |
Weitere Informationen über Zuordnungsfehler und deren Protokollierung finden Sie unter Stufen-Eigenschaften.
Ablehnende Links verwenden
Die XML-Ausgabe unterstützt einen Reject-Link, der Ablehnungsmeldungen und abgelehnte Zeilen speichern kann.
Schreiben von Ablehnungsmeldungen an den Link
So schreiben Sie Ablehnungsmeldungen in einen Ablehnungslink:
- Fügen Sie eine Spalte für den Link Ablehnen hinzu.
- Bestimmen Sie auf der Seite Allgemein der Eigenschaften der Ausgabeverknüpfung die Spalte als Ziel für die Ablehnungsmeldungen.
Abgelehnte Zeilen in den Link schreiben
Um abgelehnte Zeilen in einen Reject-Link zu schreiben:
Fügen Sie der Ablehnungs-Verknüpfung eine Spalte hinzu, die denselben Namen hat wie die Spalte der Zielspalte in der Ausgabe-Verknüpfung.
Bei den Spaltennamen für diesen Vorgang wird zwischen Groß- und Kleinschreibung unterschieden.
Informationen zum Einrichten eines Reject-Links finden Sie unter Eigenschaften von Output-Links.
Schreiben von Ablehnungsmeldungen in das Auftragsprotokoll
Um Ablehnungsmeldungen in das Auftragsprotokoll zu schreiben:
Markieren Sie auf der Seite Validierungseinstellungen der Bühneneigenschaften das Feld Ablehnungsfehler protokollieren.
Weitere Informationen über die Seite Allgemein finden Sie unter Eigenschaften der Bühne.