[Fiware-ngsi] Clarification on the name of the NGSI10 operation to query context

[Fermín Galán Márquez]

Hi,

In a PSB-IoTBroker-ConfMan-IoTAgent/IDAS integration session today, Salvatore, Rafa and me have discovered a problem in the NGSI10 specification.

Currently, there is an inconsistence in http://forge.fi-ware.eu/plugins/mediawiki/wiki/fiware/index.php/FI-WARE_NGSI-10_Open_RESTful_API_Specification regarding the operation for query context in NGSI10. In particular, figure says that the URL for this operation should use "queryContext". On the contrary, the text of the specification says that the URL for the operation should be "contextQuery". The inconsistence also seems to happen in .doc, as Salvatore has checked.

We (TID) think that the right one should be "queryContext" due to:

  *   In all the other cases  (both NGSI9 and NGSI10) the name of the operation used in the URL matches with the one used in the OMA spec document (note that in the OMA spec document they use "queryContext")
  *   For all the other operations, the root element in the XML requests and responses defined in the XSD at https://forge.fi-ware.eu/scmrepos/svn/iot/trunk/schemes matches the name of the operation plus "Request" or "Response" at the end. Thus, having  "queryContextRequest" and "queryContextResponse" defined in the XSD implies that the operation has to be "queryContext". It would be really weird to have "queryContextRequest" and "queryContextResponse" but the operation called "contextQuery".

What do you think?

Best regards,

------
Fermín

________________________________

Este mensaje se dirige exclusivamente a su destinatario. Puede consultar nuestra política de envío y recepción de correo electrónico en el enlace situado más abajo.
This message is intended exclusively for its addressee. We only send and receive email on the basis of the terms set out at:
http://www.tid.es/ES/PAGINAS/disclaimer.aspx
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.fiware.org/private/fiware-ngsi/attachments/20130702/6b110014/attachment.html>