RE: [odata] Agenda for OData TC meeting on 2018-01-18 - chat transcript

["Handl, Ralf" <ralf.handl@sap.com>]

[13:47] Room information was updated by: Stefan Drees

OASIS Open Data Protocol (OData) TC OData TC Weekly Meeting (Conference Call) #199

- Thursday, 18 January 2018, 08:00am to 10:00am PST

  - i.e. 2018-01-18 17:00 to 19:00 CET (UTC+1)

  - other timezone? Try eg.:

  - https://www.timeanddate.com/worldclock/meetingdetails.html?year=2018&month=1&day=18&hour=16&min=0&sec=0&p1=47&p2=69&p3=179

UsefulPlaces:

- Chat:

  - http://webconf.soaphub.org/conf/room/odatatc   # ... this place 

- ScreenShare and Voice:

  - https://sap.emea.pgiconnect.com/OData-TC/

Next Planned meetings (tentative):

- Thursday January 25, 2018 during 8-10 am PST?

  - https://www.oasis-open.org/apps/org/workgroup/odata/event.php?event_id=46240

Agenda-Draft E-Mail URL:

- E-Mail Public URL = "" href="https://lists.oasis-open.org/archives/odata/201801/msg00015.html" target="_blank">https://lists.oasis-open.org/archives/odata/201801/msg00015.html

Minutes Draft Public URL (previous meeting):

- URL = "" href="https://www.oasis-open.org/committees/download.php/62193/odata-meeting-198_on-20171207-minutes.html" target="_blank">https://www.oasis-open.org/committees/download.php/62193/odata-meeting-198_on-20171207-minutes.html

Online document walkthroughs or presentations:

- URL = "" href="https://sap.emea.pgiconnect.com/OData-TC/" target="_blank">https://sap.emea.pgiconnect.com/OData-TC/

Timeline(Updated!):

- URL = "" href="https://www.oasis-open.org/committees/download.php/61677/TC%20Timeline-2017-09-29.docx" target="_blank">https://www.oasis-open.org/committees/download.php/61677/TC%20Timeline-2017-09-29.docx

