E3manual PTB

Manual do Usurio do E3
Copyright 1999 - 2015 Elipse Software Ltda. Todos os direitos reservados.

Verso 4.6.162 (03/03/2015)
Sumrio
1 Introduo
................................................................................................................................................. 1
1.1 Descrio
..........................................................................................................................................
Geral
1
1.2 Arquitetura
.......................................................................................................................................... 3
1.3 Diagrama
..........................................................................................................................................
de Blocos
6
1.4 Estrutura
..........................................................................................................................................
de Domnio
6
1.5 Limitaes
..........................................................................................................................................
do Modo Demonstrao
7
2 E3
.................................................................................................................................................
Studio
9
2.1 ..........................................................................................................................................
Iniciando um Projeto
10
2.2 ..........................................................................................................................................
rea de Trabalho
11
2.3 ..........................................................................................................................................
Configurao
12
2.4 ..........................................................................................................................................
Barra de Ferramentas
21
2.5 ..........................................................................................................................................
Organizer
40
2.6 ..........................................................................................................................................
Importao e Exportao
47
2.7 ..........................................................................................................................................
Lista de Propriedades
79
2.8 ..........................................................................................................................................
Galeria
81
2.9 ..........................................................................................................................................
AppBrowser
82
2.10
..........................................................................................................................................
Conectar A
86
3 .................................................................................................................................................
Domnios
89
3.1 ..........................................................................................................................................
E3 Server
89
3.2 ..........................................................................................................................................
E3Run
90
3.3 ..........................................................................................................................................
E3 Admin
90
3.4 ..........................................................................................................................................
IOServer
92
3.5 ..........................................................................................................................................
E3 Studio
92
3.6 ..........................................................................................................................................
E3 Viewer
92
3.7 ..........................................................................................................................................
Componentes
93
3.8 ..........................................................................................................................................
Criando um Domnio
93
3.9
..........................................................................................................................................
Configuraes
103
3.10
..........................................................................................................................................
Outras Opes da rea de Notificao
128
3.11
..........................................................................................................................................
Domnios Remotos
135
3.12
..........................................................................................................................................
Gerando Logs no E3
143
4.................................................................................................................................................
Drivers
144
4.1
..........................................................................................................................................
Driver de Comunicao
144
4.2
..........................................................................................................................................
Servidor OPC
162
4.3
..........................................................................................................................................
Driver de Comunicao OPC
163
4.4
..........................................................................................................................................
Driver de Comunicao OPC UA
180
4.5
..........................................................................................................................................
Qualidade
189
I
5.................................................................................................................................................
Quadros
197
6.................................................................................................................................................
Viewer
202
6.1
..........................................................................................................................................
Configurao
203
6.2
..........................................................................................................................................
Variveis no Viewer
209
6.3
..........................................................................................................................................
Objeto _top
209
6.4
..........................................................................................................................................
Pasta do Viewer
210
7.................................................................................................................................................
Telas e Objetos de Tela
212
7.1
..........................................................................................................................................
Tela
212
7.2
..........................................................................................................................................
Objetos de Tela
214
7.3
..........................................................................................................................................
Configuraes Gerais
221
7.4
..........................................................................................................................................
Formatao de Cores
236
7.5
..........................................................................................................................................
Formatao de Valores
239
8.................................................................................................................................................
Associaes
245
8.1
..........................................................................................................................................
Simples
246
8.2
..........................................................................................................................................
Bidirecional
247
8.3
..........................................................................................................................................
Digital
248
8.4
..........................................................................................................................................
Analgica
250
8.5
..........................................................................................................................................
Por Tabela
251
8.6
..........................................................................................................................................
Reversa
253
8.7
..........................................................................................................................................
Mltipla
253
8.8
..........................................................................................................................................
Edio de Associaes
254
9.................................................................................................................................................
Bibliotecas
260
9.1
..........................................................................................................................................
Galeria
261
9.2
..........................................................................................................................................
Biblioteca do Usurio (ElipseX)
262
9.3
..........................................................................................................................................
Quando Criar um ElipseX
272
10
.................................................................................................................................................
ActiveX
274
10.1
..........................................................................................................................................
Objetos Microsoft Forms
277
10.2
..........................................................................................................................................
Elipse KeyPad
279
11
.................................................................................................................................................
Servidor de Dados
281
11.1
..........................................................................................................................................
Pasta de Dados
281
11.2
..........................................................................................................................................
Tag Contador
282
11.3
..........................................................................................................................................
Tag Demo
284
11.4
..........................................................................................................................................
Tag Interno
285
11.5
..........................................................................................................................................
Tag Timer
287
12
.................................................................................................................................................
Banco de Dados
289
12.1
..........................................................................................................................................
Access
290
12.2
..........................................................................................................................................
Oracle
292
II
12.3
..........................................................................................................................................
SQL Server
297
12.4
..........................................................................................................................................
Objetos do E3 e Permisses
301
13
.................................................................................................................................................
Alarmes
302
13.1
..........................................................................................................................................
Configurao de Alarmes
302
13.2
..........................................................................................................................................
Servidor de Alarmes
306
13.3
..........................................................................................................................................
Fontes de Alarme
317
14
.................................................................................................................................................
E3Alarm
329
14.1
..........................................................................................................................................
Configuraes
330
14.2
..........................................................................................................................................
Caractersticas Especficas de Tempo de Execuo
340
15
.................................................................................................................................................
Storage
344
15.1
..........................................................................................................................................
Configuraes
346
15.2
..........................................................................................................................................
Configurao da Tabela
348
16
.................................................................................................................................................
Histrico
362
16.1
..........................................................................................................................................
Configuraes
364
17
.................................................................................................................................................
Consultas
376
17.1
..........................................................................................................................................
Criando uma Consulta
377
17.2
..........................................................................................................................................
Uso dos Filtros da Consulta atravs de Scripts
386
17.3
..........................................................................................................................................
Uso de Recordsets de uma Consulta atravs de Scripts
387
18
.................................................................................................................................................
E3Browser
388
18.1
..........................................................................................................................................
Objeto Consulta no E3Browser
389
18.2
..........................................................................................................................................
Outras Configuraes
391
19
.................................................................................................................................................
E3Chart
396
19.1
..........................................................................................................................................
Configuraes
397
19.2
..........................................................................................................................................
Exemplos de Utilizao
424
19.3
..........................................................................................................................................
Caractersticas Especficas de Runtime
428
20
.................................................................................................................................................
E3Playback
434
20.1
..........................................................................................................................................
Objeto E3Playback
434
20.2
..........................................................................................................................................
Adicionar Playback ao Demo do E3
434
20.3
..........................................................................................................................................
Interface de Usurio
440
20.4
..........................................................................................................................................
Banco de Dados de Playback
454
20.5
..........................................................................................................................................
Configurao dos Objetos de Banco de Dados do E3
458
21
.................................................................................................................................................
Frmulas
462
21.1
..........................................................................................................................................
Configuraes
463
21.2
..........................................................................................................................................
Templates
465
21.3
..........................................................................................................................................
Unidades
468
21.4
..........................................................................................................................................
Conjunto de Valores
469
21.5
..........................................................................................................................................
Criao de uma Frmula
469
III
22
.................................................................................................................................................
Relatrios
477
22.1
..........................................................................................................................................
Objeto Consulta
478
22.2
..........................................................................................................................................
Componentes
478
22.3
..........................................................................................................................................
Configuraes
480
22.4
..........................................................................................................................................
Criando um Relatrio no E3
496
22.5
..........................................................................................................................................
Exemplos de Utilizao
497
23
.................................................................................................................................................
Segurana
501
23.1
..........................................................................................................................................
Usurios
502
23.2
..........................................................................................................................................
Grupos
508
23.3
..........................................................................................................................................
Permisses
511
23.4
..........................................................................................................................................
Proteo de Arquivos
516
24
.................................................................................................................................................
E3 Viewer e E3 WebViewer
521
24.1
..........................................................................................................................................
Viewer Only (Modo Somente Leitura)
522
24.2
..........................................................................................................................................
Execuo do E3 Viewer
523
24.3
..........................................................................................................................................
Logs do Viewer
527
24.4
..........................................................................................................................................
Execuo do E3 WebViewer
528
25
.................................................................................................................................................
Hot-Standby
533
25.1
..........................................................................................................................................
Configurando
534
25.2
..........................................................................................................................................
Executando um Domnio Redundante
535
25.3
..........................................................................................................................................
Parando um Domnio Redundante
535
25.4
..........................................................................................................................................
Parando um dos Servidores do Domnio
536
25.5
..........................................................................................................................................
Tempo de Troca entre Servidores
536
25.6
..........................................................................................................................................
Reconexo de Viewers
536
25.7
..........................................................................................................................................
Utilizando Bancos de Dados com Hot-Standby
536
26
.................................................................................................................................................
Configuraes Avanadas
538
27
.................................................................................................................................................
Dvidas mais Frequentes
539
27.1
..........................................................................................................................................
Ordem dos Tabs
539
27.2
..........................................................................................................................................
Sobreposio de Animaes nos Objetos
539
27.3
..........................................................................................................................................
Objetos de Tela
539
27.4
..........................................................................................................................................
Servidor de Banco de Dados SQL Server
540
27.5
..........................................................................................................................................
Servidor de Banco de Dados Oracle
540
27.6
..........................................................................................................................................
Servidor de Dados
542
27.7
..........................................................................................................................................
Drivers de Comunicao
543
27.8
..........................................................................................................................................
Alarmes
543
27.9
..........................................................................................................................................
E3Alarm
545
27.10
..........................................................................................................................................
E3Browser
546
27.11
..........................................................................................................................................
E3Chart
546
IV
27.12
..........................................................................................................................................
Histrico
546
27.13
..........................................................................................................................................
Associaes
547
27.14
..........................................................................................................................................
Viewer
548
27.15
..........................................................................................................................................
Bibliotecas
549
27.16
..........................................................................................................................................
Relatrios
550
27.17
..........................................................................................................................................
Domnios e Projetos
552
27.18
..........................................................................................................................................
Stored Procedure
553
27.19
..........................................................................................................................................
Domnios Remotos
554
CAPTULO
Introduo
Desenvolvido pela Elipse Software, o E3 uma poderosa plataforma para

superviso e controle de processos totalmente voltada operao em rede e
aplicaes distribudas. O E3 um sistema SCADA (Supervisory Control and Data
Acquisition) que oferece um avanado modelo de objetos, uma poderosa interface
grfica, alm de uma arquitetura que permite o rpido desenvolvimento de
aplicaes e mxima conectividade com dispositivos e outros aplicativos. Sua
concepo incorpora as mais novas tecnologias em desenvolvimento de software,
maximizando o desempenho, a produtividade e a qualidade de suas aplicaes e
do prprio processo, minimizando perdas e custos.
Os sistemas construdos com o E3 geralmente partem da coleta de dados em tempo
real de equipamentos de aquisio de dados ou de controle, como os CLPs
(Controladores Lgicos Programveis), UTRs (Unidades Terminais Remotas), DAQs
(Data Acquisition Boards, Placas de Aquisio de Dados), controladores Multi-Loop
ou Single-Loop, centrais de incndio e balanas, dentre outros dispositivos. Estes
equipamentos normalmente possuem alguma interface que permitem sua conexo
ao software, como padres seriais RS232, RS422 ou RS485; rdio ou modem (linhas
privadas ou discadas), TCP/IP ou UDP/IP, placas ligadas diretamente ao
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, possvel criar vrias maneiras para exibir, analisar,
controlar, comandar, gravar ou divulgar tais informaes, dentre elas:
Telas: Permitem criar uma IHM (Interface Homem-Mquina) localmente, pela
rede local ou Internet, com o intuito de exibir o status atual ou passado dos
dados em vrias formas, com o auxlio de um editor grfico e objetos
especficos
Alarmes e Eventos: Monitoram o acontecimento de situaes especficas
Histricos: Armazenam os dados em bancos de dados relacionais
Relatrios: Permitem visualizar e imprimir os dados, dentre outros mdulos
e possibilidades
1.1 Descrio Geral

O E3 pode ser executado nas plataformas Windows XP SP3, Windows XP x64 SP2,
Windows Vista SP2, Windows 7 SP1, Windows 8, Windows 8.1, Windows Server
2003 SP2, Windows Server 2008 SP2, Windows Server 2008 R2 SP1, Windows
1
Introduo
Server 2012 ou Windows Server 2012 R2, utilizando alguns recursos disponveis
nestes sistemas operacionais. A interface grfica com o usurio pode tambm ser
executada atravs da Internet ou intranet via Internet Explorer.
As funes bsicas do software esto divididas em mdulos independentes,
capazes de processar atividades especficas. O gerenciamento do trfego de
informaes entre os mdulos coordenado por um mdulo principal (E3 Admin),
utilizando a tecnologia de objetos distribudos, permitindo que os componentes
possam ser executados tanto na mesma mquina quanto em outros computadores.
Em linhas gerais, o E3 composto de um ncleo (kernel) responsvel por unir e
coordenar o trabalho de vrios outros mdulos, que tambm so servidores de
informaes. A partir da so geradas as interfaces grficas com o usurio,
disponveis atravs dos clientes, tanto locais como pela Internet.
O E3 possui quatro programas principais, descritos a seguir.
1.1.1 E3 Server
o Servidor de Aplicaes, onde os principais processos so executados, incluindo
a comunicao em tempo real com os equipamentos de controle. O servidor
tambm responsvel por enviar dados e Telas aos clientes conectados em
qualquer parte da rede (intranet e Internet). O servidor pode executar vrios
projetos ao mesmo tempo e conversar com outros E3 Servers para realizar um failover (standby) ou distribuir cargas de processamento entre as mquinas.
1.1.2 E3 Studio
Ferramenta nica de configurao, agindo como plataforma universal de
desenvolvimento, que possui um ambiente moderno e amigvel, incluindo um
completo editor grfico e de scripts (VBScript). Permite que um projeto seja editado
por vrias pessoas ao mesmo tempo ou que vrios E3 Studios estejam conectados
ao mesmo servidor remoto, com mltiplas configuraes.
1.1.3 E3 Viewer
Permite operar as aplicaes residentes no servidor a partir de qualquer
computador com o programa executvel Viewer ou com um navegador de Internet.
Em ambos os casos, no necessrio instalar a aplicao na mquina cliente, pois
feito o download e o registro de todos os componentes (Telas, bibliotecas e
controles ActiveX).
1.1.4 E3 Admin
o mdulo responsvel pela interface do E3 Server e de outros mdulos do E3 com
o usurio. Atravs dele o usurio pode enviar comandos ao E3 Server, utilizando o
cone na rea de Notificaes do Windows, e controlar o Domnio pela linha de
comando.
Introduo
1.2 Arquitetura
Para supervisionar um determinado processo com um sistema SCADA, geralmente
construda uma aplicao que contm a definio das variveis envolvidas, com
nomes e endereamentos, Telas, definies de alarmes e outros, a qual se chama
Banco de Dados da Aplicao.
Quando este processo exige o uso de dois ou mais computadores, preciso fazer
com que cada aplicao em cada computador troque dados com as outras. A
maioria dos sistemas SCADA tradicionais baseiam-se em uma arquitetura comum
para realizar esta tarefa:
Cada servidor SCADA deve ter uma cpia (parcial ou no) da aplicao
configurada na base de dados local
Cada servidor SCADA possui e executa somente uma base de dados ao
mesmo tempo
Isto 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 E3 resolve este problema usando o conceito de Domnio que inclui, em um nico
ambiente, a definio dos computadores executando tarefas em tempo real
(servidores) e as bases de dados de projeto que devem ser executadas nestes
servidores, com a possibilidade de execuo de vrios projetos em cada servidor.
Tambm possvel inserir, apagar ou modificar projetos durante a execuo, sem
afetar as outras partes do Domnio em execuo.
Cada projeto pode conter qualquer tipo de objeto, como Telas, Drivers de
Comunicao, Alarmes, Histricos, Relatrios, Frmulas e 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
notificada e pode indicar seu estado em uma forma definida pelo usurio.
A estrutura do Domnio restrita aos servidores e afins, como as mquinas
servidoras, projetos, usurios e senhas. A interface do cliente para operao e
visualizao, chamada E3 Viewer, pode se conectar diretamente a qualquer
servidor E3 (com licenas suficientes de Viewer). O E3 Viewer possui trs destaques
especiais:
Os projetos da aplicao residem somente no servidor
O navegador Internet Explorer pode ser usado como interface de operao,
3
Introduo
sem nenhuma mudana

A interface do cliente capaz de alternar de um servidor desligado ou com
falha para o prximo servidor disponvel, sem interromper o monitoramento
do processo
Como alternativa ao uso do E3 Viewer na mquina cliente, possvel utilizar a
tecnologia 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 acessada remotamente). O E3
Viewer executado em uma 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.
Introduo
Arquitetura do E3
possvel observar que, em todos os casos, o E3 Viewer continua sendo a interface

de operao e visualizao. A diferena est no local de execuo, que pode ser na
mquina cliente (operao normal do E3 Viewer) ou na mquina servidora, com o
operador fisicamente junto mquina ou atravs dos Terminal Services. Com o E3
Viewer sendo executado diretamente na estao cliente, existe um trfego inicial
maior para o download de Telas e objetos. Este trfego diminui substancialmente
medida que somente as mudanas nos dados so reportadas do servidor para o
Viewer, o que traz vantagens em termos de desempenho e qualidade de
apresentao grfica.
5
Introduo
O Terminal Service, por outro lado, possui maior alcance e exige menor capacidade
de processamento da mquina cliente quando existem poucos efeitos grficos e
visuais, alm da possibilidade de operar o E3 em outras plataformas de software
que no so suportadas pelo E3 Viewer, como o Windows CE e o Linux ou Unix.
Entretanto, o RDP possui a limitao de exibir somente 256 cores, o que aumenta
consideravelmente o trfego quando existem muitas animaes ou efeitos
piscantes nas Telas. Para verificar qual a melhor maneira de implementar
mltiplos acessos a um E3 Server, importante estudar caso a caso, para poder
definir a melhor alternativa para a aplicao. Para utilizar o RDP com mltiplos
usurios, necessrio uma licena de Windows 2003 Server SP2, alm do mesmo
nmero de Viewers disponveis no Servidor.
1.3 Diagrama de Blocos

A arquitetura interna do E3 totalmente escalvel, com cada tarefa principal sendo
executada por um servio separado. O diagrama a seguir mostra uma viso geral
dos principais blocos.
Diagrama dos blocos que compem o E3
1.4 Estrutura de Domnio

Cada grupo de servidores composto por um E3 Server operando isoladamente ou
dois E3 Servers em configurao de Hot-Standby. Cada Viewer, de fato, se conecta a
um Domnio ao invs de somente a um servidor.
Depois da conexo, servidor e cliente trocam informaes e verificam a existncia
de objetos do sistema registrados e atualizados na mquina cliente. Caso negativo,
Introduo
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 so salvos em um diretrio de
cache. Este processo pode levar alguns segundos, dependendo da aplicao, mas
traz mais benefcios na prxima vez que se abre a mesma Tela, pois o Viewer realiza
um cache em disco e em memria. Se o Viewer no for fechado, a partir da segunda
vez que uma Tela for aberta (e no for reconfigurada) ela j est criada em
memria, reduzindo, portanto, o tempo de paginao. Se a Tela for modificada, o
Viewer deve executar 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 em um sistema de mensagens TCP/IP, com um
alto 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 Terminal Services envia mensagens de teclado e mouse e
recebe imagens, o que gera um trfego muito maior de informaes. Um Viewer
conectado a um Domnio isolado pode obter informaes residentes somente
dentro do servidor ativo, de acordo com os direitos de acesso do usurio.
1.5 Limitaes do Modo Demonstrao

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

hora atual do servidor, com um nmero ilimitado de Tags e com todos os
recursos de playback habilitados
No permitido utilizar a ferramenta de Importao e Exportao do E3
Introduo
CAPTULO
E3 Studio
O E3 Studio o ambiente de desenvolvimento do E3. Nele, possvel a criao e

manuteno de Domnios, projetos e bibliotecas.
Caminho indicado pelo sistema quando o E3 instalado
Para iniciar uma aplicao no E3 Studio, siga estes procedimentos:

1. No momento da instalao, criado um grupo de programas no menu Iniciar do
9
E3 Studio
Windows. Para iniciar o E3 Studio, selecione o cone correspondente neste

menu, como mostra a figura anterior, ou clique no cone criado na rea de
Trabalho, conforme figura a seguir.
cone do E3 Studio
2. O dispositivo de proteo deve estar conectado na porta de comunicao

adequada, no caso de uma edio local, ou a mquina deve estar na mesma
rede local que outra com o E3 Server j previamente instalado, e com um
dispositivo de proteo presente.
2.1 Iniciando um Projeto

Quando o E3 Studio iniciado, abre-se uma caixa de dilogo com algumas opes
do projeto:
E3 Studio
10
Janela Iniciar o Studio
As opes disponveis nesta caixa de dilogo esto descritas na tabela a seguir.

Opes disponveis na janela Iniciar o E3 Studio
OPO
Iniciar o E3 Studio
Criar um Domnio novo
Abrir um Domnio existente
DESCRIO
N o a berto nenhum Domni o.
S o requi s i ta dos o nome e ca mi nho do
novo Domni o.
Ao cl i ca r em Outros Arquivos, tem-s e a
op o de l oca l i za r um Domni o em um
di retri o es pecfi co, ou es col her na l i s ta
um dos l ti mos a pl i ca ti vos edi ta dos .
2.2 rea de Trabalho

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

cuja view esteja sendo mostrada na rea de trabalho.
A Barra de Status mostra informaes de ajuda a respeito da rea da tela, sobre a
qual est o ponteiro do mouse.
A Barra de Ferramentas mostra os objetos, componentes e demais recursos que
podem ser utilizados na Tela e no E3.
A rea de Trabalho onde as views so mostradas.
2.3 Configurao
O E3 permite personalizar alguns recursos do E3 Studio, tais como barra de
ferramentas, teclado, menus, mouse, etc.
2.3.1 Aparncia
Para personalizar a aparncia do E3 Studio, clique no menu Visualizar Personalizar. As opes disponveis deste item so as seguintes:
Aba Comandos: Atravs desta aba, pode-se definir os cones de cada uma das
barras de ferramentas. Para tanto, clique no cone na lista Comandos e arraste-o
para dentro da barra de ferramentas desejada
E3 Studio
12
Aba Comandos
As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Comandos
OPO
Categorias
Comandos
Descrio
DESCRIO
Mos tra a s opes dos menus e ba rra s de
ferra menta s di s ponvei s no E3 Studi o.
Mos tra os i tens que compem o menu ou
a ba rra de ferra menta s s el eci ona da .
Breve des cri o da op o s el eci ona da .
Aba Barra de ferramentas: Atravs desta aba, pode-se configurar, editar ou criar
novas barras de ferramentas
13
E3 Studio
Aba Barra de ferramentas
As opes disponveis nesta aba esto disponveis na tabela a seguir.

Opes disponveis na aba Barra de ferramentas
OPO
Barra de ferramentas
Restaurar
Restaurar tudo
Nova
Mudar o nome
Remover
Mostrar legendas
DESCRIO
Li s ta a s opes de ba rra s de ferra menta s
di s ponvei s .
Res ta ura a ba rra de ferra menta s
des eja da no E3.
Res ta ura toda s a s ba rra s de ferra menta s
no E3.
Cri a uma nova ba rra de ferra menta s .
Muda o nome da ba rra de ferra menta s .
Es ta op o uti l i za da s omente na ba rra
de ferra menta s cri a da pel o us u ri o
us a ndo a op o Nova.
Remove a ba rra de ferra menta s
s el eci ona da .
Mos tra uma l egenda na s opes da
ba rra de ferra menta s s el eci ona da .
Aba Menus: Atravs desta aba, possvel configurar os menus do E3

E3 Studio
14
Aba Menus

Opes disponveis na aba Menus
OPO
Mostra menus para
Restaurar
Animao dos menus
Menus com sombra
DESCRIO
Exi be o menu pr-defi ni do da a pl i ca o.
Es ta op o n o tem efei to, e ma nti da
no E3 por ques t o de compa ti bi l i da de.
Res ta ura o menu defi ni do na op o
a nteri or. Es ta op o n o tem efei to, e
ma nti da no E3 por ques t o de
compa ti bi l i da de.
Sel eci ona o ti po de a ni ma o us a da nos
menus : Nenhuma (pa dr o do E3),
Desdobrar, Deslizar, Fade e Default (pa dr o
do Wi ndows ).
Defi ne s e o menu a pres enta o efei to de
s ombrea do ou n o.
Aba Aparncia: Atravs desta aba, possvel alterar a aparncia das janelas e
barras de ferramentas no E3 Studio
15
E3 Studio
Aba Aparncia

Opes disponveis na aba Aparncia
OPO
Office XP
Windows XP
Office 2000
Office 2003
VS.Net 2005
DESCRIO
Confi gura a a pa rnci a do E3 Studi o como
no Offi ce XP.
no Wi ndows XP (n o di s ponvel no es ti l o
Wi ndows Cl s s i co).
no Offi ce 2000.
no Offi ce 2003.
no Vi s ua l Studi o .NET 2005.
Aba Opes: Atravs desta aba, possvel configurar as especificaes gerais do

projeto. Neste item possvel habilitar ou desabilitar as opes da barra de
ferramentas
E3 Studio
16
Aba Opes

Opes disponveis na aba Opes
OPO
Mostrar descries
Incluir teclas de atalho

cones grandes
DESCRIO
Ha bi l i ta o E3 a mos tra r uma breve
des cri o na s opes da s ba rra s de
ferra menta s e menus qua ndo o mous e
pos i ci ona do s obre o i tem.
Mos tra ou n o a tecl a de a ta l ho na
des cri o do bot o.
Ha bi l i ta cones gra ndes na s ba rra s de
ferra menta s .
2.3.2 Outras Configuraes

Pode-se configurar o Editor de Scripts do E3, bem como outras opes dos arquivos
do Domnio, atravs do menu Ferramentas - Opes, onde tem-se acesso seguinte
janela de configuraes:
Geral: Configura o comportamento do duplo-clique de objetos no Organizer,
quando a view de um objeto j estiver aberta
17
E3 Studio
Aba Geral

Opes disponveis na aba Geral
OPO
Ativar a view de Scripts
Abrir a Janela de Propriedades
Mostrar boto de fechar na aba ativa
DESCRIO
Ati va a view de Scri pts na ocorrnci a de
um dupl o-cl i que.
Abre a ja nel a de Propri eda des na
ocorrnci a de um dupl o-cl i que.
Permi te fecha r a a ba a ti va a o cl i ca r no
s eu res pecti vo bot o de fecha r.
Des ma rca r es ta op o fa z com que o
bot o de fecha r s eja pos i ci ona do
di rei ta da view.
Aba Editor de Scripts: Este item destinado configurao do Editor de Scripts do

E3
E3 Studio
18
Aba Editor de Scripts

Opes disponveis na aba Editor
OPO
Abrir-e-Fechar blocos do texto
Tamanho da margem
Numerao da linha
Tamanho da margem
Tamanho do Tab
Fonte
19
DESCRIO
Permi te ocul ta r ou mos tra r os bl ocos de
cdi go no s cri pt.
Ta ma nho da ma rgem da ma rca o do
bl oco de cdi go.
Ha bi l i ta a numera o de l i nha no edi tor
de s cri pts .
Ta ma nho da ma rgem que contm a
numera o de l i nha .
Determi na o nmero de es pa os de
ta bul a o.
Determi na o nome da fonte a s er us a da
no edi tor de s cri pts .
E3 Studio
OPO
Tamanho
DESCRIO
Determi na o ta ma nho da fonte a s er
us a da no edi tor de s cri pts .
NOTA: Feche os edi tores de s cri pts a bertos pa ra que a s modi fi ca es s eja m
a pl i ca da s .
Arquivos: Habilita ou desabilita a opo Ignorar verificao de CRC
Aba Arquivos
Toda vez que um projeto ou uma biblioteca criado, o E3 grava internamente um

cdigo CRC (Cyclic Redundancy Check, Verificao de Redundncia Cclica) dos
dados deste arquivo. Cada vez que um arquivo aberto, feita uma verificao
deste CRC. Caso esta verificao falhe (ou seja, o CRC no coincida com os dados),
a carga do arquivo abortada, indicando uma corrupo dos dados do arquivo.
Isto pode ser causado por falhas diversas de hardware: memria, rede, dispositivo
de armazenamento, etc.
E3 Studio
20
Porm, se um projeto criado na verso atual modificado em uma verso inferior

verso 1.00.019 build 203, o CRC no atualizado. Com isto, o arquivo no pode
ser aberto novamente com as verses atuais, pois a verificao de CRC falha,
mesmo que o arquivo no esteja efetivamente corrompido. Para solucionar esta
questo, necessrio habilitar a opo Ignorar verificao de CRC. Assim, o projeto
pode ser aberto em uma verso atual.
Neste caso, a opo deve permanecer habilitada at que todos os objetos editados
na verso antiga tenham sido salvos com a verso atual, o que atualiza o CRC.
NOTA: N o recomend vel que a rqui vos .prj s eja m edi ta dos em vers es ma i s
a nti ga s do E3 e depoi s a bertos nova mente em vers es a tua i s , poi s n o h ga ra nti a
de que com es te procedi mento n o s eja m perdi da s a s confi gura es des tes
a rqui vos .
2.4 Barra de Ferramentas

A Barra de Ferramentas do E3 muda conforme a existncia de uma aplicao aberta
ou no. Os botes da barra de ferramentas permitem a execuo de determinadas
tarefas rapidamente, sem utilizar os menus. Desta forma, pode-se criar Objetos de
Tela ou abrir o Organizer simplesmente clicando-se em um boto da barra de
ferramentas. A tabela a seguir mostra as opes disponveis nas diversas barras de
ferramentas do E3 Studio.
Opes disponveis na barra de ferramentas Padro
CONE
COMANDO
Novo Projeto
AO
Cri a um novo projeto.
Abrir Projeto
Abre um projeto exi s tente.
Salvar Projeto
Sa l va o projeto.
Salvar Tudo
Sa l va todo o Domni o.
Recortar
Copiar
Colar
Desfazer
Refazer
21
Remove a i nforma o
s el eci ona da e a move
pa ra a rea de
Tra ns fernci a .
Copi a a i nforma o
s el eci ona da e a move
pa ra a rea de
Tra ns fernci a .
Col a a i nforma o
s el eci ona da da rea de
Tra ns fernci a .
Des fa z a l ti ma a o
executa da .
Refa z a l ti ma a o
des fei ta pel o i tem
Desfazer.
E3 Studio
CONE
E3 Studio
COMANDO
AO
Mos tra ou es conde o
Organizer
Orga ni zer.
Mos tra ou es conde a
Galeria
Ga l eri a .
Mos tra ou es conde a Li s ta
de Propri eda des .
Mos tra o objeto na view do
Mostrar no Editor
objeto, s e es te es ti ver
s el eci ona do no Orga ni zer.
Mos tra o objeto no
Orga ni zer, s e es te es ti ver
Mostrar no Organizer
s el eci ona do na view do
objeto.
Sa l va todos os projetos e
Executar Aplicativo
bi bl i oteca s , executa o
Domni o e a bre o Vi ewer.
Executa ou pa ra o Domni o
Rodar ou Parar Domnio
corrente.
Executa ou pa ra o E3
Executar ou Parar E3 Viewer
Vi ewer.
Veri fi ca s e o Domni o
Verificar Domnio
contm erros .
Mos tra o erro a nteri or
Erro Anterior
encontra do no Domni o.
Mos tra o prxi mo erro
Prximo Erro
encontra do no Domni o.
Des fra gmenta o a rqui vo
Desfragmentar Arquivos
es peci fi ca do.
Procura toda s a s
ocorrnci a s de um
Procurar ou Substituir
determi na do texto em
todo o Domni o.
Mos tra uma ja nel a com a s
qua nti da des de objetos
di s ponvei s no Domni o,
Contagem de Objetos no
s epa ra dos por cl a s s es
Domnio
ordena da s
a l fa beti ca mente ou
a grupa da s por mdul os .
Gera a documenta o dos
Documentao de Scripts
s cri pts .
Mos tra a s vers es dos
Relatrio de Verses
projetos e bi bl i oteca s .
Mos tra os va l ores de Ta gs
e de propri eda des no E3
WatchWindow
Studi o em tempo de
execu o.
22
Opes disponveis na barra de ferramentas Sombra

CONE
COMANDO
Sombra do Objeto
Sombra Acima
Sombra Abaixo
Sombra Esquerda
Sombra Direita
Cor da Sombra
AO
Apl i ca uma s ombra no
objeto.
Des l oca a s ombra pa ra
ci ma do objeto.
Des l oca a s ombra pa ra
ba i xo do objeto.
Des l oca a s ombra pa ra a
es querda do objeto.
Des l oca a s ombra pa ra a
di rei ta do objeto.
Sel eci ona a cor da
s ombra do objeto.
Opes disponveis na barra de ferramentas Objetos

CONE
COMANDO
E3Alarm
E3Browser
E3Chart
Caixa de Seleo
Boto de Opo
Lista de Seleo
Boto de Comando
Texto
Lista
Barra de Rolagem
Boto IncrementoDecremento
Editor de Texto
23
AO
Ins ere um objeto do ti po
E3Alarm.
E3Browser.
E3Chart.
Caixa de Seleo (CheckBox).
Boto de Opo
(Opti onButton).
Lista de Seleo
(ComboBox).
Boto de Comando
(Comma ndButton).
Texto (La bel ).
Lista (Li s tBox).
Barra de Rolagem
(Scrol l Ba r).
Boto IncrementoDecremento (Spi nButton).
Editor de Texto (TextBox).
E3 Studio
CONE
COMANDO
Boto Liga-Desliga
AO
Boto Liga-Desliga
(Toggl eButton).
Opes disponveis na barra de ferramentas Tela

CONE
COMANDO
Selecionar
Rotacionar
Ordem dos Tabs
Editar Ponto de Conexo
Linha
Conector
Retngulo
Retngulo Arredondado
Elipse
Arco de Elipse
Desenho Livre
Polgono
Polgono de Curvas
Figura
Texto
Display
SetPoint
Escala
E3 Studio
AO
Ha bi l i ta o modo de
s el e o.
Ha bi l i ta o modo de
rota o.
Mos tra o i denti fi ca dor
de ordem de na vega o
entre os objetos .
Permi te edi ta r pontos
de conex o entre
objetos . Es te bot o
s omente es t
ha bi l i ta do em objetos
XControl .
Ins ere um objeto do
ti po Linha.
ti po Conector.
ti po Retngulo.
ti po Retngulo
Arredondado.
ti po Elipse.
ti po Arco de Elipse.
Ins ere uma ferra menta
de des enho l i vre.
ti po Polgono.
ti po Polgono de Curvas.
ti po Imagem.
ti po Texto.
ti po Display.
ti po SetPoint.
ti po Escala.
24
CONE
COMANDO
Agrupar
Desagrupar
Animar com Translao
Animar com Rotao
Trazer para a Frente
Enviar para Trs
Avanar
Recuar
Zoom
Camadas
AO
Agrupa uma s el e o de
objetos .
Des a grupa uma s el e o
de objetos .
pa ra movi mentos
l i nea res .
pa ra rota o.
Tra z o objeto pa ra a
frente em um
a grupa mento (ALT +
HOME).
Envi a o objeto pa ra tr s
em um a grupa mento
(ALT + END).
Move um objeto uma
pos i o a ci ma no
PAGE UP).
Move um objeto uma
pos i o a ba i xo no
PAGE DOWN).
Permi te edi ta r o nvel
de zoom da Tel a .
Permi te edi ta r a s
ca ma da s de objetos na
Tel a .
Opes disponveis na barra de ferramentas Desenho

CONE
COMANDO
Cor de Fundo
Cor de Frente
Cor da Borda
Estilo da Borda
Espessura da Borda
Estilo de Preenchimento
25
AO
Defi ne a cor do fundo do
objeto.
Defi ne a cor da frente do
objeto.
Defi ne a cor da borda do
objeto.
Defi ne o es ti l o da borda
do objeto.
Defi ne a es pes s ura da
borda do objeto.
Defi ne o es ti l o de
preenchi mento do objeto.
E3 Studio
Opes disponveis na barra de ferramentas Alinhamento

CONE
COMANDO
Alinhar Direita
AO
Al i nha objetos
es querda .
Al i nha objetos di rei ta .
Alinhamento Superior
Al i nha objetos pel o topo.
Alinhamento Inferior
Al i nha objetos pel a ba s e.
Alinhar Esquerda
Apl i ca a mes ma l a rgura a

todos os objetos .
Apl i ca a mes ma a l tura a
Mesma Altura
todos os objetos .
Apl i ca o mes mo ta ma nho
Mesmo Tamanho
a os objetos s el eci ona dos .
Centra l i za os objetos
Centralizar Horizontalmente
hori zonta l mente.
Centra l i za os objetos
Centralizar Verticalmente
verti ca l mente.
Forma ta o es pa a mento
Distribuir Horizontalmente entre objetos na
hori zonta l .
Forma ta o es pa a mento
Distribuir Verticalmente
entre objetos na verti ca l .
Apl i ca uma refl ex o
Espelhar Horizontalmente
hori zonta l no objeto
s el eci ona do.
Apl i ca uma refl ex o
Espelhar Verticalmente
verti ca l no objeto
s el eci ona do.
Mos tra ou es conde a
Grade
gra de.
Mesma Largura
Opes disponveis na barra de ferramentas Formatao

CONE
COMANDO
Fonte
Tamanho da Fonte
Cor da Fonte
Fonte em Negrito
Fonte em Itlico
Fonte Sublinhada
E3 Studio
AO
Determi na a fonte do
texto.
Determi na o ta ma nho
da fonte.
Determi na a cor da
fonte.
Forma ta o texto em
negri to.
Forma ta o texto em
i t l i co.
Forma ta o texto com
s ubl i nha do.
26
CONE
COMANDO
Texto Centralizado
AO
Al i nha o texto
es querda .
Centra l i za o texto.
Texto Direita
Al i nha o texto di rei ta .
Texto Esquerda
2.4.1 Verificar Domnio

Verifica erros de configurao em todo o Domnio, como objetos com o mesmo
nome, Associaes ilegais, etc. Em caso afirmativo, o E3 Studio mostra uma caixa
de dilogo com os erros encontrados no Domnio.
Verificao de Erros no Projeto
Enquanto o erro no for solucionado, a caixa de dilogo continua sendo mostrada

e no possvel executar o Viewer. Aps a resoluo do problema, o E3 Studio
mostra uma caixa de mensagem indicando que no encontrou nenhum erro no
Domnio, e libera a execuo do Viewer.
Mensagem do Item Verificar Domnio
27
E3 Studio
A opo Verificar Domnio pode ser acessada das seguintes maneiras:

Atravs do cone , disponvel na barra de ferramentas Padro: Verifica os
erros ocorridos em todo o Domnio
Atravs do menu Ferramentas - Verificar Domnio: Mesmo funcionamento da
opo anterior
Clicando com o boto direito do mouse sobre um item do projeto e
selecionando a opo Verificar ou Verificar projeto: Verifica os erros
ocorridos somente no objeto selecionado e em seus filhos
2.4.2 Procurar e Substituir

A ferramenta Procurar busca no Domnio por ocorrncias de um determinado texto,
de forma parcial ou completa. No final da busca, apresentado ao usurio uma
lista de resultados, indicando o objeto onde a ocorrncia foi encontrada, a
localizao dentro deste objeto (se uma propriedade, Associao, etc.), e o texto
que contm a ocorrncia.
A ferramenta Substituir substitui as ocorrncias encontradas por outro texto
especificado.
Janela Procurar/Substituir
Existem trs maneiras de se realizar a procura e a substituio:

Clicar com o boto direito do mouse em um item no Organizer e selecionar a
opo Procurar/Substituir. Esta procura feita a partir do item, seguindo a
hierarquia (apenas objetos filhos so pesquisados)
Clicar no menu principal do E3 Studio, em Ferramentas - Procurar/Substituir.
Esta procura feita em todos os projetos e bibliotecas abertos
Clicar em Procurar/Substituir
efetuada em todo o Domnio
, na barra de ferramentas Padro. A procura
As opes disponveis so as seguintes:

E3 Studio
28
Opes disponveis na ferramenta Procurar/Substituir

OPO
Procurar por
Procurar
Apenas nos resultados
Diferenciar maisculas de minsculas
Palavras inteiras
Substituir por
Substituir
Uma a uma
Todas
Apenas as selecionadas
ou
DESCRIO
Contm o texto a s er procura do.
Ini ci a a bus ca pel o texto.
Refa z a pes qui s a a pena s entre os
res ul ta dos da pes qui s a a nteri or.
Procura pel o texto exa ta mente como foi
es cri to, di ferenci a ndo ma i s cul a s de
mi ns cul a s .
Procura o texto es peci fi ca do como uma
pa l a vra i ntei ra . N o cons i dera o texto
como uma substring de outro.
Contm o texto a s er uti l i za do na
s ubs ti tui o.
Ini ci a o proces s o de s ubs ti tui o.
Executa a s ubs ti tui o da l i nha
s el eci ona da e s el eci ona a prxi ma
l i nha v l i da .
Subs ti tui , de uma s vez, toda s a s
ocorrnci a s do texto.
Subs ti tui , de uma s vez, toda s a s
ocorrnci a s ma rca da s na l i s ta de
res ul ta dos .
Mos tra ou es conde a s opes de
pes qui s a e s ubs ti tui o.
Sel eci ona na l i s ta de res ul ta dos a
ocorrnci a a nteri or.
Sel eci ona na l i s ta de res ul ta dos a
ocorrnci a s egui nte.
NOTA: Pa ra s el eci ona r o objeto e mos tra r o l oca l exa to onde o texto s e encontra ,
ba s ta cl i ca r dua s vezes na l i s ta de res ul ta dos , na l i nha des eja da .
A tabela a seguir contm as principais opes de pesquisa, bem como as limitaes

para os principais tipos de dados.
29
E3 Studio
Principais opes de pesquisa

TIPO DE DADO
Data / Hora
EXEMPLO
10/02/2010
00:00:10
Inteiro
0
100
Ponto flutuante
10.0
40,5
Cor
255,255,0
0,0,234
Booleano
Verda dei ro
True
String
Tes te
Ta g
E3 Studio
OBSERVAO
Encontra em propri eda des
do ti po Data/Hora. Se for
es peci fi ca da s omente a
da ta , encontra toda s a s
ocorrnci a s des ta da ta ,
i ndependente da hora . Se
for es peci fi ca da s omente a
hora , encontra toda s a s
ocorrnci a s des ta hora ,
i ndependente da da ta . Os
mi l i s s egundos s o
i gnora dos na pes qui s a .
Encontra em toda s a s
propri eda des numri ca s .
Pes qui s a ndo por 10
encontra 10 e 10.0, ma s n o
encontra 10.1 ou 100.
Encontra em toda s a s
propri eda des numri ca s
de ti po Ponto Flutuante.
Pes qui s a ndo por 10.1 n o
encontra 10 (i ntei ro). As
confi gura es regi ona i s do
Wi ndows s o
cons i dera da s pa ra va l i da r
o s mbol o deci ma l no
nmero.
Encontra a pena s em
propri eda des do ti po Cor.
Deve neces s a ri a mente
us a r vrgul a s pa ra s epa ra r
os va l ores , que devem
es ta r no s i s tema RGB.
Leva em cons i dera o o
i di oma do Wi ndows pa ra
entender a pes qui s a como
s endo de um va l or
Bool ea no.
Encontra Strings i ntei ra s ou
pa rtes de Strings (de a cordo
com o ti po de pes qui s a ,
por pa l a vra i ntei ra ou n o).
Qua l quer ti po de da do
pode s er encontra do em
propri eda des do ti po
String.
30
2.4.3 Contagem de Objetos do Domnio

A ferramenta Contagem de Objetos do Domnio permite visualizar a quantidade de
objetos existentes no Domnio, separados por classes ordenadas alfabeticamente
ou agrupadas por mdulos. A contagem tambm pode ser feita contextualmente a
um objeto, clicando com o boto direito do mouse no objeto desejado e
selecionando a opo Contagem de Objetos.
Janela Contagem de Objetos do Domnio
As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Contagem de Objetos do Domnio
CONE
OPO
Ordenar por categoria
Ordenar alfabeticamente
31
DESCRIO
Mos tra a conta gem de
objetos orga ni za ndo-os
pel o mdul o.
Mos tra a conta gem de
objetos orga ni za ndo-os
em ordem a l fa bti ca .
E3 Studio
CONE
OPO
DESCRIO
Atua l i za a conta gem de
objetos . NOTA: A
a tua l i za o n o
a utom ti ca , exceto
qua ndo o objeto removi do
o objeto ba s e do
contexto de conta gem ou
qua ndo o Domni o for
fecha do.
Contar filhos de instncias de Incl ui na conta gem os
fi l hos i nternos da s
ElipseXs
i ns t nci a s de um XControl
ou XObject.
Permi te fi l tra r a l i s ta gem
Procurar
pel o nome ou pa rte do
nome do objeto.
Atualizar
NOTAS:
O menu contextua l Contagem de Objetos n o es t di s ponvel no Orga ni zer em
modo Domnio pa ra os i tens Configurao, Servidores, Arquivos e Domnios Remotos.
Os a rqui vos i ndi vi dua i s do i tem Arquivos no Orga ni zer em modo Domnio
permi tem uti l i za r o menu contextua l Contagem de Objetos.
No ca s o de a rqui vos protegi dos por s enha , neces s ri o que es tes a rqui vos
es teja m a bertos pa ra que s eja m i ncl udos na conta gem.
2.4.4 Documentao de Scripts

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
da barra de ferramentas Padro. Utilizando esta opo,
so gravados no arquivo todos os scripts do Domnio
Clicando com o boto direito do mouse no nome do projeto ou objeto e
selecionando a opo Documentar scripts. Utilizando esta opo, apenas os
scripts do objeto selecionado e de seus filhos so 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.
E3 Studio
32
Assistente de Documentao de Scripts
Na janela Arquivo de documentao, so definidas as informaes referentes ao

arquivo que guarda os scripts da aplicao.
No item Nome do arquivo, especifique o nome do arquivo onde gerada a
documentao dos scripts. Especifique o local onde este arquivo salvo no item
Salvar o arquivo na pasta, e caso haja necessidade, clique em Procurar.
33
E3 Studio
Arquivo de documentao de scripts
Clique em Avanar para ir prxima janela.

A janela Detalhamento do arquivo permite que se formate o arquivo que contm as
informaes de scripts. possvel escolher entre uma documentao simplificada,
contendo apenas os nomes dos scripts, ou uma documentao completa, onde todo
o cdigo dos scripts gravado no arquivo.
E3 Studio
34
Detalhamento do arquivo
Por exemplo, o script a seguir:

Sub TelaInicial_KeyDown(KeyCode, Shift)
If (KeyCode = 27) Then
Application.Exit
End Sub
Se a opo escolhida for Apenas os nomes dos scripts, gravado no arquivo o texto
seguinte:
TelaInicial_KeyDown(KeyCode, Shift)
Se for escolhida a opo Todo o script, ento todo o cdigo gravado com a mesma
formatao (identao, linhas em branco, etc.) feita pelo usurio no editor de
scripts.
Independente do tipo de formatao escolhida, antes do script gravado um
identificador contendo o nome completo do objeto, para evitar conflitos. Por
exemplo, para os seguintes objetos:
TelaInicial
CommandButton1
Tela1
CommandButton1
35
E3 Studio
Ambos os scripts (considerando um mesmo evento, Click) seriam

CommandButton1_Click(). Assim, a gravao no arquivo ficaria desta forma:
<TelaInicial.CommandButton1:CommandButton1_Click()>
Sub CommandButton1_Click()
...
End Sub
E:
<Tela1.CommandButton1:CommandButton1_Click()>
...
End Sub
Isto permite a identificao correta de cada script. Clique em Avanar para ir

prxima janela.
Na janela Separador de scripts, possvel definir o texto que gravado entre um
script e outro no arquivo de documentao. possvel escolher entre linhas em
branco ou personalizadas, e ainda informar quantas linhas do tipo escolhido so
inseridas no arquivo.
Separador de scripts
Pode-se optar entre uma Linha em branco ou uma Linha personalizada. Escolhendo a
E3 Studio
36
opo Linha em branco, o arquivo de documentao tem uma linha em branco entre
um script e outro. Escolhendo a opo Linha personalizada, pode-se informar um ou
mais caracteres para compor a linha que usada como separador. Os caracteres
so informados no campo Entre com o texto da linha. Se a opo selecionada
Repetir at o final da linha, os caracteres informados so repetidos at o limite de
tamanho da linha, que de 80 caracteres. Pode-se tambm utilizar mais de uma
linha como separador, seja ela em branco ou personalizada. Basta informar um
nmero entre 1 e 100, no campo Entre com o nmero de linhas do separador. Clique
em Avanar para finalizar a configurao. Logo aps, o assistente mostra uma
mensagem indicando a finalizao da configurao e a gerao do arquivo que
contm a documentao dos scripts.
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 so gravados quando o objeto pai da instncia for pesquisado
Picks so internamente scripts; logo, tambm so documentados
A gravao no arquivo feita em ordem alfabtica do nome do objeto, dentro
de cada projeto ou biblioteca
No possvel adicionar scripts a um arquivo j existente, via Assistente.
37
E3 Studio
Sempre que o Assistente iniciado, um novo arquivo criado ou, caso j

exista, sobrescrito
Esta ferramenta pode demorar algum tempo para gerar o arquivo de
documentao, caso a aplicao seja grande e a pesquisa envolva muitos
tipos de objetos. Para agilizar a pesquisa, interessante gerar um arquivo
para cada tipo de objeto do E3
2.4.5 Relatrio de Verses

A ferramenta Relatrio de verses permite a visualizao das verses e
comentrios dos projetos e das bibliotecas abertos, pertencentes ou no ao
Domnio. Para acessar esta ferramenta, clique em
na barra de ferramentas
Padro para mostrar a caixa de dilogo da figura a seguir.
Relatrio de verses
As opes desta caixa de dilogo so mostradas na tabela a seguir.

Opes disponveis na caixa de dilogo Relatrio de verses
OPO
Projeto/Biblioteca
Verso
E3 Studio
DESCRIO
Nome do projeto ou da bi bl i oteca
a bertos .
Indi ca a vers o do projeto ou bi bl i oteca .
Es ta vers o gera da i nterna mente pel o
E3, s endo i ncrementa da toda a vez que o
projeto s a l vo, ma nua l ou
a utoma ti ca mente. No ca s o de projetos
ou de bi bl i oteca s protegi dos , s e a vers o
n o puder s er s a l va , ta mbm n o
pos s vel i ncrement -l a . No enta nto, s e o
us u ri o tem permi s s o pa ra a bri r e
a l tera r o projeto ou a bi bl i oteca , a
vers o i ncrementa da norma l mente.
38
OPO
DESCRIO
Mos tra o coment ri o rel a ci ona do a o
projeto. Es te coment ri o pode s er
edi ta do a tra vs da propri eda de
DocString. No ca s o de bi bl i oteca s , es te
ca mpo fi ca em bra nco.
Comentrio
NOTA: Es tes ca mpos s o a pena s pa ra vi s ua l i za o, n o s endo permi ti da s ua

edi o.
2.4.6 WatchWindow
A ferramenta WatchWindow permite a visualizao do valor corrente de qualquer
propriedade ou Tag em tempo de execuo no E3 Studio. Para utilizar esta
ferramenta, clique em
na barra de ferramentas Padro ou utilize o menu
Ferramentas - WatchWindow para mostrar a caixa de dilogo da figura a seguir.
Caixa de dilogo WatchWindow
39
E3 Studio
As opes desta caixa de dilogo so mostrada na tabela a seguir.

Opes disponveis na caixa de dilogo WatchWindow
OPO
Adicionar
Remover
Atualizar
Conectar
Nome
Qualidade
Estampa de tempo
Valor
Status
DESCRIO
Abre o Doma i nBrows er (um AppBrows er
com os objetos cri a dos no s ervi dor) e
s el eci ona o objeto que mos tra do na
ja nel a do Wa tchWi ndow.
Remove a l i nha s el eci ona da da l i s ta de
objetos do Wa tchWi ndow.
Bus ca toda a rvore de fi l hos dos objetos
s el eci ona dos a tua l mente pel o
Wa tchWi ndow.
Tenta rea ti va r a conex o perdi da com o
Domni o pa ra que a vi s ua l i za o s eja
pos s vel .
Indi ca o Ta g ou a propri eda de s endo
vi s ua l i za da .
Indi ca a qua l i da de do Ta g ou da
propri eda de.
Indi ca a es ta mpa de tempo do Ta g ou da
propri eda de.
Indi ca o va l or do Ta g ou da propri eda de,
em tempo de execu o.
Indi ca s e o Domni o es t conecta do ou
des conecta do.
2.5 Organizer
O Organizer permite uma viso simples e organizada de toda a aplicao, ajudando
na edio e configurao de todos os objetos envolvidos, atravs de uma rvore
hierrquica de opes. Possui dois modos de visualizao, Domnio e Explorer.
E3 Studio
40
Organizer
O modo Domnio mostra apenas as informaes dos objetos abertos pertencentes

ao Domnio. Estas informaes esto organizadas em quatro grupos: Configurao,
Bibliotecas de Objetos, Visualizao e Objetos de Servidor. Cada grupo apresenta
seus objetos ordenados alfabeticamente dentro do respectivo n.
41
E3 Studio
Modo Domnio
O grupo Configurao mostra os servidores configurados, bem como os nomes dos

arquivos de projetos e de bibliotecas pertencentes ao Domnio.
O grupo Bibliotecas de Objetos agrupa os objetos ElipseX de todas as bibliotecas
pertencentes ao Domnio, organizados por tipo de objetos (XObjects e XControls).
Os demais objetos do E3 esto nos grupos Visualizao e Objetos de Servidor. Em
Visualizao esto os objetos que rodam na mquina cliente. J os objetos
executados na mquina servidor esto em Objetos de Servidor.
O modo Explorer mostra projetos e bibliotecas abertos no E3 Studio, pertencentes
ou no ao Domnio. Os objetos so mostrados no projeto ou na biblioteca ao qual
pertencem, ordenados alfabeticamente dentro de cada um.
E3 Studio
42
Modo Explorer
A manuteno da aplicao pode ser feita em qualquer um dos dois modos. As

operaes realizadas em um modo so imediatamente refletidas no outro. Para
facilitar a localizao dos objetos, ambos os modos so intercambiveis, tanto
entre si como com a aba Design da view do objeto. Para alternar o modo de
visualizao, siga estes procedimentos:
1. No modo Domnio, clique com o boto direito do mouse no objeto e selecione
Mostrar no Explorer para visualiz-lo no modo Explorer.
2. No modo Explorer, clique com o boto direito do mouse no objeto e selecione
Mostrar no Organizer para visualiz-lo no modo Domnio.
3. Em qualquer um dos modos, clique com o boto direito do mouse no objeto e
selecione Mostrar no Editor para visualiz-lo diretamente na aba Design.
4. Em qualquer view de objetos, na aba Design, clique com o boto direito do
mouse no objeto e selecione Mostrar no Organizer ou Mostrar no Explorer para
visualiz-lo no Organizer, em seu respectivo modo.
Ao clicar em um objeto com o boto esquerdo do mouse, suas propriedades podem
ser visualizadas e editadas atravs da Lista de Propriedades, se habilitada.
Clicando com o boto direito do mouse em cada item do Organizer, so mostradas
as opes da tabela a seguir.
Opes disponveis no Organizer
OPO
Fechar
Atualizar
Registrar
43
DESCRIO
Fecha o projeto ou bi bl i oteca corrente.
Atua l i za a s confi gura es do projeto ou
bi bl i oteca .
Regi s tra a bi bl i oteca pa ra que a s
modi fi ca es executa da s es teja m
di s ponvei s .
E3 Studio
OPO
Salvar Como
Desfragmentar
Proteo
Nova Pasta
Inserir
Inserir Recurso
Habilitar/Desabilitar projeto
Adicionar/Remover do Domnio
Procurar/Substituir
Contagem de Objetos
E3 Studio
DESCRIO
Abre uma ca i xa de di l ogo pa ra que o
projeto ou a bi bl i oteca s eja m s a l vos no
l oca l i ndi ca do.
Des fra gmenta a rqui vos (.l i b ou .prj), i s to
, fa z com que os es pa os cri a dos
des neces s a ri a mente (por excl us o de
i tens , i mporta o de a rqui vos , i ncl us o
de recurs os , etc.) s eja m a pa ga dos . Aps a
des fra gmenta o, uma ja nel a exi bi da
contendo a s s egui ntes i nforma es :
ta ma nho ori gi na l do a rqui vo, ta ma nho
des fra gmenta do e percentua l de
compa cta o.
Protege o contedo de um a rqui vo .prj ou
.l i b contra a edi o, vi s ua l i za o ou
execu o n o a utori za da . Ma i ores
i nforma es no ca ptul o Segurana.
Cri a uma nova Pa s ta na a pl i ca o.
Ins ere objetos di s ponvei s no E3 no
projeto ou na bi bl i oteca . Ma i s
i nforma es s obre es ta op o nos
res pecti vos ca ptul os de ca da objeto.
Ins ere recurs os no projeto ou na
bi bl i oteca .
Ha bi l i ta ou des a bi l i ta o projeto
s el eci ona do. Pa ra des a bi l i ta r o projeto,
s el eci one s eu nome e es col ha a op o
Desabilitar projeto. Obs erve que o cone do
projeto muda pa ra
, i ndi ca ndo que o
projeto es t des a bi l i ta do. Pa ra ha bi l i ta r o
projeto, s el eci one o projeto e es col ha a
op o Habilitar projeto.
Adi ci ona ou remove o projeto ou a
bi bl i oteca do Domni o. Pa ra remover o
projeto ou a bi bl i oteca , s el eci one s eu
nome e a ps a op o Remover do Domnio.
Pa ra a di ci on -l os a o Domni o, s el eci oneos e a ps a op o Adicionar ao Domnio.
Bus ca por trechos de texto e os s ubs ti tui
por outros , s e for o ca s o. Ma i ores
i nforma es s obre es ta op o na s e o
Procurar e Substituir des te ca ptul o.
Mos tra a qua nti da de de objetos
exi s tentes no Domni o ou no objeto
s el eci ona do. Es ta op o n o es t
di s ponvel pa ra os i tens Configurao,
Servidores, Arquivos e Domnios Remotos.
44
OPO
Importar/Exportar
Documentar Scripts
Verificar
Editar Associaes
Copiar/Colar Associaes
Propriedades
Carregar Todos os Objetos

Fechar Todos os Objetos
Salvar Todos os Objetos
45
DESCRIO
Auxi l i a o us u ri o na i mporta o e na
exporta o de objetos , As s oci a es e
col ees . Ma i ores i nforma es s obre es ta
op o na s e o Importao e Exportao
des te ca ptul o.
Auxi l i a o us u ri o com a documenta o
dos s cri pts da a pl i ca o. Ma i ores
i nforma es s obre es ta op o na s e o
Documentao de Scripts des te ca ptul o.
Veri fi ca os erros ocorri dos na a pl i ca o.
Ma i ores i nforma es s obre es ta op o na
s e o Verificar Domnio des te ca ptul o.
Muda uma ou ma i s As s oci a es , eventos
de us u ri o e propri eda des do ti po Link
fei ta s na a pl i ca o, de forma ma i s r pi da
do que pel a ja nel a tra di ci ona l . Ma i ores
i nforma es s obre es ta op o no ca ptul o
Associaes.
Copi a ou col a As s oci a es de um objeto
pa ra outro. A s egunda op o s
mos tra da s e o que es ti ver copi a do na
rea de Tra ns fernci a do Wi ndows for
uma As s oci a o. Se a propri eda de em
ques t o j pos s ui r uma As s oci a o,
mos tra da uma mens a gem a o us u ri o
pergunta ndo s e a As s oci a o deve s er
s obres cri ta ou n o.
Se a s As s oci a es copi a da s na rea de
Tra ns fernci a forem col a da s em um
objeto que n o pos s ua a l guma da s
propri eda des , es ta s s o l i s ta da s pa ra o
us u ri o em uma mens a gem i nforma ndo o
probl ema . As propri eda des que exi s ti rem
tm a s As s oci a es cri a da s correta mente.
As s oci a es de propri eda des es condi da s
dos El i ps eX n o s o copi a da s .
Abre a Ja nel a de Propri eda des do objeto.
Qua ndo es ta op o a berta pel o menu, a
pri mei ra a ba a s er a berta a de
confi gura es do objeto. Ma i s
i nforma es s obre es ta op o nos
res pecti vos ca ptul os de ca da objeto.
Ca rrega todos os objetos do grupo
s el eci ona do.
Fecha todos os objetos do grupo
s el eci ona do.
Sa l va todos os objetos do grupo
s el eci ona do.
E3 Studio
OPO
Novo Arquivo de Aplicao (.prj)
Nova Biblioteca de Objetos (.lib)
Registrar bibliotecas carregadas
Abrir Todos os Arquivos
Fechar Todos os Arquivos
Editar a Ordem de Ativao
E3 Studio
DESCRIO
Cri a um novo a rqui vo .prj e o i ncl ui no
Domni o.
Cri a um novo a rqui vo .l i b e o i ncl ui no
Domni o.
Regi s tra toda s a s bi bl i oteca s .
Percorre todos os a rqui vos .prj e .l i b do
Domni o. Se a l gum a rqui vo fecha do for
encontra do, el e a berto. Se o a rqui vo
es ti ver protegi do com s enha de edi o,
s ol i ci ta da a s ua s enha . O E3 Studi o tenta
uti l i za r a mes ma s enha em todos os
a rqui vos protegi dos . Se a s enha fa l ha r
com a l gum a rqui vo, el a s ol i ci ta da
nova mente.
Fecha todos os a rqui vos .prj e .l i b do
Domni o. Se a l gum a rqui vo tem a l tera es
n o s a l va s , pergunta do pa ra o us u ri o
s e el e des eja s a l v -l a s .
Permi te edi ta r a ordem de a ti va o dos
objetos de Servi dor no Domni o (ver fi gura
a s egui r).
46
Ordem de Ativao do Domnio
2.6 Importao e Exportao

A ferramenta de importao de objetos do E3 tem como objetivo ler as informaes
sobre os objetos de um arquivo CSV (Comma Separated Values) e recri-los no
ambiente de configurao (E3 Studio). Para cada objeto possvel obter
informaes sobre propriedades, Associaes e itens de colees.
A ferramenta de exportao de objetos do E3 tem como objetivo gravar informaes
sobre os objetos escolhidos a partir do ambiente de configurao (E3 Studio) em
um arquivo CSV. Para cada objeto podem ser gravadas suas propriedades,
Associaes e itens de colees. possvel, portanto:
Criar novos objetos do E3 a partir do arquivo CSV, desde que estes no sejam
diretamente objetos filhos do projeto ou biblioteca
Importar ou exportar qualquer propriedade de qualquer tipo de objeto do E3
Importar ou exportar qualquer tipo de Associao de objetos do E3
Exportar qualquer tipo de coleo de objetos do E3 e importar suas
propriedades
47
E3 Studio
Importar ou exportar qualquer tipo de item da coleo de objetos do E3

Qualquer objeto do E3 pode ser importado ou exportado. O objeto selecionado
para a operao chamado de objeto raiz. Com isto, possvel importar ou
exportar, por exemplo, uma Pasta de Dados com XObjects definidos pelo usurio,
ou mesmo exportar uma Tela, listando todos os objetos filhos.
Alm dos objetos, as Associaes e as colees tambm podem ser importadas e
exportadas. O usurio tem a opo de informar se quer importar ou exportar
Associaes e colees ou no.
NOTA: A ferra menta de i mporta o e exporta o cons i dera a pena s a s propri eda des
e As s oci a es dos objetos e col ees do E3. Informa es que n o es teja m des cri ta s
em propri eda des n o s o i mporta da s ou exporta da s . Es te o ca s o, por exempl o, de
s cri pts e confi gura es i nterna s dos objetos de Tel a .
2.6.1 Arquivo CSV

Um arquivo CSV (Comma Separated Values) um arquivo texto baseado em colunas
separadas por vrgula, ou por outro separador previamente definido. No E3, eles
contm as informaes sobre os objetos que foram exportados, e so utilizados na
importao para que estes 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 estes arquivos sejam utilizados corretamente, preciso observar alguns
detalhes:
A primeira linha do arquivo CSV deve conter um cabealho que identifica as
colunas corretamente
O cabealho deve ter obrigatoriamente uma coluna que identifica o tipo do
objeto que est sendo importado ou exportado. Esta coluna chama-se
ObjectType. O valor desta coluna o nome da classe do objeto (XObject1,
DrawRect, InternalTag, AgSimple, etc.), com exceo das colees, que
apresentam palavras-chave pr-definidas (ITableBindRow, IAxis, etc.)
O cabealho das demais colunas deve ser o prprio nome da propriedade
em questo
As colunas podem ser colocadas em qualquer ordem no arquivo; pode haver
colunas a mais ou a menos, sem prejuzo da operao de importao ou
exportao. A nica coluna obrigatria ObjectType, porque sem ela no
possvel identificar o tipo de objeto que deve ser criado
2.6.1.1 Criando um Arquivo CSV Manualmente

possvel criar um arquivo com extenso .csv a partir do Bloco de Notas, do Excel
ou de outro aplicativo do Windows. O arquivo criado considerando o separador
E3 Studio
48
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 deve ser uma propriedade ou um identificador definido no
modelo, conforme ser visto a seguir. Nas linhas devem ser colocados os objetos, e
os valores das propriedades nas colunas correspondentes. No necessrio que
todas as propriedades dos objetos sejam listadas no cabealho, bem como podem
existir colunas que no estejam associadas a propriedades de um determinado
objeto.
importante tambm que o arquivo CSV tenha uma coluna para a propriedade
Name. Sem ela, no possvel determinar exatamente onde o objeto em questo
deve ser criado. Os nomes mostram a hierarquia correta do objeto, e nomes com
caracteres especiais devem ser delimitados por colchetes.
A seguir, um exemplo de um arquivo CSV que pode ser criado manualmente no
Excel.
1. Abra o Excel e configure o cabealho com os campos, um em cada coluna,
conforme a figura a seguir.
Arquivo CSV visualizado no Excel
2. Salve a planilha com a extenso .csv.

3. Feche o arquivo no Excel.
4. Para importar este arquivo no E3, selecione um objeto IODriver e importe o
arquivo criado atravs da opo Importar, escolhendo o modelo adequado. O
49
E3 Studio
E3 cria a estrutura de acordo com o arquivo CSV.
2.6.2 Objetos
A importao ou a exportao de objetos no E3 pode ser feita a partir de qualquer
tipo de objeto, exceto projetos e bibliotecas. A operao a partir do objeto raiz
feita sobre suas propriedades e seus objetos filhos. Para exportar objetos, siga
estes procedimentos:
1. Clique com o boto direito do mouse no objeto desejado e selecione a opo
Exportar.
2. Na caixa de dilogo, selecione o arquivo CSV desejado e clique em Salvar.
Exportao de Objetos
Na exportao, todas as propriedades, Associaes, colees e itens de colees do

objeto selecionado e de seus filhos so automaticamente exportadas. gerado um
arquivo CSV com uma linha para cada objeto exportado, bem como para cada
Associao, coleo ou item de coleo existente nestes objetos. Para cada
propriedade criada uma coluna no arquivo, onde informado o valor da
propriedade para cada objeto.
O objeto selecionado, chamado de objeto raiz, exportado com a coluna da
propriedade Name em branco. Nos demais casos, esta coluna contm a hierarquia
com nomes separados por pontos. Exemplo de exportao a partir de um objeto
IODriver:
E3 Studio
50
Hierarquia do objeto
Driver1
ObjectType;Name;Prop1;Prop2;Prop3
IODriver;;0;True;0
IOBlock;Bloco1;0;False;0
IOBlockElement;Bloco1.Elemento1;0;False;0
IOBlock;Bloco2;0;False;0
IOTag;Tag1,0,True,0
Se desejar, o usurio pode configurar a exportao de objetos atravs do uso de

modelos, que so apresentados no tpico Modelos. Utilizando um modelo
possvel configurar se as Associaes, colees e itens de colees so ou no
exportados, se o objeto raiz exportado ou no e quais as propriedades de cada
objeto devem ser exportadas, entre outras configuraes. Para isto, siga estes
procedimentos:
Exportar.
2. Clique em Avanado para configurar ou selecionar um modelo.
3. Na caixa de dilogo, selecione o arquivo CSV desejado e clique em Salvar.
Para importar objetos, siga estes procedimentos:
Importar.
2. Na caixa de dilogo, selecione o arquivo CSV desejado e clique em Abrir.
51
E3 Studio
Importao de Objetos
Na importao, para cada linha lida do arquivo CSV identificado o objeto a 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 pode ter linhas como a seguir:
ObjectType;Name
IOFolder;Pasta1
As linhas em branco, as linhas onde no encontrado um identificador de tipo

vlido, as colunas em branco e as colunas que tenham nomes invlidos de
propriedades so ignoradas, sem gerar erro.
2.6.3 Modelos
Os Modelos so arquivos INI utilizados para configurar a ferramenta de
importao e exportao, informando, por exemplo, qual separador deve ser
utilizado no arquivo CSV, se as Associaes dos objetos devem ou no ser
exportadas, etc. Os arquivos INI tm o seguinte formato:
Linhas iniciadas por ponto e vrgula so comentrios, desconsiderados na
interpretao do arquivo
O arquivo organizado em sees, e cada seo contm uma ou mais
variveis. As sees so identificadas por nomes entre colchetes. As
E3 Studio
52
variveis so as palavras antes do smbolo de igualdade. Uma seo no

pode conter duas variveis com o mesmo nome
Linhas em branco so ignoradas
Um exemplo de arquivo INI mostrado a seguir:
; Primeira seo
[SECAO1]
Var1 = 0
Var2 = 1
; Segunda seo
[SECAO2]
Var1 = TRUE
Var3 = FALSE
O formato um texto facilmente modificvel pelo usurio, sendo possvel gerar um

modelo novo utilizando um editor de textos comum. O mesmo modelo pode ser
utilizado tanto para a importao como para a exportao de objetos.
Os modelos utilizados no E3 permitem que o usurio redefina valores para nomes
das colunas do arquivo CSV, bem como para os tipos de objetos. Alm disto,
tambm permitem que o usurio agrupe mais de uma propriedade em uma mesma
coluna. Isto tudo feito atravs da definio de identificadores, que so palavraschave utilizadas no arquivo CSV e associadas propriedades ou classes de objetos
no arquivo INI.
No E3, os modelos da ferramenta de importao e exportao esto definidos com
as sees e variveis descritas na tabela a seguir.
Sees definidas para os Modelos
SEO
Header (*)
Configuration
Types
53
DESCRIO
Defi ne os i denti fi ca dores permi ti dos
pa ra nomes de col una s e ti pos de da dos .
Nes ta s e o devem s er defi ni da s a s
va ri vei s header e types.
(*) Se o obri ga tri a pa ra a exporta o.
Defi ne confi gura es a di ci ona i s pa ra a
ferra menta de i mporta o e exporta o.
Nes ta s e o devem s er defi ni da s a s
va ri vei s separator, root, link, collection,
objectduplicated e bindduplicated.
Rel a ci ona os i denti fi ca dores de ti pos de
da dos com a s cl a s s es de objetos rea i s .
Ca da i denti fi ca dor l i s ta do na va ri vel
types que n o for i gua l a um nome de
cl a s s e de objeto deve es ta r
documenta do nes ta s e o, s endo cri a da
uma va ri vel pa ra ca da um dos
i denti fi ca dores .
E3 Studio
SEO
Columns
Filter
DESCRIO
Rel a ci ona os i denti fi ca dores de nomes
de col una s com os nomes de
propri eda des . Ca da i denti fi ca dor l i s ta do
na va ri vel header que n o for i gua l a um
nome de propri eda de deve es ta r
documenta do nes ta s e o, s endo cri a da
uma va ri vel pa ra ca da um dos
i denti fi ca dores .
Defi ne qua i s a s cl a s s es de objetos que
devem ou n o s er i mporta da s ou
exporta da s . Nes ta s e o deve s er
defi ni da uma da s dua s va ri vei s : include
ou exclude. Se a mba s forem defi ni da s ,
a pena s include cons i dera da .
Variveis definidas para os Modelos
SEO
header (*)
types
separator
root
link
E3 Studio
DESCRIO
Defi ne a ordem da s col una s e os
i denti fi ca dores que s o uti l i za dos . Devem
s er l i s ta da s toda s a s col una s que o a rqui vo
CSV tem, s epa ra da s por vrgul a s . Ca da
i denti fi ca dor que n o for i gua l a um nome
de propri eda de deve s er di s cri mi na do na
s e o Columns, ca da um com uma va ri vel .
(*) Va ri vel obri ga tri a pa ra a exporta o.
Defi ne os i denti fi ca dores pa ra os ti pos de
da dos permi ti dos no a rqui vo CSV. Os
i denti fi ca dores devem s er l i s ta dos nes ta
va ri vel s epa ra dos por vrgul a s . S
neces s ri o defi ni r es ta va ri vel s e a l gum
i denti fi ca dor for di ferente do nome da
cl a s s e do objeto. Nes te ca s o, pa ra ca da um
dos i denti fi ca dores deve ha ver ta mbm
uma va ri vel na s e o Types.
Defi ne o s epa ra dor que uti l i za do pa ra
del i mi ta r a s col una s no a rqui vo CSV. Ca s o
es ta va ri vel n o s eja defi ni da , uti l i za do
o s epa ra dor de l i s ta s confi gura do no
Wi ndows .
Defi ne s e o objeto ra i z exporta do ou
i mporta do junto com os objetos fi l hos .
Ca s o es ta va ri vel n o s eja defi ni da , o
objeto ra i z uti l i za do.
Defi ne s e a s As s oci a es dos objetos s o
exporta da s ou i mporta da s . Ca s o es ta
va ri vel n o s eja defi ni da , a s As s oci a es
s o uti l i za da s .
54
SEO
collection
objectduplicated
bindduplicated
collectionduplicated
55
DESCRIO
Defi ne s e a s col ees dos objetos s o
exporta da s ou i mporta da s . Ca s o es ta
va ri vel n o s eja defi ni da , a s col ees s o
uti l i za da s .
Defi ne o que fa zer qua ndo um objeto prexi s tente es ti ver s endo i mporta do. Os
va l ores pos s vei s pa ra es ta va ri vel s o:
0 - askalways: Sempre ques ti ona o
us u ri o s obre o que deve s er fei to
1 - changealways: Sempre a l tera a s
propri eda des do objeto exi s tente
2 - ignorealways: Sempre i gnora o objeto
s endo i mporta do
3 - createalways: Sempre cri a um objeto
novo, a uto-i ncrementa ndo o nome
Ca s o es ta va ri vel n o s eja defi ni da ,
a s s umi do o va l or askalways. Es ta op o n o
tem va l or na exporta o.
Defi ne o que fa zer qua ndo uma As s oci a o
pr-exi s tente es ti ver s endo i mporta da . Os
1 - changealways: Sempre s ubs ti tui a
As s oci a o exi s tente pel a nova
2 - ignorealways: Sempre i gnora a
As s oci a o s endo i mporta da
tem va l or na exporta o, nem ta mpouco
pos s ui o va l or createalways. Nes te ca s o,
s empre modi fi ca do pa ra askalways.
Defi ne o que fa zer qua ndo uma col e o
pr-exi s tente es ti ver s endo i mporta da . Os
1 - changealways: Sempre s ubs ti tui a
col e o exi s tente pel a nova
2 - ignorealways: Sempre i gnora a col e o
s endo i mporta da
tem va l or na exporta o, nem ta mpouco
pos s ui o va l or createalways. Nes te ca s o,
s empre modi fi ca do pa ra askalways.
E3 Studio
SEO
itemduplicated
include
exclude
DESCRIO
Defi ne o que fa zer qua ndo um i tem de
col e o pr-exi s tente es ti ver s endo
i mporta do. Os va l ores pos s vei s pa ra es ta
va ri vel s o:
1 - changealways: Sempre a l tera a s
propri eda des do i tem exi s tente
2 - ignorealways: Sempre i gnora o i tem
s endo i mporta do
3 - createalways: Sempre cri a um i tem
novo, a uto-i ncrementa ndo o nome
tem va l or na exporta o.
Defi ne qua i s cl a s s es de objetos devem s er
i mporta da s ou exporta da s . O fi l tro n o
recurs i vo, ou s eja , s e for i ncl uda uma
cl a s s e de um objeto que pos s a ter fi l hos ,
es tes fi l hos n o s o i ncl udos
a utoma ti ca mente. N o pode s er us a da
junto com a va ri vel exclude. Apena s o que
es ti ver defi ni do nes ta va ri vel exporta do
ou i mporta do.
Defi ne qua i s cl a s s es de objetos n o devem
s er i mporta da s ou exporta da s . O fi l tro n o
recurs i vo, ou s eja , s e for excl uda uma
cl a s s e de um objeto que pos s a ter fi l hos ,
es tes fi l hos n o s o excl udos
a utoma ti ca mente. N o pode s er us a da
junto com a va ri vel include. Apena s o que
es ti ver defi ni do nes ta va ri vel
des cons i dera do na i mporta o ou na
exporta o.
NOTA: O ca ra ctere de ponto e vrgul a n o pode s er uti l i za do como nome ou pa rte do

nome da col una , nem ta mpouco como nome ou pa rte do nome do i denti fi ca dor de
ti po. Es ta l i mi ta o s e deve a o fa to de es te ca ra ctere defi ni r um coment ri o no
a rqui vo INI. Des ta forma , a va ri vel cri a da na s e o Columns ou na s e o Types pa ra
defi ni r o i denti fi ca dor que pos s ui o ponto e vrgul a n o pode s er l i da correta mente.
Exemplo:
[Header]
header = ObjectType,Name,DocString,N1/B1,N2/B2,N3/B3,N4/
B4,Scan,AllowRead,AllowWrite
types = Tag,Bloco,Elemento
E3 Studio
56
[Configuration]
separator = ','
root = true
link = true
collection = true
objectduplicated = askalways
bindduplicated = askalways
collectionduplicated = askalways
itemduplicated = askalways
[Types]
Tag = IOTag
Bloco = IOBlock
Elemento = IOBlockElement
[Columns]
N1/B1 = N1,B1
N2/B2 = N2,B2
N3/B3 = N3,B3
N4/B4 = N4,B4
[Filter]
exclude = IOFolder
A Elipse Software fornece alguns modelos para importao e exportao de alguns

tipos de objetos. Estes modelos tambm podem ser utilizados como base para a
criao de outros. Os modelos fornecidos esto na pasta Templates da instalao
do E3.
NOTA: Na i mporta o, a s col una s uti l i za da s s o l i da s di reta mente do a rqui vo CSV.
Nes te ca s o es pecfi co, n o neces s ri a a va ri vel header no model o. Porm, s e
a l guma col una for nomea da por um i denti fi ca dor, es te deve es ta r defi ni do na
s e o Columns ou a col una i gnora da .
2.6.4 Gerenciador de Modelos

O Gerenciador de Modelos uma ferramenta para auxiliar o usurio na criao de
um arquivo INI para ser utilizado na importao ou exportao de objetos do E3.
Para acess-lo, clique na opo Importar/Exportar e, uma vez aberta a janela da
opo, clique em Avanado. Caso o usurio j tenha carregado um modelo, os
valores iniciais das opes nas abas da janela esto de acordo com o que foi
previamente configurado. As abas disponveis esto descritas a seguir.
Configuraes: Atravs desta aba, o usurio pode configurar as opes vlidas
tanto para a importao quanto para a exportao
57
E3 Studio
Aba Configuraes
E3 Studio
58
Opes disponveis na aba Configuraes

OPO
Separador de colunas
Outras opes
Salvar modelo
DESCRIO
As opes di s ponvei s s o: Usar o
separador de listas do Windows (es col he o
ca ra ctere defi ni do no Wi ndows como
s epa ra dor de l i s ta s pa ra s er us a do como
s epa ra dor de col una s do a rqui vo CSV) ou
Usar outro caractere como separador
(es col he outro ca ra ctere defi ni do pel o
us u ri o como s epa ra dor de col una s ).
Defi ne o que i mporta do ou exporta do:
objetos , As s oci a es ou col ees . As
opes di s ponvei s s o: Importar/exportar
o objeto raiz, Importar/exportar associaes
ou Importar/exportar colees.
Qua ndo a op o Salvar as alteraes deste
modelo em um arquivo INI for ma rca da ,
defi ni do o a rqui vo INI onde a s
a l tera es do model o s o s a l va s , e es te
a rqui vo pode s er reuti l i za do. Qua ndo for
des ma rca da , a s confi gura es fei ta s s o
s a l va s tempora ri a mente em um a rqui vo
na pa s ta de a rqui vos tempor ri os do
Wi ndows . Es te a rqui vo uti l i za do pa ra a
i mporta o ou exporta o rea l i za da l ogo
a ps a confi gura o, e removi do
pos teri ormente.
Importao: Atravs desta aba, o usurio pode configurar as opes vlidas

somente para a importao.
59
E3 Studio
Aba Importao
E3 Studio
60
Opes disponveis na aba Importao

OPO
Importao de objetos duplicados
Importao de associaes duplicadas
Importao de colees duplicadas
Importao de itens de coleo duplicados
DESCRIO
Es peci fi ca como o E3 deve l i da r com a
ocorrnci a de objetos dupl i ca dos na
i mporta o. As opes di s ponvei s s o
Questionar sobre o que fazer em cada caso,
Sempre sobrescrever o objeto existente,
Sempre ignorar o objeto duplicado ou
Sempre criar um novo objeto.
ocorrnci a de As s oci a es dupl i ca da s na
Sempre sobrescrever a associao existente
ou Sempre ignorar a associao duplicada.
ocorrnci a de col ees dupl i ca da s na
Sempre sobrescrever a coleo existente ou
Sempre ignorar a coleo duplicada.
ocorrnci a de i tens de col e o
dupl i ca dos na i mporta o. As opes
di s ponvei s s o Questionar sobre o que
fazer em cada caso, Sempre sobrescrever o
item existente, Sempre ignorar o item
duplicado ou Sempre criar um novo item.
Filtros: Atravs desta aba, o usurio pode escolher quais classes so utilizadas
na importao ou na exportao, ou quais classes no deseja utilizar
61
E3 Studio
Aba Filtros

Opes disponveis na aba Filtros
OPO
No filtrar objetos
E3 Studio
DESCRIO
Defi ne a i mporta o ou a exporta o de
todos os objetos .
62
OPO
Incluir apenas estes objetos
Excluir apenas estes objetos
Alterar
DESCRIO
Defi ne qua i s cl a s s es de objetos s o
i mporta da s ou exporta da s .
Defi ne qua i s cl a s s es de objetos n o
s o i mporta da s ou exporta da s .
Abre uma ja nel a pa ra s el e o da s
cl a s s es de objetos a s erem i ncl uda s ou
excl uda s .
Abre uma ja nel a de a juda pa ra a op o.
Clicando em Alterar, abre-se uma janela para a escolha de classes, mostrada na

figura a seguir.
Janela 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 em , ou remover alguma classe, clicando em .
Identificadores: Atravs desta aba, o usurio define os identificadores para as
classes de objetos escolhidas. O estado inicial desta lista vazio
63
E3 Studio
Aba Identificadores

Opes disponveis na aba Identificadores
OPO
Nome da classe
E3 Studio
DESCRIO
Indi ca o nome da cl a s s e s el eci ona da na
op o.
64
OPO
Identificador
DESCRIO
Permi te a o us u ri o a l tera r o va l or a s er
uti l i za do na col una ObjectType do
a rqui vo CSV. O va l or i ni ci a l nes ta col una
s empre o nome da cl a s s e do objeto.
Pa ra ca da va l or a l tera do a qui , cri a da
uma entra da no a rqui vo INI na s e o
Types. Os va l ores n o s o s ens vei s
ca i xa (i s to , "AAA", "a a a " e "a Aa " s o o
mes mo va l or). Ca s o o us u ri o defi na
va l ores i gua i s pa ra ma i s de um ti po,
a pena s o pri mei ro ti po cons i dera do
na i mporta o, e a l gum objeto pode s er
cri a do com o ti po erra do.
Adi ci ona cl a s s es de objetos .
Remove a cl a s s e de objetos
s el eci ona da .
Apres enta uma ja nel a com texto de
a juda .
Propriedades: Atravs desta aba, o usurio escolhe quais propriedades dos

objetos deseja utilizar na importao ou na exportao. O valor inicial da lista
ObjectType e as demais propriedades devem ser adicionadas manualmente
pelo usurio
65
E3 Studio
Aba Propriedades
E3 Studio
66
Opes disponveis na aba Propriedades

OPO
Nome da coluna
Propriedade
e
DESCRIO
Permi te a o us u ri o a l tera r o va l or a s er
uti l i za do como nome da col una no
ca bea l ho do a rqui vo CSV. O va l or i ni ci a l
des ta col una s empre o prpri o nome
da propri eda de do objeto. Pa ra ca da
va l or a l tera do nes ta col una , cri a da
uma entra da no a rqui vo INI na s e o
Columns. Os nomes da s col una s n o s o
s ens vei s ca i xa (i s to , "AAA", "a a a " e
"a Aa " s o o mes mo va l or). Ca s o o
us u ri o defi na nomes de col una s i gua i s
pa ra ma i s de uma propri eda de, a pena s
uma del a s i denti fi ca da correta mente,
e toda s a s col una s com o mes mo nome
s o rel a ci ona da s mes ma propri eda de.
Nes te ca s o, a l gum va l or pode s er
s obres cri to.
Indi ca a propri eda de s endo i mporta da
ou exporta da .
Redefi nem a ordem da s col una s a o
a l tera r a ordem da s propri eda des na
l i s ta .
Adi ci ona propri eda des l i s ta .
Excl ui propri eda des da l i s ta , com
exce o de ObjectType.
Al terna ti va mente, pode-s e uti l i za r a
tecl a DELETE pa ra excl ui r uma
propri eda de.
Cri a um nome de col una a s s oci a do a
ma i s de uma propri eda de. Sel eci one a s
propri eda des que des eja a grupa r e
cl i que nes ta op o. Os nomes da s
propri eda des s o a grupa dos em uma
mes ma l i nha , uti l i za ndo o nome da
col una defi ni do pa ra a propri eda de que
es t no topo da l i s ta .
Mos tra uma ja nel a com um texto de
a juda .
Ao clicar em , abre-se uma janela para a seleo de propriedades, mostrada na

figura a seguir.
67
E3 Studio
Janela Propriedades

Opes disponveis na janela Propriedades
OPO
Classes de objetos
Listar todas as classes de objetos do E3
Propriedades
DESCRIO
Apres enta a s cl a s s es de objetos que s e
enqua dra m no fi l tro es col hi do a pa rti r
do objeto ra i z.
Adi ci ona toda s a s propri eda des do ti po
de objeto s el eci ona do na op o
a nteri or.
Se es ta op o for s el eci ona da , a ca i xa
de s el e o de objetos mos tra toda s a s
cl a s s es exi s tentes no E3, i ndependente
de fi l tro ou objeto ra i z.
Mos tra a s propri eda des do objeto
s el eci ona do.
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
E3 Studio
68
propriedade havia sido agrupada com outras, o duplo-clique remove apenas esta
propriedade do agrupamento, mantendo as outras propriedades agrupadas
corretamente.
As propriedades do tipo TextFont possuem propriedades internas que configuram
separadamente tipo, tamanho e outras caractersticas da fonte. Elas so
exportadas com o nome da propriedade principal (de acordo com o objeto),
seguido do nome da propriedade interna, separados por um ponto (por exemplo,
TextFont.Bold). No configurador de modelos, as propriedades internas aparecem
separadas para o usurio, para que a escolha possa ser feita isoladamente.
Propriedades do Tipo TextFont
2.6.5 Importao de Objetos do SCADA para o E3

A partir da verso 2.29 do Elipse SCADA foram desenvolvidas funcionalidades que
facilitam a exportao de Tags, alarmes e alguns objetos de Tela do Elipse SCADA, e
a importao destes no E3.
69
E3 Studio
2.6.5.1 Tags de Comunicao (PLC e Bloco)

Os Tags de Comunicao do Elipse SCADA so exportados separadamente para
cada Driver. Para executar a exportao, abra a aplicao no Elipse SCADA e siga
1. No Organizer do Elipse SCADA, selecione o item Drivers e clique no Driver
desejado.
2. Clique em Exportar.
Exportao de Drivers
3. Selecione o local e o nome do arquivo a ser gerado. Alm do arquivo com as

configuraes dos Tags, gerado um arquivo com o mesmo nome, seguido do
sufixo _Alarms. Este arquivo utilizado posteriormente na importao da
configurao de alarmes no E3.
Para executar a importao dos Tags no E3, siga estes passos:
1. Insira um Driver de Comunicao no Organizer.
2. Renomeie o Driver para o mesmo nome do Driver utilizado na aplicao Elipse
E3 Studio
70
SCADA, para que posteriormente as referncias para os Tags deste Driver sejam
importadas corretamente.
3. Clique com o boto direito do mouse no Driver de Comunicao e selecione o
item Importar.
4. Na lista de tipos de arquivos, selecione a opo Arquivos do Elipse SCADA
(*.e2f), e a seguir selecione o arquivo exportado anteriormente, sem o sufixo
_Alarms. No necessrio selecionar um modelo.
Importao de Tags
2.6.5.2 Tags RAM e Demo

Para exportar os Tags RAM e Demo, siga estes passos:
1. No Organizer do Elipse SCADA, selecione o item Tags.
71
E3 Studio
Exportao de Tags RAM e Demo

configuraes dos Tags, gerado um arquivo com o mesmo nome seguido do
sufixo _Alarms. Este arquivo utilizado posteriormente na importao da
Para executar a importao dos Tags no E3, siga estes passos:
1. Insira um Servidor de Dados no Organizer.
2. Renomeie o Servidor de Dados para Dados, para que posteriormente as
Associaes dos objetos de Tela sejam importadas corretamente.
3. Clique com o boto direito do mouse no Servidor de Dados e selecione a opo
Importar.
E3 Studio
72
2.6.5.3 Configurao e Tags de Servidores OPC

1. No Organizer do Elipse SCADA, selecione o item OPCServers e clique no Driver
OPC desejado.
Exportao de Configuraes e Tags de Servidores OPC

configuraes dos Tags OPC, gerado um arquivo com o mesmo nome seguido
do sufixo _Alarms. Este arquivo utilizado posteriormente na importao da
Para executar a importao dos Tags OPC no E3 3.0, siga estes passos:
1. No Organizer, insira um novo Driver de Comunicao OPC.
2. Renomeie o Driver de Comunicao OPC para o mesmo nome do Driver OPC
utilizado na aplicao Elipse SCADA, para que posteriormente as referncias
para os Tags deste Driver OPC sejam importadas corretamente.
3. Clique com o boto direito do mouse no Driver OPC e selecione a opo
73
E3 Studio
Importar.
2.6.5.4 Configurao de Alarmes

A exportao da Configurao de Alarmes feita automaticamente ao exportar os
Tags, seguindo os passos descritos anteriormente. Alm do arquivo com os Tags,
gerado um arquivo com o mesmo nome acrescido do sufixo _Alarms. Por exemplo,
se o nome escolhido foi "TagsInternos", so gerados os arquivos TagsInternos.e2f e
TagsInternos_Alarms.e2f. Este segundo arquivo com o prefixo _Alarms contm a
configurao dos alarmes dos Tags exportados. Para importar estes alarmes no E3,
siga estes passos:
1. No Organizer, insira uma nova Configurao de Alarmes, e insira uma rea.
2. Clique com o boto direito do mouse na rea e selecione a opo Importar.
3. Se a importao foi realizada com sucesso, os alarmes devem aparecer sem
nenhuma mensagem de erro. Caso os Tags correspondentes j tenham sido
importados, todas as referncias devem aparecer na cor azul.
2.6.5.5 Telas
A exportao de Telas do Elipse SCADA parcial e suporta apenas um subconjunto
dos objetos de Tela. Para exportar uma Tela, siga estes passos:
1. No Organizer do Elipse SCADA, selecione o item Telas e clique na Tela desejada.
E3 Studio
74
Exportao de Telas
3. Selecione o local e o nome do arquivo a ser gerado.

4. No Organizer, insira uma nova Tela.
5. Clique com o boto direito do mouse na Tela e selecione a opo Importar.
(*.e2f), e a seguir selecione o arquivo exportado anteriormente. No
necessrio selecionar um modelo.
Se a importao foi realizada com sucesso, a Tela preenchida com os objetos, e
nenhuma mensagem de erro mostrada. Os arquivos de imagens utilizados pela
Tela devem ser tratados conforme um dos casos a seguir:
Arquivos de imagens com caminhos relativos na aplicao Elipse SCADA: Estes
arquivos devem ser inseridos manualmente como Recursos no projeto do E3.
possvel inserir vrios arquivos de uma vez, clicando com o boto direito
do mouse no item Recursos do Organizer e selecionando a opo Inserir
recurso em
Arquivos de imagens com caminhos absolutos: Estes arquivos devem
permanecer nos seus diretrios originais. O E3 os procura no mesmo
75
E3 Studio
diretrio onde so encontrados pela aplicao do Elipse SCADA

NOTA: recomenda do i ns eri r todos os a rqui vos no projeto como Recurs os , pa ra que
o E3 Vi ewer pos s a executa r o download a utoma ti ca mente pel a rede. Is to evi ta a
neces s i da de de i ns ta l a r os a rqui vos ma nua l mente na s m qui na s cl i ente.
2.6.6 Associaes
Para a importao ou a exportao de Associaes no E3, deve ser selecionada a
opo correspondente no modelo. No h como excluir apenas um ou outro tipo de
Associao. Ou todas so importadas ou exportadas ou nenhuma.
Cada Associao ocupa uma linha no arquivo CSV. A identificao das Associaes
feita atravs das seguintes palavras-chave:
AgSimple: Associaes Simples, Bidirecionais ou Reversas (estas devem ser
diferenciadas pelas propriedades Reverse e Bidirectional)
AnalogBind: Associaes Analgicas
AnimationBind: Associaes Digitais
TableBind: Associaes por Tabela
As propriedades ou os campos das Associaes so importados ou exportados
como se fossem propriedades de objetos, com uma coluna no arquivo CSV para
cada uma delas. Todas as Associaes possuem as propriedades Source e Property
e, alm delas, as propriedades existentes para cada Associao so as seguintes:
AgSimple: Reverse, Bidirectional
AnalogBind: SrcHiValue, SrcLoValue, DstHiValue, DstLoValue
AnimationBind: BlinkOn, BlinkOff, OnValue, OffValue, BlinkOnValue,
BlinkOffValue
A criao de linhas da tabela respeita o ndice informado pelo usurio. Se o ndice
no for um nmero, mostrada uma mensagem de erro (nome invlido). Se for um
ndice inexistente (por exemplo, s existem duas linhas na tabela e o usurio quer
inserir a linha cinco), as linhas que faltam so criadas e ficam com os valores
padro.
Todas as Associaes so importadas ou exportadas, independente da seleo de
propriedades que o usurio tenha feito. Se uma Associao para determinada
propriedade j existir, o usurio questionado sobre o que fazer. Caso contrrio,
elas so criadas.
E3 Studio
76
Importao de uma Associao pr-existente
No nome do objeto deve ser informado o caminho completo, no formato

Objeto.Links.Nome. Exemplo:
'Links indica que uma Associao
'e Value a propriedade que possui a Associao
Texto1.Links.Value
2.6.7 Colees e seus Itens

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

pode ser auto-incrementado (as colunas da Legenda tm nomes prdefinidos e no possvel criar colunas com outros nomes)
No nome do objeto deve ser informado o caminho completo, no formato
Objeto.Collection.Name. Exemplo:
E3Chart1.Pens.Pena1
Na coluna de tipo deve aparecer uma das seguintes palavras-chave:

IDispChartPen: Penas do E3Chart
ILegendColumn: Legendas do E3Chart
IAxis: Eixos do E3Chart
ITableBindRow: Linhas das Associaes por Tabela
2.6.8 Logs e Relatrios de Falhas

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

A Lista de Propriedades uma janela de configurao das propriedades do objeto
selecionado.
O ttulo da Lista de Propriedades mostra sempre o nome do objeto selecionado no
momento. Para que esta janela esteja visvel no projeto, necessrio que a opo
esteja selecionada no menu Visualizar. A figura a seguir
mostra a Lista de Propriedades de um objeto Elemento de Bloco de Comunicao
com suas propriedades ordenadas alfabeticamente.
Lista de Propriedades ordenada alfabeticamente
A Lista de Propriedades da figura a seguir mostra o objeto anterior com suas

propriedades ordenadas por categoria.
79
E3 Studio
Lista de Propriedades ordenada por categoria

NOTA: No ca s o de s el e o ml ti pl a de objetos , a Li s ta de Propri eda des mos tra
a pena s a s propri eda des comuns a os objetos s el eci ona dos , com s eus va l ores
corres pondendo a o l ti mo objeto s el eci ona do. O mes mo cri tri o uti l i za do s e a
Li s ta de Propri eda des es t ordena da por ca tegori a , ou s eja , a s ca tegori a s
mos tra da s corres pondem s do l ti mo objeto s el eci ona do.
O rodap da Lista de Propriedades mostra uma descrio rpida da propriedade

selecionada. As opes disponveis nesta janela esto descritas na tabela a seguir.
Opes disponveis na Lista de Propriedades
CONE
E3 Studio
OPO
Ordenar por categoria
DESCRIO
Mos tra a s propri eda des
do objeto s el eci ona do
orga ni za da s por
ca tegori a s .
80
CONE
OPO
Ordenar alfabeticamente
Procurar
DESCRIO
Mos tra a s propri eda des
do objeto s el eci ona do
orga ni za da s
a l fa beti ca mente.
Permi te fi l tra r a l i s ta gem
pel o nome ou pa rte do
nome da propri eda de.
Pode-se configurar o valor de uma propriedade digitando diretamente na sua

respectiva coluna Valor. direita do nome da propriedade existe um cone que
indica o seu estado atual: O cone indica que o valor da propriedade o padro,
ou seja, seu valor no foi modificado pelo usurio, e o cone indica que o valor
da propriedade foi modificado pelo usurio (o valor modificado aparece em
negrito). Alm disto, clicar neste cone abre um menu contextual com as opes
descritas na tabela a seguir.
Opes disponveis no menu contextual de uma propriedade
OPO
Resetar
Copiar
Colar
Editar
DESCRIO
Reverte o va l or da propri eda de
s el eci ona da pa ra s eu va l or pa dr o, ca s o
tenha s i do modi fi ca do pel o us u ri o.
Copi a o va l or da propri eda de
s el eci ona da pa ra a rea de
Tra ns fernci a .
Col a o va l or da rea de Tra ns fernci a no
va l or da propri eda de s el eci ona da .
Permi te edi ta r o va l or da propri eda de
s el eci ona da .
NOTA: As opes do menu contextua l de uma propri eda de podem es ta r ha bi l i ta da s

ou des a bi l i ta da s , dependendo do ti po de da dos da propri eda de.
2.8 Galeria
Coleo de objetos grficos que podem ser arrastados e inseridos nas Telas das
aplicaes. Estes objetos so arquivos do tipo Metafiles (WMF, Windows
MetaFile).
81
E3 Studio
Galeria
2.9 AppBrowser
O AppBrowser uma ferramenta que auxilia o usurio a montar a aplicao
informando uma expresso lgica, uma Associao ou um valor para a
propriedade sendo manipulada, de acordo com o objeto selecionado. Assim,
possvel minimizar erros durante a criao da aplicao.
E3 Studio
82
AppBrowser
No quadro esquerda so mostrados os objetos do E3 que podem ser utilizados

para compor o texto que o resultado do uso do AppBrowser. De acordo com seu
contexto de utilizao, alguns objetos no podem ser utilizados e nem so
mostrados aqui.
No quadro central so mostradas as propriedades e os mtodos do objeto
selecionado, e no quadro direita o texto de ajuda da propriedade ou do mtodo
selecionado.
Mais abaixo mostrado o texto resultante do AppBrowser, ao lado das opes
Colar e Cancelar. Clique em Colar para aceitar o resultado e copiar o valor para o
local desejado. Clique em Cancelar para ignor-lo.
NOTAS:
Ao s el eci ona r Ta gs , o AppBrows er s empre a berto na l ti ma pos i o, e n o na
pos i o a ponta da pel o link a tua l .
O AppBrows er pos s ui a fun o Auto Complete: ba s ta di gi ta r o nome do objeto
des eja do pa ra s el eci on -l o a utoma ti ca mente.
Existem trs maneiras de se utilizar o AppBrowser:

Atravs de scripts
Atravs de Associaes
Atravs de algumas propriedades de objetos que possuem como valor um
outro nome de objeto
Cada uma destas maneiras abordada nos tpicos seguintes.
83
E3 Studio
2.9.1 Acesso via Script

Para utilizar o AppBrowser a partir de um script, basta abrir a view de scripts
desejada e clicar em na barra de ferramentas Scripts. Neste modo, os objetos
esto separados conforme a figura a seguir.
AppBrowser via Scripts
No quadro esquerda:
O primeiro item, mostrado isoladamente, o Contexto. O objeto contexto o
que originou a chamada do AppBrowser, ou seja, o dono do script
O segundo item a Hierarquia completa para se chegar ao objeto contexto,
caso o contexto no esteja na raiz do projeto. Este 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
o Viewer (objeto Application)
O quarto item o Servidor. Nele so listados todos os objetos do servidor
que a aplicao possui. Caso este item seja o contexto atual, ele contm a
indicao de Application
O quinto item chamado de Tarefas. Nele aparecem as tarefas mais comuns
de serem executadas atravs de um script. So duas: Carregar relatrio (cujo
resultado do AppBrowser a expresso para carregar um Relatrio) e Abrir
tela (cujo resultado a expresso para abrir a Tela selecionada, equivalente
ao Pick Abrir Tela)
Finalmente, o sexto item mostra todas as funes do VBScript disponveis
para uso em scripts
E3 Studio
84
De acordo com o objeto selecionado, o quadro central mostra suas propriedades e

seus mtodos.
2.9.2 Acesso via 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 em
direita. O AppBrowser aberto e os objetos so
apresentados conforme a figura a seguir.
AppBrowser via Associaes
Neste caso, apenas as propriedades dos objetos so mostradas no quadro central

da janela. Seus mtodos no so mostrados, pois no permitido us-los em
Associaes.
2.9.3 Acesso via Propriedade

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

DBServer dos objetos Frmula, Histrico e Storage
DataSource do objeto Servidor de Alarmes
InitialScreen do objeto Viewer
SplitLink do objeto Quadro
2.10 Conectar A
A opo Conectar a utilizada para determinar a conexo do E3 Studio a um
servidor. Esta opo permite configurar em qual servidor de Domnio o E3 Studio
deve se conectar, e permite tambm informar se o E3 Studio deve obter a licena do
servidor onde roda o Domnio ou se deve obter a licena em um outro servidor.
Para utilizar este recurso, clique no menu Arquivo - Conectar a para abrir a caixa
de dilogo mostrada na figura a seguir.
E3 Studio
86
Janela Conectar a
Opes disponveis na janela Conectar a
OPO
Conectar ao servidor local
Conectar a um servidor na rede
Pegar licena no servidor de Domnio atual

Usar licena de um servidor especfico
DESCRIO
Ha bi l i ta a conex o com o s ervi dor l oca l .
Ha bi l i ta a conex o com um s ervi dor da
rede. Pa ra i s to, s el eci one o s ervi dor
us a ndo a ca i xa de s el e o.
Us a l i cena do s ervi dor onde roda o
Domni o.
Us a a l i cena de outro s ervi dor, que n o
o s ervi dor que es t roda ndo o Domni o.
Se a conexo com qualquer dos dois servidores (Domnio ou licena) cair, o E3

Studio desconectado do outro servidor. A ltima configurao guardada no
Registro do Windows e, da prxima vez em que o E3 Studio for aberto, ele se
conecta aos servidores de Domnio e de licena utilizados da ltima vez.
Se o servidor de licena no estiver disponvel, ou se no houver mais licenas
disponveis, ento o E3 Studio permanece em modo Demo. Um E3 Studio sem
licena (modo Demo) s pode se conectar a um servidor de Domnio que tambm
esteja em modo Demo.
Se o servidor de licena for diferente do servidor de Domnio, o nome do servidor de
licena mostrado no ttulo da janela do E3 Studio: Licena no servidor local ou
Licena em <Nome_Servidor>.
Se for especificado um servidor de licena, a janela de licenas do E3 Server no
servidor de Domnio mostra o nome do servidor que est emprestando a licena
87
E3 Studio
para o E3 Studio: SERVIDOR1 (licena emprestada de SERVIDOR2). Neste caso a

licena que est listada no servidor de Domnio no entra na contagem de licenas
de E3 Studio em uso naquele servidor.
Se o servidor de Domnio no possuir uma licena, e um E3 Studio se conectar a
este servidor usando a licena de outro, ento o servidor de Domnio passa
temporariamente de modo Demo para modo Studio, voltando para modo Demo
assim que a sesso do E3 Studio for fechada.
NOTA: Qua ndo o E3 Studi o es ti ver uti l i za ndo uma l i cena empres ta da de outro
s ervi dor, el e deve foros a mente perma necer a berto enqua nto o a pl i ca ti vo es ti ver
em execu o. Se el e for fecha do enqua nto o a pl i ca ti vo es ti ver roda ndo, a l i cena de
E3 Studi o empres ta da (que permi te a execu o do a pl i ca ti vo por s ei s hora s )
l i bera da , e o E3 Server fi na l i za a execu o do a pl i ca ti vo i medi a ta mente (em no
m xi mo 10 s egundos ).
DICA: Qua ndo o us u ri o conecta r a um s ervi dor, i mporta nte que os a pl i ca ti vos
s eja m a bertos a tra vs de um ca mi nho na rede. Ao i nvs de us a r C:\projetos
\projeto.dom, uti l i ze o ca mi nho \\s erver\projetos \projetos .dom. Des ta forma , o E3
Studi o e o E3 Server remoto podem a ces s a r os a rqui vos uti l i za ndo o mes mo
ca mi nho.
E3 Studio
88
CAPTULO
Domnios
Um Domnio um conjunto de objetos e configuraes que definem um sistema de

superviso. Corresponde ao Aplicativo no Elipse SCADA.
O E3 um ambiente modular de desenvolvimento e execuo de sistemas de
superviso, composto pelos mdulos descritos nas sees a seguir.
3.1 E3 Server
O E3 Server o coordenador de todos os mdulos do E3. Ele sempre roda como
servio, mesmo no modo Demo, seja ele registrado como servio ou com o
parmetro /regserver, e deve estar sempre rodando. Pode tambm ser iniciado
quando um E3 Studio local for iniciado, ou atravs de um atalho para rodar o
Domnio (por exemplo, e3admin start app.dom). Ele responsvel por:
Verificar e gerenciar licenas de uso dos diferentes mdulos do E3
Iniciar, parar ou monitorar o processo de runtime (E3Run) do Domnio
Abrir, editar ou manipular arquivos DOM
Controlar o acesso de usurios aos objetos do Domnio
Monitorar outros servidores do Domnio e implementar o Hot-Standby
O E3 Server pode trabalhar com apenas um arquivo de Domnio por vez, e este
chamado de Domnio aberto. Os arquivos de Domnio s so manipulados pelo E3
Server.
3.1.1 Licenciamento
O E3 Server suporta dois modos de licenciamento: Licena Ativa e Demo. O modo de
licenciamento definido na inicializao do servidor. Se h um dispositivo de
proteo vlido (do tipo Hardkey ou Softkey), o E3 Server entra em modo Licena
Ativa. Se nenhum dispositivo for localizado, entra em modo Demo.
Se houver a troca do dispositivo, o E3 Server compara as licenas deste novo
dispositivo com as licenas do dispositivo anterior, e executa os seguintes ajustes:
Se as novas licenas forem exatamente iguais em limitaes s do
dispositivo anterior, so aplicadas imediatamente
Se as novas licenas forem menos limitadas do que as do dispositivo
anterior, tambm so aplicadas imediatamente
89
Domnios
Se as novas licenas forem mais limitadas do que as do dispositivo anterior,

o E3 Server aguarda por um minuto para que o dispositivo anterior seja
reconectado. Ao final deste perodo, se as licenas continuarem restritivas, o
servidor reiniciado e as novas licenas so aplicadas
NOTA: Pa ra ma i ores i nforma es s obre l i cenci a mento no E3, entre em conta to com
o setor comercial da El i ps e Softwa re.
3.2 E3Run
O E3Run o processo responsvel pela execuo dos objetos do servidor: Tags,
Alarmes, Banco de Dados, Histricos, etc., ou seja, todos os objetos exceto as Telas
e o objeto Viewer.
A execuo do E3Run indicada no cone do E3 Admin na rea de Notificao do
Windows, de acordo com a tabela a seguir.
Opes disponveis para cones da rea de Notificao
OPO
DESCRIO
Seta verde: Mos tra da qua ndo o Domni o
es t ca rrega do e roda ndo.
Qua dra do ci nza : O Domni o es t
ca rrega do, ma s n o roda ndo.
Li nha reta a ma rel a (gi ra tri a ): Mos tra da
qua ndo o Domni o es t s endo i ni ci a do
ou pa ra do. Ocorre nos ca s os em que o
Domni o demora a comea r a execu o,
como um s i na l de es pera .
Ba rra s a ma rel a s : Mos tra da s qua ndo o
Domni o es t em es pera .
O E3Run sempre roda como servio, seja ele registrado como servio ou com o
parmetro /regserver. Este processo usa o protocolo REC para se conectar fila de
banco de dados do E3 Server.
3.3 E3 Admin
O E3 Admin o mdulo responsvel por monitorar e comandar o E3 Server.
simbolizado pelo cone
na rea de Notificao do Windows. Este mdulo
iniciado quando o usurio loga no Windows, ou quando o servio do E3 Server
iniciado.
O E3 Admin tambm responsvel por tratar as opes de controle do Domnio via
linha de comando, das seguintes maneiras: e3admin <nome_do_dominio> [opes]
ou e3admin [opes] <nome_do_dominio>. As opes de linha de comando so
listadas a seguir:
Domnios
90
-start ou /start: Inicia um Domnio informado pelo usurio. O uso desta

opo no obrigatrio. Mesmo se no for informada, o Domnio iniciado
-viewer ou /viewer: Executa o Viewer para a aplicao
-load: Semelhante opo -start, porm somente carrega o Domnio, sem
execut-lo. No pode ser usada com a opo -viewer
-stop: Para o Domnio em execuo, quando existir. Esta opo deve ser
utilizada sozinha
-close: Para e fecha o Domnio em execuo, quando existir. Esta opo deve
ser utilizada sozinha
-refresh: Fora a atualizao do Domnio sem a utilizao de um Viewer
-help: Mostra uma caixa de dilogo com as opes de linha de comando
para o E3 Admin, como na figura a seguir
Caixa de dilogo com as opes de linha de comando do E3 Admin
Se as opes -load, -start ou -viewer forem utilizadas, o Windows Vista ou superior

pode pedir autorizao de Administrador (processo tambm conhecido como
elevao de privilgios) quando o E3 Admin no foi iniciado por um usurio
Administrador do sistema (e dependendo da configurao do Controle de Conta de
Usurio do Windows).
91
Domnios
Caso o usurio logado no seja Administrador e a configurao do Controle de

Conta do Usurio do Windows no permita a janela de autorizao, o prprio E3
Admin mostra uma mensagem de erro, como na figura a seguir.
Mensagem de erro do E3 Admin

NOTA: O Wi ndows deve s er rei ni ci a do pa ra que a s confi gura es do Controle de Conta
de Usurio s eja m a pl i ca da s .
Caso existam restries no Domnio, as opes -load, -stop, -refresh e -close pedem
o login do usurio do E3.
3.4 IOServer
O IOServer o processo responsvel pela execuo dos Drivers de Comunicao.
Cada Driver roda em um IOServer separado. Os IOServers so criados, mantidos e
monitorados pelo processo E3Run.
3.5 E3 Studio
O E3 Studio o ambiente de desenvolvimento e configurao de aplicativos.
Permite abrir e editar arquivos .prj ou .lib. O E3 Studio multi-usurio, isto ,
vrios E3 Studios podem modificar os mesmos arquivos ao mesmo tempo. O E3
Studio utiliza a conexo REC para se comunicar com o E3 Server.
3.6 E3 Viewer
O E3 Viewer a interface com o usurio em tempo de execuo, pois mostra as
Telas em execuo e permite a operao do sistema. O E3 Viewer pode ser
executado a partir de qualquer ponto da rede que tenha acesso ao E3 Server, sem a
necessidade de copiar o aplicativo para os outros E3 Viewers, pois as Telas e os
bitmaps so carregados conforme a necessidade, em tempo de execuo.
Domnios
92
3.7 Componentes
Um Domnio constitudo dos arquivos descritos nas sees seguintes.
3.7.1 Arquivo de Configurao

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

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

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

Existem duas maneiras de se criar um Domnio no E3:
Atravs do menu Arquivo - Novo Domnio. Para isto, necessrio que ao menos
um projeto ou uma biblioteca esteja aberto. Ao selecionar esta opo, o E3 abre
uma caixa de dilogo para a escolha do caminho e do nome do novo Domnio
93
Domnios
Criando um novo Domnio
A seguir, o usurio deve decidir se deseja incluir projetos ou bibliotecas abertos no

novo Domnio criado.
Confirmao de insero do projeto ou biblioteca no novo Domnio
Atravs do Assistente de Aplicaes do E3, que permite a criao de um Domnio

novo com um arquivo de projeto (.prj) ou uma biblioteca (.lib), conforme a
prxima seo
3.8.1 Assistente de Aplicaes

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:
Clicando em Novo
Domnios
, na barra de ferramentas Padro

94
Atravs do menu Arquivo - Novo Projeto

Uma vez que o Assistente tenha sido acessado, a tela inicial aberta. Para
continuar, clique em Avanar.
Tela inicial do Assistente de Aplicaes
3.8.1.1 Tipo de Aplicao

Nesta tela, pode-se escolher entre a criao de uma Aplicao padro, uma
Biblioteca de componentes do E3 ou uma Aplicao em branco.
Uma Aplicao padro aquela cujo projeto possui pelo menos um objeto Viewer,
uma Tela e um Servidor de Dados, tendo ainda a opo de inserir, com a ajuda do
Assistente, um Driver de Comunicao, um Banco de Dados, um Servidor de Alarmes
e uma Configurao de Alarmes.
NOTA: As tel a s Dri ver de Comuni ca o, Ba nco de Da dos e Al a rmes s s o mos tra da s
na cri a o de uma Apl i ca o pa dr o.
Uma Biblioteca de componentes do E3 um arquivo utilizado para guardar

diversos componentes que podem ser utilizados em aplicaes.
95
Domnios
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 salva deve ser especificado no item Salvar a aplicao na pasta. Caso
seja necessrio, clique em Procurar.
Tela Tipo de Aplicao
Caso a pasta informada no exista, o usurio avisado, e deve decidir se deseja

cri-la.
Domnios
96
Aviso de pasta inexistente
Clique em Avanar para prosseguir.

NOTA: A op o Biblioteca de componentes do E3 di s cuti da ma i s a di a nte, no ca ptul o
Bibliotecas.
3.8.1.2 Domnio
Nesta tela, possvel decidir a qual Domnio pertence o projeto ou a biblioteca que
est sendo criado. A seleo da opo Adicionar no Domnio ativo condicionada
existncia de Domnios ativos no sistema. Clicando nesta opo, o novo projeto faz
parte do Domnio atual. A opo Criar um novo Domnio cria um novo Domnio, ao
qual o projeto ou biblioteca pertence. 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 continua sem pertencer a nenhum
Domnio.
97
Domnios
Tela Domnio
3.8.1.3 Resoluo do Viewer

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

Nesta tela, o usurio pode decidir pela incluso de um objeto Driver de
Comunicao no projeto sendo criado. Caso positivo, possvel configurar o
arquivo .dll que este Driver utiliza, na opo Arquivo do driver de comunicao.
Para procurar o arquivo, clique em .
99
Domnios
Tela Driver de Comunicao
3.8.1.5 Banco de Dados

Nesta tela, o usurio pode decidir pela incluso de um objeto Banco de Dados no
projeto sendo criado. Caso positivo, possvel configurar o arquivo .mdb que este
Banco de Dados utiliza, na opo Nome do arquivo de banco de dados Access. Para
procurar o arquivo, clique em .
Domnios
100
Tela Banco de Dados
3.8.1.6 Alarmes
Nesta tela, o usurio pode decidir pela incluso de um objeto Servidor de Alarmes e
de um objeto Configurao de Alarmes no projeto sendo criado. A opo Desejo
guardar os dados dos alarmes em disco habilita o armazenamento de informaes
relativas a alarmes em disco, desde que um objeto Banco de Dados tenha sido
inserido no projeto.
101
Domnios
Tela Alarmes
Clique em Avanar para finalizar a criao da aplicao.

Aps, o Studio mostra a tela final do Assistente, com uma mensagem que indica o
final do processo de criao da aplicao.
Domnios
102
Tela final do Assistente de Aplicaes
Finalize o processo clicando em Concluir.
3.9 Configuraes
Atravs do menu do E3 Admin na rea de Notificaes do Windows, possvel
executar, parar, atualizar ou fechar o Domnio diretamente atravs das opes
Executar, Parar, Atualizar e Fechar, respectivamente.
Alm disto, o Domnio tambm pode ser configurado para apresentar redundncia e
utilizar Domnios Remotos, entre outras aes. Estas configuraes so feitas
atravs da opo Domnio - Opes.
103
Domnios
Opes de configurao via rea de Notificaes do

Windows
NOTA: O menu Domnio - Opes n o es t di s ponvel no modo Demo, e a s opes de
Executar e Parar n o es t o di s ponvei s s e o Domni o es ti ver em modo Hot-Standby ou
for a berto em um computa dor que n o fa z pa rte do Domni o.
Domnios
104
3.9.1 Aba Opes

Na aba Opes possvel habilitar a redundncia de servidores.
Aba Opes

OPO
Hot-Standby
Servidor principal
105
DESCRIO
Aci ona o modo Hot-Standby. Se a op o for
des a bi l i ta da , o Domni o executa do no
s ervi dor em que foi ca rrega do, s em s uporte
a Hot-Sta ndby. Se a op o for ha bi l i ta da ,
pos s vel s el eci ona r um s ervi dor pri nci pa l
onde o Domni o executa do e,
opci ona l mente, um s ervi dor em es pera .
Sel eci ona o nome do s ervi dor pri nci pa l
pa ra execu o do Domni o. Pa ra ca da s tra r e
confi gura r os s ervi dores , uti l i ze a a ba
Servidores.
Domnios
OPO
Servidor de backup
Endereos para PING de integridade da

rede
Ativar backup em caso de falha local
Tempo para ativao do servidor reserva
Domnios
DESCRIO
Se ha bi l i ta da , s el eci ona um s ervi dor de
backup pa ra execu o do Domni o. Es te
s ervi dor fi ca em es pera , com o a pl i ca ti vo
ca rrega do no E3Run pronto pa ra s er
executa do ca s o o s ervi dor pri nci pa l fa l he,
ou ca s o o s ervi dor de backup s eja a ti va do
ma nua l mente.
O a l gori tmo de Hot-Sta ndby exi ge que s eja
decl a ra da uma tercei ra enti da de de rede
(a s outra s dua s s o os s ervi dores pri nci pa l
e o backup) pa ra determi na r s e a rede es t
funci ona ndo. Se n o for pos s vel a ces s a r o
endereo de i ntegri da de nem o s ervi dor de
backup, o s ervi dor pri nci pa l a s s ume que a
s ua i nterfa ce de rede es t com probl ema s
e termi na i medi a ta mente a execu o do
Domni o. Es te ca mpo permi te que v ri os
endereos de rede s eja m regi s tra dos . As
opes pa ra es te ca mpo s o a s s egui ntes :
Os s epa ra dores permi ti dos pa ra ca da um
dos endereos s o o es pa o, a vrgul a , o
ponto e vrgul a , a ta bul a o e a quebra
de l i nha
Se pel o menos um dos endereos
forneci dos nes te ca mpo retorna r
s uces s o, a rede cons i dera da s em
fa l ha s
Os nomes de s ervi dores n o s o
s ens vei s ca i xa
Nomes repeti dos s o des ca rta dos
Es pa os em bra nco a ntes ou depoi s do
endereo s o removi dos
Ha bi l i ta a troca a utom ti ca de s ervi dores
qua ndo uma fa l ha l oca l reporta da no
s ervi dor pri nci pa l . Fa l ha s l oca i s s o
detecta da s e reporta da s pel o prpri o
a pl i ca ti vo a tra vs do mtodo
Application.ReportFailure. A troca de
s ervi dores s executa da s e o s ervi dor de
backup es ti ver s em fa l ha s .
Permi te i ndi ca r o tempo de a ti va o pa ra o
s ervi dor de backup. O va l or pa dr o 15
s egundos . Es te tempo a feta di reta mente o
timeout do ping entre os s ervi dores . Se for
mui to a ba i xo (troca em um s egundo,
timeout de ping em 160 ms ), podem ocorrer
troca s es pont nea s de s ervi dor, ca us a da s
por pequena s fa l ha s de rede.
106
OPO
Perfil de pr-ativao do servidor reserva
Pr-ativar os seguintes servios
DESCRIO
Apres enta os s egui ntes perfi s de pra ti va o di s ponvei s :
Mnimo: Ati va a pena s os s ervi os b s i cos
Mximo: Fa z com que o E3 a ti ve o m xi mo
de objetos qua ndo es t em es pera
(As s oci a es , Dri vers , s cri pts e Ba ncos de
Da dos )
Definido pelo usurio: O us u ri o pode
defi ni r qua i s os s ervi os des eja a ti va r.
Ca da uma da s opes pode s er
ha bi l i ta da ou des a bi l i ta da
i ndi vi dua l mente
Permi te a o us u ri o es col her os s ervi os
que des eja a ti va r (des de que a op o
a nteri or tenha s i do ha bi l i ta da como
Definido pelo usurio):
Associaes (Links): O va l or pa dr o
des a bi l i ta do. Se ha bi l i ta do, fa z com que
As s oci a es e propri eda des do ti po Link
de XObjects s eja m a va l i a da s dura nte a
a ti va o em es pera
Drivers de E/S (sem comunicao): O va l or
pa dr o des a bi l i ta do. Se ha bi l i ta do, os
IOServers s o cri a dos dura nte a a ti va o
em es pera . NOTA: Es ta op o
i mporta nte em a pl i ca ti vos com v ri os
Dri vers de Comuni ca o
Scripts: O va l or pa dr o des a bi l i ta do. Se
ha bi l i ta do, fa z com que todos os s cri pts
de eventos de objetos e de bi bl i oteca s
s eja m compi l a dos e a ti va dos dura nte a
a ti va o em es pera
Banco de Dados: O va l or pa dr o
ha bi l i ta do. Is to s i gni fi ca que o Ba nco de
Da dos conecta do dura nte a a ti va o
em es pera . Se des a bi l i ta do, el e a pena s
evi ta que a conex o com o Ba nco de
Da dos s eja cri a da dura nte a a ti va o em
es pera
Es ta op o ha bi l i ta da a utoma ti ca mente
qua ndo o va l or da propri eda de
EnableSynchronization for i gua l a Verda dei ro.
NOTA: Qua ndo o Domni o col oca do em execu o, o E3 Server s empre es col he o
s ervi dor a ti vo por ordem a l fa bti ca , i ndependente de es ta r s el eci ona do como
pri nci pa l ou backup. Es te cri tri o de des empa te uti l i za do s empre que ma i s de um
s ervi dor s e ca ndi da ta a executa r o Domni o. Pa ra ma i ores i nforma es , veja o
ca ptul o Hot-Standby.
107
Domnios
Quando o Hot-Standby estiver ligado, os seguintes procedimentos so necessrios:

Definir um diretrio compartilhado na rede para conter a cpia principal
dos arquivos do Domnio. Este diretrio deve residir em um computador que
no faa parte do Domnio E3
Criar em cada servidor do E3 um diretrio onde mantida uma cpia
atualizada dos arquivos do Domnio. O E3Run utiliza esta cpia local dos
arquivos PRJ e LIB
Abrir sempre o arquivo DOM da rede, utilizando o caminho de rede (por
exemplo, \\server\folder\Domnio.dom)
Quando utilizar o E3 Studio, sempre editar os projetos e bibliotecas da cpia
principal (na rede). Para aplicar as alteraes, copie os projetos e
bibliotecas alterados para o diretrio local dos servidores do Domnio. Aps
a cpia, clique em Executar Aplicativo no E3 Studio para que as alteraes
sejam aplicadas no processo de tempo de execuo (E3Run)
NOTA: A REDUNDNCIA NO EST DISPONVEL EM MODO DEMO. Qua ndo o modo HotStandby es ti ver l i ga do, neces s ri o que todos os s ervi dores tenha m uma cpi a dos
a rqui vos do Domni o (.dom, .prj e .l i b) e a mes ma rvore de di retri os .
3.9.2 Aba Segurana

Atravs da aba Segurana, possvel determinar as configuraes de segurana do
Domnio. Esta opo utilizada como padro, caso no seja habilitada nenhuma
das opes de permisso de segurana nos usurios do projeto. Para acessar este
item, clique com o boto direito do mouse no cone do E3 Admin na rea de
Notificaes do Windows, selecione a opo Domnio - Opes e clique na aba
Segurana. A janela da figura a seguir mostrada.
Domnios
108
Aba Segurana

Opes disponveis na aba Segurana
OPO
O usurio no pode alterar a sua senha
DESCRIO
Impede que o us u ri o troque a s enha
em tempo de execu o.
Determi na o pra zo de va l i da de da s enha
A senha expira aps ... dias
do us u ri o. Antes de termi na r o pra zo de
va l i da de da s enha , o s i s tema a vi s a
qua ntos di a s res ta m pa ra expi ra r. Aps a
s enha expi ra r, o us u ri o fi ca
des a bi l i ta do.
A senha deve conter no mnimo ... caracteres Determi na a qua nti da de mni ma de
ca ra cteres pa ra a s enha do us u ri o.
Determi na que a s enha do us u ri o deve
A senha deve conter letras e nmeros
conter l etra s e nmeros .
A senha deve conter no mnimo ... nmeros Determi na a qua nti da de mni ma de
nmeros na s enha .
109
Domnios
OPO
A senha deve conter no mnimo ... letras
DESCRIO
Determi na a qua nti da de mni ma de
l etra s na s enha .
Determi na que a s enha do us u ri o deve
A senha deve conter letras maisculas e
conter l etra s ma i s cul a s e mi ns cul a s .
minsculas
Bloquear a conta do usurio aps ... falhas de Determi na a qua nti da de m xi ma de
fa l ha s de l ogi n pa ra que a conta do
login
us u ri o s eja bl oquea da .
Des bl oquei a a conta do us u ri o depoi s
Desbloquear o usurio automaticamente
de determi na dos mi nutos .
aps ... minutos
Avisar o usurio nos ltimos ... dias antes da Determi na a da ta em que o s i s tema
comea a envi a r mens a gens di ri a s a o
senha expirar
us u ri o, a vi s a ndo-o s obre a da ta de
expi ra o de s ua s enha . Aps es ta da ta ,
s e o us u ri o n o troca r s ua s enha , el e
bl oquea do e s omente o a dmi ni s tra dor
pode des bl oque -l o.
Validar senhas sem diferenciar maisculas e Permi te que a s s enha s s eja m va l i da da s
s em di ferenci a r ma i s cul a s de
minsculas
mi ns cul a s . Es ta op o n o
recomenda da .
Bloqueio de Senha
A conta de um usurio pode ser bloqueada nas seguintes condies:
Se a senha expirar (o tempo de expirao pode ser atributo global, de grupo
ou de usurio)
Se o usurio digitar a senha errada um determinado nmero de vezes
seguidas, isto , falhas de login
Uma vez bloqueada, a conta no permite login. Esta condio persiste at que um
administrador desbloqueie a senha manualmente, ou ento o timeout de bloqueio
expire.
3.9.3 Aba 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 so 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 Admin na rea de Notificaes do Windows, selecione a opo Domnio Opes e clique na aba Grupos de Viewers. A janela da figura a seguir mostrada.
Domnios
110
Aba Grupos de Viewers

Opes disponveis na aba Grupos de Viewers
OPO
Nome
Adicionar / Remover
Nome do grupo
Lista de IPs
111
DESCRIO
Li s ta os nomes de todos os grupos de
Vi ewers .
Adi ci ona ou remove grupos de Vi ewers .
Ha bi l i ta a cri a o ou a l tera o de nomes
de grupos de Vi ewers .
Es peci fi ca qua i s IPs pertencem a o grupo,
e des te modo compa rti l ha m os mes mos
l i mi tes de conex o. Qua ndo um Vi ewer
tenta s e conecta r a o E3 Server, s eu IP
compa ra do a os grupos exi s tentes . Aps
determi na do o grupo a o qua l pertence,
a pl i ca da a res tri o de l i cena s a es te
Vi ewer, confi gura da pa ra a quel e grupo.
Domnios
OPO
Adicionar / Editar / Remover
Permitir conexes de Viewer Full

Limitar uso de licenas simultneas
Permitir conexes de Viewer Only

Limitar uso de licenas simultneas
DESCRIO
Adi ci ona , edi ta ou remove os nmeros
de IP. Qua ndo um grupo cri a do, el e n o
tem nenhum IP es peci fi ca do (exceto o
pri mei ro grupo, que s empre *.*.*.*, e
n o pode s er cri a do pel o us u ri o). Ca s o
o us u ri o tente s a l va r a confi gura o e
a l gum grupo tenha uma l i s ta de IPs
va zi a , o s i s tema emi te um a vi s o. Ca s o o
grupo s eja ma nti do a s s i m, el e n o tem
uti l i da de.
Qua ndo s el eci ona da , permi te conexes
do ti po Viewer Full pa ra o grupo.
Qua ndo s el eci ona da , l i mi ta o us o de
l i cena s do ti po Viewer Full s i mul t nea s
a um determi na do nmero. Se a op o
a nteri or es ti ver ma rca da , ma s es ta
es ti ver des ma rca da , o us o de l i cena s
s i mul t nea s i l i mi ta do.
Qua ndo s el eci ona da , permi te conexes
do ti po Viewer Only pa ra o grupo.
Qua ndo s el eci ona do, l i mi ta o us o de
l i cena s do ti po Viewer Only s i mul t nea s
a um determi na do nmero. Se a op o
a nteri or es ti ver ma rca da , ma s es ta
es ti ver des ma rca da , o us o de l i cena s
s i mul t nea s i l i mi ta do.
importante notar que estes limites so aplicados aps o limite do E3 Server, como
configurado no dispositivo de proteo. Por exemplo, se o dispositivo de proteo
possuir dez licenas de Viewer e o grupo especificar cinco conexes no mximo,
apenas estas cinco so usadas. No entanto, se o dispositivo de proteo possuir
cinco licenas de Viewer e o grupo especificar dez conexes no mximo, utilizado
o limite de cinco conexes do dispositivo. Ou seja, o grupo de Viewer tem sempre
uma limitao de licenas adicional a ser aplicada na conexo do Viewer.
A configurao de Grupos de Viewers deve ser feita preferencialmente com o
Domnio parado. Caso seja feita com o Domnio em execuo, ela no tem efeito at
que todos os Viewers sejam desconectados.
Domnios
112
NOTA: No ca s o de conexes i denti fi ca da s como E3AccessLayer e E3DataAccess, que

por pa dr o n o cons omem l i cena s do E3 Server, o comporta mento dos Grupos de
Vi ewers o s egui nte:
Se o Grupo de Vi ewers n o permi ti r conexes do ti po Viewer Full nem do ti po
Viewer Only, a conex o nega da
Se o Grupo de Vi ewers permi ti r conexes do ti po Viewer Full, a conex o
permi ti da e obedece a o ti po de a ces s o requi s i ta do. Por exempl o, pa ra a ces s os
do ti po Viewer Only a conex o a pena s de l ei tura , e pa ra a ces s os do ti po Viewer
Full a conex o de l ei tura e es cri ta
Se o Grupo de Vi ewers permi ti r a pena s conexes do ti po Viewer Only, a conex o
permi ti da e s omente de l ei tura , mes mo pa ra a ces s os do ti po Viewer Full
3.9.4 Aba Registro de Eventos

Os eventos dividem-se em duas categorias: Eventos Padro do Sistema e Eventos
Manuais.
Eventos Padro do Sistema so os eventos gerados automaticamente pelo E3, e que
podem ter o registro habilitado ou desabilitado individualmente:
Login ou Logout de usurio
Troca de senha de usurio
Falha de login de usurio
Alterao na base de dados de usurio
Bloqueio de conta de usurio
Incio ou trmino do Domnio
Alterao no Domnio (inserir, remover, habilitar ou desabilitar projetos e
bibliotecas, alterar a configurao do Domnio)
Atualizao do Domnio (quando o usurio aplica as alteraes feitas em
projetos, atravs do E3 Studio)
Troca manual de servidor Hot-Standby
Eventos Manuais so eventos definidos pelo aplicativo. Estes eventos so gerados
em scripts de usurio, atravs da chamada do mtodo Application.TrackEvent. Estes
eventos podem ser gerados tanto no Viewer quanto no Servidor (E3Run).
O Viewer apenas um gerador de eventos manuais. Basta chamar o mtodo
Application.TrackEvent, e o evento enviado para o E3 Server.
O diagrama a seguir mostra como os diferentes processos do E3 geram e tratam os
eventos do sistema:
113
Domnios
Diagrama de processos
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 so
gravados.
Para configurar o registro de eventos do E3, clique com o boto direito do mouse no
cone do E3 Admin na rea de Notificao do Windows, selecione a opo Domnio Opes, e clique na aba Registro de Eventos. A janela da figura a seguir mostrada.
Domnios
114
Aba Registro de Eventos

Opes disponveis na aba Registro de Eventos
OPO
DESCRIO
Registrar os eventos do sistema em uma Ha bi l i ta o regi s tro de eventos no E3.
tabela no Banco de Dados do aplicativo
Selecionar automaticamente um Banco de Ha bi l i te es ta op o pa ra dei xa r que o
E3Run es col ha um objeto Servi dor de Da dos
Dados no aplicativo
pa ra gra va r os da dos . Se o a pl i ca ti vo
pos s ui a pena s um Servi dor de Da dos , es te
objeto us a do. Se ti ver ma i s de um,
recomenda do s el eci ona r a op o Usar este
Banco de Dados.
115
Domnios
OPO
Usar este Banco de Dados
DESCRIO
Ha bi l i te es ta op o pa ra es peci fi ca r o
Servi dor de Da dos onde s o gra va dos os
eventos . Se o nome do Servi dor de Da dos
foi i nforma do i ncorreta mente, os eventos
fi ca m a rma zena dos na fi l a de eventos do
E3 Server (em memri a ), a t que s eja
i ndi ca do um Servi dor de Da dos v l i do.
Indi que o nome da ta bel a onde s o
Nome da tabela
gra va dos os eventos . A ta bel a i nforma da
cri a da a utoma ti ca mente pel o E3Run, e tem
os s egui ntes ca mpos :
E3TimeStamp (Da ta /Hora ): O ca mpo
E3TimeStamp confi gura do pel o E3Run e
contm a da ta e hora em que o E3Run
cons egui u envi a r o evento pa ra o Ba nco
de Da dos
EventTime (Da ta /Hora ): O ca mpo
EventTime a da ta e hora em que
rea l mente ocorreu o evento, a da ta e
hora a tua l do s ervi dor (Hot ou Standby)
qua ndo o evento foi cri a do, ou ent o o
pa r metro dtTimeStamp es peci fi ca do
pa ra o mtodo Application.TrackEvent
EventMessage (String): Mens a gem do
evento (m xi mo de 200 ca ra cteres )
EventComment (String): Coment ri o s obre
o evento (m xi mo de 200 ca ra cteres )
Marque abaixo os eventos que devem ser Li s ta os eventos di s ponvei s no s i s tema ,
pa ra s erem regi s tra dos .
registrados
Se o E3Run tiver que escolher entre vrios Servidores de Dados, normalmente

utilizado o primeiro Banco de Dados ativado na execuo do Domnio. Se durante a
execuo do Domnio, o usurio desabilitar o projeto que contm o Servidor de
Dados que estava sendo usado para gravar os eventos, o E3Run automaticamente
escolhe outro Servidor de Dados que esteja disponvel no aplicativo, e continua
com este Servidor de Dados at que outro Servidor de Dados anterior seja
reativado. Isto implica que, se houver mais de um Servidor de Dados no projeto,
possvel que alguns eventos sejam gravados em um Servidor de Dados e outros
eventos em outro Servidor de Dados (por isto, recomendado indicar um Servidor
de Dados especfico, quando houver mais de um Servidor de Dados no projeto).
Quando um evento selecionado na lista e a tecla F2 pressionada, abre-se uma
caixa de dilogo para edio do evento. A janela mostrada na figura a seguir
mostrada.
Domnios
116
Edio de eventos
Desmarque a opo Usar mensagem padro para alterar a mensagem do evento.

Clique em
para inserir uma macro dentro da mensagem. Apenas as macros
permitidas para aquele evento so mostradas.
Visualizao da macro disponvel para o evento
As macros sempre tm o formato %MACRO%. As seguintes macros podem ser

usadas:
%%: Insere um sinal de % na mensagem
117
Domnios
%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 executa o login no Viewer
que est rodando na mquina CLIENT004, gerado o seguinte evento:
"Falhou login do usurio Admin no computador CLIENT004 (usando
um Viewer): login ou senha incorretos"
Os eventos padro do sistema so descritos nas sees seguintes.
3.9.4.1 Login de Usurio

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

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

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

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

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

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

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

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

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

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

Adicionado projeto "nomedoprojeto" (habilitado)
Adicionado projeto "nomedoprojeto" (desabilitado)
Removido projeto "nomedoprojeto"
Desabilitado projeto "nomedoprojeto"
3.9.4.11 Troca Manual de Servidores

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

possvel adicionar, remover ou editar os projetos (arquivos .prj) de um Domnio.
Para acessar este item, clique com o boto direito do mouse no cone do E3 Admin
na rea de Notificaes do Windows, selecione a opo Domnio - Opes e clique
na aba Projetos. A janela da figura a seguir mostrada.
121
Domnios
Aba Projetos

Opes disponveis na aba Projetos
OPO
Nome
Adicionar / Remover
Nome do projeto
Domnios
DESCRIO
Es ta op o l i s ta os nomes dos projetos
no s i s tema .
Atra vs des ta s opes , pode-s e remover
ou a di ci ona r projetos no s i s tema . Pa ra
a di ci ona r um projeto, cl i que em Adicionar
e es peci fi que o ca mpo Nome do projeto.
Pa ra remover um projeto, s el eci one-o e
cl i que em Remover. O a rqui vo PRJ n o
a pa ga do do di s co, a pena s removi do da
l i s ta de projetos do Domni o.
Di gi te o nome do a rqui vo do projeto, que
deve s er um ca mi nho rel a ti vo a o
di retri o do Domni o (o di retri o que
contm o a rqui vo .dom). Exempl os :
Tel a s .prj, Hi dro\Es ta ca o1.prj
122
OPO
Em manuteno (execuo desabilitada)
DESCRIO
Es ta op o permi te des a bi l i ta r a
execu o do projeto, evi ta ndo a
ocorrnci a de erros qua ndo o Domni o
executa do. Qua ndo a op o ha bi l i ta da ,
o cone i ndi ca que o projeto n o
uti l i za do. Os projetos com o cone es t o
ha bi l i ta dos e s o executa dos .
3.9.6 Aba Servidores

possvel adicionar, remover ou editar os servidores de um Domnio. Use a lista da
esquerda para selecionar um ou mais servidores a alterar. A lista indica tambm se
o servidor est habilitado , em modo Manuteno ou desabilitado . Para
acessar este item, clique com o boto direito do mouse no cone do E3 Admin na
rea de Notificaes do Windows, selecione a opo Domnio - Opes e clique na
aba Servidores. A janela da figura a seguir mostrada.
Aba Servidores

123
Domnios
Opes disponveis na aba Servidores

OPO
Nome
Adicionar e Remover
Nome do servidor
Identificao do servidor na rede
Pasta raiz dos arquivos do Domnio
Em manuteno (execuo desabilitada)
DESCRIO
Li s ta com os nomes dos s ervi dores no
s i s tema .
ou a di ci ona r s ervi dores no s i s tema . Pa ra
a di ci ona r um s ervi dor em rede, cl i que em
Adicionar e es peci fi que os ca mpos Nome
do servidor e Identificao do servidor na
rede. Pa ra a di ci ona r um s ervi dor l oca l ,
es peci fi que o i tem Caminho local de acesso
aos arquivos de Domnio. Pa ra remover um
projeto, s el eci one-o na l i s ta e cl i que em
Remover.
Determi na o nome do s ervi dor. Es te nome
defi ni do pel o us u ri o.
Di gi te o nome do s ervi dor na rede. Deve
s er o nome da m qui na com ou s em a s
ba rra s dupl a s i nverti da s no i nci o (por
exempl o, \\s erver ou s erver).
Indi ca a pa s ta onde es t o l oca l i za dos os
a rqui vos do Domni o (a rqui vos .prj, .l i b,
etc.) do s ervi dor s el eci ona do. A op o No
especificar (utilizar a pasta do arquivo .DOM)
o pa dr o, e i ndi ca que os a rqui vos
es t o na mes ma pa s ta do a rqui vo de
Domni o (.dom). Ca s o s eja s el eci ona da a
op o Utilizar a seguinte pasta local, o
ca mi nho di gi ta do no ca mpo es pecfi co
deve conter a pena s a pa s ta , s em o nome
nem a extens o do a rqui vo de Domni o
(.dom).
Es ta op o permi te des a bi l i ta r o s ervi dor
e n o uti l i z -l o na execu o do Domni o.
Qua ndo a op o ha bi l i ta da , o cone
i ndi ca que o s ervi dor n o uti l i za do. Do
contr ri o, o cone i ndi ca que o s ervi dor
pode s er uti l i za do.
3.9.7 Aba Domnios Remotos

Permite adicionar, remover ou editar os Domnios Remotos. Use a lista da esquerda
para selecionar um ou mais Domnios Remotos a alterar. Para acessar tal item,
clique com o boto direito do mouse no cone do E3 Admin na rea de Notificaes
do Windows, selecione a opo Domnio - Opes e clique na aba Domnios
Remotos. A janela da figura a seguir mostrada.
Domnios
124
Aba Domnios Remotos

Opes disponveis na aba Domnios Remotos
OPO
Nome
Adicionar / Remover
Nome do Domnio
Arquivo de Domnio
125
DESCRIO
Es ta op o l i s ta os nomes dos Domni os
Remotos no s i s tema .
ou a di ci ona r Domni os Remotos no
s i s tema . Pa ra a di ci ona r um Domni o
Remoto em rede, cl i que em Adicionar e
es peci fi que os ca mpos Nome e Arquivo de
Domnio. Pa ra remover um Domni o,
s el eci one-o na l i s ta e cl i que em
Remover.
Determi na o nome do Domni o Remoto.
Es te nome defi ni do pel o us u ri o.
Determi na o nome ou o ca mi nho na rede
onde es t o a rqui vo .dom do Domni o
Remoto.
Domnios
OPO
Servidor Principal
Servidor de Backup
Usurio no Domnio
Usurio
Senha
DESCRIO
Identi fi ca o s ervi dor pri nci pa l na rede.
Qua ndo ha bi l i ta do, i denti fi ca o s ervi dor
de backup na rede.
Permi te reconhecer um us u ri o com
s enha pa ra ca da Domni o Remoto. As
opes di s ponvei s s o: No especificar
(annimo), e Utilizar a seguinte conta. Ao
s el eci ona r a s egunda op o, os ca mpos
Usurio e Senha s o ha bi l i ta dos .
Identi fi ca o us u ri o.
Permi te a conex o a o Domni o a tra vs de
s enha .
possvel que uma configurao de Domnio Remoto possibilite a conexo ao

prprio Domnio local. A isso se d o nome de Alias local ou conexo Loopback.
Este alias criado segundo a configurao normal de Domnios Remotos. Basta que
o nome dos servidores (principal ou backup) seja localhost* ou o mesmo da
mquina onde o Domnio est rodando para que tudo funcione localmente. Neste
caso, para que a configurao funcione no E3 Studio, no campo Arquivo de
Domnio, basta colocar diretamente o caminho local do arquivo DOM (por exemplo,
c:\caminho\arquivo.dom).
NOTAS:
A muda na dos aliases l oca i s com o Domni o roda ndo NO s uporta da . O que
a contece que, s e o Domni o es ti ver roda ndo, Links j res ol vi dos como l oca i s
conti nua m s empre l oca i s , mes mo que o alias s eja reconfi gura do pa ra conecta r em
uma m qui na remota rea l mente. Pa ra contorna r i s to, ba s ta rei ni ci a r o Domni o
As conexes do ti po loopback n o a pa recem na ja nel a Licenas (ou Estatsticas) do
E3 Admi n e nem neces s i ta m de l i cena de Domni os Remotos pa ra funci ona r
* Pa ra que o nome localhost funci one, neces s ri o que el e es teja confi gura do
pa ra a ponta r pa ra o endereo IP 127.0.0.1 (que a confi gura o pa dr o do
Wi ndows )
Pa ra ma i ores i nforma es s obre a s confi gura es da a ba Domnios Remotos, veja
o i tem Configurao da Conexo
3.9.8 Aba Propriedades

Permite controlar configuraes diversas do Domnio. Para acessar este item,
do Windows, selecione a opo Domnio - Opes e clique na aba Propriedades. A
janela da figura a seguir mostrada.
Domnios
126
Aba Propriedades

OPO
Pool Habilitado
127
DESCRIO
Ha bi l i ta ou des a bi l i ta o pool de
proces s os IOServer. NOTA: Certi fi que-s e
que os Dri vers em us o na a pl i ca o
s uporta m o recurs o de pool de proces s os
(os Dri vers devem ter s i do compi l a dos
com o IOKit verso 2.0.6 ou s uperi or). Os
Dri vers que n o s uporta m es te recurs o
devem s er confi gura dos com a
propri eda de DisableIOServerPool em
Verda dei ro. O va l or pa dr o des ta op o
Fa l s o.
Domnios
OPO
Drivers por Processo
Nmero Mximo de Processos
DESCRIO
Defi ne o nmero m xi mo de Dri vers que
roda m em ca da proces s o do IOServer.
NOTA: Es te l i mi te pode s er ul tra pa s s a do
ca s o o nmero de proces s os do pool
chegue a o m xi mo confi gura do na op o
Nmero Mximo de Processos. O va l or
pa dr o des ta op o 0 (zero).
Defi ne o nmero m xi mo de proces s os
IOServer que s o cri a dos pel o pool. O
va l or 0 (zero, pa dr o) nes ta op o
permi te um nmero i l i mi ta do de
proces s os .
Esta configurao pode ser alterada com o Domnio em execuo, porm somente
afeta os Drivers iniciados aps a alterao, ou nas situaes em que o Domnio
atualizado:
Ao clicar em
no E3 Studio
Ao selecionar a opo Domnio - Atualizar, no menu do E3 Admin na rea de

Notificaes do Windows
Ao gerar um evento que force o E3Run a receber a configurao do Domnio
NOTA: Pa ra ma i ores i nforma es , veja o tpi co Pool de Processos IOServer no ca ptul o
Drivers.
3.10 Outras Opes da rea de Notificao

Alm das opes listadas na seo anterior, existem outras configuraes
acessadas atravs do menu do E3 Admin na rea de Notificaes do Windows.
3.10.1 Atalhos
Esta opo permite executar aplicativos presentes na instalao do E3 diretamente
pelo menu contextual do cone do E3 Admin, na rea de Notificao do Windows.
Os seguintes aplicativos podem ser executados:
Log Viewer
E3 Studio
E3 Tweak
E3 Viewer
O item Log Viewer abre o aplicativo Elipse Event Log Viewer j com o arquivo
Domnios
128
correspondente sesso ativa de logs do E3. Para maiores informaes sobre este
aplicativo, consulte o Manual do Usurio do Elipse Event Log, disponvel no menu
Iniciar - Programas - Elipse Software - Elipse Event Log.
Se j h um Domnio rodando localmente, o item E3 Viewer deste menu abre um
Viewer para o Domnio local. Do contrrio, ou se a tecla SHIFT estiver pressionada,
abre-se a janela inicial do Viewer, onde possvel escolher o servidor e outras
opes, como descrito no tpico E3 Viewer e E3 WebViewer - Execuo do E3
Viewer - Execuo Atrves do Menu Iniciar.
3.10.2 Licenas
possvel visualizar as diversas licenas disponveis atravs do E3 Admin. Para
isto, clique com o boto direito do mouse no cone do E3 Admin na rea de
Notificaes do Windows e selecione a opo Licenas. A janela da figura a seguir
mostrada.
Janela E3 Admin - Licenas
129
Domnios

Opes disponveis na janela E3 Admin - Licenas
OPO
Nmero da licena
E3 Server
E3 Studio
E3 Viewer
E3 Viewer Only
Domnio Remoto (Servidor)

Domnio Remoto (Cliente)
Pontos E/S
Tags do Storage
Drivers
Servidor OPC
Tempo mximo de execuo
DESCRIO
Informa o nmero da l i cena (di s pos i ti vo
de prote o): um nmero hexa deci ma l
de oi to dgi tos com prefi xo "HL", s e o
di s pos i ti vo for uma hardkey; ou um
nmero hexa deci ma l de dezes s ei s
dgi tos com prefi xo "SL", s e o di s pos i ti vo
for uma softkey. Se o di s pos i ti vo de
prote o n o foi detecta do, o nmero
preenchi do com zeros .
Indi ca o ti po de E3 Server.
Indi ca o nmero de l i cena s di s ponvei s
e em us o do E3 Studi o.
e em us o do E3 Vi ewer.
e em us o do E3 Vi ewer no modo Somente
Leitura.
e em us o do Domni o Remoto (Servi dor).
e em us o do Domni o Remoto (Cl i ente).
Indi ca o nmero de pontos de
comuni ca o.
Indi ca o nmero de Ta gs do Stora ge.
Indi ca o nmero de Dri vers di s ponvei s e
em us o.
e em us o do Servi dor OPC.
Indi ca o tempo m xi mo permi ti do de
execu o de um a pl i ca ti vo.
Para maiores informaes sobre as limitaes do modo Demo do E3, veja o tpico
Limitaes do Modo Demonstrao.
NOTA: Os us u ri os l oga dos e i denti fi ca dos como E3DataAccess e E3AccessLayer, na
col una Programa da l i s ta Usurios Logados, n o cons omem l i cena s de Vi ewer de um
E3 Server.
3.10.3 Estatsticas
A janela E3 Admin - Estatsticas de Comunicao mostra os dados em tempo real
sobre o trfego de informaes na rede. A lista atualizada automaticamente a
cada segundo. Para isto, clique com o boto direito do mouse no cone do E3 Admin
Domnios
130
na rea de Notificaes do Windows e selecione a opo Estatsticas.
Janela E3 Admin - Estatsticas de Comunicao

Opes disponveis na janela E3 Admin - Estatsticas de Comunicao
OPO
Programa
Computador
Dados enviados
Compresso no envio
Pacotes enviados
Dados recebidos
Compresso no recebimento
Pacotes recebidos
Conectado desde
DESCRIO
Mos tra o nome da a pl i ca o conecta da
a o E3 Server.
Mos tra o nome da m qui na conecta da
a o E3 Server.
Mos tra a qua nti da de de da dos envi a dos .
Mos tra a percenta gem de compres s o no
envi o.
Mos tra a qua nti da de de pa cotes
envi a dos .
Mos tra a qua nti da de de da dos
recebi dos .
Mos tra a percenta gem de compres s o no
recebi mento.
Mos tra a qua nti da de de pa cotes
recebi dos .
Mos tra a da ta e hora em que o progra ma
i ni ci ou a conex o.
3.10.4 Monitor
A janela E3 Admin - Monitor mostra informaes em tempo real sobre o estado dos
servidores do Domnio. Para isto, clique com o boto direito do mouse no cone do
E3 Admin na rea de Notificaes do Windows e selecione a opo Monitor.
131
Domnios
Janela E3 Admin - Monitor

Opes disponveis na janela E3 Admin - Monitor
OPO
Domnio atual
Endereos de ping
Nome
Endereo
Ping
Relgio
Estado
Conexo
Funo
Domnios
DESCRIO
Nome do Domni o a ti vo.
Li s ta com os endereos dos s ervi dores de
ping.
Nome do s ervi dor.
Endereo de rede do s ervi dor.
Mos tra o es ta do do ping de rede com es te
s ervi dor.
Mos tra a hora l oca l do s ervi dor.
Mos tra o es ta do do Domni o no s ervi dor
(Parado ou Rodando).
Mos tra o es ta do da conex o DCOM com o
s ervi dor.
Mos tra uma l i s ta de funes reporta da s
pel o s ervi dor:
Ativo: Es te o s ervi dor a ti vo do Domni o
Reserva: Es te o s ervi dor standby do
Domni o
Falha(n): Servi dor pos s ui fa l ha s l oca i s
reporta da s
Prioridade: O s ervi dor requi s i tou
pri ori da de pa ra roda r o Domni o. Es te
i ndi ca dor fa z com que o s ervi dor a ti vo
pa s s e pa ra o modo Standby
Candidato: O s ervi dor ca ndi da to a roda r
o Domni o
E/S: O s ervi dor pos s ui IOServers a ti vos
132
3.10.5 Inicializao
Esta opo permite controlar o Domnio a ser iniciado automaticamente. O Domnio
configurado s executado se o E3 Server no estiver em modo Demo. Para isto,
do Windows e selecione a opo Inicializao. A janela da figura a seguir
mostrada.
Janela E3 Admin - Inicializao

Opes disponveis na janela E3 Admin - Inicializao
OPO
O Domnio carregado
O Domnio configurado
Nenhum Domnio
DESCRIO
Ao i ni ci a r, executa a utoma ti ca mente o
Domni o previ a mente ca rrega do.
Ao i ni ci a r, executa a utoma ti ca mente o
Domni o confi gura do pel o us u ri o.
N o i ni ci a nenhum Domni o.
3.10.6 Impressora
Esta opo mostra a lista das impressoras encontradas local ou remotamente, e
permite que o usurio escolha uma para ser usada pelo E3 Server. Para isto, clique
com o boto direito do mouse no cone do E3 Admin na rea de Notificaes do
Windows e selecione a opo Impressora. A janela da figura a seguir mostrada.
133
Domnios
Janela E3 Admin - Impressora

Opes disponveis na janela E3 Admin - Impressora
OPO
Nome da impressora
Padro
Configurar
Procurar
DESCRIO
Li s ta o nome da s i mpres s ora s
di s ponvei s .
Permi te s el eci ona r es ta i mpres s ora
como pa dr o.
Abre a ja nel a de propri eda des da
i mpres s ora s el eci ona da .
Permi te es col her outra i mpres s ora na
rede e es ta bel ecer uma conex o.
3.10.7 Sobre o E3 Admin

Esta opo mostra a verso do E3 Admin.
3.10.8 Iniciar ou Parar o E3 Server

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

O E3 Admin pode ser fechado sem precisar fechar o E3 Server, atravs da opo
Fechar E3 Admin. Quando isto acontece, o E3 Server continua rodando, mas nenhum
cone aparece na rea de Notificaes do Windows. Neste caso, quando o E3 Admin
no est aberto, as mensagens de erro aparecem como caixas de mensagens a
Domnios
134
todos os usurios logados (e ativos) na mquina rodando o E3 Server.

A qualquer momento, o E3 Admin pode ser reiniciado para controlar o E3 Server em
execuo, bastando para isto iniciar o E3 Admin sem nenhum parmetro. O
instalador tambm cria um atalho para abrir o E3 Admin diretamente.
3.11 Domnios Remotos

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

A configurao das conexes com outros Domnios do E3 deve ser feita no Domnio
Cliente, clicando com o boto direito do mouse no cone do E3 Admin na rea de
Notificaes do Windows, selecionando a opo Domnios - Opes e ento
selecionando a aba Domnios Remotos.
135
Domnios
Aba Domnios Remotos
Neste caso, o Domnio referenciado pela configurao o Domnio Servidor.

possvel tambm que os Domnios se referenciem entre si, sendo ao mesmo tempo
servidores e clientes de Domnios Remotos. Para configurar o uso de um Domnio
Remoto, siga estes procedimentos:
1. Informe um apelido para o Domnio Remoto no campo Nome do Domnio. Este
campo no sensvel a maisculas ou minsculas. Este nome usado na
aplicao para referenciar os objetos a serem acessados no Domnio Remoto.
2. Especifique o caminho do arquivo .dom do Domnio Remoto. Este caminho deve
ser um compartilhamento na rede que permita acessar este arquivo .dom.
3. Informe o nome do servidor principal, que deve ser o servidor contendo o
Domnio Remoto especificado no caminho do arquivo .dom. Esta configurao
utilizada para encontrar os objetos do Domnio Remoto em tempo de execuo.
O item Servidores e opes de conexo contm a opo Avanado, que permite
realizar configuraes especficas da conexo entre os Domnios, atravs da janela
mostrada na figura a seguir.
Domnios
136
Janela Opes de Conexo
As opes desta janela esto descritas na tabela a seguir.

Opes disponveis na janela Opes de Conexo
OPO
Tempo limite de conexo (ms)
Tempo limite de chamada (ms)
137
DESCRIO
Es ta op o control a o tempo m xi mo que
o Domni o Remoto Cl i ente es pera pa ra
es ta bel ecer uma conex o REC com o E3
Server do Domni o Servi dor. Sua
fi na l i da de a mes ma da cha ve
ConnectionTimeout, confi gur vel pel o E3
Tweak. O va l or pa dr o des ta op o 2000
ms .
Es ta op o control a o tempo m xi mo que
o Domni o Remoto Cl i ente es pera pel o
retorno de uma cha ma da a o Domni o
Remoto Servi dor. Se es te tempo for
excedi do, a conex o des fei ta pel o
cl i ente, mes mo que os l i mi tes
es ta bel eci dos pel a s opes Verificar
PING e Utilizar heartbeat na conexo a i nda
n o tenha m s i do excedi dos . O va l or
pa dr o des ta op o 0 (zero), que
des a bi l i ta o tempo l i mi te.
Domnios
OPO
Verificar PING
Tempo limite de PING (ms)

Utilizar heartbeat na conexo
Perodo de heartbeat (ms)
Domnios
DESCRIO
Es ta op o permi te que, a tra vs de um
pedi do de echo do protocol o ICMP, o
Domni o Remoto veri fi que s e o Servi dor
res ponde dentro de um tempo l i mi te
(timeout). Se n o houver res pos ta , por
qua l quer moti vo, cons i dera -s e que o
computa dor es t fora da rede, ou
des l i ga do. Es ta veri fi ca o, s e
ha bi l i ta da , ocorre a ntes da conex o
(evi ta ndo a tenta ti va de conecta r em um
computa dor i ndi s ponvel ) e enqua nto a
conex o es ti ver a ti va (fora ndo a
des conex o i medi a ta ).
O va l or, em mi l i s s egundos , pa ra a
veri fi ca o do ping. O va l or pa dr o des ta
op o 2000 ms .
Es ta op o permi te que, a tra vs de um
meca ni s mo do protocol o REC, o Domni o
Remoto Cl i ente veri fi que s e o Servi dor
es t ma ntendo a conex o a ti va ,
es pera ndo que s eja m envi a da s
mens a gens de heartbeat peri di ca s ,
mes mo que n o ha ja nenhuma outra
comuni ca o a s er fei ta . Se for excedi do
o dobro do tempo de heartbeat
confi gura do, s em que o Cl i ente receba
uma mens a gem qua l quer do computa dor
Servi dor, cons i dera -s e que o Servi dor
fa l hou ou es t fora da rede, s endo
fora da uma des conex o i medi a ta .
O va l or, em mi l i s s egundos , do perodo
de heartbeat. O va l or pa dr o des ta op o
2000 ms .
138
OPO
Utilizar criao assncrona de links
DESCRIO
Se es ta op o es ti ver s el eci ona da , os
Links s o cri a dos em pa ra l el o entre os
di vers os Domni os e o res ul ta do da
opera o vem a s s i ncrona mente,
medi da que ca da Servi dor res ponder. A
va nta gem des ta op o n o tra nca r o
tra ta mento de Links gera l do E3 Server.
Apena s opera es da quel e mes mo
Domni o podem fi ca r tra nca da s , ca s o a
cri a o de Links demore mui to (o que
pode ocorrer em redes l enta s ). NOTA:
Es ta op o n o es t di s ponvel pa ra
vers es a nteri ores 3.2, e a s a pl i ca es
des envol vi da s em vers es a nteri ores
fa l ha m com o cdi go de erro 8004F108
(vers o i ncompa tvel do REC). O va l or
pa dr o des ta op o des ma rca da , que
corres ponde a o comporta mento da s
vers es a nteri ores vers o 3.2.
NOTA: Des ma rca r s i mul ta nea mente a s opes Verificar PING e Utilizar heartbeat na
conexo torna a detec o de queda da conex o extrema mente l enta , ca s o o Servi dor
fa l he. Recomenda -s e que a s dua s opes es teja m s empre ma rca da s .
No E3 Studio, o caminho completo do compartilhamento usado para que seja

possvel determinar os objetos existentes no Domnio Remoto. O nome do arquivo
.dom (sem o caminho) usado para verificar se a conexo remota est sendo feita
com o Domnio correto, em tempo de execuo. Assim, se o nome do Domnio
carregado no E3 Server remoto no for o correto, a conexo no completada e os
objetos remotos no ficam acessveis.
Outra possibilidade manter uma cpia do Domnio Remoto na mquina Cliente, e
colocar o caminho da cpia no campo Arquivo de Domnio. Desta forma, o E3
Studio vai utilizar a cpia local para determinar quais objetos existem, permitindo
o trabalho offline. A cpia deve obrigatoriamente ter o mesmo nome do Domnio
Remoto para que a conexo funcione, no sendo necessrio possuir a mesma
hierarquia de diretrios.
Alm disto, para que a conexo entre os Domnios possa ocorrer, todos os E3
Servers envolvidos devem rodar a mesma verso do E3. No possvel, por
exemplo, conectar-se a um Domnio que esteja rodando a verso 2.5 do E3.
Para que um E3 Server aceite receber conexes de outros Domnios (isto , para que
ele seja um servidor de Domnios Remotos), no necessria nenhuma
configurao especfica.
Aps a correta configurao destes itens, necessrio apenas rodar os E3 Servers
139
Domnios
para que as conexes remotas sejam estabelecidas.

NOTA: Pa ra ma i ores i nforma es s obre a confi gura o de Domni os Remotos , veja o
i tem Configuraes de Domnio - Domnios Remotos.
3.11.2 Licenas
Tanto o E3 Server rodando o Domnio Cliente, quanto o que roda o Domnio
Servidor, devem ter licenas especficas para Domnios Remotos.
Quando esta licena existe, o E3 Server Servidor passa a aceitar um nmero
ilimitado de conexes externas de outros Domnios. Da mesma forma, no caso do
E3 Server Cliente, possvel estabelecer um nmero ilimitado de conexes. Para
maiores informaes sobre as limitaes do modo Demo do E3, veja o tpico
Limitaes do Modo Demonstrao.
3.11.3 Sintaxe dos Links

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

Assim como ocorre com o Viewer, o acesso aos objetos de um Domnio Remoto pode
ser limitado ao modo Somente Leitura. Quando isto ocorre, so aplicados os
mesmo tipos de limitaes de acesso que se aplicam ao Viewer Only. Porm,
diferente do Viewer, neste caso o controle feito apenas por usurio e no por IP
ou por licena. Para isto, usa-se a configurao de usurios na permisso Acesso
remoto de escrita ao Domnio, dentro do item de segurana Domnio.
Permisses de usurio
Com isto, pode ser necessrio que a conexo com o Domnio Remoto especifique um
determinado usurio para poder ter acesso completo aos objetos do Domnio. Este
usurio deve ser especificado no campo Usurio no Domnio atravs da opo
141
Domnios
Utilizar a seguinte conta, na aba Domnios Remotos da configurao do Domnio

Cliente. Ali devem ser especificados o login e senha de um usurio existente no
Domnio sendo acessado remotamente.
Alm do acesso em modo Somente Leitura, possvel bloquear completamente o
acesso remoto, o que exige que a conexo com o Domnio Remoto especifique um
determinado usurio para poder ganhar acesso aos objetos remotos. Isto feito
atravs da permisso Acesso remoto ao Domnio, tambm do item de segurana
Domnio.
NOTA: A permi s s o Acesso remoto ao Domnio s empre tem precednci a s obre a
permi s s o Acesso remoto de escrita ao Domnio. Is to s i gni fi ca que qua ndo a pri mei ra
permi s s o for nega da , a s egunda n o efeti va da mes mo qua ndo expl i ci ta mente
permi ti da . N o ha vendo nenhuma permi s s o de a ces s o confi gura da , qua l quer
Domni o pode s e conecta r remota mente a outro, uti l i za ndo um us u ri o a nni mo.
3.11.5 Hot-Standby
A conexo remota ao Domnio suporta Domnios com Hot-Standby nativamente.
Para isto, basta apenas especificar os nomes dos dois servidores (principal e
backup) nos itens respectivos da rea Identificao dos servidores na rede, na aba
Domnios Remotos. importante ressaltar que, para o correto funcionamento do
Hot-Standby, estes nomes devem ser os mesmos especificados pelo Domnio Remoto
acessado. Uma vez que haja esta configurao em tempo de execuo, o E3 Server
sempre tenta conectar-se aos dois servidores, direcionando o acesso de todos os
comandos Application.GetObject e Links para o primeiro servidor que possa ser
acessado e que indique estar rodando o Domnio. Caso os nomes dos servidores
sejam modificados quando o Domnio Cliente estiver em execuo, este se
desconecta e reinicia a conexo com os novos servidores.
3.11.6 Gerenciamento da Conexo

Mesmo quando no h configurao de Hot-Standby, existe um controle da conexo
de Domnios Remotos entre os E3 Servers Clientes e Servidores. A conexo utiliza o
protocolo REC, o mesmo utilizado entre o E3 Server, E3 Viewer e E3 Studio. Assim, a
porta de conexo do REC e as possveis configuraes de firewall associadas
tambm se aplicam aos Domnios Remotos.
Com a conexo estabelecida, espera-se que haja um Domnio rodando. Neste
processo, a conexo refeita sempre que houver algum problema. Aps ser
encontrado o Domnio rodando, verifica-se o nome correto do Domnio, bem como
o login do usurio (se necessrio).
Assim como acontece com as conexes REC do E3 Studio e do E3 Viewer, as
estatsticas de comunicao das conexes de Domnios Remotos podem ser
visualizadas na janela de Estatsticas do E3 Server, acessveis atravs do cone do
E3 Admin na rea de Notificaes do Windows.
Domnios
142
3.11.7 Desconexo
O Domnio Cliente pode no conseguir estabelecer a conexo com o Domnio
Servidor por uma srie de motivos. Entre eles esto:
O computador do Cliente ou do Servidor est fora da rede
O Servidor no est rodando o E3 Server
O E3 Server do Servidor no est com o Domnio correto, ou o Domnio no
foi iniciado
O Domnio Servidor no aceita o usurio especificado pelo Domnio Cliente
O E3 Server do Cliente ou do Servidor no possui licena de Domnio Remoto
O E3 Server do Servidor de uma verso antiga (2.5 ou inferior)
Existe um firewall bloqueando a porta utilizada pelo REC, ou o Cliente e o
Servidor esto usando portas diferentes
O apelido do Domnio no existe na configurao de Domnio Remoto
Quando uma destas situaes ocorrer, todos os Links do Cliente referenciando o
Domnio ficam desconectados, assim como todos os mtodos Application.GetObject
referenciando o Domnio Remoto falham, ou seja, causam erros de script. Quando o
problema for resolvido, os Links devem conectar-se automaticamente. J os
comandos de Application.GetObject devem ser executados novamente.
3.12 Gerando Logs no E3

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

controladores, CLPs (Controladores Lgicos Programveis), UTRs (Unidades
Terminais Remotas), ou qualquer outro tipo de equipamento, atravs de Drivers de
Comunicao prprios ou Servidores OPC, de acordo com o tipo do equipamento ou
tipo de comunicao necessria.
NOTA: Os objetos de Dri vers (Dri ver de Comuni ca o, Pa s ta de Comuni ca o, Ta g de
Comuni ca o, Bl oco de Comuni ca o, El emento de Bl oco, Dri ver de Comuni ca o
OPC, Grupo de Ta gs OPC, Pa s ta OPC, Ta g de Comuni ca o OPC, Bl oco de Comuni ca o
OPC, El emento de Bl oco OPC e Dri ver de Comuni ca o OPC UA) podem s er
confi gura dos pa ra funci ona rem como reas de Alarme.
4.1 Driver de Comunicao

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

configurao. Logo em seguida, abre-se a janela de importao de Tags (se
145
Drivers
disponvel).
Ao inserir um Driver em uma aplicao do E3 Studio, aberta a view do objeto,
View do Driver de Comunicao
As opes disponveis nesta view esto descritas na tabela a seguir.

Opes disponveis na view do Driver de Comunicao
CONE
OPO
Adicionar
Remover
Configurar o driver
Tag Browser
Ativar/desativar
comunicao
Contagem de tags
DESCRIO
Adi ci ona uma nova Pa s ta ,
um novo Ta g ou um novo
Bl oco de Comuni ca o a o
Dri ver; um novo Ta g ou um
novo Bl oco de
Comuni ca o a uma Pa s ta ;
ou um novo El emento de
Comuni ca o a um Bl oco.
Remove o i tem
s el eci ona do na view.
Abre a ja nel a de
confi gura es extra s do
Dri ver.
Abre uma ja nel a que
permi te i mporta r Ta gs
di reta mente do Dri ver.
Ati va ou des a ti va a
comuni ca o do Dri ver.
Apres enta o nmero tota l
de Ta gs de Comuni ca o
no Dri ver.
4.1.1 Configurao
Para determinar o Driver de Comunicao a ser usado, clique na propriedade
DriverLocation, ou clique com o boto direito do mouse no Driver e selecione a
Drivers
146
opo Procurar DLL. Uma caixa de seleo para a determinao do arquivo .dll que
contm o Driver exibida, conforme a figura a seguir:
Selecionando um Driver
Para maiores informaes sobre a configurao individual de cada Driver,

consulte os respectivos arquivos de ajuda que acompanham os Drivers, onde
constam instrues sobre a configurao dos parmetros [P] e demais
propriedades, acessveis pela janela de configurao do Driver.
4.1.1.1 Teste de Comunicao

Ao configurar um Driver de Comunicao, o usurio pode realizar um procedimento
de teste a fim de verificar se os valores esto corretos e sendo atualizados sem
problemas. Ao clicar com o boto direito do mouse no Driver de Comunicao,
possvel utilizar a opo Ativar Comunicao.
Desta forma, o Driver de Comunicao especificado carregado e os valores das
variveis podem 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 aparece com a cor cinza.
Caso o Tag apresente erro de comunicao, a linha se torna vermelha, e caso a
comunicao esteja sem problemas, a linha tem a cor azul. Para interromper o
monitoramento, clique com o boto direito do mouse no Driver de Comunicao
novamente e selecione a opo Desativar Comunicao.
147
Drivers
4.1.2 Funcionamento
O IOServer o mdulo do E3 responsvel pela comunicao com o equipamento.
no processo do IOServer que carregada a DLL do Driver e efetuada a comunicao
com o equipamento.
Os Tags de Comunicao possibilitam a leitura ou escrita de um conjunto de
valores, utilizando o Driver de Comunicao onde eles esto inseridos. Podem ser
utilizados tambm os Blocos de Comunicao para a leitura simultnea de mais de
uma varivel. Para acessar cada valor do Bloco utilize o Elemento de Bloco, que
pode ser includo dentro do objeto. Estes objetos so 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 requisita
periodicamente o valor de cada um. Sempre que o valor ou a qualidade do Tag for
alterado, seu valor repassado para o Driver de Comunicao.
A verificao do tempo de ciclo de cada varivel feita de forma sequencial. Caso o
ciclo de uma varivel esteja vencido, o IOServer prossegue 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 executada com prioridade em relao varredura dos
Tags.
No caso de falha de um IOServer, o E3 automaticamente realiza uma reinicializao
daquele mdulo, de forma a normalizar seu funcionamento. Por outro lado, o
IOServer interrompe 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 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 utilizam o mesmo IOServer aberto pelo primeiro, o
que permite o compartilhamento das interfaces de comunicao utilizadas pelo
Driver.
Isto pode ser vantajoso, j que muitos dos dispositivos de comunicao, como
modems, portas seriais e outras interfaces, permitem apenas uma conexo, o que
impediria a utilizao simultnea por mais de um Driver. Com o compartilhamento
Drivers
148
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, tem-se acesso interface de execuo do
Driver de Comunicao, denominada Gerenciador de Drivers.
Acesso ao Gerenciador de Drivers
O Gerenciador de Drivers permite visualizar todos os Drivers em execuo,

exibindo suas propriedades.
Gerenciador de Drivers
149
Drivers

Opes disponveis na janela Gerenciador de Drivers
OPO
Nome
Objeto(s)
Erros de leitura
Erros de escrita
Processo
Estado
Compartilhado
Log
Caminho
Habilitar Log
Atualizar
DESCRIO
Informa o nome do Dri ver i ns eri do no
s i s tema .
Informa o nome do objeto Dri ver de
Comuni ca o a s s oci a do a o Dri ver.
Mos tra o tota l de l ei tura s do Dri ver, a
qua nti da de de erros de l ei tura e
percentua l de erros em rel a o a o tota l
de l ei tura s .
Mos tra o tota l de es cri ta s do Dri ver, a
qua nti da de de erros de es cri ta e
percentua l de erros em rel a o a o tota l
de es cri ta s .
Mos tra o i denti fi ca dor do proces s o do
IOServer no s i s tema opera ci ona l .
Mos tra o es ta do a tua l do Dri ver
(confi gura do, i ni ci a ndo, roda ndo,
fi na l i za ndo, fi na l i za do ou em erro). Se o
Dri ver es ti ver em erro, mos tra uma
des cri o do erro.
Mos tra a s pa l a vra s SIM ou NO,
i nforma ndo s e o Dri ver es t
compa rti l ha do ou n o.
Mos tra o s ta tus do l og (ha bi l i ta do ou
des a bi l i ta do).
Informa o ca mi nho do Dri ver no s i s tema .
Ha bi l i ta o l og dos Dri vers em tempo de
execu o, s em a neces s i da de de
reconfi gura r o a pl i ca ti vo. Atra vs da
mes ma op o pode-s e i nterromper es te
procedi mento de gra va o.
Fora a a tua l i za o dos da dos exi bi dos .
4.1.2.1 Utilizao de Estampa de Tempo

Alguns equipamentos e protocolos permitem o envio de informaes de tempo
juntamente com os valores das variveis. Os Drivers de Comunicao para tais
equipamentos podem, a cada varivel consultada, retornar tambm a informao
deste relgio que fica armazenada na propriedade TimeStamp de cada Tag, com
resoluo de 1ms.
Quando o equipamento no suporta este tipo de informao, ou quando o Driver
no est preparado para tal, o Driver de Comunicao insere na estampa de tempo
o valor de data e hora atual, a partir do relgio do computador. De posse da
estampa de tempo, o E3 utiliza esta informao tanto para a verificao e gravao
de alarmes quanto para a gerao de arquivos histricos.
Drivers
150
No caso dos Tags serem Elementos de Bloco, informada 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.
Para obter mais informaes sobre quais equipamentos possuem esta
caracterstica, entre em contato com o fabricante. Para saber quais Drivers ou tipos
de variveis dentro dos equipamentos utilizam a estampa de tempo, consulte a
ajuda dos Drivers ou diretamente o suporte tcnico da Elipse Software.
4.1.2.2 Tags Reportados por Eventos

Tags reportados por eventos podem retornar mais de um valor a cada leitura, ou
ento no retornar valor algum.
Os Tags reportados por eventos so destinados leitura de dados sob demanda,
geralmente armazenados no Driver at serem lidos em uma operao de leitura.
So normalmente utilizados para a leitura de eventos, dados de memria de massa
e mensagens no solicitadas recebidas do equipamento.
A documentao do Driver deve especificar quais dos seus Tags disponveis para a
aplicao so reportados a eventos.
A utilizao mais comum para a coleta de Sequncia de Eventos (SOE, ou Sequence
Of Events). Por exemplo, em equipamentos que armazenem em sua memria
sequncias muito rpidas de variaes de Tags digitais, ou que armazenem dados
de telemetria em tabelas na memria, os dados podem ser armazenados na
memria em tabelas, como demonstrado nas figuras a seguir.
Tabela com trs eventos e apenas um campo de dados
Tabela com trs eventos e seis campos de dados
Para o primeiro exemplo, necessrio um Tag de Comunicao para ler o valor A. O

campo Tempo seria retornado na propriedade TimeStamp do Tag. J para o
151
Drivers
segundo exemplo, necessrio um Tag Bloco de Comunicao com seis elementos

(de A at F), com o campo Tempo mais uma vez sendo retornado na propriedade
Timestamp do Bloco de Comunicao.
Em Tags comuns, no reportados por eventos, pode-se configurar um tempo de
varredura (scan), que determina o perodo em que o valor do Tag lido. A cada
operao de leitura, o Tag retorna um valor (Tag de Comunicao) ou bloco de
valores (Tag Bloco de Comunicao), ou ento pode retornar erro. Para ler as
tabelas descritas anteriormente, neste caso, so necessrias trs operaes de
leitura em cada tabela para poder ler os trs eventos (ou seja, as trs linhas da
tabela).
Os Tags reportados por eventos tambm permitem configurar um tempo de
varredura. Para estes Tags, entretanto, cada operao de leitura pode retornar uma
srie de valores ou blocos de valores, com qualidades e timestamps prprios. Ou
seja, no caso de utilizar Tags reportados por eventos para ler as tabelas anteriores,
seria possvel obter os trs eventos (os dados das trs linhas de cada tabela) de
uma vez s, em uma nica operao de leitura (um nico scan).
A leitura dos valores retornados por Tags reportados por eventos feita atravs do
evento OnRead do Tag. A cada operao de leitura que retorne valores, a aplicao
dispara uma sucesso de eventos OnRead. Para cada valor ou evento retornado, a
aplicao preenche as propriedades do Tag (valor, timestamp e qualidade) com os
valores do evento especfico, e ento dispara o evento OnRead.
Caso o Driver no possua eventos ou valores a retornar, a operao de leitura
reportada a eventos, ao contrrio do que ocorre com os Tags comuns, pode no
retornar dado algum e nem gerar erros, como se a operao de leitura no
houvesse ocorrido.
O tempo de varredura ou scan de Tags reportados por eventos geralmente pode ser
configurado com um valor bem baixo, pois o consumo de CPU, caso no existam
valores a retornar, geralmente desprezvel.
A propriedade TimeStamp destes Tags em geral contm um valor fornecido pelo
prprio equipamento.
NOTA: Os Ta gs reporta dos por eventos devem s er confi gura dos com a propri eda de
EnableDeadband des a bi l i ta da . Is to evi ta que eventos com va l ores mui to prxi mos
s eja m des preza dos pel a a pl i ca o.
4.1.2.2.1 Gravao de Eventos em um Histrico

O uso mais comum da leitura de Tags reportados por eventos a gravao dos
eventos retornados em um objeto Histrico. Para isto, siga estes procedimentos:
1. Crie um objeto Histrico, com varredura desabilitada (propriedade ScanTime
igual a zero) e sem banda morta (propriedade DeadBand igual a zero).
2. Associe as propriedades TimeStamp e os valores do Tag ao Histrico. Pode-se
Drivers
152
tambm associar outras propriedades, caso seja importante armazen-las.

3. Utilize o mtodo WriteRecord do objeto Histrico no evento OnRead do Tag.
Desta forma, garante-se que cada valor reportado a evento que chegar seja gravado
sequencialmente no Histrico associado.
4.1.2.3 Pool de Processos IOServer

Em aplicativos com centenas de Drivers, os recursos necessrios para rodar os
processos IOServer para cada Driver podem esgotar a capacidade do sistema
operacional. Nestes casos, pode ser necessrio habilitar o Pool de Processos
IOServer na aba Propriedades da configurao do Domnio.
Quando este Pool est habilitado, cada processo IOServer pode executar mais de
um Driver, economizando desta forma recursos do sistema operacional e
permitindo que um aplicativo chegue a rodar milhares de Drivers.
Apenas Drivers que suportam a criao de novas instncias dinmicas (Drivers
compilados com o IOKit v2.0.6 ou superior) podem ser utilizados no Pool. Se um
Driver que no tem este suporte for adicionado ao Pool, ele no executado (falha).
Para estes casos, basta configurar a propriedade DisableIOServerPool do IODriver
para Falso para que o Driver rode fora do Pool, em um processo IOServer exclusivo.
Na aba Propriedades da configurao do Domnio, pode-se controlar o nmero
mximo de processos IOServer no Pool, bem como o nmero mximo de Drivers que
rodam em cada IOServer.
Opes de comportamento do Pool de Processos IOServer
DRIVERS POR PROCESSO
0
153
NMERO MXIMO DE
PROCESSOS
M
COMPORTAMENTO DO POOL
medi da que os Dri vers do
a pl i ca ti vo forem a ti va dos ,
cri a do um proces s o
IOServer pa ra ca da Dri ver,
a t a ti ngi r o nmero
m xi mo M. Depoi s des te
ponto, ca da novo Dri ver
que for a ti va do
a di ci ona do a o IOServer do
Pool que contm a menor
qua nti da de de Dri vers .
Drivers
DRIVERS POR PROCESSO
Drivers
NMERO MXIMO DE
PROCESSOS
0
COMPORTAMENTO DO POOL
o E3 os a di ci ona a um
proces s o IOServer do Pool
que a i nda n o tenha
a ti ngi do o nmero m xi mo
N de Dri vers roda ndo
dentro del e. Se todos os
proces s os do Pool
es ti verem no l i mi te
m xi mo, ent o um novo
IOServer a di ci ona do a o
Pool.
o E3 os a di ci ona a um
proces s o IOServer do Pool
que a i nda n o tenha
a ti ngi do o nmero m xi mo
N de Dri vers roda ndo
dentro del e. Se todos os
proces s os do Pool
es ti verem no l i mi te
m xi mo, o comporta mento
depende da qua nti da de de
proces s os no Pool, e s e o
nmero de proces s os do
Pool for menor que o
m xi mo M, ent o um novo
proces s o a di ci ona do a o
Pool, ca s o contr ri o, o
Dri ver a di ci ona do no
proces s o que ti ver menos
Dri vers roda ndo. NOTA:
Nes te modo, o nmero
m xi mo de Dri vers por
proces s o (N) pode s er
ul tra pa s s a do ca s o o
nmero tota l de Dri vers do
a pl i ca ti vo exceda N * M.
154
NOTAS:
Ao a grupa r Dri vers em um mes mo proces s o IOServer, perde-s e o i s ol a mento entre
es tes Dri vers . Des ta forma , s e ocorrer uma fa l ha em um des tes Dri vers , o IOServer
fecha do e todos os Dri vers que roda va m na quel e IOServer tm que s er
rei ni ci a dos .
Exi s te um l i mi te no nmero de Dri vers que podem roda r em um proces s o
IOServer. Es te l i mi te depende de di vers a s va ri vei s , ta i s como o s i s tema
opera ci ona l em us o, a qua nti da de de memri a , threads e recurs os que ca da
Dri ver es pecfi co es t ocupa ndo. Em l i nha s gera i s , n o s e deve a di ci ona r ma i s do
que 100 Dri vers em um ni co IOServer, s ob pena de exceder os l i mi tes do s i s tema
opera ci ona l .
4.1.3 Pasta de Comunicao

A Pasta de Comunicao define grupos e subdiretrios de forma a organizar as
variveis. Cada Pasta pode ser renomeada conforme a necessidade e novas Pastas
podem ser inseridas dentro de outras. Para utilizar este recurso, siga este
procedimento:
1. No Organizer, clique com o boto direito do mouse no objeto Driver e selecione
a opo Inserir - Nova Pasta.
155
Drivers
Inserindo uma nova Pasta
4.1.4 Tag de Comunicao

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

mouse no Driver e selecionando a opo Inserir - Tag de Comunicao.
Inserindo um Tag de Comunicao
2. A janela da figura a seguir mostrada, perguntando quantos Tags devem

criados no Driver, e qual seu nome. Este nome auto-incrementado, e se a
opo for deixada em branco, os Tags so criados com o nome padro.
157
Drivers
Inserindo Tags de Comunicao
Caso o equipamento sendo utilizado para coletar os dados informe valores de Tags
que precisam ser convertidos, pode-se utilizar as escalas dos Tags, que so
basicamente uma especificao de uma converso linear entre duas bases
diferentes.
Para isto, deve-se habilitar a propriedade EnableScaling do Tag e informar os
parmetros DeviceLow e DeviceHigh (atravs das respectivas propriedades), que
seriam os limites inferior e superior do dado vindo do equipamento, alm de
informar os parmetros EULow e EUHigh (atravs das respectivas propriedades)
que so os limites inferior e superior do dado, j em unidades de engenharia.
Algumas das propriedades deste objeto podem ser configuradas diretamente na
Lista de Propriedades, sem a necessidade de criar scripts para isto. Demais
informaes sobre as funcionalidades das propriedades deste objeto podem ser
encontradas no Manual de Referncia de Scripts, em seu captulo respectivo.
4.1.5 Bloco de Comunicao

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

criados no Driver, e qual seu nome. Este nome auto-incrementado, e se a
opo for deixada em branco, os Blocos so criados com o nome padro.
159
Drivers
Inserindo Blocos de Comunicao
3. A caixa de dilogo da figura a seguir mostrada, 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.
Configurando o Bloco de Comunicao
4. Informe o tamanho do Bloco e a opo de mapeamento.

5. Clique em OK.
6. Caso necessite, configure as propriedades do objeto.
Algumas das propriedades do Bloco de Comunicao podem ser configuradas
atravs da Lista de Propriedades, sem a necessidade de criar scripts para isto.
Caso necessite configurar alguma propriedade, localize-a na Lista de Propriedades
e execute os devidos ajustes. Para maiores informaes, consulte o Manual de
Referncia de Scripts.
Drivers
160
4.1.6 Elemento de Bloco

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

Elementos que precisam ser convertidos, pode-se utilizar as escalas dos Elementos,
que so basicamente uma especificao de uma converso linear entre duas bases
diferentes.
161
Drivers
Para isto, deve-se habilitar a propriedade EnableScaling do Elemento e informar os

parmetros DeviceLow e DeviceHigh (atravs das respectivas propriedades), que so
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, localize-a na Lista de Propriedades e
execute os devidos ajustes. Para maiores informaes, consulte o Manual de
4.2 Servidor OPC

Alm de possuir um cliente OPC (Driver OPC), o E3 funciona tambm como Servidor
OPC DA (Data Access) 2.0x. Isto permite ao E3 expor todos os objetos existentes no
Domnio em execuo (Tags de Comunicao, por exemplo) para softwares externos
ao E3. Como exemplos, pode-se citar o Elipse SCADA, o E3 (que pode estar rodando
em outra aplicao como cliente), ou um cliente OPC de outro fabricante, basta que
o cliente implemente o padro OPC DA 2.0x ou superior.
NOTA: O Servi dor OPC no E3 um mdul o a di ci ona l a pa rti r da vers o 3.0, e
neces s i ta de l i cena es pecfi ca no di s pos i ti vo de prote o. Entre em conta to com a
Elipse pa ra ma i ores i nforma es .
4.2.1 Caractersticas
Para usar o Servidor OPC do E3 no necessria nenhuma configurao extra,
bastando executar o Domnio para que qualquer cliente OPC possa se comunicar
com o E3. Para conectar-se ao servidor OPC do E3 de um cliente qualquer, basta
selecionar o servidor identificado como Elipse.OPCSvr.1.
O Servidor OPC permite que qualquer cliente importe facilmente toda a definio de
Tags existentes no Domnio (funo Browse). Naturalmente, os Tags fornecidos so
apenas os objetos que fazem parte do servidor, ou seja, itens de Tela (Viewer) no
so acessveis pelo Servidor OPC.
Sendo baseado na mesma tecnologia de associaes usada nas associaes
internas entre objetos, o Servidor OPC do E3 permite que clientes usem Tags que
sejam expresses matemticas, e com o recurso de conexo e desconexo
transparente durante a execuo.
4.2.2 Informaes de Status

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

Domnio em standby: OPC_STATUS_SUSPENDED
Domnio parado ou sem Domnio: OPC_STATUS_NOCONFIG
4.2.3 Desconexo
Para os clientes OPC que suportam o mecanismo de desligamento (shutdown),
sempre enviado um aviso quando o Domnio parado ou entra em standby. Aps
o aviso, todos os clientes so desconectados.
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 este procedimento:
1. Clique com o boto direito do mouse no nome do projeto no Explorer e
selecione a opo Inserir - Driver de Comunicao OPC. No modo Domnio,
clique com o boto direito do mouse no item Objetos de Servidor - Drivers e
OPC, selecione a opo Inserir Driver de Comunicao OPC em e logo aps o
nome do projeto desejado.
163
Drivers
Inserindo um Driver OPC
Ao inserir um Driver OPC em uma aplicao no E3 Studio, aberta a view do objeto,

View do Driver de Comunicao OPC
Drivers
164
Opes disponveis na view do Driver OPC

CONE
OPO
Adicionar
Remover
Selecionar servidor
DESCRIO
Adi ci ona um Grupo a o
Dri ver; um Ta g, um Bl oco
ou uma Pa s ta a o Grupo; ou
um El emento a o Bl oco.
Remove o i tem
s el eci ona do na view.
Sel eci ona o Servi dor OPC.
Ati va e des a ti va a
comuni ca o do Dri ver.
Importa Ta gs pa ra o Dri ver
Importar tags
OPC.
Mos tra uma ja nel a com a s
Informaes sobre o servidor
confi gura es do Dri ver.
Apres enta o nmero tota l
Contagem de tags
de Ta gs de Comuni ca o
no Dri ver.
Ativar/desativar
comunicao
4.3.1 Configurao
A identificao dos outros objetos pertencentes ao Driver OPC pode ser inserida
manualmente, ou ento ser trazida automaticamente do Servidor OPC. Para isto,
abra a janela de propriedades do Driver, clicando com o boto direito do mouse no
objeto e selecionando a aba OPC Driver.
165
Drivers
Aba OPC Driver
Informe o Endereo e ID do Servidor e clique em Selecionar. A janela da figura a

seguir mostrada.
Drivers
166
Seleo do Servidor OPC
As opes disponveis no item Opes de busca dos servidores OPC esto descritas
na tabela a seguir.
Opes disponveis no item Opes de busca dos servidores OPC
OPO
Tentar enumerador padro ou registro
(recomendado)
Tentar apenas enumerador padro (servio
OPCENUM)
Tentar apenas pesquisa no registro
167
DESCRIO
O E3 tenta procura r a s es peci fi ca es do
Dri ver, ta nto pel o Regi s tro do Wi ndows
qua nto pel o enumera dor pa dr o OPC
(OPCENUM).
Dri ver a pena s pel o enumera dor pa dr o
OPC (OPCENUM).
Dri ver a pena s pel os regi s tros no
Wi ndows .
Drivers
Clicando em OK, o sistema mostra os dados do Driver, indicando os caminhos e o

nome do servidor. Para ativar a comunicao do Driver OPC, clique em Ativar
Comunicao.
Ativar comunicao do Driver OPC
Quando a comunicao ativada, so habilitadas as opes Informaes sobre o

servidor e Importar tags, alm da opo Desativar Comunicao. Para utilizar estas
opes, clique com o boto direito do mouse no Driver OPC e selecione a opo
desejada.
Drivers
168
Opes habilitadas quando o Driver OPC est ativo
A opo Informaes sobre o servidor mostra uma janela com as configuraes do

Driver.
169
Drivers
Informaes do Servidor OPC
Atravs da opo Importar tags, possvel importar Tags para o Driver OPC.
Quando esta opo selecionada, a caixa de dilogo da figura a seguir mostrada.
Mensagem referente importao de Tags OPC
As opes disponveis nesta caixa de dilogo so as seguintes:

Sim: O E3, ao executar a localizao dos Tags OPC, tenta 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
Drivers
170
No: O E3 no l os valores dos Tags OPC ao realizar a operao de procura.

Esta operao mais rpida, porm no cria automaticamente Tags OPC de
tipo Bloco e seus Elementos
Cancelar: Cancela a importao
A janela de importao dispe dos recursos mostrados na figura a seguir.
Importao de Tags OPC

Opes disponveis na janela Importao de Tags OPC
OPO
Nome dos Itens
Tipo de dados
171
DESCRIO
Fi l tra os Ta gs a pa rti r do nome dos i tens
es peci fi ca dos . Podem s er uti l i za dos
ca ra cteres curi nga s , ta i s como * ou ?.
Fi l tra os Ta gs a pa rti r do ti po de da do
es peci fi ca do no ca mpo, que pode s er
Integer, Long, Single, etc.
Drivers
OPO
Tipo de acesso
Mostrar apenas itens com IDs no

encontrados no projeto
Projeto corrente
Servidor OPC
DESCRIO
Fi l tra os Ta gs a pa rti r do ti po de a ces s o
es peci fi ca do no ca mpo, que pode s er
Leitura, Escrita ou Leitura e Escrita.
Fi l tra os Ta gs pa ra que a a pl i ca o
mos tre a pena s os i tens com IDs n o
encontra dos no projeto.
Mos tra os objetos que fora m
s el eci ona dos pa ra a di o no projeto
corrente.
Mos tra os Ta gs di s ponvei s no s ervi dor
pa ra i mporta o.
Para executar a importao, selecione o Tag desejado e arraste-o para o Driver ou

Grupo OPC desejado. Para desativar a comunicao do Driver OPC, clique em
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, localize-a na Lista de Propriedades e execute os
devidos ajustes. Para maiores informaes, consulte o Manual de Referncia de
Scripts.
4.3.1.1 Funcionamento
A comunicao do cliente OPC do E3 com um servidor OPC feita por um processo
separado. Este processo, quando o Driver OPC ativado pelo Studio, executa na
conta do usurio atual do Windows. Em tempo de execuo, por outro lado, este
processo executado na conta SYSTEM. Alguns servidores OPC podem ser sensveis
conta em que esto executando e, por este motivo, pode ser necessrio
reconfigurar o processo para que seja executado por um usurio especfico. Para
isto, siga estes procedimentos:
1. V ao menu Iniciar - Painel de Controle - Ferramentas Administrativas - Servios
de Componente (Start - Control Panel - Administrative Tools - Component
Services), ou digite dcomcnfg no prompt de comando do Windows.
2. Expanda o item Config DCOM (DCOM Config) em Servios de componente Computadores - Meu computador (Component Services - Computers - My
Computer), clique com o boto direito do mouse no item E3OpcClient e
selecione a opo Propriedades (Properties).
3. Selecione a aba Identidade (Identity), selecione o item Este usurio (This user) e
preencha as informaes da conta.
4. Clique em OK e reinicie o computador para que as modificaes sejam
aplicadas.
Drivers
172
4.3.2 Grupo de Tags OPC

O objeto Grupo de Tags 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 de Tags OPC para poder criar Tags OPC. Para inserir
um Grupo de Tags OPC, siga este procedimento:
1. Clique com o boto direto do mouse no Driver OPC e selecione a opo Inserir Grupo de tags OPC.
Inserindo um Grupo de Tags OPC
Algumas das propriedades do Grupo de Tags OPC podem ser configuradas atravs
da Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso
execute os devidos ajustes. Para maiores informaes, consulte o Manual de
173
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 podem ser inseridas dentro de outras. Em tempo de execuo, se a Pasta
OPC for desabilitada, todo o contedo desativado. Para utilizar este recurso, siga
este procedimento:
1. Clique com o boto direito do mouse no Grupo OPC e selecione a opo Inserir Nova Pasta.
Inserindo uma Pasta OPC
Drivers
174
4.3.4 Tag de Comunicao OPC

O Tag de Comunicao OPC um objeto para leitura ou escrita de valores em um
equipamento. A leitura do Tag feita automaticamente pelo Servidor OPC, com
tempo de varredura definido no Grupo OPC no qual ele est inserido. Para utilizar
1. Clique com o boto direito do mouse no Grupo OPC e selecione a opo Inserir Tag de Comunicao OPC.
Inserindo um Tag de Comunicao OPC
2. Abre-se uma janela perguntando quantos Tags devem ser criados no Grupo, e
qual seu nome. Este nome auto-incrementado e, se esta opo for deixada em
branco, os Tags so criados com o nome padro.
175
Drivers
Inserindo Tags de Comunicao OPC
Algumas das propriedades do Tag OPC podem ser configuradas atravs da Lista de
Propriedades, sem a necessidade de criar scripts para isto. Caso necessite
configurar alguma propriedade, localize-a na Lista de Propriedades e execute os
Scripts.
4.3.5 Bloco de Comunicao OPC

O objeto Bloco de Comunicao OPC possibilita a leitura ou escrita de um conjunto
de valores. Para executar uma escrita, deve-se apenas atribuir um novo valor
propriedade Value. A leitura do Tag feita automaticamente pelo Servidor OPC com
tempo de varredura definido no Grupo OPC. A propriedade Size determina o nmero
de Elementos do Tag no servidor. Para utilizar este recurso, siga estes
procedimentos:
1. Clique com o boto direito do mouse no Grupo OPC e selecione a opo Inserir Bloco de Comunicao OPC.
Drivers
176
Inserindo um Bloco de Comunicao OPC
2. Abre-se uma janela perguntando quantos Blocos devem ser criados no Grupo, e
qual seu nome. Este nome auto-incrementado e, se esta opo for deixada em
branco, os Blocos so criados com o nome padro.
177
Drivers
Inserindo Blocos de Comunicao OPC
3. mostrada uma caixa de dilogo para determinar o nmero de Elementos de

Bloco neste objeto. Nesta opo possvel indicar o mapeamento de todos os
Elementos de Bloco ou somente de um determinado intervalo de Elementos.
Configurando o Bloco de Comunicao
4. Informe o tamanho do Bloco e a opo de mapeamento.

5. Clique em OK.
Algumas das propriedades do Bloco de Comunicao OPC podem ser configuradas
Drivers
178
4.3.6 Elemento de Bloco OPC

O objeto Elemento de Bloco OPC possibilita a leitura ou escrita de um dos
Elementos do Bloco OPC onde ele est inserido.
O Bloco OPC l uma tabela de dados, e este objeto est sempre associado posio
definida por sua propriedade Index. Por exemplo, um Elemento de Bloco OPC com
Index igual a cinco e inserido em um Bloco OPC com tamanho 10, cujos dados
sejam lidos como na tabela a seguir.
Tabela
12
77
55
42
20
89
ndice
Teria sua propriedade Value igual a trs, segundo a tabela anterior.

NOTA: O E3 pode cri a r a utoma ti ca mente os El ementos de Bl oco OPC. Pa ra ma i ores
deta l hes , veja a op o Importar Tags, no tpi co Configurao.
Para utilizar este recurso, siga este procedimento:

1. Clique com o boto direito do mouse no Bloco OPC e selecione a opo Inserir Elemento de Bloco OPC.
179
Drivers
Inserindo um Elemento de Bloco OPC
Algumas das propriedades do Elemento de Bloco OPC podem ser configuradas

4.4 Driver de Comunicao OPC UA

O Driver de Comunicao OPC UA implementa a comunicao com um servidor OPC
UA que implemente leituras histricas, como por exemplo o EPM. Este objeto pode
ser usado como fonte de dados de um objeto Consulta. Para inserir um Driver de
Comunicao OPC UA no projeto, clique com o boto direito do mouse no nome do
projeto no modo Explorer e selecione a opo Inserir - Driver de Comunicao OPC
UA. No modo Domnio, clique com o boto direito do mouse no item Objetos de
Servidor - Drivers e OPC, selecione a opo Inserir Driver de Comunicao OPC UA
em e logo aps o nome do projeto desejado.
Drivers
180
Inserindo um Driver de Comunicao OPC UA em modo Domnio
Algumas das propriedades do Driver de Comunicao OPC UA podem ser

configuradas atravs da Lista de Propriedades, sem a necessidade de criar scripts
para isto. Caso necessite configurar alguma propriedade, localize-a na Lista de
Propriedades e execute os devidos ajustes. Para maiores informaes, consulte o
Manual de Referncia de Scripts.
4.4.1 Configurao
A configurao do objeto Driver de Comunicao OPC UA semelhante
configurao do Driver de Comunicao OPC. Para configur-lo, clique com o boto
direito do mouse no objeto e selecione o item Selecionar servidor.
181
Drivers
Opo Selecionar servidor
A janela a seguir mostrada, permitindo selecionar um servidor OPC UA na

mquina local ou na rede.
Drivers
182
Servidores OPC UA locais e na rede
Para cada servidor OPC UA, tanto locais quanto em rede, so enumerados os
pontos de conexo (endpoints), que podem utilizar diferentes protocolos e modos
de segurana. Alm disto, para cada ponto de conexo o servidor tambm pode
suportar diferentes formas de identificao e autenticao de usurios.
Atualmente, o E3 permite a conexo apenas pelo modo TCP Binrio. Para este modo,
o E3 suporta os modos de segurana definidos pelo padro OPC UA, em diversas
combinaes de polticas de segurana. Para a autenticao, o E3 suporta apenas
os modos Annimo e Usurio e Senha.
NOTA: A ja nel a Servi dores OPC UA l i s ta todos os protocol os e modos de s egura na ,
pa ra i nforma o do us u ri o. Entreta nto, s omente os modos compa tvei s com o E3
podem s er s el eci ona dos .
Ao selecionar um ponto de conexo compatvel com o E3, as propriedades

EndPointURL, SecurityMode e SecurityPolicy do objeto so automaticamente
183
Drivers
preenchidas.
Se as propriedades UserName e Password do objeto forem deixadas em branco, o
E3 utiliza uma conexo annima com o servidor. Caso contrrio, o E3 envia os
valores destas propriedades para o servidor, que deve suportar este tipo de
autenticao no ponto de conexo selecionado.
Neste objeto tambm possvel configurar diversos limites de tempo (timeouts) da
conexo OPC UA. Estes valores de limite de tempo (propriedades TimeoutCall,
TimeoutConnection e TimeoutSession) so sempre em milissegundos e devem ser
ajustados de acordo com a performance da comunicao, que pode ser limitada
pelo servidor, pela rede, pelas mquinas onde rodam o cliente e o servidor, e at
mesmo pelas operaes feitas pelo cliente. Este ajuste deve ser feito caso a caso e
os valores padro destas propriedades so apenas sugestes.
No E3 Studio, a comunicao com o Driver pode ser ativada ao selecionar a opo
Ativar Comunicao no menu contextual do objeto. A ativao executada
automaticamente pelos objetos Consulta ao selecionar servidores, Tags, ou
executar a visualizao dos resultados de uma consulta (aba Visualizar).
Note que para editar as propriedades do Driver pode ser necessrio desativar a
comunicao. Se a comunicao estiver ativa no E3 Studio, possvel abrir uma
janela de informaes sobre o servidor selecionado (ao selecionar a opo
Informaes sobre o servidor no menu contextual do objeto). Caso a conexo no
esteja estabelecida, por qualquer motivo, esta janela mostra pontos de
interrogao no lugar das informaes.
4.4.2 Objeto Consulta

Para configurar um objeto Consulta para buscar dados em um servidor OPC UA
utilizando o Driver OPC UA, siga estes procedimentos:
1. Selecione o Driver OPC UA na janela Defina o Servidor de Banco de Dados da
Consulta.
Selecionar Driver OPC UA
2. A janela a seguir mostrada, permitindo configurar a Consulta.

Drivers
184
Aba Campos
As opes disponveis na aba Campos esto descritas na tabela a seguir.

Opes disponveis na aba Campos
OPO
Dados Brutos
185
DESCRIO
A Cons ul ta retorna os da dos como s o
a rma zena dos no s ervi dor, s emel ha nte
cons ul ta CompressedDataStartEndTime do
objeto Stora ge. Nes te modo, a pena s um
Ta g pode s er cons ul ta do por vez,
retorna ndo ta mbm a qua l i da de do
va l or.
Drivers
OPO
Dados Processados
Id
Colunas
Ttulo
Funo
DESCRIO
A Cons ul ta retorna da dos a grega dos
dentro de um i nterva l o de tempo,
s emel ha nte s cons ul ta s SampledData e
CalculatedData do objeto Stora ge. Nes te
modo, v ri os Ta gs podem s er
cons ul ta dos por vez, ma s n o retorna m
a qua l i da de do va l or. Di vers a s funes
de a grega o podem s er uti l i za da s ,
como por exempl o mdi a s , m xi mos ,
i nterpol a es , etc. Funes di ferentes
podem s er us a da s pa ra ca da Ta g e um
mes mo Ta g pode a pa recer v ri a s vezes
na Cons ul ta , com funes de a grega o
di ferentes . O E3 a pena s l i s ta a s funes
pa dr o, s em bus ca r funes es pecfi ca s
do s ervi dor ou fi l tra r funes n o
s uporta da s pel o s ervi dor. A Cons ul ta
pode fa l ha r ca s o s eja s el eci ona da uma
fun o n o s uporta da pel o s ervi dor OPC
UA.
Adi ci ona um ou ma i s Ta gs do s ervi dor
OPC UA.
Remove o Ta g s el eci ona do da Cons ul ta .
Fora a a tua l i za o dos Identi fi ca dores
de Ns OPC UA (NodeIds ).
Ti po de Identi fi ca dor de N OPC UA
(NodeId) no s ervi dor.
Ca mi nho do Ta g no s ervi dor OPC UA.
Nome do Ta g no s ervi dor OPC UA.
Fun o uti l i za da no Ta g. Es ta col una s
es t di s ponvel qua ndo a op o Dados
Processados es t s el eci ona da .
Ao clicar em , a janela a seguir mostrada, permitindo selecionar os Tags

existentes no servidor.
Drivers
186
Seleo de Tags OPC UA
As abas Variveis e Visualizar tm o mesmo comportamento descrito no captulo

Consultas.
4.4.3 Certificados
Durante a instalao do E3, instalado um certificado relativo instncia do
cliente OPC UA do E3. Este certificado necessrio sempre que for utilizada uma
conexo com o servidor cujo modo de segurana (propriedade SecurityMode) no
seja igual a None (ou seja, uma conexo OPC UA segura).
Este certificado pode ser encontrado na pasta CertificateStore/certs da instalao
do E3, em um arquivo chamado Elipse E3 UA Client [xxx].der, onde xxx um cdigo
gerado aleatoriamente.
Se o certificado for apagado, um novo gerado automaticamente sempre o Driver
OPC UA tentar estabelecer uma conexo com um servidor.
187
Drivers
NOTAS:
Apa ga r o certi fi ca do pode s i gni fi ca r ter que a tua l i za r os s ervi dores OPC UA com o
novo certi fi ca do, ou ent o a conex o s egura com o cl i ente do E3 pode s er nega da .
Es te certi fi ca do corres ponde i ns t nci a do cl i ente, e n o a o cl i ente OPC UA do
E3, ou s eja , el e NO pode s er copi a do de uma m qui na pa ra outra . Ca da
i ns ta l a o tem um certi fi ca do ni co.
O cl i ente OPC UA do E3 a cei ta qua l quer certi fi ca do v l i do de s ervi dor, ou s eja ,
n o neces s ri a nenhuma confi gura o pa ra que o cl i ente do E3 a cei te uma
determi na da i ns t nci a de s ervi dor OPC UA.
4.4.4 Limitaes na Leitura de Tipos de Dados

O Driver de Comunicao OPC UA do E3 suporta tipos bsicos e vetores de uma
dimenso, bem como alguns tipos de estruturas definidas pelo padro OPC UA. So
suportados valores escalares e vetores dos seguintes tipos:
Tipos suportados plenamente: SByte, Byte, Int16, UInt16, Int32, UInt32, Int64,
UInt64, Float, Double, Boolean, String, DateTime e ByteString
Tipos suportados com limitaes: DataValue (ignora o timestamp e a
qualidade), LocalizedText (ignora a configurao regional), QualifiedName
(ignora o NamespaceIndex), StatusCode (convertido para SCode ou HRESULT),
Guid (convertido para texto)
Tipos suportados convertidos para vetores de uma dimenso de tamanho
fixo: Estes tipos de dados so retornados como vetores de Variants, em que
cada um dos campos um item do vetor. Se o campo for outro objeto, o
Variant contm outro vetor, e assim por diante. Os tipos suportados so
ServerDiagnosticsSummaryDataType, SubscriptionDiagnosticsDataType,
SessionSecurityDiagnosticsDataType, SessionDiagnosticsDataType,
ApplicationDescription, Argument, BuildInfo, ServiceCounterDataType,
ExpandedNodeId e NodeId
Nos campos da consulta, o texto dos caminhos dos Tags do servidor segue o
padro OPC UA de caminhos relativos. Os componentes deste caminho so os
seguintes:
/ (barra): Indica uma referncia hierrquica qualquer
. (ponto): Indica uma referncia de agregao qualquer
[ns:]browse-name: A String que segue uma barra ou ponto especifica o nome
de browse de um item. Este nome pode ser prefixado com seu ndice de
Namespace. Se for omitido, assumido o ndice 0 (zero)
& (e comercial, caractere de escape): Insere um caractere reservado no local.
Por exemplo, a expresso "&/Nome" substituda por "/Nome". Os
caracteres reservados so os seguintes:
/ (barra)
Drivers
188
. (ponto)
< (menor que)
> (maior que)
: (dois pontos)
# (sinal numrico)
! (ponto de exclamao)
& (e comercial)
A definio formal de um caminho OPC UA, em notao BNF, a seguinte:
<caminho-relativo> ::= <tipo-referencia> <nome-browse>
<tipo-referencia> ::= '/' | '.' | '<' ['#'] ['!']
<nome-browse> '>'
<nome-browse> ::= [<indice-namespace> ':'] <nome>
<indice-namespace> ::= <digito> [<digito>]
<digito> ::= '0' | '1' | '2' | '3' | '4' | '5'
| '6' | '7' | '8' | '9'
<nome> ::= (<caractere-nome> | '&' <caractere-reservado>)
[<nome>]
<caractere-reservado> ::= '/' | '.' | '<' | '>' | ':'
| '#' | '!' | '&'
<caractere-nome> ::= Todos os caracteres vlidos
para uma String, exceto caracteres reservados.
O E3 no suporta Identificadores de Ns OPC UA (NodeIds) que no sejam do

servidor onde executado o browse dos Tags (servidores Gateway). Estes Tags,
portanto, no so mostrados na janela de seleo de servidores. Alm disto, os
caminhos so sempre hierrquicos e apenas os tipos de referncia barra (/) e ponto
(.) so suportados (o tipo <browse-name> no suportado).
4.5 Qualidade
Os campos de qualidade representam o estado da qualidade do valor do item.
formado de uma palavra de 16 bits, sendo que os primeiros oito bits so definidos
na forma de trs campos de bits: Qualidade, Substatus e Limite.
Os outros oito bits (de maior ordem) esto disponveis para uso de cada fabricante.
Se estes 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 esta informao usa as
mesmas regras do cliente.
189
Drivers
Opes disponveis no campo Qualidade

QUALIDADE
CAMPO QUALIDADE
0 - 63
Rui m
64 - 127
Incerta
128 - 191
(Res erva do)
192 - 255
Boa
DESCRIO
O va l or n o ti l pel a s
ra zes i ndi ca da s no
ca mpo Substatus.
A qua l i da de do va l or
i ncerta pel a s ra zes
i ndi ca da s no ca mpo
Substatus.
N o us a do pel o pa dr o
OPC.
A qua l i da de do va l or
boa .
Um servidor que no suporta informao de qualidade retorna 192 (Bom) sempre.

Tambm aceitvel que um servidor retorne simplesmente 0 ou 192 (Ruim ou Bom)
e sempre retorne 0 (zero) para o Substatus e para o Limite.
4.5.1 Campo Substatus

O layout deste campo depende do valor do campo Qualidade.
Substatus para Qualidade RUIM
SUBSTATUS
DESCRIO
No especfico O va l or
rui m, ma s
nenhuma
ra z o
es peci fi ca
conheci da .
H a l gum
Erro de
Configurao probl ema de
confi gura o
es pecfi co no
s ervi dor. Por
exempl o, o
i tem em
ques t o
pode ter s i do
a pa ga do.
Drivers
LIMITE
SEM LIMITE
BAIXO
ALTO
CONSTANTE
190
SUBSTATUS
DESCRIO
No Conectado A entra da
deveri a es ta r
l ogi ca mente
conecta da a
a l go, ma s
n o es t .
Es ta
qua l i da de
pode refl eti r
que n o h
va l or
di s ponvel
nes te
momento,
poi s o va l or
pode n o ter
s i do
forneci do
pel a fonte de
da dos .
Uma fa l ha de
Falha de
di s pos i ti vo
Dispositivo
foi
detecta da .
Uma fa l ha de
Falha de
s ens or foi
Sensor
detecta da (o
ca mpo Limite
pode conter
i nforma o
a di ci ona l ).
ltimo valor Comuni ca o
em fa l ha .
conhecido
Entreta nto, o
ul ti mo va l or
conheci do
es t
di s ponvel .
Note que a
i da de do
va l or pode
s er
determi na da
pel a
propri eda de
TimeStamp.
191
LIMITE
SEM LIMITE
BAIXO
ALTO
CONSTANTE
10
11
12
13
14
15
16
17
18
19
20
21
22
23
Drivers
SUBSTATUS
DESCRIO
Comuni ca e
Falha de
Comunicao s es t o em
fa l ha . N o h
l ti mo va l or
conheci do
di s ponvel .
O Bl oco es t
Fora de
fora de scan
Servio
ou tra nca do.
N o
N/A
uti l i za do.
LIMITE
SEM LIMITE
BAIXO
ALTO
CONSTANTE
24
25
26
27
28
29
30
31
32 - 63
Substatus para Qualidade INCERTA

SUBSTATUS
DESCRIO
No especfico N o h ra z o
es pecfi ca .
Drivers
LIMITE
SEM LIMITE
BAIXO
ALTO
CONSTANTE
64
65
66
67
192
SUBSTATUS
DESCRIO
O di s pos i ti vo
que es ta va
provi denci a n
do o va l or
pa rou de
fa z-l o. O
va l or
retorna do
deve s er
cons i dera do
velho. Note
que i s to
di fere de um
va l or Rui m
com o
Substatus 5
(l ti mo va l or
conheci do).
Aquel e
es ta do
a s s oci a do
com uma
fa l ha
detect vel de
comuni ca o
em um va l or
bus ca do.
Es te erro
a s s oci a do
com a fa l ha
de a l guma
fonte externa
que i ri a
i ns eri r a l go
no va l or
dentro de um
perodo
a cei t vel .
Note que a
i da de do
va l or pode
s er
determi na da
na
propri eda de
TimeStamp.
No utilizado N o
uti l i za do.
ltimo valor
utilizvel
193
LIMITE
SEM LIMITE
BAIXO
ALTO
CONSTANTE
68
69
70
71
72 - 79
Drivers
SUBSTATUS
Sensor
impreciso
Unidade de
engenharia
excedida
Drivers
DESCRIO
O va l or es t
col a do em
um dos
l i mi tes do
s ens or
(nes te ca s o o
ca mpo Limite
deve es ta r
confi gura do
pa ra 1 ou 2)
ou o s ens or
es t de
a l gum modo
conheci do
fora de
ca l i bra o
vi a a l gum
di a gns ti co
i nterno
(nes te ca s o o
ca mpo Limite
deve s er
zero).
O va l or
retorna do
es t fora dos
l i mi tes
defi ni dos
pa ra es te
pa r metro.
Note que
nes te ca s o o
va l or do
ca mpo Limite
i ndi ca qua i s
l i mi tes fora m
excedi dos ,
ma s n o
neces s a ri a m
ente i mpl i ca
que o va l or
n o pos s a i r
ma i s a l m
da fa i xa
es peci fi ca da .
LIMITE
SEM LIMITE
BAIXO
ALTO
CONSTANTE
80
81
82
83
84
85
86
87
194
SUBSTATUS
DESCRIO
O va l or
deri va do de
ml ti pl a s
fontes e h
um nmero
menor do
que o
requeri do de
fontes boa s .
No utilizado N o
uti l i za do.
Subnormal
LIMITE
SEM LIMITE
BAIXO
ALTO
CONSTANTE
88
89
90
91
92 - 127
NOTA: Servi dores que n o s uporta m o Substatus devem retorna r 0 (zero).

Substatus para Qualidade BOA
SUBSTATUS
DESCRIO
No especfico O va l or
bom. N o h
condi es
es peci a i s .
No utilizado N o
uti l i za do.
Ti pi ca mente
Forado
i ndi ca que a
localmente
entra da foi
des conecta d
a e um va l or
ma nua l foi
fora do.
No especfico N o
uti l i za do.
LIMITE
SEM LIMITE
BAIXO
ALTO
CONSTANTE
192
193
194
195
218
219
196 - 215
216
217
220 - 255
NOTA: Servi dores que n o s uporta m o Substatus devem retorna r 0 (zero).
4.5.2 Campo Limite

O campo Limite vlido independente dos campos Qualidade e Substatus. Em
alguns casos, como uma falha de sensor, ele pode prover informaes de
diagnstico.
195
Drivers
Campo Limite
ESPECIFICAO
No Limitado
Limite Inferior
Limite Superior
Constante
DESCRIO
O va l or l i vre pa ra mover-s e a ci ma ou
a ba i xo.
O va l or es t l i mi ta do em a l gum va l or
i nferi or.
O va l or es t l i mi ta do em a l gum va l or
s uperi or.
O va l or uma cons ta nte e n o pode
mover-s e.
NOTA: Servi dores que n o s uporta m o ca mpo Limite devem retorna r 0 (zero).
Drivers
196
CAPTULO
Quadros
O objeto Quadro utilizado para organizar e estruturar a interface do projeto,

criando visualizaes compostas para o usurio dentro da janela principal do
Viewer ou do navegador. Muitas vezes, uma aplicao requer apenas uma Tela
principal, que a porta de entrada para a aplicao. A partir da, o usurio pode
navegar por outras Telas, que ocupam o lugar da primeira, formando uma nica
visualizao do processo. Porm, possvel suportar mais de uma visualizao em
um mesmo documento ou projeto. Isto se torna til no caso de uma aplicao que
utilize uma Tela que nunca muda, ou que muda pouco (como, por exemplo, um
menu), e outra parte que a navegao das Telas propriamente ditas. Para utilizar
este recurso, execute os procedimentos a seguir.
1. Clique com o boto direito do mouse no nome do projeto no modo Explorer e
selecione a opo Inserir - Quadro. No modo Domnio, clique com o boto
direito do mouse no item Visualizao - Viewer e Quadros, selecione a opo
Inserir Quadro em e logo aps o nome do projeto desejado.
Inserindo um Quadro no modo Domnio
O Quadro possui subdivises, chamadas de Divisores, que podem ser inseridas ou

removidas do Quadro atravs de um menu contextual na view de Design. A
197
Quadros
princpio, o Quadro possui um Divisor inicial, que pode ser subdividido horizontal
ou verticalmente em dois Divisores, que por sua vez tambm podem ser
subdivididos em outros dois Divisores, e assim sucessivamente.
A cada par de novos Divisores criados pelas opes Dividir Horizontalmente e
Dividir Verticalmente, h sempre um Divisor Principal e um Divisor Secundrio.
Apenas o Divisor Principal tem valores que definem explicitamente o seu
posicionamento, ficando o Divisor Secundrio com o valor restante.
Assim, quando o Divisor subdividido horizontalmente, sua propriedade
SplitDockPosition recebe o valor dockTop. Do mesmo modo, se a subdiviso for
vertical, esta propriedade recebe o valor dockLeft. A propriedade do Divisor
Secundrio recebe, ento, o valor dockRemaining, significando que este Divisor
ocupa o espao restante.
Os cones dos objetos no Organizer identificam exatamente o posicionamento de
cada Divisor.
Posicionamento do Divisor
CONE
DESCRIO
dockBottom: Es te Di vi s or es t
pos i ci ona do na pa rte i nferi or do Di vi s or
Pa i .
dockTop: Es te Di vi s or es t pos i ci ona do
na pa rte s uperi or do Di vi s or Pa i .
dockLeft: Es te Di vi s or es t pos i ci ona do
es querda do Di vi s or Pa i .
dockRight: Es te Di vi s or es t pos i ci ona do
di rei ta do Di vi s or Pa i .
dockRemaining: Es te Di vi s or ocupa o
es pa o res ta nte a ps o pos i ci ona mento
de s eu Di vi s or Irm o.
Cada Divisor corresponde visualizao de uma Tela ou Quadro de seu processo

ou a uma URL (Uniform Resource Locator). Para utilizar este recurso, execute os
procedimentos a seguir.
1. Clique com o boto direito do mouse no Quadro aberto e selecione uma das
opes: Dividir Horizontalmente ou Dividir Verticalmente, conforme o tipo de
Diviso desejada.
Quadros
198
Inserindo um Divisor Horizontal ou Vertical
2. Para remover um Divisor, clique com o boto direito do mouse no Quadro

aberto e selecione a opo
Deletar.
3. possvel inverter a seleo original dos Divisores (transformar o Divisor
Principal em Divisor Secundrio, e vice-versa) atravs deste mesmo menu. No
caso de um Divisor Principal, clique com o boto direito do mouse no Quadro e
selecione a opo Configurar como Divisor Secundrio. No caso de um Divisor
Secundrio, selecione a opo Configurar como Divisor Principal. A propriedade
SplitDockPosition dos Divisores automaticamente configurada para refletir
esta mudana.
4. Com a opo Selecionar Tela ou Quadro, possvel escolher a Tela ou Quadro
que associada propriedade SplitLink do Divisor selecionado, usando o
AppBrowser.
5. Pode-se inserir vrios Divisores no Quadro.
199
Quadros
Divisores do Quadro
6. Para configurar os Divisores do Quadro, clique com o boto direito do mouse

no Divisor desejado no Organizer e selecione a opo Propriedades.
Quadros
200
Configuraes do Quadro

Opes disponveis na aba Quadro
OPO
Tela ou Quadro
Posicionamento
Valor
DESCRIO
Determi na o ca mi nho da Tel a ou Qua dro
que o Di vi s or a bre. S ha bi l i ta do s e o
Di vi s or n o ti ver nenhum fi l ho. Es te
ca mpo equi va l e propri eda de SplitLink.
Determi na a pos i o do Di vi s or no
Qua dro. Es te ca mpo equi va l e
propri eda de SplitDockPosition.
Determi na o va l or que a tri budo a o
Qua dro. S tem efei to vi s ua l s e for
modi fi ca da no Di vi s or Pri nci pa l . Es te
ca mpo equi va l e propri eda de SplitValue.
Algumas das propriedades do Quadro ou Divisor podem ser configuradas atravs

da Lista de Propriedades, sem a necessidade da criao de scripts para isto. Caso
haja a necessidade de configurar alguma propriedade, localize-a na Lista de
Propriedades e faa os devidos ajustes. Para maiores informaes, consulte o
Manual de Referncia de Scripts.
201
Quadros
CAPTULO
Viewer
O objeto Viewer disponibiliza a visualizao da aplicao. Permite visualizar

Telas do projeto em modo de execuo e a operao do sistema. O Viewer pode ser
executado 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 pode existir um objeto
Viewer em um Domnio.
Viewer no modo Domnio
Para criar um Viewer no projeto, siga este procedimento:

1. Verifique se j existe um Viewer no Domnio, ou insira um novo clicando com o
boto direito do mouse no nome do projeto no modo Explorer e selecionando a
opo Inserir - Viewer. No modo Domnio, clique com o boto direito do mouse
no item Visualizao - Viewer e Quadros, selecione a opo Inserir Viewer em e
logo aps o nome do projeto desejado.
Viewer
202
NOTA: A qua l i da de gr fi ca da s Tel a s pode s er modi fi ca da , em tempo de execu o,

uti l i za ndo-s e o menu contextua l do Vi ewer e s el eci ona ndo uma da s opes do
menu Qualidade (todas as telas). Pa ra ma i ores i nforma es , veja a propri eda de
RenderQuality do Vi ewer no Manual de Scripts.
6.1 Configurao
Atravs das propriedades do Viewer, possvel especificar configuraes do
Viewer, Erros de comunicao, criar associaes ou scripts.
6.1.1 Visualizador
Atravs da aba Visualizador, so configuradas as opes do Viewer quanto a ttulo,
Tela e zoom, conforme explicado a seguir.
Aba Visualizador
Cada campo da aba Visualizador possui uma propriedade correspondente. As

opes disponveis nesta aba esto descritas na tabela a seguir.
203
Viewer
Opes disponveis na aba Visualizador

OPO
Ttulo
Tela ou Quadro Inicial
Zoom
Habilitar barra de rolagem na Tela Inicial

Exibir o menu do Zoom ao clicar com o
boto direito do mouse
Manter Telas carregadas na memria
Verificar inatividade aps ... minutos
Nmero de retentativas para confirmao

de usurio ou senha
DESCRIO
Determi na o ttul o do Vi ewer. Es te ca mpo
equi va l e propri eda de Caption do objeto
Vi ewer.
Determi na a Tel a ou Qua dro que o Vi ewer
i ni ci a . Cl i ca ndo em
, o Studi o a bre uma
ja nel a de confi gura o, pel a qua l a bre o
AppBrows er, onde es peci fi ca da a Tel a
i ni ci a l de vi s ua l i za o. Es te ca mpo
equi va l e propri eda de InitialScreen do
objeto Vi ewer.
Determi na o nvel de zoom pa ra
vi s ua l i za o no Vi ewer. Atra vs da s s ua s
opes , pos s vel confi gura r como o
Vi ewer i ni ci a l i za do. Es te ca mpo
equi va l e propri eda de InitialScreen do
objeto Vi ewer, e repres enta do pel a s
es peci fi ca es a ps o ca ra ctere "?". Por
exempl o, s e na Tel a i ni ci a l o zoom de
100%, na propri eda de InitialScreen a pa rece
a des cri o "Tel a Ini ci a l ?100", onde
"Tel a Ini ci a l " o nome da Tel a e "?100"
a s ua percenta gem de zoom.
Ha bi l i ta a ba rra de rol a gem na p gi na
i ni ci a l .
Ha bi l i ta a exi bi o do menu Zoom com o
bot o di rei to do mous e, em tempo de
execu o. Es te ca mpo equi va l e
propri eda de EnableZoomMenu do objeto
Vi ewer.
Ha bi l i ta o Vi ewer a ma nter a s Tel a s
ca rrega da s em memri a . Es te ca mpo
equi va l e propri eda de CacheEnable do
objeto Vi ewer.
Defi ne o tempo m xi mo de es pera , em
mi nutos , por um evento de mous e ou de
tecl a do pa ra o perodo de i na ti vi da de.
Es te ca mpo equi va l e propri eda de
EnableInactivity do objeto Vi ewer.
Es ta bel ece o nmero de vezes que a ca i xa
de di l ogo de login exi bi da a l m da
pri mei ra vez. Es te ca mpo equi va l e
propri eda de LoginRetries do objeto Vi ewer.
6.1.2 Configurao
Atravs da aba Configurao, pode-se editar as opes relativas janela, ao ttulo e
resoluo do Viewer.
Viewer
204
Aba Configurao
Cada campo da aba Configurao possui uma propriedade correspondente. As

205
Viewer
Opes disponveis na aba Configurao

OPO
Iniciar Maximizada / Minimizada /
Janelada
Desabilitar troca de janelas
Barra de ttulo
Boto de fechar
Boto de minimizar
Boto de maximizar
Borda
Opo de redimensionar
Opo de mover
Ficar sempre no topo
Barra de ttulo menor
Viewer
DESCRIO
Determi na o es ti l o da ja nel a do Vi ewer.
WindowStyle e pos s ui a s s egui ntes opes :
0 - Maximized: A Tel a i ni ci a ma xi mi za da
1 - Windowed: Es ti l o ja nel a da , i s to ,
pode s er confi gura da a a l tura e a l a rgura
da Tel a
2 - Minimized: A Tel a i ni ci a mi ni mi za da
Des a bi l i ta a troca de ja nel a s . Es te ca mpo
equi va l e propri eda de
DisableTaskSwitching do objeto Vi ewer. Es ta
op o pode s er modi fi ca da em tempo de
execu o us a ndo o mtodo
SetDisableTaskSwitching.
Ha bi l i ta a ba rra de ttul o. Es te ca mpo
equi va l e propri eda de TitleBar do objeto
Vi ewer.
Ha bi l i ta o bot o de fecha r. Es te ca mpo
equi va l e propri eda de CloseButton do
objeto Vi ewer.
Ha bi l i ta o bot o de mi ni mi za r. Es te ca mpo
equi va l e propri eda de MinimizeButton do
objeto Vi ewer.
Ha bi l i ta o bot o de ma xi mi za r. Es te ca mpo
equi va l e propri eda de MaximizeButton do
objeto Vi ewer.
Ha bi l i ta uma borda na ja nel a do Vi ewer.
WindowBorder do objeto Vi ewer.
Indi ca s e a ja nel a pode s er
redi mens i ona da . Es ta op o s tem
va l i da de s e a op o Borda es ti ver ma rca da .
WindowResizable do objeto Vi ewer.
Indi ca s e a ja nel a pode s er movi da . Es te
ca mpo equi va l e propri eda de
WindowMovable do objeto Vi ewer.
Indi ca s e a ja nel a deve s empre s e s obrepor
s outra s ja nel a s . Es te ca mpo equi va l e
propri eda de WindowStayOnTop do objeto
Vi ewer.
Ha bi l i ta uma ba rra de ttul os pequena na
ja nel a . Es ta op o s tem efei to s e a
op o Barra de ttulo es ti ver ma rca da . Es te
WindowSmallTitle do objeto Vi ewer.
206
OPO
Resoluo da Tela
Avanado
DESCRIO
Sel eci ona a res ol u o da Tel a : 640 x 480,
800 x 600, 1024 x 768, 1280 x 1024, ou 1600 x
1200 pi xel s .
Abre a ja nel a pa ra confi gura es
a va na da s .
Ao clicar em Avanado, a janela da figura a seguir aberta.
Configuraes avanadas

Opes disponveis na janela Configuraes avanadas
OPO
Resoluo da Tela em pixels
207
DESCRIO
Permi te es col her entre a res ol u o a tua l
do computa dor ou uma res ol u o
es col hi da pel o us u ri o, em pi xel s .
Viewer
OPO
Desconto na resoluo da Tela em pixels
Resoluo do monitor em pontos por

polegada (DPI)
DESCRIO
Permi te es col her o des conto a pl i ca do na
res ol u o da Tel a entre a confi gura o
a tua l do computa dor ou uma res ol u o
es col hi da pel o us u ri o, em pi xel s .
Permi te es col her entre a res ol u o a tua l
do computa dor ou um res ol u o
es col hi da pel o us u ri o, em pontos por
pol ega da (DPI).
6.1.3 Erros de Comunicao

No Viewer, possvel visualizar os erros de comunicao dos Tags quando estes
estiverem associados a Displays ou Setpoints. Isto possvel configurando as
informaes contidas na aba Erros de Comunicao, disponvel nas propriedades
do Viewer.
Aba Erros de comunicao

Opes disponveis na aba Erros de Comunicao
OPO
Visualizar erros de comunicao
Texto
Viewer
DESCRIO
Ha bi l i ta ou des a bi l i ta a vi s ua l i za o dos
erros de comuni ca o.
Contm o texto que mos tra do no
Setpoi nt, ca s o a qua l i da de do va l or s eja
rui m.
208
OPO
Cor da letra
Cor de fundo
DESCRIO
Contm a cor que deve s er us a da no
texto.
Contm a cor que deve s er us a da no
Setpoi nt. Equi va l e a uma a l tera o da
propri eda de ForegroundColor do Setpoi nt,
ma s es ta a l tera o n o executa da
efeti va mente. O va l or da propri eda de do
Setpoi nt n o a l tera do.
6.2 Variveis no Viewer

No objeto Viewer possvel criar Associaes com objetos a partir de Telas, bem
como us-los via scripts. Tambm possvel inserir Tags Demo ou Internos no
Viewer. Atravs do AppBrowser, pode-se executar as seguintes aes:
Acessar o objeto Viewer ou algum de seus filhos a partir de uma Tela ou
controle de Tela (Associaes ou scripts)
Os filhos do objeto Viewer podem acessar outros filhos do Viewer ou o
prprio Viewer (Associaes ou scripts)
O prprio objeto Viewer pode acessar seus filhos (Associaes ou scripts)
importante salientar que a Associao para o Viewer deve levar o nome real do
Viewer (por exemplo, "Viewer1") e no simplesmente "Application". Em scripts,
ainda vale o uso de Application, que uma propriedade de todos os objetos que
retornam o Viewer.
6.3 Objeto _top

Quando um Viewer inserido no projeto, disponibiliza um Quadro filho. Este
Quadro filho chamado de _top. Este objeto possui as mesmas funcionalidades do
objeto Divisor do Quadro. Para utilizar este recurso, siga estes procedimentos:
1. Clique em no item Visualizao - Viewer e Quadros - Viewer para mostrar o
Quadro _top.
209
Viewer
Objeto _top
2. Para configurar as propriedades do objeto _top, clique com o boto direito do

mouse e selecione a opo Propriedades.
3. Este objeto possui as mesmas funcionalidades do objeto Divisor do Quadro, e
tais informaes podem ser encontradas nos captulos Telas e Quadros.
6.4 Pasta do Viewer

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

NOTA: Uma a pl i ca o que contenha Pa s ta s do Vi ewer n o pode s er a berta em
vers es do E3 a nteri ores vers o 3.1.
211
Viewer
CAPTULO
Telas so janelas para monitoramento de processos. Em cada Tela so inseridos

objetos que compem a interface do operador com o sistema, chamados Objetos de
Tela. Cada aplicao pode ter um nmero ilimitado de Telas e de objetos de Tela.
7.1 Tela
A Tela o objeto bsico de interface com o usurio, e pode conter vrios tipos de
objetos. Os grficos inseridos na Tela podem ser apagados, copiados, movidos,
redimensionados, agrupados ou configurados.
Para inserir uma Tela no projeto, clique com o boto direito do mouse no nome do
projeto no modo Explorer e selecione a opo Inserir - Tela. No modo Domnio,
clique com o boto direito do mouse no item Visualizao - Telas, selecione a opo
Inserir Tela em e logo aps o nome do projeto desejado.
Inserindo uma Tela no modo Domnio
Quando uma nova Tela criada, ou quando selecionada a opo Ajustar ao

Divisor em uma Tela j existente, a seguinte janela mostrada para configurao
do tamanho do objeto.
212
Configurando o tamanho da Tela

Opes disponveis na janela Configurando o tamanho da Tela
OPO
Escolha o Divisor onde a Tela ser aberta
Configurar como Tela inicial do Divisor

Nome
Largura (pixels)
Altura (pixels)
DESCRIO
Permi te es col her o Di vi s or onde a Tel a
a berta . S o l i s ta dos a pena s os Di vi s ores
cuja Tel a a s s oci a da propri eda de
SplitLink vi s vel em tempo de execu o.
Ha bi l i ta a Tel a como Tel a Ini ci a l do
Di vi s or onde a berta .
Determi na o nome da Tel a .
Determi na a l a rgura da Tel a , em pi xel s .
Determi na a a l tura da Tel a , em pi xel s .
As opes Largura e Altura esto inicialmente preenchidas com o tamanho que a

Tela deve ter para poder ser exibida no Divisor escolhido, sem que aparea uma
barra de rolagem. Se algum dos valores for negativo, isto indica que o Divisor no
est visvel em tempo de execuo, em funo da configurao do Viewer e do
tamanho dos outros Divisores.
O E3 Studio fornece um editor dos objetos que podem ser inseridos em uma Tela.
Esto disponveis os seguintes objetos: Linha, Retngulo, Retngulo Arredondado,
Elipse, Arco de Elipse, Desenho Livre, Polgono, Polgono de Curvas, Figura (Imagem),
Texto, Display, SetPoint, Escala e MSForms. Os MSForms so discutidos no captulo
ActiveX e os demais objetos citados so apresentados neste captulo.
213
Tela
Pode-se configurar as propriedades da Tela para determinar tamanho, cor e outros

aspectos do comportamento e da aparncia, alm de vrios tipos de eventos. Estes
objetos utilizam como padro para o tamanho e coordenadas as unidades
HIMETRIC, dadas em 1/100 mm, e no em pixels.
Todas das propriedades da Tela podem ser configuradas atravs da Lista de
Propriedades, sem a necessidade de se criar scripts para isto. Caso necessite
configurar alguma propriedade, localize-a na Lista de Propriedades e faa os
devidos ajustes.
NOTA: A qua l i da de gr fi ca de uma Tel a pode s er modi fi ca da , em tempo de
execu o, uti l i za ndo-s e o menu contextua l do Vi ewer e s el eci ona ndo uma da s
opes do menu Qualidade (esta tela). Pa ra ma i ores i nforma es , veja a propri eda de
RenderQuality da Tel a no Manual de Scripts.
7.2 Objetos de Tela

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

Imagens vetoriais (Arquivos WMF, EMF, etc.)
Controles Padro do Windows (Lista, Editor de Texto, Lista de Seleo, etc.)
ElipseX, compostos de qualquer dos objetos anteriores
As primitivas do editor grfico disponveis no Studio so listadas nos prximos
tpicos. Elas podem ser rotacionadas ou redimensionadas livremente, exceto pelo
objeto Figura. Aps ter sido criado, cada objeto permanece selecionado para
facilitar a edio de suas propriedades, caso seja necessrio.
7.2.1 Linha
Permite o desenho de retas, ligando dois pontos especificados na sua criao. Para
utilizar este objeto, siga estes procedimentos:
1. Selecione a Linha
na barra de ferramentas Tela.
2. Clique na Tela para criar o ponto de origem da reta e arraste o mouse at seu
ponto final.
7.2.2 Conector
Este objeto utilizado para conectar dois ou mais objetos de Tela atravs de uma
linha. Os objetos de Tela que podem ser conectados so o Retngulo, o Retngulo
Arredondado, a Elipse, o Arco de Elipse, o Desenho Livre, o Polgono e o Polgono de
Curvas. Ao clicar em
na barra de ferramentas Tela, os objetos anteriormente
citados mostram seus pontos de conexo, como na figura a seguir.
Pontos de conexo de objetos de Tela
Para conectar dois objetos, clique em um dos pontos de conexo do primeiro

objeto e, em seguida, clique em um dos pontos de conexo do segundo objeto.
Sempre que se passa o mouse sobre um ponto de conexo, seu cone muda de
para , indicando qual ponto deve ser conectado.
Aps a criao do Conector, tambm possvel desconectar seus vrtices. Para isto,
arraste o vrtice para longe do ponto de conexo do objeto. Para reconectar,
215
arraste-o para perto de um ponto de conexo at que seu cone mude para
Para criar uma conexo entre mais de dois pontos de conexo, mantenha
pressionada a tecla CTRL enquanto seleciona todos os pontos desejados.
Para excluir um Conector, selecione-o e utilize a tecla DELETE. Se um objeto que
possua um Conector for excludo, o Conector no excludo.
Para informaes sobre Conectores em objetos XControl, veja o tpico a seguir.
7.2.2.1 Conectores em XControls

Os Conectores em objetos de Tela criados dentro de XControls devem ter seus
pontos de conexo definidos previamente, clicando-se em
na barra de
ferramentas Tela. Ao selecionar esta ferramenta e clicar em um ponto de conexo, a
janela da figura a seguir mostrada.
Janela de edio de pontos de conexo

Opes disponveis na janela Novo Ponto de Conexo
OPO
Nome do Ponto de Conexo
Conectado a
Utilizar como "Ponto ncora" do objeto
DESCRIO
Permi te defi ni r um nome pa ra o Ponto de
Conex o.
Mos tra em qua l Ponto de Conex o do
objeto de Tel a o Ponto de Conex o do
XControl es t conecta do.
Ma rca es te Ponto de Conex o como o
ponto ncora do objeto. Es te ponto
ncora pode s er a l tera do qua ndo o
XControl for i ns eri do em uma Tel a . Veja
ta mbm o tpi co Ponto ncora pa ra
ma i ores i nforma es .
216
Para editar ou excluir um ponto criado, clique com o boto direito do mouse no
ponto e selecione a opo Excluir Ponto de Conexo ou Editar Ponto de Conexo,
conforme a figura a seguir. Um ponto de conexo tambm pode ser excludo
clicando-se nele com a tecla CTRL pressionada.
Excluir ou editar um ponto de conexo
Caso no seja definido nenhum Ponto de Conexo para os objetos de Tela includos
no XControl, no possvel conectar este XControl a nenhum outro objeto de Tela,
quando ele for includo em uma Tela.
7.2.3 Retngulo
Permite o desenho de retngulos, criados a partir de dois vrtices. Para utilizar este
objeto, siga estes procedimentos:
1. Selecione o Retngulo
2. Clique na Tela para criar o vrtice de origem do Retngulo e arraste o mouse

diagonalmente at seu vrtice final, at o desenho atingir o tamanho e a
posio desejados.
7.2.4 Retngulo Arredondado

Permite o desenho de retngulos com cantos arredondados, criados a partir de
dois vrtices. Para utilizar este objeto, siga estes procedimentos:
1. Selecione o Retngulo Arredondado
2. Clique na Tela para criar o vrtice de origem do retngulo e arraste o mouse

diagonalmente at seu vrtice final, at o desenho atingir o tamanho e a
posio desejados.
3. No canto superior esquerdo do objeto, aparece o ponto responsvel pelo fator
de arredondamento do retngulo. Arraste-o mais para o centro ou mais para as
bordas para determinar a curva de seus vrtices.
217
7.2.5 Elipse
Permite o desenho de crculos e elipses. Para utilizar este objeto, siga estes
procedimentos:
1. Selecione a Elipse
2. Clique na Tela para estabelecer o ponto inicial do desenho e arraste o mouse

diagonalmente at o desenho atingir o tamanho e a posio desejados.
7.2.6 Arco de Elipse

Permite o desenho de objetos do tipo arco, corda ou torta. Para utilizar este objeto,
1. Selecione o Arco de Elipse

diagonalmente at o desenho atingir o tamanho e a posio desejados.
3. Nas duas extremidades do corte, aparecem dois pontos responsveis pela
posio de abertura do desenho. Arraste-os de forma que o desenho fique mais
aberto ou mais fechado.
4. O formato do desenho inicial o de torta. Para alter-lo para arco ou corda,
utilize a propriedade ArcStyle na Lista de Propriedades.
7.2.7 Desenho Livre

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

em qualquer direo tantas vezes quantas forem necessrias para completar o
desenho desejado.
7.2.8 Polgono
Permite o desenho de polgonos com lados retos. Para utilizar este objeto, siga
1. Selecione o Polgono
2. Clique na Tela para estabelecer o vrtice inicial do desenho e arraste o mouse

desenho desejado.
3. Quando desejar trocar a direo do desenho, clique uma vez com o mouse.
Quando desejar finaliz-lo, clique duas vezes com o mouse.
218
7.2.9 Polgono de Curvas

Permite o desenho de polgonos com lados curvos. Para utilizar este objeto, siga
1. Selecione o Polgono de Curvas
2. Clique na Tela para estabelecer o vrtice inicial do desenho e arraste o mouse

desenho desejado.
3. Quando desejar trocar a direo do desenho, clique uma vez com o mouse.
Quando desejar finaliz-lo, clique duas vezes com o mouse.
7.2.10 Figura
Permite mostrar imagens que estejam armazenadas em arquivos, que podem ou
no pertencer aplicao. A Figura pode ser redimensionada livremente, porm a
rotao s efetiva quando esta for um metafile convertido para smbolo. Os
seguintes formatos de arquivo so suportados: .bmp, .gif, .jpg, .ico, .wmf e .emf.
Para utilizar este objeto, siga estes procedimentos:
1. Selecione a Figura
2. Clique na Tela para criar o vrtice de origem do retngulo e arraste o mouse

diagonalmente at seu vrtice final.
3. O Studio abre uma caixa de dilogo para seleo do arquivo de imagem,
conforme figura a seguir.
219
Seleo do arquivo de imagem
4. Selecione o arquivo desejado e clique em Abrir para inserir a figura na Tela.
7.2.11 Texto
Permite a criao de um texto a ser exibido na Tela. Para utilizar este objeto, siga
1. Selecione o Texto
2. Digite o texto desejado e pressione a tecla ENTER.

3. Caso queira alterar ou digitar contedos neste objeto, utilize a propriedade
Value.
7.2.12 Display
Permite criar um objeto que utilizado para mostrar os valores dos Tags em tempo
de execuo. Para utilizar este objeto, siga estes procedimentos:
1. Selecione o Display
2. Clique na Tela para criar o vrtice de origem do objeto e arraste o mouse

3. Clique com o boto direito do mouse no objeto para abrir a Janela de
Propriedades. Na aba Item, selecione o Tag a ser associado propriedade
Value do Display.
220
7.2.13 SetPoint
Permite criar um objeto que funciona como uma caixa de edio onde so
inseridos contedos a serem atribudos a Tags associados. Para utilizar este
1. Selecione o SetPoint

3. Clique com o boto direito do mouse no objeto para abrir a Janela de
Propriedades. Na aba Item, selecione o Tag a ser associado propriedade
Value do SetPoint.
7.2.14 Escala
Permite a criao de um objeto que desenha rguas ou escalas de valores. Para
utilizar este objeto, siga estes procedimentos:
1. Selecione a Escala

7.3 Configuraes Gerais

As configuraes dos tpicos a seguir podem ser aplicadas Tela ou aos seus
objetos.
7.3.1 Alinhamento
Permite alinhar os objetos de Tela entre si ou em relao Tela. As opes de
alinhamento disponveis esto descritas na tabela a seguir.
Opes de alinhamento para objetos de Tela
CONE
OPO
Alinhar Esquerda
Alinhar Direita
221
DESCRIO
Al i nha doi s ou ma i s
objetos entre s i , tendo
como refernci a a
coordena da es querda do
l ti mo objeto
s el eci ona do.
como refernci a a
coordena da di rei ta do
l ti mo objeto
s el eci ona do.
CONE
OPO
Alinhamento Superior
DESCRIO
como refernci a a
coordena da s uperi or do
l ti mo objeto
s el eci ona do.
Alinhamento Inferior
como refernci a a
coordena da i nferi or do
l ti mo objeto
s el eci ona do.
Alinhamento Central
objetos hori zonta l mente
Horizontal
entre s i , tendo como
refernci a o l ti mo objeto
s el eci ona do.
Alinhamento Central Vertical Al i nha doi s ou ma i s
objetos verti ca l mente
entre s i , tendo como
refernci a o l ti mo objeto
s el eci ona do.
Apl i ca a l a rgura do l ti mo
Mesma Largura
objeto s el eci ona do a os
dema i s objetos
s el eci ona dos .
Apl i ca a a l tura do l ti mo
Mesma Altura
objeto s el eci ona do a os
dema i s objetos
s el eci ona dos .
Apl i ca a l a rgura e a a l tura
Mesmo Tamanho
do l ti mo objeto
s el eci ona do a os dema i s
objetos s el eci ona dos .
Centralizar Horizontalmente Centra l i za o objeto na
Tel a , de a cordo com s ua s
coordena da s hori zonta i s .
Centra l i za o objeto na
Centralizar Verticalmente
Tel a , de a cordo com s ua s
coordena da s verti ca i s .
Distribuir Horizontalmente Apl i ca a mes ma di s t nci a
hori zonta l entre s i a trs
ou ma i s objetos .
Apl i ca a mes ma di s t nci a
Distribuir Verticalmente
verti ca l entre s i a trs ou
ma i s objetos .
Apl i ca o efei to de refl ex o
Espelhar Horizontalmente
hori zonta l a os objetos
s el eci ona dos .
222
CONE
OPO
Espelhar Verticalmente
DESCRIO
Apl i ca o efei to de refl ex o
verti ca l a os objetos
s el eci ona dos .
NOTAS:
As opes Espelhar Horizontalmente e Espelhar Verticalmente tm o s egui nte
comporta mento:
Pa ra s el ees ml ti pl a s , ca da um dos objetos es pel ha do i ndi vi dua l mente
O es ta do dos botes s e a l tera (pres s i ona do ou n o) conforme os objetos
tenha m s i do refl eti dos verti ca l mente ou hori zonta l mente, ma s s omente s e
o es ta do de refl ex o i gua l pa ra todos os objetos s el eci ona dos
Os botes fi ca m des a bi l i ta dos s e a Tel a es ti ver s el eci ona da ou s e n o h
nenhum objeto s el eci ona do
Os objetos de Tel a podem s er a jus ta dos a o pi xel ma i s prxi mo (efei to Snap to
Pixel), uti l i za ndo-s e a combi na o de tecl a s CTRL + BARRA DE ESPAO.
7.3.2 Grade
Conjunto de linhas horizontais e verticais que servem como referncia de
posicionamento para objetos na Tela. Ela visualizada somente no E3 Studio, e no
em tempo de execuo.
No E3 Studio, possvel mostrar ou esconder a grade atravs do menu Arranjar Grade, ou clicando em na barra de ferramentas Alinhamento.
As propriedades da Grade podem ser configuradas atravs do menu Arranjar Edio da Grade. Ao selecionar esta opo, a janela da figura a seguir mostrada.
223
Janela Propriedades da Grade

Opes disponveis na janela Propriedades da Grade
OPO
Pontilhada
Linhas pontilhadas
Alinhar mouse automaticamente
Comprimento
Largura
Cor
DESCRIO
A gra de mos tra pontos a pena s na s
i nters eces de l i nha s .
A gra de mos tra a l i nha i ntei ra
ponti l ha da .
Al i nha o mous e gra de
a utoma ti ca mente.
Determi na a di s t nci a entre a s l i nha s
hori zonta i s .
Determi na a di s t nci a entre a s l i nha s
verti ca i s .
Determi na a cor da gra de.
7.3.3 Rotacionar
Permite rotacionar um objeto de Tela tendo como origem seu centro ou qualquer
outro ponto na Tela. Para utilizar este recurso, siga estes procedimentos:
1. Selecione um objeto na Tela e clique em Rotacionar
ferramentas Tela.
, na barra de
2. Clique em um de seus vrtices de rotao (em verde) e arraste o objeto at a

posio desejada.
224
3. Caso seja necessrio, altere o centro de rotao do objeto (marcado por um

crculo verde).
7.3.4 Ordem de Navegao entre os Objetos

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

navegao aparece no canto superior esquerdo do objeto.
3. Quando o Domnio for executado, a navegao entre estes objetos feita
conforme a ordem especificada.
Ordem dos Tabs
Para manter a ordem inicial dos objetos, necessrio seguir estes procedimentos:
1. Aps ter criado o objeto na Tela, clique em Ordem dos Tabs
2. Com a tecla CTRL pressionada, clique no penltimo objeto.

3. Solte a tecla CTRL e clique no ltimo objeto (objeto criado anteriormente).
NOTA: A ordem de ta bul a o equi va l ente ordem de s obrepos i o dos objetos ,
des cri ta no tpi co Sobreposio de Objetos.
225
7.3.5 Agrupar ou Desagrupar

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

mouse no objeto e selecione a opo Editar Grupo.
NOTA: pos s vel a jus ta r os objetos dentro de um grupo a o pi xel ma i s prxi mo
(efei to Snap to Pixel), uti l i za ndo-s e a combi na o de tecl a s CTRL + BARRA DE ESPAO.
Nes te ca s o, o efei to a pl i ca do a ca da um dos objetos dentro do grupo, podendo
s er des fei to uti l i za ndo-s e a combi na o de tecl a s CTRL + Z.
7.3.6 Animao
Recurso que aplica movimento a um objeto em tempo de execuo, e que est
disponvel na barra de ferramentas Tela. Os tipos de movimentos disponveis so
os seguintes:
Animao com Translao: O objeto que recebe este recurso faz movimentos
lineares de acordo com as configuraes das propriedades no objeto. Para
1. Selecione o objeto na Tela e clique em
Animar com Translao.
2. Com o cursor do mouse, habilite as configuraes da orientao do objeto.
Animao com Translao
Animao com Rotao: O objeto que recebe este recurso faz movimentos
226
circulares de acordo com o centro de rotao do objeto e seu ngulo. Para

1. Selecione o objeto na Tela e clique em
Animar com Rotao.
2. Quando o objeto criado, seu centro de rotao padro definido como o

centro do objeto, com uma inclinao de 0 (zero) graus de posio da
horizontal em relao a este centro. Neste momento, os vrtices do objeto
selecionado so indicados por pequenos crculos e seu centro por dois crculos
circunscritos.
3. Ao passar o mouse sobre o centro ou vrtices, possvel modificar o centro
arrastando ou rotacionando o objeto de um de seus vrtices em relao ao
centro.
Animao com Rotao
7.3.7 Sobreposio de Objetos

Permite editar o modo como dois ou mais objetos esto sobrepostos. As opes
disponveis na barra de ferramentos Tela esto descritas na tabela a seguir.
Opes disponveis na barra de ferramentas Tela
CONE
OPO
Trazer para a Frente
Enviar para Trs
227
DESCRIO
O objeto s el eci ona do
envi a do pa ra a pri mei ra
pos i o na ordem de
s obrepos i o (ALT +
HOME).
envi a do pa ra a l ti ma
pos i o na ordem de
s obrepos i o (ALT + END).
CONE
OPO
Avanar
Recuar
DESCRIO
a va na uma pos i o na
ordem de s obrepos i o
dos objetos (ALT + PAGE
UP).
recua uma pos i o na
ordem de s obrepos i o
dos objetos (ALT + PAGE
DOWN).
7.3.8 Zoom
Na edio da Tela, pode-se escolher livremente o nvel de zoom desejado e mais
confortvel para a edio. O zoom est disponvel atravs do menu contextual
Zoom, e possui nveis que vo de 10% a 800%, alm das opes Toda Largura, Toda
Altura, Toda Pgina e Preencher, conforme a figura a seguir.
Menu Zoom
228
Alm do menu Zoom, possvel modificar o nvel de zoom atravs do teclado e

mouse, utilizando as seguintes combinaes:
CTRL + SINAL DE MAIS (+): Aumenta o zoom
CTRL + SINAL DE MENOS (-): Diminui o zoom
CTRL + ASTERISCO (*) ou CTRL + 0 (ZERO): Volta para o zoom padro (100%)
CTRL + Roda do mouse para cima: Aumenta o zoom
CTRL + Roda do mouse para baixo: Diminui o zoom
NOTA: Ao uti l i za r a s opes de CTRL + Roda do mous e (pa ra ci ma ou pa ra ba i xo), o
foco do zoom s empre rel a ti vo pos i o do pontei ro do mous e.
7.3.9 Camadas
O E3 oferece uma arquitetura de Telas com at 32 camadas para insero de
objetos. Cada objeto pode pertencer a uma ou mais camadas, e a Tela ativa tanto
em tempo de configurao (no E3 Studio) quanto em tempo de execuo (no E3
Viewer) pode estar com nenhuma, uma, vrias ou todas as camadas ativas. Isto
permite criar sistemas com vrias formas de monitoramento, como por exemplo a
visualizao de um processo apenas com o sistema eltrico, apenas o hidrulico
ou ambos. possvel tambm controlar o aparecimento de camadas de acordo com
um determinado nvel de zoom. A configurao das camadas feita clicando-se em
Camadas na barra de ferramentas Tela. As opes disponveis esto descritas na
tabela a seguir.
Opes disponveis para a configurao de Camadas
OPO
Camada
Todas as camadas
Nenhuma camada
Editar camadas
DESCRIO
Ha bi l i ta a vi s ua l i za o da ca ma da
confi gura da na propri eda de Layer da
Tel a .
Mos tra toda s a s ca ma da s di s ponvei s no
projeto.
Nenhuma ca ma da mos tra da .
Atra vs des ta op o, pode-s e confi gura r
ca ma da s i ndi vi dua i s . Es ta op o a bre
uma ca i xa de di l ogo pa ra confi gura o
da ca ma da .
Quando a opo Editar camadas selecionada, a janela da figura a seguir

mostrada.
229
Edio de Camadas
A janela Edio de Camadas tem as seguintes opes: Adicionar Camada , para a

criao de uma nova camada; Remover Camada , para a excluso da camada
selecionada; e Editar Camada , para a edio da camada selecionada. Ao clicar
em ou , a janela da figura a seguir aberta.
Adio ou edio de camadas

230
Opes disponveis na Camada

OPO
Nome da Camada
Zoom Baixo
Zoom Alto
Usar condio adicional de visibilidade
Fonte
DESCRIO
Determi na o nome da ca ma da .
Defi ne a porcenta gem i ni ci a l de zoom
na ca ma da .
Defi ne a porcenta gem fi na l de zoom na
ca ma da .
Ha bi l i ta a uti l i za o de uma condi o
a di ci ona l de vi s i bi l i da de de zoom na
ca ma da . Es ta condi o pode s er uma
va ri vel ou propri eda de qua l quer.
Es ta bel ece uma As s oci a o ou uma
propri eda de que, uma vez a ti va
(di ferente de zero), ta mbm exi be a
ca ma da (a s opes de Zoom e Fonte n o
s o excl us i va s , i s to , podem a ti va r a
ca ma da es ta ndo uma ou outra condi o
a ti va ).
Para maiores informaes, consulte o Manual de Referncia de Scripts.
7.3.10 Travar
Ao selecionar esta opo, o E3 Studio no permite que o objeto seja movido,
evitando movimentos indesejados. Depois de travado, o mouse exibe um cursor
com um cadeado ao ser deslocado sobre a rea do objeto.
Para habilitar esta opo, clique com o boto direito do mouse no objeto desejado
e selecione a opo Travar .
Objeto travado
Para desabilitar esta opo, clique novamente com o boto direito do mouse no
objeto e selecione a opo Destravar .
231
7.3.11 Ponto ncora

Um Ponto ncora definido como as coordenadas que marcam o ponto inicial do
objeto. Inicialmente, o ponto ncora est atrelado s coordenadas iniciais do
objeto.
Para habilitar esta opo, clique com o boto direito do mouse no 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 fica fixado nos pontos da grade, sendo que
o objeto fica deslocado nas mesmas propores em relao ncora. Isto s
visualizado se a opo Alinhar Mouse Automaticamente (propriedade da Grade)
estiver habilitada.
Objeto com ponto ncora

NOTA: Ao uti l i za r a combi na o de tecl a s CTRL + BARRA DE ESPAO (efei to Snap to
Pixel) em um objeto com a op o Definir Ponto ncora ha bi l i ta da , o objeto movi do
pa ra o pi xel ma i s prxi mo, s em res pei ta r a pos i o do ponto ncora . Ca s o s eja
uti l i za do o mous e pa ra mover o objeto, o ponto ncora pos i ci ona do exa ta mente
em ci ma de um pi xel . Pa ra corri gi r eventua i s di s crep nci a s no pos i ci ona mento do
objeto, pode-s e uti l i za r a combi na o CTRL + BARRA DE ESPAO a ps s ol ta r o bot o
do mous e.
7.3.12 Sombreamento
Permite aplicar ou editar o efeito de sombra em um objeto de Tela.
Opes da sombra
Para utilizar este recurso, siga estes procedimentos:

1. Insira ou selecione o objeto ao qual deseja aplicar a sombra.
2. Altere suas propriedades atravs da barra de ferramentas Sombra, de acordo
232
com as opes mostradas na tabela a seguir.

Opes disponveis na barra de ferramentas Sombra
OPO
DESCRIO
Ha bi l i ta ou des a bi l i ta o efei to de
s ombra no objeto.
Des l oca a s ombra a ba i xo do objeto.
Des l oca a s ombra a ci ma do objeto.
Des l oca a s ombra es querda do
objeto.
Des l oca a s ombra di rei ta do objeto.
Confi gura a cor da s ombra do objeto.
7.3.13 Desenho
Permite aplicar ou editar informaes relativas s cores de fundo e frente da Tela e
objetos de Tela e borda dos objetos de Tela.
Opes de desenho

1. Insira ou selecione o objeto (Tela ou objeto de Tela) cujas cores ou bordas
deseja editar.
2. Altere suas propriedades de acordo com as opes disponveis na barra de
ferramentas Desenho.
As opes disponveis nesta barra de ferramentas esto descritas na tabela a
seguir.
Opes disponveis na barra de ferramentas Desenho
CONE
233
OPO
Cor do Fundo
DESCRIO
Permi te s el eci ona r a cor
de fundo da Tel a ou do
objeto de Tel a a pa rti r de
uma l i s ta de cores pres ta bel eci da s , ou cri a r
uma nova cor
pers ona l i za da .
CONE
OPO
Cor da Frente
Cor da Borda
Estilo da Borda
Espessura da Linha
Estilo do Preenchimento
DESCRIO
de frente da Tel a ou do
uma l i s ta de cores pres ta bel eci da s , ou cri a r
uma nova cor
da borda do objeto de
Tel a a pa rti r de uma l i s ta
de cores pres ta bel eci da s , ou cri a r
uma nova cor
Permi te es col her o ti po
de borda exi bi da pel o
uma l i s ta com es ti l os pres ta bel eci dos : uma l i nha
contnua , di ferentes ti pos
de ponti l ha dos e
tra ceja dos , ou
s i mpl es mente nenhuma
borda .
Permi te es col her a
es pes s ura da l i nha da
borda do objeto de Tel a a
pa rti r de uma l i s ta com
es pes s ura s pres ta bel eci da s entre 0 e
2,5 mi l metros .
Permi te es col her o ti po
de preenchi mento
exi bi do pel a Tel a ou pel o
objeto de Tel a , i s to ,
como s e d a combi na o
entre a s cores de fundo e
de frente do objeto. Ao
s el eci ona r es ta op o, a
ja nel a mos tra da na fi gura
a s egui r a berta .
234
Efeitos de preenchimento

Opes disponveis na janela Preenchimento
OPO
Estilos
Cor da frente
Cor do fundo
Amostra
235
DESCRIO
Mos tra todos os es ti l os de preenchi mento
di s ponvei s pa ra o objeto s el eci ona do.
Mos tra a cor da frente previ a mente
s el eci ona da pa ra o objeto. Permi te
ta mbm a s el e o de uma nova cor de
frente (o mes mo que cl i ca r em
).
Mos tra a cor de fundo previ a mente
s el eci ona da pa ra o objeto. Permi te
ta mbm a s el e o de uma nova cor de
fundo (o mes mo que cl i ca r em
).
Mos tra como o efei to es col hi do a pl i ca do
com a s cores de fundo e de frente do
objeto.
OPO
Opaco ou Transparente
DESCRIO
Ao s el eci ona r a op o Transparente, os
preenchi mentos com efei to ha chura do n o
mos tra m a cor de fundo do objeto
s el eci ona do, s omente a cor de frente,
cri a ndo um efei to de tra ns pa rnci a no
objeto. Ao s el eci ona r a op o Opaco, es te
efei to n o a contece. NOTA: A op o
Transparente es t des a bi l i ta da pa ra a Tel a .
7.3.14 Configurar como Padro

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

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

Em propriedades do tipo Cor, a alterao de valor pode ser feita por meio de caixas
de dilogo, como mostrado a seguir, disponveis na lista de Propriedades ao clicar
em
na janela de Propriedades. Existem dois modos para se escolher a cor
desejada: atravs da aba Padro, onde possvel selecion-la dentre cores prdefinidas, ou atravs da aba Personalizado, onde pode-se informar a cor atravs de
seus componentes.
236
Cores
A opo Outra permite que o usurio selecione uma cor de qualquer parte da tela,
dentro ou fora do E3 Studio. Clique em
e aps na cor desejada para que ela seja
capturada para a janela de cores.
Para personalizar uma cor, pode-se combinar duas metodologias: RGB
(componentes de vermelho, verde e azul) ou HSL (componentes de matiz, saturao e
luminosidade).
237
Cor personalizada
A escala RGB descreve uma cor atravs da mistura de trs cores bsicas, a saber:
Red (vermelho): Indica a quantidade do componente primrio vermelho na
composio da cor
Green (verde): Indica a quantidade do componente primrio verde na
composio da cor
Blue (azul): Indica a quantidade do componente primrio azul na
composio da cor
Cada um destes elementos de cor podem ter um grau de intensidade que vai de 0 a
255.
A escala HSL descreve uma cor atravs da mistura de trs componentes bsicos, a
saber:
Hue (matiz): Especifica a gradao da cor dentro do espectro de luz visvel
Saturation (saturao): Indica a intensidade de um determinado matiz. Um
matiz com alta saturao tem uma cor mais intensa, enquanto um matiz com
baixa saturao produz uma cor mais acinzentada
Lightness (luminosidade): Indica a quantidade de luz aplicada cor. Quanto
maior a luminosidade, mais clara a cor. Do mesmo modo, quanto menor a
luminosidade, mais escura a cor
238
Estes elementos tambm podem ter seu grau de intensidade configurado entre 0 e
255. Assim, basta especificar o valor para cada um dos itens, conforme a
tonalidade da cor desejada, ou escolher a cor desejada diretamente com o mouse
sobre as escalas da janela.
O valor numrico de cada cor obtido atravs da seguinte frmula:
Red * 256^0 + Green * 256^1 + Blue * 256^2
Ou seja:
Red * 1 + Green * 256 + Blue * 65536
Sendo que as variveis Red, Green e Blue podem assumir valores de 0 a 255. Por
exemplo:
Preto (0, 0, 0): 0 * 1 + 0 * 256 + 0 * 65536 = 0
Branco (255, 255, 255): 255 * 1 + 255 * 256 + 255 * 65536 = 16777215
Vermelho (255, 0, 0): 255 * 1 + 0 * 256 + 0 * 65536 = 255
Verde (0, 255, 0): 0 * 1 + 255 * 256 + 0 * 65536 = 65280
Azul (0, 0, 255): 0 * 1 + 0 * 256 + 255 * 65536 = 16711680
NOTA: Os va l ores a rma zena dos na s propri eda des dos objetos que s e referem a
cores s o os va l ores numri cos , ca l cul a dos a tra vs da frmul a a nteri or. A
ferra menta Procurar e Substituir uti l i za es te va l or a rma zena do no proces s o de
pes qui s a , e n o os va l ores forma ta dos como RGB mos tra dos na ja nel a de
Propri eda des .
7.5 Formatao de Valores

O uso de formatadores permite mudar a forma como os dados so apresentados
sem precisar mudar o valor que existe por trs deles. O formato um texto que
pode ser editado manualmente ou configurado atravs da janela de formatao.
Seu uso semelhante aos formatadores usados nas planilhas eletrnicas, seguindo
a mesma sintaxe bsica, mas com algumas extenses. So suportados os seguintes
tipos de dados:
Numricos (sada decimal, cientfica, hexadecimal, binria e octal)
Texto
Booleanos
Datas e Horas (calendrio Gregoriano)
Os objetos que suportam formatao devem ter o tipo de dado na propriedade
239
Value alterado de acordo com o tipo de formatao desejada.
Janela de Formatao de Valores
As seguintes formataes esto disponveis:

Geral: No h formatao especfica. realizada automaticamente,
dependendo do tipo de dado
Nmero: Apresenta nmeros com parte inteira e fracionria, permitindo
definir o nmero de casas decimais e uso de separador de milhares. Para
nmeros muito grandes ou muito pequenos, utilize o formato Cientfico. Os
smbolos de casa decimal e separador de milhares so aqueles definidos no
Painel de Controle - Configuraes Regionais
Data/Hora: Apresentam valores numricos (formato Gregoriano) como datas
e horas, quando vlidos
Porcentagem: Multiplica o nmero por 100 e adiciona o smbolo de
percentual, definindo tambm o nmero de casas decimais
Cientfico: Este formato apresenta o nmero em notao de mantissa e
expoente. Ideal para nmeros de magnitude variada, permitindo escolher
tambm o nmero de casas decimais e formatos
Especial: Permite formatar nmeros inteiros em bases no decimais
(hexadecimal, octal e binria)
240
7.5.1 Outros Formatos

Na opo Outro, pode-se criar um formato de dados qualquer, mesmo um dos j
citados, a partir da digitao de um cdigo (texto) de formato.
O texto do formatador composto de at quatro campos separados por um ponto e
vrgula. O primeiro campo sempre aplicado quando no existir um outro campo
mais apropriado para o valor ou tipo de dado. O segundo campo utilizado para
valores numricos negativos. O terceiro campo utilizado quando o valor
numrico for zero. Finalmente, o quarto campo utilizado quando o dado for do
tipo texto.
Sempre que mais de um campo for definido, o campo anterior considerado,
mesmo que esteja vazio. No caso de um formatador de campo vazio, o valor
formatado sempre um texto vazio. Note que isto difere do formato Geral, que
apenas um formato vazio, sem o uso dos separadores de campo (ponto e vrgula).
Para inserir caracteres que so mostrados pelo formatador, pode-se coloc-los
entre aspas duplas ou aps uma barra invertida. Exemplos (vlidos para todos os
tipos de formatadores):
Entrada de Texto
FORMATADOR
SADA FORMATADA
0#?
mdy
"0#?"
\m\d\y
Tambm possvel criar formatadores que contenham apenas texto, que podem ser
combinados com o uso de diferentes campos, como no exemplo a seguir.
Formatador e Sada Formatada
VALOR
1
-1
0
"Abcd"
FORMATADOR
"Pos i ti vo";"Nega ti vo";"Zero
","Texto"
","Texto"
","Texto"
","Texto"
SADA FORMATADA
Pos i ti vo
Nega ti vo
Zero
Texto
Alm disto, os seguintes caracteres podem ser mostrados diretamente sem o uso de
aspas ou barra: $ - + / () : ! ^ & ' (aspas simples esquerda) ' (aspas simples
direita) ~ { } = < >
241
NOTA: Pa ra mos tra r a ba rra i nverti da ou a s pa s dupl a s no da do forma ta do, us e \" ou

\\. Qua ndo entre a s pa s , todo o texto copi a do di reta mente; l ogo, "\a" mos tra do
s i mpl es mente como \a.
Os formatadores numricos aceitam trs tipos bsicos de caracteres para definir o

nmero de dgitos apresentados:
Formatadores Numricos
OPO
DESCRIO
Col oca o dgi to s i gni fi ca ti vo ou 0 (zero),
qua ndo n o houver.
Col oca o dgi to s i gni fi ca ti vo.
Col oca o dgi to s i gni fi ca ti vo ou um
es pa o, qua ndo n o houver.
0 (zero)
#
?
O ponto decimal define que se deseja apresentar tambm a parte fracionria de um

nmero. A vrgula tem como funo indicar que o valor deve ser dividido por mil
(para cada vrgula), aps os dgitos do formatador.
Independente da configurao local do Windows, o ponto e a vrgula sempre devem
ser utilizados no texto do formatador para indicar o separador de milhar e de
decimal, mas a sada formatada de acordo com a configurao regional do
sistema. Exemplos:
Opes disponveis
DADO
FORMATADOR
#,
#,#.0
12000
1234567
SADA FORMATADA
12
1,234,567.0
7.5.1.1 Formatos Cientficos

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

O caractere @ copia o valor do dado na posio onde aparecer. Este formatador
deve aparecer no quarto campo (por exemplo, ;;;@) ou diretamente quando h
242
apenas um campo. Exemplos:

Formatador para Texto
DADO
Abc
xyZ
FORMATADOR
@@
"Nome: " \ " @ \ "
SADA FORMATADA
Abc Abc
Nome: "xyZ"
7.5.1.3 Formatos de Bases No Decimais

Os formatadores para bases no-decimais sempre apresentam apenas a parte
inteira do valor numrico formatado, e tambm no so sensveis ao sinal. Da
mesma forma que na base decimal, caso o nmero possua mais dgitos do que o
requisitado no formatador, estes dgitos so apresentados de qualquer forma.
Atualmente, estes formatadores esto limitados em nmeros de 32 bits. Caso a
parte inteira do valor exceda este limite, a formatao retorna erro. Exemplos:
Formatadores para Bases No-Decimais
DADO
255
12345
987
12
FORMATADOR
"0x"XXX
oooo\o
B
BBBB - BBBB
SADA FORMATADA
0x0FF
30071o
1111011011
0000 - 1100
7.5.1.4 Formatos de Data e 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, garantindo uma resoluo
de pelo menos 1 ms em todo o intervalo. Os nomes de meses e dias da semana, a
ordem padro de dia, ms e ano e o separador de datas e horas so todos
utilizados de acordo com a configurao regional do Windows. Atravs do quadro
a seguir, possvel verificar o formatador e a sada formatada para os valores.
Formatadores para Datas e Horas
DADO
1234.56789
0.56789
12.345678
243
FORMATADOR
dd/MMMM/yyyy
hh:mm:s s .000 tt
hh\hmm\ms s .000\s
SADA FORMATADA
18/ma i o/1903
01:37:45.696 PM
296h17m46.667s
NOTA: Os va l ores a rma zena dos na s propri eda des dos objetos que s e referem a
da ta s s o os va l ores numri cos , ca l cul a dos a tra vs da frmul a a nteri or. A
ferra menta Procurar e Substituir uti l i za es te va l or a rma zena do no proces s o de
pes qui s a , e n o os va l ores forma ta dos como da ta e hora mos tra dos na l i s ta de
propri eda des .
244
CAPTULO
Associaes
Associaes (ou conexes) so ligaes feitas entre propriedades e objetos ou

outras propriedades. As Associaes trazem grande facilidade ao criar animaes
e outros tipos de lgicas comuns, minimizando a utilizao de scripts.
Pode-se acessar a aba Associaes clicando-se com o boto direito do mouse no
objeto e selecionando a opo Propriedades. Nesta aba, so mostradas as
propriedades do objeto que podem ser associadas, bem como os tipos de
Associaes existentes e suas fontes.
Aba Associaes
As opes disponveis na aba Associaes esto disponveis na tabela a seguir.

Opes disponveis na aba Associaes
OPO
Propriedades
245
DESCRIO
Li s ta a s propri eda des do objeto que
podem s er a s s oci a da s .
Associaes
OPO
Conexo
Fonte
DESCRIO
Indi ca o ti po de As s oci a o que a
propri eda de pos s ui . Pa ra propri eda des
comuns , a s As s oci a es di s ponvei s s o
a s s egui ntes : Simples, Bidirecional,
Analgica, Digital, Por Tabela, Reversa e
Mltipla. Exi s te a i nda a l i ga o entre
propri eda des de El i ps eX e objetos , que
a i nda n o pode ter s eu ti po modi fi ca do
(pa ra ma i ores deta l hes , cons ul te o
ca ptul o Bibliotecas).
No ca s o ma i s s i mpl es , es peci fi ca o
ca mi nho pa ra um objeto ou propri eda de.
Es te ca mi nho pode s er preenchi do pel o
AppBrows er, cl i ca ndo-s e em
, que fi ca
di rei ta do ca mpo. No ca s o gera l , uma
expres s o que permi te a pl i ca r opera es
l gi ca s , a ri tmti ca s e a va l i a es de
funes propri eda des , objetos e
cons ta ntes .
Ao especificar a fonte da Associao, o seu texto aparece 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 aparece em vermelho. Nestes casos, a opo de Verificar
Domnio informa os locais que necessitam de correo ou reviso. Os tipos de
Associaes disponveis so explicados nos tpicos a seguir.
8.1 Simples
Na Associao Simples, o valor do campo Fonte copiado para a propriedade toda
vez que o primeiro for modificado.
Associaes
246
Associao Simples

1. Selecione o objeto desejado para a Associao.
2. Clique com o boto direito do mouse no objeto e selecione a opo
Propriedades.
3. Clique na aba Associaes e selecione a propriedade para a qual deseja fazer a
Associao. O Studio indica vrios tipos de Associaes.
4. No campo Fonte, selecione a Associao desejada e clique em
para indicar
a propriedade que deseja referenciar, ou escreva a expresso neste campo.
8.2 Bidirecional
A Associao Bidirecional semelhante Associao Simples. Porm, caso haja uma
variao na propriedade, seu valor copiado para a fonte, gerando assim uma
Associao de duas direes.
247
Associaes
Associao Bidirecional

Propriedades.
para indicar
8.3 Digital
J na Associao Digital podemos estabelecer que, caso a varivel ou expresso do
campo Fonte represente um valor digital (Booleano), seus estados Verdadeiro e
Falso so mapeados para certos valores no destino, incluindo a opo de Pisca
(alternncia de valores).
Associaes
248
Associao Digital
As opes disponveis nesta Associao esto descritas na tabela a seguir.

Opes disponveis para a Associao Digital
OPO
Ligado
Desligado
Pisca
Para valor <Campo Ligado>
249
DESCRIO
Es peci fi ca o va l or a s s umi do pel a
propri eda de qua ndo a expres s o da
fonte for Verda dei ra .
Es peci fi ca o va l or a s s umi do pel a
fonte res ul ta r em Fa l s o.
Qua ndo es te ca mpo es ti ver ha bi l i ta do, a
propri eda de conecta da a l terna entre os
va l ores do ca mpo Para valor, ca s o a fonte
retorne Verda dei ro. Ca s o contr ri o, a
propri eda de retorna da a l terna entre os
va l ores dos ca mpos Valor e Para valor
ca s o a fonte retorne Fa l s o.
Es peci fi ca o va l or a l terna ti vo a s er
a s s umi do peri odi ca mente pel a
propri eda de qua ndo a expres s o ou
As s oci a o da fonte res ul ta r em
Verda dei ro e o ca mpo Pisca es ti ver
ha bi l i ta do.
Associaes
OPO
Para valor <Campo Desligado>
DESCRIO
Es peci fi ca o va l or a l terna ti vo a s er
a s s umi do peri odi ca mente pel a
fonte res ul ta r em Fa l s o e o ca mpo Pisca
es ti ver des a bi l i ta do.

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

Opes disponveis para a Associao Analgica
OPO
Valor na Fonte
Valor na Propriedade
DESCRIO
Determi na os va l ores mni mo e m xi mo
a ti ngi dos na fonte.
Determi na os va l ores mni mo e m xi mo
a ti ngi dos na propri eda de.

2. Clique com o boto direito do mouse no objeto, selecione o item Propriedades e
clique na aba Associaes. Selecione a propriedade para a qual deseja fazer a
para indicar
8.5 Por Tabela

Na Associao por Tabela, possvel especificar um conjunto de intervalos em
funo de valores mximo e mnimo da fonte e, para cada um destes intervalos, o
valor a ser assumido pela propriedade. Alm disto, assim como na Associao
Digital, possvel especificar a opo de Pisca e o valor alternativo. Para utilizar
1. Abra a janela de propriedades do objeto e selecione a aba Associaes.
2. Selecione a propriedade para a qual deseja criar a Associao e clique no item
Conexo por Tabela.
251
Associaes
Associao por Tabela

Opes disponveis para a Associao por Tabela
OPO
Mn
Mx
Valor
Pisca
Valor <Pisca Habilitado>
DESCRIO
Ins ere uma nova l i nha na ta bel a .
Remove a l i nha s el eci ona da da ta bel a .
Es peci fi ca o va l or mni mo da fonte pa ra
uma l i nha da ta bel a .
Es peci fi ca o va l or m xi mo da fonte pa ra
Es peci fi ca o va l or da propri eda de a s er
a s s umi do qua ndo a fonte es ti ver no
i nterva l o es peci fi ca do na l i nha .
Determi na que qua ndo a fonte es ti ver
no i nterva l o des ta l i nha , a propri eda de
a l terna peri odi ca mente entre os va l ores
es peci fi ca dos na s opes Valor e Valor
(com o Pisca habilitado).
Es peci fi ca o va l or a l terna ti vo da
propri eda de a s er a s s umi do qua ndo a
fonte es ti ver no i nterva l o es peci fi ca do
na l i nha , i s to , qua ndo a op o Pisca
es ti ver ha bi l i ta da .

1. Na aba Associaes, selecione a propriedade e associe a opo Conexo por
tabela.
2. Crie as linhas desejadas na tabela e configure as colunas Mn, Mx e Valor.
Associaes
252
3. Caso deseje alternar periodicamente entre os valores, habilite a coluna Pisca e

configure as opes restantes.
8.6 Reversa
Na Associao Reversa, toda vez que o valor da propriedade for modificado, este
copiado para a fonte, funcionando assim de maneira reversa Associao Simples.
1. Abra a janela de propriedades do objeto e selecione a opo Associaes.
2. Selecione a propriedade para a qual deseja fazer a Associao e clique no item
Conexo Reversa.
para indicar
Associao Reversa
8.7 Mltipla
Na Associao Mltipla, cada linha da Associao permite buscar o valor de uma
fonte diferente. A fonte ativa selecionada de acordo com o valor fonte principal
da Associao.
Cada linha possui o intervalo (propriedades Min e Max) e a fonte para aquele
intervalo (propriedade Source, que um link normal). Para utilizar este recurso,
253
Associaes
1. Abra a janela de propriedades do objeto e selecione a aba Associaes.

2. Selecione a propriedade para a qual deseja criar a Associao e clique no item
Conexo Mltipla.
3. Defina a fonte principal da Associao na coluna Fonte.
Associao Mltipla

Opes disponveis para a Associao Mltipla
OPO
Mn
Mx
Fonte
Manter todas associaes ativas
DESCRIO
Ins ere uma nova l i nha na ta bel a .
Remove a l i nha s el eci ona da da ta bel a .
Es peci fi ca o va l or mni mo da fonte pa ra
Es peci fi ca o va l or m xi mo da fonte pa ra
Es peci fi ca a fonte que a s s oci a da com
a propri eda de qua ndo o va l or da fonte
pri nci pa l es ti ver entre os l i mi tes Mn e
Mx.
Ma ntm toda s a s As s oci a es da ta bel a
em modo Advise (a ti va s ). Es ta
propri eda de corres ponde
propri eda de AdviseAll.
8.8 Edio de Associaes

O E3 possui uma ferramenta para editar Associaes, chamada Edio de
Associaes. Assim, possvel mudar uma ou mais Associaes criadas na
Associaes
254
aplicao de forma mais rpida do que pela janela tradicional.

Para acessar esta ferramenta, clique com o boto direito do mouse em um ou mais
objetos e selecione a opo Editar Associaes.
Opo Editar Associaes
A caixa de dilogo da figura a seguir mostrada.
Edio de Associaes
A caixa de dilogo anterior mostra uma lista das Associaes, propriedades do

tipo Link e eventos do usurio relacionados aos objetos selecionados e seus filhos.
De acordo com o tipo de linha, as informaes mostradas nas colunas esto
255
Associaes
Opes disponveis na janela Editar Associaes

OPES
Nome do Objeto
Propriedade / Evento
Conexo
Fonte
DESCRIO
Determi na o nome do objeto.
Determi na a propri eda de do objeto que
pos s ui a As s oci a o.
Determi na o ti po de As s oci a o (Simples,
Bidirecional, Digital, Analgica, Por Tabela,
Reversa e Mltipla).
Determi na a fonte da As s oci a o.
Opes para Propriedades do tipo Link

OPO
Nome do Objeto
Conexo
Fonte
DESCRIO
Determi na o nome do objeto que pos s ui
a propri eda de.
Determi na o nome da propri eda de.
s empre a mes ma (Link).
Determi na o va l or da propri eda de.
Opes para Eventos do usurio

OPO
Nome do Objeto
Conexo
Fonte
DESCRIO
Determi na o nome do objeto que pos s ui
o evento.
Determi na o nome do evento do us u ri o.
Determi na o ti po do evento (OnEvent,
WhileEvent ou OnValueChangeEvent).
Expres s o rel a ci ona da a o evento.
Na caixa de dilogo Editar Associaes, permitido modificar as seguintes opes:

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
Clicar em
permite a remoo da Associao selecionada. A opo Mostrar janela
de propriedades das associaes determina se os minidialogs das Associaes so
mostrados quando a linha estiver selecionada. Se esta janela estiver visvel,
permitida a edio das propriedades das Associaes. Seu valor padro
habilitado.
Associaes
256
Edio das propriedades da Associao selecionada
Para editar as propriedades dos eventos do usurio, necessrio selecionar a

linha que contm o evento e, na coluna Conexo, clicar na opo Editar.
Edio das propriedades dos eventos do usurio
Ao clicar na opo Editar, a caixa de dilogo a seguir mostrada, permitindo assim

que seja editado o evento do usurio selecionado.
257
Associaes
Janela Editar Eventos

Opes disponveis na janela Editar Eventos
OPO
Propriedade ou expresso
DESCRIO
Propri eda de ou expres s o gera dora do
evento.
Sempre que a propriedade for uma condio Indi ca que o evento do ti po etOnEvent
ou etWhileEvent.
verdadeira
Indi ca o ci cl o de repeti o do evento em
Repetir o evento
mi l i s s egundos , i s to , de qua nto em
qua nto tempo el e ocorre, enqua nto a
expres s o gera dora for verda dei ra .
Va l or pa ra o i nterva l o de repeti o, em
Intervalo de repetio (ms)
mi l i s s egundos .
Sempre que a propriedade alterar o seu valor Indi ca que o evento do ti po
etOnValueChangeEvent, i s to , o evento
ocorre s empre que a expres s o gera dora
muda r o va l or.
Tratar a desconexo como mudana de valor Se houver a l guma des conex o, el a
tra ta da como uma muda na de va l or.
A janela de edio de Associaes permite utilizar o recurso de copiar e colar entre

as Associaes das propriedades. A opo Copiar Associao copia a Associao da
linha selecionada e a opo Colar Associao cola a Associao na linha
selecionada, substituindo a Associao anterior.
Associaes
258
Opo de copiar ou colar uma Associao
259
Associaes
CAPTULO
Bibliotecas
O E3 possui ferramentas que permitem transformar qualquer objeto ou conjunto de

objetos da aplicao em uma biblioteca do usurio. As Bibliotecas podem ser
formadas por objetos frequentemente utilizados, e subsequentemente
reaproveitados em outra aplicao.
O E3 fornece dois tipos de bibliotecas para o usurio: a Galeria, uma biblioteca de
smbolos grficos vetoriais, que podem ser livremente utilizados nas aplicaes; e
uma ferramenta de bibliotecas do usurio chamada de ElipseX. O uso de
bibliotecas no E3 altamente recomendvel na maioria dos casos, devido ao ganho
de produtividade que elas trazem s aplicaes. Algumas das vantagens dos
ElipseX:
Reutilizao de cdigos
Minimizao de testes durante o desenvolvimento
Criao de interfaces padro para os objetos desenvolvidos
Diminuio do tempo de desenvolvimento de novos projetos
Proteo do contedo do projeto
Bibliotecas no Organizer
Bibliotecas
260
9.1 Galeria
A Galeria pode ser acessada clicando-se em
Galeria na barra de ferramentas
Padro. Neste item est disponvel uma srie de elementos grficos vetoriais,
divididos em categorias, que podem ser arrastados para as Telas ou ento para os
ElipseX. Esto disponveis os seguintes tipos de smbolos: 3D ISA Symbols, Ar
Condicionado, Arquitetura, Setas, ASHRAE (Controles e Equipamentos), ASHRAE
(Dutos), ASHRAE (Canos), Formatos Bsicos, Sopradores e Ventiladores, Prdios,
Processos Qumicos, Computadores, Contineres, Controladores, Esteiras e Linhas
de Produo, Dutos, Eltrica, Tubos Flexveis, Medidores de Vazo, Smbolos Gerais,
Aquecimento, HVAC, cones e Bitmaps, Miscelnea Industrial, Smbolos
Internacionais, Smbolos ISA, Mapas e Bandeiras, Manuseio de Materiais, Canos,
Misturadores, Motores, Natureza, Interfaces Homem Mquina, Painis, Acessrios
Industriais, Dispositivos de Potncia, Resfriamento de Processos, Aquecimento de
Processos, Bombas, Segurana, Escalas, Canos Segmentados, Sensores, Cortes em
Tanques, Texturas, Vlvulas, Veculos, gua e Abastecimento, Fios e Cabos, Botes
3D, Caldeiras, Teclas de Computador, Acabamento, Comida, Laboratrio,
Maquinrio, Minas, Papel e Polpa.
1. Clique em
Galeria na barra de ferramentas Padro.
2. Selecionando esta aba, tem-se acesso aos conjuntos de smbolos, que esto
agrupados em categorias. Selecione a categoria atravs da lista na parte
superior da janela.
3. Para inserir um objeto da biblioteca de smbolos em uma Tela, basta clicar no
objeto desejado e arrast-lo para a Tela.
4. Depois de inserido, o objeto pode ser livremente editado e trabalhado de
acordo com as caractersticas descritas para os objetos de imagem. Por
exemplo, pode-se mudar a cor de preenchimento diretamente atravs das
propriedades OverrideFillMode, OverrideFillColor e OverrideLineColor, sem a
necessidade de transformar o objeto em um objeto grfico do E3.
261
Bibliotecas
Galeria
9.2 Biblioteca do Usurio (ElipseX)

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

4. Determine as especificaes referentes ao Domnio.
5. Clique em Concluir.
Dentro de uma biblioteca ElipseX, pode-se inserir dois tipos de objetos: os objetos
grficos XControls e os objetos de dados XObjects.
Os seguintes itens podem ser inseridos em um XControl: Primitivas de Desenho
(Retas, Retngulos, Crculos, etc.), Objetos Grficos Vetoriais, incluindo objetos da
biblioteca de smbolos (WMF, EMF, etc.), Objetos Grficos no-Vetoriais (BMP,
JPEG, GIF,etc.), Controles ActiveX do E3 (E3Chart, E3Browser, E3Alarm, Controles
ActiveX de terceiros) e outros XControls.
J os XObjects podem conter quaisquer tipos de objetos no-grficos, executados
no E3 Server, como Drivers de Comunicao, Servidores de Dados, Bancos de Dados,
Frmulas, Configuraes de Alarmes, Servidores de Alarmes, Objetos COM, entre
outros.
Dentro de um mesmo arquivo .lib pode existir qualquer nmero de componentes
ElipseX, sejam eles XControls ou XObjects. Pode-se tambm ter vrias bibliotecas
diferentes dentro do mesmo Domnio.
263
Bibliotecas
Note que para cada XObject ou XControl criado em uma biblioteca so criadas
internamente duas interfaces, uma para declarar as propriedades do objeto, e
outra para declarar os eventos do objeto. Estas interfaces tm seus nomes gerados
automaticamente, acrescentando o prefixo "D" a este nome (a interface de eventos
adiciona o sufixo "Events" ao nome automtico). Se, por exemplo, o objeto se
chama "XObject1", sua interface de propriedades tem o nome "DXObject1" e a
interface de eventos, "DXObject1Events". Uma tentativa de usar estes nomes em
outras classes na mesma biblioteca gera um cdigo de erro 8002802D, que
corresponde a Name already exists in the library.
9.2.1 XControls
O XControl define uma interface grfica com o usurio, que pode ser composta de
quaisquer objetos do E3, e tem o propsito de ser multiplicada facilmente por um
projeto. Pode-se criar um XControl clicando com o boto direito do mouse no
arquivo LIB criado no Domnio e selecionando a opo Inserir - XControl.
Aba Design de um XControl
Bibliotecas
264
Aba Propriedades de um XControl
Ao inserir um XControl aberta a view deste objeto, composta por trs abas. Alm
da aba Scripts, presente em todos os objetos, existe a aba Design, que equivale a
uma Tela, onde podem ser inseridos os objetos grficos descritos anteriormente, e
a aba Propriedades, onde podem ser inseridas variveis, que so as propriedades
do XControl. Estas propriedades so exportadas pelo objeto e podem ser
associadas a um Tag ou outra propriedade qualquer quando o objeto estiver sendo
usado na aplicao.
As variveis a serem exportadas podem ser inseridas pressionando-se a tecla
INSERT do teclado ou clicando em e excludos atravs da tecla DELETE do teclado
ou clicando em . As opes disponveis deste item esto descritas na tabela a
seguir.
OPO
Nome
265
DESCRIO
Determi na o nome da va ri vel do XControl .
Bibliotecas
OPO
Tipo
Valor
Texto de ajuda
DESCRIO
Determi na o ti po de da do s uporta do pel a
va ri vel . Note que outros objetos de
Da dos (XObjects ) podem s er decl a ra dos
como Ti pos . Des ta forma , pode-s e cri a r um
objeto de da dos que pos s ui como
propri eda de outro objeto de da dos . Os
objetos de da dos podem funci ona r nes te
ca s o como uma es trutura ou cl a s s e, como
uti l i za do na s l i ngua gens C/C++. Qua ndo
for es peci fi ca do um ti po de objeto (por
exempl o DemoTa g, IOTa g, XObject, etc.),
es ta propri eda de tem o s egui nte
comporta mento:
Caso o ElipseX esteja inativo: A
propri eda de funci ona como uma String,
que es peci fi ca o ca mi nho da i ns t nci a
de um objeto do ti po confi gura do
Caso o ElipseX esteja ativo: Na es cri ta , a
propri eda de funci ona como o ca s o
a nteri or, porm na l ei tura a
propri eda de retorna o objeto
es peci fi ca do, ca s o el e exi s ta . Se o
ca mi nho n o a ponta pa ra um objeto
exi s tente no momento, a propri eda de
retorna Nothing.
Ha bi l i ta ou des a bi l i ta a vi s i bi l i da de da
va ri vel fora da bi bl i oteca , i s to ,
determi na s e a va ri vel ou n o pbl i ca .
Determi na s e a va ri vel s a l va no projeto
ou n o.
Determi na s e a propri eda de retenti va ou
n o. No ca s o de XControl s , a s
propri eda des n o podem s er retenti va s .
Determi na o va l or i ni ci a l da va ri vel .
Texto de decl a ra o e documenta o da
va ri vel .
NOTA: i nteres s a nte obs erva r que podem s er decl a ra dos como Ti pos os objetos de
Da dos (XObjects ).
A edio do objeto grfico pode ser feita da mesma forma como feita a edio de
uma Tela, possuindo os mesmos recursos grficos e opes.
Pode-se inserir os XControls em qualquer Tela, ou ainda dentro de outro XControl
clicando com o boto direito do mouse na Tela ou XControl de destino,
selecionando a opo Inserir, como mostrado a seguir. A partir de um XControl em
desenvolvimento (dentro da biblioteca), possvel inserir outro XControl dentro
Bibliotecas
266
dele, clicando com o boto direito do mouse no XControl de destino e selecionando

a opo Inserir.
Inserindo um XControl na Tela
A partir deste momento, o XControl tem um nome dentro da Tela, e entendido

como uma cpia da definio original. Assim, deve-se definir (se necessrio) os
valores ou as Associaes que esta cpia especfica tem no contexto que est sendo
utilizada. Se o tamanho deste objeto for alterado na view de Design da Biblioteca e
registrado novamente, necessrio usar a opo Tamanho Original no seu menu
contextual da Tela para que a alterao aparea.
Se for criado um objeto Bomba, por exemplo, que possui uma propriedade Estado,
que recebe uma informao externa revelando se a bomba est ligada ou
desligada, fazendo com que ela mude sua cor. Ao inserir este objeto na Tela, o E3
automaticamente renomeia o objeto para "Bomba1".
Pode-se manter este nome ou renome-lo para outro que se desejar. Depois, deve
ser informada qual varivel vai ser associada propriedade Estado. Suponha que
certo Tag de Comunicao representa o estado desta bomba. Logo, deve ser criada
uma Associao entre a propriedade Estado e o referido Tag. O mesmo trabalho
deve ser executado para outras instncias (cpias) do objeto Bomba que se fizerem
necessrias no projeto.
9.2.2 XObjects
Alm dos Objetos grficos XControls, pode-se criar uma biblioteca de dados,
denominada XObject. Com ela, pode-se definir uma estrutura de dados, que
267
Bibliotecas
executada no servidor. Tal estrutura pode realizar clculos, Associaes,

comunicaes, verificao de alarmes, registro histrico, etc., que independam de
que alguma interface grfica (Viewer) esteja aberta ou sendo executada naquele
momento. Para criar um XObject, clique com o boto direito do mouse no item
Bibliotecas de Objetos - XObjects no modo Domnio, selecione a opo Inserir
XObject em e logo aps o nome da biblioteca desejada.
XObjects
Ao inserir um XObject, aberta a view deste objeto, onde podem ser inseridas
variveis. Estas variveis so as propriedades a serem exportadas pelo objeto, que
podem ser associadas a um Tag ou outra propriedade qualquer de uma aplicao
quando o objeto estiver sendo usado em uma aplicao.
As variveis a serem exportadas podem ser inseridas pressionando-se a tecla
INSERT do teclado ou clicando em e excludas atravs da tecla DELETE ou
clicando em . As opes disponveis neste item esto descritas na tabela a
seguir.
Opes disponveis na view dos XObjects
OPO
Nome
Bibliotecas
DESCRIO
Determi na o nome da va ri vel do XObject.
268
OPO
Tipo
Valor
Texto de ajuda
DESCRIO
Determi na o ti po de da do s uporta do pel a
va ri vel . Note que outros objetos de
Da dos (XObjects ) podem s er decl a ra dos
como Ti pos . Des ta forma , pode-s e cri a r um
objeto de da dos que pos s ui como
propri eda de outro objeto de da dos . Os
objetos de da dos podem funci ona r nes te
ca s o como uma es trutura ou cl a s s e, como
uti l i za do na s l i ngua gens C/C++. Qua ndo
for es peci fi ca do um ti po de objeto (por
exempl o DemoTa g, IOTa g, XObject, etc.),
es ta propri eda de tem o s egui nte
comporta mento:
Caso o ElipseX esteja inativo: A
propri eda de funci ona como uma String,
que es peci fi ca o ca mi nho da i ns t nci a
de um objeto do ti po confi gura do
Caso o ElipseX esteja ativo: Na es cri ta , a
propri eda de funci ona da mes ma
ma nei ra de qua ndo o objeto es t
des a ti va do. Porm, na l ei tura a
propri eda de retorna o objeto
es peci fi ca do, ca s o el e exi s ta . Se o
ca mi nho n o a ponta pa ra um objeto
exi s tente no momento, a propri eda de
retorna Nothing
Ha bi l i ta ou des a bi l i ta a vi s i bi l i da de da
va ri vel fora da bi bl i oteca , i s to ,
determi na s e a va ri vel ou n o pbl i ca .
Determi na s e a va ri vel s a l va no projeto
ou n o.
Determi na s e a propri eda de retenti va ou
n o.
Determi na o va l or i ni ci a l da va ri vel .
Texto de decl a ra o e documenta o da
va ri vel .
Apenas propriedades de tipos simples (Variant, String, Date, Double, etc.) podem ser
retentivas (a view desmarca automaticamente a coluna
se o tipo de uma
propriedade for alterado para um tipo de objeto), e apenas propriedades de
XObjects podem ser retentivas.
269
Bibliotecas
NOTA: O us o de propri eda des retenti va s nos El i ps eX pode a umenta r o tempo de

i nci o do a pl i ca ti vo, e ta mbm a umenta r o cons umo de memri a pel o proces s o
E3Run. Os tempos va ri a m dependendo do nmero de i ns t nci a s de XObjects ,
nmero de propri eda des retenti va s em ca da XObject e a qua nti da de des ta s
propri eda des que pos s uem o s eu va l or a l tera do (s e a propri eda de nunca
a l tera da , o va l or retenti vo del a perma nece zera do).
Podem ser inseridos em um XObject quaisquer mdulos do E3 que sejam

executados no servidor, a saber:
Driver de Comunicao e Driver de Comunicao OPC
Servidor de alarmes e alarmes
Servidor de Banco de Dados
Frmulas
Servidor de Dados
Histricos
Isto permite que se possa definir como uma biblioteca um sistema complexo de
gerenciamento, que pode ser facilmente replicado quantas vezes forem necessrias
em um aplicativo.
IMPORTANTE: Veja que ta nto os XControl s qua nto os XObjects s podem s e
rel a ci ona r com o mundo externo a tra vs da s propri eda des (ou a i nda a tra vs do
mous e e tecl a do, no ca s o dos XControl s ). Is to s i gni fi ca que n o s e pode a ces s a r
da dos i nternos de um XObject ou XControl s en o de dentro do prpri o objeto.
Pode-se inserir XObjects em qualquer Servidor de Dados, clicando com o boto

direito do mouse no Servidor de Dados no modo Domnio, selecionado a opo
Inserir e logo aps o nome do XObject desejado, conforme mostrado na figura a
seguir. No modo Explorer, clique com o boto direito do mouse no Servidor de
Dados do projeto, selecione a opo Inserir e logo aps o nome do XObject
desejado.
Bibliotecas
270
Inserindo um XObject no modo Domnio
Note que mesmo se os arquivos de biblioteca possurem vrios XControls e

XObjects, ao tentar inserir uma instncia (cpia), o E3 Studio exibe para as Telas
somente os XControls, e para os Servidores de Dados somente os XObjects
disponveis.
NOTA: Deve-s e cui da r pa ra n o a pa ga r uma propri eda de de um XControl ou XObject
que pos s ua uma As s oci a o. Es ta s propri eda des , uma vez a pa ga da s , n o a pa recem
ma i s na l i s ta de propri eda des do objeto, e por i s s o n o podem s er edi ta da s .
Qua ndo for executa da a opera o Verificar Domnio, executa da uma procura por
es ta s propri eda des e o us u ri o cons ul ta do s e des eja remover es ta As s oci a o ou
n o.
271
Bibliotecas
Propriedade invlida
Pode-se optar por no remover e ento criar novamente o objeto que foi apagado
com a propriedade que se deseja editar, remover apenas a propriedade que est
sendo mostrada, remover todas as propriedades ou no remover nenhuma
propriedade.
9.3 Quando Criar um ElipseX

O uso de Bibliotecas altamente recomendvel devido ao ganho de produtividade
que trazem. Algumas das vantagens dos ElipseX so:
Reutilizao de cdigo
Minimizao de testes durante o desenvolvimento
Criao de interface padro para os objetos desenvolvidos
Diminuio do tempo de desenvolvimento de novos projetos
Proteo do contedo do projeto
Logo, o uso de biblioteca recomendado para a maioria das aplicaes. Entretanto,
existem alguns critrios para indicar a necessidade da construo de objetos no
E3:
Repetio no uso: Se um mesmo equipamento ou processo usado mais de
uma vez no mesmo projeto
Procedimentos do conhecimento do usurio: Frequentemente, um processo
criado por determinada empresa deve ser protegido de cpia ou alterao.
Isto 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
Bibliotecas
272
NOTA: Pa ra exempl os de cri a o de El i ps eX e ma i ores i nforma es s obre es tes

objetos , cons ul te o Manual de Referncia de Scripts.
273
Bibliotecas
CAPTULO
10
ActiveX
Os objetos ActiveX so componentes de software baseados na tecnologia COM

(Component Object Model) que podem ser inseridos em uma aplicao para realizar
diversas tarefas. Estes objetos so desenvolvidos em ambientes de programao
tais como C/C++, Delphi e Visual Basic, entre outros.
Alguns objetos ActiveX so automaticamente registrados quando o E3 instalado:
E3Alarm, E3Browser e E3Chart (desenvolvidos pela Elipse Software), Microsoft
Forms (desenvolvidos pela Microsoft) e Relatrio (ActiveReports, desenvolvido pela
Data Dynamics). Os objetos E3Alarm, E3Browser, E3Chart e Relatrio possuem
captulos especficos mais adiante neste Manual. Os objetos Microsoft Forms so
descritos em outro tpico deste captulo.
NOTA: Pa ra objetos Acti veX n o i ns ta l a dos previ a mente pel o E3, neces s ri o que
es tes objetos s eja m i ns ta l a dos em todos os computa dores onde a a pl i ca o va i
roda r, es peci a l mente em Vi ewers Remotos .
Alm destes, pode-se inserir qualquer outro objeto ActiveX. Para registrar um
objeto ActiveX no E3, siga estes procedimentos:
1. Selecione o menu Ferramentas - Gerenciar ActiveX. A janela da figura a seguir
mostrada.
Janela Gerenciar Controles ActiveX
ActiveX
274
As opes da janela Gerenciar Controles ActiveX esto descritas na tabela a seguir.

Opes da janela Gerenciar Controles ActiveX
OPO
Controles registrados no Windows
Controles registrados no E3
Registrar
Remover
Procurar
Atualizar
Fechar
DESCRIO
Li s ta gem com todos os control es Acti veX
regi s tra dos no Wi ndows e que podem s er
a di ci ona dos a o E3.
Li s ta gem com todos os control es Acti veX j
regi s tra dos no E3.
Regi s tra o control e s el eci ona do no E3.
Ca s o o control e s eja i ncompa tvel com o
E3, uma ca i xa de di l ogo mos tra da
a vi s a ndo o us u ri o a res pei to da
i ncompa ti bi l i da de.
Remove o control e s el eci ona do da l i s ta
Controles registrados no E3, movendo-o de
vol ta pa ra a l i s ta Controles registrados no
Windows. Os control es com o cone
n o
podem s er removi dos , s omente os que
ti verem o cone
.
Abre uma ca i xa de di l ogo pa ra l oca l i za r
um a rqui vo Acti veX.
Permi te a tua l i za r os control es Acti veX na
l i s ta gem Controles registrados no Windows
que tenha m s i do regi s tra dos a ps a
a bertura da ja nel a de gerenci a mento.
Fecha a ja nel a de gerenci a mento dos
Acti veX.
2. Clique em Procurar para abrir uma caixa de dilogo e localizar o arquivo que
contm o ActiveX.
275
ActiveX
Localizao do arquivo ActiveX
3. Selecione o arquivo desejado e clique em Abrir.

Os objetos ActiveX podem ser de dois tipos: Grficos (utilizados nas Telas da
aplicao) e No-Grficos (realizam algum tipo de manipulao de dados).
Os objetos grficos podem ser inseridos na aplicao de trs formas diferentes:
Atravs da barra de ferramentas Objetos, selecionando o objeto desejado
Atravs do clique com o boto direito do mouse no objeto Tela, no Organizer,
selecionando a opo Inserir
Atravs do clique com o boto direito do mouse na Tela, selecionando a
opo Inserir
ActiveX
276
Inserindo um objeto grfico na Tela
Os objetos no-grficos podem ser usados na aplicao atravs de scripts e so

criados pelo mtodo CreateObject, padro do VBScript.
10.1 Objetos Microsoft Forms

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

Indica se uma determinada opo est selecionada ou no, ou ainda se est
parcialmente selecionada. Permite selees mltiplas em um grupo. inserido na
Tela ao selecionar o cone .
277
ActiveX
10.1.2 Boto de Opo

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

Combina as funcionalidades de uma Lista e de um Editor de Texto: neste objeto,
pode-se tanto digitar um valor diretamente ou selecionar um item de uma lista prestabelecida. inserido na Tela ao selecionar o cone .
10.1.4 Boto de Comando

Usado para executar aes especficas quando pressionado, tais como abrir uma
janela, imprimir um relatrio, etc. inserido na Tela ao selecionar o cone .
10.1.5 Texto
Exibe mensagens de texto que no podem ser editadas pelo usurio, como
descries de controles ou legendas. inserido na Tela ao selecionar o cone
10.1.6 Lista
Exibe uma lista de itens dentre os quais o usurio pode escolher um ou mais.
inserido na Tela ao selecionar o cone .
10.1.7 Barra de Rolagem

Facilita a navegao atravs de uma longa lista de itens ou de uma grande
quantidade de informao tanto horizontalmente quanto verticalmente. inserido
na Tela ao selecionar o cone .
10.1.8 Boto de Incremento e Decremento

Usado para incrementar ou decrementar valores atravs de seu par de setas.
inserido na Tela ao selecionar o cone .
10.1.9 Editor de Texto

Possibilita ao usurio inserir e editar textos. inserido na Tela ao selecionar o
cone .
ActiveX
278
10.1.10 Boto Liga e Desliga

Permite atribuir um de dois estados a um outro objeto de Tela. inserido na Tela ao
selecionar o cone .
10.2 Elipse KeyPad

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

OPO
Mostrar quando um SetPoint recebe o foco
Esconder ao pressionar ENTER
Esconder ao pressionar ESC
DESCRIO
Es ta op o mos tra o El i ps e KeyPa d
s empre que um objeto do ti po SetPoi nt
recebe o foco.
Ha bi l i ta ocul ta r o El i ps e KeyPa d a o
pres s i ona r a tecl a ENTER. Es ta op o
equi va l e propri eda de AutoHideOnEnter
do control e.
Ha bi l i ta ocul ta r o El i ps e KeyPa d a o
pres s i ona r a tecl a ESC. Es ta op o
equi va l e propri eda de AutoHideOnEsc do
control e.
Em scripts, o KeyPad pode ser acionado utilizando-se o mtodo GetKeyPad do

objeto Application. Demais informaes sobre as funcionalidades das
propriedades deste objeto podem ser encontradas no Manual de Referncia de
Scripts, em seu captulo respectivo.
ActiveX
280
CAPTULO
11
Servidor de Dados
Os Servidores de Dados so os objetos responsveis por abrigar a execuo das

variveis do sistema como Tags Internos, Tags Demo, Tags Timer, e instncias de
XObjects. Para utilizar este recurso, siga este procedimento:
1. Clique com o boto direito do mouse no projeto no Organizer e selecione a
opo Inserir - Servidor de Dados.
Inserindo um Servidor de Dados

NOTA: Os objetos do Servi dor de Da dos (Pa s ta de Da dos , Ta g Conta dor, Ta g Demo,
Ta g Interno e Ta g Ti mer) podem s er confi gura dos pa ra funci ona rem como reas de
Alarme.
11.1 Pasta de Dados

A Pasta de Dados define grupos, de forma a organizar as variveis. Caso haja
necessidade, novas Pastas podem ser inseridas dentro de outras. Para utilizar este
recurso, siga este procedimento:
281
Servidor de Dados

Inserir - Panel - Pasta de Dados.
Inserindo uma Pasta de Dados
11.2 Tag Contador

O Tag Contador um objeto que realiza a contagem de tempo (em segundos) at
atingir um valor predeterminado, ou que realiza uma certa contagem
indefinidamente. Para utilizar este recurso, siga estes procedimentos:
Inserir - Panel - Tag Contador.
Servidor de Dados
282
Inserindo um Tag Contador
2. O Studio abre uma janela perguntando quantos Tags devem ser criados no
servidor, e qual seu nome. Este nome auto-incrementado e, se a opo for
deixada em branco, os Tags so criados com o nome padro.
Inserindo Tags Contador
As propriedades do Tag Contador podem ser configuradas atravs da Lista de

devidos ajustes.
283
Servidor de Dados
11.3 Tag Demo

O Tag Demo um objeto que gera valores de acordo com a forma de onda, e
utilizado para simulao de valores. Permite gerar ondas definidas ou valores
aleatrios. Para utilizar este recurso, siga estes procedimentos:
Inserir - Panel - Tag Demo.
Inserindo um Tag Demo
Servidor de Dados
284
Inserindo Tags Demo
As propriedades do Tag Demo podem ser configuradas atravs da Lista de

devidos ajustes.
11.4 Tag Interno

O Tag Interno um objeto de propsito genrico, utilizado para guardar valores de
qualquer tipo, incluindo nmeros, textos e at outros objetos. Para utilizar este
Inserir - Panel - Tag Interno.
285
Servidor de Dados
Inserindo um Tag Interno
Inserindo Tags Internos
As propriedades do Tag Interno podem ser configuradas atravs da Lista de

devidos ajustes.
Servidor de Dados
286
11.5 Tag Timer

O Tag Timer um objeto para contagem de tempo e agendamento de atividades. Ele
estabelece horrios (com repeties) para executar aes. Para utilizar este objeto,
Inserir - Panel - Tag Timer.
Inserindo um Tag Timer
287
Servidor de Dados
Inserindo Tags Timer
As propriedades do Tag Timer podem ser configuradas atravs da Lista de

devidos ajustes.
Servidor de Dados
288
CAPTULO
12
Banco de Dados
O Banco de Dados do E3 utilizado para armazenar as informaes do projeto

referentes a Histricos, Frmulas, Alarmes e Storage. Suporta os formatos Access
(.mdb), Oracle e Microsoft SQL Server.
Para utilizar este recurso, clique com o boto direito do mouse no nome do projeto
no Explorer e selecione a opo Inserir - Banco de Dados. No modo Domnio, clique
com o boto direito do mouse no item Objetos de Servidor - Banco de Dados,
selecione a opo Inserir - Banco de Dados em e logo aps o nome do projeto
desejado.
Inserindo um Banco de Dados no modo Domnio
Ao inserir o Banco de Dados na aplicao, 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.
289
Banco de Dados
Algumas das propriedades deste objeto podem ser configuradas atravs da Lista de
Propriedades, sem a necessidade da criao de scripts para isto. Para isto,
localize-as e efetue os devidos ajustes. Demais informaes sobre as
funcionalidades das propriedades deste objeto podem ser encontradas no Manual
de Referncia de Scripts, em seu captulo respectivo.
NOTA: O objeto Ba nco de Da dos pode s er confi gura do pa ra funci ona r como rea de
Alarme.
12.1 Access
Gera uma base de dados no formato MDB (Microsoft Access Database), padro para
banco de dados no E3. Para utilizar este recurso, siga estes procedimentos:
selecione a opo Inserir - Banco de Dados. No modo Domnio, clique com o
boto direito do mouse no item Objetos de Servidor - Banco de Dados, selecione
a opo Inserir Banco de Dados em e logo aps o nome do projeto desejado. O
objeto criado no projeto, e sua janela de edio de scripts aberta.
2. Para configur-lo, selecione a aba Configuraes da Janela de Propriedades.
Banco de Dados
290
Configuraes para Banco de Dados Access

OPO
Banco de Dados
Arquivo MDB
291
DESCRIO
Sel eci ona o ti po de Ba nco de Da dos em
us o no projeto: 0 - stAccess, 1 - stOracle ou
2 - stSqlServer.
Nome do a rqui vo .mdb uti l i za do no
projeto. NOTA: Es te ca mpo a cei ta ta nto
um ca mi nho a bs ol uto qua nto um
ca mi nho rel a ti vo pa s ta do Domni o
a tua l . O ca mi nho compl eto deve exi s ti r
pa ra que o a rqui vo .mdb s eja cri a do ou
encontra do correta mente.
Banco de Dados
OPO
Senha do BD
Usurio
Senha
Testar conexo
DESCRIO
Senha do Ba nco de Da dos Acces s .
Us u ri o do Ba nco de Da dos conecta do
pel o E3.
Senha do us u ri o que rea l i za o l ogon.
Tes ta a conex o com o Ba nco de Da dos .
3. No campo Banco de Dados, selecione o item 0 - stAccess.

4. Insira o nome do arquivo desejado (existente ou no) no campo Arquivo MDB
(conforme figura anterior).
5. Caso seja necessrio, configure as opes Usurio, Senha e Senha do BD de
acordo com as definies do Access. Tais itens podem ficar em branco e, neste
caso, a aplicao assume as configuraes padro do E3.
6. Clique em OK para finalizar as configuraes.
12.2 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 executado o E3
Server. Nesta instalao devem estar presentes, obrigatoriamente, o suporte a OCI
(Oracle Call Interface) e o OLEDB Provider para Oracle, necessrios para a
comunicao do E3 com o Oracle. Para instalar o Oracle, consulte a documentao
prpria do produto.
O acesso ao banco de dados Oracle pode ser feito de duas maneiras: acessando o
Banco de Dados Oracle de dentro do E3 ou via scripts. A seguir so explicados cada
um destes procedimentos.
12.2.1 Acessando o Oracle via E3

Para inserir um novo Banco de Dados Oracle, siga estes procedimentos:
selecione a opo Inserir - Banco de Dados. No modo Domnio, clique com o
boto direito do mouse no item Objetos de Servidor - Banco de Dados, selecione
a opo Inserir Banco de Dados em e logo aps o nome do projeto desejado. O
objeto criado no projeto, e sua janela de edio de scripts aberta.
2. Para configur-lo, selecione a aba Configurao na Janela de Propriedades.
Banco de Dados
292
Configuraes para Banco de Dados Oracle

OPO
Banco de Dados
Conexo
293
DESCRIO
us o no projeto: 0 - stAccess, 1 - stOracle ou
2 - stSqlServer.
Nome da conex o forneci do pel o
a dmi ni s tra dor do ba nco de da dos .
Banco de Dados
OPO
Usar tipo TIMESTAMP
Usar drivers ADO Oracle
Usurio
Senha
Testar conexo
DESCRIO
Permi te uti l i za r o ti po de da dos
TIMESTAMP do Ora cl e, com preci s o de
mi l i s s egundos e di s ponvel a pa rti r da
vers o 9.0. Ca s o es ta op o es teja
des a bi l i ta da , us a do o ti po de da dos
DATE, com preci s o de s egundos . NOTA:
Pa ra que o objeto Cons ul ta do E3 s eja
compa tvel com ta bel a s que uti l i zem o
ti po de da dos TIMESTAMP, deve s er
ha bi l i ta da a op o Usar drivers ADO
Oracle.
Permi te us a r a s i nterfa ces ADO (ActiveX
Data Objects) do Ora cl e pa ra que o objeto
Cons ul ta do E3 reconhea o ti po de
da dos TIMESTAMP. As s i m pos s vel l er
regi s tros de ta bel a s do Ora cl e que
pos s ua m preci s o de mi l i s s egundos .
Us u ri o do Ba nco de Da dos conecta do
pel o E3.
3. No campo Banco de Dados, selecione o item 1 - stOracle.

4. Se o servidor Oracle for local, o campo Conexo pode ficar em branco, pois o
E3 recupera os dados automaticamente. Do contrrio, a conexo criada
usando o cliente Oracle instalado na mquina.
5. Caso seja necessrio, configure as opes Usurio e Senha de acordo com as
definies do Oracle. Tais itens podem ficar em branco e, neste caso, a
aplicao assume as configuraes padro do E3.
Ao inserir o Banco de Dados na aplicao, so habilitadas as opes referentes ao
tipo de Servidor de Banco de Dados. O Servidor de Banco de Dados o responsvel
pelo gerenciamento e armazenamento das informaes dos objetos que utilizam
este servio.
12.2.2 Acessando o Oracle via Scripts

Scripts so mdulos de linguagem de programao onde se pode criar linhas de
cdigo, que permitem maior flexibilidade para a associao de aes a eventos
especficos. Cada item de um projeto do E3 possui uma lista de eventos previamente
associados. Assim, o usurio pode criar programas que so executados na
ocorrncia de um evento.
O E3 utiliza o VBScript (Visual Basic Script) em seus scripts, e com ele consegue
Banco de Dados
294
instanciar qualquer objeto ActiveX registrado no sistema. Para o acesso ao Banco

de Dados, o ActiveX mais utilizado o ADO, que pode ser facilmente manipulado
nos scripts do E3.
Primeiramente, necessria a criao de uma conexo ADO que pode ser feita com
o script a seguir:
Set DBConnection = CreateObject("ADODB.Connection")
DBConnection.Open "Provider=MSDAORA;_
DataSource=conexaoOracle;User_
ID=UserID;Password=passwd"
Depois da criao da conexo, possvel executar um comando SQL diretamente na

conexo, como mostrado a seguir:
DBConnection.Execute _
"UPDATE Tabela SET nome = 'Joo' WHERE id = 10"
possvel tambm a visualizao de todos os registros desejados, retornados na

forma de um Recordset (consulta), como mostrado a seguir:
Set Recordset = CreateObject("ADODB.Recordset")
Recordset.Source = "Tabela"
Recordset.ActiveConnection = DbConnection
Recordset.CursorType = 1 ' adOpenKeyset
Recordset.LockType = 3 ' adLockOptimistic
Recordset.Open
A partir deste momento, possvel navegar pela tabela utilizando-se os comandos

MoveNext e MovePrevious, bem como uma srie de outros comandos fornecidos
pelo ADO. possvel tambm utilizar uma consulta SQL para manipular partes
especficas da tabela, atravs da propriedade Source.
12.2.3 Tecnologias Utilizadas pelo E3 para Acessar o

Oracle
O E3 utiliza basicamente duas tecnologias para acessar o Banco de Dados Oracle:
ADO (ActiveX Data Object) e OCI (Oracle Call Interface).
ADO a tecnologia utilizada pelo E3Browser e E3Chart para recuperao dos dados
armazenados no Banco de Dados. O ADO tambm amplamente utilizado nos
scripts do E3 para todo tipo de operao junto ao Banco de Dados. Ele um
conjunto de objetos COM (Component Object Model) criado para acessar
informaes de SGBD usando OLE DB (Object Linking and Embedding). Esta
tecnologia est disponvel quando se instala o OLE DB Provider para Oracle
(MSDAORA) e permite o acesso interface nativa do Oracle, a OCI.
A OCI utilizada pelo Servidor de Banco de Dados do E3 para implementar os
servios de Banco de Dados utilizados pelos Histricos, Frmulas, Alarmes e
Storage. Atravs da OCI se acessa diretamente as funes do Oracle, tornando este
295
Banco de Dados
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 conectada a uma aplicao em tempo de execuo.
12.2.4 Acessando o Oracle via Servidor BD

O Servidor de Banco de Dados do E3 utiliza a OCI (Oracle Call Interface) para se
comunicar com o servidor Oracle, ou seja, utiliza a forma nativa do Banco de
Dados para ganhar em performance na comunicao com o Banco de Dados.
Um bom exemplo de como funciona a comunicao do Servidor de Banco de Dados
do E3 com o Oracle o Histrico. Inicialmente feita a aquisio dos dados pelo
Histrico que, de posse destes dados, imediatamente os envia em forma de
requisies para o Banco de Dados. Estas requisies podem ser para criao de
uma tabela, criao de ndices e chaves, adio de dados, etc. O Servidor de Banco
de Dados do E3 possui um processo separado especialmente para receb-las.
Dependendo do tipo de operao a ser realizada, os dados so formatados e
armazenados em arquivos temporrios ou em memria.
Ao mesmo tempo, o Banco de Dados possui mais um outro processo, responsvel
pela recuperao das aquisies e posterior envio para o banco de dados em
forma de comandos SQL, utilizando a OCI.
Banco de Dados
296
Comunicao do E3 com o Oracle
12.3 SQL Server

Atravs desta opo possvel armazenar dados no Banco de Dados SQL Server.
12.3.1 Acessando o SQL Server via E3

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

OPO
Banco de Dados
Servidor
Banco de Dados
Biblioteca de Rede
Banco de Dados
DESCRIO
us o no projeto: 0 - stAccess, 1 - stOracle ou 2 stSqlServer.
Nome do s ervi dor.
Nome do Ba nco de Da dos .
Bi bl i oteca de rede uti l i za da pel o ADO: 0 Padro, 1 - Named Pipes, 2 - Winsock TCP/IP, 3 SPX/IPX, 4 - Banyan Vines ou 5 - Multi-Protocol
(RCP).
298
OPO
Alterar string de conexo
Usurio
Senha
Testar conexo
DESCRIO
Es ta ca i xa de s el e o permi te modi fi ca r a
String de conex o a um ba nco de da dos SQL
Server. As s egui ntes res tri es s e a pl i ca m a
es ta op o:
As a l tera es fei ta s NO SO va l i da da s
pel o E3. Porta nto, de i ntei ra
res pons a bi l i da de do us u ri o a correta
confi gura o da String cus tomi za da .
Se es ta ca i xa de s el e o es ti ver
des ma rca da , o E3 uti l i za o forma to
pa dr o pa ra rea l i za r a conex o.
A String de conex o a cei ta dua s ma cros :
{SERVER}, que s ubs ti tuda pel o nome
do s ervi dor confi gura do em Servidor e
{DB}, que s ubs ti tuda pel o nome do
ba nco de da dos confi gura do em Banco de
Dados.
Us u ri o do Ba nco de Da dos conecta do pel o
E3. Dependendo do ti po de objeto a s er
uti l i za do no projeto, deve ter di ferentes
ti pos de permi s s o.
3. No campo Banco de Dados, selecione o item 2 - stSqlServer.

4. Caso seja necessrio, configure as opes Usurio e Senha de acordo com as
definies do SQL Server. Tais itens podem ficar em branco e, neste caso, a
aplicao assume as configuraes padro do E3.
12.3.2 Exemplo de Utilizao do SQL Server 2000

Para ilustrar o acesso ao SQL Server 2000, faremos a criao de um Histrico
registrando dados por tempo de varredura de um segundo. Os procedimentos so
mostrados a seguir.
1. Crie um Tag Demo. As configuraes deste Tag no necessitam ser alteradas.
2. Clique duas vezes no Servidor de Banco de Dados para abrir a janela de
configurao do Servidor SQL. Os parmetros devem ser alterados para se
adequarem s configuraes disponveis na instalao do SQL Server.
3. Execute as configuraes necessrias nesta janela, tais como nome do
servidor, usurio, senha e Banco de Dados.
4. Aps executar a configurao do Banco de Dados, deve-se configurar o
Histrico que acessa este banco de dados. Para tanto, primeiramente deve-se
299
Banco de Dados
criar um campo no Histrico e inserir o Tag Demo, que utilizado para o envio
de diferentes valores ao Banco de Dados.
Histrico e suas configuraes
5. Abra a janela de propriedades do Histrico clicando em

Propriedades do
Histrico e determine o servidor de Banco de Dados e o nome da tabela. As
demais configuraes devem permanecer inalteradas. A tabela serve para a
busca de dados no E3 e tambm para visualizar o uso da ferramenta SQL Server
Analyzer, que o cliente usado para consultas no SQL Server.
6. Finalizada a configurao do Histrico, necessria a criao da estrutura de
tabelas no Servidor de Banco de Dados. Para isto, clique em
Gerar estrutura
no BD. Uma mensagem de confirmao da criao da estrutura de tabelas
mostrada na tela. Caso haja algum erro, deve-se localizar o problema.
7. Para visualizar o Histrico em ao (salvando dados no servidor SQL Server),
crie uma Tela, insira um E3Browser e configure-o para acessar o Servidor de
Banco de Dados, como explicado anteriormente no Histrico, e configure o
E3Browser para ser atualizado automaticamente a cada 10 segundos, por
exemplo.
8. Aps as configuraes, execute o projeto. Depois de algum tempo, o E3Browser
passa a exibir os dados que esto sendo enviados ao servidor.
9. possvel consolidar os dados que so mostrados no E3 e os que esto salvos
no servidor utilizando o objeto Consulta do E3Browser e o software SQL Query
Analyzer. Para isto, crie diferentes consultas no Banco de Dados e edite-as na
Consulta e tambm no Query Analyzer. Os resultados devem ser os mesmos, se
o Domnio estiver parado, ou semelhantes, se o Domnio estiver rodando. Esta
diferena deve-se atualizao constante do Banco de Dados quando o
Domnio est sendo executado. Para a edio de consultas no objeto Consulta,
habilite a opo Habilita edio direta do SQL.
Banco de Dados
300
12.3.3 Uso de ADODB para Acesso via Script

Para acesso ao SQL Server atravs de scripts, usa-se uma conexo ADODB. A String
de conexo a este tipo de Banco de Dados deve ser configurada conforme o modelo
a seguir:
DRIVER={SQL Server};SERVER=server;UID=login_id;PWD=password;
O uso deste tipo de acesso deve ser restrito a casos onde no exista outra soluo.
O E3 disponibiliza recursos que visam minimizar o uso destes acessos via script.
Entretanto, eventualmente o uso deste recurso pode ser necessrio.
12.4 Objetos do E3 e Permisses

necessrio configurar as permisses no Banco de Dados para a utilizao dos
objetos do E3 em um projeto. Estas permisses esto listadas na tabela a seguir.
Opes disponveis para permisses
OBJETO
Frmulas
Histrico de usurio
Histrico
Servidor de Alarmes
PERMISSES
Permi s s o compl eta
Es creve e cons ul ta a s ta bel a s exi s tentes
Nas permisses, a expresso Permisso completa significa que o usurio tem

permisses para:
Criar ou remover tabelas existentes
Criar ndices e chaves
Inserir e excluir dados nas tabelas criadas
Realizar consultas sobre as tabelas resultantes
O usurio no precisa ser um Administrador para possuir Permisso completa em
qualquer objeto.
301
Banco de Dados
CAPTULO
13
Alarmes
O E3 dispe de um conjunto de objetos que permite ao usurio monitorar alarmes

em uma aplicao. Com eles, possvel especificar e gerenciar alarmes e eventos
de variveis de um processo. As condies de alarme podem ser gerenciadas em
diversas fontes. O sistema composto de um objeto centralizador de alarmes,
chamado Servidor de Alarmes, e de um ou mais objetos de configurao, chamado
Configurao de Alarmes. As sees a seguir detalham estes objetos.
13.1 Configurao de Alarmes

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

As reas de Alarme permitem agrupar um conjunto de Fontes de Alarmes, bem
como outras reas. Isto facilita o gerenciamento, a operao e o monitoramento de
um conjunto de Fontes de Alarme relacionadas, como por exemplo:
Filtrar o conjunto de alarmes visveis no sumrio
Habilitar ou desabilitar um conjunto de Fontes de Alarmes
Reconhecer um conjunto de Fontes de Alarmes
Verificar o total de alarmes ativos ou no reconhecidos de um conjunto de
Fontes de Alarmes
Caso haja necessidade, novas reas podem ser inseridas dentro de outras. Para
inserir este objeto, siga este procedimento:
1. Clique com o boto direito do mouse no objeto Configurao de Alarmes ou no
objeto rea do projeto no modo Explorer e selecione a opo Inserir - rea. No
modo Domnio, clique com o boto direito do mouse no objeto Configurao de
303
Alarmes
Alarmes e selecione o item Inserir - rea.
Inserindo uma rea de Alarme
devidos ajustes. Demais informaes sobre as funcionalidades das propriedades
deste objeto podem ser encontradas no Manual de Referncia de Scripts, em seu
captulo respectivo.
13.1.1.1 Objetos de Servidor como reas de Alarme

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

Opes disponveis na aba rea de Alarmes
OPO
Funcionar como rea de alarmes
Verificar alarmes
Campos do usurio
DESCRIO
Ha bi l i ta ou des a bi l i ta o comporta mento
de rea de Al a rme pa ra o objeto de
Servi dor. Es ta op o corres ponde
propri eda de IsAlarmArea.
Ha bi l i ta ou des a bi l i ta a veri fi ca o de
a l a rmes no objeto. Es ta op o
corres ponde propri eda de AlarmVerify.
Veja o tpi co Configuraes dos Campos do
Usurio pa ra ma i ores i nforma es .
As seguintes propriedades ficam disponveis no objeto de Servidor:

ActiveAlarms
ActiveHighAlarms
ActiveHighNACKAlarms
ActiveLowAlarms
305
Alarmes
ActiveLowNACKAlarms
ActiveMedAlarms
ActiveMedNACKAlarms
ActiveNACKAlarms
Alarm
AlarmVerify
UserFields
13.2 Servidor de Alarmes

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

Para especificar as configuraes do Servidor de Alarmes, clique com o boto
direito do mouse no objeto e selecione a opo Propriedades.
Na aba Configurao, possvel especificar as configuraes de Banco de Dados e
determinar campos para a gerao da tabela de alarmes.
307
Alarmes
Configuraes do Servidor de Alarmes
Cada campo da aba Configurao possui uma propriedade correspondente. As

OPO
Guarde alarmes no Banco de Dados
Utilize o servidor de banco de dados
Nome da Tabela
Alarmes
DESCRIO
Ha bi l i ta ou des a bi l i ta o a rma zena mento
dos da dos dos a l a rmes no Ba nco de
Da dos . Es te ca mpo equi va l e
propri eda de Logging.
Defi ne o s ervi dor de Ba nco de Da dos que
a rma zena os da dos do a l a rme. Es te
DataSource.
Defi ne o nome da ta bel a de a l a rmes .
TableName.
308
OPO
Descarta dados da tabela principal
Mantenha os dados do(s) ltimo(s) ... <

Tabela Principal >
A verificao deve ocorrer a cada
Dados descartados devem ser armazenados
Mantenha os dados do(s) ltimo(s) ... <

Tabela de Backup >
Campos
Gerar Tabela
DESCRIO
Ha bi l i ta ou des a bi l i ta o des ca rte de
da dos da ta bel a pri nci pa l . O da do
cons i dera do a nti go de a cordo com o que
for defi ni do na op o Mantenha os dados
do(s) ltimo(s). Es te ca mpo equi va l ente
propri eda de EnableDiscard.
Determi na o i nterva l o de tempo
(mi nutos , hora s , di a s ou mes es ) dura nte
o qua l os da dos s o ma nti dos na ta bel a
pri nci pa l . Se um da do da ta bel a for ma i s
a nti go que o i nterva l o de tempo des ta
op o, el e des ca rta do. Es te ca mpo
equi va l e propri eda de DiscardInterval, e
o ca mpo de s el e o da uni da de de
tempo do i nterva l o equi va l e
propri eda de DiscardTimeUnit.
Fa z a veri fi ca o dos a l a rmes , conforme
o perodo es peci fi ca do no ca mpo (em
mi nutos , hora s , di a s ou mes es ). Es te
VerificationInterval, e o ca mpo de s el e o
da uni da de de tempo do i nterva l o
equi va l e propri eda de VerificationUnit.
dos da dos des ca rta dos na ta bel a
s ecund ri a (ta bel a de backup). Es te
EnableBackupTable.
de backup. Es te i nterva l o deve s er s empre
ma i or que o confi gura do no i tem
Mantenha os dados do(s) ltimo(s) da
Ta bel a Pri nci pa l . Es te ca mpo equi va l e
propri eda de BackupDiscardInterval, e o
ca mpo de s el e o da uni da de de tempo
do i nterva l o equi va l e propri eda de
BackupDiscardTimeUnit.
Determi na qua i s ca mpos dos eventos de
a l a rme s o a di ci ona dos ta bel a de
a l a rmes , e qua l a ordem em que es ta s
col una s a pa recem.
Gera a ta bel a dos a l a rmes no Ba nco de
Da dos es peci fi ca do.
Os campos disponveis no Servidor de Alarmes para gerao da tabela de alarmes

esto descritos na tabela a seguir.
309
Alarmes
Opes disponveis para tabelas dos Campos dos alarmes

OPO
Acked
AckRequired
AckTime
AckTimeDbl
ActorID
AlarmSourceName
Area
ChangeMask
ConditionActive
Alarmes
DESCRIO
Informa s e o a l a rme foi reconheci do ou
n o. Es te ca mpo pode a s s umi r os va l ores 0:
No reconhecido ou 1: Reconhecido.
Determi na o reconheci mento a utom ti co
do a l a rme. Es te ca mpo a pres enta os
va l ores 0: Reconhecimento automtico ou 1:
Reconhecimento manual.
Regi s tra a da ta e hora do E3 no momento
em que o a l a rme reconheci do, ou zero
(30/12/1899), enqua nto o a l a rme n o tenha
s i do reconheci do. No ca s o de a l a rmes que
n o pedem reconheci mento, o ca mpo
a s s ume a da ta e hora do E3 no momento
em que o a l a rme torna -s e a ti vo.
Semel ha nte a o ca mpo a nteri or. us a do
pa ra fa ci l i ta r a gra va o de da dos do ti po
Double no ca s o de ba ncos de da dos Ora cl e
ou SQL Server.
Nome do opera dor que reconheceu o
a l a rme. Pode s er:
O us u ri o l oga do no Vi ewer, qua ndo o
reconheci mento fei to no E3Al a rm (ou
"Sem us u ri o", s e n o h us u ri o
l oga do)
"Sys tem", qua ndo o reconheci mento
a utom ti co (ou s eja , pa ra a l a rmes que
n o pedem reconheci mento)
Um nome pa s s a do por s cri pt (por
exempl o, us a ndo AckArea, AckAllAlarms
ou LogTrackingEvent do Servi dor de
Al a rmes , ou Ack da Fonte de Al a rmes )
O l i mi te des te ca mpo, qua ndo a rma zena do
no Ba nco de Da dos , de 50 ca ra cteres .
Regi s tra o nome da Fonte de Al a rme. O
l i mi te des te ca mpo, qua ndo a rma zena do
Pa ra eventos de a l a rme, o nome da rea
a qua l a Fonte de Al a rmes pertence. Pa ra
outros eventos (por exempl o, us a ndo o
mtodo LogTrackingEvent do Servi dor de
Al a rmes ), pode s er um texto defi ni do pel o
us u ri o. O l i mi te des te ca mpo, qua ndo
a rma zena do no Ba nco de Da dos , de 100
ca ra cteres .
N o us a do (o va l or s empre zero).
Indi ca s e a Fonte de Al a rme es t em
a l a rme. Es te ca mpo a pres enta os es ta dos
0: Condio no ativa ou 1: Condio ativa.
310
OPO
ConditionName
Cookie
CurrentValue
Enabled
EventCategory
311
DESCRIO
Nome da condi o, s e for um evento de
a l a rme. Es te ca mpo pode a pres enta r os
s egui ntes va l ores :
Banda Morta: Fonte de Al a rme do ti po
Ba nda Morta
Digital: Fonte de Al a rme do ti po Di gi ta l
Nvel: Fonte de Al a rme do ti po Ana l gi co
TaxaDeVariao: Fonte de Al a rme do ti po
Ta xa de Va ri a o
Se o evento n o for um a l a rme (por
exempl o, us a ndo o mtodo LogTrackingEvent
do Servi dor de Al a rmes ), es te va l or
s empre uma String va zi a .O l i mi te des te
ca mpo, qua ndo a rma zena do no Ba nco de
Da dos , de 100 ca ra cteres .
Va l or a s s oci a do Fonte de Al a rme, us a do
i nterna mente pel o Servi dor de Al a rmes .
Determi na o va l or da Fonte de Al a rme
(converti do pa ra Double) no momento do
evento. Pa ra outros eventos (por exempl o,
us a ndo o mtodo LogTrackingEvent), o va l or
s empre zero (0). O l i mi te des te ca mpo,
qua ndo a rma zena do no Ba nco de Da dos ,
de 100 ca ra cteres .
Determi na s e a veri fi ca o do a l a rme es t
ha bi l i ta da . Es te ca mpo a pres enta os
es ta dos 0: Verificao da fonte de alarmes
desabilitada ou 1: Verificao da fonte de
alarme desabilitada.
Ca tegori a do evento. Pa ra a l a rmes , es te
ca mpo pode a s s umi r os s egui ntes va l ores :
Banda Morta: Fonte de Al a rme do ti po
Ba nda Morta
Digital: Fonte de Al a rme do ti po Di gi ta l
Nvel: Fonte de Al a rme do ti po Ana l gi co
TaxaDeVariao: Fonte de Al a rme do ti po
Ta xa de Va ri a o
Pa ra outros eventos (por exempl o, us a ndo
o mtodo LogTrackingEvent do Servi dor de
Al a rmes ), o ca mpo pode a s s umi r va l ores
defi ni dos pel o us u ri o. O l i mi te des te
Alarmes
OPO
EventCLSID
EventTime
EventTimeDbl
EventTimeUTC
EventType
FormattedValue
FullAlarmSourceName
InTime
InTimeDbl
Alarmes
DESCRIO
Identi fi ca dor ni co pa ra toda a vi da de um
a l a rme. Qua ndo um a l a rme novo ocorre em
uma Fonte, gera do um novo nmero de
EventCLSID. As s i m, el e ma ntm es te mes mo
CLSID no ba nco de da dos enqua nto n o
s a i r da l i s ta de a l a rmes a ti vos e n o
reconheci dos .
Da ta e hora do va l or da Fonte de Al a rme no
momento do evento.
ou SQL Server.
Da ta e hora do va l or da Fonte de Al a rme no
momento do evento, com rel a o a o
hor ri o de Greenwi ch. O va l or o mes mo
do ca mpo EventTime, s endo ma nti do no E3
por ques tes de compa ti bi l i da de.
Ti po do evento. Pa ra eventos de a l a rme,
s empre Condition. Pa ra outros eventos , pode
s er um texto defi ni do pel o us u ri o, como
por exempl o, us a ndo o mtodo
LogTrackingEvent do Servi dor de Al a rmes
("Tra cki ng", "Si mpl e", etc.). O l i mi te des te
Mos tra o va l or forma ta do da Fonte de
Al a rme que va i pa ra o s eu evento. O l i mi te
des te ca mpo, qua ndo a rma zena do no
Ba nco de Da dos , de 100 ca ra cteres . NOTA:
Es te ca mpo s omente de l ei tura .
Regi s tra o ca mi nho compl eto da Fonte de
Al a rme, i ncl ui ndo rea s , nome da
Confi gura o de Al a rmes e de pos s vei s
Pa s ta s onde es ta pos s a es ta r i ns eri da . Por
exempl o,
Pasta1.ConfigAlarmes1.Area1.FonteAlarme1.
Regi s tra a da ta e hora do va l or, no
momento em que el e entra na condi o de
a l a rme.
ou SQL Server.
312
OPO
Message
OutTime
OutTimeDbl
Quality
Severity
Source
313
DESCRIO
o texto confi gura do na Fonte de Al a rme,
ou es peci fi ca do por um outro evento (por
exempl o, us a ndo o mtodo LogTrackingEvent
do Servi dor de Al a rmes ). O l i mi te des te
Regi s tra a da ta e hora do va l or no
momento em que el e s a i da condi o de
a l a rme, ou zero (30/12/1899) enqua nto o
a l a rme a i nda n o tenha s a do da condi o
a ti va .
ou SQL Server.
Qua l i da de do va l or de Fonte de a l a rme no
momento do evento. Es te ca mpo a s s ume os
s egui ntes va l ores numri cos :
0 - 63: Qua l i da de rui m
64 - 127: Qua l i da de i ncerta
128 - 191: Va l or n o defi ni do
192 - 255: Qua l i da de boa
exempl o, s e el e es ti ver us a ndo o mtodo
LogTrackingEvent do Servi dor de Al a rmes ),
es te ca mpo i gua l a uma String va zi a .
Exempl o: Rui m (0); Incerta (64); ?? (128); Boa
(192).
o va l or de s everi da de confi gura do na
Fonte de Al a rme. Es te ca mpo pode a s s umi r
os va l ores 0: Alta, 1: Mdia ou 2: Baixa. El e
pode ta mbm a s s umi r outro va l or defi ni do
pel o us u ri o s e for um evento, como por
exempl o qua ndo es ti ver us a ndo o mtodo
LogTrackingEvent.
Pa ra eventos de a l a rme, i nforma a
expres s o uti l i za da pa ra a va l i a r a s
condi es de a l a rme. O l i mi te des te
Alarmes
OPO
SubConditionName
Campos do Usurio
DESCRIO
Nome da s ubcondi o, s e for um evento de
a l a rme. Es te ca mpo pode a s s umi r os
s egui ntes va l ores :
BM: Al a rme de Ba nda Morta
DIG: Al a rme Di gi ta l
TV: Al a rme Ta xa de Va ri a o
LOLO: Al a rme Ana l gi co na fa i xa Mui to
Ba i xo
LO: Al a rme Ana l gi co na fa i xa Ba i xo
HI: Al a rme Ana l gi co na fa i xa Al to
HIHI: Al a rme Ana l gi co na fa i xa Mui to
Al to
exempl o, s e el e es ti ver us a ndo o mtodo
LogTrackingEvent do Servi dor de Al a rmes ),
es te ca mpo i gua l a uma String va zi a . O
l i mi te des te ca mpo, qua ndo a rma zena do
S o os ca mpos defi ni dos pel o us u ri o.
Es tes ca mpos s o confi gura dos na a ba
Campos do usurio, no Servi dor de Al a rmes .
NOTAS:
neces s ri o que ha ja um Servi dor de Al a rmes no Domni o, pa ra que s eja
pos s vel o moni tora mento de a l a rmes
Os ca mpos EventTimeMS, InTimeMS, OutTimeMS e AckTimeMS contm os va l ores em
mi l i s s egundos dos ca mpos EventTime, InTime, OutTime e
AckTime,
res pecti va mente. Es tes ca mpos s o us a dos qua ndo for neces s ri o regi s tra r o
tempo (em ms ) dos eventos em um s ervi dor de ba ncos de da dos Ora cl e. Obs erve
que es tes ca mpos n o es t o di s ponvei s no E3Al a rm, poi s nes te objeto
pos s vel vi s ua l i za r os mi l i s s egundos a tra vs da forma ta o da s col una s de Da ta
e Hora
Depois de definidas todas as configuraes, o sistema inicializa a insero e

gravao das informaes na tabela dos alarmes, conforme as especificaes dos
campos. Ao clicar em Gerar tabela, o sistema gera a tabela de dados dos alarmes
conforme as especificaes, e informa se a tabela foi gerada com sucesso.
Alarmes
314
Mensagem do Servidor de Alarmes
A estrutura da tabela dos alarmes semelhante do Histrico: composta por uma

tabela de definies, uma tabela principal de dados e uma tabela de backup
(opcional).
Tabela Fields
Os campos gerados na tabela so explicados no tpico Configuraes da Tabela do

captulo Histrico.
Atravs da janela de configurao do Servidor de Alarmes, pode-se especificar o
Servidor de Banco de Dados utilizado para a gravao dos alarmes. O Servidor de
Banco de Dados (objeto DBServer) um mdulo do E3 que deve ser inserido na
aplicao.
315
Alarmes
13.2.2 Configuraes dos Campos do Usurio

Na aba Campos do usurio pode-se adicionar valores arbitrrios aos eventos de
alarmes.
Aba Campos do usurio

Opes disponveis na aba Campos do usurio
OPO
Nome
Tipo
Tamanho
Fonte
Propagar?
Alarmes
DESCRIO
Determi na o nome do Ca mpo.
Determi na o ti po do Ca mpo (0: String, 1:
Integer, 2: Double ou 3: DateTime).
Determi na o ta ma nho do Ca mpo.
Determi na a fonte de da dos do Al a rme.
Fora a a tua l i za o i medi a ta de todos
os a l a rmes que herda m o va l or des te
Ca mpo do Us u ri o, s empre que es te
receber um va l or fora do ou s e a
As s oci a o for a l tera da .
Adi ci ona um Ca mpo do Us u ri o a o fi na l
da l i s ta gem.
Remove o l ti mo Ca mpo do Us u ri o da
l i s ta gem.
316
Campos do Usurio s podem ser includos ou excludos ao final da listagem. A

excluso de Campos de Usurio nesta listagem se reflete em todas as reas e
Fontes de Alarmes relacionadas a este Servidor de Alarmes, mas apenas se os
Campos removidos no tenham sido configurados com um valor forado ou uma
Associao. Do contrrio, estes Campos continuam aparecendo nas reas e Fontes
de Alarme. A figura a seguir mostra um Alarme Analgico com os Campos do
Usurio herdados do Servidor de Alarmes.
Campos do Usurio herdados

NOTA: Pa ra ma i ores i nforma es s obre o comporta mento de um Ca mpo do Us u ri o
de rea s e Fontes de Al a rme, ta nto em Studi o qua nto em tempo de execu o,
veri fi que a s propri eda des Link, Value e ValueSource no Manual de Scripts.
13.3 Fontes de Alarme

Todas as informaes relativas s condies de alarme so definidas nas Fontes
de Alarmes, bem como os tipos de eventos que devem ser gerados em cada
condio. As Fontes de Alarme sempre contm uma expresso de alarme (fonte de
dados), cujo valor pode ser verificado de acordo com as diversas condies
disponveis. Estas fontes so Alarme Analgico, Banda Morta, Digital, Taxa de
Variao e Discreto.
NOTA: O objeto Fonte de Al a rme pode s er cri a do dentro de qua l quer objeto do
Servi dor.
317
Alarmes
Para inserir este objeto, siga este procedimento:

1. Clique com o boto direito do mouse no objeto de Servidor no modo Explorer e
selecione a opo Inserir - Alarme (Analgico, Banda Morta, Taxa de Variao,
Digital ou Discreto). No modo Domnio, selecione o objeto desejado no item
Objetos de Servidor e selecione a opo Inserir - Alarme (Analgico, Banda
Morta, Taxa de Variao, Digital ou Discreto).
Inserindo uma Fonte de Alarme
devidos ajustes. Demais informaes sobre as funcionalidades das propriedades
Alarmes
318
deste objeto podem ser encontradas no Manual de Referncia de Scripts, em seu

captulo respectivo.
Em cada subcondio de alarme so configurados seus limites, a mensagem
relativa ao evento, sua severidade e a necessidade ou no de reconhecimento deste
evento.
Fontes de Alarmes
Ao abrir a janela de Propriedades de qualquer Fonte de Alarme e selecionar a aba

Fonte, a janela mostrada na figura a seguir aberta.
Aba Fonte
Para tratar o alarme como evento, ou para que o alarme possa ser reconhecido
duplamente (tanto quando estiver ativo como quando passar para inativo), clique
319
Alarmes
na caixa de seleo correspondente. Todas as Fontes de Alarme possuem as

seguintes propriedades gerais:
Texto da Mensagem: Esta mensagem armazenada no campo Mensagem do
evento de alarme enquanto ele estiver ativo. Ou seja, pode ser visualizada no
E3Alarm (sumrio de alarmes), armazenada no Banco de dados, etc. O limite
do texto da 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 reconhecido
automaticamente quando a varivel deixa uma condio de alarme
Volta ao normal: Esta mensagem armazenada no campo Mensagem do
evento de alarme enquanto este estiver inativo. Ou seja, pode ser visualizada
no E3Alarm (sumrio de alarmes), armazenada em um Banco de Dados, etc.
H vrios tipos de Fontes de Alarme que podem ser inseridas em objetos do
Servidor. As opes disponveis so descritas nos prximos tpicos.
13.3.1 Analgico
Permite monitorar uma varivel analgica, pela especificao de at quatro nveis
de alarme, que so o LoLo (Muito Baixo), Lo (Baixo), Hi (Alto) e HiHi (Muito Alto).
Alarmes
320
Aba Analgico

Opes disponveis na aba Analgico
OPO
Habilitao (LoLo, Lo, Hi, HiHi)
Limite
Texto da mensagem
Severidade
Pede Ack
Evento
Espera
321
DESCRIO
Ha bi l i ta a veri fi ca o do ti po de a l a rme
es col hi do.
Indi ca o nvel em que o a l a rme
di s pa ra do.
Permi te es peci fi ca r o texto que
mos tra do pa ra o us u ri o, qua ndo o
a l a rme es ti ver em condi o a ti va .
Determi na a s everi da de do nvel de
a l a rme (pode s er Alta, Mdia ou Baixa).
Ha bi l i ta ou des a bi l i ta o reconheci mento
do a l a rme.
Ha bi l i ta ou des a bi l i ta o tra ta mento de
ca da s ubcondi o do a l a rme como um
evento.
Es peci fi ca o tempo de es pera , em ms .
Qua ndo o va l or for 0 (zero, pa dr o), n o
a pl i ca da nenhuma es pera .
Alarmes
OPO
Banda morta
Volta ao normal
DESCRIO
Ha bi l i ta a ba nda morta , que um
recurs o uti l i za do pa ra evi ta r que uma
va ri vel , a o ma nter uma pequena
os ci l a o em torno de um l i mi te de
a l a rme, gere uma qua nti da de
des neces s ri a de mens a gens .
Permi te es peci fi ca r o texto a s er
a l a rme n o es ti ver em condi o a ti va .
13.3.2 Digital
Permite monitorar uma varivel digital, pela especificao de alarme na borda de
subida (em -1 ou Verdadeiro) ou na borda de descida (em 0 ou Falso).
Aba Digital

Opes disponveis na aba Digital
OPO
Alarme Digital
Valor
Texto da mensagem
Alarmes
DESCRIO
Ha bi l i ta o a l a rme di gi ta l .
Determi na o va l or Bool ea no do a l a rme
(Verda dei ro ou Fa l s o).
322
OPO
Severidade
Pede Ack
Espera (ms)
Volta ao normal
DESCRIO
do a l a rme.
13.3.3 Banda Morta

Permite monitorar uma varivel analgica pela especificao de um limite mximo
de diferena (valor de banda morta), em relao a um valor de referncia (SetPoint).
Banda morta
Este tipo de alarme interessante quando a referncia (SetPoint) varivel, e

tambm quando se deseja evitar uma quantidade desnecessria de alarmes para
pequenas oscilaes da varivel monitorada.
323
Alarmes
Aba Banda Morta

Opes disponveis na aba Banda Morta
OPO
SetPoint
BM
Valor
Texto da mensagem
Severidade
Pede Ack
Alarmes
DESCRIO
As s oci a o pa ra a va ri vel de refernci a ,
pa ra que s eja moni tora da uma di ferena
em rel a o va ri vel de moni tora mento.
Ha bi l i ta a ba nda morta , que um
recurs o uti l i za do pa ra evi ta r que uma
va ri vel , a o ma nter uma pequena
os ci l a o em torno de um l i mi te de
a l a rme, gere uma qua nti da de
des neces s ri a de mens a gens .
Indi ca a di ferena entre a va ri vel
moni tora da e o SetPoi nt, a pa rti r do qua l
deve s er i ndi ca do o a l a rme. Deve s er
i nforma do em uni da des de engenha ri a
da va ri vel moni tora da .
mos tra do pa ra o us u ri o qua ndo o
do a l a rme.
324
OPO
DESCRIO
Espera (ms)
Volta ao normal
13.3.4 Taxa de Variao

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

Opes disponveis na aba Taxa de Variao
OPO
TDV
325
DESCRIO
Ha bi l i ta a veri fi ca o do a l a rme Ta xa de
Va ri a o.
Alarmes
OPO
Variao p/seg
Texto da mensagem
Severidade
Pede Ack
Espera (ms)
Volta ao normal
Alarmes
DESCRIO
Indi ca a porcenta gem da va ri vel
moni tora da que pode va ri a r por
s egundo. Es te va l or ca l cul a do toma ndo
como ba s e ca da i nterva l o de l ei tura da
va ri vel , pel a frmul a TDV = (Valor Atual Valor Anterior) / (Instante Atual - Instante
Anterior). Se a ta xa de va ri a o for ma i or
que a ta xa es peci fi ca da , cons i dera do
em es ta do de a l a rme.
do a l a rme.
Determi na a mens a gem de texto que
mos tra da a o us u ri o qua ndo o a l a rme
vol ta r a o es ta do norma l .
326
13.3.5 Discreto
Permite monitorar uma varivel pela especificao de mltiplas subcondies.
Aba Discreto

Opes disponveis na aba Discreto
OPO
Mapear todas as subcondies
Nome
Habilitado
Descrio
Valor
327
DESCRIO
Adi ci ona uma nova Subcondi o no
a l a rme.
Remove a Subcondi o s el eci ona da .
Permi te ma pea r e s i ncroni za r a s
Subcondi es do Al a rme a pa rti r de
s em nti ca s pres entes no objeto fonte.
Es te recurs o a tua l mente s s uporta do
pel os objetos de s ervi dor do Elipse
Power, porta nto es te bot o perma nece
des a bi l i ta do por pa dr o no Elipse E3.
Nome da Subcondi o.
Ha bi l i ta ou des a bi l i ta a Subcondi o.
Des cri o da Subcondi o.
Va l or a va l i a do pa ra determi na r s e o
a l a rme ocorre ou n o.
Alarmes
OPO
Texto da mensagem
Tipo
Severidade
Pede Ack?
Espera (ms)
Volta ao normal
Alarmes
DESCRIO
Mens a gem mos tra da qua ndo a
Subcondi o es t a ti va .
Comporta mento da Subcondi o. Pode
a s s umi r os va l ores 0: Alarme, 1: Evento ou
2: Retorno.
O ti po de s everi da de da Subcondi o.
Pode a s s umi r os va l ores 0: Alta, 1: Mdia
ou 2: Baixa.
Indi ca s e es ta Subcondi o exi ge
reconheci mento.
328
CAPTULO
14
E3Alarm
O E3Alarm serve para monitoramento dos alarmes ativos ou no reconhecidos no

sistema. Atravs deste objeto, possvel verificar o estado dos alarmes no sistema,
bem como reconhec-los manualmente.
E3Alarm
Para utilizar este objeto, siga este procedimento:

1. Clique com o boto direito do mouse em uma Tela ou na rea de trabalho e
selecione a opo Inserir - E3Alarm, ou ento clique em
E3Alarm na barra de
ferramentas Objetos.
329
E3Alarm
Inserindo um E3Alarm na Tela
devidos ajustes.
14.1 Configuraes
Para configurar o E3Alarm, clique com o boto direito do mouse no objeto e
selecione a opo Propriedades.
14.1.1 Aba Geral

Na aba Geral so especificadas as informaes referentes ao Servidor de Alarmes e
ao filtro.
E3Alarm
330
Aba Geral
Cada campo da aba Geral possui uma propriedade correspondente. As opes

disponveis nesta aba esto descritas na tabela a seguir.
OPO
Nome do Servidor de Alarmes
Filtrar por rea de Alarme
331
DESCRIO
Determi na o nome do Servi dor de
Al a rmes . i mporta nte i nforma r es te
ca mpo, ca s o contr ri o o E3Al a rm n o
mos tra os a l a rmes e i nforma uma
mens a gem de erro. Es te ca mpo equi va l e
propri eda de AlarmServer.
Determi na o fi l tro por rea de Al a rme.
Ca s o des eje uti l i za r a l gum fi l tro,
es peci fi que no ca mpo, s en o dei xe-o em
bra nco. Pode-s e fi l tra r rea s com ou s em
ca ra cteres cori nga (como * ou ?),
dependendo da confi gura o na
propri eda de SimpleAreaFilter. Se a
propri eda de SimpleAreaFilter es ti ver em
Fa l s o, ml ti pl os fi l tros de rea podem
s er us a dos , s epa ra dos por doi s pontos .
AreaFilter.
E3Alarm
OPO
Filtrar por tipo
Filtrar por severidade
DESCRIO
Ha bi l i ta o ti po de fi l tro que a pl i ca do
no Al a rme (Apenas alarmes, Apenas
eventos, e Alarmes e Eventos). Es te ca mpo
equi va l e propri eda de FilterType.
Ha bi l i ta ou des a bi l i ta a vi s ua l i za o do
gra u da s everi da de (Alta, Mdia ou Baixa).
Es te ca mpo equi va l e s propri eda des
ShowHightPriority (Al ta ),
ShowMediumPriority (Mdi a ) e
ShowLowPriority (Ba i xa ).
possvel acessar um Servidor de Alarmes remoto simplesmente preenchendo a

propriedade AlarmServer do E3Alarm com os dados do Domnio e do Servidor de
Alarmes remotos, no formato DOMINIO:SERVIDOR, onde SERVIDOR o nome do
Servidor de Alarmes remoto e DOMINIO o nome do Domnio Remoto que o contm.
Para configurar o Domnio Remoto, veja o tpico Domnios Remotos no captulo
sobre Domnios.
14.1.2 Aba Colunas

Atravs da aba Colunas possvel selecionar os campos que so 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 no tpico Configuraes para Gerao
da Tabela de Alarmes do captulo Alarmes.
E3Alarm
332
Aba Colunas
A lista Campos disponveis mostra todos os campos da Fonte de Alarme. Clicando

em Adicionar, pode-se acrescentar campos individualmente no E3Alarm. Clicando
em Propriedades, possvel configurar as propriedades do campo do alarme.
Propriedades da coluna
333
E3Alarm
Opes disponveis na janela Propriedades da coluna

OPO
Largura (pixels)
Formatador
Renomear para
Permite reconhecer
Esta coluna nunca pisca
DESCRIO
Determi na a l a rgura da col una , em pi xel s . A
l a rgura pa dr o da s col una s do E3Al a rm
de 80 pi xel s .
Determi na o forma ta dor uti l i za do na
col una do E3Al a rm. O forma ta dor uti l i za do
o pa dr o do E3 (ver tpi co Formatao de
Valores), com exce o do ca mpo Severidade e
dos ca mpos Condio Ativa, Pede Ack,
Reconhecido e Habilitado, cujos exempl os de
forma ta o podem s er vi s tos na s ta bel a s a
s egui r.
Renomei a o ttul o da col una .
Permi te confi gura r o reconheci mento do
a l a rme qua ndo o us u ri o cl i ca r na l i nha da
col una confi gura da . As opes di s ponvei s
s o:
Nunca: O a l a rme n o reconheci do
(pa dr o)
Com clique: O a l a rme reconheci do
qua ndo o us u ri o cl i ca na l i nha da
col una
Com clique-duplo: O a l a rme reconheci do
qua ndo o us u ri o cl i ca dua s vezes na
l i nha da col una
(NOTA: Se o a l a rme puder s er reconheci do,
o forma to do curs or do mous e muda pa ra
, em tempo de execu o, qua ndo el e
es ti ver s obre uma l i nha de a l a rme n o
reconheci do).
Ha bi l i ta ou des a bi l i ta o pi s ca r da col una .
Formatador para o campo Severidade

DADO
Severidade Alta
Severidade Mdia
Severidade Baixa
FORMATADOR
;;;
"A";"M";"B"
;;;
SADA FORMATADA
Al ta
M
Ba i xa
Formatador para os campos Condio Ativa, Pede Ack, Reconhecido e Habilitado

DADO
Verdadeiro
Falso
Verdadeiro
Falso
E3Alarm
FORMATADOR
"OK";"N o OK"
"OK";"N o OK"
"AAA"
"AAA"
SADA FORMATADA
OK
N o OK
AAA
N o
334
DADO
FORMATADOR
;
;
Verdadeiro
Falso
SADA FORMATADA
Si m
N o
Para remover algum campo indesejado, selecione-o e clique em Remover.
14.1.3 Aba Ordenao

A aba Ordenao permite configurar a ordenao padro dos alarmes. Quando
mais de um campo de ordenao for usado, os campos subsequentes permitem a
ordenao entre alarmes que tenham o mesmo valor para o primeiro campo.
Aba Ordenao
Cada campo da aba Ordenao possui uma propriedade correspondente. As

propriedades disponveis esto descritas na tabela a seguir.
Opes disponveis na aba Ordenao
OPO
Pelo campo
335
DESCRIO
Ordena os a l a rmes conforme o ca mpo
es peci fi ca do. Es te ca mpo equi va l e
propri eda de PrimarySortField.
E3Alarm
OPO
Depois por
Ascendente
Descendente
DESCRIO
Ordena os a l a rmes a pa rti r do i tem
es peci fi ca do na op o Pelo campo. O
prxi mo i tem ordena do a pa rti r da
es peci fi ca o i ndi ca da nos ca mpos
Depois por. Es tes ca mpos equi va l em s
propri eda des SecondarySortField,
ThirdSortField e FourthSortField,
res pecti va mente.
Ordena os ca mpos do a l a rme de forma
a s cendente. Es tes ca mpos equi va l em s
propri eda des PrimarySortAscending,
SecondarySortAscending, ThirdSortAscending
e FourthSortAscending em Verda dei ro,
res pecti va mente.
Ordena os ca mpos do a l a rme de forma
des cendente. Es tes ca mpos equi va l em
s propri eda des PrimarySortAscending,
SecondarySortAscending, ThirdSortAscending
e FourthSortAscending em Fa l s o,
res pecti va mente.
NOTAS:
A ordena o pa dr o fei ta a tra vs do ca mpo InTime, de ma nei ra des cendente.
Ca s o a propri eda de BannerMode es teja confi gura da pa ra Verda dei ro, o a l a rme
mos tra do depende da confi gura o fei ta nes ta a ba .
14.1.4 Aba Cores

Na aba Cores so definidas as cores de reconhecimento dos alarmes no objeto.
possvel configurar as cores para cada tipo de alarme ou por severidade.
E3Alarm
336
Aba Cores
Clicando em
possvel selecionar a cor para o tipo de alarme selecionado. A
seguinte janela mostrada:
Cores do alarme selecionado

Opes disponveis na janela Cores
OPO
Cor de fundo
Cor do texto
337
DESCRIO
Determi na a cor de fundo do a l a rme.
Determi na a cor do texto do a l a rme.
E3Alarm
OPO
No pisca
Pisca fundo e texto
Pisca apenas texto
DESCRIO
Qua ndo s el eci ona da , o texto do a l a rme
n o i r pi s ca r.
Qua ndo s el eci ona da , a s cores de texto e
fundo a l terna m entre s i .
Qua ndo s el eci ona da , a cor do texto va ri a
entre a s cores es col hi da s pa ra o texto e
pa ra o fundo.
possvel tambm escolher as cores por severidade, para cada tipo de alarme.
Cores do alarme por severidade
Clicando em
possvel redefinir as cores apenas para um tipo de severidade, no
tipo de alarme selecionado. A seguinte janela mostrada:
E3Alarm
338
Cores por severidade

Opes disponveis na janela Cores por severidade
OPO
Redefinir cor de fundo
Redefinir cor do texto
Redefinir pisca
DESCRIO
Determi na a cor de fundo do a l a rme
a pena s pa ra a s everi da de es col hi da . Se
es ta op o n o for ma rca da , perma nece
a cor es col hi da na op o Cor de fundo do
ti po de a l a rme s el eci ona do.
Determi na a cor do texto do a l a rme
a pena s pa ra a s everi da de es col hi da . Se
es ta op o n o for ma rca da , perma nece
a cor es col hi da na op o Cor do texto do
ti po de a l a rme s el eci ona do.
Redefi ne a op o de pi s ca pa ra o texto e
pa ra o fundo do a l a rme na s everi da de
es col hi da . Se es ta op o n o for
ma rca da , perma nece a op o es col hi da
no ti po de a l a rme s el eci ona do.
14.1.5 Aba Fontes

Atravs da aba Fonte possvel configurar a fonte do cabealho e das linhas do
E3Alarm.
339
E3Alarm
Aba Fonte
As opes disponveis so referentes a tipo, tamanho e efeitos da fonte.

NOTA: O nome da a ba a pa rece no i di oma do Wi ndows , e n o neces s a ri a mente no
i di oma do E3.
14.2 Caractersticas Especficas de Tempo de

Execuo
O E3Alarm possui uma srie de caractersticas que se aplicam apenas em tempo de
execuo (runtime). Estas caractersticas sero explicadas a seguir.
E3Alarm
340
14.2.1 Visualizando os Alarmes

Em tempo de execuo, os alarmes do sistema podem ser visualizados no E3Alarm.
E3Alarm em execuo
Dentre os alarmes que satisfazem os filtros configurados, so mostrados no

E3Alarm aqueles que estiverem em condio ativa ou no estiverem reconhecidos.
De maneira geral, isso pode ser dividido em dois casos:
Se a opo Pede Ack da Fonte de Alarme estiver em Falso, o alarme ser
considerado reconhecido desde a sua ativao, sem a necessidade de
reconhecimento. Neste caso, o alarme ficar visvel at que saia da condio
ativa
Se a opo Pede Ack da Fonte de Alarme estiver em Verdadeiro, o usurio pode
reconhecer o alarme antes ou depois da varivel sair da condio de alarme. Em
ambos os casos, o alarme s sair da lista do E3Alarm quando as duas
condies forem satisfeitas
A propriedade BannerMode, quando configurada para Verdadeiro, permite
visualizar apenas uma mensagem de alarme no objeto E3Alarm. A mensagem que
ser mostrada depender da configurao feita na aba Ordenao.
14.2.2 Reconhecimento de Alarmes

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

Opes disponveis na janela Reconhecimento de Alarmes
OPO
Reconhece apenas os alarmes selecionados
DESCRIO
Somente os a l a rmes s el eci ona dos s er o
reconheci dos .
Reconhece todos os alarmes do filtro corrente Todos os a l a rmes vi s vei s nes te E3Al a rm
s er o reconheci dos .
Todos os a l a rmes do Domni o s er o
Reconhece globalmente todos os alarmes
reconheci dos .
A opo Reconhecer apenas os alarmes selecionados s fica disponvel se

realmente houver alarmes selecionados no E3Alarm em questo. O usurio
poder reconhecer o alarme (neste caso, ser inserido um novo registro no
Banco de Dados indicando o reconhecimento), e no E3Alarm a linha
correspondente indicar que ele foi reconhecido. Esta opo estar desabilitada
caso a propriedade AllowAckSelected esteja configurada para Falso
A opo Reconhecer todos os alarmes do filtro corrente s fica disponvel se
realmente houver alarmes visveis no E3Alarm. possvel chamar esta opo sem
clicar em nenhum alarme. Para tanto, basta clicar em qualquer rea do E3Alarm,
que a janela de Reconhecimento aparecer. Clicando sobre esta janela, a caixa
de dilogo de reconhecimento aparecer. Esta opo estar desabilitada caso a
propriedade AllowAckCurrentFilter esteja configurada para Falso
A opo Reconhecer globalmente todos os alarmes fica sempre disponvel,
mesmo que no haja alarmes visveis no E3Alarm em questo. Esta opo estar
desabilitada caso a propriedade AllowAckAll esteja configurada para Falso
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, opo
Propriedades) como ser feito o reconhecimento do alarme em tempo de execuo,
com um ou dois cliques sobre a coluna.
E3Alarm
342
14.2.3 Ordenao de Colunas

Na configurao padro, possvel ordenar os alarmes clicando-se no cabealho
das colunas do E3Alarm. Ao clicar no cabealho da coluna desejada, o campo
associado a ela ser configurado como campo primrio de ordenao. Ao clicar
novamente no cabealho da mesma coluna, o sentido de ordenao primrio
(ascendente ou descendente) ser invertido.
Clicando no cabealho da coluna desejada com a tecla SHIFT pressionada, o campo
associado a ela ser configurado como campo secundrio de ordenao. Ao clicar
novamente com a tecla SHIFT pressionada no cabealho desta coluna, o sentido de
ordenao secundrio ser invertido.
Para maiores detalhes sobre este comportamento, veja as propriedades
PrimarySortAscending, PrimarySortField, SecondarySortAscending,
SecondarySortField, ThirdSortAscending, ThirdSortField, FourthSortAscending,
FourthSortField e BannerMode do E3Alarm no Manual de Referncia de Scripts.
Exemplo de ordenao
Na figura anterior, os alarmes esto ordenados primeiro por DataHora (Entrada), de

forma descendente, e depois por rea, tambm de forma descendente.
343
E3Alarm
CAPTULO
15
Storage
O Storage um mdulo alternativo de gravao dos dados histricos. Atravs dele,

possvel transformar dados de produo, processos e outras coletas em
informaes gerenciais. Este mdulo permite que diversas informaes sejam
coletadas atravs de servidores OPC, Drivers da Elipse, bancos de dados em geral,
ou at mesmo arquivos de texto e armazenamentos em banco de dados comerciais
(Microsoft SQL Server e Oracle), por objetos histricos definidos pelo usurio em
uma forma compacta e eficiente.
O armazenamento das informaes segue a lgica de que um dado s gravado
quando h 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 ferramentas como Microsoft Access ou SQL Server) ou
ainda editar diretamente as consultas SQL. Os dados extrados podem ser
visualizados em formato tabular (E3Browser), grficos (E3Chart), relatrios que
permitem visualizao em tela (propriedade PrintPreview do Relatrio), impresso
direta para o papel, ou mesmo exportao para vrios formatos como Acrobat
PDF, HTML, TXT, CSV, TIFF e GIF, entre outros.
A principal funo do Storage permitir a gravao dos dados de forma compacta.
Atravs desta ferramenta possvel recuperar com grande exatido todas as
mudanas nas variveis de processo, ocupando assim o mnimo de espao no
banco de dados. Alguns exemplos so mostrados nos tpicos a seguir.
Grfico sem compactao
A informao processada contm vrios pontos.
Storage
344
Grfico sem compactao
Grfico com compactao

Veja que a informao praticamente a mesma, s que com menos pontos.
Grfico com compactao
A gravao no Storage feita da seguinte maneira:

Aps a definio da tabela nas propriedades do Storage, esta gerada clicando
em Gerar Tabela e os dados so gravados de acordo com estas definies. Se
houver variao de qualidade no Tag, os dados tambm so gravados
Os dados s no so gravados se a variao ocorreu em um tempo menor que o
mnimo programado (campo MinRecTime)
345
Storage
Para inserir esta ferramenta no E3, siga este procedimento:

1. Clique com o boto direito do mouse no projeto no modo Explorer e selecione a
opo Inserir - Storage. No modo Domnio, clique com o boto direito do mouse
no item Objetos de Servidor - Banco de Dados, selecione a opo Inserir Storage
em e logo aps o nome do projeto desejado.
Inserindo um Storage no modo Domnio
Caso necessite, configure as propriedades do objeto. Algumas das propriedades

deste objeto podem ser configuradas atravs da Lista de Propriedades, sem a
necessidades de criar scripts para isto. Caso necessite configurar alguma
propriedade, localize-a na Lista de Propriedades e faa os devidos ajustes. Para
maiores informaes, consulte o Manual de Referncia de Scripts.
NOTA: O objeto Stora ge pode s er confi gura do pa ra funci ona r como rea de Alarme.
15.1 Configuraes
Quando o Storage criado na Tela, mostrada uma lista de definies dos campos
de gravao.
Storage
346
Campos configurados para o Storage
Para adicionar um campo, pode-se arrastar e soltar um Tag ou propriedade a partir

do Organizer, ou ento definir o campo e a fonte manualmente.
NOTA: As l i cena s de Stora ge s o veri fi ca da s a pena s qua ndo o a pl i ca ti vo
executa do e l eva m em conta a pena s os ca mpos a ti vos na a pl i ca o, n o a
qua nti da de de ca mpos exi s tentes no ba nco de da dos .
Para efeitos de posterior consulta nos dados, toda a busca se d atravs do

caminho do Tag ou propriedade que est sendo armazenada, definido atravs do
campo Fonte. A propriedade Nome s utilizada caso o campo Fonte contenha
uma expresso (por exemplo, Driver1.Tag1 + Driver1.Tag2).
Logo, se expresses no estiverem sendo utilizadas no campo Fonte, no h
necessidade de se importar com o nome do campo. As opes disponveis esto
Opes disponveis na view do Storage
OPO
Nome
Fonte
347
DESCRIO
Adi ci ona ca mpos na ta bel a do Stora ge.
Remove o ca mpo s el eci ona do da ta bel a
do Stora ge.
Determi na a s confi gura es da ta bel a
do Stora ge.
Gera a es trutura no Ba nco de Da dos .
Determi na o nome do ca mpo da ta bel a
do Stora ge.
Determi na a fonte de da dos que
a s s oci a da a o ca mpo.
Storage
OPO
Tipo
MinRecTime
MaxRecTime
Varredura
Banda Morta
Unidade
DESCRIO
Determi na o ti po do ca mpo da ta bel a do
Stora ge. Se es te va l or for a l tera do pa ra
Bit, Text ou Integer, a s col una s
MinRecTime, MaxRecTime, Varredura,
Banda Morta e Unidade fi ca m
des a bi l i ta da s .
Tempo mni mo pa ra i ns er o de um
da do na ta bel a . Es te tempo ca l cul a do
em mi l i s s egundos .
Tempo m xi mo de es pera por um da do,
em s egundos . Ao pa s s a r es te tempo, o
da do cons i dera do a nti go e
a rma zena do.
Tempo de va rredura do ca mpo. Se es te
va l or for i gua l a 0 (zero), es ta col una fi ca
des a bi l i ta da e mos tra o va l or defi ni do
em MaxRecTime, em mi l i s s egundos .
Ba nda morta pa ra c l cul o do a l gori tmo.
Va l or a bs ol uto ou a porcenta gem de
modi fi ca o.
15.1.1 Criando um Storage Vazio

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

Pode-se acessar as configuraes da tabela utilizada no Storage de duas maneiras:
1. Clicando em
Propriedades.
2. Clicando com o boto direito do mouse no objeto no Organizer e selecionando

Storage
348
a opo Propriedades.
Aba Storage
Cada campo da aba Storage possui uma propriedade correspondente. As opes

Opes disponveis na aba Storage
OPO
Nome da tabela
349
DESCRIO
Defi ne o s ervi dor de Ba nco de Da dos .
DbServer.
Determi na o nome da ta bel a . Es te ca mpo
equi va l e propri eda de TableName.
Storage
OPO
DESCRIO
Ha bi l i ta ou des a bi l i ta o des ca rte dos
da dos da ta bel a pri nci pa l . O da do s er
a nti go de a cordo com o que for defi ni do
na op o Mantenha os dados do(s)
ltimo(s). Es te ca mpo equi va l e
Mantenha os dados do(s) ltimo(s)... <Tabela Determi na o i nterva l o de tempo
Principal>
o qua l os da dos s er o ma nti dos na
ta bel a pri nci pa l . Se um da do da ta bel a
for ma i s a nti go que o i nterva l o de tempo
des ta op o, el e s er des ca rta do. Es te
DiscardInterval, e o ca mpo de s el e o da
uni da de de tempo do i nterva l o equi va l e
Determi na o i nterva l o (mi nutos , hora s ,
di a s ou mes es ) de des ca rte de da dos
a nti gos da ta bel a . Es te ca mpo equi va l e
propri eda de VerificationUnit.
Dados descartados devem ser armazenados Ha bi l i ta ou des a bi l i ta o a rma zena mento
EnableBackupTable.
Mantenha os dados do(s) ltimo(s)... <Tabela Determi na o i nterva l o de tempo
de Backup>
o qua l os da dos s er o ma nti dos na
ta bel a de backup. Es te i nterva l o deve s er
s empre ma i or que o confi gura do no i tem
Mantenha os dado(s) dos ltimo(s) da
Ta bel a Pri nci pa l . Es te ca mpo equi va l e
Gera a es trutura da ta bel a no Ba nco de
Gerar Tabela
Da dos . Es ta op o es t di s ponvel
cl i ca ndo com o bot o di rei to do mous e
no Orga ni zer, ou cl i ca ndo em Gerar
Tabela.
Aps definir as configuraes da tabela, clique em Gerar Tabela. Esta ao cria a

estrutura da tabela no banco de dados.
A estrutura de tabelas do Storage semelhante estrutura do Histrico: uma tabela
de definies, uma tabela principal de dados e uma tabela de backup (se escolhida
pelo usurio). Para que se possa identificar externamente que uma tabela
Storage
350
compactada, s verificar se foi criada a tabela _Fields.
Tabela Fields
Esta tabela possui os campos descritos na tabela a seguir.

Campos da tabela _Fields
CAMPO
FieldDeadBand
FieldDeadBandUnit
FieldDescription
FieldEU
FieldHighEng
FieldID
FieldLowEng
FieldMaxRecTime
FieldMinRecTime
FieldName
FieldQuality
FieldScanTimeMs
FieldSize
351
DESCRIO
Ba nda morta .
Uni da de da ba nda morta . Em
porcenta gem do va l or a nteri or ou
porcenta gem dos l i mi tes de engenha ri a
(va l or fi xo).
Des cri o do ca mpo.
Uni da de de Engenha ri a .
Li mi te s uperi or do Ta g.
ndi ce do ca mpo ca da s tra do no Stora ge.
Li mi te i nferi or do Ta g.
Depoi s que es te tempo expi ra , o da do
deve s er a utoma ti ca mente gra va do.
Va l or mni mo de tempo de va ri a o pa ra
a rma zena r da dos .
Nome do ca mpo.
Qua l i da de do ca mpo.
Tempo de va rredura que deve s er
uti l i za do pa ra recons trui r o gr fi co do
Ta g, em mi l i s s egundos .
Ta ma nho do ca mpo.
Storage
CAMPO
FieldSource
FieldType
FieldVARTYPE
DESCRIO
As s oci a o uti l i za da pa ra obter va l ores
des te ca mpo.
Ti po do ca mpo.
Ti po de da do na ti vo do ca mpo (0:
Indefinido, 3: Integer, 5: Double, 8: Text ou
11: Bit).
A implementao do Storage permite que o usurio no tenha que se preocupar em

como os dados esto armazenados nas tabelas. Entretanto, para uma melhor
compreenso do funcionamento do mdulo, e tambm para permitir acesso por
outros programas, mostrado a seguir o formato das tabelas.
As opes de gerenciamento de tabelas especificadas no item anterior se aplicam
na verdade a trs conjuntos de tabelas geradas pelo Storage, de acordo com o
campo Nome de Tabela.
Isto porque, para cada tipo de grandeza armazenada, gerado automaticamente
um conjunto de tabelas, a saber: um conjunto para os Tags analgicos, outro para
os textos e mais outro para os digitais. Desta forma, cada Storage pode gerenciar
at sete tabelas, caso se especifique que os trs tipos de Tags devam ser
armazenados:
<NomeTabela>_Fields
<NomeTabela>
<NomeTabela>_Text
<NomeTabela>_Bit
<NomeTabela>_Backup
<NomeTabela>_Text_Backup
<NomeTabela>_Dig_Backup
A tabela _Fields contm a descrio dos campos que so armazenados, que de
forma geral armazenam as mesmas informaes definidas na configurao dos
campos do Storage, alm de associar um ndice automtico para cada campo. As
demais tabelas possuem um formato fixo:
E3TimeStamp: Campo que armazena a data e hora em que houve a variao
do Tag. Caso o protocolo de comunicao suporte o envio de informao de
tempo, este campo contm o timestamp do equipamento
Qualidade: Contm a informao de qualidade do ponto (ruim, incerto ou
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
Storage
352
Valor: Valor armazenado. Para a tabela de analgicos trata-se de um campo

tipo Double (nmero real), j para a tabela de digitais trata-se de um nmero
inteiro e para os textos trata-se de um campo NVARCHAR de tamanho
varivel, especificado pelo usurio no campo StringFieldSize
15.2.1 Execuo
Ao iniciar a execuo do aplicativo e receber a primeira notificao de valor de
cada uma das variveis armazenadas, o Storage armazena este valor obtido com
qualidade Ruim, e logo em seguida com a qualidade enviada, se esta for Boa. Isto
porque ao realizar a consulta, o usurio tem a visualizao de que houve uma
interrupo no armazenamento.
Depois, conforme sejam obtidos novos valores para as variveis, um algoritmo de
verificao de gravao interpreta a sequncia e decide se cada ponto ou no
armazenado. Este algoritmo, conhecido como BoxCar/BackSlope, cria duas bandas
de variao (cuja amplitude dada pela banda morta da varivel) de um ponto
gravado. A banda horizontal (BoxCar) define uma verificao comum da banda
morta. Uma segunda banda diagonal (BackSlope) define uma variao para cima ou
para baixo da banda morta.
Portanto, se a varivel est em uma derivativa contnua descendente ou
ascendente, s necessrio armazenar os pontos iniciais ou finais nesta linha
reta. Assim, uma varivel analgica s gravada se o valor viola tanto a banda
horizontal quanto a vertical, ou se houve uma mudana na qualidade (ou seja, o
equipamento foi ligado ou desligado).
353
Storage
Exemplo do algoritmo BoxCar/BackSlope
Esta verificao, entretanto, s ocorre para os campos analgicos. Para os campos

de texto e digitais, basta que haja uma mudana qualquer de valor ou qualidade
(por exemplo, o equipamento perder a comunicao) para que sejam gravados.
15.2.2 Ferramentas de Consultas Internas

A ferramenta Consulta prev algumas facilidades para realizar consultas nos dados
do Storage.
Ao iniciar a configurao de uma Consulta em uma aplicao que possui um
Storage, este objeto entra na lista de Bancos de Dados disponveis para consulta.
Isto porque o Storage atua como um novo provedor de dados, criando facilidades
para o usurio consultar os dados nas tabelas temporais.
Entretanto, nada impede o usurio de realizar as consultas diretamente no Banco
de Dados de origem, de acordo com os formatos das tabelas j mencionado. A
desvantagem neste caso que o processo de consulta mais complexo.
Portanto, uma vez escolhido o prprio Storage como provedor de dados para a
Consulta, sua interface de configurao apresenta vrias diferenas, como pode
ser visto na figura a seguir. A primeira delas que ao invs de exibir as tabelas,
mostrada uma rvore com todas as variveis que esto sendo armazenadas. A
outra diferena que o usurio pode escolher uma entre sete funes para
consolidao dos dados, mostradas a seguir:
LastValue: Retorna o ltimo valor armazenado na Base de Dados
Storage
354
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 tempo de execuo
a partir da chamada do mtodo SetVariableValue da Consulta
TagAttribute: Devolve um atributo do Tag, definido em FunctionSubType, que
pode ser FieldDescription (significado ou descrio do Tag), FieldSource
(caminho do Tag que est sendo armazenado), FieldType (tipo de dado:
Double, Bit, String ou Integer), FieldEU (unidades de engenharia),
FieldLowEng (limite inferior), FieldHighEng (limite superior), 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 este intervalo so
desprezadas) e FieldMaxRecTime (tempo mximo para gravao, a ausncia
de variao nestes 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 tempo de
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 tempo de 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 tempo de 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
tempo de execuo a partir da chamada do mtodo SetVariableValue da
Consulta
Para todas as opes possvel indicar se os dados com qualidade Ruim so
includos ou no no resultado, atravs da caixa de seleo Incluir qualidade RUIM
(correspondente propriedade IgnoreQuality da Consulta associada ao objeto
355
Storage
Storage).
Funes da Consulta
15.2.3 Utilizao
Se a funo escolhida possui algum filtro, ento necessrio informar o valor dos
filtros antes de executar a Consulta, seja na prpria caixa de dilogo de
configurao (na aba Visualizar) ou atravs de script, usando o mtodo
SetVariableValue. Exemplo:
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
Storage
356
15.2.4 Ferramentas de Consultas Externas

Quando se est desenvolvendo um programa externo, em linguagens como Java,
Visual Basic ou C++, e se deseja obter os dados armazenados pelo Storage,
possvel realizar chamadas a Stored Procedures, que so criadas pelo Storage em
um Banco de Dados. Existem sete Stored Procedures que correspondem a algumas
das opes de Consulta, mostradas na tabela a seguir.
Opes de consultas disponveis
FUNO CONSULTA
LastValue
ArchivedValue
CompressedDataNValues
CompressedDataStartEndTime
SampledData
CalculatedData
STORED PROCEDURE
E3La s tVa l ue
E3Archi ve, E3Archi veInterpol a te
E3NCompDa ta
E3CompDa ta
E3Sa mpl edDa ta
E3Ca l cul a tedDa ta
As Stored Procedures que utilizam parmetros de tipo Data recebem este parmetro
na chamada como um nmero Float (ponto flutuante), ao invs de DateTime. Isto
feito para aumentar a preciso do E3, j que ao utilizar o formato DateTime a
preciso mxima de 3ms, ao invs de 1ms com o tipo Float.
Para facilitar a passagem de parmetros, pode-se adicionar ao Banco de Dados
uma funo do usurio que transforma um valor DateTime em um Float, conforme o
exemplo a seguir:
CREATE FUNCTION E3GETFLOATVALUE (@dDate datetime)
RETURNS FLOAT AS
BEGIN
RETURN CAST(@dDate AS float)
END
A seguir, alguns exemplos da utilizao destas funes.
15.2.4.1 E3LastValue
Retorna o ltimo valor de um determinado Tag que est armazenado no Banco de
Dados. A descrio formal a seguinte:
E3LastValue(@strTableName varchar(100),
@strFieldName VARCHAR(100),
@strFilter VARCHAR(500),
@type int,
@bQuality int)
Onde:
@strTableName: Nome da tabela
357
Storage
@strFieldName: Nome do campo

@strFilter: Caso queira inserir opes de filtro para o valor
@type: Tipo de dado (0: String, 1: Bit ou Integer ou 2: Analgico)
@bQuality: Se diferente de 0 (zero), somente inclui Tags com qualidade Boa
Retorna uma consulta com apenas uma linha, com os campos E3TimeStamp,
Quality e FieldValue. Exemplo de utilizao:
EXECUTE E3LastValue 'TabelaXX',
'Tag234', '', 2, 1
15.2.4.2 E3Archive
Retorna um valor armazenado em relao a um instante, conforme exposto na
funo ArchivedValue. usada somente para os subtipos Prev (0), Next (2) e
ExactTime (3). A descrio formal a seguinte:
E3Archive(@iSubType int,
@strTableName varchar(100),
@dData float,
@type int,
@bQuality int)
Onde:
@iSubType: Subtipo da funo (0: Prvio, 2: Prximo ou 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
15.2.4.3 E3ArchiveInterpolate
Retorna os pontos imediatamente anteriores e posteriores a um instante, conforme
exposto para a funo ArchivedValue, porm somente para o Subtipo Interpolado. A
descrio formal a seguinte:
E3ArchiveInterpolate(@strTableName varchar(100),
@dData float,
Storage
358
@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:
EXECUTE E3ArchiveInterpolate 'STO22',
@MyDate, 'Dados.TagDemo1', '', 2, 0
15.2.4.4 E3NCompData
Equivale funo CompressedDataNValues. A descrio formal a seguinte:
E3NCompData(@strTableName varchar(100),
@dData float,
@iNValues int,
@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:
EXECUTE E3NCompData 'STO22', @MyDate,
'Dados.TagDemo1', 20, '', '', 2, 0
15.2.4.5 E3CompData
Equivale funo CompressedDataStartEndTime. A descrio formal a seguinte:
E3CompData(@strTableName varchar(100),
@dStartData float,
@dEndData float,
359
Storage
@strOrder VARCHAR(100),
@type int,
@bQuality int)
Onde:
@dStartData: A data inicial, em formato Float
@dEndData: A data final, em formato Float
@strOrder: Quando desejar que a consulta seja ordenada por outro campo
que no seja o TimeStamp
Esta funo retorna o nmero de linhas encontrado no intervalo, com os campos
E3TimeStamp, Quality e FieldValue. Exemplo de utilizao:
DECLARE @MyStartDate FLOAT
DECLARE @MyEndDate FLOAT
SET @MyStartDate = dbo.E3GETFLOATVALUE('10-10-2005 12:00:00')
SET @MyEndDate = dbo.E3GETFLOATVALUE('10-10-2006 12:00:00')
EXECUTE E3CompData 'STO22', @MyStartDate,
@MyEndDate, 'Dados.TagDemo1', '', '', 2, 0
15.2.4.6 E3SampledData
Equivale funo SampledData. A descrio formal a seguinte:
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
Storage
360

EXECUTE E3SampledData 'STOXX', 10, @MyStartDate,
@MyEndDate, 'Dados.TagDemo1', '', 2, 1
15.2.4.7 E3CalculatedData
Equivale funo CalculatedData. A descrio formal a seguinte:
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 (0: Total, 1: Mnimo, 2: Mximo, 3: Desvio
Padro, 4: Amplitude, 5: Mdia ou 6: Mediana)
EXECUTE E3CalculatedData 0, 'STOXX', 10,
@MyStartDate, @MyEndDate, 'Dados.TagDemo1', '', 2, 1
361
Storage
CAPTULO
16
Histrico
Histricos so mdulos responsveis pelo armazenamento de dados da aplicao

em um Banco de Dados. Permitem armazenar dados de processos para anlises
futuras. Pode-se criar tantos arquivos de Histricos quantos se desejar, cada um
contendo diversos Tags ou expresses. Cada Histrico pode criar ou utilizar uma
tabela independente dentro do Banco de Dados, cujo armazenamento pode ser
definido por Tempo ou por Evento. Atravs da propriedade CacheSize, define-se o
nmero de registros enviados por vez para o Banco de Dados. Conforme a definio
da propriedade DBServer, define-se o Servidor do Banco de Dados que utilizado
pelo Histrico. Para utilizar este recurso, siga estes procedimentos:
1. Clique com o boto direito do mouse no nome do projeto no mdoo Explorer e
selecione a opo Inserir - Histrico. No modo Domnio, clique com o boto
direito do mouse no item Objetos de Servidor - Banco de Dados, selecione a
opo Inserir Histrico em e logo aps o nome do projeto desejado.
Histrico
362
Inserindo um Histrico no modo Domnio
2. Quando o Histrico for habilitado, as seguintes opes de configurao so

mostradas na figura a seguir.
Opes do Histrico
363
Histrico
Opes disponveis na view do Histrico

OPO
DESCRIO
Adi ci ona ca mpos na ta bel a do Hi s tri co.
Remove o ca mpo s el eci ona do da ta bel a
do Hi s tri co.
Determi na a s confi gura es da ta bel a
do Hi s tri co.
Gera a es trutura no Ba nco de Da dos .
Cri a uma cha ve pri m ri a .
Confi gura os ndi ces que s o cri a dos no
Hi s tri co.
Ma ntm o Hi s tri co s em vncul os di retos
com a ta bel a exi s tente.
Bus ca os ca mpos na ta bel a ori gi na l .
Vi ncul a o Hi s tri co a uma ta bel a j
exi s tente.
3. Abra a janela de propriedades do Histrico. Para tanto, clique com o boto

direito do mouse no objeto e selecione 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, localize-a na Lista de Propriedades
e faa os devidos ajustes. Demais informaes sobre as funcionalidades das
Scripts, no captulo referente ao objeto Histrico.
NOTA: O objeto Hi s tri co pode s er confi gura do pa ra funci ona r como rea de Alarme.
16.1 Configuraes
Quando um Histrico inserido no projeto, o campo E3TimeStamp criado
automaticamente na tabela. O campo E3TimeStamp mostra a data e hora em que o
valor foi buscado (diferente do timestamp do Tag). Vale lembrar que este campo
utilizado somente para leitura. possvel associar um Tag ao campo E3TimeStamp.
Se no houver Associao, ele busca a hora atual do sistema para a gravao. Para
criar a tabela no Histrico, importante que seus campos sejam previamente
criados clicando-se em (Adicionar campo). Para remover algum campo
indesejado, clique em
(Remover campo). A mensagem de confirmao da figura
a seguir mostrada.
Histrico
364
Mensagem para confirmar excluso de campo na tabela
O campo Nome define o nome do campo da tabela, o campo Tipo define o tipo de
campo da tabela e a fonte deste campo definida em Fonte. Tambm possvel
definir se este campo ou no a chave primria da tabela.
16.1.1 Chave Primria

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

ou clicando no cone
configurao, conforme a figura a seguir.
, que abre a janela de
Editando um ndice de Chave Primria
Nesta janela, selecione o campo desejado como chave primria. As opes

disponveis nesta janela esto descritas na tabela a seguir.
Opes disponveis na janela Edio de ndices
OPO
Nome do ndice
Garantir que os valores deste ndice sero
nicos
Nome do campo
Ordenao
Tipo
Mude a ordem dos campos
Histrico
DESCRIO
Determi na o nome da cha ve pri m ri a .
Fa z com que os va l ores es peci fi ca dos
pa ra o ndi ce Cha ve Pri m ri a s eja m
ni cos . Es ta op o es t s empre ma rca da
pa ra Cha ves Pri m ri a s , n o podendo s er
modi fi ca da .
Mos tra o nome do ca mpo.
Mos tra a ordena o do ca mpo
s el eci ona do.
Mos tra o ti po do ca mpo da ta bel a .
Muda a pos i o do ca mpo na ta bel a ,
fa zendo com que el e s uba ou des a .
366
Clicando em OK, confirma-se que o campo determinado uma chave primria da

tabela. Para cancelar a configurao, clique em Cancelar. Pode-se tambm atribuir
um ndice tabela.
16.1.2 ndices
Um ndice um campo ou conjunto de campos que so 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 encontre os registros
relevantes. Quanto maior a tabela, maior o custo desta operao. Se a tabela
possuir um ndice para as colunas em questo, o Banco de Dados pode
rapidamente obter uma posio para procurar no meio do arquivo de dados sem
ter que varrer todos os registros. Por exemplo, se uma tabela possui 1.000
registros, isto pelo menos 100 vezes mais rpido do que ler todos os registros
sequencialmente. Note que, se for preciso acessar quase todos os 1.000 registros,
mais rpido acess-los sequencialmente, pois isto evita acessos ao disco.
Os tipos de ndices disponveis so os seguintes: Primrio, nico e Index.
Todos os tipos de colunas da tabela podem ser indexadas. O uso de ndices nas
colunas relevantes a melhor forma de melhorar a performance da tabela. O
nmero mximo de ndices por tabelas e o tamanho mximo de um ndice definido
pelo mecanismo de armazenamento do Servidor de Banco de Dados.
Pode-se criar ndices em mltiplas colunas. Um ndice de mltiplas colunas pode
ser considerado um vetor ordenado contendo valores que so criados
concatenando-se valores de colunas indexadas.
Os ndices podem ser configurados atravs do cone
configurao, conforme a figura a seguir.
367
, que abre a janela de
Histrico
Janela Editor de ndices

Opes disponveis na janela Editor de ndices
OPO
Nome
Campos
Adicionar
Editar
Remover
DESCRIO
Mos tra o nome do ndi ce exi s tente.
Mos tra o ca mpo a o qua l o ndi ce es t
a s s oci a do na ta bel a .
Abre uma ca i xa de di l ogo pa ra a a di o
de um ndi ce.
Abre uma ca i xa de di l ogo pa ra a edi o
do ndi ce s el eci ona do.
Remove o ndi ce s el eci ona do.
Ao clicar em Adicionar, a caixa de dilogo da figura a seguir mostrada.
Histrico
368
Janela Adio de ndices

Opes disponveis na janela Adio de ndices
OPO
Nome do ndice
Garantir que os valores deste ndice sero
nicos
Nome do campo
Ordenao
Tipo
Mude a ordem dos campos
DESCRIO
Determi na o nome do ndi ce.
Se ha bi l i ta da , fa z com que os va l ores
es peci fi ca dos pa ra o ndi ce s eja m
ni cos .
Mos tra os nomes dos ca mpos . Sel eci one
a quel es que devem pertencer a o ndi ce.
Mos tra a ordena o do ca mpo
s el eci ona do (Ascendente ou Descendente).
Mos tra o ti po do ca mpo da ta bel a .
Muda a pos i o do ca mpo na ta bel a ,
fa zendo com que el e s uba ou des a .
Clicando em OK, os ndices na tabela so confirmados. Para cancelar a

configurao, clique em Cancelar.
369
Histrico
16.1.3 Configuraes da Tabela

Depois de definidas as opes anteriores, necessrio configurar as informaes
da tabela do Histrico e gerar a estrutura no Banco de Dados. Para tanto, clique
com o boto direito do mouse no Histrico e selecione a opo Propriedades.
Selecione a aba Histrico, conforme a figura a seguir.
Aba Histrico
Cada campo da aba Histrico possui uma propriedade correspondente. As opes

Histrico
370
Opes disponveis na aba Histrico

OPO
Nome da tabela
Gravar um novo registro a cada
Mantenha os dados do(s) ltimo(s) ...

<Tabela Principal>
Dados descartados devem ser armazenados
Mantenha os dados do(s) ltimo(s)...

<Tabela de Backup>
371
DESCRIO
Defi ne o s ervi dor de Ba nco de Da dos .
DbServer.
Determi na o nome da ta bel a . Es te ca mpo
equi va l e propri eda de TableName.
Determi na a va ri a o do i nterva l o de
tempo (em ms ), ou s eja , de qua nto em
qua nto tempo os da dos do Hi s tri co s o
gra va dos na ta bel a . Es te ca mpo equi va l e
propri eda de ScanTime.
Ha bi l i ta ou des a bi l i ta o des ca rte dos
da dos da ta bel a pri nci pa l . O da do
a nti go de a cordo com o que for defi ni do
na op o Mantenha os dados do(s)
ltimo(s). Es te ca mpo equi va l e
pri nci pa l . Se um da do da ta bel a for ma i s
a nti go que o i nterva l o de tempo des ta
op o, el e des ca rta do. Es te ca mpo
equi va l e propri eda de DiscardInterval, e
o ca mpo de s el e o da uni da de de
tempo do i nterva l o equi va l e
Determi na o i nterva l o (mi nutos , hora s ,
di a s ou mes es ) de des ca rte de da dos
a nti gos da ta bel a . Es te ca mpo equi va l e
propri eda de VerificationUnit.
EnableBackupTable.
de backup. Es te i nterva l o deve s er s empre
ma i or que o confi gura do no i tem
Mantenha os dados do(s) ltimo(s) da Tabela
Principal. Es te ca mpo equi va l e
Histrico
OPO
Gerar Tabela
DESCRIO
Gera a es trutura da ta bel a no Ba nco de
Da dos . Es ta op o es t di s ponvel a o
cl i ca r com o bot o di rei to do mous e no
Orga ni zer, ou a tra vs da op o Gerar
Tabela.
Ao clicar em Gerar Tabela, o Studio mostra a caixa de dilogo da figura a seguir.
Mensagem do sistema
Quando a opo Gerar Tabela utilizada, a tabela especificada no Histrico

gerada, alm de uma tabela _Fields. Esta tabela possui as informaes de cada
campo cadastrado no Histrico.
Campos
Os campos disponveis na tabela do Histrico esto descritos na tabela a seguir.

Histrico
372
Campos da tabela do Histrico

CAMPO
FieldDeadBand
FieldDeadBandUnit
FieldDescription
FieldEU
FieldHighEng
FieldID
FieldLowEng
FieldMaxRecTime
FieldMinRecTime
FieldName
FieldQuality
FieldSize
FieldSource
FieldType
DESCRIO
Ba nda morta .
Uni da de uti l i za da pel a ba nda morta (em
va l ores a bs ol utos ou em porcenta gem).
Des cri o do ca mpo.
Uni da de de Engenha ri a .
Li mi te s uperi or do Ta g.
ndi ce do ca mpo ca da s tra do no Hi s tri co.
Li mi te i nferi or do Ta g.
Depoi s que es te tempo expi ra , o da do
deve s er a utoma ti ca mente gra va do.
Va l or mni mo de tempo de va ri a o pa ra
a rma zena mento de um da do.
Nome do ca mpo do Hi s tri co.
Ti po da qua l i da de do ca mpo. As opes
di s ponvei s s o 0: Sem qualidade, 1:
Mtodo anterior verso 1.21 (onde 0: Valor
duvidoso e 1: Valor bom) ou 2: Qualidade
real do Tag.
Ta ma nho do ca mpo.
As s oci a o uti l i za da pel o ca mpo pa ra
obter os s eus va l ores .
Ti po do ca mpo.
A opo Vincular Histrico a uma tabela j existente

vincula o Histrico a
tabelas existentes no Banco de Dados. Quando esta opo habilitada, o Studio
abre uma caixa de dilogo para determinar quais as tabelas so vinculadas ao
Histrico corrente, conforme a figura a seguir.
373
Histrico
Seleo de tabela para vinculo com o Histrico
Quando a tabela selecionada e clica-se em OK, o Studio mostra a mensagem da

figura a seguir.
Mensagem do sistema
Clicando em Cancel, os campos configurados na tabela permanecem com as

configuraes atuais. J clicando em OK, todos os campos, ndices e chaves
primrias definidas no Histrico so substitudos pelos dados da tabela
selecionada.
Quando este item utilizado, outras duas opes 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
Histrico
374
habilitada, o Studio mostra a mensagem da figura a seguir.
Mensagem quanto configurao do Histrico
Clicando em Cancel, a tabela permanece com as configuraes atuais. J clicando

em OK, a tabela reinicializada com seus campos iniciais, onde h somente o
campo padro habilitado (E3TimeStamp).
Histrico aps a habilitao da opo Manter histricos sem vnculo direto com a tabela
existente
J a opo Buscar campos da tabela original recupera os dados do Histrico

vinculado tabela existente, que haviam sido apagados.
Histrico utilizando a opo Buscar campos da tabela original
375
Histrico
CAPTULO
17
Consultas
O objeto Consulta (ou Query) auxilia no processo de definio de consultas no

Banco de Dados da aplicao. Toda vez que os objetos E3Browser ou Relatrio
buscam dados de um Banco de Dados, necessrio enviar um comando, de forma
que se saiba quais os dados desejados para aquele objeto. Logo, toda vez que uma
aplicao precisar gravar ou buscar dados armazenados em um Banco de Dados,
so enviados comandos no formato SQL (Structured Query Language). A Consulta
apresenta uma interface amigvel, que permite a construo das consultas em uma
forma grfica e o acompanhamento imediato da sintaxe SQL que est sendo gerada.
A consulta permite mostrar os dados dos ltimos N dias, horas ou meses, data final
ou inicial e consultas.
O Assistente da consulta responsvel por criar o texto que executa o filtro ou a
consulta, no sendo necessrio para o usurio saber detalhes como data, etc. Para
utilizar este recurso, siga estes procedimentos:
1. Clique com o boto direito do mouse em uma Tela do projeto e selecione a
opo Inserir - Consulta.
NOTA: Qua ndo cri a do um objeto Rel a tri o ou E3Brows er, o objeto Cons ul ta
a di ci ona do a utoma ti ca mente a es tes objetos . No enta nto, ta mbm pode-s e i ns eri r
es te objeto em uma Pa s ta de Da dos ou em uma Tel a . Pa ra ma i ores deta l hes , veja
os ca ptul os corres pondentes .
2. Antes de definir a Consulta, deve-se informar em qual Servidor de Banco de

Dados a Consulta busca os dados. Para tanto, selecione o servidor na caixa de
listagem Nome do Servidor.
Definio do Servidor Banco de Dados
A configurao da Consulta depende do objeto ao qual ela est relacionada.

Consultas
376
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
Scripts.
17.1 Criando uma Consulta

Quando um E3Browser ou um Relatrio criado no projeto, uma Consulta
automaticamente inserida como objeto filho, com o nome "Consulta1". Para utilizar
1. Ao clicar com o boto direito do mouse na Consulta e selecionar o item
Configurar, uma janela mostrada solicitando a identificao do Servidor de
Banco de Dados da aplicao.
377
Consultas
Definio do Servidor Banco de Dados na Consulta
2. Aps ser definido o servidor Banco de Dados, uma nova janela aparece com
tabelas que foram encontradas no Banco de Dados, permitindo a sua seleo.
Adio de tabela
3. Selecione as tabelas que fazem parte da consulta e clique em OK.

4. Depois de definidas as tabelas, a janela de definio da Consulta mostrada,
contendo as quatro abas a seguir:
Campos
Variveis
Visualizar
Consultas
378
SQL
Configurao da Consulta
Estas abas so descritas nos prximos tpicos.
17.1.1 Aba Campos

Esta aba mostra todos os campos das tabelas usadas na Consulta. Ao clicar em
possvel selecionar outras tabelas para a Consulta.
379
Consultas
Inserindo uma tabela
Para selecionar todos os campos da tabela para que faam parte da Consulta,
selecione o primeiro item da lista de seleo, correspondente ao smbolo *
(asterisco). Para adicionar um campo especfico, selecione sua caixa de seleo
correspondente.
Consultas
380
Selecionando campos de uma tabela
Devido questes de performance, importante adicionar Consulta somente

campos que realmente interessam para a anlise.
Na rea de colunas, os campos escolhidos so mostrados.
rea de colunas
Cada coluna mostra propriedades para cada campo da tabela ou tabelas

selecionadas, conforme a tabela a seguir.
Opes disponveis para a configurao de colunas
OPO
Colunas
Ttulo
381
DESCRIO
Mos tra o nome da s col una s
s el eci ona da s . Ao cl i ca r na ca i xa de
combi na o de ca da l i nha , pode-s e
redefi ni r a col una des eja da .
Permi te que um novo nome s eja defi ni do
pa ra a col una (ta mbm conheci do como
alias).
Consultas
OPO
Tabela
Mostrar
Ordenao
Ordem
Agrupado por
Funo
Filtro
DESCRIO
Mos tra o nome da ta bel a de ori gem do
ca mpo.
Ha bi l i ta ou des a bi l i ta o ca mpo.
Permi te ordena r os va l ores : Sem
ordenao, Ascendente (va l ores menores
pri mei ro) ou Descendente (va l ores
ma i ores pri mei ro).
Defi ne a pri ori da de qua ndo ma i s de um
ca mpo pos s ui ordena o.
Permi te que os da dos s eja m a grupa dos a
ca da novo va l or do ca mpo.
Permi te defi ni r a execu o de uma
fun o pa ra o ca mpo.
Defi ne um cri tri o de cons ul ta , como por
exempl o i nterva l os de da ta .
Ao definir um filtro, a janela da figura a seguir mostrada, permitindo que se

defina o tipo de comparao e o valor a ser comparado.
Definindo um filtro
O tipo de dado de comparao pode ser definido ao clicar na caixa de seleo

correspondente e selecionar um dos tipos na lista de opes.
Consultas
382
Configuraes para a definio do filtro
O valor de comparao pode ser uma constante (por exemplo, 123, 45, "ABCD", etc.)
ou uma varivel definida pelo usurio. Para criar uma varivel, informe um nome
qualquer entre os seguintes smbolos:
<% %> se o valor for numrico
'<% %>' se o valor for uma String
#<% %># se o valor for uma data
O valor da varivel pode ser definido na aba Variveis ou atravs do mtodo
SetVariableValue, via script.
17.1.2 Aba Variveis

Esta aba permite definir valores padro para variveis definidas pelo usurio.
Estas variveis tambm podem ter seu valor alterado em tempo de execuo
utilizando o mtodo SetVariableValue.
383
Consultas
Aba Variveis
As colunas desta aba so descritas na tabela a seguir.

Opes disponveis na aba Variveis
OPO
Nome
Valor
DESCRIO
O nome da va ri vel defi ni da pel o
us u ri o.
Uma ca i xa de s el e o onde o va l or do
ti po de da dos pode s er s el eci ona do. As
opes s o Empty, NULL, Boolean, Char,
Byte, Integer, Word, Long, Dword, Currency,
Single, Double, Date, Decimal e String.
17.1.3 Aba Visualizar

Esta aba mostra uma prvia dos resultados da Consulta ao clicar em . Tambm
possvel limitar o nmero mximo de registros retornados, permitindo agilizar a
consulta.
Consultas
384
Visualizao da Consulta
17.1.4 Aba SQL

Nesta aba exibida a sintaxe SQL resultante da configurao realizada. Pode-se
editar diretamente a consulta, selecionando a opo Habilita edio direta do SQL.
385
Consultas
Aba SQL
Ao desmarcar a opo Habilita edio direta do SQL, todas as alteraes so

perdidas e a Consulta retorna s opes selecionadas nas abas Campos, Variveis e
Visualizar.
Aviso ao desabilitar a edio direta do SQL
17.2 Uso dos Filtros da Consulta atravs de Scripts

Configurar e confirmar se a Consulta est correta apenas um dos passos no seu
uso. O uso em tempo de execuo e as modificaes de valores dos filtros definidos
para a Consulta podem ser vistos no script a seguir. O mtodo SetVariableValue o
responsvel pela configurao da Consulta, conforme os valores passados via
script.
Set consulta = Screen.Item("E3Browser1").Item("Consulta1")
Consulta.SetVariableValue "DataIni", _
Consultas
386
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 executada respeitando estes novos
valores.
17.3 Uso de Recordsets de uma Consulta atravs de

Scripts
Um outro uso interessante da Consulta trabalhar com Recordsets. Depois de
executada uma Consulta, possvel capturar o Recordset correspondente e
trabalhar com registros linha a linha, executar novas Consultas, etc. Na linha de
comando a seguir:
RS = TelaInicial.E3Browser1.Consulta1.GetADORecordset()
A varivel RS assume todas as caractersticas de um Recordset. A vantagem do uso

deste recurso que se forem feitas modificaes nas propriedades do banco de
dados, no necessrio ajustar cada um dos scripts que acessam este banco de
dados.
387
Consultas
CAPTULO
18
E3Browser
O E3Browser um controle ActiveX utilizado para visualizar dados armazenados

em Bancos de Dados. Pode-se configurar consultas utilizando filtros de vrios tipos
nos dados e atribuir cores para cada coluna, entre outras configuraes. Este
objeto utilizado para visualizar os Histricos, alarmes ou qualquer tabela
existente no Banco de Dados.
E3Browser

1. Insira um E3Browser no projeto clicando com o boto direito do mouse na rea
de trabalho e selecionando o item Inserir - E3Browser.
E3Browser
388
Inserindo um E3Browser na Tela
2. O E3Browser utiliza o objeto Consulta para auxiliar o usurio no processo de

definio de consultas no Banco de Dados da aplicao. Para maiores
informaes, consulte o captulo referente.
3. Caso necessite, configure as propriedades do E3Browser. Algumas das
devidos ajustes. Demais informaes sobre as funcionalidades das
Scripts, em seu captulo respectivo.
18.1 Objeto Consulta no E3Browser

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

consultas de forma grfica e o acompanhamento imediato da sintaxe SQL que est
sendo gerada.
NOTA: Um E3Brows er n o pode ca rrega r cons ul ta s que s e encontrem no s ervi dor.
A aba Consulta mostra os campos disponveis na consulta. Tais campos podem ser
acessados clicando-se em Configurar, que abre o assistente de configurao da
consulta.
E3Browser
390
Aba Consulta
Para maiores informaes sobre a Consulta, veja o captulo Consultas.
18.2 Outras Configuraes

As configuraes disponveis no E3Browser so descritas nas sees seguintes.
18.2.1 Aba Estilo

Atravs da aba Estilo pode-se definir a aparncia das divises (grade) das clulas e
dimenses das linhas e colunas.
391
E3Browser
Aba Estilo
Cada campo da aba Estilo possui uma propriedade correspondente. As

Opes disponveis na aba Estilo
OPO
Estilo da grade
Altura do cabealho
Largura da 1 coluna
Altura das Linhas

Largura das Colunas
E3Browser
DESCRIO
Determi na o es ti l o da gra de do
E3Brows er. Es te ca mpo equi va l e
propri eda de GridLinesType do E3Brows er.
Determi na a a l tura , em pi xel s , do
ca bea l ho do E3Brows er. Es te ca mpo
equi va l e propri eda de FixedRowHeight
do E3Brows er.
Determi na a l a rgura da pri mei ra col una
na ta bel a . Es te ca mpo equi va l e
propri eda de FixedColumnWidth do
E3Brows er.
Determi na a a l tura da s l i nha s res ta ntes
na ta bel a . Es te ca mpo equi va l e
propri eda de RowHeight do E3Brows er.
Determi na a l a rgura da s col una s da
ta bel a . Es te ca mpo equi va l e
propri eda de ColumnWidth do E3Brows er.
392
18.2.2 Aba Opes

Na aba Opes, informe o intervalo de tempo em que os dados so gravados e
atualizados no E3Browser. A atualizao ocorre 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, informado qual o tipo de
seleo feita na tabela.
Aba Opes
Cada campo da aba Opes possui uma propriedade correspondente. As

OPO
Informe o intervalo de tempo em que os
dados sero atualizados
Informe qual ser o tipo de seleo
393
DESCRIO
Determi na o i nterva l o de tempo em que
os da dos s o a tua l i za dos . Es te va l or
deve s er s uperi or a 1000 ms . Es te ca mpo
equi va l e propri eda de RefreshTime do
E3Brows er.
Determi na o ti po de s el e o na ta bel a
do E3Brows er. Es te ca mpo equi va l e
propri eda de SelectRow do E3Brows er.
E3Browser
18.2.3 Aba Cores

A aba Cor determina as cores do E3Browser, referentes s suas colunas e clulas.
Se a cor desejada no estiver na paleta de cores padro, necessrio configur-la
clicando em Editar Cor Personalizada (Edit Custom Color), que abre a caixa de
dilogo de edio de cor.
Aba Cor
As opes disponveis deste item esto descritas na tabela a seguir.

Opes disponveis da aba Cor
OPO
Propriedades (Properties)
Conjunto de Cores (Color Set)
Paleta de Cores (Color Palette)

Editar Cor Personalizada (Edit Custom Color)
DESCRIO
Determi na a cor conforme a propri eda de
s el eci ona da .
Determi na o conjunto de cores a s er
uti l i za do: Cores padro ou Cores do
Windows.
Determi na a cor da propri eda de
s el eci ona da .
Edi ta uma nova cor pers ona l i za da ,
di ferente da s cores pa dr o.

i di oma do E3.
E3Browser
394
18.2.4 Aba Fonte

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

i di oma do E3.
395
E3Browser
CAPTULO
19
E3Chart
O E3Chart um componente ActiveX criado especialmente para trabalhar em

conjunto com o E3. Com ele, possvel exibir grficos mostrando Tags variando em
tempo real, bem como dados histricos gravados em um Banco de Dados.
O E3Chart composto por vrias colees. Uma coleo (collection) um objeto
especial que gerencia um conjunto de objetos semelhantes. O E3Chart possui as
seguintes colees:
Coleo de Penas: Gerencia o conjunto de Penas criadas para manipular a
sequncia de dados representada no E3Chart
Coleo de Eixos: Gerencia os Eixos do E3Chart, onde podem ser configuradas
diferentes escalas a serem associadas aos dados das Penas
Coleo de Consultas: Gerencia as consultas com informaes sobre as
Penas (por exemplo, no caso de grficos que mostram dados histricos que
j foram gravados em um Banco de Dados)
Coleo de Legendas: Gerencia as colunas da Legenda do E3Chart, onde so
mostradas as informaes sobre as Penas
Para utilizar os recursos do E3Chart, siga estes procedimentos:
1. Insira um E3Chart no projeto clicando com o boto direito do mouse na Tela e
selecionando a opo Inserir - E3Chart.
E3Chart
396
Inserindo um E3Chart na Tela
2. Caso seja necessrio, configure as propriedades do E3Chart. Algumas das

Propriedades, sem a necessidade da criao de scripts para isto. Caso
faa os devidos ajustes. Demais informaes sobre as funcionalidades das
Scripts, em seu captulo correspondente.
19.1 Configuraes
Para configurar um E3Chart, clique com o boto direito do mouse no objeto e
selecione a opo Propriedades.
19.1.1 Abas Item, Posio e Geral

Atravs da aba Item, possvel visualizar o nome do objeto e atribuir-lhe uma
descrio.
397
E3Chart
Aba Item
Cada campo da aba Item possui uma propriedade correspondente. As opes

disponveis esto descritas na tabela a seguir.
Opes disponveis na aba Item
OPO
Nome
Documentao
DESCRIO
Determi na o nome do objeto. Es te ca mpo
equi va l e propri eda de Name do E3Cha rt.
Texto l i vre que pos s i bi l i ta a
documenta o da s funci ona l i da des e
ca ra cters ti ca s do objeto pel o
progra ma dor. Es te ca mpo equi va l e
propri eda de DocString do E3Cha rt.
A aba Posio determina o posicionamento do E3Chart na Tela.
E3Chart
398
Aba Posio
Cada campo da aba Posio possui uma propriedade correspondente. As opes

Opes disponveis na aba Posio
OPO
X
Largura
Altura
DESCRIO
Defi ne a coordena da hori zonta l
es querda do objeto, em uni da des
Hi metri c. Es te ca mpo equi va l e
propri eda de X do E3Cha rt.
Defi ne a coordena da verti ca l s uperi or do
objeto, em uni da des Hi metri c. Es te
ca mpo equi va l e propri eda de Y do
E3Cha rt.
Determi na a l a rgura do objeto. Es te
ca mpo equi va l e propri eda de Width do
E3Cha rt.
Determi na a a l tura do objeto. Es te
ca mpo equi va l e propri eda de Height do
E3Cha rt.
Atravs da aba Geral, possvel especificar o estilo e a aparncia do grfico.
399
E3Chart
Aba Geral

OPO
Mostrar ttulo
Mostrar o fundo do grfico com a cor
Mostrar o fundo da grade com a cor
Intervalo entre as atualizaes (segundos)
DESCRIO
Exi be o ttul o do gr fi co. Es te ca mpo
equi va l e propri eda de Title do E3Cha rt.
Determi na a cor de fundo do gr fi co. Es te
ca mpo equi va l e propri eda de BackColor
do E3Cha rt.
Determi na a cor de fundo da gra de do
gr fi co. Es te ca mpo equi va l e
propri eda de GridBackColor do E3Cha rt.
Determi na o i nterva l o entre a s
a tua l i za es do des enho no gr fi co. Es te
RefreshTime do E3Cha rt.
19.1.2 Aba Eixos

O objeto Coleo de Eixos representa o conjunto de Eixos contidos no E3Chart. Os
Eixos so escalas colocadas no contorno da grade do E3Chart.
Atravs da aba Eixos, possvel adicionar e remover Eixos da Coleo de Eixos, bem
como configurar suas propriedades individualmente.
E3Chart
400
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 em Adicionar, criado um novo Eixo no grfico e aberta uma
janela de configurao que permite determinar as propriedades do objeto Eixo.
Esta janela possui duas abas, Geral e Escala, e tambm pode ser aberta ao clicar em
Configurar.
A aba Geral contm a informao que identifica a Pena no sistema.
401
E3Chart
Aba Geral
Cada campo da aba Geral possui uma propriedade ou mtodo correspondente. As

opes disponveis esto descritas na tabela a seguir.
OPO
Nome
E3Chart
DESCRIO
Determi na o nome do Ei xo do gr fi co.
Name do Ei xo.
402
OPO
Posio
Espelhar o eixo
Ttulo do eixo
Cor da escala
Visvel
Texto na cor da escala
Cor das linhas da grade

Estilo da linha
Mostrar as linhas na grade
Intervalo entre divises
Automtico
Nmero de subdivises
DESCRIO
Determi na a pos i o do Ei xo no gr fi co:
Direita ou Esquerda (Ei xo verti ca l ), Base ou
Topo (Ei xo hori zonta l ). Es te ca mpo
equi va l e propri eda de Position do Ei xo.
Mos tra o Ei xo ta mbm do l a do opos to a o
es col hi do, com efei to de es pel ho. Es te
ca mpo equi va l e propri eda de Mirror do
Ei xo.
Determi na o ttul o do Ei xo. Es te ca mpo
equi va l e propri eda de Title do Ei xo.
Determi na a cor da es ca l a . Es te ca mpo
corres ponde propri eda de Color do
objeto Ei xo.
Determi na a vi s i bi l i da de do Ei xo no
propri eda de Visible do Ei xo.
Determi na s e a cor do texto do Ei xo tem a
mes ma cor da es ca l a . Es te ca mpo
equi va l e propri eda de EnableTextColor
do Ei xo.
Determi na a cor da s l i nha s na gra de.
GridColor do Ei xo.
Determi na o es ti l o da l i nha da gra de do
propri eda de GridStyle do Ei xo.
Ha bi l i ta a vi s ua l i za o da s l i nha s na
gra de. Es te ca mpo equi va l e
propri eda de ShowGrid do Ei xo.
Determi na o i nterva l o entre os
ma rca dores da es ca l a , ca s o a op o
Automtico es teja des a bi l i ta da . Se a
es ca l a n o for numri ca , pos s vel
s el eci ona r a uni da de de tempo a que
es te i nterva l o s e refere. Es te ca mpo
equi va l e a o mtodo SetTickSpacing do
Ei xo.
Sel eci ona a utoma ti ca mente o i nterva l o
entre os ma rca dores da es ca l a . Es te
ca mpo equi va l e a o mtodo SetTickSpacing
do Ei xo, com 0 (zero) no va l or do
i nterva l o.
Determi na o nmero de s ubdi vi s es
entre os ma rca dores . Es te ca mpo
equi va l e propri eda de MinorTicks do
Ei xo.
Clique em Aplicar para visualizar as modificaes feitas nesta janela, e em OK para

403
E3Chart
salv-las.
A aba Escala define as configuraes da escala do Eixo.
Aba Escala
Cada campo da aba Escala possui uma propriedade ou um mtodo correspondente.

As opes disponveis esto descritas na tabela a seguir.
E3Chart
404
Opes disponveis na aba Escala

OPO
Escala numrica
Mostrar ltimo perodo (tempo real)
Intervalo de tempo (histrico)
Inverter Escala
Formatao
DESCRIO
Defi ne o Ei xo como s endo uma es ca l a
numri ca . Es te ca mpo equi va l e
propri eda de ScaleType do Ei xo. As opes
de confi gura o da es ca l a numri ca s o a s
s egui ntes :
Mnimo: Determi na o va l or mni mo da
es ca l a numri ca . Es te ca mpo equi va l e a o
mtodo SetMinMax do Ei xo
Mximo: Determi na o va l or m xi mo da
es ca l a numri ca . Es te ca mpo equi va l e a o
mtodo SetMinMax do Ei xo
Mos tra o i nterva l o de tempo que o Ei xo
mos tra , s empre em rel a o hora a tua l .
Es te ca mpo equi va l e a o mtodo
SetRealTimePeriod do Ei xo.
Determi na um i nterva l o de tempo fi xo. As
opes de confi gura o s o a s s egui ntes :
Do dia: Da ta e hora i ni ci a i s do i nterva l o
At o dia: Da ta e hora fi na i s do i nterva l o
Selecionar: Sel eci ona o i nterva l o de
tempo
Es te ca mpo corres ponde a o mtodo
SetHistoricPeriod do Ei xo.
Inverte os va l ores da es ca l a s el eci ona da .
Determi na a forma ta o dos va l ores do
Ei xo, que pode s er a utom ti ca ou
pers ona l i za da . Es te ca mpo corres ponde
propri eda de Format do Ei xo. Pa ra ma i ores
i nforma es s obre forma tos , cons ul te o
tpi co Formatao de Valores.
Clique em Aplicar para visualizar as modificaes feitas nesta janela, e em OK para

salv-las.
19.1.3 Aba Penas

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

Opes disponveis na aba Penas
OPO
DESCRIO
Adi ci ona uma Pena . Mos tra um menu
que permi te es col her o ti po de Pena
que cri a da : Tempo Real, Histrica ou
Tempo Real & Histrica.
Remove a s Pena s s el eci ona da s .
Abre a ja nel a de propri eda des da Pena
s el eci ona da (es ta opera o s
permi ti da s e a pena s uma Pena es ti ver
s el eci ona da ).
Move a Pena s el eci ona da uma pos i o
pa ra ci ma (es ta opera o s permi ti da
s e a pena s uma Pena es ti ver
s el eci ona da ).
Move a Pena s el eci ona da uma pos i o
pa ra ba i xo (es ta opera o s
permi ti da s e a pena s uma Pena es ti ver
s el eci ona da ).
A listagem de Pena s do E3Chart permite copiar e colar Pena s , tanto no mesmo

E3Chart
406
E3Chart quanto entre E3Charts diferentes. Clique com o boto direito do mouse na
Pena desejada (ou nas Pena s selecionadas, em caso de mltipla seleo) e
selecione a opo Copiar (CTRL + C). No E3Chart de destino, abra a janela de
Propriedades e, na aba Penas, clique com o boto direito do mouse na listagem de
Pena s e selecione a opo Colar (CTRL + V). A opo de Recortar a Pena (CTRL + X)
tambm est presente. No caso de o E3Chart de destino j possuir uma Pena com o
mesmo nome da Pena sendo copiada, o nome automaticamente incrementado.
Algumas propriedades da Pena podem ser configuradas diretamente na lista
mostrada na aba Penas. Na coluna Estilo, ao clicar em , a janela da figura a
seguir mostrada.
Estilo da Pena

Opes disponveis na janela Estilo da Pena
OPO
Cor principal
Cor do fundo
Tipo de desenho
407
DESCRIO
Defi ne a cor da l i nha da Pena . Equi va l e
propri eda de Color.
Defi ne a cor de fundo us a da em uma
Pena do ti po rea. Equi va l e
propri eda de BkColor.
Defi ne o ti po de des enho da Pena :
Linhas, Pontos, Linhas e Pontos ou rea.
Equi va l e propri eda de PenType.
E3Chart
OPO
Estilo do trao
Espessura da linha
Amostra
DESCRIO
Defi ne o ti po de l i nha : Slida, Tracejada,
Pontilhada, Trao-Ponto, Trao-Ponto-Ponto
ou Sem Linha. Equi va l e propri eda de
PenStyle.
Defi ne a es pes s ura da l i nha . Equi va l e
propri eda de Width.
Mos tra um exempl o de como a Pena
des enha da no E3Cha rt.
Ao selecionar uma Pena e clicar em , a janela de Propriedades da Pena

mostrada. Ela possui cinco abas: Geral, Dados, Estilo, Modo de Ligao e Estatsticas.
A aba Geral contm as informaes que identificam a Pena no sistema.
E3Chart
408
Aba Geral

OPO
Nome da Pena
Cor principal
409
DESCRIO
Indi ca o nome da Pena . Es te ca mpo
equi va l e propri eda de Name da Pena .
Determi na a cor da l i nha da Pena . Es te
ca mpo equi va l e propri eda de Color da
Pena .
E3Chart
OPO
Visvel
Unidade de Engenharia
DESCRIO
Indi ca o es ta do de vi s i bi l i da de da Pena
no gr fi co. Es te ca mpo equi va l e
propri eda de Visible da Pena .
Indi ca a uni da de de engenha ri a
uti l i za da pel a Pena . Es te ca mpo equi va l e
propri eda de EU da Pena .
A aba Dados contm informaes de acordo com o tipo da Pena.
Aba Dados
E3Chart
410
Cada campo da aba Dados possui uma propriedade correspondente. As opes

Opes disponveis na aba Dados
OPO
Tipo de pena
Link do eixo vertical
Link do eixo horizontal
Nmero de amostras mantidas na memria
Usar a estampa de tempo
Consulta local
Consulta externa
Campo do eixo vertical
Campo do eixo horizontal
Usar consulta automtica
411
DESCRIO
Determi na o ti po de Pena s endo
uti l i za da . Es te ca mpo equi va l e
propri eda de DataSourceType da Pena .
Nome da As s oci a o us a da pa ra pl ota r o
da do em uma es ca l a verti ca l . Es te ca mpo
equi va l e propri eda de YLink da Pena .
Nome da As s oci a o us a da pa ra pl ota r o
da do em uma es ca l a hori zonta l . Es te
ca mpo equi va l e propri eda de XLink da
Pena .
Determi na o nmero de a mos tra s na s
Pena s de tempo rea l . Es te ca mpo
equi va l e propri eda de BufferSize da
Pena .
Ha bi l i ta ou des a bi l i ta a es ta mpa de
tempo. A es ta mpa de tempo o va l or de
tempo que a compa nha o va l or do Ta g,
i ndi ca ndo o momento em que es te va l or
foi a l tera do. Es te ca mpo equi va l e
propri eda de UseTimeStamp da Pena . Se
es te ca mpo es ti ver ha bi l i ta do, a op o
Link do Eixo Horizontal fi ca i na ti va .
Determi na a Cons ul ta vi ncul a da a o
E3Cha rt que uti l i za da nos da dos do
Ei xo. Es te ca mpo equi va l e propri eda de
QueryName da Pena .
Determi na a cons ul ta externa , i s to , os
da dos vm de uma cons ul ta fora do
objeto E3Cha rt.
Nome do ca mpo da Cons ul ta us a do pa ra
pl ota r o da do em uma es ca l a verti ca l .
YField da Pena .
Nome do ca mpo da Cons ul ta us a do pa ra
pl ota r o da do em uma es ca l a hori zonta l .
XField da Pena .
Indi ca s e a Pena deve ou n o us a r
cons ul ta a utom ti ca . A cons ul ta
a utom ti ca n o uti l i za da s e o E3Cha rt
es ti ver uti l i za ndo um cdi go SQL
pers ona l i za do, s e es ti ver us a ndo um
Stora ge, ou s e pos s ui r v ri a s ta bel a s .
AutoQuery da Pena .
E3Chart
OPO
DESCRIO
Es peci fi ca o Ei xo verti ca l . Es te ca mpo
equi va l e propri eda de ScaleY da Pena .
Es peci fi ca o Ei xo hori zonta l . Es te ca mpo
equi va l e propri eda de ScaleX da Pena .
Eixo vertical
Eixo horizontal
A aba Estilo determina o estilo da Pena.
Aba Estilo
Cada campo da aba Estilo possui uma propriedade correspondente. As opes

E3Chart
412
Opes disponveis na aba Estilo

OPO
Tipo de desenho
Estilo do trao
Espessura da linha
Cor do fundo
Documentao
Habilita alarme alto
Habilita alarme baixo
Cor de alarme
Cor de fundo do alarme
DESCRIO
Indi ca o ti po de des enho da Pena . Es te
ca mpo equi va l e propri eda de PenType
da Pena .
Determi na o es ti l o do tra o da Pena . Es te
ca mpo equi va l e propri eda de PenStyle
da Pena .
Determi na a es pes s ura da l i nha , em
pi xel s . Es te ca mpo equi va l e
propri eda de Width da Pena .
Determi na a cor de fundo da l i nha . Es te
ca mpo equi va l e propri eda de BkColor da
Pena .
Determi na a documenta o que pode s er
mos tra da na Legenda . Es te ca mpo
equi va l e propri eda de DocString da
Pena .
Ha bi l i ta a veri fi ca o do a l a rme a l to.
Es te ca mpo corres ponde propri eda de
EnableHighLimit da Pena . A ca i xa de texto
a o l a do pos s i bi l i ta es ta bel ecer o l i mi te
des te a l a rme, que equi va l e
propri eda de HighLimit.
Ha bi l i ta a veri fi ca o do a l a rme ba i xo.
EnableLowLimit da Pena . A ca i xa de texto
a o l a do pos s i bi l i ta es ta bel ecer o l i mi te
des te a l a rme, que equi va l e
propri eda de LowLimit.
Cor da Pena qua ndo em a l a rme. Es te
LimitPenColor.
Cor do fundo da Pena qua ndo em a l a rme.
LimitPenBkColor.
A aparncia da Pena, conforme a opo configurada, pode ser visualizada a seguir.
413
E3Chart
Modo analgico de ligao entre os pontos
Modo digital de ligao entre os pontos
O modo como a Pena apresentada quando o scan considerado

representado pela cor verde e quando este campo est desabilitado
representado pelas cores azul e rosa
A aba Modo de Ligao determina o estilo da ligao entre a parte histrica e a

parte de tempo real de uma Pena mista.
E3Chart
414
Aba Modo de Ligao
415
E3Chart
Opes disponveis na aba Modo de Ligao

OPO
Modo de ligao entre os pontos
Valor considerado para o scan (ms)
Mostrar os pontos de qualidade ruim
Intervalo mximo para ligar os dados

histricos aos de tempo real (s)
Realar linha quando MaxGapTime usado
Cor da linha usada com MaxGapTime

Estilo da linha usada com MaxGapTime
DESCRIO
Defi ne o modo como os pontos entre a
pa rte hi s tri ca e a pa rte de tempo rea l
s o l i ga dos . Es te ca mpo equi va l e
propri eda de DigitalData. As opes
pos s vei s s o Digital, onde o tra a do
s empre ba s ea do em reta s s omente
hori zonta i s e verti ca i s , s ugeri ndo
va ri a o i ns ta nt nea , ou Analgico, onde
o tra a do bus ca uma reta uni ndo ca da
um dos pontos do gr fi co.
Defi ne o tempo de l ei tura es pera do do
Ta g da Pena de tempo rea l . Es te ca mpo
equi va l e propri eda de ScanValue da
Pena .
Defi ne s e mos tra ou n o os pontos de
qua l i da de rui m. Equi va l e propri eda de
ShowBadPoints da Pena .
Es peci fi ca um tempo l i mi te a s er
cons i dera do pa ra a conex o vi s ua l entre
a pa rte hi s tri ca e a pa rte de tempo rea l
de uma Pena mi s ta . Corres ponde
propri eda de MaxGapTime.
Rea l a a l i nha de l i ga o entre a pa rte
hi s tri ca e a pa rte de tempo rea l .
Corres ponde propri eda de
HighlightMaxGapTime da Pena .
Es peci fi ca a cor da l i ga o. Corres ponde
propri eda de MaxGapTimeColor da Pena .
Es peci fi ca o es ti l o da l i nha de l i ga o.
Corres ponde propri eda de
MaxGapTimeStyle da Pena .
A aba Estatsticas habilita o clculo de dados estatsticos.
E3Chart
416
Aba Estatsticas
Cada campo da aba Estatsticas possui uma propriedade correspondente. As opes

Opes disponveis na aba Estatsticas
OPO
Calcular dados estatsticos
Mostrar linha da mdia
Mostrar mnimo e mximo
417
DESCRIO
Ha bi l i ta o c l cul o de da dos es ta ts ti cos .
Exi be a l i nha da mdi a dos da dos
es ta ts ti cos .
Exi be o mni mo e o m xi mo dos da dos
es ta ts ti cos .
E3Chart
19.1.4 Aba Legenda

A Legenda utilizada para exibir as Penas visveis no grfico e informaes sobre
elas, tais como cor, nome da Pena, estado, etc.
Objeto Legenda em tempo de execuo
Atravs da aba Legenda, possvel configurar as informaes referentes ao objeto

Legenda e suas colunas.
E3Chart
418
Propriedades do objeto Legenda
Alguns campos da aba Legenda possuem uma propriedade ou mtodo

correspondente. As opes disponveis esto descritas na tabela a seguir.
Opes disponveis na aba Legenda
OPO
Mostrar Legenda
Tamanho
Cor do fundo
Colunas disponveis
Colunas selecionadas
419
DESCRIO
Ha bi l i ta a vi s ua l i za o da Legenda . A
ca i xa de s el e o a o l a do des te ca mpo
defi ne o pos i ci ona mento da Legenda .
Visible da Legenda , e o ca mpo de s el e o
da pos i o da Legenda equi va l e
propri eda de LegendPos da Legenda .
Determi na o ta ma nho da Legenda , em
pi xel s . Pode s er a a l tura ou a l a rgura ,
dependendo da pos i o. A outra
di mens o a compa nha a do E3Cha rt. Es te
ca mpo corres ponde propri eda de Size
da Legenda .
Determi na a cor de fundo da Legenda .
BackColor da Legenda .
Li s ta a s col una s di s ponvei s pa ra
vi s ua l i za o na Legenda .
Mos tra a s col una s s el eci ona da s pa ra a
Legenda .
E3Chart
OPO
DESCRIO
Adi ci ona uma col una Legenda . Es ta
op o equi va l e a o mtodo InsertColumn
da Legenda .
Abre uma ca i xa de di l ogo pa ra a
confi gura o da s propri eda des dos
ca mpos da s col una s da Legenda .
Remove a col una s el eci ona da da
Legenda . Es ta op o equi va l e a o
mtodo RemoveColumn da Legenda .
Troca a pos i o da col una na Legenda .
Es ta s opes equi va l em a o mtodo
ChangeColumnPos da Legenda .
Ha bi l i ta o ca bea l ho da Legenda . Es te
ShowHeader da Legenda .
Determi na s e a cor do texto da Legenda
a mes ma da Pena . Es te ca mpo equi va l e
propri eda de EnableTextColor da Legenda .
Adicionar
Propriedades
Remover
Sobe e Desce
Mostrar ttulos das colunas
Mostrar texto na cor da pena
Os campos da listagem Colunas disponveis esto descritos na tabela a seguir.

Opes disponveis para identificao de colunas
1
Este valor pode ser usado diretamente nos mtodos InsertColumn (parmetro Col), Item e
RemoveColumn
OPO
Cor da Pena
VALOR1
6
NOME
Color
Descrio da Pena
Description
DifX
15
DiffX
DifY
16
DiffY
EscalaX
ScaleX
EscalaY
ScaleY
Estado
Status
E3Chart
DESCRIO
Mos tra a cor da
Pena .
Mos tra a des cri o
conti da na
propri eda de
DocString da Pena .
Mos tra a di ferena
entre os curs ores
i ni ci a l e fi na l .
Mos tra a di ferena
no Ei xo Y entre os
pontos i nterpol a dos
i ni ci a l e fi na l .
Mos tra o nome do
Ei xo X a s s oci a do
Pena .
Mos tra o nome do
Ei xo Y a s s oci a do
Pena .
Mos tra o es ta do de
funci ona mento
a tua l da Pena .
420
OPO
NOME
FimX
VALOR1
14
XEnd
FimY
18
YEnd
IncioX
13
XBegin
IncioY
17
YBegin
MximoY
12
MaxY
MdiaY
10
AverageY
MnimoY
11
MinY
Nome da pena
Name
Nome do tag X
TagX
Nome do tag Y
TagY
Unidade
19
EU
Valor do tag X
TagXValue
Valor do tag Y
TagYValue
DESCRIO
Mos tra a pos i o
fi na l do curs or.
Mos tra o ponto
i nterpol a do onde o
curs or fi na l cruza
com a Pena .
Mos tra a pos i o
i ni ci a l do curs or.
Mos tra o ponto
i nterpol a do onde o
curs or i ni ci a l cruza
com a Pena .
Mos tra o va l or
m xi mo da Pena no
i nterva l o.
Mos tra o va l or
mdi o da Pena no
i nterva l o.
Mos tra o va l or
mni mo da Pena no
i nterva l o.
Mos tra o nome da
Pena .
Mos tra o nome do
Ta g a s s oci a do a o
Ei xo X.
Mos tra o nome do
Ta g a s s oci a do a o
Ei xo Y.
Mos tra a uni da de
de engenha ri a
uti l i za da pel a Pena .
Mos tra o va l or da
pes qui s a no Ei xo X.
Mos tra o va l or da
pes qui s a no Ei xo Y.
Ao clicar em Propriedades, mostrada uma caixa de dilogo para configurao do

objeto Coluna da Legenda.
421
E3Chart
Propriedades da coluna
Cada campo da caixa de dilogo Propriedades da coluna possui uma propriedade

correspondente. As opes disponveis esto descritas na tabela a seguir.
Opes disponveis na janela Propriedades da coluna
OPO
Largura inicial
Ttulo da coluna
Alinhamento do texto
Formatador
DESCRIO
Defi ne a l a rgura i ni ci a l da Col una , em
pi xel s . Es te ca mpo equi va l e
propri eda de Width da Col una da
Legenda .
Determi na o ttul o da Col una . Es te ca mpo
equi va l e propri eda de Caption da
Col una da Legenda .
Determi na o a l i nha mento do texto na
Col una da Legenda , Es te ca mpo equi va l e
propri eda de TextAlign da Col una da
Legenda .
Determi na o forma ta dor da Col una
s el eci ona da . Es te ca mpo equi va l e
propri eda de Format da Col una da
Legenda .
19.1.5 Aba Consultas

As Consultas so necessrias para mostrar valores histricos no E3Chart. Atravs
da aba Consultas possvel adicionar ou remover Consultas, bem como configurlas.
E3Chart
422
Aba Consultas

Opes disponveis na aba Consultas
OPO
Consultas
Configurar
Adicionar
Remover
DESCRIO
Mos tra a Cons ul ta s el eci ona da pa ra
edi o.
Confi gura a Cons ul ta s el eci ona da .
Adi ci ona uma nova Cons ul ta . Pa ra obter
ma i ores i nforma es referentes s
Cons ul ta s , veja o ca ptul o Consultas.
Remove a Cons ul ta s el eci ona da .
NOTA: Ao cl i ca r em Adicionar ou Configurar, uma ca i xa de di l ogo a berta pa ra

es peci fi ca o do Servi dor de Ba nco de Da dos que gua rda a Cons ul ta . Os
procedi mentos de defi ni o da Cons ul ta podem s er encontra dos no ca ptul o
Consultas.
19.1.6 Aba Fonte

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

NOTA: O nome da a ba a pa rece s empre no i di oma do Wi ndows .
19.2 Exemplos de Utilizao

Os tpicos a seguir mostram alguns exemplos de utilizao do E3Chart.
19.2.1 Habilitando e Desabilitando Penas

O exemplo a seguir demonstra como habilitar ou desabilitar a conexo dos dados
de uma Pena no E3Chart. Para tanto, siga estes procedimentos:
1. Crie um E3Chart na Tela.
2. Abra a janela de propriedades do E3Chart e selecione a aba Penas. Crie uma
nova Pena de tempo real e associe-a a um Tag Demo no Eixo vertical.
3. Crie dois botes de comando na Tela. No primeiro boto de comando, escreva
na propriedade Caption a descrio "Desabilitar Pena".
4. Abra a janela de propriedades deste boto e selecione a aba Scripts. No evento
Click, escreva o seguinte script:
Set Pen1= Screen.Item("E3Chart1").Pens.Item("Pena1")
E3Chart
424
Pen1.Disconnect()
End Sub
5. No segundo boto de comando, escreva na propriedade Caption a descrio

"Habilitar Pena".
Pen1.Connect()
End Sub
7. Execute o projeto e verifique o resultado.
19.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 se tenha uma Consulta a uma
tabela do Banco de Dados previamente criada.
2. Abra a janela de propriedades do E3Chart e selecione a aba Eixos. Clique na
opo Configurar do Eixo horizontal e, na aba Escala, selecione a opo
Intervalo de tempo (Histrico).
3. Selecione a aba Consultas e clique em Adicionar. O Studio mostra uma caixa de
dilogo para que se indique o nome do servidor de Banco de Dados em que a
tabela da consulta est armazenada.
4. Selecione o servidor de Banco de Dados na caixa de dilogo e clique em OK. O
Studio abre a janela de configuraes da Consulta.
5. Selecione na tabela histrica o campo E3TimeStamp e algum outro campo de
dados para mostrar no grfico.
6. No campo E3TimeStamp, crie um filtro conforme as especificaes a seguir.
425
E3Chart
Filtro a ser criado no campo E3TimeStamp
7. Aps ter criado o filtro conforme as especificaes anteriores, clique em OK.

8. Crie uma nova Pena. Abra a janela de propriedades desta Pena e, na aba Dados,
item Tipo de Pena, selecione a opo Histrica usando a Consulta e indique o
campo da Consulta configurada.
9. No item Campo do eixo vertical, indique um campo da tabela. No item Campo do
eixo horizontal, indique o campo E3TimeStamp. Clique em OK.
10. Crie um novo boto na Tela e, na propriedade Caption, escreva "Atualizar
E3Chart Histrico".
11. Selecione a aba Scripts deste boto e, no evento Click, escreva o seguinte cdigo:
Set Chart = Screen.Item("E3Chart1")
Set Consulta = Chart.Item("Consulta1")
Consulta.SetVariableValue "Ini", Now 1 / 24
Consulta.SetVariableValue "Fim", Now
Chart.HorScaleBegin = Now 1 / 24
Chart.HorScaleEnd = Now
Chart.Queries.UpdateData()
End Sub
E3Chart
426
19.2.3 Habilitando ou Desabilitando a Visualizao da

Pena
O exemplo a seguir demonstra como habilitar ou desabilitar a visualizao de uma
Pena no E3Chart. Para tanto, siga estes procedimentos:
2. Abra a janela de propriedades do E3Chart e selecione a aba Penas. Crie uma
nova Pena de tempo real e associe-a a um Tag Demo, no Eixo vertical.
3. Crie dois botes na Tela. No primeiro, mude a propriedade Caption para
"Desabilitar Visualizao da Pena".
Pen1.Visible = False
End Sub
5. No segundo boto de comando, mude a propriedade Caption para "Habilitar

Visualizao da Pena".
Set Pen1 = Screen.Item("E3Chart1").Pens.Item("Pena1")
Pen1.Visible = True
End Sub
19.2.4 Criao de uma Pena por Script

O exemplo a seguir demonstra como criar uma Pena por script. Para tanto, siga
2. Crie um boto de comando na Tela. Na propriedade Caption, digite o texto
"Criar Pena".
3. Abra a janela de propriedades deste boto de comando e selecione a aba
Scripts. Digite o script a seguir no evento Click.
Sub Texto1_Click()
Set E3Chart1 = Screen.Item("E3Chart1")
MsgBox "Clique OK para criar a Pena"
Set Pen = E3Chart1.Pens.AddPen("Pen1")
427
E3Chart
Pen.DataSourceType = 0 ' Tempo real

Pen.VerDataSource = "Dados.TagDemo1"
Pen.UseTimeStamp = True ' No X usa o timestamp
Pen.Color = RGB(255, 0, 0)
Pen.DocString = "teste"
MsgBox "Clique OK para conectar"
Pen.Connect() ' Comea a receber os dados
MsgBox "Clique OK para enquadrar"
E3Chart1.FitPen(0)
MsgBox "Clique OK para desconectar"
Pen.Disconnect() ' Para de receber os dados
MsgBox "Clique OK para remover a Pena"
E3Chart1.Pens.Remove(Pen.Name)
End Sub
19.3 Caractersticas Especficas de Runtime

O E3Chart possui uma srie de caractersticas que se aplicam apenas em tempo de
execuo. Estas caractersticas so explicadas nos tpicos a seguir.
19.3.1 Opes do Ponteiro do Mouse

Clicando na legenda do grfico, possvel redimensionar suas colunas. Para tanto,
selecione a coluna desejada e arraste-a.
19.3.2 Opes do Menu Contextual

Clicando com o boto direito do mouse no grfico do E3Chart, abre-se o menu de
opes mostrado na figura a seguir.
E3Chart
428
Opes do menu do E3Chart em tempo de

execuo

Opes disponveis do menu contextual do E3Chart em tempo de execuo
OPO
Caixa de zoom
Mover
Mover horizontalmente
Pesquisar
Pesquisar Intervalos
Menos Zoom
Mais Zoom
Enquadrar tudo
Enquadrar verticalmente
Enquadrar horizontalmente
Enquadrar Pena
429
DESCRIO
Col oca o mous e no modo zoom por rea
s el eci ona da . Es ta op o es t di s ponvel
nos gr fi cos de es ca l a numri ca em XY e
es ca l a fi xa .
Col oca o mous e em modo de
movi menta o da s es ca l a s .
Col oca o mous e em modo de
movi menta o da s es ca l a s s omente na
di re o hori zonta l .
Col oca o mous e em modo de pes qui s a
de va l ores nos da dos da s Pena s .
Ha bi l i ta a op o de pes qui s a de
i nterva l os de tempo.
Di mi nui o zoom de todo o Ei xo.
Aumenta o zoom de todo o Ei xo.
Enqua dra a Pena s el eci ona da em a mbos
os Ei xos .
Enqua dra a Pena s el eci ona da s omente
no Ei xo verti ca l .
Enqua dra a Pena s el eci ona da s omente
no Ei xo hori zonta l .
Enqua dra a Pena s el eci ona da ou toda s
a s Pena s exi s tentes .
E3Chart
19.3.3 Opo Pesquisar

Esta opo permite pesquisar valores dos pontos das Penas. O valor mostrado na
legenda, atravs das colunas Valor do Tag X e Valor do Tag Y.
A pesquisa mostrada nos campos Valor do TagX e Valor do TagY

NOTA: Pa ra obter ma i ores i nforma es s obre a s col una s Valor do Tag X e Valor do Tag
Y, veja o tpi co Configuraes da Legenda.
19.3.4 Opo Pesquisar Intervalos

Neste modo so mostrados dois cursores, que definem o intervalo de clculos
estatsticos. Os valores dos cursores so mostrados nas colunas IncioX, IncioY,
FimX e FimY. Para alterar a posio de um cursor, selecione-o clicando com o
boto esquerdo do mouse e arraste-o para a posio desejada.
E3Chart
430
Pesquisa de intervalos
19.3.5 Coluna Estado da Legenda

A coluna Estado da legenda mostra o estado atual de cada Pena. O contedo desta
mensagem composto por uma informao de erro, se houver, e informaes sobre
a situao atual da Pena, como por exemplo o nmero de pontos. As tabelas a
seguir mostram as possveis mensagens de erro e de informao para Penas de
Tempo Real e Histricas. Se a Pena do tipo Mista, a mensagem final uma
combinao da mensagem da parte de Tempo Real e Histrica. Caso haja
mensagens de erro, a linha da coluna mostrada em vermelho enquanto o erro
persistir.
Mensagens de status da parte de tempo real
MENSAGEM
Erro: Parte de tempo real desconectada
(YLink='Nome do Tag') (XLink='Nome do
Tag')
Info: Tempo real n pts
431
SIGNIFICADO
N o houve conex o da pa rte de tempo
rea l da Pena . Veri fi que o nome dos Ta gs
na s propri eda des YLink e XLink da Pena .
Mos tra o nmero tota l de pontos da
pa rte de tempo rea l .
E3Chart
Mensagens de status da parte histrica

MENSAGEM
Info: Consulta aguardando
Info: Consulta inicializando
Erro: Consulta: Falha na inicializao
Erro: Campo no encontrado (XField = 'Nome

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

do Campo')
Erro: 'Nome da Consulta' 'Mensagem de Erro'
Info: n pts
Info: Carregando
Erro: Consulta invlida (QueryName = 'Nome
da Consulta')
SIGNIFICADO
Agua rda ndo a i ni ci a l i za o da cons ul ta .
Si gni fi ca que a l guma muda na ou
pedi do de a tua l i za o da cons ul ta foi
detecta do.
A cons ul ta es t i ni ci a ndo. Nes ta fa s e
s o va l i da dos os ca mpos i nforma dos na
Pena .
Antes de ca rrega r os da dos da cons ul ta ,
o E3Cha rt preci s a conhecer os ca mpos
que a cons ul ta contm pa ra rea l i za r a
a s s oci a o entre es tes ca mpos e a s
propri eda des XField e YField. Ocorreu uma
fa l ha a o bus ca r es tes ca mpos , que pode
s er ta nto um erro de rede qua nto um erro
de s i nta xe SQL.
O ca mpo i nforma do na propri eda de
XField n o foi encontra do na cons ul ta .
Veri fi que s e o ca mpo es t s el eci ona do
na tel a de edi o da cons ul ta ou no
cdi go SQL.
O ca mpo i nforma do na propri eda de
YField n o foi encontra do na cons ul ta .
Veri fi que s e o ca mpo es t s el eci ona do
na tel a de edi o da cons ul ta ou no
cdi go SQL.
Indi ca que houve um erro na cons ul ta ,
n o s endo pos s vel recupera r os da dos .
As pos s vei s mens a gens mos tra da s em
Mensagem de Erro s o des cri ta s na ta bel a
a s egui r.
Mos tra o nmero tota l de pontos da
pa rte hi s tri ca .
Indi ca que os da dos da cons ul ta a i nda
es t o s endo ca rrega dos do s ervi dor.
A cons ul ta i ndi ca da pel a propri eda de
QueryName da Pena n o foi encontra da
pel o E3Cha rt.
Mensagens especficas para falha na consulta

MENSAGEM
Falha ao inserir dados
Falha na criao da consulta
E3Chart
SIGNIFICADO
N o foi pos s vel ca rrega r os da dos pa ra a
memri a .
N o foi pos s vel cri a r a cons ul ta .
432
MENSAGEM
Erro ao executar a consulta
Falha ao baixar os dados do servidor
Falha ao pegar o nmero de registros do
servidor
Falha ao posicionar o cursor para o incio
Cursor ocupado
Falha ao pegar os dados do servidor
Erro desconhecido
433
SIGNIFICADO
N o foi pos s vel executa r a cons ul ta .
N o foi pos s vel tra zer do s ervi dor os
res ul ta dos da cons ul ta .
N o foi pos s vel tra zer do s ervi dor o tota l
de regi s tros exi s tentes na cons ul ta .
N o foi pos s vel pos i ci ona r o curs or no
pri mei ro regi s tro da cons ul ta .
Os regi s tros da cons ul ta n o es t o
di s ponvei s pa ra s erem tra zi dos do
s ervi dor.
N o foi pos s vel tra zer do s ervi dor os
regi s tros da cons ul ta .
Houve um erro i nes pera do a o tenta r
tra zer do s ervi dor os da dos da cons ul ta .
E3Chart
CAPTULO
20
E3Playback
Uma ferramenta de playback visa facilitar o ps-operao, sobretudo a anlise de

ocorrncias. Sua necessidade justificada por permitir que o usurio visualize,
atravs das telas de monitoramento em tempo real, as variaes de eventos e
pontos analgicos em tempo passado que, em determinados casos, pode ser
complicado observando apenas relatrios de eventos e valores analgicos.
Cabe ressaltar que um playback uma ferramenta que permite a um operador
experiente e conhecedor do processo interpretar os acontecimentos de forma mais
clara. No faz parte do escopo de um playback a identificao automtica de
soluo ou de causa de uma ocorrncia.
Um exemplo prtico de uso de um playback pode ser o seguinte:
O usurio, ao chegar em seu horrio de trabalho, recebe a informao de uma grave
ocorrncia acontecida durante a madrugada, por volta das 3h15min. Ele pode ento
abrir na ferramenta de playback uma tela que contm o ponto gerador do evento e
outros pontos relacionados, movendo o relgio para as 03h10min e clicando em Play.
Ao observar a tela sendo animada com os dados histricos, o usurio facilmente
acompanha o estado geral do processo, avanando e retrocedendo livremente no
tempo at compreender perfeitamente a causa da ocorrncia.
20.1 Objeto E3Playback

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

Este exemplo mostra como adicionar funcionalidades de playback ao aplicativo de
demonstrao que vem junto com a instalao do E3.
1. Crie uma nova Tela, chamada "TelaPlayback", e insira um ActiveX E3Playback
ocupando toda a rea de fundo da Tela.
E3Playback
434
Incluso do E3Playback em uma Tela
2. Abra a Lista de Propriedades e configure a propriedade DBServer do

E3Playback para apontar para o objeto Banco de Dados que contm os dados
histricos do aplicativo.
Selecionando um Banco de Dados
3. Abra a Lista de Propriedades e configure a propriedade InitialScreen do

E3Playback para apontar para o Quadro "FrameApp".
435
E3Playback
Selecionando um Quadro para a propriedade InitialScreen
4. Abra a Tela "UpperMenu" e insira a imagem Stopwatch no canto superior

direito (abra a Galeria e selecione a categoria Misc Symbols 1).
Tela UpperMenu
5. Clique duas vezes na imagem Stopwatch, adicione o Pick Abrir Tela no evento
Click para abrir a "TelaPlayback" no Quadro principal e configure-o conforme
as figuras a seguir.
E3Playback
436
Pick Abrir Tela
437
E3Playback
Configuraes do estilo da janela
6. Execute o aplicativo, abra o Viewer, clique em Portugus, depois em Preview de

Aplicaes, e finalmente clique no cone Stopwatch. Neste momento deve
aparecer a Tela de playback.
E3Playback
438
Tela de playback
7. Clique em para entrar no modo Online. Os primeiros dados de playback so

carregados, e o relgio de playback posicionado no centro dos dados
disponveis.
439
E3Playback
Tela de playback em modo Online
20.3 Interface de Usurio

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

A Barra de Ferramentas Playback rene os principais comandos para operao do
E3Playback.
Barra de ferramentas Playback
E3Playback
440
Esta barra de ferramentas possui as opes descritas na tabela a seguir.

Opes disponveis na barra de ferramentas Playback
CONE
COMANDO
Reproduzir para trs
Pausa
Reproduzir
Parar
Mais devagar
Velocidade normal
Mais rpido
Seletor de velocidade
441
AO
Ini ci a a reprodu o
dos da dos no hor ri o
a tua l de playback,
retrocedendo o rel gi o
de a cordo com a
vel oci da de de
reprodu o a tua l .
Congel a o rel gi o de
playback no tempo
a tua l .
Ini ci a a reprodu o
dos da dos no hor ri o
a tua l de playback,
a va na ndo o rel gi o
de a cordo com a
vel oci da de de
reprodu o a tua l .
Interrompe o playback,
os da dos de Ta gs e
a l a rmes s o
removi dos da s Tel a s e
nenhuma nova
cons ul ta fei ta a o
ba nco de da dos .
Di mi nui a vel oci da de
de playback pel a
meta de. O va l or
mni mo 1/1024x, i s to
, a va na
a proxi ma da mente um
mi l i s s egundo de
da dos a ca da s egundo.
Dei xa a vel oci da de de
playback no va l or
norma l (1x).
Dobra a vel oci da de de
playback. O va l or
m xi mo de 1024x,
i s to , a ca da s egundo
o rel gi o de playback
a va na 1024 s egundos
(a proxi ma da mente 17
mi nutos ).
Permi te s el eci ona r a
vel oci da de de playback.
E3Playback
CONE
COMANDO
Data e hora atual
Mostrar ou esconder a
Linha de Tempo
Lista de Tags
Lista de Eventos
Iniciar ou parar a
gravao de vdeo
Capturar a tela do
E3Playback
Ao selecionar a ferramenta Gravao de Vdeo

configuraes mostrada.
E3Playback
AO
Mos tra a da ta e hora
a tua l do rel gi o de
playback, e permi te
s el eci ona r uma nova
da ta .
Mos tra ou ocul ta a
ja nel a Li nha de Tempo
do E3Pl a yba ck.
ja nel a Ta gs do
E3Pl a yba ck.
ja nel a Eventos do
E3Pl a yba ck.
Permi te gera r um vdeo
(em forma to AVI)
ca ptura ndo toda a
rea do Acti veX de
playback dura nte um
determi na do perodo,
ou a t que o us u ri o
ma nde pa ra r a
gra va o.
Permi te ca ptura r a
rea de Tel a do Acti veX
de playback. A Tel a
ca ptura da pode s er
s a l va em um a rqui vo
BMP ou copi a da pa ra a
rea de Tra ns fernci a .
, a seguinte janela de
442
Janela Opes de gravao

Opes disponveis na janela Opes de gravao
OPO
Salvar vdeo como
Tempo mximo de gravao
443
DESCRIO
Mos tra o l oca l e o nome do a rqui vo de
vdeo a s er s a l vo. Pode-s e cl i ca r em
pa ra na vega r pel a s pa s ta s do
computa dor.
Permi te defi ni r um tempo tota l pa ra
gra va o. Se o va l or es ti ver em Indefinido, a
gra va o a pena s pa ra s e o bot o de
gra va o de vdeo do E3Pl a yba ck for
pres s i ona do. A op o Tempo permi te que
s eja pr-defi ni do um tempo m xi mo de
gra va o, em s egundos (nes te ca s o a
gra va o encerra da a utoma ti ca mente
a o fi na l do tempo es ti pul a do).
E3Playback
OPO
Quadros por segundo
Mostrar cursor na gravao
Compressor
Qualidade de compresso
Intervalo de quadros a cada quadro-chave

Configurar (compresso de vdeo)
Sobre
Gravar udio
Dispositivo
Formato
Atributos
Configurar (gravao de udio)
Mostrar resumo ao concluir gravao
E3Playback
DESCRIO
Confi gura o nmero de qua dros (frames)
ca ptura dos a ca da s egundo de gra va o.
Qua ndo es ta op o es ti ver ha bi l i ta da , o
curs or do mous e a pa rece no vdeo
gra va do. O pa dr o des ta op o
des a bi l i ta da . O pontei ro do mous e
gra va do no vdeo o que es ti ver
confi gura do como pa dr o do Wi ndows .
Pontei ros com a ni ma o n o s o
a ni ma dos no vdeo. Nes te ca s o,
mos tra do s empre o pri mei ro qua dro da
a ni ma o.
Compres s or de vdeo uti l i za do na
gra va o. S o l i s ta dos todos os
compres s ores que es t o i ns ta l a dos no
computa dor, des de que s eja m s uporta dos
pel o E3Pl a yba ck.
Confi gura a ta xa de compres s o, que
a feta a qua l i da de fi na l do vdeo e,
cons equentemente, o ta ma nho do a rqui vo
gera do.
Confi gura a qua nti da de de qua dros a
ca da qua dro-cha ve (key frame).
Abre uma nova ja nel a que pos s ui
confi gura es es pecfi ca s do compres s or
s el eci ona do.
Abre uma nova ja nel a que pos s ui
i nforma es s obre o compres s or
s el eci ona do.
Ha bi l i ta a gra va o de udi o. O pa dr o
des ta op o des a bi l i ta da .
Li s ta os di s pos i ti vos de udi o i ns ta l a dos
e ha bi l i ta dos no s i s tema , e que podem
s er uti l i za dos na ca ptura de udi o.
Mos tra i nforma es s obre o forma to de
udi o a tua l mente s el eci ona do.
Mos tra i nforma es s obre os a tri butos do
forma to de udi o a tua l mente
s el eci ona do.
Mos tra uma ja nel a que permi te a l tera r o
forma to de gra va o e os a tri butos do
udi o.
Ha bi l i ta ou des a bi l i ta a ja nel a que
mos tra da no momento em que a gra va o
fi na l i za da .
444
20.3.2 Linha de Tempo

A Linha de Tempo permite acompanhar visualmente e controlar o relgio de
playback.
Linha de tempo
As opes deste componente esto descritas na tabela a seguir.

Opes disponveis na Linha de Tempo
OPO
Rgua
Cursor
445
DESCRIO
Mos tra a l i nha de tempo. Pode-s e mover a
l i nha de tempo pa ra os l a dos cl i ca ndo e
a rra s ta ndo o mous e. O zoom control a do
pel a roda do mous e. Gi ra ndo pa ra ci ma ,
fei to um zoom in. Gi ra ndo pa ra ba i xo, zoom
out. neces s ri o pri mei ro cl i ca r no fundo
da l i nha de tempo a ntes de tenta r executa r
o zoom. Se a tecl a CTRL es ti ver pres s i ona da ,
o zoom fei to trs vezes ma i s r pi do.
Ma rca a pos i o a tua l do rel gi o de
playback. Qua ndo o playback es t no modo
Pausa pode-s e a rra s ta r o curs or pa ra os
l a dos , a l tera ndo o rel gi o de playback
enqua nto a rra s ta -s e o curs or. Es t s empre
vi s vel na l i nha de tempo.
E3Playback
OPO
Barra de Consultas
Barra de Dados
Barra de Zoom Geral
DESCRIO
Mos tra os perodos de tempo que j tm
da dos ca rrega dos :
Uma l i nha verde cl a ra s i gni fi ca que
na quel e perodo os da dos j es t o
tota l mente ca rrega dos
Uma l i nha verde es cura i ndi ca que os
da dos do perodo es t o s endo
ca rrega dos
Uma l i nha a ma rel a cl a ra i ndi ca que o
perodo contm a l guns da dos
ca rrega dos . Nova s cons ul ta s a o ba nco de
da dos s o neces s ri a s s e o curs or for
movi do pa ra ci ma do perodo
Uma l i nha ci nza cl a ra i ndi ca que o
perodo n o tem nenhum da do ca rrega do
a i nda . Pa ra ca rrega r os da dos do
perodo, mova o curs or de playback pa ra
ci ma do perodo
Indi ca com um ponto a zul ca da momento
em que h um evento de playback.
Mos tra o perodo de da dos que es t s endo
mos tra do na Li nha de Tempo, compa ra do
com o perodo tota l de da dos di s ponvel
pa ra playback.
Caso tenha sido selecionada a opo Mostrar grfico na Linha de Tempo de um Tag
na Lista de Eventos ou na Lista de Tags, mostrada uma representao visual do
Tag esquerda do grfico. Esta representao varia de acordo com o tipo de dados
do Tag:
String: Mostra caixas de texto com o nome do Tag
Booleano ou Digital: Mostra um grfico de estado do Tag, onde o valor do Tag
fica sempre sobre uma linha inferior (Off ou False) ou sobre uma linha
superior (On ou True). A linha do grfico fica pontilhada nos perodos em
que a qualidade do Tag est ruim
Double, Integer ou Analgico: Mostra um grfico de linha com os valores do
Tag. A escala do grfico (inferior e superior) calculada automaticamente de
acordo com os valores do Tag que o E3Playback j consultou no banco de
dados. Assim como no grfico digital, a linha do grfico fica pontilhada nos
perodos em que a qualidade do Tag est ruim. A linha tambm pode ser
interpolada ou em escada, dependendo se o Tag suporta (Storage) ou no
(Histrico) interpolao
E3Playback
446
Mostrar grfico na Linha de Tempo
Cada Tag adicionado na Linha de Tempo possui uma cor definida automaticamente,
que pode ser alterada usando a opo Alterar a cor do menu contextual. Esta opo
abre a janela de Cores do sistema, permitindo selecionar uma nova cor ou
personalizar a cor selecionada.
20.3.3 Marcadores
Os Marcadores so utilizados para sinalizar ocorrncias na linha de tempo do
E3Playback.
Marcadores
Opes disponveis na barra de ferramentas Marcadores
CONE
447
COMANDO
Adicionar marcador no
timestamp selecionado
AO
Adi ci ona um nome a o
ma rca dor na l i nha de
tempo, na da ta e hora
s el eci ona da s .
Editar marcador selecionado Permi te edi ta r o ma rca dor
s el eci ona do, podendo
a l tera r da ta e hora , nome
ou des cri o.
Remove o ma rca dor
Remover o marcador
s el eci ona do na l i nha de
tempo.
Remove todos os
Remover todos os
ma rca dores cri a dos na
marcadores
l i nha de tempo.
Sel eci ona o ma rca dor
Mover para o marcador
i medi a ta mente frente
anterior
na l i nha de tempo e na
l i s ta de eventos ,
s i mul ta nea mente.
E3Playback
CONE
Clicando em
COMANDO
Mover para o marcador
seguinte
Adicionar, ou em
AO
Sel eci ona o prxi mo
ma rca dor na l i nha de
tempo e na l i s ta de
eventos ,
s i mul ta nea mente.
Editar, a janela a seguir mostrada.
Adicionar ou editar marcador

Opes disponveis na janela Adicionar ou Editar Marcador
OPO
Data/hora/ms
Nome
Comentrios
DESCRIO
Permi te s el eci ona r a da ta e a hora ,
i ncl ui ndo os mi l i s s egundos , do
ma rca dor. Es tes ca mpos j vm
preenchi dos com a da ta e a hora
s el eci ona da s na l i nha de tempo.
Permi te s el eci ona r o nome do ma rca dor.
Permi te i nforma r a l gum coment ri o
a di ci ona l pa ra o ma rca dor.
Quando um marcador criado, ele mostrado na Linha de Tempo, como pode ser
observado na figura a seguir, e tambm na Lista de Eventos.
E3Playback
448
Linha de Tempo com marcadores
20.3.4 rea de Telas

Esta a rea onde so mostradas as Telas do aplicativo. A Tela inicial mostrada
a configurada na propriedade InitialScreen do E3Playback. Se esta propriedade for
deixada em branco, utilizada a Tela inicial do objeto Viewer.
rea de Telas
A rea de Telas funciona como se fosse um Viewer dentro do E3Playback. As Telas

so sempre abertas no zoom Preencher. possvel navegar livremente entre as
Telas do aplicativo.
Existem algumas restries e comentrios quanto ao funcionamento das Telas
dentro do E3Playback:
As Telas funcionam como se estivessem em um Viewer Somente Leitura, isto
, no permitido o envio de comandos e valores para o servidor E3. Isto
garante que as operaes efetuadas no E3Playback no iro perturbar o
funcionamento do aplicativo em tempo real
449
E3Playback
No permitido acesso aos objetos do servidor atravs do mtodo

Application.GetObject. Se este mtodo for chamado em algum script, ele
falha abortando o script
Devido s vrias limitaes de acesso ao servidor, erros de script ocorridos
dentro do E3Playback no geram uma mensagem de erro, e os scripts so
abortados silenciosamente
O E3Playback emula um Viewer real. Para isto criada uma nova cpia do
objeto Viewer e seus Tags para uso do E3Playback. Se algum comportamento
especfico do Viewer tiver que ser habilitado ou desabilitado dentro do
E3Playback, pode-se testar a propriedade IsPlaybackMode, do objeto Viewer
O isolamento entre as Telas que rodam dentro do E3Playback e o que est
fora total
O E3Playback trata os novos Quadros criados pelo aplicativo como novas
abas no topo da rea de Telas. O ttulo da aba o nome do Quadro ou Tela
que foi aberto
Quadros abertos em abas no E3Playback
Todas as Associaes que se referem a objetos do servidor so capturadas

pelo E3Playback, e passam a receber os dados histricos de acordo com o
relgio atual de playback. Isto inclui no apenas as Associaes feitas nas
Telas que esto sendo mostradas, mas tambm as Associaes existentes
nos Tags do Viewer
As Associaes feitas entre objetos do Viewer (por exemplo, um Display
mostrando o valor de um Tag Demo interno ao Viewer) funcionam
normalmente, sem nenhuma interferncia do playback
O E3Chart s funciona dentro do E3Playback se estiver configurado com
Penas histricas. Penas de tempo real so desabilitadas dentro do
E3Playback
450
E3Playback (ficam sem dados)

O E3Alarm mostra o sumrio de alarmes de acordo com o que estiver
registrado na tabela de alarmes no banco de dados
O E3Browser funciona normalmente, j que consultas ao banco de dados
so permitidas dentro do E3Playback
NOTA: Os da dos mos tra dos no E3Brows er s o s empre os da dos ATUAIS do ba nco de
da dos , i s to , o E3Pl a yba ck n o tenta emul a r o es ta do do ba nco de da dos em um
momento no pa s s a do.
20.3.5 Lista de Eventos

A Lista de Eventos mostra a sequncia cronolgica de eventos de playback,
permitindo a navegao evento a evento. Um evento de playback pode ser:
Uma alterao no valor de um Tag
Uma alterao no estado de um alarme
Lista de Eventos
As colunas desta janela esto descritas na tabela a seguir.

Colunas da Lista de Eventos
COLUNA
Data/hora
Caminho do Tag
451
DESCRIO
Mos tra a da ta e a hora do evento,
conforme es t regi s tra do no ba nco de
da dos .
Mos tra o ca mi nho do Ta g ou da fonte de
a l a rmes que gerou es te evento, ou o
nome do Ma rca dor.
E3Playback
COLUNA
Evento
DESCRIO
Se o evento for de muda na do va l or de
um Ta g, mos tra o novo va l or. Se a
qua l i da de n o for Boa (192), el a
mos tra da na frente do va l or (por
exempl o, "Rui m(20); 45.433"). Se o evento
for uma a l tera o no es ta do de um
a l a rme, mos tra o nome da s ub-condi o
(HI, HIHI, LO, LOLO, etc.) e a des cri o do
a l a rme. Se o a l a rme es t (ou foi )
reconheci do, mos tra no i nci o o texto
"ACK", com o nome do opera dor entre
pa rntes es . Se for um Ma rca dor, es te
ca mpo mos tra o coment ri o a s s oci a do a
el e.
A barra de ferramentas da Lista de Eventos possui as opes listadas na tabela a

seguir.
Opes da barra de ferramentas da Lista de Eventos
CONE
COMANDO
Evento Anterior
Prximo Evento
Filtrar Eventos
Filtrar marcadores
AO
Pos i ci ona o rel gi o de
playback no evento a nteri or
a o evento s el eci ona do na
l i s ta , pul a ndo os eventos
com timestamp i gua l a o
timestamp a tua l .
Pos i ci ona o rel gi o de
playback no prxi mo evento
com timestamp ma i or que
o timestamp a tua l .
Li ga ou des l i ga o fi l tro de
eventos . Ao l i ga r o fi l tro,
a pena s os eventos do Ta g
ou da fonte de a l a rme
s el eci ona do a tua l mente
s o mos tra dos na l i s ta de
eventos . Os Ma rca dores
s o mos tra dos s empre,
i ndependente do fi l tro.
Mos tra a pena s os
Ma rca dores cri a dos .
Ao clicar com o boto direito do mouse em um evento, um menu contextual

mostrado com as opes descritas na tabela a seguir.
E3Playback
452
Opes do menu contextual dos eventos

OPO
Mostrar ou Remover grfico na Linha de
Tempo
Mostrar apenas os eventos deste tag ou
Mostrar todos os eventos
DESCRIO
Adi ci ona ou remove uma repres enta o
vi s ua l do Ta g s el eci ona do na ja nel a
Linha de Tempo.
Fi l tra os eventos na Li s ta de Eventos
pa ra mos tra r a pena s o Ta g s el eci ona do.
Sel eci ona ndo de novo es ta op o, todos
os eventos s o mos tra dos .
20.3.6 Lista de Tags

A Lista de Tags mostra os Tags que esto sendo utilizados para playback.
Lista de Tags
As colunas desta janela esto descritas na tabela a seguir.

Colunas da Lista de Tags
COLUNA
Caminho do Tag
Tabela
Estado
Valor
453
DESCRIO
Mos tra o ca mi nho do Ta g.
Mos tra o nome da ta bel a do ba nco de
da dos que contm os da dos do Ta g.
Indi ca s e o Ta g foi encontra do ou n o no
ba nco de da dos .
Mos tra o va l or do Ta g na da ta e hora
a tua l de playback.
E3Playback
COLUNA
Data/hora
Qualidade
Evento Anterior
Prximo Evento
DESCRIO
Mos tra o timestamp a tua l do Ta g. Se o
Ta g s uporta r i nterpol a o (a pena s pa ra
pontos a na l gi cos a rma zena dos no
Stora ge), ent o o timestamp i gua l a o
hor ri o a tua l de playback. Ca s o contr ri o,
o timestamp o do l ti mo evento com
timestamp a nteri or ou i gua l a o hor ri o
a tua l de playback.
Mos tra a qua l i da de do Ta g (pa dr o OPC)
no momento a tua l de playback. Qua ndo a
qua l i da de 192, mos tra do a pena s o
texto "Boa ".
Mos tra o timestamp do evento a nteri or
des te Ta g no ba nco de da dos . Se o Ta g
n o s uporta r i nterpol a o, o evento
a nteri or s empre i gua l a o timestamp
a tua l do Ta g. Se o Ta g s uporta r
i nterpol a o, o evento a nteri or o
l ti mo timestamp regi s tra do no ba nco de
da dos a ntes do hor ri o a tua l de playback.
Mos tra o timestamp do prxi mo evento
des te Ta g.
NOTA: A Li s ta de Ta gs pode a juda r ta mbm a determi na r qua i s Ta gs neces s i ta m s er

gra va dos no ba nco de da dos pa ra permi ti r o playback compl eto de uma Tel a ,
ba s ta ndo veri fi ca r os Ta gs com o s i na l de proi bi do .
Ao clicar com o boto direito do mouse em um Tag, um menu contextual mostrado

com as mesmas opes descritas no tpico Lista de Eventos, exceto no caso de Tags
marcados com o cone , em que o menu contextual aparece desabilitado.
20.4 Banco de Dados de Playback

O E3Playback detecta automaticamente quais so os Tags e os alarmes que esto
armazenados no banco de dados. Este processo de deteco do banco de dados
chamado de Montagem. Depois que o banco de dados est montado, o E3Playback
utiliza as informaes coletadas para realizar consultas aos dados armazenados,
de acordo com os Tags que esto sendo mostrados na Tela e de acordo com o
relgio atual de playback.
20.4.1 Montagem do Banco de Dados

A Montagem do Banco de Dados feita sempre que o E3Playback ativado. As
informaes de estrutura do banco de dados coletadas durante a montagem so
mantidas enquanto a seo de playback estiver ativa. Os passos da montagem do
banco de dados podem ser resumidos da seguinte forma:
E3Playback
454
1. Enumerar todas as tabelas do banco de dados.

2. Verificar quais destas tabelas possuem uma tabela _Fields correspondente. Por
exemplo, quando o E3 gera uma tabela de alarmes chamada E3Alarms, gera
tambm uma tabela com a descrio dos campos da tabela de alarmes
(E3Alarms_Fields).
3. Analisar os campos de cada tabela, bem como o contedo da sua tabela
_Fields correspondente para determinar o tipo de tabela. O E3Playback
reconhece trs tipos de tabela:
Storage: A tabela deve ter os campos E3TimeStamp, FieldID, Quality e
FieldValue
Alarmes: A tabela deve ter os campos EventTime (ou EventTimeDbl),
ConditionActive, Acked, AckRequired e FullAlarmSourceName
Histrico: A tabela deve ter o campo E3TimeStamp, e no pode ter sido
reconhecida como uma tabela de Storage ou de Alarmes
4. Se a tabela for de Storage, a tabela _Fields varrida para determinar quais so
os Tags armazenados na tabela. O caminho do Tag determinado pelo campo
FieldName da tabela _Fields. O campo que fornece o timestamp dos dados de
Storage sempre o E3TimeStamp. Cada Storage pode ter at trs tabelas de
dados, uma para cada tipo de dado:
Strings: O nome da tabela de dados <Tabela>_String
Bit/Digital: O nome da tabela de dados <Tabela>_Bit
Double/Analgicos: O nome da tabela de dados <Tabela>
5. Se a tabela for de Histrico, a tabela _Fields varrida para determinar quais
so os Tags armazenados na tabela. O caminho do Tag neste caso
determinado pelo campo FieldSource. O campo que fornece o timestamp dos
dados desta tabela sempre o E3TimeStamp.
6. Se a tabela for de alarmes, a tabela _Fields varrida para determinar o nome
dos campos de alarme de usurio (se existirem). O campo que fornece o
timestamp na tabela de alarmes o EventTime (opcionalmente combinado com
o campo EventTimeMS, se existir) ou o campo EventTimeDbl (este ltimo tem
prioridade por representar os milissegundos com mais preciso).
7. Depois que todas as tabelas de dados e os caminhos dos Tags foram
detectados, feita uma consulta simples em cada uma das tabelas para
determinar a data mais antiga e a data mais nova armazenada na tabela. Isto
permite determinar o intervalo de datas em que o playback permitido.
455
E3Playback
NOTA 1: O i nterva l o de da ta s v l i da s n o a tua l i za do dura nte um proces s o de

playback, de forma que os da dos novos que forem a di ci ona dos a o ba nco de da dos
a ps a monta gem s es t o di s ponvei s s e a ja nel a de playback for fecha da e a berta
nova mente.
NOTA 2: Em modo Demo (ou com uma l i cena de E3 Studi o), o perodo permi ti do
pa ra playback s e res ume s l ti ma s s ei s hora s de da dos a rma zena dos no ba nco de
da dos .
20.4.2 Consultas de Dados de Playback

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

Informaes de alarmes que devem ser consultadas, que podem ser zero ou
mais das seguintes opes:
Sumrio de alarmes anterior (estado de cada Fonte de Alarme na data e
hora inicial da consulta)
Eventos de alarmes no perodo
Sumrio de alarmes posterior (prximo evento de cada Fonte de Alarme
aps a data e hora final do perodo)
Para executar uma consulta a dados de playback, normalmente so necessrias
vrias consultas ao banco de dados. O servidor de dados de playback efetua estas
consultas de forma assncrona e em um thread separado, coleta os dados e s os
retorna quando todas as consultas tiverem terminado.
Quando uma consulta de playback completada, os dados so imediatamente
adicionados fatia correspondente e o E3Playback automaticamente dispara
consultas para atualizar as fatias vizinhas. Desta forma, medida que o relgio de
playback avana, as consultas de dados vo sendo feitas, e quando o relgio passa
para a prxima fatia bem provvel que ela j tenha todos os seus dados
carregados.
Caso o relgio de playback esteja no modo Reproduzir e entre em uma fatia sem
dados ou com dados incompletos, o E3Playback fica temporariamente pausado
aguardando at que as consultas daquela fatia sejam completadas.
O E3Playback tambm busca minimizar o acesso ao banco de dados, aproveitando
as informaes dos campos ltimo evento anterior, Prximo evento aps, Sumrio
anterior e Sumrio posterior para evitar que estes dados sejam consultados
novamente. Por exemplo:
Se uma consulta a um Tag no retornou o prximo evento aps o perodo da
consulta, sinal de que este Tag no possui nenhum evento aps a data e
hora final da consulta, e portanto este Tag no precisa ser consultado nas
fatias de tempo posteriores
Se uma consulta retornou o sumrio anterior, eventos de alarmes no perodo
e o sumrio posterior para uma fatia, possvel calcular o sumrio anterior
da prxima fatia simplesmente combinando o sumrio anterior e os eventos
ocorridos durante a fatia atual. Desta forma, torna-se desnecessrio
consultar no banco de dados o sumrio anterior da prxima fatia
457
E3Playback
20.5 Configurao dos Objetos de Banco de Dados do

E3
Esta seo explica como os objetos do E3 devem ser configurados para que os
dados armazenados no banco de dados possam ser utilizados no E3Playback.
20.5.1 Storage
A nica recomendao para o Storage que a coluna Fonte no deve conter
expresses, pois elas no podem ser utilizadas no playback.
O E3 j cria automaticamente nas tabelas de Storage os ndices necessrios para
otimizar as consultas do E3Playback.
20.5.2 Alarmes
Para executar o playback de alarmes, siga estes procedimentos:
1. Habilite ou configure o registro de alarmes em disco.
2. Selecione os seguintes campos para registro (obrigatrios):
EventTime (mais EventTimeMS) ou EventTimeDbl
FullAlarmSourceName
ConditionActive
Acked
AckRequired
3. Ainda recomendada a seleo dos seguintes campos para registro:
InTime (mais InTimeMS) ou InTimeDbl
OutTime (mais OutTimeMS) ou OutTimeDbl
AckTime (mais AckTimeMS) ou AckTimeDbl
Area
ActorID
Enabled
EventCategory
EventType
Message
Severity
E3Playback
458
Source
SubConditionName
CurrentValue
Seleo dos campos
O E3 j cria automaticamente na tabela de alarmes os ndices necessrios para

otimizar as consultas de playback.
20.5.3 Histricos
O formato de arquivo Histrico no o ideal para playback, pois normalmente
muitos dados duplicados esto armazenados. As consultas de playback tm um
trabalho extra para eliminar os valores duplicados de cada Tag e encontrar apenas
os eventos de mudana de valor, o que pode exigir longas consultas sequenciais na
tabela do Histrico. recomendado o uso do Storage sempre que possvel. Se for
indispensvel o uso de dados de Histrico no playback, deve-se seguir ao mximo
as seguintes recomendaes:
Configurar a propriedade UserTable para Falso (se esta propriedade estiver
em Verdadeiro, a tabela _Fields deste histrico no gerada, e este histrico
no reconhecido pelo playback)
Colocar cada Tag em um campo separado (no utilizar expresses na fonte
do campo, por exemplo)
Criar um ndice para o campo E3TimeStamp. Sem este ndice as consultas ao
Histrico ficam muito lentas, tornando o playback impraticvel
459
Utilizar tabelas com poucos campos e, se possvel, adicionar um ndice

individual para cada campo (principalmente para os campos com poucas
E3Playback
variaes)
Configurar a propriedade CompressedTable em Verdadeiro e utilizar a
propriedade DeadBand no Histrico
A figura a seguir mostra como deve ser a configurao do ndice do campo
E3TimeStamp:
Definio do ndice para o campo E3TimeStamp
20.5.4 Licenciamento
A Elipse Software fornece dois pacotes de playback, de acordo com as suas
ferramentas:
Playback Bsico
Playback Avanado: Consiste no Playback Bsico mais as ferramentas Gravao
de Vdeo e Captura de Tela
Cada um destes pacotes dimensionado conforme o nmero de pontos (Tags e
E3Playback
460
Fontes de Alarmes) armazenados no banco de dados. Por exemplo, um Playback

Bsico 1000 permite fazer playback de um banco de dados com at 1000 pontos. Se
o banco de dados tem mais pontos que as licenas disponveis, a montagem do
banco de dados falha e mostrada uma mensagem de erro indicando que no h
licenas disponveis para rodar o playback.
A licena de Studio do E3 inclui uma licena de Playback Avanado sem limite de
pontos, porm limitada s ltimas seis horas de dados armazenados no banco de
dados. Isto permite que o desenvolvedor do aplicativo teste o playback sem
precisar adquirir as licenas para isto.
Em modo Demo (quando no h dispositivo de proteo), o playback tambm
funciona no modo Avanado sem limite de pontos, porm limitado a mostrar
apenas as ltimas seis horas de dados armazenados no banco de dados, em
relao hora atual do servidor.
IMPORTANTE: Se o di s pos i ti vo de prote o for do ti po Master (Studio + Runtime) ou
a pena s de Runtime, o playback s es t di s ponvel s e houver l i cena s progra ma da s
no di s pos i ti vo. Pa ra ma i ores i nforma es s obre a s l i mi ta es do modo Demo do E3,
veja o tpi co Limitaes do Modo Demonstrao.
461
E3Playback
CAPTULO
21
Frmulas
Frmulas so mdulos destinados ao armazenamento e transferncia de conjuntos

de valores para determinados agrupamentos de variveis, de forma a criar
configuraes pr-definidas. So compostas de trs partes: Templates, Unidades e
Conjuntos de Valores.
As Frmulas podem ser utilizadas para facilitar processos industriais. Por
exemplo, uma fbrica de bebidas produz 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. Os
Conjuntos de Valores so o tipo e a quantidade de produtos colocados em cada
suco (por exemplo, 50g de acar, 1000l de gua, polpa de fruta, etc.). Para utilizar
este recurso, siga este procedimento:
1. Clique com o boto direito do mouse no nome do projeto no Organizer e
selecione a opo Inserir - Frmula.
Frmulas
462
Inserindo uma Frmula

NOTA: O objeto Frmul a pode s er confi gura do pa ra funci ona r como rea de Alarme.
21.1 Configuraes
Quando se cria uma Frmula, mostrada uma janela para a configurao do
Banco de Dados e da tabela a ser utilizados. Sem isto, no possvel a criao de
Unidades e Conjuntos de Valores.
463
Frmulas
Configurao do Banco de Dados e da tabela

Opes disponveis na janela Configurao do Banco de Dados
OPO
Banco de Dados
Tabela
DESCRIO
Determi na o s ervi dor de Ba nco de Da dos
que gerenci a os da dos confi gura dos na
Frmul a .
Determi na o nome da ta bel a .
Caso seja necessrio configur-los posteriormente, ou mesmo reconfigur-los,

selecione a opo Configurar Banco de Dados no menu contextual da Frmula.
Frmulas
464
Configurando o Banco de Dados
21.2 Templates
A primeira aba na view de Frmulas chama-se Templates. Os Templates definem o
tipo de dado que pode ser armazenado em cada varivel da Frmula, alm de suas
restries.
465
Frmulas
Aba Templates

Opes disponveis na aba Templates
OPO
Nome
Tipo
Restries
DESCRIO
Defi ne o nome do Templ a te.
Defi ne o ti po do Templ a te.
Determi na a s res tri es do Templ a te.
A barra de ferramentas da view Templates tem as seguintes opes: Adicionar ,

para a criao de um novo Template, e Remover , para a excluso do Template
selecionado.
Ao clicar em
Frmulas
Restries, a janela da figura a seguir mostrada.
466
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
Opes disponveis na janela Edio das Restries
OPO
Limite Irrestrito
Limite Restrito
Limite Absoluto
467
DESCRIO
O us u ri o pode a l tera r qua l quer va l or no
Templ a te. s i mbol i za do pel a l etra U na
view Templ a tes .
O us u ri o n o pode a l tera r o va l or do
Templ a te. s i mbol i za do pel a l etra R na
view Templ a tes .
S o defi ni dos va l ores fi xos como l i mi tes ,
corres pondendo a o va l or mni mo e
m xi mo do Templ a te. s i mbol i za do pel a
l etra A na view Templ a tes (e os va l ores
mni mo e m xi mo confi gura dos no
ca mpo).
Frmulas
OPO
Limite Percentual
Limite por diferena
DESCRIO
Va l or percentua l a ci ma ou a ba i xo do
va l or pr-defi ni do. Por exempl o,
col oca ndo os l i mi tes entre 20% e 30%,
pa ra o va l or 100, os va l ores permi ti dos
va ri a m entre 80 e 130. s i mbol i za do pel a
l etra P na view Templ a tes (e os va l ores
confi gura dos no ca mpo).
Va l ores fi xos a ci ma ou a ba i xo do va l or
pr-defi ni do. Por exempl o, col oca ndo os
l i mi tes em 10 e 50 pa ra o va l or 50, os
va l ores permi ti dos va ri a m de 40 e 100.
s i mbol i za do pel a l etra D na view
Templ a tes (e os va l ores confi gura dos no
ca mpo).
21.3 Unidades
A segunda aba na view de Frmulas chama-se Unidades. As Unidades definem os
Tags que so associados aos Templates da Frmula. possvel criar vrias
Unidades, ou seja, vrios grupos de Tags que podem receber os valores da Frmula.
Aba Unidades

Opes disponveis na aba Unidades
OPO
Nome
Unidade
DESCRIO
Determi na o nome do Templ a te.
Determi na o Ta g que a s s oci a do
Uni da de.
A barra de ferramentas da view Unidades tem as seguintes opes: 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, a janela a seguir mostrada para definir um nome.
Frmulas
468
Adio de uma Unidade
21.4 Conjunto de Valores

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

Opes disponveis na aba Valores
OPO
Nome
Valor
DESCRIO
Determi na o nome do Templ a te.
Determi na o va l or dos ca mpos pa ra os
Conjuntos de Va l ores .
A barra de ferramentas da view Valores tem as seguintes opes: 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.
21.5 Criao de uma Frmula

Instrues
Este exerccio cria um objeto Frmula para armazenar Conjuntos de Valores para a
469
Frmulas
produo de uma determinada pea. Esta pea tem trs medidas: Dimetro Externo,
Dimetro Interno e Altura. Esta Frmula armazena os valores para duas mquinas
diferentes que produzem estas peas.
21.5.1 Procedimentos
1. Insira um objeto Frmula na aplicao.
2. Configure o Banco de Dados e a tabela. Use um Banco de Dados existente no
projeto, e nomeie a tabela como "Produo".
Configuraes do Banco de Dados e da tabela
3. Crie trs Templates na Frmula:

Dimetro Externo: Com restrio de valor absoluta entre 50 e 80
Dimetro Interno: Com restrio por diferena de valor de 10 e 10
Altura: Com limite restrito
Templates
4. Na prxima etapa so 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 um Servidor de Dados uma Pasta chamada "Formula" e
dentro dela outras duas Pastas chamadas "Maquina1" e "Maquina2". Dentro
destas Pastas crie trs Tags Internos para cada uma.
Frmulas
470
Criando Tags
5. Crie na Frmula duas Unidades chamadas "Maquina1" e "Maquina2". Associe

cada campo destas Unidades aos Tags criados anteriormente.
Associando os Tags s Unidades da Frmula
6. Defina os Conjuntos de Valores a serem carregados posteriormente nos Tags.

Crie quatro Conjuntos de Valores, chamados de "Modelo'" at "Modelo4", e
471
Frmulas
digite os valores mostrados na figura a seguir.
Configurao do Conjunto de Valores
7. Crie agora uma nova Tela chamada "Frmulas".

8. Crie seis objetos SetPoint nesta Tela, que devem ser associados a cada um dos
Tags da Frmula, e ajuste o tamanho da Tela ao dos objetos. A Tela deve estar
semelhante figura a seguir.
Tela de Frmula
Frmulas
472
NOTA: s vezes , pode ocorrer um erro na Tel a que fa z com que a s i ma gens
des a pa rea m. Pa ra s ol uci ona r es ta ques t o, deve-s e des a bi l i ta r a op o Esconder
extenses do MS-DOS para arquivos registrados. Es ta op o es t di s ponvel no
Wi ndows Expl orer.
9. Crie um boto na Tela com o ttulo "Carregar valores". Este boto mostra 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:
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 caixa de dilogo da figura a
seguir mostrada.
Caixa de dilogo do mtodo LoadFormulaDlg
10. Na diviso da direita so apresentadas as duas Unidades criadas na Frmula,

assim como os Conjuntos de Valores. A opo Modo Silencioso inibe a
possibilidade de o usurio alterar valores gravados em disco, que so
carregados para os Tags.
11. Atravs deste boto, pode-se ver a aplicao funcionando com as Frmulas e
os Tags recebendo os valores do disco. Este um dos mtodos para carregar
473
Frmulas
valores de uma Frmula, mas tambm existem mtodos em que o usurio no

necessita selecionar os valores ou as Unidades em uma caixa de dilogo.
12. Crie agora um objeto SetPoint na Tela e um boto com o ttulo "OK". Junto com o
SetPoint, coloque um texto de identificao com o ttulo "Modelo:". No boto
deve ser criado o seguinte script:
Application.LoadFormulaValues_
"Formula1", "Maquina1", "Modelo1"
Screen.Item("Texto16").Value
End Sub
Onde Texto16 o nome do ltimo SetPoint inserido na Tela. Este comando carrega o
Conjunto de Valores especificado no SetPoint para a Unidade Maquina1. Ao ser
executado, este mtodo busca pelo Conjunto de Valores em disco. Caso encontre,
carrega-o seguindo o padro de restries definido no Template da Frmula. Os
campos com restries abertas podem ter seus valores modificados pelo usurio.
Para que o usurio no seja interrogado sobre as mudanas de valores nos
campos carregados, deve-se utilizar o modo silencioso.
Alterao do valor
No entanto existe uma alternativa, o mtodo LoadFormulaValuesQuiet, do objeto

Viewer. feita uma opo pelo modo silencioso na Tela, utilizando para isto, o
objeto Caixa de Seleo.
1. Crie um objeto Caixa de Seleo na Tela.
2. Coloque um texto de identificao ao seu lado, com o texto "Silencioso".
3. Volte ao script do boto OK e mude o cdigo para o seguinte:
If Screen.Item("CheckBox1").Value = true Then
Frmulas
474
Application.LoadFormulaValuesQuiet_
Else
End If
End Sub
Onde CheckBox1 o nome da Caixa de Seleo criada. Isto faz com que se o objeto
estiver habilitado, seja utilizado o mtodo LoadFormulaValuesQuiet. Caso
contrrio, utilizado o mtodo LoadFormulaValues.
1. Repita os ltimos procedimentos desde a criao do SetPoint para os itens da
Maquina2, modificando os scripts necessrios. Ao final das alteraes, a Tela
deve estar semelhante figura a seguir.
475
Frmulas
Tela final da Frmula
2. Execute a aplicao e observe os resultados.
Frmulas
476
CAPTULO
22
Relatrios
O Relatrio um componente ActiveX chamado ActiveReport, que permite a

visualizao e impresso de valores instantneos de variveis do sistema e dados
armazenados em Banco de Dados (Alarmes, Histricos, Consultas e Frmulas).
Estes dados podem ser impressos tanto em formato texto como em formato grfico,
sendo este ltimo feito atravs do objeto E3Chart.
NOTAS:
O objeto Rel a tri o NO es t di s ponvel na vers o 64 bi ts do E3. Entreta nto, o
Rel a tri o pode s er edi ta do na vers o 32 bi ts do Studi o, pres ente na i ns ta l a o 64
bi ts .
Um Vi ewer 32 bi ts conecta do a um Servi dor 64 bi ts i mpri me Rel a tri os
norma l mente.
Para utilizar o Relatrio, siga estes procedimentos:

1. Clique com o boto direito no item Relatrios do Organizer e selecione a opo
Inserir Relatrio em.
477
Relatrios
Inserindo um Relatrio
22.1 Objeto Consulta

Este objeto permite que seja especificada a origem dos dados do Banco de Dados
que so visualizados no Relatrio. Aps ter criado o Relatrio no projeto, este cria
o objeto Consulta. Para maiores informaes a respeito deste objeto, veja o
captulo Consultas.
22.2 Componentes
Um Relatrio contm vrias Sees. Cada Seo do Relatrio contm um grupo de
controles que so processados e impressos ao mesmo tempo, como uma unidade.
Relatrios
478
Sees do Relatrio
O Relatrio define tipos de Seo, que so explicados nos tpicos a seguir.
22.2.1 Report Header

Um Relatrio pode ter uma Seo Report Header que imprime no incio do
Relatrio. geralmente utilizada para imprimir ttulos de relatrio, tabelas de
somas, grficos ou qualquer outra informao que necessite aparecer somente
uma vez no incio do Relatrio.
NOTA: Um Report Hea der pode es tender-s e por ml ti pl a s p gi na s . Pa ra i s to, ba s ta
i ns eri r um objeto Quebra de P gi na em s eu contedo.
22.2.2 Report Footer

A Seo Report Footer imprime no final do Relatrio. usada para imprimir uma
soma de um relatrio, totais gerais ou qualquer outra informao que necessite ser
impressa somente uma vez no final do Relatrio.
479
Relatrios
22.2.3 Page Header

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

A Seo Page Footer imprime uma vez na base de cada pgina do Relatrio. Usada
para imprimir totais de pginas, nmeros de pginas ou qualquer outra
informao que necessite ser impressa uma vez na base de cada pgina.
22.2.5 Group Header e Group Footer

Um Relatrio pode ter mltiplos grupos aninhados. Cada grupo possui uma Seo
Header e uma Seo Footer. A Seo Header imprime antes de qualquer Seo
Detail no grupo. A Seo Footer imprime depois de todas as Sees Detail do grupo.
Sees de grupo so inseridas imediatamente antes e depois da Seo Detail.
O nmero de vezes que uma Seo de grupo pode imprimir depende de como os
dados so agrupados. O Relatrio inicia um novo grupo (Header, Detail e Footer)
para cada mudana nos dados que so reunidos no grupo.
22.2.6 Detail
A Seo Detail o corpo do Relatrio, que imprime uma vez para cada registro da
fonte de dados.
22.3 Configuraes
O Relatrio possui vrios objetos que podem ser agregados a ele, que so
acessados atravs da barra de ferramentas Relatrios.
Barra de ferramentas Relatrios
Clicando com o boto direito do mouse no Relatrio, mostrado um menu. As

opes deste menu variam de acordo com o local do clique do mouse.
Na rea do Relatrio: Somente as opes Insert e Delete Section esto
habilitadas
Relatrios
480
Menu da rea do Relatrio
Em um objeto no Relatrio: Somente as opes Insert, Delete, Cut, Copy, Paste,

Bring to Front, Send to Back, Alignment e Format Border esto habilitadas
Menu de objeto do Relatrio
Em mais de um objeto selecionado no Relatrio: Todas as opes do menu esto

habilitadas
481
Relatrios
Opes disponveis no menu contextual do Relatrio

OPO
Insert
Delete / Delete Section

Reorder Groups
Cut
Copy
Paste
Bring to Front
Send to Back
Align
Relatrios
DESCRIO
Permi te i ns eri r um novo componente do
Rel a tri o. As opes di s ponvei s s o a s
s egui ntes :
Insert - Group Header/Footer: Adi ci ona um
novo pa r de ca bea l hos ou roda ps de
grupo no Rel a tri o
Insert - Page Header/Footer: Adi ci ona um
novo pa r de ca bea l hos ou roda ps de
p gi na
Insert - Report Header/Footer: Adi ci ona um
novo pa r de ca bea l hos ou roda ps no
Rel a tri o
Apa ga a Se o, objeto ou grupo
s el eci ona do. Es ta op o n o a pl i ca da na
Se o Detail do Rel a tri o.
Reorga ni za os grupos s el eci ona dos . Es ta
op o v l i da qua ndo v ri os grupos de
Se o (pa res de ca bea l ho ou roda p) s o
a di ci ona dos no Rel a tri o. Es ta op o n o
a pl i ca da na Se o Detail do Rel a tri o.
Recorta o objeto, grupo ou Se o
s el eci ona do.
Copi a o objeto, grupo ou Se o
s el eci ona do.
Col a o objeto, grupo ou Se o na Se o
corrente do Rel a tri o.
O objeto, grupo ou Se o s el eci ona do
envi a do pa ra a pri mei ra pos i o na ordem
de s obrepos i o.
O objeto, grupo ou Se o s el eci ona do
envi a do pa ra a l ti ma pos i o na ordem de
s obrepos i o.
Al i nha o objeto, grupo ou Se o
s el eci ona do. As opes di s ponvei s s o a s
s egui ntes :
Lefts: Al i nha mento es querdo
Centers: Al i nha mento centra l i za do
Rights: Al i nha mento di rei to
Tops: Al i nha mento no topo
Middles: Al i nha mento centra l
Bottoms: Al i nha mento mes ma a l tura
To grid: Al i nha mento conforme a gra de
Center in section: Al i nha mento
centra l i za do na Se o
482
OPO
Size
Horizontal Spacing
Vertical Spacing
Format Border
DESCRIO
Determi na o ta ma nho do objeto, grupo ou
Se o s el eci ona do. As opes di s ponvei s
s o a s s egui ntes :
Make same width: Mes ma l a rgura
Make same height: Mes ma a l tura
Make same size: Mes mo ta ma nho
Determi na o es pa a mento hori zonta l do
objeto no Rel a tri o. As opes di s ponvei s
s o a s s egui ntes :
Make Equal: Es pa a mento i gua l entre os
objetos
Increase: Incrementa o es pa a mento do
objeto em um pa s s o
Decrease: Decrementa o es pa a mento do
Determi na o es pa a mento verti ca l do
objeto. As opes di s ponvei s s o a s
s egui ntes :
Make equal: Es pa a mento i gua l entre os
objetos
Increase: Incrementa o es pa a mento do
Decrease: Decrementa o es pa a mento do
Determi na o forma to da borda do objeto do
Rel a tri o.
Quando a opo Format Border selecionada, a caixa de dilogo da figura a seguir

mostrada.
483
Relatrios
Opes de borda do objeto

Opes disponveis para a borda do objeto
OPO
Presets
Line Styles
Preview
Color
Shadow
DESCRIO
Determi na o es ti l o da borda externa do
objeto.
Determi na o es ti l o da l i nha da borda do
objeto.
Prvi a de confi gura o do objeto.
Determi na a cor da borda do objeto.
Ha bi l i ta ou des a bi l i ta a s ombra do
objeto.
Atravs da barra de ferramentas Relatrios, possvel acessar os recursos

disponveis no Relatrio.
22.3.1 Preview
Atravs desta opo, possvel visualizar uma prvia da impresso do Relatrio.
Assim possvel verificar configuraes de margem, figuras, etc.
Relatrios
484
Prvia de impresso do Relatrio

Configuraes da Prvia de Impresso
CONE
DESCRIO
Ta bel a de contedo do Rel a tri o.
Impri me o Rel a tri o, a bri ndo a
Tel a de confi gura o de
i mpres s o.
Copi a o contedo s el eci ona do.
Procura um texto es pecfi co no
Rel a tri o.
Vi s ua l i za o de uma p gi na
s i mpl es do Rel a tri o.
Vi s ua l i za o de ml ti pl a s
p gi na s do Rel a tri o.
485
Relatrios
CONE
DESCRIO
Menos zoom na p gi na .
Ma i s zoom na p gi na .
Porcenta gem de zoom na p gi na .
P gi na a nteri or e Prxi ma p gi na .
22.3.2 Report Settings

Atravs desta opo, possvel configurar as especificaes do Relatrio, tais
como configuraes de pgina, impresso, grade e estilo do Relatrio.
A aba Page Setup configura as especificaes referentes pgina do Relatrio.
Configuraes de pgina do Relatrio

Opes de configurao Page Setup (pgina)
OPO
Top Margin
Bottom Margin
Left Margin
Right Margin
Relatrios
Determi na
Determi na
p gi na .
Determi na
p gi na .
Determi na
DESCRIO
a ma rgem do topo da p gi na .
a ma rgem do contedo da
a ma rgem es querda da
a ma rgem di rei ta da p gi na .
486
OPO
Gutter
Mirror Margins
DESCRIO
Determi na a ma rgem da p gi na .
Ha bi l i ta ou des a bi l i ta a ma rgem
es pel ha da da p gi na .
A aba Printer Settings configura as especificaes referentes impresso do

Relatrio.
Configuraes de impresso do Relatrio

Opes de configurao Printer Settings (Impressora)
OPO
Paper Size
Width
Height
Orientation
Collate
Duplex
PaperBin
487
DESCRIO
Determi na o ta ma nho do pa pel .
Determi na a l a rgura do pa pel .
Determi na a a l tura do pa pel .
Determi na a ori enta o do pa pel na
i mpres s ora (Printer Default:Configuraes
de acordo com a impressora padro, Portrait:
Layout da pgina na vertical ou Landscape:
Layout da pgina na horizontal).
Ordena a i mpres s o.
Dupl i ca a i mpres s o.
Determi na a s confi gura es e o ti po de
pa pel pa ra a i mpres s o.
Relatrios
A aba Grid Settings determina as configuraes referentes s grades do Relatrio.
Configuraes da grade do Relatrio

Opes de configurao Grid Settings (grade)
OPO
Show Grid
Align Controls to Grid
Grid Columns
Grid Rows
Ruler Units
DESCRIO
Ha bi l i ta ou des a bi l i ta a gra de.
Ha bi l i ta ou des a bi l i ta o a l i nha mento
dos control es na gra de.
Determi na o nmero de col una s na
gra de.
Determi na o nmero de l i nha s na gra de.
Determi na o ti po de uni da de da rgua
(pi xel s ou centmetros ).
A aba Styles determina as configuraes referentes ao estilo do Relatrio.
Relatrios
488
Configuraes de estilo do Relatrio

Opes de configurao Styles (estilos)
OPO
New / Delete / Lista
Font / Colors / Misc
DESCRIO
Determi na o es ti l o do Rel a tri o. Pode-s e
i ns eri r um novo es ti l o (cl i ca ndo em New),
a pa ga r um es ti l o (cl i ca ndo em Delete) ou
uti l i za r os es ti l os exi s tentes na l i s ta .
Determi na a s es peci fi ca es do es ti l o
do Rel a tri o (fontes , cores de fundo e
frente, ori enta o, etc.).
22.3.3 Script Editor

O Editor de Scripts (Script Editor) utilizado para criar scripts nos Relatrios do E3.
A linguagem utilizada para criar os scripts no Relatrio a Active Scripting, que
interage com o Visual Basic. Quando o Editor de Scripts est aberto, disponibiliza
os mtodos e eventos dos objetos e componentes do Relatrio. Para utilizar este
recurso, clique em Script Editor , disponvel na barra de ferramentas Relatrios.
489
Relatrios
Editor de Scripts
No campo Object necessrio especificar o objeto onde se deseja criar o script e

no item Events, o evento do Relatrio em que ocorre a ao.
22.3.4 Carregar Arquivo RPX

Importa a configurao do Relatrio de um arquivo externo.
22.3.5 Salvar Arquivo RPX

Exporta a configurao do Relatrio para um arquivo externo.
22.3.6 Objetos
Esta seo contm informaes sobre os objetos que podem ser usados em um
Relatrio.
22.3.6.1 Linha
O objeto Linha liga dois pontos quaisquer. Permite o desenho de retas, atravs de
dois pontos especificados na sua criao ou em polgonos.
Linha
Aps ser inserido no Relatrio, este objeto chamado de "Line".
Relatrios
490
22.3.6.2 Retngulo
O objeto Retngulo permite o desenho de retngulos, utilizando toda a largura ou
altura do objeto. Criado a partir de dois vrtices.
Retngulo
Aps ser inserido no Relatrio, este objeto chamado de "Shape".
22.3.6.3 Retngulo Arredondado

O objeto Retngulo Arredondado um retngulo criado a partir de dois vrtices,
com cantos arredondados a partir de um fator de arredondamento.
Ao ser inserido ou editado, exibe um pequeno ponto prximo ao seu canto superior
esquerdo, que permite modificar o fator de arredondamento.
Retngulo arredondado
22.3.6.4 Elipse
O objeto Elipse permite o desenho de crculos e elipses, utilizando toda a largura ou
a altura e definindo o centro do crculo no centro do retngulo.
Elipse
491
Relatrios
22.3.6.5 Figura
O objeto Figura permite mostrar imagens que estejam armazenadas em arquivos,
tanto em arquivos externos como em arquivos de recurso do aplicativo.
Figura
Aps ser inserido no Relatrio, este objeto chamado de "Image".
22.3.6.6 Texto
O objeto Texto possibilita a criao de um texto. Ao definir a rea na Tela, pode-se
digitar diretamente o texto desejado, que aceita tambm mltiplas linhas.
Texto
Aps ser inserido no Relatrio, este objeto chamado de "Label".
22.3.6.7 Campo de Dados

O objeto Campo de Dados utilizado para inserir um dado do Banco de Dados no
Relatrio. Este dado indicado atravs da propriedade DataField.
Campo de Dados
Aps ser inserido no Relatrio, este objeto chamado de "Field".

Relatrios
492
22.3.6.7.1 Exemplo de Utilizao

O exemplo a seguir demonstra como mostrar a mdia por dia de um campo da
consulta no Relatrio. Para tanto, siga estes procedimentos:
1. Insira um novo GroupHeader/Footer no Relatrio.
2. Configure a propriedade DataField do GroupHeader para "=Day(E3TimeStamp)".
Isto determina que o clculo da mdia feito por dia.
3. Insira um Campo de Dados no GroupHeader com a propriedade DataField igual
a "=Day(E3TimeStamp)".
4. Insira um Campo de Dados no GroupFooter com a propriedade DataField igual
ao nome do campo que calculada a mdia.
5. Configure as seguintes propriedades do Campo de Dados do GroupHeader:
SummaryFunc: 1 - ddSFAvg
SummaryGroup: GroupHeader1
SummaryRunning: 1 - ddSRGroup
SummaryType: 3 - ddSMSubTotal
22.3.6.8 Caixa de Seleo

O objeto Caixa de seleo insere um dado no Relatrio que pode ou no estar ligado
ao Banco de Dados. Seu valor do tipo Booleano.
Caixa de seleo
Aps ser inserido no Relatrio, este objeto chamado de "CheckBox".
22.3.6.9 Cdigo de Barras

O objeto Cdigo de Barras permite gerar uma figura que converte uma sequncia de
nmeros e caracteres em um cdigo de barras. Este cdigo de barras uma
representao numrica ou alfanumrica, utilizada para facilitar diferentes
processos. Este cdigo decifrado atravs de scanners, canetas ou equipamentos de
leitura ptica.
493
Relatrios
Cdigo de barras
Aps ser inserido no Relatrio, este objeto chamado de "Barcode".
22.3.6.10 Quebra de Pgina

O objeto Quebra de Pgina um ponto em que uma pgina termina e outra comea
no Relatrio. Por exemplo, pode-se forar uma quebra de pgina para assegurar
que o ttulo de um captulo comece sempre em uma nova pgina. Ao trabalhar com
documentos que contenham diversas pginas e inserir quebras de pgina manuais,
talvez seja necessrio reinseri-las com frequncia medida que se edita o
documento. Tambm pode-se impedir que uma quebra de pgina ocorra em um
pargrafo ou em uma linha de tabela, ou ainda assegurar que uma quebra de
pgina no seja inserida entre dois pargrafos, como entre um ttulo e o pargrafo
seguinte.
Quebra de Pgina
22.3.6.11 Quadro
O objeto Quadro composto de linhas e colunas onde so inseridos textos ou
grficos. Os Quadros dos Relatrios so usados para organizar e apresentar
informaes. Pode-se tambm usar Quadros para criar disposies de pgina, ou
criar textos, grficos e tabelas animadas como em uma pgina em HTML.
Relatrios
494
Quadro
Aps ser inserido no Relatrio, este objeto chamado de "Frame".
22.3.6.12 E3Chart
O objeto E3Chart um componente ActiveX utilizado para exibir um grfico
mostrando Tags variando em tempo real e tambm mostrar dados histricos
gravados em um Banco de Dados.
E3Chart
NOTA: O E3Cha rt n o pode s er a di ci ona do na Se o Detail do Rel a tri o.
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 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
495
Relatrios
tampouco as de seus objetos via scripts do aplicativo. Por isto, as alteraes nos
objetos, incluindo o E3Chart, devem ser feitas diretamente no E3 Studio ou em
eventos do prprio Relatrio.
Para maiores informaes sobre este objeto, veja o captulo E3Chart.
22.4 Criando um Relatrio no E3

Esse exemplo contempla a criao de um Relatrio no E3 para extrao de dados de
um Histrico.
22.4.1 Definio de reas

O Relatrio padro, criado quando inserido um novo Relatrio ao projeto, tem as
seguintes reas:
Page Header: rea mostrada em todas as pginas do Relatrio, como
cabealho
Detail Area: rea repetida tantas vezes quantas forem necessrias, o corpo
do Relatrio
Page Footer: Rodap da pgina, trabalha do mesmo modo que o Page Header
Existem ainda dois tipos de reas:
Report Header/Footer: reas que so impressas uma nica vez, no
importando o tamanho do Relatrio em pginas. Esta rea 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. Esta rea se repete
sempre que um grupo for apresentado. No exemplo aqui demonstrado no
utilizada nenhuma construo deste tipo. Esta rea sempre envolve uma
rea de detalhes
Estas duas reas podem ser acessadas clicando com o boto direito do mouse no
Relatrio e selecionando a opo Insert.
22.4.2 Configurao da Consulta

Para a extrao de dados de um Banco de Dados, necessrio configurar a
consulta do Relatrio. Podem existir vrias consultas diferentes para o mesmo
Relatrio, sendo que apenas uma pode estar ativa em determinado momento. Para
tanto, deve-se seguir estes procedimentos:
1. Configure a propriedade DataSource (nome do Banco de Dados onde
executada a consulta. Neste caso, "ServidorDB").
Relatrios
496
2. Determine a propriedade Table (tabela de consulta, aqui "Dados").

3. Configure a propriedade Name (mantenha o nome original, "Consulta1").
22.4.3 Configurao dos Campos

Neste exemplo so criadas quatro temperaturas armazenadas em um Histrico e
estas temperaturas so o objeto de interesse do nosso Relatrio. Sendo assim, os
valores lidos do Histrico so impressos atravs do Relatrio.
Para ler dados de um Banco de Dados, a rea ideal a Detail Area, visto que esta
rea repetida automaticamente quantas vezes se fizerem necessrias. Desta
maneira, devem ser inseridos cinco Campos de Texto nesta rea. Estes campos
podem ser ligados a um Campo de Dados, que configurado atravs da
propriedade DataField. Aqui, so usados os seguintes valores:
Field1: E3Timestamp
Field2: Temperatura1 (como est no Banco de Dados)
Field3: Temperatura2
22.4.4 Visualizao
possvel executar a visualizao do Relatrio criado clicando-se em Preview
disponvel na rea de edio.
Para tanto, necessrio direcionar o servidor de Banco de Dados do projeto para o

arquivo MDB da pasta onde foi salvo o exemplo.
22.5 Exemplos de Utilizao

A seguir so mostrados alguns exemplos de utilizao dos recursos dos Relatrios.
22.5.1 Configurando o Caminho de um Bitmap na

Impresso
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
497
Relatrios
22.5.2 Configurando o Valor de um Cdigo de Barras na

Seo Detail
Para utilizar este recurso, escreva o script a seguir no evento OnFormat da Seo
Detail:
Sub OnFormat
Report.Sections("Detail").Controls("BarCode1")
Caption = Right(Report.Field ("E3TimeStamp"), 8)
End Sub
22.5.3 Capturando uma Tela e Gerando uma Prvia de

Impresso
Para utilizar este recurso, digite o seguinte script:
Sub Rect_Click()
' Esta chamada de mtodo tambm pode ser feita
' utilizando-se Application.CaptureScreen()
Screen.Frame.CaptureScreen("C:\correio\teste.bmp")
Application.LoadReport("[Relatrio3]").PrintPreview()
End Sub
22.5.4 Gerando um Menu Exportar

Para utilizar este recurso, escreva o seguinte script:
Sub Retangulo3_Click()
Set report = Application.LoadReport("[Relatrio3]")
Select Case _
Application.SelectMenu("PDF|Excel|HTML|RTF|Texto|_
TIFF|Texto(CSV)")
Case 1
Report.Export "PDF", "C:\correio\reports\report.pdf"
MsgBox "Exportado para PDF!"
Case 2
Report.Export "EXCEL", "C:\correio\reports\report.XLS"
MsgBox "Exportado para XLS!"
Case 3
Report.Export "HTML", "C:\correio\reports\report.html"
MsgBox "Exportado para HTML!"
Case 4
Report.Export "RTF", "C:\correio\reports\report.rtf"
MsgBox "Exportado para RTF!"
Case 5
Report.Export "TEXT", "C:\correio\reports\report.txt"
MsgBox "Exportado para Texto (CSV)!"
Case 6
Report.Export "TIFF", "C:\correio\reports\report.tiff"
MsgBox "Exportado para TIFF!"
Relatrios
498
Case 7
Set reportFilter = report.GetExportFilter("TEXT")
reportFilter.FileName="C:\correio\reports\_
report2.txt"
reportFilter.TextDelimiter = ","
report.Export reportFilter
MsgBox "Exportado para TXT usando filtro!"
End Select
End Sub
22.5.5 Como Criar Relatrios Mostrando Pgina N de M

Para criar um Relatrio que a cada pgina imprime um indicativo de Pgina N de M
onde N a pgina atual e M o total de pginas, crie dois Labels e dois Campos de
Dados.
Os dois Labels correspondem aos textos Pgina e de, que devem ser inseridos na
propriedade Caption. Os dois Campos de Dados correspondem aos valores N e M,
com as seguintes propriedades:
Campo N
Name: txtPageNumber
SummaryType: 4 - ddSMPageCount
Campo M
Name: txtPageCount
SummaryType: 4 - ddSMPageCount
22.5.6 Como Criar Relatrios Imprimindo somente Mdias

de Valores a cada 5 Minutos
Para isto, deve-se criar um novo grupo no Relatrio. O grupo criado tem uma Seo
Header e uma Seo Footer. O layout geral o seguinte:
PageHeader: Contm o titulo das colunas
GroupHeader: Permanece vazio, porm a sua propriedade DataField tem o
valor igual a "CLng(E3TimeStamp*288)", pois E3TimeStamp a data e hora
do dado no formato gregoriano (dias desde 1/1/1900), sendo a parte inteira
o nmero de dias e a parte fracionria as horas e os minutos. Multiplicando
por 288 tem-se um nmero inteiro correspondente ao total de cinco minutos
desde 1/1/1900. A funo CLng converte para um nmero inteiro de 32 bits
499
Relatrios
eliminando a parte fracionria, de modo que no apaream os minutos e

segundos intermedirios. O grupo criado vai ser impresso cada vez que este
nmero inteiro mudar, ou seja, a cada cinco minutos. Verifique as
propriedades NewColumn e NewPage, que devem estar configurados para 0
- ddNPNone
Detail: Contm os Campos de Dados para os campos da tabela. A
propriedade Visible est em Falso, de modo que cada uma das aquisies
que compem a mdia de cinco minutos so computadas, porm no
impressas
GroupFooter: Contm os seguintes campos, que representam as mdias dos
Campos de Dados:
DataField: Nomes dos campos da tabela (o mesmo que na Seo Detail)
SummaryFunc: 1 - ddSFAvg
SummaryType: 1 - ddSGrandTotal
A nica exceo para Data/Hora, que um Campo de Dados padro com a
propriedade DataField igual a "=CLng(E3TimeStamp*288)/288".
ReportFooter: Em branco (ou outro valor qualquer)
Se a consulta for entre a zero hora de um dia e outro, o resultado composto por
288 linhas impressas com a mdia dos campos a cada cinco minutos.
Relatrios
500
CAPTULO
23
Segurana
Atravs desta opo, possvel controlar o acesso a Telas, Alarmes, Domnios e

Viewer em uma lista de usurios e grupos. Conforme a opo configurada, a
aplicao permite ou no o acesso aos usurios cadastrados.
As permisses de acesso so configuradas por usurio ou por grupos de usurios.
Os grupos podem ser criados contendo apenas usurios ou tambm outros grupos.
Para acessar as configuraes de usurios, grupos ou permisses, siga este
procedimento:
1. Clique no menu Arquivo - Usurios para mostrar uma caixa de dilogo para
configurao das permisses, dos usurios e dos grupos na aplicao.
501
Segurana
Janela Permisses de usurio
23.1 Usurios
Atravs da aba Usurios possvel configurar as informaes referentes aos
usurios que tm ou no acesso aplicao. Para utilizar este recurso, clique no
menu Arquivo - Usurios e selecione a aba Usurios.
Segurana
502
Aba Usurios

Opes disponveis na aba Usurios
OPO
Nome
Novo
Editar
Remover
Grupos disponveis
Pertence a
503
DESCRIO
Indi ca o us u ri o corrente.
Cri a um novo us u ri o.
Edi ta a s propri eda des do us u ri o
s el eci ona do.
Remove o us u ri o s el eci ona do.
Mos tra os grupos de us u ri os
di s ponvei s na a pl i ca o.
Mos tra os grupos a os qua i s o us u ri o
pertence.
Segurana
OPO
Adicionar
Remover
DESCRIO
Adi ci ona grupos da l i s ta Grupos
disponveis pa ra a l i s ta Pertence a.
Remove grupos da l i s ta Pertence a.
Ao clicar em Novo ou Editar, a caixa de dilogo da figura a seguir mostrada.
Segurana
504
Adicionando usurios na aplicao
505
Segurana
Opes disponveis na janela Adicionar usurios

OPO
Nome
Autenticao do Windows
DESCRIO
Determi na o nome do us u ri o.
Es ta op o permi te a di ci ona r um us u ri o
exi s tente no domni o de rede do
Wi ndows . O nome do us u ri o deve es ta r
no forma to DOMNIO\USURIO. Ao
s el eci ona r es ta op o, toda s a s dema i s
opes da ja nel a fi ca m des a bi l i ta da s ,
exceto Este usurio um administrador e
Esta conta est desabilitada.
Es ta op o cri a o us u ri o no Domni o
Autenticao do E3
corrente do E3.
Determi na a s enha do us u ri o.
Senha
Reconfi rma o da s enha a nteri ormente
Confirme a senha
i nforma da .
Determi na o nome compl eto do us u ri o.
Nome completo
Ha bi l i ta o us u ri o como a dmi ni s tra dor.
Este usurio um administrador
O us u ri o n o pode a l tera r s ua s enha ,
O usurio no pode alterar sua senha
poi s s omente o a dmi ni s tra dor pode
executa r es ta ta refa .
do us u ri o. Qua ndo a da ta de expi ra o
es ti ver prxi ma , mos tra do um l embrete
pa ra renova r a s enha . Ca s o des eje
renov -l a , uma ca i xa de di l ogo a berta
pa ra que o us u ri o confi gure a s enha . Se
a s enha expi ra r a ntes do us u ri o renov l a , n o ma i s pos s vel executa r o login, e
a op o Esta conta est bloqueada
ha bi l i ta da a utoma ti ca mente. Es ta
condi o pers i s te a t que um
a dmi ni s tra dor des bl oquei e a s enha
ma nua l mente.
A senha deve conter no mnimo ... caracteres Determi na um nmero mni mo de
Determi na que a s enha deve conter
l etra s e nmeros .
A senha deve conter no mnimo ... nmeros Determi na um nmero mni mo de
nmeros pa ra a s enha do us u ri o.
Determi na um nmero mni mo de l etra s
pa ra a s enha do us u ri o.
l etra s ma i s cul a s e mi ns cul a s .
minsculas
Indi ca que a conta es t des a bi l i ta da .
Esta conta est desabilitada
Segurana
506
OPO
Esta conta est bloqueada
DESCRIO
Indi ca que a conta do us u ri o es t
bl oquea da . Es ta op o ha bi l i ta da
a utoma ti ca mente ca s o a s enha do
us u ri o expi re ou s e o us u ri o di gi ta r a
s enha erra da v ri a s vezes .
Indi ca que o us u ri o deve troca r s ua
O usurio deve trocar a senha no prximo
s enha qua ndo for executa r o prxi mo
login
login.
Validar senhas sem diferenciar maisculas e Permi te a va l i da o de s enha s ,
i ndependente de s eus ca ra cteres s erem
minsculas
di gi ta dos em ma i s cul a s ou mi ns cul a s .
Es ta op o n o recomenda da .
Ao efetuar o login do usurio (pelo mtodo Login do Viewer ou pelo menu Arquivo Login), abre-se a caixa de dilogo da figura a seguir.
Janela de login
Ao selecionar o modo de autenticao Windows, os campos Nome do usurio e

Senha so desabilitados e preenchidos com o nome e a senha do usurio logado no
domnio de rede. Para selecionar outro usurio pertencente ao domnio de rede,
clique em Outro usurio. Selecionando o modo de autenticao E3, preencha as
informaes de usurio e senha de um usurio do Domnio do E3 nos campos
Nome do usurio e Senha, respectivamente.
Quando a opo Este usurio um administrador habilitada para um usurio,
este usurio pode, em tempo de execuo, alterar todas as configuraes
mostradas na aba Usurios.
Estes privilgios so acessados via script atravs do mtodo UserAdministration do
507
Segurana
Viewer, que habilita a caixa de dilogo dos usurios em tempo de execuo.

NOTA: Apena s o a dmi ni s tra dor tem a ces s o a o mtodo UserAdministration do Vi ewer.
Ao clicar em Remover, a aplicao mostra uma caixa de mensagem questionando

se realmente deseja-se remover o usurio.
possvel que um usurio pertena a um grupo, podendo assim compartilhar as
configuraes deste grupo. Para tanto, na lista Grupos disponveis so mostrados
os grupos disponveis na aplicao que podem conter o usurio selecionado, e na
lista Pertence a, a lista dos grupos aos quais o usurio selecionado j pertence.
Para adicionar um usurio a um grupo, siga estes procedimentos:
1. Selecione o usurio que deseja inserir no grupo especfico.
2. Na lista Grupos disponveis, selecione o grupo ao qual o usurio vai pertencer.
3. Clique em Adicionar, para adicionar o grupo, que aparece na lista Pertence a.
4. Para remover o grupo, selecione-o na lista Pertence a e clique em Remover.
23.2 Grupos
A aba Grupos permite que sejam configuradas as informaes referentes aos
grupos. Cada grupo define caractersticas que so comuns para todos os seus
membros. Um grupo tambm pode pertencer a outros grupos. S no permitido
pertencer a outro grupo que j pertena a ele, ou seja, criar uma referncia
circular.
Para utilizar este recurso, clique no menu Arquivo - Usurios e selecione a aba
Grupos.
Segurana
508
Aba Grupos

Opes disponveis na aba Grupos
OPO
Nome
Novo
Editar
Remover
Grupos disponveis
Pertence a
509
DESCRIO
Indi ca o grupo corrente.
Cri a um novo grupo.
Edi ta a s propri eda des do grupo
s el eci ona do.
Remove o grupo s el eci ona do.
Mos tra os grupos di s ponvei s na
a pl i ca o.
Mos tra os grupos a os qua i s o grupo
s el eci ona do pertence.
Segurana
OPO
Adicionar
Remover
DESCRIO
Adi ci ona grupos da l i s ta Grupos
disponveis na l i s ta Pertence a.
Remove grupos da l i s ta Pertence a.
Ao clicar em Novo ou Editar, a caixa de dilogo da figura a seguir mostrada.
Adicionar grupo
As opes disponveis nesta janela so descritas na tabela a seguir.

Opes disponveis na janela Adicionar Grupos
OPO
DESCRIO
Determi na o nome do grupo.
O us u ri o n o pode a l tera r s ua s enha ,
poi s s omente o a dmi ni s tra dor pode
executa r es ta ta refa .
do us u ri o.
A senha deve conter no mnimo ... caracteres Determi na um nmero mni mo de
Nome do grupo
O usurio no pode alterar sua senha
Segurana
510
OPO
DESCRIO
l etra s e nmeros .
A senha deve conter no mnimo ... nmeros Determi na um nmero mni mo de
nmeros pa ra a s enha do us u ri o.
Determi na um nmero mni mo de l etra s
pa ra a s enha do us u ri o.
l etra s ma i s cul a s e mi ns cul a s .
minsculas
Validar senhas sem diferenciar maisculas e Permi te a va l i da o de s enha s ,
i ndependente de s eus ca ra cteres s erem
minsculas
di gi ta dos em ma i s cul a s ou mi ns cul a s .
Ao clicar em Remover, a aplicao mostra uma caixa de mensagem perguntando se

realmente deseja-se excluir o grupo selecionado.
possvel que um grupo de usurios pertena a outro, podendo assim compartilhar
as configuraes. Para tanto, na lista Grupos disponveis so mostrados os grupos
disponveis na aplicao que podem conter o grupo selecionado, e no item
Pertence a, a lista dos grupos aos quais o grupo selecionado pertence. Para
adicionar um grupo a outro especfico, siga estes procedimentos:
1. Selecione o grupo que deseja inserir em um grupo especfico.
2. Na lista Grupos disponveis, selecione o grupo ao qual o grupo vai pertencer.
3. Clique em Adicionar para adicionar o grupo, que aparece na lista Pertence a.
4. Para remover o grupo, selecione-o na lista Pertence a e clique em Remover.
NOTA: i mporta nte veri fi ca r a hi era rqui a entre us u ri os e grupos . Se o us u ri o tem
uma op o des a bi l i ta da , ma s es ta mes ma op o es t ha bi l i ta da no grupo, va l e a
op o do us u ri o, que pos s ui es te i tem des a bi l i ta do. A op o do grupo s
res pei ta da s e a mes ma op o do us u ri o es ti ver ma rca da como neutra .
23.3 Permisses
A aba Permisses permite configurar as permisses dos usurios e grupos para
Telas, Alarmes, Domnios e Viewers. Uma verificao de permisso consiste em uma
informao que um membro de um grupo tem sobre um comando que atua sobre
um objeto especfico.
511
Segurana
Aba Permisses

Opes disponveis na aba Permisses
OPO
Usurios/Grupos
Segurana
DESCRIO
Es ta op o l i s ta os us u ri os ou grupos de
us u ri os confi gura dos na a pl i ca o.
512
OPO
Itens para segurana
Usurios
Grupos
Permisses
Desabilitar a verificao de permisses
DESCRIO
Os i tens pa ra s egura na di s ponvei s s o:
Telas: Permi te a o us u ri o ha bi l i ta r ou
des a bi l i ta r o a ces s o s Tel a s . Em uma
a pl i ca o, todos os us u ri os ou grupos
tm a ces s o Tel a de a bertura
Alarmes: Ha bi l i ta ou des a bi l i ta o
reconheci mento de a l a rmes pa ra o
us u ri o ou grupo. Em um projeto,
pos s vel exi bi r a s i nforma es de
a l a rmes pa ra v ri os a s s i na ntes da s
i nforma es a tra vs de um objeto de
vi s ua l i za o em Tel a , como por exempl o
o E3Al a rm
Domnios: Permi te confi gura r permi s s es
pa ra executa r, pa ra r ou edi ta r um
Domni o e ter a ces s o remoto a um
Domni o, entre outra s permi s s es
Viewer: Permi te a o us u ri o uti l i za r o
Vi ewer em modo Viewer Full ou Viewer
Only, de a cordo com s ua s confi gura es
um fi l tro da s opes de confi gura o.
Ha bi l i ta ndo es ta op o, pos s vel
vi s ua l i za r s omente os us u ri os
ca da s tra dos na a pl i ca o.
um fi l tro da s opes de confi gura o.
Ha bi l i ta ndo es ta op o, pos s vel
vi s ua l i za r s omente os grupos ca da s tra dos
na a pl i ca o.
Mos tra a s permi s s es dos us u ri os ou
grupos qua nto a os i tens de s egura na
(Tel a s , Al a rmes , Domni os e Vi ewers ).
Des a bi l i ta qua l quer veri fi ca o de
permi s s es . Veja a nota a s egui r s obre o
comporta mento des ta op o.
NOTA: A op o Desabilitar a verificao de permisses deve s er uti l i za da com cui da do,

poi s i mpl i ca nos s egui ntes comporta mentos :
O l ogi n s empre funci ona , mes mo que a s enha es teja erra da ou que s eja uti l i za do
um nome de us u ri o i nexi s tente
As a es s empre s o permi ti da s , mes mo pa ra us u ri os a nni mos
Para cada item de segurana existe uma srie de permisses que podem ser
configuradas para cada usurio ou grupo. As opes disponveis esto descritas
nas tabelas a seguir.
513
Segurana
Opes disponveis para Telas

OPO
DESCRIO
Ha bi l i ta a a bertura de Tel a s .
Abrir Tela
Opes disponveis para Alarmes

OPO
Reconhecer alarme
DESCRIO
Ha bi l i ta o reconheci mento de a l a rmes .
Opes disponveis para Domnios

OPO
Executar Domnio
Parar Domnio
Editar Domnio
Executar como servio
Configurar usurios/grupos
Acesso remoto ao Domnio
Acesso remoto de escrita ao Domnio
DESCRIO
Ha bi l i ta a execu o de um Domni o.
Pa ra o Domni o.
Ha bi l i ta a edi o de um Domni o.
Ha bi l i ta a execu o do Domni o como um
s ervi o.
Permi te confi gura r us u ri os e grupos de
us u ri os .
Ha bi l i ta o a ces s o remoto a um Domni o.
Ha bi l i ta o a ces s o remoto de es cri ta a um
Domni o.
Opes disponveis para Viewers

OPO
Acesso de escrita ao servidor
DESCRIO
Ha bi l i ta o a ces s o de es cri ta a o s ervi dor.
Cada item da lista de permisses pode estar configurado com um dos estados da
tabela a seguir.
Opes da lista de permisses
CONE
ESTADO
Permitido (crculo verde
slido)
No permitido (crculo
vermelho slido)
Segurana
DESCRIO
O coma ndo s el eci ona do
na l i s ta de permi s s es
permi ti do pa ra o us u ri o
ou grupo s el eci ona do,
i ndependente dos grupos
a os qua i s el e pertence.
n o permi ti do pa ra o
us u ri o ou grupo
s el eci ona do,
i ndependente dos grupos
a os qua i s el e pertence.
514
CONE
ESTADO
DESCRIO
Permitido pelo grupo (crculo O coma ndo s el eci ona do
verde vazado)
permi ti do pa ra o us u ri o
ou grupo s el eci ona do, s e
el e for permi ti do nos
grupos a os qua i s o
us u ri o ou grupo pertence.
No permitido pelo grupo
(crculo vermelho vazado)
n o permi ti do pa ra o
us u ri o ou grupo
s el eci ona do, s e el e n o
for permi ti do em pel o
menos um dos grupos a os
qua i s o us u ri o ou grupo
pertence.
O us u ri o ou grupo
No informado
s el eci ona do uti l i za a s
defi ni es dos grupos a os
qua i s pertence e n o h
na da i nforma do nos
grupos . Porta nto, o
coma ndo permi ti do.
No caso de Telas, possvel que a configurao de permisso seja feita por Tela
especificamente. No caso de Alarmes, esta configurao pode ser feita por rea.
NOTA: Em uma a pl i ca o, todos os us u ri os tm a ces s o Tel a de a bertura . Ca s o
des eje que a a pl i ca o s empre i ni ci e com a tel a de login do us u ri o, cri e um
us u ri o s em permi s s o es pecfi ca na Tel a i ni ci a l . As s i m, toda vez que for i ni ci a da a
a pl i ca o, pede-s e o login do us u ri o e a ps , mos tra -s e a Tel a de a bertura .
Com relao a permisses para um usurio annimo, devem ser observadas as

seguintes situaes:
Se no h usurio criado, a verificao de permisses no est habilitada
ou no h usurio com restrio para uma determinada operao, ento
no exigida identificao (o usurio 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 exigida identificao (no permitido o acesso como usurio
annimo)
NOTA: A nomencl a tura e des cri o da s opes de res tri o podem s er a ces s a da s
a tra vs da op o Legenda.
515
Segurana
Caso haja alguma restrio para executar, parar, editar um Domnio ou configurar
os usurios ou grupos, necessrio que um usurio esteja logado no E3. Para
tanto, utilizam-se as opes Login ou Logout, disponveis no menu Arquivo.
Login ou Logout do usurio
A opo Login abre uma caixa de dilogo para o login no E3 Studio. O usurio
permanece logado at que seja feito outro login ou logout.
A opo Logout executa o logout no E3 Studio. Caso no haja um usurio logado,
esta opo est desabilitada.
23.4 Proteo de Arquivos

Protege o contedo de um arquivo .prj ou .lib contra a edio, visualizao ou
execuo no autorizada. Para utilizar este recurso, siga estes procedimentos:
1. Clique com o boto direito do mouse no nome do projeto ou da biblioteca no
modo Explorer e selecione a opo Proteo. No modo Domnio, clique com o
boto direito do mouse no nome do projeto ou da biblioteca, no item
Configurao - Arquivos, e selecione a opo Proteo.
2. A caixa de dilogo a seguir mostrada.
Segurana
516
Proteo de arquivos
Esta janela possui dois tipos de proteo: Proteo de Edio e Proteo de

Execuo.
Proteo de Edio: Protege o arquivo contra alteraes e visualizaes no
autorizadas. Este recurso utilizado para evitar que determinada biblioteca
ou projeto seja alterado acidentalmente, ou que sejam copiados
procedimentos de conhecimento especfico do desenvolvedor
A opo Adicionar proteo permite configurar uma senha de proteo
para a aplicao.
517
Segurana
Adicionar proteo
A opo Alterar senha altera a senha de proteo do E3 Studio para o

arquivo.
Alterao de senha de proteo
A opo Remover proteo remove a proteo de edio deste arquivo.

Para tanto, basta clicar nesta opo, digitar a senha e clicar em OK, que
a aplicao abrir uma caixa de mensagem informando se a ao foi
executada corretamente.
Proteo de Execuo: Esta opo utilizada para proteger o arquivo contra
execuo no autorizada. Para tanto, necessrio solicitar a gravao de
uma senha no dispositivo de proteo, que feita pela Elipse Software. Isto
protege o desenvolvedor de cpias no autorizadas do projeto, por exemplo.
Para isto, no momento do pedido de licena do E3 Server, necessrio
fornecer a senha de execuo. Este processo feito posteriormente compra
do servidor
A opo Adicionar proteo permite configurar uma senha de proteo
para a aplicao.
Segurana
518
Adicionar proteo
A opo Alterar senha altera a senha de proteo de execuo para o

arquivo.
Alterao de senha de proteo
A opo Remover proteo permite remover a proteo de execuo

deste arquivo. Para tanto, clique na opo, digite a senha e clique em
OK, para que a aplicao abra uma caixa de mensagem informando se a
ao foi executada corretamente.
Quando um arquivo .lib ou .prj aberto no E3 Studio, este inicializa mostrando um
cone cinza
, com um cadeado indicando que est protegido e este contedo no
pode ser acessado. Para acessar o contedo do arquivo, clique com o boto direito
do mouse no projeto ou biblioteca e selecione a opo Abrir com senha. Aps
informar a senha e a aplicao liberar o acesso, o cone fica colorido ,
indicando a acessibilidade dos arquivos.
O contedo de arquivos .prj e .lib protegidos criptografado. Quando um projeto
519
Segurana
protegido, as propriedades DocString e Domain so bloqueadas.

IMPORTANTE: As protees i mpl ementa da s n o podem s er des fei ta s ca s o a s
s enha s s eja m perdi da s . Porta nto, a o proteger um a rqui vo, ma ntenha a s s enha s
a rma zena da s em l oca l s eguro. Is s o ga ra nte que pos s vel us a r o a rqui vo s empre
que neces s ri o.
Segurana
520
CAPTULO
24
O E3 Viewer o ambiente de visualizao do E3. Nele, possvel visualizar a

execuo da aplicao feita no E3 Studio.
O E3 WebViewer um componente ActiveX que faz o navegador comportar-se como
o E3 Viewer, o que permite a visualizao e controle de aplicaes E3 via Internet.
Desta forma, possvel visualizar e interagir com um processo de cho de fbrica
atravs de um navegador web comum. O navegador pode estar em qualquer
computador da rede que tenha acesso ao E3 Server.
Depois de instalado, o E3 WebViewer vai funcionar exatamente como o E3 Viewer,
executando o download da aplicao (Telas, bitmaps, etc.) para a mquina local.
Todas as funcionalidades do E3 Viewer (E3Chart, E3Alarm, etc.) so suportadas
pelo E3 WebViewer.
E3 WebViewer em execuo (visualizao de uma aplicao)
521
NOTA: Ta nto o E3 Vi ewer qua nto o E3 WebVi ewer a cei ta m a s mes ma s opes de
zoom des cri ta s no tpi co Zoom do ca ptul o Telas e Objetos de Tela. Al m di s to, a
qua l i da de gr fi ca da s Tel a s pode s er modi fi ca da , em tempo de execu o,
uti l i za ndo-s e o menu contextua l ta nto do E3 Vi ewer qua nto do E3 WebVi ewer e
s el eci ona ndo uma da s opes do menu Qualidade (todas as telas). Pa ra ma i ores
i nforma es , veja a propri eda de RenderQuality do Vi ewer no Manual de Scripts.
24.1 Viewer Only (Modo Somente Leitura)

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

GetAlarm (Fonte de Alarmes)
GetE3QueryFields, GetADORecordSet e GetAsyncADORecordSet
(Consulta)
GetObject (Servidor de Aplicaes)
Mudanas do estado de Advise de Tags do servidor
Mudana da prpria senha (mtodo ChangePassword do Viewer)
24.1.1 Mudanas no Modo do Viewer

Para que o usurio acesse o E3 no modo Somente Leitura, pelo menos uma destas
duas condies deve ser verdadeira:
Licena em uso do tipo Viewer Only
Usurio logado sem permisso para o item Acesso de escrita ao servidor
importante lembrar que, no caso de no haver usurio logado no Viewer (usurio
annimo), aplicada a restrio de acesso, desde que pelo menos um ou mais
usurios tenham esta restrio.
Desta forma, cada vez que ocorre uma mudana de usurio o modo de acesso do
Viewer pode ser mudado (e consequentemente a propriedade IsReadOnly), de
acordo com a combinao do que permitido pela licena em uso e a permisso do
usurio logado.
A mudana do modo de acesso tambm pode acontecer caso ocorra a reconexo do
Viewer, j que esta pode provocar tanto a mudana de licena (de Viewer Full para
Viewer Only, ou 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,
independente da licena em uso, j que o usurio annimo sempre assume a
restrio mxima configurada.
24.2 Execuo do E3 Viewer

Existem trs formas de se executar o E3 Viewer: atravs de um servidor local, de um
servidor na intranet, ou de um servidor na Internet. Os tpicos a seguir detalham
estas formas.
523
24.2.1 Atravs do E3
O E3 Viewer pode ser executado atravs da barra de ferramentas Padro:
Barra de Ferramentas Padro
Executar Aplicativo: Salva todas as configuraes do projeto, roda o

Domnio e executa o E3 Viewer
Rodar/Parar Domnio: Executa ou para a execuo do Domnio
Executar/Parar E3 Viewer: Executa o E3 Viewer ou para a sua execuo
caso ele j esteja aberto
Quando o E3 Viewer executado, a aplicao mostra a janela a seguir, indicando o
estado da conexo.
Mensagem de estado de conexo
Quando a conexo com o servidor perdida, o E3 tenta restabelec-la

automaticamente, respeitando as configuraes do servidor. Para determinar qual
servidor estabelece a conexo caso o E3 Viewer falhe, necessrio configurar a
opo Servidores atravs do E3 Admin, conforme explicado no captulo Domnios.
24.2.2 Atravs da Linha de Comando

O E3 Viewer pode ser acessado via linha de comando da seguinte maneira:
Viewer [nome_do_servidor] [opes]
524
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 no prximo tpico).
As opes de configurao para a linha de comando so as seguintes:
-screen ou /screen: Permite ao usurio informar uma Tela inicial vlida,
diferente da Tela inicial configurada no Domnio
Viewer [nome_do_servidor] screen <nome_da_tela>
-noping ou /noping: Descarta a necessidade de se executar um comando ping

para o servidor antes da tentativa de conexo (tentativa de conexo direta)
Viewer [nome_do_servidor] noping
-readonly ou /readonly: Permite ao usurio especificar que o Viewer deve

tentar conectar apenas no modo Somente Leitura. Quando isto for feito, o
Viewer sempre utiliza uma licena do tipo Viewer Only
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)
Viewer [nome_do_servidor] cachepath <diretorio>
-useservers ou /useservers: Esta opo faz com que o Viewer tente se

conectar somente aos servidores especificados na linha de comando. Se a
opo no estiver presente (comportamento padro), o Viewer pode tentar
descobrir servidores alternativos caso no consiga se conectar aos
servidores passados na linha de comando. Esta opo funciona apenas em
rede local, portanto deve ser informada caso o servidor que o Viewer deve
acessar esteja fora da rede local
Viewer [nome_do_servidor] useservers
-params: Permite que o usurio especifique parmetros de inicializao do

Viewer. Esta opo no pode vir imediatamente antes da lista de servidores.
Os valores passados nesta opo podem ser recuperados via script
utilizando a propriedade Params do Viewer. Para maiores informaes sobre
a utilizao desta propriedade, veja o captulo Viewer, do Manual de Scripts
Viewer -params <Nome1>=<Valor1> [<Nome2>=<Valor2>] ...
-help: Mostra uma caixa de dilogo com exemplos de uso das opes de
linha de comando do Viewer, como na figura a seguir
525
Caixa de dilogo de ajuda do Viewer
24.2.3 Atravs do Menu Iniciar

Para executar uma aplicao cliente, pode-se utilizar o E3 Viewer, disponvel no
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.
526
E3 Viewer
Se o E3 Server estiver na mesma mquina do E3 Viewer, selecione a opo Servidor

Local. Caso estejam em mquinas diferentes, selecione a opo Servidor na rede e
informe o nome ou o endereo IP da mquina com o E3 Server. Se o E3 Server estiver
disponvel em uma porta diferente do padro (6515), informe o nmero desta porta
no campo Servidor na rede aps o nmero do IP, separados por dois pontos. Para
se conectar no modo Somente Leitura, selecione a opo Iniciar o Viewer no modo
apenas de leitura.
24.3 Logs do Viewer

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

Durante a instalao do E3 WebViewer, os arquivos e3web.asp, e3web2.asp,
docwrite.asp, docwrite2.asp e e3downloader.cab ficam disponveis para
configurao pelo usurio. Estes arquivos ficam localizados no diretrio onde o E3
foi instalado, na pasta Web.
e3web.asp e docwrite.asp: Tm a funo de carregar e iniciar o ActiveX
E3Downloader
e3downloader.cab: ActiveX que enviado para a mquina cliente e executa a
instalao do e3webviewer-x86-ptb.exe
e3web2.asp e docwrite2.asp: Tm a funo de carregar e iniciar o ActiveX do
WebViewer que mostra a aplicao sendo executada na mquina do Internet
Explorer
A pgina docwrite2.asp vem configurada considerando-se que o E3 Server est
rodando no mesmo computador que o servidor web. Porm, possvel alterar o
cdigo fonte desta pgina para atender configurao desejada. Para tanto, altere
a linha a seguir no cdigo fonte do arquivo docwrite2.asp:
var Domain = getDomain();
Para:
var Domain = "IP externo do servidor IIS";
Caso se queira permitir ao usurio informar uma Tela inicial vlida, diferente da
configurada no Domnio, deve-se alterar a linha a seguir, colocando em
Nome_da_Tela um nome de Tela vlido na aplicao:
<param name='Screen' value='Nome_da_tela'>
Caso se queira informar a necessidade de se executar o comando ping para o

servidor antes de tentar a conexo, deve-se alterar a linha a seguir. O valor pode
ser "True" ou "False":
<param name='Ping' value='TRUE'>
Se esta linha for omitida, o comando ping executado.

Para se navegar para uma pgina diferente do padro aps o carregamento do E3
WebViewer, deve-se modificar o atributo value do parmetro URLToLoad para o
endereo desejado:
<param name='URLToLoad' value='url'>
Se esta linha for omitida, a pgina e3web2.asp carregada.

528
Para especificar um diretrio para a gravao do cache do Viewer, deve-se alterar a

linha a seguir. Se no for especificado, usado o diretrio temporrio do sistema
(varivel de ambiente TEMP).
<param name='cachepath' value='diretorio_para_cache'>
Caso seja preciso que o WebViewer procure por outros servidores na rede se no
conseguir conectar ao servidor especificado no parmetro Domain, deve-se alterar
a linha a seguir. Se o parmetro no for informado, o WebViewer tenta se conectar
apenas ao servidor especificado no parmetro Domain, que o comportamento
padro do WebViewer (valor True). A alterao do valor para False s funciona
para servidores e WebViewers que estejam na mesma rede.
<param name= 'useservers' value='FALSE'>
A configurao do E3 WebViewer para abrir no modo Somente Leitura feita

atravs da propriedade StartReadOnly (com os valores True ou False). Se este item
no existir, o valor assumido False (comportamento compatvel com verses
anteriores). Exemplo:
var conteudo = "<object classid='clsid:7EB4D157-FACC-45BB-9536C14B9DCE3CA7'";
conteudo += " width='100%' height='100%'>";
conteudo += "<PARAM NAME='Domain' VALUE='192.0.0.21'>";
conteudo += "<PARAM NAME='Screen' VALUE=''>";
conteudo += "<PARAM NAME='CachePath' VALUE=''>";
conteudo += "<PARAM NAME='Ping' VALUE='0'>";
conteudo += "<PARAM NAME='StartReadOnly' VALUE='FALSE'>";
conteudo += "</object>";
document.write(conteudo);
Em ambos os casos, esta configurao s tem efeito na abertura do E3 WebViewer.

Se a propriedade for mudada durante a execuo, a conexo ou reconexo do E3
WebViewer no afetada.
Os servidores e o E3 WebViewer podem tanto rodar na mesma mquina quanto em
mquinas diferentes. Os tpicos a seguir mostram como estas situaes se
aplicam.
24.4.1 Internet Information Services

Tanto para a visualizao na Internet como para visualizao em Intranet ou
mquina local, necessria a instalao e configurao do IIS (Internet Information
Services), ou outro servidor de Internet.
O IIS fornecido juntamente com o Windows. Para instal-lo e configur-lo, siga
1. Abra o menu Iniciar - Painel de Controle (Start - Control Panel) no Windows
Server 2003 SP2, Windows XP SP3, Windows Vista SP2 e Windows 7 SP1, ou
529
abra o item Aplicativos - Sistema do Windows - Painel de Controle (Apps Windows System - Control Panel) na tela Inicial do Windows 8 e Windows 8.1.
2. Clique em Adicionar ou remover programas (Add or remove programs) no
Windows Server 2003 SP2 e Windows XP SP3, ou clique em Programas e
Recursos (Programs and Features) no Windows Vista SP2, Windows 7 SP1,
Windows 8 e Windows 8.1.
3. Clique em Adicionar ou remover componentes do Windows (Add or remove
Windows component) no Windows Server 2003 SP2 e Windows XP SP3, ou
clique em Ativar ou desativar recursos do Windows (Turn Windows features on
or off) no Windows Vista SP2, Windows 7 SP1, Windows 8 e Windows 8.1.
Servios de Informaes da Internet
4. No Windows Server 2003 SP2 e Windows XP SP3, selecione na lista o item

Servios de Informaes da Internet (Internet Information Services) e clique em
Avanar (Next).
5. No Windows Vista SP2, Windows 7 SP1, Windows 8 e Windows 8.1, localize na
lista o item Servios de Informaes da Internet (Internet Information Services) e
clique em para expandir todos os seus subitens.
6. Selecione, no mnimo, as opes a seguir e clique em OK.
530
Ferramentas de Gerenciamento da Web (Web Management Tools)

Console de Gerenciamento do IIS (IIS Management Console)
Scripts e Ferramentas de Gerenciamento do IIS (IIS Management Scripts
and Tools)
Servio de Gerenciamento do IIS (IIS Management Service)
Servios da World Wide Web (World Wide Web Services)
Recursos de Desenvolvimento de Aplicativos (Application Development
Features)
ASP
Extenses ISAPI (ISAPI Extensions)
Filtros ISAPI (ISAPI Filters)
Recursos Http Comuns (Common Http Features)
Contedo Esttico (Static Content)
Documento Padro (Default Document)
Redirecionamento de HTTP (HTTP Redirection)
Segurana (Security)
Autenticao Bsica (Basic Authentication)
Filtragem de Solicitaes (Request Filtering)
7. O IIS inicia a instalao (para instalar o IIS preciso ter o CD de instalao no
Window Server 2003 SP2 e Windows XP SP3).
8. Aguarde a finalizao do processo para configurar o IIS.
Aps a instalao do IIS, os arquivos e3web.asp, e3web2.asp, docwrite.asp,
docwrite2.asp e e3downloader.cab devem ser copiados para c:\InetPub\wwwroot.
Esta pasta criada na instalao do IIS. Alm dos arquivos .asp, o instalador do E3
WebViewer tambm deve ser copiado para esta mesma pasta. Este instalador
(e3webviewer-x86-ptb.exe) utilizado quando a mquina cliente acessar o servidor
pela primeira vez, caso o E3 no tenha sido previamente instalado nesta mquina.
Este arquivo pode ser obtido atravs de download no site da Elipse.
O IIS ainda necessita ser configurado para seu correto funcionamento. A
configurao diferente caso o IIS e o E3 Server estejam na mesma mquina ou em
mquinas diferentes. Para configur-lo, consulte o Guia de Instalao do E3, no
tpico Instalao do E3 WebViewer.
531
24.4.2 Visualizao na Aplicao Cliente

Se o servidor estiver utilizando o servidor web, por exemplo o IIS, digite na barra de
endereos do browser o endereo ou IP do servidor (por exemplo, http://
nomedoservidor/diretorio_virtual ou http://192.0.0.21/diretorio_virtual), onde
diretorio_virtual o diretrio criado na configurao do IIS (conforme o Guia de
Instalao do E3).
No primeiro acesso ao servidor, o navegador inicia a instalao dos componentes,
caso estes no tenham sido previamente instalados, conforme explicado no
comeo deste captulo. O componente assinado pela Elipse Software e o usurio
deve aceitar a instalao para que se iniciem as configuraes necessrias.
Instalao do Web Viewer
Aps a instalao, o E3 WebViewer est aberto no browser, e visualizando a

aplicao do servidor. Nos prximos acessos no mais necessrio instalar os
componentes e o tempo de conexo mais rpido.
NOTA: A vers o do cl i ente tem que s er a mes ma do s ervi dor. Pa ra i s to, o i ns ta l a dor
(e3-w2kwebvi ewer.exe) no s ervi dor deve s er s empre o ma i s a tua l .
532
CAPTULO
25
Hot-Standby
O Hot-Standby permite a implementao do conceito de fail-over em um sistema

supervisrio. Este conceito consiste na possibilidade de se ter dois servidores
(principal e backup) atuando um como contingncia do outro, ou seja, se o servidor
principal falhar, um servidor de backup entra em ao imediatamente, sem perda
da continuidade do processo. Este servidor em espera diz-se que est em Standby.
Assim, a ferramenta de Hot-Standby do E3 tem como objetivo permitir que um
servidor fique em estado de espera (Standby), aguardando uma possvel falha de
um outro servidor (servidor ativo). A troca de servidor ativo pode ser manual ou
automtica.
A troca manual acionada atravs do menu do E3 Admin na rea de Notificaes
do Windows do computador em Standby (opo Servidor - Ativar). A troca
automtica ocorre quando o servidor em Standby detecta que o servidor principal
no est mais rodando. Um servidor pode assumir um dos seguintes estados:
Servidor em Manuteno: Este estado indicado na configurao do
servidor do Domnio. Um servidor em manuteno no toma parte em
nenhum evento do Domnio
Servidor Ativo: Apenas um servidor pode estar ativo em um Domnio em um
determinado momento. O servidor ativo aquele que est rodando o
aplicativo (E3Run)
Servidor Standby: Apenas um servidor pode estar em modo Standby em um
Domnio em um determinado momento. O servidor Standby roda o E3Run em
modo Standby, o aplicativo permanece carregado, apenas esperando um
comando para entrar em operao. O servidor Standby monitora o servidor
ativo e, se este no estiver respondendo, o Standby ativado
Servidor Inativo: Um servidor permanece inativo quando est declarado no
Domnio, mas no est selecionado como servidor principal nem como
backup. Mesmo inativo, este servidor monitora mudanas no arquivo de
Domnio, podendo passar para o estado Ativo ou Standby se o Domnio for
reconfigurado
IMPORTANTE: Pa ra roda r uma a pl i ca o redunda nte no E3, neces s ri o que todos
os s ervi dores rodem a mes ma vers o do s oftwa re, e tenha m uma cpi a l oca l
a tua l i za da dos a rqui vos do Domni o (a rqui vos .prj, .l i b, etc.). O a rqui vo .dom, por
s ua vez, s i ncroni za do a utoma ti ca mente pel o E3 Server, i s to , muda na s fei ta s no
a rqui vo .dom em um s ervi dor s o a utoma ti ca mente copi a da s pa ra o a rqui vo .dom
dos outros s ervi dores do Domni o. Pa ra i s to, o a rqui vo .dom deve obri ga tori a mente
exi s ti r no mes mo ca mi nho em todos os s ervi dores .
533
Hot-Standby
O Hot-Standby usa a conexo REC, portanto ele s funciona se o E3 Server estiver

iniciado nas mquinas envolvidas.
Se o usurio de um E3 Studio ou Hot-Standby administrador da mquina remota
onde o E3 Server est rodando, ele pode controlar o servio remotamente usando o
aplicativo services.msc, atravs da opo Action - Connect to another computer.
25.1 Configurando
As configuraes que devem ser feitas para implementar o Hot-Standby so as
seguintes:
1. Localize o caminho dos arquivos de Domnio (arquivos .dom, .prj, .lib, etc.) no
computador principal e copie esta pasta para o computador Standby. Caso
tenha sido indicado um outro caminho para os arquivos de Domnio na opo
Pasta raiz dos arquivos do Domnio na aba Servidores, deve-se utilizar este
caminho para a cpia.
2. Os arquivos de bancos de dados devem ser tratados de maneira diferenciada.
Para maiores informaes, veja o tpico Utilizando Bancos de Dados com HotStandby.
3. Clique com o boto direito do mouse no cone do E3 Admin
na rea de
Notificaes do Windows e selecione a opo Domnio - Opes.
E3 Admin
4. Na aba Servidores, adicione os servidores principal e backup. Configure as

opes Nome do servidor e Identificao do servidor na rede, conforme descrito
no tpico Domnios - Configuraes de Domnio - Servidores. Por exemplo:
Nome do servidor: Servidor1
Identificao do servidor na rede: \\Computer1
Hot-Standby
534
5. Na aba Opes, selecione o item Hot-Standby - Habilitar. No campo Servidor

principal, selecione o servidor principal do projeto e, no campo Servidor de
backup, selecione o servidor de backup. O E3 busca o servidor principal por
ordem alfabtica.
6. Defina a opo Endereos para PING de integridade de rede, conforme
especificado no item Endereos para PING de integridade da rede do tpico
Domnios - Configuraes de Domnio - Opes.
7. Habilite a opo Ativar backup em caso de falha local, conforme especificado no
item Ativar backup em caso de falha local do tpico Domnios - Configuraes de
Domnio - Opes.
8. Para confirmar as configuraes, clique em OK.
9. Ao iniciar a execuo do E3 mostrado, na rea de Notificaes do Windows
dos computadores configurados no Hot-Standby, um cone representado por
uma barra amarela circulante , indicando que os Domnios esto sendo
carregados. Aps alguns segundos, o E3 reconhece o computador principal e
indica este estado, na rea de Notificaes do Windows, com um cone
representado por uma seta verde . Este cone determina que este computador
est em execuo. No computador standby mostrado um cone representado
por duas barras amarelas
, indicando que este computador est em modo
Standby (modo de espera).
25.2 Executando um Domnio Redundante

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

Um Domnio pode ser iniciado tambm atravs do E3 Studio. Para tanto, abra o
Domnio e clique em na barra de ferramentas Padro.
25.3 Parando um Domnio Redundante

Um Domnio pode ser parado por qualquer um dos seus servidores, atravs do
cone
na rea de Notificaes do Windows. Selecione a opo Domnio - Parar e
o servidor Ativo e o Standby terminam o processo E3Run. O Domnio pode ser
reiniciado selecionando a opo Domnio - Executar. Se for selecionada a opo
Domnio - Fechar, o Domnio parado e fechado, ficando os E3 Servers disponveis
para rodar outros Domnios.
535
Hot-Standby
IMPORTANTE: As opes de pa ra r e fecha r um Domni o AFETAM TODOS OS

SERVIDORES DO DOMNIO, e n o a pena s o s ervi dor onde o coma ndo executa do.
25.4 Parando um dos Servidores do Domnio

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

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

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

Pode-se ter dois servidores rodando separadamente em uma mesma aplicao. Um
deles permanece ativo, enquanto o outro permanece em estado de espera (standby),
aguardando uma possvel falha.
O Hot-Standby garante a continuidade da aplicao, mas quando se utiliza bancos
de dados, tambm preciso garantir a continuidade do acesso base de dados.
H duas maneiras de resolver este problema. Na primeira, ambas as aplicaes
acessam uma mesma base de dados. Habilita-se o acesso ao banco de dados na
aplicao, configurando o objeto DBServer em ambos servidores (Principal e
Standby) com os mesmos parmetros de localizao do banco de dados na rede.
Para garantir a continuidade do sistema, importante que a base de dados esteja
em uma mquina separada, acessvel aos dois servidores.
Na segunda maneira, a gravao dos dados feita em bases diferentes. Neste caso,
Hot-Standby
536
o ideal ter-se os dois bancos de dados rodando localmente, em ambos os

servidores. Assim, garante-se que o acesso ao banco de dados est sempre
disponvel, pois a mquina que roda a aplicao tambm roda o banco de dados.
Uma opo interessante neste caso o sincronismo entre as diferentes bases de
dados da aplicao principal e secundria. A propriedade EnableSynchronization
do objeto DBServer habilita este recurso na aplicao. Quando ela est ativa, todos
os dados gravados na base principal so atualizados na base em Standby quase
instantaneamente.
NOTA: Se a a pl i ca o pri nci pa l n o cons egui r envi a r os da dos pa ra o s ervi dor em
Standby, es s es da dos fi ca m a rma zena dos l oca l mente em di s co, pa ra pos teri or envi o
qua ndo a comuni ca o entre os doi s computa dores for res ta bel eci da , a s s egura ndo
a s s i m a i gua l da de entre a s ta bel a s gera da s pel a a pl i ca o.
537
Hot-Standby
CAPTULO
26
Existem configuraes do E3 que podem ser realizadas diretamente no Registro do

Windows, embora esse procedimento no seja aconselhvel. A Elipse Software
possui uma ferramenta, chamada E3 Tweak, que realiza as configuraes de
registro usando uma interface grfica. O Manual do Usurio do E3 Tweak pode ser
aberto pelo menu Iniciar - Programas - Elipse Software - Elipse E3 - Manuais - Manual
do E3 Tweak. O aplicativo E3 Tweak pode ser aberto de trs formas:
Pelo menu Iniciar - Programas - Elipse Software - Elipse E3 - E3 Tweak
Pelo menu Ferramentas - E3 Tweak do E3 Studio
Pelo item Atalhos - E3 Tweak do menu do E3 Admin na rea de Notificao do
Windows
538
CAPTULO
27
Este captulo destina-se ao esclarecimento das dvidas mais frequentes

encontradas no E3. Tambm so mostrados os erros que podem ocorrer e quais as
solues para eles.
27.1 Ordem dos Tabs

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

Criei uma Animao com Rotao ou Translao na Tela, mas decidi mud-la, criando
uma nova Animao. No entanto, quando fui executar a aplicao, o objeto apareceu
com a Animao inicial, e no com a Animao corrente. Por qu isto ocorre?
POSSVEL CAUSA
A nova Animao foi criada sem que a anterior tenha sido removida.
SOLUO
Para solucionar esta questo, siga estes procedimentos:
1. Selecione o objeto que deseja mudar a Animao.
2. Clique com o boto direito do mouse neste objeto e selecione a opo Remover
animao.
3. Aplique a Animao desejada.
NOTA: N o tente remover a Ani ma o do objeto a tra vs do Orga ni zer, poi s es ta a o
remove o objeto.
27.3 Objetos de Tela

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

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

A seguir so listados os possveis erros que podem ocorrer ao se testar a conexo
com este Banco de Dados:
540
Error = ORA-01017: invalid username/password; logon denied

POSSVEL CAUSA
Mensagem gerada em log quando a senha ou o usurio est incorreto.
SOLUO
Verificar se o usurio existe e se a senha utilizada est correta.
Error = ORA-12154: TNS: no foi possvel resolver nome de servio
POSSVEL CAUSA
A conexo cliente utilizada no foi encontrada.
SOLUO
Verificar se a conexo utilizada est criada no computador e se ela est
funcionando atravs dos utilitrios de rede do Oracle.
Error = ORA-02264: nome j usado por uma restrio existente
POSSVEL CAUSA
J existe um objeto no Banco de Dados com este mesmo nome.
SOLUO
Para evitar este erro, crie e configure diferentes nomes de ndices ou chaves
primrias no E3.
Error = ORA-01403: dados no encontrados
POSSVEL CAUSA
Esta mensagem gerada quando uma pesquisa interna do E3 procura por objetos
no Banco de Dados e no os encontra (por exemplo, a tabela de Histricos no
existe, deve ser criada).
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 recusada e a mensagem
anterior exibida. interessante verificar que o nome da chave mostrado (neste
caso, a chave SYSTEM.E3INDEX) no formato Usurio.NomeChave. Dependendo do
projeto, este erro esperado, mas na grande maioria das vezes, importante
541
verificar se a chave a mais adequada. Para ilustrar esta afirmao, veja estes
dois casos:
Sistema de Telemedio de Energia: Visando gravar todos os dados de um
dia, as rotinas usadas para coletar dados admitem tolerncias a mais ou a
menos no horrio a ser coletado. Assim, alguns dos registros tm de ser
escritos mais de uma vez. Neste caso, a ocorrncia deste erro esperada
Manuteno de alarmes: Para este 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 chaveprimria pode ser a soluo adequada
SOLUO
H duas maneiras de solucionar esta questo:
1. O usurio deve criar um ndice nico para os campos da chave.
2. O usurio deve verificar a aplicao para que ela no envie valores repetidos
de chave para gravao.
27.6 Servidor de Dados

A propriedade Retentive do Tag Interno no est funcionando, pois ela no guarda o
ltimo valor ao parar o Domnio. O qu pode estar errado?
A propriedade Retentive no tem este objetivo. Ela tem utilidade apenas em
aplicaes Hot-Standby, para manter o valor do Tag Interno quando houver uma
troca de servidor.
Como salvar o valor de um Tag Interno ao parar o Domnio?
Use o mtodo Save do Servidor de Dados.
Como eu mostro a data e a hora atual do sistema em uma Tela da minha aplicao?
Crie um Tag Demo do tipo CurrentTime e associe-o a um Display na Tela. O formato
de data e hora pode ser configurado na aba Formatao das propriedades do
Display.
Como criar um temporizador no E3?
Com um Tag Demo do tipo Square. O Tag deve ter a propriedade Enabled igual a
False e a propriedade Period igual a duas vezes o tempo limite em milissegundos. A
atribuio do valor Verdadeiro propriedade Enabled inicia a contagem do tempo.
Para executar um script qualquer no trmino do temporizador, crie um evento
542
associado propriedade Value do Tag Demo, que seja executado quando a

propriedade alterar o seu valor. Neste script tambm se deve desabilitar o Tag
Demo, ou seja, atribuir propriedade Enabled o valor False, para que ele no
continue variando. Recomenda-se usar o mtodo Reset do Tag Demo antes de
atribuir propriedade Enabled o valor True.
27.7 Drivers de Comunicao

O que tenho que fazer para usar os bits de um Tag de Comunicao?
Para usar os bits de um Tag de Comunicao, deve-se habilitar a propriedade
UseBitFields do Tag.
Como so contados os Tags Bloco e os bits dos Tags no E3?
A contagem considera os Tags de Comunicao e o tamanho dos Blocos de
Comunicao. Os bits no entram na contagem.
Qual a maneira mais fcil de fazer piscar a cor de um objeto na Tela quando houver
um erro de comunicao?
Crie uma Associao Digital entre a propriedade ForegroundColor do objeto e a
expresso NomeDoTag.Quality < 192, com a opo de pisca habilitada. A
propriedade Quality representa o estado da qualidade do valor do Tag, no padro
OPC, e pode variar de 0 a 255, sendo que a qualidade boa apenas acima do valor
192.
Como sinalizar erros de comunicao na Tela?
Habilite a opo Erros de Comunicao do objeto Viewer, na aba Erros de
Comunicao.
Como trocar a cor padro dos erros de comunicao em Setpoints e Displays?
Abra a janela de propriedades do objeto Viewer e altere a cor desejada na aba
Erros de Comunicao.
27.8 Alarmes
Foi encontrado um erro no nmero de colunas do arquivo CSV na importao de um
Alarme do tipo <nomedotipo>. Deseja continuar a importao dos demais Alarmes,
ignorando os erros?
POSSVEIS CAUSAS
O arquivo CSV para os alarmes que se quer importar possui um erro nas colunas
do Alarme do tipo indicado. Arquivos de alarmes devem ter sempre o nmero
mnimo de colunas esperado, de acordo com cada tipo. Colunas extras so
543
desprezadas. Para saber a maneira correta de criar um arquivo CSV para alarmes,
veja o tpico Criando um arquivo CSV manualmente no captulo E3 Studio.
SOLUO
Existem trs possveis respostas pergunta feita na mensagem de erro:
Sim: A importao dos Alarmes contidos no arquivo CSV prossegue,
ignorando apenas este erro de nmero de colunas. O Alarme cujas colunas
esto incorretas no importado
Sim (Todos): A importao dos Alarmes prossegue, ignorando todos os
demais Alarmes com erro no nmero de colunas que possam existir no
arquivo CSV
No: A importao interrompida, mas os Alarmes j importados so
preservados
Para que este erro no ocorra, o arquivo CSV deve ser criado de acordo com as
recomendaes do captulo Alarmes.
IMPORTANTE: Embora os a rqui vos de Ta gs e Al a rmes tenha m a mes ma extens o
(.cs v), el es s o i nterna mente di ferentes . Sendo a s s i m, um a rqui vo de Al a rmes n o
s erve pa ra Ta gs e vi ce-vers a .
Criei um arquivo CSV manualmente, contendo a configurao dos Alarmes. Como

fao para import-lo?
Verifique as configuraes regionais no Painel de Controle do Windows, e confirme
se o caractere separador o mesmo utilizado no arquivo CSV. DICA: crie um Alarme
no E3 e utilize a ferramenta de exportao, utilizando-o como modelo para a
gerao dos novos Alarmes.
Como mostrar o campo E3TimeStamp com milissegundos no E3Browser e no
E3Alarm?
Use o formato Outros, digitando "dd/MM/yyyy HH:mm:ss.000". Esta configurao
para o E3Browser feita na aba Fontes de Dados, na coluna Formato de cada
campo. Para o E3Alarm, tal configurao feita na aba Colunas, clicando em
Propriedades de cada campo.
Aparece a seguinte mensagem de erro: "Impossvel criar assinaturas de Alarmes no
Servidor de Alarmes com filtro. Error code: (0x800706F7)". O qu isto significa?
O nome do Servidor de Alarmes no foi especificado no E3Alarm, ou ento est
errado. Para que o E3Alarm consiga capturar e exibir os Alarmes ativos,
necessrio configurar o nome do Servidor de Alarmes a ser acessado. Para isto,
modifique o item Nome do Servidor de Alarmes, na aba Geral das propriedades do
544
objeto E3Alarm, ou atravs da Lista de Propriedades, acessando a propriedade

AlarmServer.
Como apagar Tags associados a Alarmes e reas do objeto Configurao de Alarmes?
Para apagar um Tag que est associado a um Alarme: Selecione o Tag
desejado com o mouse e pressione a tecla DELETE
Para apagar um Alarme: Selecione o Alarme desejado com o mouse e
pressione a tecla DELETE
Para apagar uma rea: Selecione a rea desejada com o mouse e pressione a
tecla DELETE
Como exibir as mensagens "Alta", "Mdia" e "Baixa" no campo Severidade de um
Alarme ao invs dos valores 0, 1 e 2 em uma consulta SQL?
A sintaxe SQL para cada um dos bancos de dados suportados pelo E3 a seguinte:
Access:
SELECT InTime, OutTime, Message, FormattedValue,
IIF(Severity = "0", "Alta",
IIF(Severity = "1", "Mdia", "Baixa"))
AS Severidade FROM Alarms;
SQL Server:
Severidade = CASE Severity
WHEN 0 THEN 'Alta' WHEN 1 THEN 'Mdia'
WHEN 2 THEN 'Baixa' END FROM Alarms;
Oracle:
DECODE(Severity, 0, 'Alta', 1, 'Mdia', 2, 'Baixa')
Severidade FROM Alarms;
27.9 E3Alarm
Os Alarmes no aparecem no E3Alarm. Por qu isto ocorre?
POSSVEIS CAUSAS
Para checar a configurao do E3Alarm, verifique se o nome do Servidor est
configurado corretamente. Outra possibilidade a existncia de mais de um
Servidor de Alarmes no Domnio, o que pode gerar problemas. Mais uma situao
de erro seria um filtro configurado para uma rea de Alarme inexistente.
545
SOLUO
Certifique-se de que existe apenas um Servidor de Alarmes no Domnio e que todos
os Alarmes esto configurados corretamente. Confira tambm se a rea
configurada existe.
Como criar um filtro por duas ou mais reas no E3Alarm?
Primeiro, agrupe as reas em uma rea principal. Depois, use nomes com os
mesmos caracteres iniciais. Exemplo: ALM1MEC, ALM1ELE, ALM2MEC, ALM2ELE, etc.
Como reconhecer Alarmes com duplo-clique?
Habilite a opo Reconhecer Alarme, localizada nas propriedades da coluna
desejada no objeto E3Alarm, na aba Colunas.
27.10 E3Browser
Como limitar o nmero de registros que aparecem no E3Browser?
Este item pode ser configurado na consulta do E3Browser. Habilite a caixa de
seleo Retornar no mximo ... registros, especificando o nmero mximo de
registros a serem retornados. Outra opo otimizar a consulta a ser feita
utilizando os filtros para restringir o perodo, a quantidade de colunas ou registros
envolvidos, etc. Para isto, veja o captulo Consultas.
27.11 E3Chart
possvel no plotar o valor de um Tag quando a qualidade estiver ruim, em um
E3Chart histrico?
Sim. Utilizando scripts possvel configurar o E3Chart da seguinte forma:
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 sempre plotado, independente da qualidade do Tag.
27.12 Histrico
Como no gravar os registros de Histricos por scan?
Configure a opo Gravar um novo script a cada, na aba Histrico das propriedades
do Histrico, com o valor 0 (zero). Se desejar faz-lo por script, a propriedade a ser
utilizada ScanTime. Com isto, os valores no so registrados automaticamente,
sendo necessrio executar o registro via script utilizando o mtodo WriteRecord.
546
27.13 Associaes
Como criar um Tag Expresso no E3?
Associando a propriedade Value de um Tag Interno expresso desejada. A
expresso pode ser do tipo simples e pode conter operadores aritmticos e lgicos
envolvendo constantes e outros Tags.
Como mudar a cor de um objeto ao passar o mouse sobre ele?
Criando uma Associao Digital entre as propriedades ForegroundColor e
MouseOver de um objeto. A propriedade MouseOver do tipo Booleana, e assume o
valor Verdadeiro quando o mouse estiver sobre objeto e Falso quando o mouse
estiver fora da rea do objeto.
Como criar uma aplicao multilngue?
H duas formas de se fazer isto. Uma delas criar um Tag Interno no Viewer para
cada String e associar estes Tags s propriedades que devem ser traduzidas (ou
utilizar os Tags por script no caso do mtodo Msgbox). Depois, criar uma tabela
com todas as Strings da aplicao, onde a primeira coluna o nome do Tag Interno
criado no Viewer, e cada coluna seguinte contm a String correspondente a um
idioma. Esta tabela pode ser criada no Access, por exemplo. Ao abrir o Viewer e
definir o idioma, carregar os Tags Internos do Viewer com as Strings da tabela
correspondente ao idioma escolhido. Isto pode ser feito utilizando um objeto
Consulta na Tela. Segue um exemplo de script:
Sub Tela1_OnPreShow(Arg)
Set rs = Item("Query1").GetADORecordset()
rs.MoveFirst
For i = 1 To rs.RecordCount
Application.Item(rs.Fields("NomeTag").Value).Value = _
rs.Fields(Arg).Value
' Arg um parmetro passado para a Tela contendo o nome
' da coluna referente ao idioma selecionado
rs.MoveNext
Next
End Sub
Outra maneira criar uma Associao por Tabela em todas as propriedades que
possuem contedo a ser traduzido, usando para todas as Associaes a mesma
fonte. Em cada faixa de valores da Associao, coloque uma String referente a um
idioma diferente. A fonte pode ser um Tag Interno cujo valor pode ser definido ao
abrir o Viewer. No caso do mtodo MsgBox, use o mesmo Tag como condio para
escolher qual String utilizada.
547
27.14 Viewer
No consigo conectar um Viewer remoto ao Servidor. Por qu isto est
acontecendo?
POSSVEL CAUSA
Existe um firewall bloqueando o acesso ao servidor.
SOLUO
Deve-se liberar as portas utilizadas pelo E3. O procedimento para desbloquear uma
porta no firewall do Windows est descrito a seguir.
NOTA: A porta pa dr o uti l i za da pel o E3 a 6515, ma s es te comporta mento pode s er
a l tera do conforme des cri to no tpi co Execuo do E3 Viewer - Execuo atravs do
Menu Iniciar.
Windows XP SP3
1. V ao menu Iniciar - Painel de Controle (Start - Control Panel).
2. Clique em Central de Segurana (Security Center).
3. Clique em Firewall do Windows (Windows Firewall).
4. Selecione a aba Excees (Exceptions) e clique em Adicionar Porta (Add Port).
5. Digite um nome e o nmero da porta a ser liberada. Deixe a opo Protocolo
(Protocol) selecionada como TCP.
6. Clique em OK para salvar as alteraes.
Windows Vista SP2
3. Selecione a aba Excees (Exceptions) e clique em Adicionar Porta (Add Port).
4. Digite um nome e o nmero da porta a ser liberada. Deixe a opo Protocolo
(Protocol) selecionada como TCP.
5. Clique em OK para salvar as alteraes.
Windows 7 SP1, Windows 8 e Windows 8.1
3. Clique em Configuraes Avanadas (Advanced Settings).
548
4. Clique com o boto direito do mouse no item Regras de Sada (Outbound Rules)
e selecione a opo Nova Regra (New Rule).
5. Selecione o item Porta (Port) na janela Tipo de Regra (Rule Type) e clique em
Avanar (Next).
6. Selecione a opo TCP e, no item Portas remotas especficas (Specific remote
ports), digite o nmero da porta a ser liberada.
7. Na prxima janela, selecione o item Permitir a conexo (Allow the connection).
8. Digite um nome para a porta e clique em OK para salvar as alteraes e fechar
a janela.
No consigo abrir um Viewer remoto pelo Internet Explorer. Por qu isto est
acontecendo?
POSSVEIS CAUSAS
O Viewer no foi instalado na mquina remota
Existe um firewall bloqueando o acesso ao servidor
SOLUO
Pode-se instalar o Viewer na mquina remota ou ento colocar o arquivo de
instalao do Viewer na pasta C:\Inetpub\wwwroot do computador servidor.
Assim, toda vez que se tentar abrir um Viewer pelo Internet Explorer em um
computador remoto onde o Viewer no foi previamente instalado, a instalao
iniciada automaticamente.
27.15 Bibliotecas
Ao abrir uma Tela, aparece uma mensagem dizendo que um objeto no pode ser
carregado corretamente
POSSVEL CAUSA
Foi apagado algum XControl da Biblioteca que estava sendo usada dentro desta
Tela ou ento foi removido do Domnio a Biblioteca que contm este XControl.
SOLUO
No primeiro caso, se foi apagado o XControl, no h mais como recuper-lo. Para
corrigir o erro, apague o objeto ElipseX que ficou dentro da Tela (pelo Organizer
pode-se ver um ponto de interrogao sobre o cone do objeto. Na Tela aparece um
quadrado preto com um "X"). No segundo caso, adicione a Biblioteca ao Domnio.
549
Ao abrir uma Tela, aparece uma mensagem de erro dizendo que no foi possvel
abrir uma Biblioteca ActiveX
POSSVEL CAUSA
Alguns ActiveX utilizados nesta Tela no foram registrados e adicionados no
computador.
SOLUO
Registre e adicione o ActiveX atravs da opo Adicionar ActiveX, disponvel no
menu Ferramentas. Para tanto, deve-se ter o arquivo OCX que contm a Biblioteca.
Ao inserir um ActiveX na minha Tela ocorreu um erro 80040112. O qu isto
significa?
POSSVEL CAUSA
Este erro indica que o ActiveX a ser inserido no est licenciado na mquina.
Durante o instanciamento, o controle procura no Registro do Windows por sua
chave de licena (HKEY_CLASSES_ROOT\Licenses) e, caso no encontre, retorna este
erro. Existem chaves de licena para os objetos ActiveX, tanto para ambientes de
desenvolvimento quanto para tempo de execuo.
SOLUO
Para resolver este problema, preciso adquirir a licena deste ActiveX e registr-lo
no computador.
Tenho duas Bibliotecas em meu Domnio, mas no consigo utiliz-las ao mesmo
tempo. Quando registro uma, a outra deixa de funcionar. Como posso resolver este
problema?
Provavelmente, uma das Bibliotecas foi criada a partir da cpia da outra,
permanecendo as duas com o mesmo identificador. Por isto, necessrio remover
uma delas do Domnio.
27.16 Relatrios
Como colocar a data e a hora atual em um Relatrio do E3?
Existem pelo menos duas alternativas:
Coloque um objeto Texto na Seo Page Header e, no evento OnFormat desta
Seo, escreva o seguinte script (Label1 o nome do objeto Texto):
Report.Sections("PageHeader").Controls("Label1")._
Caption = Now
Crie um Tag Demo do tipo CurrentTime. No cabealho ou no rodap do

Relatrio, deve-se inserir um objeto SetPoint e, na propriedade DataField,
550
deve-se digitar o nome completo do Tag (por exemplo,

"Dados.TagDemo1.Value"). Configure o formato da data desejada. Isto pode
ser feito clicando com o boto direito do mouse no objeto e ajustando as
suas propriedades, ou ento digitando diretamente o formato na
propriedade OutputFormat, na Lista de Propriedades (um exemplo de
formato de data "dd/MM/yyyy hh:mm:ss").
Tenho um Relatrio que mostra o resultado de uma Consulta que possui um filtro
por data. Quando o Relatrio gerado, a Consulta no retorna os valores
configurados via script para estas variveis. Como solucionar este problema?
Verifique, no script que configura ou acessa este Relatrio, se aps os valores para
as variveis da Consulta terem sido configurados no foi acionado o mtodo
LoadReport, j que este mtodo carrega o Relatrio com as configuraes feitas no
E3 Studio. Utilize somente uma vez o mtodo LoadReport no script, carregando o
Relatrio para uma varivel (atravs do comando Set).
Como executar corretamente um Relatrio que utiliza o mtodo CopyConfig para
copiar para si as configuraes de um E3Chart em Tela?
O mtodo CopyConfig no copia os valores de variveis de consulta, sendo
necessrio executar este procedimento via script dentro do grfico. As Penas
configuradas no E3Chart em Tela so do tipo Real.
Como criar um filtro por datas no Relatrio?
Crie uma Consulta SQL no Relatrio filtrando por data inicial e final. Na Tela onde
se deseja gerar este Relatrio, deve-se executar a Consulta SQL configurada
passando os valores de data inicial e final. O script do boto na Tela onde gerado
o Relatrio, por exemplo, pode ser implementado da seguinte forma:
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 na Seo Page Header do
Relatrio?
Primeiro, adicione dois SetPoints na Seo Page Header (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 na Seo Page Header, no evento OnBeforePrint do
Relatrio o seguinte:
Set dados = Application.GetFrame().Screen
551
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?
Crie o seguinte script no evento OnReportStart do Relatrio:
Sub OnReportStart
Report.Printer.DeviceName = "Nome da Impressora"
End Sub
Como utilizo o evento de script OnError para mostrar uma mensagem de erro
quando falhar a impresso do Relatrio?
O evento OnError do Relatrio no permite que sejam executados scripts dentro
dele, servindo somente para seu uso interno. Isto significa que no possvel
alterar a mensagem de erro, nem executar algum outro procedimento a partir deste
evento.
27.17 Domnios e Projetos

O qu acontece com os eventos gerados pelo E3 Server enquanto o Domnio no
est rodando?
Sempre que o registro de eventos estiver habilitado, o E3 Server coloca 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
so enviadas para este E3 Server
Se o Domnio for fechado, todas as mensagens que ainda no foram
gravadas so descartadas
Utilizei o E3 Admin via linha de comando e apareceu um erro. Por qu isto ocorreu?
Muitas vezes, quando se utiliza o E3 Admin via linha de comando, pode-se
configurar algum parmetro errado, o que acaba provocando uma mensagem de
erro. As mensagens de erro que podem aparecer so as seguintes:
552
O Domnio no pode 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 do Domnio. Para maiores informaes, consulte o
captulo Domnios
Como duas ou mais pessoas podem trabalhar ao mesmo tempo no mesmo Domnio?
Criando o Domnio pela rede, vrias pessoas podem abri-lo em mquinas
diferentes e trabalhar nele ao mesmo tempo. As alteraes salvas por uma pessoa
so visveis para todas as outras, assim que abrirem o objeto especfico alterado,
ou ento assim que atualizarem o projeto ou a Biblioteca alterados.
Qual o efeito de clicar na opo Atualizar do menu do projeto?
Todos os objetos do projeto so atualizados. Por exemplo, se vrias pessoas
estiverem trabalhando ao mesmo tempo no mesmo Domnio, as alteraes salvas
por uma pessoa so visveis para todas as outras, assim que abrirem o objeto
especfico alterado ou quando atualizarem o projeto ou a Biblioteca alterados.
27.18 Stored Procedure

Como executo uma Stored Procedure no E3?
A maneira mais fcil criando uma Consulta no E3 com o comando para executar a
Stored Procedure desejada passando, se necessrio, valores para ela. O comando
que deve ser configurado nesta Consulta o seguinte:
Exec NomeDaStoredProcedure <%var1%>, <%var2%>, ...
A sintaxe para as variveis deve ser o caractere "<" (menor que), o caractere
"%" (percentual), o nome da varivel, o caractere "%" novamente e por fim o
caractere ">" (maior que). Os valores var1 e var2 so as variveis que a Stored
Procedure est esperando (por exemplo, a data inicial e final). Caso a Stored
Procedure no esteja esperando nenhuma varivel, crie o comando SQL sem as
553
variveis. Para executar esta Consulta, utilize o mtodo Execute.

NOTA: A propri eda de CursorLocation da Cons ul ta do E3 deve es ta r confi gura da como
1: clClient.
27.19 Domnios Remotos

Como funciona o licenciamento dos Domnios Remotos?
Tanto o E3 Server rodando o Domnio Cliente quanto o que roda o Domnio Servidor
devem ter licenas especficas para Domnios Remotos. Quando esta licena existe,
o E3 Server Servidor passa a aceitar um nmero ilimitado de conexes externas de
outros Domnios. Da mesma forma, no caso do E3 Server Cliente, possvel
estabelecer um nmero ilimitado de conexes. Para maiores informaes sobre as
limitaes do modo Demo do E3, veja o tpico Limitaes do Modo Demonstrao.
Quando cai a comunicao entre o Domnio Cliente e o Domnio Servidor, o qu
acontece?
Quando uma situao de erro ocorrer, todos as Associaes da aplicao cliente
referenciando o Domnio ficam desconectadas (Displays, por exemplo, passam a
mostrar o texto que indica erro de comunicao, conforme as configuraes do
objeto Viewer), assim como todos os comandos Application.GetObject
referenciando o Domnio Remoto falham, ou seja, causam erros de script. Quando o
problema for resolvido, as Associaes devem reconectar-se automaticamente. J
os comandos Application.GetObject devem ser executados novamente.
Um Domnio Cliente pode visualizar Alarmes de outros Domnios Remotos?
No, mas isto uma caracterstica que pode ser implementada em verses futuras.
Atualmente necessrio duplicar os Alarmes no Domnio Remoto.
Um Domnio Cliente pode abrir Telas de outros Domnios Remotos?
No.
Um Domnio Cliente pode usar usurios de outros Domnios Remotos?
No.
possvel conectar um Domnio a vrios outros Domnios?
Sim, como pode-se ver na figura a seguir.
554
Conectar um Domnio a vrios outros Domnios
possvel conectar um Domnio a um Domnio em Hot-Standby?

Sim. Considere a seguinte arquitetura:
555
Conectar um Domnio a um Domnio em Hot-Standby
Atravs dos Domnios Remotos esta arquitetura possvel. Tem-se um Domnio de

Comunicao, em Hot-Standby, comunicando com os dispositivos. Estes dados
seriam lidos por um outro Domnio, tambm em Hot-Standby, que seriam o servidor
para os computadores clientes (Viewers).
556
Matriz
Rua 24 de Outubro, 353 - 10 andar
90510-002 Porto Alegre RS
Fone: (51) 3346-4699
Fax: (51) 3222-6226
E-mail: elipse@elipse.com.br
Filial SP
Rua dos Pinheiros, 870 - Conj. 141/142
05422-001 So Paulo - SP
Fone: (11) 3061-2828
Fax: (11) 3061-2828
E-mail: elipse-sp@elipse.com.br
Filial PR
Av. Sete de Setembro, 4698/1705
80240-000 Curitiba - PR
Fone: (41) 3342-0120
Fax: (41) 3342-0120
E-mail: elipse-pr@elipse.com.br
Filial MG
Rua Antnio de Albuquerque, 156
7 andar Sala 705
30112-010 Belo Horizonte - MG
Fone: (31) 2511-2121
E-mail: elipse-mg@elipse.com.br
Filial RJ
Praia de Botafogo, 300/525
22250-044 Rio de Janeiro - RJ
Fone: (21) 2158-1015
Fax: (21) 2158-1099
E-mail: elipse-rj@elipse.com.br
USA
2501 Blue Ridge Road, Suite 250
Raleigh - NC - 27607 USA
Fone: +1 (252) 995-6885
Fax: +1 (252) 995-5686
E-mail: info@elipse-software.com
Taiwan
9F., No.12, Beiping 2nd St., Sanmin Dist.
807 Kaohsiung City - Taiwan
Telefone: +886 (7) 323-8468
Fax: +886 (7) 323-9656
E-mail: evan@elipse.com.br
Consulte nosso website para informaes sobre o representante do seu estado.

www.elipse.com.br
kb.elipse.com.br
elipse@elipse.com.br

E3manual PTB

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

E3manual PTB

Uploaded by

Copyright:

Available Formats

Manual do Usurio do E3

Copyright 1999 - 2015 Elipse Software Ltda. Todos os direitos reservados.

Desenvolvido pela Elipse Software, o E3 uma poderosa plataforma para

1.1 Descrio Geral

sem nenhuma mudana

possvel observar que, em todos os casos, o E3 Viewer continua sendo a interface

1.3 Diagrama de Blocos

Diagrama dos blocos que compem o E3

1.4 Estrutura de Domnio

o servidor carrega as definies dos objetos, como bibliotecas do usurio,

1.5 Limitaes do Modo Demonstrao

Permite executar o playback das ltimas seis horas de dados, em relao

O E3 Studio o ambiente de desenvolvimento do E3. Nele, possvel a criao e

Caminho indicado pelo sistema quando o E3 instalado

Para iniciar uma aplicao no E3 Studio, siga estes procedimentos:

Windows. Para iniciar o E3 Studio, selecione o cone correspondente neste

2. O dispositivo de proteo deve estar conectado na porta de comunicao

2.1 Iniciando um Projeto

Janela Iniciar o Studio

As opes disponveis nesta caixa de dilogo esto descritas na tabela a seguir.

2.2 rea de Trabalho

rea de trabalho do E3 Studio

A Barra de Ttulo mostra o caminho e o nome da aplicao, ou o nome do objeto

As opes disponveis nesta aba esto descritas na tabela a seguir.

Aba Barra de ferramentas

As opes disponveis nesta aba esto disponveis na tabela a seguir.

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

As opes disponveis nesta aba esto descritas na tabela a seguir.

Animao dos menus

Menus com sombra

As opes disponveis nesta aba esto descritas na tabela a seguir.

Aba Opes: Atravs desta aba, possvel configurar as especificaes gerais do

As opes disponveis nesta aba esto descritas na tabela a seguir.

Incluir teclas de atalho

2.3.2 Outras Configuraes

As opes disponveis nesta aba esto descritas na tabela a seguir.

Aba Editor de Scripts: Este item destinado configurao do Editor de Scripts do

Aba Editor de Scripts

As opes disponveis nesta aba esto descritas na tabela a seguir.

Arquivos: Habilita ou desabilita a opo Ignorar verificao de CRC

Toda vez que um projeto ou uma biblioteca criado, o E3 grava internamente um

Porm, se um projeto criado na verso atual modificado em uma verso inferior

2.4 Barra de Ferramentas

Abre um projeto exi s tente.

Opes disponveis na barra de ferramentas Sombra

Opes disponveis na barra de ferramentas Objetos

Opes disponveis na barra de ferramentas Tela

Editar Ponto de Conexo

Enviar para Trs

Opes disponveis na barra de ferramentas Desenho

Opes disponveis na barra de ferramentas Alinhamento

Al i nha objetos pel o topo.

Al i nha objetos pel a ba s e.

Apl i ca a mes ma l a rgura a

Opes disponveis na barra de ferramentas Formatao

Al i nha o texto di rei ta .

2.4.1 Verificar Domnio

Verificao de Erros no Projeto

Enquanto o erro no for solucionado, a caixa de dilogo continua sendo mostrada

Mensagem do Item Verificar Domnio

A opo Verificar Domnio pode ser acessada das seguintes maneiras:

2.4.2 Procurar e Substituir

Existem trs maneiras de se realizar a procura e a substituio: