RE: Agenda for OData TC meeting on 2018-11-08

anonymous morphed into Saurabh Madan

Saurabh Madan morphed into Saurabh Madan (Microsoft)

Please change your name from 'anonymous' using the Settings button

[17:02] anonymous morphed into Ralf Handl

[17:04] Room information was updated by: Ralf Handl

Here [1] is a draft agenda for the OData TC (Technical Committee) meeting scheduled on Thursday November 08, 2018 during 8-10 am PDT (17:00-19:00 CEST). For additional information, such as dial-in details and chat room, refer to [2]. For TC timeline, see [3]. Feel free to suggest additions or modifications.

Thanks.

[1] Agenda

1.Roll call [8:00 am PT]

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

2.Approve agenda [8:05 am PT]

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

a.Minutes from October 25, 2018 TC meeting: https://www.oasis-open.org/committees/download.php/64148/odata-meeting-235_on-20181025-minutes.html

4.Review action items [Action item list: https://www.oasis-open.org/apps/org/workgroup/odata/members/action_items.php?sort_field=due_closed_date] [8:15am PT]

a.Upcoming

i.#0037 Concept for Google Protocol Buffers as a data format  Hubert Heijkers  2018-12-06

b.In progress

i.#0036 Register the OData- headers and preferences with IANA  Mark Biamonte  2018-07-26

5.Repeatable Requests [8:20 am PT]

a.https://www.oasis-open.org/committees/document.php?document_id=49687&wg_abbrev=odata

i.This proposed Committee Note has been dormant for some time

1.Are there other implementations besides SAPs implementation?

2.Matt and Evan would like finish the document and get it published

6.Issues [8:50 am PT]

a.Vocabularies: NEW or OPEN with concrete proposal

i.ODATA-1216 Terms for POST/PATCH/PUT with system query options to shape response

ii.ODATA-1200 ODATA-884 / Support sample values for types, parameters, request/response bodies

iii.ODATA-1194 Add term Core.Example to allow including annotation examples in term definitions

iv.ODATA-1176 Capabilities: add new term SelectSupport

b.APPLIED

i.ODATA-1188 Allow using instance annotations in $select and $expand

1.https://github.com/oasis-tcs/odata-abnf/pull/7

ii.ODATA-1203 Allow numeric indexes in Path constructs within annotations

1.https://tools.oasis-open.org/version-control/browse/wsvn/odata/trunk/4.01%20spec/schemas/edm.xsd?op=diff&rev=1031

2.https://github.com/oasis-tcs/odata-csdl-schemas/pull/1

3.https://www.oasis-open.org/committees/download.php/64129/odata-csdl-json-v4.01-wd05-2018-10-22.docx

4.https://www.oasis-open.org/committees/download.php/64130/odata-csdl-xml-v4.01-wd06-2018-10-22.docx

iii.ODATA-1183

1. https://github.com/oasis-tcs/odata-csdl-schemas/pull/2

2.https://www.oasis-open.org/committees/download.php/64129/odata-csdl-json-v4.01-wd05-2018-10-22.docx

3.https://www.oasis-open.org/committees/download.php/64130/odata-csdl-xml-v4.01-wd06-2018-10-22.docx

iv.ODATA-1170 Allow @odata.type for isomorphy to CSDL XML

1.https://github.com/oasis-tcs/odata-csdl-schemas/pull/3

2.https://www.oasis-open.org/committees/download.php/64129/odata-csdl-json-v4.01-wd05-2018-10-22.docx

v.ODATA-1232 Support Union types

1.https://github.com/oasis-tcs/odata-vocabularies/pull/27

vi.ODATA-1229 Introduce LocalDateTime TypeDef to apply to string datatype

1.https://github.com/oasis-tcs/odata-vocabularies/pull/23

2.https://www.oasis-open.org/committees/download.php/64118/odata-v4.01-wd06-part2-url-conventions-2018-10-19.docx

vii.ODATA-1208 Specify the finest possible granularity for Duration

1.https://github.com/oasis-tcs/odata-vocabularies/pull/22

2.https://www.oasis-open.org/committees/download.php/64129/odata-csdl-json-v4.01-wd05-2018-10-22.docx

3.https://www.oasis-open.org/committees/download.php/64130/odata-csdl-xml-v4.01-wd06-2018-10-22.docx

viii.ODATA-1202 Deep update with nested delta items should allow Core.ContentID

1.https://github.com/oasis-tcs/odata-vocabularies/pull/25

2.https://www.oasis-open.org/committees/download.php/64119/odata-v4.01-wd06-part1-protocol-2018-10-19.docx

ix.ODATA-1114 If-Then-Else in $batch requests

1.https://github.com/oasis-tcs/odata-vocabularies/pull/26

2.https://www.oasis-open.org/committees/download.php/64120/odata-json-format-v4.01-wd06-2018-10-19.docx

c.V4.01: NEW or OPEN

i.ODATA-1250 GeoJSON, SRID, and LineString

ii.ODATA-1249 edm.xsd: ActionImport and IncludeInServiceDocument

iii.ODATA-1248 csdl.schema.json: add descriptions to all schema elements

iv.ODATA-1245 Extract _expression_ syntax into own sub-section next to $filter

v.ODATA-1165 Describe $expand and $select via prose text and examples, remove ABNF snippets

vi.ODATA-1243 Clarify whether $orderby and string comparison with ge, gt, le, lt is language-specific

vii.ODATA-1242 Clarify that resolved relative URIs in batch responses cannot contain content-ID references

viii.ODATA-1226 Ambiguity with Capabilities.ChangeTracking annotation

ix.ODATA-1251 Should annotated null/default values be omitted/restored?

x.ODATA-1246 Allow BaseType to be a ComplexType

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

xii.ODATA-1238 Clarifications for select-list in ContextUrl

xiii.ODATA-1198 ETag handling deviations from RFC7232 are avoidable if we consider two kinds of ETag (ETag in response header and ETag in response payload)

xiv.ODATA-1168 Clarify the use of ETags for Avoiding Update Conflicts

xv.ODATA-1135 Document use of JSON $schema

xvi.ODATA-1064 Add ability to annotate collections to return only count and NextLink

xvii.ODATA-1005 Make sure we have capabilities for all new 4.01 functionality

d.Data Aggregation: NEW or OPEN

i.ODATA-1244 Extend compute to work with aggregated values calculated from the input set

ii.ODATA-1218 Transformations for recursive hierarchy processing

iii.ODATA-1207 Clarify need for @odata.id in nested response structures

iv.ODATA-947 Transformation for computing ratios with aggregated values

v.ODATA-945 Correct examples 53 and 54

e.Vocabularies: NEW or OPEN that need more discussion

i.ODATA-1140 ODATA-884 / Add details to HTTPResponseCode term

ii.ODATA-1099 Add annotations to describe custom query options and custom headers

iii.ODATA-884 Enable enumerating the valid requests and responses for a particular resource.

iv.ODATA-1214 Annotate constructor actions

v.ODATA-1177 Allow referencing a (JSON) schema for Edm.Untyped properties

vi.ODATA-1107 Introduce instance annotation to specify which types an instance "implements"

vii.ODATA-1060 Improve specification of element response requirements

7.Next meetings [9:50 am PT]

a.Thursday November 15, 2018 during 8-10 am PST (17:00-19:00 CET)

b.Thursday November 22, 2018 during 8-10 am PST (17:00-19:00 CET)  Thanksgiving in the United States  no meeting?

c.Thursday November 29, 2018 during 8-10 am PST (17:00-19:00 CET)

8.AOB and wrap up [9:55 am PT]

[2] References

Chat room: http://webconf.soaphub.org/conf/room/odatatc

Conference call & Screen sharing: https://lync.co.sap.com/meet/ralf.handl/Q4QB1098

Conference call details: https://www.oasis-open.org/apps/org/workgroup/odata/download.php/63673/latest/TC%20meeting%20dial-in%20details.htm

[3] Timeline

https://www.oasis-open.org/committees/download.php/62637/TC%20Timeline-2018-03-02.docx

[17:04] anonymous morphed into George Ericson (Dell)

[17:04] anonymous morphed into Matt Borges (SAP)

[17:06] Ralf Handl: Voting Members: 8 of 10 (80%) (used for quorum calculation)

[17:06] Ralf Handl: Quorum achieved: yes

[17:06] Ralf Handl: 2.Approve agenda [8:05 am PT]

[17:07] Ralf Handl: Mike: three new issues:

[17:07] Ralf Handl: * https://issues.oasis-open.org/browse/ODATA-1254

[17:08] Ralf Handl: * https://issues.oasis-open.org/browse/ODATA-1252

[17:08] Ralf Handl: * https://issues.oasis-open.org/browse/ODATA-1251

[17:08] Ralf Handl: 1251 and 1252 critical for today

[17:08] Ralf Handl: 1216 critical for today (first on current agenda)

[17:09] George Ericson (Dell): FYI: I will need to drop in 35 minutes

[17:10] Ralf Handl: Mike: 1251 and 1252 first, limit to first hour of meeting, then move on to 1216 and related vocab issues

[17:10] Ralf Handl: Agenda is approved with these changes

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

a.Minutes from October 25, 2018 TC meeting: https://www.oasis-open.org/committees/download.php/64148/odata-meeting-235_on-20181025-minutes.html

[17:11] Ralf Handl: Minutes are approved

[17:11] Ralf Handl: 4.Review action items [Action item list: https://www.oasis-open.org/apps/org/workgroup/odata/members/action_items.php?sort_field=due_closed_date] [8:15am PT]

a.Upcoming

i.#0037 Concept for Google Protocol Buffers as a data format  Hubert Heijkers  2018-12-06

b.In progress

i.#0036 Register the OData- headers and preferences with IANA  Mark Biamonte  2018-07-26

[17:11] Ralf Handl: Mark: registration documents updated

[17:16] Ralf Handl: 5.Repeatable Requests [8:20 am PT]

a.https://www.oasis-open.org/committees/document.php?document_id=49687&wg_abbrev=odata

i.This proposed Committee Note has been dormant for some time

1.Are there other implementations besides SAPs implementation?

2.Matt and Evan would like finish the document and get it published

[17:17] Mark Biamonte (Progress): Document unused Isolation values in Header Registration document.  Mark to update registration document and send to TC for review

[17:19] Michael Pizzo: Repeatable Requests

[17:20] Michael Pizzo: -Mike: interesting, but not currently implemented

[17:20] Ralf Handl: Ralf to create action item for Matt due January 17, 2019

[17:20] Michael Pizzo: -Mark: interesting, sometimes repeat read requests, don't currently for write.

[17:21] Ralf Handl: Matt: need to add clarification on date and id formats, and general cleanup of the document

[17:22] Ralf Handl: Next: https://issues.oasis-open.org/browse/ODATA-1251

[17:30] Michael Pizzo: Proposal:

Properties that are annotated must not be omitted due to omit-values if they would otherwise be written.

[17:31] Ralf Handl: ODATA-1251 is OPEN

[17:32] Hubert Heijkers (IBM): I move to resolve ODATA-1251 as proposed.

[17:32] Michael Pizzo: I second

[17:32] Ralf Handl: ODATA-1251 is RESOLVED as proposed

[17:32] Ralf Handl: https://issues.oasis-open.org/browse/ODATA-1252

[17:33] Ralf Handl: Proposal:

Allow Edm.PrimitiveType as an underlying type for TypeDefinition for 4.01 schemas.

Don't allow type-specific facets to be applied to Edm.PrimitiveType.

[17:35] Ralf Handl: Ralf: We could allow facets in the same manner that JSON Schema allows type-specific validation keywords (e.g. maxLength or multipleOf) in combination with array-valued type: only those facets that apply to the concrete type of the instance need to be fulfilled.

[17:41] Ralf Handl: ODATA-1252 is OPEN

[17:48] Ralf Handl: Edm.PrimitiveType

cannot be used as the type of a key property of an entity type.

cannot be used as the underlying type of a type definition or enumeration type.

[17:55] Ralf Handl: $metadata: <Property Name="Number" Type="Edm.PrimitiveType" />

[17:55] Ralf Handl: Instance data:

  "Number":42,

  "Number@odata.type":"#Int32

[17:57] Michael Pizzo: Proposal:

Allow Edm.PrimitiveType as an underlying type for TypeDefinition for 4.01 and greater schemas only.

Type-specific facets applied to Edm.PrimitiveType (in property or type definition) should be ignored by the client.

[17:57] Hubert Heijkers (IBM): I move to resolve ODATA-1252 as per the amended proposal.

[17:57] George Ericson (Dell): Second

[17:58] Ralf Handl: ODATA-1252 is RESOLVED with the amended proposal

[17:58] Ralf Handl: https://issues.oasis-open.org/browse/ODATA-1253

[17:58] Ralf Handl: Abstract type Edm.Number

[17:58] Ralf Handl: Either:

Add new abstract type Edm.Number as a specialization of Edm.PrimitiveType and a super-type of all numeric types

Or:

Add type definition Core.Number with underlying type Edm.PrimitiveType annotated with Validation.DerivedTypeConstraint listing all numeric types (depends on ODATA-1252)

[18:00] Ralf Handl: Changed title to: Abstract type definition Core.Number as a super-type of all numeric types

[18:00] Ralf Handl: Proposal:

Add type definition Core.Number with underlying type Edm.PrimitiveType annotated with Validation.DerivedTypeConstraint listing all numeric types (depends on ODATA-1252)

[18:00] Ralf Handl: ODATA-1253 is OPEN

[18:03] Ralf Handl: Problem: ODATA-1252 restricts this to V4.01, and Core is V4

[18:04] Ralf Handl: Could have a Types vocabulary for Types.Number and (ideally also) Types.LocalDateTime (i.e. move it over from Core)

[18:05] Ralf Handl: 6.Issues [8:50 am PT]

a.Vocabularies: NEW or OPEN with concrete proposal

i.ODATA-1216 Terms for POST/PATCH/PUT with system query options to shape response

ii.ODATA-1200 ODATA-884 / Support sample values for types, parameters, request/response bodies

iii.ODATA-1194 Add term Core.Example to allow including annotation examples in term definitions

iv.ODATA-1176 Capabilities: add new term SelectSupport

[18:35] Ralf Handl: Back to ODATA-1216

[18:36] Ralf Handl: Mike: use ModificationOptionsSupport also in InsertRestrictions and UpdateRestrictions

[18:40] Ralf Handl: Better names for ModificationOptionsSupport

[18:40] Ralf Handl: SystemQueryOptionsSupportedWithModificationOperatoins

[18:40] Ralf Handl: ODATA-1216 is OPEN

[18:42] Ralf Handl: Proposal: add ModificationOptionSupport as new top-level term and as a property on InsertRestrictions and UpdateRestrictions (from where they propagate into NavigationRestrictions)

[18:43] Ralf Handl: <Term Name="ModificationOptionsSupport" Type="Capabilities.ModificationOptionsSupportType"

        AppliesTo="EntityContainer Action ActionImport"

        <Annotation Term="Core.Description"

          String="Support for query options with modification requests (insert, update, action invocation)" />

      </Term>

      <ComplexType Name="ModificationOptionsSupportType">

        <Property Name="ExpandSupported" Type="Edm.Boolean" Nullable="false" DefaultValue="false">

          <Annotation Term="Core.Description" String="Supports $expand with modification requests" />

        </Property>

        <Property Name="SelectSupported" Type="Edm.Boolean" Nullable="false" DefaultValue="false">

          <Annotation Term="Core.Description" String="Supports $select with modification requests" />

        </Property>

        <Property Name="ComputeSupported" Type="Edm.Boolean" Nullable="false" DefaultValue="false">

          <Annotation Term="Core.Description" String="Supports $compute with modification requests" />

        </Property>

        <Property Name="FilterSupported" Type="Edm.Boolean" Nullable="false" DefaultValue="false">

          <Annotation Term="Core.Description" String="Supports $filter with modification requests" />

        </Property>

        <Property Name="SearchSupported" Type="Edm.Boolean" Nullable="false" DefaultValue="false">

          <Annotation Term="Core.Description" String="Supports $search with modification requests" />

        </Property>

        <Property Name="SortSupported" Type="Edm.Boolean" Nullable="false" DefaultValue="false">

          <Annotation Term="Core.Description" String="Supports $orderby with modification requests" />

        </Property>

      </ComplexType>

[18:45] Ralf Handl: Use property name InsertOptionsSupport in InsertRestrictions and UpdateOptionsSupport in UpdateRestrictions

[18:46] Ralf Handl: Or just InsertQueryOptions and UpdateQueryOptions

[18:46] Ralf Handl: And consequently ModificationQueryOptions instead of ModificationOptionsSupport

[18:48] Ralf Handl: Rename complex type to ModificationQueryOptionsType

[18:48] Ralf Handl: Shorten to InsertRestrictions/QueryOptions and UpdateRestrictions/QueryOptions

[18:50] Ralf Handl: Type: ModificationQueryOptionsType

[18:50] Ralf Handl: Term: ModificationQueryOptions

[18:50] Ralf Handl: Property: QueryOptions (context is given by surrounding type)

[18:51] Michael Pizzo: Add ModificationQueryOptionsType

Add  ModificationQueryOptions as a top-level annotation term.

Add QueryOptions property to InsertRestrictions

Add QueryOptions property to UpdateRestrictions

[18:52] Michael Pizzo: I move to resolve ODATA 1216 as proposed

[18:52] Stefan Hagen: I second

[18:53] Ralf Handl: ODATA-1216 is RESOLVED as proposed

[18:54] Ralf Handl: 7.Next meetings [9:50 am PT]

a.Thursday November 15, 2018 during 8-10 am PST (17:00-19:00 CET)

b.Thursday November 22, 2018 during 8-10 am PST (17:00-19:00 CET)  Thanksgiving in the United States  no meeting?

c.Thursday November 29, 2018 during 8-10 am PST (17:00-19:00 CET)

[18:55] Ralf Handl: a and c: have meetings

[18:55] Ralf Handl: b: no meeting

[18:55] Ralf Handl: 8.AOB and wrap up [9:55 am PT]

[18:55] Ralf Handl: Meeting is adjourned

From: odata@lists.oasis-open.org <odata@lists.oasis-open.org> On Behalf Of Handl, Ralf
Sent: Dienstag, 6. November 2018 13:14
To: odata@lists.oasis-open.org
Subject: [CAUTION] [odata] Agenda for OData TC meeting on 2018-11-08

Here [1] is a draft agenda for the OData TC (Technical Committee) meeting scheduled on Thursday November 08, 2018 during 8-10 am PDT (17:00-19:00 CEST). For additional information, such as dial-in details and chat room, refer to [2]. For TC timeline, see [3]. Feel free to suggest additions or modifications.

Thanks.

[1] Agenda

1. Roll call [8:00 am PT]

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

2. Approve agenda [8:05 am PT]

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

Minutes from October 25, 2018 TC meeting: https://www.oasis-open.org/committees/download.php/64148/odata-meeting-235_on-20181025-minutes.html

4. Review action items [Action item list: https://www.oasis-open.org/apps/org/workgroup/odata/members/action_items.php?sort_field=due_closed_date] [8:15am PT]

Upcoming

i. #0037 Concept for Google Protocol Buffers as a data format – Hubert Heijkers – 2018-12-06

In progress

i. #0036 Register the OData- headers and preferences with IANA – Mark Biamonte – 2018-07-26

5. Repeatable Requests [8:20 am PT]

https://www.oasis-open.org/committees/document.php?document_id=49687&wg_abbrev=odata

i. This proposed Committee Note has been dormant for some time

Are there other implementations besides SAP’s implementation?
Matt and Evan would like finish the document and get it published

6. Issues [8:50 am PT]

Vocabularies: NEW or OPEN with concrete proposal

i. ODATA-1216 Terms for POST/PATCH/PUT with system query options to shape response

ii. ODATA-1200 ODATA-884 / Support sample values for types, parameters, request/response bodies

iii. ODATA-1194 Add term Core.Example to allow including annotation examples in term definitions

iv. ODATA-1176 Capabilities: add new term SelectSupport

APPLIED

i. ODATA-1188 Allow using instance annotations in $select and $expand

https://github.com/oasis-tcs/odata-abnf/pull/7

ii. ODATA-1203 Allow numeric indexes in Path constructs within annotations

iii. ODATA-1183

iv. ODATA-1170 Allow @odata.type for isomorphy to CSDL XML

v. ODATA-1232 Support Union types

https://github.com/oasis-tcs/odata-vocabularies/pull/27

vi. ODATA-1229 Introduce LocalDateTime TypeDef to apply to string datatype

vii. ODATA-1208 Specify the finest possible granularity for Duration

viii. ODATA-1202 Deep update with nested delta items should allow Core.ContentID

ix. ODATA-1114 If-Then-Else in $batch requests

V4.01: NEW or OPEN

i. ODATA-1250 GeoJSON, SRID, and LineString

ii. ODATA-1249 edm.xsd: ActionImport and IncludeInServiceDocument

iii. ODATA-1248 csdl.schema.json: add descriptions to all schema elements

iv. ODATA-1245 Extract _expression_ syntax into own sub-section next to $filter

v. ODATA-1165 Describe $expand and $select via prose text and examples, remove ABNF snippets

vi. ODATA-1243 Clarify whether $orderby and string comparison with ge, gt, le, lt is language-specific

vii. ODATA-1242 Clarify that resolved relative URIs in batch responses cannot contain content-ID references

viii. ODATA-1226 Ambiguity with Capabilities.ChangeTracking annotation

ix. ODATA-1251 Should annotated null/default values be omitted/restored?

x. ODATA-1246 Allow BaseType to be a ComplexType

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

xii. ODATA-1238 Clarifications for select-list in ContextUrl

xiii. ODATA-1198 ETag handling deviations from RFC7232 are avoidable if we consider two kinds of ETag (ETag in response header and ETag in response payload)

xiv. ODATA-1168 Clarify the use of ETags for Avoiding Update Conflicts

xv. ODATA-1135 Document use of JSON $schema

xvi. ODATA-1064 Add ability to annotate collections to return only count and NextLink

xvii. ODATA-1005 Make sure we have capabilities for all new 4.01 functionality

Data Aggregation: NEW or OPEN

i. ODATA-1244 Extend compute to work with aggregated values calculated from the input set

ii. ODATA-1218 Transformations for recursive hierarchy processing

iii. ODATA-1207 Clarify need for @odata.id in nested response structures

iv. ODATA-947 Transformation for computing ratios with aggregated values

v. ODATA-945 Correct examples 53 and 54

Vocabularies: NEW or OPEN that need more discussion

i. ODATA-1140 ODATA-884 / Add details to HTTPResponseCode term

ii. ODATA-1099 Add annotations to describe custom query options and custom headers

iii. ODATA-884 Enable enumerating the valid requests and responses for a particular resource.

iv. ODATA-1214 Annotate constructor actions

v. ODATA-1177 Allow referencing a (JSON) schema for Edm.Untyped properties

vi. ODATA-1107 Introduce instance annotation to specify which types an instance "implements"

vii. ODATA-1060 Improve specification of element response requirements

7. Next meetings [9:50 am PT]

Thursday November 15, 2018 during 8-10 am PST (17:00-19:00 CET)
Thursday November 22, 2018 during 8-10 am PST (17:00-19:00 CET) – Thanksgiving in the United States – no meeting?
Thursday November 29, 2018 during 8-10 am PST (17:00-19:00 CET)

8. AOB and wrap up [9:55 am PT]

[2] References

Chat room: http://webconf.soaphub.org/conf/room/odatatc
Conference call & Screen sharing: https://lync.co.sap.com/meet/ralf.handl/Q4QB1098
Conference call details: https://www.oasis-open.org/apps/org/workgroup/odata/download.php/63673/latest/TC%20meeting%20dial-in%20details.htm

[3] Timeline

https://www.oasis-open.org/committees/download.php/62637/TC%20Timeline-2018-03-02.docx

odata message