Estructura de los catálogos en RaptorXML+XBRL Server
Al iniciarse, RaptorXML+XBRL Server carga un archivo llamado RootCatalog.xml (cuya estructura aparece a continuación), que contiene una lista de los archivos de catálogo que se buscarán. El usuario puede modificar esta lista y añadir tantos archivos de catálogo como desee, escribiendo cada archivo en un elemento nextCatalog. La aplicación busca cada uno de estos archivos de catálogo y sus URI se resuelven de acuerdo con sus asignaciones.
Extracto de 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>
El extracto anterior hace referencia a un catálogo personalizado (CustomCatalog.xml) y a un conjunto de catálogos que localizan los esquemas usados a menudo (como W3C XML Schemas y el esquema SVG).
•CustomCatalog.xml se encuentra enla subcarpeta etc de la aplicación RaptorXML+XBRL Server. Debe crear el archivo a partir de una plantilla llamada CustomCatalog_template.xml. Es un archivo base en el que el usuario puede crear asignaciones propias. Puede añadir asignaciones a CustomCatalog.xml para cualquier esquema que necesite que no aparezca en los archivos de catálogo de la carpeta Common Schemas. Debe usar los elementos compatibles del mecanismo de catálogo OASIS (véase más abajo).
•La carpeta Common Schemas Folder (a la que se accede con la variable %CommonSchemasFolder%) contiene un conjunto de esquemas de uso habitual. Dentro de cada una de estas carpetas hay un archivo catalog.xml que asigna identificadores públicos y/o del sistema a URIs que apuntan a copias locales de los esquemas correspondientes.
•Los esquemas relacionados con XBRL y varias taxonomías XBRL son grandes y se instalan localmente a petición con ayuda del Gestor de taxonomías de Altova. Los esquemas y las taxonomías individuales se asignan en el catálogo remapping.xml, que se encuentra en la subcarpeta pkgs/.cache de la carpeta Program Data (a la que puede acceder con la variable %ApplicationWritableDatFolder%).
•CoreCatalog.xml está en la carpeta de la aplicación <%XMLSPY%> y se usa para localizar esquemas y hojas de estilos que usan los procesos específicos de <%XMLSPY%>, como los archivos SPS de StyleVision, que se usan para generar documentos XML para la Vista Authentic de Altova.
Tenga en cuenta que:
•Durante una instalación nueva de la misma versión principal (misma u otra subversión), el archivo de plantilla se sustituye por uno nuevo, pero CustomCatalog.xml no cambia.
•Sin embargo, si instala una versión principal nueva sobre una versión principal anterior, la carpeta de la instalación anterior se borra junto con su archivo CustomCatalog.xml. Por tanto, si quiere seguir usando el CustomCatalog.xml de la versión anterior debe guardarlo en una ubicación segura. Después de instalar la versión principal nueva puede copiar el archivo CustomCatalog.xml guardado en la carpeta etc de la versión principal nueva y editarlo allí como necesite.
Variables de ubicación
Las variables que se usan en RootCatalog.xml (véase el extracto más arriba) tienen estos valores:
%PersonalFolder% | La carpeta personal del usuario, por ejemplo C:\Users\<name>\Documents. |
%CommonSchemasFolder% | C:\ProgramData\Altova\Common2025\Schemas |
%ApplicationWritableDataFolder% | C:\ProgramData\Altova |
Ubicación de los archivos de catálogo y los esquemas
Estas son las ubicaciones de los distintos archivos de los catálogos.
•RootCatalog.xml, CustomCatalog.xml, y CoreCatalog.xml se instalan en la carpeta de aplicación de <%XMLSPY%>.
•Cada archivo catalog.xml está en una carpeta de esquema y estas carpetas están dentro de la carpeta común de esquemas.