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:
- Abra o arquivo XML que deseja associar a uma DTD ou esquema XML.
- Clique em e selecione . 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.
- Clique em Incluir para criar uma nova entrada no catálogo.
- 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. |
- 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.
|
- 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.
- 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 e selecione . 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 e selecione . 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).