Telas da Aplicação Default
- Jose Porto
- Leonardo Porto
Aplicação Default já vem com um conjunto de telas prontas que o usuário poderá usar em sua aplicação. Para o tratamento destas telas também existe um conjunto de tags, pré-definidos. Nesta seção são apresentados estes objetos.
Layout Default
Existe um único layout na Aplicação Default: o layout tipo DockPanel MainLayout que tem a forma de uma tela com cabeçalho e rodapé, conforme a configuração mostrada na figura abaixo:
O formato geral da tela que utiliza este layout MainLayout, é mostrado na figura seguinte:
Este layout é usado para apresentar todas as telas prontas da Aplicação Default.
Caso os usuários desejam desenvolver novos layouts, basta criá-los e observar que antes de carregar uma tela deve-se carregar seu leiaute.
Após importar os itens do componente, é necessário configurar o "MainLayout" como Layout de inicialização no projeto. Isto pode ser feito na seção "Edit – Displays – Displays" como mostrado na figura abaixo:
Cuidado! Certifique-se de executar um "Build" após a importação do componente. O Build auxilia o novo projeto a encontrar os objetos importados a partir do componente e a referenciá-los corretamente no projeto.
Telas Disponibilizadas
Nesta seção é feita uma descrição das telas gerais existentes no DefaultNewProject, suas funcionalidades e especificidades. Telas específicas de módulos como anotações ou manobras são explicadas em suas seções correspondentes.
Alarmes
Tanto para as telas de alarmes e eventos quanto para AlarmItens, considere que o estado (campo State) de um alarme pode ter os seguintes valores:
Estado Valor
Nenhum (None) 0
Ativo (Active) 1
Normalizado (Normalized) 2
Reconhecido (Acknowledge) 3AN_About
Tela de informações de projeto e máquina.
Nesta tela também é possível chamar a página de informações de tags (AN_TagView).
AN_AlarmsSummary
Tela de visualização de alarmes de forma tabular. Contém um tAlarmWindow com as seguintes propriedades configuradas:
O filtro desta tela é configurado a partir da tag de sistema Tag.ZZ_System.AlarmSum.TagsFilterSQL. Uma tag é considerada um alarme a ser visualizado nesta tela se:
A prioridade da condição de alarme for menor ou igual a 10; e O estado do alarme for diferente de 0.
Importante
Neste grid o filtro utilizado é a tag Tag.ZZ_System.AlarmSum.TagsFilterSQL que terá como valor a expressão:
[Priority] <= 10 AND [State] <> 0
Apenas são inseridos 4096 registros no controle tAlarmWindow.
AN_ChooseTag e AN_CmdManobra
Telas da funcionalidade de manobras. Estas telas serão melhor descritas na seção "Manobras".
AN_Command
Exemplo de tela de comandos. Esta tela utiliza a tag de referência Tag. ZZ_CommandWD para mostrar estado, calcular condição, o texto dos botões e fazer comandos em uma tag "linkada".
A rotina de comando desta tela está no "codebehind". Nesta rotina, é definido inicialmente algumas constantes que serão aplicadas no comando a ser executado (Time out, Password e a operação), logo abaixo, no método 'MouseLeftButtonDown1' é verificado se a tag possui algum impedimento (mostrando uma mensagem na tela de alarmes caso tenha). Caso não tenha, é ajustado os valores do estado (no exemplo, ajusta-se os valores para um disjuntor duplo) e é chamado o método 'SendCmd' da Classe Signalling Commands ( veja "Verificação de Sinalização de Comandos") para executar o comando, e em seguida, é feita a adição de um alarme do tipo "AuditTrail" customizado com o uso da função @Alarm.AuditTrail.AddCustomMessage(string message, string areaName, string tagName).
Este alarme, por padrão, é mostrado tanto na tela de eventos como no de sumário de operação.
Por fim, os últimos três métodos 'MouseLeftButtonDown2', 'MouseLeftButtonDown3' e 'MouseLeftButtonDown4' são usados para gerar um alarme sinalizando o toggle respectivamente do 'IDS_Simulated', 'IDS_Inhibited' e 'IDS_Disabled'.
AN_EventsSummary
Tela de visualização de eventos de forma tabular. Contém um tAlarmWindow com as seguintes propriedades configuradas:
O filtro desta tela é configurado a partir da tag de sistema Tag.ZZ_System.EventsSum.TagsFilterSQL. Uma tag é considerada um evento a ser visualizado nesta tela se:
O grupo da tag em alarme for diferente de Alarm.Group.SystemEvent; ou
O grupo da tag em alarme for igual a Alarm.Group.SystemEvent E a condição do alarme for igual a 100.
AN_Filter
Tela que mantém o controle WPF SPIN.ActionNet.View.Wpf.Controls.Filter. Este controle é referenciado em "Run – Build – References" com a identidade "SPIN_ActionNet_View_Wpf_Controls" e tem como domínio a propriedade "Client" pois só é usado em clientes.
O controle filtro é usado em todas as telas que necessitam busca de dados nos históricos de medidas e de alarmes e também na tela de sumário de tags.
Basicamente, este controle verifica as condições selecionados pelo usuário, monta uma query SQL ou uma tabela de resultados e a passa internamente para uma tag de sistema. Para um melhor entendimento sobre como este filtro funciona para cada tela, consulte a documentação da tela neste manual.
AN_Footer
Tela de rodapé do layout "Startup". Sua função é mostrar o último evento ocorrido. Contém apenas um tAlarmWindow reduzido de uma linha. Suas propriedades podem ser conferidas abaixo:
AN_Header
Tela de cabeçalho do layout "StartUp". Sua função é de navegação entre as telas de sistema criadas no DefaultNewProject. Também é possível fazer a navegação a partir de dinâmicas de objetos para outras telas que não as de sistema. Estas dinâmicas de objeto são explicadas no guia do usuário do Action.Net.
Por padrão, a tela AN_Header é a tela selecionada para o cabeçalho. E segue o modelo abaixo.
O modelo default vem com os objetos e suas respectivas propriedades já configuradas. É de livre uso do usuário customizar de acordo com a necessidade de cada projeto. Segue abaixo duas tabelas exemplificando a funcionalidade padrão dos ícones e textos dinâmicos.
| Textos dinâmicos |
"Usuário: " + Client.UserName.ToUpper() | Informa o usuário logado no Sistema. |
Alarm.TotalCount | Informa a quantidade de alarmes. |
| Barra de Comados de telas |
Abre o display AN_About. | |
Abre o display AN_LogOn. A troca de usuário é realizada. | |
Fecha a janela do cliente. | |
Retorna ao display previamente aberto. | |
Abre o display AN_MainPage. | |
Abre o display AN_AlarmsSummary. | |
Abre o display AN_EventsSummary. | |
Silencia os efeitos sonoros dos alarmes atualizando o valor da variável Alarm.BeepState | |
Abre o display AN_Operation_Log. | |
Abre o display AN_TagsSummary. | |
Abre o display AN_HistoricEventsSummary. | |
Abre o display AN_HistoricEventsSummary. | |
Abre o display AN_TrendsScreen. | |
Abre o display AN_PageSelector. Seletor de telas. | |
Abre o display AN_Filter. | |
Exporta para CSV o resultado do Data Grid de UID "grid" do display. |
AN_HistoricEventsSummary
Tela de visualização de histórico de eventos de forma tabular. Contém um tAlarmWindow com as seguintes propriedades configuradas:
Nome | valor |
ControlName | grid |
MaxLines | 10000 |
Show column titles | Sim |
Show Header | Sim |
Show Header Text | Arraste aqui para agrupar |
Allow sort | Sim |
Allow column reorder | Sim |
Display value Column as Sim | |
Display Miliseconds | Sim |
Filter | Tag.ZZ_System. |
Esta tela utiliza como filtro a tag Tag.ZZ_System. HistEvents.TagsFilterSQL do tipo string para filtrar dados, utilizando o controle da página AN_Filter descrito na seção "Controle de Filtro" deste guia.
AN_Loading
Tela de exemplo de uso de evento de loading.
AN_Lock_Cmd_Tag
Tela legada de impedimento de comandos.
AN_MainPage
Tela principal do projeto para cliente tRichClient e tSmartClient. Esta tela é configurada no Layout "Startup" em "Edit – Displays – Layouts". A mesma pode ser substituída pelo usuário.
AN_NoteDetails e AN_NotesSummary
Telas da funcionalidade de Anotações. Estas telas serão melhor descritas na seção Anotações
deste manual.
AN_OperationLog
A tela de registro de operações mostra todas as operações do tipo AlarmHistory + AuditTrail. Neste componente, está configurada para mostrar operações de Logon de usuário e de mensagens customizadas do sistema.A tela é também denominada de Sumário de Operações.
As configurações de AuditTrail podem ser configuradas na seção Edit > Alarms >Groups
pressionando o botão "Settings". Eis a configuração atual:
Mensagens customizadas ("Custom Messages") podem ser inseridas via script usando as seguinte chamada:
@Alarm.AuditTrail.AddCustomMessage(string message); ou
@Alarm.AuditTrail.AddCustomMessage(string message, string área, string objectName);
Existem outras variações da chamada. Para mais informações, visite o guia do usuário do Action.Net.
As telas de comando de disjuntores e seccionadoras utilizam o comando descrito acima para informar a tela de registro de operações que estes equipamentos foram comandados.
O registro de operações mostra por padrão as colunas de Data / Hora, Nível, Nome a Tag, Descrição da mensagem, Valor, Condição e Usuário responsável por aquela operação (quando aplicável). Outras colunas também podem ser selecionadas pelo usuário.
O relatório mostra no máximo 4096 linhas de operação.
Logo, apenas alarmes do tipo AuditTrail ou SystemEvent ou alarmes com prioridade acima de 20 são mostrados nesta tela.
Seguem as configurações do controle tAlarmWindow desta tela:
AN_PageSelector
Esta tela é chamada pelos botões de relatórios das telas AN_Header, AN_Header2 ou AN_Header3.
Ela contém um controle "PageSelector" que mostra apenas as telas configuradas para aparecer em um controle do tipo PageSelector.
Há duas maneiras de marcar uma tela para aparecer neste controle, nas configurações da tela na seção "Draw" ou na coluna "AllowSelection" na seção Edit > Displays > Displays.
AN_Tag_Cmd
Semelhante à tela AN_Command, porém usando a tag ZZ_Disj diretamente.
AN_TagsSummary
Tela de visualização de sumário de tags em forma tabular. Contém um tDatagridWindow com as seguintes propriedades configuradas:
Esta tela utiliza como fonte de dados a tag Tag.ZZ_System.TagsSummary.GridDataSource do tipo DataTable.
Para filtrar dados, utiliza o controle da página AN_Filter descrito na seção Controle de Filtro deste guia.
AN_TagView
Mostra as propriedades de uma tag especificada pelo usuário de forma tabular. Esta tela é chamada a partir da tela de informações do projeto.
Para ver as propriedades de uma tag, basta inserir o nome correto da mesma no campo "Insira tag abaixo" e pressionar o botão OK.
AN_TrendsScreen
Tela de visualização de dados em tempo real ou em histórico em formato de gráfico. Esta tela utiliza um controle TrendWindow que contém as seguintes propriedades:
O controle utiliza propriedades expressas pelas tags Tag.ZZ_System.NewTrend e Tag.ZZ_System.NewPens.
A escolha de penas para a visualização é feita a partir do Controle Filtro. As tags selecionadas no filtro são configuradas na tag Tag.ZZ_System.NewPens. É permitida a seleção de até 15 penas.
Contém também scripts em codebehind como auxílio às operações de configuração inicial, parada do gráfico, início de modo real time, início de modo histórico e limpeza de penas do gráfico.
Configuração Inicial
Modo Histórico
Modo Tempo Real
Parar plotagem de gráfico
Limpar penas do gráfico
Mostrar Dados
Depois que inicia uma plotagem, e os gráficos são mostrados. pode-se também ver a tabela de dados correspondente a o gráfico.
Basta pressionar o botão Mostrar Dados. Aparece então uma tabela com os timestamps e valores usados na plotagem, na página em questão.
Este gráfico acima foi gerado com os dados mostrados abaixo. Enquanto está sendo mostrada tabela pode-se pressionar o botão Exportar CSV para se obter os dados em um arquivo texto, formato CSV que pode facilmente ser importado em uma planilha e gráfico em MS-EXCEL. Pressionando-se o botão Gráfico, volta para a apresentação do gráfico.
HTML5_Logon
Tela de acesso a aplicação em tempo real em clientes HTML5. Por padrão esta tela é chamada quando a aplicação é executada em um cliente. A tela é chamada pela task "ClientStartup" definida na seção "Edit – Scripts – Tasks".
O logon é feito a partir do script no "CodeBehind" (note que para telas HTML5 o script usa a linguagem javascript) da tela a partir de requisição de autenticação ao servidor expresso pelo comando:
@Client.LogOn(string userName, string password);
Caso a autenticação seja confirmada pelo servidor, esta tela chama a tela inicial do sistema. Caso contrário, mensagens de erro são mostradas ao usuário caso o nome de usuário ou a senha fornecida não coincidam com o cadastro de usuários da seção Edit > Security > Users.
HTML5_MainPage
Tela principal do projeto para clientes HTML5. Esta tela é chamada a partir da tela HTML5_Logon caso o usuário tenha fornecido as informações de autenticação corretas. A mesma pode ser alterada pelo integrador a partir da edição de código da tela HTML_Logon (note que para telas HTML5 o script usa a linguagem javascript).
LogOn
Tela de acesso a aplicação em tempo real em clientes tRichClient e tSmartClient. Por padrão esta tela é chamada quando a aplicação é executada em um cliente. A tela é chamada pela task "ClientStartup" definida na seção Edit > Scripts > Tasks..
O logon é feito a partir do script no "CodeBehind" da tela a partir de requisição de autenticação ao servidor expresso pelo comando:
@Client.LogOn(string userName, string password);
Caso a autenticação seja confirmada pelo servidor, esta tela chama a tela inicial do sistema. Caso contrário, mensagens de erro são mostradas ao usuário caso o nome de usuário ou a senha fornecida não coincidam com o cadastro de usuários da seção "Edit – Security – Users".