A nova versão do Cronapp possui um novo relatório, muito mais completo e fácil de utilizar. Porém, caso ainda tenha projetos que foram criados na versão 1.0 do Cronapp e eles possuam relatórios Jasper, será possível modificá-los, mas não será possível criar novos. A figura 1 exibe o diretório padrão de relatórios com um relatório Jasper (extensão .jrxml) criado na versão anterior do Cronapp e o novo relatório (extensão .report).

Figura 1 - Relatórios

Os relatórios criados no Cronapp podem ser visualizados através do componente visualizador de relatório, chamada de eventos ou pelo bloco de programação Abrir relatório.

Relatórios da versão 1.0 do Cronapp

A versão antiga do Cronapp trabalhava com relatórios utilizando Jasper e Ad-hoc. Dessa forma, a opção Projetos > Relatórios no menu do sistema só estará disponível para projetos criados na versão 1.0 do Cronapp e que possua relatórios Jasper e Ad-hoc, mantendo a compatibilidade com os relatórios antigos.

Figura 2 - Relatórios da antiga versão

Criar relatório

O Cronapp possui o diretório Relatórios (Localização: Relatórios/ ) para armazenar e manter esse conteúdo. Caso seja o primeiro relatório do projeto, clique no ícone de atalho (destaque 1 da figura 3) para criar o diretório e ser direcionado.

É possível criar relatórios novos ou gerar relatórios a partir de uma Fonte de Dados ou classe do Diagrama. A seguir, forneceremos uma descrição mais detalhada de cada uma dessas opções.

Novo

A forma mais comum para criar um relatório é através do diretório Relatórios. Clique com o botão direito do mouse para abrir o menu de contexto do diretório, clique em Novo > Relatório para abrir uma janela e informar um nome ao arquivo do relatório, em seguida, a ferramenta de relatório será aberta com o conteúdo vazio (Figura 3).

Figura 3 - Criando relatório

A partir de uma Fonte de dados ou Classe

É possível criar um relatório a partir de uma classe no Diagrama de Dados (destaque 1 na figura 3.1) ou através de uma Fonte de Dados (2). O processo de criação é o mesmo para ambos os casos. Neste exemplo, utilizaremos a classe "Pessoa" presente no diagrama de dados. Para começar, clique com o botão direito sobre ela para exibir o menu Ação e, em seguida, selecione a opção Novo relatório. Isso abrirá a janela de Configuração, ela também é exibida quando criamos um relatório a partir de uma Fonte de Dados.

A janela de Configuração é dividida em cinco colunas. Na primeira coluna, denominada Campo (3), encontram-se listados os atributos da classe. Na segunda coluna, chamada Rótulo (4), estão os rótulos correspondentes aos atributos. Os destaques 5 e 6 representam, respectivamente, os botões de ordenação para mover um atributo para cima ou para baixo. Caso seja necessário, é possível excluir um atributo clicando no ícone da lixeira (7). No campo Nome (8) consta o nome da classe ou fonte de dados utilizada para criar o relatório.

Figura 3.1 - Criando relatório através de uma classe ou fonte de dados

Visão geral do novo relatório

O novo relatório apresenta diversas ferramentas para construir um relatório poderoso de maneira simples através de seus elementos de arrasta e solta (exceto com os elementos do tipo gráfico), no qual os elementos são arrastados até a página do relatório e ao solta-los, eles preenchem automaticamente o espaço que será utilizado, mas com as outras ferramentas existentes no relatório é possível modifica-los, podendo ser seu tamanho, seu tema, etc.

Figura 4 - Visão geral do relatório

1. Menu superior;
2. Menu lateral;
3. Área do relatório;
4. Menu inferior.

Menu superior

No menu superior se encontra as ferramentas para o relatório, como bordas, adição dos elementos, criação de colunas e a função de pré-visualização do relatório. Além disso, o botão presente nesse menu (destaque da Figura 4.1) expande a aba selecionada no menu, apresentando suas ferramentas correspondentes.

Figura 4.1 - Menu superior

Aba Início

A aba início apresenta as ferramentas de clipboard, fonte, alinhamento, bordas, formato do texto e estilos.

Figura 4.1.1 - Aba início

Aba Inserir

A aba inserir apresenta as funcionalidades de novo item, categoriais e componente, no quais é possível adicionar página, faixa, componentes, código de barras, formas e infográficos. Além disso, possui uma caixa de ferramentas, onde você consegue adicionar ou remover os itens que são exibidos na aba (destaque da Figura 4.1.2).

Figura 4.1.2 - Aba inserir

Aba Página

A aba página apresenta configurações de margens, orientação, colunas como também habilitar as opções de exibir grade e cabeçalho, etc. (Figura 4.1.3).

Figura 4.1.3 - Aba página

Aba Layout

A aba layout apresenta todas as opções de organização dos elementos que se encontram na página do relatório e o design dos mesmos. Essa opção só fica disponível quando o elemento ou conjunto de elementos estão selecionados.

