Altova RaptorXML+XBRL Server 2024

Catalog Structure in RaptorXML+XBRL Server

Home Prev Top Next

When RaptorXML+XBRL Server starts, it loads a file called RootCatalog.xml (structure shown in listing below), which contains a list of catalog files that will be looked up. You can modify this file and enter as many catalog files to look up as you like, each of which is referenced in a nextCatalog element. These catalog files are looked up and the URIs in them are resolved according to their mappings.

 

Listing of 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>

 

The listing above references a custom catalog (named CustomCatalog.xml) and a set of catalogs that locate commonly used schemas (such as W3C XML Schemas and the SVG schema).

 

CustomCatalog.xml is located in the RaptorXML+XBRL Server application folder's etc subfolder. You must create it from a template file named CustomCatalog_template.xml. It is a skeleton file in which you can create your own mappings. You can add mappings to CustomCatalog.xml for any schema you require that is not addressed by the catalog files in the Common Schemas Folder. Do this by using the supported elements of the OASIS catalog mechanism (see next section).

The Common Schemas Folder (located via the variable %CommonSchemasFolder%) contains a set of commonly used schemas. Inside each of these schema folders is a catalog.xml file that maps public and/or system identifiers to URIs that point to locally saved copies of the respective schemas.

Schemas related to XBRL and various XBRL taxonomies are large and are installed locally on demand with the help of Altova's Taxonomy Manager. Individual schemas and taxonomies are mapped in the catalog remapping.xml, which is located in the pkgs/.cache subfolder of the Program Data Folder (located via the variable %ApplicationWritableDatFolder%). Please do not edit this file; the smallest error could seriously compromise large sets of references.

CoreCatalog.xml  is located in the RaptorXML+XBRL Server application folder, and is used to locate schemas and stylesheets used by RaptorXML+XBRL Server-specific processes, such as StyleVision Power Stylesheets which are stylesheets used to generate Altova's Authentic View of XML documents.

 

Note the following:

 

During a new installation of the same major version (same or different minor versions), the template file will be replaced by a new template file, but CustomCatalog.xml will be left untouched.

However, if you are installing a new major version over a previous major version, then the previous major version folder will be deleted—together with its CustomCatalog.xml. So, if you want to continue using CustomCatalog.xml, make sure that you save CustomCatalog.xml from the previous major version folder to a safe place. After the new major version has been installed, you can copy the CustomCatalog.xml that you saved to the etc folder of the new major version and edit it there as required.

 

Location variables

The variables that are used in RootCatalog.xml (listing above) have the following values:

 

%PersonalFolder%

Personal folder of the current user, for example C:\Users\<name>\Documents

%CommonSchemasFolder%

C:\ProgramData\Altova\Common2024\Schemas

%ApplicationWritableDataFolder%

C:\ProgramData\Altova

 

Location of catalog files and schemas

Note the locations of the various catalog files.

 

RootCatalog.xml, CustomCatalog.xml, CustomCatalog_template.xml, and CoreCatalog.xml are in the RaptorXML+XBRL Server application folder.

The catalog.xml files are each in a specific schema folder, these schema folders being inside the Common Schemas Folder.

 

© 2018-2024 Altova GmbH