Dashboard
O Dashboard, é um novo recurso do Cronapp muito completo e fácil de utilizar. A figura 1 exibe o diretório padrão do Dashboard criado no Cronapp (Localização: Dashboards/ )
Figura 1 - Local de criação do Dashboard
Os Dashboards criados no Cronapp podem ser visualizados através do componente Visualizador de dashboard inseridos em uma view.
Criação do Dashboard
A criação do Dashboard fica disponível no diretório Dashboards (Localização: Dashboards/ ). Então, para criar um dashboard, clique com o botão direito do mouse para abrir o menu de contexto do diretório e clique em Novo > Dashboard (Figura 3).
Figura 2 - Criando um Dashboard
Visão Geral do Dashboard
O Dashboard apresenta diversas ferramentas para construir um poderoso painel visual de maneira simples através de seus elementos de arrasta e solta, no qual os elementos são arrastados até a página do dashboard e ao solta-los, eles preenchem automaticamente o espaço que será utilizado, mas com as outras ferramentas existentes no dashboard é possível modifica-los, podendo ser seu tamanho, seu tema, etc.
Figura 1 - Visão geral do dashboard.
- Menu superior;
- Área lateral;
- Área de edição do dashboard;
- Menu inferior.
Menu Superior
O Menu superior (Destaque da figura 2) é composto por abas que comportam ferramentas de utilização, são elas Início, Inserir, Página, Layout e Pré-visualizar.
Figura 2 - Menu superior do dashboard.
Aba Início
A aba início (Destaque da figura 2.1). é responsável por estilizar o componente, inserindo tamanhos e cores de fontes, bordas e cores de fundos para o componente, também é possível escolher estilos prontos para o componente (ao selecionar o componente) ou para todo o dashboard (ao selecionar a área de edição).
Figura 2.1 - Aba Início.
Aba Inserir
Na aba inserir (Destaque da figura 2.2), estão localizados os componentes que farão parte do dashboard. Com exceção dos componentes, imagem, texto, painel e formas, todos os outros componentes precisam de atributos da classe importada do banco de dados para serem exibidos, como no exemplo abaixo, Região e Estados são atributos de uma classe.
Figura 2.2 - Aba Inserir.
- Tabela: Insere uma tabela na área de edição;
- Gráfico: Insere um gráfico na área de edição;
- Manômetro: Insere um manômetro na área de edição;
- Tabela Pivô: Insere uma tabela pivô na área de edição, uma tabela pivô é uma tabela dinâmica que serve para calcular, resumir e analisar os dados que lhe permitem ver comparações, padrões e tendências nos dados;
- Indicador: Insere um indicador na área de edição;
- Progresso: Insere um componente que mostra o progresso de um atributo;
- Mapa: Insere um mapa na área de edição, existem dois tipos de mapa, o mapa de região e mapa de localização. O primeiro exibe os países dividido por continentes, o segundo exibe todos os países de uma forma geral, como um mapa mundi;
- Imagem: Insere uma imagem na área de edição;
- Texto: Insere uma área de texto na área de edição;
- Painel: Insere um painel na área de edição, nele é possível inserir outros componentes do dashboard;
- Formas: Insere uma ou mais formas ao dashboard, como por exemplo, circulos, triângulos, setas, retângulos, etc;
- Filtros: Insere um filtro a um determinado componente do dashboard;
- Setup de caixa de ferramentas: local onde é possível deixar ou não visível algum componente do dashboard, basta clicar na checkbox para realizar tal ação.
Aba Página
A aba página é responsável por formatar a página, como por exemplo, definir as margens, orientação, tamanho da página, também é possível inserir uma marca d'água à página.
Figura 2.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 2.4 - Aba Layout.
Aba Pré-visualizar
A aba pré-visualizar mostra uma prévia de como está ficando o dashboard sem ter que executar o projeto.
Figura 2.5 - Aba Pré-visualizar.
Área Lateral
Na Área Lateral podemos encontrar as propriedades de cada componente selecionado na área de edição do dashboard, também é por ela que adicionamos a fonte de dados e podemos ver a árvore hierárquica de elementos que constam no dashboard.
Figura 3 - Área Lateral.
- Ícone de atalhos: apresenta os principais elementos da aba inserir do menu superior;
- Propriedades: Apresenta as propriedades do componente selecionado na área de edição do dashboard.
- Dicionário: Área responsável por adicionar uma fonte de dados ao dashboard.
- Árvore de relatório: Exibe uma lista dos componentes presentes no dashboard.
- Í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.
- 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, mas ela exibe todas as configurações que podem ser feitas no elemento.
Figura 3.1 - Propriedades.
Dicionário
A aba dicionário é onde se encontra a configuração de fonte de dados, variáveis do sistema, funções e recursos. Nessa aba, é possível adicionar e remover fonte de dados, inserir e remover variáveis e funções no relatório, etc.
Para utilizar esse recurso é preciso que haja uma fonte de dados no projeto.
Figura 3.2 - Dicionário.
- Ações: exibe as opções: Novo dicionário, abrir dicionário, salvar dicionário como e sincronizar.
- Novo item: exibe as opções:
- Nova fonte de dados: adiciona uma nova fonte de dados ao Dashboard;
- Nova transformação de dados; Cria um novo atributo a partir de um existente;
- Nova coluna: Insere uma nova coluna (atributo) na fonte de dados;
- Nova coluna calculada: Insere uma nova coluna calculada na fonte de dados;
- Novo relacionamento; Cria uma relação entre duas fontes de dados distintas;
- Nova categoria; Cria uma nova categoria de variáveis;
- Nova variável; Cria uma nova variável;
- Novo recurso; Cria um novo recurso no diretório "Recursos".
- Editar: habilitado somente quando uma fonte de dados ou um elemento dessa fonte estiver selecionado, ele abre a janela de edição da fonte ou do elemento;
- Excluir: habilitado somente quando uma fonte de dados ou um elemento dessa fonte estiver selecionado, ele exclui a fonte ou o elemento;
- Mover para cima: habilitado somente quando um elemento da fonte de dados estiver selecionado e quando esse elemento não for o primeiro, ele move o elemento da fonte de dados para cima;
- Mover para baixo: habilitado somente quando um elemento da fonte de dados estiver selecionado e quando esse elemento não for o último, ele move o elemento da fonte de dados para baixo.
Variáveis de sistema
As Variáveis de sistema e Funções encontram-se na aba Dicionário e para utilizá-las é preciso ter alguma fonte de dados vinculado ao dashboard, elas possuem diversos elementos prontos para serem exibidos no dashboard. Em geral, essas variáveis contemplam informações sobre páginas, informações do dashboard, informações de linha do dashboard, data e hora.
Figura 3.2.1 - Variáveis de Sistema.
| Variável | Descrição |
|---|---|
| Column | Retorna o número da coluna atual (começa em 1). |
| Line | Retorna o número da linha atual (começa em 1). |
| LineThrough | Retorna o número da linha atual (começa a partir de 1). Quando o cálculo do número, todos os agrupamentos são ignorados e numeração começa a partir do início de um relatório. |
| LineABC | Retorna o análogo alfabético do número da linha atual. |
| LineRoman | Retorna o número da linha atual em algarismos romanos. |
| GroupLine | Retorna o número da linha do grupo atual (começa em 1). |
| PageNumber | Retorna o número da página atual (começa em 1). Usado para numerar páginas. |
| PageNumberThrough | Retorna o número da página atual (começa em 1). Quando o PageNumberThrough é usado, a propriedade ResetPageNumber é ignorada e a numeração começa no início de um dashboard. |
| PageNofM | Retorna uma string localizada, mostrando "Página N de M", onde N é o número da página atual e M é o TotalPageCount de um dashboard. |
| PageNofMThrough | Retorna uma string localizada, mostrando "Página N de M", onde N é o número da página atual e M é o TotalPageCount de um relatório. Quando o PageNofMThrough é usado, a propriedade ResetPageNumber é ignorada e a numeração começa no início de um dashboard. |
| TotalPageCount | Retorna o número de páginas em um dashboard. |
| TotalPageCountThrough | Retorna o número de páginas em um relatório. Quando o TotalPageCountThrough é usado, a propriedade ResetPageNumber é ignorada e a numeração começa no início de um dashboard. |
| IsFirstPage | Retorna verdadeiro, se, no momento atual, for impressa a primeira página de um dashboard. |
| IsFirstPageThrough | Retorna verdadeiro, se, no momento atual, a primeira página do relatório é impresso. Ao calcular a IsFirstPageThrough, todas as propriedades ResetPageNumber são ignorados e numeração começa a partir do início do dashboard. É necessário executar dois passes para o cálculo correto de uma variável. |
| IsLastPage | Retorna verdadeiro se, no momento atual, a última página de um dashboard é impresso. É necessário executar dois passes para o cálculo correto de uma variável. |
| IsLastPageThrough | Retorna verdadeiro se, no momento atual, for impressa a última página de um dashboard. Ao calcular IsLastPageThrough , todas as propriedades ResetPageNumber são ignoradas e a numeração começa no início do relatório. Para o cálculo correto de uma variável, é necessário executar dois passes. |
| PageCopyNumber | Retorna o número de uma cópia atual de uma página (começa em 1). |
| ReportAlias | Retorna o alias de um relatório. Você pode alterar o ReportAlias com a ajuda da propriedade ReportAlias de um dashboard. |
| ReportAuthor | Retorna o autor de um relatório. Você pode alterar ReportAuthor com a ajuda da propriedade ReportAuthor de um dashboard. |
| ReportChanged | Retorna a data em que um dashboar foi alterado. |
| ReportCreated | Retorna a data em que um dashboard foi criado. |
| ReportDescription | Retorna a descrição de um dashboard. Você pode alterar o ReportName com a ajuda da propriedade ReportDescription de um dashboard. |
| ReportName | Retorna o nome de um dashboard. Você pode alterar o ReportName com a ajuda da propriedade ReportName de um dashboard. |
| Time | Retorna a hora atual. |
| Today | Retorna a data atual. |
Funções
As funções possuem elementos que são usados para tratar ou calcular os dados obtidos no relatório, cada grupo possui vários elementos e os principais grupos são: Matemática, Data, Edição de palavras e Cálculo de agrupamento.
Figura 3.2.2 - Funções.
Math (Matemática)
Função | Descrição |
|---|---|
Abs() | Exibe o número absoluto. |
Acos() | Exibe o valor do cosseno (cos). |
Asin() | Exibe o valor do seno (sin). |
Atan() | Exibe o valor da tangente (tan). |
Ceiling() | Exibe o valor inteiro máximo para um número especificado. |
Cos() | Calcula o valor do cosseno (cos). |
Div() | Exibe o resultado da divisão de um argumento por outro. |
Exp() | Exibe o resultado do número elevado à potência especificada. |
Floor() | Exibe o valor inteiro mínimo ou igual para o número especificado. Esta função não arredonda números. |
Log() | Calcula o logaritmo natural. |
Maximum() | Compara dois valores e exibe o máximo. |
Minimum(,) | Compara dois valores e exibe o mínimo. |
Round() | Arredonda o valor para um número inteiro. |
Sign() | Exibe um indicador. 1 para números positivos, 0 para números iguais a zero e -1 para números negativos. |
Sin() | Calcula o valor do seno (sin). |
Sqrt() | Calcula a raiz quadrada de um número. |
Tan() | Calcula o valor do tangente (tan). |
Truncate() | Exibe apenas a parte inteira sem arredondamento. |
Date (Data)
Função | Descrição |
|---|---|
DateDiff() | Calcula a distância entre as datas especificadas. |
DateSerial() | Especifica a data. |
Day() | Exibe o dia de uma data. |
DayOfWeek() | Exibe o dia da semana de uma data em formato de texto. |
DayOfYear() | Exibe a contagem do dia no ano. |
DaysInMonth() | Exibe o número de dias no mês. |
DaysInYear() | Exibe o número de dias em um ano. |
Hour() | Exibe a hora de uma data e hora. |
Minute() | Exibe o minuto de uma data e hora. |
Month() | Exibe o mês de uma data. |
MonthName() | Exibe o nome do mês de uma data. |
Second() | Exibe o segundo de uma data e hora. |
TimeSerial() | Exibe o tempo. Horas, minutos e segundos em argumentos. |
| WeekOfMonth() | Exibe a semana no mês que inclui a data especificada. |
| WeekOfYear | Exibe a semana no ano que inclui a data especificada. |
Year() | Exibe o ano de uma data. |
Print State (Estado de impressão)
Função | Descrição |
|---|---|
IsNull() | Identifica valores nulos na coluna de dados especificada. Se houver um valor nulo, o resultado é verdadeiro, caso contrário - falso. |
Next() | Exibe o valor da próxima linha. Se o valor da próxima linha for nulo, o resultado será 0. |
NextIsNull() | Compara o valor com o valor da próxima linha. Se o valor da próxima linha for 0 ou nulo, o resultado é verdadeiro, caso contrário será falso. |
Previous() | Exibe o valor da linha anterior. Se o valor da próxima linha for nulo, o resultado será 0. |
PreviousIsNull() | Compara o valor com o valor da linha anterior. Se o valor da linha anterior for 0 ou nulo, o resultado é verdadeiro, caso contrário será falso. |
Programming Shortcut (Atalho de programação)
Função | Descrição |
|---|---|
| Choose() | Exibe um valor da lista de opções com base no valor do índice |
| IIF() | Exibe uma de duas partes, dependendo da condição atendida. |
| Switch() | Atribui o valor especificado quando a condição for atendida. Se a expressão for falsa, retornará nulo. |
Strings (Sequência de caracteres)
Função | Descrição |
|---|---|
Arabic() | Converte esses números em algarismos arábicos. |
DateToStr() | Converte data em texto. |
Insert() | Insere um valor após um determinado número de caracteres. |
Left() | Exibe parte do lado esquerdo de um valor de acordo com o número especificado. |
Length() | Exibe o número de caracteres de um valor. |
Mid() | Exibe parte de um valor. Neste caso, você pode definir a posição de referência. |
Persian() | Converte os números especificados em números em Persa. |
Remove() | Exclui uma quantidade de caracteres especificados a partir de uma posição. |
Replace() | Substitui certos caracteres. |
Right() | Exibe parte do lado direito de um valor de acordo com o número especificado. |
Roman() | Converte numerais arábicos em numerais romanos. |
Substring() | Ignora parte da string a partir de uma posição especificado e exibe a parte restante de acordo com o número desejado. |
ToCurrencyWords() | Exibe o valor da moeda em formato de texto. |
ToLowerCase() | Exibe o valor em minúsculas. |
ToOrdinal() | Converte numerais em ordinais. |
ToProperCase() | Exibe o primeiro caractere em maiúsculo e os demais caracteres estão em minúsculos. |
ToUpperCase() | Exibe o valor em maiúsculas. |
ToWords() | Exibe os numerais como texto. |
Trim() | Remove os espaços no início ou no final da linha. |
TryParseDecimal() | Converte um número para o tipo decimal. |
| TryParseDouble() | Converte um número para o tipo double. |
| TryParseLong() | Converte um número para o tipo long. |
Totals (Totais)
Função | Descrição |
|---|---|
Avg() | Calcula a média aritmética. |
Count() | Calcula o número de valores do objeto especificado. |
First() | Exibe o primeiro valor. |
Last() | Exibe o último valor. |
Max() | Exibe o valor máximo. |
Median() | Exibe o valor médio (não aritmético) da lista. |
Min() | Exibe o valor mínimo. |
Mode() | Exibe o valor que mais se repete. |
Rank() | Exibe a posição do valor em ordem crescente. |
Sum() | Exibe o resultado da soma dos valores. |
Á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 3.3 - Árvore de relatório.
Menu Inferior
Apresenta informações gerais sobre a página do dashboard.
Figura 4 - Menu Inferior.
Ao clicar, será feita uma varredura em todo o dashboard, e, ao final, aparecerá uma janela informando os possíveis erros, avisos, informações de mensagens e relatório de prestação de mensagens;
Mostra o título do elemento selecionado no dashboard, podendo ser a página ou um componente de texto;
A coluna informa as coordenadas x e y do mouse ou do componente selecionado dentro do relatório, assim como largura e altura;
- 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.
- Define o valor do zoom do dashboard;
- Informa o zoom atual e ao clicar sobre a opção, ele apresenta outros valores de zoom.
Componentes
Os componentes possuem algumas propriedades na qual poderá utilizá-las para manipular os dados, posicionar e customizar os componentes no Dashboard.
Gráfico
Tabela
Mapa
Principais propriedades
Após selecionar um componente, é exibido na aba de propriedades (1 da figura 5) os elementos para configurarmos o comportamento, aparência e posição do componente, com isso será possível mudar para forma que desejar obter, filtrar e até customizar temas.
Figura 5 - Principais propriedades
- Aba de propriedades: exibida após selecionar o componente;
- Nome do componente selecionado: dependendo do componente selecionado, poderá haver subpropriedades diferentes, também é usado para mudar a forma de como os dados são exibidos;
- Posição: utilizado para definir a posição e tamanho do componente;
- Aparência: configura a aparência geral do componente;
- Comportamento: configurações de comportamento referente ao componente selecionado;
- Interação: configura a interação com o componente, podendo inserir hiperlink, filtro, drilldown e outras configurações;
- Margem: altera a margem do componente;
- Preenchimento: altera o preenchimento do componente
- Design: trava a posição do componente em relação ao Dashboard para evitar que seja movido por engano;
Propriedades específicas
O componente Tabela não possui propriedades específicas, mas ao contrário da maioria dos componentes, ele não possui o subcampo de formatação dos dados no campo Comportamento.
- Gráfico
- Área: Configura os dados dentro da área do componente gráfico, definindo alteração de cor entre colunas e suas posições;
- Rótulo: Se definido uma posição, aparecerá rótulos contendo informações dentro do gráfico, com isso, também é possível definir a cor; e outras configurações referente ao rótulo exibido;
- Legenda: configura a exibição da legenda no componente;
- Eixo X: área para configurações de rótulo referente ao Eixo X do gráfico;
- Eixo Y: área para configurações de rótulo referente ao Eixo Y do gráfico;
- Comportamento:
- Formato do argumento: possui máscaras pré-definidas para a exibição dos dados de argumento;
- Formato de valor: possui máscaras pré-definidas para a exibição dos dados de argumento;
- Comportamento:
- Formato de texto: possui máscaras pré-definidas para a exibição dos dados;
O elemento exibe a proporção dos dados de entrada. Pode ser apresentado em diferentes modos - uma torta, círculo, barras.
- Comportamento:
- Formato de texto: possui máscaras pré-definidas para a exibição dos dados;
- Imagem:
- Alinhamento Horizontal: Define o alinhamento Horizontal da imagem no componente imagem;
- Alinhamento Vertical: Define o alinhamento Vertical da imagem no componente imagem;
- Mapa da região
- Valor curto: Simplifica os valores exibidos no mapa ex: 100.000,00 muda para 100K.
- O K significa milhares e o M milhões.
- Valor curto: Simplifica os valores exibidos no mapa ex: 100.000,00 muda para 100K.