Agenda for OData TC meeting on 2023-08-30

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

For TC timeline, see [2].

Feel free to suggest additions or modifications.

Thanks.

[1] Agenda

Roll call [8:00]

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

Approve agenda [8:05]
Approve minutes from previous meeting(s) [8:10 am]

Minutes from July 26, 2023 TC meeting: https://www.oasis-open.org/committees/download.php/71236/Minutes%20of%202023-07-26%20Meeting%20%23442.docx

Data Aggregation [8:15]

CSD04 Public Review ended on August 17, 2023
Public Review Comments: https://lists.oasis-open.org/archives/odata-comment/202308/threads.html
Comment Resolution Log: https://www.oasis-open.org/committees/document.php?document_id=71270&wg_abbrev=odata

RAPID Profile for OData [8:25]

Issues [8:30]

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

i. currently 12 issues

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-1353 Clarity for "@odata.type" in request payloads

iii. ODATA-1360 Clarify that clients have to do content-ID replacing to interpret Location headers in batch results

iv. ODATA-1366 Remove redundant text to improve readability

v. ODATA-1368 Clarify Term applicability

vi. ODATA-1371 Improve structure of CSDL clause 4

vii. ODATA-1376 Clarify terminology where unbound functions can be invoked

viii. ODATA-1380 11.4.1.2 Handling of DateTimeOffset Values: replace "i.e. UTC" with "for example UTC"

ix. ODATA-1385 Add TypecastSegmentSupported to ReadRestrictions

x. ODATA-1410 $expand: clarify that property *paths* must not appear twice

xi. ODATA-1411 $expand: Discrepancy in argument descriptions

xii. ODATA-1413 Clarification of response to a request against a delta link

xiii. ODATA-1417 Inconsistencies in OData-CSDL section 14.2.2

xiv. ODATA-1419 Use of Core.ContentID by clients if service does not reference Core vocabulary

xv. ODATA-1420 Path evaluation for annotations targeting annotations

xvi. ODATA-1422 Clarify $select behavior for stream properties

xvii. ODATA-1429 Clarify applicability of $expand options

xviii. ODATA-1430 Clarify handling of null values for complex-typed properties

xix. ODATA-1432 Clarify wording in Section 7.2, Type Facets

xx. ODATA-1433 Clarify applicability of lambda operators to complex-typed collections

xxi. ODATA-1434 List of recommended navigation property bindings is incomplete.

xxii. ODATA-1437 11.4.9.4 Update a Collection Property: reference section 11.4.11 Positional Inserts

xxiii. ODATA-1446 Clarify usage of Edm.Stream-typed function and action return types

xxiv. ODATA-1450 Key with PropertyRef using navigation path incompatible with Protocol 11.4.2 "Create an Entity"

xxv. ODATA-1456 Navigation path from instance to lambda operator

xxvi. ODATA-1464 Remove section 14.4.4.3 Function odata.matchesPattern

xxvii. ODATA-1465 Clarification: Delete supported for Nullable single-valued navigation properties

xxviii. ODATA-1469 Clarify $select behavior for properties of "null" instances

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

xxx. ODATA-1472 Clarify: PATCH should allow changing type on nested complex type

xxxi. ODATA-1476 JSON batch body encoding for "text" content types may cause conversion errors or data loss

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

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

xxxiv. ODATA-1482 Clarify response to batch request that fails before "OData processing"

xxxv. ODATA-1485 Clarify canonical URLs for stream properties

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

xxxvii. ODATA-1487 broken link in "References" section

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

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

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

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

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

xliii. ODATA-1500 Why is function "matchesPattern" written in camelCase?

xliv. ODATA-1501 Annotations targeting contained singletons

xlv. ODATA-1508 Missing annotation namespace in example 8

xlvi. ODATA-1510 $root/EntitySet is not allowed by ABNF

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

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

xlix. ODATA-1521 Case statement ambiguous with timeOfDay values

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

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

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

liii. ODATA-1531 14.1.2 Applicability: clarify that "Property" means "structural property" and excludes navigation properties

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

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

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

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

lviii. ODATA-1561 Clarify format of AsyncResult response header value

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

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

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

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

lxiii. ODATA-1571 Allow empty entity containers

lxiv. ODATA-1576 Consistently use "instances of structured types" instead of "structured instances"

lxv. ODATA-1577 Consistently use "entity-id" instead of "entity id"

lxvi. ODATA-1578 Consistently use "annotated with the term" instead of "annotated with term"

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

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

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

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-1239 Define a mechanism to distinguish between inserted and updated entities in a Delta message

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

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

x. ODATA-1370 CSDL Section 12.9 "Parameter" mixing with "overload" causes ambiguity, particularly with regard to parameter ordering

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

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

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

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

xv. ODATA-1424 OData 4.01 JSON "Delta Responses" doesn't describe use of "@id" (or "@odata.id") for Added/Changed Entity

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

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

xviii. ODATA-1475 How to search for double quotes

xix. ODATA-1503 Instance annotations of absent complex properties

xx. ODATA-1506 Allow index segments in path expressions

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

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

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

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

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

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

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

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

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

xxx. ODATA-1563 URL 4.11, paragraph 2: clarify restriction "that is part of a Boolean _expression_"

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

xxxii. ODATA-1575 Remove restriction on Partner navigation

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

xxxiv. ODATA-1587 Remove reference to obsolete GeoJSON document

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

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

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

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

xxxix. ODATA-1593 11.4.12 Update a Collection of Entities: add JSON response example

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

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

i. currently 40 issues

e. Data Aggregation: NEW or OPEN

i. ODATA-1492 Temporal transformation at(<date or timestamp>) 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 actions

iii. ODATA-1336 Querying âJSON propertiesâ

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

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

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

vii. ODATA-1453 Capabilities.SearchRestrictions/UnsupportedExpressions: description of default value "none" is misleading

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

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

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

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

Next meetings [9:50]

a. Wednesday September 06, 2023 during 8-10 PDT (17:00-19:00 CEST)

b. Wednesday September 13, 2023 during 8-10 PDT (17:00-19:00 CEST)

c. Wednesday September 20, 2023 during 8-10 PDT (17:00-19:00 CEST)

d. Wednesday September 27, 2023 during 8-10 PDT (17:00-19:00 CEST)

AOB and wrap up [9:55]

[2] Timeline

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

________________________________________________________________________________

Join Microsoft Teams Meeting

Conference ID: 629 315 222#

Local numbers | Learn more about Teams | Meeting options

________________________________________________________________________________

odata message