Compartir a través de

Elemento <xsd:group>

  • Artículo

Agrupa un conjunto de declaraciones de elementos de forma que puedan incorporarse como un grupo en definiciones de tipos complejos.

<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>

Atributos

  • nombre
    Nombre del grupo. El nombre no debe incluir un signo de dos puntos (NCName), como se define en la especificación de los espacios de nombres XML.

    Este atributo se utiliza solo cuando el elemento schema es el primario de este elemento group. En este caso, group es un grupo modelo para ser utilizado por los elementos complexType, choice y sequence.

    Opcional.

  • id
    Identificador de este elemento. El valor id debe ser de tipo ID y debe ser único dentro del documento que contiene este elemento.

    Opcional.

  • maxOccurs
    Número máximo de veces que el elemento puede aparecer en el elemento contenedor. El valor puede ser un número entero mayor o igual que cero. Para no limitar el número máximo, utilice la cadena "sin delimitar".

    Limitado cuando el grupo no es un elemento secundario del elemento schema.

    Opcional.

  • minOccurs
    Número mínimo de veces que el elemento puede aparecer en el elemento contenedor. El valor puede ser un número entero mayor o igual que cero. Para especificar que este elemento es opcional, establezca este atributo como cero.

    Limitado cuando el grupo no es un elemento secundario del elemento schema.

    Opcional.

  • nombre
    Nombre del elemento. El nombre no debe incluir un signo de dos puntos (NCName), como se define en la especificación de los espacios de nombres XML. Los atributos Name y ref no pueden estar presentes a la vez.

    Se requiere si el elemento contenedor es el elemento schema.

    Opcional.

  • ref
    Nombre de un grupo declarado en este esquema (u otro esquema indicado por el espacio de nombres especificado). El valor ref debe ser un QName. ref puede incluir un prefijo del espacio de nombres.

    Si el atributo ref está presente, pueden estar presentes id, minOccurs y maxOccurs. Ref y name se excluyen mutuamente.

    Para declarar un grupo mediante una definición de grupo existente, utilice el atributo ref para especificar dicha definición.

    <xs:group ref="globalGroup"/>

    Parámetro opcional.

Información del elemento

Número de apariciones

Ilimitado

Elementos primarios

schema, choice, sequence, complexType, restriction (complexContent), extension (complexContent)

Contenido

annotation, all, choice, sequence

Comentarios

Cualquiera de los elementos siguientes puede ser secundario del elemento group.

choice

Solo permite uno de los elementos contenidos en el grupo.

sequence

Requiere que los elementos del grupo aparezcan en la secuencia especificada.

all

Permite que los elementos del grupo aparezcan o no en cualquier orden en el elemento contenedor.

El valor predeterminado de los atributos minOccurs y maxOccurs es 1. Un grupo sin ninguno de los atributos debe aparecer solo una vez en el elemento contenedor.

Ejemplo

En el ejemplo siguiente se define un grupo que contiene una secuencia de tres elementos y utiliza el elemento group en una definición de tipo complejo.

Otros recursos

Para obtener más información, vea la parte 1 sobre recomendación sobre estructuras de esquema XML del W3C en la dirección www.w3.org/TR/2001/REC-xmlschema-1-20010502/\#element-all.

Vea también

Referencia

Referencia de esquemas XML (XSD)
Elementos de los esquemas XML