A datamodel is a template on what data attributes you would like to structure within a specific document type. A document type is for example a product, component, batch and so on.
A document can have a lot of attributes, the data model dictates what attributes should be shown. You can always access all the data in the "Data" tab next to the "overview" tab on all documents.
How to create a data model
Go to the tab "Data" on the left.
Go to the tab "Datamodels" under the settings category.
Press "Add Data Model" in the top right.
Give et a name. The name of a data model could be for example "EUDR" if this should be a template for collection data for compliance with EUDR. Could also be a template for electronic devices, that need specific attributes
Chose the document type.
Chose attributes you want to be a component of the data model.
If Want to activate the attributes on the document. Press on the slider "Always show" for each attribute or for all attributes use the slider ind the top.
Press save.
How to attach a data model directly via the upload?
When uploading products (and components), you can attach a data model directly via the Excel/CSV upload. This is especially useful if you are uploading large quantities at a time and want to attach different data models to the uploaded products. To attach it via upload you will need to:
Your data model needs to exist before the upload.
In a column - add the names of the data models you want to attach to each product, on the line of each respective product.
Map the column you've created with the data model names, to the attribute called "Data model" when uploading.
Domain models
Besides the master data model — the primary data model for a document type — you can also create domain models. A domain model is a specific data model that covers a particular domain, such as a legislation (e.g. EUDR, REACH) or a category like packaging.
For example, for packaging you could have:
A master data model covering the things that don't differ from packaging to packaging, such as weight, identifier, and name.
A plastic-specific domain model, attached only to plastic packaging, containing attributes relevant to that domain — for example design criteria related to Extended Producer Responsibility (EPR) requirements.
This allows you to combine data models on the same document type, giving a clearer view of the data that's actually relevant to a given document. It also keeps your data overview clean, since you avoid adding attributes that aren't relevant for a given document type or product.
Domain models are created the same way as master data models, following the same logic described above, and you can also set a domain model as the default for a document type if needed.
How to attach a domain model to a master data model
Go to the master data model you want to attach a domain model to.
Use the option to attach a domain model to it.
Once attached, every product or document using this master data model will also have the domain model applied as a filter — and, where set up with business rules, this can happen automatically. For example, if a document is flagged as plastic, the system can automatically attach the plastic domain model.
How to show or hide empty attributes
When managing a data model — whether a domain model or a master data model — you can choose whether attributes should:
Always be shown, or
Only be shown when they contain data.
If hidden, an attribute will not be shown on the document until data has been mapped to it. You can always show hidden attributes for a specific document or product from the left-hand menu, where you can toggle to show or hide empty attributes.
Per-attribute rules for enrichment links
When creating a data model, you can also set a per-attribute rule set, which controls how attributes behave in an enrichment link.
These rules only affect enrichment links. For example, if you set an attribute's per-attribute rule to Read only and include that attribute in an enrichment link, the attribute will appear as read-only to the recipient of the link. This lets you display data — such as instructions or a file with delivery guidelines — in an enrichment link without allowing the recipient to edit it.
These rules can also be edited individually on each enrichment link.
How to change what data model a product uses
Go to the specific product. In the overview tab, find the field "Data model". This opens a pop up where you can choose the data model you want to use.
How to set a default datamodel for all
In "Data models" page, find the column called "Default". If you press on the slider, it will add this data model to all of your existing documents of a specific type, except for those documents that already have a data model, and dont worry you will keep the existing attributes on the product, they will not be overwritten.
How to view the completeness of a data model?
Find the preferred document for example products. In the column "Completeness" you can se the completeness score of each product. Based on the data model applied to that product.
Which data points cannot be added to a data model?
You can basically add all data points to a data model, however, there are a few exceptions with the following:
Name. The name is not a data point and must be changed by clicking the three buttons next to the name. Can also be updated via excel upload.
Supplier. A supplier link is made on the overview page and is not in a data point.
Relations in general. All relations between documents (products, components, packaging, etc.) are made on the overview page and are not in a data point.