# Configure automatic object creation

Automatic object creation allows the platform to generate instances of an object class from data received from a data source, without the user having to intervene manually from the project.

<div id="bkmrk-english-italiano" style="display: flex; gap: 8px; margin-bottom: 20px;">[<button id="bkmrk-btn-italiano" style="display: flex; align-items: center; gap: 6px; padding: 6px 14px; border: 1px solid #DEDFE0; border-radius: 6px; cursor: pointer; background: #EFF1F3; color: #333; font-weight: 600; line-height: 1;">![Bandiera italiana](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/flag-italy-1f1ee-1f1f9.png) Italian version ↓</button>](https://wiki.eaglearca.com/link/137#bkmrk-%C2%A0italian-version%C2%A0)</div>---

<span id="bkmrk-italiano-1"> ![jQPeng.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/KKPjqpeng.png) **English version**</span>

Automatic object creation allows the platform to generate instances of an object class from data received from a data source, without the user having to intervene manually from the project.

Automatic object creation is only available for object classes of type **Point** and **Form**. Form classes do not have a coordinates section, so only the attribute values are configured.

<p class="callout info">Available only with **sensors configured in advance**.</p>

---

### Prerequisites

The automatic object creation configuration is accessible from the **Data Sources** tab in the object class creation or editing page, in the **Automatic object creation** section at the bottom of the page.

To unlock this function, the following must be configured in the object class:

- **exactly one** data source
- **at least one** chart

[![automatic object creation section.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/automatic-object-creation-section.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/automatic-object-creation-section.png)

If more than one data source is added, the button to add the automation is disabled. Conversely, if an automation is already configured, the button to add further data sources is disabled.

<p class="callout warning">Modifying the data source associated with the object class will cause the **loss of the entire configuration** of the automatic object creation.</p>

---

### Adding the automation

Click the **+ Add automation** button to open the configuration card.

[![Add automation button.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/add-automation-button.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/add-automation-button.png)

The configuration card is divided into several sections.

#### Projects where automation is active

Shows the projects in which automatic creation is currently enabled. The configuration is carried out in the project configuration page in the Backoffice.

[![Projects where automation is active.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/projects-where-automation-is-active.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/projects-where-automation-is-active.png)

This section is useful when editing the class to have an understanding of where the changes will have an impact.

#### Automation start date

Select the date from which the automation should be active. The selector defaults to today's date, but past or future dates can be selected. If the date is modified, the **reset button** is enabled to return to the current date.

[![automation start date.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/automation-start-date.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/automation-start-date.png)

<p class="callout info">When editing the object class, the selector is read-only if the selected date is in the past or is the current day. If the date is in the future, it can still be modified.</p>

#### Creation coordinates

Available only for object classes of type **Point**.

Defines the coordinates that will be used to position automatically created objects. Values can come from the data source (**Data source**, dynamic) or be entered manually (**Custom**, static). For each coordinate it is mandatory to indicate a **fallback value**, used in case the data source returns a null value.

Using the **2D** and **3D** tabs you can choose whether to create objects in 2D or 3D. Selecting **3D** also displays the **Elevation** field.

[![creation coordinates.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/MdIcreation-coordinates.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/MdIcreation-coordinates.png)

The **fallback value** is used when the data source **returns a null value** in the selected column. It **ensures** that fields **do not remain empty** and data is always complete. For coordinates, the field is always mandatory.

<p class="callout info">If **Custom** is selected for elevation, the fallback value corresponds to the default height at which objects are created in the platform. If this value is modified, the **reset button** is enabled to return to the original value.</p>



#### Attribute values

Defines the values that will be assigned to the attributes of automatically created objects. For each attribute it is possible to choose whether the value should come from the data source (**Data source**, dynamic) or be defined manually (**Custom**, static).

The attributes configurable from this section are: **text**, **numbers**, **true/false**, **value list** and **date**. Other attribute types cannot be pre-filled here.

[![Attribute values.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/attribute-values.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/attribute-values.png)

The mandatory nature of the fields mirrors what is defined in the **Attributes** tab of the object class.

The **fallback value** is used when the data source **returns a null value** in the selected column. It corresponds to the **default value of the attributes** and is only enabled if the attribute is **mandatory**.

---

### Viewing the configuration

The configuration card can be collapsed by clicking outside of it. When filled out, it displays a summary of the main settings: start date, coordinates, and elevation.

[![automatic object creation section collapsed.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/automatic-object-creation-section-collapsed.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/automatic-object-creation-section-collapsed.png)

---

### New attributes

If the **object class is modified** and a **new attribute is added** after the automation was already configured, the attribute to be filled in is indicated by a **label on the card**. Clicking on the card opens it, bringing the new attribute into **focus**, highlighted with a **blue border** for easy identification. The highlight remains visible until the class is saved or the section is changed.

[![new attribute.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/new-attribute.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/new-attribute.png)

---

### Removing the automation

To remove the configuration, click the **Remove automation** button in the top-right corner of the card.

[![remove automation.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/Qpgremove-automation.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/Qpgremove-automation.png)

<p class="callout warning">**Removing** the automation from an object class **does not delete the instances already created automatically**: the class will simply **stop generating new ones**. Objects **already present in the project** will remain **unchanged.**</p>

---

### Links

- *[Create and manage Object Classes](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-object-classes "Create and manage Object Classes")*
- *[Configure Data Sources and Charts](https://wiki.eaglearca.com/books/backoffice/page/configure-data-sources-and-charts "Configure Data Sources and Charts")*

---

<span id="bkmrk-%C2%A0italian-version%C2%A0-1">![flag-italy-1f1ee-1f1f9.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/aiMflag-italy-1f1ee-1f1f9.png) **Italian version** </span>

La creazione automatica degli oggetti consente alla piattaforma di generare istanze di una classe oggetto a partire dai dati ricevuti da una data source, senza che l'utente debba intervenire manualmente dal progetto.

La creazione automatica è disponibile solo per classi oggetto di tipo **Punto** e **Form**. Le classi di tipo Form non hanno la sezione coordinate, quindi viene configurata solo la compilazione degli attributi.

<p class="callout info">Disponibile solo con **sensori configurati in precedenza**.</p>

---

### Prerequisiti

La configurazione della creazione automatica è accessibile dalla tab **Data Sources** nella pagina di creazione o modifica di una classe oggetto, nella sezione **Creazione automatica oggetti** in fondo alla pagina.

Per sbloccare questa funzione è necessario che nella classe oggetto siano configurati:

- **esattamente una** data source
- **almeno** **un** grafico

[![automatic object creation section.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/automatic-object-creation-section.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/automatic-object-creation-section.png)

Se viene aggiunta più di una data source, il pulsante per aggiungere l'automazione si disabilita. Al contrario, se è già configurata un'automazione, il pulsante per aggiungere ulteriori data source si disabilita.

<p class="callout warning">Modificare la data source associata alla classe oggetto comporta la **perdita di tutta la configurazione** della creazione automatica degli oggetti.</p>

---

### Aggiungere l'automazione

Clicca sul pulsante **+ Aggiungi automazione** per aprire la scheda di configurazione.

[![Add automation button.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/add-automation-button.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/add-automation-button.png)

La scheda di configurazione è suddivisa in diverse sezioni.

#### Progetti dove l'automazione è attiva

Mostra i progetti in cui la creazione automatica è attualmente abilitata. La configurazione viene effettuata nella pagina di configurazione dei progetti nel Backoffice.

[![Projects where automation is active.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/projects-where-automation-is-active.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/projects-where-automation-is-active.png)

Questa sezione è utile in fase di modifica della classe per avere consapevolezza di dove le modifiche andranno a impattare.

#### Data di avvio automazione

Seleziona la data a partire dalla quale l'automazione deve essere attiva. Il selettore ha come valore predefinito la data odierna, ma è possibile selezionare date passate o future. Se la data viene modificata si abilita il **pulsante** **di reset** per tornare alla data corrente.

[![automation start date.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/automation-start-date.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/automation-start-date.png)

<p class="callout info">In modifica della classe oggetto il selettore è in sola visualizzazione se la data selezionata è passata o è il giorno corrente. Se la data è futura può ancora essere modificata.</p>

#### Coordinate di creazione

Disponibili solo per classi oggetto di tipo **Punto**.

Definisce le coordinate che verranno utilizzate per posizionare gli oggetti creati automaticamente. I valori possono provenire dalla data source (**Data source**, dinamico) oppure essere inseriti manualmente (**Personalizzato**, statico). Per ogni coordinata è obbligatorio indicare un **valore di fallback**, utilizzato nel caso in cui la data source restituisca un valore nullo.

Tramite le schede **2D** e **3D** è possibile scegliere se creare gli oggetti in 2D o in 3D. Selezionando **3D** viene visualizzato anche il campo **Elevazione**.

[![creation coordinates.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/MdIcreation-coordinates.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/MdIcreation-coordinates.png)

Il **valore di fallback** viene utilizzato quando la data source **restituisce un valore nullo** nella colonna selezionata. Serve a **garantire** che i campi **non rimangano vuoti** e i dati siano sempre completi. Per le coordinate il campo è sempre obbligatorio

<p class="callout info">Se per l'elevazione viene selezionato **Personalizzato**, il valore di fallback corrisponde all'altezza predefinita con cui gli oggetti vengono creati nella piattaforma. Se questo valore viene modificato si abilita il **pulsante di reset** per tornare al valore originale.</p>



#### Valori degli attributi

Definisce i valori che verranno assegnati agli attributi degli oggetti creati automaticamente. Per ogni attributo è possibile scegliere se il valore deve provenire dalla data source (**Data source**, dinamico) oppure essere definito manualmente (**Personalizzato**, statico).

Gli attributi configurabili da questa sezione sono: **testo**, **numeri**, **vero/falso**, **lista valori** e **data**. Gli altri tipi di attributo non sono precompilabili da qui.

[![Attribute values.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/attribute-values.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/attribute-values.png)

L'obbligatorietà della compilazione rispecchia quella definita nella tab **Attributi** della classe oggetto.

Il **valore di fallback** viene utilizzato quando la data source **restituisce un valore nullo** nella colonna selezionata. Corrisponde al valore di **default degli attributi** ed è abilitato solo se l'attributo è **obbligatorio**.

---

### Visualizzare la configurazione

La scheda di configurazione può essere collassata cliccando al di fuori di essa. Se compilata mostra un riepilogo delle impostazioni principali: data di avvio, coordinate ed elevazione.

[![automatic object creation section collapsed.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/automatic-object-creation-section-collapsed.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/automatic-object-creation-section-collapsed.png)

---

### Nuovi attributi

Se la **classe oggetto viene modificata** e viene **aggiunto un nuovo attributo** dopo che l'automazione era già configurata, l'attributo da compilare viene segnalato tramite un'**etichetta sulla scheda**. Cliccando sulla scheda questa si apre mettendo **in evidenza** il nuovo attributo, evidenziato con un **bordo blu** per facilitarne l'individuazione. L'evidenziazione rimane visibile fino al salvataggio della classe o al cambio di sezione.

[![new attribute.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/new-attribute.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/new-attribute.png)

---

### Rimuovere l'automazione

Per rimuovere la configurazione clicca sul pulsante **Rimuovi automazione** in alto a destra della scheda.

[![remove automation.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/Qpgremove-automation.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/Qpgremove-automation.png)

<p class="callout warning">**Rimuovere** l’automazione da una classe oggetto **non elimina le istanze già create automaticamente**: la classe smetterà semplicemente di **generarne di nuove**. Gli oggetti **già presenti nel progetto** resteranno **invariati**.</p>

---

### Collegamenti

- *[Creare e gestire le Classi Oggetto](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-object-classes "Create and manage Object Classes")*
- *[Configurare Data Source e Grafici](https://wiki.eaglearca.com/books/backoffice/page/configure-data-sources-and-charts "Configure Data Sources and Charts")*

---

***Last update:** 25 May 2026*