[OASIS Issue Tracker] (ODATA-636) Clarify that complex types and arrays can only be passed to functions through parameter aliases

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

Michael Pizzo updated ODATA-636:
--------------------------------

        Summary: Clarify that complex types and arrays can only be passed to functions through parameter aliases  (was: Clarify that complex types can only be passed to functions through parameter aliases)
    Description: 
complex types and arrays can be passed by value to functions as JSON, however the structure of the JSON may contain characters (urls, types prefixed with "#", etc.) which are not valid in the path of the URL. Thus, complex types/arrays may only be passed by value as parameters using a parameter alias (whose value is passed as a query option).

This is supported from the ABNF, but it takes some digging to figure out. It would be good to call this out in the prose.



  was:
complex types can be passed by value to functions, however the structure of the complex type may contain characters (urls, types prefixed with "#", etc.) which are not valid in the path of the URL. Thus, complex types may only be passed by value as parameters using a parameter alias (whose value is passed as a query option).

This is supported from the ABNF, but it takes some digging to figure out. It would be good to call this out in the prose.



       Proposal: Explicitly call out in the discussion of passing complex types/arrays to functions that passing complex types/arrays by value MUST use parameter alias syntax.  (was: Explicitly call out in the discussion of passing complex types to functions that passing complex types by value MUST use parameter alias syntax.)

> Clarify that complex types and arrays can only be passed to functions through parameter aliases
> -----------------------------------------------------------------------------------------------
>
>                 Key: ODATA-636
>                 URL: https://tools.oasis-open.org/issues/browse/ODATA-636
>             Project: OASIS Open Data Protocol (OData) TC
>          Issue Type: Bug
>          Components: OData CSDL, OData Protocol 
>    Affects Versions: V4.0_OS
>         Environment: [Proposed]
>            Reporter: Michael Pizzo
>            Priority: Minor
>             Fix For: V4.0_ERRATA01
>
>
> complex types and arrays can be passed by value to functions as JSON, however the structure of the JSON may contain characters (urls, types prefixed with "#", etc.) which are not valid in the path of the URL. Thus, complex types/arrays may only be passed by value as parameters using a parameter alias (whose value is passed as a query option).
> This is supported from the ABNF, but it takes some digging to figure out. It would be good to call this out in the prose.



--
This message was sent by Atlassian JIRA
(v6.1.1#6155)