Figura 4.1.4 - Aba layout

Aba Pré-visualizar

A aba pré-visualizar mostra como será o resultado do relatório.

Figura 4.1.5 - Aba pré-visualizar

Menu lateral

O menu lateral apresenta as propriedades do elemento selecionado na área de design do relatório, podendo ser a própria página quanto um componente, como as fontes de dados e a árvore hierárquica do relatório. Além disso, ele apresenta um ícone de atalhos da aba inserir do menu superior e alguns ícones de configuração do menu lateral (Figura 4.2).

Figura 4.2 - Menu lateral

1. Ícone de atalhos: apresenta os principais elementos da aba inserir do menu superior;
2. Ícones de configuração do menu lateral:
   • Propriedades: selecionado por padrão, exibe as propriedades do elemento selecionado;
   • Eventos: exibe os eventos que podem ser associados ao elemento selecionado, podendo ser de navegação como de impressão;
   • Colocações: habilita a localização da grade;
   • Fixa ou desprende o menu lateral do relatório.

Propriedades

A aba propriedades varia conforme o elemento selecionado na página (Figura 4.2.1 e 4.2.2), mas ele exibe todas as configurações que podem ser feitas no elemento.

Figura 4.2.1 - Propriedades referente ao componente cabeçalho

Figura 4.2.2 - Propriedades do componente gráfico

Dicionário 

Na aba Dicionário é possível adicionar e remover fontes de dados, variáveis do sistema, variáveis criadas pelo usuário, funções e Recursos do relatório.

Figura 4.2.3 - Dicionário

1. Controles: menus e botões para manipulação dos recursos.
   • Ações: exibe ações para os recursos do dicionário.
     • Novo dicionário: limpa o dicionário atual e suas configurações.
     • Abrir dicionário: abre as configurações do dicionário a partir de um arquivo de configurações do dicionário.
     • Salvar dicionário como: permite exportar as configurações do dicionário atual para um arquivo de configurações.
     • Sincronizar: recarrega o dicionário.
   • Novo item: exibe ações para os recursos do dicionário.
     • Nova fonte de dados: adiciona uma Fonte de dados do Cronapp ou um dos arquivos: JSON, CSV e Excel.
     • Nova transformação de dados; cria um atributo a partir de um existente.
     • Nova coluna: (essa opção só será exibida quando um campo da fonte de dados estiver selecionado na área de recursos, destaque 2) - insere uma nova coluna (atributo) na fonte de dados.
     • Nova coluna calculada: (essa opção só será exibida quando um campo da fonte de dados estiver selecionado na área de recursos, destaque 2) - insere uma nova coluna calculada na fonte de dados.
     • Novo relacionamento: cria uma relação entre duas fontes de dados que possuam um atributo de relação.
     • Nova categoria: cria uma categoria de variáveis.
     • Nova variável: cria uma variável.
     • Novo recurso: cria um recurso (arquivo) no diretório "Recursos".
   • Editar: abre a janela de edição dos recursos criados pelo usuário. Exemplo: Fonte de dados, campos da fonte de dados, variáveis, recursos etc. 
   • Excluir: deleta o recurso selecionado e criado pelo usuário. Exemplo: Fonte de dados, campos da fonte de dados, variáveis, recursos etc. 
   • Mover para cima: habilitado somente quando um atributo da fonte de dados estiver selecionado e quando esse elemento não for o primeiro, ele move o atributo da fonte de dados para cima.
   • Mover para baixo: habilitado somente quando um atributo da fonte de dados estiver selecionado e quando esse elemento não for o último, ele move o atributo da fonte de dados para baixo.
2. Recursos
   • Fonte de dados: lista as fontes de dados (e seus campos) vinculados ao relatório.
   • Variáveis: lista as variáveis criadas pelo usuário.
   • Variáveis do Sistema: lista um conjunto de variáveis pré-definidas, normalmente são variáveis que fornecem informações sobre o status atual de um relatório.
   • Funções: lista um conjunto de funções pré-definidas que podem ser utilizadas no relatório.
   • Recursos: espaço destinado para armazenar recursos que podem ser utilizados no relatório, são eles:

     • Arquivos de dados - CSV, Excel, JSON, XML, DBF;

     • Arquivos de imagem - SVG, JPEG, JPG, PNG, BMP, GIF e outros arquivos de imagem.

Nova fonte de dados

Ao clicar na opção Nova fonte de dados, será exibida a janela Selecionar o tipo de conexão, através dela poderemos incluir no relatório diferentes tipos de fontes de dados: os arquivos CSV, Excel ou JSON e a Fonte de dados do Cronapp.

Existem três formas de adicionar uma nova fonte de dados, a primeira é logo após a criação do arquivo relatório, onde será exibida a opção Criar nova fonte de dados, a segunda é através do menu Novo item, por fim, a última forma é clicando com o botão direito na área de destaque 2 da figura 4.2.3 e selecionando a opção Nova fonte de dados.

