complexType "stipulation_type"

Namespace:	http://www.sci.fi/~stniekat/pccc/2007/Problem/1/0
Content:	complex, 4 attributes, 3 elements
Defined:	globally in problem.xsd, see XML source
Includes:	definitions of 4 attributes and 3 elements
Used:	at 1 location

XML Representation Summary

<...

atmove

("white" | "black")

order

("alternating" | "incremental") : "alternating"

play

structure

xs:string

Content:

length?, (endstate | stipulation)

</...>

Content Elements (3):

endstate, length, stipulation

All Direct / Indirect Based Elements (1):

stipulation

Known Usage Locations

As direct type of elements (1):
stipulation

Annotation

An element of type stipulation_type defines the stipulation of a twin.
The stipulation is specified by two main characteristics:

the state to be reached
how the state is to be reached

Stipulations can be recursive, i.e. a stipulation can be defined to be fulfilled if another stipulation can be fulfilled after the required sequence of moves; in that case, the state to be reached is defined by a nested stipulation_type element.
The end of the recursion is reached if a stipulation element has an endstate child element.

Examples:

#3
<stipulation> <length type="maximum" value="3"/> <endstate type="mate"/> </stipulation>
1w -> ser-h#5
<stipulation atmove="white" play="series"> <length type="exact" value="1"/> <stipulation atmove="black" play="series"> <length type="maximum" value="4"/> <stipulation play="help"> <length type="maximum" value="2"/> <endstate type="mate"/> </stipulation> </stipulation> </stipulation>

XML Source (w/o annotations (8); see schema source)

<xs:complexType name="stipulation_type">

<xs:sequence>

<xs:element maxOccurs="1" minOccurs="0" ref="length">

</xs:element>

<xs:choice>

<xs:element ref="endstate">

</xs:element>

<xs:element ref="stipulation">

</xs:element>

</xs:choice>

</xs:sequence>

<xs:attribute default="alternating" name="order" use="optional">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:enumeration value="alternating"/>

<xs:enumeration value="incremental"/>

</xs:restriction>

</xs:simpleType>

</xs:attribute>

<xs:attribute default="direct" name="play" use="optional">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:enumeration value="direct"/>

<xs:enumeration value="help"/>

<xs:enumeration value="self"/>

<xs:enumeration value="reflex"/>

<xs:enumeration value="semireflex"/>

<xs:enumeration value="series"/>

</xs:restriction>

</xs:simpleType>

</xs:attribute>

<xs:attribute name="atmove" use="optional">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:enumeration value="white"/>

<xs:enumeration value="black"/>

</xs:restriction>

</xs:simpleType>

</xs:attribute>

<xs:attribute name="structure" type="xs:string" use="optional">

</xs:attribute>

</xs:complexType>

Attribute Detail

atmove

If present, the atmove attribute specifies is initially at the move.
In most stipulations, this information can be derived from the other attributes; in that case, the atmove attribute need not be given.
The atmove attribute is required in series play stipulations.

Type:	embedded
Use:	optional
Defined:	locally, within (this) stipulation_type complexType

XML Source (w/o annotations (1); see schema source)

<xs:attribute name="atmove" use="optional">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:enumeration value="white"/>

<xs:enumeration value="black"/>

</xs:restriction>

</xs:simpleType>

</xs:attribute>

Embedded Type

Derivation:

restriction of xs:string

The order attribute specifies the order in which both sides play their moves.
The following orders are allowed:

alternating both sides alternatively play one move.
incremental The side at the move plays 1 move, then the other side plays 2 moves etc.

Type:	embedded
Use:	optional
Default:	"alternating"
Defined:	locally, within (this) stipulation_type complexType

XML Source (w/o annotations (1); see schema source)

<xs:attribute default="alternating" name="order" use="optional">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:enumeration value="alternating"/>

<xs:enumeration value="incremental"/>

</xs:restriction>

</xs:simpleType>

</xs:attribute>

Embedded Type

Derivation:

restriction of xs:string

Facets:

enumeration:

"alternating", "incremental"

play

The play attribute specifies the type of play required by the stipulation
The following types of play are allowed:

direct
help
self
reflex
semireflex
series

Type:	embedded
Use:	optional
Default:	"direct"
Defined:	locally, within (this) stipulation_type complexType

XML Source (w/o annotations (1); see schema source)

<xs:attribute default="direct" name="play" use="optional">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:enumeration value="direct"/>

<xs:enumeration value="help"/>

<xs:enumeration value="self"/>

<xs:enumeration value="reflex"/>

<xs:enumeration value="semireflex"/>

<xs:enumeration value="series"/>

</xs:restriction>

</xs:simpleType>

</xs:attribute>

Embedded Type

Derivation:

restriction of xs:string

Facets:

enumeration:

"direct", "help", "self", "reflex", "semireflex", "series"

structure

If present, the structure attribute specifies the solution structure.
The structure attribute is typically only present in help play stipulations. It is an informal text.
Example:
2.1;1.1

Type:	xs:string
Use:	optional
Defined:	locally, within (this) stipulation_type complexType

XML Source (w/o annotations (1); see schema source)

<xs:attribute name="structure" type="xs:string" use="optional">

</xs:attribute>

Content Element Detail

endstate

If present, the endstate child element specifies that this stipulation is not recursive and identifies the state to be reached for it to be fulfilled.

Type:	endstate_type, empty content
Defined:	by reference, within (this) stipulation_type complexType

XML Source (w/o annotations (1); see schema source)

<xs:element ref="endstate">

</xs:element>

length

The length element defines the number of moves to be played to reach the end state.

Type:	length_type, empty content
Defined:	by reference, within (this) stipulation_type complexType

XML Source (w/o annotations (1); see schema source)

<xs:element maxOccurs="1" minOccurs="0" ref="length">

</xs:element>

stipulation

If present, the stipulation child element specifies the end state of this stipulation to be another stipulation and the requirements of that stipulation.

Type:	complex content
Defined:	by reference, within (this) stipulation_type complexType

XML Source (w/o annotations (1); see schema source)

<xs:element ref="stipulation">

</xs:element>

XML Schema documentation generated with DocFlex/XML (Kit) v1.6.6

DocFlex/XML (Kit) is a freeware edition of DocFlex/XML, which is a powerful template-driven documentation and report generator from any data stored in XML files. Based on an innovative technology developed by FILIGRIS WORKS, this new tool offers virtuoso data querying and formatting capabilities not found in anything else!

Need to convert your XML data into a clear nice-looking documentation or reports? Web-ready hypertext HTML or printable MS Word / OpenOffice.org friendly RTF? DocFlex/XML may be a cheap, quick and effective solution exactly for this task!

Have questions? Not sure how to use it? Just send us e-mail to contact@filigris.com and we are always happy to help you! See also our services at www.filigris.com