Project news

Invitation to comment on four #OData specification drafts – ends December 18th

We are pleased to announce that OData Version 4.01, OData Common Schema Definition Language (CSDL) XML Representation Version 4.01, OData Common Schema Definition Language (CSDL) JSON Representation Version 4.01, and OData JSON Format Version 4.01 from the OASIS Open Data Protocol (OData) TC [1] is now available for public review and comment. This release has been updated based on feedback from the previous public review. The comments received in that review and their resolution can be found the TC’s comment resolution logs [2].

The Open Data Protocol (OData) enables the creation of REST-based data services, which allow resources, identified using Uniform Resource Locators (URLs) and defined in an Entity Data Model (EDM), to be published and edited by Web clients using simple HTTP messages. The public review drafts released today are:

– OData Version 4.01: This document defines the core semantics and facilities of the protocol.

– OData Common Schema Definition Language (CSDL) XML Representation Version 4.01: OData services are described by an Entity Model (EDM). The Common Schema Definition Language (CSDL) defines specific representations of the entity data model exposed by an OData service using, XML, JSON, and other formats. This document specifically defines the XML representation of CSDL.

– OData Common Schema Definition Language (CSDL) JSON Representation Version 4.01: This document specifically defines the JSON representation of CSDL.

– OData JSON Format Version 4.01: This document extends the core specification by defining representations for OData requests and responses using a JSON format.

The documents and related files are available here:

– OData Version 4.01
Committee Specification Draft 04 / Public Review Draft 04
16 November 2017

— OData Version 4.01. Part 1: Protocol

Editable source (Authoritative):
http://docs.oasis-open.org/odata/odata/v4.01/csprd04/part1-protocol/odata-v4.01-csprd04-part1-protocol.docx

HTML:
http://docs.oasis-open.org/odata/odata/v4.01/csprd04/part1-protocol/odata-v4.01-csprd04-part1-protocol.html

PDF:
http://docs.oasis-open.org/odata/odata/v4.01/csprd04/part1-protocol/odata-v4.01-csprd04-part1-protocol.pdf

— OData Version 4.01. Part 2: URL Conventions

Editable source (Authoritative):
http://docs.oasis-open.org/odata/odata/v4.01/csprd04/part2-url-conventions/odata-v4.01-csprd04-part2-url-conventions.docx

HTML:
http://docs.oasis-open.org/odata/odata/v4.01/csprd04/part2-url-conventions/odata-v4.01-csprd04-part2-url-conventions.html

PDF:
http://docs.oasis-open.org/odata/odata/v4.01/csprd04/part2-url-conventions/odata-v4.01-csprd04-part2-url-conventions.pdf

ABNF components:
http://docs.oasis-open.org/odata/odata/v4.01/csprd04/abnf/

– OData Common Schema Definition Language (CSDL) XML Representation Version 4.01
Committee Specification Draft 04 / Public Review Draft 04
16 November 2017

Editable source (Authoritative):
http://docs.oasis-open.org/odata/odata-csdl-xml/v4.01/csprd04/odata-csdl-xml-v4.01-csprd04.docx

HTML:
http://docs.oasis-open.org/odata/odata-csdl-xml/v4.01/csprd04/odata-csdl-xml-v4.01-csprd04.html

PDF:
http://docs.oasis-open.org/odata/odata-csdl-xml/v4.01/csprd04/odata-csdl-xml-v4.01-csprd04.pdf

XML schemas:
http://docs.oasis-open.org/odata/odata-csdl-xml/v4.01/csprd04/schemas/

– OData Common Schema Definition Language (CSDL) JSON Representation Version 4.01
Committee Specification Draft 03 / Public Review Draft 03
16 November 2017

Editable source (Authoritative):
http://docs.oasis-open.org/odata/odata-csdl-json/v4.01/csprd03/odata-csdl-json-v4.01-csprd03.docx

HTML:
http://docs.oasis-open.org/odata/odata-csdl-json/v4.01/csprd03/odata-csdl-json-v4.01-csprd03.html

PDF:
http://docs.oasis-open.org/odata/odata-csdl-json/v4.01/csprd03/odata-csdl-json-v4.01-csprd03.pdf

JSON schemas:
http://docs.oasis-open.org/odata/odata-csdl-json/v4.01/csprd03/schemas/

– OData JSON Format Version 4.01
Committee Specification Draft 04 / Public Review Draft 04
16 November 2017

Editable source (Authoritative):
http://docs.oasis-open.org/odata/odata-json-format/v4.01/csprd04/odata-json-format-v4.01-csprd04.docx

HTML:
http://docs.oasis-open.org/odata/odata-json-format/v4.01/csprd04/odata-json-format-v4.01-csprd04.html

PDF:
http://docs.oasis-open.org/odata/odata-json-format/v4.01/csprd04/odata-json-format-v4.01-csprd04.pdf

For your convenience, OASIS provides complete packages of the prose specifications and related files in ZIP distribution files. You can download the ZIP files at:

– OData Version 4.01:
http://docs.oasis-open.org/odata/odata/v4.01/csprd04/odata-v4.01-csprd04.zip

– OData Common Schema Definition Language (CSDL) XML Representation Version 4.01:
http://docs.oasis-open.org/odata/odata-csdl-xml/v4.01/csprd04/odata-csdl-xml-v4.01-csprd04.zip

– OData Common Schema Definition Language (CSDL) JSON Representation Version 4.01:
http://docs.oasis-open.org/odata/odata-csdl-json/v4.01/csprd03/odata-csdl-json-v4.01-csprd03.zip

– OData JSON Format Version 4.01:
http://docs.oasis-open.org/odata/odata-json-format/v4.01/csprd04/odata-json-format-v4.01-csprd04.zip

How to Provide Feedback

OASIS and the OData 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 04 December 2017 at 00:00 UTC and ends 18 December 2017 at 11:59 UTC.

These specification drafts were previously submitted for public review [2]. Changes are highlighted in the red-lined files included in the packages [3]. Comments for these drafts are limited to the changes from the previous public review.

Comments on the work may be submitted to the TC by following the instructions located at:

http://www.oasis-open.org/committees/comments/form.php?wg_abbrev=odata

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

http://lists.oasis-open.org/archives/odata-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 these works, 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 OData TC may be found on the TC’s public home page.

========== Additional references:

[1] OASIS Open Data Protocol (OData) TC
http://www.oasis-open.org/committees/odata/

Approval: https://www.oasis-open.org/committees/download.php/62068/odata-meeting-196_on-20171116-minutes.html

[2] Previous public reviews:

– OData Version 4.01

* 30-day public review, 19 January 2017:
https://lists.oasis-open.org/archives/members/201701/msg00003.html
– Comment resolution log:
http://docs.oasis-open.org/odata/odata/v4.01/csprd01/odata-v4.01-csprd01-comment-resolution-log.txt

* 30-day public review, 03 July 2017:
https://lists.oasis-open.org/archives/members/201707/msg00001.html
– Comment resolution log:
http://docs.oasis-open.org/odata/odata/v4.01/csprd02/odata-v4.01-csprd02-comment-resolution-log.xlsx

* 15-day public review, 18 October, 2017:
https://lists.oasis-open.org/archives/members/201710/msg00000.html
– Comment resolution log:
http://docs.oasis-open.org/odata/odata/v4.01/csprd03/odata-v4.01-csprd03-comment-resolution-log.xlsx

– OData JSON Format Version 4.01

* 30-day public review, 19 January 2017:
https://lists.oasis-open.org/archives/members/201701/msg00003.html
– Comment resolution log:
http://docs.oasis-open.org/odata/odata-json-format/v4.01/csprd01/odata-json-format-v4.01-csprd01-comment-resolution-log.txt

* 30-day public review, 03 July 2017:
https://lists.oasis-open.org/archives/members/201707/msg00001.html – Comment resolution log:
http://docs.oasis-open.org/odata/odata-json-format/v4.01/csprd02/odata-json-format-v4.01-csprd02-comment-resolution-log.xlsx

* 15-day public review, 18 October, 2017:
https://lists.oasis-open.org/archives/members/201710/msg00000.html
– Comment resolution log:
http://docs.oasis-open.org/odata/odata-json-format/v4.01/csprd03/odata-json-format-v4.01-csprd03-comment-resolution-log.xlsx

– OData Common Schema Definition Language (CSDL) XML Representation Version 4.01

* 30-day public review, 19 January 2017:
https://lists.oasis-open.org/archives/members/201701/msg00003.html
– Comment resolution log:
http://docs.oasis-open.org/odata/odata-csdl-xml/v4.01/csprd01/odata-csdl-xml-v4.01-csprd01-comment-resolution-log.txt

* 30-day public review, 03 July 2017:
https://lists.oasis-open.org/archives/members/201707/msg00001.html – Comment resolution log:
http://docs.oasis-open.org/odata/odata-csdl-xml/v4.01/csprd02/odata-csdl-xml-v4.01-csprd02-comment-resolution-log.xlsx

* 15-day public review, 18 October, 2017:
https://lists.oasis-open.org/archives/members/201710/msg00000.html
– Comment resolution log:
http://docs.oasis-open.org/odata/odata-csdl-xml/v4.01/csprd03/odata-csdl-xml-v4.01-csprd03-comment-resolution-log.xlsx

– OData Common Schema Definition Language (CSDL) JSON Representation v4.01

* 30-day public review, 03 July 2017:
https://lists.oasis-open.org/archives/members/201707/msg00001.html – Comment resolution log:
http://docs.oasis-open.org/odata/odata-csdl-json/v4.01/csprd01/odata-csdl-json-v4.01-csprd01-comment-resolution-log.xlsx

* 15-day public review, 18 October, 2017:
https://lists.oasis-open.org/archives/members/201710/msg00000.html
– Comment resolution log:
http://docs.oasis-open.org/odata/odata-csdl-json/v4.01/csprd02/odata-csdl-json-v4.01-csprd02-comment-resolution-log.xlsx

[3] Red-lined copies of the specifications:

– OData Version 4.01:
Part 1: http://docs.oasis-open.org/odata/odata/v4.01/csprd04/part1-protocol/odata-v4.01-csprd04-part1-protocol-DIFF.pdf

Part 2: http://docs.oasis-open.org/odata/odata/v4.01/csprd04/part2-url-conventions/odata-v4.01-csprd04-part2-url-conventions-DIFF.pdf

– OData Common Schema Definition Language (CSDL) XML Representation Version 4.01:
http://docs.oasis-open.org/odata/odata-csdl-xml/v4.01/csprd04/odata-csdl-xml-v4.01-csprd04-DIFF.pdf

– OData Common Schema Definition Language (CSDL) JSON Representation Version 4.01:
http://docs.oasis-open.org/odata/odata-csdl-json/v4.01/csprd03/odata-csdl-json-v4.01-csprd03-DIFF.pdf

– OData JSON Format Version 4.01:
http://docs.oasis-open.org/odata/odata-json-format/v4.01/csprd04/odata-json-format-v4.01-csprd04-DIFF.pdf

[4] http://www.oasis-open.org/policies-guidelines/ipr

[5] http://www.oasis-open.org/committees/odata/ipr.php
https://www.oasis-open.org/policies-guidelines/ipr#RF-on-RAND-Mode
RF on RAND Mode