Wizard Home | Reports (Admin)

Cod. Ultima revisione Wiki Note
732 2019/03/15 - MA /syncro/reports

Permette di automatizzare il caricamento dei reports

Caratteristica


Per facilitare la gestione della reportistica in modo da utilizzare un caricamento Massivo anziché manuale da interfaccia Web è stata studiata una logica basata sull'utilizzo di alcune convenzioni riguardo ai nomi dei files che possono così essere caricati via FTP all’interno della cartella “repository” ( vedi Guida API - Sezione FTP ). e tramite l'automatizzazione nel processo di importazione essi vengono associati a cartelle specifiche a cui gli agenti/utenti hanno accesso .

Per la definizione di tali file convenzionati entrano  in gioco i campi   Pattern e Frequency nella creazione delle cartelle (come spiegato nella gestione manuale dei Report).

Spieghiamo il processo di creazione del pattern e frequency corretti con un esempio
 
a) Creare una cartella

Creare una nuova cartella premendo in corrispondenza del pulsante " Create new folder" il sistema richiede l'inserimento di :

- Label : Rappresenta il nome della cartella che vedrà poi l'agente nel modulo Reports in app
- Description : Si tratta di una riga descrittiva che in apparirà sotto al nome della cartella
- Pattern : Serve per definire la codifica del file, il campo è fondamentale per l'automazione del caricamento dei reports

Esempio :

Supponiamo che dal gestionale si voglia produrre mensilmente un rapportino relativo al  il fatturato generato dell'agente, quindi possiamo creare innanzitutto la cartella "madre" relativa all'agente

- Label : AGENTE MARIO ROSSI
- Description : DOCUMENTI RELATIVI ALL'AGENTE MARIO ROSSI
- Pattern : mario_rossi

Attenzione Il pattern deve SEMPRE essere indicato

In corrispondenza della cartella "AGENTE MARIO ROSSI" cliccando su "View Group" sarà possibile creare la sottocartella "FATTURATO"

 



Una volta all'interno della cartella "AGENTE MARIO ROSSI" cliccare su "Create new folder" per creare la sottocartella.

Esempio:

- Label : FATTURATO
- Description : FATTURATO AGENTE MARIO ROSSI
- Pattern : FATTURATO
- Frequency : yyyymm (Rappresenta il formato con il quale dovrà essere indicata la “data di pertinenza” del file ( yyyymm ad esempio identifica una formattazione di tipo 201202 , 201203, 201811 per indicare Febbraio 2012, Marzo 2012, Novembre 2018)

Attenzione Il valore frequency deve SEMPRE essere indicato

A questo punto si è creato il pattern che dovrà avere il nome del file per essere prelevato da FTP e associato alla cartella 

In pratica alla cartella appena creata verranno associati se presenti i file che hanno nome 

mario_rossi_FATTURATO_yyyymm

Es: 

mario_rossi_FATTURATO_201202.pdf
mario_rossi_FATTURATO_201202.xls
mario_rossi_FATTURATO_201203.xls
mario_rossi_FATTURATO_201811.pdf

ma non 

paolo_bianchi_FATTURATO_201811.pdf
mario_rossi_FATTURE_201811.pdf


Una volta creato il percorso delle cartelle sarà possibile caricare i file in FTP all’interno della cartella “repository” ( vedi Guida API - Sezione FTP ) serve poi  avviare un elaborazione server e il sistema aggancerà in automatico i file in base alle corrispondenze definite nell'area Report.  


In questo caso se all'interno dell'Ftp verrà caricato un file nominato " mario_rossi_FATTURATO_201903" in automatico il file verrà reso disponibile all'agente in quella cartella

In conclusione: Per essere inserito automaticamente dal sistema all’interno di uno specifico gruppo, il file deve possedere quindi un nome contenente informazioni riguardanti la sua collocazione nell'albero a cartelle definito da interfaccia web.

Limite numero file e manutenzione


Essendo il sistema automatizzato può risultare importante far pulizia di file caricati in elaborazioni precedenti  e ormai divenuti obsoleti al fine di non appesantire troppo il volume di file presenti nei device 

E' possibile inoltre utilizzare il campo Limit  per limitare il numero di file che verranno mantenuti  disponibili all'agente per la cartella specifica . Ad esempio 

- Limit : 12 (limita a 12 il numero di documenti  presenti )  in questo caso l'agente vedrà solo i gli ultimi 12 documenti caricati in ordine temporale )
In riferimento all'esempio sopra supponendo di aver reso disponibile nella cartella  mario_rossi/FATTURATO un file ogni mese e oggi sia Marzo 2018 il sistema cancellerà tutti i file precedenti al file mario_rossi_FATTURATO_201703