Dashboards de um modelo
Os dashboards de forma livre definidos num modelo, o espaço reservado de unidade que os vínculos deles carregam, e como cada unidade abre a cópia resolvida dela.
Um dashboard de um modelo é um dashboard comum que nomeia o modelo dele: ele é montado com os mesmos componentes e editado com o mesmo editor de todo dashboard da página View (veja O editor de dashboards), e o que o torna de um modelo é onde ele vive e o que os vínculos dele nomeiam. Ele é listado em Process > Modelos > modelo > Visualização > Dashboards, os campos de endereço dele oferecem os canais do modelo, e ele escreve um espaço reservado de unidade onde uma única unidade seria nomeada. Uma definição serve toda unidade do modelo. Criar, remover e marcar um dashboard exige a permissão Gerenciar o Process; editar o que está nele exige a permissão Editar dashboards da área Dashboard.
A pasta Dashboards
Selecionar a linha Dashboards abre a página da pasta: o cabeçalho ("Dashboards de operador definidos neste modelo. Uma definição serve a todas as unidades: cada unidade carrega uma linha própria que o abre sobre os canais vinculados dela.") e um cartão por dashboard, com o ícone e o nome dele. Clicar num cartão abre o dashboard; o X num cartão o remove. Quando o modelo não tem nenhum, a página diz "Nenhum dashboard ainda. Adicione um e depois edite-o com a caixa de ferramentas do dashboard." A árvore lista os dashboards sob a pasta por nome, e a linha da pasta os conta.
| Comando | O que faz | Fica cinza quando (situação) | Não é desenhado quando (papel) |
|---|---|---|---|
| Dashboard (barra de detalhe, com a pasta selecionada; clique direito Adicionar dashboard) | Cria um dashboard vazio chamado Tela <n> (o primeiro número que dashboard nenhum deste modelo já usa), o salva e o seleciona, para você poder nomeá-lo onde o fez. |
Alguma unidade tem uma execução, ou o runtime está parado. | Sem Gerenciar o Process. |
Um dashboard novo começa sem nada nele. O nome, a descrição, o ícone e tudo o mais que um dashboard carrega são do editor (veja Configurações do dashboard); a página Process não carrega campo para eles.
A página do dashboard
Selecionar um dashboard o roda no painel de conteúdo, de borda a borda, sem nada na frente: esta é a própria definição, desenhada no mesmo canvas em que todo outro dashboard é desenhado. Como nenhuma unidade é nomeada aqui, um componente vinculado a um dos canais do modelo desenha o layout dele e não lê valor nenhum; a linha de endereço do editor diz "um ponto por unidade deste modelo" para um vínculo assim, em vez de informar um ponto faltando. Um componente vinculado a um ponto da estação (uma tag, uma variável) o lê normalmente.
Um dashboard vazio diz isso, em vez de ficar como uma faixa em branco: "Nada nesta tela ainda. Edite-a para colocar componentes: os campos de endereço deles oferecem os canais deste modelo, e cada unidade lê então os seus."
A barra de detalhe carrega três coisas para um dashboard selecionado: Editar dashboard, o interruptor Mostrar em View e, no grupo de perigo, Remover dashboard.
Editar dashboard
Editar dashboard entrega o corpo da página Process ao único editor de dashboards da aplicação,
montado sobre esta definição: o palco, o filete dele e o trilho de tarefas tomam o lugar do painel de
conteúdo, e a faixa do editor carrega Concluir a edição ("Terminar a edição e voltar a visualizar
este dashboard"), que devolve o corpo ao painel de conteúdo rodando o dashboard como ele ficou. Nada
é confirmado na saída: toda edição é salva conforme é feita. O endereço próprio do dashboard
(/d/<id>) continua sendo um atalho para dentro do editor, para quem chegar com um.
| Situação | O que você vê |
|---|---|
| Seu papel não tem Editar dashboards | O verbo não é desenhado: o que o papel nunca pode apertar fica de fora, em vez de ficar cinza. |
| Uma unidade tem uma execução | O verbo fica cinza com "A engenharia está travada enquanto uma Unidade está em execução". Uma trava que chega enquanto você edita encerra o modo de edição; voltar quando a estação estiver livre é um acionamento seu. |
| A seleção sai do dashboard, ou o papel perde o bit | O modo de edição termina do mesmo jeito. |
Excluir o dashboard de dentro do editor fecha o editor e leva a seleção para a pasta Dashboards do modelo.
O espaço reservado de unidade nos vínculos
No dashboard de um modelo, todo campo de endereço do editor começa pelos canais do modelo, uma linha
por canal na ordem dos canais do modelo, cada uma escrita como o endereço de "este canal, na unidade
que abrir a tela": Process.<Model>.{unit}.Channels.<Channel>. Escolher um vincula o canal e deixa
a unidade para ser respondida depois. Os pontos da própria estação vêm depois dessas linhas (o
dashboard de um modelo pode legitimamente ler uma tag de ambiente ou uma variável compartilhada), a
lista tem teto de 50 sugestões, e o campo continua livre para digitar. Um campo que escreve (um
Botão, um Input) lista apenas os canais cujo papel é gravável, porque por quais canais uma unidade
pode ser escrita é o papel do canal.
As linhas são filtradas pela categoria de valor que o campo aceita, exatamente como os pontos da própria estação são, então um canal só é escondido onde nada poderia carregá-lo.
Três tokens são respondidos quando uma unidade abre o dashboard:
| Token | Onde ele é escrito | No que ele vira |
|---|---|---|
{unit} |
Dentro de um endereço, e como o valor inteiro de uma propriedade de componente que vincula uma unidade (a Unidade da linha do tempo de comentários ou da lista de ocorrências, por exemplo). | O segmento de endereço da unidade, num endereço; a identidade da unidade, numa propriedade vinculada a unidade. Escrito dentro de texto comum (um rótulo, uma legenda), ele fica exatamente como está. |
{unit.name} |
Qualquer texto: o nome e a descrição do dashboard, o nome ou a legenda de um componente, o título de um gráfico ou o rótulo de uma série, qualquer propriedade de texto. | O nome de exibição da unidade. |
{channel.name:<segment>} |
Qualquer texto. O segmento é o segmento de endereço higienizado do canal, a mesma chave que o endereço ao lado usa. | O nome que o canal carrega naquela unidade: o apelido por unidade dele, onde o modelo permite um e a unidade o definiu, ou o nome do próprio canal. Um segmento que não nomeia canal nenhum do modelo fica como está. |
Enquanto o dashboard é editado no modelo, um componente cujo endereço ainda carrega {unit} é
tratado como não vinculado: ele não desenha nada e não marca nada, porque o silêncio só é real na
cópia resolvida.
Como cada unidade ganha o dashboard resolvido dela
Sob a Operação, toda unidade do modelo carrega uma linha por dashboard do modelo, depois das linhas de painel dela. Selecionar essa linha roda a definição como a da própria unidade:
- A definição é copiada e reidentificada (identidades novas para o dashboard, para os componentes dele e para as redes de ligação dele), então as cópias de duas unidades nunca compartilham a identidade de um componente.
- Todo
{unit}vira esta unidade, então cada endereço sai como o ponto comumProcess.<Model>.<Unit>.Channels.<Channel>e cada propriedade vinculada a unidade guarda esta unidade. Nada rio abaixo fica sabendo que a definição era abstrata: os componentes leem valores ao vivo, os componentes Botão e Input escrevem, e um gráfico de linha cujas séries leem esta unidade desenha as faixas de avaliação da execução em curso nela, exatamente como em qualquer dashboard vinculado a uma unidade. {unit.name}e{channel.name:...}viram o nome da unidade e os nomes de canal em vigor nela.
A linha veste a barra de palco que a página View usa: o nome da entrada Modelo · Unidade · Dashboard, o ícone do dashboard, Expandir ("Usar a janela inteira") e Tela cheia ("Tela
cheia (F11)"). Não há Copiar nem Editar nela: a linha de uma unidade mostra um dashboard e nunca o
edita. Um dashboard vazio diz, na linha da unidade: "Nada nesta tela ainda. Ela é desenhada na linha
Dashboards do modelo, em Visualização, e o que é colocado ali aparece aqui para todas as unidades."
Uma edição salva no modelo alcança a linha de toda unidade: a linha guarda a definição do modelo e a resolve de novo sempre que uma instância nova chega.
Mostrar em View
Mostrar em View é o interruptor da barra de detalhe, ao lado de Editar dashboard. Ele lê o estado em vigor, e a dica dele diz o que aquele estado faz:
| Estado | Dica |
|---|---|
| Ligado | "Cada unidade deste modelo tem uma entrada para este dashboard na lista de Visualização." |
| Desligado | "Este dashboard é aberto a partir da unidade, em Operação. Nada dele fica na página View." |
Ligá-lo põe uma entrada por unidade do modelo na coluna de Visualização da página View, chamada
Modelo · Unidade · Dashboard e vestindo o ícone do dashboard; cada entrada é a definição resolvida
para aquela unidade, a mesma tela que a linha da unidade sob a Operação roda. As entradas são linhas
daquela lista e não dashboards da estação: elas nunca são reordenadas, editadas ou copiadas lá
(Copiar é recusado nelas), embora a entrada de cada unidade possa ser arquivada nas pastas da página
View por conta própria. Um modelo sem unidades não põe nada na página View. Um dashboard pode ficar
na página View por direito próprio e também ser cartão de um painel que fica lá; os dois ao mesmo
tempo é um arranjo comum. Como as entradas ficam está em
Painéis de unidade na View.
O interruptor não é desenhado para um papel sem Gerenciar o Process. Ele continua desenhado e cinza sob a trava de engenharia e o runtime parado, dizendo qual dos dois é. A decisão é salva com o próprio dashboard (o mesmo salvamento automático que o nome dele recebe), então uma escrita recusada devolve o interruptor.
Um dashboard como cartão de um painel
Um painel do modelo pode desenhar qualquer dashboard do modelo como um dos cartões dele, numa altura escolhida no painel (120 a 1200 px, 320 por padrão). Um dashboard entra num painel apenas quando você o liga lá; ele começa desligado. Veja Painéis.
Remover dashboard
Remover dashboard fica no grupo de perigo da barra de detalhe com o dashboard selecionado, no menu de clique direito da árvore, e como o X no cartão da página da pasta. Ele pergunta antes ("Excluir dashboard": o nome e, em seguida, "Isso remove o dashboard e tudo o que está nele. Os endereços que eles leem continuam na Logic."). Depois da exclusão a seleção cai na pasta Dashboards do modelo, um editor aberto sobre aquele dashboard se fecha, toda linha de painel que o desenhava descarta aquele cartão, e as entradas dele saem da página View. Ele exige Gerenciar o Process e fica cinza sob a trava de engenharia e o runtime parado.
O que esta página não faz
- Ela não edita o conteúdo, o nome nem as configurações do dashboard: isso é do editor, aberto por Editar dashboard.
- Ela não faz uma cópia por unidade. O que uma unidade mostra é resolvido a partir da definição única a cada vez; não há nada para editar por unidade, e um dashboard que o operador queira mudar para uma estação é um segundo dashboard do modelo.
- Ela não põe um dashboard nas pastas da própria página View. O dashboard de um modelo nunca está na lista de dashboards da estação; ele alcança a página View apenas por Mostrar em View, uma entrada por unidade.
- Ela não inicia nem conduz uma execução. Um Botão vinculado a um ponto de comando no dashboard resolvido faz isso, sob a permissão Executar procedimentos, exatamente como em qualquer dashboard; veja Execuções e comentários.