E3manual BR

MANUAL DO USURIO
2008 Elipse Software Ltda. Todos os direitos reservados. 19/12/2008 - Verso 3.1
Sumrio
1. 1.1. 1.2. 1.3. 1.4. 2. 2.1. 2.2. 2.3. INTRODUO ........................................................................................................................................................... 11 DESCRIO GERAL ............................................................................................................................................... 12 ARQUITETURA DO E3 ............................................................................................................................................ 13 DIAGRAMA DE BLOCOS.......................................................................................................................................... 16 ESTRUTURA DE DOMNIO ....................................................................................................................................... 17 E3 STUDIO ................................................................................................................................................................. 19 INICIANDO UM PROJETO ......................................................................................................................................... 20 REA DE TRABALHO .............................................................................................................................................. 20 CONFIGURAO DO E3 STUDIO ............................................................................................................................. 21 2.3.1. Aparncia do E3 Studio......................................................................................................................... 21 2.3.2. Outras configuraes ............................................................................................................................ 26 2.4. BARRA DE FERRAMENTAS ..................................................................................................................................... 29 2.4.1. Verificar Domnio................................................................................................................................... 33 2.4.2. Procurar/Substituir................................................................................................................................. 34 2.4.3. Documentao de Scripts ..................................................................................................................... 36 2.4.4. Relatrio de verses ............................................................................................................................. 40 2.4.5. WatchWindow ....................................................................................................................................... 41 2.5. ORGANIZER .......................................................................................................................................................... 42 2.6. IMPORTAO E EXPORTAO ................................................................................................................................ 47 2.6.1. Arquivo CSV.......................................................................................................................................... 48 2.6.2. Importao e exportao de objetos ..................................................................................................... 49 2.6.3. Modelos................................................................................................................................................. 52 2.6.4. Gerenciador de modelos ....................................................................................................................... 56 2.6.5. Importao de objetos do Elipse SCADA para o E3 ............................................................................. 64 2.6.6. Importao e exportao de associaes ............................................................................................. 70 2.6.7. Importao e exportao de colees e seus itens............................................................................... 71 2.6.8. Logs e Relatrios de Falhas .................................................................................................................. 72 2.7. LISTA DE PROPRIEDADES ...................................................................................................................................... 73 2.8. GALERIA ............................................................................................................................................................... 73 2.9. APPBROWSER ...................................................................................................................................................... 74 2.9.1. Acessando o AppBrowser a partir de um script..................................................................................... 75 2.9.2. Acessando o AppBrowser a partir de uma associao ......................................................................... 76 2.9.3. Acessando o AppBrowser a partir de uma propriedade ........................................................................ 77 2.10. CONECTAR A ................................................................................................................................................. 77 3. 3.1. 3.2. DOMNIOS.................................................................................................................................................................. 81 COMPONENTES DO DOMNIO ................................................................................................................................. 83 CRIANDO UM DOMNIO........................................................................................................................................... 84 3.2.1. Assistente de Aplicaes do E3 ............................................................................................................ 85 3.3. CONFIGURAES DE DOMNIO .............................................................................................................................. 91 3.3.1. Opes .................................................................................................................................................. 92 3.3.2. Segurana ............................................................................................................................................. 95 3.3.3. Grupos de Viewers ................................................................................................................................ 96 3.3.4. Registro de Eventos .............................................................................................................................. 98 3.3.5. Projetos ............................................................................................................................................... 106 3.3.6. Servidores ........................................................................................................................................... 107 3.3.7. Domnios Remotos .............................................................................................................................. 109 3.4. OUTRAS OPES DA REA DE NOTIFICAO ....................................................................................................... 110 3.4.1. Licenas .............................................................................................................................................. 111 3.4.2. Estatsticas .......................................................................................................................................... 112 3.4.3. Monitor ................................................................................................................................................ 113 3.4.4. Inicializao......................................................................................................................................... 114 3.4.5. Impressora .......................................................................................................................................... 114 3.4.6. Sobre E3 Admin .................................................................................................................................. 115 3.4.7. Parar / Iniciar E3 Server ...................................................................................................................... 115 3.4.8. Fechar E3 Admin................................................................................................................................. 115 3.5. DOMNIOS REMOTOS ........................................................................................................................................... 116 3.5.1. Configurao da conexo ................................................................................................................... 116 3.5.2. Licenas .............................................................................................................................................. 117
3.5.3. Sintaxe dos links ................................................................................................................................. 117 3.5.4. Permisses de acesso ........................................................................................................................ 118 3.5.5. Hot-Standby ........................................................................................................................................ 119 3.5.6. Gerenciamento da conexo ................................................................................................................ 120 3.5.7. Desconexo ........................................................................................................................................ 120 3.6. GERANDO LOGS NO E3 ....................................................................................................................................... 121 4. 4.1. DRIVERS.................................................................................................................................................................. 123 DRIVER DE COMUNICAO .................................................................................................................................. 123 4.1.1. Configurao dos Drivers de Comunicao ........................................................................................ 125 4.1.2. Funcionamento dos Drivers de Comunicao..................................................................................... 126 4.1.3. Pasta de Comunicao ....................................................................................................................... 130 4.1.4. Tag de Comunicao .......................................................................................................................... 131 4.1.5. Bloco de Comunicao ....................................................................................................................... 132 4.1.6. Elementos de Bloco ............................................................................................................................ 134 4.2. SERVIDOR OPC .................................................................................................................................................. 135 4.3. DRIVER DE COMUNICAO OPC ......................................................................................................................... 136 4.3.1. Configurao dos Drivers OPC ........................................................................................................... 139 4.3.2. Grupo de tags OPC............................................................................................................................. 145 4.3.3. Pasta OPC .......................................................................................................................................... 146 4.3.4. Tag de Comunicao OPC ................................................................................................................. 147 4.3.5. Bloco de Comunicao OPC............................................................................................................... 149 4.3.6. Elemento de Bloco OPC ..................................................................................................................... 150 4.4. QUALIDADE ......................................................................................................................................................... 151 4.4.1. Campo SubStatus ............................................................................................................................... 152 4.4.2. Campo Limite ...................................................................................................................................... 155 5. 5.1. 5.2. 5.3. 5.4. 5.5. 6. 6.1. 6.2. SERVIDOR DE DADOS ........................................................................................................................................... 157 PASTA DE D ADOS ............................................................................................................................................... 157 TAG CONTADOR .................................................................................................................................................. 158 TAG DEMO.......................................................................................................................................................... 160 TAG INTERNO ..................................................................................................................................................... 161 TAG TIMER ......................................................................................................................................................... 162 TELAS E OBJETOS DE TELA ................................................................................................................................ 165 TELA .................................................................................................................................................................. 165 OBJETOS DE TELA .............................................................................................................................................. 167 6.2.1. Linha ................................................................................................................................................... 168 6.2.2. Retngulo............................................................................................................................................ 168 6.2.3. Retngulo Arredondado ...................................................................................................................... 168 6.2.4. Elipse .................................................................................................................................................. 168 6.2.5. Arco de Elipse ..................................................................................................................................... 169 6.2.6. Desenho Livre ..................................................................................................................................... 169 6.2.7. Polgono .............................................................................................................................................. 169 6.2.8. Polgono de Curvas............................................................................................................................. 170 6.2.9. Figura .................................................................................................................................................. 170 6.2.10. Texto ................................................................................................................................................... 171 6.2.11. Display ................................................................................................................................................ 171 6.2.12. SetPoint............................................................................................................................................... 172 6.2.13. Escala ................................................................................................................................................. 172 6.3. CONFIGURAES GERAIS ................................................................................................................................... 172 6.3.1. Alinhamento ........................................................................................................................................ 172 6.3.2. Grade .................................................................................................................................................. 173 6.3.3. Rotacionar........................................................................................................................................... 174 6.3.4. Ordem de navegao entre os objetos ............................................................................................... 175 6.3.5. Agrupar / Desagrupar.......................................................................................................................... 175 6.3.6. Animao ............................................................................................................................................ 175 6.3.7. Sobreposio de objetos ..................................................................................................................... 177 6.3.8. Zoom ................................................................................................................................................... 177 6.3.9. Camadas............................................................................................................................................. 177 6.3.10. Travar .................................................................................................................................................. 179 6.3.11. Ponto ncora ...................................................................................................................................... 179 6.3.12. Sombreamento.................................................................................................................................... 180 6.3.13. Desenho.............................................................................................................................................. 181 6.3.14. Configurar como Padro ..................................................................................................................... 182 6.3.15. Aplicar Estilo ....................................................................................................................................... 183 6.4. FORMATAO DE CORES .................................................................................................................................... 183
6.5. 7. 7.1. 8. 9. 9.1. 9.2. 9.3. 9.4. 9.5. 9.6. 9.7. 10.
FORMATAO DE VALORES ................................................................................................................................. 185 6.5.1. Outros Formatos ................................................................................................................................. 186 ACTIVEX .................................................................................................................................................................. 191 OBJETOS MICROSOFT FORMS ............................................................................................................................. 193 QUADROS ............................................................................................................................................................... 195 ASSOCIAES ....................................................................................................................................................... 199 CONEXO SIMPLES ............................................................................................................................................. 201 CONEXO BIDIRECIONAL ..................................................................................................................................... 202 CONEXO DIGITAL .............................................................................................................................................. 203 CONEXO A NALGICA......................................................................................................................................... 205 CONEXO POR TABELA ....................................................................................................................................... 205 CONEXO REVERSA............................................................................................................................................ 208 EDIO DE ASSOCIAES ................................................................................................................................... 208 VIEWER ................................................................................................................................................................... 213
10.1. 10.1.1. 10.1.2. 10.1.3. 10.2. 10.3. 10.4. 11.
CONFIGURAO DO VIEWER ........................................................................................................................ 213 Visualizador......................................................................................................................................... 213 Configurao ....................................................................................................................................... 215 Erros de Comunicao ........................................................................................................................ 217 VARIVEIS NO VIEWER ................................................................................................................................. 218 OBJETO _TOP .............................................................................................................................................. 218 PASTA DO VIEWER ....................................................................................................................................... 219
BANCO DE DADOS................................................................................................................................................. 221 11.1. 11.2. 11.2.1. 11.2.2. 11.2.3. 11.2.4. 11.3. 11.3.1. 11.3.2. 11.3.3. 11.4. BANCO DE DADOS ACCESS .......................................................................................................................... 222 BANCO DE DADOS ORACLE .......................................................................................................................... 223 Acessando o Banco de Dados Oracle dentro do E3 ........................................................................... 223 Acessando o Banco de Dados Oracle via Scripts ............................................................................... 224 Tecnologias utilizadas pelo E3 para o acesso ao Banco de Dados Oracle......................................... 225 Acessando o Oracle via Servidor BD .................................................................................................. 225 BANCO DE DADOS SQL SERVER .................................................................................................................. 227 Acessando o Banco de Dados SQL Server dentro do E3 ................................................................... 227 Exemplo de utilizao do SQL Server 2000 ........................................................................................ 228 Uso de ADODB para acesso via Script ............................................................................................... 229 OBJETOS DO E3 E PERMISSES ................................................................................................................... 229
12.
ALARMES ................................................................................................................................................................ 231 12.1. CONFIGURAO DE ALARMES ...................................................................................................................... 231 12.1.1. reas de Alarme.................................................................................................................................. 232 12.1.2. Fontes de Alarme ................................................................................................................................ 233 12.2. SERVIDOR DE ALARMES ............................................................................................................................... 239 12.2.1. Configuraes para gerao da Tabela de Alarmes ........................................................................... 240 12.2.2. Configuraes dos Campos do Usurio .............................................................................................. 247
13.
E3ALARM ................................................................................................................................................................ 249 13.1. CONFIGURAES DO E3ALARM ................................................................................................................... 250 13.1.1. Configuraes Gerais.......................................................................................................................... 250 13.1.2. Configuraes de Colunas .................................................................................................................. 251 13.1.3. Ordenao de Campos ....................................................................................................................... 253 13.1.4. Configurao de Cores ....................................................................................................................... 254 13.1.5. Configurao de Fontes ...................................................................................................................... 257 13.2. CARACTERSTICAS ESPECFICAS DE RUNTIME ............................................................................................... 257 13.2.1. Visualizando os Alarmes ..................................................................................................................... 257 13.2.2. Reconhecimento de Alarmes .............................................................................................................. 258 13.2.3. Ordenao de Colunas ....................................................................................................................... 259
14.
HISTRICOS ........................................................................................................................................................... 261 14.1. CONFIGURAES DO HISTRICO ................................................................................................................. 263 14.1.1. Chave Primria.................................................................................................................................... 263 14.1.2. ndices ................................................................................................................................................. 265 14.1.3. Configuraes da Tabela .................................................................................................................... 267
15.
STORAGE ................................................................................................................................................................ 273 15.2. CONFIGURAES DO STORAGE ................................................................................................................... 275 15.3. CONFIGURAO DA TABELA ......................................................................................................................... 277 15.3.1. Execuo ............................................................................................................................................ 280 15.3.2. Ferramentas de Consultas Internas (Query) ....................................................................................... 281 15.3.3. Utilizao............................................................................................................................................. 283 15.3.4. Ferramentas de Consultas Externas (Stored Procedures).................................................................. 283
16.
CONSULTAS ........................................................................................................................................................... 289 16.1. 16.2. 16.3. 16.4. 16.5. 16.6. 16.7. 16.8. CRIANDO UMA CONSULTA ............................................................................................................................ 290 FUNES GERAIS ........................................................................................................................................ 292 TABELAS ..................................................................................................................................................... 293 COLUNAS .................................................................................................................................................... 294 SINTAXE SQL .............................................................................................................................................. 296 RESULTADO DA CONSULTA .......................................................................................................................... 296 USO DOS FILTROS DA CONSULTA ATRAVS DE SCRIPTS ................................................................................ 296 USO DE RECORD SETS DE UMA CONSULTA ATRAVS DE SCRIPTS ................................................................. 297
17.
E3BROWSER .......................................................................................................................................................... 299 17.1. OBJETO CONSULTA NO E3BROWSER ........................................................................................................... 300 17.2. OUTRAS CONFIGURAES DO E3BROWSER ................................................................................................. 301 17.2.1. Configuraes de Estilo ...................................................................................................................... 301 17.2.2. Configurao de Atualizao dos Dados ............................................................................................ 303 17.2.3. Configurao das cores do E3Browser ............................................................................................... 304 17.2.4. Configuraes da Fonte do E3Browser .............................................................................................. 304
18.
E3CHART................................................................................................................................................................. 307 18.1. CONFIGURAES DO E3C HART ................................................................................................................... 308 18.1.1. Configuraes Gerais do E3Chart ...................................................................................................... 308 18.1.2. Configurao dos Eixos do E3Chart ................................................................................................... 310 18.1.3. Configuraes das Penas ................................................................................................................... 313 18.1.4. Configuraes da Legenda ................................................................................................................. 322 18.1.5. Configuraes das Consultas ............................................................................................................. 325 18.1.6. Configurao das Fontes .................................................................................................................... 325 18.2. EXEMPLOS DE UTILIZAO DO E3CHART ...................................................................................................... 326 18.2.1. Habilitando e desabilitando penas no E3Chart ................................................................................... 326 18.2.2. Atualizando o E3Chart histrico com os dados da ltima hora ........................................................... 327 18.2.3. Habilitando/desabilitando a visualizao da pena no E3Chart ............................................................ 329 18.2.4. Criao de uma pena por script .......................................................................................................... 330 18.3. CARACTERSTICAS ESPECFICAS DE RUNTIME .............................................................................................. 331
19.
E3PLAYBACK ......................................................................................................................................................... 335 19.1. 19.2. 19.3. 19.4. 19.4.1. 19.4.2. 19.4.3. 19.4.4. 19.4.5. 19.5. 19.5.1. 19.5.2. 19.6. 19.6.1. 19.6.2. 19.6.3. 19.6.4. INTRODUO ............................................................................................................................................... 335 E3PLAYBACK ............................................................................................................................................... 335 ADICIONAR PLAYBACK AO DEMO DO E3 ....................................................................................................... 336 INTERFACE DE USURIO DO E3PLAYBACK .................................................................................................... 340 Barra de Ferramentas ......................................................................................................................... 340 Linha de Tempo .................................................................................................................................. 343 rea de Telas ...................................................................................................................................... 344 Lista de Eventos.................................................................................................................................. 347 Lista de Tags....................................................................................................................................... 348 BANCO DE DADOS DE PLAYBACK ................................................................................................................. 349 Montagem do Banco de Dados ........................................................................................................... 349 Consultas de Dados de Playback ....................................................................................................... 350 CONFIGURAO DOS OBJETOS DE BANCO DE DADOS DO E3 ........................................................................ 352 Storage ............................................................................................................................................... 352 Alarmes ............................................................................................................................................... 352 Histricos ............................................................................................................................................ 354 Licenciamento ..................................................................................................................................... 355
20.
FRMULAS ............................................................................................................................................................. 357 20.1. 20.2. 20.3. 20.4. CONFIGURAES DA FRMULA .................................................................................................................... 358 TEMPLATES ................................................................................................................................................. 359 UNIDADES ................................................................................................................................................... 361 CONJUNTO DE VALORES .............................................................................................................................. 362
20.5. 21.
EXEMPLO DE CRIAO DE UMA FRMULA ..................................................................................................... 363
BIBLIOTECAS ......................................................................................................................................................... 371 21.1. GALERIA ...................................................................................................................................................... 372 21.2. BIBLIOTECA DO USURIO - ELIPSEX.............................................................................................................. 373 21.2.1. XControls ............................................................................................................................................ 375 21.2.2. XObject ............................................................................................................................................... 376 21.3. QUANDO CRIAR UM ELIPSEX ........................................................................................................................ 380
22.
RELATRIOS .......................................................................................................................................................... 381 22.1. 22.2. 22.2.1. 22.2.2. 22.2.3. 22.2.4. 22.2.5. 22.2.6. 22.3. 22.3.1. 22.3.2. 22.3.3. 22.3.4. 22.3.5. 22.4. 22.4.1. 22.4.2. 22.4.3. 22.4.4. 22.4.5. 22.4.6. 22.4.7. 22.4.8. 22.4.9. 22.4.10. 22.4.11. 22.4.12. 22.5. 22.6. OBJETO CONSULTA ..................................................................................................................................... 381 COMPONENTES DO RELATRIO .................................................................................................................... 382 Report Header ..................................................................................................................................... 382 Report Footer ...................................................................................................................................... 382 Page Header ....................................................................................................................................... 383 Page Footer ........................................................................................................................................ 383 Group Header, Group Footer .............................................................................................................. 383 Detail ................................................................................................................................................... 383 CONFIGURAES DO RELATRIO ................................................................................................................. 383 Preview ............................................................................................................................................... 387 Report Settings.................................................................................................................................... 388 Script Editor......................................................................................................................................... 391 Carregar Arquivo RPX......................................................................................................................... 392 Salvar Arquivo RPX............................................................................................................................. 392 OBJETOS DO RELATRIO ............................................................................................................................. 392 Linha ................................................................................................................................................... 392 Retngulo ............................................................................................................................................ 393 Retngulo Arredondado ...................................................................................................................... 393 Elipse .................................................................................................................................................. 393 Texto ................................................................................................................................................... 394 Figura .................................................................................................................................................. 394 Campo de Dados ................................................................................................................................ 394 Caixa de seleo................................................................................................................................. 395 Cdigo de barras ................................................................................................................................. 395 E3Chart ............................................................................................................................................... 396 Quebra de Pgina ............................................................................................................................... 396 Quadro ................................................................................................................................................ 397 CRIANDO UM RELATRIO NO E3 ................................................................................................................... 397 EXEMPLOS DE UTILIZAO NOS RELATRIOS ............................................................................................... 399
23.
SEGURANA........................................................................................................................................................... 403 23.1. 23.2. 23.3. 23.4. USURIOS ................................................................................................................................................... 404 GRUPOS ...................................................................................................................................................... 407 PERMISSES ............................................................................................................................................... 409 PROTEO DE ARQUIVOS ............................................................................................................................. 413
24.
E3 VIEWER E E3 WEBVIEWER .............................................................................................................................. 417 24.1. 24.1.1. 24.2. 24.2.1. 24.2.2. 24.2.3. 24.3. 24.4. 24.4.1. 24.4.2. VIEWER ONLY (MODO SOMENTE LEITURA) ................................................................................................... 418 Mudanas no modo do Viewer ............................................................................................................ 419 EXECUO DO E3 VIEWER........................................................................................................................... 419 Execuo atravs do E3 Studio .......................................................................................................... 419 Execuo atravs da Linha de Comando............................................................................................ 420 Execuo atravs do Menu Iniciar ...................................................................................................... 421 LOGS DO VIEWER ........................................................................................................................................ 422 EXECUO DO E3 W EBVIEWER ................................................................................................................... 422 Internet Information Services .............................................................................................................. 424 Visualizao na aplicao Cliente ....................................................................................................... 425
25.
HOT-STANDBY........................................................................................................................................................ 427 25.1. 25.2. 25.3. 25.4. 25.5. 25.6. 25.7. CONFIGURANDO O HOT-S TANDBY ................................................................................................................ 428 EXECUTANDO UM DOMNIO REDUNDANTE ..................................................................................................... 430 PARANDO UM DOMNIO REDUNDANTE .......................................................................................................... 431 PARANDO UM DOS SERVIDORES DO DOMNIO ............................................................................................... 431 TEMPO DE TROCA ENTRE SERVIDORES ........................................................................................................ 431 RECONEXO DE VIEWERS ............................................................................................................................ 431 UTILIZANDO BANCO DE D ADOS COM HOT-STANDBY ...................................................................................... 432
26.
CONFIGURAES AVANADAS .......................................................................................................................... 433 26.1. 26.1.1. 26.1.2. 26.1.3. 26.1.4. 26.1.5. 26.1.6. 26.2. 26.2.1. 26.2.2. 26.2.3. 26.3. 26.3.1. 26.3.2. 26.4. 26.4.1. 26.4.2. 26.4.3. CONFIGURAES DO E3 SERVER ................................................................................................................ 433 Leitura do HASP ................................................................................................................................. 433 Desabilitar mltiplas CPUs .................................................................................................................. 433 Definir um timeout para o ping do E3 Server ...................................................................................... 434 Configurar heartbeat de licena .......................................................................................................... 434 Definir porta TCP/IP usada pelo protocolo REC ................................................................................. 434 Definir timeout para o encerramento do E3Run .................................................................................. 435 CONFIGURAES DO E3R UN ....................................................................................................................... 435 Ocultar ou exibir a janela de progresso do E3Run .............................................................................. 435 Filtrar chamadas COM/DCOM ............................................................................................................ 435 Especificar o tamanho da pilha da thread de runtime ......................................................................... 436 CONFIGURAES DO REC ........................................................................................................................... 436 Compactar pacotes do REC................................................................................................................ 436 Definir timeout da conexo REC ......................................................................................................... 437 CONFIGURAES DOS LOGS ........................................................................................................................ 437 Definir tempo mnimo para funes de Log Full .................................................................................. 437 Definir tempo para mensagens de funes trancadas ........................................................................ 437 Habilitar ou desabilitar sees de log.................................................................................................. 438
27.
DVIDAS MAIS FREQENTES .............................................................................................................................. 441 27.1. 27.1.1. 27.1.2. 27.2. 27.3. 27.4. 27.5. 27.6. 27.7. 27.8. 27.9. 27.10. 27.11. 27.12. 27.13. 27.14. 27.15. 27.16. 27.17. 27.18. E3 STUDIO .................................................................................................................................................. 441 Ordem dos Tabs ................................................................................................................................. 441 Sobreposio de animaes nos objetos ............................................................................................ 441 OBJETOS DE TELA ....................................................................................................................................... 442 SERVIDOR DE BANCO DE DADOS SQL SERVER ............................................................................................ 442 SERVIDOR DE BANCO DE DADOS ORACLE .................................................................................................... 443 SERVIDOR DE DADOS .................................................................................................................................. 444 DRIVERS DE COMUNICAO......................................................................................................................... 445 ALARMES..................................................................................................................................................... 446 E3ALARM .................................................................................................................................................... 447 E3BROWSER ............................................................................................................................................... 448 E3CHART .................................................................................................................................................... 448 HISTRICO .................................................................................................................................................. 449 ASSOCIAES ............................................................................................................................................. 449 VIEWER ....................................................................................................................................................... 450 BIBLIOTECAS ............................................................................................................................................... 451 RELATRIOS ................................................................................................................................................ 452 DOMNIOS E PROJETOS ................................................................................................................................ 454 STORED PROCEDURE .................................................................................................................................. 455 DOMNIOS REMOTOS ................................................................................................................................... 455
Convenes
Estas so as convenes utilizadas neste manual:
EXEMPLO SILO6.BMP
Geral
"Agitao" Tela1.Show()
Tank01.High
<nome do arquivo> [Ctrl+Enter]
DESCRIO Nomes de arquivos e outros termos no nvel do sistema operacional so indicados com o tipo de letra Tahoma, em maisculas. Nomes de campos e opes que devem ser procurados na tela, em menus ou nas abas dos objetos so indicados com tipo de letra Tahoma. Caracteres entre aspas devem ser digitados no lugar mencionado, sem a presena das aspas. Partes de programas (scripts) so indicadas com o tipo de letra Courier. Elas devero ser digitadas nos lugares reservados e depois compiladas para a verificao de erros. Caracteres em negrito indicam nomes de objetos do E3 ou suas propriedades. Expresses entre os sinais < e > devem ser substitudas pelo nome do objeto em questo. Expresses entre colchetes indicam nomes de teclas. Quando estiverem acompanhadas de um sinal +, voc deve pressionar a segunda tecla enquanto mantm pressionada a primeira.
Microsoft Windows, Windows NT, Windows XP, Internet Explorer e demais marcas so marcas registradas da Microsoft Corporation.
Captulo
1
1.
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: a) 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; b) Alarmes e Eventos: monitoram o acontecimento de situaes especficas; c) Histricos: armazenam os dados em bancos de dados relacionais; d) Relatrios: permitem visualizar e imprimir os dados, dentre outros mdulos e possibilidades.
Introduo
11
E3 - Manual do Usurio
1.1.
Descrio Geral
O E3 pode ser executado nas plataformas Microsoft Windows XP SP2, Server 2003 SP2, Vista SP1 e Server 2008 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, que so: 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. 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. 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, controles ActiveX). 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
12
Introduo
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;
Introduo
13
O navegador Internet Explorer1 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. All-In-One
Viewer executado na Mquina Cliente
Deve-se tomar cuidado com polticas de segurana para o envio de comandos via Internet, para evitar potenciais riscos de exposio do sistema. Algumas caractersticas devem ser configuradas na aplicao para evitar tais riscos, dependendo das regras das empresas onde tais sistemas so instalados.
14 Introduo
Viewer executado na Mquina Servidora e Acessado via Terminal Service
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.
Introduo
15
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.
Figura 1: 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 encontramse outros servidores, que expem servios utilizados por outros mdulos.
16
Introduo
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.
Introduo
17
Captulo
2
2.
E3 Studio
O E3 Studio o ambiente de desenvolvimento do E3. Nele, possvel a criao e manuteno de Domnios, projetos e bibliotecas.
Figura 2: Caminho indicado pelo sistema quando o E3 instalado
Para iniciar uma aplicao no E3 Studio, siga estes procedimentos: 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 acima, ou acessar o cone do E3, que criado na rea de trabalho, conforme figura a seguir.
Figura 3: cone do E3
A hardkey dever estar conectada na porta de comunicao adequada, no caso de uma edio local, ou a mquina deve estar na mesma rede local que outra com o E3 Server, j previamente instalada e com uma hardkey presente.
E3 Studio 19
2.1.
Iniciando um projeto
Quando o E3 Studio iniciado, o sistema abre uma caixa de dilogo com algumas opes do projeto. Ao iniciar o E3 Studio, aparecero trs opes de trabalho:
Figura 4: Ao iniciar o E3, a janela acima mostrada
As opes disponveis so as seguintes:

Opes disponveis na janela Iniciar o E3 Studio OPO DESCRIO No ser aberto nenhum domnio. Iniciar o E3 Studio Sero requisitados o nome e caminho do novo domnio. Criar um Domnio novo Ao clicar em Outros Arquivos... tem-se a opo de Abrir um Domnio existente localizar um domnio num diretrio especfico, ou escolher na lista um dos ltimos aplicativos editados.
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 se executar o E3 Studio pela primeira vez. Ao utilizar uma interface grfica mais moderna, similar a programas como o Office 2000, 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 novo projeto.
20
E3 Studio
Figura 5: rea de Trabalho
A Barra de Ttulo mostra o caminho e o nome da sua 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 acessar o Menu Visualizar - Personalizar. As opes disponveis deste item so as seguintes: Aba Comandos: Atravs desta opo, pode-se definir os cones de cada uma das Barras de Ferramentas. Para tanto, basta clicar sobre o cone do campo Comandos e arrast-lo para dentro da Barra de Ferramentas desejada.
E3 Studio
21
Figura 6: Aba Comandos

Opes disponveis na aba Comandos DESCRIO Mostra as opes dos menus e barras de ferramentas disponveis no sistema. Mostra os itens que compem o menu ou a Barra de Ferramentas selecionada. Breve descrio da opo selecionada.
OPO Categorias Comandos Descrio
Aba Barra de Ferramentas: Atravs desta opo, pode-se configurar, editar ou criar novas Barras de Ferramentas.
22
E3 Studio
Figura 7: Aba Barra de Ferramentas

Opes disponveis na aba Barra de Ferramentas OPO DESCRIO Lista as opes de barras de ferramentas disponveis Barra de Ferramentas no sistema. Repe a barra de ferramenta desejada no E3. Boto [Repor] Repe todas as Barra de Ferramentas no E3. Boto [Repor tudo] Cria uma nova Barra de Ferramentas. Boto [Nova...] Muda o nome da barra de ferramenta. Esta opo Boto [Mudar o nome] utilizada somente na barra de ferramenta criada pelo usurio atravs do boto [Nova...]. Elimina a barra de ferramentas selecionada. Boto [Eliminar] Mostra legenda nas opes da Barra de Ferramentas Mostrar Legenda selecionada.
Aba Menu: Atravs desta opo, possvel configurar os menus do E3.
E3 Studio
23
Figura 8: Aba Menus

Opes disponveis na aba Menus DESCRIO Exibe o menu pr-definido da aplicao. Essa opo no tem efeito, e mantida no E3 por motivos de compatibilidade do sistema. Repe o menu definido na opo anterior. Essa opo no tem efeito, e mantida no E3 por motivos de compatibilidade do sistema. Seleciona o tipo de animao usada nos menus: Nenhuma (padro), Desdobrar, Deslizar e Fade. Define se o menu apresentar o efeito de sombreado ou no.
OPO Mostra menus para
Boto [Repor]
Animao dos menus Menus com sombra
Aba Aparncia: Atravs desta opo, possvel alterar a aparncia das janelas e barras de ferramentas no E3 Studio.
24
E3 Studio
Figura 9: Aba Aparncia

Opes disponveis na aba Aparncia 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.
OPO Office XP Windows XP Office 2000 Office 2003 VS.Net 2005
Aba Opes: Atravs desta opo possvel configurar as especificaes gerais do projeto. Nesse item possvel habilitar ou desabilitar as opes da Barra de Ferramentas.
E3 Studio
25
Figura 10: Aba Opes

Opes disponveis na aba Opes DESCRIO Habilita o E3 a mostrar uma breve descrio nas opes das barras de ferramentas e menus quando o mouse passa sobre o item. Mostra ou no a tecla de atalho na descrio do boto. Incluir teclas de atalho Habilita cones grandes nas barras de ferramentas. cones grandes OPO Mostrar descries
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:
26
E3 Studio
Figura 11: Configuraes do Editor de Scripts
As opes disponveis deste item so as seguintes:

Opes disponveis na aba Editor OPO DESCRIO Permite ocultar os blocos de cdigo no script. Abrir-e-Fechar blocos do texto Tamanho da margem da marcao do bloco de Tamanho da margem cdigo. Habilita a numerao de linha no editor de scripts. Numerao da linha Tamanho da margem que contm a numerao de Tamanho da margem linha. Determina o nmero de espaos de tabulao. Tamanho do Tab Determina o tipo de fonte a ser usado no editor de Fonte scripts. Determina o tamanho de fonte a ser usado no editor Tamanho de scripts.
NOTA: Feche os editores de scripts abertos para que as modificaes sejam aplicadas. Arquivos: Habilita ou desabilita a opo Ignorar verificao de CRC.
E3 Studio
27
Figura 12: Configuraes de Arquivos
Toda a vez que um projeto ou uma biblioteca criado no E3, o sistema grava internamente um CRC (Cyclic Redundancy Check, Verificao de Redundncia Cclica) dos dados deste arquivo. Cada vez que um arquivo aberto, feita a verificao desse CRC. Caso essa verificao falhe (ou seja, o CRC no coincide 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 realmente 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. 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 do objeto no Organizer, quando a view desse objeto j estiver aberta.
28
E3 Studio
Figura 13: Configuraes do Studio

Opes disponveis na aba Studio DESCRIO Ativa a view de Scripts na ocorrncia de um duploclique. Abre a Janela de Propriedades na ocorrncia de um Abrir a Janela de Propriedades duplo-clique. OPO Ativar a view de Scripts
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 chamar o Organizer simplesmente pressionando um boto. A tabela abaixo mostra as opes disponveis nas Barras de Ferramentas do E3 Studio:
Opes disponveis na barra de ferramentas Padro COMANDO AO Cria um novo projeto. Novo Abre um projeto existente. Abrir projeto Salvar Salvar tudo
E3 Studio
ICONE
Salva o projeto. Salva todo o Domnio.
29
ICONE
COMANDO Recortar Copiar Colar Desfazer Refazer Organizer Galeria Lista de Propriedades Mostrar no Editor Mostrar no Organizer Executar aplicativo Rodar/Parar Domnio Executar/Parar E3 Viewer Verificar Domnio Erro anterior Prximo erro Sobre Desfragmentar arquivos Procurar/Substituir Documentao de scripts Relatrio de verses WatchWindow
AO Remove a informao selecionada e a transporta para a rea de transferncia. Copia a informao selecionada e a transporta 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. Mostra o objeto no Organizer, se este estiver selecionado na view do objeto. Salva tudo, executa o Domnio e abre o Viewer. Executa ou pra o Domnio corrente. Executa ou pra o E3 Viewer. Verifica se o Domnio contm erros. Mostra o erro anterior encontrado no Domnio. Mostra o prximo erro encontrado no Domnio. Habilita a Ajuda do sistema. Desfragmenta o arquivo especificado. Procura todas as ocorrncias de determinado texto por todo o Domnio. Gera 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. um
ICONE
Opes disponveis na barra de ferramentas Sombra COMANDO AO Aplica uma sombra no objeto. Sombra do objeto Sombra acima Sombra abaixo Sombra esquerda Desloca a sombra para cima do objeto. Desloca a sombra para baixo do objeto. Desloca a sombra para a esquerda do objeto.
E3 Studio
30
ICONE
COMANDO Sombra direita Cor da sombra
AO Desloca a sombra para a direita do objeto. Seleciona a cor da sombra.
ICONE
Opes disponveis na barra de ferramentas Objetos COMANDO AO Insere um objeto E3Alarm. E3Alarm E3Browser E3Chart Caixa de Seleo Boto de Opo Lista de Seleo Boto de Comando Texto Lista Barra de Rolagem Boto IncrementoDecremento Editor de Texto Boto Liga-Desliga 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 IncrementoDecremento (SpinButton). Insere um objeto Editor de Texto (TextBox). Insere um objeto Boto Liga-Desliga (ToggleButton).
ICONE
Opes disponveis na barra de ferramentas Tela COMANDO AO Habilita o modo de seleo. Selecionar Rotacionar Ordem dos tabs Linha Retngulo Retngulo arredondado Habilita o modo de rotao. Mostra o identificador de ordem de navegao entre os objetos. Insere um objeto do tipo linha. Insere um objeto do tipo retngulo. Insere um arredondado. objeto do tipo retngulo
E3 Studio
31
ICONE
COMANDO Elipse Arco de elipse Desenho livre Polgono Polgono de curvas Figura Texto Display SetPoint Escala Agrupar Desagrupar Animar com translao Animar com rotao Trazer para frente Enviar para trs Avanar Recuar Zoom Camadas
AO 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. 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.
ICONE
Opes disponveis na barra de ferramentas Desenho COMANDO AO Define a cor do fundo do objeto. Cor do fundo Cor da frente Cor da borda Estilo da borda Espessura da linha Estilo do preenchimento Define a cor da frente do objeto. 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.
32
E3 Studio
Opes disponveis na barra de ferramentas Alinhamento ICONE COMANDO AO Alinha objetos esquerda. Alinhar esquerda Alinhar direita Alinhamento superior Alinhamento inferior Mesma largura Mesma altura Mesmo tamanho Centralizar horizontalmente Centralizar verticalmente Distribui horizontalmente Distribuir verticalmente Grade Alinha objetos direita. Alinha objetos acima. Alinha objetos abaixo. Aplica a mesma largura entre os objetos. Aplica a mesma altura entre 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. Mostra ou esconde a grade.
Opes disponveis na barra de ferramentas Formatao ICONE COMANDO AO Determina a fonte do texto. Fonte Tamanho da fonte Cor da fonte Fonte em negrito Fonte em itlico Fonte sublinhada Texto esquerda Texto centralizado Texto direita Determina o tamanho da fonte. Determina a cor da fonte. Insere fonte em negrito. Insere fonte em itlico. Insere fonte sublinhada. Formata texto esquerda. Centraliza texto. Formata texto direita.
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 sistema mostra uma caixa de dilogo indicando os erros encontrados no Domnio.
E3 Studio 33
Figura 14: 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 sistema mostrar uma caixa de mensagem indicando que no encontrou nenhum erro no Domnio e liberar a execuo do Viewer.
Figura 15: Mensagem do item Verificar Domnio
A opo Verificar Domnio pode ser acessada das seguintes maneiras: Atravs do cone Verificar Domnio, disponvel na Barra de Ferramentas Padro: Verifica os erros ocorridos em todo o Domnio; Atravs do Menu Ferramentas - Verificar Domnio, com o funcionamento descrito anteriormente; 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.
2.4.2.
Procurar/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.
34 E3 Studio
A ferramenta Substituir substitui as ocorrncias encontradas por outro texto especificado.
Figura 16: 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 , na Barra de Ferramentas Padro. A procura ser efetuada em todo o Domnio. As opes disponveis so as seguintes:
Opes disponveis na ferramenta Procurar/Substituir OPO DESCRIO Contm o texto a ser procurado. Procurar por Inicia a busca pelo texto. Boto [Procurar] Refaz a pesquisa apenas entre os resultados da pesquisa Apenas nos resultados anterior. Procura pelo texto exatamente como foi escrito, Diferenciar maisculas de diferenciando maisculas de minsculas. minsculas Procura o texto especificado como uma palavra inteira. No Palavras inteiras considera o texto como substring de outro. Contm o texto a ser utilizado na substituio. Substituir por Inicia o processo de substituio. Boto [Substituir] Faz a substituio da linha selecionada e seleciona a Uma a uma prxima linha vlida. Substitui, de uma s vez, todas as ocorrncias do texto. Todas Substitui, de uma s vez, todas as ocorrncias marcadas na Apenas as selecionadas lista de resultados. Boto
E3 Studio
Mostra ou esconde as opes de pesquisa e substituio.

35
OPO Boto Boto
DESCRIO Seleciona na lista de resultados a ocorrncia anterior. Seleciona na lista de resultados a ocorrncia seguinte.
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.
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 (Documentao de scripts) 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.
Figura 17: Assistente de documentao de scripts
36
E3 Studio
Arquivo de documentao 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].
Figura 18: Arquivo de documentao de scripts
Clique no boto [Avanar] para ir prxima janela. Detalhamento do arquivo 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
Figura 19: Detalhamento do arquivo
Por exemplo, o script abaixo:

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, se tem-se os seguintes objetos:
TelaInicial CommandButton1 Tela1 CommandButton1
Ambos os scripts (considerando um mesmo evento, CommandButton1_Click(). Assim, a gravao no arquivo fica:
Sub CommandButton1_Click() ... End Sub
38
Click)
seriam
<TelaInicial.CommandButton1:CommandButton1_Click()>
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. Separador de scripts 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.
Figura 20: 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, podese 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
E3 Studio 39
sistema mostrar uma mensagem indicando a finalizao da configurao e a gerao do arquivo que contm a documentao dos scripts.
Figura 21: 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.
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
40 E3 Studio
essa ferramenta, basta clicar no boto Relatrio de verses da Barra de Ferramentas Padro, que a caixa de dilogo seguinte ser mostrada.
Figura 22: Relatrio de verses
As opes mostradas nesta caixa de dilogo so as seguintes:

Opes disponveis na caixa de dilogo Relatrio de verses OPO DESCRIO Nome do projeto ou da biblioteca abertos. Projeto/Biblioteca Indica a verso do projeto ou biblioteca. Esta verso gerada Verso 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 tiver permisso para abrir e alterar o projeto ou a biblioteca, a verso ser incrementada normalmente. Mostra o comentrio relacionado ao projeto. Esse comentrio Comentrio pode ser editado atravs da propriedade DocString. No caso das bibliotecas, esse campo fica em branco.
NOTA: Esses campos so apenas para visualizao, no sendo permitida sua edio.
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, deve-se clicar no boto WatchWindow da Barra de Ferramentas Padro ou acessar o menu Ferramentas - WatchWindow, que a caixa de dilogo a seguir ser mostrada:
E3 Studio
41
Figura 23: WatchWindow
A caixa de dilogo apresenta as seguintes opes:

Opes disponveis na caixa de dilogo WatchWindow OPO DESCRIO Abre o DomainBrowser (um AppBrowser com os objetos Boto [Adicionar...] criados no servidor) e seleciona o objeto que ser mostrado na janela do WatchWindow. Remove a linha selecionada da lista de objetos do Boto [Remover] WatchWindow. Busca toda a rvore de filhos dos objetos selecionados Boto [Atualizar] atualmente pelo WatchWindow. Tenta reativar a conexo perdida com o Domnio para que a Boto [Conectar] visualizao seja possvel. Indica o tag ou a propriedade sendo visualizada. Nome Indica a qualidade do tag ou da propriedade. Qualidade Indica a estampa de tempo do tag ou da propriedade. Estampa de tempo Indica o valor do tag ou da propriedade, em tempo de Valor execuo. Indica se o Domnio est conectado ou desconectado. 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 no sistema atravs de uma rvore hierrquica de opes. Possui dois modos de visualizao: Domnio e Explorer.
42
E3 Studio
Figura 24: Organizer
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 nodo.
Figura 25: Modo Domnio
E3 Studio
43
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 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.
Figura 26: Modo Explorer
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: No modo Domnio, clique com o boto direito no objeto e selecione Mostrar no Explorer para visualiz-lo no modo Explorer; No modo Explorer, clique com o boto direito no objeto e selecione Mostrar no Organizer para visualiz-lo no modo Domnio; Em qualquer um dos modos, clique com o boto direito no objeto e selecione Mostrar no Editor para visualiz-lo diretamente na aba de Design; Em qualquer view de objetos, na aba Design, clique com o boto direito 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, suas propriedades podero ser visualizadas e editadas atravs da Lista de Propriedades, se habilitada. Clicando com o boto direito sobre cada item do Organizer, so mostradas as seguintes opes:
44 E3 Studio
OPO Fechar Atualizar Registrar! Salvar Como... Desfragmentar
Opes disponveis no Organizer DESCRIO Fecha o projeto ou biblioteca corrente. Atualiza as configuraes do projeto ou biblioteca. Registra a biblioteca para que as modificaes feitas fiquem 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 do sistema, 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. 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 no sistema. 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 acesse 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 acesse a opo Remover do Domnio. Para adicion-los 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 subseo 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 subseo Documentao de Scripts deste captulo. Verifica os erros ocorridos na aplicao. Maiores informaes sobre essa opo na subseo Verificar Domnio deste captulo. 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.
Proteo...
Nova Pasta Inserir Inserir Recurso Habilitar/Desabilitar projeto
Adicionar/Remover do Domnio
Procurar/Substituir
Importar/Exportar
Documentar Scripts... Verificar Editar Associaes
E3 Studio
45
OPO Copiar/Colar Associaes
Propriedades
DESCRIO Copia ou Cola associaes de um objeto para o 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. Abre a Janela de Propriedades do objeto. Quando essa opo chamada 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. 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 tiver alteraes no salvas, perguntado para o usurio se ele as deseja salvar. Permite editar a ordem de ativao dos objetos de Servidor no Domnio (ver figura a seguir).
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! Abrir Todos os Arquivos
Fechar Todos os Arquivos Editar a Ordem de Ativao...
46
E3 Studio
Figura 27: 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 e criar os mesmos 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 cada objeto podem ser gravadas suas propriedades, suas associaes e seus itens de colees. possvel, ento: 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.
E3 Studio
47
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.
2.6.1.
Arquivo CSV
Um arquivo CSV (Comma Separated Values) um arquivo texto baseado em colunas separadas por vrgula, ou por outro separador 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; 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 a ObjectType, porque sem ela no possvel identificar o tipo de objeto que deve ser criado. Criando um arquivo CSV manualmente possvel criar um arquivo com extenso .CSV a partir o 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 para 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.
48 E3 Studio
A seguir, um exemplo de um arquivo CSV que pode ser criado manualmente no Excel: Abra o Excel e configure o cabealho com os seguintes campos, um em cada coluna, conforme a figura a seguir;
Figura 28: Arquivo CSV visualizado no Excel
Salve a planilha com a extenso CSV; Feche o arquivo no Excel; Para importar este arquivo no E3, selecione um IODriver e importe o arquivo criado atravs da opo Importar, escolhendo o modelo adequado. O E3 criar a estrutura no sistema de acordo com o arquivo CSV.
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: Clique com o boto direito do mouse sobre o objeto desejado e selecione a opo Exportar; Na caixa de dilogo, selecione o arquivo CSV desejado e clique no boto [Salvar].
E3 Studio
49
Figura 29: 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 IODriver.
Figura 30: 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

50 E3 Studio
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: Clique com o boto direito do mouse sobre o objeto desejado e selecione a opo Exportar; Clique no boto [Avanado...] para configurar ou selecionar um modelo; Na caixa de dilogo, selecione o arquivo CSV desejado e clique no boto [Salvar]. Clique com o boto direito do mouse sobre o objeto desejado e selecione a opo Importar; Na caixa de dilogo, selecione o arquivo CSV desejado e clique no boto [Abrir].
Para importar objetos, siga esses procedimentos:
Figura 31: 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.
E3 Studio 51
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 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 altervel 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 palavraschave 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 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.
SEO Header (*)
52
E3 Studio
SEO Configuration
Types
Columns
Filter
DESCRIO 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. 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. Variveis definidas para os Modelos 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. 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. 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.
SEO header (*)
types
separator
root
link
collection
E3 Studio
53
SEO objectduplicated
bindduplicated
collectionduplicated
itemduplicated
include
exclude
DESCRIO Define o que fazer quando um objeto 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 objeto existente); 2: ignorealways (sempre ignora o objeto sendo importado); e 3: createalways (sempre cria um objeto novo, auto-incrementando 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; caso esse seja atribudo, ser automaticamente modificado para askalways. Define o que fazer quando uma coleo 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 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; caso esse seja atribudo, ser automaticamente modificado para askalways. 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.
E3 Studio
54
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:
[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 installpath\Templates.
E3 Studio 55
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 sero de acordo com o que j estiver previamente configurado. As abas disponveis so: Aba Configuraes: Atravs desta opo, o usurio pode configurar as opes vlidas tanto para a importao quanto para a exportao.
Figura 32: Aba Configuraes
56
E3 Studio
OPO Separador de colunas
Outras opes
Salvar modelo
Opes disponveis na aba Configuraes 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). 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.
Aba Importao: Atravs desta opo, o usurio pode configurar as opes vlidas somente para a importao.
Figura 33: Aba Importao
E3 Studio
57

Opes disponveis na aba Importao OPO DESCRIO Especifica como o sistema deve lidar com a ocorrncia de objetos Importao de objetos duplicados na importao. As opes disponveis so: Questionar duplicados sobre o que fazer em cada caso, Sempre sobrescrever o objeto existente, Sempre ignorar o objeto duplicado e Sempre criar um novo objeto. Especifica como o sistema deve lidar com a ocorrncia de Importao de associaes duplicadas na importao. As opes disponveis so: associaes duplicadas Questionar sobre o que fazer em cada caso, Sempre sobrescrever a associao existente e Sempre ignorar a associao duplicada. Especifica como o sistema deve lidar com a ocorrncia de colees Importao de colees duplicadas na importao. As opes disponveis so: Questionar duplicadas sobre o que fazer em cada caso, Sempre sobrescrever a coleo existente e Sempre ignorar a coleo duplicada. Especifica como o sistema deve lidar com a ocorrncia de itens de Importao de itens de coleo duplicados na importao. As opes disponveis so: coleo duplicados Questionar sobre o que fazer em cada caso, Sempre sobrescrever o item existente, Sempre ignorar o item duplicado e Sempre criar um novo item.
Aba Filtros: Atravs desta opo, o usurio pode escolher quais as classes que sero utilizadas na importao ou na exportao, ou quais classes no deseja utilizar.
58
E3 Studio
Figura 34: Aba Filtros

Opes disponveis na aba Filtros 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.
OPO No filtrar objetos Incluir apenas estes objetos Excluir apenas estes objetos Boto [Alterar...] Boto
O boto [Alterar...] abre a seguinte janela para a escolha de classes:
E3 Studio
59
Figura 35: 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, pressionando o boto . Aba Identificadores: Atravs desta opo, o usurio define os identificadores para as classes de objetos escolhidas. O estado inicial dessa lista vazio.
Figura 36: Aba Identificadores
60
E3 Studio
OPO Nome da classe Identificador
Opes disponveis na aba Identificadores DESCRIO Indica o nome da classe selecionada na opo. 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
Aba Propriedades: Atravs desta opo, 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.
Figura 37: Aba Propriedades
E3 Studio
61

Opes disponveis na aba Propriedades 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.
OPO Nome da coluna
Propriedade Botes e Boto Boto Boto
Boto
Ao pressionar o boto
, a seguinte janela aberta para a seleo de propriedades:
62
E3 Studio
Figura 38: Seleo de Propriedades

Opes disponveis na janela Propriedades 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 Boto opo anterior. Se esta opo for selecionada, a caixa de seleo de objetos Listar todas as classes de mostrar todas as classes existentes no E3, independente de filtro objetos do E3 ou objeto raiz. Mostra as propriedades do objeto selecionado. Propriedades OPO Classes de objetos
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, 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.
E3 Studio 63
Figura 39: 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. 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 os seguintes procedimentos: No Organizer do Elipse SCADA, abra a pasta de Drivers e clique sobre o Driver desejado; Clique no boto [Exportar...];
64
E3 Studio
Figura 40: Exportao de Drivers
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: Insira um Driver de Comunicao no Organizer do E3; 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; Clique com o boto direito no Driver de Comunicao, e clique na opo Importar...; 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
65
Figura 41: Importao de Tags
Importao de Tags RAM e Demo Para exportar os tags RAM e Demo, siga esses passos: No Organizer do Elipse SCADA, clique na pasta Tags; Clique no boto [Exportar...];
66
E3 Studio
Figura 42: Exportao de Tags
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: Insira um Servidor de Dados no Organizer do E3; Renomeie o Servidor de Dados para Dados, para que posteriormente as associaes dos objetos de Tela sejam importadas corretamente; Clique com o boto direito no Servidor de Dados, e clique na opo Importar...; 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.
Importao da Configurao e Tags de Servidores OPC No Organizer do Elipse SCADA, abra a pasta OPCServers e clique sobre o Driver OPC desejado; Clique no boto [Exportar...];
E3 Studio
67
Figura 43: Exportao de Configuraes e Tags de Servidores OPC
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. No Organizer do E3, insira um novo Driver de Comunicao OPC; 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; Clique com o boto direito no Driver OPC, e selecione a opo Importar...; 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.
Para fazer a importao dos Tags OPC no E3 3.0, siga esses passos:
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:
68 E3 Studio
No Organizer do E3, insira uma nova Configurao de Alarmes, e insira uma rea; Clique com o boto direito na rea e selecione a opo Importar...; 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.
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: No Organizer do Elipse SCADA, abra a pasta Telas e clique sobre a Tela desejada; Clique no boto [Exportar...];
Figura 44: Exportao de Telas
Escolha o local e o nome do arquivo a ser gerado. Antes de importar as Telas do SCADA no E3 pela primeira vez, necessrio registrar no E3 Studio os controles ActiveX dos objetos de Tela E2Controls. Para isso, siga esses procedimentos: Selecione a opo Ferramentas - Adicionar ActiveX; Selecione na lista um dos controles da biblioteca E2Controls, por exemplo, E2Animation, e clique em [OK];
E3 Studio
No Organizer do E3, insira uma nova Tela;

69
Clique com o boto direito sobre a Tela e selecione a opo Importar...; 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 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. NOTA: recomendado inserir todos os arquivos no projeto como recursos, para que o Viewer do E3 possa fazer o download dos mesmos 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:
70
E3 Studio
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.
Figura 45: 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 disso feito da mesma forma que nas colunas das propriedades dos objetos. No caso de colees e itens de coleo, as propriedades precisam ser incluidas no arquivo INI manualmente. No possvel selecionar essas propriedades atravs do configurador de modelos.
E3 Studio 71
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 no 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: 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.
72
E3 Studio
Figura 46: Relatrio de Falhas na Importao (exemplo)
2.7.
Lista de Propriedades
A Lista de Propriedades uma caixa 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.
Figura 47: 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).
E3 Studio
73
Figura 48: Galeria
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 os erros durante a criao da aplicao.
Figura 49: AppBrowser
74
E3 Studio
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 direita so mostrados as propriedades e os mtodos do objeto selecionado, e abaixo uma breve descrio da propriedade ou do mtodo selecionado. Mais abaixo mostrado o texto resultante do AppBrowser, ao lado dos botes [Colar] e [Cancelar]. Pressione [Colar] para aceitar o resultado e copiar o valor para o local desejado. Pressione [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, e atravs de algumas propriedades de objetos que possuem como valor um outro nome de objeto. Cada uma destas maneiras ser abordada adiante.
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 da seguinte maneira:
Figura 50: AppBrowser via scripts
E3 Studio
75
No quadro esquerda: o primeiro item, mostrado isoladamente, o contexto. O objeto-contexto o que originou a chamada ao 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(Application); o quarto item o Servidor; nele so listados todos os objetos do servidor que a aplicao possui. 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; equivale ao pick Abrir Tela). finalmente, o sexto item mostra todas as funes do VBScript disponveis para uso em scripts. De acordo com o objeto selecionado, o quadro direita 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 da seguinte maneira:
Figura 51: AppBrowser via associaes
76
E3 Studio
Neste caso, apenas as propriedades dos objetos so mostradas no quadro direita 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. Pressionando esse boto, o AppBrowser chamado mostrando apenas os objetos que podem ser usados como valor da propriedade selecionada. As propriedades e mtodos destes objetos so omitidas. o caso, por exemplo, da propriedade DBServer do objeto Frmula. O AppBrowser mostra apenas os objetos do tipo Banco de Dados existentes na aplicao.
Figura 52: 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; e 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 pegar a licena do servidor onde roda o Domnio ou se deve pegar a licena em um outro servidor. Para utilizar este recurso, clique no menu Arquivo - Conectar a..., e a caixa de dilogo aberta:
E3 Studio 77
Figura 53: Conectar a
Opes disponveis na janela Conectar a... OPO DESCRIO Habilita a conexo com o servidor local. Conectar ao servidor local Habilita a conexo com um servidor da rede. Para tanto, Conectar a um servidor na rede basta acess-lo atravs de caixa de seleo. Pegar licena no servidor de Domnio atual Usar licena de um servidor especfico Usa licena do servidor onde roda o Domnio. Usa a licena de outro servidor, que no o rodando o Domnio.
Se a conexo com qualquer dos dois servidores (Domnio ou licena) cair, o E3 Studio desconectado do outro servidor. A ltima configurao guardada no Registro do Windows, e da prxima vez em que o E3 Studio for aberto, ele se conectar aos servidores de Domnio e de licena utilizados da ltima vez. Se o servidor de licena no estiver disponvel, ou se no tiver 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_do_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. Se o servidor de Domnio no possuir hardkey, 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 (ver seo Pacotes Disponveis,
78 E3 Studio
no captulo Introduo), 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. Em vez de usar C:\projetos\projeto.dom utilize \\server\projetos\projetos.dom. Desta forma, o E3 Studio e o E3 Server remoto podero acessar os arquivos utilizando o mesmo caminho.
E3 Studio
79
Captulo
3
3.
E3 Server
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 seguintes mdulos:
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. 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:
Domnio
81
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): mostradas 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 /RegServer. Este processo usa o REC para se conectar fila de banco de dados do E3 Server. E3 Admin O E3 Admin o mdulo responsvel por monitorar e comandar o E3 Server. simbolizado por 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:
E3 Admin <nome_do_domnio> [opes]
ou
E3 Admin [opes] <nome_do_domnio>
As opes disponveis esto 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: Pra o Domnio em execuo, quando existir. Esta opo deve ser utilizada sozinha. -close: Pra e fecha o Domnio em execuo, quando existir. Esta opo deve ser utlizada 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 E3Admin, como na figura a seguir:
82
Domnio
Figura 54: Caixa de dilogo com as opes de linha de comando do E3Admin
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. 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. E3 Studio O E3 Studio o ambiente de desenvolvimento e configurao de aplicativos. Permite abrir ou editar arquivos .PRJ e .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. 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 bitmaps so carregadas conforme a necessidade em tempo de execuo.
3.1.
Componentes do Domnio
Um Domnio constitudo dos seguintes arquivos: DOM: Arquivo de Configurao do Domnio O arquivo .DOM armazena quatro tipos de informaes:
Domnio
83
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. PRJ: 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, independentemente dos outros, inclusive em servidores diferentes. LIB: Arquivo de Biblioteca Os arquivos .LIB contm definies de objetos criados pelo usurio (ElipseX) que podem ser utilizados nos arquivos de projeto.
3.2.
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.
84
Domnio
Figura 55: Criando um novo Domnio
A seguir, o usurio deve decidir se deseja incluir projetos ou bibliotecas abertos no novo Domnio criado.
Figura 56: Confirmao de insero do projeto/biblioteca no novo Domnio
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.2.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 cone Novo , na Barra de Ferramentas Padro;
Atravs do menu Arquivos - Novo Projeto. Uma vez que o Assistente tenha sido acessado, a tela inicial aberta. Para continuar, clique em [Avanar >].
Domnio
85
Figura 57: Tela inicial do Assistente de Aplicaes do E3
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. 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...].
86
Domnio
Figura 58: Tela Tipo de Aplicao
Caso a pasta informada no exista, o usurio avisado, e deve decidir se deseja crila.
Figura 59: Aviso de Pasta inexistente
Clique no boto [Avanar >] para prosseguir. NOTA: a opo Biblioteca de componentes do E3 ser discutida mais adiante, no captulo Bibliotecas. Domnio Nesta tela possvel decidir o Domnio ao qual o projeto ou biblioteca sendo criado pertencer. A habilitao da opo Adicionar no Domnio ativo condicionada existncia de Domnios ativos no sistema; clicando nesta opo, o novo projeto far parte do atual Domnio. 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.
Domnio
87
Figura 60: Tela Domnio
Clique no boto [Avanar >] para prosseguir. 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.
Figura 61: Tela Resoluo do Viewer
Clique no boto [Avanar >] para prosseguir.

88 Domnio
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 [...].
Figura 62: Tela Driver de Comunicao
Clique no boto [Avanar >] para prosseguir. 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 [...].
Domnio
89
Figura 63: Tela Banco de Dados
Clique no boto [Avanar >] para prosseguir. 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 banco de dados tenha sido inserido no projeto.
Figura 64: Tela Alarmes
Clique no boto [Avanar >] para finalizar a criao da aplicao.

90 Domnio
Aps, o sistema mostra a tela final do Assistente, com uma mensagem que indica a final do processo de criao da aplicao.
Figura 65: Tela final do Assistente de Aplicaes do E3
Finalize o processo clicando no boto [Concluir].
3.3. Configuraes de Domnio

Atravs do menu do E3 Admin na rea de Notificao 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 outros. Essas configuraes so feitas atravs da opo Domnio - Opes.
Figura 66: Opes de configurao via rea de Notificao do Windows
Domnio
91
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 Hot-Standby e for aberto em um computador que no faz parte do domnio.
3.3.1.
Opes
Na aba Opes possvel habilitar a redundncia de servidores.
Figura 67: Opes de configuraes

