SWN075 - Schede CRM¶

Nome programma SWN075 Linkage section UTILAGPRG - Linkage comune Id processo: 75 Nome processo: SCHEDE-CRM Tabelle principali gestite

AREA	AREAGATE	Direzione
CRMANAGR	APCRMANAGR	------> <------

Versione tabella: 3 Logica generale Sincronizzazione dei nominativi CRM (solo record di testata) Esportazione Esportazione di tutti i nominativi effettivamente modificati (con dati variati). Importazione Le applicazioni WEB potranno inserire, modificare o cancellare logicamente nuovi nominativi ATTENZIONE: Se la configurazione gestione-schede-areagate è attiva, significa che le schede CRM vengono gestite interamente su Areagate, quindi non viene effettuata nessuna importazione. 26/04/2024 In presenza di questa configurazione, saranno sincronizzate solo le schede collegate ad una tipologia "Anagrafica", Logica di cancellazione da gestionale La cancellazione di un nominativo da gestionale attualmente è fisica. Se dovessimo seguire la prassi standard, dovremo effettuare la cancellazione logica dei record sulle tabelle. Dato però che le tabelle figlie (ARPSKDATI/ARPSKDATN) potrebbero molto pesanti da gestire, si è concordato con la parte web di operare in modo diverso; quindi in questo processo, quando si incontra un nominativo cancellato fisicamente dal gestionale, si dovrà: * Cancellare logicamente APCRMANAGR * Cancellare fisicamente ARPSKDATI/ARPSKDATN/ARPSKDATF Dopodichè gli script di sincronizzazione da KPN ad APP saranno ottimizzati per poter gestire correttamente questa situazione. In questo modo evitiamo di dover leggere/scrivere "n" id sincro per ciascuna tabella interessata ma con una unica query otteniamo il risultato richiesto. Configurazioni possibili

Gruppo	Parametro	Note
abilita	attiva-areaapp
areaapp	cod-azienda
areaapp	db-conn-string
areaapp	agg-postgres-online
clipot	info-nominativo-cancellato
clipot	info-account
ass-chiam	info-crm-zona
clipot	numerazione-web-nominativi
clipot	gestione-schede-areagate

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: APCRMANAGR Se fallita inviare una Segnalazione critica e chiudere. C - Importazione aggiornamenti Effettuare una query per estrarre tutti gli elementi aggiornati su APP: SELECT * FROM APCRMANAGR WHERE a_cra_azienda = azienda AND a_cra_agg_app = 'A' Se la configurazione gestione-schede-areagate è attiva, verificare a quale tipologia nominativo appartiene, tramite una lettura su CRMTIPCL:

Dato	Descrizione
TCL-COD	A-CRA-TIP

Se TCL-ANA-TIP <> "C" e <> "F" skippare il record Per ciascun record valido, se il campo: A_CRA_COD vale: * "0": significa che è un nuovo nominativo inserito su smartphone; eseguire C.1 * <> 0: significa che sullo smartphone il nominativo è stato aggiornato; eseguire C.2 Non è prevista per il momento la cancellazione di un nominativo, nè logica nè fisica in ambiente web C.1 - Inserimento nuovo nominativo In questo caso avremo anche A_CRA_ID_DISPOSITIVO e A_CRA_IDD_PROG significativi. Se la configurazione numerazione-web-nominativi è attiva un nominativo nuovo potrà avere il codice ufficiale, quindi in questo caso mantengo il primo giro ma consento anche di acquisire nuovi nominativi con il codice ufficiale, e quindi durante il giro C.2 C.1.1 - Creazione nuovo nominativo Chiamata a CRMS07 con i dati:

Dato	Descrizione
CRMS07-OPE	"SCRIVI"
CRMS07-TCL	Tipologia configurata in "clipot"-"tipo-nominativo-anagr-cliente"
CRMS07-RAGSOC	A_CRA_NOME
CRMS07-IND	A_CRA_IND
CRMS07-CAP	A_CRA_CAP
CRMS07-LOCA	A_CRA_LOCA
CRMS07-PROV	A_CRA_PROV
CRMS07-NAZIONE	A_CRA_NAZIONE
CRMS07-CF	A_CRA_COD_FIS
CRMS07-PI	A_CRA_PIVA
CRMS07-COMUNE	A_CRA_COMUNE

