Para interagir com um único servidor SFTP (Secure File Transfer Protocol) como parte de uma cadeia, adicione uma etapa que inclua um comando de conexão SFTP.
Observação: Para usar esse conector, sua organização precisa ter acesso a seu próprio servidor SFTP. A Workiva não nem hospeda ou fornece servidores SFTP.
Para ativar esses comandos, um administrador de TI deve primeiro configurar uma conexão SFTP.
Excluir
Para excluir arquivos e pastas no servidor SFTP, use o comando Delete.
Propriedades
| Propriedade |
Detalhes |
| Arquivo(s) |
Digite os arquivos e as pastas a serem excluídos. Para corresponder a vários arquivos e pastas, use o caractere curinga *. |
| Pular pastas |
Para ignorar as pastas que correspondem ao(s) arquivo(s) especificado(s), marque essa caixa. |
| Recursive* |
Para excluir as pastas especificadas e todo o seu conteúdo, marque essa caixa. |
Saídas
| Saída |
Tipo de saída |
| Arquivos excluídos |
JSON |
| Pastas excluídas |
JSON |
| Todos os itens excluídos |
JSON |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 2 |
Erro |
Falha na tarefa |
| 6 |
Erro |
Os diretórios marcados para exclusão não foram definidos para serem ignorados e o recursivo não foi definido |
Baixar arquivo
Para fazer download de um arquivo do servidor SFTP, use o comando Download File.
Propriedades
| Propriedade |
Detalhes |
| Arquivo |
Digite o nome do arquivo a ser recuperado do servidor SFTP. Observação: Se você estiver usando esse comando com uma iteração de grupo, use a variável Remote Files Iteration do iterador de comandos para identificar o arquivo. |
| Download paralelo |
Para ativar downloads paralelos, por exemplo, para um arquivo grande, marque essa caixa. |
| Número de threads |
Se você selecionar Parallel Download, selecione quantos threads devem ser executados em paralelo. Se você não tiver certeza, deixe o valor padrão de 3. |
Saídas
| Saída |
Tipo de saída |
| Arquivo baixado |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 2 |
Erro |
Falha na tarefa |
Obtenha
Para recuperar arquivos do servidor SFTP, use o comando Get.
Propriedades
| Propriedade |
Detalhes |
| Arquivo(s) |
Digite os arquivos a serem recuperados. Para corresponder a vários arquivos, use o caractere curinga *. |
| Destino |
Digite o destino dos arquivos. Para recuperar vários arquivos, digite um diretório. |
Saídas
| Saída |
Tipo de saída |
| Arquivos recuperados |
JSON |
| Arquivos recuperados (texto) |
String |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 2 |
Erro |
Falha na tarefa |
| 6 |
Erro |
Os diretórios não foram ignorados e marcados para exclusão, e o recursivo não foi definido |
Listar diretório
Para listar os arquivos em um diretório no servidor SFTP, use o comando List Directory.
Propriedades
| Propriedade |
Detalhes |
| Diretório |
Digite o diretório com o conteúdo a ser listado. Para listar vários arquivos e pastas dentro do diretório, use o caractere curinga *. Observação: Se você usar esse comando para listar arquivos para um comando iterativo posterior Download File, inclua o nome do arquivo a ser baixado. Se o nome mudar a cada iteração, por exemplo, com base em uma data ou registro de data e hora, inclua o caractere curinga *. |
| Nível de detalhe |
Selecione o nível de detalhe a ser mostrado sobre os arquivos e as pastas:
- Short, apenas para os nomes dos arquivos e pastas
- Full, para os nomes e informações adicionais, incluindo propriedade e permissões
|
Saídas
| Saída |
Tipo de saída |
| Arquivos remotos |
JSON |
| Detalhes de arquivos remotos |
JSON (arquivo)
A partir de 11 de setembro de 2025, contém uma matriz JSON de arquivos com os seguintes campos:
- modifiedTime = último tempo em que o arquivo SFTP foi alterado
- mode = modo do arquivo
- remoteFile = caminho para o arquivo remoto (isso corresponde à outra saída)
- accessedTime = último tempo em que o arquivo SFTP foi acessado
Amostra:
[{"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"}]
|
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 2 |
Erro |
Falha na tarefa |
| 5 |
Erro |
O diretório especificado não foi encontrado |
Criar diretório
Para criar um novo diretório no servidor SFTP, use o comando Make Directory.
Propriedades
| Propriedade |
Detalhes |
| Diretório |
Digite o diretório a ser criado no servidor SFTP. |
| Recursive* |
Para criar o caminho completo do diretório, se ele não existir, marque essa caixa. |
Saída
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 2 |
Erro |
Falha na tarefa |
| 4 |
Erro |
Erro ao criar o diretório especificado |
| 6 |
Sucesso |
O diretório já existe |
Mover
Para mover arquivos no servidor SFTP, use o comando Move.
Propriedades
| Propriedade |
Detalhes |
| Arquivo(s) |
Digite os arquivos a serem movidos. Para corresponder a vários arquivos e pastas, use o caractere curinga *. |
| Destino |
Digite o destino dos arquivos. Para mover vários arquivos, digite um diretório. |
Saídas
| Saída |
Tipo de saída |
| Arquivos movidos |
JSON |
| Arquivos movidos (texto) |
String |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 2 |
Erro |
Falha na tarefa |
| 4 |
Erro |
Ao mover vários arquivos, o destino deve ser um diretório existente |
| 5 |
Erro |
Nenhum arquivo foi encontrado com os arquivos de origem especificados |
Colocar
Para fazer upload de arquivos para o servidor SFTP, use o comando Put.
Propriedades
| Propriedade |
Detalhes |
| Arquivo(s) |
Digite os arquivos a serem carregados. Para corresponder a vários arquivos e pastas, use o caractere curinga *. |
| Destino |
Digite o destino dos arquivos. Para fazer upload de vários arquivos, digite um diretório. |
Saídas
| Saída |
Tipo de saída |
| Arquivos remotos |
JSON |
| Arquivos remotos (texto) |
String |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 2 |
Erro |
Falha na tarefa |
| 6 |
Erro |
Os diretórios não foram ignorados e marcados para exclusão, mas o recursivo não foi definido |