11.2.9: clarify /$count segment and system query options

    • Type: Improvement
    • Resolution: Fixed
    • Priority: Minor
    • V4.01_CSD02
    • Affects Version/s: V4.0_ERRATA03
    • Component/s: Protocol
    • None
    • Environment:

      Applied

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

            Assignee:
            Unassigned
            Reporter:
            handl
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated:
              Resolved: