Replace multiple batch capability term with single "BatchSupport" term

    • Type: Bug
    • Resolution: Fixed
    • Priority: Major
    • V4.01_WD01
    • Affects Version/s: V4.0_ERRATA03, V4.01_WD01
    • Component/s: CSDL XML
    • None
    • Environment:

      Proposed

    • Hide

      Remove before publishing the following capability term:
      -BatchContentIdReferencingInRequestBodiesSupported

      Deprecate the following capabilities terms:
      -BatchSupported
      -BatchContinueOnErrorSupported

      Define a new "BatchSupport" term in the capabilities vocabulary for putting these and other capabilities related to batch:

      <Term Name="BatchSupport" Type="Capabilities.BatchSupportType" AppliesTo="EntityContainer">
      <Annotation Term="Core.Description" String="Batch Support for the service"/>
      </Term>

      <ComplexType Name="BatchSupportType">
      <Property Name="Supported" Type="Edm.Boolean" DefaultValue="true">
      <Annotation Term="Core.Description" String="Service supports requests to $batch" />
      </Property>
      <Property Name="ContinueOnErrorSupported" Type="Edm.Boolean">
      <Annotation Term="Core.Description" String="Service supports the continue on error preference" />
      </Property>
      <Property Name="ReferencesInRequestBodiesSupported" Type="Edm.Boolean">
      <Annotation Term="Core.Description" String="Service supports Content-ID referencing in request bodies" />
      </Property>
      <Property Name="ReferencesAcrossChangeSetsSupported" Type="Edm.Boolean">
      <Annotation Term="Core.Description" String="Service supports Content-ID referencing across change sets" />
      </Property>
      <Property Name="EtagReferencesSupported" Type="Edm.Boolean">
      <Annotation Term="Core.Description" String="Service supports referencing Etags from previous requests" />
      </Property>
      </ComplexType>

      Show
      Remove before publishing the following capability term: -BatchContentIdReferencingInRequestBodiesSupported Deprecate the following capabilities terms: -BatchSupported -BatchContinueOnErrorSupported Define a new "BatchSupport" term in the capabilities vocabulary for putting these and other capabilities related to batch: <Term Name="BatchSupport" Type="Capabilities.BatchSupportType" AppliesTo="EntityContainer"> <Annotation Term="Core.Description" String="Batch Support for the service"/> </Term> <ComplexType Name="BatchSupportType"> <Property Name="Supported" Type="Edm.Boolean" DefaultValue="true"> <Annotation Term="Core.Description" String="Service supports requests to $batch" /> </Property> <Property Name="ContinueOnErrorSupported" Type="Edm.Boolean"> <Annotation Term="Core.Description" String="Service supports the continue on error preference" /> </Property> <Property Name="ReferencesInRequestBodiesSupported" Type="Edm.Boolean"> <Annotation Term="Core.Description" String="Service supports Content-ID referencing in request bodies" /> </Property> <Property Name="ReferencesAcrossChangeSetsSupported" Type="Edm.Boolean"> <Annotation Term="Core.Description" String="Service supports Content-ID referencing across change sets" /> </Property> <Property Name="EtagReferencesSupported" Type="Edm.Boolean"> <Annotation Term="Core.Description" String="Service supports referencing Etags from previous requests" /> </Property> </ComplexType>
    • Show
      https://tools.oasis-open.org/version-control/browse/wsvn/odata/trunk/4.01%20spec/vocabularies/Org.OData.Capabilities.V1.xml https://www.oasis-open.org/apps/org/workgroup/odata/download.php/59028/odata-v4.01-wd01-part1-protocol.docx

      In the current published vocabulary we have two different capabilities terms related to batch (Supported and ContinueOnErrorSupported). We at least three more already lined up for 4.01:
      "BatchContentIdReferencingInRequestBodiesSupported" (ODATA-479),
      "ContentIdReferencingAcrossChangeSetsSupported" (ODATA-480), and
      "EtagReferencingSupported" (OData-541)

      In most cases (filter, expand, etc.) we have grouped related terms together under a single capability. I would suggest we do the same for $batch.

            Assignee:
            Unassigned
            Reporter:
            Michael Pizzo (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated:
              Resolved: