RE: [odata] Five new OData specs open to public review - ends Feb. 16th

The public review of these documents ended on 16 February 2017 at 23:59 UTC.

 

We received no comments on the documents.

 

Ralf Handl

OData TC Co-Chair

 

From:  [mailto:]
On Behalf Of Chet Ensign

Sent: Mittwoch, 18. Januar 2017 17:22

To: ; ; ; 

Subject: [odata] Five new OData specs open to public review - ends Feb. 16th

 

OASIS members and other interested parties, 

 

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/odata-v4.01-csprd01-part1-protocol.docx

 

HTML: 

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

 

PDF: 

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

 

-- OData Version 4.01. Part 2: URL Conventions

 

Editable source (Authoritative):

http://docs.oasis-open.org/odata/odata/v4.01/csprd01/part2-url-conventions/odata-v4.01-csprd01-part2-url-conventions.docx

 

HTML: 

http://docs.oasis-open.org/odata/odata/v4.01/csprd01/part2-url-conventions/odata-v4.01-csprd01-part2-url-conventions.html

 

PDF:

http://docs.oasis-open.org/odata/odata/v4.01/csprd01/part2-url-conventions/odata-v4.01-csprd01-part2-url-conventions.pdf

 

-- 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.01-csprd01-part3-csdl.docx

 

HTML:

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

 

PDF: 

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

 

-- 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-vocabularies-v4.0-csprd01.docx

 

HTML: 

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

 

PDF: 

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

 

- OData JSON Format Version 4.01 

 

Editable source (Authoritative):

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

 

HTML:

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

 

PDF:

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

 

- 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-xml-v4.01-csprd01.docx

 

HTML:

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

 

PDF:

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

 

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-openapi-v1.0-cnprd01.docx

 

HTML:

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

 

PDF:

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

 

 

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.zip

 

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

 

- 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-xml-v4.01-csprd01.zip 

 

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

 

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

 

-- 

/chet 

----------------

Chet Ensign

Director of Standards Development and TC Administration 

OASIS: Advancing open standards for the information society

http://www.oasis-open.org

Primary: +1 973-996-2298

Mobile: +1 201-341-1393