Re: Agenda for OData TC meeting on 2023-11-08

I would like to discuss https://issues.oasis-open.org/browse/ODATA-1609

From: Handl, Ralf <ralf.handl@sap.com>
Sent: Donnerstag, 26. Oktober 2023 13:32
To: odata@lists.oasis-open.org
Cc: Theissen, Heiko <heiko.theissen@sap.com>; Krause, Gerald <gerald.krause@sap.com>
Subject: Agenda for OData TC meeting on 2023-11-08

Here [1] is a draft agenda for the OData TC (Technical Committee) meeting scheduled on Wednesday November 08, 2023 during 8-10 am PST (17:00-19:00 CET).

For TC timeline, see [2].

Feel free to suggest additions or modifications.

Thanks.

[1] Agenda

1. Roll call [8:00]

a. Self-registration link: https://www.oasis-open.org/apps/org/workgroup/odata/event.php?event_id=53548

b. Join Microsoft Teams Meeting

Conference ID: 629 315 222#

Local numbers | Learn more about Teams

2. Approve agenda [8:05]

3. Approve minutes from previous meeting(s) [8:10 am]

a. Minutes from October 25, 2023 TC meeting: https://www.oasis-open.org/committees/download.php/71459/Minutes%20of%202023-10-25%20Meeting%20%23451.docx

4. RAPID Profile for OData [8:15]

a. Pull Requests

b. Issues

5. Issues [8:20]

a. V4.02 (and V4.01 Errata 01): RESOLVED

i. ODATA-1133 Part 1 protocol clause 1.3 Entity is unclear on template usage

ii. ODATA-1354 Add support for SoundsLike expressions

iii. ODATA-1426 Clarify use of byte-order mark (BOM) in text/plain responses

iv. ODATA-1436 Relax constraint that DELETE Cannot return data

v. ODATA-1484 Allow a client to query the status of an asynchronous request without returning the result if the request completed.

vi. ODATA-1516 Support returning inline count accuracy

vii. ODATA-1526 Support collapsing individual sections (chapters) in the HTML versions of the specification

viii. ODATA-1528 Update JSON Delta Response payload examples

ix. ODATA-1547 Recursive complex types must be nullable

x. ODATA-1549 Clarify semantics of etag in delta requests/responses

xi. ODATA-1567 Clarify “Expand to the level present in the deep insert request”

xii. ODATA-1580 Further clarify restrictions around open types

xiii. ODATA-1599 Clarify support for supplementary plane characters in OData Identifiers

b. V4.02 (and V4.01 Errata 01): APPLIED

i. ODATA-1323 Clarify representation of GEO literals and streams in annotations (XML, JSON)

ii. ODATA-1470 Clarify value of @odata.mediaContentType if stream is null

iii. ODATA-1478 7.2.3 Precision: clarify absence of $Precision for DateTimeOffset

iv. ODATA-1481 Allow Edm.Stream for non-binding action and function parameters

v. ODATA-1482 Clarify response to batch request that fails before “OData processing”

vi. ODATA-1486 Section 4.3: Correct references to ABNF rules

vii. ODATA-1487 broken link in “References” section

viii. ODATA-1491 Inconsistency in example 16.1, entity type Product

ix. ODATA-1493 OData-URL 5.1.1.15 does not explain example 106 in 5.1.1.14.4

x. ODATA-1495 Remove statement about format of media streams

xi. ODATA-1497 13.6 Function Import: annotations allowed but not mentioned

xii. ODATA-1498 Clarify where collection of primitive type can be used

xiii. ODATA-1500 Why is function “matchesPattern” written in camelCase?

xiv. ODATA-1501 Annotations targeting contained singletons

xv. ODATA-1508 Missing annotation namespace in example 8

xvi. ODATA-1518 Extend [OData-Protocol, example 18] with properties from derived types

xvii. ODATA-1520 Central definition for type-cast and term-cast segments

xviii. ODATA-1521 Case statement ambiguous with timeOfDay values

xix. ODATA-1524 Clarify key-as-segment representation for Duration and EnumValue

xx. ODATA-1525 Clarify context URL for response to $expand=*

xxi. ODATA-1530 Specify when and how stream valued properties are included

xxii. ODATA-1531 14.1.2 Applicability: clarify that “Property” means “structural property” and excludes navigation properties

xxiii. ODATA-1536 ODATA 4.01. 16.1 Example CSDL has missing alias

xxiv. ODATA-1539 Clarify decoding of plus character in URLs

xxv. ODATA-1541 Forward slashes in /$filter segments

xxvi. ODATA-1546 Clarify /$value segment appended to function returning a primitive value

xxvii. ODATA-1562 Clarify uniqueness of bound action and function names

xxviii. ODATA-1564 Protocol 11.7.7.1 misleading text on request formats

xxix. ODATA-1568 Allow handling of in-stream errors on protocol level

xxx. ODATA-1570 CSDL XML is defined with reference to XML 1.1 but none of the examples use XML version 1.1 documents

