Manual do Usurio do E3

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 Descrio Geral

O E3 pode ser executado nas plataformas Microsoft Windows XP SP3, XP x64 SP2, Server 2003 SP2, Vista SP2, Server 2008 SP2, Server 2008 R2 SP1 e Windows 7 SP1, utilizando alguns recursos disponveis nesses sistemas operacionais. A interface grfica com o usurio pode tambm ser executada atravs da Internet ou intranet via Internet Explorer. As funes bsicas do software esto divididas em mdulos independentes, capazes de processar atividades especficas. O gerenciamento do trfego de informaes entre os mdulos coordenado por um mdulo principal (E3 Admin), utilizando a tecnologia de objetos distribudos, permitindo que os componentes possam ser executados tanto na mesma mquina quanto em outros computadores. Em linhas gerais, o E3 composto de um ncleo (kernel ) responsvel por unir e coordenar o trabalho de vrios outros mdulos, que tambm so servidores de informaes. A partir da so geradas as interfaces grficas com o usurio, disponveis atravs dos clientes, tanto locais como pela Internet. O E3 possui quatro programas principais, descritos a seguir.

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.

1.3 Diagrama de Blocos

A arquitetura interna do E3 totalmente escalvel, com cada tarefa principal sendo executada por um servio separado. O diagrama a seguir mostra uma viso geral dos principais blocos.

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

1.4 Estrutura de Domnio

Cada grupo de servidores composto por um E3 Server operando isoladamente ou dois E3 Servers em configurao de hot-standby. Cada Viewer, de fato, se conecta a um Domnio ao invs de somente a um servidor. Depois da conexo, servidor e cliente trocam informaes e verificam a existncia de objetos do sistema registrados e atualizados na mquina cliente. Caso negativo, o servidor carrega as definies dos objetos, como bibliotecas do usurio, conforme a necessidade para abrir cada uma das telas. Do ponto de vista do cliente, o download comea na primeira tela (interface grfica), incluindo quaisquer objetos internos que sero salvos em um diretrio de cache. Esse processo pode levar alguns segundos, dependendo da aplicao, mas traz mais benefcios na prxima vez que se entra na mesma tela, pois o Viewer realiza um cache em disco e em memria. Se o programa Viewer no for fechado, a partir da segunda vez que uma tela for aberta (e no for reconfigurada) ela j estar criada em memria, reduzindo, portanto, o tempo de paginao. Se a tela for modificada, o Viewer dever fazer um novo download, reiniciando o processo. Depois de abrir uma tela, o servidor e o cliente trocam somente dados em tempo real e consultas ao Banco de Dados num sistema de mensagens TCP/IP, com um alto desempenho se comparado ao Terminal Service, dependendo da aplicao. Isso possvel porque enquanto o E3 Viewer recebe e envia apenas valores e dados em tempo real, um cliente Terminal Service envia mensagens de teclado e mouse, e recebe imagens, o que gera um trfego muito maior de informaes. Um Viewer conectado a um Domnio isolado pode obter informaes residentes somente dentro do servidor ativo, de acordo com os direitos de acesso do usurio.

1.5 Limitaes do Modo Demonstrao

Sem a utilizao de uma licena, o E3 pode ser executado em modo Demonstrao (ou Demo), o que til para avaliao do software. Nesse caso, as seguintes limitaes se aplicam: Permite salvar projetos com at 20 Tags de Comunicao No permite trabalhar com servidores em modo Hot-Standby No permite trabalhar com Domnios Remotos S permitida a comunicao com um Driver de Comunicao de nvel 0 (zero), sem limite de Tags. Drivers com nvel maior do que 0 (zero) no so permitidos No h acesso s configuraes do Domnio (menu contextual Domnio - Opes do cone do E3 Admin na rea de Notificaes do Windows) Somente a primeira imagem de cada categoria da Galeria de Smbolos est disponvel S permitida a abertura de um Viewer ou WebViewer

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.

2.1 Iniciando um Projeto

Quando o E3 Studio iniciado, abre-se uma caixa de dilogo com algumas opes do projeto:

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.

Abrir um Domnio existente

2.2 rea de Trabalho

O E3 Studio j vem com uma srie de menus e de barras de ferramentas configurados, que so mostrados ao execut-lo pela primeira vez. Ao utilizar uma interface grfica mais moderna, similar a programas como o Microsoft Office, os menus e as barras de ferramentas podem ser modificados pelo usurio. Quando no existe uma aplicao aberta, a tela apresenta menos opes habilitadas na barra de menu e na barra de ferramentas, mas sua aparncia permanece a mesma. A figura a seguir mostra a aparncia do E3 Studio aps a criao de um E3 Studio 15

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.

2.3 Configurao do E3 Studio

O E3 permite personalizar alguns recursos do E3 Studio, tais como barra de ferramentas, teclado, menus, mouse, etc.

2.3.1 Aparncia do E3 Studio

Para personalizar a aparncia do E3 Studio, necessrio clicar no menu Visualizar Personalizar. As opes disponveis deste item so as seguintes: Aba Comandos: Atravs desta aba, pode-se definir os cones de cada uma das barras de ferramentas. Para tanto, basta clicar sobre o cone na lista Comandos e arrast-lo para dentro da barra de ferramentas desejada

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

Boto Restaurar tudo

Boto Nova Boto Mudar o nome

Boto Remover Mostrar legendas

Aba Menu: Atravs desta aba, possvel configurar os menus do E3

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

Animao dos menus

Menus com sombra

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.

Incluir teclas de atalho

cones grandes

2.3.2 Outras Configuraes

Pode-se configurar o Editor de Scripts do E3, bem como outras opes dos arquivos do Domnio, atravs do menu Ferramentas - Opes, onde tem-se acesso seguinte janela de configuraes: Aba Editor: Este item destinado configurao do Editor de Scripts do E3

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.

Arquivos: Habilita ou desabilita a opo Ignorar verificao de CRC

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.

Abrir a Janela de Propriedades

24

E3 Studio

2.4 Barra de Ferramentas

A Barra de Ferramentas do E3 muda conforme a existncia de uma aplicao aberta ou no. Os botes da barra de ferramentas permitem a execuo de determinadas tarefas rapidamente, sem utilizar os menus. Dessa forma, pode-se criar Objetos de Tela ou abrir o Organizer simplesmente pressionando um boto. A tabela abaixo mostra as opes disponveis nas diversas barras de ferramentas do E3 Studio: Opes disponveis na barra de ferramentas Padro CONE Novo Abrir projeto Salvar Salvar tudo COMANDO AO Cria um novo projeto. Abre um projeto existente. Salva o projeto. Salva todo o Domnio. Remove a informao selecionada e a move para a rea de Transferncia. Copia a informao selecionada e a move para a rea de Transferncia. Cola a informao selecionada da rea de Transferncia. Desfaz a ltima ao executada. Refaz a ltima ao desfeita pelo item Desfazer. Mostra ou esconde o Organizer. Mostra ou esconde a Galeria. Mostra ou esconde a Lista de Propriedades. Mostra o objeto na view do objeto, se este estiver selecionado no Organizer.

Recortar

Copiar

Colar

Desfazer

Refazer

Organizer Galeria Lista de Propriedades

Mostrar no Editor

E3 Studio

25

CONE

COMANDO Mostrar no Organizer

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

Rodar/Parar Domnio Executar/Parar E3 Viewer Verificar Domnio

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

COMANDO Sombra esquerda

AO Desloca a sombra para a esquerda do objeto. Desloca a sombra para a direita do objeto. Seleciona a cor da sombra.

Sombra direita 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.

Ordem dos tabs

Editar pontos de conexo

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

Animar com Translao

Animar com Rotao

Trazer para frente

Enviar para trs

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

COMANDO Cor da borda

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

COMANDO Espelhar verticalmente Grade

AO Aplica uma reflexo vertical no objeto selecionado. Mostra ou esconde a grade.

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

2.4.1 Verificar Domnio

Verifica erros de configurao em todo o Domnio, como objetos com o mesmo nome, Associaes ilegais, etc. Em caso afirmativo, o E3 Studio mostra uma caixa de dilogo com os erros encontrados no Domnio.

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

2.4.2 Procurar e Substituir

A ferramenta Procurar busca no Domnio (inteiro ou em parte), por ocorrncias de um determinado texto. No final da busca, apresentado ao usurio uma lista de resultados, indicando o objeto onde a ocorrncia foi encontrada, a localizao dentro deste objeto (se uma propriedade, Associao, etc.), e o texto que contm a ocorrncia. A ferramenta Substituir substitui as ocorrncias encontradas por outro texto especificado.

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.

Diferenciar maisculas de minsculas

E3 Studio

33

OPO Palavras inteiras

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

Boto Substituir Uma a uma

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

2.4.3 Documentao de Scripts

A ferramenta Documentao de Scripts serve para auxiliar o usurio na organizao e documentao dos scripts da aplicao. Essa ferramenta pode ser acessada de duas maneiras: Atravs do cone da barra de ferramentas Padro. Utilizando esta opo, sero gravados no arquivo todos os scripts do Domnio Clicando com o boto direito do mouse sobre o nome do projeto ou objeto e selecionando a opo Documentar scripts. Utilizando esta opo, apenas os scripts do objeto selecionado e de seus filhos sero gravados no arquivo

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

Detalhamento do arquivo Por exemplo, o script a seguir:

Sub TelaInicial_KeyDown(KeyCode, Shift) If (KeyCode = 27) Then Application.Exit End Sub

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

2.4.4 Relatrio de Verses

A ferramenta Relatrio de verses permite a visualizao das verses e comentrios dos projetos e das bibliotecas abertos, pertencentes ou no ao Domnio. Para acessar essa ferramenta, basta clicar no boto seguinte ser mostrada. da barra de ferramentas Padro, que a caixa de dilogo

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.

Qualidade Estampa de tempo

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.

Nova Pasta Inserir

Inserir Recurso Habilitar/Desabilitar projeto

Adicionar/Remover do Domnio

Procurar/Substituir

Importar/Exportar

Documentar Scripts

Verificar

46

E3 Studio

OPO Editar Associaes

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.

Carregar Todos os Objetos

Fechar Todos os Objetos

Salvar Todos os Objetos Novo Arquivo de Aplicao (.prj)

Nova Biblioteca de Objetos (.lib)

Registrar bibliotecas carregadas

E3 Studio

47

OPO Abrir Todos os Arquivos

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).

Fechar Todos os Arquivos

Editar a Ordem de Ativao

Ordem de Ativao do Domnio

2.6 Importao e Exportao

A ferramenta de importao de objetos do E3 tem como objetivo ler as informaes sobre os objetos de um arquivo CSV (Comma Separated Values) e recri-los no ambiente de configurao (E3 Studio). Para cada objeto possvel obter informaes sobre propriedades, Associaes e itens de colees. A ferramenta de exportao de objetos do E3 tem como objetivo gravar informaes sobre os objetos escolhidos a partir do ambiente de configurao (E3 Studio) em um arquivo CSV. Para 48 E3 Studio

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.

2.6.1 Arquivo CSV

Um arquivo CSV (Comma Separated Values) um arquivo texto baseado em colunas separadas por vrgula, ou por outro separador previamente definido. No E3, eles contm as informaes sobre os objetos que foram exportados, e so utilizados na importao para que esses objetos sejam criados corretamente no E3 Studio. Cada coluna do arquivo CSV representa uma ou mais propriedades de objetos do E3. Cada linha do arquivo representa um objeto, Associao ou item de coleo. Para que esses arquivos sejam utilizados corretamente, preciso observar alguns detalhes: A primeira linha do arquivo CSV deve conter um cabealho que identifica as colunas corretamente O cabealho deve ter obrigatoriamente uma coluna que identifica o tipo do objeto que est sendo importado ou exportado. Esta coluna chama-se ObjectType . O valor desta coluna o nome da classe do objeto (XObject1 , DrawRect , InternalTag , AgSimple , etc.), com exceo das colees, que apresentam palavras-chave pr-definidas ( ITableBindRow , IAxis , etc.) O cabealho das demais colunas deve ser o prprio nome da propriedade em questo E3 Studio 49

 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

2.6.1.1 Criando um Arquivo CSV Manualmente

possvel criar um arquivo com extenso .csv a partir do Bloco de Notas, do Excel ou de outro aplicativo do Windows. O arquivo ser criado considerando o separador de elementos configurado no Windows (na configurao por usurio, no do sistema). A primeira linha do arquivo deve conter um cabealho com os nomes das colunas desejadas. Cada coluna dever ser uma propriedade ou um identificador definido no modelo, conforme ser visto a seguir. Nas linhas devero ser colocados os objetos, e os valores das propriedades nas colunas correspondentes. No necessrio que todas as propriedades dos objetos sejam listadas no cabealho, bem como podem existir colunas que no estejam associadas a propriedades de um determinado objeto. importante tambm que o arquivo CSV tenha uma coluna para a propriedade Name . Sem ela, no possvel determinar exatamente onde o objeto em questo deve ser criado. Os nomes mostram a hierarquia correta do objeto, e nomes com caracteres especiais devem ser delimitados por colchetes. A seguir, um exemplo de um arquivo CSV que pode ser criado manualmente no Excel. 1. Abra o Excel e configure o cabealho com os campos, um em cada coluna, conforme a figura a seguir.

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

2.6.2 Importao e Exportao de Objetos

A importao ou a exportao de objetos no E3 pode ser feita a partir de qualquer tipo de objeto, exceto projetos e bibliotecas. A operao a partir do objeto raiz feita sobre suas propriedades e seus objetos filhos. Para exportar objetos, siga esses procedimentos: 1. Clique com o boto direito do mouse sobre o objeto desejado e selecione a opo Exportar. 2. Na caixa de dilogo, selecione o arquivo CSV desejado e clique no boto Salvar.

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

Um exemplo de arquivo INI mostrado a seguir:

; Primeira seo [SECAO1] Var1 = 0 Var2 = 1 ; Segunda seo [SECAO2] Var1 = TRUE Var3 = FALSE

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.

2.6.4 Gerenciador de Modelos

O Gerenciador de Modelos uma ferramenta para auxiliar o usurio na criao de um arquivo INI para ser utilizado na importao ou exportao de objetos do E3. Para acess-lo, basta clicar na opo Importar/Exportar e, uma vez aberta a janela da opo, clicar no boto Configurar. Caso o usurio j tenha carregado um modelo, os valores iniciais das opes nas abas da janela estaro de acordo com o que foi previamente configurado. As abas disponveis so: Configuraes: Atravs desta aba, o usurio pode configurar as opes vlidas tanto para a importao quanto para a exportao

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

OPO Outras opes

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

OPO Importao de associaes duplicadas

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.

Importao de colees duplicadas

Importao de itens de coleo duplicados

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

Incluir apenas estes objetos

Excluir apenas estes objetos

Boto Alterar

Boto E3 Studio

O boto Alterar abre a seguinte janela para a escolha de classes:

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.

Boto Boto Boto

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

Aba Propriedades As opes disponveis so as seguintes:

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

, a seguinte janela aberta para a seleo de propriedades:

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.

Boto Listar todas as classes de objetos do E3

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.

Propriedades do Tipo Font

2.6.5 Importao de Objetos do Elipse SCADA para o E3

A partir da verso 2.29 do Elipse SCADA foram desenvolvidas funcionalidades que facilitam a exportao de Tags, alarmes e alguns objetos de Tela do Elipse SCADA, e a importao destes no E3 3.0.

2.6.5.1 Importao de Tags de Comunicao (PLC e Bloco)

Os Tags de Comunicao do Elipse SCADA so exportados separadamente para cada Driver. Para fazer a exportao, abra a aplicao no Elipse SCADA e siga estes procedimentos: 1. No Organizer do Elipse SCADA, abra a pasta de Drivers e clique sobre o Driver desejado. 2. Clique no boto Exportar.

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

2.6.5.2 Importao de Tags RAM e Demo

Para exportar os Tags RAM e Demo, siga estes passos: 1. No Organizer do Elipse SCADA, clique na pasta Tags. 2. Clique no boto Exportar.

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

2.6.5.3 Importao da Configurao e Tags de Servidores OPC

1. No Organizer do Elipse SCADA, abra a pasta OPCServers e clique sobre o Driver OPC desejado. 2. Clique no boto Exportar.

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.

2.6.5.4 Importao da Configurao de Alarmes

A exportao da Configurao de Alarmes feita automaticamente ao exportar os Tags, seguindo os passos descritos anteriormente. Alm do arquivo com os Tags gerado um arquivo com o mesmo nome acrescido do sufixo _Alarms. Por exemplo, se o nome escolhido foi TagsInternos , so gerados os arquivos TagsInternos.e2f e TagsInternos_Alarms.e2f. Este segundo arquivo com o prefixo _Alarms contm a configurao dos alarmes dos Tags exportados. Para importar esses alarmes no E3, siga esses passos: 1. No Organizer do E3, insira uma nova Configurao de Alarmes, e insira uma rea. 2. Clique com o boto direito do mouse na rea e selecione a opo Importar. 3. Se a importao foi realizada com sucesso, os alarmes devero aparecer sem nenhuma mensagem de erro. Caso os Tags correspondentes j tenham sido importados, todas as referncias devero aparecer na cor azul.

2.6.5.5 Importao de Telas

A exportao de Telas do Elipse SCADA parcial e suporta apenas um subconjunto dos objetos de Tela. Para exportar uma Tela, siga esses passos: 1. No Organizer do Elipse SCADA, abra a pasta Telas e clique sobre a Tela desejada. 2. Clique no boto Exportar.

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.

2.6.6 Importao e Exportao de Associaes

Para a importao ou a exportao de Associaes no E3, deve ser selecionada a opo correspondente no modelo. No h como excluir apenas um ou outro tipo de Associao: ou todas so importadas ou exportadas, ou nenhuma. Cada Associao ocupa uma linha no arquivo CSV. A identificao das Associaes feita atravs das seguintes palavras-chave: AgSimple : para Associaes Simples, Bidirecionais ou Reversas (essas devero ser diferenciadas pelas propriedades Reverse e Bidirectional) AnalogBind: para Associaes Analgicas AnimationBind: para Associaes Digitais TableBind: para Associaes por Tabela

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

2.6.7 Importao e Exportao de Colees e seus Itens

Para a importao ou a exportao de colees no E3, deve ser selecionada a opo correspondente no modelo. No h como excluir apenas uma ou outra coleo: ou todas so importadas ou exportadas, ou nenhuma. As colunas de cada coleo dependem das propriedades que essa coleo possui. O tratamento feito da mesma forma que nas colunas das propriedades dos objetos. No caso de colees e itens de coleo, as propriedades precisam ser includas no arquivo INI manualmente. No possvel selecionar essas propriedades atravs do configurador de modelos. As colees podem ser importadas e suas propriedades, atualizadas. Como as colees sempre existem, e no possvel criar outra coleo do mesmo tipo, o usurio questionado se deseja ignorar ou sobrescrever a coleo existente. Se o item de coleo que est sendo importado j existir, o usurio questionado se deseja ignor-lo, sobrescrev-lo ou criar um novo. Caso o usurio selecione essa ltima opo: No caso de Penas e Eixos, o nome ser auto-incrementado corretamente No caso de linhas da Associao por Tabela, elas sero criadas sempre ao final desta No caso de colunas da Legenda, ser mostrada uma mensagem de erro informando que o nome no vlido, ou que j existe a coluna e o nome no pode ser auto-incrementado (as colunas da Legenda tm nomes pr-definidos e no possvel criar colunas com outros nomes)

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

2.6.8 Logs e Relatrios de Falhas

Durante o processo de importao ou exportao, gerado um arquivo de log contendo os erros ocorridos e algumas outras consideraes relevantes, caso a seo de log ImportExport esteja habilitada. Para habilitar esta seo, consulte o captulo Configuraes Avanadas. Ao final da operao, h uma opo para visualizar um relatrio de falhas na importao. Neste relatrio constam falhas que provavelmente so erros no arquivo CSV, como objeto inexistente, entre outras.

Relatrio de falhas na importao

2.7 Lista de Propriedades

