Siamo in grado di controllare come gli elementi devono essere utilizzati nei documenti con indicatori.
indicatori
Ci sono sette indicatori:
Indicatori di ordine:
- All
- Choice
- Sequence
Indicatori di occorrenza:
- maxOccurs
- minOccurs
Indicatori Gruppo:
- Group name
- attributeGroup name
Indicatori ordine
indicatori di ordine vengono utilizzati per definire l'ordine degli elementi.
Tutti Indicator
Il <all> indicatore specifica che gli elementi figli possono apparire in qualsiasi ordine, e che ogni elemento figlio deve avvenire solo una volta:
<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: Quando si utilizza il <all> indicatore è possibile impostare il <minOccurs> indicatore a 0 o 1 e il <maxOccurs> indicatore può essere impostato solo su 1 (il <minOccurs> e <maxOccurs> sono descritti più avanti).
Indicatore scelta
Il <choice> indicatore specifica che possono verificarsi sia un elemento figlio o un altro:
<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>
Indicatore di sequenza
Il <sequence> indicatore specifica che gli elementi figlio devono apparire in un ordine specifico:
<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>
Indicatori di occorrenza
Gli indicatori di occorrenza sono usati per definire la frequenza può verificarsi un elemento.
Note: Per tutti "Order" e "Group" indicatori (qualsiasi, tutto, la scelta, la sequenza, il nome del gruppo, e di riferimento del gruppo) il valore di default per maxOccurs e minOccurs è 1.
Indicatore maxOccurs
Il <maxOccurs> indicatore specifica il numero massimo di volte può verificarsi 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>
L'esempio indica che il sopra "child_name" elemento può verificarsi un minimo di una volta (il valore predefinito per minOccurs è 1) e un massimo di dieci volte nella "person" elemento.
Indicatore minOccurs
Il <minOccurs> indicatore specifica il numero minimo di volte può verificarsi 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>
L'esempio indica precede che il "child_name" elemento può verificarsi un minimo di zero volte e un massimo di dieci volte nella "person" elemento.
Tip: Per consentire un elemento di apparire un numero illimitato di volte, utilizzare l'maxOccurs = istruzione "illimitata":
A working example:
Un file XML chiamato "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>
Il file XML sopra contiene un elemento radice denominato "persons" . All'interno di questo elemento radice abbiamo definito tre "person" elementi. Ogni "person" elemento deve contenere un "full_name" elemento e può contenere fino a cinque "child_name" elementi.
Ecco il file di schema "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>
Indicatori di gruppo
Gli indicatori di gruppo vengono utilizzati per definire set correlate di elementi.
Gruppi Element
gruppi di elementi sono definiti con la dichiarazione di gruppo, in questo modo:
<xs:group name="groupname">
...
</xs:group>
È necessario definire un tutto, la scelta, o elemento di sequenza all'interno della dichiarazione del gruppo. Il seguente esempio definisce un gruppo denominato "persongroup" , che definisce un gruppo di elementi che devono presentarsi in una precisa sequenza:
<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>
Dopo aver definito un gruppo, è possibile fare riferimento in un'altra definizione, in questo modo:
<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>
Attributo Gruppi
gruppi di attributi sono definiti con la dichiarazione attributeGroup, in questo modo:
<xs:attributeGroup name="groupname">
...
</xs:attributeGroup>
L'esempio seguente definisce un gruppo di attributo denominato "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>
Dopo aver definito un gruppo di attributi, è possibile fare riferimento in un'altra definizione, in questo modo:
<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>