Personalizar catálogos
Cuando cree entradas en el archivo CustomCatalog.xml (o en cualquier otro archivo de catálogo que sea leído por RaptorXML Server), utilice únicamente los elementos que aparecen a continuación de la especificación de catálogos OASIS. En la lista que aparece más adelante explicamos los valores de los atributos de cada elemento. Si desea consultar una descripción más detallada, visite la página de la especificación XML Catalogs. Tenga en cuenta que cada uno de los elementos del subconjunto pueden llevar el atributo xml:base, que se usa para especificar el URI base del elemento.
•<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"/>
Tenga en cuenta que:
•Cuando no exista un identificador público, como es el caso de casi todas las hojas de estilos, el identificador de sistema se puede asignar directamente a una URL con el elemento system.
•Un URI se puede asignar a otro URI con el elemento uri.
•Los elementos rewriteURI y rewriteSystem sirven para volver a escribir la parte inicial de un URI o identificador de sistema respectivamente. Gracias a ello se puede sustituir el principio de la ruta de acceso de un archivo y, por consiguiente, se puede apuntar a otro directorio. Para más información sobre estos elementos, consulte la especificación XML Catalogs.
A partir de su versión de 2014 RaptorXML Server cumple escrupulosamente con la especificación de catálogos XML XML Catalogs specification (OASIS Standard V1.1, 7 October 2005) Esta especificación separa estrictamente las consultas por identificador externo (las realizadas con un ID público o de sistema) de las búsquedas por URI (los URI que no son ID públicos ni de sistema). Por tanto, los URIs de espacios de nombres deben considerarse simplemente como URIs (no como IDs públicos o del sistema) y deben usarse como búsquedas por URI y no como consultas por identificador externo. En las versiones de RaptorXML Server previas a la de 2014 los URIs de espacios de nombres de esquemas se traducían con asignaciones <public>. Sin embargo, a partir de la versión 2014 es necesario utilizar asignaciones <uri>.
Antes de la versión v2014: <public publicID="http://www.MyMapping.com/ref" uri="file:///C:/MyDocs/Catalog/test.xsd"/>
A partir de la versión 2014: <uri name="http://www.MyMapping.com/ref" uri="file:///C:/MyDocs/Catalog/test.xsd"/>
Cómo encuentra RaptorXML Server un esquema de referencia
Para hacer referencia a un esquema desde un documento XML se usa el atributo xsi:scemaLocation (más abajo). El valor del atributo xsi:schemaLocation tiene dos partes: un espacio de nombres (verde) y un URI (resaltado).
xsi:schemaLocation="http://www.xmlspy.com/schemas/orgchart OrgChart.xsd"
La secuencia de pasos que debe seguir para encontrar un esquema al que se hace referencia depende de las opciones de validación --schemalocation-hints y --schema-mapping. A continuación puede encontrar los procedimientos para cada uno de los valores de estas dos opciones:
•--schemalocation-hints=load-by-schemalocation | load-by-namespace | load-combining-both | ignore
Indica el comportamiento de los atributos xsi:schemaLocation y xsi:noNamespaceSchemaLocation: si deben cargar un documento de esquema y, en ese caso, qué información deben usar para encontrarlo (la opción predeterminada es load-by-schemalocation).
❖load-by-schemalocation
1.Si la parte del URI de xsi:schemaLocation está asignada a un catálogo, carga el URI resultante.
2.Carga el URI directamente.
❖load-by-namespace
1.Si la parte del espacio de nombres de xsi:schemaLocation está asignada a un catálogo, carga el URI resultante.
2.No carga nada.
❖load-combining-both
1.Si la parte del URI de xsi:schemaLocation está asignada a un catálogo, carga el URI resultante.
2.Si la parte del espacio de nombres de xsi:schemaLocation está asignada a un catálogo, carga el URI resultante.
3.Carga la parte del URI directamente.
•--schema-mapping=prefer-schemalocation | prefer-namespace
Si se usan tanto la ubicación como el espacio de nombres del esquema para encontrar un documento de esquema, entonces esta opción indica cuál de estas dos opciones se prefiere al buscar un catálogo (la opción predeterminada es schemalocation). Esta opción se usa para cambiar el orden de los primeros dos pasos en la variante load-combining-both de más arriba.
Especificaciones de XML Schema
La información de la especificación XML Schema está integrada en RaptorXML Server y esta información interna se usa para validar los documentos de esquema XML (.xsd). Por tanto, en los documentos de esquema XML no se deberían hacer referencia a ningún esquema que defina la especificación XML Schema.
El archivo catalog.xml de la carpeta %AltovaCommonSchemasFolder%\Schemas\schema incluye referencias a las DTD que implementan especificaciones antiguas de XML Schema. Rogamos no valide sus documentos de esquema XML con estos esquemas. Los archivos referenciados se incluyen con el único objetivo de aportar información a RaptorXML Server para sus ayudantes de entrada, en caso de que el usuario quiera crear documentos basados en estas recomendaciones.