Sélection d'un type de substitution pour des variables

Lorsqu'un schéma XML définit un élément XML basé sur des types dérivés, vous devez spécifier le type dérivé (ou type de substitution) attendu en phase d'exécution.

Pourquoi et quand exécuter cette tâche

La spécification de schéma XML prend en charge la capacité à dériver des types complexes par extension. Pour plus d'informations sur la substitution de type et son utilisation dans les panneaux de mappage, voir Sélection d'un type de substitution.

Lorsqu'un schéma XML définit un élément XML basé sur des types dérivés, vous devez spécifier le type dérivé (ou type de substitution) attendu en phase d'exécution. Dans Studio, vous devez spécifier le type de substitution attendu pour l'élément XML de la variable à l'aide de l'option de menu Remplacer le noeud par..., comme décrit dans la procédure suivante.

Pour sélectionner un type de substitution pour une variable :

Procédure

  1. Téléchargez un schéma XML contenant des types dérivés basés sur un élément XML dans le projet. Pour plus d'informations, voir Téléchargement de fichiers dans un projet.
  2. Créez une variable contenant des types dérivés basés sur un élément XML. Le schéma associé au noeud s'affiche dans le panneau "Schéma de" de l'onglet Variables.

    Pour l'exemple de schéma XML fourni dans Sélection d'un type de substitution, créez une variable basée sur l'élément <shape>. Le schéma associé à l'élément <shape> s'affiche dans le panneau "Schéma de" de l'onglet Variables, comme illustré dans la Figure 1 :

    Figure 1. Schéma associé à l'élément shape comme affiché dans le panneau Schéma de.

    Notez que les éléments enfant des types dérivés ne sont pas répertoriés dans le panneau "Schéma de".Dans cet exemple, l'élément enfant de circle appelé diameter n'est pas répertorié, les éléments enfant de rectangle appelés width et length non plus.

  3. Dans le panneau "Schéma de" de l'onglet Variables, sélectionnez le type dérivé attendu en phase d'exécution en cliquant avec le bouton droit de la souris sur le noeud et en sélectionnant l'option Remplacer le noeud par....

    La boîte de dialogue Remplacer un noeud par un type dérivé s'affiche. Dans le menu, les types dérivés disponibles pour le noeud comme définis par le schéma XML sont répertoriés. Pour cet exemple, les deux types dérivés sont disponibles dans les menus, comme illustré dans la Figure 2 :

    Figure 2. La figure montre les deux types dérivés pour le noeud : circle et rectangle.
  4. Sélectionnez l'un des types dérivés. Le type dérivé sélectionné détermine le type attendu de document d'instance XML en phase d'exécution.

    Dans cet exemple, le type dérivé circle est sélectionné. Les données XML attendues pour cette variable en phase d'exécution sont donc de type circle.

    Outre les éléments enfant de type de base, les éléments enfant du type dérivé sont répertoriés dans le panneau "Schéma de". Dans cet exemple, l'élément enfant appelé diameter s'affiche avec l'élément enfant nommé color (hérité du type de base) dans le panneau "Schéma de" de l'onglet Variables, comme illustré dans la Figure 3 :

    Figure 3. Onglet Variables

Que faire ensuite

Lorsqu'un type dérivé a été sélectionné pour un noeud d'une variable à l'aide de l'option Remplacer le noeud par..., vous pouvez supprimer l'association entre le noeud d'une variable et le type dérivé en cliquant avec le bouton droit de la souris et en sélectionnant l'option Annuler le remplacement du noeud dans le menu. Une boîte de dialogue Annuler le remplacement s'ouvre. Cliquez sur Oui.