Executando relatórios

Sabemos que um relatório pode ter várias versões, pois são relatórios que passaram por modificações, alterações por algum motivo. Para visualizar como ficou determinada alteração, é necessário pressionar o botão EXECUTAR.

Relatórios são executados no servidor da Betha e não localmente, portanto se faltar energia na hora da execução por exemplo, vai continuar executando normalmente.

Sempre que for clicado no botão mencionado acima abrirá a tela de execução de um relatório. A emissão dos relatórios normalmente resulta em um arquivo .pdf, porém, é possível configurar emissões nos formatos .xls, .docx, .ods, .odt, .csv, .txt e .html, mas para que cada relatório seja visualizado de acordo com cada extensão é necessário ajustar no Jaspersoft de forma manual. Para executar de fato insira as informações necessárias nas opções de execuções e pressione o botão EXECUTAR.

As opções de execução ficam ocultas podendo ser acessadas quando desejado pelo usuário, essa melhoria tem o intuito de diminuir as informações apresentadas na tela de execução. Para visualizar as opções de execução pressione o botão OPÇÕES.

Marcando as opções desejadas, aparece um indicador de campo quando as informações estão ocultas.

Quando as opções estiverem ocultas e houver opções com campos obrigatórios não preenchidos é exibido uma indicação de alerta.

Todas as execuções são apresentadas na tela central e as informações são distribuídas em colunas.

No ícone de engrenagem são apresentadas outras ações disponíveis no que diz respeito ao relatório executado.

• Reexecutar

As reexecuções de extensões são a consideradas sempre a última versão da mesma, ou seja, quando a reexecução é solicitada a partir de uma versão desatualizada, é apresentada uma mensagem informativa para usuário, conforme imagem abaixo.

Caso algum parâmetro não possa ser preenchido da execução devido incompatibilidade de tipos entre as versões, é exibido uma notificação na tela.

• Solicitar assinatura

É possível enviar o documento para assinatura. Para isso, insira os nomes dos usuários e pressione o botão SALVAR.

• Parâmetros

Possibilita a visualização dos parâmetros criados pelo usuário desenvolvedor.

• Métricas

Um relatório quando executado pode ter mais de um ativo no banco de dados, possibilitando visualizar os ativos/recursos do relatório que foram acionados, Número de execuções, Duração da execução, Tamanho do payload (pacote de dados de envio ou entrega por uma API) e APDEX (métrica que mede a performance de uma API).

Clicando sobre o ícone mostrado na imagem abaixo são apresentadas as informações da Duração, Tamanho do payload e APDEX.

Clicando na engrenagem, a ferramenta disponibiliza uma amostragem da execução do campo exibindo detalhadamente todos os dados.

• Execução pública

Marcando o parâmetro, a execução pública é exibida para todos os usuários que possuem acesso a esse relatório. Caso esteja desmarcado, apenas o usuário logado que executou o relatório pode ver o resultado da execução.

• Número de protocolo

De acordo com o número de protocolo os usuários conseguem obter detalhes da execução através de um ambiente público https://consulta-execucoes.cloud.betha.com.br/#/. Para isso, existem três formas de verificação:

O primeiro deles é copiar o número do protocolo e acessar o link mencionado disponibilizado acima, logo, colar no campo mostrado na tela de verificação e clicar no botão VERIFICAR.

A segunda maneira, basta pressionar no botão CONSULTAR.

A terceira forma de verificação é muito mais fácil! Com apenas um único clique o usuário confere todos os detalhes da execução. A imagem abaixo mostra o local exato para obter as informações.

Ao clicar no botão mencionado é possível visualizar todos os detalhes da execução, inclusive as opções APDEX de uma execução, proporcionando melhor visualização do desempenho das ferramentas da empresa através de uma legenda com cores diferenciadas e o Trace, que visa facilitar a observação do tempo gasto nas execuções, obtendo assim maior controle da qualidade do código executado.

