Gerar relatório com parâmetros

Gera um arquivo em formato PDF, HTML ou HTML EXCEL de um relatório existente no projeto e o salva em uma determinada pasta.

Parâmetros

Nome

Tipo

Doc

Image Added

Figura 1 - Bloco Gerar relatório com parâmetros 

Compatibilidade

• Bloco servidor:  cronapi.report.Operations.generateReportWithParam()

Retorno

Retorna o endereço onde foi salvo o arquivo PDF, HTML ou EXCEL.

Parâmetros

Relatório

Esse parâmetro recebe o caminho relativo do relatório, é necessário informar o nome do diretório e o nome do relatório com a extensão .report

• Posição: 1
• Inglês: Report 
• Tipo: Texto / String
• Exemplo: "reports/alunos.report"

Tipo

Define o tipo do relatório gerado, podendo ser PDF, HTML ou EXCEL, o tipo de arquivo EXCEL gerado é somente .xls.

• Posição: 2
• Inglês: Type
• Tipo: Texto / String
• Exemplo: "PDF"
• Opções:
  • HTML

Parâmetro 3StringDiretório a receber o arquivo referente ao relatório escolhido.

• • :  Arquivo com extensão .html
  • PDF: Arquivo com extensão .pdf.
  • Excel: Arquivo com extensão .xls.

Caminho

Campo utilizado para definir o caminho do diretório que receberá o arquivo gerado. Ele deve conter o nome do arquivo resultante e a extensão de acordo com o formato escolhido no parâmetro Tipo.

• Posição: 3
• Inglês: Path
• Tipo: Texto / String
• Exemplo: "src/main/webapp/public/assets/relatorio/relatorio.pdf"

Parâmetros

Mapa (chave / valor) com os filtros do relatório.

Retorno

Retorna o endereço onde foi salvo o arquivo PDF ou HTML.

Compatibilidade

Image Removed

 Podemos utilizar o bloco de programação Criar mapa com (Servidor) / Create map with (Server) para preencher este campo.

• Posição: 4
• Inglês: Parameters
• Tipo: Mapa / Map
• Exemplo: {“nota“:”10”}.

Exemplo

No exemplo da figura 1 2 estamos gerando um PDF contendo os alunos com notas iguais a 10. Para fazer isso, adicionamos um filtro na Fonte de dados contida no relatório. O quatro parâmetro só aceita um bloco do tipo Mapa, por essa razão utilizamos o bloco criar Criar mapa com para passar o(s) valor(es) solicitado(s) pelo filtro da fonte de dados e exibir no relatório. Para saber mais como funciona os filtros em relatórios, clique aqui.

Figura 1 2 - Bloco de programação Gerar Relatório com parâmetros

A figura 2.1 exibe a lista de alunos antes dos dados serem filtrados.

Figura 2.1 - Lista de alunos antes dos dados serem filtrados.

A figura 3 2.2 exibe o relatório gerado através do bloco Gerar Relatório com parâmetroparâmetros, contendo os alunos com nota iguais a 10.

Figura 3 2.2 - Relatório gerado através do bloco Gerar Relatório com parâmetroparâmetros