Podemos controlar como os elementos são para ser usado em documentos com indicadores.
indicadores
Há sete indicadores:
indicadores de encomendas:
- All
- Choice
- Sequence
indicadores de ocorrência:
- maxOccurs
- minOccurs
Indicadores Grupo:
- Group name
- attributeGroup name
Indicadores de ordem
indicadores de ordem são usados para definir a ordem dos elementos.
Todos Indicator
O <all> indicador especifica que os elementos filhos podem aparecer em qualquer ordem, e que cada elemento filho deve ocorrer apenas uma 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: Ao usar o <all> indicador é possível definir o <minOccurs> indicador para 0 ou 1 e o <maxOccurs> indicador só pode ser definido como 1 (o <minOccurs> e <maxOccurs> são descritos mais tarde).
Indicador de escolha
O <choice> indicador especifica que qualquer um elemento filho ou de outra pode ocorrer:
<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 sequência
O <sequence> indicador especifica que os elementos filhos devem aparecer em uma ordem específica:
<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 ocorrência
indicadores de ocorrência são usados para definir a frequência com que um elemento pode ocorrer.
Note: Para todos "Order" e "Group" indicadores (qualquer, todos, escolha, seqüência, nome do grupo e referência de grupo) o valor padrão para maxOccurs e minOccurs é 1.
Indicador maxOccurs
O <maxOccurs> indicador especifica o número máximo de vezes que um elemento pode ocorrer:
<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>
O exemplo acima indica que o "child_name" elemento pode ocorrer um mínimo de uma vez (o valor padrão para minOccurs é 1) e um máximo de dez vezes na "person" elemento.
Indicador minOccurs
O <minOccurs> indicador especifica o número mínimo de vezes que um elemento pode ocorrer:
<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>
O exemplo acima indica que a "child_name" elemento pode ocorrer um mínimo de zero vezes e, no máximo, dez vezes na "person" elemento.
Tip: Para permitir que um elemento a aparecer um número ilimitado de vezes, use o maxOccurs = declaração "sem limites":
A working example:
Um arquivo XML chamado "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>
O arquivo XML acima contém um elemento raiz chamado "persons" . Dentro deste elemento raiz nós definimos três "person" elementos. Cada "person" elemento deve conter uma "full_name" elemento e que pode conter até cinco "child_name" elementos.
Aqui está o arquivo 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 de grupo
indicadores do grupo são usados para definir conjuntos relacionados de elementos.
elemento Groups
grupos de classes são definidas com a declaração de grupo, como este:
<xs:group name="groupname">
...
</xs:group>
É necessário definir um tudo, escolha, ou elemento de sequência dentro da declaração de grupo. O exemplo a seguir define um grupo denominado "persongroup" , que define um conjunto de elementos que devem ocorrer numa sequência 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>
Depois de ter definido um grupo, você pode fazer referência a ela em outra definição, como este:
<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
grupos de atributos são definidos com a declaração attributeGroup, como este:
<xs:attributeGroup name="groupname">
...
</xs:attributeGroup>
O exemplo a seguir define um grupo atributo chamado "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>
Depois de ter definido um grupo de atributos, você pode fazer referência a ela em outra definição, como este:
<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>