Les entrées de catalogue XML sont utilisées pour mapper des références d'entité externes à des ressources définies en local. Vous pouvez définir des règles spécifiant la façon dont ces entités sont résolues.
Pour plus d'informations sur la norme applicable aux catalogues XML, reportez-vous au site http://www.oasis-open.org/committees/download.php/14809/xml-catalogs.html.
Par exemple, vous utilisez un fichier XML sur votre ordinateur et pointez son attribut schemaLocation vers un schéma nommé c:\MonSchéma.xsd. Si vous n'utilisez pas de catalogue XML lorsque l'édition du fichier XML est terminée et que vous êtes prêt à le publier sur le Web, vous devrez éditer schemaLocation afin qu'il pointe vers une ressource accessible sur le Web.
Pour éviter de modifier fréquemment votre document XML, vous pouvez utiliser le catalogue XML : vous pouvez spécifier une règle qui redirige une référence de ressource Internet (par exemple "http://www.ibm.com/published-schemas/MySchema.xsd") afin qu'elle pointe vers une ressource sur la machine locale (par exemple "file:///C:/MySchema.xsd"). Désormais, au lieu de modifier fréquemment des documents XML pour mettre à jour des identificateurs URI ou des emplacements (particulièrement lorsque votre projet contient de nombreux documents), il vous suffit de mettre à jour une seule règle dans votre catalogue XML.
Les instructions ci-dessous ont été rédigées pour la perspective Ressource, mais elles sont également valables dans bien d'autres perspectives.
Pour ajouter une entrée au catalogue XML, procédez comme suit :
- Ouvrez le fichier XML que vous voulez associer à une définition DTD ou un schéma XML.
- Cliquez et sélectionnez . La section Entrées de catalogue XML contient une liste de toutes les entrées de catalogue définies par l'utilisateur ou par le plug-in. Sélectionnez une entrée pour afficher ses détails dans la section Détails.
- Cliquez sur Ajouter pour créer une entrée de catalogue.
- Dans la colonne de gauche, cliquez sur le type d'entrée de catalogue à ajouter :
| Option |
Description |
| Entrée de catalogue
|
Utilisée par un processeur XML lors de la résolution de références d'entité. Vous pouvez ajouter des règles au catalogue afin de spécifier la méthode de résolution des entités.Une entrée de catalogue XML se compose de deux parties :
- une clé (qui représente un schéma XML ou DTD),
- un emplacement (similaire à un URI, qui contient des informations sur l'emplacement d'un schéma DTD ou XML).
Vous pouvez placer la clé dans un fichier XML. Lorsque le processeur XML la rencontre, il utilise l'entrée de catalogue XML pour trouver l'emplacement de la DTD ou du schéma XML associé à la clé
|
| Entrée de réécriture |
Utilisée pour rediriger un ensemble d'entité. |
| Entrée de suffixe |
Utilisée pour faire correspondre le suffixe à un URI ou un ID système. |
| Catalogue suivant
|
Permet de faire référence à un autre catalogue sans l'importer dans le plan de travail. |
| Catalogue délégué |
Permet d'associer un catalogue alternatif à un identificateur. |
- Complétez les zones pour l'entrée de catalogue que vous avez sélectionnée :
Table 1. Types d'entrée de catalogue et zones associées
| Type de catalogue |
Zones |
| Entrée de catalogue |
- Dans la zone Emplacement, entrez ou recherchez l'emplacement ou l'identificateur URI du fichier de schéma DTD ou XML. Cette opération utilise le style de chemin de votre ordinateur pour décrire l'emplacement du fichier.
- Sélectionnez un type de clé :
- Si vous avez spécifié une définition DTD, sélectionnez ID public, ID système ou URI dans la zone Type de clé. Si vous sélectionnez ID public, la valeur que vous entrez dans la zone Clé doit être la même que celle de l'ID public figurant dans la déclaration DOCTYPE du fichier XML. Si vous sélectionnez ID système, la valeur que vous entrez doit correspondre à l'ID système figurant dans la déclaration DOCTYPE du fichier XML.
Si vous sélectionnez URI, la valeur que vous saisissez doit correspondre à un URI qualifié complet.
- Si vous avez spécifié un schéma XML, vous pouvez sélectionner Nom de l'espace de nom ou Emplacement du schéma dans la zone Type de clé. Si le schéma définit un espace de nom cible, il apparaîtra automatiquement dans la zone Clé.
Sinon, vous pouvez entrer l'emplacement du schéma dans la zone Clé.
- Cochez la case Spécifier une adresse Web de remplacement si vous voulez spécifier une autre adresse Web pour la ressource.
Cette adresse Web est utilisée lorsqu'une instance XML est générée à partir de cette entrée de catalogue. Remarque : Cette option est disponible uniquement si vous sélectionnez ID public (pour une DTD) ou Nom de l'espace de nom (pour un schéma) dans la zone Type de clé.
|
| Entrée de réécriture |
- Sélectionnez un type de clé pour la correspondance, c'est-à-dire un URI ou un ID système.
- Correspondant à la chaîne de début : Préfixe correspondant à retirer de l'identificateur indiqué.
- Préfixe de réécriture : Préfixe à utiliser à la place du préfixe retiré.
|
| Entrée de suffixe |
- Dans la zone Emplacement, entrez ou recherchez l'emplacement ou l'identificateur URI du fichier de schéma DTD ou XML. Cette opération utilise le style de chemin de votre ordinateur pour décrire l'emplacement du fichier.
- Sélectionnez un type de clé (URI ou ID système) pour la correspondance.
- Tapez le suffixe de l'identificateur pour la correspondance.
|
| Catalogue suivant |
Dans la zone Emplacement d'un autre fichier de catalogue XML, tapez ou recherchez le catalogue XML auquel vous souhaitez faire référence. |
| Catalogue délégué |
- Sélectionnez un type de clé pour la correspondance, c'est-à-dire un URI ou un ID système.
- Correspondant à la chaîne de début : Préfixe de l'identificateur spécifié pour la correspondance.
- Délégué de ce fichier de catalogue XML : Catalogue alternatif à associer.
|
- Une fois la création des entrées de catalogue terminée, cliquez sur OK pour fermer la boîte de dialogue Ajout d'une entrée de catalogue XML. Cliquez une nouvelle fois OK pour sauvegarder les paramètres.
- Vérifiez que le fichier XML est mis en évidence et cliquez sur le bouton Recharger les dépendances de la barre d'outils.
Le fichier XML est désormais associé à la dernière version du schéma XML ou de la définition DTD.
Vous pouvez également exporter et importer des informations de catalogue XML :
Pour lancer l'exportation, cliquez sur et sélectionnez . Vous serez invité à sélectionner un projet et à indiquer un nom de fichier pour stocker vos entrées de catalogue dans un fichier .xmlcatalog, pouvant être ouvert à partir de la vue Navigateur. Vos entrées de catalogue étant stockées dans un fichier .xmlcatalog, vous pouvez les libérer, les réserver et les partager comme toutes les autres ressources de projet.
Pour lancer l'importation, cliquez sur et sélectionnez . Ensuite, indiquez le fichier qui sera utilisé pour charger les paramètres du catalogue XML. Lorsque vous importez un fichier .xmlcatalog, toutes les entrées qu'il contient seront chargées dans le catalogue XML (et toutes les entrées existantes seront remplacées).