Home » XML » XSD : Indikator – Kode dan Contohnya

XSD : Indikator – Kode dan Contohnya

by Hanifah Nurbaeti
by Hanifah Nurbaeti

Kita dapat mengontrol BAGAIMANA elemen harus digunakan dalam dokumen dengan indikator.

Indikator

Ada tujuh indikator:

Order Indikator:

  • All
  • Choice
  • Sequence

Indikator kejadian(Occorence):

  • maxOccurs
  • minOccurs

Indikator kelompok(Group):

  • Nama grup
  • atributNama grup

Order Indicator

Indikator urutan digunakan untuk menentukan urutan elemen.

All Indikator

Indikator <all> menentukan bahwa elemen anak dapat muncul dalam urutan apa pun, dan setiap elemen anak harus muncul 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>

Catatan: Saat menggunakan indikator <all> kita dapat mengatur indikator ke 0 atau 1 dan indikator hanya dapat diatur ke 1.

Indikator Pilihan

Indikator <choice> menentukan bahwa salah satu elemen turunan atau lainnya 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>

Indikator Urutan

Indikator <sequence> 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 Kejadian(Occurence)

Indikator kejadian (occorence) digunakan untuk menentukan seberapa sering suatu elemen dapat muncul.

Catatan: Untuk semua indikator “Order” dan “Group” (any, all, choice, sequence, group name, and group reference) nilai default untuk maxOccurs dan minOccurs adalah 1.

Indikator maxOccurs

Indikator <maxOccurs> menentukan berapa kali maksimum suatu elemen dapat muncul:

<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 elemen “child_name” dapat muncul minimal satu kali (nilai default untuk minOccurs adalah 1) dan maksimal sepuluh kali dalam elemen “person”.

Indokator minOccurs

Indikator <minOccurs> menentukan jumlah minimum berapa kali elemen dapat muncul:

<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 elemen “child_name” dapat muncul minimal nol kali dan maksimal sepuluh kali dalam elemen “person”.

Tip: Untuk mengizinkan elemen muncul dalam jumlah tak terbatas, gunakan pernyataan maxOccurs = “unbounded”:

Cara kerja:

File XML bernama “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>Asep Kusnandar</full_name>
  <child_name>Asep</child_name>
</person>

<person>
  <full_name>Yusuf Ghazali</full_name>
  <child_name>Yusuf</child_name>
  <child_name>Ucup</child_name>
  <child_name>Ali</child_name>
  <child_name>Za</child_name>
</person>

<person>
  <full_name>Alfonso</full_name>
</person>

</persons>

File XML di atas berisi elemen root bernama “person”. Di dalam elemen root ini kita telah mendefinisikan tiga elemen “person”. Setiap elemen “person” harus berisi elemen “full_name” dan dapat berisi hingga lima elemen “child_name”.

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(Group)

Indikator kelompok digunakan untuk menentukan set elemen terkait.

Grup Elemen

Grup elemen ditentukan dengan deklarasi grup, seperti ini:

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

Kita harus menentukan all, choice, atau elemen sequence di dalam deklarasi grup. Contoh berikut mendefinisikan grup bernama “persongroup”, yang mendefinisikan sekelompok elemen yang harus muncul 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 menentukan grup, kita bisa mereferensikannya 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>

Grup Atribut

Grup atribut ditentukan dengan deklarasi grup atribut, seperti ini:

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

Contoh berikut mendefinisikan grup 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 menentukan grup atribut, kita bisa mereferensikannya 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>

You may also like