[OASIS Issue Tracker] Issue Comment Edited: (ODATA-227) Support of symbolic names in annotations

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

    [ http://tools.oasis-open.org/issues/browse/ODATA-227?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=32399#action_32399 ] 

Ralf Handl edited comment on ODATA-227 at 2/8/13 1:10 PM:
----------------------------------------------------------

Using the @ sign as the separator for named stream properties (only) feels odd, because until now we don't differentiate "term casts" in CSDL Path expressions by property type. Accessing a display.hidden annotation on a property would be

Path="PropertyName/display.hidden"

independently of whether the property is primitive or complex or navigation. So 

Path="NamedStream/odata.mediaReadLink"

is more consistent than

Path="NamedStream@odata.mediaReadLink"

We COULD consistently switch to the @ sign for all "term casts":

Path="PropertyName@display.hidden"

The examples in ODATA-108 and ODATA-109 would then be changed to

      <PropertyValue Property="PhoneNumbers" Path="Phones@vCard.PhoneNumber#work" /> 

and

<Annotation Term="Display.Caption" Path="@CreativeWorks.Movie/Title"/> (empty prefix means "this", then look for annotation)
<Annotation Term="Display.Caption" Path="@vCard.Contact/Fullname" /> 

  <Property Name="Something" Type="String"> 
    <Annotation Term="Display.Hidden" Path="Something@Core.ReadOnly" /> 
  </Property> 
  <Property Name="SomethingElse" Type="String"> 
    <Annotation Term="Display.Hidden" Path="Something@Core.ReadOnly" /> 
  </Property> 

Thoughts?

      was (Author: ralfhandl):
    Using the @ sign as the separator for named stream properties feels odd, because until now we don't differentiate in CSDL Path expressions by property type. Accessing a display.hidden annotation on a property would be

Path="PropertyName/display.hidden"

independently of whether the property is primitive or complex or navigation. So 

Path="NamedStream/odata.mediaReadLink"

looks more natural than 

Path="NamedStream@odata.mediaReadLink"

Thoughts?

  
> Support of symbolic names in annotations
> ----------------------------------------
>
>                 Key: ODATA-227
>                 URL: http://tools.oasis-open.org/issues/browse/ODATA-227
>             Project: OASIS Open Data Protocol (OData) TC
>          Issue Type: Improvement
>          Components: OData CSDL v1.0
>    Affects Versions: WD01
>         Environment: [Proposed]
>            Reporter: Martin Zurmuehl
>            Assignee: Ralf Handl
>            Priority: Minor
>             Fix For: WD01
>
>
> An Annotation should be able to use one of a set of pre-defined symbolic names when specifying a value.
> For example, the value of the "MovieURL" Annotation should  be the MediaRessource of the "Movie" type (which is a Media Link Entry).
>  

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