Navigation:  »No topics above this level« DBF104 - Import/export chiamate/interventi

Posizione nel menu

Programma non a menu

 

Linkage section

 

UTILDBFPRG - Linkage comune

 

Nome processo: CONTATTI

 

Tabelle:

•DFCHIAMATE - Chiamate o richieste di intervento

•DFCHIAMATEDOC - Galleria documenti su chiamata

•DFINTERVENTI - Interventi eseguiti

 

Logica generale

 

Sincronizzazione di chiamate/interventi tra AREA e il DB frontiera.

 

Questo processo funziona in IMPORT e EXPORT

 

I dettagli sulla logica sono in Chiamate/interventi (DBF104)

 

Configurazioni possibili

 

 

Elaborazione

 

Tipi di segnalazione:

Vedi Tipi di segnalazione

 

A - Controllo di esecuzione

Vedi Controllo di esecuzione

 

A.1 - Controllo log ASNCHTES/ASNINTES

Per l'esecuzione di questo programma è necessario aver attivato il log sul file ASNINTES, altrimenti risulta impossibile tracciare le cancellazioni dei documenti.

 

Quindi:

•se il dato TLF-ASN-LOG (26) è diverso da "X", inviare una Segnalazione grave e chiudere.

 

B - Apertura

 

B.1 Apertura tabelle

 

Tentare l'apertura della tabella da sincronizzare: DFCHIAMATE. Se fallita inviare una Segnalazione grave e chiudere.

Tentare l'apertura della tabella da sincronizzare: DFCHAMATEDOC. Se fallita inviare una Segnalazione grave e chiudere.

Tentare l'apertura della tabella da sincronizzare: DFINTERVENTI. Se fallita inviare una Segnalazione grave e chiudere.

Tentare l'apertura della tabella semaforo: DFSEMAFORO. Se fallita inviare una Segnalazione grave e chiudere.

 

B.2 Blocco semaforo

 

Lettura del record DFSEMAFORO:

 

 

Se il record non esiste inserirlo. Se risulta bloccato dal gestonale host (DF_SMF_USO_HOST = 1) Informazione sul log e chiudere.

 

Dopodichè aggiornare il semaforo impostando:

 

 

Ripetere l'operazione per le tabella DFCHIAMATEDOC e DFINTERVENTI

 

B.3 Aggiornamento stato

 

Aggiornamento dello stato sul record specifico; in particolare:

 

 

B.4 Operazioni preliminari

 

B.4.1 Caricamento tecnici

Preparare un file di transito interno al programma ("T-TECNICI") dove la chiave è il "codice host" (ATN-CODICE-HOST), scorrendo COGANATN e memorizzando in questa tabella il raccordo tra ATN-CODICE-HOST e ATN-RIF-COD (COGANATN non contiene una chiave su ATN-CODICE-HOST).

Questa tabella servirà per la ricerca del tecnico preassegnato.

 

B.4.2 Caricamento provenienze

Preparare una tabella in memorie ("T-PROVENIENZE") dove caricare le provenienze chiamate da ASNPROVC. I campi necessari sono

•APRV-COD

•APRV-CODICE-HOST

 

B.4.2 Caricamento priorita

Preparare una tabella in memorie ("T-PRIORITA") dove caricare le priorita chiamate da ASNPRIOR. I campi necessari sono

•APRI-COD

•APRI-CODICE-HOST

 

B.4.3 Caricamento tipi attività

Preparare una tabella in memorie ("T-TIPI-ATT") dove caricare i tipi attività da ASNTPATT. I campi necessari sono

•ATPA-COD

•ATPA-CODICE-HOST

 

C - Sincronizzazione (Importazione)

 

Se DBFST-FL-ATTIVAZIONE = 'E' (solo esportazione). segnalare Informazione sul log e skippare questa fase.

 

C.1 Selezione nuove chiamate da importare

 

Tramite un comando SQL specifico, estrazione di tutte le nuove richieste di intervento (chiamate) create dall'HOST:

SELECT * FROM DFCHIAMATE WHERE DF_CHT_AGG_HOST = 1

 

I documenti trovati in questo modo potrebbero essere:

•Chiamate inserite dall'HOST

•Chiamate inserite dall'HOST e successivamente variate

•Chiamate inserite su AREA che sono stati acquisiti dall'HOST e successivamente variati

 

I documenti del primo tipo saranno importati; gli altri ignorati e solamente marcati come "processati"

 

C.2 Controllo record di testata

 

Per ciascun record letto, verificare la correttezza delle informazioni contenute

 

Controllo DF_CHT_KEY_HOST

