SWN030 - Movimenti controlli su matricola¶
Nome programma SWN030 Linkage section UTILAGPRG - Linkage comune Id processo: 33 Nome processo: CTR-MATRICOLA-MV Tabelle principali gestite
| AREA | AREAGATE | Direzione |
|---|---|---|
| ASNCTRMV | MVCONTROLLIMAT | ------> <------ |
Logica generale Sincronizzazione della tabella Movimenti controllo su matricola" Esportazione Esportazione di tutti gli elementi effettivamente modificati (con dati variati). Importazione Le applicazioni WEB potranno inserire, modificare o cancellare logicamente nuovi elementi NB: i controlli potranno essere creati su matricole provvisorie create nell'ambito WEB: in questo caso non hanno id matricola significativo; questi saranno ignorati finchè la corrispondente matricola non è stata acquisita e convertita in matricola "ufficiale" dall'apposito processo. 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: MVCONTROLLIMAT Se fallita inviare una Segnalazione critica e chiudere. C - Importazione aggiornamenti Effettuare una query per estrarre tutti gli elementi aggiornati su APP: SELECT * FROM MVCONTROLLIMAT WHERE a_mctm_azi = azienda AND a_mctm_fl_agg = 'A' Gli elementi potranno essere: * Cancellati: se A-MTCM-FL-CANC = "C" * Inseriti o aggiornati: se A-MTCM-FL-CANC <> "C" C.1 - Importazione elemento nuovo o aggiornato C.1.1 Verifica controllo su matricola temporanea Se il controllo ha: * A-MTCM-ID-DISPOSITIVO > 0 * A-MTCM-MTR-ID = 0 Significa che è stato creato su una matricola temporanea. Quindi, verificare se la matricola è ancora temporanea, tramite una ricerca diretta su APASNMATRI:
| Dato | Contenuto |
|---|---|
| A-AMTR-AZIENDA | Azienda in elaborazione |
| A-AMTR-ID-DISPOSITIVO | A-MTCM-ID-DISPOSITIVO |
| A-AMTR-IDD-PROG | A-MTCM-IDD-PROG |
| A-AMTR-ID | A-MTCM-ID-MTR |
Se trovato, la matricola è ancora temporanea: quindi ignorare l'elaborazione di questo record (potrà essere valutato al giro successivo) C.1.1.1 Ricerca matricola definitiva Se invece la matricola temporanea non è stata trovata, possiamo ipotizzare che sia già stata acquisita e trasformata in definitiva. In questo caso, la troveremo con la seguente query: SELECT * FROM APASNMATRI WHERE a_amtr_azi = azienda AND a_amtr_idd_orig = a_mtcm_id_dispositivo AND a_amtr_idd_prog_orig = a_mtcm_idd_prog Questa query dovrebbe restituire un solo record, dove A-AMTR-ID corrisponde alla matricola definitiva cercata. C.1.2 Importazione elemento Fare una ricerca su ASNCTRMV impostando:
| Dato | Contenuto |
|---|---|
| AMTCM-MTR-ID | |
| AMTCM-PROG | A-MTCM-PROG |
Se l'elemento non esiste, inserirlo. Quindi proseguire con l'aggiornamento di ASNCTRMV.
| Dato | Contenuto |
|---|---|
| AMTCM-COD-CONTOLLO | A-MTCM-COD-CONTROLLO |
| AMTCM-STATO | A-MTCM-STATO |
| AMTCM-DATA-ESECUZIONE | A-MTCM-DATA-ESECUZIONE |
| AMTCM-DATA-PREVISTA | A-MTCM-DATA-PREVISTA |
| AMTCM-OPE-ESECUZIONE | A-MTCM-OPE-ESECUZIONE |
| AMTCM-INTERVENTO | A-MTCM-INTERVENTO |
| AMTCM-NOTE | A-MTCM-NOTE |
C.2 - Importazione elemento cancellato Fare una ricerca su ASNCTRMV impostando:
| Dato | Contenuto |
|---|---|
| AMTCM-MTR-ID | |
| AMTCM-PROG | A-MTCM-PROG |
Se l'elemento esiste, effettuare la cancellazione logica del record. C.3 - Aggiornamento record da importare C.3.1 Aggiornamento elemento "definitivo" Se il controllo era definitivo: modifica del record
| Dato | Contenuto |
|---|---|
| AMTCM-FL-AGG | " " |
C.3.1 Aggiornamento elemento "provvisorio" Se il controllo era provvisorio: cancellazione logica del record: verrà successivamente riesportato come definitivo nella seconda fase dell'elaborazione NB: Abbiamo deciso che su APP quando viene creata una matricola provvisoria non saranno visibili i controlli finchè la matricola non diventa definitiva; in ogni caso gestendo la cancellazione logica sarebbe possibile acquisire le variazioni effettuate su APP. B - Esportazione elementi aggiornati * ID SINCRO: gestito * Esportazione differenziale: gestita e ottimizzata: 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 "MVCONTROLLIMAT"; se il record non esiste, crearlo impostando
| Dato | Contenuto |
|---|---|
| A_SYN_AZIENDA | Codice azienda |
| A_SYN_TABELLA | "MVCONTROLLIMAT" |
| 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 B.2.1 Ricerca record da esportare
| Tipo di elaborazione | Condizione | Cosa fare |
|---|---|---|
| Singolo record | AGPRG-KEY <> " " (conterrà AMTCM-CHIA1) |
Si legge direttamente il record da aggiornare su ASNCTRMV 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 ASNCTRMV; ogni record va considerato, ignorando il controllo sulla variazione dei record |
| Esportazione standard | Si scorrono tutti i record di ASNCTRMV: si considerano solo i record dove: (AMTCM-DA-DATA+AMTCM-DA-TIME) >= (A-SYN-DA-GES-DATA+A-SYN-DA-GES-ORA) |
Per ciascun record valido si cercano tutti i record collegati: Nessuno B.2.2 Verifica ed esportazione record Dopodichè si effettua la ricerca dell'elemento su MVCONTROLLIMAT
| Dato | Contenuto |
|---|---|
| A-MTCM-AZI | Codice azienda |
| A-MTCM-ID-DISPOSITIVO | 0 |
| A-MTCM-IDD-PROG | 0 |
| A-MTCM-MTR-ID | AMTCM-MTR-ID |
| A-MTCM-PROG | AMTCM-PROG |
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 ASNCTRMV NB: se a questo punto A-MTCM-FL-AGG vale "A", significa che nel lasso di tempo tra la fase di importazione e questa, qualcuno ha aggiornato il record su APP: quindi segnalare sul log e ignorare l'esportazione.
| Dato | Contenuto | Confronto? |
|---|---|---|
| A-MTCM-AZI | Codice azienda | |
| A-MTCM-ID-DISPOSITIVO | 0 | |
| A-MTCM-IDD-PROG | 0 | |
| A-MTCM-MTR-ID | AMTCM-MTR-ID | |
| A-MTCM-PROG | AMTCM-PROG | |
| A-MTCM-COD-CONTOLLO | AMTCM-COD-CONTOLLO | Si |
| A-MTCM-STATO | AMTCM-STATO | Si |
| A-MTCM-DATA-ESECUZIONE | AMTCM-DATA-ESECUZIONE | Si |
| A-MTCM-DATA-PREVISTA | AMTCM-DATA-PREVISTA | Si |
| A-MTCM-OPE-ESECUZIONE | AMTCM-OPE-ESECUZIONE | Si |
| A-MTCM-INTERVENTO | AMTCM-INTERVENTO | Si |
| A-MTCM-NOTE | AMTCM-NOTE | Si |
| A-MTCM-FL-CANC | AMTCM-FL-CANC | Si |
| A-MTCM-ID-SINCRO | Prossimo id sincro | |
| A-MTCM-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.9 - Aggiornamento id syncro Al termine dell'elaborazione, aggiornare il record APSTATOSYN:
| Dato | Contenuto |
|---|---|
| A_SYN_AZIENDA | Codice azienda |
| A_SYN_TABELLA | "MVCONTROLLIMAT" |
| 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