Como Gerar um PDF no Mendix , Guia Completo.
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.
Keep exploring
â“ Perguntas Frequentes
O que é necessário para gerar um PDF no Mendix?
à‰ necessário ter no mínimo a versão do Mendix Studio Pro 9.24.0 e instalar o widget ‘PDF Document Generation’ através do Marketplace.
Como posso configurar o microflow para a geração de PDF?
Na aba ‘App Explorer’, abra as configurações ‘Settings’ e selecione a aba de RunTime. Configure o campo ‘After Startup’ selecionando o microflow ASu_DocumentGeneration_Initialize.
Qual é a importância do formato PDF?
O PDF é o tipo de arquivo mais utilizado no mundo pela sua facilidade de utilização e pela conservação do conteúdo, mesmo em sistemas mais antigos.
Related Articles
Discover the power of Mendix
