Vai al contenuto

SWA005: importazione interventi eseguiti

Logica generale del programma Questo programma dovrà eseguire l'importazione degli interventi eseguiti da un tecnico sullo smartphone Configurazioni possibili

Gruppo Parametro Note
....
areaapp modo-stampa-intervento
ass-chiam tipo-fat-assistenza
ass-chiam importa-desag-dettaglio
ass-chiam default-da-fatturare
ass-chiam flag-da-non-fatturare
assist cod-attivita-su-chiamata
avviso-default
avviso-ins-chiamata
tecnici-uso-mag-secondari
piping creazione-cliente-assistito Configurazioni specifiche per la fase di piping, ovvero la creazione automatica di una chiamata sulla base delle informazioni ottenute dal riconoscimento del contenuto di una mail
Vedi Riconoscimento informazioni
piping formato-indirizzo
piping separatore-indirizzo
ass-strum generazione-dossier Configurazioni per la creazione del dossier chiamata
ass-strum prefisso-id-dossier
ass-strum tipo-dossier-chiamata
aws attivazione-bucket

Procedure attinenti Gestione "check-list" su chiamate/interventi Casi su ARPINTES Elaborazione Questo programma esegure principalmente 2 elaborazioni: * Importazione interventi chiusi dal tecnico sulla APP * Creazione di chiamate/interventi "bianchi" utilizzati sulla APP per la creazione di nuove chiamate Controllo elaborazione Durante la fase di importazione di un intervento, il programma creerà un file di log nella cartella configurata in "LOG-DIR", chiamato: "SWA005-000000001234.log", dove 000000001234 è il numero intervento che si sta importando. Questo file contiene una serie di segnalazioni riguardanti lo stato del processo, in particolar modo per quanto riguarda l'operazione di download/upload dal server FTP. Tutti gli output dei comandi FTP vengono inclusi nel file di log. Al termine delle operazioni di download, il sistema controllerà l'esistenza del file di testo che contiene l'elenco dei files da importare; se fallisce ritenterà fino a 5 volte, poi terminerà l'elaborazione, impostando il campo RCIT-FL-STAMPA-PDF = "E": questo attiverà l'invio di una mail specifica al responsabile dell'azienda. Lo stesso controllo viene effettuato durante l'UPLOAD del rapportino e/o del certificato sul server FTP. Elaborazioni preliminari Acquisizione nuovi clienti Come prima cosa viene innescato SWA030 - Importazione nuovi clienti: renderà disponibili i nuovi clienti sul gestionale.

C - Importazione nuovi interventi

Questa fase ha lo scopo di importare da KPN i nuovi interventi inseriti su chiamate esistenti da APP. Questi hanno la caratteristica di avere il progressivo di intervento > 50. Ne deriva che questa fase potrà essere eseguita solo se è configurato l'inserimento del numero intervento come progressivo sulla chiamata. Quindi ad esempio sulla chiamata 2450, un intervento inserito da APP potrà avere come id: * 245051 * .... * 245099 Query su ARPINTES, per cercare gli interventi appena inseriti; devono avere: * RCIT-FL-ACQUISITA = "I" * RCIT-FL-CANCELLATO <> "S" Lo stesso flag sarà impostato anche quando un intervento viene assegnato o spostato direttamente dallo scheduler. NO: questa cosa non è vera e viene gestita con il caso D Quindi, se l'intervento è: * nuovo: (non esistente su ASNINTES): l'id intervento dovrà essere composto come spiegato sopra: in caso diverso segnalare sul log e skippare l'importazione del record. * esistente: posso aggiornare sia interventi creati da APP che interventi creati dal gestionale e sono stati assegnati da APP (se ancora aperto, quindi ACIT-STATO = "A"). NB: Problema di sequenza importazione errata Puo' succedere per errore che venga acquisito un "nuovo intervento" su una chiamata non ancora acquisita. Per ovviare a questo, si dovr' verificare se sul gestionale la chiamata per cui si acquisisce l'intervento e' gia' presente, e se lo e' che non sia in situazione "Z": in questi casi si deve segnalare sul log e skippare l'elaborazione di questo intervento. Per ciascun intervento: C.1 Inserimento/Aggiornamento ASNINTES:

Nome campo Contenuto
ACIT-ID Id intervento
ACIT-ID-CHIAMATA RCIT-ID-CHIAMATA
ACIT-ASS-DATA
ACIT-ASS-ORA
RCIT-ASS-DATA
RCIT-ASS-ORA
ACIT-INT-DATA
ACIT-INT-ORA
RCIT-INT-DATA
RCIT-INT-ORA
ACIT-FL-SPOSTABILE "S"
ACIT-NOTE ?
ACIT-STATO-AVVISO

ACIT-MAG RCIT-MAG-DEFAULT
ACIT-STATO "A"
ACIT-FL-RISOLUTIVO "N"
ACIT-FL-BOL "N"
ACIT-TIPO-ATT RCIT-TIPO-ATT
ACIT-ORA-FINE RCIT-ASS-ORA-FINE
ACIT-FL-AGENDA "N" (per ora)
ACIT-TECNICO (1).... (10) Da ARPINTEC
ACIT-TARGA RCIT-TARGA
ACIT-NOTE RCIT-DESCRIZIONE (?)
ACIT-ID-CONTRATTO RCIT-ID-CONTRATTO
ACIT-PROG-MOD-INTERVENTO RCIT-PROG-MOD-INTERVENTO
ACIT-COMMESSA Copiare la commessa presente nella chiamata:
ACHT-COMMESSA
ACHT-SOTTOCOM
ACIT-SOTTOCOM

Se l'intervento in questa fase risulta "non assegnato" (ACIT-TECNICO (1) = 0) si dovrà cercare un tecnico da preassegnare con una chiamata a ASNS19:

Dato Contenuto
ASNS19-OPE "CERCA"
ASNS19-CLIENTE Cliente assistito collegato alla chiamata
ASNS19-DST Destinazione collegata alla chiamata
ASNS19-ID-MATRICOLA Matricola collegata alla chiamata

