Regole di segnale

Dove si trova: /config/signal-rules — voce di menu Regole di segnale nella sezione di configurazione.

A cosa serve

Le regole di segnale aggiungono messaggi dinamici (informativi, di avviso o di errore) e/o aggiustamenti del livello di confidenza su soggetti, campi dell'intestazione o righe del documento, in base ai dati del documento stesso e/o dell'entità di anagrafica ad esso associata. L'effetto pratico per chi valida: accanto al soggetto/campo/riga interessato compare il messaggio configurato con la sua severità, e la confidenza mostrata può salire o scendere (portando ad esempio un campo "verde" a richiedere attenzione).

Cosa vedi

• In alto il titolo Regole di segnale con il sottotitolo "Messaggi dinamici e aggiustamenti di confidenza su soggetti, campi e righe, in base ai dati del documento e delle entità associate." e i pulsanti Aggiorna e Nuova regola.
• Una tabella con le regole (15 per pagina):
  • Nome — nome della regola.
  • Ambito — su cosa agisce: Party (soggetto), Field (campo di testata), Item (riga).
  • Target — il ruolo del soggetto (per ambito Party) oppure il nome del campo interessato.
  • Tipo doc — il tipo di documento (spesso * = tutti).
  • Effetto — riepilogo: l'eventuale confidenza impostata (=NN%) o la variazione (+/-NN%), più il badge di severità.
  • Attiva — casella di sola lettura che indica se la regola è accesa.
  • Pulsanti di modifica ed eliminazione.
• Cliccando su modifica o Nuova regola compare sotto il pannello di modifica con Salva e Annulla.

Cosa puoi fare

Creare o modificare una regola

Una nuova regola parte attiva, valida per tutti i tipi (*), con ambito Party, condizioni combinate in AND e severità Warning.

Riga principale:

1. Nome — nome della regola (obbligatorio: altrimenti compare "Indica un nome per la regola.").
2. Ambito — dove applicare il segnale: Party (un soggetto del documento), Field (un campo dell'intestazione), Item (le righe).
3. In base all'ambito:
   • con Party compare Ruolo soggetto (vuoto = tutti) — limita la regola a un ruolo (Supplier, Customer, Buyer, Seller, Shipper, Consignee, Provider, ForwarderCarrier) o lasciala valida per tutti i soggetti;
   • con Field o Item compare Campo target — il nome del campo su cui applicare messaggio e aggiustamento.
4. Tipo doc — il tipo di documento a cui la regola si applica (testo libero; * = tutti).
5. Priorità — ordina l'applicazione tra più regole.

Seconda riga:

• Collection entità associata (per MatchedEntity) — l'archivio dell'anagrafica associata al target (esempio suggerito: prodotti o fornitori). Serve quando le condizioni leggono i dati dell'entità abbinata al soggetto/campo.
• Combina condizioni — And (tutte le condizioni devono valere) oppure Or (ne basta una).
• Attiva — interruttore di accensione della regola.

Sezione "Condizioni" — l'elenco delle condizioni da verificare; Aggiungi crea una riga, la × la elimina. Ogni condizione confronta due lati (sinistro e destro):

• Sorgente sx / Sorgente dx — da dove viene il valore: DocumentField (un campo del documento), MatchedEntity (un campo dell'entità di anagrafica associata), Constant (un valore fisso).
• Campo/valore sx / dx — con sorgente Constant scrivi direttamente il valore; con le altre sorgenti scrivi il nome del campo.
• Operatore — Equal (uguale), NotEqual (diverso), Contains (contiene), NotContains (non contiene), Greater / GreaterOrEqual (maggiore / maggiore o uguale), Less / LessOrEqual (minore / minore o uguale), Empty (vuoto), NotEmpty (non vuoto), Regex (criterio di ricerca sul testo).
• Confronto — come interpretare i valori: String (testo) o Numeric (numero).
• Toll. — tolleranza numerica ammessa nel confronto.

Sezione "Effetto" — cosa succede quando le condizioni sono soddisfatte:

• Delta confidenza — variazione della confidenza del target (es. -0,2 per abbassarla del 20%).
• Imposta confidenza — in alternativa, un valore fisso di confidenza da assegnare.
• Severità — Info, Warning o Error: colora il messaggio mostrato all'operatore.
• Messaggio (placeholder {value} {field} {entity.campo}) — il testo del messaggio; puoi usare i segnaposto {value} (il valore del target), {field} (il nome del campo) e {entity.campo} (un valore dell'entità associata).

Clicca Salva (compare "Salvato") oppure Annulla.

Eliminare una regola

Cestino sulla riga → conferma "Eliminare questa regola?" con Elimina / Annulla.

Aggiornare l'elenco

Il pulsante Aggiorna ricarica le regole.

Buono a sapersi

Quando vengono valutate

Le regole di segnale vengono valutate al termine dell'elaborazione del documento: i messaggi e le confidenze aggiornate sono già visibili quando il documento arriva in validazione. Modificando una regola, l'effetto si vede sui documenti elaborati da quel momento in poi.

Un esempio d'uso

"Se il fornitore riconosciuto è bloccato in anagrafica, mostra un errore": ambito Party, ruolo Supplier, condizione MatchedEntity.blocked uguale alla costante true, effetto severità Error con messaggio "Fornitore bloccato".

Delta e valore fisso insieme

Se compili sia "Delta confidenza" sia "Imposta confidenza", nel riepilogo della tabella prevale il valore fisso: usa uno solo dei due per evitare ambiguità.