Opes disponveis na aba Opes 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. 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 executar caso o servidor principal falhe, ou caso o servidor de backup seja ativado manualmente.
OPO Hot-Standby
Servidor principal
Servidor de backup
92
Domnio
OPO Endereo para PING de integridade da rede
Ativar backup em caso de falha local
Tempo para ativao do servidor reserva
Perfil de pr-ativao do servidor reserva
DESCRIO O algoritmo de Hot-Standby exige que seja declarada uma terceira entidade de rede (as outras duas 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 termina imediatamente a execuo do Domnio. Habilita a troca automtica de servidores quando uma falha local reportada no servidor principal. Falhas locais so detectadas e reportadas pelo prprio aplicativo atravs da funo Application.ReportFailure. A troca de servidores s feita se o servidor de backup estiver sem falhas. 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 pr-ativao 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.
Domnio
93
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. (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 True.
NOTA: Quando o Domnio colocado em execuo, o E3 Server sempre escolhe o servidor ativo por ordem alfabtica, independentemente 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 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 (Ex: \\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
94 Domnio
no Boto 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 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.3.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 na rea de Notificao do Windows, selecione a opo Domnio - Opes e acesse a aba Segurana. A seguinte janela ser mostrada:
Figura 68: Configurao de segurana do Domnio

Opes disponveis na aba Segurana OPO DESCRIO Impede que o usurio troque a senha em tempo de O usurio no pode alterar a sua senha execuo.
Domnio 95
OPO 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 Bloquear a conta do usurio aps ... falhas de login Desbloquear o usurio automaticamente aps ... minutos Avisar o usurio nos ltimos ... dias antes da senha expirar
DESCRIO 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 a mesma expirar. Aps a senha expirar, o usurio fica desabilitado. Determina o nmero mnimo de caracteres para a senha do usurio. Determina que a senha do usurio deva conter letras e nmeros. Determina o nmero mnimo de nmeros na senha. Determina o nmero mnimo de letras na senha. Determina que a senha do usurio deva conter letras maisculas e minsculas. Determina o nmero mximo de falhas de login para que a conta do usurio seja bloqueada. Desbloqueia a conta do usurio depois de determinados minutos. 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.3.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).
96 Domnio
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 Notificao do Windows, selecione a opo Domnio - Opes, e acesse a aba Grupos de Viewers. A seguinte janela ser mostrada:
Figura 69: Configuraes de Grupos de Viewers
As opes disponveis so:

Opes disponveis na aba Grupos de Viewers OPO DESCRIO Lista os nomes de todos os grupos de Viewers. Nome Adiciona ou remove grupos de Viewers. Adicionar / Remover Habilita a criao ou alterao de nomes de grupos de Nome do grupo Viewers. Especifica quais IPs pertencero ao grupo, e desse modo Lista de IPs 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.
Domnio
97
OPO Adicionar / Editar / Remover
Permitir conexes de Viewer Full Limitar uso de licenas simultneas
Permitir conexes de Viewer Only Limitar uso de licenas simultneas
DESCRIO 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 selecionado, permite conexes de Viewer Full para o grupo. Quando selecionado, 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 selecionado, permite conexes de Viewer Only para o grupo. Quando selecionado, limita o uso de licenas de Viewer Only simultneas a um determinado nmero. Se a opo anterior estiver marcada, mas esta estiver desmarcada, o uso de licenas simultneas ilimitado.
importante notar que estes limites so aplicados aps o limite do E3 Server, como configurado na hardkey. Por exemplo, se a hardkey possuir dez licenas de Viewer e o grupo especificar cinco conexes no mximo, apenas estas cinco sero usadas. No entanto, se a hardkey possuir cinco licenas de Viewer e o grupo especificar dez conexes no mximo, sero utilizadas o limite de cinco conexes da hardkey. 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.
3.3.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;
98 Domnio
Incio ou Trmino do Domnio; Alterao no Domnio (Inserir, remover, habilitar ou desabilitar projetos e libs, alterar a configurao do Domnio); Atualizao do Domnio (quando o usurio manda aplicar 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:
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.
Domnio
99
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 na rea de Notificao, selecione a opo Domnio - Opes, e acesse a aba Registro de Eventos. A seguinte janela ser mostrada:
Figura 70: Registro de eventos

Opes disponveis na aba Registro de Eventos OPO DESCRIO Registrar os eventos do sistema em Habilita o registro de eventos no E3. uma tabela no Banco de Dados do aplicativo Habilite esta opo para deixar que o E3Run Selecionar automaticamente um Banco escolha um objeto Servidor de Dados para gravar de Dados no aplicativo 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 Usar este Banco de Dados 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.
100 Domnio
OPO Nome da tabela
Marque abaixo os eventos que devem ser registrados
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 (DataHora): O campo E3TimeStamp configurado pelo E3Run e contm a data/hora em que o E3Run conseguiu enviar o evento para o Banco de Dados. EventTime(DataHora): O campo EventTime a data/hora em que realmente ocorreu o evento, a data/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) 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 o boto [F2] pressionado, abre-se uma caixa de dilogo para edio do evento. A seguinte janela mostrada:
Domnio
101
Figura 71: 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.
Figura 72: 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; %SESSION%: Insere o nome do programa onde o usurio estava logado (Viewer, E3 Studio ou E3 Server); %CAUSE%: Informao adicional sobre o evento.
102 Domnio
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: 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. Logout de usurio Usurio %User% terminou a sesso de uso de %SESSION% na mquina %MACHINE% Gerado sempre que ocorrer um logout de um usurio no E3 Studio ou no Viewer (ou quando o programa fechado sem dar 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. Troca de senha A senha do usurio %USER% foi alterada. Gerado sempre que a senha de um usurio for trocada (chamando a funo ChangePassword() no Viewer), onde: %USER% contm o nome de login do usurio que teve a senha trocada.
Domnio
103
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. 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). 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. 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 do SystemTray); %MACHINE% contm o nome do computador onde foi gerado o comando de executar o Domnio.
104
Domnio
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 do SystemTray). %MACHINE% contm o nome do computador onde foi gerado o comando de parar o Domnio. 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. Domnio modificado Domnio modificado pelo usurio %USER% no %SESSION% na mquina %MACHINE%: %CAUSE% Gerado sempre que o arquivo do Domnio (.DOM) modificado, onde: %SESSION% contm o nome do usurio que alterou o Domnio; %MACHINE% contm E3 Studio ou E3 Server; %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;
Domnio
105
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 reserva (ou Annimo se no foi pedida autenticao quando o servidor foi ativado); %SESSION% contm E3 Server (menu da rea de Notificao do Windows); %MACHINE% contm o nome do computador onde foi gerado o comando de ativar o servidor backup.
3.3.5.
Projetos
possvel adicionar, remover e editar os projetos (.PRJ) de um Domnio. Para acessar este item, clique com o boto direito do mouse no cone do E3 na rea de Notificao do Windows, selecione a opo Domnio - Opes e acesse a aba Projetos. A seguinte janela ser mostrada:
Figura 73: Configuraes do Projeto
106
Domnio
Opes disponveis na aba Projeto DESCRIO Esta opo lista os nomes dos projetos no sistema. Nome Atravs destas opes, pode-se remover ou adicionar Adicionar / Remover 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 Nome do projeto caminho relativo ao diretrio do Domnio (o diretrio que contm o arquivo .DOM). Exemplos: Telas.PRJ Hidro\Estacao1.prj Em manuteno (execuo Esta opo permite desabilitar a execuo do projeto, evitando a ocorrncia de erros quando o Domnio desabilitada) executado. Quando a opo habilitada, o cone indica que o projeto no ser utilizado. Os projetos com o cone OPO esto habilitados e sero executados.
3.3.6.
Servidores
possvel adicionar, remover e 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 ( ) ou em manuteno/desabilitado( ). Para acessar este item, clique com o boto direito do mouse no cone do E3 na rea de Notificao do Windows, selecione a opo Domnio - Opes e acesse a aba Servidores. A seguinte janela ser mostrada:
Domnio
107
Figura 74: Configuraes dos Servidores

Opes disponveis na aba Servidores DESCRIO Esta opo lista os nomes dos servidores no sistema. Nome Atravs destas opes, pode-se remover ou adicionar Adicionar / Remover 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 Nome do servidor pelo usurio. Marque esta opo para indicar a localizao dos Caminho local de acesso aos arquivos do Domnio (.PRJ e .LIB) no servidor arquivos do Domnio selecionado quando estes no estiverem no mesmo diretrio do .DOM. recomendado que os arquivos do Domnio SEMPRE ESTEJAM NO MESMO DIRETRIO QUE O ARQUIVO DOM, portanto normalmente esta opo estar desabilitada. Digite o nome do servidor na rede, deve ser o nome da Identificao do servidor na rede mquina com ou sem as barras duplas no incio (ex: \\server ou server). OPO
108
Domnio
OPO Em manuteno (execuo desabilitada)
DESCRIO 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 indica que o servidor poder ser
contrrio, o cone utilizado.
3.3.7.
Domnios Remotos
Permite adicionar, remover e 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 na rea de Notificao do Windows, selecione a opo Domnio - Opes e acesse a aba Domnios Remotos. A seguinte janela ser mostrada:
Figura 75: Domnios Remotos

Opes disponveis na aba Domnios Remotos OPO DESCRIO Esta opo lista os nomes dos Domnios Remotos no sistema.
Nome
Domnio
109
OPO Adicionar / Remover
Nome do Domnio Arquivo de Domnio Servidor Principal Servidor de Backup Usurio no Domnio
Usurio Senha
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.
Uma configurao de Domnio Remoto permite tambm que se conecte ao prprio Domnio local. A isso se d o nome de Alias local ou conexo Loopback. Esse alias criado segundo a configurao de Domnios Remotos normal. Basta que o nome do servidor (principal ou backup) seja o mesmo da mquina onde o Domnio est rodando para que tudo funcione localmente. Nesse caso, para que a configurao funcione no Studio, no campo Arquivo de Domnio, basta colocar diretamente o caminho local do arquivo DOM (p. ex.: c:\caminho\arquivo.dom). NOTA 1: A mudana dos alias 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. NOTA 2: As conexes do tipo loopback no aparecero na janela Licenas (ou Estatsticas) no E3 Admin e nem iro necessitar de licena de Domnios Remotos para funcionarem.
3.4.
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 Notificao.
110
Domnio
3.4.1.
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 na rea de Notificao do Windows e selecione a opo Licenas. A seguinte janela ser mostrada:
Figura 76: Licenas

Opes disponveis para Licena DESCRIO Informa o nmero da licena (hardkey), um hexadecimal de oito dgitos. Se a hardkey no foi detectada, o nmero 00000000. Indica o tipo de E3 Server. 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).
111
OPO Nmero da licena
E3 Server E3 Studio E3 Viewer E3 Viewer Only Domnio Remoto (Servidor)

Domnio
OPO Domnio Remoto (Cliente) Pontos E/S Tags do Storage Drivers Servidor OPC Tempo mximo de execuo
DESCRIO 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.
3.4.2.
Estatsticas
A caixa de dilogo Estatsticas 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 na rea de Notificao do Windows e selecione a opo Estatsticas.
Figura 77: Estatsticas

Opes disponveis na janela E3 Server - Estatsticas OPO DESCRIO Mostra o nome da mquina conectada ao E3 Server. Computador Mostra a quantidade de dados enviados. Dados enviados Compresso no envio Pacotes enviados Dados recebidos Compresso no recebimento Pacotes recebidos Conectado desde
112
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.
Domnio
3.4.3.
Monitor
A caixa de dilogo Monitor mostra informaes em tempo real sobre o estado dos servidores do Domnio. Para acessar tal item, clique com o boto direito do mouse no cone do E3 na rea de Notificao do Windows e selecione a opo Monitor.
Figura 78: Monitor

Opes disponveis na janela E3 Server - Monitor DESCRIO 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 com o servidor. Mostra uma lista de indicadores reportados 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 standby; - Candidato: O servidor est se candidatando a rodar o Domnio; - E/S: O servidor possui IOServers ativos.
OPO Nome Endereo Ping Relgio Estado Conexo Funo
Domnio
113
3.4.4.
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 na rea de Notificao do Windows e selecione a opo Inicializao. A seguinte janela ser mostrada:
Figura 79: E3 Server - Inicializao

Opes disponveis na janela E3 Server - Inicializao OPO DESCRIO Ao iniciar, executa automaticamente o Domnio O Domnio carregado previamente carregado. Ao iniciar, executa automaticamente o Domnio O Domnio configurado configurado pelo usurio. No inicia nenhum Domnio. Nenhum Domnio
3.4.5.
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 na rea de Notificao do Windows e selecione a opo Impressora. A seguinte janela ser mostrada:
114
Domnio
Figura 80: E3 Server - Impressora

Opes disponveis na janela E3 Server - Impressora OPO DESCRIO Lista o nome das impressoras disponveis. Nome da impressora Permite selecionar esta impressora como padro. Padro Abre a janela de propriedades da impressora Configurar... selecionada. Permite escolher outra impressora na rede e estabelecer Procurar... conexo.
3.4.6.
Sobre E3 Admin
Esta opo mostra a verso do E3 Admin.
3.4.7.
Parar / Iniciar E3 Server
Esta opo pra 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.4.8.
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 Notificao. Neste caso, quando o E3 Admin no
Domnio 115
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.5. 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.
3.5.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 Notificao).
Figura 81: 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
116 Domnio
servidores e clientes de Domnios Remotos. Para configurar o uso de um Domnio Remoto, siga estes procedimentos: Informe um apelido para o Domnio Remoto no campo Nome do Domnio. Este campo no sensvel a maisculas ou minsculas. Esse nome ser usado na aplicao para referenciar os objetos a serem acessados no Domnio Remoto; Especifique o caminho do arquivo .DOM do Domnio Remoto. Este caminho deve ser um compartilhamento na rede que permita acessar esse arquivo .DOM; Informe o nome do servidor principal, que deve ser o servidor contendo o Domnio Remoto especificado no caminho do arquivo .DOM. Essa configurao utilizada para encontrar os objetos do Domnio Remoto em tempo de execuo.
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 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 off-line. 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 estar rodando 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.
3.5.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.
3.5.3.
Domnio
Sintaxe dos links

117
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 do 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, deve-se 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: 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 sublinhado ("_").
3.5.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, diferentemente 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.
118
Domnio
Figura 82: 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 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 o usurio annimo.
3.5.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
Domnio 119
pelo Domnio Remoto acessado. Uma vez que haja essa configurao em tempo de execuo, o E3 Server ficar sempre tentando 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.5.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 Server na rea de Notificao da barra de tarefas do Windows.
3.5.7.
Desconexo
O Domnio Cliente pode no conseguir estabelecer a conexo com 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; 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
120 Domnio
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.6. 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 outros. Para mais informaes sobre a ferramenta Elipse Event Log Viewer, consulte o Elipse Event Log Viewer: Manual do Usurio. NOTA: Para sistemas operacionais anteriores ao Windows XP, os logs genricos so atualizados sempre, mesmo que o E3 seja fechado incorretamente (como no caso de uma falha). Os demais logs so atualizados periodicamente, sendo que se o E3 no for fechado corretamente, o contedo pode ficar incompleto ou at vazio.
Domnio
121
Captulo
4
4.
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.
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 e selecione o item Inserir - Driver de Comunicao.
Figura 83: Inserindo um Driver de Comunicao na aplicao
aberta a janela para localizao do driver:
Drivers
123
Figura 84: 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 figura a seguir.
Figura 85: View do Driver de Comunicao
124
Drivers
Opes disponveis na view do Driver de Comunicao OPO DESCRIO Adiciona uma nova pasta, um novo Tag ou um novo Adicionar 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. Remover Configurar o driver Tag Browser Ativar/desativar comunicao Contagem de tags Acessa a janela de configuraes extras do driver. Abre uma janela que permite importar tags diretamente do driver. Ativa e desativa a comunicao do driver. 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 a comunicao ser exibida, conforme a figura a seguir:
Figura 86: 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.
Drivers 125
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 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 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 seqencial. 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.
126 Drivers
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 modens, 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.
Figura 87: Acesso ao Gerenciador de Drivers
O Gerenciador de Drivers permite visualizar todos os drivers em execuo, exibindo suas propriedades.
Drivers
127
Figura 88: Gerenciador de Drivers

Opes disponveis na janela Gerenciador de Drivers OPO DESCRIO Informa o nome do driver inserido no sistema. Nome Informa o nome do objeto Driver de Comunicao associado ao Objeto(s) driver. Mostra o total de leituras do driver, a quantidade de erros de leitura e Erros de leitura percentual de erros em relao ao total de leituras. Mostra o total de escritas do driver, a quantidade de erros de escrita e Erros de escrita percentual de erros em relao ao total de escritas. Mostra o ID do processo do IOServer no sistema operacional. Processo Mostra o estado atual do driver (configurado, iniciando, rodando, Estado finalizando, finalizado, 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? compartilhado. Mostra o status do log (habilitado/desabilitado). Log Informa o caminho do driver no sistema. Caminho Habilita o log dos drivers em tempo de execuo sem a necessidade Boto [Habilitar Log] de reconfigurar o aplicativo. Atravs do mesmo boto podemos interromper este procedimento de gravao. Fora a atualizao dos dados exibidos. Boto [Atualizar]
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.
128 Drivers
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/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. 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. 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 seqncia 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 - Seqncia 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 abaixo:
Figura 89: Exemplos
Na primeira tabela, temos uma seqncia 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,
Drivers 129
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 estes procedimentos: No Organizer, clique com o boto direito sobre o objeto Driver e selecione a opo Inserir - Nova Pasta.
Figura 90: Inserindo uma Nova Pasta
130
Drivers
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 informao com os equipamentos de aquisio, que consistem em uma nica varivel independente. O Tag de Comunicao pode ser uma varivel analgica, entrada, 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: Insira o Tag de Comunicao no projeto, clicando com o boto direito do mouse no Driver e selecionando a opo Inserir - Tag de Comunicao;
Figura 91: Inserindo um Tag de Comunicao
Drivers
131
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.
Figura 92: Inserindo Tags de Comunicao
Caso o equipamento sendo utilizando 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: Clique com o boto direito do mouse no Driver e escolha a opo Inserir Bloco de Comunicao;
132
Drivers
Figura 93: Inserindo um Bloco de Comunicao
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.
Figura 94: Inserindo Blocos de Comunicao
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 num determinado intervalo de elementos;
Drivers
133
Figura 95: Configurando o Bloco de Comunicao
Informe o tamanho do Bloco e a opo de mapeamento; Clique em [OK]; 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.
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 estes procedimentos:
134
Drivers
Clique com o boto direito do mouse no Bloco de Comunicao e escolha a opo Inserir - Elemento de Comunicao.
Figura 96: Inserindo um Elemento de Bloco
Caso o equipamento sendo utilizando 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.
4.2. Servidor OPC

Drivers 135
Alm de possuir um cliente OPC (Driver OPC), o E3 funciona tambm como Servidor OPC DA (Data Access) 2.0x. Isso permite ao E3 disponibilizar todos objetos existentes no Domnio em execuo (tags de IO, etc.) para softwares externos ao E3. Como exemplos, podemos citar o Elipse SCADA, o E3 (que pode estar rodando em outra aplicao como cliente), ou um cliente OPC de um fabricante qualquer - basta o cliente implementar o padro OPC DA 2.0x. 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 de 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. 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 fica assim: Domnio rodando normalmente: OPC_STATUS_RUNNING Domnio em standby: OPC_STATUS_SUSPENDED Domnio parado ou sem Domnio: OPC_STATUS_NOCONFIG 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 isso, todos os clientes so desconectados.
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.
136 Drivers
Para utilizar um Driver OPC, siga estes procedimentos: Clique com o boto direito do mouse sobre o nome do projeto, e selecione a opo Inserir - Driver de Comunicao OPC.
Figura 97: Inserindo um Driver OPC
Ao inserir um Driver OPC em uma aplicao do E3 Studio, aberta a view do objeto, conforme a figura abaixo.
Figura 98: View do Driver de Comunicao OPC

Opes disponveis na view do Driver OPC DESCRIO Adiciona um Grupo ao Driver; um Tag, um Bloco ou uma Pasta ao Grupo; ou um Elemento ao Bloco.
OPO Adicionar
Drivers
137
OPO Remover Selecionar servidor Ativar/desativar comunicao Importar tags Informaes sobre o servidor Contagem de tags
DESCRIO 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.
138
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, e escolhendo a aba OPC Driver.
Figura 99: Configuraes do Driver OPC
Informe o Endereo e ID do Servidor e clique no boto [Selecionar...]. A seguinte janela ser mostrada:
Figura 100: Seleo do Servidor OPC
Drivers
139
As opes disponveis neste item so as seguintes:

Opes disponveis na janela Servidores OPC OPO DESCRIO O E3 ir tentar procurar as especificaes do Tentar enumerador padro ou registro driver tanto pelo registro do Windows quanto pelo (recomendado) enumerador padro OPC (OPCENUM). O E3 ir tentar procurar as especificaes do Tentar apenas enumerador padro driver apenas pelo enumerador padro OPC (servio OPCENUM) (OPCENUM). O E3 ir tentar procurar as especificaes do Tentar apenas registros no sistema driver apenas pelos registros no Window.
Clicando em [OK], o sistema mostrar os dados do Driver, indicando os caminhos e o nome do servidor. Para ativar a comunicao do Driver OPC clique na opo Ativar Comunicao:
Figura 101: Ativar comunicao do Driver OPC
140
Drivers
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.
Figura 102: Opes habilitadas quando o driver OPC est ativo
A opo Informaes sobre o servidor mostra uma janela com as configuraes do driver.
Drivers
141
Figura 103: Informaes do Servidor OPC
Atravs da opo Importar tags, possvel importar tags para o Driver OPC. Quando esta opo selecionada, a seguinte mensagem mostrada:
Figura 104: Mensagem referente a 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 tipo bloco e seus elementos. CANCELAR: Cancela a importao. A janela de importao dispe dos seguintes recursos:
142
Drivers
Figura 105: Importao de Tags OPC

Opes disponveis na janela Importao de Tags OPC OPES DESCRIO Filtra os tags a partir do nome dos itens especificados. Nome dos Itens Podem ser utilizados caracteres curingas, tais como * ou ?. Filtra os tags a partir do tipo de dado especificado no Tipo de dados campo. Estes dados podem ser do tipo Integer, Long, Single, etc. Filtra os tags a partir do tipo de acesso especificado no Tipo de acesso campo. Estes acessos podem ser: Leitura, Escrita ou Leitura/Escrita. Mostrar apenas itens com IDs no Filtra os tags para que o sistema mostre apenas os itens com IDs no encontrados no projeto. encontrados no projeto Mostra os objetos que foram selecionados para adio no Projeto corrente projeto corrente. Mostra os tags disponveis no servidor para a Servidor OPC 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
Drivers 143
devidos ajustes. Para maiores informaes, consulte o Manual de Referncia de Scripts.
144
Drivers
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 estes procedimentos: Clique com o boto direto do mouse sobre o Driver OPC e selecione a opo Inserir - Grupo de tags OPC.
Figura 106: 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.
Drivers
145
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 estes procedimentos: Clique com o boto direito do mouse sobre o Grupo OPC e selecione a opo Inserir - Nova Pasta.
Figura 107: Inserindo uma Pasta OPC
146
Drivers
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: Clique com o boto direito do mouse sobre o Grupo OPC e selecione a opo Inserir - Tag de Comunicao OPC;
Figura 108: Inserindo um Tag de Comunicao OPC
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.
Figura 109: Inserindo Tags de Comunicao OPC
Drivers
147
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.
148
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: Clique com o boto direito do mouse sobre o Grupo OPC e selecione a opo Inserir - Bloco de Comunicao OPC;
Figura 110: Inserindo um Bloco de Comunicao OPC
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;
Figura 111: Inserindo Blocos de Comunicao OPC
Drivers
149
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;
Figura 112: Configurando o Bloco de Comunicao
Informe o tamanho do bloco e a opo de mapeamento; Clique em [OK]; 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.
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:
Tabela ndice
5 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.
150
Drivers
NOTA: O E3 pode criar automaticamente os elementos de Bloco OPC. Para maiores detalhes, veja a opo Importar tags, na seo Configurao dos Drivers OPC. Para utilizar este recurso, siga estes procedimentos: Clique com o boto direito do mouse sobre o Bloco OPC e selecione a opo Inserir - Elemento de Bloco OPC.
Figura 113: 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.
4.4. Qualidade
Os campos de qualidade representam o estado de 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, Campo Substatus e Campo 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
Drivers 151
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.
Opes disponveis no campo Qualidade CAMPO QUALIDADE DESCRIO O valor no til pelas razes Ruim indicadas no substatus. A qualidade do valor incerta pelas Incerta razes indicadas no substatus. (Reservado) No usado pelo padro OPC. Boa A qualidade do valor Boa.
QUALIDADE 0 - 63 64 - 127 128 - 191 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 retornar 0 para o Substatus e limite.
4.4.1.
Campo SubStatus
O layout deste campo depende do valor do campo Qualidade.

SubStatus para Qualidade RUIM DESCRIO Sem Limite
SUBSTATUS
LIMITE Constante 3 7 11 15
Drivers
Baixo
No especfico Erro de Configurao
No Conectado
Falha de Dispositivo
152
O valor ruim, mas nenhuma razo especifica conhecida. H algum problema de configurao especfico no servidor. Por exemplo, o item em questo pode ter sido apagado. A entrada 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 dispositivo foi detectada.
0 4
1 5
12
13
Alto 2 6 10 14
SUBSTATUS
DESCRIO Sem Limite
LIMITE Constante 19 23 27 31 Constante 67 71

153
Baixo
Falha de Sensor
ltimo valor conhecido
Falha de Comunicao Fora de Servio N/A
Uma falha de sensor foi detectada (o campo Limite pode prover informao adicional). Comunicao em falha. Entretanto, o ultimo valor conhecido est disponvel. Note que a idade do valor pode ser determinada pela propriedade TimeStamp. Comunicaes esto em falha. No h ultimo valor conhecido disponvel. O Bloco est fora de scan ou trancado. No usado.
16
17
20
21
24
25
28
29
32 - 63
SUBSTATUS
SubStatus para Qualidade INCERTA DESCRIO Sem Limite
LIMITE
Baixo
No especfico ltimo valor usvel
No especfico. O dispositivo que estava providenciando o valor parou de faz-lo. 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.
64 68
65 69
Drivers
Alto 66 70
Alto 18 22 26 30
SUBSTATUS
DESCRIO Sem Limite
LIMITE Constante 83 87 91 Constante 195 219

Drivers
Baixo
No utilizado Sensor impreciso
Unidade de engenharia excedida
Sub-Normal
No utilizado
No utilizado em OPC. O Valor est 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 retornado est fora dos limites definidos para esse parmetro. Note que nesse caso o valor do campo Limites indica quais limites foram excedidos, mas no necessariamente implica que o valor no possa ir mais alm da faixa especificada. O valor derivado de mltiplas fontes e h um nmero menor do que o requerido de fontes boas. No utilizado em OPC.
80
81
72 - 79 82
84
85
88
89
92 - 127
NOTA: Servidores que no suportam o Substatus devem retornar 0.

SubStatus para Qualidade BOA DESCRIO Sem Limite
SUBSTATUS
LIMITE
Baixo
No especfico No utilizado Forado localmente No especfico

154
O valor bom. No h condies especiais. No utilizado. Tipicamente indica que a entrada foi desconectada e um valor entrado manualmente foi forado. No usado em OPC.
192
193
216
196 - 215 217 218
220 - 255
Alto 194
Alto 86 90
NOTA: Servidores que no suportam o SubStatus devem retornar 0.
4.4.2.
Campo Limite
O Campo Limite vlido independentemente dos campos Qualidade e Substatus. Em alguns casos como uma falha de sensor ele pode prover informao de diagnstico.
Campo Limite ESPECIFICAES No Limitado Limite Inferior Limite Superior Constante DESCRIO O valor livre para mover 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 mover-se.
NOTA: Servidores que no suportam Limite devem retornar 0.
Drivers
155
Captulo
5
5.
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: Clique com o boto direito do mouse sobre o projeto no Organizer, selecione a opo Inserir - Servidor de Dados.
Figura 114: Inserindo um Servidor de Dados
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: Clique com o boto direito do mouse sobre o Servidor de Dados e selecione a opo Inserir - Panel - Pasta de Dados.
Servido de Dados
157
Figura 115: 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:
158
Servidor de Dados
Clique com o boto direito do mouse sobre o Servidor de Dados e selecione a opo Inserir - Panel - Tag Contador;
Figura 116: Inserindo um Tag Contador
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.
Figura 117: 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.
Servidor de Dados
159
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 curvas definidas ou valores aleatrios. Para utilizar este recurso, siga estes procedimentos: Clique com o boto direito do mouse sobre o Servidor de Dados e selecione a opo Inserir - Panel - Tag Demo;
Figura 118: Inserindo um Tag Demo
Figura 119: Inserindo Tags Demo
160
Servidor de Dados
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: Clique com o boto direito do mouse sobre o Servidor de Dados e selecione a opo Inserir - Panel - Tag Interno;
Figura 120: Inserindo um Tag Interno
Servidor de Dados
161
Figura 121: 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.
5.5. Tag Timer

O Tag Timer um objeto para contagem de tempo e programao de atividades. Ele estabelece horrios (com repeties) para executar aes. Para utilizar este objeto, siga estes procedimentos: Clique com o boto direito do mouse sobre o Servidor de Dados e selecione a opo Inserir - Panel - Tag Timer;
Figura 122: Inserindo um Tag Timer
162
Servidor de Dados
Figura 123: 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
163
Captulo
6
6.
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 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 e selecione o item Inserir - Tela.
Figura 124: Inserindo um Tela na aplicao
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:
165
Figura 125: Configurando o tamanho da Tela
Opes disponveis na janela Tamanho da Tela OPO DESCRIO Permite escolher o Divisor onde a Tela ser aberta. Escolha o Divisor onde a Tela ser So listados apenas os Divisores cuja Tela associada aberta propriedade SplitLink ser visvel em tempo de execuo. Habilita a Tela como Tela Inicial do Divisor onde Configurar como Tela inicial do ser aberta. Divisor Determina o nome da Tela. Nome Determina a largura da Tela, em pixels. Largura Determina a altura da Tela, em pixels. 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.
166
Figura 126: 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.
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); 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 abaixo. Elas podem ser rotacionadas ou redimensionadas livremente, exceto pelo objeto Figura.
167
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: Selecione a Linha na barra de ferramentas Tela; Clique na Tela para criar o ponto de origem da reta e arraste o mouse at seu ponto final.
6.2.2.
Retngulo
Permite o desenho de retngulos, criados a partir de dois vrtices. Para utilizar este objeto, siga estes procedimentos: Selecione o Retngulo na barra de ferramentas Tela; 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.3.
Retngulo Arredondado
Permite o desenho de retngulos com cantos arredondados, criados a partir de dois vrtices. Para utilizar este objeto, siga estes procedimentos: Selecione o Retngulo Arredondado na barra de ferramentas Tela; 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; 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.4.
Elipse
Permite o desenho de crculos e elipses. Para utilizar este objeto, siga estes procedimentos: Selecione a Elipse na barra de ferramentas Tela;
168 Telas e Objetos de Tela
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.
6.2.5.
Arco de Elipse
Permite o desenho de objetos do tipo arco, corda ou torta. Para utilizar este objeto, siga estes procedimentos: Selecione o Arco de Elipse na barra de ferramentas Tela; 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; 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; 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.6.
Desenho Livre
Permite a criao de desenhos a mo livre. Para utilizar este objeto, siga estes procedimentos: Selecione o Desenho Livre na barra de ferramentas Tela;
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.7.
Polgono
Permite o desenho de polgonos com lados retos. Para utilizar este objeto, siga estes procedimentos: Selecione o Polgono na barra de ferramentas Tela; 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; Quando desejar trocar a direo do desenho, d um clique simples no mouse. Quando desejar finaliz-lo, clique duas vezes.
169
6.2.8.
Polgono de Curvas
Permite o desenho de polgonos com lados curvos. Para utilizar este objeto, siga estes procedimentos: Selecione o Polgono de Curvas na barra de ferramentas Tela;
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; Quando desejar trocar a direo do desenho, d um clique simples no mouse. Quando desejar finaliz-lo, clique duas vezes.
6.2.9.
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: Selecione a Figura na barra de ferramentas Tela;
Clique na Tela para criar o vrtice de origem do retngulo e arraste o mouse diagonalmente at seu vrtice final; O sistema abrir uma caixa para seleo do arquivo de imagem, conforme figura a seguir:
170
Figura 127: Seleo do arquivo de imagem
Selecione o arquivo e clique em [Abrir] para inserir a figura na Tela.
6.2.10. Texto
Permite a criao de um texto que ser exibido na Tela. Para utilizar este objeto, siga estes procedimentos: Selecione o Texto na barra de ferramentas Tela; Digite o texto desejado e pressione a tecla [Enter]; Caso queira alterar ou digitar contedos neste objeto, utilize a propriedade Value.
6.2.11. Display
Permite criar um objeto que utilizado para mostrar os valores dos tags em tempo de execuo. Para utilizar este objeto, siga estes procedimentos: Selecione o Display na barra de ferramentas Tela;
Clique na Tela para criar o vrtice de origem do objeto e arraste o mouse diagonalmente at seu vrtice final; Clique com o boto direito no objeto para abrir a Janela de Propriedades. Na aba Item, escolha o tag a ser associado propriedade Value do Display.
171
6.2.12. 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: Selecione o SetPoint na barra de ferramentas Tela;
Clique na Tela para criar o vrtice de origem do objeto e arraste o mouse diagonalmente at seu vrtice final; Clique com o boto direito no objeto para abrir a Janela de Propriedades. Na aba Item, escolha o tag a ser associado propriedade Value do SetPoint.
6.2.13. Escala
Permite a criao de um objeto que desenha rguas ou escalas de valores. Para utilizar este objeto, siga estes procedimentos: Selecione a Escala na barra de ferramentas Tela;
Clique na Tela para criar o vrtice de origem do objeto e arraste o mouse diagonalmente at seu vrtice final.
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 com relao Tela. As opes de alinhamento disponveis so: Alinhar Esquerda: alinha dois ou mais objetos entre si tendo como referncia a coordenada esquerda do ltimo objeto selecionado. Alinhar Direita: alinha dois ou mais objetos entre si tendo como referncia a coordenada direita do ltimo objeto selecionado. Alinhamento Superior: alinha dois ou mais objetos entre si tendo como referncia a coordenada superior do ltimo objeto selecionado. Alinhamento Inferior: alinha dois ou mais objetos entre si tendo como referncia a coordenada inferior do ltimo objeto selecionado. Alinhamento Central Horizontal: alinha dois ou mais objetos horizontalmente entre si tendo como referncia o ltimo objeto selecionado.
Alinhamento Central Vertical: alinha dois ou mais objetos verticalmente entre si tendo como referncia o ltimo objeto selecionado. Mesma Largura: aplica a largura do ltimo objeto selecionado aos demais objetos selecionados. Mesma Altura: aplica a altura do ltimo objeto selecionado aos demais objetos selecionados. Mesmo Tamanho: aplica a largura e a altura do ltimo objeto selecionado aos demais objetos selecionados. Centralizar Horizontalmente: centraliza o objeto na Tela de acordo com suas coordenadas horizontais. Centralizar Verticalmente: centraliza o objeto na Tela de acordo com suas coordenadas verticais. Distribuir Horizontalmente: aplica a mesma distncia horizontal entre si a trs ou mais objetos. Distribuir Verticalmente: aplica a mesma distncia vertical entre si a trs ou mais objetos.
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:
173
Figura 128: Propriedades da Grade

Opes disponveis na janela Propriedades da Grade OPO DESCRIO A grade mostra pontos apenas nas interseces de Pontilhada linhas. A grade mostra a linha inteira pontilhada. Linhas pontilhadas Alinha o mouse grade automaticamente. Alinhar mouse automaticamente Determina a distncia entre as linhas horizontais. Comprimento Determina a distncia entre as linhas verticais. Largura Determina a cor da grade. 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: Selecione um objeto na Tela e clique no boto Rotacionar ferramentas Tela; , na barra de
Clique em um de seus vrtices de rotao (em verde) e arraste o objeto at a posio desejada; Caso seja necessrio, altere o centro de rotao do objeto (marcado por um crculo verde).
174
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: Selecione a Tela e clique no boto Ordem dos Tabs Tela; , na barra de ferramentas
Clique nos objetos conforme a ordenao desejada. O nmero com a ordem de navegao aparecer no canto superior esquerdo do objeto. Quando o Domnio for executado, a navegao entre estes objetos ser feita conforme a ordem especificada.
Figura 129: Ordem dos Tabs
6.3.5.
Agrupar / Desagrupar
Permite transformar mais de um objeto em apenas um, com propriedades especficas. Para utilizar este recurso, siga estes procedimentos: Selecione na Tela os objetos que devem formar o grupo; 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; Para desfazer a unio de um grupo de objetos, selecione a opo Desagrupar ; Para editar um objeto contido em um grupo, clique com o boto direito do mouse no objeto e selecione a opo Editar Grupo.
6.3.6.
Animao
175
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: Animar 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: Selecione o objeto na Tela e clique no boto Animar com Translao;
Com o cursor do mouse, habilite as configuraes da orientao do objeto;
Figura 130: 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: Selecione o objeto na Tela e clique no boto Animar com Rotao;
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; 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.
Figura 131: Rotao
176
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.
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 de preenchimento de toda a altura, toda a largura e toda a pgina, e preenchimento total da 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 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.
177
OPO Camada Todas as camadas Nenhuma camada Editar camadas
Quando a opo Editar camadas selecionada, a seguinte janela mostrada.
Figura 132: Edio de Camadas
A janela Edio de Camadas tem os seguintes botes: Adicionar Camada para a criao de uma nova camada; Remover Camada camada selecionada; e Editar Camada Ao clicar nos botes ou , para a edio da camada selecionada.
, para a excluso da
, a seguinte janela aberta:
Figura 133: Adio / Edio de camada
178
Opes disponveis na Camada DESCRIO Determina o nome da camada. Nome Define a porcentagem inicial de zoom na camada. Zoom Baixo Define a porcentagem final de zoom na camada. Zoom Alto Habilita a utilizao de uma condio adicional de Usar condio adicional de visibilidade de zoom na camada. Esta condio pode ser visibilidade uma varivel ou propriedade qualquer. Estabelece uma associao ou propriedade, que uma vez Fonte ativo (diferente de zero), tambm exibe a camada (as opes de Zoom e Fonte no so exclusivas, isto , pode ativar a camada estando uma condio ou outra ativa). OPO
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 .
Figura 134: Objeto travado
Para desabilitar esta opo, basta clicar novamente com o boto direito no objeto e selecionar a opo Destravar.
6.3.11. 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
Telas e Objetos de Tela 179
visualizado se a opo Alinhar Mouse Automaticamente (propriedade da Grade) estiver habilitada.
Figura 135: Objeto com ncora
6.3.12. Sombreamento
Permite aplicar ou editar o efeito de sombra em um objeto de Tela.
Figura 136: Opes da sombra
Para utilizar este recurso, siga estes procedimentos: Insira ou selecione o objeto ao qual deseja aplicar a sombra; Altere suas propriedades atravs da barra de ferramentas Sombra, de acordo com as seguintes opes:
Opes disponveis na barra de ferramentas Sombra DESCRIO Habilita ou desabilita o efeito de sombra no objeto. Desloca a sombra abaixo do objeto. Desloca a sombra acima do objeto. Desloca a sombra esquerda do objeto. Desloca a sombra direita do objeto. Configura a cor da sombra do objeto.
OPO
180
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.
Figura 137: Opes de desenho
Para utilizar este recurso, siga estes procedimentos: Insira ou selecione o objeto (Tela ou objeto de Tela) cujas cores ou bordas deseja editar; 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:
181
Figura 138: Efeitos de preenchimento
As opes disponveis nesta janela so:

Opes disponveis na janela Preenchimento OPO DESCRIO Mostra todos os estilos de preenchimento disponveis para o Estilos objeto selecionado. Mostra a cor da frente previamente selecionada para o Cor da frente objeto. Permite tambm a seleo de uma nova cor da Cor do fundo frente, nos mesmos moldes que o boto . 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 . 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).
Amostra Opaco/transparente
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:
182
Selecione o objeto a servir como modelo para os demais;

Clique com o boto direito do mouse e selecione a opo Configurar como Padro; 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 anterior a objetos previamente criados. Para utilizar este recurso, siga estes procedimentos: Selecione o objeto ao qual o padro deve ser aplicado; Clique com o boto direito do mouse e selecione a opo Aplicar Estilo.
6.4. Formatao de Cores

