OASIS Universal Business Language (UBL) TC

 View Only
  • 1.  Invitation to comment on Universal Business Language v2.3 from the UBL TC - ends September 2nd

    Posted 08-19-2020 02:55
    OASIS Members and other interested parties, We are pleased to announce that Universal Business Language Version 2.3 from the UBL TC [1] is now available for public review and comment. This is the third public review for Universal Business Language v2.3. UBL is the leading interchange format for business documents. It is designed to operate within a standard business framework such as ISO/IEC 15000 (ebXML) to provide a complete, standards-based infrastructure that can extend the benefits of existing EDI systems to businesses of all sizes. The European Commission has declared UBL officially eligible for referencing in tenders from public administrations, and in 2015 UBL was approved as ISO/IEC 19845:2015. Specifically, UBL provides: - A suite of structured business objects and their associated semantics expressed as reusable data components and common business documents. - A library of schemas for reusable data components such as Address, Item, and Payment, the common data elements of everyday business documents. - A set of schemas for common business documents such as Order, Despatch Advice, and Invoice that are constructed from the UBL library components and can be used in generic procurement and transportation contexts. UBL v2.3 is a minor revision to v2.2 that preserves backwards compatibility with previous v2.# versions. It adds five new document types, bringing the total number of UBL business documents to 86. The specification documents and related files are available here: Universal Business Language Version 2.3 Committee Specification Draft 03 29 July 2020 Editable source (Authoritative): https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.xml HTML: https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.html PDF: https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.pdf Code lists for constraint validation: https://docs.oasis-open.org/ubl/csd03-UBL-2.3/cl/ Context/value Association files for constraint validation: https://docs.oasis-open.org/ubl/csd03-UBL-2.3/cva/ Document models of information bundles: https://docs.oasis-open.org/ubl/csd03-UBL-2.3/mod/ Default validation test environment: https://docs.oasis-open.org/ubl/csd03-UBL-2.3/val/ XML examples: https://docs.oasis-open.org/ubl/csd03-UBL-2.3/xml/ Annotated XSD schemas: https://docs.oasis-open.org/ubl/csd03-UBL-2.3/xsd/ Runtime XSD schemas: https://docs.oasis-open.org/ubl/csd03-UBL-2.3/xsdrt/ For your convenience, OASIS provides a complete package of the prose specification and related files in a ZIP distribution file. You can download the ZIP file at: https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.zip How to Provide Feedback OASIS and the UBL TC value your feedback. We solicit feedback from potential users, developers and others, whether OASIS members or not, for the sake of improving the interoperability and quality of its technical work. This public review starts 19 August 2020 at 00:00 UTC and ends 02 September 2020 at 11:59 UTC. This specification was previously submitted for public review [2]. This 15-day review may be limited in scope to changes made from the previous review. Changes are described in the previous comment resolution log [2] and highlighted in a red-lined file included in the package [3]. Comments may be submitted to the TC by any person through the use of the OASIS TC Comment Facility which can be used by following the instructions on the TC's "Send A Comment" page ( https://www.oasis-open.org/committees/comments/index.php?wg_abbrev=ubl ). Feedback submitted by TC non-members for this work and for other work of this TC is publicly archived and can be viewed at: https://lists.oasis-open.org/archives/ubl-comment/ All comments submitted to OASIS are subject to the OASIS Feedback License, which ensures that the feedback you provide carries the same obligations at least as the obligations of the TC members. In connection with the public review of this work, we call your attention to the OASIS IPR Policy [4] applicable especially [5] to the work of this technical committee. All members of the TC should be familiar with this document, which may create obligations regarding the disclosure and availability of a member's patent, copyright, trademark and license rights that read on an approved OASIS specification. OASIS invites any persons who know of any such claims to disclose these if they may be essential to the implementation of the above specification, so that notice of them may be posted to the notice page for this TC's work. Additional information about this specification and the UBL TC may be found on the TC's public home page [1]. ========== Additional references: [1] OASIS Universal Business Language (UBL) TC https://www.oasis-open.org/committees/ubl/ [2] ÂPrevious public reviews and comment resolution logs: - Please see the "Timeline Summary" in the public review metadata document at: https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3-csd03-public-review-metadata.html [3] Red-lined version: https://docs.oasis-open.org/ubl/csd03-UBL-2.3/csd03-UBL-2.3-DIFF.pdf [4] https://www.oasis-open.org/policies-guidelines/ipr [5] https://www.oasis-open.org/committees/ubl/ipr.php https://www.oasis-open.org/policies-guidelines/ipr#RF-on-Limited-Mode RF on Limited Terms Mode -- Paul Knight ... . Document Process Analyst OASIS - Advancing open standards for the information society


  • 2.  Re: [ubl-comment] Invitation to comment on Universal Business Language v2.3 from the UBL TC - ends September 2nd

    Posted 08-20-2020 10:01
    There are still problems with the examples. Two of them will not load with schema
    validation.

    1) UBL-GoodsCertificate-2.3-Example.xml

    lineNumber: 299; columnNumber: 29; cvc-complex-type.2.4.a: Invalid content was found
    starting with element
    '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":Acceptance
    Indicator}'. One of
    '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":Description
    , "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":Note,
    "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":Validity
    Period,
    "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":IssuerP
    arty}' is expected.

    2) UBL-GoodsItemPassport-2.3-ExampleIssued.xml

    lineNumber: 6; columnNumber: 18; cvc-complex-type.2.4.a: Invalid content was found
    starting with element
    '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":StatusCode
    }'. One of
    '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":IssueTime,
    "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":Note,
    "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":VersionID,
    "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":ExportReaso
    nCode,
    "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":ExportReaso
    n,
    "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":Validity
    Period,
    "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":IssuerP
    arty,
    "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":Holder
    Party}' is expected.

    The final problem, and much the most serious, is with PriorInformationNotice. I think I
    raised this before, but I think it is worth revisiting.

    In all other root documents, the ID field is mandatory. Here it is optional. Without an ID
    you can not create a DocumentReference, and thus ApplicationResponse, DocumentStatus
    and DocumentStatusRequest are all useless.
    I realise that this is an old (pre-2.30) document, but at least can we have a note
    somewhere that says that this field should be present even if formally it is not required. I
    only noticed this because the I have a base class for all my UBL objects, and this is passed
    into the constructor for DocumentReference objects - I then strip the fields in this base
    class from each object and include them by inheritance. So the two examples pass
    schema validation, but my code will not load them as the base class has them as required.

    At the very least there needs to be a note in the documentation saying that if you do not
    provide an ID then DocumentReferences, ApplicationResponses, DocumentStatuses and
    DocumentStatusRequests will not be able to be generated and so an ID should be
    provided. I could make ID optional in my base class, and simply not generate a
    DocumentReference if no ID is present, and use the schema to ensure that ID is present
    where needed, but its absence renders the object so useless I am minded to leave it as it
    (i.e. mandatory) and to reject any incoming object which leaves it out.

    David

    On Wednesday, 19 August 2020 03:54:46 BST Paul Knight wrote:


    OASIS Members and other interested parties,

    We are pleased to announce that Universal Business Language Version 2.3 from the UBL
    TC [1] is now available for public review and comment. This is the third public review for
    Universal Business Language v2.3.

    UBL is the leading interchange format for business documents. It is designed to operate
    within a standard business framework such as ISO/IEC 15000 (ebXML) to provide a
    complete, standards-based infrastructure that can extend the benefits of existing EDI
    systems to businesses of all sizes. The European Commission has declared UBL officially
    eligible for referencing in tenders from public administrations, and in 2015 UBL was
    approved as ISO/IEC 19845:2015.

    Specifically, UBL provides:- A suite of structured business objects and their associated
    semantics expressed as reusable data components and common business documents.- A
    library of schemas for reusable data components such as Address, Item, and Payment, the
    common data elements of everyday business documents.- A set of schemas for common
    business documents such as Order, Despatch Advice, and Invoice that are constructed
    from the UBL library components and can be used in generic procurement and
    transportation contexts.

    UBL v2.3 is a minor revision to v2.2 that preserves backwards compatibility with previous
    v2.# versions. It adds five new document types, bringing the total number of UBL business
    documents to 86.

    The specification documents and related files are available here:

    Universal Business Language Version 2.3Committee Specification Draft 0329 July 2020

    Editable source (Authoritative):

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.xml[1]
    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.html[2]
    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.pdf[3]
    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/cl/[4]
    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/cva/[5]
    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/mod/[6]
    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/val/[7]
    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/xml/[8]
    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/xsd/[9]
    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/xsdrt/[10]
    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.zip[11]
    https://www.oasis-open.org/committees/comments/index.php?wg_abbrev=ubl[12]).

    Feedback submitted by TC non-members for this work and for other work of this TC is
    publicly archived and can be viewed at:

    https://lists.oasis-open.org/archives/ubl-comment/[13]
    https://www.oasis-open.org/committees/ubl/[14]
    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3-csd03-public-review-metadata.html[15]


  • 3.  Re: [ubl-comment] Invitation to comment on Universal Business Language v2.3 from the UBL TC - ends September 2nd

    Posted 09-01-2020 14:43
    Thank you David. The TC will go through each of your comments and report our conclusions in a comment resolution log.

    Best regards,

    Kenneth



    From: David Goodenough <david.goodenough@broadwellmanor.co.uk>
    Date: Thursday, August 20, 2020 at 12:00 PM
    To: "ubl-comment@lists.oasis-open.org" <ubl-comment@lists.oasis-open.org>
    Subject: Re: [ubl-comment] Invitation to comment on Universal Business Language v2.3 from the UBL TC - ends September 2nd


    There are still problems with the examples. Two of them will not load with schema validation.



    1) UBL-GoodsCertificate-2.3-Example.xml



    lineNumber: 299; columnNumber: 29; cvc-complex-type.2.4.a: Invalid content was found starting with element '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":AcceptanceIndicator}'. One of '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":Description, "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":Note, "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":ValidityPeriod, "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":IssuerParty}' is expected.



    2) UBL-GoodsItemPassport-2.3-ExampleIssued.xml



    lineNumber: 6; columnNumber: 18; cvc-complex-type.2.4.a: Invalid content was found starting with element '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":StatusCode}'. One of '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":IssueTime, "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":Note, "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":VersionID, "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":ExportReasonCode, "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":ExportReason, "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":ValidityPeriod, "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":IssuerParty, "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":HolderParty}' is expected.



    The final problem, and much the most serious, is with PriorInformationNotice. I think I raised this before, but I think it is worth revisiting.



    In all other root documents, the ID field is mandatory. Here it is optional. Without an ID you can not create a DocumentReference, and thus ApplicationResponse, DocumentStatus and DocumentStatusRequest are all useless.

    I realise that this is an old (pre-2.30) document, but at least can we have a note somewhere that says that this field should be present even if formally it is not required. I only noticed this because the I have a base class for all my UBL objects, and this is passed into the constructor for DocumentReference objects - I then strip the fields in this base class from each object and include them by inheritance. So the two examples pass schema validation, but my code will not load them as the base class has them as required.



    At the very least there needs to be a note in the documentation saying that if you do not provide an ID then DocumentReferences, ApplicationResponses, DocumentStatuses and DocumentStatusRequests will not be able to be generated and so an ID should be provided. I could make ID optional in my base class, and simply not generate a DocumentReference if no ID is present, and use the schema to ensure that ID is present where needed, but its absence renders the object so useless I am minded to leave it as it (i.e. mandatory) and to reject any incoming object which leaves it out.



    David



    On Wednesday, 19 August 2020 03:54:46 BST Paul Knight wrote:



    OASIS Members and other interested parties,



    We are pleased to announce that Universal Business Language Version 2.3 from the UBL TC [1] is now available for public review and comment. This is the third public review for Universal Business Language v2.3.



    UBL is the leading interchange format for business documents. It is designed to operate within a standard business framework such as ISO/IEC 15000 (ebXML) to provide a complete, standards-based infrastructure that can extend the benefits of existing EDI systems to businesses of all sizes. The European Commission has declared UBL officially eligible for referencing in tenders from public administrations, and in 2015 UBL was approved as ISO/IEC 19845:2015.



    Specifically, UBL provides:

    - A suite of structured business objects and their associated semantics expressed as reusable data components and common business documents.

    - A library of schemas for reusable data components such as Address, Item, and Payment, the common data elements of everyday business documents.

    - A set of schemas for common business documents such as Order, Despatch Advice, and Invoice that are constructed from the UBL library components and can be used in generic procurement and transportation contexts.



    UBL v2.3 is a minor revision to v2.2 that preserves backwards compatibility with previous v2.# versions. It adds five new document types, bringing the total number of UBL business documents to 86.



    The specification documents and related files are available here:



    Universal Business Language Version 2.3

    Committee Specification Draft 03

    29 July 2020



    Editable source (Authoritative):

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.xml

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.html

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.pdf

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/cl/

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/cva/

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/mod/

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/val/

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/xml/

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/xsd/

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/xsdrt/

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.zip

    https://www.oasis-open.org/committees/comments/index.php?wg_abbrev=ubl).



    Feedback submitted by TC non-members for this work and for other work of this TC is publicly archived and can be viewed at:

    https://lists.oasis-open.org/archives/ubl-comment/

    https://www.oasis-open.org/committees/ubl/

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3-csd03-public-review-metadata.html

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/csd03-UBL-2.3-DIFF.pdf

    https://www.oasis-open.org/policies-guidelines/ipr

    https://www.oasis-open.org/committees/ubl/ipr.php

    https://www.oasis-open.org/policies-guidelines/ipr#RF-on-Limited-Mode





    Paul Knight<mailto:paul.knight@oasis-open.org>....Document Process Analyst<https://www.oasis-open.org/people/staff/paul-knight>

    OASIS<https://www.oasis-open.org/> - Advancing open standards for the information society





  • 4.  Re: [ubl-comment] Invitation to comment on Universal Business Language v2.3 from the UBL TC - ends September 2nd

    Posted 09-01-2020 14:43




    Thank you David. The TC will go through each of your comments and report our conclusions in a comment resolution log.
     
    Best regards,
     
    Kenneth
     
     
     

    From: David Goodenough <david.goodenough@broadwellmanor.co.uk>
    Date: Thursday, August 20, 2020 at 12:00 PM
    To: "ubl-comment@lists.oasis-open.org" <ubl-comment@lists.oasis-open.org>
    Subject: Re: [ubl-comment] Invitation to comment on Universal Business Language v2.3 from the UBL TC - ends September 2nd


     

    There are still problems with the examples.  Two of them will not load with schema validation.
     
    1) UBL-GoodsCertificate-2.3-Example.xml
     
    lineNumber: 299; columnNumber: 29; cvc-complex-type.2.4.a: Invalid content was found starting with element '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":AcceptanceIndicator}'. One of '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":Description,
    "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":Note, "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":ValidityPeriod, "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":IssuerParty}'
    is expected.
     
    2) UBL-GoodsItemPassport-2.3-ExampleIssued.xml
     
    lineNumber: 6; columnNumber: 18; cvc-complex-type.2.4.a: Invalid content was found starting with element '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":StatusCode}'. One of '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":IssueTime,
    "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":Note, "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":VersionID, "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":ExportReasonCode, "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":ExportReason,
    "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":ValidityPeriod, "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":IssuerParty, "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":HolderParty}'
    is expected.
     
    The final problem, and much the most serious, is with PriorInformationNotice.  I think I raised this before, but I think it is worth revisiting.

     
     In all other root documents, the ID field is mandatory.  Here it is optional.  Without an ID you can not create a DocumentReference, and thus ApplicationResponse, DocumentStatus and DocumentStatusRequest are all useless.

    I realise that this is an old (pre-2.30) document, but at least can we have a note somewhere that says that this field should be present even if formally it is not required.  I only noticed this because the I have a base class for all
    my UBL objects, and this is passed into the constructor for DocumentReference objects - I then strip the fields in this base class from each object and include them by inheritance.  So the two examples pass schema validation, but my code will not load them
    as the base class has them as required.
     
    At the very least there needs to be a note in the documentation saying that if you do not provide an ID then DocumentReferences, ApplicationResponses, DocumentStatuses and DocumentStatusRequests will not be able to be generated and so
    an ID should be provided.  I could make ID optional in my base class, and simply not generate a DocumentReference if no ID is present, and use the schema to ensure that ID is present where needed, but its absence renders the object so useless I am minded to
    leave it as it (i.e. mandatory) and to reject any incoming object which leaves it out.

     
    David
     
    On Wednesday, 19 August 2020 03:54:46 BST Paul Knight wrote:
     

    OASIS Members and other interested parties,
     
    We are pleased to announce that Universal Business Language Version 2.3 from the UBL TC [1] is now available for public review and comment. This is the third public review for Universal Business Language v2.3.
     
    UBL is the leading interchange format for business documents. It is designed to operate within a standard business framework such as ISO/IEC 15000 (ebXML) to provide a complete, standards-based infrastructure that can extend the benefits
    of existing EDI systems to businesses of all sizes. The European Commission has declared UBL officially eligible for referencing in tenders from public administrations, and in 2015 UBL was approved as ISO/IEC 19845:2015.
     
    Specifically, UBL provides:
     - A suite of structured business objects and their associated semantics expressed as reusable data components and common business documents.
     - A library of schemas for reusable data components such as Address, Item, and Payment, the common data elements of everyday business documents.
     - A set of schemas for common business documents such as Order, Despatch Advice, and Invoice that are constructed from the UBL library components and can be used in generic procurement and transportation contexts.
     
    UBL v2.3 is a minor revision to v2.2 that preserves backwards compatibility with previous v2.# versions. It adds five new document types, bringing the total number of UBL business documents to 86.
     
    The specification documents and related files are available here:
     
    Universal Business Language Version 2.3
     Committee Specification Draft 03
     29 July 2020
     
    Editable source (Authoritative):
      https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.xml
      https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.html
      https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.pdf
      https://docs.oasis-open.org/ubl/csd03-UBL-2.3/cl/
      https://docs.oasis-open.org/ubl/csd03-UBL-2.3/cva/
      https://docs.oasis-open.org/ubl/csd03-UBL-2.3/mod/
      https://docs.oasis-open.org/ubl/csd03-UBL-2.3/val/
      https://docs.oasis-open.org/ubl/csd03-UBL-2.3/xml/
      https://docs.oasis-open.org/ubl/csd03-UBL-2.3/xsd/
      https://docs.oasis-open.org/ubl/csd03-UBL-2.3/xsdrt/
      https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.zip
      https://www.oasis-open.org/committees/comments/index.php?wg_abbrev=ubl ).
     
    Feedback submitted by TC non-members for this work and for other work of this TC is publicly archived and can be viewed at:
      https://lists.oasis-open.org/archives/ubl-comment/
      https://www.oasis-open.org/committees/ubl/
      https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3-csd03-public-review-metadata.html
      https://docs.oasis-open.org/ubl/csd03-UBL-2.3/csd03-UBL-2.3-DIFF.pdf
      https://www.oasis-open.org/policies-guidelines/ipr
      https://www.oasis-open.org/committees/ubl/ipr.php
      https://www.oasis-open.org/policies-guidelines/ipr#RF-on-Limited-Mode
     
     

    Paul Knight ... . Document
    Process Analyst

    OASIS  - Advancing open standards for the information society
     






  • 5.  Re: [ubl-comment] Invitation to comment on Universal Business Language v2.3 from the UBL TC - ends September 2nd

    Posted 10-07-2020 15:32
    Hi David

    Thanks always for your diligent reviewing! The TC did review and approve resolutions to all comments, as recorded here: https://www.oasis-open.org/committees/document.php?document_id=67718&wg_abbrev=ubl

    However, upon further examination we were not able to reproduce the validation errors with the two examples (Goods Certificate and Goods Item Passport). Could you check that you are using the correct versions (XMLs and XSDs) please? The CSD03 version is published here: https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.zip

    Best regards,

    Kenneth


    From: David Goodenough <david.goodenough@broadwellmanor.co.uk>
    Date: Thursday, August 20, 2020 at 12:00 PM
    To: "ubl-comment@lists.oasis-open.org" <ubl-comment@lists.oasis-open.org>
    Subject: Re: [ubl-comment] Invitation to comment on Universal Business Language v2.3 from the UBL TC - ends September 2nd


    There are still problems with the examples. Two of them will not load with schema validation.



    1) UBL-GoodsCertificate-2.3-Example.xml



    lineNumber: 299; columnNumber: 29; cvc-complex-type.2.4.a: Invalid content was found starting with element '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":AcceptanceIndicator}'. One of '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":Description, "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":Note, "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":ValidityPeriod, "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":IssuerParty}' is expected.



    2) UBL-GoodsItemPassport-2.3-ExampleIssued.xml



    lineNumber: 6; columnNumber: 18; cvc-complex-type.2.4.a: Invalid content was found starting with element '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":StatusCode}'. One of '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":IssueTime, "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":Note, "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":VersionID, "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":ExportReasonCode, "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":ExportReason, "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":ValidityPeriod, "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":IssuerParty, "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":HolderParty}' is expected.



    The final problem, and much the most serious, is with PriorInformationNotice. I think I raised this before, but I think it is worth revisiting.



    In all other root documents, the ID field is mandatory. Here it is optional. Without an ID you can not create a DocumentReference, and thus ApplicationResponse, DocumentStatus and DocumentStatusRequest are all useless.

    I realise that this is an old (pre-2.30) document, but at least can we have a note somewhere that says that this field should be present even if formally it is not required. I only noticed this because the I have a base class for all my UBL objects, and this is passed into the constructor for DocumentReference objects - I then strip the fields in this base class from each object and include them by inheritance. So the two examples pass schema validation, but my code will not load them as the base class has them as required.



    At the very least there needs to be a note in the documentation saying that if you do not provide an ID then DocumentReferences, ApplicationResponses, DocumentStatuses and DocumentStatusRequests will not be able to be generated and so an ID should be provided. I could make ID optional in my base class, and simply not generate a DocumentReference if no ID is present, and use the schema to ensure that ID is present where needed, but its absence renders the object so useless I am minded to leave it as it (i.e. mandatory) and to reject any incoming object which leaves it out.



    David



    On Wednesday, 19 August 2020 03:54:46 BST Paul Knight wrote:



    OASIS Members and other interested parties,



    We are pleased to announce that Universal Business Language Version 2.3 from the UBL TC [1] is now available for public review and comment. This is the third public review for Universal Business Language v2.3.



    UBL is the leading interchange format for business documents. It is designed to operate within a standard business framework such as ISO/IEC 15000 (ebXML) to provide a complete, standards-based infrastructure that can extend the benefits of existing EDI systems to businesses of all sizes. The European Commission has declared UBL officially eligible for referencing in tenders from public administrations, and in 2015 UBL was approved as ISO/IEC 19845:2015.



    Specifically, UBL provides:

    - A suite of structured business objects and their associated semantics expressed as reusable data components and common business documents.

    - A library of schemas for reusable data components such as Address, Item, and Payment, the common data elements of everyday business documents.

    - A set of schemas for common business documents such as Order, Despatch Advice, and Invoice that are constructed from the UBL library components and can be used in generic procurement and transportation contexts.



    UBL v2.3 is a minor revision to v2.2 that preserves backwards compatibility with previous v2.# versions. It adds five new document types, bringing the total number of UBL business documents to 86.



    The specification documents and related files are available here:



    Universal Business Language Version 2.3

    Committee Specification Draft 03

    29 July 2020



    Editable source (Authoritative):

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.xml

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.html

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.pdf

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/cl/

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/cva/

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/mod/

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/val/

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/xml/

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/xsd/

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/xsdrt/

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.zip

    https://www.oasis-open.org/committees/comments/index.php?wg_abbrev=ubl).



    Feedback submitted by TC non-members for this work and for other work of this TC is publicly archived and can be viewed at:

    https://lists.oasis-open.org/archives/ubl-comment/

    https://www.oasis-open.org/committees/ubl/

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3-csd03-public-review-metadata.html

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/csd03-UBL-2.3-DIFF.pdf

    https://www.oasis-open.org/policies-guidelines/ipr

    https://www.oasis-open.org/committees/ubl/ipr.php

    https://www.oasis-open.org/policies-guidelines/ipr#RF-on-Limited-Mode





    Paul Knight<mailto:paul.knight@oasis-open.org>....Document Process Analyst<https://www.oasis-open.org/people/staff/paul-knight>

    OASIS<https://www.oasis-open.org/> - Advancing open standards for the information society





  • 6.  Re: [ubl-comment] Invitation to comment on Universal Business Language v2.3 from the UBL TC - ends September 2nd

    Posted 10-07-2020 17:38
    My code takes that ZIP and extracts the RT xsds and builds the scala classes that to handle
    the content of the XML. So everything comes from that ZIP.

    I then have a viewer which uses those scala classes to load a file which the user chooses. I
    have expanded the ZIP in to its own (1 per version of the ZIP) directory structure, and then
    loaded each example into the viewer. All of them loaded except these two.

    When the classes load the XML they load it with schema validation, using the RT xsds
    extracted from the ZIP at the start of this process.

    However the viewer is a manual process, and thus subject to human error - which I guess
    is what must have happened, because I now can not find the error, they all load (except
    PriorInformationNotice because my common code always insists on an ID).

    So I guess we can mark this down my mistook. Sorry to raise a false alarm.

    David

    On Wednesday, 7 October 2020 16:31:54 BST Kenneth Bengtsson wrote:


    Hi David

    Thanks always for your diligent reviewing! The TC did review and approve resolutions to all
    comments, as recorded here: https://www.oasis-open.org/committees/document.php?
    document_id=67718&wg_abbrev=ubl[1]

    However, upon further examination we were not able to reproduce the validation errors
    with the two examples (Goods Certificate and Goods Item Passport). Could you check that
    you are using the correct versions (XMLs and XSDs) please? The CSD03 version is
    published here: https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.zip[2]

    Best regards,

    Kenneth


    *From: *David Goodenough <david.goodenough@broadwellmanor.co.uk>

    *Date: *Thursday, August 20, 2020 at 12:00 PM

    *To: *"ubl-comment@lists.oasis-open.org" <ubl-comment@lists.oasis-open.org>

    *Subject: *Re: [ubl-comment] Invitation to comment on Universal Business Language v2.3
    from the UBL TC - ends September 2nd

    There are still problems with the examples. Two of them will not load with schema
    validation.

    1) UBL-GoodsCertificate-2.3-Example.xml

    lineNumber: 299; columnNumber: 29; cvc-complex-type.2.4.a: Invalid content was found
    starting with element
    '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":Acceptance
    Indicator}'. One of
    '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":Description
    , "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":Note,
    "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":Validity
    Period,
    "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":IssuerP
    arty}' is expected.

    2) UBL-GoodsItemPassport-2.3-ExampleIssued.xml

    lineNumber: 6; columnNumber: 18; cvc-complex-type.2.4.a: Invalid content was found
    starting with element
    '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":StatusCode
    }'. One of
    '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":IssueTime,
    "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":Note,
    "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":VersionID,
    "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":ExportReaso
    nCode,
    "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":ExportReaso
    n,
    "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":Validity
    Period,
    "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":IssuerP
    arty,
    "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":Holder
    Party}' is expected.

    The final problem, and much the most serious, is with PriorInformationNotice. I think I
    raised this before, but I think it is worth revisiting.

    In all other root documents, the ID field is mandatory. Here it is optional. Without an ID
    you can not create a DocumentReference, and thus ApplicationResponse, DocumentStatus
    and DocumentStatusRequest are all useless.
    I realise that this is an old (pre-2.30) document, but at least can we have a note
    somewhere that says that this field should be present even if formally it is not required. I
    only noticed this because the I have a base class for all my UBL objects, and this is passed
    into the constructor for DocumentReference objects - I then strip the fields in this base
    class from each object and include them by inheritance. So the two examples pass
    schema validation, but my code will not load them as the base class has them as required.

    At the very least there needs to be a note in the documentation saying that if you do not
    provide an ID then DocumentReferences, ApplicationResponses, DocumentStatuses and
    DocumentStatusRequests will not be able to be generated and so an ID should be
    provided. I could make ID optional in my base class, and simply not generate a
    DocumentReference if no ID is present, and use the schema to ensure that ID is present
    where needed, but its absence renders the object so useless I am minded to leave it as it
    (i.e. mandatory) and to reject any incoming object which leaves it out.

    David

    On Wednesday, 19 August 2020 03:54:46 BST Paul Knight wrote:

    OASIS Members and other interested parties,

    We are pleased to announce that Universal Business Language Version 2.3 from the UBL
    TC [1] is now available for public review and comment. This is the third public review for
    Universal Business Language v2.3.


  • 7.  Re: [ubl-comment] Invitation to comment on Universal Business Language v2.3 from the UBL TC - ends September 2nd

    Posted 10-07-2020 17:41
    Glad it worked out, David! And we always appreciate your input. Thanks again for taking your time to help us review.

    /Kenneth


    From: David Goodenough <david.goodenough@broadwellmanor.co.uk>
    Date: Wednesday, October 7, 2020 at 7:38 PM
    To: "ubl-comment@lists.oasis-open.org" <ubl-comment@lists.oasis-open.org>
    Subject: Re: [ubl-comment] Invitation to comment on Universal Business Language v2.3 from the UBL TC - ends September 2nd


    My code takes that ZIP and extracts the RT xsds and builds the scala classes that to handle the content of the XML. So everything comes from that ZIP.



    I then have a viewer which uses those scala classes to load a file which the user chooses. I have expanded the ZIP in to its own (1 per version of the ZIP) directory structure, and then loaded each example into the viewer. All of them loaded except these two.



    When the classes load the XML they load it with schema validation, using the RT xsds extracted from the ZIP at the start of this process.



    However the viewer is a manual process, and thus subject to human error - which I guess is what must have happened, because I now can not find the error, they all load (except PriorInformationNotice because my common code always insists on an ID).



    So I guess we can mark this down my mistook. Sorry to raise a false alarm.



    David



    On Wednesday, 7 October 2020 16:31:54 BST Kenneth Bengtsson wrote:



    Hi David



    Thanks always for your diligent reviewing! The TC did review and approve resolutions to all comments, as recorded here: https://www.oasis-open.org/committees/document.php?document_id=67718&wg_abbrev=ubl



    However, upon further examination we were not able to reproduce the validation errors with the two examples (Goods Certificate and Goods Item Passport). Could you check that you are using the correct versions (XMLs and XSDs) please? The CSD03 version is published here: https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.zip



    Best regards,



    Kenneth





    From: David Goodenough <david.goodenough@broadwellmanor.co.uk>

    Date: Thursday, August 20, 2020 at 12:00 PM

    To: "ubl-comment@lists.oasis-open.org" <ubl-comment@lists.oasis-open.org>

    Subject: Re: [ubl-comment] Invitation to comment on Universal Business Language v2.3 from the UBL TC - ends September 2nd



    There are still problems with the examples. Two of them will not load with schema validation.



    1) UBL-GoodsCertificate-2.3-Example.xml



    lineNumber: 299; columnNumber: 29; cvc-complex-type.2.4.a: Invalid content was found starting with element '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":AcceptanceIndicator}'. One of '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":Description, "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":Note, "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":ValidityPeriod, "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":IssuerParty}' is expected.



    2) UBL-GoodsItemPassport-2.3-ExampleIssued.xml



    lineNumber: 6; columnNumber: 18; cvc-complex-type.2.4.a: Invalid content was found starting with element '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":StatusCode}'. One of '{"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":IssueTime, "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":Note, "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":VersionID, "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":ExportReasonCode, "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2":ExportReason, "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":ValidityPeriod, "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":IssuerParty, "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2":HolderParty}' is expected.



    The final problem, and much the most serious, is with PriorInformationNotice. I think I raised this before, but I think it is worth revisiting.



    In all other root documents, the ID field is mandatory. Here it is optional. Without an ID you can not create a DocumentReference, and thus ApplicationResponse, DocumentStatus and DocumentStatusRequest are all useless.

    I realise that this is an old (pre-2.30) document, but at least can we have a note somewhere that says that this field should be present even if formally it is not required. I only noticed this because the I have a base class for all my UBL objects, and this is passed into the constructor for DocumentReference objects - I then strip the fields in this base class from each object and include them by inheritance. So the two examples pass schema validation, but my code will not load them as the base class has them as required.



    At the very least there needs to be a note in the documentation saying that if you do not provide an ID then DocumentReferences, ApplicationResponses, DocumentStatuses and DocumentStatusRequests will not be able to be generated and so an ID should be provided. I could make ID optional in my base class, and simply not generate a DocumentReference if no ID is present, and use the schema to ensure that ID is present where needed, but its absence renders the object so useless I am minded to leave it as it (i.e. mandatory) and to reject any incoming object which leaves it out.



    David



    On Wednesday, 19 August 2020 03:54:46 BST Paul Knight wrote:



    OASIS Members and other interested parties,



    We are pleased to announce that Universal Business Language Version 2.3 from the UBL TC [1] is now available for public review and comment. This is the third public review for Universal Business Language v2.3.



    UBL is the leading interchange format for business documents. It is designed to operate within a standard business framework such as ISO/IEC 15000 (ebXML) to provide a complete, standards-based infrastructure that can extend the benefits of existing EDI systems to businesses of all sizes. The European Commission has declared UBL officially eligible for referencing in tenders from public administrations, and in 2015 UBL was approved as ISO/IEC 19845:2015.



    Specifically, UBL provides:

    - A suite of structured business objects and their associated semantics expressed as reusable data components and common business documents.

    - A library of schemas for reusable data components such as Address, Item, and Payment, the common data elements of everyday business documents.

    - A set of schemas for common business documents such as Order, Despatch Advice, and Invoice that are constructed from the UBL library components and can be used in generic procurement and transportation contexts.



    UBL v2.3 is a minor revision to v2.2 that preserves backwards compatibility with previous v2.# versions. It adds five new document types, bringing the total number of UBL business documents to 86.



    The specification documents and related files are available here:



    Universal Business Language Version 2.3

    Committee Specification Draft 03

    29 July 2020



    Editable source (Authoritative):

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.xml

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.html

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.pdf

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/cl/

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/cva/

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/mod/

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/val/

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/xml/

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/xsd/

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/xsdrt/

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3.zip

    https://www.oasis-open.org/committees/comments/index.php?wg_abbrev=ubl).



    Feedback submitted by TC non-members for this work and for other work of this TC is publicly archived and can be viewed at:

    https://lists.oasis-open.org/archives/ubl-comment/

    https://www.oasis-open.org/committees/ubl/

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/UBL-2.3-csd03-public-review-metadata.html

    https://docs.oasis-open.org/ubl/csd03-UBL-2.3/csd03-UBL-2.3-DIFF.pdf

    https://www.oasis-open.org/policies-guidelines/ipr

    https://www.oasis-open.org/committees/ubl/ipr.php

    https://www.oasis-open.org/policies-guidelines/ipr#RF-on-Limited-Mode





    Paul Knight<mailto:paul.knight@oasis-open.org>....Document Process Analyst<https://www.oasis-open.org/people/staff/paul-knight>

    OASIS<https://www.oasis-open.org/> - Advancing open standards for the information society