Adición de entradas al catálogo XML

Las entradas de catálogo XML se utilizan para correlacionar referencias de entidad externas con recursos definidos localmente. Puede proporcionar reglas específicas para la resolución de estas entidades

Para obtener detalles sobre el estándar de catálogos XML, consulte: http://www.oasis-open.org/committees/download.php/14809/xml-catalogs.html.

Por ejemplo: está trabajando en un archivo XML en un sistema y apunta su schemaLocation a un esquema llamado c:\MySchema.xsd. Si no utiliza un catálogo XML, cuando termina de editar el archivo XML y está preparado para publicarlo en la Web, debe editar schemaLocation para que señale a un recurso accesible en la Web.

Para evitar realizar cambios frecuentemente en el documento XML, puede utilizar el catálogo XML: puede especificar una regla que redirija una referencia de recurso de Internet (por ejemplo, "http://www.ibm.com/published-schemas/MySchema.xsd") para que apunte a un recursos en la máquina local (por ejemplo, "file:///C:/MySchema.xsd"). Ahora, en lugar de editar documentos XML frecuentemente para actualizar los URI o las ubicaciones (sobretodo cuando hay muchos documentos en el proyecto), sólo tendrá que actualizar una norma individual del catálogo XML.

Las instrucciones siguientes se han escrito para la perspectiva Recurso pero también funcionarán en muchas otras perspectivas.

Para añadir una entrada al catálogo XML, siga estos pasos:

  1. Abra el archivo XML que desea asociar con una DTD o esquema XML.
  2. Pulse Ventana > Preferencias y seleccione XML > Catálogo XML. La sección Entradas de catálogo XML contiene una lista de entradas de catálogo definidas por el usuario y definidas por plug-in. Seleccione cualquier entrada para ver información sobre la misma en la sección Detalles.
  3. Pulse Añadir para crear una nueva entrada de catálogo.
  4. En la columna de la izquierda, pulse el tipo de entrada de catálogo que desea añadir:
    Opción Descripción
    Entrada de catálogo Utilizado por un procesador XML al resolver referencias de entidad. Puede proporcionar normas al catálogo para que especifique el modo en que se resolverán las entidades.
    Una entrada de catálogo XML contiene dos partes:
    • Una clave (que representa una DTD o un esquema XML)
    • Una ubicación (parecida a un URI, que contiene información sobre una DTD o una ubicación de esquema XML).
    Puede colocar la clave en un archivo XML. Cuando el procesador XML lo encuentra, utilizará la entrada del catálogo XML para buscar la ubicación de la DTD o del esquema XML asociado a la clave.
    Entrada de rescritura Utilizado para redirigir un conjunto de entidades.
    Entrada de sufijo Utilizado para emparejar el sufijo de un URI o systemID.
    Catálogo siguiente Utilizado para hacer referencia a otro catálogo sin importarlo en el entorno de trabajo.
    Catálogo delegado Utilizado para asociar un catálogo alternativo con un identificador.
  5. Complete los campos de la entrada de catálogo seleccionado:
    Tabla 1. Tipos de entrada de catálogo y campos asociados
    Tipo de catálogo Campos
    Entrada de catálogo
    • En el campo Ubicación, escriba o navegue hasta la ubicación o URI de la DTD o archivo de esquema XML. Esto utiliza el estilo de vía de acceso del sistema para describir la ubicación del archivo.
    • Seleccione Tipo de clave:
      • Si ha especificado una DTD: seleccione ID público, ID de sistema o URI en el campo Tipo de clave. Si selecciona ID público, el valor que especifique en el campo Clave debe ser el mismo que el ID público en la declaración DOCTYPE del archivo XML. Si selecciona ID de sistema, el valor que especifique debe corresponder con el ID de sistema en una declaración DOCTYPE del archivo XML. Si selecciona URI, el valor que especifique debe ser un URI totalmente calificado.
      • Si ha especificado un esquema XML: seleccione Espacio de nombres o Ubicación del esquema en el campo Tipo de clave. Si el esquema define un espacio de nombres de destino, aparecerá automáticamente en el campo Clave. En caso contrario, puede especificar la ubicación del esquema en el campo Clave.
    • Marque el recuadro de selección Especificar dirección Web alternativa si desea poder especificar una dirección Web alternativa para el recurso.
      Esta dirección Web se utiliza cuando se genera una instancia XML a partir de esta entrada de catálogo.
      Nota: esta opción sólo está disponible si selecciona ID público (para una DTD) o Nombre de espacio de nombres (para un esquema) en el campo Tipo de clave.
    Entrada de rescritura
    • Seleccione un Tipo de clave a emparejar, URI o systemID.
    • Serie inicial coincidente: el prefijo coincidente que eliminar del identificador proporcionado.
    • Rescribir prefijo: el prefijo que utilizar en lugar del prefijo que se debe eliminar.
    Entrada de sufijo
    • En el campo Ubicación, escriba o navegue hasta la ubicación o URI de la DTD o archivo de esquema XML. Esto utiliza el estilo de vía de acceso del sistema para describir la ubicación del archivo.
    • Seleccione un Tipo de clave (URI o systemID) con el que coincidir.
    • Escriba el Sufijo del identificador con el que coincidir.
    Catálogo siguiente En el campo Ubicación de otro archivo de catálogo XML, escriba o navegue al catálogo XML al que quiere hacer referencia.
    Catálogo delegado
    • Seleccione un Tipo de clave a emparejar, URI o systemID.
    • Serie inicial coincidente: el prefijo del identificador proporcionado con el que coincidir.
    • Delegar en este archivo XML: El catálogo alternativo que asociar.
  6. Cuando haya terminado de crear entradas de catálogo, pulse Aceptar para cerrar el recuadro de diálogo Añadir entrada de catálogo XML. Pulse Aceptar de nuevo para guardar los valores.
  7. Compruebe que el archivo XML tiene el foco en pantalla y pulse el botón de la barra de herramientas Recargar dependencias.
El archivo XML está ahora asociado a la versión más reciente del esquema XML o DTD.

También puede exportar e importar información de Catálogo XML:

Para exportar, pulse Archivo > Exportar y seleccione XML > Catálogo XML. Se le solicitará que seleccione un proyecto y proporcione un nombre de archivo para almacenar las entradas de catálogo en un archivo .xmlcatalog que se puede abrir desde la vista del navegador. Dado que las entradas del catálogo se guardan en un archivo .xmlcatalog, puede seleccionarlas y deseleccionarlas y compartirlas como cualquier otro recurso de proyecto.

Para importar, pulse Archivo > Importar y seleccione XML > Catálogo XML . A continuación, especifique el archivo que se utilizará para cargar los valores de Catálogo XML. Cuando importe un archivo .xmlcatalog, cualquier entrada que contenga se cargará en el catálogo XML y se sobregrabarán las entradas existentes.

Conceptos relacionados
Asociaciones de archivos XML con DTD y esquemas XML
Tareas relacionadas
Edición con DTD o restricciones de esquema XML
Editar declaraciones DOCTYPE
Actualizar archivos XML con cambios hechos en DTD y esquemas
Editar de información de espacio de nombres