Função

O componente envio de arquivo é utilizado para fazer o upload de arquivos de tipos variados (.txt, .png, .jpg, .pdf, etc.), podendo ser adicionado dentro de pastas no seu projeto ou até mesmo em locais externos.

Figura 1 - Exemplo do componente rodando no Browser

Principais propriedades

Na tabela abaixo estão descritas as principais propriedades do componente.

Utilizando via Diagrama

Para utilizar o componente de arquivo no Cronapp você poderá gerá-lo através do CRUD no Diagrama com os atributos do Tipo Arquivo no Banco ou Arquivo no Cloud (para saber como configurar atributos no Cloud acesse a documentação).

Figura 2 - Atributos Arquivo Banco e Cloud

Após configurar seus atributos na entidade, clique com o botão direito do mouse sobre a entidade e selecione a opção Criar visão para a entidade (Figura 3).

Figura 3 - Criando visão para a entidade

Em seguida rode o projeto, acesse a página da sua entidade e clique no botão adicionar para visualizar o componente arquivo gerado pelo CRUD no Cronapp (Figura 4).

Figura 4 - Componentes Arquivo gerados pelo CRUD.

Utilizando de forma independente

Como alternativa ao uso via Diagrama siga os passos abaixo para utilizar o componente envio de arquivo dinâmico no seu projeto:

• Arraste o componente envio de arquivo dinâmico para a view;
• Arraste o componente botão para a view;

Figura 5 - Arrastando componentes para view

Upload do arquivo

• Rode seu projeto;
• Acesse a view criada (no exemplo acima upload);
• Clique sobre o componente para fazer upload de um arquivo do seu computador.

Figura 6 - Exibição de dados do arquivo após upload feito

Após realizar o upload do arquivo o Cronapp irá colocá-lo temporariamente no diretório:

/project/target/tomcat/temp/CRONAPI_RECYCLE_FILES

Criando dois arquivos de referência: um .bin que traz o conteúdo do arquivo e outro .md que traz as informações do arquivo como nome e tipo.

Persistindo Arquivo

Para que você persista seu arquivo em uma pasta do seu projeto será necessário a criação de um bloco de programação do tipo servidor

• Crie um novo bloco do tipo servidor com nome do arquivo Salvar e Nome da Função mover
• Acesse a aba de Propriedades do bloco de programação
• Clique sobre formulário de referência e selecione Upload

Figura 7 - Selecionando view ao bloco

Para desenvolver a lógica do bloco de programação mover siga os passos abaixo:

Figura 8 - Função mover

1. Defina uma variável com nome dadosArquivo e obtenha o valor selecionando o campo do Envio de Arquivo Dinâmico, no nosso exemplo renomeamos o valor do campo para arquivoDinamico;
2. Defina uma variável com nome info quer irá receber informações em formato JSON da variável dadosArquivo;
3. Defina uma variável com nome transfere quer irá receber um retorno verdadeiro ou falso:
   1. Adicione o bloco Mover arquivo:
      1. No Caminho de origem Adicione o bloco criar texto com Pasta reciclável da aplicação / campo path do JSON da variável info a ser levado para Pasta da aplicação.
      2. No Caminho de destino adicione o bloco Pasta da aplicação onde será persistido o nosso arquivo.
4. Adicione o bloco condicional se faça para validar se o valor da variável transfere é verdadeiro significando assim que a transferência foi feita com sucesso.
5. Após a transferência ser concluída iremos executar a renomeação do arquivo para o nome original dele dentro do faça, pois para evitar duplicidade no upload o Cronapp definiu seu nome como uma série de números + .bin
6. Defina uma variável com nome renomeia;
7. Adicione o bloque Renomear arquivo
   
   1. Caminho do arquivo iremos passar o caminho onde ele se encontra
      1. Pasta da aplicação / campo path do JSON da variável info
   2. Novo nome criaremos com o campo name e com o campo fileExtension que se encontra no JSON da variável info

Para que seu bloco seja executado você deverá vincular ao botão Salvar Arquivo criado na view Upload (Figura 9).

Figura 9 - Selecionando view ao bloco

Teste

Por fim rode o projeto, acesse a view, faça o upload de um arquivo e clique no botão Salvar Arquivo. Acesse a IDE clique com o botão direito em cima do nome do projeto e selecione Recarregar após isso você já conseguirá ver seus arquivos na pasta da aplicação (Figura 10).