[Fiware-ngsi] NGSI-10 binding

[Tobias Jacobs]

Dear members of the FI-WARE NGSI-list

A new version of the NGSI-10 binding can be found at
https://forge.fi-ware.eu/scmrepos/svn/iot/trunk/documents/Ngsi10-RestfulBinding-Draft.docx
Major changes are marked in red.

I am listing below the open questions I have identified, together with a proposal of how to solve them:


1)      (already postet last week) Do we allow PUT and DELETE on ../ContextEntities/{EntityID}, ../ContextEntities/{EntityID}/attributes and ../ContextEntities/{EntityID}/attributes/{attributeName}?

--> my proposal: allow only DELETE on these resources.


2)      When querying ../ContextEntities/{EntityID}/AttributeDomains with GET, does that also return the values of attributes that do not belong to any domain?
--> my proposal: yes



3)      Is there a standard way to encode a URI inside a URI? This is because {typeName} has the type xs:anyURI in NGSI. Google uses some encoding for in the links contained in their search results, but I do not know if that is a standard way, and where such a standard is described.



è My proposal: no proposal.


4)      When querying a../ {typeName} resource or a subresource of it, should each returned Entity also contain information on its type? This would be redundant information.

--> my proposal: include the type information (but this is more a feeling than a proposal)



5)      It is thinkable that multiple providers provide domain metadata of a certain attribute domain, but there is no concept of different value instances for metadata.

--> my proposal: no proposal yet



6)      Should we distinguish between datastructures and input/output messages in the RESTful binding?



è My proposal: do not distinguish; in the end it is all an xml datastructure. And also in the case of some convenient functions we sometimes return a datastructure instead of an extra output message.


Thanks for your consideration and best regards
Tobias

From: Tobias Jacobs
Sent: Freitag, 23. März 2012 17:10
To: fiware-ngsi at lists.fi-ware.eu
Subject: NGSI-10 binding

Dear all,

Sorry, I have to admit that I will not manage to complete the new binding document version by today as promised.

The current version (which also includes comments about open points) can be found at https://forge.fi-ware.eu/scmrepos/svn/iot/trunk/documents/Ngsi10-RestfulBinding-Draft.docx

Please feel free to have a look at it and comment.

Best regards
Tobias
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.fiware.org/private/fiware-ngsi/attachments/20120326/148288d7/attachment.html>