SWN072 - Abilitazione utenti a tipo attività¶
Nome programma SWN072 Linkage section UTILAGPRG - Linkage comune Id processo: 72 Nome processo: CRMUSRTA Tabelle principali gestite
| AREA | AREAGATE | Direzione |
|---|---|---|
| CRMUSRTA | APCRMUSRTA | ------> <------ |
Versione tabella: 2 Logica generale Sincronizzazione dei raccordi tipi attività CRM - utenti 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: APCRMUSRTA Se fallita inviare una Segnalazione critica e chiudere.
C - Importazione aggiornamenti¶
Attenzione: in questa tabella l'assenza del record significa "Non abilitato", quindi è necessario agire di conseguenza Effettuare una query per estrarre tutti gli elementi aggiornati su APP: SELECT * FROM APCRMUSRTA WHERE a_ctu_azi = azienda AND (a_ctu_agg_app = 'A') Si dovrà inserire/aggiornare il record a seconda della seguente combinazione:
| A-CTU-FL-CANC | A-CTU-ABILITATO | Operazione su CRMUSRTA |
|---|---|---|
| "C" | qualunque | Cancellazione se esiste |
| <> "C" | "S" | Cancellazione se esiste |
| <> "C" | <> "N" | Inserimento se manca |
C.1 - Inserimento elemento mancante Fare una ricerca su CRMUSRTA impostando:
| Dato | Contenuto |
|---|---|
| CTU-OPE | A-CTU-OPE |
| CTU-TAT | A-CTU-TAT |
Se l'elemento non esiste, inserirlo. C.2 - Cancellazione elemento esistente Fare una ricerca su CRMUSRTA impostando:
| Dato | Contenuto |
|---|---|
| CTU-OPE | A-CTU-OPE |
| CTU-TAT | A-CTU-TAT |
Se il record esiste, effettuare la cancellazione fisica del record.
B - Esportazione elementi aggiornati (in questa tabella indica "Non abilitazione") * 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 "APCRMUSRTA"; se il record non esiste, crearlo impostando
| Dato | Contenuto |
|---|---|
| A_SYN_AZIENDA | Codice azienda |
| A_SYN_TABELLA | "APCRMUSRTA" |
| 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.1.1 - Attività una tantum Se in questa fase A-SYN-VERSIONE è <= 2: * Effettuare una query di cancellazione di tutti i record della tabella APCRMUSRTA per l'azienda B.2 - Ricerca record da esportare B.2.1 Ricerca record da esportare
| Tipo di elaborazione | Condizione | Cosa fare |
|---|---|---|
| Singolo record | AGPRG-KEY <> " " (conterrà CTU-CHIA1) |
Si legge direttamente il record da aggiornare su CRMUSRTA 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 CRMUSRTA; ogni record va considerato, ignorando il controllo sulla variazione dei record |
| Esportazione standard | Si scorrono tutti i record di CRMUSRTA, si considerano solo quelli con data/ora aggiornamento superiore all'ultima effettuata | |
| Pulizia | AGPRG-OPE = "PULIZIA" | ~~Eseguire solo il giro di cancellazione logica B.3 quindi uscire~~ DISABILITATA (TASK-2974, 01/04/2026): la funzione di pulizia e' stata disabilitata perche' cancellava logicamente le abilitazioni impostate da Areagate |
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 APCRMUSRTA
| Dato | Contenuto |
|---|---|
| A-CTU-AZIENDA | Codice azienda |
| A-CTU-OPE | CTU-OPE |
| A-CTU-TAT | CTU-TAT |
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 CRMUSRTA NB: se a questo punto A-CTU-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-CTU-AZI | Codice azienda | |
| A-CTU-OPE | CTU-OPE | |
| A-CTU-TAT | CTU-TAT | |
| A-CTU-AGGIORNATO | " " | |
| A-CTU-ABILITATO | "S" | Si |
| A-CTU-FL-CANC | " " | Si |
| A-CTU-ID-SINCRO | Prossimo id sincro | |
| A-CTU-AGG-AGG | " " |
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 Sulla tabella di origine CRMUSRTA non esiste il flag di cancellazione logica; inoltre, se il record è * presente, significa abilitazione * non presente, significa non abilitazione Quindi si opererà come segue: 1. Scorrere tutti i record di APCRMUSRTA per l'azienda 2. Ricerca, per ciascuno, del corrispondente record su CRMUSRTA A questo punto la situazione potrebbe essere la seguente:
| CRMUSRTA trovato? | A-CTU-FL-CANC | A-CTU-ABILITATO | Cosa fare |
|---|---|---|---|
| Si | "C" | qualunque | Aggiornare APCRMUSRTA impostando |
| Si | " " | <> "S" | |
| Si | " " | "S" | Nessuna operazione |
| No | "C" | qualunque | Nessuna operazione |
| No | " " | <> "S" | |
| No | " " | "S" | Aggiornare APCRMUSRTA impostando |
B.9 - Aggiornamento id syncro Al termine dell'elaborazione, aggiornare il record APSTATOSYN:
| Dato | Contenuto |
|---|---|
| A_SYN_AZIENDA | Codice azienda |
| A_SYN_TABELLA | "APCRMUSRTA" |
| 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 |
Casistica problemi noti¶
| Bug | Sintomo | Risoluzione |
|---|---|---|
| Giro PULIZIA cancella abilitazioni Areagate | Il giro di PULIZIA cancellava logicamente tutti i record APCRMUSRTA, azzerando le abilitazioni tipi attivita' impostate da Areagate (dal 16/12/2025) | Giro di pulizia disabilitato (01/04/2026, TASK-2974): la sincronizzazione differenziale gestisce correttamente l'allineamento senza necessita' di pulizia massiva |
Estratto da documentazione interna ClickUp