Adición de entradas al catálogo XML

Una entrada del catálogo XML contiene dos partes, la clave (que representa la DTD o el esquema XML) y un URI (que contiene información acerca de la ubicación de la DTD o del 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.

Las entradas del catálogo XML se pueden utilizar en diferentes situaciones. Por ejemplo, si trabaja en un archivo XML en su sistema de escritorio principal y apunta su schemaLocation a un esquema denominado c:\MySchema.xsd. A c continuación, lo guarda en el sistema portátil para poder trabajar en otro momento. No bastante, cuando abre el archivo en el portátil encuentra un problema: el editor XML no puede encontrar el esquema MySchema.xsd porque realmente se ha instalado en la unidad D. Tendrá que editar schemaLocation de modo que apunte a d:\MySchema.xsd. Cuando ha terminado de editar el archivo XML y está listo para publicarlo en la Web, tendrá que volver a editar el URI de modo que apunte a un recurso al que se pueda acceder en la Web. De momento, el problema resulta obvio. Un URI utilizado en un archivo XML no se puede portar tan fácilmente como le gustaría. Para evitar tener que realizar cambios frecuentemente en su documento XML, puede utilizar el catálogo XML.

Un procesador XML utiliza una entrada de catálogo XML para resolver referencias de entidad. Puede proporcionar normas al catálogo para que especifique el modo en que se resolverán las entidades. Si considera el ejemplo anterior, puede especificar una norma que redirija una referencia de recurso Internet, por ejemplo, "http://www.ibm.com/published-schemas/MySchema.xsd", de modo que apunte a un recurso en la máquina local del desarrollador, por ejemplo, "file:///C:/MySchema.xsd"). Ahora, en lugar de editar documentos XML frecuentemente para actualizar los URI (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 a una DTD o esquema XML.
  2. Pulse Ventana > Preferencias > Web y XML > Catálogo XML.
  3. El campo Entradas de catálogo XML contiene una lista de entradas de catálogo definidas por el usuario y definidas por el plug-in.
    1. Seleccione una entrada para ver información detallada acerca del mismo en el campo Detalles.
    2. Pulse Añadir para crear una entrada de catálogo nueva.
  4. En el campo URI, escriba la ubicación de la DTD o esquema XML o examine para buscarla.
  5. Si ha especificado una DTD en el campo URI, puede seleccionar ID público o ID de sistema 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 de la declaración DOCTYPE del archivo XML. Si selecciona ID de sistema, el valor que especifique debe corresponderse con el ID de sistema en una declaración DOCTYPE del archivo XML.
  6. Si ha especificado un esquema XML en el campo URI, puede seleccionar Nombre de 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. De lo contrario, puede especificar la ubicación del esquema en el campo Clave.
  7. Seleccione 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.
  8. Si desea consultar otro catálogo sin importarlo al área de trabajo, pulse Catálogo siguiente. Escriba o busque el catálogo XML al que desea hacer referencia.
  9. Cuando haya terminado de crear entradas de catálogo, pulse Aceptar para cerrar el diálogo Añadir entrada de catálogo XML.
  10. Pulse Avanzado si desea importar o exportar cualquier valor del catálogo XML.
  11. Pulse Exportar si desea conservar la información del catálogo XML. Sólo se exportarán las entradas especificadas por el usuario.
    1. 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.
    2. Pulse Aceptar.
  12. Pulse Importar si desea importar un archivo .xmlcatalog. Se le solicitará que seleccione el archivo que desea importar.
    1. Cuando importe un archivo .xmlcatalog, cualquier entrada que contenga se cargará en el catálogo XML y se sobregrabarán las entradas existentes.
    2. Pulse Aceptar.
  13. Pulse Aceptar para cerrar el diálogo Preferencias de catálogo XML avanzadas.
  14. Asegúrese de que el archivo XML esté focalizado 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.
Conceptos relacionados
Asociaciones de archivos XML con DTD y esquemas XML
Tareas relacionadas
Edición con restricciones de DTD o del esquema XML
Edición de declaraciones DOCTYPE
Actualización de los archivos XML con cambios realizados en las DTD y esquemas
Edición de la información del espacio de nombres