Á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 2 Próxima »

Função: CpyT2S

Copia um arquivo (compactado ou não) do client (Remote) para o servidor.

CpyT2S ( < cOrigem>, < cDestino>, [ lCompacta] ) --> lRet

 

NomeTipoDescriçãoObrigatórioReferência
cOrigemCaracterIndica o nome do arquivo será copiado, além de aceitar caracteres curingas (* e ?).X 
cDestinoCaracterIndica o diretório de destino dos arquivos no servidor.X 
lCompactaLógicoIndica se o arquivo deve ser internamente compactado antes de fazer a cópia. Default = .T. ( verdadeiro )  

 

lRet
    (lógico)
  • Retorna, verdadeiro (.T.), se o arquivo for copiado com sucesso
  • Retorna falso (.F.), em caso de falha na cópia.

Caso a compactação esteja habilitada ( Default = .T. ) , no parâmetro <lCompacta>, o arquivo será compactado automaticamente no client antes do envio, e descompactado automaticamente no servidor. Para a grande parte dos tipos de arquivo, utilizar a compactação reduz o tempo de cópia, pois o conteúdo trafegado pela rede é menor. Para tráfego de arquivos que já possuem algum tipo de compressão de dados ( ZIP, TAR, RAR, JPG, MPG ), é mais eficiente especificar este parâmetro com .F., para que a compactação automática não seja utilizada, pois nestes casos a mesma não agregará nenhum ganho neste processo.

O diretório no destino (servidor) deve existir para que a cópia seja realizada com sucesso. Caso a cópia falhe, para identificação do motivo do erro, a função FError deve ser chamada.

// Copia arquivos do remote local para o servidor, compactando antes de transmitir
CpyT2S( "C:\TEMP\MANUAL.DOC", "\BKP" )

// Copia arquivos do remote local para o servidor, sem compactar antes de transmitir
CpyT2S( "C:\TEMP\MANUAL.DOC", "\BKP", .F. )

Quando o SmartClient utilizado for uma build nativa Linux ou Mac, sabe-se que sistema de arquivos destas plataformas não têm unidade de disco, a nomenclatura dos arquivos é case sensitive ( letras minúsculas diferente de maiúsculas ), e as barras separadoras de diretório / pasta são barras normais "/" ao invés de barras inversas "\". Mesmo nestes casos, deve-se especificar uma letra de unidade de disco no diretório de destino; pois quando o SmartClient em Linux e/ou Mac receber o diretório de destino, com a unidade de disco especificada, a unidade de disco será ignorada e as barras serão internamente invertidas.

Por exemplo, a cópia especificando o path de destino "C:\USER\LOCAL\TEMP\" será interpretado pelo smartclient Linux e/ou Max como "/user/local/temp/"

Advanced Protheus 6.09 , Advanced Protheus 7.10 , Microsiga Protheus 8.11 , Protheus 10 , TOTVS Application Server 10 , ByYou Application Server
 
  • Sem rótulos