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

Provide section that clearly indicates what system query options are allowed on the various combinations of URL type and HTTP method (public comment c201306e00012)

    XMLWordPrintable

    Details

    • Type: Improvement
    • Status: Closed
    • Priority: Minor
    • Resolution: Fixed
    • Affects Version/s: V4.0_CSD01
    • Fix Version/s: V4.0_CSD02
    • Component/s: URL Conventions
    • Labels:
      None
    • Environment:

      [Applied]

    • Proposal:
      Hide

      When inserting an entity we already specified that the service MUST return at least the expansion level that was present in the (deep) insert request.

      As clients should have a complete representation of how the service interpreted their request, the response MUST NOT be projected by the service (this rule is new).

      Consequently $expand and $select are not allowed on insert requests, and none of the other system query options make sense either.

      Similar argument for update requests: no system query options on update requests.

      Delete request don't return data, so no question here.

      Summary: CUD operations don't allow system query options.

      The rationale for actions is different: there's no predefined semantics for actions, so all system query options applicable to the return type are allowed. For functions they are allowed anyway.

      Show
      When inserting an entity we already specified that the service MUST return at least the expansion level that was present in the (deep) insert request. As clients should have a complete representation of how the service interpreted their request, the response MUST NOT be projected by the service (this rule is new). Consequently $expand and $select are not allowed on insert requests, and none of the other system query options make sense either. Similar argument for update requests: no system query options on update requests. Delete request don't return data, so no question here. Summary: CUD operations don't allow system query options. The rationale for actions is different: there's no predefined semantics for actions, so all system query options applicable to the return type are allowed. For functions they are allowed anyway.
    • Resolution:
      Show
      https://www.oasis-open.org/committees/download.php/49614/odata-v4.0-wd02-part2-url-conventions-2013-06-19.docx

      Description

      We received the public Comment #20130600012 on 2013-06-14 with title "feedback/discussion now that public comment period is over".

      Text was:
      """
      Where can I send comments about or have discussion regarding the OData v4 spec now that the public comment period is over?

      I would like to know if the $select and $expand system query options are allowed on insert entity requests to limit or expand the data that is returned (when it is requested via a PREFER header that data be returned). A section that clearly indicates what system query options are allowed on the various combinations of URL type and HTTP method would be helpful (unless it exists already and I just missed it).
      """

        Attachments

          Activity

            People

            • Assignee:
              handl Ralf Handl
              Reporter:
              sdrees Stefan Hagen
            • Watchers:
              0 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: