minOccurs
El elemento element
permite el uso de un atributo minOccurs
cuando se encuentra dentro de un elemento indicador, es decir, dentro de algunos de los siguientes:
sequence
all
choice
El atributo minOccurs
define el número mínimo de ocurrencias, es decir, el número mínimo de veces que se debe utilizar un elemento.
El atributo minOccurs
debe ir acompañado del atributo maxOccurs
. Además, su valor debe ser:
- Un número entero positivo.
- Menor o igual que el valor
maxOccurrs
.
El valor por defecto de minOccurs
es 1.
Consideremos el siguiente documento XSD:
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="objeto" type="propiedades-objeto"/>
<xs:complexType name="propiedades-objeto">
<xs:complexContent>
<xs:restriction base="xs:anyType">
<xs:sequence>
<xs:element name="material" type="xs:string" />
<xs:element name="color" type="xs:string" minOccurs="2" maxOccurs="3" />
</xs:sequence>
</xs:restriction>
</xs:complexContent>
</xs:complexType>
</xs:schema>
En el esquema anterior se define que <color>
debe aparecer un mínimo de 2 veces y un máximo de 3 veces.
Ejemplos de documentos XML válidos son los siguientes:
<objeto>
<material>Plástico</material>
<color>Negro</color>
<color>Blanco</color>
</objeto>
<objeto>
<material>Plástico</material>
<color>Negro</color>
<color>Gris</color>
<color>Blanco</color>
</objeto>