Navigation:  »No topics above this level« SWA014: Sincronizzazione attività CRM

Nome programma

SWA014

 

Linkage section

 

Programma richiamabile direttamente da una funzione di lancio, o da uno schedulatore

 

Configurazioni possibili

 

 

Logica generale del programma

 

Questo programma permetterà la sincronizzazione (import/export) delle attività i CRM tra gestionale e base dati Postgres

Le attività CRM sono oggetti che potrebbero essere aggiornati e/o cancellati sia su gestionale che su APP. Quindi per poter ottenere correttamente le attività cancellate è necessario eseguire l'esportazione usando il log aggiornamenti.        

La prima esportazione avverrà invece nel modo classico, esportando tutte le attività presenti nel sistema.

 

Importazione attività (20/04/2018)

In fase di importazione, la logica è la seguente:

•Tutte le attività nuove sono importate cosi' come sono; se sono già state chiuse su APP saranno importate come chiuse

•Tutte le attività già esistenti (quindi quelle che erano state inserite su gestionale, o inserite su APP e non chiuse) potranno essere importate e chiuse, ma saranno aggiornate solo alcune informazioni specifiche (vedi il punto B.2)

 

 

Maschera del programma

 

Nella maschera del programma mostrare solo il contatore dei record elaborati.

 

Elaborazione

 

A - Esportazione attività

 

Seguendo le Linee guida per la sincronizzazione, eseguire l'esportazione delle attività.

 

 

 

Su POSTGRES, tabella APSTATOSYN, leggere il record relativo alla tabella/oggetto da sincronizzare "CRMATTIV"; se il record non esiste, crearlo impostando

 

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 configurata l'esportazione massiva: swa014-esportazione-massiva = "S", verrà eseguito il punto A.1, altrimenti il punto A.2

 

A.1 - Esportazione massiva attività

 

•Scorrere CRMATTIV;

•Se l'attività ha data precedente alla data confiurata in swa014-data-inizio-exp-massiva, l'attività non sarà esportata

•Eseguire il punto A.1.1 per verificare se l'attività è di tipo "Agenda"; se si, cercare l'ora fine appuntamento con il punto A.1.2

•Eseguire A.3

 

A.1.1 - Ricerca se attività "Agenda"

 

•Verificare se su CRMAGAPP esistono record collegati all'attività in esame; se si, significa che l'attività è di tipo "Agenda".

 

A.1.2 - Ricerca fine appuntamento

 

Cercare con una start all'indietro l'ultimo record di CRMAGASP collegato ad una attività.

L'ora fine dell'appuntamento è data da "ASP-ORA + 15 minuti"

 

A.2 - Esportazione attività aggiornate/cancellate

 

Occorre verificare se per la tabella interessata il log aggiornamenti è attivo: quindi testare il campo TLF-CRM-LOG (8). Se il campo non vale "X" segnalare e uscire.

 

•Scorrere il log aggiornamenti relativo alla tabella interessata ricerca su LOGAGREC attraverso LGR-CHIA3, impostando:

oLGR-FILE = "CRMATTIV"

oLGR-DATA = A_SYN_DA_GES_DATA

oLGR-ORA = A_SYN_DA_GES_ORA

•Leggere tutti i record trovati

•leggere  LOGIDREC che contiene la chiave del file CRMATTIV

•Se e' il campo di linkage  denominato "utilswa-num-attivita" non e' = 0 si deve filtrare solamente i record con questo numero di attivita.  

•Eseguire il punto A.1.1 per verificare se l'attività è di tipo "Agenda"; se si, se si, cercare l'ora fine appuntamento con il punto A.1.2

•Per ciascun record valudo, se LGR-OPERAZIONE vale:

o"C": eseguire A.4

o"I": eseguire A.3

o"M": eseguire A.3

 

Se siamo in modalita' di "aggiornamento su singola attivita'" modifiicare "logdirec" mettere nel campo lgr-eseguito = "S" ed eseguire rewrite  allo scopo di indicare a SWA014 che gira in modo massivo, che si tratta di un record di cui e' gia' stato fatto l'aggioranamento.

 

A.3 - Esportazione attività nuova/aggiornata

 

Cerca l'esistenza di un record su APCRMATTIV avente:

 

 

Se non esiste, inserirlo.

Se esiste, aggiornarlo: se pero' A_CRT_AGG_APP = "S" o "C", inserire una segnalazione sul file di log.

 

A.3.1 - Aggiornamento APCRMATTIV

 

Cerca l'esistenza di un record su APCRMATTIV avente:

 

Informazioni con cui inserire/aggiornare un record su APCRMATTIV:

 

 

A.3.2 - Aggiornamento APCRMATTAN

 

Usando un opportuno comando SQL cancellare tutti i record di APCRMATTAN la cui chiave corrisponde alla chiave primaria di APCRMATTIV.

Dopodichè eseguire l'esportazione dei record CRMATTAN aventi:

•CRN-NUM = CRT-NUM

 

Per ciascun record inserire un nuovo record su APCRMATTAN:

 

 

 

A.3.3 - Aggiornamento APCRMATTOP

 

Usando un opportuno comando SQL cancellare tutti i record di APCRMATTOP la cui chiave corrisponde alla chiave primaria di APCRMATTIV.

Dopodichè eseguire l'esportazione dei record CRMATTOP aventi:

•CRP-NUM = CRT-NUM

 

Per ciascun record inserire un nuovo record su APCRMATTOP:

 

 

A.3.4 - Aggiornamento APCRMATTAL

 

