# Policy

## Panoramica

Una Policy definisce un insieme di condizioni e azioni che vengono valutate rispetto ai metadati di un documento. Se tutte le condizioni sono soddisfatte, la policy aggiunge automaticamente alla pratica i destinatari definiti.

Le Policy sono collegate a una **Classe documentale** e vengono valutate nel Designer tramite l'azione **Applica regole della policy**. Questo consente alle organizzazioni di automatizzare l'instradamento dei destinatari in base al contenuto del documento — ad esempio richiedendo l'approvazione di un responsabile ogni volta che il valore di un contratto supera una determinata soglia.

> Le Policy fanno parte di una funzionalità controllata dal feature flag **DocumentalClass**. Quando è disabilitato, le policy non sono disponibili.


## Navigazione

**Impostazioni dell'organizzazione → Policy**

## Elenco delle Policy

L'elenco mostra tutte le Policy definite con le seguenti colonne:

| Colonna | Descrizione |
|  --- | --- |
| **Policy** | Nome della policy. |
| **Descrizione** | Descrizione della policy. |
| **Abilitato** | Selezionato se la policy è abilitata. |
| **Azioni** | Modifica o elimina la policy. |


## Creazione di una Policy

Fare clic su **Nuova policy** e compilare il modulo.

### Campi di base

| Campo | Obbligatorio | Descrizione |
|  --- | --- | --- |
| **Nome** | Sì | Identifica la policy. |
| **Descrizione** | No | Nota in testo libero per fornire contesto. |
| **Classe documentale** | No | Collega la policy a una specifica Classe documentale. La selezione di una classe abilita la sezione Condizioni. |
| **Abilitato** | — | Interruttore per attivare o disattivare la policy. Abilitato per impostazione predefinita. |


### Condizioni

Le condizioni sono disponibili solo quando è selezionata una **Classe documentale**. Definiscono le regole che devono essere soddisfatte affinché le azioni della policy vengano applicate.

Ogni condizione è composta da:

- **Metadato** — un campo metadati definito sulla Classe documentale selezionata.
- **Condizione** — un operatore di confronto. Gli operatori disponibili dipendono dal tipo di dato del campo:
  - **Stringa** → `equals`
  - **Numero** → `equals`, `greater than`, `less than`
  - **Data** → `equals`, `greater than`, `less than`
  - **Opzione da elenco** → `equals`
- **Valore** — il valore con cui effettuare il confronto.


È possibile aggiungere più condizioni tramite **Aggiungi condizione** (＋). Tutte le condizioni vengono valutate con logica **AND** — ogni condizione deve essere soddisfatta affinché le azioni vengano applicate.

### Azioni

Le azioni definiscono i destinatari che vengono aggiunti alla pratica quando tutte le condizioni corrispondono. Sono disponibili tre opzioni:

- **Aggiungi destinatario** — aggiunge un singolo destinatario. Campi: E-mail, Nome, Cognome, Numero di telefono.
- **Aggiungi gruppo** — aggiunge un gruppo di destinatari.
- **Aggiungi da Gruppo utenti** — aggiunge destinatari provenienti da un Gruppo utenti dell'organizzazione.
  - Selezionare il gruppo utenti, il responsabile amministrativo e il tipo di destinatario. Se non viene selezionato alcun responsabile amministrativo, verranno aggiunti tutti gli utenti del gruppo utenti nel caso in cui le condizioni siano soddisfatte.


È possibile definire più azioni. Ogni azione rappresenta un destinatario o un gruppo da aggiungere alla pratica.

Fare clic su **Salva** per creare la policy.

## Modifica ed eliminazione delle Policy

Utilizzare le azioni **Modifica** ed **Elimina** nella tabella dell'elenco delle Policy.

## Applicazione delle Policy nel Designer

Una volta che ai documenti di una pratica in Bozza è stata assegnata una Classe documentale e i relativi valori di metadati sono stati compilati, le policy possono essere valutate:

1. Nel Designer, aprire il menu **Altre azioni**.
  1. L'applicazione delle policy è disponibile solo per le pratiche e non per i modelli
2. Selezionare **Applica regole della policy**.


Dopo aver fatto clic su **Applica regole della policy**, viene visualizzata una finestra di dialogo che informa che alla pratica potrebbero essere aggiunti dei destinatari.

Il sistema quindi:

- Individua tutte le Classi documentali assegnate ai documenti della pratica.
- Recupera tutte le policy collegate a tali classi.
- Valuta le condizioni di ciascuna policy rispetto ai valori effettivi dei metadati del documento.
- Per ogni policy in cui **tutte le condizioni corrispondono**, aggiunge alla pratica i destinatari definiti, a meno che tali destinatari non siano già presenti.


> Se più policy corrispondono, **Applica regole della policy** le applica in ordine di data di creazione, a partire dalla meno recente.


> **Applica regole della policy può essere eseguito più volte.** I destinatari già aggiunti da un'esecuzione precedente non verranno duplicati.


> **I metadati obbligatori devono essere compilati prima dell'esecuzione.** Se un campo metadati obbligatorio è vuoto, il sistema restituisce un errore e la valutazione non prosegue.


> **Le policy non vengono applicate quando si crea una pratica da un modello.** Le Classi documentali e i valori dei metadati vengono ereditati, ma la valutazione delle policy deve essere avviata manualmente nel Designer.


## Autorizzazioni

L'accesso alle Policy in Impostazioni dell'organizzazione è riservato agli **amministratori dell'organizzazione**.