Project news

15-day Public Review for OData, OData Atom Format and OData JSON Format, V4.0 (#OData)

[NOTE: This public review replaces the public review announced 03 July 2013 in https://lists.oasis-open.org/archives/members/201307/msg00000.html. Note new review dates below.]

The OASIS Open Data Protocol (OData) TC [1] members have recently approved three Committee Specification Drafts (CSDs) and submitted them for 15-day public review:

OData Version 4.0
Committee Specification Draft 02 / Public Review Draft 02
24 June 2013

OData Atom Format Version 4.0
Committee Specification Draft 02 / Public Review Draft 02
24 June 2013

OData JSON Format Version 4.0
Committee Specification Draft 02 / Public Review Draft 02
24 June 2013

Specification Overview:

The Open Data Protocol (OData) enables the creation of REST-based data services, which allow resources, identified using Uniform Resource Identifiers (URIs) and defined in an Entity Data Model (EDM), to be published and edited by Web clients using simple HTTP messages. OData version 4.0 defines the core semantics and facilities of the protocol, a set of recommended (but not required) rules for constructing URLs to identify the data and metadata exposed by an OData service as well as a set of reserved URL query string operators, an Entity Data Model (EDM), and an XML representation of the entity data model exposed by an OData service.

OData Atom Format version 4.0 extends the former by defining representations for OData requests and responses using an Atom format.

OData JSON Format version 4.0 extends the former by defining representations for OData requests and responses using a JSON format.

TC Description:

The OASIS OData TC works to simplify the querying and sharing of data across disparate applications and multiple stakeholders for re-use in the enterprise, Cloud, and mobile devices. A REST-based protocol, OData builds on HTTP, AtomPub, and JSON using URIs to address and access data feed resources. It enables information to be accessed from a variety of sources including (but not limited to) relational databases, file systems, content management systems, and traditional Web sites. OData provides a way to break down data silos and increase the shared value of data by creating an ecosystem in which data consumers can interoperate with data producers in a way that is far more powerful than currently possible, enabling more applications to make sense of a broader set of data. Every producer and consumer of data that participates in this ecosystem increases its overall value.

Public Review Period:

The public review starts 09 July 2013 at 00:00 GMT and ends 24 July 2013 at 23:59 GMT. The specification was previously submitted for public review [2]. This 15-day review is limited in scope to changes made from the previous review. Changes are highlighted in the diff-marked PDF files for each part of the specification [3].

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.

URIs:

The prose specification documents and related files are available here:

– OData Version 4.0

OData Version 4.0 is a multi-part Work Product consisting of:

— OData Version 4.0 Part 1: Protocol.

Editable Source (Authoritative):
http://docs.oasis-open.org/odata/odata/v4.0/csprd02/part1-protocol/odata-v4.0-csprd02-part1-protocol.doc

HTML:
http://docs.oasis-open.org/odata/odata/v4.0/csprd02/part1-protocol/odata-v4.0-csprd02-part1-protocol.html

PDF:
http://docs.oasis-open.org/odata/odata/v4.0/csprd02/part1-protocol/odata-v4.0-csprd02-part1-protocol.pdf

— OData Version 4.0 Part 2: URL Conventions.

Editable Source (Authoritative):
http://docs.oasis-open.org/odata/odata/v4.0/csprd02/part2-url-conventions/odata-v4.0-csprd02-part2-url-conventions.doc

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

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

— OData Version 4.0 Part 3: Common Schema Definition Language (CSDL).

Editable Source (Authoritative):
http://docs.oasis-open.org/odata/odata/v4.0/csprd02/part3-csdl/odata-v4.0-csprd02-part3-csdl.doc

HTML:
http://docs.oasis-open.org/odata/odata/v4.0/csprd02/part3-csdl/odata-v4.0-csprd02-part3-csdl.html

PDF:
http://docs.oasis-open.org/odata/odata/v4.0/csprd02/part3-csdl/odata-v4.0-csprd02-part3-csdl.pdf

— ABNF components – OData ABNF Construction Rules Version 4.0 and OData ABNF Test Cases:
http://docs.oasis-open.org/odata/odata/v4.0/csprd02/abnf/

— OData Metadata Service Entity Model:
http://docs.oasis-open.org/odata/odata/v4.0/csprd02/models/MetadataService.edmx

— Vocabulary components – OData Core Vocabulary, OData Measures Vocabulary and OData Capabilities Vocabulary:
http://docs.oasis-open.org/odata/odata/v4.0/csprd02/vocabularies/

— XML schemas – OData EDMX XML Schema and OData EDM XML Schema:
http://docs.oasis-open.org/odata/odata/v4.0/csprd02/schemas/

– OData Atom Format Version 4.0

Editable Source (Authoritative):
http://docs.oasis-open.org/odata/odata-atom-format/v4.0/csprd02/odata-atom-format-v4.0-csprd02.doc

HTML:
http://docs.oasis-open.org/odata/odata-atom-format/v4.0/csprd02/odata-atom-format-v4.0-csprd02.html

PDF:
http://docs.oasis-open.org/odata/odata-atom-format/v4.0/csprd02/odata-atom-format-v4.0-csprd02.pdf

OData Metadata XML Schema:
http://docs.oasis-open.org/odata/odata-atom-format/v4.0/csprd02/schemas/metadata.xsd

OData Atom Vocabulary:
http://docs.oasis-open.org/odata/odata-atom-format/v4.0/csprd02/vocabularies/Org.OData.Atom.V1.xml

– OData JSON Format Version 4.0

Editable Source (Authoritative):
http://docs.oasis-open.org/odata/odata-json-format/v4.0/csprd02/odata-json-format-v4.0-csprd02.doc

HTML:
http://docs.oasis-open.org/odata/odata-json-format/v4.0/csprd02/odata-json-format-v4.0-csprd02.html

PDF:
http://docs.oasis-open.org/odata/odata-json-format/v4.0/csprd02/odata-json-format-v4.0-csprd02.pdf

ZIP distribution file (complete):

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

– OData Version 4.0:
http://docs.oasis-open.org/odata/odata/v4.0/csprd02/odata-v4.0-csprd02.zip

– OData Atom Format Version 4.0:
http://docs.oasis-open.org/odata/odata-atom-format/v4.0/csprd02/odata-atom-format-v4.0-csprd02.zip

– OData JSON Format Version 4.0:
http://docs.oasis-open.org/odata/odata-json-format/v4.0/csprd02/odata-json-format-v4.0-csprd02.zip

Additional information about the specifications and the OASIS Open Data Protocol (OData) TC can 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 by following the instructions located via the button labeled “Send A Comment” at the top of the TC public home which can also be found at:

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

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

https://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, OData Atom Format and OData JSON Format, Versions 4.0”, 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 references:

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

[2] Previous public reviews:
– 30-day public review 02 May 2013: https://lists.oasis-open.org/archives/tc-announce/201305/msg00002.html

[3] Red-lined DIFF files:

– Part 1 Protocol: http://docs.oasis-open.org/odata/odata/v4.0/csprd02/part1-protocol/odata-v4.0-csprd02-part1-protocol-DIFF.pdf
– Part 2 URL Conventions: http://docs.oasis-open.org/odata/odata/v4.0/csprd02/part2-url-conventions/odata-v4.0-csprd02-part2-url-conventions-DIFF.pdf
– Part 3 Common Schema Definition Language (CSDL): http://docs.oasis-open.org/odata/odata/v4.0/csprd02/part3-csdl/odata-v4.0-csprd02-part3-csdl-DIFF.pdf

[4] http://www.oasis-open.org/who/intellectualproperty.php

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