Uploaded image for project: 'OASIS Open Data Protocol (OData) TC'
  1. OASIS Open Data Protocol (OData) TC
  2. ODATA-1295

Clarify whether new annotation target syntax requires Version=4.01

    XMLWordPrintable

    Details

    • Type: Improvement
    • Status: Closed
    • Priority: Minor
    • Resolution: Fixed
    • Affects Version/s: V4.01_CS02
    • Fix Version/s: V4.01_CS02
    • Component/s: CSDL JSON, CSDL XML
    • Labels:
      None
    • Proposal:
      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.
    • Resolution:
      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

      Description

      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

        Attachments

          Activity

            People

            • Assignee:
              Unassigned
              Reporter:
              handl Ralf Handl
            • Watchers:
              1 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: