DDS-WEB 1.0 FTF Avatar
  1. OMG Issue

DDSWEB — Inconsistent and incomplete specification of resource representations

  • Key: DDSWEB-19
  • Status: closed  
  • Source: Real-Time Innovations ( Gerardo Pardo-Castellote)
  • Summary:

    Table 5 in Section 8.3.3 lists the resource representations that appear in the bodies of the REST operations and Table 6 specifies the location in the XSD where those representations are defined.
    However the references to the XSD in Table 6 point to the definition of a “type” inside the XSD (for example participantObjectRepresentation points to the xs:complexType named “DomainParticipant”). It would be better if the specification of the representation was done in terms of an XML element (of an XSD-defined type) rather than in terms of the type itself. If the specification is done referencing just the XSD type the resulting definition does not specify an outer XML element name. This is ambiguous and could be interpreted as implying that there is no outer XML element (e.g. the information appears directly inside <body> section of the HTML). If the definition was done using an XSD element, the resource representation would appear inside a single XSD element facilitating parsing and avoiding potentially conflicting interpretations of the specification.
    In addition applicationRepresentation and qosRepresentation appear in webdds_rest1.xsd but are missing from section 8.3.4. They should be added to 8.3.4.
    Also missing is the definition of a list of participantObjectRepresentation and list of typeObjectRepresentation.
    The reference to DDS-XTYPES in Table 6, second row is incorrect. The referenced schema is in webdds_rest1.xsd, not DDS-XTYPES.

  • Reported: DDS-WEB 1.0b1 — Mon, 10 Aug 2015 09:35 GMT
  • Disposition: Duplicate or Merged — DDS-WEB 1.0
  • Disposition Summary:

    Issue duplicated DDSWEB-14

    Mark as duplicate

  • Updated: Tue, 22 Dec 2015 15:08 GMT