XML Schema (W3C)

XML Schema (W3C)
Filename extension .xsd
Internet media type application/xml, text/xml
Developed by World Wide Web Consortium
Type of format XML Schema language
Extended from XML
Standard

1.0, Part 1 Structures (Recommendation),
1.0, Part 2 Datatypes (Recommendation),
1.1, Part 1 Structures (Recommendation),

1.1, Part 2 Datatypes (Recommendation)

XSD (XML Schema Definition), a recommendation of the World Wide Web Consortium (W3C), specifies how to formally describe the elements in an Extensible Markup Language (XML) document. It can be used by programmers to verify each piece of item content in a document. They can check if it adheres to the description of the element it is placed in.[1]

Like all XML schema languages, XSD can be used to express a set of rules to which an XML document must conform in order to be considered "valid" according to that schema. However, unlike most other schema languages, XSD was also designed with the intent that determination of a document's validity would produce a collection of information adhering to specific data types. Such a post-validation infoset can be useful in the development of XML document processing software.

History

XML Schema, published as a W3C recommendation in May 2001,[2] is one of several XML schema languages. It was the first separate schema language for XML to achieve Recommendation status by the W3C. Because of confusion between XML Schema as a specific W3C specification, and the use of the same term to describe schema languages in general, some parts of the user community referred to this language as WXS, an initialism for W3C XML Schema, while others referred to it as XSD, an initialism for XML Schema Definition.[3][4] In Version 1.1 the W3C has chosen to adopt XSD as the preferred name, and that is the name used in this article.

In its appendix of references, the XSD specification acknowledges the influence of DTDs and other early XML schema efforts such as DDML, SOX, XML-Data, and XDR. It has adopted features from each of these proposals but is also a compromise among them. Of those languages, XDR and SOX continued to be used and supported for a while after XML Schema was published. A number of Microsoft products supported XDR until the release of MSXML 6.0 (which dropped XDR in favor of XML Schema) in December 2006.[5] Commerce One, Inc. supported its SOX schema language until declaring bankruptcy in late 2004.

The most obvious features offered in XSD that are not available in XML's native Document Type Definitions (DTDs) are namespace awareness and datatypes, that is, the ability to define element and attribute content as containing values such as integers and dates rather than arbitrary text.

The XSD 1.0 specification was originally published in 2001, with a second edition following in 2004 to correct large numbers of errors. XSD 1.1 became a W3C Recommendation in April 2012.

Schemas and schema documents

Technically, a schema is an abstract collection of metadata, consisting of a set of schema components: chiefly element and attribute declarations and complex and simple type definitions. These components are usually created by processing a collection of schema documents, which contain the source language definitions of these components. In popular usage, however, a schema document is often referred to as a schema.

Schema documents are organized by namespace: all the named schema components belong to a target namespace, and the target namespace is a property of the schema document as a whole. A schema document may include other schema documents for the same namespace, and may import schema documents for a different namespace.

When an instance document is validated against a schema (a process known as assessment), the schema to be used for validation can either be supplied as a parameter to the validation engine, or it can be referenced directly from the instance document using two special attributes, xsi:schemaLocation and xsi:noNamespaceSchemaLocation. (The latter mechanism requires the client invoking validation to trust the document sufficiently to know that it is being validated against the correct schema. "xsi" is the conventional prefix for the namespace "http://www.w3.org/2001/XMLSchema-instance".)

XML Schema Documents usually have the filename extension ".xsd". A unique Internet Media Type is not yet registered for XSDs, so "application/xml" or "text/xml" should be used, as per RFC 3023.

Schema components

The main components of a schema are:

Other more specialized components include annotations, assertions, notations, and the schema component which contains information about the schema as a whole.

Types

