TOTVSTEC

Árvore de páginas

Versões comparadas

Versão antiga 2

changes.mady.by.user Danilo Coimbra Sigolo

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Felipe Andrade Allemand Borges

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Complementando a tabela de erros

...

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

Sintaxe

Bloco de código
collapsefalse
 nStatus := SFTPDwld1( < sFileName >, < sRemotePath >, < sServer >, < sUser >, < sPassword > , [ @sError] )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

sFileName

caractere

Caminho completo Nome do arquivo a ser salvo no seu computadorcriado pelo download.  (**)

X


sRemotePath

caractere

Caminho completo Nome do arquivo – caminho completo – a ser baixado do servidor remotode SFTP 

X


sServer

caractere

Endereço ( nome do servidor remotohost 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

nResult

NomeTipoTipo

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érico67Servidor remoto rejeitou a conexão
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

-1 = Falha na requisição

-2 = Falha na abertura do arquivo

Exemplos

Exemplo de implementação do download de arquivo utilizando autenticação por usuário e senha. Ao testar esta função favor apontar para um servidor com o SSHD presente e utilizar um nome de usuário e senha válidos. 

Bloco de código
languagecpp
themeEclipse
linenumberstrue
collapsefalse
user function exemplo()

status
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", "passwaordpassword", @cErrorMsg)

if (!status nStatus != 0 )
	Conout("SucessoNão foi aopossível transferir o arquivo :D Erro "+cErrorMsg)
endif

return

Abrangência

...