Assegnare il tecnico restituito all'intervento C.1.1 Automatismi sull'assegnazione tecnico: Vedi Acquisizione dati veicolo e magazzino tecnico C.2 Inserimento/Aggiornamento ASNINDAG Le note inserite in RCIT-NOTE-INTERNE devono essere inserite in questa tabella (vedi ASN120) C.3 Aggiornamenti ARPINTES:

Nome campo Contenuto
RCIT-FL-ACQUISITA "N"

C.4 invio avviso al cliente Se dopo l'operazione l'intervento aggiornato risulta assegnato, eseguire una chiamata a ASNS05 - Invio messaggio da chiamata/intervento :

Dato Formato Contenuto
ASNS05-CALLER x(08) Programma chiamante
ASNS05-ID-INTERVENTO 9(12) Id intervento elaborato
ASNS05-OPE x(20) "INVIO-INTERVENTO"

Questa operazione dovrebbe inviare una mail al cliente, quando previsto C.5 Importazione allegati Eseguire il giro di importazione allegati, analogo a quello descritto nel punto A.7.1

D - Interventi assegnati e modificati su scheduler

Questa fase ha lo scopo di importare da KPN interventi che sono stati modificati sullo scheduler. Definiamo che le modifiche possano essere le seguenti: * Modifica di ora appuntamento/data appuntamento * Modifica di un tecnico assegnatario * Modifica del veicolo: * Viene prelevato quello presente sull'intervento * In questo caso NON viene forzato quello eventualmente presente sul tecnico, diamo per scontato che abbia priorità la selezione effettuata sullo scheduler, anche se cambia il tecnico. * Modifica delle informazioni: * Oggetto * descrizione * Priorità * Stato chiamata NB: questo evento potrebbe avvenire in questi casi: * Assegnazione di un intervento * Modifica di un intervento assegnato * Modifica di un intervento non assegnato (ancora presente nell'albero a sx di Scheduler) D Selezione Query su ARPINTES, per cercare gli interventi che hanno: * RCIT-FL-ASSEGNATA = "M" Per ciascun intervento, verificare: * E' chiuso? (ACIT-STATO = "P" o "C"): segnalare un problema sul file di log e skippare Altrimenti proseguire D.1 Aggiornamento ASNCHTES: Aggiornare solo i campi descritti

