[OASIS Issue Tracker] (ODATA-1346) Clarify handling of delta with $expand

[OASIS Issues Tracker <workgroup_mailer@lists.oasis-open.org>]

Gerald Krause created ODATA-1346:
------------------------------------

             Summary: Clarify handling of delta with $expand
                 Key: ODATA-1346
                 URL: https://issues.oasis-open.org/browse/ODATA-1346
             Project: OASIS Open Data Protocol (OData) TC
          Issue Type: Bug
          Components: Protocol
            Reporter: Gerald Krause
             Fix For: V4.01_OS


Section [11.3.1 Delta Links|https://docs.oasis-open.org/odata/odata/v4.01/csprd06/part1-protocol/odata-v4.01-csprd06-part1-protocol.html#sec_DeltaLinks] describes handling of $expand 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|https://docs.oasis-open.org/odata/odata/v4.01/csprd06/part1-protocol/odata-v4.01-csprd06-part1-protocol.html#sec_SystemQueryOptionselect] 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|https://docs.oasis-open.org/odata/odata/v4.01/csprd06/part1-protocol/odata-v4.01-csprd06-part1-protocol.html#sec_SystemQueryOptionexpand] in order to specify interest in the set of related entities without interest in changes to the content of those related entities.â



--
This message was sent by Atlassian Jira
(v8.3.3#803004)