SWN056 - Testata dossier¶
Nome programma SWN056 Linkage section UTILAGPRG - Linkage comune Id processo: 59 Nome processo: DOSSIER-TES Tabelle principali gestite
| AREA | AREAGATE | Direzione |
|---|---|---|
| CRMDOSSR | APCRMDOSSR | ------> <------ |
Versione tabella: 2 Logica generale Sincronizzazione della tabella "testata dossier CRM". Esportazione Esportazione di tutti i record effettivamente modificati (con dati variati). Importazione Le applicazioni WEB potranno inserire, modificare o cancellare logicamente nuovi record Attribuzione numerazione condivisa gestionale & Web La tabella APCRMDOSSR non prevede "id dispositivo e progressivo", perchè si presuppone che l'ambiente gestionale e web venga gestito in modo unitario. Di conseguenza questo programma fornisce anche una operazione specifica, necessaria al gestionale per capire se il numero di un nuovo dossier possa essere utilizzato (potrebbe venire "occupato" da una applicazione web nel frattempo). Questa operazione è descritta successivamente. 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: APCRMDOSSR Se fallita inviare una Segnalazione critica e chiudere. C - Importazione aggiornamenti Effettuare una query per estrarre tutti gli elementi aggiornati su APP: SELECT * FROM APCRMDOSSR WHERE a_dsa_azienda = azienda AND (a_dsa_agg_app = 'A') Gli elementi potranno essere: * Cancellati: se A-DSA-VAL = "C" * Inseriti o aggiornati: se A-DSA-VAL <> "C" C.1 - Importazione elemento nuovo o aggiornato Fare una ricerca su CRMDOSSR impostando:
| Dato | Contenuto |
|---|---|
| DSA-KEY-TDO | A-DSA-KEY-TDO |
| DSA-NUM | A-DSA-NUM |
Se l'elemento non esiste, inserirlo. Quindi proseguire con l'aggiornamento di CRMDOSSR.
| Dato | Contenuto |
|---|---|
| DSA-TDO | A-DSA-TDO |
| DSA-ID | A-DSA-ID |
| DSA-WKF-COD | A-DSA-WKF-COD |
| DSA-WKF-VER | A-DSA-WKF-VER |
| DSA-DES | A-DSA-DES |
| DSA-COD-OP | A-DSA-COD-OP |
| DSA-DATA-A | A-DSA-DATA-A |
| DSA-DATA-C | A-DSA-DATA-C |
| DSA-STATO | A-DSA-STATO |
| DSA-FL-CHIUSO-MANUALE | A-DSA-FL-CHIUSO-MANUALE |
| DSA-CAMP-DATA-INI | A-DSA-CAMP-DATA-INI |
| DSA-CAMP-DATA-FIN | A-DSA-CAMP-DATA-FIN |
| DSA-MP | A-DSA-MP |
| DSA-RS | A-DSA-RS |
| DSA-IMPORTO | A-DSA-IMPORTO |
| DSA-PRV-ANN | A-DSA-PRV-ANN |
| DSA-PRV-NUM | A-DSA-PRV-NUM |
Inserimento/variazione di CRMDOSNT:
| Dato | Contenuto |
|---|---|
| DNT-CHIA1 | DSA-CHIA1 |
| DNT-NOTE | A-DSA-NOTE |
| DNT-NOTE-LEN | La lunghezza effettiva di A-DSA-NOTE |
C.2 - Importazione elemento cancellato Fare una ricerca su CRMDOSSR 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 "APCRMDOSSR"; se il record non esiste, crearlo impostando
| Dato | Contenuto |
|---|---|
| A_SYN_AZIENDA | Codice azienda |
| A_SYN_TABELLA | "APCRMDOSSR" |
| A_SYN_DA_GES_DATA | 0 |
| A_SYN_DA_GES_ORA | 0 |
| A_SYN_DA_ID_SINCRO | 1 |
| A_SYN_VERSIONE | 2 |
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) Se la versione della tabella è < 2, azzerare data/ora esportazione, in modo da ripetere l'esportazione per tutti i dossier (se vengono trovate differenze) B.2 - Ricerca record da esportare B.2.1 Ricerca record da esportare
| Tipo di elaborazione | Condizione | Cosa fare |
|---|---|---|
| Singolo record | AGPRG-KEY <> " " (conterrà DSA-CHIA1) |
Si legge direttamente il record da aggiornare su CRMDOSSR 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 CRMDOSSR, e si considerano solo i record dove DSA-DA-DATA+DSA-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 |
| Occupazione numerazione | (conterrà DSA-CHIA1) |
Eseguire la procedura B.4 e 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 APCRMDOSSR
| Dato | Contenuto |
|---|---|
| A-DSA-AZIENDA | Codice azienda |
| A-DSA-KEY-TDO | DSA-KEY-TDO |
| A-DSA-NUM | DSA-NUM |
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 CRMDOSSR/CRMDOSNT NB: se a questo punto A-DSA-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. Leggere il record collegato su CRMDOSNT
| Dato | Contenuto | Confronto? |
|---|---|---|
| A-DSA-AZIENDA | Codice azienda | |
| A-DSA-KEY-TDO | DSA-KEY-TDO | |
| A-DSA-NUM | DSA-NUM | |
| A-DSA-TDO | DSA-TDO | Si |
| A-DSA-ID | DSA-ID | Si |
| A-DSA-WKF-COD | DSA-WKF-COD | Si |
| A-DSA-WKF-VER | DSA-WKF-VER | Si |
| A-DSA-DES | DSA-DES (*) | Si |
| A-DSA-COD-OP | DSA-COD-OP | Si |
| A-DSA-DATA-A | DSA-DATA-A | Si |
| A-DSA-DATA-C | DSA-DATA-C | Si |
| A-DSA-STATO | DSA-STATO (#) | Si |
| A-DSA-FL-CHIUSO-MANUALE | DSA-FL-CHIUSO-MANUALE | Si |
| A-DSA-CAMP-DATA-INI | DSA-CAMP-DATA-INI | Si |
| A-DSA-CAMP-DATA-FIN | DSA-CAMP-DATA-FIN | Si |
| A-DSA-MP | DSA-MP | Si |
| A-DSA-RS | DSA-RS | Si |
| A-DSA-IMPORTO | DSA-IMPORTO | Si |
| A-DSA-PRV-ANN | DSA-PRV-ANN | Si |
| A-DSA-PRV-NUM | DSA-PRV-NUM | Si |
| A-DSA-NOTE | DSN-NOTE (1:DNT-NOTE-LEN) | Si |
| A-DSA-VAL | " " | Si |
| A-DSA-ID-SINCRO | Prossimo id sincro | |
| A-DSA-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.2.3 Modifica stato dossier Se durante l'aggiornamento risulta essere stato modificato lo stato dossier, si dovrà creare un record su ARPNOTIFICHE:
| Dato | Contenuto |
|---|---|
| ANTP-AZI | Azienda attiva |
| ANTP-CLASSE | "DO" |
| ANTP-ID-OGGETTO | DSA-CHIA1 |
| ANTP-TIP | 1 |
| ANTP-ESITO | 0 |
B.3 Verifica record cancellati Procedura specifica per l'operazione "PULIZIA" Sulla tabella di origine CRMDOSSR non esiste il flag di cancellazione logica. Quindi si opererà come segue: 1. Scorrere tutti i record di APCRMDOSSR per l'azienda 2. Ricerca, per ciascuno, del corrispondente record su CRMDOSSR A questo punto la situazione potrebbe essere la seguente:
| CRMDOSSR trovato? | A-DSA-VAL | Cosa fare |
|---|---|---|
| Si | "C" | Aggiornare APCRMDOSSR impostando |
| Si | " " | Nessuna operazione |
| No | "C" | Nessuna operazione |
| No | " " | Aggiornare APCRMDOSSR impostando |
B.4 Occupazione numerazione condivisa Procedura specifica per l'operazione "OCCUPA-KEY" In questa operazione si riceve una chiave di testata dossier (DSA-CHIA1), e il programma deve controllare che questo numero sia libero. In tal caso occuparlo inserendo il record. In dettaglio: Ricerca di un record su APCRMDOSSR con la chiave:
| Dato | Contenuto |
|---|---|
| A-DSA-AZIENDA | Codice azienda |
| A-DSA-KEY-TDO | DSA-KEY-TDO |
| A-DSA-NUM | DSA-NUM |
Se il record viene trovato -> uscire restituendo AGPRG-ESITO = "N" Altrimenti inserire il record vuoto, esattamente cosi' com'è. Se a questo punto l'operazione ha esito: * Positivo: uscire restituendo AGPRG-ESITO = "S" * Negativo: uscire restituendo AGPRG-ESITO = "N" (in questo caso nel lasso di tempo tra la lettura e la scrittura del record un processo web ha effettuato la stessa operazione ed è arrivata prima). B.9 - Aggiornamento id syncro Al termine dell'elaborazione, aggiornare il record APSTATOSYN:
| Dato | Contenuto |
|---|---|
| A_SYN_AZIENDA | Codice azienda |
| A_SYN_TABELLA | "APCRMDOSSR" |
| 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