Conectores
Dados e Armazenamento
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" "kevin lynch\@email com", "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