Você está na página 1de 463

2006 Elipse Software Ltda. Todos os direitos reservados.

05.08.2006 Verso 2.5






MANUAL DO
U8UARO

ndice
1. INTRODUO........................................................................................................................................................... 11
1.1. DESCRIO GERAL............................................................................................................................................... 12
1.2. ARQUITETURA DO E3............................................................................................................................................ 13
1.3. DIAGRAMA DE BLOCOS ......................................................................................................................................... 16
1.4. ESTRUTURA DE DOMNIO ...................................................................................................................................... 17
1.5. PACOTES DISPONVEIS ......................................................................................................................................... 17
1.5.1. E3 Studio............................................................................................................................................... 17
1.5.2. Servidores E3........................................................................................................................................ 18
1.5.3. Servidores E3 Back-End....................................................................................................................... 18
1.5.4. Servidores Hot-Standby........................................................................................................................ 18
1.5.5. Demonstrao....................................................................................................................................... 18
2. E3 STUDIO................................................................................................................................................................. 19
2.1. INICIANDO UM PROJETO ........................................................................................................................................ 20
2.2. REA DE TRABALHO.............................................................................................................................................. 21
2.3. CONFIGURAO DO STUDIO.................................................................................................................................. 22
2.3.1. Aparncia do Studio.............................................................................................................................. 22
2.3.2. Outras configuraes............................................................................................................................ 27
2.3.3. Barra de Execuo do Projeto .............................................................................................................. 30
2.4. BARRA DE FERRAMENTAS..................................................................................................................................... 30
2.4.1. Verificar domnio ................................................................................................................................... 35
2.4.2. Procurar/Substituir ................................................................................................................................ 36
2.4.3. Documentao de Scripts ..................................................................................................................... 38
2.4.4. Relatrio de verses ............................................................................................................................. 44
2.4.5. WatchWindow....................................................................................................................................... 45
2.5. ORGANIZER.......................................................................................................................................................... 47
2.5.1. Fechar................................................................................................................................................... 48
2.5.2. Atualizar ................................................................................................................................................ 48
2.5.3. Salvar Como ......................................................................................................................................... 48
2.5.4. Desfragmentar ...................................................................................................................................... 49
2.5.5. Proteo................................................................................................................................................ 49
2.5.6. Nova Pasta............................................................................................................................................ 49
2.5.7. Inserir .................................................................................................................................................... 49
2.5.8. Inserir Recurso...................................................................................................................................... 50
2.5.9. Habilitar/Desabilitar projeto................................................................................................................... 50
2.5.10. Verificar projeto..................................................................................................................................... 51
2.5.11. Adicionar/Remover do Domnio ............................................................................................................ 51
2.5.12. Procurar/Substituir ................................................................................................................................ 51
2.5.13. Importar/Exportar .................................................................................................................................. 51
2.5.14. Documentar scripts ............................................................................................................................... 52
2.5.15. Editar Associaes................................................................................................................................ 52
2.5.16. Copiar/Colar Associaes..................................................................................................................... 52
2.5.17. Propriedades......................................................................................................................................... 52
2.6. IMPORTAO E EXPORTAO ............................................................................................................................... 52
2.6.1. Arquivo CSV.......................................................................................................................................... 53
2.6.2. Modelos................................................................................................................................................. 55
2.6.3. Gerenciador de modelos....................................................................................................................... 58
2.6.4. Importao e exportao de objetos..................................................................................................... 69
2.6.5. Importao e exportao de associaes............................................................................................. 72
2.6.6. Importao e exportao de colees .................................................................................................. 73
2.6.7. Logs e Relatrios de Falhas.................................................................................................................. 74
2.7. LISTA DE PROPRIEDADES...................................................................................................................................... 74
2.8. GALLERY.............................................................................................................................................................. 75
2.9. APPBROWSER...................................................................................................................................................... 76
2.9.1. Acessando o AppBrowser a partir de um script .................................................................................... 77
2.9.2. Acessando o AppBrowser a partir de uma associao......................................................................... 78
2.9.3. Acessando o AppBrowser a partir de uma propriedade........................................................................ 79
3. DOMNIOS ................................................................................................................................................................. 81
3.1. COMPONENTES DO DOMNIO................................................................................................................................. 82


3.2. CRIANDO UM DOMNIO.......................................................................................................................................... 83
3.2.1. Assistente de Aplicaes do E3............................................................................................................ 84
3.3. CONFIGURAES DE DOMNIO.............................................................................................................................. 91
3.3.1. Configuraes de Domnio via da barra de ferramentas...................................................................... 91
3.3.2. Configuraes de Domnio via menus do E3 Studio............................................................................. 92
3.3.3. Configuraes de Domnio via menu de contexto................................................................................. 92
3.3.4. Configuraes de Domnio via System Tray......................................................................................... 92
3.4. E3 SERVER .......................................................................................................................................................... 96
3.4.1. Criando Logs no E3 .............................................................................................................................. 97
3.4.2. Acessando o E3 Server via linha de comando...................................................................................... 97
3.4.3. Configuraes de Segurana do Domnio ............................................................................................ 97
3.4.4. Grupos de Viewers.............................................................................................................................. 100
3.4.5. Configuraes do Registro de Eventos do Domnio............................................................................ 102
3.4.6. Configuraes do Projeto no Domnio ................................................................................................ 111
3.4.7. Configuraes dos Servidores............................................................................................................ 112
3.4.8. Licenas.............................................................................................................................................. 115
3.4.9. Monitor ................................................................................................................................................ 116
3.4.10. Avanado............................................................................................................................................ 117
3.5. CONECTAR A ... .................................................................................................................................................. 118
4. DRIVERS ................................................................................................................................................................. 121
4.1. DRIVER DE COMUNICAO.................................................................................................................................. 121
4.1.1. Configurao dos Drivers de Comunicao........................................................................................ 123
4.1.2. Funcionamento dos Drivers de Comunicao .................................................................................... 124
4.1.3. Pasta de Comunicao....................................................................................................................... 128
4.1.4. Tag de Comunicao.......................................................................................................................... 129
4.1.5. Bloco de Comunicao....................................................................................................................... 130
4.1.6. Elementos de Bloco............................................................................................................................ 132
4.2. SERVIDOR OPC.................................................................................................................................................. 133
4.3. DRIVER DE COMUNICAO OPC......................................................................................................................... 134
4.3.1. Configurao dos Drivers OPC........................................................................................................... 136
4.3.2. Grupo de tags OPC............................................................................................................................. 143
4.3.3. Pasta OPC.......................................................................................................................................... 144
4.3.4. Tag de Comunicao OPC................................................................................................................. 145
4.3.5. Bloco de Comunicao OPC .............................................................................................................. 146
4.3.6. Elemento de Bloco OPC..................................................................................................................... 148
4.4. QUALIDADE......................................................................................................................................................... 149
4.4.1. Campo SubStatus............................................................................................................................... 150
4.4.2. Campo Limite...................................................................................................................................... 152
5. SERVIDOR DE DADOS........................................................................................................................................... 153
5.1. PASTA DE DADOS ............................................................................................................................................... 154
5.2. TAG DEMO.......................................................................................................................................................... 154
5.3. TAG INTERNO ..................................................................................................................................................... 155
5.4. OUTROS TIPOS DE DADOS................................................................................................................................... 155
5.5. REGRAS PARA O NOME DOS TAGS....................................................................................................................... 156
6. TELAS E QUADROS............................................................................................................................................... 157
6.1. TELA .................................................................................................................................................................. 157
6.1.1. Componentes da Tela......................................................................................................................... 159
6.2. QUADROS........................................................................................................................................................... 162
7. OBJETOS DE TELA................................................................................................................................................ 167
7.1. LINHA................................................................................................................................................................. 168
7.2. RETNGULO....................................................................................................................................................... 168
7.3. RETNGULO ARREDONDADO............................................................................................................................... 169
7.4. ELIPSE ............................................................................................................................................................... 170
7.5. ARCO DE ELIPSE................................................................................................................................................. 170
7.6. DESENHO LIVRE ................................................................................................................................................. 171
7.7. POLGONO.......................................................................................................................................................... 172
7.8. POLGONO DE CURVAS ....................................................................................................................................... 172
7.9. FIGURA............................................................................................................................................................... 173
7.10. TEXTO......................................................................................................................................................... 175
7.11. DISPLAY...................................................................................................................................................... 175
7.12. SETPOINT ................................................................................................................................................... 176
7.13. ESCALA....................................................................................................................................................... 176
7.14. CONFIGURAES GERAIS............................................................................................................................ 177


7.14.1. Travar.................................................................................................................................................. 177
7.14.2. Ponto ncora ...................................................................................................................................... 177
7.14.3. Configurar como Padro..................................................................................................................... 178
7.14.4. Aplicar Estilo ....................................................................................................................................... 178
7.14.5. Recortar, Copiar e Colar ..................................................................................................................... 178
7.14.6. Deletar................................................................................................................................................. 179
7.14.7. Propriedades....................................................................................................................................... 179
7.14.8. Animao ............................................................................................................................................ 179
7.14.9. Sobreposio de Objetos.................................................................................................................... 181
7.14.10. Ordem de Navegao entre os objetos............................................................................................... 181
7.14.11. Selecionando objetos na Tela............................................................................................................. 182
7.14.12. Agrupando objetos e editando objetos agrupados.............................................................................. 182
7.14.13. Uso de Teclas Direcionais................................................................................................................... 183
7.14.14. Modificando Camadas do Objeto........................................................................................................ 183
7.14.15. Sombreamento.................................................................................................................................... 183
7.14.16. Preenchimento.................................................................................................................................... 185
7.14.17. Gradiente e Estilos de Gradiente ........................................................................................................ 186
7.14.18. Estilo de Fundo ................................................................................................................................... 188
7.14.19. Bordas................................................................................................................................................. 189
7.14.20. Preenchimento Parcial Horizontal e Vertical ....................................................................................... 189
7.14.21. Formatao de Cores ......................................................................................................................... 190
7.15. FORMATAO DE VALORES.......................................................................................................................... 193
7.15.1. Formatos Pr-Definidos ...................................................................................................................... 193
7.15.2. Outros Formatos ................................................................................................................................. 194
7.15.3. Entrada de Texto................................................................................................................................. 194
7.15.4. Formatadores Numricos.................................................................................................................... 195
8. ACTIVEX.................................................................................................................................................................. 199
8.1. REGISTRANDO OBJETOS ACTIVEX NO E3 ............................................................................................................ 199
8.2. INSERINDO OBJETOS ACTIVEX NO E3.................................................................................................................. 202
8.3. OBJETOS MICROSOFT FORMS............................................................................................................................. 203
8.3.1. Caixa de Seleo................................................................................................................................ 203
8.3.2. Boto de Opo .................................................................................................................................. 203
8.3.3. Lista de Seleo.................................................................................................................................. 204
8.3.4. Boto de Comando ............................................................................................................................. 204
8.3.5. Texto................................................................................................................................................... 205
8.3.6. Lista .................................................................................................................................................... 205
8.3.7. Barra de Rolagem............................................................................................................................... 206
8.3.8. Boto Incremento-Decremento........................................................................................................... 206
8.3.9. Editor de Texto.................................................................................................................................... 207
8.3.10. Boto Liga-Desliga.............................................................................................................................. 209
9. ASSOCIAES....................................................................................................................................................... 211
9.1. CONEXO SIMPLES............................................................................................................................................. 213
9.2. CONEXO BIDIRECIONAL..................................................................................................................................... 214
9.3. CONEXO DIGITAL .............................................................................................................................................. 215
9.4. CONEXO ANALGICA ........................................................................................................................................ 217
9.5. CONEXO POR TABELA....................................................................................................................................... 218
9.6. CONEXO REVERSA............................................................................................................................................ 220
9.7. EDIO DE ASSOCIAES................................................................................................................................... 221
10. VIEWER ................................................................................................................................................................... 225
10.1. CONFIGURAO DO VIEWER........................................................................................................................ 226
10.1.1. Configuraes do Visualizador............................................................................................................ 226
10.1.2. Erros de Comunicao........................................................................................................................ 228
10.2. VARIVEIS NO VIEWER................................................................................................................................. 229
10.3. OBJETO TOP ............................................................................................................................................... 229
11. BANCO DE DADOS................................................................................................................................................. 231
11.1. BANCO DE DADOS ACCESS.......................................................................................................................... 232
11.2. BANCO DE DADOS ORACLE.......................................................................................................................... 233
11.2.1. Acessando o Banco de Dados Oracle dentro do E3........................................................................... 233
11.2.2. Acessando o Banco de Dados Oracle via Scripts............................................................................... 234
11.2.3. Tecnologias utilizadas pelo E3 para o acesso ao Banco de Dados Oracle......................................... 235
11.2.4. Acessando o Oracle via Servidor BD.................................................................................................. 236
11.3. BANCO DE DADOS SQL SERVER.................................................................................................................. 238
11.3.1. Acessando o Banco de Dados SQL Server dentro do E3................................................................... 238


11.3.2. Exemplo de utilizao do SQL Server 2000........................................................................................ 239
11.3.3. Uso de ADODB para acesso via Script............................................................................................... 240
11.4. OBJETOS DO E3 E PERMISSES................................................................................................................... 241
12. ALARMES................................................................................................................................................................ 243
12.1. CONFIGURAO DE ALARMES...................................................................................................................... 243
12.1.1. reas de Alarme ................................................................................................................................. 244
12.1.2. Fontes de Alarme................................................................................................................................ 245
12.2. SERVIDOR DE ALARMES............................................................................................................................... 251
12.2.1. Configuraes para gerao da Tabela de Alarmes........................................................................... 252
12.2.2. Configuraes dos Campos do Usurio.............................................................................................. 259
13. E3ALARM................................................................................................................................................................ 261
13.1. CONFIGURAES DO E3ALARM................................................................................................................... 262
13.1.1. Configuraes Gerais ......................................................................................................................... 262
13.1.2. Configuraes de Colunas.................................................................................................................. 264
13.1.3. Ordenao de Campos....................................................................................................................... 265
13.1.4. Configurao de Cores ....................................................................................................................... 267
13.1.5. Configurao de Fontes...................................................................................................................... 270
13.2. CARACTERSTICAS ESPECFICAS DE RUNTIME .............................................................................................. 271
13.2.1. Visualizando os Alarmes..................................................................................................................... 271
13.2.2. Reconhecimento de Alarmes.............................................................................................................. 272
13.2.3. Ordenao de Colunas ....................................................................................................................... 273
14. HISTRICOS........................................................................................................................................................... 275
14.1. CONFIGURAES DO HISTRICO................................................................................................................. 277
14.1.1. Chave Primria ................................................................................................................................... 277
14.1.2. ndices................................................................................................................................................. 279
14.1.3. Configuraes da Tabela.................................................................................................................... 282
15. E3STORAGE ........................................................................................................................................................... 289
15.2. CONFIGURAES DO E3STORAGE............................................................................................................... 291
15.3. CONFIGURAO DA TABELA......................................................................................................................... 293
15.3.1. Execuo ............................................................................................................................................ 296
15.3.2. Ferramentas de Consultas Internas (E3Query) .................................................................................. 297
15.3.3. Utilizao ............................................................................................................................................ 299
15.3.4. Ferramentas de Consultas Externas (Stored Procedures).................................................................. 300
16. CONSULTAS........................................................................................................................................................... 307
16.1. CRIANDO UMA CONSULTA............................................................................................................................ 308
16.2. FUNES GERAIS........................................................................................................................................ 310
16.3. TABELAS ..................................................................................................................................................... 311
16.4. COLUNAS .................................................................................................................................................... 312
16.5. SINTAXE SQL.............................................................................................................................................. 314
16.6. RESULTADO DA CONSULTA.......................................................................................................................... 314
16.7. USO DOS FILTROS DA CONSULTA ATRAVS DE SCRIPTS................................................................................ 315
16.8. USO DE RECORD SETS DE UMA CONSULTA ATRAVS DE SCRIPTS................................................................. 315
17. E3BROWSER .......................................................................................................................................................... 317
17.1. OBJETO CONSULTA NO E3BROWSER........................................................................................................... 318
17.2. OUTRAS CONFIGURAES DO E3BROWSER................................................................................................. 319
17.2.1. Configuraes de Estilo ...................................................................................................................... 319
17.2.2. Configurao de Atualizao dos Dados ............................................................................................ 321
17.2.3. Configurao das cores do E3Browser............................................................................................... 322
17.2.4. Configuraes da Fonte do E3Browser .............................................................................................. 323
18. E3CHART ................................................................................................................................................................ 325
18.1. CONFIGURAES DO E3CHART ................................................................................................................... 326
18.1.1. Configuraes Gerais do E3Chart ...................................................................................................... 326
18.1.2. Configurao dos Eixos do E3Chart ................................................................................................... 329
18.1.3. Configuraes das Penas................................................................................................................... 334
18.1.4. Configuraes da Legenda................................................................................................................. 341
18.1.5. Configuraes das Consultas ............................................................................................................. 344
18.1.6. Configurao das Fontes.................................................................................................................... 345
18.2. EXEMPLOS DE UTILIZAO DO E3CHART...................................................................................................... 345


18.2.1. Habilitando e desabilitando penas no E3Chart ................................................................................... 345
18.2.2. Atualizando o E3Chart histrico com os dados da ltima hora........................................................... 346
18.2.3. Habilitando/desabilitando a visualizao da pena no E3Chart............................................................ 348
18.2.4. Criao de uma pena por script .......................................................................................................... 349
18.3. CARACTERSTICAS ESPECFICAS DE RUNTIME............................................................................................... 350
19. FRMULAS ............................................................................................................................................................. 355
19.1. CONFIGURAES DA FRMULA.................................................................................................................... 356
19.2. TEMPLATES................................................................................................................................................. 357
19.3. UNIDADES ................................................................................................................................................... 359
19.4. CONJUNTO DE VALORES.............................................................................................................................. 360
19.5. EXEMPLO DE CRIAO DE UMA FRMULA..................................................................................................... 361
20. BIBLIOTECAS ......................................................................................................................................................... 369
20.1. GALLERY..................................................................................................................................................... 370
20.2. BIBLIOTECA DO USURIO ELIPSEX............................................................................................................. 371
20.2.1. XControls ............................................................................................................................................ 373
20.2.2. XObject ............................................................................................................................................... 375
20.3. QUANDO CRIAR UM ELIPSEX........................................................................................................................ 377
21. RELATRIOS.......................................................................................................................................................... 379
21.1. OBJETO CONSULTA ..................................................................................................................................... 379
21.2. COMPONENTES DO RELATRIO.................................................................................................................... 380
21.2.1. Report Header..................................................................................................................................... 380
21.2.2. Report Footer ...................................................................................................................................... 380
21.2.3. Page Header ....................................................................................................................................... 381
21.2.4. Page Footer ........................................................................................................................................ 381
21.2.5. Group Header, Group Footer .............................................................................................................. 381
21.2.6. Detail ................................................................................................................................................... 381
21.3. CONFIGURAES DO RELATRIO................................................................................................................. 381
21.3.1. Preview ............................................................................................................................................... 385
21.3.2. Report Settings ................................................................................................................................... 386
21.3.3. Script Editor......................................................................................................................................... 390
21.3.4. Carregar Arquivo RPX......................................................................................................................... 390
21.3.5. Salvar Arquivo RPX ............................................................................................................................ 390
21.4. OBJETOS DO RELATRIO............................................................................................................................. 391
21.4.1. Linha ................................................................................................................................................... 391
21.4.2. Retngulo............................................................................................................................................ 391
21.4.3. Retngulo Arredondado...................................................................................................................... 391
21.4.4. Elipse .................................................................................................................................................. 392
21.4.5. Texto................................................................................................................................................... 392
21.4.6. Figura.................................................................................................................................................. 392
21.4.7. Campo de Dados ................................................................................................................................ 393
21.4.8. Caixa de seleo................................................................................................................................. 394
21.4.9. Cdigo de barras................................................................................................................................. 394
21.4.10. E3Chart ............................................................................................................................................... 395
21.4.11. Quebra de Pgina............................................................................................................................... 395
21.4.12. Quadro................................................................................................................................................ 396
21.5. CRIANDO UM RELATRIO NO E3................................................................................................................... 396
21.6. EXEMPLOS DE UTILIZAO NOS RELATRIOS ............................................................................................... 398
22. SEGURANA .......................................................................................................................................................... 403
22.1. USURIOS................................................................................................................................................... 405
22.2. GRUPOS...................................................................................................................................................... 409
22.3. PERMISSES............................................................................................................................................... 414
22.4. PROTEO DE ARQUIVOS............................................................................................................................. 424
23. E3 VIEWER E E3 WEBVIEWER.............................................................................................................................. 429
23.1. VIEWER ONLY (MODO SOMENTE LEITURA) ................................................................................................... 430
23.1.1. Mudanas no modo do Viewer............................................................................................................ 431
23.2. EXECUO DO E3 VIEWER........................................................................................................................... 432
23.2.1. Execuo atravs do Studio................................................................................................................ 432
23.2.2. Execuo atravs da Linha de Comando............................................................................................ 433
23.2.3. Execuo atravs do Menu Iniciar ...................................................................................................... 433
23.3. LOGS DO VIEWER ........................................................................................................................................ 434
23.4. EXECUO DO E3 WEBVIEWER................................................................................................................... 434


23.4.1. Aplicaes E3 na internet ................................................................................................................... 436
23.4.2. Aplicaes E3 na intranet ou na mquina local .................................................................................. 438
24. HOT-STANDBY ....................................................................................................................................................... 439
24.1. EXECUTANDO UM DOMNIO DISTRIBUDO...................................................................................................... 440
24.2. PARANDO UM DOMNIO DISTRIBUDO............................................................................................................ 440
24.3. PARANDO UM DOS SERVIDORES DO DOMNIO............................................................................................... 440
24.4. TEMPO DE TROCA ENTRE SERVIDORES ........................................................................................................ 440
24.5. RECONEXO DE VIEWERS............................................................................................................................ 441
24.6. UTILIZANDO BANCO DE DADOS COM HOT-STANDBY ..................................................................................... 441
24.7. CONFIGURANDO O HOT-STANDBY................................................................................................................ 442
25. CONFIGURAES AVANADAS.......................................................................................................................... 445
25.1. JANELA DE PROGRESSO DO E3RUN............................................................................................................. 445
25.2. COMPACTAO DE PACOTES DO REC......................................................................................................... 445
25.3. PORTA UTILIZADA PELO REC....................................................................................................................... 446
25.4. MLTIPLAS CPUS........................................................................................................................................ 446
25.5. PING DO E3 SERVER ................................................................................................................................... 446
26. DVIDAS MAIS FREQENTES.............................................................................................................................. 447
26.1. STUDIO ....................................................................................................................................................... 447
26.1.1. Ordem dos Tabs ................................................................................................................................. 447
26.1.2. Sobreposio de animaes nos objetos............................................................................................ 448
26.2. OBJETOS DE TELA....................................................................................................................................... 448
26.3. SERVIDOR DE BANCO DE DADOS SQL SERVER............................................................................................ 448
26.4. SERVIDOR DE BANCO DE DADOS ORACLE.................................................................................................... 449
26.5. SERVIDOR DE DADOS .................................................................................................................................. 451
26.6. DRIVERS DE COMUNICAO......................................................................................................................... 452
26.7. ALARMES .................................................................................................................................................... 452
26.8. E3ALARM.................................................................................................................................................... 454
26.9. E3BROWSER............................................................................................................................................... 455
26.10. E3CHART.................................................................................................................................................... 455
26.11. HISTRICO.................................................................................................................................................. 455
26.12. ASSOCIAES............................................................................................................................................. 456
26.13. VIEWER....................................................................................................................................................... 457
26.14. BIBLIOTECAS............................................................................................................................................... 457
26.15. RELATRIOS ............................................................................................................................................... 459
26.16. DOMNIOS E PROJETOS................................................................................................................................ 461
26.17. STORED PROCEDURE.................................................................................................................................. 463


Convenes
Estas so convenes utilizadas neste manual:

EXEMPLO DESCRIO
S!LO6.BNP Nomes de arquivos e outros termos no nvel do sistema
operacional so indicados com o tipo de letra Tahoma, em
maisculas.
Geral 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.
Agitao Caracteres entre aspas devem ser digitados no lugar
mencionado, sem a presena das aspas.
Tela1.Show() Partes de programas (scripts) so indicadas com o tipo de
letra Courier. Eles devero ser digitados nos lugares
reservados e depois compilados para a verificao de erros.
Tank01.High Caracteres em negrito indicam nomes de objetos do E3 ou
suas propriedades.
<nome do arquivo> Expresses entre os sinais < > devem ser substitudas pelo
nome do objeto em questo.
[Ctrl+Enter| Expresses entre colchetes indicam nomes de teclas.
Quando estiverem acompanhadas de um sinal +, voc deve
pressionar a segunda tecla enquanto pressiona a primeira.



Introduo 11

A Elipse Software tem orgulho de apresentar sua mais nova e moderna ferramenta
para superviso e controle de processos, o E3. Totalmente voltado 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 nova e exclusiva 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 e/ou controle, como os PLCs
(Controladores Lgicos Programveis), UTRs (Unidades Terminais Remotas),
DAQs (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 destes equipamentos. Estes drivers
podem ainda estar em um formato prprio da Elipse Software ou no formato OPC
(OLE for Process Control).
De posse dos dados, voc poder 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.
Capitulo
1
1. ntroduo
E3 Manual do Usurio
12 Introduo
1.1. Descrio Geral
O E3 foi desenvolvido inicialmente para a plataforma Microsoft Windows

2000 e
XP, utilizando alguns recursos disponveis somente nestes sistemas operacionais. A
interface grfica com o usurio pode ainda ser executada nos sistemas Windows


9X/NT/2000/Me/XP ou ainda 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 Server), 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 trs 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 Server para realizar um
fail-over (standby) ou distribuir cargas de processamento entre as mquinas. Foi
desenvolvido para ser executado sobre os sistemas operacionais Windows 2000 e
Windows XP.
E3STUD!O: 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 Studio estejam conectados ao
mesmo servidor remoto, com mltiplas configuraes.
E3 v!EWER: O Viewer permite operar as aplicaes residentes no servidor em
qualquer computador com o programa executvel Viewer (Windows 98, NT, Me,
2000 e XP) ou com um navegador de Internet. Em ambos os casos, no necessrio
instalar a aplicao na mquina cliente, pois todos os componentes (Telas,
bibliotecas, controles ActiveX) sero baixados e registrados automaticamente.

E3 Manual do Usurio
Introduo 13
1.2. Arquitetura do E3
Para supervisionar um determinado processo com um sistema SCADA, geralmente
construmos uma aplicao que conter a definio das variveis envolvidas, com
nomes e endereamentos, telas, definies de alarmes e outros, a que chamamos de
Banco de Dados da Aplicao.
Quando esse processo exige o uso de dois ou mais computadores, precisamos fazer
com que cada aplicao em cada computador troque dados com as outras. A maioria
dos sistemas SCADA tradicionais se baseiam numa arquitetura comum para realizar
essa tarefa:
Cada servidor SCADA deveria 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.
Isto nos 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 este problema usando o conceito de Domnio, que inclui em um
nico ambiente, a definio dos computadores executando tarefas de 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.
Voc tambm pode inserir, deletar 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
e 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. Isto 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 sabe disso 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 E3
Server (com as licenas suficientes de Viewer).
E3 Manual do Usurio
14 Introduo
O E3 Viewer possui trs destaques especiais:
Os projetos da aplicao residem no servidor somente;
O navegador Internet Explorer1 pode ser usado como interface de
operao com 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). Este protocolo permite a interao entre
uma estao cliente e uma mquina servidora (que ser acessada remotamente),
sendo que 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-n-One


Viewer executado na Maquina Cliente



1
Devero ser tomados cuidados com polticas de segurana para o envio de comandos pela Internet,
para evitar riscos potenciais ao expor o sistema. Algumas caractersticas devem ser configuradas na
aplicao para evitar tais riscos, mas depende tambm das regras das empresas onde tais sistemas so
instalados.
E3 Manual do Usurio
Introduo 15
Viewer executado na Maquina 8ervidora e Acessado via
Terminal 8ervice


Veja que ambos os casos, o E3 Viewer continua sendo a interface de operao e
visualizao, sendo que 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. Alm do
carter genrico do Terminal Service, o modo como a transferncia de dados entre o
cliente e o servidor implementada. Como o E3 Viewer est sendo executado
diretamente na estao cliente, existe um maior trfego inicial para o download de
telas e objetos, que 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 de 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 as limitaes de exibir somente 256 cores e que aumenta
consideravelmente o trfego quando existem muitas animaes ou efeitos de pisca-
pisca 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 sua aplicao, sendo que para utilizar o RDP com
mltiplos usurios, necessrio uma licena de Windows 2000 ou 2003 Server
licenciada corretamente, alm do mesmo nmero de Viewers disponveis no
Servidor.
E3 Manual do Usurio
16 Introduo
1.3. Diagrama de Blocos
A arquitetura interna do E3 totalmente escalvel, com cada tarefa principal sendo
executada por um servio separado. Abaixo temos uma viso geral dos principais
blocos.

Figura 1: Diagrama dos blocos que compem o E3
Com mais detalhes, o E3 Server responsvel por criar um processo de execuo
(E3 Runtime) que vai efetivamente executar a aplicao. Dentro do Runtime
encontraremos cada servidor especfico, que expe servios que sero utilizados por
outros mdulos.
E3 Manual do Usurio
Introduo 17
1.4. Estrutura de Dominio
Cada clula composta por um E3 Server operando isoladamente ou dois E3 Server
em configurao de dual standby. Cada Viewer, de fato, se conecta a um domnio ao
invs de somente 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. Este
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 uma alta
desempenho se comparado ao Terminal Services, dependendo da aplicao. Isto
possvel porque enquanto o E3 Viewer recebe e envia apenas valores e dados em
tempo real, um cliente dos Terminal Services envia mensagens de teclado e
movimentos de mouse e recebe imagens, o que gera um trfego muito maior de
informaes. Um Viewer conectado a um domnio isolado pode obter informaes
residentes somente dentro do servidor ativo, de acordo com os direitos de acesso do
usurio.
1.5. Pacotes Disponiveis
Os pacotes disponveis do E3 so os seguintes:
1.5.1. E3 8tudio
Pacote de Configurao, sem limitaes de nmero de pontos de comunicao.
Permite executar o domnio durante 6 horas e possui uma licena de visualizao
(E3 Viewer) para efeitos de teste nos projetos que esto sendo desenvolvidos.
E3 Manual do Usurio
18 Introduo
1.5.2. 8ervidores E3
O servidor E3 (E3 Server) pode ser adquirido em verses com 100, 300, 1500, 5000
e ilimitados pontos de I/O*, e j inclui uma licena de E3 Viewer. Alm disso, na
mesma cpia podem ser includas licenas do E3 Studio (verses Master) e licenas
adicionais do E3 Viewer, permitindo que mais usurios possam operar o sistema
simultaneamente. O controle das licenas do E3 Viewer fica no E3 Server, de modo
que no necessrio utilizar nenhum dispositivo de proteo nas mquinas rodando
o E3 Viewer, somente na mquina rodando o E3 Server.
1.5.3. 8ervidores E3 Back-End
Os servidores do E3 podem ser fornecidos tambm como Back-End de Dados
(sem licena de Viewer) tambm em verses de 100, 300, 1500, 5000 e ilimitados
pontos de I/O*, atuando como fontes de dados para outros servidores E3, que por
sua vez roteiam as informaes para os Viewers, no importando onde esto
conectados. Podem tambm ser oferecidos com licenas de E3 Studio includas
(licenas Master).
1.5.4. 8ervidores Hot-8tandby
Tanto os servidores E3 normais como os Back-End possuem licenas especficas
para utilizao em arquiteturas redundantes ou Hot-StandBy. Estas licenas possuem
um controle especfico e so um espelho da configurao principal, incluindo o
nmero de pontos de I/O*, licenas de E3 Viewer, drivers e add-ons.
1.5.5. Demonstrao
Sem a utilizao de uma licena, o E3 pode ser executado em modo de
demonstrao, til para avaliao do software. Neste caso, o E3 Studio tem a
limitao de no salvar uma pasta de drivers com mais de 20 tags, e de permitir o
uso somente da primeira figura de cada categoria da biblioteca de smbolos. No E3
Server, disponibilizada uma licena de driver e permitida a execuo do domnio
por at 2 horas. Alm disso, as opes de configurao de Hot-Standby e execuo
como servio ficam desabilitadas.
* Pontos internos do E3 e outras estruturas de objetos no fazem parte da contagem
de pontos de I/O.


E3 Studio 19

O E3 Studio o ambiente de desenvolvimento no 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 abaixo.

Figura 3: cone do E3
A hardkey dever estar conectada em sua porta paralela, 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.
Capitulo
2
2. E3 8tudio
E3 Manual do Usurio
20 E3 Studio
2.1. niciando um pro]eto
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 no janela Iniciar o E3 Studio
OPO DESCRIO
!niciar o E3 Studio No ser aberto nenhum projeto.
Criar um novo projeto Sero requisitados o nome e caminho do novo
projeto.
Abrir um projeto existente Ao clicar em Outros Arquivos... tem-se a opo
de localizar um projeto num diretrio especfico, ou
escolher na lista um dos ltimos aplicativos editados.

E3 Manual do Usurio
E3 Studio 21
2.2. Area de Trabalho
O E3 Studio j vem com uma srie de Menus e 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 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
Barra de Ferramentas, mas sua aparncia permanece a mesma.
A figura abaixo mostra a aparncia do E3 Studio aps a criao de um novo projeto.

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.
E3 Manual do Usurio
22 E3 Studio
2.3. Configurao do 8tudio
O E3 permite personalizar alguns recursos do Studio, tais como Barra de
Ferramentas, teclado, menus, mouse, etc.
2.3.1. Aparncia do 8tudio
Para personalizar a aparncia do Studio, necessrio acessar o Menu Visualizar
Personalizar. As opes disponveis deste item so as seguintes:
Aba Comandos: Atravs desta opo, podemos 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.

Figura 6: Aba Comandos

As opes disponveis so as seguintes:
Opes disponveis na aba Comandos
OPO DESCRIO
Categorias Mostra as opes dos menus e barras de ferramentas disponveis no
sistema.
Comandos Mostra os itens que compem o menu ou Barra de Ferramentas
selecionada.
Descriao Breve descrio da opo selecionada.

E3 Manual do Usurio
E3 Studio 23
Aba Barra de Ferramentas: Atravs desta opo, podemos configurar, editar ou
criar novas Barras de Ferramentas.

