[OASIS Issue Tracker] Updated: (ODATA-407) Navigation Properties in Complex Types (public comment c201305e00012)

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

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

Ralf Handl updated ODATA-407:
-----------------------------

       Proposal: 
Navigation properties in Atom are atom:link elements.

Complex properties can be collection-valued, so the atom:link elements have to be placed within the representation of each single complex type instance.

In ODATA-346 we decided that collections are NOT arrays, and items in a collection CANNOT be accessed by index. This requires that href attribute values in links within complex type instances CANNOT be relative to the current entities, as they are by convention in OData V2 and V3 implementations.

Example:
<atom:entry>
  <atom:link rel="http://docs.oasis-open.org/odata/ns/related/Orders"; 
         type="application/atom+xml;type=entry" title="Orders" 
         href="Customers('ALFKI')/Orders" />
  ...
  <metadata:properties>
    <Addresses>
      <metadata:element>
        <atom:link rel="http://docs.oasis-open.org/odata/ns/related/Country"; type="application/atom+xml;type=entry" title="Supplier" href="Countries('DE')" />
        <Street>Obere Str. 57</Street>
        <City>Berlin</City>
        <PostalCode>D-12209</PostalCode>
      </metadata:element>
      ...
    </Addresses>
    ...
  </metadata:properties>
  ...
</atom:entry>
    Environment: [Proposed]

> Navigation Properties in Complex Types (public comment c201305e00012)
> ---------------------------------------------------------------------
>
>                 Key: ODATA-407
>                 URL: http://tools.oasis-open.org/issues/browse/ODATA-407
>             Project: OASIS Open Data Protocol (OData) TC
>          Issue Type: Improvement
>          Components: OData ATOM Format 
>    Affects Versions: V4.0_CSD01
>         Environment: [Proposed]
>            Reporter: Stefan Drees
>            Priority: Minor
>             Fix For: V4.0_CSD02
>
>
> The public comment [c201305e00012](https://lists.oasis-open.org/archives/odata-comment/201305/msg00012.html) with title "Navigation Properties in Complex Types" states:
> """
> [OData-Part3] (CSDL Defintion) states:
> As structural and navigation properties MAY be returned by the service on instances of any structured type, whether or not the type is marked as open. Clients MUST always be prepared to deal with additional properties on instances of any structured type, see [OData-Protocol].
> In this light, I wonder, what is the reason tat complex types cannot declare navigation properties in metadata? I would serve a lot of real -life cases
> For example, the Address complex type used throughout the documents is a bit unrealistic, as in most real cases it should contain a navigation property "Country", referencing another enitity, not just text representaion
> """

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