[OASIS Issue Tracker] Updated: (ODATA-431) Add $expand=*, $expand=*/$ref, $expand=*($levels=...) for expanding all navigation properties

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

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

Hubert Heijkers updated ODATA-431:
----------------------------------

       Proposal: 
$expand=* expands all navigation properties, including dynamic navigation properties.

$expand=*/$ref inlcudes entity references for all related entities.

$expand=*($levels=2) expands all navigation properties and all navigation properties on related entities.

  was:
$expand=* expands all navigation properties, including dynamic structural properties.

$expand=*/$ref inlcudes entity references for all related entities.

$expand=*($levels=2) expands all navigation properties and all navigation properties on related entities.

    Description: 
$select=* allows selecting all structural properties, including dynamic structural properties.
$expand=* would allow expanding all navigation properties, including dynamic navigation properties.

This is a not only a convenient shortcut, it also covers cases where metadata inspection wouldn't help: dynamic navigation properties.

In combination with the suffix /$ref this includes entity references for all related entities.

In combination with the $level operator this allows expanding an entity graph in all directions up to the given distance to the central entity.

  was:
$select=* allows selecting all structural properties, including dynamic structural properties.
$expand=* would allow expanding all navigation properties, including dynamic structural properties.

This is a not only a convenient shortcut, it also covers cases where metadata inspection wouldn't help: dynamic navigaition properties.

In combination with the suffix /$ref this includes entity references for all related entities.

In combination with the $level operator this allows expanding an entity graph in all directions up to the given distance to the central entity.


I changed the description and proposal to have dynamic navigation properties included in $expand=*

I like this and it works great now that we've decided that properties that are expanded don't need to be in the $select clause.

Was wondering however if there might be a way to express that we'd want to have this behavior but just for containment cases? For example in the case of an order I'd like the order lines to be expanded but not necessarily the customer the order is for.

Also $level operator normaly operates on a particular navigation property in combination with which it is being used. Are we saying that i.c.w. a * it is the number of levels of just any navigation property? Can I make it be indefinate (at least for containment)?

> Add $expand=*, $expand=*/$ref, $expand=*($levels=...) for expanding all navigation properties
> ---------------------------------------------------------------------------------------------
>
>                 Key: ODATA-431
>                 URL: http://tools.oasis-open.org/issues/browse/ODATA-431
>             Project: OASIS Open Data Protocol (OData) TC
>          Issue Type: Improvement
>          Components: OData URL Conventions 
>    Affects Versions: V4.0_CSD01
>         Environment: [Proposed]
>            Reporter: Ralf Handl
>             Fix For: V4.0_CSD02
>
>
> $select=* allows selecting all structural properties, including dynamic structural properties.
> $expand=* would allow expanding all navigation properties, including dynamic navigation properties.
> This is a not only a convenient shortcut, it also covers cases where metadata inspection wouldn't help: dynamic navigation properties.
> In combination with the suffix /$ref this includes entity references for all related entities.
> In combination with the $level operator this allows expanding an entity graph in all directions up to the given distance to the central entity.

-- 
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