XSD Complexe Type Indicatoren

Door middel van indicatoren kunnen we bepalen hoe elementen in documenten worden gebruikt.

Indicator

Er zijn zeven soorten indicatoren:

Indicator van volgorde:

  • Alles
  • Keuze
  • Volgorde

Indicator van voorkomen:

  • maxOccurs
  • minOccurs

Group indicator:

  • Group name
  • attributeGroup name

Order indicator

Order indicator wordt gebruikt om de volgorde van elementen te definiëren.

All indicator

<all> indicator bepaalt dat subelementen in willekeurige volgorde kunnen voorkomen en dat elke subelement slechts een keer moet 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 het gebruik van de <all> indicator kan <minOccurs> worden ingesteld op 0 of 1, en kan de <maxOccurs> indicator alleen worden ingesteld op 1 (dat later wordt besproken over <minOccurs> en <maxOccurs>).

Choice indicator

<choice> indicator bepaalt dat een subelement of een ander subelement (ofwel dit of dat) 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>

Tip:Om de subelementen een onbeperkte hoeveelheid keren te laten voorkomen, kan <maxOccurs> (dat later wordt besproken) worden ingesteld op unbounded (onbeperkt).

Sequence indicator

<sequence> bepaalt dat subelementen in een specifieke volgorde moeten voorkomen:

<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>

Occurrence indicator

Occurrence indicator wordt gebruikt om de frequentie van voorkomen van een element te definiëren.

Opmerking:Voor alle "Order" en "Group" indicators (any, all, choice, sequence, groepsnaam en groepsverwijzing), zijn de standaardwaarden van maxOccurs en minOccurs 1.

maxOccurs indicator

<maxOccurs> indicator bepaalt de maximale hoeveelheid keren 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 voorbeeld hierboven toont aan dat de subelement "child_name" minimaal 1 keer kan voorkomen in het "person"-element (waarbij de standaardwaarde van minOccurs 1 is), en maximaal 10 keer.

minOccurs indicator

<minOccurs> indicator bepaalt de minimale hoeveelheid keren 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 voorbeeld hierboven toont aan dat de subelement "child_name" minimaal 0 en maximaal 10 keer kan voorkomen in het "person"-element.

Tip:Om de hoeveelheid van een element onbeperkt te maken, gebruik dan de verklaring maxOccurs="unbounded":

Een voorbeeld:

Het XML-bestand genaamd "Myfamily.xml":

<?xml version="1.0" encoding="ISO-8859-1"?>
<persons xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
xsi:noNamespaceSchemaLocation="family.xsd">
<person>
<full_name>Tony Smith</full_name>
<child_name>Cecilie</child_name>
</person>
<person>
<full_name>David Smith</full_name>
<child_name>Jogn</child_name>
<child_name>mike</child_name>
<child_name>kyle</child_name>
<child_name>mary</child_name>
</person>
<person>
<full_name>Michael Smith</full_name>
</person>
</persons>

Deze XML-bestand bevat een root-element genaamd "persons" waarin we drie "person"-elementen definiëren. Elke "person"-element moet een "full_name"-element bevatten en kan maximaal vijf "child_name"-elementen bevatten.

Dit is het schema-bestand "family.xsd":

<?xml version="1.0" encoding="ISO-8859-1"?>
<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>

Group indicator

De Group indicator wordt gebruikt om gerelateerde elementen te definiëren.

Elementengroep

Een elementengroep wordt gedefinieerd via de group-declaratie:

<xs:group name="组名称">
  ...
</xs:group>

U moet binnen de group-declaratie een all, choice of sequence-element definiëren. Het volgende voorbeeld definieert een group genaamd "persongroup", die een exacte volgorde van elementen definieert die moeten verschijnen:

<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>

Naar aanleiding van het voltooien van de definitie van de group, kunt u het in een andere definitie verwijzen:

<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>

Eigenschapsgroep

Een eigenschapsgroep wordt gedefinieerd via de attributeGroup-declaratie:

<xs:attributeGroup name="组名称">
  ...
</xs:attributeGroup>

Het volgende voorbeeld definieert een eigenschapsgroep genaamd "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>

Naar aanleiding van het voltooien van het definiëren van de eigenschapsgroep, kunt u het in een andere definitie verwijzen, zoals hieronder:

<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>