XSD Element Substitution
With XML Schemas, one element can substitute another element.
Element Substitution
Let's say that we have users from two different countries: England and
Norway. We would like the ability to let the user choose whether he or she
would like to use the Norwegian element names or the English element names in
the XML document.
To solve this problem, we could define a substitutionGroup in the XML
schema. First, we declare a head element and then we declare the other elements which state that
they are substitutable for the head element.
<xs:element name="name" type="xs:string"/>
<xs:element name="navn" substitutionGroup="name"/> |
In the example above, the "name" element is the head element and the "navn"
element is substitutable for "name".
Look at this fragment of an XML schema:
<xs:element name="name" type="xs:string"/>
<xs:element name="navn" substitutionGroup="name"/>
<xs:complexType name="custinfo">
<xs:sequence>
<xs:element ref="name"/>
</xs:sequence>
</xs:complexType>
<xs:element name="customer" type="custinfo"/>
<xs:element name="kunde" substitutionGroup="customer"/> |
A valid XML document (according to the schema above) could look like this:
<customer>
<name>John Smith</name>
</customer> |
or like this:
<kunde>
<navn>John Smith</navn>
</kunde> |
Blocking Element Substitution
To prevent other elements from substituting with a specified element, use the block attribute:
| <xs:element name="name" type="xs:string" block="substitution"/> |
Look at this fragment of an XML schema:
<xs:element name="name" type="xs:string" block="substitution"/>
<xs:element name="navn" substitutionGroup="name"/>
<xs:complexType name="custinfo">
<xs:sequence>
<xs:element ref="name"/>
</xs:sequence>
</xs:complexType>
<xs:element name="customer" type="custinfo" block="substitution"/>
<xs:element name="kunde" substitutionGroup="customer"/> |
A valid XML document (according to the schema above) looks like this:
<customer>
<name>John Smith</name>
</customer> |
BUT THIS IS NO LONGER VALID:
<kunde>
<navn>John Smith</navn>
</kunde> |
Using substitutionGroup
The type of the substitutable elements must be the same as, or derived from,
the type of the head element. If the type of the substitutable element is the
same as the type of the head element you will not have to specify the type of
the substitutable element.
Note that all elements in the substitutionGroup (the head element and the
substitutable elements) must be declared as global elements, otherwise it will
not work!
What are Global Elements?
Global elements are elements that are immediate children of the "schema"
element! Local elements are elements nested within other elements.
Need an easy way to get data into XML, or transform XML to another format?
MapForce lets you map XML data to/from any combination of XML, database, flat file, Excel 2007, XBRL, or Web services data.
Then it transforms data instantly or auto-generates royalty-free data integration code for recurrent conversions.
New features in Version 2010!
Download a free, fully functional 30-day trial to experience the following features:
- Easy-to-use, graphical data mapping interface
- Instant data transformation
- XSLT 1.0/2.0 and XQuery code generation
- Java, C#, and C++ code generation
- Advanced data processing functions
- Support for all major relational databases including SQL Server, IBM DB2, Oracle, and more
- Visual Studio & Eclipse integration
Download a fully-functional trial today!
|
|
|
| 