A formatao das cores no E3 Studio pode ser feita atravs de caixas de dilogo como a mostrada a seguir. 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 suas componentes.
Figura 139: Cores
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).
Figura 140: 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 uma 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; Sat (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; Lum (luminosidade): indica a quantida de luz aplicada cor. Quanto maior a luminosidade, mais clara a cor; do mesmo modo, quanto menor a luminosidade, mais escura a cor. 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 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.
185
Figura 141: 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 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 (;). Para inserir caracteres que sero mostrados pelo formatador pode-se coloc-los entre aspas (") ou aps uma barra (\). Exemplos (vlidos para todos os tipos de formatadores):
Entrada de Texto SADA FORMATADA 0#? mdy
FORMATADOR "0#?" \m\d\y
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 FORMATADOR SADA FORMATADA "Positivo";"Negativo";"Zero","Texto" Positivo "Positivo";"Negativo";"Zero","Texto" Negativo "Positivo";"Negativo";"Zero","Texto" Zero "Positivo";"Negativo";"Zero","Texto" Texto
VALOR 1 -1 0 "ABCD"
Alm disso, os seguintes caracteres podem ser mostrados diretamente sem o uso de aspas ou barra: $ - + / () : ! ^ & ' (aspas simples esquerda) ' (aspas simples direita) ~ { } = < > OBS: Para mostrar a barra (\) 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 de dgitos apresentados:
Formatadores Numricos 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.
OPO 0 (zero) # ?
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 FORMATADOR SADA FORMATADA #, 12 #,#.0 1,234,567.0
DADO 12000 1234567
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 FORMATADOR SADA FORMATADA #E+00 1E+03 ##e-00 10e02
DADO 1000 1000
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 COMANDO @@ Abc Abc "Nome: " \ " @ \ " Nome: "xyZ"
DADO Abc xyZ
AO
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:
188
DADO 255 12345 987 12
Formatadores para Bases No-Decimais FORMATADOR SADA FORMATADA "0x"XXX 0x0FF oooo\o 30071o B 1111011011 BBBB - BBBB 0000 - 1100
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:
Formatadores para Datas e Horas FORMATADOR SADA FORMATADA dd/MMMM/yyyy 18/maio/1903 hh:mm:ss.000 tt 01:37:45.696 PM hh\hmm\mss.000\s 296 h17 m46.667 s
DADO 1234.56789 0.56789 12.345678
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.
189
Captulo
7
7.
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. Alm destes, pode-se inserir qualquer outro objeto ActiveX. Para registrar um ActiveX no E3, siga estes procedimentos: Acesse o menu Ferramentas - Adicionar ActiveX.... O sistema mostrar a caixa de dilogo a seguir:
Figura 142: Registrando um ActiveX no E3
Clique no boto [Registrar...]. O sistema abre uma caixa de dilogo para localizao do arquivo que contm o ActiveX;
ActiveX
191
Figura 143: Localizao do arquivo ActiveX
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 direto do mouse no objeto Tela, no Organizer, selecionando a opo Inserir; Atravs do clique com o boto direto do mouse na Tela, selecionando a opo Inserir.
Figura 144: 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.
192
ActiveX
7.1. Objetos Microsoft Forms

Para inserir um dos objetos Microsoft Forms previamente registrados no E3 na aplicao, existem duas opes: Clique com o boto direito do mouse na Tela e selecione a opo Inserir - MSForms; ou 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 os seguintes: 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 . 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 . 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 prestabelecida. inserido na Tela atravs do boto 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 . Texto Exibe mensagens de texto que no podem ser editadas pelo usurio, como descries de controles ou legendas. inserido na Tela atravs do boto . .
ActiveX
193
Lista Exibe uma lista de itens dentre os quais o usurio pode escolher um ou mais. inserido na Tela atravs do boto . 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 .
Boto Incremento-Decremento Usado para incrementar ou decrementar valores atravs de seu par de setas. inserido na Tela atravs do boto Editor de Texto Possibilita ao usurio inserir e editar textos. inserido na Tela atravs do boto . .
Boto Liga-Desliga Permite atribuir um de dois estados a um outro objeto de Tela. inserido na Tela atravs do boto .
194
ActiveX
Captulo
8
8.
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, siga este procedimento: Clique com o boto direito do mouse no nome do projeto e escolha a opo Inserir Quadro.
Figura 145: Inserindo um Quadro na aplicao
O Quadro possui subdivises, chamadas de Divisores, que podem ser inseridas ou removidas do Quadro atravs de um menu no boto direito na view de Design. A princpio, o Quadro possui um Divisor inicial, que pode ser subdivido 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.
Quadros 195
Apenas o Divisor 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 DESCRIO dockBottom: este Divisor est posicionado na parte inferior do Divisor-Pai. dockTop: este Divisor est posicionado na parte superior do DivisorPai. 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.
CONE
Cada Divisor corresponde visualizao de uma Tela ou Quadro de seu processo ou a uma URL (Uniform Resource Locator). Para utilizar este recurso, siga estes procedimentos: 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;
Figura 146: Inserindo um divisor horizontal
Para remover um Divisor, clique com o boto direito do mouse sobre o Quadro aberto e selecione a opo Remover Quadro;
196
Quadros
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 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; 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; Pode-se inserir vrios Divisores no Quadro;
Figura 147: Divisores do Quadro
Para configurar os Divisores do Quadro, clique com o boto direito do mouse no Organizer sobre o Divisor desejado e selecione a opo Propriedades.
Quadros
197
Figura 148: Configuraes do Quadro

Opes disponveis na aba Quadro 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.
OPO Link
Posio Valor
Algumas das propriedades do Quadro/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.
198
Quadros
Captulo
9
9.
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 duas vezes 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.
Figura 149: Pgina de Associaes
As opes disponveis na aba Associaes so as seguintes:

Opes disponveis na aba Associaes OPO DESCRIO Lista as propriedades do objeto que podem ser Propriedades associadas. Indica o tipo de conexo que a propriedade possui. Para Conexo propriedades comuns, as conexes disponveis so as seguintes: simples, bidirecional, analgica, digital, por tabela e reversa. 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).
Associaes
199
OPO Fonte
DESCRIO 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.
Ao especificar a fonte da associao, o texto da mesma 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 conexes disponveis sero explicados a seguir.
200
Associaes
9.1. Conexo Simples

Na Conexo Simples, o valor do campo Fonte copiado para a propriedade toda vez que o primeiro for modificado.
Figura 150: Conexo simples
Para utilizar este recurso, siga estes procedimentos: Selecione o objeto desejado para a conexo; Acesse as propriedades deste objeto atravs do clique com o boto direito do mouse e selecionando a opo Propriedades; Clique na aba Associaes e selecione a propriedade que deseja fazer a conexo. O sistema indicar vrios tipos de conexes; No campo Fonte, selecione a conexo desejada e clique no boto do AppBrowser para indicar a propriedade que deseja referenciar ou escreva a expresso neste campo.
Associaes
201
9.2. Conexo Bidirecional

A Conexo Bidirecional semelhante a Conexo Simples porm, caso haja uma variao na propriedade, seu valor ser copiado para a Fonte, gerando assim, uma associao de duas direes.
Figura 151: Conexo Bidirecional
Para utilizar este recurso, siga estes procedimentos: Selecione o objeto desejado para a conexo; Acesse as propriedades deste objeto atravs do clique com o boto direito do mouse e selecionando a opo Propriedades; Clique na aba Associaes e selecione a propriedade que deseja fazer a conexo. O sistema indicar vrios tipos de conexes; No campo Fonte, selecione a conexo desejada e clique no boto do AppBrowser para indicar a propriedade que deseja referenciar ou escreva a expresso neste campo;
202
Associaes
9.3. Conexo Digital

J na Conexo 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 (alternao de valores).
Figura 152: Conexo digital
As opes disponveis nesta conexo so as seguintes:

Opes disponveis para Conexo Digital DESCRIO Especifica o valor assumido pela propriedade quando a Ligado expresso da fonte for True. Especifica o valor assumido pela propriedade quando a Desligado expresso da fonte resultar em False. Quando este campo estiver habilitado, a propriedade conectada Pisca ir alternar entre os valores do campo Para o valor, caso a fonte retorne True. Caso contrrio, a propriedade retornada ir alternar entre os valores dos campos Valor e Para o valor caso a fonte retorne False. Especifica o valor alternativo a ser assumido periodicamente Para o valor pela propriedade quando a expresso ou associao da fonte <Campo Ligado> resultar em True e o campo Pisca estiver habilitado. Especifica o valor alternativo a ser assumido periodicamente Para o valor pela propriedade quando a expresso da fonte resultar em False <Campo Desligado> e o campo Pisca estiver desabilitado. OPO
Para utilizar este recurso, siga estes procedimentos: Selecione o objeto desejado para a conexo;
Associaes 203
Acesse as propriedades deste objeto atravs do clique com o boto direito do mouse e selecionando a opo Propriedades; Clique na aba Associaes e selecione a propriedade que deseja fazer a conexo. O sistema indicar vrios tipos de conexes; No campo Fonte, selecione a conexo desejada e clique no boto do AppBrowser para indicar a propriedade que deseja referenciar ou escreva a expresso neste campo.
204
Associaes
9.4. Conexo Analgica

A Conexo 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.
Figura 153: Conexo analgica

Opes disponveis para Conexo Analgica OPO DESCRIO Determina os valores mnimo e mximo atingidos na fonte. Valor da Fonte Determina os valores mnimo e mximo atingidos na Valor na Propriedade propriedade.
Para utilizar este recurso, siga estes procedimentos: Selecione o objeto desejado para a conexo; Acesse as propriedades deste objeto e clique na aba Associaes. Selecione a propriedade que deseja fazer a conexo. O sistema indicar vrios tipos de conexes; No campo Fonte, selecione a conexo desejada e clique no boto do AppBrowser para indicar a propriedade que deseja referenciar ou escreva a expresso neste campo.
9.5. Conexo por Tabela

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

Opes disponveis para Conexo por Tabela DESCRIO Insere uma nova linha na tabela. Remove a linha selecionada da tabela. 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.
OPO Boto Boto Min Max Valor Pisca
Valor < Pisca Habilitado>
Para utilizar este recurso, siga estes procedimentos: Na aba Associaes, selecione a propriedade e associe a opo Conexo por tabela; Crie as linhas desejadas na tabela e configure os valores mnimo, mximo e valor;
206 Associaes
Caso deseje alternar periodicamente entre os valores, habilite o campo Pisca e configure as opes restantes.
Associaes
207
9.6. Conexo Reversa

Na Conexo Reversa, toda vez que o valor da propriedade for modificado, este ser copiado para a Fonte, funcionando assim de maneira reversa Conexo Simples. Para utilizar este recurso, siga estes procedimentos: Clique nas propriedades do objeto e escolha a opo Associaes; Selecione a propriedade que deseja fazer a associao, e clique no item Conexo Reversa; No campo Fonte, selecione a conexo desejada e clique no boto do AppBrowser para indicar a propriedade que deseja referenciar ou escreva a expresso neste campo.
Figura 155: Conexo Reversa
9.7. Edio de Associaes

O E3 possui uma ferramenta para edio das associaes, chamada Edio de Associaes. Assim, possvel mudar uma ou mais associaes feitas na aplicao de forma mais rpida que pela janela tradicional. O acesso a esta ferramenta pode ser feito clicando com o boto direito do mouse sobre um ou mais objetos e selecionando a opo Editar Associaes.
208
Associaes
Figura 156: Acesso opo Editar Associaes
A seguinte caixa de dilogo mostrada:
Figura 157: 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. De acordo com o tipo de linha, temos as seguintes informaes dispostas nas colunas:
Associaes
209
Opes disponveis na janela Editar Associaes OPES DESCRIO Determina o nome do objeto. Nome do objeto Determina a propriedade do objeto que possui a associao. Propriedade / Evento Determina o tipo de associao (analgica, digital, simples, Conexo reversa, bidirecional ou por tabela). Determina a fonte da associao. Fonte
OPO Nome do objeto Propriedade / Evento Conexo Fonte
Opes para Propriedades do tipo Link DESCRIO Determina o nome do objeto que possui a propriedade. Determina o nome da propriedade. sempre a mesma - link. Determina o valor da propriedade.
OPO Nome do objeto Propriedade / Evento Conexo Fonte
Opes para Eventos do usurio 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.
Na caixa de dilogo Editar Associaes, permitido modificar o seguinte: Associaes: Podem ser modificadas, exceto o nome do objeto; 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.
210
Associaes
Figura 158: Edio das propriedades da associao selecionada
Para editar as propriedades dos eventos do usurio, necessrio selecionarmos a linha que contm o evento e na coluna Conexo, clicar na opo Editar.
Figura 159: 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.
Figura 160: Edio de eventos
Associaes
211
Opes disponveis na janela Editar Eventos OPO DESCRIO Propriedade ou expresso geradora do evento. A propriedade/expresso Indica que o evento ser do tipo etOnEvent ou For uma condio verdadeira etWhileEvent. Indica o ciclo de repetio do evento em ms, isto , Repetir o evento a cada ... ms de quanto em quanto tempo ele ir ocorrer, enquanto a expresso geradora for verdadeira. Alterar o seu valor 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.
Tratar a desconexo como mudana
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.
Figura 161: Copiar e colar uma associao
212
Associaes
10
10.
Captulo
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.
Figura 162: Viewer
Para criar um Viewer no projeto, siga estes procedimentos: Verifique se j existe um Viewer em seu Domnio, ou insira um novo caso contrrio atravs do clique com o boto direito do mouse sobre o Projeto e selecionando a opo Inserir - Viewer.
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.
Viewer 213
Figura 163: Aba Visualizador
Cada campo da aba Visualizador possui uma propriedade correspondente. As opes disponveis so as seguintes:
Opes disponveis na aba Visualizador DESCRIO Determina o ttulo do Viewer. Este campo equivale Ttulo propriedade Caption do objeto Viewer. Determina a Tela ou quadro que o Viewer ir iniciar. Tela ou Quadro Inicial OPO 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. Determina a visualizao no Viewer. Atravs das suas opes, possvel configurar para que o Viewer inicialize : 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 porcentagem de zoom. Habilita a barra de rolagem na pgina inicial. Habilita a exibio do menu de Zoom com o boto direito em tempo de execuo. Este campo equivale propriedade EnableZoomMenu do objeto Viewer. Habilita o Viewer a manter as Telas carregadas na memria. Este campo equivale propriedade CacheEnable do objeto Viewer.
Zoom
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
214
Viewer
OPO Verificar inatividade aps ... minutos
Nmero de retentativas para confirmao de usurio ou senha
DESCRIO Define o tempo mximo de espera, em minutos, por um evento de mouse ou teclado para o perodo de inatividade. Este campo equivale propriedade EnableInactivity do objeto Viewer. Estabelece o nmero de vezes que o dilogo de login ser exibido alm da primeira vez. Este campo equivale propriedade LoginRetries do objeto Viewer.
10.1.2. Configurao
Atravs da aba Configurao, pode-se editar as opes relativas a janela, ttulo e resoluo do Viewer.
Figura 164: Aba Configurao
Cada campo da aba Configurao possui uma propriedade correspondente. As opes disponveis so as seguintes:
Viewer
215
Opes disponveis na aba Configurao OPO DESCRIO Determina o estilo da janela do Viewer. Este campo Iniciar Maximizada / equivale propriedade WindowStyle e possui as seguintes Minimizada / Janelada 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 inimizada. Desabilita a troca de janelas. Este campo equivale Desabilitar troca de janelas propriedade DisabletaskSwitching do objeto Viewer. Habilita a barra de ttulo. Este campo equivale Barra de ttulo propriedade TitleBar do objeto Viewer. Habilita o boto de fechar. Este campo equivale Boto de fechar propriedade CloseButton do objeto Viewer. Habilita o boto de minimizar. Este campo equivale Boto de minimizar propriedade MinimizeButton do objeto Viewer. Habilita o boto de maximizar. Este campo equivale Boto de maximizar propriedade MaximizeButton do objeto Viewer. Seleciona a resoluo da Tela: 640 x 480, 800 x 600, 1024 Resoluo da Tela x 768, 1280 x 1024, ou 1600 x 1200 pixels. Abre a janela para configuraes avanadas. Avanado
Ao clicar no boto [Avanado], a seguinte janela aberta:
Figura 165: Configuraes avanadas
216
Viewer
As opes disponveis nesta janela so as seguintes:

Opes disponveis na janela Configuraes Avanadas OPO DESCRIO Permite escolher entre a resoluo atual do computador ou Resoluo da Tela em pixels uma resoluo escolhida pelo usurio, em pixels. Permite escolher o desconto aplicado na resoluo da Tela Desconto na resoluo da Tela entre a configurao atual do computador ou uma resoluo em pixels escolhida pelo usurio, em pixels. Permite escolher entre a resoluo atual do computador ou Resoluo do monitor em um resoluo escolhida pelo usurio, em pontos por pontos por polegada (DPI) polegada (DPI).
10.1.3. Erros de Comunicao

No Viewer, possvel visualizar os erros de comunicao das tags quando as mesmas estiverem associadas a Displays ou SetPoints. Isto possvel configurando as informaes contidas na aba Erros de Comunicao, disponvel nas propriedades do Viewer.
Figura 166: Aba Erros de comunicao
As opes disponveis nesta aba so as seguintes:

Opes disponveis na aba Erros de Comunicao OPO DESCRIO Visualizar erros de comunicao Habilita ou desabilita a visualizao dos erros de comunicao. Contm o texto que ser mostrado no SetPoint, caso a Texto qualidade do valor seja ruim. Contm a cor que deve ser usada no texto. Cor da letra
Viewer 217
OPO Cor de fundo
DESCRIO 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.
10.2. Variveis no Viewer

No objeto Viewer possvel fazer associaes com objetos a partir de Telas, bem como us-los 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: Clique no objeto Viewer. O Viewer mostrar o seu filho nomeado _top;
Figura 167: Objeto _top
218
Viewer
Para configurar as propriedades do objeto Top, clique com o boto direito do mouse sobre o mesmo e selecione a opo Propriedades; Este objeto possui as mesmas funcionalidades do objeto Divisor do Quadro, e tais informaes podem ser encontradas no captulo 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: Clique com o boto direito do mouse sobre o Viewer e selecione a opo Inserir Pasta do Viewer.
Figura 168: Inserindo Pasta do Viewer
NOTA: Uma aplicao que contenha Pastas do Viewer no poder ser aberta em verses do E3 anteriores 3.1.
Viewer
219
11
11.
Captulo
Banco de Dados
0 1 0
Banco de Dados
0 0
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 e escolha a opo Inserir - Banco de Dados.
Figura 169: Inserindo um Banco de Dados
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.
221
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: Clique com o boto direito 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; Para configur-lo, acesse a aba Configuraes da Janela de Propriedades:
Figura 170: Configuraes para Banco de Dados Access
As opes disponveis nesta aba so:

Opes disponveis na aba Configurao OPO DESCRIO Seleciona o tipo de Banco de Dados em uso no projeto: Banco de Dados 0 - stAccess; 1 - stOracle; ou 2 - stSqlServer. Arquivo MDB Senha do BD Usurio Senha Testar conexo Nome do arquivo .MDB utilizado no projeto. Senha do Banco de Dados Access. Usurio do Banco de Dados conectado pelo E3. Senha do usurio que realizar o logon. Testa a conexo com o Banco de Dados
No campo Banco de Dados, selecione a opo 0 - stAccess; Insira o nome do arquivo desejado (existente ou no) no campo Arquivo MDB (conforme figura anterior); 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;
Banco de Dados
222
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 BD 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: Clique com o boto direito 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; Para configur-lo, acesse a aba Configuraes da Janela de Propriedades:
Figura 171: Configuraes para Banco de Dados Oracle
Banco de Dados
223
Opes disponveis na aba Configurao OPO DESCRIO Seleciona o tipo de Banco de Dados em uso no projeto: Banco de Dados 0 - stAccess; 1 - stOracle; ou 2 - stSqlServer. Nome da conexo fornecido pelo administrador do Conexo banco. Permite usar o tipo de dado do Oracle, com preciso de Usar tipo TIMESTAMP milissegundos. Permite usar as interfaces do Oracle para fazer consultas Usar drivers ADO Oracle a este banco de dados. Usurio do Banco de Dados conectado pelo E3. Usurio Senha do usurio que realizar o logon. Senha Testa a conexo com o Banco de Dados. Testar conexo
No campo Banco de Dados, selecione a opo 1 stOracle; 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; Caso seja necesssrio, 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; 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 Banco de Dados. O Servidor BD 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 eles consegue instanciar qualquer objeto ActiveX registrado no sistema. Para o acesso ao BD, 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;_
224 Banco de Dados
DataSource=conexaoOracle;User_ ID=UserID;Password=passwd"
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 MovePrev, bem como uma srie de outros comando 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 criado para acessar informaes de SGBD usando OLE DB. Essa tecnologia fica disponvel quando instalamos o OLE DB Provider para Oracle (MSDAORA). Ela faz o acesso interface nativa do Oracle, a OCI. A OCI utilizada pelo Servidor BD do E3 para implementar os servios de Banco de Dados utilizados pelos Histricos, Frmulas, Alarmes e Storage. Atravs da OCI, acessamos 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 BD.
Banco de Dados 225
Um bom exemplo de como funciona a comunicao do Servidor BD 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 BD do E3 possui um processo separado especialmente para receb-las. Dependendo do tipo de operao a ser realizada, os dados so formatados e armazenados em arquivo ou memria temporrios. Ao mesmo tempo, o BD 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.
226
Banco de Dados
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: Clique com o boto direito 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; Para configur-lo, acesse a aba Configuraes da Janela de Propriedades:
Figura 172: Configuraes para o Banco de Dados SQL Server

Opes disponveis na aba Configurao OPO DESCRIO Seleciona o tipo de Banco de Dados em uso no projeto: Banco de Dados 0 - stAccess; 1 - stOracle; ou 2 - stSqlServer. Nome do servidor. Servidor Nome do Banco de Dados. Banco de Dados Biblioteca de Rede Biblioteca de rede utilizada pelo ADO: 0 - Padro; 1 Named Pipes; 2 - Winsock TCP/IP, 3 - SPX/IPX; 4 Banyan Vines; ou 5 - Multi-Protocol (RCP).
Banco de Dados
227
OPO Usurio
Senha Testar conexo
DESCRIO 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.
No campo Banco de Dados, selecione a opo 2 - stSqlServer; Caso seja necesssrio, 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; 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: Crie um Tag Demo. As configuraes deste tag no necessitam ser alteradas; D um duplo clique no ServidorBD 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; Faa as configuraes necessrias nesta janela, tais como nome do servidor, usurio, senha e Banco de Dados; 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;
Figura 173: Histrico e suas configuraes
228
Banco de Dados
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 Analyser, que o cliente usado para consultas no SQLServer; Finalizada a configurao do Histrico, ser necessria a criao da estrutura de tabelas no ServidorBD. 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;
Para visualizar o Histrico em ao (salvando dados no servidor SQL Server), crie uma Tela, insira um E3Browser e configure-o para acessar o ServidorBD como explicado acima no Histrico e configure o E3Browser para ser atualizado automaticamente a cada 10 segundos, por exemplo; Feitas as configuraes, execute o projeto. Depois de um tempo executando o projeto, o E3Browser passar a exibir os dados que esto sendo enviados ao servidor; 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 Analyser. Para isso, crie diferentes consultas ao Banco de Dados e editeas na Query 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 na Query, 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 segue o modelo definido 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 existe 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:
Banco de Dados
229
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 tabelas ou remover tabelas existentes; Criar ndices e chaves; Inserir e excluir dados nas tabelas criadas; Consultas sobre as tabelas resultantes. O usurio no precisa ser um Administrador para possuir Permisso Completa em qualquer objeto.
230
Banco de Dados
12
12.
Captulo
Alarmes
O E3 dispe de um conjunto de objetos que permitem ao usurio monitorar alarmes em sua aplicao. Com eles, possvel especificar e gerenciar alarmes e eventos de variveis de um processo. As condies de alarmes 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 estes procedimentos: Clique com o boto direito do mouse sobre o Organizer e escolha a opo Inserir - Configurao de Alarmes.
Figura 174: Inserindo o objeto Configurao de Alarmes
Alarmes
231
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, operao e monitoramento de um conjunto de fontes de alarmes 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 Fonte de Alarmes. Caso haja necessidade, novas reas podem ser inseridas dentro de outras. Para inserir este objeto, siga estes procedimentos: Clique com o boto direito do mouse no objeto Configurao de Alarmes ou no objeto rea e escolha a opo Inserir - rea;
Figura 175: Inserindo uma rea
232
Alarmes
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.
12.1.2. 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 Alarmes 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, alarme de banda morta, alarme digital e alarme de taxa de variao. Para inserir este objeto, siga estes procedimentos: Clique com o boto direito do mouse no objeto rea e escolha a opo Inserir - Alarme (Analgico, de Banda Morta, Digital, ROC);
Figura 176: Inserindo uma Fonte de Alarme
Alarmes
233
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.
Figura 177: Fontes de Alarmes
Ao abrir a Janela de Propriedades de qualquer fonte de alarme e escolher a aba Fonte, a seguinte janela aberta:
Figura 178: 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 alarmes possuem as seguintes propriedades gerais:
234 Alarmes
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 de mensagem de 200 caracteres. 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 no Banco de dados, etc. H vrios tipos de Fontes de Alarme que podem ser inseridas na rea de Alarme. As opes disponveis so as seguintes: Analgico Permite monitorar uma varivel analgica, pela especificao de at 4 nveis de alarme, que so o LOLO (Muito Baixo), LO (Baixo), HI (Alto) e HIHI (Muito Alto).
Figura 179: Fonte de Alarme Analgico

Opes disponveis na aba Analgico OPO DESCRIO Habilita a verificao do tipo de alarme escolhido. Habilitao (LoLo, Lo, Hi, HiHi) Indica o nvel em que o alarme ser disparado. Limite
Alarmes 235
OPO Texto da mensagem Severidade Pede Ack Espera Banda morta
Voltar ao normal
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 (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 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.
Digital Permite monitorar uma varivel digital, pela especificao de alarme na borda de subida (em -1 ou TRUE) ou borda de descida (em 0 ou FALSE).
Figura 180: Fonte de Alarme Digital

Opes disponveis na aba Digital DESCRIO Habilita o alarme digital. Determina o valor booleano do alarme (True/False). Permite especificar o texto que ser mostrado para o usurio quando o alarme estiver em condio ativa.
OPO Alarme Digital Valor de Alarme Texto da mensagem
236
Alarmes
OPO Severidade Pede Ack Espera Voltar ao normal
DESCRIO Determina a severidade do nvel de alarme (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 espera. Permite especificar o texto a ser mostrado para o usurio quando o alarme no estiver em condio ativa.
Banda Morta Permite monitorar uma varivel analgica pela especificao de um limite mximo de diferena (Valor da banda morta), em relao a um valor de referncia (SetPoint).
Figura 181: Banda morta
Este tipo de alarme interessante quando a referncia (SetPoint) varivel, e tambm quando se deseja evitar uma quantidade desnecessria de alarmes para pequenas oscilaes da varivel monitorada.
Alarmes
237
Figura 182: Fonte de Alarme Banda Morta

Opes disponveis na aba Banda Morta DESCRIO Associao para a varivel de referncia, para que seja SetPoint monitorada uma diferena em relao varivel de monitorao. Habilita a banda morta, que um recurso utilizado para evitar BM (Banda Morta) 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 Valor 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 Texto da mensagem quando o alarme estiver em condio ativa. Determina a severidade do nvel de alarme (alta, mdia ou Severidade baixa) Habilita ou desabilita o reconhecimento do alarme. Pede Ack Especifica o tempo de espera, em ms. Quando o valor for 0 Espera (padro), no aplicada espera. Permite especificar o texto a ser mostrado para o usurio Voltar ao normal quando o alarme no estiver em condio ativa. OPO
Taxa de variao Usado para monitorar variaes muito rpidas em uma varivel do processo. A taxa de variao usa seus valores especificados em unidades da varivel por segundo.
238
Alarmes
Figura 183: Fonte de Alarme Taxa de Variao

Opes disponveis na aba Taxa de Variao OPO DESCRIO Habilita a verificao do alarme Taxa de variao. TDV Indica a porcentagem da varivel monitorada que pode Variao por Segundo: variar por segundo. Este valor calculado tomando como base cada intervalo de leitura da varivel, pela frmula: ROC ou TDV = (ValorAtual - ValorAnterior) / (InstanteAtual - InstanteAnterior). Se o ROC for maior que a taxa especificada, ser considerado estado de alarme. Permite especificar o texto que ser mostrado para o Texto da mensagem usurio quando o alarme estiver em condio ativa. Determina a severidade do nvel de alarme (alta, mdia Severidade ou baixa). Habilita ou desabilita o reconhecimento do alarme. Pede Ack Especifica o tempo de espera, em ms. Quando o valor Espera for 0 (padro), no aplicada espera. Determina a mensagem de texto que ser mostrada ao Voltar ao normal usurio quando o alarme voltar ao estado normal.
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 alarmes para todos os Viewers conectados, bem como enviar esses eventos para um Banco de Dados, se necessrio.
Alarmes 239
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: Clique com o boto direito do mouse sobre o nome do projeto no Organizer e selecione a opo Inserir - Servidor de Alarmes.
Figura 184: Inserindo um Servidor de Alarmes
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.
240
Alarmes
Figura 185: 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 DESCRIO Habilita ou desabilita o armazenamento dos dados dos Guarde alarmes no Banco de alarmes no Banco de Dados. Este campo equivale Dados propriedade Logging. Define o servidor de Banco de Dados que armazenar os Utilize o servidor de banco de dados do alarme. Este campo equivale propriedade dados DataSource. Define o nome da tabela de alarmes. Este campo equivale Nome da Tabela propriedade TableName. Habilita ou desabilita o descarte de dados da tabela Descarta dados da tabela principal. O dado ser antigo de acordo com o que for principal definido na opo Mantenha os dados do(s) ltimo(s).... Este campo equivale propriedade EnableDiscard. Determina o intervalo de tempo (minutos, horas, dias ou Mantenha os dados do(s) meses) durante o qual os dados sero mantidos na tabela ltimo(s)... principal. Se um dado da tabela for mais antigo que o < Tabela Principal > 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.
Alarmes 241
OPO A verificao deve ocorrer a cada...
Dados descartados devem ser armazenados Mantenha os dados do(s) ltimo(s)... < Tabela de Backup >
Campos...
Gerar Tabela
DESCRIO 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 na ordem em que estas colunas aparecero. Gera a tabela dos alarmes no Banco de Dados especificado.
Os campos disponveis no Servidor de Alarmes para gerao da tabela de alarmes so os seguintes:

Opes disponveis para tabelas dos Campos dos alarmes OPO DESCRIO Informa se o alarme foi reconhecido ou no. Este campo Acked pode assumir os seguintes valores: 0: no-reconhecido; (Reconhecido) 1: reconhecido. Determina o reconhecimento automtico do alarme. AckRequired Este campo apresenta os seguintes valores: 0: (Necessita Reconhecimento) reconhecimento automtico; 1: reconhecimento manual. Registra a data/hora do E3 no momento em que o AckTime alarme reconhecido, ou zero (30/12/1899), enquanto o (DataHora - Reconhecido) alarme no tenha sido reconhecido. No caso de alarmes que no pedem reconhecimento, o campo assume a data/hora do E3 no momento em que o alarme fica ativo. Semelhante ao campo anterior. usado para facilitar a AckTimeDbl gravao de dados do tipo Double no caso do Banco de (DataHora - Reconhecido Dados ser Oracle ou SQL Server. Double)
242
Alarmes
OPO ActorID (Operador)
DESCRIO Nome do operador que reconheceu o alarme. Pode ser: O usurio logado no Viewer, quando reconhecimento feito no E3Alarm (ou (Sem usurio), se no h usurio logado); System, quando o reconhecimento automtico (ou seja, para alarmes que pedem reconhecimento); Um nome passado por Scripts (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. Registra o nome da fonte de alarme. O limite deste campo quando amarzenado no Banco de Dados de 100 caracteres. Ex: FonteAlarme1. Para eventos de alarmes, 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 alarmes 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. 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.
243
AlarmSourceName (Nome da Fonte) Area (rea)
ChangeMask (Mscara) ConditionActive (Condio Ativa)
ConditionName (Nome da Condio)
Cookie (Cookie) CurrentValue (Valor)
Alarmes
OPO Enabled (Habilitado)
EventCategory (Categoria)
EventCLSID (Ciclo de vida)
EventTime (DataHora) EventTimeDbl (DataHora - Double) EventTimeUTC (DataHoraUTC)
EventType (Tipo)
FormattedValue (Valor Formatado)
FullAlarmSourceName (Nome da Fonte - Completo)
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. 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/hora do valor da fonte do alarme no momento do evento. Semelhante ao campo anterior. usado para facilitar a gravao de dados do tipo Double no caso do Banco de Dados ser Oracle ou SQL Server. Data/hora do valor da fonte do 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. 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 (Ex: 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. Obs.: 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. Ex: Pasta1.ConfigAlarmes1.Area1.FonteAlarme1.
244
Alarmes
OPO InTime (Data - Entrada) InTimeDbl (Data - Entrada - Double) Message (Mensagem)
OutTime (DataHora - Sada)
OutTimeDbl (DataHora - Sada - Double) Quality (Qualidade)
Severity (Severidade)
Source (Fonte)
SubConditionName (Nome da Subcondio)
DESCRIO Registra a data/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 do Banco de Dados ser 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/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 do Banco de Dados ser Oracle ou SQL Server. Qualidade do valor de fonte do 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). o valor de severidade configurado na fonte de alarmes. 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. Ex: Dados.TagDemo1.Value. 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; e 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.
Alarmes
245
OPO Campos do Usurio (UserField1, UserField2, UserField3, UserField4)
DESCRIO 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 a monitorao 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 Banco de Dados Oracle. Observe que estes campos no esto disponveis no E3Alarm, pois l possvel visualizar os milissegundos atravs da formatao das colunas de Data e Hora. Depois de definidas todas as configuraes, o sistema inicializa as inseres e gravaes das informaes na tabela dos alarmes, conforme as especificaes dos campos. Quando o boto [Gerar tabela] clicado, o sistema gera a tabela de dados dos alarmes conforme as especificaes, e informa se a tabela foi gerada com sucesso.
Figura 186: 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).
246
Alarmes
Figura 187: 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 (DBServer) um mdulo do E3 que deve ser inserido em sua aplicao.
12.2.2. Configuraes dos Campos do Usurio

Na aba Campos do Usurio pode-se adicionar valores arbitrrios aos eventos de alarmes.
Figura 188: Campos do usurio
Alarmes
247
OPO Campo Nome Tipo Tamanho Fonte
Opes disponveis na aba Campos do usurio 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.
248
Alarmes
13
13.
Captulo
E3Alarm
O E3Alarm serve para monitorao dos alarmes ativos ou no-reconhecidos no sistema. Atravs deste objeto, possvel verificar o estado dos alarmes no sistema, bem como reconhec-los manualmente.
Figura 189: E3Alarms
Para utilizar este objeto, siga estes procedimentos: Insira este objeto no projeto atravs do clique com o boto direito do mouse em um objeto Tela ou na rea de trabalho e selecionando a opo Inserir E3Alarm, ou ento atravs da Barra de Ferramentas Objeto, selecionando o boto E3Alarm;
Figura 190: 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.
E3Alarm
249
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.
Figura 191: Aba Geral
Cada campo da aba Geral possui uma propriedade correspondente. As opes disponveis so as seguintes:
Opes disponveis na aba Geral DESCRIO 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 False, mltiplos filtros de rea podem ser usados, separados por dois pontos. Este campo equivale propriedade Filter. 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). Habilita o tipo de filtro aplicado no alarme (Apenas alarmes, Apenas eventos, Alarmes e Eventos). Este campo equivale propriedade FilterType.
OPES Filtros
Mostre alarmes de severidade Filtrar por tipo
250
E3Alarm
OPES 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.
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.
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, neste manual.
Figura 192: 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.
E3Alarm
251
Figura 193: Propriedades da coluna

Opes disponveis na Aba Coluna OPO DESCRIO Determina a largura da coluna, em pixels. A largura Esta coluna ter ... pixels de padro das colunas do E3Alarm 80 pixels. largura Determina o formatador utilizado na coluna do Formatador E3Alarm. O formatador utilizado o padro do E3 (ver seo 6.5, Formatao de Valores), com exceo do campo Severidade e dos campos Condio Ativa, Precisa Ack, Reconhecido e Habilitado, cujos exemplos de formatao podem ser vistos nas tabelas a seguir. Renomeia o ttulo da coluna. Renomear para Permite configurar o reconhecimento do alarme quando Permite reconhecer 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. (Obs.: Se o alarme puder ser reconhecido, o formato do cursor do mouse muda de uma seta para uma mo, em tempo de execuo, quando ele estiver sobre uma linha de alarme no-reconhecido). Habilita ou desabilita o piscar da coluna.
Esta coluna nunca pisca
252
E3Alarm
DADO Severidade Alta Severidade Mdia Severidade Baixa
Formatador para o campo Severidade FORMATADOR SADA FORMATADA ;;; Alta "A";"M";"B" M ;;; Baixa
Formatador para os campos Condio Ativa, Precisa Ack, Reconhecido e Habilitado DADO Verdadeiro Falso Verdadeiro Falso Verdadeiro Falso FORMATADOR "OK";"No OK" "OK";"No OK" "AAA" "AAA" ; ; SADA FORMATADA OK No OK AAA No Sim No
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.
Figura 194: Aba Ordenao
E3Alarm
253
Cada campo da aba Ordenao possui uma propriedade correspondente. As propriedades disponveis so as seguintes:
Opes disponveis na aba Ordenao 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 propriedade PrimarySortAscending em True. Ordena os campos do alarme de forma descendente. Este campo equivale propriedade PrimarySortAscending em False.
OPO Pelo campo Depois pelo campo
Ascendente
Descendente
NOTA: A ordenao padro feita atravs do campo InTime, de maneira descendente.
13.1.4. Configurao de Cores

Na aba Cores so definidas as cores dos alarmes no objeto. Cada item da listagem traz especificaes a respeito do estado do alarme, conforme a figura a seguir:
Figura 195: Aba Cores
254
E3Alarm
Para cada tipo de alarme (Ativo, Reconhecido, No Reconhecido ou Evento) podese escolher uma cor para o texto, uma cor para o fundo e o comportamento de pisca. Clicando no boto [...] a seguinte janela mostrada:
Figura 196: Cores do alarme
As opes disponveis nesta janela so as seguintes:

Opes disponveis na janela Cores DESCRIO Determina a cor de fundo do alarme. Determina a cor do texto do alarme. Se esta opo estiver selecionada, a cor de texto e de fundo do alarme no alternam. Se esta opo estiver selecionada, as cores selecionadas para o fundo e para o texto do alarme alternam entre si. Se esta opo estiver selecionada, somente a cor do texto do alarme alterna entre as cores selecionadas para o fundo e para o texto.
OPO Cor de fundo Cor do texto No Pisca Pisca fundo e texto Pisca apenas texto
Ao expandir os itens de alarmes, possvel redefinir as cores de fundo, de texto e o comportamento de pisca para cada tipo de severidade (Alta, Mdia ou Baixa), conforme a figura a seguir:
E3Alarm
255
Figura 197: Cores para a severidade
Ao clicar no boto [...], a seguinte janela mostrada:
Figura 198: Redefinio das Cores da severidade

Opes da janela Cores por severidade OPO DESCRIO Redefine a cor de fundo para a severidade. Redefinir cor de fundo Redefine a cor do texto para a severidade. Redefinir cor do texto Redefine se o comportamento de pisca do alarme ser Redefinir pisca sobrescrito. Se esta opo estiver selecionada, a cor de texto e de fundo da No pisca severidade no alternam. Se esta opo estiver selecionada, as cores selecionadas para o Pisca fundo e texto fundo e para o texto da severidade alternam entre si. Se esta opo estiver selecionada, somente a cor do texto da Pisca apenas texto severidade alterna entre as cores selecionadas para o fundo e para o texto.
256
E3Alarm
NOTA: A configurao de cores para os tipos de severidade herdada automaticamente da configurao de cores para os alarmes. Marcar qualquer opo da janela de Cores para a severidade sobrescreve os valores definidos para o alarme. Desmarcar qualquer opo faz com que a severidade volte a ter a mesma configurao de cor do alarme.
13.1.5. Configurao de Fontes

Atravs da aba Fonte, possvel configurar a fonte do cabealho e das linhas do E3Alarm.
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.
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

Durante a operao de runtime, os alarmes do sistema podem ser visualizados no E3Alarm.
E3Alarm
257
Figura 200: 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 for False, 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 for True, 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.
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:
Figura 201: Opes de reconhecimento de alarmes

Opes disponveis na janela Reconhecimento de Alarmes OPO DESCRIO Reconhece apenas os alarmes Somente os alarmes selecionados sero reconhecidos. selecionados Todos os alarmes visveis neste E3Alarm sero Reconhece todos os alarmes do reconhecidos. filtro corrente
258 E3Alarm
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 estiver configurada para False; 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 o pop-up Reconhecimento aparecer. Clicando sobre ele, a caixa de dilogo de reconhecimento aparecer. Esta opo estar desabilitada caso a propriedade AllowAckCurrentFilter estiver configurada para False; 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 estiver configurada para False. 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 runtime: clique ou duplo-clique 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.
E3Alarm
259
Figura 202: Exemplo de ordenao
Na figura anterior, os alarmes esto ordenados primeiro por rea, de forma ascendente, e depois por Data/Hora (Entrada), tambm de forma ascendente.
260
E3Alarm
14
14.
Captulo
Histricos
Histricos so mdulos responsveis pelo armazenamento de dados da aplicao no 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 Evento. Atravs da propriedade CacheSize, define-se o nmero de registros enviados por vez para o DB. 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: Clique com o boto direito do mouse no nome do projeto e selecione a opo Inserir - Histrico;
Figura 203: Inserindo um Histrico
Quando o Histrico for habilitado, as seguintes opes de configurao so apresentadas:

261
Histricos
Figura 204: Opes do Histrico

Opes disponveis na view do Histrico 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.
BOTO
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, no captulo referente ao objeto Histrico.
262
Histricos
14.1. Configuraes do Histrico

Quando um Histrico inserido no projeto, o campo E3TimeStamp criado automaticamente na tabela. O E3TimeStamp mostra a data/hora que o valor foi buscado (diferente do Timestamp do Tag). Vale lembrar que este campo utilizado somente para leitura. possvel associar um tag ao 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). (Remover campo). A
Para remover algum campo indesejado, clique no Boto seguinte mensagem de confirmao aparecer:
Figura 205: 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, n 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
Histricos 263
simples ou composta. Ou seja, no podemos 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 seqencialmente. 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 configurao, conforme a figura a seguir: , que abre a janela de
Figura 206: 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 DESCRIO Determina o nome da chave primria. Nome do ndice Se habilitada, faz com que os valores especificados Garantir que os valores deste ndice para o ndice Chave Primria sejam nicos. sejam nicos Mostra o nome do campo. Nome do campo
264 Histricos
OPO Ordenao Tipo Mude a ordem dos campos
DESCRIO 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.
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. 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 seqencialmente. Note que se for preciso acessar quase todos os 1.000 registros, no entanto, mais rpido acess-los seqencialmente, 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 pode ser configurados atravs do cone configurao, conforme figura a seguir: , que abrir a janela de
Histricos
265
Figura 207: Editor de ndices

Opes disponveis na janela Editor de ndices OPO DESCRIO Mostra o nome do ndice existente. Nome Mostra o campo ao qual o ndice est associado na tabela. Campos Abre uma caixa de dilogo para a adio de um ndice. Boto [Adicionar] Abre uma caixa de dilogo para a edio do ndice Boto [Editar] selecionado. Remove o ndice selecionado. Boto [Remover]
Quando o boto [Adicionar] clicado, a seguinte caixa de dilogo aberta:
Figura 208: Adicionando ndices
266
Histricos

Opes disponveis na adio de ndices OPO DESCRIO Determina o nome do ndice. Nome do ndice Se habilitada, faz com que os valores especificados Garantir que os valores deste ndice para o ndice sejam nicos. sejam nicos Mostra os nomes dos campos. Marque aqueles que Nome do campo devem pertencer ao ndice. Mostra a ordenao do campo selecionado Ordenao (Ascendente ou Descendente). Mostra o tipo do campo da tabela. Tipo Muda a posio do campo na tabela, fazendo com Mude a ordem dos campos que ele suba ou desa.
Clicando no boto [OK], os ndices na tabela so confirmados. Para cancelar a configurao, clique no boto [Cancelar].
14.1.3. Configuraes da Tabela

Depois de definidas as opes acima, 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:
Histricos
267
Figura 209: Propriedades do Histrico
Cada campo da aba Histrico possui uma propriedade correspondente. As opes disponveis so as seguintes:
Opes disponveis na aba Histrico OPO DESCRIO Define o servidor de Banco de Dados. Este campo equivale Utilize o servidor de banco de propriedade DbServer. dados Determina o nome da tabela. Este campo equivale Nome da tabela propriedade TableName. Determina a variao do intervalo de tempo (em ms), ou Gravar um novo registro a seja, de quanto em quanto tempo os dados do Histrico cada... sero gravados na tabela. Este campo equivale propriedade ScanTime. Habilita ou desabilita o descarte dos dados da tabela Descarta dados da tabela principal. O dado ser antigo de acordo com o que for principal definido na opo Mantenha os dados do(s) ltimo(s).... Este campo equivale propriedade EnableDiscard.
268
Histricos
OPO 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
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. 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.
Quando a opo Gerar Tabela acionada, o sistema mostra a seguinte mensagem:
Figura 210: 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.
Histricos
269
Figura 211: Campos
Os campos disponveis na tabela do histrico so os seguintes:

Campos da tabela do Histrico DESCRIO 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. 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.
CAMPOS FieldDeadBand FieldDeadBandUnit FieldDescription FieldEU FieldHighEng FieldID FieldLowEng FieldMaxRecTime FieldMinRecTime 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
270 Histricos
abre uma caixa de dilogo para determinar quais as tabelas sero vinculadas ao histrico corrente, conforme figura a seguir:
Figura 212: Seleo de tabela para vinculo com Histrico
Quando a tabela selecionada e clicado no boto [OK], o sistema mostra a seguinte mensagem:
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: Histrico sem vnculos diretos com tabela existente e tabela original. Manter
Buscar campos da
Quando a opo Manter Histrico sem vnculos diretos com tabela existente habilitada, o sistema mostra a seguinte mensagem:
Histricos
271
Figura 214: Mensagem do sistema quanto a 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).
Figura 215: 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:
Figura 216: Histrico utilizando a opo Buscar campos da tabela original
272
Histricos
15
15.
Captulo
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 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 (recurso 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. Exemplos: a) Grfico sem compactao A informao processada contm vrios pontos.
Storage
273
Figura 217: Grfico sem compactao
b) Grfico com compactao Veja que a informao praticamente a mesma, s que com menos pontos.
Figura 218: 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 FieldMinRecTime). Para inserir esta ferramenta no E3, siga estes procedimentos: Clique com o boto direito do mouse sobre o nome do projeto e selecione a opo Inserir - Storage;
274
Storage
Figura 219: Inserindo um Storage
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.
15.2. Configuraes do Storage

Quando o Storage criado na tela, mostrada uma lista de definies dos campos de gravao.
Figura 220: 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 (Ex: Driver1.Tag1+Driver1.Tag2).
Storage 275
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 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 Fonte Tipo MinRecTime MaxRecTime Banda Morta Unidade Determina o nome do campo da tabela do Storage. Determina a fonte de dados que ser associada ao campo. Determina o tipo do campo da tabela do Storage. Tempo mnimo para insero de um dado na tabela. Este tempo calculado em milissegundos. Tempo mximo de espera por um dado. Se passar esse tempo, o dado passa a ficar antigo e armazenado. Banda morta para clculo do algoritmo. Valor absoluto ou a porcentagem de modificao.
OPO
276
Storage
15.3. Configurao da Tabela

Pode-se acessar as configuraes da tabela utilizada no Storage de duas maneiras: Atravs do boto Propriedades;
Atravs do clique com o boto direito do mouse sobre o objeto no Organizer e selecionando a opo Propriedades.
Figura 221: Campos do Storage
Cada campo da aba Storage possui uma propriedade correspondente. As opes disponveis so as seguintes:
Opes disponveis na aba Storage OPO DESCRIO Define o servidor de Banco de Dados. Este campo Utilize o servidor de banco de equivale propriedade DbServer. dados
Storage 277
OPO Nome da 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
DESCRIO Determina o nome da tabela. Este campo equivale propriedade TableName. 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 no Organizer, ou atravs do boto Tabela. Gerar
Aps definir as configuraes da tabela, necessrio clicar no boto Gerar Tabela. Esta ao cria a estrutura da tabela no banco de dados. A tabela do Storage semelhante a 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.
278
Storage
Figura 222: Tabela Fields
Esta tabela possui os seguintes campos:

Campos da tabela _Fields DESCRIO 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. Tamanho do campo. Associao utilizada para obter valores deste campo. Tipo do campo.
CAMPOS FieldDeadBand FieldDeadBandUnit FieldDescription FieldEU FieldHighEng FieldID FieldLowEng FieldMaxRecTime FieldMinRecTime FieldName FieldQuality FieldSize FieldSource FieldType
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.
Storage 279
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 voc 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 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, bom) de acordo 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 (Numero Real) , j para a tabela de digitais trata-se de um numero inteiro e para os textos trata-se de um campo NVARCHAR de tamanho varivel, especificado pelo usurio no campo StringFieldSize.
15.3.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 a 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 forem sendo obtidos novos valores para as variveis, um algoritmo de verificao de gravao vai interpretando a seqncia e decidindo se cada ponto ser ou no armazenado.
280
Storage
Figura 223: 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 (ex: equipamento perdeu a comunicao) para que sejam gravados.
15.3.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.
Storage 281
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, Boolean, String), FieldEU (Unidades de Engenharia), FieldLowEng FieldHighEng (Limites Superiores), 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. 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 do CheckBox Incluir Qualidade Ruim.
282
Storage
Figura 224: Funes
15.3.3. Utilizao
Se a funo escolhida possui algum filtro, ento necessrio informar o valor dos filtros antes de executar a consulta, seja no prprio dilogo de configurao (atravs da aba Visualizar) ou atravs de scripts, usando o mtodo SetVariableValue(). Exemplos:
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.3.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

Storage
STORED PROCEDURE E3LastValue

283
FUNO QUERY ArchivedValue CompressedDataNValues CompressedDataStartEndTime SampledData CalculatedData
STORED PROCEDURE E3Archive, E3ArchiveInterpolate E3NCompData E3CompData E3SampledData E3CalculatedData
As Stored Procedures que utilizam parmetros de Datas as recebem 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 desta funo. E3LastValue Retorna o ltimo valor que est armazenado no Banco de um determinado tag. 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, 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
284
Storage
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
E3ArchiveInterpolate Retorna os pontos imediatamente anterior e posterior 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
Storage 285
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 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:
286 Storage
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 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. 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
E3CalculatedData Equivale funo CalculatedData. A descrio formal :