Na opção MARCADORES, são apresentadas informações dos marcadores customizados na aplicação. Logo abaixo, são mostradas informações relacionadas ao contexto da execução: Sistema e Entidade.

É possível ainda, consultar quem visualizou os e-mails enviados com o resultado da execução, ou seja, quando é utilizado a opção "enviar por email" na execução de um relatório, as informações ficam armazenadas no protocolo. Ao clicar na opção Protocolo > Informações avançadas é possível visualizar os destinatários que receberam o e-mail, data e hora de abertura do e-mail.

Ao consultar uma execução de um artefato, o usuário consegue visualizar todos os eventos realizados durante a execução de um relatório, como exemplo: o usuário que executou, data e hora de início e fim do mesmo.

Segue abaixo a lista dos eventos.

Todas as execuções recentes ficam disponíveis em uma aba específica do lado esquerdo da tela, para visualizá-las basta clicar no local mencionado.

Salvando parâmetros mais utilizados

Na tela de execução de relatório o usuário encontra vários parâmetros para que sejam configurados. Habilitando os itens desejados, é possível salvar os parâmetros. Para isso, pressione a flecha no botão EXECUTAR, facilitando assim, a visualização dos parâmetros mais utilizados.

Insira uma descrição e clique em SALVAR ou SALVAR E EXECUTAR para gravar e executar o relatório. para anular a ação, pressione CANCELAR.

Os parâmetros salvos ficam disponíveis no lado esquerdo da tela. Para visualizá-los clique em Parâmetros salvos e para carregá-los clique no parâmetro desejado.

Com esse recurso, a ferramenta possibilita que o usuário possua uma lista de parâmetros com informações salvas para quando desejar reexecutar o relatório. Também é possível editar as informações já cadastradas, basta alterar as informações e salvar novamente.

Os parâmetros salvos não estão vinculados a uma versão específica da extensão, portanto, se o usuário editar e publicar uma nova, nada será modificado. A única alteração que terá é ao incluir um campo novo, a informação aparecerá na ferramenta sem informação nenhuma, ou seja, em branco. Para que a informação seja apresentada é necessário inserir o conteúdo no campo e salvar novamente.

Agendando relatórios

A ferramenta dispõe de um recurso facilitador para os usuários, são os agendamentos, possibilitando que seja programada uma execução para um determinado relatório. Clicando em Ações disponíveis no botão EXECUTAR existe a possibilidade de Agendar os relatórios.

São apresentados 4 abas a serem preenchidas para que o agendamento se concretize, veja em detalhes abaixo.

Configurando opções

Na primeira aba Configurar opções encontram-se as opções de execuções e o formato de exportação.

Definindo recorrência

Na segunda aba Definir recorrência são apresentados as informações referentes às repetições que esse relatório será executado. Perceba que todos os campos são de preenchimento obrigatórios e os campos comuns são Recorrência, Início e Termina.

No campo Recorrência, as opções de escolha são: diária, semanal, mensal, anual ou personalizada.

No campo Início, informe uma data que dará início a execução e o envio do mesmo.

No campo Termina o usuário precisa escolher entre as opções Nunca (não tem fim), Após algumas ocorrências (um novo campo é aberto para que seja informado a quantidade de ocorrências) e Em uma data específica (necessário informar a data de término).

Dependendo da opção escolhida no campo Recorrência, outros campos são apresentados. Confira abaixo os detalhes de cada item:

Diária: optando por essa recorrência, o campo Repete a cada (dias) é exibido, é necessário que o usuário insira a quantidade de dias em que será repetido a execução do relatório.

Semanal: informe os dias da semana que será executado e enviado o relatório.

Mensal: neste item, dois novos campos são apresentados, onde o usuário informará os dias do mês e o(s) mês(es) de envio do relatório.

Anual: escolhendo essa opção aparecerá apenas campos comuns a todas as opções, porém será executado e enviado o relatório 1 vez ao ano na data e hora estipulados no campo Início e terá um fim marcando o campo Termina.

Personalizado: optando por essa recorrência, o campo Expressão de agendamento CRON é exibido, a expressão CRON é uma expressão que determina um agendamento que pode ser horários, datas, repetições periódicas, intervalos fixos ou apenas um agendamento para uma determinada data. Atualmente os agendamentos suportados são de expressões no formato CRON Quartz e com intervalo mínimo entre execuções de 15 minutos. No exemplo a seguir, está especificado uma CRON de repetição para cada hora.

Para facilitar a construção dessas expressões, existem diversas ferramentas e documentações na internet, como por exemplo o site Cron Maker, que permite montar de acordo com grupos de horário e dias da semana. Abaixo seguem alguns exemplos de expressões Cron e seus significados.

Condição	Expressão
Executar a cada 30 minutos	0 0/30 * 1/1 * ? *
Executar a cada 12 horas	0 0 0/12 1/1 * ? *
Executar todo dia da semana às 18h	0 0 18 ? * MON-FRI *
Somente nas sextas-feiras e sábados, às 8h	0 0 8 ? * FRI,SAT *
Primeiro dia a cada 2 meses, às 13h	0 0 13 1 1/2 ? *
Primeira segunda feira de Maio às 12h	0 0 12 ? 5 MON#1 *

Gerenciando notificações

O recurso Gerenciar notificações, administra os avisos de execuções dos relatórios, controlando o que será possível visualizar e para quem irá enviar as notificações. Quando o parâmetro Omitir notificações está desabilitado é possível inserir os usuários que receberão as notificações.

Quando o parâmetro está habilitado, o campo Notificar usuários do sistema desaparece, ou seja, ao executar um artefato não será enviado nenhum tipo de notificação para os usuários.

Resumo

Esta guia mostra o resumo de todas as informações inseridas nas guias anteriores, através do campo Título é inserido um nome para o agendamento e ainda é possível realizar um agendamentos sistêmico que tem por objetivo agendar execuções vinculadas ao sistema e não a um usuário específico.

IMPORTANTE!

É necessário que o usuário seja administrador da entidade para realizar os Agendamentos sistêmicos.

A ferramenta permite que seja realizado o cancelamento de uma execução sistêmica por um administrador. Esta funcionalidade está disponível através da engrenagem Mais opções > Cancelar, porém só aparecerá a opção de cancelar quando o script estiver sendo executado, caso contrário não aparece essa alternativa.

Executando uma extensão utilizando dados de outras entidades

Os usuários técnicos podem executar uma extensão dentro do ambiente de desenvolvimento de outras entidades, facilitando o fluxo de desenvolvimento. Porém, esse usuário precisa ter acesso a outra entidade destino (necessário ser administrador) para que seja realizada essa execução.

Esse recurso está disponível nas ferramentas de Relatórios e Scripts através da opção Executar no contexto de outra entidade. Habilitando essa opção, o usuário necessita selecionar a entidade. Para isso, basta clicar no espaço abaixo que logo, será mostrado as alternativas.

A entidade selecionada será usada no momento da busca nos campos de seleção com dados dinâmicos.

Ainda, no caso dos campos de seleção terem seus valores preenchidos e a entidade de execução ser alterada, estes serão limpos, evitando que valores inválidos sejam enviados para processamento.

Exemplificando: partindo do cenário onde temos para seleção uma lista de obras da entidade, ao selecionar para executar em outro contexto e selecionado outra entidade, a lista de obras terá seu valor selecionado limpo e serão dispostos apenas as obras que pertencerem à entidade selecionada.

IMPORTANTE!

• Somente será exibido a opção de execução em outro contexto para usuários técnicos e somente serão listadas as entidades que o usuário é administrador e possui acesso técnico;
• Execuções em outro contexto serão automaticamente classificadas como execuções privadas.