Nome campo Contenuto
ACHT-OGGETTO RCIT-OGGETTO
ACHT-PRIORITA RCIT-PRIORITA
ACHT-NOTE RCIT-CHIAMATA-DES
ACHT-CHIAMATA-CLI RCIT-CHIAMATA-CLI
ACHT-FL-AREAGATE RCIT-FL-AREAGATE
ACHT-STATO RCIT-STATO-CHIAMATA
ACHT-CNT-TIP RCIT2-CNT-TIP (per il momento non c'è)
ACHT-CNT-COD RCIT2-CNT-COD (per il momento non c'è)

D.2 Aggiornamento ASNINTES: Aggiornare solo i campi descritti

Nome campo Contenuto
ACIT-ASS-DATA
ACIT-ASS-ORA
RCIT-ASS-DATA
RCIT-ASS-ORA
ACIT-INT-DATA
ACIT-INT-ORA
RCIT-INT-DATA
RCIT-INT-ORA
ACIT-FL-SPOSTABILE "S"
ACIT-ORA-FINE RCIT-ASS-ORA-FINE
ACIT-FL-AGENDA "S"
ACIT-TECNICO (1).... (10) Da ARPINTEC
ACIT-TIPO-ATT "G"
ACIT-TARGA RCIT-TARGA
ACIT-MAG RCIT-MAG-DEFAULT

D.3 Aggiornamento intervento su agenda Se è stata effettuata una modifica di pianificazione, ovvero: * Modifica data/ora intervento * Modifica ora fine * Modifica di uno o più tecnici è necessario modificare la pianificazione in agenda, con 2 chiamate a ASNS78: Cancellazione

Nome campo Contenuto
ASNS78'CALLER K-PROGRAM-ID
ASNS78-TIPO-ELAB "C"
ASNS78-ID-INTER Id intervento
ASNS78-CFG-ATTIVITA Tipo attività configurato in cod-attivita-su-chiamata (configurazione già presente nel programma)
ASNS78-TIPO-ATT ACIT-TIPO-ATT
ASNS78-LUOGO-EVENTO " "

Inserimento Da eseguire solo se in questo momento il tecnico è stato assegnato.

Nome campo Contenuto
ASNS78'CALLER K-PROGRAM-ID
ASNS78-TIPO-ELAB "I"
ASNS78-ID-INTER Id intervento
ASNS78-CFG-ATTIVITA TIpo attività configurato in cod-attivita-su-chiamata (configurazione già presente nel programma)
ASNS78-TIPO-ATT ACIT-TIPO-ATT
ASNS78-LUOGO-EVENTO Ricavare il luogo evento dall'indirizzo del cliente assistito con una chiamata a GETADDR (vedi ASN120)

D.4 Aggiornamenti ARPINTES:

Nome campo Contenuto
RCIT-FL-ASSEGNATA "X"

D.4.1. invio avviso al cliente Se dopo l'operazione l'intervento aggiornato risulta assegnato, eseguire una chiamata a ASNS05 - Invio messaggio da chiamata/intervento :

Dato Formato Contenuto
ASNS05-CALLER x(08) Programma chiamante
ASNS05-ID-INTERVENTO 9(12) Id intervento elaborato
ASNS05-OPE x(20) "INVIO-INTERVENTO"

Questa operazione dovrebbe inviare una mail al cliente, quando previsto

A - Ricerca e importazione interventi eseguiti su APP

A - Ricerca e importazione interventi eseguiti su APP Query su ARPINTES, per cercare gli interventi eseguiti; devono avere: * RCIT-FL-ESEGUITA = "S" * RCIT-FL-ACQUISITA <> "S" * L'intervento corrispondente sul gestionale non deve essere chiuso (ACIT-STATO <> "C") Operazioni preliminari Per ciascun intervento vengono effettuati i controlli descritti in Operazioni comuni preliminari --------------------------------------------------------------------------------------------------------------- MODIFICA 09/03/2017 conseguente ad introduzione reportistica su Jasper: Se risulta configurata la modalità d Jasper il flusso di processo subisce una profonda modificazione: viene valutato se TM-CFG-MODO-STAMPA 1. se TM-CFG-MODO-STAMPA <> "J" prosegue nel modo standard 2. se TM-CFG-MODO-STAMPA = "J" procede cosi: 1. se RCIT-FL-ESEGUITA = "S" 1. RCIT-FL-ACQUISITA = " " 1. se RCIT-FL-STAMPA-PDF = " " o = "P" 1. allora scarica SOLO i dati dell'intervento popolando le tabelle gestionali 2. al termine imposta RCIT-FL-ACQUISITA = "P" 2. se RCIT-FL-STAMPA-PDF = "A" 1. allora scarica sia i dati di intervento che le immagini (tra cui il PDF del voucher) da archiviare 2. al termine imposta RCIT-FL-ACQUISITA = "S" e RCIT-FL-STAMPA-PDF = "N" (per inibire l'esecuzione del postino) 2. RCIT-FL-ACQUISITA = "P" 1. se RCIT-FL-STAMPA-PDF = " " o "P" 1. non fa nulla ed esce 2. se RCIT-FL-STAMPA-PDF = "A" 1. allora scarica SOLO le immagini (tra cui il PDF del voucher) da archiviare 2. al termine imposta RCIT-FL-ACQUISITA = "S" e RCIT-FL-STAMPA-PDF = "N" (per inibire l'esecuzione del postino) Nel caso in cui la chiamata risulta inserita da APP, saranno effettuati anche alcuni aggiornamenti specifici atti a importare i dati della chiamata e della assegnazione (vedi A.4). Per ciascun intervento: A.1 Aggiornamento ASNINTES:

Nome campo Contenuto
ACIT-INT-DATA
ACIT-INT-ORA
RCIT-ESEC-DATA
RCIT-ESEC-ORA
ACIT-STATO "P"
ACIT-STATO-MOBILE "P"
ACIT-FL-RISOLUTIVO RCIT-FL-RISOLUTIVO
ACIT-FL-TRASFERTA RCIT-FL-TRASFERTA
ACIT-VIAGGIO-KM RCIT-VIAGGIO-KM
ACIT-VIAGGIO-ORE RCIT-VIAGGIO-ORE
ACIT-TIPO-INTERVENTO RCIT-TIPO-INTERVENTO
ACIT-IMPORTO-CONCORDATO RCIT-IMPORTO-CONCORDATO
ACIT-DST RCIT-DST
ACIT-MAG-DEFAULT RCIT-MAG-DEFAULT
ACIT-FL-WEB-CHIUSE " "
ACIT-PROG-MOD-INTERVENTO RCIT-PROG-MOD-INTERVENTO
ACIT-DST-ID-TIP RCIT-DST-ID-TIP
ACIT-DST-ID-IDX RCIT-DST-ID-IDX

A.1.1 Inserimento/aggiornamento ASNINTE2:

Nome campo Contenuto
ACIT2-ID-INTERVENTO Id intervento aggiornato
ACIT-NOME-FIRMA RCIT-NOME-FIRMA
ACIT2-MAG-TIP RCIT2-MAG-TIP
ACIT2-MAG-SEC RCIT2-MAG-SEC
ACIT2-FL-RESIDENZIALE RCIT2-FL-RESIDENZIALE
ACIT2-IMPORTO-PAGATO ARPINTADD.INTADD-IMPORTO-PAGATO
ACIT2-TIPO-ESITO RCIT2-TIPO-ESITO
ACIT2-CAUSALE-ESITO RCIT2-CAUSALE-ESITO

A.2 Aggiornamento ASNCHTES:

Nome campo Contenuto
ACHT-IVA-AGEVOLATA RCIT-IVA-AGEVOLATA
ACHT-STATO RCIT-STATO-CHIAMATA (se significativo)
Se il contratto è significativo
ACHT-ID-CONTRATTO RCIT-ID-CONTRATTO
ACHT-FL-CONTRATTO "S"
ACHT-MODELLO-CERT RCIT-MODELLO-CERT

A.2.1 Aggiornamento ASNCHDET: A seguito dell'introduzione della possibilita di modificare il modello di certificazione sulla APP anche per le matricole, si rende necessario aggiornare anche il dettaglio matricole sulla chiamata; Scorrere ARPCHDET per la chiamata in elaborazione. Per ciascuna matricola trovata, cercare il relativo record su ASNCHDET, e confrontare RCHT-MODELLO-CERT con ACHD-MODELLO-CERT; se diversi aggiornare:

Nome campo Contenuto
ACHD-MODELLO-CERT RCHT-MODELLO-CERT

A.3 Acquisizione certificazione: Questa parte permette l'acquisizione dei dati di certificazione, quindi importa: * ARPSKDATI -> su ASNCHINF * ARPSKDATN -> su ASNCHNNF NB: a seconda della modalità di certificazione si potrà avere: * Certificazione su testata (ASNCHTES.ACHT-MODELLO-CERT significativo): aggiornamento dei record con

Dato Contenuto
A-SKDI-ORIGINE "S"
A-SKDI-CLASSE "AI"
A-SKDI-OGGETTO ID Intervento
  • Certificazione su matricola (ASNCHDET.ACHD-MODELLO-CERT significativo): per ciascuna matricola aggiornamento dei record con
Dato Contenuto
A-SKDI-ORIGINE "S"
A-SKDI-CLASSE "AM"
A-SKDI-OGGETTO chiave ASNCHDET

A.3.1 Sincronizzazione certificazione con scheda CRM matricola: Se questa caratteristica è abilitata ( gestione-checklist-prec = "S" ) è necessario sincronizzare le informazioni previste sulla check-list con la scheda CRM corretta della matricola corretta; quindi: * Check-list su intervento: si sincronizza con la prima matricola trovata sulla chiamata * Check-list su matricola: si sincronizza con la matricola relativa La sincronizzazione avrà luogo se la matricola selezionata è collegata ad una scheda CRM: ASNMATRI.AMTR-COD-NOM > 0. In questo caso, si dovrà cercare CRMANAGR per ottenere il tipo nominativo collegato (CRA-TIP). Poi durante l'importazione dei dati come spiegato al punto A.3, per ciascuna informazione importata si procede come segue: A.3.1.1 - Verifico se l'informazione è da sincronizzare Posizionarsi su ASNSKINF:

Nome campo Contenuto
ASKI-MOD-NOME Il nome del modello di certificazione usato:


a seconda del tipo di check list
ASKI-PAG A-SKDI-PAGINA
ASKI-PROG A-SKDI-PROG

Se ASKI-FL-RIPORTA = "S" significa che l'informazione è da sincronizzare, quindi proseguo. In questo caso ASKI-IPT-NUM-SINCRO conterrà il codice informazione da sincronizzare. A.3.1.2 - Ricerca informazione su scheda CRM e aggiornamento Eseguire una chiamata a CRMS06 per aggiornare l'informazione:

Tipo Dato Contenuto
INPUT CRMS06-OPE "SCRIVI"
CRMS06-NOM Codice nominativo corrispondente alla scheda CRM matricola:
AMTR-COD-NOM
CRMS06-INF Informazione da aggiornare: ASKI-IPT-NUM-SINCRO
CRMS06-MODO-LETTURA-TABELLA "C"
CRMS06-DATO Informazione recuperata
Usare CRMS06-DATO-NUM se l'informazione è numerica o CRMS06-DATO negli altri casi
CRMS06-DATA-R

Questa chiamata dovrebbe già posizionarsi sull'informazione corretta (la prima sulla scheda contenente l'informazione cercata) A.4 Aggiornamenti specifici per chiamata creata su APP: Se l'intervento pre-chiuso ha: * RCIT-STATO = "Z" * RCIT-FL-ASSEGNATA = "S" significa che è stato prechiuso un intervento relativo ad una chiamata direttamente creata su APP. Quindi occorre effettuare alcuni aggiornamenti specifici: A.4.1 Aggiornamento ASNCHTES:

Nome campo Contenuto
ACHT-DATA
ACHT-ORA
RCIT-CHIAMATA-DATA
RCIT-CHIAMATA-ORA
ACHT-OGGETTO RCIT-OGGETTO
ACHT-CLI-ASS RCIT-ANA
ACHT-AGENTE Agente su anagrafica, se configurato
ACHT-CLI-FAT RCIT-CLI-FAT
Se non significativo sarà usato il cliente padre trovato sul cliente assistito in anagrafica
ACHT-PRIORITA RCIT-PRIORITA
ACHT-SCAD-DATA
ACHT-SCAD-ORA
RCIT-SCADENZA-DATA
RCIT-SCADENZA-ORA
ACHT-SITUAZIONE Se risulta collegata ad un tecnico -> "A"
Se non è collegata ad un tecnico -> " " (non assegnata)
ACHT-STATO Stato chiamata inserito su app, o se non presente, quello configurato
ACHT-NOTE RCIT-CHIAMATA-DES
ACHT-CHIAMATA-CLI RCIT-CHIAMATA-CLI
ACHT-CONTATTO-1 RCIT--CONTATTO-1
ACHT-CLASSE "C" (chiamata esterna)
ACHT-IVA-AGEVOLATA RCIT-IVA-AGEVOLATA (doppio)
ACHT-FL-AREAGATE RCIT-FL-AREAGATE
ACHT-PROVENIENZA RCIT-PROVENIENZA
ACHT-UTE-AG-COD RCIT-UTE-AG-COD
ACHT-OPERATORE Viene inserito WO-OPER, ovvero l'operatore attivo (che nel caso di elaborazione automatica da motore di sincronizzazione non ha senso).
Se:

l'utente è loggato come tecnico RCIT-PROVENIENZA = " "

allora viene impostato RCIT-UTE-AG-COD (l'operatore collegato al tecnico);
ACHT-TIPO-FAT Se = " ", inserire il valore configurato in tipo-fat-assistenza
ACHT-AVVISA-CLIENTE Prendere il valore di default configurato in avviso-default
ACHT-MODELLO-CERT RCIT-MODELLO-CERT
ACHT-FL-STA-RAP RCIT-FL-STA-RAP
ACHT-FL-STA-CERT RCIT-FL-STA-CERT
ACHT-CHIAMATA-GRATUITA Determinare se questo campo deve valere "S", con la stessa logica con cui è stato descritto in caso di inserimento in Inserimento/gestione chiamata
ACHT-NOM-ASS RCIT-NOM-ASS
ACHT-DST-ID-TIP RCIT-DST-ID-TIP
ACHT-DST-ID-IDX RCIT-DST-ID-IDX

A.4.2 Aggiornamento ASNINTES:

Nome campo Contenuto
ACIT-STATO Se aperto ("A"), e non c'è nessun tecnico collegato, verrà forzato " "
ACIT-ASS-DATA
ACIT-ASS-ORA
ACIT-ASS-ORA-FINE
RCIT-ASS-DATA
RCIT-ASS-ORA
RCIT-ASS-ORA-FINE
(se c'è il tecnico assegnato)
ACIT-TARGA RCIT-TARGA
ACIT-FL-SPOSTABILE RCIT-FL-SPOSTABILE
ACIT-NOTE RCIT-NOTE
ACIT-FL-BOL "N"
ACIT-TECNICO (1) Tecnico assegnato 1
.... ...
ACIT-TECNICO (10) Tecnico assegnato 10
ACIT-TIPO-ATT Verrà valorizzato come "A" (attività) o "G" (agenda) a seconda della configurazione e della durata dell'appuntamento
ACIT-IMPORTO-CONCORDATO RCIT-IMPORTO-CONCORDATO (doppio)
ACIT-DST RCIT-DST (doppio)
ACIT-MAG RCIT-MAG-DEFAULT (doppio)

A.4.2.1 Aggiornamento ASNINTE2: Vedi anche Acquisizione dati veicolo e magazzino tecnico

ACIT2-MAG-TIP RCIT2-MAG-TIP
ACIT2-MAG-SEC RCIT2-MAG-SEC
ACIT2-DATA-RILASCIO RCIT2-DATA-RIL-PROD
ACIT2-ORA-RILASCIO RCIT2-ORA-RIL-PROD
ACIT2-FL-RESIDENZIALE RCIT2-FL-RESIDENZIALE
ACIT2-IMPORTO-PAGATO ARPINTADD.INTADD-IMPORTO-PAGATO

A.4.3 Aggiornamento ASNCHPRP: Scorrere tutti i record di ARPCHPRP collegati alla chiamata; importare il contenuto su ARPCHPRP:

Nome campo Contenuto
ACHP-ID-CHIAMATA RCHP-ID
ACHP-PROG RCHP-PROG
ACHP-MERCE RCHP-MERCE
ACHP-QTA RCHP-QTA
ACHP-IMPORTANZA RCHP-IMPORTANZA
ACHP-ESE-DATA RCHP-ESE-DATA
ACHP-ESE-TECNICO RCHP-ESE-TECNICO
ACHP-FL-VAL RCHP-FL-VAL
ACHP-FL-CONTENITORE RCHP-FL-CONTENITORE
ACHP-FL-ESPOSTA RCHP-FL-VISIBILE

A.4.4 Aggiornamento agenda: Se è presente una configurazione specifica, verrà inserita una attività nell'agenda dell'operatore tramite ASNS78 Successivamente, verrà anche aggiornata l'attività CRM collegata A.4.5 Creazione dossier: Se la configurazione generazione-dossier vale "S", eseguire una chiamata a CRMS10 per la creazione del dossier chiamata

Dato Contenuto
CRMS10-OPE "SCRIVI"
CRMS10-ANA Il cliente assistito collegato alla chiamata


CRMS10-TDO tipo-dossier-chiamata
CRMS10-ID prefisso-id-dossier + ACHT-ID (vedi ASN110)
CRMS10-DES "Chiamata n. " + ACHT-ID
CRMS10-DATA-APE Data chiamata

All'uscita, memorizzare il riferimento del dossier sulla chiamata

Dato Contenuto
ACHT-DOSSIER CRMS10-DSR-CHIA1

A.4.6 Creazione nuova chiamata "Z": A seguito dell'assegnazione di una chiamata "Z" (che diventa una chiamata reale), in questa fase verrà creata una nuova chiamata "Z". A.5 Acquisizione altre informazioni * Note tecnico -> su ASNINDAG Durante l'acquisizione di un intervento prechiuso, importare alcuni nuovi campi note dall'intervento, che saranno memorizzati su 5 nuovi record su ASNINDAG, solo quando sono significativi. Su questi nuovi record AITD-TIPO dovrà essere: * "E": ARPINTES.RCIT-COMMENTO-RISOLUTIVO * "A": APPINTES.A-RCIT-MSG-COMMERCIALE * "B": APPINTES.A-RCIT-MSG-ADMIN * "C": APPINTES.A-RCIT-MSG-UFF-TEC * "D": APPINTES.A-RCIT-MSG-UFF-ACQ * "G": ARPINTES2.RCIT2-PROBLEMI A.5.1 Acquisizione ASNAPPPR: Questa tabella contiene le prestazioni inserite dal tecnico dalla APP (è una tabella di appoggio che verrà analizzata in fase di chiusura chiamata quando si elabora una chiamata "pre-chiusa da APP") Verrà importata da ARPINDET In questa fase, se ACID-DESCRIZIONE è significativa si dovrà importare su un apposito record di ASNINDED A.5.2 Acquisizione ASNAPPMT: Questa tabella contiene i materiali inseriti dal tecnico dalla APP (è una tabella di appoggio che verrà analizzata in fase di chiusura chiamata quando si elabora una chiamata "pre-chiusa da APP" Verrà importata da ARPINMAT In questa fase, se ACIM-DESCRIZIONE è significativa si dovrà importare su un apposito record di ASNINDED A.5.3 Acquisizione ASNCHDET: Matricole collegate alla chiamata: è corretto che vengano sempre acquisite? Non dovrebbe essere solo quando acquisisco una chiamata "Z"? Verrà importata da ARPCHDET A.5.4 Acquisizione ASNINTMP: Questa tabella contiene il dettaglio tempi di lavorazione inseriti dal tecnico, se previsto. Verrà importata da ARPINTMP A.5.5 Acquisizione ASNINDIF: Questa tabella contiene il dettaglio difetti/soluzioni per matricola inseriti dal tecnico, se previsto. Verrà importata da ARPINDIF Durante l'importazione, verificare l'esistenza dei codici difetto e soluzione: se non esiste, eseguire l'acquisizione: A.5.5.1 Ricerca e acquisizione difetto Cercare su ASNTPDIF l'esistenza del difetto presente in ACII-DIFETTO; se non esiste. leggere il corrispondente codice difetto su ARPTPDIF e inserirlo su ASNTPDIF:

Nome campo Contenuto
ATPD-COD A-ATPD-COD
ATPD-DES A-ATPD-DES
ATPD-STAMPA-DOC "N"
ATPD-TIP-MAT A-ATPD-TIP-MAT
ATPD-NOME-DOC " "

A.5.5.2 Ricerca e acquisizione soluzione Cercare su ASNTPDSL l'esistenza del difetto presente in ACII-SOLUZIONE; se non esiste. leggere il corrispondente codice difetto su ARPTPDSL e inserirlo su ASNTPDSL:

Nome campo Contenuto
ATPS-DIFETTO A-ATPS-DIFETTO
ATPS-SOLUZIONE A-ATPS-SOLUZIONE
ATPS-DES A-ATPS-DES

A.6 Aggiornamenti ARPINTES:

Nome campo Contenuto
RCIT-FL-ACQUISITA "S"
RCIT-FL-ASSEGNATA "X"
(solo se sto acquisendo una chiamata creata su APP)
RCIT-DST ACIT-DST (a cosa serve?)
RCIT-FL-STA-RAP "N"
Solo se è una chiamata di consegna e non sono stati trovati materiali
Serve per impedire la spedizione del rapportino in questo caso

A.7 Preparazione moduli e spedizione A.7.1 Download immagini: Tramite FTP si esegue lo scaricamento dei files necessari per la stampa del rapportino; in sintesi verrà scaricato: * Un file "pilota" che indica quali altri files devono essere scaricati * Un file di firma * Eventuali allegati In questa fase viene anche eseguita la preparazione e archiviazione della stampa del rapportino, attraverso: 1. Chiamata a ASN060W per la produzione della stampa dal modello 2. Se la modalità di elaborazione è diretta, a questo punto avremo direttamente il PDF; altrimenti si esegue una chiamata a SVIEW per la conversione del file PCL generato in PDF 3. Archiviazione del file PDF tramite COGU06 Importazione galleria immagini su un server ftp, in una cartella che dovrà essere definita, esiste una struttura fatta in questo modo:: cartella/codice azienda/codice intervento ad esempio: cartella/C01692/178901 In questa cartella ci sarà un file di testo, ad esempio: 178901.txt composto in questo modo:

Nome immagine Descrizione
178901.pdf Modulo intervento
178901_001.jpg Immagine guasto
.... ..

Quindi leggere il file e per ogni riga importare il relativo file nella galleria della chiamata Tra i files importati ci sarà anche un file contenente la firma dell'utente in formato JPG, deve essere archiviato e usato nella fase successiva. NB: memorizzare il file in modo che sia distinguibile da eventuali altri firme in caso di + interventi sulla chiamata (ad esempio, memorizzare come "FIRMA INT:178901") A.7.1.1 - Scrittura collegamento su ARPCHIMG Per ciascuna immagine archiviata in galleria, leggere il record COGIMAGE che è stato appena creato da COGU06, usando IMG-CHIA2 e impostando: * IMG-TIP-DOC = "A2" * IMG-DC-A2-KEY = RCIT-ID-CHIAMATA * IMG-DC-A2-TIP = "IM" * IMG-DC-A2-PROG=progressivo inserito * Per ciascun record leggere il corrispondente record COGARIDX su ARX-CHIA2, impostando: * ARX-PROTOCOLLO = IMG-PROTOCOLLO * A questo punto siamo posizionati su un allegato dell'attività; vediamo se sulla tabella web esiste ed è aggiornato: * Lettura di ARPCHIMG impostando

Dato Descrizione
RCHIMG-AZI Codice azienda
RCHIMG-ID ID chiamata
RCHIMG-PROG Progressivo di immagine nella galleria (IMG-DC-A2-PROG)

Il record non dovrebbe esistere: se lo fosse sovrascriverlo aggiornando i dati qui sotto evidenziati in grassetto, altrimenti scrivere il record

Nome campo Note
RCHIMG-AZI Codice azienda
RCHIMG-ID RCIT-ID-CHIAMATA
RCHIMG-PROG Progressivo di immagine nella galleria (IMG-DC-A2-PROG)
RCHIMG-DES IMG-OGGETTO
RCHIMG-NOME Il nome del file appena archiviato
RCHIMG-AREA-AGG-DATA ARX-DA-DATA
RCHIMG-AREA-AGG-ORA ARX-DA-TIME
RCHIMG-AREA-FL-AGG "S"

Stampa intervento A seconda del contenuto della configurazione modo-stampa-intervento, la stampa potrà essere fatta nei seguenti modi: Stampa standard (configurazione = "S") Si dovrà eseguire la stampa dell'intervento in formato WORD, usando l'apposita stampante configurata con cui generare il file in formato PCL: "stampe"-"periferica-stampa-file" Il modello da stampare dovrà essere acquisito lanciando COGPA3 con l'opzione "COGPA3-USA-DEFAULT" = "S", in modo che scelga sempre il primo tra i modelli disponibili (si dovrà comunque passare anche il cliente assistito o il cliente di fatturazione, da vedere) Dopodichè la stampa dovrà essere processata per la produzione di un file PDF, che dovrà essere inviato via ftp al server WEB. Stampa diretta (configurazione = "D") Come nel caso precedente ma con le seguenti modifiche: * Si dovrà eseguire la stampa dell'intervento in formato WORD; in questo caso però passare un apposito parametro ad ASN060W in modo che questo passi a WORDMDL non la richiesta della stampa su una periferica configurata, ma il parametro WORDMDL-SAVE-AS con indicato il nome del file pdf da creare. * Dopo l'esecuzione di ASN060W, bypassare la chiamata a SVIEW perchè non più necessaria A.7.2 Preparazione certificato: Se la chiamata prevede la certificazione, verrà eseguito un processo per la stampa, archiviazione e spedizione del modello di certificazione configurato. 1. Chiamata a ASN598 per la produzione della stampa/stampe dal modello 2. Il programma produrrà un file sequenziale chiamato "asn598_certificati.txt" che contiene l'elenco dei files prodotti. A seconda della modalità di stampa modo-stampa-intervento: 1. "S" (stampa diretta: creazione di un file prn e successiva trasformazione in PDF): ogni file dell'elenco sarà trasformato in PDF con una chiamata ad SVIEW 2. "D": (stampa diretta: la versione di Word installata consente l'esportazione diretta di un file PDF): ogni file dell'elenco sarà già in formato PDF 3. Archiviazione di ciascun file PDF risultante dall'elenco tramite COGU06 A.7.3 upload dei documenti prodotti: 1. Se la produzione del rapportino è andata a buon fine, upload attraverso FTP 2. Se la produzione del certificato è andata a buon fine, upload attraverso FTP A.7.4 Aggiornamento ARPINTES: Se l'invio dei modelli è avvenuto correttamente, dovrà essere aggiornato il flag RCIT-FL-STAMPA-PDF = "S". In caso contrario, se sono avvenuti errori, verrà aggiornato a "E" -> Questo permetterà la spedizione al cliente di un rapporto di errore. A.8 Prossima chiamata programmata Al termine dell'importazione di un intervento eseguito, se la chiamata: * è collegata a contratto * è una chiamata programmata (ACHT-PROVENIENZA = chiamate-programmate-provenienza) * il modo-programmazione vale "B", allora si dovrà eseguire la creazione della prossima chiamata programmata, con una chiamata a ASN053:

Dato Contenuto
ASN053-CONTRATTO Codice contratto da elaborare
ASN053-OPERAZIONE "CREA-PROSSIMA"
ASN053-INTERVENTO Id intervento eseguito

E' possibile che questa operazione non avvenga, ad esempio se abbiamo già raggiunto il numero di chiamate previste. In questo caso sarà restituito comunque esito e messaggio. Quindi, se l'esito è: * Positivo: segnalare nel file di log il numero di chiamata generata * Negativo: segnalare l'errore nel file di log con il messaggio relativo

B - Ricerca e importazione interventi creati su APP ma non eseguiti

B - Ricerca e importazione interventi creati su APP ma non eseguiti Nel punto "A" vengono acquisite tutte le chiamate eseguite, anche se sono state create appena prima tramite la chiamata "Z". Ora il programma esamina se esistono invece chiamate create da APP, ma solo assegnate (o non assegnate) e non eseguite. Query su ARPINTES, per cercare gli interventi eseguiti; devono avere: * RCIT-STATO = "Z" * RCIT-FL-ASSEGNATA = "S" * RCIT-FL-ESEGUITA <> "S" Operazioni preliminari Per ciascun intervento vengono effettuati i controlli descritti in O perazioni comuni preliminari B.1 Aggiornamento ASNINTES:

Nome campo Contenuto
ACIT-STATO "A"
ACIT-TIPO-INTERVENTO RCIT-TIPO-INTERVENTO
ACIT-DST-ID-TIP RCIT-DST-ID-TIP
ACIT-DST-ID-IDX RCIT-DST-ID-IDX

B.2 Aggiornamento ASNCHTES: La routine di aggiornamento al momento e' in comune con quella eseguita per il punto A - Ricerca e importazione interventi eseguiti su APP, ma in questo caso (stiamo creando una nuova chiamata) occorre fare una ricerca aggiuntiva dei riferimenti anagrafici per la chiamata: Se la configurazione commessa-impianto vale "S", e se sulla chiamata sono state agganciate delle matricole (ARPCHDET), cercare l'esistenza di una commessa con il codice identico al s/n della matricola (con questa configurazione deve esistere). Poi impostare i dati

Nome campo Contenuto
ACHT-CLI-FAT-COD TSC-ANA-COD
ACHT-CLI-ASS-COD TSCA-CLI-ASS
Se non significativo, e' ancora TSC-ANA-COD
ACHT-DST TSCA-DST
ACHT-FL-STA-RAP RCIT-FL-STA-RAP
ACHT-FL-STA-CERT RCIT-FL-STA-CERT
ACHT-AVVISA-CLIENTE avviso-default
ACHT-GRP-AZ-ESE RCIT2-GRP-AZ-ESE
ACHT-GRP-AZ-APP RCIT2-GRP-AZ-APP
ACHT-FL-FAT Come nel caso di inserimento chiamata standard, la valorizzazione di questo parametro dipende dalle configurazioni:
default-da-fatturare
flag-da-non-fatturare
e dalla presenza del flag "Benestare" sul cliente di fatturazione
ACHT-DST-ID-TIP RCIT-DST-ID-TIP
ACHT-DST-ID-IDX RCIT-DST-ID-IDX
ACHT-CNT-TIP RCIT2-CNT-TIP
ACHT-CNT-COD RCIT2-CNT-COD

B.2.1 invio avviso al cliente In questo caso (inserimento nuova chiamata) se previsto dalla configurazione avviso-ins-chiamata eseguire una chiamata a ASNS05 - Invio messaggio da chiamata/intervento :

Dato Formato Contenuto
ASNS05-CALLER x(08) Programma chiamante
ASNS05-ID-CHIAMATA 9(12) Id chiamata inserita
ASNS05-OPE x(20) "INVIO-CHIAMATA"

Questa operazione dovrebbe inviare una mail al cliente, quando previsto B.3 Aggiornamento chiamata "Z": B.3.1 Parsing informazioni note Come prima cosa, eseguire eseguire il parsing delle informazioni che possono essere contenute nel campo note ricevuto in input. Si dovrà eseguire la ricerca delle informazioni configurate in COGPARSE riguardanti la classe documento "01": quindi per ciascuna delle informazioni previste (si potrà eseguire un semplice loop) si dovrà eseguire una chiamata a COGUA6 - Parsing informazione su testo, passando:

Tipo Dato Contenuto
INPUT COGUA6-OPE "CERCA-INFO"
COGUA6-CLASSE "01"
COGUA6-COD Codice informazione da elaborare
COGUA6-SIZE-TESTO Dimensione campo RCIT-CHIAMATA-DES
COGUA6-TESTO RCIT-CHIAMATA-DES

Se l'informazione viene trovata (COGUA6-ESITO = "S"), eseguire il trattamento specifico dell'informazione trovata.

PARS-COD Descrizione Note
1 Cliente assistito Il dato trovato dovrà essere un codice cliente esistente nell'anagrafica clienti, e sostituirà il cliente assistito con cui viene ricevuta la chiamata
2 S/N matricola Il dato trovato corrisponderà ad un s/n di una matricola codificata nel sistema, e appartenente al cliente assistito
3 Ragione sociale cliente assistito Il dato trovato potrà essere la ragione sociale del cliente assistito.
Verrà utilizzata nel caso in cui sia prevista la creazione automatica del cliente assistito (Vedi oltre)
4 Indirizzo cliente assistito Il dato trovato potrà essere l'indirizzo del cliente assisisto.
Verrà utilizzata nel caso in cui sia prevista la creazione automatica del cliente assistito (Vedi oltre)
Il contenuto di questa informazione dipende dalla configurazione formato-indirizzo
5 Telefono cliente assistito Il dato trovato potrà essere il numero di telefono del cliente assisisto.
Verrà utilizzata nel caso in cui sia prevista la creazione automatica del cliente assistito (Vedi oltre)
6 Numero chiamata cliente Il dato trovato verrà acquisito come Numero chiamata cliente (o codice richiesta)
Non verranno effettuati controlli sulla duplicazione o esistenza di una chiamata avente lo stesso riferimento.
7 Numero intervento cliente Il dato trovato verrà acquisito come Numero intervento cliente (o codice richiesta)
Non verranno effettuati controlli sulla duplicazione o esistenza di una chiamata avente lo stesso riferimento.
8 Oggetto chiamata Il dato trovato verrà acquisito come Oggetto sulla chiamata.
9 Id destinazione Se viene ricevuto uno di questi 3 campi, sarà utilizzato per la ricerca della destinazione diversa a cui abbinare la chiamata.
La ricerca verrà effettuata in base all'ordine di questi 3 campi: quindi se ad esempio è presente il tag "Id destinazione", sarà cercato solo questo
Se invece nessuno dei 3 campi è presenti, o comunque non viene trovata nessuna corrispondenza, la destinazione non sarà agganciata
10 Immobile (Skype)
11 Edificio (Fax)
12 Data/ora inserimento chiamata All'interno di questo tag il programma si aspetta di trovare almeno la data, e opzionalmente anche l'ora di inserimento della chiamata. Se non presenti, saranno usati data/ora sistema.
Se presente il programma applicherà le seguenti regole:



13 Data/ora scadenza chiamata All'interno di questo tag il programma si aspetta di trovare almeno la data, e opzionalmente anche l'ora di scadenza della chiamata. Se non presenti, saranno lasciati vuoti.
Se presente il programma applicherà le seguenti regole:



B.3.1.1 Creazione nuovo cliente assistito Se la configurazione creazione-cliente-assistito vale "S", dovranno essere cercate nel testo anche le informazioni 3,4,5 (in caso contrario non è necessario effettuare la ricerca). Quindi potrebbero avere le seguenti situazioni:

Codice 1
(Codice cliente assistito)
Codice 3
(Ragione sociale)
Codice 4
(Indirizzo)
Comportamento
Indicato / / In questo caso il sistema si comporta come nel caso in cui la creazione cliente assistito non fosse configurata: il cliente indicato deve esistere
Non indicato Indicato Indicato Il cliente assistito viene cercato attraverso la ragione sociale, che deve esistere ed essere identica al contenuto dell'informazione "Codice 3". Se trovata, deve essere confrontato anche l'indirizzo. Se:


In caso di creazione nuovo cliente, l'informazione 4 (indirizzo), in base al contenuto di formato-indirizzo potrà essere composta da sottocampi; quindi dovranno essere separati in base al separatore configurato. Se il cliente assistito viene trovato tramite la ragione sociale, usare quello, altrimenti si dovrà creare con una chiamata alla funzione "INSANA" (vedi SWA030) usando i dati a disposizione. Quindi usare il cliente inserito come cliente assistito. B.3.1.2 Ricerca destinazione diversa Se l'analisi dei tag 9,10,11 restituisce almeno un valore, effettuare la ricerca della presenza della destinazione diversa sul cliente (di fatturazione o assistito a seconda di quanto trovato in precedenza). La ricerca va fatta esattamente in questo ordine; quindi: 1. Ricerca informazione 9 (k-cp-chiamate-dst-id); se contiene un valore, effettuare la ricerca tra le destinazioni sul campo COGDEST2.DST2-ID-DESTINAZIONE 2. Ricerca informazione 10 (k-cp-chiamate-dst-skype); se contiene un valore, effettuare la ricerca tra le destinazioni sul campo COGDEST2.DST2-SKYPE 3. Ricerca informazione 11 (k-cp-chiamate-dst-fax); se contiene un valore, effettuare la ricerca tra le destinazioni sul campo COGDEST2.DST2-FAX Alla prima ricerca positiva ci si ferma e non è necessario proseguire con le rimanenti. Se nessuna ricerca restituisce un campo significativo, o se nessuno di questi risulta essere presente in una destinazione, questa rimane vuota. B.3.1.3 Campi "Data e ora" I campi 12 e 13 corrispondono a data e/o ora. Se significativo, almeno la data dovrebbe essere presente. Per una efficace ricerca in uno di questi campi, se significativi, seguire queste regole: * L'orario se presente sarà separato da " " dalla data * Una volta isolati i campi "data" e "ora": * Normalizzare la data usando COGS52W con operazione "Accept-E" * Normalizzare l'ora, se presente, usando COGS93W con operazione "Accept-E" B.3.2 Elaborazione Verranno eseguiti gli aggiornamenti come ai punti: * A.4.1 * A.4.2 * Se l'intervento in questa fase risulta "non assegnato" (ACIT-TECNICO (1) = 0) si dovrà cercare un tecnico da preassegnare con una chiamata a ASNS19:

Dato Contenuto
ASNS19-OPE "CERCA"
ASNS19-CLIENTE Cliente assistito collegato alla chiamata
ASNS19-DST Destinazione collegata alla chiamata
ASNS19-ID-MATRICOLA Matricola collegata alla chiamata

Assegnare il tecnico restituito all'intervento In questo caso scattano gli automatismi su veicolo/magazzino come spiegato in Acquisizione dati veicolo e magazzino tecnico * A.4.3 * A.4.4 * A.4.5 B.4 Acquisizione altre informazioni Verranno eseguiti gli aggiornamenti come al punto A.5 - Acquisizione altre informazioni B.5 Aggiornamento ARPINTES:

Nome campo Contenuto
RCIT-FL-ASSEGNATA "X"
RCIT-DST ACIT-DST (a cosa serve?)
RCIT-FL-STA-RAP "N"
Solo se è una chiamata di consegna e non sono stati trovati materiali
Serve per impedire la spedizione del rapportino in questo caso

Estratto da documentazione interna ClickUp