Anpassen von Katalogen
Wenn Sie Einträge für CustomCatalog.xml (oder jede andere Katalogdatei, die von RaptorXML Server gelesen werden soll) erstellen, verwenden Sie nur die folgenden Elemente der OASIS-Katalogspezifikation. Jedes der unten angeführten Elemente wird mit einer Erläuterung der Attributwerte aufgelistet. Eine ausführlichere Beschreibung finden Sie in der XML Catalogs Specification. Beachten Sie, dass jedes Element das Attribut xml:base, mit dem die Basis-URI dieses Elements definiert wird, erhalten kann.
•<public publicId="PublicID of Resource" uri="URL of local file"/>
•<system systemId="SystemID of Resource" uri="URL of local file"/>
•<uri name="filename" uri="URL of file identified by filename"/>
•<rewriteURI uriStartString="StartString of URI to rewrite" rewritePrefix="String to replace StartString"/>
•<rewriteSystem systemIdStartString="StartString of SystemID" rewritePrefix="Replacement string to locate resource locally"/>
Beachten Sie die folgenden Punkte:
•In Fällen, in denen es keinen Public Identifier gibt, kann der System Identifier einer URL wie z.B. bei den meisten Stylesheets über das system Element direkt auf eine URL gemappt werden.
•Eine URI kann über das uri Element auf eine andere URI gemappt werden.
•Mit Hilfe der Elemente rewriteURI und rewriteSystem kann der Anfangsteil einer URI bzw. eines System Identifiers neu geschrieben werden. Dadurch kann der Anfang eines Dateipfads ersetzt werden, sodass ein anderes Verzeichnis als Ziel gewählt werden kann. Nähere Informationen zu diesen Elementen finden Sie in der XML Catalogs Specification.
Ab Release 2014 entspricht RaptorXML Server weitgehend der XML Catalogs Specification (OASIS Standard V1.1, 7 Oktober 2005). In dieser Spezifikation wird streng zwischen externen Identifier Look-ups (jenen mit einer öffentlichen ID oder einer System-ID) und URI Look-ups (URIs, die keine öffentlichen IDS oder System-IDs sind) getrennt. Namespace URIs müssen daher einfach als URIs - und nicht Public IDs oder System-IDs - behandelt werden und folglich als URI Look-ups anstelle von externen Identifier Look-ups verwendet werden. In RaptorXML Server Versionen vor Version 2014 wurden Schema Namespace URIs über <public> Mappings übersetzt. Ab Version 2014 müssen <uri> Mappings verwendet werden.
Vor v2014: <public publicID="http://www.MyMapping.com/ref" uri="file:///C:/MyDocs/Catalog/test.xsd"/>
Ab V-2014: <uri name="http://www.MyMapping.com/ref" uri="file:///C:/MyDocs/Catalog/test.xsd"/>
Wie findet RaptorXML Server ein referenziertes Schema
Ein Schema wird in einem XML-Dokument über das Attribut xsi:scemaLocation (siehe unten) referenziert. Der Wert des xsi:schemaLocation-Attributs besteht aus zwei Teilen: einem Namespace-Teil (grün) und einem URI-Teil (markiert).
xsi:schemaLocation="http://www.xmlspy.com/schemas/orgchart OrgChart.xsd"
Welche Schritte anschließend durchgeführt werden müssen, um ein referenziertes Schema zu finden, hängt von den Validierungsoptionen --schemalocation-hints und --schema-mapping ab. Im Folgenden wird die Vorgangsweise für jeden einzelnen Wert der beiden Optionen beschrieben:
•--schemalocation-hints=load-by-schemalocation | load-by-namespace | load-combining-both | ignore
Definiert das Verhalten der Attribute xsi:schemaLocation und xsi:noNamespaceSchemaLocation: ob ein Schema-Dokument geladen werden soll und falls ja, anhand welcher Informationen es gesucht werden soll; (die Standardeinstellung ist load-by-schemalocation).
❖load-by-schemalocation
1.Wenn der URI-Teil von xsi:schemaLocation in einem Katalog gemappt wurde, wird die erzeugte URI geladen.
2.URI direkt laden.
❖load-by-namespace
1.Wenn der namespace-Teil von xsi:schemaLocation in einem Katalog gemappt wurde, wird die erzeugte URI geladen.
2.Nichts laden.
❖load-combining-both
1.Wenn der URI-Teil von xsi:schemaLocation in einem Katalog gemappt wurde, wird die erzeugte URI geladen.
2.Wenn der namespace-Teil von xsi:schemaLocation in einem Katalog gemappt wurde, wird die erzeugte URI geladen.
3.URI-Teil direkt laden.
•--schema-mapping=prefer-schemalocation | prefer-namespace
Wenn ein Schema-Dokument sowohl anhand des Schema-Pfads als auch des Namespace gesucht werden soll, wird mit dieser Option festgelegt, welche der beiden Optionen beim Katalog-Lookup Vorrang erhält; (die Standardeinstellung ist prefer-schemalocation). Mit Hilfe dieser Option wird die Reihenfolge der ersten beiden Schritte in der load-combining-both-Variante oben geändert.
XML-Schema-Spezifikationen
Die XML-Schemaspezifikationsinformationen sind in RaptorXML Server integriert und die Gültigkeit von XML-Schema- (.xsd)-Dokumenten wird anhand dieser internen Informationen überprüft. Daher sollte in einem XML-Schema-Dokument kein Verweis auf ein Schema, das die XML-Schema-Spezifikation definiert, vorgenommen werden.
Die Datei catalog.xml im Ordner %AltovaCommonSchemasFolder%\Schemas\schema enthält Referenzen auf DTDs, die ältere XML-Schema-Spezifikationen implementieren. Sie sollten Ihre XML-Schema-Dokumente nicht anhand dieser Schemas validieren. Zweck dieser beiden DTDs ist es einzig und allein, für die Eingabehilfen von RaptorXML Server zu Bearbeitungszwecken Informationen bereitzustellen, falls Sie Dateien gemäß diesen älteren Empfehlungen erstellen wollen.