E3manual PTB

Manual do Usurio do E3
2012 Elipse Software Ltda. Todos os direitos reservados.

30/07/2012 - Verso 4.0
Sumrio
1 Introduo 7
1.1 Descrio Geral 8
1.2 Arquitetura do E3 9
1.3 Diagrama de Blocos 11
1.4 Estrutura de Domnio 12
1.5 Limitaes do Modo Demonstrao 12
2 E3 Studio 14
2.1 Iniciando um Projeto 15
2.2 rea de Trabalho 15
2.3 Configurao do E3 Studio 16
2.4 Barra de Ferramentas 25
2.5 Organizer 43
2.6 Importao e Exportao 48
2.7 Lista de Propriedades 79
2.8 Galeria 80
2.9 AppBrowser 81
2.10 Conectar A 84
3 Domnios 87
3.1 E3 Server 87
3.2 E3Run 88
3.3 E3 Admin 89
3.4 IOServer 90
3.5 E3 Studio 90
3.6 E3 Viewer 90
3.7 Componentes do Domnio 90
3.8 Criando um Domnio 91
3.9 Configuraes de Domnio 99
3.10 Outras Opes da rea de Notificao 124
3.11 Domnios Remotos 132
3.12 Gerando Logs no E3 139
4 Drivers 140
4.1 Driver de Comunicao 140
4.2 Servidor OPC 154
4.3 Driver de Comunicao OPC 155
4.4 Qualidade 170
5 Servidor de Dados 178
5.1 Pasta de Dados 178
5.2 Tag Contador 179
5.3 Tag Demo 181
5.4 Tag Interno 182
5.5 Tag Timer 184
6 Telas e Objetos de Tela 186
6.1 Tela 186
6.2 Objetos de Tela 188
6.3 Configuraes Gerais 195
6.4 Formatao de Cores 209
6.5 Formatao de Valores 211
7 ActiveX 217
7.1 Objetos Microsoft Forms 220
7.2 Elipse KeyPad 222
8 Quadros 224
9 Associaes 228
9.1 Associao Simples 230
9.2 Associao Bidirecional 231
9.3 Associao Digital 232
9.4 Associao Analgica 233
9.5 Associao por Tabela 234
9.6 Associao Reversa 236
9.7 Associao Mltipla 236
9.8 Edio de Associaes 238
10 Viewer 243
10.1 Configurao do Viewer 244
10.2 Variveis no Viewer 250
10.3 Objeto _top 250
10.4 Pasta do Viewer 251
11 Banco de Dados 253
11.1 Banco de Dados Access 254
11.2 Banco de Dados Oracle 255
11.3 Banco de Dados SQL Server 259
11.4 Objetos do E3 e Permisses 262
12 Alarmes 264
12.1 Configurao de Alarmes 264
12.2 Servidor de Alarmes 268
12.3 Fontes de Alarme 279
13 E3Alarm 289
13.1 Configuraes do E3Alarm 290
13.2 Caractersticas Especficas de Runtime 299
14 Histricos 302
14.1 Configuraes do Histrico 304
15 Storage 315
15.1 Configuraes do Storage 318
15.2 Configurao da Tabela 320
16 Consultas 332
16.1 Criando uma Consulta 333
16.2 Uso dos Filtros da Consulta atravs de Scripts 341
16.3 Uso de Recordsets de uma Consulta atravs de Scripts 342
17 E3Browser 343
17.1 Objeto Consulta no E3Browser 344
17.2 Outras Configuraes do E3Browser 345
18 E3Chart 349
18.1 Configuraes do E3Chart 350
18.2 Exemplos de Utilizao do E3Chart 375
18.3 Caractersticas Especficas de Runtime 379
19 E3Playback 384
19.1 Objeto E3Playback 384
19.2 Adicionar Playback ao Demo do E3 384
19.3 Interface de Usurio do E3Playback 389
19.4 Banco de Dados de Playback 403
19.5 Configurao dos Objetos de Banco de Dados do E3 407
20 Frmulas 411
20.1 Configuraes da Frmula 412
20.2 Templates 414
20.3 Unidades 416
20.4 Conjunto de Valores 417
20.5 Exemplo de Criao de uma Frmula 418
21 Bibliotecas 425
21.1 Galeria 426
21.2 Biblioteca do Usurio (ElipseX) 427
21.3 Quando Criar um ElipseX 436
22 Relatrios 437
22.1 Objeto Consulta 437
22.2 Componentes do Relatrio 438
22.3 Configuraes do Relatrio 439
22.4 Criando um Relatrio no E3 455
22.5 Exemplos de Utilizao nos Relatrios 456
23 Segurana 460
23.1 Usurios 461
23.2 Grupos 466
23.3 Permisses 469
23.4 Proteo de Arquivos 473
24 E3 Viewer e E3 WebViewer 477
24.1 Viewer Only (Modo Somente Leitura) 478
24.2 Execuo do E3 Viewer 479
24.3 Logs do Viewer 482
24.4 Execuo do E3 WebViewer 483
25 Hot-Standby 487
25.1 Configurando o Hot-Standby 488
25.2 Executando um Domnio Redundante 490
25.3 Parando um Domnio Redundante 491
25.4 Parando um dos Servidores do Domnio 491
25.5 Tempo de Troca entre Servidores 491
25.6 Reconexo de Viewers 491
25.7 Utilizando Bancos de Dados com Hot-Standby 492
26 Configuraes Avanadas 493
27 Dvidas mais Frequentes 494
27.1 Ordem dos Tabs 494
27.2 Sobreposio de Animaes nos Objetos 494
27.3 Objetos de Tela 495
27.4 Servidor de Banco de Dados SQL Server 495
27.5 Servidor de Banco de Dados Oracle 496
27.6 Servidor de Dados 497
27.7 Drivers de Comunicao 498
27.8 Alarmes 499
27.9 E3Alarm 500
27.10 E3Browser 501
27.11 E3Chart 501
27.12 Histrico 501
27.13 Associaes 502
27.14 Viewer 502
27.15 Bibliotecas 504
27.16 Relatrios 505
27.17 Domnios e Projetos 507
27.18 Stored Procedure 508
27.19 Domnios Remotos 508
CAPTULO
1
Introduo
Desenvolvido pela Elipse Software, o E3 uma poderosa plataforma para superviso e

controle de processos totalmente voltada operao em rede e aplicaes distribudas. O E3
um sistema SCADA (Supervisory Control and Data Acquisition) que oferece um avanado
modelo de objetos, uma poderosa interface grfica, alm de uma arquitetura que permite o
rpido desenvolvimento de aplicaes e mxima conectividade com dispositivos e outros
aplicativos. Sua concepo incorpora as mais novas tecnologias em desenvolvimento de
software, maximizando o desempenho, a produtividade e a qualidade de suas aplicaes e do
prprio processo, minimizando perdas e custos.
Os sistemas construdos com o E3 geralmente partem da coleta de dados em tempo real de

equipamentos de aquisio de dados ou de controle, como os CLPs (Controladores Lgicos
Programveis), UTRs (Unidades Terminais Remotas), DAQs (Data Acquisition Boards, Placas de
Aquisio de Dados), controladores Multi-Loop ou Single-Loop, centrais de incndio e
balanas, dentre outros dispositivos. Estes equipamentos normalmente possuem alguma
interface que permitem sua conexo ao software, como padres seriais RS232, RS422 ou
RS485; rdio ou modem (linhas privadas ou discadas), TCP/IP ou UDP/IP, placas ligadas
diretamente no barramento do computador e outros. O E3 l e escreve dados dos
equipamentos atravs de mdulos (drivers de comunicao) que implementam o protocolo
(de Domnio pblico ou privado) disponvel em cada um desses equipamentos. Esses drivers
podem ainda estar em um formato prprio da Elipse Software ou no formato OPC (OLE for
Process Control).
De posse dos dados, possvel criar vrias maneiras para exibir, analisar, controlar,
comandar, gravar ou divulgar tais informaes, dentre elas:
Telas: permitem criar uma IHM (Interface Homem-Mquina) localmente, pela rede local ou
Internet, com o intuito de exibir o status atual ou passado dos dados em vrias formas,
com o auxlio de um editor grfico e objetos especficos
Alarmes e Eventos: monitoram o acontecimento de situaes especficas
Histricos: armazenam os dados em bancos de dados relacionais
Relatrios: permitem visualizar e imprimir os dados, dentre outros mdulos e

possibilidades
Introdu o 7
1.1 Descrio Geral
O E3 pode ser executado nas plataformas Microsoft Windows XP SP3, XP x64 SP2, Server 2003
SP2, Vista SP2, Server 2008 SP2, Server 2008 R2 SP1 e Windows 7 SP1, utilizando alguns
recursos disponveis nesses sistemas operacionais. A interface grfica com o usurio pode
tambm ser executada atravs da Internet ou intranet via Internet Explorer.
As funes bsicas do software esto divididas em mdulos independentes, capazes de

processar atividades especficas. O gerenciamento do trfego de informaes entre os
mdulos coordenado por um mdulo principal (E3 Admin), utilizando a tecnologia de objetos
distribudos, permitindo que os componentes possam ser executados tanto na mesma
mquina quanto em outros computadores.
Em linhas gerais, o E3 composto de um ncleo (kernel) responsvel por unir e coordenar o

trabalho de vrios outros mdulos, que tambm so servidores de informaes. A partir da
so geradas as interfaces grficas com o usurio, disponveis atravs dos clientes, tanto
locais como pela Internet.
O E3 possui quatro programas principais, descritos a seguir.
1.1.1 E3 Server
o Servidor de Aplicaes, onde os principais processos so executados, incluindo a
comunicao em tempo real com os equipamentos de controle. O servidor tambm
responsvel por enviar dados e Telas aos clientes conectados em qualquer parte da rede
(Intranet e Internet). O servidor pode executar vrios projetos ao mesmo tempo e conversar
com outros E3 Servers para realizar um failover (standby) ou distribuir cargas de
processamento entre as mquinas.
1.1.2 E3 Studio
Ferramenta nica de configurao, agindo como plataforma universal de desenvolvimento,
que possui um ambiente moderno e amigvel, incluindo um completo editor grfico e de
scripts (VBScript). Permite que um projeto seja editado por vrias pessoas ao mesmo tempo
ou que vrios E3 Studios estejam conectados ao mesmo servidor remoto, com mltiplas
configuraes.
1.1.3 E3 Viewer
Permite operar as aplicaes residentes no servidor em qualquer computador com o
programa executvel Viewer ou com um navegador de Internet. Em ambos os casos, no
necessrio instalar a aplicao na mquina cliente, pois ser feito o download e o registro de
todos os componentes (Telas, bibliotecas e controles ActiveX).
8 Introdu o
1.1.4 E3 Admin
o mdulo responsvel pela interface do E3 Server e de outros mdulos do E3 com o usurio.
Atravs dele o usurio pode enviar comandos ao E3 Server, utilizando o cone na rea de
Notificao da Barra de Tarefas do Windows, e controlar o Domnio pela linha de comando.
1.2 Arquitetura do E3
Para supervisionar um determinado processo com um sistema SCADA, geralmente
construda uma aplicao que conter a definio das variveis envolvidas, com nomes e
endereamentos, telas, definies de alarmes e outros, a qual se chama Banco de Dados da
Aplicao.
Quando esse processo exige o uso de dois ou mais computadores, preciso fazer com que
cada aplicao em cada computador troque dados com as outras. A maioria dos sistemas
SCADA tradicionais baseiam-se numa arquitetura comum para realizar essa tarefa:
Cada servidor SCADA deve ter uma cpia (parcial ou no) da aplicao configurada na base
de dados local
Cada servidor SCADA possui e executa somente uma base de dados ao mesmo tempo
Isso leva a alguns problemas de gerenciamento, como aplicar mudanas a todos os

servidores, controlar verses do aplicativo ou ento trabalhar com diferentes fabricantes de
software e hardware.
O Elipse E3 resolve esse problema usando o conceito de Domnio que inclui, em um nico
ambiente, a definio dos computadores executando tarefas em tempo real (servidores) e as
bases de dados de projeto que devem ser executadas nesses servidores, com a possibilidade
de execuo de vrios projetos em cada servidor. Tambm possvel inserir, apagar ou
modificar projetos durante a execuo, sem afetar as outras partes do Domnio em execuo.
Cada projeto pode conter qualquer tipo de objeto, como Telas, Drivers I/O, Alarmes,
Histricos, Relatrios, Frmulas, Bancos de Dados, dentre outros. Quando dois ou mais
projetos esto dentro de um mesmo Domnio, eles podem acessar as propriedades e objetos
entre si como se estivessem residentes em uma nica base de dados. Isso possvel atravs
do uso de associaes (conexes) que um objeto pode fazer com qualquer outro. Se ambos os
objetos existem e esto rodando, a conexo est ativa e qualquer mudana de valor
enviada assincronamente entre as partes (dependendo do tipo da conexo). Se um dos
objetos destrudo ou parado, a conexo quebrada, ento a aplicao notificada e pode
indicar o estado numa forma definida pelo usurio.
A estrutura do Domnio restrita aos servidores e afins, como as mquinas servidoras,

projetos, usurios e senhas. A interface do cliente para operao e visualizao, chamada E3
Viewer, pode se conectar diretamente a qualquer servidor E3 (com as licenas suficientes de
Viewer).
O E3 Viewer possui trs destaques especiais:
Os projetos da aplicao residem somente no servidor
Introdu o 9
O navegador Internet Explorer pode ser usado como interface de operao sem nenhuma
mudana
A interface do cliente capaz de alternar de um servidor desligado ou com falha para o

prximo servidor disponvel, sem interromper a monitorao do processo
Como alternativa ao uso do E3 Viewer na mquina cliente, possvel utilizar a tecnologia de

Terminal Service. Este servio surgiu no Windows NT 4.0 e sua funo permitir o acesso
remoto entre computadores, atravs de um protocolo chamado RDP (Remote Desktop
Protocol). Esse protocolo permite a interao entre uma estao cliente e uma mquina
servidora (que ser acessada remotamente). O E3 Viewer executado numa nova sesso de
usurio criada na mquina servidora, que por sua vez, transfere para a mquina cliente os
dados de vdeo e recebe de volta os eventos de mouse e teclado.
10 Introdu o
possvel observar que em todos os casos o E3 Viewer continua sendo a interface de
operao e visualizao. A diferena est no local de execuo, que pode ser na mquina
cliente (operao normal do E3 Viewer) ou na mquina servidora, com o operador fisicamente
junto mquina ou atravs dos Terminal Services. Com o E3 Viewer sendo executado
diretamente na estao cliente, existe um maior trfego inicial para o download de telas e
objetos. Esse trfego diminui substancialmente medida que somente as mudanas nos
dados so reportadas do servidor para o Viewer, o que traz vantagens em termos de
desempenho e qualidade de apresentao grfica.
O Terminal Service, por outro lado, possui maior alcance e exige menor capacidade de
processamento da mquina cliente quando existem poucos efeitos grficos e visuais, alm da
possibilidade de operar o E3 em outras plataformas de software que no so suportadas pelo
E3 Viewer, como o Windows CE e o Linux/Unix. Entretanto, o RDP possui a limitao de exibir
somente 256 cores, o que aumenta consideravelmente o trfego quando existem muitas
animaes ou efeitos piscantes nas telas. Para verificar qual a melhor maneira de
implementar mltiplos acessos a um E3 Server, importante estudar caso a caso, para poder
definir a melhor alternativa para a aplicao. Para utilizar o RDP com mltiplos usurios,
necessrio uma licena de Windows 2003 Server SP2, alm do mesmo nmero de Viewers
disponveis no Servidor.
1.3 Diagrama de Blocos

A arquitetura interna do E3 totalmente escalvel, com cada tarefa principal sendo
executada por um servio separado. O diagrama a seguir mostra uma viso geral dos
principais blocos.
Diagrama dos blocos que compem o E3
Detalhadamente, o E3 Server responsvel por criar um processo de execuo (E3 Runtime)

que vai efetivamente executar a aplicao. Dentro do Runtime encontram-se outros
servidores, que expem servios utilizados por outros mdulos.
Introdu o 11
1.4 Estrutura de Domnio
Cada grupo de servidores composto por um E3 Server operando isoladamente ou dois E3
Servers em configurao de hot-standby. Cada Viewer, de fato, se conecta a um Domnio ao
invs de somente a um servidor.
Depois da conexo, servidor e cliente trocam informaes e verificam a existncia de objetos

do sistema registrados e atualizados na mquina cliente. Caso negativo, o servidor carrega as
definies dos objetos, como bibliotecas do usurio, conforme a necessidade para abrir cada
uma das telas.
Do ponto de vista do cliente, o download comea na primeira tela (interface grfica),

incluindo quaisquer objetos internos que sero salvos em um diretrio de cache. Esse
processo pode levar alguns segundos, dependendo da aplicao, mas traz mais benefcios na
prxima vez que se entra na mesma tela, pois o Viewer realiza um cache em disco e em
memria. Se o programa Viewer no for fechado, a partir da segunda vez que uma tela for
aberta (e no for reconfigurada) ela j estar criada em memria, reduzindo, portanto, o
tempo de paginao. Se a tela for modificada, o Viewer dever fazer um novo download,
reiniciando o processo.
Depois de abrir uma tela, o servidor e o cliente trocam somente dados em tempo real e
consultas ao Banco de Dados num sistema de mensagens TCP/IP, com um alto desempenho
se comparado ao Terminal Service, dependendo da aplicao. Isso possvel porque
enquanto o E3 Viewer recebe e envia apenas valores e dados em tempo real, um cliente
Terminal Service envia mensagens de teclado e mouse, e recebe imagens, o que gera um
trfego muito maior de informaes. Um Viewer conectado a um Domnio isolado pode obter
informaes residentes somente dentro do servidor ativo, de acordo com os direitos de
acesso do usurio.
1.5 Limitaes do Modo Demonstrao

Sem a utilizao de uma licena, o E3 pode ser executado em modo Demonstrao (ou Demo),
o que til para avaliao do software. Nesse caso, as seguintes limitaes se aplicam:
Permite salvar projetos com at 20 Tags de Comunicao
No permite trabalhar com servidores em modo Hot-Standby
No permite trabalhar com Domnios Remotos
S permitida a comunicao com um Driver de Comunicao de nvel 0 (zero), sem limite

de Tags. Drivers com nvel maior do que 0 (zero) no so permitidos
No h acesso s configuraes do Domnio (menu contextual Domnio - Opes do cone do

E3 Admin na rea de Notificaes do Windows)
Somente a primeira imagem de cada categoria da Galeria de Smbolos est disponvel
S permitida a abertura de um Viewer ou WebViewer
12 Introdu o
O tempo mximo de execuo de um Domnio de duas horas
S permitida a gravao de no mximo 20 Tags de Comunicao em um objeto Storage
Permite acesso como OPC Server
Permite executar o playback das ltimas seis horas de dados, com um nmero ilimitado de
Tags e com todos os recursos de playback habilitados
No permitido utilizar a ferramenta de Importao e Exportao do E3 Studio
Introdu o 13
CAPTULO
2
E3 Studio
O E3 Studio o ambiente de desenvolvimento do E3. Nele, possvel a criao e manuteno

de Domnios, projetos e bibliotecas.
Caminho indicado pelo sistema quando o E3 instalado
Para iniciar uma aplicao no E3 Studio, siga estes procedimentos:
1. No momento da instalao, criado um grupo de programas no menu Iniciar do Windows.

Para iniciar o E3 Studio, basta escolher o cone correspondente nesse menu, como mostra
a figura anterior, ou clicar no cone do E3, que criado na rea de Trabalho, conforme figura
a seguir.
cone do E3
2. O dispositivo de proteo dever estar conectado na porta de comunicao adequada, no
14 E3 Studio
caso de uma edio local, ou a mquina deve estar na mesma rede local que outra com o
E3 Server j previamente instalado, e com um dispositivo de proteo presente.
2.1 Iniciando um Projeto

Quando o E3 Studio iniciado, abre-se uma caixa de dilogo com algumas opes do projeto:
Janela Iniciar o E3 Studio
As opes disponveis so as seguintes:
Opes disponveis na janela Iniciar o E3 Studio
OPO DESCRIO
Iniciar o E3 Studio No ser aberto nenhum Domnio.
Criar um Domnio novo Sero requisitados o nome e caminho do

novo Domnio.
Abrir um Domnio existente Ao clicar em Outros Arquivos, tem-se a opo

de localizar um Domnio num diretrio
especfico, ou escolher na lista um dos
ltimos aplicativos editados.
2.2 rea de Trabalho

O E3 Studio j vem com uma srie de menus e de barras de ferramentas configurados, que so
mostrados ao execut-lo pela primeira vez. Ao utilizar uma interface grfica mais moderna,
similar a programas como o Microsoft Office, os menus e as barras de ferramentas podem ser
modificados pelo usurio. Quando no existe uma aplicao aberta, a tela apresenta menos
opes habilitadas na barra de menu e na barra de ferramentas, mas sua aparncia
permanece a mesma. A figura a seguir mostra a aparncia do E3 Studio aps a criao de um
E3 Studio 15
novo projeto.
rea de trabalho do E3 Studio
A Barra de Ttulo mostra o caminho e o nome da aplicao, ou o nome do objeto cuja view
esteja sendo mostrada na rea de trabalho.
A Barra de Status mostra informaes de ajuda a respeito da rea da tela, sobre a qual est o
ponteiro do mouse.
A Barra de Ferramentas mostra os objetos, componentes e demais recursos que podem ser
utilizados na Tela e no E3.
A rea de Trabalho onde as views so mostradas.
2.3 Configurao do E3 Studio

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

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

barra de ferramentas selecionada.
Descrio Breve descrio da opo selecionada.
Aba Barra de Ferramentas: Atravs desta aba, pode-se configurar, editar ou criar novas
barras de ferramentas
E3 Studio 17
Aba Barra de ferramentas
Opes disponveis na aba Barra de ferramentas
OPO DESCRIO
Barra de ferramentas Lista as opes de barras de ferramentas
disponveis.
Boto Restaurar Restaura a barra de ferramentas desejada

no E3.
Boto Restaurar tudo Restaura todas as barras de ferramentas no

E3.
Boto Nova Cria uma nova barra de ferramentas.
Boto Mudar o nome Muda o nome da barra de ferramentas. Esta

opo utilizada somente na barra de
ferramentas criada pelo usurio atravs do
boto Nova.
Boto Remover Remove a barra de ferramentas selecionada.
Mostrar legendas Mostra uma legenda nas opes da barra de

ferramentas selecionada.
Aba Menu: Atravs desta aba, possvel configurar os menus do E3
18 E3 Studio
Aba Menus
Opes disponveis na aba Menus
OPO DESCRIO
Mostra menus para Exibe o menu pr-definido da aplicao. Essa
opo no tem efeito, e mantida no E3 por
questo de compatibilidade.
Boto Restaurar Restaura o menu definido na opo anterior.

Essa opo no tem efeito, e mantida no E3
por questo de compatibilidade.
Animao dos menus Seleciona o tipo de animao usada nos

menus: Nenhuma (padro do E3), Desdobrar,
Deslizar, Fade e Default (padro do Windows).
Menus com sombra Define se o menu apresentar o efeito de

sombreado ou no.
Aba Aparncia: Atravs desta aba, possvel alterar a aparncia das janelas e barras de
ferramentas no E3 Studio
E3 Studio 19
Aba Aparncia
Opes disponveis na aba Aparncia
OPO DESCRIO
Office XP Configura a aparncia do E3 Studio como no
Office XP.
Windows XP Configura a aparncia do E3 Studio como no

Windows XP (no disponvel no estilo
Windows Clssico).
Office 2000 Configura a aparncia do E3 Studio como no

Office 2000.
Office 2003 Configura a aparncia do E3 Studio como no

Office 2003.
VS.Net 2005 Configura a aparncia do E3 Studio como no

Visual Studio .Net 2005.
Aba Opes: Atravs desta aba possvel configurar as especificaes gerais do projeto.
Nesse item possvel habilitar ou desabilitar as opes da barra de ferramentas
20 E3 Studio
Aba Opes
Opes disponveis na aba Opes
OPO DESCRIO
Mostrar descries Habilita o E3 a mostrar uma breve descrio
nas opes das barras de ferramentas e
menus quando o mouse posicionado sobre
o item.
Incluir teclas de atalho Mostra ou no a tecla de atalho na descrio

do boto.
cones grandes Habilita cones grandes nas barras de

ferramentas.
2.3.2 Outras Configuraes

Pode-se configurar o Editor de Scripts do E3, bem como outras opes dos arquivos do
Domnio, atravs do menu Ferramentas - Opes, onde tem-se acesso seguinte janela de
configuraes:
Aba Editor: Este item destinado configurao do Editor de Scripts do E3
E3 Studio 21
Configuraes do Editor de Scripts
As opes disponveis deste item so as seguintes:
Opes disponveis na aba Editor
OPO DESCRIO
Abrir-e-Fechar blocos do texto Permite ocultar ou mostrar os blocos de
cdigo no script.
Tamanho da margem Tamanho da margem da marcao do bloco

de cdigo.
Numerao da linha Habilita a numerao de linha no editor de

scripts.
Tamanho da margem Tamanho da margem que contm a

numerao de linha.
Tamanho do Tab Determina o nmero de espaos de

tabulao.
Fonte Determina o nome da fonte a ser usada no

editor de scripts.
Tamanho Determina o tamanho da fonte a ser usada

no editor de scripts.
22 E3 Studio
NOTA: Feche os editores de scripts abertos para que as modificaes sejam aplicadas.
Arquivos: Habilita ou desabilita a opo Ignorar verificao de CRC
Configuraes de Arquivos
Toda a vez que um projeto ou uma biblioteca criado, o E3 grava internamente um cdigo CRC
(Cyclic Redundancy Check, Verificao de Redundncia Cclica) dos dados deste arquivo. Cada
vez que um arquivo aberto, feita uma verificao desse CRC. Caso essa verificao falhe
(ou seja, o CRC no coincida com os dados), a carga do arquivo abortada, indicando uma
corrupo dos dados do arquivo. Isso pode ser causado por falhas diversas de hardware:
memria, rede, dispositivo de armazenamento, etc.
Porm, se um projeto criado na verso atual modificado numa verso inferior a 1.00.019
build 203, o CRC no atualizado. Com isso, o arquivo no poder ser aberto novamente com
as verses atuais, pois a verificao de CRC ir falhar, mesmo que o arquivo no esteja
efetivamente corrompido. Para solucionar essa questo, necessrio habilitar a opo
Ignorar verificao de CRC. Assim, o projeto poder ser aberto numa verso atual.
Neste caso, a opo dever permanecer habilitada at que todos os objetos editados na
verso antiga tenham sido salvos com a verso atual, o que ir atualizar o CRC.
E3 Studio 23
NOTA: No recomendvel que arquivos .prj sejam editados em verses mais antigas do E3
e depois abertos novamente em verses atuais, pois no h garantia de que com esse
procedimento no sero perdidas as configuraes desses arquivos.
Studio: Configura o comportamento do duplo-clique de objetos no Organizer, quando a view

de um objeto j estiver aberta
Configuraes do Studio
Opes disponveis na aba Studio
OPO DESCRIO
Ativar a view de Scripts Ativa a view de Scripts na ocorrncia de um
duplo-clique.
Abrir a Janela de Propriedades Abre a Janela de Propriedades na ocorrncia

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

Refazer
pelo item Desfazer.
Mostra ou esconde o
Organizer
Organizer.
Galeria Mostra ou esconde a Galeria.
Mostra ou esconde a Lista de

Lista de Propriedades
Propriedades.
Mostra o objeto na view do

Mostrar no Editor objeto, se este estiver
selecionado no Organizer.
E3 Studio 25
CONE COMANDO AO
Mostra o objeto no Organizer,
Mostrar no Organizer se este estiver selecionado
na view do objeto.
Salva tudo, executa o

Executar aplicativo
Domnio e abre o Viewer.
Executa ou para o Domnio

Rodar/Parar Domnio
corrente.
Executar/Parar E3 Viewer Executa ou para o E3 Viewer.
Verifica se o Domnio contm

Verificar Domnio
erros.
Mostra o erro anterior

Erro anterior
encontrado no Domnio.
Mostra o prximo erro

Prximo erro
encontrado no Domnio.
Desfragmenta o arquivo
Desfragmentar arquivos
especificado.
Procura todas as ocorrncias

Procurar/Substituir de um determinado texto em
todo o Domnio.
Gera a documentao dos

Documentao de scripts
scripts.
Mostra as verses dos

Relatrio de verses
projetos e bibliotecas.
Mostra os valores de Tags e

WatchWindow de propriedades no E3 Studio
em tempo de execuo.
Opes disponveis na barra de ferramentas Sombra
CONE COMANDO AO
Aplica uma sombra no
Sombra do objeto
objeto.
Desloca a sombra para cima

Sombra acima
do objeto.
Desloca a sombra para baixo

Sombra abaixo
do objeto.
26 E3 Studio
CONE COMANDO AO
Desloca a sombra para a
Sombra esquerda
esquerda do objeto.
Desloca a sombra para a

Sombra direita
direita do objeto.
Cor da sombra Seleciona a cor da sombra.
Opes disponveis na barra de ferramentas Objetos
CONE COMANDO AO
E3Alarm Insere um objeto E3Alarm.
E3Browser Insere um objeto E3Browser.
E3Chart Insere um objeto E3Chart.
Insere um objeto Caixa de

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

Boto de Opo
Opo (OptionButton).
Insere um objeto Lista de

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

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

Texto
(Label).
Insere um objeto Lista

Lista
(ListBox).
Insere um objeto Barra de

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

Boto Incremento-
Incremento-Decremento
Decremento
(SpinButton).
Insere um objeto Editor de

Editor de Texto
Texto (TextBox).
Insere um objeto Boto Liga-

Boto Liga-Desliga
Desliga (ToggleButton).
E3 Studio 27
Opes disponveis na barra de ferramentas Tela
CONE COMANDO AO
Selecionar Habilita o modo de seleo.
Rotacionar Habilita o modo de rotao.
Mostra o identificador de
Ordem dos tabs ordem de navegao entre os
objetos.
Permite editar pontos de

conexo entre objetos. Este
Editar pontos de conexo boto somente est
habilitado em objetos
XControl.
Insere um objeto do tipo

Linha
Linha.

Conector
Conector.

Retngulo
Retngulo.

Retngulo arredondado
Retngulo Arredondado.

Elipse
Elipse.
Insere um objeto do tipo Arco

Arco de Elipse
de Elipse.
Insere uma ferramenta de

Desenho livre
desenho livre.

Polgono
Polgono.

Polgono de Curvas
Polgono de Curvas.

Figura
Imagem.

Texto
Texto.
28 E3 Studio
CONE COMANDO AO
Display
Display.

SetPoint
SetPoint.

Escala
Escala.
Agrupa uma seleo de

Agrupar
objetos.
Desagrupa uma seleo de

Desagrupar
objetos.
Insere uma ferramenta para

Animar com Translao
movimentos lineares.
Insere uma ferramenta para

Animar com Rotao
rotao.
Traz o objeto para frente em

Trazer para frente
um agrupamento.
Envia o objeto para trs em

Enviar para trs
um agrupamento.
Insere um objeto acima no

Avanar
agrupamento.
Insere um objeto abaixo no

Recuar
agrupamento.
Permite editar o nvel de

Zoom
zoom da Tela.
Permite editar as camadas

Camadas
de objetos na Tela.
Opes disponveis na barra de ferramentas Desenho
CONE COMANDO AO
Define a cor do fundo do
Cor do fundo
objeto.
Define a cor da frente do

Cor da frente
objeto.
E3 Studio 29
CONE COMANDO AO
Define a cor da borda do
Cor da borda
objeto.
Define o estilo da borda do

Estilo da borda
objeto.
Define a espessura da linha

Espessura da linha
do objeto.
Define o estilo do
Estilo do preenchimento
preenchimento do objeto.
Opes disponveis na barra de ferramentas Alinhamento
CONE COMANDO AO
Alinhar esquerda Alinha objetos esquerda.
Alinhar direita Alinha objetos direita.
Alinhamento superior Alinha objetos pelo topo.
Alinhamento inferior Alinha objetos pela base.
Aplica a mesma largura a

Mesma largura
todos os objetos.
Aplica a mesma altura a

Mesma altura
todos os objetos.
Aplica o mesmo tamanho aos

Mesmo tamanho
objetos selecionados.
Centraliza os objetos
Centralizar horizontalmente
horizontalmente.
Centraliza os objetos
Centralizar verticalmente
verticalmente.
Formata o espaamento
Distribui horizontalmente
entre objetos na horizontal.
Formata o espaamento
Distribuir verticalmente
entre objetos na vertical.
Aplica uma reflexo

Espelhar horizontalmente horizontal no objeto
selecionado.
30 E3 Studio
CONE COMANDO AO
Aplica uma reflexo vertical
Espelhar verticalmente
no objeto selecionado.
Grade Mostra ou esconde a grade.
Opes disponveis na barra de ferramentas Formatao
CONE COMANDO AO
Fonte Determina a fonte do texto.
Determina o tamanho da
Tamanho da fonte
fonte.
Cor da fonte Determina a cor da fonte.
Fonte em negrito Formata o texto em negrito.
Fonte em itlico Formata o texto em itlico.
Formata o texto com

Fonte sublinhada
sublinhado.
Texto esquerda Alinha o texto esquerda.
Texto centralizado Centraliza o texto.
Texto direita Alinha o texto direita.
E3 Studio 31
2.4.1 Verificar Domnio
Verifica erros de configurao em todo o Domnio, como objetos com o mesmo nome,
Associaes ilegais, etc. Em caso afirmativo, o E3 Studio mostra uma caixa de dilogo com os
erros encontrados no Domnio.
Verificao de Erros no Projeto
Enquanto o erro no for solucionado, a caixa de dilogo continuar sendo mostrada e no

ser possvel executar o Viewer. Aps a resoluo do problema, o E3 Studio mostrar uma
caixa de mensagem indicando que no encontrou nenhum erro no Domnio, e liberar a
execuo do Viewer.
Mensagem do Item Verificar Domnio
A opo Verificar Domnio pode ser acessada das seguintes maneiras:
Atravs do cone , disponvel na barra de ferramentas Padro: Verifica os erros

ocorridos em todo o Domnio
Atravs do menu Ferramentas - Verificar Domnio: mesmo funcionamento da opo anterior
Clicando com o boto direito do mouse sobre um item do projeto e selecionando a opo
Verificar ou Verificar projeto: Verifica os erros ocorridos somente no objeto selecionado e
em seus filhos
32 E3 Studio
2.4.2 Procurar e Substituir
A ferramenta Procurar busca no Domnio (inteiro ou em parte), por ocorrncias de um
determinado texto. No final da busca, apresentado ao usurio uma lista de resultados,
indicando o objeto onde a ocorrncia foi encontrada, a localizao dentro deste objeto (se
uma propriedade, Associao, etc.), e o texto que contm a ocorrncia.
A ferramenta Substituir substitui as ocorrncias encontradas por outro texto especificado.
Janela Procurar/Substituir
Existem trs maneiras de se realizar a procura e a substituio:
Escolher um item no Organizer, clicar com o boto direito do mouse sobre ele, e selecionar
a opo Procurar/Substituir. Essa procura feita a partir do item, seguindo a hierarquia
(apenas objetos filhos sero pesquisados)
Clicar no menu principal do E3 Studio, em Ferramentas - Procurar/Substituir. Essa procura

feita em todos os projetos e bibliotecas abertos
Clicar no cone Procurar/Substituir , na barra de ferramentas Padro. A procura ser

efetuada em todo o Domnio
Opes disponveis na ferramenta Procurar/Substituir
OPO DESCRIO
Procurar por Contm o texto a ser procurado.
Boto Procurar Inicia a busca pelo texto.
Apenas nos resultados Refaz a pesquisa apenas entre os resultados

da pesquisa anterior.
Diferenciar maisculas de minsculas Procura pelo texto exatamente como foi

escrito, diferenciando maisculas de
minsculas.
E3 Studio 33
OPO DESCRIO
Palavras inteiras Procura o texto especificado como uma
palavra inteira. No considera o texto como
uma substring de outro.
Substituir por Contm o texto a ser utilizado na

substituio.
Boto Substituir Inicia o processo de substituio.
Uma a uma Faz a substituio da linha selecionada e

seleciona a prxima linha vlida.
Todas Substitui, de uma s vez, todas as

ocorrncias do texto.
Apenas as selecionadas Substitui, de uma s vez, todas as

ocorrncias marcadas na lista de resultados.
Mostra ou esconde as opes de pesquisa e

Boto ou substituio.
Boto Seleciona na lista de resultados a ocorrncia

anterior.
Boto Seleciona na lista de resultados a ocorrncia

seguinte.
NOTA: Para selecionar o objeto e mostrar o local exato onde o texto se encontra, basta um
duplo-clique na lista de resultados, na linha desejada.
A tabela a seguir contm as principais opes de pesquisa, bem como as limitaes para os
principais tipos de dados.
34 E3 Studio
Principais opes de pesquisa
TIPO DE DADO EXEMPLO OBSERVAO

Data / Hora 10/02/2010 Encontra em propriedades do
tipo Data/Hora. Se for
00:00:10 especificada somente a data,
encontra todas as
ocorrncias desta data,
independente da hora. Se for
especificada somente a hora,
encontra todas as
ocorrncias desta hora,
independente da data. Os
milissegundos so ignorados
na pesquisa.
Inteiro 0 Encontra em todas as

propriedades numricas.
100 Pesquisando por 10
encontrar 10 e 10.0, mas
no encontrar 10.1 ou 100.
Ponto flutuante 10.0 Encontra em todas as

propriedades numricas de
40,5 tipo Ponto Flutuante.
Pesquisando por 10.1 no
encontra 10 (inteiro). As
configuraes regionais do
Windows so consideradas
para validar o smbolo
decimal no nmero.
Cor 255,255,0 Encontra apenas em

propriedades do tipo Cor.
0,0,234 Deve necessariamente usar
vrgulas para separar os
valores, que devem estar no
sistema RGB.
Booleano Verdadeiro Leva em considerao o

idioma do Windows para
True entender a pesquisa como
sendo de um valor Booleano.
String Teste Encontra Strings inteiras ou

partes de Strings (de acordo
Tag com o tipo de pesquisa, por
palavra inteira ou no).
Qualquer tipo de dado pode
ser encontrado em
propriedades do tipo String.
E3 Studio 35
2.4.3 Documentao de Scripts
A ferramenta Documentao de Scripts serve para auxiliar o usurio na organizao e
documentao dos scripts da aplicao. Essa ferramenta pode ser acessada de duas
maneiras:
Atravs do cone da barra de ferramentas Padro. Utilizando esta opo, sero

gravados no arquivo todos os scripts do Domnio
Clicando com o boto direito do mouse sobre o nome do projeto ou objeto e selecionando
a opo Documentar scripts. Utilizando esta opo, apenas os scripts do objeto
selecionado e de seus filhos sero gravados no arquivo
Esta ferramenta gera um arquivo texto que pode ser editado em qualquer programa de edio
de textos. A formatao do arquivo de documentao feita atravs de um assistente
chamado Assistente de Documentao de Scripts. Esse assistente responsvel por guiar o
usurio na configurao do arquivo de documentao de scripts.
Assistente de Documentao de Scripts
Na janela Arquivo de documentao, so definidas as informaes referentes ao arquivo que

guardar os scripts da aplicao.
No item Nome do arquivo, especifique o nome do arquivo onde ser gerada a documentao
dos scripts. Especifique o local onde este arquivo ser salvo no item Salvar o arquivo na pasta,
e caso haja necessidade, utilize o boto Procurar.
36 E3 Studio
Arquivo de documentao de scripts
Clique no boto Avanar para ir prxima janela.
A janela Detalhamento do arquivo permite que se formate o arquivo que contm as

informaes de scripts. possvel escolher entre uma documentao simplificada, contendo
apenas os nomes dos scripts, ou uma documentao completa, onde todo o cdigo dos
scripts ser gravado no arquivo.
E3 Studio 37
Detalhamento do arquivo
Por exemplo, o script a seguir:

Sub TelaInicial_KeyDown(KeyCode, Shift)
If (KeyCode = 27) Then
Application.Exit
End Sub
Se a opo escolhida for Apenas os nomes dos scripts, ser gravado no arquivo o texto
seguinte:
TelaInicial_KeyDown(KeyCode, Shift)
Se for escolhida a opo Todo o script, ento todo o cdigo ser gravado com a mesma
formatao (identao, linhas em branco, etc.) feita pelo usurio no editor de scripts.
Independente do tipo de formatao escolhida, antes do script gravado um identificador

contendo o nome completo do objeto, para evitar conflitos. Por exemplo, para os seguintes
objetos:
TelaInicial
CommandButton1
Tela1
CommandButton1
Ambos os scripts (considerando um mesmo evento, Click) seriam

CommandButton1_Click(). Assim, a gravao no arquivo ficaria desta forma:
<TelaInicial.CommandButton1:CommandButton1_Click()>
Sub CommandButton1_Click()
...
End Sub
38 E3 Studio
E
<Tela1.CommandButton1:CommandButton1_Click()>
Sub CommandButton1_Click()
...
End Sub
Isto permite a identificao correta de cada script. Clique no boto Avanar para ir prxima
janela.
Na janela Separador de scripts, possvel definir o texto que ser gravado entre um script e
outro no seu arquivo de documentao. possvel escolher entre linhas em branco ou
personalizadas, e ainda informar quantas linhas do tipo escolhido sero inseridas no arquivo.
Separador de scripts
Pode-se optar entre uma Linha em branco ou uma Linha personalizada. Escolhendo a opo
Linha em branco, o arquivo de documentao ter uma linha em branco entre um script e
outro. Escolhendo a opo Linha personalizada, pode-se informar um ou mais caracteres para
compor a linha que ser usada como separador. Os caracteres so informados no campo
Entre com o texto da linha. Se a opo selecionada Repetir at o final da linha, os caracteres
informados sero repetidos at o limite de tamanho da linha, que de 80 caracteres. Pode-se
tambm utilizar mais de uma linha como separador, seja ela em branco ou personalizada.
Basta informar um nmero entre 1 e 100, no campo Entre com o nmero de linhas do
separador. Clique no boto Avanar para finalizar a configurao. Logo aps, o assistente
mostrar uma mensagem indicando a finalizao da configurao e a gerao do arquivo que
contm a documentao dos scripts.
E3 Studio 39
Mensagem de finalizao da gerao do arquivo que contm os scripts
Algumas observaes relevantes:
Os scripts de XControls e XObjects so gravados apenas uma vez no arquivo, pois so

encontrados durante a pesquisa na biblioteca. Scripts de instncias sero gravados
quando o objeto pai da instncia for pesquisado
Picks so internamente scripts; logo, tambm sero documentados
A gravao no arquivo feita em ordem alfabtica do nome do objeto, dentro de cada

projeto ou biblioteca
No possvel adicionar scripts a um arquivo j existente, via assistente. Sempre que o

assistente chamado, um novo arquivo ser criado ou, caso j exista, ser sobrescrito
Esta ferramenta pode demorar algum tempo para gerar o arquivo de documentao, caso a
aplicao seja grande e a pesquisa envolva muitos tipos de objetos. Para agilizar a
pesquisa, interessante gerar um arquivo para cada tipo de objeto do E3
40 E3 Studio
2.4.4 Relatrio de Verses
A ferramenta Relatrio de verses permite a visualizao das verses e comentrios dos
projetos e das bibliotecas abertos, pertencentes ou no ao Domnio. Para acessar essa
ferramenta, basta clicar no boto da barra de ferramentas Padro, que a caixa de dilogo
seguinte ser mostrada.
Relatrio de verses
As opes mostradas nesta caixa de dilogo so as seguintes:
Opes disponveis na caixa de dilogo Relatrio de verses
OPO DESCRIO
Projeto/Biblioteca Nome do projeto ou da biblioteca abertos.
Verso Indica a verso do projeto ou biblioteca. Esta

verso gerada internamente pelo E3,
sendo incrementada toda a vez que o projeto
salvo, manual ou automaticamente. No
caso de projetos ou de bibliotecas
protegidos, se a verso no puder ser salva,
tambm no ser possvel seu incremento.
No entanto, se o usurio tem permisso para
abrir e alterar o projeto ou a biblioteca, a
verso ser incrementada normalmente.
Comentrio Mostra o comentrio relacionado ao projeto.

Esse comentrio pode ser editado atravs da
propriedade DocString. No caso de
bibliotecas, esse campo fica em branco.
NOTA: Estes campos so apenas para visualizao, no sendo permitida sua edio.
E3 Studio 41
2.4.5 WatchWindow
A ferramenta WatchWindow permite a visualizao do valor corrente de qualquer
propriedade ou Tag em tempo de execuo no E3 Studio. Para acessar essa ferramenta, deve-
se clicar no boto da barra de ferramentas Padro ou acessar o menu Ferramentas -
WatchWindow, que a caixa de dilogo a seguir ser mostrada:
Caixa de dilogo WatchWindow
A caixa de dilogo apresenta as seguintes opes:
Opes disponveis na caixa de dilogo WatchWindow
OPO DESCRIO
Boto Adicionar Abre o DomainBrowser (um AppBrowser com
os objetos criados no servidor) e seleciona o
objeto que ser mostrado na janela do
WatchWindow.
Boto Remover Remove a linha selecionada da lista de

objetos do WatchWindow.
Boto Atualizar Busca toda a rvore de filhos dos objetos

selecionados atualmente pelo
WatchWindow.
Boto Conectar Tenta reativar a conexo perdida com o

Domnio para que a visualizao seja
possvel.
42 E3 Studio
OPO DESCRIO
Nome Indica o Tag ou a propriedade sendo
visualizada.
Qualidade Indica a qualidade do Tag ou da propriedade.
Estampa de tempo Indica a estampa de tempo do Tag ou da

