Interface DASHBOARD2

Dashboard

RTMENU.DASHBOARD2

Descri��o

Interface que permite a constru��o de uma dashboard baseado em menu disponibilizado por par�metro ou prefer�ncia de usu�rio RTMENU.DASHBOARD.DEFAULT_DASHBOARD que deve ter o valor de uma nome de menu EX: ENTRADA

Lista de par�metros que podem ser usados nos itens de menu:

Parametro	Descri��o
Z_COLUMNS	Define 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_ACTION	Define qual action da interface (determinada no item de menu) ser� apresentada no box
Z_BOX	Define se o "box" por volta do conte�udo ser� renderizado
Z_REFRESH	Define 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_PADDING	Define um espa�amento interno do box com o conte�do (em pixels)
Z_COLLAPSE	Define que o box ser� apresentado fechado (necessitando clique do usu�rio para apresentar o conte�do), caso o valor seja S
Z_HEIGHT	Define a altura do box, caso o conte�do seja maior que o box, ir� criar um scroll verticalmente
Z_RENDER_BUTTONS	Define se vai imprimir bot�es de a��o
Z_GRAPHIC	Define se o report ser� apresentado em forma de gr�fico
Z_GRAPHIC_TYPE	Define o formato do gr�fico, suportanto os valores, pie, bar, line
Z_ITEMS	Define 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_OPERATORS	Define se vai imprimir a lista de query operators
Z_REPORT_INTERFACE	Define a interface que ser� utilizada para apresenta��o da consulta. P.ex: PRO_REPORTS. A interface padr�o dos dashboards � PRO_REPORT2. obs: caso precise apresentar os registros agrupados via Z_GROUP_BY deve-se obrigatoriamente utilizar a PRO_REPORTS.
Z_SHOW_TOTAL_RECORDS	Define se vai ser apresentando o total de registros nas listas agrupadas.
Z_SHOW_PERCENTAGE	Define se vai ser apresentado o coluna com o % que representa aqueles registros na consulta para listas agrupadas.

Ver tamb�m:

Campos:

Menu:	Nome global do menu. Ser� tipicamente formado por SISTEMA.NOME.
Sequ�ncia:	N�mero usado para ordenar os menus. �til apenas para ordenar os menus que s�o topo.
Descri��o:	Texto livre para descrever o menu. Meramente informativo. Ex: Op��es de configura��o e parametriza��o do sistema.
Topo:	Indica se o menu deve ou n�o aparecer no topo da aplica��o. O "topo" ser� calculado como "S" se existir um usu�rio apontando para ele, ou a prefer�ncia do menu padr�o apontar para ele.
T�tulo:	T�tulo do menu (texto que aparece no mesmo).
Par�metros:	Par�metros que s�o repassados para os itens de menu. Este campo � utilizado somente em menus que representam dashboards (nome do menu inicia com DASHBOARD_), n�o possuindo aplica��o para os demais menus. Os par�metros informados no menu n�o se sobrep�em aos par�metros informados itens do menu da dashboard (Itens de menu). Os par�metros que podem ser informados obedecem as mesmas configura��es definidas para Dashboard.
Em uso:	Esse atributo indica que o menu est� sendo utilizado. Seu valor ser� calculado, se o menu tem relacionamentos com usu�rio, itens de menus e/ou aplica��es(aplicacoes_sistemas) seu valor ser� S, caso contr�rio ser� N.
Ativo:	Indica se o menu est� ou n�o ativo. Somente menus ativos podem ser utilizados no sistema.
Tipo:	Classifica o menu quanto ao seu tipo. Menu - Utilizado como menu tradicional. Dashboard - Defini��o de um dashboard Launchpad - Defini��es de um launchpad para disparar interfaces. Shortcuts - Utilizado para definir atalhos diretos para o sistema.

Opera��es

Topo

Consultar

A consulta de um registro � realizada quando o usu�rio clica no primeiro link de um dos registros resultantes a opera��o [b:Listar]. A tela apresenta as informa��es detalhadas do registro, bem como as a��es que o usu�rio pode disparar a partir dele (alterar, excluir, cancelar, etc.).

Topo

Listar

Apresenta uma lista com os registros que atendem aos filtros informados.
A lista possui diversos recursos pr�ticos e importantes para o usu�rio:

Clique no link apresentado na primeira coluna para acessar um registro espec�fico. Voc� tamb�m pode usar as teclas (seta para baixo) e (seta para cima) para navegar entre os registros apresentados para acess�-lo.
Normalmente, o cursor fica ativo no link do primeiro registro, ou no registro que estava sendo acessado no caso do usu�rio voltar para a lista ap�s acessar um registro espec�fico.
� poss�vel reordenar a lista clicando no t�tulo da coluna desejada. Clicar no t�tulo de uma coluna que j� est� sendo ordenada, inverte o sentido da ordena��o (ascendente/descendente). Clicar no link juntamente com a tecla SHIFT, acrescenta a coluna � ordena��o j� imposta, permitindo ordenar primeiro por uma coluna e segundo por outra.
Ao clicar no �cone de agrupamento, a lista � refeita apresentando todas as informa��es totaliz�veis dos registros agrupados pela respectiva coluna.
No canto superior direito da tabela com a lista, existe um �cone que, ao ser clicado, abre um pequeno menu que permite o usu�rio configurar a tabela.
No menu de configura��o da tabela, o usu�rio pode escolher quais colunas devem ser apresentadas e em que posi��o.
No menu de configura��o da tabela, o usu�rio pode gerar uma pivot da mesma.
Antes da lista, s�o apresentados os filtros aplicados. Cada filtro possui um pequeno "x" que pode ser utilizado para exclui-lo. Ao fazer isso, a lista � automaticamente atualizada.

Topo	Em uso	Ativo	Tipo
N�o	N�o	N�o	Menu
Sim	Sim	Sim	Dashboard
N�o	N�o	N�o	Launchpad
Sim	Sim	Sim	Shortcuts

Topo

Dashboard

Tela de apresenta��o da dashboard.
Topo

Atalhos

Bloco para uso nas dashboard, onde apresenta uma lista de atalhos importante para o usu�rio
Topo

Carregar item

Carrega itens individuais da dashboard para chamadas via ajax atrav�s do par�metro Z_REFRESH.
Topo

Pesquisar

Ao pesquisar, o usu�rio poder� informar crit�rios de filtro para listar apenas os registros desejados. Normalmente depois de informar os filtros desejados, o usu�rio dever� executar a opera��o [b:Listar].
Obtenha maiores detalhes em Como utilizar a tela de pesquisa?.
Topo

Alterar

Fun��o que ir� alterar o dashboard

Topo

Tornar padr�o

A opera��o vai alterar a prefer�ncia do usu�rio para que o dashboard escolhido seja o padr�o para o usu�rio ao entrar no sistema.
Topo

Pesquisa gen�rica

Campos utilizados para pesquisa gen�rica

Configura��es

RTMENU.DASHBOARD2.DEFAULT_DASHBOARD

Define o menu que ser� apresentado como dashboard padr�o para o usu�rio.

Tipo: TEXT

RTMENU.DASHBOARD2.SQL_MACROS

SQL para incluir suporte a par�metros adicionais

Quando informado, indica um SQL que poder� ser usado para incluir o suporte a par�metros adicionais nas chamadas ao DASHBOARD.

Um exemplo de uso t�pico (padr�o no ELIGO), � a inclus�o do c�digo da pessoa associada a sess�o corrente:

select pessoa as PERSON from pessoas where id = [PERSON_ID];

Neste exemplo, a macro [PERSON] ser� automaticamente substitu�da pelo c�digo de pessoa do usu�rio da sess�o.
O SQL pode utilizar qualquer vari�vel da sess�o corrente, tais como USER_ID, PERSON_ID, etc.

Tipo: SOURCE_CODE

�ndice

Dashboard

Descri��o

Lista de par�metros que podem ser usados nos itens de menu:

Campos:

Opera��es

Consultar

Listar

Dashboard

Atalhos

Carregar item

Pesquisar

Alterar

Tornar padr�o

Pesquisa gen�rica

D�vidas frequentes

Configura��es

RTMENU.DASHBOARD2.DEFAULT_DASHBOARD

RTMENU.DASHBOARD2.SQL_MACROS