Data Value Toggle

Esta página apresenta a descrição e as propriedades de configuração do controle Data Value Toggle(alternancia de valor de um dado).

Este controle pode ser utilizado para proporcionar ao usuário uma escolha entre dois valores tais como:

  • SIM / NÃO;

  • ON / OFF;

  • Habilita / Desabilita.

Podemos observar aqui que o comportamento deste controle é semelhante ao controle Data Value Checkbox, porém com um aspecto visual diferente(ícones e ), além de permitir customizar o texto associado aos seus dois estados.

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 representado na barra de progresso.

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 a opção Estilo (determinando que o estilo do controle será aplicado posteriormente nos controles selecionados);

  • Por fim, selecione no painel sinótico os controles(semelhantes) em que deseja-se aplicar o estilo conforme definido no controle “original”.

Uma outra operação possível é reverter as configurações de estilo para o padrão de sistema(estilo 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.

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

  • Tracejada

  • Pontilhada

  • Dupla

  • Sulco

  • Cume

  • Embutida

  • Saltada

  • Nenhuma

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:

  • Não

  • 3px

  • 5px

  • 10px

  • 20%

  • 50%

3px

Texto

Propriedade

Descrição

Default

Fonte

Define os atributos da fonte do controle

Opções:

  • Fonte: Tipo da fonte

  • Tamanho: Tamanho da fonte

  • Negrito

  • Itálico

  • Sublinhado

  • Subscrito

Source Sans Pro 18

Alinhamento

Define o alinhamento vertical do texto dentro do controle.

Opções:

  • Esquerda

  • Direita

  • Centro

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

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

Valores

Define quais são os valores, textos e cores associados aos dois estados do controle sendo representados pelos ícones e , ou seja, quais valores serão utilizados na apresentação/escrita pelo controle para o dado tratado.

Para isso, são disponibilizadas as seguintes configurações:

Propriedade

Descrição

Estado ON

Nesta opção é possível configurar as seguintes opções:

  • Cor: Ao clicar no ícone , é possível definir sua cor;

  • Texto: Define o texto a ser apresentado pelo controle quando o dado tratado estiver com o valor configurado;

  • Valor: Define o valor associado ao dado tratado pelo controle para este estado.

Estado OFF

Nesta opção é possível configurar as seguintes opções:

  • Cor: Ao clicar no ícone , é possível definir sua cor;

  • Texto: Define o texto a ser apresentado pelo controle quando o dado tratado estiver com o valor configurado;

  • Valor: Define o valor associado ao dado tratado pelo controle para este estado.