Élément <xsd:group>
Regroupe un ensemble de déclarations d'élément de façon à ce qu'elles soient incorporées en tant que groupe à des définitions de types complexes.
<group
name= NCName
id = ID
maxOccurs = (nonNegativeInteger | unbounded) : 1
minOccurs = nonNegativeInteger : 1
name = NCName
ref = QName
{any attributes with non-schema Namespace}...>
Content: (annotation?, (all | choice | sequence))
</group>
Attributs
name
Nom du groupe. Ce nom doit être un NCName, comme défini dans la spécification sur les espaces de noms XML.Cet attribut n'est utilisé que lorsque l'élément schema est le parent de cet élément group. Dans ce cas, le group est un modèle de groupe utilisé par les éléments complexType, choice et sequence.
Facultatif.
id
ID de cet élément. La valeur id doit être du type ID et unique dans le document contenant cet élément.Facultatif.
maxOccurs
Nombre maximal d'occurrences de l'élément dans l'élément conteneur. La valeur peut être un entier supérieur ou égal à 0. Pour ne pas définir de nombre maximal, utilisez la chaîne « unbounded ».Limité lorsque le groupe n'est pas un enfant de l'élément schema.
Facultatif.
minOccurs
Nombre minimal d'occurrences de l'élément dans l'élément conteneur. La valeur peut être un entier supérieur ou égal à 0. Pour spécifier que cet élément est facultatif, définissez cet attribut sur zéro.Limité lorsque le groupe n'est pas un enfant de l'élément schema.
Facultatif.
name
Nom de l'élément. Ce nom doit être un NCName, comme défini dans la spécification sur les espaces de noms XML. Les attributs Name et ref ne peuvent pas être présents en même temps.Obligatoire si l'élément conteneur est l'élément schema.
Facultatif.
ref
Nom d'un groupe déclaré dans ce schéma (ou un autre schéma indiqué par l'espace de noms spécifié). La valeur ref doit être un nom qualifié (QName). L'attribut ref peut inclure un préfixe d'espace de noms.Si l'attribut ref est présent, id, minOccurs et maxOccurs peuvent être présents. Ref et name s'excluent mutuellement.
Pour déclarer un groupe à l'aide d'une définition de groupe existante, utilisez l'attribut ref pour spécifier la définition de groupe existante.
<xs:group ref="globalGroup"/>Facultatif.
Informations sur l'élément
Nombre d'occurrences |
Illimité |
Éléments parents |
schema, choice, sequence, complexType, restriction (complexContent), extension (complexContent) |
Contenu |
Remarques
Chacun des éléments suivants peut être un enfant de l'élément group.
choice |
Autorise un et un seul des éléments contenus dans le groupe. |
sequence |
Requiert que les éléments du groupe s'affichent dans l'ordre spécifié. |
all |
Permet aux éléments du groupe de s'afficher (ou de ne pas s'afficher) dans n'importe quel ordre dans l'élément conteneur. |
Les attributs minOccurs et maxOccurs possèdent la valeur par défaut 1. Un groupe ne contenant aucun de ces attributs doit apparaître une et une seule fois dans l'élément conteneur.
Exemple
L'exemple suivant définit un groupe contenant une séquence de trois éléments et utilise l'élément group dans une définition de type complexe.
Autres ressources
Pour plus d'informations, consultez le document du W3C sur les schémas XML, notamment le tome 1 relatif aux structures, à l'adresse www.w3.org/TR/2001/REC-xmlschema-1-20010502/\#element-all.