A Lista de Propriedades uma janela de configurao das propriedades do objeto selecionado. O ttulo da Lista de Propriedades mostra sempre o nome do objeto selecionado no momento. Para que esta caixa esteja visvel no projeto, necessrio que a opo Lista de Propriedades esteja marcada no menu Visualizar.

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

Cada uma destas maneiras ser abordada nos tpicos seguintes.

2.9.1 Acessando o AppBrowser a partir de um Script

Para utilizar o AppBrowser a partir de um script, basta abrir a view de scripts desejada e clicar no boto da barra de ferramentas de scripts. Neste modo, os objetos esto separados conforme a figura a seguir.

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.

2.9.2 Acessando o AppBrowser a partir de uma Associao

Para acessar o AppBrowser a partir de uma Associao, basta abrir a Janela de Propriedades, selecionar a aba Associaes, logo aps a propriedade desejada, e finalmente clicar no boto que aparece direita. O AppBrowser aberto e os objetos so apresentados conforme a figura a seguir.

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.

2.9.3 Acessando o AppBrowser a partir de uma Propriedade

Algumas propriedades permitem o uso do AppBrowser para auxiliar no preenchimento correto do valor esperado. Estas propriedades, quando selecionadas, mostram um boto direita do campo Valor da Lista de Propriedades. Ao clicar nesse boto o AppBrowser chamado, mostrando apenas os objetos que podem ser usados como valor da propriedade selecionada. As propriedades e mtodos destes objetos so omitidos. o caso, por exemplo, da propriedade DBServer do objeto Frmula. O AppBrowser mostra apenas os objetos do tipo Banco de Dados existentes na aplicao.

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.

Pegar licena no servidor de Domnio atual Usar licena de um servidor especfico

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.

3.7 Componentes do Domnio

Um Domnio constitudo dos arquivos descritos nas sees seguintes.

3.7.1 Arquivo de Configurao do Domnio

O arquivo .dom armazena quatro tipos de informaes: Opes de configurao do Domnio Lista de arquivos .prj e .lib que contm os Tags, Telas, definies de objetos, etc. Configuraes dos servidores (computadores) que iro rodar o Domnio Configuraes de usurios e permisses de acesso

3.7.2 Arquivo de Projeto

Um Domnio pode ter um ou mais arquivos de projeto. Cada arquivo .prj contm definies de objetos, Tags, Telas, Histricos, Alarmes, bitmaps, etc. A organizao dos objetos dentro de um arquivo .prj livre; podem ser criados diversos nveis de Pastas dentro do projeto, e cada Pasta pode conter qualquer tipo de objeto. O usurio pode dividir os objetos de um sistema de superviso em um ou mais arquivos .prj, dependendo das suas necessidades. Em tempo de execuo, cada projeto pode ser ativado, independente dos outros, inclusive em servidores diferentes.

90

Domnios

3.7.3 Arquivo de Biblioteca

Os arquivos .lib contm definies de objetos criados pelo usurio (ElipseX), que podem ser utilizados nos arquivos de projeto.

3.8 Criando um Domnio

Existem duas maneiras de se criar um Domnio no E3: Atravs do menu Arquivo - Novo Domnio. Para isso, necessrio que ao menos um projeto ou uma biblioteca esteja aberto. Ao selecionar esta opo, o E3 abre uma caixa de dilogo para a escolha do caminho e do nome do novo Domnio

Criando um novo Domnio A seguir, o usurio deve decidir se deseja incluir projetos ou bibliotecas abertos no novo Domnio criado.

Confirmao de insero do projeto ou biblioteca no novo Domnio

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

3.8.1 Assistente de Aplicaes do E3

O Assistente de Aplicaes do E3 a ferramenta utilizada para criar um novo Domnio com um projeto ou uma biblioteca. Esta opo pode ser acessada das seguintes maneiras: Atravs do boto Novo , na barra de ferramentas Padro

Atravs do menu Arquivo - Novo Projeto

Uma vez que o Assistente tenha sido acessado, a tela inicial aberta. Para continuar, clique em Avanar.

Tela inicial do Assistente de Aplicaes do E3

3.8.1.1 Tipo de Aplicao

Nesta tela, pode-se escolher entre a criao de uma Aplicao padro, uma Biblioteca de componentes do E3 ou uma Aplicao em branco. Uma Aplicao padro aquela cujo projeto possui pelo menos um objeto Viewer, uma Tela e um Servidor de Dados, tendo ainda a opo de inserir, com a ajuda do Assistente, um Driver de Comunicao, um Banco de Dados, um Servidor de Alarmes e uma Configurao de Alarmes.

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.

Aviso de pasta inexistente Clique no boto Avanar para prosseguir. Domnios 93

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.

Tela Domnio Clique no boto Avanar para prosseguir.

3.8.1.3 Resoluo do Viewer

Nesta tela, o usurio pode configurar as propriedades do Viewer que definem a resoluo de trabalho para a aplicao sendo criada, ou seja, a resoluo do computador que ir executar a aplicao. Assim, as Telas que forem criadas podero ter seus tamanhos definidos de forma que se ajustem janela do Viewer sem a necessidade de barras de rolagem. A opo Resoluo da tela permite escolher dentre uma srie de resolues pr-definidas; j a opo Avanado permite informar um valor personalizado.

94

Domnios

Tela Resoluo do Viewer Clique no boto Avanar para prosseguir.

Domnios

95

3.8.1.4 Driver de Comunicao

Nesta tela, o usurio pode decidir pela incluso de um objeto Driver de Comunicao no projeto sendo criado. Caso positivo, possvel configurar o arquivo .dll que este Driver utiliza, na opo Arquivo do driver de comunicao. Para procurar o arquivo, utilize o boto .

Tela Driver de Comunicao Clique no boto Avanar para prosseguir.

96

Domnios

3.8.1.5 Banco de Dados

Nesta tela, o usurio pode decidir pela incluso de um objeto Banco de Dados no projeto sendo criado. Caso positivo, possvel configurar o arquivo .mdb que este Banco de Dados utiliza, na opo Nome do arquivo de banco de dados Access. Para procurar o arquivo, utilize o boto .

Tela Banco de Dados Clique no boto Avanar para prosseguir.

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

Tela final do Assistente de Aplicaes do E3 Finalize o processo clicando no boto Concluir.

3.9 Configuraes de Domnio

Atravs do menu do E3 Admin na rea de Notificaes do Windows, possvel executar, parar, atualizar ou fechar o Domnio diretamente atravs das opes Executar, Parar, Atualizar e Fechar, respectivamente. Alm disso, o Domnio tambm pode ser configurado para apresentar redundncia e utilizar Domnios Remotos, entre outras aes. Essas configuraes so feitas atravs da opo Domnio - Opes.

Opes de configurao via rea de Notificaes do Windows

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

OPO Servidor principal

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

Endereos para PING de integridade da rede

Ativar backup em caso de falha local

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

OPO Tempo para ativao do servidor reserva

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

Perfil de pr-ativao do servidor reserva

102

Domnios

OPO Pr-ativar os seguintes servios

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

A senha expira aps ... dias

A senha deve conter no mnimo ... caracteres

A senha deve conter letras e nmeros

A senha deve conter no mnimo ... nmeros

Domnios

OPO A senha deve conter no mnimo ... letras

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.

Validar senhas sem diferenciar maisculas e minsculas

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.

3.9.3 Grupos de Viewers

possvel especificar, de acordo com o IP do Viewer, se este pode se conectar, e com qual tipo de licena (Viewer Full ou Viewer Only). Com este recurso possvel bloquear totalmente a conexo, ou limitar a quantidade e o tipo de licenas que sero usadas simultaneamente para um determinado grupo de IPs. Para acessar os grupos de Viewers, clique com o boto direito do mouse no cone do E3 na rea de Notificaes do Windows, selecione a opo Domnio - Opes, e acesse a aba Grupos 106 Domnios

de Viewers. A seguinte janela ser mostrada:

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.

Adicionar / Remover Nome do grupo

Domnios

107

OPO Lista de IPs

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.

Adicionar / Editar / Remover

Permitir conexes de Viewer Full

Limitar uso de licenas simultneas

Permitir conexes de Viewer Only

Limitar uso de licenas simultneas

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

3.9.4 Registro de Eventos

Os eventos dividem-se em duas categorias: Eventos Padro do Sistema e Eventos Manuais. Eventos Padro do Sistema so os eventos gerados automaticamente pelo E3, e que podem ter o registro habilitado ou desabilitado individualmente: Login ou Logout de usurio Troca de senha de usurio Falha de login de usurio Alterao na base de dados de usurio Bloqueio de conta de usurio Incio ou trmino do Domnio Alterao no Domnio (inserir, remover, habilitar ou desabilitar projetos e bibliotecas, alterar a configurao do Domnio) Atualizao do Domnio (quando o usurio aplica as alteraes feitas em projetos, atravs do E3 Studio) Troca manual de servidor Hot-Standby

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

Usar este Banco de Dados

Domnios

OPO Nome da tabela

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)

Marque abaixo os eventos que devem ser registrados

Lista os eventos disponveis no sistema, para serem registrados.

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

Por exemplo, se a mensagem do evento Falha de Login for alterada para:

"Falhou login do usurio %USER% no computador %MACHINE% (usando um %SESSION%): %CAUSE %"

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"

Os eventos padro do sistema so descritos nas sees seguintes.

3.9.4.1 Login de Usurio

Usurio %User% logou no %SESSION% na mquina %MACHINE% Gerado sempre que ocorrer um login bem sucedido de um usurio no E3 Studio ou no Viewer, onde: %USER% contm o nome de login do usurio %SESSION% contm "Viewer" ou "E3 Studio" %MACHINE% contm o nome do computador onde o usurio est logado

3.9.4.2 Logout de Usurio

Usurio %User% terminou a sesso de uso de %SESSION% na mquina %MACHINE% Gerado sempre que ocorrer o logout de um usurio no E3 Studio ou no Viewer (ou quando o programa fechado sem logout. Neste caso, o logout automtico), onde: %USER% contm o nome de login do usurio %SESSION% contm "Viewer" ou "E3 Studio" %MACHINE% contm o nome do computador onde o usurio estava logado

114

Domnios

3.9.4.3 Troca de Senha

A senha do usurio %USER% foi alterada Gerado sempre que a senha de um usurio for trocada (chamando o mtodo ChangePassword no Viewer), onde: %USER% contm o nome de login do usurio que teve a senha trocada

3.9.4.4 Falha de Login

O login do usurio %USER% no %SESSION% na mquina %MACHINE% falhou: %CAUSE% Gerado sempre que falhar o login de um usurio no Viewer ou no E3 Studio, onde: %USER% contm o nome de login informado %SESSION% contm "Viewer" ou "E3 Studio" %MACHINE% contm o nome do computador onde o usurio tentou logar %CAUSE% pode ser login ou senha incorretos, conta desabilitada, conta bloqueada, senha expirada ou erro 0xnnnnnnn

3.9.4.5 Base de Usurios Alterada

Usurio %USER% alterou a base de usurios Gerado sempre que a base de usurios for alterada (normalmente atravs da opo Arquivos - Usurio do E3 Studio), onde: %USER% contm o nome de login do usurio que editou a base de usurios (ou "Annimo" se no havia nenhum usurio logado)

3.9.4.6 Conta Bloqueada

A conta do usurio %USER% foi bloqueada Gerado sempre que a conta de um usurio bloqueada por excesso de logins errados, onde: %USER% contm o nome de login do usurio que teve a conta bloqueada

Domnios

115

3.9.4.7 Domnio Iniciado

Domnio iniciado pelo usurio %USER% no %SESSION% na mquina %MACHINE% Gerado sempre que o Domnio iniciado (colocado em execuo), onde: %USER% contm o nome de login do usurio que colocou o Domnio em execuo (ou "Annimo" se no foi pedida autenticao quando o Domnio foi executado) %SESSION% contm "E3 Studio" ou "E3 Server" (menu da rea de Notificaes do Windows) %MACHINE% contm o nome do computador onde foi gerado o comando para executar o Domnio

3.9.4.8 Domnio Finalizado

Domnio finalizado pelo usurio %USER% no %SESSION% na mquina %MACHINE% Gerado sempre que o Domnio parado, onde: %USER% contm o nome de login do usurio que parou o Domnio (ou "Annimo", se no foi pedida autenticao quando o Domnio foi parado) %SESSION% contm "E3 Studio" ou "E3 Server" (menu da rea de Notificaes do Windows) %MACHINE% contm o nome do computador onde foi gerado o comando de parar o Domnio

3.9.4.9 Domnio Atualizado

Domnio atualizado pelo usurio %USER% no %SESSION% na mquina %MACHINE% Gerado sempre que o Domnio atualizado pelo boto do E3 Studio, isto , quando so aplicadas no E3Run as alteraes feitas em arquivos PRJ e LIB, onde: %USER% contm o nome de login do usurio logado no E3 Studio (ou "Annimo", se no h nenhum usurio logado) %SESSION% contm "E3 Studio" %MACHINE% contm o nome do computador onde o E3 Studio estava rodando

116

Domnios

3.9.4.10 Domnio Modificado

Domnio modificado pelo usurio %USER% no %SESSION% na mquina %MACHINE%: %CAUSE% Gerado sempre que o arquivo do Domnio (.dom) modificado, onde: %USER% contm o nome do usurio que alterou o Domnio %SESSION% contm "E3 Studio" ou "E3 Server" %MACHINE% contm o nome do computador onde foi gerado o comando de modificar o Domnio %CAUSE% pode ser: Aplicadas alteraes na janela do computador de edio do Domnio Adicionado projeto "nomedoprojeto" (habilitado) Adicionado projeto "nomedoprojeto" (desabilitado) Removido projeto "nomedoprojeto" Desabilitado projeto "nomedoprojeto"

3.9.4.11 Troca Manual de Servidores

Servidor reserva ativado pelo usurio '%USER%' no '%SESSION%' na mquina '%MACHINE%' Gerado sempre que forada a ativao do servidor de backup de um Domnio, atravs da opo Servidor - Ativar do menu do E3 Server, onde: %USER% contm o nome de login do usurio que ativou o servidor de backup (ou "Annimo" se no foi pedida autenticao quando o servidor foi ativado) %SESSION% contm "E3 Server" (menu da rea de Notificaes do Windows) %MACHINE% contm o nome do computador onde foi gerado o comando para ativar o servidor de backup

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

OPO Adicionar / Remover

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

Em manuteno (execuo desabilitada)

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

OPO Identificao do servidor na rede

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.

Pasta raiz dos arquivos do Domnio

Em manuteno (execuo desabilitada)

Domnios

121

3.9.7 Domnios Remotos

Permite adicionar, remover ou editar os Domnios Remotos. Use a lista da esquerda para selecionar um ou mais Domnios Remotos a alterar. 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 Domnios Remotos. A seguinte janela ser mostrada:

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

OPO Adicionar / Remover

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

Servidor Principal Servidor de Backup

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 Outras Opes da rea de Notificao

Alm das opes listadas na seo anterior, existem outras configuraes acessadas atravs do menu do E3 Admin na rea de Notificaes do Windows.

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

Domnio Remoto (Servidor)

Domnio Remoto (Cliente)

Pontos E/S Tags do Storage Drivers

Servidor OPC

Tempo mximo de execuo

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.

Dados enviados Compresso no envio

Pacotes enviados Dados recebidos Compresso no recebimento

Pacotes recebidos Conectado desde

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.

Nome Endereo Ping

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

OPO O Domnio configurado

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

3.10.7 Sobre o E3 Admin

Esta opo mostra a verso do E3 Admin.

Domnios

131

3.10.8 Parar ou Iniciar E3 Server

Esta opo para ou inicia o E3 Server. Ao ser acionada a opo Parar E3 Server, pedida a confirmao da operao. Se confirmada, o Domnio parado e fechado, e so desconectados todos os E3 Studios e Viewers (caso existam). O usurio ser notificado que isto indisponibilizar o uso de E3 Studios remotos e do Hot-Standby. Quando o E3 Server estiver parado, ele pode ser reiniciado pela opo Iniciar E3 Server.

3.10.9 Fechar E3 Admin

O E3 Admin pode ser fechado sem precisar fechar o E3 Server, atravs da opo Fechar E3 Admin. Quando isso acontece, o E3 Server continua rodando, mas nenhum cone aparece na rea de Notificaes do Windows. Neste caso, quando o E3 Admin no est aberto, as mensagens de erro aparecem como caixas de mensagens a todos os usurios logados (e ativos) na mquina rodando o E3 Server. A qualquer momento, o E3 Admin pode ser reiniciado para controlar o E3 Server em execuo, bastando para isto iniciar o E3 Admin sem nenhum parmetro. O instalador tambm cria um atalho para abrir o E3 Admin diretamente.

3.11 Domnios Remotos

A configurao de Domnios Remotos define que haver comunicao entre diferentes servidores e Viewers, onde uma aplicao ser destinada a fornecer dados, e a outra a receb-los. O Domnio que fornece dados a outro chamado de Domnio Servidor; j o Domnio que utiliza estes dados chamado de Domnio Cliente . A configurao de um Domnio como Domnio Cliente no impede que ele seja ao mesmo tempo um Domnio Servidor, e vice-versa. Domnios Remotos no esto disponveis em modo Demo.

132

Domnios

3.11.1 Configurao da Conexo

A configurao das conexes com outros Domnios do E3 deve ser feita no Domnio Cliente, atravs da aba Domnios Remotos nas opes do Domnio (rea de Notificaes do Windows).

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

Tempo limite de PING (ms)

134

Domnios

OPO Utilizar heartbeat na conexo

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.

Perodo de heartbeat (ms)

Utilizar criao assncrona de links

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.

3.11.3 Sintaxe dos Links

Com a configurao de Domnios Remotos, o Domnio Cliente poder acessar objetos do Domnio Servidor de duas maneiras: atravs de scripts, utilizando o mtodo Application. GetObject; ou atravs de Links, ou seja, de qualquer funcionalidade que crie uma conexo com outro objeto (expresses de eventos de usurio, propriedades do tipo Objeto de ElipseX, fontes de Associaes, de Alarmes ou de campos de Histricos e Storages, entre outros). Os objetos acessados desta forma podem tanto ser objetos do Viewer quanto do Servidor. O acesso aos objetos de outro Domnio feito atravs do apelido (Nome de Domnio), que deve preceder o caminho completo de cada objeto, separado por dois pontos. Ou seja, para que as fontes de Links ou o comando Application.GetObject referenciem outro Domnio, devese usar a sintaxe DOMINIO:CAMINHO, onde DOMINIO o apelido dado quela conexo com o Domnio Remoto, e CAMINHO o caminho completo de um objeto ou propriedade daquele Domnio. No caso de Links, as fontes podem incluir expresses com referncias a vrios objetos, podendo haver combinaes entre objetos locais e de Domnios Remotos. Por exemplo, Driver1.Tag1 + Remoto:Driver2.Tag1 * 2 . O nome do Domnio Remoto tambm pode necessitar de colchetes, ficando [DOMINIO]: CAMINHO. Neste caso, aplicam-se as mesmas regras de nomes de objetos. Necessita de colchetes o nome do Domnio que: 136 Domnios

 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

3.11.4 Permisses de Acesso

Assim como ocorre com o Viewer, o acesso aos objetos de um Domnio Remoto pode ser limitado ao modo Somente Leitura. Quando isso ocorre, so aplicados os mesmo tipos de limitaes de acesso que se aplicam ao Viewer Only. Porm, diferente do Viewer, nesse caso o controle feito apenas por usurio e no por IP ou por licena. Para isso, usa-se a configurao de usurios na permisso Acesso remoto de escrita ao Domnio, dentro do item de segurana Domnio.

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.6 Gerenciamento da Conexo

Mesmo quando no h configurao de Hot-Standby, existe um controle da conexo de Domnios Remotos entre os E3 Servers Clientes e Servidores. A conexo utiliza o protocolo REC, o mesmo utilizado entre o E3 Server, E3 Viewer e E3 Studio. Assim, a porta de conexo do REC e as possveis configuraes de firewall associadas tambm se aplicam aos Domnios Remotos. Com a conexo estabelecida, espera-se que haja um Domnio rodando. Nesse processo, a conexo refeita sempre que houver algum problema. Aps ser encontrado o Domnio rodando, verifica-se o nome correto do Domnio, bem como o login do usurio (se necessrio). Assim como acontece com as conexes REC do E3 Studio e do E3 Viewer, as estatsticas de comunicao das conexes de Domnios Remotos podem ser visualizadas na janela de Estatsticas do E3 Server, acessveis atravs do cone do E3 Admin na rea de Notificaes do Windows.

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.

3.12 Gerando Logs no E3

O E3 gera logs no formato ETL (Event Trace Log ). Esses arquivos de log so gerenciados por uma ferramenta da Elipse chamada Elipse Event Log Viewer, disponvel com a instalao do E3. Com essa ferramenta possvel visualizar os arquivos e gerenciar o espao que estes ocupam em disco, entre outras configuraes. Para mais informaes sobre a ferramenta Elipse Event Log Viewer, consulte o Manual do Usurio do Elipse Event Log Viewer, disponvel no menu Iniciar - Programas - Elipse Software - Elipse Event Log. O aplicativo Elipse Event Log Viewer pode ser aberto de trs formas: Pelo menu Iniciar - Programas - Elipse Software - Elipse Event Log - Log Viewer Pelo menu Ferramentas - Log Viewer do E3 Studio Pelo item Atalhos - Log Viewer do menu do E3 Admin na rea de Notificao do Windows

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 .

4.1 Driver de Comunicao

O Driver de Comunicao o mdulo do E3 que possibilita a comunicao com um determinado equipamento usando arquivos .dll. Estes drivers so desenvolvidos pela Elipse Software, bem como por terceiros, a partir de um DDK (Driver Development Kit), fornecido pela Elipse, em linguagem C/C++. Cada driver implementa uma famlia de equipamentos ou protocolos diferentes de acordo com o tipo de equipamento ou protocolo de comunicao. Novos drivers so costumeiramente desenvolvidos pela Elipse Software. Para inserir um Driver de Comunicao no projeto, clique com o boto direito do mouse no nome do projeto no Explorer e selecione a opo Inserir - Driver de Comunicao. No modo Domnio, clique com o boto direito do mouse no item Objetos de Servidor - Drivers e OPC, selecione a opo Inserir Driver de Comunicao em e logo aps o nome do projeto desejado.

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

OPO Contagem de tags

CONE

DESCRIO Apresenta o nmero total de Tags de Comunicao no Driver.

4.1.1 Configurao dos Drivers de Comunicao

Para determinar o Driver de Comunicao a ser usado, clique na propriedade DriverLocation, ou clique com o boto direito no Driver e selecione a opo Procurar DLL . Uma caixa de seleo para a determinao do arquivo .dll que contm o Driver ser exibida, conforme a figura a seguir:

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.

4.1.1.1 Teste de Comunicao

Ao configurar um Driver de Comunicao, o usurio pode realizar um procedimento de teste a fim de verificar se os valores esto corretos e sendo atualizados sem problemas. Ao clicar no Driver de Comunicao, aberta a opo Ativar Comunicao. Desta forma, o Driver de Comunicao especificado ser carregado e os valores das variveis podero ser visualizados no campo Valor de cada Tag na view de edio. Caso algum dos Tags Drivers 143

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.

4.1.2 Funcionamento dos Drivers de Comunicao

O IOServer o mdulo do E3 responsvel pela comunicao com o equipamento. no processo do IOServer que carregada a .dll do Driver e efetuada a comunicao com o equipamento. Os Tags de Comunicao possibilitam a leitura ou escrita de um conjunto de valores, utilizando o Driver de Comunicao onde eles esto inseridos. Podem ser utilizados tambm os Blocos de Comunicao para a leitura simultnea de mais de uma varivel. Para acessar cada valor do Bloco utilize o Elemento de Bloco, que pode ser includo dentro do objeto. Estes objetos sero discutidos nas sees seguintes. Em tempo de execuo, o E3 cria um IOServer para cada Driver de Comunicao. Baseado no tempo de varredura (propriedade Scan) de cada Tag, o Driver ir requisitar periodicamente o valor de cada um. Sempre que o valor ou a qualidade do Tag for alterado, seu valor ser repassado para o Driver de Comunicao. A verificao do tempo de ciclo de cada varivel feita de forma sequencial. Caso o ciclo de uma varivel esteja vencido, o IOServer prosseguir com o questionamento de seu valor, passando para a prxima varivel at que a verificao de toda a planilha esteja completa, para ento retornar ao topo para uma nova varredura. Pode-se reservar um tempo de ciclo menor para as variveis com necessidade de atualizao mais veloz, e um tempo de ciclo maior para as variveis sem tanta prioridade de atualizao. Deve-se ressaltar, entretanto, que a performance da comunicao depende de uma srie de fatores, incluindo o tipo de equipamento, o tipo de interface da comunicao utilizada, velocidade (baud rate), taxa de erros, etc. Sempre que o E3 enviar uma solicitao de atribuio de valores para uma ou mais variveis, esta solicitao ser executada com prioridade em relao varredura dos Tags. No caso de falha de um IOServer, o E3 automaticamente realizar uma reinicializao daquele mdulo, de forma a normalizar seu funcionamento. Por outro lado, o IOServer ir interromper seu funcionamento caso no exista nenhum E3 Runtime (Principal ou Standby) para receber seu dados. Atravs da propriedade ShareServer, possvel compartilhar o mesmo IOServer entre vrios Drivers de Comunicao. O primeiro Driver a ser executado ser o responsvel por iniciar os procedimentos de comunicao, como abrir uma porta serial ou iniciar uma interface de comunicao. Os prximos Drivers de Comunicao compartilhados utilizaro o mesmo IOServer aberto pelo primeiro, o que permite o compartilhamento das interfaces de comunicao utilizadas pelo Driver. Isto pode ser vantajoso, j que muitos dos dispositivos de comunicao, como modems, 144 Drivers

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

OPO Erros de leitura

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

Caminho Boto Habilitar Log

Boto Atualizar

4.1.2.1 Utilizao de Estampa de Tempo

Alguns equipamentos e protocolos permitem o envio de informaes de tempo juntamente com os valores das variveis. Os Drivers de Comunicao para tais equipamentos podem, a cada varivel consultada, retornar tambm a informao deste relgio que fica armazenada na propriedade TimeStamp de cada Tag, com resoluo de 1ms. Quando o equipamento no suporta este tipo de informao, ou quando o Driver no est preparado para tal, o Driver de Comunicao insere na estampa de tempo o valor de data e hora atual, a partir do relgio do computador. De posse da estampa de tempo, o E3 ir utilizar esta informao tanto para a verificao e gravao de alarmes quanto para a gerao de arquivos histricos. No caso dos Tags serem Elementos de Bloco, informada a mesma estampa de tempo para todos os Elementos do Bloco, j que foram consultadas no mesmo instante de tempo. No caso do Driver suportar leituras de variveis tanto como Bloco quanto como Tag de Comunicao, caso os Elementos possam representar eventos distintos, deve-se preferir o uso de Tags de Comunicao. 146 Drivers

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.

4.1.2.2 Lista de Valores

Alm do envio da estampa de tempo, os Drivers de Comunicao tambm suportam o envio de listas de valores para os Tags. As listas so uma sequncia de valores para um mesmo Tag de Comunicao ou Bloco de Comunicao, que so informadas numa mesma leitura. Alguns exemplos de utilizao para a lista de valores so a coleta de variaes rpidas de um Tag digital, por exemplo, atravs da utilizao de SOE (Sequence of Events - Sequncia de Eventos ), que esto armazenadas em um equipamento tipo PLC ou RTU (Remote Terminal Unit) ou ainda na leitura de tabelas de dados onde esto armazenados dados de telemetria, como nos exemplos a seguir:

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.

4.1.3 Pasta de Comunicao

Define grupos e subdiretrios de forma a organizar as variveis. Cada Pasta pode ser renomeada conforme a necessidade e novas Pastas podem ser inseridas dentro de outras. Para utilizar este recurso, siga este procedimento: 1. No Organizer, clique com o boto direito do mouse sobre o objeto Driver e selecione a opo Inserir - Nova Pasta. Drivers 147

Inserindo uma nova Pasta

4.1.4 Tag de Comunicao

O Tag de Comunicao possibilita a leitura ou a escrita de um conjunto de valores utilizando o Driver de Comunicao. utilizado para definir a troca de informaes com os equipamentos de aquisio, que consistem em uma nica varivel independente. O Tag de Comunicao pode ser uma varivel analgica, de entrada, de sada, contador, ponto digital, etc. Vrios pontos digitais podem ser agrupados no Tag e serem acessados atravs de suas propriedades, como bits de dados. Os Tags de Comunicao so configurados atravs de uma srie de parmetros N (N1 a N4 ), que variam de acordo com o Driver de Comunicao a ser utilizado. Para utilizar este recurso, siga estes procedimentos: 1. Insira o Tag de Comunicao no projeto, clicando com o boto direito do mouse no Driver e selecionando a opo Inserir - Tag de Comunicao.

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.

Inserindo Tags de Comunicao

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.

4.1.5 Bloco de Comunicao

O Bloco de Comunicao utilizado para definir a troca de informaes com os equipamentos de aquisio, que consistem de uma ou mais variveis, desde que seja consecutivo no endereamento dentro do dispositivo externo. Dependendo do mtodo de comunicao utilizado, podem economizar tempo de comunicao, obtendo um nmero maior de atualizaes num mesmo intervalo de tempo se comparado com o Tag de Comunicao. Os Blocos de Comunicao so configurados atravs de uma srie de parmetros B (B1 a B4 ) que variam de acordo com o Driver de Comunicao a ser utilizado, alm da propriedade Size , que define o nmero de Elementos ou ndices disponveis no Bloco. Para utilizar este recurso, siga estes procedimentos: 1. Clique com o boto direito do mouse no Driver e escolha a opo Inserir - Bloco de Comunicao.

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

Bloco ou somente num 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 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.1.6 Elementos de Bloco

Os Elementos de Bloco representam as associaes de cada uma das posies no Bloco, de forma a serem utilizados como se fossem Tags de Comunicao. Os Elementos de Bloco podem apontar livremente para cada ndice dentro de um Bloco. Podem existir dois Elementos de Bloco apontando para o mesmo ndice do Bloco, e tambm um nmero menor, igual ou maior de Elementos do que o nmero de variveis declaradas no Bloco. Para utilizar este recurso, siga este procedimento: 1. Clique com o boto direito do mouse no Bloco de Comunicao e escolha a opo Inserir Elemento de Comunicao.

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

4.2 Servidor OPC

Alm de possuir um cliente OPC (Driver OPC), o E3 funciona tambm como Servidor OPC DA ( Data Access) 2.0x. Isso permite ao E3 expor todos os objetos existentes no Domnio em execuo (Tags de Comunicao, por exemplo) para softwares externos ao E3. Como exemplos, pode-se citar o Elipse SCADA, o E3 (que pode estar rodando em outra aplicao como cliente), ou um cliente OPC de outro fabricante, basta que o cliente implemente o padro OPC DA 2.0x ou superior.

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.2 Informaes de Status

Atravs da informao de status (funcionalidade padro do OPC), o cliente OPC pode identificar se o servidor do E3 encontra-se sem Domnio, em standby ou rodando normalmente. O status do OPC pode ser: Domnio rodando normalmente : OPC_STATUS_RUNNING Domnio em standby: OPC_STATUS_SUSPENDED Domnio parado ou sem Domnio: OPC_STATUS_NOCONFIG

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

4.3 Driver de Comunicao OPC

O Driver de Comunicao OPC o mdulo responsvel por coletar dados de equipamentos externos atravs da execuo de um Servidor OPC, que pode ser fornecido por qualquer empresa. Os Tags podem ser importados para o Driver OPC dentro do E3 (que neste caso atua como um OPC Client) ou ainda podem ser criados a partir do E3. Para utilizar um Driver OPC, siga estes procedimentos: 1. Clique com o boto direito do mouse sobre o nome do projeto, e selecione a opo Inserir Driver de Comunicao OPC.

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

Selecionar servidor Ativar/desativar comunicao

Importar tags

Informaes sobre o servidor

Contagem de tags

156

Drivers

4.3.1 Configurao dos Drivers OPC

A identificao dos outros objetos pertencentes ao Driver OPC pode ser inserida manualmente, ou ento ser trazida automaticamente do Servidor OPC. Para isso, acesse as propriedades do Driver clicando com o boto direito do mouse, e escolhendo a aba OPC Driver .

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.

Tentar apenas enumerador padro (servio OPCENUM)

Tentar apenas registros no sistema

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

A janela de importao dispe dos seguintes recursos:

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

Mostrar apenas itens com IDs no encontrados no projeto

Projeto corrente

162

Drivers

OPES Servidor OPC

DESCRIO Mostra os tags disponveis no servidor para a importao.

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 .

4.3.2 Grupo de Tags OPC

O objeto Grupo OPC agrupa uma srie de Tags OPC que compartilham os mesmos parmetros de atualizao (tempo de varredura e banda morta). sempre necessrio existir um Grupo OPC para poder criar Tags OPC. Para inserir um Grupo OPC, siga este procedimento: 1. Clique com o boto direto do mouse sobre o Driver OPC e selecione a opo Inserir - Grupo de tags OPC.

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 .

4.3.3 Pasta OPC

O objeto Pasta OPC define grupos ou subdiretrios, de forma a melhor organizar as variveis. Cada Pasta OPC pode ser renomeada conforme a necessidade, e novas Pastas podem ser inseridas dentro de outras. Em tempo de execuo, se a Pasta OPC for desabilitada, todo o contedo ser desativado. Para utilizar este recurso, siga este procedimento: 1. Clique com o boto direito do mouse sobre o Grupo OPC e selecione a opo Inserir - Nova Pasta.

164

Drivers

Inserindo uma Pasta OPC

4.3.4 Tag de Comunicao OPC

O Tag OPC um objeto para leitura ou escrita de valores em um equipamento. A leitura do Tag feita automaticamente pelo Servidor OPC, com tempo de varredura definido no Grupo OPC no qual ele est inserido. Para utilizar este recurso, siga estes procedimentos: 1. Clique com o boto direito do mouse sobre o Grupo OPC e selecione a opo Inserir - Tag de Comunicao OPC.

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

4.3.5 Bloco de Comunicao OPC

O objeto Bloco de Comunicao OPC possibilita a leitura ou escrita de um conjunto de valores. Para fazer uma escrita, deve-se apenas atribuir um novo valor propriedade Value . A leitura do Tag feita automaticamente pelo Servidor OPC com tempo de varredura definido no Grupo OPC. A propriedade Size determina o nmero de Elementos do Tag no servidor. Para utilizar este recurso, siga estes procedimentos: 1. Clique com o boto direito do mouse sobre o Grupo OPC e selecione a opo Inserir - Bloco de Comunicao OPC.

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 .

4.3.6 Elemento de Bloco OPC

O objeto Elemento de Bloco OPC possibilita a leitura ou escrita de um dos Elementos do Bloco OPC onde ele est inserido. O Bloco OPC l uma tabela de dados, e este objeto estar sempre associado posio definida por sua propriedade Index. Por exemplo, um Elemento de Bloco OPC com Index igual a 5 e inserido em um Bloco OPC com tamanho 10, cujos dados lidos sejam os seguintes:

168

Drivers

Tabela 5 ndice 0

12 1

77 2

55 3

1 4

3 5

42 6

20 7

8 8

89 9

Teria sua propriedade Value igual a 3, segundo a tabela acima.

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.

4.4.1 Campo Substatus

O layout deste campo depende do valor do campo Qualidade . Substatus para Qualidade RUIM SUBSTATUS No especfico DESCRIO Sem Limite O valor ruim, mas nenhuma razo especifica conhecida. 0 Baixo 1 LIMITE Alto 2 Constante 3

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

LIMITE Alto 10 Constante 11

Falha de Dispositivo

13

14

15

Falha de Sensor

17

18

19

ltimo valor conhecido

21

22

23

172

Drivers

SUBSTATUS Falha de Comunicao

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

LIMITE Alto 26 Constante 27

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

SUBSTATUS ltimo valor utilizvel

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

LIMITE Alto 70 Constante 71

No utilizado

174

Drivers

SUBSTATUS Sensor impreciso

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

LIMITE Alto 82 Constante 83

Unidade de engenharia excedida

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

LIMITE Alto 90 Constante 91

No utilizado

NOTA : Servidores que no suportam o Substatus devem retornar 0.

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 Forado localmente

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

No utilizado. 220 - 255

NOTA : Servidores que no suportam o Substatus devem retornar 0.

176

Drivers

4.4.2 Campo Limite

O campo Limite vlido independente dos campos Qualidade e Substatus. Em alguns casos, como uma falha de sensor, ele pode prover informao de diagnstico. Campo Limite ESPECIFICAES No Limitado DESCRIO O valor livre para mover-se acima ou abaixo. O valor est limitado em algum valor inferior. O valor est limitado em algum valor superior. O valor uma constante e no pode moverse.

Limite Inferior Limite Superior

Constante

NOTA : Servidores que no suportam Limite devem retornar 0.

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.

Inserindo um 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 .

5.1 Pasta de Dados

A Pasta de Dados define grupos, de forma a organizar as variveis. Caso haja necessidade, novas Pastas podem ser inseridas dentro de outras. Para utilizar este recurso, siga este procedimento: 1. Clique com o boto direito do mouse sobre o Servidor de Dados e selecione a opo Inserir Panel - Pasta de Dados.

178

Servidor de Dados

Inserindo uma Pasta de Dados

5.2 Tag Contador

O Tag Contador um objeto que faz a contagem de tempo (em segundos) at atingir um valor predeterminado, ou que faz uma certa contagem indefinidamente. Para utilizar este recurso, siga estes procedimentos: 1. Clique com o boto direito do mouse sobre o Servidor de Dados e selecione a opo Inserir Panel - Tag Contador.

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

5.3 Tag Demo

O Tag Demo um objeto que gera valores de acordo com a forma de onda, e utilizado para simulao de valores. Permite gerar ondas definidas ou valores aleatrios. Para utilizar este recurso, siga estes procedimentos: 1. Clique com o boto direito do mouse sobre o Servidor de Dados e selecione a opo Inserir Panel - Tag Demo.

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.

5.4 Tag Interno

O Tag Interno um objeto de propsito genrico, utilizado para guardar valores de qualquer tipo, incluindo nmeros, textos e at outros objetos. Para utilizar este objeto, siga estes procedimentos: 1. Clique com o boto direito do mouse sobre o Servidor de Dados e selecione a opo Inserir Panel - Tag Interno.

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

5.5 Tag Timer

O Tag Timer um objeto para contagem de tempo e agendamento de atividades. Ele estabelece horrios (com repeties) para executar aes. Para utilizar este objeto, siga estes procedimentos: 1. Clique com o boto direito do mouse sobre o Servidor de Dados e selecione a opo Inserir Panel - Tag Timer.

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

Telas e Objetos de Tela

Telas so janelas para monitoramento de processos. Em cada Tela so inseridos objetos que faro a interface do operador com o sistema, chamados Objetos de Tela. Cada aplicao pode ter um nmero ilimitado de Telas e de objetos de Tela.

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

Telas e Objetos de Tela

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.

Configurar como Tela inicial do Divisor

Nome Largura Altura

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.

Telas e Objetos de Tela

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 .

6.2 Objetos de Tela

Os seguintes objetos podem ser inseridos em uma Tela: Primitivas do Editor Grfico (Retas, Crculos, Retngulos, Polgonos, etc.) Controles ActiveX fornecidos pela Elipse (E3Alarm, E3Chart, E3Browser) Controles ActiveX fornecidos por terceiros Imagens no vetoriais (Arquivos BMP, JPG, GIF, etc.) Imagens vetoriais (Arquivos WMF, EMF, etc.) 188 Telas e Objetos de Tela

 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.

6.2.2.1 Conectores em XControls

Os Conectores em objetos de Tela criados dentro de XControls devem ter seus pontos de conexo definidos previamente, utilizando o boto da barra de ferramentas Tela. Ao selecionar esta ferramenta e clicar em um ponto de conexo, a seguinte janela aberta:

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

Utilizar como "Ponto ncora" do objeto

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.

6.2.4 Retngulo Arredondado

Permite o desenho de retngulos com cantos arredondados, criados a partir de dois vrtices. Para utilizar este objeto, siga estes procedimentos: 1. Selecione o Retngulo Arredondado 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. 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.

Telas e Objetos de Tela

191

6.2.6 Arco de Elipse

Permite o desenho de objetos do tipo arco, corda ou torta. Para utilizar este objeto, siga estes procedimentos: 1. Selecione o Arco de 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. 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.

6.2.7 Desenho Livre

Permite a criao de desenhos mo livre. Para utilizar este objeto, siga estes procedimentos: 1. Selecione o Desenho Livre na barra de ferramentas Tela.

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.

6.2.9 Polgono de Curvas

Permite o desenho de polgonos com lados curvos. Para utilizar este objeto, siga estes procedimentos: 1. Selecione o Polgono de Curvas na barra de ferramentas Tela.

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.

Telas e Objetos de 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 Configuraes Gerais

As seguintes configuraes podem ser aplicadas Tela ou aos seus objetos.

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 Horizontal

Alinhamento Central Vertical Alinha dois ou mais objetos verticalmente entre si, tendo como referncia o ltimo objeto selecionado.

Telas e Objetos de Tela

195

CONE

OPO Mesma Largura

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

Telas e Objetos de Tela

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:

Propriedades da Grade As opes disponveis so as seguintes:

Telas e Objetos de Tela

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.

Linhas pontilhadas Alinhar mouse automaticamente Comprimento

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).

6.3.4 Ordem de Navegao entre os Objetos

Estabelece a ordem de navegao, atravs da tecla TAB, entre dois ou mais objetos em tempo de execuo (isto , a ordem em que os objetos ganham foco). Para habilitar esta opo, siga estes procedimentos: 1. Selecione a Tela e clique no boto Ordem dos Tabs , na barra de ferramentas Tela.

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

Telas e Objetos de Tela

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.

6.3.5 Agrupar ou Desagrupar

Permite transformar mais de um objeto em apenas um, com propriedades especficas. Para utilizar este recurso, siga estes procedimentos: 1. Selecione na Tela os objetos que devem formar o grupo. 2. Clique no boto Agrupar . Um novo objeto criado. Esta operao pode ser feita em cascata, e um grupo pode conter qualquer objeto, inclusive outros grupos. 3. Para desfazer a unio de um grupo de objetos, selecione a opo Desagrupar .

4. Para editar um objeto contido em um grupo, clique com o boto direito do mouse no objeto e selecione a opo Editar Grupo.

Telas e Objetos de Tela

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.

2. Com o cursor do mouse, habilite as configuraes da orientao do objeto.

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

Telas e Objetos de Tela

Rotao

6.3.7 Sobreposio de Objetos

Permite editar o modo como dois ou mais objetos estaro sobrepostos. As opes disponveis na barra de ferramentos Tela so: Enviar para a Frente : O objeto selecionado enviado para a primeira posio na ordem de sobreposio Enviar para Trs: O objeto selecionado enviado para a ltima posio na ordem de sobreposio Avanar: O objeto selecionado avana uma posio na ordem de sobreposio dos objetos Recuar: O objeto selecionado recua uma posio na ordem de sobreposio dos objetos

Telas e Objetos de Tela

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

Telas e Objetos de Tela

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

Nenhuma camada Editar camadas

Quando a opo Editar camadas selecionada, a seguinte janela mostrada.

Edio de Camadas Telas e Objetos de Tela 203

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

, para a excluso da camada selecionada; e Editar

Ao clicar nos botes

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

Usar condio adicional de visibilidade

Fonte

204

Telas e Objetos de Tela

Para maiores informaes, consulte o Manual de Referncia de Scripts.

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.

6.3.11 Ponto ncora

Um Ponto ncora definido como as coordenadas que marcam o ponto inicial do objeto. Inicialmente, o ponto ncora est atrelado s coordenadas iniciais do objeto. Para habilitar esta opo, clique com o boto direito do mouse sobre o objeto e selecione a opo Definir Ponto ncora. O objeto aparece com o smbolo , de onde pode ser movido para qualquer lugar da Tela. Ao arrastar o objeto com a nova ncora, o ponto que foi definido o que ficar fixado nos pontos da grade, sendo que o objeto ficar deslocado nas mesmas propores em relao ncora. Isto s visualizado se a opo Alinhar Mouse Automaticamente (propriedade da Grade) estiver habilitada.

Telas e Objetos de Tela

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:

Telas e Objetos de Tela

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

Telas e Objetos de Tela

6.3.14 Configurar como Padro

Configura as opes editadas nas barras de ferramentas Sombra e Desenho como padro para os demais objetos de Tela que forem sendo criados. Para utilizar este recurso, siga estes procedimentos: 1. Selecione o objeto que servir como modelo para os demais. 2. Clique com o boto direito do mouse e selecione a opo Configurar como Padro. 3. Ao criar um novo objeto de Tela, as configuraes de Sombra e Desenho deste objeto sero utilizadas como configuraes iniciais dos prximos objetos.

6.3.15 Aplicar Estilo

Aplica o estilo configurado como padro na opo Configurar como Padro a objetos previamente criados. Para utilizar este recurso, siga estes procedimentos: 1. Selecione o objeto ao qual o padro deve ser aplicado. 2. Clique com o boto direito do mouse e selecione a opo Aplicar Estilo.

6.4 Formatao de Cores

Em propriedades do tipo Cor, a alterao de valor pode ser feita por meio de caixas de dilogo, como mostrado a seguir, disponveis na lista de Propriedades atravs do boto na janela de Propriedades. Existem dois modos para se escolher a cor desejada: atravs da aba Padro, onde possvel selecion-la dentre cores pr-definidas, ou atravs da aba Personalizado, onde pode-se informar a cor atravs de seus componentes.

Cores

Telas e Objetos de Tela

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

Telas e Objetos de Tela

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.

6.5 Formatao de Valores

O uso de formatadores permite mudar a forma como os dados so apresentados sem precisar mudar o valor que existe por trs deles. O formato um texto que pode ser editado manualmente ou configurado atravs da janela de formatao. Seu uso semelhante aos formatadores usados nas planilhas eletrnicas, seguindo a mesma sintaxe bsica, mas com algumas extenses. So suportados os seguintes tipos de dados: Numricos (sada decimal, cientfica, hexadecimal, binria e octal) Texto Booleanos Datas e Horas (calendrio Gregoriano)

Os objetos que suportam formatao devem ter o tipo de dado na propriedade Value alterado de acordo com o tipo de formatao desejada.

Telas e Objetos de Tela

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)

6.5.1 Outros Formatos

Na opo Outro, pode-se criar um formato de dados qualquer, mesmo um dos j citados, a partir da digitao de um cdigo (texto) de formato. O texto do formatador composto de at quatro campos separados por um ponto e vrgula. O primeiro campo sempre aplicado quando no existir um outro campo mais apropriado para o valor ou tipo de dado. O segundo campo utilizado para valores numricos negativos. O 212 Telas e Objetos de Tela

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

Telas e Objetos de Tela

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

6.5.1.1 Formatadores Cientficos

O nmero poder ser apresentado em notao cientfica (mantissa e expoente) quando aps algum dgito houver E+, E-, e- ou e+, seguidos de dgitos para formatar o expoente. Quando for usado E+ ou e+ o expoente ser sempre mostrado com sinal, quando for usado E- ou e-, o sinal aparecer apenas para expoente negativos, sendo que no expoente sempre ser mostrado um dgito, mesmo que este seja zero. O nmero de dgitos direita do ponto decimal afeta o expoente mostrado. Exemplos: Formatador Cientfico DADO 1000 1000 #E+00 ##e-00 FORMATADOR SADA FORMATADA 1E+03 10e02

214

Telas e Objetos de Tela

6.5.1.2 Formatadores para Texto

O caractere @ copia o valor do dado na posio onde aparecer. Esse formatador deve aparecer no quarto campo (exemplo: ;;;@) ou diretamente quando h apenas um campo. Exemplos: Formatador para Texto DADO Abc xyZ @@ "Nome: " \ " @ \ " COMANDO Abc Abc Nome: "xyZ" AO

6.5.1.3 Formatadores para Bases No Decimais

Os formatadores para bases no-decimais sempre apresentam apenas a parte inteira do valor numrico formatado, e tambm no so sensveis ao sinal. Da mesma forma que na base decimal, caso o nmero possua mais dgitos do que o requisitado no formatador, estes dgitos sero apresentados de qualquer forma. Atualmente, estes formatadores esto limitados em nmeros de 32 bits. Caso a parte inteira do valor exceda esse limite a formatao retornar erro. Exemplos: Formatadores para Bases No-Decimais DADO 255 12345 987 12 "0x"XXX oooo\o B BBBB - BBBB FORMATADOR SADA FORMATADA 0x0FF 30071o 1111011011 0000 - 1100

6.5.1.4 Formatadores para Datas e Horas

A sintaxe da formatao de datas e horas difere um pouco do sistema usado pelas planilhas, seguindo o modo usado pela configurao regional do Windows. As datas so valores numricos onde a parte inteira uma contagem de dias desde 31 de dezembro de 1899 e a parte fracionria representa a hora em fraes de dia. O ano mnimo suportado 100 e o ano mximo 9999; isto garante uma resoluo de pelo menos 1 ms em todo o intervalo. Os nomes de meses e dias da semana, a ordem padro de dia, ms e ano e o separador de datas e horas so todos utilizados de acordo com a configurao regional do Windows. Atravs do quadro a seguir, possvel verificar o formatador e a sada formatada para os valores:

Telas e Objetos de Tela

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

Telas e Objetos de Tela

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.

Janela Gerenciar Controles ActiveX Ac tiveX 217

A janela Gerenciar Controles ActiveX possui as seguintes opes:

OPO Controles registrados no Windows

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.

7.1 Objetos Microsoft Forms

Para inserir um dos objetos Microsoft Forms previamente registrados no E3 na aplicao, existem duas opes: 1. Clique com o boto direito do mouse na Tela e selecione a opo Inserir - MSForms. 2. Selecione o objeto desejado na barra de ferramentas Objetos; aps, clique na Tela para estabelecer o ponto inicial do desenho do objeto, arrastando o mouse diagonalmente at o objeto atingir o tamanho e a posio desejados. Os objetos da biblioteca Microsoft Forms disponveis no E3 so descritos nas sees seguintes.

7.1.1 Caixa de Seleo

Indica se uma determinada opo est selecionada ou no, ou ainda se est parcialmente selecionada. Permite selees mltiplas em um grupo. inserido na Tela atravs do boto .

7.1.2 Boto de Opo

Indica se uma opo est selecionada ou no. Ao contrrio da Caixa de Seleo, no entanto, apenas um destes objetos pode ser selecionado em um grupo; no E3, este controle deve ser feito manualmente, atravs de scripts que configurem a propriedade Value dos demais botes para 0 (zero) quando um deles for clicado. inserido na Tela atravs do boto .

220

Ac tiveX

7.1.3 Lista de Seleo

Combina as funcionalidades de uma Lista e de um Editor de Texto: neste objeto, pode-se tanto digitar um valor diretamente ou selecionar um item de uma lista pr-estabelecida. inserido na Tela atravs do boto .

7.1.4 Boto de Comando

Usado para executar aes especficas quando pressionado, tais como abrir uma janela, imprimir um relatrio, etc. inserido na Tela atravs do boto .

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 .

7.1.7 Barra de Rolagem

Facilita a navegao atravs de uma longa lista de itens ou de uma grande quantidade de informao tanto horizontalmente quanto verticalmente. inserido na Tela atravs do boto .

7.1.8 Boto Incremento-Decremento

Usado para incrementar ou decrementar valores atravs de seu par de setas. inserido na Tela atravs do boto .

7.1.9 Editor de Texto

Possibilita ao usurio inserir e editar textos. inserido na Tela atravs do boto .

7.1.10 Boto Liga-Desliga

Permite atribuir um de dois estados a um outro objeto de Tela. inserido na Tela atravs do boto .

Ac tiveX

221

7.2 Elipse KeyPad

O Elipse KeyPad um controle ActiveX desenvolvido pela Elipse Software, que permite utilizar um teclado virtual flutuante em aplicaes desenvolvidas com o E3. Este controle pode ser ativado no Viewer utilizando a aba Visualizador das propriedades do objeto Viewer.

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.

Esconder ao pressionar ENTER

Esconder ao pressionar ESC

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.

Inserindo um divisor horizontal

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

9.1 Associao Simples

Na Associao Simples, o valor do campo Fonte copiado para a propriedade toda vez que o primeiro for modificado.

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

9.2 Associao Bidirecional

A Associao Bidirecional semelhante Associao Simples porm, caso haja uma variao na propriedade, seu valor ser copiado para a fonte, gerando assim, uma Associao de duas direes.

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

9.3 Associao Digital

J na Associao Digital, podemos estabelecer que caso a varivel ou expresso do campo Fonte represente um valor digital (Booleano), seus estados Verdadeiro e Falso sero mapeados para certos valores no destino, incluindo a opo de Pisca (alternncia de valores).

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

OPO Para valor <Campo Ligado>

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 valor <Campo Desligado>

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.

9.4 Associao Analgica

A Associao Analgica permite estabelecer uma escala de converses entre a varivel fonte e destino. Atravs dos valores especificados, feita uma escala linear entre os valores da propriedade e os valores da fonte.

Associao Analgica Assoc ia es 233

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.

9.5 Associao por Tabela

Na Associao por Tabela, possvel especificar um conjunto de intervalos em funo de valores mximo e mnimo da fonte e, para cada um destes intervalos, o valor a ser assumido pela propriedade. Alm disso, assim como na Associao Digital, possvel especificar a opo de Pisca e o valor alternativo. Para utilizar este recurso, siga estes procedimentos: 1. Clique nas propriedades do objeto e escolha a opo Associaes. 2. Selecione a propriedade para a qual deseja fazer a Associao, e clique no item Conexo por Tabela.

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

Valor < Pisca Habilitado>

Para utilizar este recurso, siga estes procedimentos: Assoc ia es 235

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.

9.6 Associao Reversa

Na Associao Reversa, toda vez que o valor da propriedade for modificado, este ser copiado para a fonte, funcionando assim de maneira reversa Associao Simples. Para utilizar este recurso, siga estes procedimentos: 1. Clique nas propriedades do objeto e escolha a opo Associaes. 2. Selecione a propriedade para a qual deseja fazer a Associao, e clique no item Conexo Reversa. 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.

Associao Reversa

9.7 Associao Mltipla

Na Associao Mltipla, cada linha da Associao permite buscar o valor de uma fonte diferente. A fonte ativa selecionada de acordo com o valor fonte principal da Associao. Cada linha possui o intervalo (propriedades Min e Max) e a fonte para aquele intervalo (propriedade Source , que um link normal). Para utilizar este recurso, siga estes procedimentos:

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

9.8 Edio de Associaes

O E3 possui uma ferramenta para editar as Associaes, chamada Edio de Associaes. Assim, possvel mudar uma ou mais Associaes feitas na aplicao de forma mais rpida do que pela janela tradicional. O acesso a esta ferramenta pode ser feito clicando-se com o boto direito do mouse sobre um ou mais objetos e selecionando a opo Editar Associaes.

Acesso opo Editar Associaes A seguinte caixa de dilogo mostrada:

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.

Propriedade / Evento Conexo Fonte

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.

Propriedade / Evento Conexo

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.

Sempre que a propriedade for uma condio verdadeira Repetir o evento

Intervalo de repetio (ms)

Sempre que a propriedade alterar o seu valor

Tratar a desconexo como 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

Copiar e colar uma Associao

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 Configurao do Viewer

Atravs das propriedades do Viewer, possvel especificar configuraes do Viewer, Erros de comunicao, criar associaes ou scripts.

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

OPO Tela ou Quadro Inicial

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

Manter Telas carregadas na memria

Verificar inatividade aps ... minutos

Nmero de retentativas para confirmao de usurio ou senha

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

OPO Ficar sempre no topo

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.

Barra de ttulo menor

Resoluo da Tela

Avanado

Ao clicar no boto Avanado, a seguinte janela aberta:

Configuraes avanadas As opes disponveis nesta janela so as seguintes:

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).

Desconto na resoluo da Tela em pixels

Resoluo do monitor em pontos por polegada (DPI)

10.1.3 Erros de Comunicao

No Viewer, possvel visualizar os erros de comunicao dos tags quando os mesmos estiverem associadas a Displays ou SetPoints. Isto possvel configurando as informaes contidas na aba Erros de Comunicao, disponvel nas propriedades do Viewer.

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.

Cor da letra Cor de fundo

10.2 Variveis no Viewer

No objeto Viewer possvel fazer associaes com objetos a partir de Telas, bem como uslos via scripts. Tambm possvel inserir tags Demo ou Internos no Viewer. Atravs do AppBrowser, pode-se executar as seguintes aes: Acessar o objeto Viewer ou algum de seus filhos a partir de uma Tela ou controle de Tela (associaes ou Scripts) Os filhos do objeto Viewer acessarem outros filhos do Viewer ou o prprio Viewer (associaes ou Scripts) O prprio objeto Viewer acessar seus filhos (associaes ou Scripts)

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.

10.3 Objeto _top

Quando um Viewer inserido no projeto, disponibiliza um frame filho. Este frame filho chamado de _top. Este objeto possui as mesmas funcionalidades do objeto Divisor do Quadro. Para utilizar este recurso, siga estes procedimentos: 1. Clique no objeto Viewer. O Viewer mostrar o seu filho nomeado _top .

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.

10.4 Pasta do Viewer

A Pasta do Viewer define grupos dentro do objeto Viewer de forma a organizar os tags do Viewer (Contador, Demo, Interno e Timer). Caso haja necessidade, novas pastas podem ser inseridas dentro de outras. Para utilizar este recurso, siga este procedimento: 1. Clique com o boto direito do mouse sobre o Viewer e selecione a opo Inserir - Pasta do Viewer.

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 .

11.1 Banco de Dados Access

Gera uma base de dados no formato .mdb, o formato padro de banco de dados no E3. 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 - 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. O objeto criado no projeto, e sua janela de edio de scripts aberta. 2. Para configur-lo, acesse a aba Configuraes da Janela de Propriedades.

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.

Arquivo MDB Senha do BD

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.

Senha Testar conexo

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.

11.2 Banco de Dados Oracle

A utilizao do Oracle como servidor de Banco de Dados do E3 s possvel atravs da instalao de um servidor ou cliente Oracle na mquina onde ser executado o servidor E3. Nesta instalao devem estar presentes, obrigatoriamente, o suporte a OCI (Oracle Call Interface) e o OLEDB Provider para Oracle, necessrios para a comunicao do E3 com o Oracle. Para instalar o Oracle, consulte a documentao prpria do produto. O acesso ao banco de dados Oracle pode ser feito de duas maneiras: acessando o Banco de Dados Oracle de dentro do E3 ou via scripts. A seguir sero explicados cada um destes procedimentos.

11.2.1 Acessando o Banco de Dados Oracle dentro do E3

Para inserir um novo Banco de Dados Oracle, siga estes procedimentos: 1. Clique com o boto direito do mouse no 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. O objeto criado no projeto, e sua janela de edio de scripts aberta. 2. Para configur-lo, acesse a aba Configuraes da Janela de Propriedades.

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 .

Usar tipo TIMESTAMP

256

Banc o de Dados

OPO Usar drivers ADO Oracle

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

Senha Testar conexo

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.

11.2.2 Acessando o Banco de Dados Oracle via Scripts

Scripts so mdulos de linguagem de programao onde se pode criar linhas de cdigo, que permitem maior flexibilidade para a associao de aes a eventos especficos. Cada item de um projeto do E3 possui uma lista de eventos previamente associados. Assim, o usurio poder criar programas que sero executados na ocorrncia de um evento. O E3 utiliza o VBScript (Visual Basic Script) em seus scripts, e com ele consegue instanciar qualquer objeto ActiveX registrado no sistema. Para o acesso ao Banco de Dados, o ActiveX mais utilizado o ADO, que pode ser facilmente manipulado nos scripts E3. Primeiramente, necessria a criao de uma conexo ADO que pode ser feita com o script a seguir:
Set DBConnection = CreateObject("ADODB.Connection")_ DBConnection.Open "Provider=MSDAORA;_ DataSource=conexaoOracle;User_ ID=UserID;Password=passwd"

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 .

11.2.3 Tecnologias Utilizadas pelo E3 para o Acesso ao Banco de Dados Oracle

O E3 utiliza basicamente duas tecnologias para acessar o Banco de Dados Oracle: ADO ( ActiveX Data Object) e OCI (Oracle Call Interface). ADO a tecnologia utilizada pelo E3Browser e E3Chart para recuperao dos dados armazenados no Banco de Dados. O ADO tambm amplamente utilizado nos scripts do E3 para todo tipo de operao junto ao Banco de Dados. Ele um conjunto de objetos COM ( Component Object Model ) criado para acessar informaes de SGBD usando OLE DB (Object Linking and Embedding ). Essa tecnologia fica disponvel quando se instala o OLE DB Provider para Oracle (MSDAORA). Ela faz o acesso interface nativa do Oracle, a OCI. A OCI utilizada pelo Servidor de Banco de Dados do E3 para implementar os servios de Banco de Dados utilizados pelos Histricos, Frmulas, Alarmes e Storage. Atravs da OCI, se acessa diretamente as funes do Oracle, tornando o processo o mais otimizado possvel. Ela fornece uma biblioteca padro de acesso ao Banco de Dados e funes de recuperao de dados na forma de uma DLL ou LIB que pode ser ligada a uma aplicao em tempo de execuo.

11.2.4 Acessando o Oracle via Servidor BD

O Servidor de Banco de Dados do E3 utiliza a OCI (Oracle Call Interface) para se comunicar com o servidor Oracle, ou seja, utiliza a forma nativa do Banco de Dados para ganhar em performance na comunicao com o Banco de Dados. Um bom exemplo de como funciona a comunicao do Servidor de Banco de Dados do E3 com o Oracle o Histrico. Inicialmente feita a aquisio dos dados pelo Histrico, que de posse destes dados, imediatamente os envia em forma de requisies para o BD. Estas requisies podem ser para criao de uma tabela, criao de ndices e chaves, adio de dados, etc. O Servidor de Banco de Dados do E3 possui um processo separado especialmente para receblas. Dependendo do tipo de operao a ser realizada, os dados so formatados e 258 Banc o de Dados

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.

Comunicao do E3 com o Oracle

11.3 Banco de Dados SQL Server

Atravs desta opo possvel armazenar dados no Banco de Dados SQL Server.

11.3.1 Acessando o Banco de Dados SQL Server dentro do E3

Para inserir um novo Banco de Dados SQL Server, siga estes procedimentos: 1. Clique com o boto direito do mouse sobre o cone do projeto, e selecione a opo Inserir Banco de Dados. O objeto criado no projeto, e sua janela de edio de scripts aberta. 2. Para configur-lo, acesse a aba Configuraes da Janela de Propriedades: Banc o de Dados 259

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.

Servidor Banco de Dados Biblioteca de Rede

Usurio

Senha Testar conexo

3. No campo Banco de Dados, selecione a opo 2 - stSqlServer.

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.

11.3.2 Exemplo de Utilizao do SQL Server 2000

Para ilustrar o acesso ao SQL Server 2000, faremos a criao de um Histrico registrando dados por tempo de varredura de um segundo. Os procedimentos sero mostrados a seguir. 1. Crie um Tag Demo. As configuraes deste Tag no necessitam ser alteradas. 2. D um duplo clique no Servidor de Banco de Dados e acesse a janela de configurao do Servidor SQL. Os parmetros devero ser alterados para se adequarem s configuraes disponveis na instalao do SQL Server. 3. Faa as configuraes necessrias nesta janela, tais como nome do servidor, usurio, senha e Banco de Dados. 4. Feita a configurao do Banco de Dados, deve-se configurar o Histrico que acessar esse banco. Para tanto, primeiramente devemos criar um campo no Histrico e inserir o Tag Demo, que ser utilizado para o envio de diferentes valores ao Banco de Dados.

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 .

11.3.3 Uso de ADODB para Acesso via Script

Para acesso ao SQL Server atravs de scripts, usa-se uma conexo ADODB. A String de conexo a esse tipo de Banco de Dados deve ser configurada conforme o modelo a seguir:
DRIVER={SQL Server};SERVER=server;UID=login_id;PWD=password;

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.

11.4 Objetos do E3 e Permisses

necessrio configurar as permisses no Banco de Dados para a utilizao dos objetos do E3 em um projeto. Estas permisses so listadas a seguir: Permisses OBJETO Frmulas Histrico de usurio Histrico Servidor de Alarmes PERMISSES Permisso completa. Escreve e consulta as tabelas existentes. Permisso completa. Permisso completa.

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.

12.1 Configurao de Alarmes

O objeto Configurao de Alarmes o local onde as reas so inseridas e organizadas. Para inserir este objeto em seu projeto, siga este procedimento: 1. Clique com o boto direito do mouse sobre o nome do projeto no Explorer e selecione a opo Inserir - Configurao de Alarmes. No modo Domnio, clique com o boto direito do mouse no item Objetos de Servidor - Alarmes, selecione a opo Inserir Configurao de Alarmes em, e logo aps o nome do projeto.

Inserindo o objeto Configurao de Alarmes

264

Alarmes

12.1.1 reas de Alarme

As reas de Alarme permitem agrupar um conjunto de Fontes de Alarmes, bem como outras reas. Isto facilita o gerenciamento, a operao e o monitoramento de um conjunto de Fontes de Alarme relacionadas, como por exemplo: Filtrar o conjunto de alarmes visveis no sumrio Habilitar ou desabilitar um conjunto de Fontes de Alarmes Reconhecer um conjunto de Fontes de Alarmes Verificar o total de alarmes ativos ou no reconhecidos de um conjunto de Fontes de 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

12.1.1.1 Objetos de Servidor como reas de Alarme

Objetos de Servidor, a partir da verso 4.0, tm a possibilidade de se comportarem como reas de Alarme. Estes objetos agora possuem uma aba adicional, rea de Alarmes, onde este comportamento pode ser habilitado e configurado. A figura a seguir mostra esta aba em um Driver de Comunicao:

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

As seguintes propriedades ficam disponveis no objeto de Servidor: ActiveAlarms

Alarmes

267

 ActiveHighAlarms ActiveHighNACKAlarms ActiveLowAlarms ActiveLowNACKAlarms ActiveMedAlarms ActiveMedNACKAlarms ActiveNACKAlarms Alarm AlarmVerify

12.2 Servidor de Alarmes

O objeto Servidor de Alarmes centraliza todos os alarmes do projeto. Nele podem ser encontrados todos os alarmes ativos da aplicao (reconhecidos ou no). Ele tambm o responsvel por reportar os eventos de alarme para todos os Viewers conectados, bem como enviar esses eventos para um Banco de Dados, se necessrio. Uma aplicao s pode ter um objeto desse tipo, e a sua presena obrigatria para que a verificao de alarmes ocorra. Para inserir um Servidor de Alarmes, siga este procedimento: 1. Clique com o boto direito do mouse sobre o nome do projeto no Explorer e selecione a opo Inserir - Servidor de Alarmes. No modo Domnio, clique com o boto direito do mouse no item Objetos de Servidor - Alarmes, selecione a opo Inserir Servidor de Alarmes em e logo aps o nome do projeto desejado.

268

Alarmes

Inserindo um Servidor de Alarmes no modo Domnio

12.2.1 Configuraes para Gerao da Tabela de Alarmes

Para especificar as configuraes do Servidor de Alarmes, necessrio acessar suas propriedades. Para tanto, basta clicar com o boto direito do mouse sobre o Servidor de Alarmes e selecionar a opo Propriedades. Na aba Configurao, possvel especificar as configuraes de Banco de Dados e determinar campos para a gerao da tabela de 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.

Utilize o servidor de banco de dados

Nome da Tabela

Descarta dados da tabela principal

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.

A verificao deve ocorrer a cada

Dados descartados devem ser armazenados

Mantenha os dados do(s) ltimo(s) ... < Tabela de Backup >

Campos

Gerar Tabela

Os campos disponveis no Servidor de Alarmes para gerao da tabela de alarmes so os seguintes:

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

12.2.2 Configuraes dos Campos do Usurio

Na aba Campos do Usurio pode-se adicionar valores arbitrrios aos eventos de 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

12.3 Fontes de Alarme

Todas as informaes relativas s condies de alarme so definidas nas Fontes de Alarmes, bem como os tipos de eventos que devem ser gerados em cada condio. As Fontes de Alarme sempre contm uma expresso de alarme (fonte de dados), cujo valor poder ser verificado de acordo com as diversas condies disponveis. Estas fontes so Alarme Analgico, Banda Morta, Digital, Taxa de Variao e Discreto.

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

OPO Texto da mensagem

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).

Aba Digital Alarmes 283

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

12.3.3 Banda Morta

Permite monitorar uma varivel analgica pela especificao de um limite mximo de diferena (valor de banda morta), em relao a um valor de referncia (SetPoint).

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

OPO Espera (ms)

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

12.3.4 Taxa de Variao

Usado para monitorar variaes muito rpidas em uma varivel do processo. A Fonte de Alarme Taxa de Variao usa seus valores especificados em unidades da varivel por segundo.

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

OPO Texto da mensagem

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

OPO Boto Mapear todas as subcondies

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.

Nome Habilitado Descrio Valor

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.

13.1 Configuraes do E3Alarm

Para configurar o E3Alarm, clique com o boto direito do mouse no objeto e selecione a opo Propriedades.

13.1.1 Configuraes Gerais

Na aba Geral so especificadas as informaes referentes ao Servidor de Alarmes e ao filtro.

Aba Geral 290 E3Alarm

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).

Filtrar por rea de Alarme

Filtrar por tipo

Filtrar por severidade

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

13.1.2 Configuraes de Colunas

Atravs da aba Colunas possvel selecionar os campos que sero visualizados no E3Alarm. Os campos mostrados nos itens Campos disponveis e Campos selecionados so gerados pelo Servidor de Alarmes. Para maiores informaes, consulte a Tabela dos Campos dos Alarmes na seo Configuraes para Gerao da Tabela de Alarmes do captulo Alarmes.

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.

Propriedades da coluna As opes disponveis so as seguintes:

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

Renomear para Permite reconhecer

Formatador para o campo Severidade DADO Severidade Alta Severidade Mdia ;;; "A";"M";"B" FORMATADOR Alta M SADA FORMATADA

E3Alarm

293

DADO Severidade Baixa ;;;

FORMATADOR

SADA FORMATADA Baixa

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.

13.1.3 Ordenao de Campos

A aba Ordenao permite configurar a ordenao padro dos alarmes. Quando mais de um campo de ordenao for usado, o segundo campo permite a ordenao entre alarmes que tenham o mesmo valor para o primeiro campo.

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.

Depois pelo campo

Ascendente

Descendente

NOTA : A ordenao padro feita atravs do campo InTime , de maneira descendente.

E3Alarm

295

13.1.4 Configurao de Cores

Na aba Cores so definidas as cores de reconhecimento dos alarmes no objeto. possvel configurar as cores para cada tipo de alarme ou por severidade.

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.

Pisca fundo e texto

Pisca apenas texto

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:

Cores por severidade E3Alarm 297

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 cor do texto

Redefinir pisca

13.1.5 Configurao de Fontes

Atravs da aba Fonte possvel configurar a fonte do cabealho e das linhas do E3Alarm.

Aba Fonte As opes disponveis so referentes a tipo, tamanho e efeitos da fonte.

298

E3Alarm

NOTA : o nome da aba aparece no idioma do Windows, e no necessariamente no idioma do E3.

13.2 Caractersticas Especficas de Runtime

O E3Alarm possui uma srie de caractersticas que se aplicam apenas em tempo de execuo (runtime). Estas caractersticas sero explicadas a seguir.

13.2.1 Visualizando os Alarmes

Em tempo de execuo, os alarmes do sistema podem ser visualizados no 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

13.2.2 Reconhecimento de Alarmes

Na configurao padro, ao clicar com o boto direito do mouse sobre o E3Alarm, mostrado um menu contextual com a opo Reconhecimento. Ao selecionar esta opo, mostrada a seguinte caixa de dilogo:

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.

13.2.3 Ordenao de Colunas

Na configurao padro, possvel ordenar os alarmes clicando-se no cabealho das colunas do E3Alarm. Ao clicar no cabealho da coluna desejada, o campo associado a ela ser configurado como campo primrio de ordenao. Ao clicar novamente no cabealho da mesma coluna, o sentido de ordenao primrio (ascendente ou descendente) ser invertido. Clicando no cabealho da coluna desejada com a tecla SHIFT pressionada, o campo associado a ela ser configurado como campo secundrio de ordenao. Ao clicar novamente com a tecla SHIFT pressionada no cabealho desta coluna, o sentido de ordenao secundrio ser invertido. Para maiores detalhes sobre este comportamento, veja as propriedades PrimarySortAscending, PrimarySortField, SecondarySortAscending e SecondarySortField na seo Propriedades do E3Alarm do Manual de Referncia de Scripts.

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

14.1 Configuraes do Histrico

Quando um Histrico inserido no projeto, o campo E3TimeStamp criado automaticamente na tabela. O campo E3TimeStamp mostra a data e hora em que o valor foi buscado (diferente do timestamp do Tag). Vale lembrar que este campo utilizado somente para leitura. possvel associar um Tag ao campo E3TimeStamp. Se no houver associao, ele busca a hora atual do sistema para a gravao. Para criar a tabela no Histrico, importante que seus campos sejam previamente criados atravs do boto (Adicionar campo). Para remover algum campo indesejado, clique no boto confirmao aparecer: (Remover campo). A seguinte mensagem de

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.

14.1.1 Chave Primria

A Chave Primria um campo ou um conjunto de campos que identifica de maneira nica cada registro de uma tabela. Assim como o ndice principal para a tabela, ela utilizada para associar dados entre tabelas. Alguns exemplos de chaves primrias so cdigos de clientes, CNPJ, nmero de matricula, etc. Aps a definio de um campo como sendo a chave primria da tabela, o prprio Banco de Dados garante que no sejam inseridos dados duplicados no campo que a chave primria. Por exemplo, se o usurio tentar cadastrar um pedido com o mesmo nmero de um pedido j existente, o registro no ser cadastrado e uma mensagem de erro ser mostrada. H dois tipos de chave primria: Simples ou Composta. Uma Chave primria simples um campo que identifica de modo nico cada registro de uma tabela. Uma Chave primria composta pode ser formada pela combinao de dois ou mais campos da tabela. Podem existir casos em que um nico campo no capaz de atuar como chave primria porque ele apresenta valores repetidos. Alm disso, uma tabela pode ter somente uma chave primria, seja ela simples ou composta. Ou seja, no se pode definir dois ou mais campos de uma tabela para que cada um seja uma chave primria separada. No confundir com o caso de uma chave primria composta, onde a unio de dois ou mais campos que forma a nica chave primria da tabela. Ao escolher campos da Chave Primria, considere os seguintes detalhes: No so permitidos valores duplos ou nulos Caso no exista um identificador nico para uma determinada tabela, pode-se usar um campo que numere os registros sequencialmente

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.

Nome do campo Ordenao Tipo Mude a ordem dos campos

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

Quando o boto Adicionar clicado, a seguinte caixa de dilogo aberta:

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

Tipo Mude a ordem dos campos

Clicando no boto OK, os ndices na tabela so confirmados. Para cancelar a configurao, clique no boto Cancelar.

308

Histric os

14.1.3 Configuraes da Tabela

Depois de definidas as opes anteriores, necessrio configurar as informaes da tabela do Histrico e gerar a estrutura no Banco de Dados. Para tanto, clique com o boto direito do mouse sobre o Histrico e selecione a opo Propriedades. Acesse a aba Histrico e a seguinte janela ser mostrada:

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

OPO Gravar um novo registro a cada

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.

Descarta dados da tabela principal

Mantenha os dados do(s) ltimo(s) ... <Tabela Principal>

A verificao deve ocorrer a cada

Dados descartados devem ser armazenados

Mantenha os dados do(s) ltimo(s)... <Tabela de Backup>

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

FieldDescription FieldEU FieldHighEng FieldID FieldLowEng FieldMaxRecTime

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

Buscar campos da tabela original. habilitada,

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

Histrico utilizando a opo Buscar campos da tabela original

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

Grfico sem compactao

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

15.1 Configuraes do Storage

Quando o Storage criado na tela, mostrada uma lista de definies dos campos de gravao.

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

Banda Morta Unidade

15.1.1 Criando um Storage Vazio

O objeto Storage pode ser criado sem que tenha seus campos configurados. Para isto, basta que suas propriedades DBServer e TableName sejam preenchidas na sua criao. Esta configurao permite que seja criado um Storage somente para consulta, o que bastante til para acessar dados gerados por aplicativos externos. Algumas restries so aplicadas nesta situao: Embora o Storage seja ativado normalmente, no ir gerar tabelas nem alterar ndices O boto Gerar Tabela, na janela de Propriedades, a opo Gerar Estrutura no DB do menu contextual e o boto da barra de ferramentas do Storage retornam uma mensagem de erro, indicando que a estrutura do banco de dados no pode ser criada pois no h campos definidos O Storage vazio listado normalmente na caixa de seleo Nome do Servidor de uma Consulta No h necessidade de licenas de Storage para consultar dados externos, somente para escrita de dados

Storage

319

15.2 Configurao da Tabela

Pode-se acessar as configuraes da tabela utilizada no Storage de duas maneiras: 1. Atravs do boto Propriedades.

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

OPO Descarta dados da tabela principal

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.

Mantenha os dados do(s) ltimo(s)... <Tabela Principal>

A verificao deve ocorrer a cada

Dados descartados devem ser armazenados

Mantenha os dados do(s) ltimo(s)... <Tabela de Backup>

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

FieldDescription FieldEU FieldHighEng FieldID FieldLowEng FieldMaxRecTime

FieldMinRecTime

FieldName FieldQuality FieldScanTimeMs

322

CAMPOS FieldSize FieldSource

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

15.2.2 Ferramentas de Consultas Internas (Query)

A ferramenta Consulta prev algumas facilidades para realizar consultas nos dados do Storage. Ao iniciar a configurao de uma consulta em uma aplicao que possui um Storage, este objeto entra na lista de Bancos de Dados disponveis para consulta. Isto porque o Storage atua como um novo provedor de dados, criando facilidades para o usurio consultar os dados nas tabelas temporais. Entretanto, nada impede o usurio de realizar as consultas diretamente no Banco de Dados de origem, de acordo com os formatos das tabelas j mencionado. A desvantagem neste caso que o processo de consulta ser mais complexo. Portanto, uma vez escolhido o prprio Storage como provedor de dados para a consulta, sua interface de configurao apresenta vrias diferenas, como pode ser visto na figura a seguir. A primeira delas que ao invs de exibir as tabelas, mostrada uma rvore com todas as variveis que esto sendo armazenadas. A outra diferena que o usurio pode escolher uma entre sete funes para consolidao dos dados, mostradas a seguir: LastValue : Retorna o ltimo valor armazenado na Base de Dados ArchivedValue : Retorna um valor armazenado em relao a um determinado instante de tempo definido na varivel TimeStamp . O tipo de relao, definido na propriedade FunctionSubType , pode ser Previous (Valor armazenado imediatamente anterior ao timestamp fornecido), Next (Valor armazenado imediatamente posterior ao timestamp ), Interpolated (Valor calculado a partir do valor anterior e posterior) e ExactTime (se for encontrado um valor armazenado no exato instante que foi fornecido pelo timestamp ). As variveis tambm podem ser definidas em execuo a partir da chamada do mtodo SetVariableValue da Consulta TagAttribute : Devolve um atributo do Tag, definido em FunctionSubType , que pode ser FieldDescription (Significado ou descrio do Tag), FieldSource (Caminho do Tag que est sendo armazenado), FieldType (Tipo de dado: Double , Bit, String ou Integer), FieldEU (Unidades de engenharia), FieldLowEng - FieldHighEng (Limites superiores e inferiores), FieldDeadBand (Banda morta para gravao), FieldDeadBandUnit (Unidade da banda morta, se em valores absolutos ou em porcentagem), FieldMinRecTime (Tempo mnimo para gravao, variaes menores que esse intervalo so desprezadas) e FieldMaxRecTime (Tempo mximo para gravao, a ausncia de variao nesses intervalos fora uma gravao) CompressedDataNValues: Retorna, para um nico Tag, N valores definidos na varivel NumVals , armazenados a partir de um instante inicial, definido na varivel StartTime . As variveis tambm podem ser definidas em execuo a partir da chamada do mtodo SetVariableValue da Consulta CompressedDataStartEndTime : Retorna, para um nico Tag, os valores armazenados que esto entre o intervalo definido pelas variveis StartTime e EndTime . As variveis tambm podem ser definidas em execuo a partir da chamada do mtodo SetVariableValue da Consulta

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

15.2.4 Ferramentas de Consultas Externas (Stored Procedures)

Quando se est desenvolvendo um programa externo, em linguagens como Java, Visual Basic ou Visual C++, e se deseja obter os dados armazenados pelo Storage, possvel realizar chamadas Stored Procedures, que so criadas pelo Storage em seu Banco de Dados. Existem sete Stored Procedures, que correspondem a algumas das opes de Consulta exibidas a seguir:

FUNO QUERY LastValue ArchivedValue CompressedDataNValues CompressedDataStartEndTime SampledData CalculatedData E3LastValue

STORED PROCEDURE

E3Archive, E3ArchiveInterpolate E3NCompData E3CompData E3SampledData E3CalculatedData

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

A seguir, alguns exemplos da utilizao destas funes.

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)

Onde: @dData: instante no tempo para a busca, no formato Float

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 .

16.1 Criando uma Consulta

Quando um E3Browser ou um Relatrio criado no projeto, uma Consulta automaticamente inserida como filho, com o nome Consulta1 . Para utilizar este recurso, siga estes procedimentos: 1. Ao clicar com o boto direito do mouse na Consulta e selecionar o item Configurar, uma janela mostrada solicitando a identificao do Servidor de Banco de Dados da aplicao.

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

Configurao da Consulta Estas abas so descritas nas prximas sees.

Consultas

335

16.1.1 Aba Campos

Esta aba mostra todos os campos das tabelas usadas na Consulta. Ao clicar no boto possvel selecionar outras tabelas para a Consulta. ,

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.

16.1.2 Aba Variveis

Esta aba permite definir valores padro para variveis definidas pelo usurio. Estas variveis tambm podem ter seu valor alterado em tempo de execuo utilizando o mtodo SetVariableValue .

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

16.1.3 Aba Visualizar

Esta aba mostra uma prvia dos resultados da Consulta quando se clica no boto . Tambm possvel retornar um nmero mximo de registros, permitindo agilizar a consulta.

Visualizao da Consulta

340

Consultas

16.1.4 Aba SQL

Nesta aba exibida a sintaxe SQL resultante da parametrizao realizada. Pode-se editar diretamente a consulta, selecionando a opo Habilita edio direta do SQL .

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.

Aviso ao desabilitar a edio direta do SQL

16.2 Uso dos Filtros da Consulta atravs de Scripts

Configurar e confirmar se a consulta est correta apenas um dos passos no uso da consulta. O uso em tempo de execuo e as modificaes de valores dos filtros definidos para a consulta podem ser vistos no script a seguir. A funo Consulta.SetVariableValue a responsvel pela parametrizao da consulta conforme valores passados via script.
Set consulta = Screen.Item("E3Browser1").Item("Consulta1") Consulta.SetVariableValue "DataIni", _ Application.GetObject("DadosFH.TagInterno1").Value Consulta.SetVariableValue "DataFim", _ Application.GetObject("DadosFH.TagInterno2").Value Screen.Item("E3Browser1").Requery()

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.

16.3 Uso de Recordsets de uma Consulta atravs de Scripts

Um outro uso interessante da consulta trabalhar com Recordsets. Depois de feita uma consulta, possvel capturar o recordset correspondente e trabalhar com registros linha a linha, executar novas consultas, etc. Na linha de comando
RS = TelaInicial.E3Browser1.Consulta1.GetADORecordset()

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

17.1 Objeto Consulta no E3Browser

A Consulta um objeto do E3 que auxilia o usurio no processo de definio de consultas no Banco de Dados da aplicao. Toda vez que o E3Browser for buscar dados no Banco de Dados, necessrio enviar um comando para o mesmo, de forma que se saiba quais os dados desejados para aquele objeto. Logo, toda vez que uma aplicao E3 precisar gravar ou buscar dados armazenados num Banco de Dados, so enviados comandos no formato SQL (Structured Query Language).

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.

NOTA : Um E3Browser no pode carregar consultas que se encontrem no servidor.

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.

17.2 Outras Configuraes do E3Browser

As configuraes disponveis no E3Browser so descritas nas sees seguintes.

17.2.1 Configuraes de Estilo

Atravs da aba Estilo pode-se definir a aparncia das divises (grade) das clulas e dimenses das linhas e colunas. Pela aba Opes pode-se definir o regime de atualizao dos dados e tipo de seleo das clulas.

Configuraes de estilo do E3Browser

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

Largura da primeira coluna

Altura das linhas

Largura das colunas

17.2.2 Configurao de Atualizao dos Dados

Na aba Opes, informe o intervalo de tempo em que os dados sero gravados e atualizados no E3Browser. A atualizao ocorrer em milissegundos (ms). Pode-se escolher a opo de no atualizar os dados, fazendo com que as gravaes permaneam as mesmas. Na opo Tipo de seleo, ser informado qual o tipo de seleo ser feita na tabela.

Aba Opes 346 E3Brow ser

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

17.2.3 Configurao de Cores

A aba Cor determina as cores do E3Browser, referentes s colunas e clulas do mesmo. Se a cor desejada no estiver na paleta de cores padro, necessrio configur-la atravs do boto Editar Cor Personalizada, pelo qual ser aberta a caixa de edio da cor.

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

OPO Paleta de Cores

DESCRIO Determina a cor da propriedade selecionada. Edita uma nova cor personalizada, diferente das cores padro.

Editar cor personalizada

NOTA : o nome da aba aparece no idioma do Windows, e no necessariamente no idioma do E3.

17.2.4 Configuraes de Fonte

Na aba Fonte , definem-se as especificaes de fontes no E3Browser.

Configuraes da Aba Fontes As opes disponveis so referentes a tipo, tamanho e efeitos da fonte.

NOTA : o nome da aba aparece no idioma do Windows, e no necessariamente no idioma do E3.

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.

18.1 Configuraes do E3Chart

Para acessar as configuraes do E3Chart, clique com o boto direito do mouse sobre o objeto e selecione a opo Propriedades.

350

E3Chart

18.1.1 Configuraes Gerais

Atravs da aba Item, possvel visualizar o nome do objeto e atribuir-lhe uma descrio.

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

A aba Posio determina o posicionamento do E3Chart na Tela.

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

Atravs da aba Geral, possvel especificar o estilo e a aparncia do grfico.

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.

Mostrar o fundo do grfico com a cor

Mostrar o fundo da grade com a cor

Intervalo entre as atualizaes (segundos)

18.1.2 Configurao dos Eixos

O objeto Coleo de Eixos representa o conjunto de Eixos contidos no E3Chart. Os Eixos so escalas colocadas no contorno da grade do E3Chart. Atravs da aba Eixos, possvel adicionar e remover Eixos da Coleo de Eixos, bem como configurar suas propriedades individualmente.

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

OPO Ttulo do eixo

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

Texto na cor da escala

Cor das linhas da grade

Estilo da linha

Mostrar as linhas na grade

Intervalo entre divises

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

OPO Mostrar ltimo perodo (tempo real)

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.

Intervalo de tempo (histrico)

Inverter Escala Formatao

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.

18.1.3 Configuraes das Penas

O objeto Coleo de Penas representa o conjunto de Penas contidas no E3Chart. Cada Pena configurada para exibir dados em tempo real ou dados histricos vindos da Consulta. Atravs da aba Penas, possvel adicionar e remover Penas da Coleo de Penas, bem como configurar suas propriedades principais, individualmente ou atravs da mltipla seleo de Penas.

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

A aba Geral contm as informaes que identificam a Pena no sistema.

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

OPO Unidade de Engenharia

DESCRIO Indica a unidade de engenharia utilizada pela Pena. Este campo equivale propriedade EU da Pena.

A aba Dados contm informaes de acordo com o tipo 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

OPO Link do eixo vertical

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.

Link do eixo horizontal

Nmero de amostras mantidas na memria

Usar a estampa de tempo

Consulta local

Consulta externa

Campo do eixo vertical

Campo do eixo horizontal

Usar consulta automtica

Eixo vertical

E3Chart

363

OPO Eixo horizontal

DESCRIO Especifica o Eixo horizontal. Este campo equivale propriedade ScaleX da Pena.

A aba Estilo determina o estilo 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

OPO Estilo do trao

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

Habilita alarme alto

Habilita alarme baixo

Cor de alarme

Cor de fundo do alarme

A aparncia da Pena, conforme a opo configurada, pode ser visualizada a seguir.

E3Chart

365

Modo analgico de ligao entre os pontos

Modo digital de ligao entre os pontos

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.

Valor considerado para o scan (ms)

E3Chart

367

OPO Mostrar os pontos de qualidade ruim

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)

Realar linha quando MaxGapTime usado

Cor da linha usada com MaxGapTime

Estilo da linha usada com MaxGapTime

A aba Estatsticas habilita o clculo de dados estatsticos.

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.

Mostrar mnimo e mximo

E3Chart

369

18.1.4 Configuraes da Legenda

A Legenda utilizada para exibir as Penas visveis no grfico e informaes sobre elas, tais como cor, nome da Pena, estado, etc.

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

Mostrar ttulos das colunas

Mostrar texto na cor da pena

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

EscalaX EscalaY Estado

FimX FimY

InicioX InicioY

MaximoY MediaY MinimoY Nome da Pena Nome do tagX Nome do tagY Unidade

Valor do tagX

372

E3Chart

OPO Valor do tagY

DESCRIO Mostra o valor da pesquisa no Eixo Y.

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

18.1.5 Configuraes das Consultas

As Consultas so necessrias para mostrar valores histricos no E3Chart. Atravs da aba Consultas possvel adicionar ou remover Consultas, bem como configur-las.

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

18.1.6 Configurao das Fontes

Atravs da aba Fonte , possvel configurar a fonte do cabealho e das linhas do E3Chart.

Aba Fonte As opes disponveis so referentes a tipo, tamanho e efeitos da fonte.

NOTA : o nome da aba aparece sempre no idioma do Windows.

18.2 Exemplos de Utilizao do E3Chart

A seguir sero mostrados alguns exemplos de utilizao do E3Chart.

18.2.1 Habilitando e Desabilitando Penas no E3Chart

O exemplo a seguir demonstra como habilitar ou desabilitar a conexo dos dados de uma Pena no E3Chart. Para tanto, siga estes procedimentos: 1. Crie um E3Chart na Tela. 2. Acesse as propriedades do E3Chart e selecione a aba Penas. Crie uma nova Pena de tempo real e associe-a a um Tag Demo no Eixo vertical. 3. Crie dois botes de comando na Tela. No primeiro boto de comando, escreva na propriedade Caption a descrio "Desabilitar Pena". 4. Acesse as propriedades deste boto e selecione a aba Scripts. No evento Click do boto de comando, escreva o seguinte script:

E3Chart

375

Sub CommandButton1_Click() Set Pen1= Screen.Item("E3Chart1").Pens.Item("Pena1") Pen1.Disconnect() End Sub

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

6. Execute o projeto e veja o resultado.

18.2.2 Atualizando o E3Chart Histrico com os Dados da ltima Hora

O exemplo a seguir demonstra como atualizar o E3Chart com os dados histricos da ltima hora. Para este exemplo, necessrio que voc tenha uma Consulta a uma tabela do Banco de Dados previamente criada. 1. Crie um E3Chart na Tela. 2. Acesse as propriedades do E3Chart e selecione a aba Eixos. Clique na opo Configurar do Eixo horizontal e na aba Escala, selecione a opo Intervalo de tempo (Histrico). 3. Acesse a aba Consultas e clique no boto Adicionar. O sistema mostrar uma caixa de dilogo para que se indique o nome do servidor de Banco de Dados em que a tabela da consulta est armazenada. 4. Selecione o servidor de Banco de Dados na caixa de dilogo e clique em OK. O sistema abrir as configuraes da Consulta. 5. Selecione na tabela histrica, o campo E3TimeStamp e algum campo de dados que se deseja mostrar no grfico. 6. No campo E3TimeStamp, crie um filtro conforme as especificaes a seguir.

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

12.Execute o projeto e veja o resultado.

18.2.3 Habilitando ou Desabilitando a Visualizao da Pena no E3Chart

O exemplo a seguir demonstra como habilitar ou desabilitar a visualizao de uma Pena no E3Chart. Para tanto, siga estes procedimentos: 1. Crie um E3Chart na Tela. 2. Acesse as propriedades do E3Chart e selecione a aba Penas. Crie uma nova Pena de tempo real e associe-a a um Tag Demo, no Eixo vertical.

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

7. Execute o projeto e veja o resultado.

18.2.4 Criao de uma Pena por Script

O exemplo a seguir demonstra como criar uma Pena por script. Para tanto, siga estes procedimentos: 1. Crie um E3Chart na Tela. 2. Crie um boto de comando da Tela. Na propriedade Caption, digite o texto "Criar Pena". 3. Acesse as propriedades deste boto de comando e selecione a aba Scripts. Digite o script a seguir no evento Click.
Sub Texto1_Click() Set E3Chart1 = Screen.Item("E3Chart1") MsgBox "Clique OK para criar a Pena" Set Pen = E3Chart1.Pens.AddPen("Pen1") Pen.DataSourceType = 0 ' Tempo real Pen.VerDataSource = "Dados.TagDemo1" Pen.UseTimeStamp = True ' No X usa o timestamp Pen.Color = RGB(255, 0, 0) Pen.DocString = "teste" MsgBox "Clique OK para conectar" Pen.Connect() ' Comea a receber os dados MsgBox "Clique OK para enquadrar" E3Chart1.FitPen(0) MsgBox "Clique OK para desconectar" Pen.Disconnect() ' Para de receber os dados MsgBox "Clique OK para remover a Pena" E3Chart1.Pens.Remove(Pen.Name) End Sub

4. Execute o projeto e veja o resultado.

378

E3Chart

18.3 Caractersticas Especficas de Runtime

O E3Chart possui uma srie de caractersticas que se aplicam apenas em tempo de execuo. Essas caractersticas sero explicadas nas prximas sees.

18.3.1 Opes do Cursor do Mouse

Clicando na legenda do grfico, possvel redimensionar suas colunas. Para tanto, basta selecionar a coluna desejada e arrast-la.

18.3.2 Opes do Menu Contextual

Clicando com o boto direito do mouse sobre o grfico do E3Chart, aberto um menu de opes.

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

OPO Pesquisar Intervalos

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.

Menos Zoom Mais Zoom Enquadrar tudo

Enquadrar verticalmente

Enquadrar horizontalmente

Enquadrar Pena

18.3.3 Opo Pesquisar

Esta opo permite pesquisar valores dos pontos das Penas. O valor mostrado na legenda, atravs das colunas Valor do Tag X e Valor do Tag Y.

A pesquisa mostrada nos campos Valor do TagX e Valor do TagY

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.

18.3.4 Opo Pesquisar Intervalos

Neste modo so mostrados dois cursores, que definem o intervalo de clculos estatsticos. Os valores dos cursores so mostrados nas colunas IncioX, IncioY, FimX e FimY. Para alterar a posio de um cursor, basta selecion-lo, clicando com o boto esquerdo do mouse, e arrast-lo para a posio desejada.

Pesquisa de intervalos

18.3.5 Coluna Estado da Legenda

A coluna Estado da legenda mostra o estado atual de cada Pena. O contedo desta mensagem composto por uma informao de erro, se houver, e informaes sobre a situao atual da Pena, como por exemplo o nmero de pontos. As tabelas a seguir mostram as possveis mensagens de erro e de informao para Penas de Tempo Real e Histricas. Se a Pena do tipo Mista, a mensagem final ser uma combinao da mensagem da parte de Tempo Real e Histrica. Caso haja mensagens de erro, a linha da coluna ser mostrada em vermelho enquanto o erro persistir. Mensagens de status da parte de tempo real MENSAGEM Erro: Parte de tempo real desconectada (YLink=' Nome do Tag') (XLink='Nome do Tag') SIGNIFICADO No houve conexo da parte de tempo real da Pena. Verifique o nome dos Tags nas propriedades YLink e XLink da Pena.

E3Chart

381

MENSAGEM Info: Tempo real n pts

SIGNIFICADO Mostra o nmero total de pontos da parte de tempo real.

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: Consulta inicializando

Erro: Consulta: Falha na inicializao

Erro: Campo no encontrado (XField = 'Nome do Campo')

Erro: Campo no encontrado (YField = 'Nome do Campo')

Erro: ' Nome da Consulta' ' Mensagem de Erro'

Info: n pts

Info: Carregando

Erro: Consulta invlida (QueryName = ' Nome da Consulta')

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

Falha ao pegar os dados do servidor

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.

19.1 Objeto E3Playback

O E3Playback, a ferramenta de playback da Elipse, um ActiveX que roda dentro do E3 Viewer ou do E3WebViewer e que permite visualizar as telas do aplicativo utilizando dados histricos armazenados em bancos de dados. O E3Playback busca no banco de dados os tags referenciados nas telas, bem como os demais links entre Viewer e servidor (tais como os tags do Viewer com links para objetos do servidor), e mostra valores, animaes, estados e grficos de acordo com as informaes existentes no banco de dados e o perodo de playback definido.

19.2 Adicionar Playback ao Demo do E3

Este exemplo mostra como adicionar funcionalidades de playback ao aplicativo de demonstrao que vem junto com a instalao do E3. 1. Crie uma nova Tela chamada TelaPlayback e insira o ActiveX E3Playback ocupando toda a rea de fundo da Tela.

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

Pick Abrir Tela

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

Tela de playback em modo online

19.3 Interface de Usurio do E3Playback

A interface de usurio do E3Playback dividida em cinco partes: Barra de Ferramentas Linha de Tempo Marcadores rea de Telas Lista de Eventos Lista de Tags

E3Play bac k

389

19.3.1 Barra de Ferramentas

A Barra de Ferramentas rene os principais comandos para operao do E3Playback.

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

COMANDO Mais Rpido

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.

Capturar a tela do E3Playback

Ao selecionar a ferramenta Gravao de Vdeo mostrada.

, a seguinte janela de configuraes

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.

Quadros por segundo

392

E3Play bac k

OPO Mostrar cursor na gravao

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

Intervalo de quadros a cada quadro-chave

Configurar Compresso de Vdeo

Sobre

Gravar udio

Dispositivo

Formato

Atributos

Configurar Gravao de udio

Mostrar resumo ao concluir gravao

E3Play bac k

393

19.3.2 Linha de Tempo

A Linha de Tempo permite acompanhar visualmente e controlar o relgio de playback.

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

COMPONENTE Barra de Consultas

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.

Barra de Zoom Geral

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.

Remover todos os marcadores Mover para o marcador anterior

396

E3Play bac k

CONE

COMANDO Mover para o marcador seguinte

AO Seleciona o prximo marcador na linha de tempo e na lista de eventos, simultaneamente.

Clicando no boto

Adicionar, ou no boto

Editar, a seguinte janela mostrada.

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

19.3.4 rea de Telas

Esta a rea onde so mostradas as telas do aplicativo. A tela inicial mostrada a configurada na propriedade InitialScreen do E3Playback. Se esta propriedade for deixada em branco, utilizada a tela inicial do objeto Viewer.

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.

19.3.5 Lista de Eventos

A Lista de Eventos mostra a sequncia cronolgica de eventos de playback, permitindo a navegao evento-a-evento. Um evento de playback pode ser: Uma alterao no valor de um tag Uma alterao no estado de um alarme

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

CAMPO Caminho do Tag

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.

Mostrar apenas os eventos deste tag ou Mostrar todos os eventos

19.3.6 Lista de Tags

A Lista de Tags mostra os tags que esto sendo utilizados para playback.

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.

19.4 Banco de Dados de Playback

O E3Playback detecta automaticamente quais so os tags e os alarmes que esto armazenados no banco de dados. A este processo de deteco do banco chamamos de Montagem. Depois que o banco est montado, o E3Playback utiliza as informaes coletadas para fazer consultas aos dados armazenados de acordo com os tags que esto sendo mostrados na tela, e de acordo com o relgio atual de playback.

E3Play bac k

403

19.4.1 Montagem do Banco de Dados

A Montagem do Banco de Dados feita sempre que o E3Playback ativado. As informaes de estrutura do banco de dados coletadas durante a montagem so mantidas enquanto a seo de playback estiver ativa. Os passos da montagem do banco de dados podem ser resumidos da seguinte forma: 1. Enumerar todas as tabelas do banco de dados. 2. Verificar quais destas tabelas possuem uma tabela _Fields correspondente. Por exemplo, quando o E3 gera uma tabela de alarmes chamada E3Alarms, gera tambm uma tabela com a descrio dos campos da tabela de alarmes (E3Alarms_Fields). 3. Analisar os campos de cada tabela, bem como o contedo da sua tabela _Fields correspondente para determinar o tipo de tabela. O E3Playback reconhece trs tipos de tabela: Storage : a tabela deve ter os campos E3TimeStamp, FieldID, Quality e FieldValue Alarmes: a tabela deve ter os campos EventTime (ou EventTimeDbl), ConditionActive , Acked, AckRequired e FullAlarmSourceName Histrico: a tabela deve ter o campo E3TimeStamp, e no pode ter sido reconhecida como uma tabela de Storage ou de Alarmes 4. Se a tabela for de Storage, a tabela _Fields varrida para determinar quais so os tags armazenados na tabela. O caminho do tag determinado pelo campo FieldName da tabela _Fields. O campo que fornece o timestamp dos dados de Storage sempre o E3TimeStamp. Cada Storage pode ter at trs tabelas de dados, uma para cada tipo de dado: Strings: o nome da tabela de dados <Tabela>_String Bit/Digital: o nome da tabela de dados <Tabela>_Bit Double/Analgicos: o nome da tabela de dados <Tabela> 5. Se a tabela for de Histrico, a tabela _Fields varrida para determinar quais so os tags armazenados na tabela. O caminho do tag neste caso determinado pelo campo FieldSource . O campo que fornece o timestamp dos dados desta tabela sempre o E3TimeStamp. 6. Se a tabela for de alarmes, a tabela _Fields varrida para determinar o nome dos campos de alarme de usurio (se existirem). O campo que fornece o timestamp na tabela de alarmes o EventTime (opcionalmente combinado com o campo EventTimeMS, se existir) ou o campo EventTimeDbl (este ltimo tem prioridade por representar os milissegundos com mais preciso). 7. Depois que todas as tabelas de dados e os caminhos dos tags foram detectados, feita uma consulta simples em cada uma das tabelas para determinar a data mais antiga e a data mais nova armazenada na tabela. Isto permite determinar o intervalo de datas em 404 E3Play bac k

que o playback ser permitido.

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.

19.4.2 Consultas de Dados de Playback

A quantidade de dados disponvel para playback pode ser enorme, dependendo do aplicativo. Para tornar a navegao de telas mais suave, o E3Playback faz consultas ao banco de dados em perodos de tempo pequenos, chamados Fatias. Cada fatia de dados de playback tem uma largura fixa de 45 minutos. Sempre que o relgio posicionado em uma determinada data/hora, o E3Playback cria ou encontra a fatia de tempo que contm a data/hora atual. Cada fatia de dados possui as seguintes informaes: Perodo de tempo da fatia (data/hora inicial e final) Uma lista dos tags que j tm os seus dados carregados na fatia Para cada tag armazenado em uma fatia, so mantidos os seguintes dados: O ltimo evento do tag anterior ao incio da fatia Todos os eventos do tag dentro do intervalo da fatia O prximo evento do tag aps o final da fatia O sumrio de alarmes no momento do incio da fatia Todos os eventos de alarmes que ocorreram durante o intervalo da fatia O prximo evento de alarme de cada Fonte de Alarme aps o final da fatia Quando o relgio de playback movido sobre uma fatia de tempo, o E3Playback analisa se todos os tags necessrios j esto carregados na fatia, e se todas as informaes de alarme tambm j foram carregadas. Se estiver faltando algum dado, ento gerada uma consulta assncrona para carregar os dados necessrios do banco de dados. Uma consulta de dados de playback composta dos seguintes parmetros: Perodo que vai ser consultado (data/hora inicial e final) Conjunto de tags que devem ser consultados (pode estar vazio). Para cada tag dever ser E3Play bac k 405

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 Configurao dos Objetos de Banco de Dados do E3

Esta seo explica como os objetos do E3 devem ser configurados para que os dados armazenados no banco de dados possam ser utilizados no E3Playback.

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

 Message Severity Source SubConditionName CurrentValue

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

 Configurar a propriedade CompressedTable em True e utilizar a propriedade DeadBand no Histrico

A figura a seguir mostra como deve ser a configurao do ndice do campo E3TimeStamp:

Definio do ndice para o 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.

Inserindo um objeto Frmula na aplicao

NOTA : O objeto Frmula pode ser configurado para funcionar como rea de Alarme .

Frmulas

411

20.1 Configuraes da Frmula

Quando uma Frmula criada, mostrada uma janela para a configurao do Banco de Dados e da tabela que sero utilizados. Sem isto, no ser possvel a criao de unidades e conjuntos de valores.

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

Configurando o Banco de Dados

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

, para a excluso do template selecionado.

Restries, a seguinte janela mostrada:

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

OPO Limite por diferena

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

, para a excluso da unidade selecionada; e

Renomear , para a troca do nome da unidade selecionada. Para cada nova unidade, solicitado um nome: 416 Frmulas

Adio de uma unidade

20.4 Conjunto de Valores

A terceira aba na view de Frmulas chama-se Valores. Conjuntos de valores so os valores transferidos para os Tags, ou seja, para as unidades.

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

, para a excluso do conjunto de valores

, para a troca do nome do conjunto de valores selecionado.

Frmulas

417

20.5 Exemplo de Criao de uma Frmula

Instrues Ser criado um objeto Frmula para armazenar conjuntos de valores para a produo de uma determinada pea. Esta pea ter trs medidas: Dimetro Externo, Dimetro Interno e Altura. Esta Frmula armazenar os valores para duas mquinas diferentes, que produziro estas peas.

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

Tela final da Frmula 2. Rode a aplicao e observe os resultados.

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

Galeria (Biblioteca de smbolos)

21.2 Biblioteca do Usurio (ElipseX)

Os ElipseX so as bibliotecas de objetos do E3. Podem conter, alm de um desenho, variveis internas passveis de serem exportadas para a aplicao, alm de lgicas de programao (scripts) presentes em todas as cpias do objeto sendo criado, diminuindo a necessidade de repetio de cdigo em diversas partes de seu aplicativo. Os ElipseX ficam encapsulados em um arquivo com extenso .lib. Pode-se criar todos os ElipseX que sero utilizados num determinado projeto no mesmo arquivo de Biblioteca (.lib), ou ento dividir entre vrios arquivos conforme desejado. Para criar uma nova biblioteca no E3, siga estes procedimentos: 1. Acesse o menu, selecione o item Novo Projeto e clique em Prximo. 2. Na opo Tipo de Aplicao, selecione a opo Biblioteca de componentes do E3 .

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

8002802D, que corresponde a Name already exists in the library.

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.

Valor Texto de ajuda

Determina o valor inicial da varivel. Texto de declarao e documentao da varivel.

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.

Valor Texto de ajuda

Determina o valor inicial da varivel. Texto de declarao e documentao da varivel.

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.

21.3 Quando Criar um ElipseX

O uso de Bibliotecas altamente recomendvel devido ao ganho de produtividade que trazem. Algumas das vantagens dos ElipseX so: Reutilizao de cdigo Minimizao de testes durante o desenvolvimento Criao de interface padro para os objetos desenvolvidos Diminuio do tempo de desenvolvimento de novos projetos Proteo do contedo do projeto

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.

Inserindo um Relatrio 2. Caso necessite, configure as propriedades do objeto.

22.1 Objeto Consulta

Este objeto permite que seja especificada a origem dos dados do Banco de Dados que ser visualizado no Relatrio. Aps ter criado o Relatrio no projeto, este cria o objeto Consulta. Para maiores informaes a respeito deste objeto, veja o captulo Consultas.

Relatrios

437

22.2 Componentes do Relatrio

Um relatrio contm vrias sees. Cada seo do relatrio contm um grupo de controles que so processados e impressos ao mesmo tempo, como uma simples unidade.

Sees do relatrio O relatrio define tipos de seo, que sero explicados nas sees a seguir.

22.2.1 Report Header

Um relatrio pode ter uma seo Report Header que imprime no incio do relatrio. geralmente utilizada para imprimir ttulos de relatrio, tabelas de somas, grficos ou qualquer outra informao que necessite aparecer somente uma vez no incio do relatrio.

NOTA : Um Report Header pode estender-se por mltiplas pginas. Para isto, basta inserir um objeto Quebra de Pgina em seu contedo.

22.2.2 Report Footer

A seo Report Footer imprime no final do relatrio. usada para imprimir uma soma de um relatrio, totais gerais ou qualquer outra informao que necessite ser impressa somente uma vez no final do relatrio.

22.2.3 Page Header

A seo Page Header imprime uma vez o topo de cada pgina no relatrio. a primeira seo que imprime na pgina, exceto quando esta pgina contm a seo Report Header. Usada para imprimir totais de pginas, nmeros de pginas, ttulos de pginas ou qualquer outra informao que necessite ser impressa uma vez no topo de cada pgina.

438

Relatrios

22.2.4 Page Footer

A seo Page Footer imprime uma vez a base de cada pgina no relatrio. Usada para imprimir totais de pginas, nmeros de pginas ou qualquer outra informao que necessite ser impressa uma vez na base de cada pgina.

22.2.5 Group Header e Group Footer

Um relatrio pode ter mltiplos grupos aninhados. Cada grupo possui uma seo Header e uma seo Footer. A seo Header imprime antes de qualquer seo Detail no grupo. A seo Footer imprime depois de todas as sees Detail do grupo. Sees de grupo so inseridas imediatamente antes e depois da seo Detail. O nmero de vezes que uma seo de grupo pode imprimir depende de como os dados so agrupados. O relatrio iniciar um novo grupo (Header, Detail e Footer) para cada mudana nos dados que sero reunidos no grupo.

22.2.6 Detail
A seo Detail o corpo do relatrio, que imprime uma vez para cada registro da fonte de dados.

22.3 Configuraes do Relatrio

O Relatrio possui vrios objetos que podem ser agregados a si, que so acessados atravs da barra de ferramentas Relatrio.

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

Menu do Relatrio Relatrios 439

 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

OPO Horizontal Spacing

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

Determina o formato da borda do objeto do relatrio.

Quando a opo Format Border selecionada, uma caixa de dilogo mostrada.

Opes de borda do objeto 442 Relatrios

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

Preview Color Shadow

Atravs da barra de ferramentas Relatrio, possvel acessar os recursos disponveis no relatrio.

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.

22.3.2 Report Settings

Atravs desta opo, possvel configurar as especificaes do relatrio, tais como configuraes de pgina, impresso, grade e estilo do relatrio. A opo PageSetup configura as especificaes referentes pgina do relatrio.

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

ITEM Right Margin Gutter Mirror Margins

DESCRIO Determina a margem direita da pgina. Determina a margem da pgina. Habilita ou desabilita a margem espelhada da pgina.

A opo Printer Setting configura as especificaes referentes impresso do relatrio.

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.

Collate Duplex PaperBin

A opo Grid Setting determina as configuraes referentes s grades do relatrio.

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

ITEM Grid Columns Grid Rows Ruler Units

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).

A opo Style determina as configuraes referentes ao estilo do relatrio.

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.).

Font / Colors / Misc

448

Relatrios

22.3.3 Script Editor

O Editor de scripts (Script Editor) utilizado para criar scripts nos relatrios do E3. A linguagem utilizada para criar os scripts no relatrio a Active Scripting, que interage com o Visual Basic. Quando o editor de scripts est aberto, disponibiliza os mtodos e eventos dos objetos e componentes do relatrio. Para utilizar este recurso, acesse o boto Script Editor disponvel na barra de ferramentas Relatrio. que est

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.

22.3.4 Carregar Arquivo RPX

Importa a configurao do relatrio de um arquivo externo.

22.3.5 Salvar Arquivo RPX

Exporta a configurao do relatrio para um arquivo externo.

22.3.6 Objetos do Relatrio

Esta seo contm informaes sobre os objetos que podem ser usados em um Relatrio.

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.

Linha Aps ser inserido na Tela, o objeto ser chamado de Line .

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 Aps ser inserido na Tela, o objeto ser chamado de Shape .

22.3.6.3 Retngulo Arredondado

O objeto Retngulo Arredondado um retngulo criado a partir de dois vrtices, com cantos arredondados a partir de um fator de arredondamento. Ao ser inserido ou editado, exibe um pequeno ponto prximo ao canto superior esquerdo do objeto, que permite modificar o fator de arredondamento.

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.

Elipse Aps ser inserido na Tela, o objeto ser chamado de Shape .

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.

Texto Aps ser inserido na Tela, o objeto ser chamado de Label .

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

Aps ser inserido na Tela, o objeto ser chamado de Picture .

22.3.6.7 Campo de Dados

O objeto Campo de Dados utilizado para inserir um dado do Banco de Dados no relatrio. Este dado indicado atravs da propriedade DataField.

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

22.3.6.8 Caixa de Seleo

O objeto Caixa de seleo insere um dado no Relatrio que pode ou no estar ligado ao Banco de Dados. Seu valor ser um booleano.

Caixa de seleo Aps ser inserido na Tela, o objeto ser chamado de CheckBox .

22.3.6.9 Cdigo de Barras

O objeto Cdigo de Barras permite gerar uma figura que converte uma sequncia de nmeros e caracteres em um cdigo de barra. Este cdigo de barras uma representao numrica ou alfanumrica, utilizada para facilitar diferentes processos. Este cdigo decifrado atravs de scanners, canetas e equipamentos de leitura ptica.

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.

E3Chart NOTA : O E3Chart no pode ser adicionado na seo Detail do Relatrio.

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.

22.3.6.11 Quebra de Pgina

O objeto Quebra de pgina um ponto em que uma pgina termina e outra comea no relatrio. Por exemplo, pode-se forar uma quebra de pgina para assegurar que o ttulo de um captulo comece sempre em uma nova pgina. Ao trabalhar com documentos que contenham diversas pginas e inserir quebras de pgina manuais, talvez seja necessrio reinser-las com frequncia medida que se edita o documento. Tambm pode-se impedir que uma quebra de pgina ocorra em um pargrafo ou em uma linha de tabela ou ainda assegurar que uma quebra de pgina no seja inserida entre dois pargrafos, como entre um ttulo e o pargrafo seguinte.

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.

Quadro Aps ser inserido na Tela, o objeto ser chamado de Frame .

22.4 Criando um Relatrio no E3

Esse exemplo contempla a criao de um relatrio no E3 para extrao de dados de um histrico.

22.4.1 Definio de reas do Relatrio

O relatrio padro, criado quando inserido um novo relatrio ao projeto, tem as seguintes reas: Page Header: rea mostrada em todas as pginas do relatrio, como cabealho Detail Area: rea repetida tantas vezes quantas forem necessrias, o corpo do relatrio Page Footer: Rodap da pgina, trabalha do mesmo modo que o Page Header

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

22.4.2 Configurao da Consulta

Para a extrao de dados de um Banco de Dados, necessrio configurar a consulta do Relatrio. Podem existir vrias consultas diferentes para o mesmo relatrio, sendo que apenas uma pode estar ativa em determinado momento. Para tanto, deve-se seguir estes procedimentos: 1. Configure a propriedade DataSource (nome do Banco de Dados onde ser feita a consulta. Nesse caso, ServidorDB ). 2. Determine a propriedade Table (tabela de consulta, aqui ser Dados ). 3. Configure a propriedade Name (ficar com o nome original, Consulta1 ).

22.4.3 Configurao dos Campos

Nesse exemplo foram criadas quatro temperaturas sendo armazenadas em um histrico e essas temperaturas so o objeto de interesse do nosso relatrio. Sendo assim, os valores lidos do histrico sero impressos atravs do relatrio. Para ler dados de um Banco de Dados, a rea ideal a Detail Area, visto que essa rea repetida automaticamente quantas vezes se fizerem necessrias. Dessa maneira, devero ser inseridos cinco campos de texto nessa rea. Esses campos podem ser ligados a um campo de dados, que configurado atravs da propriedade DataField. Aqui, sero usados os seguintes valores: Field1 : E3Timestamp Field2 : Temperatura1 (como est no Banco de Dados) Field3 : Temperatura2

22.4.4 Visualizao do Relatrio

possvel fazer a visualizao do relatrio criado atravs do boto de Preview na rea de edio do mesmo. , disponvel

Para tanto, necessrio direcionar o servidor de Banco de Dados do projeto para o arquivo MDB da pasta onde foi salvo o exemplo.

22.5 Exemplos de Utilizao nos Relatrios

A seguir so mostrados alguns exemplos de utilizao dos recursos dos Relatrios.

456

Relatrios

22.5.1 Configurando o Caminho de um Bitmap na Hora de Imprimir um Relatrio

Para utilizar este recurso, escreva o seguinte script no evento OnFormat das sees PageHeader ou ReportHeader:
Sub OnFormat Report.Sections("ReportHeader").Controls("Image2").Picture = _ LoadPicture ("C:\correio\teste.bmp") End Sub

22.5.2 Configurando o Valor de um Objeto Cdigo de Barras dentro da Seo Detail

Para utilizar este recurso, escreva o script a seguir no evento OnFormat da seo Detail:
Sub OnFormat Report.Sections("Detail").Controls("BarCode1") Caption = Right(Report.Field ("E3TimeStamp"), 8) End Sub

22.5.3 Capturando uma Tela e Gerando uma Prvia de Impresso

Para utilizar este recurso, escreva o seguinte script:
Sub Rect_Click() Screen.CaptureScreen("C:\correio\teste.bmp") Application.LoadReport("[Relatrio3]").PrintPreview() End Sub

22.5.4 Gerando um Menu que Permite Exportar um Relatrio

Para utilizar este recurso, escreva o seguinte script:

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

22.5.5 Como Criar Relatrios Mostrando Pgina N de M

Para criar um relatrio que a cada pgina imprime um indicativo de Pgina N de M onde N a pgina atual e M o total de pginas, crie dois Labels e dois Campos. Os dois Labels correspondem aos textos Pgina e de , que devem ser inseridos na propriedade Caption. Os dois campos correspondem aos valores N e M , com as seguintes propriedades: Campo N Name : txtPageNumber SummaryGroup: GroupHeader1 SummaryRunning: 1 - ddSRGroup SummaryType : 4 - ddSMPageCount Campo M Name : txtPageCount SummaryGroup: GroupHeader1 SummaryType : 4 - ddSMPageCount

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.

Janela Permisses de usurio

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

OPO Grupos disponveis

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

Ao clicar nos botes Novo ou Editar, a seguinte caixa de dilogo mostrada:

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

Senha Confirme a senha

Nome completo Este usurio um administrador O usurio no pode alterar sua senha

A senha expira aps ... dias

A senha deve conter no mnimo ... caracteres

A senha deve conter letras e nmeros

A senha deve conter no mnimo ... nmeros

A senha deve conter no mnimo ... letras

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.

NOTA : Apenas o administrador tem acesso ao mtodo UserAdministration do Viewer.

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.

Aba Grupos As opes disponveis desta aba so as seguintes: 466 Seguran a

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

Ao clicar nos botes Novo ou Editar, a seguinte caixa de dilogo mostrada:

Adicionar grupo As opes disponveis so as seguintes:

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 expira aps ... dias

A senha deve conter no mnimo ... caracteres

A senha deve conter letras e nmeros

A senha deve conter no mnimo ... nmeros

A senha deve conter no mnimo ... letras

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

OPO Itens para segurana

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

Desabilitar a verificao de 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

Acesso remoto ao Domnio Acesso remoto de escrita ao Domnio

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.

23.4 Proteo de Arquivos

Protege o contedo de um arquivo .prj ou .lib contra a edio, visualizao ou execuo no autorizada. Para utilizar este recurso, siga estes procedimentos: 1. Clique com o boto direito do mouse sobre o nome do projeto ou da biblioteca no Explorer e selecione a opo Proteo. No modo Domnio, clique com o boto direito do mouse no nome do projeto ou da biblioteca, no item Configurao - Arquivos, e selecione a opo Proteo. 2. O sistema abrir uma caixa de dilogo com as opes a seguir:

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

24.1 Viewer Only (Modo Somente Leitura)

O modo Viewer Only (modo Somente Leitura, ou de acesso restrito) uma maneira de controlar o acesso que o Viewer tem ao servidor (Domnio), em oposio ao modo Viewer Full, que no possui restries de acesso. Atravs da configurao da permisso de usurios (captulo sobre Segurana), e de acordo com o tipo de licena de Viewer em uso (captulo sobre Domnios), o servidor ir determinar se o Viewer est no modo Full (normal) ou Only (restrito). Quando ele est no modo Only, so aplicadas diversas restries quanto s aes que podem ser escritas no servidor. Neste modo esto bloqueados (seja por erro de script ou por gerar mensagem de erro): Escritas em geral em propriedades de objetos do servidor atravs do Viewer por Associaes Escritas em geral em propriedades de objetos do servidor atravs de scripts do Viewer Mtodos SetValue e ToggleValue do Viewer (incluindo-se a os Picks Carregar e Inverter Valor) Chamadas de mtodos de objetos do servidor atravs de scripts do Viewer (excees a seguir) Administrao de usurios atravs do Viewer (uso do mtodo UserAdministration do Viewer) Reconhecimento de alarmes pelo E3Alarm Uso dos mtodos LoadFormulaDlg, LoadFormulaValues e LoadFormulaValuesQuiet do Viewer

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

E3 V iew er e E3 W ebV iew er

24.1.1 Mudanas no Modo do Viewer

Para que o usurio acesse o E3 no modo Somente Leitura, pelo menos uma destas duas condies deve ser verdadeira: Licena em uso do tipo Viewer Only Usurio logado sem permisso para o item Acesso de escrita ao servidor

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.

24.2 Execuo do E3 Viewer

Existem trs formas de se executar o E3 Viewer: atravs de um servidor local, de um servidor na intranet, ou de um servidor na internet. Nas sees a seguir, estas formas sero detalhadas.

24.2.1 Execuo atravs do E3 Studio

O E3 Viewer pode ser executado atravs da barra de ferramentas Padro:

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

E3 V iew er e E3 W ebV iew er

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.

24.2.2 Execuo atravs da Linha de Comando

O E3 Viewer pode ser acessado via linha de comando da seguinte maneira:
Viewer [nome_do_servidor] [opes]

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

E3 V iew er e E3 W ebV iew er

 -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

Caixa de dilogo de ajuda do Viewer

E3 V iew er e E3 W ebV iew er

481

24.2.3 Execuo atravs do Menu Iniciar

Para rodar uma aplicao cliente, pode-se utilizar o E3 Viewer localizado no seguinte caminho: Menu Iniciar (Start) - Programas (Programs) - Elipse E3 - Viewer. O E3 ento mostra a seguinte caixa de dilogo para que o caminho do servidor da aplicao seja informado:

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.

24.3 Logs do Viewer

O E3 gera logs no formato ETL (Event Trace Log ). Esses arquivos de log so gerenciados por uma ferramenta da Elipse chamada Elipse Event Log Viewer, disponvel com a instalao do E3. Com essa ferramenta possvel visualizar os arquivos e gerenciar o espao que estes ocupam em disco, entre outros. Para mais informaes sobre a ferramenta Elipse Event Log Viewer, consulte o Manual do Usurio do Elipse Event Log, disponvel no menu Iniciar - Programas Elipse Software - Elipse Event Log. O aplicativo Elipse Event Log Viewer pode ser aberto de trs formas: Pelo menu Iniciar - Programas - Elipse Software - Elipse Event Log - Log Viewer Pelo menu Ferramentas - Log Viewer do E3 Studio Pelo item Atalhos - Log Viewer do menu do E3 Admin na rea de Notificao do Windows

482

E3 V iew er e E3 W ebV iew er

24.4 Execuo do E3 WebViewer

Durante a instalao do E3 WebViewer, os arquivos e3web.asp, e3web2.asp, docwrite.asp, docwrite2.asp e e3downloader.cab ficam disponveis para configurao pelo usurio. Estes arquivos ficam localizados no diretrio onde o E3 foi instalado, na pasta WEB. e3web.asp e docwrite.asp: tm a funo de carregar e iniciar o ActiveX E3Downloader e3downloader.cab: ActiveX que ser enviado para a mquina cliente e far a instalao do e3-w2kwebviewer.exe e3web2.asp e docwrite2.asp: tm a funo de carregar e iniciar o ActiveX do WebViewer que mostrar a aplicao sendo executada na mquina do Internet Explorer

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'>

E3 V iew er e E3 W ebV iew er

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.

24.4.1 Internet Information Services

Tanto para a visualizao na internet como para visualizao em intranet ou mquina local, a partir da verso 3.0 necessria a instalao e configurao do IIS (Internet Information Services), ou outro servidor de internet. O IIS fornecido juntamente com o Windows. Para instal-lo e configur-lo, siga estes procedimentos: 1. Abra o Painel de Controle (Control Panel). 2. Acesse a opo Adicionar programas (Add/Remove Programs). 3. Clique em Adicionar um componente do Windows (Add/Remove Windows Component).

484

E3 V iew er e E3 W ebV iew er

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.

24.4.2 Visualizao na Aplicao Cliente

Se o servidor estiver utilizando o servidor Web, por exemplo o IIS, basta digitar na barra de endereos do browser o endereo ou IP do servidor (por exemplo, http://nomedoservidor/ diretorio_virtual ou http://192.0.0.21/diretorio_virtual ), onde diretorio_virtual o diretrio criado na configurao do IIS (conforme o Guia de Instalao do E3 ). No primeiro acesso ao servidor, o navegador vai iniciar a instalao dos componentes, caso E3 V iew er e E3 W ebV iew er 485

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

E3 V iew er e E3 W ebV iew er

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.

25.1 Configurando o Hot-Standby

As configuraes que devero ser feitas para implementar o Hot-Standby so as seguintes: 1. Localize o caminho dos arquivos de Domnio (arquivos .dom, .prj, .lib, etc.) no computador principal e copie esta pasta para o computador Standby. Caso tenha sido indicado um caminho diferente para os arquivos de Domnio na opo Pasta raiz dos arquivos do Domnio , na aba Servidores, deve-se utilizar este caminho para a cpia. 2. Os arquivos de bancos de dados devem ser tratados de maneira diferenciada. Para maiores informaes, veja o tpico Utilizando Bancos de Dados com Hot-Standby. 3. Acesse o cone do E3 Admin Domnio - Opes. na rea de Notificaes do Windows e selecione a opo

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

25.2 Executando um Domnio Redundante

Para executar um Domnio redundante, necessrio apenas iniciar um dos seus servidores; os outros servidores sero automaticamente iniciados por este primeiro servidor. Para iniciar um Domnio, crie um atalho para o E3 Admin com a seguinte linha de comando:
E3Admin.exe start <Caminho_do_Domnio>

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 .

25.3 Parando um Domnio Redundante

Um Domnio pode ser parado por qualquer um dos seus servidores, atravs do cone na rea de Notificaes do Windows. Escolha a opo Domnio - Parar e o servidor Ativo e o Standby terminaro o processo E3Run. O Domnio pode ser reiniciado escolhendo a opo Domnio - Executar. Se for escolhida a opo Domnio - Fechar, o Domnio ser parado e fechado, ficando os E3 Servers disponveis para rodar outros Domnios.

IMPORTANTE: As opes de parar e fechar um Domnio AFETAM TODOS OS SERVIDORES DO DOMNIO, e no apenas o servidor onde o comando executado.

25.4 Parando um dos Servidores do Domnio

A maneira correta de parar um dos servidores do Domnio marc-lo como Em manuteno na configurao Domnio - Opes, aba Servidores, do Domnio. Se o servidor ativo for colocado em manuteno, o servidor Standby ir passar para o estado ativo. Para recolocar o servidor no Domnio, desmarque a opo Em manuteno deste servidor.

25.5 Tempo de Troca entre Servidores

O tempo padro para o servidor de backup assumir, quando ocorre uma falha do servidor ativo, de 15 segundos. No entanto, possvel configurar este tempo atravs do item Tempo para ativao do servidor reserva (conforme explicado no tpico Opes do Domnio do captulo Domnios). Este tempo permite que o servidor anterior termine a execuo do aplicativo (caso a falha seja apenas de rede). O tempo configurado afeta diretamente o timeout do ping entre os servidores. Se ficar muito baixo (troca em 1 segundo, timeout de ping igual a 160 ms), podem ocorrer trocas espontneas de servidor, causadas por pequenas falhas de rede.

25.6 Reconexo de Viewers

Quando h uma troca de servidores, os Viewers entram em processo de reconexo, tentando alternadamente conectar com o servidor backup e com o ativo. O usurio tem a opo de esperar o fim do processo de reconexo com o Viewer atual, cancelar a reconexo (e fechar o Viewer) ou abrir uma nova sesso Viewer com o novo servidor.

Hot-Standby

491

25.7 Utilizando Bancos de Dados com Hot-Standby

Pode-se ter dois servidores rodando separadamente numa mesma aplicao. Um deles fica ativo, enquanto o outro fica em estado de espera (standby), aguardando uma possvel falha. O Hot-Standby garante a continuidade da aplicao, mas quando se utiliza bancos de dados, tambm tem-se que garantir a continuidade do acesso base de dados. H duas maneiras de resolver este problema. Na primeira, ambas as aplicaes acessam uma mesma base de dados. Habilita-se o acesso ao banco de dados na aplicao, configurando o objeto DBServer em ambos servidores (Principal e Standby) com os mesmos parmetros de localizao do banco de dados na rede. Para garantir a continuidade do sistema, importante que a base de dados esteja em uma mquina separada, acessvel aos dois servidores. Na segunda maneira, a gravao dos dados feita em bases diferentes. Neste caso, o ideal ter-se os dois bancos de dados rodando localmente, em ambos os servidores. Assim, garantese que o acesso ao banco de dados estar sempre disponvel, pois a mquina que roda a aplicao tambm roda o banco de dados. Uma opo interessante nesse caso o sincronismo entre as diferentes bases de dados da aplicao principal e da secundria. A propriedade EnableSynchronization do objeto DBServer habilita esse recurso na aplicao. Quando ela est ativa, todos os dados gravados na base principal so atualizados na base em Standby quase instantaneamente.

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

Configura es Avan adas

493

27

CAPTULO

Dvidas mais Frequentes

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.

27.1 Ordem dos Tabs

Qual a relao entre a ordem de criao dos objetos na Tela e a ordem de tabulao em tempo de execuo? Quando um novo objeto criado na Tela, atribui-se a ele a primeira posio na ordem de tabulao, e ele ordenado em sequncia decrescente em relao aos demais objetos da Tela. Para maiores informaes sobre este assunto, veja o tpico Ordem de Navegao entre os Objetos, do captulo Telas e Objetos de Tela.

27.2 Sobreposio de Animaes nos Objetos

Criei uma Animao com Rotao ou Translao na Tela, mas decidi mud-la, criando uma nova Animao. No entanto, quando fui executar a aplicao, o objeto apareceu com a Animao inicial, e no com a Animao corrente. Por qu isto ocorre? POSSVEL CAUSA A nova Animao foi criada sem que a anterior tenha sido removida. SOLUO Para solucionar esta questo, siga estes procedimentos: 1. Selecione o objeto que deseja mudar a Animao. 2. Clique com o boto direito do mouse sobre ele e selecione a opo Remover animao. 3. Aplique a Animao desejada.

NOTA : No tente remover a Animao do objeto atravs do Organizer, pois esta ao ir remover o objeto.

494

Dvidas mais Frequentes

27.3 Objetos de Tela

No consigo rotacionar uma figura inserida atravs da Galeria. Por qu isto ocorre? Deve-se converter o objeto em smbolo. Isto permite que sejam utilizados os comandos e opes disponveis aos objetos que so nativos do E3, como por exemplo, o uso da Rotao.

27.4 Servidor de Banco de Dados SQL Server

A seguir so listados os possveis erros que podem ocorrer ao se testar a conexo com este Banco de Dados: ErrorLocal = Open Connection ErrorError #0x80004005 Description:[DBNETLIB] [ConnectionOpen(Connection()).]SQL Server does not exist or access denied. (Source: Microsoft OLE DB Provider for SQL Server) (SQL State: 08001)(NativeError:17) POSSVEL CAUSA Nome do Servidor errado na configurao do ServidorDB ou o usurio no tem acesso quele banco. SOLUO Verificar o nome do servidor utilizado e se o usurio possui permisso para conectar-se quele banco. ErrorLocal = Open Connection ErrorError #0x80040E4D Description: Login failed for user 'UsuarioErrado'.(Source: Microsoft OLE DB Provider for SQL Server) (SQL State: 42000) (NativeError: 18456) POSSVEL CAUSA Erro no nome do usurio ou senha. SOLUO Utilize um usurio cadastrado no banco de dados ou verifique a senha utilizada. ErrorLocal = ExecuteSql ErrorError #0x80040E14 Description: There is already an object named 'E3Index' in the database. (Source: Microsoft OLE DB Provider for SQL Server) (SQL State: 42000) (NativeError: 1750) POSSVEL CAUSA J existe um objeto (tabela, chave, ndice, etc.) no Banco de Dados com este mesmo nome.

Dvidas mais Frequentes

495

SOLUO Mudar o nome do objeto.

27.5 Servidor de Banco de Dados Oracle

A seguir sero listados os possveis erros que podem ocorrer ao se testar a conexo com este Banco de Dados: Error = ORA-01017: invalid username/password; logon denied POSSVEL CAUSA Mensagem gerada em log quando a senha ou o usurio est incorreto. SOLUO Verificar se o usurio existe e se a senha utilizada est correta. Error = ORA-12154: TNS: no foi possvel resolver nome de servio POSSVEL CAUSA A conexo cliente utilizada no foi encontrada. SOLUO Verificar se a conexo utilizada est criada no computador e se ela est funcionando atravs dos softwares utilitrios de rede do Oracle. Error = ORA-02264: nome j usado por uma restrio existente POSSVEL CAUSA J existe um objeto no Banco de Dados com este mesmo nome. SOLUO Para evitar esse erro, crie e configure diferentes nomes de ndices ou chaves primrias no E3. Error = ORA-01403: dados no encontrados POSSVEL CAUSA Esta mensagem gerada quando uma pesquisa interna do E3 procura por objetos no Banco de Dados e no os encontra (por exemplo, a tabela de Histricos no existe, deve ser criada).

496

Dvidas mais Frequentes

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.

27.6 Servidor de Dados

A propriedade Retentive do Tag Interno no est funcionando, pois ela no guarda o ltimo valor ao parar o Domnio. O qu pode estar errado? A propriedade Retentive no tem este objetivo. Ela tem utilidade apenas em aplicaes hotstandby, para manter o valor do Tag Interno quando houver uma troca de servidor. Como salvar o valor de um Tag Interno ao parar o Domnio? Use o mtodo Save do Servidor de Dados.

Dvidas mais Frequentes

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.

27.7 Drivers de Comunicao

O que tenho que fazer para usar os bits de um Tag de Comunicao? Para usar os bits de um Tag de Comunicao, deve-se habilitar a propriedade UseBitFields do Tag. Como so contados os Tags Bloco e os bits dos Tags no E3? A contagem considera os Tags de Comunicao e o tamanho dos Blocos de Comunicao. Os bits no entram na contagem. Qual a maneira mais fcil de fazer piscar a cor de um objeto na Tela quando houver um erro de comunicao? Crie uma Associao Digital entre a propriedade ForegroundColor do objeto e a expresso NomeDoTag.Quality < 192 , com a opo de pisca habilitada. A propriedade Quality representa o estado da qualidade do valor do Tag, no padro OPC, e pode variar de 0 a 255, sendo que a qualidade boa apenas acima de 192. Como sinalizar erros de comunicao na Tela? Habilite a opo Erros de Comunicao no objeto Viewer, na aba Erros de Comunicao. Como trocar a cor padro dos erros de comunicao em Setpoints e Displays? Acesse o objeto Viewer e altere a cor desejada, na aba Erros de Comunicao.

498

Dvidas mais Frequentes

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.

Dvidas mais Frequentes

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

Dvidas mais Frequentes

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.

Dvidas mais Frequentes

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

Dvidas mais Frequentes

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.

Dvidas mais Frequentes

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

Dvidas mais Frequentes

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

Dvidas mais Frequentes

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.

27.17 Domnios e Projetos

O qu acontece com os eventos gerados pelo E3 Server enquanto o Domnio no est rodando? Sempre que o registro de eventos estiver habilitado, o E3 Server vai colocar os eventos gerados na lista interna de eventos (em memria). Esta lista esvaziada em trs situaes: Se existe um E3Run rodando localmente (isto , o E3 Server est em estado HOT), os eventos da lista so enviados para o E3Run para serem gravados no Banco de Dados. Se a gravao funcionar, os eventos gravados so removidos da lista Se existe outro E3 Server rodando em estado HOT no Domnio, as mensagens sero enviadas para este E3 Server Se o Domnio for fechado, todas as mensagens que ainda no foram gravadas so descartadas Utilizei o E3 Admin via linha de comando e apareceu um erro. Por qu isto ocorreu? Muitas vezes, quando se utiliza o E3 Admin via linha de comando, pode-se configurar algum parmetro errado, o que acaba provocando uma mensagem de erro. As mensagens de erro que podem aparecer so as seguintes: O Domnio no pde ser aberto porque o arquivo 'nomedoarquivo.dom' somente para leitura Esta mensagem aparece quando o arquivo de Domnio somente de leitura (read-only ) As opes no so vlidas ou o nome do Domnio no est correto. Verifique as opes informadas e se o Domnio existe Esta mensagem aparece quando for informada uma opo inexistente, um nome de Domnio inexistente ou quando o arquivo do Domnio no for localizado, provavelmente por ter sido informado um caminho invlido para o Domnio

Dvidas mais Frequentes

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.

27.18 Stored Procedure

Como executo uma Stored Procedure no E3? A maneira mais fcil criando uma Consulta no E3 com o comando para executar a Stored Procedure desejada passando, se necessrio, valores para ela. O comando que deve ser configurado nesta Consulta o seguinte:
Exec NomeDaStoredProcedure <%var1%>, <%var2%>, ...

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 .

NOTA : A propriedade CursorLocation da Consulta do E3 dever estar configurada como 1 clClient.

27.19 Domnios Remotos

Como funciona o licenciamento dos Domnios Remotos? 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 508 Dvidas mais Frequentes

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.

Dvidas mais Frequentes

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).

Dvidas mais Frequentes

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

Consulte nosso website para informaes sobre o representante do seu estado.

w w w .elipse.c om.br elipse@elipse.c om.br