Dashboard

Este componente permite combinar cartões informativos, gráficos e outros elementos visuais num formato visual que permite a rápida visualizaçção de diferentes indicadores na tela.

Exemplos

Veja no link abaixo um exemplo da API em funcionamento: Exemplo On-Line em Maker 2.7

Como usar

Adicione uma moldura no formulário onde deseja exibir o dashboard, no “Ao Entrar” ou outro evento qualquer utilize a função “Dashboard – Criar componente” para criar o dashboard.

Na criação você também irá definir qual fluxo irá retornar os dados dos itens exibidos no componente.

Retornando os valores do dashboard

Ao iniciar o componente o fluxo de dados será acionado para receber as diferentes informações que compõe o dashboard. São dois parâmetros de entrada:

  1. ID – Vêm preenchido com o código do item a ser retornado, podendo estar vazio indicando que todos os itens devem ser retornados;
  2. Tipo – Indica a informação desejada, podendo assumir um dos valores abaixo:
  • ALL – Indica que todos os itens devem ser retornados, é chamado normalmente na inicialização do componente;
  • MENU – Indica que as opções de menu (botão direito) de um item estão sendo solicitadas;
  • ITEM – Indica que os dados de um único item (identificado no ID) deve ser retornado. Normalmente é chamado na atualização do item.

Retornando as categorias/grupos

As categorias permitem filtrar quais componentes estarão visiveis.

Retornando os itens

Geral

  • id” – Código único desse item no dashboard;
  • titulo” – Identificação no topo do item;
  • grupo” – Aba onde este gráfico aparece;
  • tamanho” – Núemro de blocos que o item irá ocupar: LARGURAxALTURA . Exemplo “1×1” (padrão) “2×2” duas colunas e linhas , “2×1” duas colunas e uma linha;
  • tipo” – “GRUPO“, “ITEM“, “GRAFICO“;
  • grafico” – “VELOCIMETRO“, “LINHAS“, “FUNIL“, “BARRAS“, “PIZZA“.

Velocímetro

Mostra um controle no estilo de um velocímetro/marcador de combustível. O tamanho recomendado é 2 (largura) x 1 (altura), ou 2×2 para visualização correta deste item.

  • grafico” – “VELOCIMETRO
  • dados” – Mapa com o valores:
    • minValue” – Valor quando ZERADO (limite inferior);
    • value” – Posição do ponteiro;
    • maxValue” – Valor quando cheio (limite superior);

Retornando os dados das opções do menu

Cada item pode ter ações associadas ao botão direito.

Deve ser retornado um mapa com as chaves contendo um mapa com as opções do menu, sendo as seguintes entradas do mapa:

  • id – Código que identifica a opção do menu;
  • titulo – Descrição / Titulo que irá ser exibido na tela;

Eventos

  • CLICK
  • DBLCLICK