Compartilhar via

FTP

  • Artigo

Use o grupo de ações do FTP para fazer upload e download de arquivos e manipular diretórios em servidores FTP.

Para estabelecer uma conexão FTP, use a ação Abrir conexão de FTP. O exemplo a seguir tem um host, porta e credenciais especificados. Além disso, o tempo limite definido faz com que a ação falhe se a conexão não for estabelecida a tempo.

Captura de tela da ação Abrir conexão FTP.

Baixe arquivos usando a ação Baixar arquivos do FTP. O exemplo a seguir mostra a variável de conexão em uso e a pasta de destino selecionada. O arquivo remoto também foi especificado e configurado para substituir arquivos existentes no mesmo local.

Captura de tela da ação Baixar arquivos do FTP.

Faça upload de arquivos usando a ação Carregar arquivos para FTP e especificando o arquivo e o local remoto.

Abrir conexão de FTP

Esta ação estabelece uma conexão específica com um servidor FTP remoto e armazena essa conexão como uma variável para uso posterior.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Host Não Valor do texto Insira aqui o endereço do servidor FTP.
Port Sim Valor numérico 21 Insira aqui a porta do servidor FTP.
Active mode N/D Valor booliano False Especificar o modo de conexão
Username Não Valor do texto Especifique o nome de usuário da conta FTP a ser usada
Senha Sim Entrada direta criptografada ou Valor do texto Especifique a senha da conta FTP a ser usada
Tempo limite Sim Valor numérico 10 Definir o tempo em segundos que você deseja aguardar pelo estabelecimento da conexão antes de considerar que ação falhou

Variáveis produzidas

Argumento Type Description
FTPConnection Conexão FTP A conexão de FTP

Exceções

Exceção Descrição
Login failure error Indica falha no logon
Connection error Indica que há um problema com a conexão

Listar diretório FTP

Esta ação retorna os subdiretórios e arquivos contidos no diretório atual de uma conexão de FTP.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Connection Não Conexão FTP A conexão de FTP
Path Sim Valor do texto O caminho que você deseja listar.

Variáveis produzidas

Argumento Type Description
Directories Lista de Diretórios FTP Os diretórios listados
Arquivos Lista de Arquivos FTP Os arquivos listados

Exceções

Exceção Descrição
Erro de listagem Indica que não foi possível executar a listagem da pasta
Not connected error Indica que não há uma conexão aberta com o servidor FTP
Directory doesn't exist error Indica que não foi possível encontrar o diretório

Abrir conexão segura de FTP

Esta ação estabelece uma conexão específica segura com um servidor FTP remoto e armazena essa conexão como uma variável para uso posterior.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Host Não Valor do texto Insira aqui o endereço do servidor FTP.
Port Sim Valor numérico 22 Insira aqui a porta do servidor FTP.
Active mode N/D Valor booliano Verdadeiro Especificar o modo de conexão
Secure FTP Protocol N/D SFTP, FTPS explícito, FTPS implícito SFTP Escolher o protocolo FTP que você deseja usar para criptografar a conexão
Authentication method N/D Nome de usuário e senha, Chave privada, Chave privada e senha Nome de usuário e senha Escolha o método que você deseja usar para se autenticar no servidor FTP
User name Não Valor do texto Especifique o nome de usuário da conta FTP a ser usada
Senha Sim Entrada direta criptografada ou Valor do texto Especifique a senha da conta FTP que você deseja usar
Path to private key Não Valor do texto Insira o caminho do arquivo para a chave privada a ser usada na autenticação
Senha da chave privada Sim Entrada direta criptografada ou Valor do texto Insira aqui uma variável que contém a senha da chave privada
Timeout Sim Valor numérico 10 Definir o tempo em segundos que você deseja aguardar pelo estabelecimento da conexão antes de considerar que ação falhou

Variáveis produzidas

Argumento Type Description
SftpConnection Conexão FTP Conexão de SFTP

Exceções

Exceção Descrição
Login failure error Indica falha no logon
Connection error Indica que há um problema com a conexão

Encerrar conexão

Esta ação encerra uma conexão de FTP aberta.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Connection Não Conexão FTP A conexão de FTP

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Not connected error Indica que não há uma conexão aberta com o servidor FTP

Alterar diretório de trabalho

Esta ação define o diretório de trabalho atual para uma conexão de FTP.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Connection Não Conexão FTP A conexão de FTP
Set working directory to Não Valor do texto Configurar o caminho a ser definido como o diretório de trabalho

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Not connected error Indica que não há uma conexão aberta com o servidor FTP
Directory doesn't exist error Indica que não foi possível encontrar o diretório
Can't change working directory error Indica que não é possível alterar o diretório de trabalho

Baixar arquivos do FTP

Baixa um ou mais arquivos de um servidor FTP.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
FTP connection Não Conexão FTP A conexão FTP com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Abrir conexão de FTP
Download into folder Não Pasta A pasta de destino dos arquivos que serão baixados
Arquivos a serem baixados Não Lista de Arquivos FTP Os arquivos a serem baixados
Tipo de transferência N/D Automático, Binário, ASCII Automático Insira ASCII ou binário para especificar o método de download de um único arquivo. Se o tipo de arquivo for incerto ou mais de um for baixado, escolha Automático para seguir as regras de transferência especificadas nas opções
If file exists N/D Substituir, Não baixar, Baixar com nome exclusivo Substituir Especifique o que fazer se o arquivo já existir. Substituir grava sobre o arquivo original de maneira que você não possa mais acessá-lo, e baixar com nome exclusivo adiciona um sublinhado e um número sequencial ao final

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Not connected error Indica que não há uma conexão aberta com o servidor FTP
Remote file doesn't exist error Indica que o arquivo não existe no servidor FTP
Directory doesn't exist error Indica que não foi possível encontrar o diretório
FTP connection aborted error Indica que a conexão de FTP foi cancelada
Can't download file error Indica que não foi possível baixar o arquivo

Baixar pastas do FTP

Baixa uma ou mais pastas de um servidor FTP.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
FTP connection Não Conexão FTP A conexão FTP com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Abrir conexão de FTP
Folder(s) to download Não Lista de Diretórios FTP O nome dos caminhos das pastas ou as pastas FTP a serem baixadas
Download into local folder Não Pasta O caminho completo de destino das pastas FTP que você está baixando

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Not connected error Indica que não há uma conexão aberta com o servidor FTP
Remote directory doesn't exist error Indica que o diretório não existe no servidor FTP
Directory doesn't exist error Indica que não foi possível encontrar o diretório
FTP connection aborted error Indica que a conexão de FTP foi cancelada
Can't download directory error Indica que não foi possível baixar o diretório

Carregar arquivos no FTP

Carrega um ou mais arquivos em um servidor FTP.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
FTP connection Não Conexão FTP A conexão FTP com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Abrir conexão de FTP
File(s) to upload Não Lista de Arquivos Os arquivos a serem carregados
Remote location Sim Valor do texto O local onde os arquivos devem ser carregados
Transfer type N/D Automático, Binário, ASCII Automático Insira ASCII ou binário para especificar o método de download de um único arquivo. Se você não sabe qual será o tipo de arquivo ou se estiver baixando mais de um tipo, escolha Automático para acompanhar as regras de transferência especificadas nas Opções
If file exists N/D Substituir, Não baixar, Baixar com nome exclusivo Substituir Especifique o que fazer se o arquivo já existir. Substituir grava sobre o arquivo original de maneira que você não possa mais acessá-lo, e Baixar com Nome Exclusivo adiciona um sublinhado e um número sequencial ao final

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Not connected error Indica que não há uma conexão aberta com o servidor FTP
File not found error Indica que o arquivo não foi encontrado
FTP connection aborted error Indica que a conexão de FTP foi cancelada
Upload file error Indica que não foi possível carregar o arquivo

