Uploaded image for project: 'Technical Committee Administration'
  1. Technical Committee Administration
  2. TCADMIN-2534

Request a first public review for UBL 2.1 JSON Alternative Representation Version 1.0

    Details

      Description

      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: UBL 2.1 JSON Alternative Representation Version 1.0
      Approval link: https://lists.oasis-open.org/archives/ubl/201701/msg00010.html
      Abstract: This committee note supplements the OASIS Universal Business
      Language
      version 2.1 release with an alternative expression of the UBL sample XML
      documents in JSON syntax, and a JSON schema expression of all 65 XSD schemas
      in
      conformance to the OASIS Business Document Naming and Design Rules Version
      1.1.
      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

        Attachments

          Activity

            People

            • Assignee:
              chet-oasis Chet Ensign
              Reporter:
              gkholman Ken Holman
            • Watchers:
              3 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: