Administração do sistema

Como customizar os campos das telas e relatórios em tempo de execução?

RT.FAQ-29064
Por padrão, todos os campos são apresentados de acordo com as definições do sistema padrão (ambiente de desenvolvimento).
Algumas características podem ser customizadas diretamente no ambiente de execução do sistema (produção). Para isso, basta configurar preferências do sistema nomeadas com o nome global do item ou do campo da interface seguida com uma das propriedades documentadas abaixo:

FORMAT

Propriedades de formatação. Seguem um padrão estilo CSS. Ver documentação do domínio utilizado no campo para maiores detalhes.
Exemplo: 
PEDIDOS.CAD_PEDIDOS_06.PESO_ESTIMADO.FORMAT = mask:##,###,##0.###

Ver também:

LABEL

Label para o campo.
Exemplo: 
CONPAG.CAD_TITULOS_PAGAR.LIST.VALOR_ORIGINAL.LABEL = Val.Orig.
Esse exemplo altera o label (texto) do campo "valor original" (VALOR_ORIGINAL) para "Val.Orig." na tela de listagem (LIST) da interface Títulos a pagar.


WIDTH

Largura do campo na interface.


HEIGHT

Altura do campo na interface.


SIZE

Tamanho máximo do campo.


SQL_OPTIONS

Altera a lista de opções disponíveis nos campos que possuem uma lista de valores válidos, tais como OPCAO, OPTIONS, SELECTION_CHECK, etc. A preferência pode ser informada de duas formas:

Se começar com a palavra SELECT, então a preferência é composta por um comando SQL que deverá retornar 2 colunas. A primeira coluna é o valor e a segunda coluna é o texto que será apresentado para o usuário.
Exemplo: 
select id, login
from usuarios
where ativo = 'S'
order by login

Se não começar com a palavra SELECT, a preferência deverá ser composta pelos valores desejados informados um por linha no formado: 
VALOR = DESCRIÇÃO
Exemplo: 
A=Aprovado
P=Pendente
C=Cancelado

Ver também:


LOOKUP_SQL

SQL utilizada para a funcionalidade de autocomplete. Esta configuração funciona somente se o campo já possui autocomplete, ou seja, serve apenas para modificar o SQL utilizado e não permite incluir a funcionalidade em um campo que não a tem. O SQL informado DEVE possuir as colunas VALOR, DESCRICAO e PESQUISAR.

Observações

A opção de LOOKUP_SQL permite também a configuração geral.


NULL_TEXT

Permite customizar o texto que aparece no campo quando seu valor é nulo.
Na maioria das vezes, quando o campo não tem informação, ele é apresentado simplesmente em branco (em uma lista, por exemplo). Nestes casos, pode-se configurar se desejado para aparecer algum outro texto.
Exemplo: 
PEDIDOS.CAD_PEDIDOS_06.PLANO_PAGAMENTO.NULL_TEXT = Não informado


AGGREGATION_FUNCTION

Define a função de agregação a ser utilizado nas operações sumarizadas, tais como totalização de coluna, agrupamentos de registros ou pivot.
Caso não informado, assume "SUM".
Valores permitidos:


SUMMARIZE

Deve-se informar S ou N e permite customizar se a coluna deve ser totalizada ou não.

TOTALIZAR

Algumas interfaces possuem recursos de configuração para apresentação dos totalizadores de colunas na lista. Para configurar a apresentação dos totais de determinadas colunas da lista de uma interface por usuário deve-se cadastrar e configurar preferências definidas como "Por usuário" por coluna com a opção TOTALIZAR . 
{SISTEMA}.{BLOCO}.{CAMPO}.TOTALIZAR
P.ex.: Configurar a preferência abaixo para definir se o totalizar da coluna "Valor total" (nome global do campo VALOR_TOTAL) da interface de orçamentos deve ser apresentado para todos os usuários: 
ORCAME06.CAD_ORCAMENTO_06.VALOR_TOTAL.TOTALIZAR
Caso seja definido o valor da preferência como S (marcado) deve-se configurar a preferência no cadastro dos Usuários para os quais o totalizador da coluna não deva ser apresentado com o valor N.


HINT

Define o hint (descrição) do campo, formatado em HTML.
P.ex.: Para alterar a descrição do hint do campo "Número do título" da interface de cadastro de CONREC.CAD_TITULOS_RECEBER. 
CONREC.CAD_TITULOS_RECEBER.NUMERO_TITULO.HINT = Número (somente numerais) do título.


STYLE

Define propriedades visuais do campo.
O valor passado é baseado basicamente em propriedades CSS que serão renderizadas juntamente com o campo. As propriedades devem ser informadas no formato 
propriedade:valor; propriedade2:valor2; ...

As principais propriedades utilizadas são:

Exemplo: 
PEDIDOS.CAD_PEDIDOS_06.PLANO_PAGAMENTO.STYLE = font-style:monospace; font-weight:bold;
Atenção
Esta opção não afetará colunas nas listagens. Para isso, deve-se utilizar a FAQ Regras de inferência de propriedades e características por expressão.


DEFAULT_QUERY_VALUE

Valor padrão do campo na QUERY. Ver Como definir o query operator padrão de um campo de uma tela?.


Ver também: