[ODATA-1016] 11.2.9: clarify /$count segment and system query options - OASIS Technical Committees Issue Tracker

XML

Word

Printable

Proposal:

Hide

Replace

The returned count MUST NOT be affected by $top, $skip, $orderby, or $expand. Content negotiation using the Accept request header or the $format system query option is not allowed with the path segment /$count.

with

Clients SHOULD NOT combine system query options $top, $skip, $orderby, $expand, and $format with the path segment /$count. The result of such a request is undefined.

Show
Replace The returned count MUST NOT be affected by $top, $skip, $orderby, or $expand. Content negotiation using the Accept request header or the $format system query option is not allowed with the path segment /$count. with Clients SHOULD NOT combine system query options $top, $skip, $orderby, $expand, and $format with the path segment /$count. The result of such a request is undefined.
Resolution:

Hide

https://www.oasis-open.org/committees/download.php/60256/odata-v4.01-wd02-part1-protocol-2017-03-10.docx

Show
https://www.oasis-open.org/committees/download.php/60256/odata-v4.01-wd02-part1-protocol-2017-03-10.docx

Part 1, section 11.2.9 on the /$count path segment states:

The returned count MUST NOT be affected by $top, $skip, $orderby, or $expand.

Part 2, section 5.1 states that only $filter and $search are allowed for paths ending in /$count.

"Not allowed" is clearer than "must not be affected by", so rephrase part 1.