Release Notes - OASIS Open Data Protocol (OData) TC - Version V4.02 - HTML format

Bug

  • [ODATA-1625] - Cannot specify null as DefaultValue in CSDL XML

New Feature

  • [ODATA-579] - Should we support dynamic functions/actions?
  • [ODATA-739] - Allow default values for function and action parameters
  • [ODATA-854] - Consider use of OPTIONS for discovering formats, other capabilities and features
  • [ODATA-879] - Support Arrays of Arrays
  • [ODATA-900] - Cross-service navigation and service versioning
  • [ODATA-1060] - Improve specification of element response requirements
  • [ODATA-1071] - Nullable Collection Navigation Property
  • [ODATA-1107] - Introduce instance annotation to specify which types an instance "implements"
  • [ODATA-1214] - Annotate constructor/factory actions
  • [ODATA-1235] - ActionImport and FunctionImport on EntityType
  • [ODATA-1308] - Ability to reference newly discovered OData services
  • [ODATA-1336] - Querying "JSON properties"
  • [ODATA-1354] - Add support for SoundsLike expressions
  • [ODATA-1407] - No way to $select instance annotations on primitive types
  • [ODATA-1436] - Relax constraint that DELETE Cannot return data
  • [ODATA-1504] - Dry-run of data modification requests
  • [ODATA-1506] - Allow index segments in path expressions
  • [ODATA-1516] - Support returning inline count accuracy
  • [ODATA-1527] - Allow functions/actions to return (and take) a delta payload
  • [ODATA-1529] - Provide support for selecting the id of an entity
  • [ODATA-1535] - Should updates of related resources be supported in Create?
  • [ODATA-1545] - Allow services to validate read-only properties in update payloads
  • [ODATA-1548] - Encourage clients to specify the correct value for non-key, non-computed read-only values (or omit)
  • [ODATA-1549] - Clarify semantics of etag in delta requests/responses
  • [ODATA-1574] - Expand function results
  • [ODATA-1579] - Allow references to Core.ContentIDs in batch request URLs
  • [ODATA-1594] - Add support for fuzzy search function within $filter, etc.
  • [ODATA-1599] - Clarify support for supplementary plane characters in OData Identifiers
  • [ODATA-1614] - Add NonSelectableProperties to SelectSupportType
  • [ODATA-1616] - Clarify rules around results returned from Create/Update
  • [ODATA-1623] - Support alternate keys in delta patch
  • [ODATA-1626] - Should support annotations to bound actions/functions via path
  • [ODATA-1633] - In should support empty literal arrays

Improvement

  • [ODATA-601] - Investigate enhancements to interoperability and feature set of OData JSON through JSON-LD
  • [ODATA-665] - Add OData-MetadataETag header
  • [ODATA-730] - Lack of ordering constraints on delta responses may require clients to buffer (or persist) entire response to process it correctly
  • [ODATA-919] - Specify the result type for each operation based on operator types
  • [ODATA-923] - Support subsetting returned metadata
  • [ODATA-975] - Consider allowing use of instance annotations in $select and $expand
  • [ODATA-1052] - Consider the "fragility" of server-driven paging
  • [ODATA-1059] - Improve specification and use of NavigationProperties, EntitySets, and Singletons
  • [ODATA-1062] - Formally define OData Metamodel
  • [ODATA-1070] - Clarify text related to Canonical URL
  • [ODATA-1113] - Allow alternate / native search syntax
  • [ODATA-1239] - Define a mechanism to distinguish between inserted and updated entities in a Delta message
  • [ODATA-1246] - Allow BaseType of EntityType to be a ComplexType
  • [ODATA-1253] - Abstract type definition Core.Number as a super-type of all numeric types
  • [ODATA-1261] - Allow $pagesize system query option
  • [ODATA-1262] - Explicitly state structural restrictions of type Edm.Untyped
  • [ODATA-1317] - ContextUrl does not represent navigation properties for which the entity references ($ref) are included
  • [ODATA-1323] - Clarify representation of GEO literals and streams in annotations (XML, JSON)
  • [ODATA-1333] - Add Terms, Abbreviated Terms, and Symbols sections to specifications
  • [ODATA-1340] - PATCH: new preference return=delta to get back a delta response
  • [ODATA-1350] - OData V2 required continue-on-error style batch responses, V4 makes it optional for servers (due to use of Prefer)
  • [ODATA-1357] - Add descriptions to system query option restrictions in Capability vocabulary
  • [ODATA-1379] - Consider adding railroad diagrams for the URL syntax
  • [ODATA-1386] - Introduce primitive types for color values
  • [ODATA-1405] - /$query shall allow Content-Type: application/x-www-form-urlencoded
  • [ODATA-1428] - Definition of service-specific client-side functions
  • [ODATA-1435] - Conditionally add an element to a collection
  • [ODATA-1438] - New preference return=keys
  • [ODATA-1441] - New query option $expect combining $expand and $select
  • [ODATA-1454] - Allow upserts against media entities
  • [ODATA-1457] - Potential confusion wrt Content-Type header for media entities
  • [ODATA-1470] - Clarify value of @odata.mediaContentType if stream is null
  • [ODATA-1479] - Current instance/collection is only defined adhoc
  • [ODATA-1481] - Allow Edm.Stream for non-binding action and function parameters
  • [ODATA-1484] - Allow a client to query the status of an asynchronous request without returning the result if the request completed.
  • [ODATA-1505] - Expressions in action payloads
  • [ODATA-1514] - Generalize the use of $each
  • [ODATA-1515] - Allow $value as the last path segment of an annotation target - no, annotate the media entity type
  • [ODATA-1526] - Support collapsing individual sections (chapters) in the HTML versions of the specification
  • [ODATA-1534] - OData 4.01 JSON batch format doesn't support streaming use cases well
  • [ODATA-1540] - Require decoding of plus as space in query part of URL
  • [ODATA-1544] - Section 4.17: support new HTTP QUERY method, deprecate /$query path suffix
  • [ODATA-1569] - Allow CSDL JSON also for OData versions 2.0 and 3.0
  • [ODATA-1571] - Allow empty entity containers
  • [ODATA-1575] - Remove restriction on Partner navigation
  • [ODATA-1583] - Clarify representation of context URLs in JSON payloads
  • [ODATA-1585] - Should be able to change type when PATCHing an entity
  • [ODATA-1586] - Clarify create/replace for server-defined dynamic properties
  • [ODATA-1588] - Allow creating and linking along a nullable single-valued navigation
  • [ODATA-1589] - /$query shall allow Content-Type: application/json
  • [ODATA-1590] - Clarify where alternate keys can be used
  • [ODATA-1596] - Allow Scale="floating" also in 4.0 responses
  • [ODATA-1597] - Allow to create annotations in CSDL with a less verbose format to increase adoption
  • [ODATA-1601] - concat: allow more than two arguments
  • [ODATA-1606] - Separation of concerns: ABNF for URL components instead of whole URLs
  • [ODATA-1608] - Safety, Security and Privacy Considerations: fill out or remove appendix
  • [ODATA-1618] - Clarify matchespattern and regular expression flags
  • [ODATA-1621] - Clarify annotations on unavailable properties
  • [ODATA-1624] - Make conformance clauses more future-proof
  • [ODATA-1630] - Resharpen definitions of PropertyPath and NavigationPropertyPath
  • [ODATA-1641] - More rigorous definition of $<request identifier> references
  • [ODATA-1645] - Find reliable references for Geo WKT and SRID

Edit/Copy Release Notes

The text area below allows the project release notes to be edited and copied to another document.