NÚMERO

Figura1: Interface Configuração do Campo.

Atributos:

• Tipo do dado - Define o tipo do campo da aplicação. Quando o campo é definido como Número, é permitido definir regras de formatação de números inteiros.
  

• Label - Define o título do campo na aplicação. Por exemplo: se o campo estiver definido no banco de dados como cmp_nome_cliente fica mais claro o entendimento se o mesmo for exibido como Nome do Cliente.
• Máscara de Consulta - Define a máscara de exibição do campo. São dois os tipos de máscara descritos na tabela abaixo:
  

  Caracter	Descrição
  X	É substituído por quaisquer caracteres retornados pelo banco de dados. Seu preenchimento é obrigatório e quando forem retornados menos caracteres do que o tamanho da máscara, o valor será completado com zeros à esquerda.
  Z	É substituído por quaisquer caracteres retornados pelo banco de dados. Seu preenchimento é opcional e quando forem retornados menos caracteres do que o tamanho da máscara, nada será feito em relação aos caracteres que estão faltando. Além disso os zeros à esquerda serão suprimidos. Obrigatoriamente o uso deste caracter é à esquerda da máscara quando usado em conjunto com o X

  Exemplos de máscaras:

  Máscara	Valor do campo	Valor formatado
  (xx) xxxx - xxxx	1234567890	(12) 3456 - 7890
  (xx) xxxx - xxxx	12345678	(00) 1234 - 5678
  (zz) xxxx - xxxx	1234567890	(12) 3456 - 7890
  (zz) xxxx - xxxx	12345678	( ) 1234 - 5678
  (zz) xxxx - xxxx	0012345678	( ) 1234 - 5678

  
  

• Não Repetir Valor - Não repetir o valor do campo caso este seja igual ao do registro anterior.
  

  Repetir Valor		Não Repetir Valor

  
  
• Tipo SQL - Informa o tipo do campo no banco de dados.

Formatando Número

Figura2: Interface Formatando Número.

• Usar configurações regionais – Permite aplicar as configurações regionais de formatação de números ao campo. Quando não for selecionada serão exibidos os atributos Agrupamento, Sinal negativo e Formato de número negativo.(Veja configurações regionais).
• Agrupamento - Define qual caracter será usado para a separação de milhar.
• Sinal negativo - Define qual caracter será usado para a exibição de números negativos.
• Formato de número negativo - Define o posicionamento do sinal negativo em relação ao valor.
• Cor dos Negativos – Permite definir uma cor quando o valor for negativo.
• Exibir valor por extenso - O valor será exibido por extenso. Exemplo: 2.100 (Dois mil e cem).
• Tamanho da Linha – Tamanho máximo em caracteres a ser exibido na célula do valor, por extenso. Ao ultrapassar este valor é feita a quebra da linha dentro da célula.

Lookup de Consulta

Forma utilizada para modificar a exibição de um determinado campo na consulta. Por exemplo, um campo sexo no banco de dados com valores M ou F pode ser substituído por Masculino ou Feminino (ver lookup manual) ou ainda, de forma dinâmica, ter esses valores recuperados de uma tabela do banco de dados (ver lookup automatico).

Antes do Lookup		Depois do Lookup

Lookup de Consulta - AutomÁtico

Lookup usado para modificar a exibição do campo de forma dinâmica, recuperando os valores de uma tabela.

Atributos :

• Comando Select - Define o comando SQL que irá recuperar o valor a ser exibido no campo da consulta. O comando deverá ter o seguinte formato "SELECT campo_a_ser_exibido FROM tabela WHERE campo_chave = {campo_da_consulta}".
  
  OBS: O campo da consulta deve ser referenciado sempre entre chaves {}. No momento da execução, o campo entre chaves será substituido pelo seu valor na tabela.
• Múltiplas Opções - Quando o Comando Select informado retornar vários valores, a opção Sim deve ser selecionada.
  
• Delimitador - Define o separador dos valores retornados pelo Comando Select, esta opção deverá ser preenchida quando estiver marcado Sim no atributo Múltiplas Opções.
• Usar o lookup em:
  

  Consulta	Aplica o lookup em todas as formas de consulta (HTML, PDF, XML , CSV e RTF).
  Resumo	Aplica o lookup somente no resumo (HTML e PDF).
  Ambos	Equivale à marcação das opções Consulta e Resumo.

• Valor Default - Define um valor padrão, usado nos casos onde o comando select não retorna nenhum valor.
  
• Exibir valor original e lookup - Quando selecionado Não, é exibido apenas o valor retornado pelo Comando Select. Caso contrário, serão exibidos o valor original do campo e o valor retornado pelo Comando Select separados pelo caracter definido em Separados por.
  
• Separados Por - Define o(s) caracter(es) que será(ão) usado(s) para separar o valor orignal do campo e o valor retornado pelo Comando Select. Esta opção deverá ser preenchida quando estiver marcado Sim no atributo Mostrar valor original e lookup.
• Usar conexão específica - Permite selecionar uma outra conexão existente no projeto diferente da conexão atual da consulta.

Lookup de Consulta - Manual

Lookup usado para modificar a exibição do campo com valores pré-definidos.

Figura4: Interface Lookup de Consulta Manual.

Atributos:

• Tipos de Lookup - Define o modo de funcionamento do lookup, podendo ser : Simples Valor , Múltiplos Valores (Delimitador), Múltiplos Valores (Posição) e Múltiplos Valores (Binário).
  
  

• Botão Incluir - Inclui na lista os valores preenchidos nos atributos Label e Valor.
• Botão Alterar - Altera os atributos do item selecionado.
• Botão Excluir - Exclui o item selecionado.
• Botão Limpar - Limpa os atributos.
• Botão Salvar - Salva a lista de valores informados para que possa ser reutilizado.
  
• Carregar Definição de Lookup - Permite carregar uma Lista de valores pré-definida para uso como lookup.
• Usar o lookup em:
  

  Consulta	Aplica o lookup em todas as formas de consulta (HTML, PDF, XML , CSV e RTF).
  Resumo	Aplica o lookup somente no resumo (HTML, PDF).
  Ambos	Equivale à marcação das opções Consulta e Resumo.

• Valor Default - Define um valor padrão, usado nos casos onde o valor armazenado não corresponde a nenhum valor da lista.
  
• Exibir valor original e lookup - Quando selecionado Não, é exibido apenas o valor informado no Label, caso contrário será exibido o valor do campo selecionado e o valor informado no Label separado pelo caracter definido em Separados por.
  
• Separados Por - Define o(s) caracter(es) que será(ão) usado(s) para separar o valor do campo selecionado e o valor retornado pelo Comando Select. Esta opção deverá ser preenchida quando estiver marcado Sim no atributo Mostrar valor original e lookup.

CONFIGURAÇÃO DA VISUALIZAÇÃO

Permite definir valores de CSS para o campo individualmente.

Figura: Interface de definição de CSS à nível de campo.

Atributos:

• Fonte - Permite escolher o tipo de fonte, que será aplicado no campo da aplicação.

• Tamanho da Fonte - Permite escolher o tamanho da fonte, que será aplicado no objeto da aplicação.
• Cor da fonte -Permite escolher a cor utilizando uma paleta de cores para ser aplicada a fonte.
  
• Cor de fundo - Permite escolher a cor, utilizando uma paleta de cores para ser aplicada como plano de fundo do campo da aplicação.
• Negrito - Permite aplicar o tipo negrito na fonte.
• Sublinhado - Permite aplicar o sublinhado.
• Tamanho da Borda - Define o tamanho da Borda.
• Cor da Borda - Define a cor da Borda.
• Alinhamento Horizontal - Permite posicionar o label do filtro no local desejado (left,rigth,center e justify).
• Alinhamento Vertical - Permite posicionar o label do filtro no local desejado (left,rigth,center e justify).
  
• Largura - Largura, referente ao atributo "Colunas da Tabela" na conf da consulta.
• Altura - Altura informada em pixel.

Gráfico de Linha

Utilizando está guia de edição é possível definir um gráfico para cada linha.

Figura: Interface Gráfico de Linha.

Atributos:

• Tipo do gráfico linha - São dois os tipos de gráficos que podem ser utilizados. Abaixo mostraremos os dois tipos:
  
  • Gráfico de Barras - Esta opção permite exibir um gráfico de barras relativo à coluna na qual estamos trabalhando. O cálculo do tamanho das barras é feito em relação ao Total Geral dos valores da coluna. O valor informado em Largura do Gráfico define o tamanho das imagens a serem exibidas.

  
  
  Nota: No exemplo mostrado pela tela acima, a Largura do Gráfico foi de 200px.

  • Gráfico de Ícones - Esta opção permite exibir Ícones relativos à coluna na qual estamos trabalhando. O cálculo da quantidade de ícones é feito pela divisão do valor da coluna pelo valor informado em Ícone de Quantidade.

  

Nota: No exemplo acima, no campo Ícone de Quantidade, foi informado o valor 1000, logo, a quantidade de estrelas existentes ao lado, é determinada pela divisão do valor exibido por 1000.

• Mostrar Valor - Se mostrará o valor e o gráfico ao mesmo tempo, podendo o valor estar do lado esquerdo ou direito da barra ou ícones.
  
• Ícone de Quantidade - Determina quantos ícones (figuras) aparecerão para cada valor nesse campo. Este valor será apurado pela divisão do valor da coluna pelo campo Ícone de Quantidade.
  
• Largura do Gráfico - Largura do gráfico em pixels. Este campo só é utilizado pela opção Gráfico de Barras. Caso não seja preenchido, o valor utilizado será 200px.
  
• Altura do Gráfico - Altura do gráfico em pixels. Este campo só é utilizado pela opção Gráfico de Barras.
  
• Margem - Margem do gráfico. Este campo só é utilizado pela opção Gráfico de Barras.
  
• Imagem/Cor Positiva - O forma de preenchimento vai variar de acordo com a opção escolhida, veja abaixo:
  
  • Gráfico de Barra - Preencher o campo com a Cor a ser utilizada para formar a imagem do gráfico. Clique no ícone ao lado para escolher a cor.
  • Gráfico de Ícones - Preencher o campo com o nome da imagem que será utilizada como Ícone. Clique no ícone ao lado para escolher a imagem "Ícone".
    
• Imagem/Cor Negativa - O Preenchimento desse campo segue os mesmos critérios do campo Imagem/Cor Positiva. Esse parâmetro será utilizado caso o valor do campo seja negativo.

Gráfico de Coluna

Com a utilização desta opção, aparecerá na consulta, na linha de Título do campo, um ícone para exibição do gráfico.

Neste tipo de opção escolhemos duas colunas para montagem do gráfico. A primeira é o próprio campo que estamos trabalhando, e a segunda é um campo que escolheremos e que chamaremos de "Coluna para Label".

Figura6: Interface Gráfico de Coluna.

Atributos:

• Agrupar pelo Label - Agrupar valores da coluna pelo label. Semelhante ao efeito de um group by em um Select.
• Função de Sumarização - Função de sumarização a ser aplicada aos dados da coluna. As funções que podem ser utilizadas no campo são as seguintes: Count, Sum, Max, Min e Avg.
• Gráfico Configurável - Permiti que o usuário configure os parâmetros de criação dos gráficos durante a execução da aplicação.
• Exibir Valores - Exibe os valores do gráfico gerado
• Coluna para Label - Coluna para Label do campo.
• Largura do Gráfico - Largura do gráfico, em pixels.
• Altura do Gráfico - Altura do gráfico, em pixels.
• Altura da Legenda - Altura máxima, em porcentagem entre o gráfico e o espaço (no topo) reservados para legendas.