Complex types describe the permitted content of an element, including its element and text children and its attributes. A complex type definition consists of a set of attribute uses and a content model. Varieties of content model include element-only content, in which no text may appear (other than whitespace, or text enclosed by a child element); simple content, in which text is allowed but child elements are not; empty content, in which neither text nor child elements are allowed; and mixed content, which permits both elements and text to appear. A complex type can be derived from another complex type by restriction (disallowing some elements, attributes, or values that the base type permits) or by extension (allowing additional attributes and elements to appear). In XSD 1.1, a complex type may be constrained by assertions — XPath 2.0 expressions evaluated against the content that must evaluate to true.

Simple types (also called data types) constrain the textual values that may appear in an element or attribute. This is one of the more significant ways in which XML Schema differs from DTDs. For example, an attribute might be constrained to hold only a valid date or a decimal number.

XSD provides a set of 19 primitive data types (anyURI, base64Binary, boolean, date, dateTime, decimal, double, duration, float, hexBinary, gDay, gMonth, gMonthDay, gYear, gYearMonth, NOTATION, QName, string, and time). It allows new data types to be constructed from these primitives by three mechanisms:

Twenty-five derived types are defined within the specification itself, and further derived types can be defined by users in their own schemas.

The mechanisms available for restricting data types include the ability to specify minimum and maximum values, regular expressions, constraints on the length of strings, and constraints on the number of digits in decimal values. XSD 1.1 again adds assertions, the ability to specify an arbitrary constraint by means of an XPath 2.0 expression.

Post-Schema-Validation Infoset

After XML Schema-based validation, it is possible to express an XML document's structure and content in terms of the data model that was implicit during validation. The XML Schema data model includes:

This collection of information is called the Post-Schema-Validation Infoset (PSVI). The PSVI gives a valid XML document its "type" and facilitates treating the document as an object, using object-oriented programming (OOP) paradigms.

<?xml version="1.0" encoding="UTF-8"?>
<Invoice xmlns="rrn:org.xcbl:schemas/xcbl/v3_0/xcbl30.xsd">
  <InvoiceHeader>
    <InvoiceNumber>
      <Reference>
        <RefNum>192872</RefNum>
      </Reference>
    </InvoiceNumber>
    <InvoiceIssueDate>20160516T08:57:32</InvoiceIssueDate>
    <InvoiceReferences>
      <PurchaseOrderReference>
        <PurchaseOrderNumber>
          <Reference>
            <RefNum>3323733</RefNum>
          </Reference>
        </PurchaseOrderNumber>
      </PurchaseOrderReference>
      <DeliveryNoteNumber>
        <Reference>
          <RefNum></RefNum>
        </Reference>
      </DeliveryNoteNumber>
    </InvoiceReferences>
    <InvoicePurpose>
      <InvoicePurposeCoded>Original</InvoicePurposeCoded>
    </InvoicePurpose>
    <InvoiceType>
      <InvoiceTypeCoded>CommercialInvoice</InvoiceTypeCoded>
    </InvoiceType>
    <InvoiceLanguage>
      <Language>
        <LanguageCoded>en</LanguageCoded>
      </Language>
    </InvoiceLanguage>
    <InvoiceParty>
      <BuyerParty>
        <Party>
          <PartyID>
            <Identifier>
              <Agency>
                <AgencyCoded>Other</AgencyCoded>
              </Agency>
              <Ident>ET</Ident>
            </Identifier>
          </PartyID>
          <NameAddress>
            <Name1></Name1>
            <Street></Street>
            <StreetSupplement1></StreetSupplement1>
            <StreetSupplement2></StreetSupplement2>
            <PostalCode></PostalCode>
          </NameAddress>
        </Party>
      </BuyerParty>
      <SellerParty>
        <Party>
          <PartyID>
            <Identifier>
              <Agency>
                <AgencyCoded>Other</AgencyCoded>
              </Agency>
              <Ident>STARRETT</Ident>
            </Identifier>
          </PartyID>
          <NameAddress>
            <Name1>Starrett (NZ) Limited</Name1>
            <Street>PO Box 112347</Street>
            <StreetSupplement1>Penrose</StreetSupplement1>
            <StreetSupplement2>NZ</StreetSupplement2>
            <PostalCode>NZ</PostalCode>
          </NameAddress>
        </Party>
      </SellerParty>
    </InvoiceParty>
  </InvoiceHeader>
  <InvoiceDetail>
    <ListOfInvoiceItemDetail>
      <InvoiceItemDetail>
        <InvoiceBaseItemDetail>
          <LineItemNum>
            <BuyerLineItemNum>1</BuyerLineItemNum>
            <SellerLineItemNum>10</SellerLineItemNum>
          </LineItemNum>
          <ItemIdentifiers>
            <PartNumbers>
              <SellerPartNumber>
                <PartNum>
                  <PartID>D0005</PartID>
                </PartNum>
              </SellerPartNumber>
              <BuyerPartNumber>
                <PartNum>
                  <PartID>93120940</PartID>
                </PartNum>
              </BuyerPartNumber>
            </PartNumbers>
            <ItemDescription>Diamond Tile Drill 5.0mm</ItemDescription>
          </ItemIdentifiers>
          <TotalQuantity>
            <Quantity>
              <QuantityValue>6.00</QuantityValue>
              <UnitOfMeasurement>
                <UOMCoded>Other</UOMCoded>
                <UOMCodedOther></UOMCodedOther>
              </UnitOfMeasurement>
            </Quantity>
          </TotalQuantity>
        </InvoiceBaseItemDetail>
        <InvoicePricingDetail>
          <ListOfPrice>
            <Price>
              <UnitPrice>
                <UnitPriceValue>9.74</UnitPriceValue>
              </UnitPrice>
            </Price>
          </ListOfPrice>
          <InvoiceCurrencyTotalValue>
            <MonetaryValue>
              <MonetaryAmount>58.44</MonetaryAmount>
            </MonetaryValue>
          </InvoiceCurrencyTotalValue>
        </InvoicePricingDetail>
      </InvoiceItemDetail>
      <InvoiceItemDetail>
        <InvoiceBaseItemDetail>
          <LineItemNum>
            <BuyerLineItemNum>2</BuyerLineItemNum>
            <SellerLineItemNum>20</SellerLineItemNum>
          </LineItemNum>
          <ItemIdentifiers>
            <PartNumbers>
              <SellerPartNumber>
                <PartNum>
                  <PartID>KA014CE-E</PartID>
                </PartNum>
              </SellerPartNumber>
              <BuyerPartNumber>
                <PartNum>
                  <PartID>93121920</PartID>
                </PartNum>
              </BuyerPartNumber>
            </PartNumbers>
            <ItemDescription>Pilot drill 90mm long suits all Starrett Arbors</ItemDescription>
          </ItemIdentifiers>
          <TotalQuantity>
            <Quantity>
              <QuantityValue>9.00</QuantityValue>
              <UnitOfMeasurement>
                <UOMCoded>Other</UOMCoded>
                <UOMCodedOther></UOMCodedOther>
              </UnitOfMeasurement>
            </Quantity>
          </TotalQuantity>
        </InvoiceBaseItemDetail>
        <InvoicePricingDetail>
          <ListOfPrice>
            <Price>
              <UnitPrice>
                <UnitPriceValue>5.81</UnitPriceValue>
              </UnitPrice>
            </Price>
          </ListOfPrice>
          <InvoiceCurrencyTotalValue>
            <MonetaryValue>
              <MonetaryAmount>52.29</MonetaryAmount>
            </MonetaryValue>
          </InvoiceCurrencyTotalValue>
        </InvoicePricingDetail>
      </InvoiceItemDetail>
      <InvoiceItemDetail>
        <InvoiceBaseItemDetail>
          <LineItemNum>
            <BuyerLineItemNum>3</BuyerLineItemNum>
            <SellerLineItemNum>30</SellerLineItemNum>
          </LineItemNum>
          <ItemIdentifiers>
            <PartNumbers>
              <SellerPartNumber>
                <PartNum>
                  <PartID>MPH0614</PartID>
                </PartNum>
              </SellerPartNumber>
              <BuyerPartNumber>
                <PartNum>
                  <PartID>93123840</PartID>
                </PartNum>
              </BuyerPartNumber>
            </PartNumbers>
            <ItemDescription>TCT Fast Cut Hole Saw 159mm</ItemDescription>
          </ItemIdentifiers>
          <TotalQuantity>
            <Quantity>
              <QuantityValue>2.00</QuantityValue>
              <UnitOfMeasurement>
                <UOMCoded>Other</UOMCoded>
                <UOMCodedOther></UOMCodedOther>
              </UnitOfMeasurement>
            </Quantity>
          </TotalQuantity>
        </InvoiceBaseItemDetail>
        <InvoicePricingDetail>
          <ListOfPrice>
            <Price>
              <UnitPrice>
                <UnitPriceValue>51.93</UnitPriceValue>
              </UnitPrice>
            </Price>
          </ListOfPrice>
          <InvoiceCurrencyTotalValue>
            <MonetaryValue>
              <MonetaryAmount>103.86</MonetaryAmount>
            </MonetaryValue>
          </InvoiceCurrencyTotalValue>
        </InvoicePricingDetail>
      </InvoiceItemDetail>
    </ListOfInvoiceItemDetail>
  </InvoiceDetail>
  <InvoiceSummary>
    <NumberOfLines>3</NumberOfLines>
    <InvoiceTotals>
      <NetValue>
        <MonetaryValue>
          <MonetaryAmount>214.59</MonetaryAmount>
        </MonetaryValue>
      </NetValue>
      <GrossValue>
        <MonetaryValue>
          <MonetaryAmount>246.78</MonetaryAmount>
        </MonetaryValue>
      </GrossValue>
      <TaxValue>
        <MonetaryValue>
          <MonetaryAmount>32.19</MonetaryAmount>
        </MonetaryValue>
      </TaxValue>
    </InvoiceTotals>
  </InvoiceSummary>
