› System data › Data models › Create a global data model using JSON

Create a global data model using JSON

You can create a data model model using a sample JSON. On providing a JSON file, the JSON format is parsed and a tree structure is created automatically. The global data model can be used across processes, cases, rules, custom services, and forms.

  1. Navigate to System data > Data models.

    The Data models page appears.

  2. Click New.

    The new data model appears in a tree form under the Design tab and opens in a new browser tab.

  3. You can change the default name and provide a meaningful and unique name for the data model.
  4. Optional. Provide a Description for the data model.
  5. By default, the data model is placed in your default working category. To place it in a different category, on the Category list, select a category.
  6. To add a JSON file, click Load from external source.

    The Load from external dialog box is displayed.

  7. On the Type list, select JSON expression. (Default: JSON expression)
  8. Browse the file or drag the JSON file into the File box.

    You can also paste the sample JSON format in the File content box.

    Once you add the files, the file preview is displayed in the File content box. You can edit the file if required.

  9. Click Add.

    The JSON file is parsed and the fields are displayed in the tree structure in the canvas. You can change or rename the field properties or delete them from the tree.

    • The field names support these special characters (!@#$%^&*()_+-={}|:"<>?,./;'[]\).

    • If the JSON file cannot be parsed, an error message is displayed.

    • You can only use the first instance of an object in an array to generate the corresponding data model types.

    • If the JSON is a list you cannot return it into the data object you created, but must instead map to the list field within the JSON that has been created.

    • When you define a tree structure for the data model, but provide a different JSON sample, a warning message is displayed that the existing model will be overwritten. You must confirm if you want to continue; this action cannot be undone.

  10. Save or release the data model.

    The new data model appears on the Data models list page.