Project news

60-day Public Review for four #OData Candidate OASIS Standards – ends April 7th 2020

Members of the OASIS Open Data Protocol (OData) TC [1] have recently approved a Special Majority Ballot [2] to advance OData v4.01, OData Common Schema Definition Language (CSDL) XML Representation v4.01, OData Common Schema Definition Language (CSDL) JSON Representation v4.01, and OData JSON Format v4.01 as Candidate OASIS Standards (COS). These COS now enter a 60-day public review period in preparation for a member ballot to consider their approval as OASIS Standards.

OData Overview:
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 Candidate OASIS Standards announced today are:

– OData Version 4.01
This two-part specification 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.

Three Statements of Use were received from IBM, Microsoft, and SAP [3].

Public Review Period:
The 60-day public review starts 08 February 2020 at 00:00 UTC and ends 07 April 2020 at 23:59 UTC.

This is an open invitation to comment. OASIS solicits 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.

The prose specification documents and related files are available here:

– OData Version 4.01
Candidate OASIS Standard 01
28 January 2020

OData Version 4.01. Part 1: Protocol
Editable source (Authoritative):
https://docs.oasis-open.org/odata/odata/v4.01/cos01/part1-protocol/odata-v4.01-cos01-part1-protocol.docx
HTML:
https://docs.oasis-open.org/odata/odata/v4.01/cos01/part1-protocol/odata-v4.01-cos01-part1-protocol.html
PDF:
https://docs.oasis-open.org/odata/odata/v4.01/cos01/part1-protocol/odata-v4.01-cos01-part1-protocol.pdf

OData Version 4.01. Part 2: URL Conventions
Editable source (Authoritative):
https://docs.oasis-open.org/odata/odata/v4.01/cos01/part2-url-conventions/odata-v4.01-cos01-part2-url-conventions.docx
HTML:
https://docs.oasis-open.org/odata/odata/v4.01/cos01/part2-url-conventions/odata-v4.01-cos01-part2-url-conventions.html
PDF:
https://docs.oasis-open.org/odata/odata/v4.01/cos01/part2-url-conventions/odata-v4.01-cos01-part2-url-conventions.pdf
ABNF components:
https://docs.oasis-open.org/odata/odata/v4.01/cos01/abnf/

OData Common Schema Definition Language (CSDL) XML Representation Version 4.01
Candidate OASIS Standard 01
28 January 2020

Editable source (Authoritative):
https://docs.oasis-open.org/odata/odata-csdl-xml/v4.01/cos01/odata-csdl-xml-v4.01-cos01.docx
HTML:
https://docs.oasis-open.org/odata/odata-csdl-xml/v4.01/cos01/odata-csdl-xml-v4.01-cos01.html
PDF:
https://docs.oasis-open.org/odata/odata-csdl-xml/v4.01/cos01/odata-csdl-xml-v4.01-cos01.pdf
XML schemas:
https://docs.oasis-open.org/odata/odata-csdl-xml/v4.01/cos01/schemas/

OData Common Schema Definition Language (CSDL) JSON Representation Version 4.01
Candidate OASIS Standard 01
28 January 2020

Editable source (Authoritative):
https://docs.oasis-open.org/odata/odata-csdl-json/v4.01/cos01/odata-csdl-json-v4.01-cos01.docx
HTML:
https://docs.oasis-open.org/odata/odata-csdl-json/v4.01/cos01/odata-csdl-json-v4.01-cos01.html
PDF:
https://docs.oasis-open.org/odata/odata-csdl-json/v4.01/cos01/odata-csdl-json-v4.01-cos01.pdf
JSON schemas:
https://docs.oasis-open.org/odata/odata-csdl-json/v4.01/cos01/schemas/

OData JSON Format Version 4.01
Candidate OASIS Standard 01
28 January 2020

Editable source (Authoritative):
https://docs.oasis-open.org/odata/odata-json-format/v4.01/cos01/odata-json-format-v4.01-cos01.docx
HTML:
https://docs.oasis-open.org/odata/odata-json-format/v4.01/cos01/odata-json-format-v4.01-cos01.html
PDF:
https://docs.oasis-open.org/odata/odata-json-format/v4.01/cos01/odata-json-format-v4.01-cos01.pdf

Distribution ZIP files:
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 files here:
– OData Version 4.01:
https://docs.oasis-open.org/odata/odata/v4.01/cos01/odata-v4.01-cos01.zip
– OData Common Schema Definition Language (CSDL) XML Representation Version 4.01:
https://docs.oasis-open.org/odata/odata-csdl-xml/v4.01/cos01/odata-csdl-xml-v4.01-cos01.zip
– OData Common Schema Definition Language (CSDL) JSON Representation Version 4.01:
https://docs.oasis-open.org/odata/odata-csdl-json/v4.01/cos01/odata-csdl-json-v4.01-cos01.zip
– OData JSON Format Version 4.01:
https://docs.oasis-open.org/odata/odata-json-format/v4.01/cos01/odata-json-format-v4.01-cos01.zip

Additional information about the specifications and the OData TC may be found at the TC’s public home page:
https://www.oasis-open.org/committees/odata/

Comments may be submitted to the TC by any person through the use of the OASIS TC Comment Facility as explained in the instructions located via the button labeled “Send A Comment” at the top of the TC public home page, or directly at:
https://www.oasis-open.org/committees/comments/index.php?wg_abbrev=odata

Comments submitted by TC non-members for these works and for other work of this TC are 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 this public review of OData v4.01, OData Common Schema Definition Language (CSDL) XML Representation v4.01, OData Common Schema Definition Language (CSDL) JSON Representation v4.01, and OData JSON Format v4.01, 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 specifications, so that notice of them may be posted to the notice page for this TC’s work.

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

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

[2] Approval ballot:
https://www.oasis-open.org/committees/ballot.php?id=3469

[3] Statements of Use:
– IBM:
https://www.oasis-open.org/apps/org/workgroup/odata/email/archives/202001/msg00005.html
– Microsoft:
https://www.oasis-open.org/apps/org/workgroup/odata/email/archives/201911/msg00044.html
– SAP:
https://www.oasis-open.org/apps/org/workgroup/odata/email/archives/201911/msg00037.html

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

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