RE: [odata] Agenda for OData TC meeting on 2017-08-24

[13:39] Room information was updated by: Stefan Hagen

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

- Thursday, 24 August 2017, 08:00am to 10:00am PDT

  - i.e. 2017-08-24 17:00 to 19:00 CEST (UTC+2)

  - other timezone? Try eg.:

  - https://www.timeanddate.com/worldclock/meetingdetails.html?year=2017&month=8&day=24&hour=15&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 August 31, 2017 during 8-10 am PDT (17:00-19:00 CEST)

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

- Thursday September 07, 2017 during 8-10 am PDT?

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

Agenda-Draft E-Mail URL:

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

Minutes Draft Public URL (previous meeting):

- URL = "" href="https://www.oasis-open.org/committees/download.php/61331/odata-meeting-183_on-20170803-minutes.html" target="_blank">https://www.oasis-open.org/committees/download.php/61331/odata-meeting-183_on-20170803-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:

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

Agenda Draft (for meeting #184):

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

1.  Roll call

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

2.  Approve agenda

3.  Approve minutes from previous meeting(s)

  a.  Minutes from August 03, 2017 TC meeting: https://www.oasis-open.org/committees/download.php/61331/odata-meeting-183_on-20170803-minutes.html

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

  a.  Action items due

    i.    None

5.  Version 4.01  next Public Review

  a.  NEW or OPEN

    i.    ODATA-1100 Add mechanism for specifying match type for $search

    ii.   ODATA-1101 The hash (#) character is not allowed in search phrases per the ABNF definition

    iii.  ODATA-1103 Special values of temporal types (public comment c201708e0003)

    iv.   ODATA-1104 Make "@" optional for parameters

    v.    ODATA-1105 Simplify selection of properties of complex type

    vi.   ODATA-1106 Introduce mechanism for selecting default properties

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

  b.  Document Walkthrough

    i.    Part 1: Protocol  https://www.oasis-open.org/committees/download.php/61368/odata-v4.01-wd03-part1-protocol-2017-08-10.docx

    ii.   Part 2: URL Conventions  https://www.oasis-open.org/committees/download.php/61369/odata-v4.01-wd03-part2-url-conventions-2017-08-10.docx

    iii.  ABNF  https://tools.oasis-open.org/version-control/browse/wsvn/odata/trunk/4.01%20spec/ABNF/odata-abnf-construction-rules.txt?op=diff&rev=1064

    iv.   CSDL JSON  https://www.oasis-open.org/committees/download.php/61370/odata-csdl-json-v4.01-wd02-2017-08-10.docx

    v.    CSDL XML  https://www.oasis-open.org/committees/download.php/61371/odata-csdl-xml-v4.01-wd03-2017-08-10.docx

    vi.   Edm.xsd

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

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

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

    vii.  JSON Format  https://www.oasis-open.org/committees/download.php/61412/odata-json-format-v4.01-wd03-2017-08-18.docx

    viii. New in OData 4.01  https://www.oasis-open.org/committees/download.php/61413/new-in-odata-v4.01-wd02-2017-08-18.docx

  c.  Close APPLIED issues

    i.    I move to close ODATA-1086, ODATA-1087, ODATA-1090, ODATA-1091, ODATA-1092, ODATA-1094, ODATA-1095, ODATA-1096, ODATA-1097, and ODATA-1102 as applied.

  d.  Request next public review  if time allows preparing the zip files during the TC meeting

    i.    Sample Motion for Part 1 and Part 2:

      I move that the TC approve OData V4.01 Working Draft 03 and all associated artifacts packaged together in <insert_zip> as Committee Specification Draft 03 and designate the Microsoft Word version of the specification as authoritative. I further move that the TC approve submitting the aforementioned Committee Specification Draft 03 for 15 days of public review.

    ii.   Sample Motion for CSDL XML:

      I move that the TC approve OData Common Schema Definition Language (CSDL) XML Representation V4.01 Working Draft 03 and all associated artifacts packaged together in <insert_zip> as Committee Specification Draft 03 and designate the Microsoft Word version of the specification as authoritative. I further move that the TC approve submitting the aforementioned Committee Specification Draft 03 for 15 days of public review.

    iii.  Sample Motion for CSDL JSON:

      I move that the TC approve OData Common Schema Definition Language (CSDL) JSON Representation V4.01 Working Draft 02 and all associated artifacts packaged together in <insert_zip> as Committee Specification Draft 02 and designate the Microsoft Word version of the specification as authoritative. I further move that the TC approve submitting the aforementioned Committee Specification Draft 02 for 15 days of public review.

    iv.   Sample Motion for JSON Format:

      I move that the TC approve OData JSON Format V4.01 Working Draft 03 and all associated artifacts packaged together in <insert_zip> as Committee Specification Draft 03 and designate the Microsoft Word version of the specification as authoritative. I further move that the TC approve submitting the aforementioned Committee Specification Draft 03 for 15 days of public review.

    v.    Sample Motion for New in OData 4.01:

      I move that the TC approve Whats New in OData 4.01 Working Draft 02 and all associated artifacts packaged together in <insert_zip> as Committee Note 02 and designate the Microsoft Word version of the note as authoritative.

6.  Issues

  a.  Vocabularies: NEW or OPEN

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

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

    iii.  ODATA-1060 Improve specification of element response requirements

    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)

  b.  Vocabularies: APPLIED

    i.    ODATA-958 Capabilities: FilterRestrictions and SortRestrictions for navigation properties

    ii.   ODATA-1055 DeepInsertSupport: allow applying to entity sets and collection-valued navigation properties

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

    iv.   ODATA-1069 New term Core.OperationAvailable

    v.    ODATA-1079 Several issues with latest standard vocabularies

    vi.   ODATA-1082 Add term Constraint to Validation vocabulary

    vii.  ODATA-1089 Org.OData.Aggregation.V1 missing Nullable="false" for Function ReturnType

    viii. ODATA-1098 xxxRestrictions can be applied more broadly

7.  Data Aggregation

  a.  Gerald to walk us through the proposal on

    i.    Grid-Like Access to Aggregated Data.docx

8.  Next meetings

  a.  Thursday August 31, 2017 during 8-10 am PDT

  b.  Thursday September 07, 2017 during 8-10 am PDT

9.  AOB and wrap up

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

Meeting Member URL:

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

  - 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=43992&confirmed=1

[14:20] Stefan Hagen: .pleaseIgnore[KeepAlive]

[14:55] Stefan Hagen: .pleaseIgnore[KeepAlive]

[15:20] Stefan Hagen: .pleaseIgnore[KeepAlive]

[15:40] Stefan Hagen: .pleaseIgnore[KeepAlive]

[16:01] Stefan1: .pleaseIfnore[KeepAlive]

[16:46] Stefan: .pleaseIgnore

[16:56] anonymous morphed into Ted Jones (Red Hat)

Room Information:

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

- Thursday, 24 August 2017, 08:00am to 10:00am PDT

  - i.e. 2017-08-24 17:00 to 19:00 CEST (UTC+2)

  - other timezone? Try eg.:

  - https://www.timeanddate.com/worldclock/meetingdetails.html?year=2017&month=8&day=24&hour=15&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 August 31, 2017 during 8-10 am PDT (17:00-19:00 CEST)

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

- Thursday September 07, 2017 during 8-10 am PDT?

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

Agenda-Draft E-Mail URL:

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

Minutes Draft Public URL (previous meeting):

- URL = "" href="https://www.oasis-open.org/committees/download.php/61331/odata-meeting-183_on-20170803-minutes.html" target="_blank">https://www.oasis-open.org/committees/download.php/61331/odata-meeting-183_on-20170803-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:

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

Agenda Draft (for meeting #184):

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

1.  Roll call

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

2.  Approve agenda

3.  Approve minutes from previous meeting(s)

  a.  Minutes from August 03, 2017 TC meeting: https://www.oasis-open.org/committees/download.php/61331/odata-meeting-183_on-20170803-minutes.html

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

  a.  Action items due

    i.    None

5.  Version 4.01  next Public Review

  a.  NEW or OPEN

    i.    ODATA-1100 Add mechanism for specifying match type for $search

    ii.   ODATA-1101 The hash (#) character is not allowed in search phrases per the ABNF definition

    iii.  ODATA-1103 Special values of temporal types (public comment c201708e0003)

    iv.   ODATA-1104 Make "@" optional for parameters

    v.    ODATA-1105 Simplify selection of properties of complex type

    vi.   ODATA-1106 Introduce mechanism for selecting default properties

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

  b.  Document Walkthrough

    i.    Part 1: Protocol  https://www.oasis-open.org/committees/download.php/61368/odata-v4.01-wd03-part1-protocol-2017-08-10.docx

    ii.   Part 2: URL Conventions  https://www.oasis-open.org/committees/download.php/61369/odata-v4.01-wd03-part2-url-conventions-2017-08-10.docx

    iii.  ABNF  https://tools.oasis-open.org/version-control/browse/wsvn/odata/trunk/4.01%20spec/ABNF/odata-abnf-construction-rules.txt?op=diff&rev=1064

    iv.   CSDL JSON  https://www.oasis-open.org/committees/download.php/61370/odata-csdl-json-v4.01-wd02-2017-08-10.docx

    v.    CSDL XML  https://www.oasis-open.org/committees/download.php/61371/odata-csdl-xml-v4.01-wd03-2017-08-10.docx

    vi.   Edm.xsd

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

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

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

    vii.  JSON Format  https://www.oasis-open.org/committees/download.php/61412/odata-json-format-v4.01-wd03-2017-08-18.docx

    viii. New in OData 4.01  https://www.oasis-open.org/committees/download.php/61413/new-in-odata-v4.01-wd02-2017-08-18.docx

  c.  Close APPLIED issues

    i.    I move to close ODATA-1086, ODATA-1087, ODATA-1090, ODATA-1091, ODATA-1092, ODATA-1094, ODATA-1095, ODATA-1096, ODATA-1097, and ODATA-1102 as applied.

  d.  Request next public review  if time allows preparing the zip files during the TC meeting

    i.    Sample Motion for Part 1 and Part 2:

      I move that the TC approve OData V4.01 Working Draft 03 and all associated artifacts packaged together in <insert_zip> as Committee Specification Draft 03 and designate the Microsoft Word version of the specification as authoritative. I further move that the TC approve submitting the aforementioned Committee Specification Draft 03 for 15 days of public review.

    ii.   Sample Motion for CSDL XML:

      I move that the TC approve OData Common Schema Definition Language (CSDL) XML Representation V4.01 Working Draft 03 and all associated artifacts packaged together in <insert_zip> as Committee Specification Draft 03 and designate the Microsoft Word version of the specification as authoritative. I further move that the TC approve submitting the aforementioned Committee Specification Draft 03 for 15 days of public review.

    iii.  Sample Motion for CSDL JSON:

      I move that the TC approve OData Common Schema Definition Language (CSDL) JSON Representation V4.01 Working Draft 02 and all associated artifacts packaged together in <insert_zip> as Committee Specification Draft 02 and designate the Microsoft Word version of the specification as authoritative. I further move that the TC approve submitting the aforementioned Committee Specification Draft 02 for 15 days of public review.

    iv.   Sample Motion for JSON Format:

      I move that the TC approve OData JSON Format V4.01 Working Draft 03 and all associated artifacts packaged together in <insert_zip> as Committee Specification Draft 03 and designate the Microsoft Word version of the specification as authoritative. I further move that the TC approve submitting the aforementioned Committee Specification Draft 03 for 15 days of public review.

    v.    Sample Motion for New in OData 4.01:

      I move that the TC approve Whats New in OData 4.01 Working Draft 02 and all associated artifacts packaged together in <insert_zip> as Committee Note 02 and designate the Microsoft Word version of the note as authoritative.

6.  Issues

  a.  Vocabularies: NEW or OPEN

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

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

    iii.  ODATA-1060 Improve specification of element response requirements

    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)

  b.  Vocabularies: APPLIED

    i.    ODATA-958 Capabilities: FilterRestrictions and SortRestrictions for navigation properties

    ii.   ODATA-1055 DeepInsertSupport: allow applying to entity sets and collection-valued navigation properties

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

    iv.   ODATA-1069 New term Core.OperationAvailable

    v.    ODATA-1079 Several issues with latest standard vocabularies

    vi.   ODATA-1082 Add term Constraint to Validation vocabulary

    vii.  ODATA-1089 Org.OData.Aggregation.V1 missing Nullable="false" for Function ReturnType

    viii. ODATA-1098 xxxRestrictions can be applied more broadly

7.  Data Aggregation

  a.  Gerald to walk us through the proposal on

    i.    Grid-Like Access to Aggregated Data.docx

8.  Next meetings

  a.  Thursday August 31, 2017 during 8-10 am PDT

  b.  Thursday September 07, 2017 during 8-10 am PDT

9.  AOB and wrap up

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

Meeting Member URL:

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

  - 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=43992&confirmed=1

[16:59] anonymous morphed into George Ericson (Dell)

[17:03] Ralf Handl (SAP SE): Voting Members: 8 of 12 (66%) (used for quorum calculation)

[17:03] Ralf Handl (SAP SE): Achieved quorum: yes

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

[17:05] Ralf Handl (SAP SE): Skip 5.d - wait for resolution of current 4.01 issues and more feedback

[17:08] Ralf Handl (SAP SE): Move 7. before 6. if more than 45 minutes are left after 5., otherwise move it to the beginning of the next meeting

[17:08] Ralf Handl (SAP SE): Agenda is approved with these changes

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

a.Minutes from August 03, 2017 TC meeting: https://www.oasis-open.org/committees/download.php/61331/odata-meeting-183_on-20170803-minutes.html

[17:09] Ralf Handl (SAP SE): Minutes are approved

[17:09] 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:10] Ralf Handl (SAP SE): 5.Version 4.01  next Public Review [8:20 am PT]

a.NEW or OPEN

i.ODATA-1100 Add mechanism for specifying match type for $search

[17:13] Ralf Handl (SAP SE): ODATA-1100 is OPEN

[17:17] Ralf Handl (SAP SE): Mike, Mark, and Ralf to get feedback from corresponding search groups

[17:19] Ralf Handl (SAP SE): ii.ODATA-1101 The hash (#) character is not allowed in search phrases per the ABNF definition

[17:25] Ralf Handl (SAP SE): Mike: rather not add text to the specification, the Jira issue is sufficient

[17:26] Ralf Handl (SAP SE): Mark: Jira issue is sufficient

[17:27] Mark Biamonte (Progress)1: I move that OData 1101 be closed with no action

[17:27] Stefan Hagen: I second

[17:28] Ralf Handl (SAP SE): ODATA-1101 is closed without action

[17:28] Ralf Handl (SAP SE): iii.ODATA-1103 Special values of temporal types (public comment c201708e0003)

[17:29] Ralf Handl (SAP SE): ODATA-1103 is OPEN

[17:32] Ralf Handl (SAP SE): https://en.wikipedia.org/wiki/ISO_8601

[17:34] Ralf Handl (SAP SE): George: ISO 8601 does not include negative and positive infinity

[17:34] Ralf Handl (SAP SE): Neither does XML/Schema

[17:36] Ralf Handl (SAP SE): Mike: we shouldn't add -INF and INF now

[17:37] Michael Pizzo: I propose we resolve OData-1103 by removing the support for INF and -INF for the temporal data types added in OData 4.01.

[17:37] Martin Zurmuehl (SAP SE): i second

[17:38] Ralf Handl (SAP SE): ODATA-1103 is RESOLVED by removing -INF and INF for the temporal data types

[17:38] Ralf Handl (SAP SE): iv.ODATA-1104 Make "@" optional for parameters

[17:41] Ralf Handl (SAP SE): ODATA-1104 is OPEN

[17:42] Ralf Handl (SAP SE): GET http://host/service/EmployeesByManager?ManagerID=3

[17:42] Ralf Handl (SAP SE): GET http://host/service/EmployeesByManager?@ManagerID=3

[17:42] Ralf Handl (SAP SE): GET http://host/service/EmployeesByManager(ManagerID=@p1)?@p1=3

[17:54] Michael Pizzo: Working proposal: Implicit parameter aliases should *NOT* be prefixed with "@".

GET http://host/service/EmployeesByManager?ManagerID=3

Keep the "@" prefix in the path for explicitly introduced parameter aliases in order to disambiguate within the path, and in the query option to match the alias within the path.

[18:03] Michael Pizzo: Revised proposal:

Make the "@" prefix for implicit parameters optional.

GET http://host/service/EmployeesByManager?ManagerID=3

If the parameter matches a system query option, the system query option is used.  To be unambiguous and future proof, use the "@" prefix.

Keep the "@" prefix in the path for explicitly introduced parameter aliases in order to disambiguate within the path, and in the query option to match the alias within the path.

[18:11] Hubert Heijkers (IBM): I move to resolve ODATA-1104 as per the amended proposal.

[18:11] Mark Biamonte (Progress)1: I second

[18:12] Ralf Handl (SAP SE): ODATA-1104 is RESOLVED as proposed

[18:12] Ralf Handl (SAP SE): v.ODATA-1105 Simplify selection of properties of complex type

[18:39] Michael Pizzo: Currently, properties of complex types are individually selected, as in:

$select=Name,Address/City,Address/State,Address/Zip

We could simplify the syntax for selecting individual properties of a complex type, similar to expand options.  Something like:

$select=Name, Address($select=City,State,Zip)

or

$select=Name, Address(City,State,Zip)

The first syntax would support adding the ability, for example, to $filter or $sort a collection of complex types.

We could put $compute (or an inline _expression_) in the $select in as a scoped value (couldn't be used in filter/sort).

Putting $expand in $select brings in all the issues of combining $expand and $select and results in two ways of doing expand.

[18:41] Ralf Handl (SAP SE): Combine $expand and $select into $expect

[18:43] Ralf Handl (SAP SE): ODATA-1105 is OPEN

[18:43] Ralf Handl (SAP SE): vi.ODATA-1106 Introduce mechanism for selecting default properties

[18:50] Ralf Handl (SAP SE): ODATA-1106 is OPEN

[18:54] Michael Pizzo: Propose we close ODATA-1106 due to inability to come up with a compelling client scenario and re-open if we come up with such a scenario.

[18:54] George Ericson (Dell): Motion to close ODATA-1106 with no action

[18:54] George Ericson (Dell): Second

[18:54] Ralf Handl (SAP SE): ODATA-1106 is CLOSED without action

[18:55] Ralf Handl (SAP SE): vii.ODATA-1107 Introduce instance annotation to specify which types an instance "implements"

[19:03] Ralf Handl (SAP SE): ODATA-1107

[19:09] Ralf Handl (SAP SE): The meeting is adjourned

From: odata@lists.oasis-open.org [mailto:odata@lists.oasis-open.org] On Behalf Of Handl, Ralf
Sent: Donnerstag, 24. August 2017 12:27
To: odata@lists.oasis-open.org
Subject: [odata] Agenda for OData TC meeting on 2017-08-24 - updated

Changes:

· 5.a.iv to 5.a.vii – new issues

· 5.c.i – corrected list of applied issues

From: odata@lists.oasis-open.org [mailto:odata@lists.oasis-open.org] On Behalf Of Handl, Ralf
Sent: Freitag, 18. August 2017 12:28
To: odata@lists.oasis-open.org
Subject: [odata] Agenda for OData TC meeting on 2017-08-24

Here [1] is a draft agenda for the OData TC (Technical Committee) meeting scheduled on Thursday August 24, 2017 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=43992

2. Approve agenda [8:05 am PT]

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

a. Minutes from August 03, 2017 TC meeting: https://www.oasis-open.org/committees/download.php/61331/odata-meeting-183_on-20170803-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]

a. Action items due

i. None

5. Version 4.01 – next Public Review [8:20 am PT]

a. NEW or OPEN

i. ODATA-1100 Add mechanism for specifying match type for $search

ii. ODATA-1101 The hash (#) character is not allowed in search phrases per the ABNF definition

iii. ODATA-1103 Special values of temporal types (public comment c201708e0003)

iv. ODATA-1104 Make "@" optional for parameters

v. ODATA-1105 Simplify selection of properties of complex type

vi. ODATA-1106 Introduce mechanism for selecting default properties

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

b. Document Walkthrough

i. Part 1: Protocol – https://www.oasis-open.org/committees/download.php/61368/odata-v4.01-wd03-part1-protocol-2017-08-10.docx

ii. Part 2: URL Conventions – https://www.oasis-open.org/committees/download.php/61369/odata-v4.01-wd03-part2-url-conventions-2017-08-10.docx

iii. ABNF – https://tools.oasis-open.org/version-control/browse/wsvn/odata/trunk/4.01%20spec/ABNF/odata-abnf-construction-rules.txt?op=diff&rev=1064

iv. CSDL JSON – https://www.oasis-open.org/committees/download.php/61370/odata-csdl-json-v4.01-wd02-2017-08-10.docx

v. CSDL XML – https://www.oasis-open.org/committees/download.php/61371/odata-csdl-xml-v4.01-wd03-2017-08-10.docx

vi. Edm.xsd

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

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

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

vii. JSON Format – https://www.oasis-open.org/committees/download.php/61412/odata-json-format-v4.01-wd03-2017-08-18.docx

viii. New in OData 4.01 – https://www.oasis-open.org/committees/download.php/61413/new-in-odata-v4.01-wd02-2017-08-18.docx

c. Close APPLIED issues

i. I move to close ODATA-1086, ODATA-1087, ODATA-1090, ODATA-1091, ODATA-1092, ODATA-1094, ODATA-1095, ODATA-1096, ODATA-1097, and ODATA-1102 as applied.

d. Request next public review – if time allows preparing the zip files during the TC meeting

i. Sample Motion for Part 1 and Part 2:

I move that the TC approve OData V4.01 Working Draft 03 and all associated artifacts packaged together in <insert_zip> as Committee Specification Draft 03 and designate the Microsoft Word version of the specification as authoritative. I further move that the TC approve submitting the aforementioned Committee Specification Draft 03 for 15 days of public review.

ii. Sample Motion for CSDL XML:

I move that the TC approve OData Common Schema Definition Language (CSDL) XML Representation V4.01 Working Draft 03 and all associated artifacts packaged together in <insert_zip> as Committee Specification Draft 03 and designate the Microsoft Word version of the specification as authoritative. I further move that the TC approve submitting the aforementioned Committee Specification Draft 03 for 15 days of public review.

iii. Sample Motion for CSDL JSON:

I move that the TC approve OData Common Schema Definition Language (CSDL) JSON Representation V4.01 Working Draft 02 and all associated artifacts packaged together in <insert_zip> as Committee Specification Draft 02 and designate the Microsoft Word version of the specification as authoritative. I further move that the TC approve submitting the aforementioned Committee Specification Draft 02 for 15 days of public review.

iv. Sample Motion for JSON Format:

I move that the TC approve OData JSON Format V4.01 Working Draft 03 and all associated artifacts packaged together in <insert_zip> as Committee Specification Draft 03 and designate the Microsoft Word version of the specification as authoritative. I further move that the TC approve submitting the aforementioned Committee Specification Draft 03 for 15 days of public review.

v. Sample Motion for New in OData 4.01:

I move that the TC approve Whats New in OData 4.01 Working Draft 02 and all associated artifacts packaged together in <insert_zip> as Committee Note 02 and designate the Microsoft Word version of the note as authoritative.

6. Issues [8:50 am PT]

a. Vocabularies: NEW or OPEN

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

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

iii. ODATA-1060 Improve specification of element response requirements

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)

b. Vocabularies: APPLIED

i. ODATA-958 Capabilities: FilterRestrictions and SortRestrictions for navigation properties

ii. ODATA-1055 DeepInsertSupport: allow applying to entity sets and collection-valued navigation properties

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

iv. ODATA-1069 New term Core.OperationAvailable

v. ODATA-1079 Several issues with latest standard vocabularies

vi. ODATA-1082 Add term Constraint to Validation vocabulary

vii. ODATA-1089 Org.OData.Aggregation.V1 missing Nullable="false" for Function ReturnType

viii. ODATA-1098 xxxRestrictions can be applied more broadly

7. Data Aggregation [9:30 am PT]

a. Gerald to walk us through the proposal on

i. Grid-Like Access to Aggregated Data.docx

8. Next meetings [9:50 am PT]

a. Thursday August 31, 2017 during 8-10 am PDT

b. Thursday September 07, 2017 during 8-10 am PDT

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

[2] References

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

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

[3] Timeline

· https://www.oasis-open.org/committees/download.php/59862/TC%20Timeline-2017-01-25.docx

odata message