Pular para o conteúdo principal

S-FTP Out

Configuração atual da tarefa S-FTP Out no Workflow Designer

A Tarefa “S-FTP Out” permite carregar de forma segura um ou mais ficheiros para um servidor remoto utilizando o protocolo SFTP (Secure File Transfer Protocol). É um componente essencial para automatizar a transferência de dados, relatórios ou qualquer outro ficheiro gerado pelo Workflow para sistemas externos.

Configuração​

A configuração da Tarefa está dividida em duas secções principais: a autenticação para a ligação e os detalhes do ficheiro a ser transferido. Os campos de configuração da Tarefa podem ser preenchidos manualmente ou através de parâmetros e variáveis do fluxo de trabalho.

Autenticação​

Define o método pelo qual o Workflow se autenticará junto do servidor SFTP.

  • Método de Autenticação: É possível escolher entre:
  • Password: A autenticação ocorrerá através da palavra-passe associada ao utilizador.
  • Chaves SSH: A autenticação ocorrerá através de um par de chaves SSH (pública/privada). Este é o método mais seguro e recomendado para automações.
  • Host: O endereço IP ou o nome DNS do servidor SFTP ao qual se conectar.
  • Porta: A porta de comunicação para a ligação SFTP. O valor padrão é 22.
  • User: O nome de utilizador para a ligação.

Parâmetros de Upload​

Especifica qual ficheiro transferir e onde o posicionar no servidor remoto.

  • File to transfer: O caminho completo do ficheiro local (no sistema onde o Workflow está a correr) que deve ser carregado.
  • Remote path: O caminho do diretório no servidor SFTP onde o ficheiro será carregado.

Parâmetros de Output​

Após tentar a operação de upload, a Tarefa expõe os seguintes parâmetros de saída, que são fundamentais para verificar o resultado da transferência.

  • result: Contém uma mensagem de texto que descreve o resultado da operação.
  • Exemplo de sucesso: "Transferência realizada com sucesso"
  • Exemplo de falha: "Erro de Autenticação com utilizador [NomeUtilizador] e palavra-passe" ou "Erro na transferência do ficheiro [NomeFicheiro]"
  • resultJson: Representa o resultado da execução da tarefa em formato JSON, incluindo informações gerais, configurações e detalhes da execução.
  • ftpOutFile: Retorna o nome do ficheiro tal como foi transferido para o servidor remoto.
  • ftpOutPath: Retorna o caminho do diretório remoto onde o ficheiro foi carregado.