E3CalculatedData( @iSubType int, @strTableName varchar(100), @iModMin int, @dStartDate float, @dEndDate float,
Storage 287
@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
288
Storage
16
16.
Captulo
Consultas
O objeto Consulta (ou Query) auxilia no processo de definio de consultas no Banco de Dados da aplicao. Toda a vez que os objetos E3Browser ou Relatrio vo buscar dados do Banco de Dados necessrio enviar um comando para o mesmo, de forma que se saiba quais os dados desejados para aquele objeto. Logo, toda a 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: 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 ao mesmo automaticamente. No entanto, voc tambm pode 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 que a consulta ir buscar os dados. Para tanto, selecione na lista.
Figura 225: Definio do Servidor Banco de Dados
A configurao da consulta depende do objeto em que ela est relacionada.
Consultas
289
Figura 226: 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 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.
16.1. Criando uma Consulta

Quando um E3Browser, Relatrio ou E3Chart so criados no projeto, inserem automaticamente uma consulta como filho, com o nome Consulta1. Para utilizar este recurso, siga estes procedimentos: Ao clicar na consulta, uma janela mostrada, solicitando a identificao do Servidor de Banco de Dados da aplicao:
Figura 227: Definio do Servidor Banco de Dados na Consulta
290
Consultas
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:
Figura 228: Adio de tabela
Selecione as tabelas que faro parte da consulta e clique no boto [Adicionar]; Depois de definidas as tabelas, a janela de definio de consultas mostrada, onde destacam-se cinco principais subdivises horizontais: Funes gerais; Tabelas; Colunas; Sintaxe SQL; Resultado ou prvia da consulta.
A seguinte janela mostrada:
Consultas
291
Figura 229: Configurao da Consulta
A janela anterior tambm pode ser acessada atravs do clique com o boto direito do mouse sobre o objeto e selecionando a opo Configurar.
16.2. Funes Gerais

Na primeira subdiviso, pode-se destacar os seguintes elementos:
Figura 230: Funes Gerais
Opes disponveis na janela Definio de Consulta OPO DESCRIO Permite que se retorne janela anterior adicionando uma ou Boto [Adicionar Tabela] mais de uma tabela. Executa a consulta SQL, exibindo os resultados na diviso Boto [Gerar Consulta] inferior da janela. Permite a definio de valores padro para variveis definidas Editar Variveis pelo usurio. Essas variveis tambm podem ter seu valor alterado em execuo atravs do mtodo SetVariableValue().
292
Consultas
OPO Habilitar edio direta no SQL
DESCRIO Habilitando esta opo, o usurio questionado se deseja abandonar a conexo existente entre o ambiente visual da consulta para poder editar o comando SQL diretamente. Ao escolher esta opo, possvel retornar edio visual, porm a sintaxe alterada manualmente ser sobrescrita na primeira modificao.
16.3. Tabelas
Neste item, so exibidas as tabelas selecionadas para a consulta, que podem ser excludas ao serem fechadas. Novas tabelas podem ser inseridas pelo boto [Adicionar tabelas].
Figura 231: Inserindo Tabela
Para selecionar todos os campos da tabela para fazer parte da consulta, clique no primeiro item na caixa de texto, correspondente ao smbolo "*". Para adicionar um campo especfico, basta clicar na caixa de seleo correspondente.
Figura 232: Tabela
Por questes de performance, importante adicionar consulta somente os campos que realmente interessam para a anlise.
Consultas 293
16.4. Colunas
Na diviso de colunas, so mostrados os campos escolhidos.
Figura 233: Diviso de colunas
Nestes campos escolhidos so definidas as seguintes propriedades para cada um deles:

Opes disponveis para configurao de colunas OPO DESCRIO Mostra o nome das colunas selecionadas. Ao clicar neste campo, Colunas podemos redefinir a coluna desejada. Permite que um novo nome seja definido para a Coluna (tambm Ttulos conhecido como Alias). Mostra o nome da tabela de origem do campo. Tabela Habilita ou desabilita o campo. Mostrar Permite ordenar os valores: sem ordenao, ascendente (valores Ordenao menores primeiro) e descendente (valores maiores primeiro). Define a prioridade quando mais de um campo possui ordenao. Ordem Permite que os dados sejam agrupados a cada novo valor do campo Agrupado por em questo. Permite definir a execuo de uma funo para o campo. Funo Define um critrio de consulta, como por exemplo, intervalos de Filtro data.
Ao definir um filtro, a janela abaixo aparecer, permitindo que se defina o tipo de comparao e o valor a ser comparado.
294
Consultas
Figura 234: Definio do filtro
O tipo de dado de comparao pode ser definido ao clicar com o mouse na caixa de texto correspondente e aparecer uma lista de opes (Empty, NULL, Boolean, Integer, Long, Currency, Single, Double, Date e String).
Figura 235: Definio e configurao do filtro
O valor de comparao poder ser fixo (Ex: 123, 45, "ABCD", etc.) ou uma varivel que ser 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.
Consultas 295
O valor da varivel pode ser definido atravs do boto [Editar variveis...] ou atravs do mtodo SetVariableValue(), chamado via Script.
16.5. Sintaxe SQL

Aqui exibida a sintaxe SQL resultante da parametrizao realizada. Voc pode editar diretamente a consulta, caso desejar, inserindo manualmente os comandos SQL.
16.6. Resultado da Consulta

Ao clicar no boto [Gerar Consulta], possvel realizar uma prvia da mesma, cujo resultado ser mostrado na parte inferior da janela. Voc pode definir tambm um nmero mximo de registros para busca, para tornar mais rpido o processo de teste.
Figura 236: Resultado da Consulta
16.7. 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()
O mtodo Requery() possibilita que os novos parmetros de consulta seja realmente utilizados, visto que uma nova consulta feita, respeitando esses novos valores.
296
Consultas
16.8. Uso de Record Sets de uma consulta atravs de scripts

Um outro uso interessante da consulta trabalhar com record sets. Depois de feita uma consulta, possvel capturar o record set 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 record set. A vantagem do uso desse recurso que, se forem feitas modificaes nas propriedades do banco, no necessrio ajustar cada um dos scripts que acessam esse banco.
Consultas
297
17
17.
Captulo
E3Browser
O E3Browser um controle ActiveX utilizado para visualizar dados armazenados em Bancos de Dados. Voc pode 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.
Figura 237: E3Browser
Para utilizar este recurso, siga estes procedimentos: Insira o E3Browser no projeto atravs do clique com o boto direito do mouse na rea de trabalho, e selecionando o objeto E3Browser; 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; 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.
E3Browser
299
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 a 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 a vez que uma aplicao E3 precisar gravar ou buscar dados armazenados num Banco de Dados, so enviados comandos no formato SQL (Structured Query Language).
Figura 238: 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.
300
E3Browser
Figura 239: Aba Consulta
Para maiores informaes sobre a Consulta, veja o captulo Consultas.
17.2. Outras configuraes do E3Browser

As configuraes disponveis no E3Browser so as seguintes:
17.2.1. Configuraes de Estilo

Atravs da aba Estilo voc pode definir a aparncia das divises (grade) das clulas e dimenses das linhas e colunas. Pela aba Opes voc pode definir o regime de atualizao dos dados e tipo de seleo das clulas.
E3Browser
301
Figura 240: Configuraes de estilo do E3Browser
Cada campo da aba Estilo possui uma propriedade correspondente. As propriedades disponveis so as seguintes:
Opes disponveis na aba Estilo DESCRIO Determina o estilo da grade do E3Browser. Este campo equivale a propriedade GridLinesType do E3Browser. Determina a altura (em pixels) do cabealho do E3Browser. Este campo equivale a propriedade FixedRowHeight do E3Browser. Determina a largura da 1 coluna na tabela. Este campo equivale a propriedade FixedColumnWidth do E3Browser. Determina a altura das linhas restantes na tabela. Este campo equivale a propriedade RowHeight do E3Browser. Determina a largura das colunas da tabela. Este campo equivale a propriedade ColumnWidth do E3Browser.
OPO Estilo de grade Altura do cabealho
Largura da 1 coluna Altura das linhas Largura das colunas
302
E3Browser
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.
Figura 241: Aba Opes
Cada campo da aba Opes possui uma propriedade correspondente. As propriedades disponveis so as seguintes:
Opes disponveis na aba Opes 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.
OPO Atualizao
Tipo de seleo
E3Browser
303
17.2.3. Configurao das cores do E3Browser

A aba Cor determina as cores do E3Browser, referente 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], pela qual ser aberta a caixa de edio da cor.
Figura 242: Configuraes da aba Cor

Opes disponveis da aba Cor DESCRIO Determina a cor conforme a propriedade selecionada. Determina o conjunto de cores a ser utilizado: cores padro ou cores do Windows. Determina a cor da propriedade selecionada. Edita uma nova cor personalizada, diferente das cores padro.
OPO Propriedades Conjunto de cores Paleta de Cores Editar cor personalizada
NOTA: o nome da aba aparece no idioma do Windows, e no necessariamente no idioma do E3.
17.2.4. Configuraes da Fonte do E3Browser

Na aba Fonte, defina as especificaes de fontes no E3Browser.
304 E3Browser
Figura 243: 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.
E3Browser
305
18
Captulo
18. 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 seqncia 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: Insira o E3Chart no projeto atravs do clique com o boto direito do mouse na Tela, e selecione o objeto E3Chart;
Figura 244: Inserindo um E3Chart na Tela
E3Chart
307
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 sobre o objeto e selecione a opo Propriedades.
18.1.1. Configuraes Gerais do E3Chart

Atravs da aba Item, possvel visualizar o nome do objeto e atribuir-lhe uma descrio.
Figura 245: Aba Item
Cada campo da aba Item possui uma propriedade correspondente. As opes disponveis so:
Opes disponveis na aba Item 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 do objeto. Este campo equivale propriedade DocString do E3Chart.
OPO Nome Documentao
A aba Posio determina o posicionamento do E3Chart na Tela.
308
E3Chart
Figura 246: Aba Posio
Cada campo da aba Posio possui uma propriedade correspondente. As opes disponveis so as seguintes:
Opes disponveis na aba Posio 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.
OPO Posio X
Posio Y Largura Altura
Atravs da aba Geral, possvel especificar o estilo e a aparncia do grfico.
Figura 247: Aba Geral
E3Chart
309
Opes disponveis na aba Geral DESCRIO Exibe o ttulo do grfico. Este campo equivale propriedade Title do E3Chart. Determina a cor de fundo do grfico Este campo Mostrar o fundo do grfico com a equivale propriedade BackColor do E3Chart. cor... Determina a cor de fundo da grade do grfico. Este Mostrar o fundo da grade com a campo equivale propriedade GridBackColor do cor... E3Chart. Determina intervalo entre as atualizaes do desenho no Intervalo entre as atualizaes grfico. Este campo equivale propriedade RefreshTime (segundos) do E3Chart. OPO Mostrar ttulo
18.1.2. Configurao dos Eixos do E3Chart

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.
Figura 248: 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.
310 E3Chart
Figura 249: 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 DESCRIO Determina o nome do eixo do grfico. Este campo Nome equivale propriedade Name do Eixo. Determina a posio do eixo no grfico: direita ou Posio 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 Espelhar o eixo efeito de espelho. Este campo equivale propriedade Mirror do Eixo. Determina o ttulo do eixo. Este campo equivale Ttulo do eixo propriedade Title do Eixo. Determina a cor da escala. Este campo corresponde Cor da escala propriedade Color do objeto Eixo. Determina a visibilidade do eixo no grfico. Este campo Visvel equivale propriedade Visible do Eixo. Determina a cor das linhas na grade. Este campo Cor das linhas da grade equivale propriedade GridColor do Eixo. Determina o estilo da linha da grade do grfico. Este Estilo da linha campo equivale propriedade GridStyle do Eixo. OPO
E3Chart
311
OPO Mostrar as linhas na grade Intervalo entre divises
Automtico
Nmero de subdivises
DESCRIO 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.
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.
Figura 250: Configuraes da escala do E3Chart
312
E3Chart
Cada campo da aba Escala possui uma propriedade ou um mtodo correspondente. As opes disponveis so as seguintes:
Opes disponveis na aba Escala 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; 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; Boto [Selecionar]: Seleciona o intervalo de tempo. Este campo corresponde ao mtodo SetHistoricPeriod() do Eixo. Inverte os valores da escala selecionada. Determina a formatao dos valores do eixo, que pode ser automtica ou personalizada. Este campo corresponde ao mtodo Format() do Eixo.
OPO Escala numrica
Mostrar ltimo perodo (tempo real) Intervalo de tempo (histrico)
Inverter Escala Formatao
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 individualmente.
E3Chart
313
Figura 251: Aba Penas
Ao adicionar uma nova pena, ao selecionar uma pena e clicar no boto [Configurar], ou ao clicar duas vezes em uma pena previamente criada, a janela de configurao das propriedades da pena aberta. Ela possui quatro abas: Geral, Dados, Estilo e Estatsticas. A aba Geral contm a informao que identifica a pena no sistema.
314
E3Chart
Figura 252: Propriedades gerais da pena
Opes disponveis na aba Geral DESCRIO Indica o nome da pena. Este campo equivale propriedade Name da Pena. Determina a cor da linha da pena. Este campo equivale Cor Principal propriedade Color da Pena. Indica o estado de visibilidade da pena no grfico. Este campo Visvel equivale propriedade Visible da Pena. Indica a unidade de engenharia utilizada pela pena. Este campo Unidade de Engenharia equivale propriedade EU. OPO Nome da Pena
Clique em [Apply] para visualizar as modificaes feitas nesta janela, e em [OK] para salv-las. A aba Dados contm a informao sobre o tipo da pena.
E3Chart 315
Figura 253: Propriedades do tipo da Pena
Cada campo da aba Dados possui uma propriedade correspondente. As opes disponveis so as seguintes:
Opes disponveis na aba Dados DESCRIO Determina o tipo de pena sendo utilizada. Este campo equivale propriedade DataSourceType da Pena. Nome da associao usada para plotar o dado em uma Link do Eixo Vertical escala vertical. Este campo equivale propriedade YLink da Pena. Nome da associao usada para plotar o dado em uma Link do Eixo Horizontal escala horizontal. Este campo equivale propriedade XLink da Pena. Habilita ou desabilita a estampa de tempo. A estampa de Usar a estampa de tempo 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. OPO Tipo de Pena
316
E3Chart
OPO Consulta Local
Consulta Externa Campo do Eixo Vertical
Campo do Eixo Horizontal
Usar Consulta Automtica
Eixo Vertical Eixo Horizontal
DESCRIO 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 SQL personalizado pelo usurio, 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. Especifica o eixo horizontal. Este campo equivale propriedade ScaleX da Pena.
Clique em [Apply] para visualizar as modificaes feitas nesta janela, e em [OK] para salv-las. A aba Estilo determina o estilo da pena.
E3Chart
317
Figura 254: Estilo da Pena
Cada campo da aba Estilo possui uma propriedade correspondente. As opes disponveis so as seguintes:
Opes disponveis na aba Estilo DESCRIO Indica o tipo de desenho da pena. Este campo equivale propriedade PenType da Pena. Determina o estilo do trao da pena. Este campo equivale propriedade PenLineStyle 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.
OPO Tipo de desenho Estilo do trao Espessura da linha Cor do fundo Documentao
318
E3Chart
OPO Habilita alarme alto
Habilita alarme baixo
Cor de alarme Cor de fundo do alarme Manter na memria as ltimas... amostras Modo de ligao entre os pontos Valor considerado para o scan de ... ms
DESCRIO Habilita a verificao do alarme alto. Este campo corresponde propriedade EnableHighLimit da Pena. O campo Valor correspondente possibilita estabelecer o limite deste alarme; equivale propriedade HighLimit. Habilita a verificao do alarme baixo. Este campo corresponde propriedade EnableLowLimit da Pena. O campo Valor correspondente 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. Determina o nmero de amostras nas penas de tempo real. Este campo equivale propriedade BufferSize da Pena. Determina o estilo do desenho (analgico ou digital). Este campo equivale propriedade DigitalData da Pena. Muda o estilo do desenho. Este campo equivale propriedade ScanValue da Pena.
Clique em [Apply] para visualizar as modificaes feitas nesta janela, e em [OK] para salv-las. A aba Estatsticas habilita o clculo de dados estatsticos.
E3Chart
319
Figura 255: Estatsticas
Cada campo da aba Estatsticas possui uma propriedade correspondente. As opes disponveis so as seguintes:
Opes disponveis na aba Estatsticas OPO DESCRIO Habilita o clculo de dados estatsticos. Calcular dados estatsticos Exibe a linha da mdia dos dados estatsticos. Mostrar linha da mdia Exibe o mnimo e o mximo dos dados estatsticos. Mostrar mnimo e mximo
Clique em [Apply] para visualizar as modificaes feitas nesta janela, e em [OK] para salv-las. O estilo do desenho da pena definido no campo Modo de ligao entre os pontos, que possui as seguintes opes: Analgico, onde o traado busca uma reta unindo cada um dos pontos do grfico, ou Digital, onde o traado sempre baseado em retas somente horizontais e verticais, sugerindo variao instantnea.
320
E3Chart
A aparncia da pena conforme a opo configurada nesta opo pode ser visualizada a seguir:
Figura 256: Modo analgico de ligao entre os pontos
Figura 257: Modo digital de ligao entre os pontos
Figura 258: O modo como a pena apresentada quando o scan considerado representado pela cor verde e quando este campo est desabilitado representado pela cor azul e rosa
E3Chart
321
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.
Figura 259: Objeto Legenda em tempo de execuo
Atravs da aba Legenda, possvel configurar as informaes referentes ao objeto Legenda e suas colunas.
Figura 260: Propriedades do Objeto Legenda
Alguns campos da aba Legenda possuem uma propriedade ou mtodo correspondente. As opes disponveis so as seguintes:
322
E3Chart
Opes disponveis na aba 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 Tamanho ser a altura ou a largura, dependendo da posio. A outra dimenso acompanha a do E3Chart. Este campo corresponde propriedade Size da Legenda. Lista as colunas disponveis para visualizao na Colunas disponveis legenda. Mostra as colunas selecionadas para a legenda. Colunas selecionadas Adiciona uma coluna legenda. Este boto equivale Boto [Adicionar] ao mtodo InsertColumn() da Legenda. Abre uma caixa de dilogo para a configurao das Boto [Propriedades] propriedades dos campos das colunas da Legenda. Remove a coluna selecionada da legenda. Este boto Boto [Remover] equivale ao mtodo Remove() da Legenda. Troca a posio da coluna na legenda. Estes campos Sobe/Desce equivalem ao mtodo ChangeColumnPos() da Legenda. Habilita o cabealho da legenda. Este campo Mostrar ttulos das colunas equivale propriedade ShowHeader da Legenda. OPO Mostrar Legenda
Os campos disponveis na opo Colunas disponveis so:

Opes disponveis para identificao de colunas OPO DESCRIO Mostra a cor da pena. Cor da Pena Mostra a descrio contida na propriedade DocString da pena. Descrio da Pena Mostra a diferena entre os cursores inicial e final. DifX Mostra a diferena no eixo Y entre os pontos interpolados inicial DifY e final. Mostra o nome do eixo X associado pena. EscalaX Mostra o nome do eixo Y associado pena. EscalaY Mostra o estado de funcionamento atual da pena. Estado Mostra a posio final do cursor. FimX Mostra o ponto interpolado onde o cursor final cruza com a pena. FimY Mostra a posio inicial do cursor. InicioX Mostra o ponto interpolado onde o cursor inicial cruza com a InicioY pena.
E3Chart 323
OPO MaximoY MediaY MinimoY Nome da Pena Nome do tagX Nome do tagY Unidade Valor do tagX Valor do tagY
DESCRIO 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. Mostra o valor da pesquisa no eixo Y.
Quando o Boto [Propriedades] clicado, mostrada uma caixa de dilogo para configurao do objeto Coluna da Legenda.
Figura 261: 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 DESCRIO Define a largura inicial da coluna, em pixels. Este campo Largura inicial equivale propriedade Width da Coluna da Legenda. Determina o ttulo da coluna. Este campo equivale Ttulo da coluna propriedade Caption da Coluna da Legenda. Determina o alinhamento do texto na coluna da legenda, Alinhamento do texto Este campo equivale propriedade TextAlign da Coluna da Legenda. Determina o formatador da coluna selecionada. Este campo Formatador equivale propriedade Format da Coluna da Legenda.
324
E3Chart
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 configurlas.
Figura 262: Configurao das Consultas

Opes disponveis na aba Consultas 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.
OPO Consultas Boto [Configurar] Boto [Adicionar]
Boto [Remover]
NOTA: Quando os botes [Adicionar] ou [Configurar] so clicados, 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.
18.1.6. Configurao das Fontes

Atravs da aba Fonte, possvel configurar a fonte do cabealho e das linhas do E3Chart.
E3Chart 325
As opes disponveis so referentes a tipo, tamanho e efeitos da fonte. NOTA: o nome da aba no idioma do Windows.
18.2. Exemplos de utilizao do E3Chart

Abaixo 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 os procedimentos a seguir: Crie um E3Chart na Tela; Acesse as propriedades do E3Chart e selecione a aba Penas. Crie uma nova pena de tempo real e associe a um Tag demo no eixo vertical; Crie dois botes de comando na Tela. No primeiro boto de comando, escreva na propriedade Caption a descrio Desabilitar pena; 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.Disconnect() End Sub
No segundo boto de comando, escreva na propriedade Caption a descrio Habilitar Pena.

E3Chart
326
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
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. Crie um E3Chart na Tela; 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); Acesse a aba Consultas e clique no boto [Adicionar]. O sistema mostrar uma caixa de dilogo para que voc indique o nome do servidor de Banco de Dados em que a tabela da consulta est armazenada; Selecione o servidor de banco de dados na caixa de dilogo e clique em [OK]. O sistema abrir as configuraes da Consulta; Selecione na tabela histrica, o campo E3TimeStamp e algum campo de dados que voc deseja mostrar no grfico; No campo E3TimeStamp, crie um filtro conforme as especificaes a seguir:
E3Chart
327
Figura 264: Filtro a ser criado no campo E3TimeStamp
Aps ter criado o filtro conforme especificaes acima, clique em [OK]; 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; No item Campo do eixo vertical, indique um campo da tabela. No item Campo do eixo horizontal, indique o campo E3TimeStamp. Clique em [OK]; Crie um novo boto na Tela e na propriedade Caption, escreva Atualizar E3Chart Histrico; 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
328
E3Chart
18.2.3. Habilitando/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: Crie um E3Chart na Tela; Acesse as propriedades do E3Chart e selecione a aba Penas. Crie uma nova pena de tempo real e associe a um Tag Demo, no eixo vertical; Crie dois botes na Tela. No primeiro, mude a propriedade Caption para Desabilitar visualizao da pena; 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
No segundo boto de comando, mude a propriedade Caption para Habilitar visualizao da penas; 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
E3Chart
329
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: Crie um E3Chart na Tela; Crie um boto de comando da Tela. Na propriedade Caption, digite o texto Criar Pena; 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 connectar" 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
330
E3Chart
18.3. Caractersticas especficas de Runtime

O E3Chart possui uma srie de caractersticas que se aplicam apenas em tempo de execuo (runtime). Essas caractersticas sero explicadas abaixo. Opes do Cursor do Mouse Clicando com o mouse na legenda do grfico, possvel redimensionar suas colunas. Para tanto, basta selecionar a coluna desejada e arrast-la. Opes do Menu do Mouse Clicando com o boto direito do mouse sobre o grfico do E3Chart, aberto um menu de opes.
Figura 265: Opes do menu do E3Chart em tempo de execuo

Opes disponveis do menu do E3Chart em tempo de execuo OPO DESCRIO Coloca o mouse no modo zoom por rea selecionada Esta Caixa de zoom opo est disponvel nos grficos de escala numrica em XY e escala fixa. Coloca o mouse em modo de movimentao das escalas. Mover Coloca o mouse em modo de movimentao das escalas Mover horizontalmente somente na direo horizontal. Coloca o mouse em modo de pesquisa de valores nos dados Pesquisar das penas.
E3Chart 331
OPO Pesquisar Intervalos Menos Zoom Mais Zoom Enquadrar tudo Enquadrar verticalmente Enquadrar horizontalmente Enquadrar Pena
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.
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.
Figura 266: A pesquisa mostrada nos campos Valor do TagX e Valor do TagY
NOTA: Para obter maiores informaes sobre as colunas Valor do Tag X e Valor do Tag Y, veja o tpico Configuraes da Legenda. 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 e arrastando-o para a posio desejada.
332
E3Chart
Figura 267: Pesquisa de intervalos
Coluna Estado da Legenda A coluna Estado da legenda mostra o estado atual da pena. Quando a pena est funcionando corretamente, mostrada a mensagem de Ok ou Sem dados. A mensagem de Ok aparece quando no ocorreu nenhum erro e a pena contm dados. A mensagem Sem dados aparece quando no ocorreu nenhum erro e a pena no contm nenhum dado. No entanto, quando h algum erro, o E3Chart mostra uma mensagem. As mensagens mostradas so as seguintes:
Sem conexo
Esta mensagem aparece na pena de tempo real, quando os valores das propriedades YLink ou XLink foram informados, mas so invlidos.
XLink no informado, YLink no informado
Esta mensagem aparece quando no foi informado o valor para a propriedade XLink ou YLink da pena.
A consulta Nome_da_Consulta no vlida
Esta mensagem indica que a consulta no foi informada ou no foi encontrada no local especificado.
Campo Nome_do_Campo no encontrado
Esta mensagem indica que o campo informado para a pena histrica no pertence consulta.
<Nome_da_Consulta> (Falha na criao da consulta)
Esta mensagem indica que a consulta no foi criada no servidor. Provavelmente ocorreu um erro de comunicao entre o Viewer e o Servidor.
E3Chart 333
<Nome_da_Consulta> (Erro ao executar a consulta)
Esta mensagem indica que a consulta contm erros e no foi completada no servidor. Verifique se a sintaxe SQL est correta.
<Nome_da_Consulta> (Desconectado)
Esta mensagem indica que o E3Chart est sem conexo com o Domnio.
<Nome_da_Consulta> (Erro ao refazer a consulta)
Esta mensagem indica que ocorreu um erro ao refazer a consulta. Este problema poderia ocorrer, por exemplo, se a conexo for perdida depois de j ter feito a consulta pelo menos uma vez.
<Nome_da_Consulta> (Falha ao ler os campo da tabela)
Esta mensagem indica que a descrio dos campos no pode ser lida pelo E3Chart e no possvel continuar a consulta.
<Nome_da_Consulta> (Falha ao baixar os dados do servidor)
Esta mensagem indica que a consulta foi realizada com sucesso, porm houve algum problema ao baixar os dados do servidor. Este problema pode ocorrer por demora excessiva, ou falta de memria no computador. DICA: Trocar a propriedade CursorLocation para clClient faz com que os dados sejam baixados por etapas, evitando o possvel problema de timeout.
334
E3Chart
19
Captulo
19.
E3Playback
19.1. Introduo
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 que, 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.2. 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.
E3Playback 335
19.3. 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. Crie uma nova Tela chamada TelaPlayback e insira o ActiveX E3Playback ocupando toda a rea de fundo da Tela;
Figura 268: Incluso do E3Playback em uma Tela
Configure a propriedade DBServer do E3Playback, fazendo-a apontar para o objeto Banco de Dados que contm os dados histricos do aplicativo;
336
E3Playback
Figura 269: Selecionando um Banco de Dados
Configure a propriedade InitialScreen do E3Playback, fazendo-a apontar para o quadro FrameApp;
Figura 270: Selecionando um Quadro para a propriedade InitialScreen
Abra a Tela UpperMenu e insira a imagem Stopwatch no canto superior direito (abra a Galeria e selecione a categoria Misc Symbols 1);
E3Playback
337
Figura 271: Tela UpperMenu
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;
Figura 272: Pick Abrir Tela
Figura 273: Configuraes do estilo da janela
338
E3Playback
Rode o aplicativo, abra o Viewer, clique em Portugus, depois em Preview de Aplicaes, e finalmente clique sobre o cone Stopwatch. Neste momento deve aparecer a tela de playback:
Figura 274: Tela de playback
Aperte no 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.
E3Playback
339
Figura 275: Tela de playback em modo online
19.4. Interface de Usurio do E3Playback

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

A Barra de Ferramentas rene os principais comandos para operao do E3Playback.
340
E3Playback
Possui os seguintes botes:
CONE
COMANDO Reproduzir (para trs)
Pausa Reproduzir
Parar
Mais Devagar
Velocidade Normal Mais Rpido
Seletor de Velocidade Data/Hora Atual
Mostrar/esconder a Linha de Tempo Mostrar/esconder a Lista de Tags Mostrar/esconder a Lista de Eventos Iniciar/parar gravao de vdeo
Capturar a tela do E3Playback
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). 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. Mostra ou oculta a janela Linha de Tempo do E3Playback. 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.
341
E3Playback
Ao selecionar a ferramenta Gravao de Vdeo configuraes mostrada:
, a seguinte janela de
Figura 276: Janela de opes de Gravao de Vdeo

Opes disponveis na janela Opes de gravao OPO DESCRIO Mostra o local e o nome do arquivo de Salvar vdeo como vdeo que ser salvo. Pode ser utilizado o boto [...] para navegar pelas pastas do computador. Permite definir um tempo total para Tempo mximo de gravao gravao. Se o valor estiver em Indefinido, a gravao apenas pra 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) Quadros por segundo capturados a cada segundo de gravao.
342
E3Playback
OPO Compressor
Qualidade de compresso
Intervalo de quadros a cada quadro-chave Configurar...
Sobre...
Mostrar resumo ao concluir gravao
DESCRIO 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, conseqentemente, 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/desabilita a janela que mostrada no momento em que a gravao finalizada.
19.4.2. Linha de Tempo

A Linha de Tempo permite acompanhar visualmente e controlar o relgio de playback.
Cursor Barra de Dados Barra de Consultas
Rgua Barra de Zoom Geral
Possui os seguintes componentes:
E3Playback
343
COMPONENTE Rgua
Cursor
Barra de Consultas
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. Marca a posio atual do relgio de playback. Quando o playback est no modo Pausa podese arrastar o cursor para os lados, alterando o relgio de playback enquanto arrasta-se o cursor. Est sempre visvel na linha de tempo. 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. 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 Dados Barra de Zoom Geral
19.4.3. 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.
344
E3Playback
Figura 277: 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 ser habilitado ou desabilitado dentro do E3Playback, pode-se testar a propriedade IsPlaybackMode, do objeto Viewer;
E3Playback 345
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;
Figura 278: 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.
346
E3Playback
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.4.4. Lista de Eventos

A Lista de Eventos mostra a seqncia 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.
Figura 279: Lista de Eventos
A lista possui trs colunas:
Data/hora Caminho do Tag
Mostra a data e a hora do evento, conforme est registrado no banco de dados. Mostra o caminho do tag ou da fonte de alarmes que gerou este evento.
E3Playback
347
Evento
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 (ex: "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.
A barra de ferramentas da Lista de Eventos possui as seguintes operaes:
CONE
COMANDO Evento Anterior
Prximo Evento Filtrar Eventos
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.
19.4.5. Lista de Tags

A Lista de Tags mostra os tags que esto sendo utilizados para playback.
Figura 280: Lista de Tags
As colunas so as seguintes:
COLUNA Caminho do Tag Tabela Estado Valor
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.
348
E3Playback
COLUNA Data/hora
Qualidade Evento Anterior
Prximo Evento
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.
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 .
19.5. Banco de Dados de Playback

O E3Playback detecta automaticamente quais so os tags e 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.
19.5.1. Montagem do Banco de Dados

A montagem do banco feita sempre que o E3Playback ativado. As informaes de estrutura do banco coletadas durante a montagem so mantidas enquanto a seo de playback estiver ativa. Os passos da montagem do banco podem ser resumidos da seguinte forma: Enumerar todas as tabelas do banco; 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); 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:
E3Playback
349
o o o
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.
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: o o o Strings: o nome da tabela <Tabela>_String; Bit/Digital: o nome da tabela de dados <Tabela>_Bit; Double/Analgicos: o nome da tabela de dados <Tabela>;
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; 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); 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 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 6 (seis) horas de dados armazenados no banco.
19.5.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.
350 E3Playback
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 o o 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 retornado: o o o 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): o o o 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. 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 sua fatia correspondente e o E3Playback automaticamente dispara
E3Playback 351
consultas para atualizar as fatias vizinhas. Desta forma, medida em 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 de 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.
19.6. 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.6.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.6.2. Alarmes
Para fazer playback de alarmes, siga estes procedimentos: Habilite ou configure o registro de alarmes em disco; Selecione os seguintes campos para registro (obrigatrio): EventTime (mais EventTimeMS) ou EventTimeDbl;
352 E3Playback
FullAlarmSourceName; ConditionActive; Acked; AckRequired. 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; Message; Severity; Source; SubConditionName; CurrentValue.
Figura 281: Seleo dos campos
O E3 j cria automaticamente na tabela de alarmes os ndices necessrios para otimizar as consultas do playback.
E3Playback 353
19.6.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 seqenciais 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); 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:
354
E3Playback
Figura 282: Definio do ndice para o campo E3TimeStamp
19.6.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 hardkey 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 hardkey) o playback tambm funciona no modo Avanado sem limite de pontos, porm limitado a mostrar apenas as ltimas seis horas de dados armazenados no banco.
E3Playback 355
IMPORTANTE: se a hardkey for Master (Studio + Runtime) ou apenas de Runtime, o playback s estar disponvel se tiver licenas programadas na hardkey.
356
E3Playback
20
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 conjunto 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 (ex: 50g de acar, 1000l de gua, polpa de fruta, etc.) so os conjunto de valores. Para utilizar este recurso, siga estes procedimentos: Clique com o boto direito sobre o nome do projeto no Organizer e selecione a opo Inserir - Frmula.
Figura 283: Inserindo um objeto Frmula na aplicao
Frmulas
357
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.
Figura 284: Janela para configurao do Banco de Dados e da tabela

Opes disponveis na janela Configurao do Banco de Dados OPO DESCRIO Determina o servidor de Banco de Dados que gerenciar Banco de Dados 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.
358
Frmulas
Figura 285: Configurando o Banco de Dados
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 e suas restries.
Figura 286: Aba Templates
Frmulas
359

