I think it is very helpful to have that explicit wording. +1 The only clarification that may be needed is whether the RDF/XML representation embedded in the Atom format should be the Core Guidance one, or the unrestricted one. I read it as the unrestricted one (which is ok, IMO).
Regards, Patrick |------------> | From: | |------------> >--------------------------------------------------------------------------------------------------------------------------------------------------| |Steve K Speicher <[email protected]> | >--------------------------------------------------------------------------------------------------------------------------------------------------| |------------> | To: | |------------> >--------------------------------------------------------------------------------------------------------------------------------------------------| |[email protected] | >--------------------------------------------------------------------------------------------------------------------------------------------------| |------------> | Date: | |------------> >--------------------------------------------------------------------------------------------------------------------------------------------------| |10/14/2010 05:37 PM | >--------------------------------------------------------------------------------------------------------------------------------------------------| |------------> | Subject: | |------------> >--------------------------------------------------------------------------------------------------------------------------------------------------| |Re: [oslc-cm] Proposed clarifying changes for Query Request XML format used | >--------------------------------------------------------------------------------------------------------------------------------------------------| I got some feedback after a discussion with someone that this was still a bit confusing. Perhaps it would be best to be extremely explicit. So here's a new proposal: For HTTP GET response formats for Query requests, CM Providers MUST provide RDF/XML, XML, Atom Syndication Format XML and JSON representations. When CM Consumers request: * application/rdf+xml CM Providers MUST respond with RDF/XML representation without restrictions. * application/json CM Providers MUST respond with JSON representation as defined in the OSLC Core Representations Guidance. * application/xml CM Provider MUST respond with OSLC-defined abbreviated XML representation as defined in the OSLC Core Representations Guidance. * application/atom+xml CM Provider MUST respond with Atom Syndication Format XML representation as defined in the OSLC Core Representations Guidance. * The Atom Syndication Format XML representation SHOULD use RDF/XML for the atom:content entries representing the resource representations. See Query Capabilities for additional information when Resource Shapes affect representation ----------------- I still need to work on a better name for " OSLC-defined abbreviated XML representation", I'll work with Core WG on this. Thanks, Steve Speicher | IBM Rational Software | (919) 254-0645 Steve K Speicher/Raleigh/IBM wrote on 10/13/2010 03:54:31 PM: > From: Steve K Speicher/Raleigh/IBM > To: [email protected] > Date: 10/13/2010 03:54 PM > Subject: Proposed clarifying changes for Query Request XML format used > > Per my action from today's WG meeting [1] to address an ambiguity in using > application/xml and query response representation. I have included the > changes inline for comment and here [2] for reference > > For HTTP GET response formats for Query requests, > > * CM Providers MUST provide RDF/XML, XML, Atom Syndication Format XML and > JSON representations. > * The XML, Atom Syndication Format XML and JSON representations SHOULD > follow the guidelines outlined in the OSLC Core Representations Guidance. > * The XML representation MUST be identified by using the application/xml > content type. This representation may not be the same as the Atom Syndication > Format XML representation, see OSLC Core Representations Guidance > * The Atom Syndication Format XML representation SHOULD use RDF/XML for > the atom:content entries representing the resource representations. > * See Query Capabilities for additional information when Resource Shapes > affect representation > > [1] http://open-services.net/bin/view/Main/CmMeetings10132010 > [2] http://open-services.net/bin/view/Main/CmSpecificationV2#Resource_Formats > > Thanks, > Steve Speicher | IBM Rational Software | (919) 254-0645 _______________________________________________ Oslc-Cm mailing list [email protected] http://open-services.net/mailman/listinfo/oslc-cm_open-services.net
