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

Função: CpyS2T

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

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

 

NomeTipoDescriçãoObrigatórioReferência
cOrigemCaracterIndica o nome do arquivo que será copiado.X 
cDestinoCaracterIndica o nome do diretório de destino na estação Client (Remote).X 
lCompactaLógicoIndica se o arquivo deve ser internamente compactado antes de fazer a cópia. Default = .T. ( verdadeiro )  

 

lRet
    (logico)
  • 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 servidor antes do envio, e descompactado automaticamente no Client. 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 (client) 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.

Exemplos

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

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

Informações adicionais

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