Ultimele tutoriale de dezvoltare web
 

Indicatori XSD


Putem controla modul în care elementele urmează să fie utilizate în documente cu indicatori.


Indicatori

Există șapte indicatori:

Indicatorii de ordine:

  • All
  • Choice
  • Sequence

Indicatorii ocurență:

  • maxOccurs
  • minOccurs

Indicatoare Grupa:

  • Group name
  • attributeGroup name

Indicatori Comanda

Indicatorii de ordine sunt folosite pentru a defini ordinea elementelor.

Toate Indicatorul

<all> indicator specifică faptul că elementele de copil pot apărea în orice ordine, și că fiecare element de copil trebuie să aibă loc o singură dată:

<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: Când utilizați <all> indicatorul puteți seta <minOccurs> indicatorul la 0 sau 1 și <maxOccurs> indicator poate fi setat numai la 1 ( <minOccurs> și <maxOccurs> sunt descrise mai târziu).

alegerea indicatorului

<choice> indicator specifică faptul că poate avea loc fie un element copil sau altul:

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

Secvență Indicator

<sequence> indicator specifică faptul că elementele de copil trebuie să apară într - o anumită ordine:

<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 ocurență

Indicatorii ocurență sunt folosite pentru a defini cât de des se poate produce un element.

Note: Pentru toate "Order" și "Group" indicatori (orice, toate, alegerea, secvență, nume de grup, de referință de grup) valoarea implicită pentru maxOccurs și minOccurs este 1.

maxOccurs Indicator

<maxOccurs> Indicatorul specifică numărul maxim de ori poate apărea un element:

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

Exemplul de mai sus indică faptul că "child_name" elementul poate avea loc un minim de o singură dată (valoarea implicită pentru minOccurs este 1) și un maxim de zece ori în "person" element.

minOccurs Indicator

<minOccurs> Indicatorul specifică numărul minim de ori poate apărea un element:

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

Exemplul de mai sus indică faptul că "child_name" elementul poate avea loc un minim de zero , ori si un maxim de zece ori în "person" element.

Tip: Pentru a permite un element să apară un număr nelimitat de ori, utilizați maxOccurs = declarația „nemărginit“:

A working example:

Un fișier XML numit "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>

Fișierul XML de mai sus conține un element rădăcină numit "persons" . În interiorul acestui element rădăcină , am definit trei "person" elemente. Fiecare "person" elementul trebuie să conțină un "full_name" element și poate conține până la cinci "child_name" elemente.

Aici este fișierul 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>

Indicatoare Grupa

Indicatorii de grup sunt folosite pentru a defini seturi de elemente conexe.

Grupuri Element

Grupuri de elemente sunt definite cu declarația de grup, ca aceasta:

<xs:group name="groupname">
...
</xs:group>

Trebuie să definiți un all, alegere, sau element de secvență în interiorul declarației de grup. Următorul exemplu definește un grup denumit "persongroup" , care definește un grup de elemente care trebuie să aibă loc într - o secvență exactă:

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

După ce ați definit un grup, puteți face referire la el într-o altă definiție, cum ar fi acest lucru:

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

Caracteristica Grupuri

grupuri de atribute sunt definite cu declarația attributeGroup, ca aceasta:

<xs:attributeGroup name="groupname">
...
</xs:attributeGroup>

Următorul exemplu definește un grup atribut numit "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>

După ce ați definit un grup de atribut, puteți face referire la el într-o altă definiție, cum ar fi acest lucru:

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