Botão
A tecla de comando: escreve um valor predefinido, dispara um comando de execução de unidade, abre outro dashboard ou executa uma ação da Logic.
Botão é a tecla de comando da paleta. Um clique faz a única coisa que o componente declara, a ação dele, e o painel de propriedades então pede só os campos daquela ação, para que nenhum campo fique na tela sob uma regra escondida sobre quando ele conta. É um componente de Controle; um novo ocupa 3 × 1 células.
Qualquer que seja a ação, o botão carrega a aparência dele: um par de cores e um ícone opcional. Num painel de operação o botão é a peça para a qual a mão do operador vai, e a cor e a marca são o que torna um deles encontrável de relance.
Conteúdo
| Campo | O que ele faz | Valores | Padrão |
|---|---|---|---|
| Rótulo | A legenda na tecla. Vazio recai no que a ação escolhida aponta: o último segmento do endereço do ponto escrito, o nome do dashboard de destino, ou o nome da ação da Logic vinculada, e "(sem ponto)", "(sem dashboard)", "(sem ação)" ou "(ausente)" enquanto não há o que nomear. | Texto livre | vazio |
Ação
| Campo | O que ele faz | Valores | Padrão |
|---|---|---|---|
| Ao clicar | O que o clique faz. Todo campo abaixo pertence à ação escolhida. | Escrever um valor · Executar um comando de unidade · Abrir outro dashboard · Executar uma ação da Logic |
Escrever um valor |
Escrever um valor
| Campo | O que ele faz | Valores | Padrão |
|---|---|---|---|
| Ponto | O ponto escrito. A lista é estreitada para o que pode mesmo ser escrito: variáveis de memória e tags que não são somente leitura. | Texto livre; sugestões de pontos escrevíveis | vazio |
| Valor escrito | O literal predefinido enviado a cada clique. Ele é lido primeiro contra o tipo do próprio ponto, então um valor que o ponto não pode guardar é recusado na linha de resposta do botão e nunca chega à fila. | Texto livre | true |
A escrita passa pelo funil único da lógica da estação e é registrada no diário como toda outra escrita; a linha de resposta diz "Escrito".
Executar um comando de unidade
| Campo | O que ele faz | Valores | Padrão |
|---|---|---|---|
| Comando | Um ponto de comando de execução de unidade (Process.<Model>.<Unit>.Commands.*). Disparar o comando é a instrução inteira: não há valor a escrever. |
Texto livre; a lista oferece os pontos de comando de execução da unidade | vazio |
Um ponto de comando informa "pode executar agora", então o botão se desabilita enquanto o comando não se aplica; um Iniciar com o runtime bloqueado ainda mostra a razão do bloqueio. O toque executa o comando contra a unidade, atribuído ao operador autenticado, e a linha de resposta nomeia o comando que rodou.
Abrir outro dashboard
| Campo | O que ele faz | Valores | Padrão |
|---|---|---|---|
| Dashboard | A tela de destino. O seletor lista os dashboards da estação; telas definidas num modelo do Process não são oferecidas, porque elas só abrem a partir de uma unidade. | (nenhum) ou um dashboard |
(nenhum) |
Trocar de tela é um gesto de operação: um painel rodando em tela cheia continua em tela cheia quando o operador chega. A referência é frouxa: uma tela que foi excluída, ou que o papel autenticado não vê, não desabilita mais nada; o toque responde "Esse dashboard está indisponível." na linha do próprio botão, em vez de quebrar a tela.
Executar uma ação da Logic
| Campo | O que ele faz | Valores | Padrão |
|---|---|---|---|
| Ação | A ação da Logic vinculada (veja a página da Logic). | (nenhuma) ou uma ação |
(nenhuma) |
A ação roda na fila da lógica, registrada no diário como vinda do dashboard. A linha de resposta relata o resultado: "Concluído · 12 ms", ou o erro da própria ação. Uma ação excluída ou desabilitada desabilita o botão, em vez de quebrá-lo.
Cor e ícone
Lidos qualquer que seja a ação:
| Campo | O que ele faz | Valores | Padrão |
|---|---|---|---|
| Cor do botão | A face da tecla, como um par, uma metade por tema, as duas na tela ao mesmo tempo, porque o tema em vigor decide qual metade pinta. Um hex digitado pela metade é recusado e os campos voltam às cores em vigor. O que uma cor significa é a sua convenção; o aplicativo não lê nenhuma. | #RRGGBB cada |
#FFFFFF claro · #2B2B2B escuro |
| Ícone | Marca opcional antes da legenda, escolhida na biblioteca de ícones do aplicativo (cerca de 2.770 marcas), com busca por nome ou palavra-chave ("em inglês: play, stop, warning…"). A célula — é a escolha de nenhum ícone. |
Glifo do catálogo ou nenhum | nenhum |
A tinta da legenda é derivada, nunca escrita: sobre cada metade da face o aplicativo escolhe qual dos dois tons de texto dele tem o melhor contraste, então nenhuma cor que você escolha consegue deixar a legenda ilegível. A legenda se dimensiona pelo contrato de exibição compartilhado: o que a tecla não comporta é cortado com reticências, com a legenda inteira na dica.
Permissões e a trava
Toda ação exige a permissão do papel para operar dashboards. O que um toque exige além disso se lê do alvo dele, não do tipo: só Executar um comando de unidade alcança uma mudança no Process e exige, além disso, a permissão de executar procedimentos. Um toque que o papel autenticado não pode fazer desenha a marca de trava compartilhada com a razão na dica do componente (veja a página de dashboards); a autorização é reconferida no clique. A linha de resposta passageira expira depois de alguns segundos.
As seções compartilhadas Aparência, Identificação, Posição e camada e Ações estão descritas na página de componentes.