Si votre élément a un contenu élémentaire
ou un contenu mixte, son modèle de contenu est représenté par un noeud de groupe. Vous pouvez ajouter des éléments
enfants ou un autre groupe à un noeud de groupe et spécifiez à quelle fréquence et de quelle manière un groupe
d'éléments sera disponible dans un fichier XML associé à votre DTD.
A propos de cette tâche
Les instructions suivantes ont été écrites pour la perspective Ressource, mais elles fonctionneront
également dans de nombreuses autres perspectives.
Pour éditer un noeud de groupe,
suivez ces étapes :
- Ouvrez votre DTD dans l'éditeur de DTD.
- Dans la vue Structure, développez l'arborescence de l'élément sur lequel vous voulez travailler.
- Cliquez sur le noeud de groupe que vous souhaitez éditer.
- Dans la vue Conception, sélectionnez Séquence ou Choix dans la
liste Groupe de modèles. Cela détermine si le groupe d'éléments est trié en séquence ou disponible en tant que choix dans un fichier XML.
- Sélectionnez l'option appropriée dans la liste Occurrence pour indiquer la fréquence avec
laquelle le groupe d'éléments peut apparaître dans un fichier XML associé à cette DTD.
- Pour ajouter un autre élément existant à un groupe en tant qu'enfant, faites un clic droit
sur le noeud du groupe, cliquez sur Ajouter un élément au modèle de contenu et
sélectionnez l'élément en question.
- Vous pouvez également ajouter un groupe en tant qu'enfant à un noeud de groupe existant en faisant un clic droit
sur ce dernier et en choisissant Ajouter un groupe au modèle de contenu.
Résultats
Remarque : L'option Occurrence s'appliquant au noeud de groupe ne spécifie que la fréquence
avec laquelle l'ensemble du groupe d'éléments peut apparaître dans un fichier XML. Vous pouvez également spécifier individuellement
la fréquence d'occurrence de chaque élément enfant contenu
dans le groupe (autrement dit,
la fréquence avec laquelle un élément enfant peut apparaître est totalement indépendante de la fréquence avec laquelle le
groupe qui le contient peut lui-même apparaître).
Conseil : Pour changer l'ordre des éléments
figurant sous un noeud de groupe, cliquez simplement sur l'élément que vous voulez déplacer et faites-le
glisser vers l'emplacement choisi comme destination.
Exemple
Création d'un noeud de groupe contenant une liste de petits animaux
domestiques ("small pets")
Les étapes suivantes illustrent la manière de créer un noeud de groupe contenant
une liste de petits animaux domestiques et expliquent comment les choix que vous faites affectent la manière avec laquelle votre
noeud de groupe (et les éléments qu'il contient) peut être utilisé dans un fichier XML basé sur votre fichier DTD :
- Créez un nouveau fichier DTD appelé Pets.dtd et ouvrez-le dans l'éditeur de DTD.
- Dans la vue Structure, cliquez avec le bouton droit de la souris sur votre fichier DTD et créez un nouvel élément
SmallPets.
Créez également trois autres éléments : Cats, Dogs et Fish.
- Développez SmallPets et sélectionnez le modèle de contenu
EMPTY. Sélectionnez Contenu mixte dans la
liste Type de contenu. Cela signifie que votre élément SmallPets peut
contenir à la fois d'autres éléments et des données de type caractère.
- Votre modèle de contenu est maintenant représenté par un noeud de groupe
. Un élément #PCDATA (pour les données de type caractères)
et un nouvel élément enfant sont automatiquement créés sous
celui-ci. Sélectionnez newChild et Dogs dans
la liste Modèle de contenu.
- Faites un clic droit sur le noeud de groupe et
sélectionnez Ajouter un élément au modèle de contenu.
Sélectionnez le nouveau noeud enfant et Cats dans la liste Modèle de contenu.
- Répétez l'étape précédente et sélectionnez Fish dans la liste
Modèle de contenu.
- Maintenant que vous avez créé votre liste de petits animaux domestiques, vous devez décider si vous voulez que les utilisateurs
puissent les sélectionner tous ou seulement l'un d'entre eux dans un fichier XML basé sur ce fichier Pets.dtd.
Par exemple, vous créez un nouveau fichier XML appelé Pets.xml basé
sur cette DTD et vous créez un élément SmallPets dedans.
Si vous avez sélectionné Séquence comme groupe de modèles dans le fichier DTD, alors vous pouvez
avoir toutes les catégories d'animaux domestiques (Cats, Dogs et Fish)
dans votre élément SmallPets, dans le fichier Pets.xml.
En revanche, si vous avez sélectionné Choix comme groupe de modèles, vous ne pouvez avoir qu'une
seule catégorie d'animaux répertoriée dans votre élément SmallPets, dans le fichier
Pets.xml. Vous pouvez avoir la catégorie Cats, Dogs ou
Fish, mais une seule à la fois.
- Vous devez à présent décider à quelle fréquence ce groupe d'éléments (la liste d'animaux domestiques) peut apparaître
dans un fichier XML associé à cette DTD. Vous pouvez spécifier qu'il doit apparaître une seule fois (Une seule
fois), qu'il doit apparaître une ou plusieurs fois (Une fois ou plus), qu'il
n'est pas obligé d'apparaître du tout (Facultatif) ou qu'il est susceptible de ne pas être
utilisé du tout ou d'être utilisé un nombre quelconque de fois (Zéro ou plus).
Remarque : Vous pouvez également spécifier la fréquence avec laquelle chaque élément enfant peut
apparaître. La fréquence avec laquelle un élément enfant peut apparaître est totalement indépendante de la fréquence avec laquelle le
groupe qui le contient peut lui-même apparaître.
Donc, par exemple, vous pouvez spécifier que le groupe SmallPets doit
apparaître Une seule fois, mais que l'élément Cats peut apparaître plusieurs fois (pour cela,
sélectionnez l'élément Cats et cliquez sur Une fois ou plus).
- L'ordre dans lequel vous spécifiez les éléments enfants dans un groupe affecte la manière avec laquelle ils peuvent
être utilisés dans une instance de l'élément parent dans un fichier XML.
Par exemple, si, dans votre fichier DTD, vous avez spécifié ceci : <!ELEMENT SmallPets (Dogs+ , Cats+ ,
Fish)+>, toute instance de SmallPets dans votre fichier
Pets.xml doit contenir une ou plusieurs instances de Dogs suivies d'une
ou plusieurs instances de Cats, suivies par une seule occurrence
de Fish. Vous ne pouvez jamais avoir d'occurrence de Fish après
Dogs ou d'occurrence de Cats avant Dogs.
- Vous pouvez également ajouter un groupe à un noeud de groupe existant. Sélectionnez le noeud,
faites un clic droit dessus et
sélectionnez Ajouter un groupe au modèle de contenu. Vous pourriez, par exemple, ajouter un noeud
de groupe si vous vouliez classer les animaux par race dans des groupes séparés.