tutorial pengembangan web terbaru
 

Indikator XSD


Kita dapat mengontrol CARA elemen yang akan digunakan dalam dokumen dengan indikator.


indikator

Ada tujuh indikator:

Indikator Order:

  • All
  • Choice
  • Sequence

indikator terjadinya:

  • maxOccurs
  • minOccurs

Indikator kelompok:

  • Group name
  • attributeGroup name

Indikator rangka

Indikator rangka yang digunakan untuk menentukan urutan elemen.

semua Indicator

The <all> indikator menentukan bahwa elemen anak dapat muncul dalam urutan apapun, dan bahwa setiap elemen anak harus terjadi hanya sekali:

<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: Bila menggunakan <all> indikator Anda dapat mengatur <minOccurs> indikator untuk 0 atau 1 dan <maxOccurs> indikator hanya dapat diatur untuk 1 (satu <minOccurs> dan <maxOccurs> dijelaskan kemudian).

pilihan Indicator

The <choice> indikator menetapkan bahwa salah satu elemen anak atau yang lain dapat terjadi:

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

urutan Indicator

The <sequence> indikator menentukan bahwa elemen anak harus muncul dalam urutan tertentu:

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

Indikator terjadinya

indikator terjadinya digunakan untuk menentukan seberapa sering sebuah elemen dapat terjadi.

Note: Untuk semua "Order" dan "Group" indikator (apapun, semua, pilihan, urut, nama grup, dan kelompok acuan) nilai default untuk maxOccurs dan minOccurs adalah 1.

maxOccurs Indicator

The <maxOccurs> indikator menentukan jumlah maksimum kali elemen dapat terjadi:

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

Contoh di atas menunjukkan bahwa "child_name" elemen dapat terjadi minimal satu kali (nilai default untuk minOccurs adalah 1) dan maksimal sepuluh kali dalam "person" elemen.

minOccurs Indicator

The <minOccurs> indikator menentukan jumlah minimum kali elemen dapat terjadi:

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

Contoh di atas menunjukkan bahwa "child_name" elemen dapat terjadi minimal nol kali dan maksimal sepuluh kali dalam "person" elemen.

Tip: Untuk memungkinkan elemen muncul jumlah yang tidak terbatas kali, gunakan maxOccurs = "tak terbatas" pernyataan:

A working example:

Sebuah file XML yang disebut "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>

File XML di atas mengandung elemen root bernama "persons" . Dalam elemen akar ini kita telah mendefinisikan tiga "person" elemen. Setiap "person" elemen harus berisi "full_name" elemen dan dapat berisi hingga lima "child_name" elemen.

Berikut adalah file skema "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>

Indikator kelompok

Indikator kelompok digunakan untuk mendefinisikan set terkait elemen.

elemen Grup

kelompok elemen didefinisikan dengan deklarasi kelompok, seperti ini:

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

Anda harus mendefinisikan semua, pilihan, atau elemen urut dalam deklarasi kelompok. Contoh berikut mendefinisikan kelompok bernama "persongroup" , yang mendefinisikan sekelompok elemen yang harus terjadi dalam urutan yang tepat:

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

Setelah Anda telah menetapkan grup, Anda dapat referensi itu dalam definisi lain, seperti ini:

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

atribut Grup

kelompok atribut didefinisikan dengan deklarasi attributeGroup, seperti ini:

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

Contoh berikut mendefinisikan sebuah kelompok atribut bernama "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>

Setelah Anda telah menetapkan kelompok atribut, Anda dapat referensi itu dalam definisi lain, seperti ini:

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