La regione non viene passata perchè viene ricavata dalla provincia Restituirà CRMS07-NOM, che contiene il codice nominativo creato C.1.2 - Rimozione record di input Il record di origine da cui siamo partiti su APCRMANAGR va cancellato. C.1.3 - Informazioni variabili Le informazioni variabili vengono sincronizzati dagli appositi processi C.2 - Aggiornamento nominativo esistente In questo caso avremo A_CRA_ID_DISPOSITIVO e A_CRA_IDD_PROG = 0, mentre avremo A_CRA_COD significativo. C.2.1 - Aggiornamento nominativo Chiamata a CRMS07 con i dati:

Dato	Descrizione
CRMS07-OPE	"AGGIORNA"
CRMS07-NOM	A_CRA_COD
CRMS07-RAGSOC	A_CRA_NOME
CRMS07-IND	A_CRA_IND
CRMS07-CAP	A_CRA_CAP
CRMS07-LOCA	A_CRA_LOCA
CRMS07-PROV	A_CRA_PROV
CRMS07-NAZIONE	A_CRA_NAZIONE
CRMS07-CF	A_CRA_COD_FIS
CRMS07-PI	A_CRA_PIVA
CRMS07-COMUNE	A_CRA_COMUNE

C.2.2 - Aggiornamento APCRMANAGR Aggiornare il record di origine impostando:

Dato	Descrizione
A_CRA_AGG_APP	"N"

C.3 - Aggiornamento informazioni speciali Sia in caso di inserimento che di variazione, eseguire la ricerca informazioni speciali (D.1) per il tipo nominativo importato. Quindi, se per la tipologia in esame sono presenti le informazioni per: * K-IFL-LATITUDINE * K-IFL-LONGITUDINE * K-IFL-TEL * K-IFL-EMAIL * info-account aggiornare i relativi record sulla scheda CRM, usando CRMS06

Dato	Contenuto
CRMS06-OPE	"SCRIVI"
CRMS06-NOM	Codice nominativo in elaborazione
CRMS06-INF	Numero informazione interessata all'operazione
CRMS06-DATO-NUM	A_CRA_LATITUDINE A_CRA_LONGITUDINE
CRMS06-DATO	A_CRA_TELEFONO A_CRA_EMAIL

Verificare che sulla scheda importata i dati siano presenti, al termine dell'elaborazione C.4 - Aggiornamento informazioni variabili Le informazioni variabili vengono sincronizzati dagli appositi processi 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: gestita tramite una informazione configurata; si dovrà comunque prevedere un processo di pulizia 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 "CRMANAGR"; se il record non esiste, crearlo impostando

Dato	Contenuto
A-SYN-AZIENDA	Codice azienda
A-SYN-TABELLA	"CRMANAGR"
A-SYN-DA-GES-DATA	0
A-SYN-DA-GES-ORA	0
A-SYN-DA-ID-SINCRO	1
A-SYN-VERSIONE	3

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 è < 3, azzerare data/ora esportazione, in modo da ripetere l'esportazione per tutti i nominativi (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à CRA-CHIA1)	Si legge direttamente il record da aggiornare su CRMANAGR 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 CRMANAGR, e si considerano solo i record dove CRA-DA-DATA+CRA-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à CRA-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 Se la configurazione gestione-schede-areagate è attiva, verificare a quale tipologia nominativo appartiene, tramite una lettura su CRMTIPCL:

Dato	Descrizione
TCL-COD	CRA-TIP

Se TCL-ANA-TIP <> "C" e <> "F" skippare il record Dopodichè si effettua la ricerca dell'nominativo su APCRMANAGR

