[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: [OASIS Issue Tracker] Updated: (ODATA-206) Rephrasing of section Delta Links in ODQP proposal page 1/2
[ http://tools.oasis-open.org/issues/browse/ODATA-206?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ] Ralf Handl updated ODATA-206: ----------------------------- Component/s: OData Protocol v1.0 > 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 > Components: OData Protocol v1.0 > 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
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]