Edition d'un noeud de groupe

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.
Avant de commencer
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 :

  1. Ouvrez votre DTD dans l'éditeur de DTD.
  2. Dans la vue Structure, développez l'arborescence de l'élément sur lequel vous voulez travailler.
  3. Cliquez sur le noeud de groupe que vous souhaitez éditer.
  4. 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.
  5. 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.
  6. 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.
  7. 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 :

  1. Créez un nouveau fichier DTD appelé Pets.dtd et ouvrez-le dans l'éditeur de DTD.
  2. 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.
  3. 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.
  4. Votre modèle de contenu est maintenant représenté par un noeud de groupe Symbole du noeud de groupe Contenu mixte.. 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.
  5. 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.
  6. Répétez l'étape précédente et sélectionnez Fish dans la liste Modèle de contenu.
  7. 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.
  8. 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).
  9. 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.
  10. 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.
Que faire ensuite

Vos commentaires