Índice:
Objetivo:
Este documento tem como objetivo trazer uma visão de como funciona a atividade Gerar Relatório.
Introdução:
Essa atividade permite que um relatório seja gerado, com a passagem de parâmetros e filtros previamente cadastrados na estrutura do relatório.
Utilizando a atividade:
Primeiro, é necessário arrastar a atividade "Gerar Relatório" para o fluxo de trabalho sequencial da Fórmula Visual. Em seguida, é preciso configurar as propriedades da atividade.
Código da aplicação: Aplicação na qual o relatório a ser utilizado pela atividade foi criado.
Código da coligada: Coligada em que o relatório foi criado.
Código do relatório: Código do relatório a ser gerado pela atividade.
Formato do arquivo: Formato em que o relatório será gerado (PDF, JPEG, RTF, TXT, etc).
Dica |
---|
Caso prefira, é possível efetuar a pesquisa do relatório a ser gerado pela FV ao clicar com o botão direito na atividade pelo fluxo de trabalho e em seguida clicar na opção "Selecionar Relatório". |
Filtros e Parâmetros:
Após os campos de parâmetro da atividade serem preenchidos, dois novos grupos de propriedades serão exibidos: "Filtro(s) do relatório" e "Parâmetro(s) do relatório", isso só acontece caso o relatório tenha parâmetros e/ou filtros cadastrados em sua estrutura.
Aviso |
---|
Não é possível criar parâmetros e filtros para um relatório através dessa atividade. |
Deck of Cards |
---|
|
Card |
---|
| Para o uso um filtro na atividade, é necessário preencher o campo da seguinte forma: NOMETABELA.CAMPO (SINAL) 'VALOR' Como no exemplo acima, para trazer Chapa menor que 00005, será escrito: PFUNC.CHAPA < '00005' |
Card |
---|
| Para parâmetros, é possível digitar apenas o valor desejado. Aviso |
---|
Os sinais que serão usados na geração do relatório correspondem aos escritos na consulta SQL, não sendo necessário digitá-los na atividade. |
|
|
Exemplo de uso dos parâmetros e filtros descritos:
![](/download/attachments/463814973/image2019-3-11_13-37-5.png?version=1&modificationDate=1552322225303&api=v2&effects=drop-shadow)
Envio de relatório por e-mail:
O relatório gerado pela atividade "Gerar Relatório" não é exibido após o fim da execução do processo de geração, no entanto, uma forma de conseguir visualizar o relatório gerado é enviá-lo por e-mail após a execução do processo.
Para isso, é necessário adicionar a atividade "Enviar E-mail" ao fluxo de trabalho. Após isso, pode-se configurar para que o relatório seja enviado da seguinte forma:
Na propriedade "Anexar Arquivo", ao clicar em "Propriedade de Associação" uma tela de seleção será aberta, assim, selecione a opção "Relatório Gerado" mostrada ao expandir a atividade de geração de relatório.
![](/download/attachments/463814973/image2019-3-4_12-56-32.png?version=1&modificationDate=1551714993263&api=v2&effects=drop-shadow)
Após preencher os campos necessários para o envio do e-mail (para mais informações, consulte a página "Utilizando a atividade Enviar E-mail"), ainda nas propriedades dessa atividade, é necessário informar o Nome do Arquivo Anexo.
Deck of Cards |
---|
|
Card |
---|
id | 5 |
---|
label | Nome do Arquivo Anexo |
---|
| Informações |
---|
Nessa propriedade, ao inserir o nome do arquivo, é preciso que a extensão também seja informada. |
Nos parâmetros da atividade "Gerar Relatório" foi informado o formato de arquivo em que o relatório será gerado (por exemplo, o formato PDF). Então agora, na atividade "Enviar e-mail" o nome do arquivo deve contar com a extensão ".pdf" ![](/download/attachments/463814973/image2019-3-4_13-14-34.png?version=1&modificationDate=1551716074440&api=v2&effects=drop-shadow)
|
|
Binding de parâmetros e filtros:
Para o uso de parâmetros e filtros, há também a possibilidade de ligá-los a outros campos da própria FV. No caso dos filtros, eles devem ser montados a partir da atividade "Expressão", já os parâmetros podem ser ligados diretamente a um campo da FV.
No exemplo a seguir, foi criada uma FV exemplo, trazendo os 3 primeiros funcionários da tabela PFUNC e para cada um deles, com o uso da atividade "Para cada Iteração" será gerado um relatório e enviado por e-mail.
![](/download/attachments/463814973/image2019-3-12_9-58-18.png?version=1&modificationDate=1552395498360&api=v2&effects=drop-shadow)
Deck of Cards |
---|
|
Card |
---|
| Foi adicionada a atividade "Expressão" antes da atividade "Gerar Relatório" no fluxo de trabalho, onde o filtro foi montado para ser usado posteriormente. ![](/download/attachments/463814973/image2019-3-12_9-59-48.png?version=1&modificationDate=1552395588627&api=v2&effects=drop-shadow)
Em seguida, na propriedade "Filtro(s) do relatório" foi feita a ligação com a atividade "Expressão" através do botão "Propriedade de Associação". Onde foi selecionada a atividade Expressão e usada a propriedade de conversão do valor para string. ![](/download/attachments/463814973/image2019-3-12_10-3-50.png?version=1&modificationDate=1552395830140&api=v2&effects=drop-shadow)
Assim, o campo será exibido da seguinte forma: ![](/download/attachments/463814973/image2019-3-12_10-3-34.png?version=1&modificationDate=1552395814643&api=v2&effects=drop-shadow)
|
Card |
---|
| Para os parâmetros, os campos foram ligados diretamente pela "Propriedade de Associação". Foi selecionada a atividade "Para cada Iteração", em seguida na propriedade "Campos" foi colocado o nome do parâmetro usado entre aspas e selecionado o valor como string. Exemplo do campo CODSECAO após expandir a atividade "Para cada Iteração": ![](/download/attachments/463814973/image2019-3-12_10-13-3.png?version=1&modificationDate=1552396383710&api=v2&effects=drop-shadow)
|
|
Após as ligações, os filtros e parâmetros serão exibidos da seguinte forma na aba de Propriedades da Atividade:
Image Added