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

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:  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. 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 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 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 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 2.2 exibe o relatório gerado através do bloco Gerar Relatório com parâmetros, contendo os alunos com nota iguais a 10.

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