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.