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. Italian version ↓   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. 2. Click New User in the upper-right corner. 3.  Fill in the Email , First Name , Last Name  and Username fields. 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. 5. Select backoffice permissions: No access Standard – all sections except Users and Admin Admin – full access  6. Click Save to create the account. The user will receive a welcome email 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. 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 Overview of users, roles and groups   Italian version  Nel Backoffice è possibile creare e gestire le utenze dell’organizzazione. Ogni utenza identifica un utente abilitato ad accedere all' app o al backoffice , in base ai permessi assegnati. Disponibile solo per utenti con permesso  backoffice-admin . Creare una nuova utenza 1. Accedi al  Backoffice e apri la sezione Utenti . 2. Clicca su Nuovo utente in alto a destra. 3. Compila i campi Email, Nome, Cognome, Username . 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. 5. Seleziona i permessi per il backoffice : Nessun accesso Standard – tutte le sezioni tranne Utenti e Admin Admin – accesso completo 6. Clicca Salva per creare l’utenza. L’utente riceverà una  mail di benvenuto 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. 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 Panoramica utenti, ruoli e gruppi 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. Italian version ↓   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 . 2. Click the New Object button. 3. Enter the Name (unique) and choose the object Type : 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. 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. 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. You can reorder the attributes by dragging the cards to the desired position. 💡 Tip : Use a meaningful Primary Attribute, choosing a unique attribute to quickly identify instances. Configure Conditional Styles (Optional) Conditional styles automatically change the appearance or visibility of objects based on attribute values. A. Classic Style (for Categories/Statuses) Ideal for highlighting distinct statuses, such as Verified / To be verified . 1. Click Add style . 2. Click Add condition and define Attribute + Value . 3. Choose the logic between conditions: Every condition or At least 1 condition . 4. Edit the style to apply, such as geometry, color, or pattern. B. Value Range Style (for Continuous Values) Ideal for representing a continuous trend, such as height or index. 1. Click Add value range . 2. Select the attribute (numeric, date, or size). 3. Define the stop values (min/max) and customize the style for each stop (color, transparency, etc.). 4. Check the transition using the slider in the preview . 💡 Tip : Use conditional styles if you want the style change to be immediately obvious, or to highlight states and thresholds. 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 , associate Data Sources and charts to display data collected over time, and define settings for the automatic creation of objects . 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 Creare e gestire i progetti   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 . 2. Clicca sul bottone Nuovo oggetto . 3. Inserisci il Nome (univoco) e scegli il Tipo di oggetto: 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. 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. 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. 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. A. Stile Classico (per Categorie/Stati) Ideale per evidenziare stati distinti (es. Verificato/Da verificare). 1. Clicca  Aggiungi Stile . 2. Clicca Aggiungi condizione e definisci Attributo + Valore. 3. Scegli la logica tra le condizioni: Tutte le condizioni o Almeno una condizione . 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 . 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.). 4. Verifica la transizione con lo slider nella preview . 💡 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 , associare Data Sources e grafici per visualizzare dati raccolti nel tempo, e definire impostazioni per la creazione automatica degli oggetti . 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 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 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. Italian version ↓   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 , 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. To create a new relationship, click the Add relation button. The configuration is divided into two sections: This object class and Is related to . 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. 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 , 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. 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 . 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   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 , all’interno di una sezione dedicata. Disponibile solo per utenti con permesso  backoffice . Come funzionano le relazioni Una relazione collega sempre due classi oggetto : Classe oggetto corrente È la classe che stai configurando in quel momento nel Backoffice . Classe oggetto collegata È la classe con cui gli oggetti della classe corrente possono essere collegati. Quando una relazione viene configurata tra due classi, gli oggetti possono essere associati a una o più istanze della classe relazionata. Il numero di oggetti collegabili dipende dalla cardinalità impostata nella relazione. Configurare le relazioni Per configurare una relazione tra classi oggetto, apri il Backoffice , accedi alla pagina di modifica di una classe oggetto e seleziona la tab Relazioni . Per creare una nuova relazione clicca sul bottone Aggiungi relazione . La configurazione è suddivisa in due sezioni: Questa classe oggetto e È legata a . 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. 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 , 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. 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 . 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 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. Italian version ↓   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 , 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. Add a Data Source To create a new data source, click the Add data source button. Select the data source type and enter an identifying name (e.g. Type Thermometer, Name Thermometer 1 ). 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. Enter an identifying name and select the chart type ( Line, Counter, Bar, Scatter, 3D Scatter, Heatmap). At this point, you can configure different sections: Data (required) Customization (optional) Style (optional) 💡 Tip: Assign clear and descriptive names to data sources and charts (e.g. “Thermometer Floor 1”) to make them easier to manage. Configure the Chart Data Section The Data section defines which data is displayed in the chart and which Data Source it is retrieved from. The first field to complete is Data compression , which allows you to choose how the available data is handled before it is displayed in the chart. You can select one of the following methods: Aggregation over time: Groups the collected data into time intervals and shows a summarized value for each period. This is useful when there is a large amount of data and a more compact view of the trend is needed. Downsampling: Reduces the number of displayed data points by keeping only part of the available values. This is useful to make the chart lighter when the amount of data is high. After choosing the compression method, configure the Main data source . In this section, select the Data Source that feeds the chart from those previously created. Once the Data Source has been selected, specify which values must be used for the chart axes. The available axes change depending on the selected chart type. 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. 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. 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. 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. 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   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 , 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 . Aggiungere Data Source Per creare una nuova data source clicca sul bottone  Aggiungi sorgente dati . Seleziona il  tipo di data source e imposta un nome identificativo (Es: Type Thermometer , Name Termometro 1 ). 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 . Imposta il nome identificativo e seleziona il tipo di grafico ( Line, Counter, Bar, Scatter, 3D Scatter, Heatmap ). A questo punto puoi configurare diverse sezioni: Dati (obbligatoria) Personalizzazione (facoltativa) Stile (facoltativa) 💡 Suggerimento: Assegna nomi chiari e descrittivi a 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. È 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. 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. 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. 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. 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 Last update: 08 May 2026 Configure automatic object creation 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. Italian version ↓   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. 2. Click the New Role button in the top-right corner. 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. You can filter items using the search bar and the chips at the top right of the page. 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. 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 Create and manage Object Classes   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. 2. Clicca sul bottone Nuovo ruolo in alto a destra. 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. Puoi filtrare gli elementi con la  searchbar e le chip situate in alto a destra della pagina. 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. 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 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. Italian version ↓   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 and assign them a role , 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. 2. Click the New Group button in the top-right corner. 3. Fill in the required fields (name and role): Enter a unique name in the Group Name field. Select the Role to associate from the drop-down menu. 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 . 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 Introduction to Object Classes Creare e gestire le Classi Oggetto Creare e gestire i Progetti   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 e assegnare loro un ruolo , 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. 2. Clicca sul bottone Nuovo gruppo in alto a destra. 3. Compila i campi obbligatori (nome e ruolo): Inserisci un nome univoco nel campo Nome gruppo . Seleziona il Ruolo da associare tramite il menu a tendina. 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 . 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 Introduzione alle Classi Oggetto Creare e gestire le Classi Oggetto 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. 2. Clicca sul bottone Nuovo progetto in alto a destra. 3. Seleziona i Moduli : Nel menu a tendina, scegli i moduli da includere nel progetto (es. GIS 2D , 3D , IoT , Mission Planner ). 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 , Risorse , Siti di sensori , Gruppi ), clicca Aggiungi . Seleziona uno o più elementi nel pannello sinistro e trascinali a destra per aggiungerli. 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 . 2. Clicca sul bottone Nuovo evento in alto a destra. 3.  Inserisci il Nome evento e l'entità collegata (obbligatori) : 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. 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 .   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. 2. Clicca sul bottone Nuova lista . 3. Configura la Direct List : Inserisci un Nome lista descrittivo. Seleziona il Tipo di comunicazione ( Email o Push ). 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 ). 5. Aggiungi Destinatari : Scegli gli utenti/gruppi che riceveranno la notifica per aggiungerli alla sezione Destinatari . Per Email , puoi aggiungere anche indirizzi email esterni. 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 Gestire gli oggetti nel progetto Configurare Data Source e Grafici 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 Create and manage Automations