xxxi. ODATA-1571 Allow empty entity containers

xxxii. ODATA-1576 Consistently use “instances of structured types” instead of “structured instances”

xxxiii. ODATA-1577 Consistently use “entity-id” instead of “entity id”

xxxiv. ODATA-1578 Consistently use “annotated with the term” instead of “annotated with term”

xxxv. ODATA-1581 Clarify duplicate properties in JSON Batch payload

xxxvi. ODATA-1582 Mention use of ETag with bound function: only process if binding entity matches ETag

xxxvii. ODATA-1588 Allow creating and linking along a nullable single-valued navigation

c. V4.02 (and V4.01 Errata 01): NEW or OPEN with champion and proposa l

i. ODATA-879 Support Arrays of Arrays

ii. ODATA-919 Specify the result type for each operation based on operator types

iii. ODATA-923 Support subsetting returned metadata

iv. ODATA-1059 Improve specification and use of NavigationProperties, EntitySets, and Singletons

v. ODATA-1060 Improve specification of element response requirements

vi. ODATA-1071 Nullable Collection Navigation Property

vii. ODATA-1113 Allow alternate / native search syntax

viii. ODATA-1239 Define a mechanism to distinguish between inserted and updated entities in a Delta message

ix. ODATA-1253 Abstract type definition Core.Number as a super-type of all numeric types

x. ODATA-1336 Querying “JSON properties”

xi. ODATA-1340 PATCH: new preference return=delta to get back a delta response

xii. ODATA-1370 CSDL Section 12.9 “Parameter” mixing with “overload” causes ambiguity, particularly with regard to parameter ordering

xiii. ODATA-1397 Examples 86 and 87 apply an entity type as term

xiv. ODATA-1398 Improve text and examples for JSON and multipart batch

xv. ODATA-1405 /$query shall allow Content-Type: application/x-www-form-urlencoded

xvi. ODATA-1407 No way to $select instance annotations on primitive types

xvii. ODATA-1424 OData 4.01 JSON “Delta Responses” doesn’t describe use of “@id” (or “@odata.id”) for Added/Changed Entity

xviii. ODATA-1435 Conditionally add an element to a collection

xix. ODATA-1457 Potential confusion wrt Content-Type header for media entities

xx. ODATA-1475 How to search for double quotes

xxi. ODATA-1503 Instance annotations of absent complex properties

xxii. ODATA-1506 Allow index segments in path expressions

xxiii. ODATA-1517 [OData-CSDL, example 64] annotating a navigation property or its addressed resource?

xxiv. ODATA-1534 OData 4.01 JSON batch format doesn’t support streaming use cases well

xxv. ODATA-1540 Require decoding of plus as space in query part of URL

xxvi. ODATA-1544 Section 4.17: support new HTTP QUERY method, deprecate /$query path suffix

xxvii. ODATA-1545 Allow services to validate read-only properties in update payloads

xxviii. ODATA-1548 Encourage clients to specify the correct value for non-key, non-computed read-only values (or omit)

xxix. ODATA-1553 Clarify the algorithm for evaluating $compute

xxx. ODATA-1555 Strengthen definitions for $orderby, $top and $skip

xxxi. ODATA-1558 Define semantics for navigation properties of type Edm.EntityType

xxxii. ODATA-1563 URL 4.11, paragraph 2: clarify restriction “that is part of a Boolean _expression_”

xxxiii. ODATA-1569 Allow CSDL JSON also for OData versions 2.0 and 3.0

xxxiv. ODATA-1575 Remove restriction on Partner navigation

xxxv. ODATA-1584 Inconsistency regarding $select=@Namespace.Term

xxxvi. ODATA-1585 Should be able to change type when PATCHing an entity

xxxvii. ODATA-1587 Remove reference to obsolete GeoJSON document

xxxviii. ODATA-1589 /$query shall allow Content-Type: application/json

xxxix. ODATA-1590 Clarify where alternate keys can be used

xl. ODATA-1591 OData-Protocol example 64 is syntactically wrong

xli. ODATA-1592 correct vocabulary URIs in CSDL XML examples

xlii. ODATA-1593 11.4.12 Update a Collection of Entities: add examples

xliii. ODATA-1594 Add support for fuzzy search function within $filter, etc.

xliv. ODATA-1595 Replace references to RFC7230, RFC7231, and RFC7232 with RFC9110

xlv. ODATA-1596 Allow Scale=“floating” also in 4.0 responses

xlvi. ODATA-1597 Allow to create annotations in CSDL with a less verbose format to increase adoption

xlvii. ODATA-1601 concat: allow more than two arguments

xlviii. ODATA-1602 CSDL example 39 applies to Term

xlix. ODATA-1603 It is not clear if the entities in a collection returned by a function always have an entity-id

l. ODATA-1604 Clarify meaning of trailing spaces in $search query option

d. V4.02 (and V4.01 Errata 01): NEW or OPEN without champion or proposal

i. ODATA-579 Should we support dynamic functions/actions?

ii. ODATA-601 Investigate enhancements to interoperability and feature set of OData JSON through JSON-LD

iii. ODATA-665 Add OData-MetadataETag header

iv. ODATA-730 Lack of ordering constraints on delta responses may require clients to buffer (or persist) entire response to process it correctly

v. ODATA-854 Consider use of OPTIONS for discovering formats, other capabilities and features

vi. ODATA-900 Cross-service navigation and service versioning

vii. ODATA-1052 Consider the “fragility” of server-driven paging

viii. ODATA-1062 Revise UML model for OData Metamodel

ix. ODATA-1070 Clarify text related to Canonical URL

x. ODATA-1107 Introduce instance annotation to specify which types an instance “implements”

xi. ODATA-1235 ActionImport and FunctionImport on EntityType

xii. ODATA-1246 Allow BaseType of EntityType to be a ComplexType

xiii. ODATA-1261 Allow $pagesize system query option

xiv. ODATA-1262 Explicitly state structural restrictions of type Edm.Untyped

xv. ODATA-1308 Ability to reference newly discovered OData services

xvi. ODATA-1317 ContextUrl does not represent navigation properties for which the entity references ($ref) are included

xvii. ODATA-1333 Add Terms, Abbreviated Terms, and Symbols sections to specifications

xviii. ODATA-1350 OData V2 required continue-on-error style batch responses, V4 makes it optional for servers (due to use of Prefer)

xix. ODATA-1379 Consider adding railroad diagrams for the URL syntax

xx. ODATA-1386 Introduce primitive types for color values

xxi. ODATA-1438 New preference return=keys

xxii. ODATA-1479 Current instance/collection is only defined adhoc

xxiii. ODATA-1496 clarify the relationship of the various path _expression_ types

xxiv. ODATA-1504 Dry-run of data modification requests

xxv. ODATA-1505 Expressions in action payloads

xxvi. ODATA-1514 Generalize the use of $each

xxvii. ODATA-1527 Allow functions/actions to return (and take) a delta payload

xxviii. ODATA-1529 Provide support for selecting the id of an entity

xxix. ODATA-1535 Should updates of related resources be supported in Create?

xxx. ODATA-1559 Clarify definition of transient.

xxxi. ODATA-1560 Clarify usage of URL templates with callback preference

xxxii. ODATA-1573 clarify behavior for omitted values in PATCH and PUT

xxxiii. ODATA-1574 Expand function results

xxxiv. ODATA-1579 Allow references to Core.ContentIDs in batch request URLs

xxxv. ODATA-1583 Clarify representation of context URLs in JSON payloads

xxxvi. ODATA-1586 Clarify create/replace for server-defined dynamic properties

e. Data Aggregation: NEW or OPEN

i. ODATA-1492 Temporal transformation at() for snapshot entity sets

f. Temporal: NEW or OPEN

i. ODATA-1542 Chapter 3, example 7 still uses TimeSliceStart and TimeSliceEnd

ii. ODATA-1551 4.3.2.3 Delete during a Period, step 3: align with corresponding step of 4.3.2.1, step 3

g. Vocabularies: NEW or OPEN with proposal

i. ODATA-1140 Add details to HttpResponse

ii. ODATA-1214 Annotate constructor/factory actions

iii. ODATA-1358 Detach textual descriptions from operation restriction terms in Capability vocabulary

iv. ODATA-1394 Add full-fledged support for ISO 8601-1 duration

v. ODATA-1412 Capabilities vocabulary: Add EntityContainer as annotation target

vi. ODATA-1453 Capabilities.SearchRestrictions/UnsupportedExpressions: description of default value “none” is misleading

vii. ODATA-1467 Keep a CHANGELOG.md, use Semantic Versioning for each vocabulary

viii. ODATA-1550 Clarify whether Validation.AllowedValues can be applied to collection-valued properties

ix. ODATA-1600 Functions and Actions as Interfaces

h. Vocabularies: NEW or OPEN without proposal

i. ODATA-1480 Missing term property Capabilities.NavigationRestrictions/…/ComputeSupported

ii. ODATA-1499 Clarify how to allow/disallow an unbound function in filter/orderby

iii. ODATA-1502 Allow to specify expand query options beyond just nested expands (filter, select, …)

iv. ODATA-1512 Delta: distinguish “soft-deleted” and “hard-deleted” entities

v. ODATA-1513 Clarify use of read/update restrictions for complex types

6. Next meetings [9:50]

a. Wednesday November 15, 2023 during 8-10 PST (17:00-19:00 CET)

b. Wednesday November 22, 2023 during 8-10 PST (17:00-19:00 CET)

c. Wednesday November 29, 2023 during 8-10 PST (17:00-19:00 CET)

d. Wednesday December 06, 2023 during 8-10 PST (17:00-19:00 CET)

7. AOB and wrap up [9:55]

[2] Timeline

1. https://www.oasis-open.org/committees/download.php/71007/TC-Timeline-2023-05-10.docx

odata message