Regole destinazioni

Dove si trova: /config/destination-sync-rules — voce di menu Regole destinazioni nella sezione di configurazione.

A cosa serve

Queste regole definiscono come le anagrafiche esistenti (fornitori, clienti, spedizionieri, terminal, ...) diventano "destinazioni", cioè voci di un indice unificato dei luoghi usato per riconoscere le località nei documenti (location matching, es. le tappe di un trasporto). Per ogni anagrafica indichi quali campi alimentano la destinazione, il tipo di luogo e come trattare gli eventuali indirizzi multipli. L'effetto pratico: le località citate nei documenti vengono riconosciute e abbinate ai luoghi in anagrafica; se una regola manca o è spenta, quei luoghi non vengono proposti.

Cosa vedi

• In alto il titolo Regole destinazioni con il sottotitolo "Come le anagrafiche (fornitori/clienti/spedizionieri/terminal) diventano destinazioni per il location matching." e i pulsanti Aggiorna e Nuova regola.
• Una tabella con le regole (15 per pagina):
  • Entità — l'anagrafica sorgente.
  • Collection — l'archivio dati dell'anagrafica.
  • Chiave — il campo che identifica ogni voce (per aggiornare senza duplicare).
  • Tipo location — il tipo di luogo assegnato alle destinazioni generate.
  • Campi — quanti campi vengono mappati; se la regola gestisce anche un elenco di indirizzi, compare "+ array".
  • Attiva — casella di sola lettura.
  • 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 con chiave code.

1. Entità — scegli l'anagrafica sorgente dall'elenco (con ricerca). Alla selezione, il campo Collection viene compilato in automatico (se vuoto) e sotto compare l'elenco dei Campi disponibili dell'anagrafica, da usare come riferimento nelle mappature.
2. Collection — l'archivio dati dell'anagrafica (di norma auto-compilato).
3. Chiave — il campo dell'anagrafica che identifica la voce (es. il codice): serve per aggiornare la destinazione quando l'anagrafica cambia, senza crearne di nuove.
4. Attiva — interruttore di accensione della regola.
5. Tipo location — il tipo di luogo fisso da assegnare (es. terminal, cliente...).
6. Campo tipo location (opz.) — in alternativa al tipo fisso, il campo dell'anagrafica da cui leggere il tipo, voce per voce.
7. Array indirizzi (opz., es. destinationAddresses) — se l'anagrafica ha un elenco di indirizzi per ogni voce, indica qui il nome dell'elenco: ogni indirizzo diventa una destinazione aggiuntiva.

Seguono tre mappe (elenchi di coppie con la freccia ←; Aggiungi crea una riga, la × la elimina):

• Mappa campi (destinazione ← sorgente) — quale campo della destinazione si riempie con quale campo (o percorso) dell'anagrafica: es. nome ← ragione sociale, città ← città.
• Mappa indirizzi array (destinazione ← sotto-campo) — come sopra, ma per gli elementi dell'elenco indirizzi: campo della destinazione ← sotto-campo del singolo indirizzo. Ha senso solo se hai compilato "Array indirizzi".
• Mappa tipo location (valore → tipo) — traduce i valori grezzi trovati nel campo tipo (es. sigle interne) nei tipi di luogo normalizzati: a sinistra il valore com'è in anagrafica, a destra il tipo da assegnare.

Clicca Salva: Entità e Collection sono obbligatorie (altrimenti compare "Indica entità e collection sorgente."). A salvataggio riuscito compare "Salvato".

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

Regole gemelle per i recapiti

L'indice dei recapiti (email e domini) usato per riconoscere il mittente funziona con la stessa logica: vedi le regole recapiti.

Nomi campo esatti

Le mappe si compilano con i nomi dei campi dell'anagrafica: usa l'elenco "Campi disponibili" mostrato dopo la scelta dell'entità per evitare errori di battitura. Un nome errato non genera avvisi: semplicemente quel campo della destinazione resta vuoto.