SWN057 - Collegamento dossier-attività¶
Nome programma SWN057 Linkage section UTILAGPRG - Linkage comune Id processo: 60 Nome processo: DOSSIER-ATT Tabelle principali gestite
| AREA | AREAGATE | Direzione |
|---|---|---|
| CRMDOSAT | APCRMDOSAT | ------> <------ |
Logica generale Sincronizzazione della tabella "Raccordo dossier/attività". Esportazione Esportazione di tutti i record effettivamente modificati (con dati variati). Importazione Le applicazioni WEB potranno inserire, modificare o cancellare logicamente nuovi record 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: APCRMDOSAT Se fallita inviare una Segnalazione critica e chiudere. C - Importazione aggiornamenti Effettuare una query per estrarre tutti gli elementi aggiornati su APP: SELECT * FROM APCRMDOSAT WHERE a_dsv_azienda = azienda AND (a_dsa_agg_app = 'A') Gli elementi potranno essere: * Cancellati: se A-DSV-FL-CANC = "C" * Inseriti o aggiornati: se A-DSV-FL-CANC <> "C" * Inserimento di elemento con attività temporanea: A-DSV-ID-DISPOSITIVO > 0 C.1 - Importazione elemento nuovo o aggiornato Ora distinguamo i due casi principali: * Acquisizione di collegamento a dossier di attività temporanea (nuova) -> C.1.1 * Acquisizione di collegamento a dossier di attività definitiva (nuovo collegamento o collegamento esistente) -> C.1.2 C.1.1 - Importazione elemento nuovo con attività temporanea C.1.1.1 - Controllo se l'attività è definitiva In questo caso dobbiamo verificare se l'attività nel frattempo è stata acquisita ed è diventata definitiva. Quindi, fare una query: SELECT * FROM apcrmattiv WHERE a_crt_azienda = azienda AND a_crt_id_disp_orig = a_dsv_id_dispositivo AND a_crt_idd_prog_orig = a_dsv_idd_prog Se questa query restituisce un record, A-CRT-NUM conterrà il numero attività definitivo: quindi possiamo proseguire; altrimenti skippare segnalando sul log. C.1.1.2 - Importazione Fare una ricerca su CRMDOSAT impostando:
| Dato | Contenuto |
|---|---|
| DSV-KEY-TDO | A-DSV-KEY-TDO |
| DSV-NUM | A-DSV-NUM |
| DSV-ATT | A-CRT-NUM |
Se l'elemento non esiste, inserirlo. Quindi proseguire con l'aggiornamento di CRMDOSAT.
| Dato | Contenuto |
|---|---|
| DSV-DATA-ESE | A-DSV-DATA-ESE |
| DSV-ATT-TIP | A-DSV-ATT-TIP |
| DSV-NOM | A-DSV-NOM |
Dopodichè cancellare il collegamento temporaneo su APCRMDOSAT (verrà riesportato nella fase successiva di esportazione) C.1.2 - Importazione elemento nuovo o aggiornato con attività definitiva Fare una ricerca su CRMDOSAT impostando:
| Dato | Contenuto |
|---|---|
| DSV-KEY-TDO | A-DSV-KEY-TDO |
| DSV-NUM | A-DSV-NUM |
| DSV-ATT | A-DSV-ATT |
Se l'elemento non esiste, inserirlo. Quindi proseguire con l'aggiornamento di CRMDOSAT.
| Dato | Contenuto |
|---|---|
| DSV-DATA-ESE | A-DSV-DATA-ESE |
| DSV-ATT-TIP | A-DSV-ATT-TIP |
| DSV-NOM | A-DSV-NOM |
C.2 - Importazione elemento cancellato Fare una ricerca su CRMDOSAT come al punto C.1: Se il record esiste, effettuare la cancellazione fisica del record. B - Esportazione elementi aggiornati * ID SINCRO: gestito * Esportazione differenziale: gestita ma non ottimizzata: non esiste una chiave diretta per ottenere solo i record aggiornati * Cancellazione logica: non 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 "APCRMDOSAT"; se il record non esiste, crearlo impostando
| Dato | Contenuto |
|---|---|
| A_SYN_AZIENDA | Codice azienda |
| A_SYN_TABELLA | "APCRMDOSAT" |
| 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à DSV-CHIA1) |
Si legge direttamente il record da aggiornare su CRMDOSAT Verrà eseguita se agg-postgres-online è attiva Se viene sincronizzato un record cancellato, verrà effettuata la cancellazione logica |
| Esportazione dossier | ESP-DOSSIER conterrà DSV-CHIA1 |
Simile all'esportazione standard, ma in questo caso verranno esportati tutti i record collegati al dossier passato Verrà eseguita se agg-postgres-online è attiva |
| Esportazione totale | AGPRG-ESPORTA-TUTTO = "S" | Si scorrono tutti i record di CRMDOSAT, e si considerano solo i record dove DSV-DA-DATA+DSV-DA-TIME super la data/ora ultimo aggiornamento |
| Esportazione standard | ||
| 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: Nessuno B.2.2 Verifica ed esportazione record Dopodichè si effettua la ricerca dell'informazione su APCRMDOSAT
| Dato | Contenuto |
|---|---|
| A-DSV-AZIENDA | Codice azienda |
| A-DSV-KEY-TDO | DSV-KEY-TDO |
| A-DSV-NUM | DSV-NUM |
| A-DSV-ATT | DSV-ATT |
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 CRMDOSAT NB: se a questo punto A-DSV-AGG-APP 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-DSV-AZIENDA | Codice azienda | |
| A-DSV-KEY-TDO | DSV-KEY-TDO | |
| A-DSV-NUM | DSV-NUM | |
| A-DSV-ATT | DSV-ATT | |
| A-DSV-DATA-ESE | DSV-DATA-ESE | Si |
| A-DSV-ATT-TIP | DSV-ATT-TIP | Si |
| A-DSV-NOM | DSV-NOM | Si |
| A-DSV-FL-CANC | " " | Si |
| A-DSV-ID-SINCRO | Prossimo id sincro | |
| A-DSV-AGG-APP | " " |
In questa fase tenere memoria di data+ora dell'ultimo record di input considerato. Per i campi contrassegnati con (*) effettuare il parsing tramite GESSTR, come già fatto negli altri programmi di sincronizzazione B.3 Verifica record cancellati Procedura specifica per l'operazione "PULIZIA" Sulla tabella di origine CRMDOSAT non esiste il flag di cancellazione logica. Quindi si opererà come segue: 1. Scorrere tutti i record di APCRMDOSAT per l'azienda 2. Ricerca, per ciascuno, del corrispondente record su CRMDOSAT A questo punto la situazione potrebbe essere la seguente:
| CRMDOSAT trovato? | A-DSV-FL-CANC | Cosa fare |
|---|---|---|
| Si | "C" | Aggiornare APCRMDOSAT impostando |
| Si | " " | Nessuna operazione |
| No | "C" | Nessuna operazione |
| No | " " | Aggiornare APCRMDOSAT impostando |
B.9 - Aggiornamento id syncro Al termine dell'elaborazione, aggiornare il record APSTATOSYN:
| Dato | Contenuto |
|---|---|
| A_SYN_AZIENDA | Codice azienda |
| A_SYN_TABELLA | "APCRMDOSAT" |
| 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