Opes disponveis na aba Templates DESCRIO Define o nome do template. Define o tipo do template. Determina as restries do template.
OPO Nome Tipo Restries
A barra de ferramentas da view Templates tem os seguintes botes: Adicionar para a criao de um novo template; e Remover selecionado. Quando o Boto
, para a excluso do template
Restries acionado, a seguinte janela mostrada:
Figura 287: 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 DESCRIO O usurio pode alterar qualquer valor no template. simbolizado pela letra Limite Irrestrito U na view Templates. O usurio no pode alterar o valor do template. simbolizado pela letra R Limite Restrito na view Templates. So definidos valores fixos como limites, correspondendo ao valor mnimo Limite Absoluto e mximo do template. simbolizado pela letra A na view Templates (e os valores mnimo e mximo configurados no campo).
360 Frmulas
OPO Limite Percentual
Limite por diferena
DESCRIO Valor percentual acima ou abaixo do valor pr-definido. Ex: 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). Valores fixos acima ou abaixo do valor pr-definido. Ex: 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.
Figura 288: Aba Unidades

Opes disponveis na aba Unidades DESCRIO Determina o nome do template. Determina o tag que ser associado unidade.
OPO Nome Unidade
A barra de ferramentas da view Unidades tem os seguintes botes: Adicionar para a criao de uma nova unidade; Remover selecionada; e Renomear , para a troca do nome da unidade selecionada . Para cada nova unidade, solicitado um nome:
Frmulas
, para a excluso da unidade
361
Figura 289: 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.
Figura 290: Aba Valores

Opes disponveis na aba Valores DESCRIO Determina o nome do template. Determina o valor dos campos do conjunto de valores.
OPO Nome Valor
A barra de ferramentas da view Valores tem os seguintes botes: Adicionar para a criao de um novo conjunto de valores; Remover conjunto de valores selecionado; e Renomear conjunto de valores selecionado.
, para a excluso do
, para a troca do nome do
362
Frmulas
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 produzir estas peas. Procedimentos Insira um objeto Frmula na aplicao; Configure o Banco de Dados e a tabela. Use um Banco de Dados existente no projeto, e chame a tabela de Produo.
Figura 291: Configuraes do Banco de Dados e da tabela
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 valor restrito.
Frmulas
363
Figura 292: Templates
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.
Figura 293: Criando tags
Crie na Frmula duas unidades chamadas Maquina1 e Maquina2. Associe cada campo destas unidades aos tags criados anteriormente.
364
Frmulas
Figura 294: Associando os tags s unidades da Frmula
Defina os conjuntos de valores a serem carregados posteriormente nos tags. Crie quatro conjuntos de valores, chamados de Modelo1 at Modelo4, e entre com os seguintes valores:
Figura 295: Configurao do conjunto de valores
Crie agora uma nova Tela chamada Frmulas. 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:
Frmulas
365
Figura 296: 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. Crie um boto na Tela com a mensagem 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:
366
Frmulas
Figura 297: Caixa de dilogo mostrada quando o boto Carregar valores clicado em tempo de execuo
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; 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; Crie agora um objeto SetPoint na Tela e um boto com a mensagem OK. Junto com o SetPoint coloque um texto de identificao com a mensagem 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.
Frmulas
367
Figura 298: 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 a mensagem 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, ser utilizado o mtodo LoadFormulaValuesQuiet(). Caso contrrio, ser utilizado o mtodo LoadFormulaValues().
368 Frmulas
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:
Figura 299: Tela final da Frmula
Rode a aplicao e observe os resultados.
Frmulas
369
21
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 freqentemente utilizados, e subseqentemente 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.
Figura 300: Bibliotecas no Organizer
Bibliotecas
371
21.1. Galeria
A Galeria pode ser acessada atravs do boto Galeria na barra de ferramentas Padro. Neste item esto disponveis 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: Clique no boto Galeria na barra de ferramentas Padro;
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; Para inserir um objeto da biblioteca de smbolos em uma Tela, basta clicar no objeto desejado e arrast-lo para a Tela; 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.
372
Bibliotecas
Figura 301: 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: Acesse o menu, selecione o item Novo Projeto e clique em [Prximo]; Na opo Tipo de Aplicao, selecione a opo Biblioteca de componentes do E3;
Bibliotecas
373
Figura 302: Criao de uma biblioteca do usurio - ElipseX
Determine o nome da sua biblioteca e clique em [Avanar]; Determine as especificaes referentes ao Domnio; 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 as bibliotecas de dados podem conter quaisquer tipos de objetos no-grficos, executados no E3 Server. O seguintes objetos podem ser inseridos em um XObject: Drivers de comunicao; DataServers; DBServers; Formulas; AlarmConfigs; AlarmServers; DBServers; Objetos COM; e outros. Dentro de um mesmo arquivo .LIB podem 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 duas interfaces, uma para declarar as propriedades do objeto, e outra para declarar os eventos do objeto. Estas interfaces tem o seu nome gerado automaticamente. Para um objeto com nome nonono, utiliza-se o nome Dnonono para a interface de propriedades, e DnononoEvents para a interface de eventos (esta nomenclatura padro).
374 Bibliotecas
Portanto, se uma biblioteca j possui um XObject ou XControl chamado nonono, os nomes Dnonono e DnononoEvents no podem ser utilizados como nome de outras classes nesta biblioteca. Se o usurio tentar nomear um ElipseX Dnonono, j tendo outro chamado nonono na biblioteca, aparecer o cdigo de erro 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, que ter o propsito de ser multiplicada facilmente por seu projeto.Voc poder criar um XControl clicando com o boto direito do mouse sobre o arquivo LIB criado em seu Domnio, escolhendo a opo Inserir - XControl.
Figura 303: XControls
Ao inserir um XControl, aberta a view deste objeto, composta por duas abas. A primeira a aba Design, que equivale a uma Tela, onde podem ser inseridos os objetos grficos descritos anteriormente. A segunda chamada de 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, que so os XProperties, podem ser inseridas pressionando-se a tecla [Insert] do teclado ou atravs do Boto atravs do Boto . As opes disponveis deste item so as seguintes:
Opes disponveis na aba Propriedades DESCRIO Determina o nome da varivel do XControl. Determina o tipo de dado suportado pela varivel. Determina o valor inicial da varivel. Habilita ou desabilita a visibilidade da varivel fora da biblioteca, isto, determina se a varivel ser ou no pblica.
375
e excludos
OPO Nome Tipo Valor Public
Bibliotecas
OPO Texto de ajuda
DESCRIO 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 quando voc est editando uma Tela, possuindo os mesmos recursos grficos e opes. Voc poder 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:
Figura 304: XControls
A partir deste momento, o seu XControl ter um nome dentro da Tela, e ser entendido como uma cpia da definio original. Assim, voc deve 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. Exemplo: Suponha voc criou um objeto Bomba, que possui um XProperty com o nome de Estado, que receber uma informao externa revelando se a bomba est ligada ou desligada, o que far com que ela mude sua cor. Ao inserir este objeto na Tela, o E3 automaticamente renomeia o objeto para Bomba1. Voc poder manter este nome ou renome-lo para outro que desejar. Depois, dever informar qual varivel ser associada ao XPropery 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. XObject
Alm dos Objetos grficos XControls, voc pode criar uma biblioteca de dados, denominada XObject. Com ela, voc pode definir uma estrutura de dados, que ser
376 Bibliotecas
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 sobre o arquivo LIB no Organizer e escolha a opo Inserir - XObject.
Figura 305: 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, chamadas XProperties, que podero ser associadas a um tag ou outra propriedade qualquer de uma aplicao quando o objeto estiver sendo usado numa aplicao. As variveis podem ser inseridas pressionando-se a tecla [Insert] do teclado, e devem ser definidas as seguintes propriedades para cada uma delas: Boolean, Byte, Integer, Date, String, Variant, Color,etc. Note que outros objetos de Dados (XObjects) podem ser declarados como Tipos. Desta forma, voc poder 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++. As variveis a serem exportadas podem ser inseridas pressionando-se a tecla [Insert] do teclado ou atravs do Boto e excludos atravs do Boto As opes disponveis deste item so as seguintes: .
Nome Tipo Valor Public
Opes disponveis na view dos XObjects OPO DESCRIO Determina o nome da varivel do XObject. Este campo equivale a propriedade Name do XObject. Determina o tipo de dado suportado pela varivel. Este campo equivale a propriedade Type do XObject. Determina o valor inicial da varivel. Este campo equivale a propriedade Value do XObject. Habilita ou desabilita a visibilidade da varivel fora da biblioteca, isto, determina se a varivel ser ou no pblica. Este campo equivale propriedade Public do XObject.
Alm dos XProperties, podem ser inseridos num XObject qualquer em um mdulo do E3 que seja executado no servidor, a saber:
Bibliotecas 377
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 o XControl quanto o XObject s podero se relacionar com o mundo externo atravs dos XProperties (ou ainda atravs do Mouse e teclado, no caso dos XControls), ou ainda atravs do compartilhamento de algum outro recurso ou propriedade externa. Isso significa que voc no poder acessar dados internos de um XObject ou XControl seno de dentro do prprio objeto. Voc poder inserir os XObjects em qualquer Servidor de Dados, clicando com o boto direito do mouse sobre o Servidor de Dados, escolhendo a opo Inserir, como mostrado a seguir:
378
Bibliotecas
Figura 306: Inserindo um XObject
Note que mesmo que seu arquivo ou arquivos de biblioteca possuam vrios XControls e XObjects, ao tentar inserir uma biblioteca o E3 Studio exibir para as Telas somente os XControls, e para os Servidores de Dados somente os XObjects. NOTA: Voc deve 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.
Bibliotecas
379
Voc pode optar por no remover e ento criar novamente o objeto que foi deletado com a propriedade que deseja editar, remover apenas a que est sendo mostrada, remover todas ou no remover nenhuma.
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 por mais de uma vez no mesmo projeto; Procedimentos do conhecimento do usurio: freqentemente, 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.
380
Bibliotecas
22
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: Clique com o boto direito no Organizer e selecione a opo Inserir - Relatrio;
Figura 308: Inserindo um Relatrio
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. Se a propriedade SourceQuery for especificada, o relatrio ir buscar os dados do Banco de Dados indicado.
Relatrios
381
Caso contrrio, o relatrio buscar os dados da consulta padro do sistema. Aps ter criado o relatrio no projeto, este cria o objeto consulta. Para maiores informaes a respeito deste objeto, veja o captulo Consultas.
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.
Figura 309: Sees do relatrio
O relatrio define tipos de seo, que sero explicadas a seguir.
22.2.1. Report Header

Um relatrio pode ter uma seo Report Header que imprime no incio do relatrio. geralmente utilizado 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. usado para imprimir uma soma de um relatrio, totais gerais ou qualquer outra informao que necessite ser impressa somente uma vez no final do relatrio.
382
Relatrios
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.
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, 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.
Figura 310: Barra de Ferramentas Relatrio
Clicando com o boto direito do mouse sobre o relatrio, mostrado um menu.
Relatrios
383
Figura 311: Menu do relatrio
Figura 312: Menu do objeto no relatrio
As opes do menu variam de acordo com o local onde o mouse clicado. Na rea do relatrio: Somente as opes Insert e Delete Section esto habilitadas; Em um objeto no relatrio: Somente as opes Insert, Delete, Cut, Copy, Paste, Bring to Front, Send to Back, Alignment e Format Border esto habilitadas; Em mais de um objeto selecionado no relatrio: Todas as opes do menu esto habilitadas.
384
Relatrios
OPO Insert
Delete / Delete Section Reorder Groups
Cut Copy Paste Bring to Front Send to Back Align
Opes disponveis no Menu 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. Deleta 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. 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; Bottons: Alinhamento mesma altura; To grid: Alinhamento conforme a grade; Center in section: Alinhamento centralizado na sesso. 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.
Size
Relatrios
385
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. 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. Determina o formato da borda do objeto do relatrio.
Vertical Spacing
Format Border
Quando a opo Format Border selecionada, uma caixa de dilogo mostrada.
Figura 313: Opes de borda do objeto

Opes disponveis para Borda DESCRIO Determina o estilo da borda externa do objeto.
Relatrios
OPO Presets
386
OPO Line Styles Preview Color Shadow
DESCRIO 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.
Atravs da Barra de Ferramentas Relatrio, possvel acessar os recursos disponveis no relatrio:
22.3.1.
Preview
Atravs desta opo, possvel visualizar uma prvia da impresso do relatrio. Assim possvel verificar configuraes de margem, figuras, etc.
Figura 314: Prvia de impresso do relatrio

Configuraes da Prvia de Impresso 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.
Relatrios 387
CONE
CONE Menos zoom na pgina. Mais zoom na pgina.
DESCRIO
Porcentagem de zoom na pgina. Pgina anterior / 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.
Figura 315: Configuraes do relatrio

Opes de configurao do PageSetup DESCRIO Determina a margem do topo da pgina. Determina a margem do contedo da pgina. Determina a margem esquerda da pgina. Determina a margem direita da pgina. Determina a margem da pgina. Habilita ou desabilita a margem espelhada da pgina.
ITEM Top Margim Bottom Margin Left Margin Right Margin Gutter Mirror Margins
A opo Printer Setting configura as especificaes referentes impresso do relatrio.

388 Relatrios
Figura 316: Configuraes de impresso do relatrio

Opes de configurao do Printer Setting (Impressora) ITEM DESCRIO Determina o tamanho do papel. Paper Size Determina a largura do papel. Width Determina a altura do papel. Height Determina a orientao do papel na impressora Orientation (Printer Default - Configuraes de acordo com a impressora padro; Portait - Layout da pgina na vertical; Landscape - Layout da pgina na horizontal). Ordena a impresso. Collate Duplica a impresso. Duplex Determina as configuraes e o tipo de papel para a PaperBin impresso.
A opo Grid Setting determina as configuraes referentes as grades do relatrio.
Relatrios
389
Figura 317: Configuraes da grade

Opes de configurao do Grid Setting (grade) ITEM DESCRIO Habilita ou desabilita a grade. Show Grid Habilita ou desabilita o alinhamento dos controles na Align Controls to Grid grade. Determina o nmero de colunas na grade. Grid Columns Determina o nmero de linhas na grade. Grid Rows Determina o tipo de unidade da rgua (pixels ou Ruler Units centmetros).
A opo Style determina as configuraes referentes ao estilo do relatrio.
390
Relatrios
Figura 318: Configuraes de impresso do relatrio

Opes disponveis para configurao do Style (estilo) OPO DESCRIO Determina o estilo do relatrio. Pode-se inserir um novo New/Delete/Lista 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 Font/ Colors / Misc (fontes, cores de fundo e frente, orientao, etc.).
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 Barra de Ferramentas Relatrio. que est disponvel na
Relatrios
391
Figura 319: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.4. Objetos do Relatrio

22.4.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.
Figura 320: Linha
Aps ser inserido na Tela, o objeto ser chamado Line.
392
Relatrios
22.4.2.
Retngulo
O objeto Retngulo permite o desenho de retngulos, utilizando toda a largura ou altura do objeto. Criado a partir de dois vrtices.
Figura 321: Retngulo
Aps ser inserido na Tela, o objeto ser chamado Shape.
22.4.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.
Figura 322: Retngulo arredondado
22.4.4.
Elipse
O objeto Elipse permite o desenho de crculos e elipses, utilizando toda a largura ou altura e definindo o centro do crculo no centro do retngulo.
Figura 323: Elipse
Relatrios
393
22.4.5.
Texto
O objeto Texto possibilita de criao de um texto. Ao definir a rea na Tela, podemos digitar diretamente o texto desejado, que aceita tambm mltiplas linhas.
Figura 324: Texto
Aps ser inserido na Tela, o objeto ser chamado Label.
22.4.6.
Figura
O objeto Figura permite mostrar imagens que estejam armazenadas em arquivos, estejam eles dentro ou fora do arquivo do aplicativo.
Figura 325: Figura
Aps ser inserido na Tela, o objeto ser chamado Picture.
22.4.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.
Figura 326: Campo de Dados
Aps ser inserido na Tela, o objeto ser chamado Field. 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:
394
Insira um novo GroupHeader/Footer no relatrio;

Relatrios
Configure a propriedade DataField do GroupHeader para =Day(E3TimeStamp). Isto determina que o clculo da mdia ser feito por dia; Insira um Campo de Dados no GroupHeader com a propriedade DataField igual a =Day(E3TimeStamp); Insira um Campo de Dados no GroupFooter com a propriedade DataField igual ao nome do campo que ser calculada a mdia; Configure as seguintes propriedades do Campo de Dados do GroupHeader: SummaryFunc = 1 - ddSFAvg SummaryGroup = GroupHeader1 SummaryRunning = 1 - ddSRGroup SummaryType = 3 - ddSMSubTotal
22.4.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 booleano.
Figura 327: Caixa de seleo
Aps ser inserido na Tela, o objeto ser chamado CheckBox.
22.4.9. Cdigo de barras

O objeto Cdigo de Barras permite gerar uma figura que converte uma seqncia 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.
Figura 328: Cdigo de barras
Relatrios
395
Aps ser inserido na Tela, o objeto ser chamado BarCode.
22.4.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.
Figura 329: 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 em seus 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.4.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. Se voc trabalhar com documentos que contenham diversas pginas e inserir quebras de pgina manuais, talvez seja necessrio reinser-las com freqncia medida que voc editar o documento. Voc tambm poder 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.
396
Relatrios
Figura 330: Quebra de pgina
22.4.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.
Figura 331: Quadro
Aps ser inserido na Tela, o objeto ser chamado Frame.
22.5. Criando um Relatrio no E3

Esse exemplo contempla a criao de um relatrio no E3 para extrao de dados de um histrico. Definio de reas do Relatrio O relatrio-padro, criado quando inserido um novo relatrio ao projeto, tem as seguintes reas: PageHeader - 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:
Relatrios
397
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 e acessando a opo Insert. 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: Configure a propriedade DataSource (nome do Banco de Dados onde ser feita a consulta. Nesse caso, ServidorDB); Determine a propriedade Table (tabela de consulta, aqui ser Dados); Configure a propriedade Name (ficar com o nome original, Consulta1).
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 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. Visualizao do relatrio possvel fazer a visualizao do relatrio criado atravs do Boto de Preview , disponvel na rea de edio do mesmo. Para tanto, necessrio direcionar o servidor de Banco de Dados do projeto para o arquivo MDB da pasta onde foi salvo o exemplo.
398 Relatrios
22.6. Exemplos de utilizao nos Relatrios