propriedade.
Valor Indica o valor do Tag ou da propriedade, em

tempo de execuo.
Status Indica se o Domnio est conectado ou

desconectado.
2.5 Organizer
O Organizer permite uma viso simples e organizada de toda a aplicao, ajudando na edio
e configurao de todos os objetos envolvidos, atravs de uma rvore hierrquica de opes.
Possui dois modos de visualizao, Domnio e Explorer.
Organizer
E3 Studio 43
O modo Domnio mostra apenas as informaes dos objetos abertos pertencentes ao
Domnio. Essas informaes esto organizadas em quatro grupos: Configurao, Bibliotecas de
Objetos, Visualizao e Objetos de Servidor. Cada grupo apresenta seus objetos ordenados
alfabeticamente dentro do respectivo n.
Modo Domnio
O grupo Configurao mostra os servidores configurados, bem como os nomes dos arquivos de
projetos e de bibliotecas pertencentes ao Domnio.
O grupo Bibliotecas de Objetos agrupa os objetos ElipseX de todas as bibliotecas pertencentes

ao Domnio, organizados por tipo de objetos (XObjects e XControls).
Os demais objetos do E3 esto nos grupos Visualizao e Objetos de Servidor. Em Visualizao

esto os objetos que rodam na mquina cliente; j os objetos executados na mquina
servidor esto em Objetos de Servidor.
O modo Explorer mostra projetos e bibliotecas abertos no E3 Studio, pertencentes ou no ao

Domnio. Os objetos so mostrados no projeto ou na biblioteca ao qual pertencem,
ordenados alfabeticamente dentro de cada um.
Modo Explorer
44 E3 Studio
A manuteno da aplicao pode ser feita em qualquer um dos dois modos. As operaes
realizadas em um modo sero imediatamente refletidas no outro. Para facilitar a localizao
dos objetos, ambos os modos so intercambiveis, tanto entre si como com a aba Design da
view do objeto. Para alternar o modo de visualizao, siga estes procedimentos:
1. No modo Domnio, clique com o boto direito no objeto e selecione Mostrar no Explorer
para visualiz-lo no modo Explorer.
2. No modo Explorer, clique com o boto direito no objeto e selecione Mostrar no Organizer
para visualiz-lo no modo Domnio.
3. Em qualquer um dos modos, clique com o boto direito no objeto e selecione Mostrar no
Editor para visualiz-lo diretamente na aba Design.
4. Em qualquer view de objetos, na aba Design, clique com o boto direito do mouse no objeto
e selecione Mostrar no Organizer ou Mostrar no Explorer para visualiz-lo no Organizer, em
seu respectivo modo.
Ao clicar em um objeto com o boto esquerdo do mouse, suas propriedades podero ser
visualizadas e editadas atravs da Lista de Propriedades, se habilitada. Clicando com o boto
direito do mouse sobre cada item do Organizer, so mostradas as seguintes opes:
Opes disponveis no Organizer
OPO DESCRIO
Fechar Fecha o projeto ou biblioteca corrente.
Atualizar Atualiza as configuraes do projeto ou

biblioteca.
Registrar Registra a biblioteca para que as

modificaes executadas estejam
disponveis.
Salvar Como Abre uma caixa de dilogo para que o projeto

ou a biblioteca sejam salvos no local
indicado.
Desfragmentar Desfragmenta arquivos (.lib ou .prj), isto ,

faz com que os espaos criados
desnecessariamente (por excluso de itens,
importao de arquivos, incluso de
recursos, etc.) sejam apagados. Aps a
desfragmentao, uma janela ser exibida
contendo as seguintes informaes:
tamanho original do arquivo, tamanho
desfragmentado e percentual de
compactao.
E3 Studio 45
OPO DESCRIO
Proteo Protege o contedo de um arquivo .prj ou .lib
contra a edio, visualizao ou execuo
no autorizada. Maiores informaes no
captulo Segurana.
Nova Pasta Cria uma nova Pasta na aplicao.
Inserir Insere objetos disponveis no E3 no projeto

ou na biblioteca. Mais informaes sobre
essa opo nos respectivos captulos de
cada objeto.
Inserir Recurso Insere recursos no projeto ou na biblioteca.
Habilitar/Desabilitar projeto Habilita ou desabilita o projeto selecionado.

Para desabilitar o projeto, selecione seu
nome e escolha a opo Desabilitar projeto.
Observe que o nome e cone do projeto
aparecero na cor cinza, indicando que o
projeto est desabilitado. Para habilitar o
projeto, selecione o projeto e escolha a
opo Habilitar projeto.
Adicionar/Remover do Domnio Adiciona ou remove o projeto ou a biblioteca

do Domnio. Para remover o projeto ou a
biblioteca, selecione seu nome e escolha a
opo Remover do Domnio. Para adicion-
los ao Domnio, selecione-os e escolha a
opo Adicionar ao Domnio.
Procurar/Substituir Busca por trechos de texto e os substitui por

outros, se for o caso. Maiores informaes
sobre essa opo na seo Procurar/
Substituir deste captulo.
Importar/Exportar Auxilia o usurio na importao e na

exportao de objetos, Associaes e
colees. Maiores informaes sobre essa
opo na seo Importao e Exportao
deste captulo.
Documentar Scripts Auxilia o usurio com a documentao dos

scripts da aplicao. Maiores informaes
sobre essa opo na seo Documentao de
Scripts deste captulo.
Verificar Verifica os erros ocorridos na aplicao.

Maiores informaes sobre essa opo na
seo Verificar Domnio deste captulo.
46 E3 Studio
OPO DESCRIO
Editar Associaes Muda uma ou mais Associaes, eventos de
usurio e propriedades do tipo Link feitas na
aplicao, de forma mais rpida do que pela
janela tradicional. Maiores informaes
sobre essa opo no captulo Associaes.
Copiar/Colar Associaes Copia ou cola Associaes de um objeto para

outro. A segunda opo s mostrada se o
que estiver copiado na rea de Transferncia
do Windows for uma Associao. Se a
propriedade em questo j possuir uma
Associao, mostrada uma mensagem ao
usurio perguntando se a Associao deve
ser sobrescrita ou no.
Se as Associaes copiadas na rea de

Transferncia forem coladas em um objeto
que no possua alguma das propriedades,
estas sero listadas para o usurio em uma
mensagem informando o problema. As
propriedades que existirem tero as
Associaes criadas corretamente.
Associaes de propriedades escondidas
dos ElipseX no so copiadas.
Propriedades Abre a Janela de Propriedades do objeto.

Quando essa opo aberta pelo menu, a
primeira aba a ser aberta ser a de
configuraes do objeto. Mais informaes
sobre essa opo nos respectivos captulos
de cada objeto.
Carregar Todos os Objetos Carrega todos os objetos do grupo

selecionado.
Fechar Todos os Objetos Fecha todos os objetos do grupo

selecionado.
Salvar Todos os Objetos Salva todos os objetos do grupo selecionado.
Novo Arquivo de Aplicao (.prj) Cria um novo arquivo .prj e o inclui no

Domnio.
Nova Biblioteca de Objetos (.lib) Cria um novo arquivo .lib e o inclui no

Domnio.
Registrar bibliotecas carregadas Registra todas as bibliotecas.
E3 Studio 47
OPO DESCRIO
Abrir Todos os Arquivos Percorre todos os arquivos .prj e .lib do
Domnio; se algum arquivo fechado for
encontrado, ele ser aberto. Se o arquivo
estiver protegido com senha de edio, ser
solicitada a sua senha. O E3 Studio tenta
utilizar a mesma senha em todos os arquivos
protegidos. Se a senha falhar com algum
arquivo, ela solicitada novamente.
Fechar Todos os Arquivos Fecha todos os arquivos .prj e .lib do

Domnio. Se algum arquivo tem alteraes
no salvas, perguntado para o usurio se
ele deseja salv-las.
Editar a Ordem de Ativao Permite editar a ordem de ativao dos

objetos de Servidor no Domnio (ver figura a
seguir).
Ordem de Ativao do Domnio
2.6 Importao e Exportao

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

objetos escolhidos a partir do ambiente de configurao (E3 Studio) em um arquivo CSV. Para
48 E3 Studio
cada objeto podem ser gravadas suas propriedades, Associaes e itens de colees.
possvel, portanto:
Criar novos objetos do E3 a partir do arquivo CSV, desde que estes no sejam diretamente
objetos filhos do projeto ou biblioteca
Importar ou exportar qualquer propriedade de qualquer tipo de objeto do E3
Importar ou exportar qualquer tipo de Associao de objetos do E3
Exportar qualquer tipo de coleo de objetos do E3 e importar suas propriedades
Importar ou exportar qualquer tipo de item da coleo de objetos do E3
Qualquer objeto do E3 poder ser importado ou exportado. O objeto selecionado para a

operao chamado de objeto raiz. Com isso, possvel importar ou exportar, por exemplo,
uma Pasta de Dados com XObjects definidos pelo usurio, ou mesmo exportar uma Tela,
listando todos os objetos filhos.
Alm dos objetos, as Associaes e as colees tambm podem ser importadas e exportadas.
O usurio tem a opo de informar se quer importar ou exportar Associaes e colees ou
no.
NOTA: A ferramenta de importao e exportao considera apenas as propriedades e

Associaes dos objetos e colees do E3. Informaes que no estejam descritas em
propriedades no sero importadas ou exportadas. Isso o caso, por exemplo, de scripts e
configuraes internas dos objetos de Tela.
2.6.1 Arquivo CSV

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

possvel criar um arquivo com extenso .csv a partir do Bloco de Notas, do Excel ou de outro
aplicativo do Windows. O arquivo ser criado considerando o separador de elementos
configurado no Windows (na configurao por usurio, no do sistema).
A primeira linha do arquivo deve conter um cabealho com os nomes das colunas desejadas.
Cada coluna dever ser uma propriedade ou um identificador definido no modelo, conforme
ser visto a seguir. Nas linhas devero ser colocados os objetos, e os valores das
propriedades nas colunas correspondentes. No necessrio que todas as propriedades dos
objetos sejam listadas no cabealho, bem como podem existir colunas que no estejam
associadas a propriedades de um determinado objeto.
importante tambm que o arquivo CSV tenha uma coluna para a propriedade Name. Sem
ela, no possvel determinar exatamente onde o objeto em questo deve ser criado. Os
nomes mostram a hierarquia correta do objeto, e nomes com caracteres especiais devem ser
delimitados por colchetes.
A seguir, um exemplo de um arquivo CSV que pode ser criado manualmente no Excel.
1. Abra o Excel e configure o cabealho com os campos, um em cada coluna, conforme a figura
a seguir.
Arquivo CSV Visualizado no Excel
2. Salve a planilha com a extenso .csv.
3. Feche o arquivo no Excel.
4. Para importar este arquivo no E3, selecione um objeto IODriver e importe o arquivo criado
atravs da opo Importar, escolhendo o modelo adequado. O E3 criar a estrutura de
acordo com o arquivo CSV.
50 E3 Studio
2.6.2 Importao e Exportao de Objetos
A importao ou a exportao de objetos no E3 pode ser feita a partir de qualquer tipo de
objeto, exceto projetos e bibliotecas. A operao a partir do objeto raiz feita sobre suas
propriedades e seus objetos filhos. Para exportar objetos, siga esses procedimentos:
1. Clique com o boto direito do mouse sobre o objeto desejado e selecione a opo Exportar.
2. Na caixa de dilogo, selecione o arquivo CSV desejado e clique no boto Salvar.
Exportao de Objetos
Na exportao, todas as propriedades, Associaes, colees e itens de colees do objeto

selecionado e de seus filhos sero automaticamente exportadas. gerado um arquivo CSV
com uma linha para cada objeto exportado, bem como para cada Associao, coleo ou item
de coleo existente nesses objetos. Para cada propriedade criada uma coluna no arquivo,
onde informado o valor da propriedade para cada objeto.
O objeto selecionado, chamado de objeto raiz, exportado com a coluna da propriedade

Name em branco. Nos demais casos, essa coluna contm a hierarquia com nomes separados
por pontos. Exemplo de exportao a partir de um objeto IODriver.
E3 Studio 51
Hierarquia de Driver1
ObjectType;Name;Prop1;Prop2;Prop3
IODriver;;0;True;0
IOBlock;Bloco1;0;False;0
IOBlockElement;Bloco1.Elemento1;0;False;0
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 na seo Modelos. Utilizando um modelo possvel configurar se as
Associaes, colees e itens de colees sero ou no exportados, se o objeto raiz ser
exportado ou no, quais as propriedades de cada objeto devem ser exportadas, entre outras
configuraes. Para isso, siga estes procedimentos:
1. Clique com o boto direito do mouse sobre o objeto desejado e selecione a opo Exportar.
2. Clique no boto Avanado para configurar ou selecionar um modelo.
3. Na caixa de dilogo, selecione o arquivo CSV desejado e clique no boto Salvar.
Para importar objetos, siga esses procedimentos:
1. Clique com o boto direito do mouse sobre o objeto desejado e selecione a opo Importar.
2. Na caixa de dilogo, selecione o arquivo CSV desejado e clique no boto Abrir.
52 E3 Studio
Importao de Objetos
Na importao, para cada linha lida do arquivo CSV identificado o objeto que ser criado.
Apenas o filho mais ao final da hierarquia pode ser criado. O restante do caminho deve existir.
Por exemplo, no objeto Pasta1.Pasta2.Tag, apenas Tag deve ser criado. Pasta1 e
Pasta2 devem existir previamente. Assim, permitido ter no arquivo apenas pastas, sem
filhos. O arquivo poder ter linhas como essas:
ObjectType;Name
IOFolder;Pasta1
As linhas em branco, as linhas onde no encontrado um identificador de tipo vlido, as

colunas em branco e as colunas que tenham nomes invlidos de propriedades so ignoradas,
sem gerar erro.
2.6.3 Modelos
Os Modelos so arquivos INI utilizados para configurar a ferramenta de importao e
exportao, informando, por exemplo, qual o separador que deve ser utilizado no arquivo CSV,
se as Associaes dos objetos devem ou no ser exportadas, etc. Os arquivos INI tm o
seguinte formato:
Linhas iniciadas por ponto e vrgula so comentrios, desconsiderados na interpretao

do arquivo
O arquivo organizado em sees, e cada seo contm uma ou mais variveis. As sees
so identificadas por nomes entre colchetes. As variveis so as palavras antes do smbolo
E3 Studio 53
de igualdade. Uma seo no pode conter duas variveis com o mesmo nome
Linhas em branco so ignoradas
Um exemplo de arquivo INI mostrado a seguir:

; Primeira seo
[SECAO1]
Var1 = 0
Var2 = 1
; Segunda seo
[SECAO2]
Var1 = TRUE
Var3 = FALSE
O formato um texto facilmente modificvel pelo usurio, sendo possvel gerar um modelo
novo utilizando um editor de textos comum. O mesmo modelo pode ser utilizado tanto para a
importao como para a exportao de objetos.
Os modelos utilizados no E3 permitem que o usurio redefina valores para nomes das colunas
do arquivo CSV, bem como para os tipos de objetos. Alm disso, tambm permitem que o
usurio agrupe mais de uma propriedade em uma mesma coluna. Isso tudo feito atravs da
definio de identificadores, que so palavras-chave utilizadas no arquivo CSV e associadas a
propriedades ou classes de objetos no arquivo INI.
No E3, os modelos da ferramenta de importao e exportao esto definidos com as

seguintes sees e variveis:
Sees definidas para os Modelos
SEO DESCRIO
Header (*) Define os identificadores permitidos para
nomes de colunas e tipos de dados. Nesta
seo devero ser definidas as variveis
header e types.
(*) Seo obrigatria para a exportao.
Configuration Define configuraes adicionais para a

ferramenta de importao e exportao.
Nesta seo devero ser definidas as
variveis separator, root, link,
collection, objectduplicated e
bindduplicated.
Types Relaciona os identificadores de tipos de

dados com as classes de objetos reais. Cada
identificador listado na varivel types que
no for igual a um nome de classe de objeto
dever estar documentado nessa seo,
sendo criada uma varivel para cada um dos
identificadores.
54 E3 Studio
SEO DESCRIO
Columns Relaciona os identificadores de nomes de
colunas com os nomes de propriedades.
Cada identificador listado na varivel
header que no for igual a um nome de
propriedade dever estar documentado
nessa seo, sendo criada uma varivel para
cada um dos identificadores.
Filter Define quais as classes de objetos que

devero ou no ser importadas ou
exportadas. Nesta seo deve ser definida
uma das duas variveis: include ou
exclude. Se ambas forem definidas,
apenas include ser considerada.
Variveis definidas para os Modelos
SEO DESCRIO
header (*) Define a ordem das colunas e os
identificadores que sero utilizados. Devem
ser listadas todas as colunas que o arquivo
CSV ter, separadas por vrgulas. Cada
identificador que no for igual a um nome de
propriedade dever ser discriminado na
seo Columns, cada um com uma varivel.
(*) Varivel obrigatria para a exportao.
types Define os identificadores para os tipos de

dados permitidos no arquivo CSV. Os
identificadores devero ser listados nessa
varivel separados por vrgulas. S
necessrio definir essa varivel se algum
identificador for diferente do nome da classe
do objeto. Nesse caso, para cada um dos
identificadores dever haver tambm uma
varivel na seo Types.
separator Define o separador que ser utilizado para

delimitar as colunas no arquivo CSV. Caso
essa varivel no seja definida, ser
utilizado o separador de listas configurado
no Windows.
root Define se o objeto raiz ser exportado ou

importado junto com os objetos filhos. Caso
essa varivel no seja definida, o objeto raiz
ser utilizado.
E3 Studio 55
SEO DESCRIO
link Define se as Associaes dos objetos sero
exportadas ou importadas. Caso essa
varivel no seja definida, as Associaes
so utilizadas.
collection Define se as colees dos objetos sero

exportadas ou importadas. Caso essa
varivel no seja definida, as colees so
utilizadas.
objectduplicated Define o que fazer quando um objeto pr-

existente estiver sendo importado. Os
valores possveis para essa varivel so: 0 -
askalways (sempre questiona o usurio sobre
o que deve ser feito); 1 - changealways
(sempre altera as propriedades do objeto
existente); 2 - ignorealways (sempre ignora o
objeto sendo importado); e 3 - createalways
(sempre cria um objeto novo, auto-
incrementando o nome). Caso essa varivel
no seja definida, assumido o valor
askalways. Essa opo no tem valor na
exportao.
bindduplicated Define o que fazer quando uma Associao

pr-existente estiver sendo importada. Os
(sempre substitui a Associao existente
pela nova); e 2 - ignorealways (sempre ignora
a Associao sendo importada). Caso essa
varivel no seja definida, assumido o
valor askalways. Essa opo no tem valor na
exportao, nem tampouco possui o valor
createalways; neste caso, sempre
modificado para askalways.
collectionduplicated Define o que fazer quando uma coleo pr-

existente estiver sendo importada. Os
(sempre substitui a coleo existente pela
nova); e 2 - ignorealways (sempre ignora a
coleo sendo importada). Caso essa
varivel no seja definida, assumido o
valor askalways. Essa opo no tem valor na
exportao, nem tampouco possui o valor
createalways; neste caso, sempre
modificado para askalways.
56 E3 Studio
SEO DESCRIO
itemduplicated Define o que fazer quando um item de
coleo pr-existente estiver sendo
importado. Os valores possveis para essa
varivel so: 0 - askalways (sempre questiona
o usurio sobre o que deve ser feito); 1 -
changealways (sempre altera as
propriedades do item existente); 2 -
ignorealways (sempre ignora o item sendo
importado); e 3 - createalways (sempre cria
um item novo, auto-incrementando o nome).
Caso essa varivel no seja definida,
assumido o valor askalways. Essa opo no
tem valor na exportao.
include Define quais classes de objetos devero ser

importadas ou exportadas. O filtro no
recursivo, ou seja, se for includa uma classe
de um objeto que possa ter filhos, esses
filhos no sero includos automaticamente.
No pode ser usada junto com a varivel
exclude. Apenas o que estiver definido
nessa varivel ser exportado ou importado.
exclude Define quais classes de objetos no devero

ser importadas ou exportadas. O filtro no
recursivo, ou seja, se for excluda uma classe
de um objeto que possa ter filhos, esses
filhos no sero excludos automaticamente.
No pode ser usada junto com a varivel
include. Apenas o que estiver definido
nessa varivel ser desconsiderado na
importao ou na exportao.
NOTA: O caractere de ponto e vrgula no pode ser utilizado como nome ou parte do nome da
coluna, nem tampouco como nome ou parte do nome do identificador de tipo. Esta limitao
se deve ao fato de esse caractere definir um comentrio no arquivo INI. Dessa forma, a
varivel criada na seo Columns ou na seo Types para definir o identificador que possui o
ponto e vrgula no pode ser lida corretamente.
Exemplo:
E3 Studio 57
[Header]
header = ObjectType,Name,DocString,N1/B1,N2/B2,N3/B3,N4/B4,Scan,AllowRead,AllowWrite
types = Tag,Bloco,Elemento
[Configuration]
separator = ','
root = true
link = true
collection = true
objectduplicated = askalways
bindduplicated = askalways
collectionduplicated = askalways
itemduplicated = askalways
[Types]
Tag = IOTag
Bloco = IOBlock
Elemento = IOBlockElement
[Columns]
N1/B1 = N1,B1
N2/B2 = N2,B2
N3/B3 = N3,B3
N4/B4 = N4,B4
[Filter]
exclude = IOFolder
A Elipse Software fornece alguns modelos para importao e exportao de alguns tipos de
objetos. Esses modelos tambm podem ser utilizados como base para a criao de outros. Os
modelos fornecidos esto na pasta Templates da instalao do E3.
NOTA: Na importao, as colunas que sero utilizadas so lidas diretamente do arquivo CSV.
Neste caso especfico, no necessria a varivel header no modelo. Porm, se alguma
coluna for nomeada por um identificador, este dever estar definido na seo Columns ou a
coluna ser ignorada.
2.6.4 Gerenciador de Modelos

O Gerenciador de Modelos uma ferramenta para auxiliar o usurio na criao de um arquivo
INI para ser utilizado na importao ou exportao de objetos do E3. Para acess-lo, basta
clicar na opo Importar/Exportar e, uma vez aberta a janela da opo, clicar no boto
Configurar. Caso o usurio j tenha carregado um modelo, os valores iniciais das opes nas
abas da janela estaro de acordo com o que foi previamente configurado. As abas disponveis
so:
Configuraes: Atravs desta aba, o usurio pode configurar as opes vlidas tanto para a
importao quanto para a exportao
58 E3 Studio
Aba Configuraes
Opes disponveis na aba Configuraes
OPO DESCRIO
Separador de colunas As opes disponveis so: Usar o separador
de listas do Windows (escolhe o caractere
definido no Windows como separador de
listas para ser usado como separador de
colunas do arquivo CSV) e Usar outro
caractere como separador (escolhe outro
caractere definido pelo usurio como
separador de colunas).
E3 Studio 59
OPO DESCRIO
Outras opes Define o que ser importado ou exportado:
objetos, Associaes ou colees. As opes
disponveis so: Importar/exportar o objeto
raiz, Importar/exportar associaes e
Importar/exportar colees.
Salvar modelo Quando a opo Salvar as alteraes deste

modelo em um arquivo INI for marcada,
definido o arquivo INI onde as alteraes do
modelo sero salvas, e esse arquivo poder
ser reutilizado. Quando for desmarcada, as
configuraes feitas sero salvas
temporariamente em um arquivo na pasta
de arquivos temporrios do Windows. Esse
arquivo ser utilizado para a importao ou
exportao realizada logo aps a
configurao, e ser removido depois disso.
Importao: Atravs desta aba, o usurio pode configurar as opes vlidas somente para
a importao.
60 E3 Studio
Aba Importao
Opes disponveis na aba Importao
OPO DESCRIO
Importao de objetos duplicados Especifica como o E3 deve lidar com a
ocorrncia de objetos duplicados na
importao. As opes disponveis so
Questionar sobre o que fazer em cada caso,
Sempre sobrescrever o objeto existente,
Sempre ignorar o objeto duplicado e Sempre
criar um novo objeto.
E3 Studio 61
OPO DESCRIO
Importao de associaes duplicadas Especifica como o E3 deve lidar com a
ocorrncia de Associaes duplicadas na
Sempre sobrescrever a associao existente e
Sempre ignorar a associao duplicada.
Importao de colees duplicadas Especifica como o E3 deve lidar com a

ocorrncia de colees duplicadas na
Sempre sobrescrever a coleo existente e
Sempre ignorar a coleo duplicada.
Importao de itens de coleo duplicados Especifica como o E3 deve lidar com a

ocorrncia de itens de coleo duplicados na
Sempre sobrescrever o item existente,
Sempre ignorar o item duplicado e Sempre
criar um novo item.
Filtros: Atravs desta aba, o usurio pode escolher quais as classes que sero utilizadas na
importao ou na exportao, ou quais classes no deseja utilizar
62 E3 Studio
Aba Filtros
Opes disponveis na aba Filtros
OPO DESCRIO
No filtrar objetos Define a importao ou a exportao de
todos os objetos.
Incluir apenas estes objetos Define quais classes de objetos sero

importadas ou exportadas.
Excluir apenas estes objetos Define quais classes de objetos no sero

importadas ou exportadas.
Boto Alterar Abre uma janela para seleo das classes de

objetos a serem includas ou excludas.
Boto Abre uma janela de ajuda para a opo.
E3 Studio 63
O boto Alterar abre a seguinte janela para a escolha de classes:
Classes de Objetos
As classes que preenchem inicialmente a lista so as do objeto raiz e seus filhos, caso um
novo modelo esteja sendo criado. O usurio pode adicionar outras, clicando no boto , ou
remover alguma classe, clicando no boto .
Identificadores: Atravs desta aba, o usurio define os identificadores para as classes de

objetos escolhidas. O estado inicial dessa lista vazio
64 E3 Studio
Aba Identificadores
Opes disponveis na aba Identificadores
OPO DESCRIO
Nome da classe Indica o nome da classe selecionada na
opo.
E3 Studio 65
OPO DESCRIO
Identificador Permite ao usurio alterar o valor a ser
utilizado na coluna ObjectType do arquivo
CSV. O valor inicial nesta coluna sempre o
nome da classe do objeto. Para cada valor
alterado aqui, criada uma entrada no
arquivo INI na seo Types. Os valores no
so sensveis caixa (isto , "AAA", "aaa" e
"aAa" so o mesmo valor). Caso o usurio
defina valores iguais para mais de um tipo,
apenas o primeiro tipo ser considerado na
importao, e algum objeto poder ser
criado com o tipo errado.
Boto Adiciona classes de objetos.
Boto Remove a classe de objetos selecionada.
Boto Apresenta uma janela com texto de ajuda.
Propriedades: Atravs desta aba, o usurio escolhe quais as propriedades dos objetos que
deseja utilizar na importao ou na exportao. O valor inicial da lista ObjectType; as
demais propriedades devem ser adicionadas manualmente pelo usurio
66 E3 Studio
Aba Propriedades
E3 Studio 67
Opes disponveis na aba Propriedades
OPO DESCRIO
Nome da coluna Permite ao usurio alterar o valor a ser
utilizado como nome da coluna no cabealho
do arquivo CSV. O valor inicial dessa coluna
sempre o prprio nome da propriedade do
objeto. Para cada valor alterado nessa
coluna, criada uma entrada no arquivo INI
na seo Columns. Os nomes das colunas
no so sensveis caixa (isto , "AAA", "aaa"
e "aAa" so o mesmo valor); caso o usurio
defina nomes de colunas iguais para mais de
uma propriedade, apenas uma delas ser
identificada corretamente, e todas as
colunas com o mesmo nome sero
relacionadas mesma propriedade; nesse
caso, algum valor pode ser sobrescrito.
Propriedade Indica a propriedade sendo importada ou

exportada.
Botes e Redefinem a ordem das colunas ao alterar a

ordem das propriedades na lista.
Boto Adiciona propriedades lista.
Boto Exclui propriedades da lista, com exceo de

ObjectType. Alternativamente, pode-se
utilizar a tecla DELETE para excluir uma
propriedade.
Boto Cria um nome de coluna associado a mais de

uma propriedade. Selecione as propriedades
que deseja agrupar e clique neste boto. Os
nomes das propriedades so agrupados em
uma mesma linha, utilizando o nome da
coluna definido para a propriedade que est
no topo da lista.
Boto Mostra uma janela com texto de ajuda.
Ao pressionar o boto , a seguinte janela aberta para a seleo de propriedades:
68 E3 Studio
Seleo de Propriedades
Opes disponveis na janela Propriedades
OPO DESCRIO
Classes de objetos Apresenta as classes de objetos que se
enquadram no filtro escolhido a partir do
objeto raiz.
Boto Adiciona todas as propriedades do tipo de

objeto selecionado na opo anterior.
Listar todas as classes de objetos do E3 Se esta opo for selecionada, a caixa de

seleo de objetos mostrar todas as
classes existentes no E3, independente de
filtro ou objeto raiz.
Propriedades Mostra as propriedades do objeto

selecionado.
As propriedades em negrito nesta lista j foram inseridas na lista que define as colunas do
arquivo CSV. Um duplo-clique sobre uma propriedade faz com que ela seja adicionada ou
removida, dependendo se ela j estava ou no na lista. Se a propriedade havia sido agrupada
com outras, o duplo-clique remove apenas essa propriedade do agrupamento, mantendo as
outras propriedades agrupadas corretamente.
As propriedades do tipo Font possuem propriedades internas que configuram separadamente

tipo, tamanho e outras caractersticas da fonte. Elas so exportadas com o nome da
propriedade principal (de acordo com o objeto), seguido do nome da propriedade interna,
E3 Studio 69
separados por um ponto (por exemplo, TextFont.Bold). No configurador de modelos, as
propriedades internas aparecem separadas para o usurio, para que a escolha possa ser
feita isoladamente.
Propriedades do Tipo Font
2.6.5 Importao de Objetos do Elipse SCADA para o E3

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

Os Tags de Comunicao do Elipse SCADA so exportados separadamente para cada Driver.
Para fazer a exportao, abra a aplicao no Elipse SCADA e siga estes procedimentos:
1. No Organizer do Elipse SCADA, abra a pasta de Drivers e clique sobre o Driver desejado.
2. Clique no boto Exportar.
70 E3 Studio
Exportao de Drivers
3. Escolha o local e o nome do arquivo a ser gerado. Alm do arquivo com as configuraes dos
Tags, ser gerado um arquivo com o mesmo nome, seguido do sufixo _Alarms. Esse arquivo
ser utilizado posteriormente na importao da configurao de alarmes no E3.
Para fazer a importao dos Tags no E3 3.0, siga esses passos:
1. Insira um Driver de Comunicao no Organizer do E3.
2. Renomeie o Driver para que fique com o mesmo nome do Driver utilizado na aplicao
Elipse SCADA, para que posteriormente as referncias para os Tags desse Driver sejam
importadas corretamente.
3. Clique com o boto direito do mouse no Driver de Comunicao, e clique em Importar.
4. Na lista de tipos de arquivos, selecione a opo Arquivos do Elipse SCADA (*.e2f), e a seguir
selecione o arquivo exportado anteriormente, sem o sufixo _Alarms. No necessrio
selecionar um modelo.
E3 Studio 71
Importao de Tags
2.6.5.2 Importao de Tags RAM e Demo

Para exportar os Tags RAM e Demo, siga estes passos:
1. No Organizer do Elipse SCADA, clique na pasta Tags.
72 E3 Studio
Exportao de Tags
Tags, ser gerado um arquivo com o mesmo nome seguido do sufixo _Alarms. Esse arquivo
ser utilizado posteriormente na importao da configurao de alarmes no E3.
Para fazer a importao dos Tags no E3 3.0, siga esses passos:
1. Insira um Servidor de Dados no Organizer do E3.
2. Renomeie o Servidor de Dados para Dados, para que posteriormente as Associaes dos
objetos de Tela sejam importadas corretamente.
3. Clique com o boto direito do mouse no Servidor de Dados, e clique na opo Importar.
E3 Studio 73
2.6.5.3 Importao da Configurao e Tags de Servidores OPC
1. No Organizer do Elipse SCADA, abra a pasta OPCServers e clique sobre o Driver OPC
desejado.
Exportao de Configuraes e Tags de Servidores OPC
Tags OPC, ser gerado um arquivo com o mesmo nome seguido do sufixo _Alarms. Esse
arquivo ser utilizado posteriormente na importao da configurao de alarmes no E3.
Para fazer a importao dos Tags OPC no E3 3.0, siga esses passos:
1. No Organizer do E3, insira um novo Driver de Comunicao OPC.
2. Renomeie o Driver de Comunicao OPC para que fique com o mesmo nome do Driver OPC
utilizado na aplicao Elipse SCADA, para que posteriormente as referncias para os Tags
deste Driver OPC sejam importadas corretamente.
3. Clique com o boto direito do mouse no Driver OPC, e selecione a opo Importar.
74 E3 Studio
2.6.5.4 Importao da Configurao de Alarmes

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

A exportao de Telas do Elipse SCADA parcial e suporta apenas um subconjunto dos objetos
de Tela. Para exportar uma Tela, siga esses passos:
1. No Organizer do Elipse SCADA, abra a pasta Telas e clique sobre a Tela desejada.
E3 Studio 75
Exportao de Telas
3. Escolha o local e o nome do arquivo a ser gerado.
4. No Organizer do E3, insira uma nova Tela.
5. Clique com o boto direito do mouse sobre a Tela e selecione a opo Importar.
selecione o arquivo exportado anteriormente. No necessrio selecionar um modelo.
Se a importao foi realizada com sucesso, a Tela ser preenchida com os objetos, e nenhuma
mensagem de erro ser mostrada. Os arquivos de imagens utilizados pela Tela devem ser
tratados conforme um dos casos a seguir:
Arquivos de imagens com caminhos relativos na aplicao Elipse SCADA: estes arquivos
devem ser inseridos manualmente como Recursos no projeto do E3. possvel inserir
vrios arquivos de uma vez, clicando com o boto direito do mouse na pasta Recursos do
Organizer, e escolhendo a opo Inserir recurso em
Arquivos de imagens com caminhos absolutos: estes arquivos devem permanecer nos seus
diretrios originais. O E3 ir procur-los no mesmo diretrio onde so encontrados pela
aplicao do Elipse SCADA
76 E3 Studio
NOTA: recomendado inserir todos os arquivos no projeto como Recursos, para que o
Viewer do E3 possa fazer o download automaticamente pela rede. Isso evita a necessidade
de ter que instalar os arquivos manualmente nas mquinas cliente.
2.6.6 Importao e Exportao de Associaes

Para a importao ou a exportao de Associaes no E3, deve ser selecionada a opo
correspondente no modelo. No h como excluir apenas um ou outro tipo de Associao: ou
todas so importadas ou exportadas, ou nenhuma.
Cada Associao ocupa uma linha no arquivo CSV. A identificao das Associaes feita
atravs das seguintes palavras-chave:
AgSimple: para Associaes Simples, Bidirecionais ou Reversas (essas devero ser

diferenciadas pelas propriedades Reverse e Bidirectional)
AnalogBind: para Associaes Analgicas
AnimationBind: para Associaes Digitais
TableBind: para Associaes por Tabela
As propriedades ou os campos das Associaes so importados ou exportados como se

fossem propriedades de objetos, com uma coluna no arquivo CSV para cada uma delas. Todas
as Associaes possuem as propriedades Source e Property, e alm delas, as propriedades
existentes para cada Associao so as seguintes:
AgSimple: Reverse, Bidirectional
AnalogBind: SrcHiValue, SrcLoValue, DstHiValue, DstLoValue
AnimationBind: BlinkOn, BlinkOff, OnValue, OffValue, BlinkOnValue, BlinkOffValue
A criao de linhas da tabela respeita o ndice informado pelo usurio. Se o ndice no for um
nmero, mostrada uma mensagem de erro (nome invlido). Se for um ndice inexistente (por
exemplo, s existem duas linhas na tabela e o usurio quer inserir a linha 5), as linhas que
faltam so criadas e ficam com os valores padro.
Todas as Associaes so importadas ou exportadas, independente da seleo de

propriedades que o usurio tenha feito. Se uma Associao para determinada propriedade j
existir, o usurio ser questionado sobre o que fazer. Caso contrrio, elas sero criadas.
E3 Studio 77
Importao de uma Associao pr-existente
No nome do objeto, deve ser informado o caminho completo, no formato Objeto.Links.Nome.

Exemplo:
Texto1.Links.Value 'Links indica que uma Associao, e Value a propriedade que
possui a Associao
2.6.7 Importao e Exportao de Colees e seus Itens

Para a importao ou a exportao de colees no E3, deve ser selecionada a opo
correspondente no modelo. No h como excluir apenas uma ou outra coleo: ou todas so
importadas ou exportadas, ou nenhuma.
As colunas de cada coleo dependem das propriedades que essa coleo possui. O
tratamento feito da mesma forma que nas colunas das propriedades dos objetos.
No caso de colees e itens de coleo, as propriedades precisam ser includas no arquivo INI
manualmente. No possvel selecionar essas propriedades atravs do configurador de
modelos.
As colees podem ser importadas e suas propriedades, atualizadas. Como as colees

sempre existem, e no possvel criar outra coleo do mesmo tipo, o usurio questionado
se deseja ignorar ou sobrescrever a coleo existente.
Se o item de coleo que est sendo importado j existir, o usurio questionado se deseja
ignor-lo, sobrescrev-lo ou criar um novo. Caso o usurio selecione essa ltima opo:
No caso de Penas e Eixos, o nome ser auto-incrementado corretamente
No caso de linhas da Associao por Tabela, elas sero criadas sempre ao final desta
No caso de colunas da Legenda, ser mostrada uma mensagem de erro informando que o
nome no vlido, ou que j existe a coluna e o nome no pode ser auto-incrementado (as
colunas da Legenda tm nomes pr-definidos e no possvel criar colunas com outros
nomes)
No nome do objeto, deve ser informado o caminho completo do tipo Objeto.Collection.Name.

Exemplo:
78 E3 Studio
E3Chart1.Pens.Pena1
Na coluna de tipo deve aparecer uma das seguintes palavras-chave:
IDispChartPen: para Penas do E3Chart
ILegendColumn: para Legendas do E3Chart
IAxis: para Eixos do E3Chart
ITableBindRow: para linhas das Associaes por Tabela
2.6.8 Logs e Relatrios de Falhas

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

Neste relatrio constam falhas que provavelmente so erros no arquivo CSV, como objeto
inexistente, entre outras.
Relatrio de falhas na importao
2.7 Lista de Propriedades

A Lista de Propriedades uma janela de configurao das propriedades do objeto
selecionado.
O ttulo da Lista de Propriedades mostra sempre o nome do objeto selecionado no momento.

Para que esta caixa esteja visvel no projeto, necessrio que a opo Lista de Propriedades
esteja marcada no menu Visualizar.
E3 Studio 79
Lista de Propriedades
Pode-se configurar um valor para uma propriedade digitando diretamente no campo

selecionado, ou ainda seguindo as instrues da janela ao clicar sobre o campo Valor.
2.8 Galeria
Coleo de objetos grficos que podem ser arrastados e inseridos nas Telas das aplicaes.
Estes objetos so arquivos do tipo Metafiles (WMF, Windows MetaFile).
Galeria
80 E3 Studio
2.9 AppBrowser
O AppBrowser uma ferramenta que auxilia o usurio a montar a aplicao informando uma
expresso lgica, uma Associao ou um valor para a propriedade sendo manipulada, de
acordo com o objeto selecionado. Assim, possvel minimizar erros durante a criao da
aplicao.
AppBrowser
No quadro esquerda so mostrados os objetos do E3 que podem ser utilizados para compor
o texto que ser o resultado do uso do AppBrowser. De acordo com seu contexto de utilizao,
alguns objetos no podero ser utilizados e nem sero mostrados aqui.
No quadro central so mostradas as propriedades e os mtodos do objeto selecionado, e no

quadro direita o texto de ajuda da propriedade ou do mtodo selecionado.
Mais abaixo mostrado o texto resultante do AppBrowser, ao lado dos botes Colar e Cancelar
. Clique em Colar para aceitar o resultado e copiar o valor para o local desejado. Clique em
Cancelar para ignor-lo.
NOTAS:
Ao selecionar Tags, o AppBrowser sempre aberto na ltima posio, e no na posio
apontada pelo link atual.
O AppBrowser possui a funo Auto Complete: basta digitar o nome do objeto desejado
que ele ser automaticamente selecionado.
Existem trs maneiras de se utilizar o AppBrowser:
Atravs de scripts
Atravs de Associaes
E3 Studio 81
Atravs de algumas propriedades de objetos que possuem como valor um outro nome de
objeto
Cada uma destas maneiras ser abordada nos tpicos seguintes.
2.9.1 Acessando o AppBrowser a partir de um Script

Para utilizar o AppBrowser a partir de um script, basta abrir a view de scripts desejada e clicar
no boto da barra de ferramentas de scripts. Neste modo, os objetos esto separados
conforme a figura a seguir.
AppBrowser via Scripts
No quadro esquerda:
O primeiro item, mostrado isoladamente, o Contexto. O objeto contexto o que originou

a chamada do AppBrowser, ou seja, o dono do script
O segundo item a Hierarquia completa para se chegar ao objeto contexto, caso o contexto
no esteja na raiz do projeto. Esse objeto pode ser expandido e o prprio objeto contexto
pode ser visto nesta hierarquia
Caso o contexto no seja um objeto do servidor, o terceiro item mostrado ser o Viewer
(objeto Application)
O quarto item o Servidor. Nele so listados todos os objetos do servidor que a aplicao
possui. Caso este item seja o contexto atual, ele conter a indicao de Application
O quinto item chamado de Tarefas. Nele aparecem as tarefas mais comuns de serem
executadas atravs de um script. So duas: Carregar relatrio (cujo resultado do
AppBrowser a expresso para carregar um Relatrio) e Abrir tela (cujo resultado a
expresso para abrir a Tela selecionada, equivalente ao Pick Abrir Tela)
82 E3 Studio
Finalmente, o sexto item mostra todas as funes do VBScript disponveis para uso em
scripts
De acordo com o objeto selecionado, o quadro central mostra suas propriedades e seus
mtodos.
2.9.2 Acessando o AppBrowser a partir de uma Associao

Para acessar o AppBrowser a partir de uma Associao, basta abrir a Janela de Propriedades,
selecionar a aba Associaes, logo aps a propriedade desejada, e finalmente clicar no boto
que aparece direita. O AppBrowser aberto e os objetos so apresentados conforme a
figura a seguir.
AppBrowser via Associaes
Neste caso, apenas as propriedades dos objetos so mostradas no quadro central da janela.
Seus mtodos no so mostrados, pois no permitido us-los em Associaes.
2.9.3 Acessando o AppBrowser a partir de uma Propriedade

Algumas propriedades permitem o uso do AppBrowser para auxiliar no preenchimento
correto do valor esperado. Estas propriedades, quando selecionadas, mostram um boto
direita do campo Valor da Lista de Propriedades. Ao clicar nesse boto o AppBrowser
chamado, mostrando apenas os objetos que podem ser usados como valor da propriedade
selecionada. As propriedades e mtodos destes objetos so omitidos. o caso, por exemplo,
da propriedade DBServer do objeto Frmula. O AppBrowser mostra apenas os objetos do tipo
Banco de Dados existentes na aplicao.
E3 Studio 83
AppBrowser via Propriedade
As propriedades que permitem o uso do AppBrowser so:
DBServer dos objetos Frmula, Histrico e Storage
DataSource, do objeto Servidor de Alarmes
InitialScreen, do objeto Viewer
SplitLink, do objeto Quadro
2.10 Conectar A
A opo Conectar a utilizada para determinar a conexo do E3 Studio a um servidor. Esta
opo permite configurar em qual servidor de Domnio o E3 Studio deve se conectar, e
permite tambm informar se o E3 Studio deve obter a licena do servidor onde roda o Domnio
ou se deve obter a licena em um outro servidor. Para utilizar este recurso, clique no menu
Arquivo - Conectar a, e a seguinte caixa de dilogo aberta:
84 E3 Studio
Janela Conectar a
Opes disponveis na janela Conectar a
OPO DESCRIO
Conectar ao servidor local Habilita a conexo com o servidor local.
Conectar a um servidor na rede Habilita a conexo com um servidor da rede.

Para tanto, basta acess-lo atravs da caixa
de seleo.
Pegar licena no servidor de Domnio atual Usa licena do servidor onde roda o Domnio.
Usar licena de um servidor especfico Usa a licena de outro servidor, que no o

servidor que est rodando o Domnio.
Se a conexo com qualquer dos dois servidores (Domnio ou licena) cair, o E3 Studio
desconectado do outro servidor. A ltima configurao guardada no Registro do Windows e,
da prxima vez em que o E3 Studio for aberto, ele se conectar aos servidores de Domnio e de
licena utilizados da ltima vez.
Se o servidor de licena no estiver disponvel, ou se no houver mais licenas disponveis,

ento o E3 Studio ficar em modo Demo. Um E3 Studio sem licena (modo Demo) s poder se
conectar a um servidor de Domnio que tambm esteja em modo Demo.
Se o servidor de licena for diferente do servidor de Domnio, o nome do servidor de licena

mostrado no ttulo da janela do E3 Studio: (licena no servidor local) ou (licena em
<Nome_Servidor>).
Se for especificado um servidor de licena, a janela de licenas do E3 Server no servidor de

Domnio mostra o nome do servidor que est emprestando a licena para o E3 Studio:
SERVIDOR1 (licena emprestada de SERVIDOR2). Neste caso a licena que est listada no
servidor de Domnio no entra na contagem de licenas de E3 Studio em uso naquele servidor.
E3 Studio 85
Se o servidor de Domnio no possuir uma licena, e um E3 Studio se conectar a este servidor
usando a licena de outro, ento o servidor de Domnio passar temporariamente de modo
Demo para modo Studio, voltando para modo Demo assim que a sesso de Studio for fechada.
NOTA: Quando o E3 Studio estiver utilizando uma licena emprestada de outro servidor, ele
deve forosamente permanecer aberto enquanto o aplicativo estiver em execuo. Se ele
for fechado enquanto o aplicativo estiver rodando, a licena de E3 Studio emprestada (que
permite a execuo do aplicativo por seis horas) ser liberada, e o E3 Server finalizar a
execuo do aplicativo imediatamente (em no mximo 10 segundos).
DICA: Quando o usurio conectar a um servidor, importante que os aplicativos sejam

abertos atravs de um caminho na rede. Ao invs de usar C:\projetos\projeto.dom, utilize o
caminho \\server\projetos\projetos.dom. Desta forma, o E3 Studio e o E3 Server remoto
podero acessar os arquivos utilizando o mesmo caminho.
86 E3 Studio
CAPTULO
3
Domnios
Um Domnio um conjunto de objetos e configuraes que definem um sistema de

superviso. Corresponde ao que se chamava de Aplicativo no Elipse SCADA.
O E3 um ambiente modular de desenvolvimento e execuo de sistemas de superviso,

composto pelos mdulos descritos nas sees a seguir.
3.1 E3 Server
O E3 Server o coordenador de todos os mdulos do E3. Ele sempre roda como servio,
mesmo no modo Demo, seja ele registrado como servio ou com /regserver, e deve estar
sempre rodando. Pode tambm ser iniciado quando um E3 Studio local for iniciado, ou atravs
de um atalho para rodar o Domnio (por exemplo, e3admin start app.dom). Ele responsvel
por:
Verificar e gerenciar licenas de uso dos diferentes mdulos do E3
Iniciar, parar ou monitorar o processo de runtime (E3Run) do Domnio
Abrir, editar ou manipular arquivos DOM
Controlar o acesso de usurios aos objetos do Domnio
Monitorar outros servidores do Domnio e implementar o Hot-Standby
O E3 Server pode trabalhar com apenas um arquivo de Domnio por vez, e este chamado de
Domnio aberto. Os arquivos de Domnio s so manipulados pelo E3 Server.
3.1.1 Licenciamento
O E3 Server suporta dois modos de licenciamento: Licena Ativa e Demo. O modo de
licenciamento definido na inicializao do servidor. Se h um dispositivo de proteo vlido
(do tipo hardkey ou softkey), o E3 Server entra em modo Licena Ativa. Se nenhum dispositivo
for localizado, entra em modo Demo.
Se houver a troca do dispositivo, o E3 Server ir comparar as licenas deste novo dispositivo

com as licenas do dispositivo anterior, e far os seguintes ajustes:
Se as novas licenas forem exatamente iguais em limitaes s do dispositivo anterior,

sero aplicadas imediatamente
Domnios 87
Se as novas licenas forem menos limitadas do que as do dispositivo anterior, tambm
sero aplicadas imediatamente
Se as novas licenas forem mais limitadas do que as do dispositivo anterior, o E3 Server

aguardar por um minuto para que o dispositivo anterior seja reconectado. Ao final deste
perodo, se as licenas continuarem restritivas, o servidor ser reiniciado e as novas
licenas sero aplicadas
NOTA: Para maiores informaes sobre licenciamento no E3, entre em contato com o setor
comercial da Elipse Software.
3.2 E3Run
O E3Run o processo responsvel pela execuo dos objetos do servidor: Tags, Alarmes,
Banco de Dados, Histricos, etc.; ou seja, todos os objetos exceto as Telas e o objeto Viewer.
A execuo do E3Run indicada no cone do E3 Admin na rea de Notificao do Windows, de

acordo com a tabela a seguir:
Opes disponveis para cones da rea de Notificao
OPO DESCRIO
Seta verde: mostrada quando o Domnio est
carregado e rodando.
Quadrado cinza: o Domnio est carregado,

mas no rodando.
Linha reta amarela (giratria): mostrada

quando o Domnio est sendo iniciado ou
parado. Ocorre nos casos em que o Domnio
demora a comear a execuo, como um
sinal de espera.
Barras amarelas: mostradas quando o

Domnio est em espera.
O E3Run sempre roda como servio, seja ele registrado como servio ou com o comando /
regserver. Este processo usa o protocolo REC para se conectar fila de banco de dados do E3
Server.
88 Domnios
3.3 E3 Admin
O E3 Admin o mdulo responsvel por monitorar e comandar o E3 Server. simbolizado pelo
cone na rea de Notificao do Windows. Este mdulo iniciado quando o usurio loga
no Windows, ou quando o servio do E3 Server iniciado.
O E3 Admin tambm responsvel por tratar as opes de controle do Domnio via linha de
comando, das seguintes maneiras: e3admin <nome_do_dominio> [opes] ou e3admin
[opes] <nome_do_dominio>. As opes de linha de comando so listadas a seguir:
-start ou /start: Inicia o Domnio informado pelo usurio. O uso desta opo no
obrigatrio. Mesmo se no for informada, o Domnio ser iniciado
-viewer ou /viewer: Executa o Viewer para a aplicao
-load: Semelhante opo -start, porm somente carrega o Domnio, sem execut-lo. No
pode ser usada com a opo -viewer
-stop: Para o Domnio em execuo, quando existir. Esta opo deve ser utilizada sozinha
-close: Para e fecha o Domnio em execuo, quando existir. Esta opo deve ser utilizada
sozinha
-refresh: Fora a atualizao do Domnio sem a utilizao de um Viewer
-help: Mostra uma caixa de dilogo com as opes de linha de comando para o E3 Admin,
como na figura a seguir:
Caixa de dilogo com as opes de linha de comando do E3 Admin
Se as opes -load, -start ou -viewer forem utilizadas, o Windows Vista pede autorizao de
Administrador quando o E3 Admin no foi iniciado por um usurio Administrador do sistema
(dependendo da configurao do Controle de Conta de Usurio do Windows Vista).
Caso existam restries no Domnio, as opes -load, -stop, -refresh e -close pedem o login do
usurio.
Domnios 89
3.4 IOServer
O IOServer o processo responsvel pela execuo dos Drivers de Comunicao. Cada Driver
roda em um IOServer separado. Os IOServers so criados, mantidos e monitorados pelo
processo E3Run.
3.5 E3 Studio
O E3 Studio o ambiente de desenvolvimento e configurao de aplicativos. Permite abrir e
editar arquivos .prj ou .lib. O E3 Studio multi-usurio, isto , vrios E3 Studios podem
modificar os mesmos arquivos ao mesmo tempo. O E3 Studio utiliza a conexo REC para se
comunicar com o E3 Server.
3.6 E3 Viewer
O E3 Viewer a interface com o usurio em tempo de execuo, pois mostra as Telas em
execuo e permite a operao do sistema. O E3 Viewer pode ser executado a partir de
qualquer ponto da rede que tenha acesso ao E3 Server, sem a necessidade de copiar o
aplicativo para os outros E3 Viewers, pois as Telas e os bitmaps so carregados conforme a
necessidade, em tempo de execuo.
3.7 Componentes do Domnio

Um Domnio constitudo dos arquivos descritos nas sees seguintes.
3.7.1 Arquivo de Configurao do Domnio

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

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

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

novo Domnio
Domnios 91
Atravs do Assistente de Aplicaes do E3, que permite a criao de um Domnio novo com
um arquivo de projeto (.prj) ou uma biblioteca (.lib), conforme a prxima seo
3.8.1 Assistente de Aplicaes do E3

O Assistente de Aplicaes do E3 a ferramenta utilizada para criar um novo Domnio com um
projeto ou uma biblioteca. Esta opo pode ser acessada das seguintes maneiras:
Atravs do boto Novo , na barra de ferramentas Padro
Atravs do menu Arquivo - Novo Projeto
Uma vez que o Assistente tenha sido acessado, a tela inicial aberta. Para continuar, clique
em Avanar.
Tela inicial do Assistente de Aplicaes do E3
3.8.1.1 Tipo de Aplicao

Nesta tela, pode-se escolher entre a criao de uma Aplicao padro, uma Biblioteca de
componentes do E3 ou uma Aplicao em branco.
Uma Aplicao padro aquela cujo projeto possui pelo menos um objeto Viewer, uma Tela e
um Servidor de Dados, tendo ainda a opo de inserir, com a ajuda do Assistente, um Driver
de Comunicao, um Banco de Dados, um Servidor de Alarmes e uma Configurao de
Alarmes.
92 Domnios
NOTA: as telas Driver de Comunicao, Banco de Dados e Alarmes s sero mostradas na
criao de uma Aplicao padro.
Uma Biblioteca de componentes do E3 um arquivo utilizado para guardar diversos

componentes que podem ser utilizados em aplicaes.
Uma Aplicao em branco um projeto criado sem nenhum objeto.
No item Nome da aplicao, especifique o nome do arquivo .prj ou .lib que est sendo criado
(de acordo com o que foi escolhido na opo anterior). O local onde a aplicao ser salva
especificado no item Salvar a aplicao na pasta. Caso seja necessrio, utilize o boto Procurar.
Tela Tipo de Aplicao
Caso a pasta informada no exista, o usurio avisado, e deve decidir se deseja cri-la.
Aviso de pasta inexistente
Clique no boto Avanar para prosseguir.
Domnios 93
NOTA: a opo Biblioteca de componentes do E3 ser discutida mais adiante, no captulo
Bibliotecas.
3.8.1.2 Domnio
Nesta tela, possvel decidir a qual Domnio pertencer o projeto ou a biblioteca que est
sendo criado. A habilitao da opo Adicionar no Domnio ativo condicionada existncia
de Domnios ativos no sistema; clicando nesta opo, o novo projeto far parte do Domnio
atual. A opo Criar um novo Domnio cria um novo Domnio, ao qual o projeto ou biblioteca
pertencer. O nome deste novo Domnio indicado na opo Entre com o nome do Domnio.
Por fim, com a opo No adicionar em nenhum Domnio, o projeto ou biblioteca criado
continuar sem pertencer a nenhum Domnio.
Tela Domnio
3.8.1.3 Resoluo do Viewer

Nesta tela, o usurio pode configurar as propriedades do Viewer que definem a resoluo de
trabalho para a aplicao sendo criada, ou seja, a resoluo do computador que ir executar
a aplicao. Assim, as Telas que forem criadas podero ter seus tamanhos definidos de forma
que se ajustem janela do Viewer sem a necessidade de barras de rolagem. A opo
Resoluo da tela permite escolher dentre uma srie de resolues pr-definidas; j a opo
Avanado permite informar um valor personalizado.
94 Domnios
Tela Resoluo do Viewer
Domnios 95
3.8.1.4 Driver de Comunicao
Nesta tela, o usurio pode decidir pela incluso de um objeto Driver de Comunicao no
projeto sendo criado. Caso positivo, possvel configurar o arquivo .dll que este Driver utiliza,
na opo Arquivo do driver de comunicao. Para procurar o arquivo, utilize o boto .
Tela Driver de Comunicao
96 Domnios
3.8.1.5 Banco de Dados
Nesta tela, o usurio pode decidir pela incluso de um objeto Banco de Dados no projeto
sendo criado. Caso positivo, possvel configurar o arquivo .mdb que este Banco de Dados
utiliza, na opo Nome do arquivo de banco de dados Access. Para procurar o arquivo, utilize o
boto .
Tela Banco de Dados
Domnios 97
3.8.1.6 Alarmes
Nesta tela, o usurio pode decidir pela incluso de um objeto Servidor de Alarmes e de um
objeto Configurao de Alarmes no projeto sendo criado. A opo Desejo guardar os dados dos
alarmes em disco habilita o armazenamento de informaes relativas a alarmes em disco,
desde que um objeto Banco de Dados tenha sido inserido no projeto.
Tela Alarmes
Clique no boto Avanar para finalizar a criao da aplicao.
Aps, o sistema mostra a tela final do Assistente, com uma mensagem que indica o final do
processo de criao da aplicao.
98 Domnios
Tela final do Assistente de Aplicaes do E3
Finalize o processo clicando no boto Concluir.
3.9 Configuraes de Domnio

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

Notificaes do Windows
Domnios 99
NOTA: O menu Domnio - Opes no est disponvel no modo Demo, e as opes de Executar
e Parar no esto disponveis se o Domnio estiver em modo Hot-Standby ou for aberto em
um computador que no faz parte do Domnio.
3.9.1 Opes
Na aba Opes possvel habilitar a redundncia de servidores.
Aba Opes
Opes disponveis na aba Opes
OPO DESCRIO
Hot-Standby Aciona o modo Hot-Standby. Se a opo for
desabilitada, o Domnio executado no
servidor em que foi carregado, sem suporte a
Hot-Standby. Se a opo for habilitada,
possvel selecionar um servidor principal
onde o Domnio ser executado e,
opcionalmente, um servidor em espera.
100 Domnios
OPO DESCRIO
Servidor principal Seleciona o nome do servidor principal para
execuo do Domnio. Para cadastrar e
configurar os servidores, utilize a aba
Servidores.
Servidor de backup Se habilitado, seleciona um servidor de

backup para execuo do Domnio. Este
servidor fica em espera, com o aplicativo
carregado no E3Run pronto para ser
executado caso o servidor principal falhe, ou
caso o servidor de backup seja ativado
manualmente.
Endereos para PING de integridade da rede O algoritmo de Hot-Standby exige que seja
declarada uma terceira entidade de rede (as
outras duas so os servidores principal e o
backup) para determinar se a rede est
funcionando. Se no for possvel acessar o
endereo de integridade nem o servidor de
backup, o servidor principal assume que a
sua interface de rede est com problemas e
termina imediatamente a execuo do
Domnio. Este campo permite que vrios
endereos de rede sejam registrados. As
opes para este campo so as seguintes:
Os separadores permitidos para cada um

dos endereos so o espao, a vrgula, o
ponto e vrgula, a tabulao e a quebra de
linha
Se pelo menos um dos endereos

fornecidos neste campo retornar sucesso,
a rede ser considerada sem falhas
Os nomes de servidores no so sensveis

caixa
Nomes repetidos so descartados
Espaos em branco antes ou depois do

endereo so removidos
Ativar backup em caso de falha local Habilita a troca automtica de servidores

quando uma falha local reportada no
servidor principal. Falhas locais so
detectadas e reportadas pelo prprio
aplicativo atravs do mtodo Application.
ReportFailure. A troca de servidores s
feita se o servidor de backup estiver sem
falhas.
Domnios 101
OPO DESCRIO
Tempo para ativao do servidor reserva Permite indicar o tempo de ativao para o
servidor de backup. O valor padro 15
segundos. Este tempo afeta diretamente o
timeout do ping entre os servidores. Se for
muito abaixo (troca em 1 segundo, timeout
de ping em 160 ms), podem ocorrer trocas
espontneas de servidor, causadas por
pequenas falhas de rede.
Perfil de pr-ativao do servidor reserva Apresenta os seguintes perfis de pr-

ativao disponveis:
Mnimo: Ativa apenas os servios bsicos
Mximo: Faz com que o E3 ative o mximo

de objetos quando est em espera
(Associaes, Drivers, scripts e Banco de
Dados)
Definido pelo usurio: O usurio pode

definir quais os servios deseja ativar.
Cada uma das opes pode ser habilitada
ou desabilitada individualmente
102 Domnios
OPO DESCRIO
Pr-ativar os seguintes servios Permite ao usurio escolher os servios que
deseja ativar (desde que a opo anterior
tenha sido habilitada como Definido pelo
usurio):
Associaes (Links): O valor padro

desabilitado. Se habilitado, faz com que
Associaes e propriedades do tipo Link
de XObjects sejam avaliadas durante a
ativao em espera
I/O Drivers (sem comunicao): O valor

padro desabilitado. Se habilitado, os
IOServers sero criados durante a
ativao em espera. NOTA: Esta opo
importante em aplicativos com vrios
Drivers de Comunicao
Scripts: O valor padro desabilitado. Se

habilitado, faz com que todos os scripts de
eventos de objetos e de bibliotecas sejam
compilados e ativados durante a ativao
em espera
Banco de Dados: O valor padro

habilitado. Isto significa que o Banco de
Dados ser conectado durante a ativao
em espera. Se desabilitado, ele apenas
evita que a conexo com o Banco de
Dados seja criada durante a ativao em
espera
Esta opo habilitada automaticamente

quando o valor da propriedade
EnableSynchronization for igual a True.
NOTA: Quando o Domnio colocado em execuo, o E3 Server sempre escolhe o servidor

ativo por ordem alfabtica, independente de estar selecionado como principal ou backup.
Este critrio de desempate utilizado sempre que mais de um servidor se candidata a
executar o Domnio. Para maiores informaes, veja o captulo Hot-Standby.
Quando o Hot-Standby estiver ligado, os seguintes procedimentos so necessrios:
Definir um diretrio compartilhado na rede para conter a cpia principal dos arquivos do
Domnio. Este diretrio deve residir em um computador que no faa parte do Domnio E3
Criar em cada servidor do E3 um diretrio onde ser mantida uma cpia atualizada dos
Domnios 103
arquivos do Domnio. O E3Run ir utilizar esta cpia local dos arquivos PRJ e LIB
Abrir sempre o arquivo DOM da rede, utilizando o caminho de rede (por exemplo, \
\server\folder\Domnio.dom)
Quando utilizar o E3 Studio, sempre editar os projetos e bibliotecas da cpia principal (na
rede). Para aplicar as alteraes, copie os projetos e bibliotecas alterados para o diretrio
local dos servidores do Domnio. Aps a cpia, clique no boto Executar Aplicativo do E3
Studio para que as alteraes sejam aplicadas no processo de tempo de execuo (E3Run)
NOTA: A REDUNDNCIA NO EST DISPONVEL EM MODO DEMO. Quando o modo Hot-Standby

estiver ligado, necessrio que todos os servidores tenham uma cpia dos arquivos do
Domnio (.dom, .prj e .lib) e a mesma rvore de diretrios.
3.9.2 Segurana
Atravs da aba Segurana, possvel determinar as configuraes de segurana do Domnio.
Esta opo utilizada como padro, caso no seja habilitada nenhuma das opes de
permisso de segurana nos usurios do projeto. Para acessar tal item, clique com o boto
direito do mouse no cone do E3 Admin na rea de Notificaes do Windows, selecione a
opo Domnio - Opes e acesse a aba Segurana. A seguinte janela ser mostrada:
104 Domnios
Aba Segurana
Opes disponveis na aba Segurana
OPO DESCRIO
O usurio no pode alterar a sua senha Impede que o usurio troque a senha em
tempo de execuo.
A senha expira aps ... dias Determina o prazo de validade da senha do

usurio. Antes de terminar o prazo de
validade da senha, o sistema avisa quantos
dias restam para expirar. Aps a senha
expirar, o usurio fica desabilitado.
A senha deve conter no mnimo ... caracteres Determina a quantidade mnima de

caracteres para a senha do usurio.
A senha deve conter letras e nmeros Determina que a senha do usurio deve
conter letras e nmeros.
A senha deve conter no mnimo ... nmeros Determina a quantidade mnima de nmeros
na senha.
Domnios 105
OPO DESCRIO
A senha deve conter no mnimo ... letras Determina a quantidade mnima de letras na
senha.
A senha deve conter letras maisculas e Determina que a senha do usurio deve
minsculas conter letras maisculas e minsculas.
Bloquear a conta do usurio aps ... falhas de Determina a quantidade mxima de falhas
login de login para que a conta do usurio seja
bloqueada.
Desbloquear o usurio automaticamente aps Desbloqueia a conta do usurio depois de

... minutos determinados minutos.
Avisar o usurio nos ltimos ... dias antes da Determina a data em que o sistema comea
senha expirar a enviar mensagens dirias ao usurio,
avisando-o sobre a data de expirao de sua
senha. Aps esta data, se o usurio no
trocar sua senha, ele ser bloqueado e
somente o administrador poder
desbloque-lo.
Validar senhas sem diferenciar maisculas e Permite que as senhas sejam validadas sem
minsculas diferenciar maisculas de minsculas. Esta
opo no recomendada.
Bloqueio de Senha
A conta de um usurio pode ser bloqueada nas seguintes condies:
Se a senha expirar (o tempo de expirao pode ser atributo global, de grupo ou de usurio)
Se o usurio digitar a senha errada um determinado nmero de vezes seguidas, isto ,

falhas de login
Uma vez bloqueada, a conta no permite login. Esta condio persiste at que um
administrador desbloqueie a senha manualmente, ou ento o timeout de bloqueio expire.
3.9.3 Grupos de Viewers

possvel especificar, de acordo com o IP do Viewer, se este pode se conectar, e com qual tipo
de licena (Viewer Full ou Viewer Only).
Com este recurso possvel bloquear totalmente a conexo, ou limitar a quantidade e o tipo
de licenas que sero usadas simultaneamente para um determinado grupo de IPs.
Para acessar os grupos de Viewers, clique com o boto direito do mouse no cone do E3 na
rea de Notificaes do Windows, selecione a opo Domnio - Opes, e acesse a aba Grupos
106 Domnios
de Viewers. A seguinte janela ser mostrada:
Aba Grupos de Viewers
As opes disponveis so:
Opes disponveis na aba Grupos de Viewers
OPO DESCRIO
Nome Lista os nomes de todos os grupos de
Viewers.
Adicionar / Remover Adiciona ou remove grupos de Viewers.
Nome do grupo Habilita a criao ou alterao de nomes de

grupos de Viewers.
Domnios 107
OPO DESCRIO
Lista de IPs Especifica quais IPs pertencero ao grupo, e
desse modo compartilharo os mesmos
limites de conexo. Quando um Viewer tenta
se conectar ao E3 Server, seu IP ser
comparado aos grupos existentes. Aps
determinado o grupo ao qual pertence, ser
aplicada a restrio de licenas a este
Viewer, configurada para aquele grupo.
Adicionar / Editar / Remover Adiciona, edita ou remove os nmeros de IP.

Quando um grupo criado, ele no tem
nenhum IP especificado (exceto o primeiro
grupo, que sempre *.*.*.*, e no pode
ser criado pelo usurio). Caso o usurio
tente salvar a configurao e algum grupo
tenha uma lista de IPs vazia, o sistema emite
um aviso. Caso o grupo seja mantido assim,
ele no ter utilidade.
Permitir conexes de Viewer Full Quando selecionada, permite conexes de

Viewer Full para o grupo.
Limitar uso de licenas simultneas Quando selecionada, limita o uso de licenas

de Viewer Full simultneas a um
determinado nmero. Se a opo anterior
estiver marcada, mas esta estiver
desmarcada, o uso de licenas simultneas
ilimitado.
Permitir conexes de Viewer Only Quando selecionada, permite conexes de

Viewer Only para o grupo.
Limitar uso de licenas simultneas Quando selecionado, limita o uso de licenas

