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

Clarify $select behavior for stream properties

    XMLWordPrintable

    Details

    • Type: Improvement
    • Status: Open
    • Priority: Major
    • Resolution: Unresolved
    • Affects Version/s: V4.01_OS
    • Fix Version/s: V4.01_ERRATA01
    • Component/s: JSON Format, Protocol
    • Labels:
      None
    • Environment:

      Proposed

    • Proposal:
      Hide

      JSON Format:

      • Stream properties requested with $select or included in the default selection are represented by their control information odata.media*.
      • Stream properties requested with $expand or implicitly expanded are represented as a property with its value.

      Protocol:

      • Services SHOULD support direct property access to a stream property's canonical URL (e.g. GET Entity(123)/Thumbnail). The response MAY be a redirect to the media read link of the stream property if the media read link is different from the canonical URL.
      • Note: if neither canonical URL nor media read link can be used and the stream value can only be accessed via $expand, the modeler should have used an Edm.Binary property instead.
      Show
      JSON Format: Stream properties requested with $select or included in the default selection are represented by their control information odata.media* . Stream properties requested with $expand or implicitly expanded are represented as a property with its value. Protocol: Services SHOULD support direct property access to a stream property's canonical URL (e.g. GET Entity(123)/Thumbnail ). The response MAY be a redirect to the media read link of the stream property if the media read link is different from the canonical URL. Note: if neither canonical URL nor media read link can be used and the stream value can only be accessed via $expand, the modeler should have used an Edm.Binary property instead.

      Description

      The $select behavior for stream properties is not explicitly stated.

      Clarify whether property access to stream properties (e.g. GET Entity(123)/Thumbnail) is expected to be implemented by services.

        Attachments

          Activity

            People

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

              Dates

              • Created:
                Updated: