[OASIS Issue Tracker] Updated: (ODATA-206) Rephrasing of section Delta Links in ODQP proposal page 1/2

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

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

Michael Pizzo updated ODATA-206:
--------------------------------

       Proposal: Rewritten as suggested in version 1.3: https://www.oasis-open.org/apps/org/workgroup/odata/download.php/47996/OData%20Delta%20Query%20Protocol%20Design%202013-1-23.docx  (was: Rewrite as suggested.)
    Environment: [Proposed]

> Rephrasing of section Delta Links in ODQP proposal page 1/2
> -----------------------------------------------------------
>
>                 Key: ODATA-206
>                 URL: http://tools.oasis-open.org/issues/browse/ODATA-206
>             Project: OASIS Open Data Protocol (OData) TC
>          Issue Type: Improvement
>    Affects Versions: WD01
>         Environment: [Proposed]
>            Reporter: Stefan Drees
>            Assignee: Michael Pizzo
>            Priority: Minor
>             Fix For: WD01
>
>
> Inside the current revision of the proposal for an OData Delta Query Protocol i.e. [OData Delta Query Protocol Design 2012-12-19.docx](https://www.oasis-open.org/committees/download.php/47755/OData%20Delta%20Query%20Protocol%20Design%202012-12-19.docx) please consider rewriting:
> """
> Delta Links
> An OData Service supports result maintenance by including a "delta link" url in the last page of results returned from a request for which the service can enumerate changes. This delta link is generated in place of the next link on the last page of the result. It is illegal for a response to contain both a delta link and a next page link.
> Clients can use this delta link to query the service for changes that have occurred to the result since the initial request.
> Delta links are returned only on requests that return a collection of zero or more entities. Requests for individual entities (for example ~/Customers('ALFKI') or property values (for example, ~/Customers('ALFKI')/ContactName) do not include delta links."""
> into:
> """
> Delta Links
> For any request for which the OData Service can enumerate changes the service SHOULD support result maintenance by including a "delta link" url in place of the next link on the last page of results returned.
> A response MAY contain a next page or a delta link, but MUST NOT contain both.
> Clients can use this delta link to query the service for changes that have occurred to the result since the initial request.
> Delta links MUST only be returned upon requests whose responses contain a collection of zero or more entities. Requests for individual entities or property values MUST NOT include delta links. Corresponding examples for such requests are  ~/Customers('ALFKI') and ~/Customers('ALFKI')/ContactName respectively.""" 
> to ease understanding of main statements and extraction of conformance tests.

-- 
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