[OASIS Issue Tracker] (ODATA-1207) Clarify need for @odata.id in nested response structures

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

Gerald Krause created ODATA-1207:
------------------------------------

             Summary: Clarify need for @odata.id in nested response structures
                 Key: ODATA-1207
                 URL: https://issues.oasis-open.org/browse/ODATA-1207
             Project: OASIS Open Data Protocol (OData) TC
          Issue Type: Improvement
          Components: Extension for Data Aggregation
    Affects Versions: V4.0_CS02
            Reporter: Gerald Krause
             Fix For: V4.0_CSD04


This issue is to clarify, if nested entities included in the response to an aggregation request need to be equipped with an @odata.id control information.

Consider example 24 from the Data Aggregation specification:
{{GET ~/Sales?$apply=groupby((Customer/Country,Product/Name),}}
{{ aggregate(Amount with sum as Total))}}

results in
{{{}}

{{"@odata.context": "$metadata#Sales(Customer(Country),Product(Name),Total)",}}

{{"value": [}}
{{ \{ "@odata.id": null, "Customer": { "Country" : "Netherlands" },}}
{{ "Product": \{ "Name": "Paper" }, "Total": 3 },}}
 [...]

Top-level entities do have an @odata.id, but nested projections of related entities currently not. Is this according to rules defined in the format specs to be considered as a gap that needs to be discussed for the Data Aggregation spec?

The JSON specification describes in section 8.3 for expanded navigation properties that the content is to be rendered according to the entity representation. Two cases exist: 1) If the nested entity is a projection of a "real" entity, this could imply mentioning its @odata.id in the response. 2) If the nested entity is a result of an aggregation and therefore transient, section 4.5.8 of the JSON spec states: "If the entity is transient (i.e. cannot be read or updated), the id annotation MUST appear and have the null value."



--
This message was sent by Atlassian JIRA
(v7.7.2#77003)