Como configurar o cabe�alho e o rodap� das interfaces?

RT.FAQ-8201

O cabe�alho e rodap�s das p�ginas do sistema s�o regidos pelos par�metros de configura��o "APP.UI.HEADER_CONTENT" e "APP.UI.FOOTER_CONTENT" que cont�m o respectivo c�digo HTML. Estes c�digos permitem o uso de placeholders identificados na forma ${nome}. Os placeholders dispon�veis devem estar registrados na classe PlaceHoldersMap. Por padr�o, a T2 registra automaticamente os seguintes placeholders:

${logo}: = Logotipo (ou nome) da aplica��o registrado no par�metro APP.UI.LOGO com um link para a p�gina de entrada do sistema. Esta p�gina � definida atrav�s das preferencias RT.UI.HOME_INTERFACE e RT.UI.USER_HOME_INTERFACE.
${menu} = Estrutura completa de HTML do menu do usu�rio no sistema.
${auth} = Informa��es sobre o usu�rio que est� logado, bem como link para fazer login ou logout;
${version} = Vers�o do sistema retirado do WebXML (APP.VERSION)
${build} = Vers�o do build (APP.BUILD)
${notifications} = Representa o C�digo HTML (�rea) para apresenta��o das notifica��es do sistema
${time} = Data e hora da aplica��o
${globalName} = Nome global da interface acessada no momento
${interfaceName} = Nome da interface, sem o nome do sistema/subsistema.
${interfaceTitle} = T�tulo da interface
${user} = Nome do usu�rio que est� logado
${company} = Nome da empresa (APP.EMPRESA)
${memoryUsage} = Percentual de mem�ria ocupado (objetos Java)
${instance} = Nome da instancia definido pelo par�metro APP.NAME.

Importante

Caso esta configura��o seja realizada por preferencia de sistema e a replica��o estiver ativada, as configura��es ser�o atualizadas em todas as bases replicadas.
Para que isto n�o ocorra, deve-se utilizar as configura��es em arquivos .css, por inst�ncia de sistema - ver FAQ 8203.

Como criar placeholder customizados

Para criar novos placeholders com conte�dos espec�ficos para uma aplica��o, deve-se simplesmente registrar um objeto na classe PlaceHoldersMap. Este registro deve ser feito preferencialmente na inicializa��o do sistema (evento ON_START de algum sub-sistema). O placeholder � apenas um objeto cujo m�todo toString() retorna o conte�do desejado.

Exemplo:
Digamos que se deseja criar um placeholder que apresente o nome do banco de dados em uso:

PlaceHoldersMap.getInstance().put("build", new Object() {
   @Override
   public String toString() {
       BaseRuntime ctx = BaseRuntime.getContext();
       try {
           return ctx.getDbName();
       } catch (AdsException ignore) { }
       return "";
   }
});

Notas:

Como o placeholder precisa apenas da implementa��o do m�todo toString(), o uso de inner-class an�nima � bastante conveniente.
Os placeholders s�o objetos instanciados uma �nica vez e reutilizados por todas as sess�es da aplica��o, portanto, estes objetos N�O DEVEM MANTER ESTADO a n�o ser de elementos que s�o objetos n�o mutantes entre as sess�es.
A package br.com.telescope.t2.view.placeholder possui v�rios exemplos de placeholders que podem servir como exemplo.

Valor default para APP.UI.HEADER_CONTENT

${logo}
<nav id=\"main\">${menu}</nav>
<section class=\"user-options\">${auth}</section>

Valor default para APP.UI.FOOTER_CONTENT

<section class=\"global-name\">${globalName}</section>
<section class=\"version\">${version}</section>
<section class=\"current-time right\">${time}</section>
${notifications}

Sugest�o de c�digo para o footer do Eligo

Criar prefer�ncia de sistema APP.UI.FOOTER_CONTENT com o seguinte conte�do:

<table width="100%">
<tr>
<td>
<section class="global-name">${globalName}</section><section class="version">v${version}</section>
<section class="build">(${build})</section>
<section class="memory-usage">Memory used: ${memoryUsage}</section>
</td>
<td>
<section class="current-time">${time}</section>
</td>
<td>${notifications}
</td>
<td align="right">
<section class="links">
<ul>
<li>
<a href="http://www.prd.inf.br/wiki/index.php?title=${interfaceName}" target="_blank">Documenta��o</a>
</li>
<li>
<a href="http://www.prd.inf.br/suporte/client.php?locale=pt-br&name=${user} (${company})" target="_blank">Atendimento on-line</a>
</li>
<li>
<a href="http://www.prd.inf.br" target="_blank">PRD Tecnologia de Gest�o</a></li>
</ul>
</section>
</td>
</tr>
</table>