[OASIS Issue Tracker] (ODATA-969) Chapter 15, Example 32: syntax of "target" URL

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

    [ https://issues.oasis-open.org/browse/ODATA-969?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=63911#comment-63911 ] 

Ralf Handl commented on ODATA-969:
----------------------------------

Problem is that explicit parameter aliases require clients to parse the target URL:

  "target": "Employees(2)/RemainingVacation(Year=@abc)" 

Correct invocation would require to add ?@abc=2016, and client would need to parse the target to figure out the @abc.

I'd rather require use of implicit aliases to avoid target parsing.

> Chapter 15, Example 32: syntax of "target" URL
> ----------------------------------------------
>
>                 Key: ODATA-969
>                 URL: https://issues.oasis-open.org/browse/ODATA-969
>             Project: OASIS Open Data Protocol (OData) TC
>          Issue Type: Bug
>          Components: OData JSON Format
>    Affects Versions: V4.0_ERRATA03
>         Environment: Proposed
>            Reporter: Ralf Handl
>             Fix For: V4.01_WD01, V4.0_ERRATA04
>
>
> The example shows 
>     "target": "Employees(2)/RemainingVacation(Year=@Year)"
> The prose text says:
> The target name/value pair contains a bound function or action URL. If the URL in the target name/value pair cannot be used to invoke all overloads for the function, then the function name MUST be distinguished by appending the parentheses-enclosed, comma-separated list of non-binding parameter names.
> This implies that the example should show
>     "target": "Employees(2)/RemainingVacation(Year)"
> Problem is that this URL would be quite useless for invoking the function. Also the specific function overload is already identified by the advertisement
>  "#Model.RemainingVacation(Year)": {...}
> If the intention of "target" is to provide a URL for invoking the function, then a better approach would be to build on ODATA-763 and require that "target" is a URL without trailing parens and parameter names that can be invoked by appending the default aliases for the parameters listed in the advertisement.



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