de Viewer Only simultneas a um
determinado nmero. Se a opo anterior
estiver marcada, mas esta estiver
desmarcada, o uso de licenas simultneas
ilimitado.
importante notar que estes limites so aplicados aps o limite do E3 Server, como
configurado no dispositivo de proteo. Por exemplo, se o dispositivo de proteo possuir dez
licenas de Viewer e o grupo especificar cinco conexes no mximo, apenas estas cinco sero
usadas. No entanto, se o dispositivo de proteo possuir cinco licenas de Viewer e o grupo
especificar dez conexes no mximo, ser utilizado o limite de cinco conexes do dispositivo.
Ou seja, o grupo de Viewer ter sempre uma limitao de licenas adicional a ser aplicada na
conexo do Viewer.
A configurao de Grupos de Viewers deve ser feita preferencialmente com o Domnio parado.
Caso seja feita com o Domnio em execuo, ela no ter efeito at que todos os Viewers
sejam desconectados.
108 Domnios
3.9.4 Registro de Eventos
Os eventos dividem-se em duas categorias: Eventos Padro do Sistema e Eventos Manuais.
Eventos Padro do Sistema so os eventos gerados automaticamente pelo E3, e que podem ter
o registro habilitado ou desabilitado individualmente:
Login ou Logout de usurio
Troca de senha de usurio
Falha de login de usurio
Alterao na base de dados de usurio
Bloqueio de conta de usurio
Incio ou trmino do Domnio
Alterao no Domnio (inserir, remover, habilitar ou desabilitar projetos e bibliotecas,

alterar a configurao do Domnio)
Atualizao do Domnio (quando o usurio aplica as alteraes feitas em projetos, atravs

do E3 Studio)
Troca manual de servidor Hot-Standby
Eventos Manuais so eventos definidos pelo aplicativo. Estes eventos so gerados em scripts
de usurio, atravs da chamada do mtodo Application.TrackEvent. Estes eventos podem ser
gerados tanto no Viewer quanto no Servidor (E3Run).
O Viewer apenas um gerador de eventos manuais. Basta chamar o mtodo Application.

TrackEvent, e o evento ser enviado para o E3 Server.
O diagrama a seguir mostra como os diferentes processos do E3 geram e tratam os eventos do

sistema:
Domnios 109
Diagrama de processos do E3
Cada E3 Server mantm uma lista interna dos eventos que devem ser registrados no Banco de
Dados. Estes eventos podem vir de trs fontes:
Eventos gerados nos Viewers (usando o mtodo Application.TrackEvent)
Eventos gerados internamente no E3 Server
Eventos gerados no E3 Server Standby
O E3 Server Standby, de tempos em tempos, envia a lista de eventos para o E3 Server Hot, pois
apenas este tem condies de gravar eventos no Banco de Dados. Os eventos so colocados
na fila de eventos do Hot, juntamente com os demais eventos do sistema, isto , o servidor
Hot centraliza a gravao de eventos.
Se houver uma troca de servidor, os eventos que no haviam sido gravados so passados
automaticamente para o novo servidor Hot.
O E3Run grava no Banco de Dados os registros enviados pelo E3 Server Hot. O E3 Server
informa o nome do Servidor de Dados e da tabela onde os dados sero gravados.
Para configurar o registro de eventos do E3, clique com o boto direito do mouse no cone do
E3 Admin na rea de Notificao do Windows, selecione a opo Domnio - Opes, e acesse a
aba Registro de Eventos. A seguinte janela ser mostrada:
110 Domnios
Aba Registro de Eventos
Opes disponveis na aba Registro de Eventos
OPO DESCRIO
Registrar os eventos do sistema em uma Habilita o registro de eventos no E3.
tabela no Banco de Dados do aplicativo
Selecionar automaticamente um Banco de Habilite esta opo para deixar que o E3Run
Dados no aplicativo escolha um objeto Servidor de Dados para
gravar os dados. Se o aplicativo possui
apenas um Servidor de Dados, este objeto
ser usado. Se tiver mais de um,
recomendado marcar a opo Usar este
Banco de Dados.
Usar este Banco de Dados Habilite esta opo para especificar o

Servidor de Dados onde sero gravados os
eventos. Se o nome do Servidor de Dados foi
informado incorretamente, os eventos
ficaro armazenados na fila de eventos do E3
Server (em memria), at que seja indicado
um Servidor de Dados vlido.
Domnios 111
OPO DESCRIO
Nome da tabela Indique o nome da tabela onde sero
gravados os eventos. A tabela informada
ser criada automaticamente pelo E3Run, e
ter os seguintes campos:
E3TimeStamp (Data/Hora): O campo

E3TimeStamp configurado pelo E3Run e
contm a data e hora em que o E3Run
conseguiu enviar o evento para o Banco
de Dados
EventTime (Data/Hora): O campo

EventTime a data e hora em que
realmente ocorreu o evento, a data e hora
atual do servidor (Hot ou Standby) quando
o evento foi criado, ou ento o parmetro
dtTimeStamp especificado para o mtodo
Application.TrackEvent
EventMessage (String): mensagem do

evento (mximo de 200 caracteres)
EventComment (String): comentrio sobre

o evento (mximo de 200 caracteres)
Marque abaixo os eventos que devem ser Lista os eventos disponveis no sistema,
registrados para serem registrados.
Se o E3Run tiver que escolher entre vrios Servidores de Dados, normalmente ser utilizado o
primeiro Banco de Dados ativado na execuo do Domnio. Se durante a execuo do Domnio,
o usurio desabilitar o projeto que contm o Servidor de Dados que estava sendo usado para
gravar os eventos, o E3Run automaticamente escolher outro Servidor de Dados que esteja
disponvel no aplicativo, e continuar com este Servidor de Dados at que outro Servidor de
Dados anterior seja reativado. Isto implica que, se houver mais de um Servidor de Dados no
projeto, possvel que alguns eventos sejam gravados em um Servidor de Dados e outros
eventos em outro Servidor de Dados (por isto, recomendado indicar um Servidor de Dados
especfico, quando houver mais de um Servidor de Dados no projeto).
Quando um evento selecionado na lista e a tecla F2 pressionada, abre-se uma caixa de

dilogo para edio do evento. A seguinte janela mostrada:
112 Domnios
Edio de eventos
Desmarque a opo Usar mensagem padro para alterar a mensagem do evento. Clique no
boto para inserir uma macro dentro da mensagem. Apenas as macros permitidas para o
evento sero mostradas.
Visualizao da macro disponvel para o evento
As macros sempre tem o formato %MACRO%. As seguintes macros podem ser usadas:
%%: Insere um sinal de % na mensagem
%USER%: Insere o nome do usurio que gerou o evento (ou "Annimo", se no houver
nenhum usurio logado)
%MACHINE%: Insere o nome do computador onde o evento foi gerado
Domnios 113
%SESSION%: Insere o nome do programa onde o usurio estava logado (Viewer, E3 Studio ou
E3 Server)
%CAUSE%: Informao adicional sobre o evento
Por exemplo, se a mensagem do evento Falha de Login for alterada para:

"Falhou login do usurio %USER% no computador %MACHINE% (usando um %SESSION%): %CAUSE
%"
Se o usurio Admin escrever uma senha errada enquanto fizer login no Viewer que est
rodando na mquina CLIENT004, ser gerado o seguinte evento:
"Falhou login do usurio Admin no computador CLIENT004 (usando um Viewer): login ou
senha incorretos"
Os eventos padro do sistema so descritos nas sees seguintes.
3.9.4.1 Login de Usurio

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

Usurio %User% terminou a sesso de uso de %SESSION% na mquina %MACHINE%
Gerado sempre que ocorrer o logout de um usurio no E3 Studio ou no Viewer (ou quando o
programa fechado sem logout. Neste caso, o logout automtico), onde:
%USER% contm o nome de login do usurio
%MACHINE% contm o nome do computador onde o usurio estava logado
114 Domnios
3.9.4.3 Troca de Senha
A senha do usurio %USER% foi alterada
Gerado sempre que a senha de um usurio for trocada (chamando o mtodo ChangePassword
no Viewer), onde:
%USER% contm o nome de login do usurio que teve a senha trocada
3.9.4.4 Falha de Login

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

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

A conta do usurio %USER% foi bloqueada
Gerado sempre que a conta de um usurio bloqueada por excesso de logins errados, onde:
%USER% contm o nome de login do usurio que teve a conta bloqueada
Domnios 115
3.9.4.7 Domnio Iniciado
Domnio iniciado pelo usurio %USER% no %SESSION% na mquina %MACHINE%
Gerado sempre que o Domnio iniciado (colocado em execuo), onde:
%USER% contm o nome de login do usurio que colocou o Domnio em execuo (ou
"Annimo" se no foi pedida autenticao quando o Domnio foi executado)
%SESSION% contm "E3 Studio" ou "E3 Server" (menu da rea de Notificaes do Windows)
%MACHINE% contm o nome do computador onde foi gerado o comando para executar o
Domnio
3.9.4.8 Domnio Finalizado

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

Domnio
3.9.4.9 Domnio Atualizado

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

nenhum usurio logado)
%SESSION% contm "E3 Studio"
%MACHINE% contm o nome do computador onde o E3 Studio estava rodando
116 Domnios
3.9.4.10 Domnio Modificado
Domnio modificado pelo usurio %USER% no %SESSION% na mquina %MACHINE%: %CAUSE%
Gerado sempre que o arquivo do Domnio (.dom) modificado, onde:
%USER% contm o nome do usurio que alterou o Domnio
%SESSION% contm "E3 Studio" ou "E3 Server"
%MACHINE% contm o nome do computador onde foi gerado o comando de modificar o

Domnio
%CAUSE% pode ser:
Aplicadas alteraes na janela do computador de edio do Domnio
Adicionado projeto "nomedoprojeto" (habilitado)
Adicionado projeto "nomedoprojeto" (desabilitado)
Removido projeto "nomedoprojeto"
Desabilitado projeto "nomedoprojeto"
3.9.4.11 Troca Manual de Servidores

Servidor reserva ativado pelo usurio '%USER%' no '%SESSION%' na mquina '%MACHINE%'
Gerado sempre que forada a ativao do servidor de backup de um Domnio, atravs da

opo Servidor - Ativar do menu do E3 Server, onde:
%USER% contm o nome de login do usurio que ativou o servidor de backup (ou "Annimo"
se no foi pedida autenticao quando o servidor foi ativado)
%SESSION% contm "E3 Server" (menu da rea de Notificaes do Windows)
%MACHINE% contm o nome do computador onde foi gerado o comando para ativar o
servidor de backup
Domnios 117
3.9.5 Projetos
possvel adicionar, remover ou editar os projetos (arquivos .prj) de um Domnio. Para
acessar este item, clique com o boto direito do mouse no cone do E3 Admin na rea de
Notificaes do Windows, selecione a opo Domnio - Opes e acesse a aba Projetos. A
seguinte janela ser mostrada:
Aba Projetos
Opes disponveis na aba Projetos
OPO DESCRIO
Nome Esta opo lista os nomes dos projetos no
sistema.
118 Domnios
OPO DESCRIO
Adicionar / Remover Atravs destas opes, pode-se remover ou
adicionar projetos no sistema. Para
adicionar um projeto, basta clicar no boto
Adicionar e especificar o campo Nome do
projeto. Para remover um projeto, basta
selecion-lo e clicar no boto Remover. O
arquivo PRJ no apagado do disco, apenas
removido da lista de projetos do Domnio.
Nome do projeto Digite o nome do arquivo do projeto, que

deve ser um caminho relativo ao diretrio do
Domnio (o diretrio que contm o arquivo .
dom). Exemplos: Telas.prj, Hidro\Estacao1.
prj
Em manuteno (execuo desabilitada) Esta opo permite desabilitar a execuo

do projeto, evitando a ocorrncia de erros
quando o Domnio executado. Quando a
opo habilitada, o cone indica que o
projeto no ser utilizado. Os projetos com o
cone esto habilitados e sero
executados.
3.9.6 Servidores
possvel adicionar, remover ou editar os servidores de um Domnio. Use a lista da esquerda
para selecionar um ou mais servidores a alterar. A lista indica tambm se o servidor est
habilitado ( ), em modo Manuteno ou desabilitado ( ). Para acessar este item, clique
com o boto direito do mouse no cone do E3 Admin na rea de Notificaes do Windows,
selecione a opo Domnio - Opes e acesse a aba Servidores. A seguinte janela ser
mostrada:
Domnios 119
Aba Servidores
As opes disponveis neste item so as seguintes:
Opes disponveis na aba Servidores
OPO DESCRIO
Nome Lista com os nomes dos servidores no
sistema.
Adicionar e Remover Atravs destas opes, pode-se remover ou

adicionar servidores no sistema. Para
adicionar um servidor em rede, basta clicar
no boto Adicionar e especificar os campos
Nome do servidor e Identificao do servidor
na rede; para adicionar um servidor local,
basta especificar o item Caminho local de
acesso aos arquivos de Domnio. Para
remover um projeto, basta selecion-lo na
lista e clicar no boto Remover.
Nome do servidor Determina o nome do servidor. Este nome

definido pelo usurio.
120 Domnios
OPO DESCRIO
Identificao do servidor na rede Digite o nome do servidor na rede. Deve ser o
nome da mquina com ou sem as barras
duplas invertidas no incio (por exemplo, \
\server ou server).
Pasta raiz dos arquivos do Domnio Indica a pasta onde esto localizados os
arquivos do Domnio (arquivos .prj, .lib, etc.)
do servidor selecionado. A opo No
especificar (utilizar a pasta do arquivo .DOM)
o padro, e indica que os arquivos esto na
mesma pasta do arquivo de Domnio (.dom).
Caso seja selecionada a opo Utilizar a
seguinte pasta local, o caminho digitado no
campo especfico deve conter apenas a
pasta, sem o nome nem a extenso do
arquivo de Domnio (.dom).
Em manuteno (execuo desabilitada) Esta opo permite desabilitar o servidor e

no utiliz-lo na execuo do Domnio.
Quando a opo habilitada, o cone
indica que o servidor no ser utilizado. Do
contrrio, o cone indica que o servidor
poder ser utilizado.
Domnios 121
3.9.7 Domnios Remotos
Permite adicionar, remover ou editar os Domnios Remotos. Use a lista da esquerda para
selecionar um ou mais Domnios Remotos a alterar. Para acessar tal item, clique com o boto
direito do mouse no cone do E3 Admin na rea de Notificaes do Windows, selecione a
opo Domnio - Opes e acesse a aba Domnios Remotos. A seguinte janela ser mostrada:
Aba Domnios Remotos
Opes disponveis na aba Domnios Remotos
OPO DESCRIO
Nome Esta opo lista os nomes dos Domnios
Remotos no sistema.
122 Domnios
OPO DESCRIO
Adicionar / Remover Atravs destas opes, pode-se remover ou
adicionar Domnios Remotos no sistema.
Para adicionar um Domnio Remoto em rede,
basta clicar no boto Adicionar e especificar
os campos Nome e Arquivo de Domnio. Para
remover um Domnio, basta selecion-lo na
lista e clicar no boto Remover.
Nome do Domnio Determina o nome do Domnio Remoto. Este

nome definido pelo usurio.
Arquivo de Domnio Determina o nome ou o caminho na rede

onde est o arquivo .dom do Domnio
Remoto.
Servidor Principal Identifica o servidor principal na rede.
Servidor de Backup Quando habilitado, identifica o servidor de

backup na rede.
Usurio no Domnio Permite reconhecer um usurio com senha

para cada Domnio Remoto. As opes
disponveis so: No especificar (annimo), e
Utilizar a seguinte conta. Ao selecionar a
segunda opo, os dois campos a seguir so
habilitados.
Usurio Identifica o usurio.
Senha Permite a conexo ao Domnio atravs de

senha.
possvel que uma configurao de Domnio Remoto possibilite a conexo ao prprio Domnio
local. A isso se d o nome de Alias local ou conexo Loopback.
Este alias criado segundo a configurao normal de Domnios Remotos. Basta que o nome
dos servidores (principal ou backup) seja localhost* ou o mesmo da mquina onde o
Domnio est rodando para que tudo funcione localmente. Neste caso, para que a
configurao funcione no Studio, no campo Arquivo de Domnio, basta colocar diretamente o
caminho local do arquivo DOM (por exemplo, c:\caminho\arquivo.dom).
Domnios 123
NOTAS:
A mudana dos aliases locais com o Domnio rodando NO suportada. O que acontecer
que, se o Domnio estiver rodando, Links j resolvidos como locais continuaro sempre
locais, mesmo que o alias seja reconfigurado para conectar numa mquina remota
realmente. Para contornar isso, basta reiniciar o Domnio
As conexes do tipo loopback no aparecero na janela Licenas (ou Estatsticas) do E3
Admin e nem iro necessitar de licena de Domnios Remotos para funcionar
* Para que o nome localhost funcione, necessrio que ele esteja configurado para
apontar para o IP 127.0.0.1 (que a configurao padro do Windows)
Para maiores informaes sobre as configuraes da aba Domnios Remotos, veja o item
Configurao da Conexo
3.10 Outras Opes da rea de Notificao

Alm das opes listadas na seo anterior, existem outras configuraes acessadas atravs
do menu do E3 Admin na rea de Notificaes do Windows.
3.10.1 Atalhos
Esta opo permite executar aplicativos presentes na instalao do E3 diretamente pelo
menu contextual do cone do E3 Admin, na rea de Notificao do Windows. Os seguintes
aplicativos podem ser executados:
Log Viewer
E3 Studio
E3 Tweak
E3 Viewer
O item Log Viewer abre o aplicativo Elipse Event Log Viewer j com o arquivo correspondente
sesso ativa de logs do E3. Para maiores informaes sobre este aplicativo, consulte o
Manual do Usurio do Elipse Event Log, disponvel no menu Iniciar - Programas - Elipse Software -
Elipse Event Log.
Se j h um Domnio rodando localmente, o item E3 Viewer deste menu abre um Viewer para
o Domnio local. Do contrrio, ou se a tecla SHIFT estiver pressionada, abre-se a janela inicial
do Viewer, onde possvel escolher o servidor e outras opes, como descrito no tpico E3
Viewer e E3 WebViewer - Execuo do E3 Viewer - Execuo Atrves do Menu Iniciar.
124 Domnios
3.10.2 Licenas
possvel visualizar as diversas licenas disponveis atravs do E3 Admin. Para acessar este
item, clique com o boto direito do mouse no cone do E3 Admin na rea de Notificaes do
Windows e selecione a opo Licenas. A seguinte janela ser mostrada:
Licenas
Opes disponveis na janela Licena
OPO DESCRIO
Nmero da licena Informa o nmero da licena (dispositivo de
proteo): um nmero hexadecimal de oito
dgitos com prefixo "HL", se o dispositivo for
uma hardkey; ou um nmero hexadecimal de
dezesseis dgitos com prefixo "SL", se o
dispositivo for uma softkey. Se o dispositivo
de proteo no foi detectado, o nmero
ser preenchido com zeros.
E3 Server Indica o tipo de E3 Server.
Domnios 125
OPO DESCRIO
E3 Studio Indica o nmero de licenas disponveis e em
uso do E3 Studio.
E3 Viewer Indica o nmero de licenas disponveis e em

uso do E3 Viewer.
E3 Viewer Only Indica o nmero de licenas disponveis e em

uso do E3 Viewer no modo Somente Leitura.
Domnio Remoto (Servidor) Indica o nmero de licenas disponveis e em

uso do Domnio Remoto (Servidor).
Domnio Remoto (Cliente) Indica o nmero de licenas disponveis e em

uso do Domnio Remoto (Cliente).
Pontos E/S Indica o nmero de pontos de comunicao.
Tags do Storage Indica o nmero de Tags do Storage.
Drivers Indica o nmero de Drivers disponveis e em

uso.
Servidor OPC Indica o nmero de licenas disponveis e em

uso do Servidor OPC.
Tempo mximo de execuo Indica o tempo mximo permitido de

execuo de um aplicativo.
Para maiores informaes sobre as limitaes do modo Demo do E3, veja o tpico Limitaes
do Modo Demonstrao.
126 Domnios
3.10.3 Estatsticas
A janela Estatsticas de Comunicao mostra os dados em tempo real sobre o trfego de
informaes na rede. A lista atualizada automaticamente a cada segundo. Para acessar tal
Windows e selecione a opo Estatsticas.
Estatsticas de Comunicao
Opes disponveis na janela Estatsticas de Comunicao
OPO DESCRIO
Computador Mostra o nome da mquina conectada ao E3
Server. Veja a tabela a seguir para uma
descrio dos cones que representam as
conexes de cada mquina listada nesta
coluna.
Dados enviados Mostra a quantidade de dados enviados.
Compresso no envio Mostra a percentagem de compresso no

envio.
Pacotes enviados Mostra a quantidade de pacotes enviados.
Dados recebidos Mostra a quantidade de dados recebidos.
Compresso no recebimento Mostra a percentagem de compresso no

recebimento.
Pacotes recebidos Mostra a quantidade de pacotes recebidos.
Conectado desde Mostra o tempo de conexo.
Os cones mostrados ao lado do nome da mquina, na coluna Computador, so descritos na
Domnios 127
tabela a seguir.
cones das conexes na janela de Estatsticas
CONE DESCRIO
Conexo de um Studio, consumindo licenas
do E3 Server (locais ou remotas).
Conexo de um Viewer, consumindo licenas

do E3 Server (locais ou remotas).
Conexo de um Viewer Only, consumindo

licenas do E3 Server (locais ou remotas).
Este cone pode representar trs tipos de

conexes:
Conexo de Hot-Standby de outro E3

Server (sempre remota)
Conexo de Domnios Remotos de outro

E3 Server (sempre remota)
Conexo do E3 Admin (atualmente sempre

local)
Conexo da fila de operaes do banco de

dados (arquivos .e3i e .e3o, sempre local).
128 Domnios
3.10.4 Monitor
A janela Monitor mostra informaes em tempo real sobre o estado dos servidores do
Domnio. Para acessar este item, clique com o boto direito do mouse no cone do E3 Admin
na rea de Notificaes do Windows e selecione a opo Monitor.
Monitor
Opes disponveis na janela Monitor
OPO DESCRIO
Domnio atual Nome do Domnio ativo.
Endereos de ping Lista com os endereos dos servidores de

ping.
Nome Nome do servidor.
Endereo Endereo de rede do servidor.
Ping Mostra o estado do ping de rede com este

servidor.
Relgio Mostra a hora local do servidor.
Estado Mostra o estado do Domnio no servidor (

Parado ou Rodando).
Conexo Mostra o estado da conexo DCOM com o

servidor.
Domnios 129
OPO DESCRIO
Funo Mostra uma lista de funes reportadas pelo
servidor:
Ativo: Este o servidor ativo do Domnio
Reserva: Este o servidor standby do

Domnio
Falha(n): Servidor possui falhas locais

reportadas
Prioridade: O servidor requisitou

prioridade para rodar o Domnio, este
indicador faz com que o servidor ativo
passe para o modo Standby
Candidato: O servidor candidato a rodar