Figura 7: Aba Barra de Ferramentas
As opes disponveis so as seguintes:
Opes disponveis na aba Barra de Ferramentas
OPO DESCRIO
Barra de Ferramentas Lista as opes de barras de ferramentas disponveis
no sistema.
Botao [Repor| Repe a barra de ferramenta desejada no E3.
Botao [Repor tudo| Repe todas as Barra de Ferramentas no E3
Botao [Nova...| Cria uma nova Barra de Ferramentas.
Botao [Nudar o nome| Muda o nome da barra de ferramenta. Esta opo
utilizada somente na barra de ferramenta criada pelo
usurio atravs do boto [Nova...].
Botao [Eliminar| Elimina a barra de ferramenta selecionada.
Nostrar Legenda Mostra legenda nas opes da Barra de Ferramentas
selecionada.

Aba Nenu: Atravs desta opo, possvel configurar os menus do E3.
E3 Manual do Usurio
24 E3 Studio

Figura 8: Aba Menus
As opes disponveis so as seguintes:
Opes disponveis na aba Menus
OPO DESCRIO
Nostra menus para Exibe o menu pr-definido da aplicao. Esta opo
no tem efeito, e mantida no E3 por motivos de
compatibilidade do sistema.
Botao [Repor| Repe o menu definido na opo anterior. Esta opo
no tem efeito, e mantida no E3 por motivos de
compatibilidade do sistema.
Animaao dos menus Seleciona o tipo de animao usada nos menus:
Nenhuma (padro), Desdobrar, Deslizar e Fade.
Nenus com sombra Define se o menu apresentar o efeito de sombreado
ou no.

Aba Aparncia: Atravs desta opo, possvel alterar a aparncia das janelas e
barras de ferramentas no E3 Studio.
E3 Manual do Usurio
E3 Studio 25

Figura 9: Aba Aparncia
As opes disponveis so as seguintes:
Opes disponveis na aba Aparncia
OPO DESCRIO
Office XP Configura a aparncia do E3 Studio como Office XP.
Windows XP Configura a aparncia do E3 Studio como Windows XP
(no disponvel no estilo Windows Clssico).
Office 2000 Configura a aparncia do E3 Studio como Office 2000.
Office 2003 Configura a aparncia do E3 Studio como Office 2003.
vS.Net 2005 Configura a aparncia do E3 Studio como VS.Net 2005.

E3 Manual do Usurio
26 E3 Studio
Aba Opoes: Atravs desta opo possvel configurar as especificaes gerais do
projeto. Neste item, possvel habilitar ou desabilitar as opes da Barra de
Ferramentas.

Figura 10: Aba Opes
As opes disponveis so as seguintes:
Opes disponveis na aba Opes
OPO DESCRIO
Nostrar descrioes Habilita o E3 a mostrar uma breve descrio nas
opes das barras de ferramentas e menus quando o
mouse passa por cima do item.
!ncluir teclas de atalho Mostra ou no a tecla de atalho na descrio do boto.
cones grandes Habilita cones grandes nas barras de ferramentas.

E3 Manual do Usurio
E3 Studio 27
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 FerramentasOpes, onde se tem acesso janela
de configuraes abaixo:
Aba Editor: Este item destinado configurao do Editor de Scripts do E3:

Figura 11: Configuraes do Editor de Scripts
As opes disponveis deste item so as seguintes:
E3 Manual do Usurio
28 E3 Studio
Opes disponveis na aba Editor
OPO DESCRIO
Abrir-e-Fechar blocos do
texto
Permite ocultar os blocos de cdigo no script.
Tamanho da margem Tamanho da margem da marcao do bloco de
cdigo.
Numeraao da linha Habilita a numerao de linha no editor de scripts.
Tamanho da margem Tamanho da margem que contm a numerao de
linha.
Tamanho do Tab Determina o tamanho do Tab.
Fonte Determina o tipo de fonte a ser usado no editor de
scripts.
Tamanho Determina o tamanho de fonte a ser usado no
editor de scripts.
Nota: Feche os editores de scripts abertos para que as modificaes sejam aplicadas.
Arquivos: Habilita/desabilita a opo Ignorar verificao de CRC.

Figura 12: Configuraes de Arquivos
Toda a vez que um projeto ou 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 esta verificao falhe (ou seja, o CRC no confira os
dados), a carga do arquivo abortada, indicando uma corrupo dos dados do
E3 Manual do Usurio
E3 Studio 29
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 esta 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 este procedimento no sero perdidas as configuraes desses arquivos.
E3 Manual do Usurio
30 E3 Studio
2.3.3. Barra de Execuo do Pro]eto
A Barra de Execuo do projeto, localizada no System Tray do Windows (canto
inferior direito da tela, ao lado do relgio do sistema) utilizada para determinar as
aes que esto ocorrendo no projeto. Assim possvel verificar se o projeto est em
andamento ou se est parado, alm de outras opes que sero listadas abaixo:

Figura 13: Barra de execuo do projeto
Dominio: Atravs desta opo, possvel executar ou fechar o domnio. Para
configurar as opes deste domnio, utilize o item Opes.
Licenas: Atravs desta opo possvel visualizar todas as licenas disponveis do
sistema e do projeto em andamento. Tal recurso disponibilizar informaes sobre o
programa em execuo, o computador que est utilizando-o, usurio, o tempo de
execuo, etc.
Nonitor: Esta opo mostra informaes em tempo real sobre o estado dos
servidores do domnio.
Avanado: Habilita/Desabilita executar o E3 Server como servio.
Maiores informaes sobre configuraes de Domnio podem ser encontradas no
captulo Domnios.
2.4. Barra de Ferramentas
A Barra de Ferramentas do E3 muda conforme existncia de uma aplicao aberta
ou no. Os botes da Barra de Ferramentas permitem que voc execute determinadas
tarefas rapidamente, sem usar os menus. Desta forma, voc pode 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:
E3 Manual do Usurio
E3 Studio 31
Opes disponveis na barra de ferramentas Padro
ICONE COMANDO AO

Novo
Cria um novo projeto.

Abrir projeto
Abre um projeto existente.

Salvar
Salva o projeto.

Salvar tudo
Salva todo o domnio.

Recortar
Remove a informao selecionada e a
transporta para rea de transferncia.
Copiar
Copia a informao selecionada e a
transporta para rea de transferncia.
Colar
Cola a informao selecionada da rea de
transferncia.

Desfazer
Desfaz a ltima ao executada.
Refazer
Refaz a ltima ao desfeita pelo item
Desfazer.

Organizer
Mostra/esconde Organizer.

Lista de Propriedades
Mostra/esconde Lista de Propriedades.

Gallery
Mostra/esconde Gallery.
Executar aplicativo
Salva tudo, executa o domnio e abre o
Viewer.

RodarfParar dominio
Executa/pra o domnio corrente.

ExecutarfParar E3
viewer
Executa/pra o E3 Viewer.

verificar dominio
Verifica se o domnio contm erros.

Erro anterior
Mostra o erro anterior encontrado no
domnio.
Prximo erro
Mostra o prximo erro encontrado no
domnio.

Sobre
Habilita a Ajuda do sistema.

Desfragmentar
arquivos
Desfragmenta o arquivo especificado.
ProcurarfSubstituir
Procura todas as ocorrncias de um
determinado texto por todo o domnio.

Documentaao de
scripts
Gera documentao dos scripts.
Relatrio de versoes
Mostra as verses dos projetos e
bibliotecas.

WatchWindow
Mostra os valores de tags e propriedades
no Studio em runtime.
Opes disponveis na barra de ferramentas Sombra
E3 Manual do Usurio
32 E3 Studio
ICONE COMANDO AO

Sombra do objeto
Aplica sombra no objeto.

Sombra acima
Desloca a sombra para cima do
objeto
Sombra abaixo
Desloca a sombra para baixo do
objeto.
Sombra a esquerda
Desloca a sombra para a esquerda
do objeto.

Sombra a direita
Desloca a sombra para a direita do
objeto.

Cor da sombra
Seleciona a cor da sombra.
Opes disponveis na barra de ferramentas Objetos
ICONE COMANDO AO

E3Alarm
Insere um objeto E3Alarm.

E3Browser
Insere um objeto E3Browser.

E3Chart
Insere um objeto E3Chart.

Caixa de Seleao
Insere um objeto Caixa de Seleo
(CheckBox).

Botao de Opao
Insere um objeto Boto de Opo
(OptionButton).

Lista de Seleao
Insere um objeto Lista de Seleo
(ComboBox).

Botao de Comando
Insere um objeto Boto de Comando
(CommandButton).

Texto
Insere um objeto Texto (Label).

Lista
Insere um objeto Lista (ListBox).

Barra de Rolagem
Insere um objeto Barra de Rolagem
(ScrollBar).

Botao !ncremento-
Decremento
Insere um objeto Boto Incremento-
Decremento (SpinButton).

Editor de Texto
Insere um objeto Editor de Texto
(TextBox).

Botao Liga-Desliga
Insere um objeto Boto Liga-Desliga
(ToggleButton).


Opes disponveis na barra de ferramentas Tela
E3 Manual do Usurio
E3 Studio 33
ICONE COMANDO AO

Selecionar
Habilita modo de seleo.

Rotacionar
Habilita modo de rotao.

Ordem dos tabs
Mostra o identificador de ordem de
navegao entre os objetos.

Linha
Insere objeto do tipo linha.

Retangulo
Insere objeto do tipo retngulo.

Retangulo
arredondado
Insere objeto do tipo retngulo
arredondado.

Elipse
Insere objeto do tipo elipse.

Arco de elipse
Insere objeto do tipo arco de elipse.

Desenho livre
Insere ferramenta de desenho livre.

Poligono
Insere objeto do tipo polgono.

Poligono de curvas
Insere objeto do tipo polgono de curvas.

Figura
Insere objeto do tipo Imagem.

Texto
Insere objeto do tipo Texto.

Display
Insere objeto do tipo Display.

SetPoint
Insere objeto do tipo SetPoint.

Escala
Insere objeto do tipo Escala.

Agrupar
Agrupa uma seleo de objetos.

Desagrupar
Desagrupa uma seleo de objetos.

Animar com
translaao
Insere ferramenta para movimentos
lineares.

Animar com rotaao
Insere ferramenta para rotao.

Trazer para frente
Traz objeto para frente em um
agrupamento.
Enviar para tras
Envia objeto para trs em um
agrupamento.

Avanar
Insere objeto acima.

Recuar
Insere objeto abaixo.

Zoom
Permite editar o nvel de zoom da Tela.

Camadas
Permite editar as camadas de objetos na
Tela.

Opes disponveis na barra de ferramentas Desenho
E3 Manual do Usurio
34 E3 Studio
ICONE COMANDO AO

Cor do fundo
Define a cor do fundo do objeto.

Cor da frente
Define a cor da frente do objeto.

Cor da borda
Define a cor da borda do objeto.

Estilo da borda
Define o estilo da borda do objeto.

Espessura da linha
Define a espessura da linha do
objeto.

Estilo do preenchimento
Define o estilo do preenchimento
do objeto.

Opes disponveis na barra de ferramentas Alinhamento
ICONE COMANDO AO

Alinhar a esquerda
Alinha objetos esquerda.

Alinhar a direita
Alinha objetos direita.

Alinhamento superior
Alinha objetos acima.

Alinhamento inferior
Alinha objetos abaixo.

Nesma largura
Aplica a mesma largura entre
objetos.
Nesma altura
Aplica a mesma altura entre
objetos.
Nesmo tamanho
Aplica mesmo tamanho aos objetos
selecionados.

Centralizar
horizontalmente
Centraliza objetos horizontalmente.

Centralizar verticalmente
Centraliza objetos verticalmente.
Distribui horizontalmente
Formata espaamento entre objetos
na horizontal.

Distribuir verticalmente
Formata espaamento entre objetos
na vertical.

Grade
Mostra/esconde grade.

E3 Manual do Usurio
E3 Studio 35
Opes disponveis na barra de ferramentas Formatao
ICONE COMANDO AO

Fonte
Determina a fonte do texto.

Tamanho da fonte
Determina o tamanho da fonte.

Cor da fonte
Determina a cor da fonte.

Fonte em negrito
Insere fonte em negrito.

Fonte em italico
Insere fonte em itlico.

Fonte sublinhada
Insere fonte sublinhada.

Texto a esquerda
Formata texto esquerda.

Texto centralizado
Centraliza texto.

Texto a direita
Formata texto direita.

2.4.1. Verificar dominio
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.

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.
E3 Manual do Usurio
36 E3 Studio

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 FerramentasVerificar 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/8ubstituir
A ferramenta Procurar busca no domnio (inteiro ou em parte), por ocorrncias de
um determinado texto. No final da busca, apresentado ao usurio uma lista de
resultados, indicando o objeto onde a ocorrncia foi encontrada, a localizao dentro
deste objeto (se uma propriedade, associao, etc.), e o texto que contm a
ocorrncia.
A ferramenta Substituir substitui as ocorrncias encontradas por outro texto
especificado.

Figura 16: Procurar/Substituir
E3 Manual do Usurio
E3 Studio 37
Existem trs maneiras de se realizar a procura e substituio:
Escolha um item no Organizer, clique com o boto direito do mouse
sobre ele, e selecione a opo Procurar/Substituir. Esta procura feita a
partir do item, seguindo a hierarquia (apenas objetos-filhos sero
pesquisados).
Clique no menu principal do E3 Studio em Ferramentas
Procurar/Substituir. Esta procura feita em todos os projetos e
bibliotecas abertos.
Clique 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
Procurar por Contm o texto a ser procurado.
Botao [Procurar| Inicia a busca pelo texto.
Apenas nos resultados Refaz a pesquisa apenas entre os resultados da pesquisa
anterior.
Diferenciar maiusculas
de minusculas
Procura pelo texto exatamente como foi escrito,
diferenciando maisculas de minsculas.
Palavras inteiras Procura o texto especificado como uma palavra inteira.
No considera o texto como substring de outro.
Substituir por Contm o texto a ser utilizado na substituio.
Botao [Substituir| Inicia o processo de substituio.
Uma a uma Faz a substituio da linha selecionada e seleciona a
prxima linha vlida.
Todas Substitui, de uma s vez, todas as ocorrncias do texto.
Apenas as selecionadas Substitui, de uma s vez, todas as ocorrncias marcadas
na lista de resultados.
Botao
Mostra/esconde as opes de pesquisa e substituio.
Botao
Seleciona na lista de resultados a ocorrncia anterior.
Botao
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.
E3 Manual do Usurio
38 E3 Studio
2.4.3. Documentao de 8cripts
A ferramenta Documentao de Scripts serve para auxiliar o usurio na
organizao e documentao dos scripts da aplicao.
Esta 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. Este assistente responsvel por guiar o usurio na
configurao do arquivo de documentao de scripts.

Figura 17: Assistente de documentao de scripts

E3 Manual do Usurio
E3 Studio 39
Arquivo de documentao
Na janela Arquivo de documentao, so definidas as informaes referentes ao do
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.
Filtro
Na janela Filtro, possvel selecionar os objetos cujos scripts sero documentados.
Habilite a opo Apenas nos objetos selecionados para indicar somente os
objetos cujos scripts voc deseja documentar, ou habilite a opo Todos os objetos
do E3, para documentar os scripts de todos os tipos de objeto do E3.
Pastas, projetos e bibliotecas no aparecem na lista por no possurem scripts. A lista
de objetos contm apenas os objetos que podem ser filhos de projetos ou
bibliotecas, como Telas, Drivers, XControls, etc.
E3 Manual do Usurio
40 E3 Studio

Figura 19: Filtro de objetos
Clique no boto [Avanar] para ir prxima janela.

Detalhamento do arquivo
A janela Detalhamento do arquivo permite que voc 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 Manual do Usurio
E3 Studio 41

Figura 20: 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-
texto, o 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 tivermos os seguintes objetos:
TelaInicial
CommandButton1
Tela1
CommandButton1
Ambos os scripts (considerando um mesmo evento - Click) seriam
CommandButton1_Click(). Assim, a gravao no arquivo fica:
<TelaInicial.CommandButton1:CommandButton1_Click()>
E3 Manual do Usurio
42 E3 Studio
Sub CommandButton1_Click()
...
End Sub
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 21: Separador de scripts
Voc pode 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,
E3 Manual do Usurio
E3 Studio 43
voc pode 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 voc selecionar a opo Repetir at o final da linha, os caracteres informados
sero repetidos at o limite de tamanho da linha, que de 80 caracteres. Voc
tambm pode utilizar mais de uma linha como separador, seja ela em branco ou
personalizada. Basta informar um nmero, limitado 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 sistema mostrar uma mensagem indicando a finalizao da
configurao e gerao do arquivo que contm a documentao dos scripts.

Figura 22: 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.
E3 Manual do Usurio
44 E3 Studio
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 um 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 bibliotecas abertos, pertencentes ou no ao domnio. Para acessar esta
ferramenta, basta clicar no boto Relatrio de verses da Barra de Ferramentas
Padro, que a caixa de dilogo abaixo ser mostrada.

Figura 23: Relatrio de verses
As opes mostradas nesta caixa de dilogo so as seguintes:

E3 Manual do Usurio
E3 Studio 45
Opes disponveis na caixa de dilogo Relatrio de verses
OPO DESCRIO
ProjetofBiblioteca Nome do projeto ou biblioteca abertos.
versao Indica a verso do projeto ou biblioteca. Esta verso gerada
internamente pelo E3, sendo incrementada toda a vez que o
projeto salvo, manual ou automaticamente. No caso de
projetos ou bibliotecas protegidas, se a verso no puder ser
salva, tambm no ser possvel sua incrementao. No
entanto, se o usurio tiver permisso para abrir e alterar o
projeto ou biblioteca, a verso ser incrementada
normalmente.
Comentario Mostra o comentrio relacionado ao projeto. Este comentrio
pode ser editado atravs da propriedade DocString. No caso
das bibliotecas, este campo fica em branco.

NOTA: Estes campos so apenas de visualizao, no sendo permitida edio.
2.4.5. WatchWindow
A ferramenta WatchWindow permite a visualizao do valor corrente de qualquer
propriedade ou tag em tempo de execuo no Studio. Para acessar esta ferramenta,
deve-se clicar no boto WatchWindow da Barra de Ferramentas Padro ou
acessar o menu FerramentasWatchWindow, que a caixa de dilogo abaixo ser
mostrada:

Figura 24: WatchWindow
E3 Manual do Usurio
46 E3 Studio
A caixa de dilogo apresenta as seguintes opes:
Opes disponveis na caixa de dilogo WatchWindow
OPO DESCRIO
Botao [Adicionar...| Abre o DomainBrowser (um AppBrowser com os objetos
criados no servidor) e seleciona o objeto que ser mostrado
na janela do WatchWindow.
Botao [Remover| Remove a linha selecionada da lista de objetos do
WatchWindow.
Botao [Atualizar| Busca toda a rvore de filhos dos objetos selecionados
atualmente pelo WatchWindow.
Botao [Conectar| Tenta reativar a conexo perdida com o domnio para que a
visualizao seja possvel.
Nome Indica o tag ou propriedade sendo visualizada.
Qualidade Indica a qualidade do tag ou propriedade.
Estampa de tempo Indica a estampa de tempo do tag ou propriedade.
valor Indica o valor do tag ou propriedade, em tempo de
execuo.
Status Indica se o domnio est conectado ou desconectado.
E3 Manual do Usurio
E3 Studio 47
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.

Figura 25: Organizer
No Organizer, tem-se a viso de todos os projetos que esto abertos para edio
(pertencentes ou no ao domnio corrente). Sua estrutura pode ser comparada
rvore de diretrios do Windows Explorer. Desta forma, sua estrutura comea por
um projeto ou biblioteca, e seus objetos-filho seguem abaixo.
Por sua vez, cada objeto pode conter itens filhos, que podem ser visualizados atravs
da expanso de seus elementos. Ao navegar pela estrutura da aplicao, vrias
opes sero apresentadas para edio dos objetos, seja atravs do uso do boto
esquerdo ou direito do mouse.
Ao clicar em um objeto com o boto esquerdo, suas propriedades podero ser
visualizadas e editadas atravs da Lista de Propriedades, se esta estiver habilitada.
Clicando com o boto direito do mouse sobre o nome do projeto, no Organizer, as
seguintes opes so disponibilizadas:
E3 Manual do Usurio
48 E3 Studio
2.5.1. Fechar
Fecha o projeto corrente.
2.5.2. Atualizar
Atualiza as configuraes do projeto.
2.5.3. 8alvar Como
Abre uma caixa de dilogo para que o projeto seja salvo no local indicado.
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 Salvar como.
Especifique o nome do projeto e clique no boto [Salvar].

Figura 26: Salvando o projeto
E3 Manual do Usurio
E3 Studio 49
2.5.4. Desfragmentar
Desfragmenta arquivos (.lib ou .prj), isto , faz com que os espaos que so criados
desnecessariamente (excluso de itens do sistema, importao de arquivos, incluso
de recursos, etc.) sejam retirados, dando dinamismo ao sistema.
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 Desfragmentar.
Aps a desfragmentao do arquivo, o sistema mostrar uma caixa de
mensagem com o resultado da ao, conforme figura abaixo:

Figura 27: Desfragmentao
2.5.5. Proteo
Protege o contedo de um arquivo .prj ou .lib contra a edio, visualizao ou
execuo no-autorizada.
Maiores informaes sobre esta opo no captulo Segurana.
2.5.6. Nova Pasta
Cria uma nova pasta no sistema. A pasta funciona como uma diviso lgica para o
projeto, facilitando a visualizao de sistemas de grande porte.
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 Nova Pasta.
Especifique o nome da nova pasta e pressione a tecla [Enter].
2.5.7. nserir
Atravs deste recurso possvel inserir no projeto os objetos disponveis E3.
E3 Manual do Usurio
50 E3 Studio
2.5.8. nserir Recurso
Atravs desta opo, possvel inserir no projeto os diversos mdulos disponveis e
registrados. Isso porque cada projeto pode conter somente as funcionalidades
desejadas pelo usurio ou que estiverem disponveis naquela mquina, evitando
eventuais overheads de processamento. Alm disso, permite que novos mdulos
sejam desenvolvidos e adicionados dinamicamente.
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 Inserir Recurso. O E3 ir abrir uma caixa
de dilogo, conforme figura abaixo:

Figura 28: Inserindo um recurso no E3
Selecione o recurso que deseja inserir no projeto e clique no Boto [Abrir].
2.5.9. Habilitar/Desabilitar pro]eto
Habilita ou desabilita o projeto selecionado.
Para utilizar este recurso, siga estes procedimentos:
Clique com o boto direito do mouse sobre o nome do projeto que deseja
desabilitar no Organizer e selecione a opo Desabilitar projeto.
E3 Manual do Usurio
E3 Studio 51
Observe que o nome e cone do projeto aparecero na cor cinza, indicando
que o projeto est desabilitado.
Para habilitar o projeto novamente, clique com o boto direito do mouse
sobre o mesmo e escolha a opo Habilitar projeto.
2.5.10. Verificar pro]eto
Verifica os erros ocorridos somente no objeto selecionado e em seus filhos.
Maiores informaes sobre esta opo na subseo Verificar Domnio.
2.5.11. Adicionar/Remover do Dominio
Adiciona ou remove o projeto do Domnio.
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 Remover do domnio.
Para adicionar o projeto ao domnio, clique com o boto direito do mouse
sobre o nome do projeto no Organizer e selecione a opo Adicionar ao
domnio.
2.5.12. Procurar/8ubstituir
Busca por trechos de texto no projeto e os substitui por outros, se for o caso.
Maiores informaes sobre esta opo na subseo Procurar/Substituir.
2.5.13. mportar/Exportar
Auxilia o usurio na importao e exportao de objetos, associaes e colees.
Maiores informaes sobre esta opo na seo Importao e Exportao.
E3 Manual do Usurio
52 E3 Studio
2.5.14. Documentar scripts
Auxilia o usurio na organizao e documentao dos scripts da aplicao.
Maiores informaes sobre esta opo na subseo Documentao de Scripts.
2.5.15. Editar Associaes
Muda uma ou mais associaes feitas na aplicao de forma mais rpida que pela
janela tradicional.
Maiores informaes sobre esta opo no captulo Associaes.
2.5.16. Copiar/Colar Associaes
Copia/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 mais de um objeto estiver selecionado, estas opes estaro desabilitadas. 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.
2.5.17. Propriedades
Abre a Janela de Propriedades do objeto. Quando esta opo chamada pelo
menu, a primeira aba aberta ser a de configuraes do objeto.
Mais informaes sobre esta opo nos respectivos captulos dos objetos.
2.6. mportao 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.
E3 Manual do Usurio
E3 Studio 53
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/Exportar qualquer propriedade de qualquer tipo de objeto do E3;
Importar/Exportar qualquer tipo de associao de objetos do E3;
Exportar qualquer tipo de item de coleo de objetos do E3 e importar
suas propriedades.
Qualquer objeto do E3 poder ser importado ou exportado. O objeto selecionado
para a operao chamado de objeto-raiz. Com isso, possvel importar ou
exportar, por exemplo, uma pasta de dados com XObjects definidos pelo usurio, ou
mesmo exportar uma Tela, listando todos os objetos-filhos.

Alm dos objetos, as associaes e as colees tambm podem ser importadas e
exportadas. O usurio tem a opo de informar se quer importar/exportar
associaes e colees ou no.
2.6.1. Arquivo C8V
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/exportado. Esta coluna chama-se
ObjectType. O valor desta coluna o nome da classe do objeto
(XObject1, DrawRect, InternalTag, AgSimple, etc.), com exceo das
colees, que apresentam palavras-chave pr-definidas (ITableBindRow,
IAxis, etc.);
O cabealho das demais colunas deve ser o prprio nome da propriedade
em questo;
E3 Manual do Usurio
54 E3 Studio
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 de um bloco de notas, Excel
ou 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 [].
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 abaixo :

Figura 29: Arquivo CSV visualizado no Excel
Salve a planilha com a extenso CSV;
Feche o arquivo no Excel;
E3 Manual do Usurio
E3 Studio 55
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. 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 seguem o seguinte formato:
Linhas iniciadas por ; 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 =. 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 palavras-
chave utilizadas no arquivo CSV e associadas a propriedades ou classes de objetos
no arquivo INI.
No E3, os modelos da ferramenta de importao e exportao esto definidos com as
seguintes sees e variveis:
E3 Manual do Usurio
56 E3 Studio
Sees definidas para os Modelos
SEO DESCRIO
Header (*) Define os identificadores permitidos para nomes de colunas e
tipos de dados. Nesta seo devero ser definidas as variveis
header e types.
(*) Seo obrigatria para a exportao.
Configuration Define configuraes adicionais para a ferramenta de importao
e exportao. Nesta seo devero ser definidas as variveis
separator, root, link, collection, objectduplicated e
bindduplicated.
Types 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 nesta seo, sendo criada uma varivel para cada
um dos identificadores.
Columns 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 nesta seo, sendo criada uma varivel para cada
um dos identificadores.
Filter 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
SEO DESCRIO
header (*) Define a ordem das colunas e os identificadores que sero
utilizados. Devem ser listadas todas as colunas que o arquivo
CSV ter, separadas por vrgulas. Cada identificador que no
for igual a um nome de propriedade dever ser discriminado
na seo Columns, cada um com uma varivel.
(*) Varivel obrigatria para a exportao.
types Define os identificadores para os tipos de dados permitidos no
arquivo CSV. Os identificadores devero ser listados nesta
varivel separados por vrgulas. S necessrio definir essa
varivel se algum identificador for diferente do nome da classe
do objeto. Neste caso, para cada um dever haver tambm
uma varivel na seo Types.
separator Define o separador que ser utilizado para delimitar as colunas
no arquivo CSV. Caso esta varivel no seja definida, ser
utilizado o separador de listas configurado no Windows.
root Define se o objeto-raiz ser exportado ou importado junto com
os objetos-filhos. Caso esta varivel no seja definida, o
objeto-raiz no ser utilizado.
link Define se as associaes dos objetos sero exportadas ou
importadas. Caso esta varivel no seja definida, as
E3 Manual do Usurio
E3 Studio 57
associaes no so utilizadas.
collection Define se as colees dos objetos sero exportadas ou
importadas. Caso esta varivel no seja definida, as colees
no so utilizadas.
objectduplicated 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 esta varivel no
seja definida, assumido o valor askalways. Esta opo no
tem valor na exportao.
bindduplicated 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 esta varivel no
seja definida, assumido o valor askalways. Esta opo no
tem valor na exportao, nem tampouco possui o valor
createalways; caso este seja atribudo, ser automaticamente
modificado para askalways.
include 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 nesta
varivel ser exportado/importado.
exclude 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 nesta
varivel ser desconsiderado na importao/exportao.

NOTA: O caractere ; 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 o ; definir um comentrio no arquivo ini. Desta forma,
a varivel criada na seo Columns ou na seo Types para definir o identificador
que possui o ; no pode ser lida corretamente.

E3 Manual do Usurio
58 E3 Studio
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

[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.
2.6.3. 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, clique 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:
E3 Manual do Usurio
E3 Studio 59
Aba Configuraoes: Atravs desta opo, o usurio pode configurar as opes
vlidas tanto para a importao quanto para a exportao.

Figura 30: Aba Configuraes

E3 Manual do Usurio
60 E3 Studio
As opes disponveis so as seguintes:
Opes disponveis na aba Configuraes
OPO DESCRIO
Separador de
colunas
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).
Outras opoes Define o que ser importado/exportado: objetos,
associaes ou colees. As opes disponveis so:
Importar/exportar o objeto-raiz, Importar/exportar
associaes e Importar/exportar colees.
Salvar modelo 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 este arquivo
poder ser reutilizado. Quando for desmarcada, as
configuraes feitas sero salvas temporariamente em um
arquivo na pasta de arquivos temporrios do Windows.
Este arquivo ser utilizado para a importao ou exportao
realizada logo aps a configurao, e ser removido depois
disto.

E3 Manual do Usurio
E3 Studio 61
Aba !mportaao: Atravs desta opo, o usurio pode configurar as opes vlidas
somente para a importao.

Figura 31: Aba Importao

E3 Manual do Usurio
62 E3 Studio
As opes disponveis so as seguintes:
Opes disponveis na aba Importao
OPO DESCRIO
!mportaao de
objetos duplicados
Especifica como o sistema deve lidar com a ocorrncia de
objetos duplicados na importao. As opes disponveis
so: Questionar sobre o que fazer em cada caso, Sempre
sobrescrever o objeto existente, Sempre ignorar o
objeto duplicado e Sempre criar um novo objeto.
!mportaao de
associaoes
duplicadas
Especifica como o sistema deve lidar com a ocorrncia de
associaes duplicadas na importao. As opes
disponveis so: Questionar sobre o que fazer em cada
caso, Sempre sobrescrever a associao existente e
Sempre ignorar a associao duplicada.

Aba Filtros: Atravs desta opo, o usurio pode escolher quais as classes que sero
utilizadas na importao/exportao, ou quais classes no deseja utilizar.

Figura 32: Aba Filtros
E3 Manual do Usurio
E3 Studio 63

As opes disponveis so as seguintes:
Opes disponveis na aba Filtros
OPO DESCRIO
Nao filtrar objetos Define a importao/exportao de todos os objetos.
!ncluir apenas
estes objetos
Define quais classes de objetos sero importadas/exportadas.
Excluir apenas
estes objetos
Define quais classes de objetos no sero
importadas/exportadas.
Botao [Alterar...| Abre uma janela para seleo das classes de objetos a serem
includas/excludas.
Botao
Abre uma janela de ajuda para a opo.

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

Figura 33: 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 .
E3 Manual do Usurio
64 E3 Studio

Aba !dentificadores: Atravs desta opo, o usurio define os identificadores para
as classes de objetos escolhidas. O estado inicial desta lista vazio.

Figura 34: Aba Identificadores

E3 Manual do Usurio
E3 Studio 65
As opes disponveis so as seguintes:
Opes disponveis na aba Identificadores
OPO DESCRIO
Nome da classe Indica o nome da classe selecionada na opo.
!dentificador 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 case-sensitive (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.
Botao
Adiciona classes de objetos.
Botao
Remove a classe de objetos selecionada.
Botao
Apresenta uma janela com texto de ajuda.


E3 Manual do Usurio
66 E3 Studio
Aba Propriedades: Atravs desta opo, o usurio escolhe quais as propriedades
dos objetos que deseja utilizar na importao/exportao. O valor inicial da lista
ObjectType; as demais propriedades devem ser adicionadas manualmente pelo
usurio.

Figura 35: Aba Propriedades

E3 Manual do Usurio
E3 Studio 67
As opes disponveis so as seguintes:
Opes disponveis na aba Propriedades
OPO DESCRIO
Nome da coluna Permite ao usurio alterar o valor a ser utilizado como nome
da coluna no cabealho do arquivo CSV. O valor inicial desta
coluna sempre o prprio nome da propriedade do objeto.
Para cada valor alterado nesta coluna, criada uma entrada no
arquivo INI na seo Columns. Os nomes das colunas no so
case-sensitive (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; neste caso, algum valor
pode ser sobrescrito.
Propriedade Indica a propriedade sendo importada/exportada.
Botoes e Redefinem a ordem das colunas ao alterar a ordem das
propriedades na lista.
Botao
Adiciona propriedades lista.
Botao
Exclui propriedades da lista, com exceo de ObjectType.
Botao
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 mais do incio da lista.
Botao
Mostra uma janela com texto de ajuda.


E3 Manual do Usurio
68 E3 Studio
Ao pressionar o boto , a seguinte janela aberta para a seleo de propriedades:

Figura 36: Seleo de Propriedades
As opes disponveis so as seguintes:
Opes disponveis na janela Propriedades
OPO DESCRIO
Classes de objetos Apresenta as classes de objetos que se enquadram no filtro
escolhido a partir do objeto-raiz.
Listar todas as
classes de objetos
do E3
Se esta opo for selecionada, a caixa de seleo de objetos
mostrar todas as classes existentes no E3, independentemente
de filtro ou objeto-raiz.
Propriedades Mostra as propriedades do objeto selecionado.

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 ela do
agrupamento, mantendo as outras propriedades agrupadas corretamente.
E3 Manual do Usurio
E3 Studio 69
2.6.4. mportao e exportao de ob]etos
A exportao ou importao 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 isso, siga os seguintes
procedimentos:

Clique com o boto direito do mouse sobre o objeto desejado e selecione
a opo Importar ou a opo Exportar.
Na caixa de dilogo, selecione o arquivo CSV desejado, selecione ou
configure um modelo e clique no boto [Salvar].

Figura 37: Exportao
Na exportao, gerado um arquivo CSV com uma linha para cada objeto
exportado. Se tiver sido selecionada a opo de exportar o objeto-raiz, ser gerada
uma linha a mais para este objeto, contendo suas propriedades, exceto o nome, que
permanece em branco. Nos demais casos, contm a hierarquia com nomes separados
por pontos.
Exemplo de exportao a partir de um IODriver.
E3 Manual do Usurio
70 E3 Studio

Figura 38: 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

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 essa:
ObjectType;Name
IOFolder;Pasta1
No caso especfico da importao de tags no Viewer, onde no so permitidas
pastas, se a linha no arquivo tiver um nome de Tag no formato Pasta.Nome, o tag
ser ignorado porque a pasta no ser encontrada.
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.
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.
E3 Manual do Usurio
E3 Studio 71
Importao do Elipse SCADA para o E3
O E3 aceita a importao de tags do SCADA para o seu sistema, respeitando as suas
devidas configuraes. Para utilizar este recurso, siga estes procedimentos:
No Elipse SCADA, acesse o Organizer e selecione o Driver;
Acesse a aba Lista de Tags;
Selecione os tags desejados e clique em [Exportar Tags...].

Figura 39: Exportao de Tags no SCADA
Selecione o nome do arquivo e clique em [Salvar]. O arquivo ser salvo
na extenso CSV.
Feche o Elipse SCADA e abra o E3;
No Organizer, clique com o boto direito do mouse sobre o objeto Driver
e selecione a opo Importar;
Selecione o arquivo CSV e o modelo SCADA.ini, fornecido pela Elipse,
que se encontra na pasta installpath\Templates e clique em [Abrir].
E3 Manual do Usurio
72 E3 Studio

Figura 40: Importando tags do SCADA
2.6.5. mportao e exportao de associaes
Para a exportao ou importao 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/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 (estas
devero ser diferenciadas pelas propriedades Reverse e Bidirectional);
AnalogBind: para associaes analgicas;
AnimationBind: para associaes digitais;
TableBind: para associaes por tabela.
As propriedades ou campos das associaes so importados/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 hoje para cada associao so as seguintes:
AgSimple: Reverse, Bidirectional;
AnalogBind: SrcHiValue, SrcLoValue, DstHiValue, DstLoValue;
E3 Manual do Usurio
E3 Studio 73
AnimationBind: BlinkOn, BlinkOff, OnValue, OffValue, BlinkOnValue,
BlinkOffValue.
Todas as associaes so importadas/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 41: Importao de uma associao pr-existente
No nome do objeto, deve ser informado o caminho completo, do tipo:
Objeto.Links.Name.
Exemplo:
Texto1.Links.Value (Links indica que uma associao, e Value a propriedade que
possui a associao).
2.6.6. mportao e exportao de colees
Para a exportao ou importao 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/exportadas, ou nenhuma. As colees em questo devero
SEMPRE existir no objeto. Apenas suas propriedades sero atualizadas.
As colunas de cada coleo dependem das propriedades que esta coleo possui. O
tratamento disto feito da mesma forma que as colunas das propriedades dos
objetos.
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:
!DispChartPen, para Penas do E3Chart;
E3 Manual do Usurio
74 E3 Studio
!LegendColumn, para Legendas do E3Chart;
!Axis, para Eixos do E3Chart;
!TableBindRow, para linhas das associaes por tabela.
2.6.7. 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.
O arquivo de log da importao e exportao criado sempre que houver algo a ser
gravado, na pasta ImportExport dentro de E3Logs. Se a pasta no existir, o log no
criado. O arquivo C:\E3Logs\ImportExport\ImportExport_aaaa_mm_dd.log.
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.

Figura 42: 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.
E3 Manual do Usurio
E3 Studio 75

Figura 43: 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. Gallery
Coleo de objetos grficos que podem ser arrastados e inseridos nas Telas das
aplicaes. Estes objetos so arquivos do tipo Metafiles (WMF: Windows
MetaFile).

Figura 44: Gallery
E3 Manual do Usurio
76 E3 Studio
2.9. AppBrowser
O AppBrowser uma ferramenta que auxilia o usurio a montar a aplicao
informando uma expresso lgica, uma associao ou um valor para a propriedade
sendo manipulada, de acordo com o objeto selecionado. Assim, possvel minimizar
os erros durante a criao da aplicao.

Figura 45: AppBrowser
No quadro esquerda so mostrados os objetos do E3 que podem ser utilizados para
compor o texto que ser o resultado do uso do AppBrowser. De acordo com seu
contexto de utilizao, alguns objetos no podero ser utilizados e nem sero
mostrados aqui.
No quadro 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;
E3 Manual do Usurio
E3 Studio 77
* 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 46: AppBrowser via scripts
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);
E3 Manual do Usurio
78 E3 Studio
o quarto item o Servidor; nele so listados todos os objetos do servidor
que a aplicao possui.
finalmente, 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).

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 47: AppBrowser via associaes
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.
E3 Manual do Usurio
E3 Studio 79
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 48: AppBrowser via propriedade
As propriedades que permitem o uso do AppBrowser so: DBServer dos objetos
Frmula, Histrico e E3Storage; DataSource, do objeto Servidor de Alarmes;
InitialScreen, do objeto Viewer; e SplitLink, do objeto Quadro.


Domnio 81

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:
E3 Server
O E3 Server o coordenador de todos os outros mdulos do E3. simbolizado por
no System Tray.
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 simbolizada por um cone no system tray, de acordo com a
tabela abaixo:
Opes disponveis para cones do System Tray
OPO DESCRIO

Seta verde: mostrado quando o Domnio est carregado e rodando.

Crculo cinza: mostrado quando no h Domnio rodando (por
exemplo, quando a comunicao de um Driver OPC ativada sem
que um Domnio tenha sido rodado previamente).

Linha reta amarela (giratria): mostrados 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.

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.
Capitulo
3
3. Dominios
E3 Manual do Usurio
82 Domnio
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
Studios podem modificar os mesmos arquivos ao mesmo tempo.
Viewer
O Viewer a interface com o usurio em tempo de execuo, pois mostra as Telas
em execuo e permite a operao do sistema. O 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 Viewers, pois as Telas e bitmaps so carregadas
conforme a necessidade em tempo de execuo.
3.1. Componentes do Dominio
Um Domnio constitudo dos seguintes arquivos:
DOM: Arquivo de Configurao do Domnio
O arquivo .dom armazena quatro tipos de informaes:
Opes de configurao do Domnio;
Lista de arquivos .prj e .lib que contm os Tags, Telas, definies de
objetos, etc.;
Configuraes dos servidores (micros) 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
diretrios dentro do projeto, e cada diretrio 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.
A execuo distribuda do sistema (em vrios computadores) e a capacidade de parar
seletivamente partes do aplicativo determinam a separao dos objetos em vrios
arquivos de projeto.
E3 Manual do Usurio
Domnio 83
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 Dominio
Existem duas maneiras de se criar um Domnio no E3:
Atravs do Menu ArquivoNovo Domnio. Para isso, necessrio que
ao menos um projeto ou 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.

Figura 49: Criando um novo Domnio
A seguir, o usurio deve decidir se deseja incluir projetos ou bibliotecas
abertos no novo Domnio criado.
E3 Manual do Usurio
84 Domnio

Figura 50: 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 ArquivosNovo Projeto.
Uma vez que o Assistente tenha sido acessado, a tela inicial aberta. Para continuar,
clique em [Avanar >].

E3 Manual do Usurio
Domnio 85

Figura 51: 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.
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...].

E3 Manual do Usurio
86 Domnio

Figura 52: Tela Tipo de Aplicao
Caso a pasta informada no exista, o usurio avisado, e deve decidir se deseja cri-
la.

Figura 53: 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 a
existncia de domnios ativos no sistema; clicando nesta opo, o novo projeto far
E3 Manual do Usurio
Domnio 87
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.

Figura 54: Tela Domnio
Clique no boto [Avanar >] para prosseguir.

Driver de comunicao
Nesta tela o usurio pode decidir pela incluso de um objeto Driver de Comunicao
no projeto ou biblioteca 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 [...].

E3 Manual do Usurio
88 Domnio

Figura 55: Tela Driver de Comunicao
Clique no boto [Avanar >] para prosseguir.
NOTA: esta tela no mostrada caso o usurio tenha escolhido a opo Aplicao
em branco.

Banco de Dados
Nesta tela o usurio pode decidir pela incluso de um objeto Banco de Dados no
projeto ou biblioteca 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 [...].

E3 Manual do Usurio
Domnio 89

Figura 56: Tela Banco de Dados
Clique no boto [Avanar >] para prosseguir.
NOTA: esta tela no mostrada caso o usurio tenha escolhido a opo Aplicao
em branco.

Alarmes
Nesta tela o usurio pode decidir pela incluso de um objeto Servidor de Alarmes e
de um objeto Configurao de Alarmes no projeto ou biblioteca sendo criado. A
opo Desejo guardar os dados de alarme em disco habilita o armazenamento de
informaes relativas a alarmes em disco, desde que um banco de dados tenha sido
inserido no projeto.

E3 Manual do Usurio
90 Domnio

Figura 57: Tela Alarmes
Clique no boto [Avanar >] para finalizar a criao da aplicao.
NOTA: esta tela no mostrada caso o usurio tenha escolhido a opo Aplicao
em branco.

Aps, o sistema mostra a tela final do Assistente, com uma mensagem que indica a
final do processo de criao da aplicao.

E3 Manual do Usurio
Domnio 91

Figura 58: Tela final do Assistente de Aplicaes do E3
Finalize o processo clicando no boto [Concluir].
3.3. Configuraes de Dominio
O Domnio pode ser configurado:
Atravs da Barra de Ferramentas Padro;
Atravs dos menus do E3 Studio;
Atravs dos menus de contexto;
Atravs do System Tray.
3.3.1. Configuraes de Dominio via da barra de ferramentas
Para configurar o Domnio via Barra de Ferramentas, o E3 Studio dispe de alguns
botes na Barra de Ferramentas Padro.

Figura 59: Barra de Ferramentas Padro
E3 Manual do Usurio
92 Domnio
O boto (Executar Aplicativo) executa o Domnio (ou fora os projetos j em
execuo a serem atualizados) e abre o Viewer. Se o Domnio demorar mais de 20
segundos para entrar em execuo, o Viewer no ser aberto, sendo ento necessrio
abri-lo manualmente.
Atravs do Boto (Rodar/Parar Domnio), o Domnio executado ou
terminado.
Finalmente, atravs do Boto (Executar/Parar E3 Viewer), o Viewer pode ser
aberto ou fechado.
3.3.2. Configuraes de Dominio via menus do E3 8tudio
O Domnio tambm pode ser acessado atravs dos menus do E3 Studio. Acessando
o menu ArquivoNovo Domnio, possvel criar um novo Domnio, e adicionar
os projetos e bibliotecas abertos a ele, se necessrio. Para abrir um Domnio e
carregar seus projetos e bibliotecas no E3 Studio, acesse o menu ArquivoAbrir
Domnio; para fech-lo, acesse o menu ArquivoFechar Domnio. Atravs do
menu ArquivoUsurios, o E3 Studio abre uma caixa de dilogo para
configurao dos usurios e permisses de acesso ao Domnio.
3.3.3. Configuraes de Dominio via menu de contexto
Para acessar as configuraes de um projeto ou uma biblioteca via menu de
contexto, necessrio clicar com o boto direito no nome do projeto ou biblioteca
no Organizer.
Atravs da opo Adicionar ao Domnio, possvel adicionar o projeto ou
biblioteca lista de projetos ou bibliotecas do Domnio, respectivamente. No caso
de projetos, se o Domnio estiver em execuo, o projeto adicionado executado
imediatamente.
Para remover o projeto ou biblioteca do Domnio, utiliza-se a opo Remover do
Domnio. No caso de projetos, se o Domnio estiver em execuo, o projeto
automaticamente parado.
Ainda no caso especfico de projetos, a opo Habilitar projeto habilita o projeto
para execuo; para desabilit-lo utilizada a opo Desabilitar projeto. Quando
esta opo selecionada, o projeto fica em modo manuteno. Se o Domnio estiver
em execuo, o projeto parado imediatamente.
3.3.4. Configuraes de Dominio via 8ystem Tray
Quando o E3 Server est sendo executado, ele disponibiliza um cone no System
Tray, que permite acessar um menu com vrias opes. Clicando com o boto
E3 Manual do Usurio
Domnio 93
direito no cone e selecionando a opo DomnioOpes, o E3 abre uma caixa de
dilogo com as seguintes opes de configurao do Domnio.

Figura 60: Opes de configurao via System Tray


Figura 61: Opes de configuraes


E3 Manual do Usurio
94 Domnio
As opes disponveis so as seguintes:
Opes disponveis na aba Opes
OPO DESCRIO
Caminho de acesso aos
arquivos do Dominio pela
rede
Especifica o caminho de acesso dos arquivos do
Domnio.na rede.
Habilitar distribuiao em rede Permite que o Domnio seja distribudo em rede,
isto , em mais de um servidor. 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.
Servidor principal Seleciona o nome do servidor principal para
execuo do Domnio. Para cadastrar e configurar
os servidores, utilize a pgina de Servidores.
Servidor de backup 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.
Endereo para P!NG de
integridade da rede
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.
Ativar backup em caso de
falha local
Habilita a troca automtica de servidores quando
uma falha local reportada no servidor principal.
Falhas locais so detectadas e reportadas pelo
prprio aplicativo atravs da funo
Application.ReportFailure. A troca de servidores
s feita se o servidor de backup estiver sem
falhas.
Tempo para ativaao do
servidor reserva
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.
Perfil de pr-ativaao do
servidor reserva
Apresenta os seguintes perfis de pr-ativao
disponveis:
Mnimo: Ativa apenas os servios bsicos;
E3 Manual do Usurio
Domnio 95
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.
Pr-ativar os seguintes
servios
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 captulo
Hot-StandBy.
Quando o Domnio est distribudo em rede, 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.
E3 Manual do Usurio
96 Domnio
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 no Boto do E3 Studio para que as alteraes
sejam aplicadas no processo de runtime (E3Run).
NOTA: A DISTRIBUIO EM REDE NO EST DISPONVEL EM MODO
DEMO! Quando o Domnio est distribudo em rede necessrio que todos os
servidores tenham uma cpia dos arquivos do Domnio (.dom, .prj e .lib) e a mesma
rvore de diretrios.
3.4. E3 8erver
O E3 Server o coordenador de todos os outros mdulos do E3. simbolizado por
um cone no system tray . O E3 Server responsvel por:
Verificar e gerenciar licenas de uso dos diferentes mdulos do E3;
Iniciar/Parar/Monitorar o processo de runtime (E3Run) do Domnio;
Abrir/Editar/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. Um domnio pode ser aberto pelo E3 Server das seguintes maneiras:
Atravs da linha de comando: E3 Server start
caminho_do_arquivo.dom (carrega e coloca o domnio em execuo)
Ex: E3 Server start C:\Program Files\Elipse E3\Projects\Projeto2.dom
Atravs do Studio pelo menu Arquivos Abrir Domnio (carrega
apenas o domnio)
O domnio permanece aberto at que outro domnio seja selecionado ou ele seja
fechado.
E3 Manual do Usurio
Domnio 97
3.4.1. Criando Logs no E3
O E3 permite que sejam gerados logs de seus componentes e do E3 Server. Para
tanto, basta criar uma pasta chamada E3Logs no diretrio C:\. Assim, quando o E3
for executado, os logs sero gerados automaticamente nesta pasta.
possvel obter logs mais especficos para alguns componentes do E3 simplesmente
criando pastas, dentre as listadas abaixo, de acordo com o tipo de log que desejar:
DB: Logs especficos do Banco de Dados.
Full: Logs genricos e mais detalhados das diversas partes do E3.
IO: Logs de leitura de IODrivers (incluindo os erros, se houver).
Raw: Logs de baixo nvel da comunicao entre Viewers e Servidores.
Sync: Logs do Registro de Eventos.
Rec: Logs especficos e mais detalhados dos alarmes, da comunicao
entre o servidor e os Viewers e rastreamento de objetos do banco de
dados.
Para tanto, basta criar as pastas acima no diretrio C:\E3Logs.
Nota: 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.
3.4.2. Acessando o E3 8erver via linha de comando
O E3 Server pode ser acessado via linha de comando das seguintes maneiras:
E3 Server <nome_do_domnio> [opes]
ou
E3 Server [opes] <nome_do_domnio>
As opes disponveis seguem abaixo:
-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.
3.4.3. Configuraes de 8egurana do Dominio
E3 Manual do Usurio
98 Domnio
Atravs da aba Segurana, possvel determinar as configuraes padro 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 no System
Tray, selecione a opo Domnio Opes e acesse a aba Segurana. A seguinte
janela ser mostrada:

Figura 62: Configurao de segurana do Domnio
As opes disponveis so as seguintes:
E3 Manual do Usurio
Domnio 99
Opes disponveis na aba Segurana
OPO DESCRIO
O usuario nao pode alterar a
sua senha
Impede que o usurio troque a senha em
runtime.
A senha expira aps ... dias 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.
A senha deve conter no minimo
... caracteres
Determina o nmero mnimo de caracteres
para a senha do usurio.
A senha deve conter letras e
numeros
Determina que a senha do usurio deva conter
letras e nmeros.
A senha deve conter letras
maiusculas e minusculas
Determina que a senha do usurio deva conter
letras maisculas e minsculas.
Bloquear a conta do usuario
aps ... falhas de login
Determina o nmero mximo de falhas de
login para que a conta do usurio seja
bloqueada.
Desbloquear o usuario
automaticamente aps ...
minutos
Desbloqueia a conta do usurio depois de
determinados minutos.
Avisar o usuario nos ultimos ...
dias antes da senha expirar
Determina a data em que o sistema comea a
enviar mensagens dirias ao usurio avisando-o
sobre a data de expirao de sua senha. Aps
esta data, se o usurio no trocar sua senha, ele
ser bloqueado, e somente o administrador
poder desbloque-lo.

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 usurio).
Se o usurio digitar a senha errada um determinado nmero de vezes
seguidas, isto , falha 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 seja
expirado.
E3 Manual do Usurio
100 Domnio
3.4.4. Grupos de Viewers
possvel especificar de acordo com o IP do Viewer se este pode se conectar, e com
qual tipo de licena (Viewer Full ou Viewer Only).
Com este recurso possvel bloquear totalmente a conexo, ou limitar a quantidade
e o tipo de licenas que sero usadas simultaneamente para um determinado grupo
de IPs.
Para acessar os grupos de Viewers, clique com o boto direito do mouse no cone do
E3 no System Tray, selecione a opo DomnioOpes, e acesse a aba Grupos de
Viewers. A seguinte janela ser mostrada:

Figura 63: Configuraes de Grupos de Viewers
E3 Manual do Usurio
Domnio 101
As opes disponveis so:
Opes disponveis na aba Grupos de Viewers
OPO DESCRIO
Nome Lista os nomes de todos os grupos de Viewer.
Adicionar f Remover Adiciona/remove grupos de Viewers.
Nome do grupo Habilita a criao/alterao de nomes de grupos de
Viewers.
Lista de !Ps Especifica quais IPs pertencero ao grupo, e desse
modo compartilharo os mesmos limites de conexo.
Quando um Viewer tenta se conectar ao E3 Server,
seu IP ser comparado aos grupos existentes. Aps
determinado o grupo ao qual pertence, ser aplicada a
restrio de licenas a este Viewer configurada para
aquele grupo.
Adicionar f Editar f
Remover
Adiciona/edita/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.
Permitir conexoes de
viewer Full
Quando selecionado, permite conexes de Viewer
Full para o grupo.
Limitar uso de licenas
simultaneas
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.
Permitir conexoes de
viewer Only
Quando selecionado, permite conexes de Viewer
Only para o grupo.
Limitar uso de licenas
simultaneas
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 o hardkey possuir dez licenas de Viewer e
o grupo especificar cinco conexes no mximo, apenas estas cinco sero usadas. No
entanto, se o hardkey possuir cinco licenas de Viewer e o grupo especificar dez
conexes no mximo, sero utilizadas o limite de cinco conexes do hardkey. Ou
seja, o grupo de Viewer ter sempre uma limitao de licenas adicional a ser
aplicada na conexo do Viewer.
E3 Manual do Usurio
102 Domnio
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.4.5. Configuraes do Registro de Eventos do Dominio
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/desabilitado individualmente:
Login/Logout de usurio;
Troca de senha de usurio;
Falha de login de usurio;
Alterao na base de dados de usurio;
Bloqueio de conta de usurio;
Incio/Trmino do domnio;
Alterao no domnio (Inserir/Remover/Habilitar/Desabilitar projetos e
libs, alterar a configurao do domnio);
Atualizao do domnio (quando o usurio manda aplicar as alteraes
feitas em projetos, atravs do 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 como 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.
E3 Manual do Usurio
Domnio 103
Esquema de Funcionamento
O diagrama abaixo 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.
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.
E3 Manual do Usurio
104 Domnio
Configurao de Registro de Eventos
A aba Registro de Eventos permite configurar o registro de eventos do E3. Para
habilitar o registro de eventos, necessrio habilitar a opo Registrar os eventos
do sistema em uma tabela no Banco de Dados do aplicativo.

Figura 64: Registro de eventos
As opes disponveis deste item so as seguintes:
E3 Manual do Usurio
Domnio 105
Opes disponveis na aba Registro de Eventos
OPO DESCRIO
Registrar os eventos do sistema
em uma tabela no Banco de
Dados do aplicativo
Habilita o registro de eventos no E3.
Selecionar automaticamente um
Banco de Dados no aplicativo
Habilite esta opo para deixar que o E3Run
escolha um objeto Servidor de Dados para
gravar os dados. Se o aplicativo possui apenas
um Servidor de Dados, este objeto ser usado.
Se tiver mais de um, recomendado marcar a
opo Usar este Banco de Dados.1
Usar este Banco de Dados Habilite esta opo para especificar o Servidor
de Dados onde sero gravados os eventos. Se o
nome do Servidor de Dados foi informado
incorretamente, os eventos ficaro
armazenados na fila de eventos do E3 Server
(em memria), at que seja indicado um
Servidor de Dados vlido.
Nome da tabela 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 = 200
caracteres)
EventComment (String): comentrio
sobre o evento (mximo = 200
caracteres)
Narque abaixo os eventos que
devem ser registrados
Lista os eventos disponveis no sistema, para
serem registrados.

Se o E3Run tiver que escolher entre vrios Servidores de Dados, normalmente ser
utilizado o primeiro Banco de Dados ativado na execuo do domnio (o que est
mais acima na rvore do Organizer). Se durante a execuo do domnio, o usurio
E3 Manual do Usurio
106 Domnio
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
que 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 que um
Servidor de Dados no projeto).
Quando um evento selecionado na lista e o Boto [F2] pressionado, abre uma
caixa de dilogo para edio do evento. A seguinte janela mostrada:

Figura 65: 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.
E3 Manual do Usurio
Domnio 107

Figura 66: 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, Studio ou E3 Server);
%CAUSE%: Informao adicional sobre o evento.
Por exemplo, se a mensagem do evento Falha de Login for alterada para:

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

Se o usurio Admin escrever uma senha errada enquanto fizer login no Viewer
que est rodando na mquina CLIENT004, ser gerado o seguinte evento:

" Falhou login do usurio Admin no computador CLIENT004
(usando um Viewer): login ou senha incorretos"

E3 Manual do Usurio
108 Domnio
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 Studio ou no
Viewer, onde:
%USER% contm o nome de login do usurio.
%SESSION% contm Viewer ou 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 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 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.
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 Studio, onde:
%USER% contm o nome de login informado.
%SESSION% contm Viewer ou Studio.
%MACHINE% contm o nome do computador onde o usurio tentou
logar.
E3 Manual do Usurio
Domnio 109
%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 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 Studio ou E3 Server (menu do SystemTray);
%MACHINE% contm o nome do computador onde foi gerado o
comando de executar o 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 Studio ou E3 Server (menu do SystemTray).
%MACHINE% contm o nome do computador onde foi gerado o
comando de parar o domnio.
E3 Manual do Usurio
110 Domnio
Domnio atualizado
Domnio atualizado pelo usurio %USER% no %SESSION% na mquina
%MACHINE%
Gerado sempre que o domnio atualizado pelo boto [!!!] do Studio, isto , quando
so aplicadas no E3Run as alteraes feitas em PRJs e LIBs, onde:
%USER% contm o nome de login do usurio logado no Studio (ou
Annimo, se no h nenhum usurio logado).
%SESSION% contm Studio;
%MACHINE% contm o nome do computador onde o 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 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
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 do System Tray);
%MACHINE% contm o nome do computador onde foi gerado o
comando de ativar o servidor backup.
E3 Manual do Usurio
Domnio 111
3.4.6. Configuraes do Pro]eto no Dominio
A pgina de projetos permite adicionar, remover e editar os projetos (PRJ) de um
domnio. Utilize esta opo para selecionar um ou mais projetos a alterar. Para
acessar tal item, clique com o boto direito do mouse no cone do E3 no System
Tray e selecione a opo Domnio Opes - Projetos.

Figura 67: Configuraes do Projeto
E3 Manual do Usurio
112 Domnio
As opes disponveis deste item so as seguintes:
Opes disponveis na aba Projeto
OPO DESCRIO
Nome Esta opo lista os nomes dos projetos no sistema
Adicionar f Remover Atravs destas opes, pode-se remover ou adicionar
projetos no sistema. Para adicionar um projeto, basta
clicar no boto [Adicionar] e especificar os campos
Nome do projeto e itens da distribuio em rede. Para
remover um projeto, basta selecion-lo e clicar no boto
[Remover]. O arquivo PRJ no deletado do disco,
apenas removido da lista de projetos do domnio.
Nome do projeto Digite o nome do arquivo do projeto que deve ser um
caminho relativo ao diretrio do domnio (o diretrio
que contm o arquivo .DOM).
Exemplos: Telas.PRJ
Hidro\Estacao1.prj
Em manutenao
(execuao desabilitada)
Esta opo permite que seja desabilitada a execuo do
domnio no do projeto. Isto possibilita desabilitar o
domnio, evitando que ocorram erros na execuo do
projeto. Se a opo habilitada, o sistema mostra o cone
, demonstrando que o projeto no ser utilizado. Os
demais projetos com o cone mostram os projetos
habilitados.

3.4.7. Configuraes dos 8ervidores
A pgina de projetos permite 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 projeto est habilitado ( ) ou em
manuteno/desabilitado( ).
Para acessar tal item, clique com o boto direito do mouse no cone do E3 no System
Tray, selecione a opo Domnio Opes - Servidores. A seguinte janela ser
mostrada:
E3 Manual do Usurio
Domnio 113

Figura 68: Configuraes dos Servidores
As opes disponveis deste item so as seguintes:
E3 Manual do Usurio
114 Domnio
Opes disponveis na aba Servidores
OPO DESCRIO
Nome Esta opo lista os nomes dos servidores no sistema.
Adicionar f Remover Atravs destas opes, pode-se remover ou adicionar
servidores no sistema. Para adicionar um servidor em
rede, basta clicar no boto [Adicionar] e especificar
os campos Nome do servidor, Identificao do
servidor na rede e 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].
Nome do servidor Determina o nome do servidor. Este nome definido
pelo usurio.
Caminho local de acesso
aos arquivos do dominio
Marque esta opo para indicar a localizao dos
arquivos do domnio (.PRJ e .LIB) no servidor
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.
!dentificaao do servidor
na rede
Digite o nome do servidor na rede, deve ser o nome
da mquina com ou sem as barras duplas no incio
(ex: \\server ou server).
Em manutenao
(execuao desabilitada)
Esta opo permite que seja desabilitada a execuo
do servidor no projeto. Isto possibilita desabilitar o
servidor, evitando que ocorram erros na execuo do
domnio projeto. Se a opo habilitada, o sistema
mostra o cone , demonstrando que o servidor
no ser utilizado. Os demais servidores com o cone
mostram os servidores habilitados.

E3 Manual do Usurio
Domnio 115
3.4.8. Licenas
Voc tambm pode visualizar as licenas via E3 Server. Para acessar tal item, clique
com o boto direito do mouse no cone do E3 no System Tray e selecione a opo
Licenas. A seguinte janela ser mostrada:

Figura 69: Licenas
As opes disponveis deste item so as seguintes:
Opes disponveis para Licena
OPO DESCRIO
Nmero da
licena
Informa o nmero da licena (hardkey), um hexadecimal de oito
dgitos. Se o hardkey no foi detectado, o nmero 00000000.
E3 SERVER Indica o tipo de E3 Server.
E3STUDIO Indica o nmero de licenas disponveis e em uso do Viewer.
E3 VIEWER Indica o nmero de licenas disponveis e em uso do Viewer.
E3 VIEWER
ONLY
Indica o nmero de licenas disponveis e em uso do Viewer no
modo Somente Leitura
Pontos E/S Indica o nmero de pontos de IO e de drivers disponveis e em uso.
Maximum
execution
time
Indica o tempo mximo permitido de execuo de um aplicativo.
E3 Manual do Usurio
116 Domnio
3.4.9. 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 no System Tray, selecione a opo Monitor.

Figura 70: Monitor
As opes disponveis deste item so as seguintes:
Opes disponveis na janela E3 Server - Monitor
OPO DESCRIO
Dominio atual Mostra o nome do arquivo .DOM corrente e indica o estado do
domnio: rodando ou parado.
Endereo de ping Mostra o estado da conexo com o endereo de integridade da rede.
Nome Nome do servidor.
Endereo Endereo de rede do servidor.
Ping Mostra o estado do ping de rede com este servidor.
Relgio Mostra a hora local do servidor.
Estado Mostra o estado do domnio no servidor (Parado ou Rodando).
Conexao Mostra o estado da conexo com o servidor.
Funao 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.

E3 Manual do Usurio
Domnio 117
3.4.10. Avanado
Esta opo permite habilitar a execuo do E3 Server como servio. Assim,
possvel iniciar automaticamente o domnio atravs do caminho especificado.
Para acessar tal item, clique com o boto direito do mouse no cone do E3 no System
Tray, selecione a opo Avanado. A seguinte janela ser mostrada:

Figura 71: E3 Server Avanado
As opes disponveis deste item so as seguintes:
Opes disponveis na janela E3 Server - Avanado
OPO DESCRIO
Executar o E3 Server
como servio
Habilita a execuo do E3 Server como servio.
!niciar automaticamente o
dominio
Habilita a execuo automaticamente do domnio
atravs do caminho especificado.
Usar o dominio corrente Habilita utilizar o domnio corrente.

Para parar o E3 Server quando este est sendo executado como servio existe a
opo Parar E3 Server, disponvel no menu pop-up somente quando a primeira
opo da janela acima tiver sido marcada. Ao ser acionada esta opo, pedida a
confirmao da parada, e se confirmada parado e fechado o domnio, e
desconectados todos Studios e Viewers (caso existam).

Figura 72: Parar E3 Server
E3 Manual do Usurio
118 Domnio
NOTA : Esta opo no vlida em modo DEMO.
3.5. Conectar a ...
A opo Conectar a... utilizada para determinar a conexo do servidor, que pode
ser local ou em rede, e a licena de uso do Studio, que pode ser do servidor do
domnio ou outro. Para utilizar este recurso, necessrio acessar o menu Arquivo -
Conectar a..., e a caixa de dilogo aberta:

Figura 73: Conectar a
As opes disponveis deste item so as seguintes:
Opes disponveis na janela Conectar a...
OPO DESCRIO
Conectar ao servidor local Habilita a conexo com o servidor local.
Conectar a um servidor na
rede
Habilita a conexo com um servidor da rede. Para
tanto, basta acess-lo atravs do combobox.
Pegar licena no servidor
de dominio atual
Usa licena do servidor onde roda o domnio.
Usar licena de um
servidor especifico
Usa a licena de outro servidor, que no o rodando o
domnio.

Se a conexo com qualquer dos dois servidores (servidor de domnio ou servidor de
licena) cair, o Studio desconectado do outro servidor. A ltima configurao
E3 Manual do Usurio
Domnio 119
guardada no registro, e da prxima vez em que o Studio for aberto ele se conectar
aos servidores de domnio e de licena utilizados da ltima vez.
Se o servidor de licena for diferente do servidor de domnio, o nome do servidor de
licena ser mostrado no ttulo da janela do Studio: (licena no servidor local) ou
(licena em XXX).
Se for especificado um servidor de licena, a janela de licenas do E3 Server no
servidor de domnio identifica o nome do servidor que est emprestando a licena
para o Studio: SERVIDOR1 (licena emprestada de SERVIDOR2). Neste caso a
licena que est listada no servidor de domnio no entra na contagem de licenas de
Studio em uso naquele servidor.
Se o servidor de domnio no possuir hardkey, e um Studio se conectar a este
servidor usando a licena de outro servidor, ento o servidor de domnio passar
temporariamente de modo Demo para modo Studio (ver seo Pacotes Disponveis,
no captulo Introduo), voltando para modo Demo assim que a sesso de Studio
for fechada.
NOTA: Quando o 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
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).
Se a conexo falhar, o sistema abre uma caixa de dilogo para reconexo do Viewer.

Figura 74: Reconexo do Viewer
A janela "Conectar a..." aberta para permitir conectar ao servidor local ou a outro
servidor da rede. A conexo com um servidor remoto faz com que uma licena do
E3 Studio seja consumida no servidor remoto. O hardkey local no utilizado
quando a conexo remota. O ttulo do E3 Studio informa o nome do servidor
conectado e tambm indica se est rodando em modo demo.
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 Manual do Usurio
120 Domnio
Studio e o E3 Server remoto podero acessar os arquivos utilizando o mesmo
caminho.

Drivers 121

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 InserirDriver de Comunicao.

Figura 75: Inserindo um Driver de Comunicao na aplicao
Capitulo
4
4. Drivers
E3 Manual do Usurio
122 Drivers
Ao inserir um Driver em uma aplicao do E3 Studio, aberta a view do objeto,
conforme a figura abaixo.

Figura 76: View do Driver de Comunicao
As opes disponveis so:
Opes disponveis na view do Driver de Comunicao
OPO DESCRIO
Adicionar

Adiciona uma nova pasta, um novo Tag ou um novo
Bloco de Comunicao ao Driver; um novo Tag ou
um novo Bloco de Comunicao a uma pasta; ou um
novo Elemento de Comunicao a um Bloco.
Remover

Remove o item selecionado na view.
Configurar o driver

Acessa a janela de configuraes extras do driver.
Tag Browser

Abre uma janela que permite importar tags
diretamente do driver.
Ativarfdesativar
comunicaao

Ativa e desativa a comunicao do driver.
Contagem de tags

Apresenta o nmero total de tags de comunicao no
driver.

E3 Manual do Usurio
Drivers 123
4.1.1. Configurao dos Drivers de Comunicao
Para determinar o driver de comunicao a ser usado, clique na propriedade
DriverLocation. Uma caixa de seleo para a determinao do arquivo .dll que
contm a comunicao ser exibida, conforme a figura abaixo.

Figura 77: 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.
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 a
E3 Manual do Usurio
124 Drivers
monitorao, 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 e/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.
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.
E3 Manual do Usurio
Drivers 125
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 78: Acesso ao Gerenciador de Drivers
O Gerenciador de Drivers permite visualizar todos os drivers em execuo,
exibindo suas propriedades.

Figura 79: Gerenciador de Drivers
E3 Manual do Usurio
126 Drivers
As opes disponveis so as seguintes:
Opes disponveis na janela Gerenciador de Drivers
OPO DESCRIO
Nome Informa o nome do driver inserido no sistema.
Caminho Informa o caminho do driver no sistema.
Compartilhado? Informa se o driver est compartilhado. Se ele estiver,
mostra na tela a palavra SIM, caso contrrio, mostra a
palavra NO.
Erros de leitura Mostra o total de leituras do driver, a quantidade de erros de
leitura e percentual de erros em relao ao total de leituras.
Erros de escrita Mostra o total de escritas do driver, a quantidade de erros de
escrita e percentual de erros em relao ao total de escritas.
Log Mostra o status do log (habilitado/desabilitado).
Botao [Habilitar Log| Habilita o log dos drivers em runtime sem a necessidade de
reconfigurar o aplicativo. Atravs do mesmo boto
podemos interromper este procedimento de gravao.
Botao [Atualizar| Fora a atualizao dos dados exibidos
Utilizao de Estampa de Tempo
Alguns equipamentos e protocolos permitem o envio de informaes de tempo
juntamente com os valores das variveis. Os drivers de comunicao para tais
equipamentos podem, a cada varivel consultada, retornar tambm a informao
deste relgio que fica armazenada na propriedade TimeStamp de cada tag, com
resoluo de 1ms.
Quando o equipamento no suporta este tipo de informao, ou quando o driver no
est preparado para tal, o driver de comunicao insere na estampa de tempo o valor
de data/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, informado a mesma estampa de tempo
para todos os elementos do bloco, j que foram consultados 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.
E3 Manual do Usurio
Drivers 127
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 80: 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,
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.
E3 Manual do Usurio
128 Drivers
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 InserirNova Pasta.

Figura 81: Insero da Nova Pasta

E3 Manual do Usurio
Drivers 129
4.1.4. Tag de Comunicao
O Tag de Comunicao possibilita a leitura/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 InserirTag de Comunicao.

Figura 82: Insero do Tag de Comunicao

E3 Manual do Usurio
130 Drivers
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
Scripts: Manual de Referncia do E3, em seu captulo referente.
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.
A depender 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
InserirBloco de Comunicao;

E3 Manual do Usurio
Drivers 131

Figura 83: Insero do Bloco 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;

Figura 84: Determine o nmero elementos do Bloco de Comunicao
E3 Manual do Usurio
132 Drivers
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 Scripts: Manual de
Referncia.
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:
Clique com o boto direito do mouse no Bloco de Comunicao e escolha
a opo InserirElemento de Comunicao.

Figura 85: Insero do Elemento de Bloco

E3 Manual do Usurio
Drivers 133
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 Scripts: Manual de
Referncia.
4.2. 8ervidor OPC
Alm de possuir um cliente OPC (Driver OPC), o E3 funciona tambm como
Servidor OPC DA (Data Access) 2.0x. Isso permite ao E3 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
disponibilizados 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/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:
E3 Manual do Usurio
134 Drivers
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.
Para utilizar um Driver OPC, siga estes procedimentos:
Clique com o boto direito do mouse sobre o nome do projeto, e selecione
a opo InserirDriver de Comunicao OPC.

Figura 86: Insero do Driver OPC

E3 Manual do Usurio
Drivers 135
Ao inserir um Driver OPC em uma aplicao do E3 Studio, aberta a view do
objeto, conforme a figura abaixo.

Figura 87: View do Driver de Comunicao OPC
As opes disponveis so:
Opes disponveis na view do Driver OPC
OPO DESCRIO
Adicionar

Adiciona um Grupo ao Driver; um Tag, um Bloco ou
uma Pasta ao Grupo; ou um Elemento ao Bloco.
Remover

Remove o item selecionado na view.
Selecionar servidor

Seleciona o Servidor OPC.
Ativarfdesativar
comunicaao

Ativa e desativa a comunicao do driver.
!mportar tags

Importa tags para o Driver OPC.
!nformaoes sobre o
servidor

Mostra uma janela com as configuraes do Driver.
Contagem de tags

Apresenta o nmero total de tags de comunicao no
driver.

E3 Manual do Usurio
136 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 88: Configuraes do Driver OPC
Informe o Endereo e ID do Servidor e clique no boto [Selecionar...]. A seguinte
janela ser mostrada:
E3 Manual do Usurio
Drivers 137

Figura 89: Seleo do Servidor OPC
As opes disponveis neste item so as seguintes:
Opes disponveis na janela Servidores OPC
OPO DESCRIO
Tentar enumerador padrao ou
registro (recomendado)
O E3 ir tentar procurar as especificaes do
driver tanto pelo registro do Windows quanto
pelo enumerador padro OPC (OPCENUM).
Tentar apenas enumerador
padrao (servio OPCENUN)
O E3 ir tentar procurar as especificaes do
driver apenas pelo enumerador padro OPC
(OPCENUM).
Tentar apenas registros no
sistema
O E3 ir tentar procurar as especificaes do
driver apenas pelos registros no Window.

E3 Manual do Usurio
138 Drivers
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 90: Ativar comunicao do Driver OPC
E3 Manual do Usurio
Drivers 139
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 91: Opes habilitadas quando o driver OPC est ativo
E3 Manual do Usurio
140 Drivers
A opo Informaes sobre o servidor mostra uma janela com as configuraes do
driver.

Figura 92: 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 93: Mensagem referente a importao de tags OPC
As opes so as seguintes:
S!N: 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.
E3 Manual do Usurio
Drivers 141
A janela de importao dispe dos seguintes recursos:

Figura 94: Importao de Tags OPC
E3 Manual do Usurio
142 Drivers
As opes disponveis so as seguintes:
Opes disponveis na janela Importao de Tags OPC
OPES DESCRIO
Nome dos !tens Filtra os tags a partir do nome dos itens especificados.
Podem ser utilizados caracteres curingas, tais como *
ou ?.
Tipo de dados Filtra os tags a partir do tipo de dado especificado no
campo. Estes dados podem ser do tipo Integer,
Long, Single, etc.
Tipo de acesso Filtra os tags a partir do tipo de acesso especificado
no campo. Estes acessos podem ser: Leitura, Escrita
ou Leitura/Escrita.
Nostrar apenas itens com
!Ds nao encontrados no
projeto
Filtra os tags para que o sistema mostre apenas os
itens com IDs no encontrados no projeto.
Projeto corrente Mostra os objetos que foram selecionados para adio
no projeto corrente.
Servidor OPC Mostra os tags disponveis no servidor para a
importao.

Para fazer a importao, basta selecionar o tag desejado e arrast-lo para o driver ou
Grupo OPC desejado. Para desativar a comunicao do Driver OPC, basta clicar na
opo Desativar Comunicao.
Algumas das propriedades do Driver OPC podem ser configuradas atravs da Lista
de Propriedades, sem a necessidade de criar scripts para isto. Caso necessite
configurar alguma propriedade, basta localiz-la na Lista de Propriedades e fazer os
devidos ajustes. Para maiores informaes, consulte o Scripts: Manual de
Referncia.
E3 Manual do Usurio
Drivers 143
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 InserirGrupo de tags OPC.

Figura 95: Insero do 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 Scripts: Manual de
Referncia.

E3 Manual do Usurio
144 Drivers
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 que 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 InserirNova Pasta.

Figura 96: Insero de Pasta OPC

E3 Manual do Usurio
Drivers 145
4.3.4. Tag de Comunicao OPC
O Tag OPC um objeto para leitura e/ou escrita de valores em um equipamento. A
leitura do tag feita automaticamente pelo Servidor OPC, com tempo de varredura
definido no grupo OPC pela 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 InserirTag de Comunicao OPC.

Figura 97: Insero do Tag de Comunicao OPC
Algumas das propriedades do Tag OPC podem ser configuradas atravs da Lista de
Propriedades, sem a necessidade de criar scripts para isto. Caso necessite configurar
alguma propriedade, basta localiz-la na Lista de Propriedades e fazer os devidos
ajustes. Para maiores informaes, consulte o Scripts: Manual de Referncia.

E3 Manual do Usurio
146 Drivers
4.3.5. Bloco de Comunicao OPC
O objeto Bloco de Comunicao OPC possibilita a leitura e/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 Bloco de Comunicao OPC.

Figura 98: Insero do Bloco de Comunicao OPC
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 em um
determinado intervalo de elementos.

E3 Manual do Usurio
Drivers 147

Figura 99: Determine o nmero de elementos do Bloco de Comunicao OPC
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 Scripts: Manual de
Referncia.
E3 Manual do Usurio
148 Drivers
4.3.6. Elemento de Bloco OPC
O objeto Elemento de Bloco OPC possibilita a leitura e/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 5 12 77 55 1 3 42 20 8 89
ndice 0 1 2 3 4 5 6 7 8 9

teria sua propriedade Value igual a 3, segundo a tabela acima.
OBS: 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 InserirElemento de Bloco OPC.

Figura 100: Insero do Elemento de Bloco OPC

E3 Manual do Usurio
Drivers 149
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 Scripts: Manual de
Referncia.
4.4. Oualidade
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
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
QUALIDADE CAMPO QUALIDADE DESCRIO
0 - 63
Ruim
O valor no usvel pelas
razes indicadas no substatus.
6+ - 127
Incerta
A qualidade do valor incerta
pelas razes indicadas no
substatus.
128 - 191 (Reservado) No usado pelo padro OPC.
192 - 255 Boa A qualidade do valor Boa.

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.

E3 Manual do Usurio
150 Drivers
4.4.1. Campo 8ub8tatus
O layout deste campo depende do valor do campo Qualidade.
SubStatus para Qualidade RUIM
SUBSTATUS DESCRIO LIMITE

S
e
m

L
i
m
i
t
e

B
a
i
x
o

A
l
t
o

C
o
n
s
t
a
n
t
e

Nao especifico O valor ruim, mas nenhuma
razo especifica conhecida.
0 1 2 3
Erro de
Configuraao
H algum problema de
configurao especficos no
servidor. Por exemplo: o item em
questo pode ter sido deletado.
4 5 6 7
Nao Conectado 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.
8 9 10 11
Falha de
Dispositivo
Uma falha de dispositivo foi
detectada.
12 13 14 15
Falha de Sensor Uma falha de sensor foi detectada
(o campo Limite pode prover
informao adicional).
16 17 18 19
Ultimo valor
conhecido
Comunicao em falha. Entretanto,
o ultimo valor conhecido est
disponvel. Note que a idade do
valor pode ser determinada pela
propriedade TimeStamp.
20 21 22 23
Falha de
Comunicaao
Comunicaes esto em falha. No
h ultimo valor conhecido
disponvel.
24 25 26 27
Fora de
Servio
O Bloco est fora de scan ou
trancado.
28 29 30 31
NfA No usado. 32 - 63

E3 Manual do Usurio
Drivers 151
SubStatus para Qualidade INCERTA
SUBSTATUS DESCRIO LIMITE

S
e
m

L
i
m
i
t
e

B
a
i
x
o

A
l
t
o

C
o
n
s
t
a
n
t
e

Nao especifico No especfico. 64 65 66 67
Ultimo valor
usavel
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.
68 69 70 71
Nao utilizado No utilizado em OPC. 72 79
Sensor
impreciso
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).
80 81 82 83
Unidade de
engenharia
excedida
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.
84 85 86 87
Sub-Normal O valor derivado de mltiplas
fontes e h um nmero menor do
que o requerido de fontes boas.
88 89 90 91
Nao utilizado No utilizado em OPC. 92 127

E3 Manual do Usurio
152 Drivers
NOTA: Servidores que no suportam o Substatus devem retornar 0.
SUBSTATUS PARA QUALIDADE BOA
SUBSTATUS DESCRIO LIMITE

S
e
m

L
i
m
i
t
e

B
a
i
x
o

A
l
t
o

C
o
n
s
t
a
n
t
e

Nao especifico O valor bom. No h condies
especiais.
192 193 194 195
Nao utilizado No utilizado. 196 215
Forado
localmente
Tipicamente indica que a entrada
foi desconectada e um valor
entrado manualmente foi forado.
216 217 218 219
Nao especifico No usado em OPC. 220 - 255
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
diagnostico.
CAMPO LIMITE
ESPECIFICAES DESCRIO
Nao Limitado O valor livre para mover acima ou abaixo.
Limite !nferior O valor est limitado em algum valor inferior.
Limite Superior O valor est limitado em algum valor superior.
Constante O valor uma constante e no pode mover-se.

Servidores que no suportam Limite devem retornar 0.


Servido de Dados 153

O Servidor de Dados o mdulo responsvel por executar ou abrigar a execuo de
todas as outras variveis do processo que no so exatamente de comunicao, como
tag interno, tag Demo, ou ainda outras estruturas de dados como a parte de dados das
bibliotecas ElipseX chamados de XObject. Para utilizar este recurso, siga estes
procedimentos:
Clique com o boto direito do mouse sobre o projeto no Organizer,
selecione a opo Inserir Servidor de Dados;

Figura 101: Insero do Servidor de Dados
Capitulo
5
5. 8ervidor de Dados
E3 Manual do Usurio
154 Servidor de Dados
5.1. Pasta de Dados
A Pasta de Dados define grupos e subdiretrios de forma a organizar as variveis.
Caso haja necessidade, novas pastas podem ser inseridas dentro de outras.
Para utilizar este recurso, siga estes procedimentos:
Clique com o boto direito do mouse sobre o Servidor de Dados e
selecione a opo Data Pasta de Dados.

Figura 102: Insero da Pasta de Dados
5.2. 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, a partir da seleo nos botes que aparecem na janela.
Para utilizar este recurso, siga estes procedimentos:
Clique com o boto direito do mouse sobre o Servidor de Dados e
selecione a opo Data Tag Demo;

As propriedades do Tag Demo podem ser configuradas atravs da Lista de
Propriedades, sem a necessidade de criar scripts para isto. Caso necessite configurar
alguma propriedade, basta localiz-la na Lista de Propriedades e fazer os devidos
ajustes.


E3 Manual do Usurio
Servidor de Dados 155
5.3. Tag nterno
O Tag Interno um objeto de propsito genrico, utilizado para guardar valores de
qualquer tipo, incluindo nmeros, textos e at outros objetos. Os valores das
propriedades Quality e Timestamp so sempre atualizados quando a propriedade
Value do Tag Interno modificada por Script. Nesse caso, Quality sempre assume o
valor 192 (qualidade boa no especfica) e Timestamp assume o valor da data/hora
no momento da atribuio em Value. Para permitir a mudana dos valores das
propriedades Value, Quality e Timestamp sem problemas de ordem de atribuio,
utilizado o mtodo WriteEx. Este mtodo permite modificar o valor, timestamp e
qualidade de um Tag Interno, numa s operao.
Para utilizar os recursos deste objeto, siga estes procedimentos:
Clique com o boto direito do mouse sobre o Servidor de Dados e
selecione a opo Data Tag Interno;
Caso necessite, configure as propriedades do objeto. 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.4. Outros tipos de dados
Podem ser inseridos tambm em um Servidor de Dados outros tipos de dados,
tipicamente objetos COM e os XObjects. Atravs desses ltimos, podemos
instanciar os objetos de dados da biblioteca, especificando e/ou associando cada uma
das variveis internas do XObject.
Os objetos inseridos no Servidor de Dados sero executados pelo E3 Server,
portanto estaro presentes no Servidor. Os XControls que podem estar fazendo
referncia aos XObjects esto sendo executados pelo Viewer, logo esto em outro
programa; porm so automaticamente referenciados e manipulados pelo conjunto
Viewer(s) + Servidor (es).
Para inserir um XObject em um Servidor de Dados, devemos proceder da mesma
forma para os tags acima.

E3 Manual do Usurio
156 Servidor de Dados
5.5. Regras para o nome dos Tags
Ao especificar o nome dos tags, alguns detalhes devem ser levados em conta:
O nome da varivel no pode conter caracteres reservados, como: [], \, /,
{}. . Esses caracteres so trocados por caracteres de sublinhado _.
Assim, o sistema aplica a seguinte regra:
Uso dos Colchetes
Se o 1- caractere no for uma letra ou caractere de sublinhado, o nome de
estar entre colchetes [];
Se algum dos demais caracteres (2- em diante) no for uma letra ou
nmero ou caractere de sublinhado, o nome tambm deve estar entre
colchetes.
O nome do tag no pode conter operadores lgicos e aritmticos, tais
como: /, ., etc.;
O nome do tag no pode ser estritamente numrico.



Telas e Quadros 157

Telas so janelas para monitoramento de processos, onde so inseridos objetos que
faro a interface do operador com o sistema. Cada aplicao pode ter um nmero
ilimitado de Telas.
Quadros so objetos para a organizao e a estruturao da interface, criando
visualizaes compostas para o usurio dentro da janela principal do Viewer ou do
seu navegador.
6.1. Tela
A Tela a entidade bsica de interface com o usurio que pode conter vrios tipos
de objetos. Os grficos que so inseridos na Tela podem ser deletados, copiados,
movidos, redimensionados, agrupados ou configurados. Na configurao do Viewer,
voc pode especificar para que seja visualizado um Quadro ou Tela no momento da
sua inicializao. Para tanto, basta definir no campo Tela ou Quadro Inicial a
opo desejada.

Figura 103: Tela ou Quadro Inicial
Atravs da opo Tela ou Quadro inicial do Viewer, possvel determinar se
deseja visualizar o quadro ou a Tela quando o projeto executado. Tambm
possvel atribuir a um objeto esta funo e determinar atravs de um script. Para
inserir uma nova Tela no projeto, siga estes procedimentos:
Clique com o boto direito do mouse sobre o Projeto e selecione a opo
InserirTela. Nesta nova Tela, podem-se definir suas propriedades, alm
de definir vrios tipos de objetos grficos.

Capitulo
6
6. Telas e Ouadros
E3 Manual do Usurio
158 Telas e Quadros
O E3 Studio disponibiliza um completo editor grfico de objetos que podem ser
inseridos em uma Tela ou biblioteca. Esto disponveis os seguintes objetos: Linha,
Retngulo, Retngulo Arredondado, Elipse, Arco de Elipse, Desenho Livre,
Polgono, Polgono de Curvas, Desenho (Imagem), Texto, Display, SetPoint, Escala
e Formulrios (CheckBox, RadioButton, ComboBox, etc..).

Figura 104: Tela
Pode-se configurar as propriedades da Tela para determinar tamanho, cor e outros
aspectos do comportamento e aparncia, alm de eventos ao entrar ou sair de uma
Tela.
As Telas utilizam como padro para o tamanho e coordenadas as unidades
HIMETRIC, dadas em 1/100 mm (no em pixels). Neste sistema, ao adicionar um
valor positivo em x, a coordenada x move-se para a direita. Quando adicionamos um
valor positivo em y, a coordenada y move-se para baixo, sendo a origem dada pelo
canto superior esquerdo da Tela.
As Telas somente podem ser abertas de modo Full-Screen, ocupando toda a rea do
Studio. 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.
E3 Manual do Usurio
Telas e Quadros 159
6.1.1. Componentes da Tela
Os componentes da Tela so os seguintes:
Grade
A Grade serve como referncia para o editor grfico (no aparece em execuo),
composta de pontos separados por uma distncia configurvel.
Com ela, ao inserir, copiar ou editar objetos, as coordenadas iniciais (X, Y) e seu
tamanho (altura, largura) somente sero aqueles possveis para que o objeto fique
alinhado grade, tanto horizontal quanto verticalmente.
A Grade pode ser retirada ou inserida atravs do menu Arranjar ou atravs do cone
da Barra de Ferramentas Alinhamento .

Figura 105: Grade
A opo Grade habilita/desabilita a grade da Tela. J a opo Edio da grade
permite editar a grade, determinar o estilo da grade, suas dimenses e cor. Quando
selecionada esta opo, A seguinte janela mostrada:
E3 Manual do Usurio
160 Telas e Quadros

Figura 106: Propriedades da Grade
As opes disponveis so as seguintes:
Opes disponveis na janela Propriedades da Grade
OPO DESCRIO
Pontilhada A grade fica pontilhada. Quando o projeto
est em execuo, a Tela no visualizada
pontilhada, pois este recurso serve somente
para a orientao dos objetos na Tela.
Linhas pontilhadas A grade fica com linhas pontilhadas.
Alinhar mouse automaticamente Alinha a grade ao mouse automaticamente.
Comprimento Determina o comprimento da grade.
Largura Determina a largura da grade.
Cor Determina a cor da grade.

E3 Manual do Usurio
Telas e Quadros 161
Zoom
Na edio da Tela, podemos escolher livremente o nvel de zoom desejado e mais
confortvel para a edio. O zoom est disponvel atravs do Menu Zoom e possui
vrios nveis que vo de 10 a 800%, alm poder ajustar automaticamente a largura
em "Toda Largura", a altura em "Toda Altura", a pgina inteira sem alterao do
aspecto largura x altura em "Toda Pgina" e a pgina inteira com alterao do
aspecto em "Total".
Camadas
O E3 oferece uma arquitetura de Telas com at 32 camadas para insero de objetos
grficos. Cada objeto pode pertencer a uma ou mais camadas, e a Tela ativa tanto em
configurao (no Studio) quanto em execuo (no Viewer) podem 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. O Viewer pode
tambm, controlar o aparecimento de camadas a depender de um determinado nvel
de Zoom. A configurao das camadas feita a partir do menu Camadas, ou via
boto direito do mouse clicando sobre a Tela, que a princpio exibe as opes:
Opes disponveis no menu Camadas
OPO DESCRIO
Camada Habilita a visualizao da camada.
Todas as camadas Mostra todas as camadas disponveis no projeto.
Nenhuma camada Nenhuma camada mostrada.
Editar camadas Atravs desta opo, podem-se configurar camadas
individuais. Esta opo abre uma caixa de dilogo
para configurao da camada.

Tal configurao tambm pode ser editada atravs da Lista de Propriedades, atravs
da propriedade Layer. Para que um objeto aparea na Tela, a propriedade Layer deve
conter pelo menos 1 bit configurado na mesma posio que a layer da Tela tiver.
Para acessar as opes desta propriedade, basta clicar na mesma na Lista de
Propriedades.

Figura 107: Propriedade Layer sendo configurada atravs da Lista de Propriedades
Quando a opo Editar camadas selecionada, A seguinte janela mostrada.
E3 Manual do Usurio
162 Telas e Quadros

Figura 108: Edio de camada
As opes disponveis so as seguintes:
Opes disponveis na Camada
OPO DESCRIO
Nome Determina o nome da camada.
Zoom Baixo Define a porcentagem inicial de zoom na camada.
Zoom Alto Define a porcentagem final de zoom na camada.
Usar condiao adicional
de visibilidade
Habilita a utilizao de uma condio adicional de
visibilidade de zoom na camada. Esta condio pode ser
uma varivel ou propriedade qualquer.
Link Estabelece uma associao ou propriedade, que uma vez
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).

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

6.2. Ouadros
O objeto Quadro um mtodo para organizar e estruturar a interface do projeto,
criando visualizaes compostas para o usurio dentro da janela principal do Viewer
ou do Internet Explorer. Muitas vezes, uma aplicao requer apenas uma Tela
principal, que a porta de entrada para a aplicao. A partir da, o usurio pode
E3 Manual do Usurio
Telas e Quadros 163
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.
O Quadro possui subdivises, chamadas de Divisores, que podem ser inseridas ou
removidas do Quadro atravs de um clique com o boto direito. O Quadro
inicialmente possui um Divisor principal, que pode ser subdivido horizontal ou
verticalmente em mais Divisores. Cada Divisor corresponde visualizao de uma
Tela ou Quadro de seu processo ou a um URL (Universal Resource Locator),
chamado de Quadro.
O suporte a mltiplas visualizaes se d atravs da criao de um Quadro em sua
aplicao, que inicialmente vem configurado com uma janela apenas, chamada de
Divisor1. O Quadro considerado como uma Tela para o projeto; j os Divisores
so as sub-janelas dentro do Quadro. Como o propsito do uso dos Quadros a
utilizao de mais de uma janela simultaneamente, provavelmente ser necessrio
criar dois Divisores-filhos para esse Divisor principal.
A disposio dos Divisores dentro do Quadro pode ser horizontal ou vertical, isto ,
a Tela pode ser dividida na horizontal ou vertical. Dentro de cada Divisor podem ser
inseridos outros Divisores, representando sub-divises dentro de uma janela.
Para utilizar este recurso, siga estes procedimentos:
Para inserir um quadro, clique com o boto direito do mouse no nome do
projeto e escolha a opo InserirQuadro.
O quadro pode conter divisores, que sero as interligaes entre a
associao especificada e o programa. Para criar um divisor, clique com o
boto direito do mouse sobre o quadro aberto e selecione o tipo de divisor
(horizontal ou vertical).

Figura 109: Inserindo um divisor horizontal
Podem-se inserir vrios Divisores no Quadro.

E3 Manual do Usurio
164 Telas e Quadros

Figura 110: Divisores do Quadro
Para configurar os Divisores do Quadro, clique com o boto direito do
mouse sobre o Divisor desejado e selecione a opo Propriedades.

Figura 111: Configuraes do Quadro
E3 Manual do Usurio
Telas e Quadros 165
As opes disponveis so as seguintes:
Opes disponveis na aba Quadro
OPO DESCRIO
Link Determina o caminho da Tela ou associao que o divisor ir abrir.
Este campo equivale propriedade SplitLink.
Divisao Determina o tipo de diviso no Quadro: horizontal, vertical ou sem
diviso. Este campo equivale propriedade SplitType.
Unidade Determina a unidade da diviso do Quadro: porcentagem ou pixel.
Posiao Determina a posio do divisor no Quadro. Este campo equivale
propriedade SplitPosition.
valor Determina o valor que ser atribudo ao Quadro. Este campo
equivale propriedade SplitValue.

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
Scripts: Manual de Referncia.


Objetos de Tela 167

Uma Tela pode ser definida como uma janela para monitoramento de um processo,
onde so inseridos os objetos que faro a interface do operador com o sistema, que
so chamados de Objetos de Tela.
Os objetos de Tela so elementos grfico e podem ser criados a partir da Barra de
Ferramentas Objetos ou atravs do Menu Objetos. Uma vez selecionado o objeto
que se deseja criar, mantenha o boto esquerdo do mouse pressionado na rea da
Tela, enquanto movimenta o mouse (um retngulo pontilhado mostra o tamanho e a
forma do objeto). Ao soltar o boto, o objeto ser posicionado dentro da rea
especificada.
Os seguintes elementos 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.).
Bibliotecas grficas do E3 (XControl), compostas de qualquer dos objetos
acima.
Os objetos grficos disponveis no sistema so listados abaixo.
Capitulo
7
7. Ob]etos de Tela
E3 Manual do Usurio
168 Objetos de Tela
7.1. Linha
Objeto bsico de reta que liga dois pontos quaisquer. Permite o desenho de retas,
atravs de dois pontos especificados na sua criao ou na de polgonos. Pode ser
redimensionado/rotacionado livremente. Aps ser inserido na Tela, o objeto ser
nomeado como Linha.