A seguir so mostrados alguns exemplos de utilizao dos recursos dos Relatrios: 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
Configurando o valor de um objeto Cdigo de Barras (BarCode) dentro da seo Detail Para utilizar este recurso, escreva o script no evento OnFormat da seo Detail:
Sub OnFormat Report.Sections("Detail").Controls("BarCode1"). Caption = Right (Report.Field ("E3TimeStamp"), 8) End Sub
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
Gerando um Menu que permite exportar um relatrio Para utilizar este recurso, escreva o seguinte script:
Sub [Retngulo3_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
Relatrios 399
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 XLS! " 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
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;
400 Relatrios
SummaryType: 4 - ddSMPageCount. 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: = "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 numero de dias e a parte fracionria as horas e 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 =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 5 minutos.
Relatrios
401
23
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 grupo 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: Acesse o menu Arquivo - Usurio... O sistema mostrar uma caixa de dilogo para configurao das permisses, dos usurios e dos grupos no sistema.
Figura 332: Configuraes de segurana
Segurana
403
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 Arquivos - Usurios, e selecione a aba Usurios.
Figura 333: Aba Usurios

Opes disponveis na aba Usurios DESCRIO Indica o usurio corrente. Cria um novo usurio. Edita as propriedades do usurio selecionado. Remove o usurio selecionado. Mostra os grupos de usurios disponveis no sistema. Mostra os grupos aos quais o usurio pertence. Adiciona grupos do campo Grupos disponveis ao campo Pertence a. Remove grupos do campo Pertence a.
OPO Nome Boto [Novo...] Boto [Editar...] Boto [Remover] Grupos disponveis Pertence a Boto [Adicionar >] Boto [<Remover]
404
Segurana
Quando os botes [Novo...] ou [Editar...] so acionados, a seguinte caixa de mensagem mostrada:
Figura 334: Adicionando usurios na aplicao

Opes disponveis na janela Adicionar usurios OPO DESCRIO Determina o nome do usurio. Nome Determina a senha do usurio. Senha Reconfirmao da senha anteriormente informada. Confirme a senha Determina o nome completo do usurio. Nome completo Habilita o usurio como administrador. Este usurio um administrador O usurio no pode alterar a sua senha, sendo que O usurio no pode alterar sua somente o administrador pode executar esta tarefa. senha
Segurana
405
OPO 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
DESCRIO Determina o prazo de validade da senha do usurio. Quando a senha se aproximar da data de validade, ser mostrado um lembrete para renov-la. 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, o mesmo no poder mais 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. Indica que o usurio dever trocar sua senha quando for executar seu prximo login. Permite a validao de senhas independentemente de suas letras serem digitadas como maisculas ou minsculas. Esta opo no recomendada.
O usurio deve trocar a senha no prximo login Validar senhas sem diferenciar maisculas e minsculas
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, exceto remover-se ou marcar-se como noadministrador. Estes privilgios so acessados via script atravs do mtodo UserAdministration(), que habilita a caixa de dilogo dos usurios em tempo de execuo. NOTA: Apenas o administrador tem acesso ao mtodo UserAdministration(). Quando o boto [Remover] acionado, o sistema mostra uma caixa de mensagem questionando se realmente deseja remover o usurio. possvel que um usurio pertena a um grupo, podendo assim compartilhar as configuraes. Para tanto, na lista Grupos disponveis so mostrados os grupos disponveis no sistema que podero conter o usurio selecionado, e no item
406 Segurana
Pertence a, a lista dos grupos aos quais o usurio selecionado pertence. Para adicionar um usurio a um grupo, siga estes procedimentos: Selecione o usurio que deseja inserir no grupo especfico; Na lista Grupos disponveis, selecione o grupo ao qual o usurio ir pertencer; Clique no boto [Adicionar>], para adicionar o grupo, que aparecer no campo Pertence a; Para remover o grupo, basta selecion-lo no campo Pertence a e clicar no boto [<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 Arquivos - Usurios e selecione a aba Grupos.
Figura 335:Grupos

Opes disponveis na aba Grupos
Segurana 407
OPO Nome Boto [Novo...] Boto [Editar...] Boto [Remover] Grupos disponveis Pertence a Boto [Adicionar >] Boto [< Remover]
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 do campo Grupos disponveis ao campo Pertence a. Remove grupos do campo Pertence a.
Quando os botes [Novo...] ou [Editar...] so acionados, a seguinte caixa de mensagem mostrada:
Figura 336: Criando um novo grupo

Opes disponveis na janela Adicionar Grupos OPO DESCRIO Determina o nome do grupo. Nome do grupo O usurio no pode alterar a sua senha, sendo que O usurio no pode alterar sua somente o administrador pode executar esta tarefa. senha Determina o prazo de validade da senha do usurio. A senha expira aps ... dias A senha deve conter no mnimo ... Determina um nmero mnimo de caracteres para a senha do usurio. caracteres
408 Segurana
OPO 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
DESCRIO 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 independentemente de suas letras serem digitadas como maisculas ou minsculas.
Quando o boto [Remover] pressionado, o sistema mostra uma caixa de mensagem perguntando se deseja realmente 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: Selecione o grupo que deseja inserir num grupo especfico; Na lista Grupos disponveis, selecione o grupo ao qual o grupo ir pertencer; Clique no boto [Adicionar >], para adicionar o grupo, que aparecer no campo Pertence a; Para remover o grupo, basta selecion-lo no campo Pertence a e clicar no boto [<Remover].
NOTA: importante verificar a hierarquia entre usurios e grupos: Se o usurio tiver uma opo desabilitada, mas esta mesma opo estiver habilitada no grupo, fica sendo vlida a opo do usurio, que possui este item desabilitado. A opo do grupo s ser respeitada se a mesma opo no usurio for 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.
Segurana
409
Figura 337: Permisses de usurios/grupos

Opes disponveis na aba Permisses DESCRIO Esta opo lista os usurios ou grupos de usurios configurados no sistema. Os itens para segurana disponveis so: Itens para segurana - Telas: Permitem ao usurio habilitar ou desabilitar o acesso s Telas. Numa aplicao, todos os usurios ou grupos tem acesso a Tela de abertura. - Alarmes: Habilita ou desabilita o reconhecimento dos alarmes para o usurio ou grupo. Num 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. - Viewer: Permite ao usurio utilizar o Viewer do modo Viewer Full ou Viewer Only, de acordo com suas configuraes. um filtro das opes de configurao. Habilitando esta Usurios opo, possvel visualizar somente os usurios cadastrados no sistema. um filtro das opes de configurao. Habilitando esta Grupos opo, possvel visualizar somente os grupos cadastrados no sistema. OPO Usurios/Grupo
410 Segurana
OPO Permisses
DESCRIO Mostram as permisses dos usurios ou grupos quanto aos itens de segurana (Telas, Alarmes, Domnios e Viewer). Desabilita a verificao de 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 DESCRIO Habilita a abertura de Telas. Opes disponveis para Alarmes DESCRIO Habilita o reconhecimento de alarmes.
OPO Abrir Tela
OPO Reconhecer alarme
Opes disponveis para Domnios OPO DESCRIO Habilita a execuo do Domnio. Executar Domnio Pra o Domnio. Parar Domnio Habilita a edio do Domnio. Editar Domnio Habilita a execuo do Domnio como servio. Executar como servio Permite configurar usurios e grupos de usurios. Configurar usurios/grupos Habilita o acesso remoto ao Domnio. Acesso remoto ao Domnio Acesso remoto de escrita ao Habilita o acesso remoto de escrita ao Domnio. Domnio Opes disponveis para Viewer OPO DESCRIO Habilita o acesso de escrita ao servidor. Acesso de escrita ao servidor
Cada item da lista de permisses pode estar configurado como 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.
Segurana
411
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 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 o 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 do mesmo. 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). OBS.: A nomenclatura e descrio das opes de restrio podem ser acessadas atravs da opo Legenda.
412
Segurana
Figura 338:Legenda das permisses dos usurios/grupos
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/Logout, disponveis no menu Arquivo.
Figura 339: Login/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.
Segurana 413
Para utilizar este recurso, siga estes procedimentos: Clique com o boto direito do mouse sobre o nome do projeto no Organizer e selecione a opo Proteger; O sistema abrir uma caixa de dilogo com as opes abaixo.
Figura 340: 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.
414
Segurana
Figura 341: Adicionar proteo
O boto [Alterar] senha altera a senha de proteo do E3 Studio para o arquivo.
Figura 342: 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 pressionar [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 seu arquivo contra execuo no autorizada. Para tanto, necessrio solicitar a gravao de uma senha de proteo na hardkey, 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.
Segurana
415
Figura 343: Adicionar proteo
O boto [Alterar senha] altera a senha de proteo de execuo para o arquivo.
Figura 344: 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 pressionar [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 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 acessibilidade dos arquivos. , indicando a
O contedo de arquivos .PRJ e .LIB protegidos so criptografados. 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 determinado arquivo, mantenha as senhas armazenadas de modo seguro. Isso garante que voc conseguir usar o arquivo sempre que necessrio.
416 Segurana
24
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.
Figura 345: E3 WebViewer em execuo (visualizao de uma aplicao)
417
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 Segurana), e de acordo com o tipo de licena de Viewer em uso (captulo Domnio), 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 / Inverter Valor); Chamadas de mtodos de objetos do servidor atravs de scripts do Viewer (excees a seguir); Administrao de usurios atravs UserAdministration() do Viewer); Reconhecimento de alarmes pelo E3Alarm; Uso dos mtodos LoadFormulaDlg(), 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 script 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() (ServerApplication); Mudanas do estado de Advise de tags do servidor; Mudana da prpria senha (mtodo ChangePassword() do Viewer). LoadFormulaValues() e do Viewer (uso do mtodo
418
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 conseqentemente a propriedade IsViewerReadOnly), 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 vice-versa) 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:
Figura 346: 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 pra a execuo do Domnio. Executar/Parar E3 Viewer: Executa o E3 Viewer ou pra a sua execuo caso ele j esteja aberto.
E3 Viewer e E3 WebViewer 419
Quando o E3 Viewer executado, o sistema mostra a janela a seguir, indicando o estado de conexo:
Figura 347: 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.
Sintaxe: Viewer [nome_do_servidor] screen <nome_da_tela>
-noping ou /noping: Descarta a necessidade de se fazer ping para o servidor antes da tentativa de conexo (Tentativa de conexo direta).
Sintaxe: 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.
Sintaxe: Viewer [nome_do_servidor] readonly
420
-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).
Sintaxe: 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.
Sintaxe: 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.
Sintaxe: 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 seguinte figura:
Figura 348: Caixa de dilogo de ajuda do Viewer
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:
Figura 349: 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 da 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 Elipse Event Log Viewer: Manual do Usurio. NOTA: Para sistemas operacionais anteriores ao Windows XP, os logs genricos so atualizados sempre, mesmo que o E3 seja fechado incorretamente (como no caso de uma falha). Os demais logs so atualizados periodicamente, sendo que se o E3 no for fechado corretamente, o contedo pode ficar incompleto ou at vazio.
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
422 E3 Viewer e E3 WebViewer
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 abaixo 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 fazer o 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 ping ser feito. 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="diretrio_para_cache">
Caso se deseje que o WebViewer procure por outros servidores na rede se no conseguir conectar-se ao servidor especificado na varivel Domain, deve-se alterar a linha a seguir. Se o parmetro no for informado, o WebViewer tentar se conectar apenas ao servidor especificado na varivel 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-45BB9536-C14B9DCE3CA7'"; conteudo += " width='100%' height='100%'>"; var domain = "192.0.0.21"; conteudo += '<PARAM NAME="Domain" VALUE=" ' + domain + '">'; 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 em internet como para visualizao em intranet ou mquina local, a partir da verso 3.0 necessrio a instalao e configurao do IIS, ou outro servidor de internet. O IIS fornecido juntamente com o Windows. Para instal-lo e configur-lo, siga estes procedimentos: Abra o Painel de Controle (ou Control Panel); Acesse a opo Adicionar programas (ou Add/Remove Programs); Clique em Adicionar um componente do Windows (ou Add/Remove Windows Component);
424
Figura 350: Internet Information Service (IIS)
Selecione na lista o item Internet Information Services (IIS) e clique em Prximo (ou Next); O sistema inicia a instalao do software (para instalar o IIS preciso ter o CD de instalao do Windows); 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, 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 (Ex.: http://nomedoservidor/diretorio_virtual, http://192.0.0.21/diretorio_virtual), onde diretorio_virtual o diretrio criado na configurao do IIS (conforme o Guia de Instalao).
No primeiro acesso ao servidor, o navegador vai iniciar a instalao dos componentes, caso 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 a mesma inicie as configuraes necessrias.
Figura 351: 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 que a do servidor. Para isto, o instalador (e3-w2kwebviewer.exe) que fica no servidor deve ser sempre o mais atual.
426
25
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. Esse servidor em espera, dizemos 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 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, 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 Servidor de 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 ( .PRJ e .LIB), que devem ter obrigatoriamente o mesmo caminho. O arquivo .DOM sincronizado automaticamente pelo E3 Server, isto , mudanas feitas no .DOM em um servidor so automaticamente copiadas para o arquivo .DOM dos outros servidores do Domnio.
Hot-Standby 427
O Hot-Standby usa a conexo REC; por isso, ele s funciona se o E3 Server estiver iniciado nas 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 com o uso do 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: Localize o caminho do Domnio no computador principal e copie esta pasta para o computador de standby, na mesma localizao. (Ex: Se no computador principal, o Domnio e os demais arquivos (LIBs, PRJs, etc.) estiverem no caminho C:\Projeto1, no computador de standby dever ser copiado o projeto para este mesmo caminho, isto , C:\Projeto1); Os arquivos de Banco de Dados devem ser tratados de maneira diferenciada. Para maiores informaes, veja o tpico Utilizando Banco de Dados com Hot-Standby; Acesse o cone do E3 Admin as opes Domnio - Opes; na rea de Notificao do Windows e selecione
Figura 352: E3 Admin
Na aba Servidores, adicione os servidores principal e backup. Configure as opes Nome do servidor e Identificao do servidor na rede. Ex: Nome do servidor: Servidor1 Identificao do servidor em rede: \\Computer1
428
Hot-Standby
Figura 353: Configurao do Servidor
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. Defina a opo Endereo 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 termina imediatamente a execuo do Domnio. 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 da funo Application.ReportFailure(). A troca de servidores s feita se o servidor backup estiver sem falhas. Para maiores informaes sobre a funo Application.ReportFailure() veja o Manual de Referncia de Scripts.
Hot-Standby
429
Figura 354: Configurao da distribuio em rede
Para confirmar as configuraes, clique no boto [OK]; Ao iniciar a execuo do E3, ser mostrado na rea de Notificao do Windows dos computadores 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 na rea de Notificao do Windows 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 , indicando que ele est em standby (modo de espera).
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 Domnio pode ser iniciado tambm atravs do E3 Studio. Para tanto, basta abrir o Domnio e clicar no boto .
430
Hot-Standby
25.3. Parando um Domnio Redundante

Um Domnio pode ser parado por qualquer um dos seus servidores, atravs do cone do E3 Admin na rea de Notificao 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 de rede apenas). O tempo configurado afeta diretamente o timeout do ping entre os servidores. Se ficar muito baixo (troca em 1 segundo, timeout de ping = 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
431
25.7. Utilizando Banco de Dados com Hot-Standby

Pode-se ter dois servidores rodando separadamente numa mesma aplicao. Um deles fica ativo, enquanto que o outro fica em estado de espera (standby), aguardando uma possvel falha. O Hot-Standby garante a continuidade da aplicao, mas quando se utiliza Banco 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 BD na aplicao, configurando o objeto DBServer em ambos servidores (Principal e Standby) com os mesmos parmetros de localizao do BD 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 de dados feita em bases diferentes. Neste caso, o ideal se ter os dois bancos de dados rodando localmente, em ambos servidores. Assim, garante-se que o acesso ao BD estar sempre disponvel, pois a mquina que est rodando a aplicao tambm roda o Banco de Dados. Uma opo interessante nesse caso o sincronismo entre as diferentes bases da aplicao principal e a secundria. A propriedade EnableSynchronization do objeto DBServer habilita essa caracterstica na aplicao. Quando ela est ativa, todos os dados gravados na base principal so atualizados na base em Standby quase que instantaneamente. NOTA: Se a aplicao principal no conseguir enviar os dados para o servidor em Standby, esses dados ficaro armazenados em disco localmente, para posterior envio (quando a comunicao entre os dois computadores for restabelecida), assegurando assim a igualdade entre as tabelas geradas pela aplicao.
432
Hot-Standby
26
26.
Captulo
Configuraes Avanadas
Existem configuraes do E3 que podem ser realizadas diretamente no registro do Windows. 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.
26.1. Configuraes do E3 Server

26.1.1. Leitura do HASP
O E3 Server realiza um certo nmero de tentativas de leitura da chave que contm a configurao; se esta leitura no for bem-sucedida, o E3 ser iniciado em modo Demo. possvel configurar o nmero de tentativas de leitura do HASP, feitas quando o E3 Server iniciado, atravs da seguinte chave de registro do Windows:
HKEY_LOCAL_MACHINE\Software\Elipse Software\E3\E3Server
A varivel a ser configurada nesta chave a HaspReadRetries, que deve ser do tipo DWORD. Se esta varivel no for criada, o sistema assume automaticamente o valor 5, isto , sero feitas cinco tentativas de encontrar a hardkey, com intervalos mnimos de 1 segundo. Se esta varivel for criada, o valor configurado indica o nmero de tentativas de leitura do HASP pelo E3 Server. Se configurado o valor 0, o modo Demo ser habilitado automaticamente, estejam o driver HASP ou a hardkey instalados ou no. Durante o tempo de procura da hardkey, o E3 Server ficar indisponvel.
26.1.2. Desabilitar mltiplas CPUs

No caso de computadores biprocessados, possvel configurar o E3 Server para utilizar apenas a primeira ou todas as CPUs disponveis no sistema atravs da seguinte chave de registro do Windows:
HKEY_LOCAL_MACHINE\SOFTWARE\Elipse Software\E3\E3Server
A varivel a ser configurada nesta chave a AllowMultiCPU, que deve ser do tipo DWORD.
Configuraes Avanadas 433
Se esta varivel no for criada, o sistema assume automaticamente que o E3 Server rodar em todas as CPUs. Se esta varivel for criada, qualquer valor diferente de 0 habilita o E3 Server a rodar em todas as CPUs disponveis no sistema. O valor 0 habilita o E3 Server a rodar em apenas uma CPU.
26.1.3. Definir um timeout para o ping do E3 Server

possvel fazer com que o E3 Server detecte rapidamente a desconexo de Viewers remotos, interrompendo o acmulo de dados a serem enviados para o Viewer, atravs da seguinte chave de registro do Windows:
A varivel a ser configurada nesta chave a PingTimeout, que deve ser do tipo DWORD. O valor da varivel indica o timeout do ping em milissegundos. Se o valor da varivel no for especificado, ser usado o valor padro de 2000 ms. Se o valor da varivel for configurado como 0, este mecanismo de ping ser desligado. O ideal que seja sempre usado o menor valor possvel permitido pela rede. Isto faz com que o E3 Server detecte a queda dos Viewers no mnimo tempo possvel, evitando o empilhamento excessivo de mensagens.
26.1.4. Configurar heartbeat de licena

Na conexo de licena do servidor com o Viewer aplicado por padro um keepalive (ou heartbeat). Se o Viewer passar algum tempo sem responder, sua conexo desfeita automaticamente. O tempo do heartbeat pode ser configurado no servidor pela chave de registro do Windows:
A varivel a ser configurada nesta chave a LicenseHeartBeat, que deve ser do tipo DWORD. O valor da varivel indica o perodo do heartbeat em milissegundos. Se o valor for 0, o heartbeat desligado. Se o valor no for especificado, considerado um tempo padro de 5 segundos (5000 ms). O tempo mximo que o Viewer pode ficar sem enviar o heartbeat (ou seja, o timeout no servidor) ser sempre o dobro do tempo de hearbeat configurado.
26.1.5. Definir porta TCP/IP usada pelo protocolo REC

possvel configurar o nmero da porta utilizada pelo REC atravs da seguinte chave de registro do Windows:
HKEY_LOCAL_MACHINE\SOFTWARE\Elipse Software\E3\E3Server\REC
434
A varivel a ser configurada nesta chave a IPPort, que deve ser do tipo DWORD. Se esta varivel no for criada, o sistema assume automaticamente a porta padro 6515. Se esta varivel for criada, o valor configurado indica o nmero da porta utilizada pelo REC. Podem ser usados valores maiores que 1024 e at 65535. Valores iguais ou abaixo de 1024 so reservados. Valores nulos ou invlidos habilitam a utilizao da porta 6515.
26.1.6. Definir timeout para o encerramento do E3Run

possvel especificar o tempo mximo, em milissegundos, para o encerramento do E3Run, atravs da seguinte chave de registro do Windows:
A varivel a ser configurada nesta chave DomainStopTimeout, que deve ser do tipo DWORD. Se a varivel no for criada, o sistema assume automaticamente o valor de 60000 ms (1 minuto).
26.2. Configuraes do E3Run

26.2.1. Ocultar ou exibir a janela de progresso do E3Run
possvel optar entre exibir ou ocultar a janela de progresso do E3Run atravs da seguinte chave de registro do Windows:
HKEY_LOCAL_MACHINE\Software\Elipse Software\E3\E3Run
A varivel a ser configurada nesta chave a HideProgressIndicator, que deve ser do tipo DWORD. Se esta varivel no for criada, o sistema assume automaticamente que a janela deve ser exibida. Se esta varivel for criada, o valor 0 habilita a exibio da janela de progresso. Qualquer valor diferente de 0 oculta a visualizao da janela de progresso.
26.2.2. Filtrar chamadas COM/DCOM

O E3Run implementa um filtro de chamadas COM/DCOM visando evitar chamadas reentrantes. Esse filtro por padro est desabilitado e para habilit-lo (recomendvel apenas nos sistemas que apresentarem erros ou travamentos aparentemente sem causa), pode-se criar a seguinte chave no registro do Windows:
HKEY_LOCAL_MACHINE\Software\Elipse Software\COMFilter
Configuraes Avanadas 435
A varivel a ser configurada EnableFilter, que deve ser do tipo DWORD. Se esta varivel for criada com valor 0, o filtro COM/DCOM desabilitado. Se a varivel no for criada, ou possuir valor diferente de 0, o filtro fica habilitado. Esta configurao lida do registro apenas quando o E3Run iniciado. Portanto, ao alterar o registro o E3 tem que ser reiniciado. No log Full do E3 possvel verificar as chamadas COM/DCOM reentrantes, para permitir a depurao de problemas.
26.2.3. Especificar o tamanho da pilha da thread de runtime

possvel ajustar o tamanho, em MB, da pilha da thread de runtime atravs da seguinte chave de registro do Windows:
HKEY_LOCAL_MACHINE\SOFTWARE\Elipse Software\E3\E3Run
A varivel a ser configurada nesta chave a StackSizeMB, que deve ser do tipo DWORD. O valor 0 indica que deve ser usado o tamanho padro do Windows (1 MB). Valores entre 1 e 3 permitem reduzir o tamanho da pilha, o que no recomendado. O valor mximo dessa varivel 256. Valores maiores sero automaticamente armazenados com o valor mximo da varivel.
26.3. Configuraes do REC

26.3.1. Compactar pacotes do REC
possvel habilitar a compactao de pacotes de comunicao atravs do REC entre o E3 Server, o E3 Viewer e o E3 Studio atravs da seguinte chave de registro do Windows:
HKEY_LOCAL_MACHINE\SOFTWARE\Elipse Software\E3\REC
A varivel a ser configurada nesta chave a CompressionLevel, que deve ser do tipo DWORD. Se esta varivel no for criada, o sistema assume automaticamente que a compresso est desabilitada. Se esta varivel for criada, qualquer valor entre 1 e 9 ativa a compactao. O valor recomendado 6. Quaisquer valores fora desta faixa desabilitam a compactao de pacotes do REC. Esta configurao ser aplicada somente para a compresso do E3 Server ou E3 Viewer rodando localmente na mquina. Tanto o E3 Server quanto o E3 Viewer suportam descompactao de pacotes, independente de suas configuraes.
436
26.3.2. Definir timeout da conexo REC

Para casos em que o E3 Server est iniciando e a deteco da hardkey demorada, possvel controlar o tempo mximo que o E3 Studio ou o E3 Admin levam para conectarem-se ao E3 Server. Isso feito atravs da seguinte chave de registro do Windows:
HKEY_LOCAL_MACHINE\SOFTWARE\Elipse Software\E3\REC
A varivel a ser criada ConnectionTimeout que deve ser do tipo DWORD. A varivel indica o tempo mximo de conexo, em milissegundos. Quando a varivel no existe, assumido o valor padro de 6000 ms (para permitir esperar os 5000 ms que o E3 Server pode demorar por padro para detectar a hardkey). NOTA: O E3 Admin tenta conectar ao E3 Server repetidamente, exceto quando se usa um atalho do tipo E3Admin -opo.
26.4. Configuraes dos Logs

26.4.1. Definir tempo mnimo para funes de Log Full
possvel definir o tempo mnimo para logar uma funo nos logs Full (funes que durarem menos que este tempo no sero logadas). A chave do registro do Windows :
HKEY_LOCAL_MACHINE\SOFTWARE\Elipse Software\E3\Logs
A varivel a ser criada FullLogThresholdMsec, que deve ser do tipo DWORD. Quando a varivel est ausente, assume o valor padro de 100 ms. O valor 0 fora todas chamadas a serem logadas (um valor muito baixo pode prejudicar sensivelmente a performance do aplicativo).
26.4.2. Definir tempo para mensagens de funes trancadas

possvel definir o tempo (em milisegundos) que uma funo deve estar rodando para que seja gerado um aviso (EcoLogWarning) de que a funo provavelmente est trancada. A chave de registro do Windows :
HKEY_LOCAL_MACHINE\SOFTWARE\Elipse Software\E3\Logs
A varivel a ser criada FullLogWarningMsec, que deve ser do tipo DWORD. O valor 0 desabilita a opo. Se no for zero, o valor mnimo aceito 20000. Quando a varivel est ausente assumido o valor padro de 30000 ms.
437
26.4.3. Habilitar ou desabilitar sees de log

possvel definir as sees de log que sero habilitadas. Algumas sees podem ser subdivididas em mdulos, de modo que possvel habilitar cada mdulo separadamente. As sees so habilitadas atravs da seguinte chave de registro do Windows:
HKEY_LOCAL_MACHINE\Software\Elipse Software\E3\Logs
As variveis a serem configuradas devem ter os mesmos nomes das sees, e devem ser do tipo DWORD. Se as variveis no forem especificadas, o sistema assume automaticamente que os logs no sero criados, exceto para as sees E3 e IOData. Se as variveis forem especificadas, o valor 0 desabilita a criao de logs (com exceo da seo E3), e qualquer valor diferente de 0 habilita o log da seo. O prximo exemplo desabilita a seo IOData do log:
HKEY_LOCAL_MACHINE\SOFTWARE\Elipse Software\E3\Logs\IOData = 0
NOTA: A alterao das variveis pode ser feita com o E3 em execuo e aplicada at 30 segundos depois de executada. Tambm possvel habilitar ou desabilitar um mdulo especfico dentro de uma seo. Isso feito atravs da seguinte chave de registro do Windows:
HKEY_LOCAL_MACHINE\Software\Elipse Software\E3\Logs
As variveis a serem configuradas devem ser no formato <nome_da_seo>.<nome_do_modulo>, e devem ser do tipo DWORD. Por exemplo, para desabilitar os logs Full, deixando habilitados apenas os logs do mdulo E3Runtime, devem ser definidas as seguintes variveis:
Full=0 Full.E3Runtime=1
As sees de log disponveis so as seguintes:

Sees de log e seus mdulos DESCRIO Este o log principal do E3, com mensagens de erro, avisos, estatsticas e outras informaes. Mostra erros em operaes de banco de dados ou operaes de descarte de dados, bem como o resultado de operaes executadas nos threads de aquisio e de execuo. O mdulo disponvel nessa seo o seguinte: <Nome_DBServer>: mostra mensagens relativas a cada Servidor de Banco de Dados.
SEO E3 DB
438
SEO Sync
IOData
ImportExport
RECRaw
Track
Undo
Playback
DESCRIO Permite acompanhar as informaes que so sincronizadas entre o E3 Server e o E3Run (e entre E3 Servers em Hot-Standby). Os mdulos disponveis nessa seo so os seguintes: Alarm: mostra mensagens de alarme geradas pelo E3Run, que so passadas para o sumrio de alarmes mantido pelo E3 Server. Vars: mostra as alteraes feitas na base de tags persistentes do E3 Server. Mostra os dados lidos e escritos pelo E3Run. O mdulo disponvel nessa seo o seguinte: Driver: mostra os dados que foram passados pelos IOServers para o E3Run, bem como os dados das escritas enviadas pelo E3Run para os IOServers. Log gerado pelo E3 Studio em processos de importao ou exportao de dados. O mdulo disponvel nessa seo o seguinte: CSV: mostra os logs de operaes de importao ou exportao para arquivos .CSV. Log detalhado das comunicaes do REC. O mdulo disponvel nessa seo o seguinte: Packet: mostra o cabealho dos pacotes REC enviados e recebidos. Registra o ciclo de vida de determinados tipos de objetos, desde a sua criao at sua destruio. O mdulo disponvel nessa seo o seguinte: <NomeDoProcesso>: identifica o processo (E3 Server, E3Run, Viewer ou E3 Studio) onde os objetos esto instanciados. Registra as atividades do sistema da opo de menu Desfazer do E3 Studio. O mdulo disponvel nessa seo o seguinte: Undo: mostra as pilhas Desfazer mantidas pelo E3 Studio em cada operao. Log gerado pelo E3Playback.
Existem sesses de log especiais que registram as operaes executadas em um thread especfico, bem como a sua durao. Apenas as operaes que durarem mais que um determinado tempo (valor padro 100 ms) so logadas. Estes logs permitem verificar quando o processamento do E3 se torna lento, quase parado.
439
SEO Full
FullDB
Sees de log especiais e seus mdulos DESCRIO Log principal que rene informaes gerais sobre a execuo do E3 Server, E3Run, E3 Studio e E3 Viewer. Mdulos disponveis: E3Runtime: thread principal do E3Run, permite identificar travamentos ou lentido na execuo do aplicativo E3. E3 Server: thread principal do E3 Server. LicenseManager: thread do verificador de licena do E3 Server. DomainManager: thread de gerenciamento do estado do Domnio no E3 Server (abre ou fecha o Domnio ativo, atualiza o Domnio a partir de modificaes no arquivo .DOM). Studio: thread principal (de interface) do E3 Studio. Viewer: thread principal (de interface) do E3 Viewer, permite diagnosticar tempos de abertura de Telas, tempo de execuo de scripts, etc. Registra a operao dos threads de acesso a banco de dados do E3 (gerado pelo E3Run e E3 Server). Mdulos disponveis: DBAcquisition: thread que passa para as filas (.E3I) os dados gerados pelo aplicativo. DBExec: thread que remove operaes das filas (.E3O) e executa os comandos no banco de dados. Registra as operaes executadas nos threads gerenciados pelo REC. Mdulo disponvel: RECServer: thread servidor de uma conexo REC (no E3 Server). Registra a atividade nos threads do IOServer. Mdulos disponveis: IOServer: thread principal do IOServer, que recebe a configurao do driver e requisies enviadas pelo E3Run. CallBack: thread de envio para o E3Run de dados coletados pelo driver. Driver: thread onde o driver roda.
FullREC
FullIO
NOTA: A configurao do mdulo tem precedncia sobre a configurao da seo apenas.
440
27
27.
Captulo
Dvidas mais freqentes
Este captulo destina-se ao esclarecimento das dvidas mais freqentes encontradas no E3. Tambm so mostrados os erros que podem ocorrer e quais as solues para eles.
27.1. E3 Studio
27.1.1. Ordem dos Tabs
A ordem dos objetos em runtime diferente da configurada no E3 Studio. Por que isto ocorreu? POSSVEL CAUSA:
Quando um novo objeto criado na Tela, atribui-se a ele a primeira posio, e ele ordenado em seqncia decrescente aos demais objetos da Tela.
SOLUO:
Para manter a ordem inicial dos objetos, necessrio seguir estes procedimentos: Aps ter criado o objeto na Tela, clique na opo Ordem dos Tabs Com a tecla [CTRL] pressionada, clique no penltimo objeto; Solte a tecla [CTRL] e clique no ltimo objeto (objeto criado anteriormente). NOTA: O valor da opo Ordem dos Tabs o mesmo do Z-Order. Z-Order o valor da ordem de sobreposio dos objetos da Tela. ;
27.1.2. Sobreposio de animaes nos objetos

Criei uma animao com rotao/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 que isto ocorreu? POSSVEL CAUSA:
A nova animao foi criada sem que a anterior tenha sido removida.
Dvidas mais freqentes 441
SOLUO:
Para solucionar esta questo, siga estes procedimentos: Selecione o objeto que deseja mudar a animao; Clique com o boto direito sobre ele e selecione a opo Remover animao; Aplique a animao desejada. NOTA: No tente remover a animao do objeto atravs do Organizer, pois esta ao ir remover o objeto.
27.2. Objetos de Tela

No consigo rotacionar uma figura inserida atravs da Galeria. Por que isto ocorre? RESPOSTA:
Devemos 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.3. Servidor de Banco de Dados SQL Server

Abaixo sero 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 de se conectar 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 ou verifique a senha utilizada.

442 Dvidas mais freqentes
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.
SOLUO:
Mudar o nome do objeto.
27.4. Servidor de Banco de Dados Oracle

Abaixo 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 e no os encontra (ex.: a tabela de Histricos no existia, deve ser criada).
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 acima 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 importante verificar se a chave a mais adequada. Para ilustrar essa afirmao, poderemos ver dois casos: Sistema de Telemedio de Energia: Visando gravar todos os dados de um dia, as rotinas usadas para coletar admitem tolerncias a mais e 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: O usurio deve criar um ndice nico para os campos da chave; O usurio deve verificar a aplicao para que ela no envie valores repetidos de chave para a gravao.
27.5. Servidor de Dados

A propriedade Retentive do tag interno no est funcionando, pois ele no guarda o ltimo valor ao parar o Domnio. O que pode estar errado? RESPOSTA:
A propriedade Retentive no tem este objetivo. Ela tem utilidade apenas em aplicaes hot-standby, para manter o valor do tag interno quando houver uma troca de servidor.
Como salvar o valor de um tag interno quando parar o Domnio? RESPOSTA:
Use o mtodo Save() do Servidor de Dados.
444
Como eu mostro a data e a hora atual do sistema em uma tela da minha aplicao? RESPOSTA:
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 fazer um temporizador no E3? RESPOSTA:
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 da propriedade Enabled ao valor True 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.6. Drivers de Comunicao

O que tenho que fazer para usar os bits de um tag de comunicao? RESPOSTA:
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? RESPOSTA:
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? RESPOSTA:
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.
445
Como sinalizar erros de comunicao na Tela? RESPOSTA:
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? RESPOSTA:
Acesse o objeto Viewer, e altere a cor desejada na aba Erro de Comunicao.
27.7. 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 voc 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 Alarmes.
SOLUO:
Voc tem trs possveis respostas pergunta feita na mensagem de erro: Sim: Voc ir prosseguir a importao dos alarmes contidos no arquivo CSV, ignorando apenas este erro de nmero de colunas. O alarme cujas colunas esto incorretas no ser importado. Sim (Todos): Voc ir prosseguir a importao dos alarmes 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 feito 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.
446
Criei um arquivo CSV manualmente, contendo a configurao dos Alarmes. Como fao para import-lo? RESPOSTA:
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 E3TimeStamp com milissegundos no E3Browser e no E3Alarm? RESPOSTA:
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.
Apareceu a seguinte mensagem de erro: "Impossvel criar assinaturas de alarmes no servidor de alarmes com filtro. Error code: (0x800706F7)". O que isto significa? RESPOSTA:
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 alarmes 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 associadas a alarmes, alarmes e reas do objeto configurao de alarmes? RESPOSTA:
Para apagar um tag que est associado a um alarme: Selecionar o tag desejado com o mouse e apertar 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].
27.8. E3Alarm
Os alarmes no aparecem no E3Alarm. Por que isto ocorreu? POSSVEIS CAUSAS:
Para checar a configurao do E3Alarm, verifique que o nome do servidor esteja configurado corretamente. Outra causa possvel a existncia de mais de um
servidor de alarmes no Domnio, o que causa problemas. Mais uma causa possvel seria um filtro configurado para uma rea de alarme inexistente.
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? RESPOSTA:
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? RESPOSTA:
Habilite a opo Reconhecer Alarme, localizada nas propriedades da coluna desejada no objeto E3Alarm, na aba Colunas.
27.9. E3Browser
Como limitar o nmero de registros que vo aparecer no E3Browser? RESPOSTA:
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.10.
E3Chart
possvel no plotar o valor de um tag quando a qualidade estiver ruim, em um E3Chart histrico? RESPOSTA:
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.
448
27.11.
Histrico
Como no gravar os registros de histricos por scan? RESPOSTA:
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().
27.12.
Associaes
Como criar um tag expresso no E3? RESPOSTA:
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? RESPOSTA:
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 multilnge? RESPOSTA:
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 todos os strings da aplicao, onde a primeira coluna o nome do tag interno criado no Viewer, e cada coluna seguinte contm o 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 os 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 escolhido 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 um 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 o string que ser utilizado.
27.13.
Viewer
No consigo conectar um Viewer remoto ao Servidor. Por que isso est acontecendo? POSSVEL CAUSA:
Existe um firewall bloqueando o acesso ao servidor.

SOLUO:
Deve-se liberar as portas utilizadas pelo E3. Esta informao pode ser encontrada no site da Elipse Software, na seo de artigos.
No consigo abrir um Viewer remoto pelo Internet Explorer. Por que isso est acontecendo? POSSVEIS CAUSAS:
O Viewer no foi instalado na mquina remota; Mesmas causas da questo anterior.

SOLUO:
Voc pode 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 a vez que voc tentar abrir um Viewer pelo Internet Explorer num computador remoto onde o Viewer no foi previamente instalado, a instalao ser iniciada automaticamente.
450
27.14.
Bibliotecas
Ao abrir uma Tela, aparece uma mensagem dizendo que um objeto no pode ser carregado corretamente POSSVEL CAUSA:
Voc apagou algum XControl da biblioteca que estava sendo usada dentro desta Tela ou ento voc removeu do Domnio a LIB que contm este XControl.
SOLUO:
No primeiro caso, se voc apagou 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.
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 que 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 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 runtime.
SOLUO:
Para resolver este problema, voc tem que 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? RESPOSTA:
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.15.
Relatrios
Como colocar data/hora atual em um relatrio do E3? RESPOSTA:
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, devemos digitar o nome completo do tag (ex.: Dados.TagDemo1.Value). Configure o formato da data desejada. Isto pode ser feito clicando com o boto direito 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 scripts para estas variveis. Como solucionar este problema? RESPOSTA:
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? RESPOSTA:
O mtodo CopyConfig() no copia os valores de variveis de consulta, sendo necessrio fazer isto via scripts dentro do grfico. As penas configuradas no E3Chart em tela so do tipo real.
Como fazer um filtro por datas no relatrio? RESPOSTA:
Crie uma consulta SQL no relatrio filtrando por data inicial e data final. Na tela onde 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? RESPOSTA:
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.
Como imprimo dois relatrios em impressoras diferentes? RESPOSTA:
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 mensagem de erro quando falhar a impresso do relatrio? RESPOSTA:
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.
453
27.16.
Domnios e projetos
O que acontece com os eventos gerados pelo E3 Server enquanto o Domnio no est rodando? RESPOSTA:
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 que isto ocorreu? RESPOSTA:
Muitas vezes, quando utilizamos o E3 Admin via linha de comando, podemos 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. 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? RESPOSTA:
Criando o Domnio pela rede, vrias pessoas podero abri-lo em mquinas diferentes e trabalharem 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 LIB alterado.
Qual o efeito de clicar na opo "Atualizar" do menu do projeto? RESPOSTA:
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 sero visveis para todas as outras, assim que abrirem o objeto especfico alterado ou quando atualizarem o projeto ou LIB alterado.
27.17.
Stored Procedure
Como executo uma stored procedure no E3? RESPOSTA:
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 NomeDaStoredPorcedure var1, var2, ...
onde a sintaxe das variveis o sinal de maior, o sinal de percentual entre o nome da varivel e o sinal de menor. var1 e var2 so as variveis que a stored procedure est esperando (por exemplo, data inicial e data 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.18.
Domnios Remotos
Como funciona o licenciamento dos Domnios Remotos? RESPOSTA:
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.
Quando cai a comunicao entre o Domnio Cliente e o Domnio Servidor, o que acontece? RESPOSTA:
Quando uma situao de erro ocorrer, todos as associaes da aplicao-cliente referenciando o Domnio ficaro desconectados (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? RESPOSTA:
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? RESPOSTA:
No.
Um Domnio Cliente pode usar usurios de outros Domnios Remotos? RESPOSTA:
No.
possvel conectar um Domnio a vrios outros Domnios? RESPOSTA:
Sim, como pode-se ver na figura a seguir:
456
possvel conectar um Domnio a um Domnio em Hot-Standby? RESPOSTA:
Sim. Considere a seguinte arquitetura:
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 clientes (Viewers).
457

E3manual BR

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

E3manual BR

Enviado por

Direitos autorais:

Formatos disponíveis

MANUAL DO USURIO

10.1. 10.1.1. 10.1.2. 10.1.3. 10.2. 10.3. 10.4. 11.

EXEMPLO DE CRIAO DE UMA FRMULA ..................................................................................................... 363

Viewer executado na Mquina Cliente

Viewer executado na Mquina Servidora e Acessado via Terminal Service

Figura 1: Diagrama dos blocos que compem o E3

Figura 2: Caminho indicado pelo sistema quando o E3 instalado

Figura 4: Ao iniciar o E3, a janela acima mostrada

As opes disponveis so as seguintes:

Figura 5: rea de Trabalho

Figura 6: Aba Comandos

As opes disponveis so as seguintes:

OPO Categorias Comandos Descrio

Figura 7: Aba Barra de Ferramentas

As opes disponveis so as seguintes:

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

Figura 8: Aba Menus

As opes disponveis so as seguintes:

OPO Mostra menus para

Animao dos menus Menus com sombra

Figura 9: Aba Aparncia

As opes disponveis so as seguintes:

OPO Office XP Windows XP Office 2000 Office 2003 VS.Net 2005

Figura 10: Aba Opes

As opes disponveis so as seguintes:

Figura 11: Configuraes do Editor de Scripts

As opes disponveis deste item so as seguintes:

Figura 12: Configuraes de Arquivos

Figura 13: Configuraes do Studio

As opes disponveis deste item so as seguintes:

2.4. Barra de Ferramentas

Salva o projeto. Salva todo o Domnio.

COMANDO Sombra direita Cor da sombra

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

Figura 14: Verificao de erros no projeto

Figura 15: Mensagem do item Verificar Domnio

A ferramenta Substituir substitui as ocorrncias encontradas por outro texto especificado.

Figura 16: Procurar/Substituir

Mostra ou esconde as opes de pesquisa e substituio.

OPO Boto Boto

Figura 17: Assistente de documentao de scripts

Figura 18: Arquivo de documentao de scripts

Figura 19: Detalhamento do arquivo

Por exemplo, o script abaixo:

Figura 20: Separador de scripts

Figura 21: Mensagem de finalizao da gerao do arquivo que contm os scripts

Figura 22: Relatrio de verses

As opes mostradas nesta caixa de dilogo so as seguintes:

Figura 23: WatchWindow

A caixa de dilogo apresenta as seguintes opes:

Figura 24: Organizer

Figura 25: Modo Domnio

Figura 26: Modo Explorer

OPO Fechar Atualizar Registrar! Salvar Como... Desfragmentar

Nova Pasta Inserir Inserir Recurso Habilitar/Desabilitar projeto

Documentar Scripts... Verificar Editar Associaes

OPO Copiar/Colar Associaes

Fechar Todos os Arquivos Editar a Ordem de Ativao...

Figura 27: Ordem de ativao do Domnio

Figura 28: Arquivo CSV visualizado no Excel

Importao e exportao de objetos

Figura 29: Exportao de objetos

Figura 30: Hierarquia de Driver1