Page tree
Skip to end of metadata
Go to start of metadata

Upload de Arquivo

Faz o upload de um arquivo armazenado na máquina do usuário.

Mais sobre

A função Upload de Arquivo é assíncrona, ou seja, retorna de forma imediata para que o fluxo de execução do programa possa realizar outras operações.

Parâmetros de Entrada

NomeTipoDoc
DescriçãoStringDescrição a ser apresentada no janela de seleção do(s) arquivo(s)
FiltrosStringTipo(s) de arquivo(s) permitido(s) para envio
Tamanho máximoStringTamanho máximo de cada arquivo a ser enviado
MúltiplosObjetoValor a ser definido na função que possibilita o envio de múltiplos arquivos
Após envioComandosComandos a serem executados após o envio do arquivo

Obs.:

Caso o valor do parâmetro Múltiplos seja definido como "Sim" a função permite o envio de múltiplos arquivos de uma só vez. Caso o valor seja "Não" apenas o envio de um arquivo por vez é permitido.

Retorno

A variável padrão item armazena o retorno da função de upload. Esse retorno é um array representando o diretório completo e temporário do(s) arquivo(s) selecionado(s) para envio.

Nota

  • É necessário que o usuário manipule o(s) arquivo(s) de forma imediata, definindo as ações a serem executadas sobre o(s) arquivo(s) no parâmetro Após envio. (callback)
  • Os arquivos são apagados logo após a execução dos comandos definidos no parâmetro Após envio. (callback)

Compatibilidade

 Servidor

Exemplo 1

A função abaixo em destaque faz o upload de um arquivo por vez, desde que atenda os filtros referente aos tipos de arquivo (.doc,.pdf,.png) e tamanho máximo de 5MB. Observe que nesse exemplo o arquivo é movido do seu diretório temporário para um diretório fixo dentro da estrutura de arquivos do projeto através da função Mover arquivo.


 

 

 

 

 

 

 


Sobre Upload

O processo de upload pode ser definido como o envio de dados para um sistema remoto, como um servidor ou outro cliente para que o sistema remoto possa armazenar uma cópia desses dados.

Extensão de Arquivos(Filtros)

A extensão de um arquivo é um identificador especificado como um sufixo para o nome de um arquivo digital,  indicando a característica do conteúdo ou seu uso pretendido. Uma extensão de arquivo normalmente é delimitada a partir do nome do arquivo com um ponto(.), como por exemplo(nomeArquivo.txt). A função Upload de Arquivo permite a passagem de filtros contendo as extensões aceitas no processo de upload. 

Exemplo de extensões

.pdf, .xls, .doc, .ppt, .avi, .mpeg, .jpg, .jpeg, .gif, .mp4, .png, .csv e etc.

Pode-se definir mais de um tipo de arquivo/extensão no parâmetro Filtros da função. Para isso basta utilizar o caractere virgula(,) como separador das extensões.

 

 

 

 

 

 


  • No labels