[OASIS Issue Tracker] (ODATA-1028) 4.3.4 and 4.4: clarify resolution of relative URLs in system query option $id

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

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

Michael Pizzo updated ODATA-1028:
---------------------------------

    Proposal: Clarify that relative URLs passed with query option $id are relative to the path to be consistent with $ref.  (was: Clarify that relative URLs passed with query option $id are relative to the service root.)

4.3.4 contradicts 4.4, http://docs.oasis-open.org/odata/odata/v4.01/csprd01/part2-url-conventions/odata-v4.01-csprd01-part2-url-conventions.html#_Toc470093604: 

The entity-id specified by $id may be expressed absolute or relative to the request URL. 

So we have two different resolution mechanisms for the $id system query option: 
- relative to the service root for paths containing /$entity 
- relative to the request URL for paths ending in /$ref 

This is less than consistent.
Source of problem:
http://host/service/$entity?$id=Products(0)
http://host/service/$entity/this.VipProducts?$id=Products(0)
http://host/service/$entity/this.VipProducts?$id=../Products(0)
DELETE http://host/service/Categories(1)/Products/$ref?$id=../../Products(0)
DELETE http://host/service/Categories(1)/Products/$ref?$id=/service/Products(0)

> 4.3.4 and 4.4: clarify resolution of relative URLs in system query option $id
> -----------------------------------------------------------------------------
>
>                 Key: ODATA-1028
>                 URL: https://issues.oasis-open.org/browse/ODATA-1028
>             Project: OASIS Open Data Protocol (OData) TC
>          Issue Type: Bug
>          Components: OData URL Conventions
>    Affects Versions: V4.0_ERRATA03
>         Environment: Proposed
>            Reporter: Ralf Handl
>            Assignee: Ralf Handl
>             Fix For: V4.01_CSD02
>
>
> 4.3.4 Resolving an Entity-Id states that 
> The entity-id may be expressed as an absolute IRI or relative to the service root URL.
> Example 23: request the entity representation for an entity-id
> http://host/service/$entity?$id=Products(0)
> This was correct until we introduced type-cast segments after $entity with ODATA-528. 
> Now relative URLs should rather be relative to the request URL, as in all other places, especially in 
> 4.4 Addressing References between Entities
> The entity-id specified by $id may be expressed absolute or relative to the request URL.



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