4D Doc Center : FTP

4D Internet Commands v14

FTP_Send


FTP_Send ( ftp_ID ; viaLocal ; viaServidor ; progresso ) -> Resultado

Parâmetro	Tipo	Descrição
ftp_ID	Inteiro longo	Referencia de uma conexão FTP
viaLocal	Texto	Via de acesso local do documento a enviar
viaServidor	Texto	Via de acesso do documento no servidor FTP
progresso	Inteiro	1 = Mostrar progresso, 0 = Ocultar progresso
Resultado	Inteiro	Código de erro

Descrição

O comando FTP_Send envia o documento designado por viaLocal à localização designada por viaServidor. É produzido um erro de estado de arquivo FTP, FTP_Send é devolvido imediatamente.

ftp_ID é a referencia inteiro longo da sessão FTP estabelecida com FTP_Login.

viaLocal é a via do documento a enviar. Se passada uma cadeia vazia, aparece a caixa de diálogo padrão de abertura de arquivos. Se viaLocal é um nome de arquivo simples (sem via de acesso), o comando busca este arquivo na pasta que contém o arquivo de estrutura do banco de dados (com 4D autônomo) ou na pasta de 4D Client (com 4D Server). Ao igual que com todas as vias de acesso a documentos locais, os diretórios devem estar separados por um delimitador apropriado para a plataforma. Para obter mais informação, consulte a seção Glossário e terminologia.

Nota: os comandos FTP trabalham com documentos cujos nomes tem uma amplitude limitada. Para obter mais informação, consulte a seção Transferência de arquivos, Apresentação .

viaServidor designa a via de acesso ao formato Unix do documento a criar. viaServidor indica o novo nome do arquivo uma vez recebido pelo servidor FTP. Se viaLocal é uma cadeia vazia que permite ao usuário escolher um arquivo do disco, viaServidor também pode ser uma cadeia vazia, em cujo caso se utilizará o nome do arquivo selecionado.

viaServidor pode ser uma via de acesso Unix completa ou simplesmente um nome de arquivo:

Se passar uma via de acesso completa, o arquivo especificado será localizado no diretório indicado por viaServidor.
Se somente passa um nome de arquivo, ou cadeias vazias na seleção do arquivo, o arquivo será enviado ao diretório de trabalho atual [CWD].

Se o arquivo ou a via não podem ser interpretados corretamente, o comando devolverá um erro. Se o usuário não tem os privilégios suficientes para enviar um arquivo a esse diretório, é devolvido um erro. Ao igual que com todas as vias de acesso aos documentos Unix, a via deve utilizar barras oblíquas como separadores ("/"). Para mais informação, consulte a seção Glossário e terminologia.

Nota: o servidor FTP também pode impor limitações específicas relativas a amplitude ou caracteres para os nomes de arquivo.

O parâmetro progresso indica se o termômetro de progresso. Passe 1 para mostrar termômetro de progresso ou 0 para ocultar.

Exemplo 1

 $OK:=False

 Case of

    :(FTP_Login("ftp.4d.com";"anonymous";vEmailID;vFTP_ID;vFTP_Msg)#0)

    :(FTP_Progress(-1;-1;"Progress window";"Getting requested file…";"Cancel")#0)

    :(FTP_Send(vFTP_ID;"My Hard Drive:Documents:July Sales Report";"/pub/reports/July_sales";1)#0)

    :(FTP_Logout(vFTP_ID)#0)

    Else

       $OK:=True `todos os comandos são executados sem erro

 End case

Nota: para maior informação sobre este uso particular da estrutura Case of, consulte o Apêndice A, Dicas de programação 4D Internet Commands.

Exemplo 2

$error:=FTP_Send(vFTP_ID;"";"";1)