</Invoice>

Secondary uses for XML Schemas

The primary reason for defining an XML schema is to formally describe an XML document; however the resulting schema has a number of other uses that go beyond simple validation.

Code generation

The schema can be used to generate code, referred to as XML Data Binding. This code allows contents of XML documents to be treated as objects within the programming environment.

Generation of XML file structure documentation

The schema can be used to generate human-readable documentation of an XML file structure; this is especially useful where the authors have made use of the annotation elements. No formal standard exists for documentation generation, but a number of tools are available, such as the Xs3p stylesheet, that will produce high quality readable HTML and printed material.

Criticism

Although XML Schema is successful in that it has been widely adopted and largely achieves what it set out to, it has been the subject of a great deal of severe criticism, perhaps more so than any other W3C Recommendation. Good summaries of the criticisms are provided by James Clark,[6] Anders Møller and Michael Schwartzbach,[7] Rick Jelliffe[8] and David Webber.[9]

General problems:

Practical limitations of expressibility:

Technical problems:

Version 1.1

XSD 1.1 became a W3C Recommendation in April 2012, which means it is an approved W3C specification.

Significant new features in XSD 1.1 are:

Until the Proposed Recommendation draft, XSD 1.1 also proposed the addition of a new numeric data type, precisionDecimal. This proved controversial, and was therefore dropped from the specification at a late stage of development.

See also

Further reading

References

Wikibooks has a book on the topic of: XML Schema

W3C XML Schema 1.0 Specification

W3C XML Schema 1.1 Specification

Other


This article is issued from Wikipedia - version of the 11/8/2016. The text is available under the Creative Commons Attribution/Share Alike but additional terms may apply for the media files.