Téléchargement des schémas XML inclus

Un schéma XML ou un document WSDL peut inclure d'autres schémas XML dans le document principal à l'aide des options d'inclusion de schéma, d'inclusion de schéma avec une redéfinition ou d'importation d'un espace de nom.

Pourquoi et quand exécuter cette tâche

Inclusion de schéma
Vous pouvez inclure d'autres fragments de schéma XML dans le schéma XML ou le document WSDL principal, comme illustré dans l'exemple suivant : <xsd:include schemaLocation="myTypes.xsd"/>
Inclusion de schéma avec une redéfinition
La spécification d'un schéma XML prend en charge la modification de définitions incluses par d'autres fragments de schéma XML dans le schéma XML ou le document WSDL en cours. Par exemple, le fragment de schéma XML myTypes.xsd définit un type complexe appelé PurchaseOrderType. Un autre schéma XML nommé PurchaseOrder.xsd inclut le fragment de schéma XML myTypes.xsd qui utilise l'élément redefine et redéfinit le type complexe appelé PurchaseOrderType.
Vous pouvez inclure d'autres fragments de schéma XML dans le schéma XML ou le document WSDL principal à l'aide de l'élément redefine comme illustré dans l'exemple suivant : <xsd:redefine schemaLocation="myTypes.xsd"/>
Importation d'un espace de nom
Vous pouvez inclure un espace de nom dans le document en cours en utilisant l'élément import comme illustré dans l'exemple suivant : <xs:import namespace="http://acme.com/ns/example schemaLocation="mySchema.xsd" /> .

Lorsque vous ajoutez ou téléchargez le schéma XML ou le document WSDL principal dans le projet à l'aide de la boîte de dialogue Ajouter un document, vous êtes invité à localiser le ou les schémas XML inclus dans le projet, comme illustré dans la procédure suivante. Tous les schémas XML inclus doivent être localisés avant que le schéma XML ou le document WSDL principal apparaissent dans l'onglet Projet et puissent être utilisés dans le projet.

Procédure

  1. Téléchargez un schéma XML ou un document WSDL dans le projet en cours. Si le schéma XML ou le document WSDL inclut d'autres schémas XML, la boîte de dialogue Téléchargement des schémas XML inclus s'affiche avec tous les schémas XML inclus comme illustré dans la Figure 1.
    Figure 1. Téléchargement des schémas XML inclusTéléchargement d'un schéma XML
    Si le schéma XML inclus est localisé automatiquement, l'icône de coche Icône de coche apparaît en regard du schéma XML dans la boîte de dialogue Téléchargement des schémas XML inclus, comme illustré pour le schéma XML commonTypes.xsd dans la figure précédente. Si le schéma XML ou le document WSDL principal était situé dans le système de fichiers local, Studio recherche les schémas XML inclus dans le même répertoire et les localise automatiquement. Par exemple, si vous avez téléchargé mySchema.xsd depuis le répertoire C:\temp et que mySchema.xsd inclut le schéma XML commonTypes.xsd, Studio recherche automatiquement le schéma XMLcommonTypes.xsd dans le répertoire C:\temp. Si le schéma XML inclus n'est pas localisé automatiquement, l'icône d'avertissement Icône d'avertissement apparaît en regard du schéma XML dans la boîte de dialogue Téléchargement des schémas XML inclus, comme illustré pour le schéma XML poTypes.xsd de la Figure 1.
  2. Répétez les étapes suivantes pour rechercher tous les schémas XML non localisés.
    1. Sélectionnez le schéma XML dans la boîte de dialogue Téléchargement des schémas XML inclus. Le schéma XML est mis en évidence dans la table, comme illustré dans la Figure 2.
      Figure 2. Téléchargement d'un schéma XMLTéléchargement d'un schéma XML
    2. Cliquez sur Localiser.   La boîte de dialogue Localisation du schéma XML sélectionné s'affiche.
    3. Dans la zone Emplacement, indiquez l'emplacement du schéma XML inclus (emplacement Web externe ou système de fichiers).
    4. Cliquez sur OK.   Si le schéma XML inclus est localisé, l'icône de coche Icône de coche apparaît en regard du schéma XML dans la boîte de dialogue Téléchargement des schémas XML inclus.
  3. Par défaut, la case Stocker toutes les inclusions dans le même noeud de projet comme document principal est cochée. Lorsque cette case est cochée, les schémas XML inclus et le schéma XML ou le document WSDL principal sont téléchargés sous la forme d'un noeud de projet unique. Lorsque cette case est désélectionnée, les schémas XML inclus et le schéma XML ou le document WSDL principal s'affichent séparément dans l'onglet Projet. Une icône de coche apparaît en regard de chaque schéma XML répertorié indiquant que tous les schémas XML inclus ont été localisés.
  4. Cliquez sur OK.

Exemple

Si la case Stocker toutes les inclusions dans le même noeud de projet comme document principal est cochée, seul le schéma XML ou le fichier WSDL principal s'affiche dans l'onglet Projet, comme illustré dans la Figure 3.
Figure 3. ExempleExemple

Lorsque la case est cochée, les schémas XML inclus sont quand même téléchargés dans le projet mais ne sont pas affichés dans l'onglet Projet. Vous ne pouvez donc pas mettre à jour individuellement ces schémas XML dans le projet, comme décrit dans Téléchargement des schémas XML inclus.

Si la case Stocker toutes les inclusions dans le même noeud de projet comme document principal est désélectionnée, le schéma XML ou le document WSDL principal et tous les schémas XML inclus sont téléchargés dans le projet et apparaissent dans l'onglet Projet, comme illustré dans la Figure 4.
Figure 4. ExempleExemple

Lorsque la case est désélectionnée, tous les schémas XML inclus peuvent être mis à jour individuellement, comme décrit dans Téléchargement des schémas XML inclus.

Remarque : Si possible, chargez toujours le schéma XML ou le document WSDL principal avec cette case cochée (en tant qu'un seul noeud de projet) pour diminuer les risques de conflits de dépendance potentiels entre les schémas XML. Par exemple, si vous téléchargez le fichier myTypes.xsd principal dans le projet avec la case Stocker toutes les inclusions dans le même noeud de projet comme document principal désélectionnée, les fichiers XSD suivants sont également téléchargés et apparaissent dans l'onglet Projet :
  • commonTypes.xsd
  • poTypes.xsd

Si vous avez créé et téléchargé un troisième fichier XSD appelé myTypesTwo.xsd qui inclut également les types définis dans le fichier commonTypes.xsd et si vous avez modifié les noms et les types définis dans commonTypes.xsd et utilisés dans myTypes.xsd en dehors de Studio et que vous avez téléchargé des nouvelles versions de ces fichiers, le fichier myTypesTwo.xsd du projet fait encore référence aux noms et aux types d'origine et n'est plus valide.