[OASIS Issue Tracker] Updated: (ODATA-388) Remove "when" from OData-specific items in delta responses

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

     [ http://tools.oasis-open.org/issues/browse/ODATA-388?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Ralf Handl updated ODATA-388:
-----------------------------

        Summary: Remove "when" from OData-specific items in delta responses  (was: Rename "when" to "odata.when" and allow it in added/changed entities)
       Proposal: 
Atom: remove when attribute from metadata:link and metadata:deleted-link elements.

JSON: remove "when" name/value pair from deletedEntity, link, and deletedLink objects in delta responses.

  was:See summary

    Component/s: OData ATOM Format 
    Description: 
We added when to added/deleted links in ATom because it was part of the Atom tombstone specification for deleted entries. We added when to JSON to be consistent with Atom.

However, because we impose an ordering on the returned changes that leads to eventual consistency, knowing "when" a change occurred is of dubious value.

As we don't currently have an annotation for last change in JSON, nor do we have a way for the client to say whether or not they want/care about such information, we should remove the "when" name/value pair from added/deleted links and tombstones in JSON, so it only appears for well-formedness in Atom tombstones with no semantic meaning in OData, and perhaps we can get it optional there as well.

  was:The creation/change timestamp is valuable information for clients and present in Atom (atom:updated), so we should add it to JSON.


> Remove "when" from OData-specific items in delta responses
> ----------------------------------------------------------
>
>                 Key: ODATA-388
>                 URL: http://tools.oasis-open.org/issues/browse/ODATA-388
>             Project: OASIS Open Data Protocol (OData) TC
>          Issue Type: Bug
>          Components: OData ATOM Format , OData JSON Format
>    Affects Versions: V4.0_CSD01
>         Environment: [Proposed]
>            Reporter: Ralf Handl
>             Fix For: V4.0_CSD02
>
>
> We added when to added/deleted links in ATom because it was part of the Atom tombstone specification for deleted entries. We added when to JSON to be consistent with Atom.
> However, because we impose an ordering on the returned changes that leads to eventual consistency, knowing "when" a change occurred is of dubious value.
> As we don't currently have an annotation for last change in JSON, nor do we have a way for the client to say whether or not they want/care about such information, we should remove the "when" name/value pair from added/deleted links and tombstones in JSON, so it only appears for well-formedness in Atom tombstones with no semantic meaning in OData, and perhaps we can get it optional there as well.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://tools.oasis-open.org/issues/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira