[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Agreed Schema Changes
Folks / David Please find below a list of agreed changes to Schema generation in the first of two Schema development stages towards UBL 1.1. Sylvia Webb will shortly send an abbreviated list of actual change tasks but the following / attached give the decisions made on which such changes will be based. Many thanks Stephen Green
Agreed First Specification of Schema Changes Required for UBL Version 1.1 (10th March 2005)
--------------------------------------------------------------------------------------------
There are still some matters concerning the following rules which
remain undecided but there seems to be sufficient decided in the
following to allow some Schema generator work to begin.
A second phase of development will be needed to support further
design agreements (including codelist decisions).
The following changes were agreed in the Atlantic TC call on March 9.
A summary list of actual change details is to be provided shortly to
supplement this list.
CHANGE REQUIREMENTS (10th March 2005)
Schema changes required by NDR version 1.1 work in McLean Feb 2005
(note that this list excludes for the timebeing a possible further set
of codelist Schema change requirements):
C1. Changes to Rule DOC8 now states the following:
"The xsd:documentation element for every Supplementary Component
attribute declarationType MUST contain a structured set of annotations in the
following sequence and pattern:
• Name (mandatory): Name in the Registry of a Supplementary Component of
a Core Component Type.
• Definition (mandatory): A clear, unambiguous and complete explanation of
the meaning of a Supplementary Component and its revlevance for the related
Core Component Type.
• Primitive type (mandatory): PrimitiveType to be used for the representation
of the value of a Supplementary Component.
• Possible Value(s) (optional): one possible value of a Supplementary
Component."
Please add xsd:documentation to every Supplementary Component attribute
where it is declared in the common Schemas (CCT, UDT and SDT) and codelist
Schemas.
The last clause of the rule is yet to be discussed sufficiently and is excepted
from this round of Schema generator development.
C2. The rule DOC9 is yet to be discussed sufficiently and is excepted from
this round of Schema generator development.
C3. New Rule CTD20 states:
"For every property identified in the UBL model a named XSD:ComplexType
must be defined"
It is agreed that this rule should be implemented in this round of Schema
generation.
C4. VER8 and VER9 implementation: To be decided.
The following change has been agreed apart from the ordering
of Schema imports and there remains disagreement about how much
the ordering of XSD attribute-related should be specified.
Additions may be made later to comply with VER8 and VER9
(derivation) requirements.
Conformance to this rule is requested for this round of Schema
generation development.
C5. 1.1 Schema layout required by the currently amended rule GSX1
with added agreements/comments in square brackets and
with a), b), etc denoting subsections for clarity
[GXS1]
UBL Schema MUST conform to the following physical layout as applicable:
a)
XML Declaration
i.e. <?xml version="1.0" encoding="UTF-8"?>
b)
Schemas should include comment section separator.
<!-- ===== Copyright Notice ===== -->
c)
Required OASIS full copyright notice.
"Copyright ? 2001-2004 The Organization for the Advancement of Structured
Information Standards (OASIS). All rights reserved.
Copyright text should be taken verbatim from OASIS:
http://www.oasis-open.org/who/ipr/intellectual_property_2000-1-13.php
section OASIS.IPR.4.Notices, subsections (A), (B), (C), and,
when applicable, subsection (D).
(This is a new ipr policy for OASIS and takes effect on 15 April 2005.)
d)
In addition, the following fields should be included in the header comment,
below the copyright:
OASIS Open (http://www.oasis-open.org/)
Universal Business Language Specification
(http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=ubl)
Document Name: <insert document name w/o suffix>
Generated On: <insert date with timestamp>
e)
They should be clearly separated from the copyright notice.
A single dashed line should be used as the separator.
f)
<!-- ===== xsd:schema Element With Namespaces Declarations ===== -->
Schemas need to be updated to include this comment line.
g)
xsd:schema element to include version attribute and namespace declarations in
the following order:
xmlns:xsd
[Schemas already conform with above line.]
Target namespace
Default namespace
CommonAggregateComponents
CommonBasicComponents
CoreComponentTypes
Unspecialized Datatypes
Specialized Datatypes
Identifier Schemes
Code Lists
[Schemas currently don't conform to this order.
Order needs review for technical issues, but otherwise is fine as in rule.
Schemas need to be updated to conform to this order (unless technical
reason for altering the order).]
[NOTE: Not all schemas need to include all the following declarations.
'As applicable', in the opening sentence
of the rule, means these can be present or not present, as needed, as long
as they are in this order. This applies to several of the following cases]
h)
Attribute Declarations:
elementFormDefault="qualified"
attributeFormDefault="unqualified"
[schemas currently conform to the two lines above.]
i)
<!-- ===== Imports ===== -->
[Schemas do not have this comment line.
Add this to schemas (unless there are no imports)]
j)
CommonAggregateComponents schema module
CommonBasicComponents schema module
Unspecialized Types schema module
Specialized Types schema module
[Schemas don't currently conform to this order.
Change schemas to conform to this order unless
technically problematic or non-standard. Some
have added that the order is only important
for the sake of specification of some order
and note that there is no other technical
requirement to adhere to any particular order so
if for some technical reason the order cannot
be maintained in generation that is understood.]
k)
[There will be further discussion later about specifying
in the Rule the following which are currently already included
by the Schema generator
- any codelist schemas
- cc parameters schema]
l)
<!-- ===== Global Attributes ===== -->
Global Attributes and Attribute Groups
[The Schemas already conform to this.
Add global attribute or attribute groups here,
and add comment section separator when they are present.]
m)
<!-- ===== Root Element ===== -->
Root Element Declaration
Root Element Type Definition
[This is how it is now in schemas,
but schemas need to add comment section separator.]
n)
<!-- ===== Element Declarations ===== -->
alphabetized order
[This is how it is now in schemas,
but schemas need to add comment section separator.]
[Further discussion will consider the following additions to the rule
about setting the alphabetical order: ignore case
(i.e., fold case), and ignore the xsd-related suffix "type" when
it's there purely for xsd reasons.]
o)
<!-- ===== Type Definitions ===== -->
All type definitions segregated by basic and aggregates as follows
[Schemas should add comment section separator.]
p)
<!-- ===== Aggregate Business Information Entity Type Definitions ===== -->
alphabetized order of AggregateBusinessInformationEntity TypeDefinitions
[Schemas should include comment section separator if section has content.]
q)
<!-- =====Basic Business Information Entity Type Definitions ===== -->
alphabetized order of BasicBusinessInformationEntities
[Schemas should include comment section separator if section has content.]
[Note: there still needs to be review of the Parameters (CCTS) Schema and
the above may need revision for codelist Schemas depending on the outcome
of codelist Schema design decisions. Further changes may be required later to
conform to VER8 and VER9 too.]
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]