Questa informazione, in fase di importazione deve essere significativa, altrimenti segnalare Errore .

 

Controllo DF_CHT_ORIGINE

Questa informazione potrà contenere "A" o "H", altrimenti segnalare Errore e skippare: "DF_CHT_KEY con DF_CHT_ORIGINE errato: DF_CHT_ORIGINE".

Se contiene "A" significa che il documento è stato generato da AREA; per il momento ignoriamo le variazioni su questi documenti, quindi Informazione sul log e skippare il record.

 

Controllo DF_CHT_ID_AREA

Se presente, significa che il documento è già stato acquisito da AREA: segnalare Informazione: "DF_CHT_KEY; Chiamata DF_CHT_KEY_HOST già acquisita su chiamata AREA: DF_CHT_ID_AREA" sul log, marcare il record come aggiornato e skippare il record

 

Controllo DF_CHT_VAL

Questo campo potrà contenere "C" o " " altrimenti segnalare Errore e skippare: "DF_CHT_KEY con DF_CHT_VAL errato: DF_CHT_VAL".

Se value "C":
- se la chiamata non è ancora stata acquisita, marcare il record come aggiornato senza effettuare altri aggiornamenti (vedi C.4.1.1).
- se la chiamata è già stata acquisita, eseguire la sezione C.4.1.2 Cancellazione chiamata

 

Controllo DF_CHT_DATA_RICHIESTA

Data documento: questo campo dovrà essere significativo e contenere una data valida, altrimenti segnalare Errore e skippare.

 

Controllo DF_CHT_DATA_PROGRAMMATA

Data di richiesta intervento: questo campo è opzionale. Se presente deve contenere una data valida, altrimenti segnalare Errore e skippare.

 

Controllo DF_CHT_ANA_DST_HOST

Informazione obbligatoria; deve corrispondere ad un cliente: ricerca su COGANAP2.AAP2-CHIA2, impostando

•AAP2-RACCORDO = DF_CHT_ANA_DST_HOST

Se il raccordo:

➢Esiste: la chiamata sarà collegata all'anagrafica trovata; il tipo anagrafico sarà dovrà essere di tipo "C"

➢Non esiste: l'anagrafica a cui è collegati il contatto non è stato ancora acquisita: Informazione e skippare: "DF_CHT_KEY collegato ad anagrafica non ancora importata : DF_CHT_ANA_DST_HOST"

 

Controllo DF_CHT_ANA_FAT_HOST

Come sopra. Se non indicato, corrisponderà al cliente destinatario DF_CHT_ANA_DST_HOST.

 

Controllo DF_CHT_IND_HOST

Se indicato dovrà corrispondere ad un indirizzo di spedizione presente in DFINDIR (fare la ricerca su DF_IND_KEY_HOST). Se non presente segnalare Errore e skippare. Se presente questo indirizzo deve essere già stato importato e collegato su AREA: dovrà quindi avere DF_IND_AREA_PROG valorizzato. Altrimenti segnalare Informazione e skippare: "DF_CHT_KEY collegato ad indirizzo non ancora importata : DF_CHT_IND_HOST"

 

Controllo DF_CHT_MATR_HOST_1

Controllo DF_CHT_MATR_HOST_2

Controllo DF_CHT_MATR_HOST_3

Questi campi potranno indicare fino a 3 matricole di assistenza collegate alla chiamata.

Per ciascun campo significativo controllare quindi se la matricola indicata corrisponde ad un s/n matricola di assistenza, con una ricerca su ASNMATRI usando AMTR-CHIA2. Se non presente segnalare Errore e skippare.

 

Controllo DF_CHT_TEC_HOST

Campo non obbligatorio. Se indicato corrisponde ad un tecnico a cui è stato pre-assegnato l'intervento.

Verificare quindi su T-TECNICI se il tecnico DF_CHT_TEC_HOST è già stato acquisito. Se non trovato, segnalare Errore e skippare:  "DF_CHT_KEY collegato a tecnico non acquisito: DF_CHT_TEC_HOST"

 

Controllo DF_CHT_PROVENIENZA

Campo non obbligatorio. Se indicato deve corrispondere ad una provenienza chiamata.

Verificare quindi su T-PROVENIENZE se la provenienza DF_CHT_PROVENIENZA è già stato acquisita e raccordata. Se non trovata, segnalare Errore e skippare:  "DF_CHT_KEY collegato a provenienza non raccordata: DF_CHT_PROVENIENZA"

 

Controllo DF_CHT_PRIORITA

Campo non obbligatorio. Se indicato deve corrispondere ad una priorita chiamata.

