Générer un extrait XML à partir d'un schéma XML

  • Article

L’éditeur XML permet de générer des extraits XML à partir d’un schéma de langage XSD (langage de définition de schéma XML). Par exemple, lorsque vous créez un fichier XML alors que le curseur est placé à côté du nom d’un élément, vous pouvez appuyer sur Tab pour remplir l’élément avec des données XML générées à partir des informations de schéma de cet élément.

Cette fonction n'est disponible que pour les éléments. Les règles suivantes s'appliquent également :

  • L'élément doit avoir un type de schéma associé ; autrement dit, l'élément doit être valide par rapport à un schéma associé. Le type de schéma ne peut pas être abstract et doit contenir les attributs et/ou éléments enfants obligatoires.

  • L'élément actuel dans l'éditeur doit être vide et dépourvu d'attributs. Par exemple, tous les exemples suivants sont valides

    • <Account

    • <Account>

    • <Account></Account>

  • Le curseur doit être placé immédiatement à droite du nom de l'élément.

L'extrait généré contient tous les attributs et éléments requis. Si minOccurs est supérieur à un, le nombre minimal d'instances requises de cet élément est inclus dans l'extrait, jusqu'à 100 instances. Toutes les valeurs fixes trouvées dans le schéma engendrent des valeurs fixes dans l'extrait. Les éléments xsd:any et xsd:anyAttribute sont ignorés et n'engendrent aucune construction d'extrait supplémentaire.

Des valeurs par défaut sont générées et notées comme valeurs modifiables. Si le schéma spécifie une valeur par défaut, celle-ci est utilisée. Toutefois, si la valeur par défaut du schéma est une chaîne vide, l'éditeur génère les valeurs par défaut de la manière suivante :

  • Si le type de schéma contient des facettes d'énumération, que ce soit directement ou indirectement par le biais de membres d'un type d'union, la première valeur énumérée trouvée dans le modèle Objet du schéma est utilisée comme valeur par défaut.

  • Si le type de schéma est un type atomique, l'éditeur cherche ce type atomique et en insère le nom. Pour un type simple dérivé, il utilise le type simple de base. Pour un type de liste, le type atomique est l'itemType. Pour une union, le type atomique est celui du premier memberType.

Exemple

Les étapes de cette section expliquent comment utiliser la fonction d’extrait de code XML généré par schéma dans l’éditeur XML.

Notes

Avant d'entamer ces procédures, enregistrez le fichier de schéma sur votre ordinateur local.

Pour créer un nouveau fichier XML et l’associer à un schéma XML

  1. Dans le menu Fichier, pointez sur Nouveau et cliquez sur Fichier.

  2. Sélectionnez Fichier XML dans le volet Modèles et cliquez sur Ouvrir.

    Un nouveau fichier s'ouvre dans l'éditeur. Il contient une déclaration XML par défaut, <?xml version="1.0" encoding="utf-8">.

  3. Dans la fenêtre de propriétés du document, cliquez sur le bouton Parcourir (…) du champ Schémas.

    La boîte de dialogue Schémas XSD s’affiche.

  4. Cliquez sur Add.

    La boîte de dialogue Ouvrir le schéma XSD s’affiche.

  5. Sélectionnez le fichier de schéma et cliquez sur Ouvrir.

  6. Cliquez sur OK.

    Le schéma XML est à présent associé au document XML.

Pour générer un extrait XML

  1. Entrez < dans le volet de l'éditeur.

  2. La liste des membres affiche les éléments possibles :

    !-- permet d’ajouter un commentaire.

    !DOCTYPE permet d’ajouter un type de document.

    ? permet d'ajouter une instruction de traitement.

    Contact permet d’ajouter l’élément racine.

  3. Sélectionnez Contact dans la liste des membres et appuyez sur Entrée.

    L’éditeur ajoute l’étiquette de début <Contact et place le curseur après le nom de l’élément.

  4. Appuyez sur Tab pour générer des données XML pour l’élément Contact d’après ses informations de schéma.

Entrée

La procédure pas à pas utilise le fichier de schéma suivant.

<?xml version="1.0" encoding="utf-8" ?>
<xs:schema elementFormDefault="qualified"
           xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:simpleType name="phoneType">
    <xs:restriction base="xs:string">
      <xs:enumeration value="Voice"/>
      <xs:enumeration value="Fax"/>
      <xs:enumeration value="Pager"/>
    </xs:restriction>
  </xs:simpleType>
  <xs:element name="Contact">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="Name">
          <xs:simpleType>
            <xs:restriction base="xs:string"></xs:restriction>
          </xs:simpleType>
        </xs:element>
        <xs:element name="Title"
                    type="xs:string" />
        <xs:element name="Phone"
                    minOccurs="1"
                    maxOccurs="unbounded">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="Number"
                          minOccurs="1">
                <xs:simpleType>
                  <xs:restriction base="xs:string"></xs:restriction>
                </xs:simpleType>
              </xs:element>
              <xs:element name="Type"
                          default="Voice"
                          minOccurs="1"
                          type="phoneType"/>
            </xs:sequence>
          </xs:complexType>
        </xs:element>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>

Sortie

Voici les données XML générées sur la base des informations de schéma associées à l'élément Contact. Les parties en bold sont des champs modifiables dans l’extrait XML.

<Contact>
  <Name>name</Name>
  <Title>title</Title>
  <Phone>
    <Number>number</Number>
    <Type>Voice</Type>
  </Phone>
</Contact>

Contenu connexe