Skip to main content

S-FTP In

Il Task “S-FTP In” consente di scaricare in modo sicuro uno o più file da un server remoto al sistema locale utilizzando il protocollo SFTP (Secure File Transfer Protocol). È un componente cruciale per automatizzare l'acquisizione di dati o file da sistemi esterni, rendendoli disponibili per essere elaborati dal Workflow.

Configurazione​

La configurazione del Task si articola nella definizione delle credenziali di accesso e nella specifica di cosa scaricare. I campi di configurazione del Task possono essere valorizzati manualmente o tramite parametri e variabili del workflow

Autenticazione​

Definisce il metodo con cui il Workflow si autenticherà presso il server SFTP.

  • Metodo di Autenticazione: È possibile scegliere tra:
  • Password: L'autenticazione avverrà tramite la password associata all'utente.
  • Chiavi SSH: L'autenticazione avverrà tramite una coppia di chiavi SSH (pubblica/privata).
  • Host: L'indirizzo IP o il nome DNS del server SFTP a cui connettersi.
  • Porta: La porta di comunicazione per la connessione SFTP. Il valore predefinito è 22.
  • User: Il nome utente per la connessione.

Download file da remoto​

Specifica la modalità di download.

  • Modalità di Download: È possibile scegliere tra due opzioni:
  • Singolo File: Permette di scaricare un singolo file specifico.
  • Intera Directory: Permette di scaricare tutti i file contenuti in una specifica cartella remota.
  • Nome File: Questo campo è visibile solo se si sceglie la modalità "Singolo File". Qui va inserito il nome esatto del file da scaricare.
  • Path remoto: Il percorso della directory sul server SFTP da cui scaricare i file. Se si scarica un singolo file, questo è il percorso della cartella che lo contiene.

Parametri di Output​

Dopo aver tentato l'operazione di download, il Task espone i seguenti parametri di output, che forniscono informazioni dettagliate sull'esito e sui file scaricati.

  • result: Contiene un messaggio testuale che descrive il risultato dell'operazione.
  • Esempio di successo (file singolo): "Trasferimento del file [NomeFile] avvenuto con successo!"
  • Esempio di successo (directory): "Trasferimento dei file della directory [PathRemoto] avvenuto con successo!"
  • Esempio di fallimento: "Errore Autenticazione con utente [NomeUtente]" o "Errore nel trasferimento del file [NomeFile]!"
  • ftpInFile: Contiene il nome del file scaricato.
  • ftpInPath: Restituisce il percorso della directory remota da cui è stato effettuato il download.
  • resultJson: Rappresenta il risultato dell’esecuzione del task in formato JSON, includendo informazioni generali, configurazioni e dettagli sull’esecuzione.

Note Importanti

  • La modalità "Intera Directory" scarica i file presenti al primo livello della cartella specificata, ma non scarica ricorsivamente il contenuto di eventuali sottocartelle.