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

Support subsetting returned metadata

    XMLWordPrintable

    Details

    • Type: Improvement
    • Status: Open
    • Priority: Major
    • Resolution: Unresolved
    • Affects Version/s: V4.0_ERRATA03
    • Fix Version/s: V4.02
    • Component/s: CSDL JSON, CSDL XML
    • Labels:
      None
    • Proposal:
      Hide

      Add a new preference, metadata-scope, that can be specified on a metadata request. The value follows the syntax for the fragment portion of a context URL to describe the shape of results for which the client needs metadata.

      Clients can then extract the fragment portion of the context url to use in the preference to requests only the metadata required to describe that particular response. If the response spans multiple namespaces the service MAY include multiple schema elements in the response, one per namespace containing types used in the response. Since this is a preference, services can also ignore and just return the metadata with references to related metadata.

      Services that support the metadata-scope preference SHOULD include a preference-applied header specifying the contextUrl fragment identifying the results described by the returned metadata.

      Example: to include the metadata required to describe customers and their orders, the client could specify:

      http://sampleservice.com/$metadata
      Prefer: metadata-scope=Customers(Orders)

      Services can return preference-applied to specify the extent of the metadata included. For any included namespaces, the service must return at least the requested data, but data in related namespaces can be referenced through Include.

      Show
      Add a new preference, metadata-scope, that can be specified on a metadata request. The value follows the syntax for the fragment portion of a context URL to describe the shape of results for which the client needs metadata. Clients can then extract the fragment portion of the context url to use in the preference to requests only the metadata required to describe that particular response. If the response spans multiple namespaces the service MAY include multiple schema elements in the response, one per namespace containing types used in the response. Since this is a preference, services can also ignore and just return the metadata with references to related metadata. Services that support the metadata-scope preference SHOULD include a preference-applied header specifying the contextUrl fragment identifying the results described by the returned metadata. Example: to include the metadata required to describe customers and their orders, the client could specify: http://sampleservice.com/$metadata Prefer: metadata-scope=Customers(Orders) Services can return preference-applied to specify the extent of the metadata included. For any included namespaces, the service must return at least the requested data, but data in related namespaces can be referenced through Include.

      Description

      After being able to partition large services into smaller ones using cross-service navigation we might want to support requesting multiple of these small files in one request, similar to expanding an entity and including related entities.

        Attachments

          Activity

            People

            • Assignee:
              mikep Michael Pizzo
              Reporter:
              handl Ralf Handl
            • Watchers:
              3 Start watching this issue

              Dates

              • Created:
                Updated: