# Regole degli eventi

Le regole degli eventi ti consentono di automatizzare le reazioni agli eventi dei dispositivi supportati. Apri **Dashboard** → **Regole degli eventi** per creare regole che monitorino l'iscrizione, la disiscrizione, la non conformità e gli eventi di geofence Android, per poi attivare automaticamente una o più azioni.

## Cosa può fare una regola di evento

 Ogni regola combina un **soggetto**, un **evento** e una o due **azioni**. I soggetti supportati sono **Tutti i dispositivi**, **Dispositivo specifico** e **Policy**.

- **Eventi**: dispositivo registrato, dispositivo disattivato, il dispositivo diventa non conforme, ingresso geofence, uscita geofence.
- **Azioni sul dispositivo**: disabilita dispositivo, abilita dispositivo, blocca dispositivo.
- **Azione email**: invia un'email di notifica agli amministratori e, se abilitato, ai manager delegati.

<p class="callout info"> Una regola può contenere solo un'azione email, solo un'azione dispositivo o un'azione dispositivo più un'azione email. Se sono configurate entrambe le azioni, Cerberus Enterprise esegue prima l'azione dispositivo e poi l'azione email. </p>

## Regole di piattaforma e compatibilità

 Gli eventi e le azioni disponibili dipendono dal soggetto selezionato e dalla piattaforma applicabile a quel soggetto.

- **Android** supporta l'iscrizione, la disiscrizione, la non conformità e gli eventi di geofence.
- **Apple** supporta eventi di iscrizione, disiscrizione e non conformità.
- **Disabilita dispositivo** e **Abilita dispositivo** sono azioni valide solo per Android.
- **Blocca dispositivo** e **Invia email** sono disponibili sia su Android che su Apple, quando l'evento selezionato li supporta.
- **Disattivazione del dispositivo** supporta solo l'e-mail.

## Elenco delle regole

 L'elenco delle regole di Evento è la pagina di gestione principale per questa funzionalità. Include una tabella ricercabile con nome della regola, soggetto, evento, azioni, piattaforma, stato di attivazione e ora di aggiornamento.

- Usa i chip dei filtri per passare tra tutte le regole, regole abilitate, regole disabilitate e ricerca testuale.
- Usa il pulsante **Aggiorna** per ricaricare la visualizzazione corrente della tabella.
- Usa l'interruttore di attivazione in ogni riga per abilitare o disabilitare temporaneamente una regola.
- Usa la modalità di selezione multi-riga per eliminare più regole contemporaneamente.
- Usa **Crea regola evento** per aprire l'editor per una nuova regola.

## Editor delle regole

L'editor è diviso nelle sezioni **Generale**, **Ambito**, **Trigger** e **Azioni**. In fondo alla pagina, una barra delle azioni fissa mantiene i pulsanti principali visibili mentre scorri.

### Generale

- **Nome**: obbligatorio, fino a 150 caratteri.
- **Descrizione**: opzionale, fino a 2000 caratteri.
- **Regola abilitata**: salva la regola nello stato abilitato o disabilitato.

### Ambito

 L'ambito definisce quali dispositivi la regola può corrispondere. L'editor mostra inoltre la piattaforma risolta e, quando disponibile, il contesto della policy effettiva.

- **Tutti i dispositivi**: la regola può essere applicata a tutti i dispositivi supportati in azienda.
- **Dispositivo specifico**: seleziona un dispositivo gestito dal menu di selezione.
- **Policy**: seleziona un modello di policy dal dialogo di selezione.

### Attiva

 La sezione trigger filtra automaticamente gli eventi disponibili in base all'ambito e alla piattaforma selezionati.

#### Attivazioni di geofence

 Le regole di entrata e uscita dai geofence sono supportate solo per Android e richiedono un contesto di policy Android valido. Per la segnalazione della posizione e le definizioni dei geofence, consulta [**Posizione e geofence**](https://enterprise.cerberusapp.com/docs/books/manuale-utente/page/posizione-e-geofence "Location and geofence").

- Se il soggetto è **Tutti i dispositivi**, la regola si applica sempre a **Qualsiasi geofence**.
- Se il soggetto è un dispositivo o una policy, puoi scegliere **Qualsiasi geofence** o una **Geofence specifica**.
- L'elenco specifico di geofence viene caricato dal contesto della policy effettiva del dispositivo o della policy selezionata.

### Azioni

 La sezione azioni ti consente di scegliere un'azione opzionale per il dispositivo e una notifica email opzionale. L'interfaccia nasconde automaticamente le combinazioni non supportate.

- Se non è disponibile alcuna azione per il dispositivo per l'evento e l'ambito selezionati, puoi comunque salvare una regola solo per l'e-mail.
- Se l'email è disabilitata per l'evento e la piattaforma selezionati, l'interruttore dell'email non è disponibile.
- Una regola senza alcuna azione non è valida e non può essere salvata

## Destinatari dell'e-mail

 Le messaggi email includono sempre gli utenti aziendali con il ruolo **ADMIN**. Se l'azienda è gestita tramite multi-tenancy, puoi espandere i destinatari per includere i manager MT.

- **Solo i gestori principali**: include gli amministratori dell'impresa e i contatti dei gestori principali di MT.
- **Gestori principali e gestori di sottoaccount**: aggiunge anche i gestori di sottoaccount assegnati.
- L'anteprima mostra gli indirizzi email effettivi che verranno utilizzati quando la regola viene eseguita.
- Solo i manager delegati con accesso concesso all'azienda sono inclusi nell'elenco finale dei destinatari.

## Comportamento di esecuzione

 Le regole degli eventi vengono eseguite immediatamente quando Cerberus Enterprise riceve un evento supportato dalle integrazioni del backend. Le regole disabilitate vengono saltate automaticamente.

 Le esecuzioni riuscite e fallite vengono registrate nel log di sistema con messaggi leggibili dall'uomo.