۱۹
خرداد

جلسه ۸۶ : آموزش کار با Indicators ها در schema

دسته‌بندی‌ها :

فایل ها
نوع محتوا

جزئیات
نوع محتواآموزشی

فهرست

مقدمه

با سلام خدمت کاربران گرامی سایت پی وی لرن و علاقمندان و کاربرانی که علاقمند به یادگیری دوره XML هستند. در جلسه گذشته Mixed Content ها یا محتواهای ترکیبی را شناختیم و کار با آن ها را فراگرفتیم. در ادامه سر فصل آموزشی schema شما را به آموزش کار با Indicators ها در schema دعوت می کنیم.

آموزش کار با Indicators ها در Schema

به Indicators ها یا شاخص ها می توان عناصر HOW را در اسناد کنترل کرد.

Indicators شاخص ها

هفت نوع Indicators یا شاخص وجود دارد:

شاخص های Order که عبارتند از:

All
Choice
Sequence

شاخص های Occurrence که شامل موارد زیر می شود:

maxOccurs
minOccurs

و شاخص های Group که دو نوع هستند:

Group name
attributeGroup name

شاخص های Order

شاخص های Order برای مشخص کردن ترتیب عناصر مورد استفاده قرار می گیرند.

شاخص ALL

شاخص <all> عنصر child را که می تواند در هر ترتیب ظاهر شود مشخص می کند.
آن عنصر child باید فقط یک بار رخ داده باشد.

مثال :

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

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

نکته

هنگام استفاده از شاخص <all> می توانید شاخص <minOccurs> را بر روی ۰ و یا ۱ تنظیم کنید.
شاخص <maxOccurs> نیز باید همواره بر روی ۱ تنظیم شود.
( بعداً راجع به شاخص <maxOccurs> و شاخص <minOccurs> توضیح خواهیم داد.)

شاخص choice

شاخص <choice> مشخص می کند که فقط یک عنصر child و یا عنصر دیگری می تواند رخ دهد:

مثال :

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

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

شاخص sequence

شاخص <sequence> مشخص می کند که عنصر child باید در ردیف مشخصی ظاهر شود:

مثال :

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

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

شاخص Occurrence

از این شاخص برای تعیین تعداد رخ دادن یک عنصر استفاده می شود.

نکته

برای شاخص “Order” و شاخص “Group” یعنی (any, all, choice, sequence, group name, و group reference) مقدار پیش فرض برای maxOccurs و minOccurs 1 است.

شاخص maxOccurs

شاخص <maxOccurs> حداکثر تعداد دفعاتی که یک عنصر می تواند رخ دهد را تعیین می کند:

مثال :

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

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

مثال بالا نشان می دهد که عنصر “child_name” حداقل یک بار (مقدار پیش فرض برای minOccurs برابر ۱ است) و حداکثر ده بار در عنصر “person” رخ می دهد.

شاخص minOccurs

نشانگر <minOccurs> حداقل تعداد دفعاتی که یک عنصر می تواند رخ دهد را مشخص می کند:

مثال :

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

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

مثال بالا نشان می دهد که عنصر “child_name” می تواند حداقل صفر و حداکثر ده بار در عنصر “person” رخ دهد.

توصیه

برای این که یک عناصر به صورت نامحدود بتواند ظاهر شود از عبارت maxOccurs = “unbounded” استفاده کنید.

نمونه کار:

به فایل XML زیر به نام “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>

<?xml version="1.0" encoding="UTF-8"?>

<persons xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:noNamespaceSchemaLocation="family.xsd">

<full_name>Hege Refsnes</full_name>

<child_name>Cecilie</child_name>

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

<full_name>Stale Refsnes</full_name>

</person>

</persons>

فایل XML بالا شامل یک عنصر ریشه به نام “persons” است. در داخل این عنصر ریشه سه عنصر “ر” تعریف شده است.
هر عنصر “person” باید یک عنصر “full_name” داشته باشد که خود می تواند شامل پنج عنصر “child_name” باشد.

در اینجا فایل 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>

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

شاخص های Group

شاخص های Group برای تعیین مجموعه ای از عناصر مرتبط استفاده می شود.

گروه عناصر

گروه های عنصر با اعلان گروه تعریف شده اند و شما باید عنصر all، choice و sequence را در داخل اعلان گروه تعریف نمایید.
مثال زیر یک گروه را به نام “persongroup” تعریف می کند که یک گروه از عناصر را که باید در یک exact sequence رخ دهد تعریف می نماید:

مثال :

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

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

گروه های Attribute

گروه های Attribute با اعلام attributeGroup تعریف می شوند:

مثال :

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

<xs:attributeGroup name="groupname">

...

</xs:attributeGroup>

مثال زیر یک attribute group به نام “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>

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

پس از اینکه یک attribute group را تعریف کردید، می توانید آن را در یک تعریف دیگر، مانند نمونه زیر به کار برید:

مثال :

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

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

کلام آخر

در این جلسه با آموزش کار با Indicators ها در schema همراهتان بودیم.
در جلسه بعد کار به بر روی عنصر any خواهیم پرداخت.
با پی وی لرن همراه باشید.

QR: جلسه ۸۶ : آموزش کار با Indicators ها در schema

به اشتراک بگذارید

Indicators ها در schema ,آموزش Schema ,آموزش XML ,آموزش کار با Indicators ها در schema

دیدگاه کاربران

تعداد دیدگاه : 0

پی وی لرن – آموزش برنامه نویسی و طراحی وب سایت

دوره های آموزشی آکادمی پی وی لرن (پروژه محور و ویژه بازار کار)

جلسه ۸۶ : آموزش کار با Indicators ها در schema

مقدمه

آموزش کار با Indicators ها در Schema

Indicators شاخص ها

شاخص های Order

شاخص ALL

نکته

شاخص choice

شاخص sequence

شاخص Occurrence

نکته

شاخص maxOccurs

شاخص minOccurs

توصیه

نمونه کار:

شاخص های Group

گروه عناصر

گروه های Attribute

کلام آخر

لیست مطالب دوره

XML AJAX

XML DOM

XPath Tutorial

XSLT Tutorial

XQuery

DTD

مطالب ویژه

دسته های اصلی

برگه ها

بلاگ