< Précédent | Suivant >

Leçon 1.3 : Créer et éditer votre fichier XML

Cette section du tutoriel vous montre comment générer un fichier XML basé sur votre DTD (et associé à elle) puis l'éditer.
Avant de commencer, vous devez effectuer la Leçon 1.2 : Personnaliser votre DTD.

Générer un fichier XML à partir de votre DTD

Pour générer un fichier XML à partir de votre fichier DTD, procédez comme suit :
  1. Dans la vue Navigateur, cliquez avec le bouton droit de la souris sur le fichier CDTitle.dtd que vous avez créé précédemment, et dans le menu contextuel cliquez sur Générer > Fichier XML.
  2. Sélectionnez votre projet et acceptez le nom par défaut. Cliquez sur Suivant.
  3. Sur la page Sélectionner l'élément racine, acceptez les valeurs par défaut. Votre fichier XML sera généré avec l'élément racine CDLib et tous les éléments générés contiendront des exemples de données.
  4. Cliquez sur Terminer.

Le fichier XML apparaît dans la vue Navigateur et s'ouvre automatiquement dans l'éditeur de page source XML.

Le fichier XML ne contient que l'élément racine sélectionné et les éléments ou attributs contenus dans celui-ci. Vous pouvez maintenant lui ajouter des éléments, des attributs, des entités et des notations ; toutefois, ceux-ci doivent respecter les règles établies dans la DTD que vous avez utilisée pour le créer.

L'élément format n'est pas inclus dans le fichier XML généré car vous n'avez pas choisi de créer les éléments facultatifs lors des étapes précédentes.

Editer dans la vue Conception

Dans la vue Conception, lorsque vous éditez un fichier XML qui comporte un ensemble de contraintes (ou un ensemble de règles) définies par une DTD ou un schéma XML, vous pouvez activer ou désactiver ces contraintes.

Lorsque les contraintes sont activées, vous ne pouvez pas effectuer de modifications qui violent les règles de la DTD, comme ajouter un élément non valide ou retirer des balises nécessaires. Dans ce mode, vous pouvez utiliser les options d'édition guidée.

Si vous désactivez les contraintes, vous pouvez introduire ou supprimer n'importe quel élément ou attribut indépendamment des règles de la DTD. Vous trouverez peut-être plus rapide de travailler dans ce mode, mais vous risquez d'introduire des erreurs donc vous devriez alors valider explicitement votre fichier XML de temps en temps.

Le fichier CDTitle.xml est contrait par les règles de CDTitle.dtd.

Vous allez maintenant éditer le fichier CDTitle.xml dans la vue Conception, avec les contraintes d'abord activées, puis désactivées :

  1. Si nécessaire, ouvrez CDTitle.xml dans l'éditeur XML (pour cela, cliquez dessus avec le bouton droit dans la vue Navigateur et cliquez sur Ouvrir avec > Editeur XML).
  2. Dans la vue Conception, sélectionnez l'élément CDLib et développez-le.
  3. Editez le contenu de l'élément CD. Remplacez la valeur de artist par John Brown, celle de description par Opera et celle de price par 15.00.
  4. CDTitle.xml ne contient actuellement qu'un seul CD. Vous allez en ajouter un autre :
    1. Cliquez avec le bouton droit sur CDLib et sélectionnez Ajouter un enfant > CD.
    2. Un nouvel élément CD est automatiquement créé ; il contient trois autres éléments : artist, description et price.
    3. Remplacez la valeur de artist par Jane Smith, celle de description par Classical et celle de price par 20.00.
    4. Cliquez sur Fichier > Enregistrer pour enregistrer vos modifications.
  5. Essayez d'ajouter et de retirer certains éléments et attributs du premier élément CD :
    1. Cliquez avec le bouton droit sur artist. L'option de menu Supprimer n'est pas disponible car artist est un élément obligatoire (vous l'avez spécifié dans votre fichier DTD).
    2. Cliquez avec le bouton droit sur description et sur price. L'option de menu Supprimer n'est pas non plus disponible car ces éléments sont eux aussi obligatoires.
    3. Cliquez avec le bouton droit sur CD et cliquez sur Ajouter un enfant. Vous avez la possibilité d'ajouter un autre artiste, mais pas une autre description ni un autre prix. L'option d'ajouter une autre description ou un autre prix n'est pas disponible car vous avez spécifié dans CDTitle.dtd que ces éléments ne pouvaient se présenter qu'une seule fois dans un élément CD. En revanche, vous avez spécifié qu'il pouvait y avoir un ou plusieurs éléments artist, raison pour laquelle vous pouvez sélectionner d'ajouter un autre artiste.
  6. Vous allez maintenant désactiver les contraintes grammaticales et continuer à éditer CDTitle.xml. Cliquez sur Conception > Désactiver les contraintes grammaticales.
  7. Cliquez avec le bouton droit sur artist dans le premier élément CD et cliquez sur Supprimer. Vous pouvez supprimer cet élément obligatoire car les contraintes grammaticales sont désactivées.
  8. Cliquez avec le bouton droit sur description dans le premier élément CD et cliquez sur Supprimer.
  9. Cliquez avec le bouton droit sur le premier élément CD et sélectionnez Ajouter un enfant. Vous avez maintenant la possibilité d'ajouter un autre prix. Cliquez sur price.
  10. Enregistrez votre fichier. Remarquez que vous êtes autorisé à l'enregistrer malgré toutes les erreurs de syntaxe. C'est parce que vous avez désactivé les contraintes.
  11. Dans la vue Navigateur, cliquez avec le bouton droit de la souris sur le fichier XML et cliquez sur Valider. Les erreurs que vous avez introduites dans le fichier apparaissent dans la vue Erreurs.

Editer dans la vue Source

Vous allez maintenant éditer le fichier CDTitle.xml dans la vue Source et corriger les erreurs que vous avez introduites :
  1. Sélectionnez votre fichier XML et cliquez sur Conception > Activer les contraintes grammaticales pour réactiver les contraintes grammaticales.
  2. Cliquez sur l'onglet Source pour passer à la vue Source.
  3. Placez votre curseur après la balise d'ouverture du premier élément CD : <cd>
  4. Appuyez sur Ctrl + Espace pour activer l'assistant de code. Une liste contextuelle apparaît avec les choix possibles.
  5. Cliquez deux fois sur artist.
  6. Tapez John Brown entre les balises <artist>.
  7. A présent placez votre curseur après les balises artist et l'assistant de code actif. Cliquez deux fois sur description.
  8. Tapez Opera entre les balises description.
  9. Sélectionnez le code de l'élément price que vous n'avez pas modifié et supprimez-le.
  10. Enregistrez votre fichier.
  11. Dans la vue Navigateur, cliquez avec le bouton droit de la souris sur le fichier XML et sélectionnez Valider. Le fichier est maintenant valide et aucune erreur ne s'affiche dans la vue Erreurs.
Le code source de votre fichier devrait ressembler à ceci :
Vue Source

Point de contrôle

Les vues Conception et Source de l'éditeur XML vous permettent d'effectuer facilement des modifications dans votre fichier XML en respectant les contraintes de la DTD associée. L'option des contraintes grammaticales vous permet d'appliquer ou non les règles au fichier à tout moment.
Maintenant que vous avez fini cette leçon, vous devriez savoir :
  • Générer un fichier XML à partir de votre DTD
  • Editer le fichier dans la vue Conception avec les contraintes grammaticales activées et désactivées
  • Editer le fichier dans la vue Source
< Précédent | Suivant >
Commentaires en retour