Sanity check: UBL 2.1 PRD1 release candidate

[Jon Bosak <bosak@pinax.com>]

Hello UBL TC,

I promised you a 2.1 PRD1 release candidate today, and here it is:

http://www.oasis-open.org/committees/download.php/39273/UBL-2.1-PRD1-20100909.zip

I'd like to consider this a sanity check, but a possible schema
issue has turned up.

Naming and Design Rules ELD12, ELD13, and ELD14 (see page 122 of
UBL-2.1.pdf) read as follows:

    ELD12

       The UBL Extensions element MUST be declared as the first
       child of the document element with xsd:minOccurs="0".

    ELD13

       The UBLProfileID element MUST be declared immediately
       following the UBL Extensions element with xsd:minOccurs="0".

    ELD14

       The UBLSubsetID element MUST be declared immediately
       following the UBLProfileID element with xsd:minOccurs="0".

VER15 is relevant, too:

    VER15

       Every UBL document schema MUST declare an optional element
       named UBLVersionID immediately following the optional UBL
       Extensions element.

Ken Holman has pointed out that Naming and Design Rule ELD14
should refer to CustomizationID, not UBLSubsetID.  But it looks
like there's another problem here as well.  ELD13 says that
UBLExtensions must be immediately followed by UBLProfileID, but
VER15 says that UBLExtensions (ignore the extra space for now, we
can fix that) must be immediately followed by UBLVersionID.

Here's a fragment of the declarations from an xsdrt file chosen at
random (DespatchAdvice, as it happens):

    <xsd:element maxOccurs="1" minOccurs="0" ref="ext:UBLExtensions"/>
    <xsd:element maxOccurs="1" minOccurs="0" ref="cbc:UBLVersionID"/>
    <xsd:element maxOccurs="1" minOccurs="0" ref="cbc:CustomizationID"/>
    <xsd:element maxOccurs="1" minOccurs="0" ref="cbc:ProfileID"/>
    <xsd:element maxOccurs="1" minOccurs="0" ref="cbc:ProfileExecutionID"/>

Is the order shown in the snippet above correct?  (I think it is.)
If so, then there are a couple of issues here for resolution by
the NDR editors in PRD2, and they can join some other less
important NDR issues that need to be dealt with as well.  If the
order shown above is not correct, then we have a schema problem
that must be resolved before we can release PRD1.

There are two actions here for the TC:

  - Please confirm that the order shown in the sample above is
    correct and that the problems we've identified are to be
    resolved by editing the NDRs.

  - Please unpack and review the release candidate linked above.
    You have about 48 hours to let me know whether you see any
    showstoppers before I ask for a default ballot on moving this
    to public review.

Jon

##################################################################

Changes to the UBL 2.1 documentation since the last version was
posted to the TC:

Replaced chapter 5 with a new version dated 28 August from GKH.

Replaced art/UBL-2.1-SchemaDependencies.png and
art/UBL-2.1-SpreadsheetRealization.png with new versions from GKH.

Corrected HTML rendition of code literal (increased font size).

Changed version URIs to the following:

    This Version:
      http://docs.oasis-open.org/ubl/prd1-UBL-2.1/UBL.html
      http://docs.oasis-open.org/ubl/prd1-UBL-2.1/UBL.pdf
      http://docs.oasis-open.org/ubl/prd1-UBL-2.1/UBL.xml (Authoritative)
    Previous Version:
      http://docs.oasis-open.org/ubl/os-UBL-2.0/UBL-2.0.html
      http://docs.oasis-open.org/ubl/os-UBL-2.0/UBL-2.0.pdf
      http://docs.oasis-open.org/ubl/os-UBL-2.0/UBL-2.0.xml
    Latest Version:
      http://docs.oasis-open.org/ubl/UBL/UBL.html
      http://docs.oasis-open.org/ubl/UBL/UBL.pdf
      http://docs.oasis-open.org/ubl/UBL/UBL.xml (Authoritative)

Removed references to uml directory and class diagrams.

Removed entry in 1.1.1 for "Class diagram", because there are no
class diagrams.  (We will have to restore this in PRD2.)

Removed entry in 1.1.1 for "Spreadsheet model", because that term
is not used in the text.  Moved content of this definition to
"Assembly model".

Removed entry in 1.1.1 for "Context," because the definition
doesn't add anything.

Corrected wrong version of graphic for figure C.2.

Changed

    The default code list values assumed by the UBL 2.1
    specification are included in a file named
    <code>UBL-2.1-DefaultDTQ.xsl</code> located in the
    <code>val</code> directory, as described in more detail below.

    to

    The default code list values assumed by the UBL 2.1
    specification are expressed as data type qualifications in a
    file named <code>UBL-2.1-DefaultDTQ.xsl</code> located in the
    <code>val</code> directory, as described in more detail below.

Revised language under "UBL 2.1 document models" to clarify the
role of eDoCreator.

Unzipped Crane reports (Crane-UBL21Reports-EN-20100830-2100z.zip)
into the mod directory and referenced them from the text.  Built
conversion scripts to shorten and regularize the file names.

Created a new directory "rnc" and copied
Crane-UBL-rnc-20100830-2050z.zip into it.

Replaced the former ASN.1 appendix with a new appendix titled
"Alternative Representations of the UBL 2.1 Schemas" having two
sections, one for ASN.1 and one for RELAX NG.

Added reference to new chapter 5 and revised dependency figure in
section "Extension Content Schemas".

Revised section on UBL Data Model; added the EA project file to
the package and added a reference to the UBL classes in the EA
project file.

Edited new Chapter 5.

Made several minor wording edits as suggested by GKH.

In appendix D, added a table of UBL unqualified data types (table
D.2, provided by GKH) to accompany the table of CCTS unqualified
data types.

Section 3.2.2 CCTS_CCT_SchemaModule: included edit from GKH.

Section 3.2.2 UnqualifiedDataTypes: included edit from GKH.

Section 3.2.2 QualifiedDataTypes: included edit from GKH.

Section 3.2.4 ExtensionContentDatatype: changed to
ExtensionContentDataType (capital "T") plus other edits from GKH.

Added new section 3.2.5 "Signature Extension Schemas" per GKH.

Section 3.3: Added para from GKH following the diagram.

Added acknowledgements for SRDC, OSS Nokalva, and Crane
Softwrights.

Added exception for materials used by permission to the OASIS
copyright notice.