Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Trasfere um arquivo do servidor remoto para a máquina local.

Sintaxe

TSFTPClient():ReceiveFile( < cRemoteFile >, < cLocalFile > )

Parâmetros

Os parâmetros que esta função recebe são descritos abaixo:

NomeTipoDescriçãoObrigatórioReferência
cRemoteFilecaractereCaminho completo (pasta + nome do arquivo) do arquivo no servidor remoto que será transferido.X
cLocalFilecaractereCaminho completo (pasta + nome do arquivo) que será dado ao arquivo na máquina local.X

Retorno

Conforme a Tabela abaixo esta função retornará os seguintes valores numéricos. Além disso, o console.log conterá informações importantes adicionais caso for detectados erros.

RetornoTipoDescrição
nRetnuméricoStatus da tentativa de transferência do arquivo do servidor para máquina local.

Exemplo

user function sftp_download1()

  local nRet1, nRet2
  local oSftp1 := tSFTPClient():new()
  
  nRet1 := oSftp1:Connect("server1.exemplo.local.br","2222","josevitor", "Fs74!@bz*@54/")
  if (nRet1 <> 0)
    ConOut("Falha em conectar ao servidor SFTP.")
    return .F.
  endif

  nRet2 := oSftp1:ReceiveFile("downloadedTLPP_OK.txt","./somefileA.txt")
  if (nRret2 <> 0)
    ConOut("Falha em transferir um arquivo do servidor SFTP.")
    return .F.
  endif

return .T.

Observação

Caso o arquivo apontado por cLocalFile já exista, ele será sobrescrito. Esse caminho é relativo ao ROOTPATH do Application Server. Caso o caminho de diretório não exista, a função retornará um código de erro.

Lista de códigos de erros e seus respectivos significados

CódigoSímboloDescrição
0SFTP_RECEIVEFILE_OKOperação de transferência de arquivo executada com sucesso
-24SFTP_SFTP_REMOTE_PATH_FAILCaminho de diretório não reconhecido no servidor SFTP
-23SFTP_SFTP_OPEN_FILE_FAILFalha na abertura do arquivo do servidor para iniciar a transferência
-26SFTP_TIMEOUT_FAILTempo de transferência excedido