Invitation to comment on four OData v4.02 specification drafts
First public review for Version 4.02 specifications - ends May 8th
OASIS and the OASIS Open Data Protocol (OData) TC [1] are pleased to announce that OData Version 4.02, OData Common Schema Definition Language (CSDL) XML Representation Version 4.02, OData Common Schema Definition Language (CSDL) JSON Representation Version 4.02, and OData JSON Format Version 4.02 are now available for public review and comment.
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.02: This document defines the core semantics and facilities of the protocol.
– OData Common Schema Definition Language (CSDL) XML Representation Version 4.02: 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.02: This document specifically defines the JSON representation of CSDL.
– OData JSON Format Version 4.02: 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.02
Committee Specification Draft 01
28 February 2024
— OData Version 4.02. Part 1: Protocol
Editable source (Authoritative):
https://docs.oasis-open.org/odata/odata/v4.02/csd01/part1-protocol/odata-v4.02-csd01-part1-protocol.md
HTML:
https://docs.oasis-open.org/odata/odata/v4.02/csd01/part1-protocol/odata-v4.02-csd01-part1-protocol.html
PDF:
https://docs.oasis-open.org/odata/odata/v4.02/csd01/part1-protocol/odata-v4.02-csd01-part1-protocol.pdf
— OData Version 4.02. Part 2: URL Conventions
Editable source (Authoritative):
https://docs.oasis-open.org/odata/odata/v4.02/csd01/part2-url-conventions/odata-v4.02-csd01-part2-url-conventions.md
HTML:
https://docs.oasis-open.org/odata/odata/v4.02/csd01/part2-url-conventions/odata-v4.02-csd01-part2-url-conventions.html
PDF:
https://docs.oasis-open.org/odata/odata/v4.02/csd01/part2-url-conventions/odata-v4.02-csd01-part2-url-conventions.pdf
— OData Version 4.02. ABNF components:
https://docs.oasis-open.org/odata/odata/v4.02/csd01/abnf/
OData Common Schema Definition Language (CSDL) XML Representation Version 4.02
Committee Specification Draft 01
28 February 2024
Editable source (Authoritative):
https://docs.oasis-open.org/odata/odata-csdl-xml/v4.02/csd01/odata-csdl-xml-v4.02-csd01.md
HTML:
https://docs.oasis-open.org/odata/odata-csdl-xml/v4.02/csd01/odata-csdl-xml-v4.02-csd01.html
PDF:
https://docs.oasis-open.org/odata/odata-csdl-xml/v4.02/csd01/odata-csdl-xml-v4.02-csd01.pdf
XML schemas:
https://docs.oasis-open.org/odata/odata-csdl-xml/v4.02/csd01/schemas/
OData Common Schema Definition Language (CSDL) JSON Representation Version 4.02
Committee Specification Draft 01
28 February 2024
Editable source (Authoritative):
https://docs.oasis-open.org/odata/odata-csdl-json/v4.02/csd01/odata-csdl-json-v4.02-csd01.md
HTML:
https://docs.oasis-open.org/odata/odata-csdl-json/v4.02/csd01/odata-csdl-json-v4.02-csd01.html
PDF:
https://docs.oasis-open.org/odata/odata-csdl-json/v4.02/csd01/odata-csdl-json-v4.02-csd01.pdf
JSON schemas:
https://docs.oasis-open.org/odata/odata-csdl-json/v4.02/csd01/schemas/
OData JSON Format Version 4.02
Committee Specification Draft 01
28 February 2024
Editable source (Authoritative):
https://docs.oasis-open.org/odata/odata-json-format/v4.02/csd01/odata-json-format-v4.02-csd01.md
HTML:
https://docs.oasis-open.org/odata/odata-json-format/v4.02/csd01/odata-json-format-v4.02-csd01.html
PDF:
https://docs.oasis-open.org/odata/odata-json-format/v4.02/csd01/odata-json-format-v4.02-csd01.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.02:
https://docs.oasis-open.org/odata/odata/v4.02/csd01/odata-v4.02-csd01.zip
OData Common Schema Definition Language (CSDL) XML Representation Version 4.02:
https://docs.oasis-open.org/odata/odata-csdl-xml/v4.02/csd01/odata-csdl-xml-v4.02-csd01.zip
OData Common Schema Definition Language (CSDL) JSON Representation Version 4.02:
https://docs.oasis-open.org/odata/odata-csdl-json/v4.02/csd01/odata-csdl-json-v4.02-csd01.zip
OData JSON Format Version 4.02:
https://docs.oasis-open.org/odata/odata-json-format/v4.02/csd01/odata-json-format-v4.02-csd01.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 09 April 2024 at 00:00 UTC and ends 08 May 2024 at 11:59 UTC.
Comments may be submitted to the TC by any person directly at:
Technical-Committee-Comments@oasis-open.org
Comments submitted by for this work and for other work of this TC are publicly archived and can be viewed at:
https://groups.google.com/a/oasis-open.org/g/technical-committee-comments/.
Previous comments on OData works are archived at https://lists.oasis-open.org/archives/odata-comment/.
All comments submitted to OASIS are subject to the OASIS Feedback License [2], 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 [3] applicable especially [4] 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 information about these specifications and the OData TC may be found on the TC’s public home page.
========== Additional references:
[1] OASIS Open Data Protocol (OData) TC
https://groups.oasis-open.org/communities/tc-community-home2?CommunityKey=e7cac2a9-2d18-4640-b94d-018dc7d3f0e2
https://www.oasis-open.org/committees/odata/
Approval (four specifications): https://github.com/oasis-tcs/odata-specs/blob/256d65b9f5f6fa5c3f6c3caa341947e6c711fb8c/zip/Minutes%20of%202024-02-28%20Meeting%20%23463.md
[2] OASIS Feedback License:
https://www.oasis-open.org/who/ipr/feedback_license.pdf
[3] https://www.oasis-open.org/policies-guidelines/ipr/
[4] 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