FTP - Trasferimento documenti¶
Posizione nel menu Programma non a menu Linkage section
| Tipo | Dato | Formato | Contenuto |
|---|---|---|---|
| INPUT | FTP-CALLER | x(10) | |
| FTP-CALLED | x(10) | ||
| FTP-SERVER | x(10) | Codice suddivisione della configurazione "ftp" su cui | |
| FTP-OPE | x(15) | Operazione da eseguire; vedi topic successivi | |
| FTP-LOG-OPE | x(01) | Registrazione log delle attività? S/N | |
| FTP-SOURCE-FOLDER | x(01) | Cartella sorgente | |
| FTP-SOURCE-FILE-LIST | x(2000) | Elenco di files separato da "cr+lf" | |
| FTP-DESTINATION-FOLDER | x(256) | Cartella di destinazione | |
| FTP-DESTINATION-FILE | x(120) | Nome file di destinazione Può essere usato in ambito AWS, quando FTP-SOURCE-FILE-LIST contiene un solo file Se vuoto, il nome file di destinazione coincide con il file di origine |
|
| FTP-LOCATION | x(01) | Location dellla cartella locale Potrà essere riferita al percorso source o destination, a seconda dell'operazione da eseguire - "C":Client - "S":Server (default) |
|
| FTP-BUCKET | x(01) | In caso di collegamento ad AWS, questo parametro indica se il bucket a cui collegarsi deve essere diverso da quello configurato. NB: si dà per scontato che le credenziali siano le stesse - " ":Bucket standard cliente - "M":Bucket "modelli" |
|
| OUTPUT | FTP-ESITO | x(01) | Esito dell'operazione S/N |
| FTP-CLOCK-MSG | x(01) | Emetto il clock-msg? default "S" | |
| FILLER | x(77) |
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 | |
| aws | attivazione-bucket | Parametri necessari in caso di gestione AWS attiva |
| aws | key-id | |
| aws | key-secret | |
| aws | bucket-name | |
| aws | profile-name |
Procedure Sincronizzazione file con AWS Maschera del programma Nessuna maschera. Elaborazione L'elaborazione cambia a seconda dell'operazione richiesta. Configurazione AWS Prima di eseguire qualunque operazione si controllerà lo stato della configurazione attivazione-bucket: se vale "F", sarà eseguita la funzione CONFIGURA-AWS
Operazione: CONFIGURA-AWS¶
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¶
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¶
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¶
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¶
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: MoveRemote¶
Descrizione Un file presente in remoto su AWS deve essere spostato su un altro percorso di AWS Operazione prevista solo in caso di configurazione AWS Chiamata standard
| Dato | Contenuto |
|---|---|
| FTP-CALLER | Nome programma chiamante |
| FTP-CALLED | "FTP" |
| FTP-SERVER | Il codice server configurato (solo per FTP) |
| FTP-OPE | "MoveRemote" |
| FTP-SOURCE-FOLDER | Cartella "remota" da cui spostare |
| FTP-SOURCE-FILE-LIST | Elenco di file da cui spostare |
| FTP-DESTINATION-FOLDER | Cartella "remota" di destinazione |
| FTP-ESITO | Verrà restituito "S" se il fileSystem server è attivo |
| FTP-CLOCK-MSG | Impostare a "S" se necessario |
| FILLER |
Elaborazione - AWS Ciascun file presente in FTP-SOURCE-FILE-LIST verrà spostato da FTP-SOURCE-FOLDER a FTP-DESTINATION-FOLDER La funzione effettua una chiamata al client AWS con la direttiva di spostamento dei files richiesti Elaborazione - FTP Non previsto
Operazione: DOWNLOAD¶
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