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.
Acesse o tópico "Upload de arquivos" na página Arquivos para conhecer outras formas de fazer upload no Cronapp.
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 |
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.
Figura 1 - Bloco de programação
Ao executar o bloco um modal será aberto, clique no centro para abrir a janela de seleção de arquivos.
Figura 2 - Modal do bloco para seleção do 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.
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.