Dashboard

Como criar dashboards?

RTMENU.DASHBOARD.FAQ-37812
O funcionamento dos Dashboard é controlado por um menu. Para criar Dashboards e blocos, usa-se as interfaces RTMENU.CAD_MENU e RTMENU.CAD_ITEM_MENU respectivamente, onde uma dashboard seria um menu e seus blocos seriam os itens do menu. P.ex:

[img:dashboard]

[img:dashboard_blocos]

Quando existem vários dahsboards cadastrados, é importante informar um título diferente para cada um.

Vale lembrar que no blocos podemos usar qualquer interface do sistema ou relatório pré cadastrados em REPORTS.CAD_REPORT2, para relatórios deve-se usar o nome dado ao relatório no campo 'Nome da Interface'.

Além de poder adicionar qualquer interface ou qualquer relatório, pode-se configurar alguns aspectos/comportamentos através dos parâmetros listados a baixo.

ParametroDescrição
Z_COLUMNSDefine a quantidade de colunas que o bloco irá usar, lembrando que uma linha tem um total de 12 colunas. Quando não informado, assume 12.
Z_ACTIONDefine qual action da interface (determinada no item de menu) será apresentada no box
Z_REFRESHDefine se o box irá se atualizar de tempo em tempo o valor desta propriedade é em milissegundos (1000 = 1 segundo, 1 minuto = 60000 milissegundos, 30 minutos = 60000 * 30 = 180000)
Z_PADDINGDefine um espaçamento interno do box com o conteúdo (em pixels)
Z_COLLAPSEDefine que o box será apresentado fechado (necessitando clique do usuário para apresentar o conteúdo), caso o valor seja S
Z_HEIGHTDefine a altura do box, caso o conteúdo seja maior que o box, irá criar um scroll verticalmente
Z_RENDER_BUTTONSDefine se vai imprimir botões de ação
Z_GRAPHICDefine se o report será apresentado em forma de gráfico
Z_GRAPHIC_TYPEDefine o formato do gráfico, suportanto os valores, pie, bar, line
Z_ITEMSDefine quais colunas serão apresentadas ou retiradas das telas de lista. O valor deve conter os nome dos campos em maiúsculas, separados por vírgula. Para excluir colunas da tela de lista deve ser acrescentado o - (hífien) antes do nome do primeiro campo a ser excluído, como p.ex: -ESTADO,CIDADE para excluir as colunas de "estado" e "cidade" da tela de lista.
Z_RENDER_QUERY_OPERATORSDefine se vai imprimir a lista de query operators.
Z_REPORT_INTERFACEGeralmente utilizado para definir qual interface deve ser utilizada, e geralmente é PRO_REPORTS
Z_GROUP_BY Permite agrupar por uma ou mais coluna.
Z_ORDERPermite definir a ordenação dos itens.
Z_LIMITDetermina a quantidade de registros por página da lista (LIST). P.ex.: Se for informado 5, a lista será paginada de 5 em 5 registros.

Também podemos utilizar os QueryOperators como parâmetros, para saber mais clique aqui Como utilizar os Query Operators na passagem de parâmetros?, lembrando que todos parâmetros de query nos blocos deve começar com o prefix Q_[NOME_DO_CAMPO] para filtros adicionados automaticamente (binds) ou A_[NOME_DO_CAMPO] para campos adicionados manualmente.

OBS: Para filtros adicionados manualmente não existe QueryOperators então o paramêtro será A_[NOME_DO_CAMPO]=VALOR.

Ver também: