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

11.4.9.4 Update a Collection Property: reference section 11.4.11 Positional Inserts

    XMLWordPrintable

    Details

    • Type: Improvement
    • Status: Resolved
    • Priority: Minor
    • Resolution: Fixed
    • Affects Version/s: V4.01_OS
    • Fix Version/s: V4.01_ERRATA01
    • Component/s: Protocol
    • Labels:
      None
    • Environment:

      Proposed

    • Proposal:
      Hide

      Add a reference and align the text.

      A successful POST request to the edit URL of a collection property adds an item to the collection. The body of the request MUST be a single item to be added to the collection. If the collection is ordered, the item is added to the end of the collection, and if the collection supports positional insert $index MAY be used to specify the insert positiona zero-based ordinal position to insert the new value, with a negative value indicating an ordinal position from the end of the collection.

      Explicitly mention that the success response for return=representation is the after-image of the collection, same as for a GET request to the collection property.

      Upon successful completion the service responds with either 200 OK and a representation of the updated collection, or 204 No Content. The client may request that the response SHOULD include a body by specifying a Prefer header with a value of return=representation.

       

      Show
      Add a reference and align the text. A successful POST request to the edit URL of a collection property adds an item to the collection. The body of the request MUST be a single item to be added to the collection. If the collection is ordered, the item is added to the end of the collection, and if the collection supports positional insert $index MAY be used to specify the insert position a zero-based ordinal position to insert the new value, with a negative value indicating an ordinal position from the end of the collection . Explicitly mention that the success response for return=representation is the after-image of the collection, same as for a GET request to the collection property. Upon successful completion the service responds with either  200 OK   and a representation of the updated collection, or  204 No Content . The client may request that the response SHOULD include a body by specifying a  Prefer header  with a value of  return=representation .  

      Description

      Section 11.4.9.4 Update a Collection Property also describes inserting into a collection. The current description partially overlaps with the content of section 11.4.11 Positional Inserts and does not reference this section.

       

        Attachments

          Activity

            People

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

              Dates

              • Created:
                Updated:
                Resolved: