OASIS Open Data Protocol (OData) TC

 View Only
Expand all | Collapse all

RE: Agenda for OData TC meeting on 2021-09-02

  • 1.  RE: Agenda for OData TC meeting on 2021-09-02

    Posted 09-02-2021 02:20
    Hello,   If possible, I would like to spend some time on   RSDL capabilities syntax proposal - · Issue #249 · oasis-open/odata-rapid (github.com)   I have a draft document at odata-rapid/rapid-pro-capabilities.md at chrispre-capabilities · oasis-open/odata-rapid (github.com) (in a feature branch) That is not complete at all yet but probably has a lot to discuss already.   Christof   From: odata@lists.oasis-open.org <odata@lists.oasis-open.org> On Behalf Of Handl, Ralf Sent: Wednesday, September 1, 2021 06:02 To: odata@lists.oasis-open.org Cc: Krause, Gerald <gerald.krause@sap.com>; Theissen, Heiko <heiko.theissen@sap.com>; Handl, Ralf <ralf.handl@sap.com> Subject: [EXTERNAL] [odata] Agenda for OData TC meeting on 2021-09-02   Here [1] is a draft agenda for the OData TC (Technical Committee) meeting scheduled on Thursday September 02, 2021 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        1. Roll call [8:00 am]           a.  Self-registration link: https://www.oasis-open.org/apps/org/workgroup/odata/event.php?event_id=50889        2. Approve agenda [8:05 am]        3. Approve minutes from previous meeting(s) [8:10 am]           a.  Minutes from August 26, 2021 TC meeting: https://www.oasis-open.org/committees/download.php/68992/Minutes%20of%202021-08-26%20Meeting%20%23356.docx        4. Review action items [8:15 am]           a.  Upcoming               i.   #0043 Comparison between msgpack and compressed JSON – Christof Sprenger – 2021-12-09               ii.  #0039 Concept for Compact JSON data format – Hubert Heijkers – 2021-12-15               iii. #0037 Concept for binary data format – Hubert Heijkers – 2021-12-15        5. RAPID Profile for OData [8:20 am]           a.  Pull Requests           b. Issues           6. Issues [8:50 am]          a.  Data Aggregation: NEW or OPEN               i.   ODATA-1442 Update Aggregation ABNF with changes from previous issues +            ii.  ODATA-1451 Rephrase definitions for any, all and aggregate               iii. ODATA-1458 Clarify representation of navigation properties in response that are expanded by $apply               iv. ODATA-1459 Clarify representation of property paths with leading segments being null               v.  ODATA-1460 Aggregation.ApplySupportedDefaults: use PATCH logic when overriding with ApplySupported               vi. ODATA-1468 Simple grouping by instance annotations            b. Vocabularies: NEW or OPEN with concrete proposal              i.   ODATA-1358 Detach textual descriptions from operation restriction terms in Capability vocabulary              ii.  ODATA-1394 Add full-fledged support for ISO 8601-1 duration              iii. ODATA-1412 Capabilities vocabulary: Add EntityContainer as annotation target              iv. ODATA-1453 Capabilities.SearchRestrictions/UnsupportedExpressions: description of default value "none" is misleading              v.  ODATA-1467 Keep a CHANGELOG.md, use Semantic Versioning for each vocabulary            c. Vocabularies: NEW or OPEN that need more discussion              i.   ODATA-1336 Querying “JSON properties”              ii.  ODATA-1326 Enhance syntax of term Validation.OpenPropertyTypeConstraint                   1. https://github.com/oasis-tcs/odata-vocabularies/pull/59/files              iii. ODATA-1253 Abstract type definition Core.Number as a super-type of all numeric types              iv. ODATA-1214 Annotate constructor actions              v.  ODATA-1140 Add details to HttpResponse              vi. ODATA-1107 Introduce instance annotation to specify which types an instance "implements"              vii. ODATA-1060 Improve specification of element response requirements              viii.    ODATA-884 Allow describing possible responses to requests for a particular resource (public comment c201510e00019)            d. V4.01 Errata: NEW or OPEN with concrete proposal              i.   ODATA-1366 Remove redundant text to improve readability              ii.  ODATA-1370 CSDL XML Section 12.9 "Parameter" mixing with "overload" causes ambiguity, particularly with regard to parameter ordering              iii. ODATA-1378 Clarify use of $root with function imports              iv. ODATA-1379 Consider adding railroad diagrams for the URL syntax              v.  ODATA-1387 Difference between Asynchronous and Repeatable Requests              vi. ODATA-1397 Example 86 applies an entity type as term              vii. ODATA-1398 Improve text and examples for JSON and multipart batch              viii.    ODATA-1407 No way to $select instance annotations on primitive types              ix. ODATA-1410 $expand: clarify that property *paths* must not appear twice              x.  ODATA-1411 $expand: Discrepancy in argument descriptions              xi. ODATA-1417 Inconsistencies in OData-CSDL section 14.2.2              xii. ODATA-1419 Use of Core.ContentID by clients if service does not reference Core vocabulary +           xiii.    ODATA-1420 Path evaluation for annotations targeting annotations              xiv.    ODATA-1422 Clarify $select behavior for stream properties              xv. ODATA-1424 OData 4.01 JSON "Delta Responses" doesn't describe use of "@id" (or "@odata.id") for Added/Changed Entity              xvi.    ODATA-1432 Clarify wording in Section 7.2, Type Facets              xvii.   ODATA-1437 11.4.9.4 Update a Collection Property: reference section 11.4.11 Positional Inserts              xviii.   ODATA-1450 Key with PropertyRef using navigation path incompatible with Protocol 11.4.2 "Create an Entity"              xix.    ODATA-1456 Navigation path from instance to lambda operator              xx. ODATA-1462 in operator should allow empty collection literals              xxi.    ODATA-1464 Remove section 14.4.4.3 Function odata.matchesPattern              xxii.   ODATA-1465 Clarification: Delete supported for Nullable single-valued navigation properties              xxiii.   ODATA-1469 Clarify $select behavior for properties of "null" instances            e . V4.01 Errata: NEW or OPEN that need more discussion              i.   ODATA-1360 Clarify that clients have to do content-ID replacing to interpret Location headers in batch results              ii.  ODATA-1428 Definition of service-specific client-side functions              iii. ODATA-1457 Potential confusion wrt Content-Type header for media entities            f . V4.02: NEW or OPEN with concrete proposal              i.   ODATA-1338 Alternative representation of entity references using key properties              ii.  ODATA-1364 Define ExpandOptions for nav property in $select              iii. ODATA-1388 Make key aliases optional, clarify multiple to-one navigation hops              iv. ODATA-1389 New control information @fileName / @odata.fileName              v.  ODATA-1405 /$query shall allow Content-Type: application/x-www-form-urlencoded              vi. ODATA-1435 Conditionally add an element to a collection              vii. ODATA-1438 New preference return=keys              viii.    ODATA-1441 New query option $expect combining $expand and $select            g . V4.02: NEW or OPEN that need more discussion              i. currently 30 issues        7. Next meetings [9:50 am]           a.  Thursday September 09, 2021 during 8-10 am PDT (17:00-19:00 CEST)           b.  Thursday September 16, 2021 during 8-10 am PDT (17:00-19:00 CEST)           c.  Thursday September 23, 2021 during 8-10 am PDT (17:00-19:00 CEST)           d.  Thursday September 30, 2021 during 8-10 am PDT (17:00-19:00 CEST)   8. AOB and wrap up [9:55 am]     [2] Timeline      1.  https://www.oasis-open.org/committees/download.php/68135/TC-Timeline-2021-01-07.docx     ________________________________________________________________________________ Join Microsoft Teams Meeting Conference ID: 629 315 222# Local numbers Learn more about Teams Meeting options ________________________________________________________________________________      


  • 2.  RE: Agenda for OData TC meeting on 2021-09-02

    Posted 09-02-2021 13:03




    I d like to discuss this new issue:
     
    6.d.xxiv.          
    ODATA-1470 Clarify
    value of @odata.mediaContentType if stream is null
     


    From: Christof Sprenger <chrispre@microsoft.com>

    Sent: Thursday, 2 September 2021 04:20
    To: Handl, Ralf <ralf.handl@sap.com>; odata@lists.oasis-open.org
    Subject: RE: Agenda for OData TC meeting on 2021-09-02


     
    Hello,
     
    If possible, I would like to spend some time on

     
    RSDL capabilities syntax proposal - Issue #249 oasis-open/odata-rapid (github.com)
     
    I have a draft document at
    odata-rapid/rapid-pro-capabilities.md at chrispre-capabilities oasis-open/odata-rapid (github.com) (in a feature branch)

    That is not complete at all yet but probably has a lot to discuss already.
     
    Christof
     


    From:
    odata@lists.oasis-open.org < odata@lists.oasis-open.org >
    On Behalf Of Handl, Ralf
    Sent: Wednesday, September 1, 2021 06:02
    To: odata@lists.oasis-open.org
    Cc: Krause, Gerald < gerald.krause@sap.com >; Theissen, Heiko < heiko.theissen@sap.com >; Handl, Ralf < ralf.handl@sap.com >
    Subject: [EXTERNAL] [odata] Agenda for OData TC meeting on 2021-09-02


     
    Here [1] is a draft agenda for the OData TC (Technical Committee) meeting
    scheduled on
    Thursday September 02, 2021 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
     
         1. Roll call [8:00 am]
              a.  Self-registration link:

    https://www.oasis-open.org/apps/org/workgroup/odata/event.php?event_id=50889
     
         2. Approve agenda [8:05 am]
     
         3. Approve minutes from previous meeting(s) [8:10 am]
              a. 
    Minutes from August 26, 2021 TC meeting:

    https://www.oasis-open.org/committees/download.php/68992/Minutes%20of%202021-08-26%20Meeting%20%23356.docx
     
         4. Review

    action items [8:15 am]
              a.  Upcoming
                  i.   #0043

    Comparison between msgpack and compressed JSON Christof Sprenger 2021-12-09
                  ii.  #0039

    Concept for Compact JSON data format Hubert Heijkers 2021-12-15
                  iii. #0037

    Concept for binary data format Hubert Heijkers 2021-12-15
     
         5.
    RAPID
    Profile for OData [8:20 am]
              a. 

    Pull Requests
              b.

    Issues
        

         6.
    Issues [8:50 am]

             a. 
    Data Aggregation:

    NEW or OPEN
                  i.  

    ODATA-1442 Update Aggregation ABNF with changes from previous issues
    +            ii. 

    ODATA-1451 Rephrase definitions for any, all and aggregate
                  iii.

    ODATA-1458 Clarify representation of navigation properties in response that are expanded by $apply
                  iv.

    ODATA-1459 Clarify representation of property paths with leading segments being null
                  v. 

    ODATA-1460 Aggregation.ApplySupportedDefaults: use PATCH logic when overriding with ApplySupported
                  vi.

    ODATA-1468 Simple grouping by instance annotations
     
             b.
    Vocabularies:

    NEW or OPEN with concrete proposal
                 i.  

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

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

    ODATA-1412 Capabilities vocabulary: Add EntityContainer as annotation target
                 iv.
    ODATA-1453
    Capabilities.SearchRestrictions/UnsupportedExpressions: description of default value "none" is misleading
                 v. 
    ODATA-1467
    Keep a CHANGELOG.md, use Semantic Versioning for each vocabulary
     
             c.
    Vocabularies:

    NEW or OPEN that need more discussion
                 i.  

    ODATA-1336 Querying JSON properties
                 ii. 

    ODATA-1326 Enhance syntax of term Validation.OpenPropertyTypeConstraint
                      1.
    https://github.com/oasis-tcs/odata-vocabularies/pull/59/files
                 iii.

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

    ODATA-1214 Annotate constructor actions
                 v. 
    ODATA-1140
    Add details to HttpResponse
                 vi.
    ODATA-1107
    Introduce instance annotation to specify which types an instance "implements"
                 vii.
    ODATA-1060
    Improve specification of element response requirements
                 viii.   
    ODATA-884
    Allow describing possible responses to requests for a particular resource (public comment c201510e00019)
     
            
    d. V4.01 Errata:

    NEW or OPEN with concrete proposal
                 i.  

    ODATA-1366 Remove redundant text to improve readability
                 ii. 

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

    ODATA-1378 Clarify use of $root with function imports
                 iv.

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

    ODATA-1387 Difference between Asynchronous and Repeatable Requests
                 vi.

    ODATA-1397 Example 86 applies an entity type as term
                
    vii. ODATA-1398 Improve text and examples for JSON and multipart batch
                 viii.   

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

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

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

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

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

    ODATA-1420 Path evaluation for annotations targeting annotations
                 xiv.   

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

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

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

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

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

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

    ODATA-1462 in operator should allow empty collection literals
                 xxi.   

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

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

    ODATA-1469 Clarify $select behavior for properties of "null" instances
     
             e .
    V4.01 Errata:
    NEW or OPEN that need more discussion
                 i.  

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

    ODATA-1428 Definition of service-specific client-side functions
                 iii.

    ODATA-1457 Potential confusion wrt Content-Type header for media entities
     
             f .
    V4.02:
    NEW or OPEN with concrete proposal
                 i.  

    ODATA-1338 Alternative representation of entity references using key properties
                 ii. 

    ODATA-1364 Define ExpandOptions for nav property in $select
                 iii.

    ODATA-1388 Make key aliases optional, clarify multiple to-one navigation hops
                 iv.

    ODATA-1389 New control information @fileName / @odata.fileName
                 v. 

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

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

    ODATA-1438 New preference return=keys
                 viii.   

    ODATA-1441 New query option $expect combining $expand and $select
     
             g .
    V4.02:
    NEW or OPEN that need more discussion
                 i. currently 30 issues
     
         7. Next meetings [9:50 am]
              a.  Thursday September 09, 2021 during 8-10 am PDT (17:00-19:00 CEST)
              b.  Thursday September 16, 2021 during 8-10 am PDT (17:00-19:00 CEST)
              c.  Thursday September 23, 2021 during 8-10 am PDT (17:00-19:00 CEST)
              d.  Thursday September 30, 2021 during 8-10 am PDT (17:00-19:00 CEST)
     
    8. AOB and wrap up [9:55 am]
     
     
    [2] Timeline
         1. 

    https://www.oasis-open.org/committees/download.php/68135/TC-Timeline-2021-01-07.docx

     
     
    ________________________________________________________________________________

    Join
    Microsoft Teams Meeting
    Conference ID:
    629 315 222#

    Local
    numbers
    Learn more about Teams

    Meeting options

    ________________________________________________________________________________