Fillers
I filler sono componenti configurabili utilizzati per estrarre e popolare automaticamente informazioni strutturate dai documenti. Definiscono come dati specifici (tag, lingua e classi documentali) vengono identificati e recuperati dal contenuto del documento.
I moduli di compilazione vengono generalmente utilizzati in combinazione con i flussi di lavoro di elaborazione dei documenti per consentire l'estrazione automatizzata dei dati e ridurre l'inserimento manuale.
Gestione dei filler
In Amministrazione > Intelligenza Artificiale > Filler, è possibile gestire i riempitivi dal pannello dedicato.
Il pannello dei filler fornisce un elenco di tutti i filler configurati e consente di:
- Visualizza i riempitivi esistenti
- Crea nuovi riempitivi (Aggiungi riempitivo)
- Modifica la configurazione dei riempitivi
- Elimina i riempitivi
Ciascun elemento di riempimento viene visualizzato con i seguenti attributi:
- Nome: identificativo interno del filler
- Etichetta: Nome di facile comprensione visualizzato nell'interfaccia
- Tipo: Strategia di estrazione utilizzata dal filler
- Descrizione: Dettagli aggiuntivi sullo scopo del filler
- Sovrascrivi: se selezionato, la funzione di compilazione sovrascrive le informazioni già inserite.
- Compila al check-in: se selezionato, il documento viene compilato automaticamente al momento del check-in.
Quando crei un nuovo elemento di riempimento facendo clic su Aggiungi filler, ti verrà richiesto di selezionare uno dei filler disponibili.

Proprietà del filler
Ogni filler viene configurato tramite il pannello proprietà del filler, dove si definisce come viene eseguita l'estrazione e quali tecnologie vengono utilizzate.
La configurazione è dinamica: alcuni campi vengono visualizzati o modificati a seconda del tipo di filler e della strategia selezionati.
Al momento della stesura di questo testo, è possibile scegliere tra le seguenti tipologie di riempimento:
- Tag: Assegna un valore a un campo in base alla somiglianza semantica o alla classificazione
- Lingua: Assegna la lingua del documento in base all'analisi del contenuto
- Classe documentale: Assegna una classe documentale in base alla somiglianza semantica
- Catena: Assegna valori combinando più elementi di riempimento in sequenza
Filler dei tag
Quando il campo di testo selezionato è di tipo Tag, è necessario definire una Strategia che determini come viene recuperato il valore, insieme a un valore di Soglia (Threshold) che definisca il livello minimo di confidenza richiesto per accettare un risultato.

Le strategie disponibili sono: Modello di IA e Somiglianza semantica. Inoltre, la strategia selezionata influisce sui campi aggiuntivi richiesti.
- Modello di IA (Model-based)
Utilizza un modello di machine learning per classificare o estrarre direttamente il valore.- Modello: per la selezione di uno specifico modello di IA (questa impostazione deve fare riferimento a un modello precedentemente configurato).

- Modello: per la selezione di uno specifico modello di IA (questa impostazione deve fare riferimento a un modello precedentemente configurato).
- Somiglianza semantica (basata sul recupero)
Utilizza la ricerca di similarità vettoriale sugli embedding per recuperare il contenuto più pertinente.- Schema di embedding: per la selezione di uno schema di embedding specifico (questa impostazione deve fare riferimento a uno schema di embedding configurato in precedenza).

- Schema di embedding: per la selezione di uno schema di embedding specifico (questa impostazione deve fare riferimento a uno schema di embedding configurato in precedenza).
Filler della lingua
Quando il filler selezionato è di tipo Lingua, è necessario definire un Modello per specificare il modello di IA utilizzato per l'estrazione.