o Domnio
E/S: O servidor possui IOServers ativos
3.10.5 Inicializao
Esta opo permite controlar o Domnio a ser iniciado automaticamente. O Domnio
configurado s ser executado se o E3 Server no estiver em modo Demo. Para acessar tal
Windows e selecione a opo Inicializao. A seguinte janela ser mostrada:
E3 Server - Inicializao
Opes disponveis na janela Inicializao
OPO DESCRIO
O Domnio carregado Ao iniciar, executa automaticamente o
Domnio previamente carregado.
130 Domnios
OPO DESCRIO
O Domnio configurado Ao iniciar, executa automaticamente o
Domnio configurado pelo usurio.
Nenhum Domnio No inicia nenhum Domnio.
3.10.6 Impressora
Esta opo mostra a lista das impressoras encontradas local ou remotamente, e permite que
o usurio escolha uma para ser usada pelo E3 Server. Para acessar tal item, clique com o
boto direito do mouse no cone do E3 Admin na rea de Notificaes do Windows e selecione
a opo Impressora. A seguinte janela ser mostrada:
E3 Server - Impressora
Opes disponveis na janela Impressora
OPO DESCRIO
Nome da impressora Lista o nome das impressoras disponveis.
Padro Permite selecionar esta impressora como

padro.
Configurar Abre a janela de propriedades da impressora

selecionada.
Procurar Permite escolher outra impressora na rede e

estabelecer uma conexo.
3.10.7 Sobre o E3 Admin

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

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

A configurao de Domnios Remotos define que haver comunicao entre diferentes
servidores e Viewers, onde uma aplicao ser destinada a fornecer dados, e a outra a
receb-los. O Domnio que fornece dados a outro chamado de Domnio Servidor; j o
Domnio que utiliza estes dados chamado de Domnio Cliente. A configurao de um
Domnio como Domnio Cliente no impede que ele seja ao mesmo tempo um Domnio
Servidor, e vice-versa. Domnios Remotos no esto disponveis em modo Demo.
132 Domnios
3.11.1 Configurao da Conexo
A configurao das conexes com outros Domnios do E3 deve ser feita no Domnio Cliente,
atravs da aba Domnios Remotos nas opes do Domnio (rea de Notificaes do Windows).
Domnios Remotos
Neste caso, o Domnio referenciado pela configurao o Domnio Servidor. possvel

tambm que os Domnios se referenciem entre si, sendo ao mesmo tempo servidores e
clientes de Domnios Remotos. Para configurar o uso de um Domnio Remoto, siga estes
procedimentos:
1. Informe um apelido para o Domnio Remoto no campo Nome do Domnio. Este campo no
sensvel a maisculas ou minsculas. Este nome ser usado na aplicao para referenciar
os objetos a serem acessados no Domnio Remoto.
2. Especifique o caminho do arquivo .dom do Domnio Remoto. Este caminho deve ser um
compartilhamento na rede que permita acessar este arquivo .dom.
3. Informe o nome do servidor principal, que deve ser o servidor contendo o Domnio Remoto
especificado no caminho do arquivo .dom. Esta configurao utilizada para encontrar os
objetos do Domnio Remoto em tempo de execuo.
Domnios 133
O item Servidores e Opes de Conexo contm um boto Avanado, que permite realizar
configuraes especficas da conexo entre os Domnios, atravs da janela mostrada na
figura a seguir.
Opes avanadas de conexo
As opes desta janela so descritas na tabela a seguir.
Opes avanadas de conexo
OPO DESCRIO
Tempo limite de conexo (ms) Esta opo controla o tempo mximo que o
Domnio Remoto Cliente espera para
estabelecer uma conexo REC com o E3
Server do Domnio Servidor. Sua finalidade
a mesma da chave ConnectionTimeout,
configurvel pelo E3 Tweak. O valor padro
desta opo 2000 ms.
Verificar PING Esta opo permite que, atravs de um

pedido de echo do protocolo ICMP, o Domnio
Remoto verifique se o Servidor responde
dentro de um tempo limite (timeout). Se no
houver resposta, por qualquer motivo,
considera-se que o computador est fora da
rede, ou desligado. Essa verificao, se
habilitada, ocorre antes da conexo
(evitando a tentativa de conectar em um
computador indisponvel) e enquanto a
conexo estiver ativa (forando a
desconexo imediata).
Tempo limite de PING (ms) O valor, em milissegundos, para a verificao

do ping. O valor padro desta opo 2000
ms.
134 Domnios
OPO DESCRIO
Utilizar heartbeat na conexo Esta opo permite que, atravs de um
mecanismo do protocolo REC, o Domnio
Remoto Cliente verifique se o Servidor est
mantendo a conexo ativa, esperando que
sejam enviadas mensagens de heartbeat
peridicas, mesmo que no haja nenhuma
outra comunicao a ser feita. Se for
excedido o dobro do tempo de heartbeat
configurado, sem que o Cliente receba uma
mensagem qualquer do computador
Servidor, considera-se que o Servidor falhou
ou est fora da rede, sendo forada uma
desconexo imediata.
Perodo de heartbeat (ms) O valor, em milissegundos, do perodo de

heartbeat. O valor padro desta opo
2000 ms.
Utilizar criao assncrona de links Se esta opo for marcada, os Links so

criados em paralelo entre os diversos
Domnios e o resultado da operao vem
assincronamente, medida que cada
Servidor responder. A vantagem desta opo
no trancar o tratamento de Links geral do
E3 Server. Apenas operaes daquele
mesmo Domnio podem ficar trancadas, caso
a criao de Links demore muito (o que pode
ocorrer em redes lentas). NOTA: Esta opo
no est disponvel para verses anteriores
3.2, e as aplicaces desenvolvidas em
verses anteriores falharo com o cdigo de
erro 8004F108 (verso incompatvel do REC).
O valor padro desta opo desmarcada,
que corresponde ao comportamento das
verses anteriores verso 3.2.
NOTA: Desmarcar simultaneamente as opes Verificar PING e Utilizar heartbeat na conexo

torna a deteco de queda da conexo extremamente lenta, caso o Servidor falhe.
Recomenda-se que as duas opes estejam sempre marcadas.
No E3 Studio, o caminho completo do compartilhamento usado para que seja possvel

determinar os objetos existentes no Domnio Remoto. O nome do arquivo .dom (sem o
caminho) usado para verificar se a conexo remota est sendo feita com o Domnio correto,
em tempo de execuo. Assim, se o nome do Domnio carregado no E3 Server remoto no for o
correto, a conexo no ser completada e os objetos remotos no ficaro acessveis.
Outra possibilidade manter uma cpia do Domnio Remoto na mquina Cliente, e colocar o
Domnios 135
caminho da cpia no campo Arquivo de Domnio. Dessa forma, o E3 Studio vai utilizar a cpia
local para determinar quais objetos existem, permitindo o trabalho offline. A cpia deve
obrigatoriamente ter o mesmo nome do Domnio Remoto para que a conexo funcione, no
sendo necessrio possuir a mesma hierarquia de diretrios.
Alm disso, para que a conexo entre os Domnios possa ocorrer, todos os E3 Servers
envolvidos devero rodar a mesma verso do E3. No possvel, por exemplo, conectar-se a
um Domnio que esteja rodando a verso 2.5 do E3.
Para que um E3 Server aceite receber conexes de outros Domnios (isto , para que ele seja
um servidor de Domnios Remotos), no necessria nenhuma configurao especfica.
Aps a correta configurao destes itens, necessrio apenas rodar os E3 Servers para que as
conexes remotas sejam estabelecidas.
NOTA: Para maiores informaes sobre a configurao de Domnios Remotos, veja o item
Configuraes de Domnio - Domnios Remotos.
3.11.2 Licenas
Tanto o E3 Server rodando o Domnio Cliente, quanto o que roda o Domnio Servidor, devem
ter licenas especficas para Domnios Remotos.
Quando essa licena existe, o E3 Server Servidor passa a aceitar um nmero ilimitado de
conexes externas de outros Domnios. Da mesma forma, no caso do E3 Server Cliente, ser
possvel estabelecer um nmero ilimitado de conexes. Para maiores informaes sobre as
limitaes do modo Demo do E3, veja o tpico Limitaes do Modo Demonstrao.
3.11.3 Sintaxe dos Links

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

CAMINHO. Neste caso, aplicam-se as mesmas regras de nomes de objetos. Necessita de
colchetes o nome do Domnio que:
136 Domnios
Comea com um caractere que no seja uma letra (sem acentos nem "")
Possui um caractere qualquer que no seja uma letra (sem acentos nem ""), um algarismo
(0-9) ou o caractere de sublinhado
3.11.4 Permisses de Acesso

Assim como ocorre com o Viewer, o acesso aos objetos de um Domnio Remoto pode ser
limitado ao modo Somente Leitura. Quando isso ocorre, so aplicados os mesmo tipos de
limitaes de acesso que se aplicam ao Viewer Only. Porm, diferente do Viewer, nesse caso
o controle feito apenas por usurio e no por IP ou por licena. Para isso, usa-se a
configurao de usurios na permisso Acesso remoto de escrita ao Domnio, dentro do item
de segurana Domnio.
Permisses de usurio
Com isso, pode ser necessrio que a conexo com o Domnio Remoto especifique um
determinado usurio para poder ter acesso completo aos objetos do Domnio. Esse usurio
dever ser especificado no campo Usurio no Domnio atravs da opo Utilizar a seguinte
conta, na aba Domnios Remotos da configurao do Domnio Cliente. Ali devem ser
especificados o login e senha de um usurio existente no Domnio sendo acessado
remotamente.
Alm do acesso em modo Somente Leitura, possvel bloquear completamente o acesso
Domnios 137
remoto, o que exige que a conexo com o Domnio Remoto especifique um determinado
usurio para poder ganhar acesso aos objetos remotos. Isso feito atravs da permisso
Acesso remoto ao Domnio, tambm do item de segurana Domnio.
NOTA: A permisso Acesso remoto ao Domnio sempre ter precedncia sobre a permisso
Acesso remoto de escrita ao Domnio. Isto significa que quando a primeira permisso for
negada, a segunda no ser efetivada mesmo quando explicitamente permitida. No
havendo nenhuma permisso de acesso configurada, qualquer Domnio pode se conectar
remotamente a outro, utilizando um usurio annimo.
3.11.5 Hot-Standby
A conexo remota ao Domnio suporta Domnios com Hot-Standby nativamente. Para isso,
basta apenas especificar os nomes dos dois servidores (principal e backup) nos itens
respectivos da rea Identificao dos servidores na rede, da aba de configurao dos Domnios
Remotos. importante ressaltar que, para o correto funcionamento do Hot-Standby, esses
nomes devem ser os mesmos especificados pelo Domnio Remoto acessado. Uma vez que
haja essa configurao em tempo de execuo, o E3 Server sempre tentar conectar-se aos
dois servidores, direcionando o acesso de todos os comandos Application.GetObject e Links
para o primeiro servidor que possa ser acessado e que indique estar rodando o Domnio. Caso
os nomes dos servidores sejam modificados quando o Domnio Cliente estiver em execuo,
este ir desconectar-se e reiniciar a conexo com os novos servidores.
3.11.6 Gerenciamento da Conexo

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

comunicao das conexes de Domnios Remotos podem ser visualizadas na janela de
Estatsticas do E3 Server, acessveis atravs do cone do E3 Admin na rea de Notificaes do
Windows.
3.11.7 Desconexo
O Domnio Cliente pode no conseguir estabelecer a conexo com o Domnio Servidor por uma
srie de motivos. Entre eles esto:
O computador do Cliente ou do Servidor est fora da rede
O Servidor no est rodando o E3 Server
138 Domnios
O E3 Server do Servidor no est com o Domnio correto, ou o Domnio no foi iniciado
O Domnio Servidor no aceita o usurio especificado pelo Domnio Cliente
O E3 Server do Cliente ou do Servidor no possui licena de Domnio Remoto
O E3 Server do Servidor de uma verso antiga (2.5 ou inferior)
Existe um firewall bloqueando a porta utilizada pelo REC, ou o Cliente e o Servidor esto
usando portas diferentes
O apelido do Domnio no existe na configurao de Domnio Remoto
Quando uma dessas situaes ocorrer, todos os Links do Cliente referenciando o Domnio
ficaro desconectados, assim como todos os comandos de Application.GetObject
referenciando o Domnio Remoto iro falhar (ou seja, causaro erros de script). Quando o
problema for resolvido, os Links devero conectar-se automaticamente. J os comandos de
Application.GetObject devero ser re-executados.
3.12 Gerando Logs no E3

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

(Controladores Lgicos Programveis), UTRs (Unidades Terminais Remotas), ou qualquer
outro tipo de equipamento, atravs de Drivers de Comunicao prprios ou Servidores OPC,
de acordo com o tipo do equipamento ou tipo de comunicao necessria.
NOTA: Os objetos de Drivers (Driver de Comunicao, Pasta de Comunicao, Tag de

Comunicao, Bloco de Comunicao, Elemento de Bloco, Driver de Comunicao OPC,
Grupo de Tags OPC, Pasta OPC, Tag de Comunicao OPC, Bloco de Comunicao OPC e
Elemento de Bloco OPC) podem ser configurados para funcionarem como reas de Alarme.
4.1 Driver de Comunicao

O Driver de Comunicao o mdulo do E3 que possibilita a comunicao com um
determinado equipamento usando arquivos .dll. Estes drivers so desenvolvidos pela Elipse
Software, bem como por terceiros, a partir de um DDK (Driver Development Kit), fornecido pela
Elipse, em linguagem C/C++. Cada driver implementa uma famlia de equipamentos ou
protocolos diferentes de acordo com o tipo de equipamento ou protocolo de comunicao.
Novos drivers so costumeiramente desenvolvidos pela Elipse Software.
Para inserir um Driver de Comunicao no projeto, clique com o boto direito do mouse no
nome do projeto no Explorer e selecione a opo Inserir - Driver de Comunicao. No modo
Domnio, clique com o boto direito do mouse no item Objetos de Servidor - Drivers e OPC,
selecione a opo Inserir Driver de Comunicao em e logo aps o nome do projeto desejado.
140 Drivers
Inserindo um Driver de Comunicao no modo Domnio
aberta a janela para localizao do Driver:
Localizar Driver
Se for selecionado um Driver vlido, o sistema exibir sua janela prpria de configurao.
Logo em seguida, ser aberta a janela de importao de Tags (se disponvel).
Ao inserir um Driver em uma aplicao do E3 Studio, aberta a view do objeto, conforme a
Drivers 141
figura a seguir.
View do Driver de Comunicao
Opes disponveis na view do Driver de Comunicao
OPO CONE DESCRIO

Adicionar Adiciona uma nova pasta, um
novo Tag ou um novo Bloco de
Comunicao ao Driver; um
novo Tag ou um novo Bloco de
Comunicao a uma Pasta;
ou um novo Elemento de
Comunicao a um Bloco.
Remover Remove o item selecionado

na view.
Configurar o driver Abre a janela de

configuraes extras do
Driver.
Tag Browser Abre uma janela que permite

importar Tags diretamente
do Driver.
Ativar/desativar comunicao Ativa ou desativa a

comunicao do Driver.
142 Drivers
OPO CONE DESCRIO
Contagem de tags Apresenta o nmero total de
Tags de Comunicao no
Driver.
4.1.1 Configurao dos Drivers de Comunicao

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

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

Ao configurar um Driver de Comunicao, o usurio pode realizar um procedimento de teste a
fim de verificar se os valores esto corretos e sendo atualizados sem problemas. Ao clicar no
Driver de Comunicao, aberta a opo Ativar Comunicao.
Desta forma, o Driver de Comunicao especificado ser carregado e os valores das variveis
podero ser visualizados no campo Valor de cada Tag na view de edio. Caso algum dos Tags
Drivers 143
possua a propriedade AllowRead em Falso, ou ainda se o Tag no possuir um valor a ser
reportado, esta linha aparecer com a cor cinza.
Caso o Tag apresente erro de comunicao, a linha se tornar vermelha, e caso a

comunicao esteja sem problemas, a linha ter a cor azul. Para interromper o
monitoramento, clique com o boto direito do mouse sobre o Driver de Comunicao
novamente e escolha a opo Desativar Comunicao.
4.1.2 Funcionamento dos Drivers de Comunicao

O IOServer o mdulo do E3 responsvel pela comunicao com o equipamento. no
processo do IOServer que carregada a .dll do Driver e efetuada a comunicao com o
equipamento.
Os Tags de Comunicao possibilitam a leitura ou escrita de um conjunto de valores,

utilizando o Driver de Comunicao onde eles esto inseridos. Podem ser utilizados tambm
os Blocos de Comunicao para a leitura simultnea de mais de uma varivel. Para acessar
cada valor do Bloco utilize o Elemento de Bloco, que pode ser includo dentro do objeto. Estes
objetos sero discutidos nas sees seguintes.
Em tempo de execuo, o E3 cria um IOServer para cada Driver de Comunicao. Baseado no

tempo de varredura (propriedade Scan) de cada Tag, o Driver ir requisitar periodicamente o
valor de cada um. Sempre que o valor ou a qualidade do Tag for alterado, seu valor ser
repassado para o Driver de Comunicao.
A verificao do tempo de ciclo de cada varivel feita de forma sequencial. Caso o ciclo de
uma varivel esteja vencido, o IOServer prosseguir com o questionamento de seu valor,
passando para a prxima varivel at que a verificao de toda a planilha esteja completa,
para ento retornar ao topo para uma nova varredura.
Pode-se reservar um tempo de ciclo menor para as variveis com necessidade de atualizao
mais veloz, e um tempo de ciclo maior para as variveis sem tanta prioridade de atualizao.
Deve-se ressaltar, entretanto, que a performance da comunicao depende de uma srie de
fatores, incluindo o tipo de equipamento, o tipo de interface da comunicao utilizada,
velocidade (baud rate), taxa de erros, etc.
Sempre que o E3 enviar uma solicitao de atribuio de valores para uma ou mais variveis,
esta solicitao ser executada com prioridade em relao varredura dos Tags.
No caso de falha de um IOServer, o E3 automaticamente realizar uma reinicializao daquele

mdulo, de forma a normalizar seu funcionamento. Por outro lado, o IOServer ir interromper
seu funcionamento caso no exista nenhum E3 Runtime (Principal ou Standby) para receber
seu dados.
Atravs da propriedade ShareServer, possvel compartilhar o mesmo IOServer entre vrios

Drivers de Comunicao. O primeiro Driver a ser executado ser o responsvel por iniciar os
procedimentos de comunicao, como abrir uma porta serial ou iniciar uma interface de
comunicao. Os prximos Drivers de Comunicao compartilhados utilizaro o mesmo
IOServer aberto pelo primeiro, o que permite o compartilhamento das interfaces de
comunicao utilizadas pelo Driver.
Isto pode ser vantajoso, j que muitos dos dispositivos de comunicao, como modems,
144 Drivers
portas seriais e outras interfaces, permitem apenas uma conexo, o que impediria a
utilizao simultnea por mais de um Driver. Com o compartilhamento pode-se reutilizar a
mesma conexo para mais de um objeto. Deve-se ressaltar que as configuraes dos Drivers
compartilhados devem ser as mesmas para que o compartilhamento de Drivers funcione
corretamente.
Quando o Domnio est em execuo, temos acesso interface de execuo do Driver de

Comunicao denominado Gerenciador de Drivers.
Acesso ao Gerenciador de Drivers
O Gerenciador de Drivers permite visualizar todos os Drivers em execuo, exibindo suas

propriedades.
Gerenciador de Drivers
Opes disponveis na janela Gerenciador de Drivers
OPO DESCRIO
Nome Informa o nome do Driver inserido no
sistema.
Objeto(s) Informa o nome do objeto Driver de

Comunicao associado ao Driver.
Drivers 145
OPO DESCRIO
Erros de leitura Mostra o total de leituras do Driver, a
quantidade de erros de leitura e percentual
de erros em relao ao total de leituras.
Erros de escrita Mostra o total de escritas do Driver, a

quantidade de erros de escrita e percentual
de erros em relao ao total de escritas.
Processo Mostra o identificador do processo do

IOServer no sistema operacional.
Estado Mostra o estado atual do Driver

(configurado, iniciando, rodando,
finalizando, finalizado ou em erro). Se o
Driver estiver em erro, mostra uma
descrio do erro.
Compartilhado Mostra as palavras SIM ou NO, informando

se o Driver est compartilhado ou no.
Log Mostra o status do log (habilitado ou

desabilitado).
Caminho Informa o caminho do Driver no sistema.
Boto Habilitar Log Habilita o log dos Drivers em tempo de

execuo, sem a necessidade de
reconfigurar o aplicativo. Atravs do mesmo
boto podemos interromper este
procedimento de gravao.
Boto Atualizar Fora a atualizao dos dados exibidos.
4.1.2.1 Utilizao de Estampa de Tempo

Alguns equipamentos e protocolos permitem o envio de informaes de tempo juntamente
com os valores das variveis. Os Drivers de Comunicao para tais equipamentos podem, a
cada varivel consultada, retornar tambm a informao deste relgio que fica armazenada
na propriedade TimeStamp de cada Tag, com resoluo de 1ms.
Quando o equipamento no suporta este tipo de informao, ou quando o Driver no est

preparado para tal, o Driver de Comunicao insere na estampa de tempo o valor de data e
hora atual, a partir do relgio do computador. De posse da estampa de tempo, o E3 ir utilizar
esta informao tanto para a verificao e gravao de alarmes quanto para a gerao de
arquivos histricos.
No caso dos Tags serem Elementos de Bloco, informada a mesma estampa de tempo para
todos os Elementos do Bloco, j que foram consultadas no mesmo instante de tempo. No caso
do Driver suportar leituras de variveis tanto como Bloco quanto como Tag de Comunicao,
caso os Elementos possam representar eventos distintos, deve-se preferir o uso de Tags de
Comunicao.
146 Drivers
Para obter mais informaes sobre quais equipamentos possuem esta caracterstica, entre
em contato com o fabricante. Para saber quais Drivers ou tipos de variveis dentro dos
equipamentos utilizam a estampa de tempo, consulte a ajuda dos Drivers ou diretamente o
suporte tcnico da Elipse Software.
4.1.2.2 Lista de Valores

Alm do envio da estampa de tempo, os Drivers de Comunicao tambm suportam o envio
de listas de valores para os Tags. As listas so uma sequncia de valores para um mesmo Tag
de Comunicao ou Bloco de Comunicao, que so informadas numa mesma leitura.
Alguns exemplos de utilizao para a lista de valores so a coleta de variaes rpidas de um

Tag digital, por exemplo, atravs da utilizao de SOE (Sequence of Events - Sequncia de Eventos
), que esto armazenadas em um equipamento tipo PLC ou RTU (Remote Terminal Unit) ou
ainda na leitura de tabelas de dados onde esto armazenados dados de telemetria, como nos
exemplos a seguir:
Exemplo de lista de valores
Na primeira tabela, temos uma sequncia de valores para o campo A, associada a um

instante de tempo representando uma leitura SOE. Neste caso, o ideal realizar a leitura
atravs de um Tag de Comunicao, que trar toda a tabela em uma nica leitura, sendo que
os valores do campo A estaro no prprio Tag e o campo Time estar na propriedade
TimeStamp.
J na segunda tabela, temos uma representao tpica de coleta de dados de telemetria,

