SWN005 - Tabelle generiche¶
Nome programma SWN005 Linkage section UTILAGPRG - Linkage comune Id processo: 8 Nome processo: TABELLE Tabelle principali gestite
| AREA | AREAGATE | Direzione |
|---|---|---|
| COGTABEL | ARPTABELLE | ------> <------ |
Logica generale Sincronizzazione delle tabelle generiche. Esportazione Esportazione di tutti i record tabella effettivamente modificati (con dati variati). Importazione Le applicazioni WEB potranno inserire, modificare o cancellare logicamente nuovi elementi sulla tabella 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 Tipi tabella coinvolti: Le tabelle da elaborare sono nel topic Definizione tipi tabella 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: ARPTABELLE Se fallita inviare una Segnalazione critica e chiudere. C - Importazione aggiornamenti Per ciascun tipo tabella previsto (vedi sopra), effettuare una query per estrarre tutti gli elementi aggiornati su APP: SELECT * FROM arptabelle WHERE a_tab_azienda = azienda AND a_tab_provenienza = "provenienza" AND a_tab_tipo = 'tipo-tabella' AND a_tab_fl_agg = 'A' Gli elementi tabella potranno essere: * Cancellati: se A-TAB-FL-CANC = "C" * Inseriti o aggiornati: se A-TAB-FL-CANC <> "C" C.1 - Importazione elemento nuovo o aggiornato (Provenienza=COGTABEL) Fare una ricerca su COGTABEL impostando:
| Dato | Contenuto |
|---|---|
| EUTA-TIPO | A-TAB-TIPO |
| EUTA-COD | A-TAB-COD |
Se il record non esiste, inserirlo. Quindi proseguire con l'aggiornamento di COGTABEL.
| Dato | Contenuto |
|---|---|
| EUTA-descrizione | A-TAB-DES |
| EUTA-xxx | A-TAB-ATTRIBUTO-1 (se previsto dal tipo tabella) |
C.2 - Importazione elemento cancellato Fare una ricerca su COGTABEL impostando:
| Dato | Contenuto |
|---|---|
| EUTA-TIPO | A-TAB-TIPO |
| EUTA-COD | A-TAB-COD |
Se l'elemento tabella 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 "ARPTABELLE"; se il record non esiste, crearlo impostando
| Dato | Contenuto |
|---|---|
| A_SYN_AZIENDA | Codice azienda |
| A_SYN_TABELLA | "ARPTABELLE" |
| A_SYN_DA_GES_DATA | 0 |
| A_SYN_DA_GES_ORA | 0 |
| A_SYN_DA_ID_SINCRO | 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.2 - Ricerca record da esportare Per ciascuna tabella da esportare (Definizione tipi tabella), eseguire il punto B.2.1 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" | Per ciascun tipo: Si scorrono tutti i record di COGTABEL; ogni record va considerato, ignorando il controllo sulla variazione dei record |
| Esportazione standard | Per ciascun tipo: si scorrono tutti i record di COGTABEL: si considerano tutti i record perchè non c'è nessun log di aggiornamento | |
| 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: * nessun record B.2.2 Verifica ed esportazione record Dopodichè si effettua la ricerca dell'informazione su ARPTABELLE
| Dato | Contenuto |
|---|---|
| A-TAB-AZIENDA | Codice azienda |
| A-TAB-PROVENIENZA | Provenienza |
| A-TAB-TIPO | Tipo tabella |
| A-TAB-COD | EUTA-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
| Dato | Contenuto | Confronto? |
|---|---|---|
| A-TAB-AZIENDA | Codice azienda | |
| A-TAB-PROVENIENZA | "T" | |
| A-TAB-TIPO | Tipo tabella | |
| A-TAB-COD | EUTA-COD | |
| A-TAB-DES | Campo descrittivo specifico per la tabella | Si |
| A-TAB-ATTRIBUTO-1 | Il contenuto dipende dalle singole tabelle | Si |
| A-TAB-FL-CANC | " " | |
| A-TAB--ID-SINCRO | Prossimo id sincro | |
| A-TAB--FL-AGG | " " (non più usato) |
Aggiornamento da COGGENER
| Dato | Contenuto | Confronto? |
|---|---|---|
| A-TAB-AZIENDA | Codice azienda | |
| A-TAB-PROVENIENZA | "G" | |
| A-TAB-TIPO | Tipo tabella | |
| A-TAB-COD | Vedi Definizione tipi tabella | |
| A-TAB-DES | Si | |
| A-TAB-ATTRIBUTO-1 | Si | |
| A-TAB-FL-CANC | " " | |
| A-TAB--ID-SINCRO | Prossimo id sincro | |
| A-TAB--FL-AGG | " " (non più usato) |
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 Per ciascuna tabella da esportare (Vedi il punto B.2) effettuare questa elaborazione B.3.1 Verifica record cancellati per una singola tabella Sulla tabella di origine non esiste il flag di cancellazione logica. Quindi si opererà come segue: 1. Scorrere tutti i record di ARPTABELLE per la tabella in elaborazione 2. Ricerca, per ciascuno, del corrispondente record sulla tabella di origine A questo punto la situazione potrebbe essere la seguente:
| COGTABEL trovato? | A-TAB-FL-CANC | Cosa fare |
|---|---|---|
| Si | "C" | Aggiornare ARPTABELLE impostando |
| Si | " " | Nessuna operazione |
| No | "C" | Nessuna operazione |
| No | " " | Aggiornare ARPTABELLE impostando |
B.9 - Aggiornamento id syncro Al termine dell'elaborazione, aggiornare il record APSTATOSYN:
| Dato | Contenuto |
|---|---|
| A_SYN_AZIENDA | Codice azienda |
| A_SYN_TABELLA | "ARPTABELLE" |
| 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 |
Estratto da documentazione interna ClickUp