# Quickstart Guide

This quick start guide will assist you in getting started with Datome, creating models, assets, and links between two models.

<figure><img src="https://1579942651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgeEfNxZDCoeNsPoWTAr6%2Fuploads%2FhhMjF2qDZ5ux4G9Fq0Zi%2F1-4steps-8b33c042d9a59f57cc420432aababdc3.png?alt=media&#x26;token=32c76df4-21c7-4fa3-acc5-6ab8b109c654" alt=""><figcaption></figcaption></figure>

### 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](https://www.datome.io/). During the registration process, you will generate a custom URL for your organization (i.e. https\://\[your\_organization].datome.io).

{% hint style="info" %}
The custom URL you create will be the URL to be used for logging in.
{% endhint %}

### 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

1. Select the **Models** dropdown button.
2. Click + **new model** button.<br>

   <figure><img src="https://1579942651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgeEfNxZDCoeNsPoWTAr6%2Fuploads%2FwPngA6Zh3ubuXNFGozGX%2F2-model_creation-2395021febe7e678a27585cef3dc50b0%20(1).png?alt=media&#x26;token=f20d763b-4d0f-4bab-9647-1925c7fdbe9a" alt=""><figcaption></figcaption></figure>
3. 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:<br>

   <figure><img src="https://1579942651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgeEfNxZDCoeNsPoWTAr6%2Fuploads%2F5F8tI74zQChDVDGwvIWq%2F3-model1-7e5058bae3a93b62c1ce759959466f7e.png?alt=media&#x26;token=412760a6-4fe8-4aa7-aebc-0a76eb0ce8b1" alt=""><figcaption></figcaption></figure>
4. Click **Save**.<br>

   <figure><img src="https://1579942651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgeEfNxZDCoeNsPoWTAr6%2Fuploads%2FqK26KhH4W6hzNhdEsMUa%2F4-model1-550070d1c16cf92b5c7c10b340fdb643.png?alt=media&#x26;token=b9e8886d-b7d7-468a-baf5-56c234fd5cab" alt=""><figcaption></figcaption></figure>

#### Model 2 - Denim

1. Select the **Models** dropdown button.
2. Click + **new model** button.<br>

   <figure><img src="https://1579942651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgeEfNxZDCoeNsPoWTAr6%2Fuploads%2FhYZov8u3XWYraRNj0aC4%2F2-model_creation-2395021febe7e678a27585cef3dc50b0.png?alt=media&#x26;token=248bf815-13d6-4ff2-8a47-d99cedb8eb13" alt=""><figcaption></figcaption></figure>
3. Enter the Model’s **name** and **properties**. In this example, we have specified the model’s name and properties as shown below:<br>

   <figure><img src="https://1579942651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgeEfNxZDCoeNsPoWTAr6%2Fuploads%2FGBD5NubEAU5SjhBChEtX%2F5-model2-53845a7a05ef0f11bce048205c50fdd2.png?alt=media&#x26;token=f43dbc25-2cb6-4cf3-8bbe-61fcab392675" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
A "**relation"** keyword is used and defined for Model 1 so that Model 2 and Model 1 can have a one-to-one relation.
{% endhint %}

4. Click **Save**.<br>

   <figure><img src="https://1579942651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgeEfNxZDCoeNsPoWTAr6%2Fuploads%2FDxgIQMRXgrbtGYt09Tu3%2F6-model2-12d27a92e9978a3e71f20704858b0f05.png?alt=media&#x26;token=02bcc160-6f89-49eb-8124-d78bb19116cc" alt=""><figcaption></figcaption></figure>

### 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

1. Select the **Assets** **Search** dropdown button.
2. Click the newly created model **Linen**.<br>

   <figure><img src="https://1579942651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgeEfNxZDCoeNsPoWTAr6%2Fuploads%2FWL5VsslOM8IFT3B6bTA7%2F7-asset_linen-58da7e9699629215b687ea513f65fb80.png?alt=media&#x26;token=b605d43c-541e-4f8b-922d-fe62e76d7aed" alt=""><figcaption></figcaption></figure>
3. Click the + **Add new asset** button.<br>

   <figure><img src="https://1579942651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgeEfNxZDCoeNsPoWTAr6%2Fuploads%2FQLNbXKp5F8kc8GhhLv3C%2F8-create_asset-16cc438f20c361a7fc5c11c60a441cbf%20(1).png?alt=media&#x26;token=3798ec5a-ccba-4be5-af2f-cb6d81549f14" alt=""><figcaption></figcaption></figure>
4. Specify the required model **properties** as shown in the image below.<br>

   <figure><img src="https://1579942651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgeEfNxZDCoeNsPoWTAr6%2Fuploads%2F5irFLfAENdHVm9A3UMFT%2F9-asset_linen_prop-452e130bc5cfaf360e01d4e9f9eef28a.png?alt=media&#x26;token=b3ea6fea-c838-492b-ac57-35453dc04ec2" alt=""><figcaption></figcaption></figure>
5. Click **Save**.<br>

   <figure><img src="https://1579942651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgeEfNxZDCoeNsPoWTAr6%2Fuploads%2F7lxgvIy83mm8onRjPWsu%2F9-asset_linen-2299ab8af06e338fbd44af193e44bc85.png?alt=media&#x26;token=40e415ff-e267-4a88-aae8-b666d9745ab6" alt=""><figcaption></figcaption></figure>

#### Model 2

1. Select the **Assets** **Search** dropdown button.
2. Click the newly created model **Denim**.<br>

   <figure><img src="https://1579942651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgeEfNxZDCoeNsPoWTAr6%2Fuploads%2FacStozJ1XZCtT8Zya8wf%2F10-asset_denim-e6921dc9c92a290acd80be9840a4a631.png?alt=media&#x26;token=fdc83389-c25c-4df8-9226-d9b16152b5e0" alt=""><figcaption></figcaption></figure>
3. Click the + **Add new asset** button.<br>

   <figure><img src="https://1579942651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgeEfNxZDCoeNsPoWTAr6%2Fuploads%2FCvr2U0zQj7DSEjdFT7M0%2F8-create_asset-16cc438f20c361a7fc5c11c60a441cbf.png?alt=media&#x26;token=424bb4a1-0b2f-425d-a13b-16f4d107d169" alt=""><figcaption></figcaption></figure>
4. Specify the required model **properties** as shown in the image below.<br>

   <figure><img src="https://1579942651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgeEfNxZDCoeNsPoWTAr6%2Fuploads%2FI9Cv5zQ5pz4XBkgPqDWM%2F11-asset_denim-03205edcf63418f3f0f164b3d2b15079.png?alt=media&#x26;token=0531e0bd-bb31-4cd6-8271-3afc1a7727f7" alt=""><figcaption></figcaption></figure>

> **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.

5. Click **Save**.<br>

   <figure><img src="https://1579942651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgeEfNxZDCoeNsPoWTAr6%2Fuploads%2Fg08upGYVDrkRsjWt3Euh%2F12-asset_denim-8ad3fc3a4fe153eca88e746237c006cc.png?alt=media&#x26;token=87d1ef98-597e-48f0-ad41-cc9b1537051b" alt=""><figcaption></figcaption></figure>

### 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.

<figure><img src="https://1579942651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgeEfNxZDCoeNsPoWTAr6%2Fuploads%2FShq8DYpu8QH5YhKQKqGB%2F13-relations-696eb203845b6a7909281ac7cdd31c52.png?alt=media&#x26;token=c69f8cfd-ff08-47e5-90dc-023be19409c2" alt=""><figcaption></figcaption></figure>

The **Entity Relation-Diagram** between the models, can be seen in the relations window.

<figure><img src="https://1579942651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgeEfNxZDCoeNsPoWTAr6%2Fuploads%2F9z56iYvdEmkANaF436tV%2F14-relations-bc469b8b3d8a5adfd12aadf38e90d425.png?alt=media&#x26;token=4c2fb56f-0ff7-48a1-924a-a6b1fcbb8815" alt=""><figcaption></figcaption></figure>

### 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](https://doc.datome.io/writing-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](https://discord.com/invite/AT8DJJKFNw) channel or writing to <support@datome.io>