Figura 112: Linha
Para utilizar este objeto, siga estes procedimentos:
Selecione a Linha na Barra de Ferramentas Objeto e mova-a para
a rea da Tela.
Desenhe a linha e solte.
7.2. Retngulo
Este objeto permite o desenho de retngulos, utilizando toda a largura/altura do
objeto. Criado a partir de dois vrtices, pode ser redimensionado/rotacionado
livremente.

Figura 113: Retngulo
Aps ser inserido na Tela, o objeto ser nomeado como Retngulo.
Para utilizar este objeto, siga estes procedimentos:
Selecione o Retngulo na Barra de Ferramentas Objeto e mova-o
para a rea da Tela.
Quando o mouse est sobre a Tela, seu desenho se torna uma cruz. Mova-
o para a posio selecionada, pressione e segure o boto esquerdo, e
arraste o mouse na diagonal (para cima ou para baixo).



E3 Manual do Usurio
Objetos de Tela 169
Quando o objeto atingir o tamanho e posio desejada, solte o boto, e o
objeto criado ficar selecionado, o que pode ser visto atravs de uma
seleo das extremidades do objeto.
7.3. Retngulo Arredondado
Retngulo criado a partir de dois vrtices com a opo dos cantos serem
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 114: Retngulo Arredondado
Este objeto permite o desenho de retngulos com borda arredondada, dimensionando
toda a largura/altura do objeto. Atravs de seu ngulo, pode-se configurar o objeto
desde um retngulo at uma elipse.
Ao clicarmos o mouse sobre esse ponto, podemos arrast-lo para as bordas, tornando
o objeto mais reto, ou para o centro, tornando-o mais curvo. Isso refletido
diretamente nas propriedades RoundAspectX e RoundAspectY, que so nmeros reais
que vo de 0 (retngulo completo) a 1 (crculo completo).
Para utilizar este objeto, siga estes procedimentos:
Selecione o Retngulo Arredondado na Barra de Ferramentas
Objeto e mova-o para a rea da Tela.
Quando o mouse est sobre a Tela, seu desenho se torna uma cruz. Mova-
o para a posio selecionada, pressione e segure o boto esquerdo, e
arraste o mouse na diagonal (para cima ou para baixo).

