As entradas de Catálogo XML são utilizadas para correlacionar referências de entidade externas a recursos definidos localmente. Pode facultar as regras especificando como estas entidades se processam.
Para obter detalhes acerca do padrão para Catálogos XML, consulte http://www.oasis-open.org/committees/download.php/14809/xml-catalogs.html.
Por exemplo, se estiver a trabalhar num ficheiro XML num computador e indicar o respectivo schemaLocation para um esquema designado c:\MySchema.xsd. Caso não utilize um catálogo XML, quando terminar a edição do ficheiro XML e estiver pronto para o publicar na Web, terá de editar schemaLocation, de modo a que indique um recurso que esteja acessível na Web.
Para evitar que efectue alterações frequentes ao documento XML, pode utilizar o Catálogo XML: pode especificar uma regra que redireccione uma referência de recurso da Internet (por exemplo, "http://www.ibm.com/published-schemas/MySchema.xsd") para que indique um recurso na máquina local (por exemplo, "file:///C:/MySchema.xsd"). Agora, em vez de editar
frequentemente documentos XML para actualizar os URIs ou localizações (principalmente quando
existem vários documentos no projecto), o utilizador necessita apenas de
actualizar uma ú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:
- Abra o ficheiro XML que pretende associar a uma DTD ou esquema XML.
- Faça clique em e seleccione . A secção Entradas do Catálogo XML contém uma lista
de todas as entradas do catálogo definidas pelo utilizador e pelo plug-in. Seleccione qualquer entrada para ver informações da mesma na secção Detalhes.
- Faça clique em Adicionar para criar uma nova entrada de catálogo.
- Na coluna do lado esquerdo, faça clique no tipo de entrada de catálogo que pretende adicionar:
| Opção |
Descrição |
| Entrada de catálogo |
Utilizado por um processador de XML ao processar referências da entidade.
Poderá facultar regras ao catálogo para especificar o modo de processamento das
entidades. Uma entrada de Catálogo XML contém duas partes:
- Uma chave (que representa um esquema DTD ou XML)
- Uma localização (semelhante a uma URI, que contém informações sobre a localização de um esquema DTD ou 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
|
| Reescrever entrada |
Utilizado para redireccionar um conjunto de entidades. |
| Entrada de sufixo |
Utilizado para corresponder o sufixo de uma URI ou systemID. |
| Catálogo seguinte |
Utilizado para remeter para outro catálogo sem o importar para a área de trabalho. |
| Delegar catálogo |
Utilizado para associar um catálogo alternativo com um identificador. |
- Conclua os campos para a entrada de catálogo que seleccionou:
Tabela 1. Tipos de entrada de catálogos e campos associados
| Tipo de catálogo |
Campos |
| Entrada de catálogo |
- No campo Localização, introduza ou procure a localização ou URI do ficheiro DTD ou de esquema XML. Esta acção utiliza o estilo de caminho do computador para descrever a localização do ficheiro.
- Seleccione um Tipo de chave:
- Caso tenha especificado um DTD: seleccione ID público, ID do sistema ou URI 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.
Caso seleccione URI, o valor que introduzir tem de ser um URI totalmente qualificado.
- Caso tenha especificado um esquema XML: seleccione Nome de espaço de nomes ou Localização de 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.
- 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 um DTD) ou Nome de espaço de nomes (para um esquema) no campo Tipo de chave.
|
| Reescrever entrada |
- Seleccione um Tipo de chave para corresponder, que seja URI ou systemID.
- Cadeia de início correspondente: O prefixo correspondente a ser removido do identificador facultado.
- Reescrever prefixo: O prefixo vai ser utilizado em vez do prefixo que é removido
|
| Entrada de sufixo |
- No campo Localização, introduza ou procure a localização ou URI do ficheiro DTD ou de esquema XML. Esta acção utiliza o estilo de caminho do computador para descrever a localização do ficheiro.
- Seleccione um Tipo de chave (URI ou systemID) para corresponder.
- Escreva o Sufixo do identificador a corresponder.
|
| Catálogo seguinte |
No campo Localização de outro ficheiro de Catálogo XM, escreva ou procure o catálogo XML ao qual pretende fazer referência. |
| Delegar catálogo |
- Seleccione um Tipo de chave para corresponder, que seja URI ou systemID.
- Cadeia de início correspondente: O prefixo do identificador facultado a corresponder.
- Delegar para este ficheiro XML: O catálogo alternativo a associar.
|
- 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. Faça clique em OK novamente para guardar as definições.
- 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.
É também possível exportar e importar informações do Catálogo XML:
Para exportar, faça clique em e seleccione . 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
armazenadas num ficheiro .xmlcatalog, poderá marcá-las ou desmarcá-las e
partilhá-las tal como qualquer outro recurso de projecto.
Para importar, faça clique em e seleccione . De seguida, especifique o ficheiro que será utilizado para carregar as definições do Catálogo XML. 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).