Hi all, Please find below the mail from Flavio drafted befor today’s meeting / agreement. But it gives some background of our thinking… Also find the schema files attached. - Ernoe Dear FIWARE partners, here at NEC, we are trying to create a JSON Schema for the JSON NGSI (version 1) specification. The motivation for this is that till now the only agreed formalization of a NGSI serialization was the XML for which we had an agreed XML schema. Thanks to that, we had a better integration between the IoT chapter components. Since then several IoT Chapter components have implemented also the JSON serialization of NGSI because it has been stated that FIWARE users would generally prefer to use JSON. The problem of this was that we have never agreed on a common JSON serialization and the result is, for example, that for the IoT Broker we have a JSON serialization pretty much close to the XML serialization, keeping the same data structure as defined in the OMA NGSI standard, and a JSON serialization made for the Orion Context Broker which slightly deviates from the original OMA NGSI standard specification. The JSON schema will help us to understand in a more formal way where the two serializations differs. What we have done first is to create the JSON schema for our NGSI serialization (attached to the mail an alpha version) and then modifying it according to the Orion version by reading from the Orion documentation (http://fiware-orion.readthedocs.io/en/latest/user/walkthrough_apiv1/#context-management-using-ngsi10). We have found very hard to follow this approach because the documentation there is very valuable from a point of view of a developer, since it is very much similar to a tutorial, but it is lacking of formality which is very useful (if not even necessary) in order to ease the task of spotting the differences with the original OMA NGSI Specification. Here some example of difficulties found so far: · UpdateContext: o the isPattern field of the contextElment is mandatory like in the OMA NGSI? Not clear in the text o the type field of the contextElement is mandatory differently from the OMA NGSI? Not clear in the text · UpdateContextType: o Found two more UpdateActionType like APPEND_STRICT and REPLACE. These two additional action types (not present in the standard OMA NGSI Specification) were explained through the whole tutorial text and not easy to get on a first glance like it would be in a table. o Are there any other UpdateActionType? · ContextElement o Is DomainMetadataList field suppressed? o Is AttributeDomainName suppressed? We are attaching also another json schema, which is the same schema we had for the NEC version with already some data structures changed accordingly to what we have inferred from the Orion documentation (only the UpdateContextRequest and connected data structures like ContextElement). It would be very useful if the Orion people will help us on finishing this document or, even better and quicker, change themselves the json schema we are providing within this mail in order to have formal specification and an easy way to make a “diff” of the two schemas. This will ease a lot the integration of the IoT Chapter components. Thank you in advance Best Regards Flavio ______________________________________________________________________________________ Dr. Ernö Kovacs エルノー・コヴァーチェ NEC Europe Ltd. NEC Laboratories Europe Senior Manager Cloud Service and Smart Things Kurfürsten-Anlage 36 | D-69115 Heidelberg E-Mail: ernoe.kovacs at neclab.eu<mailto:ernoe.kovacs at neclab.eu> Tel. +49 6221 4342 – 131 | Fax. +49 6221 4342 – 115 Mobile: +49 (163) 2086046 NEC Europe Limited | Registered Office: Athene, Odyssey Business Park, West End Road, London, HA4 6QE, GB | Registered in England 2832014 ______________________________________________________________________________________ -------------- next part -------------- An HTML attachment was scrubbed... URL: <https://lists.fiware.org/private/fiware-ngsi/attachments/20161213/a1561afb/attachment.html> -------------- next part -------------- A non-text attachment was scrubbed... Name: ngsi-v1.nec.jsonschema Type: application/octet-stream Size: 60651 bytes Desc: ngsi-v1.nec.jsonschema URL: <https://lists.fiware.org/private/fiware-ngsi/attachments/20161213/a1561afb/attachment.obj> -------------- next part -------------- A non-text attachment was scrubbed... Name: ngsi-v1.tid.jsonschema Type: application/octet-stream Size: 60816 bytes Desc: ngsi-v1.tid.jsonschema URL: <https://lists.fiware.org/private/fiware-ngsi/attachments/20161213/a1561afb/attachment-0001.obj>
You can get more information about our cookies and privacy policies clicking on the following links: Privacy policy Cookies policy