Quando o objeto atingir o tamanho e posio desejada, solte o boto, e o objeto
criado ficar selecionado, o que pode ser visto atravs de uma seleo das
extremidades do objeto.



E3 Manual do Usurio
170 Objetos de Tela
7.4. Elipse
Este objeto permite o desenho de crculos e elipses. Pode ser
redimensionado/rotacionado livremente.

Figura 115: Elipse
Criado a partir de rea definida possui tambm todas as propriedades gerais.
Aps ser inserido na Tela, o objeto ser nomeado como Crculo.
Para utilizar este objeto, siga estes procedimentos:
Selecione a Elipse



na Barra de Ferramentas Objeto e mova-o
para a rea da Tela.
Quando o mouse est sobre a Tela, seu desenho se torna uma cruz. Mova-
o para a posio selecionada, pressione e segure o boto esquerdo, e
arraste o mouse na diagonal (para cima ou para baixo). Quando o objeto
atingir o tamanho e posio desejada, solte o boto, e o objeto criado
ficar selecionado, o que pode ser visto atravs de uma seleo das
extremidades do objeto.
7.5. Arco de Elipse
Permite o desenho de objetos do tipo torta, corda ou pizza. Ao ser inserido na Tela, o
objeto exibe dois pontos que indicam a posio da abertura da torta (propriedades
ArcBeginAngle e ArcEndAngle, dadas em graus (0 a 360)).Utilizando tambm as
propriedades de preenchimento e borda, pode-se customizar melhor o aspecto do
objeto. Modificando o ngulo das propriedades ArcBeginAngle e ArcEndAngle
consegue-se alterar o incio e o final do arco.

Figura 116: Arco de Elipse





E3 Manual do Usurio
Objetos de Tela 171
Este objeto pode ser redimensionado/rotacionado livremente. Aps ser inserido na
Tela, o objeto ser nomeado como Linha. Para utilizar este recurso, siga estes
procedimentos:
Selecione o arco de elipse na Barra de Ferramentas Objeto e
mova-o para a rea da Tela
Quando o mouse est sobre a Tela, seu desenho se torna uma cruz. Mova-
o para a posio selecionada, pressione e segure o boto esquerdo, e
arraste o mouse na diagonal (para cima ou para baixo). Quando o objeto
atingir o tamanho e posio desejada, solte o boto, e o objeto criado
ficar selecionado, o que pode ser visto atravs de uma seleo das
extremidades do objeto.
Caso necessite, configure as propriedades do objeto, clicando com o boto
direito sobre o mesmo e selecionando a opo Propriedades.
7.6. Desenho Livre
Esta ferramenta se destina criao de reas irregulares. Para definir os vrtices do
objeto, mantenha o boto pressionado, enquanto arrasta o mouse pela Tela. Todos os
caminhos que o ponteiro do mouse percorrer sero criados como parte do objeto.

Figura 117: Desenho livre
Este objeto pode ser redimensionado/rotacionado livremente. Aps ser inserido na
Tela, o objeto ser nomeado como Linha. Para utilizar este recurso, siga estes
procedimentos:
Selecione o Desenho livre na Barra de Ferramentas Objeto e mova-
o para a rea da Tela
Quando o mouse est sobre a Tela, seu desenho se torna uma cruz. Mova-
o para a posio selecionada, pressione e segure o boto esquerdo, e
arraste o mouse na diagonal (para cima ou para baixo). Quando o objeto
atingir o tamanho e posio desejada, solte o boto, e o objeto criado
ficar selecionado, o que pode ser visto atravs de uma seleo das
extremidades do objeto.


E3 Manual do Usurio
172 Objetos de Tela
7.7. Poligono
Utilizado para o desenho de polgonos cujos lados so retas.
Este objeto pode ser redimensionado/rotacionado livremente. Aps ser inserido na
Tela, o objeto ser nomeado como Linha.

Figura 118: Polgono
Para utilizar este objeto, siga estes procedimentos:
Selecione o Polgono na Barra de Ferramentas Objeto e mova-o
para a rea da Tela.
A cada clique em uma rea da Tela, ser definido um vrtice do objeto.
Quando desejar interromper o desenho, basta um duplo clique no ltimo
vrtice, quando o objeto aparecer selecionado.
Para deletar pontos de um polgono, deve-se selecionar o polgono
desejado e com o boto direito do mouse selecionar a opo Editar
Pontos. Depois, s selecionar o ponto que se deseja remover clicando
com o mouse e a tecla [Ctrl] do teclado pressionada.
7.8. Poligono de Curvas
Realiza um desenho praticamente da mesma forma que o polgono, porm a cada
ponto inserido, o objeto criar curvas que passam por todos os pontos criados. Este
objeto permite o desenho de curvas Bezier atravs de pontos de referncia, sempre
juntando o ponto final ao ponto inicial. Aps ser inserido na Tela, o objeto ser
nomeado como Bezier.

Figura 119: Polgono de Curvas
Para utilizar este objeto, siga estes procedimentos:
Selecione o Polgono na Barra de Ferramentas Objeto e mova-o
para a rea da Tela.


E3 Manual do Usurio
Objetos de Tela 173
Desenhe o polgono e d duplo clique para finalizar o objeto.
Para deletar pontos de um polgono, deve-se selecionar o polgono e com o
boto direito do mouse selecionar a opo Editar Pontos. Depois, s
selecionar o ponto que se deseja remover clicando com o mouse e a tecla
[Ctrl] do teclado pressionada.
7.9. Figura
Este objeto permite mostrar imagens que estejam armazenadas em arquivos, estejam
eles dentro ou fora do arquivo do aplicativo.
A figura pode ser redimensionada livremente, porm a rotao s efetiva, quando
trabalha com metafile convertido para smbolo. Aps ser inserido na Tela, o objeto
ser nomeado como Figura.

Figura 120: Figura
A figura torna-se bem interessante quando trabalha com arquivos metafile
(extenso.wmf), onde possvel animar as cores de preenchimento/borda sem
alterao do arquivo original.
O seguinte formato de arquivo suportado:
Formatos de arquivos suportados
EXTENSO DESCRIO
.BNP Bitmap file
.G!F Graphics Interchange Format
.JPG Join Picture Expert Group
.!CO Icon File
.WNF Microsoft Windows Metafile
.ENF Microsoft Windows Enchanced Metafile


E3 Manual do Usurio
174 Objetos de Tela
Para utilizar este objeto, siga estes procedimentos:
Selecione a Figura na Barra de Ferramentas Objeto e mova-o
para a rea da Tela.
Quando o mouse est sobre a Tela, seu desenho se torna uma cruz. Mova-
o para a posio selecionada, pressione e segure o boto esquerdo, e
arraste o mouse na diagonal (para cima ou para baixo). Quando o objeto
atingir o tamanho e posio desejada, solte o boto, e o objeto criado
ficar selecionado, o que pode ser visto atravs de uma seleo das
extremidades do objeto.
O sistema abrir uma caixa para seleo da figura no arquivo.

Figura 121: Seleo da figura no arquivo
Selecione o local e clique em Abrir, para inserir a figura na Tela.
Caso necessite, configure as propriedades do objeto.
E3 Manual do Usurio
Objetos de Tela 175
7.10. Texto
Possibilita de criao de um texto. Ao definir a rea na Tela, podemos digitar
diretamente os textos desejados, que aceitam tambm mltiplas linhas.

Figura 122: Objeto Texto
Para utilizar este objeto, siga estes procedimentos:
Selecione o Texto na Barra de Ferramentas Objeto e mova-o para
a rea da Tela.
Digite o texto desejado e pressione a tecla [Enter].
Caso queira alterar ou digitar contedos neste objeto, utilize a propriedade
Value.
7.11. Display
Este objeto utilizado para mostrar os valores dos Tags em tempo real. As
propriedades do Display permitem definir o tamanho, cor, fonte, alinhamento, efeito
3D, etc.

Figura 123: Display
Este objeto pode ser redimensionado/rotacionado livremente. Aps ser inserido na
Tela, o objeto ser nomeado como Texto.
Para utilizar este objeto, siga estes procedimentos:
Selecione o Display na Barra de Ferramentas Objeto e mova-o para
a rea da Tela.
Faa a associao atravs aba Scripts ou scripts que o objeto ir conter
atravs da Aba Associaes.




E3 Manual do Usurio
176 Objetos de Tela
7.12. 8etPoint
O objeto SetPoint trabalha como uma caixa de edio pela qual so inseridos
contedos para atribu-los a tags associados. Assim, basta digitar um valor e
pressionar a tecla [ENTER], para atribuir este valor ao tag associado. As
propriedades do SetPoint permitem que seja definido o tipo de valor de entrada,
fonte, tamanho, e cor dos caracteres que sero mostrados no objeto.

Figura 124: SetPoint
Para utilizar este objeto, siga estes procedimentos:
Selecione o SetPoint na Barra de Ferramentas Objeto e mova-o
para a rea da Tela.
Faa a associao atravs aba Scripts ou scripts que o objeto ir conter
atravs da Aba Associaes.
7.13. Escala
O objeto Escala permite desenhar rguas ou escalas de valores. Atravs de suas
divises e subdivises, determinados atravs das propriedades Ticks e MinorTicks,
so especificadas informaes para configurao do objeto.

Figura 125: Escala
Este objeto pode ser redimensionado/rotacionado livremente. Aps ser inserido na
Tela, o objeto ser nomeado como Escala. Para utilizar este objeto, siga estes
procedimentos:
Selecione a Escala na Barra de Ferramentas Objeto e mova-o para
a rea da Tela.
Quando o mouse est sobre a Tela, seu desenho se torna uma cruz. Mova-
o para a posio selecionada, pressione e segure o boto esquerdo, e




E3 Manual do Usurio
Objetos de Tela 177
arraste o mouse na diagonal (para cima ou para baixo). Quando o objeto
atingir o tamanho e posio desejada, solte o boto, e o objeto criado
ficar selecionado, o que pode ser visto atravs de uma seleo das
extremidades do objeto.
Podem-se alterar os limites inferior e superior da rgua atravs das
propriedades MinimumValue e MaximumValue respectivamente.
Caso necessite, configure as propriedades do objeto.
7.14. Configuraes Gerais
As configuraes gerais dos objetos podem ser acessadas atravs do boto direito do
mouse que pressionado sobre o objeto. As opes disponveis so as seguintes:
7.14.1. Travar
Ao escolher esta opo, o 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 travado.
Para habilitar esta opo, basta clicar com o boto direito do mouse sobre o objeto
desejado e escolher a opo Travar.

Figura 126: Objeto travado
Para desabilitar esta opo, basta clicar novamente com o boto direito no objeto e
selecionar a opo Destravar.
7.14.2. Ponto ncora
definido como as coordenadas (x, y) marcam o ponto inicial do objeto.
Inicialmente, o ponto ncora est atrelado s coordenadas iniciais (X, Y) 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.




E3 Manual do Usurio
178 Objetos de Tela

Figura 127: Objeto com ncora
7.14.3. Configurar como Padro
Aplica as definies do objeto que est sendo editado como o estilo padro para os
prximos objetos que utilizarem a funo Aplicar Estilo. Neste estilo esto
includas as cores de frente, fundo e borda, espessura da linha, estilo da borda e do
gradiente.
7.14.4. Aplicar Estilo
Aplica as definies de estilo previamente definidas pela opo Configurar como
Padro. Neste estilo esto includas as cores de Frente, fundo e borda, espessura da
linha, estilo da borda e do gradiente.
7.14.5. Recortar, Copiar e Colar
So as aes bsicas de edio dos objetos. Podemos copiar, recortar ou colar
objetos ou componentes do E3 atravs dos seguintes mtodos:
Podemos copiar objetos de tela ou componentes do E3 pressionando a
tecla [CTRL], enquanto arrastamos o item que desejamos at a rea da
Tela ou Organizer (no caso do componente do E3).
Tambm possvel utilizar os botes (copiar), (recortar) e
(colar), disponveis na Barra de Ferramentas Padro.
Utilizando as teclas de atalho (Ctrl+C, Ctrl+X, Ctrl+V) para fazer aes
de copiar, recortar e colar, respectivamente.
Para utilizar estes recursos, selecione o objeto ou componente do E3 e escolha a
opo desejada (copiar ou recortar). Aps, indique o objeto destino e selecione a
opo Colar. O objeto que voc copiou poder ser colado de duas maneiras, em
relao ao objeto destino, dependendo de onde foi feita a seleo do mesmo:
Se o objeto destino foi selecionado no Organizer, ento a ao Colar ir
criar um novo objeto filho do destino;
E3 Manual do Usurio
Objetos de Tela 179
Se o objeto destino foi selecionado na janela de configurao do objeto,
ser criado um novo objeto cujo pai o mesmo do objeto destino.
7.14.6. Deletar
Remove o objeto da Tela. Pode ser feito tambm se selecionando o objeto e
pressionando a tecla [Delete].
7.14.7. Propriedades
Abre uma janela para a edio das propriedades gerais (e especficas, caso houver)
do objeto em questo. Esta opo acessada atravs do clique com o boto direito
do mouse sobre o objeto e selecionando a opo Propriedades.

Figura 128: Propriedades
7.14.8. Animao
A animao um recurso do E3 fcil e prtico para dar movimento a um objeto.
Este recurso est disponvel na Barra de Ferramentas Tela.

Figura 129: Barra de Ferramentas Tela com as opes de movimentao
Os tipos de movimentaes disponveis no sistema so:

E3 Manual do Usurio
180 Objetos de Tela
Animar com Translaao (Linear): O objeto que recebe este recurso faz
movimentos lineares de acordo com as configuraes das propriedades no objeto.
Para habilitar esta opo, basta selecionar o objeto na Tela e clicar no boto da
animar com translao. O cursor do mouse habilitar as configuraes da orientao
do objeto.

Figura 130: Translao
Animaao com rotaao: O objeto que recebe este recurso faz movimentos
rotacionais de acordo com as configuraes das propriedades no objeto. A rotao
de um objeto est relacionada com duas propriedades do objeto: o centro de rotao
e o ngulo. Ao criar o objeto, seu centro de rotao padro definido como o centro
do objeto, e possui uma inclinao de 0 graus de posio da horizontal em relao a
esse centro. Ao selecionar a opo Animar com rotao na Barra de Ferramentas
Tela, pode-se alterar tanto o centro de rotao como o prprio ngulo. Nesse
momento, o ponteiro do mouse assume um formato, e o objeto selecionado possui
seus vrtices indicados por pequenos crculos e seu centro por dois crculos
circunscritos.
Ao passar o mouse sobre o centro ou vrtices, o mouse torna-se somente um crculo
e podemos modificar o centro arrastando-o, ou ainda rotacionando o objeto de um de
seus vrtices em relao ao centro.

Figura 131: Ferramenta Rotacionar
O ngulo de rotao pode ser visualizado pela propriedade Angle de cada objeto.
Deve-se ressaltar que alguns objetos ActiveX no permitem rotao.
E3 Manual do Usurio
Objetos de Tela 181
7.14.9. 8obreposio de Ob]etos
Se voc possui dois objetos na Tela, e parte de um precisa estar sob ou sobre o outro,
pode-se ajustar a disposio atravs dos botes:
Enviar para 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 ir ocupar a posio imediatamente acima do
prximo objeto na ordem desejada.
Recuar: O objeto selecionado ir ocupar a posio imediatamente abaixo do
prximo objeto na ordem desejada.
Esta opo pode ser acessada atravs da Barra de Ferramentas Tela.
7.14.10. Ordem de Navegao entre os ob]etos
Ao inserir uma srie de objetos na Tela, possvel (em execuo), atravs do uso da
tecla [Tab], se deslocar de um objeto para o outro, como por exemplo, dois
SetPoints. Esta ordem feita atravs da opo Ordem dos Tabs . Para utilizar
este recurso, crie os objetos na Tela e selecione a opo Ordem dos tabs . Voc
ver que o mouse assumir um cursor semelhante ao cone da opo. Clique com o
mouse nos objetos conforme deseja ordenar. Nos objetos, aparecer o nmero com a
devida ordem especificada.

Figura 132: Ferramenta Procurar
Quando o projeto for compilado, a navegao entre estes objetos, tanto do mouse
como teclado, ser feita conforme a ordem especificada.
E3 Manual do Usurio
182 Objetos de Tela
7.14.11. 8elecionando ob]etos na Tela
Para selecionar os objetos contidos em uma rea, use a ferramenta de seleo .
Com ela, voc pode selecionar os objetos dentro de um retngulo delimitado pelo
mouse.
7.14.12. Agrupando ob]etos e editando ob]etos agrupados
Ao selecionar um grupo de objetos, podemos transform-lo em apenas um, atravs
da opo Agrupar. Com essa opo, ser formado apenas um objeto que expe
propriedades comuns como altura, largura, ngulo, etc., sem mostrar diretamente
para cada um de seus componentes, e podendo copiar, arrastar e deletar um grupo
que todo seu contedo ser tratado como um nico objeto.
Para utilizar este recurso, siga estes procedimentos:
Selecione os objetos que deseja formar o grupo.
Clique no boto Agrupar .

Este recurso permite que os objetos selecionados tornem-se um grupo, fazendo com
que possam ser mudada todas as configuraes do mesmo. Ao ser aplicado este
recurso, o sistema d acesso s propriedades especficas do grupo. Para configur-
las, siga estes procedimentos:
Aps o grupo ser criado, d um duplo clique sobre o objeto ou clique com
o boto direito do mouse e selecione a opo Propriedades;
Propriedades do Grupo
OPO DESCRIO
EnableOverrideLineColor Seta ou retorna o Booleano que habilita/desabilita a
alterao da cor original dos objetos contidos no
grupo.
OverrideFillColor Seta ou retorna o nmero inteiro da cor do
preenchimento para os objetos do grupo.
OverrideFillNode Seta ou retorna o nmero inteiro do estilo do
preenchimento dos objetos do grupo.
OverrideLineColor Seta ou retorna o nmero inteiro da cor da linha para
os objetos do grupo.

Esta operao pode ser feita em cascata, sendo que um grupo pode conter qualquer
objeto inclusive outros grupos. Para desfazer a unio de um grupo de objetos,
devemos selecionar a opo Desagrupar.
E3 Manual do Usurio
Objetos de Tela 183
Para editarmos um objeto contido em grupo, porm, no h necessidade de
desagrup-lo. Basta escolher a opo Editar Grupo, disponvel via clique com o
boto direito sobre o objeto, que teremos acesso a cada componente individual.
7.14.13. Uso de Teclas Direcionais
Para mover um objeto com o teclado, voc tambm pode utilizar as teclas
direcionais, como segue:
Seta para Cima: Sobe o objeto 1 pixel para cima;
Seta para Baixo: Desce o objeto 1 pixel para baixo;
Seta para Direita: Move o objeto 1 pixel para a direita;
Seta para Esquerda: Move o objeto 1 pixel para a esquerda;
Seta + Control: Move o objeto 10 pixels a mais.
7.14.14. Modificando Camadas do Ob]eto
Para modificar a camada de algum objeto, basta selecion-lo e clicar no campo
"Camadas" visvel pela Lista de Propriedades, ou ainda via boto direito do mouse,
selecionando a opo Camadas, quando alguma estiver disponvel.
7.14.15. 8ombreamento
Os objetos grficos podem ter um efeito de sombra automtico, atravs da Barra de
Ferramentas Sombra, que habilita/desabilita a sombra do objeto. Configurando
esta propriedade para True, o objeto mostrar uma sombra com os mesmos estilos de
preenchimento, fundo e borda, porm com a propriedade ShadowColor,
especificada a cor do preenchimento da sombra do objeto.

Figura 133: Opes da sombra
Quando as propriedades so aplicadas em um grupo de objetos, primeiro so
desenhadas todas as sombras dos objetos filhos do grupo e aps so desenhados os
objetos. Ao escolher esta opo, um segundo objeto idntico ao primeiro
acrescentado, porm, ligeiramente deslocado e permanecendo sempre em segundo
plano, criando o efeito de sombra. A propriedade Shadow de cada objeto indica se
este possui ou no o efeito de sombra, e equivale posio do boto
"Sombreamento" da Barra de Ferramentas, assim como as opes de
E3 Manual do Usurio
184 Objetos de Tela
posicionamento que modificam as propriedades ShadowX e ShadowY, dadas em
unidades HIMETRIC(1/100 mm). J a cor da sombra pode ser alterada via opo
Cor da Sombra, ou ento atravs da propriedade ShadowColor na Lista de
Propriedades. Para utilizar os recursos da sombra, proceda assim:
Insira ou selecione o objeto que deseja aplicar a sombra. Voc pode alterar
suas propriedades atravs da barra de atalho ou pela sua caixa de
propriedades.
Opes disponveis no menu Sombra
OPO DESCRIO

Habilita/Desabilita a sombra no objeto.

Posiciona a sombra abaixo do objeto.

Posiciona a sombra acima do objeto.

Posiciona a sombra esquerda do objeto.

Posiciona a sombra direita do objeto.

Configura ou retorna o nmero inteiro da cor da sombra deste
objeto.

E3 Manual do Usurio
Objetos de Tela 185
7.14.16. Preenchimento
Cada objeto grfico pode ter seu contedo preenchido de acordo com as opes
disponveis na propriedade FillStyle, a partir da Lista de Propriedades. So elas:
Opes disponveis para Preenchimento
OPO DESCRIO

Solid: O objeto tem seu contedo da mesma cor da
propriedade ForegroundColor. a opo padro.

Hollow: O objeto mostra em seu interior tudo o que
estiver no fundo, deixando visvel apenas a borda (se
houver). Com esta opo, o objeto no possui contedo.

Horizontal: O preenchimento feito com listras
horizontais, intercaladas com a opo escolhida para o
fundo (Opaco ou Transparente).

Vertical: O preenchimento feito com listras verticais,
intercaladas com a opo escolhida para o fundo (Opaco
ou Transparente).

Downward: O preenchimento feito com listras
diagonais para baixo, intercaladas com a opo
escolhida para o fundo (Opaco ou Transparente).

Upward: O preenchimento feito com listras diagonais
para cima, intercaladas com a opo escolhida para o
fundo (Opaco ou Transparente).

Cross: O preenchimento feito com listras verticais e
horizontais, intercaladas com a opo escolhida para o
fundo (Opaco ou Transparente).

DiagonalCross: O preenchimento feito com listras
diagonais para cima e para baixo, intercaladas com a
opo escolhida para o fundo (Opaco ou Transparente).

SemiTransparent: Nesta opo o objeto fica
parcialmente opaco, isto , transparece o fundo a
depender da opo escolhida para seu fundo (Opaco ou
Transparente). Na opo Opaca a transparncia difusa;
na segunda, feita atravs de pequenas faixas
transparentes.

E3 Manual do Usurio
186 Objetos de Tela
7.14.17. Gradiente e Estilos de Gradiente
Nesta opo, o fundo uma transio ou gradiente da cor "ForegroundColor" para
a cor Backgroundcolor. O efeito de transio determinado pela propriedade
GradientStyle, disponvel na Lista de Propriedades, ou pela opo Estilo do
Gradiente na Barra de Ferramentas.

Figura 134: Efeito Gradiente
As opes de preenchimento disponveis so as seguintes:
E3 Manual do Usurio
Objetos de Tela 187
Opes disponveis para Preenchimento Gradiente
OPO DESCRIO

0- Gradiente para a direita: Degrad vertical da esquerda
para a direita.

1-Gradiente para a esquerda: Degrad vertical da direita
para a esquerda.

2-Gradiente vertical no centro: Degrad vertical do
centro para as bordas.

3- Gradiente vertical na borda: Degrad vertical das
bordas para o centro.

4- Gradiente abaixo: Degrad horizontal de baixo para
cima.

5- Gradiente acima: Degrad horizontal de cima para
baixo.

6- Gradiente horizontal no centro: Degrad do centro
para as bordas.

7- Gradiente horizontal nas bordas: Degrad das bordas
para o centro.

8- Gradiente na base direita: Degrad diagonal para
cima com a cor de frente na direita.

9- Gradiente na base esquerda: Degrad diagonal para
cima com cor de frente na esquerda.

10 Gradiente no centro a 45: Degrad diagonal para
cima do centro para as bordas.

11- Gradiente na borda a 45: Degrad diagonal para
cima das bordas para o centro.
E3 Manual do Usurio
188 Objetos de Tela

12- Gradiente na base esquerda: Degrad diagonal para
baixo com cor de frente na esquerda.

13- Gradiente no topo direita: Degrad diagonal para
baixo com cor de frente direita.

14- Gradiente para baixo a 45: Degrad diagonal para
baixo do centro para as bordas.

15- Gradiente na borda para baixo a 45: Degrad
diagonal para baixo das bordas para o centro.

