Incluindo Entradas no Catálogo XML

As entradas no Catálogo XML são utilizadas para mapear as referências de entidade externa para recursos definidos localmente. É possível fornecer regras para especificar como estas entidades são resolvidas

Para obter detalhes no padrão para Catálogos XML, consulte: http://www.oasis-open.org/committees/download.php/14809/xml-catalogs.html.

Por exemplo: você está trabalhando em um arquivo XML em um computador e aponta seu schemaLocation na direção de um esquema denominado c:\MySchema.xsd. Se não utilizar um catálogo XML, quando terminar de editar o arquivo XML e estiver pronto para publicá-lo na Web, será necessário editar o schemaLocation para que ele aponte para um recurso que seja acessível pela Web.

Para evitar fazer alterações frequentes no seu documento XML, é possível utilizar o Catálogo XML: seria possível especificar uma regra que redirecionasse uma referência de recurso da Internet (por exemplo, "http://www.ibm.com/published-schemas/MySchema.xsd") para que ele aponte para um recurso na máquina local (por exemplo, "file:///C:/MySchema.xsd"). Agora, em vez de editar freqüentemente documentos XML para atualizar os URIs ou locais (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 e selecione XML > Catálogo XML. A seção Entradas do Catálogo XML contém uma lista de entradas do catálogo definidas pelo usuário e definidas pelo plug-in. Selecione qualquer entrada para ver informações sobre ela na seção Detalhes.
  3. Clique em Incluir para criar uma nova entrada no catálogo.
  4. Na coluna à esquerda, clique no tipo de entrada no catálogo que deseja incluir:
    Opção Descrição
    Entrada do Catálogo Utilizada por um processador XML ao resolver referências da entidade. É possível fornecer regras para o catálogo, para especificar como as entidades devem ser resolvidas.
    Uma entrada no Catálogo XML contém duas partes:
    • Uma chave (que representa um esquema XML ou DTD)
    • Um local (similar a um URI, que contém as informações sobre um local de esquema XML ou DTD).
    É 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
    Entrada Gravar Novamente Utilizada para redirecionar um conjunto de entidades.
    Entrada Sufixo Utilizada para corresponder o sufixo de uma URI ou ID do sistema.
    Próximo Catálogo Utilizada para consultar outro catálogo sem importá-lo para o ambiente de trabalho.
    Delegar Catálogo Utilizada para associar um catálogo alternativo a um identificador.
  5. Complete os campos para a entrada no catálogo que você selecionou:
    Tabela 1. Tipos de Entrada no Catálogo e Campos Associados
    Tipos de catálogo Campos
    Entrada do Catálogo
    • No campo Local, digite ou navegue até o local ou URI do arquivo de esquema DTD ou XML. Utiliza o estilo de caminho do computador para descrever o local do arquivo.
    • Selecione um Tipo de Chave:
      • Se você especificou uma DTD: selecione ID Público, ID do Sistema ou URI 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. Se você selecionar URI, o valor digitado deverá ser um URI completo.
      • Se você especificou um esquema XML: selecione 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.
    • 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 um DTD) ou Nome de Namespace (para um esquema) no campo Tipo de chave.
    Entrada Gravar Novamente
    • Selecione um Tipo de chave para corresponder, ou URI ou ID do sistema.
    • Cadeia de início correspondente: O prefixo correspondente a ser removido do identificador fornecido.
    • Prefixo Gravar Novamente: O prefixo que deve ser usado ao invés do prefixo que é removido.
    Entrada Sufixo
    • No campo Local, digite ou navegue até o local ou URI do arquivo de esquema DTD ou XML. Utiliza o estilo de caminho do computador para descrever o local do arquivo.
    • Selecione um Tipo de Chave (URI ou ID do sistema) para corresponder.
    • Digite o Sufixo do identificador para corresponder.
    Próximo Catálogo No campo Local do outro arquivo de Catálogo XML, digite ou navegue para o catálogo XML que deseja consultar.
    Delegar Catálogo
    • Selecione um Tipo de chave para corresponder, ou URI ou ID do sistema.
    • Cadeia de início correspondente: O prefixo do identificador fornecido para corresponder.
    • Delegar para este arquivo XML: O catálogo alternativo para associar.
  6. Quando terminar de criar entradas de catálogo, clique em OK para fechar o diálogo Incluir Entrada no Catálogo XML. Clique em OK novamente para salvar suas configurações.
  7. 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.

Você também pode exportar e importar informações do Catálogo XML:

Para exportar, clique em Arquivo > Exportar e selecione XML > Catálogo XML. 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.

Para importar, clique em Arquivo > Importar e selecione XML > Catálogo XML . Em seguida, especifique o arquivo que será utilizado para carregar as configurações do Catálogo XML. Quando você importar um arquivo .xmlcatalog, as entradas contidas nele serão carregadas no Catálogo XML (e as entradas existentes serão sobrescritas).

Conceitos Relacionados
As associações XML com DTDs e esquemas XML
Tarefas Relacionadas
Editando com limitações de DTD ou esquema XML
Editando declarações DOCTYPE
Atualizando arquivos XML com alterações feitas nos DTDs e esquemas
Editando informações de namespace