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:

Image Added

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 arquivo e obtenha 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).

Image Added

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).

Image Added