[OASIS Issue Tracker] Updated: (ODATA-345) Specify which nested query options can be used when expanding only references, and adapt syntax

[OASIS Issues Tracker <workgroup_mailer@lists.oasis-open.org>]

     [ http://tools.oasis-open.org/issues/browse/ODATA-345?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Ralf Handl updated ODATA-345:
-----------------------------

    Proposal: 
Change syntax to 

$epand=NavProp/$ref(<nested options>)

and define a different set following $ref than the one directly following the navigation property:

expand       = '$expand' EQ expandItem *( COMMA expandItem )
expandItem   = [ qualifiedEntityTypeName "/" ] navigationProperty 
               [ "/" qualifiedEntityTypeName ]
               [ ref OPEN expandRefOption *( SEMI expandRefOption ) CLOSE 
               / OPEN expandOption *( SEMI expandOption ) CLOSE ]
expandRefOption = filter
                / search
                / skip 
                / top 
                / inlinecount
expandOption = expandRefOption
             / select 
             / orderby
             / expand
             / levels


Rationale: we now express in the ABNF what is meaningful and thus allowed after /$ref.

Also this allows parsing from left to right. 

And putting /$ref before the parens makes it a bit more obvious. Just try reading

$expand=Items($filter=something very complicated and lengthy and I'll only tell you afterwards that I only want)/$ref&andsoon

  was:
Change syntax to 

$epand=NavProp/$ref(<nested options>)

and define a different set following $ref than the one directly following the navigation property

Rationale: this allows parsing from left to right. The current positioning of NavProp(...)/$ref makes that impossible, and is hard to read anyway.


> Specify which nested query options can be used when expanding only references, and adapt syntax
> -----------------------------------------------------------------------------------------------
>
>                 Key: ODATA-345
>                 URL: http://tools.oasis-open.org/issues/browse/ODATA-345
>             Project: OASIS Open Data Protocol (OData) TC
>          Issue Type: Bug
>          Components: OData ABNF Construction Rules, OData Protocol , OData URL Conventions 
>    Affects Versions: V4.0_WD01
>         Environment: [Proposed]
>            Reporter: Ralf Handl
>             Fix For: V4.0_WD01
>
>
> $expand allows nesting query options after the name of the navigation properties to be expanded.
> When expanding only references $select, $expand, and $levels don't make sense as neither structural nor navigation properties are represented in references.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://tools.oasis-open.org/issues/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira