Upload de Arquivo
Faz o upload de um arquivo armazenado na máquina do usuário.
| Informações | ||
|---|---|---|
| ||
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
| Nome | Tipo | Doc |
|---|---|---|
| Descrição | String | Descrição a ser apresentada no janela de seleção do(s) arquivo(s) |
| Filtros | String | Tipo(s) de arquivo(s) permitido(s) para envio |
| Tamanho máximo | String | Tamanho máximo de cada arquivo a ser enviado |
| Múltiplos | Objeto | Valor a ser definido na função que possibilita o envio de múltiplos arquivos |
| Após envio | Comandos | Comandos a serem executados após o envio do arquivo |
| Nota | ||
|---|---|---|
| ||
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.
| Aviso | ||
|---|---|---|
| ||
|
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.
| Informaçõ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.
O parâmetro Filtro também aceita MIME Types,
Assim, ao invés de inserir diversas extensões do tipo imagem, basta inserir o MIME Types: image/*. Serão aceitas extensões de imagens, como .png, .jpg, .svg, .git, .bpm e outras.
Acesse o link maiores informações sobre MIME Types.