DB di frontiera¶
A cosa serve¶
Il DB di frontiera e' il sistema di sincronizzazione automatica dei dati tra il gestionale AREA e un gestionale esterno (HOST) del cliente. Serve a mantenere allineate anagrafiche, documenti, prezzi, ordini e altri dati tra i due sistemi senza intervento manuale. Ogni cliente che necessita di un collegamento dispone di una propria istanza del DB di frontiera, ospitata su un database PostgreSQL.
Il sistema e' utile quando il cliente opera con un gestionale proprio (HOST) e vuole che i dati fluiscano automaticamente da e verso AREA: ad esempio, le anagrafiche clienti vengono importate dall'HOST, i documenti di magazzino vengono scambiati in entrambe le direzioni, e le fatture emesse da AREA vengono esportate verso l'HOST.
Ambiti coperti¶
I processi di sincronizzazione coprono circa 30 tabelle organizzate in due aree:
- Anagrafico: clienti/fornitori, indirizzi, contatti, articoli, listini prezzi, gruppi sconto, tecnici, matricole di assistenza
- Movimentazione: documenti di magazzino, fatture, ordini di vendita, interventi di assistenza, scadenzario
Come funziona¶
La sincronizzazione e' gestita da un insieme di processi automatici. Ogni processo si occupa di una specifica tipologia di dati (ad esempio: anagrafiche, prezzi, documenti). I processi vengono eseguiti a intervalli regolari da uno schedulatore esterno (PgAgent): ogni processo, all'avvio, verifica se e' il momento di eseguire e, in caso affermativo, effettua l'importazione, l'esportazione o entrambe.
Il pannello di controllo permette di configurare e monitorare ogni singolo processo.
Prerequisiti¶
Prima di utilizzare il DB di frontiera e' necessario:
- Disporre di un database PostgreSQL raggiungibile dalla postazione AREA
- Configurare i parametri di connessione nel gruppo dbfront della configurazione di sistema
- Caricare la tabella dei processi di sincronizzazione nell'ambiente del cliente
Configurazione iniziale¶
Passo 1 -- Parametri di connessione¶
Accedere alla configurazione di sistema e impostare i parametri del gruppo dbfront:
| Parametro | Descrizione |
|---|---|
| Sincronizzazione attiva | Pulsante di accensione generale: attiva o disattiva tutti i processi |
| Email segnalazioni | Indirizzo e-mail per ricevere notifiche in caso di errori gravi |
| Tipo database | Tipologia del database (attualmente solo PostgreSQL) |
| Stringa di connessione | Dati di accesso al database: host, porta, nome database, utente, password |
| Stringa di connessione DDL | Connessione con permessi di livello superiore (per operazioni DDL) |
| Livello log globale | Livello di dettaglio del log per tutti i processi |
| Inversione segno sconti | Attivare se gli sconti dell'HOST vengono esportati con segno negativo |
Passo 2 -- Caricamento tabella processi¶
La tabella dei processi disponibili va copiata manualmente nell'ambiente del cliente. Il file sorgente si trova nel percorso di distribuzione standard.
Passo 3 -- Pannello di controllo¶
- Accedere al pannello di controllo DB Frontiera da Sistema > Archivi > Sincronizzazioni > Pannello di controllo DB Frontiera
- Attivare la casella Sincronizzazione attiva: il sistema tenta una connessione di prova al database. Se la connessione riesce, disattivare nuovamente la sincronizzazione
- Configurare i singoli processi nella griglia: tempo di attesa, livello log, eventuale limite di righe per i test
- Attivare i processi desiderati con doppio clic sulla colonna Attivo?
- Riattivare la casella Sincronizzazione attiva per rendere operativa la sincronizzazione
Pannello di controllo¶
Il pannello presenta una griglia con una riga per ogni processo di sincronizzazione. Le colonne principali sono:
| Colonna | Descrizione | Modificabile |
|---|---|---|
| Nome | Codice mnemonico del processo | |
| Descrizione | Descrizione breve | |
| Attivo | Attiva/disattiva il singolo processo. Valori: Attivo, Disattivo, solo Import, solo Export | Si |
| Tempo di attesa | Minuti tra un'esecuzione e la successiva (da 1 a 99.999.999) | Si |
| Forzo esecuzione | Forza l'esecuzione immediata (si disattiva automaticamente al termine) | Si |
| Ultima esecuzione | Data e ora dell'ultima esecuzione | |
| Prossima esecuzione | Data e ora della prossima esecuzione pianificata | |
| In corso | Indica se il processo e' in esecuzione | |
| Errori | Numero di errori nell'ultima esecuzione | |
| Messaggio | Ultimo messaggio di errore | |
| Livello log | Livello di dettaglio del log per il processo | Si |
| Ultimo aggiornamento | Data e ora dell'ultimo record importato o esportato | Si |
| Limita righe | Se > 0, elabora solo le prime N righe (utile in fase di test) | Si |
| Limita errori | Se > 0, limita le segnalazioni di errore alle prime N | Si |
Operazioni frequenti¶
- Attivare un processo: doppio clic sulla colonna Attivo?
- Forzare un'esecuzione immediata: spuntare Forzo esecuzione sul processo desiderato; il processo viene avviato alla prima verifica dello schedulatore
- Limitare le righe per test: impostare un valore in Limita righe per testare la sincronizzazione con pochi record
- Consultare gli errori: controllare le colonne Errori e Messaggio per diagnosticare problemi
Elenco dei processi¶
Processi di importazione anagrafica¶
Questi processi importano dati dall'HOST verso AREA. Alcuni includono un'elaborazione settimanale che verifica l'allineamento completo e marca come cancellati i record non piu' presenti sull'HOST.
| Processo | Dati sincronizzati | Note |
|---|---|---|
| ANAGR | Anagrafiche clienti/fornitori | Settimanale: marca come cancellate le anagrafiche non piu' esistenti |
| INDIR | Indirizzi (destinazioni) | |
| CONTATTI | Contatti | Settimanale: marca come cancellati i contatti non piu' esistenti |
| MERCI | Articoli (merci e prestazioni) | Settimanale: marca come cancellati gli articoli non piu' esistenti |
| PREZZI | Listini prezzi | Settimanale: cancella i prezzi non piu' esistenti |
| GRUPPISCONTO | Testata gruppi sconto | |
| SCONTI | Dettaglio sconti | Settimanale: cancella sconti non piu' esistenti |
| ANAGRSCONTI | Gruppi sconto per anagrafica | Settimanale: cancella raccordi non piu' esistenti |
| MAGAZ | Magazzini | |
| GIACENZE | Giacenze | |
| MATR-ASSI | Matricole assistenza | |
| KITINTTES | Kit di intervento (testata) | |
| KITINTDET | Kit di intervento (dettaglio) | |
| UBICAZIONI | Ubicazioni | |
| POSTIT | Note post-it | |
| SETTIPICO | Set tipico | Settimanale: pulizia clienti non referenziati |
| BACKORDER | Backorder | Settimanale: cancella backorder non piu' esistenti |
| BUDGETOMAGGI | Budget omaggi | |
| DISTINTAMATR | Distinta matricole | |
| TECNICI | Tecnici | |
| SCADEX | Scadenzario extracontabile | Copia semplificata dello scadenzario HOST, separata dallo scadenzario ufficiale AREA |
Processi di import/export¶
Questi processi lavorano in entrambe le direzioni: importano dati dall'HOST e esportano dati verso l'HOST.
| Processo | Dati sincronizzati |
|---|---|
| DOCMAG | Documenti di magazzino (bolle, DDT, ecc.) |
| ORDINI | Ordini di vendita |
| CHIAMATE | Chiamate e interventi di assistenza |
Processi di sola esportazione¶
Questi processi esportano dati da AREA verso l'HOST.
| Processo | Dati esportati |
|---|---|
| SETTIPICOVAR | Variazioni su set tipico |
| BACKORDERVAR | Variazioni su backorder |
| SCADEXPAG | Pagamenti scadenzario extracontabile |
| FATTURECLI | Fatture e note di accredito clienti |
Dettaglio processi principali¶
Anagrafiche¶
L'importazione delle anagrafiche clienti/fornitori funziona con un meccanismo di raccordo automatico:
- Se l'anagrafica esiste gia' in AREA (riconosciuta tramite codice AREA o codice HOST): viene aggiornata
- Se l'anagrafica non esiste: viene inserita come nuova
L'elaborazione settimanale controlla tutte le anagrafiche AREA e marca come cancellate quelle non piu' presenti nell'HOST, sanando eventuali disallineamenti dovuti a esportazioni di massa.
Contatti¶
L'importazione dei contatti cerca di riconoscere un contatto gia' esistente in piu' modi:
- Per codice contatto AREA, se presente
- Per codice HOST registrato sul contatto
- Per corrispondenza del nome
Se nessun contatto viene riconosciuto, ne viene creato uno nuovo.
Prezzi¶
Un prezzo viene identificato dalla combinazione merce + listino:
- Se il codice listino corrisponde a un cliente HOST: viene trattato come prezzo particolare del cliente
- Altrimenti viene cercato il raccordo con un listino AREA
- Se il raccordo non viene trovato: il record viene segnalato come errore
Documenti di magazzino¶
Il processo puo' funzionare in importazione, esportazione o entrambe le direzioni.
Importazione: i documenti provenienti dall'HOST vengono inseriti o aggiornati in AREA. Se un documento e' stato generato in AREA e successivamente modificato dall'HOST, la modifica viene ignorata (il documento AREA ha la precedenza).
Esportazione: il sistema esporta i documenti nuovi e quelli modificati dopo l'ultima esportazione. Non vengono esportate le variazioni su documenti generati dall'HOST.
Per forzare la riesportazione di un documento: modificare il documento (il flag di esportazione viene reimpostato automaticamente) oppure utilizzare l'apposita funzione di gestione.
Chiamate e interventi¶
Importazione chiamate: vengono importate solo le richieste nuove generate dall'HOST. Le variazioni dell'HOST su richieste gia' importate non vengono considerate.
Esportazione interventi: gli interventi chiusi in AREA vengono esportati verso l'HOST con i relativi documenti e chiamate collegate.
Fatture¶
Le fatture e le note di accredito clienti vengono esportate verso l'HOST.
Attenzione: l'esportazione di una fattura ne impedisce la modifica e la cancellazione. Per questo motivo il processo FATTURECLI non va messo in schedulazione automatica, ma va eseguito manualmente (tramite il pulsante Forzo esecuzione nel pannello di controllo) solo quando le fatture sono state verificate e sono pronte per l'invio.
Scadenzario extracontabile¶
Lo scadenzario importato dall'HOST e' una copia semplificata che viene mantenuta separata dallo scadenzario ufficiale AREA. Al termine di ogni elaborazione, i record presenti in AREA ma non piu' presenti nell'HOST vengono rimossi automaticamente.
Elaborazione settimanale¶
Diversi processi anagrafici eseguono periodicamente un'elaborazione completa (oltre a quella differenziale standard) per verificare l'allineamento tra i due sistemi. Questa elaborazione:
- Controlla tutti i record AREA della tipologia corrispondente
- Marca come cancellati quelli non piu' presenti nell'HOST
- Sana eventuali disallineamenti accumulati nel tempo
I processi con elaborazione settimanale sono: anagrafiche, contatti, articoli, prezzi, sconti, raccordi gruppi sconto, backorder e set tipico.
Pannello di controllo AreaGate¶
AreaGate e' un sistema analogo al DB di frontiera, dedicato al collegamento tra AREA e l'applicazione AreaGate (portali web, app mobile, sistemi di terze parti).
Il pannello di controllo si trova in Sistema > Archivi > Sincronizzazioni > Pannello di controllo AreaGate e funziona in modo simile a quello del DB di frontiera, con l'aggiunta della gestione per istanze: piu' istanze possono essere eseguite in parallelo, e ogni istanza raggruppa uno o piu' processi eseguiti in sequenza.
Differenze rispetto al DB di frontiera¶
| Caratteristica | DB di frontiera | AreaGate |
|---|---|---|
| Gestione istanze | No | Si -- piu' istanze in parallelo |
| Direzione processi | Configurabile per processo | Visibile per processo (Import, Export o entrambi) |
| Esportazione completa | Solo per singolo processo | Per processo o per intera istanza |
| Fasce di stand-by | No | Si -- configurabili per giorni e orari |
| Segnale keep-alive | No | Si -- aggiornamento periodico di attivita' |
| Esecuzione forzata istanza | No | Si -- con F5 (forza reload istanze) |
Configurazione AreaGate¶
I parametri risiedono nei gruppi abilita e areaapp della configurazione di sistema:
| Parametro | Descrizione |
|---|---|
| Attiva AreaApp | Pulsante di accensione del modulo AreaGate |
| Codice azienda | Codice azienda per la sincronizzazione |
| Stringa di connessione | Dati di accesso al database AreaGate |
| Aggiornamento online | Abilita/disabilita aggiornamento in tempo reale |
Tasti funzione (pannello AreaGate)¶
| Tasto | Funzione |
|---|---|
| F1 | Aggiorna i dati della griglia |
| F3 | Salva le modifiche alle impostazioni |
| F5 (su griglia processi) | Avvia immediatamente il processo selezionato |
| F5 (su griglia istanze) | Forza il reload delle istanze: spegne, rileva modifiche e riaccende |
| F6 (su griglia processi) | Accende o spegne tutti i processi |
| F6 (su griglia istanze) | Accende o spegne la singola istanza selezionata |
| F7 | Apre il log di elaborazione dell'ultima sessione per il processo selezionato |
Domande frequenti¶
Come si forza la riesportazione di un documento di magazzino? Modificare il documento nel gestionale: il flag di esportazione viene reimpostato automaticamente. In alternativa, utilizzare l'apposita funzione di gestione del flag di esportazione.
Un processo mostra errori: come si diagnostica il problema? Controllare la colonna Messaggio nel pannello di controllo per un'indicazione sintetica. Per il dettaglio completo, consultare il log di elaborazione (nel pannello AreaGate, premere F7 sul processo).
La sincronizzazione e' attiva ma i processi non partono: cosa verificare?
- Verificare che la casella Sincronizzazione attiva sia spuntata
- Verificare che il singolo processo sia impostato come Attivo
- Controllare che lo schedulatore esterno (PgAgent) sia in funzione
- Verificare la connessione al database di frontiera (i parametri di connessione nel gruppo dbfront)
Le fatture vanno in schedulazione automatica? No. Il processo FATTURECLI va eseguito manualmente, perche' l'esportazione di una fattura ne impedisce la modifica e la cancellazione. Usare Forzo esecuzione nel pannello di controllo solo quando le fatture sono pronte.
A cosa serve il campo "Limita righe"? Serve in fase di test per elaborare solo le prime N righe. Impostare un valore basso (ad esempio 10) permette di verificare il funzionamento della sincronizzazione senza elaborare l'intero volume di dati.
Vedi anche¶
- Pannello di controllo DB Frontiera -- configurazione e monitoraggio processi DB di frontiera
- Pannello di controllo AreaGate -- configurazione e monitoraggio processi AreaGate
- Configurazioni di sistema -- parametri di connessione (gruppi dbfront e areaapp)