XSD- indicatoren
We kunnen bepalen HOE elementen worden gebruikt in documenten met indicatoren.
Indicatoren
Er zijn zeven indicatoren:
Bestelindicatoren:
- Allemaal
- Keuze
- Volgorde
Aanwezigheidsindicatoren:
- maxOccurs
- minOccurs
Groepsindicatoren:
- Groepsnaam
- attribuutGroepsnaam
Bestelindicatoren
Volgorde-indicatoren worden gebruikt om de volgorde van de elementen te bepalen.
Alle indicatoren
De indicator <all> geeft aan dat de onderliggende elementen in elke volgorde kunnen verschijnen en dat elk onderliggend element slechts één keer mag voorkomen:
<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>
Opmerking: Bij gebruik van de <all>-indicator kunt u de <minOccurs>-indicator op 0 of 1 zetten en de <maxOccurs>-indicator alleen op 1 (de <minOccurs> en <maxOccurs> worden later beschreven).
Keuze-indicator
De <choice>-indicator geeft aan dat ofwel het ene kindelement of het andere kan voorkomen:
<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>
Volgorde-indicator:
De indicator <reeks> geeft aan dat de onderliggende elementen in een bepaalde volgorde moeten verschijnen:
<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>
Voorvalindicatoren
Aanwezigheidsindicatoren worden gebruikt om te bepalen hoe vaak een element kan voorkomen.
Opmerking: Voor alle indicatoren "Order" en "Groep" (elke, alle, keuze, volgorde, groepsnaam en groepsreferentie) is de standaardwaarde voor maxOccurs en minOccurs 1.
maxOccurs-indicator
De indicator <maxOccurs> geeft het maximum aantal keren aan dat een element kan voorkomen:
<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>
Het bovenstaande voorbeeld geeft aan dat het element "child_name" minimaal één keer kan voorkomen (de standaardwaarde voor minOccurs is 1) en maximaal tien keer in het element "person".
minOccurs-indicator
De indicator <minOccurs> geeft het minimum aantal keren aan dat een element kan voorkomen:
<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>
Het bovenstaande voorbeeld geeft aan dat het element "child_name" minimaal nul keer en maximaal tien keer kan voorkomen in het element "person".
Tip: Als u een element een onbeperkt aantal keren wilt laten verschijnen, gebruikt u de instructie maxOccurs="unbounded":
Een werkend voorbeeld:
Een XML-bestand met de naam "Mijnfamilie.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>
Het bovenstaande XML-bestand bevat een root-element met de naam "persons". Binnen dit basiselement hebben we drie "persoon"-elementen gedefinieerd. Elk "person"-element moet een "full_name"-element bevatten en het kan maximaal vijf "child_name"-elementen bevatten.
Hier is het schemabestand "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>
Groepsindicatoren
Groepsindicatoren worden gebruikt om gerelateerde sets van elementen te definiëren.
Elementgroepen
Elementgroepen worden gedefinieerd met de groepsdeclaratie, als volgt:
<xs:group name="groupname">
...
</xs:group>
U moet een alles-, keuze- of sequentie-element definiëren binnen de groepsdeclaratie. Het volgende voorbeeld definieert een groep met de naam "persongroup", die een groep elementen definieert die in een exacte volgorde moeten voorkomen:
<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>
Nadat u een groep hebt gedefinieerd, kunt u ernaar verwijzen in een andere definitie, zoals deze:
<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>
Attribuutgroepen
Attribuutgroepen worden als volgt gedefinieerd met de attribuutGroup-declaratie:
<xs:attributeGroup name="groupname">
...
</xs:attributeGroup>
Het volgende voorbeeld definieert een kenmerkgroep met de naam "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>
Nadat u een attribuutgroep hebt gedefinieerd, kunt u ernaar verwijzen in een andere definitie, zoals deze:
<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>