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

Clarify handling of delta with $expand

    XMLWordPrintable

    Details

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

      Proposed

    • Proposal:
      Hide

      change the wording of the first cited paragraph to:

      If the defining query includes expanded relationships, the delta link MUST return changes, additions, or deletions to the expanded entities, as well as added or deleted links to expanded entities or nested collections representing current membership. If the defining query includes expanded references, then the delta link MUST return changes to the membership in the set of expanded references.

      Show
      change the wording of the first cited paragraph to: If the defining query includes expanded relationships, the delta link MUST return changes, additions, or deletions to the expanded entities, as well as added or deleted links to expanded entities or nested collections representing current membership. If the defining query includes expanded references, then the delta link MUST return changes to the membership in the set of expanded references.
    • Resolution:
      Show
      https://www.oasis-open.org/committees/download.php/66404/odata-v4.01-wd09-part1-protocol-2019-12-12.docx

      Description

      Section 11.3.1 Delta Links describes handling of delta queries in combination with $expand, the relevant text is attached below. The highlighted sentence seems contradictory and should be clarified. It demands that the delta response must include changes to the expanded entities also for navigation properties expanded with $ref, whereas the following paragraph states that a delta query with a $ref expansion will ignore changes to changes to related entities.

      "If the defining query includes expanded relationships, the delta link MUST return changes, additions, or deletions to the expanded entities, as well as added or deleted links to expanded entities or nested collections representing current membership. This is independent of whether related entity themselves or only references to related entities were requested. 

      Navigation properties specified in the $select list of a defining query are not used to define the scope or contents of the items being tracked. Clients can specify /$ref in $expand in order to specify interest in the set of related entities without interest in changes to the content of those related entities.“

        Attachments

          Activity

            People

            • Assignee:
              Unassigned
              Reporter:
              gerald.krause1 Gerald Krause
            • Watchers:
              2 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: