Katalogstruktur in RaptorXML+XBRL Server
RaptorXML+XBRL Server lädt beim Start eine Datei namens RootCatalog.xml(Struktur siehe unten), die eine Liste von Katalogdateien enthält, die durchsucht werden. Sie können diese Datei bearbeiten und beliebig viele Katalogdateien definieren, die durchsucht werden sollen. Jede davon wird in einem nextCatalog referenziert. Diese Katalogdateien werden durchsucht und die URIs darin werden entsprechend ihren Mappings aufgelöst.
Codefragment von RootCatalog.xml
<?xml version="1.0" encoding="UTF-8"?>
<catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog"
xmlns:spy="https://www.altova.com/catalog_ext"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="urn:oasis:names:tc:entity:xmlns:xml:catalog Catalog.xsd">
<nextCatalog catalog="%PersonalFolder%/Altova/%AppAndVersionName%/CustomCatalog.xml"/>
<!-- Include all catalogs under common schemas folder on the first directory level -->
<nextCatalog spy:recurseFrom="%CommonSchemasFolder%" catalog="catalog.xml" spy:depth="1"/>
<nextCatalog spy:recurseFrom="%ApplicationWritableDataFolder%/pkgs/.cache" catalog="remapping.xml" spy:depth="0"/>
<nextCatalog catalog="CoreCatalog.xml"/>
</catalog>
Im obigen Codefragment wird ein benutzerdefinierter Katalog namens CustomCatalog.xml und eine Gruppe von Katalogen, die gebräuchliche Schemas (wie z.B. W3C XML-Schemas udn das SVG-Schema) referenzieren, referenziert.
•CustomCatalog.xml befindet sich im Unterordner etc des RaptorXML+XBRL Server-Applikationsordners. Sie müssen die Datei anhand einer Vorlagendatei namens CustomCatalog_template.xml erstellen. Diese Datei ist eine Skelettdatei, in der Sie Ihre eigenen Mappings erstellen können. Sie können für jedes gewünschte Schema, das nicht in den Katalogdateien im Altova Ordner "Common Schemas" enthalten ist, Mappings zu CustomCatalog.xml hinzufügen. Verwenden Sie dazu die unterstützten Elemente des OASIS-Katalogmechanismus (siehe nächster Abschnitt).
•Der durch die Variable %CommonSchemasFolder% definierte Ordner "Common Schemas" enthält eine Reihe gebräuchlicher Schemas. Innerhalb dieser einzelnen Schema-Ordner befindet sich eine catalog.xml-Datei, die Public und/oder System Identifier auf URIs mappt, die auf lokal gespeicherte Kopien des jeweiligen Schemas verweisen.
•Schemas, die im Zusammenhang mit XBRL-Dateien und verschiedenen XBRL-Taxonomien stehen, sind sehr umfangreich und werden bei Bedarf mit Hilfe des Altova Taxonomie-Managers lokal installiert. Die einzelnen Schemas und Taxonomien werden im Katalog remapping.xml, der sich im Unterordner pkgs/.cache des Ordners Program Data befindet (dessen Pfad durch die Variable %ApplicationWritableDatFolder% angegeben wird), gemappt. Bitte bearbeiten Sie diese Datei nicht; der kleinste Fehler hätte schwerwiegende Folgen für große Gruppen von Referenzen.
•CoreCatalog.xml befindet sich im RaptorXML+XBRL Server-Applikationsordner und dient zum Auffinden von Schemas und Stylesheets, die von RaptorXML+XBRL Server-spezifischen Prozessen wie z.B. StyleVision Power Stylesheets, anhand derer die Altova-Authentic-Ansicht von XML-Dokumenten generiert wird.
Beachten Sie dazu Folgendes:
•Bei einer Neuinstallation derselben Hauptversion (selbe oder unterschiedliche Nebenversion) wird die Vorlagendatei durch eine neue Vorlagendatei ersetzt, wobei CustomCatalog.xml jedoch unverändert bleibt.
•Wenn Sie jedoch eine neue Hauptversion über eine vorherige Hauptversion installieren, wird der Ordner der vorherigen Hauptversion zusammen mit seiner CustomCatalog.xml-Datei gelöscht. Wenn Sie also CustomCatalog.xml weiterhin verwenden möchten, müssen Sie CustomCatalog.xml aus dem Ordner der vorherigen Hauptversion in einem anderen Ordner sichern. Nach Installation der neuen Hauptversion können Sie die zuvor gespeicherte Datei CustomCatalog.xml in den Ordner etc der neuen Hauptversion kopieren und dort je nach Bedarf bearbeiten.
Pfadvariablen
Die in RootCatalog.xml verwendeten Variablen (Codefragment oben) haben die folgenden Werte:
%PersonalFolder% | Der persönliche Ordner des aktuellen Benutzers, z.B. C:\Benutzer\<Name>\Dokumente |
%CommonSchemasFolder% | C:\ProgramData\Altova\Common2024\Schemas |
%ApplicationWritableDataFolder% | C:\ProgramData\Altova |
Speicherpfad von Katalogdateien und Schemas
Beachten Sie die Pfade der verschiedenen Katalogdateien.
•Die Dateien RootCatalog.xml, CustomCatalog.xml, CustomCatalog_template.xml und CoreCatalog.xml befinden sich im RaptorXML+XBRL Server Applikationsordner.
•Die catalog.xml-Dateien befinden sich jeweils in einem eigenen Schemaordner, wobei sich diese Schemaordner innerhalb des Ordners "Common Schemas" befinden: