Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: DI-2732

O Dashboard é um painel digital onde é possível exibir, em tempo real, diversas informações de forma resumida, utilizando para isso, componentes como tabelas, gráficos, mapas e diversos outros recursos. A ferramenta de Dashboard do Cronapp é fácil de utilizar e possui diversos recursos.

A figura 1 exibe o diretório padrão do dashboard criado no Cronapp (Localização: Dashboards/ 

Tooltip
onlyIcontrue
appendIconinfo-circle

Endereço: src/main/java/dashboards/

), é possível acessá-lo através do seu atalho (destaque 1 da figura 1).


Image Modified

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 ou através do bloco de programação Abrir Dashboard.

Criação do Dashboard

Para ciar criar um arquivo de dashboard , acesse o menu de contexto de um diretório clique no botão (+) (destaque 1 da figura 1.1), recomendamos o diretório padrão  exibido ao lado do diretório Dashboards (Localização: Dashboards/ 

Tooltip
onlyIcontrue
appendIconinfo-circle

Endereço: src/main/java/dashboards/

) , selecioneou através do menu de contexto, selecionando Novo Dashboard(destaques 2 e 3 da figura 1.1) e na . Em seguida, na janela que abrir (destaque 2), informe o nome do arquivo e clique em OK (4).


Figura 1.1 - 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 componentes de arrastar e soltar, no qual os componentes são arrastados até a área de edição e ao solta-los, eles preenchem automaticamente o espaço que será utilizado junto com os outros componentes existentes no dashboard, podendo personalizá-los de diversas formas. Veja abaixo os espaços que compõe a ferramenta do dashboard. 


Figura 1.2 - Visão geral do dashboard


  1. Menu superior;
  2. Área lateral;
  3. Área de edição, local onde são organizados os componentes do dashboard.
  4. Menu inferior.

Âncora
menusuperior
menusuperior

Menu Superior

O Menu superior (Destaque em amarelo 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

Âncora
abainicio
abainicio

Aba Início

A aba início (Destaque amarelo 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

Âncora
abainserir
abainserir

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 formas, todos os outros componentes precisam estar relacionados com os campos de uma fonte de dados. No exemplo abaixo, Região Estados são campos obtidos de uma fonte de dados.


Figura 2.2 - Aba Inserir


  1. Tabela: insere uma tabela na área de edição.
  2. Gráfico: insere um gráfico na área de edição.
  3. Manômetro: insere um manômetro na área de edição.
  4. Tabela de Pivô: insere uma tabela de pivô na área de edição. Uma tabela de pivô é uma tabela dinâmica que serve para calcular, resumir e analisar os dados, permitindo ver comparações, padrões e tendências nos dados.
  5. Indicador: insere um indicador na área de edição que irá usar os dados para verificar se o valor está próximo da meta.
  6. Progresso: insere um componente que mostra o progresso de um atributo.
  7. 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 divididos por continentes, o segundo exibe todos os países de uma forma geral, como um mapa-múndi.
  8. Imagem: insere uma imagem na área de edição.
  9. Texto: insere uma área de texto.
  10. Painel: insere um painel na área de edição, nele é possível inserir outros componentes do dashboard.
  11. Formas: insere uma ou mais formas ao dashboard, como por exemplo, círculos, triângulos, setas, retângulos, etc.
  12. Filtros: insere um filtro a um determinado componente do dashboard.
  13. 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.

Âncora
abapagina
abapagina

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

Âncora
abalayout
abalayout

Aba Layout

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


Figura 2.4 - Aba Layout

Âncora
abaprevisualizar
abaprevisualizar

Aba Pré-visualizar

A aba pré-visualizar mostra uma prévia de como está ficando o dashboard sem ter que executar o projeto.


Nota

A pré-visualização se trata de uma apresentação parcial, modificações na fonte de dados podem demorar para renderizar, nesses casos, salve o arquivo, rode o projeto e visualize o dashboard executando dentro da aplicação.

Os Campos calculados da Fonte de dados não são exibidos na funcionalidade Pré-visualizar, somente em modo de execução.


Figura 2.5 - Aba Pré-visualizar

Âncora
arealateral
arealateral

Á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


  1. Ícone de atalhos: apresenta os principais componentes da aba inserir do menu superior;
  2. Propriedades: apresenta as propriedades do componente selecionado na área de edição do dashboard.
  3. Dicionário: área responsável por adicionar fontes de dados e disponibilizar funções prontas.
  4. Árvore de relatório: exibe uma lista dos componentes presentes no dashboard.
  5. Ícones de configuração do menu lateral: possui recursos diferentes a depender a aba aberta (Propriedades, Dicionário ou Árvore de relatório).
    • Propriedades: exibida apenas ao selecionar a aba Propriedades (destaque 2), possui os recursos para configurar o elemento selecionado;
    • Eventos: exibida apenas ao selecionar a aba Propriedades (destaque 2), possui os recursos para configurar eventos ao componente selecionado;
    • Colocações: possui opções diferentes a depender da aba selecionada:
      • Opções da aba Propriedades (destaque 2):
        • Localize Propriedades da Grade: permite alterar o nome dos campos das propriedades entre original e amigável.
      • Opções da aba Dicionário (destaque 3)
        • Criar Campo com Dois Clicks: ao ativar essa opção, não é possível abrir a tela de edição do atributo ao clicar 2 vezes;
        • Criar Rótulo: ativa ou desativa o rótulo;
        • Usar Aliases: ao ativar, irá mostrar apenas o apelido da fonte de dados, desativado, irá mostrar o nome da fonte junto ao apelido entre parênteses, ex: app_dados (dados gerais).
    • Fixar: Fixa ou desprende/minimiza o menu lateral do relatório.
  6. Segurança/Renderização: permite selecionar o perfil de usuário que terá acesso ao relatório e a forma como ele será exibido.

Âncora
propriedades
propriedades

Propriedades

A aba propriedades varia conforme o componente selecionado no dashboard, ela exibe todas as configurações que podem ser feitas no componente. É possível clicar e expandir as subabas (exemplo: Tabelas, Posição, Aparência, etc) para exibir todos os campos do componente.


Figura 3.1 - Propriedades do componente selecionado

Âncora
dicionario
dicionario

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.

Informações

Para utilizar esse recurso é preciso que haja uma fonte de dados associada ao dashboard, clique no menu Novo Item > Nova Fonte de Dados e selecionar a fonte de dados desejada.


Figura 3.2 - 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 novo 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 nova categoria de variáveis.
      • Nova variável: cria uma nova variável.
      • Novo recurso: cria um novo 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 dashboard.
    • 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 dashboard.
    • Funções: lista um conjunto de funções pré-definidas que podem ser utilizadas no dashboard.
    • Recursos: espaço destinado para armazenar recursos que podem ser utilizados no dashboard, 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.

Âncora
novaFonteDeDados
novaFonteDeDados

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 dashboard 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 dashboard, 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 3.2 e selecionando a opção Nova fonte de dados.


Figura 3.2.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 3.2.1.1 - 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 3.2.1.2) 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 3.2.1.2 - Janela de seleção de dados

Âncora
NovaTransformacao
NovaTransformacao

Nova transformação de dados

A janela Nova Transformação de Dados permite modificar/converter valores dos campos de uma ou mais Fonte de dados e criar um recurso a parte para ser utilizado em diversos locais do dashboard. É possível inserir os dados arrastando e soltando um atributo da fonte de dados (2 da figura 3.2) para o campo Organização de dados (5 da figura 3.2.2) ou selecionando uma opção no menu de contexto da área dos campos (2 da figura 3.2.2). 


Figura 3.2.2 - Nova Transformação de Dados


  1. Nome na Fonte: nome do diretório onde ficará o recurso no dicionário.
  2. Nome: nome do novo diretório onde será armazenado os atributos com dados transformados.
  3. Apelido: neste campo você pode especificar o nome da transformação, que será usado se o parâmetro Usar Aliases estiver habilitado nas configurações do Dicionário.
  4. Tabela de dados: exibe os valores das colunas e campos de dados.
  5. Organização de dados: campo destinado a armazenar os dados que serão transformados.
  6. Tipo: define o modo de um atributo selecionado, podendo ser Dimensão (ou A medida ():
    • Dimensão. esse tipo de campo não é aplicado a tipos de dados numéricos por padrão. Ao agrupar dados, os valores deste campo de dados serão a condição de agrupamento para valores de outros campos de dados.
    • A medida. por padrão, esse tipo de campo é aplicado a todos os tipos numéricos de dados. Além disso, esse tipo de campo de dados é usado se você precisar agrupar os valores do campo de dados atual pelos valores de outro campo de dados.
  7. Expressão: expressão que resultará no valor do campo selecionado. Também é possível utilizar funções para tratar o valor.
  8. Tipo: define o tipo de dado para o campo selecionado, exemplo: String, inteiro, datetime, byte[], etc.

Âncora
variaveies
variaveies

Variáveis

É possível criar variáveis para utilizar junto com textos, expressões e outros recursos do dashboard. Todas as variáveis são armazenadas no dicionário de dados e podem ser de diferentes tipos: string, data, hora, número, array, coleção, intervalo, etc. Antes de utilizar uma variável, é necessário adicioná-la ao dicionário de dados. Para adicionar uma variável, você pode selecionar Nova variável no menu Novo Item do dicionário de dados ou clicar com o botão direito no item Variável e em seguida Nova variável, como na imagem abaixo.


Figura 3.2.3 - Criando uma nova variável


  1. Nome:especifica o nome da variável usada no dashboard.
  2. Apelido:aplica um nome mais amigável ao nome da variável.
  3. Descrição: é possível adicionar algum comentário para a variável.
  4. Tipo: você pode alterar o tipo de dado que será colocado em uma variável e o seu formato. Este campo é representado por duas caixas de seleção, a primeira é uma lista de todos os tipos de dados, já a segunda informa o formato do dado:
    • Valor: define que a variável será um valor simples.
    • Nullable Valor: fornece a capacidade de colocar valores simples que podem ser iguais a null. 
    • Faixa: permite trabalhar com intervalos de valores. Nesse caso, a variável armazenará um intervalo de valores.
    • Lista:fornece a capacidade de colocar uma lista de valores de qualquer tipo de dados disponível. Ao contrário da variável Valor, neste caso, na renderização do dashboard, a variável contém uma lista de valores.
  5. Iniciar por: caixa de seleção para definir o tipo de conteúdo da variável, "Valor" ou "Expressão".
  6. Valor / Expressão: este campo especifica o conteúdo a ser armazenado na variável. Se o campo Iniciar por (5) estiver configurado como "Valor", o campo atual espera receber um conteúdo fixo, como um texto ou número, porém, caso a opção "Expressão" esteja selecionada no campo Iniciar por (5), o campo atual espera receber uma expressão, como um cálculo matemático ou função do sistema.
  7. Somente leitura: o valor armazenado em uma variável é retornado e o usuário não pode alterá-lo.
  8. Solicitado ao usuário: estabelece um modo onde é possível definir o parâmetro de entrada. Ao marcar essa opção, novos campos de configurações de parâmetros serão exibidos. 

Âncora
variaveis-faixa
variaveis-faixa

Variável tipo Faixa

A opção Faixa permite trabalhar com um intervalo de valores. Ao selecionar a opção faixa, a janela Nova Variável sofre algumas alterações.


Figura 3.2.4 - Nova Transformação de Dados


  1. Tipo: ao selecionar a opção "Faixa", na segunda caixa de seleção, os campos "De" (3) e "Para" (4) serão exibidos.
  2. Iniciar por: caixa de seleção para definir o tipo de conteúdo da variável, "Valor" ou "Expressão".
  3. De: especifica o valor inicial do intervalo. O valor neste campo é incluído no intervalo de valores. No nosso caso a data 01/01/2022; 00:00:01 é especificado
  4. Para: especifica o valor final do intervalo. O valor neste campo é incluído no intervalo de valores. No nosso caso a data 07/04/2022; 23:59:59 é especificado.

Âncora
variavelSistema
variavelSistema

Variáveis de sistema

As Variáveis de sistemaencontram-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.5 - Variáveis de Sistema


Variável Descrição
ColumnRetorna o número da coluna atual (começa em 1).
LineRetorna o número da linha atual (começa em 1).
LineThroughRetorna 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.
LineABCRetorna o análogo alfabético do número da linha atual.
LineRomanRetorna o número da linha atual em algarismos romanos.
GroupLineRetorna o número da linha do grupo atual (começa em 1).
PageNumberRetorna o número da página atual (começa em 1). Usado para numerar páginas.
PageNumberThroughRetorna 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.
PageNofMRetorna 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.
PageNofMThroughRetorna 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.
TotalPageCountRetorna o número de páginas em um dashboard.
TotalPageCountThroughRetorna 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.
IsFirstPageRetorna verdadeiro, se, no momento atual, for impressa a primeira página de um dashboard.
IsFirstPageThroughRetorna 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.
IsLastPageRetorna 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.
IsLastPageThroughRetorna 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.
PageCopyNumberRetorna o número de uma cópia atual de uma página (começa em 1).
ReportAliasRetorna o alias de um relatório. Você pode alterar o ReportAlias com a ajuda da propriedade ReportAlias de um dashboard.
ReportAuthorRetorna o autor de um relatório. Você pode alterar ReportAuthor com a ajuda da propriedade ReportAuthor de um dashboard.
ReportChangedRetorna a data em que um dashboar foi alterado.
ReportCreatedRetorna a data em que um dashboard foi criado.
ReportDescriptionRetorna a descrição de um dashboard. Você pode alterar o ReportName com a ajuda da propriedade ReportDescription de um dashboard.
ReportNameRetorna o nome de um dashboard. Você pode alterar o ReportName com a ajuda da propriedade ReportName de um dashboard.
TimeRetorna a hora atual.
TodayRetorna a data atual.

Âncora
funcoessistemas
funcoessistemas

Funções

As funções possuem elementos que são usados para tratar ou calcular os dados obtidos no dashboard, cada grupo possui várias funções e os principais grupos são: Matemática, Data, Edição de palavras e Cálculo de agrupamento.


Figura 3.2.6 - 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.
WeekOfYearExibe 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 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.

Âncora
arvoreRelatorio
arvoreRelatorio

Árvore de relatório

A aba Árvore de relatório exibe de forma hierárquica todos os elementos e itens contidos no dashboard, facilitando a seleção de componentes sobrepostos.


Figura 3.3 - Árvore de relatório

Âncora
segurancaRenderizacao
segurancaRenderizacao

Segurança e Renderização

A funcionalidade Segurança/Renderização permite selecionar o perfil de usuário que terá acesso ao dashboard e a forma como ele será exibido (PDF ou HTML).


Figura 3.4 - Segurança/Renderização


  1. Segurança/Renderização: abre uma janela com as opções de renderização e segurança.
  2. Renderização: exibe um menu com três opções de visualização do dashboard:
    • PDF: gera um pdf do dashboard criado e exibe para o usuário.
    • HTML: gera um dashboard em formato HTML.
    • PDF-Servidor: processa o dashboard no servidor da aplicação e exibe em formato PDF.
  3. Segurança: abre uma janela com a opção Permitir Obter (visualização).
  4. Permitir Obter: abre a janela de exibição dos tipos de usuários que estarão habilitados para visualizar o dashboard.
  5. Janela de seleção do(s) permissionáveis: seleciona os permissionáveis que terão acesso ao dashboard.

Âncora
menuinferior
menuinferior

Menu Inferior 

Apresenta informações gerais sobre a página do dashboard.


Figura 4 - Menu Inferior


  1. 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.

  2. Mostra o título do elemento selecionado no dashboard, podendo ser a página ou um componente.

  3. A coluna informa as coordenadas x e y do cursor do mousedentro do relatório, assim como largura e altura do componente selecionado.

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

Âncora
componentes
componentes

Componentes

Componentes do dashboard são recursos que obtém uma série de dados e os apresenta de forma resumida, simples e intuitiva, facilitando, por exemplo, decisões estratégias. O Dashboard do Croanpp possui diversos componentes, como tabelas, gráficos, mapas, indicadores de progresso e outros. Esses componentes podem ser utilizados de forma isolada ou agrupados com outros componentes. Assim, se dois ou mais componentes possuem a mesma base de dados, ao realizar um filtro sobre um dos componentes, todos os outros receberão o mesmo filtro automaticamente.

Para inserir um componente ao seu dashboard, clique sobre ele na aba Inserir (1 da figura 5), em seguida clique na área de edição (2), após isso aparecerá uma janela na qual será possível inserir os dados que você irá trabalhar no componente (3 da figura 5). Selecione os dados e arraste do dicionário até a janela (4). 


Dica

Para utilizar os recursos da aba Dicionário, é necessário selecionar uma fonte de dados. Assim, na aba Dicionário, clique no menu Novo Item > Nova Fonte de Dados e selecionar a fonte de dados desejada.


No exemplo abaixo estamos utilizando o componente Tabela e selecionando o atributo "data" da fonte de dados para arrastar até a janela de configuração do componente.


Figura 5 - Configuração básica de um componente

Detalhes dos componentes

Todos os componente do dashboard apresentam um padrão de disposição de alguns itens usados para configuração, assim como em seu menu de contexto, confira na figura abaixo.


Figura 5.0.1- Detalhes de um componente


  1. Ordem: este ícone está presente somente nos componente gráfico e através dele é possível ordenar os dados de acordo com o eito X ou Y.
  2. Habilitar/Desabilitar título: propriedade responsável por exibir ou não o título do componente.
  3. Editor: exibe a janela de inserção de dados com os dados atuais do componente.
  4. Filtros: a ferramenta Filtros é usada para filtrar dados de um elemento 
  5. Alterar Tipo: ao clicar nesta propriedade, será exibida uma lista com todos os componentes visuais do dashboard, clique em qualquer um deles para alternar o componente atual por outro de sua escolha.
  6. Copiar: copia o componente para a área de transferência.
  7. Recortar: recorta o componente para a área de transferência.
  8. Colar: cola o componente que foi copiado ou recortado.
  9. Excluir: deleta o componente.
  10. Propriedades: exibe as propriedades do componente na aba dicionário.
  11. Alinhamento: exibe propriedades de alinhamento do componente, são elas:
    • Alinhar à Grade: alinha o componente em relação a grade.
    • Alinha à Esquerda: alinha o componente à esquerda.
    • Alinhar ao Centro: alinha o componente ao centro.
    • Alinhar à Direita: alinha o componente à esquerda
    • Alinhar ao Topo: alinha o componente em relação ao topo. 
    • Alinhar ao Meio: alinha o componente ao meio.
    • Alinhar à Base: alinha o componente em relação a base.
    • Igualar o Espaçamento Horizontal: iguala os espaçamentos em branco de forma horizontal.
    • Igualar o Espaçamento Vertical: iguala os espaçamentos em branco de forma vertical.
    • Centralizar Horizontalmente: centraliza horizontalmente o componente.
    • Centralizar Verticalmente: centraliza verticalmente o componente.
  12. Ordem: exibe propriedades de movimentação do componente, são elas:
    • Trazer para frente: move o componente para frente de todos os outros elementos.
    • Enviar para trás: move o componente para trás de todos os outros elementos.
    • Mover para frente: move o componente apenas uma camada à frente.
    • Mover para trás: move o componente apenas uma camada à trás.
  13. Habilitado: habilita ou desabilita o componente.

Âncora
comptabela
comptabela

Tabela

A Tabela (Destaque 1 da figura 5.2) é um componente de análise de dados que permite cruzar os dados em 2 dimensões (linhas e colunas). Fornece a capacidade de exibir valores de campo de dados nos modos Medida Dimensão, bem como aplicar Barras de dadosEscala de coresIndicadorMinigráficos aos valores do campo de dados. Além disso, o componente de tabela possui configurações para agregação de dados como filtragem, classificação, substituição de valores, cálculo de um total cumulativo, etc. 

Após incluir o componente Tabela ao editor e selecionar os atributos que serão trabalhos (figura 5), será possível tratar os dados que serão exibidos no componente (Figura 5.1)


Figura 5.1 - Janela de dados do componente


  1. Área onde contém os atributos selecionados.
  2. Tipo: define o formato do atributo selecionado, dependendo do tipo é possível manipular seu valor com funções ou outros recursos, 
  3. Expressão: permite tratar o valor do atributo selecionado a partir de funções do sistema.
  4. Mais algumas formas de exibição dos dados:
    • Visível: esconde ou exibe a coluna do atributo selecionado (destaque 1 da figura 5.1);
    • Show Total: cria uma linha de sumário ao final da coluna;
    • Mostrar hyperlink: se preferir, poderá marcar essa opção para mostrar o dado em forma de hyperlink.
  5. Interação: recursos básicos de interação com usuário, como dica de ferramenta e filtros.


Figura 5.2 - Componente Tabela


Âncora
compgrafico
compgrafico

Gráfico

Esse componente possui diversos formato de gráfico para análise dos dados apresentados. Usando quando os dados podem ser processados e o resultado é exibido em forma de gráfico. Fica localizado na aba Inserir (Destaque 1 da figura 5.3).


Figura 5.3 - Componente Gráfico


Assim como mostrado acima, o componente gráfico possui diversos tipos de formas de exibição, são eles, Coluna, Linha, Série, Pizza e outros.

Âncora
compmanometro
compmanometro

Manômetro

O Manômetro é um medidorcom o qual você pode exibir o valor processado do campo de dados (Destaque 1 da figura 5.4).


Figura 5.4 - Componente Manômetro

Âncora
comptabeladepivo
comptabeladepivo

Tabela de pivô

A Tabela de pivô (Destaque 1 da figura 5.5), também conhecida como tabela cruzada é diferente do componente Tabela, além de processar os dados, é usado para agrupar e resumir valores de dados por linhas e colunas, mudando sua forma de exibição.



Figura 5.5 - Componente Tabela de Pivô

Âncora
compindicador
compindicador

Indicador

Indicador (Destaque 1 da figura 5.6) é um componente do dashboard que representa a capacidade de exibir o valor agregado do campo de dados, bem como a taxa de aumento desse valor para o destino. Além disso, a taxa de crescimento e o valor agregado do indicador podem ser agrupados por uma condição.


Figura 5.6 - Componente Indicador

Âncora
compprogresso
compprogresso

Progresso

O Progresso (Destaque 1 da figura 5.7) é um componente do dashboard que representa a capacidade de exibir a taxa de crescimento de um valor inicial em relação ao valor final.


Figura 5.7 - Componente Progresso

Âncora
compmapa
compmapa

Mapa

Existem duas opções para o componente Mapa: Mapa da região e Mapa Online (Destaque 1 da figura 5.8).

  • Mapa da região: permite selecionar um mapa interativo de diversas regiões do globo, sendo possível referenciar um objetivo para cada região do mapa selecionado.
  • Mapa Online: utiliza o mapa online Bing e referência com os dados vinculados.


Figura 5.8 - Opções do componente de Mapa

Âncora
compimagem
compimagem

Imagem

Imagem (Destaque 1 da figura 5.9) é um componente com o qual você pode vincular com arquivo no formato de imagem. O componente Imagem suporta os seguintes tipos de arquivos: BMP, PNG, JPEG, TIFF, GIF, PNG, ICO, EMF, WMF e SVG.


Figura 5.9 - Componente Imagem

Âncora
comptexto
comptexto

Texto

Texto (Destaque 1 da figura 5.10) é um componente que permite exibir qualquer texto ou o resultado de uma expressão especificada. Uma expressão pode ser uma referência a uma variável do sistema, uma coluna de dados ou função do sistema.


Figura 5.10 - Componente Texto

Âncora
comppainel
comppainel

Painel

O Painel é um componente no qual é possível agrupar outros componentes, incluindo outros painéis.


Figura 5.11 - Componente Painel

Âncora
compformas
compformas

Formas

Forma (Destaque 1 da figura 5.12) é um componente que possui várias formas prontas e pode auxiliar na estrutura do Dashboard.


Figura 5.12 - Componente Formas

Principais propriedades

Os componentes possuem algumas propriedades para manipular os dados, posicionar e customizar os componentes dentro da área de edição do dashboard. Após selecionar um componente na área de edição, será exibido a aba de propriedades (1 da figura 6) com os diversos campos de configuração desse componente. 


Figura 6 - Propriedades agrupadas nas subabas acordeão


Abaixo um resumo das propriedades contidas na maioria dos componentes (Figura 6).

  1. Aba de propriedades: exibe a lista de propriedades do componente selecionado.
  2. Nome do componente selecionado: caixa de seleção que exibe o nome do componente selecionado e permite alternar entre os componentes contidos na área de edição.
  3. Posição: utilizado para definir a posição e tamanho do componente.
  4. Aparência: configura a aparência geral do componente.
  5. 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.
  6. Design: trava a posição do componente em relação ao Dashboard para evitar que seja movido por engano.

Propriedades específicas

Alguns componentes possuem propriedades específicas.

Componente

Propriedade

Descrição

Tabela

ComportamentoO 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.

Tabela de Pivô

ComportamentoO componente Tabela de Pivô 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

Gráfico e 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.

Indicador

Comportamento

Formato de texto: possui máscaras pré-definidas para a exibição dos dados.

Progresso

Comportamento

Formato de texto: possui máscaras pré-definidas para a exibição dos dados.

Imagem

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

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.

Âncora
funcoes
funcoes

Funções

Dependendo do tipo de valores, a lista de funções utilizadas pode variar. A tabela abaixo contém uma lista de funções que podem ser aplicadas aos campos de dados nos campos Expressão.


Função

Descrição

Count()

Calcula o número de valores no campo atual.

DistinctCount()

Calcula o número único de valores no campo atual.

First()

Exibe o primeiro valor do campo de dados atual.

Last()

Exibe o último valor do campo de dados atual.

Sum()

Exibe o resultado da some dos valores no campo de dados atual.

Avg()

Calcula a média aritmética para os valores do campo atual.

Min()

Exibe o valor mínimo do campo de dados atual.

Max()

Exibe o valor máximo do campo de dados atual.

Median()

Exibe a média (não aritmética) do campo de dados atual.

Year()

Exibe o ano a partir da codificação da data.

Quarter()

Exibe o trimestre da codificação de data.

Month()

Mostra o mês a partir da codificação de data.

Day()

Exibe o dia a partir da codificação da data.

PercentOfGrandTotal()

Ele mostra a gravidade específica de um valor da soma de todos os valores da coluna de dados atual. Se você aplicar a formatação de porcentagem a este campo de dados, a porcentagem do valor de 100 por cento será exibida.


Na figura 6  é possível conferir a aplicação de uma dessas funções listadas na tabela acima.


Figura 7 - Aplicação da função Year() na coluna Data


  1. Coluna exibindo os dados após o uso da função;
  2. Função Year() sendo aplicada no atributo "data" da fonte de dados.

Funções que podem ser adicionadas a partir do dicionário de dados ou inseridas manualmente.


FunçãoDescrição

CountIf(,)

Essa função permite que você calcule o número de valores no campo de dados atual, através de uma condição, por exemplo:

CountIf(DataSource.Column1, DataSource.ColumnID > 5)

SumIf(,)

Essa função exibe o resultado da soma de valores do campo de dados atual através de uma determinada condição, por exemplo:

SumIf (DataSource.Column1, DataSource.ColumnID > 5)

Mode()

Exibe os valores que se repetem com maior frequência no campo de dados atual.

List()

Insere uma lista de valores para o campo de dados atual de um item.

Array()

Insere um array de valores para o campo de dados atual de um item.

ToUpperCase()

Converte todos os valores do campo para maiúsculo.

ToLowerCase()

Converte todos os valores do campo para minúsculo. 

ToProperCase()

Converte o primeiro caractere para maiúsculo e deixa todo o resto em minúsculo. 

Insert(,,)

Insere texto em valores de campo de dados, após um caractere específico. 
Três argumentos são especificados por meio do delimitador ",":

  1. Campo de dados;
  2. O número ordinal do caractere após o qual outro valor será inserido;
  3. O valor a ser inserido.

Replace(,,)

Substitui determinados caracteres em valores.
Três argumentos são especificados através do delimitador ";":

  1. Campo de dados;
  2. Um caractere ou um conjunto de caracteres que precisam ser substituídos;
  3. O valor a ser substituído.

Remove(,,)

Remove um número específico de caracteres nos valores.
Três argumentos são especificados através do delimitador ";":

  1. Campo de dados;
  2. O número ordinal do caractere a partir do qual a remoção é iniciada;
  3. Número de caracteres a ser removido,

DayOfWeek()

Mostra o dia da semana a partir da codificação de data.

DayOfWeekIdent()

Mostra os dias da semana a partir da codificação da data, ordenados na ordem de domingo a sábado.

Além disso, esta função é usada para classificar os dias da semana, se o tipo de campo de dados for definido como string.

DaysInMonth()

Exibe o número de dias em um mês.

DaysInYear()

Exibe o número de dias por ano.

Month()

Exibe o número de meses.

MonthIdent()

Mostra os nomes dos meses a partir da codificação da data, classificados na ordem de janeiro a dezembro.

Além disso, esta função é usada para classificar meses, se o tipo de campo de dados for definido como string.

Quarter()

Mostra os nomes abreviados dos trimestres do ano, classificados na ordem do primeiro trimestre ao quarto.

ISO2()

Exibe o código de duas letras do objeto geográfico.

ISO3()

Exibe o código de três letras de um objeto geográfico.

NormalizeName()

Exibe os nomes dos objetos geográficos por padrão.

Left(,)

Exibe o número especificado de caracteres do lado esquerdo do valor.
Dois argumentos são especificados através do delimitador ";"

  1. Campo de dados;
  2. O número de caracteres a ser exibido.

Mid(,,)

Exibe caracteres de um valor.
Três argumentos são especificados através do delimitador ";":

  1. Campo de dados;
  2. O número ordinal do caractere com o qual iniciar a exibição;
  3. O número de caracteres a serem exibidos.

Right(,)

Mostra o número especificado de caracteres do lado direito do valor.
Dois argumentos são especificados por meio do delimitador ",":

  1. Campo de dados;

  2. O número de caracteres a ser exibido

Substring(,,)

Mostra caracteres de um valor.
Três argumentos são especificados por meio do delimitador ",":

  1. Campo de dados;
  2. O número ordinal do caractere com o qual iniciar a exibição.
  3. O número de caracteres a serem exibidos.

Image()

Ele permite que você obtenha imagens da URL e as exiba nos intervalos do componente Tabela.

Você também deve especificar a altura e a largura nos argumentos da função para imagens SVG.

Por exemplo, Image(DataSource.DataColumn1, 10, 15), em que DataSource.DataColumn1 contém URL para imagens SVG.

Nesta página

Índice
maxLevel4
printablefalse