Skip to main content

Create and manage Events

AnA Eventgroup 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 the platformyou to receivegroup users and interpretassign informationthem a (typicallyrole, JSON)simplifying frompermission externalmanagement providers, linking it toin a platformscalable entity such as organizations, projects, objects, sensors, and devices.

To use events for sending notifications, you can configure the outputs from the Automations section.way.

Available only to users with backoffice permission.permissions. To create ana event,group, the role to which the entitiesgroup it mustwill be linked to must already exist in the system: project, object, sensor, or device.
system.

Create a new EventSteps

1. Log in toAccess the Backoffice and click BackofficeGroups and open the Events section fromin the left-side menu.menu.
The list shows the name, thecreation date, associated projects, added users and linked entity, the linked automation, the creation date,and a button to copy the event URL.role.

1- Icon Events.png1 - Icon Groups.png

2. Click Clickthe New eventGroup button in the top-right corner.

2 - Button New Event.png2 - Button New Groups.png

3. EnterFill in the Eventrequired fields (name and select the Linked to entity, both fields are required.

3 - Linked To.png

The available options are:role):

  • Organization
    For general events.

  • Project
    For events specific toEnter a singleunique project.

  • Object
    For events linked to a class and a single instance.

  • Single sensor
    For events coming from a single sensor.

  • Device
    For events generated by a set of sensors.

4. In the Mapping section, define how the incoming data should be interpreted.

If needed, load the sample payload: paste or upload a JSON filename in the textGroup boxName andfield. click

  • Select the ConfirmRole to generateassociate from the mappingdrop-down keys.

    Loading the JSON is not required, you can also fill in the fields manually.

    4 - Payload Structure.png

    Then map the keys, associating the provider's keys with the fields required by the platform:

    • Name (required)
      The name of the event. Example: event_name or notification_name.

    • Event ID (required)
      Uniquely identifies the type of event. Example: event_id or type_code.

    • Time (required)
      Indicates when the event occurs. Example: timestamp or event_time.

    • Levels (required)
      Defines the type or severity of the event (info, warning, success, error). Each level can have a Displayed name, shown when hovering over the level icon. Example: a key like severity or status mapped to "warning".

    • Description (required)
      Briefly explains the content or purpose of the event. Example: message or details.

    • Additional info (optional)
      Adds supplementary data, each with an optional Displayed name. Example: temperature, battery_status, signal_strength.menu.

    5 - Mapping.png3 - Name and Role.png

    DependingName and Role are required to save.

    4. Add or remove users.
    The group configuration shows two lists: on the linked entityleft selectedare earlier,all additionalusers required fields may appear:

    • Project ID
      Linksin the eventorganization, towhile a project. Example: project_id.

    • Object ID
      Links the event to an object;on the object classright must be selected first. Example: object_id or entity_ref.

    • Single Sensor ID
      Identifiesare the sensorusers already added to the eventgroup.

      comes

      To from.add Example:users sensor_id or sensor_name.

    • Device ID
      Identifiesto the devicegroup      , groupingselect one or more sensors.names Example:from the list on the left using device_idControl or controller_nameShift.
      •  
    for

    Formultiple eachselection, mappedthen keydrag them to the area on the right. Hold Control and click a name that is already selected to remove it isfrom alsothe possibleselection.

    To remove users from the group, select the names from the list on the right and drag them to assignthe alist type, which defines howon the platformleft. shouldTo interpretremove thatall value.
    Theadded availableusers, typesclick are:

    • Text fieldClear: for text values.
    • Date: selectable as date only or date and time.
    • Number: selectable as integer or decimal number.
    • True/false: for boolean values.

    The type assigned to each field influences the conditions available in the Automations section.

    read as.png4 - Groups Configuration.png

    5. IfSave the payloadnew includes geographic datagroup, it is possible to map the coordinates as well. Enable the switch to configure how the platform should read the incoming coordinates.

    Once enabled, you can choose the format in which the coordinates are transmitted by the provider:

    • Single field
      The coordinates are contained in a single field of the payload. Enter the field name in Corresponds to.

    • Double field
      Latitude and longitude are transmitted in separate fields. Enter the respective names in the Latitude corresponds to and Longitude corresponds to fields.

    coordinates section.png

    The Coordinates field is required to enable certain actions in Automations, such as the creation of an object of type Point or the launch of a robotic mission.

    6. Clickclicking Save  in the top-right corner.corner The(after buttonassigning remainsat disabledleast untilone user). 

    💡Tip:  Use the name,search bar to filter users in both lists.

    💡Tip:  Make sure to assign only those users who need the linkedsame entity,level andof all required keys have been filled in.

    Once saved, a URL link appears in the list. This link must be providedaccess to the external provider to enable data transmission.projects.

    EditViewing and manageEditing eventsGroups

    To edit ana eventgroup, click the blue button with the arrow icon that appears when hoveringyou hover over the item.

    To duplicate ana eventgroup, select a singlean item from the list,list. thenOnce clickselected, the Duplicate button in the top-right corner.

    To delete an event, select one or more items from the list, the Delete button will appear in the top-right corner. Hold CTRL and click to add items to the selection or remove them from it.appear.

    To copy the URL of an event, use the dedicated button directly from the list.

    💡 Tips:

    • When duplicating an event, update the mapping keys if the target provider uses a different JSON structure.
    • Use descriptive names for events to make them easier to identify in the list.

    Links

    Crea e gestisci eventii gruppi

    Un Eventogruppo consenteraccoglie allautenti piattaformacon lo stesso ruolo e permessi, consentendo loro di riceverelavorare esugli interpretarestessi informazioniprogetti (tipicamentecon JSON)un daset providerdi esterni,operazioni collegandolecoerenti.

    Creare un gruppo serve a un'entitàassociare dellautenti piattaforma, come organizzazioni, progetti, oggetti, sensori e dispositivi.

    assegnare

    Perloro usareun gli eventi per l'invio di notificheruolo, puoisemplificando configurarela gligestione outputdei dallapermessi sezionein Automazioni.modo scalabile.

    Disponibile solo per utenti con permesso backoffice. Per creare un eventogruppo è necessario che nel sistema sianosia già presentipresente leil entitàruolo a cui l’eventoil gruppo deve essere collegato: progetto, oggetto, sensore o dispositivo.collegato.

    Creare un nuovo eventoPassaggi

    1. Accedi al Backoffice e apriclicca la sezionesu EventiGruppi dalnel menu lateralesul lato sinistro.
    La lista mostra il nome, l'entità collegata, l'automazione collegata, la data di creazionecreazione, progetti associati, utenti aggiunti e unil bottoneruolo per copiare l'URL dell'evento.collegato.

    1- Icon Events.png1 - Icon Groups.png

    2.  Clicca susul pulsante Nuovo eventogruppo in alto a destra.

    2 - Button New Event.png2 - Button New Groups.png

    3. Inserisci il Nome evento e seleziona l'Entità collegata, entrambiCompila i campi sonoobbligatori obbligatori.

    (nome

    3 - Linked To.png

    e

    Le opzioni disponibili sono:ruolo):

    • Organizzazione
      Per eventi generali.

    • Progetto
      Per eventi specifici diInserisci un singolo progetto.

    • Oggetto
      Per eventi legati a una classe e a una singola istanza.

    • Sensore singolo
      Per eventi provenienti da un singolo sensore.

    • Dispositivo
      Per eventi generati da un insieme di sensori.

    4. Nella sezione Mapping definisci come i dati in arrivo devono essere interpretati.

    Se lo ritieni necessario, carica il payload di esempio: incolla o carica un file JSON nella casella di testo e clicca Conferma per generare le chiavi di mappatura.

    Inserire il JSON non è obbligatorio, puoi inserire i campi anche manualmente.

    4 - Payload Structure.png

    Poi mappa le chiavi, associando le chiavi del provider ai campi richiesti dalla piattaforma:

    • Nome (obbligatorio)
      Il nome dell'evento. Esempio: event_name o notification_name.

    • Event ID (obbligatorio)
      Identifica in modo univoco ilnel tipo di evento. Esempio: event_id o type_code.

    • Tempo (obbligatorio)
      Indica il momento in cui l'evento si verifica. Esempio: timestamp o event_time.

    • Livelli (obbligatorio)
      Definisce la tipologia o gravità dell'evento (info, warning, success, error).
      Ogni livello può avere uncampo Nome visualizzatogruppo,.
      • visibile passando
    • Seleziona il cursore sull'icona del livello. Esempio: una chiave come severity o status mappata su "warning".

    • DescrizioneRuolo (obbligatoria)
      Spiegada brevementeassociare tramite il contenutomenu oa lo scopo dell'evento. Esempio: message o details.

    • Informazioni aggiuntive (facoltativo)
      Aggiunge dati supplementari, ciascuno con un Nome visualizzato opzionale. Esempio: temperature, battery_status, signal_strength. tendina.

    5 - Mapping.png3 - Name and Role.png


    InNome basee all'entitàRuolo colegata selezionata precedentemente, potrebbero aggiungersisono ulterioriobbligatori campiper obbligatori:
    il salvataggio.

    • Project4. IDAggiungi o rimuovi gli utenti.
      CollegaLa l'eventoconfigurazione del gruppo mostra due liste: a unsinistra progetto.sono Esempio:disponibili project_idtutti gli utenti dell’organizzazione, mentre a destra sono presenti gli utenti già aggiunti al gruppo.

    • ObjectPer IDaggiungere utenti al gruppo
      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 raggruppaseleziona uno o più sensori.nominativi Esempio:dalla lista a sinistra usando device_idControl o controller_nameShift.

    Per ogni chiave mappata è inoltre possibile assegnare una tipologia, che definisce come la piattaforma deve interpretare quel valore.
    Le tipologie disponibili sono:

    • Campo di testo: per valorile testuali.
      • selezioni
    • Data:multiple, selezionabilequindi cometrascinali solo data o come data e ora.
    • Numero: selezionabile come numero intero o numero reale.
    • Vero/falso: per valori booleani.

    La tipologia assegnatanell’area a ciascundestra. campoCon influenzaControl le+ condizioniclic disponibilisu nellaun sezionenominativo Automazioni.già selezionato lo togli dalla selezione.

    Per rimuovere utenti dal gruppo, seleziona i nominativi dalla lista a destra e trascinali nella lista a sinistra. Per rimuovere tutti gli utenti aggiunti, clicca Cancella.

    read as.png4 - Groups Configuration.png

    5. SeSalva il payloadnuovo include dati geografici, è possibile mappare anche le coordinate. Attiva lo switch per configurare come la piattaforma deve leggere le coordinate in arrivo.

    Una volta attivato, puoi scegliere il formato con cui le coordinate vengono trasmesse dal provider:

    • Campo singolo
      Le coordinate sono contenute in un unico campo del payload. Inserisci il nome del campo in Corrisponde a.

    • Doppio campo
      Latitudine e longitudine sono trasmesse in campi separati. Inserisci i rispettivi nomi nei campi Latitudine corrisponde agruppo e Longitudine corrisponde a.

    coordinates section.png

    Il campo Coordinate è necessario per abilitare alcune azioni nelle Automazioni, come la creazione di un oggetto di tipo Punto o l'avvio di una missione robotica.

    6. Per salvare, cliccacliccando Salva in alto a destra.destra Il(dopo bottoneaver rimaneassegnato disabilitatoalmeno finchéun nonutente).

    sono

    💡Suggerimento: compilatiUsa illa nome,barra l'entitàdi collegataricerca eper tuttefiltrare gli utenti in entrambe le chiavi obbligatorie.liste.

    Una💡Suggerimento: voltaAssicurati salvato,di nellaassegnare listasolo comparegli un link URLutenti che devedevono essereavere fornitolo alstesso providerlivello esternodi peraccesso abilitareai l'invio dei dati.progetti.

    ModificareVisualizzazione e gestireModifica glidei eventiGruppi

    Per modificare un eventogruppo, clicca sul bottonepulsante blu con l'l’icona frecciadi una freccia, che compareappare passandoal ilpassaggio del mouse sull'sull’elemento.

    SePer vuoi duplicare un eventogruppo, seleziona un singolo elemento dalla lista,lista. poiDopo cliccala selezione, compare il bottonepulsante Duplica in alto a destra..

    Per eliminare un evento, seleziona uno o più elementi dalla lista: comparirà il bottone Elimina in alto a destra. Tieni premuto CTRL e clicca per aggiungere elementi alla selezione o toglierli.

    Per copiare l'URL di un evento, usa il bottone apposito direttamente dalla lista.

    💡 Suggerimenti:

    • Quando duplichi un evento, aggiorna le chiavi di mappatura se il provider di destinazione ha una struttura JSON diversa.
    • Usa nomi descrittivi per gli eventi per facilitarne il riconoscimento nella lista.

    Collegamenti

    Last updateupdate:: 2607 May 2026

    • Back to top