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

Enhancement of "flat heterogeneous" structure definition and reference thereof in section Delta Responses inside ODQP proposal pages 3/4 (and later)

    XMLWordPrintable

    Details

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

      [Closed]

      Description

      Inside the current revision of the proposal for an OData Delta Query Protocol i.e. [OData Delta Query Protocol Design 2012-12-19.docx](https://www.oasis-open.org/committees/download.php/47755/OData%20Delta%20Query%20Protocol%20Design%202012-12-19.docx) we should be clearer, as what the reader should understand as "flat, heterogeneous" in the last list item of section "Delta Responses" :?)

      Is it in JSON a (one dimensional) vector of maps/dicts ?

      """ ...
      For delta queries that are tracking changes to a set of related entities (for example, the result of a $expand request), the result includes changes to related entities, as well as added or deleted links, returned in a flat, heterogeneous result."""

      As she learns later from the samples for ATOM and JSON on the later pages, it is for ATOM a sequence of elements all children of the feed root element and for JSON a (one dimensional) vector of flat key-value dicts.

      I read Mikes issue item in the list following the main text of the document the way, that we also would prfoit from a central definition point of such a term in our collection of work products. This issue focusses on readability at the location the term first enters the stage in the document.

        Attachments

          Activity

            People

            • Assignee:
              mikep Michael Pizzo
              Reporter:
              sdrees Stefan Hagen
            • Watchers:
              0 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: