Árvore de páginas

Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 7 Atual »

Faz o download de um arquivo via protocolo SFTP para o Totvs Application Server, utilizando autenticação SFTP por usuário e senha. 

Sintaxe

 nStatus := SFTPDwld1( < sFileName >, < sRemotePath >, < sServer >, < sUser >, < sPassword > , [ @sError] )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

sFileName

caractere

Nome do arquivo a ser criado pelo download.  (**)

X


sRemotePath

caractere

Nome do arquivo – caminho completo – a ser baixado do servidor de SFTP 

X


sServer

caractere

Endereço ( nome do host ou IP ) do servidor de SFTP

X


sUser

caractere

Nome do usuário SFTP para autenticação

X


sPassword

caractere

Senha do usuário SFTP para autenticação

X


sErrorcaractere Obtém por referência uma string contendo detalhes em caso de falha na execução da função
X

(**) O nome do arquivo segue o padrão de arquivos a partir do ROOTPATH do ambiente em uso no Totvs Application Server. 

Retorno

Tipo

Código de Status

Descrição do Status

numérico

0

Sucesso na operação
numérico-1111

Caminho de arquivo inválido
numérico-1112Falha ao abrir o arquivo
numérico79Erro na camada SSH
numérico82O servidor rejeitou a chave pública fornecida
numérico83Chave de host inválida
numérico84Nome de usuário ou senha inválidos
numérico85Falha ao inicializar o SSH
numérico86Erro ao ler o arquivo local para upload SFTP
numérico87Erro SSH geral
numérico88Falha ao carregar uma biblioteca libcurve necessária
numérico89Erro com o arquivo de hosts conhecidos
numérico90Erro do agente SSH
numérico91A chave pública do host remoto não foi encontrada
numérico92A conexão com o host remoto foi negada
numérico93Ocorreu um erro de protocolo SSH
numérico94Caminho de arquivo inválido para operação SFTP
numérico96Autoridade de certificação desconhecida no SSH
numérico101O acesso ao recurso remoto foi negado
numérico102A chave pública fornecida para autenticação não foi verificada

Exemplos

Exemplo de implementação do download de arquivo utilizando autenticação por usuário e senha. 

user function exemplo()
local nStatus, cErrorMsg := ''

// O exemplo abaixo faz download do arquivo "meufile.txt", localizado no servidor de sftp "cloud1.dominio.com"
// no caminho "/home/user/", criando o arquivo "meuarquivo.txt" na pasta "\downloads\" 
// a partir do RootPath do ambiente do TOTVS Application Server em uso .

nStatus := SFTPDwld1("\downloads\meuarquivo.txt", "/home/user/meufile.txt", "cloud1.dominio.com", "user", "password", @cErrorMsg)

if ( nStatus != 0 )
	Conout("Não foi possível transferir o arquivo : Erro "+cErrorMsg)
endif

return

Abrangência

Função disponível, na linguagem TLPP, para build superior a 19.3.1.7.

IMPORTANTE: Utilizar preferencialmente na linguagem TLPP pois o suporte desta função no AdvPL está sendo descontinuado.

  • Sem rótulos