Quickstart Guide
This quick start guide will assist you in getting started with Datome, creating models, assets, and links between two models.
Step 1: Log In to Your Datome Application
You can sign up for a free 30-day trial account at the bottom of our website. During the registration process, you will generate a custom URL for your organization (i.e. https://[your_organization].datome.io).
The custom URL you create will be the URL to be used for logging in.
Step 2: Create Models
At your first login, you’ll be taken to a wizard showing you the creation of two exemplary Models. Think of a Model as the blueprint for the rules and specifications of the Assets you want to track. An Asset can be a process, a digital object or a physical one.
The following steps will guide you to create two additional models that can later be linked.
Model 1 - Linen
Select the Models dropdown button.
Click + new model button.
Enter the Model’s name and properties or clone an existing model. In this example, we have specified the model’s name and properties as shown below:
Click Save.
Model 2 - Denim
Select the Models dropdown button.
Click + new model button.
Enter the Model’s name and properties. In this example, we have specified the model’s name and properties as shown below:
A "relation" keyword is used and defined for Model 1 so that Model 2 and Model 1 can have a one-to-one relation.
Click Save.
Step 3: Create Assets
After successfully creating two models, you need to create an asset for each so that the models will have a one-to-one relation. Follow the steps below to create assets:
Model 1
Select the Assets Search dropdown button.
Click the newly created model Linen.
Click the + Add new asset button.
Specify the required model properties as shown in the image below.
Click Save.
Model 2
Select the Assets Search dropdown button.
Click the newly created model Denim.
Click the + Add new asset button.
Specify the required model properties as shown in the image below.
Note: As you can see in the image above, we can select Model 1’s asset that has just been created in the relation keyword.
Click Save.
Step 4: View the Model Relation
You can see the Model’s relation with each other by clicking the Relations button on the main navigation menu.
The Entity Relation-Diagram between the models, can be seen in the relations window.
Step 5: Expanding the Features of Your Models
The Models we created above have no states (what you typically want to have to manage a process), no validation rules, nor authorized users. Check out the Writing a Model section to learn about all the features you can add.
The Datome UI, for the moment, only has a no-code tool for adding “properties” to a Model, but much more can be added using the JSON editor. You can also create and edit your models via Postman. Check the Swagger to learn how to get a Bearer token via a login and how to call a Model endpoint.
After you come to a version of your Model(s) that you’re happy with, you can create credentials for other users and have them create Assets. Users shall log in to your environment through your organization's custom URL. Alternatively, your users can create, edit, and read Assets via APIs. Users can be individuals, applications or IoTs.
Never hesitate to ask for support via our discord channel or writing to support@datome.io
Last updated