Filler della classe documentale
Un filler di tipo classe documentale non presenta campi obbligatori aggiuntivi.
Il Filler della classe documentale è uno strumento specializzato utilizzato per assegnare automaticamente un modello a un documento in base al suo contenuto.
Anziché estrarre un singolo campo, questo strumento esegue una classificazione semantica, identificando la classe documentale che meglio si adatta al documento.
Filler degli attributi
Quando il riempitivo selezionato è di tipo Attributo, oltre alle informazioni di base, è necessario definire tre parametri importanti (Modello, Etichetta candidata e Attributo).
- Modello: Selezionare il modello YOLO (vedere Rilevamento oggetti per ulteriori informazioni) che verrà utilizzato per rilevare la regione desiderata all'interno del documento.
- Etichetta candidata: Specificare il nome della classe di oggetti da rilevare. Il valore deve corrispondere esattamente a una delle etichette (categorie) definite durante l'addestramento del modello YOLO, ad esempio DATA, TOTALE o NUMERO_FATTURA. Durante l'elaborazione, il modello cerca i rilevamenti con l'etichetta specificata.
- Attributo: Selezionare l'attributo del documento che riceverà il valore estratto. Una volta rilevata la regione specificata, viene applicato l'OCR a tale regione e il testo estratto viene memorizzato nell'attributo selezionato.

Criteri dell'Attribute Filler
Quando un Attribute Filler ricerca un'etichetta candidata, il modello YOLO può rilevare più oggetti appartenenti alla stessa categoria. Ad esempio, una fattura può contenere più valori etichettati come TOTAL, DATE o NUMBER.
I criteri consentono di individuare il candidato più appropriato valutandone la posizione rispetto alle altre etichette rilevate. Ogni criterio soddisfatto aumenta il punteggio del candidato. Il candidato con il punteggio più alto viene selezionato per l'elaborazione OCR e per le successive fasi di estrazione.
Un criterio è composto da tre elementi:
- Operator: definisce la relazione spaziale da valutare.
- Operand: l'etichetta di riferimento utilizzata per il confronto.
- Metric: un valore di distanza opzionale utilizzato solo dagli operatori basati sulla distanza.

Operatori disponibili:
| Operatore | Descrizione |
|---|---|
| Above | Il candidato si trova sopra l'etichetta di riferimento. |
| Below | Il candidato si trova sotto l'etichetta di riferimento. |
| Left | Il candidato si trova a sinistra dell'etichetta di riferimento. |
| Right | Il candidato si trova a destra dell'etichetta di riferimento. |
| Included | Il candidato è completamente contenuto all'interno dell'etichetta di riferimento. |
| Topmost | Il candidato è il più in alto tra tutte le etichette del tipo di riferimento specificato. |
| Bottommost | Il candidato è il più in basso tra tutte le etichette del tipo di riferimento specificato. |
| Leftmost | Il candidato è il più a sinistra tra tutte le etichette del tipo di riferimento specificato. |
| Rightmost | Il candidato è il più a destra tra tutte le etichette del tipo di riferimento specificato. |
| Max Distance | Il candidato si trova entro la distanza massima specificata dall'etichetta di riferimento. |
Catena di filler
Quando il filler selezionato è di tipo Lingua, è necessario definire una catena di filler nella tabella, sul lato destro del pannello. Il filler funge da pipeline di più filler eseguiti in sequenza.
In questo caso, la tabella consente di:
- Aggiungi filler alla catena
- Riordina l'esecuzione (drag & drop)
- Rimuovi i filler

Automazione
È possibile eseguire il proprio script di automazione prima e dopo ogni esecuzione del filler.

Dizionario disponibile per l'Automazione in questo contesto
| CONTESTO DI AUTOMAZIONE: FILLER | ||
|---|---|---|
| Variabile | Classe Java | Descrizione |
| filler | ExtensibleObject | lo stesso filler attualmente in esecuzione |
| document | Document | il documento in fase di compilazione |
| transaction | DocumentHistory | l'evento corrente |
| value | Value | contiene la rappresentazione in stringa del valore riempito |
| fillerDictionary | Map | dizionario della pipeline di esecuzione del riempimento corrente |
Leggi il manuale dell'Automazione per maggiori informazioni.