• Domains

  • Governance

    The availability of widely adopted (de-facto standard) information models is key for creating a global digital single market of interoperable and replicable (portable) smart solutions in multiple domains (smart cities, smart agrifood, smart utilities, smart industry, …).


    Such models provide an essential element in the common technical ground needed for standards-based open innovation and procurement. Data Models play a crucial role because they define the harmonised representation formats and semantics that will be used by applications both to consume and to publish data.

    The FIWARE Foundation, TM Forum, IUDX and other entities to join, are leading a joint collaboration program to support the adoption of a reference architecture and compatible common data models that underpin a digital market of interoperable and replicable smart solutions in multiple sectors, starting with smart cities. All data models are public and royalty-free nature of specifications. Data Model Licensing mode. Preferred Creative Commons by Attribution 4.0

    Organizations can evolve their current data sharing policies towards a vision which, shared with other organizations, brings support to a Data Economy.

    This GitHub organization structure contains JSON Schemas and documentation on Smart Data Models for different Smart Domains. For each Domain (industrial sector) there is a Repository containing as submodules the link to the Subjects containing all the Data Models related. And some other shared elements for all the domain. For each Vertical(Subject) there is a Repository containing the Data Models related to that vertical. These repositories do admit pull requests regardign data models.

    General Principles
    1. Driven-by-implementation approach: Specifications will be considered stable as soon as enough end user organizations (e.g., cities) have validated them in practice.
    2. Open-closed. Breaking changes to already approved specs are not allowed. Instead, new versions shall deprecate attributes, add new attributes, extend enumerations, etc.
    3. Open contribution. Contributions open to anybody (not only members), while final decision making corresponds to the administrators of the domains and Subjects. Management (currently TM Forum, FIWARE Foundation and IUDX) could opposed to some contributions if it does not meet coding guidelines.

Updated the attributes search data base

In order to create a new data model is always interesting what others have done in order copy and to maintain interoperability.

That’s why we have available a database with all attributes and enumerations across all data models.

Now it’s updated daily and the number of occurrences is also available.

What’s is your opinion of the new specification model?

We are testing a potential new format for the specification that

1) makes easier for people to read the specification

2) provides additional utility to be connected with other platforms making NGSI more compatible

Could you check these two new specifications Building, BuildingOperation compared with the old two Building, BuildingOperation and gives us your opinion?

(once in, click on the name of the object for deploying all the content)

[cf7form cf7key=”new-specification-format”]

The actual new specs are here without viewer (building, building operation) what you see above is generated automatically from the yaml specs.

What’s the idea behind adopting yaml specifications? To allow multiple evolutions (automatic multilanguage spec, integration with other platforms, etc)

Working on new data models for water

In the pending repository (the place where the data models can be developed if you wish) there is an interesting working going on about sensoring related to water management.

In development is :

– A data model for the actuator

– A data model for the service which is related to the actuator

– Modifications of the device data model

– A data model for a gateway gathering the data of a group of sensors

They are in the very early stages (so not that much is being contributed).

These contributions are based on the works of the EU project FIWARE4WATER in its group of IoT data models. You can contact them here.

Help for data modellers

Some of the contributors have requested some help about creating new data models. How to do it and where to do it.


1) If you are clear about the payloads that you want to share (you have a plain key values json payload)

i.e. https://raw.githubusercontent.com/smart-data-models/dataModel.Weather/master/WeatherObserved/example.jsonld

2) You can use this tool https://www.liquid-technologies.com/online-json-to-schema-converter (This link is always available in the Learning Zone on the upper menu, section tools)

to generate a draft version of the json schema. You will have to review (for sure).

– Whether you need some restrictions (min, max) on number properties

– The number of required properties

– The full list of options in enumeration properties

– Remove the context (it is treated as property)

– Check the Arrays (minItems, etc)

and possibly some other minor issues


3) We offer an open repository named pending for you to contribute while developing. Ask for access raising an issue with the option ‘Access to pending repository’