Kita dapat mengontrol BAGAIMANA elemen harus digunakan dalam dokumen dengan indikator.
Section Artikel
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>