Create and manage Events

LaUn gestioneEvento delleconsente notifichealla si basa sulla creazionepiattaforma di un Evento (per ricevere e interpretare iinformazioni dati(tipicamente JSON) da fontiprovider esterne)esterni, collegandole a un'entità della piattaforma, come organizzazioni, progetti, oggetti, sensori e sulladispositivi.

configurazione

Per usare gli eventi per l'invio di Outputnotifiche, (perpuoi inviareconfigurare comunicazionigli condizionalioutput adalla destinatarisezione specifici)Automazioni.

Disponibile solo per utenti con permesso permesso backoffice. Per creare un evento è necessario che nel sistema siano siano già presenti le entità a cui l’evento deve essere collegato: progetto, oggetto, sensore o dispositivo.

---

Passaggi per creareCreare un Eventonuovo 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 cliccaapri sula sezione Eventi Eventinella nav raildal dimenu sinistra.laterale sinistro.
La lista mostra il nome, l'entità a cui l'evento è collegato,collegata, le direct list presenti, la data di creazione e ilun bottone per copiare l'URL dell'evento.
evento.

2. Clicca sul bottonesu Nuovo evento in alto a destra.

3.  Inserisci il Nome evento e seleziona l'entitàEntità collegata, (obbligatori):entrambi i campi sono obbligatori.

Le opzioni disponibili sono:

• Organizzazione:Organizzazione
   perPer eventi generali.

  
  
  

• Progetto:Progetto
   perPer eventi specifici di un singolo progetto.

  
  
  

• Oggetto:Oggetto
   perPer eventi legati a una classe e a una singola istanza.

  
  
  
• Sensore

  Single sensor:singolo
   perPer eventi provenienti da un singolo sensore.

  
  
  

• Device:Dispositivo
   perPer eventi generati da un insieme di sensori.

 

4. Sezione Mapping: QuestaNella sezione definisceMapping definisci come i dati in arrivo (payload JSON) devono essere interpretati.

Se

• lo

  ritieni necessario, Caricacarica il payload di esempio: Incollaincolla o carica un file JSON nella casella di esempio nella textboxtesto e clicca Conferma per generare le chiavi di mappatura.

Inserire

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

Poi

• Mappamappa le chiavi:, Associaassociando le chiavi del provider ai livellicampi dirichiesti informazionedalla previsti:piattaforma:

  • Nome: obbligatorio; rappresenta il(obbligatorio)
    Il nome dell’dell'evento.

    Esempio: nel codice del provider può comparire come event_name o  o notification_name.

    
    
    
  • Event ID: obbligatorio; identifica(obbligatorio)
    Identifica in modo univoco il tipo di evento.
     Esempio:  event_id o  o type_code.
    
    
  • Tempo (Time): obbligatorio; indicaobbligatorio)
    Indica il momento in cui l’l'evento si verifica.
     Esempio: una chiave chiamata timestamp o  o event_time.
    
    
  • Livelli (Levels): obbligatorio; definisceobbligatorio)
    Definisce la tipologia o gravità dell’dell'evento (info,  warning,  success,  error).
    Ogni livello può avere un un DisplayedNome namevisualizzato, il nome visibile quando si passapassando il cursore sull’sull'icona del livello.
     Esempio:  una chiave delcome provider come severity o  o status può essere mappata su “warning”"warning".
    
    
  • Descrizione: obbligatoria; spiega(obbligatoria)
    Spiega brevemente il contenuto o lo scopo dell’dell'evento.
  • Esempio: una chiave come message o  o details.
    
    
  • AdditionalInformazioni infoaggiuntive: facoltativo;(facoltativo)
    Aggiunge aggiungedati informazionisupplementari, aggiuntive.
    Ogniciascuno informazionecon puòun avereNome un Displayedvisualizzato name,opzionale. visibileEsempio: all’utente.
    Esempio: chiavi come temperature,  battery_status,  signal_strength.

   

   

In base alall'entità valorecolegata selezionatoselezionata in Linkedprecedentemente, to,potrebbero vengonoaggiungersi visualizzate ulteriori cardcampi obbligatorie:obbligatori:

• Project ID
  :Collega collega l’l'evento a un progetto,progetto. inEsempio: modo che venga categorizzato nel contesto del progetto associato.
  Esempio: una chiave project_id nel JSON..
  
  

• Object ID:
  Collega collega l’l'evento a un oggetto; è necessario selezionare prima la la classe oggetto.
   Esempio:  object_id o  o entity_ref.
  
  

• Single Sensor ID: identifica
  Identifica il sensore da cui proviene l’l'evento.
   Esempio:  sensor_id o  o sensor_name.
  
  

• Device ID
  : identificaIdentifica il dispositivo che raggruppa uno o più sensori.
   Esempio:  device_id o  o controller_name.
  
  

5. Salva l'evento cliccandoPer salvare, clicca Salva in alto a destra. Il bottone èrimane disabilitato finché non sono inseriticompilati nomeil enome, l'entità collegata e finché non sono state mappate tutte le chiavi obbligatorie.

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

---

Modificare e Visualizzaregestire dallagli Listaeventi

Per

• Modificamodificare un evento:, Cliccaclicca sul bottone blu con l'icona di una freccia,freccia che apparecompare alpassando passaggio delil mouse sull'elemento.

Se

• vuoi Duplicaduplicare un evento:, Appareseleziona un singolo elemento dalla lista, poi clicca il bottone 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 destradestra.

si

Per abilitaeliminare laun pagina Outputevento, aprila.

seleziona

uno

2.o Cliccapiù sulelementi dalla lista: comparirà il bottone Nuova lista.

3. Configura la Direct List:

• Inserisci un Nome listaElimina descrittivo.

  in

• Seleziona il Tipo di comunicazione (Email o Push).
  

4. Imposta la Condizione (Opzionale):

• Se vuoi limitare l'invio soloalto a specifiche occorrenze, aggiungi delle condizioni basate su occorrenze degli eventi o sui livelli (info, warning, success, error) .destra.

• 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,copiare puoil'URL aggiungeredi ancheun indirizzievento, emailusa esterni.

  il
bottone

apposito

direttamente dalla lista.

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.

💡 ControllaSuggerimenti:

il

JSON
Prima
• Quando diduplichi salvareun l'Evento,evento, assicuratiaggiorna che il JSON di esempio sia corretto per generarele chiavi di mappatura valide.
  se

  💡il Evitaprovider duplicati
  Quandodi duplichidestinazione ha una Directstruttura List,JSON modificadiversa.

sempre
• Usa almenonomi un parametro (es. i destinatari o la condizione)descrittivi per evitaregli comunicazioni doppie.

  💡 Condizioni d'invio
  Imposta le condizioni sull'output solo se vuoi limitare l'invio; se non ci sono condizioni, la notifica viene inviataeventi per ognifacilitarne occorrenzail dell'evento.

  riconoscimento nella lista.

---

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.

---

UltimoLast aggiornamentoupdate: 626 NovembreMay 20252026