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

PATCH: new preference return=delta to get back a delta response

    XMLWordPrintable

    Details

    • Type: Improvement
    • Status: Open
    • Priority: Major
    • Resolution: Unresolved
    • Affects Version/s: V4.01_CS02
    • Fix Version/s: V4.02
    • Component/s: Protocol
    • Labels:
      None
    • Proposal:
      Hide

      Add preference return=delta for PATCH requests. The server then may respond with a delta payload containing the changes to the server state identified by the ETag in the PATCH request.

      It is a preference, so servers can ignore it.

      The maximum shape of the delta can be specified via $select and $expand.

      Add boolean property DeltaResponseSupported to type Capabilities.UpdateRestrictionsType to advertise support for this feature.

      Show
      Add preference return=delta for PATCH requests. The server then may respond with a delta payload containing the changes to the server state identified by the ETag in the PATCH request. It is a preference, so servers can ignore it. The maximum shape of the delta can be specified via $select and $expand. Add boolean property DeltaResponseSupported to type Capabilities.UpdateRestrictionsType to advertise support for this feature.

      Description

      Update requests can have side-effects, e.g. changing the street of an address could as a side-effect also change the zip code even if it is not present in the PATCH request body.

      We need a way to communicate to the client what actually has changed.

        Attachments

          Activity

            People

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

              Dates

              • Created:
                Updated: