Incluindo Entradas no Catálogo XML

Uma entrada do Catálogo XML contém duas partes - uma Chave (que representa uma DTD ou esquema XML) e um URI (Uniform Resource Identifier) (que contém informações sobre o local de uma DTD ou de esquema XML). É possível colocar a Chave em um arquivo XML. Quando o processador XML encontrá-la, ele utilizará a entrada do Catálogo XML para localizar o local da DTD ou esquema XML associado à Chave

As entradas do Catálogo XML podem ser utilizadas em várias situações. Por exemplo, você está trabalhando em um arquivo XML em seu computador desktop principal e aponta seu schemaLocation para um esquema chamado c:\MySchema.xsd. Em seguida, você salva-o em seu laptop para poder trabalhar nele posteriormente. No entanto, quando você abrir o arquivo em seu laptop, encontrará um problema - o editor XML não pode localizar o esquema MySchema.xsd, porque, de fato, ele está instalado em sua unidade D. Será necessário editar schemaLocation para apontar para d:\MySchema.xsd. Quando concluir a edição do arquivo XML e estiver pronto para publicá-lo na Web, será necessário editar o URI novamente para que ele aponte para um recurso que esteja acessível na Web. Por enquanto, o problema é óbvio. Um URI utilizado em um arquivo XML não é tão portável quanto você gostaria que fosse. Para evitar fazer alterações freqüentes em seu documento XML, você pode utilizar o Catálogo XML.

Uma entrada do Catálogo XML é utilizada por um processador XML ao resolver referências de entidade. É possível fornecer regras para o catálogo, para especificar como as entidades devem ser resolvidas. Se você considerar o exemplo anterior, poderá especificar uma regra que redireciona uma referência de recurso da Internet (por exemplo, "http://www.ibm.com/published-schemas/MySchema.xsd") para que aponte para um recurso na máquina local do desenvolvedor (por exemplo, "file:///C:/MySchema.xsd"). Agora, em vez de editar freqüentemente documentos XML para atualizar os URIs (principalmente quando existem muitos documentos em seu projeto), será necessário atualizar apenas uma única regra em seu Catálogo XML.

As instruções a seguir foram escritas para a perspectiva do Recurso, mas elas também funcionarão em muitas outras perspectivas.

Para incluir uma entrada no Catálogo XML, siga estas etapas:

  1. Abra o arquivo XML que deseja associar a uma DTD ou esquema XML.
  2. Clique em Janela > Preferências > Web e XML > Catálogo XML.
  3. O campo Entradas do Catálogo XML contém uma lista de entradas do catálogo definidas pelo usuário e definidas pelo plug-in.
    1. Selecione uma entrada para ver detalhes sobre ela no campo Detalhes.
    2. Clique em Incluir para criar uma nova entrada do catálogo.
  4. No campo URI, digite o local da DTD ou esquema XML ou procure-o.
  5. Se você tiver especificado uma DTD no campo URI, poderá selecionar ID Público ou ID do Sistema no campo Tipo de Chave. Se você selecionar ID Público, o valor digitado no campo Chave deverá ser igual ao ID Público na declaração DOCTYPE do arquivo XML. Se você selecionar ID do Sistema, o valor digitado deverá corresponder ao ID do Sistema em uma declaração DOCTYPE do arquivo XML.
  6. Se você tiver especificado um esquema XML no campo URI, poderá selecionar Nome do Espaço de Nomes ou Local do Esquema no campo Tipo de Chave. Se o esquema definir um espaço de nomes de destino, ele aparecerá automaticamente no campo Chave. Caso contrário, você poderá digitar o local do esquema no campo Chave.
  7. Selecione a caixa de opções Especificar endereço da Web alternativo se desejar especificar um endereço da Web alternativo para o recurso. Este endereço da Web é utilizado quando uma instância XML é gerada a partir desta entrada do catálogo. Nota: Esta opção estará disponível apenas se você selecionar ID Público (para uma DTD) ou Nome do Espaço de Nomes (para um esquema) no campo Tipo de Chave.
  8. Se desejar consultar outro catálogo sem importá-lo para o ambiente de trabalho, clique em Próximo Catálogo. Digite ou procure o catálogo XML que deseja consultar.
  9. Quando concluir a criação de entradas do catálogo, clique em OK para fechar o diálogo Incluir Entrada do Catálogo XML.
  10. Clique em Avançado se desejar importar ou exportar configurações do Catálogo XML.
  11. Clique em Exportar se desejar persistir as informações do Catálogo XML. Apenas as entradas especificadas pelo usuário serão exportadas.
    1. Será solicitado que selecione um projeto e forneça um nome de arquivo para armazenar suas entradas do catálogo em um arquivo .xmlcatalog, que pode ser aberto a partir da visualização do Navegador. Como suas entradas do catálogo estão armazenadas em um arquivo .xmlcatalog, você poderá registrar a entrada e saída delas e compartilhá-las como qualquer outro recurso do projeto.
    2. Clique em OK.
  12. Clique em Importar se desejar importar um arquivo .xmlcatalog. Será solicitado que selecione o arquivo que deseja importar.
    1. Quando você importar um arquivo .xmlcatalog, as entradas contidas nele serão carregadas no Catálogo XML (e as entradas existentes serão sobrescritas).
    2. Clique em OK.
  13. Clique em OK para fechar o diálogo Preferências Avançadas do Catálogo XML.
  14. Certifique-se de que o arquivo XML esteja em foco e clique no botão da barra de ferramentas Recarregar Dependências.
O arquivo XML agora está associado à versão mais recente do esquema XML ou DTD.
Conceitos relacionados
Associações de Arquivos XML a DTDs e a Esquemas XML
Tarefas relacionadas
Editando com Restrições de DTD ou de Esquema XML
Editando Declarações DOCTYPE
Atualizando Arquivos XML com Alterações Feitas em DTDs e Esquemas
Editando Informações de Espaço de Nomes