Per motivi di performance, si cercherà di aggiornare (e quindi trasferire da server gestionale a server web) i soli allegati nuovi realmente modificati sull'attività (una attività potrebbe venire aggiornata, ma gli allegati non essere stati toccati).

Note su archiviazione remota

Se per la classe "Attività CRM" è attiva l'archiviazione remota, l'esecuzione di questa fase viene bypassata: anche se è stata appena attivata, i documenti non ancora remoti saranno sincronizzati e trasferiti dall'apposito processo incluso in ARC005.

 

 

A.3.4.1 - Azzeramento A_CRL_AGG_GEST

 

Eseguire un comando SQL con cui impostare "A_CRL_AGG_GEST="N"" per tutti i record relativi all'attività in corso:

 

A.3.4.2 - Controllo ed esportazione allegati

 

•Scorrere tutti i record di COGIMAGE attraverso IMG-CHIA2 aventi

oIMG-TIP-DOC = "AT"

oIMG-DOC-COGE (1:12) = numero attività

•Per ciascun record leggere il corrispondente record COGARIDX su ARX-CHIA2, impostando:

oARX-PROTOCOLLO = IMG-PROTOCOLLO

•A questo punto siamo posizionati su un allegato dell'attività; vediamo se sulla tabella web esiste ed è aggiornato:

•Lettura di APCRMATTAL impostando

 

 

•Quindi se il record esiste e:

oA_CRL_AGG_DATA = ARX-DA-DATA

oA_CRL_AGG_ORA = ARX-DA-ORA

▪Significa che l'allegato è già presente e aggiornato, quindi scartare il record

•Altrimenti proseguire:

•Estrazione documento: chiamata a COGU06 con i parametri:

 

 

A questo punto sarà presente un file nella cartella EXT-TMP-DIR con nome U06-FILE

 

•inserimento/aggiornamento record su APCRMATTAL:

 

 

•Trasferimento file sul server WEB, usando la subroutine di trasferimento FTP già usata per gli allegati di Assist, vedi SWA005:

oDA: EXT-TMP-DIR/U06-FILE

oA: cartella configurata "areaapp"-"cartella-ftp-attivita" / CRT-NUM "/" U06-FILE

oLa modalità di trasferimento dipenderà dalla configurazione attivazione-bucket

 

A.3.4.3 - Controllo allegati non presenti sul gestionale

 

Eseguire un comando SQL con cui cancellare tutti i record relativi all'attività in corso:

 

aventi ancora A_CRL_AGG_GEST = "N"

 

A.4 - Cancellazione attività

 

In questo caso dobbiamo semplicemente informare i dispositivi esterni che l'attività è stata cancellata; quindi:

 

Cerca l'esistenza di un record su APCRMATTIV avente:

 

 

Se il record viene trovato, aggiornare impostando:

 

 

B - Importazione attività

 

Scorrere APCRMATTIV eseguendo una apposita query che permetta di restituire i record aggiornati (A_CRT_AGG_APP = "S"). Per ciascun record trovato, se il campo: A_CRT_NUM vale:

•"0": significa che è una nuova attività inserito su smartphone; eseguire B.1

•<> 0: significa che sullo smartphone l'attività è stato aggiornata; eseguire B.2

 

24/04/2018

Aggiungo questa nota dopo aver controllato il comportamento attuale del programma che nel frattempo è stato pesantemente modificato per la sincronizzazione con Calendar/Scheduler.

Si considera "aggiornata" l'attività quando A_CRT_AGG_APP = "A"

 

B.1 - Inserimento nuova attività

 

Significa che il record è stato inserito da uno smartphone; in questo caso avremo anche A_CRT_ID_DISPOSITIVO e A_CRT_IDD_PROG significativi.

 

B.1.1 - Creazione nuova attività

 

NB: per il momento prevedo che l'attività sia collegata ad un solo nominativo e ad un solo utente destinatario, e con un solo allegato

 

Chiamata a CRMS08 impostando:

 

 

B.1.2 - Importazione allegati

 

Lettura di tutti i record id APCRMATTAL collegati all'attività; per ciascuno:

 

B.1.2.1 - Download allegato

 

Trasferimento file dal server WEB, usando la subroutine di trasferimento FTP già usata per gli allegati di Assist, vedi SWA005:

oDA: cartella configurata "areaapp"-"cartella-ftp-attivita" / CRT-NUM "/" A_CRL_DOCUMENTO

oA: EXT-TMP-DIR/A_CRL_DOCUMENTO

 

B.1.2.2 - Archiviazione allegato

 

Archiviazione del documento sull'attività, con una chiamata a COGU06:

 

 

B.1.3 - Rimozione record di input

 

Il record di origine da cui siamo partiti su APCRMATTIV va cancellato, assieme ai record collegati alla stessa attività sulle altre tabelle:

•APCRMATTAN

•APCRMATTOP

•APCRMATTAL

 

B.1.3 - Riesportazione record

 

La nuova attività dovrà essere riesportata come spiegato al punto A.3

 

B.2 - Aggiornamento attività esistente

 

In questo caso avremo A_CRT_ID_DISPOSITIVO e A_CRT_IDD_PROG = 0, mentre avremo A_CRT_NUM significativo.

 

Effettuare una chiamata specifica a CRMS08:

 

 

 

B.2.2 - Aggiornamento APCRMATTIV

 

Aggiornare il record di origine impostando:

 

 

C - Aggiornamento APSTATOSYN

 

Aggiornare il record APSTATOSYN relativo a:

 

e aggiornare i dati: