Documente Academic
Documente Profesional
Documente Cultură
2013 Elipse Software Ltda. Todos os direitos reservados. 04/02/2013 - Verso 4.0
Sumrio
1 Introduo 1.1 Descrio Geral 1.2 Arquitetura do E3 1.3 Diagrama de Blocos 1.4 Estrutura de Domnio 1.5 Limitaes do Modo Demonstrao 2 E3 Studio 2.1 Iniciando um Projeto 2.2 rea de Trabalho 2.3 Configurao do E3 Studio 2.4 Barra de Ferramentas 2.5 Organizer 2.6 Importao e Exportao 2.7 Lista de Propriedades 2.8 Galeria 2.9 AppBrowser 2.10 Conectar A 3 Domnios 3.1 E3 Server 3.2 E3Run 3.3 E3 Admin 3.4 IOServer 3.5 E3 Studio 3.6 E3 Viewer 3.7 Componentes do Domnio 3.8 Criando um Domnio 3.9 Configuraes de Domnio 3.10 Outras Opes da rea de Notificao 3.11 Domnios Remotos 3.12 Gerando Logs no E3 4 Drivers 4.1 Driver de Comunicao 4.2 Servidor OPC 4.3 Driver de Comunicao OPC 4.4 Qualidade 5 Servidor de Dados 5.1 Pasta de Dados 5.2 Tag Contador 5.3 Tag Demo 5.4 Tag Interno 5.5 Tag Timer 6 Telas e Objetos de Tela 7 8 9 11 12 12 14 15 15 16 25 43 48 79 80 81 84 87 87 88 89 90 90 90 90 91 99 124 132 139 140 140 154 155 170 178 178 179 181 182 184 186
6.1 Tela 6.2 Objetos de Tela 6.3 Configuraes Gerais 6.4 Formatao de Cores 6.5 Formatao de Valores 7 ActiveX 7.1 Objetos Microsoft Forms 7.2 Elipse KeyPad 8 Quadros 9 Associaes 9.1 Associao Simples 9.2 Associao Bidirecional 9.3 Associao Digital 9.4 Associao Analgica 9.5 Associao por Tabela 9.6 Associao Reversa 9.7 Associao Mltipla 9.8 Edio de Associaes 10 Viewer 10.1 Configurao do Viewer 10.2 Variveis no Viewer 10.3 Objeto _top 10.4 Pasta do Viewer 11 Banco de Dados 11.1 Banco de Dados Access 11.2 Banco de Dados Oracle 11.3 Banco de Dados SQL Server 11.4 Objetos do E3 e Permisses 12 Alarmes 12.1 Configurao de Alarmes 12.2 Servidor de Alarmes 12.3 Fontes de Alarme 13 E3Alarm 13.1 Configuraes do E3Alarm 13.2 Caractersticas Especficas de Runtime 14 Histricos 14.1 Configuraes do Histrico 15 Storage 15.1 Configuraes do Storage 15.2 Configurao da Tabela 16 Consultas 16.1 Criando uma Consulta 16.2 Uso dos Filtros da Consulta atravs de Scripts 16.3 Uso de Recordsets de uma Consulta atravs de Scripts 17 E3Browser
186 188 195 209 211 217 220 222 224 228 230 231 232 233 234 236 236 238 243 244 250 250 251 253 254 255 259 262 264 264 268 279 289 290 299 302 304 315 318 320 332 333 341 342 343
17.1 Objeto Consulta no E3Browser 17.2 Outras Configuraes do E3Browser 18 E3Chart 18.1 Configuraes do E3Chart 18.2 Exemplos de Utilizao do E3Chart 18.3 Caractersticas Especficas de Runtime 19 E3Playback 19.1 Objeto E3Playback 19.2 Adicionar Playback ao Demo do E3 19.3 Interface de Usurio do E3Playback 19.4 Banco de Dados de Playback 19.5 Configurao dos Objetos de Banco de Dados do E3 20 Frmulas 20.1 Configuraes da Frmula 20.2 Templates 20.3 Unidades 20.4 Conjunto de Valores 20.5 Exemplo de Criao de uma Frmula 21 Bibliotecas 21.1 Galeria 21.2 Biblioteca do Usurio (ElipseX) 21.3 Quando Criar um ElipseX 22 Relatrios 22.1 Objeto Consulta 22.2 Componentes do Relatrio 22.3 Configuraes do Relatrio 22.4 Criando um Relatrio no E3 22.5 Exemplos de Utilizao nos Relatrios 23 Segurana 23.1 Usurios 23.2 Grupos 23.3 Permisses 23.4 Proteo de Arquivos 24 E3 Viewer e E3 WebViewer 24.1 Viewer Only (Modo Somente Leitura) 24.2 Execuo do E3 Viewer 24.3 Logs do Viewer 24.4 Execuo do E3 WebViewer 25 Hot-Standby 25.1 Configurando o Hot-Standby 25.2 Executando um Domnio Redundante 25.3 Parando um Domnio Redundante 25.4 Parando um dos Servidores do Domnio 25.5 Tempo de Troca entre Servidores 25.6 Reconexo de Viewers
344 345 349 350 375 379 384 384 384 389 403 407 411 412 414 416 417 418 425 426 427 436 437 437 438 439 455 456 460 461 466 469 473 477 478 479 482 483 487 488 490 491 491 491 491
25.7 Utilizando Bancos de Dados com Hot-Standby 26 Configuraes Avanadas 27 Dvidas mais Frequentes 27.1 Ordem dos Tabs 27.2 Sobreposio de Animaes nos Objetos 27.3 Objetos de Tela 27.4 Servidor de Banco de Dados SQL Server 27.5 Servidor de Banco de Dados Oracle 27.6 Servidor de Dados 27.7 Drivers de Comunicao 27.8 Alarmes 27.9 E3Alarm 27.10 E3Browser 27.11 E3Chart 27.12 Histrico 27.13 Associaes 27.14 Viewer 27.15 Bibliotecas 27.16 Relatrios 27.17 Domnios e Projetos 27.18 Stored Procedure 27.19 Domnios Remotos
492 493 494 494 494 495 495 496 497 498 499 500 501 501 501 502 502 504 505 507 508 508
CAPTULO
Introduo
Desenvolvido pela Elipse Software, o E3 uma poderosa plataforma para superviso e controle de processos totalmente voltada operao em rede e aplicaes distribudas. O E3 um sistema SCADA (Supervisory Control and Data Acquisition ) que oferece um avanado modelo de objetos, uma poderosa interface grfica, alm de uma arquitetura que permite o rpido desenvolvimento de aplicaes e mxima conectividade com dispositivos e outros aplicativos. Sua concepo incorpora as mais novas tecnologias em desenvolvimento de software, maximizando o desempenho, a produtividade e a qualidade de suas aplicaes e do prprio processo, minimizando perdas e custos. Os sistemas construdos com o E3 geralmente partem da coleta de dados em tempo real de equipamentos de aquisio de dados ou de controle, como os CLPs (Controladores Lgicos Programveis), UTRs (Unidades Terminais Remotas), DAQs (Data Acquisition Boards, Placas de Aquisio de Dados), controladores Multi-Loop ou Single-Loop , centrais de incndio e balanas, dentre outros dispositivos. Estes equipamentos normalmente possuem alguma interface que permitem sua conexo ao software, como padres seriais RS232, RS422 ou RS485; rdio ou modem (linhas privadas ou discadas), TCP/IP ou UDP/IP, placas ligadas diretamente no barramento do computador e outros. O E3 l e escreve dados dos equipamentos atravs de mdulos (drivers de comunicao) que implementam o protocolo (de Domnio pblico ou privado) disponvel em cada um desses equipamentos. Esses drivers podem ainda estar em um formato prprio da Elipse Software ou no formato OPC (OLE for Process Control ). De posse dos dados, possvel criar vrias maneiras para exibir, analisar, controlar, comandar, gravar ou divulgar tais informaes, dentre elas: Telas: permitem criar uma IHM (Interface Homem-Mquina) localmente, pela rede local ou Internet, com o intuito de exibir o status atual ou passado dos dados em vrias formas, com o auxlio de um editor grfico e objetos especficos Alarmes e Eventos: monitoram o acontecimento de situaes especficas Histricos: armazenam os dados em bancos de dados relacionais Relatrios: permitem visualizar e imprimir os dados, dentre outros mdulos e possibilidades
Introdu o
1.1.1 E3 Server
o Servidor de Aplicaes, onde os principais processos so executados, incluindo a comunicao em tempo real com os equipamentos de controle. O servidor tambm responsvel por enviar dados e Telas aos clientes conectados em qualquer parte da rede (Intranet e Internet). O servidor pode executar vrios projetos ao mesmo tempo e conversar com outros E3 Servers para realizar um failover (standby) ou distribuir cargas de processamento entre as mquinas.
1.1.2 E3 Studio
Ferramenta nica de configurao, agindo como plataforma universal de desenvolvimento, que possui um ambiente moderno e amigvel, incluindo um completo editor grfico e de scripts (VBScript). Permite que um projeto seja editado por vrias pessoas ao mesmo tempo ou que vrios E3 Studios estejam conectados ao mesmo servidor remoto, com mltiplas configuraes.
1.1.3 E3 Viewer
Permite operar as aplicaes residentes no servidor em qualquer computador com o programa executvel Viewer ou com um navegador de Internet. Em ambos os casos, no necessrio instalar a aplicao na mquina cliente, pois ser feito o download e o registro de todos os componentes (Telas, bibliotecas e controles ActiveX).
Introdu o
1.1.4 E3 Admin
o mdulo responsvel pela interface do E3 Server e de outros mdulos do E3 com o usurio. Atravs dele o usurio pode enviar comandos ao E3 Server, utilizando o cone na rea de Notificao da Barra de Tarefas do Windows, e controlar o Domnio pela linha de comando.
1.2 Arquitetura do E3
Para supervisionar um determinado processo com um sistema SCADA, geralmente construda uma aplicao que conter a definio das variveis envolvidas, com nomes e endereamentos, telas, definies de alarmes e outros, a qual se chama Banco de Dados da Aplicao. Quando esse processo exige o uso de dois ou mais computadores, preciso fazer com que cada aplicao em cada computador troque dados com as outras. A maioria dos sistemas SCADA tradicionais baseiam-se numa arquitetura comum para realizar essa tarefa: Cada servidor SCADA deve ter uma cpia (parcial ou no) da aplicao configurada na base de dados local Cada servidor SCADA possui e executa somente uma base de dados ao mesmo tempo
Isso leva a alguns problemas de gerenciamento, como aplicar mudanas a todos os servidores, controlar verses do aplicativo ou ento trabalhar com diferentes fabricantes de software e hardware. O Elipse E3 resolve esse problema usando o conceito de Domnio que inclui, em um nico ambiente, a definio dos computadores executando tarefas em tempo real (servidores) e as bases de dados de projeto que devem ser executadas nesses servidores, com a possibilidade de execuo de vrios projetos em cada servidor. Tambm possvel inserir, apagar ou modificar projetos durante a execuo, sem afetar as outras partes do Domnio em execuo. Cada projeto pode conter qualquer tipo de objeto, como Telas, Drivers I/O, Alarmes, Histricos, Relatrios, Frmulas, Bancos de Dados, dentre outros. Quando dois ou mais projetos esto dentro de um mesmo Domnio, eles podem acessar as propriedades e objetos entre si como se estivessem residentes em uma nica base de dados. Isso possvel atravs do uso de associaes (conexes) que um objeto pode fazer com qualquer outro. Se ambos os objetos existem e esto rodando, a conexo est ativa e qualquer mudana de valor enviada assincronamente entre as partes (dependendo do tipo da conexo). Se um dos objetos destrudo ou parado, a conexo quebrada, ento a aplicao notificada e pode indicar o estado numa forma definida pelo usurio. A estrutura do Domnio restrita aos servidores e afins, como as mquinas servidoras, projetos, usurios e senhas. A interface do cliente para operao e visualizao, chamada E3 Viewer, pode se conectar diretamente a qualquer servidor E3 (com as licenas suficientes de Viewer). O E3 Viewer possui trs destaques especiais: Os projetos da aplicao residem somente no servidor Introdu o 9
O navegador Internet Explorer pode ser usado como interface de operao sem nenhuma mudana A interface do cliente capaz de alternar de um servidor desligado ou com falha para o prximo servidor disponvel, sem interromper a monitorao do processo
Como alternativa ao uso do E3 Viewer na mquina cliente, possvel utilizar a tecnologia de Terminal Service. Este servio surgiu no Windows NT 4.0 e sua funo permitir o acesso remoto entre computadores, atravs de um protocolo chamado RDP (Remote Desktop Protocol ). Esse protocolo permite a interao entre uma estao cliente e uma mquina servidora (que ser acessada remotamente). O E3 Viewer executado numa nova sesso de usurio criada na mquina servidora, que por sua vez, transfere para a mquina cliente os dados de vdeo e recebe de volta os eventos de mouse e teclado.
10
Introdu o
possvel observar que em todos os casos o E3 Viewer continua sendo a interface de operao e visualizao. A diferena est no local de execuo, que pode ser na mquina cliente (operao normal do E3 Viewer) ou na mquina servidora, com o operador fisicamente junto mquina ou atravs dos Terminal Services. Com o E3 Viewer sendo executado diretamente na estao cliente, existe um maior trfego inicial para o download de telas e objetos. Esse trfego diminui substancialmente medida que somente as mudanas nos dados so reportadas do servidor para o Viewer, o que traz vantagens em termos de desempenho e qualidade de apresentao grfica. O Terminal Service, por outro lado, possui maior alcance e exige menor capacidade de processamento da mquina cliente quando existem poucos efeitos grficos e visuais, alm da possibilidade de operar o E3 em outras plataformas de software que no so suportadas pelo E3 Viewer, como o Windows CE e o Linux/Unix. Entretanto, o RDP possui a limitao de exibir somente 256 cores, o que aumenta consideravelmente o trfego quando existem muitas animaes ou efeitos piscantes nas telas. Para verificar qual a melhor maneira de implementar mltiplos acessos a um E3 Server, importante estudar caso a caso, para poder definir a melhor alternativa para a aplicao. Para utilizar o RDP com mltiplos usurios, necessrio uma licena de Windows 2003 Server SP2, alm do mesmo nmero de Viewers disponveis no Servidor.
Diagrama dos blocos que compem o E3 Detalhadamente, o E3 Server responsvel por criar um processo de execuo (E3 Runtime) que vai efetivamente executar a aplicao. Dentro do Runtime encontram-se outros servidores, que expem servios utilizados por outros mdulos.
Introdu o
11
12
Introdu o
O tempo mximo de execuo de um Domnio de duas horas S permitida a gravao de no mximo 20 Tags de Comunicao em um objeto Storage Permite acesso como OPC Server Permite executar o playback das ltimas seis horas de dados, com um nmero ilimitado de Tags e com todos os recursos de playback habilitados No permitido utilizar a ferramenta de Importao e Exportao do E3 Studio
Introdu o
13
CAPTULO
E3 Studio
O E3 Studio o ambiente de desenvolvimento do E3. Nele, possvel a criao e manuteno de Domnios, projetos e bibliotecas.
Caminho indicado pelo sistema quando o E3 instalado Para iniciar uma aplicao no E3 Studio, siga estes procedimentos: 1. No momento da instalao, criado um grupo de programas no menu Iniciar do Windows. Para iniciar o E3 Studio, basta escolher o cone correspondente nesse menu, como mostra a figura anterior, ou clicar no cone do E3, que criado na rea de Trabalho, conforme figura a seguir.
cone do E3 2. O dispositivo de proteo dever estar conectado na porta de comunicao adequada, no 14 E3 Studio
caso de uma edio local, ou a mquina deve estar na mesma rede local que outra com o E3 Server j previamente instalado, e com um dispositivo de proteo presente.
Janela Iniciar o E3 Studio As opes disponveis so as seguintes: Opes disponveis na janela Iniciar o E3 Studio OPO Iniciar o E3 Studio Criar um Domnio novo DESCRIO No ser aberto nenhum Domnio. Sero requisitados o nome e caminho do novo Domnio. Ao clicar em Outros Arquivos, tem-se a opo de localizar um Domnio num diretrio especfico, ou escolher na lista um dos ltimos aplicativos editados.
novo projeto.
rea de trabalho do E3 Studio A Barra de Ttulo mostra o caminho e o nome da aplicao, ou o nome do objeto cuja view esteja sendo mostrada na rea de trabalho. A Barra de Status mostra informaes de ajuda a respeito da rea da tela, sobre a qual est o ponteiro do mouse. A Barra de Ferramentas mostra os objetos, componentes e demais recursos que podem ser utilizados na Tela e no E3. A rea de Trabalho onde as views so mostradas.
16
E3 Studio
Aba Comandos As opes disponveis so as seguintes: Opes disponveis na aba Comandos OPO Categorias DESCRIO Mostra as opes dos menus e barras de ferramentas disponveis no E3 Studio. Mostra os itens que compem o menu ou a barra de ferramentas selecionada. Breve descrio da opo selecionada.
Comandos
Descrio
Aba Barra de Ferramentas: Atravs desta aba, pode-se configurar, editar ou criar novas barras de ferramentas
E3 Studio
17
Aba Barra de ferramentas As opes disponveis so as seguintes: Opes disponveis na aba Barra de ferramentas OPO Barra de ferramentas DESCRIO Lista as opes de barras de ferramentas disponveis. Restaura a barra de ferramentas desejada no E3. Restaura todas as barras de ferramentas no E3. Cria uma nova barra de ferramentas. Muda o nome da barra de ferramentas. Esta opo utilizada somente na barra de ferramentas criada pelo usurio atravs do boto Nova. Remove a barra de ferramentas selecionada. Mostra uma legenda nas opes da barra de ferramentas selecionada.
Boto Restaurar
18
E3 Studio
Aba Menus As opes disponveis so as seguintes: Opes disponveis na aba Menus OPO Mostra menus para DESCRIO Exibe o menu pr-definido da aplicao. Essa opo no tem efeito, e mantida no E3 por questo de compatibilidade. Restaura o menu definido na opo anterior. Essa opo no tem efeito, e mantida no E3 por questo de compatibilidade. Seleciona o tipo de animao usada nos menus: Nenhuma (padro do E3), Desdobrar, Deslizar, Fade e Default (padro do Windows). Define se o menu apresentar o efeito de sombreado ou no.
Boto Restaurar
Aba Aparncia: Atravs desta aba, possvel alterar a aparncia das janelas e barras de ferramentas no E3 Studio
E3 Studio
19
Aba Aparncia As opes disponveis so as seguintes: Opes disponveis na aba Aparncia OPO Office XP DESCRIO Configura a aparncia do E3 Studio como no Office XP. Configura a aparncia do E3 Studio como no Windows XP (no disponvel no estilo Windows Clssico). Configura a aparncia do E3 Studio como no Office 2000. Configura a aparncia do E3 Studio como no Office 2003. Configura a aparncia do E3 Studio como no Visual Studio .Net 2005.
Windows XP
Office 2000
Office 2003
VS.Net 2005
Aba Opes: Atravs desta aba possvel configurar as especificaes gerais do projeto. Nesse item possvel habilitar ou desabilitar as opes da barra de ferramentas
20
E3 Studio
Aba Opes As opes disponveis so as seguintes: Opes disponveis na aba Opes OPO Mostrar descries DESCRIO Habilita o E3 a mostrar uma breve descrio nas opes das barras de ferramentas e menus quando o mouse posicionado sobre o item. Mostra ou no a tecla de atalho na descrio do boto. Habilita cones grandes nas barras de ferramentas.
cones grandes
E3 Studio
21
Configuraes do Editor de Scripts As opes disponveis deste item so as seguintes: Opes disponveis na aba Editor OPO Abrir-e-Fechar blocos do texto DESCRIO Permite ocultar ou mostrar os blocos de cdigo no script. Tamanho da margem da marcao do bloco de cdigo. Habilita a numerao de linha no editor de scripts. Tamanho da margem que contm a numerao de linha. Determina o nmero de espaos de tabulao. Determina o nome da fonte a ser usada no editor de scripts. Determina o tamanho da fonte a ser usada no editor de scripts.
Tamanho da margem
Numerao da linha
Tamanho da margem
Tamanho do Tab
Fonte
Tamanho
22
E3 Studio
NOTA : Feche os editores de scripts abertos para que as modificaes sejam aplicadas.
Configuraes de Arquivos Toda a vez que um projeto ou uma biblioteca criado, o E3 grava internamente um cdigo CRC (Cyclic Redundancy Check, Verificao de Redundncia Cclica) dos dados deste arquivo. Cada vez que um arquivo aberto, feita uma verificao desse CRC. Caso essa verificao falhe (ou seja, o CRC no coincida com os dados), a carga do arquivo abortada, indicando uma corrupo dos dados do arquivo. Isso pode ser causado por falhas diversas de hardware: memria, rede, dispositivo de armazenamento, etc. Porm, se um projeto criado na verso atual modificado numa verso inferior a 1.00.019 build 203, o CRC no atualizado. Com isso, o arquivo no poder ser aberto novamente com as verses atuais, pois a verificao de CRC ir falhar, mesmo que o arquivo no esteja efetivamente corrompido. Para solucionar essa questo, necessrio habilitar a opo Ignorar verificao de CRC. Assim, o projeto poder ser aberto numa verso atual. Neste caso, a opo dever permanecer habilitada at que todos os objetos editados na verso antiga tenham sido salvos com a verso atual, o que ir atualizar o CRC.
E3 Studio
23
NOTA : No recomendvel que arquivos .prj sejam editados em verses mais antigas do E3 e depois abertos novamente em verses atuais, pois no h garantia de que com esse procedimento no sero perdidas as configuraes desses arquivos.
Studio: Configura o comportamento do duplo-clique de objetos no Organizer, quando a view de um objeto j estiver aberta
Configuraes do Studio As opes disponveis deste item so as seguintes: Opes disponveis na aba Studio OPO Ativar a view de Scripts DESCRIO Ativa a view de Scripts na ocorrncia de um duplo-clique. Abre a Janela de Propriedades na ocorrncia de um duplo-clique.
24
E3 Studio
Recortar
Copiar
Colar
Desfazer
Refazer
Mostrar no Editor
E3 Studio
25
CONE
AO Mostra o objeto no Organizer, se este estiver selecionado na view do objeto. Salva tudo, executa o Domnio e abre o Viewer. Executa ou para o Domnio corrente. Executa ou para o E3 Viewer. Verifica se o Domnio contm erros. Mostra o erro anterior encontrado no Domnio. Mostra o prximo erro encontrado no Domnio. Desfragmenta o arquivo especificado. Procura todas as ocorrncias de um determinado texto em todo o Domnio. Gera a documentao dos scripts. Mostra as verses dos projetos e bibliotecas. Mostra os valores de Tags e de propriedades no E3 Studio em tempo de execuo.
Executar aplicativo
Erro anterior
Prximo erro
Desfragmentar arquivos
Procurar/Substituir
Documentao de scripts
Relatrio de verses
WatchWindow
Opes disponveis na barra de ferramentas Sombra CONE COMANDO Sombra do objeto AO Aplica uma sombra no objeto. Desloca a sombra para cima do objeto. Desloca a sombra para baixo do objeto. E3 Studio
Sombra acima
Sombra abaixo 26
CONE
AO Desloca a sombra para a esquerda do objeto. Desloca a sombra para a direita do objeto. Seleciona a cor da sombra.
Opes disponveis na barra de ferramentas Objetos CONE E3Alarm E3Browser E3Chart Caixa de Seleo COMANDO AO Insere um objeto E3Alarm. Insere um objeto E3Browser. Insere um objeto E3Chart. Insere um objeto Caixa de Seleo (CheckBox). Insere um objeto Boto de Opo (OptionButton). Insere um objeto Lista de Seleo (ComboBox). Insere um objeto Boto de Comando (CommandButton). Insere um objeto Texto (Label). Insere um objeto Lista (ListBox). Insere um objeto Barra de Rolagem (ScrollBar). Insere um objeto Boto Incremento-Decremento (SpinButton). Insere um objeto Editor de Texto (TextBox). Insere um objeto Boto LigaDesliga (ToggleButton).
Boto de Opo
Lista de Seleo
Boto de Comando
Texto
Lista
Barra de Rolagem
Boto IncrementoDecremento
Editor de Texto
Boto Liga-Desliga
E3 Studio
27
Opes disponveis na barra de ferramentas Tela CONE COMANDO Selecionar Rotacionar AO Habilita o modo de seleo. Habilita o modo de rotao. Mostra o identificador de ordem de navegao entre os objetos. Permite editar pontos de conexo entre objetos. Este boto somente est habilitado em objetos XControl. Insere um objeto do tipo Linha. Insere um objeto do tipo Conector. Insere um objeto do tipo Retngulo. Insere um objeto do tipo Retngulo Arredondado. Insere um objeto do tipo Elipse. Insere um objeto do tipo Arco de Elipse. Insere uma ferramenta de desenho livre. Insere um objeto do tipo Polgono. Insere um objeto do tipo Polgono de Curvas. Insere um objeto do tipo Imagem. Insere um objeto do tipo Texto.
Linha
Conector
Retngulo
Retngulo arredondado
Elipse
Arco de Elipse
Desenho livre
Polgono
Polgono de Curvas
Figura
Texto
28
E3 Studio
CONE Display
COMANDO
AO Insere um objeto do tipo Display. Insere um objeto do tipo SetPoint. Insere um objeto do tipo Escala. Agrupa uma seleo de objetos. Desagrupa uma seleo de objetos. Insere uma ferramenta para movimentos lineares. Insere uma ferramenta para rotao. Traz o objeto para frente em um agrupamento. Envia o objeto para trs em um agrupamento. Insere um objeto acima no agrupamento. Insere um objeto abaixo no agrupamento. Permite editar o nvel de zoom da Tela. Permite editar as camadas de objetos na Tela.
SetPoint
Escala
Agrupar
Desagrupar
Avanar
Recuar
Zoom
Camadas
Opes disponveis na barra de ferramentas Desenho CONE COMANDO Cor do fundo AO Define a cor do fundo do objeto. Define a cor da frente do objeto.
Cor da frente
E3 Studio
29
CONE
AO Define a cor da borda do objeto. Define o estilo da borda do objeto. Define a espessura da linha do objeto. Define o estilo do preenchimento do objeto.
Estilo da borda
Espessura da linha
Estilo do preenchimento
Opes disponveis na barra de ferramentas Alinhamento CONE COMANDO Alinhar esquerda Alinhar direita Alinhamento superior Alinhamento inferior Mesma largura AO Alinha objetos esquerda. Alinha objetos direita. Alinha objetos pelo topo. Alinha objetos pela base. Aplica a mesma largura a todos os objetos. Aplica a mesma altura a todos os objetos. Aplica o mesmo tamanho aos objetos selecionados. Centraliza os objetos horizontalmente. Centraliza os objetos verticalmente. Formata o espaamento entre objetos na horizontal. Formata o espaamento entre objetos na vertical. Aplica uma reflexo horizontal no objeto selecionado.
Mesma altura
Mesmo tamanho
Centralizar horizontalmente
Centralizar verticalmente
Distribui horizontalmente
Distribuir verticalmente
Espelhar horizontalmente
30
E3 Studio
CONE
Opes disponveis na barra de ferramentas Formatao CONE Fonte Tamanho da fonte Cor da fonte Fonte em negrito Fonte em itlico Fonte sublinhada Texto esquerda Texto centralizado Texto direita COMANDO AO Determina a fonte do texto. Determina o tamanho da fonte. Determina a cor da fonte. Formata o texto em negrito. Formata o texto em itlico. Formata o texto com sublinhado. Alinha o texto esquerda. Centraliza o texto. Alinha o texto direita.
E3 Studio
31
Verificao de Erros no Projeto Enquanto o erro no for solucionado, a caixa de dilogo continuar sendo mostrada e no ser possvel executar o Viewer. Aps a resoluo do problema, o E3 Studio mostrar uma caixa de mensagem indicando que no encontrou nenhum erro no Domnio, e liberar a execuo do Viewer.
Mensagem do Item Verificar Domnio A opo Verificar Domnio pode ser acessada das seguintes maneiras: Atravs do cone , disponvel na barra de ferramentas Padro: Verifica os erros ocorridos em todo o Domnio Atravs do menu Ferramentas - Verificar Domnio: mesmo funcionamento da opo anterior Clicando com o boto direito do mouse sobre um item do projeto e selecionando a opo Verificar ou Verificar projeto: Verifica os erros ocorridos somente no objeto selecionado e em seus filhos
32
E3 Studio
Janela Procurar/Substituir Existem trs maneiras de se realizar a procura e a substituio: Escolher um item no Organizer, clicar com o boto direito do mouse sobre ele, e selecionar a opo Procurar/Substituir. Essa procura feita a partir do item, seguindo a hierarquia (apenas objetos filhos sero pesquisados) Clicar no menu principal do E3 Studio, em Ferramentas - Procurar/Substituir. Essa procura feita em todos os projetos e bibliotecas abertos Clicar no cone Procurar/Substituir efetuada em todo o Domnio , na barra de ferramentas Padro. A procura ser
As opes disponveis so as seguintes: Opes disponveis na ferramenta Procurar/Substituir OPO Procurar por Boto Procurar Apenas nos resultados DESCRIO Contm o texto a ser procurado. Inicia a busca pelo texto. Refaz a pesquisa apenas entre os resultados da pesquisa anterior. Procura pelo texto exatamente como foi escrito, diferenciando maisculas de minsculas.
E3 Studio
33
DESCRIO Procura o texto especificado como uma palavra inteira. No considera o texto como uma substring de outro. Contm o texto a ser utilizado na substituio. Inicia o processo de substituio. Faz a substituio da linha selecionada e seleciona a prxima linha vlida. Substitui, de uma s vez, todas as ocorrncias do texto. Substitui, de uma s vez, todas as ocorrncias marcadas na lista de resultados. Mostra ou esconde as opes de pesquisa e substituio. Seleciona na lista de resultados a ocorrncia anterior. Seleciona na lista de resultados a ocorrncia seguinte.
Substituir por
Todas
Apenas as selecionadas
Boto Boto
ou
Boto
NOTA : Para selecionar o objeto e mostrar o local exato onde o texto se encontra, basta um duplo-clique na lista de resultados, na linha desejada.
A tabela a seguir contm as principais opes de pesquisa, bem como as limitaes para os principais tipos de dados.
34
E3 Studio
Principais opes de pesquisa TIPO DE DADO Data / Hora EXEMPLO 10/02/2010 00:00:10 OBSERVAO Encontra em propriedades do tipo Data/Hora. Se for especificada somente a data, encontra todas as ocorrncias desta data, independente da hora. Se for especificada somente a hora, encontra todas as ocorrncias desta hora, independente da data. Os milissegundos so ignorados na pesquisa. Encontra em todas as propriedades numricas. Pesquisando por 10 encontrar 10 e 10.0, mas no encontrar 10.1 ou 100. Encontra em todas as propriedades numricas de tipo Ponto Flutuante . Pesquisando por 10.1 no encontra 10 (inteiro). As configuraes regionais do Windows so consideradas para validar o smbolo decimal no nmero. Encontra apenas em propriedades do tipo Cor. Deve necessariamente usar vrgulas para separar os valores, que devem estar no sistema RGB. Leva em considerao o idioma do Windows para entender a pesquisa como sendo de um valor Booleano. Encontra Strings inteiras ou partes de Strings (de acordo com o tipo de pesquisa, por palavra inteira ou no). Qualquer tipo de dado pode ser encontrado em propriedades do tipo String.
Inteiro
0 100
Ponto flutuante
10.0 40,5
Cor
255,255,0 0,0,234
Booleano
Verdadeiro True
String
Teste Tag
E3 Studio
35
Esta ferramenta gera um arquivo texto que pode ser editado em qualquer programa de edio de textos. A formatao do arquivo de documentao feita atravs de um assistente chamado Assistente de Documentao de Scripts. Esse assistente responsvel por guiar o usurio na configurao do arquivo de documentao de scripts.
Assistente de Documentao de Scripts Na janela Arquivo de documentao, so definidas as informaes referentes ao arquivo que guardar os scripts da aplicao. No item Nome do arquivo, especifique o nome do arquivo onde ser gerada a documentao dos scripts. Especifique o local onde este arquivo ser salvo no item Salvar o arquivo na pasta, e caso haja necessidade, utilize o boto Procurar.
36
E3 Studio
Arquivo de documentao de scripts Clique no boto Avanar para ir prxima janela. A janela Detalhamento do arquivo permite que se formate o arquivo que contm as informaes de scripts. possvel escolher entre uma documentao simplificada, contendo apenas os nomes dos scripts, ou uma documentao completa, onde todo o cdigo dos scripts ser gravado no arquivo.
E3 Studio
37
Se a opo escolhida for Apenas os nomes dos scripts, ser gravado no arquivo o texto seguinte:
TelaInicial_KeyDown(KeyCode, Shift)
Se for escolhida a opo Todo o script, ento todo o cdigo ser gravado com a mesma formatao (identao, linhas em branco, etc.) feita pelo usurio no editor de scripts. Independente do tipo de formatao escolhida, antes do script gravado um identificador contendo o nome completo do objeto, para evitar conflitos. Por exemplo, para os seguintes objetos:
TelaInicial CommandButton1 Tela1 CommandButton1
Ambos os scripts (considerando um mesmo evento, Click) seriam CommandButton1_Click() . Assim, a gravao no arquivo ficaria desta forma:
<TelaInicial.CommandButton1:CommandButton1_Click()> Sub CommandButton1_Click() ... End Sub
38
E3 Studio
E
<Tela1.CommandButton1:CommandButton1_Click()> Sub CommandButton1_Click() ... End Sub
Isto permite a identificao correta de cada script. Clique no boto Avanar para ir prxima janela. Na janela Separador de scripts, possvel definir o texto que ser gravado entre um script e outro no seu arquivo de documentao. possvel escolher entre linhas em branco ou personalizadas, e ainda informar quantas linhas do tipo escolhido sero inseridas no arquivo.
Separador de scripts Pode-se optar entre uma Linha em branco ou uma Linha personalizada. Escolhendo a opo Linha em branco, o arquivo de documentao ter uma linha em branco entre um script e outro. Escolhendo a opo Linha personalizada, pode-se informar um ou mais caracteres para compor a linha que ser usada como separador. Os caracteres so informados no campo Entre com o texto da linha. Se a opo selecionada Repetir at o final da linha, os caracteres informados sero repetidos at o limite de tamanho da linha, que de 80 caracteres. Pode-se tambm utilizar mais de uma linha como separador, seja ela em branco ou personalizada. Basta informar um nmero entre 1 e 100, no campo Entre com o nmero de linhas do separador. Clique no boto Avanar para finalizar a configurao. Logo aps, o assistente mostrar uma mensagem indicando a finalizao da configurao e a gerao do arquivo que contm a documentao dos scripts.
E3 Studio
39
Mensagem de finalizao da gerao do arquivo que contm os scripts Algumas observaes relevantes: Os scripts de XControls e XObjects so gravados apenas uma vez no arquivo, pois so encontrados durante a pesquisa na biblioteca. Scripts de instncias sero gravados quando o objeto pai da instncia for pesquisado Picks so internamente scripts; logo, tambm sero documentados A gravao no arquivo feita em ordem alfabtica do nome do objeto, dentro de cada projeto ou biblioteca No possvel adicionar scripts a um arquivo j existente, via assistente. Sempre que o assistente chamado, um novo arquivo ser criado ou, caso j exista, ser sobrescrito Esta ferramenta pode demorar algum tempo para gerar o arquivo de documentao, caso a aplicao seja grande e a pesquisa envolva muitos tipos de objetos. Para agilizar a pesquisa, interessante gerar um arquivo para cada tipo de objeto do E3
40
E3 Studio
Relatrio de verses As opes mostradas nesta caixa de dilogo so as seguintes: Opes disponveis na caixa de dilogo Relatrio de verses OPO Projeto/Biblioteca Verso DESCRIO Nome do projeto ou da biblioteca abertos. Indica a verso do projeto ou biblioteca. Esta verso gerada internamente pelo E3, sendo incrementada toda a vez que o projeto salvo, manual ou automaticamente. No caso de projetos ou de bibliotecas protegidos, se a verso no puder ser salva, tambm no ser possvel seu incremento. No entanto, se o usurio tem permisso para abrir e alterar o projeto ou a biblioteca, a verso ser incrementada normalmente. Mostra o comentrio relacionado ao projeto. Esse comentrio pode ser editado atravs da propriedade DocString. No caso de bibliotecas, esse campo fica em branco.
Comentrio
NOTA : Estes campos so apenas para visualizao, no sendo permitida sua edio.
E3 Studio
41
2.4.5 WatchWindow
A ferramenta WatchWindow permite a visualizao do valor corrente de qualquer propriedade ou Tag em tempo de execuo no E3 Studio. Para acessar essa ferramenta, devese clicar no boto da barra de ferramentas Padro ou acessar o menu Ferramentas WatchWindow, que a caixa de dilogo a seguir ser mostrada:
Caixa de dilogo WatchWindow A caixa de dilogo apresenta as seguintes opes: Opes disponveis na caixa de dilogo WatchWindow OPO Boto Adicionar DESCRIO Abre o DomainBrowser (um AppBrowser com os objetos criados no servidor) e seleciona o objeto que ser mostrado na janela do WatchWindow. Remove a linha selecionada da lista de objetos do WatchWindow. Busca toda a rvore de filhos dos objetos selecionados atualmente pelo WatchWindow. Tenta reativar a conexo perdida com o Domnio para que a visualizao seja possvel.
Boto Remover
Boto Atualizar
Boto Conectar
42
E3 Studio
OPO Nome
DESCRIO Indica o Tag ou a propriedade sendo visualizada. Indica a qualidade do Tag ou da propriedade. Indica a estampa de tempo do Tag ou da propriedade. Indica o valor do Tag ou da propriedade, em tempo de execuo. Indica se o Domnio est conectado ou desconectado.
Valor
Status
2.5 Organizer
O Organizer permite uma viso simples e organizada de toda a aplicao, ajudando na edio e configurao de todos os objetos envolvidos, atravs de uma rvore hierrquica de opes. Possui dois modos de visualizao, Domnio e Explorer.
Organizer E3 Studio 43
O modo Domnio mostra apenas as informaes dos objetos abertos pertencentes ao Domnio. Essas informaes esto organizadas em quatro grupos: Configurao, Bibliotecas de Objetos, Visualizao e Objetos de Servidor. Cada grupo apresenta seus objetos ordenados alfabeticamente dentro do respectivo n.
Modo Domnio O grupo Configurao mostra os servidores configurados, bem como os nomes dos arquivos de projetos e de bibliotecas pertencentes ao Domnio. O grupo Bibliotecas de Objetos agrupa os objetos ElipseX de todas as bibliotecas pertencentes ao Domnio, organizados por tipo de objetos (XObjects e XControls). Os demais objetos do E3 esto nos grupos Visualizao e Objetos de Servidor. Em Visualizao esto os objetos que rodam na mquina cliente; j os objetos executados na mquina servidor esto em Objetos de Servidor. O modo Explorer mostra projetos e bibliotecas abertos no E3 Studio, pertencentes ou no ao Domnio. Os objetos so mostrados no projeto ou na biblioteca ao qual pertencem, ordenados alfabeticamente dentro de cada um.
Modo Explorer
44
E3 Studio
A manuteno da aplicao pode ser feita em qualquer um dos dois modos. As operaes realizadas em um modo sero imediatamente refletidas no outro. Para facilitar a localizao dos objetos, ambos os modos so intercambiveis, tanto entre si como com a aba Design da view do objeto. Para alternar o modo de visualizao, siga estes procedimentos: 1. No modo Domnio, clique com o boto direito no objeto e selecione Mostrar no Explorer para visualiz-lo no modo Explorer. 2. No modo Explorer, clique com o boto direito no objeto e selecione Mostrar no Organizer para visualiz-lo no modo Domnio. 3. Em qualquer um dos modos, clique com o boto direito no objeto e selecione Mostrar no Editor para visualiz-lo diretamente na aba Design. 4. Em qualquer view de objetos, na aba Design, clique com o boto direito do mouse no objeto e selecione Mostrar no Organizer ou Mostrar no Explorer para visualiz-lo no Organizer, em seu respectivo modo. Ao clicar em um objeto com o boto esquerdo do mouse, suas propriedades podero ser visualizadas e editadas atravs da Lista de Propriedades, se habilitada. Clicando com o boto direito do mouse sobre cada item do Organizer, so mostradas as seguintes opes: Opes disponveis no Organizer OPO Fechar Atualizar DESCRIO Fecha o projeto ou biblioteca corrente. Atualiza as configuraes do projeto ou biblioteca. Registra a biblioteca para que as modificaes executadas estejam disponveis. Abre uma caixa de dilogo para que o projeto ou a biblioteca sejam salvos no local indicado. Desfragmenta arquivos (.lib ou .prj), isto , faz com que os espaos criados desnecessariamente (por excluso de itens, importao de arquivos, incluso de recursos, etc.) sejam apagados. Aps a desfragmentao, uma janela ser exibida contendo as seguintes informaes: tamanho original do arquivo, tamanho desfragmentado e percentual de compactao.
Registrar
Salvar Como
Desfragmentar
E3 Studio
45
OPO Proteo
DESCRIO Protege o contedo de um arquivo .prj ou .lib contra a edio, visualizao ou execuo no autorizada. Maiores informaes no captulo Segurana. Cria uma nova Pasta na aplicao. Insere objetos disponveis no E3 no projeto ou na biblioteca. Mais informaes sobre essa opo nos respectivos captulos de cada objeto. Insere recursos no projeto ou na biblioteca. Habilita ou desabilita o projeto selecionado. Para desabilitar o projeto, selecione seu nome e escolha a opo Desabilitar projeto. Observe que o nome e cone do projeto aparecero na cor cinza, indicando que o projeto est desabilitado. Para habilitar o projeto, selecione o projeto e escolha a opo Habilitar projeto. Adiciona ou remove o projeto ou a biblioteca do Domnio. Para remover o projeto ou a biblioteca, selecione seu nome e escolha a opo Remover do Domnio. Para adicionlos ao Domnio, selecione-os e escolha a opo Adicionar ao Domnio. Busca por trechos de texto e os substitui por outros, se for o caso. Maiores informaes sobre essa opo na seo Procurar/ Substituir deste captulo. Auxilia o usurio na importao e na exportao de objetos, Associaes e colees. Maiores informaes sobre essa opo na seo Importao e Exportao deste captulo. Auxilia o usurio com a documentao dos scripts da aplicao. Maiores informaes sobre essa opo na seo Documentao de Scripts deste captulo. Verifica os erros ocorridos na aplicao. Maiores informaes sobre essa opo na seo Verificar Domnio deste captulo.
Adicionar/Remover do Domnio
Procurar/Substituir
Importar/Exportar
Documentar Scripts
Verificar
46
E3 Studio
DESCRIO Muda uma ou mais Associaes, eventos de usurio e propriedades do tipo Link feitas na aplicao, de forma mais rpida do que pela janela tradicional. Maiores informaes sobre essa opo no captulo Associaes. Copia ou cola Associaes de um objeto para outro. A segunda opo s mostrada se o que estiver copiado na rea de Transferncia do Windows for uma Associao. Se a propriedade em questo j possuir uma Associao, mostrada uma mensagem ao usurio perguntando se a Associao deve ser sobrescrita ou no. Se as Associaes copiadas na rea de Transferncia forem coladas em um objeto que no possua alguma das propriedades, estas sero listadas para o usurio em uma mensagem informando o problema. As propriedades que existirem tero as Associaes criadas corretamente. Associaes de propriedades escondidas dos ElipseX no so copiadas.
Copiar/Colar Associaes
Propriedades
Abre a Janela de Propriedades do objeto. Quando essa opo aberta pelo menu, a primeira aba a ser aberta ser a de configuraes do objeto. Mais informaes sobre essa opo nos respectivos captulos de cada objeto. Carrega todos os objetos do grupo selecionado. Fecha todos os objetos do grupo selecionado. Salva todos os objetos do grupo selecionado. Cria um novo arquivo .prj e o inclui no Domnio. Cria um novo arquivo .lib e o inclui no Domnio. Registra todas as bibliotecas.
E3 Studio
47
DESCRIO Percorre todos os arquivos .prj e .lib do Domnio; se algum arquivo fechado for encontrado, ele ser aberto. Se o arquivo estiver protegido com senha de edio, ser solicitada a sua senha. O E3 Studio tenta utilizar a mesma senha em todos os arquivos protegidos. Se a senha falhar com algum arquivo, ela solicitada novamente. Fecha todos os arquivos .prj e .lib do Domnio. Se algum arquivo tem alteraes no salvas, perguntado para o usurio se ele deseja salv-las. Permite editar a ordem de ativao dos objetos de Servidor no Domnio (ver figura a seguir).
cada objeto podem ser gravadas suas propriedades, Associaes e itens de colees. possvel, portanto: Criar novos objetos do E3 a partir do arquivo CSV, desde que estes no sejam diretamente objetos filhos do projeto ou biblioteca Importar ou exportar qualquer propriedade de qualquer tipo de objeto do E3 Importar ou exportar qualquer tipo de Associao de objetos do E3 Exportar qualquer tipo de coleo de objetos do E3 e importar suas propriedades Importar ou exportar qualquer tipo de item da coleo de objetos do E3
Qualquer objeto do E3 poder ser importado ou exportado. O objeto selecionado para a operao chamado de objeto raiz. Com isso, possvel importar ou exportar, por exemplo, uma Pasta de Dados com XObjects definidos pelo usurio, ou mesmo exportar uma Tela, listando todos os objetos filhos. Alm dos objetos, as Associaes e as colees tambm podem ser importadas e exportadas. O usurio tem a opo de informar se quer importar ou exportar Associaes e colees ou no.
NOTA : A ferramenta de importao e exportao considera apenas as propriedades e Associaes dos objetos e colees do E3. Informaes que no estejam descritas em propriedades no sero importadas ou exportadas. Isso o caso, por exemplo, de scripts e configuraes internas dos objetos de Tela.
As colunas podem ser colocadas em qualquer ordem no arquivo; pode haver colunas a mais ou a menos, sem prejuzo da operao de importao ou exportao. A nica coluna obrigatria ObjectType , porque sem ela no possvel identificar o tipo de objeto que deve ser criado
Arquivo CSV Visualizado no Excel 2. Salve a planilha com a extenso .csv. 3. Feche o arquivo no Excel. 4. Para importar este arquivo no E3, selecione um objeto IODriver e importe o arquivo criado atravs da opo Importar, escolhendo o modelo adequado. O E3 criar a estrutura de acordo com o arquivo CSV.
50
E3 Studio
Exportao de Objetos Na exportao, todas as propriedades, Associaes, colees e itens de colees do objeto selecionado e de seus filhos sero automaticamente exportadas. gerado um arquivo CSV com uma linha para cada objeto exportado, bem como para cada Associao, coleo ou item de coleo existente nesses objetos. Para cada propriedade criada uma coluna no arquivo, onde informado o valor da propriedade para cada objeto. O objeto selecionado, chamado de objeto raiz, exportado com a coluna da propriedade Name em branco. Nos demais casos, essa coluna contm a hierarquia com nomes separados por pontos. Exemplo de exportao a partir de um objeto IODriver.
E3 Studio
51
Hierarquia de Driver1
ObjectType;Name;Prop1;Prop2;Prop3 IODriver;;0;True;0 IOBlock;Bloco1;0;False;0 IOBlockElement;Bloco1.Elemento1;0;False;0 IOBlockElement;Bloco1.Elemento2;0;False;0 IOBlock;Bloco2;0;False;0 IOBlockElement;Bloco2.Elemento1;0;False;0 IOTag;Tag1,0,True,0
Se desejar, o usurio pode configurar a exportao de objetos atravs do uso de modelos, que so apresentados na seo Modelos. Utilizando um modelo possvel configurar se as Associaes, colees e itens de colees sero ou no exportados, se o objeto raiz ser exportado ou no, quais as propriedades de cada objeto devem ser exportadas, entre outras configuraes. Para isso, siga estes procedimentos: 1. Clique com o boto direito do mouse sobre o objeto desejado e selecione a opo Exportar. 2. Clique no boto Avanado para configurar ou selecionar um modelo. 3. Na caixa de dilogo, selecione o arquivo CSV desejado e clique no boto Salvar. Para importar objetos, siga esses procedimentos: 1. Clique com o boto direito do mouse sobre o objeto desejado e selecione a opo Importar. 2. Na caixa de dilogo, selecione o arquivo CSV desejado e clique no boto Abrir.
52
E3 Studio
Importao de Objetos Na importao, para cada linha lida do arquivo CSV identificado o objeto que ser criado. Apenas o filho mais ao final da hierarquia pode ser criado. O restante do caminho deve existir. Por exemplo, no objeto Pasta1.Pasta2.Tag , apenas Tag deve ser criado. Pasta1 e Pasta2 devem existir previamente. Assim, permitido ter no arquivo apenas pastas, sem filhos. O arquivo poder ter linhas como essas:
ObjectType;Name IOFolder;Pasta1
As linhas em branco, as linhas onde no encontrado um identificador de tipo vlido, as colunas em branco e as colunas que tenham nomes invlidos de propriedades so ignoradas, sem gerar erro.
2.6.3 Modelos
Os Modelos so arquivos INI utilizados para configurar a ferramenta de importao e exportao, informando, por exemplo, qual o separador que deve ser utilizado no arquivo CSV, se as Associaes dos objetos devem ou no ser exportadas, etc. Os arquivos INI tm o seguinte formato: Linhas iniciadas por ponto e vrgula so comentrios, desconsiderados na interpretao do arquivo O arquivo organizado em sees, e cada seo contm uma ou mais variveis. As sees so identificadas por nomes entre colchetes. As variveis so as palavras antes do smbolo E3 Studio 53
de igualdade. Uma seo no pode conter duas variveis com o mesmo nome Linhas em branco so ignoradas
O formato um texto facilmente modificvel pelo usurio, sendo possvel gerar um modelo novo utilizando um editor de textos comum. O mesmo modelo pode ser utilizado tanto para a importao como para a exportao de objetos. Os modelos utilizados no E3 permitem que o usurio redefina valores para nomes das colunas do arquivo CSV, bem como para os tipos de objetos. Alm disso, tambm permitem que o usurio agrupe mais de uma propriedade em uma mesma coluna. Isso tudo feito atravs da definio de identificadores, que so palavras-chave utilizadas no arquivo CSV e associadas a propriedades ou classes de objetos no arquivo INI. No E3, os modelos da ferramenta de importao e exportao esto definidos com as seguintes sees e variveis: Sees definidas para os Modelos SEO Header (*) DESCRIO Define os identificadores permitidos para nomes de colunas e tipos de dados. Nesta seo devero ser definidas as variveis header e types . (*) Seo obrigatria para a exportao. Configuration Define configuraes adicionais para a ferramenta de importao e exportao. Nesta seo devero ser definidas as variveis separator , root , link , collection , objectduplicated e bindduplicated . Relaciona os identificadores de tipos de dados com as classes de objetos reais. Cada identificador listado na varivel types que no for igual a um nome de classe de objeto dever estar documentado nessa seo, sendo criada uma varivel para cada um dos identificadores.
Types
54
E3 Studio
SEO Columns
DESCRIO Relaciona os identificadores de nomes de colunas com os nomes de propriedades. Cada identificador listado na varivel header que no for igual a um nome de propriedade dever estar documentado nessa seo, sendo criada uma varivel para cada um dos identificadores. Define quais as classes de objetos que devero ou no ser importadas ou exportadas. Nesta seo deve ser definida uma das duas variveis: include ou exclude . Se ambas forem definidas, apenas include ser considerada.
Filter
Variveis definidas para os Modelos SEO header (*) DESCRIO Define a ordem das colunas e os identificadores que sero utilizados. Devem ser listadas todas as colunas que o arquivo CSV ter, separadas por vrgulas. Cada identificador que no for igual a um nome de propriedade dever ser discriminado na seo Columns, cada um com uma varivel. (*) Varivel obrigatria para a exportao. types Define os identificadores para os tipos de dados permitidos no arquivo CSV. Os identificadores devero ser listados nessa varivel separados por vrgulas. S necessrio definir essa varivel se algum identificador for diferente do nome da classe do objeto. Nesse caso, para cada um dos identificadores dever haver tambm uma varivel na seo Types. Define o separador que ser utilizado para delimitar as colunas no arquivo CSV. Caso essa varivel no seja definida, ser utilizado o separador de listas configurado no Windows. Define se o objeto raiz ser exportado ou importado junto com os objetos filhos. Caso essa varivel no seja definida, o objeto raiz ser utilizado.
separator
root
E3 Studio
55
SEO link
DESCRIO Define se as Associaes dos objetos sero exportadas ou importadas. Caso essa varivel no seja definida, as Associaes so utilizadas. Define se as colees dos objetos sero exportadas ou importadas. Caso essa varivel no seja definida, as colees so utilizadas. Define o que fazer quando um objeto prexistente estiver sendo importado. Os valores possveis para essa varivel so: 0 askalways (sempre questiona o usurio sobre o que deve ser feito); 1 - changealways (sempre altera as propriedades do objeto existente); 2 - ignorealways (sempre ignora o objeto sendo importado); e 3 - createalways (sempre cria um objeto novo, autoincrementando o nome). Caso essa varivel no seja definida, assumido o valor askalways. Essa opo no tem valor na exportao. Define o que fazer quando uma Associao pr-existente estiver sendo importada. Os valores possveis para essa varivel so: 0 askalways (sempre questiona o usurio sobre o que deve ser feito); 1 - changealways (sempre substitui a Associao existente pela nova); e 2 - ignorealways (sempre ignora a Associao sendo importada). Caso essa varivel no seja definida, assumido o valor askalways. Essa opo no tem valor na exportao, nem tampouco possui o valor createalways; neste caso, sempre modificado para askalways. Define o que fazer quando uma coleo prexistente estiver sendo importada. Os valores possveis para essa varivel so: 0 askalways (sempre questiona o usurio sobre o que deve ser feito); 1 - changealways (sempre substitui a coleo existente pela nova); e 2 - ignorealways (sempre ignora a coleo sendo importada). Caso essa varivel no seja definida, assumido o valor askalways. Essa opo no tem valor na exportao, nem tampouco possui o valor createalways; neste caso, sempre modificado para askalways.
collection
objectduplicated
bindduplicated
collectionduplicated
56
E3 Studio
SEO itemduplicated
DESCRIO Define o que fazer quando um item de coleo pr-existente estiver sendo importado. Os valores possveis para essa varivel so: 0 - askalways (sempre questiona o usurio sobre o que deve ser feito); 1 changealways (sempre altera as propriedades do item existente); 2 ignorealways (sempre ignora o item sendo importado); e 3 - createalways (sempre cria um item novo, auto-incrementando o nome). Caso essa varivel no seja definida, assumido o valor askalways. Essa opo no tem valor na exportao. Define quais classes de objetos devero ser importadas ou exportadas. O filtro no recursivo, ou seja, se for includa uma classe de um objeto que possa ter filhos, esses filhos no sero includos automaticamente. No pode ser usada junto com a varivel exclude . Apenas o que estiver definido nessa varivel ser exportado ou importado. Define quais classes de objetos no devero ser importadas ou exportadas. O filtro no recursivo, ou seja, se for excluda uma classe de um objeto que possa ter filhos, esses filhos no sero excludos automaticamente. No pode ser usada junto com a varivel include . Apenas o que estiver definido nessa varivel ser desconsiderado na importao ou na exportao.
include
exclude
NOTA : O caractere de ponto e vrgula no pode ser utilizado como nome ou parte do nome da coluna, nem tampouco como nome ou parte do nome do identificador de tipo. Esta limitao se deve ao fato de esse caractere definir um comentrio no arquivo INI. Dessa forma, a varivel criada na seo Columns ou na seo Types para definir o identificador que possui o ponto e vrgula no pode ser lida corretamente.
Exemplo:
E3 Studio
57
[Header] header = ObjectType,Name,DocString,N1/B1,N2/B2,N3/B3,N4/B4,Scan,AllowRead,AllowWrite types = Tag,Bloco,Elemento [Configuration] separator = ',' root = true link = true collection = true objectduplicated = askalways bindduplicated = askalways collectionduplicated = askalways itemduplicated = askalways [Types] Tag = IOTag Bloco = IOBlock Elemento = IOBlockElement [Columns] N1/B1 = N1,B1 N2/B2 = N2,B2 N3/B3 = N3,B3 N4/B4 = N4,B4 [Filter] exclude = IOFolder
A Elipse Software fornece alguns modelos para importao e exportao de alguns tipos de objetos. Esses modelos tambm podem ser utilizados como base para a criao de outros. Os modelos fornecidos esto na pasta Templates da instalao do E3.
NOTA : Na importao, as colunas que sero utilizadas so lidas diretamente do arquivo CSV. Neste caso especfico, no necessria a varivel header no modelo. Porm, se alguma coluna for nomeada por um identificador, este dever estar definido na seo Columns ou a coluna ser ignorada.
58
E3 Studio
Aba Configuraes As opes disponveis so as seguintes: Opes disponveis na aba Configuraes OPO Separador de colunas DESCRIO As opes disponveis so: Usar o separador de listas do Windows (escolhe o caractere definido no Windows como separador de listas para ser usado como separador de colunas do arquivo CSV) e Usar outro caractere como separador (escolhe outro caractere definido pelo usurio como separador de colunas).
E3 Studio
59
DESCRIO Define o que ser importado ou exportado: objetos, Associaes ou colees. As opes disponveis so: Importar/exportar o objeto raiz, Importar/exportar associaes e Importar/exportar colees. Quando a opo Salvar as alteraes deste modelo em um arquivo INI for marcada, definido o arquivo INI onde as alteraes do modelo sero salvas, e esse arquivo poder ser reutilizado. Quando for desmarcada, as configuraes feitas sero salvas temporariamente em um arquivo na pasta de arquivos temporrios do Windows. Esse arquivo ser utilizado para a importao ou exportao realizada logo aps a configurao, e ser removido depois disso.
Salvar modelo
Importao: Atravs desta aba, o usurio pode configurar as opes vlidas somente para a importao.
60
E3 Studio
Aba Importao As opes disponveis so as seguintes: Opes disponveis na aba Importao OPO Importao de objetos duplicados DESCRIO Especifica como o E3 deve lidar com a ocorrncia de objetos duplicados na importao. As opes disponveis so Questionar sobre o que fazer em cada caso, Sempre sobrescrever o objeto existente , Sempre ignorar o objeto duplicado e Sempre criar um novo objeto.
E3 Studio
61
DESCRIO Especifica como o E3 deve lidar com a ocorrncia de Associaes duplicadas na importao. As opes disponveis so Questionar sobre o que fazer em cada caso, Sempre sobrescrever a associao existente e Sempre ignorar a associao duplicada. Especifica como o E3 deve lidar com a ocorrncia de colees duplicadas na importao. As opes disponveis so Questionar sobre o que fazer em cada caso, Sempre sobrescrever a coleo existente e Sempre ignorar a coleo duplicada. Especifica como o E3 deve lidar com a ocorrncia de itens de coleo duplicados na importao. As opes disponveis so Questionar sobre o que fazer em cada caso, Sempre sobrescrever o item existente , Sempre ignorar o item duplicado e Sempre criar um novo item.
Filtros: Atravs desta aba, o usurio pode escolher quais as classes que sero utilizadas na importao ou na exportao, ou quais classes no deseja utilizar
62
E3 Studio
Aba Filtros As opes disponveis so as seguintes: Opes disponveis na aba Filtros OPO No filtrar objetos DESCRIO Define a importao ou a exportao de todos os objetos. Define quais classes de objetos sero importadas ou exportadas. Define quais classes de objetos no sero importadas ou exportadas. Abre uma janela para seleo das classes de objetos a serem includas ou excludas. Abre uma janela de ajuda para a opo. 63
Boto Alterar
Boto E3 Studio
Classes de Objetos As classes que preenchem inicialmente a lista so as do objeto raiz e seus filhos, caso um novo modelo esteja sendo criado. O usurio pode adicionar outras, clicando no boto , ou remover alguma classe, clicando no boto .
Identificadores: Atravs desta aba, o usurio define os identificadores para as classes de objetos escolhidas. O estado inicial dessa lista vazio
64
E3 Studio
Aba Identificadores As opes disponveis so as seguintes: Opes disponveis na aba Identificadores OPO Nome da classe DESCRIO Indica o nome da classe selecionada na opo.
E3 Studio
65
OPO Identificador
DESCRIO Permite ao usurio alterar o valor a ser utilizado na coluna ObjectType do arquivo CSV. O valor inicial nesta coluna sempre o nome da classe do objeto. Para cada valor alterado aqui, criada uma entrada no arquivo INI na seo Types. Os valores no so sensveis caixa (isto , "AAA", "aaa" e "aAa" so o mesmo valor). Caso o usurio defina valores iguais para mais de um tipo, apenas o primeiro tipo ser considerado na importao, e algum objeto poder ser criado com o tipo errado. Adiciona classes de objetos. Remove a classe de objetos selecionada. Apresenta uma janela com texto de ajuda.
Propriedades: Atravs desta aba, o usurio escolhe quais as propriedades dos objetos que deseja utilizar na importao ou na exportao. O valor inicial da lista ObjectType ; as demais propriedades devem ser adicionadas manualmente pelo usurio
66
E3 Studio
E3 Studio
67
Opes disponveis na aba Propriedades OPO Nome da coluna DESCRIO Permite ao usurio alterar o valor a ser utilizado como nome da coluna no cabealho do arquivo CSV. O valor inicial dessa coluna sempre o prprio nome da propriedade do objeto. Para cada valor alterado nessa coluna, criada uma entrada no arquivo INI na seo Columns. Os nomes das colunas no so sensveis caixa (isto , "AAA", "aaa" e "aAa" so o mesmo valor); caso o usurio defina nomes de colunas iguais para mais de uma propriedade, apenas uma delas ser identificada corretamente, e todas as colunas com o mesmo nome sero relacionadas mesma propriedade; nesse caso, algum valor pode ser sobrescrito. Indica a propriedade sendo importada ou exportada. Redefinem a ordem das colunas ao alterar a ordem das propriedades na lista. Adiciona propriedades lista. Exclui propriedades da lista, com exceo de ObjectType . Alternativamente, pode-se utilizar a tecla DELETE para excluir uma propriedade. Cria um nome de coluna associado a mais de uma propriedade. Selecione as propriedades que deseja agrupar e clique neste boto. Os nomes das propriedades so agrupados em uma mesma linha, utilizando o nome da coluna definido para a propriedade que est no topo da lista. Mostra uma janela com texto de ajuda.
Propriedade
Botes
Boto Boto
Boto
Boto
Ao pressionar o boto
68
E3 Studio
Seleo de Propriedades As opes disponveis so as seguintes: Opes disponveis na janela Propriedades OPO Classes de objetos DESCRIO Apresenta as classes de objetos que se enquadram no filtro escolhido a partir do objeto raiz. Adiciona todas as propriedades do tipo de objeto selecionado na opo anterior. Se esta opo for selecionada, a caixa de seleo de objetos mostrar todas as classes existentes no E3, independente de filtro ou objeto raiz. Mostra as propriedades do objeto selecionado.
Propriedades
As propriedades em negrito nesta lista j foram inseridas na lista que define as colunas do arquivo CSV. Um duplo-clique sobre uma propriedade faz com que ela seja adicionada ou removida, dependendo se ela j estava ou no na lista. Se a propriedade havia sido agrupada com outras, o duplo-clique remove apenas essa propriedade do agrupamento, mantendo as outras propriedades agrupadas corretamente. As propriedades do tipo Font possuem propriedades internas que configuram separadamente tipo, tamanho e outras caractersticas da fonte. Elas so exportadas com o nome da propriedade principal (de acordo com o objeto), seguido do nome da propriedade interna, E3 Studio 69
separados por um ponto (por exemplo, TextFont.Bold). No configurador de modelos, as propriedades internas aparecem separadas para o usurio, para que a escolha possa ser feita isoladamente.
70
E3 Studio
Exportao de Drivers 3. Escolha o local e o nome do arquivo a ser gerado. Alm do arquivo com as configuraes dos Tags, ser gerado um arquivo com o mesmo nome, seguido do sufixo _Alarms. Esse arquivo ser utilizado posteriormente na importao da configurao de alarmes no E3. Para fazer a importao dos Tags no E3 3.0, siga esses passos: 1. Insira um Driver de Comunicao no Organizer do E3. 2. Renomeie o Driver para que fique com o mesmo nome do Driver utilizado na aplicao Elipse SCADA, para que posteriormente as referncias para os Tags desse Driver sejam importadas corretamente. 3. Clique com o boto direito do mouse no Driver de Comunicao, e clique em Importar. 4. Na lista de tipos de arquivos, selecione a opo Arquivos do Elipse SCADA (*.e2f), e a seguir selecione o arquivo exportado anteriormente, sem o sufixo _Alarms. No necessrio selecionar um modelo.
E3 Studio
71
Importao de Tags
72
E3 Studio
Exportao de Tags 3. Escolha o local e o nome do arquivo a ser gerado. Alm do arquivo com as configuraes dos Tags, ser gerado um arquivo com o mesmo nome seguido do sufixo _Alarms. Esse arquivo ser utilizado posteriormente na importao da configurao de alarmes no E3. Para fazer a importao dos Tags no E3 3.0, siga esses passos: 1. Insira um Servidor de Dados no Organizer do E3. 2. Renomeie o Servidor de Dados para Dados , para que posteriormente as Associaes dos objetos de Tela sejam importadas corretamente. 3. Clique com o boto direito do mouse no Servidor de Dados, e clique na opo Importar. 4. Na lista de tipos de arquivos, selecione a opo Arquivos do Elipse SCADA (*.e2f), e a seguir selecione o arquivo exportado anteriormente, sem o sufixo _Alarms. No necessrio selecionar um modelo.
E3 Studio
73
Exportao de Configuraes e Tags de Servidores OPC 3. Escolha o local e o nome do arquivo a ser gerado. Alm do arquivo com as configuraes dos Tags OPC, ser gerado um arquivo com o mesmo nome seguido do sufixo _Alarms. Esse arquivo ser utilizado posteriormente na importao da configurao de alarmes no E3. Para fazer a importao dos Tags OPC no E3 3.0, siga esses passos: 1. No Organizer do E3, insira um novo Driver de Comunicao OPC. 2. Renomeie o Driver de Comunicao OPC para que fique com o mesmo nome do Driver OPC utilizado na aplicao Elipse SCADA, para que posteriormente as referncias para os Tags deste Driver OPC sejam importadas corretamente. 3. Clique com o boto direito do mouse no Driver OPC, e selecione a opo Importar. 4. Na lista de tipos de arquivos, selecione a opo Arquivos do Elipse SCADA (*.e2f), e a seguir 74 E3 Studio
selecione o arquivo exportado anteriormente, sem o sufixo _Alarms. No necessrio selecionar um modelo.
E3 Studio
75
Exportao de Telas 3. Escolha o local e o nome do arquivo a ser gerado. 4. No Organizer do E3, insira uma nova Tela. 5. Clique com o boto direito do mouse sobre a Tela e selecione a opo Importar. 6. Na lista de tipos de arquivos, selecione a opo Arquivos do Elipse SCADA (*.e2f), e a seguir selecione o arquivo exportado anteriormente. No necessrio selecionar um modelo. Se a importao foi realizada com sucesso, a Tela ser preenchida com os objetos, e nenhuma mensagem de erro ser mostrada. Os arquivos de imagens utilizados pela Tela devem ser tratados conforme um dos casos a seguir: Arquivos de imagens com caminhos relativos na aplicao Elipse SCADA : estes arquivos devem ser inseridos manualmente como Recursos no projeto do E3. possvel inserir vrios arquivos de uma vez, clicando com o boto direito do mouse na pasta Recursos do Organizer, e escolhendo a opo Inserir recurso em Arquivos de imagens com caminhos absolutos: estes arquivos devem permanecer nos seus diretrios originais. O E3 ir procur-los no mesmo diretrio onde so encontrados pela aplicao do Elipse SCADA
76
E3 Studio
NOTA : recomendado inserir todos os arquivos no projeto como Recursos, para que o Viewer do E3 possa fazer o download automaticamente pela rede. Isso evita a necessidade de ter que instalar os arquivos manualmente nas mquinas cliente.
As propriedades ou os campos das Associaes so importados ou exportados como se fossem propriedades de objetos, com uma coluna no arquivo CSV para cada uma delas. Todas as Associaes possuem as propriedades Source e Property, e alm delas, as propriedades existentes para cada Associao so as seguintes: AgSimple : Reverse , Bidirectional AnalogBind: SrcHiValue , SrcLoValue , DstHiValue , DstLoValue AnimationBind: BlinkOn, BlinkOff, OnValue , OffValue , BlinkOnValue , BlinkOffValue
A criao de linhas da tabela respeita o ndice informado pelo usurio. Se o ndice no for um nmero, mostrada uma mensagem de erro (nome invlido). Se for um ndice inexistente (por exemplo, s existem duas linhas na tabela e o usurio quer inserir a linha 5), as linhas que faltam so criadas e ficam com os valores padro. Todas as Associaes so importadas ou exportadas, independente da seleo de propriedades que o usurio tenha feito. Se uma Associao para determinada propriedade j existir, o usurio ser questionado sobre o que fazer. Caso contrrio, elas sero criadas.
E3 Studio
77
Importao de uma Associao pr-existente No nome do objeto, deve ser informado o caminho completo, no formato Objeto.Links.Nome . Exemplo:
Texto1.Links.Value 'Links indica que uma Associao, e Value a propriedade que possui a Associao
No nome do objeto, deve ser informado o caminho completo do tipo Objeto.Collection.Name . Exemplo: 78 E3 Studio
E3Chart1.Pens.Pena1
Na coluna de tipo deve aparecer uma das seguintes palavras-chave: IDispChartPen: para Penas do E3Chart ILegendColumn: para Legendas do E3Chart IAxis: para Eixos do E3Chart ITableBindRow: para linhas das Associaes por Tabela
E3 Studio
79
Lista de Propriedades Pode-se configurar um valor para uma propriedade digitando diretamente no campo selecionado, ou ainda seguindo as instrues da janela ao clicar sobre o campo Valor.
2.8 Galeria
Coleo de objetos grficos que podem ser arrastados e inseridos nas Telas das aplicaes. Estes objetos so arquivos do tipo Metafiles (WMF, Windows MetaFile).
Galeria 80 E3 Studio
2.9 AppBrowser
O AppBrowser uma ferramenta que auxilia o usurio a montar a aplicao informando uma expresso lgica, uma Associao ou um valor para a propriedade sendo manipulada, de acordo com o objeto selecionado. Assim, possvel minimizar erros durante a criao da aplicao.
AppBrowser No quadro esquerda so mostrados os objetos do E3 que podem ser utilizados para compor o texto que ser o resultado do uso do AppBrowser. De acordo com seu contexto de utilizao, alguns objetos no podero ser utilizados e nem sero mostrados aqui. No quadro central so mostradas as propriedades e os mtodos do objeto selecionado, e no quadro direita o texto de ajuda da propriedade ou do mtodo selecionado. Mais abaixo mostrado o texto resultante do AppBrowser, ao lado dos botes Colar e Cancelar . Clique em Colar para aceitar o resultado e copiar o valor para o local desejado. Clique em Cancelar para ignor-lo.
NOTAS: Ao selecionar Tags, o AppBrowser sempre aberto na ltima posio, e no na posio apontada pelo link atual. O AppBrowser possui a funo Auto Complete : basta digitar o nome do objeto desejado que ele ser automaticamente selecionado.
Existem trs maneiras de se utilizar o AppBrowser: Atravs de scripts Atravs de Associaes E3 Studio 81
Atravs de algumas propriedades de objetos que possuem como valor um outro nome de objeto
AppBrowser via Scripts No quadro esquerda: O primeiro item, mostrado isoladamente, o Contexto. O objeto contexto o que originou a chamada do AppBrowser, ou seja, o dono do script O segundo item a Hierarquia completa para se chegar ao objeto contexto, caso o contexto no esteja na raiz do projeto. Esse objeto pode ser expandido e o prprio objeto contexto pode ser visto nesta hierarquia Caso o contexto no seja um objeto do servidor, o terceiro item mostrado ser o Viewer (objeto Application) O quarto item o Servidor. Nele so listados todos os objetos do servidor que a aplicao possui. Caso este item seja o contexto atual, ele conter a indicao de Application O quinto item chamado de Tarefas. Nele aparecem as tarefas mais comuns de serem executadas atravs de um script. So duas: Carregar relatrio (cujo resultado do AppBrowser a expresso para carregar um Relatrio) e Abrir tela (cujo resultado a expresso para abrir a Tela selecionada, equivalente ao Pick Abrir Tela)
82
E3 Studio
Finalmente, o sexto item mostra todas as funes do VBScript disponveis para uso em scripts
De acordo com o objeto selecionado, o quadro central mostra suas propriedades e seus mtodos.
AppBrowser via Associaes Neste caso, apenas as propriedades dos objetos so mostradas no quadro central da janela. Seus mtodos no so mostrados, pois no permitido us-los em Associaes.
E3 Studio
83
AppBrowser via Propriedade As propriedades que permitem o uso do AppBrowser so: DBServer dos objetos Frmula, Histrico e Storage DataSource , do objeto Servidor de Alarmes InitialScreen, do objeto Viewer SplitLink, do objeto Quadro
2.10 Conectar A
A opo Conectar a utilizada para determinar a conexo do E3 Studio a um servidor. Esta opo permite configurar em qual servidor de Domnio o E3 Studio deve se conectar, e permite tambm informar se o E3 Studio deve obter a licena do servidor onde roda o Domnio ou se deve obter a licena em um outro servidor. Para utilizar este recurso, clique no menu Arquivo - Conectar a, e a seguinte caixa de dilogo aberta:
84
E3 Studio
Janela Conectar a Opes disponveis na janela Conectar a OPO Conectar ao servidor local Conectar a um servidor na rede DESCRIO Habilita a conexo com o servidor local. Habilita a conexo com um servidor da rede. Para tanto, basta acess-lo atravs da caixa de seleo. Usa licena do servidor onde roda o Domnio. Usa a licena de outro servidor, que no o servidor que est rodando o Domnio.
Se a conexo com qualquer dos dois servidores (Domnio ou licena) cair, o E3 Studio desconectado do outro servidor. A ltima configurao guardada no Registro do Windows e, da prxima vez em que o E3 Studio for aberto, ele se conectar aos servidores de Domnio e de licena utilizados da ltima vez. Se o servidor de licena no estiver disponvel, ou se no houver mais licenas disponveis, ento o E3 Studio ficar em modo Demo. Um E3 Studio sem licena (modo Demo) s poder se conectar a um servidor de Domnio que tambm esteja em modo Demo. Se o servidor de licena for diferente do servidor de Domnio, o nome do servidor de licena mostrado no ttulo da janela do E3 Studio: (licena no servidor local) ou (licena em <Nome_Servidor>). Se for especificado um servidor de licena, a janela de licenas do E3 Server no servidor de Domnio mostra o nome do servidor que est emprestando a licena para o E3 Studio: SERVIDOR1 (licena emprestada de SERVIDOR2). Neste caso a licena que est listada no servidor de Domnio no entra na contagem de licenas de E3 Studio em uso naquele servidor.
E3 Studio
85
Se o servidor de Domnio no possuir uma licena, e um E3 Studio se conectar a este servidor usando a licena de outro, ento o servidor de Domnio passar temporariamente de modo Demo para modo Studio, voltando para modo Demo assim que a sesso de Studio for fechada.
NOTA : Quando o E3 Studio estiver utilizando uma licena emprestada de outro servidor, ele deve forosamente permanecer aberto enquanto o aplicativo estiver em execuo. Se ele for fechado enquanto o aplicativo estiver rodando, a licena de E3 Studio emprestada (que permite a execuo do aplicativo por seis horas) ser liberada, e o E3 Server finalizar a execuo do aplicativo imediatamente (em no mximo 10 segundos).
DICA : Quando o usurio conectar a um servidor, importante que os aplicativos sejam abertos atravs de um caminho na rede. Ao invs de usar C:\projetos\projeto.dom, utilize o caminho \\server\projetos\projetos.dom. Desta forma, o E3 Studio e o E3 Server remoto podero acessar os arquivos utilizando o mesmo caminho.
86
E3 Studio
CAPTULO
Domnios
Um Domnio um conjunto de objetos e configuraes que definem um sistema de superviso. Corresponde ao que se chamava de Aplicativo no Elipse SCADA. O E3 um ambiente modular de desenvolvimento e execuo de sistemas de superviso, composto pelos mdulos descritos nas sees a seguir.
3.1 E3 Server
O E3 Server o coordenador de todos os mdulos do E3. Ele sempre roda como servio, mesmo no modo Demo, seja ele registrado como servio ou com /regserver, e deve estar sempre rodando. Pode tambm ser iniciado quando um E3 Studio local for iniciado, ou atravs de um atalho para rodar o Domnio (por exemplo, e3admin start app.dom). Ele responsvel por: Verificar e gerenciar licenas de uso dos diferentes mdulos do E3 Iniciar, parar ou monitorar o processo de runtime (E3Run) do Domnio Abrir, editar ou manipular arquivos DOM Controlar o acesso de usurios aos objetos do Domnio Monitorar outros servidores do Domnio e implementar o Hot-Standby
O E3 Server pode trabalhar com apenas um arquivo de Domnio por vez, e este chamado de Domnio aberto. Os arquivos de Domnio s so manipulados pelo E3 Server.
3.1.1 Licenciamento
O E3 Server suporta dois modos de licenciamento: Licena Ativa e Demo. O modo de licenciamento definido na inicializao do servidor. Se h um dispositivo de proteo vlido (do tipo hardkey ou softkey), o E3 Server entra em modo Licena Ativa. Se nenhum dispositivo for localizado, entra em modo Demo. Se houver a troca do dispositivo, o E3 Server ir comparar as licenas deste novo dispositivo com as licenas do dispositivo anterior, e far os seguintes ajustes: Se as novas licenas forem exatamente iguais em limitaes s do dispositivo anterior, sero aplicadas imediatamente Domnios 87
Se as novas licenas forem menos limitadas do que as do dispositivo anterior, tambm sero aplicadas imediatamente Se as novas licenas forem mais limitadas do que as do dispositivo anterior, o E3 Server aguardar por um minuto para que o dispositivo anterior seja reconectado. Ao final deste perodo, se as licenas continuarem restritivas, o servidor ser reiniciado e as novas licenas sero aplicadas
NOTA : Para maiores informaes sobre licenciamento no E3, entre em contato com o setor comercial da Elipse Software.
3.2 E3Run
O E3Run o processo responsvel pela execuo dos objetos do servidor: Tags, Alarmes, Banco de Dados, Histricos, etc.; ou seja, todos os objetos exceto as Telas e o objeto Viewer. A execuo do E3Run indicada no cone do E3 Admin na rea de Notificao do Windows, de acordo com a tabela a seguir: Opes disponveis para cones da rea de Notificao OPO DESCRIO Seta verde: mostrada quando o Domnio est carregado e rodando. Quadrado cinza: o Domnio est carregado, mas no rodando. Linha reta amarela (giratria): mostrada quando o Domnio est sendo iniciado ou parado. Ocorre nos casos em que o Domnio demora a comear a execuo, como um sinal de espera. Barras amarelas: mostradas quando o Domnio est em espera.
O E3Run sempre roda como servio, seja ele registrado como servio ou com o comando / regserver. Este processo usa o protocolo REC para se conectar fila de banco de dados do E3 Server.
88
Domnios
3.3 E3 Admin
O E3 Admin o mdulo responsvel por monitorar e comandar o E3 Server. simbolizado pelo cone na rea de Notificao do Windows. Este mdulo iniciado quando o usurio loga no Windows, ou quando o servio do E3 Server iniciado. O E3 Admin tambm responsvel por tratar as opes de controle do Domnio via linha de comando, das seguintes maneiras: e3admin <nome_do_dominio> [opes] ou e3admin [opes] <nome_do_dominio>. As opes de linha de comando so listadas a seguir: -start ou /start: Inicia o Domnio informado pelo usurio. O uso desta opo no obrigatrio. Mesmo se no for informada, o Domnio ser iniciado -viewer ou /viewer: Executa o Viewer para a aplicao -load: Semelhante opo -start, porm somente carrega o Domnio, sem execut-lo. No pode ser usada com a opo -viewer -stop: Para o Domnio em execuo, quando existir. Esta opo deve ser utilizada sozinha -close : Para e fecha o Domnio em execuo, quando existir. Esta opo deve ser utilizada sozinha -refresh: Fora a atualizao do Domnio sem a utilizao de um Viewer -help: Mostra uma caixa de dilogo com as opes de linha de comando para o E3 Admin, como na figura a seguir:
Caixa de dilogo com as opes de linha de comando do E3 Admin Se as opes -load, -start ou -viewer forem utilizadas, o Windows Vista pede autorizao de Administrador quando o E3 Admin no foi iniciado por um usurio Administrador do sistema (dependendo da configurao do Controle de Conta de Usurio do Windows Vista). Caso existam restries no Domnio, as opes -load, -stop, -refresh e -close pedem o login do usurio.
Domnios
89
3.4 IOServer
O IOServer o processo responsvel pela execuo dos Drivers de Comunicao. Cada Driver roda em um IOServer separado. Os IOServers so criados, mantidos e monitorados pelo processo E3Run.
3.5 E3 Studio
O E3 Studio o ambiente de desenvolvimento e configurao de aplicativos. Permite abrir e editar arquivos .prj ou .lib. O E3 Studio multi-usurio, isto , vrios E3 Studios podem modificar os mesmos arquivos ao mesmo tempo. O E3 Studio utiliza a conexo REC para se comunicar com o E3 Server.
3.6 E3 Viewer
O E3 Viewer a interface com o usurio em tempo de execuo, pois mostra as Telas em execuo e permite a operao do sistema. O E3 Viewer pode ser executado a partir de qualquer ponto da rede que tenha acesso ao E3 Server, sem a necessidade de copiar o aplicativo para os outros E3 Viewers, pois as Telas e os bitmaps so carregados conforme a necessidade, em tempo de execuo.
90
Domnios
Criando um novo Domnio A seguir, o usurio deve decidir se deseja incluir projetos ou bibliotecas abertos no novo Domnio criado.
Domnios
91
Atravs do Assistente de Aplicaes do E3, que permite a criao de um Domnio novo com um arquivo de projeto (.prj) ou uma biblioteca (.lib), conforme a prxima seo
Uma vez que o Assistente tenha sido acessado, a tela inicial aberta. Para continuar, clique em Avanar.
92
Domnios
NOTA : as telas Driver de Comunicao, Banco de Dados e Alarmes s sero mostradas na criao de uma Aplicao padro.
Uma Biblioteca de componentes do E3 um arquivo utilizado para guardar diversos componentes que podem ser utilizados em aplicaes. Uma Aplicao em branco um projeto criado sem nenhum objeto. No item Nome da aplicao, especifique o nome do arquivo .prj ou .lib que est sendo criado (de acordo com o que foi escolhido na opo anterior). O local onde a aplicao ser salva especificado no item Salvar a aplicao na pasta. Caso seja necessrio, utilize o boto Procurar.
Tela Tipo de Aplicao Caso a pasta informada no exista, o usurio avisado, e deve decidir se deseja cri-la.
NOTA : a opo Biblioteca de componentes do E3 ser discutida mais adiante, no captulo Bibliotecas.
3.8.1.2 Domnio
Nesta tela, possvel decidir a qual Domnio pertencer o projeto ou a biblioteca que est sendo criado. A habilitao da opo Adicionar no Domnio ativo condicionada existncia de Domnios ativos no sistema; clicando nesta opo, o novo projeto far parte do Domnio atual. A opo Criar um novo Domnio cria um novo Domnio, ao qual o projeto ou biblioteca pertencer. O nome deste novo Domnio indicado na opo Entre com o nome do Domnio. Por fim, com a opo No adicionar em nenhum Domnio, o projeto ou biblioteca criado continuar sem pertencer a nenhum Domnio.
94
Domnios
Domnios
95
96
Domnios
Domnios
97
3.8.1.6 Alarmes
Nesta tela, o usurio pode decidir pela incluso de um objeto Servidor de Alarmes e de um objeto Configurao de Alarmes no projeto sendo criado. A opo Desejo guardar os dados dos alarmes em disco habilita o armazenamento de informaes relativas a alarmes em disco, desde que um objeto Banco de Dados tenha sido inserido no projeto.
Tela Alarmes Clique no boto Avanar para finalizar a criao da aplicao. Aps, o sistema mostra a tela final do Assistente, com uma mensagem que indica o final do processo de criao da aplicao.
98
Domnios
Domnios
99
NOTA : O menu Domnio - Opes no est disponvel no modo Demo, e as opes de Executar e Parar no esto disponveis se o Domnio estiver em modo Hot-Standby ou for aberto em um computador que no faz parte do Domnio.
3.9.1 Opes
Na aba Opes possvel habilitar a redundncia de servidores.
Aba Opes As opes disponveis so as seguintes: Opes disponveis na aba Opes OPO Hot-Standby DESCRIO Aciona o modo Hot-Standby. Se a opo for desabilitada, o Domnio executado no servidor em que foi carregado, sem suporte a Hot-Standby. Se a opo for habilitada, possvel selecionar um servidor principal onde o Domnio ser executado e, opcionalmente, um servidor em espera.
100
Domnios
DESCRIO Seleciona o nome do servidor principal para execuo do Domnio. Para cadastrar e configurar os servidores, utilize a aba Servidores. Se habilitado, seleciona um servidor de backup para execuo do Domnio. Este servidor fica em espera, com o aplicativo carregado no E3Run pronto para ser executado caso o servidor principal falhe, ou caso o servidor de backup seja ativado manualmente. O algoritmo de Hot-Standby exige que seja declarada uma terceira entidade de rede (as outras duas so os servidores principal e o backup ) para determinar se a rede est funcionando. Se no for possvel acessar o endereo de integridade nem o servidor de backup , o servidor principal assume que a sua interface de rede est com problemas e termina imediatamente a execuo do Domnio. Este campo permite que vrios endereos de rede sejam registrados. As opes para este campo so as seguintes: Os separadores permitidos para cada um dos endereos so o espao, a vrgula, o ponto e vrgula, a tabulao e a quebra de linha Se pelo menos um dos endereos fornecidos neste campo retornar sucesso, a rede ser considerada sem falhas Os nomes de servidores no so sensveis caixa Nomes repetidos so descartados Espaos em branco antes ou depois do endereo so removidos
Servidor de backup
Habilita a troca automtica de servidores quando uma falha local reportada no servidor principal. Falhas locais so detectadas e reportadas pelo prprio aplicativo atravs do mtodo Application. ReportFailure . A troca de servidores s feita se o servidor de backup estiver sem falhas. 101
Domnios
DESCRIO Permite indicar o tempo de ativao para o servidor de backup . O valor padro 15 segundos. Este tempo afeta diretamente o timeout do ping entre os servidores. Se for muito abaixo (troca em 1 segundo, timeout de ping em 160 ms), podem ocorrer trocas espontneas de servidor, causadas por pequenas falhas de rede. Apresenta os seguintes perfis de prativao disponveis: Mnimo: Ativa apenas os servios bsicos Mximo: Faz com que o E3 ative o mximo de objetos quando est em espera (Associaes, Drivers, scripts e Banco de Dados) Definido pelo usurio: O usurio pode definir quais os servios deseja ativar. Cada uma das opes pode ser habilitada ou desabilitada individualmente
102
Domnios
DESCRIO Permite ao usurio escolher os servios que deseja ativar (desde que a opo anterior tenha sido habilitada como Definido pelo usurio): Associaes (Links): O valor padro desabilitado. Se habilitado, faz com que Associaes e propriedades do tipo Link de XObjects sejam avaliadas durante a ativao em espera I/O Drivers (sem comunicao): O valor padro desabilitado. Se habilitado, os IOServers sero criados durante a ativao em espera. NOTA : Esta opo importante em aplicativos com vrios Drivers de Comunicao Scripts: O valor padro desabilitado. Se habilitado, faz com que todos os scripts de eventos de objetos e de bibliotecas sejam compilados e ativados durante a ativao em espera Banco de Dados: O valor padro habilitado. Isto significa que o Banco de Dados ser conectado durante a ativao em espera. Se desabilitado, ele apenas evita que a conexo com o Banco de Dados seja criada durante a ativao em espera Esta opo habilitada automaticamente quando o valor da propriedade EnableSynchronization for igual a True.
NOTA : Quando o Domnio colocado em execuo, o E3 Server sempre escolhe o servidor ativo por ordem alfabtica, independente de estar selecionado como principal ou backup . Este critrio de desempate utilizado sempre que mais de um servidor se candidata a executar o Domnio. Para maiores informaes, veja o captulo Hot-Standby.
Quando o Hot-Standby estiver ligado, os seguintes procedimentos so necessrios: Definir um diretrio compartilhado na rede para conter a cpia principal dos arquivos do Domnio. Este diretrio deve residir em um computador que no faa parte do Domnio E3 Criar em cada servidor do E3 um diretrio onde ser mantida uma cpia atualizada dos Domnios 103
arquivos do Domnio. O E3Run ir utilizar esta cpia local dos arquivos PRJ e LIB Abrir sempre o arquivo DOM da rede, utilizando o caminho de rede (por exemplo, \ \server\folder\Domnio.dom) Quando utilizar o E3 Studio, sempre editar os projetos e bibliotecas da cpia principal (na rede). Para aplicar as alteraes, copie os projetos e bibliotecas alterados para o diretrio local dos servidores do Domnio. Aps a cpia, clique no boto Executar Aplicativo do E3 Studio para que as alteraes sejam aplicadas no processo de tempo de execuo (E3Run)
NOTA : A REDUNDNCIA NO EST DISPONVEL EM MODO DEMO. Quando o modo Hot-Standby estiver ligado, necessrio que todos os servidores tenham uma cpia dos arquivos do Domnio (.dom, .prj e .lib) e a mesma rvore de diretrios.
3.9.2 Segurana
Atravs da aba Segurana, possvel determinar as configuraes de segurana do Domnio. Esta opo utilizada como padro, caso no seja habilitada nenhuma das opes de permisso de segurana nos usurios do projeto. Para acessar tal item, clique com o boto direito do mouse no cone do E3 Admin na rea de Notificaes do Windows, selecione a opo Domnio - Opes e acesse a aba Segurana. A seguinte janela ser mostrada:
104
Domnios
Aba Segurana As opes disponveis so as seguintes: Opes disponveis na aba Segurana OPO O usurio no pode alterar a sua senha DESCRIO Impede que o usurio troque a senha em tempo de execuo. Determina o prazo de validade da senha do usurio. Antes de terminar o prazo de validade da senha, o sistema avisa quantos dias restam para expirar. Aps a senha expirar, o usurio fica desabilitado. Determina a quantidade mnima de caracteres para a senha do usurio. Determina que a senha do usurio deve conter letras e nmeros. Determina a quantidade mnima de nmeros na senha. 105
Domnios
DESCRIO Determina a quantidade mnima de letras na senha. Determina que a senha do usurio deve conter letras maisculas e minsculas. Determina a quantidade mxima de falhas de login para que a conta do usurio seja bloqueada.
A senha deve conter letras maisculas e minsculas Bloquear a conta do usurio aps ... falhas de login
Desbloquear o usurio automaticamente aps Desbloqueia a conta do usurio depois de ... minutos determinados minutos. Avisar o usurio nos ltimos ... dias antes da senha expirar Determina a data em que o sistema comea a enviar mensagens dirias ao usurio, avisando-o sobre a data de expirao de sua senha. Aps esta data, se o usurio no trocar sua senha, ele ser bloqueado e somente o administrador poder desbloque-lo. Permite que as senhas sejam validadas sem diferenciar maisculas de minsculas. Esta opo no recomendada.
Bloqueio de Senha A conta de um usurio pode ser bloqueada nas seguintes condies: Se a senha expirar (o tempo de expirao pode ser atributo global, de grupo ou de usurio) Se o usurio digitar a senha errada um determinado nmero de vezes seguidas, isto , falhas de login
Uma vez bloqueada, a conta no permite login . Esta condio persiste at que um administrador desbloqueie a senha manualmente, ou ento o timeout de bloqueio expire.
Aba Grupos de Viewers As opes disponveis so: Opes disponveis na aba Grupos de Viewers OPO Nome DESCRIO Lista os nomes de todos os grupos de Viewers. Adiciona ou remove grupos de Viewers. Habilita a criao ou alterao de nomes de grupos de Viewers.
Domnios
107
DESCRIO Especifica quais IPs pertencero ao grupo, e desse modo compartilharo os mesmos limites de conexo. Quando um Viewer tenta se conectar ao E3 Server, seu IP ser comparado aos grupos existentes. Aps determinado o grupo ao qual pertence, ser aplicada a restrio de licenas a este Viewer, configurada para aquele grupo. Adiciona, edita ou remove os nmeros de IP. Quando um grupo criado, ele no tem nenhum IP especificado (exceto o primeiro grupo, que sempre *.*.*.* , e no pode ser criado pelo usurio). Caso o usurio tente salvar a configurao e algum grupo tenha uma lista de IPs vazia, o sistema emite um aviso. Caso o grupo seja mantido assim, ele no ter utilidade. Quando selecionada, permite conexes de Viewer Full para o grupo. Quando selecionada, limita o uso de licenas de Viewer Full simultneas a um determinado nmero. Se a opo anterior estiver marcada, mas esta estiver desmarcada, o uso de licenas simultneas ilimitado. Quando selecionada, permite conexes de Viewer Only para o grupo. Quando selecionado, limita o uso de licenas de Viewer Only simultneas a um determinado nmero. Se a opo anterior estiver marcada, mas esta estiver desmarcada, o uso de licenas simultneas ilimitado.
importante notar que estes limites so aplicados aps o limite do E3 Server, como configurado no dispositivo de proteo. Por exemplo, se o dispositivo de proteo possuir dez licenas de Viewer e o grupo especificar cinco conexes no mximo, apenas estas cinco sero usadas. No entanto, se o dispositivo de proteo possuir cinco licenas de Viewer e o grupo especificar dez conexes no mximo, ser utilizado o limite de cinco conexes do dispositivo. Ou seja, o grupo de Viewer ter sempre uma limitao de licenas adicional a ser aplicada na conexo do Viewer. A configurao de Grupos de Viewers deve ser feita preferencialmente com o Domnio parado. Caso seja feita com o Domnio em execuo, ela no ter efeito at que todos os Viewers sejam desconectados. 108 Domnios
Eventos Manuais so eventos definidos pelo aplicativo. Estes eventos so gerados em scripts de usurio, atravs da chamada do mtodo Application.TrackEvent. Estes eventos podem ser gerados tanto no Viewer quanto no Servidor (E3Run). O Viewer apenas um gerador de eventos manuais. Basta chamar o mtodo Application. TrackEvent, e o evento ser enviado para o E3 Server. O diagrama a seguir mostra como os diferentes processos do E3 geram e tratam os eventos do sistema:
Domnios
109
Diagrama de processos do E3 Cada E3 Server mantm uma lista interna dos eventos que devem ser registrados no Banco de Dados. Estes eventos podem vir de trs fontes: Eventos gerados nos Viewers (usando o mtodo Application.TrackEvent) Eventos gerados internamente no E3 Server Eventos gerados no E3 Server Standby
O E3 Server Standby, de tempos em tempos, envia a lista de eventos para o E3 Server Hot, pois apenas este tem condies de gravar eventos no Banco de Dados. Os eventos so colocados na fila de eventos do Hot, juntamente com os demais eventos do sistema, isto , o servidor Hot centraliza a gravao de eventos. Se houver uma troca de servidor, os eventos que no haviam sido gravados so passados automaticamente para o novo servidor Hot. O E3Run grava no Banco de Dados os registros enviados pelo E3 Server Hot. O E3 Server informa o nome do Servidor de Dados e da tabela onde os dados sero gravados. Para configurar o registro de eventos do E3, clique com o boto direito do mouse no cone do E3 Admin na rea de Notificao do Windows, selecione a opo Domnio - Opes, e acesse a aba Registro de Eventos. A seguinte janela ser mostrada:
110
Domnios
Aba Registro de Eventos As opes disponveis deste item so as seguintes: Opes disponveis na aba Registro de Eventos OPO Registrar os eventos do sistema em uma tabela no Banco de Dados do aplicativo Selecionar automaticamente um Banco de Dados no aplicativo DESCRIO Habilita o registro de eventos no E3. Habilite esta opo para deixar que o E3Run escolha um objeto Servidor de Dados para gravar os dados. Se o aplicativo possui apenas um Servidor de Dados, este objeto ser usado. Se tiver mais de um, recomendado marcar a opo Usar este Banco de Dados. Habilite esta opo para especificar o Servidor de Dados onde sero gravados os eventos. Se o nome do Servidor de Dados foi informado incorretamente, os eventos ficaro armazenados na fila de eventos do E3 Server (em memria), at que seja indicado um Servidor de Dados vlido. 111
Domnios
DESCRIO Indique o nome da tabela onde sero gravados os eventos. A tabela informada ser criada automaticamente pelo E3Run, e ter os seguintes campos: E3TimeStamp (Data/Hora): O campo E3TimeStamp configurado pelo E3Run e contm a data e hora em que o E3Run conseguiu enviar o evento para o Banco de Dados EventTime (Data/Hora): O campo EventTime a data e hora em que realmente ocorreu o evento, a data e hora atual do servidor (Hot ou Standby) quando o evento foi criado, ou ento o parmetro dtTimeStamp especificado para o mtodo Application.TrackEvent EventMessage (String): mensagem do evento (mximo de 200 caracteres) EventComment (String): comentrio sobre o evento (mximo de 200 caracteres)
Se o E3Run tiver que escolher entre vrios Servidores de Dados, normalmente ser utilizado o primeiro Banco de Dados ativado na execuo do Domnio. Se durante a execuo do Domnio, o usurio desabilitar o projeto que contm o Servidor de Dados que estava sendo usado para gravar os eventos, o E3Run automaticamente escolher outro Servidor de Dados que esteja disponvel no aplicativo, e continuar com este Servidor de Dados at que outro Servidor de Dados anterior seja reativado. Isto implica que, se houver mais de um Servidor de Dados no projeto, possvel que alguns eventos sejam gravados em um Servidor de Dados e outros eventos em outro Servidor de Dados (por isto, recomendado indicar um Servidor de Dados especfico, quando houver mais de um Servidor de Dados no projeto). Quando um evento selecionado na lista e a tecla F2 pressionada, abre-se uma caixa de dilogo para edio do evento. A seguinte janela mostrada:
112
Domnios
Edio de eventos Desmarque a opo Usar mensagem padro para alterar a mensagem do evento. Clique no boto para inserir uma macro dentro da mensagem. Apenas as macros permitidas para o evento sero mostradas.
Visualizao da macro disponvel para o evento As macros sempre tem o formato %MACRO%. As seguintes macros podem ser usadas: %%: Insere um sinal de % na mensagem %USER%: Insere o nome do usurio que gerou o evento (ou "Annimo", se no houver nenhum usurio logado) %MACHINE%: Insere o nome do computador onde o evento foi gerado Domnios 113
%SESSION%: Insere o nome do programa onde o usurio estava logado (Viewer, E3 Studio ou E3 Server) %CAUSE%: Informao adicional sobre o evento
Se o usurio Admin escrever uma senha errada enquanto fizer login no Viewer que est rodando na mquina CLIENT004, ser gerado o seguinte evento:
"Falhou login do usurio Admin no computador CLIENT004 (usando um Viewer): login ou senha incorretos"
114
Domnios
Domnios
115
116
Domnios
Domnios
117
3.9.5 Projetos
possvel adicionar, remover ou editar os projetos (arquivos .prj) de um Domnio. Para acessar este item, clique com o boto direito do mouse no cone do E3 Admin na rea de Notificaes do Windows, selecione a opo Domnio - Opes e acesse a aba Projetos. A seguinte janela ser mostrada:
Aba Projetos As opes disponveis deste item so as seguintes: Opes disponveis na aba Projetos OPO Nome DESCRIO Esta opo lista os nomes dos projetos no sistema.
118
Domnios
DESCRIO Atravs destas opes, pode-se remover ou adicionar projetos no sistema. Para adicionar um projeto, basta clicar no boto Adicionar e especificar o campo Nome do projeto. Para remover um projeto, basta selecion-lo e clicar no boto Remover. O arquivo PRJ no apagado do disco, apenas removido da lista de projetos do Domnio. Digite o nome do arquivo do projeto, que deve ser um caminho relativo ao diretrio do Domnio (o diretrio que contm o arquivo . dom). Exemplos: Telas.prj, Hidro\Estacao1. prj Esta opo permite desabilitar a execuo do projeto, evitando a ocorrncia de erros quando o Domnio executado. Quando a opo habilitada, o cone indica que o projeto no ser utilizado. Os projetos com o cone esto habilitados e sero executados.
Nome do projeto
3.9.6 Servidores
possvel adicionar, remover ou editar os servidores de um Domnio. Use a lista da esquerda para selecionar um ou mais servidores a alterar. A lista indica tambm se o servidor est habilitado ( ), em modo Manuteno ou desabilitado ( ). Para acessar este item, clique com o boto direito do mouse no cone do E3 Admin na rea de Notificaes do Windows, selecione a opo Domnio - Opes e acesse a aba Servidores. A seguinte janela ser mostrada:
Domnios
119
Aba Servidores As opes disponveis neste item so as seguintes: Opes disponveis na aba Servidores OPO Nome DESCRIO Lista com os nomes dos servidores no sistema. Atravs destas opes, pode-se remover ou adicionar servidores no sistema. Para adicionar um servidor em rede, basta clicar no boto Adicionar e especificar os campos Nome do servidor e Identificao do servidor na rede ; para adicionar um servidor local, basta especificar o item Caminho local de acesso aos arquivos de Domnio. Para remover um projeto, basta selecion-lo na lista e clicar no boto Remover. Determina o nome do servidor. Este nome definido pelo usurio.
Adicionar e Remover
Nome do servidor
120
Domnios
DESCRIO Digite o nome do servidor na rede. Deve ser o nome da mquina com ou sem as barras duplas invertidas no incio (por exemplo, \ \server ou server). Indica a pasta onde esto localizados os arquivos do Domnio (arquivos .prj, .lib, etc.) do servidor selecionado. A opo No especificar (utilizar a pasta do arquivo .DOM) o padro, e indica que os arquivos esto na mesma pasta do arquivo de Domnio (.dom). Caso seja selecionada a opo Utilizar a seguinte pasta local, o caminho digitado no campo especfico deve conter apenas a pasta, sem o nome nem a extenso do arquivo de Domnio (.dom). Esta opo permite desabilitar o servidor e no utiliz-lo na execuo do Domnio. Quando a opo habilitada, o cone indica que o servidor no ser utilizado. Do contrrio, o cone indica que o servidor poder ser utilizado.
Domnios
121
Aba Domnios Remotos As opes disponveis deste item so as seguintes: Opes disponveis na aba Domnios Remotos OPO Nome DESCRIO Esta opo lista os nomes dos Domnios Remotos no sistema.
122
Domnios
DESCRIO Atravs destas opes, pode-se remover ou adicionar Domnios Remotos no sistema. Para adicionar um Domnio Remoto em rede, basta clicar no boto Adicionar e especificar os campos Nome e Arquivo de Domnio. Para remover um Domnio, basta selecion-lo na lista e clicar no boto Remover. Determina o nome do Domnio Remoto. Este nome definido pelo usurio. Determina o nome ou o caminho na rede onde est o arquivo .dom do Domnio Remoto. Identifica o servidor principal na rede. Quando habilitado, identifica o servidor de backup na rede. Permite reconhecer um usurio com senha para cada Domnio Remoto. As opes disponveis so: No especificar (annimo), e Utilizar a seguinte conta. Ao selecionar a segunda opo, os dois campos a seguir so habilitados. Identifica o usurio. Permite a conexo ao Domnio atravs de senha.
Nome do Domnio
Arquivo de Domnio
Usurio no Domnio
Usurio Senha
possvel que uma configurao de Domnio Remoto possibilite a conexo ao prprio Domnio local. A isso se d o nome de Alias local ou conexo Loopback. Este alias criado segundo a configurao normal de Domnios Remotos. Basta que o nome dos servidores (principal ou backup ) seja localhost* ou o mesmo da mquina onde o Domnio est rodando para que tudo funcione localmente. Neste caso, para que a configurao funcione no Studio, no campo Arquivo de Domnio, basta colocar diretamente o caminho local do arquivo DOM (por exemplo, c:\caminho\arquivo.dom).
Domnios
123
NOTAS: A mudana dos aliases locais com o Domnio rodando NO suportada. O que acontecer que, se o Domnio estiver rodando, Links j resolvidos como locais continuaro sempre locais, mesmo que o alias seja reconfigurado para conectar numa mquina remota realmente. Para contornar isso, basta reiniciar o Domnio As conexes do tipo loopback no aparecero na janela Licenas (ou Estatsticas) do E3 Admin e nem iro necessitar de licena de Domnios Remotos para funcionar * Para que o nome localhost funcione, necessrio que ele esteja configurado para apontar para o IP 127.0.0.1 (que a configurao padro do Windows) Para maiores informaes sobre as configuraes da aba Domnios Remotos, veja o item Configurao da Conexo
3.10.1 Atalhos
Esta opo permite executar aplicativos presentes na instalao do E3 diretamente pelo menu contextual do cone do E3 Admin, na rea de Notificao do Windows. Os seguintes aplicativos podem ser executados: Log Viewer E3 Studio E3 Tweak E3 Viewer
O item Log Viewer abre o aplicativo Elipse Event Log Viewer j com o arquivo correspondente sesso ativa de logs do E3. Para maiores informaes sobre este aplicativo, consulte o Manual do Usurio do Elipse Event Log, disponvel no menu Iniciar - Programas - Elipse Software Elipse Event Log. Se j h um Domnio rodando localmente, o item E3 Viewer deste menu abre um Viewer para o Domnio local. Do contrrio, ou se a tecla SHIFT estiver pressionada, abre-se a janela inicial do Viewer, onde possvel escolher o servidor e outras opes, como descrito no tpico E3 Viewer e E3 WebViewer - Execuo do E3 Viewer - Execuo Atrves do Menu Iniciar.
124
Domnios
3.10.2 Licenas
possvel visualizar as diversas licenas disponveis atravs do E3 Admin. Para acessar este item, clique com o boto direito do mouse no cone do E3 Admin na rea de Notificaes do Windows e selecione a opo Licenas. A seguinte janela ser mostrada:
Licenas As opes disponveis deste item so as seguintes: Opes disponveis na janela Licena OPO Nmero da licena DESCRIO Informa o nmero da licena (dispositivo de proteo): um nmero hexadecimal de oito dgitos com prefixo "HL", se o dispositivo for uma hardkey; ou um nmero hexadecimal de dezesseis dgitos com prefixo "SL", se o dispositivo for uma softkey. Se o dispositivo de proteo no foi detectado, o nmero ser preenchido com zeros. Indica o tipo de E3 Server.
E3 Server
Domnios
125
OPO E3 Studio
DESCRIO Indica o nmero de licenas disponveis e em uso do E3 Studio. Indica o nmero de licenas disponveis e em uso do E3 Viewer. Indica o nmero de licenas disponveis e em uso do E3 Viewer no modo Somente Leitura. Indica o nmero de licenas disponveis e em uso do Domnio Remoto (Servidor). Indica o nmero de licenas disponveis e em uso do Domnio Remoto (Cliente). Indica o nmero de pontos de comunicao. Indica o nmero de Tags do Storage. Indica o nmero de Drivers disponveis e em uso. Indica o nmero de licenas disponveis e em uso do Servidor OPC. Indica o tempo mximo permitido de execuo de um aplicativo.
E3 Viewer
E3 Viewer Only
Servidor OPC
Para maiores informaes sobre as limitaes do modo Demo do E3, veja o tpico Limitaes do Modo Demonstrao.
126
Domnios
3.10.3 Estatsticas
A janela Estatsticas de Comunicao mostra os dados em tempo real sobre o trfego de informaes na rede. A lista atualizada automaticamente a cada segundo. Para acessar tal item, clique com o boto direito do mouse no cone do E3 Admin na rea de Notificaes do Windows e selecione a opo Estatsticas.
Estatsticas de Comunicao As opes disponveis deste item so as seguintes: Opes disponveis na janela Estatsticas de Comunicao OPO Computador DESCRIO Mostra o nome da mquina conectada ao E3 Server. Veja a tabela a seguir para uma descrio dos cones que representam as conexes de cada mquina listada nesta coluna. Mostra a quantidade de dados enviados. Mostra a percentagem de compresso no envio. Mostra a quantidade de pacotes enviados. Mostra a quantidade de dados recebidos. Mostra a percentagem de compresso no recebimento. Mostra a quantidade de pacotes recebidos. Mostra o tempo de conexo.
Os cones mostrados ao lado do nome da mquina, na coluna Computador, so descritos na Domnios 127
tabela a seguir. cones das conexes na janela de Estatsticas CONE DESCRIO Conexo de um Studio, consumindo licenas do E3 Server (locais ou remotas). Conexo de um Viewer, consumindo licenas do E3 Server (locais ou remotas). Conexo de um Viewer Only, consumindo licenas do E3 Server (locais ou remotas). Este cone pode representar trs tipos de conexes: Conexo de Hot-Standby de outro E3 Server (sempre remota) Conexo de Domnios Remotos de outro E3 Server (sempre remota) Conexo do E3 Admin (atualmente sempre local) Conexo da fila de operaes do banco de dados (arquivos .e3i e .e3o, sempre local).
128
Domnios
3.10.4 Monitor
A janela Monitor mostra informaes em tempo real sobre o estado dos servidores do Domnio. Para acessar este item, clique com o boto direito do mouse no cone do E3 Admin na rea de Notificaes do Windows e selecione a opo Monitor.
Monitor As opes disponveis deste item so as seguintes: Opes disponveis na janela Monitor OPO Domnio atual Endereos de ping DESCRIO Nome do Domnio ativo. Lista com os endereos dos servidores de ping. Nome do servidor. Endereo de rede do servidor. Mostra o estado do ping de rede com este servidor. Mostra a hora local do servidor. Mostra o estado do Domnio no servidor ( Parado ou Rodando). Mostra o estado da conexo DCOM com o servidor.
Relgio Estado
Conexo
Domnios
129
OPO Funo
DESCRIO Mostra uma lista de funes reportadas pelo servidor: Ativo: Este o servidor ativo do Domnio Reserva: Este o servidor standby do Domnio Falha(n): Servidor possui falhas locais reportadas Prioridade : O servidor requisitou prioridade para rodar o Domnio, este indicador faz com que o servidor ativo passe para o modo Standby Candidato: O servidor candidato a rodar o Domnio E/S: O servidor possui IOServers ativos
3.10.5 Inicializao
Esta opo permite controlar o Domnio a ser iniciado automaticamente. O Domnio configurado s ser executado se o E3 Server no estiver em modo Demo. Para acessar tal item, clique com o boto direito do mouse no cone do E3 Admin na rea de Notificaes do Windows e selecione a opo Inicializao. A seguinte janela ser mostrada:
E3 Server - Inicializao As opes disponveis deste item so as seguintes: Opes disponveis na janela Inicializao OPO O Domnio carregado DESCRIO Ao iniciar, executa automaticamente o Domnio previamente carregado.
130
Domnios
DESCRIO Ao iniciar, executa automaticamente o Domnio configurado pelo usurio. No inicia nenhum Domnio.
Nenhum Domnio
3.10.6 Impressora
Esta opo mostra a lista das impressoras encontradas local ou remotamente, e permite que o usurio escolha uma para ser usada pelo E3 Server. Para acessar tal item, clique com o boto direito do mouse no cone do E3 Admin na rea de Notificaes do Windows e selecione a opo Impressora. A seguinte janela ser mostrada:
E3 Server - Impressora As opes disponveis deste item so as seguintes: Opes disponveis na janela Impressora OPO Nome da impressora Padro DESCRIO Lista o nome das impressoras disponveis. Permite selecionar esta impressora como padro. Abre a janela de propriedades da impressora selecionada. Permite escolher outra impressora na rede e estabelecer uma conexo.
Configurar
Procurar
Domnios
131
132
Domnios
Domnios Remotos Neste caso, o Domnio referenciado pela configurao o Domnio Servidor. possvel tambm que os Domnios se referenciem entre si, sendo ao mesmo tempo servidores e clientes de Domnios Remotos. Para configurar o uso de um Domnio Remoto, siga estes procedimentos: 1. Informe um apelido para o Domnio Remoto no campo Nome do Domnio. Este campo no sensvel a maisculas ou minsculas. Este nome ser usado na aplicao para referenciar os objetos a serem acessados no Domnio Remoto. 2. Especifique o caminho do arquivo .dom do Domnio Remoto. Este caminho deve ser um compartilhamento na rede que permita acessar este arquivo .dom. 3. Informe o nome do servidor principal, que deve ser o servidor contendo o Domnio Remoto especificado no caminho do arquivo .dom. Esta configurao utilizada para encontrar os objetos do Domnio Remoto em tempo de execuo.
Domnios
133
O item Servidores e Opes de Conexo contm um boto Avanado, que permite realizar configuraes especficas da conexo entre os Domnios, atravs da janela mostrada na figura a seguir.
Opes avanadas de conexo As opes desta janela so descritas na tabela a seguir. Opes avanadas de conexo OPO Tempo limite de conexo (ms) DESCRIO Esta opo controla o tempo mximo que o Domnio Remoto Cliente espera para estabelecer uma conexo REC com o E3 Server do Domnio Servidor. Sua finalidade a mesma da chave ConnectionTimeout, configurvel pelo E3 Tweak. O valor padro desta opo 2000 ms. Esta opo permite que, atravs de um pedido de echo do protocolo ICMP, o Domnio Remoto verifique se o Servidor responde dentro de um tempo limite (timeout). Se no houver resposta, por qualquer motivo, considera-se que o computador est fora da rede, ou desligado. Essa verificao, se habilitada, ocorre antes da conexo (evitando a tentativa de conectar em um computador indisponvel) e enquanto a conexo estiver ativa (forando a desconexo imediata). O valor, em milissegundos, para a verificao do ping. O valor padro desta opo 2000 ms.
Verificar PING
134
Domnios
DESCRIO Esta opo permite que, atravs de um mecanismo do protocolo REC, o Domnio Remoto Cliente verifique se o Servidor est mantendo a conexo ativa, esperando que sejam enviadas mensagens de heartbeat peridicas, mesmo que no haja nenhuma outra comunicao a ser feita. Se for excedido o dobro do tempo de heartbeat configurado, sem que o Cliente receba uma mensagem qualquer do computador Servidor, considera-se que o Servidor falhou ou est fora da rede, sendo forada uma desconexo imediata. O valor, em milissegundos, do perodo de heartbeat. O valor padro desta opo 2000 ms. Se esta opo for marcada, os Links so criados em paralelo entre os diversos Domnios e o resultado da operao vem assincronamente, medida que cada Servidor responder. A vantagem desta opo no trancar o tratamento de Links geral do E3 Server. Apenas operaes daquele mesmo Domnio podem ficar trancadas, caso a criao de Links demore muito (o que pode ocorrer em redes lentas). NOTA : Esta opo no est disponvel para verses anteriores 3.2, e as aplicaces desenvolvidas em verses anteriores falharo com o cdigo de erro 8004F108 (verso incompatvel do REC). O valor padro desta opo desmarcada, que corresponde ao comportamento das verses anteriores verso 3.2.
NOTA : Desmarcar simultaneamente as opes Verificar PING e Utilizar heartbeat na conexo torna a deteco de queda da conexo extremamente lenta, caso o Servidor falhe. Recomenda-se que as duas opes estejam sempre marcadas.
No E3 Studio, o caminho completo do compartilhamento usado para que seja possvel determinar os objetos existentes no Domnio Remoto. O nome do arquivo .dom (sem o caminho) usado para verificar se a conexo remota est sendo feita com o Domnio correto, em tempo de execuo. Assim, se o nome do Domnio carregado no E3 Server remoto no for o correto, a conexo no ser completada e os objetos remotos no ficaro acessveis. Outra possibilidade manter uma cpia do Domnio Remoto na mquina Cliente, e colocar o Domnios 135
caminho da cpia no campo Arquivo de Domnio. Dessa forma, o E3 Studio vai utilizar a cpia local para determinar quais objetos existem, permitindo o trabalho offline. A cpia deve obrigatoriamente ter o mesmo nome do Domnio Remoto para que a conexo funcione, no sendo necessrio possuir a mesma hierarquia de diretrios. Alm disso, para que a conexo entre os Domnios possa ocorrer, todos os E3 Servers envolvidos devero rodar a mesma verso do E3. No possvel, por exemplo, conectar-se a um Domnio que esteja rodando a verso 2.5 do E3. Para que um E3 Server aceite receber conexes de outros Domnios (isto , para que ele seja um servidor de Domnios Remotos), no necessria nenhuma configurao especfica. Aps a correta configurao destes itens, necessrio apenas rodar os E3 Servers para que as conexes remotas sejam estabelecidas.
NOTA : Para maiores informaes sobre a configurao de Domnios Remotos, veja o item Configuraes de Domnio - Domnios Remotos.
3.11.2 Licenas
Tanto o E3 Server rodando o Domnio Cliente, quanto o que roda o Domnio Servidor, devem ter licenas especficas para Domnios Remotos. Quando essa licena existe, o E3 Server Servidor passa a aceitar um nmero ilimitado de conexes externas de outros Domnios. Da mesma forma, no caso do E3 Server Cliente, ser possvel estabelecer um nmero ilimitado de conexes. Para maiores informaes sobre as limitaes do modo Demo do E3, veja o tpico Limitaes do Modo Demonstrao.
Comea com um caractere que no seja uma letra (sem acentos nem "") Possui um caractere qualquer que no seja uma letra (sem acentos nem ""), um algarismo (0-9) ou o caractere de sublinhado
Permisses de usurio Com isso, pode ser necessrio que a conexo com o Domnio Remoto especifique um determinado usurio para poder ter acesso completo aos objetos do Domnio. Esse usurio dever ser especificado no campo Usurio no Domnio atravs da opo Utilizar a seguinte conta, na aba Domnios Remotos da configurao do Domnio Cliente. Ali devem ser especificados o login e senha de um usurio existente no Domnio sendo acessado remotamente. Alm do acesso em modo Somente Leitura, possvel bloquear completamente o acesso Domnios 137
remoto, o que exige que a conexo com o Domnio Remoto especifique um determinado usurio para poder ganhar acesso aos objetos remotos. Isso feito atravs da permisso Acesso remoto ao Domnio, tambm do item de segurana Domnio.
NOTA : A permisso Acesso remoto ao Domnio sempre ter precedncia sobre a permisso Acesso remoto de escrita ao Domnio. Isto significa que quando a primeira permisso for negada, a segunda no ser efetivada mesmo quando explicitamente permitida. No havendo nenhuma permisso de acesso configurada, qualquer Domnio pode se conectar remotamente a outro, utilizando um usurio annimo.
3.11.5 Hot-Standby
A conexo remota ao Domnio suporta Domnios com Hot-Standby nativamente. Para isso, basta apenas especificar os nomes dos dois servidores (principal e backup ) nos itens respectivos da rea Identificao dos servidores na rede , da aba de configurao dos Domnios Remotos. importante ressaltar que, para o correto funcionamento do Hot-Standby, esses nomes devem ser os mesmos especificados pelo Domnio Remoto acessado. Uma vez que haja essa configurao em tempo de execuo, o E3 Server sempre tentar conectar-se aos dois servidores, direcionando o acesso de todos os comandos Application.GetObject e Links para o primeiro servidor que possa ser acessado e que indique estar rodando o Domnio. Caso os nomes dos servidores sejam modificados quando o Domnio Cliente estiver em execuo, este ir desconectar-se e reiniciar a conexo com os novos servidores.
3.11.7 Desconexo
O Domnio Cliente pode no conseguir estabelecer a conexo com o Domnio Servidor por uma srie de motivos. Entre eles esto: O computador do Cliente ou do Servidor est fora da rede O Servidor no est rodando o E3 Server 138 Domnios
O E3 Server do Servidor no est com o Domnio correto, ou o Domnio no foi iniciado O Domnio Servidor no aceita o usurio especificado pelo Domnio Cliente O E3 Server do Cliente ou do Servidor no possui licena de Domnio Remoto O E3 Server do Servidor de uma verso antiga (2.5 ou inferior) Existe um firewall bloqueando a porta utilizada pelo REC, ou o Cliente e o Servidor esto usando portas diferentes O apelido do Domnio no existe na configurao de Domnio Remoto
Quando uma dessas situaes ocorrer, todos os Links do Cliente referenciando o Domnio ficaro desconectados, assim como todos os comandos de Application.GetObject referenciando o Domnio Remoto iro falhar (ou seja, causaro erros de script). Quando o problema for resolvido, os Links devero conectar-se automaticamente. J os comandos de Application.GetObject devero ser re-executados.
Domnios
139
CAPTULO
Drivers
O E3 permite a comunicao com equipamentos de aquisio de dados, controladores, CLPs (Controladores Lgicos Programveis), UTRs (Unidades Terminais Remotas), ou qualquer outro tipo de equipamento, atravs de Drivers de Comunicao prprios ou Servidores OPC, de acordo com o tipo do equipamento ou tipo de comunicao necessria.
NOTA : Os objetos de Drivers (Driver de Comunicao, Pasta de Comunicao, Tag de Comunicao, Bloco de Comunicao, Elemento de Bloco, Driver de Comunicao OPC, Grupo de Tags OPC, Pasta OPC, Tag de Comunicao OPC, Bloco de Comunicao OPC e Elemento de Bloco OPC) podem ser configurados para funcionarem como reas de Alarme .
140
Drivers
Inserindo um Driver de Comunicao no modo Domnio aberta a janela para localizao do Driver:
Localizar Driver Se for selecionado um Driver vlido, o sistema exibir sua janela prpria de configurao. Logo em seguida, ser aberta a janela de importao de Tags (se disponvel). Ao inserir um Driver em uma aplicao do E3 Studio, aberta a view do objeto, conforme a
Drivers
141
figura a seguir.
View do Driver de Comunicao As opes disponveis so: Opes disponveis na view do Driver de Comunicao OPO Adicionar CONE DESCRIO Adiciona uma nova pasta, um novo Tag ou um novo Bloco de Comunicao ao Driver; um novo Tag ou um novo Bloco de Comunicao a uma Pasta; ou um novo Elemento de Comunicao a um Bloco. Remove o item selecionado na view. Abre a janela de configuraes extras do Driver. Abre uma janela que permite importar Tags diretamente do Driver. Ativa ou desativa a comunicao do Driver.
Remover
Configurar o driver
Tag Browser
Ativar/desativar comunicao
142
Drivers
CONE
Driver Para maiores informaes sobre a configurao individual de cada Driver, consulte os respectivos arquivos de ajuda que acompanham os Drivers, onde constam instrues sobre a configurao dos parmetros [P] e demais propriedades, acessveis pela janela de configurao do Driver.
possua a propriedade AllowRead em Falso, ou ainda se o Tag no possuir um valor a ser reportado, esta linha aparecer com a cor cinza. Caso o Tag apresente erro de comunicao, a linha se tornar vermelha, e caso a comunicao esteja sem problemas, a linha ter a cor azul. Para interromper o monitoramento, clique com o boto direito do mouse sobre o Driver de Comunicao novamente e escolha a opo Desativar Comunicao.
portas seriais e outras interfaces, permitem apenas uma conexo, o que impediria a utilizao simultnea por mais de um Driver. Com o compartilhamento pode-se reutilizar a mesma conexo para mais de um objeto. Deve-se ressaltar que as configuraes dos Drivers compartilhados devem ser as mesmas para que o compartilhamento de Drivers funcione corretamente. Quando o Domnio est em execuo, temos acesso interface de execuo do Driver de Comunicao denominado Gerenciador de Drivers.
Acesso ao Gerenciador de Drivers O Gerenciador de Drivers permite visualizar todos os Drivers em execuo, exibindo suas propriedades.
Gerenciador de Drivers As opes disponveis so as seguintes: Opes disponveis na janela Gerenciador de Drivers OPO Nome DESCRIO Informa o nome do Driver inserido no sistema. Informa o nome do objeto Driver de Comunicao associado ao Driver. 145
Objeto(s)
Drivers
DESCRIO Mostra o total de leituras do Driver, a quantidade de erros de leitura e percentual de erros em relao ao total de leituras. Mostra o total de escritas do Driver, a quantidade de erros de escrita e percentual de erros em relao ao total de escritas. Mostra o identificador do processo do IOServer no sistema operacional. Mostra o estado atual do Driver (configurado, iniciando, rodando, finalizando, finalizado ou em erro). Se o Driver estiver em erro, mostra uma descrio do erro. Mostra as palavras SIM ou NO, informando se o Driver est compartilhado ou no. Mostra o status do log (habilitado ou desabilitado). Informa o caminho do Driver no sistema. Habilita o log dos Drivers em tempo de execuo, sem a necessidade de reconfigurar o aplicativo. Atravs do mesmo boto podemos interromper este procedimento de gravao. Fora a atualizao dos dados exibidos.
Erros de escrita
Processo
Estado
Compartilhado
Log
Boto Atualizar
Para obter mais informaes sobre quais equipamentos possuem esta caracterstica, entre em contato com o fabricante. Para saber quais Drivers ou tipos de variveis dentro dos equipamentos utilizam a estampa de tempo, consulte a ajuda dos Drivers ou diretamente o suporte tcnico da Elipse Software.
Exemplo de lista de valores Na primeira tabela, temos uma sequncia de valores para o campo A , associada a um instante de tempo representando uma leitura SOE. Neste caso, o ideal realizar a leitura atravs de um Tag de Comunicao, que trar toda a tabela em uma nica leitura, sendo que os valores do campo A estaro no prprio Tag e o campo Time estar na propriedade TimeStamp. J na segunda tabela, temos uma representao tpica de coleta de dados de telemetria, onde para cada instante de tempo existem vrias colunas representando vrios valores coletados naquele determinado instante. Para a leitura desses valores, o ideal utilizar um Bloco de Comunicao que trar toda a tabela em uma nica leitura, sendo que os valores do campo Time estaro associados propriedade TimeStamp do Bloco; os valores do campo A estaro associados a um Elemento do Bloco, o campo B a outro Elemento, e assim por diante.
148
Drivers
Inserindo um Tag de Comunicao 2. O sistema abre uma janela perguntando quantos Tags sero criados no Driver, e qual seu nome. Este nome ser auto-incrementado; se a opo for deixada em branco, os Tags sero criados com o nome padro.
Drivers
149
Caso o equipamento sendo utilizado para coletar os dados informe valores de Tags que precisam ser convertidos, pode-se utilizar as escalas dos Tags, que so basicamente uma especificao de uma converso linear entre duas bases diferentes. Para isto, deve-se habilitar a propriedade EnableScaling do Tag e informar os parmetros DeviceLow e DeviceHigh (atravs das respectivas propriedades), que seriam os limites inferior e superior do dado vindo do equipamento, alm de informar os parmetros EULow e EUHigh (atravs das respectivas propriedades) que so os limites inferior e superior do dado, j em unidades de engenharia. Algumas das propriedades deste objeto podem ser configuradas diretamente na Lista de Propriedades, sem a necessidade de criar scripts para isto. Demais informaes sobre as funcionalidades das propriedades deste objeto podem ser encontradas no Manual de Referncia de Scripts do E3 , em seu captulo respectivo.
150
Drivers
Inserindo um Bloco de Comunicao 2. O sistema abre uma janela perguntando quantos Blocos sero criados no Driver, e qual seu nome. Este nome ser auto-incrementado; se a opo for deixada em branco, os Blocos sero criados com o nome padro.
Inserindo Blocos de Comunicao 3. O sistema mostrar uma caixa de dilogo para determinar o nmero de Elementos de Bloco neste objeto. Nesta opo possvel indicar o mapeamento de todos os Elementos de Drivers 151
Configurando o Bloco de Comunicao 4. Informe o tamanho do Bloco e a opo de mapeamento. 5. Clique em OK. 6. Caso necessite, configure as propriedades do objeto. Algumas das propriedades do Bloco de Comunicao podem ser configuradas atravs da Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes. Para maiores informaes, consulte o Manual de Referncia de Scripts do E3 .
152
Drivers
Inserindo um Elemento de Bloco Caso o equipamento sendo utilizado para coletar os dados informe valores de Elementos que precisam ser convertidos, pode-se utilizar as escalas dos Elementos, que so basicamente uma especificao de uma converso linear entre duas bases diferentes. Para isto, deve-se habilitar a propriedade EnableScaling do Elemento e informar os parmetros DeviceLow e DeviceHigh (atravs das respectivas propriedades), que seriam os limites inferior e superior do dado vindo do equipamento, alm dos parmetros EULow e EUHigh (atravs das respectivas propriedades) que so os limites inferior e superior do dado j em unidades de engenharia. Algumas das propriedades do Elemento de Bloco podem ser configuradas atravs da Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes. Para maiores informaes, consulte o Manual de Referncia de Scripts do E3 .
Drivers
153
NOTA : O Servidor OPC no E3 um mdulo adicional a partir da verso 3.0, e necessita de licena especfica no dispositivo de proteo. Entre em contato com a Elipse para maiores informaes.
4.2.1 Caractersticas
Para usar o Servidor OPC do E3 no necessria nenhuma configurao extra, bastando executar o Domnio para que qualquer cliente OPC possa se comunicar com o E3. Para conectar-se ao servidor OPC do E3 de um cliente qualquer, basta selecionar o servidor identificado como Elipse.OPCSvr.1 . O Servidor OPC permite que qualquer cliente importe facilmente toda a definio de Tags existentes no Domnio (funo Browse ). Naturalmente, os Tags fornecidos so apenas os objetos que fazem parte do servidor, ou seja, itens de Tela (Viewer) no so acessveis pelo Servidor OPC. Sendo baseado na mesma tecnologia de associaes usada nas associaes internas entre objetos, o Servidor OPC do E3 permite que clientes usem Tags que sejam expresses matemticas, e com o recurso de conexo e desconexo transparente durante a execuo.
4.2.3 Desconexo
Para os clientes OPC que suportam o mecanismo de desligamento (shutdown ), sempre enviado um aviso quando o Domnio parado ou entra em standby. Aps o aviso, todos os clientes so desconectados.
154
Drivers
Inserindo um Driver OPC Ao inserir um Driver OPC em uma aplicao do E3 Studio, aberta a view do objeto, conforme a figura a seguir.
Drivers
155
View do Driver de Comunicao OPC As opes disponveis so: Opes disponveis na view do Driver OPC OPO Adicionar CONE DESCRIO Adiciona um Grupo ao Driver; um Tag, um Bloco ou uma Pasta ao Grupo; ou um Elemento ao Bloco. Remove o item selecionado na view. Seleciona o Servidor OPC. Ativa e desativa a comunicao do Driver. Importa Tags para o Driver OPC. Mostra uma janela com as configuraes do Driver. Apresenta o nmero total de Tags de Comunicao no Driver.
Remover
Importar tags
Contagem de tags
156
Drivers
Configuraes do Driver OPC Informe o Endereo e ID do Servidor e clique no boto Selecionar. A seguinte janela ser mostrada:
Drivers
157
Seleo do Servidor OPC As opes disponveis neste item so as seguintes: Opes disponveis na janela Servidores OPC OPO Tentar enumerador padro ou registro (recomendado) DESCRIO O E3 ir tentar procurar as especificaes do Driver, tanto pelo Registro do Windows quanto pelo enumerador padro OPC (OPCENUM). O E3 ir tentar procurar as especificaes do Driver apenas pelo enumerador padro OPC (OPCENUM). O E3 ir tentar procurar as especificaes do Driver apenas pelos registros no Window.
Clicando em OK, o sistema mostrar os dados do Driver, indicando os caminhos e o nome do servidor. Para ativar a comunicao do Driver OPC clique na opo Ativar Comunicao:
158
Drivers
Ativar comunicao do Driver OPC Quando a comunicao ativada, so habilitadas as opes Informaes sobre o servidor e Importar tags, alm da opo Desativar Comunicao. Para acessar estas opes, basta clicar com o boto direito do mouse sobre o Driver OPC e escolher a opo desejada.
Drivers
159
Opes habilitadas quando o Driver OPC est ativo A opo Informaes sobre o servidor mostra uma janela com as configuraes do Driver.
160
Drivers
Informaes do Servidor OPC Atravs da opo Importar tags, possvel importar Tags para o Driver OPC. Quando esta opo selecionada, a seguinte mensagem mostrada:
Mensagem referente importao de Tags OPC As opes so as seguintes: SIM : O E3, ao fazer a localizao dos Tags OPC, ir tentar automaticamente detectar quais Tags so do tipo Bloco e, neste caso, qual o nmero de Elementos. Para fazer isto, o E3 precisa ler o valor de cada um, o que dependendo do servidor e do nmero de Tags, pode ser demorado NO: O E3 no ir ler os valores dos Tags OPC ao fazer a operao de procura. Essa operao mais rpida, porm no ir criar automaticamente Tags OPC de tipo Bloco e seus Elementos CANCELAR: Cancela a importao
Drivers
161
Importao de Tags OPC As opes disponveis so as seguintes: Opes disponveis na janela Importao de Tags OPC OPES Nome dos Itens DESCRIO Filtra os tags a partir do nome dos itens especificados. Podem ser utilizados caracteres curingas, tais como * ou ?. Filtra os tags a partir do tipo de dado especificado no campo. Estes dados podem ser do tipo Integer, Long, Single , etc. Filtra os tags a partir do tipo de acesso especificado no campo. Estes acessos podem ser: Leitura, Escrita ou Leitura e Escrita. Filtra os tags para que o sistema mostre apenas os itens com IDs no encontrados no projeto. Mostra os objetos que foram selecionados para adio no projeto corrente.
Tipo de dados
Tipo de acesso
Projeto corrente
162
Drivers
Para fazer a importao, basta selecionar o tag desejado e arrast-lo para o driver ou Grupo OPC desejado. Para desativar a comunicao do Driver OPC, basta clicar na opo Desativar Comunicao. Algumas das propriedades do Driver OPC podem ser configuradas atravs da Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes. Para maiores informaes, consulte o Manual de Referncia de Scripts do E3 .
Drivers
163
Inserindo um Grupo de Tags OPC Algumas das propriedades do Grupo OPC podem ser configuradas atravs da Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes. Para maiores informaes, consulte o Manual de Referncia de Scripts do E3 .
164
Drivers
Drivers
165
Inserindo um Tag de Comunicao OPC 2. O sistema abre uma janela perguntando quantos Tags sero criados no Grupo, e qual seu nome. Este nome ser auto-incrementado; se a opo for deixada em branco, os Tags sero criados com o nome padro.
Inserindo Tags de Comunicao OPC Algumas das propriedades do Tag OPC podem ser configuradas atravs da Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes. Para maiores informaes, consulte o Manual de Referncia de Scripts do E3 . 166 Drivers
Inserindo um Bloco de Comunicao OPC 2. O sistema abre uma janela perguntando quantos Blocos sero criados no Grupo, e qual seu nome. Este nome ser auto-incrementado; se a opo for deixada em branco, os Blocos sero criados com o nome padro.
Drivers
167
Inserindo Blocos de Comunicao OPC 3. O sistema mostrar uma caixa de dilogo para determinar o nmero de Elementos de Bloco neste objeto. Nesta opo possvel indicar o mapeamento de todos os Elementos de Bloco ou somente de um determinado intervalo de Elementos.
Configurando o Bloco de Comunicao 4. Informe o tamanho do Bloco e a opo de mapeamento. 5. Clique em OK. 6. Caso necessite, configure as propriedades do objeto. Algumas das propriedades do Bloco de Comunicao OPC podem ser configuradas atravs da Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes. Para maiores informaes, consulte o Manual de Referncia de Scripts do E3 .
168
Drivers
Tabela 5 ndice 0
12 1
77 2
55 3
1 4
3 5
42 6
20 7
8 8
89 9
NOTA : O E3 pode criar automaticamente os elementos de Bloco OPC. Para maiores detalhes, veja a opo Importar Tags, no tpico Configurao dos Drivers OPC.
Para utilizar este recurso, siga este procedimento: 1. Clique com o boto direito do mouse sobre o Bloco OPC e selecione a opo Inserir Elemento de Bloco OPC.
Drivers
169
Inserindo um Elemento de Bloco OPC Algumas das propriedades do Elemento de Bloco OPC podem ser configuradas atravs da Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes. Para maiores informaes, consulte o Manual de Referncia de Scripts do E3 .
4.4 Qualidade
Os campos de qualidade representam o estado da qualidade do valor do item. formado de uma palavra de 16 bits, sendo que os primeiros 8 bits so definidos na forma de 3 campos de bits: Campo Qualidade , Substatus e Limite . Os outros 8 bits (de maior ordem) esto disponveis para uso de cada fabricante. Se esses bits forem utilizados, os bits de qualidade padro ainda so utilizados para indicar quais dedues pode-se fazer sobre os dados retornados. Assim, de responsabilidade do cliente interpretar o campo de informaes especficas de qualidade, para garantir que o servidor que est provendo essa informao usa as mesmas regras que o cliente.
170
Drivers
Opes disponveis no campo Qualidade QUALIDADE 0 - 63 Ruim 64 - 127 Incerta 128 - 191 CAMPO QUALIDADE DESCRIO O valor no til pelas razes indicadas no substatus. A qualidade do valor incerta pelas razes indicadas no substatus. No usado pelo padro OPC. A qualidade do valor Boa.
(Reservado) Boa
192 - 255
Um servidor que no suporta informao de qualidade retorna 192 sempre (Bom). Tambm aceitvel que um servidor retorne simplesmente Ruim ou Bom (0 ou 192) e sempre retorne 0 para o substatus e para o limite.
Erro de Configurao
H algum 4 problema de configurao especfico no servidor. Por exemplo, o item em questo pode ter sido apagado.
Drivers
171
SUBSTATUS No Conectado
DESCRIO Sem Limite A entrada 8 deveria estar logicamente conectada a algo, mas no est. Esta qualidade pode refletir que no h valor disponvel neste momento, por razes como o valor pode no ter sido fornecido pela fonte de dados. Uma falha de 12 dispositivo foi detectada. Uma falha de 16 sensor foi detectada (o campo Limite pode prover informao adicional). Comunicao 20 em falha. Entretanto, o ultimo valor conhecido est disponvel. Note que a idade do valor pode ser determinada pela propriedade TimeStamp. Baixo 9
Falha de Dispositivo
13
14
15
Falha de Sensor
17
18
19
21
22
23
172
Drivers
DESCRIO Sem Limite Comunicae 24 s esto em falha. No h ltimo valor conhecido disponvel. O Bloco est fora de scan ou trancado. 28 Baixo 25
Fora de Servio
29
30
31
N/A
No utilizado. 32 - 63
Substatus para Qualidade INCERTA SUBSTATUS No especfico DESCRIO Sem Limite No especfico. 64 Baixo 65 LIMITE Alto 66 Constante 67
Drivers
173
DESCRIO Sem Limite O dispositivo 68 que estava providencian do o valor parou de fazlo. O valor retornado deve ser considerado velho . Note que isso difere de um valor Ruim com o Substatus 5 (ltimo valor conhecido). Aquele estado associado com uma falha detectvel de comunicao num valor buscado. Este erro associado com a falha de alguma fonte externa que iria inserir algo no valor dentro de um perodo aceitvel. Note que a idade do valor pode ser determinada na propriedade TimeStamp. No utilizado. 72 - 79 Baixo 69
No utilizado
174
Drivers
DESCRIO Sem Limite O Valor est 80 colado em um dos limites do sensor (nesse caso o campo Limite deve estar configurado para 1 ou 2) ou o sensor est de algum modo conhecido fora de calibrao via algum diagnstico interno (nesse caso o campo Limite deve ser 0). O valor 84 retornado est fora dos limites definidos para esse parmetro. Note que nesse caso o valor do campo Limite indica quais limites foram excedidos, mas no necessariam ente implica que o valor no possa ir mais alm da faixa especificada. Baixo 81
85
86
87
Drivers
175
SUBSTATUS Subnormal
DESCRIO Sem Limite O valor 88 derivado de mltiplas fontes e h um nmero menor do que o requerido de fontes boas. No utilizado. 92 - 127 Baixo 89
No utilizado
Substatus para Qualidade BOA SUBSTATUS No especfico DESCRIO Sem Limite O valor bom. No h condies especiais. 192 Baixo 193 LIMITE Alto 194 Constante 195
No utilizado. 196 - 215 Tipicamente indica que a entrada foi desconectad a e um valor entrado manualment e foi forado. 216 217 218 219
No especfico
176
Drivers
Constante
Drivers
177
CAPTULO
Servidor de Dados
Os Servidores de Dados so os objetos responsveis por abrigar a execuo das variveis do sistema como Tags Internos, Tags Demo, Tags Timer, e instncias de XObjects. Para utilizar este recurso, siga este procedimento: 1. Clique com o boto direito do mouse sobre o projeto no Organizer e selecione a opo Inserir - Servidor de Dados.
NOTA : Os objetos do Servidor de Dados (Pasta de Dados, Tag Contador, Tag Demo, Tag Interno e Tag Timer) podem ser configurados para funcionarem como reas de Alarme .
178
Servidor de Dados
Servidor de Dados
179
Inserindo um Tag Contador 2. O sistema abre uma janela perguntando quantos Tags sero criados no servidor, e qual seu nome. Este nome ser auto-incrementado; se a opo for deixada em branco, os Tags sero criados com o nome padro.
Inserindo Tags Contador As propriedades do Tag Contador podem ser configuradas atravs da Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes.
180
Servidor de Dados
Inserindo um Tag Demo 2. O sistema abre uma janela perguntando quantos Tags sero criados no servidor, e qual seu nome. Este nome ser auto-incrementado; se a opo for deixada em branco, os Tags sero criados com o nome padro.
Servidor de Dados
181
Inserindo Tags Demo As propriedades do Tag Demo podem ser configuradas atravs da Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes.
182
Servidor de Dados
Inserindo um Tag Interno 2. O sistema abre uma janela perguntando quantos Tags sero criados no servidor, e qual seu nome. Este nome ser auto-incrementado; se a opo for deixada em branco, os Tags sero criados com o nome padro.
Inserindo Tags Internos As propriedades do Tag Interno podem ser configuradas atravs da Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes.
Servidor de Dados
183
Inserindo um Tag Timer 2. O sistema abre uma janela perguntando quantos Tags sero criados no servidor, e qual seu nome. Este nome ser auto-incrementado; se a opo for deixada em branco, os Tags sero criados com o nome padro.
184
Servidor de Dados
Inserindo Tags Timer As propriedades do Tag Timer podem ser configuradas atravs da Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes.
Servidor de Dados
185
CAPTULO
6.1 Tela
A Tela o objeto bsico de interface com o usurio, e pode conter vrios tipos de objetos. Os grficos inseridos na Tela podem ser apagados, copiados, movidos, redimensionados, agrupados ou configurados. Para inserir uma Tela no projeto, clique com o boto direito do mouse no nome do projeto no Explorer e selecione a opo Inserir - Tela. No modo Domnio, clique com o boto direito do mouse no item Visualizao - Telas, selecione a opo Inserir Tela em e logo aps o nome do projeto desejado.
Inserindo um Tela na aplicao no modo Domnio Quando uma nova Tela criada, ou quando selecionada a opo Ajustar ao Divisor em uma Tela j existente, a seguinte janela mostrada para configurao do tamanho do objeto:
186
Configurando o tamanho da Tela Opes disponveis na janela Tamanho da Tela OPO Escolha o Divisor onde a Tela ser aberta DESCRIO Permite escolher o Divisor onde a Tela ser aberta. So listados apenas os Divisores cuja Tela associada propriedade SplitLink ser visvel em tempo de execuo. Habilita a Tela como Tela Inicial do Divisor onde ser aberta. Determina o nome da Tela. Determina a largura da Tela, em pixels. Determina a altura da Tela, em pixels.
As opes Largura e Altura estaro inicialmente preenchidas com o tamanho que a Tela deve ter para poder ser exibida no Divisor escolhido sem que aparea a barra de rolagem. Se algum dos valores for negativo, isto indica que o Divisor no estar visvel em tempo de execuo, em funo da configurao do Viewer e dos tamanhos dos outros Divisores. O E3 Studio fornece um editor dos objetos que podem ser inseridos em uma Tela. Esto disponveis os seguintes objetos: Linha, Retngulo, Retngulo Arredondado, Elipse, Arco de Elipse, Desenho Livre, Polgono, Polgono de Curvas, Figura (Imagem), Texto, Display, SetPoint, Escala e MSForms. Os MSForms sero discutidos no prximo captulo (ActiveX); os demais objetos citados sero apresentados neste captulo.
187
Tela Pode-se configurar as propriedades da Tela para determinar tamanho, cor e outros aspectos do comportamento e da aparncia, alm de vrios tipos de eventos. Estes objetos utilizam como padro para o tamanho e coordenadas as unidades HIMETRIC, dadas em 1/100 mm, e no em pixels. Todas das propriedades da Tela podem ser configuradas atravs da Lista de Propriedades, sem a necessidade de se criar scripts para isto. Caso necessite configurar alguma propriedade, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes.
NOTA : A qualidade grfica de uma Tela pode ser modificada, em tempo de execuo, utilizando-se o menu contextual do Viewer e selecionando uma das opes do menu Qualidade (esta tela). Para maiores informaes, veja a propriedade RenderQuality da Tela no Manual de Scripts do E3 .
Controles Padro do Windows (Lista, Editor de Texto, Lista de Seleo, etc.) ElipseX, compostos de qualquer dos objetos acima
As primitivas do editor grfico disponveis no sistema so listadas nas prximas sees. Elas podem ser rotacionadas ou redimensionadas livremente, exceto pelo objeto Figura. Aps ter sido criado, cada objeto permanece selecionado para facilitar a edio de suas propriedades, caso seja necessrio.
6.2.1 Linha
Permite o desenho de retas, ligando dois pontos especificados na sua criao. Para utilizar este objeto, siga estes procedimentos: 1. Selecione a Linha na barra de ferramentas Tela.
2. Clique na Tela para criar o ponto de origem da reta e arraste o mouse at seu ponto final.
6.2.2 Conector
Este objeto utilizado para conectar dois ou mais objetos de Tela atravs de uma linha. Os objetos de Tela que podem ser conectados so o Retngulo, o Retngulo Arredondado, a Elipse, o Arco de Elipse, o Desenho Livre, o Polgono e o Polgono de Curvas. Ao clicar no boto da barra de ferramentas Tela, os objetos anteriormente citados mostraro seus pontos de conexo, como na figura a seguir.
Pontos de conexo de objetos de Tela Para conectar dois objetos, basta clicar sobre um dos pontos de conexo do primeiro objeto e, em seguida, clicar sobre um dos pontos de conexo do segundo objeto. Sempre que se passa o mouse sobre um ponto de conexo, seu cone muda de para , indicando qual ponto ser conectado. Aps a criao do Conector tambm possvel desconectar seus vrtices. Para isso, arraste o vrtice para longe do ponto de conexo do objeto. Para reconectar, arraste-o para perto de um ponto de conexo at que seu cone mude para . Para criar uma conexo entre mais de dois pontos de conexo, basta manter pressionada a Telas e Objetos de Tela 189
tecla CTRL enquanto se seleciona todos os pontos desejados. Para excluir uma Conexo, basta selecion-la e utilizar a tecla DELETE. Se um objeto que possua uma Conexo for excludo, a Conexo no excluda. Para informaes sobre Conectores em objetos XControl, veja a seo a seguir.
Janela de edio de pontos de conexo As opes disponveis nesta janela esto descritas na tabela a seguir. Opes disponveis na janela Novo Ponto de Conexo OPO Nome do Ponto de Conexo DESCRIO Permite definir um nome para o Ponto de Conexo. Mostra em qual Ponto de Conexo do objeto de Tela o Ponto de Conexo do XControl est conectado. Marca este Ponto de Conexo como o ponto ncora do objeto. Este ponto ncora pode ser alterado quando o XControl for inserido em uma Tela. Veja tambm o tpico Ponto ncora para maiores informaes.
Conectado a
Para editar ou excluir um ponto criado, clique com o boto direito do mouse sobre o ponto e escolha a opo Excluir Ponto de Conexo ou Editar Ponto de Conexo, conforme a figura a seguir. Um ponto de conexo tambm pode ser excludo clicando-se sobre ele com a tecla 190 Telas e Objetos de Tela
CTRL pressionada.
Excluir ou editar um ponto de conexo Caso no seja definido nenhum Ponto de Conexo para os objetos de Tela includos no XControl, no ser possvel conectar este XControl a nenhum outro objeto de Tela, quando ele for includo em uma Tela.
6.2.3 Retngulo
Permite o desenho de retngulos, criados a partir de dois vrtices. Para utilizar este objeto, siga estes procedimentos: 1. Selecione o Retngulo na barra de ferramentas Tela.
2. Clique na Tela para criar o vrtice de origem do Retngulo e arraste o mouse diagonalmente at seu vrtice final, at o desenho atingir o tamanho e a posio desejados.
2. Clique na Tela para criar o vrtice de origem do retngulo e arraste o mouse diagonalmente at seu vrtice final, at o desenho atingir o tamanho e a posio desejados. 3. No canto superior esquerdo do objeto, aparecer o ponto responsvel pelo fator de arredondamento do retngulo. Arraste-o mais para o centro ou mais para as bordas para determinar a curva de seus vrtices.
6.2.5 Elipse
Permite o desenho de crculos e elipses. Para utilizar este objeto, siga estes procedimentos: 1. Selecione a Elipse na barra de ferramentas Tela.
2. Clique na Tela para estabelecer o ponto inicial do desenho e arraste o mouse diagonalmente at o desenho atingir o tamanho e a posio desejados.
191
2. Clique na Tela para estabelecer o ponto inicial do desenho e arraste o mouse diagonalmente at o desenho atingir o tamanho e a posio desejados. 3. Nas duas extremidades do corte, aparecero dois pontos responsveis pela posio de abertura do desenho. Arraste-os de forma que o desenho fique mais aberto ou mais fechado. 4. O formato do desenho inicial o de torta. Para alter-lo para arco ou corda, acesse a propriedade ArcStyle na Lista de Propriedades.
2. Clique na Tela para estabelecer o ponto inicial do desenho e arraste o mouse em qualquer direo tantas vezes quantas forem necessrias para completar o desenho desejado.
6.2.8 Polgono
Permite o desenho de polgonos com lados retos. Para utilizar este objeto, siga estes procedimentos: 1. Selecione o Polgono na barra de ferramentas Tela.
2. Clique na Tela para estabelecer o vrtice inicial do desenho e arraste o mouse em qualquer direo tantas vezes quantas forem necessrias para completar o desenho desejado. 3. Quando desejar trocar a direo do desenho, d um clique simples no mouse. Quando desejar finaliz-lo, clique duas vezes.
2. Clique na Tela para estabelecer o vrtice inicial do desenho e arraste o mouse em qualquer 192 Telas e Objetos de Tela
direo tantas vezes quantas forem necessrias para completar o desenho desejado. 3. Quando desejar trocar a direo do desenho, d um clique simples no mouse. Quando desejar finaliz-lo, clique duas vezes.
6.2.10 Figura
Permite mostrar imagens que estejam armazenadas em arquivos, que podem ou no pertencer aplicao. A Figura pode ser redimensionada livremente, porm a rotao s efetiva quando esta for um metafile convertido para smbolo. Os seguintes formatos de arquivo so suportados: .bmp, .gif, .jpg, .ico, .wmf e .emf. Para utilizar este objeto, siga estes procedimentos: 1. Selecione a Figura na barra de ferramentas Tela.
2. Clique na Tela para criar o vrtice de origem do retngulo e arraste o mouse diagonalmente at seu vrtice final. 3. O sistema abrir uma caixa para seleo do arquivo de imagem, conforme figura a seguir.
Seleo do arquivo de imagem 4. Selecione o arquivo e clique em Abrir para inserir a figura na Tela.
193
6.2.11 Texto
Permite a criao de um texto que ser exibido na Tela. Para utilizar este objeto, siga estes procedimentos: 1. Selecione o Texto na barra de ferramentas Tela.
2. Digite o texto desejado e pressione a tecla ENTER. 3. Caso queira alterar ou digitar contedos neste objeto, utilize a propriedade Value .
6.2.12 Display
Permite criar um objeto que utilizado para mostrar os valores dos tags em tempo de execuo. Para utilizar este objeto, siga estes procedimentos: 1. Selecione o Display na barra de ferramentas Tela.
2. Clique na Tela para criar o vrtice de origem do objeto e arraste o mouse diagonalmente at seu vrtice final. 3. Clique com o boto direito do mouse no objeto para abrir a Janela de Propriedades. Na aba Item, escolha o tag a ser associado propriedade Value do Display.
6.2.13 SetPoint
Permite criar um objeto que funciona como uma caixa de edio onde so inseridos contedos a serem atribudos a tags associados. Para utilizar este objeto, siga estes procedimentos: 1. Selecione o SetPoint na barra de ferramentas Tela.
2. Clique na Tela para criar o vrtice de origem do objeto e arraste o mouse diagonalmente at seu vrtice final. 3. Clique com o boto direito do mouse no objeto para abrir a Janela de Propriedades. Na aba Item, escolha o tag a ser associado propriedade Value do SetPoint.
6.2.14 Escala
Permite a criao de um objeto que desenha rguas ou escalas de valores. Para utilizar este objeto, siga estes procedimentos: 1. Selecione a Escala na barra de ferramentas Tela.
2. Clique na Tela para criar o vrtice de origem do objeto e arraste o mouse diagonalmente at seu vrtice final. 194 Telas e Objetos de Tela
6.3.1 Alinhamento
Permite alinhar os objetos de Tela entre si ou em relao Tela. As opes de alinhamento disponveis so: Opes de alinhamento para objetos de Tela CONE OPO Alinhar Esquerda DESCRIO Alinha dois ou mais objetos entre si, tendo como referncia a coordenada esquerda do ltimo objeto selecionado. Alinha dois ou mais objetos entre si, tendo como referncia a coordenada direita do ltimo objeto selecionado. Alinha dois ou mais objetos entre si, tendo como referncia a coordenada superior do ltimo objeto selecionado. Alinha dois ou mais objetos entre si, tendo como referncia a coordenada inferior do ltimo objeto selecionado. Alinha dois ou mais objetos horizontalmente entre si, tendo como referncia o ltimo objeto selecionado.
Alinhar Direita
Alinhamento Superior
Alinhamento Inferior
Alinhamento Central Vertical Alinha dois ou mais objetos verticalmente entre si, tendo como referncia o ltimo objeto selecionado.
195
CONE
DESCRIO Aplica a largura do ltimo objeto selecionado aos demais objetos selecionados. Aplica a altura do ltimo objeto selecionado aos demais objetos selecionados. Aplica a largura e a altura do ltimo objeto selecionado aos demais objetos selecionados. Centraliza o objeto na Tela, de acordo com suas coordenadas horizontais. Centraliza o objeto na Tela, de acordo com suas coordenadas verticais. Aplica a mesma distncia horizontal entre si a trs ou mais objetos. Aplica a mesma distncia vertical entre si a trs ou mais objetos. Aplica o efeito de reflexo horizontal aos objetos selecionados. Aplica o efeito de reflexo vertical aos objetos selecionados.
Mesma Altura
Mesmo Tamanho
Centralizar Horizontalmente
Centralizar Verticalmente
Distribuir Horizontalmente
Distribuir Verticalmente
Espelhar Horizontalmente
Espelhar Verticalmente
196
NOTAS: As opes Espelhar Horizontalmente e Espelhar Verticalmente tm o seguinte comportamento: Para selees mltiplas, cada um dos objetos espelhado individualmente O estado dos botes se altera (pressionado ou no) conforme os objetos tenham sido refletidos verticalmente ou horizontalmente, mas somente se o estado de reflexo igual para todos os objetos selecionados Os botes ficam desabilitados se a Tela estiver selecionada ou se no h nenhum objeto selecionado A partir da verso 4.0, os objetos de Tela podem ser ajustados ao pixel mais prximo (efeito Snap to Pixel ), utilizando-se a combinao de teclas CTRL + BARRA DE ESPAO.
6.3.2 Grade
Conjunto de linhas horizontais e verticais que servem como referncia de posicionamento para objetos na Tela. Ela visualizada somente no E3 Studio, e no em tempo de execuo. No E3 Studio, possvel mostrar ou esconder a grade atravs do menu Arranjar - Grade , ou na barra de ferramentas Alinhamento .
As propriedades da Grade podem ser configuradas atravs do menu Arranjar - Edio da Grade . Ao selecionar esta opo, a seguinte janela mostrada:
197
Opes disponveis na janela Propriedades da Grade OPO Pontilhada DESCRIO A grade mostra pontos apenas nas interseces de linhas. A grade mostra a linha inteira pontilhada. Alinha o mouse grade automaticamente. Determina a distncia entre as linhas horizontais. Determina a distncia entre as linhas verticais. Determina a cor da grade.
Largura
Cor
6.3.3 Rotacionar
Permite rotacionar um objeto de Tela tendo como origem seu centro ou qualquer outro ponto na Tela. Para utilizar este recurso, siga estes procedimentos: 1. Selecione um objeto na Tela e clique no boto Rotacionar . , na barra de ferramentas Tela
2. Clique em um de seus vrtices de rotao (em verde) e arraste o objeto at a posio desejada. 3. Caso seja necessrio, altere o centro de rotao do objeto (marcado por um crculo verde).
2. Clique nos objetos conforme a ordenao desejada. O nmero com a ordem de navegao aparecer no canto superior esquerdo do objeto. 3. Quando o Domnio for executado, a navegao entre estes objetos ser feita conforme a ordem especificada.
198
Ordem dos Tabs Para manter a ordem inicial dos objetos, necessrio seguir estes procedimentos: 1. Aps ter criado o objeto na Tela, clique na opo Ordem dos Tabs 2. Com a tecla CTRL pressionada, clique no penltimo objeto. 3. Solte a tecla CTRL e clique no ltimo objeto (objeto criado anteriormente). .
NOTA : A ordem de tabulao equivalente ordem de sobreposio dos objetos, descrita no tpico Sobreposio de Objetos.
4. Para editar um objeto contido em um grupo, clique com o boto direito do mouse no objeto e selecione a opo Editar Grupo.
199
NOTA : A partir da verso 4.0, possvel ajustar os objetos dentro de um grupo ao pixel mais prximo (efeito Snap to Pixel ), utilizando-se a combinao de teclas CTRL + BARRA DE ESPAO. Neste caso, o efeito ser aplicado a cada um dos objetos dentro do grupo, podendo ser desfeito utilizando-se a combinao de teclas CTRL + Z.
6.3.6 Animao
Recurso que aplica movimento a um objeto em tempo de execuo. Disponvel na barra de ferramentas Tela. Os tipos de movimentos disponveis no sistema so: Animao com Translao: O objeto que recebe este recurso faz movimentos lineares de acordo com as configuraes das propriedades no objeto. Para habilitar esta opo, siga estes procedimentos: 1. Selecione o objeto na Tela e clique no boto Animar com Translao.
Translao Animao com Rotao: O objeto que recebe este recurso faz movimentos circulares de acordo com o centro de rotao do objeto e seu ngulo. Para habilitar esta opo, siga estes procedimentos: 1. Selecione o objeto na Tela e clique no boto Animar com Rotao.
2. Quando o objeto criado, seu centro de rotao padro definido como o centro do objeto, com uma inclinao de 0 graus de posio da horizontal em relao a esse centro. Neste momento, os vrtices do objeto selecionado so indicados por pequenos crculos e seu centro por dois crculos circunscritos. 3. Ao passar o mouse sobre o centro ou vrtices, possvel modificar o centro arrastando ou rotacionando o objeto de um de seus vrtices em relao ao centro.
200
Rotao
201
6.3.8 Zoom
Na edio da Tela, pode-se escolher livremente o nvel de zoom desejado e mais confortvel para a edio. O zoom est disponvel atravs do boto Zoom, e possui nveis que vo de 10% a 800%, alm das opes Toda Largura, Toda Altura, Toda Pgina e Preencher, conforme a figura a seguir.
Menu Zoom Alm do menu Zoom, possvel modificar o nvel de zoom atravs do teclado e mouse, utilizando as seguintes combinaes: CTRL + SINAL DE MAIS (+): Aumenta o zoom CTRL + SINAL DE MENOS (-): Diminui o zoom CTRL + ASTERISCO (*) ou CTRL + ZERO (0): Volta para o zoom padro (100%) CTRL + Roda do mouse para cima: Aumenta o zoom CTRL + Roda do mouse para baixo: Diminui o zoom
NOTA : Ao utilizar as opes de CTRL + Roda do mouse (para cima ou para baixo), o foco do zoom sempre relativo posio do ponteiro do mouse.
202
6.3.9 Camadas
O E3 oferece uma arquitetura de Telas com at 32 camadas para insero de objetos. Cada objeto pode pertencer a uma ou mais camadas, e a Tela ativa tanto em configurao (no E3 Studio) quanto em execuo (no E3 Viewer) pode estar com nenhuma, uma, vrias ou todas as camadas ativas. Isso permite criar sistemas com vrias formas de monitoramento como, por exemplo, a visualizao de um processo apenas com o sistema eltrico, apenas o hidrulico ou ambos. possvel tambm controlar o aparecimento de camadas de acordo com um determinado nvel de Zoom. A configurao das camadas feita a partir do boto Camadas. As opes disponveis so: Opes disponveis no boto Camadas OPO Camada DESCRIO Habilita a visualizao da camada configurada na propriedade Layer da Tela. Mostra todas as camadas disponveis no projeto. Nenhuma camada mostrada. Atravs desta opo, podem-se configurar camadas individuais. Esta opo abre uma caixa de dilogo para configurao da camada.
Todas as camadas
A janela Edio de Camadas tem os seguintes botes: Adicionar Camada uma nova camada; Remover Camada Camada , para a edio da camada selecionada. ou , a seguinte janela aberta:
, para a criao de
Adio / Edio de camada As opes disponveis so as seguintes: Opes disponveis na Camada OPO Nome Zoom Baixo DESCRIO Determina o nome da camada. Define a porcentagem inicial de zoom na camada. Define a porcentagem final de zoom na camada. Habilita a utilizao de uma condio adicional de visibilidade de zoom na camada. Esta condio pode ser uma varivel ou propriedade qualquer. Estabelece uma associao ou uma propriedade, que uma vez ativa (diferente de zero), tambm exibe a camada (as opes de Zoom e Fonte no so exclusivas, isto , podem ativar a camada estando uma ou outra condio ativa).
Zoom Alto
Fonte
204
6.3.10 Travar
Ao escolher esta opo, o E3 Studio no permite que o objeto seja movido, evitando movimentos indesejados. Depois de travado, o mouse exibe um cursor com um cadeado ao ser deslocado sobre a rea do objeto. Para habilitar esta opo, basta clicar com o boto direito do mouse sobre o objeto desejado e escolher a opo Travar .
Objeto travado Para desabilitar esta opo, basta clicar novamente com o boto direito do mouse no objeto e selecionar a opo Destravar.
205
Objeto com ponto ncora NOTA : Ao utilizar a combinao de teclas CTRL + BARRA DE ESPAO (efeito Snap to Pixel , disponvel a partir da verso 4.0) em um objeto com a opo Definir Ponto ncora habilitada, o objeto ser movido para o pixel mais prximo, sem respeitar a posio do ponto ncora. Caso seja utilizado o mouse para mover o objeto, o ponto ncora ser posicionado exatamente em cima de um pixel. Para corrigir eventuais discrepncias no posicionamento do objeto, pode-se utilizar a combinao CTRL + BARRA DE ESPAO aps soltar o boto do mouse.
6.3.12 Sombreamento
Permite aplicar ou editar o efeito de sombra em um objeto de Tela.
Opes da sombra Para utilizar este recurso, siga estes procedimentos: 1. Insira ou selecione o objeto ao qual deseja aplicar a sombra. 2. Altere suas propriedades atravs da barra de ferramentas Sombra, de acordo com as seguintes opes: Opes disponveis na barra de ferramentas Sombra OPO DESCRIO Habilita ou desabilita o efeito de sombra no objeto. Desloca a sombra abaixo do objeto. Desloca a sombra acima do objeto. 206 Telas e Objetos de Tela
OPO
DESCRIO Desloca a sombra esquerda do objeto. Desloca a sombra direita do objeto. Configura a cor da sombra do objeto.
6.3.13 Desenho
Permite aplicar ou editar informaes relativas s cores de fundo e frente da Tela e objetos de Tela e borda dos objetos de Tela.
Opes de desenho Para utilizar este recurso, siga estes procedimentos: 1. Insira ou selecione o objeto (Tela ou objeto de Tela) cujas cores ou bordas deseja editar. 2. Altere suas propriedades de acordo com as opes disponveis na barra de ferramentas Desenho. As opes disponveis nesta barra de ferramentas so: Cor do Fundo: permite selecionar a cor de fundo da Tela ou do objeto de Tela a partir de uma lista de cores pr-estabelecidas, ou criar uma nova cor personalizada. Cor da Frente : permite selecionar a cor de frente da Tela ou do objeto de Tela a partir de uma lista de cores pr-estabelecidas, ou criar uma nova cor personalizada. Cor da Borda: permite selecionar a cor da borda do objeto de Tela a partir de uma lista de cores pr-estabelecidas, ou criar uma nova cor personalizada. Estilo da Borda: permite escolher o tipo de borda exibida pelo objeto de Tela a partir de uma lista com estilos pr-estabelecidos: uma linha contnua, diferentes tipos de pontilhados e tracejados, ou simplesmente nenhuma borda. Espessura da Linha: permite escolher a espessura da linha da borda do objeto de Tela a partir de uma lista com espessuras pr-estabelecidas entre 0 e 2,5 milmetros. Estilo do Preenchimento: permite escolher o tipo de preenchimento exibido pela Tela ou pelo objeto de Tela, isto , como se dar a combinao entre as cores de fundo e de frente do objeto. Ao selecionar esta opo, a seguinte janela aberta:
207
Efeitos de preenchimento As opes disponveis nesta janela so: Opes disponveis na janela Preenchimento OPO Estilos DESCRIO Mostra todos os estilos de preenchimento disponveis para o objeto selecionado. Mostra a cor da frente previamente selecionada para o objeto. Permite tambm a seleo de uma nova cor da frente, nos mesmos moldes que o boto Cor do fundo .
Cor da frente
Mostra a cor do fundo previamente selecionada para o objeto. Permite tambm a seleo de uma nova cor do fundo, nos mesmos moldes que o boto .
Amostra
Mostra como o efeito escolhido aplicado com as cores de fundo e de frente do objeto. Ao selecionar a opo Transparente , os preenchimentos com efeito hachurado no mostram a cor de fundo do objeto selecionado, somente a cor de frente, criando um efeito de transparncia no objeto. Ao selecionar a opo Opaco, este efeito no acontece. (Obs.: a opo Transparente est desabilitada para a Tela).
Opaco/transparente
208
Cores
209
O boto Outra permite que o usurio selecione uma cor de qualquer parte da tela, dentro ou fora do E3 Studio. Basta clicar no boto e aps clicar sobre a cor desejada que ela ser capturada para a janela de cores. Para personalizar uma cor, pode-se combinar duas metodologias: RGB (componentes de vermelho, verde e azul) e HSL (componentes de matiz, saturao e luminosidade).
Cor personalizada A escala RGB descreve uma cor atravs da mistura de trs cores bsicas, a saber: Red (vermelho): indica a quantidade do componente primrio vermelho na composio da cor Green (verde): indica a quantidade do componente primrio verde na composio da cor Blue (azul): indica a quantidade do componente primrio azul na composio da cor
Cada um destes elementos da cor podem ter um grau de intensidade que vai de 0 a 255. A escala HSL descreve uma cor atravs da mistura de trs componentes bsicos, a saber: Hue (matiz): especifica a gradao da cor dentro do espectro de luz visvel Saturation (saturao): indica a intensidade de um determinado matiz. Um matiz com alta saturao tem uma cor mais intensa, enquanto que um matiz com baixa saturao produz uma cor mais acinzentada Lightness (luminosidade): indica a quantidade de luz aplicada cor. Quanto maior a luminosidade, mais clara a cor; do mesmo modo, quanto menor a luminosidade, mais escura a cor
210
Estes elementos tambm podem ter seu grau de intensidade configurado entre 0 e 255. Assim, basta especificar o valor para cada um dos itens, conforme a tonalidade da cor desejada, ou escolher a cor desejada diretamente com o mouse sobre as escalas da janela. O valor numrico de cada cor obtido atravs da seguinte frmula:
Red * 256^0 + Green * 256^1 + Blue * 256^2
Ou seja:
Red * 1 + Green * 256 + Blue * 65536
Sendo que Red , Green e Blue podem assumir valores de 0 a 255. Por exemplo: Preto (0, 0, 0) = 0 * 1 + 0 * 256 + 0 * 65536 = 0 Branco (255, 255, 255) = 255 * 1 + 255 * 256 + 255 * 65536 = 16777215 Vermelho (255, 0, 0) = 255 * 1 + 0 * 256 + 0 * 65536 = 255 Verde (0, 255, 0) = 0 * 1 + 255 * 256 + 0 * 65536 = 65280 Azul (0, 0, 255) = 0 * 1 + 0 * 256 + 255 * 65536 = 16711680
NOTA : Os valores armazenados nas propriedades dos objetos que se referem a cores so os valores nmericos, calculados atravs da frmula acima. A ferramenta Procurar/Substituir utiliza esse valor armazenado no processo de pesquisa, e no os valores formatados como RGB mostrados na lista de propriedades.
Os objetos que suportam formatao devem ter o tipo de dado na propriedade Value alterado de acordo com o tipo de formatao desejada.
211
Janela de Formatao de Valores As seguintes formataes esto disponveis: Geral: No h formatao especfica. realizada automaticamente, dependendo do tipo de dado Nmero: Apresenta nmeros com parte inteira e fracionria, permitindo definir o nmero de casas decimais e uso de separador de milhares. Para nmeros muito grandes ou muito pequenos, utilize o formato Cientfico. Os smbolos de casa decimal e separador de milhares so aqueles definidos no Painel de Controle - Configuraes Regionais Data/Hora: Apresentam valores numricos (formato Gregoriano) como datas e horas, quando vlidos Porcentagem: Multiplica o nmero por 100 e adiciona o smbolo de percentual, definindo tambm o nmero de casas decimais Cientfico: Este formato apresenta o nmero em notao de mantissa e expoente. Ideal para nmeros de magnitude variada, permitindo escolher tambm o nmero de casas decimais e formatos Especial: Permite formatar nmeros inteiros em bases no decimais (hexadecimal, octal e binria)
terceiro campo utilizado quando o valor numrico for zero. Finalmente, o quarto campo utilizado quando o dado for do tipo texto. Sempre que mais de um campo for definido, o campo anterior ser considerado, mesmo que esteja vazio. No caso de um formatador de campo vazio, o valor formatado ser sempre um texto vazio. Note que isso difere do formato Geral, que apenas um formato vazio, sem o uso dos separadores de campo (ponto e vrgula). Para inserir caracteres que sero mostrados pelo formatador pode-se coloc-los entre aspas duplas ou aps uma barra invertida. Exemplos (vlidos para todos os tipos de formatadores): Entrada de Texto FORMATADOR "0#?" \m\d\y 0#? mdy SADA FORMATADA
Tambm possvel criar formatadores que contenham apenas texto, que podem ser combinados com o uso de diferentes campos, como no exemplo a seguir: Formatador e Sada Formatada VALOR 1 FORMATADOR SADA FORMATADA
"Positivo";"Negativo";"Zero"," Positivo Texto" "Positivo";"Negativo";"Zero"," Negativo Texto" "Positivo";"Negativo";"Zero"," Zero Texto" "Positivo";"Negativo";"Zero"," Texto Texto"
-1
"Abcd"
Alm disso, os seguintes caracteres podem ser mostrados diretamente sem o uso de aspas ou barra: $ - + / () : ! ^ & ' (aspas simples esquerda) ' (aspas simples direita) ~ { } = < >
NOTA : Para mostrar a barra invertida ou aspas duplas no dado formatado, use \" ou \\ . Quando entre aspas, todo o texto copiado diretamente; logo, "\a" mostrado simplesmente como \a .
Os formatadores numricos aceitam trs tipos bsicos de caracteres para definir o nmero
213
de dgitos apresentados: Formatadores Numricos OPO 0 (zero) DESCRIO Coloca o dgito significativo ou 0 (zero), quando no houver. Coloca o dgito significativo. Coloca o dgito significativo ou um espao, quando no houver.
# ?
O ponto decimal define que se deseja apresentar tambm a parte fracionria de um nmero. A vrgula tem como funo indicar que o valor deve ser dividido por mil (para cada vrgula), aps os dgitos do formatador. Independentemente da configurao local do Windows, o ponto e a vrgula sempre devem ser utilizados no texto do formatador para indicar o separador de milhar e de decimal, mas a sada formatada ser de acordo com a configurao regional do sistema. Exemplos: Opes disponveis DADO 12000 1234567 #, #,#.0 FORMATADOR 12 1,234,567.0 SADA FORMATADA
214
215
Formatadores para Datas e Horas DADO 1234.56789 0.56789 12.345678 FORMATADOR dd/MMMM/yyyy hh:mm:ss.000 tt hh\hmm\mss.000\s SADA FORMATADA 18/maio/1903 01:37:45.696 PM 296 h17 m46.667 s
NOTA : Os valores armazenados nas propriedades dos objetos que se referem a datas so os valores nmericos, calculados atravs da frmula acima. A ferramenta Procurar/Substituir utiliza esse valor armazenado no processo de pesquisa, e no os valores formatados como data/hora mostrados na lista de propriedades.
216
CAPTULO
ActiveX
Os objetos ActiveX so componentes de software baseados na tecnologia COM (Component Object Model ) que podem ser inseridos em uma aplicao para realizar diversas tarefas. Estes objetos so desenvolvidos em ambientes de programao tais como C/C++, Delphi e Visual Basic, entre outros. Alguns objetos ActiveX so automaticamente registrados quando o E3 instalado: E3Alarm, E3Browser e E3Chart (desenvolvidos pela Elipse Software); Microsoft Forms (desenvolvidos pela Microsoft); e Relatrio (ActiveReports, desenvolvido pela Data Dynamics). Os objetos E3Alarm, E3Browser, E3Chart e Relatrio possuem captulos especficos mais adiante neste Manual. Os objetos Microsoft Forms so descritos em outra seo deste captulo.
NOTA : Para objetos ActiveX no pr-instalados pelo E3, necessrio que estes objetos sejam instalados em todos os computadores onde a aplicao ir rodar, especialmente em Viewers Remotos.
Alm destes, pode-se inserir qualquer outro objeto ActiveX. Para registrar um objeto ActiveX no E3, siga estes procedimentos: 1. Acesse o menu Ferramentas - Gerenciar ActiveX. O sistema mostrar a caixa de dilogo a seguir.
DESCRIO Listagem com todos os controles ActiveX registrados no Windows e que podem ser adicionados ao E3. Listagem com todos os controles ActiveX j registrados no E3. Registra o controle selecionado no E3. Caso o controle seja incompatvel com o E3, uma caixa de dilogo mostrada avisando o usurio a respeito da incompatibilidade. Remove o controle selecionado da lista Controles registrados no E3 , movendo-o de volta para a lista Controles registrados no Windows. Os controles com o cone no podem ser removidos, somente os que tiverem o cone .
Controles registrados no E3
Registrar
Remover
Procurar
Abre uma caixa de dilogo para localizar um arquivo ActiveX. Permite atualizar os controles ActiveX na listagem Controles registrados no Windows que tenham sido registrados aps a abertura da janela de gerenciamento. Fecha a janela de gerenciamento dos ActiveX.
Atualizar
Fechar
2. Clique no boto Procurar. O sistema abre uma caixa de dilogo para localizao do arquivo que contm o ActiveX.
218
Ac tiveX
Localizao do arquivo ActiveX 3. Selecione o arquivo e clique no boto Abrir. Os objetos ActiveX podem ser de dois tipos: grficos (utilizados nas Telas da aplicao) ou no-grficos (que realizam algum tipo de manipulao de dados). Os objetos grficos podem ser inseridos na aplicao de trs formas diferentes: Atravs da barra de ferramentas Objetos, selecionando o boto especfico do objeto desejado Atravs do clique com o boto direito do mouse no objeto Tela, no Organizer, selecionando a opo Inserir Atravs do clique com o boto direito do mouse na Tela, selecionando a opo Inserir
Ac tiveX
219
Inserindo um objeto grfico na Tela Os objetos no-grficos podem ser usados na aplicao atravs de scripts e so criados pelo mtodo CreateObject, padro do VBScript.
220
Ac tiveX
7.1.5 Texto
Exibe mensagens de texto que no podem ser editadas pelo usurio, como descries de controles ou legendas. inserido na Tela atravs do boto .
7.1.6 Lista
Exibe uma lista de itens dentre os quais o usurio pode escolher um ou mais. inserido na Tela atravs do boto .
Ac tiveX
221
Aba Visualizador do Viewer As opes disponveis desta aba so as seguintes: Opes disponveis para o Elipse KeyPad na aba Visualizador OPO Mostrar quando um SetPoint recebe o foco DESCRIO Esta opo faz com que o Elipse KeyPad seja mostrado sempre que um objeto do tipo SetPoint receba o foco. Habilita ocultar o Elipse KeyPad ao pressionar a tecla ENTER. Esta opo equivale propriedade AutoHideOnEnter do controle. Habilita ocultar o Elipse KeyPad ao pressionar a tecla ESC. Esta opo equivale propriedade AutoHideOnEsc do controle.
222
Ac tiveX
Em scripts, o KeyPad pode ser acionado utilizando-se o mtodo GetKeyPad do objeto Application. Demais informaes sobre as funcionalidades das propriedades deste objeto podem ser encontradas no Manual de Referncia de Scripts do E3 , em seu captulo respectivo.
Ac tiveX
223
CAPTULO
Quadros
O objeto Quadro utilizado para organizar e estruturar a interface do projeto, criando visualizaes compostas para o usurio dentro da janela principal do Viewer ou do navegador. Muitas vezes, uma aplicao requer apenas uma Tela principal, que a porta de entrada para a aplicao. A partir da, o usurio pode navegar por outras Telas, que ocuparo o lugar da primeira, formando uma nica visualizao do processo. Porm, possvel suportar mais de uma visualizao em um mesmo documento ou projeto. Isto se torna til no caso de uma aplicao que utilize uma Tela que nunca muda, ou que muda pouco (como, por exemplo, um menu), e outra parte que a navegao das Telas propriamente ditas. Para utilizar este recurso, execute os procedimentos a seguir. 1. Clique com o boto direito do mouse no nome do projeto no Explorer e selecione a opo Inserir - Quadro. No modo Domnio, clique com o boto direito do mouse no item Visualizao - Viewer e Quadros, selecione a opo Inserir Quadro em e logo aps o nome do projeto desejado.
Inserindo um Quadro na aplicao no modo Domnio O Quadro possui subdivises, chamadas de Divisores, que podem ser inseridas ou removidas do Quadro atravs de um menu no boto direito do mouse na view de Design. A princpio, o Quadro possui um Divisor inicial, que pode ser subdividido horizontal ou verticalmente em dois Divisores, que por sua vez tambm podem ser subdivididos em outros dois Divisores, e assim sucessivamente. A cada par de novos Divisores criados pelas opes Dividir Horizontalmente e Dividir Verticalmente , h sempre um Divisor Principal e um Divisor Secundrio. Apenas o Divisor 224 Quadros
Principal ter valores que definem explicitamente o seu posicionamento, ficando o Divisor Secundrio com o valor restante. Assim, quando o Divisor subdividido horizontalmente, sua propriedade SplitDockPosition recebe o valor dockTop; do mesmo modo, se a subdiviso for vertical, esta propriedade receber o valor dockLeft. A propriedade do Divisor Secundrio receber, ento, o valor dockRemaining, significando que este ocupar o espao que sobra. Os cones dos objetos no Organizer identificam exatamente o posicionamento de cada Divisor. Posicionamento do Divisor CONE DESCRIO dockBottom: este Divisor est posicionado na parte inferior do Divisor Pai. dockTop: este Divisor est posicionado na parte superior do Divisor Pai. dockLeft: este Divisor est posicionado esquerda do Divisor Pai. dockRight: este Divisor est posicionado direita do Divisor Pai. dockRemaining: este Divisor ocupa o espao restante aps o posicionamento de seu Divisor-Irmo.
Cada Divisor corresponde visualizao de uma Tela ou Quadro de seu processo ou a uma URL (Uniform Resource Locator). Para utilizar este recurso, execute os procedimentos a seguir. 1. Clique com o boto direito do mouse sobre o Quadro aberto e selecione uma das opes: Dividir Horizontalmente ou Dividir Verticalmente , conforme o tipo de diviso desejada.
Quadros
225
2. Para remover um Divisor, clique com o boto direito do mouse sobre o Quadro aberto e selecione a opo Remover Quadro. 3. possvel inverter a seleo original dos Divisores (transformar o Divisor Principal em Divisor Secundrio, e vice-versa) atravs deste mesmo menu. No caso de um Divisor Principal, clique com o boto direito do mouse no Quadro e selecione a opo Configurar como Divisor Secundrio; no caso de um Divisor Secundrio, selecione a opo Configurar como Divisor Principal. A propriedade SplitDockPosition dos Divisores ser automaticamente configurada para refletir esta mudana. 4. Com a opo Selecionar Tela ou Quadro, possvel escolher a Tela ou Quadro que ser associada propriedade SplitLink do Divisor selecionado. A escolha feita atravs de uma janela do AppBrowser. 5. Pode-se inserir vrios Divisores no Quadro.
Divisores do Quadro 6. Para configurar os Divisores do Quadro, clique com o boto direito do mouse no Organizer sobre o Divisor desejado e selecione a opo Propriedades.
226
Quadros
Configuraes do Quadro As opes disponveis so as seguintes: Opes disponveis na aba Quadro OPO Link DESCRIO Determina o caminho da Tela ou Quadro que o Divisor ir abrir. S ser habilitado se o Divisor no tiver nenhum filho. Este campo equivale propriedade SplitLink. Determina a posio do divisor no Quadro. Este campo equivale propriedade SplitDockPosition. Determina o valor que ser atribudo ao Quadro. S ter efeito visual se for modificada no Divisor Principal. Este campo equivale propriedade SplitValue .
Posio
Valor
Algumas das propriedades do Quadro ou Divisor podem ser configuradas atravs da Lista de Propriedades, sem a necessidade da criao de scripts para isto. Caso haja a necessidade de configurar alguma propriedade, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes. Para maiores informaes, consulte o Manual de Referncia de Scripts.
Quadros
227
CAPTULO
Associaes
Associaes (ou conexes) so ligaes feitas entre propriedades e objetos ou outras propriedades. As Associaes trazem grande facilidade ao criar animaes e outros tipos de lgicas comuns, minimizando a utilizao de scripts. Pode-se acessar a aba Associaes clicando-se com o boto direito do mouse no objeto e selecionando a opo Propriedades. Nesta aba, so mostradas as propriedades do objeto que podem ser associadas, bem como os tipos de Associaes existentes e suas fontes.
Aba Associaes As opes disponveis na aba Associaes so as seguintes: Opes disponveis na aba Associaes OPO Propriedades DESCRIO Lista as propriedades do objeto que podem ser associadas.
228
Assoc ia es
OPO Conexo
DESCRIO Indica o tipo de Associao que a propriedade possui. Para propriedades comuns, as Associaes disponveis so as seguintes: Simples, Bidirecional, Analgica, Digital, Por Tabela, Reversa e Mltipla. Existe ainda a ligao entre propriedades de ElipseX e objetos, que ainda no pode ter seu tipo modificado (para maiores detalhes, consulte o captulo Bibliotecas). No caso mais simples, especifica o caminho para um objeto ou propriedade. Este caminho pode ser preenchido pelo AppBrowser, que pode ser acessado atravs do boto , que fica direita do campo. No caso geral, uma expresso que permite aplicar operaes lgicas, aritmticas e avaliaes de funes propriedades, objetos e constantes.
Fonte
Ao especificar a fonte da Associao, o seu texto aparecer em azul, caso esta corresponda a uma expresso vlida. Se a expresso contiver erros, como no caso de caminhos de objetos que no existam (ou pertenam a projetos que no estejam carregados), o texto aparecer em vermelho. Nestes casos, a opo de Verificar Domnio ir informar os locais que necessitam de correo ou reviso. Os tipos de Associaes disponveis sero explicados nos tpicos a seguir.
Assoc ia es
229
Associao Simples Para utilizar este recurso, siga estes procedimentos: 1. Selecione o objeto desejado para a Associao. 2. Acesse as propriedades deste objeto atravs do clique com o boto direito do mouse e selecione a opo Propriedades. 3. Clique na aba Associaes e selecione a propriedade para a qual deseja fazer a Associao. O sistema indicar vrios tipos de Associaes. 4. No campo Fonte , selecione a Associao desejada e clique no boto do AppBrowser para indicar a propriedade que deseja referenciar, ou escreva a expresso neste campo.
230
Assoc ia es
Associao Bidirecional Para utilizar este recurso, siga estes procedimentos: 1. Selecione o objeto desejado para a Associao. 2. Acesse as propriedades deste objeto atravs do clique com o boto direito do mouse e selecione a opo Propriedades. 3. Clique na aba Associaes e selecione a propriedade para a qual deseja fazer a Associao. O sistema indicar vrios tipos de Associaes. 4. No campo Fonte , selecione a Associao desejada e clique no boto do AppBrowser para indicar a propriedade que deseja referenciar, ou escreva a expresso neste campo.
Assoc ia es
231
Associao Digital As opes disponveis nesta Associao so as seguintes: Opes disponveis para a Associao Digital OPO Ligado DESCRIO Especifica o valor assumido pela propriedade quando a expresso da fonte for Verdadeira. Especifica o valor assumido pela propriedade quando a expresso da fonte resultar em Falso. Quando este campo estiver habilitado, a propriedade conectada ir alternar entre os valores do campo Para valor, caso a fonte retorne Verdadeiro. Caso contrrio, a propriedade retornada ir alternar entre os valores dos campos Valor e Para valor caso a fonte retorne Falso.
Desligado
Pisca
232
Assoc ia es
DESCRIO Especifica o valor alternativo a ser assumido periodicamente pela propriedade quando a expresso ou Associao da fonte resultar em Verdadeiro e o campo Pisca estiver habilitado. Especifica o valor alternativo a ser assumido periodicamente pela propriedade quando a expresso da fonte resultar em Falso e o campo Pisca estiver desabilitado.
Para utilizar este recurso, siga estes procedimentos: 1. Selecione o objeto desejado para a Associao. 2. Acesse as propriedades deste objeto atravs do clique com o boto direito do mouse e selecione a opo Propriedades. 3. Clique na aba Associaes e selecione a propriedade para a qual deseja fazer a Associao. O sistema indicar vrios tipos de Associaes. 4. No campo Fonte , selecione a Associao desejada e clique no boto do AppBrowser para indicar a propriedade que deseja referenciar, ou escreva a expresso neste campo.
As opes disponveis nesta Associao so as seguintes: Opes disponveis para a Associao Analgica OPO Valor na Fonte DESCRIO Determina os valores mnimo e mximo atingidos na fonte. Determina os valores mnimo e mximo atingidos na propriedade.
Valor na Propriedade
Para utilizar este recurso, siga estes procedimentos: 1. Selecione o objeto desejado para a Associao. 2. Acesse as propriedades deste objeto e clique na aba Associaes. Selecione a propriedade para a qual deseja fazer a Associao. O sistema indicar vrios tipos de Associaes. 3. No campo Fonte , selecione a Associao desejada e clique no boto do AppBrowser para indicar a propriedade que deseja referenciar, ou escreva a expresso neste campo.
234
Assoc ia es
Associao por Tabela As opes disponveis nesta Associao so as seguintes: Opes disponveis para a Associao por Tabela OPO DESCRIO Insere uma nova linha na tabela. Remove a linha selecionada da tabela. Min Especifica o valor mnimo da fonte para uma linha da tabela. Especifica o valor mximo da fonte para uma linha da tabela. Especifica o valor da propriedade a ser assumido quando a fonte estiver no intervalo especificado na linha. Determina que quando a fonte estiver no intervalo desta linha, a propriedade ir alternar periodicamente entre os valores especificados nos campos Valor e Valor (com o Pisca habilitado). Especifica o valor alternativo da propriedade a ser assumido quando a fonte estiver no intervalo especificado na linha, isto , quando o campo Pisca estiver habilitado.
Max
Valor
Pisca
1. Na aba Associaes, selecione a propriedade e associe a opo Conexo por tabela. 2. Crie as linhas desejadas na tabela e configure os campos Min, Max e Valor. 3. Caso deseje alternar periodicamente entre os valores, habilite o campo Pisca e configure as opes restantes.
Associao Reversa
236
Assoc ia es
1. Clique nas propriedades do objeto e escolha a aba Associaes. 2. Selecione a propriedade para a qual deseja fazer a Associao, e clique no item Conexo Mltipla. 3. Defina a fonte principal da Associao na coluna Fonte .
Associao Mltipla As opes disponveis nesta Associao so as seguintes: Opes disponveis para a Associao Mltipla OPO DESCRIO Insere uma nova linha na tabela. Remove a linha selecionada da tabela. Min Especifica o valor mnimo da fonte para uma linha da tabela. Especifica o valor mximo da fonte para uma linha da tabela. Especifica a fonte que ser associada com a propriedade quando o valor da fonte principal estiver entre os limites Min e Max.
Max
Fonte
Assoc ia es
237
Edio de Associaes A caixa de dilogo anterior mostra uma lista das Associaes, propriedades do tipo Link e eventos do usurio relacionados aos objetos selecionados e seus filhos. 238 Assoc ia es
De acordo com o tipo de linha, temos as seguintes informaes dispostas nas colunas: Opes disponveis na janela Editar Associaes OPES Nome do objeto Propriedade / Evento DESCRIO Determina o nome do objeto. Determina a propriedade do objeto que possui a Associao. Determina o tipo de Associao (Simples, Bidirecional, Analgica, Digital, Por Tabela, Reversa e Mltipla). Determina a fonte da Associao.
Conexo
Fonte
Opes para Propriedades do tipo Link OPO Nome do objeto DESCRIO Determina o nome do objeto que possui a propriedade. Determina o nome da propriedade. sempre a mesma (Link). Determina o valor da propriedade.
Opes para Eventos do usurio OPO Nome do objeto DESCRIO Determina o nome do objeto que possui o evento. Determina o nome do evento do usurio. Determina o tipo do evento (OnEvent, WhileEvent ou OnValueChanged). Expresso relacionada ao evento.
Fonte
Na caixa de dilogo Editar Associaes, permitido modificar o seguinte: Associaes: Podem ser modificadas, exceto o nome do objeto Assoc ia es 239
Propriedades do tipo Link: Podem ser modificadas, exceto o nome do objeto Eventos do usurio: Podem ser modificados, exceto o nome do objeto e o nome do evento
O boto permite a remoo da Associao selecionada. A opo Mostrar janela de propriedades das associaes determina se os minidialogs das Associaes sero mostrados quando a linha estiver selecionada. Se esta janela estiver visvel, permitida a edio das propriedades das Associaes. Seu valor padro habilitado.
Edio das propriedades da Associao selecionada Para editar as propriedades dos eventos do usurio, necessrio selecionar a linha que contm o evento e na coluna Conexo, clicar na opo Editar.
Edio das propriedades dos eventos do usurio Ao clicar na opo Editar, a caixa de dilogo a seguir mostrada, permitindo assim que seja editado o evento do usurio selecionado.
240
Assoc ia es
Edio de eventos As opes disponveis so as seguintes: Opes disponveis na janela Editar Eventos OPO Propriedade ou expresso DESCRIO Propriedade ou expresso geradora do evento. Indica que o evento ser do tipo etOnEvent ou etWhileEvent. Indica o ciclo de repetio do evento em ms, isto , de quanto em quanto tempo ele ir ocorrer, enquanto a expresso geradora for verdadeira. Valor para o intervalo de repetio, em milissegundos. Indica que o evento ser etOnValueChanged, isto , o evento ir ocorrer sempre que a expresso geradora mudar o valor. Se houver alguma desconexo, ela ser tratada como uma mudana de valor.
A janela de edio de Associaes permite utilizar o recurso de copiar e colar entre as Associaes das propriedades. A opo Copiar Associao copia a Associao da linha selecionada e a opo Colar Associao cola a Associao na linha selecionada, substituindo a Associao anterior.
Assoc ia es
241
242
Assoc ia es
10
Viewer
O objeto Viewer disponibiliza a visualizao da aplicao. Permite visualizar Telas do projeto em modo de execuo e a operao do sistema. O Viewer pode ser rodado a partir de qualquer ponto da rede que tenha acesso ao E3 Server. No necessrio copiar o aplicativo para os outros Viewers, pois as Telas e bitmaps so baixados conforme a necessidade em tempo de execuo. S poder existir um objeto Viewer em um Domnio.
CAPTULO
Viewer no modo Domnio Para criar um Viewer no projeto, siga estes procedimentos: 1. Verifique se j existe um Viewer em seu Domnio, ou insira um novo clicando com o boto direito do mouse no nome do projeto no Explorer e selecionando a opo Inserir - Viewer. No modo Domnio, clique com o boto direito do mouse no item Visualizao - Viewer e Quadros, selecione a opo Inserir Viewer em e logo aps o nome do projeto desejado.
NOTA : A qualidade grfica das Telas pode ser modificada, em tempo de execuo, utilizandose o menu contextual do Viewer e selecionando uma das opes do menu Qualidade (todas as telas). Para maiores informaes, veja a propriedade RenderQuality do Viewer no Manual de Scripts do E3 .
V iew er
243
10.1.1 Visualizador
Atravs da aba Visualizador, so configuradas as opes do Viewer quanto a ttulo, Tela e zoom, conforme explicado a seguir.
Aba Visualizador Cada campo da aba Visualizador possui uma propriedade correspondente. As opes disponveis so as seguintes: Opes disponveis na aba Visualizador OPO Ttulo DESCRIO Determina o ttulo do Viewer. Este campo equivale propriedade Caption do objeto Viewer.
244
V iew er
DESCRIO Determina a Tela ou Quadro que o Viewer ir iniciar. Clicando no boto , o sistema abre uma janela de configurao, pela qual chamar o AppBrowser, onde ser especificada a Tela inicial de visualizao do sistema. Este campo equivale propriedade InitialScreen do objeto Viewer.
Zoom
Determina o nvel de zoom para visualizao no Viewer. Atravs das suas opes, possvel configurar como o Viewer ser inicializado. Este campo equivale propriedade InitialScreen do objeto Viewer, e representado pelas especificaes aps o caractere "?" . Por exemplo, se na Tela inicial o zoom de 100%, na propriedade InitialScreen aparecer descrio TelaInicial?100 , onde TelaInicial o nome da Tela e ?100 a sua percentagem de zoom. Habilita a barra de rolagem na pgina inicial. Habilita a exibio do menu Zoom com o boto direito do mouse, em tempo de execuo. Este campo equivale propriedade EnableZoomMenu do objeto Viewer. Habilita o Viewer a manter as Telas carregadas em memria. Este campo equivale propriedade CacheEnable do objeto Viewer. Define o tempo mximo de espera, em minutos, por um evento de mouse ou de teclado para o perodo de inatividade. Este campo equivale propriedade EnableInactivity do objeto Viewer. Estabelece o nmero de vezes que a caixa de dilogo de login ser exibida alm da primeira vez. Este campo equivale propriedade LoginRetries do objeto Viewer.
Habilitar barra de rolagem na Tela Inicial Exibir o menu do Zoom ao clicar com o boto direito do mouse
V iew er
245
10.1.2 Configurao
Atravs da aba Configurao, pode-se editar as opes relativas janela, ao ttulo e resoluo do Viewer.
Aba Configurao Cada campo da aba Configurao possui uma propriedade correspondente. As opes disponveis so as seguintes:
246
V iew er
Opes disponveis na aba Configurao OPO Iniciar Maximizada / Minimizada / Janelada DESCRIO Determina o estilo da janela do Viewer. Este campo equivale propriedade WindowStyle e possui as seguintes opes: 0 - Maximized: A Tela inicia maximizada 1 - Windowed: Estilo janelada, isto , pode ser configurada a altura e a largura da Tela 2 - Minimized: A Tela inicia minimizada Desabilitar troca de janelas Desabilita a troca de janelas. Este campo equivale propriedade DisableTaskSwitching do objeto Viewer. Esta opo pode ser modificada em tempo de execuo usando o mtodo SetDisableTaskSwitching. Habilita a barra de ttulo. Este campo equivale propriedade TitleBar do objeto Viewer. Habilita o boto de fechar. Este campo equivale propriedade CloseButton do objeto Viewer. Habilita o boto de minimizar. Este campo equivale propriedade MinimizeButton do objeto Viewer. Habilita o boto de maximizar. Este campo equivale propriedade MaximizeButton do objeto Viewer. Habilita uma borda na janela do Viewer. Este campo equivale propriedade WindowBorder do objeto Viewer. Indica se a janela pode ser redimensionada. Esta opo s tem validade se a opo Borda estiver marcada. Este campo equivale propriedade WindowResizable do objeto Viewer. Indica se a janela pode ser movida. Este campo equivale propriedade WindowMovable do objeto Viewer.
Barra de ttulo
Boto de fechar
Boto de minimizar
Boto de maximizar
Borda
Opo de redimensionar
Opo de mover
V iew er
247
DESCRIO Indica se a janela deve sempre se sobrepor s outras janelas. Este campo equivale propriedade WindowStayOnTop do objeto Viewer. Habilita uma barra de ttulos pequena na janela. Esta opo s tem efeito se a opo Barra de ttulo estiver marcada. Este campo equivale propriedade WindowSmallTitle do objeto Viewer. Seleciona a resoluo da Tela: 640 x 480, 800 x 600, 1024 x 768, 1280 x 1024, ou 1600 x 1200 pixels. Abre a janela para configuraes avanadas.
Resoluo da Tela
Avanado
248
V iew er
Opes disponveis na janela Configuraes Avanadas OPO Resoluo da Tela em pixels DESCRIO Permite escolher entre a resoluo atual do computador ou uma resoluo escolhida pelo usurio, em pixels. Permite escolher o desconto aplicado na resoluo da Tela entre a configurao atual do computador ou uma resoluo escolhida pelo usurio, em pixels. Permite escolher entre a resoluo atual do computador ou um resoluo escolhida pelo usurio, em pontos por polegada (DPI).
Aba Erros de comunicao As opes disponveis nesta aba so as seguintes: Opes disponveis na aba Erros de Comunicao OPO Visualizar erros de comunicao DESCRIO Habilita ou desabilita a visualizao dos erros de comunicao.
V iew er
249
OPO Texto
DESCRIO Contm o texto que ser mostrado no SetPoint, caso a qualidade do valor seja ruim. Contm a cor que deve ser usada no texto. Contm a cor que deve ser usada no SetPoint. Equivale a uma alterao da propriedade ForegroundColor do SetPoint, mas essa alterao no feita efetivamente. O valor da propriedade do SetPoint no alterado.
importante salientar que a associao para o Viewer deve levar o nome real do Viewer (ex: Viewer1 ) e no simplesmente Application . Em scripts, ainda vale o uso de Application, que uma propriedade de todos os objetos que retornam o Viewer.
250
V iew er
Objeto _top 2. Para configurar as propriedades do objeto Top, clique com o boto direito do mouse sobre o mesmo e selecione a opo Propriedades. 3. Este objeto possui as mesmas funcionalidades do objeto Divisor do Quadro, e tais informaes podem ser encontradas nos captulos Telas e Quadros.
V iew er
251
Inserindo Pasta do Viewer NOTA : Uma aplicao que contenha Pastas do Viewer no poder ser aberta em verses do E3 anteriores verso 3.1.
252
V iew er
11
CAPTULO
Banco de Dados
O Banco de Dados do E3 utilizado para armazenar as informaes do projeto referentes a Histricos, Frmulas, Alarmes e Storage. Suporta os formatos Access (.mdb), Oracle e Microsoft SQL Server. Para utilizar este recurso, clique com o boto direito do mouse sobre o nome do projeto no Explorer e selecione a opo Inserir - Banco de Dados. No modo Domnio, clique com o boto direito do mouse no item Objetos de Servidor - Banco de Dados, selecione a opo Inserir Banco de Dados em e logo aps o nome do projeto desejado.
Inserindo um Banco de Dados no modo Domnio Ao inserir o Banco de Dados no sistema, so habilitadas as opes referentes ao tipo de Servidor de Banco de Dados, atravs da aba Configurao na Janela de Propriedades, ou da propriedade SourceType , na Lista de Propriedades. Algumas das propriedades deste objeto podem ser configuradas atravs da Lista de Propriedades, sem a necessidade da criao de scripts para isto. Para isto, basta localiz-la e efetuar os devidos ajustes. Demais informaes sobre as funcionalidades das propriedades deste objeto podem ser encontradas no Manual de Referncia de Scripts do E3 , em seu captulo respectivo. Banc o de Dados 253
NOTA : o objeto Banco de Dados pode ser configurado para funcionar como rea de Alarme .
Configuraes para Banco de Dados Access As opes disponveis nesta aba so: Opes disponveis na aba Configurao OPO Banco de Dados DESCRIO Seleciona o tipo de Banco de Dados em uso no projeto: 0 - stAccess; 1 - stOracle ; ou 2 stSqlServer. Nome do arquivo .mdb utilizado no projeto. Senha do Banco de Dados Access.
254
Banc o de Dados
OPO Usurio
DESCRIO Usurio do Banco de Dados conectado pelo E3. Senha do usurio que realizar o logon. Testa a conexo com o Banco de Dados.
3. No campo Banco de Dados, selecione a opo 0 - stAccess. 4. Insira o nome do arquivo desejado (existente ou no) no campo Arquivo MDB (conforme figura anterior). 5. Caso seja necesssrio, configure as opes Usurio, Senha e Senha do BD de acordo com as definies do Access. Tais itens podem ficar em branco; neste caso, o sistema assume as configuraes padro do E3. 6. Clique no boto OK para finalizar as configuraes.
Banc o de Dados
255
Configuraes para Banco de Dados Oracle As opes disponveis nesta aba so: Opes disponveis na aba Configurao OPO Banco de Dados DESCRIO Seleciona o tipo de Banco de Dados em uso no projeto: 0 : stAccess 1 : stOracle 2 : stSqlServer Conexo Nome da conexo fornecido pelo administrador do banco. Permite utilizar o tipo de dados TIMESTAMP do Oracle, com preciso de milissegundos e disponvel a partir da verso 9.0. Caso esta opo esteja desabilitada, usado o tipo de dados DATE, com preciso de segundos. NOTA : Para que o objeto Consulta do E3 seja compatvel com tabelas que utilizem o tipo de dados TIMESTAMP, deve ser habilitada a opo Usar drivers ADO Oracle .
256
Banc o de Dados
DESCRIO Permite usar as interfaces ADO (ActiveX Data Objects) do Oracle para que o objeto Consulta do E3 reconhea o tipo de dados TIMESTAMP. Assim possvel ler registros de tabelas do Oracle que possuam preciso de milissegundos. Usurio do Banco de Dados conectado pelo E3. Senha do usurio que realizar o logon. Testa a conexo com o Banco de Dados.
Usurio
3. No campo Banco de Dados, selecione a opo 1 - stOracle . 4. Se o servidor Oracle for local, o campo Conexo pode ficar em branco, pois o E3 recupera os dados automaticamente. Do contrrio, a conexo ser criada usando o cliente Oracle instalado na mquina. 5. Caso seja necessrio, configure as opes Usurio e Senha de acordo com as definies do Oracle. Tais itens podem ficar em branco; neste caso, o sistema assume as configuraes padro do E3. 6. Clique no boto OK para finalizar as configuraes. Ao inserir o Banco de Dados no sistema, so habilitadas as opes referentes ao tipo de Servidor de Banco de Dados. O Servidor de Banco de Dados o responsvel pelo gerenciamento e armazenamento das informaes dos objetos que utilizam esse servio.
Banc o de Dados
257
Depois da criao da conexo, possvel executar um comando SQL diretamente sobre a conexo, como mostrado a seguir:
DBConnection.Execute _ "UPDATE Tabela SET nome = 'Joo' WHERE id = 10"
possvel tambm a visualizao de todos os registros desejados, retornados na forma de um Recordset (consulta), como mostrado a seguir:
Set Recordset = CreateObject("ADODB.Recordset") Recordset.Source = "Tabela" Recordset.ActiveConnection = DbConnection Recordset.CursorType = 1 ' adOpenKeyset Recordset.LockType = 3 ' adLockOptimistic Recordset.Open
A partir deste momento, possvel navegar pela tabela utilizando-se os comandos MoveNext e MovePrevious, bem como uma srie de outros comandos fornecidos pelo ADO. possvel tambm utilizar uma consulta SQL para manipular partes especficas da tabela, atravs da propriedade Source .
armazenados em arquivo ou em memria temporrios. Ao mesmo tempo, o Banco de Dados possui mais um outro processo, responsvel pela recuperao das aquisies e posterior envio para o banco de dados em forma de comandos SQL, utilizando a OCI.
Configuraes para o Banco de Dados SQL Server As opes disponveis nesta aba so: Opes disponveis na aba Configurao OPO Banco de Dados DESCRIO Seleciona o tipo de Banco de Dados em uso no projeto: 0 - stAccess; 1 - stOracle ; ou 2 stSqlServer. Nome do servidor. Nome do Banco de Dados. Biblioteca de rede utilizada pelo ADO: 0 Padro; 1 - Named Pipes; 2 - Winsock TCP/IP, 3 - SPX/IPX; 4 - Banyan Vines; ou 5 - MultiProtocol (RCP). Usurio do Banco de Dados conectado pelo E3. Dependendo do tipo de objeto a ser utilizado no projeto, dever ter diferentes tipos de permisso. Senha do usurio que realizar o logon. Testa a conexo com o Banco de Dados.
Usurio
260
Banc o de Dados
4. Caso seja necessrio, configure as opes Usurio e Senha de acordo com as definies do SQL Server. Tais itens podem ficar em branco; neste caso, o sistema assume as configuraes padro do E3. 5. Clique no boto OK para finalizar as configuraes.
Histrico e suas configuraes 5. Acesse as propriedades do Histrico atravs do boto (Propriedades do Histrico) e determine o servidor de Banco de Dados e o nome da tabela. As demais configuraes devem permanecer inalteradas. A tabela servir para a busca de dados no E3 e tambm para visualizar o uso da ferramenta SQL Server Analyzer, que o cliente usado para consultas no SQLServer. 6. Finalizada a configurao do Histrico, ser necessria a criao da estrutura de tabelas no Servidor de Banco de Dados. Para isso, utilize o boto (Gerar estrutura no BD). Uma mensagem de confirmao da criao da estrutura de tabelas ser mostrada na tela. Caso haja algum erro, deve-se localizar o problema. 7. Para visualizar o Histrico em ao (salvando dados no servidor SQL Server), crie uma Tela, insira um E3Browser e configure-o para acessar o Servidor de Banco de Dados, como explicado anteriormente no Histrico, e configure o E3Browser para ser atualizado automaticamente a cada 10 segundos, por exemplo. 8. Feitas as configuraes, execute o projeto. Depois de um tempo executando o projeto, o Banc o de Dados 261
E3Browser passar a exibir os dados que esto sendo enviados ao servidor. 9. possvel consolidar os dados que sero mostrados no E3 e os que esto salvos no servidor utilizando o objeto Consultas do E3Browser e o software SQL Query Analyzer. Para isso, crie diferentes consultas no Banco de Dados e edite-as na Consulta e tambm no Query Analyzer. Os resultados devero ser os mesmos, se o Domnio estiver parado, ou semelhantes, se o Domnio estiver rodando. Essa diferena deve-se atualizao constante do Banco de Dados quando o Domnio est sendo executado. Para a edio de consultas no objeto Consulta, habilite a opo Habilita edio direta do SQL .
O uso desse tipo de acesso deve ser restrito a casos onde no exista outra soluo. O E3 disponibiliza recursos que visam minimizar o uso desses acessos via script. Entretanto, eventualmente o uso desse recurso pode ser necessrio.
Nas permisses, a expresso Permisso completa significa que o usurio ter permisses para: Criar ou remover tabelas existentes Criar ndices e chaves Inserir e excluir dados nas tabelas criadas Consultas sobre as tabelas resultantes
262
Banc o de Dados
O usurio no precisa ser um Administrador para possuir Permisso Completa em qualquer objeto.
Banc o de Dados
263
12
CAPTULO
Alarmes
O E3 dispe de um conjunto de objetos que permite ao usurio monitorar alarmes em sua aplicao. Com eles, possvel especificar e gerenciar alarmes e eventos de variveis de um processo. As condies de alarme podem ser gerenciadas em diversas fontes. O sistema composto de um objeto centralizador de alarmes, chamado Servidor de Alarmes, e de um ou mais objetos de configurao, chamado Configurao de Alarmes. As sees a seguir detalharo estes objetos.
264
Alarmes
Caso haja necessidade, novas reas podem ser inseridas dentro de outras. Para inserir este objeto, siga este procedimento: 1. Clique com o boto direito do mouse no objeto Configurao de Alarmes ou no objeto rea do projeto no Explorer, e escolha a opo Inserir - rea. No modo Domnio, clique com o boto direito do mouse no objeto Configurao de Alarmes e selecione o item Inserir - rea.
Alarmes
265
Inserindo uma rea de Alarme Algumas das propriedades deste objeto podem ser configuradas atravs da Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes. Demais informaes sobre as funcionalidades das propriedades deste objeto podem ser encontradas no Manual de Referncia de Scripts do E3 , em seu captulo respectivo.
266
Alarmes
Aba rea de Alarmes As opes disponveis nesta aba so as seguintes: Opes disponveis na aba rea de Alarmes OPO Funcionar como rea de alarmes DESCRIO Habilita ou desabilita o comportamento de rea de Alarme para o objeto de Servidor. Esta opo corresponde propriedade IsAlarmArea. Habilita ou desabilita a verificao de alarmes no objeto. Esta opo corresponde propriedade AlarmVerify. Veja o tpico Configuraes dos Campos do Usurio para maiores informaes.
Verificar alarmes
Campos do usurio
Alarmes
267
268
Alarmes
Alarmes
269
Configuraes do Servidor de Alarmes Cada campo da aba Configurao possui uma propriedade correspondente. As opes disponveis so as seguintes: Opes disponveis na aba Configurao OPO Guarde alarmes no Banco de Dados DESCRIO Habilita ou desabilita o armazenamento dos dados dos alarmes no Banco de Dados. Este campo equivale propriedade Logging. Define o servidor de Banco de Dados que armazenar os dados do alarme. Este campo equivale propriedade DataSource . Define o nome da tabela de alarmes. Este campo equivale propriedade TableName . Habilita ou desabilita o descarte de dados da tabela principal. O dado ser considerado antigo de acordo com o que for definido na opo Mantenha os dados do(s) ltimo(s). Este campo equivalente propriedade EnableDiscard.
Nome da Tabela
270
Alarmes
OPO Mantenha os dados do(s) ltimo(s) ... < Tabela Principal >
DESCRIO Determina o intervalo de tempo (minutos, horas, dias ou meses) durante o qual os dados sero mantidos na tabela principal. Se um dado da tabela for mais antigo que o intervalo de tempo desta opo, ele ser descartado. Este campo equivale propriedade DiscardInterval, e o campo de seleo da unidade de tempo do intervalo equivale propriedade DiscardTimeUnit. Faz a verificao dos alarmes, conforme o perodo especificado no campo (em minutos, horas, dias ou meses). Este campo equivale propriedade VerificationInterval, e o campo de seleo da unidade de tempo do intervalo equivale propriedade VerificationUnit. Habilita ou desabilita o armazenamento dos dados descartados na tabela secundria (tabela de backup ). Este campo equivale propriedade EnableBackupTable . Determina o intervalo de tempo (minutos, horas, dias ou meses) durante o qual os dados sero mantidos na tabela de backup . Este intervalo deve ser sempre maior que o configurado no item Mantenha os dados do(s) ltimo(s) da Tabela Principal. Este campo equivale propriedade BackupDiscardInterval, e o campo de seleo da unidade de tempo do intervalo equivale propriedade BackupDiscardTimeUnit. Determina quais campos dos eventos de alarme sero adicionados tabela de alarmes, e qual a ordem em que estas colunas aparecero. Gera a tabela dos alarmes no Banco de Dados especificado.
Campos
Gerar Tabela
Alarmes
271
Opes disponveis para tabelas dos Campos dos alarmes OPO Acked DESCRIO Informa se o alarme foi reconhecido ou no. Este campo pode assumir os seguintes valores: 0 - no reconhecido; 1 - reconhecido. Determina o reconhecimento automtico do alarme. Este campo apresenta os seguintes valores: 0 - reconhecimento automtico; 1 reconhecimento manual. Registra a data e hora do E3 no momento em que o alarme reconhecido, ou zero (30/12/1899), enquanto o alarme no tenha sido reconhecido. No caso de alarmes que no pedem reconhecimento, o campo assume a data e hora do E3 no momento em que o alarme torna-se ativo. Semelhante ao campo anterior. usado para facilitar a gravao de dados do tipo Double no caso de bancos de dados Oracle ou SQL Server. Nome do operador que reconheceu o alarme. Pode ser: O usurio logado no Viewer, quando o reconhecimento feito no E3 Alarm (ou "Sem usurio", se no h usurio logado) "System", quando o reconhecimento automtico (ou seja, para alarmes que pedem reconhecimento) Um nome passado por script (por exemplo, usando AckArea, AckAllAlarms ou LogTrackingEvent do Servidor de Alarmes, ou Ack da Fonte de Alarmes) O limite deste campo, quando armazenado no Banco de Dados, de 50 caracteres. AlarmSourceName Registra o nome da Fonte de Alarme. O limite deste campo, quando armazenado no Banco de Dados, de 100 caracteres. Por exemplo, FonteAlarme1 .
AckRequired
AckTime
AckTimeDbl
ActorID
272
Alarmes
OPO Area
DESCRIO Para eventos de alarme, o nome da rea a qual a Fonte de Alarmes pertence. Para outros eventos (por exemplo, usando o mtodo LogTrackingEvent do Servidor de Alarmes), pode ser um texto definido pelo usurio. O limite deste campo, quando armazenado no Banco de Dados, de 100 caracteres. No usado (o valor sempre 0). Indica se a Fonte de Alarme est em alarme. Este campo apresenta os seguintes estados: 0 - condio no ativa; 1 - condio ativa. Nome da condio, se for um evento de alarme. Este campo pode apresentar os seguintes valores: Banda Morta: Fonte de Alarme do tipo Banda Morta Digital: Fonte de Alarme do tipo Digital Nvel: Fonte de Alarme do tipo Analgico TaxaDeVariao: Fonte de Alarme do tipo Taxa de Variao Se o evento no for um alarme (por exemplo, usando o mtodo LogTrackingEvent do Servidor de Alarmes), este valor ser sempre uma String vazia.O limite deste campo, quando armazenado no Banco de Dados, de 100 caracteres.
ChangeMask ConditionActive
ConditionName
Cookie
Valor associado Fonte de Alarme, usado internamente pelo Servidor de Alarmes. Determina o valor da Fonte de Alarme (convertido para Double ) no momento do evento. Para outros eventos (por exemplo, usando o mtodo LogTrackingEvent), o valor ser sempre zero (0). O limite deste campo, quando armazenado no Banco de Dados, de 100 caracteres.
CurrentValue
Alarmes
273
OPO Enabled
DESCRIO Determina se a verificao do alarme est habilitada. Este campo apresenta os seguintes estados: 0 - verificao da fonte de alarmes desabilitada; 1 - verificao da fonte de alarme habilitada. Categoria do evento. Para alarmes, este campo pode assumir os seguintes valores: Banda Morta: Fonte de Alarme do tipo Banda Morta Digital: Fonte de Alarme do tipo Digital Nvel: Fonte de Alarme do tipo Analgico TaxaDeVariao: Fonte de Alarme do tipo Taxa de Variao Para outros eventos (por exemplo, usando o mtodo LogTrackingEvent do Servidor de Alarmes), o campo pode assumir valores definidos pelo usurio. O limite deste campo, quando armazenado no Banco de Dados, de 100 caracteres.
EventCategory
EventCLSID
Identificador nico para toda a vida de um alarme. Quando um alarme novo ocorre em uma Fonte, gerado um novo nmero de EventCLSID; assim, ele ir manter esse mesmo CLSID no banco de dados enquanto no sair da lista de alarmes ativos e no reconhecidos. Data e hora do valor da Fonte de Alarme no momento do evento. Semelhante ao campo anterior. usado para facilitar a gravao de dados do tipo Double no caso de bancos de dados Oracle ou SQL Server. Data e hora do valor da Fonte de Alarme no momento do evento, com relao ao horrio de Greenwich. O valor o mesmo do campo EventTime , sendo mantido no E3 por questes de compatibilidade.
EventTime
EventTimeDbl
EventTimeUTC
274
Alarmes
OPO EventType
DESCRIO Tipo do evento. Para eventos de alarme, sempre Condition. Para outros eventos, pode ser um texto definido pelo usurio, como por exemplo, usando o mtodo LogTrackingEvent do Servidor de Alarmes ("Tracking", "Simple", etc.). O limite deste campo, quando armazenado no Banco de Dados, de 100 caracteres. Mostra o valor formatado da Fonte de Alarme que vai para o seu evento. O limite deste campo, quando armazenado no Banco de Dados, de 100 caracteres. NOTA : Este campo somente de leitura. Registra o caminho completo da Fonte de Alarme, incluindo reas, nome da Configurao de Alarmes e de possveis Pastas onde esta possa estar inserida. Por exemplo, Pasta1.ConfigAlarmes1. Area1.FonteAlarme1 . Registra a data e hora do valor, no momento em que ele entra na condio de alarme. Semelhante ao campo anterior. usado para facilitar a gravao de dados do tipo Double no caso de bancos de dados Oracle ou SQL Server. o texto configurado na Fonte de Alarme, ou especificado por um outro evento (por exemplo, usando o mtodo LogTrackingEvent do Servidor de Alarmes). O limite deste campo, quando armazenado no Banco de Dados, de 200 caracteres. Registra a data e hora do valor no momento em que ele sai da condio de alarme; ou zero (30/12/1899), enquanto o alarme ainda no tenha sado da condio ativa. Semelhante ao campo anterior. usado para facilitar a gravao de dados do tipo Double no caso de bancos de dados Oracle ou SQL Server.
FormattedValue
FullAlarmSourceName
InTime
InTimeDbl
Message
OutTime
OutTimeDbl
Alarmes
275
OPO Quality
DESCRIO Qualidade do valor de Fonte de alarme no momento do evento. Este campo assume os seguintes valores numricos: 0 - 63 : qualidade ruim 64 - 127 : qualidade incerta 128 - 191 : valor no definido 192 - 255 : qualidade boa Se o evento no for um alarme (por exemplo, se ele estiver usando o mtodo LogTrackingEvent do Servidor de Alarmes), este campo ser igual a uma String vazia. Exemplo: Ruim (0); Incerta (64); ?? (128); Boa (192).
Severity
o valor de severidade configurado na Fonte de Alarme. Este campo pode assumir os seguintes valores: 0 - alta; 1 - mdia; 2 - baixa. Ele pode tambm assumir outro valor definido pelo usurio se for um evento, como por exemplo quando estiver usando o mtodo LogTrackingEvent. Para eventos de alarme, informa a expresso utilizada para avaliar as condies de alarme. O limite deste campo, quando armazenado no Banco de Dados, de 100 caracteres. Por exemplo, Dados. TagDemo1.Value .
Source
276
Alarmes
OPO SubConditionName
DESCRIO Nome da subcondio, se for um evento de alarme. Este campo pode assumir os seguintes valores: BM : Alarme de Banda Morta DIG: Alarme Digital TV : Alarme Taxa de Variao LOLO: Alarme Analgico na faixa Muito Baixo LO: Alarme Analgico na faixa Baixo HI: Alarme Analgico na faixa Alto HIHI: Alarme Analgico na faixa Muito Alto Se o evento no for um alarme (por exemplo, se ele estiver usando o mtodo LogTrackingEvent do Servidor de Alarmes), este campo ser igual a uma String vazia. O limite deste campo, quando armazenado no Banco de Dados, de 100 caracteres.
Campos do Usurio
So os campos definidos pelo usurio. Estes campos so configurados na aba Campos do usurio, no Servidor de Alarmes.
NOTAS: necessrio que haja um Servidor de Alarmes no Domnio, para que seja possvel o monitoramento de alarmes Os campos EventTimeMS, InTimeMS, OutTimeMS e AckTimeMS contm os valores em milissegundos dos campos EventTime , InTime , OutTime e AckTime , respectivamente. Estes campos sero usados quando for necessrio registrar o tempo (em ms) dos eventos em um servidor de bancos de dados Oracle. Observe que estes campos no esto disponveis no E3Alarm, pois neste objeto possvel visualizar os milissegundos atravs da formatao das colunas de Data e Hora
Depois de definidas todas as configuraes, o sistema inicializa a insero e gravao das informaes na tabela dos alarmes, conforme as especificaes dos campos. Ao clicar em Gerar tabela, o sistema gera a tabela de dados dos alarmes conforme as especificaes, e informa se a tabela foi gerada com sucesso.
Alarmes
277
Mensagem do Servidor de Alarmes A estrutura da tabela dos alarmes semelhante do Histrico: composta por uma tabela de definies, uma tabela principal de dados e uma tabela de backup (opcional).
Tabela Fields Os campos gerados na tabela so explicados no tpico Configuraes da Tabela do captulo Histrico. Atravs da janela de configurao do Servidor de Alarmes, pode-se especificar o Servidor de Banco de Dados utilizado para a gravao dos alarmes. O Servidor de Banco de Dados (objeto DBServer) um mdulo do E3 que deve ser inserido em sua aplicao.
278
Alarmes
Aba Campos do usurio As opes disponveis so as seguintes: Opes disponveis na aba Campos do usurio OPO Campo Nome Tipo DESCRIO Identificador do campo. Determina o nome do campo. Determina o tipo do campo (Text, Integer, DateTime ou Double ). Determina o tamanho do campo. Determina a fonte de dados do alarme.
Tamanho Fonte
NOTA : O objeto Fonte de Alarme pode ser criado dentro de qualquer objeto do Servidor. Alarmes 279
Para inserir este objeto, siga este procedimento: 1. Clique com o boto direito do mouse no objeto de Servidor no Explorer, e escolha a opo Inserir - Alarme (Analgico, Banda Morta, Taxa de Variao, Digital ou Discreto). No modo Domnio, selecione o objeto desejado no item Objetos de Servidor e selecione a opo Inserir - Alarme (Analgico, Banda Morta, Taxa de Variao, Digital ou Discreto).
Inserindo uma Fonte de Alarme Algumas das propriedades deste objeto podem ser configuradas atravs da Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes. Demais informaes sobre as funcionalidades das propriedades deste objeto podem ser encontradas no Manual de Referncia de Scripts do E3 , em seu captulo respectivo. Em cada subcondio de alarme so configurados seus limites, a mensagem relativa ao evento, sua severidade e a necessidade ou no de reconhecimento deste evento.
280
Alarmes
Fontes de Alarmes Ao abrir a janela de Propriedades de qualquer Fonte de Alarme e escolher a aba Fonte , a seguinte janela aberta:
Aba Fonte Para tratar o alarme como evento, ou para que o alarme possa ser reconhecido duplamente (tanto quando estiver ativo como quando passar para inativo), basta clicar na caixa de seleo correspondente acima. Todas as Fontes de Alarme possuem as seguintes propriedades gerais: Texto da Mensagem: Esta mensagem ser armazenada no campo Mensagem do evento de alarme enquanto ele estiver ativo. Ou seja, poder ser visualizada no E3Alarm (sumrio de alarmes), armazenada no Banco de dados, etc. O limite do texto da mensagem de 200 caracteres Alarmes 281
Severidade : Indica a gravidade do alarme ocorrido (Baixa, Mdia ou Alta). O campo Severidade utilizado para realizao de filtros e ordenao nas mensagens Pede Ack: Indica se o alarme deve ser reconhecido pelo operador para ser retirado da lista de alarmes no E3Alarm, ou se ser reconhecido automaticamente quando a varivel deixa uma condio de alarme Volta ao normal: Essa mensagem ser armazenada no campo Mensagem do evento de alarme enquanto este estiver inativo. Ou seja, poder ser visualizada no E3Alarm (sumrio de alarmes), armazenada em um Banco de Dados, etc.
H vrios tipos de Fontes de Alarme que podem ser inseridas em objetos do Servidor. As opes disponveis so descritas nas prximas sees.
12.3.1 Analgico
Permite monitorar uma varivel analgica, pela especificao de at quatro nveis de alarme, que so o LoLo (Muito Baixo), Lo (Baixo), Hi (Alto) e HiHi (Muito Alto).
Aba Analgico As opes disponveis so as seguintes: Opes disponveis na aba Analgico OPO Habilitao (LoLo, Lo, Hi, HiHi) DESCRIO Habilita a verificao do tipo de alarme escolhido. Indica o nvel em que o alarme ser disparado.
Limite
282
Alarmes
DESCRIO Permite especificar o texto que ser mostrado para o usurio, quando o alarme estiver em condio ativa. Determina a severidade do nvel de alarme (pode ser Alta, Mdia ou Baixa). Habilita ou desabilita o reconhecimento do alarme. Habilita ou desabilita o tratamento de cada subcondio do alarme como um evento. Especifica o tempo de espera, em ms. Quando o valor for 0 (padro), no aplicada nenhuma espera. Habilita a banda morta, que um recurso utilizado para evitar que uma varivel, ao manter uma pequena oscilao em torno de um limite de alarme, gere uma quantidade desnecessria de mensagens. Permite especificar o texto a ser mostrado para o usurio, quando o alarme no estiver em condio ativa.
Severidade
Pede Ack
Evento
Espera
Banda morta
Volta ao normal
12.3.2 Digital
Permite monitorar uma varivel digital, pela especificao de alarme na borda de subida (em -1 ou Verdadeiro) ou na borda de descida (em 0 ou Falso).
As opes disponveis so as seguintes: Opes disponveis na aba Digital OPO Alarme Digital Valor DESCRIO Habilita o alarme digital. Determina o valor Booleano do alarme (Verdadeiro ou Falso). Permite especificar o texto que ser mostrado para o usurio, quando o alarme estiver em condio ativa. Determina a severidade do nvel de alarme (pode ser Alta, Mdia ou Baixa). Habilita ou desabilita o reconhecimento do alarme. Especifica o tempo de espera, em ms. Quando o valor for 0 (padro), no aplicada nenhuma espera. Permite especificar o texto a ser mostrado para o usurio, quando o alarme no estiver em condio ativa.
Texto da mensagem
Severidade
Pede Ack
Espera (ms)
Volta ao normal
Banda morta Este tipo de alarme interessante quando a referncia (SetPoint) varivel, e tambm 284 Alarmes
quando se deseja evitar uma quantidade desnecessria de alarmes para pequenas oscilaes da varivel monitorada.
Aba Banda Morta As opes disponveis so as seguintes: Opes disponveis na aba Banda Morta OPO SetPoint DESCRIO Associao para a varivel de referncia, para que seja monitorada uma diferena em relao varivel de monitoramento. Habilita a banda morta, que um recurso utilizado para evitar que uma varivel, ao manter uma pequena oscilao em torno de um limite de alarme, gere uma quantidade desnecessria de mensagens. Indica a diferena entre a varivel monitorada e o SetPoint, a partir do qual deve ser indicado o alarme. Deve ser informado em unidades de engenharia da varivel monitorada. Permite especificar o texto que ser mostrado para o usurio quando o alarme estiver em condio ativa. Determina a severidade do nvel de alarme (pode ser Alta, Mdia ou Baixa). Habilita ou desabilita o reconhecimento do alarme. 285
BM
Valor
Texto da mensagem
Severidade
Pede Ack
Alarmes
DESCRIO Especifica o tempo de espera, em ms. Quando o valor for 0 (padro), no aplicada nenhuma espera. Permite especificar o texto a ser mostrado para o usurio quando o alarme no estiver em condio ativa.
Volta ao normal
Aba Taxa de Variao As opes disponveis so as seguintes: Opes disponveis na aba Taxa de Variao OPO TDV DESCRIO Habilita a verificao do alarme Taxa de Variao. Indica a porcentagem da varivel monitorada que pode variar por segundo. Este valor calculado tomando como base cada intervalo de leitura da varivel, pela frmula: TDV = (Valor Atual - Valor Anterior) / (Instante Atual - Instante Anterior). Se a taxa de variao for maior que a taxa especificada, ser considerado em estado de alarme.
Variao p/seg
286
Alarmes
DESCRIO Permite especificar o texto que ser mostrado para o usurio quando o alarme estiver em condio ativa. Determina a severidade do nvel de alarme (pode ser Alta, Mdia ou Baixa). Habilita ou desabilita o reconhecimento do alarme. Especifica o tempo de espera, em ms. Quando o valor for 0 (padro), no aplicada nenhuma espera. Determina a mensagem de texto que ser mostrada ao usurio quando o alarme voltar ao estado normal.
Severidade
Pede Ack
Espera (ms)
Volta ao normal
12.3.5 Discreto
Permite monitorar uma varivel pela especificao de mltiplas subcondies.
Aba Discreto As opes disponveis nesta aba so as seguintes: Opes disponveis na aba Discreto OPO Boto DESCRIO Adiciona uma nova Subcondio no alarme.
Alarmes
287
DESCRIO Remove a Subcondio selecionada. Permite mapear e sincronizar as Subcondies do Alarme a partir de semnticas presentes no objeto fonte. Este recurso atualmente s suportado pelos objetos de servidor do Elipse Power, portanto este boto permanece desabilitado por padro no Elipse E3. Nome da Subcondio. Habilita ou desabilita a Subcondio. Descrio da Subcondio. Valor avaliado para determinar se o alarme ocorre ou no. Mensagem mostrada quando a Subcondio est ativa. Comportamento da Subcondio. Pode assumir os seguintes valores: 0 - Alarme; 1 Evento; 2 - Retorno. O tipo de severidade da Subcondio. Pode assumir os seguintes valores: 0 - Alta; 1 Mdia; 2 - Baixa. Indica se esta Subcondio exige reconhecimento. Especifica o tempo de espera, em ms. Quando o valor for 0 (padro), no aplicada nenhuma espera. Permite especificar o texto a ser mostrado para o usurio quando o alarme no estiver em condio ativa.
Texto da mensagem
Tipo
Severidade
Pede Ack?
Espera (ms)
Volta ao normal
288
Alarmes
13
CAPTULO
E3Alarm
O E3Alarm serve para monitoramento dos alarmes ativos ou no reconhecidos no sistema. Atravs deste objeto, possvel verificar o estado dos alarmes no sistema, bem como reconhec-los manualmente.
E3Alarm Para utilizar este objeto, siga estes procedimentos: 1. Insira este objeto no projeto atravs do clique com o boto direito do mouse em uma Tela ou na rea de trabalho e selecione a opo Inserir - E3Alarm, ou ento atravs da barra de ferramentas Objeto, selecionando o boto E3Alarm.
E3Alarm
289
Inserindo um E3Alarm Algumas das propriedades deste objeto podem ser configuradas atravs da Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes.
Cada campo da aba Geral possui uma propriedade correspondente. As opes disponveis so as seguintes: Opes disponveis na aba Geral OPO Nome do Servidor de Alarmes DESCRIO Determina o nome do Servidor de Alarmes. importante informar este campo, caso contrrio o E3Alarm no mostrar os alarmes e informar uma mensagem de erro. Este campo equivale propriedade AlarmServer. Determina o filtro por rea de Alarme. Caso deseje utilizar algum filtro, especifique no campo, seno basta deix-lo em branco. Pode-se filtrar reas com ou sem caracteres coringa (como * ou ?), dependendo da configurao na propriedade SimpleAreaFilter. Se a propriedade SimpleAreaFilter estiver em Falso, mltiplos filtros de rea podem ser usados, separados por dois pontos. Este campo equivale propriedade Filter. Habilita o tipo de filtro que ser aplicado no Alarme (Apenas alarmes, Apenas eventos, Alarmes e Eventos). Este campo equivale propriedade FilterType . Habilita ou desabilita a visualizao do grau da severidade (Alta, Mdia ou Baixa). Este campo equivale s propriedades ShowHightPriority (Alta), ShowMediumPriority (Mdia) e ShowLowPriority (Baixa).
possvel acessar um Servidor de Alarmes remoto, simplesmente preenchendo a propriedade AlarmServer do E3Alarm com os dados do Domnio e do Servidor de Alarmes remotos, no formato DOMINIO:SERVIDOR , onde SERVIDOR o nome do Servidor de Alarmes remoto, e DOMINIO o nome do Domnio Remoto que o contm. Para configurar o Domnio Remoto, veja a seo Domnios Remotos, no captulo sobre Domnios.
E3Alarm
291
Aba Colunas A lista Campos disponveis mostra todos os campos da Fonte de Alarme. Atravs do boto Adicionar, pode-se acrescentar campos individualmente no E3Alarm. Atravs do boto Propriedades, possvel configurar as propriedades do campo do alarme.
292
E3Alarm
Opes disponveis na aba Coluna OPO Largura (pixels) DESCRIO Determina a largura da coluna, em pixels. A largura padro das colunas do E3Alarm de 80 pixels. Determina o formatador utilizado na coluna do E3Alarm. O formatador utilizado o padro do E3 (ver seo Formatao de Valores), com exceo do campo Severidade e dos campos Condio Ativa, Pede Ack, Reconhecido e Habilitado, cujos exemplos de formatao podem ser vistos nas tabelas a seguir. Renomeia o ttulo da coluna. Permite configurar o reconhecimento do alarme quando o usurio clicar sobre a linha da coluna configurada. As opes disponveis so: Nunca: O alarme no reconhecido (padro) Com clique : O alarme reconhecido quando o usurio clica sobre a linha da coluna Com clique-duplo: O alarme reconhecido quando o usurio d um duplo-clique sobre a linha da coluna (NOTA : Se o alarme puder ser reconhecido, o formato do cursor do mouse muda para , em tempo de execuo, quando ele estiver sobre uma linha de alarme no reconhecido). Esta coluna nunca pisca Habilita ou desabilita o piscar da coluna.
Formatador
Formatador para o campo Severidade DADO Severidade Alta Severidade Mdia ;;; "A";"M";"B" FORMATADOR Alta M SADA FORMATADA
E3Alarm
293
FORMATADOR
Formatador para os campos Condio Ativa, Pede Ack, Reconhecido e Habilitado DADO Verdadeiro Falso Verdadeiro Falso Verdadeiro Falso FORMATADOR "OK";"No OK" "OK";"No OK" "AAA" "AAA" ; ; OK No OK AAA No Sim No SADA FORMATADA
Para remover algum campo indesejado, basta selecion-lo e clicar no boto Remover.
Aba Ordenao Cada campo da aba Ordenao possui uma propriedade correspondente. As propriedades 294 E3Alarm
disponveis so as seguintes: Opes disponveis na aba Ordenao OPO Pelo campo DESCRIO Ordena os alarmes conforme o campo especificado. Este campo equivale propriedade PrimarySortField. Ordena os alarmes a partir do item especificado na opo Pelo campo. O prximo item ser ordenado a partir da especificao indicada no campo Depois pelo campo. Este campo equivale propriedade SecondarySortField. Ordena os campos do alarme de forma ascendente. Este campo equivale s propriedades PrimarySortAscending e SecondarySortAscending em Verdadeiro. Ordena os campos do alarme de forma descendente. Este campo equivale s propriedades PrimarySortAscending e SecondarySortAscending em Falso.
Ascendente
Descendente
E3Alarm
295
Aba Cores Clicando no boto possvel selecionar a cor para o tipo de alarme selecionado. A seguinte janela mostrada:
Cores do alarme selecionado As opes disponveis so as seguintes: Opes disponveis na janela Cores OPO Cor de fundo Cor do texto DESCRIO Determina a cor de fundo do alarme. Determina a cor do texto do alarme.
296
E3Alarm
OPO No pisca
DESCRIO Quando selecionada, o texto do alarme no ir piscar. Quando selecionada, as cores de texto e fundo alternam entre si. Quando selecionada, a cor do texto varia entre as cores escolhidas para o texto e para o fundo.
possvel tambm escolher as cores por severidade, para cada tipo de alarme.
Cores do alarme por severidade Clicando no boto possvel redefinir as cores apenas para um tipo de severidade, no tipo de alarme selecionado. A seguinte janela mostrada:
As opes disponveis so as seguintes: Opes disponveis na janela Cores por severidade OPO Redefinir cor de fundo DESCRIO Determina a cor de fundo do alarme apenas para a severidade escolhida. Se esta opo no for marcada, permanece a cor escolhida na opo Cor de fundo do tipo de alarme selecionado. Determina a cor do texto do alarme apenas para a severidade escolhida. Se esta opo no for marcada, permanece a cor escolhida na opo Cor do texto do tipo de alarme selecionado. Redefine a opo de pisca para o texto e para o fundo do alarme na severidade escolhida. Se esta opo no for marcada, permanece a opo escolhida no tipo de alarme selecionado.
Redefinir pisca
298
E3Alarm
E3Alarm em execuo Dentre os alarmes que satisfazem os filtros configurados, so mostrados no E3Alarm aqueles que estiverem em condio ativa ou no estiverem reconhecidos. De maneira geral, isso pode ser dividido em dois casos: Se a opo Pede Ack da Fonte de Alarme estiver em Falso, o alarme ser considerado reconhecido desde a sua ativao, sem a necessidade de reconhecimento. Neste caso, o alarme ficar visvel at que saia da condio ativa Se a opo Pede Ack da Fonte de Alarme estiver em Verdadeiro, o usurio pode reconhecer o alarme antes ou depois da varivel sair da condio de alarme. Em ambos os casos, o alarme s sair da lista do E3Alarm quando as duas condies forem satisfeitas
E3Alarm
299
Opes de reconhecimento de alarmes As opes disponveis so as seguintes: Opes disponveis na janela Reconhecimento de Alarmes OPO Reconhece apenas os alarmes selecionados DESCRIO Somente os alarmes selecionados sero reconhecidos.
Reconhece todos os alarmes do filtro corrente Todos os alarmes visveis neste E3Alarm sero reconhecidos. Reconhece globalmente todos os alarmes Todos os alarmes do Domnio sero reconhecidos.
A opo Reconhecer apenas os alarmes selecionados s fica disponvel se realmente houver alarmes selecionados no E3Alarm em questo. O usurio poder reconhecer o alarme (neste caso, ser inserido um novo registro no Banco de Dados indicando o reconhecimento), e no E3Alarm a linha correspondente indicar que ele foi reconhecido. Esta opo estar desabilitada caso a propriedade AllowAckSelected esteja configurada para Falso A opo Reconhecer todos os alarmes do filtro corrente s fica disponvel se realmente houver alarmes visveis no E3Alarm. possvel chamar esta opo sem clicar em nenhum alarme. Para tanto, basta clicar em qualquer rea do E3Alarm, que a janela de Reconhecimento aparecer. Clicando sobre esta janela, a caixa de dilogo de reconhecimento aparecer. Esta opo estar desabilitada caso a propriedade AllowAckCurrentFilter esteja configurada para Falso A opo Reconhecer globalmente todos os alarmes fica sempre disponvel, mesmo que no haja alarmes visveis no E3Alarm em questo. Esta opo estar desabilitada caso a propriedade AllowAckAll esteja configurada para Falso
300
E3Alarm
O reconhecimento de alarmes tambm pode ser feito atravs de um clique ou duplo-clique sobre a linha do alarme. Para tanto, basta especificar nas propriedades da coluna desejada (propriedades do E3Alarm, aba Colunas, boto Propriedades) como ser feito o reconhecimento do alarme em tempo de execuo, com um ou dois cliques sobre a coluna.
Exemplo de ordenao Na figura anterior, os alarmes esto ordenados primeiro por rea, de forma ascendente, e depois por data e hora (Entrada), tambm de forma ascendente.
E3Alarm
301
14
CAPTULO
Histricos
Histricos so mdulos responsveis pelo armazenamento de dados da aplicao em um Banco de Dados. Permitem armazenar dados de processos para anlises futuras. Voc pode criar tantos arquivos de Histricos quantos desejar, cada um contendo diversos Tags ou expresses. Cada Histrico pode criar ou utilizar uma tabela independente dentro do Banco de Dados, cujo armazenamento pode ser definido por Tempo ou por Evento. Atravs da propriedade CacheSize , define-se o nmero de registros enviados por vez para o Banco de Dados. Conforme a definio da propriedade DBServer, define-se o Servidor do Banco de Dados que ser utilizado pelo histrico. Para utilizar este recurso, siga estes procedimentos: 1. Clique com o boto direito do mouse no nome do projeto no Explorer e selecione a opo Inserir - Histrico. No modo Domnio, clique com o boto direito do mouse no item Objetos de Servidor - Banco de Dados, selecione a opo Inserir Histrico em e logo aps o nome do projeto desejado.
Inserindo um Histrico no modo Domnio 2. Quando o Histrico for habilitado, as seguintes opes de configurao so apresentadas:
302
Histric os
Opes do Histrico As opes disponveis so as seguintes: Opes disponveis na view do Histrico BOTO DESCRIO Adiciona campos na tabela do Histrico. Remove o campo selecionado da tabela do Histrico. Determina as configuraes da tabela do Histrico. Gera a estrutura no Banco de Dados. Cria uma chave primria. Configura os ndices que sero criados no Histrico. Mantm o Histrico sem vnculos diretos com a tabela existente. Busca os campos na tabela original. Vincula o Histrico a uma tabela j existente.
3. Acesse as propriedades do Histrico. Para tanto, clique com o boto direito do mouse sobre o objeto e acesse a opo Propriedades. Algumas das propriedades deste objeto podem ser configuradas atravs da Lista de Propriedades, sem a necessidade da criao de scripts para isto. Caso seja necessrio configurar alguma propriedade, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes. Demais informaes sobre as funcionalidades das propriedades deste objeto podem ser encontradas no Manual de Referncia de Scripts do E3 , no captulo referente ao objeto Histrico.
NOTA : O objeto Histrico pode ser configurado para funcionar como rea de Alarme .
Histric os
303
Mensagem para confirmar excluso de campo na tabela O campo Nome define o nome do campo da tabela. O campo Tipo define o tipo de campo da tabela, e a fonte deste campo definida em Fonte . Tambm possvel definir se este campo ser ou no a chave primria da tabela.
304
Histric os
A chave primria pode ser configurada de duas formas: verificando na tela do Histrico qual campo da tabela que se pretende tornar chave primria, e habilitando-o atravs do boto ou clicando no cone , que abre a janela de configurao, conforme a figura a seguir:
Editando um ndice Chave Primria Nesta caixa de dilogo, basta selecionar o campo desejado como chave primria. As opes disponveis deste item so as seguintes: Opes disponveis na janela Edio de ndices OPO Nome do ndice Garantir que os valores deste ndice sero nicos DESCRIO Determina o nome da chave primria. Faz com que os valores especificados para o ndice Chave Primria sejam nicos. Esta opo est sempre marcada para Chaves Primrias, no podendo ser modificada. Mostra o nome do campo. Mostra a ordenao do campo selecionado. Mostra o tipo do campo da tabela. Muda a posio do campo na tabela, fazendo com que ele suba ou desa.
Histric os
305
Clicando no boto OK, confirma-se que o campo determinado uma chave primria da tabela. Para cancelar a configurao, clique no boto Cancelar. Pode-se tambm atribuir um ndice tabela.
14.1.2 ndices
Um ndice um campo ou conjunto de campos que sero previamente ordenados pelo Banco de Dados a fim de melhorar a performance das consultas que utilizam este ndice. Eles so utilizados para encontrar registros com um valor especfico em uma coluna rapidamente. Sem um ndice, o Banco de Dados tem de iniciar com o primeiro registro e depois ler atravs de toda a tabela at que ele encontre os registros relevantes. Quanto maior a tabela, maior ser o custo dessa operao. Se a tabela possuir um ndice para as colunas em questo, o Banco de Dados pode rapidamente obter uma posio para procurar no meio do arquivo de dados sem ter que varrer todos os registros. Por exemplo, se uma tabela possui 1.000 registros, isto pelo menos 100 vezes mais rpido do que ler todos os registros sequencialmente. Note que se for preciso acessar quase todos os 1.000 registros, no entanto, mais rpido acess-los sequencialmente, pois isto evitaria acessos ao disco. Os tipos de ndices disponveis so os seguintes: Primrio, nico e Index. Todos os tipos de colunas da tabela podem ser indexadas. O uso de ndices nas colunas relevantes a melhor forma de melhorar a performance da tabela. O nmero mximo de ndices por tabelas e o tamanho mximo de um ndice definido pelo mecanismo de armazenamento do Servidor de Banco de Dados. Pode-se criar ndices em mltiplas colunas. Um ndice de mltiplas colunas pode ser considerado um vetor ordenado contendo valores que so criados concatenando-se valores de colunas indexadas. Os ndices podem ser configurados atravs do cone conforme figura a seguir: , que abrir a janela de configurao,
306
Histric os
Janela do Editor de ndices As opes disponveis deste item so as seguintes: Opes disponveis na janela Editor de ndices OPO Nome Campos DESCRIO Mostra o nome do ndice existente. Mostra o campo ao qual o ndice est associado na tabela. Abre uma caixa de dilogo para a adio de um ndice. Abre uma caixa de dilogo para a edio do ndice selecionado. Remove o ndice selecionado.
Adicionar
Editar
Remover
Histric os
307
Adicionando ndices As opes disponveis deste item so as seguintes: Opes disponveis na adio de ndices OPO Nome do ndice Garantir que os valores deste ndice sero nicos Nome do campo DESCRIO Determina o nome do ndice. Se habilitada, faz com que os valores especificados para o ndice sejam nicos. Mostra os nomes dos campos. Marque aqueles que devem pertencer ao ndice. Mostra a ordenao do campo selecionado (Ascendente ou Descendente). Mostra o tipo do campo da tabela. Muda a posio do campo na tabela, fazendo com que ele suba ou desa.
Ordenao
Clicando no boto OK, os ndices na tabela so confirmados. Para cancelar a configurao, clique no boto Cancelar.
308
Histric os
Aba Histrico Cada campo da aba Histrico possui uma propriedade correspondente. As opes disponveis so as seguintes: Opes disponveis na aba Histrico OPO Utilize o servidor de banco de dados DESCRIO Define o servidor de Banco de Dados. Este campo equivale propriedade DbServer. Determina o nome da tabela. Este campo equivale propriedade TableName .
Nome da tabela
Histric os
309
DESCRIO Determina a variao do intervalo de tempo (em ms), ou seja, de quanto em quanto tempo os dados do Histrico sero gravados na tabela. Este campo equivale propriedade ScanTime . Habilita ou desabilita o descarte dos dados da tabela principal. O dado ser antigo de acordo com o que for definido na opo Mantenha os dados do(s) ltimo(s). Este campo equivale propriedade EnableDiscard . Determina o intervalo de tempo (minutos, horas, dias ou meses) durante o qual os dados sero mantidos na tabela principal. Se um dado da tabela for mais antigo que o intervalo de tempo desta opo, ele ser descartado. Este campo equivale propriedade DiscardInterval, e o campo de seleo da unidade de tempo do intervalo equivale propriedade DiscardTimeUnit. Determina o intervalo (minutos, horas, dias ou meses) de descarte de dados antigos da tabela. Este campo equivale propriedade VerificationUnit. Habilita ou desabilita o armazenamento dos dados descartados na tabela secundria (tabela de backup ). Este campo equivale propriedade EnableBackupTable . Determina o intervalo de tempo (minutos, horas, dias ou meses) durante o qual os dados sero mantidos na tabela de backup . Este intervalo deve ser sempre maior que o configurado no item Mantenha os dados do(s) ltimo(s) da Tabela Principal. Este campo equivale propriedade BackupDiscardInterval, e o campo de seleo da unidade de tempo do intervalo equivale propriedade BackupDiscardTimeUnit. Gera a estrutura da tabela no Banco de Dados. Esta opo est disponvel atravs do clique com o boto direito no Organizer, ou atravs do boto Gerar Tabela.
Gerar Tabela
Quando a opo Gerar Tabela acionada, o sistema mostra a seguinte mensagem: 310 Histric os
Mensagem do sistema Quando a opo Gerar Tabela utilizada, a tabela especificada no Histrico gerada, alm de uma tabela _Fields. Esta tabela possui as informaes de cada campo cadastrado no Histrico.
Campos Os campos disponveis na tabela do Histrico so os seguintes: Campos da tabela do Histrico CAMPOS FieldDeadBand FieldDeadBandUnit Banda morta. Unidade utilizada pela banda morta (em valores absolutos ou porcentagem). Descrio do campo. Unidade de Engenharia. Limite superior do Tag. ndice do campo cadastrado no Histrico. Limite inferior do Tag. Depois que esse tempo expira, o dado deve ser automaticamente gravado. DESCRIO
Histric os
311
CAMPOS FieldMinRecTime
DESCRIO Valor mnimo de tempo de variao para armazenamento de um dado. Nome do campo do Histrico. Tipo da qualidade do campo. As opes disponveis so: 0 - sem qualidade ; 1 mtodo anterior verso 1.21 (onde 0 = valor duvidoso; 1 = valor bom); 2 - qualidade real do tag. Tamanho do campo. Associao utilizada pelo campo para obter os seus valores. Tipo do campo.
FieldName FieldQuality
FieldSize FieldSource
FieldType
A opo Vincular Histrico a uma tabela j existente vincula o Histrico a tabelas existentes no Banco de Dados. Quando esta opo habilitada, o sistema abre uma caixa de dilogo para determinar quais as tabelas sero vinculadas ao Histrico corrente, conforme figura a seguir:
Seleo de tabela para vinculo com o Histrico Quando a tabela selecionada e clica-se no boto OK, o sistema mostra a seguinte mensagem:
312
Histric os
Mensagem do sistema Clicando em Cancel, os campos configurados na tabela iro permanecer com as configuraes atuais. J clicando em OK, todos os campos, ndices e chaves primrias definidas no Histrico sero substitudos pelos dados da tabela selecionada. Quando este item utilizado, outros dois botes so habilitados: vnculos diretos com tabela existente e Manter Histrico sem
Quando a opo Manter Histrico sem vnculos diretos com tabela existente o sistema mostra a seguinte mensagem:
Mensagem do sistema quanto configurao do Histrico Clicando em Cancel, a tabela permanecer com as configuraes atuais. J clicando em OK, o sistema reinicializa a tabela com seus campos iniciais, onde h somente o campo padro habilitado (E3TimeStamp).
Histrico aps a habilitao da opo Manter histricos sem vnculo direto com a tabela existente J a opo Buscar campos da tabela original recupera os dados do Histrico vinculado tabela existente, que haviam sido apagados:
Histric os
313
314
Histric os
15
Storage
O Storage um mdulo alternativo de gravao dos dados histricos. Atravs dele, possvel transformar dados de produo, processos, outras coletas e informaes gerenciais. Este mdulo permite que diversas informaes sejam coletadas atravs de servidores OPC, drivers Elipse, bancos de dados em geral, ou at mesmo arquivos de texto e armazenamentos em banco de dados comerciais (Microsoft SQL Server e Oracle), por objetos histricos definidos pelo usurio em uma forma compacta e eficiente. O armazenamento das informaes segue a lgica de que um dado s gravado quando houver uma variao significativa, definida pelo usurio. A verificao das variaes analisada pelo algoritmo BoxCar/BackSlope, que permite uma compactao de at 93% nos dados, com uma recuperao total das informaes realmente teis, dependendo da banda morta definida. A recuperao dos dados no ambiente do E3 pode ser feita atravs de uma ferramenta de consulta padronizada, que permite montar sua estrutura de consulta de forma grfica (similar ao existente nas ferramentas Microsoft Access ou SQL Server) ou ainda editar diretamente as consultas SQL. Os dados extrados podem ser visualizados em formato tabular (E3Browser), em grfico (E3Chart), ou ainda em relatrios que permitem visualizao em tela (propriedade PrintPreview do Relatrio), impresso direta para o papel, ou mesmo exportao para vrios formatos como Acrobat PDF, HTML, TXT, CSV, TIFF e GIF, entre outros. A principal funo do Storage permitir a gravao dos dados de forma compacta. Atravs desta ferramenta possvel recuperar com grande exatido todas as mudanas nas variveis de processo, ocupando assim o mnimo de espao no banco de dados. Alguns exemplos so mostrados nas sees a seguir. Grfico sem compactao A informao processada contm vrios pontos.
CAPTULO
Storage
315
Grfico com compactao Veja que a informao praticamente a mesma, s que com menos pontos.
Grfico com compactao A gravao no Storage feita da seguinte maneira: Aps a definio da tabela nas propriedades do Storage, esta gerada atravs do boto Gerar Tabela e os dados so gravados de acordo com estas definies. Se houver variao de qualidade no Tag, os dados tambm sero gravados Os dados s no sero gravados se a variao ocorreu num tempo menor que o mnimo programado (campo MinRecTime )
Para inserir esta ferramenta no E3, siga estes procedimentos: 1. Clique com o boto direito do mouse sobre o nome do projeto no Explorer e selecione a opo Inserir - Storage . No modo Domnio, clique com o boto direito do mouse no item Objetos de Servidor - Banco de Dados, selecione a opo Inserir Storage em e logo aps o nome do projeto desejado.
316
Storage
Inserindo um Storage no modo Domnio Caso necessite, configure as propriedades do objeto. Algumas das propriedades deste objeto podem ser configuradas atravs da Lista de Propriedades, sem a necessidades de criar scripts para isto. Caso necessite configurar alguma propriedade, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes. Para maiores informaes, consulte o Manual de Referncia de Scripts do E3 .
NOTA : O objeto Storage pode ser configurado para funcionar como rea de Alarme .
Storage
317
Campos configurados para o Storage Para adicionar um campo, pode-se arrastar e soltar um tag ou propriedade a partir do Organizer, ou ento definir o campo e a fonte manualmente. Para efeitos de posterior consulta nos dados, toda a busca se dar atravs do caminho do tag ou propriedade que est sendo armazenada - definido atravs do campo Fonte . A propriedade Nome s ser utilizada caso o campo Fonte contenha uma expresso (por exemplo, Driver1.Tag1 + Driver1.Tag2 ). Logo, se expresses no estiverem sendo utilizadas no campo Fonte , no h necessidade de se importar com o nome do campo. As opes disponveis so as seguintes: Opes disponveis na view do Storage OPO DESCRIO Adiciona campos na tabela do Storage. Remove o campo selecionado na tabela do Storage. Determina as configuraes da tabela do Storage. Gera a estrutura no Banco de Dados. Nome Determina o nome do campo da tabela do Storage. Determina a fonte de dados que ser associada ao campo.
Fonte
318
Storage
OPO Tipo
DESCRIO Determina o tipo do campo da tabela do Storage. Se este valor for alterado para Bit, Text ou Integer, as colunas MinRecTime , MaxRecTime , Varredura, Banda Morta e Unidade ficam desabilitadas. Tempo mnimo para insero de um dado na tabela. Este tempo calculado em milissegundos. Tempo mximo de espera por um dado, em segundos. Se passar esse tempo, o dado considerado antigo e ser armazenado. Tempo de varredura do Campo. Se este valor for igual a 0 (zero), esta coluna fica desabilitada e mostra o valor definido em MaxRecTime , em milissegundos. Banda morta para clculo do algoritmo. Valor absoluto ou a porcentagem de modificao.
MinRecTime
MaxRecTime
Varredura
Storage
319
2. Atravs do clique com o boto direito do mouse sobre o objeto no Organizer e selecionando a opo Propriedades.
Campos do Storage Cada campo da aba Storage possui uma propriedade correspondente. As opes disponveis so as seguintes: Opes disponveis na aba Storage OPO Utilize o servidor de banco de dados DESCRIO Define o servidor de Banco de Dados. Este campo equivale propriedade DbServer. Determina o nome da tabela. Este campo equivale propriedade TableName .
Nome da tabela
320
Storage
DESCRIO Habilita ou desabilita o descarte dos dados da tabela principal. O dado ser antigo de acordo com o que for definido na opo Mantenha os dados do(s) ltimo(s). Este campo equivale propriedade EnableDiscard . Determina o intervalo de tempo (minutos, horas, dias ou meses) durante o qual os dados sero mantidos na tabela principal. Se um dado da tabela for mais antigo que o intervalo de tempo desta opo, ele ser descartado. Este campo equivale propriedade DiscardInterval, e o campo de seleo da unidade de tempo do intervalo equivale propriedade DiscardTimeUnit. Determina o intervalo (minutos, horas, dias ou meses) de descarte de dados antigos da tabela. Este campo equivale propriedade VerificationUnit. Habilita ou desabilita o armazenamento dos dados descartados na tabela secundria (tabela de backup ). Este campo equivale propriedade EnableBackupTable . Determina o intervalo de tempo (minutos, horas, dias ou meses) durante o qual os dados sero mantidos na tabela de backup . Este intervalo deve ser sempre maior que o configurado no item Mantenha os dado(s) dos ltimo(s) da Tabela Principal. Este campo equivale propriedade BackupDiscardInterval, e o campo de seleo da unidade de tempo do intervalo equivale propriedade BackupDiscardTimeUnit. Gera a estrutura da tabela no Banco de Dados. Esta opo est disponvel atravs do clique com o boto direito do mouse no Organizer, ou atravs do boto Gerar Tabela.
Gerar Tabela
Aps definir as configuraes da tabela, necessrio clicar no boto Gerar Tabela. Esta ao cria a estrutura da tabela no banco de dados. A estrutura de tabelas do Storage semelhante estrutura do Histrico: uma tabela de definies, uma tabela principal de dados e uma tabela de backup (se escolhida pelo usurio). Para que se possa identificar externamente que uma tabela compactada, s verificar se foi criada a tabela _Fields. Storage 321
Tabela Fields Esta tabela possui os seguintes campos: Campos da tabela _Fields CAMPOS FieldDeadBand FieldDeadBandUnit Banda morta. Unidade da banda morta. Em porcentagem do valor anterior ou porcentagem dos limites de engenharia (valor fixo). Descrio do campo. Unidade de Engenharia. Limite superior do Tag. ndice do campo cadastrado no Storage. Limite inferior do Tag. Depois que esse tempo expira, o dado deve ser automaticamente gravado. Valor mnimo de tempo de variao para armazenar dados. Nome do campo. Qualidade do campo. Tempo de varredura que deve ser utilizado para reconstruir o grfico do Tag, em milissegundos. Storage DESCRIO
FieldMinRecTime
322
DESCRIO Tamanho do campo. Associao utilizada para obter valores deste campo. Tipo do campo. Tipo de dado nativo do campo (0 : Indefinido, 3 : Integer, 5 : Double, 8 : Text, 11 : Bit).
FieldType FieldVARTYPE
A implementao do Storage permite que o usurio no tenha que se preocupar em como os dados esto armazenados nas tabelas. Entretanto, para uma melhor compreenso do funcionamento do mdulo, e tambm para permitir acesso por outros programas, ser mostrado a seguir o formato das tabelas. As opes de gerenciamento de tabelas especificadas no item anterior se aplicam na verdade a trs conjuntos de tabelas geradas pelo Storage, de acordo com o campo Nome de Tabela. Isto porque, para cada tipo de grandeza armazenada, gerado automaticamente um conjunto de tabelas, a saber: um conjunto para os tags analgicos, outro para os textos e mais outro para os digitais. Dessa forma, cada Storage pode gerenciar at sete tabelas, caso se especifique que os trs tipos de tags devam ser armazenados: <NomeTabela>_Fields <NomeTabela> <NomeTabela>_Text <NomeTabela>_Bit <NomeTabela>_Backup <NomeTabela>_Text_Backup <NomeTabela>_Dig_Backup A tabela _Fields contm a descrio dos campos que sero armazenados, que de forma geral armazenam as mesmas informaes definidas na configurao dos campos do Storage, alm de associar um ndice automtico para cada campo. As demais tabelas possuem um formato fixo: E3TimeStamp: Campo que armazena a data e hora em que houve a variao do Tag. Caso o protocolo de comunicao suporte o envio de informao de tempo, este campo conter o timestamp do equipamento Qualidade : Contm a informao de qualidade do ponto (ruim, incerto ou bom) de acordo Storage 323
com a utilizao dentro do E3 e das normas OPC ndice : Relaciona o campo gravado com o seu respectivo nome que est armazenado na tabela Fields Valor: Valor armazenado. Para a tabela de analgicos trata-se de um campo tipo Double (nmero real), j para a tabela de digitais trata-se de um nmero inteiro e para os textos trata-se de um campo NVARCHAR de tamanho varivel, especificado pelo usurio no campo StringFieldSize
15.2.1 Execuo
Ao iniciar a execuo do aplicativo e receber a primeira notificao de valor de cada uma das variveis armazenadas, o Storage armazena esse valor obtido com qualidade Ruim, e logo em seguida com a qualidade enviada, se esta for Boa. Isto porque ao realizar a consulta, o usurio ter a visualizao de que houve uma interrupo no armazenamento. Depois, conforme sejam obtidos novos valores para as variveis, um algoritmo de verificao de gravao interpreta a sequncia e decide se cada ponto ser ou no armazenado. Este algoritmo, conhecido como BoxCar/BackSlope , cria duas bandas de variao (cuja amplitude dada pela banda morta da varivel) de um ponto gravado. A banda horizontal (BoxCar) define uma verificao comum da banda morta. Uma segunda banda diagonal (BackSlope) define uma variao para cima ou para baixo da banda morta. Portanto, se a varivel est em uma derivativa contnua descendente ou ascendente, s necessrio armazenar os pontos iniciais ou finais nesta linha reta. Assim, uma varivel analgica s gravada se o valor viola tanto a banda horizontal quanto a vertical, ou se houve uma mudana na qualidade (ou seja, o equipamento foi ligado ou desligado).
Exemplo do algoritmo BoxCar/BackSlope Esta verificao, entretanto, s ocorre para os campos analgicos. Para os campos de texto e digitais, basta que haja uma mudana qualquer de valor ou qualidade (por exemplo, o equipamento perder a comunicao) para que sejam gravados.
324
Storage
Storage
325
SampledData: Retorna, para um ou mais Tags, os valores interpolados (ou seja, estimados) entre os instantes definidos pelas variveis StartTime e EndTime , a intervalos fixos definidos pela varivel TimeInterval . As variveis tambm podem ser definidas em execuo a partir da chamada do mtodo SetVariableValue da Consulta CalculatedData: Retorna, para um ou mais Tags, o resultado de operaes matemticas aplicadas aos dados entre os instantes definidos pelas variveis StartTime e EndTime , a intervalos fixos definidos pela varivel TimeInterval . Os tipos de clculos so: Total, Mnimo, Mximo, Desvio Padro, Amplitude , Mdia e Mediana. As variveis tambm podem ser definidas em execuo a partir da chamada do mtodo SetVariableValue da Consulta
Para todas as opes possvel indicar se os dados com qualidade Ruim sero includos ou no na resposta, atravs da caixa de seleo Incluir Qualidade Ruim.
Funes
15.2.3 Utilizao
Se a funo escolhida possui algum filtro, ento necessrio informar o valor dos filtros antes de executar a consulta, seja na prpria caixa de dilogo de configurao (atravs da aba Visualizar) ou atravs de scripts, usando o mtodo SetVariableValue . Exemplos:
326
Storage
Set Chart = Screen.Item("E3Chart1") Set Query = Chart.Item("Consulta1") Query.SetVariableValue "StartTime", Chart.DataIni Query.SetVariableValue "EndTime", Chart.DataFim Query.SetVariableValue "TimeInterval", rs.Fields("SampleInterval").Value Chart.Queries.UpdateData
STORED PROCEDURE
As Stored Procedures que utilizam parmetros de tipo Data recebem este parmetro na chamada como um nmero Float (Ponto flutuante), ao invs de DateTime . Isto feito para aumentar a preciso do E3, j que ao utilizar o formato DateTime a preciso mxima de 3ms, ao invs de 1ms com o tipo Float. Para facilitar a passagem de parmetros, pode-se adicionar ao Banco de Dados uma funo do usurio que transforma um valor DateTime em um Float, conforme o exemplo a seguir:
CREATE FUNCTION E3GETFLOATVALUE (@dDate datetime) RETURNS FLOAT AS BEGIN RETURN CAST(@dDate AS float) END
Storage
327
15.2.4.1 E3LastValue
Retorna o ltimo valor de um determinado Tag que est armazenado no Banco de Dados. A descrio formal :
E3LastValue(@strTableName varchar(100), @strFieldName VARCHAR(100), @strFilter VARCHAR(500), @type int, @bQuality int)
Onde: @strTableName : nome da tabela @strFieldName : nome do campo @strFilter: caso queira inserir opes de filtro para o valor @type : tipo de dado (0: String, 1: Bit ou Integer, 2: Analgico) @bQuality: se diferente de 0, somente inclui Tags com qualidade Boa
Retorna uma consulta com apenas uma linha, com os campos E3TimeStamp, Quality e FieldValue . Exemplo de utilizao:
EXECUTE E3LastValue 'TabelaXX', 'Tag234', '', 2, 1
15.2.4.2 E3Archive
Retorna um valor armazenado em relao a um instante, conforme o exposto na funo ArchivedValue . usada somente para os SubTipos Prev (0), Next (2) e ExactTime (3). A descrio formal :
E3Archive(@iSubType int, @strTableName varchar(100), @dData float, @strFieldName VARCHAR(100), @strFilter VARCHAR(500), @type int, @bQuality int)
Onde: @iSubType : subtipo da funo, sendo 0: Prvio, 2: Prximo, 3: Instante Exato @Data: instante no tempo para a busca, no formato Float
Retorna uma consulta com apenas uma linha, com os campos E3TimeStamp, Quality e FieldValue . Exemplo de utilizao:
DECLARE @MyDate FLOAT SET @MyDate = dbo.E3GETFLOATVALUE('10-10-2005 12:00:00') EXECUTE E3Archive 0, 'STO22', @MyDate, 'Dados.TagDemo1', '', 2, 0
328
Storage
15.2.4.3 E3ArchiveInterpolate
Retorna os pontos imediatamente anteriores e posteriores a um instante, conforme exposto para a funo ArchivedValue , porm somente para o Subtipo Interpolado. A descrio formal :
E3ArchiveInterpolate(@strTableName varchar(100), @dData float, @strFieldName VARCHAR(100), @strFilter VARCHAR(500), @type int, @bQuality int)
Esta consulta retorna duas linhas, com os campos E3TimeStamp e FieldValue . Exemplo de utilizao:
DECLARE @MyDate FLOAT SET @MyDate = dbo.E3GETFLOATVALUE('10-10-2005 12:00:00') EXECUTE E3ArchiveInterpolate 'STO22', @MyDate, 'Dados.TagDemo1', '', 2, 0
15.2.4.4 E3NCompData
Equivale funo CompressedDataNValues. A descrio formal :
E3NCompData(@strTableName varchar(100), @dData float, @strFieldName VARCHAR(100), @iNValues int, @strFilter VARCHAR(500), @strOrder VARCHAR(100), @type int, @bQuality int)
Onde: @iNValues: o nmero de valores desejado @strOrder: quando desejar que a consulta seja ordenada por outro campo que no seja o TimeStamp
Esta funo retorna o nmero de linhas solicitado, se encontrado, com os campos E3TimeStamp, Quality e FieldValue . Exemplo de utilizao:
DECLARE @MyDate FLOAT SET @MyDate = dbo.E3GETFLOATVALUE('10-10-2005 12:00:00') EXECUTE E3NCompData 'STO22', @MyDate, 'Dados.TagDemo1', 20, '', '', 2, 0
Storage
329
15.2.4.5 E3CompData
Equivale funo CompressedDataStartEndTime . A descrio formal :
E3CompData(@strTableName varchar(100), @dStartData float, @dEndData float, @strFieldName VARCHAR(100), @strFilter VARCHAR(500), @strOrder VARCHAR(100), @type int, @bQuality int)
Onde: @dStartData: a data inicial, em formato Float @dEndData: a data final, em formato Float @strOrder: quando desejar que a consulta seja ordenada por outro campo que no seja o TimeStamp
Esta funo retorna o nmero de linhas encontrado no intervalo, com os campos E3TimeStamp, Quality e FieldValue . Exemplo de utilizao:
DECLARE @MyStartDate FLOAT DECLARE @MyEndDate FLOAT SET @MyStartDate = dbo.E3GETFLOATVALUE('10-10-2005 12:00:00') SET @MyEndDate = dbo.E3GETFLOATVALUE('10-10-2006 12:00:00') EXECUTE E3CompData 'STO22', @MyStartDate, @MyEndDate, 'Dados.TagDemo1', '', '', 2, 0
15.2.4.6 E3SampledData
Equivale funo SampledData. A descrio formal :
E3SampledData(@strTableName varchar(100), @iModMin int, @dStartDate float, @dEndDate float, @strFields VARCHAR(1000), @strWhere VARCHAR(4000), @type int, @bQuality int)
Onde: @iModMin: intervalo em segundos para a interpolao de cada valor dentro do intervalo @dStartData: a data inicial, em formato Float @dEndData: a data final, em formato Float @strFields: lista de campos
330
Storage
Exemplo de utilizao:
DECLARE @MyStartDate FLOAT SET @MyStartDate = dbo.E3GETFLOATVALUE('10-10-2004 12:00:00') DECLARE @MyEndDate FLOAT SET @MyEndDate = dbo.E3GETFLOATVALUE('10-10-2006 12:00:00') EXECUTE E3SampledData 'STOXX', 10, @MyStartDate, @MyEndDate, 'Dados.TagDemo1', '', 2, 1
15.2.4.7 E3CalculatedData
Equivale funo CalculatedData. A descrio formal :
E3CalculatedData(@iSubType int, @strTableName varchar(100), @iModMin int, @dStartDate float, @dEndDate float, @strFields VARCHAR(1000), @strWhere VARCHAR(4000), @type int, @bQuality int)
Onde: @iSubType : subtipo do clculo, sendo 0: Total, 1: Mnimo, 2: Mximo, 3: Desvio Padro, 4: Amplitude , 5: Mdia e 6: Mediana
Exemplo de utilizao:
DECLARE @MyStartDate FLOAT SET @MyStartDate = dbo.E3GETFLOATVALUE('10-10-2004 12:00:00') DECLARE @MyEndDate FLOAT SET @MyEndDate = dbo.E3GETFLOATVALUE('10-10-2006 12:00:00') EXECUTE E3CalculatedData 0, 'STOXX', 10, @MyStartDate, @MyEndDate, 'Dados.TagDemo1', '', 2, 1
Storage
331
16
CAPTULO
Consultas
O objeto Consulta (ou Query) auxilia no processo de definio de consultas no Banco de Dados da aplicao. Toda vez que os objetos E3Browser ou Relatrio vo buscar dados do Banco de Dados, necessrio enviar um comando, de forma que se saiba quais os dados desejados para aquele objeto. Logo, toda vez que uma aplicao precisar gravar ou buscar dados armazenados num Banco de Dados, so enviados comandos no formato SQL (Structured Query Language). A consulta apresenta uma interface amigvel, que permite a construo das consultas numa forma grfica e o acompanhamento imediato da sintaxe SQL que est sendo gerada. A consulta permite mostrar os dados dos ltimos N dias, horas ou meses, data final ou inicial e consultas. O Assistente da consulta responsvel por criar o texto que faz o filtro ou a consulta, no sendo necessrio para o usurio saber detalhes como data, etc. Para utilizar este recurso, siga estes procedimentos: 1. Clique com o boto direito do mouse sobre a Tela do projeto e selecione as opes Inserir Consulta.
NOTA : Quando criado um objeto Relatrio ou E3Browser, o objeto Consulta adicionado automaticamente a estes objetos. No entanto, tambm pode-se inserir este objeto em uma Pasta de Dados ou na Tela. Para maiores detalhes, veja os captulos correspondentes.
Antes de definir a Consulta, deve-se informar o Servidor de Banco de Dados no qual a Consulta ir buscar os dados. Para tanto, selecione o servidor na caixa de listagem Nome do Servidor:
Definio do Servidor Banco de Dados A configurao da Consulta depende do objeto ao qual ela est relacionada.
332
Consultas
Configuraes da Consulta Para verificar quais as configuraes necessrias da Consulta, veja os captulos Relatrios e E3Browser. Algumas das propriedades da Consulta podem ser configuradas atravs da Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes. Para maiores informaes, consulte o Manual de Referncia de Scripts do E3 .
Consultas
333
Definio do Servidor Banco de Dados na Consulta 2. Aps ser definido o servidor Banco de Dados, uma nova janela aparecer com tabelas que foram encontradas no Banco de Dados, permitindo a sua seleo.
Adio de tabela 3. Selecione as tabelas que faro parte da consulta e clique no boto OK. 4. Depois de definidas as tabelas, a janela de definio da Consulta mostrada, contendo quatro abas: Campos Variveis Visualizar SQL
334
Consultas
Consultas
335
Inserindo uma tabela Para selecionar todos os campos da tabela para fazerem parte da Consulta, selecione o primeiro item da lista de seleo, correspondente ao smbolo *. Para adicionar um campo especfico, selecione sua caixa de seleo correspondente.
Selecionando campos de uma tabela Devido questes de performance, importante adicionar Consulta somente campos que realmente interessam para a anlise. Na rea de colunas, os campos escolhidos so mostrados.
336
Consultas
rea de colunas Cada coluna mostra as seguintes propriedades para cada campo da tabela ou tabelas selecionadas. Opes disponveis para a configurao de colunas OPO Colunas DESCRIO Mostra o nome das colunas selecionadas. Ao clicar na caixa de combinao de cada linha, pode-se redefinir a coluna desejada. Permite que um novo nome seja definido para a Coluna (tambm conhecido como Alias). Mostra o nome da tabela de origem do campo. Habilita ou desabilita o campo. Permite ordenar os valores: Sem ordenao, Ascendente (valores menores primeiro) e Descendente (valores maiores primeiro). Define a prioridade quando mais de um campo possui ordenao. Permite que os dados sejam agrupados a cada novo valor do campo em questo. Permite definir a execuo de uma funo para o campo. Define um critrio de consulta, como por exemplo, intervalos de data.
Ttulos
Tabela
Mostrar Ordenao
Ordem
Agrupado por
Funo
Filtro
Ao definir um filtro, a janela a seguir ser mostrada, permitindo que se defina o tipo de comparao e o valor a ser comparado.
Consultas
337
Definindo um filtro O tipo de dado de comparao pode ser definido ao clicar na caixa de seleo correspondente e selecionando um dos tipos na lista de opes (Empty, NULL , Boolean, Byte , Integer, Long, Currency, Single , Double , Date e String).
Configuraes para a definio do filtro O valor de comparao poder ser uma constante (por exemplo, 123, 45, "ABCD", etc.) ou uma varivel definida pelo usurio. Para criar uma varivel, basta informar um nome qualquer entre os smbolos: <% '<% #<% %> se o valor for numrico %>' se for texto (String) %># se o valor for uma data
338
Consultas
O valor da varivel pode ser definido na aba Variveis ou atravs do mtodo SetVariableValue , chamado via script.
Aba Variveis As colunas desta aba so descritas na tabela a seguir. Opes disponveis na aba Variveis OPO Nome Valor DESCRIO O nome da varivel definida pelo usurio. Uma caixa de seleo onde o valor do tipo de dados pode ser selecionado.As opes so Empty, NULL , Boolean, Char, Byte , Integer, Word, Long, Dword, Currency, Single , Double , Date, Decimal e String.
Consultas
339
Visualizao da Consulta
340
Consultas
Aba SQL Ao desmarcar a opo Habilita edio direta do SQL , todas as alteraes so perdidas e a Consulta retorna s opes selecionadas nas abas Campos, Variveis e Visualizar.
Consultas
341
O mtodo Requery possibilita que os novos parmetros de consulta seja realmente utilizados, visto que uma nova consulta feita, respeitando esses novos valores.
A varivel RS assume todas as caractersticas de um Recordset. A vantagem do uso desse recurso que, se forem feitas modificaes nas propriedades do banco de dados, no necessrio ajustar cada um dos scripts que acessam esse banco.
342
Consultas
17
CAPTULO
E3Browser
O E3Browser um controle ActiveX utilizado para visualizar dados armazenados em Bancos de Dados. Pode-se configurar consultas utilizando filtros de vrios tipos nos dados, atribuir cores para cada coluna, entre outras configuraes. Este objeto utilizado para visualizar os histricos, alarmes ou qualquer tabela existente no Banco de Dados.
E3Browser Para utilizar este recurso, siga estes procedimentos: 1. Insira um E3Browser no projeto atravs do clique com o boto direito do mouse na rea de trabalho, e selecionando o objeto E3Browser. 2. O E3Browser utiliza o objeto Consulta para auxiliar o usurio no processo de definio de consultas no Banco de Dados da aplicao. Para maiores informaes, consulte o captulo referente. 3. Caso necessite, configure as propriedades do E3Browser. Algumas das propriedades deste objeto podem ser configuradas atravs da Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes. Demais informaes sobre as funcionalidades das propriedades deste objeto podem ser encontradas no Manual de Referncia de Scripts do E3 , em seu captulo respectivo.
E3Brow ser
343
Consulta no objeto E3Browser A Consulta apresenta uma interface amigvel que permite a construo das consultas numa forma grfica e o acompanhamento imediato da sintaxe SQL que est sendo gerada.
A aba Consulta mostra os campos disponveis na consulta. Tais campos podem ser acessados atravs do boto Configurar, que abre o assistente de configurao da consulta.
344
E3Brow ser
Aba Consulta Para maiores informaes sobre a Consulta, veja o captulo Consultas.
E3Brow ser
345
Cada campo da aba Estilo possui uma propriedade correspondente. As propriedades disponveis so as seguintes: Opes disponveis na aba Estilo OPO Estilo de grade DESCRIO Determina o estilo da grade do E3Browser. Este campo equivale propriedade GridLinesType do E3Browser. Determina a altura (em pixels) do cabealho do E3Browser. Este campo equivale propriedade FixedRowHeight do E3Browser. Determina a largura da primeira coluna na tabela. Este campo equivale propriedade FixedColumnWidth do E3Browser. Determina a altura das linhas restantes na tabela. Este campo equivale propriedade RowHeight do E3Browser. Determina a largura das colunas da tabela. Este campo equivale propriedade ColumnWidth do E3Browser.
Altura do cabealho
Cada campo da aba Opes possui uma propriedade correspondente. As propriedades disponveis so as seguintes: Opes disponveis na aba Opes OPO Atualizao DESCRIO Determina o intervalo de tempo em que os dados sero atualizados. Este valor deve ser superior a 1000 ms. Este campo equivale propriedade RefreshTime do E3Browser. Determina o tipo de seleo na tabela do E3Browser. Este campo equivale propriedade SelectRow do E3Browser.
Tipo de seleo
Configuraes da aba Cor As opes disponveis deste item so as seguintes: Opes disponveis da aba Cor OPO Propriedades DESCRIO Determina a cor conforme a propriedade selecionada. Determina o conjunto de cores a ser utilizado: Cores padro ou Cores do Windows. 347
Conjunto de cores
E3Brow ser
DESCRIO Determina a cor da propriedade selecionada. Edita uma nova cor personalizada, diferente das cores padro.
Configuraes da Aba Fontes As opes disponveis so referentes a tipo, tamanho e efeitos da fonte.
348
E3Brow ser
18
CAPTULO
E3Chart
O objeto E3Chart um componente ActiveX criado especialmente para trabalhar em conjunto com o E3. Com ele, possvel exibir grficos mostrando Tags variando em tempo real, bem como dados histricos gravados em um Banco de Dados. O E3Chart composto por vrias colees. Uma coleo (collection ) um objeto especial que gerencia um conjunto de objetos semelhantes. O E3Chart possui as seguintes colees: Coleo de Penas: gerencia o conjunto de Penas criadas para manipular a sequncia de dados representada no E3Chart Coleo de Eixos: gerencia os Eixos do E3Chart, onde podem ser configuradas diferentes escalas a serem associadas aos dados das Penas Coleo de Consultas: gerencia as consultas com informaes sobre as Penas (por exemplo, no caso de grficos que mostram dados histricos que j foram gravados em um Banco de Dados) Legenda: gerencia as colunas da Legenda do E3Chart, onde so mostradas as informaes sobre as Penas
Para utilizar os recursos do E3Chart, siga estes procedimentos: 1. Insira o E3Chart no projeto atravs do clique com o boto direito do mouse na Tela, e selecione o objeto E3Chart.
E3Chart
349
Inserindo um E3Chart na Tela 2. Caso seja necessrio, configure as propriedades do E3Chart. Algumas das propriedades deste objeto podem ser configuradas atravs da Lista de Propriedades, sem a necessidade da criao de scripts para isto. Caso necessite configurar alguma propriedade, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes. Demais informaes sobre as funcionalidades das propriedades deste objeto podem ser encontradas no Manual de Referncia de Scripts, em seu captulo correspondente.
350
E3Chart
Aba Item Cada campo da aba Item possui uma propriedade correspondente. As opes disponveis so: Opes disponveis na aba Item OPO Nome DESCRIO Determina o nome do objeto. Este campo equivale propriedade Name do E3Chart. Texto livre que possibilita a documentao das funcionalidades e caractersticas do objeto pelo programador. Este campo equivale propriedade DocString do E3Chart.
Documentao
E3Chart
351
Aba Posio Cada campo da aba Posio possui uma propriedade correspondente. As opes disponveis so as seguintes: Opes disponveis na aba Posio OPO Posio X DESCRIO Define a coordenada horizontal esquerda do objeto, em unidades himtricas. Este campo equivale propriedade X do E3Chart. Define a coordenada vertical superior do objeto, em unidades himtricas. Este campo equivale propriedade Y do E3Chart. Determina a largura do objeto. Este campo equivale propriedade Width do E3Chart. Determina a altura do objeto. Este campo equivale propriedade Height do E3Chart.
Posio Y
Largura
Altura
352
E3Chart
Aba Geral Cada campo da aba Geral possui uma propriedade correspondente. As opes disponveis so as seguintes: Opes disponveis na aba Geral OPO Mostrar ttulo DESCRIO Exibe o ttulo do grfico. Este campo equivale propriedade Title do E3Chart. Determina a cor de fundo do grfico. Este campo equivale propriedade BackColor do E3Chart. Determina a cor de fundo da grade do grfico. Este campo equivale propriedade GridBackColor do E3Chart. Determina o intervalo entre as atualizaes do desenho no grfico. Este campo equivale propriedade RefreshTime do E3Chart.
E3Chart
353
Aba Eixos Quando o E3Chart criado, dois Eixos principais so criados automaticamente: Eixo Horizontal e Eixo Vertical. Estes so os Eixos padro, e no podem ser removidos. Ao clicar no boto Adicionar, criado um novo Eixo no grfico e aberta uma janela de configurao que permite determinar as propriedades do objeto Eixo. Esta janela possui duas abas, Geral e Escala, e tambm pode ser acessada ao clicar o boto Configurar. A aba Geral contm a informao que identifica a Pena no sistema.
354
E3Chart
Propriedades do Eixo Cada campo da aba Geral possui uma propriedade ou mtodo correspondente. As opes disponveis so as seguintes: Opes disponveis na aba Geral OPO Nome DESCRIO Determina o nome do Eixo do grfico. Este campo equivale propriedade Name do Eixo. Determina a posio do Eixo no grfico: Direita ou Esquerda (Eixo vertical), Base ou Topo (Eixo horizontal). Este campo equivale propriedade Position do Eixo. Mostra o Eixo tambm do lado oposto ao escolhido, com efeito de espelho. Este campo equivale propriedade Mirror do Eixo.
Posio
Espelhar o eixo
E3Chart
355
DESCRIO Determina o ttulo do Eixo. Este campo equivale propriedade Title do Eixo. Determina a cor da escala. Este campo corresponde propriedade Color do objeto Eixo. Determina a visibilidade do Eixo no grfico. Este campo equivale propriedade Visible do Eixo. Determina se a cor do texto do Eixo ter a mesma cor da escala. Este campo equivale propriedade EnableTextColor do Eixo. Determina a cor das linhas na grade. Este campo equivale propriedade GridColor do Eixo. Determina o estilo da linha da grade do grfico. Este campo equivale propriedade GridStyle do Eixo. Habilita a visualizao das linhas na grade. Este campo equivale propriedade ShowGrid do Eixo. Determina o intervalo entre os marcadores da escala, caso a opo Automtico esteja desabilitada. Se a escala no for numrica, possvel selecionar a unidade de tempo a que este intervalo se refere. Este campo equivale ao mtodo SetTickSpacing do Eixo. Seleciona automaticamente o intervalo entre os marcadores da escala. Este campo equivale ao mtodo SetTickSpacing do Eixo, com 0 (zero) no valor do intervalo. Determina o nmero de subdivises entre os marcadores. Este campo equivale propriedade MinorTicks do Eixo.
Cor da escala
Visvel
Estilo da linha
Automtico
Nmero de subdivises
Clique em Apply para visualizar as modificaes feitas nesta janela, e em OK para salv-las. A aba Escala define as configuraes da escala do Eixo.
356
E3Chart
Configuraes da escala do E3Chart Cada campo da aba Escala possui uma propriedade ou um mtodo correspondente. As opes disponveis so as seguintes: Opes disponveis na aba Escala OPO Escala numrica DESCRIO Define o Eixo como sendo uma escala numrica. Este campo equivale propriedade ScaleType do Eixo. As opes de configurao da escala numrica so as seguintes: Mnimo: Determina o valor mnimo da escala numrica. Este campo equivale ao mtodo SetMinMax do Eixo Mximo: Determina o valor mximo da escala numrica. Este campo equivale ao mtodo SetMinMax do Eixo
E3Chart
357
DESCRIO Mostra o intervalo de tempo que o Eixo ir mostrar, sempre em relao hora atual. Este campo equivale ao mtodo SetRealTimePeriod do Eixo. Determina um intervalo de tempo fixo. As opes de configurao so as seguintes: Do dia: Data e hora iniciais do intervalo At o dia: Data e hora finais do intervalo Selecionar: Seleciona o intervalo de tempo Este campo corresponde ao mtodo SetHistoricPeriod do Eixo.
Inverte os valores da escala selecionada. Determina a formatao dos valores do Eixo, que pode ser automtica ou personalizada. Este campo corresponde propriedade Format do Eixo.
Clique em Apply para visualizar as modificaes feitas nesta janela, e em OK para salv-las.
358
E3Chart
Aba Penas As opes disponveis so as seguintes: Opes disponveis na aba Penas OPO DESCRIO Adiciona uma Pena. Mostra um menu que permite escolher o tipo de Pena que ser criada: Tempo Real, Histrica ou Tempo Real & Histrica. Remove as Penas selecionadas. Abre a janela de propriedades da Pena selecionada (essa operao s permitida se apenas uma Pena estiver selecionada). Move a Pena selecionada uma posio para cima (essa operao s permitida se apenas uma Pena estiver selecionada). Move a Pena selecionada uma posio para baixo (essa operao s permitida se apenas uma Pena estiver selecionada).
A listagem de Penas do E3Chart permite copiar e colar Penas, tanto no mesmo E3Chart quanto entre E3Charts diferentes. Basta clicar com o boto direito do mouse na Pena desejada (ou nas Penas selecionadas, em caso de mltipla seleo) e selecionar a opo Copiar (CTRL + C). No E3Chart de destino, basta abrir a janela de Propriedades e, na aba Penas, clicar com o boto direito do mouse na listagem de Penas e selecionar a opo Colar (CTRL + V). A opo de Recortar a Pena (CTRL + X) tambm est presente. No caso de o E3Chart de destino j possuir uma Pena com o mesmo nome da Pena sendo copiada, o nome automaticamente incrementado. Algumas propriedades da Pena podem ser configuradas diretamente na lista mostrada na aba Penas. Na coluna Estilo, ao clicar em E3Chart , a seguinte janela ser mostrada. 359
As opes disponveis so as seguintes: Opes disponveis na janela Estilo da Pena OPO Cor principal DESCRIO Define a cor da linha da Pena. Equivale propriedade Color. Define a cor de fundo usada em uma Pena do tipo rea. Equivale propriedade BkColor. Define o tipo de desenho da Pena: Linhas, Pontos, Linhas e Pontos ou rea. Equivale propriedade PenType . Define o tipo de linha: Slida, Tracejada, Pontilhada, Trao-Ponto, Trao-Ponto-Ponto ou Sem Linha. Equivale propriedade PenStyle . Define a espessura da linha. Equivale propriedade Width. Mostra um exemplo de como a Pena ser desenhada no E3Chart.
Cor do fundo
Tipo de desenho
Estilo do trao
Espessura da linha
Amostra
Ao selecionar uma Pena e clicar em , a janela de Propriedades da Pena mostrada. Ela possui cinco abas: Geral, Dados, Estilo, Modo de Ligao e Estatsticas.
360
E3Chart
Propriedades da Pena Cada campo da aba Geral possui uma propriedade correspondente. As opes disponveis so as seguintes: Opes disponveis na aba Geral OPO Nome da Pena DESCRIO Indica o nome da Pena. Este campo equivale propriedade Name da Pena. Determina a cor da linha da Pena. Este campo equivale propriedade Color da Pena. Indica o estado de visibilidade da Pena no grfico. Este campo equivale propriedade Visible da Pena.
Cor principal
Visvel
E3Chart
361
DESCRIO Indica a unidade de engenharia utilizada pela Pena. Este campo equivale propriedade EU da Pena.
Propriedades dos dados da Pena Cada campo da aba Dados possui uma propriedade correspondente. As opes disponveis so as seguintes: Opes disponveis na aba Dados OPO Tipo de pena DESCRIO Determina o tipo de Pena sendo utilizada. Este campo equivale propriedade DataSourceType da Pena.
362
E3Chart
DESCRIO Nome da Associao usada para plotar o dado em uma escala vertical. Este campo equivale propriedade YLink da Pena. Nome da Associao usada para plotar o dado em uma escala horizontal. Este campo equivale propriedade XLink da Pena. Determina o nmero de amostras nas Penas de tempo real. Este campo equivale propriedade BufferSize da Pena. Habilita ou desabilita a estampa de tempo. A estampa de tempo o valor de tempo que acompanha o valor do Tag, indicando o momento em que este valor foi alterado. Este campo equivale propriedade UseTimeStamp da Pena. Se este campo estiver habilitado, a opo Link do Eixo Horizontal fica inativa. Determina a Consulta vinculada ao E3Chart que ser utilizada nos dados do Eixo. Este campo equivale propriedade QueryName da Pena. Determina a consulta externa, isto , os dados viro de uma consulta fora do objeto E3Chart. Nome do campo da Consulta usado para plotar o dado em uma escala vertical. Este campo equivale propriedade YField da Pena. Nome do campo da Consulta usado para plotar o dado em uma escala horizontal. Este campo equivale propriedade XField da Pena. Indica se a Pena deve ou no usar consulta automtica. A consulta automtica no ser utilizada se o E3Chart estiver utilizando um cdigo SQL personalizado, se estiver usando o Storage, ou se possuir vrias tabelas. Este campo equivale propriedade AutoQuery da Pena. Especifica o Eixo vertical. Este campo equivale propriedade ScaleY da Pena.
Consulta local
Consulta externa
Eixo vertical
E3Chart
363
DESCRIO Especifica o Eixo horizontal. Este campo equivale propriedade ScaleX da Pena.
Estilo da Pena Cada campo da aba Estilo possui uma propriedade correspondente. As opes disponveis so as seguintes: Opes disponveis na aba Estilo OPO Tipo de desenho DESCRIO Indica o tipo de desenho da Pena. Este campo equivale propriedade PenType da Pena.
364
E3Chart
DESCRIO Determina o estilo do trao da Pena. Este campo equivale propriedade PenStyle da Pena. Determina a espessura da linha, em pixels. Este campo equivale propriedade Width da Pena. Determina a cor de fundo da linha. Este campo equivale propriedade BkColor da Pena. Determina a documentao que pode ser mostrada na Legenda. Este campo equivale propriedade DocString da Pena. Habilita a verificao do alarme alto. Este campo corresponde propriedade EnableHighLimit da Pena. A caixa de texto ao lado possibilita estabelecer o limite deste alarme, equivale propriedade HighLimit. Habilita a verificao do alarme baixo. Este campo corresponde propriedade EnableLowLimit da Pena. A caixa de texto ao lado possibilita estabelecer o limite deste alarme, equivale propriedade LowLimit. Cor da Pena quando em alarme. Este campo equivale propriedade LimitPenColor. Cor do fundo da Pena quando em alarme. Este campo equivale propriedade LimitPenBkColor.
Espessura da linha
Cor do fundo
Documentao
Cor de alarme
E3Chart
365
O modo como a Pena apresentada quando o scan considerado representado pela cor verde e quando este campo est desabilitado representado pelas cores azul e rosa A aba Modo de Ligao determina o estilo da ligao entre a parte histrica e a parte de tempo real de uma Pena mista.
366
E3Chart
Aba Modo de Ligao As opes disponveis nesta aba so listadas na tabela a seguir. Opes disponveis na aba Modo de Ligao OPO Modo de ligao entre os pontos DESCRIO Define o modo como os pontos entre a parte histrica e a parte de tempo real sero ligados. Este campo equivale propriedade DigitalData. As opes possveis so Digital, onde o traado sempre baseado em retas somente horizontais e verticais, sugerindo variao instantnea, e Analgico, onde o traado busca uma reta unindo cada um dos pontos do grfico. Define o tempo de leitura esperado do Tag da Pena de tempo real. Este campo equivale propriedade ScanValue da Pena.
E3Chart
367
DESCRIO Define se ir mostrar ou no os pontos de qualidade ruim. Equivale propriedade ShowBadPoints da Pena. Especifica um tempo limite a ser considerado para a conexo visual entre a parte histrica e a parte de tempo real de uma Pena mista. Corresponde propriedade MaxGapTime . Reala a linha de ligao entre a parte histrica e a parte de tempo real. Corresponde propriedade HighlightMaxGapTime da Pena. Especifica a cor da ligao. Corresponde propriedade MaxGapTimeColor da Pena. Especifica o estilo da linha de ligao. Corresponde propriedade MaxGapTimeStyle da Pena.
Intervalo mximo para ligar os dados histricos aos de tempo real (s)
368
E3Chart
Estatsticas Cada campo da aba Estatsticas possui uma propriedade correspondente. As opes disponveis so as seguintes: Opes disponveis na aba Estatsticas OPO Calcular dados estatsticos Mostrar linha da mdia DESCRIO Habilita o clculo de dados estatsticos. Exibe a linha da mdia dos dados estatsticos. Exibe o mnimo e o mximo dos dados estatsticos.
E3Chart
369
Objeto Legenda em tempo de execuo Atravs da aba Legenda, possvel configurar as informaes referentes ao objeto Legenda e suas colunas.
Propriedades do objeto Legenda Alguns campos da aba Legenda possuem uma propriedade ou mtodo correspondente. As opes disponveis so as seguintes:
370
E3Chart
Opes disponveis na aba Legenda OPO Mostrar Legenda DESCRIO Habilita a visualizao da Legenda. A caixa de seleo ao lado deste campo define o posicionamento da Legenda. Este campo equivale propriedade Visible da Legenda, e o campo de seleo da posio da Legenda equivale propriedade LegendPos da Legenda. Determina o tamanho da Legenda, em pixels. Pode ser a altura ou a largura, dependendo da posio. A outra dimenso acompanha a do E3Chart. Este campo corresponde propriedade Size da Legenda. Determina a cor de fundo da Legenda. Este campo corresponde propriedade BackColor da Legenda. Lista as colunas disponveis para visualizao na Legenda. Mostra as colunas selecionadas para a Legenda. Adiciona uma coluna Legenda. Este boto equivale ao mtodo InsertColumn da Legenda. Abre uma caixa de dilogo para a configurao das propriedades dos campos das colunas da Legenda. Remove a coluna selecionada da Legenda. Este boto equivale ao mtodo RemoveColumn da Legenda. Troca a posio da coluna na Legenda. Estes campos equivalem ao mtodo ChangeColumnPos da Legenda. Habilita o cabealho da Legenda. Este campo equivale propriedade ShowHeader da Legenda. Determina se a cor do texto da Legenda ser a mesma da Pena. Este campo equivale propriedade EnableTextColor da Legenda.
Tamanho
Cor do fundo
Colunas disponveis
Colunas selecionadas
Adicionar
Propriedades
Remover
Sobe/Desce
E3Chart
371
Os campos disponveis na opo Colunas disponveis so: Opes disponveis para identificao de colunas OPO Cor da Pena Descrio da Pena DESCRIO Mostra a cor da Pena. Mostra a descrio contida na propriedade DocString da Pena. Mostra a diferena entre os cursores inicial e final. Mostra a diferena no Eixo Y entre os pontos interpolados inicial e final. Mostra o nome do Eixo X associado Pena. Mostra o nome do Eixo Y associado Pena. Mostra o estado de funcionamento atual da Pena. Mostra a posio final do cursor. Mostra o ponto interpolado onde o cursor final cruza com a Pena. Mostra a posio inicial do cursor. Mostra o ponto interpolado onde o cursor inicial cruza com a Pena. Mostra o valor mximo da Pena no intervalo. Mostra o valor mdio da Pena no intervalo. Mostra o valor mnimo da Pena no intervalo. Mostra o nome da Pena. Mostra o nome do Tag associado ao Eixo X. Mostra o nome do Tag associado ao Eixo Y. Mostra a unidade de engenharia utilizada pela Pena. Mostra o valor da pesquisa no Eixo X.
DifX
DifY
FimX FimY
InicioX InicioY
MaximoY MediaY MinimoY Nome da Pena Nome do tagX Nome do tagY Unidade
Valor do tagX
372
E3Chart
Ao clicar em Propriedades, mostrada uma caixa de dilogo para configurao do objeto Coluna da Legenda.
Propriedades da coluna Cada campo da caixa de dilogo Propriedades da coluna possui uma propriedade correspondente. As opes disponveis so as seguintes: Opes disponveis na janela Propriedades da coluna OPO Largura inicial DESCRIO Define a largura inicial da Coluna, em pixels. Este campo equivale propriedade Width da Coluna da Legenda. Determina o ttulo da Coluna. Este campo equivale propriedade Caption da Coluna da Legenda. Determina o alinhamento do texto na Coluna da Legenda, Este campo equivale propriedade TextAlign da Coluna da Legenda. Determina o formatador da Coluna selecionada. Este campo equivale propriedade Format da Coluna da Legenda.
Ttulo da coluna
Alinhamento do texto
Formatador
E3Chart
373
Configurao das Consultas As opes disponveis so as seguintes: Opes disponveis na aba Consultas OPO Consultas Configurar Adicionar DESCRIO Mostra a Consulta selecionada para edio. Configura a Consulta selecionada. Adiciona uma nova Consulta. Para obter maiores informaes referentes s Consultas, veja o captulo Consultas. Remove a Consulta selecionada.
Remover
NOTA : Ao clicar em Adicionar ou Configurar, uma caixa de dilogo aberta para especificao do Servidor de Banco de Dados que guarda a Consulta. Os procedimentos de definio da Consulta podem ser encontrados no captulo Consultas.
374
E3Chart
E3Chart
375
5. No segundo boto de comando, escreva na propriedade Caption a descrio "Habilitar Pena". 6. Acesse as propriedades deste boto e selecione a aba Scripts. No evento Click do boto de comando, escreva o seguinte script:
Sub CommandButton2_Click() Set Pen1= Screen.Item("E3Chart1").Pens.Item("Pena1") Pen1.Connect() End Sub
376
E3Chart
Filtro a ser criado no campo E3TimeStamp 7. Aps ter criado o filtro conforme especificaes acima, clique em OK. 8. Crie uma nova Pena. Acesse as propriedades desta Pena e na aba Dados, item Tipo de Pena, selecione a opo Histrica usando a Consulta e indique o campo da Consulta configurada. 9. No item Campo do eixo vertical, indique um campo da tabela. No item Campo do eixo horizontal, indique o campo E3TimeStamp. Clique em OK. 10.Crie um novo boto na Tela e na propriedade Caption, escreva "Atualizar E3Chart Histrico". 11.Acesse os scripts deste boto e no evento Click, escreva o seguinte cdigo:
Sub CommandButton3_Click() Set Chart = Screen.Item("E3Chart1") Set Consulta = Chart.Item("Consulta1") Consulta.SetVariableValue "Ini", Now 1 / 24 Consulta.SetVariableValue "Fim", Now Chart.HorScaleBegin = Now 1 / 24 Chart.HorScaleEnd = Now Chart.Queries.UpdateData() End Sub
E3Chart
377
3. Crie dois botes na Tela. No primeiro, mude a propriedade Caption para "Desabilitar Visualizao da Pena". 4. Acesse as propriedades deste boto e selecione a aba Scripts. No evento Click do boto de comando, escreva o seguinte script:
Sub CommandButton1_Click() Set Pen1= Screen.Item("E3Chart1").Pens.Item("Pena1") Pen1.Visible = False End Sub
5. No segundo boto de comando, mude a propriedade Caption para "Habilitar Visualizao da Pena". 6. Acesse as propriedades deste boto e selecione a aba Scripts. No evento Click do boto de comando escreva o seguinte script:
Sub CommandButton2_Click() Set Pen1 = Screen.Item("E3Chart1").Pens.Item("Pena1") Pen1.Visible = True End Sub
378
E3Chart
Opes do menu do E3Chart em tempo de execuo As opes disponveis so as seguintes: Opes disponveis do menu contextual do E3Chart em tempo de execuo OPO Caixa de zoom DESCRIO Coloca o mouse no modo zoom por rea selecionada. Esta opo est disponvel nos grficos de escala numrica em XY e escala fixa. Coloca o mouse em modo de movimentao das escalas. Coloca o mouse em modo de movimentao das escalas somente na direo horizontal. Coloca o mouse em modo de pesquisa de valores nos dados das Penas. 379
Mover
Mover horizontalmente
Pesquisar
E3Chart
DESCRIO Habilita a opo de pesquisa de intervalos de tempo. Diminui o zoom de todo o Eixo. Aumenta o zoom de todo o Eixo. Enquadra a Pena selecionada em ambos os Eixos. Enquadra a Pena selecionada somente no Eixo vertical. Enquadra a Pena selecionada somente no Eixo horizontal. Enquadra a Pena selecionada ou todas as Penas existentes.
Enquadrar verticalmente
Enquadrar horizontalmente
Enquadrar Pena
380
E3Chart
NOTA : Para obter maiores informaes sobre as colunas Valor do Tag X e Valor do Tag Y, veja o tpico Configuraes da Legenda.
Pesquisa de intervalos
E3Chart
381
Mensagens de status da parte histrica MENSAGEM Info: Consulta aguardando SIGNIFICADO Aguardando a inicializao da consulta. Significa que alguma mudana ou pedido de atualizao da consulta foi detectado. A consulta est iniciando. Nesta fase so validados os campos informados na Pena. Antes de carregar os dados da consulta, o E3Chart precisa conhecer os campos que a consulta contm para realizar a associao entre estes campos e as propriedades XField e YField. Ocorreu uma falha ao buscar estes campos, que pode ser tanto um erro de rede quanto um erro de sintaxe SQL. O campo informado na propriedade XField no foi encontrado na consulta. Verifique se o campo est selecionado na tela de edio da consulta ou no cdigo SQL. O campo informado na propriedade YField no foi encontrado na consulta. Verifique se o campo est selecionado na tela de edio da consulta ou no cdigo SQL. Indica que houve um erro na consulta, no sendo possvel recuperar os dados. As possveis mensagens mostradas em Mensagem de Erro so descritas na tabela a seguir. Mostra o nmero total de pontos da parte histrica. Indica que os dados da consulta ainda esto sendo carregados do servidor. A consulta indicada pela propriedade QueryName da Pena no foi encontrada pelo E3Chart.
Info: n pts
Info: Carregando
382
E3Chart
Mensagens especficas para falha na consulta MENSAGEM Falha ao inserir dados SIGNIFICADO No foi possvel carregar os dados para a memria. No foi possvel criar a consulta. No foi possvel executar a consulta. No foi possvel trazer do servidor os resultados da consulta. No foi possvel trazer do servidor o total de registros existentes na consulta. No foi possvel posicionar o cursor no primeiro registro da consulta. Os registros da consulta no esto disponveis para serem trazidos do servidor. No foi possvel trazer do servidor os registros da consulta. Houve um erro inesperado ao tentar trazer do servidor os dados da consulta.
Falha na criao da consulta Erro ao executar a consulta Falha ao baixar os dados do servidor
Falha ao pegar o nmero de registros do servidor Falha ao posicionar o cursor para o incio
Cursor ocupado
Erro desconhecido
E3Chart
383
19
CAPTULO
E3Playback
Uma ferramenta de playback visa facilitar o ps-operao, sobretudo a anlise de ocorrncias. Sua necessidade justificada por permitir que o usurio visualize, atravs das telas de monitorao em tempo real, as variaes de eventos e pontos analgicos em tempo passado, o qu, em determinados casos, pode ser complicado observando apenas relatrios de eventos e valores analgicos. Cabe ressaltar que um playback uma ferramenta que permite a um operador experiente e conhecedor do processo interpretar os acontecimentos de forma mais clara. No faz parte do escopo de um playback a identificao automtica de soluo ou de causa de uma ocorrncia. Um exemplo prtico de uso de um playback pode ser o seguinte: O usurio, ao chegar em seu horrio de trabalho, recebe a informao de uma grave ocorrncia acontecida durante a madrugada, por volta das 3h15min. Ele pode ento abrir na ferramenta de playback uma tela que contm o ponto gerador do evento e outros pontos relacionados, movendo o relgio para as 03h10min e apertando a tecla Play. Ao observar a tela sendo animada com os dados histricos, o usurio facilmente acompanha o estado geral do processo, avanando e retrocedendo livremente no tempo at compreender perfeitamente a causa da ocorrncia.
384
E3Play bac k
Incluso do E3Playback em uma Tela 2. Acesse a Lista de Propriedades e configure a propriedade DBServer do E3Playback, fazendoa apontar para o objeto Banco de Dados que contm os dados histricos do aplicativo.
Selecionando um Banco de Dados 3. Acesse a Lista de Propriedades e configure a propriedade InitialScreen do E3Playback, fazendo-a apontar para o quadro FrameApp .
E3Play bac k
385
Selecionando um Quadro para a propriedade InitialScreen 4. Abra a Tela UpperMenu e insira a imagem Stopwatch no canto superior direito (abra a Galeria e selecione a categoria Misc Symbols 1 ).
Tela UpperMenu 5. D um duplo-clique no Stopwatch, adicione o pick Abrir Tela no evento Click, para abrir a TelaPlayback no Quadro principal e configure-o conforme as figuras a seguir.
386
E3Play bac k
Configuraes do estilo da janela 6. Rode o aplicativo, abra o Viewer, clique em Portugus, depois em Preview de Aplicaes, e E3Play bac k 387
finalmente clique sobre o cone Stopwatch. Neste momento deve aparecer a tela de playback.
Tela de playback 7. Aperte o boto para entrar no modo online. Os primeiros dados de playback sero carregados, e o relgio de playback ser posicionado no centro dos dados disponveis.
388
E3Play bac k
E3Play bac k
389
Possui os seguintes botes: Botes da Barra de Ferramentas CONE COMANDO Reproduzir (para trs) AO Inicia a reproduo dos dados no horrio atual de playback, retrocedendo o relgio de acordo com a velocidade de reproduo atual. Congela o relgio de playback no tempo atual. Inicia a reproduo dos dados no horrio atual de playback, avanando o relgio de acordo com a velocidade de reproduo atual. Interrompe o playback, os dados de tags e alarmes so removidos das telas e nenhuma nova consulta feita ao banco de dados. Diminui a velocidade de playback pela metade. O valor mnimo 1/1024x, isto , avana aproximadamente um milissegundo de dados a cada segundo. Deixa a velocidade de playback no valor normal (1x).
Pausa
Reproduzir
Parar
Mais Devagar
Velocidade Normal
390
E3Play bac k
CONE
AO Dobra a velocidade de playback. O valor mximo 1024x, isto , a cada segundo o relgio de playback avana 1024 segundos (aproximadamente 17 minutos). Permite selecionar a velocidade de playback. Mostra a data/hora atual do relgio de playback, e permite selecionar uma nova data.
Seletor de Velocidade
Data/Hora Atual
Mostrar/esconder a Linha de Mostra ou oculta a janela Tempo Linha de Tempo do E3Playback. Mostrar/esconder a Lista de Tags Mostrar/esconder a Lista de Eventos Iniciar/parar gravao de vdeo Mostra ou oculta a janela Tags do E3Playback. Mostra ou oculta a janela Eventos do E3Playback. Permite gerar um vdeo (em formato AVI) capturando toda a rea do ActiveX de playback durante um determinado perodo, ou at que o usurio mande parar a gravao. Permite capturar a rea de tela do ActiveX de playback. A tela capturada pode ser salva em um arquivo BMP ou colocada na rea de transferncia do Windows.
E3Play bac k
391
Janela de opes de Gravao de Vdeo As opes disponveis so as seguintes: Opes disponveis na janela Opes de gravao OPO Salvar vdeo como DESCRIO Mostra o local e o nome do arquivo de vdeo que ser salvo. Pode ser utilizado o boto para navegar pelas pastas do computador. Tempo mximo de gravao Permite definir um tempo total para gravao. Se o valor estiver em Indefinido, a gravao apenas para se o boto de gravao de vdeo do E3Playback for pressionado. A opo Tempo permite que seja pr-definido um tempo mximo de gravao, em segundos (neste caso a gravao encerrada automaticamente ao final do tempo estipulado). Configura o nmero de quadros (frames) capturados a cada segundo de gravao.
392
E3Play bac k
DESCRIO Quando esta opo estiver habilitada, ir aparecer o cursor do mouse no vdeo gravado. O padro essa opo desabilitada. O ponteiro do mouse gravado no vdeo o que estiver configurado como padro do sistema. Ponteiros com animao no ficaro animados no vdeo. Nesse caso, ser mostrado sempre o primeiro quadro da animao. Compressor de vdeo utilizado na gravao. Sero listados todos os compressores que esto instalados no computador, desde que sejam suportados pelo E3Playback. Configura a taxa de compresso, que ir afetar a qualidade final do vdeo e, consequentemente, o tamanho do arquivo gerado. Configura a quantidade de quadros a cada quadro-chave (key frame). Abre uma nova janela que possui configuraes especficas do compressor selecionado. Abre uma nova janela que possui informaes sobre o compressor selecionado. Habilita a gravao de udio. O padro dessa opo desabilitado. Lista os dispositivos de udio instalados e habilitados no sistema e que podem ser utilizados na captura de udio. Mostra informaes sobre o formato de udio atualmente selecionado. Mostra informaes sobre os atributos do formato de udio atualmente selecionado. Mostra uma janela que permite alterar o formato de gravao e os atributos do udio. Habilita ou desabilita a janela que mostrada no momento em que a gravao finalizada.
Compressor
Qualidade de compresso
Sobre
Gravar udio
Dispositivo
Formato
Atributos
E3Play bac k
393
Linha de tempo Possui os seguintes componentes: Componentes da Linha de Tempo COMPONENTE Rgua DESCRIO Mostra a linha de tempo. Pode-se mover a linha de tempo para os lados clicando e arrastando o mouse. O zoom controlado pelo mouse wheel . Girando para cima, feito um zoom in . Girando para baixo, zoom out. necessrio primeiro clicar sobre o fundo da linha de tempo antes de tentar fazer o zoom. Se a tecla CTRL estiver pressionada, o zoom feito trs vezes mais rpido. Marca a posio atual do relgio de playback . Quando o playback est no modo Pausa pode-se arrastar o cursor para os lados, alterando o relgio de playback enquanto arrasta-se o cursor. Est sempre visvel na linha de tempo.
Cursor
394
E3Play bac k
DESCRIO Mostra os perodos de tempo que j tem dados carregados: Uma linha verde clara significa que naquele perodo os dados j esto totalmente carregados Uma linha verde escura indica que os dados do perodo esto sendo carregados Uma linha amarela clara indica que o perodo contm alguns dados carregados. Novas consultas ao banco sero necessrias se o cursor for movido para cima do perodo Uma linha cinza clara indica que o perodo no tem nenhum dado carregado ainda. Para carregar os dados do perodo, mova o cursor de playback para cima do perodo
Barra de Dados
Indica com um ponto azul cada momento em que h um evento de playback. Mostra o perodo de dados que est sendo mostrado na Linha de Tempo, comparado com o perodo total de dados disponvel para playback.
Caso tenha sido selecionada a opo Mostrar grfico na Linha de Tempo de um tag na Lista de Eventos ou na Lista de Tags, ser mostrada uma representao visual do tag esquerda do grfico. Esta representao varia de acordo com o tipo de dados do tag. String: Mostra caixas de texto com o nome do tag Booleano ou Digital: Mostra um grfico de estado do tag, onde o valor do tag ficar sempre sobre uma linha inferior (Off ou False) ou sobre uma linha superior (On ou True). A linha do grfico fica pontilhada nos perodos em que a qualidade do tag est ruim Double, Integer ou Analgico: Mostra um grfico de linha com os valores do tag. A escala do grfico (inferior e superior) calculada automaticamente de acordo com os valores do tag que o E3Playback j consultou no banco de dados. Assim como no grfico digital, a linha do grfico fica pontilhada nos perodos em que a qualidade do tag est ruim. A linha tambm pode ser interpolada ou em escada, dependendo se o tag suporta (Storage) ou no (Histrico) interpolao
E3Play bac k
395
Mostrar grfico na Linha de Tempo Cada tag adicionado na Linha de Tempo possui uma cor definida automaticamente, que pode ser alterada usando a opo Alterar a cor do menu contextual. Esta opo abre a janela de Cores do sistema, permitindo selecionar uma nova cor ou personalizar a cor selecionada.
19.3.3 Marcadores
Os Marcadores so utilizados para sinalizar ocorrncias na linha de tempo do E3Playback.
Opes disponveis na barra de ferramentas Marcadores CONE COMANDO Adicionar marcador no timestamp selecionado AO Adiciona um nome ao marcador na linha de tempo, na data e hora selecionadas.
Editar marcador selecionado Permite editar o marcador selecionado, podendo alterar data/hora, nome ou descrio. Remover o marcador Remove o marcador selecionado na linha de tempo. Remove todos os marcadores criados na linha de tempo. Seleciona o marcador imediatamente frente na linha de tempo e na lista de eventos, simultaneamente.
396
E3Play bac k
CONE
Clicando no boto
Adicionar, ou no boto
As opes disponveis so as seguintes: Opes disponveis na janela Adicionar/Editar Marcador OPO Data/hora/ms DESCRIO Permite selecionar a data e a hora (incluindo os milissegundos) do marcador. Estes campos j vm preenchidos com a data e a hora selecionadas na linha de tempo. Permite selecionar o nome do marcador. Permite informar algum comentrio adicional para o marcador.
Nome Comentrios
Quando um marcador criado, ele mostrado na Linha de Tempo, como pode ser observado na figura seguinte, e tambm na Lista de Eventos.
E3Play bac k
397
rea de Telas A rea de Telas funciona como se fosse um Viewer dentro do E3Playback. As telas so sempre abertas no zoom Preencher. possvel navegar livremente entre as telas do aplicativo. Existem algumas restries e comentrios quanto ao funcionamento das telas dentro do E3Playback: As telas funcionam como se estivessem em um Viewer Read-Only, isto , no permitido o envio de comandos e valores para o servidor do E3. Isto garante que as operaes efetuadas no E3Playback no iro perturbar o funcionamento do aplicativo em tempo real No permitido acesso aos objetos do servidor atravs do mtodo Application.GetObject. Se este mtodo for chamado em algum script, ele ir falhar, abortando o script Devido s vrias limitaes de acesso ao servidor, erros de script ocorridos dentro do E3Playback no geram uma mensagem de erro, os scripts so abortados silenciosamente O E3Playback emula um Viewer real. Para isto criada uma nova cpia do objeto Viewer e seus tags para uso do E3Playback. Se algum comportamento especfico do Viewer tiver que 398 E3Play bac k
ser habilitado ou desabilitado dentro do E3Playback, pode-se testar a propriedade IsPlaybackMode , do objeto Viewer O isolamento entre as telas que rodam dentro do E3Playback e o que est fora total O E3Playback trata os novos quadros criados pelo aplicativo como novas abas no topo da rea de Telas. O ttulo da aba o nome do Quadro ou Tela que foi aberto
Quadros abertos em abas no E3Playback Todas as associaes que se referem a objetos do servidor so capturadas pelo E3Playback, e passam a receber os dados histricos de acordo com o relgio atual de playback. Isto inclui no apenas as associaes feitas nas telas que esto sendo mostradas, mas tambm os links existentes nos tags do Viewer As associaes feitas entre objetos do Viewer (por exemplo, um Display mostrando o valor de um Tag Demo interno ao Viewer) funcionam normalmente, sem nenhuma interferncia do playback O E3Chart s ir funcionar dentro do E3Playback se estiver configurado com penas histricas. Penas de tempo real so desabilitadas dentro do E3Playback (ficam sem dados) O E3Alarms ir mostrar o sumrio de alarmes de acordo com o que estiver registrado na tabela de alarmes no banco de dados O E3Browser ir funcionar normalmente, j que consultas ao banco de dados so permitidas dentro do E3Playback
E3Play bac k
399
NOTA : Os dados mostrados no E3Browser so sempre os dados ATUAIS do banco de dados, isto , o E3Playback no tenta emular o estado do banco de dados em um momento no passado.
Lista de Eventos A lista possui trs colunas: Campos da Lista de Eventos CAMPO Data/hora DESCRIO Mostra a data e a hora do evento, conforme est registrado no banco de dados.
400
E3Play bac k
DESCRIO Mostra o caminho do tag ou da fonte de alarmes que gerou este evento, ou o nome do marcador. Se o evento for de mudana do valor de um tag, mostra o novo valor. Se a qualidade no for Boa (192), ela ser mostrada na frente do valor (por exemplo, "Ruim(20); 45.433"). Se o evento for uma alterao no estado de um alarme, mostra o nome da sub-condio (HI, HIHI, LO, LOLO, etc.) e a descrio do alarme. Se o alarme est (ou foi) reconhecido, mostra no incio o texto ACK, com o nome do operador entre parnteses. Se for um marcador, este campo mostra o comentrio associado ao mesmo.
Evento
A barra de ferramentas da Lista de Eventos possui as seguintes operaes: Opes da barra de ferramentas da Lista de Eventos CONE COMANDO Evento Anterior AO Posiciona o relgio de playback no evento anterior ao evento selecionado na lista, pulando os eventos com timestamp igual ao timestamp atual. Posiciona o relgio de playback no prximo evento com timestamp maior que o timestamp atual. Este boto liga ou desliga o filtro de eventos. Ao ligar o filtro, apenas os eventos do tag ou da fonte de alarme selecionado atualmente sero mostrados na lista de eventos. Os marcadores so mostrados sempre, independente do filtro. Mostra apenas os marcadores criados.
Prximo Evento
Filtrar Eventos
Filtrar marcadores
E3Play bac k
401
Ao clicar com o boto direito do mouse sobre um evento, um menu contextual mostrado com as seguintes opes. Opes do menu contextual dos eventos OPO Mostrar ou Remover grfico na Linha de Tempo DESCRIO Adiciona ou remove uma representao visual do tag selecionado na janela Linha de Tempo. Filtra os eventos na Lista de Eventos para mostrar apenas o tag selecionado. Selecionando de novo esta opo mostra todos os eventos.
Lista de Tags As colunas so as seguintes: Colunas da Lista de Tags COLUNA Caminho do Tag Tabela DESCRIO Mostra o caminho do tag. Mostra o nome da tabela do banco de dados que contm os dados do tag. Indica se o tag foi encontrado ou no no banco de dados. Mostra o valor do tag na data/hora atual de playback.
Estado
Valor
402
E3Play bac k
COLUNA Data/hora
DESCRIO Mostra o timestamp atual do tag. Se o tag suportar interpolao (apenas para pontos analgicos armazenados no Storage), ento o timestamp ser igual ao horrio atual de playback. Caso contrrio, o timestamp ser o do ltimo evento com timestamp anterior ou igual ao horrio atual de playback. Mostra a qualidade do tag (padro OPC) no momento atual de playback. Quando a qualidade 192, mostrado apenas o texto "Boa". Mostra o timestamp do evento anterior deste tag no banco de dados. Se o tag no suportar interpolao, o evento anterior ser sempre igual ao timestamp atual do tag. Se o tag suportar interpolao, o evento anterior ser o ltimo timestamp registrado no banco de dados antes do horrio atual de playback. Mostra o timestamp do prximo evento deste tag.
Qualidade
Evento Anterior
Prximo Evento
NOTA : A Lista de Tags pode ajudar tambm a determinar quais tags necessitam ser gravados no banco de dados para permitir o playback completo de uma tela, bastando verificar os tags com o sinal de proibido .
Ao clicar com o boto direito do mouse em um tag, um menu contextual mostrado com as mesmas opes descritas no tpico Lista de Eventos, exceto no caso de tags marcados com o cone , em que o menu contextual aparece desabilitado.
E3Play bac k
403
NOTA 1 : o intervalo de datas vlidas no atualizado durante um processo de playback, de forma que os dados novos que forem adicionados ao banco aps a montagem do banco de dados s estaro disponveis se a janela de playback for fechada e aberta novamente. NOTA 2 : em modo DEMO (ou com uma licena de Studio) o perodo permitido para playback se resume s ltimas seis horas de dados armazenados no banco de dados.
retornado: O ltimo evento anterior ao incio da consulta Todos os eventos ocorridos durante o perodo da consulta O prximo evento que ocorreu aps o perodo da consulta Informaes de alarmes que devem ser consultadas (zero ou mais das seguintes opes): Sumrio de alarmes anterior (estado de cada Fonte de Alarme na data/hora inicial da consulta) Eventos de alarmes no perodo Sumrio de alarmes posterior (prximo evento de cada Fonte de Alarme aps a data/ hora final do perodo)
Para executar uma consulta a dados de playback normalmente so necessrias vrias consultas ao banco de dados. O servidor de dados de playback efetua estas consultas de forma assncrona e em um thread separado, coleta os dados e s os retorna quando todas as consultas tiverem terminado. Quando uma consulta de playback completada, os dados so imediatamente adicionados fatia correspondente e o E3Playback automaticamente dispara consultas para atualizar as fatias vizinhas. Desta forma, medida que o relgio de playback avanado, as consultas de dados vo sendo feitas, e quando o relgio passa para a prxima fatia bem provvel que ela j tenha todos os seus dados carregados. Caso o relgio de playback esteja no modo Reproduzir e entre em uma fatia sem dados ou com dados incompletos, o E3Playback fica temporariamente pausado aguardando que as consultas daquela fatia sejam completadas. O E3Playback tambm busca minimizar o acesso ao banco de dados, aproveitando as informaes dos campos ltimo evento anterior, Prximo evento aps, Sumrio anterior e Sumrio posterior para evitar que estes dados sejam consultados novamente. Por exemplo: Se uma consulta a um tag no retornou o prximo evento aps o perodo da consulta, sinal de que este tag no possui nenhum evento aps a data/hora final da consulta, e portanto este tag no precisa ser consultado nas fatias de tempo posteriores Se uma consulta retornou o sumrio anterior, eventos de alarmes no perodo e o sumrio posterior para uma fatia, possvel calcular o sumrio anterior da prxima fatia simplesmente combinando o sumrio anterior e os eventos ocorridos durante a fatia atual. Desta forma, torna-se desnecessrio consultar no banco de dados o sumrio anterior da prxima fatia
406
E3Play bac k
19.5.1 Storage
A nica recomendao para o Storage que a coluna Fonte no deve conter expresses, pois elas no podero ser utilizadas no playback. O E3 j cria automaticamente nas tabelas de Storage os ndices necessrios para otimizar as consultas do E3Playback.
19.5.2 Alarmes
Para fazer playback de alarmes, siga estes procedimentos: 1. Habilite ou configure o registro de alarmes em disco. 2. Selecione os seguintes campos para registro (obrigatrio). EventTime (mais EventTimeMS) ou EventTimeDbl FullAlarmSourceName ConditionActive Acked AckRequired 3. Ainda recomendada a seleo dos seguintes campos para registro: InTime (mais InTimeMS) ou InTimeDbl OutTime (mais OutTimeMS) ou OutTimeDbl AckTime (mais AckTimeMS) ou AckTimeDbl Area ActorID Enabled EventCategory EventType E3Play bac k 407
Seleo dos campos O E3 j cria automaticamente na tabela de alarmes os ndices necessrios para otimizar as consultas do playback.
19.5.3 Histricos
O formato de arquivo Histrico no o ideal para playback, pois normalmente muitos dados duplicados esto armazenados. As consultas de playback tem um trabalho extra para eliminar os valores duplicados de cada tag e encontrar apenas os eventos de mudana de valor, o que pode exigir longas consultas sequenciais pela tabela do Histrico. recomendado o uso do Storage sempre que possvel. Se for indispensvel o uso de dados de Histrico no playback, deve-se seguir ao mximo as seguintes recomendaes: Configurar a propriedade UserTable para False (se esta propriedade ficar em True, a tabela _Fields deste histrico no ser gerada, e este histrico no ser reconhecido pelo playback) Colocar cada tag em um campo separado (no utilizar expresses na fonte do campo, por exemplo) Criar um ndice para o campo E3TimeStamp. Sem este ndice as consultas ao Histrico ficam muito lentas, tornando o playback impraticvel Utilizar tabelas com poucos campos e, se possvel, adicionar um ndice individual para cada campo (principalmente para os campos com poucas variaes) 408 E3Play bac k
A figura a seguir mostra como deve ser a configurao do ndice do campo E3TimeStamp:
19.5.4 Licenciamento
A Elipse fornece dois pacotes de playback de acordo com as suas ferramentas: Playback Bsico Playback Avanado: consiste no Playback Bsico mais as ferramentas de Gravao de Vdeo e Captura de Tela
Cada um destes pacotes dimensionado conforme o nmero de pontos (Tags e Fontes de Alarmes) armazenados no banco de dados. Por exemplo, um Playback Bsico 1000 permite fazer playback de um banco de dados com at 1000 pontos. Se o banco de dados tiver mais pontos que as licenas disponveis, a montagem do banco ir falhar e ser mostrada uma mensagem de erro indicando que no h licenas disponveis para rodar o playback. A licena de Studio do E3 inclui uma licena de Playback Avanado sem limite de pontos, porm limitada s ltimas seis horas de dados armazenados no banco. Isto permite que o desenvolvedor do aplicativo teste o playback sem precisar adquirir as licenas para isto. Em modo Demo (quando no h dispositivo de proteo), o playback tambm funciona no E3Play bac k 409
modo Avanado sem limite de pontos, porm limitado a mostrar apenas as ltimas seis horas de dados armazenados no banco.
IMPORTANTE: Se o dispositivo de proteo for do tipo Master (Studio + Runtime ) ou apenas de Runtime , o playback s estar disponvel se houver licenas programadas no dispositivo. Para maiores informaes sobre as limitaes do modo Demo do E3, veja o tpico Limitaes do Modo Demonstrao.
410
E3Play bac k
20
CAPTULO
Frmulas
Frmulas so mdulos destinados ao armazenamento e transferncia de conjuntos de valores para determinados agrupamentos de variveis, de forma a criar configuraes pr-definidas. So compostas de trs partes: Templates, Unidades e Conjuntos de Valores. As Frmulas podem ser utilizadas para facilitar processos industriais. Por exemplo, uma fbrica de bebidas faz vrios tipos de sucos, cada um deles com uma receita diferente. Neste caso, os templates so os sabores (laranja, uva, tangerina, etc.). As unidades so os tanques onde os sucos so produzidos. E o tipo e a quantidade de produtos colocados em cada suco (por exemplo, 50g de acar, 1000l de gua, polpa de fruta, etc.) so os conjuntos de valores. Para utilizar este recurso, siga este procedimento: 1. Clique com o boto direito do mouse sobre o nome do projeto no Organizer e selecione a opo Inserir - Frmula.
NOTA : O objeto Frmula pode ser configurado para funcionar como rea de Alarme .
Frmulas
411
Janela para configurao do Banco de Dados e da tabela As opes disponveis so: Opes disponveis na janela Configurao do Banco de Dados OPO Banco de Dados DESCRIO Determina o servidor de Banco de Dados que gerenciar os dados configurados na Frmula. Determina o nome da tabela.
Tabela
Caso seja necessrio configur-los posteriormente, ou mesmo reconfigur-los, basta escolher a opo Configurar Banco de Dados no menu contextual.
412
Frmulas
Frmulas
413
20.2 Templates
A primeira aba na view de Frmulas chama-se Templates. Os templates definem o tipo de dado que poder ser armazenado em cada varivel da Frmula, alm de suas restries.
Aba Templates As opes disponveis so as seguintes: Opes disponveis na aba Templates OPO Nome Tipo Restries DESCRIO Define o nome do template. Define o tipo do template. Determina as restries do template.
A barra de ferramentas da view Templates tem os seguintes botes: Adicionar criao de um novo template; e Remover Ao clicar em
, para a
414
Frmulas
Edio das restries As restries permitem habilitar ou desabilitar a alterao dos valores da Frmula em tempo de execuo, ou ento estipular limites para esta alterao. As opes disponveis so: Opes disponveis na janela Edio das Restries OPO Limite Irrestrito DESCRIO O usurio pode alterar qualquer valor no template. simbolizado pela letra U na view Templates. O usurio no pode alterar o valor do template. simbolizado pela letra R na view Templates. So definidos valores fixos como limites, correspondendo ao valor mnimo e mximo do template. simbolizado pela letra A na view Templates (e os valores mnimo e mximo configurados no campo). Valor percentual acima ou abaixo do valor pr-definido. Por exemplo, colocando os limites entre 20% e 30%, para o valor 100, os valores permitidos variam entre 80 e 130. simbolizado pela letra P na view Templates (e os valores configurados no campo).
Limite Restrito
Limite Absoluto
Limite Percentual
Frmulas
415
DESCRIO Valores fixos acima ou abaixo do valor prdefinido. Por exemplo, colocando os limites em 10 e 50 para o valor 50, os valores permitidos variam de 40 e 100. simbolizado pela letra D na view Templates (e os valores configurados no campo).
20.3 Unidades
A segunda aba na view de Frmulas chama-se Unidades. As unidades definem os Tags que sero associados aos templates da Frmula. possvel criar vrias unidades, ou seja, vrios grupos de Tags que podero receber os valores da Frmula.
Aba Unidades As opes disponveis so as seguintes: Opes disponveis na aba Unidades OPO Nome Unidade DESCRIO Determina o nome do template. Determina o Tag que ser associado unidade.
A barra de ferramentas da view Unidades tem os seguintes botes: Adicionar criao de uma nova unidade; Remover
, para a
Renomear , para a troca do nome da unidade selecionada. Para cada nova unidade, solicitado um nome: 416 Frmulas
Aba Valores As opes disponveis so as seguintes: Opes disponveis na aba Valores OPO Nome Valor DESCRIO Determina o nome do template. Determina o valor dos campos do conjunto de valores.
A barra de ferramentas da view Valores tem os seguintes botes: Adicionar de um novo conjunto de valores; Remover selecionado; e Renomear
, para a criao
Frmulas
417
20.5.1 Procedimentos
1. Insira um objeto Frmula na aplicao. 2. Configure o Banco de Dados e a tabela. Use um Banco de Dados existente no projeto, e chame a tabela de Produo .
Configuraes do Banco de Dados e da tabela 3. Crie trs templates na Frmula: Dimetro Externo , com restrio de valor absoluta entre 50 e 80 Dimetro Interno , com restrio por diferena de valor de 10 e 10 Altura , com limite restrito
418
Frmulas
Templates 4. Na prxima etapa, sero definidas as unidades relativas a esta Frmula. Antes de criar as unidades, no entanto, deve-se criar os Tags usados nesta Frmula. Para isto, insira em seu Servidor de Dados uma Pasta chamada Formula , e dentro dela outras duas Pastas chamadas Maquina1 e Maquina2 . Dentro delas crie trs Tags Internos para cada uma.
Criando Tags 5. Crie na Frmula duas unidades chamadas Maquina1 e Maquina2 . Associe cada campo destas unidades aos Tags criados anteriormente.
Frmulas
419
Associando os Tags s unidades da Frmula 6. Defina os conjuntos de valores a serem carregados posteriormente nos Tags. Crie quatro conjuntos de valores, chamados de Modelo1 at Modelo4 , e digite os seguintes valores:
Configurao do conjunto de valores 7. Crie agora uma nova Tela chamada Frmulas . 8. Crie seis objetos SetPoint nesta Tela, que sero associados a cada um dos Tags da Frmula, e ajuste o tamanho da Tela ao dos objetos. A Tela deve ficar parecida com a figura a seguir:
420
Frmulas
Tela de Frmula
NOTA : s vezes, pode ocorrer um erro na Tela que faz com que as imagens desapaream. Para solucionar esta questo deve-se desabilitar a opo Esconder extenses do MS-DOS para arquivos registrados. Pode-se acessar esta opo a partir do Windows Explorer.
9. Crie um boto na Tela com o ttulo "Carregar valores". Este boto ir mostrar uma caixa de dilogo com os valores existentes e as unidades para as quais estes podem ser carregados, podendo ser selecionada qualquer opo. Para tanto, crie o seguinte script neste boto:
Sub CommandButton1_Click() Application.LoadFormulaDlg "Formula1", "Maquina1, Maquina2",_ "Modelo1, Modelo2, Modelo3, Modelo4" End Sub
Onde Formula1 o nome do objeto Frmula criado e o mtodo LoadFormulaDlg um mtodo do Viewer. Ao ser executado este mtodo, a seguinte caixa de dilogo mostrada:
Frmulas
421
Caixa de dilogo mostrada quando o boto Carregar valores clicado em tempo de execuo 10.Na diviso da direita so apresentadas as duas unidades criadas na Frmula, assim como os conjuntos de valores de Modelo1 a Modelo4 . A opo Modo Silencioso inibir a possibilidade do usurio alterar valores gravados em disco, que sero carregados para os Tags. 11.Atravs deste boto, pode-se ver a aplicao funcionando com as Frmulas e os Tags recebendo os valores do disco. Este um dos mtodos para carregar valores de uma Frmula, mas tambm existem mtodos em que o usurio no necessita selecionar os valores ou as unidades em uma caixa de dilogo. 12.Crie agora um objeto SetPoint na Tela e um boto com o ttulo "OK". Junto com o SetPoint, coloque um texto de identificao com o ttulo "Modelo:". No boto dever ser criado o seguinte script:
Sub CommandButton2_Click() Application.LoadFormulaValues "Formula1", "Maquina1",_ "Modelo1" Screen.Item("Texto16").Value End Sub
Onde Texto16 o nome do ltimo SetPoint inserido na Tela. Este comando ir carregar o conjunto de valores especificado no SetPoint para a unidade Maquina1 . Ao ser executado, este mtodo ir buscar pelo conjunto de valores em disco. Caso encontre, ir carreg-lo seguindo o padro de restries definido no template da Frmula. Os campos com restries abertas podero ter seus valores modificados pelo usurio. Para que o usurio no seja interrogado sobre as mudanas de valores nos campos carregados, deve-se utilizar o modo silencioso.
422
Frmulas
Alterao de valor No entanto existe uma alternativa, o mtodo LoadFormulaValuesQuiet, localizado nos mtodos do objeto Viewer. Ser feita uma opo pelo modo silencioso na Tela, utilizando para isto, o objeto Caixa de Seleo. Crie um objeto Caixa de Seleo na Tela Coloque um texto de identificao ao seu lado, com o texto "Silencioso" Volte no script do boto OK e mude o cdigo para:
Sub CommandButton2_Click() If Screen.Item("CheckBox1").Value = true Then Application.LoadFormulaValuesQuiet "Formula1", "Maquina1", "Modelo1" Application.LoadFormulaValuesQuiet "Formula1", "Maquina1", "Modelo2" Application.LoadFormulaValuesQuiet "Formula1", "Maquina1", "Modelo3" Application.LoadFormulaValuesQuiet "Formula1", "Maquina1", "Modelo4" Else Application.LoadFormulaValues "Formula1", "Maquina1", "Modelo1" Application.LoadFormulaValues "Formula1", "Maquina1", "Modelo2" Application.LoadFormulaValues "Formula1", "Maquina1", "Modelo3" Application.LoadFormulaValues "Formula1", "Maquina1", "Modelo4" End If End Sub
Onde CheckBox1 o nome da Caixa de Seleo criada. Isto far com que se o objeto estiver habilitado, seja utilizado o mtodo LoadFormulaValuesQuiet. Caso contrrio, ser utilizado o mtodo LoadFormulaValues. 1. Repita os ltimos procedimentos desde a criao do SetPoint para os itens da Maquina2 , modificando os scripts necessrios. Ao final das alteraes, a Tela dever ficar parecida com a figura a seguir.
Frmulas
423
424
Frmulas
21
CAPTULO
Bibliotecas
O E3 possui ferramentas que permitem transformar qualquer objeto ou conjunto de objetos da aplicao em uma biblioteca do usurio. As bibliotecas podem ser formadas por objetos frequentemente utilizados, e subsequentemente reaproveitados em outra aplicao. O E3 fornece dois tipos de bibliotecas para o usurio: a Galeria, uma biblioteca de smbolos grficos vetoriais, que podem ser livremente utilizados em suas aplicaes; e uma ferramenta de bibliotecas do usurio chamada de ElipseX. O uso de bibliotecas no E3 altamente recomendvel na maioria dos casos devido ao ganho de produtividade que elas trazem s aplicaes. Algumas das vantagens dos ElipseX: Reutilizao de cdigos Minimizao de testes durante o desenvolvimento Criao de interfaces padro para os objetos desenvolvidos Diminuio do tempo de desenvolvimento de novos projetos Proteo do contedo do projeto
Bibliotecas no Organizer
Bibliotec as
425
21.1 Galeria
A Galeria pode ser acessada atravs do boto Galeria na barra de ferramentas Padro. Neste item est disponvel uma srie de elementos grficos vetoriais, divididos em categorias, que podem ser arrastados para as Telas ou ento para os ElipseX. Esto disponveis os seguintes tipos de smbolos: 3D ISA Symbols, Ar Condicionado, Arquitetura, Setas, ASHRAE (Controles e Equipamentos), ASHRAE (Dutos), ASHRAE (Canos), Formatos Bsicos, Sopradores e Ventiladores, Prdios, Processos Qumicos, Computadores, Contineres, Controladores, Esteiras e Linhas de Produo, Dutos, Eltrica, Tubos Flexveis, Medidores de Vazo, Smbolos Gerais, Aquecimento, HVAC, cones e Bitmaps, Miscelnea Industrial, Smbolos Internacionais, Smbolos ISA, Mapas e Bandeiras, Manuseio de Materiais, Canos, Misturadores, Motores, Natureza, Interfaces Homem Mquina, Painis, Acessrios Industriais, Dispositivos de Potncia, Resfriamento de Processos, Aquecimento de Processos, Bombas, Segurana, Escalas, Canos Segmentados, Sensores, Cortes em Tanques, Texturas, Vlvulas, Veculos, gua e Abastecimento, Fios e Cabos, Botes 3D, Caldeiras, Teclas de Computador, Acabamento, Comida, Laboratrio, Maquinrio, Minas, Papel e Polpa. Para utilizar este recurso, siga estes procedimentos: 1. Clique no boto Galeria na barra de ferramentas Padro.
2. Selecionando esta aba, tem-se acesso aos conjuntos de smbolos, que esto agrupados em categorias. Selecione a categoria atravs da lista na parte superior da janela. 3. Para inserir um objeto da biblioteca de smbolos em uma Tela, basta clicar no objeto desejado e arrast-lo para a Tela. 4. Depois de inserido, o objeto pode ser livremente editado e trabalhado de acordo com as caractersticas descritas para os objetos de imagem. Por exemplo, pode-se mudar a cor de preenchimento diretamente atravs das propriedades OverrideFillMode , OverrideFillColor e OverrideLineColor, sem a necessidade de transformar o objeto em um objeto grfico do E3.
426
Bibliotec as
Bibliotec as
427
Criao de uma biblioteca do usurio - ElipseX 3. Determine o nome da sua biblioteca e clique em Avanar. 4. Determine as especificaes referentes ao Domnio. 5. Clique em Concluir. Dentro de uma biblioteca ElipseX, pode-se inserir dois tipos de objetos: os objetos grficos XControls e os objetos de dados XObjects. Os seguintes itens podem ser inseridos em um XControl: Primitivas de Desenho (Retas, Retngulos, Crculos, etc.), Objetos Grficos Vetoriais, incluindo objetos da biblioteca de smbolos (WMF, EMF, etc.), Objetos Grficos no-Vetoriais (BMP, JPEG, GIF,etc.), Controles ActiveX do E3 (E3Chart, E3Browser, E3Alarm, Controles ActiveX de terceiros ) e outros XControls. J os XObjects podem conter quaisquer tipos de objetos no-grficos, executados no E3 Server, como Drivers de comunicao, Servidores de Dados, Bancos de Dados, Frmulas, Configuraes de Alarmes, Servidores de Alarmes, Objetos COM, entre outros. Dentro de um mesmo arquivo .lib pode existir qualquer nmero de componentes ElipseX, sejam eles XControls ou XObjects. Pode-se tambm ter vrias bibliotecas diferentes dentro do mesmo Domnio. Note que para cada XObject ou XControl criado em uma biblioteca so criadas internamente duas interfaces, uma para declarar as propriedades do objeto, e outra para declarar os eventos do objeto. Estas interfaces tem seus nomes gerados automaticamente, acrescentando o prefixo D a esse nome (a interface de eventos adiciona o sufixo Events ao nome automtico). Se, por exemplo, o objeto se chama XObject1 , sua interface de propriedades tem o nome DXObject1 e a interface de eventos, DXObject1Events . Uma tentativa de usar estes nomes em outras classes na mesma biblioteca gera um cdigo de erro 428 Bibliotec as
21.2.1 XControls
O XControl define uma interface grfica com o usurio, que pode ser composta de quaisquer objetos do E3, e ter o propsito de ser multiplicada facilmente por seu projeto. Pode-se criar um XControl clicando com o boto direito do mouse sobre o arquivo LIB criado em seu Domnio, escolhendo a opo Inserir - XControl.
XControls Ao inserir um XControl, aberta a view deste objeto, composta por trs abas. Alm da aba Scripts, presente em todos os objetos, existe a aba Design, que equivale a uma Tela, onde podem ser inseridos os objetos grficos descritos anteriormente, e a aba Propriedades, onde podem ser inseridas variveis, que so as propriedades do XControl. Estas propriedades sero exportadas pelo objeto e podero ser associadas a um tag ou outra propriedade qualquer quando o objeto estiver sendo usado na aplicao. As variveis a serem exportadas podem ser inseridas pressionando-se a tecla INSERT do teclado ou atravs do boto e excludos atravs da tecla DELETE do teclado ou atravs do boto . As opes disponveis deste item so as seguintes: Opes disponveis na aba Propriedades OPO Nome DESCRIO Determina o nome da varivel do XControl.
Bibliotec as
429
OPO Tipo
DESCRIO Determina o tipo de dado suportado pela varivel. Note que outros objetos de Dados (XObjects) podem ser declarados como Tipos. Desta forma, pode-se criar um objeto de dados que possui como propriedade outro objeto de dados. Os objetos de dados podem funcionar neste caso como uma struct ou classe, como utilizado nas linguagens C/C++. Quando for especificado um tipo de objeto (por exemplo DemoTag, IOTag, XObject, etc.), esta propriedade ter o seguinte comportamento: Caso o ElipseX esteja inativo: A propriedade funciona como um String, que especifica o caminho da instncia de um objeto do tipo configurado Caso o ElipseX esteja ativo: Na escrita, a propriedade funciona como o caso anterior, porm na leitura a propriedade retorna o objeto especificado, caso ele exista. Se o caminho no aponta para um objeto existente no momento, a propriedade retorna Nothing Habilita ou desabilita a visibilidade da varivel fora da biblioteca, isto , determina se a varivel ser ou no pblica. Determina se a propriedade retentiva ou no. No caso de XControls, as propriedades no podem ser retentivas.
NOTA : interessante observar que podem ser declarados como Tipos, os objetos de Dados (XObjects).
A edio do objeto grfico pode ser feita da mesma forma como feita a edio de uma Tela, possuindo os mesmos recursos grficos e opes. Pode-se inserir os XControls em qualquer Tela, ou ainda dentro de outro XControl clicando com o boto direito do mouse sobre a Tela ou XControl de destino, escolhendo a opo Inserir , como mostrado a seguir. A partir de um XControl em desenvolvimento (dentro da biblioteca), 430 Bibliotec as
possvel inserir outro XControl dentro dele, clicando com o boto direito do mouse sobre o XControl de destino, e escolhendo a opo Inserir.
Insero de XControl em uma Tela A partir deste momento, o XControl ter um nome dentro da Tela, e ser entendido como uma cpia da definio original. Assim, deve-se definir (se necessrio) os valores ou as associaes que esta cpia especfica ter no contexto que est sendo utilizada. Se o tamanho deste objeto for alterado na view de Design da Biblioteca e registrado novamente, ser necessrio acessar a opo Tamanho Original no seu menu de contexto da Tela para que a alterao aparea. Se for criado um objeto Bomba, por exemplo, que possui uma propriedade Estado, que receber uma informao externa revelando se a bomba est ligada ou desligada, fazendo com que ela mude sua cor. Ao inserir este objeto na Tela, o E3 automaticamente renomeia o objeto para Bomba1 . Pode-se manter este nome ou renome-lo para outro que se desejar. Depois, dever ser informada qual varivel ser associada propriedade Estado. Suponha que certo tag de comunicao representa o estado dessa bomba; logo, dever ser feita uma associao entre a propriedade Estado e o referido tag. O mesmo trabalho dever ser feito para outras instncias (cpias) do objeto Bomba que se fizerem necessrias no projeto.
21.2.2 XObjects
Alm dos Objetos grficos XControls, pode-se criar uma biblioteca de dados, denominada XObject. Com ela, pode-se definir uma estrutura de dados, que ser executada no servidor. Tal estrutura poder realizar clculos, associaes, comunicaes, verificao de alarmes, registro histrico, etc., que independam de que alguma interface grfica (Viewer) esteja aberta ou sendo executada naquele momento. Para criar um XObject, clique com o boto direito do mouse no item Bibliotecas de Objetos - XObjects no modo Domnio e escolha a opo Inserir XObject em e logo aps o nome da biblioteca desejada.
Bibliotec as
431
XObjects Ao inserir um XObject, aberta a view deste objeto, onde podem ser inseridas variveis. Estas variveis so as propriedades a serem exportadas pelo objeto, que podero ser associadas a um tag ou outra propriedade qualquer de uma aplicao quando o objeto estiver sendo usado numa aplicao. As variveis a serem exportadas podem ser inseridas pressionando-se a tecla INSERT do teclado ou atravs do boto e excludos atravs da tecla DELETE ou do boto disponveis deste item so as seguintes: Opes disponveis na view dos XObjects OPO Nome DESCRIO Determina o nome da varivel do XObject. . As opes
432
Bibliotec as
OPO Tipo
DESCRIO Determina o tipo de dado suportado pela varivel. Note que outros objetos de Dados (XObjects) podem ser declarados como Tipos. Desta forma, pode-se criar um objeto de dados que possui como propriedade outro objeto de dados. Os objetos de dados podem funcionar neste caso como uma struct ou classe, como utilizado nas linguagens C/C++. Quando for especificado um tipo de objeto (por exemplo DemoTag, IOTag, XObject, etc.), esta propriedade ter os seguinte comportamento: Caso o ElipseX esteja inativo: A propriedade funciona como um String, que especifica o caminho da instncia de um objeto do tipo configurado Caso o ElipseX esteja ativo: Na escrita, a propriedade funciona da mesma maneira de quando o objeto est desativado. Porm, na leitura a propriedade retorna o objeto especificado, caso ele exista. Se o caminho no aponta para um objeto existente no momento, a propriedade retorna Nothing Habilita ou desabilita a visibilidade da varivel fora da biblioteca, isto , determina se a varivel ser ou no pblica. Determina se a propriedade retentiva ou no.
Apenas propriedades de tipos simples (Variant, String, Date, Double, etc.) podem ser retentivas (a view ir desmarcar automaticamente a coluna se o tipo de uma propriedade for alterado para um tipo de objeto), e apenas propriedades de XObjects podem ser retentivas.
Bibliotec as
433
NOTA : O uso de propriedades retentivas nos ElipseX pode aumentar o tempo de incio do aplicativo, e tambm aumentar o consumo de memria pelo processo E3Run. Os tempos variam dependendo do nmero de instncias de XObjects, nmero de propriedades retentivas em cada XObject, e a quantidade destas propriedades que possuem o seu valor alterado (se a propriedade nunca for alterada, o valor retentivo dela fica zerado).
Podem ser inseridos num XObject quaisquer mdulos do E3 que sejam executados no servidor, a saber: Driver de Comunicao e Driver de Comunicao OPC Servidor de alarmes e alarmes Servidor de Banco de Dados Frmulas Servidor de Dados Histricos
Isto permite que se possa definir como uma biblioteca, um sistema complexo de gerenciamento, que poder ser facilmente replicado quantas vezes forem necessrias em um aplicativo.
IMPORTANTE: Veja que tanto os XControls quanto os XObjects s podero se relacionar com o mundo externo atravs das propriedades (ou ainda atravs do mouse e teclado, no caso dos XControls). Isso significa que no se pode acessar dados internos de um XObject ou XControl seno de dentro do prprio objeto.
Pode-se inserir os XObjects em qualquer Servidor de Dados, clicando com o boto direito do mouse sobre o Servidor de Dados no modo Domnio, escolhendo a opo Inserir e logo aps o nome do XObject desejado, conforme mostrado na figura a seguir. No modo Explorer, clique com o boto direito do mouse sobre o Servidor de Dados do projeto, selecione a opo Inserir e logo aps o nome do XObject desejado.
434
Bibliotec as
Inserindo um XObject no modo Domnio Note que mesmo se os arquivos de biblioteca possuirem vrios XControls e XObjects, ao tentar inserir uma instncia (cpia), o E3 Studio exibir para as Telas somente os XControls, e para os Servidores de Dados somente os XObjects disponveis.
NOTA : Deve-se cuidar para no apagar uma propriedade de um XControl ou XObject que possua uma associao. Essas propriedades, uma vez apagadas, no aparecem mais na lista de propriedades do objeto, e por isso no podero ser editadas. Quando for executada a operao Verificar Domnio, ser feita uma procura por essas propriedades e o usurio consultado se deseja remover essa associao ou no.
Mensagem do sistema
Bibliotec as
435
Pode-se optar por no remover e ento criar novamente o objeto que foi apagado com a propriedade que se deseja editar, remover apenas a propriedade que est sendo mostrada, remover todas as propriedades ou no remover nenhuma propriedade.
Logo, o uso de biblioteca recomendado para a maioria das aplicaes. Entretanto, existem alguns critrios para indicar a necessidade da construo de objetos no Elipse. Repetio no uso: se um mesmo equipamento ou processo ser usado mais de uma vez no mesmo projeto Procedimentos do conhecimento do usurio: frequentemente, um processo criado por determinada empresa deve ser protegido de cpia ou alterao. Isso comum no caso de integradores de servios ou fabricantes de mquinas Uso de controladores: um controlador de processo, cujo mapeamento de memria fixo, pode ser implementado com todas as funcionalidades disponveis. A flexibilidade disponvel para a construo e uso dos objetos no E3 permite que sejam utilizadas posteriormente apenas as variveis de interesse, desprezando-se as demais
NOTA : Para exemplos de criao de ElipseX e maiores informaes sobre estes objetos, consulte o Manual de Referncia de Scripts.
436
Bibliotec as
22
CAPTULO
Relatrios
O Relatrio um componente ActiveX chamado ActiveReport, que permite a visualizao e impresso de valores instantneos de variveis do sistema e dados armazenados em Banco de Dados (Alarmes, Histricos, Consultas e Frmulas). Estes dados podem ser impressos tanto em formato texto como em formato grfico, sendo este ltimo feito atravs do objeto E3Chart. Para utilizar o relatrio, siga estes procedimentos: 1. Clique com o boto direito no Organizer e selecione a opo Inserir Relatrio em.
Relatrios
437
Sees do relatrio O relatrio define tipos de seo, que sero explicados nas sees a seguir.
NOTA : Um Report Header pode estender-se por mltiplas pginas. Para isto, basta inserir um objeto Quebra de Pgina em seu contedo.
438
Relatrios
22.2.6 Detail
A seo Detail o corpo do relatrio, que imprime uma vez para cada registro da fonte de dados.
Barra de Ferramentas Relatrio Clicando com o boto direito do mouse sobre o relatrio, mostrado um menu. As opes deste menu variam de acordo com o local onde se clica com o mouse. Na rea do relatrio: Somente as opes Insert e Delete Section esto habilitadas
Em um objeto no relatrio: Somente as opes Insert, Delete , Cut, Copy, Paste , Bring to Front, Send to Back, Alignment e Format Border esto habilitadas
Menu de objeto do Relatrio Em mais de um objeto selecionado no relatrio: Todas as opes do menu esto habilitadas Opes disponveis no Menu OPO Insert DESCRIO Permite inserir um novo componente do relatrio. As opes disponveis so as seguintes: Insert - Group Header/Footer: Adiciona um novo par de cabealhos ou rodaps de grupo no relatrio Insert - Page Header/Footer: Adiciona um novo par de cabealhos ou rodaps de pgina Insert - Report Header/Footer: Adiciona um novo par de cabealhos ou rodaps no relatrio Delete / Delete Section Apaga a seo, objeto ou grupo selecionado. Esta opo no aplicada na seo Detail do relatrio. Reorganiza os grupos selecionados. Esta opo vlida quando vrios grupos de seo (pares de cabealho ou rodap) foram adicionados no relatrio. Esta opo no aplicada na seo Detail do relatrio.
Reorder Groups
440
Relatrios
OPO Cut
DESCRIO Recorta o objeto, grupo ou seo selecionado. Copia o objeto, grupo ou seo selecionado. Cola o objeto, grupo ou seo na seo corrente do relatrio. O objeto, grupo ou seo selecionado enviado para a primeira posio na ordem de sobreposio. O objeto, grupo ou seo selecionado enviado para a ltima posio na ordem de sobreposio. Alinha o objeto, grupo ou seo selecionado. As opes disponveis so as seguintes: Lefts: Alinhamento esquerdo Centers: Alinhamento centralizado Rights: Alinhamento direito Tops: Alinhamento no topo Middles: Alinhamento central Bottoms: Alinhamento mesma altura To grid: Alinhamento conforme a grade Center in section: Alinhamento centralizado na sesso
Copy Paste
Bring to Front
Send to Back
Align
Size
Determina o tamanho do objeto, grupo ou seo selecionado. As opes disponveis so as seguintes: Make same width: Mesma largura Make same height: Mesma altura Make same size : Mesmo tamanho
Relatrios
441
DESCRIO Determina o espaamento horizontal do objeto no relatrio. As opes disponveis so as seguintes: Make Equal: Espaamento igual entre os objetos Increase : Incrementa o espaamento do objeto em um passo Decrease : Decrementa o espaamento do objeto em um passo
Vertical Spacing
Determina o espaamento vertical do objeto. As opes disponveis so as seguintes: Make equal: Espaamento igual entre os objetos Increase : Incrementa o espaamento do objeto em um passo Decrease : Decrementa o espaamento do objeto em um passo
Format Border
As opes disponveis so as seguintes: Opes disponveis para Borda OPO Presets DESCRIO Determina o estilo da borda externa do objeto. Determina o estilo da linha da borda do objeto. Prvia de configurao do objeto. Determina a cor da borda do objeto. Habilita ou desabilita a sombra do objeto.
Line Styles
Relatrios
443
22.3.1 Preview
Atravs desta opo, possvel visualizar uma prvia da impresso do relatrio. Assim possvel verificar configuraes de margem, figuras, etc.
Prvia de impresso do relatrio As opes disponveis deste item so as seguintes: Configuraes da Prvia de Impresso CONE DESCRIO Tabela de contedo do relatrio. Imprime o relatrio, abrindo a Tela de configurao de impresso. Copia o contedo selecionado. Procura um texto especfico no relatrio. Visualizao de uma pgina simples do relatrio. Visualizao de mltiplas pginas do relatrio. 444 Relatrios
CONE
DESCRIO Menos zoom na pgina. Mais zoom na pgina. Porcentagem de zoom na pgina. Pgina anterior e Prxima pgina.
Configuraes do relatrio As opes disponveis deste item so as seguintes: Opes de configurao do PageSetup ITEM Top Margin Bottom Margin Left Margin DESCRIO Determina a margem do topo da pgina. Determina a margem do contedo da pgina. Determina a margem esquerda da pgina.
Relatrios
445
DESCRIO Determina a margem direita da pgina. Determina a margem da pgina. Habilita ou desabilita a margem espelhada da pgina.
Configuraes de impresso do relatrio As opes disponveis deste item so as seguintes: Opes de configurao do Printer Setting (Impressora) ITEM Paper Size Width Height DESCRIO Determina o tamanho do papel. Determina a largura do papel. Determina a altura do papel.
446
Relatrios
ITEM Orientation
DESCRIO Determina a orientao do papel na impressora (Printer Default - Configuraes de acordo com a impressora padro; Portrait - Layout da pgina na vertical; Landscape Layout da pgina na horizontal). Ordena a impresso. Duplica a impresso. Determina as configuraes e o tipo de papel para a impresso.
Configuraes da grade As opes disponveis deste item so as seguintes: Opes de configurao do Grid Setting (grade) ITEM Show Grid Align Controls to Grid DESCRIO Habilita ou desabilita a grade. Habilita ou desabilita o alinhamento dos controles na grade.
Relatrios
447
DESCRIO Determina o nmero de colunas na grade. Determina o nmero de linhas na grade. Determina o tipo de unidade da rgua (pixels ou centmetros).
Configuraes de impresso do relatrio As opes disponveis deste item so as seguintes: Opes disponveis para configurao do Style (estilo) OPO New / Delete / Lista DESCRIO Determina o estilo do relatrio. Pode-se inserir um novo estilo (atravs do boto New ), apagar um estilo (atravs do boto Delete ) ou utilizar os estilos existentes na lista. Determina as especificaes do estilo do relatrio (fontes, cores de fundo e frente, orientao, etc.).
448
Relatrios
Editor de Scripts No campo Object necessrio especificar o objeto onde se deseja criar o script e no item Events, o evento do relatrio em que ocorrer a ao.
Relatrios
449
22.3.6.1 Linha
O objeto Linha liga dois pontos quaisquer. Permite o desenho de retas, atravs de dois pontos especificados na sua criao ou em polgonos.
22.3.6.2 Retngulo
O objeto Retngulo permite o desenho de retngulos, utilizando toda a largura ou altura do objeto. Criado a partir de dois vrtices.
Retngulo arredondado Aps ser inserido na Tela, o objeto ser chamado de Shape .
450
Relatrios
22.3.6.4 Elipse
O objeto Elipse permite o desenho de crculos e elipses, utilizando toda a largura ou a altura e definindo o centro do crculo no centro do retngulo.
22.3.6.5 Texto
O objeto Texto possibilita a criao de um texto. Ao definir a rea na Tela, podemos digitar diretamente o texto desejado, que aceita tambm mltiplas linhas.
22.3.6.6 Figura
O objeto Figura permite mostrar imagens que estejam armazenadas em arquivos, tanto em arquivos externos como em arquivos de recurso do aplicativo.
Figura
Relatrios
451
Campo de Dados Aps ser inserido na Tela, o objeto ser chamado de Field .
22.3.6.7.1 Exemplo de Utilizao do Campo de Dados do Relatrio O exemplo a seguir demonstrar como mostrar a mdia por dia de um campo da consulta no relatrio. Para tanto, siga estes procedimentos: 1. Insira um novo GroupHeader/Footer no relatrio. 2. Configure a propriedade DataField do GroupHeader para "=Day(E3TimeStamp"). Isto determina que o clculo da mdia ser feito por dia. 3. Insira um Campo de Dados no GroupHeader com a propriedade DataField igual a "=Day (E3TimeStamp"). 4. Insira um Campo de Dados no GroupFooter com a propriedade DataField igual ao nome do campo que ser calculada a mdia. 5. Configure as seguintes propriedades do Campo de Dados do GroupHeader: SummaryFunc : 1 - ddSFAvg SummaryGroup: GroupHeader1 SummaryRunning: 1 - ddSRGroup SummaryType : 3 - ddSMSubTotal
452
Relatrios
Caixa de seleo Aps ser inserido na Tela, o objeto ser chamado de CheckBox .
Cdigo de barras Aps ser inserido na Tela, o objeto ser chamado de BarCode .
Relatrios
453
22.3.6.10 E3Chart
O objeto E3Chart um componente ActiveX utilizado para exibir um grfico mostrando tags variando em tempo real e tambm mostrar dados histricos gravados em um Banco de Dados.
Existem algumas diferenas de funcionamento entre o E3Chart na aplicao e no relatrio. Na aplicao, o E3Chart consegue plotar grficos em tempo real, histrico e misto. J quando este objeto est sendo utilizado em um relatrio, no permitida sua utilizao com dados em tempo real ou mistos, somente com dados histricos. Note que nenhum objeto do relatrio pode ser acessado externamente, ou seja, ao se criar o relatrio pelo aplicativo, no possvel acessar suas propriedades nem tampouco as de seus objetos via scripts do aplicativo. Por isso, as alteraes nos objetos, incluindo o E3Chart, devem ser feitas diretamente no E3 Studio ou em eventos do prprio relatrio. Para maiores informaes sobre este objeto, veja o captulo E3Chart.
Quebra de pgina
454
Relatrios
22.3.6.12 Quadro
O objeto Quadro composto de linhas e colunas onde so inseridos textos ou grficos. Os quadros dos relatrios so usados para organizar e apresentar informaes. Pode-se tambm usar quadros para criar disposies de pgina, ou criar o texto, grficos e tabelas animadas como em uma pgina em HTML.
Existem ainda dois tipos de reas: Report Header/Footer: reas que so impressas uma nica vez, no importando o tamanho do relatrio em pginas. Ela vem como abertura ou fechamento do relatrio Group Header/Footer: Um grupo utilizado para dividir no relatrio conjuntos de valores iguais de uma mesma varivel. Essa rea se repetir sempre que um grupo for apresentado. No exemplo aqui demonstrado no utilizada nenhuma construo desse tipo. Essa rea sempre envolve uma rea de detalhes
Essas duas reas podem ser acessadas clicando com o boto direito do mouse no relatrio e acessando a opo Insert.
Relatrios
455
Para tanto, necessrio direcionar o servidor de Banco de Dados do projeto para o arquivo MDB da pasta onde foi salvo o exemplo.
456
Relatrios
Relatrios
457
Sub Retangulo3_Click() Set report = Application.LoadReport("[Relatrio3]") Select Case _ Application.SelectMenu("PDF|Excel|HTML|RTF|Texto|_ TIFF|Texto(CSV)") Case 1 Report.Export "PDF", "C:\correio\reports\report.pdf" MsgBox "Exportado para PDF!" Case 2 Report.Export "EXCEL", "C:\correio\reports\report.XLS" MsgBox "Exportado para XLS!" Case 3 Report.Export "HTML", "C:\correio\reports\report.html" MsgBox "Exportado para HTML!" Case 4 Report.Export "RTF", "C:\correio\reports\report.rtf" MsgBox "Exportado para RTF!" Case 5 Report.Export "TEXT", "C:\correio\reports\report.txt" MsgBox "Exportado para Texto (CSV)!" Case 6 Report.Export "TIFF", "C:\correio\reports\report.tiff" MsgBox "Exportado para TIFF!" Case 7 Set reportFilter = report.GetExportFilter("TEXT") reportFilter.FileName="C:\correio\reports\_ report2.txt" reportFilter.TextDelimiter = "," report.Export reportFilter MsgBox "Exportado para TXT usando filtro!" End Select End Sub
458
Relatrios
22.5.6 Como Criar Relatrios Imprimindo somente Mdias de Valores a cada 5 Minutos
Para isso deve-se criar um novo Grupo no Relatrio. O Grupo criado tem um Header e um Footer. O layout geral : PageHeader: Contm o titulo das Colunas GroupHeader: Fica vazio, porm a sua propriedade DataField tem o valor igual a "CLng (E3TimeStamp*288)" , isso porque o E3TimeStamp a data/hora do dado no formato gregoriano (dias desde 1/1/1900), sendo a parte inteira o nmero de dias e a parte fracionria as horas e os minutos. Multiplicando por 288 teremos um nmero inteiro correspondente ao total de 5 minutos desde 1/1/1900. A funo CLng converte para um nmero inteiro de 32 bits eliminando a parte fracionria, de modo que no apaream os minutos e segundos intermedirios. O Grupo criado vai ser impresso cada vez que esse nmero inteiro mudar, ou seja, a cada cinco minutos. Verifique as propriedades NewColumn e NewPage , que devem estar em 0 - ddNPNone Detail: Contm os DataFields para os campos da tabela. A propriedade Visible estar em False, de modo que cada uma das aquisies que comporo a mdia de 5 minutos sero computadas, porm no impressas GroupFooter: Contm campos que representam as mdias dos campos. Para isso: DataField: Nomes dos Campos da Tabela (o mesmo que na seo Detail) SummaryFunc : 1 - ddSFAvg SummaryRunning: 1 - ddSRGroup SummaryType : 1 - ddSGrandTotal
A nica exceo para a Data/Hora que ser um campo padro com a propriedade DataField igual a "=CLng(E3TimeStamp*288)/288" . ReportFooter: Em branco (ou outro valor qualquer)
Se a consulta for entre 00:00 de um dia e outro, o resultado sero 288 linhas impressas com a mdia dos campos a cada cinco minutos.
Relatrios
459
23
CAPTULO
Segurana
Atravs desta opo, possvel controlar o acesso a Telas, Alarmes, Domnios e Viewer em uma lista de usurios e grupos. Conforme a opo configurada, o sistema permitir ou no o acesso aos usurios cadastrados. As permisses de acesso so configuradas por usurio ou por grupos de usurios. Os grupos podem ser criados contendo apenas usurios ou tambm outros grupos. Para acessar as configuraes de usurios, grupos ou permisses, siga estes procedimentos: 1. Abra o menu Arquivo - Usurios. O sistema mostrar uma caixa de dilogo para configurao das permisses, dos usurios e dos grupos no sistema.
460
Seguran a
23.1 Usurios
Atravs da aba Usurios possvel configurar as informaes referentes aos usurios que tero ou no acesso ao sistema. Para utilizar este recurso, clique no menu Arquivo - Usurios, e selecione a aba Usurios.
Aba Usurios As opes disponveis desta aba so as seguintes: Opes disponveis na aba Usurios OPO Nome Boto Novo Boto Editar DESCRIO Indica o usurio corrente. Cria um novo usurio. Edita as propriedades do usurio selecionado. Remove o usurio selecionado.
Boto Remover
Seguran a
461
DESCRIO Mostra os grupos de usurios disponveis no sistema. Mostra os grupos aos quais o usurio pertence. Adiciona grupos da lista Grupos disponveis para a lista Pertence a. Remove grupos da lista Pertence a.
Pertence a
Boto Adicionar
Boto Remover
462
Seguran a
Adicionando usurios na aplicao As opes disponveis desta janela so as seguintes: Opes disponveis na janela Adicionar usurios OPO Nome Autenticao do Windows DESCRIO Determina o nome do usurio. Esta opo permite adicionar um usurio existente no domnio de rede do Windows. O nome do usurio deve estar no formato DOMNIO\USURIO. Ao selecionar esta opo, todas as demais opes da janela ficam desabilitadas, exceto Este usurio um administrador e Esta conta est desabilitada.
Seguran a
463
OPO Autenticao do E3
DESCRIO Esta opo cria o usurio no Domnio corrente do E3. Determina a senha do usurio. Reconfirmao da senha anteriormente informada. Determina o nome completo do usurio. Habilita o usurio como administrador. O usurio no pode alterar a sua senha, pois somente o administrador pode executar esta tarefa. Determina o prazo de validade da senha do usurio. Quando a data de expirao estiver prxima, ser mostrado um lembrete para renovar a senha. Caso deseje renov-la, uma caixa de dilogo ser aberta para que o usurio faa a configurao da senha. Se a senha expirar antes do usurio renov-la, no ser mais possvel executar o login , e a opo Esta conta est bloqueada ser habilitada automaticamente. Esta condio persiste at que um administrador desbloqueie a senha manualmente. Determina um nmero mnimo de caracteres para a senha do usurio. Determina que a senha deve conter letras e nmeros. Determina um nmero mnimo de nmeros para a senha do usurio. Determina um nmero mnimo de letras para a senha do usurio. Determina que a senha deve conter letras maisculas e minsculas. Indica que a conta est desabilitada. Indica que a conta do usurio est bloqueada. Esta opo habilitada automaticamente caso a senha do usurio expire ou se o usurio digitar a senha errada vrias vezes. Seguran a
Nome completo Este usurio um administrador O usurio no pode alterar sua senha
A senha deve conter letras maisculas e minsculas Esta conta est desabilitada Esta conta est bloqueada
464
OPO O usurio deve trocar a senha no prximo login Validar senhas sem diferenciar maisculas e minsculas
DESCRIO Indica que o usurio dever trocar sua senha quando for executar o prximo login . Permite a validao de senhas, independente de seus caracteres serem digitados em maisculas ou minsculas. Esta opo no recomendada.
Ao efetuar o login do usurio (pelo mtodo Login do Viewer ou pelo menu Arquivo - Login), abre-se a seguinte caixa de dilogo:
Janela de login Ao selecionar o modo de autenticao Windows, os campos Nome do usurio e Senha so desabilitados e preenchidos com o nome e a senha do usurio logado no domnio de rede. Para selecionar outro usurio pertencente ao domnio de rede, clique em Outro usurio. Selecionando o modo de autenticao E3 , basta preencher as informaes de usurio e senha de um usurio do Domnio do E3 nos campos Nome do usurio e Senha, respectivamente. Quando a opo Este usurio um administrador habilitada para um usurio, este usurio poder, em tempo de execuo, alterar todas as configuraes mostradas na aba Usurios. Estes privilgios so acessados via script atravs do mtodo UserAdministration do Viewer, que habilita a caixa de dilogo dos usurios em tempo de execuo.
Ao clicar no boto Remover, o sistema mostra uma caixa de mensagem questionando se realmente deseja-se remover o usurio. possvel que um usurio pertena a um grupo, podendo assim compartilhar as configuraes deste grupo. Para tanto, na lista Grupos disponveis so mostrados os grupos Seguran a 465
disponveis no sistema que podero conter o usurio selecionado, e na lista Pertence a, a lista dos grupos aos quais o usurio selecionado j pertence. Para adicionar um usurio a um grupo, siga estes procedimentos: 1. Selecione o usurio que deseja inserir no grupo especfico. 2. Na lista Grupos disponveis, selecione o grupo ao qual o usurio ir pertencer. 3. Clique em Adicionar, para adicionar o grupo, que aparecer na lista Pertence a. 4. Para remover o grupo, basta selecion-lo na lista Pertence a e clicar em Remover.
23.2 Grupos
A aba Grupos permite que sejam configuradas as informaes referentes aos grupos. Cada grupo define caractersticas que sero comuns para todos os seus membros. Um grupo tambm pode pertencer a outros grupos. S no permitido pertencer a outro grupo que j pertena a ele, ou seja, criando uma referncia circular. Para utilizar este recurso, clique no menu Arquivo - Usurios e selecione a aba Grupos.
Opes disponveis na aba Grupos OPO Nome Boto Novo Boto Editar Boto Remover Grupos disponveis Pertence a DESCRIO Indica o grupo corrente. Cria um novo grupo. Edita as propriedades do grupo selecionado. Remove o grupo selecionado. Mostra os grupos disponveis no sistema. Mostra os grupos aos quais o grupo selecionado pertence. Adiciona grupos da lista Grupos disponveis na lista Pertence a. Remove grupos da lista Pertence a.
Boto Adicionar
Boto Remover
Seguran a
467
Opes disponveis na janela Adicionar Grupos OPO Nome do grupo O usurio no pode alterar sua senha DESCRIO Determina o nome do grupo. O usurio no pode alterar sua senha, pois somente o administrador pode executar esta tarefa. Determina o prazo de validade da senha do usurio. Determina um nmero mnimo de caracteres para a senha do usurio. Determina que a senha deve conter letras e nmeros. Determina um nmero mnimo de nmeros para a senha do usurio. Determina um nmero mnimo de letras para a senha do usurio. Determina que a senha deve conter letras maisculas e minsculas. Permite a validao de senhas, independente de seus caracteres serem digitados em maisculas ou minsculas.
A senha deve conter letras maisculas e minsculas Validar senhas sem diferenciar maisculas e minsculas
Ao clicar no boto Remover, o sistema mostra uma caixa de mensagem perguntando se realmente deseja-se excluir o grupo selecionado. possvel que um grupo de usurios pertena a outro, podendo assim compartilhar as configuraes. Para tanto, na lista Grupos disponveis so mostrados os grupos disponveis no sistema que podero conter o grupo selecionado, e no item Pertence a, a lista dos grupos aos quais o grupo selecionado pertence. Para adicionar um grupo a outro especfico, siga estes procedimentos: 1. Selecione o grupo que deseja inserir num grupo especfico. 2. Na lista Grupos disponveis, selecione o grupo ao qual o grupo ir pertencer. 3. Clique em Adicionar, para adicionar o grupo, que aparecer na lista Pertence a. 4. Para remover o grupo, basta selecion-lo na lista Pertence a e clicar em Remover.
468
Seguran a
NOTA : importante verificar a hierarquia entre usurios e grupos. Se o usurio tem uma opo desabilitada, mas esta mesma opo est habilitada no grupo, vale a opo do usurio, que possui este item desabilitado. A opo do grupo s ser respeitada se a mesma opo do usurio estiver marcada como neutra.
23.3 Permisses
A aba Permisses permite configurar as permisses dos usurios e grupos para Telas, Alarmes, Domnios e Viewer. Uma verificao de permisso consiste em uma informao que o membro do grupo tem sobre um comando que atua sobre um objeto especfico.
Permisses de usurios e grupos As opes disponveis desta aba so as seguintes: Opes disponveis na aba Permisses OPO Usurios/Grupos DESCRIO Esta opo lista os usurios ou grupos de usurios configurados no sistema.
Seguran a
469
DESCRIO Os itens para segurana disponveis so: Telas: Permite ao usurio habilitar ou desabilitar o acesso s Telas. Em uma aplicao, todos os usurios ou grupos tm acesso Tela de abertura Alarmes: Habilita ou desabilita o reconhecimento dos alarmes para o usurio ou grupo. Em um projeto, possvel exibir as informaes dos alarmes para vrios assinantes das informaes atravs de um objeto de visualizao em Tela, como por exemplo, o E3Alarm Domnios: Permite configurar permisses para executar, parar ou editar o Domnio, ter acesso remoto ao Domnio, entre outras permisses Viewer: Permite ao usurio utilizar o Viewer no modo Viewer Full ou Viewer Only, de acordo com suas configuraes
Usurios
um filtro das opes de configurao. Habilitando esta opo, possvel visualizar somente os usurios cadastrados no sistema. um filtro das opes de configurao. Habilitando esta opo, possvel visualizar somente os grupos cadastrados no sistema. Mostra as permisses dos usurios ou grupos quanto aos itens de segurana (Telas, Alarmes, Domnios e Viewer). Desabilita a verificao de permisses.
Grupos
Permisses
Para cada item de segurana existe uma srie de permisses que podem ser configuradas para cada usurio ou grupo. As opes disponveis so as seguintes: Opes disponveis para Telas OPO Abrir Tela DESCRIO Habilita a abertura de Telas.
470
Seguran a
Opes disponveis para Alarmes OPO Reconhecer alarme DESCRIO Habilita o reconhecimento de alarmes.
Opes disponveis para Domnios OPO Executar Domnio Parar Domnio Editar Domnio Executar como servio DESCRIO Habilita a execuo do Domnio. Para o Domnio. Habilita a edio do Domnio. Habilita a execuo do Domnio como servio. Permite configurar usurios e grupos de usurios. Habilita o acesso remoto ao Domnio. Habilita o acesso remoto de escrita ao Domnio.
Configurar usurios/grupos
Opes disponveis para Viewer OPO Acesso de escrita ao servidor DESCRIO Habilita o acesso de escrita ao servidor.
Cada item da lista de permisses pode estar configurado com um dos estados a seguir: Permitido (crculo cheio verde): O comando selecionado na lista de permisses permitido para o usurio ou grupo selecionado, independente dos grupos aos quais ele pertence No permitido (crculo cheio vermelho): O comando selecionado na lista de permisses no permitido para o usurio ou grupo selecionado, independente dos grupos aos quais ele pertence Permitido pelo grupo (crculo vazado verde): O comando selecionado na lista de permisses ser permitido para o usurio ou grupo selecionado, se ele for permitido nos 471
Seguran a
grupos aos quais o usurio ou grupo pertence No permitido pelo grupo (crculo vazado vermelho): O comando selecionado na lista de permisses no ser permitido para o usurio ou grupo selecionado, se ele no for permitido em pelo menos um dos grupos aos quais o usurio ou grupo pertence No informado: O usurio ou grupo selecionado utilizar as definies dos grupos aos quais pertence e no h nada informado nos grupos. Portanto, o comando permitido
No caso das Telas, possvel que a configurao de permisso seja feita por Tela especificamente. No caso de Alarmes, essa configurao pode ser feita por rea.
NOTA : Em uma aplicao, todos os usurios tm acesso Tela de abertura. Caso deseje que a aplicao sempre inicie com a tela de login do usurio, crie um usurio sem permisso especfica na Tela inicial. Assim, toda vez que for iniciada a aplicao, o sistema pedir o login do usurio e aps, mostrar a Tela de abertura.
Com relao a permisses para o usurio annimo, devem ser observadas as seguintes situaes: Se no h usurio criado, a verificao de permisses no est habilitada ou no h usurio com restrio para uma determinada operao, ento no ser exigida identificao (usurio ser logado como annimo) Se h usurio criado, a verificao est habilitada, e h pelo menos um usurio que no possa executar determinada operao, ento para esta operao ser exigida identificao (no ser permitido o acesso como usurio annimo)
NOTA : A nomenclatura e descrio das opes de restrio pode ser acessada atravs da opo Legenda.
Caso haja alguma restrio para executar, parar, editar um Domnio ou configurar os usurios ou grupos, necessrio que um usurio esteja logado no E3. Para tanto, utilizam-se as opes Login ou Logout, disponveis no menu Arquivo.
472
Seguran a
Login ou Logout do usurio A opo Login abre uma caixa de dilogo para o login no E3 Studio. O usurio permanece logado at que seja feito outro login ou logout. A opo Logout executa o logout no E3 Studio. Caso no haja um usurio logado, esta opo ser desabilitada.
Seguran a
473
Proteo Esta opo possui dois tipos de proteo: Proteo de Edio e Proteo de Execuo. Proteo de Edio: Protege o arquivo contra alteraes e visualizaes no autorizadas. Este recurso utilizado para evitar que determinada biblioteca ou projeto seja alterado acidentalmente, ou que sejam copiados procedimentos de conhecimento especfico do desenvolvedor O boto Adicionar proteo permite configurar uma senha de proteo para o sistema.
474
Seguran a
Adicionar proteo O boto Alterar senha altera a senha de proteo do E3 Studio para o arquivo.
Alterao de senha de proteo O boto Remover proteo remove a proteo de edio deste arquivo. Para tanto, basta clicar no boto, digitar a senha e clicar em OK, que o sistema abrir uma caixa de mensagem informando se a ao foi executada corretamente. Proteo de Execuo: Esta opo utilizada para proteger o arquivo contra execuo no autorizada. Para tanto, necessrio solicitar a gravao de uma senha no dispositivo de proteo, que feita pela Elipse Software. Isto protege o desenvolvedor de cpias no autorizadas do projeto, por exemplo. Para isso, no momento do pedido de licena do E3 Server, necessrio fornecer a senha de execuo. Este processo feito posteriormente compra do servidor O boto Adicionar proteo permite configurar uma senha de proteo para o sistema.
Seguran a
475
Adicionar proteo O boto Alterar senha altera a senha de proteo de execuo para o arquivo.
Alterao de senha de proteo O boto Remover proteo permite remover a proteo de execuo deste arquivo. Para tanto, basta clicar no boto, digitar a senha e clicar em OK, que o sistema abrir uma caixa de mensagem informando se a ao foi executada corretamente. Quando um arquivo .lib ou .prj aberto no E3 Studio, este inicializa mostrando um cone cinza , com um cadeado indicando que est protegido e este contedo no pode ser acessado. Para acessar o contedo do arquivo, clique com o boto direito do mouse sobre o projeto ou biblioteca e selecione a opo Abrir com senha. Aps informar a senha e o sistema liberar o acesso, o cone fica colorido , indicando a acessibilidade dos arquivos.
O contedo de arquivos .prj e .lib protegidos criptografado. Quando um projeto protegido, as propriedades DocString e Domain so bloqueadas.
IMPORTANTE: As protees implementadas no podem ser desfeitas caso as senhas sejam perdidas. Portanto, ao proteger um arquivo, mantenha as senhas armazenadas em local seguro. Isso garante que se conseguir usar o arquivo sempre que necessrio.
476
Seguran a
24
CAPTULO
E3 Viewer e E3 WebViewer
O E3 Viewer o ambiente de visualizao do E3. Nele, possvel visualizar a execuo da aplicao feita no E3 Studio. O E3 WebViewer um componente ActiveX que faz o navegador comportar-se como o E3 Viewer, o que permite a visualizao e controle de aplicaes E3 via internet. Desta forma, possvel visualizar e interagir com um processo de cho de fbrica atravs de um navegador web comum. O navegador pode estar em qualquer computador da rede que tenha acesso ao E3 Server. Depois de instalado, o E3 WebViewer vai funcionar exatamente como o E3 Viewer, fazendo o download da aplicao (Telas, bitmaps, etc.) para a mquina local. Todas as funcionalidades do E3 Viewer (E3Chart, E3Alarm, etc.) so suportadas pelo E3 WebViewer.
E3 WebViewer em execuo (visualizao de uma aplicao) NOTA : Tanto o E3 Viewer quanto o E3 WebViewer aceitam as mesmas opes de zoom descritas no tpico Zoom do captulo Telas e Objetos de Tela. Alm disso, a qualidade grfica das Telas pode ser modificada, em tempo de execuo, utilizando-se o menu contextual tanto do E3 Viewer quanto do E3 WebViewer e selecionando uma das opes do menu Qualidade (todas as telas). Para maiores informaes, veja a propriedade RenderQuality do Viewer no Manual de Scripts do E3 . E3 V iew er e E3 W ebV iew er 477
Permanecem permitidos neste modo: Leituras de propriedades de objetos do servidor, tanto por Associaes como por scripts Chamadas de mtodos considerados no restritos de objetos do servidor em scripts do Viewer. So estes: Item (todos os objetos); Refresh (Grupo OPC); FindUnit, FindValue , GetValueData e GetUnitData (Frmula); GetAlarm (Fonte de Alarmes); GetE3QueryFields, GetADORecordSet e GetAsyncADORecordSet (Consulta); e GetObject (Servidor de Aplicaes) Mudanas do estado de Advise de Tags do servidor Mudana da prpria senha (mtodo ChangePassword do Viewer)
478
importante lembrar que, no caso de no haver usurio logado no Viewer (usurio annimo), ser aplicada a restrio de acesso, desde que pelo menos um ou mais usurios tenha esta restrio. Desta forma, cada vez que ocorre uma mudana de usurio o modo de acesso do Viewer pode ser mudado (e consequentemente a propriedade IsReadOnly), de acordo com a combinao do que permitido pela licena em uso e a permisso do usurio logado. A mudana do modo de acesso tambm pode acontecer caso ocorra a reconexo do Viewer, j que esta pode provocar tanto a mudana de licena (de Viewer Full para Viewer Only, ou viceversa) quanto a mudana das permisses do usurio logado. Caso haja algum usurio com acesso de escrita ao servidor bloqueado no momento da abertura do Viewer, este entra automaticamente no modo Somente Leitura, independentemente da licena em uso, j que o usurio annimo sempre assume a restrio mxima configurada.
Barra de Ferramentas Padro Executar Aplicativo: Salva todas as configuraes do projeto, roda o Domnio e executa o E3 Viewer Rodar/Parar Domnio: Executa ou para a execuo do Domnio Executar/Parar E3 Viewer: Executa o E3 Viewer ou para a sua execuo caso ele j esteja aberto 479
Quando o E3 Viewer executado, o sistema mostra a janela a seguir, indicando o estado da conexo:
Mensagem de estado de conexo Quando a conexo com o servidor perdida, o E3 tenta restabelec-la automaticamente, respeitando as configuraes do servidor. Para determinar qual servidor far a conexo caso o E3 Viewer falhe, necessrio configurar a opo Servidores, configurado atravs do E3 Admin, conforme explicado no captulo Domnios.
O argumento nome_do_servidor representa o nome da mquina onde o E3 Server est rodando. Se este argumento no for informado, uma caixa de dilogo mostrada perguntando o caminho do servidor da aplicao, como ocorre quando o E3 Viewer executado a partir do menu Iniciar (como mostrado na prxima seo). As opes de configurao para a linha de comando so as seguintes: -screen ou /screen: Permite ao usurio informar uma tela inicial vlida, diferente da tela inicial configurada no Domnio
Viewer [nome_do_servidor] screen <nome_da_tela>
-noping ou /noping: Descarta a necessidade de se executar um comando ping para o servidor antes da tentativa de conexo (Tentativa de conexo direta)
Viewer [nome_do_servidor] noping
-readonly ou /readonly: Permite ao usurio especificar que o Viewer deve tentar conectar apenas no modo Somente Leitura. Quando isto for feito, o Viewer ir sempre utilizar uma licena Viewer Only
Viewer [nome_do_servidor] readonly
480
-cachepath ou /cachepath: Permite especificar um diretrio para a gravao do cache do Viewer. Se no for especificado, usado o diretrio temporrio do sistema (varivel de ambiente TEMP )
Viewer [nome_do_servidor] cachepath <diretorio>
-useservers ou /useservers: Esta opo faz com que o Viewer tente se conectar somente aos servidores especificados na linha de comando. Se a opo no estiver presente (comportamento padro), o Viewer pode tentar descobrir servidores alternativos caso no consiga se conectar aos servidores passados na linha de comando. Esta opo funciona apenas em rede local, portanto deve ser informada caso o servidor que o Viewer deve acessar esteja fora da rede local
Viewer [nome_do_servidor] useservers
-params: Permite que o usurio especifique parmetros de inicializao do Viewer. Esta opo no pode vir imediatamente antes da lista de servidores. Os valores passados nessa opo podem ser recuperados via script utilizando a propriedade Params do Viewer. Para maiores informaes sobre a utilizao dessa propriedade, veja o captulo Viewer, do Manual de Scripts do E3
Viewer -params <Nome1>=<Valor1> [<Nome2>=<Valor2>] ...
-help: Mostra uma caixa de dilogo com exemplos de uso das opes de linha de comando do Viewer, como na figura a seguir
481
E3 Viewer Se o E3 Server estiver na mesma mquina do E3 Viewer, selecione a opo Servidor Local. Caso eles estejam em mquinas diferentes, selecione a opo Servidor na rede e informe o nome ou o endereo IP da mquina com o E3 Server. Se o E3 Server estiver disponvel em uma porta diferente do padro (6515), informe o nmero desta porta no campo Servidor na rede aps o nmero do IP, separados por dois pontos. Para se conectar no modo Somente Leitura, selecione a opo Iniciar o Viewer no modo apenas de leitura.
482
A pgina docwrite2.asp vem configurada considerando-se que o E3 Server est rodando no mesmo computador que o E3 WebServer (servidor web). Porm, possvel alterar o cdigo fonte desta pgina para atender a configurao desejada. Para tanto, basta alterar a linha a seguir no cdigo fonte da pgina docwrite2.asp:
var Domain = getDomain();
Para:
var Domain = "IP externo do servidor IIS";
Caso se queira permitir ao usurio informar uma tela inicial vlida, diferente da configurada no Domnio, deve-se alterar a linha abaixo, colocando em Nome_da_tela um nome de Tela vlido na aplicao:
<param name='Screen' value='Nome_da_tela'>
Caso se queira informar a necessidade de se executar o comando ping para o servidor antes de tentar a conexo, deve-se alterar a linha abaixo. O valor pode ser True ou False.
<param name='Ping' value='TRUE'>
Se esta linha for omitida, o comando ping ser executado. Para se navegar para uma pgina diferente do padro aps o carregamento do E3 WebViewer, deve-se modificar o atributo value do parmetro URLToLoad para o endereo desejado:
<param name='URLToLoad' value='url'>
Se esta linha for omitida, a pgina e3web2.asp ser carregada. Para especificar um diretrio para a gravao do cache do Viewer, deve-se alterar a linha a seguir. Se no for especificado, usado o diretrio temporrio do sistema (varivel de ambiente TEMP ).
<param name='cachepath' value='diretorio_para_cache'>
483
Caso seja preciso que o WebViewer procure por outros servidores na rede se no conseguir conectar-se ao servidor especificado no parmetro Domain , deve-se alterar a linha a seguir. Se o parmetro no for informado, o WebViewer tentar se conectar apenas ao servidor especificado no parmetro Domain , que o comportamento padro do WebViewer (valor True). A alterao do valor para False s ir funcionar para servidores e WebViewers que estejam na mesma rede.
<param name= 'useservers' value='FALSE'>
A configurao do E3 WebViewer para abrir no modo Somente Leitura feita atravs da propriedade StartReadOnly (com os valores True ou False). Se este item no existir, o valor assumido False (comportamento compatvel com verses anteriores). Exemplo:
var conteudo = "<object classid='clsid:7EB4D157-FACC-45BB-9536-C14B9DCE3CA7'"; conteudo += " width='100%' height='100%'>"; conteudo += "<PARAM NAME='Domain' VALUE='192.0.0.21'>"; conteudo += "<PARAM NAME='Screen' VALUE=''>"; conteudo += "<PARAM NAME='CachePath' VALUE=''>"; conteudo += "<PARAM NAME='Ping' VALUE='0'>"; conteudo += "<PARAM NAME='StartReadOnly' VALUE='FALSE'>"; conteudo += "</object>"; document.write(conteudo);
Em ambos os casos, esta configurao s ter efeito na abertura do E3 WebViewer. Se a propriedade for mudada durante a execuo, a conexo ou reconexo do E3 WebViewer no ser afetada. Os servidores e o E3 WebViewer podem tanto rodar na mesma mquina quanto em mquinas diferentes. A seguir, veremos como estas situaes se aplicam.
484
Internet Information Services (IIS) 4. Selecione na lista o item Internet Information Services (IIS) e clique em Prximo (Next). 5. O sistema inicia a instalao do software (para instalar o IIS preciso ter o CD de instalao do Windows). 6. Aguarde a finalizao do processo para configurar o sistema.
Aps a instalao do IIS, os arquivos e3web.asp, e3web2.asp, docwrite.asp, docwrite2.asp e e3downloader.cab devem ser copiados para c:\InetPub\wwwroot. Esta pasta criada na instalao do IIS. Alm dos arquivos .asp, o instalador do E3 WebViewer tambm deve ser copiado para esta mesma pasta. Este instalador (e3-w2kwebviewer.exe) utilizado quando a mquina cliente acessar o servidor pela primeira vez, caso o E3 no tenha sido previamente instalado nesta mquina. Este arquivo est no CD de instalao do E3, ou pode ser obtido atravs de download no site da Elipse. O IIS ainda necessita ser configurado para seu correto funcionamento. A configurao ser diferente caso o IIS e o E3 Server estejam na mesma mquina ou em mquinas diferentes. Para configur-lo, consulte o Guia de Instalao do E3 , na seo Instalao do E3 WebViewer.
estes no tenham sido previamente instalados, conforme explicado no comeo deste captulo. O componente assinado por Elipse Software e o usurio dever aceitar a instalao, para que se iniciem as configuraes necessrias.
Instalao do Web Viewer Aps a instalao, o WebViewer estar aberto no browser, e visualizando a aplicao do servidor. Nos prximos acessos no ser mais necessrio instalar os componentes e o tempo de conexo ser mais rpido.
NOTA : A verso do cliente tem que ser a mesma do servidor. Para isto, o instalador (e3w2kwebviewer.exe) que fica no servidor deve ser sempre o mais atual.
486
25
CAPTULO
Hot-Standby
O Hot-Standby permite a implementao do conceito de fail-over em um sistema supervisrio. Esse conceito consiste na possibilidade de se ter dois servidores (principal e backup ) atuando um como contingncia do outro, ou seja, se o servidor principal falhar, um servidor de backup entra em ao imediatamente, sem perda da continuidade do processo. Este servidor em espera diz-se que est em Standby. Assim, a ferramenta de Hot-Standby do E3 tem como objetivo permitir que um servidor fique em estado de espera (Standby), aguardando uma possvel falha de um outro servidor (servidor ativo). A troca de servidor ativo pode ser manual ou automtica. A troca manual acionada atravs do menu do E3 Admin na rea de Notificaes do Windows do computador em Standby (opo Servidor - Ativar). A troca automtica ocorre quando o servidor em Standby detecta que o servidor principal no est mais rodando. Um servidor pode assumir um dos seguintes estados: Servidor em Manuteno: Este estado indicado na configurao do servidor do Domnio. Um servidor em manuteno no toma parte em nenhum evento do Domnio Servidor Ativo: Apenas um servidor pode estar ativo em um Domnio em um determinado momento. O servidor ativo aquele que est rodando o aplicativo (E3Run) Servidor Standby: Apenas um servidor pode estar em Standby em um Domnio em um determinado momento. O servidor Standby roda o E3Run em modo Standby, o aplicativo fica carregado, apenas esperando um comando para entrar em operao. O servidor Standby monitora o servidor ativo e, se este no estiver respondendo, o Standby ativado Servidor Inativo: Um servidor fica inativo quando est declarado no Domnio, mas no est selecionado como servidor principal nem como backup . Mesmo inativo, este servidor monitora mudanas no arquivo de Domnio, podendo passar para o estado Ativo ou Standby se o Domnio for reconfigurado
IMPORTANTE: Para rodar uma aplicao redundante no E3, necessrio que todos os servidores rodem a mesma verso do software, e tenham uma cpia local atualizada dos arquivos do Domnio (arquivos .prj, .lib, etc.). O arquivo .dom, por sua vez, sincronizado automaticamente pelo E3 Server, isto , mudanas feitas no arquivo .dom em um servidor so automaticamente copiadas para o arquivo .dom dos outros servidores do Domnio. Para isto, o arquivo .dom deve obrigatoriamente existir no mesmo caminho em todos os servidores.
O Hot-Standby usa a conexo REC, portanto ele s funciona se o E3 Server estiver iniciado nas Hot-Standby 487
mquinas envolvidas. Se o usurio de um E3 Studio ou Hot-Standby administrador da mquina remota onde o E3 Server est rodando, ele pode controlar o servio remotamente usando o aplicativo services. msc , atravs da opo Action - Connect to another computer.
E3 Admin 4. Na aba Servidores, adicione os servidores principal e backup . Configure as opes Nome do servidor e Identificao do servidor na rede . Por exemplo: Nome do servidor: Servidor1 Identificao do servidor em rede : \\Computer1
488
Hot-Standby
Configurao do Servidor 5. Na aba Opes, marque o item Hot-Standby - Habilitar. No campo Servidor principal, selecione o servidor principal do seu projeto e no campo Servidor de backup, selecione o servidor de backup . O E3 ir buscar o servidor principal por ordem alfabtica. 6. Defina a opo Endereos para PING de integridade de rede . Esta opo especifica uma terceira entidade de rede (as outras so os servidores principal e backup ) para determinar se a rede est funcionando. Se no for possvel acessar o endereo de integridade nem o servidor de backup , o servidor principal assume que a sua interface de rede est com problemas e altera seu estado para Standby (modo de espera). 7. Habilite a opo Ativar backup em caso de falha local. Esta opo serve para habilitar a troca automtica de servidores quando uma falha local reportada no servidor principal. Falhas locais so detectadas e reportadas pelo prprio aplicativo atravs do mtodo ReportFailure . A troca de servidores s feita se o servidor backup estiver sem falhas.
Hot-Standby
489
Configurao da distribuio em rede 8. Para confirmar as configuraes, clique no boto OK. 9. Ao iniciar a execuo do E3 ser mostrado, na rea de Notificaes do Windows dos computadores configurados no Hot-Standby, um cone representado por uma barra amarela circulante , indicando que os Domnios esto sendo carregados. Aps alguns segundos, o E3 reconhece o computador principal e indica esse estado, na rea de Notificaes do Windows, com um cone representado por uma seta verde . Este cone determina que ele est em execuo. No computador standby ser mostrado um cone representado por duas barras amarelas (modo de espera). , indicando que ele est em modo Standby
Este servidor iniciar os servidores do Domnio e depois ser automaticamente fechado. Um 490 Hot-Standby
Domnio pode ser iniciado tambm atravs do E3 Studio. Para tanto, basta abrir o Domnio e clicar no boto .
IMPORTANTE: As opes de parar e fechar um Domnio AFETAM TODOS OS SERVIDORES DO DOMNIO, e no apenas o servidor onde o comando executado.
Hot-Standby
491
NOTA : Se a aplicao principal no conseguir enviar os dados para o servidor em Standby, esses dados ficaro armazenados localmente em disco, para posterior envio (quando a comunicao entre os dois computadores for restabelecida), assegurando assim a igualdade entre as tabelas geradas pela aplicao.
492
Hot-Standby
26
CAPTULO
Configuraes Avanadas
Existem configuraes do E3 que podem ser realizadas diretamente no registro do Windows, embora esse procedimento no seja aconselhvel. A Elipse Software possui uma ferramenta, chamada E3 Tweak, disponvel a partir da verso 3.1, que realiza as configuraes de registro usando uma interface grfica. O Manual do Usurio do E3 Tweak pode ser acessado no menu Iniciar - Programas - Elipse Software - Elipse E3 - Manuais - Manual do E3 Tweak. O aplicativo E3 Tweak pode ser aberto de trs formas: Pelo menu Iniciar - Programas - Elipse Software - Elipse E3 - E3 Tweak Pelo menu Ferramentas - E3 Tweak do E3 Studio Pelo item Atalhos - E3 Tweak do menu do E3 Admin na rea de Notificao do Windows
493
27
CAPTULO
Este captulo destina-se ao esclarecimento das dvidas mais frequentes encontradas no E3. Tambm so mostrados os erros que podem ocorrer e quais as solues para eles.
NOTA : No tente remover a Animao do objeto atravs do Organizer, pois esta ao ir remover o objeto.
494
495
496
SOLUO Isto seria considerado um erro apenas se persistisse nos logs da aplicao. Error = ORA-00001: restrio exclusiva (SYSTEM.E3INDEX) violada POSSVEL CAUSA Sempre que for feita uma tentativa de escrita de um registro onde o campo definido como chave primria tiver o valor repetido, a escrita ser recusada e a mensagem anterior ser exibida. interessante verificar que o nome da chave mostrado (neste caso, a chave SYSTEM.E3INDEX ) no formato Usurio.NomeChave. Dependendo do projeto, esse erro esperado, mas na grande maioria das vezes, importante verificar se a chave a mais adequada. Para ilustrar essa afirmao, veja estes dois casos: Sistema de Telemedio de Energia: Visando gravar todos os dados de um dia, as rotinas usadas para coletar dados admitem tolerncias a mais ou a menos no horrio a ser coletado. Assim, alguns dos registros tero de ser escritos mais de uma vez. Neste caso, a ocorrncia desse erro esperada Manuteno de alarmes: Para esse caso, pode haver mais de um erro por segundo no sistema. Se o campo E3TimeStamp for usado como chave primria, pode haver a perda de algumas ocorrncias de alarme, o que prejudica a anlise posterior dos eventos. Neste caso, re-estudar a chave-primria pode ser a soluo adequada
SOLUO H duas maneiras de solucionar esta questo: 1. O usurio deve criar um ndice nico para os campos da chave. 2. O usurio deve verificar a aplicao para que ela no envie valores repetidos de chave para gravao.
497
Como eu mostro a data e a hora atual do sistema em uma tela da minha aplicao? Crie um Tag Demo do tipo CurrentTime e associe-o a um Display na Tela. O formato de data e hora pode ser configurado na aba Formatao das propriedades do Display. Como criar um temporizador no E3? Com um Tag Demo do tipo Square . O Tag deve ter a propriedade Enabled igual a False e a propriedade Period igual a duas vezes o tempo limite em milissegundos. A atribuio do valor True propriedade Enabled iniciar a contagem do tempo. Para executar um script qualquer no trmino do temporizador, basta criar um evento associado propriedade Value do Tag Demo, que seja executado quando a propriedade alterar o seu valor. Neste script tambm se deve desabilitar o Tag Demo, ou seja, atribuir propriedade Enabled o valor False, para que ele no continue variando. Recomenda-se usar o mtodo Reset do Tag Demo antes de atribuir propriedade Enabled o valor True.
498
27.8 Alarmes
Foi encontrado um erro no nmero de colunas do arquivo CSV na importao de um Alarme do tipo <nomedotipo>. Deseja continuar a importao dos demais Alarmes, ignorando os erros? POSSVEIS CAUSAS O arquivo CSV para os alarmes que se quer importar possui um erro nas colunas do Alarme do tipo indicado. Arquivos de alarmes devem ter sempre o nmero mnimo de colunas esperado, de acordo com cada tipo. Colunas extras so desprezadas. Para saber a maneira correta de criar um arquivo CSV para alarmes, veja a seo Criando um arquivo CSV manualmente , no captulo E3 Studio. SOLUO Existem trs possveis respostas pergunta feita na mensagem de erro: Sim: A importao dos Alarmes contidos no arquivo CSV ir prosseguir, ignorando apenas este erro de nmero de colunas. O Alarme cujas colunas esto incorretas no ser importado Sim (Todos): A importao dos Alarmes ir prosseguir, ignorando todos os demais Alarmes com erro no nmero de colunas que possam existir no arquivo CSV No: A importao ser interrompida, mas os Alarmes j importados so preservados
Para que este erro no ocorra, o arquivo CSV deve ser criado de acordo com as recomendaes do captulo Alarmes.
IMPORTANTE: Embora os arquivos de Tags e Alarmes tenham a mesma extenso (.csv), eles so internamente diferentes. Sendo assim, um arquivo de Alarmes no serve para Tags e vice-versa.
Criei um arquivo CSV manualmente, contendo a configurao dos Alarmes. Como fao para import-lo? Verifique as configuraes regionais no Painel de Controle do Windows, e confirme se o caractere separador o mesmo utilizado no arquivo CSV. DICA : crie um Alarme no E3 e utilize a ferramenta de exportao, utilizando-o como modelo para a gerao dos novos Alarmes. Como mostrar o campo E3TimeStamp com milissegundos no E3Browser e no E3Alarm? Use o formato Outros, digitando "dd/MM/yyyy HH:mm:ss.000". Esta configurao para o E3Browser feita na aba Fontes de Dados, na coluna Formato de cada campo. Para o E3Alarm, tal configurao feita na aba Colunas, clicando no boto Propriedades de cada campo.
499
Aparece a seguinte mensagem de erro: "Impossvel criar assinaturas de Alarmes no Servidor de Alarmes com filtro. Error code: (0x800706F7)". O qu isto significa? O nome do Servidor de Alarmes no foi especificado no E3Alarm, ou ento est com erro. Para que o E3Alarm consiga capturar e exibir os Alarmes ativos, necessrio configurar o nome do Servidor de aAlarmes que ser acessado. Para isso, modifique o item Nome do Servidor de Alarmes, na aba Geral das propriedades do objeto E3Alarm, ou atravs da Lista de Propriedades, acessando a propriedade AlarmServer. Como apagar Tags associados a Alarmes, Alarmes e reas do objeto Configurao de Alarmes? Para apagar um Tag que est associado a um Alarme : Selecionar o Tag desejado com o mouse e pressionar a tecla DELETE Para apagar um Alarme : Selecionar o Alarme desejado com o mouse e apertar a tecla DELETE Para apagar uma rea: Selecionar a rea desejada com o mouse e apertar a tecla DELETE Como exibir as mensagens "Alta", "Mdia" e "Baixa" no campo Severidade de um Alarme ao invs dos valores 0, 1 e 2 em uma consulta SQL? A sintaxe SQL para cada um dos bancos de dados suportados pelo E3 a seguinte: Access:
SELECT InTime, OutTime, Message, FormattedValue, IIF(Severity = "0", "Alta", IIF(Severity = "1", "Mdia", "Baixa")) AS Severidade FROM Alarms;
SQL Server:
SELECT InTime, OutTime, Message, FormattedValue, Severidade = CASE Severity WHEN 0 THEN 'Alta' WHEN 1 THEN 'Mdia' WHEN 2 THEN 'Baixa' END FROM Alarms;
Oracle :
SELECT InTime, OutTime, Message, FormattedValue, DECODE(Severity, 0, 'Alta', 1, 'Mdia', 2, 'Baixa') Severidade FROM Alarms;
27.9 E3Alarm
Os Alarmes no aparecem no E3Alarm. Por qu isto ocorre? POSSVEIS CAUSAS Para checar a configurao do E3Alarm, verifique se o nome do Servidor est configurado corretamente. Outra possibilidade a existncia de mais de um Servidor de Alarmes no Domnio, o que pode gerar problemas. Mais uma situao de erro seria um filtro configurado para uma rea de Alarme inexistente.
500
SOLUO Certifique-se de que existe apenas um Servidor de Alarmes no seu Domnio e que todos os Alarmes esto configurados corretamente. Confira tambm se a rea configurada existe. Como fazer um filtro por duas ou mais reas no E3Alarm? Primeiro, agrupe as reas em uma rea principal. Depois, use nomes com os mesmos caracteres iniciais. Exemplo: ALM1MEC, ALM1ELE, ALM2MEC, ALM2ELE, etc. Como reconhecer Alarmes com duplo-clique? Habilite a opo Reconhecer Alarme , localizada nas propriedades da coluna desejada no objeto E3Alarm, na aba Colunas.
27.10 E3Browser
Como limitar o nmero de registros que vo aparecer no E3Browser? Este item pode ser configurado na consulta do E3Browser. s habilitar a caixa de seleo Retornar no mximo ... registros, especificando o nmero mximo de registros a serem retornados. Outra opo otimizar a consulta a ser feita utilizando os filtros para restringir o perodo, a quantidade de colunas ou registros envolvidos, etc. Para isto, veja o captulo Consultas.
27.11 E3Chart
possvel no plotar o valor de um Tag quando a qualidade estiver ruim, em um E3Chart histrico? Sim. Via scripts, possvel configurar o E3Chart para isto.
Set Pena = Screen.Item("E3Chart1").Pens Pena.Item("Nome da Pena").ShowBadPoints = False
Observe, no entanto, que esta soluo somente vlida para valores histricos. Em tempo de execuo, o valor ser sempre plotado, independente da qualidade do Tag.
27.12 Histrico
Como no gravar os registros de histricos por scan? Configure a opo Gravar um novo script a cada, da aba Histrico, nas Propriedades do Histrico, com valor 0. Se desejar faz-lo por script, a propriedade a ScanTime . Com isto, os valores no sero registrados automaticamente, sendo necessrio fazer o registro via script utilizando o mtodo WriteRecord.
501
27.13 Associaes
Como criar um Tag Expresso no E3? Associando a propriedade Value de um Tag Interno expresso desejada. A expresso pode ser do tipo simples e pode conter operadores aritmticos e lgicos envolvendo constantes e outros Tags. Como mudar a cor de um objeto ao passar o mouse sobre ele? Criando uma Associao Digital entre as propriedades ForegroundColor e MouseOver de um objeto. A propriedade MouseOver do tipo Booleana, e assume o valor True quando o mouse estiver sobre objeto e False quando o mouse estiver fora da rea do objeto. Como criar uma aplicao multilngue? H duas formas de se fazer isto. Uma delas criar um Tag Interno no Viewer para cada String e associar estes Tags s propriedades que devem ser traduzidas (ou utilizar os Tags por script no caso de usar um Msgbox). Depois, crie uma tabela com todas as Strings da aplicao, onde a primeira coluna o nome do Tag Interno criado no Viewer, e cada coluna seguinte contm a String correspondente a um idioma. Esta tabela pode ser no Access, por exemplo. Ao abrir o Viewer e definir o idioma, carregue os Tags Internos do Viewer com as Strings da tabela correspondente ao idioma escolhido. Isto pode ser feito utilizando um objeto Consulta na Tela. Segue um exemplo de script:
Sub Tela1_OnPreShow(Arg) Set rs = Item("Query1").GetADORecordset() rs.MoveFirst For i = 1 To rs.RecordCount Application.Item(rs.Fields("NomeTag").Value).Value = _ rs.Fields(Arg).Value ' Arg um parmetro passado para a Tela contendo o nome ' da coluna referente ao idioma selecionado rs.MoveNext Next End Sub
Outra maneira criar uma Associao por Tabela em todas as propriedades que possurem contedo a ser traduzido, usando para todas as Associaes a mesma fonte. Em cada faixa de valores da Associao, coloque uma String referente a um idioma diferente. A fonte pode ser um Tag Interno cujo valor pode ser definido ao abrir o Viewer. No caso do MsgBox, usar o mesmo Tag como condio para escolher qual String ser utilizada.
27.14 Viewer
No consigo conectar um Viewer remoto ao Servidor. Por qu isso est acontecendo? POSSVEL CAUSA Existe um firewall bloqueando o acesso ao servidor.
502
SOLUO Deve-se liberar as portas utilizadas pelo E3. O procedimento para desbloquear uma porta no firewall do Windows est descrito a seguir.
NOTA : A porta padro utilizada pelo E3 a 6515, mas esse comportamento pode ser alterado conforme descrito no item Execuo do E3 Viewer - Execuo atravs do Menu Iniciar .
Windows XP 1. V ao menu Iniciar - Painel de Controle . 2. Clique em Central de Segurana. 3. Clique em Firewall do Windows. 4. Selecione a aba Excees e clique no boto Adicionar Porta. 5. Digite um nome e o nmero da porta a ser liberada. Deixe a opo Protocolo selecionada como TCP. 6. Clique em OK para salvar as alteraes. Windows Vista 1. V ao menu Iniciar - Painel de Controle . 2. Clique em Firewall do Windows. 3. Selecione a aba Excees e clique no boto Adicionar Porta. 4. Digite um nome e o nmero da porta a ser liberada. Deixe a opo Protocolo selecionada como TCP. 5. Clique em OK para salvar as alteraes. Windows 7 1. V ao menu Iniciar - Painel de Controle . 2. Clique em Firewall do Windows. 3. Clique na opo Configuraes Avanadas. 4. Selecione a opo Regras de Sada.
503
5. Clique em Nova Regra. 6. Selecione o item Porta e clique em Avanar. 7. Selecione a opo TCP e em Portas Remotas Especficas digite o nmero da porta a ser liberada. 8. Na prxima janela, selecione Permitir a Conexo. 9. Digite um nome para a porta e clique em OK para salvar as alteraes e fechar a janela. No consigo abrir um Viewer remoto pelo Internet Explorer. Por qu isso est acontecendo? POSSVEIS CAUSAS O Viewer no foi instalado na mquina remota Existe um firewall bloqueando o acesso ao servidor
SOLUO Pode-se instalar o Viewer na mquina remota ou ento colocar o arquivo de instalao do Viewer na pasta C:\Inetpub\wwwroot do computador servidor. Assim, toda vez que se tentar abrir um Viewer pelo Internet Explorer num computador remoto onde o Viewer no foi previamente instalado, a instalao ser iniciada automaticamente.
27.15 Bibliotecas
Ao abrir uma Tela, aparece uma mensagem dizendo que um objeto no pode ser carregado corretamente POSSVEL CAUSA Foi apagado algum XControl da Biblioteca que estava sendo usada dentro desta Tela ou ento foi removido do Domnio a Biblioteca que contm este XControl. SOLUO No primeiro caso, se foi apagado o XControl, no h mais como recuper-lo. Para corrigir o erro, s apagar o objeto ElipseX que ficou dentro da Tela (pelo Organizer pode-se ver um ponto de interrogao sobre o cone do objeto. Na Tela aparece um quadrado preto com um X). No segundo caso, basta adicionar a Biblioteca ao Domnio.
504
Ao abrir uma Tela, aparece uma mensagem de erro dizendo que no foi possvel abrir uma Biblioteca ActiveX POSSVEL CAUSA Alguns ActiveX utilizados nesta Tela no foram registrados e adicionados no computador. SOLUO Registre e adicione o ActiveX atravs da opo Adicionar ActiveX, disponvel no menu Ferramentas. Para tanto, voc deve ter o arquivo OCX que contm a Biblioteca. Ao inserir um ActiveX na minha Tela ocorreu um erro 80040112. O qu isto significa? POSSVEL CAUSA Este erro indica que o ActiveX a ser inserido no est licenciado em sua mquina. Durante o instanciamento, o controle procura no Registro do Windows por sua chave de licena ( HKEY_CLASSES_ROOT\Licenses) e, caso no encontre, retorna este erro. Existem chaves de licena para os objetos ActiveX, tanto para ambientes de desenvolvimento quanto para tempo de execuo. SOLUO Para resolver este problema, preciso adquirir a licena deste ActiveX e registr-lo em seu computador. Tenho duas Bibliotecas em meu Domnio, mas no consigo utiliz-las ao mesmo tempo. Quando registro uma, a outra deixa de funcionar. Como posso resolver este problema? Provavelmente, uma das Bibliotecas foi criada a partir da cpia da outra, ficando as duas com o mesmo identificador. Por isto, ser necessrio remover uma delas do Domnio.
27.16 Relatrios
Como colocar a data e a hora atual em um Relatrio do E3? Existem pelo menos duas alternativas para solucionar isso: Coloque um Texto na seo PageHeader e, no evento OnFormat da seo PageHeader, escreva o seguinte script:
Report.Sections("PageHeader").Controls("Label1")._ Caption = Now
Onde Label1 o nome do rtulo criado. Crie um Tag Demo do tipo CurrentTime . No cabealho ou no rodap do Relatrio, deve-se inserir um objeto SetPoint, e na propriedade DataField, deve-se digitar o nome completo do Tag (por exemplo, Dados.TagDemo1.Value ). Configure o formato da data desejada. Isto Dvidas mais Frequentes 505
pode ser feito clicando com o boto direito do mouse sobre o objeto e ajustando as suas propriedades ou ento digitando diretamente o formato na propriedade OutputFormat, na Lista de Propriedades (um exemplo de formato de data "dd/MM/yyyy hh:mm:ss"). Tenho um Relatrio que mostra o resultado de uma Consulta que possui um filtro por data. Quando o Relatrio gerado, a Consulta no retorna os valores configurados via script para estas variveis. Como solucionar este problema? Verifique, no script que configura ou acessa este Relatrio, se aps os valores para as variveis da Consulta terem sido configurados no foi acionado o mtodo LoadReport, j que este mtodo carrega o Relatrio com as configuraes feitas no E3 Studio. Utilize somente uma vez o mtodo LoadReport no script, carregando o Relatrio para uma varivel (atravs do comando Set). Como executar corretamente um Relatrio que utiliza o mtodo CopyConfig para copiar para si as configuraes de um E3Chart em Tela? O mtodo CopyConfig no copia os valores de variveis de consulta, sendo necessrio fazer isto via script dentro do grfico. As penas configuradas no E3Chart em Tela so do tipo Real. Como fazer um filtro por datas no Relatrio? Crie uma Consulta SQL no Relatrio filtrando por data inicial e final. Na Tela onde se deseja gerar este Relatrio, deve-se executar a Consulta SQL configurada passando os valores de data inicial e final. O script do boto na Tela onde gerado o Relatrio, por exemplo, pode ser implementado assim:
DataInicial = CDate(Screen.Item("TextoDataInicial").Value) DataFinal = CDate(Screen.Item("TextoDataFinal").Value) Set Report1 = Application.LoadReport("Report1") Set Consulta = Report1.Item("Query1") Consulta.SetVariableValue "DataInicial", (DataInicial) Consulta.SetVariableValue "DataFinal", (DataFinal) Report1.PrintPreview()
Como mostrar as datas utilizadas como filtro na Consulta no PageHeader do Relatrio? Primeiramente, adicione dois Setpoints no PageHeader (um para mostrar a data inicial e outro para a data final) e crie um script que passe os valores que foram carregados nos Setpoints da Tela (e transferidos para a Consulta) para estes dois Setpoints. O script a ser criado no objeto PageHeader, no evento OnBeforePrint do Relatrio:
Set dados = Application.GetFrame().Screen Report.Sections("PageHeader").Controls("Field5").Text = _ dados.Item("TextoDataInicial").Value Report.Sections("PageHeader").Controls("Field6").Text = _ dados.Item("TextoDataFinal").Value
Depois, associe dois Tags Internos aos Setpoints da Tela onde so especificadas as datas. Associe estes Tags aos Setpoints no Relatrio.
506
Como imprimo dois Relatrios em impressoras diferentes? Crie o seguinte script no evento OnReportStart do Relatrio:
Sub OnReportStart Report.Printer.DeviceName = "Nome da Impressora" End Sub
Como utilizo o evento de script OnError para mostrar uma mensagem de erro quando falhar a impresso do Relatrio? O evento OnError do Relatrio no permite que sejam executados scripts dentro dele, servindo somente para seu uso interno. Isto significa que no possvel alterar a mensagem de erro, nem executar algum outro procedimento a partir deste evento.
507
O nome do Domnio no foi informado Esta mensagem aparece quando forem usadas as opes -viewer ou -start sem o nome de Domnio. Para maiores informaes, consulte o captulo Domnios Como duas ou mais pessoas podem trabalhar ao mesmo tempo no mesmo Domnio? Criando o Domnio pela rede, vrias pessoas podero abr-lo em mquinas diferentes e trabalhar nele ao mesmo tempo. As alteraes salvas por uma pessoa sero visveis para todas as outras, assim que abrirem o objeto especfico alterado, ou ento assim que atualizarem o projeto ou a Biblioteca alterados. Qual o efeito de clicar na opo Atualizar do menu do projeto? Todos os objetos do projeto so atualizados. Por exemplo, se vrias pessoas estiverem trabalhando ao mesmo tempo no mesmo Domnio, as alteraes salvas por uma pessoa sero visveis para todas as outras, assim que abrirem o objeto especfico alterado ou quando atualizarem o projeto ou a Biblioteca alterados.
Onde a sintaxe das variveis o sinal de maior que, o sinal de percentual entre o nome da varivel e o sinal de menor que. var1 e var2 so as variveis que a Stored Procedure est esperando (por exemplo, data inicial e final). Caso a Stored Procedure no esteja esperando nenhuma varivel, basta criar o comando SQL sem as variveis. Para executar esta Consulta, basta utilizar o mtodo Execute .
Limitaes do Modo Demonstrao. Quando cai a comunicao entre o Domnio Cliente e o Domnio Servidor, o qu acontece? Quando uma situao de erro ocorrer, todos as Associaes da aplicao cliente referenciando o Domnio ficaro desconectadas (Displays, por exemplo, passaro a mostrar o texto que indica erro de comunicao, conforme as configuraes do objeto Viewer), assim como todos os comandos Application.GetObject referenciando o Domnio Remoto iro falhar (ou seja, causaro erros de script). Quando o problema for resolvido, as Associaes devero reconectar-se automaticamente. J os comandos Application.GetObject devero ser executados novamente. Um Domnio Cliente pode visualizar Alarmes de outros Domnios Remotos? No, mas isso uma caracterstica que poder ser implementada em verses futuras. Agora, necessrio duplicar os Alarmes no Domnio Remoto. Um Domnio Cliente pode abrir Telas de outros Domnios Remotos? No. Um Domnio Cliente pode usar usurios de outros Domnios Remotos? No. possvel conectar um Domnio a vrios outros Domnios? Sim, como pode-se ver na figura a seguir.
509
Conectar um Domnio a vrios outros Domnios possvel conectar um Domnio a um Domnio em Hot-Standby? Sim. Considere a seguinte arquitetura.
Conectar um Domnio a um Domnio em Hot-Standby Atravs dos Domnios Remotos essa arquitetura possvel. Tem-se um Domnio de Comunicao, em Hot-Standby, comunicando com os dispositivos. Esses dados seriam lidos por um outro Domnio, tambm em Hot-Standby, que seriam o servidor para os computadores 510 Dvidas mais Frequentes
clientes (Viewers).
511
Matriz Rua 24 de Outubro, 353 - 10 andar 90510-002 Porto Alegre RS Fone: (51) 3346-4699 Fax: (51) 3222-6226 E-mail: elipse@elipse.com.br
Filial MG Rua Antnio de Albuquerque, 156 7 andar Sala 705 30112-010 Belo Horizonte - MG Fone: (31) 2511-2121 E-mail: elipse-mg@elipse.com.br
Filial SP Rua dos Pinheiros, 870 - Conj. 141/142 05422-001 So Paulo - SP Fone: (11) 3061-2828 Fax: (11) 3061-2828 E-mail: elipse-sp@elipse.com.br
Filial PR Av. Sete de Setembro, 4698/1705 80240-000 Curitiba - PR Fone: (41) 3342-0120 Fax: (41) 3342-0120 E-mail: elipse-pr@elipse.com.br
Filial RJ Praia de Botafogo, 300/525 22250-044 Rio de Janeiro - RJ Fone: (21) 2158-1015 Fax: (21) 2158-1099 E-mail: elipse-rj@elipse.com.br
USA 40190 Jarvis Gray Lane Avon - NC - USA 27915 Fone: +1 (252) 995-6885 Fax: +1 (252) 995-5686 E-mail: info@elipse-software.com
Alemanha D-67714 Waldfischbach Deutschland Fone: +49 (0) 6333-4439 Fax: +49 (0) 6333-2790045 E-mail: elipse@elipse.de
Taiwan 9F., N.12, Beiping 2nd St., Sanmin Dist. 807 Kaohsiung City - Taiwan Fone: +886 (7) 323-8468 Fax: +886 (7) 323-9656 E-mail: evan@elipse.com.br