Uploaded image for project: 'OASIS Open Data Protocol (OData) TC'
  1. OASIS Open Data Protocol (OData) TC
  2. ODATA-630 Consider making odata the default namespace for annotations
  3. ODATA-686

Alert clients that odata may be default namespace in future versions of the protocol

    XMLWordPrintable

    Details

    • Type: Sub-task
    • Status: Closed
    • Priority: Major
    • Resolution: Duplicate
    • Affects Version/s: V4.0_OS
    • Fix Version/s: V4.0_ERRATA01
    • Component/s: JSON Format
    • Labels:
      None
    • Environment:

      [Proposed]

    • Proposal:
      Hide

      In Section 4.5, Control information, of the OData JSON format doc.

      Add to the existing sentence:
      "In addition to the “pure data” a message body MAY contain control information that is represented as annotations whose names start with odata followed by a dot."

      the following:

      "Clients should be aware that future versions of OData are expected to allow omitting the odata prefix for control information, and should consider property names prefixed with the "@" symbol, and not containing a dot, to be the same as property names prefixed with "@odata.".

      Show
      In Section 4.5, Control information, of the OData JSON format doc. Add to the existing sentence: "In addition to the “pure data” a message body MAY contain control information that is represented as annotations whose names start with odata followed by a dot." the following: "Clients should be aware that future versions of OData are expected to allow omitting the odata prefix for control information, and should consider property names prefixed with the "@" symbol, and not containing a dot, to be the same as property names prefixed with "@odata.".

      Description

      OData control information is represented in a JSON payload as an annotation within the "odata" namespace. However, many services would like to return such control information without specifying the default "odata" namespace. ODATA-630 proposes allowing services to omit the "odata" namespace for OData control information, effectively making OData the default namespace. This would be more consistent with other formats such as JSON-LD.

      It would be nice to make clients aware that this change is likely, to allow them to anticipate it when implementing their V4 implementations.

        Attachments

          Activity

            People

            • Assignee:
              Unassigned
              Reporter:
              mikep Michael Pizzo
            • Watchers:
              2 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: