{"id":781,"date":"2020-11-23T10:46:09","date_gmt":"2020-11-23T10:46:09","guid":{"rendered":"https:\/\/smartdatamodels.org\/?p=781"},"modified":"2020-11-23T10:46:09","modified_gmt":"2020-11-23T10:46:09","slug":"migration-to-schema-generated-specifications","status":"publish","type":"post","link":"https:\/\/smartdatamodels.org\/index.php\/migration-to-schema-generated-specifications\/","title":{"rendered":"Migration to schema-generated specifications"},"content":{"rendered":"

In order to:<\/p>\n

    \n
  1. Maintain updated the specifications<\/li>\n
  2. Be able to provide them in multiple languages<\/li>\n
  3. Being able to track what properties are already defined<\/li>\n
  4. Populate properly the database of properties<\/li>\n
  5. Have a shared image for all contributions<\/li>\n
  6. Reduce the burden of work for the contributors (it will be reduced to just the documented json schema and the examples)<\/li>\n<\/ol>\n

    It has been decided that the description of the properties of the data models will be included in the schemas defining the data models (or those linked through $ref). so during next days, you will see minor changes in the schema.json of every data model in the initiative.<\/p>\n

    And although it will be announced previously all the spec.md will be replaced by an automatically generated (based on the info). See an example here. <\/a>Design could be modified so any suggestion will be assessed and eventually implemented.<\/p>\n

    Customization will be possible through a new file named notes.yaml<\/p>\n

    This is taking most of our resources and impact on our bandwidth t provide answers to the PR, but we expect that this will reduce our workload significantly so we will be more agile after this change.<\/p>\n","protected":false},"excerpt":{"rendered":"

    In order to: Maintain updated the specifications Be able to provide them in multiple languages Being able to track what properties are already defined Populate properly the database of properties Have a shared image for all contributions Reduce the burden of work for the contributors (it will be reduced to… More…<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[105,107,109,113,115,119,117,88,143,111,125],"tags":[],"class_list":["post-781","post","type-post","status-publish","format-standard","hentry","category-cross-sector","category-smart-cities","category-smart-energy-domain","category-smart-environment","category-smart-manufacturing","category-smart-robotics","category-smart-water","category-smart-sensoring","category-smartaeronautics","category-smart-agrifood","category-smartdestinations"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"jetpack-related-posts":[{"id":1969,"url":"https:\/\/smartdatamodels.org\/index.php\/include-useralias-in-common-schema-json\/","url_meta":{"origin":781,"position":0},"title":"Include userAlias in common-schema.json","author":"maestro","date":"23\/03\/2021","format":false,"excerpt":"The file common-schema.json compiles those properties massively used across the different data models in the different domains. The property userAlias has been included to store those anonymous identifiers of a user that cannot be traced back to the user. It can be referenced in any data model just by including\u2026","rel":"","context":"In "Cross Sector"","block_context":{"text":"Cross Sector","link":"https:\/\/smartdatamodels.org\/index.php\/category\/cross-sector\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":904,"url":"https:\/\/smartdatamodels.org\/index.php\/data-models-contribution-api\/","url_meta":{"origin":781,"position":1},"title":"Data Models Contribution API","author":"maestro","date":"30\/11\/2020","format":false,"excerpt":"The schemas to be accepted in the Smart Data Model initiative need to include a description for every property. In order to review your data models before submission, it should pass this test. Call: https:\/\/smartdatamodels.org\/extra\/check_schema.php Parameters: (Mandatories) schemaUrl: The link to the RAW version of the schema (see example) mail:\u2026","rel":"","context":"In "Smart Cities domain"","block_context":{"text":"Smart Cities domain","link":"https:\/\/smartdatamodels.org\/index.php\/category\/smart-cities\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":930,"url":"https:\/\/smartdatamodels.org\/index.php\/check-a-schema-validates-a-payload\/","url_meta":{"origin":781,"position":2},"title":"Check a schema validates a payload","author":"maestro","date":"07\/12\/2020","format":false,"excerpt":"If you want to check if a schema validates a payload\u00a0 through this API call Call: https:\/\/smartdatamodels.org\/extra\/validate_payload.php Parameters: (Mandatories) payloadUrl: The url of the payload in RAW version schemaUrl: The link to the RAW version of the json schema (see example) Example: https:\/\/smartdatamodels.org\/extra\/validate_payload.php?payloadUrl=https:\/\/raw.githubusercontent.com\/smart-data-models\/dataModel.Battery\/master\/Battery\/examples\/example.json&schemaUrl=https:\/\/raw.githubusercontent.com\/smart-data-models\/dataModel.Battery\/master\/Battery\/schema.json Output: A json payload with these properties\u2026","rel":"","context":"In "Smart Cities domain"","block_context":{"text":"Smart Cities domain","link":"https:\/\/smartdatamodels.org\/index.php\/category\/smart-cities\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":913,"url":"https:\/\/smartdatamodels.org\/index.php\/updated-the-contribution-manual\/","url_meta":{"origin":781,"position":3},"title":"updated the contribution manual","author":"maestro","date":"02\/12\/2020","format":false,"excerpt":"The contribution manual (link in the upper menu of main page) is updated due to the change in the approach for documenting the data models. Main changes: Properties' definitions are now included as an attribute in the json schema The specification is generated automatically based on the json schema Json\u2026","rel":"","context":"In "Smart Cities domain"","block_context":{"text":"Smart Cities domain","link":"https:\/\/smartdatamodels.org\/index.php\/category\/smart-cities\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":453,"url":"https:\/\/smartdatamodels.org\/index.php\/help-for-data-modellers\/","url_meta":{"origin":781,"position":4},"title":"Help for data modellers","author":"maestro","date":"08\/06\/2020","format":false,"excerpt":"Some of the contributors have requested some help about creating new data models. How to do it and where to do it. HOW TO CREATE DATA MODELS 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\u2026","rel":"","context":"In "Coding"","block_context":{"text":"Coding","link":"https:\/\/smartdatamodels.org\/index.php\/category\/coding\/"},"img":{"alt_text":"","src":"https:\/\/i0.wp.com\/smartdatamodels.org\/wp-content\/uploads\/2020\/03\/Smart_Data_Models_square-02.png?resize=350%2C200&ssl=1","width":350,"height":200,"srcset":"https:\/\/i0.wp.com\/smartdatamodels.org\/wp-content\/uploads\/2020\/03\/Smart_Data_Models_square-02.png?resize=350%2C200&ssl=1 1x, https:\/\/i0.wp.com\/smartdatamodels.org\/wp-content\/uploads\/2020\/03\/Smart_Data_Models_square-02.png?resize=525%2C300&ssl=1 1.5x, https:\/\/i0.wp.com\/smartdatamodels.org\/wp-content\/uploads\/2020\/03\/Smart_Data_Models_square-02.png?resize=700%2C400&ssl=1 2x, https:\/\/i0.wp.com\/smartdatamodels.org\/wp-content\/uploads\/2020\/03\/Smart_Data_Models_square-02.png?resize=1050%2C600&ssl=1 3x, https:\/\/i0.wp.com\/smartdatamodels.org\/wp-content\/uploads\/2020\/03\/Smart_Data_Models_square-02.png?resize=1400%2C800&ssl=1 4x"},"classes":[]},{"id":32325,"url":"https:\/\/smartdatamodels.org\/index.php\/besser-smart-data-json-schema-generator\/","url_meta":{"origin":781,"position":5},"title":"BESSER Smart Data JSON Schema Generator","author":"maestro","date":"27\/02\/2026","format":false,"excerpt":"Overview The tool automates the generation of Smart Data Models (SDM) from visual models, bridging the gap between high-level domain design and technical implementation for Digital Twins and IoT ecosystems. Technical Workflow Input: Users define domain entities and relationships using B-UML (a simplified UML dialect) within the BESSER Pearl editor.\u2026","rel":"","context":"In "Cross Sector"","block_context":{"text":"Cross Sector","link":"https:\/\/smartdatamodels.org\/index.php\/category\/cross-sector\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]}],"_links":{"self":[{"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/posts\/781","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/comments?post=781"}],"version-history":[{"count":1,"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/posts\/781\/revisions"}],"predecessor-version":[{"id":782,"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/posts\/781\/revisions\/782"}],"wp:attachment":[{"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/media?parent=781"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/categories?post=781"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/tags?post=781"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}