Ajout d'éléments d'inclusion (include)

Si vos schémas sont volumineux, vous pouvez scinder leur contenu en plusieurs documents de schéma pour en faciliter la maintenance, la réutilisation et la lisibilité. Vous pouvez utiliser l'élément include pour rassembler les définitions et les déclarations issues de schéma inclus dans le schéma en cours. Le schéma inclus doit figurer dans le même espace de nom cible que le schéma d'inclusion.

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 un élément d'inclusion, procédez comme suit :

  1. Ouvrez le schéma XML dans l'éditeur de schéma XML.
  2. Dans la vue Conception, cliquez avec le bouton droit de la souris sur la section Directives et sélectionnez Ajout d'une instruction d'inclusion.
  3. Dans l'assistant Sélection d'un fichier de schéma XML, vous pouvez inclure un schéma XML situé dans votre espace de travail ou inclure un schéma depuis une adresse Web HTTP. Le fichier de schéma XML que vous sélectionnez doit présenter le même espace de nom que le schéma en cours.
    • Pour inclure un schéma XML situé dans votre espace de travail :
      1. Sélectionnez Projets du plan de travail et cliquez sur Suivant.
      2. Sélectionnez le schéma que vous voulez importer et cliquez sur Terminer.
    • Pour schéma inclure un schéma XML situé à une adresse Web HTTP :
      1. Sélectionnez HTTP et cliquez sur Suivant.
      2. Entrez l'URL du schéma XML et cliquez sur Terminer.
        Remarque : Aucune copie locale du schéma n'est stockée sur le plan de travail. Si vous validez votre schéma, son contenu est vérifié à partir de l'URL que vous indiquez.
  4. Facultatif : Utilisez la vue Propriétés pour définir d'autres propriétés pour l'élément d'importation.
    1. Pour éditer l'emplacement du fichier de schéma XML inclus, cliquez sur l'onglet Général et tapez le nouvel emplacement dans la zone Emplacement du schéma.
    2. Cliquez sur l'onglet Documentation pour fournir des informations sur cet élément d'inclusion. La page Documentation est utilisée pour fournir des informations interprétables par l'utilisateur, telles qu'une description.
    3. Cliquez sur l'onglet Extensions si vous voulez ajouter des éléments d'information relatifs à une application à vos annotations de composants de schéma. La page Extensions vous permet de spécifier le schéma et d'ajouter le contenu XML à vos annotations.

Lorsque vous avez ajouté un élément d'inclusion (include) dans votre schéma XML, lors de la définition de nouveaux éléments, attributs, types complexes ou simples, dans laquelle vous pouvez spécifier les informations de types, toutes les déclarations issues du schéma inclus seront disponibles dans la liste Type pour l'élément, l'attribut, le type complexe ou simple.

Par exemple, si Address.xsd a le contenu suivant :

<complexType name="Address">
    <sequence>
        <element name="name" type="string">
        <element name="street" type="string">
    </sequence>
</complexType>
et si vous disposez d'un schéma XML nommé PurchaseOrder.xsd ayant ajouté un élément 'include' pour Address.xsd, lors de la définition d'un nouvel élément dans PurchaseOrder, vous pouvez sélectionner Address comme type de cet élément.
Tâches connexes
Ajout d'éléments d'importation (import)
Ajout d'éléments de redéfinition
Référence connexe
Espaces de nom XML