Verificare quindi su T-PRIORITA se la provenienza DF_CHT_PRIORITA è già stato acquisita e raccordata. Se non trovata, segnalare Errore e skippare:  "DF_CHT_KEY collegato a priorita non raccordata: DF_CHT_PRIORITA"

 

Controllo DF_CHT_TIPO_ATTIVITA

Campo non obbligatorio. Se indicato deve corrispondere ad un tipo attività chiamata.

Verificare quindi su T-TIPI-ATT se la provenienza DF_CHT_TIPO_ATTIVITA è già stato acquisita e raccordata. Se non trovata, segnalare Errore e skippare:  "DF_CHT_KEY collegato a tipo attività non raccordata: DF_CHT_TIPO_ATTIVITA"

 

 

Controllo DF_CHT_SITUAZIONE

Campo non obbligatorio. In questo contesto (importazione di nuova richiesta potrà essere solo:

•" ": Aperta e non assegnata

•"A": se è stato indicato tecnico e data programmata (dati con cui sarà possibile creare e assegnare un intervento)

 

C.3 Controllo documenti allegati

 

Per ciascun record letto, potrebbe essere richiesta l'archiviazione di uno o più documenti nella galleria immagini della chiamata.

 

Tramite un comando SQL specifico, estrazione di tutti gli allegati documento per la chiamata in elaborazione:

SELECT * FROM DFCHIAMATEDOC WHERE DF_CHG_KEY_HOST = DF_CHT_KEY_HOST

 

Per ciascun record letto i controlli sono i seguenti:

 

Controllo DF_CHG_ALLEGATO

Questo campo deve contenere il nome valido di un file presente, come percorso "client".
Controllare l'esistenza usando l'apposita funzione "FILEINFO" di "COPIAF".

Se non presente, segnalare Errore e al termine del ciclo skippare la chiamata:  "DF_CHG_KEY; documento da acquisire non esistente: DF_CHT_ALLEGATO"

 

C.4 Importazione record

 

Se tutti i controlli sono superati, proseguire con l'inserimento/aggiornamento della chiamata.

 

C.4.1 Cancellazione

 

C.4.1.1 Cancellazione di documento non importato

 

Se DF_CHT_ID_AREA è 0: significa che il documento non era mai stato importato: marcare il record come "elaborato":

 

 

segnalare Informazione e skippare: "DF_CHT_KEY documento cancellato ma non ancora importato"

 

C.4.1.2 Cancellazione di chiamata importata importato

 

Se DF_CHT_ID_AREA è > 0: significa che il documento era già stato importato. Quindi, se

•La provenienza è "Area" (DF_CHT_ORIGINE = 'A') -> Segnalare  "Chiamata da cancellare inserita da Area: DF_CHT_ID_AREA : non verrà cancellata"

•L'intervento collegato alla chiamata è già chiuso o pre-chiuso (ACIT-STATO = 'P' o 'C'') -> Segnalare  "Chiamata già eseguita: DF_CHT_ID_AREA : non verrà cancellata"

 

In tutti gli altri casi si dovrà effettuare la cancellazione della chiamata e dell'intervento collegato, usando la routine ASNS06

 

 

Al termine, in base all'esito e al messaggio restituito, segnalare con errore o con informazione sul log riportando anche il messaggio restituito.

 

C.4.2 Inserimento

 

Se DF_CHT_ID_AREA è vuoto: dobbiamo effettuare l'inserimento della chiamata.

 

Chiamata a ASNS20, Operazione: INSERISCI

 

 

Se l'operazione fallisce verrà restituito ASNS20-ESITO = "N", e un messaggio: in questo caso segnalare Errore e skippare:  "DF_CHT_KEY chiamata non inserita; esito: ' ASNS20-MSG'"

 

Altrimenti ASNS20-O-CHIAMATA conterrà l'id chiamata creato.

 

C.4.2.1 Inserimento allegati sulla galleria

 

Se durante la fase di controllo abbiamo trovato l'esistenza di documenti allegati, allora ripetere la query di estrazione:

SELECT * FROM DFCHIAMATEDOC WHERE DF_CHG_KEY_HOST = DF_CHT_KEY_HOST

 

Per ciascun record letto effettuare una chiamata a ASNS20, Operazione: ALLEGA-DOC

 

 

Se l'operazione fallisce verrà restituito ASNS20-ESITO = "N", e un messaggio: in questo caso segnalare Errore ma proseguire con l'elaborazione:  "DF_CHG_KEY documento non allegato; esito: ' ASNS20-MSG'"

 

Al termine aggiornare il record di testata documento:

 

 

 