16- Gradiente na base e direita: Degrad com cor de
frente partindo do canto inferior direito.

17- Gradiente na base e esquerda: Degrad com cor de
frente partindo do canto inferior esquerdo.

18- Gradiente no topo e esquerda: Degrad com cor de
frente partindo do canto superior esquerdo.

19- Gradiente no topo e direita: Degrad com cor de
frente partindo do canto superior direito.

20- Gradiente no contorno: Degrad com cor de fundo do
centro para as bordas.

21- Gradiente no meio: Degrad com cor de fundo das
bordas para o centro.

7.14.18. Estilo de Fundo
Indica como o objeto exibir sua segunda opo de cor (Backgroundcolor), o que
pode ser informado pela opo Estilo de Gradiente da Barra de Ferramentas
E3 Manual do Usurio
Objetos de Tela 189
desenho, ou pela Lista de Propriedades. As opes so Opaco, indicando cores
slidas e Transparente, indicando opo de transparncia com o fundo.

Figura 135: Opes de desenho
7.14.19. Bordas
Indica como o objeto exibir suas extremidades. Podemos definir uma cor para a
Borda, atravs da opo Cor da Borda da Barra de Ferramentas, ou ainda pela
propriedade BorderColor na Lista de Propriedades.

Podemos escolher ainda entre alguns estilos de borda, pela opo Estilo de Borda
ou na propriedade BorderStyle e ainda a espessura da linha pela opo de mesmo
nome ou propriedade BorderWidth, dada em unidades HIMETRIC.
7.14.20. Preenchimento Parcial Horizontal e Vertical
Esta opo muito til para a representao de qualquer tipo de recipiente (tanques,
vasos, reservatrios, etc.) que desejamos indicar o nvel do material. Todos os
E3 Manual do Usurio
190 Objetos de Tela
objetos podem ser preenchidos tanto no sentido vertical quanto horizontal pela cor
de frente (ForegroundColor) em relao cor de fundo (BackgroundColor).
Isso pode ser ajustado pelas seguintes propriedades, acessadas pela Lista de
Propriedades:
Propriedades do Preenchimento
OPO DESCRIO
HorizontalFillStyle Indica a forma do preenchimento horizontal: da esquerda
para a direita, direita para a esquerda ou centro para as
bordas.
verticalFillStyle Indica a forma do preenchimento vertical: de baixo para
cima, cima para baixo ou centro para as bordas.
HorizontalPercentFill Nmero de 0 a 100 indicando a porcentagem do
preenchimento na horizontal. Valor padro: 100
(preenchimento total).
verticalPercentFill Nmero de 0 a 100 indicando a porcentagem do
preenchimento na vertical. Valor padro: 100
(preenchimento total).

7.14.21. Formatao de Cores
Em todas as propriedades de cor do E3, podemos especificar a cor desejada ao
objeto atravs do clique no campo valor da propriedade ForegroundColor na Lista
de Propriedades.

Figura 136: Barra de Ferramentas Desenho
Quando este boto pressionado, abre a caixa de dilogo abaixo. Assim, possvel
especificar uma cor para o objeto selecionado, que pode ser uma cor padro ou
personalizada, caso ela no exista na paleta de cores. A aba Padro permite escolher
cores padronizadas do sistema, incluindo tonalidades de cinza.
E3 Manual do Usurio
Objetos de Tela 191

Figura 137: 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.
J a aba Personalizado permite que o usurio faa suas prprias definies de cores.
A cor pode ser escolhida pela navegao do cursor pelo mapa de cores, com o uso
do mouse. O ponto por onde o mouse passar ter a propriedade de cor refletida nos
campos de cores, que podem ser editados tambm diretamente pelo teclado.

Figura 138: Cor personalizada
E3 Manual do Usurio
192 Objetos de Tela
Existem duas metodologias para a determinao das cores, que so: RGB como cor
primria ou definio de matiz, saturao e luminosidade.
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 dessas cores pode ter um grau de intensidade que vai de 0 a 255. O valor
final obtido atravs da seguinte frmula:
Blue * 256^2 + green * 256^1 + red * 256^0
ou seja
Blue * 65536 + green * 256 + red * 1
sendo que blue, green e red podem assumir valores de 0 a 255.
Por exemplo:
Preto = 0
Branco = 16777215
Vermelho = 255
Verde = 65280
Azul = 16711680
Para facilitar o processo de escolha de uma cor, pode-se utilizar o mtodo
ShowPickColor(), que chama um dilogo com a escala de cores do sistema e
retorna o valor decimal da cor escolhida.
Para configurao da cor atravs da definio de matiz, saturao e luminosidade,
importante observar os itens , a saber:
Hue: Especifica a matiz da cor;
Sat: Indica a saturao da cor;
Lum: Indica a luminosidade da cor, que tambm pode ser editada pelo
slider direita do mapa de cores.
Assim, basta especificar o valor para cada um dos itens, conforme tonalidade da cor
desejada. Essas cores tambm tem o grau de intensidade que vai de 0 a 255.
E3 Manual do Usurio
Objetos de Tela 193
7.15. Formatao de valores
O uso de formatadores permite mudar a forma como os dados so apresentados sem
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 de dados, 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)
Em alguns objetos encontramos a opo de formatao de campos, acessada via
menu de propriedades do objeto ou pela Lista de Propriedades, na propriedade
Format.
7.15.1. Formatos Pr-Definidos
As seguintes formataes esto disponveis:
Geral
No h formatao especfica, sendo realizada automaticamente a depender do tipo
de dado.
Nmero
Este formato 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 WindowsPainel de
ControleConfiguraes Regionais.
Data
Apresentam valores numricos (formato Gregoriano) como datas e horas, quando
vlidos. Para apresentar somente a hora, sem data, utilize o formato Hora.
Hora
Apresentam valores numricos (formato Gregoriano) como datas e horas, quando
vlidos. Para apresentar somente a data, sem hora, utilize o formato Data.
E3 Manual do Usurio
194 Objetos de Tela
Porcentagem
Este formato multiplica o nmero por 100 e adiciona o smbolo de percentual,
definindo-se 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).
7.15.2. Outros Formatos
Na opo Outros, podemos 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. E 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 seja
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 (;).

7.15.3. Entrada de Texto
Para inserir caracteres que sero mostrados pelo formatador pode-se coloc-los entre
aspas () ou aps uma barra:
Entrada de Texto
FORMATADOR SADA FORMATADA
"0#?" 0#?
\m\d\y Mdy

Isso vlido para todos os tipos de formatadores. Alm disso, podem ser criados
formatadores que contenham apenas texto. possvel tambm combinar isso com os
uso dos diferentes campos. Exemplo:
E3 Manual do Usurio
Objetos de Tela 195
Formatador e Sada Formatada
VALOR FORMATADOR SADA FORMATADA
1 Positivo; Negativo;Zero,Texto Positivo
-1 Positivo;Negativo;Zero,Texto Negativo
0 Positivo;Negativo;Zero,Texto Zero
"ABCD" Positivo;Negativo;Zero,Texto Texto
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 \\" e \.
Quando entre aspas todo o texto copiado diretamente logo "\a" mostrado
simplesmente como \a./
7.15.4. Formatadores Numricos
Os formatadores numricos aceitam trs tipos bsicos de caracteres para definir o
nmero de dgitos apresentados:
Formatadores Numricos
OPO DESCRIO
0 {zero) Coloca o dgito significativo ou 0(zero) quando no houver.
# Coloca o dgito significativo.
? Coloca o dgito significativo ou um espao quando no houver.

O ponto decimal '.' define que se deseja apresentar tambm a parte fracionria de um
nmero. O caractere no formatador sempre o ponto '.', mas apresentado como o
caractere separador (exemplo: vrgula) configurado no sistema (pelo Painel de
Controle do Windows). A vrgula tem duas funes: aps os dgitos do formatador,
indica que o valor deve ser divido por mil (para cada vrgula). Independente da
configurao local do Windows, no texto do formatador sempre deve ser usada
vrgula para indicar o separador de milhar, mas a sada formatada ser de acordo
com a configurao regional do sistema. Se colocada na parte direita do ponto
decimal (parte inteira), juntamente com os dgitos, indica que deve ser usado o
separador de milhar. A vrgula (,) pode ser usada como separador de milhar mesmo
na notao cientfica, mas no para dividir o nmero por 1000.
E3 Manual do Usurio
196 Objetos de Tela
Opes disponveis
DADO FORMATADOR SADA FORMATADA
12000 #, 12
1234567 #,#,0 1,234,567.0
1 E-20 #e-0... 1 e 20
1E+20 #,###e-0 1,000e+17
Formatador Cientfico
O nmero poder ser apresentado em notao cientfica (mantissa e expoente)
quando aps algum digito 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.
Formatador Cientfico
DADO FORMATADOR SADA FORMATADA
1.0 #,#E+# 1.E+0
123 ####e-00 1230 e-01
Formatador 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.
Formatador para Texto
ICONE COMANDO AO
"Abc" @@ Abc Abc
"xyZ" Nome: \ @ \ Nome: xyZ
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 esses dgitos so apresentados de qualquer forma.
Atualmente estes formatadores esto limitados em nmeros de 32 bits.
Caso a parte inteira do valor exceda esse limite formatao retornar erro.
E3 Manual do Usurio
Objetos de Tela 197
Formatadores para Bases No-Decimais
OPO DESCRIO
X ou x Insere um dgito hexadecimal (hibble 0-9, A-Z) ou zero.
B ou b Insere um dgito binrio (bit 0,1) ou um zero.
O ou o Insere um dgito octal (0-7) ou zero.
Formatadores para Bases No-Decimais
DADO FORMATADOR SADA FORMATADA
255 0xXXX 0 x 0 FF
12345 0000\o 30071
9S7 B 1111011011
12 BBBB BBBB 0000-1100

OBS: Este tipo de formatador no suportado em programas de planilhas de dados.
Formatos para Data Hora
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, isso 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, o separador de datas e horas so todos utilizados de
acordo com a configurao regional do Windows. Atravs do quadro abaixo,
possvel verificar o formatador e a sada formatada para os valores:
E3 Manual do Usurio
198 Objetos de Tela
Formatos para Data-Hora
OPO DESCRIO
H Insere a hora no formato 24 hs com um ou dois dgitos (1-24).
HH Insere a hora no formato de 24 hs sempre com dois dgitos (1-24)
H Insere a hora no formato de 12 hs com um ou dois dgitos (1-12).
Hh Insere a hora no formato de 12 hs sempre com dois dgitos (1-12)
M Insere os minutos com um ou dois dgitos (0-59).
Mm Insere os minutos sempre com dois dgitos (00-59).
S Insere os segundos com um ou dois dgitos (0-59).
Ss Insere os segundos sempre com dois dgitos (00-59).
s.0 Insere os segundos com dcimos de segundos.
s.00 Insere os segundos com centsimo de segundos.
s.000 Insere os segundos com milsimos de segundos.
T Insere apenas o primeiro caractere do indicador de AM/PM (A/P)
Tt Insere todo o texto do indicador de AM/PM.
{h) Insere o tempo decorrido em horas, com um ou mais dgitos.
{mm) Insere o tempo decorrido em minutos, com dois ou mais dgitos.
{s) Insere o tempo decorrido em segundos, com um ou mais dgitos.
{ss) Insere o tempo decorrido em milissegundos com dois ou mais dgitos.
{d) Insere o tempo decorrido em dias com dois ou mais dgitos.
D Insere o dia do ms com dois ou mais dgitos (0-31).
Dd Inserem o dia do ms sempre com dois ou mais dgitos.
Dddd Insere o nome do dia da semana abreviado.
Mm Insere o nome do dia da semana completo.

Exemplos
DADO FORMATADOR SADA FORMATADA
1.5 1899f12f31 12:00:00
1234.567S9 DdfNNNNfyyyy 18/maio/1903
0.567S9 Hh:mm:ss.000 tt 01:37:45.696 PM
12.34567S hhhmmmss.000s 296 h17 m46.667 s



ActiveX 199

Os objetos ActiveX so componentes de software baseados na tecnologia COM
(Component Object Model) que podem ser inseridos em sua aplicao para realizar
diversas tarefas. Estes objetos so desenvolvidos em ambientes de programao tais
como C/C++, Delphi e Visual Basic, entre outros.
Os objetos ActiveX podem ser grficos, utilizados nas Telas de sua aplicao, ou
no-grficos, que realizam algum tipo de manipulao de dados.
8.1. Registrando ob]etos ActiveX no E3
Quando o E3 instalado, alguns objetos ActiveX so automaticamente registrados.
So eles: E3Alarm, E3Browser e E3Chart (desenvolvidos pela Elipse Software);
Microsoft Forms (desenvolvidos pela Microsoft); e ActiveReports (desenvolvido
pela Data Dynamics).
NOTA: O E3Alarm, E3Browser, E3Chart e ActiveReports possuem captulos
prprios mais adiante neste Manual.
Alm destes, voc poder inserir qualquer outro objeto ActiveX que desejar. Os
procedimentos necessrios para o registro do ActiveX no E3 sero explicados
abaixo:
Acesse o Menu Ferramentas Adicionar Activex.... O sistema mostrar
uma caixa de dilogo, conforme figura abaixo:
Capitulo
8
8. ActiveX
E3 Manual do Usurio
200 ActiveX

Figura 139: Registrando um ActiveX no E3
Clique no Boto [Registrar]. O sistema abrir uma caixa de dilogo para
localizao do arquivo que contm o ActiveX.

Figura 140: Localizao do arquivo ActiveX
Selecione o arquivo e clique no boto [Abrir]. Em caso de sucesso, uma
mensagem de confirmao de registro no E3 ser mostrada, conforme
figura abaixo:
E3 Manual do Usurio
ActiveX 201

Figura 141: Mensagem de sucesso do registro
Caso contrrio, ser mostrada uma mensagem de erro informando que o
registro do ActiveX no foi realizado, conforme figura abaixo.

Figura 142: Mensagem de erro do registro
E3 Manual do Usurio
202 ActiveX
8.2. nserindo ob]etos ActiveX no E3
Os objetos grficos podem ser inseridos na aplicao atravs do clique com o boto
direito sobre a Tela. Alguns tambm podem ser inseridos atravs da Barra de
Ferramentas Objetos, como o E3Alarm, o E3Browser, o E3Chart e os controles
Microsoft Forms.

Figura 143: Barra de Ferramentas Objetos e acesso aos ActiveX atravs
do clique com o boto direito sobre a Tela
Os objetos no-grficos podem ser inseridos na aplicao atravs do clique com o
boto direito sobre o Servidor de Dados.

Figura 144: Inserindo um objeto no-grfico no Servidor de Dados
E3 Manual do Usurio
ActiveX 203
8.3. Ob]etos Microsoft Forms
Abaixo sero descritos alguns objetos da biblioteca Microsoft Forms.
8.3.1. Caixa de 8eleo
Uma Caixa de Seleo d ao usurio a possibilidade de escolher entre dois valores
tais como Sim/No, True/False, ou On/Off. Quando o usurio seleciona uma caixa
de seleo, ela indica uma marca especial () e sua configurao atual Sim, True,
ou On. Se o usurio no selecionar a Caixa de Seleo, ela estar vazia e seu estado
No, False, ou Off. Dependendo do valor da propriedade TripleState, uma caixa de
seleo poder ter um valor nulo.

Figura 145: Caixa de Seleo
Se uma caixa de seleo estiver vinculada a uma fonte de dados, a alterao da
configurao mudar o valor dessa fonte. Uma caixa de seleo desativada mostra o
valor atual, mas fica esmaecida e no permite alteraes de valores.
NOTA: O objeto Lista tambm permite inserir uma marca de seleo para as opes
desejadas. Dependendo da aplicao, voc poder usar uma Lista em vez de um
vrias Caixas de Seleo.
A propriedade padro a propriedade Value. O evento padro o evento Click.
Para utilizar este objeto, siga estes procedimentos:
Insira a Caixa de Seleo na Tela atravs da Barra de Ferramentas
Objetos.
Caso seja necessrio, configure as propriedades do objeto.
8.3.2. Boto de Opo
Um Boto de Opo mostra se um item individual de um grupo est ou no
selecionado. Se um Boto de Opo for associado a uma fonte de dados, ele poder
mostrar o valor como Sim/No, True/False, ou On/Off. Se o usurio selecionar o
Boto de Opo, o valor ser Sim, True, ou On. Se o usurio no selecionar o Boto
de Opo, o valor ser No, False, ou Off.

Figura 146: Boto de Opo


E3 Manual do Usurio
204 ActiveX
Quando o Boto de Opes est desabilitado, fica esmaecido e no mostra valor.
A propriedade padro a propriedade Value. O evento padro o evento Click.
Para utilizar este objeto, siga estes procedimentos:
Insira o Boto de Opes atravs da Barra de Ferramentas Objetos.
Caso seja necessrio, configure as propriedades gerais deste objeto.
8.3.3. Lista de 8eleo
Combina as caractersticas de uma Lista e um Editor de Texto. O usurio pode
digitar um valor novo, como no caso de um Editor de Texto, ou selecionar um valor
existente, como em uma Lista de Seleo.
Os itens de uma Lista de Seleo consistem em linhas de dados. Cada linha pode ter
uma ou mais colunas, que podem aparecer com ou sem ttulos. Alguns aplicativos
no oferecem suporte a ttulos de colunas; outros oferecem apenas suporte limitado.

Figura 147: Lista de Seleo
A propriedade padro deste objeto Value, e o evento padro o OnChange.
Para utilizar este objeto, siga estes procedimentos:
Insira a Lista de seleo atravs da Barra de Ferramentas Objetos.
Caso seja necessrio, configure as propriedades gerais deste objeto.
8.3.4. Boto de Comando
Executa uma ao especfica ao ser pressionado. O procedimento de script atribudo
ao evento Click do boto determina sua ao. Por exemplo, pode-se criar um boto
que abra uma janela. Pode-se tambm mostrar um texto, um desenho ou ambos com
um Boto de Comando.

Figura 148: Boto de comando
A propriedade padro de um Boto de Comando Value. O evento padro de um
Boto Click.
Para utilizar este objeto, siga estes procedimentos:


E3 Manual do Usurio
ActiveX 205
Insira o Boto de Comando na Tela;
Caso seja necessrio, configure as propriedades deste objeto.
8.3.5. Texto
O objeto Texto utilizado para exibir um texto descritivo, tal como ttulos, textos
em geral ou instrues rpidas. Por exemplo, os ttulos de um catlogo de endereos
poderiam ser feitos atravs de um Texto, aos quais seriam atribudos nomes, ruas ou
cidades.

Figura 149: Texto
NOTA: Tambm possvel exibir uma figura em um Texto. Entretanto, no
possvel cortar, dimensionar ou aplicar zoom figura.
A propriedade padro de um Texto Caption, e o evento padro Click.
Para utilizar este objeto, siga estes procedimentos:
Insira o Texto na Tela;
Caso seja necessrio, configure as propriedades gerais deste objeto.
8.3.6. Lista
Exibe uma lista de valores, que pode ser determinada pelo usurio ou vinculada a
uma fonte de dados.

Figura 150: Lista
A propriedade padro de uma lista Value, e o evento padro o Click.
Para utilizar este objeto, siga estes procedimentos:
Insira a Lista na Tela.
Caso seja necessrio, configure as propriedades gerais deste objeto.



E3 Manual do Usurio
206 ActiveX
Estilos de Lista
possvel escolher um dos dois estilos de apresentao de uma lista. Cada estilo
fornece diferentes maneiras para a seleo de itens na lista pelos usurios. Este estilo
escolhido atravs da propriedade ListStyle.
Se a opo de estilo for Plain, cada item ser exibido em uma linha separada; e o
usurio selecionar um item realando uma ou mais linhas.
Se a opo de estilo for Option, um Boto de Opo ou uma Caixa de Seleo
aparecer no incio de cada linha. Com esse estilo, o usurio selecionar um item
clicando no Boto de Opo ou na Caixa de Seleo. As Caixas de Seleo s
aparecem quando a propriedade MultiSelect estiver configurada para a opo
1-fmNultiSelectNulti.
8.3.7. Barra de Rolagem
A Barra de Rolagem um controle independente que retorna ou define o valor da
propriedade de outro objeto, de acordo com a posio da caixa de rolagem. Sua
aparncia visual semelhante barra de rolagem vista em certos objetos, como Lista
de Seleo, Editor de Texto e outros. Entretanto, diferente das barras de rolagem
destes objetos, a Barra de Rolagem independente no parte integral de nenhum
outro objeto.

Figura 151: Barra de Rolagem
Para fazer a Barra de Rolagem definir o valor de outro objeto, pode-se escrever um
script que utilize a propriedade Value. Por exemplo, para utilizar a Barra de
Rolagem para atualizar o valor de um Editor de Texto, pode-se digitar um script que
leia a propriedade Value da Barra de Rolagem e, em seguida, definir a propriedade
Value do Editor de Texto.
O evento padro de uma Barra de Rolagem o Change, e a propriedade padro
Value.
Para utilizar este objeto, siga estes procedimentos:
Insira a Barra de Rolagem na Tela.
Caso seja necessrio, configure as propriedades gerais deste objeto.
8.3.8. Boto ncremento-Decremento
Este Boto utilizado para incrementar e decrementar valores. Ao clicar em um
Boto Incremento-Decremento, somente o valor deste objeto mudado.


E3 Manual do Usurio
ActiveX 207
Pode-se escrever um script que use o Boto Incremento-Decremento para atualizar o
valor exibido de outro objeto (por exemplo, para mudar o ms, ano ou dia mostrado
numa data). Pode-se tambm usar um Boto Incremento-Decremento para percorrer
um intervalo de valores ou lista de itens, ou para alterar o valor exibido em um
Editor de Texto. Para exibir um valor atualizado no Boto Incremento-Decremento,
pode-se atribuir o valor do objeto a sua parte exibida com a propriedade Caption de
um Texto ou Editor de Texto.

Figura 152: Boto Incremento-Decremento
Outra opo simplesmente associar a propriedade Value do Boto Incremento-
Decremento diretamente a uma propriedade de outro objeto, como Caption ou Value
de um Texto ou Editor de Texto.
O evento padro de um Boto incremento-decremento o Change, e a propriedade
padro Value.
Para utilizar este objeto, siga estes procedimentos:
Insira o Boto Incremento-Decremento na Tela;
Caso seja necessrio, configure as propriedades gerais deste objeto.
8.3.9. Editor de Texto
O Editor de Texto exibe informaes na Tela ou informaes digitadas pelo
usurio, sendo mais comumente usado para exibir as ltimas. Alm disso, pode
exibir um conjunto de dados, como uma tabela ou consulta, ou resultados de
clculos.
Uma formatao aplicada a qualquer parte do texto em um Editor de Texto afetar
todo o texto do objeto. Por exemplo, se a fonte e/ou o tamanho de qualquer caractere
no objeto forem alterados, a alterao afetar todos os caracteres do Editor de Texto.


Figura 153: Editor de Texto
A propriedade padro de um editor de texto Value, e o evento padro Change.
Para utilizar este objeto, siga estes procedimentos:
Insira o Editor de Texto na Tela;

E3 Manual do Usurio
208 ActiveX
Caso seja necessrio, configure as propriedades gerais deste objeto.
Dicas sobre a utilizao do Editor de Texto
O Editor de Texto um controle flexvel governado pelas seguintes propriedades:
Text, Multiline, WordWrap e AutoSize.
A propriedade Text contm o texto a ser exibido no Editor de Texto.
A propriedade Multiline habilita o Editor de Texto a exibir o texto como uma linha
individual ou como vrias linhas. Os caracteres identificam onde termina uma linha
e comea outra. Se Multiline estiver configurada como False, o texto ser truncado
em vez de quebrado.
Os ajustes de quebra de linhas de texto mais longas em linhas mais curtas so
definidos na propriedade WordWrap. O seu valor padro True. Se a propriedade
WordWrap no for usada, o Editor de Texto iniciar uma nova linha de texto sempre
que encontrar um caractere no texto. Se a propriedade WordWrap for desativada,
algumas linhas de texto podero no caber completamente no Editor de Texto.
Assim, o objeto exibir as partes do texto que couberem em sua largura, truncando
as partes que no couberem. A propriedade WordWrap s se aplica quando a
propriedade Multiline for True.
A propriedade AutoSize ajusta o Editor de Texto para que este exiba todo o texto.
Quando esta propriedade usada em um Editor de Texto, a largura do objeto se
reduz ou expande de acordo com a quantidade de texto no Editor de Texto e com o
tamanho da fonte usada para exibir o texto.O valor padro False.
A propriedade AutoSize funciona bem nas seguintes situaes:
Exibindo uma legenda de uma ou mais linhas;
Exibindo o contedo de um Editor de Texto com uma s linha;
Exibindo o contedo de um Editor de Texto somente de leitura com
vrias linhas.
NOTA: Recomenda-se evitar o uso da propriedade AutoSize com um Editor de
Texto vazio que tambm utilize as propriedades Multiline e WordWrap. Quando o
usurio digita um texto em um Editor de Texto com essas propriedades, ele
automaticamente se dimensionar como uma caixa longa e estreita, como um
caractere de largura e uma linha de texto de comprimento.
E3 Manual do Usurio
ActiveX 209
8.3.10. Boto Liga-Desliga
Um Boto Liga-Desliga mostra o estado de seleo de um item.
Se o Boto Liga-Desliga est associado a uma fonte de dados, ele mostra o valor
atual daquela fonte de dados, como Sim/No, Verdadeiro/Falso ou On/Off, ou
alguma outra escolha de duas definies. Se o usurio selecionar o Boto Liga-
Desliga, o valor ser Sim, Verdadeiro ou On. Caso contrrio, ser No, Falso ou Off.

Figura 154: Boto Liga-Desliga
Um Boto Liga-Desliga desabilitado mostra um valor, mas est escurecido e no
permite modificaes do usurio.
A propriedade padro de um Boto Liga-Desliga Value, e o evento padro o
Click. Para utilizar este objeto, siga estes procedimentos:
Insira o Boto Liga-Desliga na Tela;
Caso seja necessrio, configure as propriedades gerais deste objeto.



Associaes 211

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 155: Pgina de Associaes
Capitulo
9
9. Associaes
E3 Manual do Usurio
212 Associaes
As opes disponveis na aba Associaes so as seguintes:
Opes disponveis na aba Associaes
OPO DESCRIO
Propriedades Lista as propriedades do objeto que podem ser
associadas.
Conexao Indica o tipo de conexo que a propriedade possui.
Para 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).
Fonte 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/reviso.
Os tipos de conexes disponveis sero explicados abaixo.
E3 Manual do Usurio
Associaes 213
9.1. Conexo 8imples
Na Conexo Simples, o valor do campo Fonte copiado para a propriedade toda
vez que o primeiro for modificado.

Figura 156: 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.

E3 Manual do Usurio
214 Associaes
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 157: 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.

E3 Manual do Usurio
Associaes 215
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 158: Conexo digital
As opes disponveis nesta conexo so as seguintes:

E3 Manual do Usurio
216 Associaes
Opes disponveis para Conexo Digital
OPO DESCRIO
Ligado Especifica o valor assumido pela propriedade quando a
expresso da fonte for True.
Desligado Especifica o valor assumido pela propriedade quando a
expresso da fonte resultar em False.
Pisca Quando este campo estiver habilitado, a propriedade
conectada 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.
Para o valor
<Campo Ligado>
Especifica o valor alternativo a ser assumido
periodicamente pela propriedade quando a expresso ou
associao da fonte resultar em True e o campo Pisca
estiver habilitado.
Para o valor
<Campo Desligado>
Especifica o valor alternativo a ser assumido
periodicamente pela propriedade quando a expresso da
fonte resultar em False e o campo Pisca estiver
desabilitado.

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.
E3 Manual do Usurio
Associaes 217
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 159: Conexo analgica
As opes disponveis nesta conexo so as seguintes:
Opes disponveis para Conexo Analgica
OPO DESCRIO
valor da Fonte Determina os valores mnimo e mximo atingidos na fonte.
valor na Propriedade Determina os valores mnimo e mximo atingidos na
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.

E3 Manual do Usurio
218 Associaes
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
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 160: Conexo por tabela
As opes disponveis nesta conexo so as seguintes:

E3 Manual do Usurio
Associaes 219
Opes disponveis para Conexo por Tabela
OPO DESCRIO
Botao
Insere uma nova linha na tabela.
Botao
Remove a linha selecionada da tabela.
Nin Especifica o valor mnimo da fonte para uma linha da tabela.
Nax Especifica o valor mximo da fonte para uma linha da tabela.
valor Especifica o valor da propriedade a ser assumido quando a
fonte estiver no intervalo especificado na linha.
Pisca 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).
valor
< 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.

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.
Caso deseje alternar periodicamente entre os valores, habilite o campo
Pisca e configure as opes restantes.
E3 Manual do Usurio
220 Associaes
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 161: Conexo Reversa

E3 Manual do Usurio
Associaes 221
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.

Figura 162: Acesso a opo Editar Associaes
A seguinte caixa de dilogo abaixo mostrada:
E3 Manual do Usurio
222 Associaes

Figura 163: Edio de Associaes
A caixa de dilogo acima 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:
Opes disponveis na janela Editar Associaes
OPES DESCRIO
Nome do objeto Determina o nome do objeto.
Propriedade f Evento Determina a propriedade do objeto que possui a associao.
Conexao Determina o tipo de associao (analgica, digital, simples,
reversa, bidirecional ou por tabela).
Fonte Determina a fonte da associao.
Opes para Propriedades do tipo Link
OPO DESCRIO
Nome do objeto Determina o nome do objeto que possui a propriedade.
Propriedade f Evento Determina o nome da propriedade.
Conexao sempre a mesma link.
Fonte Determina o valor da propriedade.
Opes para Eventos do usurio
OPO DESCRIO
Nome do objeto Determina o nome do objeto que possui o evento.
Propriedade f Evento Determina o nome do evento do usurio.
Conexao Determina o tipo do evento (OnEvent, WhileEvent ou
OnValueChanged).
Fonte Expresso relacionada ao evento.

E3 Manual do Usurio
Associaes 223
Na caixa de dilogo Editar Associaoes, 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.

A opo Mostrar Lista 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.

Figura 164: 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 165: Edio das propriedades dos eventos do usurio
E3 Manual do Usurio
224 Associaes
Ao clicar na opo Editar, a caixa de dilogo abaixo mostrada, permitindo assim
que seja editado o evento do usurio selecionado.

Figura 166: Edio de eventos
As opes disponveis so as seguintes:
Opes disponveis na janela Editar Eventos
OPO DESCRIO
A propriedadefexpressao Propriedade/expresso geradora do evento.
For uma condiao verdadeira Indica que o evento ser do tipo etOnEvent ou
etWhileEvent.
Repetir o evento a cada... ms Indica o ciclo de repetio do evento em ms, isto
, 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.
Tratar a desconexao como
mudana
Se houver alguma desconexo, ela ser tratada
como uma mudana de valor.



Viewer 225

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 seu domnio.

Figura 167: 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.
Capitulo
10
10. Viewer
E3 Manual do Usurio
226 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. Configuraes do Visualizador
Atravs da aba Visualizador, so configuradas as opes do Viewer quanto a ttulo,
tela, zoom e demais propriedades, conforme explicado abaixo.

Figura 168: Propriedades do Visualizador do Viewer
Cada campo da aba Visualizador possui uma propriedade correspondente. As
opes disponveis so as seguintes:
E3 Manual do Usurio
Viewer 227
Opes disponveis na aba Visualizador
OPO DESCRIO
Titulo Determina o ttulo do Viewer. Este campo equivale
propriedade Caption do objeto Viewer.
Tela ou Quadro !nicial Determina a Tela ou quadro que o Viewer ir iniciar.
Clicando no boto , o sistema abre uma janela de
configurao, pela qual chamar o AppBrowser, onde
ser especificada a Tela inicial de visualizao do
sistema. Este campo equivale propriedade
InitialScreen do objeto Viewer.
Zoom Determina 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 porcentagem de zoom da mesma.
Exibir o menu do Zoom
ao clicar com o botao
direito do mouse
Habilita a exibio do menu de Zoom com o boto
direito em tempo de execuo. Este campo equivale
propriedade EnableZoomMenu do objeto Viewer.
Nanter Telas
carregadas na memria
Habilita o Viewer a manter as Telas carregadas na
memria. Este campo equivale propriedade
CacheEnable do objeto Viewer.
!niciar Naximizada f
Ninimizada f Janelada
Determina o estilo da janela do Viewer. Este campo
equivale propriedade WindowStyle e possui as
seguintes configuraes:
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.
verificar inatividade
aps ... minutos
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.
Numero de retentativas
para confirmaao de
usuario ou senha
Estabelece o nmero de vezes que o dilogo de login
ser exibido alm da primeira vez. Este campo equivale
propriedade LoginRetries do objeto Viewer.
Centralizar janela Centraliza a janela do Viewer. Este campo equivale
propriedade CenterWindow do objeto Viewer.
Desabilitar troca de
janela
Desabilita a troca de janelas. Este campo equivale
propriedade DisabletaskSwitching do objeto Viewer.
Titulo do viewer Habilita o ttulo do Viewer no topo da janela. Este
campo equivale propriedade TitleBar do objeto
Viewer.

E3 Manual do Usurio
228 Viewer
10.1.2. 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 169: Aba Erros de comunicao
As opes disponveis nesta aba so as seguintes:
Opes disponveis na aba Erros de Comunicao
OPO DESCRIO
visualizar erros de
comunicaao
Habilita ou desabilita a visualizao dos erros de
comunicao.
Texto Contm o texto que ser mostrado no SetPoint, caso a
qualidade do valor seja ruim.
Cor da letra Contm a cor que deve ser usada no texto.
Cor de fundo 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.

E3 Manual do Usurio
Viewer 229
10.2. Variaveis 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 interno no
Viewer. Atravs do AppBrowser, podemos 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. Ob]eto 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. Voc vai observar que o Viewer mostrar o seu
filho nomeado como Top.

Figura 170: Objeto Top
E3 Manual do Usurio
230 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.


Banco de Dados 231

O Banco de Dados do E3 utilizado para armazenar as informaes do projeto
referentes a Histricos, Frmulas, Alarmes e E3Storage. 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 InserirBanco de Dados.

Figura 171: 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 Scripts:
Manual de Referncia do E3, em seu captulo respectivo.
Capitulo
11
11. Banco de Dados
E3 Manual do Usurio
232 Banco de Dados
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
InserirBanco 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 Banco de Dados Access
As opes disponveis nesta aba so:
Opes disponveis na aba Configurao
OPO DESCRIO
Banco de Dados Seleciona o tipo de Banco de Dados em uso no
projeto: 0 - stAccess; 1 - stOracle; ou 2 -
stSqlServer.
Arquivo NDB Nome do arquivo .mdb utilizado no projeto.
Senha do BD Senha do Banco de Dados Access.
Usuario Usurio do Banco de Dados conectado pelo E3.
Senha Senha do usurio que realizar o logon.
Testar conexao 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).
E3 Manual do Usurio
Banco de Dados 233
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.
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. Abaixo 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
InserirBanco 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 173: Configuraes para Banco de Dados Oracle
E3 Manual do Usurio
234 Banco de Dados
As opes disponveis nesta aba so:
Opes disponveis na aba Configurao
OPO DESCRIO
Banco de Dados Seleciona o tipo de Banco de Dados em uso no
projeto: 0 - stAccess; 1 - stOracle; ou 2 -
stSqlServer.
Conexao Nome da conexo disponibilizada pelo administrador
do banco.
Usar tipo T!NESTANP Permite usar o tipo de dado do Oracle, com preciso
de milissegundos.
Usar drivers ADO Oracle Permite usar as interfaces do Oracle para fazer
consultas a este banco de dados.
Usuario Usurio do Banco de Dados conectado pelo E3.
Senha Senha do usurio que realizar o logon.
Testar conexao Testa a conexo com o Banco de Dados

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 8cripts
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
E3 Manual do Usurio
Banco de Dados 235
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 abaixo:

Set DBConnection = CreateObject("ADODB.Connection")_
DBConnection.Open "Provider=MSDAORA;_
DataSource=conexaoOracle;User_
ID=UserID;Password=passwd"

Depois da criao da conexo, possvel executar um comando SQL diretamente
sobre a conexo, como mostrado abaixo:

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 abaixo:


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
NoveNext e NovePrev, bem como uma srie de outros comando disponibilizados
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
E3 Manual do Usurio
236 Banco de Dados
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 E3Storage. 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 8ervidor 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.
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.
E3 Manual do Usurio
Banco de Dados 237

E3 Manual do Usurio
238 Banco de Dados
11.3. Banco de Dados 8OL 8erver
Atravs desta opo possvel armazenar dados no Banco de Dados SQL Server.
11.3.1. Acessando o Banco de Dados 8OL 8erver 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
InserirBanco 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 174: Configuraes para o Banco de Dados SQL Server
As opes disponveis nesta aba so:
E3 Manual do Usurio
Banco de Dados 239
Opes disponveis na aba Configurao
OPO DESCRIO
Banco de Dados Seleciona o tipo de Banco de Dados em uso no
projeto: 0 - stAccess; 1 - stOracle; ou 2 -
stSqlServer.
Servidor Nome do servidor
Banco de Dados Nome do Banco de Dados.
Usuario 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 Senha do usurio que realizar o logon.
Testar conexao 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 8OL 8erver 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.
E3 Manual do Usurio
240 Banco de Dados

Figura 175: Histrico e suas configuraes
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 edite-as no E3Query e tambm no Query Analyzer. Os
resultados devero ser os mesmos, se o domnio estiver parado, ou
semelhantes, se o domnio estiver rodando. Essa diferena deve-se
atualizao constante do Banco de Dados quando o domnio est sendo
executado. Para a edio de consultas no E3Query, habilite a opo
Habilita edio direta do SQL.
11.3.3. Uso de ADODB para acesso via 8cript
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:

E3 Manual do Usurio
Banco de Dados 241
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. Ob]etos 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 abaixo:
Permisses
OBJETO PERMISSES
Frmulas Permisso completa
Histrico de usuario Escreve e consulta as tabelas existentes
Histrico Permisso completa
Servidor de Alarmes 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.


Alarmes 243

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 abaixo 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
InserirConfigurao de Alarmes.

Figura 176: Inserindo o objeto Configurao de Alarmes

Capitulo
12
12. Alarmes
E3 Manual do Usurio
244 Alarmes
12.1.1. Areas de Alarme
As reas de Alarme permitem agrupar um conjunto de Fontes de Alarmes, bem
como outras reas. Isto facilita o gerenciamento, operao e monitorao de um
conjunto de fontes de alarmes relacionadas, como por exemplo:
Filtrar o conjunto de alarmes visveis no sumrio;
Habilitar/desabilitar um conjunto de Fontes de Alarmes;
Reconhecer de um conjunto de Fontes de Alarmes;
Verificar o total de alarmes ativos e/ou no-reconhecidos de um conjunto
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, ou clique no cone
da janela de visualizao dos alarmes.

Figura 177: Inserindo uma rea
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
E3 Manual do Usurio
Alarmes 245
funcionalidades das propriedades deste objeto podem ser encontradas no
Scripts: Manual de Referncia do E3, em seu captulo referente.
12.1.2. Fontes de Alarme
Todas as informaes relativas s condies de alarme so definidas nas Fontes de
Alarmes, bem como o tipo 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.
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 178: Fontes de Alarmes
E3 Manual do Usurio
246 Alarmes
Ao abrir a Janela de Propriedades de qualquer fonte de alarme e escolher a aba
Fonte, a seguinte janela aberta:

