FTP

19 min

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.

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.

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.

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

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

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).

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.

Operação CreateFileBase64 - FTP

Descrição

A operação Criar um arquivo base64 do conector FTP permite criar arquivos no servidor FTP a partir de conteúdo codificado em base64. Esta operação é especialmente útil para enviar arquivos binários (como imagens, documentos PDF, planilhas Excel) ou qualquer tipo de arquivo que tenha sido previamente convertido para base64.

Parâmetros de Entrada

A operação CreateFileBase64 requer os seguintes parâmetros:

Campos Obrigatórios

Campo	Tipo	Descrição
Caminho do diretório	string	Caminho do diretório no servidor FTP onde o arquivo será criado
Nome do arquivo de saída	string	Nome do arquivo a ser criado no servidor FTP
Arquivo	string	Conteúdo do arquivo codificado em base64

Exemplo de JSON de Saída

Resposta de Sucesso

{
  "message": "Arquivo exemplo.txt criado no FTP com sucesso a partir do base64."
}

Resposta de Erro - Base64 não fornecido

{
  "error": "base64 não fornecido"
}

Resposta de Erro - Base64 inválido

{
  "error": "erro ao decodificar base64: illegal base64 data at input byte 12"
}

Resposta de Erro - Falha na conexão FTP

{
  "error": "failed to connect to FTP server: dial tcp 192.168.1.100:21: connection refused"
}

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:

{
  "id": 53,
  "uid": "d774bc23-9b40-406f-9d38-4fd40ca66b70",
  "password": "wecZtfC46B",
  "first_name": "Kevin",
  "last_name": "Lynch",
  "username": "kevin.lynch",
  "email": "[email protected]",
  "address": {
    "city": "Samton",
    "state": "Colorado",
    "country": "United States"
  },
  "subscription": {
    "plan": "Starter",
    "status": "Blocked"
  }
}

Dicas e considerações

Certifique-se de que as credenciais de acesso FTP configuradas tenham permissão para as operações desejadas (leitura/escrita).
Use nomes dinâmicos para arquivos quando houver necessidade de evitar duplicações.
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.