Per interagire con un singolo server Secure File Transfer Protocol (SFTP) come parte di una catena, aggiungi un passo che includa un comando di connessione SFTP.
Nota: Per utilizzare questo connettore, la tua organizzazione deve avere accesso al proprio server SFTP. Workiva non ospita né fornisce server SFTP.
Per abilitare questi comandi, un amministratore IT deve prima configurare una connessione SFTP.
Eliminare
Per eliminare file e cartelle sul server SFTP, usa il comando Delete.
Proprietà
| Proprietà |
Dettaglio |
| File |
Inserisci i file e le cartelle da eliminare. Per abbinare più file e cartelle, usa il carattere jolly *. |
| Salta le cartelle |
Per ignorare le cartelle che corrispondono ai file specificati, seleziona questa casella. |
| Ricorsivo |
Per eliminare le cartelle specificate e tutto il loro contenuto, seleziona questa casella. |
Output
| Output |
Tipo di output |
| File eliminati |
JSON |
| Cartelle eliminate |
JSON |
| Tutti gli elementi eliminati |
JSON |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Operazione completata |
| 2 |
Errore |
Attività non riuscita |
| 6 |
Errore |
Le directory contrassegnate per l'eliminazione non sono state impostate per essere saltate e la ricorsività non è stata impostata |
Scarica file
Per scaricare un file dal server SFTP, usa il comando Download File.
Proprietà
| Proprietà |
Dettaglio |
| File |
Inserisci il nome del file da recuperare dal server SFTP. Nota: Se utilizzi questo comando con un'iterazione di gruppo, utilizza la variabile Remote Files Iteration dell'iteratore di comandi per identificare il file. |
| Download parallelo |
Per abilitare i download paralleli, ad esempio per i file di grandi dimensioni, seleziona questa casella. |
| Numero di thread |
Se selezioni Parallel Download, seleziona il numero di thread da eseguire in parallelo. Se non sei sicuro, lascia il valore predefinito di 3. |
Output
| Output |
Tipo di output |
| File scaricato |
File |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Operazione completata |
| 2 |
Errore |
Attività non riuscita |
Ottieni
Per recuperare i file dal server SFTP, usa il comando Get.
Proprietà
| Proprietà |
Dettaglio |
| File |
Inserisci i file da recuperare. Per trovare più file, usa il carattere jolly *. |
| Destinazione |
Inserisci la destinazione dei file. Per recuperare più file, inserisci una directory. |
Output
| Output |
Tipo di output |
| File recuperati |
JSON |
| File recuperati (Testo) |
Stringa |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Operazione completata |
| 2 |
Errore |
Attività non riuscita |
| 6 |
Errore |
Le directory non sono state saltate e contrassegnate per l'eliminazione e la ricorsività non è stata impostata |
Elenca directory
Per elencare i file presenti in una directory del server SFTP, usa il comando List Directory.
Proprietà
| Proprietà |
Dettaglio |
| Directory |
Inserisci la directory con i contenuti da elencare. Per elencare più file e cartelle all'interno della directory, usa il carattere jolly *. Nota: Se usi questo comando per elencare i file per un successivo comando iterativo Scarica file, includi il nome del file da scaricare. Se il nome cambia a ogni iterazione, ad esempio in base a una data o a un timestamp, includi il carattere jolly *. |
| Livello di dettaglio |
Seleziona il livello di dettaglio da mostrare per i file e le cartelle:
- Breve, per i soli nomi dei file e delle cartelle
- Completo, per i nomi e le informazioni aggiuntive, tra cui la proprietà e i permessi.
|
Output
| Output |
Tipo di output |
| File remoti |
JSON |
| Dettagli dei file remoti |
JSON (file)
In vigore dall'11 settembre 2025, contiene un array JSON di file con i seguenti campi:
- modifiedTime = ultima volta che il file SFTP è stato modificato
- mode = modalità del file
- remoteFile = percorso del file remoto (corrisponde all'altro output)
- accessedTime = ultima volta che è stato effettuato un accesso al file SFTP
Esempio:
[{"modifiedTime": "Wed Sep 10 03:15:15 UTC 2025", "size": "60", "mode":"-rwxrwxr-x", "remoteFile":"/tmp/somefile.txt", "accessedTime": "Wed Sep 10 03:15:15 UTC 2025"},{"modifiedTime": "Wed Sep 10 02:37:36 UTC 2025", "size": "60", "mode": "drwxrwxr-x", "remoteFile":"/tmp/someDir", "accessedTime": "Wed Sep 10 02:37:36 UTC 2025"}]
|
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Operazione completata |
| 2 |
Errore |
Attività non riuscita |
| 5 |
Errore |
La directory specificata non è stata trovata |
Crea directory
Per creare una nuova directory sul server SFTP, usa il comando Make Directory.
Proprietà
| Proprietà |
Dettaglio |
| Directory |
Inserisci la directory da creare sul server SFTP. |
| Ricorsivo |
Per creare l'intero percorso della directory se non esiste, seleziona questa casella. |
Output
Nessuno
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Operazione completata |
| 2 |
Errore |
Attività non riuscita |
| 4 |
Errore |
Errore nella creazione della directory specificata |
| 6 |
Operazione completata |
La directory esiste già |
Sposta
Per spostare i file sul server SFTP, usa il comando Sposta.
Proprietà
| Proprietà |
Dettaglio |
| File |
Inserisci i file da spostare. Per abbinare più file e cartelle, usa il carattere jolly *. |
| Destinazione |
Inserisci la destinazione dei file. Per spostare più file, inserisci una directory. |
Output
| Output |
Tipo di output |
| File spostati |
JSON |
| File spostati (testo) |
Stringa |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Operazione completata |
| 2 |
Errore |
Attività non riuscita |
| 4 |
Errore |
Quando si spostano più file, la destinazione deve essere una directory esistente |
| 5 |
Errore |
Non sono stati trovati file con i file di origine specificati |
Metti
Per caricare i file sul server SFTP, usa il comando Put.
Proprietà
| Proprietà |
Dettaglio |
| File |
Inserisci i file da caricare. Per abbinare più file e cartelle, usa il carattere jolly *. |
| Destinazione |
Inserisci la destinazione dei file. Per caricare più file, inserisci una directory. |
Output
| Output |
Tipo di output |
| File remoti |
JSON |
| File remoti (Testo) |
Stringa |
Codici di uscita
| Codice |
Tipo |
Dettaglio |
| 0 |
Operazione completata |
Operazione completata |
| 2 |
Errore |
Attività non riuscita |
| 6 |
Errore |
Le directory non sono state saltate e contrassegnate per l'eliminazione, ma la ricorsività non è stata impostata |