Dato	Contenuto
A-CRA-AZIENDA	Codice azienda
A-CRA-ID-DISPOSITIVO	0
A-CRA-IDD-PROG	0
A-CRA-COD	CRA-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 CRMANAGR Per ciascun nominativo leggere la tipologia a cui è associato su CRMTIPCL:

Dato	Contenuto
TCL-COD	CRA-TIP

Se la tipologia non prevede l'esportazione, skippare l'esportazione del record ma aumentare comunque data/ora ultimo record esportato. NB: se a questo punto A-CRA-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-CRA-AZIENDA	Codice azienda
A-CRA-ID-DISPOSITIVO	0
A-CRA-IDD-PROG	0
A-CRA-COD	CRA-COD

A-CRA-NOME	CRA-NOME (*)	Si
A-CRA-TIPO-ANAGR	CRA-ANA-TIP	Si
A-CRA-ANA	CRA-ANA	Si
A-CRA-TIP	CRA-TIP	Si
A-CRA-AGENTE	CRA-AGE	Si
A-CRA-ZONA	Zona su COGGEANA x tipo "C" e codice <> zero	Si
A-CRA-IND	CRA-IND (*)	Si
A-CRA-CAP	CRA-CAP	Si
A-CRA-LOCA	CRA-LOCA	Si
A-CRA-PROV	CRA-PROV	Si
A-CRA-COMUNE	Usando CRMS06, ricerca dell'informazione fissa "comune":	Si
A-CRA-PIVA	Usando CRMS06, ricerca dell'informazione fissa "partita IVA":	Si
A-CRA-COD-FIS	Usando CRMS06, ricerca dell'informazione fissa "Codice fiscale":	Si
A-CRA-FL-CANC	Usando CRMS06, ricerca dell'informazione info-nominativo-cancellato, se significativa Se viene restituito "1" in CRMS06-DATO, significa che il nominativo è cancellato, quindi inserire "C"; In tutti gli altri casi lasciare vuoto	Si
A-CRA-REGIONE	Usando CRMS06, ricerca dell'informazione fissa "Regione":
A-CRA-NO-ESPORTAZIONE	Attraverso il punto D.1, ricerca delle informazioni speciali per il tipo nominativo A-CRA-TIP Quindi usando CRMS06, ricerca del valore corrispondente alle informazioni trovate, e passarle in questi campi	Si
A-CRA-LATITUDINE	Si
A-CRA-LONGITUDINE	Si
A-CRA-TELEFONO	Si
A-CRA-EMAIL	Si
A-CRA-ACCOUNT	Si

A-CRA-ID-SINCRO	Prossimo id sincro
A-CRA-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 Sulla tabella di origine CRMANAGR non esiste il flag di cancellazione logica. Quindi si opererà come segue: 1. Scorrere tutti i record di APCRMANAGR per l'azienda 2. Ricerca, per ciascuno, del corrispondente record su CRMANAGR Se la configurazione gestione-schede-areagate è attiva, verificare a quale tipologia nominativo appartiene, tramite una lettura su CRMTIPCL:

Dato	Descrizione
TCL-COD	A-CRA-TIP

Se TCL-ANA-TIP <> "C" e <> "F" skippare il record A questo punto la situazione potrebbe essere la seguente:

CRMANAGR trovato?	A-CRA-FL-CANC	Cosa fare
Si	"C"	Aggiornare APCRMANAGR impostando
Si	" "	Nessuna operazione
No	"C"	Nessuna operazione
No	" "	Aggiornare APCRMANAGR impostando Inoltre:

B.4 Occupazione numerazione condivisa Procedura specifica per l'operazione "OCCUPA-KEY" In questa operazione si riceve una chiave di testata nominativo (CRA-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 APCRMANAGR con la chiave:

Dato	Contenuto
A-CRA-AZIENDA	Codice azienda
A-CRA-ID-DISPOSITIVO	0
A-CRA-IDD-PROG	0
A-CRA-COD	CRA-COD

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	"CRMANAGR"
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	3

Estratto da documentazione interna ClickUp