Documentação

15 Desenhos em lote

Este tipo de página permite criar desenhos em lote. Como visto na seção "Desenhos", em uma aplicação de negócio muitas vezes é necessário gerar capas de livros financeiros, capas de arquivos físicos, capas de embalagens, anúncios, banners, dentre outros impressos.

Páginas do tipo "Desenho em lote" permitem ao usuário realizar um filtro sobre uma tabela e gerar um único arquivo PDF com um lote de desenhos, onde cada página contém o desenho relativo à um registro da tabela da base de dados.

Desenho em lote

15.1 Criação

Para criar um desenho em lote, deve ser utilizada a opção “Nova página”, e em seguida, selecionar "Desenho". Após, será aberto um diálogo com informações necessárias para a criação. Para criar um desenho, deve-se informar respectivamente:

  1. A base de dados desejada.

  2. A tabela que o documento buscará as informações.

  3. O desenho modelo a ser utilizado.

  4. Informar se a página será pública. Páginas públicas são acessíveis para usuários não logados na aplicação.

  5. O nome que será exibido no menu da aplicação referente a página.

  6. O nome da classe controladora do documento.

  7. O módulo em que a página ficará agrupada.

  8. Informar se a página aparecerá no menu da aplicação.

15.2 Utilização

Para utilizar esta opção, o desenvolvedor deverá ter criado previamente uma página do tipo "Desenho", pois a página "Desenho em lote" fará uso das definições já realizadas, apontando para um desenho existente. A interface para criação de "Desenho em lote", exibirá ao topo um formulário de filtro contendo os campos da tabela sobre a qual o desenho está sendo construído, e na parte central da tela, uma visualização rápida do próprio desenho, que já fora definido em outra página do tipo "Desenho". O usuário poderá utilizar o botão "Editar desenho" para editar o desenho de referência. Uma nova janela será aberta para ajustes no desenho.

15.3 Filtros de campos

Ao trabalhar com um desenhos em lote, o usuário poderá filtrá-lo com base nos campos do formulário de filtro localizado na parte superior da tela. Neste formulário, o desenvolvedor pode acrescentar novos campos de filtro. Para cada campo, será necessário configurar a maneira que o mesmo será utilizado como filtro. Para tal, é necessário clicar sobre o campo, e em seguida acessar a aba "Filtros". Os filtros mais simples são do tipo "Comparação direta", que permite comparar uma coluna do banco com o campo selecionado do formulário. Um exemplo seria filtrar por tipo de venda em um relatório de vendas, sendo que existe um campo para o tipo de venda naquela tabela. O filtro do tipo subconsulta, permite comparar o campo do formulário com um campo relacionado da tabela exibida no relatório. Um exemplo seria uma datagrid de vendas que deve ser filtrada pelo estado do cliente. Neste caso, bastaria acrescentar uma combo de estados no formulário e preencher "Coluna do banco de dados" com o campo que representa o estado do cliente relacionado com a venda, por meio do relacionamento entre campos (venda→cliente → cidade→ estado→id). Assim, o filtro é estabelecido entre o estado selecionado no formulário, e o estado do cliente vinculado àquela venda.

15.4 Filtros de carregamento

Enquanto que os campos do formulário sobre o desenho permitem o usuário realizar uma filtragem dinâmica em tempo de execução sobre o relatório, existe também a pré-filtragem do desenho em lote, que permite estabelecer filtros "fixos", executados independentemente dos filtros do usuário. Para definir estes filtros, basta clicar sobre o ícone chamado "filtros" à direita da visualização do desenho. Nesta aba, podem ser realizados filtros de "comparação direta" entre uma coluna do banco de dados, e um valor de filtro (que pode ser fixo ou uma variável de seção). Variáveis de seção contém informações do usuário logado e também podem ser utilizadas como filtro. Já o filtro do tipo "subconsulta" permite estabelecer um filtro entre um campo relacionado à tabela em questão e um valor (que pode ser fixo ou variável de seção).

Um exemplo seria um relatório de vendas em que é necessário ter um pré-filtro fixo pelo estado do cliente da venda. Nesse caso, bastaria localizar o estado do cliente por meio de um campo relacionado (venda→ cliente→ cidade→estado→id), e estabelecer um filtro de igualdade com o valor "RS", que seria digitado no "Valor do filtro". Assim, somente vendas de clientes do estado "RS" seriam exibidas. O usuário também pode fazer filtros usando variáveis de seção. Ao clicar em "Adicionar filtro" vários filtros desse tipo podem ser adicionados.