Uploaded image for project: 'OASIS Open Data Protocol (OData) TC'
  1. OASIS Open Data Protocol (OData) TC
  2. ODATA-969

Chapter 15, Example 32: syntax of "target" URL

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Closed
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: V4.0_ERRATA03
    • Fix Version/s: V4.01_WD01
    • Component/s: JSON Format
    • Labels:
      None
    • Environment:

      Proposed

    • Proposal:
      Hide

      Clarify in text that functions are invoked by adding the named parameters as query options. The syntax of the url is up to the service (could be implicit parameters or explicit as in the example)

      Show
      Clarify in text that functions are invoked by adding the named parameters as query options. The syntax of the url is up to the service (could be implicit parameters or explicit as in the example)

      Description

      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.

        Attachments

          Activity

            People

            • Assignee:
              Unassigned
              Reporter:
              handl Ralf Handl
            • Watchers:
              1 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: