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

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

    XMLWordPrintable

    Details

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

      [Applied]

    • Proposal:
      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)"
    • Resolution:
      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

      Description

      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.

        Attachments

          Activity

            People

            • Assignee:
              Unassigned
              Reporter:
              patrick Patrick Durusau
            • Watchers:
              0 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: