Creare un evento

Questa guida spiega come creare un nuovo progettoevento all'all’interno del backofficeBackoffice di EagleArca.
Gli Ineventi questaconsentono sezionealla puoipiattaforma visualizzare,di crearericevere e gestireinterpretare iinformazioni progettiprovenienti dell'organizzazione.da provider esterni, collegandoli a organizzazioni, progetti, oggetti o dispositivi.

Disponibile solo per utenti con permesso backoffice.

---

Per creare un progettoevento è obbligatorio avere almeno un gruppo da associare.
Assicurati di aver creato in precedenza i gruppi adatti alle tue esigenze onecessario che siano già presenti nel sistema primasiano digià proseguire.presenti le entità a cui l’evento potrà essere collegato: organizzazione, progetto, oggetto, sensore o dispositivo.

---

Passaggi

1. Accedi al Backoffice

   
   Seleziona l'app Backoffice dalla pagina di selezione dell'app.
   
   

2. Accedi alla sezione ProgettiEventi

   Nella nav rail di sinistra, clicca su ProgettiEventi  per visualizzare la lista deidegli progettieventi esistenti nell'organizzazione.
   
   

3. Visualizza la lista deidegli progettieventi

   
   Nella lista vengono visualizzati il nome deldell’evento, progetto,la data di creazione, datal’entità di ultima modifica, gruppi associati, numero di classi oggettocollegata e IDun delbottone progetto.per copiare il link URL da fornire al provider. Puoi filtrare igli progettieventi usando la search bar  in alto a destra e cercare per nome. Puoi anche cambiare la visualizzazione da griglia, lista o tabella usando il selettore in alto a destra.
   
   

4. CliccaCrea suun Nuovonuovo progettoevento
   

   In alto a destra,destra clicca sul bottonesu Nuovo progettoevento per accedereaprire allala pagina di creazioneconfigurazione.
   I delcampi progetto.obbligatori da compilare sono Nome e Linked to.
   
   

5. InserisciImposta il nomecampo delLinked progettoto
   Il campo Linked to definisce l’ambito in cui l’evento opera.
   Le opzioni disponibili sono:

   Inserisci
   un
   • nome univoco

     Organizzazione: per ileventi progettogenerali.

     nel campo Nome progetto. Il nome è obbligatorio per salvare il progetto.
     
     

   • SelezionaProgetto: ilper tipoeventi specifici di missioneun singolo progetto.

     Se la tua organizzazione prevede il modulo Mission Planner e l'obiettivo del progetto è la pianificazione di missioni di robot, seleziona la tipologia di missioni da eseguire dal selettore. In caso contrario, lascia selezionato Nessuna missione.
     
     

   • VisualizzaOggetto: leper informazionieventi principalilegati a una classe o a una singola istanza.

     Alla
   destra
   • del

     Single titolo della pagina, vedrai tre chip informativesensor: cheper indicano:eventi

     provenienti da un singolo sensore.
     • Il numero

       Device: per eventi generati da un insieme di classi oggetto associate al progetto.

     • Il numero di risorse associate al progetto.
     • Il numero di gruppi associati al progetto.sensori.
       
       

   • ClassiInserisci oggettoo nelimporta progettoil payload

     
     Nella sezione ClassiPayload oggettostructure mapping vedraipuoi scrivere manualmente un elencocodice dellein classiformato oggettoJSON, presentioppure caricare un file .txt o .json che lo contenga.
     
     

     L’inserimento del payload non è obbligatorio: la mappatura può essere fatta anche manualmente compilando direttamente i campi della sezione Mapping. Caricare o scrivere un payload serve solo come supporto per facilitare la compilazione automatica dei campi.

     
     Dopo aver scritto o importato il codice, nella tuaparte organizzazione.inferiore Tuttedel campo compaiono tre bottoni:

     • Annulla: annulla le classimodifiche oggetto esistenti vengono automaticamente aggiuntefatte al progetto.
       
       contenuto;

     • AggiungiPulisci gruppitutto: alcancella progettotutto il contenuto;

       Nella

     • Conferma: propaga il codice e popola automaticamente le select nella sezione GruppiMapping cliccaa suldestra.
       
       

       bottone

   • Compila la sezione Mapping
     A destra si trova la sezione AggiungiMapping, gruppocomposta da diverse card da compilare per configurare l’evento.
     Mappare significa associare le chiavi fornite dal provider ai campi riconosciuti dalla piattaforma.
     
     In ogni card puoi scrivere manualmente la chiave corrispondente oppure, se hai importato un JSON, selezionarla dal menu a discesa che si popola automaticamente dopo aver cliccato Conferma. SiQuesto apriràprocesso rende la compilazione più rapida e riduce il rischio di errore, ma resta sempre possibile aggiungere chiavi personalizzate.
     
     Ogni campo Corresponds to serve a selezionare la chiave corrispondente nel payload. I campi presenti per la mappatura sono:
     

     
     

     • 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 modaleDisplayed dovename, potraiil primanome 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 i gruppi dalla lista a sinistra poi trascinarli nel pannello di destra per associarli al progetto. Per rimuovere un gruppo, prima selezionalo nel pannello di destra poi trascinalo nel pannello di sinistra. Per rimuovere tutti i gruppi dal progetto, clicca il bottone Pulisci in alto a destra nel pannello di destra. Per salvare la selezione dei gruppi è sufficiente premere la Xclasse oggetto.
       Esempio: inobject_id altoo aentity_ref.

       destra
     per
     • chiudere

       Single Sensor ID: identifica il modale.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.
       
       

   • Salva ill’evento
     Quando progetto

     tutti Unai voltacampi configuratoobbligatori sono compilati, il progetto, se è presente il nome ed almeno un gruppo, clicca subottone Salva in alto a destra pernella completaresezione Mapping diventa attivo.
     Cliccando Salva, EagleArca registra la creazione.mappatura Ile bottonegenera Salva rimaneun disabilitatolink URL univoco, finchévisibile nella lista eventi.
     
     Questo link deve essere fornito al provider per permettere la trasmissione dei dati verso la piattaforma. Dopo il salvataggio si sblocca anche la tab Output, che consente di configurare le Direct Lists, ovvero l’elenco di configurazioni delle notifiche relative a quell’evento.

Gli eventi vengono comunque creati e ricevuti anche se la tab Output non sono soddisfatti i requisiti minimi.

Visualizzazione del progetto creato

Dopo aver salvato il progetto, torni automaticamente alla lista dei progetti, dove il nuovo progetto è visibile.configurata. IIn gruppiquesto associaticaso alnon progettovengono hannoinviate accessocomunicazioni aesterne, quest'ultimoma ingli baseeventi airestano permessivisibili configurati.

nel

Modificarepannello unnotifiche progetto
Unadella volta creato, per modificare un progetto è sufficiente fare doppio clic sul suo nome per aprire nuovamente la pagina di modifica.

piattaforma.

---

Suggerimenti utili

💡 GestisciControlla i gruppicampi in modo efficaceobbligatori
Assicurati di aggiungere i gruppi corretti al progetto per garantire che solo gli utenti autorizzati possano accedere alle risorse e modificare le classi oggetto.

💡 Verifica i gruppi prima di salvare
Assicuratisempre che tutti i gruppicampi necessaririchiesti siano stati aggiunti al progettocompilati prima di cliccaresalvare.

su

💡 Assicurati che i nomi delle chiavi siano corretti
Una mappatura errata può compromettere la ricezione e la corretta interpretazione dei dati.

💡 Salva il testo dopo le modifiche,
Se altrimentimodifichi alcuniil payload dopo averlo importato, clicca Conferma per aggiornare la propagazione.

💡 Gestisci con cura il link URL
Il link generato è univoco e non deve essere condiviso con utenti potrebberonon autorizzati.

---

Problemi comuni

Problema	Soluzione
Il bottone Salva resta disattivato	Verifica che tutti i campi obbligatori siano compilati.
Le chiavi non averecompaiono accessonella sezione Mapping	Clicca Conferma dopo aver incollato o caricato il JSON.
Le categorie non vengono riconosciute	Controlla che le chiavi del provider corrispondano ai nomi dei livelli previsti.
Il provider non invia eventi	Verifica di aver fornito al progetto. provider il link URL corretto e che l’evento sia stato salvato.

---

Collegamenti

• CreareImpostare un nuovooutput gruppoper l’evento
• Accedere adDuplicare un progettoevento
• Eliminare un evento

---

Ultimo aggiornamento: 2610 settembreottobre 2025