Five new #OData specs open to public review - ends Feb. 16th

The OASIS Open Data Protocol (OData) TC [1] members have recently approved 4 Committee Specification Drafts (CSD) and 1 Committee Note and submitted these for 30-day public review:

OData Version 4.01
Committee Specification Draft 01 / Public Review Draft 01
08 December 2016

OData Vocabularies Version 4.0
Committee Specification Draft 01 / Public Review Draft 01
08 December 2016

OData JSON Format Version 4.01
Committee Specification Draft 01 / Public Review Draft 01
08 December 2016

OData Common Schema Definition Language (CSDL) XML Representation Version 4.01
Committee Specification Draft 01 / Public Review Draft 01
08 December 2016

OData to OpenAPI Mapping Version 1.0
Committee Note Draft 01 / Public Review Draft 01
15 December 2016

What are these new OData documents and why are they useful?

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.

- OData V4.01 is a 3-part specification that defines the core semantics and facilities of the protocol.

- OData Vocabularies V4.0 is a new specification that describes the evolving set of OData vocabularies maintained by the Technical Committee at https://github.com/oasis-tcs/odata-vocabularies.

- OData JSON Format V4.01 extends the core specification by defining representations for OData requests and responses using a JSON format.

- 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. OData Common Schema Definition Language (CSDL) XML Representation V4.01 specifically defines the XML representation of the entity data model.

- The OpenAPI Specification (OAS) is a standard, language-agnostic interface to REST APIs which allows both humans and computers to discover and understand the capabilities of the service. OData to OpenAPI Mapping Version 1.0 describes a possible mapping of OData service descriptions to OAS documents.

Public Review Period:

The public review starts 19 January 2017 at 00:00 UTC and ends 16 February 2017 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.

URIs:

The prose specification document and related files are available here:

- OData Version 4.01

-- OData Version 4.01. Part 1: Protocol

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

HTML:
http://docs.oasis-open.org/odata/odata/v4.01/csprd01/part1-protocol/odat...

PDF:
http://docs.oasis-open.org/odata/odata/v4.01/csprd01/part1-protocol/odat...

-- OData Version 4.01. Part 2: URL Conventions

Editable source (Authoritative):
http://docs.oasis-open.org/odata/odata/v4.01/csprd01/part2-url-conventio...

HTML:
http://docs.oasis-open.org/odata/odata/v4.01/csprd01/part2-url-conventio...

PDF:
http://docs.oasis-open.org/odata/odata/v4.01/csprd01/part2-url-conventio...

-- OData Version 4.01. Part 3: Common Schema Definition Language (CSDL)

Editable source (Authoritative):
http://docs.oasis-open.org/odata/odata/v4.01/csprd01/part3-csdl/odata-v4...

HTML:
http://docs.oasis-open.org/odata/odata/v4.01/csprd01/part3-csdl/odata-v4...

PDF:
http://docs.oasis-open.org/odata/odata/v4.01/csprd01/part3-csdl/odata-v4...

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

- OData Vocabularies Version 4.0

Editable source (Authoritative):
http://docs.oasis-open.org/odata/odata-vocabularies/v4.0/csprd01/odata-v...

HTML:
http://docs.oasis-open.org/odata/odata-vocabularies/v4.0/csprd01/odata-v...

PDF:
http://docs.oasis-open.org/odata/odata-vocabularies/v4.0/csprd01/odata-v...

- OData JSON Format Version 4.01

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

HTML:
http://docs.oasis-open.org/odata/odata-json-format/v4.01/csprd01/odata-j...

PDF:
http://docs.oasis-open.org/odata/odata-json-format/v4.01/csprd01/odata-j...

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

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

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

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

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

- OData to OpenAPI Mapping Version 1.0

Editable source (Authoritative):
http://docs.oasis-open.org/odata/odata-openapi/v1.0/cnprd01/odata-openap...

HTML:
http://docs.oasis-open.org/odata/odata-openapi/v1.0/cnprd01/odata-openap...

PDF:
http://docs.oasis-open.org/odata/odata-openapi/v1.0/cnprd01/odata-openap...

ZIP distribution file (complete):

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

- OData V4.01: http://docs.oasis-open.org/odata/odata/v4.01/csprd01/odata-v4.01-csprd01...

- OData Vocabularies Version 4.0: http://docs.oasis-open.org/odata/odata-vocabularies/v4.0/csprd01/odata-v...

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

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

- OData to OpenAPI Mapping Version 1.0: http://docs.oasis-open.org/odata/odata-openapi/v1.0/cnprd01/odata-openap...

Additional information about the specifications and the 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 which can be used by following the instructions on the TC's "Send A Comment" page, or directly 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 these OData specifications, we call your attention to the OASIS IPR Policy [2] applicable especially [3] 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
https://www.oasis-open.org/committees/odata/

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

[3] 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

Associated TC: 
Open Data Protocol (OData)