XSD Indicadores
Mediante los indicadores, podemos controlar la forma en que se utilizan los elementos en un documento.
Indicadores
Hay siete indicadores:
Indicadores Order:
- All
- Choice
- Sequence
Indicadores Occurrence:
- maxOccurs
- minOccurs
Indicadores Group:
- Group name
- attributeGroup name
Indicador Order
El indicador Order se utiliza para definir el orden de los elementos.
Indicador All
El indicador <all> establece que los elementos secundarios pueden aparecer en cualquier orden y que cada elemento secundario debe aparecer solo una vez:
<xs:complexType>
<xs:all>
<xs:element name="firstname" type="xs:string"/>
<xs:element name="lastname" type="xs:string"/>
</xs:all>
</xs:complexType>
</xs:element>
Nota:Cuando se utiliza el indicador <all>, puede establecer <minOccurs> en 0 o 1, y solo puede establecer el indicador <maxOccurs> en 1 (más adelante se explicarán <minOccurs> y <maxOccurs>).
Indicador Choice
El indicador <choice> establece que puede aparecer un elemento secundario u otro elemento secundario (uno u otro):
<xs:complexType>
<xs:choice>
<xs:element name="employee" type="employee"/>
<xs:element name="member" type="member"/>
</xs:choice>
</xs:complexType>
</xs:element>
Indicador Sequence
<sequence> establece que los elementos secundarios deben aparecer en un orden específico:
<xs:complexType>
<xs:sequence>
<xs:element name="firstname" type="xs:string"/>
<xs:element name="lastname" type="xs:string"/>
</xs:sequence>
</xs:complexType>
</xs:element>
Indicador Occurrence
El indicador Occurrence se utiliza para definir la frecuencia con la que aparece un elemento.
Nota:Para todos los indicadores "Order" y "Group" (any, all, choice, sequence, group name y group reference), los valores predeterminados de maxOccurs y minOccurs son 1.
Indicador maxOccurs
El indicador <maxOccurs> puede especificar el número máximo de veces que puede aparecer un elemento:
<xs:complexType>
<xs:sequence>
<xs:element name="full_name" type="xs:string"/>
<xs:element name="child_name" type="xs:string" maxOccurs="10"/>
</xs:sequence>
</xs:complexType>
</xs:element>
El ejemplo anterior muestra que el elemento secundario "child_name" puede aparecer al menos una vez (donde el valor predeterminado de minOccurs es 1) y como máximo 10 veces en el elemento "person".
Indicador minOccurs
El indicador <minOccurs> puede especificar el número mínimo de veces que puede aparecer un elemento:
<xs:complexType>
<xs:sequence>
<xs:element name="full_name" type="xs:string"/>
<xs:element name="child_name" type="xs:string"
maxOccurs="10" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:element>
El ejemplo anterior muestra que el elemento secundario "child_name" puede aparecer al menos 0 veces y como máximo 10 veces en el elemento "person".
Consejo:Si desea que un elemento pueda aparecer sin límite de veces, utilice la declaración maxOccurs="unbounded":
Un ejemplo práctico:
El archivo XML llamado "Myfamily.xml":
<persons xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="family.xsd">
<person>
<full_name>Hege Refsnes</full_name>
<child_name>Cecilie</child_name>
</person>
<person>
<full_name>Tove Refsnes</full_name>
<child_name>Hege</child_name>
<child_name>Stale</child_name>
<child_name>Jim</child_name>
<child_name>Borge</child_name>
</person>
<person>
<full_name>Stale Refsnes</full_name>
</person>
</persons>
El archivo XML anterior contiene un elemento raíz llamado "persons". Dentro de este elemento raíz, definimos tres elementos "person". Cada elemento "person" debe contener un elemento "full_name" y puede contener hasta 5 elementos "child_name".
Este es el archivo de esquema "family.xsd":
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
elementFormDefault="qualified">
<xs:element name="persons">
<xs:complexType>
<xs:sequence>
<xs:element name="person" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="full_name" type="xs:string"/>
<xs:element name="child_name" type="xs:string"
minOccurs="0" maxOccurs="5"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
Indicador Group
El indicador Group se utiliza para definir grupos de elementos relacionados.
Grupo de elementos
Los grupos de elementos se definen mediante la declaración group:
...
</xs:group>
Debe definir un elemento all, choice o sequence dentro de la declaración group. El siguiente ejemplo define un group llamado "persongroup", que define un grupo de elementos que deben aparecer en un orden preciso:
<xs:sequence>
<xs:element name="firstname" type="xs:string"/>
<xs:element name="lastname" type="xs:string"/>
<xs:element name="birthday" type="xs:date"/>
</xs:sequence>
</xs:group>
Una vez que haya definido el group, puede hacer referencia a él en otra definición:
<xs:sequence>
<xs:element name="firstname" type="xs:string"/>
<xs:element name="lastname" type="xs:string"/>
<xs:element name="birthday" type="xs:date"/>
</xs:sequence>
</xs:group>
<xs:element name="person" type="personinfo"/>
<xs:complexType name="personinfo">
<xs:sequence>
<xs:group ref="persongroup"/>
<xs:element name="country" type="xs:string"/>
</xs:sequence>
</xs:complexType>
Grupo de atributos
Los grupos de atributos se definen mediante la declaración attributeGroup:
...
</xs:attributeGroup>
El siguiente ejemplo define un grupo de atributos llamado "personattrgroup":
<xs:attribute name="firstname" type="xs:string"/>
<xs:attribute name="lastname" type="xs:string"/>
<xs:attribute name="birthday" type="xs:date"/>
</xs:attributeGroup>
Una vez que haya definido el grupo de atributos, puede hacer referencia a él en otra definición, de la siguiente manera:
<xs:attribute name="firstname" type="xs:string"/>
<xs:attribute name="lastname" type="xs:string"/>
<xs:attribute name="birthday" type="xs:date"/>
</xs:attributeGroup>
<xs:element name="person">
<xs:complexType>
<xs:attributeGroup ref="personattrgroup"/>
</xs:complexType>
</xs:element>