Clarify whether new annotation target syntax requires Version=4.01

    • Type: Improvement
    • Resolution: Fixed
    • Priority: Minor
    • V4.01_CS02
    • Affects Version/s: V4.01_CS02
    • Component/s: CSDL JSON, CSDL XML
    • None
    • Hide

      Do not require Version=4.01 or OData-Version:4.01 for these new targets.

      Rationale: we already require in CSDL Version 4.0 Errata 03 that (minus the blue text)

      Unknown or invalid annotations should never result in an error, as long as the payload remains well-formed. Clients SHOULD ignore invalid or unknown terms and silently treat unexpected or invalid values (including invalid type, invalid literal expression, invalid targets, etc.) as an unknown value for the term.

      So worst case clients the annotation on the overload.

      Add the blue text to make this unambiguously clear.

      Show
      Do not require Version=4.01 or OData-Version:4.01 for these new targets. Rationale: we already require in CSDL Version 4.0 Errata 03 that (minus the blue text) Unknown or invalid annotations should never result in an error, as long as the payload remains well-formed. Clients SHOULD ignore invalid or unknown terms and silently treat unexpected or invalid values (including invalid type, invalid literal expression, invalid targets, etc.) as an unknown value for the term. So worst case clients the annotation on the overload. Add the blue text to make this unambiguously clear.
    • Show
      https://www.oasis-open.org/committees/download.php/64947/odata-csdl-json-v4.01-wd05-2019-03-22.docx https://www.oasis-open.org/committees/download.php/64948/odata-csdl-xml-v4.01-wd06-2019-03-22.docx

      With ODATA-1178 we added the possibility to target individual action/function overloads by appending their signature to the action/function name.

      Clarify whether this already requires to use Version=4.01, or whether this is just "string content" for the Target attribute and can be used with Version=4.0

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

              Created:
              Updated:
              Resolved: