11.2.3 OData services MAY/SHOULD/MUST expose their data model

XMLWordPrintable

    • Type: Bug
    • Resolution: Fixed
    • Priority: Minor
    • V4.0_CSD02
    • Affects Version/s: V4.0_CSD01
    • Component/s: Protocol
    • None
    • Environment:

      [Applied]

    • Hide

      Delete in 11.2.3 "OData services MAY/SHOULD/MUST expose their data model as an OData Metadata Service."

      Change first sentence, last paragraph of 11.2.3 from "The" to "A". Same for start of second sentence, last paragraph.

      Add in 13.1.1 "MAY publish metadata at /$metadata according to [OData-CSDL] (section Metadata Document Request)"

      Show
      Delete in 11.2.3 "OData services MAY/SHOULD/MUST expose their data model as an OData Metadata Service." Change first sentence, last paragraph of 11.2.3 from "The" to "A". Same for start of second sentence, last paragraph. Add in 13.1.1 "MAY publish metadata at /$metadata according to [OData-CSDL] (section Metadata Document Request)"
    • Hide

      https://www.oasis-open.org/committees/download.php/49353/odata-v4.0-wd02-part1-protocol-2013-05-28.docx

      Accepted: https://www.oasis-open.org/committees/download.php/49557/odata-meeting-41_on-20130613_14-F2F-minutes.html#odata-408

      Show
      https://www.oasis-open.org/committees/download.php/49353/odata-v4.0-wd02-part1-protocol-2013-05-28.docx Accepted: https://www.oasis-open.org/committees/download.php/49557/odata-meeting-41_on-20130613_14-F2F-minutes.html#odata-408

      Checking against the conformance clauses:

      OData Minimal Conformance Level is missing: "MAY publish metadata at /$metadata according to [OData-CSDL] (section Metadata Document Request)"

      OData Intermediate Conformance Level has: "SHOULD publish metadata at /$metadata according to [OData-CSDL] (section Metadata Document Request)"

      OData Advanced Conformance Level has: "MUST publish metadata at /$metadata according to [OData-CSDL] (section Metadata Document Request)"

      Suggest defining OData Metadata Service at 11.2.3, therefore delete: "OData services MAY/SHOULD/MUST expose their data model as an OData Metadata Service." and let the conformance clauses refer to this section to say may, should or must.

      Just a nit, I would say "A" metadata service..., since not every conforming OData implementation will offer a metadata service. And "A" Metadata Service Document URL, same reasoning.

            Assignee:
            Unassigned
            Reporter:
            Patrick Durusau
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved: