Podemos controlar cómo los elementos se van a utilizar en los documentos con los indicadores.
indicadores
Hay siete indicadores:
indicadores de orden:
- All
- Choice
- Sequence
indicadores de ocurrencia:
- maxOccurs
- minOccurs
Indicadores Grupo:
- Group name
- attributeGroup name
Indicadores de orden
indicadores de pedido se utilizan para definir el orden de los elementos.
Todo Indicador
La <all> indicador especifica que los elementos secundarios pueden aparecer en cualquier orden, y que cada elemento secundario deben ocurrir sólo una vez:
<xs:element name="person">
<xs:complexType>
<xs:all>
<xs:element name="firstname" type="xs:string"/>
<xs:element name="lastname" type="xs:string"/>
</xs:all>
</xs:complexType>
</xs:element>
Note: Cuando se utiliza el <all> indicador se puede establecer el <minOccurs> indicador a 0 ó 1, y el <maxOccurs> indicador sólo se puede establecer en 1 ( <minOccurs> y <maxOccurs> se describen más adelante).
elección del indicador
La <choice> indicador especifica que pueden ocurrir ya sea un elemento secundario o de otra:
<xs:element name="person">
<xs:complexType>
<xs:choice>
<xs:element name="employee" type="employee"/>
<xs:element name="member" type="member"/>
</xs:choice>
</xs:complexType>
</xs:element>
Indicador de secuencia
La <sequence> indicador especifica que los elementos secundarios deben aparecer en un orden específico:
<xs:element name="person">
<xs:complexType>
<xs:sequence>
<xs:element name="firstname" type="xs:string"/>
<xs:element name="lastname" type="xs:string"/>
</xs:sequence>
</xs:complexType>
</xs:element>
indicadores de ocurrencia
indicadores de ocurrencia se utilizan para definir la frecuencia se puede producir un elemento.
Note: Para todos "Order" y "Group" indicadores (cualquiera, todos, la elección, la secuencia, el nombre del grupo, y la referencia del grupo) el valor por defecto para maxOccurs y minOccurs es 1.
Indicador maxOccurs
La <maxOccurs> indicador especifica el número máximo de veces que puede ocurrir un elemento:
<xs:element name="person">
<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 indica que el "child_name" elemento puede aparecer un mínimo de una vez (el valor por defecto para minOccurs es 1) y un máximo de diez veces en la "person" elemento.
Indicador minOccurs
La <minOccurs> indicador especifica el número mínimo de veces que puede ocurrir un elemento:
<xs:element name="person">
<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 indica que el "child_name" elemento puede aparecer un mínimo de cero veces y un máximo de diez veces en la "person" elemento.
Tip: Para permitir que un elemento que aparezca un número ilimitado de veces, utilice el maxOccurs = instrucción "sin límites":
A working example:
Un archivo XML denominado "Myfamily.xml" :
<?xml version="1.0" encoding="UTF-8"?>
<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 denominado "persons" . Dentro de este elemento raíz se han definido tres "person" elementos. Cada "person" elemento debe contener un "full_name" elemento y puede contener hasta cinco "child_name" elementos.
Aquí está el archivo de esquema "family.xsd" :
<?xml version="1.0" encoding="UTF-8"?>
<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>
Indicadores del grupo
indicadores de grupo se utilizan para definir conjuntos relacionados de elementos.
Grupos elemento
grupos de elementos se definen con la declaración de grupo, como sigue:
<xs:group name="groupname">
...
</xs:group>
Debe definir un todo, la elección, o elemento de la secuencia dentro de la declaración de grupo. El ejemplo siguiente define un grupo llamado "persongroup" , que define un grupo de elementos que deben ocurrir en una secuencia exacta:
<xs:group name="persongroup">
<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>
Después de haber definido un grupo, se puede hacer referencia a ella en otra definición, así:
<xs:group name="persongroup">
<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>
atributo Grupos
los grupos de atributos se definen con la declaración attributeGroup, como esto:
<xs:attributeGroup name="groupname">
...
</xs:attributeGroup>
El ejemplo siguiente define un grupo de atributos llamado "personattrgroup" :
<xs:attributeGroup name="personattrgroup">
<xs:attribute name="firstname" type="xs:string"/>
<xs:attribute name="lastname" type="xs:string"/>
<xs:attribute name="birthday" type="xs:date"/>
</xs:attributeGroup>
Después de haber definido un grupo de atributos, se puede hacer referencia a ella en otra definición, así:
<xs:attributeGroup name="personattrgroup">
<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>