Adicionar entradas ao 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 a localização de uma DTD ou de um esquema XML). É possível colocar a Chave num ficheiro XML. Quando o processador de XML a localiza, utiliza a entrada do catálogo XML para localizar a DTD ou o esquema XML associado à Chave

As entradas do Catálogo XML podem ser utilizadas em diversas situações. Por exemplo, se estiver a trabalhar num ficheiro XML no computador de secretária principal e indicar o schemaLocation para um esquema denominado c:\MySchema.xsd, poderá, em seguida, guardá-lo no computador portátil e trabalhar mais tarde no ficheiro. No entanto, ao abrir o ficheiro no computador portátil, deparar-se-á com um problema: o editor XML não consegue localizar o esquema MySchema.xsd, uma vez que este se encontra, de facto, instalado na unidade D. É necessário editar o schemaLocation para indicar o esquema d:\MySchema.xsd. Quando tiver concluído a edição do ficheiro XML e estiver pronto para o publicar na Web, terá de editar novamente o URI, para que este indique um recurso que esteja acessível na Web. Nesta fase, o problema é óbvio. Um URI utilizado num ficheiro XML não é tão portátil quanto o pretendido. Para evitar fazer alterações frequentes ao documento XML, poderá utilizar o Catálogo XML.

O processador de XML utiliza uma entrada do Catálogo de XML ao processar referências de entidades. Poderá facultar regras ao catálogo para especificar o modo de processamento das entidades. Se tiver em consideração o exemplo anterior, poderá especificar uma regra que redireccione uma referência a um recurso da Internet (por exemplo, "http://www.ibm.com/published-schemas/MySchema.xsd") de modo a que esta indique um recurso na máquina local do programador (por exemplo, "file:///C:/MySchema.xsd"). Agora, em vez de editar frequentemente documentos XML para actualizar os URIs (principalmente quando existem vários documentos no projecto), o utilizador necessita apenas de actualizar um única regra no Catálogo XML.

As seguintes instruções foram escritas para a perspectiva Recurso, mas também serão aplicáveis a muitas outras perspectivas.

Para adicionar uma entrada ao Catálogo XML, execute os seguintes passos:

  1. Abra o ficheiro XML que pretende associar a uma DTD ou esquema XML.
  2. Faça clique em Janela > Preferências > Web e XML > Catálogo XML.
  3. O campo Entradas do Catálogo XML contém uma lista de todas as entradas do catálogo definidas pelo utilizador e pelo plug-in.
    1. Seleccione qualquer entrada para visualizar detalhes no campo Detalhes.
    2. Faça clique em Adicionar para criar uma nova entrada do catálogo.
  4. No campo URI, introduza a localização da DTD, do esquema XML ou efectue uma procura da localização.
  5. Caso tenha especificado uma DTD no campo URI, poderá seleccionar ID público ou ID do sistema no campo Tipo de chave. Se seleccionar ID público, o valor que introduzir no campo Chave deverá ser o mesmo que o ID público na declaração DOCTYPE do ficheiro XML. Se seleccionar ID do sistema, o valor que introduzir deverá corresponder ao ID do sistema na declaração DOCTYPE do ficheiro XML.
  6. Caso tenha especificado um esquema XML no campo URI, poderá seleccionar Nome do espaço de nomes ou Localização do esquema no campo Tipo de chave. Se o esquema definir um espaço de nomes destino, este será apresentado automaticamente no campo Chave. Caso contrário, poderá introduzir a localização do esquema no campo Chave.
  7. Marque a caixa de verificação Especificar endereço alternativo da Web se pretender especificar um endereço alternativo da Web para o recurso. Este endereço da Web é utilizado quando é gerada uma ocorrência XML a partir desta entrada do catálogo. Nota: Esta opção apenas estará disponível se seleccionar ID público (para uma DTD) ou Nome de espaço de nomes (para um esquema) no campo Tipo de chave.
  8. Se pretender consultar outro catálogo sem o importar para a área de trabalho, faça clique em Catálogo seguinte. Introduza ou procure o catálogo XML que pretende consultar.
  9. Quando concluir a criação de entradas do catálogo, faça clique em OK para fechar a caixa de diálogo Adicionar entrada ao Catálogo XML.
  10. Faça clique em Avançadas se pretender importar ou exportar definições do Catálogo XML.
  11. Faça clique em Exportar caso pretenda manter as informações do Catálogo XML. Apenas serão exportadas as entradas especificadas pelo utilizador.
    1. Ser-lhe-á solicitado que seleccione um projecto e faculte um nome de ficheiro para armazenar as entradas do catálogo num ficheiro .xmlcatalog, que poderá ser aberto na vista Navegador. Uma vez que as entradas do catálogo estão arquivadas num ficheiro .xmlcatalog, poderá marcá-las ou desmarcá-las e partilhá-las tal como qualquer outro recurso de projecto.
    2. Faça clique em OK.
  12. Faça clique em Importar se pretender importar um ficheiro .xmlcatalog. Ser-lhe-á solicitado que seleccione o ficheiro que pretende importar.
    1. Ao importar um ficheiro .xmlcatalog, todas as entradas deste serão carregadas no Catálogo XML (e todas as entradas existentes serão substituídas).
    2. Faça clique em OK.
  13. Faça clique em OK para fechar a caixa de diálogo Preferências avançadas de Catálogo XML.
  14. Certifique-se de que o ficheiro XML está destacado e faça clique no botão da barra de ferramentas Recarregar dependências.
O ficheiro XML encontra-se agora associado à última versão do esquema XML ou da DTD.
Conceitos relacionados
Associações de ficheiros XML com DTDs e esquemas XML
Tarefas relacionadas
Editar com restrições de DTD ou de esquema XML
Editar declarações DOCTYPE
Actualizar ficheiros XML com alterações feitas a DTDs e esquemas
Editar informações de espaço de nomes