Regole di relazione

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

A cosa serve

Le regole di relazione stabiliscono come, dopo che l'operatore conferma gli abbinamenti di un documento, la piattaforma collega i documenti tra loro attorno a un documento "radice" (hub), ad esempio: ordine d'acquisto → righe dell'ordine → DDT e fatture collegati. L'effetto pratico: salvando un documento validato, la piattaforma costruisce (o aggiorna) la relazione visibile nella sezione "Relazioni" del documento e nella pagina di riconciliazione, su cui girano anche i controlli di coerenza.

Cosa vedi

• In alto il titolo Regole di relazione, il conteggio delle regole e i pulsanti Nuova regola e Aggiorna.
• Una tabella con le regole (15 per pagina):
  • Nome — nome della regola.
  • Documento — il tipo di documento sorgente (quello che, al salvataggio, fa scattare la costruzione della relazione).
  • Hub (radice) — il tipo del documento radice della relazione (es. PurchaseOrder).
  • Collection entità — l'archivio dell'anagrafica abbinata da cui si ricavano i dati della relazione.
  • Soglia Mapped — la percentuale di confidenza sopra la quale il collegamento è considerato certo ("Mapped") anziché dubbio.
  • Pulsanti di modifica ed eliminazione.
• Cliccando su modifica o Nuova regola si apre il pannello con Salva e Annulla.

Cosa puoi fare

Creare o modificare una regola

Questa è una configurazione tecnica: i campi si compilano con nomi e percorsi interni, aiutandosi con gli esempi suggeriti nelle caselle. In caso di dubbio, parti da una regola esistente.

1. Nome — nome della regola (obbligatorio).
2. Tipo documento sorgente — il tipo di documento che genera la relazione (esempio suggerito: "ddt / invoice"); l'elenco propone i tipi configurati ma ammette testo libero.
3. Path ipotesi (selezione entità) — indica in quale campo del documento cercare l'abbinamento confermato dall'operatore (esempio suggerito: il codice articolo delle righe). Da lì la piattaforma risale alla voce di anagrafica scelta.
4. Collection entità matchata — l'archivio dell'anagrafica abbinata (esempio: righe d'ordine).
5. Tipo radice (hub) — il tipo del documento radice attorno a cui raggruppare (esempio: PurchaseOrder).
6. Campo chiave radice — il campo dell'anagrafica che identifica la radice (esempio: identificativo dell'ordine): le voci con la stessa chiave finiscono nella stessa relazione.
7. Soglia Mapped (0..1) — sotto questa confidenza il collegamento viene marcato come dubbio, sopra come certo.

Seguono tre riquadri di mappatura (elenchi di coppie "proprietà ← campo"; il + aggiunge una riga, la × la elimina). Determinano quali dati compaiono nella vista relazioni e quali valori sono disponibili per i controlli di coerenza:

• Mapping radice (proprietà ← campo entità) — proprietà della radice della relazione ← campo dell'anagrafica (esempio suggerito: EntityNumber ← orderNumber).
• Mapping riga (proprietà ← campo entità) — proprietà della riga ← campo dell'anagrafica (esempio: EntityQuantity ← quantity).
• Mapping documento (proprietà ← path documento) — proprietà del documento collegato ← campo del documento sorgente (esempio: DocumentQuantity ← il campo quantità della riga).

Sezione "Quando applicare questa regola" — ambito di applicabilità opzionale (gruppi e/o condizioni), identico a quello descritto nelle regole di matching. Vuoto = si applica sempre.

Clicca Salva: il Nome è obbligatorio. Se in una mappatura ripeti la stessa proprietà su più righe, vale l'ultima; le righe con proprietà vuota vengono ignorate.

Eliminare una regola

Cestino sulla riga → conferma "Eliminare la regola "..."?" con Elimina.

Aggiornare l'elenco

Il pulsante Aggiorna ricarica la tabella e chiude il pannello di modifica.

Buono a sapersi

Da dove nasce il collegamento

La relazione parte sempre dall'abbinamento fatto (o confermato) in validazione tramite le regole di matching: se l'operatore non ha scelto una voce nella colonna Mappatura, non c'è nulla da collegare. La soglia Mapped decide solo se il collegamento è mostrato come certo o come dubbio.

Configurazione delicata

Nomi di campi e percorsi devono corrispondere esattamente a quelli usati dal tipo documento e dall'anagrafica: un errore di battitura non genera messaggi, semplicemente la relazione non si costruisce o resta incompleta. Modifica queste regole con l'aiuto di chi ha configurato il flusso.