Figura 179: 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:
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:
E3 Manual do Usurio
Alarmes 247
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 180: Fonte de Alarme Analgico
As opes disponveis so as seguintes:
Opes disponveis na aba Analgico
OPO DESCRIO
Habilitaao (LoLo, Lo,
Hi, HiHi)
Habilita a verificao do tipo de alarme escolhido.
Limite Indica o nvel em que o alarme ser disparado.
Texto da mensagem Permite especificar o texto que ser mostrado para o
usurio quando o alarme estiver em condio ativa.
Severidade Determina a severidade do nvel de alarme (alta, mdia
ou baixa).
Pede Ack Habilita/desabilita o reconhecimento do alarme.
Espera Especifica o tempo de espera, em ms. Quando o valor
for 0 (padro), no aplicada espera.
Banda morta 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.
voltar ao normal Permite especificar o texto a ser mostrado para o usurio
quando o alarme no estiver em condio ativa.

E3 Manual do Usurio
248 Alarmes
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 181: Fonte de Alarme Digital
As opes disponveis so as seguintes:
Opes disponveis na aba Digital
OPO DESCRIO
Alarme Digital Habilita o alarme digital.
valor de Alarme Determina o valor booleano do alarme (True/False).
Texto da mensagem Permite especificar o texto que ser mostrado para o
usurio quando o alarme estiver em condio ativa.
Severidade Determina a severidade do nvel de alarme (alta,
mdia ou baixa).
Pede Ack Habilita/desabilita o reconhecimento do alarme.
Espera Especifica o tempo de espera, em ms. Quando o valor
for 0 (padro), no aplicada espera.
voltar ao normal Permite especificar o texto a ser mostrado para o
usurio quando o alarme no estiver em condio
ativa.

E3 Manual do Usurio
Alarmes 249
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 182: 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.

Figura 183: Fonte de Alarme Banda Morta
E3 Manual do Usurio
250 Alarmes
As opes disponveis so as seguintes:

Opes disponveis na aba Banda Morta
OPO DESCRIO
SetPoint Associao para a varivel de referncia, para que seja
monitorada uma diferena em relao varivel de
monitorao.
BN (Banda Norta) 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.
valor Indica a diferena entre a varivel monitorada e o SetPoint,
a partir do qual deve ser indicado o alarme. Deve ser
informado em unidades de engenharia da varivel
monitorada.
Texto da mensagem Permite especificar o texto que ser mostrado para o
usurio quando o alarme estiver em condio ativa.
Severidade Determina a severidade do nvel de alarme (alta, mdia ou
baixa)
Pede Ack Habilita/desabilita o reconhecimento do alarme.
Espera Especifica o tempo de espera, em ms. Quando o valor for 0
(padro), no aplicada espera.
voltar ao normal Permite especificar o texto a ser mostrado para o usurio
quando o alarme no estiver em condio ativa.
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.
E3 Manual do Usurio
Alarmes 251

Figura 184: Fonte de Alarme Taxa de Variao
As opes disponveis so as seguintes:
Opes disponveis na aba Taxa de Variao
OPO DESCRIO
TDv Habilita a verificao do alarme Taxa de variao.
variaao por Segundo: Indica a porcentagem da varivel monitorada que
pode variar por segundo. Este valor calculado
tomando como base cada intervalo de leitura da
varivel, pela frmula: ROC ou TDV = (ValorAtual -
ValorAnterior) / (InstanteAtual - InstanteAnterior).
Se o ROC for maior que a taxa especificada, ser
considerado estado de alarme.
Texto da mensagem Permite especificar o texto que ser mostrado para o
usurio quando o alarme estiver em condio ativa.
Severidade Determina a severidade do nvel de alarme (alta,
mdia ou baixa)
Pede Ack Habilita/desabilita o reconhecimento do alarme.
Espera Especifica o tempo de espera, em ms. Quando o valor
for 0 (padro), no aplicada espera.
voltar ao normal Determina a mensagem de texto que ser mostrada ao
usurio quando o alarme voltar ao estado normal.
12.2. 8ervidor 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.
E3 Manual do Usurio
252 Alarmes
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 estes procedimentos:
Clique com o boto direito do mouse sobre o nome do projeto no
Organizer e selecione a opo InserirServidor 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.

Figura 185: Configuraes do Servidor de Alarmes
Cada campo da aba Configurao possui uma propriedade correspondente. As
opes disponveis so as seguintes:
E3 Manual do Usurio
Alarmes 253
Opes disponveis na aba Configurao
OPO DESCRIO
Guarde alarmes no
Banco de Dados
Habilita/desabilita o armazenamento dos dados dos
alarmes no Banco de Dados. Este campo equivale
propriedade Logging.
Utilize o servidor de
banco de dados
Define o servidor de Banco de Dados que armazenar os
dados do alarme. Este campo equivale propriedade
DataSource.
Descarta dados da
tabela principal
Habilita/desabilita o descarte de dados da tabela
principal. O dado ser antigo de acordo com o que for
definido na opo Nantenha os dados do(s)
ultimo(s).... Este campo equivale propriedade
EnableDiscard.
Nantenha os dados
do(s) ultimo(s)...
< Tabela Principal >
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.
A verificaao deve
ocorrer a cada...
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.
Dados descartados
devem ser
armazenados
Habilita/desabilita o armazenamento dos dados
descartados na tabela secundria (tabela de backup). Este
campo equivale propriedade EnableBackupTable.
Nantenha os dados
do(s) ultimo(s)...
< Tabela de Backup >
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 Nantenha os dados do(s)
ultimo(s)... da Tabela Principal. Este campo equivale
propriedade BackupDiscardInterval, e o campo de
seleo da unidade de tempo do intervalo equivale
propriedade BackupDiscardTimeUnit.
Campos... Determina quais campos dos eventos de alarme sero
adicionados tabela de alarmes, e na ordem em que estas
colunas aparecero.
Gerar Tabela 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:

E3 Manual do Usurio
254 Alarmes
Opes disponveis para tabelas dos Campos dos alarmes
OPO DESCRIO
Acked
(Reconhecido)

Informa se o alarme foi reconhecido ou no. Este
campo pode assumir os seguintes valores: 0: no-
reconhecido; 1: reconhecido.
AckRequired
(Necessita
Reconhecimento)
Determina o reconhecimento automtico do alarme.
Este campo apresenta os seguintes valores: 0:
reconhecimento automtico; 1: reconhecimento
manual.
AckTime
(DataHora - Reconhecido)

Registra a data/hora do E3 no momento em que o
alarme reconhecido, ou zero (30/12/1899), enquanto
o alarme no tenha sido reconhecido. No caso de
alarmes que no pedem reconhecimento, o campo
assume a data/hora do E3 no momento em que o
alarme fica ativo.
AckTimeDbl
(DataHora - Reconhecido
- Double)
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.
Actor!D
(Operador)

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 amarzenado no Banco
de Dados de 50 caracteres.
AlarmSourceName
(Nome da Fonte)

Registra o nome da fonte de alarme. O limite deste
campo quando amarzenado no Banco de Dados de
100 caracteres. Ex: FonteAlarme1
Area
(Area)

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 amarzenado no
Banco de Dados de 100 caracteres.
ChangeNask (Nascara) No usado (o valor sempre 0).
ConditionActive (Condiao
Ativa)

Indica se a fonte de alarmes est em alarme. Este
campo apresenta os seguintes estados: 0: condio
no-ativa; 1: condio ativa.
E3 Manual do Usurio
Alarmes 255
ConditionName
(Nome da Condiao)

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 .O limite deste
campo quando amarzenado no Banco de Dados de
100 caracteres.
Cookie
(Cookie)
Valor associado fonte de alarme, usado
internamente pelo servidor de alarmes.
Currentvalue
(valor)

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 amarzenado no Banco de Dados de 100
caracteres.
Enabled
(Habilitado)

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.
EventCategory
(Categoria)

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 amarzenado no Banco
de Dados de 100 caracteres.
EventTime
(DataHora)
Data/hora do valor da fonte do alarme no momento
do evento.
EventTimeDbl
(DataHora - Double)
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.
EventTimeUTC
(DataHoraUTC)
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
E3 Manual do Usurio
256 Alarmes
mantido no E3 por questes de compatibilidade.
EventType
(Tipo)

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 amarzenado no Banco de Dados de 100
caracteres.
Formattedvalue
(valor Formatado)
Mostra o valor formatado da fonte de alarme que vai
para o seu evento. O limite deste campo quando
amarzenado no Banco de Dados de 100 caracteres.
Obs.: Este campo somente de leitura.
FullAlarmSourceName
(Nome da Fonte -
Completo)

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
!nTime
(Data - Entrada)
Registra a data/hora do valor no momento em que ele
entra na condio de alarme.
!nTimeDbl
(Data - Entrada - Double)
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.
Nessage
(Nensagem)
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 amarzenado
no Banco de Dados de 200 caracteres.
OutTime
(DataHora - Saida)
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.
OutTimeDbl
(DataHora - Saida -
Double)
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.
Quality
(Qualidade)

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 . Exemplo: Ruim (0); Incerta
(64); ?? (128); Boa (192).
Severity
(Severidade)

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().
E3 Manual do Usurio
Alarmes 257
Source
(Fonte)

Para eventos de alarme, informa a expresso utilizada
para avaliar as condies de alarme. O limite deste
campo quando amarzenado no Banco de Dados de
100 caracteres. Ex: Dados.TagDemo1.Value.
SubConditionName
(Nome da Subcondiao)

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 . O
limite deste campo quando amarzenado no Banco de
Dados de 100 caracteres.
Campos do Usuario
(UserField1, UserField2,
UserField3, UserField+)
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 EventTimeNS, !nTimeNS, OutTimeNS e AckTimeNS contm os
valores em milissegundos dos campos EventTime, !nTime, 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 DataHora.
Depois de definidas todas as configuraes, o sistema inicializa as inseres e
gravaes das informaes na tabela dos alarmes, conforme as especificaes nos
campos. Quando o boto [Gerar tabela] clicado, o sistema gera a tabela de dados
dos alarmes conforme as suas especificaes, e informa se a tabela foi gerada com
sucesso.

Figura 186: Mensagem Servidor de alarmes
E3 Manual do Usurio
258 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).

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.
E3 Manual do Usurio
Alarmes 259
12.2.2. Configuraes dos Campos do Usuario
Na aba Campos do Usurio permite adicionar valores arbitrrios aos eventos de
alarmes.

Figura 188: Campos do usurio
As opes disponveis so as seguintes:
Opes disponveis na aba Campos do usurio
OPO DESCRIO
Campo Identificador do campo.
Nome Determina o nome do campo.
Tipo Determina o tipo do campo (Text, Integer, DateTime ou Double).
Tamanho Determina o tamanho do campo.
Fonte Determina a fonte de dados do alarme.



E3Alarm 261

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
InserirE3Alarm, 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.
Capitulo
13
13. E3Alarm

