Aggiungere un campo a un tipo documento

Vuoi che da domani, sulle fatture, il sistema estragga anche — ad esempio — il CIG? Questa guida percorre tutti i passaggi: dire al sistema di estrarre il campo, mostrarlo in validazione e, se serve, portarlo nell'export. Nessuno di questi passaggi richiede uno sviluppo: è tutto configurabile dall'interfaccia.

I tre livelli di un campo

Livello	Dove si configura	Cosa decide
Estrazione	Schema documenti	Il sistema cerca il campo nel documento
Visualizzazione	Configurazione UI documenti	Il campo si vede (ed è modificabile) in validazione
Uscita	Export / connettore	Il campo esce nei file esportati o verso il gestionale

In alternativa ai primi due passaggi separati puoi usare la pagina Configurazione tipo documento, che riunisce estrazione e visualizzazione in un unico editor per campo.

1. Aggiungi il campo allo schema di estrazione

1. Apri Schema documenti (/config/document-schema) e seleziona il tipo documento (es. Fattura).
2. Aggiungi il campo nella sezione giusta: tra i campi di testata oppure tra le colonne di riga.
3. Dagli un nome e, soprattutto, una descrizione chiara: è l'istruzione che l'intelligenza artificiale usa per trovare il dato nel documento (es. "Codice CIG: codice alfanumerico di 10 caratteri presente vicino ai riferimenti dell'ordine").
4. Nel pannello avanzato puoi aggiungere vincoli: formato, valori ammessi, obbligatorietà.
5. Salva.

La descrizione è metà del lavoro

Più la descrizione è precisa (dove si trova il dato, che forma ha, con cosa non va confuso), migliore sarà l'estrazione. Se il campo non viene estratto bene, il primo intervento è rifinire la descrizione.

2. Rendi visibile il campo in validazione

1. Apri Configurazione UI documenti (/config/document-ui) e seleziona lo stesso tipo documento.
2. Usa Sincronizza da schema per importare i campi nuovi, oppure aggiungi il campo a mano.
3. Imposta l'etichetta mostrata all'utente, la posizione e le opzioni (modificabile, nascosto, visibile solo se valorizzato...).
4. Salva.

Da questo momento il campo compare nella pagina di validazione dei nuovi documenti.

3. (Se serve) Porta il campo in uscita

Se il dato deve arrivare nei file esportati o al gestionale, aggiungilo alla configurazione di Export o alle associazioni del connettore.

4. Prova con un documento vero

1. Carica un documento di prova che contiene il dato.
2. Al termine dell'elaborazione, aprilo in validazione: il campo deve comparire, valorizzato, con l'evidenziazione sul documento al clic.
3. Se il valore è vuoto o sbagliato, torna allo schema e rifinisci la descrizione o i vincoli.

I documenti già elaborati non cambiano

Il nuovo campo viene estratto solo dai documenti elaborati da quel momento in poi. Per un documento già presente puoi usare il pulsante Riprocessa nella pagina di validazione.

Varianti utili

• Etichetta in più lingue: aggiungi la traduzione del campo nella pagina Traduzioni (vedi Tradurre le etichette).
• Campo da abbinare a un'anagrafica (es. un codice da risolvere contro i prodotti): oltre allo schema, crea una regola di matching per quel campo.
• Campo calcolato di un'anagrafica (derivato da altri campi con una formula): si configura in Campi entità.