Available only to users with **backoffice-admin** permissions.
--- ### Create a new user account **1.** Log in to the **Backoffice** and open the **Users** section. [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/r5o1-tab-icon-users.png) **2.** Click **New User** in the upper-right corner. [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/Upt2-button-new-user.png) **3.** Fill in the **Email**, **First Name**, **Last Name** and **Username** fields. [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/g3D3-text-field-new-user.png) **4.** Check the **checkbox for the app** to allow the user to access the operating environment. The checkbox displays the **app’s name** as configured within the organization and may therefore vary. [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/HT04-checkbox-app-ea.png) **5.** Select **backoffice** permissions: - *No access* - *Standard* – all sections except Users and Admin - *Admin* – full access [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/arv5-backoffice-permission.png) **6.** Click **Save** to create the account. The user will receive a *[welcome email](https://wiki.eaglearca.com/books/access-and-overview/page/access-to-the-platform "Access to the platform")* with a link to set their password. --- ### Management and Licenses To **edit a user account**, click the blue button with the arrow icon that appears when you hover over the item. [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/8PH7-user-card-hovered.png) Each organization has a limited number of **licenses**: one for the app and one for the backoffice. If a user accesses both, they consume two licenses. When **licenses are exhausted**, the Create New User button is **no longer available**. --- ### Internal and external utilities Users can be classified as **internal** or **external** based on the email address used during creation. If the email address is **not yet in the system**, a new **internal user** account is created within the organization. If, however, the email address is **already associated** with an existing user account in another organization, the person is added as an **external user**. When an external user is removed from an organization, they remain active in the other organizations with which they are associated. When an internal user is removed, however, they are deleted from the system. --- ### Links - [Create and Manage Groups](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-groups "Create and Manage Groups") - *[Overview of users, roles and groups](https://wiki.eaglearca.com/books/access-and-overview/page/overview-of-users-roles-and-groups "Overview of users, roles and groups")* ---  **Italian version** Nel **Backoffice** è possibile creare e gestire le **utenze** dell’organizzazione. Ogni utenza identifica un utente abilitato ad accedere all'**app** o al **backoffice**, in base ai permessi assegnati.Disponibile solo per utenti con permesso **backoffice-admin.**
--- ### Creare una nuova utenza **1.** Accedi al **Backoffice** e apri la sezione **Utenti**.  **2.** Clicca su **Nuovo utente** in alto a destra. [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/Upt2-button-new-user.png) **3.** Compila i campi **Email, Nome, Cognome, Username**. [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/g3D3-text-field-new-user.png) **4.** Spunta la **checkbox di accesso all’app** per consentire all’utente di entrare nell’ambiente operativo. La checkbox riporta il **nome dell’app** così come configurata nell’organizzazione e può quindi variare. [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/HT04-checkbox-app-ea.png) **5.** Seleziona i permessi per il **backoffice**: - *Nessun accesso* - *Standard* – tutte le sezioni tranne *Utenti* e *Admin* - *Admin* – accesso completo [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/arv5-backoffice-permission.png) **6.** Clicca **Salva** per creare l’utenza. L’utente riceverà una [*mail di benvenuto*](https://wiki.eaglearca.com/books/access-and-overview/page/access-to-the-platform) con il link per impostare la password. --- ### Gestione e licenze Per **modificare un’utenza**, clicca sul pulsante blu con l'icona di una freccia, che appare al passaggio del mouse sull'elemento.  Ogni organizzazione dispone di un numero limitato di **licenze**: una per l'app e una per il backoffice. Se un utente accede a entrambi, consuma due licenze. Quando le **licenze sono esaurite**, il pulsante Nuovo utente **non è più disponibile**. --- ### Utenze interne ed esterne Gli utenti possono essere distinti tra **interni** ed **esterni** in base all’indirizzo email utilizzato in fase di creazione. Se l’email **non è ancora presente** nel sistema, viene creata una nuova **utenza interna** all’organizzazione. Se invece l’email è **già associata** a un’utenza esistente in un’altra organizzazione, la persona viene aggiunta come **utenza esterna**. Quando un’utenza esterna viene rimossa da un’organizzazione, resta comunque attiva nelle altre organizzazioni a cui è associata. Quando invece viene rimossa un’utenza interna, questa viene eliminata dal sistema. --- ### Collegamenti - [Creare e gestire i Gruppi](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-groups "Create and Manage Groups") - *[Panoramica utenti, ruoli e gruppi](https://wiki.eaglearca.com/books/access-and-overview/page/overview-of-users-roles-and-groups "Overview of users, roles and groups")* --- ***Last update:** 07 May 2026* # Create and manage Object Classes Creating an Object Class allows you to define the data structure and geometric nature of the objects that will be used in EagleArca projects.Available only to users with **backoffice** permission.
--- ### Create the Class **1. Access the Backoffice** and navigate to **Object Classes**.  **2.** Click the **New Object** button.  **3. Enter the Name** (unique) and choose the object **Type**: [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/XNw3-type.png)| **Object Type** | **Key Properties** |
| **Point** | Shape, Size, Stroke, Fill, Orientation |
| **Line** | Style (solid, dashed, dotted), Thickness, Stroke |
| **Polygon** | Fill, Stroke |
| **All vector objects** | Map visibility |
| **Attribute type** | **Function** | **Attribute properties** | **Object Class properties** |
| **Text field** | Allows you to enter letters, numbers, or text descriptions. | Can be set as **Required** or **Blocked**. A **maximum text length** can be defined. | Can be set as **Main Attribute** or **Group By Attribute**. |
| **Numeric field** | Allows you to enter numeric values, quantities, or measurements. | Can be set as **Required** or **Blocked**. You can choose between **integer** or **real** numbers and define a **value range**. | Can be set as **Main Attribute** or **Group By Attribute**. |
| **Value list** | Allows you to select one or more values from a predefined list. | Can be set as **Required** or **Blocked**. The selection can be configured as **single answer** or **multiple answers**. | Can be set as **Main Attribute** or **Group By Attribute**. |
| **Date** | Allows you to enter a date or a date with time. | Can be set as **Required** or **Blocked**. You can choose between **date only** or **date and time**. | Can be set as **Main Attribute** or **Group By Attribute**. |
| **Attachments** | Allows you to upload files associated with the object. | Can be set as **Required**. You can define which file types can be uploaded: **images**, **videos**, or **documents**. | No Object Class properties are available. |
| **Size** | Automatically records the object’s geometric information, such as coordinates, length, or area. | No specific attribute properties are available. | Can be set as **Main Attribute**. |
| **True/False** | Allows you to choose between two boolean values. | Can be set as **Blocked**. | Can be set as **Group By Attribute**. |
| **Object list** | Allows you to create a list of related sub-attributes, useful for repeated groups of information. | Can be set as **Blocked**. | No Object Class properties are available. |
Disponibile solo per utenti con permesso **backoffice.**
--- ### Creare la Classe **1.** Accedi **al Backoffice** e naviga in **Classi Oggetto**.  **2.** Clicca sul pulsante **Nuovo oggetto**.  **3. Inserisci il Nome** (univoco) e **scegli il Tipo** di oggetto: [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/XNw3-type.png) **Punto**: Vettoriale, caratterizzato da coordinate. **Linea**: Vettoriale, caratterizzata da lunghezza. **Poligono**: Vettoriale, caratterizzata da area. **Form**: Non vettoriale, senza posizione in mappa e stile. #### Impostazioni Avanzate In base al tipo di oggetto selezionato, possono essere disponibili configurazioni aggiuntive. Se il tipo è **Punto**, puoi attivare **Punto orientato** per memorizzare e rappresentare la direzione dell’oggetto in mappa. L’opzione aggiunge automaticamente un **attributo di sistema non modificabile**. Se il tipo è **Form**, puoi attivare **Form globale** per creare oggetti collegabili a qualsiasi progetto e gestibili dalla sezione **Liste Globali**. --- ### Configurare lo Stile di Default (Solo Vettoriali) Lo stile definito è lo **stile di default** che tutte le istanze ereditano. [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/mLD5-object-style.png)| **Tipo Oggetto** | **Proprietà Chiave** |
| **Punto** | Forma, Dimensione, Contorno (stroke), Riempimento (fill), Orientamento |
| **Linea** | Stile (continua, a tratti, puntinata), Spessore, Contorno (stroke) |
| **Poligono** | Riempimento (fill), Contorno (stroke) |
| **Tutti i vettoriali** | Visibilità in mappa |
| **Tipo di attributo** | **Funzione** | **Proprietà dell’attributo** | **Proprietà della Classe Oggetto** |
| **Campo di testo** | Permette di inserire lettere, numeri o descrizioni testuali. | Può essere impostato come **Obbligatorio** o **Bloccato**. È possibile definire una **lunghezza massima** del testo. | Può essere impostato come **Attributo principale** o come **Raggruppa per attributo**. |
| **Campo numerico** | Permette di inserire valori numerici, quantità o misurazioni. | Può essere impostato come **Obbligatorio** o **Bloccato**. È possibile scegliere tra numeri **interi** o **reali** e definire un **intervallo di valori**. | Può essere impostato come **Attributo principale** o come **Raggruppa per attributo**. |
| **Lista valori** | Permette di selezionare uno o più valori da un elenco predefinito. | Può essere impostata come **Obbligatoria** o **Bloccata**. È possibile configurare la selezione come **risposta singola** o **risposte multiple**. | Può essere impostata come **Attributo principale** o come **Raggruppa per attributo**. |
| **Data** | Permette di inserire una data o una data con orario. | Può essere impostata come **Obbligatoria** o **Bloccata**. È possibile scegliere tra formato **solo data** o **data e ora**. | Può essere impostata come **Attributo principale** o come **Raggruppa per attributo**. |
| **Allegati** | Permette di caricare file associati all’oggetto. | Può essere impostato come **Obbligatorio**. È possibile definire quali tipi di file caricare: **immagini**, **video** o **documenti**. | Non sono disponibili proprietà di Classe Oggetto. |
| **Dimensione** | Registra automaticamente informazioni geometriche dell’oggetto, come coordinate, lunghezza o area. | Non sono disponibili proprietà specifiche dell’attributo. | Può essere impostata come **Attributo principale**. |
| **Vero/Falso** | Permette di scegliere tra due valori booleani. | Può essere impostato come **Bloccato**. | Può essere impostato come **Raggruppa per attributo**. |
| **Lista oggetti** | Permette di creare una lista di sotto-attributi correlati, utile per gruppi di informazioni ripetute. | Può essere impostata come **Bloccata**. | Non sono disponibili proprietà di Classe Oggetto. |
Available only to users with **backoffice** permissions.
--- ### How relations work A relation always connects **two object classes**: - **Current object class** This is the class you are configuring at that moment in the **Backoffice**. - **Linked object class** This is the class with which the objects of the current class can be linked. When a relation is configured between two classes, objects can be associated with one or more instances of the related class. The number of objects that can be linked depends on the **cardinality** set in the relation. --- ### Set up relations To configure a relationship between object classes, open the **Backoffice**, access the edit page of an object class, and select the **Relations** tab.  To create a new relationship, click the **Add relation** button. The configuration is divided into two sections: **This object class** and **Is related to**. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/2-card-relation.png) #### Current object class The **This object class** section represents the object class you are editing. The **Object class** field is filled in automatically and cannot be edited. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/3-section-this-object-class.png) In this section, you can configure: - **Cardinality:** select **1** or **N** to indicate how many objects of the current class can be linked to **objects of the other class**. - **Required:** activate the switch if this object class is necessary for the existence of the other one. If the switch is active, an object of the other class can exist only if it is linked to an object of this class. - **Displayed name:** when an object with a relationship is created and [**displayed in the app**](https://wiki.eaglearca.com/books/app-features/page/manage-object-relations "Manage object relations"), the relationship attribute has a name. If necessary, you can enter the name with which this class is shown in the relationship. If no name is set, the system automatically uses the name of the object class. - **Attributes to show:** when an object with a relationship is created and displayed in the app, the related object class appears in the relationship attribute. The related class can be expanded to show a preview of its attributes. With this field, you can choose **which attributes to show**. You cannot select attributes of type **relationship** or **object list**. #### Linked object class The **Is related to** section allows you to define the object class to link to the current class. In the **Object class** field, select from the dropdown menu the class with which to create the relationship. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/4-section-is-related-to.png) You can also configure the following fields for this class: - **Cardinality:** select **1** or **N** to indicate how many objects of the linked class can be associated with an object of the current class. - **Required:** activate the switch if the linked object class is necessary for the existence of the current class. If the switch is active, an object of the current class can exist only if it is linked to an object of this class. - **Displayed name:** if necessary, you can enter the name with which the linked class is shown in the relationship. If no name is set, the system automatically uses the name of the linked object class. - **Attributes to show:** with this field, you can choose **which attributes to show**, but **only after selecting the class**. You cannot select attributes of type **relationship** or **object list**. #### Relationship cardinality The **overall cardinality** of the relationship depends on the combination of the **values set in the two sections**.| **Configuration** | **Meaning** |
| 1 → 1 | one object can be linked to one object only |
| 1 → N | one object can be linked to multiple objects |
| N → 1 | multiple objects can be linked to one object |
| N → N | multiple objects can be linked to each other |
**Only one of the two classes can be required**, making one class necessary for the existence of the other.
💡 **Tip:** Limit the attributes to display to keep the attributes panel more readable. --- ### Configuration rules and conditions A current object class **cannot be set as required** if the linked object class already has **created instances**. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/5-object-class-already-in-use.png) After saving a relationship, it is not possible to edit: - the **cardinality** - the **linked object class** - the **required** status To configure a relationship on an object class of type **Form** or **Global Form**, the class must be saved first. After saving, re-enter edit mode for the object class and open the **Relations** section to create the relationship. If a relationship is deleted, the system automatically removes the link from all involved instances. --- ### Links - *[Introduction to Object Classes](https://wiki.eaglearca.com/books/access-and-overview/page/introduction-to-object-classes "Introduction to Object Classes")* ---  **Italian version** Le relazioni sono una **tipologia di attributo** che permette di **collegare tra loro oggetti appartenenti a classi oggetto diverse**, creando legami strutturati tra gli elementi del progetto. Questa funzione consente di rappresentare relazioni logiche tra istanze. Ad esempio, puoi collegare una **strada** ai **pali dell’illuminazione** presenti lungo il suo tracciato oppure associare una **strada** ai **segnali stradali** installati lungo di essa. Le relazioni vengono configurate durante la [**creazione o la modifica di una classe oggetto**](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-object-classes "Create and manage Object Classes"), all’interno di una sezione dedicata.Disponibile solo per utenti con permesso **backoffice.**
--- ### Come funzionano le relazioni Una relazione collega sempre **due classi oggetto**: - **Classe oggetto corrente** È la classe che stai configurando in quel momento nel **Backoffice**. - **Classe oggetto collegata** È la classe con cui gli oggetti della classe corrente possono essere collegati. Quando una relazione viene configurata tra due classi, gli oggetti possono essere associati a una o più istanze della classe relazionata. Il numero di oggetti collegabili dipende dalla **cardinalità** impostata nella relazione. --- ### Configurare le relazioni Per configurare una relazione tra classi oggetto, apri il **Backoffice**, accedi alla pagina di modifica di una classe oggetto e seleziona la tab **Relazioni**.  Per creare una nuova relazione clicca sul pulsante **Aggiungi relazione**. La configurazione è suddivisa in due sezioni: **Questa classe oggetto** e **È legata a**. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/2-card-relation.png) #### Classe oggetto corrente La sezione **Questa classe oggetto** rappresenta la classe oggetto che stai modificando. Il campo **Classe oggetto** è compilato automaticamente e non può essere modificato. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/3-section-this-object-class.png) In questa sezione puoi configurare: - **Cardinalità**: seleziona **1** oppure **N** per indicare quanti oggetti della classe corrente possono essere collegati **agli oggetti dell'altra classe**. - **Obbligatoria:** attiva lo switch se questa classe oggetto è necessaria per l’esistenza dell’altra. Se lo switch è attivo, un oggetto dell’altra classe può esistere solo se è collegato a un oggetto di questa classe. - **Nome visualizzato:** quando un oggetto con una relazione viene creato e *[visualizzato nell’app](https://wiki.eaglearca.com/books/app-features/page/manage-object-relations "Manage object relations")*, l’attributo della relazione ha un nome. Se necessario, puoi inserire il nome con cui questa classe viene mostrata nella relazione. Se non viene impostato un nome, il sistema utilizza automaticamente il nome della classe oggetto. - **Attributi da mostrare**: quando un oggetto con una relazione viene creato e visualizzato nell’app, la classe oggetto relazionata compare nell’attributo della relazione. La classe relazionata può essere espansa per mostrare un’anteprima dei suoi attributi. Con questo campo puoi scegliere **quali attributi mostrare**. Non puoi selezionare attributi di tipo **relazione** o **lista oggetti**. #### Classe oggetto collegata La sezione **È legata a** permette di definire la classe oggetto da collegare alla classe corrente. Nel campo **Classe oggetto**, seleziona dal menu a tendina la classe con cui creare la relazione. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/4-section-is-related-to.png) Anche per questa classe puoi configurare: - **Cardinalità**: seleziona **1** oppure **N** per indicare quanti oggetti della classe collegata possono essere associati a un oggetto della classe corrente. - **Obbligatoria:** attiva lo switch se la classe oggetto collegata è necessaria per l’esistenza della classe corrente. Se lo switch è attivo, un oggetto della classe corrente può esistere solo se è collegato a un oggetto di questa classe. - **Nome visualizzato:** Se necessario, puoi inserire il nome con cui la classe collegata viene mostrata nella relazione. Se non viene impostato un nome, il sistema utilizza automaticamente il nome della classe oggetto collegata. - **Attributi da mostrare:** con questo campo puoi scegliere **quali attributi mostrare**, ma **solo dopo aver selezionato la classe**. Non puoi selezionare attributi di tipo **relazione** o **lista oggetti**. #### Cardinalità della relazione La **cardinalità complessiva** della relazione dipende dalla combinazione dei **valori impostati nelle due sezioni**.| **Configurazione** | **Significato** |
| 1 → 1 | un oggetto può essere collegato a un solo oggetto |
| 1 → N | un oggetto può essere collegato a più oggetti |
| N → 1 | più oggetti possono essere collegati a uno |
| N → N | più oggetti possono essere collegati tra loro |
**Solo una delle due classi può essere obbligatoria**, rendendo una classe necessaria per l'esistenza dell'altra.
💡 **Suggerimento:** Limita gli attributi da visualizzare per lasciare il pannello attributi più leggibile. --- ### Regole e condizioni di configurazione Una classe oggetto corrente **non può essere impostata come obbligatoria** se la classe oggetto collegata ha già delle **istanze create**. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/5-object-class-already-in-use.png) Dopo il salvataggio di una relazione, non è possibile modificare: - la **cardinalità** - la **classe oggetto collegata** - lo stato **obbligatorio** Per configurare una relazione su una classe oggetto di tipo **Form** o **Form globale**, la classe deve essere prima salvata. Dopo il salvataggio, rientra in modifica nella classe oggetto e apri la sezione **Relazioni** per creare la relazione. Se una relazione viene eliminata, il sistema rimuove automaticamente il collegamento da tutte le istanze coinvolte. --- ### Collegamenti - *[Introduzione alle Classi Oggetto](https://wiki.eaglearca.com/books/access-and-overview/page/introduction-to-object-classes "Introduction to Object Classes")* --- ***Last update:** *08 May 2026** # Configure Data Sources and Charts A Data Source is a data source that can be associated with an object class and allows you to collect and display information organized over time.Available only with **sensors configured in advance**.
--- ### Configuration To configure data sources and charts, open the **Backoffice**, access the edit page of an object class, and select the **Data Sources** tab. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/2-tab-object-class.png) #### Add a Data Source To create a new data source, click the **Add data source** button. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-01/3-button-add-data-sources.png) Select the data source **type** and enter an **identifying name** (e.g. *Type Thermometer, Name Thermometer 1*). [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/4-sensor-selection.png) #### Add a ChartThe option to add charts becomes available only after **at least one data source** has been added.
To create a new chart, click the **Add chart** button. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-01/5-button-add-data-sources.png) Enter an **identifying name** and select the **chart type** (*Line, Counter, Bar, Scatter, 3D Scatter, Heatmap).*  At this point, you can configure different sections: - **Data** (required) - **Customization** (optional) - **Style** (optional) 💡 **Tip:** Assign clear and descriptive names to data sources and charts (e.g. “Thermometer Floor 1”) to make them easier to manage. --- ### Configure the Chart #### Data Section The **Data** section defines which data is displayed in the chart and which **Data Source** it is retrieved from. The first field to complete is **Data compression**, which allows you to choose how the available data is handled before it is displayed in the chart. You can select one of the following methods: - **Aggregation over time:** Groups the collected data into time intervals and shows a summarized value for each period. This is useful when there is a large amount of data and a more compact view of the trend is needed. - **Downsampling:** Reduces the number of displayed data points by keeping only part of the available values. This is useful to make the chart lighter when the amount of data is high. After choosing the compression method, configure the **Main data source**. In this section, select the **Data Source** that feeds the chart from those previously created. Once the Data Source has been selected, specify which values must be used for the chart axes. The available axes change depending on the selected chart type. [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/Qid6-section-data.png) You can add multiple data series, and therefore multiple Data Sources, by clicking **Add series**. For **Counter** charts, click **Add value** instead. For the **3D Scatter** chart, the **Color range** is also available. This field allows you to select a numeric parameter to use for coloring the chart points according to their value. The system applies a color scale that helps visually distinguish lower, intermediate, or higher values within the data distribution. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/8-color-range.png) For the **Heatmap** chart, the **Color range** is also available. It defines the numeric parameter used to generate the color intensity of the map. The color therefore represents the variation of the selected value across the different areas or positions of the chart. For the **Heatmap**, you can also enable **Parametric navigation**. This option allows you to select an additional parameter to use as a data navigation level. In this way, you can browse the Heatmap by layers, displaying different data layers according to the value of the selected parameter. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/9-parametric-navigation.png) #### Customization SectionThe option to customize the chart becomes available only after the **Data** section has been completed.
The **Customization** section allows you to define how the chart is presented in the object detail panel. From here, you can edit texts, thresholds, axis scaling, and the values shown when the chart is opened. **[](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/7-customization.png)** **Labels** In this section, you can configure the texts displayed in the chart. You can enter a **title**, a **subtitle**, and the axis labels, for example **X Axis** and **Y Axis**. To make the chart clearer, you can also include the unit of measurement in the axis labels. **Thresholds** Thresholds allow you to highlight reference values or critical values within the chart. For each threshold, you can configure: - **Name**, to identify the threshold in the chart. - **Axis**, to indicate which axis the threshold applies to. - **Trigger value**, to define the reference value to highlight. This configuration is useful, for example, to indicate that a maximum temperature, a minimum level, or any other monitored value has been exceeded. **Axes** In this section, you can define how the scale of the values shown in the chart is calculated. You can choose from: - **Auto-scale**, where the system automatically adapts the scale based on the values shown in the chart. - **Fixed scale**, which allows you to manually set a minimum and maximum range. This is useful when you want to compare different charts while keeping the same reference scale. - **Relative scale**, which applies a percentage margin based on the values shown in the chart. This is useful when you want to keep a dynamic scale while adding extra visual space above and below the displayed values. **Default values** This section allows you to configure the initial values shown when the object detail panel is opened. You can define: - **Aggregation interval**, to establish how the data is grouped in the initial view. - **Time period**, to indicate the time range displayed when the chart is opened. 💡 **Tip:** Use **Thresholds** if you want to automatically highlight anomalous values in the chart. #### Style SectionAvailable only when **a single data series** is configured in the **Data** section.
This section allows you to create one or more **conditional styles**, that is, rules that change the appearance of the chart when specific conditions are met. [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/m9m8-style.png) For each conditional style, you must enter a **name**, useful for recognizing the configured rule. In the conditions section, you can define when the style must be applied. Each condition is composed of: - **Reference parameter**, which is the value to check. - **Criterion**, which is the rule to verify, for example greater than, less than, or equal to. - **Type**, which is the way the comparison value is specified. - **Value**, which is the value that activates the condition. You can add multiple conditions by clicking **Add condition**. In the **Style** section, you can choose the **color** to apply to the chart when the defined conditions are met. The **Reset** button restores the style to the default value. You can configure multiple styles, by clicking **Add conditional style**, so that different colors are applied based on different thresholds or states. --- ### Links - *[Managing objects in the project](https://wiki.eaglearca.com/books/app-features/page/managing-objects-in-the-project "Managing objects in the project")* ---  **Italian version** Una **Sorgente dati** è una fonte dati associabile a una classe oggetto, che permette di raccogliere e visualizzare informazioni organizzate nel tempo. Questa funzione consente di collegare agli oggetti dati provenienti da sensori o altre fonti configurate, così da consultarli tramite grafici nel dettaglio dell’oggetto. Ad esempio, puoi associare a un sensore ambientale una Sorgente dati che registra temperatura, umidità o altri valori monitorati. Le **Sorgenti dati** e i **grafici** vengono configurati durante la *[creazione o la modifica di una classe oggetto](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-object-classes "Create and manage Object Classes")*, all’interno di una sezione dedicata.Disponibile solo con **sensori configurati in precedenza**.
### Configurazione Per configurare sorgenti dati e grafici, apri il **Backoffice**, accedi alla pagina di modifica di una classe oggetto e seleziona la tab **Rappresentazione di dati**. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/2-tab-object-class.png) #### Aggiungere Sorgenti dati Per creare una nuova sorgente dati clicca sul pulsante **Aggiungi sorgente dati**. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-01/3-button-add-data-sources.png) Seleziona il **tipo** di sorgente dati e imposta un **nome identificativo** (Es: Type *Thermometer*, Name *Termometro 1*). [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/4-sensor-selection.png) #### Aggiungere GraficoLa possibilità di aggiungere grafici diventa disponibile solo se è stata aggiunta **almeno una sorgente dati**.
Per creare un nuovo grafico clicca sul pulsante **Aggiungi grafico**. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-01/5-button-add-data-sources.png) Imposta il **nome identificativo** e seleziona il **tipo di grafico** (*Line, Counter, Bar, Scatter, 3D Scatter, Heatmap*).  A questo punto puoi configurare diverse sezioni: - **Dati** (obbligatoria) - **Personalizzazione** (facoltativa) - **Stile** (facoltativa) 💡 **Suggerimento:** Assegna nomi chiari e descrittivi a sorgenti dati e grafici (es. "Termometro Piano 1") per facilitarne la gestione. --- ### Configurare il Grafico Sezione Dati La sezione **Dati** definisce quali dati vengono visualizzati nel grafico e da quale **Sorgente dati** vengono recuperati. Il primo campo da compilare è la **Compressione dati**, che permette di scegliere come gestire i dati disponibili prima della visualizzazione nel grafico. Puoi selezionare uno dei seguenti metodi: - **Aggregazione per periodo:** Raggruppa i dati raccolti in intervalli di tempo e mostra un valore sintetico per ogni periodo. È utile quando sono presenti molti dati e serve una lettura più compatta dell’andamento. - **Sottocampionamento:** Riduce il numero di dati visualizzati mantenendo solo una parte dei valori disponibili. È utile per alleggerire la visualizzazione del grafico quando la quantità di dati è elevata. Dopo aver scelto il metodo di compressione, configura la **Sorgente dati principale**. In questa sezione è necessario selezionare la **Sorgente dati** che alimenta il grafico tra quelle create in precedenza. Una volta selezionata la Sorgente dati, specifica quali valori devono essere utilizzati negli assi del grafico. Gli assi disponibili cambiano in base alla tipologia di grafico selezionata. [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/Qid6-section-data.png) È possibile aggiungere più serie di dati, e quindi più Sorgente dati, cliccando **Aggiungi serie**. Per i grafici di tipo **Counter**, clicca invece **Aggiungi valore**. Nel caso del grafico **3D Scatter**, è disponibile anche il **Campo colore**. Questo campo permette di selezionare un parametro numerico da usare per colorare i punti del grafico in base al loro valore. Il sistema applica una scala colore che aiuta a distinguere visivamente valori più bassi, intermedi o più alti all’interno della distribuzione dei dati. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/8-color-range.png) Nel caso del grafico **Heatmap**, è disponibile il **Campo colore**, che definisce il parametro numerico usato per generare l’intensità cromatica della mappa. Il colore rappresenta quindi la variazione del valore selezionato nelle diverse aree o posizioni del grafico. Per la **Heatmap** puoi inoltre abilitare la **Navigazione parametrica**. Questa opzione consente di selezionare un ulteriore parametro da usare come livello di navigazione dei dati. In questo modo è possibile consultare la Heatmap per strati, visualizzando layer diversi in base al valore del parametro scelto. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/9-parametric-navigation.png) #### Sezione PersonalizzazioneLa possibilità di personalizzare il grafico diventa disponibile solo se è stata completata la sezione **Dati**.
La sezione **Personalizzazione** permette di definire come il grafico viene presentato nel dettaglio dell’oggetto. Da qui puoi modificare testi, soglie, scala degli assi e valori mostrati all’apertura del grafico. **[](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/7-customization.png)** **Etichette** In questa sezione puoi configurare i testi visualizzati nel grafico. Puoi inserire un **titolo**, un **sottotitolo** e le etichette degli assi, ad esempio **Asse X** e **Asse Y**. Per rendere il grafico più chiaro, nelle etichette degli assi puoi indicare anche l’unità di misura del valore rappresentato. **Soglie** Le soglie permettono di evidenziare valori di riferimento o valori critici all’interno del grafico. Per ogni soglia puoi configurare: - **Nome**, per identificare la soglia nel grafico. - **Asse**, per indicare a quale asse applicare la soglia. - **Valore di attivazione**, per definire il valore di riferimento da evidenziare. Questa configurazione è utile, ad esempio, per segnalare il superamento di una temperatura massima, di un livello minimo o di qualsiasi altro valore da tenere sotto controllo. **Assi** In questa sezione puoi definire come viene calcolata la scala dei valori mostrati nel grafico. Puoi scegliere tra: - **Scala automatica**, con cui il sistema adatta automaticamente la scala in base ai valori presenti nel grafico. - **Scala fissa**, che permette di impostare manualmente un intervallo minimo e massimo. È utile quando vuoi confrontare grafici diversi mantenendo sempre la stessa scala di riferimento. - **Scala relativa**, che applica un margine percentuale rispetto ai valori presenti nel grafico. È utile quando vuoi mantenere una scala dinamica, ma con uno spazio visivo aggiuntivo sopra e sotto i valori rappresentati. **Valori predefiniti** Questa sezione permette di configurare i valori iniziali mostrati quando si apre il dettaglio dell’oggetto. Puoi definire: - **Intervallo di aggregazione**, per stabilire come i dati vengono raggruppati nella vista iniziale. - **Periodo temporale**, per indicare l’intervallo di tempo visualizzato all’apertura del grafico. 💡 **Suggerimento**: Usa le Soglie se vuoi evidenziare automaticamente valori anomali sul grafico. #### Sezione StileDisponibile solo se è configurato **una sola serie di dati** nella sezione **Dati**.
Questa sezione permette di creare uno o più **stili condizionali**, cioè regole che modificano l’aspetto del grafico quando si verificano determinate condizioni. [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/m9m8-style.png) Per ogni stile condizionale è necessario inserire un **nome**, utile per riconoscere la regola configurata. Nella sezione delle condizioni puoi definire quando lo stile deve essere applicato. Ogni condizione è composta da: - **Parametro di riferimento**, cioè il valore da controllare. - **Criterio**, cioè la regola da verificare, ad esempio maggiore di, minore di o uguale a. - **Tipo**, cioè la modalità con cui viene indicato il valore di confronto. - **Valore**, cioè il valore che attiva la condizione. Puoi aggiungere più condizioni cliccando su **Aggiungi condizione**. Nella sezione **Stile** puoi scegliere il **colore** da applicare al grafico quando le condizioni definite sono soddisfatte. Il pulsante **Reset** ripristina lo stile al valore predefinito. È possibile configurare più stili, cliccando su **Aggiungi stile condizionale**, così da applicare colori diversi in base a soglie o stati differenti. --- ### Collegamenti - *[Gestire gli oggetti nel progetto](https://wiki.eaglearca.com/books/app-features/page/managing-objects-in-the-project "Managing objects in the project")* --- ***Last update:** 08 May 2026* # 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.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: - **exactly one** data source - **at least one** chart [](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.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. [](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. [](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. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/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 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. [](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.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. [](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. [](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. [](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. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/Qpgremove-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 - *[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")* ---  **Italian version** 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.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: - **esattamente una** data source - **almeno** **un** grafico [](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.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. [](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. [](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. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/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 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**. [](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 obbligatorioSe 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. [](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. [](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. [](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. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/Qpgremove-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 - *[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* # Create and manage Roles A Role defines permissions (edit, view, access) for object classes and resources. It is used to precisely configure the permissions assigned to associated groups.Available only to users with **backoffice** permission.
--- ### Permission Levels Permissions apply to **Object Classes** and **Reports**.| **Permission Type** | **Icon** | **Description** |
| **Hidden** | 👁️🗨️ (crossed-out eye) | Users with this role **cannot see** the element. |
| **Visible** | 👁️ (open eye) | Users with this role **can see** the element, but cannot edit it. |
| **Editable** | ✏️ (pencil) | Users with this role **can view and edit** the element. |
Disponibile solo per utenti con permesso **backoffice.**
--- ### Livelli di Permesso I permessi si applicano a **Classi Oggetto** e **Report**.| **Tipo di Permesso** | **Icona** | **Descrizione** |
| **Non visibile** | 👁️🗨️ (occhio barrato) | Gli utenti del ruolo **non vedono** l'elemento. |
| **Visibile** | 👁️ (occhio aperto) | Gli utenti del ruolo **vedono** l'elemento, ma non possono modificarlo. |
| **Modificabile** | ✏️ (matita) | Gli utenti del ruolo possono **visualizzare e modificare** l'elemento. |
Available only to users with **backoffice** permissions. To create a group, **the role** to which the group will be linked must **already exist** in the system.
--- ### Steps **1. Access the Backoffice** and click **Groups** in the left-side menu**.** The list shows the name, creation date, associated projects, added users and linked role.  **2.** Click the **New Group** button in the top-right corner.  **3. Fill in the required fields** (name and role): - Enter a unique name in the **Group Name** field. - Select the **Role** to associate from the drop-down menu. [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/3-name-and-role.png)Name and Role are **required** to save.
**4. Add or remove users.** The group configuration shows two lists: on the **left** are all **users in the organization**, while on the **right** are the **users already added to the group**. **To add users to the group**, select one or more names from the list on the left using `Control` or `Shift` for multiple selection, then drag them to the area on the right. **To remove users from the group**, select the names from the list on the right and drag them to the list on the left. To remove all added users, click **Clear**. [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/xMu4-groups-configuration.png) **5. Save the new group** by clicking **Save** in the top-right corner (after assigning at least one user). 💡**Tip**: Use the *search bar* to filter users in both lists. 💡**Tip**: Make sure to assign only those users who need the same level of access to the projects. --- ### Viewing and Editing Groups **To edit a group**, click the blue button with the arrow icon that appears when you hover over the item. **To duplicate a group**, select an item from the list. Once selected, the **Duplicate** button will appear. --- ### Links - *[Overview of users, roles and groups](https://wiki.eaglearca.com/books/access-and-overview/page/overview-of-users-roles-and-groups "Overview of users, roles and groups")* - *[Introduction to Object Classes](https://wiki.eaglearca.com/books/access-and-overview/page/introduction-to-object-classes "Introduction to Object Classes")* - *[Create and manage Object Classes](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-object-classes "Create and manage Object Classes")* - *[Create and manage Projects](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-projects "Create and manage Projects")* ---  **Italian version** Un gruppo raccoglie utenti con lo stesso **ruolo** e **permessi**, consentendo loro di lavorare sugli stessi progetti con un set di operazioni coerenti. Creare un gruppo serve a **associare** [*utenti*](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-users "Create and manage Users") e **assegnare loro un** [*ruolo*](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-roles "Create and manage Roles"), semplificando la gestione dei permessi in modo scalabile.Disponibile solo per utenti con permesso **backoffice**. Per creare un gruppo è necessario che nel sistema sia **già presente** il **ruolo** a cui il gruppo deve essere collegato.
--- ### Passaggi **1. Accedi al Backoffice** e clicca su **Gruppi** nel menu sul lato sinistro. La lista mostra nome, data di creazione, progetti associati, utenti aggiunti e il ruolo collegato.  **2.** Clicca sul pulsante **Nuovo gruppo** in alto a destra.  **3. Compila i campi obbligatori** (nome e ruolo): - Inserisci un nome univoco nel campo **Nome gruppo**. - Seleziona il **Ruolo** da associare tramite il menu a tendina. [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/3-name-and-role.png)Nome e Ruolo sono **obbligatori** per il salvataggio.
**4. Aggiungi o rimuovi gli utenti.** La configurazione del gruppo mostra due liste: a **sinistra** sono disponibili **tutti gli utenti dell’organizzazione**, mentre a **destra** sono presenti gli **utenti già aggiunti al gruppo**. **Per aggiungere utenti al gruppo**, seleziona uno o più nominativi dalla lista a sinistra usando `Control` o `Shift` per le selezioni multiple, quindi trascinali nell’area a destra. **Per rimuovere utenti dal gruppo**, seleziona i nominativi dalla lista a destra e trascinali nella lista a sinistra. Per rimuovere tutti gli utenti aggiunti, clicca **Cancella**. [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/xMu4-groups-configuration.png) **5. Salva il nuovo gruppo** cliccando **Salva** in alto a destra (dopo aver assegnato almeno un utente). 💡**Suggerimento**: Usa la barra di ricerca per filtrare gli utenti in entrambe le liste. 💡**Suggerimento**: Assicurati di assegnare solo gli utenti che devono avere lo stesso livello di accesso ai progetti. --- ### Visualizzazione e Modifica dei Gruppi **Per modificare un gruppo**, clicca sul pulsante blu con l’icona di una freccia, che appare al passaggio del mouse sull’elemento. **Per duplicare un gruppo**, seleziona un elemento dalla lista. Dopo la selezione, compare il pulsante **Duplica**. --- ### Collegamenti - *[Panoramica utenti, ruoli e gruppi](https://wiki.eaglearca.com/books/access-and-overview/page/overview-of-users-roles-and-groups "Overview of users, roles and groups")* - *[Introduzione alle Classi Oggetto](https://wiki.eaglearca.com/books/access-and-overview/page/introduction-to-object-classes "Introduction to Object Classes")* - *[Creare e gestire le Classi Oggetto](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-object-classes "Create and manage Object Classes")* - *[Creare e gestire i Progetti](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-projects "Create and manage Projects")* --- ***Last update:** 07 May 2026* # Create and manage Projects Creating a new project allows you to structure and manage the organisation's operational activities in an orderly way. Each project can contain object classes, resources, groups, sensor sites and reports.Available only to users with **backoffice** permission. To create a project, the **groups** to be associated must **already exist** in the system.
--- ### Create a new project **1. Access the Backoffice** and click **Projects** in the left side menu. The list shows name, date of last update, linked groups and tags.  **2.** Click the **New project** button in the top-right corner.  **3. Fill in the main fields:** - Enter a unique **Project name** (required). - Add one or more **Tags** by typing and pressing Enter, or by selecting an existing one from the dropdown menu. 💡 **Tip:** Tags are used to classify projects and make searching easier. Tags you create are saved and automatically suggested in future projects. **4. Add elements to the project.** In the lower sections, [*Object classes*](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-object-classes "Create and manage Object Classes"), Resources, Sensor sites, [*Groups*](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-groups "Create and manage Groups") and [*Reports*](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-reports "Create and manage Reports"), click **Add** to open the selection panel. [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/mKL5-section-header.png) Select one or more elements in the left panel and drag them to the right to add them. Use the search bar to filter. For multiple selections use `Ctrl` or `Shift`. [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/iP76-section-configuration.png) Click **Apply** to confirm. #### Object classes and automatic creation Some object classes have the [*automatic object creation*](https://wiki.eaglearca.com/books/backoffice/page/configure-automatic-object-creation "Configure automatic object creation") function configured. When you add one of these classes to the project, **the icon** for automatic creation is visible next to its name, as a visual reminder of this feature. Once the class has been added, the icon becomes interactive directly within the section: you can use it to **enable or disable** automatic object creation for that specific project. **5. Save the new project** by clicking **Save** in the top-right corner. The button remains disabled until a name and at least one group have been entered.If you remove Object Classes that already have **created instances**, these will be **hidden** from the project. This information remains available in **a label** at the top of the object classes section; hovering over it will show you **which object classes have been hidden**.
💡 **Tip:** Before saving, always check that the associated groups are correct: only users belonging to them will have access to the project. --- ### Edit and manage elements **To edit a project**, click the blue button with the arrow icon that appears when hovering over the element. If you want to **duplicate a project**, select a single element from the list, then click the **Duplicate** button. A window will ask which elements of the project to include in the copy. **To delete a project**, select one or more elements from the list: the **Delete** button will appear. To confirm, type the project name in the appropriate field. --- ### Links - [Managing objects in the project](https://wiki.eaglearca.com/books/app-features/page/managing-objects-in-the-project "Managing objects in the project") - [Managing reports in the project](https://wiki.eaglearca.com/books/app-features/page/managing-reports-in-the-project "Managing reports in the project") ---  **Italian version** Creare un nuovo progetto permette di strutturare e gestire le attività operative dell’organizzazione in modo ordinato. Ogni progetto può contenere **classi oggetto**, **risorse**, **gruppi**, **siti dei sensori** e **report**.Disponibile solo per utenti con permesso **backoffice**. Per creare un progetto è necessario che nel sistema siano **già presenti i gruppi** da associare.
--- ### Creare un nuovo progetto **1. Accedi al Backoffice** e clicca su **Progetti** nel menu laterale sinistro. La lista mostra nome, data dell'ultimo aggiornamento, gruppi collegati e tag.  **2.** Clicca sul pulsante **Nuovo progetto** in alto a destra.  **3. Compila i campi principali:** - Inserisci un **Nome progetto** univoco (obbligatorio). - Aggiungi uno o più **Tag** scrivendo e premendo Invio, oppure scegliendone uno esistente dal menu a tendina. 💡 **Suggerimento:** I tag servono per classificare i progetti e facilitare la ricerca. Quelli creati vengono salvati e riproposti automaticamente nei progetti futuri. **4. Aggiungi elementi al progetto.** Nelle sezioni inferiori, [*Classi oggetto*](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-object-classes "Create and manage Object Classes"), Risorse, Siti di sensori, *[Gruppi](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-groups "Create and manage Groups")* e *[Report](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-reports "Create and manage Reports")*, clicca **Aggiungi** per aprire il pannello di selezione. [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/mKL5-section-header.png) Seleziona uno o più elementi nel pannello sinistro e trascinali a destra per aggiungerli. Usa la barra di ricerca per filtrare. Per selezioni multiple usa `Ctrl` o `Shift`. [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/iP76-section-configuration.png) Clicca **Applica** per confermare. #### Classi oggetto e creazione automatica Alcune classi oggetto hanno la funzione di [*creazione automatica degli oggetti*](https://wiki.eaglearca.com/books/backoffice/page/configure-automatic-object-creation "Configure automatic object creation") configurata. Quando aggiungi una di queste classi al progetto, accanto al suo nome è visibile **l'icona** della creazione automatica, come promemoria visivo di questa caratteristica. Una volta aggiunta la classe, l'icona diventa interagibile direttamente nella sezione: puoi usarla per **attivare o disattivare** la creazione automatica degli oggetti per quel progetto specifico. **5. Salva il nuovo progetto** cliccando **Salva** in alto a destra. Il pulsante rimane disabilitato finché non sono inseriti un nome e almeno un gruppo.**Se rimuovi** delle Classi Oggetto che hanno già delle **istanze create**, queste verranno **nascoste** dal progetto. Questa informazione rimane disponibile in **un'etichetta** in cima alla sezione delle classi oggetto, passandoci sopra con il mouse avrai visibilità di **quali classi oggetto sono state nascoste**.
💡 **Suggerimento:** Prima di salvare, controlla sempre che i gruppi associati siano corretti: solo gli utenti che ne fanno parte avranno accesso al progetto. --- ### Modificare e gestire elementi **Per modificare un progetto**, clicca sul pulsante blu con l'icona di una freccia che compare passando il mouse sull'elemento. Se vuoi **duplicare un progetto**, seleziona un singolo elemento dalla lista, poi clicca il pulsante **Duplica**. Una finestra chiederà quali elementi del progetto includere nella copia. **Per eliminare un progetto**, seleziona uno o più elementi dalla lista: comparirà il pulsante **Elimina**. Per confermare, scrivi il nome del progetto nell'apposito campo. --- ### Collegamenti - [*Gestire gli oggetti nel progetto*](https://wiki.eaglearca.com/books/app-features/page/managing-objects-in-the-project "Managing objects in the project") - [*Gestire i report nel progetto*](https://wiki.eaglearca.com/books/app-features/page/managing-reports-in-the-project "Managing reports in the project") --- ***Last update:** 26 May 2026* # Create and manage Events An Event allows the platform to receive and interpret information (typically JSON) from external providers, linking it to a platform entity such as organizations, projects, objects, sensors, and devices.Available only to users with **backoffice** permission. To create an event, the entities it must be linked to must already exist in the system: project, object, sensor, or device.
--- ### Create a new Event **1.** Log in to the **Backoffice** and open the **Events** section from the left-side menu. The list shows the name, the linked entity, the linked automation, the creation date,and a button to copy the event URL.  **2.** Click **New event** in the top-right corner.  **3.** Enter the **Event name** and select the **Linked to** entity, both fields are required. [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/X0h3-linked-to.png) The available options are: - **Organization** For general events. - **Project** For events specific to a single project. - **Object** For events linked to a class and a single instance. - **Single sensor** For events coming from a single sensor. - **Device** For events generated by a set of sensors. **4.** In the **Mapping** section, define how the incoming data should be interpreted. If needed, **load the sample payload**: paste or upload a JSON file in the text box and click **Confirm** to generate the mapping keys. Loading the JSON is **not required**, you can also fill in the fields **manually**. [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/tGl4-payload-structure.png) Then **map the keys**, associating the provider's keys with the fields required by the platform: - **Name** *(required)* The name of the event. Example: `event_name` or `notification_name`. - **Event ID** *(required)* Uniquely identifies the type of event. Example: `event_id` or `type_code`. - **Time** *(required)* Indicates when the event occurs. Example: `timestamp` or `event_time`. - **Levels** *(required)* Defines the type or severity of the event (`info`, `warning`, `success`, `error`). Each level can have a **Displayed name**, shown when hovering over the level icon. Example: a key like `severity` or `status` mapped to "warning". - **Description** *(required)* Briefly explains the content or purpose of the event. Example: `message` or `details`. - **Additional info** *(optional)* Adds supplementary data, each with an optional **Displayed name**. Example: `temperature`, `battery_status`, `signal_strength`. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/5-mapping.png) Depending on the **linked entity** selected earlier, **additional required fields** may appear: - **Project ID** Links the event to a project. Example: `project_id`. - **Object ID** Links the event to an object; the **object class** must be selected first. Example: `object_id` or `entity_ref`. - **Single Sensor ID** Identifies the sensor the event comes from. Example: `sensor_id` or `sensor_name`. - **Device ID** Identifies the device grouping one or more sensors. Example: `device_id` or `controller_name`. For each mapped key it is also possible to assign a **type**, which defines how the platform should interpret that value. The available types are: - **Text field**: for text values. - **Date**: selectable as date only or date and time. - **Number**: selectable as integer or decimal number. - **True/false**: for boolean values. The type assigned to each field influences the conditions available in the Automations section**.** [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/gg4read-as.png) **5.** If the payload includes **geographic data**, it is possible to **map the coordinates as well**. Enable the switch to configure how the platform should **read the incoming coordinates**. Once enabled, you can choose the format in which the coordinates are transmitted by the provider: - **Single field** The coordinates are contained in a single field of the payload. Enter the field name in **Corresponds to**. - **Double field** Latitude and longitude are transmitted in separate fields. Enter the respective names in the **Latitude corresponds to** and **Longitude corresponds to** fields. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/coordinates-section.png)The Coordinates field is required to enable certain actions in **Automations**, such as the **creation of an object** of type **Point** or the **launch of a robotic mission**.
**6.** Click **Save** in the top-right corner. The button remains disabled until the name, the linked entity, and all required keys have been filled in.Once saved, a **URL link** appears in the list. This link must be **provided to the external provider** to **enable data transmission**.
--- ### Edit and manage events To **edit an event**, click the blue button with the arrow icon that appears when hovering over the item. To **duplicate an event**, select **a single item** from the list, then click the **Duplicate** button in the top-right corner. To **delete an event**, select one or more items from the list, the **Delete** button will appear in the top-right corner. To **copy the URL** of an event, use the dedicated button directly from the list. 💡 **Tips:** - When duplicating an event, update the mapping keys if the target provider uses a different JSON structure. - Use descriptive names for events to make them easier to identify in the list. --- ### Links - *[Create and manage Projects](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-projects "Create and manage Projects")* - *[Managing objects in the project](https://wiki.eaglearca.com/books/app-features/page/managing-objects-in-the-project "Managing objects in the project")* - [Configure Data Sources and Charts](https://wiki.eaglearca.com/books/backoffice/page/configure-data-sources-and-charts "Configure Data Sources and Charts") ---  **Italian version** Un Evento consente alla piattaforma di **ricevere e interpretare informazioni** (tipicamente JSON) da provider esterni, collegandole a un'entità della piattaforma, come organizzazioni, progetti, oggetti, sensori e dispositivi. Per usare gli eventi per **l'invio di notifiche**, puoi configurare gli output dalla *[sezione Automazioni](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-automations "Create and manage Automations")*.Disponibile solo per utenti con permesso **backoffice**. Per creare un evento è necessario che nel sistema siano **già presenti** le entità a cui l’evento deve essere collegato: progetto, oggetto, sensore o dispositivo.
--- ### Creare un nuovo evento **1.** Accedi al **Backoffice** e apri la sezione **Eventi** dal menu laterale sinistro. La lista mostra il nome, l'entità collegata, l'automazione collegata, la data di creazione e un bottone per copiare l'URL dell'evento.  **2.** Clicca su **Nuovo evento** in alto a destra.  **3.** Inserisci il **Nome evento** e seleziona l'**Entità collegata**, entrambi i campi sono obbligatori. [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/X0h3-linked-to.png) Le opzioni disponibili sono: - **Organizzazione** Per eventi generali. - **Progetto** Per eventi specifici di un singolo progetto. - **Oggetto** Per eventi legati a una classe e a una singola istanza. - **Sensore singolo** Per eventi provenienti da un singolo sensore. - **Dispositivo** Per eventi generati da un insieme di sensori. **4.** Nella sezione **Mapping** definisci come i dati in arrivo devono essere interpretati. Se lo ritieni necessario, **carica il payload di esempio**: incolla o carica un file JSON nella casella di testo e clicca **Conferma** per generare le chiavi di mappatura. Inserire il JSON **non è obbligatorio**, puoi inserire i campi anche **manualmente**. [](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/tGl4-payload-structure.png) Poi **mappa le chiavi**, associando le chiavi del provider ai campi richiesti dalla piattaforma: - **Nome** *(obbligatorio)* Il nome dell'evento. Esempio: `event_name` o `notification_name`. - **Event ID** *(obbligatorio)* Identifica in modo univoco il tipo di evento. Esempio: `event_id` o `type_code`. - **Tempo** *(obbligatorio)* Indica il momento in cui l'evento si verifica. Esempio: `timestamp` o `event_time`. - **Livelli** *(obbligatorio)* Definisce la tipologia o gravità dell'evento (`info`, `warning`, `success`, `error`). Ogni livello può avere un **Nome visualizzato**, visibile passando il cursore sull'icona del livello. Esempio: una chiave come `severity` o `status` mappata su "warning". - **Descrizione** *(obbligatoria)* Spiega brevemente il contenuto o lo scopo dell'evento. Esempio: `message` o `details`. - **Informazioni aggiuntive** *(facoltativo)* Aggiunge dati supplementari, ciascuno con un **Nome visualizzato** opzionale. Esempio: `temperature`, `battery_status`, `signal_strength`. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/5-mapping.png) **In base all'entità colegata** selezionata precedentemente, potrebbero aggiungersi **ulteriori campi obbligatori**: - **Project ID** Collega l'evento a un progetto. Esempio: `project_id`. - **Object ID** Collega l'evento a un oggetto; è necessario selezionare prima la **classe oggetto**. Esempio: `object_id` o `entity_ref`. - **Single Sensor ID** Identifica il sensore da cui proviene l'evento. Esempio: `sensor_id` o `sensor_name`. - **Device ID** Identifica il dispositivo che raggruppa uno o più sensori. Esempio: `device_id` o `controller_name`. Per ogni chiave mappata è inoltre possibile assegnare una **tipologia**, che definisce come la piattaforma deve interpretare quel valore. Le tipologie disponibili sono: - **Campo di testo**: per valori testuali. - **Data**: selezionabile come solo data o come data e ora. - **Numero**: selezionabile come numero intero o numero reale. - **Vero/falso**: per valori booleani. La tipologia assegnata a ciascun campo influenza le condizioni disponibili nella sezione Automazioni**.** **[](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/gg4read-as.png)** **5.** Se il payload include **dati geografici**, è possibile **mappare anche le coordinate**. Attiva lo switch per configurare come la piattaforma deve **leggere le coordinate in arrivo**. Una volta attivato, puoi scegliere il formato con cui le coordinate vengono trasmesse dal provider: - **Campo singolo** Le coordinate sono contenute in un unico campo del payload. Inserisci il nome del campo in **Corrisponde a**. - **Doppio campo** Latitudine e longitudine sono trasmesse in campi separati. Inserisci i rispettivi nomi nei campi **Latitudine corrisponde a** e **Longitudine corrisponde a**. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/coordinates-section.png)Il campo Coordinate è necessario per abilitare alcune azioni nelle **Automazioni**, come la **creazione di un oggetto** di tipo **Punto** o l'**avvio di una missione** robotica.
**6.** Per salvare, clicca **Salva** in alto a destra. Il bottone rimane disabilitato finché non sono compilati il nome, l'entità collegata e tutte le chiavi obbligatorie.Una volta salvato, nella lista compare un **link URL** che deve essere **fornito al provider** esterno per **abilitare l'invio dei dati**.
--- ### Modificare e gestire gli eventi Per **modificare un evento**, clicca sul bottone blu con l'icona freccia che compare passando il mouse sull'elemento. Se vuoi **duplicare un evento**, seleziona **un singolo elemento** dalla lista, poi clicca il bottone **Duplica** in alto a destra. Per **eliminare un evento**, seleziona uno o più elementi dalla lista: comparirà il bottone **Elimina** in alto a destra. Per **copiare l'URL** di un evento, usa il bottone apposito direttamente dalla lista. 💡 **Suggerimenti:** - Quando duplichi un evento, aggiorna le chiavi di mappatura se il provider di destinazione ha una struttura JSON diversa. - Usa nomi descrittivi per gli eventi per facilitarne il riconoscimento nella lista. --- ### Collegamenti - *[Creare e gestire i progetti](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-projects "Create and manage Projects")* - *[Gestire gli oggetti nel progetto](https://wiki.eaglearca.com/books/app-features/page/managing-objects-in-the-project "Managing objects in the project")* - [Configurare Sorgenti dati e Grafici](https://wiki.eaglearca.com/books/backoffice/page/configure-data-sources-and-charts "Configure Data Sources and Charts") --- ***Last update**: 26 May 2026* # Create and manage Reports The Report section of the Backoffice allows you to select and configure report templates that will then be used in projects or from the Home to generate downloadable reports. Each template defines the structure, parameters and formats available for generation.Available only to users with **backoffice** permission.
--- ### Create a new Report **1. Access the Backoffice** and click **Report** in the left-side menu.  **2.** Click the **New report** button in the top-right corner. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/nuovo-report.png) **3.** Enter a unique report name in the **Report Name** field (required, maximum 40 characters). **4.** If the report needs to collect data from all projects in the organisation, enable the **Global Report** switch. Global reports are managed from the Home and not from individual projects. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/report-globale.png) **5.** Fill in the fields in the two sections. #### Template section In this section, fields unlock progressively. First select the **category** and then the **type** of report: these two fields help you **identify the most suitable template**. You can then select the **base template** and choose one or more output **formats**. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/CSztemplate-section.png) Once the template has been chosen, you can download it using the **Download base template** button and customise it by adding new sheets to the XLSX file. To use the customised template, re-upload it using the **Upload customised template** button. The uploaded file is shown with its name, upload date and time, and can be downloaded or removed. Removing it will automatically revert to the base template. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/custom-template.png)**Do not modify the first sheet** of the XLSX file: it contains the data structure used by the platform to populate the report.
#### Parameters section Once the template has been selected, the **Parameters** section populates with the parameters to configure, which vary depending on the chosen template. Parameters are divided into two groups, **Inputs** and **Filters**, defined by the template itself: - **Inputs** are configured here in the Backoffice by indicating where the system should retrieve the data from. They may be mandatory. - **Filters** are not configurable: they are shown here so you are aware of their presence, and are filled in by the user in the app at the time of generation to refine the report content. For each filter you can optionally set a **display name**, which is shown to the user in the app to help them fill in the field; if left empty, the system name is used. Filters that are mandatory for the user are marked with the **Required in App** label. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-06/parameters-section.png) For each **Input**, the following fields unlock in sequence to indicate where the system should retrieve the data from: - **Data category** The data category to draw from - **Table or Object Name** The specific table or object class - **Data Field or Property** The specific field or property to use Parameters can be of different types, such as **text**, **numbers**, **true/false**, **date** and **date and time**.The parameter type is indicative in the Backoffice and helps guide the configuration. For **Filters**, it determines the type of field the user will need to fill in at the time of generation in the app.
Changing the category, type or base template after having configured the parameters will **reset the entire parameter configuration**. The system will display a confirmation window before proceeding.
[](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/reset-configuration.png) --- ### Save the Report Click **Save** in the top-right corner to complete the creation. On first save, a window opens to set the **default permission** to assign to the template for all existing roles. This setting can be modified later from the *[Roles page](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-roles "Create and manage Roles")* of the Backoffice. --- ### View and edit Reports The report list shows the following information for each element: - **Name** - **Base template** The selected base template. - **Formats** - **Parameters** Hovering over the number shows all parameters available for that template. - **Projects** Hovering over the number shows the list of projects in which the template has been added; global reports show 0 because they are managed from the Home. - **Creation date** Global reports are recognisable by the globe icon next to their name. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/report-page.png) #### Edit To **edit a report**, click the blue button with the arrow icon that appears when hovering over the element. #### Duplicate To **duplicate a report**, select an element from the list to display the **Duplicate** button in the top-right corner of the page. #### Delete To delete a report, select one or more elements and click the **Delete** button in the top-right corner of the page.Deleting a report template causes the **deletion of all instances** generated from that template in projects and from the Home. The system shows the number of instances involved before proceeding with the confirmation.
[](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/delete-reports.png) --- ### Links - *[Create and manage Projects](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-projects "Create and manage Projects")* - *[Managing reports in the project](https://wiki.eaglearca.com/books/app-features/page/managing-reports-in-the-project "Managing reports in the project")* ---  **Italian version** La sezione **Report** del Backoffice consente di scegliere e configurare i template di report che verranno poi utilizzati nei progetti o dalla Home per generare report scaricabili. Ogni template definisce la struttura, i parametri e i formati disponibili per la generazione.Disponibile solo per utenti con permesso **backoffice**.
--- ### Creare un nuovo Report **1. Accedi al Backoffice** e clicca su **Report** nel menu laterale sinistro.  **2.** Clicca sul pulsante **Nuovo report** in alto a destra. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/nuovo-report.png) **3.** Inserisci un nome univoco del report nel campo **Nome Report** (obbligatorio, massimo 40 caratteri). **4.** Se il report deve raccogliere dati da tutti i progetti dell'organizzazione, attiva lo switch **Global Report**. I report globali vengono gestiti dalla Home e non dai singoli progetti. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/report-globale.png) **5.** Compila i campi delle due sezioni. #### Sezione Template In questa sezione i campi si sbloccano progressivamente. Seleziona prima la **categoria** e poi la **tipologia** del report: questi due campi ti aiutano a **individuare il template più adatto**. A questo punto puoi selezionare il **template base** e scegliere uno o più **formati** di output. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/CSztemplate-section.png) Una volta scelto il template, è possibile scaricarlo tramite il pulsante **Scarica template base** e personalizzarlo aggiungendo nuovi fogli al file XLSX. Per utilizzare il template personalizzato, ricaricalo tramite il pulsante **Carica template personalizzato**. Il file caricato viene mostrato con nome, data e ora di caricamento e può essere scaricato o rimosso. Rimuovendolo si tornerà automaticamente al template base. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/custom-template.png)**Non modificare il primo foglio** del file XLSX: contiene la struttura dati utilizzata dalla piattaforma per popolare il report.
#### Sezione Parametri Una volta selezionato il template, la sezione **Parametri** si popola con i parametri da configurare, che variano in base al template scelto. I parametri si dividono in due gruppi, **Input** e **Filtri**, definiti dal template stesso: - Gli **Input** vengono configurati qui nel Backoffice indicando da dove il sistema deve recuperare il dato. Possono essere obbligatori. - I **Filtri** non sono configurabili: vengono mostrati qui per darti consapevolezza della loro presenza e vengono compilati dall'utente in app al momento della generazione per affinare il contenuto del report. Per ogni filtro puoi facoltativamente impostare un **nome in visualizzazione**, che viene mostrato all'utente in app per aiutarlo nella compilazione del campo; se lasciato vuoto, viene usato il nome di sistema. I filtri obbligatori per l'utente sono contrassegnati dall'etichetta **Required in App**. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-06/parameters-section.png) Per ogni **Input**, i seguenti campi si sbloccano a cascata per indicare da dove il sistema deve recuperare il dato: - **Categoria del dato** La categoria di dati da cui attingere - **Tabella o Nome oggetto** La tabella o la classe oggetto specifica - **Campo del dato o Proprietà** Il campo o la proprietà specifica da utilizzare I parametri possono essere di diversi tipi, come **testo**, **numeri**, **vero/falso**, **data** e **data e ora**.Il tipo di parametro è indicativo nel Backoffice e aiuta a indirizzare la configurazione. Per i **Filtri**, determina il tipo di campo che l'utente dovrà compilare al momento della generazione in app.
Modificare la categoria, la tipologia o il template base dopo aver configurato i parametri **resetterà tutta la configurazione** dei parametri. Il sistema mostrerà una finestra di conferma prima di procedere.
[](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/reset-configuration.png) --- ### Salvare il Report Clicca **Salva** in alto a destra per completare la creazione. Al primo salvataggio si apre una finestra per impostare il **permesso di default** da assegnare al template per tutti i ruoli esistenti. Questa impostazione può essere modificata in seguito dalla *[pagina Ruoli](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-roles "Create and manage Roles")* del Backoffice. --- ### Visualizzare e modificare i Report Nella lista dei report sono visibili le seguenti informazioni per ogni elemento: - **Nome** - **Template base** Il template base selezionato - **Formati** - **Parametri** Passando il mouse sul numero vengono mostrati tutti i parametri disponibili per quel template. - **Progetti** Passando il mouse sul numero viene mostrata la lista dei progetti in cui il template è stato aggiunto; i report globali mostrano 0 perché sono gestiti dalla Home - **Data di creazione** I report globali sono riconoscibili dall'icona del globo accanto al nome. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/report-page.png) #### Modifica Per **modificare un report**, clicca sul pulsante blu con l'icona freccia che appare al passaggio del mouse sull'elemento. #### Duplicazione Se vuoi **duplicare un report**, seleziona un elemento dalla lista per visualizzare il pulsante **Duplica** in alto a destra della pagina. #### Eliminazione Se vuoi eliminare un report puoi selezionare uno o più elementi e cliccare sul pulsante **Elimina** in alto a destra della pagina.Eliminare un template di report comporta l'**eliminazione di tutte le istanze** generate da quel template nei progetti e dalla Home. Il sistema mostra il numero di istanze coinvolte prima di procedere con la conferma.
[](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/delete-reports.png) --- ### Collegamenti - *[Creare e gestire i Progetti](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-projects "Create and manage Projects")* - *[Gestire i report nel progetto](https://wiki.eaglearca.com/books/app-features/page/managing-reports-in-the-project "Managing reports in the project")* --- ***Last update:** 11 June 2026* # Create and manage Automations Automations allow the platform to respond automatically to incoming events, executing one or more actions in sequence, from report generation to the launch of robotic missions.Available only to users with **backoffice-admin** permission.
--- ### Create a new automation **1.** Log in to the Backoffice and open the **Automations** section from the side menu. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/automation-section-button.png) **2.** Click **New Automation** in the upper-right corner. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/new-automation-button.png) **3.** Enter the **name** of the automation in the page header. This field is required. **4.** Select the **groups** to associate with the automation using the multi-search field.Groups define the visibility of the automation in the app. **5.** Set the **status** of the automation using the toggle at the top. It is active by default. If the status is inactive, the configuration sections are locked. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/configuration-header.png) The page is divided into two areas: - **On the left** is the flow summary, with the trigger card and the cards for any added actions - **On the right** is the configuration panel for the selected section [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/automation-timeline-and-configuration.png) The trigger and action cards display their status via an icon: an **exclamation mark on a yellow background** (Pending) indicates a configuration that is **incomplete** or **not yet confirmed**, while a **checkmark on a green background** (Completed) indicates a complete and confirmed configuration.The page has **two distinct save levels**. The **Apply** button confirms the configuration of the **individual section** and updates the card status. The **Save** button in the upper-right corner saves the entire automation definitively.
**6.** *[Configure the trigger ↓](https://wiki.eaglearca.com/link/143#bkmrk-configurare-il-trigg)* to define when the automation should run. **7.** *[Add and configure actions ↓](https://wiki.eaglearca.com/link/143#bkmrk-aggiungere-e-configu)* to choose what the platform should do when the trigger fires. **8.** Save the automation by clicking **Save** in the upper-right corner of the page. The button is enabled only when the name, groups, trigger, and all configured actions are correctly set up and confirmed. 💡 **Tip**: Before saving, make sure all cards are in the Completed state. A card in the Pending state prevents the automation from being saved. --- ### Configure the trigger The trigger defines when the automation should run. It is the first section to complete: until the trigger is configured and confirmed, the button to add actions is not available. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/trigger-configuration.png) **1.** Select the **linked event** from the dropdown menu. The list shows all events configured for the organization. Events already associated with another automation are not available. **2.** If you want the automation to activate only when specific conditions are met, enable the **Filter by field values** toggle. In this case, for each condition you will need to fill in three required fields: - **Field** Select one of the fields mapped in the event. Each field is accompanied by an icon indicating the data type (text, number, date, boolean). - **Condition** Select the condition, for example equal to, greater than, less than, etc. The list of conditions depends on the data type. - **Value** Enter the comparison value [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/conditions.png) You can add more conditions using the **Add condition** button. If multiple conditions are present, all of them must be satisfied simultaneously to activate the trigger. If you don't add any conditions, the automation fires **every time the event is received**. **3.** Click **Apply** to confirm the trigger. The card will move to the **Completed** state and the button to add actions will become available.If you later change the linked event, all already configured conditions will be reset. You can undo the change via **Discard changes** to restore the previous configuration.
--- ### Add and configure actions Once the trigger is confirmed, click **Add action** to choose the type of action to execute. The available actions depend on the entity the event selected in the trigger is linked to. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/select-action.png) If the event is linked to a **project**, an **object**, or a **sensor**, **all action types** are available. If the event is linked to an **organization** or a **device**, only **send notification** is available. The available action types are: - [*Send notification ↓*](https://wiki.eaglearca.com/link/143#bkmrk-invia-notifica) Sends an email or push notification to the selected recipients. - [*Generate report ↓*](https://wiki.eaglearca.com/link/143#bkmrk-genera-report) Automatically generates a report from a configured template. - [*Object class operation ↓*](https://wiki.eaglearca.com/link/143#bkmrk-operazione-su-classe) Creates or updates an instance of an existing object class. - [*Start mission ↓*](https://wiki.eaglearca.com/link/143#bkmrk-avvia-missione) Automatically starts a mission for a drone or a robot dog. Once the type is selected, the configuration panel opens on the right. The configuration is structured in progressive steps: each step unlocks only after the previous one has been completed and confirmed via the **Continue** button. When you have finished configuring the action, click **Apply** to add it to the flow. The action card will appear in the left column with a summary of the main settings. For each action you must also define the **error behavior**, choosing whether the system should **continue with the next action** or **stop the entire automation**. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/error-behavior.png) You can add an unlimited number of actions. To change the execution order, drag the cards up or down in the left column. The order in which the cards appear corresponds to the actual execution order. 💡 **Tips**: - If the actions are independent of each other, choose to continue with the next action to prevent a single issue from blocking the entire flow - If the actions are chained and depend on one another, choose to stop the automation to avoid inconsistent partial executions #### Send notification Configure the automatic sending of an email or push notification. **1.** Select the **notification type**: Email or Push. Each action handles a single channel. To send both email and push, add two separate actions. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/notification-type-selection.png) **2.** Click **Continue** to access the **Recipients** section. **3.** You can add optional conditions to limit delivery to specific occurrences of the event, filtering by severity level (info, warning, success, error) or by specific event name. **4.** Add the **recipients** by selecting users or groups. For email notifications you can also add external email addresses. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/recipients-panel.png) **5.** Click **Apply** to confirm. #### Generate report Configure the automatic generation of a report. **1.** Select the **report template** from the dropdown menu. The list shows the templates available in the Reports section of the Backoffice. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/report-template-selection.png) **2.** Click **Continue** to access the **Parameters mapping** section. **3.** Choose how to populate each template parameter: with the **event field**, where the value is read from a field of the received event that you will select from a dropdown menu, or with a **static value**, by entering a fixed value manually. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/parameters-mapping.png) **Required parameters** are marked with an asterisk and must all be populated. A counter updated in real time showing the missing parameters is displayed at the top. A search bar allows you to filter the parameter list. **4.** Click **Apply** to confirm.If you **change the report template**, the parameter configuration will be **reset** because the available parameters depend on the selected template.
#### Object class operation Configure the automatic creation or update of an object class instance. **1.** Select the **object class** from the dropdown menu. **2.** Select the **operation** to perform: - **Create object** Creates a new instance of the class. Available for classes of **type Point and Form**. - **Modify object** Updates an existing instance. Available for all class types. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/ptxobject-class-selection.png)The **Point creation** action is only available if the linked event has a coordinates field correctly configured.
**3.** Click **Continue** to access the **Attributes mapping** section. **4.** Choose how to populate each class attribute: with the **event field**, where the value is read from a field of the received event that you will select from a dropdown menu, or with a **static value**, by entering a fixed value manually. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/attribute-mapping.png) **Required attributes** are marked with an asterisk and must all be populated. A counter updated in real time showing the missing attributes is displayed at the top. A search bar allows you to filter the attribute list. For classes of type **Point**, the **Coordinates** field is managed automatically: during creation it is populated from the coordinates field configured in the event and cannot be edited manually. During a modification it is optional. For the **Modify object** operation, the **Unique identifier** field is required to indicate which instance to update. It can be mapped from an event field or entered as a static value. **5.** Click **Apply** to confirm.If you **change the object class**, the attribute mapping will be **reset** and the selected operation will be invalidated.
#### Start mission Configure the automatic launch of a robotic mission.This action is only available if the linked event has a coordinates field correctly configured.
**1.** Select the **unit type**: **Robot Dog** or **Drone**. **2.** Select the specific **unit**. For a drone, you must also select the associated **hangar**: the drone + hangar pair is treated as the unique reference for the action. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/mission-unit-selection.png) **3.** Click **Continue** to access the **Mission setup** section. The fields to fill in vary depending on the selected unit. For **Robot Dog**: - **Mission name** - **Mission type** - **Profile** - **Mission map**, selectable via the **Browse map** button, which opens a viewer where you can **search**, **select**, and **preview** the **maps available for the organization**. Only outdoor maps are shown - **Notes** (optional) For **Drone**: - **Mission name** - **Take-off safety height** - **Take-off speed** - **Global height** - **Global speed** - **Profile** - **Notes** (optional) [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/mission-setup.png) **4.** Click **Continue** to access the **Waypoint actions** section. The waypoint coordinates are populated automatically from the coordinates field configured in the event and cannot be edited manually. Using the **Add action** button you can configure one or more actions for the unit to perform at the target point. The available actions depend on the selected profile and the add-ons associated with the unit. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/waypoints-actions.png) **5.** Before you can confirm, you must read and explicitly select all the **operational disclaimers** shown at the bottom of the section. These notices concern the responsibilities related to the automatic execution of the mission and the option to force the launch even in the presence of warnings detected during the pre-check. **6.** Click **Apply** to confirm.You can add multiple start mission actions within the same automation, provided they do not reference the same unit. For drones, the same drone + hangar pair cannot be used more than once.
If the unit is busy with another mission at the time of execution, the action is interrupted. No override mechanism for the ongoing mission is available.
--- ### View and manage automations The list shows all configured automations with the following information: - **Name** of the automation - **Status** active or inactive, shown via icon - **Actions** total number of configured actions; hovering over the number shows the list in execution order - **Creation date** The list can be viewed in table, grid, or list mode. Two warning states may appear in the list: - **Warning icon next to the name** The automation is saved but has no actions configured yet. - **Alert icon next to the name** The event linked to the trigger has been deleted. The automation is automatically deactivated and cannot run until a new valid event is selected. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/automation-section.png) To edit an automation, click the blue button with the arrow icon that appears when hovering over the item. When you edit a section, the related card returns to the **Pending** state. You can confirm the changes via **Apply** or discard them via **Discard changes**, which restores the last saved configuration. If you **edit** a field that **affects subsequent configurations**, such as the unit type in a mission or the object class in an operation, the dependent steps are **automatically reset** and must be **reconfigured**. You can also change the **action order** by dragging the cards, and **add** or **remove** individual actions.Changes are **not final** until the automation is saved.
--- ### Delete an automation From the main list, **select one or more automations** and click the **Delete** button. The system shows a **confirmation dialog** with the names of the selected automations and a warning that all actions configured within them will stop running.Deleting an automation permanently removes the trigger, all conditions, and all actions configured within it. **This action cannot be undone.**
--- ### What happens when the linked event is deleted If an event used by an automation is deleted, the system flags this before proceeding with the deletion, indicating that the affected automation will be deactivated. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/delete-event-modal.png) If the deletion is confirmed, the automation is automatically set to inactive and the trigger is considered unconfigured. The alert icon appears next to the name in the list. To restore the automation, open it, activate it using the status toggle, and select a new valid event in the trigger. Events that are not compatible with the already configured actions are disabled in the dropdown menu. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/event-selection-pt-2.png) --- ### Links - *[Create and manage Events](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-events "Create and manage Events")* - *[Create and manage Reports](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-reports "Create and manage Reports")* - *[Create and manage Object Classes](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-object-classes "Create and manage Object Classes")* - [Mission Planner - Initial Setup](https://wiki.eaglearca.com/books/mission-planner-wR9/page/initial-setup "Mission Planner - Initial Setup") ---  **Italian version** Le automazioni consentono alla piattaforma di rispondere automaticamente alla ricezione di un evento, eseguendo una o più azioni in sequenza, dalla generazione di report all'avvio di missioni robotiche.Disponibile solo per utenti con permesso **backoffice-admin**.
--- ### Creare una nuova automazione **1.** Accedi al Backoffice e apri la sezione **Automazioni** dal menu laterale. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/automation-section-button.png) **2.** Clicca su **Nuova automazione** in alto a destra. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/new-automation-button.png) **3.** Inserisci il **nome** dell'automazione nell'intestazione della pagina. Il campo è obbligatorio. **4.** Seleziona i **gruppi** a cui associare l'automazione tramite il campo di ricerca multipla. I gruppi definiscono la visibilità dell'automazione nell'app. **5.** Imposta lo **stato** dell'automazione tramite l'interruttore in alto. Di default è attivo. Se lo stato è disattivo, le sezioni di configurazione risultano bloccate. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/configuration-header.png) La pagina è divisa in due aree: - **A sinistra** si trova il riepilogo del flusso, con la scheda del trigger e le schede delle azioni aggiunte - **A destra** si trova il pannello di configurazione della sezione selezionata [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/automation-timeline-and-configuration.png) Le schede del trigger e delle azioni mostrano il loro stato tramite un'icona, il **punto esclamativo su sfondo giallo** (In attesa) rappresenta una configurazione **incompleta** o **non ancora confermata**, la **spunta su sfondo verde** (Completato) rappresenta una configurazione completa e confermata.All'interno della pagina sono presenti **due livelli di salvataggio distinti**. Il pulsante **Applica** conferma la configurazione della **singola sezione** e aggiorna lo stato della scheda. Il pulsante **Salva** in alto a destra salva l'intera automazione in modo definitivo.
**6.** *[Configura il trigger ↓](https://wiki.eaglearca.com/link/143#bkmrk-configurare-il-trigg-1)* per stabilire quando l'automazione dovrà essere eseguita. **7.** [*Aggiungi e configura le azioni* ↓](https://wiki.eaglearca.com/link/143#bkmrk-aggiungere-e-configu-1) per scegliere cosa la piattaforma dovrà fare a seguito del trigger. **8.** Salva l'automazione cliccando **Salva** in alto a destra della pagina. Il pulsante è abilitato solo quando nome, gruppi, trigger e tutte le azioni presenti sono correttamente configurati e confermati. 💡 **Suggerimento**: Prima di salvare, verifica che tutte le schede siano nello stato Completato. Una scheda in stato In attesa impedisce il salvataggio dell'automazione. --- ### Configurare il trigger Il trigger definisce quando l'automazione deve essere eseguita. È la prima sezione da completare: finché il trigger non è configurato e confermato, il pulsante per aggiungere azioni non è disponibile. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/trigger-configuration.png) **1.** Seleziona l'**evento collegato** dal menu a tendina. La lista mostra tutti gli eventi configurati per l'organizzazione. Gli eventi già associati a un'altra automazione non sono disponibili. **2.** Se vuoi che l'automazione si attivi solo al verificarsi di condizioni specifiche, abilita l'interruttore **Filtra per valori del campo**. In questo caso, per ogni condizione, dovrai compilare tre campi obbligatori: - **Campo** Seleziona uno dei campi mappati nell'evento. Ogni campo è accompagnato da un'icona che indica il tipo di dato (testo, numero, data, booleano). - **Condizione** Seleziona la condizione, per esempio uguale, maggiore, minore, ecc. La lista delle condizioni dipende dal tipo di dato. - **Valore** Inserisci il valore di confronto [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/conditions.png) Puoi aggiungere più condizioni tramite il pulsante **Aggiungi condizione**. Se sono presenti più condizioni, per attivare il trigger devono essere tutte soddisfatte contemporaneamente. Se non aggiungi condizioni, l'automazione si avvia **ogni volta che l'evento viene ricevuto**. **3.** Clicca **Applica** per confermare il trigger. La scheda passerà allo stato **Completato** e si abiliterà il pulsante per aggiungere azioni.Se in seguito modifichi l'evento collegato, tutte le condizioni già configurate vengono azzerate. Puoi annullare la modifica tramite **Scarta modifiche** per ripristinare la configurazione precedente.
--- ### Aggiungere e configurare le azioni Dopo aver confermato il trigger, clicca su **Aggiungi azione** per scegliere il tipo di azione da eseguire. Le azioni disponibili dipendono dall'entità a cui è collegato l'evento selezionato nel trigger. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/select-action.png) Se l'evento è collegato a un **progetto**, un **oggetto** o un **sensore**, sono disponibili **tutti i tipi di azione**. Se l'evento è collegato a un'**organizzazione** o a un **dispositivo**, è disponibile solo l'**invio di notifiche**. I tipi di azione disponibili sono: - [*Invia notifica ↓*](https://wiki.eaglearca.com/link/143#bkmrk-invia-notifica-1) Invia una notifica email o push ai destinatari selezionati. - [*Genera report ↓*](https://wiki.eaglearca.com/link/143#bkmrk-genera-report-1) Genera automaticamente un report a partire da un template configurato. - [*Operazione su classe oggetto ↓*](https://wiki.eaglearca.com/link/143#bkmrk-operazione-su-classe-1) Crea o modifica un'istanza di una classe oggetto esistente. - [*Avvia missione ↓*](https://wiki.eaglearca.com/link/143#bkmrk-avvia-missione-1) Avvia automaticamente una missione per un drone o un robot dog Una volta selezionato il tipo, il pannello di configurazione si apre a destra. La configurazione è strutturata in step progressivi: ogni step successivo si sblocca solo dopo aver completato e confermato il precedente tramite il pulsante **Continua**. Quando hai terminato la configurazione dell'azione, clicca **Applica** per aggiungerla al flusso. La scheda dell'azione apparirà nella colonna di sinistra con un riepilogo delle impostazioni principali. Per ogni azione devi anche definire il **comportamento in caso di errore**, scegliendo se il sistema deve **continuare con l'azione successiva** oppure **interrompere l'intera automazione**. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/error-behavior.png) Puoi aggiungere un numero illimitato di azioni. Per cambiare l'ordine di esecuzione, trascina le schede verso l'alto o verso il basso nella colonna di sinistra. L'ordine in cui le schede compaiono corrisponde all'ordine effettivo di esecuzione. 💡 **Suggerimenti**: - Se le azioni sono indipendenti tra loro, scegli di continuare con l'azione successiva per evitare che un singolo problema blocchi l'intero flusso - Se le azioni sono concatenate e dipendono l'una dall'altra, scegli di interrompere l'automazione per evitare esecuzioni parziali incoerenti #### Invia notifica Configura l'invio automatico di una notifica email o push. **1.** Seleziona il **tipo di notifica**: Email o Push. Ogni azione gestisce un solo canale. Per inviare sia email che push, aggiungi due azioni separate. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/notification-type-selection.png) **2.** Clicca **Continua** per accedere alla sezione **Destinatari**. **3.** Puoi aggiungere condizioni opzionali per limitare l'invio solo ad alcune occorrenze dell'evento, filtrandole per livello di severità (info, avviso, successo, errore) o per nome evento specifico. **4.** Aggiungi i **destinatari** selezionando utenti o gruppi. Per le notifiche email puoi aggiungere anche indirizzi email esterni. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/recipients-panel.png) **5.** Clicca **Applica** per confermare. #### Genera report Configura la generazione automatica di un report. **1.** Seleziona il **template di report** dal menu a tendina. La lista mostra i template disponibili nella sezione Report del Backoffice. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/report-template-selection.png) **2.** Clicca **Continua** per accedere alla sezione **Mappatura parametri**. **3.** Scegli come popolare ogni parametro del template, se con il **campo dell'evento**, il valore viene letto da un campo dell'evento ricevuto che dovrai selezionare da un menu a tendina, oppure con un **valore statico**, inserendo manualmente un valore fisso. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/parameters-mapping.png) I **parametri obbligatori** sono contrassegnati da un asterisco e devono essere tutti popolati. In alto viene mostrato un contatore aggiornato in tempo reale con i parametri mancanti. Una barra di ricerca consente di filtrare la lista dei parametri. **4.** Clicca **Applica** per confermare.Se **modifichi il template di report**, la configurazione dei parametri viene **azzerata** perché i parametri disponibili dipendono dal template selezionato.
#### Operazione su classe oggetto Configura la creazione o la modifica automatica di un'istanza di una classe oggetto. **1.** Seleziona la **classe oggetto** interessata dal menu a tendina. **2.** Seleziona l'**operazione** da eseguire tra: - **Crea oggetto** Crea una nuova istanza della classe. Disponibile per classi di **tipo Punto e Form**. - **Modifica oggetto** Aggiorna un'istanza esistente. Disponibile per tutti i tipi di classe. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/ptxobject-class-selection.png)L'azione di **creazione di un Punto** è disponibile solo se l'evento collegato ha un campo coordinate correttamente configurato.
**3.** Clicca **Continua** per accedere alla sezione **Mappatura attributi**. **4.** Scegli come popolare ogni attributo della classe, se con il **campo dell'evento**, il valore viene letto da un campo dell'evento ricevuto che dovrai selezionare da un menu a tendina, oppure con un **valore statico**, inserendo manualmente un valore fisso. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/attribute-mapping.png) Gli **attributi obbligatori** sono contrassegnati da un asterisco e devono essere tutti popolati. In alto viene mostrato un contatore aggiornato in tempo reale con gli attributi mancanti. Una barra di ricerca consente di filtrare la lista degli attributi. Per le classi di tipo **Punto**, il campo **Coordinate** è gestito automaticamente: in fase di creazione viene popolato a partire dal campo coordinate configurato nell'evento e non è modificabile manualmente. In fase di modifica è opzionale. Per l'operazione **Modifica oggetto** è obbligatorio configurare il campo **Identificatore univoco**, che indica quale istanza aggiornare. Può essere mappato da un campo evento o inserito come valore statico. **5.** Clicca **Applica** per confermare.Se **modifichi la classe oggetto**, la mappatura degli attributi viene **azzerata** e l'operazione selezionata viene invalidata.
#### Avvia missione Configura l'avvio automatico di una missione robotica.Questa azione è disponibile solo se l'evento collegato ha un campo coordinate correttamente configurato.
**1.** Seleziona il **tipo di unità** tra **Robot Dog** e **Drone.** **2.** Seleziona l'**unità** specifica. Nel caso di un drone, devi selezionare anche l'**hangar** associato: la coppia drone + hangar viene trattata come riferimento unico dell'azione. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/mission-unit-selection.png) **3.** Clicca **Continua** per accedere alla sezione **Configurazione missione**. I campi da compilare variano in base all'unità selezionata. Per **Robot Dog**: - **Nome** della missione - **Tipologia missione** - **Profilo** - **Mappa missione**, selezionabile tramite il pulsante **Sfoglia mappa**, che apre un visualizzatore dove puoi **cercare**, **selezionare** e **visualizzare** in anteprima le **mappe disponibili per l'organizzazione**. Sono mostrate solo le mappe di tipo outdoor - **Note** (opzionale) Per **Drone**: - **Nome** della missione - **Altezza di sicurezza al decollo** - **Velocità di decollo** - **Altezza globale** - **Velocità globale** - **Profilo** - **Note** (opzionale) [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/mission-setup.png) **4.** Clicca **Continua** per accedere alla sezione **Azioni sul waypoint**. Le coordinate del waypoint vengono popolate automaticamente a partire dal campo coordinate configurato nell'evento e non sono modificabili manualmente. Tramite il pulsante **Aggiungi azione** puoi configurare una o più azioni che l'unità deve eseguire sul punto target. Le azioni disponibili dipendono dal profilo selezionato e dagli add-on associati all'unità. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/waypoints-actions.png) **5.** Prima di poter confermare, devi leggere e selezionare esplicitamente tutti i **disclaimer operativi** mostrati in fondo alla sezione. Questi avvisi riguardano le responsabilità legate all'esecuzione automatica della missione e la possibilità di forzare l'avvio anche in presenza di avvisi rilevati durante il pre-controllo. **6.** Clicca **Applica** per confermare.Puoi aggiungere più azioni di avvio missione nella stessa automazione, a condizione che non facciano riferimento alla stessa unità. Per i droni, la stessa coppia drone + hangar non può essere usata più di una volta.
Se al momento dell'esecuzione l'unità è occupata in un'altra missione, l'azione viene interrotta. Non è previsto alcun meccanismo di override della missione in corso.
--- ### Visualizzare e modificare le automazioni La lista mostra tutte le automazioni configurate con le seguenti informazioni: - **Nome** dell'automazione - **Stato** attivo o disattivo, mostrato tramite icona - **Azioni** numero totale di azioni configurate; passando il mouse sul numero, viene mostrato l'elenco in ordine di esecuzione - **Data di creazione** La lista può essere visualizzata in modalità tabella, griglia o elenco. Nella lista possono comparire due stati di attenzione: - **Icona di avviso accanto al nome** L'automazione è salvata ma non ha ancora azioni configurate. - **Icona di allerta accanto al nome** L'evento collegato al trigger è stato eliminato. L'automazione viene automaticamente disattivata e non può essere eseguita finché non viene selezionato un nuovo evento valido. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/automation-section.png) Per modificare un'automazione, clicca sul pulsante blu con l'icona freccia che appare al passaggio del mouse sull'elemento. Quando modifichi una sezione, la relativa scheda torna allo stato **In attesa**. Puoi confermare le modifiche tramite **Applica** oppure annullarle tramite **Scarta modifiche**, che ripristina l'ultima configurazione salvata. Se **modifichi** un campo che ha **impatto su configurazioni successive**, ad esempio il tipo di unità in una missione o la classe oggetto in un'operazione, gli step dipendenti vengono **automaticamente azzerati** e devono essere **riconfigurati**. Puoi anche modificare l'**ordine delle azioni** trascinando le schede, e **aggiungere** o **rimuovere** azioni singole.Le modifiche **non sono definitive** fino al salvataggio dell'automazione.
--- ### Eliminare un'automazione Dalla lista principale, **seleziona una o più automazioni** e clicca sul pulsante **Elimina**. Il sistema mostra una **finestra di conferma** con il nome delle automazioni selezionate e un avviso che tutte le azioni configurate al loro interno cesseranno di essere eseguite.Eliminando un'automazione vengono rimossi definitivamente anche il trigger, tutte le condizioni e tutte le azioni configurate al suo interno. **L'operazione è irreversibile.**
--- ### Cosa succede quando l'evento collegato viene eliminato Se un evento utilizzato da un'automazione viene eliminato, il sistema lo segnala prima di procedere con la cancellazione, indicando che l'automazione coinvolta verrà disattivata. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/delete-event-modal.png) Se si conferma l'eliminazione, l'automazione passa automaticamente allo stato disattivo e il trigger risulta non configurato. Nella lista compare l'icona di allerta accanto al nome. Per ripristinare l'automazione, aprila, attivala tramite l'interruttore di stato e seleziona un nuovo evento valido nel trigger. Gli eventi non compatibili con le azioni già configurate risultano disabilitati nel menu a tendina. [](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/event-selection-pt-2.png) --- ### Collegamenti - *[Creare e gestire gli Eventi](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-events "Create and manage Events")* - *[Creare e gestire i Report](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-reports "Create and manage Reports")* - *[Creare e gestire le Classi Oggetto](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-object-classes "Create and manage Object Classes")* - [Mission Planner - Setup iniziale](https://wiki.eaglearca.com/books/mission-planner-wR9/page/initial-setup "Mission Planner - Initial Setup") --- ***Last update:** 27 May 2026*