FTP2 - Trasferimento documenti_2¶
Posizione nel menu Programma non a menu Linkage section
| Tipo | Dato | Formato | Contenuto |
|---|---|---|---|
| INPUT | FTP2-CALLER | x(10) | |
| FTP2-CALLED | x(10) | ||
| FTP2-SERVER | x(10) | codice suddivisione della configurazione "ftp" su cui trovo se = "@CFILELIST" - > forza un comando tipo curl client se = "@UFILELIST" - > forza un comando tipo curl server e la destinazione folder Š la tmp-dir ed i parametri di url vengono presi dalla filelist i parametri del server |
|
| FTP2-OPE | x(15) | codice operazione richiesta: * Upload * Download * CleanupLocal * CleanupRemote * CheckServer = check della presenza di un codice server |
|
| FTP2-LOG-OPE | x(01) | Registrazione log delle attività? S/N | |
| FTP2-SOURCE-FOLDER | x(01) | cartella sorgente: * per upload e download Š da dove prelevo i files * per cleanup Š la cartella dove cancello |
|
| FTP2-SOURCE-FILE-LIST | x(2000) | elenco di files separati da CR+LF, se l'elenco Š "@FTPTRANS:..." * dove ...= full path di un file di transito ftptrans usa quello * per alimentare il file |
|
| FTP2-DESTINATION-FOLDER | x(256) | Cartella di destinazione | |
| FTP2-DESTINATION-FILE-LIST | x(2000) | elenco di files separati da CR+LF, se l'elenco Š "@FTPTRANS:..." * dove ...= full path di un file di transito ftptrans usa quello * per alimentare il file |
|
| OUTPUT | FTP2-ESITO | x(01) | esito operazione * "S"= Ok * "N"= Non ok |
| FTP2-CLOCK-MSG | x(01) | clock msg? * "S"= Ok (default) * "N"= No |
|
| FILLER | x(199) |
Logica generale Utility che centralizza le attività di trasferimento files tra un contesto locale e uno remoto, o viceversa. Inizialmente progettato per usare solo il protocollo FTP, verrà integrato con la modalità di trasferimento attraverso AWS S3 Configurazioni
| Gruppo | Parametro | Note |
|---|---|---|
| ftp | indirizzo-server-ftp | Parametri necessari in caso di uso FTP (quando AWS non è attivo) |
| ftp | utente-ftp | |
| ftp | pwd-ftp | |
| ftp | path-bat-ftp | |
| ftp | dest-folder-ftp |
Maschera del programma Nessuna maschera. Elaborazione L'elaborazione cambia a seconda dell'operazione richiesta. Configurazione WINSCP Per avere un esame corretto dell'esito xml del comando occorre che nella cartella superiore a dove viene genrata la .bat di comando siano presenti:
Operazione: CONFIGURA-AWS_2¶
Descrizione Questa operazione, sebbene pubblica, non necessita di essere invocata da un programa chiamante Viene effettuata la lettura su AWSPROFILE del record di configurazione, e se risulta attivo, acquisisce le configurazioni relative, ed esegue lo script di creazione del file di configurazione necessario all'applicazione AWS CLI Chiamata standard
| Dato | Formato | Contenuto |
|---|---|---|
| FTP-CALLER | x(10) | Nome programma chiamante |
| FTP-CALLED | x(10) | "FTP" |
| FTP-OPE | x(15) | "CONFIGURA-AWS" |
| FTP-ESITO | x(01) | Verrà restituito "S" se l'operazione è riuscita (anche se risulta non configurato) |
Elaborazione - AWS Configurazione Si esegue una chiamata a AWSCFG - Importazione configurazioni AWS:
| Dato | Contenuto |
|---|---|
| AWSCFG-OPE | IMPORTA-CFG |
Se AWSCFG-ESITO = 'S', si assume che la configurazione sia stata eseguita con successo. Verifica Si rileggono le configurazioni, e se risulta che l'ambiente AWS è attivo, si tenta di recuperare un file "pilota" dalla radice del bucket assegnato al profilo. Il file si chiamerà "hereiam.txt". Quindi, si dovrà invocare l'operazione di download di questo file dalla radice del bucket con il seguente comando: $ aws s3 cp s3://aws_bucket_name/path/hereiam.txt $ext-tmp-dir$/hereiam.txt --profile aws_profile_name Al termine del comando dovrà esistere il suddetto file nella cartella "EXT-TMP-DIR"; è sufficiente la sua esistenza per essere certi che il comando sia andato a buon fine (se è stato cancellato in precedenza)
Operazione: CHECKSERVER_2¶
Descrizione Questa operazione restituisce se il fileSystem server è attivo Chiamata standard
| Dato | Formato | Contenuto |
|---|---|---|
| FTP-CALLER | x(10) | Nome programma chiamante |
| FTP-CALLED | x(10) | "FTP" |
| FTP-SERVER | x(10) | Il codice server configurato (solo per FTP) |
| FTP-OPE | x(15) | "CheckServer" |
| FTP-ESITO | x(01) | Verrà restituito "S" se il fileSystem server è attivo |
| FTP-CLOCK-MSG | x(01) | Impostare a "S" se necessario |
| FILLER | x(199) |
Elaborazione - AWS Elaborazione - FTP
Operazione: CLEANUPLOCAL_2¶
Descrizione La cartella locale indicata nel percorso viene svuotata Chiamata standard
| Dato | Formato | Contenuto |
|---|---|---|
| FTP-CALLER | x(10) | Nome programma chiamante |
| FTP-CALLED | x(10) | "FTP" |
| FTP-SERVER | x(10) | Il codice server configurato (solo per FTP) |
| FTP-OPE | x(15) | "CleanupLocale" |
| FTP-SOURCE-FOLDER | x(256) | Cartella locale da ripulire |
| FTP-ESITO | x(01) | Verrà restituito "S" se il fileSystem server è attivo |
| FTP-CLOCK-MSG | x(01) | Impostare a "S" se necessario |
| FILLER | x(199) |
Elaborazione - AWS Elaborazione - FTP L'elaborazione è identica per entrambe le versioni: il contenuto della cartella, viene svuotato in modo ricorsivo, e anche la cartella stessa indicata viene cancellata. Si dà per scontato che la cartella sia in formato "client", quindi il comando è stato preparato dando per scontato di essere su un ambiente Windows locale. Il parametro FTP-SERVER non è necessario, in caso di configurazione AWS attiva.
Operazione: CLEANUPSERVER_2¶
Descrizione Operazione creata per essere usata in un contesto thin, quando si vuole effettuare la cancellazione di una cartella in formato "server". Chiamata standard
| Dato | Contenuto |
|---|---|
| FTP-CALLER | Nome programma chiamante |
| FTP-CALLED | "FTP" |
| FTP-OPE | "cleanupserver" |
| FTP-SOURCE-FOLDER | Cartella "server" da ripulire |
| FTP-SOURCE-FILE-LIST | Elenco di file da eleminare |
| FTP-ESITO | Verrà restituito "S" se l'operazione è riuscita |
| FTP-CLOCK-MSG | Impostare a "S" se necessario |
| FILLER |
Elaborazione - AWS Elaborazione - FTP Se FTP-SOURCE-FILE-LIST contiene uno o più file, verranno cancellati direttamente questi; altrimenti viene cancellata l'intera cartella presente in FTP-SOURCE-FOLDER. La funzione implementa direttamente il comando di cancellazione del sistema operativo: * RD .... per Windows * rm.... per Linux
Operazione: CLEANUPREMOTE_2¶
Descrizione La cartella remota indicata nel percorso viene svuotata. Per "remoto" si intende in cloud, su uno storage AWS o FTP Chiamata standard
| Dato | Contenuto |
|---|---|
| FTP-CALLER | Nome programma chiamante |
| FTP-CALLED | "FTP" |
| FTP-SERVER | Il codice server configurato (solo per FTP) |
| FTP-OPE | "CleanupRemote" |
| FTP-SOURCE-FOLDER | Cartella "remota" da ripulire |
| FTP-SOURCE-FILE-LIST | Elenco di file da eleminare |
| FTP-ESITO | Verrà restituito "S" se il fileSystem server è attivo |
| FTP-CLOCK-MSG | Impostare a "S" se necessario |
| FILLER |
Elaborazione - AWS Se FTP-SOURCE-FILE-LIST contiene uno o più file, verranno cancellati direttamente questi; altrimenti viene cancellata l'intera cartella presente in FTP-SOURCE-FOLDER. La funzione effettua una chiamata al client AWS con la direttiva di cancellazione dei files richiesti o dell'intera cartella Elaborazione - FTP Viene creato un file batch (.bat) che contiene le direttive per la cancellazione remota della cartella. NB: attualmente funziona solo se la cartella è visibile dal client da cui viene eseguita, dato che crea un file batch, e questo viene eseguito in locale.
Operazione: DOWNLOAD_2¶
Descrizione Viene eseguito il download di un singolo file, o di tutti i files di una sottocartella Chiamata standard
| Dato | Contenuto |
|---|---|
| FTP-CALLER | Nome programma chiamante |
| FTP-CALLED | "FTP" |
| FTP-SERVER | Il codice server configurato (solo per FTP) |
| FTP-OPE | "Download" |
| FTP-SOURCE-FOLDER | Cartella da cui pescare il file |
| FTP-SOURCE-FILE-LIST | Nome/nomi file da scaricare |
| FTP-ESITO | Verrà restituito "S" se l'operazione è riuscita |
| FILLER |
L'elaborazione è identica per entrambe le versioni: il contenuto della cartella, viene svuotato in modo ricorsivo, e anche la cartella stessa indicata viene cancellata. Elaborazione - AWS Il parametro FTP-SERVER non è necessario. Il parametro FTP-SOURCE-FOLDER è il path "relativo" al bucket. Elaborazione - FTP
Estratto da documentazione interna ClickUp