# Backoffice The **Backoffice** is the configuration environment of EagleArca. From here, the structure of data and permissions is managed. It allows you to define all the rules that determine how the platform works and what each user can view or modify. It serves to create the foundation on which the projects operate, keeping the data consistent and the operations under control. Il **Backoffice** è l’ambiente di configurazione di EagleArca. Da qui si gestiscono la struttura dei dati e i permessi. Consente di definire tutte le regole che determinano come la piattaforma funziona e cosa può vedere o modificare ciascun utente. Serve per creare la base su cui operano i progetti, mantenendo i dati coerenti e le operazioni sotto controllo. # Create and manage Users In the Backoffice, you can create and manage user accounts for the organization. Each user account corresponds to a user authorized to access the app or the backoffice, depending on the permissions assigned.

[ ](https://wiki.eaglearca.com/link/133#bkmrk-%C2%A0italian-version%C2%A0)

---

![jQPeng.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/KKPjqpeng.png) **English version** In the **Backoffice**, you can create and manage **user accounts** for the organization. Each user account corresponds to a user authorized to access the **app** or the **backoffice**, depending on the permissions assigned.

Available only to users with `backoffice-admin` permissions.

--- ### Create a new user account **1.** Log in to the **Backoffice** and open the **Users** section. [![1 - Tab Icon Users.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/r5o1-tab-icon-users.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/r5o1-tab-icon-users.png) **2.** Click **New User** in the upper-right corner. [![2 - Button New User.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/Upt2-button-new-user.png)](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. [![3 - Text Field (New User).png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/g3D3-text-field-new-user.png)](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. [![4 - Checkbox App EA.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/HT04-checkbox-app-ea.png)](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 [![5 - Backoffice permission.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/arv5-backoffice-permission.png)](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. [![7 - User Card Hovered.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/8PH7-user-card-hovered.png)](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")* --- ![flag-italy-1f1ee-1f1f9.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/aiMflag-italy-1f1ee-1f1f9.png) **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**. ![1 - Tab Icon Users.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/r5o1-tab-icon-users.png) **2.** Clicca su **Nuovo utente** in alto a destra. [![2 - Button New User.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/Upt2-button-new-user.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/Upt2-button-new-user.png) **3.** Compila i campi **Email, Nome, Cognome, Username**. [![3 - Text Field (New User).png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/g3D3-text-field-new-user.png)](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. [![4 - Checkbox App EA.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/HT04-checkbox-app-ea.png)](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 [![5 - Backoffice permission.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/arv5-backoffice-permission.png)](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/accesso-alla-piattaforma "Accesso alla piattaforma") con il link per impostare la password. --- ### Gestione e licenze Per **modificare un’utenza**, clicca sul bottone blu con l'icona di una freccia, che appare al passaggio del mouse sull'elemento. ![7 - User Card Hovered.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/8PH7-user-card-hovered.png) Ogni organizzazione dispone di un numero limitato di **licenze**: una per frontoffice e una per backoffice. Se un utente accede a entrambi, consuma due licenze. Quando le **licenze sono esaurite**, il bottone Crea nuova utenza **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.

[ ](https://wiki.eaglearca.com/link/136#bkmrk-%C2%A0italian-version%C2%A0)

---

![jQPeng.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/KKPjqpeng.png) **English version** **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**. ![1 - Tab Button Object Class.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/STI1-tab-button-object-class.png) **2.** Click the **New Object** button. ![2 - Button New Object.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/yCJ2-button-new-object.png) **3. Enter the Name** (unique) and choose the object **Type**: [![3 - Type.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/XNw3-type.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/XNw3-type.png)

- **Point:** Vector object, defined by coordinates. - **Line:** Vector object, defined by length. - **Polygon:** Vector object, defined by area. - **Form:** Non-vector object, with no position on the map and no style.

#### Advanced Settings Depending on the selected object type, additional configuration options may be available. If the type is **Point**, you can enable **Oriented Point** to store and represent the object direction on the map. This option automatically adds a **non-editable system attribute**. If the type is **Form**, you can enable **Global Form** to create objects that can be linked to any project and managed from the **Global List** section. --- ### Configure the Default Style (Vector Objects Only) The defined style is the **default style** inherited by all instances.

[![5 - Object Style.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/mLD5-object-style.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/mLD5-object-style.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

💡 **Tip**: Maintain the visual hierarchy, for example by using thicker main lines than secondary lines and a semi-transparent fill for the polygons. --- ### Add and Configure Attributes The system attribute **ID / Unique Identifier** is locked and cannot be deleted. To create a new attribute, click the **Add attribute** button in the upper-right corner. ![5 - Button Add Attribute](https://wiki.eaglearca.com/uploads/images/gallery/2026-01/5-button-add-attribute.png) For each attribute, enter the **System Nam**e (required) and, if necessary, the **Display Name** (optional). Then select the attribute type and choose or create an **Attribute Group**. After setting up the main fields, configure the properties available for the selected type. Each attribute type can have specific settings and different properties.

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.

### Other Object Class Configurations In addition to the main structure and attributes, an Object Class can include additional configurations available from the dedicated tabs in the edit page. From these sections, you can configure [*relationships with other Object Classes*](https://wiki.eaglearca.com/books/backoffice/page/configure-relations-between-objects "Configure relations between objects"), associate [*Data Sources and charts*](https://wiki.eaglearca.com/books/backoffice/page/configure-data-sources-and-charts "Configure Data Sources and Charts") to display data collected over time, and define settings for the [*automatic creation of objects*](https://wiki.eaglearca.com/books/backoffice/page/configure-automatic-object-creation "Configure automatic object creation").

--- ### Save the Object Class Click the **Save** button in the top-right corner of the page. Saving is disabled until all required fields are completed. When saving for the first time, a **permission setup modal** opens. - Select the **default permission** to assign to the Object Class. - The selected permission is applied to **all existing roles**. - These settings can be **modified later** from the **Roles page** in the Backoffice. Click **Save** to confirm and complete the class creation. --- ### Viewing and Editing Object Classes **To edit an Object Class**, click the blue button with the arrow icon, which appears when hovering over the element. **To duplicate an Object Class**, select an element from the list. After selection, the **Duplicate** button appears. **To delete one or more Object Classes**, select one or more elements from the list. After selection, the **Delete** button appears. --- ### Links - *[Introduction to Object Classes](https://wiki.eaglearca.com/books/access-and-overview/page/introduction-to-object-classes "Introduction to Object Classes")* - *[Creare e gestire i progetti](https://wiki.eaglearca.com/books/backoffice/page/creare-e-gestire-i-progetti "Creare e gestire i progetti")* --- ![flag-italy-1f1ee-1f1f9.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/aiMflag-italy-1f1ee-1f1f9.png) **Italian version** **Creare una Classe Oggetto** consente di definire la struttura dati e la natura geometrica degli oggetti che verranno utilizzati nei progetti di EagleArca.

Disponibile solo per utenti con permesso `backoffice`.

--- ### Creare la Classe **1.** Accedi **al Backoffice** e naviga in **Classi Oggetto**. ![1 - Tab Button Object Class.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/STI1-tab-button-object-class.png) **2.** Clicca sul bottone **Nuovo oggetto**. ![2 - Button New Object.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/yCJ2-button-new-object.png) **3. Inserisci il Nome** (univoco) e **scegli il Tipo** di oggetto: [![3 - Type.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/XNw3-type.png)](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. [![5 - Object Style.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/mLD5-object-style.png)](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

💡 **Suggerimento**: Mantieni la gerarchia visiva, ad esempio utilizzando linee principali più spesse delle secondarie e un *fill* semi-trasparente per i poligoni. --- ### Aggiungere e Configurare gli Attributi L'attributo di sistema **ID / Identificatore Unico** è bloccato e non eliminabile. Per creare un nuovo attributo, clicca sul bottone **Aggiungi attributo** in alto a destra. ![5 - Button Add Attribute](https://wiki.eaglearca.com/uploads/images/gallery/2026-01/5-button-add-attribute.png) Per ogni attributo inserisci il **Nome di sistema** (obbligatorio) e, se lo ritieni necessario necessario, il **Nome in visualizzazione** (facoltativo). Seleziona poi il tipo di attributo e scegli o crea un **Gruppo attributi**. Dopo aver impostato i campi principali, configura le proprietà disponibili per la tipologia scelta. Ogni tipo di attributo può avere impostazioni specifiche e proprietà diverse.

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.

[![6 - Attribute Configuration.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/0dj6-attribute-configuration.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/0dj6-attribute-configuration.png) Puoi riordinare gli attributi trascinando le card nella posizione desiderata. 💡 **Suggerimento**: Usa un Attributo Principale significativo, scegliendo un attributo univoco per identificare rapidamente le istanze. --- ### Configurare Stili Condizionali *(Opzionale)* Gli stili condizionali modificano automaticamente l’aspetto o la visibilità in base ai valori degli attributi. [![13 - Conditional Styles.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/JiD13-conditional-styles.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/JiD13-conditional-styles.png) #### A. Stile Classico (per Categorie/Stati) Ideale per evidenziare stati distinti (es. Verificato/Da verificare). **1.** Clicca **Aggiungi Stile**. ![7 - Add Style.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/DoL7-add-style.png) **2.** Clicca **Aggiungi condizione** e definisci Attributo + Valore. [![8 - Add Condition.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/y3p8-add-condition.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/y3p8-add-condition.png) **3.** Scegli la logica tra le condizioni: **Tutte le condizioni** o **Almeno una condizione**. [![9 - The Style Apply.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/MVP9-the-style-apply.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/MVP9-the-style-apply.png) **4. Modifica lo stile** (geometria, colore, pattern) da applicare. #### B. Stile con Range di Valori (per Grandezze Continue) Ideale per rappresentare un andamento continuo (es. altezza, indice). **1.** Clicca **Aggiungi Range di valori**. ![10 - Add value range.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/Lq410-add-value-range.png) **2.** Seleziona l'**attributo** (numerico, data o dimensione). **3.** Definisci i **valori di stop** (min/max) e personalizza lo stile per ciascuno stop (colore, trasparenza, ecc.). [![11 - Gradient Stop.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/11-gradient-stop.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/11-gradient-stop.png) **4.** Verifica la transizione con lo **slider nella preview**. [![12 - Preview.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/xZR12-preview.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/xZR12-preview.png) 💡 **Suggerimento**: Utilizza gli stili condizionali se vuoi che il cambio di stile sia immediatamente interpretabile, o per evidenziare stati e soglie. --- ### Altre configurazioni della Classe Oggetto Oltre alla struttura principale e agli attributi, la Classe Oggetto può includere configurazioni aggiuntive disponibili dalle tab dedicate nella pagina di modifica. Da queste sezioni è possibile configurare le [*relazioni con altre Classi Oggetto*](https://wiki.eaglearca.com/books/backoffice/page/configure-relations-between-objects "Configure relations between objects"), associare [*Data Sources e grafici*](https://wiki.eaglearca.com/books/backoffice/page/configure-data-sources-and-charts "Configure Data Sources and Charts") per visualizzare dati raccolti nel tempo, e definire impostazioni per la [*creazione automatica degli oggetti*](https://wiki.eaglearca.com/books/backoffice/page/configure-automatic-object-creation "Configure automatic object creation"). --- ### Salvare la Classe Oggetto Clicca il bottone **Salva** in alto a destra della pagina. Il salvataggio è disabilitato finché tutti i requisiti obbligatori non sono soddisfatti. Al primo salvataggio, si apre un **modale di impostazione dei permessi**. - Seleziona il **permesso di default** da assegnare alla Classe Oggetto. - Il permesso scelto viene applicato **a tutti i ruoli esistenti**. - Le impostazioni possono essere **modificate in seguito** dalla *[pagina Ruoli ](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-roles "Create and manage Roles")*del Backoffice. Salva per confermare e completare la creazione della classe. --- ### Visualizzazione e Modifica delle Classi Oggetto **Per modificare una Classe Oggetto**, clicca sul bottone blu con l'icona di una freccia, che appare al passaggio del mouse sull'elemento. **Per duplicare una Classe Oggetto**, seleziona un elemento dalla lista. Dopo la selezione, compare il bottone **Duplica**. **Per eliminare una o più Classi Oggetto**, seleziona uno o più elementi dalla lista. Dopo la selezione, compare il bottone **Elimina**. --- ### Collegamenti - *[Introduzione alle Classi Oggetto](https://wiki.eaglearca.com/books/access-and-overview/page/introduction-to-object-classes "Introduction to Object Classes")* - *[Creare e gestire i progetti](https://wiki.eaglearca.com/books/backoffice/page/creare-e-gestire-i-progetti "Creare e gestire i progetti")* --- ***Last update:** 07 May 2026* # Configure relations between objects Relations are an attribute type that allows you to connect objects belonging to different object classes, creating structured links between the elements of the project.

[ ](https://wiki.eaglearca.com/link/138#bkmrk-%C2%A0italian-version%C2%A0)

---

![jQPeng.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/KKPjqpeng.png) **English version** Relations are an **attribute type** that allows you to **connect objects belonging to different object classes**, creating structured links between the elements of the project. This function allows you to represent logical relationships between instances. For example, you can connect **a road to the lighting poles** along its route, or associate a **road with the road signs** installed along it. Relations are configured during the [**creation or editing of an object class**](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-object-classes "Create and manage Object Classes"), inside a dedicated section.

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. ![1 - Tab Relations.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/qHT1-tab-relations.png) To create a new relationship, click the **Add relation** button. The configuration is divided into two sections: **This object class** and **Is related to**. [![2 - Card Relation.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/2-card-relation.png)](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. [![3 - Section This object Class.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/Uf23-section-this-object-class.png)](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. [![4 - Section Is related to.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/yr24-section-is-related-to.png)](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**. [![5 - Object Class already in use.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/IMG5-object-class-already-in-use.png)](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") --- ![flag-italy-1f1ee-1f1f9.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/aiMflag-italy-1f1ee-1f1f9.png) **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 associarre una **starada** 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**. ![1 - Tab Relations.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/qHT1-tab-relations.png) Per creare una nuova relazione clicca sul bottone **Aggiungi relazione**. La configurazione è suddivisa in due sezioni: **Questa classe oggetto** e **È legata a**. [![2 - Card Relation.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/2-card-relation.png)](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. [![3 - Section This object Class.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/Uf23-section-this-object-class.png)](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. [![4 - Section Is related to.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/yr24-section-is-related-to.png)](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**. [![5 - Object Class already in use.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/IMG5-object-class-already-in-use.png)](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.

[ ](https://wiki.eaglearca.com/link/139#bkmrk-%C2%A0italian-version%C2%A0)

---

![jQPeng.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/KKPjqpeng.png) **English version** 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. This function allows you to connect objects to data coming from sensors or other configured sources, so that it can be viewed through charts in the object detail panel. For example, you can associate an environmental sensor with a Data Source that records temperature, humidity, or other monitored values. **Data Sources** and **charts** are configured during the [*creation or editing of an object class*](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-object-classes "Create and manage Object Classes"), inside a dedicated section.

Available only to users with `backoffice` permission and 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. [![2 - Tab Object Class.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/2-tab-object-class.png)](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. [![3 - Button add Data Sources](https://wiki.eaglearca.com/uploads/images/gallery/2026-01/scaled-1680-/3-button-add-data-sources.png)](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*). [![4 - Sensor Selection.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/4-sensor-selection.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/4-sensor-selection.png) #### Add a Chart

The 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. [![5 - Button add Data Sources](https://wiki.eaglearca.com/uploads/images/gallery/2026-01/5-button-add-data-sources.png)](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).* ![5 - Chart Configurator](https://wiki.eaglearca.com/uploads/images/gallery/2026-01/5-chart-configurator.png) 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. [![6 - Section Data.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/Qid6-section-data.png)](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. [![8 - Color range.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/8-color-range.png)](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. [![9 - parametric navigation.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/9-parametric-navigation.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/9-parametric-navigation.png) #### Customization Section

The 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. **[![7 - Customization.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/7-customization.png)](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 Section

Available 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. [![8 - Style.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/m9m8-style.png)](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 contidional style**, so that different colors are applied based on different thresholds or states. --- ### Links - *[Manage object in the project](https://wiki.eaglearca.com/books/app-features/page/gestire-gli-oggetti-nel-progetto "Gestire gli oggetti nel progetto")* --- ![flag-italy-1f1ee-1f1f9.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/aiMflag-italy-1f1ee-1f1f9.png) **Italian version** Una **Data Source** è 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 Data Source che registra temperatura, umidità o altri valori monitorati. Le **Data Source** 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 per utenti con permesso `backoffice` e con sensori configurati in precedenza.

### Configurazione Per configurare data source e grafici, apri il **Backoffice**, accedi alla pagina di modifica di una classe oggetto e seleziona la tab **Rappresentazione di dati**. [![2 - Tab Object Class.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/scaled-1680-/2-tab-object-class.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-03/2-tab-object-class.png) #### Aggiungere Data Source Per creare una nuova data source clicca sul bottone **Aggiungi sorgente dati**. [![3 - Button add Data Sources](https://wiki.eaglearca.com/uploads/images/gallery/2026-01/scaled-1680-/3-button-add-data-sources.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-01/3-button-add-data-sources.png) Seleziona il **tipo** di data source e imposta un **nome identificativo** (Es: Type *Thermometer*, Name *Termometro 1*). [![4 - Sensor Selection.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/4-sensor-selection.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/4-sensor-selection.png) #### Aggiungere Grafico

La possibilità di aggiungere grafici diventa disponibile solo se è stata aggiunta **almeno una data source**.

Per creare un nuovo grafico clicca sul bottone **Aggiungi grafico**. [![5 - Button add Data Sources](https://wiki.eaglearca.com/uploads/images/gallery/2026-01/5-button-add-data-sources.png)](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*). ![5 - Chart Configurator](https://wiki.eaglearca.com/uploads/images/gallery/2026-01/5-chart-configurator.png) A questo punto puoi configurare diverse sezioni: - **Dati** (obbligatoria) - **Personalizzazione** (facoltativa) - **Stile** (facoltativa) 💡 **Suggerimento:** Assegna nomi chiari e descrittivi a data source 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 **Data Source** 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 **Data Source** che alimenta il grafico tra quelle create in precedenza. Una volta selezionata la Data Source, specifica quali valori devono essere utilizzati negli assi del grafico. Gli assi disponibili cambiano in base alla tipologia di grafico selezionata. [![6 - Section Data.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/Qid6-section-data.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/Qid6-section-data.png) È possibile aggiungere più serie di dati, e quindi più Data Source, 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. [![8 - Color range.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/8-color-range.png)](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. [![9 - parametric navigation.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/9-parametric-navigation.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/9-parametric-navigation.png) #### Sezione Personalizzazione

La 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. **[![7 - Customization.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/7-customization.png)](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 Stile

Disponibile 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. [![8 - Style.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/m9m8-style.png)](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 bottone **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/gestire-gli-oggetti-nel-progetto "Gestire gli oggetti nel progetto")* --- ***Last update:** 08 May 2026* # Configure automatic object creation ![work in progress.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/work-in-progress.png) # 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.

[ ](https://wiki.eaglearca.com/link/135#bkmrk-%C2%A0italian-version%C2%A0)

---

![jQPeng.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/KKPjqpeng.png) **English version** 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.

--- ### Steps: Creation and Configuration **1. Access the Backoffice** and click **Roles** in the left nav rail. The list shows the name, creation date, number of associated groups and permission count for object classes. [![1 - Icon Roles.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/1-icon-roles.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/1-icon-roles.png) **2.** Click the **New Role** button in the top-right corner. [![2 - New Role.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/2-new-role.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/2-new-role.png) **3. Enter the role name** (required) in the **Role Name** field. **4. Select and Edit Permissions.** The lists show all available items for the three categories. By default, items retain the permission assigned to them at the time of creation. [![3 - List.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/3-list.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/3-list.png) You can filter items using the **search bar** and the **chips** at the top right of the page. [![4 - Filters.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/4-filters.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/4-filters.png) To assign permissions, s**elect one or more items** using the `Control` o `Shift` keys, then click one of the **three buttons** at the top right of the list: **Hidden**, **Visible**, or **Editable**. [![5 - Set permissions.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/5-set-permissions.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/5-set-permissions.png) **5. Save the new role** by clicking **Save** in the upper-right corner. You will be redirected to the list of roles. 💡**Tip**: Use the *chips* to quickly find items with specific permissions. 💡**Tip**: To see which groups are associated with a role, hover over the number of groups in the **Roles** list. The complete list of associated groups will be displayed. --- ### Viewing and Editing Roles **To edit a role**, click the blue button with the arrow icon that appears when you hover over the item. **To duplicate a role**, select an item from the list. Once selected, the Duplicate button will appear. **To delete a role**, select one or more items from the list. Once selected, the Delete 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")* - *[Create and manage Object Classes](https://wiki.eaglearca.com/books/backoffice/page/creare-e-gestire-le-classi-oggetto "Create and manage Object Classes")* --- ![flag-italy-1f1ee-1f1f9.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/aiMflag-italy-1f1ee-1f1f9.png) **Italian version** Un **Ruolo** definisce i permessi (modifica, visualizzazione, accesso) sulle classi oggetto e sui report. Serve per impostare con precisione i **permessi** assegnati ai gruppi associati.

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.

--- ### Passaggi: Creazione e Configurazione **1. Accedi al Backoffice** e clicca su **Ruoli** nella *nav rail* di sinistra. La lista mostra nome, data di creazione, numero di gruppi associati e il conteggio dei permessi per le classi oggetto. ![1 - Icon Roles.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/1-icon-roles.png) **2.** Clicca sul bottone **Nuovo ruolo** in alto a destra. ![2 - New Role.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/2-new-role.png) **3. Inserisci il nome** del ruolo (obbligatorio) nel campo **Nome Ruolo**. **4. Seleziona e Modifica Permessi.** Le liste mostrano tutti gli elementi disponibili per le tre categorie. Per impostazione predefinita, gli elementi mantengono il permesso assegnato al momento della loro creazione. [![3 - List.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/3-list.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/3-list.png) Puoi filtrare gli elementi con la **searchbar** e le **chip** situate in alto a destra della pagina. [![4 - Filters.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/4-filters.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/4-filters.png) Per assegnare i permessi **seleziona** **uno o più elementi**, usando `Control` o `Shift`, quindi clicca su uno dei **tre bottoni** disponibili in alto a destra della lista: **Non visibile**, **Visibile** o **Modificabile**. [![5 - Set permissions.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/scaled-1680-/5-set-permissions.png)](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/5-set-permissions.png) **5. Salva il nuovo ruolo** cliccando **Salva** in alto a destra. Verrai reindirizzato alla lista dei ruoli. 💡**Suggerimento**: Utilizza le *chip* per trovare rapidamente elementi con permessi specifici. 💡**Suggerimento**: Per vedere quali gruppi sono associati a un ruolo, passa il mouse sul numero dei gruppi nella lista **Ruoli**. Viene mostrato l’elenco completo dei gruppi collegati. --- ### Visualizzazione e Modifica dei Ruoli **Per modificare un** **ruolo**, clicca sul bottone blu con l'icona di una freccia, che appare al passaggio del mouse sull'elemento. **Per duplicare un ruolo**, seleziona un elemento dalla lista. Dopo la selezione, compare il bottone **Duplica**. **Per eliminare un ruolo**, seleziona uno o più elementi dalla lista. Dopo la selezione, compare il bottone **Elimina**. --- ### 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")* - *[Creare e gestire le Classi Oggetto](https://wiki.eaglearca.com/books/backoffice/page/creare-e-gestire-le-classi-oggetto "Creare e gestire le Classi Oggetto")* --- ***Last update:** 07 May 2026* # Create and manage Groups A group brings together users with the same role and permissions, allowing them to work on the same projects using a consistent set of operations.

[ ](https://wiki.eaglearca.com/link/134#bkmrk-%C2%A0italian-version%C2%A0)

---

![jQPeng.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/KKPjqpeng.png) **English version** A group brings together users with the same **role** and **permissions**, allowing them to work on the same projects using a consistent set of operations. Creating a group allows you to **group** [users ](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-users "Create and manage Users")and **assign them a** [role](https://wiki.eaglearca.com/books/backoffice/page/create-and-manage-roles "Create and manage Roles"), simplifying permission management in a scalable way.

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 *nav rail***.** The list shows the name, creation date, associated projects, added users and linked role. ![1 - Icon Groups.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/1-icon-groups.png) **2.** Click the **New Group** button in the top-right corner. ![2 - Button New Groups.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/poV2-button-new-groups.png) **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. [![3 - Name and Role.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/3-name-and-role.png)](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**. [![4 - Groups Configuration.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/xMu4-groups-configuration.png)](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")* - *[Creare e gestire le Classi Oggetto](https://wiki.eaglearca.com/books/backoffice/page/creare-e-gestire-le-classi-oggetto "Creare e gestire le Classi Oggetto")* - *[Creare e gestire i Progetti](https://wiki.eaglearca.com/books/backoffice/page/creare-e-gestire-i-progetti "Creare e gestire i Progetti")* --- ![flag-italy-1f1ee-1f1f9.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/aiMflag-italy-1f1ee-1f1f9.png) **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/creare-e-gestire-utenze "Creare e gestire utenze") e **assegnare loro un** [*ruolo*](https://wiki.eaglearca.com/books/backoffice/page/creare-e-gestire-i-ruoli "Creare e gestire i Ruoli"), 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** nella *nav rail* di sinistra. La lista mostra nome, data di creazione, progetti associati, utenti aggiunti e il ruolo collegato. ![1 - Icon Groups.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/1-icon-groups.png) **2.** Clicca sul bottone **Nuovo gruppo** in alto a destra. ![2 - Button New Groups.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/poV2-button-new-groups.png) **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. [![3 - Name and Role.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/3-name-and-role.png)](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 **Clear**. [![4 - Groups Configuration.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/xMu4-groups-configuration.png)](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 *search bar* 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 bottone 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 bottone **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/creare-e-gestire-le-classi-oggetto "Creare e gestire le Classi Oggetto")* - *[Creare e gestire i Progetti](https://wiki.eaglearca.com/books/backoffice/page/creare-e-gestire-i-progetti "Creare e gestire i Progetti")* --- ***Last update:** 07 May 2026* # Creare e gestire i Progetti 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, persone e siti dei sensori, integrando i moduli disponibili per l’organizzazione.

Disponibile solo per utenti con permesso `backoffice`. Per creare un progetto è necessario che nel sistema siano **già presenti** i **gruppi** da associare al progetto.

--- ### Passaggi **1. Accedi al Backoffice** e clicca su **Progetti** nella *nav rail* di sinistra. La lista mostra nome, data dell’ultimo aggiornamento, gruppi collegati, classi oggetto, moduli attivi e tag. ![1 - Icon Projects.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/1-icon-projects.png) **2.** Clicca sul bottone **Nuovo progetto** in alto a destra. ![2 - Button New Project.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/2-button-new-project.png) **3. Seleziona i Moduli**: Nel menu a tendina, scegli i moduli da includere nel progetto (es. `GIS 2D`, `3D`, `IoT`, `Mission Planner`). [![3 - Modules Selection.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/sV53-modules-selection.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/sV53-modules-selection.png) **4. Compila i campi principali**: - Inserisci un **Nome progetto** univoco (obbligatorio). - Se il `modulo-mission-planner` è attivo, seleziona il **tipo di missione** (esterna o interna). - Aggiungi uno o più **Tag del progetto** (scrivi e premi Invio o scegline uno dal menu a tendina). **5. Aggiungi elementi al progetto**: - Nelle sezioni inferiori (*[Classi oggetto](https://wiki.eaglearca.com/books/backoffice/page/creare-e-gestire-le-classi-oggetto "Creare e gestire le Classi Oggetto")*, **Risorse**, **Siti di sensori**, [*Gruppi*](https://wiki.eaglearca.com/books/backoffice/page/creare-e-gestire-i-gruppi "Creare e gestire i Gruppi")), clicca **Aggiungi**. [![5 - Section Header.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/mKL5-section-header.png)](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. [![6 - Section Configuration.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/iP76-section-configuration.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/iP76-section-configuration.png) - Usa la *search bar* per filtrare. - Per selezioni multiple usa `Ctrl` o `Shift`. - Clicca **Applica** per confermare. **6. Salva il nuovo progetto** cliccando **Salva** in alto a destra. Il bottone è disabilitato finché non sono inseriti nome e almeno un gruppo. --- ### Modificare e Visualizzare dalla Lista - **Modifica un progetto**: Clicca sul bottone blu con l'icona di una freccia, che appare al passaggio del mouse sull'elemento. - **Duplica un progetto**: Appare il bottone **Duplica** se è selezionato **un singolo elemento**. Un modale chiede quali elementi del progetto duplicare. - **Elimina un progetto**: Appare il bottone **Elimina** se sono selezionati **uno o più elementi**. Scrivi il nome del progetto per procedere.

**Se rimuovi Classi Oggetto già usate nel progetto**, le istanze collegate viene visualizzato un modale di avviso che informa che le istanze associate verranno nascoste dal progetto e nella sezione **Classi oggetto** compare una chip di **warning** (in hover mostra quali classi mancano).

--- ### Suggerimenti 💡 **Verifica i gruppi prima di salvare** Controlla sempre che i gruppi associati siano corretti, poiché solo gli utenti appartenenti a essi avranno accesso al progetto. 💡 **Attiva solo i moduli necessari** Scegli con attenzione quali moduli abilitare; mantenere il progetto essenziale aiuta a ridurne la complessità. 💡 **Usa i tag come categorie** I tag servono per classificare i progetti e facilitare la ricerca; i tag creati vengono salvati e riproposti automaticamente in progetti futuri. 💡 **Gestisci le classi oggetto con attenzione** Se una classe usata viene rimossa, le istanze legate resteranno nascoste finché non la reinserisci nella configurazione. --- ### Problemi comuni

Problema	Soluzione
Non riesco a salvare il progetto	Controlla che sia stato inserito un nome univoco e almeno un gruppo.
Gli oggetti sono scomparsi dal progetto	Potrebbero essere state rimosse le classi oggetto corrispondenti dalla configurazione; reinseriscile per renderle di nuovo visibili.
Non vedo i moduli nel menu	Verifica che i moduli siano attivi nei contratti dell’organizzazione.
Il tag non appare nei suggerimenti	I tag vengono proposti dopo il primo utilizzo; crea un nuovo progetto per vederlo comparire tra le opzioni.

--- ***Ultimo aggiornamento:** 6 Novembre 2025* # Creare e gestire le Notifiche La gestione delle notifiche si basa sulla creazione di un **Evento** (per ricevere e interpretare i dati da fonti esterne) e sulla configurazione di **Output** (per inviare comunicazioni condizionali a destinatari specifici).

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.

--- ### Passaggi per creare un Evento Un Evento consente alla piattaforma di **ricevere** e **interpretare** informazioni (tipicamente JSON) da provider esterni, collegandole a un'entità (Organizzazione, Progetto, Oggetto, Sensore, Dispositivo). **1. Accedi al Backoffice** e clicca su **Eventi** nella *nav rail* di sinistra. La lista mostra nome, l'entità a cui l'evento è collegato, le direct list presenti, la data di creazione e **il bottone per copiare l'URL dell'evento**. ![1- Icon Events.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/1-icon-events.png) **2.** Clicca sul bottone **Nuovo evento** in alto a destra. ![2 - Button New Event.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/TFM2-button-new-event.png) **3.** Inserisci il **Nome evento e l'entità collegata** (obbligatori)**:** [![3 - Linked To.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/X0h3-linked-to.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/X0h3-linked-to.png) - **Organizzazione:** per eventi generali. - **Progetto:** per eventi specifici di un singolo progetto. - **Oggetto:** per eventi legati a una classe e a una singola istanza. - **Single sensor:** per eventi provenienti da un singolo sensore. - **Device:** per eventi generati da un insieme di sensori. **4. Sezione Mapping**: Questa sezione definisce come i dati in arrivo (payload JSON) devono essere interpretati. - **Carica il payload di esempio**: Incolla o carica un file JSON di esempio nella textbox e clicca **Conferma** per generare le chiavi di mappatura. [![4 - Payload Structure.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/tGl4-payload-structure.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/tGl4-payload-structure.png) - **Mappa le chiavi**: Associa le chiavi del provider ai livelli di informazione previsti: - **Nome**: obbligatorio; rappresenta il nome dell’evento. *Esempio:* nel codice del provider può comparire come `event_name` o `notification_name`. - **Event ID**: obbligatorio; identifica in modo univoco il tipo di evento. *Esempio:* `event_id` o `type_code`. - **Tempo (Time)**: obbligatorio; indica il momento in cui l’evento si verifica. *Esempio:* una chiave chiamata `timestamp` o `event_time`. - **Livelli (Levels)**: obbligatorio; definisce la tipologia o gravità dell’evento (`info`, `warning`, `success`, `error`). Ogni livello può avere un **Displayed name**, il nome visibile quando si passa il cursore sull’icona del livello. *Esempio:* una chiave del provider come `severity` o `status` può essere mappata su “warning”. - **Descrizione**: obbligatoria; spiega brevemente il contenuto o lo scopo dell’evento. - *Esempio:* una chiave come `message` o `details`. - **Additional info**: facoltativo; aggiunge informazioni aggiuntive. Ogni informazione può avere un **Displayed name**, visibile all’utente. *Esempio:* chiavi come `temperature`, `battery_status`, `signal_strength`. [![5 - Mapping.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/l095-mapping.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/l095-mapping.png) ##### In base al valore selezionato in *Linked to*, vengono visualizzate ulteriori card obbligatorie: - **Project ID**: collega l’evento a un progetto, in modo che venga categorizzato nel contesto del progetto associato. *Esempio:* una chiave `project_id` nel JSON. - **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`. **5. Salva l'evento** cliccando **Salva** in alto a destra. Il bottone è disabilitato finché non sono inseriti nome e entità collegata e finché non sono state mappate tutte le chiavi obbligatorie.

Una volta salvato, appare un **link URL** nella lista che deve essere fornito al provider esterno per l'invio dei dati.

--- ### Modificare e Visualizzare dalla Lista - **Modifica un evento**: Clicca sul bottone blu con l'icona di una freccia, che appare al passaggio del mouse sull'elemento. - **Duplica un evento**: Appare il bottone **Duplica** se è selezionato **un singolo elemento**. - **Elimina un evento**: Appare il bottone **Elimina** se sono selezionati **uno o più elementi**. - **Copia URL**: Bottone disponibile per copiare il link da fornire al provider. --- ### Passaggi per impostare un Output (Direct Lists) L'output, gestito tramite **Direct Lists**, definisce configurazioni condizionali per l'invio di notifiche (*push* o *email*) a specifici destinatari. Se nessun output è configurato, l'evento viene registrato ma non invia comunicazioni. **1.** Dopo aver salvato l'evento in alto a destra si abilita la pagina **Output**, aprila. [![6 - Section Output.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/6-section-output.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/6-section-output.png) **2.** Clicca sul bottone **Nuova lista**. [![7 - New list.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/7-new-list.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/7-new-list.png) **3. Configura la Direct List**: - Inserisci un **Nome lista** descrittivo. - Seleziona il **Tipo di comunicazione** (*Email* o *Push*). [![8 - Direct List Name.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/qHB8-direct-list-name.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/qHB8-direct-list-name.png) **4. Imposta la Condizione (Opzionale)**: - Se vuoi limitare l'invio solo a specifiche occorrenze, a**ggiungi delle condizioni** basate su occorrenze degli eventi o sui livelli (info, warning, success, error) . - Definisci la **Chiave** (dell'evento) e il **Valore** che deve essere verificato per attivare l'invio (es. `priorità` = `alta`). [![9 - Direct List Condition.jpg](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/eoL9-direct-list-condition.jpg)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/eoL9-direct-list-condition.jpg) **5. Aggiungi Destinatari**: - Scegli gli utenti/gruppi che riceveranno la notifica per aggiungerli alla sezione **Destinatari**. - Per *Email*, puoi aggiungere anche indirizzi email esterni. [![10 - Recipients.png](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/scaled-1680-/10-recipients.png)](https://wiki.eaglearca.com/uploads/images/gallery/2025-12/10-recipients.png) **6. Salva la Direct List** cliccando **Salva**. 💡 È possibile creare un **numero illimitato di Direct List** per lo stesso evento, differenziando i destinatari e/o le condizioni. --- ### Suggerimenti 💡 **Nomi descrittivi** Usa nomi descrittivi sia per gli Eventi che per le Direct List per facilitare l'identificazione. 💡 **Controlla il JSON** Prima di salvare l'Evento, assicurati che il JSON di esempio sia corretto per generare chiavi di mappatura valide. 💡 **Evita duplicati** Quando duplichi una Direct List, modifica sempre almeno un parametro (es. i destinatari o la condizione) per evitare comunicazioni doppie. 💡 **Condizioni d'invio** Imposta le condizioni sull'output solo se vuoi limitare l'invio; se non ci sono condizioni, la notifica viene inviata per ogni occorrenza dell'evento. --- ### Collegamenti - *[Creare e gestire i progetti](https://wiki.eaglearca.com/books/backoffice/page/creare-e-gestire-i-progetti "Creare e gestire i progetti")* - *[Gestire gli oggetti nel progetto](https://wiki.eaglearca.com/books/app-features/page/gestire-gli-oggetti-nel-progetto "Gestire gli oggetti nel progetto")* - [Configurare Data Source e Grafici](https://wiki.eaglearca.com/books/backoffice/page/configurare-data-source-e-grafici "Configurare Data Source e Grafici") - [Assegnare una data source ad un oggetto](https://wiki.eaglearca.com/books/creazione-e-modifica-oggetti/page/assegnare-una-data-source-ad-un-oggetto "Assegnare una data source ad un oggetto") --- ### Problemi Comuni

Problema	Soluzione
Il bottone Salva nella pagina di creazione dell'evento resta disattivato	Controlla che tutti i campi obbligatori siano compilati.
Le chiavi di mappatura non compaiono	Dopo aver incollato il JSON nella sezione Mapping, clicca Conferma.
Non riesco ad aggiungere i destinatari	Verifica che il tipo di comunicazione sia coerente: gli indirizzi email esterni sono accettati solo nelle Direct List di tipo Email.
Le notifiche arrivano due volte	Controlla se esistono due Direct List identiche (stesso evento, stessi destinatari, stesse condizioni) e modificane una.

--- ***Ultimo aggiornamento**: 6 Novembre 2025* # Create and manage Reports ![work in progress.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/work-in-progress.png) # Create and manage Automations ![work in progress.png](https://wiki.eaglearca.com/uploads/images/gallery/2026-05/work-in-progress.png)

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.

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.