Agenda Draft (for meeting #199):

==============================================================

1. Roll call [8:00 am PT]

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

2. Approve agenda [8:05 am PT]

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

  3.1 Minutes from December 07, 2017 TC meeting: https://www.oasis-open.org/committees/download.php/62193/odata-meeting-198_on-20171207-minutes.html 

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

  4.1 Action items due

    4.1.1 none

5. Approve latest CSDs as CS01

  5.1 Review Summary of Non-Material Changes

    5.1.2 OData V4.01 CSD04 Summary of Non-Material Changes (2018-01-17)

  5.2 Sample Motions

    5.2.1 OData Version 4.01 Working Draft 05

      I move to approve the Chair requesting that TC Administration hold a Special Majority Vote to approve OData Version 4.01 Working Draft 05 contained in https://www.oasis-open.org/committees/download.php/62334/odata-v4.01-cs01-2018-01-17.zip as a Committee Specification. I further move that the TC affirm that changes have been made since the last public review, that the changes made are documented in https://www.oasis-open.org/committees/download.php/62333/odata-v4.01-csd04-non-material-changes-2018-01-17.docx and that the TC judges these changes to be Non-Material in accordance with the definition in the OASIS TC Process (https://www.oasis-open.org/policies-guidelines/oasis-defined-terms-2017-05-26#dNonmaterialChange).

    5.2.2 OData Common Schema Definition Language (CSDL) XML Representation Version 4.01 Working Draft 05

      I move to approve the Chair requesting that TC Administration hold a Special Majority Vote to approve OData Common Schema Definition Language (CSDL) XML Representation Version 4.01 Working Draft 05 contained in https://www.oasis-open.org/committees/download.php/62247/odata-csdl-xml-v4.01-cs01-2017-12-19.zip as a Committee Specification. I further move that the TC affirm that changes have been made since the last public review, that the changes made are documented in https://www.oasis-open.org/committees/download.php/62333/odata-v4.01-csd04-non-material-changes-2018-01-17.docx and that the TC judges these changes to be Non-Material in accordance with the definition in the OASIS TC Process (https://www.oasis-open.org/policies-guidelines/oasis-defined-terms-2017-05-26#dNonmaterialChange).

    5.2.3 OData Common Schema Definition Language (CSDL) JSON Representation Version 4.01 Working Draft 04

      I move to approve the Chair requesting that TC Administration hold a Special Majority Vote to approve OData Common Schema Definition Language (CSDL) JSON Representation Version 4.01 Working Draft 04 contained in https://www.oasis-open.org/committees/download.php/62248/odata-csdl-json-v4.01-cs01-2017-12-19.zip as a Committee Specification. I further move that the TC affirm that changes have been made since the last public review, that the changes made are documented in https://www.oasis-open.org/committees/download.php/62333/odata-v4.01-csd04-non-material-changes-2018-01-17.docx and that the TC judges these changes to be Non-Material in accordance with the definition in the OASIS TC Process (https://www.oasis-open.org/policies-guidelines/oasis-defined-terms-2017-05-26#dNonmaterialChange).

    5.2.4 OData JSON Format Version 4.01 Working Draft 05

      I move to approve the Chair requesting that TC Administration hold a Special Majority Vote to approve OData JSON Format Version 4.01 Working Draft 05 contained in https://www.oasis-open.org/committees/download.php/62246/odata-json-format-v4.01-cs01-2017-12-19.zip as a Committee Specification. I further move that the TC affirm that changes have been made since the last public review, that the changes made are documented in https://www.oasis-open.org/committees/download.php/62333/odata-v4.01-csd04-non-material-changes-2018-01-17.docx and that the TC judges these changes to be Non-Material in accordance with the definition in the OASIS TC Process (https://www.oasis-open.org/policies-guidelines/oasis-defined-terms-2017-05-26#dNonmaterialChange).

  5.3 Issues

    5.3.1 ODATA-1139 Clarify: contains, startswith, endswith, indexof should all be case-sensitive

6. Issues [8:20 am PT]

  6.1 Vocabularies: APPLIED

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

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

    6.1.3 ODATA-1124 Authorization vocabulary: KeyLocation - also allow cookie as value?

    6.1.4 ODATA-1134 Add KeyAsSegmentSupported annotation term to Capabilities vocabulary

  6.2 Vocabularies: NEW or OPEN

    6.2.1 ODATA-1132 Propagation of NavigationRestrictions

    6.2.2 ODATA-1121 Extend FilterExpressionRestrictions with "MultiPredicate"

    6.2.3 ODATA-1067 Consider ability to define computed default values

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

    6.2.5 ODATA-884 Add term ErrorCodes to describe possible codes in error messages (public comment c201510e00019)

7. Committee Note on Google Protocol Buffers as an alternative data format [9:30 am PT]

  7.1 George: describe use case and purpose of the proposed committee note

8. Structural Property with Type=<Entity Type> versus Containment Navigation Property [9:40 am PT]

  8.1 George: describe use case and why containment navigation properties arent sufficient

9. Next meetings [9:50 am PT]

  9.1 Thursday January 25, 2018 during 8-10 am PST?

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

==============================================================

Meeting Member URL:

- URL = "" href="https://www.oasis-open.org/apps/org/workgroup/odata/event.php?event_id=46239" target="_blank">https://www.oasis-open.org/apps/org/workgroup/odata/event.php?event_id=46239

  - Please use starting approx. 15 minutes before the meeting for self registration. Thanks.

  - Self registration deep link (as a service):

    - https://www.oasis-open.org/apps/org/workgroup/odata/record_my_attendance.php?event_id=46239&confirmed=1

[13:47] Stefan Drees: Above direct registration link checked successfully 

[14:17] Stefan Drees morphed into Stefan Hagen

[14:41] Stefan Hagen: KeepAlive

[15:41] Stefan Hagen: KeepAlive

[16:58] Stefan Hagen: H4Q::Voting Members: 2 of 12 (16%) (used for quorum calculation)

[17:02] anonymous morphed into Mark Biamonte (Progress)

[17:05] Ralf Handl (SAP SE): Voting Members: 7 of 12 (58%) (used for quorum calculation)

[17:09] Ralf Handl (SAP SE): 2.Approve agenda [8:05 am PT]

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

a.Minutes from December 07, 2017 TC meeting: https://www.oasis-open.org/committees/download.php/62193/odata-meeting-198_on-20171207-minutes.html

Room Information:

OASIS Open Data Protocol (OData) TC OData TC Weekly Meeting (Conference Call) #199

- Thursday, 18 January 2018, 08:00am to 10:00am PST

  - i.e. 2018-01-18 17:00 to 19:00 CET (UTC+1)

  - other timezone? Try eg.:

  - https://www.timeanddate.com/worldclock/meetingdetails.html?year=2018&month=1&day=18&hour=16&min=0&sec=0&p1=47&p2=69&p3=179

UsefulPlaces:

- Chat:

  - http://webconf.soaphub.org/conf/room/odatatc   # ... this place 

- ScreenShare and Voice:

  - https://sap.emea.pgiconnect.com/OData-TC/

Next Planned meetings (tentative):

- Thursday January 25, 2018 during 8-10 am PST?

  - https://www.oasis-open.org/apps/org/workgroup/odata/event.php?event_id=46240

Agenda-Draft E-Mail URL:

- E-Mail Public URL = "" href="https://lists.oasis-open.org/archives/odata/201801/msg00015.html" target="_blank">https://lists.oasis-open.org/archives/odata/201801/msg00015.html

Minutes Draft Public URL (previous meeting):

- URL = "" href="https://www.oasis-open.org/committees/download.php/62193/odata-meeting-198_on-20171207-minutes.html" target="_blank">https://www.oasis-open.org/committees/download.php/62193/odata-meeting-198_on-20171207-minutes.html

Online document walkthroughs or presentations:

- URL = "" href="https://sap.emea.pgiconnect.com/OData-TC/" target="_blank">https://sap.emea.pgiconnect.com/OData-TC/

Timeline(Updated!):

- URL = "" href="https://www.oasis-open.org/committees/download.php/61677/TC%20Timeline-2017-09-29.docx" target="_blank">https://www.oasis-open.org/committees/download.php/61677/TC%20Timeline-2017-09-29.docx

Agenda Draft (for meeting #199):

==============================================================

1. Roll call [8:00 am PT]

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

2. Approve agenda [8:05 am PT]

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

  3.1 Minutes from December 07, 2017 TC meeting: https://www.oasis-open.org/committees/download.php/62193/odata-meeting-198_on-20171207-minutes.html 

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

  4.1 Action items due

    4.1.1 none

5. Approve latest CSDs as CS01

  5.1 Review Summary of Non-Material Changes

    5.1.2 OData V4.01 CSD04 Summary of Non-Material Changes (2018-01-17)

  5.2 Sample Motions

    5.2.1 OData Version 4.01 Working Draft 05

      I move to approve the Chair requesting that TC Administration hold a Special Majority Vote to approve OData Version 4.01 Working Draft 05 contained in https://www.oasis-open.org/committees/download.php/62334/odata-v4.01-cs01-2018-01-17.zip as a Committee Specification. I further move that the TC affirm that changes have been made since the last public review, that the changes made are documented in https://www.oasis-open.org/committees/download.php/62333/odata-v4.01-csd04-non-material-changes-2018-01-17.docx and that the TC judges these changes to be Non-Material in accordance with the definition in the OASIS TC Process (https://www.oasis-open.org/policies-guidelines/oasis-defined-terms-2017-05-26#dNonmaterialChange).

    5.2.2 OData Common Schema Definition Language (CSDL) XML Representation Version 4.01 Working Draft 05

      I move to approve the Chair requesting that TC Administration hold a Special Majority Vote to approve OData Common Schema Definition Language (CSDL) XML Representation Version 4.01 Working Draft 05 contained in https://www.oasis-open.org/committees/download.php/62247/odata-csdl-xml-v4.01-cs01-2017-12-19.zip as a Committee Specification. I further move that the TC affirm that changes have been made since the last public review, that the changes made are documented in https://www.oasis-open.org/committees/download.php/62333/odata-v4.01-csd04-non-material-changes-2018-01-17.docx and that the TC judges these changes to be Non-Material in accordance with the definition in the OASIS TC Process (https://www.oasis-open.org/policies-guidelines/oasis-defined-terms-2017-05-26#dNonmaterialChange).

    5.2.3 OData Common Schema Definition Language (CSDL) JSON Representation Version 4.01 Working Draft 04

      I move to approve the Chair requesting that TC Administration hold a Special Majority Vote to approve OData Common Schema Definition Language (CSDL) JSON Representation Version 4.01 Working Draft 04 contained in https://www.oasis-open.org/committees/download.php/62248/odata-csdl-json-v4.01-cs01-2017-12-19.zip as a Committee Specification. I further move that the TC affirm that changes have been made since the last public review, that the changes made are documented in https://www.oasis-open.org/committees/download.php/62333/odata-v4.01-csd04-non-material-changes-2018-01-17.docx and that the TC judges these changes to be Non-Material in accordance with the definition in the OASIS TC Process (https://www.oasis-open.org/policies-guidelines/oasis-defined-terms-2017-05-26#dNonmaterialChange).

    5.2.4 OData JSON Format Version 4.01 Working Draft 05

      I move to approve the Chair requesting that TC Administration hold a Special Majority Vote to approve OData JSON Format Version 4.01 Working Draft 05 contained in https://www.oasis-open.org/committees/download.php/62246/odata-json-format-v4.01-cs01-2017-12-19.zip as a Committee Specification. I further move that the TC affirm that changes have been made since the last public review, that the changes made are documented in https://www.oasis-open.org/committees/download.php/62333/odata-v4.01-csd04-non-material-changes-2018-01-17.docx and that the TC judges these changes to be Non-Material in accordance with the definition in the OASIS TC Process (https://www.oasis-open.org/policies-guidelines/oasis-defined-terms-2017-05-26#dNonmaterialChange).

  5.3 Issues

    5.3.1 ODATA-1139 Clarify: contains, startswith, endswith, indexof should all be case-sensitive

6. Issues [8:20 am PT]

  6.1 Vocabularies: APPLIED

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

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

    6.1.3 ODATA-1124 Authorization vocabulary: KeyLocation - also allow cookie as value?

    6.1.4 ODATA-1134 Add KeyAsSegmentSupported annotation term to Capabilities vocabulary

  6.2 Vocabularies: NEW or OPEN

    6.2.1 ODATA-1132 Propagation of NavigationRestrictions

    6.2.2 ODATA-1121 Extend FilterExpressionRestrictions with "MultiPredicate"

    6.2.3 ODATA-1067 Consider ability to define computed default values

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

    6.2.5 ODATA-884 Add term ErrorCodes to describe possible codes in error messages (public comment c201510e00019)

7. Committee Note on Google Protocol Buffers as an alternative data format [9:30 am PT]

  7.1 George: describe use case and purpose of the proposed committee note

8. Structural Property with Type=<Entity Type> versus Containment Navigation Property [9:40 am PT]

  8.1 George: describe use case and why containment navigation properties arent sufficient

9. Next meetings [9:50 am PT]

  9.1 Thursday January 25, 2018 during 8-10 am PST?

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

==============================================================

Meeting Member URL:

- URL = "" href="https://www.oasis-open.org/apps/org/workgroup/odata/event.php?event_id=46239" target="_blank">https://www.oasis-open.org/apps/org/workgroup/odata/event.php?event_id=46239

  - Please use starting approx. 15 minutes before the meeting for self registration. Thanks.

  - Self registration deep link (as a service):

    - https://www.oasis-open.org/apps/org/workgroup/odata/record_my_attendance.php?event_id=46239&confirmed=1

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

a.Action items due

i.none

[17:11] Ralf Handl (SAP SE): a.Action items due

i.none

5.Approve latest CSDs as CS01

a.Review Summary of Non-Material Changes

i.OData V4.01 CSD04 Summary of Non-Material Changes (2018-01-17)

[17:12] Ralf Handl (SAP SE): https://www.oasis-open.org/apps/org/workgroup/odata/download.php/62333/odata-v4.01-csd04-non-material-changes-2018-01-17.docx

[17:21] Michael Pizzo: i.ODATA-1139 Clarify: contains, startswith, endswith, indexof should all be case-sensitive

[17:21] Michael Pizzo: https://issues.oasis-open.org/browse/ODATA-1139

[17:22] Ralf Handl (SAP SE): ODATA-1139 is OPEN

[17:23] Michael Pizzo: I move we approve ODATA-1139 as proposed.

[17:23] Hubert Heijkers (IBM): I second

[17:23] Ralf Handl (SAP SE): ODATA-1139 is RESOLVED as proposed

[17:33] Michael Pizzo: I move we close ODATA-1139 as applied.

[17:33] Hubert Heijkers (IBM): I second

[17:33] Ralf Handl (SAP SE): ODATA-1139 is CLOSED as applied

[17:40] Hubert Heijkers (IBM): I move to approve the Chair requesting that TC Administration hold a Special Majority Vote to approve OData Version 4.01 Working Draft 05 contained in https://www.oasis-open.org/committees/download.php/62334/odata-v4.01-cs01-2018-01-17.zip as a Committee Specification. I further move that the TC affirm that changes have been made since the last public review, that the changes made are documented in https://www.oasis-open.org/committees/download.php/62333/odata-v4.01-csd04-non-material-changes-2018-01-17.docx and that the TC judges these changes to be Non-Material in accordance with the definition in the OASIS TC Process (https://www.oasis-open.org/policies-guidelines/oasis-defined-terms-2017-05-26#dNonmaterialChange).

[17:41] Michael Pizzo: I second

[17:42] Ralf Handl (SAP SE): No objection, motion passes

[17:44] Mark Biamonte (Progress): ii.I move to approve the Chair requesting that TC Administration hold a Special Majority Vote to approve OData Common Schema Definition Language (CSDL) XML Representation Version 4.01 Working Draft 05 contained in https://www.oasis-open.org/committees/download.php/62247/odata-csdl-xml-v4.01-cs01-2017-12-19.zip as a Committee Specification. I further move that the TC affirm that changes have been made since the last public review, that the changes made are documented in https://www.oasis-open.org/committees/download.php/62333/odata-v4.01-csd04-non-material-changes-2018-01-17.docx and that the TC judges these changes to be Non-Material in accordance with the definition in the OASIS TC Process (https://www.oasis-open.org/policies-guidelines/oasis-defined-terms-2017-05-26#dNonmaterialChange).

[17:45] Michael Pizzo: I second

[17:45] Ralf Handl (SAP SE): No objection, motion passes

[17:48] Mark Biamonte (Progress): iii.I move to approve the Chair requesting that TC Administration hold a Special Majority Vote to approve OData Common Schema Definition Language (CSDL) JSON Representation Version 4.01 Working Draft 04 contained in https://www.oasis-open.org/committees/download.php/62248/odata-csdl-json-v4.01-cs01-2017-12-19.zip as a Committee Specification. I further move that the TC affirm that changes have been made since the last public review, that the changes made are documented in https://www.oasis-open.org/committees/download.php/62333/odata-v4.01-csd04-non-material-changes-2018-01-17.docx and that the TC judges these changes to be Non-Material in accordance with the definition in the OASIS TC Process (https://www.oasis-open.org/policies-guidelines/oasis-defined-terms-2017-05-26#dNonmaterialChange).

[17:49] Ted Jones (Red Hat): I second

[17:49] Ralf Handl (SAP SE): No objection, motion passes

[17:51] Michael Pizzo: iv.I move to approve the Chair requesting that TC Administration hold a Special Majority Vote to approve OData JSON Format Version 4.01 Working Draft 05 contained in https://www.oasis-open.org/committees/download.php/62246/odata-json-format-v4.01-cs01-2017-12-19.zip as a Committee Specification. I further move that the TC affirm that changes have been made since the last public review, that the changes made are documented in https://www.oasis-open.org/committees/download.php/62333/odata-v4.01-csd04-non-material-changes-2018-01-17.docx and that the TC judges these changes to be Non-Material in accordance with the definition in the OASIS TC Process (https://www.oasis-open.org/policies-guidelines/oasis-defined-terms-2017-05-26#dNonmaterialChange).

[17:51] Hubert Heijkers (IBM): I second

[17:51] Ralf Handl (SAP SE): No objection, motion passes

[17:58] Ralf Handl (SAP SE): 6.Issues [8:20 am PT]

a.Vocabularies: APPLIED

[17:58] Ralf Handl (SAP SE): i.ODATA-1064 Add ability to annotate collections to return only count and NextLink

[17:59] Ralf Handl (SAP SE): Skip for today

[18:00] Ralf Handl (SAP SE): ii.ODATA-1099 Add annotations to describe custom query options and custom headers

[18:00] Ralf Handl (SAP SE): Mike: discuss this together with ODATA-884

[18:01] Ralf Handl (SAP SE): iii.ODATA-1124 Authorization vocabulary: KeyLocation - also allow cookie as value?

[18:02] Stefan Hagen: @Ralf: Stefan will upload a minutes draft later this European evening, so the admin requests for publication have a reference

[18:02] Ralf Handl (SAP SE): @Stefan: Thanks!

[18:03] Michael Pizzo: I move we close ODATA-1124 as applied.

[18:03] Hubert Heijkers (IBM): I second

[18:04] Ralf Handl (SAP SE): ODATA-1124 is CLOSED as applied

[18:06] Michael Pizzo: https://github.com/oasis-tcs/odata-vocabularies/pull/4

[18:09] Ralf Handl (SAP SE): iv.ODATA-1134 Add KeyAsSegmentSupported annotation term to Capabilities vocabulary

[18:15] Michael Pizzo: https://github.com/oasis-tcs/odata-vocabularies/pull/5

[18:16] Hubert Heijkers (IBM): I move to close ODATA-1134 as applied.

[18:16] Michael Pizzo: I second

[18:16] Ralf Handl (SAP SE): ODATA-1134 is CLOSED as applied

[18:17] Ralf Handl (SAP SE): b.Vocabularies: NEW or OPEN

[18:18] Ralf Handl (SAP SE): v.ODATA-884 Add term ErrorCodes to describe possible codes in error messages (public comment c201510e00019)

[18:21] Michael Pizzo: <Term Name="HttpRequests" Type="Collection(Core.HttpRequest)" AppliesTo="EntitySet Singleton ActionImport FunctionImport Action Function"> 

<Annotation Term="Core.Description" String="Describes possible HTTP requests" /> 

<Annotation Term="Core.LongDescription" String="The list need not be complete. It may be used to generate API documentation, so restricting it to the most common and most important responses may increase readability." /> 

</Term> 

<ComplexType Name="HttpRequest"> 

<Property Name="Method" Type="Edm.String"> 

<Annotation Term="Core.Description" String="Request verb of the HTTP request, e.g. GET, POST, PATCH, DELETE" /> 

</Property> 

<Property Name="CustomQueryOptions" Type="Collection(Capabilities.CustomParameter)" AppliesTo="EntityContainer EntitySet Singleton Action ActionImport Function FunctionImport"> 

<Annotation Term="Core.Description" String="Custom query options that are supported/required for the annotated resource" /> 

</Property> 

<Property Name="CustomHeaders" Type="Collection(Core.CustomParameter)"> 

<Annotation Term="Core.Description" String="Custom headers that are supported/required for the annotated resource" /> 

</Property> 

<Property Name="HttpResponses" Type="Collection(Core.HttpResponse)"> 

<Annotation Term="Core.Description" String="Possible HTTP Responses returned by the request." /> 

</Property> 

</ComplexType> 

<ComplexType Name="HttpResponse"> 

<Property Name="ResponseCode" Type="Edm.String"> 

<Annotation Term="Core.Description" String="HTTP status code of the response, e.g. 400, 403, 501" /> 

</Property> 

<Property Name="Description" Type="Edm.String"> 

<Annotation Term="Core.Description" String="Human-readable description of the response code." /> 

<Annotation Term="Core.IsLanguageDependent" /> 

</Property> 

<Property Name="Conditions" Type="Collection(Core.HttpStatusCodeCondition)"> 

<Annotation Term="Core.Description" String="Descriptions of conditions resulting in the specified status code." /> 

</Property> 

</ComplexType> 

<ComplexType Name="HttpStatusCodeCondition"> 

<Property Name="ODataErrorCode" Type="Edm.String"> 

<Annotation Term="Core.Description" String="Language-independent, machine-readable OData error code" /> 

</Property> 

<Property Name="Description" Type="Edm.String"> 

<Annotation Term="Core.Description" String="Human-readable description of the response situation" /> 

<Annotation Term="Core.IsLanguageDependent" /> 

</Property> 

</ComplexType> 

<ComplexType Name="CustomParameter"> 

<Annotation Term="Core.Description" String="A custom parameter is either a header or a query option" /> 

<Annotation Term="Core.LongDescription" String="The type of a custom parameter is always a string. Restrictions on the parameter values can be expressed by annotating the record _expression_ describing the parameter with terms from the Validation vocabulary, e.g. Validation.Pattern or Validation.AllowedValues." /> 

<Property Name="Name" Type="Edm.String" Nullable="false"> 

<Annotation Term="Core.Description" String="Name of the custom parameter" /> 

</Property> 

<Property Name="Description" Type="Edm.String"> 

<Annotation Term="Core.Description" String="Description of the custom parameter" /> 

</Property> 

<Property Name="DocumentationURL" Type="Edm.String"> 

<Annotation Term="Core.IsURL" /> 

<Annotation Term="Core.Description" String="URL of related documentation" /> 

</Property> 

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

<Annotation Term="Core.Description" String="true: parameter is required, false or not specified: parameter is optional" /> 

</Property> 

<Property Name="ExampleValues" Type="Collection(Capabilities.CustomParameterExampleValue)" Nullable="false"> 

<Annotation Term="Core.Description" String="Example values for the custom parameter" /> 

</Property> 

</ComplexType> 

<ComplexType Name="CustomParameterExampleValue"> 

<Property Name="Value" Type="Edm.String" Nullable="false"> 

<Annotation Term="Core.Description" String="Example value for the custom parameter" /> 

</Property> 

<Property Name="Description" Type="Edm.String" Nullable="false"> 

<Annotation Term="Core.Description" String="Description of the example value" /> 

</Property> 

</ComplexType>

[18:33] Michael Pizzo: I propose we re-open ODATA-1099 and amend the proposal to restrict the "AppliesTo" to "EntityContainer". This would allow us to specify global (service-wide) query options or headers. Resource-specific header and query option requirements would be applied through the HttpRequests annotation term defined in ODATA-884.

[18:35] Ralf Handl (SAP SE): I second

[18:36] Michael Pizzo: This would apply to both terms defined in ODATA-1099.

[18:40] Ralf Handl (SAP SE): ODATA-1099 is OPEN (again)

[18:42] Hubert Heijkers (IBM): I move to resolve ODATA-1099 as per Mike's proposal, limiting the applicability of the 'CustomHeaders' and 'CustomQueryOptions' to just the EntityContainer.

[18:43] Michael Pizzo: I second

[18:43] Ralf Handl (SAP SE): ODATA-1099 is RESOLVED with the above proposal

[18:53] Ralf Handl (SAP SE): https://github.com/OAI/OpenAPI-Specification/issues/1392

[18:54] Ralf Handl (SAP SE): https://datatracker.ietf.org/doc/rfc7807/?include_text=1

[18:54] Ralf Handl (SAP SE): Problem Details for HTTP APIs

[18:57] Ralf Handl (SAP SE): Mike to split off the "Conditions" into a separate issue

[18:58] Ralf Handl (SAP SE): 9.Next meetings [9:50 am PT]

a.Thursday January 25, 2018 during 8-10 am PST?

[18:59] Ralf Handl (SAP SE): b.Thursday February 1, 2018 during 8-10 am PST?

[18:59] Ralf Handl (SAP SE): 10.AOB and wrap up [9:55 am PT]

[18:59] Ralf Handl (SAP SE): Meeting is adjourned

 

 

From: odata@lists.oasis-open.org [mailto:odata@lists.oasis-open.org] On Behalf Of Handl, Ralf
Sent: Mittwoch, 17. Januar 2018 14:54
To: odata@lists.oasis-open.org
Subject: RE: [odata] Agenda for OData TC meeting on 2018-01-18

 

5.a and 5.b.i-iv: new revision of OData V4.01 CSD04 Summary of Non-Material Changes (2018-01-17)

 

5.b.i: new revision of OData V4.01 WD05 CS01 zip file with URL Conventions plus application of ODATA-1139

 

5.c.i: ODATA-1139

 

 

From: odata@lists.oasis-open.org [mailto:odata@lists.oasis-open.org] On Behalf Of Handl, Ralf
Sent: Mittwoch, 10. Januar 2018 18:34
To: odata@lists.oasis-open.org
Subject: [odata] Agenda for OData TC meeting on 2018-01-18

 

Note: due to several conflicts we (Mike and Ralf) assume that we would not reach quorum tomorrow, so we will start the meeting series for this year one week later

 

 

Here [1] is a draft agenda for the OData TC (Technical Committee) meeting scheduled on Thursday January 18, 2018 during 8-10 am PST (17:00-19:00 CET). 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]

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

 

2.        Approve agenda [8:05 am PT]

 

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

1. Minutes from December 07, 2017 TC meeting: https://www.oasis-open.org/committees/download.php/62193/odata-meeting-198_on-20171207-minutes.html

 

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

1. Action items due

                                  i.    none

 

5.        Approve latest CSDs as CS01

1. Review Summary of Non-Material Changes

                                  i.    OData V4.01 CSD04 Summary of Non-Material Changes (2018-01-17)

 

2. Sample Motions

                                  i.    I move to approve the Chair requesting that TC Administration hold a Special Majority Vote to approve OData Version 4.01 Working Draft 05 contained in https://www.oasis-open.org/committees/download.php/62334/odata-v4.01-cs01-2018-01-17.zip as a Committee Specification. I further move that the TC affirm that changes have been made since the last public review, that the changes made are documented in https://www.oasis-open.org/committees/download.php/62333/odata-v4.01-csd04-non-material-changes-2018-01-17.docx and that the TC judges these changes to be Non-Material in accordance with the definition in the OASIS TC Process (https://www.oasis-open.org/policies-guidelines/oasis-defined-terms-2017-05-26#dNonmaterialChange).

                                 ii.    I move to approve the Chair requesting that TC Administration hold a Special Majority Vote to approve OData Common Schema Definition Language (CSDL) XML Representation Version 4.01 Working Draft 05 contained in https://www.oasis-open.org/committees/download.php/62247/odata-csdl-xml-v4.01-cs01-2017-12-19.zip as a Committee Specification. I further move that the TC affirm that changes have been made since the last public review, that the changes made are documented in https://www.oasis-open.org/committees/download.php/62333/odata-v4.01-csd04-non-material-changes-2018-01-17.docx and that the TC judges these changes to be Non-Material in accordance with the definition in the OASIS TC Process (https://www.oasis-open.org/policies-guidelines/oasis-defined-terms-2017-05-26#dNonmaterialChange).

                                iii.    I move to approve the Chair requesting that TC Administration hold a Special Majority Vote to approve OData Common Schema Definition Language (CSDL) JSON Representation Version 4.01 Working Draft 04 contained in https://www.oasis-open.org/committees/download.php/62248/odata-csdl-json-v4.01-cs01-2017-12-19.zip as a Committee Specification. I further move that the TC affirm that changes have been made since the last public review, that the changes made are documented in https://www.oasis-open.org/committees/download.php/62333/odata-v4.01-csd04-non-material-changes-2018-01-17.docx and that the TC judges these changes to be Non-Material in accordance with the definition in the OASIS TC Process (https://www.oasis-open.org/policies-guidelines/oasis-defined-terms-2017-05-26#dNonmaterialChange).

                                iv.    I move to approve the Chair requesting that TC Administration hold a Special Majority Vote to approve OData JSON Format Version 4.01 Working Draft 05 contained in https://www.oasis-open.org/committees/download.php/62246/odata-json-format-v4.01-cs01-2017-12-19.zip as a Committee Specification. I further move that the TC affirm that changes have been made since the last public review, that the changes made are documented in https://www.oasis-open.org/committees/download.php/62333/odata-v4.01-csd04-non-material-changes-2018-01-17.docx and that the TC judges these changes to be Non-Material in accordance with the definition in the OASIS TC Process (https://www.oasis-open.org/policies-guidelines/oasis-defined-terms-2017-05-26#dNonmaterialChange).

 

3. Issues

                                  i.    ODATA-1139 Clarify: contains, startswith, endswith, indexof should all be case-sensitive

 

6.        Issues [8:20 am PT]

1. Vocabularies: APPLIED

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

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

                                iii.    ODATA-1124 Authorization vocabulary: KeyLocation - also allow cookie as value?

                                iv.    ODATA-1134 Add KeyAsSegmentSupported annotation term to Capabilities vocabulary

 

2. Vocabularies: NEW or OPEN

                                  i.    ODATA-1132 Propagation of NavigationRestrictions

                                 ii.    ODATA-1121 Extend FilterExpressionRestrictions with "MultiPredicate"

                                iii.    ODATA-1067 Consider ability to define computed default values

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

                                 v.    ODATA-884 Add term ErrorCodes to describe possible codes in error messages (public comment c201510e00019)

 

7.        Committee Note on Google Protocol Buffers as an alternative data format [9:30 am PT]

1. George: describe use case and purpose of the proposed committee note

 

8.        Structural Property with Type=<Entity Type> versus Containment Navigation Property [9:40 am PT]

1. George: describe use case and why containment navigation properties aren’t sufficient

 

9.        Next meetings [9:50 am PT]

1. Thursday January 25, 2018 during 8-10 am PST?

 

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

 

[2] References

• Chat room: http://webconf.soaphub.org/conf/room/odatatc
• Conference call & Screen sharing: https://sap.emea.pgiconnect.com/OData-TC
• Conference call details: https://www.oasis-open.org/apps/org/workgroup/odata/download.php/56760/TC%20meeting%20dial-in%20details.htm

 

[3] Timeline

• https://www.oasis-open.org/committees/download.php/61677/TC%20Timeline-2017-09-29.docx