Data Value Input
Esta página apresenta a descrição e as propriedades de configuração do controle Data Value Input (Entrada(edição) de valores de um dado).
Este controle pode ser utilizado para visualizar e modificar os valores de um Dado.
As propriedades de configuração do controle são apresentadas nas seções a seguir:
Dado
Define qual o dado será tratado pelo controle, neste caso, qual dado terá seu valor alterado através do controle.
A configuração do dado é realizada através das seguintes opções:
Nome |
Descrição |
|---|---|
Origem |
Define o Conector associado ao Dado que será tratado no controle |
Dado |
Define o Dado que será tratado pelo controle. Caso selecionado um Dado Vetor, deve-se especificar o índice do elemento que será utilizado para tal. |
Dado Vetor
Utilizando Dados Vetores em Painéis Sinóticos para ser tratado pelo controle, é apresentada uma nova seção chamada de Índice de Valor.
É nesta opção que se define a Origem do índice(ou posição) do elemento do Dado Vetor que se deseja apresentar ou manipular no controle:
Constante: pode-se utilizar diretamente um valor constante(0, 1, 2, etc) como o valor do índice do elemento que se deseja manipular no controle. Lembrando que o valor de índice começa em 0 para o primeiro elemento do Dado Vetor, valor 1 para o segundo elemento e assim por diante;
De um Dado: neste caso, o valor de índice será obtido do Conector e Dado configurado logo abaixo desta opção. Isso significa que um mesmo controle, pode interagir com diferentes elementos de um Dado Vetor conforme o valor do Dado de índice vá alterando seu valor também:
Expressão/OffSet: permite alterar o valor de índice do Dado Vetor definido de um Dado usando um valor númerico ou expressão (default: 0). OffSet: adicionando ou subtraindo o índice (-2, -1, 1, 2, etc). Expressão: usando operadores para modificar o índice ($value * 2 + 1).
Valor de teste
Após a seleção de um Dado, será apresentado um campo chamado Valor de teste. Este campo permite ao usuário informar o valor a ser apresentado (simulado) pelo controle na tela, com o objetivo de avaliar o seu comportamento.
O usuário pode:
Digitar um valor diretamente no campo;
Alterar o valor utilizando as setas para cima ou para baixo do teclado;
Clicar nas setas disponíveis no campo;
Arrastar o cursor na barra de simulação para alterar o valor do campo para Dado numérico (não booleano nem texto);
Simular um valor aleatório através do botão “”.
Caso seja necessário limpar o valor simulado para usar o valor real do Dado, clique no ícone “”.
Simulando valores para um Dado Vetor
Quando o Dado associado for um vetor, ficará disponível o botão (“Editar [n] “) para editar os valores de todos os elementos do vetor pelo formulário.
Para um índice constante, é possível simular o valor do elemento referenciado diretamente, como se fosse um Dado de tamanho 1.
Para um índice proveniente de outro Dado, o valor que for simulado será o do Dado utilizado como índice, e não o do Dado associado ao controle (vetor), como de costume. Neste caso, para simular os valores do Dado vetor, é necessário usar o formulário com todos os elementos.
Aparência
Cópia de estilo e formatação
Nesta seção, são disponibilizadas algumas opções para que seja possível copiar as configurações de estilo e formatação do controle e aplicá-las em outros controles, facilitando assim a equalização de aparência em controles semelhantes.
Portanto, para copiar o estilo de um controle, deve-se seguir os seguintes passos:
Selecione no controle que terá seu estilo copiado, a opção Aplicar;
Marque uma das seguintes opções:
Estilo: determina que apenas o estilo do controle será aplicado posteriormente nos controles selecionados;
$ Formatação do Dado: determina que apenas a formatação de apresentação do valor do dado(Formato) associado ao controle será aplicado posteriormente nos controles selecionados;
$ Ambos: tanto o estilo, como a formatação de apresentação do valor do dado serão aplicados posteriormente nos controles selecionados.
Por fim, selecione no painel sinótico os controles(semelhantes) em que deseja-se aplicar o estilo e/ou a formatação de apresentação do valor do dado conforme definido no controle “original”.
Uma outra operação possível é reverter as configurações de estilo e formato de apresentação do valor do dado para o padrão de sistema(de quando o controle é criado). Para isso, basta seguir os seguintes passos:
Selecione no controle que terá seu estilo restaurado, a opção Restaurar;
Marque a opção Estilo ou $ Formatação do Dado ou $ Ambos.
Dimensões
Define o tamanho e a posição do controle no painel sinótico.
Nome |
Descrição |
Default |
|---|---|---|
Superior |
Define a distância, em pixels, entre a borda superior do controle e a borda superior da tela |
Depende |
Esquerda |
Define a distância, em pixels, entre a borda esquerda do controle e a borda esquerda da tela |
Depende |
Largura |
Largura, em pixels, do controle |
Depende |
Altura |
Altura, em pixels, do controle |
Depende |
Atenção
As propriedades Superior, Esquerda, Largura e Altura tem seus valores default definidos no momento da criação do controle. Então, esses valores podem variar para os diferentes tipos de controle.
Espaçamento
Propriedade |
Descrição |
Default |
|---|---|---|
Superior |
Define a distância, em pixels, de espaçamento entre a borda superior do controle e seu conteúdo(texto) |
Depende |
Direita |
Define a distância, em pixels, de espaçamento entre a borda direita do controle e seu conteúdo(texto) |
Depende |
Inferior |
Define a distância, em pixels, de espaçamento entre a borda inferior do controle e seu conteúdo(texto) |
Depende |
Esquerda |
Define a distância, em pixels, de espaçamento entre a borda esquerda do controle e seu conteúdo(texto) |
Depende |
Rotação
Permite rotacionar(girar) a angulação do controle no painel.
Cores
Define a cor de fundo e a cor da fonte(texto) apresentados pelo controle:
Propriedade |
Descrição |
Default |
|---|---|---|
Ícone |
Cor da fonte(texto) |
Preto (#000000) |
Ícone balde |
Cor de fundo |
Branco (#FFFFFF) |
Borda
Propriedade |
Descrição |
Default |
|---|---|---|
Cor |
Cor da borda |
Cinza Claro( #AFAFAF) |
Estilo da linha da borda |
Estilo de apresentação da linha de borda do controle. Opções:
|
Sólida |
Espessura da Borda |
Espessura da linha da borda em pixels |
1px |
Arredondar Borda
Define o arredondamento das bordas do controle:
Propriedade |
Descrição |
Default |
|---|---|---|
Arredondar Borda |
Opções:
|
3px |
Texto
Propriedade |
Descrição |
Default |
|---|---|---|
Fonte |
Define os atributos da fonte do controle Opções:
|
Source Sans Pro 18 |
Alinhamento |
Define o alinhamento vertical do texto dentro do controle. Opções:
|
Centro |
Informações
É uma breve descrição, dica ou informação do controle.
Permissões
Restringir visualização
Nesta configuração, é possível definir uma ou mais Área de Processo para restringir a visualização do controle na tela(dashboard) de um Conector.
Caso especificada uma ou mais áreas, somente usuários com as permissões pertinentes na(s) Área(s) de Processo selecionada(s) poderão visualizar o controle.
Caso nenhuma Área de Processo seja selecionada, o controle será visível na tela(dashboard) de um Conector para qualquer usuário com acesso a tela.
Restringir interação
Nesta configuração, é possível definir uma ou mais Área de Processo para restringir a interação do usuário com o controle na tela(dashboard) de um Conector.
Caso especificada uma ou mais áreas, somente usuários com as permissões pertinentes na(s) Área(s) de Processo selecionada(s) poderão interagir com o controle.
Caso nenhuma Área de Processo seja selecionada, o controle permitirá a interação de qualquer usuário que tenha acesso ao mesmo.
Propriedades Específicas
Formato
Define o formato de apresentação do valor do Dado associado ao controle:
Propriedade |
Descrição |
Default |
|---|---|---|
Formato |
Define o formato de apresentação do valor do dado. Opções:
OBS.: Para mais informações, veja Formato de apresentação de um valor |
Nenhuma |
Controles / Botões
Botão |
Descrição |
|---|---|
Restaurar |
Habilita a exibição de um botão no conteúdo do controle que permite restaurar o valor anterior a digitação de um novo valor(caso o valor ainda não tenha sido confirmado/salvo) |
Salvar |
Habilita a exibição de um botão no conteúdo do controle que permite realizar(salvar) a escrita no dado associado ao controle |
É possível configurar a apresentação dos botões através das seguintes opções disponíveis em Visibilidade:
Sempre: os botões são apresentados no conteúdo do controle em qualquer situação;
Foco: os botões são apresentados no conteúdo do controle apenas quando o mesmo estiver com o foco para edição.
Status do Comando
Permite configurar a exibição de um ícone() que indica o status de execução do comando de escrita no dado tratado pelo controle.
As opções de configuração são as seguintes:
Nenhum;
em cima esquerda;
em cima direita;
em cima centro;
meio esquerda;
meio direita;
meio centro;
em baixo esquerda;
em baixo direita;
em baixo centro.
Status do Controle
As opções disponibilizadas nessa seção permitem alterar a cor da fonte e a cor de fundo do controle de acordo com os seguintes status:
Erro
Caso configurado os limites de valores no controle e o dado tratado pelo mesmo apresente um valor fora dos limites, é apresentado um estado de erro no controle.
Este estado de erro consiste na exibição de um ícone de no controle e também na troca de sua cor de fonte e de sua cor de fundo.
É possível configurar este comportamento através das seguintes opções:
Propriedade |
Descrição |
|---|---|
Ícone |
Cor da fonte(texto) do controle em estado de erro |
Ícone balde |
Cor de fundo do controle em estado de erro |
Foco
Quando o controle é selecionado pelo usuário para realizar a edição do valor do dado associado ao controle é possível alterar a cor da fonte e a cor de fundo do controle através das seguintes opções:
Propriedade |
Descrição |
|---|---|
Ícone |
Cor da fonte(texto) do controle com o foco de edição |
Ícone balde |
Cor de fundo do controle com o foco de edição |
Pendente
Caso o usuário informe(digite) um valor no controle que altere o valor atual do dado e não confirme a operação(por exemplo, através do clique no botão salvar), o controle sinalizará a pendência de escrita caso se tire o foco do controle(por exemplo, selecionando um outro controle).
Portanto, é possível alterar a cor da fonte e a cor de fundo do controle através das seguintes opções:
Propriedade |
Descrição |
|---|---|
Ícone |
Cor da fonte(texto) do controle quando existe uma edição de valor não efetivada pelo usuário |
Ícone balde |
Cor de fundo do controle quando existe uma edição de valor não efetivada pelo usuário |
Limites
Permite configurar no controle, uma faixa de valores que o usuário pode inserir (digitar) através do controle.
Mínimo
Tipo |
Descrição |
Default |
|---|---|---|
Indefinido |
Não define um limite mínimo de valor que pode ser informado através do controle |
|
Constante |
Valor imutável do limite mínimo. Opções:
|
0 |
De um Dado |
Permite selecionar um Dado para que seu valor seja utilizado como limite mínimo do valor do controle. Caso selecionado um Dado Vetor, deve-se especificar o índice do elemento que será utilizado para tal. |
Máximo
Tipo |
Descrição |
Default |
|---|---|---|
Indefinido |
Não define um limite máximo de valor que pode ser informado através do controle |
|
Constante |
Valor imutável do limite máximo. Opções:
|
100 |
De um Dado |
Permite selecionar um Dado para que seu valor seja utilizado como limite máximo do valor do controle. Caso selecionado um Dado Vetor, deve-se especificar o índice do elemento que será utilizado para tal. |
Incremento
Descrição |
Default |
|---|---|
Valor imutável do incremento do controle, acessado pela seta do teclado (cima e baixo). Opções:
|
1 |