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

Les schémas devenant de plus en plus volumineux, il est souvent préférable de diviser 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.

La procédure suivante a été rédigée pour la perspective XML, mais elle s'applique également à de nombreuses autres perspectives.

Pour ajouter un élément d'inclusion (include), procédez comme suit :

Ouvrez le schéma XML dans l'éditeur de schéma XML.
Dans la vue Structure, sélectionnez le schéma. L'intégralité du schéma et son contenu s'affichent dans la vue Conception.
Dans la vue Conception, cliquez avec le bouton droit de la souris sur la section Directives et cliquez sur Ajout d'une instruction d'inclusion.
Dans la vue Propriétés, cliquez sur l'onglet Général puis sur Parcourir situé à droite de la zone Emplacement du schéma. Le fichier de schéma XML que vous sélectionnez doit avoir le même espace de nom que le schéma en cours.
Pour sélectionner un schéma XML situé dans le plan de travail, cliquez sur Projets du plan de travail, puis sur Suivant.
Sélectionnez le schéma à inclure et cliquez sur Terminer.
Pour sélectionner un schéma XML situé sur le Web, cliquez sur HTTP, puis sur Suivant.
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. A chaque validation de votre schéma, son contenu est vérifié à partir de l'URL que vous indiquez.
L'éditeur de schéma XML extrait l'emplacement du fichier de schéma XML inclus et l'affiche dans la zone Emplacement du schéma. Cette zone peut être modifiée à tout moment pour indiquer l'emplacement du fichier de schéma XML.
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.
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="Adresse">
    <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.