E3 Manual do Usurio
262 E3Alarm
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:
E3 Manual do Usurio
E3Alarm 263
Opes disponveis na aba Geral
OPES DESCRIO
Filtros 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. Este campo equivale propriedade Filter.
Nostre alarmes de
severidade
Habilita/desabilita a visualizao do grau da severidade (alta,
mdia ou baixa). Este campo equivale s propriedades
ShowHightPriority (alta), ShowMediumPriority (mdia) e
ShowLowPriority (baixa).
Filtrar por tipo Habilita o tipo de filtro aplicado no alarme (Apenas alarmes,
Apenas eventos, Alarmes e Eventos). Este campo equivale
propriedade FilterType.
Botao [Avanado| Determina se o alarme buscar os dados do servidor local ou
na rede.
Nome do Servidor
de alarmes
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.

Quando o boto [Avanado] acionado, o sistema mostra uma caixa de dilogo
para a configurao do domnio. O domnio identifica uma aplicao, que pode ser
local ou remota. Selecionando a opo No mesmo domnio da tela, possvel
habilitar a captura dos dados locais. Caso contrrio, habilitando a opo Em um
domnio diferente da tela, o E3Alarm buscar os dados do domnio indicado no
campo (Ex: \\Computer1\Projeto1.prj).

Figura 192: Configuraes Avanadas
E3 Manual do Usurio
264 E3Alarm
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 193: 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.

Figura 194: Propriedades da coluna
E3 Manual do Usurio
E3Alarm 265
As opes disponveis so as seguintes:
Opes disponveis na Aba Coluna
OPO DESCRIO
Esta coluna tera ... pixels
de largura
Determina a largura da coluna, em pixels. A largura
padro das colunas do E3Alarm 80 pixels.
Formatador Determina o formatador que ser utilizado na coluna
do E3Alarm.
Renomear para Renomeia o ttulo da coluna.
Permite reconhecer Permite configurar o reconhecimento do alarme
quando o usurio clicar sobre a linha da coluna
configurada. As opes disponveis so:
Nunca: O alarme no reconhecido
(padro).
Com clique: O alarme reconhecido
quando o usurio clica sobre a linha da
coluna
Com clique-duplo: O alarme
reconhecido quando o usurio d um
duplo-clique sobre a linha da coluna.
(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.)
Esta coluna nunca pisca Habilita/desabilita o piscar da coluna.

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.
E3 Manual do Usurio
266 E3Alarm

Figura 195: Aba Ordenao
Cada campo da aba Ordenao possui uma propriedade correspondente. As
propriedades disponveis so as seguintes:
Opes disponveis na aba Ordenao
OPO DESCRIO
Pelo campo Ordena os alarmes conforme o campo especificado. Este
campo equivale propriedade PrimarySortField.
Depois pelo campo 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 SecundarySortField.
Ascendente Ordena os campos do alarme de forma ascendente. Este
campo equivale propriedade PrimarySortAscending em
True.
Descendente Ordena os campos do alarme de forma descendente. Este
campo equivale propriedade PrimarySortAscending em
False.

NOTA: A ordenao padro feita atravs do campo InTime, de maneira
descendente.
E3 Manual do Usurio
E3Alarm 267
13.1.4. Configurao de Cores
Na aba Cores so definidas as cores de reconhecimento dos alarmes no objeto. Cada
item traz especificaes a respeito do status do alarme.

Figura 196: Aba Cores
Quando o boto [Cores...] clicado, uma caixa de dilogo mostrada, permitindo a
configurao das cores das Fontes de Alarmes que sero apresentadas no E3Alarm.
Esta caixa de dilogo varia de acordo com o tipo de alarme:
Alarme Ativo: Permite modificar a cor quando o alarme estiver ativo e
no-reconhecido. Ao clicar no boto [Cores...], o E3 abre a seguinte
caixa de dilogo:
E3 Manual do Usurio
268 E3Alarm

Figura 197: Cores do alarme ativo
As opes disponveis deste item so as seguintes:
Opes disponveis na janela Cores do alarme ativo
OPO DESCRIO
Cor de fundo Determina a cor de fundo do alarme ativo.
Cor de texto Determina a cor do texto do alarme ativo.
Piscar Pisca a cor do texto
Severidade baixa Habilita a configurao de cores para alarmes com
severidade baixa.
Severidade mdia Habilita a configurao de cores para alarmes com
severidade mdia.
Severidade alta Habilita a configurao de cores para alarmes com
severidade alta.
Cor do texto Define a cor de texto de cada tipo de severidade
(baixa, mdia e alta), caso no se queira utilizar a cor
padro (vermelho).

Alarme no reconhecido: Permite modificar a cor quando o alarme sair
da condio e no estiver reconhecido. Ao clicar no boto [Cores...], o
E3 abre a seguinte caixa de dilogo:
E3 Manual do Usurio
E3Alarm 269

Figura 198: Cores do alarme no-reconhecido
As opes disponveis deste item so as seguintes:
Opes disponveis na janela Cores do alarme no-reconhecido
OPO DESCRIO
Cor de fundo Determina a cor de fundo do alarme.
Cor de texto Determina a cor de texto do alarme.
Piscar Pisca a cor do alarme.

Alarme reconhecido: Permite modificar a cor do alarme quando este
tiver sido reconhecido. Ao clicar no boto [Cores...], o E3 abre a seguinte
caixa de dilogo:

Figura 199: Cores do alarme reconhecido
As opes disponveis deste item so as seguintes:
E3 Manual do Usurio
270 E3Alarm
Opes disponveis na aba Cores no alarme reconhecido
OPO DESCRIO
Cor de fundo Determina a cor de fundo do alarme.
Cor de texto Determina a cor de texto do alarme.
Piscar Pisca a cor do alarme.

13.1.5. Configurao de Fontes
Atravs da aba Fonte, possvel configurar a fonte do cabealho e das linhas do
E3Alarm.

Figura 200: Aba Fonte
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.
E3 Manual do Usurio
E3Alarm 271
13.2. Caracteristicas especificas de Runtime
O E3Alarm possui uma srie de caractersticas que se aplicam apenas em tempo de
execuo (runtime). Estas caractersticas sero explicadas abaixo.
13.2.1. Visualizando os Alarmes
Durante a operao de runtime, os alarmes do sistema podem ser visualizados no
E3Alarm.

Figura 201: E3Alarm em execuo
Dentre os alarmes que satisfazem os filtros configurados, so mostrados no E3Alarm
aqueles que estiverem em condio ativa e/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.
E3 Manual do Usurio
272 E3Alarm
13.2.2. Reconhecimento de Alarmes
Na configurao padro, ao clicar com o boto direito do mouse sobre o E3Alarm,
mostrado um menu de contexto com a opo Reconhecimento. Ao selecionar esta
opo, mostrada a seguinte caixa de dilogo:

Figura 202: Opes de reconhecimento de alarmes
As opes disponveis so as seguintes:
Opes disponveis na janela Reconhecimento de Alarmes
OPO DESCRIO
Reconhece apenas os
alarmes selecionados
Somente os alarmes selecionados sero reconhecidos.
Reconhece todos os
alarmes do filtro corrente
Todos os alarmes visveis neste E3Alarm sero
reconhecidos.
Reconhece globalmente
todos os alarmes
Todos os alarmes do domnio sero reconhecidos.

A opo Reconhecer apenas os alarmes selecionados s fica disponvel
se realmente houver alarmes selecionados no E3Alarm em questo. O
usurio poder reconhecer o alarme (neste caso, ser inserido um novo
registro no Banco de Dados indicando o reconhecimento), e no E3Alarm
a linha correspondente indicar que ele foi reconhecido. Esta opo estar
desabilitada caso a propriedade AllowAckSelected 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.
E3 Manual do Usurio
E3Alarm 273
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/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 Scripts: Manual de
Referncia.

Figura 203: Exemplo de ordenao
Na figura acima, os alarmes esto ordenados primeiro por rea, de forma
ascendente, e depois por DataHora (Entrada), tambm de forma ascendente.



Histricos 275

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 e/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 InserirHistrico.

Figura 204: Inserindo um Histrico
Capitulo
14
14. Histricos
E3 Manual do Usurio
276 Histricos
Quando o Histrico for habilitado, as seguintes opes de configurao
so apresentadas:

Figura 205: Opes do Histrico
As opes disponveis so as seguintes:
Opes disponveis na view do Histrico
BOTO DESCRIO

Adiciona campos na tabela do Histrico.

Remove o campo selecionado da tabela do Histrico.

Determina as configuraes da tabela do Histrico.

Gera a estrutura no Banco de Dados.

Cria uma chave-primria.

Configura os ndices que sero criados no histrico.

Mantm o Histrico sem vnculos diretos com a tabela existente.

Busca os campos na tabela original.

Vincula o Histrico a uma tabela j existente.

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 Scripts: Manual de Referncia, no
captulo referente ao objeto Histrico.
E3 Manual do Usurio
Histricos 277
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 pega a hora atual do sistema para a gravao.
Para criar a tabela no histrico, importante que seus campos sejam previamente
criados atravs do boto (Adicionar campo).
Para remover algum campo indesejado, clique no Boto (Remover campo). A
seguinte mensagem de confirmao aparecer:


Figura 206: Mensagem: 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 Primaria
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
E3 Manual do Usurio
278 Histricos
nico campo no capaz de atuar como chave primria porque ele apresenta valores
repetidos. Alm disso, uma tabela pode ter somente uma Chave Primria, seja ela
simples ou composta. Ou seja, no 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 , que abre a janela de
configurao, conforme abaixo:

Figura 207: Editando um ndice Chave Primria
Nesta caixa de dilogo, basta selecionar o campo desejado como Chave primria.
E3 Manual do Usurio
Histricos 279
As opes disponveis deste item so as seguintes:
Opes disponveis na janela Edio de ndices
OPO DESCRIO
Nome do indice Determina o nome da chave primria.
Garantir que os valores deste
indice sejam unicos
Se habilitada, faz com que os valores especificados
para o ndice Chave Primria sejam nicos.
Nome do campo Mostra o nome do campo.
Ordenaao Mostra a ordenao do campo selecionado.
Tipo Mostra o tipo do campo da tabela.
Nude a ordem dos campos 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 array ordenado contendo valores que so criados concatenando-se
valores de colunas indexadas.
E3 Manual do Usurio
280 Histricos
Os ndices pode ser configurados atravs do cone , que abrir a janela de
configurao, conforme figura abaixo:

Figura 208: Editor de ndices
As opes disponveis deste item so as seguintes:
Opes disponveis na janela Editor de ndices
OPO DESCRIO
Nome Mostra o nome do ndice existente.
Campos Mostra o campo ao qual o ndice est associado na tabela.
Botao [Adiciona|r Abre uma caixa de dilogo para a adio de um ndice.
Botao [Editar| Abre uma caixa de dilogo para a edio do ndice
selecionado.
Botao [Remover| Remove o ndice selecionado.

E3 Manual do Usurio
Histricos 281
Quando o boto [Adicionar] clicado, a seguinte caixa de dilogo aberta:

Figura 209: Adicionando ndices
As opes disponveis deste item so as seguintes:
Opes disponveis na adio de ndices
OPO DESCRIO
Nome do indice Determina o nome do ndice.
Garantir que os valores deste
indice sejam unicos
Se habilitada, faz com que os valores especificados
para o ndice sejam nicos.
Nome do campo Mostra os nomes dos campos. Marque aqueles que
devem pertencer ao ndice.
Ordenaao Mostra a ordenao do campo selecionado
(Ascendente ou Descendente).
Tipo Mostra o tipo do campo da tabela.
Nude a ordem dos campos Muda a posio do campo na tabela, fazendo com
que ele suba ou desa.

Clicando no boto [OK], os ndices na tabela so confirmados. Para cancelar a
configurao, clique no boto [Cancelar].
E3 Manual do Usurio
282 Histricos
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:

Figura 210: Propriedades do Histrico
Cada campo da aba Histrico possui uma propriedade correspondente. As opes
disponveis so as seguintes:
E3 Manual do Usurio
Histricos 283
Opes disponveis na aba Histrico
OPO DESCRIO
Utilize o servidor de
banco de dados
Define o servidor de Banco de Dados. Este campo
equivale propriedade DbServer.
Nome da tabela Determina o nome da tabela. Este campo equivale
propriedade TableName.
Gravar um novo
registro a cada...
Determina a variao do intervalo de tempo (em ms), ou
seja: de quanto em quanto tempo os dados do Histrico
seo gravados na tabela. Este campo equivale
propriedade ScanTime.
Descarta dados da
tabela principal
Habilita/desabilita o descarte dos dados da tabela
principal. O dado ser "antigo" de acordo com o que for
definido na opo Nantenha os dados do(s)
ultimo(s).... Este campo equivale propriedade
EnableDiscard.
Nantenha os dados
do(s) ultimo(s) ...
<Tabela Principal>
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.
A verificaao deve
ocorrer a cada...
Determina o intervalo (minutos, horas, dias ou meses)
de descarte de dados antigos da tabela. Este campo
equivale propriedade VerificationUnit.
Dados descartados
devem ser
armazenados
Habilita/desabilita o armazenamento dos dados
descartados na tabela secundria (tabela de backup).
Este campo equivale propriedade EnableBackupTable.
Nantenha os dados
do(s) ultimo(s)...
<Tabela de Backup>
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 Nantenha os dados do(s)
ultimo(s)... da Tabela Principal. Este campo equivale
propriedade BackupDiscardInterval, e o campo de
seleo da unidade de tempo do intervalo equivale
propriedade BackupDiscardTimeUnit.
Gerar Tabela 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.

E3 Manual do Usurio
284 Histricos
Quando a opo Gerar Tabela acionada, o sistema mostra a seguinte mensagem:

Figura 211: 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.

Figura 212: Campos
E3 Manual do Usurio
Histricos 285
Os campos disponveis na tabela do histrico so as seguintes:
Campos da tabela do Histrico
CAMPOS DESCRIO
FieldDeadBand Banda morta.
FieldDeadBandUnit Unidade utilizada pela banda morta (em valores absolutos ou
porcentagem).
FieldDescription Descrio do campo.
FieldEU Unidade de Engenharia.
FieldHighEng Limite superior do tag.
Field!D ndice do campo cadastrado no Histrico.
FieldLowEng Limite inferior do tag.
FieldNaxRecTime Depois que esse tempo expira, o dado deve ser
automaticamente gravado.
FieldNinRecTime Valor mnimo de tempo de variao para armazenamento de
um dado.
FieldName Nome do campo do Histrico.
FieldQuality 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.
FieldSize Tamanho do campo.
FieldSource Associao utilizada pelo campo para obter os seus valores.
FieldType Tipo do campo.

A opo Vincular Histrico a uma tabela j existente vincula o Histrico a
tabelas existentes no Banco de Dados. Quando esta opo habilitada, o sistema
abre uma caixa de dilogo para determinar quais as tabelas sero vinculadas ao
histrico corrente, conforme figura abaixo:

Figura 213: Seleo de tabela para vinculo com Histrico
E3 Manual do Usurio
286 Histricos
Quando a tabela selecionada e clicado no boto [OK], o sistema mostra a
seguinte mensagem:

Figura 214: Mensagem do sistema
Clicando em Cancel, os campos configurados na tabela iro permanecer com as
configuraes atuais. J clicando em OK, todos os campos, ndices e chaves
primrias definidas no Histrico sero substitudos pelos dados da tabela
selecionada.
Quando este item utilizado, outros dois botes so habilitados: Manter
Histrico sem vnculos diretos com tabela existente e Buscar campos da
tabela original.
Quando a opo Manter Histrico sem vnculos diretos com tabela existente
habilitada, o sistema mostra a seguinte mensagem:

Figura 215: 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 216: Histrico aps a habilitao da opo Manter histricos sem vnculo direto com a tabela existente
E3 Manual do Usurio
Histricos 287
J a opo Buscar campos da tabela original recupera os dados do histrico
vinculado tabela existente que haviam sido apagados:

Figura 217: Histrico utilizando a opo Buscar campos da tabela original


Storage 289

O E3Storage 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, Access 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 E3Storage 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.
Capitulo
15
15. E38torage
E3 Manual do Usurio
290 Storage
Grfico sem compactao
A informao processada contm vrios pontos.

Figura 218: Grfico sem comparao
Grfico com compactao
Veja que a informao praticamente a mesma, s que com menos pontos.

Figura 219: Grfico com compactao
E3 Manual do Usurio
Storage 291
A gravao no E3Storage feita da seguinte maneira:
Aps a definio da tabela nas propriedades do E3Storage, 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 FieldNinRecTime).
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 E3Storage.
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 Scripts: Manual de Referncia.
15.2. Configuraes do E38torage
Quando o E3Storage criado na tela, mostrada uma lista de definies dos campos
de gravao.

Figura 220: Campos configurados para o E3Storage
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).
Logo, se expresses no estiverem sendo utilizadas no campo fonte, no h
necessidade de se importar com o nome do campo.
E3 Manual do Usurio
292 Storage
As opes disponveis so as seguintes:
Opes disponveis na view do E3Storage
OPO DESCRIO

Adiciona campos na tabela do E3Storage.

Remove o campo selecionado na tabela do E3Storage.

Determina as configuraes da tabela do E3Storage.

Gera a estrutura no Banco de Dados.
Nome Determina o nome do campo da tabela do E3Storage.
Tipo Determina o tipo do campo da tabela do E3Storage.
Fonte Determina a fonte de dados que ser associada ao campo.
NinRecTime Tempo mnimo para insero de um dado na tabela. Este tempo
calculado em milissegundos.
NaxRecTime Tempo mximo de espera por um dado. Se passar esse tempo, o
dado passa a ficar antigo e armazenado.
Banda Norta Banda morta para clculo do algoritmo.
Unidade Valor absoluto ou a porcentagem de modificao.


E3 Manual do Usurio
Storage 293
15.3. Configurao da Tabela
Podemos acessar as configuraes da tabela utilizada no E3Storage 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 E3Storage
Cada campo da aba E3Storage possui uma propriedade correspondente. As opes
disponveis so as seguintes:
E3 Manual do Usurio
294 Storage
Opes disponveis na aba Storage
OPO DESCRIO
Utilize o servidor de banco de
dados
Define o servidor de Banco de Dados. Este campo
equivale propriedade DbServer.
Nome da tabela Determina o nome da tabela. Este campo equivale
propriedade TableName.
Descarta dados da tabela
principal
Habilita/desabilita o descarte dos dados da tabela
principal. O dado ser "antigo" de acordo com o que
for definido na opo Nantenha os dados do(s)
ultimo(s).... Este campo equivale propriedade
EnableDiscard.
Nantenha os dados do(s)
ultimo(s)...
<Tabela Principal>
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.
A verificaao deve ocorrer a
cada...
Determina o intervalo (minutos, horas, dias ou meses)
de descarte de dados antigos da tabela. Este campo
equivale propriedade VerificationUnit.
Dados descartados devem
ser armazenados
Habilita/desabilita o armazenamento dos dados
descartados na tabela secundria (tabela de backup).
Este campo equivale propriedade
EnableBackupTable.
Nantenha os dados do(s)
ultimo(s)...
<Tabela de Backup>
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 Nantenha os
dado(s) dos ultimo(s)... da Tabela Principal. Este
campo equivale propriedade
BackupDiscardInterval, e o campo de seleo da
unidade de tempo do intervalo equivale propriedade
BackupDiscardTimeUnit.
Gerar Tabela 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.
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
E3Storage semelhante a do Histrico: uma tabela de definies, uma tabela
principal de dados e uma tabela de backup (se escolhida pelo usurio). Para que
possamos identificar externamente que uma tabela compactada, s verificar se
foi criada a tabela _Fields.
E3 Manual do Usurio
Storage 295

Figura 222: Tabela Fields
Esta tabela possui os seguintes campos:
Campos da tabela _Fields
CAMPOS DESCRIO
FieldDeadBand Banda morta.
FieldDeadBandUnit Unidade da banda morta. Em porcentagem do valor anterior
ou porcentagem dos limites de engenharia (valor fixo).
FieldDescription Descrio do campo.
FieldEU Unidade de Engenharia.
FieldHighEng Limite superior do tag.
Field!D ndice do campo cadastrado no E3Storage.
FieldLowEng Limite inferior do tag.
FieldNaxRecTime Depois que esse tempo expira, o dado deve ser
automaticamente gravado.
FieldNinRecTime Valor mnimo de tempo de variao para armazenar dados.
FieldName Nome do campo.
FieldQuality Qualidade do campo.
FieldSize Tamanho do campo.
FieldSource Associao utilizada para obter valores deste campo.
FieldType Tipo do campo.

A implementao do E3Storage 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, exibiremos a seguir o formato das tabelas.
E3 Manual do Usurio
296 Storage
As opes de gerenciamento de tabelas especificadas no item anterior se aplicam na
verdade a trs conjuntos de tabelas geradas pelo E3Storage, de acordo com o campo
Nome de Tabela.
Isto porque, para cada tipo de grandeza armazenada, gerado automaticamente um
conjunto de tabelas, a saber: um conjunto para os tags analgicos, outro para os
textos e mais outro para os digitais. Dessa forma, cada E3Storage 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 E3Storage, 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 E3Storage 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.
E3 Manual do Usurio
Storage 297
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.


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 nternas {E3Ouery}
A ferramenta E3Query prev algumas facilidades para realizar consultas nos dados
do E3Storage.
Ao iniciar a configurao de uma consulta (E3Query) em uma aplicao que possui
um E3Storage, este objeto entra na lista de Bancos de Dados disponveis para
consulta. Isto porque o E3Storage 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 E3Storage como provedor de dados para a
consulta, sua interface de configurao apresenta vrias diferenas, como pode ser
visto na figura abaixo. 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 7 funes para consolidao dos
dados, mostradas abaixo:

A
C
B
Tempo
Valor
A viola o BackSlope
B viola o BoxCar
C ser armazenado
BoxCar
BackSlope
ltimo Valor
Armazenado
E3 Manual do Usurio
298 Storage
LastValue: Retorna o ltimo valor armazenado na Base de Dados.
ArchivedValue: Retorna um valor armazenado em relao a um determinado
instante de tempo definido na varivel TimeStamp. O tipo de relao, definido na
propriedade FunctionSubType, pode ser Previous (Valor armazenado imediatamente
anterior ao TimeStamp fornecido), Next (Valor armazenado imediatamente posterior
ao TimeStamp), Interpolated (Valor calculado a partir do valor anterior e posterior) e
ExactTime (se for encontrado um valor armazenado no exato instante que foi
fornecido pelo TimeStamp). As variveis tambm podem ser definidas em execuo
a partir da chamada do mtodo SetVariableValue da Consulta.
TagAttribute: Devolve um atributo do Tag, definido em FunctionSubType, que
pode ser FieldDescription (Significado/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.
E3 Manual do Usurio
Storage 299

Figura 223: 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
E3 Manual do Usurio
300 Storage
15.3.4. Ferramentas de Consultas Externas {8tored
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
E3Storage, possvel realizar chamadas Stored Procedures, que so criadas pelo
E3Storage em seu Banco de Dados. Existem sete Stored Procedures, que
correspondem a algumas das opes de consulta exibidas abaixo:

FUNO E3QUERY STORED PROCEDURE
LastValue E3LastValue
ArchivedValue E3Archive, E3ArchiveInterpolate
CompressedDataNValues E3NCompData
CompressedDataStartEndTime E3CompData
SampledData E3SampledData
CalculatedData 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 abaixo:
CREATE FUNCTION E3GETFLOATVALUE (@dDate datetime)
RETURNS FLOAT AS
BEGIN
RETURN CAST(@dDate AS float)
END
Abaixo, alguns exemplos da utilizao desta funo.

E3 Manual do Usurio
Storage 301
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 queiraa 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

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)

E3 Manual do Usurio
302 Storage
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 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

E3 Manual do Usurio
Storage 303
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)

E3 Manual do Usurio
304 Storage
Onde:
@dStartData: a Data Inicial, em formato FLOAT;
@dEndData: a Data Final, em formato FLOAT;
@strOrder: quando desejar que a consulta seja ordenada por outro campo que no
seja o TimeStamp

Esta funo retorna o nmero de linhas encontrado no intervalo, com os campos
E3TimeStamp, Quality e FieldValue.
Exemplo de utilizao:
DECLARE @MyStartDate FLOAT
DECLARE @MyEndDate FLOAT
SET @MyStartDate = dbo.E3GETFLOATVALUE('10-10-2005
12:00:00')
SET @MyEndDate = dbo.E3GETFLOATVALUE('10-10-2006
12:00:00')
EXECUTE E3CompData 'STO22',
@MyStartDate,@MyEndDate,'Dados.TagDemo1', '','',2,0

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

E3 Manual do Usurio
Storage 305
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,
@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.TagDemo
1','',2,1

Consultas 307

O objeto Consulta (ou E3Query) 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 (Structure 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/inicial e consultas.
O Assistente da consulta responsvel por criar o texto que faz o filtro/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 InserirConsulta.
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 224: Definio do Servidor Banco de Dados
A configurao da consulta depende do objeto em que ela est relacionada.
Capitulo
16
16. Consultas
E3 Manual do Usurio
308 Consultas

Figura 225: 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 Scripts: Manual de Referncia.
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:
E3 Manual do Usurio
Consultas 309

Figura 226: Definio do Servidor Banco de Dados na Consulta
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 227: 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 destacamos cinco principais subdivises horizontais:
Funes gerais;
Tabelas;
E3 Manual do Usurio
310 Consultas
Colunas;
Sintaxe SQL;
Resultado ou prvia da consulta
A seguinte janela mostrada:

Figura 228: Configurao da Consulta
A janela acima 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, podemos destacar os seguintes elementos:

Figura 229: Funes Gerais
E3 Manual do Usurio
Consultas 311
Opes disponveis na janela Definio de Consulta
OPO DESCRIO
Botao [Adicionar
Tabela|
Permite que se retorne janela anterior adicionando uma ou
mais uma tabela.
Botao [Gerar Consulta| Executa a consulta SQL, exibindo os resultados na diviso
inferior da janela.
Editar variaveis Permite a definio de valores padro para variveis
definidas pelo usurio. Essas variveis tambm podem ter
seu valor alterado em execuo atravs do mtodo
SetVariableValue().
Habilitar ediao direta
no SQL
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 230: 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.
E3 Manual do Usurio
312 Consultas

Figura 231: Tabela
Por questes de performance, importante adicionar consulta somente os campos
que realmente interessam para a anlise.
16.4. Colunas
Na diviso de colunas, so mostrados os campos escolhidos.

Figura 232: Diviso de colunas
Nestes campos escolhidos so definidas as seguintes propriedades para cada um
deles:
E3 Manual do Usurio
Consultas 313
Opes disponveis para configurao de colunas
OPO DESCRIO
Colunas Mostra o nome das colunas selecionadas. Ao clicar neste campo,
podemos redefinir a coluna desejada.
Titulos Permite que um novo nome seja definido para a Coluna (tambm
conhecido como Alias).
Tabela Mostra o nome da tabela de origem do campo;
Nostrar Habilita/desabilita o campo;
Ordenaao Permite ordenar os valores: sem ordenao, ascendente (valores
menores primeiro) e descendente (valores maiores primeiro);
Ordem Define a prioridade quando mais de um campo possui ordenao;
Agrupado por Permite que os dados sejam agrupados a cada novo valor do
campo em questo;
Funao Permite definir a execuo de uma funo para o campo;
Filtro Define um critrio de consulta, como por exemplo, intervalos de
data.

Ao definir um filtro, a janela abaixo aparecer, permitindo que se defina o tipo de
comparao e o valor a ser comparado.

Figura 233: 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).
E3 Manual do Usurio
314 Consultas

Figura 234: 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;
O valor da varivel pode ser definido atravs do boto [Editar variaveis...] ou
atravs do mtodo SetVariableValue(), chamado via Script.
16.5. 8intaxe 8OL
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.
E3 Manual do Usurio
Consultas 315

Figura 235: 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 runtime e as modificaes de valores dos filtros definidos para a
consulta podem ser vistos no script abaixo. 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.
16.8. Uso de Record 8ets 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.



E3Browser 317

O E3Browser um controle ActiveX utilizado para visualizar dados armazenados
em Banco 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 236: 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 Scripts: Manual
de Referncia do E3, em seu captulo referente.

Capitulo
17
17. E3Browser
E3 Manual do Usurio
318 E3Browser
17.1. Ob]eto 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 (Structure Query Language).

Figura 237: 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.
E3 Manual do Usurio
E3Browser 319

Figura 238: Aba Consulta
Para maiores informaes sobre a Consulta, veja captulo Consultas.
17.2. Outras configuraes do E3Browser
As configuraes disponveis no E3Browser so os 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.
E3 Manual do Usurio
320 E3Browser

Figura 239: 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
OPO DESCRIO
Estilo de grade Determina o estilo da grade do E3Browser. Este campo
equivale a propriedade GridLinesType do E3Browser.
Altura do cabealho Determina a altura (em pixels) do cabealho do
E3Browser. Este campo equivale a propriedade
FixedRowHeight do E3Browser.
Largura da 1- coluna Determina a largura da 1- coluna na tabela. Este campo
equivale a propriedade FixedColumnWidth do
E3Browser.
Altura das linhas Determina a altura das linhas restantes na tabela. Este
campo equivale a propriedade RowHeight do
E3Browser.
Largura das colunas Determina a largura das colunas da tabela. Este campo
equivale a propriedade ColumnWidth do E3Browser.
E3 Manual do Usurio
E3Browser 321
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 240: Aba Opes
Cada campo da aba Opes possui uma propriedade correspondente. As
propriedades disponveis so as seguintes:
Opes disponveis na aba Opes
OPO DESCRIO
Atualizaao 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.
Tipo de seleao Determina o tipo de seleo na tabela do E3Browser. Este
campo equivale propriedade SelectRow do E3Browser.
E3 Manual do Usurio
322 E3Browser
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 241: Configuraes da aba Color
As opes disponveis deste item so as seguintes:
Opes disponveis da aba Cor
OPO DESCRIO
Propriedades Determina a cor conforme a propriedade selecionada.
Conjunto de cores Determina o conjunto de cores a ser utilizado: cores
padro ou cores do Windows.
Paleta de Cores Determina a cor da propriedade selecionada.
Editar cor personalizada Edita uma nova cor personalizada, diferente das cores
padro.

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

E3 Manual do Usurio
E3Browser 323
17.2.4. Configuraes da Fonte do E3Browser
Na aba Fonte, defina as especificaes de fontes no E3Browser.

Figura 242: 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.



E3Chart 325

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.
Cada seqncia de dados representada no E3Chart atravs das penas. As penas
podem ser acessadas, includas ou removidas atravs da Coleo de Penas. Para
cada pena so associados dados, que podem ser tags ou consultas. Cada consulta
pode ser criada, removida ou acessada atravs da Coleo de Consultas,
disponibilizando dados histricos para as penas, que podem ser filtrados e
organizados. possvel criar vrios eixos com diferentes escalas para serem
associados aos dados das penas.
A arquitetura do E3Chart a seguinte:


















Capitulo
18
18. E3Chart
Convenes:

Objeto


Coleo


Pena
Coleo de Penas
Legenda
Coluna da Legenda
Coleo de Consultas
Coleo de Eixos
Consulta
Eixo
E3Chart
E3 Manual do Usurio
326 E3Chart
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 243: Inserindo um E3Chart na Tela
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 Scripts: Manual de Referncia, 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 atribui-lhe uma
descrio.
E3 Manual do Usurio
E3Chart 327

Figura 244: Aba Item
Cada campo da aba Item possui uma propriedade correspondente. As opes
disponveis so:
Opes disponveis na aba Item
OPO DESCRIO
Nome Determina o nome do objeto. Este campo equivale
propriedade Name do E3Chart.
Documentaao Texto livre que possibilita a documentao das
funcionalidades e caractersticas do objeto pelo
programador do objeto. Este campo equivale propriedade
DocString do E3Chart.

A aba Posio determina o posicionamento do E3Chart na Tela.

Figura 245: Aba Posio
E3 Manual do Usurio
328 E3Chart
Cada campo da aba Posio possui uma propriedade correspondente. As opes
disponveis so as seguintes:
Opes disponveis na aba Posio
OPO DESCRIO
Posiao X Define a coordenada horizontal esquerda do objeto, em
unidades himtricas. Este campo equivale propriedade X
do E3Chart
Posiao Y Define a coordenada vertical superior do objeto, em
unidades himtricas. Este campo equivale propriedade Y
do E3Chart
Largura Determina a largura do objeto. Este campo equivale
propriedade Width do E3Chart.
Altura Determina a altura do objeto. Este campo equivale
propriedade Height do E3Chart.

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

Figura 246: Aba Geral
E3 Manual do Usurio
E3Chart 329
Cada campo da aba Geral possui uma propriedade correspondente. As opes
disponveis so as seguintes:
Opes disponveis na aba Geral
OPO DESCRIO
Nostrar titulo Exibe o ttulo do grfico. Este campo equivale
propriedade Title do E3Chart.
Nostrar o fundo do grafico
com a cor...
Determina a cor de fundo do grfico Este campo
equivale propriedade BackColor do E3Chart.
Nostrar o fundo da grade
com a cor...
Determina a cor de fundo da grade do grfico. Este
campo equivale propriedade GridBackColor do
E3Chart.
!ntervalo entre as
atualizaoes (segundos)
Determina intervalo entre as atualizaes do desenho
no grfico. Este campo equivale propriedade
RefreshTime do E3Chart.
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 247: 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 o boto [Adicionar], criado um novo eixo no grfico e aberta uma janela
de configurao que permite determinar as propriedades do objeto Eixo. Esta janela
E3 Manual do Usurio
330 E3Chart
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.


Figura 248: Propriedades do Eixo
Cada campo da aba Geral possui uma propriedade ou mtodo correspondente. As
opes disponveis so as seguintes:
E3 Manual do Usurio
E3Chart 331
Opes disponveis na aba Geral
OPO DESCRIO
Nome Determina o nome do eixo do grfico. Este campo
equivale propriedade Name do Eixo.
Posiao Determina a posio do eixo no grfico: direita ou
esquerda (eixo vertical), base ou topo (eixo
horizontal). Este campo equivale propriedade
Position do Eixo
Espelhar o eixo Mostra o eixo tambm do lado oposto ao escolhido,
com efeito de espelho. Este campo equivale
propriedade Mirror do Eixo
Titulo do eixo Determina o ttulo do eixo. Este campo equivale
propriedade Title do Eixo
Cor da escala Determina a cor da escala. Este campo corresponde
propriedade Color do objeto Eixo
visivel Determina a visibilidade do eixo no grfico. Este
campo equivale propriedade Visible do Eixo.
Cor das linhas da grade Determina a cor das linhas na grade. Este campo
equivale propriedade GridColor do Eixo.
Estilo da linha Determina o estilo da linha da grade do grfico. Este
campo equivale propriedade GridStyle do Eixo.
Nostrar as linhas na grade Habilita a visualizao das linhas na grade. Este
campo equivale propriedade ShowGrid do Eixo.
!ntervalo entre divisoes Determina o intervalo entre os marcadores da escala,
caso a opo Automatico 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.
Automatico Seleciona automaticamente o intervalo entre os
marcadores da escala. Este campo equivale ao
mtodo SetTickSpacing() do Eixo, com 0 (zero) no
valor do intervalo.
Numero de subdivisoes Determina o nmero de subdivises entre os
marcadores. Este campo equivale propriedade
MinorTicks do Eixo.

Clique [Apply] para visualizar as modificaes feitas nesta janela, e [OK] para salv-
las.
E3 Manual do Usurio
332 E3Chart
A aba Escala define as configuraes da escala do eixo.

Figura 249: Configuraes da escala do E3Chart
Cada campo da aba Escala possui uma propriedade ou um mtodo correspondente.
As opes disponveis so as seguintes:
E3 Manual do Usurio
E3Chart 333
Opes disponveis na aba Escala
OPO DESCRIO
Escala numrica 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.
Inverter: Inverte a ordem dos valores da
escala. Este campo equivale propriedade
Inverse do Eixo.
Nostrar ultimo periodo
(tempo real)
Mostra o intervalo de tempo que o eixo ir mostrar,
sempre em relao hora atual. Este campo equivale ao
mtodo SetRealTimePeriod() do Eixo.
!ntervalo de tempo
(histrico)
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.
Formataao Determina a formatao dos valores do eixo, que pode
ser automtica ou personalizada. Este campo
corresponde ao mtodo Format() do Eixo.

Clique [Apply] para visualizar as modificaes feitas nesta janela, e [OK] para salv-
las.

E3 Manual do Usurio
334 E3Chart
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 e/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.

Figura 250: 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 trs abas: Geral, Dados e Estilo.
E3 Manual do Usurio
E3Chart 335
A aba Geral contm a informao que identifica a pena no sistema.

Figura 251: Propriedades gerais da pena

Cada campo da aba Geral possui uma propriedade correspondente. As opes
disponveis so as seguintes:
Opes disponveis na aba Geral
OPO DESCRIO
Nome da Pena Indica o nome da pena. Este campo equivale propriedade
Name da Pena.
Cor Principal Determina a cor da linha da pena. Este campo equivale
propriedade Color da Pena.
visivel Indica o estado de visibilidade da pena no grfico. Este
campo equivale propriedade Visible da Pena.

Clique [Apply] para visualizar as modificaes feitas nesta janela, e [OK] para salv-
las.

E3 Manual do Usurio
336 E3Chart
A aba Dados contm a informao sobre o tipo da pena.

Figura 252: Propriedades do tipo da Pena
Cada campo da aba Dados possui uma propriedade correspondente. As opes
disponveis so as seguintes:
E3 Manual do Usurio
E3Chart 337
Opes disponveis na aba Dados
OPO DESCRIO
Tipo de Pena Determina o tipo de pena sendo utilizada. Este campo
equivale propriedade DataSourceType da Pena.
Link do Eixo vertical Nome do usado para plotar o dado em uma escala
vertical. Este campo equivale propriedade YLink da
Pena.
Link do Eixo Horizontal Nome da associao usada para plotar o dado em uma
escala horizontal. Este campo equivale propriedade
XLink da Pena.
Usar a estampa de
tempo
Habilita/desabilita a estampa de tempo. A estampa de
tempo o valor de tempo que acompanha o valor do tag,
indicando o momento em que este valor foi alterado.
Este campo equivale propriedade UseTimeStamp da
Pena.
Consulta Local Determina a consulta vinculada ao E3Chart que ser
utilizada nos dados do Eixo. Este campo equivale
propriedade QueryName da Pena.
Consulta Externa Determina a consulta externa, isto , os dados viro de
uma consulta fora do objeto E3Chart.
Campo do Eixo vertical Nome do campo da consulta usado para plotar o dado
em uma escala vertical. Este campo equivale
propriedade YField da Pena.
Campo do Eixo
Horizontal
Nome do campo da consulta usado para plotar o dado
em uma escala horizontal. Este campo equivale
propriedade XField da Pena..
Usar Consulta
Automatica
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 E3Storage, ou se possuir vrias
tabelas. Este campo equivale propriedade AutoQuery
da Pena.
Eixo vertical Especifica o eixo vertical. Este campo equivale
propriedade ScaleY da Pena.
Eixo Horizontal Especifica o eixo horizontal. Este campo equivale
propriedade ScaleX da Pena.

Clique [Apply] para visualizar as modificaes feitas nesta janela, e [OK] para salv-
las.
E3 Manual do Usurio
338 E3Chart
A aba Estilo determina o estilo da pena.

Figura 253: Estilo da Pena
Cada campo da aba Estilo possui uma propriedade correspondente. As opes
disponveis so as seguintes:
E3 Manual do Usurio
E3Chart 339
Opes disponveis na aba Estilo
OPO DESCRIO
Tipo de desenho Indica o tipo de desenho da pena. Este campo
equivale propriedade PenType da Pena.
Estilo do trao Determina o estilo do trao da pena. Este campo
equivale propriedade PenLineStyle da Pena.
Espessura da linha Determina a espessura da linha, em pixels. Este
campo equivale propriedade Width da Pena.
Cor do fundo Determina a cor de fundo da linha. Este campo
equivale propriedade BkColor da Pena.
Documentaao Determina a documentao que pode ser mostrada na
legenda. Este campo equivale propriedade
DocString da Pena.
Habilita alarme alto 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 alarme baixo 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 de alarme Cor da pena quando em alarme. Este campo equivale
propriedade LimitPenColor.
Cor de fundo do alarme Cor do fundo da pena quando em alarme. Este campo
equivale propriedade LimitPenBkColor.
Nanter na memria as
ultimas... amostras
Determina o nmero de amostras nas penas de tempo
real. Este campo equivale propriedade BufferSize da
Pena.
Nodo de ligaao entre os
pontos
Determina o estilo do desenho (analgico ou digital).
Este campo equivale propriedade DigitalData da
Pena.
valor considerado para o
scan de ... ms
Muda o estilo do desenho. Este campo equivale
propriedade ScanValue da Pena.

Clique [Apply] para visualizar as modificaes feitas nesta janela, e [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.
A aparncia da pena conforme a opo configurada nesta opo pode ser visualizada
abaixo:
E3 Manual do Usurio
340 E3Chart

Figura 254: Modo analgico de ligao entre os pontos

Figura 255: Modo digital de ligao entre os pontos

Figura 256: 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.
E3 Manual do Usurio
E3Chart 341
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 257: Objeto Legenda em runtime
Atravs da aba Legenda, possvel configurar as informaes referentes ao objeto
Legenda e suas colunas.

Figura 258: Propriedades do Objeto Legenda
Alguns campos da aba Legenda possuem uma propriedade ou mtodo
correspondente. As opes disponveis so as seguintes:
E3 Manual do Usurio
342 E3Chart
Opes disponveis na aba Legenda
OPO DESCRIO
Nostrar Legenda 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.
Tamanho Determina o tamanho da legenda, em pixels. Pode ser a
altura ou a largura, dependendo da posio. A outra
dimenso acompanha a do E3Chart. Este campo
corresponde propriedade Size da Legenda.
Colunas disponiveis Lista as colunas disponveis para visualizao na legenda.
As opes disponveis deste item so:
Cor da pena: Determina a cor da pena.
Descrio da pena: Mostra a descrio da
propriedade DocString da pena.
EscalaX: Mostra o nome do eixo X associado
pena.
EscalaY: Mostra o nome do eixo Y associado
pena.
Estado: Mostra o estado de funcionamento
atual da pena. Para maiores detalhes, veja
tpico Coluna Estado da Legenda.
Nome da pena: Nome da pena.
Nome do tagX: Mostra o nome do tag que foi
associado ao eixo X.
Nome do tagY: Mostra o nome do tag que foi
associado ao eixo Y.
Valor do tagX: Mostra o valor da pesquisa no
eixo X.
Valor do Tag Y: Mostra o valor da pesquisa
no eixo Y.
Colunas selecionadas Mostra as colunas selecionadas para a legenda.
Botao [Adicionar| Adiciona uma coluna legenda. Este boto equivale ao
mtodo InsertColumn() da Legenda.
Botao [Propriedades| Abre uma caixa de dilogo para a configurao das
propriedades dos campos das colunas da Legenda.
Botao [Remover| Remove a coluna selecionada da legenda. Este boto
equivale ao mtodo Remove() da Legenda.
SobefDesce Troca a posio da coluna na legenda. Estes campos
equivalem ao mtodo ChangeColumnPos() da Legenda
Nostrar titulos das
colunas
Habilita o cabealho da legenda. Este campo equivale
propriedade ShowHeader da Legenda.

E3 Manual do Usurio
E3Chart 343
Quando o Boto [Propriedades] clicado, mostrada uma caixa de dilogo para
configurao do objeto Coluna da Legenda.

Figura 259: 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
Largura inicial Define a largura inicial da coluna, em pixels. Este campo
equivale propriedade Width da Coluna da Legenda.
Titulo da coluna Determina o ttulo da coluna. Este campo equivale
propriedade Caption da Coluna da Legenda.
Alinhamento do texto Determina o alinhamento do texto na coluna da legenda,
Este campo equivale propriedade TextAlign da Coluna
da Legenda.
Formatador Determina o formatador da coluna selecionada. Este
campo equivale propriedade Format da Coluna da
Legenda.

E3 Manual do Usurio
344 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 configur-
las.

Figura 260: Configurao das Consultas
As opes disponveis so as seguintes:
Opes disponveis na aba Consultas
OPO DESCRIO
Consultas Mostra a consulta selecionada para edio.
Botao [Configurar| Configura a consulta selecionada.
Botao [Adicionar| Adiciona uma nova consulta. Para obter maiores
informaes referentes s consultas, veja captulo
Consultas.
Botao [Remover| Remove a consulta selecionada.

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.

E3 Manual do Usurio
E3Chart 345
18.1.6. Configurao das Fontes
Atravs da aba Fonte, possvel configurar a fonte do cabealho e das linhas do
E3Chart.

Figura 261: Aba Fonte
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/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;
E3 Manual do Usurio
346 E3Chart
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.
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
abaixo:
E3 Manual do Usurio
E3Chart 347

Figura 262: 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
Execute o projeto e veja o resultado.
E3 Manual do Usurio
348 E3Chart
18.2.3. Habilitando/desabilitando a visualizao da pena no
E3Chart
O exemplo a seguir demonstra como habilitar/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
Execute o projeto e veja o resultado.
E3 Manual do Usurio
E3Chart 349
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 abaixo 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
Execute o projeto e veja o resultado.
E3 Manual do Usurio
350 E3Chart
18.3. Caracteristicas especificas 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 263: Opes do menu do E3Chart em runtime
E3 Manual do Usurio
E3Chart 351
As opes disponveis so as seguintes:
Opes disponveis do menu do E3Chart em runtime
OPO DESCRIO
Caixa de zoom Coloca o mouse no modo zoom por rea selecionada Esta
opo est disponvel nos grficos de escala numrica em
XY e escala fixa.
Nover Coloca o mouse em modo de movimentao das escalas.
Nover
horizontalmente
Coloca o mouse em modo de movimentao das escalas
somente na direo horizontal.
Pesquisar Coloca o mouse em modo de pesquisa de valores nos dados
das penas.
Nenos Zoom Diminui o zoom de todo o Eixo.
Nais Zoom Aumenta o zoom de todo o Eixo.
Enquadrar tudo Enquadra a pena selecionada em ambos os Eixos.
Enquadrar
verticalmente
Enquadra a pena selecionada somente no Eixo vertical.
Enquadrar
horizontalmente
Enquadra a pena selecionada somente no Eixo horizontal.
Enquadrar Pena 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 264: A pesquisa mostrada nos campos Valor do TagX e Valor do TagY
E3 Manual do Usurio
352 E3Chart
NOTA1: Para obter maiores informaes sobre as colunas Valor do Tag X e Valor
do Tag Y, veja o tpico Configuraes da Legenda.
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
e/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.
<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.
E3 Manual do Usurio
E3Chart 353
<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 micro.
DICA: Trocando a propriedade CursorLocation para clClient, faz com que os dados
sejam baixados por etapas evitando o possvel problema de Timeout.


Frmulas 355

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: 50 g de acar, 1000 lts 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 InserirFrmula.

Figura 265: Inserindo um objeto Frmula na aplicao
Capitulo
19
19. Frmulas
E3 Manual do Usurio
356 Frmulas
19.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 266: Janela para configurao do Banco de Dados e da tabela
As opes disponveis so:
Opes disponveis na janela Configurao do Banco de Dados
OPO DESCRIO
Banco de Dados Determina o servidor de Banco de Dados que
gerenciar os dados configurados na Frmula.
Tabela Determina o nome da tabela.

Caso seja necessrio configur-los posteriormente, ou mesmo reconfigur-los, basta
escolher a opo Configurar Banco de Dados no menu.
E3 Manual do Usurio
Frmulas 357

Figura 267: Configurando o Banco de Dados
19.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 268: Aba Templates
As opes disponveis so as seguintes:
E3 Manual do Usurio
358 Frmulas
Opes disponveis na aba Templates
OPO DESCRIO
Nome Define o nome do template.
Tipo Define o tipo do template.
Restrioes Determina as restries do template.

A barra de ferramentas da view Templates tem os seguintes botes: Adicionar ,
para a criao de um novo template; e Remover , para a excluso do template
selecionado.
Quando o Boto Restries acionado, a seguinte janela mostrada:

Figura 269: 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:
E3 Manual do Usurio
Frmulas 359
Opes disponveis na janela Edio das Restries
OPO DESCRIO
Limite !rrestrito O usurio pode alterar qualquer valor no template. simbolizado pela
letra U na view Templates.
Limite Restrito O usurio no pode alterar o valor do template. simbolizado pela letra
R na view Templates.
Limite Absoluto So definidos valores fixos como limites, correspondendo ao valor
mnimo e mximo do template. simbolizado pela letra A na view
Templates (e os valores mnimo e mximo configurados no campo).
Limite
Percentual
Valor percentual acima/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).
Limite por
diferena
Valores fixos acima/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).

19.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 270: Aba Unidades
As opes disponveis so as seguintes:
E3 Manual do Usurio
360 Frmulas
Opes disponveis na aba Unidades
OPO DESCRIO
Nome Determina o nome do template.
Unidade Determina o tag que ser associado unidade.

A barra de ferramentas da view Unidades tem os seguintes botes: Adicionar ,
para a criao de uma nova unidade; Remover , para a excluso da unidade
selecionada; e Renomear , para a troca do nome da unidade selecionada .
Para cada nova unidade, solicitado um nome:

Figura 271: Adio de uma unidade
19.4. Con]unto 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 272: Aba Valores
As opes disponveis so as seguintes:
E3 Manual do Usurio
Frmulas 361
Opes disponveis na aba Valores
OPO DESCRIO
Nome Determina o nome do template.
valor Determina o valor dos campos do conjunto de valores.

A barra de ferramentas da view Valores tem os seguintes botes: Adicionar ,
para a criao de um novo conjunto de valores; Remover , para a excluso do
conjunto de valores selecionado; e Renomear , para a troca do nome do
conjunto de valores selecionado.
19.5. Exemplo de criao de uma Frmula
Instrues: Criaremos 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 273: Configuraes do Banco de Dados e da tabela
Crie 3 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.
E3 Manual do Usurio
362 Frmulas

Figura 274: 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 3 tags internos
para cada uma.

Figura 275: Criando tags
E3 Manual do Usurio
Frmulas 363
Crie na Frmula duas unidades chamadas Maquina1 e Maquina2.
Associe cada campo destas unidades aos tags criados anteriormente.

Figura 276: Associando os tags s unidades da Frmula
Defina os conjuntos de valores a serem carregados posteriormente
nos tags. Crie 4 conjuntos de valores, chamados de Modelo1 at
Modelo4, e entre com os seguintes valores:

Figura 277: Configurao do conjunto de valores
Crie agora uma nova Tela chamada Frmulas.
E3 Manual do Usurio
364 Frmulas
Crie 6 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 abaixo:

Figura 278: 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:
E3 Manual do Usurio
Frmulas 365

Figura 279: 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/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, devemos utilizar o modo silencioso.
E3 Manual do Usurio
366 Frmulas

Figura 280: Alterao de valor
No entanto, existe uma alternativa, o mtodo LoadFormulaValuesQuiet, localizado
nos mtodos do objeto Viewer. Faremos 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
E3 Manual do Usurio
Frmulas 367

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.
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 abaixo:

Figura 281: Tela final da Frmula
Rode a aplicao e observe os resultados.



Bibliotecas 369

O E3 possui ferramentas que permitem transformar qualquer objeto ou conjunto de
objetos de sua aplicao em uma biblioteca do usurio. As bibliotecas podem ser
formadas por objetos freqentemente utilizados, e subseqentemente reaproveitados
em sua aplicao.
O E3 fornece dois tipos de bibliotecas para o usurio: a Gallery, 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 282: Bibliotecas no Organizer
Capitulo
20
20. Bibliotecas
E3 Manual do Usurio
370 Bibliotecas
20.1. Gallery
A Gallery pode ser acessada atravs do Organizer na aba Gallery, ou atravs do
boto Gallery 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:
A biblioteca de smbolos do E3 pode ser vista no Organizer, na aba
Gallery.
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.
E3 Manual do Usurio
Bibliotecas 371

Figura 283: Gallery (Biblioteca de smbolos)
20.2. Biblioteca do usuario - 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.
E3 Manual do Usurio
372 Bibliotecas

Figura 284: 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/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
E3 Manual do Usurio
Bibliotecas 373
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).
Portanto, se uma biblioteca j possui um XObject/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".
20.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 InserirXControl.

Figura 285: 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 [!nsert] do teclado ou atravs do Boto e excludos
atravs do Boto .
As opes disponveis deste item so as seguintes:
E3 Manual do Usurio
374 Bibliotecas
Opes disponveis na aba Propriedades
OPO DESCRIO
Nome Determina o nome da varivel do XControl.
Tipo Determina o tipo de dado suportado pela varivel.
valor Determina o valor inicial da varivel.
Public Habilita/desabilita a visibilidade da varivel fora da biblioteca,
isto, determina se a varivel ser ou no pblica.
Texto de ajuda 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 abaixo:

Figura 286: 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 e/ou 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
E3 Manual do Usurio
Bibliotecas 375
dever ser feito para outras instncias (cpias) do objeto Bomba que se fizerem
necessrias no projeto.
20.2.2. XOb]ect
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
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 287: 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 [!nsert] 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 propriedades podem ser inseridas pressionando-se a tecla [!nsert] do
teclado ou atravs do Boto e excludos atravs do Boto .
As opes disponveis deste item so as seguintes:
E3 Manual do Usurio
376 Bibliotecas
Opes disponveis na view dos XObjects
OPO DESCRIO
Nome Determina o nome da varivel do XObject. Este
campo equivale a propriedade Name do XObject.
Tipo Determina o tipo de dado suportado pela varivel.
Este campo equivale a propriedade Type do XObject.
valor Determina o valor inicial da varivel. Este campo
equivale a propriedade Value do XObject.
Public Habilita/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:
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 voc possa definir como uma biblioteca, um sistema complexo de
gerenciamento, que poder ser facilmente replicado quantas vezes forem necessrias
em seu 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 abaixo:
E3 Manual do Usurio
Bibliotecas 377

Figura 288: Inserindo um XObject
Note que mesmo que seu arquivo ou arquivos de biblioteca possua 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 XObjetcs.
NOTA: Voc deve cuidar para no deletar uma propriedade de um XControl ou
XObject que possua uma associao. Essas propriedades, uma vez deletadas, 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.

Figura 289: Mensagem do sistema
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.
20.3. Ouando 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;
E3 Manual do Usurio
378 Bibliotecas
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 Scripts: Manual de Referncia.


Relatrios 379

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
InserirRelatrio.
Caso necessite, configure as propriedades do objeto.
21.1. Ob]eto 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.
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.
Capitulo
21
21. Relatrios
E3 Manual do Usurio
380 Relatrios
21.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 290: Sees do relatrio
O relatrio define tipos de seo, que sero explicadas abaixo.
21.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.
21.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.
E3 Manual do Usurio
Relatrios 381
21.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.
21.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.
21.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.
21.2.6. Detail
A seo Detail o corpo do relatrio, que imprime uma vez para cada registro da
fonte de dados.
21.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 291: Barra de Ferramentas Relatrio
E3 Manual do Usurio
382 Relatrios
Clicando com o boto direito do mouse sobre o relatrio, mostrado um menu.

Figura 292: Menu do relatrio Figura 293: 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.
E3 Manual do Usurio
Relatrios 383
Opes disponveis no Menu
OPO DESCRIO
!nsert Permite inserir um novo componente do relatrio. As
opes disponveis so as seguintes:
Insert Group Header/Footer: Adiciona um novo
par de cabealhos/rodaps de grupo no relatrio.
Insert Page Header/Footer: Adiciona um novo
par de cabealhos/rodaps de pgina
Insert Report Header/Footer: Adiciona um novo
par de cabealhos/rodaps no relatrio.
Delete f Delete Section Deleta a seo/objeto/grupo selecionado. Esta opo
no aplicada na seo Detail do relatrio.
Reorder Groups Reorganiza os grupos selecionados. Esta opo
vlida quando vrios grupos de seo (pares de
cabealho/rodap) foram adicionados no relatrio.
Esta opo no aplicada na seo Detail do
relatrio.
Cut Recorta o objeto/grupo/seo selecionado.
Copy Copia o objeto/grupo/seo selecionado.
Paste Cola o objeto/grupo/seo na seo corrente do
relatrio.
Bring to Front O objeto/grupo/seo selecionado enviado para a
primeira posio na ordem de sobreposio.
Send to Back O objeto/grupo/seo selecionado enviado para a
ltima posio na ordem de sobreposio.
Align Alinha o objeto/grupo/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.
Size Determina o tamanho do objeto/grupo/seo
selecionado. As opes disponveis so as seguintes:
Make same width: Mesma largura.
Make same height: Mesma altura.
Make same size: Mesmo tamanho.
Horizontal Spacing Determina o espaamento horizontal do objeto no
relatrio. As opes disponveis so as seguintes:
E3 Manual do Usurio
384 Relatrios
Make Equal: Espaamento igual entre
os objetos.
Increase: Incrementa o espaamento do
objeto em um passo.
Decrease: Decrementa o espaamento do
objeto em um passo.
vertical Spacing Determina o espaamento vertical do objeto. As
opes disponveis so as seguintes:
Make equal: Espaamento igual entre os
objetos.
Increase: Incrementa o espaamento do
objeto em um passo.
Decrease: Decrementa o espaamento do
objeto em um passo.
Format Border Determina o formato da borda do objeto do relatrio.

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

Figura 294: Opes de borda do objeto

E3 Manual do Usurio
Relatrios 385
As opes disponveis so as seguintes:
Opes disponveis para Borda
OPO DESCRIO
Presets Determina o estilo da borda externa do objeto.
Line Styles Determina o estilo da linha da borda do objeto.
Preview Prvia de configurao do objeto.
Color Determina a cor da borda do objeto.
Shadow Habilita/Desabilita a sombra do objeto.

Atravs da Barra de Ferramentas Relatrio, possvel acessar os recursos
disponveis no relatrio:
21.3.1. Preview
Atravs desta opo, possvel visualizar uma prvia da impresso do relatrio.
Assim possvel verificar configuraes de margem, figuras, etc.

Figura 295: Prvia de impresso do relatrio
As opes disponveis deste item so as seguintes:
E3 Manual do Usurio
386 Relatrios
Configuraes da Prvia de Impresso
CONE DESCRIO

Tabela de contedo do relatrio.

Imprime o relatrio, abrindo a Tela de configurao de impresso.

Copia o contedo selecionado.

Procura um texto especfico no relatrio.

Visualizao de uma pgina simples do relatrio.

Visualizao de mltiplas pginas do relatrio.

Menos zoom na pgina.

Mais zoom na pgina.

Porcentagem de zoom na pgina.

Pgina anterior / Prxima pgina
21.3.2. Report 8ettings
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 296: Configuraes do relatrio

E3 Manual do Usurio
Relatrios 387
As opes disponveis deste item so as seguintes:
Opes de configurao do PageSetup
ITEM DESCRIO
Top Nargim Determina a margem do topo da pgina.
Bottom Nargin Determina a margem do contedo da pgina.
Left Nargin Determina a margem esquerda da pgina.
Right Nargin Determina a margem direita da pgina.
Gutter Determina a margem da pgina.
Nirror Nargins Habilita/Desabilita a margem espelhada da pgina.

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

Figura 297: Configuraes de impresso do relatrio
E3 Manual do Usurio
388 Relatrios
As opes disponveis deste item so as seguintes:
Opes de configurao do Printer Setting (Impressora)
ITEM DESCRIO
Paper Size Determina o tamanho do papel.
Width Determina a largura do papel.
Height Determina a altura do papel.
Orientation Determina a orientao do papel na impressora
(Printer Default Configuraes de acordo com a
impressora padro; Portait - Layout da pgina na
vertical; Landscape Layout da pgina na
horizontal).
Collate Ordena a impresso.
Duplex Duplica a impresso.
PaperBin Determina as configuraes e o tipo de papel para a
impresso.

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

Figura 298: Configuraes da grade
E3 Manual do Usurio
Relatrios 389
As opes disponveis deste item so as seguintes:
Opes de configurao do Grid Setting (grade)
ITEM DESCRIO
Show Grid Habilita/Desabilita a grade.
Align Controls to Grid Habilita/Desabilita o alinhamento dos controles na
grade.
Grid Columns Determina o nmero de colunas na grade.
Grid Rows Determina o nmero de linhas na grade.
Ruler Units Determina o tipo de unidade da rgua (pixel ou
centmetros).

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

Figura 299: Configuraes de impresso do relatrio
As opes disponveis deste item so as seguintes:
Opes disponveis para configurao do Style (estilo)
OPO DESCRIO
NewfDeletefLista Determina o estilo do relatrio. Pode-se inserir um
novo estilo (atravs do Boto [New]), deletar um
estilo (atravs do Boto [Delete]) ou utilizar os
estilos existentes na lista.
Fontf Colors f Nisc Determinam as especificaes do estilo do relatrio
(fontes, cores de fundo e frente, orientao, etc).

E3 Manual do Usurio
390 Relatrios
21.3.3. 8cript 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 Boto Script Editor que est disponvel na
Barra de Ferramentas Relatrio.

Figura 300:Editor de texto
No campo Object necessrio especificar o objeto que deseja criar o script e no
item Events, o evento do relatrio em que ocorrer a ao.
21.3.4. Carregar Arquivo RPX
Exporta a configurao do relatrio para um arquivo externo.
21.3.5. 8alvar Arquivo RPX
Importa a configurao do relatrio de um arquivo externo.
E3 Manual do Usurio
Relatrios 391
21.4. Ob]etos do Relatrio
21.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 301: Linha
Aps ser inserido na Tela, o objeto ser chamado Line.
21.4.2. Retngulo
O objeto Retngulo permite o desenho de retngulos, utilizando toda a
largura/altura do objeto. Criado a partir de dois vrtices.

Figura 302: Retngulo
Aps ser inserido na Tela, o objeto ser chamado Shape.
21.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 303: Retngulo arredondado
Aps ser inserido na Tela, o objeto ser chamado Shape.



E3 Manual do Usurio
392 Relatrios
21.4.4. Elipse
O objeto Elipse permite o desenho de crculos e elipses, utilizando toda a
largura/altura e definindo o centro do crculo no centro do retngulo.

Figura 304: Elipse
Aps ser inserido na Tela, o objeto ser chamado Shape.
21.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 305: Texto
Aps ser inserido na Tela, o objeto ser chamado Label.
21.4.6. Figura
O objeto Figura permite mostrar imagens que estejam armazenadas em arquivos,
estejam eles dentro ou fora do arquivo do aplicativo.

Figura 306: Figura
Aps ser inserido na Tela, o objeto ser chamado Picture.



E3 Manual do Usurio
Relatrios 393
21.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 307: 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:
Insira um novo GroupHeader/Footer no relatrio;
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

E3 Manual do Usurio
394 Relatrios
21.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 308: Caixa de seleo
Aps ser inserido na Tela, o objeto ser chamado CheckBox.
21.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 309: Cdigo de barras
Aps ser inserido na Tela, o objeto ser chamado BarCode.

E3 Manual do Usurio
Relatrios 395
21.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 310: 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 Studio ou em eventos
do prprio relatrio.
Para maiores informaes sobre este objeto, veja o captulo E3Chart.
21.4.11. Ouebra de Pagina
O objeto Quebra de pgina um ponto em que uma pgina termina e outra comea
no relatrio. Por exemplo, voc pode 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 reinseri-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 assegurar que uma quebra de pgina no
seja inserida entre dois pargrafos, como entre um ttulo e o pargrafo seguinte.


E3 Manual do Usurio
396 Relatrios

Figura 311: Quebra de pgina
21.4.12. Ouadro
O objeto Quadro composto de linhas e colunas onde so inseridos textos e/ou
grficos. Os quadros dos relatrios so usados para organizar e apresentar a
informao. Pode-se tambm usar quadros para criar disposies de pgina, ou criar
o texto, grficos e tabelas animadas como em uma pgina html.

Figura 312: Quadro
Aps ser inserido na Tela, o objeto ser chamado Frame.
21.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 quantas vezes quanto necessrias, o corpo
do relatrio;
Page Footer Rodap da pgina, trabalha do mesmo modo como o Page
Header.

E3 Manual do Usurio
Relatrios 397
Existem ainda dois tipos de reas:
Report Header/Footer: reas que so impressas uma nica vez, no
importando o tamanho do relatrio em pginas. Ela vem como abertura
ou fechamento do relatrio;
Group Header/Footer: Um grupo utilizado para dividir no relatrio
conjuntos de valores iguais de uma mesma varivel. Essa rea se repetir
sempre que um grupo for apresentado. No exemplo aqui demonstrado
no utilizada nenhuma construo desse tipo. Essa rea sempre
envolve uma rea de detalhes.
Essas duas reas podem ser acessadas clicando com o boto direito do mouse, 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, devem-se seguir os seguintes procedimentos:
Configure a propriedade DataSource (nome do Banco de Dados onde
ser feita a consulta. No nosso 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, usaremos os seguintes valores:
Field1: E3Timestamp
Field2: Temperatura1 (como est no Banco de Dados).
Field3: Temperatura2
E3 Manual do Usurio
398 Relatrios
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.
21.6. Exemplos de utilizao nos Relatrios
Abaixo segue 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
E3 Manual do Usurio
Relatrios 399
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
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
E3 Manual do Usurio
400 Relatrios
Como Criar Relatrios mostrando "Pgina N de M"
Para criar um relatrio que a cada pgina imprime um indicativo de "Pgina N de
M" onde N a pgina atual e M o total de pginas, crie dois Labels e dois Campos.
Os dois Labels correspondem aos textos "Pgina" e "de", que devem ser inseridos na
propriedade Caption. Os dois campos correspondem aos valores N e M, com as
seguintes propriedades:
Campo N:
Name: txtPageNumber
SummaryGroup: GroupHeader1
SummaryRunning: 1-ddSRGroup
SummaryType: 4-ddSMPageCount
Campo M
Name: txtPageCount
SummaryGroup: GroupHeader1
SummaryType: 4-ddSMPageCount
Como criar relatrios imprimindo somente mdias de valores a cada 5
minutos
Para isso devemos criar um novo Grupo no Relatrio. O Grupo criado tem um
Header e um Footer. 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 fracionaria as horas e minutos.
Multiplicando por 288 teremos um numero 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 numero 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:
E3 Manual do Usurio
Relatrios 401
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 como quiser)
Se a consulta for entre 0:00 de um dia e outro, o resultado sero 288 linhas
impressas com a mdia dos campos a cada 5 minutos.


Segurana 403

Atravs desta opo, possvel controlar o acesso a Telas, Alarmes e Domnios em
uma lista de usurios, onde a cada nome atribudo uma senha e um login.
Conforme a opo configurada, o sistema permitir acesso aos usurios cadastrados
ou acesso ilimitado as Telas do projeto. Os demais usurios podem atravs da
mesma opo, trocar sua senha, atravs da digitao da senha antiga e da dupla
confirmao da nova senha.
As senhas e informaes dos usurios so gravadas num arquivo criptografado e
independente dos demais no diretrio da aplicao. Para o usurio se logar no
sistema, deve-se obrigatoriamente executar o login para ter acesso s Telas e demais
especificaes do sistema, menos na Tela de abertura do projeto, pela qual todos os
usurios tero acesso liberado.
Para acessar as configuraes dos usurios, siga estes procedimentos:
Acesse o menu ArquivoUsurio... O sistema mostrar uma caixa
de dilogo para configurao dos usurios no sistema.
Os usurios possuem eventos, mtodos e propriedades especficas
para a sua configurao, conforme listado abaixo:
Eventos do Usurio
EVENTOS DESCRIO
Login Ocorre quando um usurio executa um login de sistema
(autenticao de usurio) com sucesso. O login de sistema
pode ser feito atravs da execuo do mtodo Login () ou
quando um objeto s pode ser acessado com um determinado
nvel de autorizao, exigindo assim, sua autenticao.
Logout Ocorre quando executado um logout, ou seja, a sada do
usurio do sistema. O logout feito atravs da chamada do
mtodo Logout ().
Propriedade do Usurio
PROPRIEDADE DESCRIO
User Esta propriedade identifica o nome do usurio que est
utilizando o Viewer.

Capitulo
22
22. 8egurana
E3 Manual do Usurio
404 Segurana
Mtodos do Usurio
MTODOS DESCRIO
ChangePassword Este mtodo abre uma caixa de dilogo para permitir
a troca de senha do usurio corrente. O mtodo
retorna True, se o usurio corrente tem permisso de
trocar a senha. Caso contrrio, retorna False,
indicando que houve falha na operao ou no
possvel trocar a senha, porque o usurio no tem
autorizao.
!sUserNemberOfGroup Este mtodo verifica se o usurio logado no Viewer
corrente pertence a um determinado grupo.
Login Abre uma caixa de dilogo para o login
(autenticao do usurio) no projeto.
Logout Executa o logout (sada do usurio corrente da
aplicao) do Viewer.
PasswordConfirm O mtodo abre uma caixa de dilogo solicitando a
reconfirmao da senha do usurio atualmente
logado. Este mtodo retorna True se a senha foi
confirmada e False, caso contrrio. Se a caixa de
dilogo for fechada atravs do boto [Cancelar], o
mtodo retorna False. Caso no haja usurio logado,
o mtodo retorna False, mas sem abrir a caixa de
dilogo. Caso a senha digitada no esteja correta, a
solicitao repetida no mximo at trs vezes e
fechado, retornando False.
UserAdministration Este mtodo abre uma caixa que permite editar a lista
de usurios do E3 Server.
Obs.: Apenas o administrador pode ter acesso a este
mtodo. A caixa de configurao dos usurios
acessvel somente ao usurio habilitado como
administrador. O usurio administrador no pode se
excluir e no pode marcar seu tipo para no-
administrador. Esta opo no funciona no modo
Somente Leitura.

E3 Manual do Usurio
Segurana 405
22.1. Usuarios
Atravs da opo Usurios possvel configurar as informaes referentes aos
usurios que tero ou no acesso ao sistema. Para utilizar este recurso, preciso
acessar o Menu ArquivosUsurios, e clicar na aba Usurios. Aps a sua
configurao, somente os usurios listados tero acesso ao sistema.

Figura 313: Usurios
As opes disponveis deste item so as seguintes:
Opes disponveis na aba Usurios
OPO DESCRIO
Nome Indica o usurio corrente.
Botao [Novo| Cria um novo usurio.
Botao [Editar| Edita as propriedades do usurio selecionado.
Botao [Remover| Remove as o usurio selecionado.
Grupos disponiveis Mostra os grupos de usurios disponveis no sistema.
Pertence a Mostra os grupos pela qual o usurio pertence.

E3 Manual do Usurio
406 Segurana
Quando o Boto [Novo] acionado, a seguinte caixa de mensagem mostrada:

Figura 314: Adicionando usurios na aplicao
As opes disponveis deste item so as seguintes:
E3 Manual do Usurio
Segurana 407
Opes disponveis na janela Adicionar usurios
OPO DESCRIO
Nome Determina o nome do usurio.
Senha Determina a senha do usurio.
Confirme a senha Esta senha gravada num arquivo criptografado e
independente dos demais no diretrio da aplicao.
Nome completo Reconfirmao da senha anteriormente informada.
Este usuario um
administrador
Habilita o usurio como administrador.
Politica de Segurana Determina vrios tipos de configuraes e restries
para o usurio. As opes disponveis so as
seguintes:
O usurio no pode alterar sua senha: O usurio
no pode alterar a sua senha, sendo que somente o
administrador pode executar esta tarefa.
A senha expira aps ... dias: Determina o prazo de
validade da senha do usurio.
A senha deve conter no mnimo ... caracteres:
Determina um nmero mnimo de caracteres para a
senha do usurio.
A senha deve conter letras e nmeros: Determina que
a senha deve conter letras e nmeros.
A senha deve conter letras maisculas e minsculas:
Determina que a senha deve conter letras maisculas
e minsculas.
Esta conta est desabilitada: Indica que a conta est
desabilitada.
Esta conta est bloqueada: Indica que a conta do
usurio est bloqueada. Esta opo habilitada
automaticamente caso a senha do usurio expire.

Quando a opo Este usurio um administrador habilitada, permite ao usurio
alguns privilgios em runtime:
Mostrar a lista de todos os usurios;
Deletar usurios (no possvel deletar o usurio corrente);
Adicionar e editar usurios;
Editar as configuraes de um usurio;
Alterar a senha do usurio;
Alterar os demais dados do usurio (login, nome, etc);
Informar o grupo que o usurio pertence.
E3 Manual do Usurio
408 Segurana
Estes privilgios so acessados via script atravs do mtodo UserAdministration(),
que habilita a caixa de dilogo dos usurios em runtime.
OBS: Apenas o administrador pode ter acesso ao mtodo UserAdministration(). A
caixa de configurao dos usurios acessvel somente ao usurio habilitado como
Administrador.
O usurio Administrador no pode se excluir e no pode marcar seu tipo para no
administrador.
Quando a opo A senha expira aps ... dias est habilitada, determina ao usurio
um prazo de validade para a senha. A senha do usurio tem uma durao especfica
de alguns dias e expirar aps uma determinada data. 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 Este usurio est bloqueado ser habilitada automaticamente. Esta
condio persiste at que um administrador desbloqueie a senha manualmente
A conta de um usurio pode ser bloqueada nas seguintes condies:
Se a senha expirar (o tempo de expirao pode ser um atributo global, do grupo ou
do usurio).
Se o usurio digitar a senha errada vrias vezes.
Quando o boto [Editar] da caixa de dilogo do usurio clicado, a mesma Tela
mostrada na opo Adicionar usurios visualizada. As opes disponveis so as
mesmas explicadas anteriormente.
Quando o boto [Excluir] acionado, o sistema mostra uma caixa de mensagem
questionando se realmente deseja remover o usurio. Clique em [Yes] para
confirmar a excluso e [No] para desistir da ao. Para cancelar a ao, clique em
[Cancel].
E3 Manual do Usurio
Segurana 409
22.2. Grupos
A opo Grupos permite que sejam configuradas as informaes referentes aos
grupos. Cada grupo define caractersticas que sero comuns para todos os seus
membros (usurios). Um grupo tambm pode pertencer a outros grupos. S no
permitido pertencer a outro grupo que j pertena a ele, ou seja, uma referncia
circular.
Para utilizar este recurso, necessrio acessar o menu ArquivosUsurios e
selecionar a aba Grupos.

Figura 315:Grupos
E3 Manual do Usurio
410 Segurana
As opes disponveis deste item so as seguintes:
Opes disponveis na aba Grupos
OPO DESCRIO
Nome Indica o grupo corrente.
Botao [Novo| Cria um novo grupo.
Botao [Editar| Edita as propriedades do grupo selecionado.
Botao [Remover| Remove o grupo selecionado.
Grupos disponiveis Mostra os grupos disponveis no sistema.
Pertence a Mostra os grupos pela qual o grupo selecionado
pertence.

Quando o boto [Novo] acionado, a seguinte caixa de mensagem mostrada:

Figura 316: Criando um novo grupo
E3 Manual do Usurio
Segurana 411
As opes disponveis so as seguintes:
Opes disponveis na janela Adicionar Grupos
OPO DESCRIO
Nome do grupo Determina o nome do grupo.
Politica de Segurana para
os usuarios deste Grupo
Determina vrios tipos de configuraes e restries
para o usurio do grupo corrente. As opes
disponveis so as seguintes:
O usurio no pode alterar sua senha: O usurio
no pode alterar a sua senha, sendo que somente o
administrador pode executar esta tarefa.
A senha expira aps ... dias: Determina o prazo de
validade da senha do usurio. A senha do usurio tem
uma durao especfica de alguns dias e expirar aps
uma determinada data. Quando a senha se aproximar
da data de validade, ser mostrado um lembrete para
renov-la. Se a senha expirar antes do usurio renov-
la, o mesmo no poder mais executar o login e a
opo Este usurio est bloqueado ser habilitada
automaticamente.
A senha deve conter no mnimo ... caracteres:
Determina um nmero mnimo de caracteres para a
senha do usurio.
A senha deve conter letras e nmeros: Determina
que a senha deve conter letras e nmeros.
A senha deve conter letras maisculas e
minsculas: Determina que a senha deve conter
letras maisculas e minsculas.

Quando o boto [Editar] da caixa de dilogo do grupo clicado, a mesma Tela
mostrada na opo Novo grupo visualizada. As opes disponveis so as mesmas
explicadas anteriormente.
O boto [Remover] pressionado, o sistema mostra uma caixa de mensagem
perguntando se deseja realmente excluir o grupo selecionado. Clicando em Yes, a
ao confirmada. Para cancelar a ao, clique em Cancel.
possvel adiciona grupos e usurios aos grupos de usurios. Para tanto, na lista
Grupos disponveis so listados os grupos disponveis no sistema e no item
Pertence a possvel adicionar o usurio/grupo. Para adicionar um usurio/grupo a
um grupo especfico, siga estes procedimentos:
Selecione na lista de seleo o grupo/usurio que deseja inserir num
grupo especfico.
E3 Manual do Usurio
412 Segurana

Figura 317: Lista de seleo do grupo
Na lista Grupos disponveis, selecione o grupo pela qual o
usurio/grupo ir pertencer.

Figura 318: Lista dos grupos
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].
E3 Manual do Usurio
Segurana 413

Figura 319: Selecione o grupo pela qual o grupo corrente ir pertencer. O mesmo ser mostrado no campo
Pertence a
Por exemplo: Temos os seguintes grupos no sistema: Unidade1 e Fbrica e
queremos que a Unidade1 pertena a Fbrica. Para isto, na lista de seleo
selecionamos o grupo Unidade1, e na lista Grupos disponveis, selecionamos o
grupo Fbrica e clicamos no boto [Adicionar]. Sendo assim, o grupo Unidade1
pertence ao grupo Fbrica. importante salientar que possvel um grupo
pertencer a mais de um grupo de usurios. Para isto, basta selecionar e adicionar no
grupo especfico. O mesmo procedimento ocorre na incluso de um usurio a um
grupo.
NOTAS:
- Um grupo pode pertencer a outro grupo. S no permitido pertencer a ele mesmo,
ou pertencer a outro grupo que j pertena a ele, ou seja, uma referncia circular.
- importante verificar a hierarquia entre usurios e grupos: Se o usurio est com a
opo A senha deve conter letras Maisculas e Minsculas desabilitada e no
grupo estiver habilitada, 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 neutro.
E3 Manual do Usurio
414 Segurana
22.3. Permisses
A aba Permisses permite configurar as permisses dos usurios e grupos a Telas e
alarmes. Uma verificao de permisso consiste em uma informao que o membro
do grupo tem sobre um comando que atua sobre um objeto especfico.
Por exemplo: Usurio1 tem permisso para o comando Abrir sobre o objeto
Tela1. Cada membro do grupo pode negar ou afirmar a permisso de um
comando, independente do grupo que ele pertence. Desta forma, ele no vai levar
em considerao a informao do grupo. Tambm se pode optar por sempre utilizar
a informao definida pelo grupo. Se as informaes dos grupos forem conflitantes,
ser usada a seguinte ordem de preferncia: Negar > Afirmar > Indiferente.

Figura 320: Permisses de usurios/grupos
E3 Manual do Usurio
Segurana 415
As opes disponveis deste item so as seguintes:
Opes disponveis na aba Permisses
OPO DESCRIO
UsuariosfGrupo Esta opo lista os usurios e/ou grupos de usurios
configurados no sistema. Tais parmetros podem ser
informados atravs dos Usurios e Grupos. Assim,
com o usurio selecionado, possvel na opo Itens
para segurana determinar os itens que este usurio
ter acesso.
!tens de segurana Este item mostra as opes disponveis no sistema
para o usurio ter acesso ou no, ao qual sero
especificadas em Permisses. Os itens de segurana
so:
- Telas: Permitem ao usurio habilitar ou desabilitar o
acesso as Telas. Numa aplicao, todos os usurios
ou grupos tem acesso a Tela de abertura.
- Alarmes: Habilita/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.
Este objeto utilizado para realizar a especificao e
o gerenciamento de alarmes e eventos de variveis de
um processo. Ao ser verificada uma condio de
alarme, este logado no servidor de alarmes e no
Banco de Dados.
- Domnios: Permite ao usurio colocar login nas
atividades do E3 Server.
- Viewer: Permite ao usurio utilizar o Viewer do
modo Viewer Full ou Viewer Only, de acordo com
suas configuraes.
Usuarios um filtro das opes de configurao. Habilitando
esta opo, possvel visualizar somente os usurios
cadastrados no sistema.
Grupos um filtro das opes de configurao. Habilitando
esta opo, possvel visualizar somente os grupos
cadastrados no sistema.
Permissoes Mostram as permisses dos usurios/grupos quanto
os itens de segurana (Telas/alarmes).

E3 Manual do Usurio
416 Segurana
Quando a opo Permisses clicada, disponibiliza vrios tipos de restries de
permisses para os usurios/grupos. As opes de permisses disponveis no sistema
so as seguintes:
Permitir comando: Habilitando esta opo, o usurio/grupo poder acessar o
item de segurana (Tela/alarme/domnio). No caso do item de segurana Tela,
possvel abrir a Tela determinada.
No caso do item de segurana Alarmes, ser inserido um novo registro no Banco de
Dados, indicando o reconhecimento do alarme. No objeto de visualizao do alarme,
por exemplo, o E3Alarm, a linha correspondente indicar que o alarme foi
reconhecido. Este usurio/grupo poder reconhecer globalmente todos os alarmes, os
alarmes do filtro corrente ou somente um alarme selecionado.
Para habilitar este comando, selecione o item de segurana desejado e d um clique
sobre o cone ou clique com o boto direito sobre o campo Permisses e
selecione a opo Permitir comando. O sistema mostrar o cone (cone verde
claro cheio), indicando a permisso ao item.

Figura 321: Permitir comando abrir Tela

Figura 322: Permite reconhecer alarme
NOTA: Em uma aplicao, todos os usurios tm acesso a Tela de abertura. Caso
deseje que a aplicao sempre inicie com o login do usurio, crie um usurio Ex:
Usurio1 que no tenha permisso 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.
E3 Manual do Usurio
Segurana 417
No permitir comando: Habilitando esta opo, o usurio/grupo no ter
acesso ao item de segurana (Tela/alarme/domnio). No caso do item de segurana
Tela, o usurio no poder abrir a Tela e aps o login ser mostrada a seguinte
mensagem: O usurio est sem credenciais para ver a Tela inicial. Contate o
responsvel pela aplicao.
No caso do item de segurana Alarmes, o usurio no poder reconhecer o alarme.
O E3Alarm ficar mostrando os alarmes sem modificao. Neste caso, um novo
registro ser adicionado no Banco de Dados, e no E3Alarm na linha correspondente,
que ir relatar que o alarme saiu da condio de alarme, isto , no reconhecido. O
usurio no poder reconhecer os alarmes do filtro corrente ou um alarme especfico
e ser mostrada a seguinte mensagem caso o usurio deseje configurar alguma das
opes do alarme: O usurio logado no tem credenciais para reconhecer todos os
alarmes selecionados.
Para habilitar este comando, selecione o item de segurana desejado e d um duplo
clique sobre o cone ou clique com o boto direito sobre o campo Permisses e
selecione a opo No permitir comando. O sistema mostrar o cone (cone
vermelho cheio), indicando que no permitido o item ao usurio/grupo.

Figura 323: No permitir abrir Tela

Figura 324: No permitir o comando Reconhecer alarme
E3 Manual do Usurio
418 Segurana
Usar a informao do grupo: Este recurso utiliza as informaes do grupo
em que o grupo/usurio est contido. No caso do item de segurana Tela, se o grupo
em que o usurio/grupo estiver inserido permitir o comando Abrir Tela, o
usurio/grupo poder abrir a Tela, pois o grupo pela qual ele pertence permite este
comando. O mesmo acontece no caso do item de segurana Alarmes, pela qual o
grupo/usurio poder reconhecer o alarme, pois o grupo a que ele pertence permite o
reconhecimento.
Mas, se o grupo em que o usurio/grupo estiver inserido no tiver acesso aos itens
de segurana, o usurio/grupo no poder abrir a Tela, no caso do item de segurana
Tela, e/ou no poder reconhecer o alarme, no caso do item de segurana Alarme.
Para habilitar este comando, selecione o item de segurana desejado e d um clique
sobre o cone ou clique com o boto direito sobre o campo Permisses e
selecione a opo Usar a informao do grupo. O sistema mostrar o cone
conforme as especificaes do grupo: cone verde vazado , caso o grupo tenha
permisso aos itens de segurana e cone vermelho vazado , caso o grupo no
tenha acesso aos itens de segurana.

Figura 325: Informao do grupo, que permite o acesso as Telas

Figura 326: Informao do grupo pela qual no permite o acesso as Telas
E3 Manual do Usurio
Segurana 419

Figura 327: Informao do grupo, permite o reconhecimento do alarme

Figura 328: Informao do grupo, no permite o reconhecimento do alarme
No informado: Habilitando esta opo, indica que o usurio/grupo est usando
as definies do grupo, que no momento no est restrito aos itens de segurana.
Sendo assim, o comando considerado permitido e o usurio/grupo poder abrir a
Tela e/ou reconhecer o alarme. Este comando pode ser acessado atravs do duplo
clique sobre o cone do item . O sistema mostrar o cone (cone vazado),
indicando que no h restries aos itens de segurana.

Figura 329:Parmetro no informado para o alarme Figura 330: Parmetro no informado para a Tela
O item de segurana Domnio possui um comportamento diferenciado em relao s
permisses. De acordo com as configuraes de permisses de cada usurio/grupo,
algumas operaes exigiro identificao para serem executadas:
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).
E3 Manual do Usurio
420 Segurana
As opes de permisses disponveis no item de segurana Domnio so as
seguintes:
Executar domnio: Determina a execuo do domnio;
Parar domnio: Pra a execuo do domnio;
Editar domnio: Abre a caixa de dilogo de configurao do domnio;
Executar como servio: Executa o domnio como servio;
Configurar usurios/grupos: Abre a caixa de dilogo de configurao
dos usurios/grupos.

Figura 331: Opes disponveis no item de segurana Domnio
Na caixa de dilogo de configurao das permisses dos usurios, possvel definir
trs tipos de estados para os itens acima: Permitir comando, no permitir
comando ou Usar a informao do grupo.
Habilitando qualquer uma destas opes da lista de permisses para Permitir
comando, o usurio/grupo poder executar a operao sobre o domnio sem
restrio. Para tanto, selecione o item de segurana Domnio, marque o item
desejado na lista de Permisses e d um clique sobre o cone ou clique com o
boto direito e selecione Permitir comando. O sistema mostrar o cone (cone
verde claro cheio), indicando a permisso ao item.

Figura 332: Permitir comando
Tambm possvel negar a permisso do comando para o item selecionado. Para
tanto, selecione o domnio, marque o item desejado na lista Permisses e d um
E3 Manual do Usurio
Segurana 421
duplo clique sobre o cone ou clique com boto direito no mesmo e selecione a
opo No permitir comando. O sistema mostrar o cone (cone vermelho
cheio), indicando que no permitida a operao ao usurio/grupo. Quando o
domnio for executado, ser exigido o login ao usurio e aps ser mostrada uma
mensagem, conforme figura abaixo:

Figura 333: Mensagem indicando que o usurio no tem permisso de executar o domnio
Para utilizar as configuraes do grupo pela qual o usurio est inserido, selecione o
item de segurana Domnio, marque o item desejado na lista de Permisses e d um
triplo clique sobre o cone ou clique com o boto direito sobre o mesmo e
selecione a opo Usar a informao do grupo.

Figura 334: Usar a informao do grupo
O sistema mostrar o cone conforme as especificaes do grupo:
cone vazado: Caso o grupo onde o usurio est inserido no tenha restries a
qualquer uma das opes da lista de permisses do item de segurana Domnio;
cone verde vazado: Caso o grupo onde o usurio est inserido tenha permisso
a qualquer uma das opes da lista de permisses do item de segurana Domnio;
cone vermelho vazado: Caso o grupo onde o usurio est inserido no tenha
acesso a qualquer uma das opes da lista de permisses do item de segurana
Domnio.
No quero usar a verificao de permisses: Com esta opo habilitada, no ser
feita a verificao de permisso, mesmo que existam usurios com restries. No
caso de no existir usurios, no ser feito verificao de permisses.
E3 Manual do Usurio
422 Segurana
OBS: A nomenclatura e descrio destes parmetros de restrio podem ser
acessadas atravs da opo Legenda.

Figura 335:Legenda das permisses dos usurios/grupos
Para executar, parar, editar um domnio ou configurar os usurios/grupos,
necessrio que um usurio esteja logado no E3. Para tanto, utilizam-se as opes
Login/Logout, disponveis no Menu Arquivo.
E3 Manual do Usurio
Segurana 423

Figura 336: Login/Logout do usurio
A opo Login abre uma caixa de dilogo para o login (autenticao de usurio)
na aplicao. O usurio permanece na memria at que seja feito outro login ou
logout (sada do usurio da aplicao).
Quando uma Tela vai ser aberta (atravs do mtodo OpenScreen()), verificado se
existe alguma configurao de segurana. Caso exista, a Tela s ser aberta se o
usurio logado tiver permisso. Caso no tenha permisso, uma mensagem
mostrada, conforme figura abaixo:

Figura 337: Mensagem de erro de acesso
A opo Logout executa o logout (sada do usurio corrente da aplicao) do
Viewer. Caso no se tenha usurio logado, esta opo no tem efeito. A partir deste
momento, ser considerado que um usurio annimo est utilizando a aplicao.
E3 Manual do Usurio
424 Segurana
22.4. Proteo de arquivos
Protege o contedo de um arquivo .prj ou .lib contra a edio, visualizao ou
execuo no-autorizada.
Para utilizar este recurso, siga estes procedimentos:
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 338: Proteo
Esta opo possui dois tipos de proteo: Proteo de Edio e Proteo de
Execuo.
E3 Manual do Usurio
Segurana 425
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 proteao] permite configurar uma senha de proteo para o
sistema.

Figura 339: Adicionar proteo
O boto [Alterar] senha altera a senha de proteo do Studio para o arquivo.

Figura 340: Alterao de senha de proteo
O boto [Remover proteao] 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.

E3 Manual do Usurio
426 Segurana
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 no 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. Entretanto, esse processo pode ser feito posteriormente compra do
servidor.
O boto [Adicionar proteao] permite configurar uma senha de proteo para o
sistema.

Figura 341: Adicionar proteo
O boto [Alterar senha] altera a senha de proteo de execuo para o arquivo.

Figura 342: Alterao de senha de proteo
O boto [Remover proteao] 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
E3 Manual do Usurio
Segurana 427
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 , indicando a
acessibilidade dos arquivos.
O contedo dos Libs e prj 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.


E3 WebViewer 429

O E3 Viewer o ambiente de visualizao do E3. Nele, possvel visualizar a
execuo da aplicao feita no 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 343: E3 WebViewer em execuo (visualizao de uma aplicao)
Capitulo
23
23. E3 Viewer e E3 WebViewer
E3 Manual do Usurio
430 E3 WebViewer
23.1. Viewer Only {Modo 8omente 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 do Viewer (uso do mtodo
UserAdministration() do Viewer).
Reconhecimento de alarmes pelo E3Alarm.
Uso dos mtodos LoadFormulaDlg(), LoadFormulaValues() e
LoadFormulaValuesQuiet() do Viewer.
Permanecem permitidos neste modo:
Leituras de propriedades de objetos do servidor, tanto por associaes
como por scripts.
Chamadas de mtodos considerados no-restritos de objetos do servidor
em 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).
E3 Manual do Usurio
E3 WebViewer 431
23.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.
E3 Manual do Usurio
432 E3 WebViewer
23.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 abaixo, estas formas
sero detalhadas.
23.2.1. Execuo atravs do 8tudio
O E3 Viewer pode ser executado atravs da Barra de Ferramentas Padro:

Figura 344: 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.
Quando o E3 Viewer executado, o sistema mostra a janela abaixo, indicando o
estado de conexo:

Figura 345: 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
E3 Manual do Usurio
E3 WebViewer 433
Servidores, configurado atravs do E3 Server, conforme explicado no captulo
Domnios.
23.2.2. Execuo atravs da Linha de Comando
O E3 Viewer pode ser acessado via linha de comando das seguintes maneiras:
Viewer [nome_do_servidor] [opes]
ou
Viewer [opes] [nome_do_servidor]
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
-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>
23.2.3. Execuo atravs do Menu niciar
Para rodar uma aplicao cliente, pode-se utilizar o E3 Viewer localizado no
seguinte caminho: Menu Iniciar (Start)Programas (Programs)Elipse E3
Viewer.
O E3 ento mostra a seguinte caixa de dilogo para que o caminho do servidor da
aplicao seja informado:
E3 Manual do Usurio
434 E3 WebViewer

Figura 346: 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.
23.3. Logs do Viewer
O E3 permite a gerao de logs do E3 Viewer. Estes logs so gerados quando o E3
Viewer executado, e so gravados na pasta C:\E3Logs (se ela existir). Para obter
maiores informaes sobre a gerao de logs no E3, verifique o tpico Criando
Logs no E3, no captulo Domnios.
23.4. Execuo do E3 WebViewer
Durante a instalao do E3 WebViewer, os arquivos E3web.asp e docwrite.asp
ficam disponveis para configurao para o usurio. Estes arquivos ficam localizados
no diretrio onde o E3 foi instalado, na pasta WEB.
A pgina docwrite.asp vem configurada considerando-se que o E3 Server est
rodando no mesmo computador que o E3WebServer (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 docwrite.asp:
E3 Manual do Usurio
E3 WebViewer 435
<param name="Domain" value="\\<%=
Request.ServerVariables("SERVER_NAME")%>\">
para:
<param name="Domain" value="\\ServerName">
Onde ServerName o nome do computador onde o E3 Server est rodando.
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">
A configurao do E3 WebViewer para abrir no modo Somente Leitura feita na
pgina ASP/HTML, que especifica sua abertura atravs da propriedade
StartReadOnly (com os valores True ou False). Se este item no existir no HTML, o
valor assumido False (comportamento compatvel com verses anteriores).
Exemplo:
<html>
<head>
<title></title>
</head>
<body topmargin=0 leftmargin=0>
<object classid="clsid:7EB4D157-FACC-45BB-9536-C14B9DCE3CA7"
id="E3 Viewer1" width="100%" height="100%" align="center">
<param name="_Version" value="65536">
<param name="_ExtentX" value="19209">
<param name="_ExtentY" value="14552">
<param name="_StockProps" value="0">
<param name="Domain" value="\\luciano">
<param name="StartReadOnly" value="False">
</object>
</body>
</html>
E3 Manual do Usurio
436 E3 WebViewer
Se o E3 WebViewer for usado em outro programa (que no o navegador de
Internet), possvel tambm configurar a propriedade Booleana StartReadOnly. O
valor default desta propriedade False (compatvel com verses anteriores).
Em ambos os casos, esta configurao s ter efeito na abertura inicial do E3
WebViewer. Se a propriedade for mudada durante a execuo, a conexo/reconexo
do E3 WebViewer no ser afetada em nada.
Os servidores e o E3 WebViewer podem tanto rodar na mesma mquina quanto em
mquinas diferentes. Abaixo, veremos como estas situaes se aplicam.
23.4.1. Aplicaes E3 na internet
Para que aplicaes E3 estejam disponveis na web preciso utilizar um servidor de
internet que rode corretamente os scripts da pgina do controle E3 WebViewer.
Qualquer servidor de internet pode ser utilizado, desde que ele execute pginas .asp.
Um deles o servidor IIS (Internet Information Services), fornecido juntamente com
o Windows . Para acess-lo, siga estes passos:
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);

Figura 347: Internet Information Service (IIS)
Selecione na lista o item Internet Information Services (IIS) e
clique em Prximo (ou Next);
E3 Manual do Usurio
E3 WebViewer 437
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, o arquivo E3Web.asp (devidamente configurado) deve ser
copiado para "c:\InetPub\wwwroot". Esta pasta criada na instalao do IIS. Alm
do arquivo .asp, os instaladores do E3 WebViewer tambm devem ser copiados para
esta mesma pasta. Estes instaladores so utilizados quando a mquina cliente for
acessar o servidor pela primeira vez, caso o E3 no tenha sido previamente instalado
nesta mquina. So eles: e3-w2kwebviewer.exe para Windows 2000, 2003, NT e
XP, e e3-w98webviewer.exe para Windows 98 e Me. Estes arquivos esto no CD de
instalao do E3, ou podem ser obtidos atravs de download no site da Elipse.
O IIS ainda necessita ser configurado para seu correto funcionamento, e informaes
detalhadas sobre este assunto podem ser obtidas no site da Elipse
(www.elipse.com.br), no artigo "Publicando aplicaes E3 na Internet com o
Microsoft Internet Information Services".
Para visualizar a aplicao, basta digitar na barra de endereos do navegador o
endereo ou IP do servidor (Ex: http://servername, 192.0.0.021, etc). O componente
assinado pela Elipse Software, e o usurio deve aceitar sua instalao para que ele
inicie as configuraes necessrias.

Figura 348: Instalao do E3 Viewer
No acesso seguinte, no ser mais necessrio instalar os componentes, e o tempo de
conexo ser mais rpido.
NOTA: A verso do cliente tem que ser necessariamente a mesma que a do servidor.
Para isto, os instaladores no servidor (e3-w2kwebviewer.exe, e3-w2kwebviewer-
E3 Manual do Usurio
438 E3 WebViewer
us.exe, e3-w2kwebviewer-de.exe, e3-w98webviewer.exe, e3-w98webviewer-us.exe
ou e3-w98webviewer-de.exe) devem ser sempre os mais recentes.
23.4.2. Aplicaes E3 na intranet ou na maquina local
Para a visualizao de aplicaes E3 em mquinas remotas que estejam dentro de
uma rede local pode-se ou no utilizar o servidor de internet. Se optar por utiliz-lo,
o procedimento o mesmo descrito na seo anterior.
Caso no se queira utilizar um servidor de internet, o procedimento mais simples, e
aplica-se tanto para o uso do E3 WebViewer e o E3 Server em mquinas diferentes
(intranet), quanto para ambos na mesma mquina (acesso local). Basta alterar o
arquivo E3Web.asp e colocar o nome da mquina onde o E3 Server est rodando.
Para isso, substitui-se a linha
<param name="Domain" value="\\<%=
Request.ServerVariables("SERVER_NAME")%>\">
por
<param name="Domain" value="\\ServerName">
Para visualizar a aplicao, abra o arquivo E3Web.asp utilizando o navegador.

Hot-StandBy 439

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 Server do micro 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 um para entrar em operao. O servidor backup monitora o
servidor ativo, se este no estiver respondendo o backup 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 distribuda 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.
Capitulo
24
24. Hot-8tandBy
E3 Manual do Usurio
440 Hot-StandBy
24.1. Executando um Dominio Distribuido
Para executar um domnio distribudo, basta iniciar um dos seus servidores, os
outros servidores so automaticamente iniciados pelo primeiro servidor. Para iniciar
um domnio, crie um atalho para o E3 Server com a seguinte linha de comando:
E3 Server.exe start c:\folder\domain.dom
Este comando pode ser feito inclusive de um servidor que no faz parte no domnio.
Este servidor ir iniciar os servidores do domnio e depois ser automaticamente
fechado. Um domnio pode ser iniciado tambm atravs do Studio. Para tanto, basta
abrir o domnio e clicar no boto .
24.2. Parando um Dominio Distribuido
Um domnio pode ser parado por qualquer um dos seus servidores, atravs do cone
do E3 Server no System Tray ( ). Escolha a opo Domnio... - Parar e o
servidor Ativo e o Standby iro terminar o processo E3Run. O domnio pode ser
reiniciado escolhendo a opo Domnio... - Executar. Se voc escolher a opo
Domnio... Fechar, os E3 Servers sero fechados e os servidores estaro aptos a
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!!!
24.3. Parando um dos 8ervidores do Dominio
A maneira correta de parar um dos servidores do domnio marc-lo como Em
manuteno... na configurao 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.
24.4. Tempo de troca entre 8ervidores
O tempo padro para o Servidor 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.
E3 Manual do Usurio
Conf 441
24.5. 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.
24.6. Utilizando Banco de Dados com Hot-8tandby
Podemos 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 utilizamos Banco
de Dados, tambm temos que garantir a continuidade do acesso base de dados.
Temos duas maneiras de resolver este problema. Na primeira, ambas as aplicaes
acessam uma mesma base de dados. Habilitamos 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, garantimos 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.
E3 Manual do Usurio
442 Hot-StandBy
24.7. Configurando o Hot-8tandby
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.
As configuraes que devero ser feitas para implementar o Hot-Standby so as
seguintes:
Localize o caminho do domnio no micro principal e copie esta pasta
para o micro 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 micro 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 Server no system tray e selecione as opes
Domnio Opes;

Figura 349: E3 Server
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.
E3 Manual do Usurio
Conf 443

Figura 350: Configurao do Servidor
Na aba Opes, habilite o item Habilitar distribuio em rede. 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 Scripts: Manual de
Referncia.
E3 Manual do Usurio
444 Hot-StandBy

Figura 351: Configurao da distribuio em rede
Para confirmar as configuraes, clique no boto [OK].
Ao iniciar a execuo do E3, ser mostrado no system tray dos
micros um cone representado por uma barra amarela circulante ,
indicando que os domnios esto sendo carregados. Aps alguns
segundos, o E3 reconhece o micro principal e indica no system tray
um cone representado por uma seta verde . Este cone determina
que ele est em execuo. No micro standby ser mostrado um cone
representado por duas barras amarelas , indicando que ele est em
standby (modo de espera).

Configuraes Avanadas 445

Existem configuraes do E3 que podem ser realizadas diretamente no registro do
Windows

.
25.1. 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 uma DWORD.
Se esta chave no for criada, o sistema assume automaticamente que a janela deve
ser exibida.
Se esta chave for criada, existem dois valores possveis para sua configurao: 0 e
1. O valor 0 habilita a exibio da janela de progresso, e o valor 1 oculta sua
visualizao.
25.2. Compactao de 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
uma DWORD.
Se esta chave no for criada, o sistema assume automaticamente que a compresso
est desabilitada.
Se esta chave for criada, qualquer valor entre 1e 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, independentemente de suas configuraes.
Capitulo
25
25. Configuraes Avanadas
E3 Manual do Usurio
446 Configuraes Avanadas
25.3. Porta Utilizada pelo 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
A varivel a ser configurada nesta chave a IPPort, que deve ser uma DWORD.
Se esta chave no for criada, o sistema assume automaticamente a porta padro
6515.
Se esta chave for criada, o valor configurado indica o nmero da porta utilizada pelo
REC. Podem ser usados valores maiores que 1024 e at 65535. Valores igual ou
abaixo de 1024 so reservados. Valores nulos ou invlidos habilitam a utilizao
da porta 6515.
25.4. 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 uma
DWORD.
Se esta chave no for criada, o sistema assume automaticamente que o E3 Server
rodar em todas as CPUs.
Se esta chave 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.
25.5. Ping do E3 8erver
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

:
HKEY_LOCAL_MACHINE\SOFTWARE\Elipse Software\E3\E3Server
A varivel a ser configurada nesta chave a PingTimeout, que deve ser uma
DWORD indicando 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.

Dvidas mais freqentes 447

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.
26.1. 8tudio
26.1.1. Ordem dos Tabs
A ordem dos objetos em runtime diferente da configurada no 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 os seguintes
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).
OBS: O valor da opo Ordem dos Tabs o mesmo do Z-Order. Z-Order o valor
da ordem de sobreposio dos objetos da Tela.
Capitulo
26
26. Dvidas mais freqentes
E3 Manual do Usurio
448 Dvidas mais freqentes
26.1.2. 8obreposio de animaes nos ob]etos
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.
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.
OBS: No tente remover a animao do objeto atravs do Organizer, pois esta ao
ir remover o objeto.
26.2. Ob]etos de Tela
No consigo rotacionar uma figura inserida atravs da Gallery. 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.
26.3. 8ervidor de Banco de Dados 8OL 8erver
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.
E3 Manual do Usurio
Dvidas mais freqentes 449
SOLUO:
Verificar o nome do servidor utilizado e se o usurio possui permisso de se
conectar aquele 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.
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.
26.4. 8ervidor 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 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 micro e se ela est funcionando
atravs dos softwares utilitrios de rede do Oracle.
E3 Manual do Usurio
450 Dvidas mais freqentes
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 SYSTEN.E3!NDEX) no formato Usuario.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.
E3 Manual do Usurio
Dvidas mais freqentes 451
26.5. 8ervidor 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.
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 contador no E3?
RESPOSTA:
Com um tag demo do tipo CurrentTime. s armazenar o valor do tag demo em um
tag interno no incio da contagem e em outro tag interno no final da contagem. A
diferena entre o valor dos dois tags internos ser igual ao tempo percorrido.
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.
E3 Manual do Usurio
452 Dvidas mais freqentes
26.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.
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.
26.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
E3 Manual do Usurio
Dvidas mais freqentes 453
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.
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
E3 Manual do Usurio
454 Dvidas mais freqentes
Servidor de Alarmes, na aba Geral das propriedades do objeto E3Alarm, ou atravs da
Lista de Propriedades, acessando a propriedade AlarmServer.
Como deletar 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].
26.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.
E3 Manual do Usurio
Dvidas mais freqentes 455
26.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.
26.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.
26.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().
E3 Manual do Usurio
456 Dvidas mais freqentes
26.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
E3 Manual do Usurio
Dvidas mais freqentes 457
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.
26.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 micro servidor. Assim, toda a
vez que voc tentar abrir um Viewer pelo Internet Explorer num micro remoto onde
o Viewer no foi previamente instalado, a instalao ser iniciada automaticamente.
26.14. Bibliotecas
Ao abrir uma Tela, aparece uma mensagem dizendo que um objeto no pode ser
carregado corretamente".
POSSVEL CAUSA:
Voc deletou 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 deletou o XControl, no h mais como recuper-lo. Para
corrigir o erro, s deletar 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).
E3 Manual do Usurio
458 Dvidas mais freqentes
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 micro.
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 e 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 micro.
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.
E3 Manual do Usurio
Dvidas mais freqentes 459
26.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/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
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.
E3 Manual do Usurio
460 Dvidas mais freqentes
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.

E3 Manual do Usurio
Dvidas mais freqentes 461
26.16. Dominios e pro]etos
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.
E3 Manual do Usurio
462 Dvidas mais freqentes
Utilizei o E3 Server via linha de comando e apareceu um erro. Por que isto ocorreu?
RESPOSTA:
Muitas vezes, quando utilizamos o E3 Server 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 tpico E3 Server do 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.
Como fao para rodar o domnio ao iniciar o Windows?
RESPOSTA:
E3 Manual do Usurio
Dvidas mais freqentes 463
Existem duas opes. Pode-se criar os seguintes atalhos na pasta Startup do
Windows:
E3 Server.exe -start c:\NomeDoArquivo.dom (executa apenas o
Server)
E3 Server.exe -start c:\NomeDoArquivo.dom viewer (executa o
Server e o Viewer)
Pode-se tambm habilitar a opo de rodar o E3 Server como servio. Para abrir um
Viewer, deve-se criar um atalho no startup do Windows para Viewer.exe\\Servidor.
26.17. 8tored 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().
Obs.: a propriedade CursorLocation da Consulta do E3 dever estar configurada
como 1-clClient.