Tema
Campos de entrada
Seis widgets recebem valores de quem está a ver o dashboard: caixa de texto, texto longo, número, sim/não, lista pendente e data.
Para que servem num dashboard de leitura
O DeepVisuals mostra dados; não os grava. Um campo de entrada aqui não serve para escrever num registo — serve para controlar o que os outros widgets mostram.
O valor actual de um campo pode ser lido por uma condição de consulta de qualquer widget do ecrã. Escolher uma opção na lista pendente faz a consulta recorrer com o novo valor.
Na maior parte dos casos, use os filtros do dashboard
Para filtrar vários widgets pelo mesmo campo, os filtros do dashboard fazem o mesmo com muito menos trabalho: declaram-se uma vez e aplicam-se sozinhos, incluindo a widgets acrescentados depois.
Os campos de entrada são para o resto: um controlo com aspecto próprio, um valor que alimenta código, ou uma combinação que a barra de filtros não cobre.
Os seis
Caixa de texto — texto de uma linha. Com o operador contains numa condição, dá uma pesquisa livre.
Texto longo — várias linhas. Raro num dashboard de leitura.
Número — valor numérico. Com gte numa condição, dá um limite mínimo.
Sim/Não — caixa de verificação. Útil para alternar entre dois modos.
Lista pendente — o mais usado. As opções podem ser fixas ou vir de um conjunto de dados, indicando que campo é o valor e qual é a etiqueta. Suporta pesquisa, selecção múltipla e modo de árvore para valores hierárquicos.
Data — seletor de data, para condições de intervalo.
Propriedades comuns
| Propriedade | O que faz |
|---|---|
| Rótulo | O texto que identifica o campo |
| Posição do rótulo | Por cima ou ao lado |
| Marcador de posição | O texto cinzento dentro do campo vazio |
| Ligação | O conjunto e o campo de onde lê e para onde escreve o valor |
No bloco de Aspecto há ainda o espaçamento, a largura fixa e o alinhamento do rótulo — é o que permite alinhar uma coluna de campos com rótulos de comprimentos diferentes.
Ligar um campo a uma consulta
- Coloque o campo no ecrã e dê-lhe um identificador reconhecível.
- No widget que quer filtrar, abra o construtor e acrescente uma condição.
- Escolha o campo a filtrar, o operador, e como valor a origem widget, apontando ao campo de entrada.
Sem valor escolhido, a condição não se aplica e o widget mostra tudo. Ver Filtros da consulta.
Onde colocar
Uma linha de campos no topo do ecrã, dentro de um painel ou de uma barra fixa, é o padrão que as pessoas reconhecem. Ver Painéis e separadores.
Dois widgets fora da palete
Existem ainda um seletor de cor e um campo de ficheiro no runtime, mas não aparecem na palete do editor: não têm uso num produto de visualização. Estão listados em Catálogo de widgets para referência.