Request a first public review for Business Document Naming and Design Rules Version 1.1

Submitted on Wednesday, January 11, 2017 - 19:35
Submitted by user:
Submitted values are:

Your name: G. Ken Holman
TC name: Universal Business Language
TC email address: ubl@lists.oasis-open.org
This ticket requests: Publish Committee Draft and release for public review
Title: Business Document Naming and Design Rules Version 1.1
Approval link: https://lists.oasis-open.org/archives/ubl/201701/msg00010.html
Abstract: This specification prescribes a set of naming and design rules used
to
create document model validation artefacts associated with abstract
information
bundles formally described using the Core Component Technical Specification
2.01
[CCTS] in either or both of XML documents using W3C Schema XSD files and
OASIS
Context/value association files, or/and JSON documents using
http://json-schema.org expressions.
Notification list:
Anders Grangard <anders.grangard@gs1.org>
Lance Thompson <lance.thompson@conex.net>

(and others hopefully to follow before publishing)

Notes:
The two work products "Business Document Naming and Design Rules Version 1.1"
(a
specification of new rules) and "UBL 2.1 JSON Alternative Representation
Version
1.0" (an implementation of the new rules) are meant to be put out to public
review together so that reviewers have both the specification and note in
hand
without missing the other.

The note has a cross reference to the specification (but not the other way
around).

The public review text for the specification is at:

https://www.oasis-open.org/committees/document.php?document_id=59776

The public review text for the note is at:

https://www.oasis-open.org/committees/document.php?document_id=59775

The following paragraphs could be considered for use in the public review
announcements:

An important and powerful method to design interoperable business documents
is
to construct logical semantic models using concepts described in the
UN/CEFACT
Core Components Technical Specification (CCTS) Version 2.01. From these
semantic models one can create physical syntax models with which to express
the
content constraints of actual business documents to be interchanged.

The OASIS Business Document Naming and Design Rules (BDNDR) Version 1.1 Draft
Specification prescribes a set of naming and design rules used to create
complete CCTS models of interoperable business documents. It also includes
the
rules needed to create validation artefacts corresponding to them. For XML
syntax, the rules govern creating W3C Schema (XSD) and OASIS Context/value
Association (CVA) validation artefacts. For JSON syntax, the rules govern
creating JSON Schema validation artefacts.

JSON is the JavaScript Object Notation described by ISO/IEC 21778 Information
technology — The JSON data interchange format, initially published at
https://www.ecma-international.org/publications/standards/Ecma-404.htm as
ECMA
404 The JSON data interchange format. JSON Schema is the vocabulary
described
at http://json-schema.org for annotating and validating JSON documents.

BDNDR Version 1.1 changes no rules for XML syntax from BDNDR Version 1.0 and
only adds the new rules prescribed for JSON syntax.

The UBL 2.1 JSON Alternative Representation Version 1.0 Draft Note engages
the
JSON rules from BDNDR and publishes the CCTS models of UBL 2.1 as
json-schema.org validation artefacts. Also included in the package is a
transliteration into JSON syntax of each of the UBL 2.1 sample XML instances,
all of which validate with the provided JSON schemas.

These two work products are being published simultaneously for reviewers to
work
with a complete implementation of the proposed new rules for JSON
serialization
of CCTS document models. The OASIS UBL TC welcomes formal feedback of this
new
approach to working with JSON syntax. Please use the
https://www.oasis-open.org/committees/comments/index.php?wg_abbrev=ubl
comment
list to do so.

The results of this submission may be viewed at:
http://tools.oasis-open.org/issues/browse/TCADMIN