Adicionar entradas ao Catálogo XML

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:

  1. Abra o ficheiro XML que pretende associar a uma DTD ou esquema XML.
  2. Faça clique em Janela > Preferências e seleccione XML > Catálogo XML. 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.
  3. Faça clique em Adicionar para criar uma nova entrada de catálogo.
  4. 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.
  5. 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.
  6. 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.
  7. 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 Ficheiro > Exportar e seleccione XML > Catálogo XML. 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 Ficheiro > Importar e seleccione XML > Catálogo XML . 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).

Conceitos relacionados
Associações de ficheiros XML a 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ços de nomes