[OASIS Issue Tracker] (ODATA-674) Specify navigation property binding combined with containment

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

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

Ralf Handl updated ODATA-674:
-----------------------------

    Description: 
This combination is not explicitly covered in the specification.

There are two sides to this problem: 
- target entity sets for contained entities
- contained entity sets as target entity sets

Both problems can be solved by allowing <NavigationPropertyBinding> elements as children of the structured type that defines the containment navigation property.

Example 1: navigation property of a contained entity targets a top-level entity set:
  <NavigationProperty Name="Items" Type="Collection(Model.OrderItem)" ContainsTarget="true" />
  <NavigationPropertyBinding Path="Items/Product" Target="Model.Container/Products"/>

Example 2: assume an Order contains Items and Shipments, and an Item refers to a single Shipment of the same Order and vice versa. Using paths that start at the type defining the containment navigation property, the Target would be "Shipments" and "Items".
<EntityType Name="Order">
  <NavigationProperty Name="Items" Type="Collection(Model.OrderItem)" ContainsTarget="true" />
  <NavigationPropertyBinding Path="Items/Shipment" Target="Shipments"/>  
  <NavigationProperty Name="Shipments" Type="Collection(Model.Shipment)" ContainsTarget="true" />
  <NavigationPropertyBinding Path="Shipments/ShippedItems" Target="Items"/>
</EntityType>

<EntityType Name="OrderItem">
  <NavigationProperty Name="Shipment" Type="Model.Shipment" Partner="ShippedItems"/>
</EntityType>

<EntityType Name="Shipment">
  <NavigationProperty Name="ShippedItems" Type="Collection(Model.OrderItem)" Partner="Shipment"/>
</EntityType>


  was:
This combination is not explicitly covered in the specification.

There are two sides to this problem: 
- target entity sets for contained entities
- contained entity sets as target entity sets

The first problem can be solved by allowing <NavigationPropertyBinding> elements as children of <NavigationProperty> elements that specify ContainsTarget="true": 
  <NavigationProperty Name="Items" Type="Collection(Model.OrderItem)" ContainsTarget="true">
    <NavigationPropertyBinding Path="Product" Target="Model.Container/Products"/>
  </NavigationProperty>

The second problem is trickier: assume an Order contains Items and Shipments, and an Item refers to a single Shipment of the same Order and vice versa. Using paths that start at the type defining the containment navigation property, the Target would be "Shipments" and "Items".
<EntityType Name="Order">
  <NavigationProperty Name="Items" Type="Collection(Model.OrderItem)" ContainsTarget="true">
    <NavigationPropertyBinding Path="Shipment" Target="Shipments"/>
  </NavigationProperty>
  <NavigationProperty Name="Shipments" Type="Collection(Model.Shipment)" ContainsTarget="true">
    <NavigationPropertyBinding Path="ShippedItems" Target="Items"/>
  </NavigationProperty>
</EntityType>

<EntityType Name="OrderItem">
  <NavigationProperty Name="Shipment" Type="Model.Shipment" Partner="ShippedItems"/>
</EntityType>

Slightly more complicated: Region contains SalesPeople and Customers, Customer has SalesRep that is a sales person from the same region. A Target can only be specified if Customer has an upward navigation to the containing Region: Target="Region/SalesPeople".

So target paths are either relative and start with a sibling of the parent (navigation property within the same type, entity set within the same container) or absolute and start with a qualified schema name.


> Specify navigation property binding combined with containment
> -------------------------------------------------------------
>
>                 Key: ODATA-674
>                 URL: https://issues.oasis-open.org/browse/ODATA-674
>             Project: OASIS Open Data Protocol (OData) TC
>          Issue Type: Bug
>          Components: Implementing OData, OData CSDL
>    Affects Versions: V4.0_OS
>            Reporter: Ralf Handl
>            Assignee: Ralf Handl
>              Labels: Gap, request_tc_discussion
>             Fix For: V4.01_WD01
>
>
> This combination is not explicitly covered in the specification.
> There are two sides to this problem: 
> - target entity sets for contained entities
> - contained entity sets as target entity sets
> Both problems can be solved by allowing <NavigationPropertyBinding> elements as children of the structured type that defines the containment navigation property.
> Example 1: navigation property of a contained entity targets a top-level entity set:
>   <NavigationProperty Name="Items" Type="Collection(Model.OrderItem)" ContainsTarget="true" />
>   <NavigationPropertyBinding Path="Items/Product" Target="Model.Container/Products"/>
> Example 2: assume an Order contains Items and Shipments, and an Item refers to a single Shipment of the same Order and vice versa. Using paths that start at the type defining the containment navigation property, the Target would be "Shipments" and "Items".
> <EntityType Name="Order">
>   <NavigationProperty Name="Items" Type="Collection(Model.OrderItem)" ContainsTarget="true" />
>   <NavigationPropertyBinding Path="Items/Shipment" Target="Shipments"/>  
>   <NavigationProperty Name="Shipments" Type="Collection(Model.Shipment)" ContainsTarget="true" />
>   <NavigationPropertyBinding Path="Shipments/ShippedItems" Target="Items"/>
> </EntityType>
> <EntityType Name="OrderItem">
>   <NavigationProperty Name="Shipment" Type="Model.Shipment" Partner="ShippedItems"/>
> </EntityType>
> <EntityType Name="Shipment">
>   <NavigationProperty Name="ShippedItems" Type="Collection(Model.OrderItem)" Partner="Shipment"/>
> </EntityType>



--
This message was sent by Atlassian JIRA
(v6.2.2#6258)