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. When needed, the objects already created can also be kept up to date with the readings that follow, without generating duplicates.

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.

Available only with sensors configured in advance.


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:

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.

Modifying the data source associated with the object class will cause the loss of the entire configuration of the automatic object creation.


Adding the automation

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

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

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

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.

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 when the object is created if 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

The fallback value is used when the object is created, if 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.

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.

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

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 object is created, if 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.

Keep existing objects updated

By default, each new reading from the data source creates a new object. In the Keep existing objects updated block, at the bottom of the card, you can choose to have a reading that refers to an existing object update it instead of creating another one. Two independent switches control what gets updated:

You can turn on one switch or both. Automatic creation keeps working either way: a reading that refers to a new object creates it, a reading that refers to an existing object updates it.

pannello aggiornamento automatico.png

While a switch is on, the card reminds you that turning it off stops the updates for existing objects. Turning a switch off does not delete or change the objects: each one keeps the last position or values received. You can turn the switches on and off freely, also when editing the class, regardless of the objects already created.

If you move an object by hand or manually edit a dynamic attribute, the change is overwritten at the next reading from the data source. The information icon next to each switch reminds you of this.

During updates, a null value received from the data source leaves the object unchanged: it keeps the last value recorded. The fallback value is only used when the object is created.

Each switch is available only when there is something to update:

aggiornamenti disabilitati.png

For Form classes, which have no coordinates, and for data sources that do not support position updates, the position switch is not shown: the card displays a message in its place. The same happens with the attributes switch in a class without attributes.

update not available.png

Refresh rate

The Refresh rate field sets how often, in milliseconds, the data source updates the position and attributes of existing objects. The value is shared by both switches, ranges from 5,000 to 300,000 milliseconds (30,000 by default) and becomes editable as soon as at least one switch is on.

 


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, elevation and the updates enabled for position and attributes.

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


Removing the automation

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

remove automation.png

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.


Links


Configurare la creazione automatica degli oggetti


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.  Se necessario, gli oggetti già creati possono essere mantenuti aggiornati con le letture successive della data source, senza generare duplicati.

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.

Disponibile solo con sensori configurati in precedenza.


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:

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.

Modificare la data source associata alla classe oggetto comporta la perdita di tutta la configurazione della creazione automatica degli oggetti.


Aggiungere l'automazione

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

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

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

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.

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 alla creazione dell'oggetto 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

Il valore di fallback viene utilizzato alla creazione dell'oggetto, 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.

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.

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

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

Il valore di fallback viene utilizzato alla creazione dell'oggetto, 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.

Mantieni aggiornati gli oggetti esistenti

Di norma ogni nuova lettura della data source genera un nuovo oggetto. Nel blocco Mantieni aggiornati gli oggetti esistenti, in fondo alla scheda, puoi scegliere che una lettura riferita a un oggetto già esistente lo aggiorni invece di crearne un altro. L'aggiornamento riguarda due aspetti indipendenti, ciascuno con il proprio interruttore:

Puoi attivare un solo interruttore o entrambi. In ogni caso la creazione automatica continua a funzionare: una lettura riferita a un oggetto nuovo lo crea, una lettura riferita a un oggetto già esistente lo aggiorna.

pannello aggiornamento automatico.png

Quando un interruttore è attivo, la scheda ricorda che disattivandolo gli oggetti esistenti non verranno più aggiornati. La disattivazione non elimina né modifica gli oggetti: ciascuno mantiene l'ultima posizione o gli ultimi valori ricevuti. Puoi attivare e disattivare gli interruttori liberamente, anche in modifica della classe, indipendentemente dagli oggetti già creati.

Se sposti manualmente un oggetto o modifichi a mano un attributo dinamico, la modifica viene sovrascritta alla lettura successiva della data source. L'icona di informazione accanto a ciascun interruttore te lo ricorda.

Durante gli aggiornamenti un valore nullo ricevuto dalla data source lascia l'oggetto invariato: resta l'ultimo valore registrato. Il valore di fallback viene usato solo alla creazione dell'oggetto.

Ogni interruttore è disponibile solo se ha qualcosa da aggiornare:

aggiornamenti disabilitati.png

Per le classi di tipo Form, che non hanno coordinate, e per le data source che non supportano l'aggiornamento della posizione, l'interruttore della posizione non compare: al suo posto la scheda mostra un messaggio. Lo stesso vale per l'interruttore degli attributi in una classe senza attributi.

update not available.png

Frequenza di aggiornamento

Il campo Frequenza di aggiornamento stabilisce ogni quanti millisecondi la data source aggiorna posizione e attributi degli oggetti esistenti. Il valore è unico per entrambi gli interruttori, va da 5.000 a 300.000 millisecondi (30.000 come valore predefinito) e diventa modificabile non appena almeno un interruttore è attivo.


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, elevazione e gli aggiornamenti attivi per posizione e attributi.

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


Rimuovere l'automazione

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

remove automation.png

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.


Collegamenti


Last update: 12 October 2026


Revision #17
Created 2026-05-07 15:49:58 UTC by EagleArca Wiki
Updated 2026-10-12 13:08:07 UTC by EagleArca Wiki