Ajout d'éléments globaux

Un élément global est un élément d'une portée globale. Il s'agit d'un élément qui a été déclaré comme une partie du schéma principal plutôt qu'une partie d'un modèle de contenu.

1. Ouvrez le schéma XML dans l'éditeur de schéma XML.
2. Dans la vue Structure, sélectionnez le schéma. L'intégralité du schéma et son contenu s'affichent dans la vue Conception.
3. Dans la vue Conception, cliquez avec le bouton droit de la souris sur la section Elements et sélectionnez Ajouter un élément.
4. Dans la vue Propriétés, cliquez sur l'onglet Général, et entrez un nouveau nom pour l'élément global dans la zone Name.
5. Dans la vue Propriétés, vous pouvez sélectionnez le type d'attribut dans la liste prédéfinie du menu situé à côté de la zone Type.

   Sinon, vous pouvez sélectionner Parcourir dans la liste pour obtenir plus d'options.

   La boîte de dialogue Définition d'un type s'affiche et répertorie tous les types intégrés et définis par l'utilisateur actuellement disponibles. Vous pouvez changer la Portée de la liste en sélectionnant une des options suivantes :

   • Espace de travail. Affiche la liste de tous les types disponibles dans votre espace de travail.
   • Projet englobant. Affiche la liste de tous les types disponibles dans le projet contenant votre fichier.
   • (Valeur par défaut) Ressource en cours. Affiche la liste de tous les types disponibles dans le fichier en cours.
   • Jeux de documents. Répertorie tous les types disponibles dans le jeu de document sélectionné.

   Sélectionnez le type désiré dans la liste et cliquez sur OK.

6. (Facultatif) Cliquez sur l'onglet Autre. Sur cette page, vous pouvez indiquer les différentes valeurs suivantes pour l'élément global :
   • abstrait. Cliquez sur true si vous souhaitez que l'élément global soit abstrait (abstract). Lorsqu'un élément global est déclaré abstrait, il ne peut pas être utilisé dans un document d'instance. A la place, c'est un membre du groupe de substitution de cet élément global qui doit apparaître dans le document d'instance.
   • bloc. Cette zone détermine si l'élément global peut être remplacé par un élément dérivé.
   • final. Cette zone détermine si l'élément global peut être dérivé.
   • Valeur fixe/Par défaut. Cliquez sur Parcourir et sélectionnez Valeur fixe ou Par défaut et indiquez une valeur appropriée. Si vous sélectionnez Valeur fixe, l'élément global a une valeur fixe, non modifiable. Si vous sélectionnez Par défaut, l'élément a une valeur par défaut.
   • forme. Utilisez cette zone pour indiquer si la forme de cet élément global dans une instance du schéma XML (un fichier XML associé au schéma XML) doit être qualifiée par un espace de nom.
   • nillable (peut être null). Sélectionnez true si si vous souhaitez que l'élément global contienne uniquement des attributs et aucun élément enfant.
   • substitutionGroup. Un groupe de substitution (substitutionGroup) permet la substitution d'éléments par d'autres éléments.
7. Cliquez sur l'onglet Attributs. Vous pouvez utiliser cette page pour ajouter des attributs, des références d'attribut, des références de groupe d'attributs et des attributs any à votre élément global.
8. Un attribut associe un nom d'attribut à un type et une valeur spécifiques. Pour ajouter un attribut, cliquez avec le bouton droit de la souris dans la page Attributs et sélectionnez Ajouter un attribut. Vous pouvez spécifier les valeurs suivantes pour un attribut :
   • Valeur fixe/Par défaut. Cliquez sur Parcourir et sélectionnez Valeur fixe ou Par défaut et indiquez une valeur appropriée. Si vous sélectionnez Valeur fixe, l'attribut a une valeur fixe, non modifiable. Si vous sélectionnez Par défaut, l'attribut a une valeur par défaut.
   • forme. Utilisez cette zone pour indiquer si la forme de cet attribut dans une instance du schéma XML doit être qualifiée par un espace de nom.
   • nom. Entrez le nom de l'attribut.
   • type. Cliquez sur Parcourir et sélectionnez le type de l'attribut.
   • utilisation. Cette zone indique le mode d'utilisation de l'attribut dans un document d'instance. Si vous sélectionnez facultatif, l'attribut peut apparaître une fois, mais pas nécessairement. Si vous sélectionnez requis, l'attribut doit apparaître une seule fois. Si vous sélectionnez interdit, l'attribut ne doit pas apparaître. Remarque : si vous avez sélectionné Par défaut, vous devez sélectionner facultatif dans cette zone, sinon la valeur par défaut ne sera pas valide.
9. Une référence d'attribut fournit la référence d'un attribut global. Pour ajouter une référence d'attribut, cliquez avec le bouton droit de la souris dans la page Attributs et sélectionnez Ajouter une référence d'attribut. Une déclaration désignant un attribut global permet à l'élément référencé d'apparaître dans le document d'instance dans le contexte d'une déclaration de référence. L'option de menu d'ajout de référence d'attribut s'affiche uniquement s'il existe des attributs globaux définis ailleurs dans le document. Sélectionnez la référence puis l'attribut global à référencer dans la liste ref.
10. Une référence de groupe d'attributs (Attribute Group Ref), fournit la référence à un groupe d'attributs. Pour ajouter une référence de groupe d'attributs, cliquez avec le bouton droit de la souris dans la page Attributs et sélectionnez Ajouter une référence de groupe d'attributs. Une déclaration désignant un groupe d'attributs permet à ce groupe référencé d'apparaître dans le document d'instance dans le contexte d'une déclaration de référence. L'option de menu d'ajout de référence de groupe d'attributs s'affiche uniquement s'il existe des groupes d'attributs définis ailleurs dans le document. Sélectionnez la référence puis le groupe d'attributs à référencer dans la liste ref.
11. L'élément any active le contenu d'un élément en fonction des espaces de nom et l'élément d'attribut any correspondant active l'affichage des attributs dans les éléments. Pour ajouter un attribut any, cliquez avec le bouton droit de la souris dans la page Attributs et sélectionnez Ajouter un attribut any. Vous pouvez spécifier les valeurs suivantes pour l'attribut any :
    • Pour la valeur d'espace de nom namespace, vous pouvez sélectionner :
      • ##any. Ceci autorise n'importe quel attribut XML valide de n'importe quel espace de nom.
      • ##local . Ceci autorise n'importe quel attribut XML valide non déclaré comme figurant dans un espace de nom.
      • ##other. Ceci autorise n'importe quel attribut XML valide ne provenant pas de l'espace de nom cible du type défini.
      • ##targetNamespace . Ceci est une abréviation désignant l'espace de nom cible du type défini.
    • Comme valeur de processContents, vous pouvez sélectionner :
      • skip. Le processeur XML ne validera pas le contenu de l'attribut.
      • lax. Le processeur XML validera le contenu de l'attribut autant que possible.
      • strict. Le processeur XML validera l'intégralité du contenu de l'attribut.
12. Cliquez sur l'onglet Documentation pour fournir des informations sur cet élément global. La page Documentation est utilisée pour fournir des informations interprétables par l'utilisateur, telles qu'une description.
13. 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.