Four OData specifications approved as Committee Specifications

6 Dec 2019

OASIS is pleased to announce that 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 from the OASIS Open Data Protocol (OData) TC [1] have been approved as OASIS Committee Specifications.

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 Committee Specifications announced 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.

These Committee Specifications are OASIS deliverables, completed and approved by the TC and fully ready for testing and implementation.

The prose specifications and related files are available here:

– OData Version 4.01
Committee Specification 02
14 November 2019

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

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

OData Common Schema Definition Language (CSDL) XML Representation Version 4.01
Committee Specification 02
14 November 2019

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

OData Common Schema Definition Language (CSDL) JSON Representation Version 4.01
Committee Specification 02
14 November 2019

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

OData JSON Format Version 4.01
Committee Specification 02
14 November 2019

Editable source (Authoritative):
https://docs.oasis-open.org/odata/odata-json-format/v4.01/cs02/odata-json-format-v4.01-cs02.docx
HTML:
https://docs.oasis-open.org/odata/odata-json-format/v4.01/cs02/odata-json-format-v4.01-cs02.html
PDF:
https://docs.oasis-open.org/odata/odata-json-format/v4.01/cs02/odata-json-format-v4.01-cs02.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/cs02/odata-v4.01-cs02.zip
– OData Common Schema Definition Language (CSDL) XML Representation Version 4.01:
https://docs.oasis-open.org/odata/odata-csdl-xml/v4.01/cs02/odata-csdl-xml-v4.01-cs02.zip
– OData Common Schema Definition Language (CSDL) JSON Representation Version 4.01:
https://docs.oasis-open.org/odata/odata-csdl-json/v4.01/cs02/odata-csdl-json-v4.01-cs02.zip
– OData JSON Format Version 4.01:
https://docs.oasis-open.org/odata/odata-json-format/v4.01/cs02/odata-json-format-v4.01-cs02.zip

Members of the OData TC [1] approved this specification by Special Majority Vote. The specification had been released for public review as required by the TC Process [2]. The vote to approve as a Committee Specification passed [3], and the document is now available online in the OASIS Library as referenced above.

Our congratulations to the TC on achieving this milestone and our thanks to the reviewers who provided feedback on the specification drafts to help improve the quality of the work.

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

[2] 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:
https://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:
https://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:
https://docs.oasis-open.org/odata/odata/v4.01/csprd03/odata-v4.01-csprd03-comment-resolution-log.xlsx
* 15-day public review, 04 December 2017:
https://lists.oasis-open.org/archives/members/201712/msg00000.html
– Comment resolution log:
https://docs.oasis-open.org/odata/odata/v4.01/csprd04/odata-v4.01-csprd04-comment-resolution-log.txt
* 15-day public review, 26 July 2019:
https://lists.oasis-open.org/archives/members/201907/msg00008.html
– Comment resolution log:
https://docs.oasis-open.org/odata/odata/v4.01/csprd05/odata-v4.01-csprd05-comment-resolution-log.txt
* 15-day public review, 18 October 2019:
https://lists.oasis-open.org/archives/odata/201910/msg00019.html
– Comment resolution log:
https://docs.oasis-open.org/odata/odata/v4.01/csprd06/odata-v4.01-csprd06-comment-resolution-log.txt