D - Sincronizzazione (esportazione)

 

Se DBFST-FL-ATTIVAZIONE = 'I' (solo importazione). segnalare Informazione sul log e skippare questa fase.

 

D.1 Interventi cancellati

 

In questa fase dovremo controllare gli interventi che sono stati cancellati, usando il log su ASNINTES.

 

Quindi, si dovrà scorrere LOGAGREC usando LGR-CHIA3, a partire dall'ultimo aggiornamento effettuato.

 

 

Per ciascun record letto cerchiamo il corrispondente record LOGIDREC:

 

 

In LRR-CHIAVE troveremo la chiave del documento, corrispondente a ACIT-CHIA1.

 

Quindi, se LGR-OPERAZIONE è diversa da "C" leggere il prossimo record di log:

 

Verifichiamo se l'intervento è già stato esportato, con una ricerca su DFINTERVENTI, tramite query:
 
SELECT * FROM DFINTERVENTI WHERE DF_INTT_ID_AREA = ACIT-ID
impostando:

 

 

Se il record non esiste, allora il documento non è mai stato esportato, Informazione sul log e skippare.

 

Se il record esiste, allora è già stato esportato: però se è stato generato dall'HOST (DF_CHT_ORIGINE = "H") lo dobbiamo ignorare: Informazione sul log e skippare.

 

Altrimenti dovremo aggiornare DFINTERVENTI:

 

 

D.1.1 Cancellazione chiamata

 

Sull'intervento elaborato troveremo DF_INTT_CHT_ID_AREA, che contiene la chiamata a cui l'intervento è collegato.

Ora dobbiamo verificare se la chiamata risulta collegata ad interventi non cancellati, con un comando SQL specifico:

 

SELECT * FROM DFINTERVENTI WHERE DF_INTT_CHT_ID_AREA = chiamata AND DF_INTT_VAL <> 'C'

 

Se la query non restituisce nessun record, allora dobbiamo marcare come cancellata anche la chiamata:

 

Lettura del record DFCHIAMATE dove DF_CHT_ID_AREA = chiamata, quindi aggiornarla:

 

 

 

D.2 Interventi nuovi/aggiornati

 

Scorrere ASNINTES usando ACIT-CHIA8, impostando:

 

Ciascun record letto è un intervento aggiornato e già esportato sul MasterDB KPN, e quindi può essere esportato sul db di frontiera.

 

Leggere ASNINTES, e da qui risalire alla testata chiamata ASNCHTES; se è una chiamata fittizia (ACHT-SITUAZIONE = "Z") aggiornare ACIT-FL-WEB-CHIUSE a "T", skippare e proseguire con il prossimo record.

 

D.2.1 Controlli preliminari

 

Prima di iniziare gli aggiornamenti dobbiamo verificare se tutti i raccordi necessari sono presenti: se uno qualunque dei controlli successivi fallisce segnalazione di Errore e skippare il record.

 

I controlli necessari sono:

 

Inizio aggiornamenti

 

Verifichiamo se il documento inserito/aggiornato è già stato esportato, con una ricerca diretta su DFINTERVENTI, usando DF_INTT_CHIA3, impostando:

 

 

Se il record esiste, allora è già stato esportato: però se è stato generato dall'HOST (DF_INTT_ORIGINE = "H") lo dobbiamo ignorare: Informazione sul log e skippare.

 

D.2.2 Inserimento DFINTERVENTI

 

Se il record non esiste inserire un record su DFINTERVENTI:

 

 

D.2.3 Aggiornamento DFINTERVENTI

 

In tutti i casi, dobbiamo trasferire i dati dell'intervento su DFINTERVENTI e aggiornarlo.

 

 

D.2.4 Verifica esistenza DFCHIAMATE

 

Lettura  DFCHIAMATE usando DF_CHT_CHIA3:

 

Se il record non esiste va inserito con i dati minimi necessari:

 

Dopodichè in ogni caso aggiornare i campi variati e aggiornare

 

D.2.4 Aggiornamento flag esportazione

 

Aggiornare ASNINTES per il documento in elaborazione, impostando

 

 

E - Chiusura

 

E.1 Rilascio semaforo

 

Aggiornare i record semaforo relativi alle tabelle elaborate impostando

 

 

 

E.2 Chiusura tabelle

 

Chiudere le tabella usate nell'elaborazione e DFSEMAFORO

 

E.3 Aggiornamento stato

 

Aggiornamento dello stato sul record specifico; in particolare:

 

 

Registrare il log procedura il numero di interventi:

•Importati validi

•Importati cancellati

•Esportati validi

•Esportati cancellati