Category: Smart Water Domain

In the tools option of the main menu, there are a few services to help you to use, create and debug your data models.

Although working, some of these services are limited. We are releasing the code for some of the services to allow you to contribute with improvments.

It appears by the end of the page with texts like this:

“source code of this service if you want to improve it.”

Source code has an hyperlink pointing to the specific script in the utils directory.

They are created in python and connected to the WP forms in each option

Specifically

• For the creation of schema based on a json keyvalues payload
• For the creation of schema based on a csv payload
• For merging several @context coming from different subjects

On the front page under the Community menu, there are two new entries
– Adopters: Lists the use cases documented in the different data models. It includes searchable facilities. It contains these fields:  adopter, description, mail, organization, project, comments, start date, subject and data model.

If you want to be listed, just make a PR on the file ADOPTERS.yaml of the data model folder. (The PR has to include an example ‘payload’ on how you use it)

– Contributors: Lists the people. It contains these fields:  name, surname, mail, organization, project, comments, year, and subject.

If you want to be listed you have to have contributed to any of the data models of the subject and then make a PR on the CONTRIBUTORS.yaml at the root of the subject.

In both cases the attributes are not mandatory so they can be empty.

In the documentation menu (Home -> documentation -> Basic info for:), there are now 4 new options to provide you with the basic information depending on your profile

• User. For those visitors with limited knowledge about what are the Smart Data Models
• Contributor. For those visitors willing to extend or to contribute with new data models
• Developer. For those visitors willing to integrate the data models with other tools or initiatives
• Researcher. For those visitors whose aim is to understand what is agile standardization and how it is implemented at the Smart Data Models Program

If you have some of these profiles and you miss some information please let us know

Initially, you will see few changes in the specifications of all data models,(it is in progress because it will last around 2 days to get it completed)

– The inclusion of the model for those attributes having it.

– Including the data type (when there is only one) for the attributes. ”

• address[object]: The mailing address. Model: https://schema.org/address“

– A footer with some useful links, etc

Smart Data Models +++ Contribution Manual +++ About

but there is another hidden relevant change. The specifications are now divided into sections by these tags:

<!– section name –>

<!– /section name –>

It makes easier to update part of the specification without disrupting the rest of the content, and in most markdown viewers it is unnoticed. Besides this, it also allows the extension of the specification (if needed in a coming future) with new sections.

And, of course, everything can be done automatically. Thus we can keep being agile according to our principles.

Therefore, if you see that the specifications are presenting an update don’t worry, Initially, it is just the format and this new trick.

And welcome to the Chinese translation which is using this new format already.

Now the list of specifications has a new language, Chinese. they are called spec_ZH.md
See the example with the WaterConsumption data model.

All the CONTRIBUTORS.yaml files across all subjects have been extended with a new attribute year. This year means the year of the contribution.
It will help us to give recognition to the contributors.
By default, it has been set to 2022 (it was much work to find out when the last contribution was submitted for each one of the several contributors across the 60 subjects).

It has been also changed in the template of the CONTRIBUTORS file in the templates folder.

In order to create a new data model or to update an existing one, Check your schema before contributing it, to check the schema on the front page.

The service has been updated to check not only the attributes of the payload but also the schema metadata (schema version, license, derivedFrom, title, description) so it will be easier to complete it before submission.

The code is available at the directory utils in the data-model repository.

Here you can have the presentation of the people presenting at the Smart Data Models session of the FIWARE summit.

Tomorrow at day 0 of the FIWARE summit there will be a training session about Smart Data Models.
Slides are freely shared here

This training will be delivered face to face.

• Intro:
  • Board and what is Smart Data Models Program
  • Current Status
  • Contributos and dissemintions
• Agile standardization
  • Current standardization status
  • M.A.S.: Manifesto for agile standardizationç
  • Standardization in a digital market
• Data model contents
  • Contents of a data model
  • Schema: review
  • Additional documents: examples, contributors, adopters, notes*
  • Generated documents: model.yaml, examples, README, context
• Data Model creation
  • Incubated repository.
  • From csv, json or open data portals
  • Tests
• Data Model moderation
  • Data model moderation
• Future
  • pysmartdatamodels
  • New services. Integration
  • New data models. Mapping of standardizations
  • Other services for the contributors