> For the complete documentation index, see [llms.txt](https://docs.eximee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.eximee.com/documentation/documentation-en/budowanie-aplikacji/model-danych/edycja-modelu-danych.md). # Editing the data model ## Data model editor To go to the data model editor, select "Data model" on the application's main screen in Eximee Designer

Figure 1. "Data model" tab of the low-code application

The data model editor is divided into three tabs: * *Structure,* where we manage the model structure and fill in node parameters, * *Data sources*, where we define and parameterize data sources, * *Source*, where we edit JSON, which is the source representation of the model - functionality for advanced users. {% hint style="info" %} If your application does not yet have a data model, you can create one by clicking the "Initialize data model" button. {% endhint %} ## Structure The data model structure is presented as a tree in the left panel of the editor. The tree branches can be collapsed and expanded.

Figure 2. Presentation of the data model structure

Selecting a tree node automatically filters the nodes in the list on the right.

Figure 3. Selecting a node in the data model editor

At the top of the node list, the key constituting the current view filter is displayed: *"client.surname"* in this case. ## Parameterization of model elements ### Node

Figure 3. Editing a model node

In the model node editing section, you can edit the key and documentation (*"description"*) of the object. You can also mark the object as an array. {% hint style="info" %} Next to the object's key there is a button that copies the key to the system clipboard. {% endhint %} The context menu contains an option to delete the node together with its descendants. To add a field to a node, click the button *"Add field"*. ### Field The field section in the data model also provides the ability to specify a default value for the field.

Figure 4. Field in the model

### Data source Clicking the data source chip or the pencil icon next to it opens a drawer with a list of data sources and the ability to edit the use (source order, source parameters, value mapping).

Figure 5. Use of data source

By default, for each **leaf** of the data model tree (that is, fields that do not have any further sub-fields), the platform automatically adds a special data source of type **ValueMap**. This is a built-in source that stores the field value in the application's memory structure (the so-called application value map) - this can be treated as an equivalent of a session variable storing data in the context of the entire application (form). The default ValueMap mapping uses the full path of the field's keys as the key in this internal map (e.g. for the field `country` located inside the object `personalData` the key in the value map will be `personalData.country` ). This means that after binding form fields to the model, **no additional code is required to save the entered data** - the value entered by the user will be automatically placed under the appropriate key in the model's memory. #### Data source - defensive logic and empty values Data model sources cannot assume a deterministic call order or that all input data is already available. The platform may call a source earlier (e.g. when determining the multiplicity of dynamic sections of a form or model), even if that data field is not yet used directly in the form or process. Therefore, data sources must be designed defensively: in the absence of data, incomplete data, or data that is "not yet ready", they should return safe, empty values (null, an empty list, an empty object) and not raise exceptions. An empty value means: at this stage I cannot determine the value and it allows subsequent sources in the cascade to take effect, in particular default sources (e.g. ValueMap or default values on the field definition). Exceptions should be reserved only for actual technical errors (e.g. communication errors or invalid configuration) that should interrupt the operation of the system (form interruption, process transaction rollback, etc.), and not for transient process states. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.eximee.com/documentation/documentation-en/budowanie-aplikacji/model-danych/edycja-modelu-danych.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.