Partilhar via

FTP

  • Artigo

Utilize o grupo de ações FTP para carregar e transferir ficheiros e manipular diretórios em servidores FTP.

Para estabelecer uma ligação FTP, utilize a ação Abrir ligação FTP. O exemplo que se segue tem um anfitrião, porta e credenciais especificados. Além disso, o tempo limite definido falha quando a ligação não é estabelecida a tempo.

Captura de ecrã da ação Abrir ligação FTP.

Transfira ficheiros utilizando a ação Transferir ficheiro(s) do FTP. O exemplo que se segue mostra a variável de ligação em utilização e a pasta de destino selecionada. O ficheiro remoto também foi especificado e definido para substituir quaisquer ficheiros existentes no mesmo local.

Captura de ecrã da ação Transferir ficheiros a partir do FTP.

Carregue ficheiros utilizando a ação Carregar ficheiro(s) para o FTP e especificando o ficheiro e a localização remota.

Abrir ligação FTP

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

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Host Não Valor de texto Introduza o endereço do servidor FTP aqui.
Port Sim Valor numérico 21 Introduza a porta do servidor FTP aqui.
Active mode N/D Valor booleano Falso Especifique o modo da ligação
Username Não Valor de texto Especifique o nome de utilizador da conta de FTP a utilizar
Palavra-passe Sim Entrada direta encriptada ou Valor de texto Especifique a palavra-passe da conta de FTP a utilizar
Limite de tempo excedido Sim Valor numérico 10 Defina o tempo, em segundos, que pretende esperar que a ligação seja estabelecida antes da ação falhar

Variáveis produzidas

Argumento Tipo Descrição
FTPConnection Ligação FTP A ligação FTP

Exceções

Exceção Descrição
Erro: falha ao iniciar sessão Indicou que o início de sessão falhou
Erro de ligação Indica que existe um problema na ligação

Listar diretório FTP

Esta ação devolve os subdiretórios e ficheiros contidos no diretório atual de uma ligação FTP.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Connection Não Ligação FTP A ligação FTP
Path Sim Valor de texto O caminho que pretende listar.

Variáveis produzidas

Argumento Tipo Descrição
Directories Lista de diretórios FTP Os diretórios listados
Ficheiros Lista de ficheiros FTP Os ficheiros listados

Exceções

Exceção Descrição
Erro de listagem Indica que não foi possível efetuar a listagem da pasta
Erro: não ligado Indica que não existe nenhuma ligação aberta com o servidor FTP
Erro: o diretório não existe Indica que o diretório não foi encontrado

Abrir ligação FTP segura

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

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Host Não Valor de texto Introduza o endereço do servidor FTP aqui.
Port Sim Valor numérico 22 Introduza a porta do servidor FTP aqui.
Active mode N/D Valor booleano Verdadeiro Especifique o modo da ligação
Secure FTP Protocol N/D SFTP, FTPS explícito, FTPS implícito SFTP Escolha o protocolo FTP que pretende utilizar para encriptar a ligação
Authentication method N/D Nome de utilizador e palavra-passe, Chave privada, Chave privada e frase de acesso Nome de utilizador e palavra-passe Escolha o método que pretende utilizar para se autenticar no servidor FTP
User name Não Valor de texto Especifique o nome de utilizador da conta de FTP a utilizar
Palavra-passe Sim Entrada direta encriptada ou Valor de texto Especifique a palavra-passe da conta de FTP que pretende utilizar
Path to private key Não Valor de texto Introduza o caminho do ficheiro da chave privada a utilizar para autenticação
Frase de passe da chave privada Sim Entrada direta encriptada ou Valor de texto Introduza uma variável que contém a frase de acesso da chave privada aqui
Timeout Sim Valor numérico 10 Defina o tempo, em segundos, que pretende esperar que a ligação seja estabelecida antes da ação falhar

Variáveis produzidas

Argumento Tipo Descrição
SftpConnection Ligação FTP Ligação SFTP

Exceções

Exceção Descrição
Erro: falha ao iniciar sessão Indicou que o início de sessão falhou
Erro de ligação Indica que existe um problema na ligação

Fechar ligação

Esta ação fecha uma ligação FTP aberta.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Connection Não Ligação FTP A ligação FTP

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Erro: não ligado Indica que não existe nenhuma ligação aberta com o servidor FTP

Alterar diretório de trabalho

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

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Connection Não Ligação FTP A ligação FTP
Set working directory to Não Valor de texto O caminho a definir como diretório de trabalho

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Erro: não ligado Indica que não existe nenhuma ligação aberta com o servidor FTP
Erro: o diretório não existe Indica que o diretório não foi encontrado
Erro: não é possível alterar o diretório de trabalho Indica que não é possível alterar o diretório de trabalho

Transferir ficheiros a partir do FTP

Transfere um ou mais ficheiros de um servidor FTP.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
FTP connection Não Ligação FTP A ligação FTP para trabalhar. Esta variável tem de ter sido previamente especificada numa ação de ligação Open FTP
Download into folder Não Pasta A pasta de destino dos ficheiros que serão transferidos
Ficheiro(s) a transferir Não Lista de ficheiros FTP O(s) ficheiro(s) a transferir
Tipo de transferência N/D Auto, Binário, ASCII Automático Insira ASCII ou binário para especificar o método para transferir um único ficheiro. Se o tipo de ficheiro for incerto, ou mais de um for transferido, escolha Auto para seguir as regras de transferência especificadas nas opções
If file exists N/D Substituir, Não transferir, Transferir com nome único Substituir Especificar o que fazer se o ficheiro já existir. O Substituir substitui o ficheiro original para que não possa aceder-lhe mais, e transferir com um nome exclusivo adiciona um caráter de sublinhado e um número sequencial ao fim do nome

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Erro: não ligado Indica que não existe nenhuma ligação aberta com o servidor FTP
Erro: o ficheiro remoto não existe Indica que o ficheiro não existe no servidor FTP
Erro: o diretório não existe Indica que o diretório não foi encontrado
Erro: ligação FTP abortada Indica que a ligação FTP foi abortada
Erro: não é possível transferir o ficheiro Indica que não foi possível transferir o ficheiro

Transferir pastas a partir do FTP

Transfere uma ou mais pastas de um servidor FTP.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
FTP connection Não Ligação FTP A ligação FTP para trabalhar. Esta variável tem de ter sido previamente especificada numa ação de ligação Open FTP
Folder(s) to download Não Lista de diretórios FTP O nome dos caminhos das pastas ou as pastas FTP a transferir
Download into local folder Não Pasta O caminho completo do destino das pastas FTP que está a transferir

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Erro: não ligado Indica que não existe nenhuma ligação aberta com o servidor FTP
Erro: o diretório remoto não existe Indica que o diretório não existe no servidor FTP
Erro: o diretório não existe Indica que o diretório não foi encontrado
Erro: ligação FTP abortada Indica que a ligação FTP foi abortada
Erro: não é possível transferir o diretório Indica que não foi possível transferir o diretório

Carregar Ficheiros para FTP

Carrega um ou mais ficheiros para um servidor FTP.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
FTP connection Não Ligação FTP A ligação FTP para trabalhar. Esta variável tem de ter sido previamente especificada numa ação de ligação Open FTP
File(s) to upload Não Lista de Ficheiros Os ficheiros a carregar
Remote location Sim Valor de texto A localização para a qual os ficheiros devem ser carregados
Transfer type N/D Auto, Binário, ASCII Automático Insira ASCII ou binário para especificar o método para transferir um único ficheiro. Se não conhecer o tipo do ficheiro, ou se estiver a transferir vários ficheiros, escolha Automático para seguir as regras de transferência especificadas em Opções
If file exists N/D Substituir, Não transferir, Transferir com nome único Substituir Especificar o que fazer se o ficheiro já existir. O Substituir substitui o ficheiro original para que não possa aceder-lhe mais, e Transferir com um Nome Exclusivo adiciona um caráter de sublinhado e um número sequencial ao fim do nome

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Erro: não ligado Indica que não existe nenhuma ligação aberta com o servidor FTP
Erro: ficheiro não encontrado Indica que o ficheiro não foi encontrado
Erro: ligação FTP abortada Indica que a ligação FTP foi abortada
Erro ao carregar ficheiro Indica que não foi possível carregar o ficheiro

Carregar pastas para FTP

Carrega uma ou mais pastas para um servidor FTP.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
FTP connection Não Ligação FTP A ligação FTP para trabalhar. Esta variável tem de ter sido previamente especificada numa ação de ligação Open FTP
Folder(s) to upload Não Lista de Pastas As pastas a carregar. As pastas que estão a ser carregadas não devem existir previamente no diretório ativo do servidor FTP
Remote location Não Valor de texto A localização para a qual as pastas devem ser carregadas

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Erro: não ligado Indica que não existe nenhuma ligação aberta com o servidor FTP
Erro: o diretório remoto não existe Indica que o diretório não existe no servidor FTP
Erro: ligação FTP abortada Indica que a ligação FTP foi abortada
Erro ao carregar diretório Indica que não foi possível carregar o diretório

Eliminar ficheiro FTP

Elimina um ou mais ficheiros de um servidor FTP.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
FTP connection Não Ligação FTP A ligação FTP para trabalhar. Esta variável tem de ter sido previamente especificada numa ação de ligação Open FTP
Ficheiros a eliminar Não Lista de ficheiros FTP Os ficheiros a eliminar

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Erro: não ligado Indica que não existe nenhuma ligação aberta com o servidor FTP
Erro: ficheiro não encontrado Indica que o ficheiro não foi encontrado
Erro: não é possível eliminar o ficheiro Indica que não foi possível eliminar o ficheiro

Mudar Nome de Ficheiro FTP

Muda o nome de um ficheiro localizado num servidor FTP.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
FTP connection Não Ligação FTP A ligação FTP para trabalhar. Esta variável tem de ter sido previamente especificada numa ação de ligação Open FTP
Ficheiro a mudar o nome Não Ficheiro FTP O ficheiro cujo nome deve ser mudado
Novo nome de ficheiro Não Valor de texto O novo nome do ficheiro. Se introduzir um nome com um caminho, o ficheiro também será transferido para esse local. Se a localização não existir, vai iniciar uma exceção

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Erro: não ligado Indica que não existe nenhuma ligação aberta com o servidor FTP
Erro: não é possível mudar o nome do ficheiro Indica que não foi possível mudar o nome do ficheiro
Erro: ficheiro não encontrado Indica que o ficheiro não foi encontrado

Criar diretório FTP

Cria um diretório num servidor FTP.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
FTP connection Não Ligação FTP A ligação FTP para trabalhar. Esta variável tem de ter sido previamente especificada numa ação de ligação Open FTP
New directory Não Diretório FTP O novo diretório. Se for especificado um caminho, todas as novas pastas que conduzem ao novo diretório serão criadas

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Erro: acesso negado Indica que esta conta não tem acesso para uma operação
Erro: o ficheiro já existe Indica que o ficheiro já existe
Erro ao criar diretório Indica que não foi possível criar o diretório
Erro: o diretório não existe Indica que o diretório não foi encontrado
Erro: não ligado Indica que não existe nenhuma ligação aberta com o servidor FTP

Eliminar diretório FTP

Elimina um diretório de um servidor FTP.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
FTP connection Não Ligação FTP A ligação FTP para trabalhar. Esta variável tem de ter sido previamente especificada numa ação de ligação Open FTP
Directory to delete Não Diretório FTP A pasta a ser eliminada. Todo o conteúdo da pasta também será eliminado

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Erro ao eliminar diretório Indica que não foi possível eliminar o diretório
Erro: o diretório remoto não existe Indica que o diretório não existe no servidor FTP
Erro ao alterar diretório de trabalho Indica que não foi possível alterar o diretório de trabalho
Erro: não ligado Indica que não existe nenhuma ligação aberta com o servidor FTP

Invocar comando de FTP

Invoca o comando de FTP literal indicado no servidor.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
FTP connection Não Ligação FTP A ligação FTP para trabalhar. Esta variável tem de ter sido previamente especificada numa ação de ligação open FTP
FTP command Não Valor de texto O comando a executar juntamente com quaisquer argumentos. Por exemplo, pode executar FEAT, ou CHMOD aqui
Valid reply code(s) Sim Valor de texto Os códigos que podiam ser devolvidos pelo comando, separados por ponto e vírgula. Se o comando FTP devolver um código que não foi introduzido aqui, esta ação iniciará uma exceção. Só se aplica nas ligações FTP ou FTPS simples

Variáveis produzidas

Argumento Tipo Descrição
ReplyCode Valor de texto O código que foi devolvido. Só se aplica nas ligações FTP ou FTPS simples
ReplyText Valor de texto O texto devolvido pelo servidor FTP

Exceções

Exceção Descrição
Erro ao invocar comando Indica que ocorreu um erro ao invocar um comando FTP
Erro: não ligado Indica que não existe nenhuma ligação aberta com o servidor FTP

Sincronizar diretórios

Sincronizar os ficheiros e subdiretórios de uma Pasta indicada com um diretório FTP remoto indicado.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
FTP connection Não Ligação FTP A ligação FTP para trabalhar. Esta variável tem de ter sido previamente especificada numa ação de ligação Open FTP
Synchronization direction N/A Remoto -> local (download), local -> remoto (enviar) Remoto -> local (Transferência) Direção do método de sincronização. Indica se a pasta local será sincronizada com o diretório remoto (TRANSFERÊNCIA) ou se o diretório remoto será sincronizado com a pasta local (CARREGAMENTO)
Files to sync N/D Todos os ficheiros, Apenas ficheiros correspondentes ao filtro de ficheiros, Apenas ficheiros que não correspondem ao filtro de ficheiros Todos os ficheiros Escolha se pretende sincronizar todos os ficheiros ou se pretende usar um filtro de ficheiros para incluir ou excluir um conjunto específico de ficheiros
Filtro de ficheiro Não Valor de texto * Padrão de nome de ficheiro que controla os ficheiros que serão incluídos ou excluídos. Esta opção permite carateres globais, como ".txt" e "document?.doc". A opção também permite vários filtros através da utilização da vírgula como separador: ".txt,*.pdf,document?"
Local folder Não Pasta Nome da pasta local a sincronizar
FTP directory Sim Diretório FTP / Nome do diretório FTP a sincronizar
Delete if source is absent N/D Valor booleano Falso Esta opção eliminará um ficheiro ou uma pasta que exista no diretório de destino e não exista na origem.
Include subdirectories N/D Valor booleano Verdadeiro Esta opção incluirá subdiretórios no processo de sincronização.
Time difference in hours Sim Valor numérico 0 Diferença (em horas) da hora do servidor remoto, caso este esteja noutro Fuso Horário.
Time difference in minutes Sim Valor numérico 0 Diferença em minutos da hora do servidor remoto, caso este esteja noutro Fuso Horário.
Time difference ahead N/D Valor booleano Verdadeiro Especifique se o fuso horário do servidor está à frente ou não.

Variáveis produzidas

Argumento Tipo Descrição
FtpFilesAdded Lista de ficheiros FTP Lista de ficheiros FTP que existiam inicialmente na origem e, após o processo de sincronização, foram adicionados ao destino.
FtpFilesModified Lista de ficheiros FTP Lista de ficheiros FTP que existiam inicialmente na origem e no destino e, após o processo de sincronização, foram adicionados ao destino.
FtpFilesDeleted Lista de ficheiros FTP Lista de ficheiros FTP que existiam inicialmente no diretório de destino e, após o processo de sincronização, foram eliminados.
FilesAdded Lista de Ficheiros Lista de ficheiros que existiam inicialmente na origem e, após o processo de sincronização, foram adicionados ao destino.
FilesModified Lista de Ficheiros Lista de ficheiros que existiam inicialmente na origem e no destino e, após o processo de sincronização, foram adicionados ao destino.
FilesDeleted Lista de Ficheiros Lista de ficheiros que existiam inicialmente no diretório de destino e, após o processo de sincronização, foram eliminados.

Exceções

Exceção Descrição
Erro de listagem Indica que não foi possível efetuar a listagem da pasta
Erro: não ligado Indica que não existe nenhuma ligação aberta com o servidor FTP
Erro: ficheiro não encontrado Indica que o ficheiro não foi encontrado
Erro: ligação FTP abortada Indica que a ligação FTP foi abortada
Erro ao carregar ficheiro Indica que não foi possível carregar o ficheiro
Erro: o ficheiro remoto não existe Indica que o ficheiro não existe no servidor FTP
Erro: não é possível transferir o ficheiro Indica que não foi possível transferir o ficheiro
Erro ao eliminar diretório Indica que não foi possível eliminar o diretório
Erro: falha ao sincronizar Indica que o processo de sincronização falhou devido a um erro inesperado.