Indicatore di tipo complesso XSD

Grazie agli indicatori, possiamo controllare il modo in cui vengono utilizzati gli elementi nel documento.

Indicatore

Ci sono sette tipi di indicatori:

Indicatore di Ordine:

  • Tutti
  • Scelta
  • Sequenza

Indicatore di Occorrenza:

  • maxOccurs
  • minOccurs

indicatore di Group:

  • Group name
  • attributeGroup name

indicatore di Order

L'indicatore di Order viene utilizzato per definire l'ordine degli elementi.

indicatore di All

<all> indica che i sottoelementi possono apparire in qualsiasi ordine e che ogni sottoelemento deve apparire una sola 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>

Nota:Quando si utilizza l'indicatore <all>, è possibile impostare <minOccurs> su 0 o 1, ma solo impostare l'indicatore <maxOccurs> su 1 (che verrà spiegato in seguito).

indicatore di Choice

<choice> indica che un sottoelemento può apparire o un altro sottoelemento (o uno o l'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>

Suggerimento:Per impostare la frequenza di apparizione illimitata di un sottoelemento, impostare <maxOccurs> (che verrà spiegato in seguito) su unbounded (senza limiti).

indicatore di Sequence

<sequence> definisce l'ordine in cui devono apparire i sottoelementi:

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

indicatore di Occurrence

L'indicatore di Occurrence viene utilizzato per definire la frequenza di apparizione di un elemento.

Nota:Per tutti gli indicatori "Order" e "Group" (any, all, choice, sequence, nome del gruppo e riferimento del gruppo), i valori predefiniti di maxOccurs e minOccurs sono entrambi 1.

indicatore maxOccurs

<maxOccurs> indica il numero massimo di volte in cui un elemento può apparire:

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

Esempi precedenti dimostrano che il sottoelemento "child_name" può apparire nell'elemento "person" almeno una volta (dove il valore predefinito di minOccurs è 1) e al massimo 10 volte.

indicatore minOccurs

<minOccurs> indica il numero minimo di volte in cui un elemento può apparire:

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

Esempi precedenti dimostrano che il sottoelemento "child_name" può apparire nell'elemento "person" almeno 0 volte e al massimo 10 volte.

Suggerimento:Per rendere il numero di occorrenze di un elemento illimitato, utilizzare la dichiarazione maxOccurs="unbounded":

Un esempio reale:

Il file XML chiamato "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>

Questo file XML contiene un elemento radice chiamato "persons". All'interno di questo elemento radice, abbiamo definito tre elementi "person". Ogni elemento "person" deve contenere un elemento "full_name", e può contenere fino a 5 elementi "child_name".

Questo è il file schema "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>

Segnalatore di gruppo

Il segnalatore di gruppo viene utilizzato per definire un insieme di elementi correlati.

Gruppo di elementi

Il gruppo di elementi viene definito tramite la dichiarazione group:

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

Devi definire un elemento all, choice o sequence all'interno della dichiarazione group. Ecco un esempio che definisce un group chiamato "persongroup", che definisce un gruppo di elementi che devono apparire in sequenza precisa:

<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 il group, puoi referenziarlo in un'altra definizione:

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

Gruppo di attributi

Il gruppo di attributi viene definito tramite la dichiarazione attributeGroup:

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

Ecco un esempio che definisce un gruppo di attributi chiamato "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 il gruppo di attributi, puoi referenziarlo in un'altra definizione, come nel seguente esempio:

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