ホーム HTML CSS XML JAVASCRIPT   PHP SQL MORE...   リファレンス 事例集    

XSD インジケータ

« 前章へ 次章へ »

インジケータにより、文書で要素をどのように使用するかをコントロールできます。

インジケータ

7つのインジケータがあります:

順序インジケータ:

  • All
  • Choice
  • Sequence

発生インジケータ:

  • maxOccurs
  • minOccurs

グループインジケータ:

  • Group name
  • attributeGroup name

順序インジケータ

順序インジケータは、要素の順序を定義するのに使用します。

All インジケータ

<all> インジケータは、子要素が順不同に現れることができ、 且つ、各子要素は一度だけ発生しなければならないことを指定します:

<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>インジケータには 0 または 1、 <maxOccurs> インジケータには 1 だけが設定できます （<minOccurs> と <maxOccurs>は、後で説明します）。

Choice インジケータ

<choice> インジケータは、1つの子要素または他のものが発生する可能性があることを指定します:

<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> インジケータは、子要素が指定の順序で出現する必要のあることを指定します:

<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 インジケータ

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>

上記例は、"child_name" 要素が、"person" 要素に最小 1 回（minOccurs のデフォルト値は 1 です）、 最大 10 回発生する可能性があることを示しています。

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>

上記例は、"child_name" 要素が "person" 要素に、最小 0 回、最大 10 回 発生する可能性があることを示しています。

チップ: 要素を、何回でも無制限に発生できるようにするには、 maxOccurs=""unbounded" ステートメントを使用します:

作業例:

"Myfamily.xml" というXMLファイル:

<?xml version="1.0" encoding="ISO-8859-1"?>

<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 ファイルには、"persons" という名前のルート要素が含まれています。 このルート要素内に、3つの "person" 要素を定義してます。 各 "person" の要素は、"full_name" 要素を含まなければならず、 それには 5 つまでの "child_name" 要素を含めることができます。

ここに、スキーマファイル "family.xsd" があります:

<?xml version="1.0" encoding="ISO-8859-1"?>
<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 宣言によって定義されます:

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

group 宣言内の all, choice, または sequence 要素を定義する必要があります。 次の例では、正確な順序で発生しなければならない要素のグループを定義する "persongroup"、 という名前の 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>

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>

属性グループ

属性グループは、次のように attributeGroup の宣言で定義します:

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

次の例は、"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>

<xs:element name="person">
  <xs:complexType>
    <xs:attributeGroup ref="personattrgroup"/>
  </xs:complexType>
</xs:element>

« 前章へ 次章へ »