Domanda
Come funziona la lettura rendicontazione incassi in modalità schedulata e di quale configurazione necessita?
Risposta
La funzionalità di lettura rendicontazione incassi schedulata permette di acquisire uno o più file presenti su una risorsa sorgente remota (esempio path remoto, server FTP o server SAMBA), caricandone gli incassi ivi contenuti nel sistema Esse3 e storicizzandoli su una diversa risorsa destinazione remota.
Per lanciare la funzionalità in modalità schedulata dalla funzione "Lettura rendicontazione incassi" è necessario selezionare un layout file incassi che abbia configurato il contesto sorgente (di default si chiama REND_MAV_SORGENTE) e il contesto storico (di default si chiama REND_MAV_STORICO) e pianificare l'elaborazione giornalmente, settimanalmente, mensilmente o una volta sola posticipando data inizio e/o ora inizio: in tal modo non viene richiesta l'indicazione del file da acquisire, ma la procedura andrà ad elaborare i file presenti sulla risorsa remota sorgente utilizzando il servizio "FILE MANAGER".
La configurazione necessaria al trasferimento dei file in download (da risorsa sorgente) e in upload (per la storicizzazione) è definita rispettivamente nei contesti REND_MAV_SORGENTE e REND_MAV_STORICO (o nei contesti sorgente e storico collegati al layout file incassi che si sta utilizzando).
Nel contesto specifico di REND_MAV_SORGENTE sono utilizzati i seguenti parametri:
- FILE_MANAGER_TYPE (obbligatorio) rappresenta il tipo di file manager (esempio "FTP", "FTPS", "SMB", "FILE");
- FILE_NAME (obbligatorio in questo contesto) indica il nome del file (o espressione regolare) su cui operare (esempio *.* oppure *.txt oppure pippo.txt);
- REMOTE_PATH (obbligatorio in questo contesto) indica il percorso sul sistema remoto da cui prelevare i file (separatore di cartelle la barra sopra il 7 = "/"; in caso di trasferimento di tipo FILE il percorso deve essere preceduto da "//");
- LOCAL_PATH (obbligatorio in questo contesto) indica il path locale di download sul sistema locale (cartella temporanea utilizzata dall'application server per l'elaborazione, separatore di cartelle il backslash "\");
- FTP_PROVIDER_URL (obbligatorio se FILE_MANAGER_TYPE=FTP o FILE_MANAGER_TYPE=FTPS, attenzione: nel caso di server ftps esplicitare la porta scrivendo host:port, esempio ftps.u-gov.it:21 ) indica il server FTP/FTPS da cui viene eseguito il download in locale;
- FTP_USER (obbligatorio se FILE_MANAGER_TYPE=FTP o FILE_MANAGER_TYPE=FTPS) indica l'utente con cui connetteri al server FTP/FTPS;
- FTP_USER_PWD (obbligatorio se FILE_MANAGER_TYPE=FTP o FILE_MANAGER_TYPE=FTPS) indica la password con cui connetteri al server FTP/FTPS;
- FTP_MODE (valido se FILE_MANAGER_TYPE=FTP o FILE_MANAGER_TYPE=FTPS, facoltativo) indica il tipo canale dati attivo/passivo: se non specificato è passivo;
- SMB_HOSTNAME (obbligatorio se FILE_MANAGER_TYPE=SMB) indica l'indirizzo IP del server SAMBA;
- SMB_USER (valido se FILE_MANAGER_TYPE=SMB) indica l'utente con cui connetteri al server SAMBA;
- SMB_USER_PWD (valido se FILE_MANAGER_TYPE=SMB) indica la password con cui connetteri al server SAMBA;
- SMB_PORT (valido se FILE_MANAGER_TYPE=SMB) indica la porta del server SAMBA da cui viene eseguito il download in locale;
- SMB_DOMAIN (valido se FILE_MANAGER_TYPE=SMB) indica l'eventuale dominio dell'utente con cui connetteri al server SAMBA.
Nel contesto specifico di REND_MAV_STORICO sono utilizzati i seguenti parametri di contesto:
- FILE_MANAGER_TYPE (obbligatorio) rappresenta il tipo di file manager (esempio "FTP", "FTPS", "SMB");
- REMOTE_PATH (obbligatorio in questo contesto) indica il percorso sul sistema remoto su cui eseguire l'upload dei file elaborati con successo, oltre che dei file di controllo (separatore di cartelle la barra sopra il 7 = "/");
- FTP_PROVIDER_URL (obbligatorio se FILE_MANAGER_TYPE=FTP o FILE_MANAGER_TYPE=FTPS) indica il server FTP/FTPS su cui viene eseguito l'upload;
- FTP_USER (obbligatorio se FILE_MANAGER_TYPE=FTP o FILE_MANAGER_TYPE=FTPS) indica l'utente con cui connetteri al server FTP/FTPS;
- FTP_USER_PWD (obbligatorio se FILE_MANAGER_TYPE=FTP o FILE_MANAGER_TYPE=FTPS) indica la password con cui connetteri al server FTP/FTPS;
- FTP_MODE (valido se FILE_MANAGER_TYPE=FTP o FILE_MANAGER_TYPE=FTPS, facoltativo) indica il tipo canale dati attivo/passivo: se non specificato è passivo;
- SMB_HOSTNAME (obbligatorio se FILE_MANAGER_TYPE=SMB) indica l'indirizzo IP del server SAMBA;
- SMB_USER (valido se FILE_MANAGER_TYPE=SMB) indica l'utente con cui connetteri al server SAMBA;
- SMB_USER_PWD (valido se FILE_MANAGER_TYPE=SMB) indica la password con cui connetteri al server SAMBA;
- SMB_PORT (valido se FILE_MANAGER_TYPE=SMB) indica la porta del server SAMBA;
- SMB_DOMAIN (valido se FILE_MANAGER_TYPE=SMB) indica l'eventuale dominio dell'utente con cui connetteri al server SAMBA su cui viene eseguito l'upload.
Per ulteriori dettagli relativi alla funzionalità del trasferimento file e al significato/uso dei parametri di contesto si faccia riferimento alla documentazione relativa al servizio "FILE MANAGER".
I file elaborati con errore dalla lettura rendicontazione incassi non vengono scaricati sul percorso remoto di storicizzazione, ma vengono lasciati nella cartella sorgente per una successiva elaborazione; i file elaborati con successo (eliminati automaticamente in fase di download) vengono storicizzati assieme ai relativi file di controllo (che servono per verificare che i file non siano stati manipolati).
Processo
- Incassi
- tutti