Carregar pastas no FTP

Carrega uma ou mais pastas em um servidor FTP.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
FTP connection Não Conexão FTP A conexão FTP com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Abrir conexão de FTP
Folder(s) to upload Não Lista de Pastas As pastas a serem carregadas. As pastas sendo carregadas não devem existir no diretório ativo do servidor FTP
Remote location Não Valor do texto O local onde as pastas devem ser carregadas

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Not connected error Indica que não há uma conexão aberta com o servidor FTP
Remote directory doesn't exist error Indica que o diretório não existe no servidor FTP
FTP connection aborted error Indica que a conexão de FTP foi cancelada
Upload directory error Indica que não foi possível carregar o diretório

Excluir arquivo FTP

Exclui um ou mais arquivos de um servidor FTP.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
FTP connection Não Conexão FTP A conexão FTP com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Abrir conexão de FTP
Arquivos a serem excluídos Não Lista de Arquivos FTP Os arquivos a serem excluídos

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Not connected error Indica que não há uma conexão aberta com o servidor FTP
File not found error Indica que o arquivo não foi encontrado
Can't delete file error Indica que a exclusão do arquivo não foi possível

Renomear Arquivo FTP

Renomeia um arquivo que reside em um servidor FTP.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
FTP connection Não Conexão FTP A conexão FTP com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Abrir conexão de FTP
Arquivo a ser renomeado Não Arquivo FTP O arquivo a ser renomeado
Novo nome do arquivo Não Valor do texto O novo nome do arquivo. Se você inserir um nome com um caminho, o arquivo também será movido para esse local. Se o local não existir, ele gerará uma exceção

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Not connected error Indica que não há uma conexão aberta com o servidor FTP
Can't rename file error Indica que não foi possível renomear o arquivo
File not found error Indica que o arquivo não foi encontrado

Criar diretório FTP

Cria um diretório em um servidor FTP.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
FTP connection Não Conexão FTP A conexão FTP com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Abrir conexão de FTP
New directory Não Diretório FTP O novo diretório. Se um caminho for especificado, todas as novas pastas que levam ao novo diretório serão criadas

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Access denied error Indica que esta conta não tem acesso a uma operação
File exists error Indica que o arquivo já existe
Create directory error Indica que não foi possível criar o diretório
Directory doesn't exist error Indica que não foi possível encontrar o diretório
Not connected error Indica que não há uma conexão aberta com o servidor FTP

Excluir diretório FTP

Exclui um diretório de um servidor FTP.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
FTP connection Não Conexão FTP A conexão FTP com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Abrir conexão de FTP
Directory to delete Não Diretório FTP A pasta a ser excluída. Todos os itens da pasta também serão excluídos

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Delete directory error Indica que não foi possível excluir o diretório
Remote directory doesn't exist error Indica que o diretório não existe no servidor FTP
Working directory change error Indica que não foi possível alterar o diretório de trabalho
Not connected error Indica que não há uma conexão aberta com o servidor FTP

Invocar o comando FTP

Invoca o comando FTP literal fornecido no servidor.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
FTP connection Não Conexão FTP A conexão FTP com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação para abrir a conexão de FTP
FTP command Não Valor do texto O comando a ser executado junto com quaisquer argumentos. Por exemplo, você pode executar FEAT ou CHMOD aqui
Valid reply code(s) Sim Valor do texto Os códigos que podem ser retornados pelo comando, separados por ponto e vírgula. Se o comando FTP retornar um código que não tiver sido inserido aqui, essa ação gerará uma exceção. Aplica-se apenas a conexões simples de FTP ou FTPS

Variáveis produzidas

Argumento Type Description
ReplyCode Valor do texto O código real que foi retornado. Aplica-se apenas a conexões simples de FTP ou FTPS
ReplyText Valor do texto O texto retornado pelo servidor FTP

Exceções

Exceção Description
Erro ao invocar comando Indica que ocorreu um erro ao invocar um comando FTP
Not connected error Indica que não há uma conexão aberta com o servidor FTP

Sincronizar diretórios

Sincronize os arquivos e subdiretórios de uma determinada pasta com um determinado diretório FTP remoto.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
FTP connection Não Conexão FTP A conexão FTP com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Abrir conexão de FTP
Synchronization direction N/A Remoto -> local (Download), Local -> remoto (Upload) Remoto > local (download) Direção do método Sincronização. Se a pasta local será sincronizada com o diretório remoto (DOWNLOAD) ou se o diretório remoto será sincronizado com a pasta local (UPLOAD)
Files to sync N/D Todos os arquivos, Somente arquivos que correspondem ao filtro de arquivo, Somente arquivos que não correspondem ao filtro de arquivo Todos os arquivos Escolha se você deseja sincronizar todos os arquivos ou se deseja usar um filtro de arquivo para incluir ou excluir um conjunto específico de arquivos
Filtro de arquivo Não Valor do texto * Padrão de nome de arquivo que controla quais arquivos serão incluídos ou excluídos. Essa opção permite curingas, como ".txt", "documento?.doc". A opção também permite vários filtros usando vírgula como separador: ".txt,*.pdf,documento?"
Local folder Não Pasta Nome da pasta local a ser sincronizada
FTP directory Sim Diretório FTP / Nome do diretório FTP a ser sincronizado
Delete if source is absent N/D Valor booliano False Esta opção excluirá um arquivo ou pasta que existe no diretório de destino, e não a origem.
Include subdirectories N/D Valor booliano Verdadeiro Esta opção incluirá subdiretórios no processo de sincronização.
Time difference in hours Sim Valor numérico 0 Diferença de horário do servidor remoto (em horas) caso opere em um fuso horário diferente.
Time difference in minutes Sim Valor numérico 0 Diferença de horário do servidor remoto (em minutos) caso opere em um fuso horário diferente.
Time difference ahead N/D Valor booliano Verdadeiro Especifique se o fuso horário do servidor está adiantado ou não.

Variáveis produzidas

Argumento Type Description
FtpFilesAdded Lista de Arquivos FTP Lista de arquivos FTP que existiam inicialmente na origem e após o processo de sincronização foram adicionados ao destino.
FtpFilesModified Lista de Arquivos FTP Lista de arquivos FTP que existiam inicialmente na origem e no destino e após o processo de sincronização foram adicionados ao destino.
FtpFilesDeleted Lista de Arquivos FTP Lista de arquivos FTP que existiam inicialmente no diretório de destino e após o processo de sincronização foram excluídos.
FilesAdded Lista de Arquivos Lista de arquivos que existiam inicialmente na origem e após o processo de sincronização foram adicionados ao destino.
FilesModified Lista de Arquivos Lista de arquivos que existiam inicialmente na origem e no destino e após o processo de sincronização foram adicionados ao destino.
FilesDeleted Lista de Arquivos Lista de arquivos que existiam inicialmente no diretório de destino e após o processo de sincronização foram excluídos.

Exceções

Exceção Description
Listing error Indica que não foi possível executar a listagem da pasta
Not connected error Indica que não há uma conexão aberta com o servidor FTP
File not found error Indica que o arquivo não foi encontrado
FTP connection aborted error Indica que a conexão de FTP foi cancelada
Upload file error Indica que não foi possível carregar o arquivo
Remote file doesn't exist error Indica que o arquivo não existe no servidor FTP
Can't download file error Indica que não foi possível baixar o arquivo
Delete directory error Indica que não foi possível excluir o diretório
Synchronization failed error Indica que o processo de sincronização falhou devido a um erro inesperado.