O PDF é o tipo de arquivo mais utilizado no mundo pela sua facilidade de utilização e conservação do conteúdo dentro da estrutura, mesmo que abra um arquivo deste formato num computador super antigo.
Independente da demanda, o PDF é crucial e para isso, o Mendix tem um widget (um tipo de componente) que pode gerar um PDF para o sistema. Para esta funcionalidade recomenda-se ter no mínimo a versão do Mendix Studio Pro 9.24.0.
As imagens que contém neste artigo é de um sistema em exemplo que faz cadastro de produtos utilizados dentro de um escritório, ou seja, é um controle de ativos.
Instalação
Abra a aba de “Marketplace” dentro do seu aplicativo Mendix através do Studio Pro e pesquise “PDF Document Generation”. Verá o seguinte módulo para ser instalado:
Configuração
Na aba “App Explorer” no painel lateral esquerdo, abra as configurações, nomeado como “Settings” e selecione a aba de RunTime. Configure o campo “After Startup” selecionando o microflow ASu_DocumentGeneration_Initialize, que é uma ação feita em Java que gera documentos.
Após salvar o microflow na aba de RunTime, verifique a segurança do aplicativo. Clique duas vezes em “Security”, ainda no “App Explorer”, e selecione o nível de segurança para prototype/demo ou production. Em seguida, clique na aba “User roles” e siga estes passos:
- Na user role Administrator, clique em “Edit”, depois clique no módulo “DocumentGeneration” onde aparecerá uma lista com tipos de perfis do módulo. Em seguida selecione os dois perfis e depois clique em “Ok” para salvar. Se selecionar apenas o perfil “Administrator”, ao gerar o documento, pode dar erro de permissão pois apenas o user tem esta ação, já o administrador tem outros privilégios.
- Com a user role User faça o mesmo caminho que o ponto anterior, porém selecione o perfil “User” e depois clique em “Ok” para salvar.
Progresso
Crie uma entidade com a generalização do tipo “FileDocument” que corresponde a arquivos no Mendix:
Na página que deseja que os dados virem um PDF, coloque um botão, em “On click” selecione a ação de chamar uma microflow e crie uma nova no mesmo módulo que está a página que criou o botão. Por questões de boa prática, este botão é uma ação, ou seja, coloque a sigla “ACT” como prefixo e sua função como nome.
Criação da Microflow de gerar PDF
A primeira atividade é pegar o objeto que deseja virar um documento em PDF. No exemplo, foi utilizado uma ação do tipo: “Call a Microflow” que chamou um fluxo baixando um objeto da entidade produto. Depois, coloque uma atividade de “Commit” e selecione o objeto que foi chamado como parâmetro do microflow (diretamente na página). Utilize uma atividade dentro da microflow chamada: Java Action trazendo a função: “EndTransaction” para finalizar a transação do objeto para os dados do documento. Enfim, coloque a atividade “Generate PDF From Page”.
O “Generate PDF From Page” abre um pop-up com algumas configurações:
- Page microflow: Selecione uma microflow que abrirá uma página que deseja exportar como um PDF, ele tem que ter nenhum ou um parâmetro do tipo objeto.
- Context Object: Selecione o objeto que você quer que seja o parâmetro da microflow que foi selecionada anterior, os dois tem quer ser iguais.
- Result Entity: Escolha uma entidade que é especializada de “FileDocument”. Com isto, vai gerar o resultado do objeto da que foi selecionada como um documento. Tenha a certeza de que o usuário tem a devida permissão de acesso se quiser fazer o download do documento.
- File name: Prover o nome do arquivo.
- Genereate as user: Prover que o objeto usuário para gerar o arquivo
A última atividade da microflow é o “Download file”, traduzindo para o português, essa ação baixa o arquivo. No final a microflow deve estar assim:
Edição da estrutura da página
Ao clicar na página que deseja fazer a exportação de PDF, entre na aba de “Styling” e ative a opção “Enable PDF export”, escolha a orientação da página (retrato que fica na vertical ou na paisagem que fica na horizontal), o tamanho da página (é recomendável ser A4) e se deseja apresentar o número de página o que é opcional.
Conclusão
O que pode ser desafiador no desenvolvimento de um sistema tradicional é simplificado no Mendix, que oferece a praticidade de empregar um único módulo e a lógica intuitiva para criação de microflows. Resultando uma criação de um dos tipos de arquivos mais compartilhados no mundo.
