Updated interactive specification

Now all data models have an interactive specification. (As long as they have examples)
This is the first step to deeper interactive services for every data model contributed.
See the example for weatherForecast.

First Survey to users and contributors of Smart Data Models

    Q1: What elements of a smart data model are useful for you?

    Examples of the options:
    1.-Json Schema
    2.-Examples
    3.-Specification
    Mark those relevant for you


    Optional. Other element useful. (Available or desired)

    Q2: What services do you use?

    1.- Search data models
    2.- Validation of payload
    3.-Validate schema before contribution
    4.-Generate a NGSI-LD payload out of a schema
    Search data modelsValidation of payloadValidate of json schema before contributionGenerate a NGSI-LD payload out of a schema
    Optional. Other services missing. (Available or desired)

    Membership

    Member of FIWARE FoundationMember of TMForumMember of IUDXNo membership

    Include userAlias in common-schema.json

    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 this code

    “userAlias”: {
    “$ref” : “https://smart-data-models.github.io/data-models/common-schema.json#/definitions/userAlias”
    }

    Updated the contribution manual

    This a general review of the contributions’ manual with these changes:

    • Recommendation how to document a property that is an object referencing to a shared schema
    • Change order in the elements (schema recommendation is the most demanded documentation and it is being placed at the beginning)
    • Minor reviews, contact point, etc.

    Located in the upper menu of the site.

    Update the database for searching properties and descriptions

    It has been updated the database for searching properties, two main improvements:

    1.  Performance (now it is a database query instead of the former static file)
    2.  The reference model of the property
    3.  The format (uri, date-time, etc) for string properties.

     

    Alpha version of the service for generating an NGSI-LD payload based on a Smart Data Model

    This is an alpha version (so you can expect errors and not being complete). Use it at your own risk. Please report errors and suggestions 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 model from Smart Data Models initiative and paste it into the form. Then you’ll get a page with a random payload compliant with the data model. Refresh for more.

    You can also use this form

      This form generates a NGSI-LD payload compliant with a json schema from Smart Data Models.


      Email


      By using this form you agree with the storage and handling of your data by this website.


      After clicking it will appear a message confirming the submission

      It will take a while to redirect to the feedback on a specific page

      Thanks for being patient

      Script for checking a data model submission

      In the directory utils of the umbrella repository data-models there is a new python script that checks if a schema is properly documented and if the payload is correctly located and validates against the schema.

      New option for drafting a data model

      In the front page, there is a new option that allows you top to directly create a copy of the template sheet for creating new data models.

      Remember that this spreadsheet is done for those unfamiliar with json schema (the official format for the smart data models) to allow them to create a new data model from their knowlege.

      The use instructions are in the spreadsheet

      Any doubt please let us know at info@smartdatamodels.org

       

      Updated context.jsonld

      The context.jsonld for smart data models has been updated to meet json ld requirements. Now they are implementing geojson requirements.
      It affects the terms of bbox and coordinates. It could impact those elements having a geoproperty (most of the data models).

      Create your data model with a google spreadsheet

      This is a resource especially for those who have limited knowledge of JSON schema.

      If you want to create a basic version of a data model (not all JSON schema is implemented), you can use a copy of this spreadsheet as template. This spreadsheet is always available at https://bit.ly/schema_sheet short name.

      You need to fill the blue cells for these parameters:

      • Subject: Official Subject where this data model should be allocated. (Check the official list)
      • DataModel: Official data model name (Only one word i.e. WeatherForecast, no _).
      • Title: use to be the name data model name with spaces. (i.e. Weather Forecast)
      • Global Description: General text description of the data model. (2 lines is nice)
      • Property name: Exactly this, the name of the property. Use camelCase. It would be good to check here whether this property already exists (you can copy and paste). Use those you need and leave one empty after those you filled. Properties below an empty property name are ignored.
      • NGSI type: (Property, Relationship or Geoproperty)
      • Data type: Type of data in the property. (array and object are not fully implemented)
      • Other restrictions: If you are unfamiliar with JSON schema leave it empty.
      • Description: Official description of the property.

      Once you’ve got the schema, grab some examples (It is always good to review the contribution manual) and you can make a Pull Request on any of the subjects of any domain in Github. Or just use this form.

      NOTE 1: The first option will be attended quicker than the second.

      NOTE 2: Do not write out of the blue cells (it will be ignored). And do not add or remove cells. The converter script looks for these precise locations in blue.

      NOTE 3: Your spreadsheet has to be made public. (anyone with the link), otherwise, the script will not be able to retrieve your data.

      Call:

      Parameters: (Mandatories)

       

      Output: A json schema based on the properties defined in the database. This is an alpha version so errors are not managed.

        This form generates a json schema based on the properties of a google sheet (Based on this template)
         


        By using this form you agree with the storage and handling of your data by this website.


        After clicking it will appear a message confirming the submission

        It will take a while to redirect to the feedback on a specific page

        Thanks for being patient