Universal Business Language 1.0 Small Business Subset 1.0 - 2005-09-07
================================================================

Copyright (C) OASIS Open (2005). All Rights Reserved.

This document and translations of it may be copied and furnished 
to others, and derivative works that comment on or otherwise 
explain it or assist in its implementation may be prepared, 
copied, published and distributed, in whole or in part, without 
restriction of any kind, provided that the above copyright notice 
and this paragraph are included on all such copies and derivative 
works. However, this document itself may not be modified in any 
way, such as by removing the copyright notice or references to 
OASIS, except as needed for the purpose of developing OASIS 
specifications, in which case the procedures for copyrights 
defined in the OASIS Intellectual Property Rights document must 
be followed, or as required to translate it into languages other 
than English.

The limited permissions granted above are perpetual and will not 
be revoked by OASIS or its successors or assigns.

This document and the information contained herein is provided 
on an "AS IS" basis and OASIS DISCLAIMS ALL WARRANTIES, EXPRESS 
OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE 
USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY 
IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR 
PURPOSE.

================================================================

In an SBS zip there are eight document types and four report files per 
document type (an XML synthesized instance, and HTML, text, XML path
information files) summarizing a list of all possible XPath addresses 
that are valid for instances of each of the document types.

It is not the role of these XPath expressions to change any normative 
specification or schema.  They are merely guidelines for summarizing those 
components of UBL 1.0 that make up UBL-1.0-SBS-1.0 ... instances of the SBS 
profile will validate using official UBL 1.0 W3C schema files, so there is 
no need for a new expression of the UBL schemas.

Users of UBL-1.0-SBS-1.0 can choose to use any expression of constraints 
they wish to express the subset profile as a supplement to the official UBL 
schemas used for position and cardinality of the components of an instance.

The HTML and text XPath files enumerate the XPath addresses and cardinality
for all elements and attributes.  Element paths that have text content do 
not end with a '/' character.  Element paths that are "branches" with only
element content trail with a "/" character, implying the XPath expression
is not complete in order to get a text value.  Element paths ending in "//"
indicate that a loop is detected in which an ancestral element is being
referenced again, which would cause an infinite loop if then traversed.

The XML instance files are well-formed UBL SBS instances with one of 
everything, but are not useful as validated UBL SBS profile examples 
because their forced completeness could never be validated by the models.  
However, many XML-based technologies rely solely on well-formedness and 
not on validity, such as XSLT 1.0, so these XML XPath files can actually 
be run through XSLT 1.0 stylesheets without error.

The XML XPath files contain the raw from which the other files are generated.
Two expressions of constraints are included: a RELAX-NG expression and a W3C
Schema expression.

A sample stylesheet "xpath.xsl" is supplied to illustrate how to traverse
the XML XPath files to create your own summary reports using XSLT.

The namespace prefixes adopted for documentary purposes in these files are 
interpreted as follows (note that there is no obligation to use these 
prefixes in UBL documents):

xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-1.0"
xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-1.0"
xmlns:co="urn:oasis:names:specification:ubl:schema:xsd:OrderChange-1.0"
xmlns:da="urn:oasis:names:specification:ubl:schema:xsd:DespatchAdvice-1.0"
xmlns:in="urn:oasis:names:specification:ubl:schema:xsd:Invoice-1.0"
xmlns:po="urn:oasis:names:specification:ubl:schema:xsd:Order-1.0"
xmlns:ra="urn:oasis:names:specification:ubl:schema:xsd:ReceiptAdvice-1.0"
xmlns:ro="urn:oasis:names:specification:ubl:schema:xsd:OrderResponse-1.0"
xmlns:rs="urn:oasis:names:specification:ubl:schema:xsd:OrderResponseSimple-1.0"
xmlns:xo="urn:oasis:names:specification:ubl:schema:xsd:OrderCancellation-1.0"

This version of these files was constructed by homegrown XSLT and Python/SAX
programs.  When prototyping is complete and these outputs are accepted by
the group, it is anticipated these homegrown scripts will be replaced by
routines of other suppliers and volunteers.

Note there are comments at the start of HTML files regarding troubleshooting
presentation problems of zero-width-space Unicode characters in browsers.

==========================================================================
$Id: readme-sbs-1.0.txt,v 1.1 2005/09/07 10:37:35 G. Ken Holman Exp $