ࡱ > ] ` X Y Z [ \ bjbj>> pl pT pT y j 8) 8) 8) 8) 8) $ \) \) \) P ) + \) Ƥ 0 x? d ? ? ? A J ZL D O E G G G G G G $ f @ k 8) BQ A A BQ BQ k 8) 8) ? ? 4 f f f BQ 2 8) ? 8) ? E f BQ E f f t њ ? j tb b } > 1 0 Ƥ X d X | њ њ X 8) x BQ BQ f BQ BQ BQ BQ BQ k k f BQ BQ BQ Ƥ BQ BQ BQ BQ X BQ BQ BQ BQ BQ BQ BQ BQ BQ ' : HYPERLINK "https://www.oasis-open.org/"
OData Version 4.0 Errata 03
OASIS Approved Errata
02 June 2016
Specification URIs
This version:
HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/odata-v4.0-errata03-os.doc" http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/odata-v4.0-errata03-os.doc (Authoritative)
HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/odata-v4.0-errata03-os.html" http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/odata-v4.0-errata03-os.html
HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/odata-v4.0-errata03-os.pdf" http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/odata-v4.0-errata03-os.pdf
Previous version:
HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/errata03/csprd01/odata-v4.0-errata03-csprd01.doc" http://docs.oasis-open.org/odata/odata/v4.0/errata03/csprd01/odata-v4.0-errata03-csprd01.doc (Authoritative)
HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/errata03/csprd01/odata-v4.0-errata03-csprd01.html" http://docs.oasis-open.org/odata/odata/v4.0/errata03/csprd01/odata-v4.0-errata03-csprd01.html
HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/errata03/csprd01/odata-v4.0-errata03-csprd01.pdf" http://docs.oasis-open.org/odata/odata/v4.0/errata03/csprd01/odata-v4.0-errata03-csprd01.pdf
Latest version:
HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/errata03/odata-v4.0-errata03.doc"http://docs.oasis-open.org/odata/odata/v4.0/errata03/odata-v4.0-errata03.doc (Authoritative)
HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/errata03/odata-v4.0-errata03.html"http://docs.oasis-open.org/odata/odata/v4.0/errata03/odata-v4.0-errata03.html
HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/errata03/odata-v4.0-errata03.pdf"http://docs.oasis-open.org/odata/odata/v4.0/errata03/odata-v4.0-errata03.pdf
Technical Committee:
HYPERLINK "https://www.oasis-open.org/committees/odata/"OASIS Open Data Protocol (OData) TC
Chairs:
Ralf Handl ( HYPERLINK "mailto:ralf.handl@sap.com" ralf.handl@sap.com), HYPERLINK "http://www.sap.com/"SAP SE
Ram Jeyaraman ( HYPERLINK "mailto:Ram.Jeyaraman@microsoft.com" Ram.Jeyaraman@microsoft.com), HYPERLINK "http://www.microsoft.com/" Microsoft
Editors:
Michael Pizzo ( HYPERLINK "mailto:mikep@microsoft.com" mikep@microsoft.com), HYPERLINK "http://www.microsoft.com/" Microsoft
Ralf Handl ( HYPERLINK "mailto:ralf.handl@sap.com" ralf.handl@sap.com), HYPERLINK "http://www.sap.com/"SAP SE
Martin Zurmuehl ( HYPERLINK "mailto:martin.zurmuehl@sap.com" martin.zurmuehl@sap.com), HYPERLINK "http://www.sap.com/"SAP SE
Hubert Heijkers (HYPERLINK "mailto:hubert.heijkers@nl.ibm.com"hubert.heijkers@nl.ibm.com), HYPERLINK "http://www.ibm.com" IBM
Additional artifacts:
This prose specification is one component of a Work Product that also includes:
OData Version 4.0. Part 1: Protocol Plus Errata 03. Edited by Michael Pizzo, Ralf Handl, and Martin Zurmuehl. 02 June 2016. OASIS Standard incorporating Approved Errata 03. HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/complete/part1-protocol/odata-v4.0-errata03-os-part1-protocol-complete.html" http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/complete/part1-protocol/odata-v4.0-errata03-os-part1-protocol-complete.html.
OData Version 4.0. Part 2: URL Conventions Plus Errata 03. Edited by Michael Pizzo, Ralf Handl, and Martin Zurmuehl. 02 June 2016. OASIS Standard incorporating Approved Errata 03. HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/complete/part2-url-conventions/odata-v4.0-errata03-os-part2-url-conventions-complete.html" http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/complete/part2-url-conventions/odata-v4.0-errata03-os-part2-url-conventions-complete.html.
OData Version 4.0. Part 3: Common Schema Definition Language (CSDL) Plus Errata 03. Edited by Michael Pizzo, Ralf Handl, and Martin Zurmuehl. 02 June 2016. OASIS Standard incorporating Approved Errata 03. HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/complete/part3-csdl/odata-v4.0-errata03-os-part3-csdl-complete.html" http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/complete/part3-csdl/odata-v4.0-errata03-os-part3-csdl-complete.html.
ABNF components: OData ABNF Construction Rules Version 4.0 and OData ABNF Test Cases. HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/complete/abnf/" http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/complete/abnf/.
Vocabulary components: OData Core Vocabulary, OData Measures Vocabulary and OData Capabilities Vocabulary. HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/complete/vocabularies/" http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/complete/vocabularies/.
XML schemas: OData EDMX XML Schema and OData EDM XML Schema. HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/complete/schemas/" http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/complete/schemas/.
OData Metadata Service Entity Model: HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/complete/models/" http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/complete/models/.
Change-marked (redlined) versions of OData Version 4.0 Part 1, Part 2, and Part 3. OASIS Standard incorporating Approved Errata 03. HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/redlined/" http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/redlined/.
Related work:
This specification lists Errata for:
OData Version 4.0, a multi-part Work Product which includes:
OData Version 4.0. Part 1: Protocol. 24 February 2014. HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/os/part1-protocol/odata-v4.0-os-part1-protocol.html" http://docs.oasis-open.org/odata/odata/v4.0/os/part1-protocol/odata-v4.0-os-part1-protocol.html.
OData Version 4.0. Part 2: URL Conventions. 24 February 2014. HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/os/part2-url-conventions/odata-v4.0-os-part2-url-conventions.html" http://docs.oasis-open.org/odata/odata/v4.0/os/part2-url-conventions/odata-v4.0-os-part2-url-conventions.html.
OData Version 4.0. Part 3: Common Schema Definition Language (CSDL). 24 February 2014. HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/os/part3-csdl/odata-v4.0-os-part3-csdl.html" http://docs.oasis-open.org/odata/odata/v4.0/os/part3-csdl/odata-v4.0-os-part3-csdl.html.
ABNF components: OData ABNF Construction Rules Version 4.0 and OData ABNF Test Cases. HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/os/abnf/" http://docs.oasis-open.org/odata/odata/v4.0/os/abnf/.
Vocabulary components: OData Core Vocabulary, OData Measures Vocabulary and OData Capabilities Vocabulary. HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/os/vocabularies/" http://docs.oasis-open.org/odata/odata/v4.0/os/vocabularies/.
Schema components: edm.xsd and edmx.xsd. HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/os/schemas/" http://docs.oasis-open.org/odata/odata/v4.0/os/schemas/.
Model components: MetadataService.edmx. HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/os/models/" http://docs.oasis-open.org/odata/odata/v4.0/os/models/.
This specification is related to:
OData Atom Format Version 4.0. Edited by Martin Zurmuehl, Michael Pizzo, and Ralf Handl. Latest version. HYPERLINK "http://docs.oasis-open.org/odata/odata-atom-format/v4.0/odata-atom-format-v4.0.html" http://docs.oasis-open.org/odata/odata-atom-format/v4.0/odata-atom-format-v4.0.html.
OData JSON Format Version 4.0. Edited by Ralf Handl, Michael Pizzo, and Mark Biamonte. Latest version. HYPERLINK "http://docs.oasis-open.org/odata/odata-json-format/v4.0/odata-json-format-v4.0.html" http://docs.oasis-open.org/odata/odata-json-format/v4.0/odata-json-format-v4.0.html.
Abstract:
This document lists Errata for OData Version 4.0.
Status:
This document was last revised or approved by the OASIS Open Data Protocol (OData) TC on the above date. The level of approval is also listed above. Check the Latest version location noted above for possible later revisions of this document. Any other numbered Versions and other technical work produced by the Technical Committee (TC) are listed at HYPERLINK "https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=odata" \l "technical"https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=odata#technical.
TC members should send comments on this specification to the TCs email list. Others should send comments to the TCs public comment list, after subscribing to it by following the instructions at the HYPERLINK "https://www.oasis-open.org/committees/comments/index.php?wg_abbrev=odata"Send A Comment button on the TCs web page at HYPERLINK "https://www.oasis-open.org/committees/odata/"https://www.oasis-open.org/committees/odata/.
For information on whether any patents have been disclosed that may be essential to implementing this specification, and any offers of patent licensing terms, please refer to the Intellectual Property Rights section of the TCs web page (HYPERLINK "https://www.oasis-open.org/committees/odata/ipr.php"https://www.oasis-open.org/committees/odata/ipr.php).
Citation format:
When referencing this specification the following citation format should be used:
[OData-v4.0-errata03]
OData Version 4.0 Errata 03. Edited by Michael Pizzo, Ralf Handl, Martin Zurmuehl, and Hubert Heijkers. 02 June 2016. OASIS Approved Errata. HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/odata-v4.0-errata03-os.html" http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/odata-v4.0-errata03-os.html. Latest version: HYPERLINK "http://docs.oasis-open.org/odata/odata/v4.0/errata03/odata-v4.0-errata03.html" http://docs.oasis-open.org/odata/odata/v4.0/errata03/odata-v4.0-errata03.html.
Notices
Copyright OASIS Open 2016. All Rights Reserved.
All capitalized terms in the following text have the meanings assigned to them in the OASIS Intellectual Property Rights Policy (the "OASIS IPR Policy"). The full HYPERLINK "https://www.oasis-open.org/policies-guidelines/ipr" Policy may be found at the OASIS website.
This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published, and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this section are included on all such copies and derivative works. However, this document itself may not be modified in any way, including by removing the copyright notice or references to OASIS, except as needed for the purpose of developing any document or deliverable produced by an OASIS Technical Committee (in which case the rules applicable to copyrights, as set forth in the OASIS IPR Policy, must be followed) or as required to translate it into languages other than English.
The limited permissions granted above are perpetual and will not be revoked by OASIS or its successors or assigns.
This document and the information contained herein is provided on an "AS IS" basis and OASIS DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY OWNERSHIP RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
OASIS requests that any OASIS Party or any other party that believes it has patent claims that would necessarily be infringed by implementations of this OASIS Committee Specification or OASIS Standard, to notify OASIS TC Administrator and provide an indication of its willingness to grant patent licenses to such patent claims in a manner consistent with the IPR Mode of the OASIS Technical Committee that produced this specification.
OASIS invites any party to contact the OASIS TC Administrator if it is aware of a claim of ownership of any patent claims that would necessarily be infringed by implementations of this specification by a patent holder that is not willing to provide a license to such patent claims in a manner consistent with the IPR Mode of the OASIS Technical Committee that produced this specification. OASIS may include such claims on its website, but disclaims any obligation to do so.
OASIS takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; neither does it represent that it has made any effort to identify any such rights. Information on OASIS' procedures with respect to rights in any document or deliverable produced by an OASIS Technical Committee can be found on the OASIS website. Copies of claims of rights made available for publication and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementers or users of this OASIS Committee Specification or OASIS Standard, can be obtained from the OASIS TC Administrator. OASIS makes no representation that any information or list of intellectual property rights will at any time be complete, or that any claims in such list are, in fact, Essential Claims.
The name "OASIS" is a trademark of HYPERLINK "https://www.oasis-open.org/" OASIS, the owner and developer of this specification, and should be used only to refer to the organization and its official outputs. OASIS welcomes reference to, and implementation and use of, specifications, while reserving the right to enforce its marks against misleading uses. Please see HYPERLINK "https://www.oasis-open.org/policies-guidelines/trademark" https://www.oasis-open.org/policies-guidelines/trademark for above guidance.
Table of Contents
TOC \o "1-3" \h \z \u HYPERLINK \l "_Toc453752080" 1 Introduction PAGEREF _Toc453752080 \h 6
HYPERLINK \l "_Toc453752081" 1.1 Normative References PAGEREF _Toc453752081 \h 6
HYPERLINK \l "_Toc453752082" 2 Part 1: Protocol PAGEREF _Toc453752082 \h 7
HYPERLINK \l "_Toc453752083" 3 Part 2: URL Conventions PAGEREF _Toc453752083 \h 9
HYPERLINK \l "_Toc453752084" 4 Part 3: Common Schema Definition Language PAGEREF _Toc453752084 \h 11
HYPERLINK \l "_Toc453752085" 5 ABNF Construction Rules PAGEREF _Toc453752085 \h 13
HYPERLINK \l "_Toc453752086" 6 ABNF Test Cases PAGEREF _Toc453752086 \h 17
HYPERLINK \l "_Toc453752087" 7 MetadataService.edmx PAGEREF _Toc453752087 \h 21
HYPERLINK \l "_Toc453752088" Appendix A. Acknowledgments PAGEREF _Toc453752088 \h 22
HYPERLINK \l "_Toc453752089" Appendix B. Revision History PAGEREF _Toc453752089 \h 23
Introduction
This document lists the approved changes to the OData Version 4.0 specification and contains one chapter per changed part of the specification.
Additional documents containing the final specification text with these changes applied are also available and linked in section " HYPERLINK \l "AdditionalArtifacts" Additional artifacts" on the title page.
Normative References
[OData-Protocol] OData Version 4.0 Part 1: Protocol. See link in Related work section on cover page.
Part 1: Protocol
SectionIssueCommentAll sections HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-668" 668Replaced ATOM with Atom5.2 Model Versioning HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-769" 769Term was missing in list of model elements6.6 Format Extensibility HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-768" 768Removed superfluous text that was added by broken bookmark7 Formats HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-861" 861, HYPERLINK "https://issues.oasis-open.org/browse/ODATA-913" 913Clarified behavior if no format is explicitly requested HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-768" 768Removed superfluous text that was added by broken bookmark8.1.1 Header Content-Type
HYPERLINK "https://issues.oasis-open.org/browse/ODATA-908" 908Align with RFC7231 HYPERLINK "https://issues.oasis-open.org/browse/ODATA-916" 916Clarify format parameter is significant8.2.1 Header Accept HYPERLINK "https://issues.oasis-open.org/browse/ODATA-916" 916Service should not add format parameter to response8.2.4 Header If-Match HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-766" 766Reference changed from RFC7230 to RFC72328.2.5 Header If-None-Match HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-766" 766Reference changed from RFC7230 to RFC72328.2.8.4 Preference odata.include-annotations HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-788" 788Clarified precedence rules for patterns in the header value HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-774" 774Pattern syntax now covers full annotation syntax8.3.1 Header ETag HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-852" 852Removed leftover fragment from previous edit8.3.3 Header OData-EntityId HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-830" 830Clarified when header is required HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-853" 853Corrected typo9.1.6 Response Code 304 Not Modified HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-766" 766Reference changed from RFC7230 to RFC72319.2.4. Response Code 412 Precondition Failed HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-766" 766Reference changed from RFC7230 to RFC723210.4 Singleton HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-742" 742Adapted non-normative example10.17 Delta Response HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-837" 837Adapted non-normative example11.2 Requesting Data HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-861" 861, HYPERLINK "https://issues.oasis-open.org/browse/ODATA-913" 913Clarified behavior if no format is explicitly requested11.2.3 Requesting the Media Stream of a Media Entity HYPERLINK "https://issues.oasis-open.org/browse/ODATA-882" 882Added missing section.11.2.5.1 System Query Option $select HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-847" 847Clarified use of namespace aliases11.2.5.2.1.1 Expand Option $levels HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-742" 742Adapted non-normative example11.2.6.1.3 Parameter Alias HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-775" 775Clarified use of parameter aliases11.2.6.2 System Query Option $orderby HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-791" 791Clarified sorting of Boolean and Geo values HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-668" 668Corrected typo in non-normative example11.2.8 Requesting Entity References HYPERLINK "https://issues.oasis-open.org/browse/ODATA-882" 882Note that services may return 204 for reference to single valued nav prop whose value is null11.3.1 Delta Links HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-837" 837Clarified use of $deltatoken HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-877" 877Clarified tracking of orphaned entities11.4.2.2 Create Related Entities When Creating an Entity HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-870" 870, HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-794" 794Referenced to relevant related sections instead of incompletely citing them11.4.3 Update an Entity HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-893" 893Clarified when @odata.id and @odata.type are required11.4.6.1 Add a Reference to a Collection-Valued Navigation Property HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-749" 749Clarified behavior when reference already exists11.5.1 Binding an Operation to a Resource HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-790" 790Corrected typo in non-normative example11.5.3.1 Invoking a Function HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-776" 776Clarified rules for function invocation11.5.4.1 Invoking an Action HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-761" 761Clarified rules for Location header HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-765" 765Extended non-normative example11.6 Asynchronous Requests HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-766" 766Corrected reference to RFC723011.7.2 Batch Request Body HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-823" 823Clarified use of Content-Transfer-Encoding header HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-668" 668Corrected non-normative example HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-778" 778Changed non-normative example11.7.3 Change Sets HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-869" 869Clarified placement of Content-ID header11.7.3.1 Referencing New Entities in a Change Set HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-479" 479Clarified use of content-id referencing HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-668" 668Adapted non-normative example11.7.4 Responding to a Batch Request HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-668" 668Corrected non-normative example11.7.5 Asynchronous Batch Requests HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-822" 822Corrected non-normative example13.1 OData Service Conformance Levels HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-668" 668Corrected typo13.1.1 OData Minimal Conformance Level HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-830" 830Clarified use of OData-EntityId headerAppendix A. Acknowledgments HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-767" 767Completed list of contributorsPart 2: URL Conventions
SectionIssueCommentAll sections HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-668" 668Replaced ATOM with Atom1.2 Normative References HYPERLINK "https://issues.oasis-open.org/browse/ODATA-917" 917Copied reference to XML Schema from Part 3 CSDL2 URL Components HYPERLINK "https://issues.oasis-open.org/browse/ODATA-903" 903Clarified precedence of prose specification over ABNF4.3.1 Canonical URL HYPERLINK "https://issues.oasis-open.org/browse/ODATA-755" 755Clarified key representation in canonical URLs5.1 System Query Options HYPERLINK "https://issues.oasis-open.org/browse/ODATA-835" 835Completed list of HTTP verbs5.1.1.2.1 Addition HYPERLINK "https://issues.oasis-open.org/browse/ODATA-917" 917Clarified rules for time-related operands HYPERLINK "https://issues.oasis-open.org/browse/ODATA-784" 784Clarified rules for decimal operands5.1.1.2.2 Subtraction HYPERLINK "https://issues.oasis-open.org/browse/ODATA-917" 917Clarified rules for time-related operands HYPERLINK "https://issues.oasis-open.org/browse/ODATA-784" 784Clarified rules for decimal operands5.1.1.2.4 Multiplication HYPERLINK "https://issues.oasis-open.org/browse/ODATA-777" 777Clarified behavior with duration operand HYPERLINK "https://issues.oasis-open.org/browse/ODATA-784" 784Clarified rules for decimal operands5.1.1.2.5 Division
HYPERLINK "https://issues.oasis-open.org/browse/ODATA-777" 777Clarified behavior with duration operand HYPERLINK "https://issues.oasis-open.org/browse/ODATA-784" 784Clarified rules for decimal operands HYPERLINK "https://issues.oasis-open.org/browse/ODATA-785" 785Clarified rules for integer division5.1.1.2.6 Modulo HYPERLINK "https://issues.oasis-open.org/browse/ODATA-784" 784Clarified rules for decimal operands5.1.1.2.7 Arithmetic Operator Examples HYPERLINK "https://issues.oasis-open.org/browse/ODATA-785" 785Add example for integer division5.1.1.5 String Functions HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-850" 850Added section header 5.1.1.5.4 indexof HYPERLINK "https://issues.oasis-open.org/browse/ODATA-780" 780Clarified result if no occurrence is found5.1.1.5.7 substring HYPERLINK "https://issues.oasis-open.org/browse/ODATA-781" 781Clarified result for edge cases5.1.1.11.2 Complex and Collection Literals HYPERLINK "https://issues.oasis-open.org/browse/ODATA-758" 758Corrected non-normative example5.1.1.15 Numeric Promotion HYPERLINK "https://issues.oasis-open.org/browse/ODATA-785" 785Clarified rules for numeric promotion5.1.2 System Query Option $expand HYPERLINK "https://issues.oasis-open.org/browse/ODATA-793" 793Clarified use of * for complex properties HYPERLINK "https://issues.oasis-open.org/browse/ODATA-892" 892Clarified behavior for dynamic properties HYPERLINK "https://issues.oasis-open.org/browse/ODATA-840" 840Added example HYPERLINK "https://issues.oasis-open.org/browse/ODATA-741" 741Corrected non-normative example5.1.3 System Query Option $select HYPERLINK "https://issues.oasis-open.org/browse/ODATA-891" 891Clarified behavior for dynamic properties5.3 Parameter Aliases HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-775" 775Clarified use of parameter aliasesPart 3: Common Schema Definition Language
SectionIssueCommentAll sections HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-668" 668Replaced ATOM with Atom3.5 Element edmx:IncludeAnnotations HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-742" 742Adapted non-normative example6.2.1 Attribute Nullable HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-803" 803Clarified default and use of Nullable for collections6.2.2 Attribute MaxLength HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-858" 858Clarified meaning of MaxLength for Binary values6.2.3 Attribute Precision HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-668" 668Replaced allowed with significant6.2.4 Attribute Scale HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-789" 789Clarified behavior for Precision equal to Scale HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-801" 801Clarified behavior for of negative Scale6.2.5 Attribute Unicode HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-734" 734Clarified behavior for Unicode=false10.2.2 Attribute Value HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-819" 819Clarified behavior for multiple enumeration members with same value11.1.3 Type Definition Facets HYPERLINK "https://issues.oasis-open.org/browse/ODATA-936" 936Fix typo in Example 2712.2.3 Attribute IsComposable HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-746" 746Clarified allowed subsequent path segments and query options13 Entity Container
HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-742" 742Adapted non-normative example HYPERLINK "https://issues.oasis-open.org/browse/ODATA-931" 931Fix example to use correctly qualified target paths13.1.2 Attribute Extends HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-733" 733Clarified treatment of cycles introduced by Extends14 Vocabulary and Annotation HYPERLINK "https://issues.oasis-open.org/browse/ODATA-912" 912Clarified treatment of unknown and invalid annotations14.1.5 Attribute AppliesTo HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-810" 810Corrected non-normative example14.2.1 Attribute Target HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-865" 865Completed list of possible targets HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-821" 821Clarified targeting of nested properties14.4.6 Expression edm:Duration HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-752" 752Corrected non-normative example14.5.2 Expression edm:AnnotationPath HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-825" 825Clarified traversal of multi-valued properties14.5.3.1.2 Function odata.fillUriTemplate HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-782" 782Changed non-normative example14.5.10 Expression edm:Null HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-880" 880Clarified that edm:Null can be annotated14.5.11 Expression edm:NavigationPropertyPath HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-751" 751Clarified meaning of edm:NavigationPropertyPath and edm:PropertyPath14.5.13 Expression edm:PropertyPath HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-751" 751Clarified meaning of edm:NavigationPropertyPath and edm:PropertyPath15.6 Entity Container HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-832" 832Corrected typo in diagram HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-878" 878Adapted non-normative example16.1 Products and Categories Example HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-742" 742Adapted non-normative exampleABNF Construction Rules
Note: line numbers are for the new Errata03 revision of the document.
Line IssueComment121-124 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-903" 903Type-cast segment after collection of complex type
/ complexColFunctionImportCall [ collectioncomplexColPath ]
/ complexFunctionImportCall [ complexPath ]
/ primitiveColFunctionImportCall [ collectionprimitiveColPath ]
/ primitiveFunctionImportCall [ singleprimitivePath ]126 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-899" 899Type-cast segment after $all
/ '$all' [ "/" qualifiedEntityTypeName ]129-132 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-903" 903Type-cast segment after collection of complex type
collectionNavPath = keyPredicate [ singleNavigation ]
/ collectionPathboundOperation
/ count
/ ref134-137 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-775" 775Parameter aliases in key segment
simpleKey = OPEN ( parameterAlias / keyPropertyValue ) CLOSE
compoundKey = OPEN keyValuePair *( COMMA keyValuePair ) CLOSE
keyValuePair = ( primitiveKeyProperty / keyPropertyAlias ) EQ ( parameterAlias / keyPropertyValue ) 150-168 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-903" 903Type-cast segment after collection of complex type
propertyPath = entityColNavigationProperty [ collectionNavigation ]
/ entityNavigationProperty [ singleNavigation ]
/ complexColProperty [ collectioncomplexColPath ]
/ complexProperty [ complexPath ]
/ primitiveColProperty [ collectionprimitiveColPath ]
/ primitiveProperty [ singleprimitivePath ]
/ streamProperty [ boundOperation ]
collectionprimitiveColPath = count / boundOperation
singleprimitivePath = value / boundOperation
complexColPath = [ "/" qualifiedComplexTypeName ]
[ count / boundOperation ]
complexPath = [ "/" qualifiedComplexTypeName ]
([ "/" propertyPath
/ boundOperation
)]177-184 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-753" 753
HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-903" 903Replaced Func with Function in rule names
Type-cast segment after collection of complex type
boundOperation = "/" ( boundActionCall
/ boundEntityColFunctionCall [ collectionNavigation ]
/ boundEntityFunctionCall [ singleNavigation ]
/ boundComplexColFunctionCall [ collectioncomplexColPath ]
/ boundComplexFunctionCall [ complexPath ]
/ boundPrimitiveColFunctionCall [ collectionprimitiveColPath ]
/ boundPrimitiveFunctionCall [ singleprimitivePath ]
)191-201 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-753" 753Replaced Func with Function in rule names
; The following boundXxxFunctionCall rules have the added restrictions that
; - the function MUST support binding, and
; - the binding parameter type MUST match the type of resource identified by the
; URI immediately preceding (to the left) of the boundXxxFunctionCall, and
; - the functionParameters MUST NOT include the bindingParameter.
boundEntityFunctionCall = namespace "." entityFunction functionParameters
boundEntityColFunctionCall = namespace "." entityColFunction functionParameters
boundComplexFunctionCall = namespace "." complexFunction functionParameters
boundComplexColFunctionCall = namespace "." complexColFunction functionParameters
boundPrimitiveFunctionCall = namespace "." primitiveFunction functionParameters
boundPrimitiveColFunctionCall = namespace "." primitiveColFunction functionParameters239-241 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-793" 793Reserve $deltatoken
systemQueryOption = deltatoken
/ expand
/ filter259-261 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-793" 793Expand * on complex type
expandPath = [ ( qualifiedEntityTypeName / qualifiedComplexTypeName ) "/" ]
*( ( complexProperty / complexColProperty ) "/" [ qualifiedComplexTypeName "/" ] )
( STAR / navigationProperty [ "/" qualifiedEntityTypeName ] )334-335 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-793" 793Reserve $deltatoken
deltatoken = '$deltatoken' EQ 1*( qchar-no-AMP )435-442 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-903" 903Type-cast segment after collection of complex type
propertyPathExpr = ( entityColNavigationProperty [ collectionNavigationExpr ]
/ entityNavigationProperty [ singleNavigationExpr ]
/ complexColProperty [ collectioncomplexColPathExpr ]
/ complexProperty [ complexPathExpr ]
/ primitiveColProperty [ collectionPathExpr ]
/ primitiveProperty [ singleprimitivePathExpr ]
/ streamProperty [ singleprimitivePathExpr ]
)449-469 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-903" 903Type-cast segment after collection of complex type
collectionNavigationExpr = [ "/" qualifiedEntityTypeName ]
([ keyPredicate [ singleNavigationExpr ]
/ collectionPathExpr
)]
singleNavigationExpr = "/" memberExpr
complexColPathExpr = [ "/" qualifiedComplexTypeName ]
[ collectionPathExpr ]
collectionPathExpr = count
/ "/" boundFunctionExpr
/ "/" anyExpr
/ "/" allExpr
complexPathExpr = [ "/" [ qualifiedComplexTypeName ]
([ "/" propertyPathExpr
/ "/" boundFunctionExpr
)]
singleprimitivePathExpr = "/" boundFunctionExpr474-481 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-903" 903Type-cast segment after collection of complex type
functionExpr = namespace "."
( entityColFunction functionExprParameters [ collectionNavigationExpr ]
/ entityFunction functionExprParameters [ singleNavigationExpr ]
/ complexColFunction functionExprParameters [ collectioncomplexColPathExpr ]
/ complexFunction functionExprParameters [ complexPathExpr ]
/ primitiveColFunction functionExprParameters [ collectionPathExpr ]
/ primitiveFunction functionExprParameters [ singleprimitiveExpr ]
)545-547 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-783" 783Allow percent-encoded parentheses
minDateTimeMethodCallExpr = 'mindatetime(' OPEN BWS CLOSE')'
maxDateTimeMethodCallExpr = 'maxdatetime(' OPEN BWS CLOSE')'
nowMethodCallExpr = 'now(' OPEN BWS CLOSE')'1020-1025 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-774" 774Qualifier for annotations missing:
annotationIdentifier = [ excludeOperator ]
( STAR
/ namespace "." ( termName / STAR )
)
[ "#" odataIdentifier ]
excludeOperator = "-"ABNF Test Cases
Note: line numbers are for the new Errata03 revision of the document.
Line IssueComment234-243 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-668" 668Additional constraints for rule checking
@c@cat@color@expression@key@ref@title@word580 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-668" 668 583-588 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-775" 775Key with parameter alias
Categories(@key)?@key=1
Categories(ID=@key)?@key=1
914-931 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-903" 903Type-cast with complex type
Products(1)/Address/Model.AddressWithLocation
Products(1)/Address/Model.AddressWithLocation/Street
Products(1)/Addresses/Model.AddressWithLocation
Address/Model.AddressWithLocation
Address/Model.AddressWithLocation/Street
Addresses/Model.AddressWithLocation
950-955 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-899" 899$all with type-cast
$all?$search=red
$all/Model.Customer?$filter=contains(Name,'red')
1226-1228 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-783" 783Percent-encoded parentheses
now%28%20%29
1232-1234 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-783" 783Percent-encoded parentheses
maxdatetime%28%20%29
1238-1240 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-783" 783Percent-encoded parentheses
mindatetime%28%20%29
1421-1426 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-793" 793$expand=* on complex path
$expand=Address/*,Address/Address/*,Addresses/*,Address/Model.AddressWithLocation/*,Model.VipCustomer/Address/*
$expand=Address/*/$ref,Address/*($levels=max)
1508-1510 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-783" 783Percent-encoding
$search=blue%20green
1559-1561 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-837" 837Delta-token
$deltatoken=A@Lot_Has:Changed?=Here!
1987-1989 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-774" 774Include-annotations with qualifier
odata.include-annotations="*#qualified"
1993-1995 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-774" 774
odata.include-annotations="-*#qualified"
1999-2001 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-774" 774
odata.include-annotations="Namespace.*#quali"
2015-2017 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-774" 774
odata.include-annotations="-Namespace.*#quali"
2021-2023 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-774" 774
odata.include-annotations="Namespace.SomeTerm#qual"
2027-2029 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-774" 774
odata.include-annotations="-Namespace.SomeTerm#qual"
MetadataService.edmx
Line IssueComment102 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-831" 831OpenType property is Boolean
356 HYPERLINK "https://tools.oasis-open.org/issues/browse/ODATA-826" 826Wrong Target attribute value
Acknowledgments
The contributions of the OASIS OData Technical Committee members, enumerated in REF OData \h [OData-Protocol], are gratefully acknowledged.
Revision History
RevisionDateEditorChanges MadeWD012016-02-18Ralf HandlFirst version
odata-v4.0-errata03-os 02 June 2016
Standards Track Work Product Copyright OASIS Open 2016. All Rights Reserved. Page PAGE 3 of NUMPAGES 23
MACROBUTTON NoMacro [document identifier] MACROBUTTON NoMacro [specification date]
Copyright OASIS Open 2004.All Rights Reserved. Page PAGE 5 of NUMPAGES 23
* + , - . J _ ` h l m z B C D S T U a
ǿ~q h7 h1D 0J B* ph hY&