FTP

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.

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.

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

Importante

A partir da versão 2.56, o Power Automate para computadores deixa de suportar algoritmos de cifra legados que são preteridos em ações SFTP (Secure FTP). Esta atualização destina-se a aumentar a segurança ao remover métodos criptográficos desatualizados.

Os seguintes algoritmos já não são suportados:

• blowfish-cbc
• twofish-cbc
• twofish192-cbc
• twofish128-cbc
• twofish256-cbc
• arcfour
• arcfour128
• arcfour256
• cast128-cbc
• hmac-sha2-512-96
• hmac-sha2-256-96
• hmac-sha1-96
• hmac-md5
• hmac-md5-96
• hmac-sha1-96-etm
• hmac-md5-etm
• hmac-md5-96-etm

Utilizadores que confiam exclusivamente em algoritmos de codificação preteridos para os seus servidores SFTP podem enfrentar fluxos com falhas ao executar ações SFTP na versão 2.56 do Power Automate para computadores porque estes servidores não são compatíveis com a biblioteca atualizada.

Para garantir uma experiência totalmente integrada e evitar interrupções ao fluxo de trabalho, siga estes passos:

• Verifique que algoritmos de cifra são suportados pelo seu servidor SFTP.
• Se o servidor usar algoritmos de cifra preteridos, atualize-o para suportar algoritmos de cifra modernos e seguros.
• Consulte a sua equipa de TI ou fornecedor de servidor SFTP para obter orientação sobre como atualizar as capacidades criptográficas do servidor.
• Evite instalar a versão 2.56 ou posterior até que os servidores SFTP sejam migrados para uma versão compatível.

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.