# Classi documentali

## Panoramica

Una Classe documentale è una categoria denominata che può essere assegnata a un documento all'interno di una pratica. Funziona come un'etichetta che collega il documento a un insieme di campi metadati e, indirettamente, a una o più Policy.

Le Classi documentali sono un prerequisito per l'automazione dei destinatari basata su policy: classificando un documento e compilandone i metadati, il sistema può valutare le Policy e aggiungere automaticamente i destinatari corretti alla pratica.

Una Classe documentale **Valore predefinito** è disponibile di serie.

> Le Classi documentali fanno parte di una funzionalità controllata dal feature flag **DocumentalClass**. Quando è disabilitato, la classificazione dei documenti non è disponibile.


I Metadati del documento descrivono il documento specifico che si sta gestendo. Si tratta dei singoli dati. I valori cambiano da un documento all'altro, anche all'interno della stessa classe.

In breve: la classe è il modello, mentre i metadati sono i dati compilati di una singola istanza. Ad esempio, “Passaporto” è una Classe documentale. “Numero: X1234567, Scadenza: 2031-05-12, Paese: IT” sono i metadati di un determinato passaporto.

## Navigazione

**Impostazioni dell'organizzazione → Classi documentali**

## Classi documentali

### Elenco delle Classi documentali

L'elenco mostra tutte le Classi documentali definite con le seguenti colonne:

| Colonna | Descrizione |
|  --- | --- |
| **Classe documentale** | Nome della classe. |
| **Policy associate** | Numero di policy collegate a questa classe. |
| **Azioni** | Modifica o elimina la classe. |


Una barra di ricerca in alto consente di filtrare per nome.

### Creazione di una Classe documentale

1. Fare clic su **Nuova classe documentale**.
2. Inserire un **Nome** (obbligatorio).
3. Facoltativamente aggiungere una **Descrizione**.
4. Aggiungere campi **Metadati** alla classe documentale:
  - Selezionare un campo metadati dal menu a discesa. Verrà aggiunto automaticamente all'elenco dei campi aggiunti. Se il campo non è ancora stato definito, passare alla scheda "Metadati" e creare prima le definizioni dei campi metadati (vedere [Metadati](#metadati)).
  - **Obbligatorio** — nella tabella, attivare l'interruttore per rendere il campo obbligatorio; i campi obbligatori devono essere compilati prima che le policy possano essere applicate a una pratica.
5. Fare clic su **Crea**.


#### Aggiunta di metadati

Se i metadati sono già definiti, è possibile aggiungerli selezionandoli dal menu a discesa.

### Modifica di una Classe documentale

Fare clic su **Modifica** nella colonna Azioni. È possibile modificare il nome, la descrizione e i campi metadati selezionati.

### Eliminazione di una Classe documentale

Fare clic sull'icona di eliminazione nella colonna Azioni e confermare.

> **Vincolo:** Una Classe documentale associata a una o più Policy **non può essere eliminata**. Rimuovere prima l'associazione dalle policy interessate. Se la Classe documentale è associata a delle policy e si fa clic su Elimina, una finestra di dialogo indica chiaramente quali policy sono associate.


## Metadati

Nella scheda "Metadati" i campi sono definiti a livello globale di organizzazione. La gestione globale garantisce che lo stesso campo metadati sia definito con proprietà identiche nelle diverse classi documentali.

### Tipi di metadati

A ciascun campo metadati viene assegnato un tipo che determina il genere di valore che accetta.

| Tipo | Identificativo interno | Descrizione |
|  --- | --- | --- |
| **Stringa** | `StringType` | Un valore di testo libero. Adatto per etichette, nomi, identificativi o qualsiasi testo non strutturato. |
| **Numero** | `NumberType` | Un valore numerico (intero o decimale). Adatto per importi, conteggi o quantità misurabili. |
| **Data** | `DateType` | Un valore di data, visualizzato secondo il formato di data configurato nelle impostazioni dell'account. Adatto per scadenze, date di riferimento o marcature temporali dei documenti. |
| **Opzione da elenco** | `ListOptionType` | Un singolo valore selezionato da un insieme predefinito di opzioni. Adatto per categorie, stati o qualsiasi campo che debba essere limitato a un elenco fisso. |


> Tenere presente le seguenti limitazioni per l'**Opzione da elenco**:
- Deve essere presente almeno un'opzione
- Massimo 100 caratteri per valore
- Nessun valore duplicato
- Massimo 25 opzioni



### Creazione di una definizione di campo metadati

1. Fare clic su **Aggiungi metadati**.
2. Inserire un **Nome** (obbligatorio). Il nome del metadato viene utilizzato come etichetta del campo e come identificativo tecnico (ad es. `contract_value`).
3. Selezionare un tipo di dato
  - **Tipo di dato** — `String`, `Number`, `Date` o `List Option`. *(Per una descrizione di tutti i tipi disponibili e di come configurarli, vedere [Tipi di metadati](#tipi-di-metadati) sopra.)*
(si noti che l'obbligatorietà è definita per ciascuna classe documentale, poiché può essere diversa)
4. Fare clic su **Crea**.


> **Nota:** per il tipo Opzione da elenco, le opzioni possono essere collegate in una gerarchia padre-figlio, in modo che la selezione di un valore in un campo restringa automaticamente le opzioni disponibili in un campo correlato. Ciò semplifica l'organizzazione dei documenti secondo una logica aziendale strutturata, ad esempio per area geografica, reparto o tipo di contratto.


Successivamente, il metadato appena creato può essere utilizzato direttamente nella definizione della classe documentale (vedere sopra).

### Modifica di una definizione di campo metadati

1. Individuare il campo metadati da modificare, utilizzando il paginatore oppure la casella di ricerca in alto a destra.
2. Fare clic su **Modifica** nella riga della definizione di campo metadati che si desidera modificare.
3. Aggiornare il **Nome** o il **Tipo di dato**.
4. Fare clic su **Salva**


> **Vincolo:** Una definizione di campo metadati in uso in una qualsiasi Classe documentale **non può essere modificata**. Rimuovere prima l'associazione dalle Classi documentali interessate.


### Eliminazione di una definizione di campo metadati

Fare clic sull'icona di eliminazione nella colonna Azioni e confermare.

> **Vincolo:** Una definizione di campo metadati in uso in una qualsiasi Classe documentale **non può essere modificata**. Rimuovere prima l'associazione dalle Classi documentali interessate.


## Utilizzo delle Classi documentali nel Designer

### Assegnazione di una Classe documentale a un documento

Dopo aver caricato un documento, accedere ai tre puntini a destra del nome del file. Fare clic su Classe documentale e selezionare una delle classi disponibili.

### Valori dei metadati

Ogni Classe documentale può contenere campi metadati. Una volta assegnata una classe a un documento, i relativi campi metadati compaiono nel pannello di destra e possono essere compilati. La modifica della Classe documentale aggiorna di conseguenza l'elenco dei campi metadati e cancella eventuali valori inseriti in precedenza.

I metadati e l'assegnazione della classe possono essere modificati in qualsiasi momento mentre la pratica si trova nello stato **Bozza**.

### Applica regole della policy

Dopo aver selezionato la classe documentale e aver compilato i metadati, verificare le policy facendo clic su Altre azioni -> Applica regole della policy.
Se sono impostate condizioni sui metadati e queste corrispondono ai metadati compilati per il documento, le policy verranno applicate.

Per maggiori informazioni sulle policy vedere: [Policy](/it/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/02-products-and-modules/01-nse/02-nse-settings/organization-policies)

## Autorizzazioni

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