Figura 4.2.3.1 - Nova Fonte de Dados

1. Menu de Filtros: exibe os filtros que irão alterar o modo de exibição das fontes de dados na janela Selecionar o tipo de conexão.
   • Procurar: utilizado para buscar uma fonte de dados específica. 
   • Categoria: selecione Tudo para exibir todas as categorias ou selecione uma categoria específica.
2. Favoritos: campo destinado a exibir as fontes de dados favoritas do usuário. Para favoritar uma fonte de dados, clique no ícone de estrela que aparece quando colocamos o mouse em cima da opção. Por padrão, a Fonte de Dados do Cronapp já vem favoritada.
3. Arquivo: exibe as fontes de dados obtidas a partir de arquivos: CSV, Excel e JSON.
4. Ocultar fontes de dados não suportadas: oculta as fontes de dados que não são suportadas atualmente pelo Cronapp.

Ao selecionar a Fonte de dados Cronapp, a janela padrão de seleção de fonte de dados é exibida. Porém, ao selecionar uma das opções de arquivos, a janela exibida será a Nova conexão. Essa janela possui campos comuns a todos os arquivos e campos específicos. 

Figura 4.2.3.2 - Configurando a nova fonte de dados escolhida

Para este exemplo utilizamos o tipo de fonte de dados CSV, ele possui alguns campos em comum com os tipos de fonte de dados Excel e JSON.

Campos em comum:

1. Nome: especifica o nome da fonte de dados. 
2. Apelido: define um alias para a fonte de dados.
3. Caminho para Dados: clique no botão "..." para selecionar um arquivo em seu computador.
4. Campos específicos: os campos abaixo vão variar em relação ao arquivo selecionado.
   • CSV
     • Codificando: neste campo é possível informar a codificação do arquivo, para mais informações clique aqui.
     • Separador: define qual tipo de separador será utilizado no CSV, podendo ser: aba, ponto e vírgula, vírgula, espaço ou outro.
   • Excel
     • A primeira linha é cabeçalho: campo booleano que usa a primeira linha no arquivo do Excel como um cabeçalho para os dados. Se estiver habilitado, a primeira linha será o cabeçalho dos dados.
   • JSON
     • Direção da relação: define como os dados do arquivo serão importados.
       • Pai-Para-Filho: quando essa opção é selecionada, a fonte de dados é estruturada de forma que os objetos pais são listados primeiro, seguidos pelos objetos filhos que pertencem a cada objeto pai. Essa direção de relação é usada para exibir informações que têm uma hierarquia, como uma lista de categorias e subcategorias.
       • Filho-Para-Pai: quando essa opção é selecionada, a fonte de dados é estruturada de forma que os objetos filhos são listados primeiro, seguidos pelos objetos pais a que pertencem. Essa direção de relação é usada para exibir informações que têm um relacionamento de dependência, como uma lista de tarefas e seus projetos associados.
5. Recursos: esse campo exibe a galeria de recursos selecionados, é possível selecionar mais de um arquivo do mesmo tipo.

Após selecionar o arquivo e clicar em Ok o arquivo será incluído na propriedade Fonte de Dados (destaque 1 da figura 4.2.3.3) e a janela de seleção de dados será exibida, dessa forma, o usuário pode decidir se quer trabalhar com todos os campos da fonte ou somente alguns.

Figura 4.2.3.3 - Janela de seleção de dados

Árvore de relatório

A aba Árvore de relatório exibe todos os elementos e itens em que ele é constituído, da mesma forma de uma árvore de projeto, com menus e submenus - no caso da árvore, é mostrado na forma de suas páginas e os elementos que contém em cada página (Figura 4.2.4).

Figura 4.2.4 - Árvore de relatório

Menu inferior

Apresenta as unidades de medida para definir os componentes da página, o valor de zoom do relatório, o elemento selecionado na área de design do relatório, a funcionalidade de varrer o relatório por possíveis erros, etc.

Figura 4.3 - Menu inferior

1. Define a unidade de medida dos componentes da página, podendo ser centímetros, centésimos de polegada, polegadas e milímetros;

2. Ao clicar, será feita uma varredura em todo o relatório, e, ao final, será aparecerá uma janela informando os possíveis erros, avisos, informações de mensagens e relatório de prestação de mensagens;

3. Mostra o título do elemento selecionado no relatório, podendo ser a página ou um componente de texto;

4. A coluna informa as coordenadas x e y do mouse ou do componente selecionado dentro do relatório, assim como largura e altura;

5. Zoom definido pelo tamanho do relatório:
   
   • Largura da Página: altera o zoom do relatório para ver a página inteira na janela;
   • Altura da Página: altera o zoom de modo que a largura do relatório corresponda à largura da janela;
   • Informa o percentual utilizado no zoom.
6. Define o valor do zoom do relatório;
7. Informa o zoom atual e ao clicar sobre a opção, ele apresenta outros valores de zoom.