SWN019 - Agenti¶
Nome programma SWN019 Linkage section UTILAGPRG - Linkage comune Id processo: 22 Nome processo: AGENTI Tabelle principali gestite
| AREA | AREAGATE | Direzione |
|---|---|---|
| COGTABEL (tabella 21) | ARPAGENT Versione attuale: 2 |
------> <------ |
Logica generale Sincronizzazione dei produttori matricola. Esportazione Esportazione di tutti i produttori effettivamente modificati (con dati variati). Importazione Le applicazioni WEB potranno inserire, modificare o cancellare nuovi agenti Configurazioni possibili
| Gruppo | Parametro | Note |
|---|---|---|
| abilita | attiva-areaapp | |
| areaapp | cod-azienda | |
| areaapp | db-conn-string | |
| areaapp | agg-postgres-online |
Elaborazione Tipi di segnalazione: Vedi Tipi di segnalazione A - Controllo di esecuzione Vedi Controllo di esecuzione A.1 - Aggiornamento KEEP-ALIVE Per il momento non lo eseguiamo: il keep-alive viene tenuto aggiornato dal thread autonomo di aglancio; se il programma venisse chiamato in "tempo reale" dal programma di gestione, non necessita comunque del keep-alive. A.2 - Apertura A.2.1 Apertura tabelle Tentare l'apertura della tabella da sincronizzare: ARPAGENT Se fallita inviare una Segnalazione critica e chiudere. C - Importazione aggiornamenti Effettuare una query per estrarre tutti gli elementi aggiornati su APP: SELECT * FROM ARPAGENT WHERE rage_azi = azienda AND (rage_fl_agg = 'A') Gli elementi potranno essere: * Cancellati: se RAGE_FL_CANC = "C" * Inseriti o aggiornati: se RAGE_FL_CANC <> "C" C.1 - Importazione elemento nuovo o aggiornato Fare una ricerca su COGTABEL impostando:
| Dato | Contenuto |
|---|---|
| EUTA-TIPO | K-EUTA-TIPO-AGENTE |
| EUTA-CODR | RAGE-COD |
Se l'elemento non esiste, inserirlo. Poi cercare l'anagrafica del fornitore collegato:
| Dato | Contenuto |
|---|---|
| ANA-TIPO | "F" |
| ANA-COD | RAGE-COD |
Se ANA-PADRE è diverso da RAGE-PADRE-ATTUALE, allora variare il codice padre su COGGEANA
| Dato | Contenuto |
|---|---|
| ANA-PADRE | RAGE-PADRE-ATTUALE |
C.2 - Importazione elemento cancellato Fare una ricerca su COGTABEL come al punto C.1: Se il record esiste, effettuare la cancellazione fisica del record. B - Esportazione informazioni aggiornate * ID SINCRO: gestito * Esportazione differenziale: gestita ma non ottimizzata: non esiste una chiave diretta per ottenere solo i record aggiornati * Cancellazione logica: gestita In questa fase si dovrà tenere conto di * Limite record * Limite errori * "Esporta tutto" B.1 - Stato sincronizzazione Sulla tabella APSTATOSYN, leggere il record relativo alla tabella/oggetto da sincronizzare "ARPAGENT"; se il record non esiste, crearlo impostando
| Dato | Contenuto |
|---|---|
| A_SYN_AZIENDA | Codice azienda |
| A_SYN_TABELLA | "ARPAGENT" |
| A_SYN_DA_GES_DATA | 0 |
| A_SYN_DA_GES_ORA | 0 |
| A_SYN_DA_ID_SINCRO | 1 |
| A_SYN_VERSIONE | 1 |
Qui otterremo due informazioni importanti: * Data/ora ultima esportazione da gestionale a postgres (A_SYN_DA_GES_DATA e A_SY_DA_GES_ORA) * Prossimo ID sincronizzazione da memorizzare sulla tabella (A_SYN_ID_SINCRO) B.1.1 Cambio versione Se la versione attuale è inferiore a 2, si dovrà riesportare tutta la tabella completa, quindi azzerare A_SYN_DA_GES_DATA e A_SYN_DA_GES_ORA) prima di proseguire in modo regolare B.2 - Ricerca record da esportare B.2.1 Ricerca record da esportare
| Tipo di elaborazione | Condizione | Cosa fare |
|---|---|---|
| Singolo record | AGPRG-KEY <> " " (conterrà EUTA-KEY) |
Si legge direttamente il record da aggiornare su COGTABEL Verrà eseguita se agg-postgres-online è attiva Se viene sincronizzato un record cancellato, verrà effettuata la cancellazione logica |
| Esportazione totale | AGPRG-ESPORTA-TUTTO = "S" | Si scorrono tutti i record di COGTABEL che hanno: ogni record va considerato, ignorando il controllo sulla variazione dei record |
| Esportazione standard | Si scorrono tutti i record di COGTABEL che hanno: Qui la tabella di origine non ha data/ora aggiornamento, quindi si valuterà se aggiornare solo in base al contenuto |
|
| Pulizia | AGPRG-OPE = "PULIZIA" | Eseguire solo il giro di cancellazione logica B.3 quindi uscire |
Per ciascun record valido si cercano tutti i record collegati: Ricerca su COGGEANA
| Dato | Contenuto |
|---|---|
| ANA-TIPO | "F" |
| ANA-COD | EUTA-CODR |
Se il record non esiste, significa che l'agente è un record sporco: ignorare l'esportazione B.2.2 Verifica ed esportazione record Dopodichè si effettua la ricerca dell'informazione su ARPAGENT
| Dato | Contenuto |
|---|---|
| RAGE-AZI | Codice azienda |
| RAGE-COD | APRD-COD |
Se non esiste, inserirlo. Se esiste, aggiornarlo; l'aggiornamento del record deve avvenire solo se almeno un dato tra quelli da modificare è diverso. NB: se è stata richiesta l'esportazione completa (AGPRG-ESPORTA-TUTTO = "S") allora il record dovrà essere esportato a prescindere dal confronto Suggerimento Invece di popolare direttamente i dati del record di destinazione, portarli su delle copie in w/s. Al termine confrontare i dati sulla destinazione con la copia in w/s. Aggiornamento da COGTABEL+COGGEANA
| Dato | Contenuto | Confronto? |
|---|---|---|
| RAGE-AZI | Codice azienda | |
| RAGE-COD | APRD-COD | |
| RAGE-NOME | ANA-NOME | Si |
| RAGE-EMAIL | ANA-EMAIL | Si |
| RAGE-PADRE-ATTUALE | ANA-PADRE | Si |
| RAGE-PADRE-PREC | RAGE-PADRE-ATTUALE presente sul record prima della modifica | Si |
| RAGE-FL-CANC | " " | Si |
| RAGE-ID-SINCRO | Prossimo id sincro | |
| RAGE-FL-AGG | " " |
In questa fase tenere memoria di data+ora dell'ultimo record di input considerato. Per tutti i campi alfanumerici significativi (non flag, non valori fissi) effettuare il parsing tramite GESSTR, come già fatto negli altri programmi di sincronizzazione B.3 Verifica record cancellati Sulla tabella di origine COGTABEL, tabella agenti, non esiste il flag di cancellazione logica. Quindi si opererà come segue: 1. Scorrere tutti i record di ARPAGENT per l'azienda 2. Ricerca, per ciascuno, del corrispondente record su COGTABEL A questo punto la situazione potrebbe essere la seguente:
| COGTABEL trovato? | RAGE-FL-CANC | Cosa fare |
|---|---|---|
| Si | "C" | Aggiornare ARPAGENT impostando |
| Si | " " | Nessuna operazione |
| No | "C" | Nessuna operazione |
| No | " " | Aggiornare ARPAGENT impostando |
B.9 - Aggiornamento id syncro Al termine dell'elaborazione, aggiornare il record APSTATOSYN:
| Dato | Contenuto |
|---|---|
| A_SYN_AZIENDA | Codice azienda |
| A_SYN_TABELLA | "ARPAGENT" |
| A_SYN_DA_GES_DATA | Data/ora dell'ultimo record aggiornato |
| A_SYN_DA_GES_ORA | |
| A_SYN_DA_ID_SINCRO | Ultimo id sincro + 1 |
| A_SYN_VERSIONE | 2 |
Estratto da documentazione interna ClickUp