{"id":909,"date":"2020-12-02T00:13:03","date_gmt":"2020-12-02T00:13:03","guid":{"rendered":"https:\/\/smartdatamodels.org\/?page_id=909"},"modified":"2020-12-02T00:13:53","modified_gmt":"2020-12-02T00:13:53","slug":"create-automatically-the-specification-of-your-data-model","status":"publish","type":"page","link":"https:\/\/smartdatamodels.org\/index.php\/create-automatically-the-specification-of-your-data-model\/","title":{"rendered":"Create automatically the specification of your data model"},"content":{"rendered":"<p>The new version of the smart data models specification is on progress (most of the \/doc directories of the data models have a version). If you want to check how this would look like you can have through this API call<\/p>\n<p><strong>Call: https:\/\/smartdatamodels.org\/extra\/create_spec.php<\/strong><\/p>\n<p><strong>Parameters<\/strong>: (Mandatories)<\/p>\n<ul>\n<li>dataModel: The name of the entity for the specification<\/li>\n<li>schemaUrl: The link to the <strong>RAW<\/strong> version of the json schema (see example)<\/li>\n<li>examplesUrl: the url of where the 4 examples required for a data model are available (named<\/li>\n<li>notesUrl: The url to the yaml for the customization paragraphs (<em>notesHeader<\/em>, after the title, <em>notesMiddle<\/em>, after properties&#8217; list and <em>notesFooter<\/em> by the end)<\/li>\n<li>mail:\u00a0 a valid mail of yours<\/li>\n<\/ul>\n<p>Example: <a href=\"https:\/\/smartdatamodels.org\/extra\/create_spec.php?dataModel=Airport&amp;schemaUrl=https:\/\/raw.githubusercontent.com\/smart-data-models\/incubated\/master\/Aeronautics\/Airport\/schema.json&amp;examplesUrl=https:\/\/raw.githubusercontent.com\/smart-data-models\/incubated\/master\/Aeronautics\/Airport\/examples\/&amp;notesUrl=%22%22&amp;mail=alberto.abella@fiware.org\">https:\/\/smartdatamodels.org\/extra\/create_spec.php?dataModel=Airport&amp;schemaUrl=https:\/\/raw.githubusercontent.com\/smart-data-models\/incubated\/master\/Aeronautics\/Airport\/schema.json&amp;examplesUrl=https:\/\/raw.githubusercontent.com\/smart-data-models\/incubated\/master\/Aeronautics\/Airport\/examples\/&amp;notesUrl=%22%22&amp;mail=alberto.abella@fiware.org<\/a><\/p>\n<p><strong>Output<\/strong>: A markdown text that although the HTML visualization is faulty, the source code of the page can be pasted in any markdown viewer (optimized for github) and you see will see something like <a href=\"https:\/\/github.com\/smart-data-models\/dataModel.Energy\/blob\/master\/ThreePhaseAcMeasurement\/doc\/new_spec_EN-US.md\">this<\/a>.<\/p>\n<p>We are on the transition to having all the data models compliant.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>The new version of the smart data models specification is on progress (most of the \/doc directories of the data models have a version). If you want to check how this would look like you can have through this API call Call: https:\/\/smartdatamodels.org\/extra\/create_spec.php Parameters: (Mandatories) dataModel: The name of the&#8230; <a class=\"continue-reading-link\" href=\"https:\/\/smartdatamodels.org\/index.php\/create-automatically-the-specification-of-your-data-model\/\">More&#8230;<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"class_list":["post-909","page","type-page","status-publish","hentry"],"jetpack_sharing_enabled":true,"jetpack-related-posts":[{"id":925,"url":"https:\/\/smartdatamodels.org\/index.php\/create-a-draft-spec-of-your-data-model\/","url_meta":{"origin":909,"position":0},"title":"Create a draft spec of your data model","author":"maestro","date":"04\/12\/2020","format":false,"excerpt":"In order to create an example of the data model that you are going to contribute this call helps you to create a spec. this is the API call If you want to check how this would look like you can have through this API call Call: https:\/\/smartdatamodels.org\/extra\/create_spec.php Parameters: (Mandatories)\u2026","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":9159,"url":"https:\/\/smartdatamodels.org\/index.php\/orion-ld-broker-with-examples-of-some-smart-data-models\/","url_meta":{"origin":909,"position":1},"title":"Orion-LD broker with examples of some smart data models","author":"maestro","date":"05\/07\/2023","format":false,"excerpt":"In this address https:\/\/smartdatamodels:1026 there is an Orion-LD Broker installed open for testing purposes. It is wiped out every hour, on minute 27, and then repopulated with some hundreds of examples (most of the current examples in data models). Therefore you can use it just for some testing. Some examples\u2026","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":126,"url":"https:\/\/smartdatamodels.org\/index.php\/coding-data-models\/","url_meta":{"origin":909,"position":2},"title":"Check the whole data model repository","author":"maestro","date":"17\/03\/2020","format":false,"excerpt":"The data models are composed of: Manually contributed Json schema describing the technical properties of the model and their descriptions Some examples in JSON and JSON-LD (example.json, example.jsonld, example-normalized.json and example-normalized.json) Optional Manually contributed: The authors (CONTRIBUTORS.yaml) Manually contributed: Current adopters of the data model (ADOPTERS.yaml) Manually contributed: Customization of\u2026","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":255,"url":"https:\/\/smartdatamodels.org\/index.php\/how-to-use-data-models\/","url_meta":{"origin":909,"position":3},"title":"How to use data models","author":"maestro","date":"03\/04\/2020","format":false,"excerpt":"Simple user: Use the csv (comma separated values) like this table, a csv is available in every data model and its specification and explanation in the \/doc\/spec.md that explains the meaning of the fields id type address__addressLocality address__addressCountry atmosphericPressure dataProvider dateObserved location__coordinates precipitation pressureTendency relativeHumidity source stationCode stationName temperature windDirection\u2026","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":10260,"url":"https:\/\/smartdatamodels.org\/index.php\/metadata-of-the-data-models-catalog-available\/","url_meta":{"origin":909,"position":4},"title":"Metadata of the data models catalog available","author":"maestro","date":"01\/02\/2024","format":false,"excerpt":"In this link you have all metadata of the catalogue available as a json file. It includes: subject data model version of the data model modelTags title url to $id of the schema description of the data model required attributes yamlUrl link to the yaml version of the schema jsonSchemaUrl\u2026","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":1829,"url":"https:\/\/smartdatamodels.org\/index.php\/generate-a-ngsi-ld-payload-based-on-a-smart-data-model\/","url_meta":{"origin":909,"position":5},"title":"Generate a NGSI-LD normalized payload based on a Smart Data Model","author":"maestro","date":"02\/03\/2021","format":false,"excerpt":"This is an alpha version (so you can expect errors and not being complete). Use it at your own risk. Please report them at info@smartdatamodels.org Call: https:\/\/smartdatamodels.org\/extra\/ngsi-ld_generator.php Parameters: (Mandatories) schemaUrl: The link to the RAW version of the json schema (see example) email: your email Example: https:\/\/smartdatamodels.org\/extra\/ngsi-ld_generator.php?schemaUrl=https:\/\/raw.githubusercontent.com\/smart-data-models\/dataModel.Streetlighting\/f56f5a7933ab05d7fce1d5adc0847f25a099cdb4\/StreetlightModel\/schema.json&email=alberto.abella@fiware.org Use any data\u2026","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]}],"_links":{"self":[{"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/pages\/909","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/types\/page"}],"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=909"}],"version-history":[{"count":2,"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/pages\/909\/revisions"}],"predecessor-version":[{"id":911,"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/pages\/909\/revisions\/911"}],"wp:attachment":[{"href":"https:\/\/smartdatamodels.org\/index.php\/wp-json\/wp\/v2\/media?parent=909"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}