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

11.4.1.5 Returning Results from Data Modification Requests - media resources and stream properties

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Closed
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: V4.0_ERRATA01
    • Fix Version/s: V4.0_ERRATA01
    • Component/s: Protocol
    • Labels:
      None
    • Environment:

      [Applied]

    • Proposal:
      Hide

      Updates to media entity streams return the media entity, by default and on return=representation.

      Updates to stream properties return nothing by default, and the media stream on return=representation.

      Show
      Updates to media entity streams return the media entity, by default and on return=representation. Updates to stream properties return nothing by default, and the media stream on return=representation.

      Description

      The new section 11.4.1.5 Returning Results from Data Modification Requests specifies that the default response to data modification is the "after-image" of the modified resource.

      This contradicts the behavior for updating media resources specified in section 11.4.7.2 Editing a Media Entity Stream:

      If the request to edit a media stream returns a non-empty response body,
      the response body MUST contain the updated media entity.

      This special behavior for updating media resources is consistent with the special behavior for creating media resources, where also the media entity, i.e. the structured twin is returned.

      This deviating "default" behavior raises the question whether stream properties also should have a different default and use 204 no content if not specified otherwise.

        Attachments

          Activity

            People

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

              Dates

              • Created:
                Updated:
                Resolved: