Conectores
Core

FTP

13min

Objetivo

O conector FTP (File Transfer Protocol) é projetado para facilitar a transferência segura de arquivos entre sistemas e servidores remotos. Ele permite operações como upload (envio) e download (recebimento) de arquivos por meio de conexões criptografadas, garantindo a integridade e a segurança das informações. Ideal para integração entre sistemas que demandam troca de arquivos sensíveis ou automação de processos, o conector FTP simplifica a manipulação de arquivos em ambientes distribuídos.



Criando uma conexão

Antes de usar o conector FTP, é necessária a criação de uma conexão. Vamos lá.

  • Clique em Propriedades.
  • Em Selecionar uma conexão clique em Criar nova conexão.
Document image

  • Vamos preencher os dados da conexão.
  • Caso tenha necessidade, este conector tem suporte ao protocolo de segurança TLS
  • Com dados de sua conexão preenchidos, clique em Salvar conexão.
Document image


Agora você já pode montar seus fluxos utilizando o Conector FTP.



Como utilizar o Conector FTP

Exemplo prático: criar um arquivo JSON em um servidor FTP a partir de uma requisição HTTP.

  • Configuração do Fluxo
    • No Canvas, adicione dois conectores: um HTTP e outro FTP.
    • Conecte os dois passos no fluxo conforme a imagem abaixo.
Document image

  • Aba Parametrização: Utilize o método GET e insira uma URL de exemplo que forneça dados aleatórios.
Document image

  • Aba Propriedades: Informe apenas o nome do passo, já que nenhuma autenticação adicional é necessária.
Document image

  • Configuração do Conector FTP
    • Operação: Escolha Criar Arquivo.
    • Caminho do Arquivo: Insira o caminho relativo no servidor FTP onde o arquivo será salvo. Certifique-se de que o diretório exista e tenha permissão de escrita (ex.: fluid).
Document image

  • Nome do Arquivo: Configure o nome como fixo ou dinâmico. Neste exemplo, utilizamos um campo uid da requisição HTTP para criar nomes únicos.
  • Conteúdo do Arquivo: Escolha salvar o payload completo da requisição HTTP ou apenas campos específicos. Para salvar como JSON, utilize a função getJsonEscaped.
  • Resultado Final
    • Após executar o fluxo, um arquivo chamado d774bc23-9b40-406f-9d38-4fd40ca66b70.json será salvo no servidor FTP.
Document image



Outras operações disponíveis

O conector FTP suporta diversas operações para diferentes necessidades:

  • Criar Diretório: Insira o caminho do diretório a ser criado.
  • Criar Arquivo: Salve dados em um arquivo no servidor.
  • Listar Arquivos: Obtenha uma lista de arquivos em um diretório.
  • Ler Arquivo: Recupere o conteúdo de um arquivo no servidor.
  • Excluir Arquivo: Remova arquivos indesejados.


Exemplo de payload

A seguir, um exemplo do payload retornado pela requisição HTTP que foi usado para gerar o arquivo JSON:

JSON


Dicas e considerações

  1. Certifique-se de que as credenciais de acesso FTP configuradas tenham permissão para as operações desejadas (leitura/escrita).
  2. Use nomes dinâmicos para arquivos quando houver necessidade de evitar duplicações.
  3. Sempre teste o fluxo antes de colocá-lo em produção para verificar permissões e caminhos corretos.

Conclusão

O conector FTP é uma ferramenta poderosa para manipulação de arquivos em integrações complexas. Com ele, você pode criar fluxos que automatizam o envio e recebimento de dados de forma segura, eficiente e personalizável.

Updated 23 Jan 2025
Doc contributor
Doc contributor
Doc contributor
Did this page help you?