onde para cada instante de tempo existem vrias colunas representando vrios valores
coletados naquele determinado instante. Para a leitura desses valores, o ideal utilizar um
Bloco de Comunicao que trar toda a tabela em uma nica leitura, sendo que os valores do
campo Time estaro associados propriedade TimeStamp do Bloco; os valores do campo A
estaro associados a um Elemento do Bloco, o campo B a outro Elemento, e assim por diante.
4.1.3 Pasta de Comunicao

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

O Tag de Comunicao possibilita a leitura ou a escrita de um conjunto de valores utilizando o
Driver de Comunicao. utilizado para definir a troca de informaes com os equipamentos
de aquisio, que consistem em uma nica varivel independente.
O Tag de Comunicao pode ser uma varivel analgica, de entrada, de sada, contador,
ponto digital, etc. Vrios pontos digitais podem ser agrupados no Tag e serem acessados
atravs de suas propriedades, como bits de dados. Os Tags de Comunicao so configurados
atravs de uma srie de parmetros N (N1 a N4), que variam de acordo com o Driver de
Comunicao a ser utilizado.
Para utilizar este recurso, siga estes procedimentos:
1. Insira o Tag de Comunicao no projeto, clicando com o boto direito do mouse no Driver e
selecionando a opo Inserir - Tag de Comunicao.
148 Drivers
Inserindo um Tag de Comunicao
2. O sistema abre uma janela perguntando quantos Tags sero criados no Driver, e qual seu
nome. Este nome ser auto-incrementado; se a opo for deixada em branco, os Tags sero
criados com o nome padro.
Inserindo Tags de Comunicao
Drivers 149
Caso o equipamento sendo utilizado para coletar os dados informe valores de Tags que
precisam ser convertidos, pode-se utilizar as escalas dos Tags, que so basicamente uma
especificao de uma converso linear entre duas bases diferentes.
Para isto, deve-se habilitar a propriedade EnableScaling do Tag e informar os parmetros

DeviceLow e DeviceHigh (atravs das respectivas propriedades), que seriam os limites inferior
e superior do dado vindo do equipamento, alm de informar os parmetros EULow e EUHigh
(atravs das respectivas propriedades) que so os limites inferior e superior do dado, j em
unidades de engenharia.
Algumas das propriedades deste objeto podem ser configuradas diretamente na Lista de
Propriedades, sem a necessidade de criar scripts para isto. Demais informaes sobre as
funcionalidades das propriedades deste objeto podem ser encontradas no Manual de
Referncia de Scripts do E3, em seu captulo respectivo.
4.1.5 Bloco de Comunicao

O Bloco de Comunicao utilizado para definir a troca de informaes com os equipamentos
de aquisio, que consistem de uma ou mais variveis, desde que seja consecutivo no
endereamento dentro do dispositivo externo.
Dependendo do mtodo de comunicao utilizado, podem economizar tempo de

comunicao, obtendo um nmero maior de atualizaes num mesmo intervalo de tempo se
comparado com o Tag de Comunicao. Os Blocos de Comunicao so configurados atravs
de uma srie de parmetros B (B1 a B4) que variam de acordo com o Driver de Comunicao a
ser utilizado, alm da propriedade Size, que define o nmero de Elementos ou ndices
disponveis no Bloco. Para utilizar este recurso, siga estes procedimentos:
1. Clique com o boto direito do mouse no Driver e escolha a opo Inserir - Bloco de
Comunicao.
150 Drivers
Inserindo um Bloco de Comunicao
2. O sistema abre uma janela perguntando quantos Blocos sero criados no Driver, e qual seu
nome. Este nome ser auto-incrementado; se a opo for deixada em branco, os Blocos
sero criados com o nome padro.
Inserindo Blocos de
Comunicao
3. O sistema mostrar uma caixa de dilogo para determinar o nmero de Elementos de Bloco
neste objeto. Nesta opo possvel indicar o mapeamento de todos os Elementos de
Drivers 151
Bloco ou somente num determinado intervalo de Elementos.
Configurando o Bloco de Comunicao
4. Informe o tamanho do Bloco e a opo de mapeamento.
5. Clique em OK.
6. Caso necessite, configure as propriedades do objeto.
Algumas das propriedades do Bloco de Comunicao podem ser configuradas atravs da Lista
de Propriedades, sem a necessidade de criar scripts para isto. Caso necessite configurar
alguma propriedade, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes.
Para maiores informaes, consulte o Manual de Referncia de Scripts do E3.
4.1.6 Elementos de Bloco

Os Elementos de Bloco representam as associaes de cada uma das posies no Bloco, de
forma a serem utilizados como se fossem Tags de Comunicao. Os Elementos de Bloco
podem apontar livremente para cada ndice dentro de um Bloco. Podem existir dois
Elementos de Bloco apontando para o mesmo ndice do Bloco, e tambm um nmero menor,
igual ou maior de Elementos do que o nmero de variveis declaradas no Bloco. Para utilizar
este recurso, siga este procedimento:
1. Clique com o boto direito do mouse no Bloco de Comunicao e escolha a opo Inserir -
Elemento de Comunicao.
152 Drivers
Inserindo um Elemento de Bloco
Caso o equipamento sendo utilizado para coletar os dados informe valores de Elementos que
precisam ser convertidos, pode-se utilizar as escalas dos Elementos, que so basicamente
uma especificao de uma converso linear entre duas bases diferentes.
Para isto, deve-se habilitar a propriedade EnableScaling do Elemento e informar os

parmetros DeviceLow e DeviceHigh (atravs das respectivas propriedades), que seriam os
limites inferior e superior do dado vindo do equipamento, alm dos parmetros EULow e
EUHigh (atravs das respectivas propriedades) que so os limites inferior e superior do dado
j em unidades de engenharia.
Algumas das propriedades do Elemento de Bloco podem ser configuradas atravs da Lista de
Propriedades, sem a necessidade de criar scripts para isto. Caso necessite configurar alguma
propriedade, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes. Para
maiores informaes, consulte o Manual de Referncia de Scripts do E3.
Drivers 153
4.2 Servidor OPC
Alm de possuir um cliente OPC (Driver OPC), o E3 funciona tambm como Servidor OPC DA (
Data Access) 2.0x. Isso permite ao E3 expor todos os objetos existentes no Domnio em
execuo (Tags de Comunicao, por exemplo) para softwares externos ao E3. Como exemplos,
pode-se citar o Elipse SCADA, o E3 (que pode estar rodando em outra aplicao como cliente),
ou um cliente OPC de outro fabricante, basta que o cliente implemente o padro OPC DA 2.0x
ou superior.
NOTA: O Servidor OPC no E3 um mdulo adicional a partir da verso 3.0, e necessita de

licena especfica no dispositivo de proteo. Entre em contato com a Elipse para maiores
informaes.
4.2.1 Caractersticas
Para usar o Servidor OPC do E3 no necessria nenhuma configurao extra, bastando
executar o Domnio para que qualquer cliente OPC possa se comunicar com o E3. Para
conectar-se ao servidor OPC do E3 de um cliente qualquer, basta selecionar o servidor
identificado como Elipse.OPCSvr.1.
O Servidor OPC permite que qualquer cliente importe facilmente toda a definio de Tags
existentes no Domnio (funo Browse). Naturalmente, os Tags fornecidos so apenas os
objetos que fazem parte do servidor, ou seja, itens de Tela (Viewer) no so acessveis pelo
Servidor OPC.
Sendo baseado na mesma tecnologia de associaes usada nas associaes internas entre
objetos, o Servidor OPC do E3 permite que clientes usem Tags que sejam expresses
matemticas, e com o recurso de conexo e desconexo transparente durante a execuo.
4.2.2 Informaes de Status

Atravs da informao de status (funcionalidade padro do OPC), o cliente OPC pode
identificar se o servidor do E3 encontra-se sem Domnio, em standby ou rodando
normalmente. O status do OPC pode ser:
Domnio rodando normalmente: OPC_STATUS_RUNNING
Domnio em standby: OPC_STATUS_SUSPENDED
Domnio parado ou sem Domnio: OPC_STATUS_NOCONFIG
4.2.3 Desconexo
Para os clientes OPC que suportam o mecanismo de desligamento (shutdown), sempre
enviado um aviso quando o Domnio parado ou entra em standby. Aps o aviso, todos os
clientes so desconectados.
154 Drivers
4.3 Driver de Comunicao OPC
O Driver de Comunicao OPC o mdulo responsvel por coletar dados de equipamentos
externos atravs da execuo de um Servidor OPC, que pode ser fornecido por qualquer
empresa. Os Tags podem ser importados para o Driver OPC dentro do E3 (que neste caso atua
como um OPC Client) ou ainda podem ser criados a partir do E3. Para utilizar um Driver OPC,
siga estes procedimentos:
1. Clique com o boto direito do mouse sobre o nome do projeto, e selecione a opo Inserir -
Driver de Comunicao OPC.
Inserindo um Driver OPC
Ao inserir um Driver OPC em uma aplicao do E3 Studio, aberta a view do objeto, conforme
a figura a seguir.
Drivers 155
View do Driver de Comunicao OPC
Opes disponveis na view do Driver OPC
OPO CONE DESCRIO

Adicionar Adiciona um Grupo ao Driver;
um Tag, um Bloco ou uma
Pasta ao Grupo; ou um
Elemento ao Bloco.
Remover Remove o item selecionado

na view.
Selecionar servidor Seleciona o Servidor OPC.
Ativar/desativar comunicao Ativa e desativa a

comunicao do Driver.
Importar tags Importa Tags para o Driver

OPC.
Informaes sobre o servidor Mostra uma janela com as

configuraes do Driver.
Contagem de tags Apresenta o nmero total de

Tags de Comunicao no
Driver.
156 Drivers
4.3.1 Configurao dos Drivers OPC
A identificao dos outros objetos pertencentes ao Driver OPC pode ser inserida
manualmente, ou ento ser trazida automaticamente do Servidor OPC. Para isso, acesse as
propriedades do Driver clicando com o boto direito do mouse, e escolhendo a aba OPC Driver
.
Configuraes do Driver OPC
Informe o Endereo e ID do Servidor e clique no boto Selecionar. A seguinte janela ser

mostrada:
Drivers 157
Seleo do Servidor OPC
As opes disponveis neste item so as seguintes:
Opes disponveis na janela Servidores OPC
OPO DESCRIO
Tentar enumerador padro ou registro O E3 ir tentar procurar as especificaes do
(recomendado) Driver, tanto pelo Registro do Windows
quanto pelo enumerador padro OPC
(OPCENUM).
Tentar apenas enumerador padro (servio O E3 ir tentar procurar as especificaes do

OPCENUM) Driver apenas pelo enumerador padro OPC
(OPCENUM).
Tentar apenas registros no sistema O E3 ir tentar procurar as especificaes do

Driver apenas pelos registros no Window.
Clicando em OK, o sistema mostrar os dados do Driver, indicando os caminhos e o nome do

servidor. Para ativar a comunicao do Driver OPC clique na opo Ativar Comunicao:
158 Drivers
Ativar comunicao do Driver OPC
Quando a comunicao ativada, so habilitadas as opes Informaes sobre o servidor e

Importar tags, alm da opo Desativar Comunicao. Para acessar estas opes, basta clicar
com o boto direito do mouse sobre o Driver OPC e escolher a opo desejada.
Drivers 159
Opes habilitadas quando o Driver OPC est ativo
A opo Informaes sobre o servidor mostra uma janela com as configuraes do Driver.
160 Drivers
Informaes do Servidor OPC
Atravs da opo Importar tags, possvel importar Tags para o Driver OPC. Quando esta
opo selecionada, a seguinte mensagem mostrada:
Mensagem referente importao de Tags OPC
As opes so as seguintes:
SIM: O E3, ao fazer a localizao dos Tags OPC, ir tentar automaticamente detectar quais
Tags so do tipo Bloco e, neste caso, qual o nmero de Elementos. Para fazer isto, o E3
precisa ler o valor de cada um, o que dependendo do servidor e do nmero de Tags, pode
ser demorado
NO: O E3 no ir ler os valores dos Tags OPC ao fazer a operao de procura. Essa
operao mais rpida, porm no ir criar automaticamente Tags OPC de tipo Bloco e
seus Elementos
CANCELAR: Cancela a importao
A janela de importao dispe dos seguintes recursos:
Drivers 161
Importao de Tags OPC
Opes disponveis na janela Importao de Tags OPC
OPES DESCRIO
Nome dos Itens Filtra os tags a partir do nome dos itens
especificados. Podem ser utilizados
caracteres curingas, tais como * ou ?.
Tipo de dados Filtra os tags a partir do tipo de dado

especificado no campo. Estes dados podem
ser do tipo Integer, Long, Single, etc.
Tipo de acesso Filtra os tags a partir do tipo de acesso

especificado no campo. Estes acessos
podem ser: Leitura, Escrita ou Leitura e
Escrita.
Mostrar apenas itens com IDs no Filtra os tags para que o sistema mostre
encontrados no projeto apenas os itens com IDs no encontrados no
projeto.
Projeto corrente Mostra os objetos que foram selecionados

para adio no projeto corrente.
162 Drivers
OPES DESCRIO
Servidor OPC Mostra os tags disponveis no servidor para a
importao.
Para fazer a importao, basta selecionar o tag desejado e arrast-lo para o driver ou Grupo
OPC desejado. Para desativar a comunicao do Driver OPC, basta clicar na opo Desativar
Comunicao.
Algumas das propriedades do Driver OPC podem ser configuradas atravs da Lista de
4.3.2 Grupo de Tags OPC

O objeto Grupo OPC agrupa uma srie de Tags OPC que compartilham os mesmos parmetros
de atualizao (tempo de varredura e banda morta). sempre necessrio existir um Grupo
OPC para poder criar Tags OPC. Para inserir um Grupo OPC, siga este procedimento:
1. Clique com o boto direto do mouse sobre o Driver OPC e selecione a opo Inserir - Grupo
de tags OPC.
Drivers 163
Inserindo um Grupo de Tags OPC
Algumas das propriedades do Grupo OPC podem ser configuradas atravs da Lista de
4.3.3 Pasta OPC

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

O Tag OPC um objeto para leitura ou escrita de valores em um equipamento. A leitura do Tag
feita automaticamente pelo Servidor OPC, com tempo de varredura definido no Grupo OPC
no qual ele est inserido. Para utilizar este recurso, siga estes procedimentos:
1. Clique com o boto direito do mouse sobre o Grupo OPC e selecione a opo Inserir - Tag de
Comunicao OPC.
Drivers 165
Inserindo um Tag de Comunicao OPC
2. O sistema abre uma janela perguntando quantos Tags sero criados no Grupo, e qual seu
nome. Este nome ser auto-incrementado; se a opo for deixada em branco, os Tags sero
criados com o nome padro.
Inserindo Tags de Comunicao

OPC
Algumas das propriedades do Tag OPC podem ser configuradas atravs da Lista de
166 Drivers
4.3.5 Bloco de Comunicao OPC
O objeto Bloco de Comunicao OPC possibilita a leitura ou escrita de um conjunto de valores.
Para fazer uma escrita, deve-se apenas atribuir um novo valor propriedade Value. A leitura
do Tag feita automaticamente pelo Servidor OPC com tempo de varredura definido no Grupo
OPC. A propriedade Size determina o nmero de Elementos do Tag no servidor. Para utilizar
este recurso, siga estes procedimentos:
1. Clique com o boto direito do mouse sobre o Grupo OPC e selecione a opo Inserir - Bloco
de Comunicao OPC.
Inserindo um Bloco de Comunicao OPC
2. O sistema abre uma janela perguntando quantos Blocos sero criados no Grupo, e qual seu
nome. Este nome ser auto-incrementado; se a opo for deixada em branco, os Blocos
sero criados com o nome padro.
Drivers 167
Inserindo Blocos de
Comunicao OPC
3. O sistema mostrar uma caixa de dilogo para determinar o nmero de Elementos de Bloco
neste objeto. Nesta opo possvel indicar o mapeamento de todos os Elementos de
Bloco ou somente de um determinado intervalo de Elementos.
Configurando o Bloco de Comunicao
4. Informe o tamanho do Bloco e a opo de mapeamento.
5. Clique em OK.
6. Caso necessite, configure as propriedades do objeto.
Algumas das propriedades do Bloco de Comunicao OPC podem ser configuradas atravs da
Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso necessite configurar
4.3.6 Elemento de Bloco OPC

O objeto Elemento de Bloco OPC possibilita a leitura ou escrita de um dos Elementos do Bloco
OPC onde ele est inserido.
O Bloco OPC l uma tabela de dados, e este objeto estar sempre associado posio
definida por sua propriedade Index. Por exemplo, um Elemento de Bloco OPC com Index igual a
5 e inserido em um Bloco OPC com tamanho 10, cujos dados lidos sejam os seguintes:
168 Drivers
Tabela 5 12 77 55 1 3 42 20 8 89
ndice 0 1 2 3 4 5 6 7 8 9
Teria sua propriedade Value igual a 3, segundo a tabela acima.
NOTA: O E3 pode criar automaticamente os elementos de Bloco OPC. Para maiores detalhes,
veja a opo Importar Tags, no tpico Configurao dos Drivers OPC.
Para utilizar este recurso, siga este procedimento:
1. Clique com o boto direito do mouse sobre o Bloco OPC e selecione a opo Inserir -
Elemento de Bloco OPC.
Drivers 169
Inserindo um Elemento de Bloco OPC
Algumas das propriedades do Elemento de Bloco OPC podem ser configuradas atravs da Lista
de Propriedades, sem a necessidade de criar scripts para isto. Caso necessite configurar
4.4 Qualidade
Os campos de qualidade representam o estado da qualidade do valor do item. formado de
uma palavra de 16 bits, sendo que os primeiros 8 bits so definidos na forma de 3 campos de
bits: Campo Qualidade, Substatus e Limite.
Os outros 8 bits (de maior ordem) esto disponveis para uso de cada fabricante. Se esses bits
forem utilizados, os bits de qualidade padro ainda so utilizados para indicar quais
dedues pode-se fazer sobre os dados retornados. Assim, de responsabilidade do cliente
interpretar o campo de informaes especficas de qualidade, para garantir que o servidor
que est provendo essa informao usa as mesmas regras que o cliente.
170 Drivers
Opes disponveis no campo Qualidade
QUALIDADE CAMPO QUALIDADE DESCRIO

0 - 63 O valor no til pelas
Ruim razes indicadas no
substatus.
64 - 127 A qualidade do valor

Incerta incerta pelas razes
indicadas no substatus.
128 - 191 No usado pelo padro

(Reservado)
OPC.
192 - 255 Boa A qualidade do valor Boa.
Um servidor que no suporta informao de qualidade retorna 192 sempre (Bom). Tambm
aceitvel que um servidor retorne simplesmente Ruim ou Bom (0 ou 192) e sempre retorne 0
para o substatus e para o limite.
4.4.1 Campo Substatus

O layout deste campo depende do valor do campo Qualidade.
Substatus para Qualidade RUIM
SUBSTATUS DESCRIO LIMITE

Sem Limite Baixo Alto Constante
No O valor 0 1 2 3
especfico ruim, mas
nenhuma
razo
especifica
conhecida.
Erro de H algum 4 5 6 7
Configurao problema de
configurao
especfico no
servidor. Por
exemplo, o
item em
questo pode
ter sido
apagado.
Drivers 171
SUBSTATUS DESCRIO LIMITE
Sem Limite Baixo Alto Constante
No A entrada 8 9 10 11
Conectado deveria estar
logicamente
conec

Idioma

E3manual PTB

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

E3manual PTB

Enviado por

Direitos autorais:

Formatos disponíveis

Manual do Usurio do E3

2012 Elipse Software Ltda. Todos os direitos reservados.

Desenvolvido pela Elipse Software, o E3 uma poderosa plataforma para superviso e

Os sistemas construdos com o E3 geralmente partem da coleta de dados em tempo real de

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

As funes bsicas do software esto divididas em mdulos independentes, capazes de

Em linhas gerais, o E3 composto de um ncleo (kernel) responsvel por unir e coordenar o

O E3 possui quatro programas principais, descritos a seguir.

Isso leva a alguns problemas de gerenciamento, como aplicar mudanas a todos os

A estrutura do Domnio restrita aos servidores e afins, como as mquinas servidoras,

O E3 Viewer possui trs destaques especiais:

Os projetos da aplicao residem somente no servidor

A interface do cliente capaz de alternar de um servidor desligado ou com falha para o

Como alternativa ao uso do E3 Viewer na mquina cliente, possvel utilizar a tecnologia de

1.3 Diagrama de Blocos

Diagrama dos blocos que compem o E3

Detalhadamente, o E3 Server responsvel por criar um processo de execuo (E3 Runtime)

Depois da conexo, servidor e cliente trocam informaes e verificam a existncia de objetos

Do ponto de vista do cliente, o download comea na primeira tela (interface grfica),

1.5 Limitaes do Modo Demonstrao

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

No h acesso s configuraes do Domnio (menu contextual Domnio - Opes do cone do

Somente a primeira imagem de cada categoria da Galeria de Smbolos est disponvel

S permitida a abertura de um Viewer ou WebViewer

S permitida a gravao de no mximo 20 Tags de Comunicao em um objeto Storage

Permite acesso como OPC Server

No permitido utilizar a ferramenta de Importao e Exportao do E3 Studio

O E3 Studio o ambiente de desenvolvimento do E3. Nele, possvel a criao e manuteno

Caminho indicado pelo sistema quando o E3 instalado

Para iniciar uma aplicao no E3 Studio, siga estes procedimentos:

1. No momento da instalao, criado um grupo de programas no menu Iniciar do Windows.

2. O dispositivo de proteo dever estar conectado na porta de comunicao adequada, no

2.1 Iniciando um Projeto

Janela Iniciar o E3 Studio

As opes disponveis so as seguintes:

Opes disponveis na janela Iniciar o E3 Studio

Criar um Domnio novo Sero requisitados o nome e caminho do

Abrir um Domnio existente Ao clicar em Outros Arquivos, tem-se a opo

2.2 rea de Trabalho

rea de trabalho do E3 Studio

A rea de Trabalho onde as views so mostradas.

2.3 Configurao do E3 Studio

2.3.1 Aparncia do E3 Studio

As opes disponveis so as seguintes:

Opes disponveis na aba Comandos

Comandos Mostra os itens que compem o menu ou a

Descrio Breve descrio da opo selecionada.

As opes disponveis so as seguintes:

Opes disponveis na aba Barra de ferramentas

Boto Restaurar Restaura a barra de ferramentas desejada

Boto Restaurar tudo Restaura todas as barras de ferramentas no

Boto Nova Cria uma nova barra de ferramentas.

Boto Mudar o nome Muda o nome da barra de ferramentas. Esta

Boto Remover Remove a barra de ferramentas selecionada.

Mostrar legendas Mostra uma legenda nas opes da barra de

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

As opes disponveis so as seguintes: