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

Clarify that PUT must persist all "updatable" properties

    XMLWordPrintable

    Details

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

      [Applied]

    • Proposal:
      Hide

      Clarify that statements around updating properties apply to structural updatable structural properties.

      Show
      Clarify that statements around updating properties apply to structural updatable structural properties.

      Description

      In section 11.4.3, Update an Entity, we are clear that non-updatable properties specified in PUT or PATCH are ignored:
      "Key and other non-updatable properties, as well as dependent properties that are not tied to key properties of the principal entity, can be omitted from the request. If the request contains a value for one of these properties, the service MUST ignore that value when applying the update."

      However, we also make general statements like:
      "Collection properties and primitive properties provided in the payload MUST replace the value of the corresponding property in the entity or complex type"
      and
      "Services that support PUT MUST replace all values of structural properties with those specified in the request body"

      We should clarify that these later statements apply to updatable structural properties.

        Attachments

          Activity

            People

            • Assignee:
              mikep Michael Pizzo
              Reporter:
              mikep Michael Pizzo
            • Watchers:
              2 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: