Manual do Usurio do E3

Copyright 1999 - 2017 Elipse Software Ltda. Todos os direitos reservados.

Verso 4.8.239 (03/03/2017)
Sumrio
1 Introduo .......................................................................................................................... 1
1.1 Descrio Geral ........................................................................................................... 2
1.2 Arquitetura ................................................................................................................... 4
1.3 Diagrama de Blocos .................................................................................................. 8
1.4 Estrutura de Domnio ............................................................................................... 9
1.5 Limitaes do Modo Demonstrao ................................................................ 10
2 E3 Studio ........................................................................................................................... 11
2.1 Iniciando um Projeto ............................................................................................. 13
2.2 rea de Trabalho ..................................................................................................... 15
2.3 Configurao ............................................................................................................. 16
2.4 Barra de Ferramentas ............................................................................................ 32
2.5 Organizer .................................................................................................................... 65
2.6 Importao e Exportao ..................................................................................... 74
2.7 Lista de Propriedades .......................................................................................... 121
2.8 Galeria ........................................................................................................................ 124
2.9 AppBrowser ............................................................................................................. 125
2.10 Conectar A ............................................................................................................. 130
3 Domnios ......................................................................................................................... 134
3.1 E3 Server ................................................................................................................... 134
3.2 E3Run ......................................................................................................................... 136
3.3 E3 Admin .................................................................................................................. 137
3.4 IOServer .................................................................................................................... 139
3.5 E3 Studio .................................................................................................................. 139
3.6 E3 Viewer .................................................................................................................. 140
3.7 Componentes ......................................................................................................... 140
3.8 Criando um Domnio ........................................................................................... 141
3.9 Configuraes ......................................................................................................... 152
3.10 Outras Opes da rea de Notificao ...................................................... 192
3.11 Domnios Remotos ............................................................................................. 204
3.12 Gerando Logs no E3 .......................................................................................... 216
4 Drivers .............................................................................................................................. 217
4.1 Driver de Comunicao ....................................................................................... 218
4.2 Servidor OPC ........................................................................................................... 244
4.3 Driver de Comunicao OPC ............................................................................. 246
4.4 Driver de Comunicao OPC UA ..................................................................... 269

I
 4.5 Qualidade ................................................................................................................. 290
5 Quadros ........................................................................................................................... 301
6 Viewer ............................................................................................................................... 308
6.1 Configurao ........................................................................................................... 309
6.2 Variveis no Viewer .............................................................................................. 319
6.3 Objeto _top .............................................................................................................. 320
6.4 Pasta do Viewer ..................................................................................................... 321
7 Telas e Objetos de Tela .............................................................................................. 323
7.1 Tela ............................................................................................................................. 324
7.2 Objetos de Tela ...................................................................................................... 327
7.3 Configuraes Gerais ........................................................................................... 336
7.4 Formatao de Cores .......................................................................................... 361
7.5 Formatao de Valores ....................................................................................... 364
8 Associaes .................................................................................................................... 372
8.1 Simples ...................................................................................................................... 375
8.2 Bidirecional .............................................................................................................. 376
8.3 Digital ......................................................................................................................... 377
8.4 Analgica .................................................................................................................. 379
8.5 Por Tabela ................................................................................................................ 381
8.6 Reversa ...................................................................................................................... 383
8.7 Mltipla ..................................................................................................................... 384
8.8 Edio de Associaes ......................................................................................... 386
9 Bibliotecas ....................................................................................................................... 393
9.1 Galeria ........................................................................................................................ 395
9.2 Biblioteca do Usurio (ElipseX) ......................................................................... 397
9.3 Quando Criar um ElipseX ................................................................................... 418
10 ActiveX ........................................................................................................................... 419
10.1 Objetos Microsoft Forms ................................................................................. 423
10.2 Elipse KeyPad ....................................................................................................... 426
11 Servidor de Dados ..................................................................................................... 428
11.1 Impressora de Linha .......................................................................................... 430
11.2 Pasta de Dados .................................................................................................... 433
11.3 Tag Contador ....................................................................................................... 434
11.4 Tag Demo .............................................................................................................. 436
11.5 Tag Interno ........................................................................................................... 438
11.6 Tag Timer ............................................................................................................... 440
12 Banco de Dados ......................................................................................................... 442

II
 12.1 Access ...................................................................................................................... 444
12.2 Oracle ...................................................................................................................... 447
12.3 SQL Server ............................................................................................................. 455
12.4 Objetos do E3 e Permisses ........................................................................... 462
13 Alarmes ......................................................................................................................... 463
13.1 Configurao de Alarmes ................................................................................ 464
13.2 Filtro de Alarmes ................................................................................................. 470
13.3 Fontes de Alarme ............................................................................................... 479
13.4 Servidor de Alarmes .......................................................................................... 495
14 E3Alarm ......................................................................................................................... 513
14.1 Configuraes ...................................................................................................... 514
14.2 Caractersticas Especficas de Tempo de Execuo ................................ 532
15 Storage .......................................................................................................................... 540
15.1 Configuraes ...................................................................................................... 543
15.2 Configurao da Tabela .................................................................................... 546
16 Histrico ........................................................................................................................ 568
16.1 Configuraes ...................................................................................................... 571
17 Consultas ...................................................................................................................... 589
17.1 Criando uma Consulta ...................................................................................... 592
17.2 Uso dos Filtros da Consulta atravs de Scripts ....................................... 603
17.3 Uso de Recordsets de uma Consulta atravs de Scripts ..................... 603
18 E3Browser ..................................................................................................................... 604
18.1 Objeto Consulta no E3Browser ..................................................................... 606
18.2 Outras Configuraes ....................................................................................... 607
19 E3Chart .......................................................................................................................... 614
19.1 Configuraes ...................................................................................................... 615
19.2 Exemplos de Utilizao ..................................................................................... 661
19.3 Caractersticas Especficas de Runtime ....................................................... 666
20 E3Playback ................................................................................................................... 674
20.1 Objeto E3Playback .............................................................................................. 674
20.2 Adicionar Playback ao Demo do E3 ............................................................. 675
20.3 Interface de Usurio .......................................................................................... 680
20.4 Banco de Dados de Playback ......................................................................... 701
20.5 Configurao dos Objetos de Banco de Dados do E3 .......................... 706
21 Frmulas ....................................................................................................................... 712
21.1 Configuraes ...................................................................................................... 714
21.2 Templates .............................................................................................................. 717

III
 21.3 Unidades ................................................................................................................ 720
21.4 Conjunto de Valores .......................................................................................... 721
21.5 Criao de uma Frmula .................................................................................. 722
22 Relatrios ...................................................................................................................... 731
22.1 Objeto Consulta .................................................................................................. 732
22.2 Componentes ....................................................................................................... 733
22.3 Configuraes ...................................................................................................... 736
22.4 Criando um Relatrio no E3 ........................................................................... 759
22.5 Exemplos de Utilizao ..................................................................................... 762
23 Segurana ..................................................................................................................... 767
23.1 Usurios .................................................................................................................. 769
23.2 Grupos .................................................................................................................... 778
23.3 Permisses ............................................................................................................ 784
23.4 Proteo de Arquivos ....................................................................................... 792
24 E3 Viewer e E3 WebViewer ..................................................................................... 797
24.1 Viewer Only (Modo Somente Leitura) ......................................................... 799
24.2 Execuo do E3 Viewer ..................................................................................... 801
24.3 Logs do Viewer .................................................................................................... 807
24.4 Execuo do E3 WebViewer ............................................................................ 808
25 Hot-Standby ................................................................................................................ 816
25.1 Configurando ....................................................................................................... 818
25.2 Executando um Domnio Redundante ....................................................... 819
25.3 Parando um Domnio Redundante .............................................................. 820
25.4 Parando um dos Servidores do Domnio .................................................. 820
25.5 Tempo de Troca entre Servidores ................................................................ 820
25.6 Reconexo de Viewers ...................................................................................... 821
25.7 Utilizando Bancos de Dados com Hot-Standby ...................................... 822
26 Configuraes Avanadas ...................................................................................... 823
27 Dvidas mais Frequentes ....................................................................................... 824
27.1 Alarmes ................................................................................................................... 825
27.2 Associaes ........................................................................................................... 828
27.3 Bibliotecas .............................................................................................................. 830
27.4 Domnios e Projetos .......................................................................................... 832
27.5 Domnios Remotos ............................................................................................. 834
27.6 Drivers de Comunicao .................................................................................. 842
27.7 E3Alarm .................................................................................................................. 843
27.8 E3Browser .............................................................................................................. 843

IV
27.9 E3Chart ................................................................................................................... 844
27.10 Histrico ............................................................................................................... 844
27.11 Impressora de Linha ........................................................................................ 844
27.12 Objetos de Tela ................................................................................................. 845
27.13 Ordem dos Tabs ............................................................................................... 845
27.14 Relatrios ............................................................................................................. 846
27.15 Servidor de Banco de Dados Oracle .......................................................... 849
27.16 Servidor de Banco de Dados SQL Server ................................................. 852
27.17 Servidor de Dados ............................................................................................ 854
27.18 Sobreposio de Animaes nos Objetos .............................................. 855
27.19 Stored Procedure ............................................................................................. 856
27.20 Viewer ................................................................................................................... 857

V
CAPTULO
Introduo
1
Desenvolvido pela Elipse Software, o E3 uma poderosa plataforma para
superviso e controle de processos totalmente voltada operao em rede e
aplicaes distribudas. O E3 um sistema SCADA (Supervisory Control and
Data Acquisition) que oferece um avanado modelo de objetos, uma poderosa
interface grfica, alm de uma arquitetura que permite o rpido
desenvolvimento de aplicaes e mxima conectividade com dispositivos e
outros aplicativos. Sua concepo incorpora as mais novas tecnologias em
desenvolvimento de software, maximizando o desempenho, a produtividade e
a qualidade de suas aplicaes e do prprio processo, minimizando perdas e
custos.

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

tempo real de equipamentos de aquisio de dados ou de controle, como os
CLPs (Controladores Lgicos Programveis), UTRs (Unidades Terminais
Remotas), DAQs (Data Acquisition Boards, Placas de Aquisio de Dados),
controladores Multi-Loop ou Single-Loop, centrais de incndio e balanas,
dentre outros dispositivos. Estes equipamentos normalmente possuem
alguma interface que permitem sua conexo ao software, como padres
seriais RS232, RS422 ou RS485; rdio ou modem (linhas privadas ou discadas),
TCP/IP ou UDP/IP, placas ligadas diretamente ao barramento do computador
e outros. O E3 l e escreve dados dos equipamentos atravs de mdulos
(Drivers de Comunicao) que implementam o protocolo (de domnio pblico
ou privado) disponvel em cada um destes equipamentos. Estes Drivers
podem ainda estar em um formato prprio da Elipse Software ou no formato
OPC (OLE for Process Control).

De posse dos dados, possvel criar vrias maneiras para exibir, analisar,
controlar, comandar, gravar ou divulgar tais informaes, dentre elas:

Telas: Permitem criar uma IHM (Interface Homem-Mquina) localmente,

pela rede local ou Internet, com o intuito de exibir o status atual ou
passado dos dados em vrias formas, com o auxlio de um editor grfico
e objetos especficos

Alarmes e Eventos: Monitoram o acontecimento de situaes especficas

Histricos: Armazenam os dados em bancos de dados relacionais

Introduo 1
 Relatrios: Permitem visualizar e imprimir os dados, dentre outros
mdulos e possibilidades

1.1 Descrio Geral

O E3 pode ser executado nas plataformas Windows XP SP3, Windows XP
x64 SP2, Windows Vista SP2, Windows 7 SP1, Windows 8, Windows 8.1,
Windows 10, Windows Server 2003 SP2, Windows Server 2008 SP2,
Windows Server 2008 R2 SP1, Windows Server 2012 ou Windows Server
2012 R2, utilizando alguns recursos disponveis nestes sistemas operacionais.
A interface grfica com o usurio pode tambm ser executada atravs da
Internet ou intranet via Internet Explorer.

As funes bsicas do software esto divididas em mdulos independentes,

capazes de processar atividades especficas. O gerenciamento do trfego de
informaes entre os mdulos coordenado por um mdulo principal (E3
Admin), utilizando a tecnologia de objetos distribudos, permitindo que os
componentes possam ser executados tanto na mesma mquina quanto em
outros computadores.

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

e coordenar o trabalho de vrios outros mdulos, que tambm so
servidores de informaes. A partir da so geradas as interfaces grficas
com o usurio, disponveis atravs dos clientes, tanto locais como pela
Internet.

O E3 possui quatro programas principais, descritos a seguir.

1.1.1 E3 Server
o Servidor de Aplicaes, onde os principais processos so executados,
incluindo a comunicao em tempo real com os equipamentos de controle. O
servidor tambm responsvel por enviar dados e Telas aos clientes
conectados em qualquer parte da rede (intranet e Internet). O servidor pode
executar vrios projetos ao mesmo tempo e conversar com outros E3 Servers
para realizar um fail-over (standby) ou distribuir cargas de processamento
entre as mquinas.

2 Introduo
1.1.2 E3 Studio
Ferramenta nica de configurao, agindo como plataforma universal de
desenvolvimento, que possui um ambiente moderno e amigvel, incluindo um
completo editor grfico e de scripts (VBScript). Permite que um projeto seja
editado por vrias pessoas ao mesmo tempo ou que vrios E3 Studios
estejam conectados ao mesmo servidor remoto, com mltiplas configuraes.

1.1.3 E3 Viewer
Permite operar as aplicaes residentes no servidor a partir de qualquer
computador com o programa executvel Viewer ou com um navegador de
Internet. Em ambos os casos, no necessrio instalar a aplicao na
mquina cliente, pois feito o download e o registro de todos os
componentes (Telas, bibliotecas e controles ActiveX).

1.1.4 E3 Admin
o mdulo responsvel pela interface do E3 Server e de outros mdulos do
E3 com o usurio. Atravs dele o usurio pode enviar comandos ao E3 Server,
utilizando o cone na rea de Notificaes do Windows, e controlar o Domnio
pela linha de comando.

Introduo 3
1.2 Arquitetura
Para supervisionar um determinado processo com um sistema SCADA,
geralmente construda uma aplicao que contm a definio das variveis
envolvidas, com nomes e endereamentos, Telas, definies de alarmes e
outros, a qual se chama Banco de Dados da Aplicao.

Quando este processo exige o uso de dois ou mais computadores, preciso

fazer com que cada aplicao em cada computador troque dados com as
outras. A maioria dos sistemas SCADA tradicionais baseiam-se em uma
arquitetura comum para realizar esta tarefa:

Cada servidor SCADA deve ter uma cpia (parcial ou no) da aplicao
configurada na base de dados local

Cada servidor SCADA possui e executa somente uma base de dados ao

mesmo tempo

Isto leva a alguns problemas de gerenciamento, como aplicar mudanas a

todos os servidores, controlar verses do aplicativo ou ento trabalhar com
diferentes fabricantes de software e hardware.

O E3 resolve este problema usando o conceito de Domnio que inclui, em um

nico ambiente, a definio dos computadores executando tarefas em tempo
real (servidores) e as bases de dados de projeto que devem ser executadas
nestes servidores, com a possibilidade de execuo de vrios projetos em
cada servidor. Tambm possvel inserir, apagar ou modificar projetos
durante a execuo, sem afetar as outras partes do Domnio em execuo.

Cada projeto pode conter qualquer tipo de objeto, como Telas, Drivers de
Comunicao, Alarmes, Histricos, Relatrios, Frmulas e Bancos de Dados,
dentre outros. Quando dois ou mais projetos esto dentro de um mesmo
Domnio, eles podem acessar as propriedades e objetos entre si como se
estivessem residentes em uma nica base de dados. Isto possvel atravs do
uso de Associaes (conexes) que um objeto pode fazer com qualquer
outro. Se ambos os objetos existem e esto executando, a conexo est ativa
e qualquer mudana de valor enviada assincronamente entre as partes
(dependendo do tipo da conexo). Se um dos objetos destrudo ou parado,
a conexo quebrada, ento a aplicao notificada e pode indicar seu
estado em uma forma definida pelo usurio.

4 Introduo
A estrutura do Domnio restrita aos servidores e afins, como as mquinas
servidoras, projetos, usurios e senhas. A interface do cliente para operao e
visualizao, chamada E3 Viewer, pode se conectar diretamente a qualquer
servidor E3 (com licenas suficientes de Viewer). O E3 Viewer possui trs
destaques especiais:

Os projetos da aplicao residem somente no servidor

O navegador Internet Explorer pode ser usado como interface de

operao, sem nenhuma mudana

A interface do cliente capaz de alternar de um servidor desligado ou

com falha para o prximo servidor disponvel, sem interromper o
monitoramento do processo

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

tecnologia Terminal Service. Este servio surgiu no Windows NT 4.0 e sua
funo permitir o acesso remoto entre computadores, atravs de um
protocolo chamado RDP (Remote Desktop Protocol). Este protocolo permite a
interao entre uma estao cliente e uma mquina servidora (que acessada
remotamente). O E3 Viewer executado em uma nova sesso de usurio
criada na mquina servidora, que por sua vez transfere para a mquina cliente
os dados de vdeo e recebe de volta os eventos de mouse e teclado.

Introduo 5
 Arquitetura do E3

6 Introduo
 possvel observar que, em todos os casos, o E3 Viewer continua sendo a
interface de operao e visualizao. A diferena est no local de execuo,
que pode ser na mquina cliente (operao normal do E3 Viewer) ou na
mquina servidora, com o operador fisicamente junto mquina ou atravs
dos Terminal Services. Com o E3 Viewer sendo executado diretamente na
estao cliente, existe um trfego inicial maior para o download de Telas e
objetos. Este trfego diminui substancialmente medida que somente as
mudanas nos dados so reportadas do servidor para o Viewer, o que traz
vantagens em termos de desempenho e qualidade de apresentao grfica.

O Terminal Service, por outro lado, possui maior alcance e exige menor
capacidade de processamento da mquina cliente quando existem poucos
efeitos grficos e visuais, alm da possibilidade de operar o E3 em outras
plataformas de software que no so suportadas pelo E3 Viewer, como o
Windows CE e o Linux ou Unix. Entretanto, o RDP possui a limitao de exibir
somente 256 cores, o que aumenta consideravelmente o trfego quando
existem muitas animaes ou efeitos piscantes nas Telas. Para verificar qual a
melhor maneira de implementar mltiplos acessos a um E3 Server,
importante estudar caso a caso, para poder definir a melhor alternativa para
a aplicao. Para utilizar o RDP com mltiplos usurios, necessrio uma
licena de Windows 2003 Server SP2, alm do mesmo nmero de Viewers
disponveis no Servidor.

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

8 Introduo
1.4 Estrutura de Domnio
Cada grupo de servidores composto por um E3 Server operando
isoladamente ou dois E3 Servers em configurao de Hot-Standby. Cada
Viewer, de fato, se conecta a um Domnio ao invs de somente a um servidor.

Depois da conexo, servidor e cliente trocam informaes e verificam a

existncia de objetos do sistema registrados e atualizados na mquina cliente.
Caso negativo, o servidor carrega as definies dos objetos, como bibliotecas
do usurio, conforme a necessidade para abrir cada uma das Telas.

Do ponto de vista do cliente, o download comea na primeira Tela (interface

grfica), incluindo quaisquer objetos internos que so salvos em um diretrio
de cache. Este processo pode levar alguns segundos, dependendo da
aplicao, mas traz mais benefcios na prxima vez que se abre a mesma Tela,
pois o Viewer realiza um cache em disco e em memria. Se o Viewer no for
fechado, a partir da segunda vez que uma Tela for aberta (e no for
reconfigurada) ela j est criada em memria, reduzindo, portanto, o tempo
de paginao. Se a Tela for modificada, o Viewer deve executar um novo
download, reiniciando o processo.

Depois de abrir uma Tela, o servidor e o cliente trocam somente dados em

tempo real e consultas ao Banco de Dados em um sistema de mensagens
TCP/IP, com um alto desempenho se comparado ao Terminal Services,
dependendo da aplicao. Isto possvel porque enquanto o E3 Viewer
recebe e envia apenas valores e dados em tempo real, um cliente Terminal
Services envia mensagens de teclado e mouse e recebe imagens, o que gera
um trfego muito maior de informaes. Um Viewer conectado a um Domnio
isolado pode obter informaes residentes somente dentro do servidor ativo,
de acordo com os direitos de acesso do usurio.

Introduo 9
1.5 Limitaes do Modo Demonstrao
Sem a utilizao de uma licena, o E3 pode ser executado em modo
Demonstrao (ou Demo), o que til para avaliao do software. Neste
caso, as seguintes limitaes se aplicam:

Permite salvar projetos com at 20 Tags de Comunicao

No permite trabalhar com servidores em modo Hot-Standby

No permite trabalhar com Domnios Remotos

S permite 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 permite 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 permite a abertura de um Viewer ou WebViewer

O tempo mximo de execuo de um Domnio de duas horas

S permite 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, em relao

hora atual do servidor, com um nmero ilimitado de Tags e com todos
os recursos de playback habilitados

No permite utilizar a ferramenta de Exportao de Usurios do E3

Admin

No permite utilizar a ferramenta de Importao e Exportao do E3

Studio

10 Introduo
 CAPTULO
E3 Studio
2
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:

E3 Studio 11
1. No momento da instalao, criado um grupo de programas no menu
Iniciar do Windows. Para iniciar o E3 Studio, selecione o cone
correspondente neste menu, como mostra a figura anterior, ou clique no
cone criado na rea de Trabalho, conforme figura a seguir.

cone do E3 Studio

2. O dispositivo de proteo deve estar conectado na porta de comunicao

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

12 E3 Studio
2.1 Iniciando um Projeto
Quando o E3 Studio iniciado, abre-se uma caixa de dilogo com algumas
opes do projeto, conforme a figura a seguir.

Janela Iniciar o E3 Studio

As opes disponveis nesta caixa de dilogo esto descritas na tabela a

seguir.

Opes disponveis na janela Iniciar o E3 Studio

OPO DESCRIO
Iniciar o E3 Studio No abre nenhum Domnio

Criar um Domnio novo Requisita o nome e caminho do novo

Domnio

E3 Studio 13
 OPO DESCRIO
Abrir um Domnio existente Ao clicar em Outros Arquivos, tem-
se a opo de localizar um Domnio
em um diretrio especfico ou
selecionar na lista um dos ltimos
aplicativos editados

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

rea de trabalho do E3 Studio

A Barra de Ttulo mostra o caminho e o nome da aplicao, ou o nome do

objeto cujo Editor esteja sendo mostrado 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.

E3 Studio 15
A rea de Trabalho onde os Editores so mostrados.

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

16 E3 Studio
2.3.1 Aparncia
Para personalizar a aparncia do E3 Studio, clique no menu Visualizar -
Personalizar. As opes disponveis deste item so as seguintes:

Aba Comandos: Atravs desta aba pode-se definir os cones de cada uma
das barras de ferramentas. Para isto, clique no cone na lista Comandos e
arraste-o para dentro da barra de ferramentas desejada

Aba Comandos

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Comandos

OPO DESCRIO
Categorias Mostra as opes dos menus e
barras de ferramentas disponveis no
E3 Studio

E3 Studio 17
 OPO DESCRIO
Comandos Mostra os itens que compem o
menu ou a barra de ferramentas
selecionada

Descrio Breve descrio da opo

selecionada

18 E3 Studio
 Aba Barras de ferramentas: Atravs desta aba pode-se configurar, editar
ou criar novas barras de ferramentas

Aba Barra de ferramentas

As opes disponveis nesta aba esto disponveis na tabela a seguir.

Opes disponveis na aba Barra de ferramentas

OPO DESCRIO
Barras de ferramentas Lista as opes de barras de
ferramentas disponveis

Restaurar Restaura a barra de ferramentas

desejada no E3

Restaurar tudo Restaura todas as barras de

ferramentas no E3

E3 Studio 19
 OPO DESCRIO
Nova Cria uma nova barra de ferramentas

Renomear Muda o nome da barra de

ferramentas. Esta opo utilizada
somente na barra de ferramentas
criada pelo usurio usando a opo
Nova

Remover Remove a barra de ferramentas

selecionada

Mostrar legendas Mostra uma legenda nas opes da

barra de ferramentas selecionada

20 E3 Studio
 Aba Menus: Atravs desta aba possvel configurar os menus do E3

Aba Menus

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Menus

OPO DESCRIO
Mostra menus para Exibe o menu pr-definido da
aplicao. Esta opo no tem efeito
e mantida no E3 por questo de
compatibilidade

Restaurar Restaura o menu definido na opo

anterior. Esta opo no tem efeito e
mantida no E3 por questo de
compatibilidade

E3 Studio 21
 OPO DESCRIO
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 apresenta o efeito

de sombreado ou no

22 E3 Studio
 Aba Aparncia: Atravs desta aba possvel alterar a aparncia das janelas
e barras de ferramentas no E3 Studio

Aba Aparncia

As opes disponveis nesta aba esto descritas na tabela a seguir.

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)

E3 Studio 23
 OPO DESCRIO
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

24 E3 Studio
 Aba Opes: Atravs desta aba possvel configurar as especificaes
gerais do projeto. Neste item possvel habilitar ou desabilitar as opes
da barra de ferramentas

Aba Opes

As opes disponveis nesta aba esto descritas na tabela a seguir.

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
ponteiro do mouse posicionado
sobre um item

Incluir teclas de atalho Mostra ou no a tecla de atalho na

descrio do boto

E3 Studio 25
 OPO DESCRIO
cones grandes Habilita cones grandes nas barras
de ferramentas

26 E3 Studio
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 janela de configuraes mostrada nas figuras a seguir.

Aba Geral: Configura o comportamento do duplo-clique do mouse em

objetos no Organizer, quando o Editor de um objeto j estiver aberto

Aba Geral

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Geral

E3 Studio 27
 OPO DESCRIO
Ativar o Editor de Scripts Ativa a aba Scripts do Editor do
objeto na ocorrncia de um duplo-
clique do mouse

Abrir a Janela de Propriedades Abre a Janela de Propriedades de

um objeto na ocorrncia de um
duplo-clique do mouse. NOTA: A
janela de propriedades tambm
pode ser aberta utilizando as
combinaes de teclas ALT + ENTER,
CTRL + ALT + ENTER ou ALT +
duplo-clique do mouse

Mostrar boto de fechar na aba Permite fechar a aba ativa ao clicar

ativa no seu respectivo boto de fechar.
Desmarcar esta opo posiciona o
boto de fechar direita do Editor

28 E3 Studio
 Aba Editor de Scripts: Este item destinado configurao do Editor de
Scripts do E3

Aba Editor de Scripts

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Editor

OPO DESCRIO
Abrir-e-Fechar blocos do texto Permite ocultar ou mostrar os blocos
de cdigo no script

E3 Studio 29
 OPO DESCRIO
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

30 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

Aba Arquivos

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

Porm, se um projeto criado na verso atual modificado em uma verso

inferior verso 1.00.019 build 203, o CRC no atualizado. Com isto, o
arquivo no pode ser aberto novamente com as verses atuais, pois a
verificao de CRC falha, mesmo que o arquivo no esteja efetivamente
corrompido. Para solucionar esta questo, necessrio habilitar a opo
Ignorar verificao de CRC. Assim, o projeto pode ser aberto em uma verso
atual.

Neste caso, a opo deve permanecer habilitada at que todos os objetos

editados na verso antiga tenham sido salvos com a verso atual, o que
atualiza o CRC.

NOTA
No recomendvel que arquivos .prj sejam editados em verses mais
antigas do E3 e depois abertos novamente em verses atuais, pois no h
garantia de que com este procedimento no sejam perdidas as
configuraes destes arquivos.

2.4 Barra de Ferramentas

A Barra de Ferramentas do E3 muda conforme a existncia de uma aplicao
aberta ou no. Os botes da barra de ferramentas permitem a execuo de
determinadas tarefas rapidamente, sem utilizar os menus. Desta forma, pode-
se criar Objetos de Tela ou abrir o Organizer simplesmente clicando-se em
um boto da barra de ferramentas. A tabela a seguir mostra as opes
disponveis nas diversas barras de ferramentas do E3 Studio.

Opes disponveis na barra de ferramentas Padro

CONE COMANDO AO
Novo Projeto Cria um novo projeto

32 E3 Studio
 CONE COMANDO AO
Abrir Projeto Abre um projeto
existente

Salvar Projeto Salva o projeto

Salvar Tudo Salva todo o Domnio

Recortar Remove a informao

selecionada e a move
para a rea de
Transferncia

Copiar Copia a informao

selecionada e a move
para a rea de
Transferncia

Colar Cola a informao

selecionada da rea de
Transferncia

Desfazer Desfaz a ltima ao

executada

Refazer Refaz a ltima ao

desfeita pelo item
Desfazer

Organizer Mostra ou esconde o

Organizer

Galeria Mostra ou esconde a

Galeria

Lista de Propriedades Mostra ou esconde a

Lista de Propriedades

E3 Studio 33
 CONE COMANDO AO
Mostrar no Editor Mostra o objeto no
Editor do objeto, se
este estiver selecionado
no Organizer

Mostrar no Organizer Mostra o objeto no

Organizer, se este
estiver selecionado no
Editor do objeto

Executar Aplicativo Salva todos os projetos

e bibliotecas, executa o
Domnio e abre o
Viewer

Rodar ou Parar Executa ou para o

Domnio Domnio corrente

Executar ou Parar E3 Executa ou para o E3

Viewer Viewer

Verificar Domnio Verifica se o Domnio

contm erros

Erro Anterior Mostra o erro anterior

encontrado no Domnio

Prximo Erro Mostra o prximo erro

encontrado no Domnio

Desfragmentar Desfragmenta o arquivo

Arquivos especificado

Procurar ou Substituir Procura todas as

ocorrncias de um
determinado texto em
todo o Domnio

34 E3 Studio
 CONE COMANDO AO
Contagem de Objetos Mostra uma janela com
no Domnio as quantidades de
objetos disponveis no
Domnio, separados
por classes ordenadas
alfabeticamente ou
agrupadas por
mdulos

Documentao de Gera a documentao

Scripts dos scripts

Relatrio de Verses Mostra as verses dos

projetos e bibliotecas

WatchWindow Mostra os valores de

Tags e de propriedades
no E3 Studio em tempo
de execuo

Opes disponveis na barra de ferramentas Sombra

CONE COMANDO AO
Sombra do Objeto Aplica uma sombra no
objeto

Sombra Acima Desloca a sombra para

cima do objeto

Sombra Abaixo Desloca a sombra para

baixo do objeto

Sombra Esquerda Desloca a sombra para

a esquerda do objeto

Sombra Direita Desloca a sombra para

a direita do objeto

E3 Studio 35
 CONE COMANDO AO
Cor da Sombra Seleciona a cor da
sombra do objeto

Opes disponveis na barra de ferramentas Objetos

CONE COMANDO AO
E3Alarm Insere um objeto do
tipo E3Alarm

E3Browser Insere um objeto do

tipo E3Browser

E3Chart Insere um objeto do

tipo E3Chart

Caixa de Seleo Insere um objeto do

tipo Caixa de Seleo
(CheckBox)

Boto de Opo Insere um objeto do

tipo Boto de Opo
(OptionButton)

Lista de Seleo Insere um objeto do

tipo Lista de Seleo
(ComboBox)

Boto de Comando Insere um objeto do

tipo Boto de
Comando
(CommandButton)

Texto Insere um objeto do

tipo Texto (Label)

Lista Insere um objeto do

tipo Lista (ListBox)

36 E3 Studio
 CONE COMANDO AO
Barra de Rolagem Insere um objeto do
tipo Barra de Rolagem
(ScrollBar)

Boto Incremento- Insere um objeto do

Decremento tipo Boto Incremento-
Decremento
(SpinButton)

Editor de Texto Insere um objeto do

tipo Editor de Texto
(TextBox)

Boto Liga-Desliga Insere um objeto do

tipo Boto Liga-
Desliga (ToggleButton)

Opes disponveis na barra de ferramentas Tela

CONE COMANDO AO
Selecionar Habilita o modo de
seleo

Mover Habilita o recurso de

mover (pan) a Tela

Rotacionar Habilita o modo de

rotao

Ordem dos Tabs Mostra o

identificador de
ordem de navegao
entre os objetos

E3 Studio 37
 CONE COMANDO AO
Editar Ponto de Permite editar pontos
Conexo de conexo entre
objetos. Este boto
somente est
habilitado em objetos
XControl

Linha Insere um objeto do

tipo Linha

Conector Insere um objeto do

tipo Conector

Retngulo Insere um objeto do

tipo Retngulo

Retngulo Insere um objeto do

Arredondado tipo Retngulo
Arredondado

Elipse Insere um objeto do

tipo Elipse

Arco de Elipse Insere um objeto do

tipo Arco de Elipse

Desenho Livre Insere uma

ferramenta de
desenho livre

Polgono Insere um objeto do

tipo Polgono

Polgono de Curvas Insere um objeto do

tipo Polgono de
Curvas

Figura Insere um objeto do

tipo Imagem

38 E3 Studio
 CONE COMANDO AO
Texto Insere um objeto do
tipo Texto

Display Insere um objeto do

tipo Display

SetPoint Insere um objeto do

tipo SetPoint

Escala Insere um objeto do

tipo Escala

Agrupar Agrupa uma seleo

de objetos

Desagrupar Desagrupa uma

seleo de objetos

Animar com Insere uma

Translao ferramenta para
movimentos lineares

Animar com Rotao Insere uma

ferramenta para
rotao

Trazer para a Frente Traz o objeto para a

frente em um
agrupamento (ALT +
HOME)

Enviar para Trs Envia o objeto para

trs em um
agrupamento (ALT +
END)

Avanar Move um objeto uma

posio acima no
agrupamento (ALT +
PAGE UP)

E3 Studio 39
 CONE COMANDO AO
Recuar Move um objeto uma
posio abaixo no
agrupamento (ALT +
PAGE DOWN)

Zoom Permite editar o nvel

de zoom da Tela

Camadas Permite editar as

camadas de objetos
na Tela

Opes disponveis na barra de ferramentas Desenho

CONE COMANDO AO
Cor de Fundo Define a cor do fundo
do objeto

Cor de Frente Define a cor da frente

do objeto

Cor da Borda Define a cor da borda

do objeto

Estilo da Borda Define o estilo da

borda do objeto

Espessura da Borda Define a espessura da

borda do objeto

Estilo de Define o estilo de

Preenchimento preenchimento do
objeto

40 E3 Studio
 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

Mesma Largura Aplica a mesma largura

a todos os objetos

Mesma Altura Aplica a mesma altura a

todos os objetos

Mesmo Tamanho Aplica o mesmo

tamanho aos objetos
selecionados

Centralizar Centraliza os objetos

Horizontalmente horizontalmente

Centralizar Centraliza os objetos

Verticalmente verticalmente

Distribuir Formata o espaamento

Horizontalmente entre objetos na
horizontal

Distribuir Formata o espaamento

Verticalmente entre objetos na vertical

E3 Studio 41
 CONE COMANDO AO
Espelhar Aplica uma reflexo
Horizontalmente horizontal no objeto
selecionado

Espelhar Verticalmente Aplica uma reflexo

vertical 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

Tamanho da Fonte Determina o

tamanho da 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

Fonte Sublinhada Formata o texto com

sublinhado

Texto Esquerda Alinha o texto

esquerda

Texto Centralizado Centraliza o texto

42 E3 Studio
 CONE COMANDO AO
Texto Direita Alinha o texto
direita

E3 Studio 43
2.4.1 Contagem de Objetos do Domnio
A ferramenta Contagem de Objetos do Domnio permite visualizar a
quantidade de objetos existentes no Domnio, separados por classes
ordenadas alfabeticamente ou agrupadas por mdulos. A contagem tambm
pode ser feita contextualmente a um objeto, clicando com o boto direito do
mouse no objeto desejado e selecionando a opo Contagem de Objetos .

Janela Contagem de Objetos do Domnio

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Contagem de Objetos do Domnio

CONE OPO DESCRIO

Ordenar por categoria Mostra a contagem de
objetos organizando-os
pelo mdulo

44 E3 Studio
 CONE OPO DESCRIO
Ordenar Mostra a contagem de
alfabeticamente objetos organizando-os
em ordem alfabtica

Atualizar Atualiza a contagem de

objetos. NOTA: A
atualizao no
automtica, exceto
quando o objeto
removido o objeto
base do contexto de
contagem ou quando o
Domnio fechado

Contar filhos de Inclui na contagem os

instncias de ElipseXs filhos internos das
instncias de um
XControl, XFolder ou
XObject

Procurar Permite filtrar a

listagem pelo nome ou
parte do nome do
objeto

NOTAS
O menu contextual Contagem de Objetos no est disponvel no
Organizer em modo Domnio para os itens Configurao, Servidores,
Arquivos e Domnios Remotos.
Os arquivos individuais do item Arquivos no Organizer em modo
Domnio permitem utilizar o menu contextual Contagem de Objetos.
No caso de arquivos protegidos por senha, necessrio que estes
arquivos estejam abertos para que sejam includos na contagem.

E3 Studio 45
2.4.2 Documentao de Scripts
A ferramenta Documentao de Scripts serve para auxiliar o usurio na
organizao e documentao dos scripts da aplicao. Esta ferramenta pode
ser acessada de duas maneiras:

Atravs do cone da barra de ferramentas Padro. Utilizando esta

opo, so gravados no arquivo todos os scripts do Domnio

Clicando com o boto direito do mouse no nome do projeto ou objeto e

selecionando a opo Documentar scripts. Utilizando esta opo,
apenas os scripts do objeto selecionado e de seus filhos so gravados
no arquivo

Esta ferramenta gera um arquivo texto que pode ser editado em qualquer
programa de edio de textos. A formatao do arquivo de documentao
feita atravs de um assistente chamado Assistente de Documentao de
Scripts. Este assistente responsvel por guiar o usurio na configurao do
arquivo de documentao de scripts.

46 E3 Studio
 Assistente de Documentao de Scripts

Na janela Arquivo de documentao so definidas as informaes referentes

ao arquivo que guarda os scripts da aplicao.

No item Nome do arquivo, especifique o nome do arquivo onde gerada a

documentao dos scripts. Especifique o local onde este arquivo salvo no
item Salvar o arquivo na pasta, e caso haja necessidade, clique em Procurar.

E3 Studio 47
 Arquivo de documentao de scripts

Clique em Avanar para ir prxima janela.

A janela Detalhamento do arquivo permite que se formate o arquivo que

contm as informaes de scripts. possvel escolher entre uma
documentao simplificada, contendo apenas os nomes dos scripts, ou uma
documentao completa, onde todo o cdigo dos scripts gravado no
arquivo.

48 E3 Studio
 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 selecionada Apenas os nomes dos scripts, o texto a seguir

gravado no arquivo:
TelaInicial_KeyDown(KeyCode, Shift)

Se for selecionada a opo Todo o script, ento todo o cdigo gravado

com a mesma formatao (identao, linhas em branco, etc.) realizada 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:

E3 Studio 49
 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

E:
<Tela1.CommandButton1:CommandButton1_Click()>
Sub CommandButton1_Click()
...
End Sub

Isto permite a identificao correta de cada script. Clique em Avanar para ir

prxima janela.

Na janela Separador de scripts possvel definir o texto que gravado entre

um script e outro no arquivo de documentao. possvel escolher entre
linhas em branco ou personalizadas, e ainda informar quantas linhas do tipo
escolhido so inseridas no arquivo.

50 E3 Studio
 Separador de scripts

Pode-se optar entre uma Linha em branco ou uma Linha personalizada.

Selecionando a opo Linha em branco, o arquivo de documentao tem
uma linha em branco entre um script e outro. Selecionando a opo Linha
personalizada, pode-se informar um ou mais caracteres para compor a linha
que usada como separador. Os caracteres so informados no campo Entre
com o texto da linha. Se a opo selecionada Repetir at o final da linha,
os caracteres informados so repetidos at o limite de tamanho da linha, que
de 80 caracteres. Pode-se tambm utilizar mais de uma linha como
separador, seja ela em branco ou personalizada. Basta informar um nmero
entre 1 (um) e 100, no campo Entre com o nmero de linhas do separador.
Clique em Avanar para finalizar a configurao. Logo aps, o assistente
mostra uma mensagem indicando a finalizao da configurao e a gerao
do arquivo que contm a documentao dos scripts.

E3 Studio 51
 Mensagem de finalizao da gerao do arquivo que contm os scripts

Algumas observaes relevantes:

Os scripts de XControls, XFolders e XObjects so gravados apenas uma

vez no arquivo, pois so encontrados durante a pesquisa na biblioteca.
Scripts de instncias so gravados quando o objeto pai da instncia
pesquisado

Picks so internamente scripts. Logo, tambm so documentados

A gravao no arquivo feita em ordem alfabtica do nome do objeto,

dentro de cada projeto ou biblioteca

No possvel adicionar scripts a um arquivo j existente, via Assistente.

Sempre que o Assistente iniciado, um novo arquivo criado ou, caso j
exista, sobrescrito

52 E3 Studio
 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

E3 Studio 53
2.4.3 Procurar e Substituir
A ferramenta Procurar busca no Domnio por ocorrncias de um determinado
texto, de forma parcial ou completa. No final da busca, apresentado ao
usurio uma lista de resultados, indicando o objeto onde a ocorrncia foi
encontrada, a localizao dentro deste objeto (se uma propriedade,
Associao, etc.), e o texto que contm a ocorrncia.

A ferramenta Substituir substitui as ocorrncias encontradas por outro texto

especificado.

Janela Procurar/Substituir

Existem trs maneiras de se realizar a procura e a substituio:

Clicar com o boto direito do mouse em um item no Organizer e

selecionar a opo Procurar/Substituir. Esta procura realizada a partir
do item, seguindo a hierarquia (apenas objetos filhos so pesquisados)

Clicar no menu principal do E3 Studio, em Ferramentas - Procurar/

Substituir. Esta procura realizada em todos os projetos e bibliotecas
abertos

Clicar em Procurar/Substituir , na barra de ferramentas Padro. A

procura efetuada em todo o Domnio

As opes disponveis esto descritas na tabela a seguir.

Opes disponveis na ferramenta Procurar/Substituir

54 E3 Studio
 OPO DESCRIO
Procurar por Contm o texto a ser procurado

Procurar Inicia a busca pelo texto

Apenas nos resultados Refaz a pesquisa apenas entre os

resultados da pesquisa anterior

Diferenciar maisculas de Procura pelo texto exatamente como

minsculas foi escrito, diferenciando maisculas
de minsculas

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

Substituir Inicia o processo de substituio

Uma a uma Executa 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 selecionadas na lista de
resultados

ou Mostra ou esconde as opes de

pesquisa e substituio

Seleciona na lista de resultados a

ocorrncia anterior

Seleciona na lista de resultados a

ocorrncia seguinte

E3 Studio 55
NOTA
Para selecionar o objeto e mostrar o local exato onde o texto se encontra,
clique duas vezes 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.

Principais opes de pesquisa

TIPO DE DADOS EXEMPLO OBSERVAO

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

Inteiro 0 Encontra em todas as

100 propriedades
numricas. Pesquisando
por 10 encontra 10 e
10.0, mas no encontra
10.1 ou 100

56 E3 Studio
 TIPO DE DADOS EXEMPLO OBSERVAO
Ponto flutuante 10.0 Encontra em todas as
40,5 propriedades numricas
de tipo Ponto
Flutuante. Pesquisando
por 10.1 no encontra
10 (inteiro). As
configuraes regionais
do Windows so
consideradas para
validar o smbolo
decimal no nmero

Cor 255,255,0 Encontra apenas em

0,0,234 propriedades do tipo
Cor. Deve
necessariamente usar
vrgulas para separar os
valores, que devem
estar no sistema RGB

Booleano Verdadeiro Leva em considerao o

True idioma do Windows
para entender a
pesquisa como sendo
de um valor Booleano

String Teste Encontra Strings inteiras

Tag ou partes de Strings
(de acordo com o tipo
de pesquisa, por
palavra inteira ou no).
Qualquer tipo de dado
pode ser encontrado
em propriedades do
tipo String

E3 Studio 57
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 esta ferramenta, clique em na barra de ferramentas
Padro para mostrar a caixa de dilogo da figura a seguir.

Relatrio de verses

As opes desta caixa de dilogo so mostradas na tabela a seguir.

Opes disponveis na caixa de dilogo Relatrio de verses

OPO DESCRIO
Projeto/Biblioteca Nome do projeto ou da biblioteca
abertos

58 E3 Studio
 OPO DESCRIO
Verso Indica a verso do projeto ou
biblioteca. Esta verso gerada
internamente pelo E3, sendo
incrementada toda 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
possvel increment-la. No entanto,
se o usurio tem permisso para
abrir e alterar o projeto ou a
biblioteca, a verso incrementada
normalmente

Comentrio Mostra o comentrio relacionado ao

projeto. Este comentrio pode ser
editado atravs da propriedade
DocString. No caso de bibliotecas,
este campo permanece em branco

NOTA
Estes campos so apenas para visualizao, no sendo permitida sua
edio.

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

Verificao de Erros no Projeto

Enquanto o erro no for solucionado, a caixa de dilogo continua sendo

mostrada e no possvel executar o Viewer. Aps a resoluo do problema,
o E3 Studio mostra uma caixa de mensagem indicando que no encontrou
nenhum erro no Domnio, e libera a execuo do Viewer.

Mensagem do Item Verificar Domnio

A opo Verificar Domnio pode ser acessada das seguintes maneiras:

60 E3 Studio
 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 em um item do projeto e

selecionando a opo Verificar ou Verificar projeto: Verifica os erros
ocorridos somente no objeto selecionado e em seus filhos

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

Caixa de dilogo WatchWindow

As opes desta caixa de dilogo so mostradas na tabela a seguir.

Opes disponveis na caixa de dilogo WatchWindow

OPO DESCRIO
Adicionar Abre o DomainBrowser (uma janela
do AppBrowser com os objetos
criados no servidor) e seleciona o
objeto que mostrado na janela
WatchWindow

62 E3 Studio
 OPO DESCRIO
Remover Remove a linha selecionada da lista
de objetos da janela WatchWindow

Atualizar Busca toda a rvore de filhos dos

objetos selecionados atualmente na
janela WatchWindow

Conectar Tenta reativar a conexo perdida

com o Domnio para que a
visualizao seja possvel

Nome Indica o Tag ou a propriedade

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

E3 Studio 63
Caso a coluna Valor mostre a indicao Array, isto significa que o Tag ou a
propriedade do tipo Variant e contm um Array. Para visualizar os valores
deste Array, clique na clula desejada e selecione a opo Visualizar Array. A
janela da figura a seguir mostrada.

Janela Edio de Arrays

Nesta janela, se algum dos valores tambm mostrar a indicao Array, seus
valores podem ser visualizados repetindo o procedimento anterior.

64 E3 Studio
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

O modo Domnio mostra apenas as informaes dos objetos abertos

pertencentes ao Domnio. Estas informaes esto organizadas em quatro
grupos: Configurao, Bibliotecas de Objetos, Visualizao e Objetos de
Servidor. Cada grupo apresenta seus objetos ordenados alfabeticamente
dentro do respectivo n.

E3 Studio 65
 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
(XControls, XFolders e XObjects).

Os demais objetos do E3 esto nos grupos Visualizao e Objetos de

Servidor. Em Visualizao esto os objetos que executam 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.

66 E3 Studio
 Modo Explorer

A manuteno da aplicao pode ser feita em qualquer um dos dois modos.

As operaes realizadas em um modo so imediatamente refletidas no outro.
Para facilitar a localizao dos objetos, ambos os modos so intercambiveis,
tanto entre si como com a aba Design do Editor do objeto. Para alternar o
modo de visualizao, siga estes procedimentos:

1. No modo Domnio, clique com o boto direito do mouse no objeto e

selecione Mostrar no Explorer para visualiz-lo no modo Explorer.

2. No modo Explorer, clique com o boto direito do mouse no objeto e

selecione Mostrar no Organizer para visualiz-lo no modo Domnio.

3. Em qualquer um dos modos, clique com o boto direito do mouse no

objeto e selecione Mostrar no Editor para visualiz-lo diretamente na
aba Design.

4. Em qualquer Editor 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.

E3 Studio 67
Ao clicar em um objeto com o boto esquerdo do mouse, suas propriedades
podem ser visualizadas e editadas atravs da Lista de Propriedades, se
habilitada. Clicando com o boto direito do mouse em cada item do
Organizer, so mostradas as opes da tabela a seguir.

Opes disponveis no Organizer

OPO 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
exibida contendo as seguintes
informaes: tamanho original do
arquivo, tamanho desfragmentado e
percentual de compactao

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

68 E3 Studio
 OPO DESCRIO
Inserir Insere objetos disponveis no E3 no
projeto ou na biblioteca. Mais
informaes sobre esta 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, clique com o boto direito do
mouse no projeto e selecione a
opo Desabilitar projeto. Observe
que o cone do projeto muda para
, indicando que o projeto est
desabilitado. Para habilitar o projeto,
clique com o boto direito do mouse
no projeto e selecione a opo
Habilitar projeto. NOTA: O cone de
desabilitado tambm mostrado
para projetos que no fazem parte do
Domnio

Adicionar/Remover do Domnio Adiciona ou remove o projeto ou a

biblioteca do Domnio. Para remover
o projeto ou a biblioteca, clique com
o boto direito do mouse e selecione
a opo Remover do Domnio. Para
adicion-los ao Domnio, clique com o
boto direito do mouse e selecione a
opo Adicionar ao Domnio

Procurar/Substituir Busca por trechos de texto e os

substitui por outros, se for o caso.
Maiores informaes sobre esta
opo no tpico Procurar e
Substituir deste captulo

E3 Studio 69
 OPO DESCRIO
Contagem de Objetos Mostra a quantidade de objetos
existentes no Domnio ou no objeto
selecionado. Esta opo no est
disponvel para os itens
Configurao, Servidores, Arquivos e
Domnios Remotos

Importar/Exportar Auxilia o usurio na importao e na

exportao de objetos, Associaes e
colees. Maiores informaes sobre
esta opo no tpico Importao e
Exportao deste captulo

Documentar Scripts Auxilia o usurio com a documentao

dos scripts da aplicao. Maiores
informaes sobre esta opo no
tpico Documentao de Scripts
deste captulo

Verificar Verifica os erros ocorridos na

aplicao. Maiores informaes sobre
esta opo no tpico Verificar
Domnio deste captulo

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 esta opo no captulo
Associaes

70 E3 Studio
 OPO DESCRIO
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 so listadas
para o usurio em uma mensagem
informando o problema. As
propriedades que existirem tm as
Associaes criadas corretamente.
Associaes de propriedades
escondidas dos ElipseX no so
copiadas

Propriedades Abre a janela de propriedades do

objeto. Quando esta opo aberta
pelo menu, a primeira aba a ser
aberta a de configuraes do
objeto. Mais informaes sobre esta
opo nos respectivos captulos de
cada objeto. NOTA: A janela de
propriedades tambm pode ser
aberta utilizando as combinaes de
teclas ALT + ENTER, CTRL + ALT +
ENTER ou ALT + duplo-clique do
mouse

Carregar Todos os Objetos Carrega todos os objetos do grupo

selecionado

E3 Studio 71
 OPO DESCRIO
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

Abrir Todos os Arquivos Percorre todos os arquivos .prj e .lib

do Domnio. Se algum arquivo
fechado for encontrado, ele aberto.
Se o arquivo estiver protegido com
senha de edio, 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
(veja a figura a seguir)

72 E3 Studio
NOTA
As opes da tabela anterior tambm esto disponveis utilizando a
combinao de teclas SHIFT + F10, que corresponde tecla de aplicao ou
de menu .

Ordem de Ativao do Domnio

E3 Studio 73
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 selecionados a partir do ambiente de
configurao (E3 Studio) em um arquivo CSV. Para cada objeto podem ser
gravadas suas propriedades, Associaes e itens de colees. possvel,
portanto:

Criar novos objetos do E3 a partir do arquivo CSV, desde que estes no

sejam diretamente objetos filhos do projeto ou biblioteca

Importar ou exportar qualquer propriedade de qualquer tipo de objeto

do E3

Importar ou exportar qualquer tipo de Associao de objetos do E3

Exportar qualquer tipo de coleo de objetos do E3 e importar suas

propriedades

Importar ou exportar qualquer tipo de item da coleo de objetos do E3

Qualquer objeto do E3 pode ser importado ou exportado. O objeto

selecionado para a operao chamado de objeto raiz. Com isto, possvel
importar ou exportar, por exemplo, uma Pasta de Dados com XObjects
definidos pelo usurio, ou mesmo exportar uma Tela, listando todos os
objetos filhos.

Alm dos objetos, as Associaes e as colees tambm podem ser

importadas e exportadas. O usurio tem a opo de informar se quer
importar ou exportar Associaes e colees ou no.

74 E3 Studio
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 so importadas ou exportadas.
Este 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 estes objetos sejam criados
corretamente no E3 Studio. Cada coluna do arquivo CSV representa uma ou
mais propriedades de objetos do E3. Cada linha do arquivo representa um
objeto, Associao ou item de coleo. Para que estes arquivos sejam
utilizados corretamente, preciso observar alguns detalhes:

A primeira linha do arquivo CSV deve conter um cabealho que identifica

as colunas corretamente

O cabealho deve ter obrigatoriamente uma coluna que identifica o tipo

do objeto que est sendo importado ou exportado. Esta coluna chama-
se ObjectType. O valor desta coluna o nome da classe do objeto
(XObject1, DrawRect, InternalTag, AgSimple, etc.), com exceo das
colees, que apresentam palavras-chave pr-definidas (ITableBindRow,
IAxis, etc.)

O cabealho das demais colunas deve ser o prprio nome da

propriedade em questo

As colunas podem ser colocadas em qualquer ordem no arquivo; pode

haver colunas a mais ou a menos, sem prejuzo da operao de
importao ou exportao. A nica coluna obrigatria ObjectType,
porque sem ela no possvel identificar o tipo de objeto que deve ser
criado

E3 Studio 75
2.6.1.1 Criando um Arquivo CSV Manualmente

possvel criar um arquivo com extenso .csv a partir do Bloco de Notas, do

Excel ou de outro aplicativo do Windows. O arquivo criado considerando o
separador de elementos configurado no Windows (na configurao por
usurio, no do sistema).

A primeira linha do arquivo deve conter um cabealho com os nomes das

colunas desejadas. Cada coluna deve ser uma propriedade ou um
identificador definido no modelo, conforme visto a seguir. Nas linhas devem
ser colocados os objetos, e os valores das propriedades nas colunas
correspondentes. No necessrio que todas as propriedades dos objetos
sejam listadas no cabealho, bem como podem existir colunas que no
estejam associadas a propriedades de um determinado objeto.

importante tambm que o arquivo CSV tenha uma coluna para a

propriedade Name. Sem esta coluna, 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. Caso o nome do objeto comece com nmeros, este nome
tambm deve ser delimitado 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.

76 E3 Studio
 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, selecionando o modelo
adequado. O E3 cria a estrutura de acordo com o arquivo CSV.

E3 Studio 77
2.6.2 Objetos
A importao ou a exportao de objetos no E3 pode ser feita a partir de
qualquer tipo de objeto, exceto projetos e bibliotecas. A operao a partir do
objeto raiz feita sobre suas propriedades e seus objetos filhos. Para
exportar objetos, siga estes procedimentos:

1. Clique com o boto direito do mouse no objeto desejado e selecione a

opo Exportar.

2. Na caixa de dilogo, selecione o arquivo CSV desejado e clique em

Salvar.

Exportao de Objetos

Na exportao, todas as propriedades, Associaes, colees e itens de

colees do objeto selecionado e de seus filhos so automaticamente
exportadas. gerado um arquivo CSV com uma linha para cada objeto
exportado, bem como para cada Associao, coleo ou item de coleo
existente nestes objetos. Para cada propriedade criada uma coluna no
arquivo, onde informado o valor da propriedade para cada objeto.

78 E3 Studio
O objeto selecionado, chamado de objeto raiz, exportado com a coluna da
propriedade Name em branco. Nos demais casos, esta coluna contm a
hierarquia com nomes separados por pontos. Exemplo de exportao a partir
de um objeto IODriver:

Hierarquia do objeto
Driver1
ObjectType;Name;Prop1;Prop2;Prop3
IODriver;;0;True;0
IOBlock;Bloco1;0;False;0
IOBlockElement;Bloco1.Elemento1;0;False;0
IOBlockElement;Bloco1.Elemento2;0;False;0
IOBlock;Bloco2;0;False;0
IOBlockElement;Bloco2.Elemento1;0;False;0
IOTag;Tag1,0,True,0

Se desejar, o usurio pode configurar a exportao de objetos atravs do uso

de modelos, que so apresentados no tpico Modelos. Utilizando um modelo
possvel configurar se as Associaes, colees e itens de colees so ou
no exportados, se o objeto raiz exportado ou no e quais as propriedades
de cada objeto devem ser exportadas, entre outras configuraes. Para isto,
siga estes procedimentos:

1. Clique com o boto direito do mouse no objeto desejado e selecione a

opo Exportar.

2. Clique em Avanado para configurar ou selecionar um modelo.

3. Na caixa de dilogo, selecione o arquivo CSV desejado e clique em

Salvar.

Para importar objetos, siga estes procedimentos:

E3 Studio 79
1. Clique com o boto direito do mouse no objeto desejado e selecione a
opo Importar.

2. Na caixa de dilogo, selecione o arquivo CSV desejado e clique em Abrir.

Importao de Objetos

Na importao, para cada linha lida do arquivo CSV identificado o objeto a

ser criado. Apenas o filho mais ao final da hierarquia pode ser criado. O
restante do caminho deve existir. Por exemplo, no objeto Pasta1.Pasta2.Tag,
apenas Tag deve ser criado. Pasta1 e Pasta2 devem existir previamente.
Assim, permitido ter no arquivo apenas pastas, sem filhos. O arquivo pode
ter linhas como a seguir:
ObjectType;Name
IOFolder;Pasta1

As linhas em branco, as linhas onde no encontrado um identificador de

tipo vlido, as colunas em branco e as colunas que tenham nomes invlidos
de propriedades so ignoradas, sem gerar erro.

80 E3 Studio
2.6.3 Modelos
Os Modelos so arquivos INI utilizados para configurar a ferramenta de
importao e exportao, informando, por exemplo, qual separador deve ser
utilizado no arquivo CSV, se as Associaes dos objetos devem ou no ser
exportadas, etc. Os arquivos INI tm o seguinte formato:

Linhas iniciadas por ponto e vrgula so comentrios, desconsiderados na

interpretao do arquivo

O arquivo organizado em sees, e cada seo contm uma ou mais

variveis. As sees so identificadas por nomes entre colchetes. As
variveis so as palavras antes do smbolo de igualdade. Uma seo no
pode conter duas variveis com o mesmo nome

Linhas em branco so ignoradas

Um exemplo de arquivo INI mostrado a seguir:

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

O formato um texto facilmente modificvel pelo usurio, sendo possvel

gerar um modelo novo utilizando um editor de textos comum. O mesmo
modelo pode ser utilizado tanto para a importao como para a exportao
de objetos.

Os modelos utilizados no E3 permitem que o usurio redefina valores para

nomes das colunas do arquivo CSV, bem como para os tipos de objetos.
Alm disto, tambm permitem que o usurio agrupe mais de uma
propriedade em uma mesma coluna. Isto tudo feito atravs da definio de
identificadores, que so palavras-chave utilizadas no arquivo CSV e
associadas propriedades ou classes de objetos no arquivo INI.

No E3, os modelos da ferramenta de importao e exportao esto

definidos com as sees e variveis descritas na tabela a seguir.

E3 Studio 81
 Sees definidas para os Modelos

SEO DESCRIO
Header (*) Define os identificadores permitidos
para nomes de colunas e tipos de
dados. Nesta seo devem 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 devem 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 deve estar
documentado nesta seo, sendo
criada uma varivel para cada um
dos identificadores

Columns Relaciona os identificadores de

nomes de colunas com os nomes de
propriedades. Cada identificador
listado na varivel header que no
for igual a um nome de propriedade
deve estar documentado nesta
seo, sendo criada uma varivel
para cada um dos identificadores

82 E3 Studio
 SEO DESCRIO
Filter Define quais as classes de objetos
que devem ou no ser importadas
ou exportadas. Nesta seo deve ser
definida uma das duas variveis,
include ou exclude. Se ambas forem
definidas, apenas include
considerada

Variveis definidas para os Modelos

SEO DESCRIO
header (*) Define a ordem das colunas e os
identificadores que so utilizados.
Devem ser listadas todas as colunas
que o arquivo CSV tem, separadas
por vrgulas. Cada identificador que
no for igual a um nome de
propriedade deve 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 devem ser listados
nesta varivel separados por vrgulas.
S necessrio definir esta varivel se
algum identificador for diferente do
nome da classe do objeto. Neste
caso, para cada um dos
identificadores deve haver tambm
uma varivel na seo Types

E3 Studio 83
 SEO DESCRIO
separator Define o separador que utilizado
para delimitar as colunas no arquivo
CSV. Caso esta varivel no seja
definida, utilizado o separador de
listas configurado no Windows

root Define se o objeto raiz exportado

ou importado junto com os objetos
filhos. Caso esta varivel no seja
definida, o objeto raiz utilizado

link Define se as Associaes dos objetos

so exportadas ou importadas. Caso
esta varivel no seja definida, as
Associaes so utilizadas

collection Define se as colees dos objetos so

exportadas ou importadas. Caso esta
varivel no seja definida, as colees
so utilizadas

84 E3 Studio
 SEO DESCRIO
objectduplicated Define o que fazer quando um objeto
pr-existente estiver sendo importado.
Os valores possveis para esta 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

3 - createalways: Sempre cria um

objeto novo, auto-incrementando o
nome

Caso esta varivel no seja definida,

assumido o valor askalways. Esta
opo no tem valor na exportao

E3 Studio 85
 SEO DESCRIO
bindduplicated Define o que fazer quando uma
Associao pr-existente estiver sendo
importada. Os valores possveis para
esta varivel so:

0 - askalways: Sempre questiona o

usurio sobre o que deve ser feito

1 - changealways: Sempre substitui

a Associao existente pela nova

2 - ignorealways: Sempre ignora a

Associao sendo importada

Caso esta varivel no seja definida,

assumido o valor askalways. Esta
opo no tem valor na exportao,
nem tampouco possui o valor
createalways. Neste caso, sempre
modificado para askalways

collectionduplicated Define o que fazer quando uma

coleo pr-existente estiver sendo
importada. Os valores possveis para
esta varivel so:

0 - askalways: Sempre questiona o

usurio sobre o que deve ser feito

1 - changealways: Sempre substitui

a coleo existente pela nova

2 - ignorealways: Sempre ignora a

coleo sendo importada

Caso esta varivel no seja definida,

assumido o valor askalways. Esta
opo no tem valor na exportao,
nem tampouco possui o valor
createalways. Neste caso, sempre
modificado para askalways

86 E3 Studio
 SEO DESCRIO
itemduplicated Define o que fazer quando um item de
coleo pr-existente estiver sendo
importado. Os valores possveis para
esta 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

3 - createalways: Sempre cria um

item novo, auto-incrementando o
nome

Caso esta varivel no seja definida,

assumido o valor askalways. Esta
opo no tem valor na exportao

include Define quais classes de objetos devem

ser importadas ou exportadas. O filtro
no recursivo, ou seja, se for
includa uma classe de um objeto que
possa ter filhos, estes filhos no so
includos automaticamente. No pode
ser usada junto com a varivel
exclude. Apenas o que estiver
definido nesta varivel exportado ou
importado

E3 Studio 87
 SEO DESCRIO
exclude Define quais classes de objetos no
devem ser importadas ou exportadas.
O filtro no recursivo, ou seja, se for
excluda uma classe de um objeto que
possa ter filhos, estes filhos no so
excludos automaticamente. No pode
ser usada junto com a varivel
include. Apenas o que estiver definido
nesta varivel desconsiderado na
importao ou na exportao

88 E3 Studio
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 este caractere definir
um comentrio no arquivo INI. Desta forma, a varivel criada na seo
Columns ou na seo Types para definir o identificador que possui o ponto
e vrgula no pode ser lida corretamente.

Exemplo:
[Header]
header = ObjectType,Name,DocString,N1/B1,N2/B2,N3/B3,N4/
B4,Scan,AllowRead,AllowWrite
types = Tag,Bloco,Elemento

[Configuration]
separator = ','
root = true
link = true
collection = true
objectduplicated = askalways
bindduplicated = askalways
collectionduplicated = askalways
itemduplicated = askalways

[Types]
Tag = IOTag
Bloco = IOBlock
Elemento = IOBlockElement

[Columns]
N1/B1 = N1,B1
N2/B2 = N2,B2
N3/B3 = N3,B3
N4/B4 = N4,B4

[Filter]
exclude = IOFolder

E3 Studio 89
A Elipse Software fornece alguns modelos para importao e exportao de
alguns tipos de objetos. Estes modelos tambm podem ser utilizados como
base para a criao de outros. Os modelos fornecidos esto na pasta
Templates da instalao do E3.

NOTA
Na importao, as colunas 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 deve estar
definido na seo Columns ou a coluna ignorada.

90 E3 Studio
2.6.4 Gerenciador de Modelos
O Gerenciador de Modelos uma ferramenta para auxiliar o usurio na
criao de um arquivo INI para ser utilizado na importao ou exportao de
objetos do E3. Para acess-lo, clique na opo Importar/Exportar e, uma vez
aberta a janela da opo, clique em Avanado. Caso o usurio j tenha
carregado um modelo, os valores iniciais das opes nas abas da janela
esto de acordo com o que foi previamente configurado. As abas disponveis
esto descritas a seguir.

Configuraes: Atravs desta aba, o usurio pode configurar as opes

vlidas tanto para a importao quanto para a exportao

E3 Studio 91
 Aba Configuraes

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Configuraes

92 E3 Studio
 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) ou Usar
outro caractere como separador
(escolhe outro caractere definido
pelo usurio como separador de
colunas)

Outras opes Define o que importado ou

exportado: objetos, Associaes ou
colees. As opes disponveis so:
Importar/exportar o objeto raiz,
Importar/exportar associaes ou
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 so salvas, e este arquivo
pode ser reutilizado. Quando for
desmarcada, as configuraes feitas
so salvas temporariamente em um
arquivo na pasta de arquivos
temporrios do Windows. Este
arquivo utilizado para a
importao ou exportao realizada
logo aps a configurao, e
removido posteriormente

E3 Studio 93
 Importao: Atravs desta aba, o usurio pode configurar as opes
vlidas somente para a importao.

Aba Importao

As opes disponveis nesta aba esto descritas na tabela a seguir.

94 E3 Studio
 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
ou Sempre criar um novo objeto

Importao de associaes Especifica como o E3 deve lidar com

duplicadas a ocorrncia de Associaes
duplicadas na importao. As opes
disponveis so Questionar sobre o
que fazer em cada caso, Sempre
sobrescrever a associao existente
ou Sempre ignorar a associao
duplicada

Importao de colees duplicadas Especifica como o E3 deve lidar com

a ocorrncia de colees duplicadas
na importao. As opes
disponveis so Questionar sobre o
que fazer em cada caso, Sempre
sobrescrever a coleo existente ou
Sempre ignorar a coleo duplicada

Importao de itens de coleo Especifica como o E3 deve lidar com

duplicados a ocorrncia de itens de coleo
duplicados na importao. As
opes disponveis so Questionar
sobre o que fazer em cada caso,
Sempre sobrescrever o item
existente, Sempre ignorar o item
duplicado ou Sempre criar um novo
item

E3 Studio 95
 Filtros: Atravs desta aba, o usurio pode escolher quais classes so
utilizadas na importao ou na exportao, ou quais classes no deseja
utilizar

Aba Filtros

96 E3 Studio
As opes disponveis nesta aba esto descritas na tabela a seguir.

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 so

importadas ou exportadas

Excluir apenas estes objetos Define quais classes de objetos no

so importadas ou exportadas

Alterar Abre uma janela para seleo das

classes de objetos a serem includas
ou excludas

Ajuda Abre uma janela de ajuda para a

opo

E3 Studio 97
Clicando em Alterar, abre-se uma janela para a escolha de classes, mostrada
na figura a seguir.

Janela Classes de Objetos

As classes que preenchem inicialmente a lista so as do objeto raiz e seus

filhos, caso um novo modelo esteja sendo criado. O usurio pode adicionar
outras, clicando em , ou remover alguma classe, clicando em .

Identificadores: Atravs desta aba, o usurio define os identificadores para

as classes de objetos escolhidas. O estado inicial desta lista vazio

98 E3 Studio
 Aba Identificadores

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Identificadores

E3 Studio 99
 OPO DESCRIO
Nome da classe Indica o nome da classe selecionada
na opo

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
considerado na importao, e algum
objeto pode ser criado com o tipo
errado

Adicionar Adiciona classes de objetos

Remover Remove a classe de objetos

selecionada

Ajuda Apresenta uma janela com texto de

ajuda

100 E3 Studio
 Propriedades: Atravs desta aba, o usurio escolhe quais propriedades dos
objetos deseja utilizar na importao ou na exportao. O valor inicial da
lista ObjectType e as demais propriedades devem ser adicionadas
manualmente pelo usurio

E3 Studio 101
 Aba Propriedades

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Propriedades

102 E3 Studio
 OPO DESCRIO
Nome da coluna Permite ao usurio alterar o valor a
ser utilizado como nome da coluna
no cabealho do arquivo CSV. O
valor inicial desta coluna sempre o
prprio nome da propriedade do
objeto. Para cada valor alterado
nesta coluna, criada uma entrada
no arquivo INI na seo Columns.
Os nomes das colunas no so
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
identificada corretamente, e todas as
colunas com o mesmo nome so
relacionadas mesma propriedade.
Neste caso, algum valor pode ser
sobrescrito

Propriedade Indica a propriedade sendo

importada ou exportada

Para cima e Para baixo Redefinem a ordem das colunas ao

alterar a ordem das propriedades
na lista

Adicionar Adiciona propriedades lista

Remover Exclui propriedades da lista, com

exceo de ObjectType.
Alternativamente, pode-se utilizar a
tecla DELETE para excluir uma
propriedade

E3 Studio 103
 OPO DESCRIO
Nome da coluna Cria um nome de coluna associado a
mais de uma propriedade. Selecione
as propriedades que deseja agrupar
e clique nesta opo. 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

Ajuda Mostra uma janela com um texto de

ajuda

104 E3 Studio
Ao clicar em , abre-se uma janela para a seleo de propriedades,
mostrada na figura a seguir.

Janela Propriedades

As opes disponveis nesta janela esto descritas na tabela a seguir.

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

Adicionar todas as propriedades Adiciona todas as propriedades do

tipo de objeto selecionado na
opo anterior

E3 Studio 105
 OPO DESCRIO
Listar todas as classes de objetos do Se esta opo for selecionada, a
E3 caixa de seleo de objetos mostra
todas as classes existentes no E3,
independente de filtro ou objeto
raiz

Propriedades Mostra as propriedades do objeto

selecionado

106 E3 Studio
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 esta propriedade do agrupamento, mantendo as outras
propriedades agrupadas corretamente.

As propriedades do tipo TextFont possuem propriedades internas que

configuram separadamente tipo, tamanho e outras caractersticas da fonte.
Elas so exportadas com o nome da propriedade principal (de acordo com o
objeto), seguido do nome da propriedade interna, separados por um ponto
(por exemplo, TextFont.Bold). No configurador de modelos, as propriedades
internas aparecem separadas para o usurio, para que a escolha possa ser
feita isoladamente.

Propriedades do Tipo TextFont

E3 Studio 107
2.6.5 Importao de Objetos do SCADA para o E3
A partir da verso 2.29 do Elipse SCADA foram desenvolvidas funcionalidades
que facilitam a exportao de Tags, alarmes e alguns objetos de Tela do
Elipse SCADA, e a importao destes no E3.

2.6.5.1 Configurao de Alarmes

A exportao da Configurao de Alarmes feita automaticamente ao

exportar os Tags, seguindo os passos descritos anteriormente. Alm do
arquivo com os Tags, gerado um arquivo com o mesmo nome acrescido do
sufixo _Alarms. Por exemplo, se o nome escolhido foi "TagsInternos", so
gerados os arquivos TagsInternos.e2f e TagsInternos_Alarms.e2f. Este
segundo arquivo com o prefixo _Alarms contm a configurao dos alarmes
dos Tags exportados. Para importar estes alarmes no E3, siga estes passos:

1. No Organizer, insira uma nova Configurao de Alarmes, e insira uma

rea.

2. Clique com o boto direito do mouse na rea e selecione a opo

Importar.

3. Se a importao foi realizada com sucesso, os alarmes devem aparecer

sem nenhuma mensagem de erro. Caso os Tags correspondentes j
tenham sido importados, todas as referncias devem aparecer na cor
azul.

108 E3 Studio
2.6.5.2 Configurao e Tags de Servidores OPC

1. No Organizer do Elipse SCADA, selecione o item OPCServers e clique no

Driver OPC desejado.

2. Clique em Exportar.

Exportao de Configuraes e Tags de Servidores OPC

3. Selecione o local e o nome do arquivo a ser gerado. Alm do arquivo

com as configuraes dos Tags OPC, gerado um arquivo com o mesmo
nome seguido do sufixo _Alarms. Este arquivo utilizado posteriormente
na importao da configurao de alarmes no E3.

Para executar a importao dos Tags OPC no E3 3.0, siga estes passos:

1. No Organizer, insira um novo Driver de Comunicao OPC.

E3 Studio 109
2. Renomeie o Driver de Comunicao OPC para o mesmo nome do Driver
OPC utilizado na aplicao Elipse SCADA, para que posteriormente as
referncias para os Tags deste Driver OPC sejam importadas
corretamente.

3. Clique com o boto direito do mouse no Driver OPC e selecione a opo

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.

110 E3 Studio
2.6.5.3 Tags de Comunicao (PLC e Bloco)

Os Tags de Comunicao do Elipse SCADA so exportados separadamente

para cada Driver. Para executar a exportao, abra a aplicao no Elipse
SCADA e siga estes procedimentos:

1. No Organizer do Elipse SCADA, selecione o item Drivers e clique no

Driver desejado.

2. Clique em Exportar.

Exportao de Drivers

3. Selecione o local e o nome do arquivo a ser gerado. Alm do arquivo

com as configuraes dos Tags, gerado um arquivo com o mesmo
nome, seguido do sufixo _Alarms. Este arquivo utilizado posteriormente
na importao da configurao de alarmes no E3.

E3 Studio 111
Para executar a importao dos Tags no E3, siga estes passos:

1. Insira um Driver de Comunicao no Organizer.

2. Renomeie o Driver para o mesmo nome do Driver utilizado na aplicao

Elipse SCADA, para que posteriormente as referncias para os Tags deste
Driver sejam importadas corretamente.

3. Clique com o boto direito do mouse no Driver de Comunicao e

selecione o item Importar.

4. Na lista de tipos de arquivos, selecione a opo Arquivos do Elipse

SCADA (*.e2f), e a seguir selecione o arquivo exportado anteriormente,
sem o sufixo _Alarms. No necessrio selecionar um modelo.

Importao de Tags

112 E3 Studio
2.6.5.4 Tags RAM e Demo

Para exportar os Tags RAM e Demo, siga estes passos:

1. No Organizer do Elipse SCADA, selecione o item Tags.

2. Clique em Exportar.

Exportao de Tags RAM e Demo

3. Selecione o local e o nome do arquivo a ser gerado. Alm do arquivo

com as configuraes dos Tags, gerado um arquivo com o mesmo
nome seguido do sufixo _Alarms. Este arquivo utilizado posteriormente
na importao da configurao de alarmes no E3.

Para executar a importao dos Tags no E3, siga estes passos:

1. Insira um Servidor de Dados no Organizer.

E3 Studio 113
2. Renomeie o Servidor de Dados para Dados, para que posteriormente as
Associaes dos objetos de Tela sejam importadas corretamente.

3. Clique com o boto direito do mouse no Servidor de Dados e selecione a

opo Importar.

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.

114 E3 Studio
2.6.5.5 Telas

A exportao de Telas do Elipse SCADA parcial e suporta apenas um

subconjunto dos objetos de Tela. Para exportar uma Tela, siga estes passos:

1. No Organizer do Elipse SCADA, selecione o item Telas e clique na Tela

desejada.

2. Clique em Exportar.

Exportao de Telas

3. Selecione o local e o nome do arquivo a ser gerado.

4. No Organizer, insira uma nova Tela.

5. Clique com o boto direito do mouse na Tela e selecione a opo

Importar.

E3 Studio 115
6. Na lista de tipos de arquivos, selecione a opo Arquivos do Elipse
SCADA (*.e2f), e a seguir selecione o arquivo exportado anteriormente.
No necessrio selecionar um modelo.

Se a importao foi realizada com sucesso, a Tela preenchida com os

objetos, e nenhuma mensagem de erro mostrada. Os arquivos de imagens
utilizados pela Tela devem ser tratados conforme um dos casos a seguir:

Arquivos de imagens com caminhos relativos na aplicao Elipse

SCADA: Estes arquivos devem ser inseridos manualmente como Recursos
no projeto do E3. possvel inserir vrios arquivos de uma vez, clicando
com o boto direito do mouse no item Recursos do Organizer e
selecionando a opo Inserir recurso em

Arquivos de imagens com caminhos absolutos: Estes arquivos devem

permanecer nos seus diretrios originais. O E3 os procura no mesmo
diretrio onde so encontrados pela aplicao do Elipse SCADA

NOTA
recomendado inserir todos os arquivos no projeto como Recursos, para
que o Viewer possa executar o download automaticamente pela rede. Isto
evita a necessidade de instalar os arquivos manualmente nas mquinas
cliente.

116 E3 Studio
2.6.6 Associaes
Para a importao ou a exportao de Associaes no E3, deve ser
selecionada a opo correspondente no modelo. No h como excluir apenas
um ou outro tipo de Associao. Ou todas so importadas ou exportadas ou
nenhuma.

Cada Associao ocupa uma linha no arquivo CSV. A identificao das

Associaes feita atravs das seguintes palavras-chave:

AgSimple: Associaes Simples, Bidirecionais ou Reversas (estas devem

ser diferenciadas pelas propriedades Reverse e Bidirectional)

AnalogBind: Associaes Analgicas

AnimationBind: Associaes Digitais

TableBind: Associaes por Tabela

As propriedades ou os campos das Associaes so importados ou

exportados como se fossem propriedades de objetos, com uma coluna no
arquivo CSV para cada uma delas. Todas as Associaes possuem as
propriedades Source e Property e, alm delas, as propriedades existentes
para cada Associao so as seguintes:

AgSimple: Reverse, Bidirectional

AnalogBind: SrcHiValue, SrcLoValue, DstHiValue, DstLoValue

AnimationBind: BlinkOn, BlinkOff, OnValue, OffValue, BlinkOnValue,

BlinkOffValue

A criao de linhas da tabela respeita o ndice informado pelo usurio. Se o

ndice no for um nmero, mostrada uma mensagem de erro (nome
invlido). Se for um ndice inexistente (por exemplo, s existem duas linhas na
tabela e o usurio quer inserir a linha cinco), as linhas que faltam so criadas
e ficam com os valores padro.

E3 Studio 117
Todas as Associaes so importadas ou exportadas, independente da
seleo de propriedades que o usurio tenha feito. Se uma Associao para
determinada propriedade j existir, o usurio questionado sobre o que
fazer. Caso contrrio, elas so criadas.

Importao de uma Associao pr-existente

No nome do objeto deve ser informado o caminho completo, no formato

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

118 E3 Studio
2.6.7 Colees e seus Itens
Para a importao ou a exportao de colees no E3, deve ser selecionada a
opo correspondente no modelo. No h como excluir apenas uma ou outra
coleo. Ou todas so importadas ou exportadas ou nenhuma.

As colunas de cada coleo dependem das propriedades que esta coleo

possui. O tratamento feito da mesma forma que nas colunas das
propriedades dos objetos.

No caso de colees e itens de coleo, as propriedades precisam ser

includas no arquivo INI manualmente. No possvel selecionar estas
propriedades atravs do Configurador de Modelos.

As colees podem ser importadas e suas propriedades, atualizadas. Como

as colees sempre existem, e no possvel criar outra coleo do mesmo
tipo, o usurio questionado se deseja ignorar ou sobrescrever a coleo
existente.

Se o item de coleo que est sendo importado j existir, o usurio

questionado se deseja ignor-lo, sobrescrev-lo ou criar um novo. Caso o
usurio selecione esta ltima opo:

No caso de Penas e Eixos, o nome auto-incrementado corretamente

No caso de linhas da Associao por Tabela, elas so criadas sempre ao

final desta

No caso de colunas da Legenda, mostrada uma mensagem de erro

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, no formato

Objeto.Collection.Name. Exemplo:
E3Chart1.Pens.Pena1

Na coluna de tipo deve aparecer uma das seguintes palavras-chave:

IDispChartPen: Penas do E3Chart

E3 Studio 119
 ILegendColumn: Legendas do E3Chart

IAxis: Eixos do E3Chart

ITableBindRow: Linhas das Associaes por Tabela

2.6.8 Logs e Relatrios de Falhas

Durante o processo de importao ou exportao, gerado um arquivo de
log contendo os erros ocorridos e algumas outras consideraes relevantes,
caso a seo de log ImportExport esteja habilitada. Para habilitar esta seo,
consulte o captulo Configuraes Avanadas.

Ao final da operao, h uma opo para visualizar um relatrio de falhas na

importao. Neste relatrio constam falhas que provavelmente so erros no
arquivo CSV, como objeto inexistente, entre outras.

Relatrio de falhas na importao

120 E3 Studio
2.7 Lista de Propriedades
A Lista de Propriedades uma janela de configurao das propriedades do
objeto selecionado.

O ttulo da Lista de Propriedades mostra sempre o nome do objeto

selecionado no momento. Para que esta janela esteja visvel no projeto,
necessrio que a opo Lista de Propriedades esteja selecionada no
menu Visualizar. A figura a seguir mostra a Lista de Propriedades de um
objeto Elemento de Bloco de Comunicao com suas propriedades
ordenadas alfabeticamente.

Lista de Propriedades ordenada

alfabeticamente

A Lista de Propriedades da figura a seguir mostra o objeto anterior com suas

propriedades ordenadas por categoria.

E3 Studio 121
 Lista de Propriedades ordenada por categoria

NOTA
No caso de seleo mltipla de objetos, a Lista de Propriedades mostra
apenas as propriedades comuns aos objetos selecionados, com seus valores
correspondendo ao ltimo objeto selecionado. O mesmo critrio utilizado
se a Lista de Propriedades est ordenada por categoria, ou seja, as
categorias mostradas correspondem s do ltimo objeto selecionado.

O rodap da Lista de Propriedades mostra uma descrio rpida da

propriedade selecionada. As opes disponveis nesta janela esto descritas
na tabela a seguir.

Opes disponveis na Lista de Propriedades

122 E3 Studio
 CONE OPO DESCRIO
Ordenar por categoria Mostra as
propriedades do objeto
selecionado
organizadas por
categorias

Ordenar Mostra as
alfabeticamente propriedades do objeto
selecionado
organizadas
alfabeticamente

Procurar Permite filtrar a

listagem pelo nome ou
parte do nome da
propriedade

Pode-se configurar o valor de uma propriedade digitando diretamente na sua

respectiva coluna Valor. direita do nome da propriedade existe um cone
que indica o seu estado atual: O cone indica que o valor da propriedade
o padro, ou seja, seu valor no foi modificado pelo usurio, e o cone
indica que o valor da propriedade foi modificado pelo usurio (o valor
modificado aparece em negrito). Alm disto, clicar neste cone abre um menu
contextual com as opes descritas na tabela a seguir.

Opes disponveis no menu contextual de uma propriedade

OPO DESCRIO
Resetar Reverte o valor da propriedade
selecionada para seu valor padro,
caso tenha sido modificado pelo
usurio

Copiar Copia o valor da propriedade

selecionada para a rea de
Transferncia

E3 Studio 123
 OPO DESCRIO
Colar Cola o valor da rea de
Transferncia no valor da
propriedade selecionada

Editar Permite editar o valor da

propriedade selecionada

NOTA
As opes do menu contextual de uma propriedade podem estar habilitadas
ou desabilitadas, dependendo do tipo de dados da propriedade.

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

124 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 o resultado do uso do AppBrowser. De
acordo com seu contexto de utilizao, alguns objetos no podem ser
utilizados e nem so mostrados aqui.

No quadro central so mostradas as propriedades e os mtodos do objeto

selecionado, e no quadro direita o texto de ajuda da propriedade ou do
mtodo selecionado.

Mais abaixo mostrado o texto resultante do AppBrowser, ao lado das

opes Colar e Cancelar. Clique em Colar para aceitar o resultado e copiar o
valor para o local desejado. Clique em Cancelar para ignor-lo.

E3 Studio 125
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 para selecion-lo automaticamente.

Existem trs maneiras de se utilizar o AppBrowser:

Atravs de scripts

Atravs de Associaes

Atravs de algumas propriedades de objetos que possuem como valor

um outro nome de objeto

Cada uma destas maneiras abordada nos tpicos seguintes.

126 E3 Studio
2.9.1 Acesso via Script
Para utilizar o AppBrowser a partir de um script, abra o Editor de Scripts
desejado e clique em na barra de ferramentas Scripts. Neste modo, os
objetos esto separados conforme a figura a seguir.

AppBrowser via Scripts

No quadro esquerda:

O primeiro item, mostrado isoladamente, o Contexto. O objeto

contexto o que originou a chamada do AppBrowser, ou seja, o dono do
script

O segundo item a Hierarquia completa para se chegar ao objeto

contexto, caso o contexto no esteja na raiz do projeto. Este objeto pode
ser expandido e o prprio objeto contexto pode ser visto nesta
hierarquia

Caso o contexto no seja um objeto do servidor, o terceiro item

mostrado o Viewer (objeto Application)

O quarto item o Servidor. Nele so listados todos os objetos do

servidor que a aplicao possui. Caso este item seja o contexto atual, ele
contm a indicao de Application

E3 Studio 127
 O quinto item chamado de Tarefas. Nele aparecem as tarefas mais
comuns de serem executadas atravs de um script. So duas: Carregar
relatrio (cujo resultado do AppBrowser a expresso para carregar um
Relatrio) e Abrir tela (cujo resultado a expresso para abrir a Tela
selecionada, equivalente ao Pick Abrir Tela)

Finalmente, o sexto item mostra todas as funes do VBScript disponveis

para uso em scripts

De acordo com o objeto selecionado, o quadro central mostra suas

propriedades e seus mtodos.

2.9.2 Acesso via Associao

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

AppBrowser via Associaes

Neste caso, apenas as propriedades dos objetos so mostradas no quadro

central da janela. Seus mtodos no so mostrados, pois no permitido
us-los em Associaes.

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

AppBrowser via Propriedade

As propriedades que permitem o uso do AppBrowser so as seguintes:

DBServer dos objetos Frmula, Histrico e Storage

DataSource do objeto Servidor de Alarmes

InitialScreen do objeto Viewer

SplitLink do objeto Quadro

E3 Studio 129
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 executa o Domnio ou se deve obter a
licena em um outro servidor. Para utilizar este recurso, clique no menu
Arquivo - Conectar a para abrir a caixa de dilogo mostrada na figura a
seguir.

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 isto, selecione o
servidor usando a caixa de seleo

Pegar licena no servidor de Usa licena do servidor onde o

Domnio atual Domnio executa

130 E3 Studio
 OPO DESCRIO
Usar licena de um servidor Usa a licena de outro servidor, que
especfico no o servidor que est executando
o Domnio

E3 Studio 131
Se a conexo com qualquer dos dois servidores (Domnio ou licena) cair, o
E3 Studio desconectado do outro servidor. A ltima configurao
guardada no Registro do Windows e, da prxima vez em que o E3 Studio for
aberto, ele se conecta aos servidores de Domnio e de licena utilizados da
ltima vez.

Se o servidor de licena no estiver disponvel, ou se no houver mais licenas

disponveis, ento o E3 Studio permanece em modo Demo. Um E3 Studio sem
licena (modo Demo) s pode se conectar a um servidor de Domnio que
tambm esteja em modo Demo.

Se o servidor de licena for diferente do servidor de Domnio, o nome do

servidor de licena mostrado no ttulo da janela do E3 Studio: Licena no
servidor local ou Licena em <Nome_Servidor>.

Se for especificado um servidor de licena, a janela de licenas do E3 Server

no servidor de Domnio mostra o nome do servidor que est emprestando a
licena para o E3 Studio: SERVIDOR1 (licena emprestada de SERVIDOR2).
Neste caso a licena que est listada no servidor de Domnio no entra na
contagem de licenas de E3 Studio em uso naquele servidor.

Se o servidor de Domnio no possuir uma licena, e um E3 Studio se conectar

a este servidor usando a licena de outro, ento o servidor de Domnio passa
temporariamente de modo Demo para modo Studio, voltando para modo
Demo assim que a sesso do E3 Studio for fechada.

NOTA
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
executando, a licena de E3 Studio emprestada (que permite a execuo do
aplicativo por seis horas) liberada, e o E3 Server finaliza a execuo do
aplicativo imediatamente (em no mximo 10 segundos).

132 E3 Studio
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 podem acessar os arquivos
utilizando o mesmo caminho.

E3 Studio 133
CAPTULO
Domnios
3
Um Domnio um conjunto de objetos e configuraes que definem um
sistema de superviso. Corresponde ao Aplicativo no Elipse SCADA.

O E3 um ambiente modular de desenvolvimento e execuo de sistemas de

superviso, composto pelos mdulos descritos nas sees a seguir.

3.1 E3 Server
O E3 Server o coordenador de todos os mdulos do E3. Ele sempre
executa como servio, mesmo no modo Demo, seja ele registrado como
servio ou com o parmetro /regserver, e deve estar sempre em execuo.
Pode tambm ser iniciado quando um E3 Studio local for iniciado, ou atravs
de um atalho para executar 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 tempo de execuo (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.

134 Domnios
3.1.1 Licenciamento
O E3 Server suporta dois modos de licenciamento: Licena Ativa e Demo. O
modo de licenciamento definido na inicializao do servidor. Se h um
dispositivo de proteo vlido (do tipo Hardkey ou Softkey), o E3 Server
entra em modo Licena Ativa. Se nenhum dispositivo for localizado, entra em
modo Demo.

Se houver a troca do dispositivo, o E3 Server compara as licenas deste novo

dispositivo com as licenas do dispositivo anterior e executa os seguintes
ajustes:

Se as novas licenas forem exatamente iguais em limitaes s do

dispositivo anterior, so aplicadas imediatamente

Se as novas licenas forem menos limitadas do que as do dispositivo

anterior, tambm so aplicadas imediatamente

Se as novas licenas forem mais limitadas do que as do dispositivo

anterior, o E3 Server aguarda por um minuto para que o dispositivo
anterior seja reconectado. Ao final deste perodo, se as licenas
continuarem restritivas, o servidor reiniciado e as novas licenas so
aplicadas

NOTA
Para maiores informaes sobre licenciamento no E3, entre em contato com
o setor comercial da Elipse Software.

Domnios 135
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
executando

Quadrado cinza: O Domnio est

carregado, mas no executando

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 modo de espera

O E3Run sempre executa como servio, seja ele registrado como servio ou
com o parmetro /regserver. Este processo usa o protocolo REC para se
conectar fila de banco de dados do E3 Server.

136 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 um Domnio informado pelo usurio. O uso desta

opo no obrigatrio. Mesmo se no for informada, o Domnio
iniciado

-viewer ou /viewer: Executa o Viewer para a aplicao

-load: Semelhante opo -start, porm somente carrega o Domnio,

sem execut-lo. No pode ser usada com a opo -viewer

-stop: Para o Domnio em execuo, quando existir. Esta opo deve ser
utilizada sozinha

-close: Para e fecha o Domnio em execuo, quando existir. Esta opo

deve ser utilizada sozinha

-refresh: Fora a atualizao do Domnio sem a utilizao de um Viewer

-help: Mostra uma caixa de dilogo com as opes de linha de comando

para o E3 Admin, como na figura a seguir

Domnios 137
 Caixa de dilogo com as opes de linha de comando do E3 Admin

Se as opes -load, -start ou -viewer forem utilizadas, o Windows Vista ou

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

Caso o usurio logado no seja Administrador e a configurao do Controle

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

138 Domnios
 Mensagem de erro do E3 Admin

NOTA
O Windows deve ser reiniciado para que as configuraes do Controle de
Conta de Usurio sejam aplicadas.

Caso existam restries no Domnio, as opes -load, -stop, -refresh e -close

pedem o login do usurio do E3.

3.4 IOServer
O IOServer o processo responsvel pela execuo dos Drivers de
Comunicao. 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.

Domnios 139
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
Um Domnio constitudo dos arquivos descritos nas sees seguintes.

3.7.1 Arquivo de Configurao

O arquivo .dom armazena quatro tipos de informaes:

Opes de configurao do Domnio

Lista de arquivos .prj e .lib que contm os Tags, Telas, definies de

objetos, etc.

Configuraes dos servidores (computadores) que executam o Domnio

Configuraes de usurios e permisses de acesso

3.7.2 Arquivo de Projeto

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

3.7.3 Arquivo de Biblioteca

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

140 Domnios
3.8 Criando um Domnio
Existem duas maneiras de se criar um Domnio no E3:

Atravs do menu Arquivo - Novo Domnio. Para isto, necessrio que ao

menos um projeto ou uma biblioteca esteja aberto. Ao selecionar esta
opo, o E3 abre uma caixa de dilogo para a escolha do caminho e do
nome do novo Domnio

Criando um novo Domnio

A seguir, o usurio deve decidir se deseja incluir projetos ou bibliotecas

abertos no novo Domnio criado.

Domnios 141
 Confirmao de insero do projeto ou biblioteca no novo
Domnio

Atravs do Assistente de Aplicaes do E3, que permite a criao de um

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

142 Domnios
3.8.1 Assistente de Aplicaes
O Assistente de Aplicaes do E3 a ferramenta utilizada para criar um novo
Domnio com um projeto ou uma biblioteca. Esta opo pode ser acessada
das seguintes maneiras:

Clicando em Novo 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

Domnios 143
3.8.1.1 Tipo de Aplicao

Nesta tela, pode-se selecionar entre a criao de uma Aplicao padro,

uma Biblioteca de componentes do E3 ou uma Aplicao em branco.

Uma Aplicao padro aquela cujo projeto possui pelo menos um objeto
Viewer, uma Tela e um Servidor de Dados, tendo ainda a opo de inserir,
com a ajuda do Assistente, um Driver de Comunicao, um Banco de Dados,
um Servidor de Alarmes e uma Configurao de Alarmes.

NOTA
As telas Driver de Comunicao, Banco de Dados e Alarmes s so
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 selecionado na opo anterior).
O local onde a aplicao salva deve ser especificado no item Salvar a
aplicao na pasta. Caso seja necessrio, clique em Procurar.

144 Domnios
 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 em Avanar para prosseguir.

Domnios 145
NOTA
A opo Biblioteca de componentes do E3 discutida mais adiante, no
captulo Bibliotecas.

3.8.1.2 Domnio

Nesta tela, possvel decidir a qual Domnio pertence o projeto ou a

biblioteca que est sendo criado. A seleo da opo Adicionar no Domnio
ativo condicionada existncia de Domnios ativos no sistema. Clicando
nesta opo, o novo projeto faz parte do Domnio atual. A opo Criar um
novo Domnio cria um novo Domnio, ao qual o projeto ou biblioteca
pertence. O nome deste novo Domnio indicado na opo Entre com o
nome do Domnio. Por fim, com a opo No adicionar em nenhum
Domnio, o projeto ou biblioteca criado continua sem pertencer a nenhum
Domnio.

Tela Domnio

Clique em Avanar para prosseguir.

146 Domnios
3.8.1.3 Resoluo do Viewer

Nesta tela, o usurio pode configurar as propriedades do Viewer que definem

a resoluo de trabalho para a aplicao sendo criada, ou seja, a resoluo
do computador que executa a aplicao. Assim, as Telas que forem criadas
podem ter seus tamanhos definidos de forma que se ajustem janela do
Viewer sem a necessidade de barras de rolagem. A opo Resoluo da tela
permite selecionar dentre uma srie de resolues pr-definidas. J a opo
Avanado permite informar um valor personalizado.

Tela Resoluo do Viewer

Clique em Avanar para prosseguir.

Domnios 147
3.8.1.4 Driver de Comunicao

Nesta tela, o usurio pode decidir pela incluso de um objeto Driver de

Comunicao no projeto sendo criado. Caso positivo, possvel configurar o
arquivo .dll que este Driver utiliza, na opo Arquivo do driver de
comunicao. Para procurar o arquivo, clique em .

Tela Driver de Comunicao

Clique em Avanar para prosseguir.

148 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, clique em .

Tela Banco de Dados

Clique em Avanar para prosseguir.

Domnios 149
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 em Avanar para finalizar a criao da aplicao.

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

150 Domnios
 Tela final do Assistente de Aplicaes

Finalize o processo clicando em Concluir.

Domnios 151
3.9 Configuraes
Atravs do menu do E3 Admin na rea de Notificaes do Windows,
possvel executar, parar, atualizar ou fechar o Domnio diretamente atravs
das opes Executar, Parar, Atualizar e Fechar, respectivamente.

Alm disto, o Domnio tambm pode ser configurado para apresentar

redundncia e utilizar Domnios Remotos, entre outras aes. Estas
configuraes so realizadas atravs da opo Domnio - Opes.

Opes de configurao via rea de Notificaes do

Windows

NOTA
Os menus Domnio - Opes e Domnio - Exportar usurios no esto
disponveis 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.

152 Domnios
3.9.1 Aba Opes
Na aba Opes possvel habilitar a redundncia de servidores.

Aba Opes

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Opes

Domnios 153
 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 executado
e, opcionalmente, um servidor em
espera

Servidor principal Seleciona o nome do servidor

principal para execuo do Domnio.
Para cadastrar e configurar os
servidores, utilize a aba Servidores

Servidor de backup Se habilitada, seleciona um servidor

de backup para execuo do Domnio.
Este servidor permanece 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

154 Domnios
 OPO DESCRIO
Endereos para PING de O algoritmo de Hot-Standby exige
integridade da rede 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 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

Domnios 155
 OPO DESCRIO
Ativar backup em caso de falha Habilita a troca automtica de
local 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 executada se
o servidor de backup estiver sem
falhas

Tempo para ativao do servidor Permite indicar o tempo de ativao

reserva para o servidor de backup. O valor
padro 15 segundos. Este tempo
afeta diretamente o time-out do ping
entre os servidores. Se for muito
abaixo (troca em um segundo, time-
out de ping em 160 ms), podem
ocorrer trocas espontneas de
servidor, causadas por pequenas
falhas de rede

Perfil de pr-ativao do servidor Apresenta os seguintes perfis de pr-

reserva ativao disponveis:

Mnimo: Ativa apenas os servios

bsicos

Mximo: O E3 ativa o mximo de

objetos quando est em espera
(Associaes, Drivers, scripts e
Bancos de Dados)

Definido pelo usurio: O usurio

pode definir quais os servios
deseja ativar. Cada uma das opes
pode ser habilitada ou desabilitada
individualmente

156 Domnios
 OPO
Pr-ativar os seguintes servios
DESCRIO
Permite ao usurio selecionar 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
XFolders e XObjects sejam avaliadas
durante a ativao em espera

Drivers de E/S (sem comunicao):

O valor padro desabilitado. Se
habilitado, os IOServers so 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 conectado durante a
ativao em espera. Se desabilitado,
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 Verdadeiro

Domnios 157
NOTA
Quando o Domnio colocado em execuo, o E3 Server sempre seleciona 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 mantida uma cpia

atualizada dos arquivos do Domnio. O E3Run utiliza esta cpia local dos
arquivos PRJ e LIB

Abrir sempre o arquivo DOM da rede, utilizando o caminho de rede (por

exemplo, \\server\folder\Domnio.dom)

Quando utilizar o E3 Studio, sempre editar os projetos e bibliotecas da

cpia principal (na rede). Para aplicar as alteraes, copie os projetos e
bibliotecas alterados para o diretrio local dos servidores do Domnio.
Aps a cpia, clique em Executar Aplicativo no E3 Studio para que as
alteraes sejam aplicadas no processo de tempo de execuo (E3Run)

NOTA
A REDUNDNCIA NO EST DISPONVEL EM MODO DEMO. 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.

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

Aba Segurana

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Segurana

Domnios 159
 OPO DESCRIO
O usurio no pode alterar a sua Impede que o usurio troque a
senha 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 desabilitado

A senha deve conter no mnimo ... Determina a quantidade mnima de

caracteres caracteres para a senha do usurio

A senha deve conter letras e Determina que a senha do usurio

nmeros deve conter letras e nmeros

A senha deve conter no mnimo ... Determina a quantidade mnima de

nmeros nmeros na senha

A senha deve conter no mnimo ... Determina a quantidade mnima de

letras letras na senha

A senha deve conter letras Determina que a senha do usurio

maisculas e minsculas deve conter letras maisculas e
minsculas

Bloquear a conta do usurio aps Determina a quantidade mxima de

... falhas de login falhas de login para que a conta do
usurio seja bloqueada

Desbloquear o usurio Desbloqueia a conta do usurio

automaticamente aps ... minutos depois de determinados minutos

160 Domnios
 OPO
Avisar o usurio nos ltimos ...
dias antes da senha expirar
DESCRIO
Determina a data em que o sistema
comea a enviar mensagens dirias
ao usurio, avisando-o sobre a data
de expirao de sua senha. Aps
esta data, se o usurio no trocar
sua senha, ele bloqueado e
somente o administrador pode
desbloque-lo

Validar senhas sem diferenciar Permite que as senhas sejam

maisculas e minsculas validadas sem 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 time-out de
bloqueio expire.

Domnios 161
3.9.3 Aba Grupos de Viewers
possvel especificar, de acordo com o endereo IP do Viewer, se este pode
se conectar, e com qual tipo de licena (Viewer Full ou Viewer Only).

Com este recurso, possvel bloquear totalmente a conexo ou limitar a

quantidade e o tipo de licenas que so usadas simultaneamente para um
determinado grupo de endereos de IP.

Para acessar os grupos de Viewers, clique com o boto direito do mouse no

cone do E3 Admin na rea de Notificaes do Windows, selecione a opo
Domnio - Opes e clique na aba Grupos de Viewers. A janela da figura a
seguir mostrada.

Aba Grupos de Viewers

As opes disponveis nesta aba esto descritas na tabela a seguir.

162 Domnios
 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

Lista de IPs Especifica quais endereos de IP

pertencem ao grupo, e deste modo
compartilham os mesmos limites de
conexo. Quando um Viewer tenta se
conectar ao E3 Server, seu endereo
IP comparado aos grupos
existentes. Aps determinado o
grupo ao qual pertence, aplicada a
restrio de licenas a este Viewer,
configurada para aquele grupo

Adicionar / Editar / Remover Adiciona, edita ou remove os

endereos de IP. Quando um grupo
criado, ele no tem nenhum
endereo 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 endereos de IP vazia, o
sistema emite um aviso. Caso o
grupo seja mantido assim, ele no
tem utilidade

Permitir conexes de Viewer Full Quando selecionada, permite

conexes do tipo Viewer Full para o
grupo

Domnios 163
 OPO DESCRIO
Limitar uso de licenas simultneas Quando selecionada, limita o uso de
licenas do tipo Viewer Full
simultneas a um determinado
nmero. Se a opo anterior estiver
selecionada, mas esta estiver
desmarcada, o uso de licenas
simultneas ilimitado

Permitir conexes de Viewer Only Quando selecionada, permite

conexes do tipo Viewer Only para
o grupo

Limitar uso de licenas simultneas Quando selecionado, limita o uso de

licenas do tipo Viewer Only
simultneas a um determinado
nmero. Se a opo anterior estiver
selecionada, mas esta estiver
desmarcada, o uso de licenas
simultneas ilimitado

164 Domnios
 importante notar que estes limites so aplicados aps o limite do E3 Server,
como configurado no dispositivo de proteo. Por exemplo, se o dispositivo
de proteo possuir dez licenas de Viewer e o grupo especificar cinco
conexes no mximo, apenas estas cinco so usadas. No entanto, se o
dispositivo de proteo possuir cinco licenas de Viewer e o grupo especificar
dez conexes no mximo, utilizado o limite de cinco conexes do
dispositivo. Ou seja, o grupo de Viewer tem sempre uma limitao de licenas
adicional a ser aplicada na conexo do Viewer.

A configurao de Grupos de Viewers deve ser realizada preferencialmente

com o Domnio parado. Caso seja realizada com o Domnio em execuo, ela
no tem efeito at que todos os Viewers sejam desconectados.

NOTAS
No caso de conexes identificadas como E3AccessLayer e E3DataAccess,
que por padro no consomem licenas do E3 Server, o comportamento
dos Grupos de Viewers o seguinte:
Se o Grupo de Viewers no permitir conexes do tipo Viewer Full nem do
tipo Viewer Only, a conexo negada
Se o Grupo de Viewers permitir conexes do tipo Viewer Full, a conexo
permitida e obedece ao tipo de acesso requisitado. Por exemplo, para
acessos do tipo Viewer Only a conexo apenas de leitura, e para
acessos do tipo Viewer Full a conexo de leitura e escrita
Se o Grupo de Viewers permitir apenas conexes do tipo Viewer Only, a
conexo permitida e somente de leitura, mesmo para acessos do tipo
Viewer Full

Domnios 165
3.9.4 Aba Registro de Eventos
Os eventos dividem-se em duas categorias: Eventos Padro do Sistema e
Eventos Manuais.

Eventos Padro do Sistema so os eventos gerados automaticamente pelo

E3, e que podem ter o registro habilitado ou desabilitado individualmente:

Login ou logout de usurio

Troca de senha de usurio

Falha de login de usurio

Alterao na base de dados de usurio

Bloqueio de conta de usurio

Incio ou trmino do Domnio

Alterao no Domnio (inserir, remover, habilitar ou desabilitar projetos e

bibliotecas, alterar a configurao do Domnio)

Atualizao do Domnio (quando o usurio aplica as alteraes realizadas

em projetos, atravs do E3 Studio)

Troca manual de servidor Hot-Standby

Criao de usurio

Mudana de usurio

Remoo de usurio

Renomeao de usurio

Mudana em diretivas de usurio

Criao de grupo

Mudana de grupo

Remoo de grupo

166 Domnios
 Renomeao de grupo

Mudana em diretivas de grupo

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 utilizar o mtodo

Application.TrackEvent e o evento enviado para o E3 Server.

O diagrama a seguir mostra como os diferentes processos do E3 geram e

tratam os eventos do sistema.

Diagrama de processos

Cada E3 Server mantm uma lista interna dos eventos que devem ser
registrados no Banco de Dados. Estes eventos podem vir de trs fontes:

Eventos gerados nos Viewers (usando o mtodo Application.TrackEvent)

Eventos gerados internamente no E3 Server

Domnios 167
 Eventos gerados no E3 Server Standby

O E3 Server Standby, de tempos em tempos, envia a lista de eventos para o

E3 Server Hot, pois apenas este tem condies de gravar eventos no Banco
de Dados. Os eventos so colocados na fila de eventos do Hot, juntamente
com os demais eventos do sistema, isto , o servidor Hot centraliza a
gravao de eventos.

Se houver uma troca de servidor, os eventos que no haviam sido gravados

so passados automaticamente para o novo servidor Hot.

O E3Run grava no Banco de Dados os registros enviados pelo E3 Server Hot.

O E3 Server informa o nome do Servidor de Dados e da tabela onde os
dados so gravados.

Para configurar o registro de eventos do E3, clique com o boto direito do

mouse no cone do E3 Admin na rea de Notificao do Windows, selecione a
opo Domnio - Opes, e clique na aba Registro de Eventos. A janela da
figura a seguir mostrada.

168 Domnios
 Aba Registro de Eventos

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Registro de Eventos

OPO
Registrar os eventos do sistema
em uma tabela no Banco de
Dados do aplicativo
DESCRIO
Habilita o registro de eventos no E3.
Ao selecionar esta opo, a opo
Nome da tabela deve ser
obrigatoriamente preenchida

Domnios 169
 OPO DESCRIO
Nome da tabela Indique o nome da tabela onde so
gravados os eventos. A tabela
informada criada automaticamente
pelo E3Run, e tem 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)

Selecionar automaticamente um Habilite esta opo para deixar que o

Banco de Dados no aplicativo
E3Run selecione um objeto Servidor
de Dados para gravar os dados. Se o
aplicativo possui apenas um Servidor
de Dados, este objeto usado. Se
possuir mais de um, recomendado
selecionar a opo Usar este Banco
de Dados

170 Domnios
 OPO DESCRIO
Usar este Banco de Dados Habilite esta opo para especificar o
Servidor de Dados onde so
gravados os eventos. Se o nome do
Servidor de Dados foi informado
incorretamente, os eventos
permanecem armazenados na fila de
eventos do E3 Server (em memria),
at que seja indicado um Servidor de
Dados vlido

Marque abaixo os eventos que Lista os eventos disponveis no

devem ser registrados sistema para serem registrados

Domnios 171
Se o E3Run tiver que escolher entre vrios Servidores de Dados, normalmente
utilizado o primeiro Banco de Dados ativado na execuo do Domnio. Se
durante a execuo do Domnio, o usurio desabilitar o projeto que contm o
Servidor de Dados que estava sendo usado para gravar os eventos, o E3Run
automaticamente seleciona outro Servidor de Dados que esteja disponvel no
aplicativo, e continua com este Servidor de Dados at que o Servidor de
Dados anterior seja reativado. Isto implica que, se houver mais de um
Servidor de Dados no projeto, possvel que alguns eventos sejam gravados
em um Servidor de Dados e outros eventos em outro Servidor de Dados (por
isto, recomendado indicar um Servidor de Dados especfico, quando houver
mais de um Servidor de Dados no projeto).

Quando um evento selecionado na lista e a tecla F2 pressionada, abre-se

uma caixa de dilogo para edio do evento. A janela mostrada na figura a
seguir mostrada.

Edio de eventos

Desmarque a opo Usar mensagem padro para alterar a mensagem do

evento. Clique em para inserir uma macro dentro da mensagem. Apenas
as macros permitidas para aquele evento so mostradas.

172 Domnios
 Visualizao da macro disponvel para o evento

As macros sempre tm o formato %MACRO%. As seguintes macros podem

ser usadas:

%%: Insere um sinal de % (porcentagem) na mensagem

%NAME%: Insere o nome do usurio ou grupo que foi afetado por este
evento

%NEWNAME%: Insere o novo nome de um usurio ou grupo que foi

renomeado por este evento

%USER%: Insere o nome do usurio que gerou o evento (ou "Annimo",

se no houver nenhum usurio logado)

%MACHINE%: Insere o nome do computador onde o evento foi gerado

%SESSION%: Insere o nome do programa onde o usurio estava logado

(Viewer, Studio ou E3 Server)

%CAUSE%: Informao adicional sobre o evento

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

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

Domnios 173
Se o usurio Admin escrever uma senha errada enquanto executa o login no
Viewer que est executando na mquina CLIENT004, gerado o seguinte
evento:
"Falhou login do usurio Admin no computador CLIENT004 (usando
um Viewer): login ou senha incorretos"

Os eventos padro do sistema so descritos nas sees seguintes.

3.9.4.1 Login de Usurios

Usurio %User% logou no %SESSION% na mquina %MACHINE%

Gerado sempre que ocorrer um login bem sucedido de um usurio no E3

Studio ou no Viewer, onde:

%USER% contm o nome de login do usurio

%SESSION% contm "Viewer" ou "Studio"

%MACHINE% contm o nome do computador onde o usurio est

logado

3.9.4.2 Logout de Usurios

Usurio %User% terminou a sesso de uso de %SESSION% na
mquina %MACHINE%

Gerado sempre que ocorrer o logout de um usurio no E3 Studio ou no

Viewer (ou quando o programa fechado sem logout. Neste caso, o logout
automtico), onde:

%USER% contm o nome de login do usurio

%SESSION% contm "Viewer" ou "Studio"

%MACHINE% contm o nome do computador onde o usurio estava

logado

174 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 (utilizando o mtodo

ChangePassword no Viewer), onde:

%USER% contm o nome de login do usurio que teve a senha trocada

3.9.4.4 Falha de Login

O login do usurio %USER% no %SESSION% na mquina %
MACHINE% falhou: %CAUSE%

Gerado sempre que falhar o login de um usurio no Viewer ou no E3 Studio,

onde:

%USER% contm o nome de login informado

%SESSION% contm "Viewer" ou "Studio"

%MACHINE% contm o nome do computador onde o usurio tentou

logar

%CAUSE% pode ser login ou senha incorretos, conta desabilitada, conta

bloqueada, senha expirada ou erro 0xnnnnnnn

3.9.4.5 Base de Usurios Alterada

Usurio %USER% alterou a base de usurios

Gerado sempre que a base de usurios for alterada (normalmente atravs da

opo Arquivos - Usurio do E3 Studio), onde:

%USER% contm o nome de login do usurio que editou a base de

usurios (ou "Annimo" se no havia nenhum usurio logado)

Domnios 175
3.9.4.6 Conta Bloqueada
A conta do usurio %USER% foi bloqueada

Gerado sempre que a conta de um usurio bloqueada por excesso de logins

errados, onde:

%USER% contm o nome de login do usurio que teve a conta bloqueada

3.9.4.7 Domnio Iniciado

Domnio iniciado pelo usurio %USER% no %SESSION% na
mquina %MACHINE%

Gerado sempre que o Domnio iniciado (colocado em execuo), onde:

%USER% contm o nome de login do usurio que colocou o Domnio em

execuo (ou "Annimo" se no foi pedida autenticao quando o
Domnio foi executado)

%SESSION% contm "Studio" ou "E3 Server" (menu da rea de

Notificaes do Windows)

%MACHINE% contm o nome do computador onde foi gerado o

comando para executar o Domnio

3.9.4.8 Domnio Finalizado

Domnio finalizado pelo usurio %USER% no %SESSION% na
mquina %MACHINE%

Gerado sempre que o Domnio parado, onde:

%USER% contm o nome de login do usurio que parou o Domnio (ou

"Annimo", se no foi pedida autenticao quando o Domnio foi parado)

%SESSION% contm "Studio" ou "E3 Server" (menu da rea de

Notificaes do Windows)

%MACHINE% contm o nome do computador onde foi gerado o

comando de parar o Domnio

176 Domnios
3.9.4.9 Domnio Atualizado
Domnio atualizado pelo usurio %USER% no %SESSION% na
mquina %MACHINE%

Gerado sempre que o Domnio atualizado ao clicar em Executar aplicativo

no E3 Studio, isto , quando so aplicadas no E3Run as alteraes feitas em
arquivos PRJ e LIB, onde:

%USER% contm o nome de login do usurio logado no E3 Studio (ou

"Annimo", se no h nenhum usurio logado)

%SESSION% contm "Studio"

%MACHINE% contm o nome do computador onde o E3 Studio estava

executando

3.9.4.10 Domnio Modificado

Domnio modificado pelo usurio %USER% no %SESSION% na
mquina %MACHINE%: %CAUSE%

Gerado sempre que o arquivo do Domnio (.dom) modificado, onde:

%USER% contm o nome do usurio que alterou o Domnio

%SESSION% contm "Studio" ou "E3 Server"

%MACHINE% contm o nome do computador onde foi gerado o

comando de modificar o Domnio

%CAUSE% pode ser:

Aplicadas alteraes na janela do computador de edio do Domnio

Adicionado projeto "nomedoprojeto" (habilitado)

Adicionado projeto "nomedoprojeto" (desabilitado)

Removido projeto "nomedoprojeto"

Desabilitado projeto "nomedoprojeto"

Domnios 177
3.9.4.11 Troca Manual de Servidores
Servidor reserva ativado pelo usurio '%USER%' no '%SESSION%'
na mquina '%MACHINE%'

Gerado sempre que forada a ativao do servidor de backup de um

Domnio, atravs da opo Servidor - Ativar do menu do E3 Server, onde:

%USER% contm o nome de login do usurio que ativou o servidor de

backup (ou "Annimo" se no foi pedida autenticao quando o servidor
foi ativado)

%SESSION% contm "E3 Server" (menu da rea de Notificaes do

Windows)

%MACHINE% contm o nome do computador onde foi gerado o

comando para ativar o servidor de backup

3.9.4.12 Usurio Criado

O usurio '%NAME%' foi criado por '%USER%'

Gerado sempre que um usurio criado, onde:

%NAME%: Nome do usurio criado

%USER%: Nome do usurio que procedeu a criao do usurio

3.9.4.13 Usurio Modificado

O usurio '%NAME%' foi modificado por '%USER%'. '%CAUSE%'

Gerado sempre que um usurio modificado, onde:

%NAME%: Nome do usurio que foi modificado

%USER%: Nome do usurio que procedeu a modificao do usurio

%CAUSE%: Causa da modificao do usurio. A mensagem mostrada

est no formato "'nomedousuario' modificado de 'nomeanterior' para
'novonome'"

178 Domnios
3.9.4.14 Usurio Removido
O usurio '%NAME%' foi removido por '%USER%'

Gerado sempre que um usurio removido, onde:

%NAME%: Nome do usurio que foi removido

%USER%: Nome do usurio que procedeu a remoo do usurio

3.9.4.15 Usurio Renomeado

O usurio '%NAME%' foi renomeado para '%NEWNAME%' por '%
USER%'

Gerado sempre que um usurio renomeado, onde:

%NAME%: Nome do usurio que foi renomeado

%NEWNAME%: Novo nome do usurio que foi renomeado

%USER%: Nome do usurio que procedeu a renomeao do usurio

3.9.4.16 Diretivas de Usurio

Os direitos do usurio '%NAME%' foram modificados por '%USER
%'

Gerado sempre que os direitos de um usurio so modificados, onde:

%NAME%: Nome do usurio cujos direitos foram modificados

%USER%: Nome do usurio que procedeu a modificao nos direitos do

usurio

Domnios 179
3.9.4.17 Grupo Criado
O grupo '%NAME%' foi criado por '%USER%'

Gerado sempre que um grupo criado, onde:

%NAME%: Nome do grupo criado

%USER%: Nome do usurio que procedeu a criao do grupo

3.9.4.18 Grupo Modificado

O grupo '%NAME%' foi modificado por '%USER%'. '%CAUSE%'

Gerado sempre que um grupo modificado, onde:

%NAME%: Nome do grupo que foi modificado

%USER%: Nome do usurio que procedeu a modificao do grupo

%CAUSE%: Causa da modificao do grupo. A mensagem mostrada est

no formato "'nomedogrupo' modificado de 'nomeanterior' para
'novonome'"

3.9.4.19 Grupo Removido

O grupo '%NAME%' foi removido por '%USER%'

Gerado sempre que um grupo removido, onde:

%NAME%: Nome do grupo que foi removido

%USER%: Nome do usurio que procedeu a remoo do grupo

180 Domnios
3.9.4.20 Grupo Renomeado
O grupo '%NAME%' foi renomeado para '%NEWNAME%' por '%
USER%'

Gerado sempre que um grupo renomeado, onde:

%NAME%: Nome do grupo que foi renomeado

%NEWNAME%: Novo nome do grupo que foi renomeado

%USER%: Nome do usurio que procedeu a renomeao do grupo

3.9.4.21 Diretivas de Grupo

Os direitos do grupo '%NAME%' foram modificados por '%USER
%'

Gerado sempre que os direitos de um grupo so modificados, onde:

%NAME%: Nome do grupo cujos direitos foram modificados

%USER%: Nome do usurio que procedeu a modificao nos direitos do

grupo

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

Aba Projetos

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Projetos

OPO DESCRIO
Nome Esta opo lista os nomes dos
projetos no sistema

182 Domnios
 OPO DESCRIO
Adicionar / Remover Atravs destas opes, pode-se
remover ou adicionar projetos no
sistema. Para adicionar um projeto,
clique em Adicionar e especifique o
campo Nome do projeto. Para
remover um projeto, selecione-o e
clique em 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 Esta opo permite desabilitar a

desabilitada) execuo do projeto, evitando a
ocorrncia de erros quando o
Domnio executado. Quando a
opo habilitada, o cone indica
que o projeto no utilizado. Os
projetos com o cone esto
habilitados e so executados

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

Aba Servidores

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Servidores

184 Domnios
 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, clique em Adicionar e
especifique os campos Nome do
servidor e Identificao do servidor
na rede. Para adicionar um servidor
local, especifique o item Caminho
local de acesso aos arquivos de
Domnio. Para remover um projeto,
selecione-o na lista e clique em
Remover

Nome do servidor Determina o nome do servidor. Este

nome definido pelo usurio

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 Indica a pasta onde esto localizados

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

Domnios 185
 OPO DESCRIO
Em manuteno (execuo Esta opo permite desabilitar o
desabilitada) servidor e no utiliz-lo na execuo
do Domnio. Quando a opo
habilitada, o cone indica que o
servidor no utilizado. Do contrrio,
o cone indica que o servidor pode
ser utilizado

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

Aba Domnios Remotos

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Domnios Remotos

OPO DESCRIO
Nome Esta opo lista os nomes dos
Domnios Remotos no sistema

Domnios 187
 OPO DESCRIO
Adicionar / Remover Atravs destas opes, pode-se
remover ou adicionar Domnios
Remotos no sistema. Para adicionar
um Domnio Remoto em rede, clique
em Adicionar e especifique os
campos Nome e Arquivo de
Domnio. Para remover um Domnio,
selecione-o na lista e clique em
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 campos Usurio
e Senha so habilitados

Usurio Identifica o usurio

Senha Permite a conexo ao Domnio

atravs de senha

188 Domnios
 possvel que uma configurao de Domnio Remoto possibilite a conexo ao
prprio Domnio local. A isto 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 executando para que tudo funcione
localmente. Neste caso, para que a configurao funcione no E3 Studio, no
campo Arquivo de Domnio, basta digitar diretamente o caminho local do
arquivo DOM (por exemplo, c:\caminho\arquivo.dom).

NOTAS
A mudana dos aliases locais com o Domnio executando NO
suportada. O que acontece que, se o Domnio estiver executando, Links
j resolvidos como locais continuam sempre locais, mesmo que o alias
seja reconfigurado para conectar em uma mquina remota realmente.
Para contornar isto, reinicie o Domnio
As conexes do tipo loopback no aparecem na janela Licenas (ou
Estatsticas) do E3 Admin e nem necessitam de licena de Domnios
Remotos para funcionar
* Para que o nome localhost funcione, necessrio que ele esteja
configurado para apontar para o endereo IP 127.0.0.1 (que a
configurao padro do Windows)
Para maiores informaes sobre as configuraes da aba Domnios
Remotos, veja o tpico Configurao da Conexo

Domnios 189
3.9.8 Aba Propriedades
Permite controlar configuraes diversas do Domnio. Para acessar este item,
clique com o boto direito do mouse no cone do E3 Admin na rea de
Notificaes do Windows, selecione a opo Domnio - Opes e clique na
aba Propriedades. A janela da figura a seguir mostrada.

Aba Propriedades

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Propriedades

190 Domnios
 OPO DESCRIO
Pool Habilitado Habilita ou desabilita o pool de
processos IOServer. NOTA:
Certifique-se que os Drivers em uso
na aplicao suportam o recurso de
pool de processos (os Drivers devem
ter sido compilados com o IOKit
verso 2.0.6 ou superior). Os Drivers
que no suportam este recurso
devem ser configurados com a
propriedade DisableIOServerPool
em Verdadeiro. O valor padro
desta opo Falso

Drivers por Processo Define o nmero mximo de Drivers

que executam em cada processo do
IOServer. NOTA: Este limite pode ser
ultrapassado caso o nmero de
processos do pool chegue ao
mximo configurado na opo
Nmero Mximo de Processos. O
valor padro desta opo 0 (zero)

Nmero Mximo de Processos Define o nmero mximo de

processos IOServer que so criados
pelo pool. O valor 0 (zero, padro)
nesta opo permite um nmero
ilimitado de processos

Esta configurao pode ser alterada com o Domnio em execuo, porm

somente afeta os Drivers iniciados aps a alterao, ou nas situaes em que
o Domnio atualizado:

Ao clicar em Executar Aplicativo no E3 Studio

Ao selecionar a opo Domnio - Atualizar, no menu do E3 Admin na

rea de Notificaes do Windows

Domnios 191
 Ao gerar um evento que force o E3Run a receber a configurao do
Domnio

NOTA
Para maiores informaes, veja o tpico Pool de Processos IOServer no
captulo Drivers.

3.10 Outras Opes da rea de Notificao

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

192 Domnios
3.10.1 Exportar Usurios
Esta opo permite exportar uma lista, em formato CSV (Comma-Separated
Values), de todos os usurios configurados no Domnio atual. Ao utilizar esta
opo, a janela da figura a seguir aberta para selecionar um diretrio para
salvar o arquivo.

Janela Exportao de Usurios

NOTAS
Esta opo no est disponvel em modo Demo.
Esta opo deve ser realizada por um usurio com a permisso
Configurar usurios/grupos.
Usurios selecionados como Administradores sempre tm permisso
para configurar usurios e grupos, mesmo que esta opo tenha sido
explicitamente negada na janela Permisses do usurio.
Esta opo sempre exporta todas as informaes sobre todos os usurios
configurados no Domnio atual.

Domnios 193
3.10.2 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 executando 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 selecionar o
servidor e outras opes, como descrito no tpico E3 Viewer e E3
WebViewer - Execuo do E3 Viewer - Execuo Atrves do Menu Iniciar.

194 Domnios
3.10.3 Licenas
possvel visualizar as diversas licenas disponveis atravs do E3 Admin. Para
isto, clique com o boto direito do mouse no cone do E3 Admin na rea de
Notificaes do Windows e selecione a opo Licenas. A janela da figura a
seguir mostrada.

Janela E3 Admin - Licenas

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela E3 Admin - Licenas

Domnios 195
 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 preenchido com zeros

E3 Server Indica o tipo de E3 Server

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

196 Domnios
 OPO DESCRIO
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.

NOTA
Os usurios logados e identificados como E3DataAccess e E3AccessLayer,
na coluna Programa da lista Usurios Logados, no consomem licenas de
Viewer de um E3 Server.

Domnios 197
3.10.4 Estatsticas
A janela E3 Admin - Estatsticas de Comunicao mostra os dados em
tempo real sobre o trfego de informaes na rede. A lista atualizada
automaticamente a cada segundo. Para isto, clique com o boto direito do
mouse no cone do E3 Admin na rea de Notificaes do Windows e
selecione a opo Estatsticas.

Janela E3 Admin - Estatsticas de Comunicao

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela E3 Admin - Estatsticas de Comunicao

OPO DESCRIO
Programa Mostra o nome da aplicao
conectada ao E3 Server

Computador Mostra o nome da mquina

conectada ao E3 Server

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

198 Domnios
 OPO DESCRIO
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 a data e hora em que o

programa iniciou a conexo

Domnios 199
3.10.5 Monitor
A janela E3 Admin - Monitor mostra informaes em tempo real sobre o
estado dos servidores do Domnio. Para isto, clique com o boto direito do
mouse no cone do E3 Admin na rea de Notificaes do Windows e
selecione a opo Monitor.

Janela E3 Admin - Monitor

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela E3 Admin - 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

200 Domnios
 OPO DESCRIO
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

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 executar o Domnio.
Este indicador faz com que o
servidor ativo passe para o modo
Standby

Candidato: O servidor candidato

a executar o Domnio

E/S: O servidor possui IOServers

ativos

Domnios 201
3.10.6 Inicializao
Esta opo permite controlar o Domnio a ser iniciado automaticamente. O
Domnio configurado s executado se o E3 Server no estiver em modo
Demo. Para isto, clique com o boto direito do mouse no cone do E3 Admin
na rea de Notificaes do Windows e selecione a opo Inicializao. A
janela da figura a seguir mostrada.

Janela E3 Admin - Inicializao

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela E3 Admin - Inicializao

OPO DESCRIO
O Domnio carregado Ao iniciar, executa automaticamente
o Domnio previamente carregado

O Domnio configurado Ao iniciar, executa automaticamente

o Domnio configurado pelo usurio

Nenhum Domnio No inicia nenhum Domnio

202 Domnios
3.10.7 Impressora
Esta opo mostra a lista das impressoras encontradas local ou remotamente,
e permite que o usurio seleciona uma para ser usada pelo E3 Server. Para
isto, clique com o boto direito do mouse no cone do E3 Admin na rea de
Notificaes do Windows e selecione a opo Impressora. A janela da figura
a seguir mostrada.

Janela E3 Admin - Impressora

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela E3 Admin - 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 selecionar outra impressora

na rede e estabelecer uma conexo

Domnios 203
3.10.8 Sobre o E3 Admin
Esta opo mostra a verso do E3 Admin.

3.10.9 Iniciar ou Parar o E3 Server

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

3.10.10 Fechar o E3 Admin

O E3 Admin pode ser fechado sem precisar fechar o E3 Server, atravs da
opo Fechar E3 Admin. Quando isto acontece, o E3 Server continua
executando, 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 executando o E3 Server.

A qualquer momento, o E3 Admin pode ser reiniciado para controlar o E3

Server em execuo, bastando para isto iniciar o E3 Admin sem nenhum
parmetro. O instalador tambm cria um atalho para abrir o E3 Admin
diretamente.

3.11 Domnios Remotos

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

204 Domnios
3.11.1 Configurao da Conexo
A configurao das conexes com outros Domnios do E3 deve ser realizada
no Domnio Cliente, clicando com o boto direito do mouse no cone do E3
Admin na rea de Notificaes do Windows, selecionando a opo Domnios
- Opes e ento selecionando a aba Domnios Remotos.

Aba Domnios Remotos

Neste caso, o Domnio referenciado pela configurao o Domnio Servidor.

possvel tambm que os Domnios se referenciem entre si, sendo ao mesmo
tempo servidores e clientes de Domnios Remotos. Para configurar o uso de
um Domnio Remoto, siga estes procedimentos:

Domnios 205
1. Informe um apelido para o Domnio Remoto no campo Nome do
Domnio. Este campo no sensvel a maisculas ou minsculas. Este
nome usado na aplicao para referenciar os objetos a serem
acessados no Domnio Remoto.

2. Especifique o caminho do arquivo .dom do Domnio Remoto. Este

caminho deve ser um compartilhamento na rede que permita acessar este
arquivo .dom.

3. Informe o nome do servidor principal, que deve ser o servidor contendo o

Domnio Remoto especificado no caminho do arquivo .dom. Esta
configurao utilizada para encontrar os objetos do Domnio Remoto
em tempo de execuo.

O item Servidores e opes de conexo contm a opo Avanado, que

permite realizar configuraes especficas da conexo entre os Domnios,
atravs da janela mostrada na figura a seguir.

Janela Opes de Conexo

As opes desta janela esto descritas na tabela a seguir.

206 Domnios
 Opes disponveis na janela Opes 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

Tempo limite de chamada (ms) Esta opo controla o tempo

mximo que o Domnio Remoto
Cliente espera pelo retorno de uma
chamada ao Domnio Remoto
Servidor. Se este tempo for
excedido, a conexo desfeita pelo
cliente, mesmo que os limites
estabelecidos pelas opes Verificar
PING e Utilizar heartbeat na
conexo ainda no tenham sido
excedidos. O valor padro desta
opo 0 (zero), que desabilita o
tempo limite

Domnios 207
 OPO DESCRIO
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 (time-out). Se no
houver resposta, por qualquer
motivo, considera-se que o
computador est fora da rede, ou
desligado. Esta 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

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

208 Domnios
 OPO
Utilizar criao assncrona de links
DESCRIO
Se esta opo estiver selecionada,
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 aplicaes
desenvolvidas em verses anteriores
falham 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
selecionadas.

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 realizada com o Domnio correto, em tempo de execuo. Assim,
se o nome do Domnio carregado no E3 Server remoto no for o correto, a
conexo no completada e os objetos remotos no ficam acessveis.

Domnios 209
Outra possibilidade manter uma cpia do Domnio Remoto na mquina
Cliente, e digitar o caminho desta cpia no campo Arquivo de Domnio.
Desta forma, o E3 Studio vai utilizar a cpia local para determinar quais
objetos existem, permitindo o trabalho offline. A cpia deve obrigatoriamente
ter o mesmo nome do Domnio Remoto para que a conexo funcione, no
sendo necessrio possuir a mesma hierarquia de diretrios.

Alm disto, para que a conexo entre os Domnios possa ocorrer, todos os E3
Servers envolvidos devem executar 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 executar os E3

Servers para que as conexes remotas sejam estabelecidas.

NOTA
Para maiores informaes sobre a configurao de Domnios Remotos, veja
o tpico Configuraes de Domnio - Domnios Remotos.

3.11.2 Licenas
Tanto o E3 Server executando o Domnio Cliente, quanto o que executa o
Domnio Servidor, devem ter licenas especficas para Domnios Remotos.

Quando esta licena existe, o E3 Server Servidor passa a aceitar um nmero

ilimitado de conexes externas de outros Domnios. Da mesma forma, no
caso do E3 Server Cliente, possvel estabelecer um nmero ilimitado de
conexes. Para maiores informaes sobre as limitaes do modo Demo do
E3, veja o tpico Limitaes do Modo Demonstrao.

210 Domnios
3.11.3 Sintaxe dos Links
Com a configurao de Domnios Remotos, o Domnio Cliente pode acessar
objetos do Domnio Servidor de duas maneiras: Atravs de scripts, utilizando
o mtodo Application.GetObject; ou atravs de Links, ou seja, de qualquer
funcionalidade que crie uma conexo com outro objeto (expresses de
eventos de usurio, propriedades do tipo Objeto de ElipseX, fontes de
Associaes, de Alarmes ou de campos de Histricos e Storages, entre
outros). Os objetos acessados desta forma podem tanto ser objetos do
Viewer quanto do Servidor.

O acesso aos objetos de outro Domnio realizado atravs do apelido

(Nome de Domnio), que deve preceder o caminho completo de cada objeto,
separado por dois pontos. Ou seja, para que as fontes de Links ou o
comando Application.GetObject referenciem outro Domnio, deve-se usar a
sintaxe DOMINIO:CAMINHO, onde DOMINIO o apelido dado quela
conexo com o Domnio Remoto, e CAMINHO o caminho completo de um
objeto ou propriedade daquele Domnio. No caso de Links, as fontes podem
incluir expresses com referncias a vrios objetos, podendo haver
combinaes entre objetos locais e de Domnios Remotos. Por exemplo,
Driver1.Tag1 + Remoto:Driver2.Tag1 * 2.

O nome do Domnio Remoto tambm pode necessitar de colchetes, como por

exemplo [DOMINIO]:CAMINHO. Neste caso, aplicam-se as mesmas regras
de nomes de objetos. Necessita de colchetes o nome do Domnio que:

Comea com um caractere que no seja uma letra (sem acentos nem "")

Possui um caractere qualquer que no seja uma letra (sem acentos nem
""), um algarismo (0-9) ou o caractere de sublinhado

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

Permisses de usurio

212 Domnios
Com isto, pode ser necessrio que a conexo com o Domnio Remoto
especifique um determinado usurio para poder ter acesso completo aos
objetos do Domnio. Este usurio deve ser especificado no campo Usurio no
Domnio atravs da opo Utilizar a seguinte conta, na aba Domnios
Remotos da configurao do Domnio Cliente. Ali devem ser especificados o
login e senha de um usurio existente no Domnio sendo acessado
remotamente.

Alm do acesso em modo Somente Leitura, possvel bloquear

completamente o acesso remoto, o que exige que a conexo com o Domnio
Remoto especifique um determinado usurio para poder ganhar acesso aos
objetos remotos. Isto feito atravs da permisso Acesso remoto ao
Domnio, tambm do item de segurana Domnio.

NOTA
A permisso Acesso remoto ao Domnio sempre tem precedncia sobre a
permisso Acesso remoto de escrita ao Domnio. Isto significa que, quando
a primeira permisso for negada, a segunda no 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 isto, basta apenas especificar os nomes dos dois servidores
(principal e backup) nos itens respectivos da rea Identificao dos
servidores na rede, na aba Domnios Remotos. importante ressaltar que,
para o correto funcionamento do Hot-Standby, estes nomes devem ser os
mesmos especificados pelo Domnio Remoto acessado. Uma vez que haja
esta configurao em tempo de execuo, o E3 Server sempre tenta conectar-
se aos dois servidores, direcionando o acesso de todos os comandos
Application.GetObject e Links para o primeiro servidor que possa ser
acessado e que indique estar executando o Domnio. Caso os nomes dos
servidores sejam modificados quando o Domnio Cliente estiver em execuo,
este se desconecta e reinicia a conexo com os novos servidores.

Domnios 213
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 executando.

Neste processo, a conexo refeita sempre que houver algum problema.
Aps ser encontrado o Domnio executando, 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.

214 Domnios
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 executando o E3 Server

O E3 Server do Servidor no est com o Domnio correto, ou o Domnio

no foi iniciado

O Domnio Servidor no aceita o usurio especificado pelo Domnio

Cliente

O E3 Server do Cliente ou do Servidor no possui licena de Domnio

Remoto

O E3 Server do Servidor de uma verso antiga (2.5 ou inferior)

Existe um firewall bloqueando a porta utilizada pelo REC, ou o Cliente e o

Servidor esto usando portas diferentes

O apelido do Domnio no existe na configurao de Domnio Remoto

Quando uma destas situaes ocorrer, todos os Links do Cliente

referenciando o Domnio so desconectados, assim como todos os mtodos
Application.GetObject referenciando o Domnio Remoto falham, ou seja,
causam erros de script. Quando o problema for resolvido, os Links devem
conectar-se automaticamente. J os comandos de Application.GetObject
devem ser executados novamente.

Domnios 215
3.12 Gerando Logs no E3
O E3 gera logs no formato ETL (Event Trace Log). Estes arquivos de log so
gerenciados por uma ferramenta da Elipse Software chamada Elipse Event
Log Viewer, disponvel com a instalao do E3. Com esta ferramenta
possvel visualizar os arquivos e gerenciar o espao que estes ocupam em
disco, entre outras configuraes. Para mais informaes sobre a ferramenta
Elipse Event Log Viewer, consulte o Manual do Usurio do Elipse Event
Log, disponvel no menu Iniciar - Programas - Elipse Software - Elipse Event
Log. O aplicativo Elipse Event Log Viewer pode ser aberto de trs formas:

Pelo menu Iniciar - Programas - Elipse Software - Elipse Event Log -

Log Viewer

Pelo menu Ferramentas - Log Viewer do E3 Studio

Pelo item Atalhos - Log Viewer do menu do E3 Admin na rea de

Notificao do Windows

216 Domnios
 CAPTULO
Drivers
4
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.

NOTAS
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, Elemento de Bloco OPC, Driver de
Comunicao OPC UA, Assinatura OPC UA, Pasta OPC UA, Tag de
Comunicao OPC UA, Bloco de Comunicao OPC UA e Elemento de
Bloco OPC UA) podem ser configurados para funcionarem como reas de
Alarme.
Todas as opes do editor dos objetos de Drivers que esto disponveis
via menu contextual (atravs do clique com o boto direito do mouse)
tambm esto disponveis utilizando a combinao de teclas SHIFT + F10,
que corresponde tecla de aplicao ou de menu .
A janela de propriedades dos objetos de Drivers no editor de objetos
pode ser aberta utilizando as combinaes de teclas ALT + ENTER, CTRL +
ALT + ENTER ou ALT + duplo-clique do mouse.

Drivers 217
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.

Inserindo um Driver de Comunicao no modo Domnio

A janela a seguir aberta para localizao do Driver.

218 Drivers
 Janela Localizar Driver

Se for selecionado um Driver vlido, o Studio exibe sua janela prpria de

configurao. Logo em seguida, abre-se a janela de importao de Tags (se
disponvel).

Ao inserir um Driver em uma aplicao do E3 Studio, abre-se o Editor do

objeto, conforme a figura a seguir.

Editor do Driver de Comunicao

As opes disponveis neste Editor esto descritas na tabela a seguir.

Opes disponveis no Editor do Driver de Comunicao

Drivers 219
 CONE OPO DESCRIO
Adicionar Adiciona uma nova
Pasta, um novo Tag ou
um novo Bloco de
Comunicao ao Driver,
um novo Tag ou um
novo Bloco de
Comunicao a uma
Pasta ou um novo
Elemento de
Comunicao a um
Bloco

Remover Remove o item

selecionado no Editor

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 Ativa ou desativa a

comunicao comunicao do Driver

Contagem de tags Apresenta o nmero

total de Tags de
Comunicao no Driver

220 Drivers
4.1.1 Configurao
Para determinar o Driver de Comunicao a ser usado, clique na propriedade
DriverLocation ou clique com o boto direito do mouse no Driver e selecione
a opo Procurar DLL. Uma caixa de dilogo para selecionar o arquivo .dll
que contm o Driver exibida, conforme a figura a seguir.

Selecionando um Driver

Para maiores informaes sobre a configurao individual de cada Driver,

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

Drivers 221
4.1.1.1 Teste de Comunicao

Ao configurar um Driver de Comunicao, o usurio pode realizar um

procedimento de teste a fim de verificar se os valores esto corretos e sendo
atualizados sem problemas. Ao clicar com o boto direito do mouse no Driver
de Comunicao, possvel utilizar a opo Ativar Comunicao.

Desta forma, o Driver de Comunicao especificado carregado e os valores

das variveis podem ser visualizados no campo Valor de cada Tag no Editor
deste objeto. Caso algum dos Tags possua a propriedade AllowRead em
Falso, ou ainda se o Tag no possuir um valor a ser reportado, esta linha
aparece com a cor cinza.

Caso o Tag apresente erro de comunicao a linha se torna vermelha, e caso

a comunicao esteja sem problemas a linha tem a cor azul. Para interromper
o monitoramento, clique com o boto direito do mouse no Driver de
Comunicao novamente e selecione a opo Desativar Comunicao.

222 Drivers
4.1.2 Funcionamento
O IOServer o mdulo do E3 responsvel pela comunicao com um
equipamento. no processo do IOServer que carregada a DLL do Driver e
efetuada a comunicao com o equipamento.

Os Tags de Comunicao possibilitam a leitura ou escrita de um conjunto de

valores, utilizando o Driver de Comunicao onde eles esto inseridos. Podem
ser utilizados tambm os Blocos de Comunicao para a leitura simultnea de
mais de uma varivel. Para acessar cada valor do Bloco utilize o Elemento de
Bloco, que pode ser includo dentro do objeto. Estes objetos so discutidos
nos tpicos seguintes.

Por padro, o E3 cria um IOServer para cada Driver de Comunicao em

tempo de execuo. Baseado no tempo de varredura (propriedade Scan) de
cada Tag, o Driver requisita periodicamente o valor de cada um. Sempre que
o valor ou a qualidade do Tag for alterado, seu valor repassado para o
Driver de Comunicao.

A verificao do tempo de ciclo de cada varivel feita de forma sequencial.

Caso o ciclo de uma varivel esteja vencido, o IOServer prossegue com o
questionamento de seu valor, passando para a prxima varivel at que a
verificao de toda a planilha esteja completa, para ento retornar ao topo
para uma nova varredura.

Pode-se reservar um tempo de ciclo menor para as variveis com

necessidade de atualizao mais veloz, e um tempo de ciclo maior para as
variveis sem tanta prioridade de atualizao. Deve-se ressaltar, entretanto,
que a performance da comunicao depende de uma srie de fatores,
incluindo o tipo de equipamento, o tipo de interface da comunicao utilizada,
velocidade (baud rate), taxa de erros, etc.

Sempre que o E3 enviar uma solicitao de atribuio de valores para uma ou

mais variveis, esta solicitao executada com prioridade em relao
varredura dos Tags.

No caso de falha de um IOServer, o E3 automaticamente realiza uma

reinicializao daquele mdulo, de forma a normalizar seu funcionamento. Por
outro lado, o IOServer interrompe seu funcionamento caso no exista nenhum
E3 Runtime (Principal ou Standby) para receber seu dados.

Drivers 223
Atravs da propriedade ShareServer, possvel compartilhar o mesmo
IOServer entre vrios Drivers de Comunicao. O primeiro Driver a ser
executado o responsvel por iniciar os procedimentos de comunicao,
como abrir uma porta serial ou iniciar uma interface de comunicao. Os
prximos Drivers de Comunicao compartilhados utilizam o mesmo IOServer
aberto pelo primeiro, o que permite o compartilhamento das interfaces de
comunicao utilizadas pelo Driver.

Isto pode ser vantajoso, j que muitos dos dispositivos de comunicao como
modems, portas seriais e outras interfaces, permitem apenas uma conexo, o
que impediria a utilizao simultnea por mais de um Driver. Com o
compartilhamento pode-se reutilizar a mesma conexo para mais de um
objeto. Deve-se ressaltar que as configuraes dos Drivers compartilhados
devem ser as mesmas para que o compartilhamento de Drivers funcione
corretamente.

Quando o Domnio est em execuo, tem-se acesso interface de execuo

do Driver de Comunicao, denominada Gerenciador de Drivers.

Acesso ao Gerenciador de Drivers

O Gerenciador de Drivers permite visualizar todos os Drivers em execuo,

exibindo suas propriedades. Nesta janela possvel ordenar os Drivers por
qualquer coluna, clicando no nome da coluna desejada. Tambm possvel
filtrar os valores das colunas (exceto para as colunas Erros de leitura e Erros
de escrita) clicando em e digitando um filtro para a coluna desejada.

224 Drivers
 Gerenciador de Drivers

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Gerenciador de Drivers

OPO DESCRIO
Nome Informa o nome do Driver

Objeto(s) Informa o nome do objeto Driver de

Comunicao associado ao Driver

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

Drivers 225
 OPO DESCRIO
Estado Mostra o estado atual do Driver
(configurado, iniciando, executando,
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
compartilhado ou no

Log Mostra o status do log (habilitado ou

desabilitado)

Caminho Informa o caminho do Driver no

sistema operacional

Habilitar Log Habilita o log dos Drivers em tempo

de execuo, sem a necessidade de
reconfigurar o aplicativo. Atravs
desta mesma opo pode-se
interromper este procedimento de
gravao

Atualizar Fora a atualizao dos dados

exibidos

226 Drivers
4.1.2.1 Utilizao de Estampa de Tempo

Alguns equipamentos e protocolos permitem o envio de informaes de

tempo juntamente com os valores das variveis. Os Drivers de Comunicao
para tais equipamentos podem, a cada varivel consultada, retornar tambm
a informao deste relgio que fica armazenada na propriedade TimeStamp
de cada Tag, com resoluo de 1ms.

Quando o equipamento no suporta este tipo de informao, ou quando o

Driver no est preparado para tal, o Driver de Comunicao insere na
estampa de tempo o valor de data e hora atual, a partir do relgio do
computador. De posse da estampa de tempo, o E3 utiliza esta informao
tanto para a verificao e gravao de alarmes quanto para a gerao de
arquivos histricos.

No caso dos Tags serem Elementos de Bloco, informada a mesma estampa

de tempo para todos os Elementos do Bloco, j que foram consultados no
mesmo instante de tempo. No caso do Driver suportar leituras de variveis
tanto como Bloco quanto como Tag de Comunicao, caso os Elementos
possam representar eventos distintos, deve-se preferir o uso de Tags de
Comunicao.

Para obter mais informaes sobre quais equipamentos possuem esta

caracterstica, entre em contato com o fabricante. Para saber quais Drivers ou
tipos de variveis dentro dos equipamentos utilizam a estampa de tempo,
consulte a ajuda dos Drivers ou diretamente o suporte tcnico da Elipse
Software.

Drivers 227
4.1.2.2 Tags Reportados por Eventos

Tags reportados por eventos podem retornar mais de um valor a cada

leitura, ou ento no retornar valor algum.

Os Tags reportados por eventos so destinados leitura de dados sob

demanda, geralmente armazenados no Driver at serem lidos em uma
operao de leitura. So normalmente utilizados para a leitura de eventos,
dados de memria de massa e mensagens no solicitadas recebidas do
equipamento.

A documentao do Driver deve especificar quais dos seus Tags disponveis

para a aplicao so reportados a eventos.

A utilizao mais comum para a coleta de Sequncia de Eventos (SOE, ou

Sequence Of Events). Por exemplo, em equipamentos que armazenem em sua
memria sequncias muito rpidas de variaes de Tags digitais, ou que
armazenem dados de telemetria em tabelas na memria, os dados podem
ser armazenados na memria em tabelas, como demonstrado nas figuras a
seguir.

Tabela com trs eventos e apenas um campo de

dados

Tabela com trs eventos e seis campos de dados

228 Drivers
Para o primeiro exemplo, necessrio um Tag de Comunicao para ler o
valor A. O campo Tempo retornado na propriedade TimeStamp do Tag. J
para o segundo exemplo, necessrio um Tag Bloco de Comunicao com
seis elementos (de A at F), com o campo Tempo mais uma vez sendo
retornado na propriedade Timestamp do Bloco de Comunicao.

Em Tags comuns, no reportados por eventos, pode-se configurar um tempo

de varredura (scan), que determina o perodo em que o valor do Tag lido. A
cada operao de leitura, o Tag retorna um valor (Tag de Comunicao) ou
bloco de valores (Tag Bloco de Comunicao), ou ento pode retornar erro.
Para ler as tabelas descritas anteriormente, neste caso, so necessrias trs
operaes de leitura em cada tabela para poder ler os trs eventos (ou seja,
as trs linhas da tabela).

Os Tags reportados por eventos tambm permitem configurar um tempo de

varredura. Para estes Tags, entretanto, cada operao de leitura pode
retornar uma srie de valores ou blocos de valores, com qualidades e
timestamps prprios. Ou seja, no caso de utilizar Tags reportados por eventos
para ler as tabelas anteriores, possvel obter os trs eventos (os dados das
trs linhas de cada tabela) de uma vez s, em uma nica operao de leitura
(um nico scan).

A leitura dos valores retornados por Tags reportados por eventos feita
atravs do evento OnRead do Tag. A cada operao de leitura que retorne
valores, a aplicao dispara uma sucesso de eventos OnRead. Para cada
valor ou evento retornado, a aplicao preenche as propriedades do Tag
(valor, timestamp e qualidade) com os valores do evento especfico, e ento
dispara o evento OnRead.

Caso o Driver no possua eventos ou valores a retornar, a operao de

leitura reportada a eventos, ao contrrio do que ocorre com os Tags comuns,
pode no retornar dado algum e nem gerar erros, como se a operao de
leitura no houvesse ocorrido.

O tempo de varredura ou scan de Tags reportados por eventos geralmente

pode ser configurado com um valor bem baixo, pois o consumo de CPU, caso
no existam valores a retornar, geralmente desprezvel.

A propriedade TimeStamp destes Tags em geral contm um valor fornecido

pelo prprio equipamento.

Drivers 229
NOTA
Os Tags reportados por eventos devem ser configurados com a
propriedade EnableDeadband desabilitada. Isto evita que eventos com
valores muito prximos sejam desprezados pela aplicao.

4.1.2.2.1 Gravao de Eventos em um Histrico

O uso mais comum da leitura de Tags reportados por eventos a gravao

dos eventos retornados em um objeto Histrico. Para isto, siga estes
procedimentos:

1. Crie um objeto Histrico, com varredura desabilitada (propriedade

ScanTime igual a zero) e sem banda morta (propriedade DeadBand igual
a zero).

2. Associe as propriedades TimeStamp e os valores do Tag ao Histrico.

Pode-se tambm associar outras propriedades, caso seja importante
armazen-las.

3. Utilize o mtodo WriteRecord do objeto Histrico no evento OnRead do

Tag.

Desta forma, garante-se que cada valor reportado a evento que chegar seja
gravado sequencialmente no Histrico associado.

230 Drivers
4.1.2.3 Pool de Processos IOServer

Em aplicativos com centenas de Drivers, os recursos necessrios para

executar os processos IOServer para cada Driver podem esgotar a
capacidade do sistema operacional. Nestes casos, pode ser necessrio
habilitar o Pool de Processos IOServer na aba Propriedades da configurao
do Domnio.

Quando este Pool est habilitado, cada processo IOServer pode executar mais
de um Driver, economizando desta forma recursos do sistema operacional e
permitindo que um aplicativo chegue a executar milhares de Drivers.

Apenas Drivers que suportam a criao de novas instncias dinmicas (Drivers

compilados com o IOKit v2.0.6 ou superior) podem ser utilizados no Pool. Se
um Driver que no tem este suporte for adicionado ao Pool, ele no
executado (falha). Para estes casos, basta configurar a propriedade
DisableIOServerPool do IODriver para Falso para que o Driver execute fora
do Pool, em um processo IOServer exclusivo.

Na aba Propriedades da configurao do Domnio, pode-se controlar o

nmero mximo de processos IOServer no Pool, bem como o nmero mximo
de Drivers que executam em cada IOServer.

Opes de comportamento do Pool de Processos IOServer

DRIVERS POR NMERO MXIMO DE COMPORTAMENTO DO

PROCESSO PROCESSOS POOL
0 M medida que os Drivers
do aplicativo forem
ativados, criado um
processo IOServer para
cada Driver, at atingir o
nmero mximo M.
Depois deste ponto,
cada novo Driver que for
ativado adicionado ao
IOServer do Pool que
contm a menor
quantidade de Drivers

Drivers 231
 DRIVERS POR NMERO MXIMO DE COMPORTAMENTO DO
PROCESSO PROCESSOS POOL
N 0 medida que os Drivers
do aplicativo forem
ativados, o E3 os
adiciona a um processo
IOServer do Pool que
ainda no tenha atingido
o nmero mximo N de
Drivers executando
dentro dele. Se todos os
processos do Pool
estiverem no limite
mximo, ento um novo
IOServer adicionado
ao Pool

232 Drivers
 DRIVERS POR NMERO MXIMO DE COMPORTAMENTO DO
PROCESSO PROCESSOS POOL
N M medida que os Drivers
do aplicativo forem
ativados, o E3 os
adiciona a um processo
IOServer do Pool que
ainda no tenha atingido
o nmero mximo N de
Drivers executando
dentro dele. Se todos os
processos do Pool
estiverem no limite
mximo, o
comportamento
depende da quantidade
de processos no Pool, e
se o nmero de
processos do Pool for
menor que o mximo M,
ento um novo processo
adicionado ao Pool,
caso contrrio o Driver
adicionado no processo
que tiver menos Drivers
executando. NOTA:
Neste modo, o nmero
mximo de Drivers por
processo (N) pode ser
ultrapassado caso o
nmero total de Drivers
do aplicativo exceda N *
M

Drivers 233
NOTAS
Ao agrupar Drivers em um mesmo processo IOServer, perde-se o
isolamento entre estes Drivers. Desta forma, se ocorrer uma falha em um
destes Drivers, o IOServer fechado e todos os Drivers que executavam
naquele IOServer tm que ser reiniciados.
Existe um limite no nmero de Drivers que podem executar em um
processo IOServer. Este limite depende de diversas variveis, tais como o
sistema operacional em uso, a quantidade de memria, threads e recursos
que cada Driver especfico est ocupando. Em linhas gerais, no se deve
adicionar mais do que 100 Drivers em um nico IOServer, sob pena de
exceder os limites do sistema operacional.

234 Drivers
4.1.3 Pasta de Comunicao
A Pasta de Comunicao define grupos e subdiretrios de forma a organizar
as variveis. Cada Pasta pode ser renomeada conforme a necessidade e
novas Pastas podem ser inseridas dentro de outras. Para utilizar este recurso,
siga este procedimento:

1. No Organizer, clique com o boto direito do mouse no objeto Driver e

selecione a opo Inserir - Nova Pasta.

Inserindo uma nova Pasta

Drivers 235
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.

236 Drivers
 Inserindo um Tag de Comunicao

2. A janela da figura a seguir mostrada, perguntando quantos Tags devem

ser criados no Driver, e qual seu nome. Este nome auto-incrementado e,
se a opo for deixada em branco, os Tags so criados com o nome
padro.

Drivers 237
 Inserindo Tags de Comunicao

Caso o equipamento sendo utilizado para coletar os dados informe valores

de Tags que precisam ser convertidos, pode-se utilizar as escalas dos Tags,
que so basicamente uma especificao de uma converso linear entre duas
bases diferentes.

Para isto, deve-se habilitar a propriedade EnableScaling do Tag e informar

os parmetros DeviceLow e DeviceHigh (atravs das respectivas propriedades),
que seriam os limites inferior e superior do dado vindo do equipamento, alm
de informar os parmetros EULow e EUHigh (atravs das respectivas
propriedades) que so os limites inferior e superior do dado, j em unidades
de engenharia.

Algumas das propriedades deste objeto podem ser configuradas diretamente

na Lista de Propriedades, sem a necessidade de criar scripts para isto. Demais
informaes sobre as funcionalidades das propriedades deste objeto podem
ser encontradas no Manual de Referncia e Scripts do E3, em seu captulo
respectivo.

238 Drivers
4.1.5 Bloco de Comunicao
O Bloco de Comunicao utilizado para definir a troca de informaes com
os equipamentos de aquisio, que consistem de uma ou mais variveis,
desde que seja consecutivo no endereamento dentro do dispositivo externo.

Dependendo do mtodo de comunicao utilizado, podem economizar tempo

de comunicao, obtendo um nmero maior de atualizaes em um mesmo
intervalo de tempo se comparado com o Tag de Comunicao. Os Blocos de
Comunicao so configurados atravs de uma srie de parmetros B (B1 a
B4) que variam de acordo com o Driver de Comunicao a ser utilizado, alm
da propriedade Size, que define o nmero de Elementos ou ndices
disponveis no Bloco. Para utilizar este recurso, siga estes procedimentos:

1. Clique com o boto direito do mouse no Driver e selecione a opo

Inserir - Bloco de Comunicao.

Drivers 239
 Inserindo um Bloco de Comunicao

2. A janela da figura a seguir mostrada, perguntando quantos Blocos

devem ser criados no Driver, e qual seu nome. Este nome auto-
incrementado e, se a opo for deixada em branco, os Blocos so criados
com o nome padro.

240 Drivers
 Inserindo Blocos de
Comunicao

3. A caixa de dilogo da figura a seguir mostrada, para determinar o

nmero de Elementos de Bloco neste objeto. Nesta opo possvel
indicar o mapeamento de todos os Elementos de Bloco ou somente em
um determinado intervalo de Elementos.

Configurando o Bloco de Comunicao

4. Informe o tamanho do Bloco e a opo de mapeamento.

5. Clique em OK.

6. Caso necessite, configure as propriedades do objeto.

Drivers 241
Algumas das propriedades do Bloco de Comunicao podem ser
configuradas atravs da Lista de Propriedades, sem a necessidade de criar
scripts para isto. Caso necessite configurar alguma propriedade, localize-a na
Lista de Propriedades e execute os devidos ajustes. Para maiores
informaes, consulte o Manual de Referncia e Scripts do E3.

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

1. Clique com o boto direito do mouse no Bloco de Comunicao e

selecione a opo Inserir - Elemento de Comunicao.

Inserindo um Elemento de Bloco de Comunicao

Drivers 243
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 so os limites inferior e superior do dado vindo do
equipamento, alm dos parmetros EULow e EUHigh (atravs das respectivas
propriedades) que so os limites inferior e superior do dado j em unidades
de engenharia.

Algumas das propriedades do Elemento de Bloco podem ser configuradas

atravs da Lista de Propriedades, sem a necessidade de criar scripts para isto.
Caso necessite configurar alguma propriedade, localize-a na Lista de
Propriedades e execute os devidos ajustes. Para maiores informaes,
consulte o Manual de Referncia e Scripts do E3.

4.2 Servidor OPC

Alm de possuir um cliente OPC (Driver OPC), o E3 funciona tambm como
Servidor OPC DA (Data Access) 2.0x. Isto permite ao E3 expor todos os objetos
existentes no Domnio em execuo (Tags de Comunicao, por exemplo)
para softwares externos ao E3. Como exemplos, pode-se citar o Elipse
SCADA, o E3 (que pode estar executando 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 Software para maiores informaes.

244 Drivers
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
modo Standby ou executando normalmente. Os valores possveis para o
status do OPC so os seguintes:

OPC_STATUS_RUNNING: Domnio executando normalmente

OPC_STATUS_SUSPENDED: Domnio em modo Standby

OPC_STATUS_NOCONFIG: Domnio parado ou sem Domnio

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 modo
Standby. Aps o aviso, todos os clientes so desconectados.

Drivers 245
4.3 Driver de Comunicao OPC
O Driver de Comunicao OPC o mdulo responsvel por coletar dados
de equipamentos externos atravs da execuo de um Servidor OPC, que
pode ser fornecido por qualquer empresa. Os Tags podem ser importados
para o Driver OPC dentro do E3 (que neste caso atua como um OPC Client) ou
ainda podem ser criados a partir do E3. Para utilizar um Driver OPC, siga este
procedimento:

1. Clique com o boto direito do mouse no nome do projeto no Explorer e

selecione a opo Inserir - Driver de Comunicao OPC. No modo
Domnio, clique com o boto direito do mouse no item Objetos de
Servidor - Drivers e OPC, selecione a opo Inserir Driver de
Comunicao OPC em e logo aps o nome do projeto desejado.

Inserindo um Driver OPC

Ao inserir um Driver OPC em uma aplicao no E3 Studio, abre-se o Editor do

objeto, conforme a figura a seguir.

246 Drivers
 Editor do Driver de Comunicao OPC

As opes disponveis neste Editor esto descritas na tabela a seguir.

Opes disponveis no Editor do Driver OPC

CONE OPO DESCRIO

Adicionar Adiciona um Grupo ao
Driver, um Tag, um
Bloco ou uma Pasta ao
Grupo, ou um Elemento
ao Bloco

Remover Remove o item

selecionado no Editor

Selecionar servidor Seleciona o Servidor

OPC

Ativar/desativar Ativa e desativa a

comunicao comunicao do Driver

Importar tags Importa Tags para o

Driver OPC

Informaes sobre o Mostra uma janela com

servidor as configuraes do
Driver

Drivers 247
 CONE OPO DESCRIO
Contagem de tags Apresenta o nmero
total de Tags de
Comunicao no Driver

248 Drivers
4.3.1 Configurao
A identificao dos outros objetos pertencentes ao Driver OPC pode ser
inserida manualmente, ou ento ser trazida automaticamente do Servidor
OPC. Para isto, abra a janela de propriedades do Driver, clicando com o
boto direito do mouse no objeto e selecionando a aba OPC Driver.

Aba OPC Driver

Informe o Endereo e ID do Servidor e clique em Selecionar. A janela da

figura a seguir mostrada.

Drivers 249
 Seleo do Servidor OPC

As opes disponveis no item Opes de busca dos servidores OPC esto

descritas na tabela a seguir.

Opes disponveis no item Opes de busca dos servidores OPC

OPO
Tentar enumerador padro ou
registro (recomendado)
DESCRIO
O E3 tenta procurar as
especificaes do Driver, tanto pelo
Registro do Windows quanto pelo
enumerador padro OPC
(OPCENUM)

250 Drivers
 OPO DESCRIO
Tentar apenas enumerador padro O E3 tenta procurar as
(servio OPCENUM) especificaes do Driver apenas pelo
enumerador padro OPC
(OPCENUM)

Tentar apenas pesquisa no registro O E3 tenta procurar as

especificaes do Driver apenas
pelos registros no Windows

Drivers 251
Clicando em OK, o sistema mostra os dados do Driver, indicando os caminhos
e o nome do servidor. Para ativar a comunicao do Driver OPC, clique em
Ativar Comunicao.

Ativar comunicao do Driver OPC

252 Drivers
Quando a comunicao ativada, so habilitadas as opes Informaes
sobre o servidor e Importar tags, alm da opo Desativar Comunicao.
Para utilizar estas opes, clique com o boto direito do mouse no Driver
OPC e selecione a opo desejada.

Opes habilitadas quando o Driver OPC est ativo

A opo Informaes sobre o servidor mostra uma janela com as

configuraes do Driver.

Drivers 253
 Informaes do Servidor OPC

Atravs da opo Importar tags, possvel importar Tags para o Driver OPC.
Quando esta opo selecionada, a caixa de dilogo da figura a seguir
mostrada.

Mensagem referente importao de Tags OPC

As opes disponveis nesta caixa de dilogo so as seguintes:

254 Drivers
 Sim: O E3, ao executar a localizao dos Tags OPC, tenta
automaticamente detectar quais Tags so do tipo Bloco e, neste caso,
qual o nmero de Elementos. Para 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 l os valores dos Tags OPC ao realizar a operao de

busca. Esta operao mais rpida, porm no cria automaticamente
Tags OPC de tipo Bloco e seus Elementos

Cancelar: Cancela a importao

A janela de importao dispe dos recursos mostrados na figura a seguir.

Importao de Tags OPC

Drivers 255
As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Importao de Tags OPC

OPO DESCRIO
Nome dos Itens Filtra os Tags a partir do nome dos
itens especificados. Podem ser
utilizados caracteres curingas, tais
como * (asterisco) ou ? (ponto de
interrogao)

Tipo de dados Filtra os Tags a partir do tipo de

dado especificado no campo, que
pode ser Integer, Long, Single, etc.

Tipo de acesso Filtra os Tags a partir do tipo de

acesso especificado no campo, que
pode ser Leitura, Escrita ou Leitura
e Escrita

Mostrar apenas itens com IDs no Filtra os Tags para que a aplicao
encontrados no projeto mostre apenas os itens com IDs no
encontrados no projeto

Projeto corrente Mostra os objetos que foram

selecionados para adio no projeto
corrente

Servidor OPC Mostra os Tags disponveis no

servidor para importao

256 Drivers
Para executar a importao, selecione o Tag desejado e arraste-o para o
Driver ou Grupo OPC desejado. Para desativar a comunicao do Driver OPC,
clique em Desativar Comunicao.

Algumas das propriedades do Driver OPC podem ser configuradas atravs da

Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso
necessite configurar alguma propriedade, localize-a na Lista de Propriedades
e execute os devidos ajustes. Para maiores informaes, consulte o Manual
de Referncia e Scripts do E3.

4.3.1.1 Funcionamento

A comunicao do cliente OPC do E3 com um servidor OPC feita por um

processo separado. Este processo, quando o Driver OPC ativado pelo
Studio, executa na conta do usurio atual do Windows. Em tempo de
execuo, por outro lado, este processo executado na conta SYSTEM.
Alguns servidores OPC podem ser sensveis conta em que esto executando
e, por este motivo, pode ser necessrio reconfigurar o processo para que
seja executado por um usurio especfico. Para isto, siga estes procedimentos:

1. V ao menu Iniciar - Painel de Controle - Ferramentas Administrativas -

Servios de Componente (Start - Control Panel - Administrative Tools -
Component Services), ou digite dcomcnfg no prompt de comando do
Windows.

2. Expanda o item Config DCOM (DCOM Config) em Servios de

componente - Computadores - Meu computador (Component Services -
Computers - My Computer), clique com o boto direito do mouse no item
E3OpcClient e selecione a opo Propriedades (Properties).

3. Selecione a aba Identidade (Identity), selecione o item Este usurio (This

user) e preencha as informaes da conta.

4. Clique em OK e reinicie o computador para que as modificaes sejam

aplicadas.

Drivers 257
4.3.2 Grupo de Tags OPC
O objeto Grupo de Tags OPC agrupa uma srie de Tags OPC que
compartilham os mesmos parmetros de atualizao (tempo de varredura e
banda morta). sempre necessrio existir um Grupo de Tags OPC para poder
criar Tags OPC. Para inserir um Grupo de Tags OPC, siga este procedimento:

1. Clique com o boto direto do mouse no Driver OPC e selecione a opo

Inserir - Grupo de tags OPC.

Inserindo um Grupo de Tags OPC

258 Drivers
Algumas das propriedades do Grupo de Tags OPC podem ser configuradas
atravs da Lista de Propriedades, sem a necessidade de criar scripts para isto.
Caso necessite configurar alguma propriedade, localize-a na Lista de
Propriedades e execute os devidos ajustes. Para maiores informaes,
consulte o Manual de Referncia e Scripts do E3.

Drivers 259
4.3.3 Pasta OPC
O objeto Pasta OPC define grupos ou subdiretrios, de forma a melhor
organizar as variveis. Cada Pasta OPC pode ser renomeada conforme a
necessidade, e novas Pastas podem ser inseridas dentro de outras. Em tempo
de execuo, se a Pasta OPC for desabilitada, todo o contedo desativado.
Para utilizar este recurso, siga este procedimento:

1. Clique com o boto direito do mouse no Grupo OPC e selecione a opo

Inserir - Nova Pasta.

Inserindo uma Pasta OPC

260 Drivers
4.3.4 Tag de Comunicao OPC
O Tag de Comunicao OPC um objeto para leitura ou escrita de valores
em um equipamento. A leitura do Tag feita automaticamente pelo Servidor
OPC, com tempo de varredura definido no Grupo OPC no qual ele est
inserido. Para utilizar este recurso, siga estes procedimentos:

1. Clique com o boto direito do mouse no Grupo OPC e selecione a opo

Inserir - Tag de Comunicao OPC.

Inserindo um Tag de Comunicao OPC

Drivers 261
2. Abre-se uma janela perguntando quantos Tags devem ser criados no
Grupo, e qual seu nome. Este nome autoincrementado e, se esta opo
for deixada em branco, os Tags so criados com o nome padro.

Inserindo Tags de Comunicao

OPC

Algumas das propriedades do Tag OPC podem ser configuradas atravs da

Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso
necessite configurar alguma propriedade, localize-a na Lista de Propriedades
e execute os devidos ajustes. Para maiores informaes, consulte o Manual
de Referncia e Scripts do E3.

262 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 executar uma escrita, deve-se apenas atribuir um
novo valor propriedade Value. A leitura do Tag feita automaticamente
pelo Servidor OPC com tempo de varredura definido no Grupo OPC. A
propriedade Size determina o nmero de Elementos do Tag no servidor. Para
utilizar este recurso, siga estes procedimentos:

1. Clique com o boto direito do mouse no Grupo OPC e selecione a opo

Inserir - Bloco de Comunicao OPC.

Drivers 263
 Inserindo um Bloco de Comunicao OPC

2. Abre-se uma janela perguntando quantos Blocos devem ser criados no

Grupo, e qual seu nome. Este nome autoincrementado e, se esta opo
for deixada em branco, os Blocos so criados com o nome padro.

264 Drivers
 Inserindo Blocos de
Comunicao OPC

3. mostrada uma caixa de dilogo para determinar o nmero de

Elementos de Bloco neste objeto. Nesta opo possvel indicar o
mapeamento de todos os Elementos de Bloco ou somente de um
determinado intervalo de Elementos.

Configurando o Bloco de Comunicao

4. Informe o tamanho do Bloco e a opo de mapeamento.

5. Clique em OK.

6. Caso necessite, configure as propriedades do objeto.

Drivers 265
Algumas das propriedades do Bloco de Comunicao OPC podem ser
configuradas atravs da Lista de Propriedades, sem a necessidade de criar
scripts para isto. Caso necessite configurar alguma propriedade, localize-a na
Lista de Propriedades e execute os devidos ajustes. Para maiores
informaes, consulte o Manual de Referncia e Scripts do E3.

4.3.6 Elemento de Bloco OPC

O objeto Elemento de Bloco OPC possibilita a leitura ou escrita de um dos
Elementos do Bloco OPC onde ele est inserido.

O Bloco OPC l uma tabela de dados, e este objeto est sempre associado
posio definida por sua propriedade Index. Por exemplo, um Elemento de
Bloco OPC com Index igual a cinco e inserido em um Bloco OPC com tamanho
10, cujos dados sejam lidos como na tabela a seguir.

Tabel 5 12 77 55 1 3 42 20 8 89
a
ndice 0 1 2 3 4 5 6 7 8 9

266 Drivers
Teria sua propriedade Value igual a trs, segundo a tabela anterior.

NOTA
O E3 pode criar automaticamente os Elementos de Bloco OPC. Para maiores
detalhes, veja a opo Importar Tags, no tpico Configurao.

Para utilizar este recurso, siga este procedimento:

1. Clique com o boto direito do mouse no Bloco OPC e selecione a opo

Inserir - Elemento de Bloco OPC.

Drivers 267
 Inserindo um Elemento de Bloco OPC

Algumas das propriedades do Elemento de Bloco OPC podem ser

configuradas atravs da Lista de Propriedades, sem a necessidade de criar
scripts para isto. Caso necessite configurar alguma propriedade, localize-a na
Lista de Propriedades e execute os devidos ajustes. Para maiores
informaes, consulte o Manual de Referncia e Scripts do E3.

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

Inserindo um Driver de Comunicao OPC UA em modo Domnio

Algumas das propriedades do Driver de Comunicao OPC UA podem ser

configuradas atravs da Lista de Propriedades, sem a necessidade de criar
scripts para isto. Caso necessite configurar alguma propriedade, localize-a na
Lista de Propriedades e execute os devidos ajustes. Para maiores
informaes, consulte o Manual de Referncia e Scripts do E3.

Drivers 269
4.4.1 Configurao
A configurao do objeto Driver de Comunicao OPC UA semelhante
configurao do Driver de Comunicao OPC. Para configur-lo, clique com
o boto direito do mouse no objeto e selecione o item Selecionar servidor.

Opo Selecionar servidor

270 Drivers
A janela a seguir mostrada, permitindo selecionar um servidor OPC UA na
mquina local ou na rede.

Servidores OPC UA locais e na rede

Para cada servidor OPC UA, tanto locais quanto em rede, so enumerados os
pontos de conexo (endpoints), que podem utilizar diferentes protocolos e
modos de segurana. Alm disto, para cada ponto de conexo o servidor
tambm pode suportar diferentes formas de identificao e autenticao de
usurios.

Atualmente, o E3 permite a conexo apenas pelo modo TCP Binrio. Para

este modo, o E3 suporta os modos de segurana definidos pelo padro OPC
UA, em diversas combinaes de polticas de segurana. Para a autenticao,
o E3 suporta apenas os modos Annimo e Usurio e Senha.

Drivers 271
NOTA
A janela Servidores OPC UA lista todos os protocolos e modos de
segurana, para informao do usurio. Entretanto, somente os modos
compatveis com o E3 podem ser selecionados.

Ao selecionar um ponto de conexo compatvel com o E3, as propriedades

EndPointURL, SecurityMode e SecurityPolicy do objeto so
automaticamente preenchidas.

Se as propriedades UserName e Password do objeto forem deixadas em

branco, o E3 utiliza uma conexo annima com o servidor. Caso contrrio, o
E3 envia os valores destas propriedades para o servidor, que deve suportar
este tipo de autenticao no ponto de conexo selecionado.

Neste objeto tambm possvel configurar diversos limites de tempo (time-

outs) da conexo OPC UA. Estes valores de limite de tempo (propriedades
TimeoutCall, TimeoutConnection e TimeoutSession) so sempre em
milissegundos e devem ser ajustados de acordo com a performance da
comunicao, que pode ser limitada pelo servidor, pela rede, pelas mquinas
onde executam o cliente e o servidor, e at mesmo pelas operaes feitas
pelo cliente. Este ajuste deve ser feito caso a caso e os valores padro destas
propriedades so apenas sugestes.

No E3 Studio, a comunicao com o Driver pode ser ativada ao selecionar a

opo Ativar Comunicao no menu contextual do objeto. A ativao
executada automaticamente pelos objetos Consulta ao selecionar servidores,
Tags, ou executar a visualizao dos resultados de uma consulta (aba
Visualizar).

Note que para editar as propriedades do Driver pode ser necessrio

desativar a comunicao. Se a comunicao estiver ativa no E3 Studio,
possvel abrir uma janela de informaes sobre o servidor selecionado (ao
selecionar a opo Informaes sobre o servidor no menu contextual do
objeto). Caso a conexo no esteja estabelecida, por qualquer motivo, esta
janela mostra pontos de interrogao no lugar das informaes.

272 Drivers
4.4.2 Assinatura OPC UA
O objeto Assinatura OPC UA agrupa Tags OPC UA que compartilham o
tempo de varredura (a propriedade Scan) e a possibilidade de habilitar ou
desabilitar a leitura de todos os itens de uma vez (a propriedade Enable). A
existncia de um objeto Assinatura OPC UA obrigatria para que se possa
criar Tags OPC UA. Para inserir um objeto Assinatura OPC UA, siga este
procedimento:

1. Clique com o boto direto do mouse no Driver OPC UA e selecione a

opo Inserir - Assinatura OPC UA.

Inserindo uma Assinatura OPC UA

Drivers 273
Algumas das propriedades do objeto Assinatura OPC UA podem ser
configuradas atravs da Lista de Propriedades, sem a necessidade de criar
scripts para isto. Caso necessite configurar alguma propriedade, localize-a na
Lista de Propriedades e execute os devidos ajustes. Para maiores
informaes, consulte o Manual de Referncia e Scripts do E3.

274 Drivers
4.4.3 Pasta OPC UA
O objeto Pasta OPC UA define grupos ou subdiretrios, de forma a melhor
organizar as variveis. Cada Pasta OPC UA pode ser renomeada conforme a
necessidade, e novas Pastas podem ser inseridas dentro de outras. Em tempo
de execuo, se a Pasta OPC UA desabilitada, todo seu contedo
desativado. Para utilizar este recurso, siga este procedimento:

1. Clique com o boto direito do mouse no objeto Assinatura OPC UA e

selecione a opo Inserir - Pasta.

Inserindo uma Pasta OPC UA

Drivers 275
4.4.4 Tag de Comunicao OPC UA
O Tag de Comunicao OPC UA um objeto para leitura ou escrita de
valores em um equipamento. A leitura do Tag realizada automaticamente
pelo servidor OPC UA, com tempo de varredura definido na Assinatura OPC
UA na qual est inserido. Para utilizar este recurso, siga estes procedimentos:

1. Clique com o boto direito do mouse no objeto Assinatura OPC UA e

selecione a opo Inserir - Tag de Comunicao OPC UA.

Inserindo um Tag de Comunicao OPC UA

2. Abre-se uma janela perguntando quantos Tags devem ser criados na

Assinatura, e qual seu nome. Este nome autoincrementado e, se esta
opo deixada em branco, os Tags so criados com o nome padro.
276 Drivers
 Configurando a quantidade de
Tags

Algumas das propriedades do Tag OPC UA podem ser configuradas atravs

da Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso
necessite configurar alguma propriedade, localize-a na Lista de Propriedades
e execute os devidos ajustes. Para maiores informaes, consulte o Manual
de Referncia e Scripts do E3.

4.4.5 Bloco de Comunicao OPC UA

O objeto Bloco de Comunicao OPC UA possibilita a leitura ou escrita de
um conjunto de valores. Para executar uma escrita, deve-se apenas atribuir um
novo valor propriedade Value. A leitura do Tag realizada
automaticamente pelo servidor OPC UA com tempo de varredura definido na
Assinatura OPC UA. A propriedade Size determina o nmero de Elementos do
Tag no servidor.

NOTA
Na verso atual, o E3 s permite que vetores de uma dimenso (arrays)
sejam mapeados para Blocos de Comunicao, embora o padro OPC UA
suporte matrizes n-dimensionais como tipos de dados.

Para utilizar este recurso, siga estes procedimentos:

1. Clique com o boto direito do mouse na Assinatura OPC UA e selecione a

opo Inserir - Bloco de Comunicao OPC UA.

Drivers 277
 Inserindo um Bloco de Comunicao OPC UA

2. Abre-se uma caixa de dilogo para indicar quantos Blocos devem ser
criados na Assinatura, e qual seu nome. Este nome autoincrementado e,
se esta opo deixada em branco, os Blocos so criados com o nome
padro.

278 Drivers
 Configurando a quantidade de
Blocos

3. Abre-se 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 OPC

UA

4. Informe o tamanho do Bloco e a opo de mapeamento.

5. Clique em OK.

6. Caso necessite, configure as propriedades do objeto.

Drivers 279
Algumas das propriedades do Bloco de Comunicao OPC UA podem ser
configuradas atravs da Lista de Propriedades, sem a necessidade de criar
scripts para isto. Caso necessite configurar alguma propriedade, localize-a na
Lista de Propriedades e execute os devidos ajustes. Para maiores
informaes, consulte o Manual de Referncia e Scripts do E3.

280 Drivers
4.4.6 Elemento de Bloco OPC UA
O objeto Elemento de Bloco OPC UA possibilita a leitura ou escrita de um
dos Elementos do Bloco OPC UA onde ele est inserido. O Bloco OPC UA l
uma tabela de dados, e este objeto est sempre associado posio definida
por sua propriedade Index. Para utilizar este recurso, siga este procedimento:

1. Clique com o boto direito do mouse no Bloco OPC UA e selecione a

opo Inserir - Elemento de Bloco OPC UA.

Inserindo um Elemento de Bloco OPC UA

Drivers 281
Algumas das propriedades do Elemento de Bloco OPC UA podem ser
configuradas atravs da Lista de Propriedades, sem a necessidade de criar
scripts para isto. Caso necessite configurar alguma propriedade, localize-a na
Lista de Propriedades e execute os devidos ajustes. Para maiores
informaes, consulte o Manual de Referncia e Scripts do E3.

282 Drivers
4.4.7 Objeto Consulta
Para configurar um objeto Consulta para buscar dados em um servidor OPC
UA utilizando o Driver OPC UA, siga estes procedimentos:

1. Selecione o Driver OPC UA na janela Defina o Servidor de Banco de Dados

da Consulta.

Selecionar Driver OPC UA

2. A janela a seguir mostrada, permitindo configurar a Consulta.

Drivers 283
 Aba Campos

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

Opes disponveis na aba Campos

OPO DESCRIO
Dados Brutos A Consulta retorna os dados como
so armazenados no servidor,
semelhante consulta
CompressedDataStartEndTime do
objeto Storage. Neste modo,
apenas um Tag pode ser consultado
por vez, retornando tambm a
qualidade do valor

284 Drivers
 OPO DESCRIO
Dados Processados A Consulta retorna dados
agregados dentro de um intervalo
de tempo, semelhante s consultas
SampledData e CalculatedData do
objeto Storage. Neste modo, vrios
Tags podem ser consultados por
vez, mas no retornam a qualidade
do valor. Diversas funes de
agregao podem ser utilizadas,
como por exemplo mdias,
mximos, interpolaes, etc. Funes
diferentes podem ser usadas para
cada Tag e um mesmo Tag pode
aparecer vrias vezes na Consulta,
com funes de agregao
diferentes. O E3 apenas lista as
funes padro, sem buscar funes
especficas do servidor ou filtrar
funes no suportadas pelo
servidor. A Consulta pode falhar
caso seja selecionada uma funo
no suportada pelo servidor OPC
UA

Adiciona um ou mais Tags do

servidor OPC UA

Remove o Tag selecionado da

Consulta

Fora a atualizao dos

Identificadores de Ns OPC UA
(NodeIds)

Id Tipo de Identificador de N OPC UA

(NodeId) no servidor

Colunas Caminho do Tag no servidor OPC

UA

Drivers 285
 OPO DESCRIO
Ttulo Nome do Tag no servidor OPC UA

Funo Funo utilizada no Tag. Esta coluna

s est disponvel quando a opo
Dados Processados est
selecionada

Ao clicar em , a janela a seguir mostrada, permitindo selecionar os Tags

existentes no servidor.

Seleo de Tags OPC UA

As abas Variveis e Visualizar tm o mesmo comportamento descrito no

captulo Consultas.

286 Drivers
4.4.8 Certificados
Durante a instalao do E3, instalado um certificado relativo instncia do
cliente OPC UA do E3. Este certificado necessrio sempre que for utilizada
uma conexo com o servidor cujo modo de segurana (propriedade
SecurityMode) no seja igual a None (ou seja, uma conexo OPC UA segura).

Este certificado pode ser encontrado na pasta CertificateStore/certs da

instalao do E3, em um arquivo chamado Elipse E3 UA Client [xxx].der, onde
xxx um cdigo gerado aleatoriamente.

Se este certificado apagado, um novo gerado automaticamente sempre

que o Driver OPC UA tentar estabelecer uma conexo com um servidor.

NOTAS
Apagar o certificado pode significar ter que atualizar os servidores OPC
UA com o novo certificado, ou ento a conexo segura com o cliente do
E3 pode ser negada.
Este certificado corresponde instncia do cliente, e no ao cliente OPC
UA do E3, ou seja, ele NO pode ser copiado de uma mquina para
outra. Cada instalao tem um certificado nico.
O cliente OPC UA do E3 aceita qualquer certificado vlido de servidor, ou
seja, no necessria nenhuma configurao para que o cliente do E3
aceite uma determinada instncia de servidor OPC UA.

Drivers 287
4.4.9 Limitaes na Leitura de Tipos de Dados
O Driver de Comunicao OPC UA do E3 suporta tipos bsicos e vetores de
uma dimenso, bem como alguns tipos de estruturas definidas pelo padro
OPC UA. So suportados valores escalares e vetores dos seguintes tipos:

Tipos suportados plenamente: SByte, Byte, Int16, UInt16, Int32, UInt32,

Int64, UInt64, Float, Double, Boolean, String, DateTime e ByteString

Tipos suportados com limitaes: DataValue (ignora a estampa de

tempo e a qualidade), LocalizedText (ignora a configurao regional),
QualifiedName (ignora o NamespaceIndex), StatusCode (convertido para
SCode ou HRESULT), Guid (convertido para texto), ArrayQualifiedName,
ArrayLocalizedText, Structure, ArrayStructure, ArrayDataValue,
Unknown e ArrayUnknown (no permitem a escrita na verso atual do
E3)

Tipos suportados convertidos para vetores de uma dimenso de

tamanho fixo: Estes tipos de dados so retornados como vetores de
Variants, em que cada um dos campos um item do vetor. Se o campo
for outro objeto, o Variant contm outro vetor, e assim por diante. Os
tipos suportados so ServerDiagnosticsSummaryDataType,
SubscriptionDiagnosticsDataType,
SessionSecurityDiagnosticsDataType, SessionDiagnosticsDataType,
ApplicationDescription, Argument, BuildInfo,
ServiceCounterDataType, ExpandedNodeId, NodeId,
ServerStatusDataType, EUInformation, Range, TimeZoneDataType,
StatusResult, ComplexNumberType, DoubleComplexNumberType,
XVType, RedundantServerDataType,
SamplingIntervalDiagnosticsDataType, EnumValueType,
NetworkGroupDataType e EndpointUrlListDataType

NOTA
Estruturas definidas por servidores especficos, no compatveis com o
padro OPC UA, no so lidas pelo E3.

288 Drivers
Nos campos da consulta, o texto dos caminhos dos Tags do servidor segue o
padro OPC UA de caminhos relativos. Os componentes deste caminho so
os seguintes:

/ (barra): Indica uma referncia hierrquica qualquer

. (ponto): Indica uma referncia de agregao qualquer

[ns:]browse-name: A String que segue uma barra ou ponto especifica o

nome de browse de um item. Este nome pode ser prefixado com seu
ndice de Namespace. Se for omitido, assumido o ndice 0 (zero)

& (e comercial, caractere de escape): Insere um caractere reservado no

local. Por exemplo, a expresso "&/Nome" substituda por "/Nome". Os
caracteres reservados so os seguintes:

/ (barra)

. (ponto)

< (menor que)

> (maior que)

: (dois pontos)

# (sinal numrico)

! (ponto de exclamao)

& (e comercial)

A definio formal de um caminho OPC UA, em notao BNF, a seguinte:

Drivers 289
 <caminho-relativo> ::= <tipo-referencia> <nome-browse>
<tipo-referencia> ::= '/' | '.' | '<' ['#'] ['!']
<nome-browse> '>'
<nome-browse> ::= [<indice-namespace> ':'] <nome>
<indice-namespace> ::= <digito> [<digito>]
<digito> ::= '0' | '1' | '2' | '3' | '4' | '5'
| '6' | '7' | '8' | '9'
<nome> ::= (<caractere-nome> | '&' <caractere-reservado>)
[<nome>]
<caractere-reservado> ::= '/' | '.' | '<' | '>' | ':'
| '#' | '!' | '&'
<caractere-nome> ::= Todos os caracteres vlidos
para uma String, exceto caracteres reservados.

O E3 no suporta Identificadores de Ns OPC UA (NodeIds) que no sejam

do servidor onde executado o browse dos Tags (servidores Gateway). Estes
Tags, portanto, no so mostrados na janela de seleo de servidores. Alm
disto, os caminhos so sempre hierrquicos e apenas os tipos de referncia
barra (/) e ponto (.) so suportados (o tipo <browse-name> no
suportado).

4.5 Qualidade
Os campos de qualidade representam o estado da qualidade do valor do
item. formado de uma palavra de 16 bits, sendo que os primeiros oito bits
so definidos na forma de trs campos de bits: Qualidade, Substatus e
Limite.

Os outros oito bits (de maior ordem) esto disponveis para uso de cada
fabricante. Se estes bits forem utilizados, os bits de qualidade padro ainda
so utilizados para indicar quais dedues pode-se fazer sobre os dados
retornados. Assim, de responsabilidade do cliente interpretar o campo de
informaes especficas de qualidade, para garantir que o servidor que est
provendo esta informao usa as mesmas regras do cliente.

Opes disponveis no campo Qualidade

QUALIDADE CAMPO QUALIDADE DESCRIO

0 - 63 Ruim O valor no til pelas
razes indicadas no
campo Substatus

290 Drivers
 QUALIDADE CAMPO QUALIDADE DESCRIO
64 - 127 Incerta A qualidade do valor
incerta pelas razes
indicadas no campo
Substatus

128 - 191 (Reservado) No usado pelo

padro OPC

192 - 255 Boa A qualidade do valor

boa

Um servidor que no suporta informao de qualidade retorna 192 (Bom)

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

4.5.1 Campo Substatus

O layout deste campo depende do valor do campo Qualidade.

Substatus para Qualidade RUIM

SUBSTATUS DESCRIO LIMITE

SEM BAIXO ALTO CONSTANT
LIMITE E
No O valor 0 1 2 3
especfico ruim, mas
nenhuma
razo
especifica
conhecida

Drivers 291
SUBSTATUS DESCRIO LIMITE
SEM BAIXO ALTO CONSTANT
LIMITE E
Erro de H algum 4 5 6 7
Configura problema
o de
configura
o especfico
no servidor.
Por
exemplo, o
item em
questo
pode ter
sido
apagado

No A entrada 8 9 10 11
Conectado deveria
estar
logicamente
conectada a
algo, mas
no est.
Esta
qualidade
pode
refletir que
no h
valor
disponvel
neste
momento,
pois o valor
pode no
ter sido
fornecido
pela fonte
de dados

292 Drivers
SUBSTATUS DESCRIO LIMITE
SEM BAIXO ALTO CONSTANT
LIMITE E
Falha de Uma falha 12 13 14 15
Dispositivo de
dispositivo
foi
detectada

Falha de Uma falha 16 17 18 19

Sensor de sensor
foi
detectada
(o campo
Limite
pode
conter
informao
adicional)

ltimo Comunica 20 21 22 23
valor o em falha.
conhecido Entretanto,
o ltimo
valor
conhecido
est
disponvel.
Note que a
idade do
valor pode
ser
determinad
a pela
propriedad
e
TimeStamp

Drivers 293
SUBSTATUS DESCRIO LIMITE
SEM BAIXO ALTO CONSTANT
LIMITE E
Falha de A 24 25 26 27
Comunica comunica
o o falhou.
No h
ltimo valor
conhecido
disponvel

Fora de O Bloco 28 29 30 31
Servio est fora
de scan ou
trancado

N/A No 32 - 63
utilizado

Substatus para Qualidade INCERTA

SUBSTATUS DESCRIO LIMITE

SEM BAIXO ALTO CONSTANT
LIMITE E
No No h 64 65 66 67
especfico razo
especfica

294 Drivers
SUBSTATUS DESCRIO LIMITE
SEM BAIXO ALTO CONSTANT
LIMITE E
ltimo O 68 69 70 71
valor dispositivo
utilizvel que estava
providencia
ndo o valor
parou de
faz-lo. O
valor
retornado
deve ser
considerad
o velho.
Note que
isto difere
de um valor
Ruim com
o
Substatus 5
(ltimo
valor
conhecido).
Aquele
estado
associado
com uma
falha
detectvel
de
comunica
o em um
valor
buscado.
Este erro
associado
com a falha
de alguma
fonte

Drivers 295
SUBSTATUS DESCRIO LIMITE
SEM BAIXO ALTO CONSTANT
LIMITE E
externa que
iria inserir
algo no
valor
dentro de
um perodo
aceitvel.
Note que a
idade do
valor pode
ser
determinad
a na
propriedad
e
TimeStamp

No No 72 - 79
utilizado utilizado

296 Drivers
SUBSTATUS DESCRIO LIMITE
SEM BAIXO ALTO CONSTANT
LIMITE E
Sensor O valor est 80 81 82 83
impreciso colado em
um dos
limites do
sensor
(neste caso
o campo
Limite deve
estar
configurado
para 1 ou
2) ou o
sensor est
de algum
modo
conhecido
fora de
calibrao
via algum
diagnstico
interno
(neste caso
o campo
Limite deve
ser zero)

Drivers 297
SUBSTATUS DESCRIO LIMITE
SEM BAIXO ALTO CONSTANT
LIMITE E
Unidade de O valor 84 85 86 87
engenharia retornado
excedida est fora
dos limites
definidos
para este
parmetro.
Note que
neste caso
o valor do
campo
Limite
indica quais
limites
foram
excedidos,
mas no
necessaria
mente
implica que
o valor no
possa ir
mais alm
da faixa
especificad
a

Subnormal O valor 88 89 90 91
derivado de
mltiplas
fontes e h
um nmero
menor do
que o
requerido
de fontes
boas

298 Drivers
SUBSTATUS DESCRIO LIMITE
SEM BAIXO ALTO CONSTANT
LIMITE E
No No 92 - 127
utilizado utilizado

NOTA
Servidores que no suportam o Substatus devem retornar 0 (zero).

Substatus para Qualidade BOA

SUBSTATUS DESCRIO LIMITE

SEM BAIXO ALTO CONSTANT
LIMITE E
No O valor 192 193 194 195
especfico bom. No
h
condies
especiais

No No 196 - 215
utilizado utilizado

Forado Tipicamente 216 217 218 219

localmente indica que a
entrada foi
desconecta
da e um
valor
manual foi
forado

No No 220 - 255
especfico utilizado

Drivers 299
NOTA
Servidores que no suportam o Substatus devem retornar 0 (zero).

4.5.2 Campo Limite

O campo Limite vlido independente dos campos Qualidade e Substatus.
Em alguns casos, como uma falha de sensor, ele pode prover informaes de
diagnstico.

Campo Limite

ESPECIFICAO DESCRIO
No Limitado O valor livre para mover-se acima
ou abaixo

Limite Inferior O valor est limitado em algum valor

inferior

Limite Superior O valor est limitado em algum valor

superior

Constante O valor uma constante e no pode

mover-se

NOTA
Servidores que no suportam o campo Limite devem retornar 0 (zero).

300 Drivers
 CAPTULO
Quadros
5
O objeto Quadro utilizado para organizar e estruturar a interface do
projeto, criando visualizaes compostas para o usurio dentro da janela
principal do Viewer ou do navegador. Muitas vezes, uma aplicao requer
apenas uma Tela principal, que a porta de entrada para a aplicao. A partir
da, o usurio pode navegar por outras Telas, que ocupam o lugar da
primeira, formando uma nica visualizao do processo. Porm, possvel
suportar mais de uma visualizao em um mesmo documento ou projeto. Isto
se torna til no caso de uma aplicao que utilize uma Tela que nunca muda,
ou que muda pouco (como, por exemplo, um menu), e outra parte que a
navegao das Telas propriamente ditas. Para utilizar este recurso, execute os
procedimentos a seguir.

1. Clique com o boto direito do mouse no nome do projeto no modo

Explorer e selecione a opo Inserir - Quadro. No modo Domnio, clique
com o boto direito do mouse no item Visualizao - Viewer e Quadros,
selecione a opo Inserir Quadro em e logo aps o nome do projeto
desejado.

Quadros 301
 Inserindo um Quadro no modo Domnio

O Quadro possui subdivises, chamadas de Divisores, que podem ser

inseridas ou removidas do Quadro atravs de um menu contextual na aba
Design do Editor do objeto. A princpio, o Quadro possui um Divisor inicial,
que pode ser subdividido horizontal ou verticalmente em dois Divisores, que
por sua vez tambm podem ser subdivididos em outros dois Divisores, e
assim sucessivamente.

A cada par de novos Divisores criados pelas opes Dividir

Horizontalmente e Dividir Verticalmente, h sempre um Divisor Principal e
um Divisor Secundrio. Apenas o Divisor Principal tem valores que definem
explicitamente o seu posicionamento, ficando o Divisor Secundrio com o
valor restante.

Assim, quando o Divisor subdividido horizontalmente, sua propriedade

SplitDockPosition recebe o valor dockTop. Do mesmo modo, se a
subdiviso for vertical, esta propriedade recebe o valor dockLeft. A
propriedade do Divisor Secundrio recebe, ento, o valor dockRemaining,
significando que este Divisor ocupa o espao restante.

302 Quadros
Os cones dos objetos no Organizer identificam exatamente o posicionamento
de cada Divisor.

Posicionamento do Divisor

CONE DESCRIO
dockBottom: Este Divisor est
posicionado na parte inferior do
Divisor Pai

dockTop: Este Divisor est

posicionado na parte superior do
Divisor Pai

dockLeft: Este Divisor est

posicionado esquerda do Divisor
Pai

dockRight: Este Divisor est

posicionado direita do Divisor Pai

dockRemaining: Este Divisor ocupa

o espao restante aps o
posicionamento de seu Divisor Irmo

Quadros 303
Cada Divisor corresponde visualizao de uma Tela ou Quadro de seu
processo ou a uma URL (Uniform Resource Locator). Para utilizar este recurso,
execute os procedimentos a seguir.

1. Clique com o boto direito do mouse no Quadro aberto e selecione uma

das opes: Dividir Horizontalmente ou Dividir Verticalmente,
conforme o tipo de Diviso desejada.

Inserindo um Divisor Horizontal ou

Vertical

2. Para remover um Divisor, clique com o boto direito do mouse no

Quadro aberto e selecione a opo Deletar.

304 Quadros
3. possvel inverter a seleo original dos Divisores (transformar o Divisor
Principal em Divisor Secundrio, e vice-versa) atravs deste mesmo menu.
No caso de um Divisor Principal, clique com o boto direito do mouse no
Quadro e selecione a opo Configurar como Divisor Secundrio. No
caso de um Divisor Secundrio, selecione a opo Configurar como
Divisor Principal. A propriedade SplitDockPosition dos Divisores
automaticamente configurada para refletir esta mudana.

4. Com a opo Selecionar Tela ou Quadro, possvel escolher a Tela ou

Quadro que associada propriedade SplitLink do Divisor selecionado,
usando o AppBrowser.

5. Pode-se inserir vrios Divisores no Quadro.

Divisores do Quadro

6. Para configurar os Divisores do Quadro, clique com o boto direito do

mouse no Divisor desejado no Organizer e selecione a opo
Propriedades.

Quadros 305
 Configuraes do Quadro

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Quadro

OPO DESCRIO
Tela ou Quadro Determina o caminho da Tela ou
Quadro que o Divisor abre. S
habilitado se o Divisor no tiver
nenhum filho. Este campo equivale
propriedade SplitLink

Posicionamento Determina a posio do Divisor no

Quadro. Este campo equivale
propriedade SplitDockPosition

Valor Determina o valor que atribudo ao

Quadro. S tem efeito visual se for
modificada no Divisor Principal. Este
campo equivale propriedade
SplitValue

306 Quadros
NOTAS
Todas as opes do Quadro que esto disponveis via menu contextual
(atravs do clique com o boto direito do mouse) tambm esto
disponveis utilizando a combinao de teclas SHIFT + F10, que
corresponde tecla de aplicao ou de menu .
A janela de propriedades de um Quadro pode ser aberta utilizando as
combinaes de teclas ALT + ENTER, CTRL + ALT + ENTER ou ALT +
duplo-clique do mouse.

Algumas das propriedades do Quadro ou Divisor podem ser configuradas

atravs da Lista de Propriedades, sem a necessidade da criao de scripts
para isto. Caso haja a necessidade de configurar alguma propriedade,
localize-a na Lista de Propriedades e faa os devidos ajustes. Para maiores
informaes, consulte o Manual de Referncia e Scripts do E3.

Quadros 307
 CAPTULO
Viewer
6
O objeto Viewer disponibiliza a visualizao da aplicao. Permite visualizar
Telas do projeto em modo de execuo e a operao do sistema. O Viewer
pode ser executado a partir de qualquer ponto da rede que tenha acesso ao
E3 Server. No necessrio copiar o aplicativo para os outros Viewers, pois
as Telas e bitmaps so baixados conforme a necessidade em tempo de
execuo. S pode existir um objeto Viewer em um Domnio.

Viewer no modo Domnio

Para criar um Viewer no projeto, siga este procedimento:

1. Verifique se j existe um Viewer no Domnio, ou insira um novo clicando

com o boto direito do mouse no nome do projeto no modo Explorer e
selecionando a opo Inserir - Viewer. No modo Domnio, clique com o
boto direito do mouse no item Visualizao - Viewer e Quadros,
selecione a opo Inserir Viewer em e logo aps o nome do projeto
desejado.

308 Viewer
NOTA
A qualidade grfica das Telas pode ser modificada, em tempo de execuo,
utilizando-se o menu contextual do Viewer e selecionando uma das opes
do menu Qualidade (todas as telas). Para maiores informaes, veja a
propriedade RenderQuality do Viewer no Manual de Referncia e Scripts
do E3.

6.1 Configurao
Atravs da janela de propriedades do Viewer, possvel especificar
configuraes do Viewer, Erros de comunicao, criar associaes ou scripts.

NOTA
A janela de propriedades do Viewer pode ser aberta utilizando as
combinaes de teclas ALT + ENTER, CTRL + ALT + ENTER ou ALT + duplo-
clique do mouse.

Viewer 309
6.1.1 Aba Visualizador
Atravs da aba Visualizador, so configuradas as opes do Viewer quanto a
ttulo, Tela e zoom, conforme explicado a seguir.

Aba Visualizador

Cada campo da aba Visualizador possui uma propriedade correspondente.

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Visualizador

OPO DESCRIO
Ttulo Determina o ttulo do Viewer. Este
campo equivale propriedade
Caption do objeto Viewer

310 Viewer
 OPO DESCRIO
Tela ou Quadro Inicial Determina a Tela ou Quadro que o
Viewer inicia. Clicando em ,o
Studio abre uma janela de
configurao, pela qual abre o
AppBrowser, onde especificada a
Tela inicial de visualizao. Este
campo equivale propriedade
InitialScreen do objeto Viewer

Zoom Determina o nvel de zoom para

visualizao no Viewer. Atravs das
suas opes, possvel configurar
como o Viewer inicializado. Este
campo equivale propriedade
InitialScreen do objeto Viewer, e
representado pelas especificaes
aps o caractere de ponto de
interrogao. Por exemplo, se na Tela
inicial o zoom de 100%, na
propriedade InitialScreen aparece a
descrio "TelaInicial?100", onde
TelaInicial o nome da Tela e ?100
a sua percentagem de zoom

Habilitar barra de rolagem na Tela Habilita a barra de rolagem na pgina

Inicial inicial

Exibir o menu do Zoom ao clicar Habilita a exibio do menu Zoom

com o boto direito do mouse com o boto direito do mouse, em
tempo de execuo. Este campo
equivale propriedade
EnableZoomMenu do objeto Viewer

Manter Telas carregadas na Habilita o Viewer a manter as Telas

memria carregadas em memria. Este campo
equivale propriedade CacheEnable
do objeto Viewer

Viewer 311
 OPO DESCRIO
Verificar inatividade aps ... Define o tempo mximo de espera,
minutos em minutos, por um evento de mouse
ou de teclado para o perodo de
inatividade. Este campo equivale
propriedade EnableInactivity do
objeto Viewer

Nmero de retentativas para Estabelece o nmero de vezes que a

confirmao de usurio ou senha caixa de dilogo de login exibida
alm da primeira vez. Este campo
equivale propriedade LoginRetries
do objeto Viewer

312 Viewer
6.1.2 Aba Configurao
Atravs da aba Configurao, pode-se editar as opes relativas janela, ao
ttulo e resoluo do Viewer.

Aba Configurao

Cada campo da aba Configurao possui uma propriedade correspondente.

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Configurao

Viewer 313
 OPO DESCRIO
Iniciar Maximizada / Minimizada / Determina o estilo da janela do
Janelada Viewer. Este campo equivale
propriedade WindowStyle e possui
as seguintes opes:

0 - Maximized: A Tela inicia

maximizada

1 - Windowed: Estilo janelada, isto

, pode ser configurada a altura e a
largura da Tela

2 - Minimized: A Tela inicia

minimizada

Desabilitar troca de janelas Desabilita a troca de janelas. Este

campo equivale propriedade
DisableTaskSwitching do objeto
Viewer. Esta opo pode ser
modificada em tempo de execuo
usando o mtodo
SetDisableTaskSwitching

Barra de ttulo Habilita a barra de ttulo. Este campo

equivale propriedade TitleBar do
objeto Viewer

Boto de fechar Habilita o boto de fechar. Este

campo equivale propriedade
CloseButton do objeto Viewer

Boto de minimizar Habilita o boto de minimizar. Este

campo equivale propriedade
MinimizeButton do objeto Viewer

Boto de maximizar Habilita o boto de maximizar. Este

campo equivale propriedade
MaximizeButton do objeto Viewer

314 Viewer
 OPO DESCRIO
Borda Habilita uma borda na janela do
Viewer. Este campo equivale
propriedade WindowBorder do
objeto Viewer

Opo de redimensionar Indica se a janela pode ser

redimensionada. Esta opo s tem
validade se a opo Borda estiver
marcada. Este campo equivale
propriedade WindowResizable do
objeto Viewer

Opo de mover Indica se a janela pode ser movida.

Este campo equivale propriedade
WindowMovable do objeto Viewer

Ficar sempre no topo Indica se a janela deve sempre se

sobrepor s outras janelas. Este
campo equivale propriedade
WindowStayOnTop do objeto Viewer

Barra de ttulo menor Habilita uma barra de ttulos pequena

na janela. Esta opo s tem efeito se
a opo Barra de ttulo estiver
marcada. Este campo equivale
propriedade WindowSmallTitle do
objeto Viewer

Resoluo da Tela Seleciona a resoluo da Tela: 640 x

480, 800 x 600, 1024 x 768, 1280 x
1024, ou 1600 x 1200 pixels

Avanado Abre a janela para configuraes

avanadas

Viewer 315
Ao clicar em Avanado, a janela da figura a seguir aberta.

Configuraes avanadas

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Configuraes avanadas

OPO DESCRIO
Resoluo da Tela em pixels Permite escolher entre a resoluo
atual do computador ou uma
resoluo escolhida pelo usurio, em
pixels

316 Viewer
 OPO DESCRIO
Desconto na resoluo da Tela em Permite escolher o desconto
pixels aplicado na resoluo da Tela entre
a configurao atual do computador
ou uma resoluo escolhida pelo
usurio, em pixels

Resoluo do monitor em pontos Permite escolher entre a resoluo

por polegada (DPI) atual do computador ou um
resoluo escolhida pelo usurio, em
pontos por polegada (DPI)

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

Aba Erros de comunicao

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Erros de Comunicao

OPO DESCRIO
Visualizar erros de comunicao Habilita ou desabilita a visualizao
dos erros de comunicao

Texto Contm o texto que mostrado no

Setpoint, caso a qualidade do valor
seja ruim

318 Viewer
 OPO DESCRIO
Cor da letra Contm a cor que deve ser usada no
texto

Cor de fundo Contm a cor que deve ser usada no

Setpoint. Equivale a uma alterao da
propriedade ForegroundColor do
Setpoint, mas esta alterao no
executada efetivamente. O valor da
propriedade do Setpoint no
alterado

6.2 Variveis no Viewer

No objeto Viewer possvel criar Associaes com objetos a partir de Telas,
bem como us-los via scripts. Tambm possvel inserir Tags Contador,
Demo, Interno e Timer no Viewer, alm de Pastas do Viewer e Consultas.
Atravs do AppBrowser, pode-se executar as seguintes aes:

Acessar o objeto Viewer ou algum de seus filhos a partir de uma Tela ou

controle de Tela (Associaes ou scripts)

Os filhos do objeto Viewer podem acessar outros filhos do Viewer ou o

prprio Viewer (Associaes ou scripts)

O prprio objeto Viewer pode acessar seus filhos (Associaes ou

scripts)

importante salientar que a Associao para o Viewer deve levar o nome real
do Viewer (por exemplo, "Viewer1") e no simplesmente "Application". Em
scripts, ainda vale o uso de Application, que uma propriedade de todos os
objetos que retornam o Viewer.

Viewer 319
6.3 Objeto _top
Quando um Viewer inserido no projeto, disponibiliza um Quadro filho. Este
Quadro filho chamado de _top. Este objeto possui as mesmas
funcionalidades do objeto Divisor do Quadro. Para utilizar este recurso, siga
estes procedimentos:

1. Clique em no item Visualizao - Viewer e Quadros - Viewer para

mostrar o Quadro _top.

Objeto _top

2. Para configurar as propriedades do objeto _top, clique com o boto

direito do mouse e selecione a opo Propriedades.

3. Este objeto possui as mesmas funcionalidades do objeto Divisor do

Quadro, e tais informaes podem ser encontradas nos captulos Telas e
Quadros.

320 Viewer
6.4 Pasta do Viewer
A Pasta do Viewer define grupos dentro do objeto Viewer de forma a
organizar os Tags do Viewer (Contador, Demo, Interno e Timer) e Consultas.
Caso haja necessidade, novas Pastas podem ser inseridas dentro de outras.
Para utilizar este recurso, siga este procedimento:

1. Clique com o boto direito do mouse no item Visualizao - Viewer e

Quadros - Viewer e selecione a opo Inserir - Panel - Pasta do Viewer.

Inserindo Pasta do Viewer

Viewer 321
NOTA
Uma aplicao que contenha Pastas do Viewer no pode ser aberta em
verses do E3 anteriores verso 3.1.

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

Telas e Objetos de Tela 323

7.1 Tela
A Tela o objeto bsico de interface com o usurio, e pode conter vrios
tipos de objetos. Os grficos inseridos na Tela podem ser apagados,
copiados, movidos, redimensionados, agrupados ou configurados.

Para inserir uma Tela no projeto, clique com o boto direito do mouse no
nome do projeto no modo Explorer e selecione a opo Inserir - Tela. No
modo Domnio, clique com o boto direito do mouse no item Visualizao -
Telas, selecione a opo Inserir Tela em e logo aps o nome do projeto
desejado.

Inserindo uma Tela no modo Domnio

Quando uma nova Tela criada, ou quando selecionada a opo Ajustar ao

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

324 Telas e Objetos de Tela

 Configurando o tamanho da Tela

Opes disponveis na janela Configurando o tamanho da Tela

OPO DESCRIO
Escolha o Divisor onde a Tela ser Permite escolher o Divisor onde a
aberta Tela aberta. So listados apenas os
Divisores cuja Tela associada
propriedade SplitLink visvel em
tempo de execuo

Configurar como Tela inicial do Habilita a Tela como Tela Inicial do

Divisor Divisor onde aberta

Nome Determina o nome da Tela

Largura (pixels) Determina a largura da Tela, em

pixels

Altura (pixels) Determina a altura da Tela, em pixels

Telas e Objetos de Tela 325

As opes Largura e Altura esto inicialmente preenchidas com o tamanho
que a Tela deve ter para poder ser exibida no Divisor escolhido, sem que
aparea uma barra de rolagem. Se algum dos valores for negativo, isto indica
que o Divisor no est visvel em tempo de execuo, em funo da
configurao do Viewer e do tamanho dos outros Divisores.

O E3 Studio fornece um editor dos objetos que podem ser inseridos em uma
Tela. Esto disponveis os seguintes objetos: Linha, Retngulo, Retngulo
Arredondado, Elipse, Arco de Elipse, Desenho Livre, Polgono, Polgono de
Curvas, Figura (Imagem), Texto, Display, SetPoint, Escala e MSForms. Os
MSForms so discutidos no captulo ActiveX e os demais objetos citados so
apresentados neste captulo.

Tela

Pode-se configurar as propriedades da Tela para determinar tamanho, cor e

outros aspectos do comportamento e da aparncia, alm de vrios tipos de
eventos. Estes objetos utilizam como padro para o tamanho e coordenadas
as unidades Himetric, dadas em 1/100 mm, e no em pixels.

326 Telas e Objetos de Tela

Todas das propriedades da Tela podem ser configuradas atravs da Lista de
Propriedades, sem a necessidade de se criar scripts para isto. Caso necessite
configurar alguma propriedade, localize-a na Lista de Propriedades e faa os
devidos ajustes.

NOTA
A qualidade grfica de uma Tela pode ser modificada, em tempo de
execuo, utilizando-se o menu contextual do Viewer e selecionando uma
das opes do menu Qualidade (esta tela). Para maiores informaes, veja
a propriedade RenderQuality da Tela no Manual de Referncia e Scripts
do E3.

7.2 Objetos de Tela

Os seguintes objetos podem ser inseridos em uma Tela:

Primitivas do Editor Grfico (Retas, Crculos, Retngulos, Polgonos, etc.)

Controles ActiveX fornecidos pela Elipse (E3Alarm, E3Browser, E3Chart e

E3Playback)

Controles ActiveX fornecidos por terceiros

Imagens no vetoriais (Arquivos BMP, JPG, GIF, etc.)

Imagens vetoriais (Arquivos WMF, EMF, etc.)

Controles Padro do Windows (Lista, Editor de Texto, Lista de Seleo,

etc.)

Objetos ElipseX, compostos de qualquer dos objetos anteriores

Pastas do Viewer, Consultas, Tags Contador, Demo, Interno e Timer

As primitivas do editor grfico disponveis no Studio so listadas nos

prximos tpicos. Elas podem ser rotacionadas ou redimensionadas
livremente, exceto pelo objeto Figura. Aps ter sido criado, cada objeto
permanece selecionado para facilitar a edio de suas propriedades, caso
seja necessrio.

Telas e Objetos de Tela 327

7.2.1 Arco de Elipse
Permite o desenho de objetos do tipo arco, corda ou torta. Para utilizar este
objeto, siga estes procedimentos:

1. Selecione o Arco de Elipse na barra de ferramentas Tela.

2. Clique na Tela para estabelecer o ponto inicial do desenho e arraste o

mouse diagonalmente at o desenho atingir o tamanho e a posio
desejados.

3. Nas duas extremidades do corte, aparecem dois pontos responsveis

pela posio de abertura do desenho. Arraste-os de forma que o
desenho fique mais aberto ou mais fechado.

4. O formato do desenho inicial o de torta. Para alter-lo para arco ou

corda, utilize a propriedade ArcStyle na Lista de Propriedades.

328 Telas e Objetos de Tela

7.2.2 Conector
Este objeto utilizado para conectar dois ou mais objetos de Tela atravs de
uma linha. Os objetos de Tela que podem ser conectados so o Retngulo, o
Retngulo Arredondado, a Elipse, o Arco de Elipse, o Desenho Livre, o
Polgono e o Polgono de Curvas. Ao clicar em na barra de ferramentas
Tela, os objetos anteriormente citados mostram seus pontos de conexo,
como na figura a seguir.

Pontos de conexo de objetos de Tela

Para conectar dois objetos, clique em um dos pontos de conexo do primeiro

objeto e, em seguida, clique em um dos pontos de conexo do segundo
objeto. Sempre que se passa o mouse sobre um ponto de conexo, seu cone
muda de para , indicando qual ponto deve ser conectado.

Aps a criao do Conector, tambm possvel desconectar seus vrtices.

Para isto, arraste o vrtice para longe do ponto de conexo do objeto. Para
reconectar, arraste-o para perto de um ponto de conexo at que seu cone
mude para .

Para criar uma conexo entre mais de dois pontos de conexo, mantenha
pressionada a tecla CTRL enquanto seleciona todos os pontos desejados.

Para excluir um Conector, selecione-o e utilize a tecla DELETE. Se um objeto

que possua um Conector for excludo, o Conector no excludo.

Para informaes sobre Conectores em objetos XControl, veja o tpico a

seguir.

Telas e Objetos de Tela 329

7.2.2.1 Conectores em XControls

Os Conectores em objetos de Tela criados dentro de XControls devem ter

seus pontos de conexo definidos previamente, clicando-se em na barra
de ferramentas Tela. Ao selecionar esta ferramenta e clicar em um ponto de
conexo, a janela da figura a seguir mostrada.

Janela de edio de pontos de conexo

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Novo Ponto de Conexo

OPO DESCRIO
Nome do Ponto de Conexo Permite definir um nome para o
Ponto de Conexo

Conectado a Mostra em qual Ponto de Conexo

do objeto de Tela o Ponto de
Conexo do XControl est conectado

Utilizar como "Ponto ncora" do Marca este Ponto de Conexo como

objeto o ponto ncora do objeto. Este
ponto ncora pode ser alterado
quando o XControl for inserido em
uma Tela. Veja tambm o tpico
Ponto ncora para maiores
informaes

330 Telas e Objetos de Tela

Para editar ou excluir um ponto criado, clique com o boto direito do mouse
no ponto e selecione a opo Excluir Ponto de Conexo ou Editar Ponto de
Conexo, conforme a figura a seguir. Um ponto de conexo tambm pode
ser excludo clicando-se nele com a tecla CTRL pressionada.

Excluir ou editar um ponto de conexo

Caso no seja definido nenhum Ponto de Conexo para os objetos de Tela

includos no XControl, no possvel conectar este XControl a nenhum outro
objeto de Tela, quando ele for includo em uma Tela.

7.2.3 Desenho Livre

Permite a criao de desenhos mo livre. Para utilizar este objeto, siga estes
procedimentos:

1. Selecione o Desenho Livre na barra de ferramentas Tela.

2. Clique na Tela para estabelecer o ponto inicial do desenho e arraste o

mouse em qualquer direo tantas vezes quantas forem necessrias para
completar o desenho desejado.

Telas e Objetos de Tela 331

7.2.4 Display
Permite criar um objeto que utilizado para mostrar os valores dos Tags em
tempo de execuo. Para utilizar este objeto, siga estes procedimentos:

1. Selecione o Display na barra de ferramentas Tela.

2. Clique na Tela para criar o vrtice de origem do objeto e arraste o mouse

diagonalmente at seu vrtice final.

3. Clique com o boto direito do mouse no objeto para abrir a Janela de

Propriedades. Na aba Item, selecione o Tag a ser associado
propriedade Value do Display.

7.2.5 Elipse
Permite o desenho de crculos e elipses. Para utilizar este objeto, siga estes
procedimentos:

1. Selecione a Elipse na barra de ferramentas Tela.

2. Clique na Tela para estabelecer o ponto inicial do desenho e arraste o

mouse diagonalmente at o desenho atingir o tamanho e a posio
desejados.

7.2.6 Escala
Permite a criao de um objeto que desenha rguas ou escalas de valores.
Para utilizar este objeto, siga estes procedimentos:

1. Selecione a Escala na barra de ferramentas Tela.

2. Clique na Tela para criar o vrtice de origem do objeto e arraste o mouse

diagonalmente at seu vrtice final.

332 Telas e Objetos de Tela

7.2.7 Figura
Permite mostrar imagens que estejam armazenadas em arquivos, que podem
ou no pertencer aplicao. A Figura pode ser redimensionada livremente,
porm a rotao e a animao s so efetivas quando esta for um metafile
convertido para smbolo. Os seguintes formatos de arquivo so suportados:
Bitmap (.bmp), Graphics Interchange Format (.gif), Joint Photographic Experts
Group (.jpg), ICO File Format (.ico), Windows Metafile (.wmf), Enhanced Metafile
(.emf), Portable Network Graphics (.png) e Tagged Image File Format (.tif). Para
utilizar este objeto, siga estes procedimentos:

1. Selecione a Figura na barra de ferramentas Tela.

2. Clique na Tela para criar o vrtice de origem do retngulo e arraste o

mouse diagonalmente at seu vrtice final.

3. O Studio abre uma caixa de dilogo para seleo do arquivo de imagem,

conforme a figura a seguir.

Seleo do arquivo de imagem

4. Selecione o arquivo desejado e clique em Abrir para inserir a figura na

Tela.

Telas e Objetos de Tela 333

7.2.8 Linha
Permite o desenho de retas, ligando dois pontos especificados na sua criao.
Para utilizar este objeto, siga estes procedimentos:

1. Selecione a Linha na barra de ferramentas Tela.

2. Clique na Tela para criar o ponto de origem da reta e arraste o mouse at

seu ponto final.

7.2.9 Polgono
Permite o desenho de polgonos com lados retos. Para utilizar este objeto,
siga estes procedimentos:

1. Selecione o Polgono na barra de ferramentas Tela.

2. Clique na Tela para estabelecer o vrtice inicial do desenho e arraste o

mouse em qualquer direo tantas vezes quantas forem necessrias para
completar o desenho desejado.

3. Quando desejar trocar a direo do desenho, clique uma vez com o

mouse. Quando desejar finaliz-lo, clique duas vezes com o mouse.

7.2.10 Polgono de Curvas

Permite o desenho de polgonos com lados curvos. Para utilizar este objeto,
siga estes procedimentos:

1. Selecione o Polgono de Curvas na barra de ferramentas Tela.

2. Clique na Tela para estabelecer o vrtice inicial do desenho e arraste o

mouse em qualquer direo tantas vezes quantas forem necessrias para
completar o desenho desejado.

3. Quando desejar trocar a direo do desenho, clique uma vez com o

mouse. Quando desejar finaliz-lo, clique duas vezes com o mouse.

334 Telas e Objetos de Tela

7.2.11 Retngulo
Permite o desenho de retngulos, criados a partir de dois vrtices. Para
utilizar este objeto, siga estes procedimentos:

1. Selecione o Retngulo na barra de ferramentas Tela.

2. Clique na Tela para criar o vrtice de origem do Retngulo e arraste o

mouse diagonalmente at seu vrtice final, at o desenho atingir o
tamanho e a posio desejados.

7.2.12 Retngulo Arredondado

Permite o desenho de retngulos com cantos arredondados, criados a partir
de dois vrtices. Para utilizar este objeto, siga estes procedimentos:

1. Selecione o Retngulo Arredondado na barra de ferramentas Tela.

2. Clique na Tela para criar o vrtice de origem do retngulo e arraste o

mouse diagonalmente at seu vrtice final, at o desenho atingir o
tamanho e a posio desejados.

3. No canto superior esquerdo do objeto, aparece o ponto responsvel pelo

fator de arredondamento do retngulo. Arraste-o mais para o centro ou
mais para as bordas para determinar a curva de seus vrtices.

7.2.13 SetPoint
Permite criar um objeto que funciona como uma caixa de edio onde so
inseridos contedos a serem atribudos a Tags associados. Para utilizar este
objeto, siga estes procedimentos:

1. Selecione o SetPoint na barra de ferramentas Tela.

2. Clique na Tela para criar o vrtice de origem do objeto e arraste o mouse

diagonalmente at seu vrtice final.

3. Clique com o boto direito do mouse no objeto para abrir a Janela de

Propriedades. Na aba Item, selecione o Tag a ser associado
propriedade Value do SetPoint.

Telas e Objetos de Tela 335

7.2.14 Texto
Permite a criao de um texto a ser exibido na Tela. Para utilizar este objeto,
siga estes procedimentos:

1. Selecione o Texto na barra de ferramentas Tela.

2. Digite o texto desejado e pressione a tecla ENTER.

3. Caso queira alterar ou digitar contedos neste objeto, utilize a

propriedade Value.

7.3 Configuraes Gerais

As configuraes dos tpicos a seguir podem ser aplicadas Tela ou aos
seus objetos.

NOTA
Todas as opes da Tela e dos objetos de Tela que esto disponveis via
menu contextual (atravs do clique com o boto direito do mouse)
tambm esto disponveis utilizando a combinao de teclas SHIFT + F10,
que corresponde tecla de aplicao ou de menu .
A janela de propriedades da Tela e dos objetos de Tela pode ser aberta
utilizando as combinaes de teclas ALT + ENTER, CTRL + ALT + ENTER ou
ALT + duplo-clique do mouse.

336 Telas e Objetos de Tela

7.3.1 Agrupar ou Desagrupar
Permite transformar mais de um objeto em apenas um, com propriedades
especficas. Para utilizar este recurso, siga estes procedimentos:

1. Selecione na Tela os objetos que devem formar o grupo.

2. Clique em Agrupar para criar um novo objeto. Esta operao pode ser
realizada em cascata, e um grupo pode conter qualquer objeto, inclusive
outros grupos.

3. Para desfazer a unio de um grupo de objetos, clique em Desagrupar .

4. Para editar um objeto contido em um grupo, clique com o boto direito

do mouse no objeto e selecione a opo Editar Grupo.

NOTA
possvel ajustar os objetos dentro de um grupo ao pixel mais prximo
(efeito Snap to Pixel), utilizando-se a combinao de teclas CTRL + BARRA
DE ESPAO. Neste caso, o efeito aplicado a cada um dos objetos dentro
do grupo, podendo ser desfeito utilizando-se a combinao de teclas
CTRL + Z.
Para sair do modo de edio de um grupo de objetos de Tela, clique duas
vezes na rea da Tela fora do grupo.

Telas e Objetos de Tela 337

7.3.2 Alinhamento
Permite alinhar os objetos de Tela entre si ou em relao Tela. As opes de
alinhamento disponveis esto descritas na tabela a seguir.

Opes de alinhamento para objetos de Tela

CONE OPO DESCRIO

Alinhar Esquerda Alinha dois ou mais
objetos entre si, tendo
como referncia a
coordenada esquerda
do ltimo objeto
selecionado

Alinhar Direita Alinha dois ou mais

objetos entre si, tendo
como referncia a
coordenada direita
do ltimo objeto
selecionado

Alinhamento Superior Alinha dois ou mais

objetos entre si, tendo
como referncia a
coordenada superior
do ltimo objeto
selecionado

Alinhamento Inferior Alinha dois ou mais

objetos entre si, tendo
como referncia a
coordenada inferior do
ltimo objeto
selecionado

338 Telas e Objetos de Tela

 CONE OPO DESCRIO
Alinhamento Central Alinha dois ou mais
Horizontal objetos horizontalmente
entre si, tendo como
referncia o ltimo
objeto selecionado

Alinhamento Central Alinha dois ou mais

Vertical objetos verticalmente
entre si, tendo como
referncia o ltimo
objeto selecionado

Mesma Largura Aplica a largura do

ltimo objeto
selecionado aos demais
objetos selecionados

Mesma Altura Aplica a altura do

ltimo objeto
selecionado aos demais
objetos selecionados

Mesmo Tamanho Aplica a largura e a

altura do ltimo objeto
selecionado aos demais
objetos selecionados

Centralizar Centraliza o objeto na

Horizontalmente Tela, de acordo com
suas coordenadas
horizontais

Centralizar Centraliza o objeto na

Verticalmente Tela, de acordo com
suas coordenadas
verticais

Telas e Objetos de Tela 339

 CONE OPO DESCRIO
Distribuir Aplica a mesma
Horizontalmente distncia horizontal
entre si a trs ou mais
objetos

Distribuir Aplica a mesma

Verticalmente distncia vertical entre
si a trs ou mais
objetos

Espelhar Aplica o efeito de

Horizontalmente reflexo horizontal aos
objetos selecionados

Espelhar Verticalmente Aplica o efeito de

reflexo vertical aos
objetos selecionados

NOTAS
As opes Espelhar Horizontalmente e Espelhar Verticalmente tm o
seguinte comportamento:
Para selees mltiplas, cada um dos objetos espelhado
individualmente
O estado dos botes se altera (pressionado ou no) conforme os
objetos tenham sido refletidos verticalmente ou horizontalmente, mas
somente se o estado de reflexo igual para todos os objetos
selecionados
Os botes ficam desabilitados se a Tela estiver selecionada ou se no h
nenhum objeto selecionado
Os objetos de Tela podem ser ajustados ao pixel mais prximo (efeito
Snap to Pixel), utilizando-se a combinao de teclas CTRL + BARRA DE
ESPAO.

340 Telas e Objetos de Tela

7.3.3 Animao
Recurso que aplica movimento a um objeto em tempo de execuo, e que
est disponvel na barra de ferramentas Tela. Os tipos de movimentos
disponveis so os seguintes:

Animao com Translao : O objeto que recebe este recurso faz

movimentos lineares de acordo com as configuraes das propriedades no
objeto. Para habilitar esta opo, siga estes procedimentos:

1. Selecione o objeto na Tela e clique em Animar com Translao .

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

objeto.

Animao com Translao

Animao com Rotao : O objeto que recebe este recurso faz

movimentos circulares de acordo com o centro de rotao do objeto e seu
ngulo. Para habilitar esta opo, siga estes procedimentos:

1. Selecione o objeto na Tela e clique em Animar com Rotao .

2. Quando o objeto criado, seu centro de rotao padro definido como

o centro do objeto, com uma inclinao de 0 (zero) graus de posio da
horizontal em relao a este centro. Neste momento, os vrtices do
objeto selecionado so indicados por pequenos crculos e seu centro por
dois crculos circunscritos.

3. Ao passar o mouse sobre o centro ou vrtices, possvel modificar o

centro arrastando ou rotacionando o objeto de um de seus vrtices em
relao ao centro.

Telas e Objetos de Tela 341

 Animao com Rotao

NOTA
Para objetos de Tela do tipo Figura que utilizem o formato de arquivo
Bitmap (arquivos com extenso .bmp), o recurso de animao no est
disponvel.

7.3.4 Aplicar Estilo

Aplica o estilo configurado como padro na opo Configurar como Padro
a objetos previamente criados. Para utilizar este recurso, siga estes
procedimentos:

1. Selecione o objeto ao qual o padro deve ser aplicado.

2. Clique com o boto direito do mouse e selecione a opo Aplicar Estilo.

342 Telas e Objetos de Tela

7.3.5 Camadas
O E3 oferece uma arquitetura de Telas com at 32 camadas para insero de
objetos. Cada objeto pode pertencer a uma ou mais camadas, e a Tela ativa
tanto em tempo de configurao (no E3 Studio) quanto em tempo de
execuo (no E3 Viewer) pode estar com nenhuma, uma, vrias ou todas as
camadas ativas. Isto permite criar sistemas com vrias formas de
monitoramento, como por exemplo a visualizao de um processo apenas
com o sistema eltrico, apenas o hidrulico ou ambos. possvel tambm
controlar o aparecimento de camadas de acordo com um determinado nvel
de zoom. A configurao das camadas feita clicando-se em Camadas na
barra de ferramentas Tela. As opes disponveis esto descritas na tabela a
seguir.

Opes disponveis para a configurao de Camadas

OPO DESCRIO
Camada Habilita a visualizao da camada
configurada na propriedade Layer
da Tela

Todas as camadas Mostra todas as camadas

disponveis no projeto

Nenhuma camada Nenhuma camada mostrada

Editar camadas Atravs desta opo, pode-se

configurar camadas individuais. Esta
opo abre uma caixa de dilogo
para configurao da camada

Telas e Objetos de Tela 343

Quando a opo Editar camadas selecionada, a janela da figura a seguir
mostrada.

Edio de Camadas

A janela Edio de Camadas tem as seguintes opes: Adicionar Camada ,

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

344 Telas e Objetos de Tela

 Adio ou edio de camadas

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na Camada

OPO DESCRIO
Nome da Camada Determina o nome da camada

Zoom Baixo Define a porcentagem inicial de

zoom na camada

Zoom Alto Define a porcentagem final de zoom

na camada

Usar condio adicional de Habilita a utilizao de uma

visibilidade condio adicional de visibilidade
de zoom na camada. Esta condio
pode ser uma varivel ou
propriedade qualquer

Telas e Objetos de Tela 345

 OPO DESCRIO
Fonte Estabelece uma Associao ou uma
propriedade que, uma vez ativa
(diferente de zero), tambm exibe a
camada (as opes de Zoom e
Fonte no so exclusivas, isto ,
podem ativar a camada estando
uma ou outra condio ativa)

Para maiores informaes, consulte o Manual de Referncia e Scripts do E3.

7.3.6 Configurar como Padro

Configura as opes editadas nas barras de ferramentas Sombra e Desenho
como padro para os demais objetos de Tela que forem criados. Para utilizar
este recurso, siga estes procedimentos:

1. Selecione o objeto que vai servir como modelo para os demais.

2. Clique com o boto direito do mouse e selecione a opo Configurar

como Padro.

3. Ao criar um novo objeto de Tela, as configuraes de Sombra e Desenho

deste objeto so utilizadas como configuraes iniciais dos prximos
objetos.

346 Telas e Objetos de Tela

7.3.7 Desenho
Permite aplicar ou editar informaes relativas s cores de fundo e frente da
Tela e objetos de Tela e borda dos objetos de Tela.

Opes de desenho

Para utilizar este recurso, siga estes procedimentos:

1. Insira ou selecione o objeto (Tela ou objeto de Tela) cujas cores ou

bordas deseja editar.

2. Altere suas propriedades de acordo com as opes disponveis na barra

de ferramentas Desenho.

As opes disponveis nesta barra de ferramentas esto descritas na tabela a

seguir.

Opes disponveis na barra de ferramentas Desenho

CONE OPO DESCRIO

Cor do Fundo Permite selecionar a
cor de fundo da Tela
ou do objeto de Tela a
partir de uma lista de
cores pr-
estabelecidas, ou criar
uma nova cor
personalizada

Telas e Objetos de Tela 347

 CONE OPO DESCRIO
Cor da Frente Permite selecionar a
cor de frente da Tela
ou do objeto de Tela a
partir de uma lista de
cores pr-
estabelecidas, ou criar
uma nova cor
personalizada

Cor da Borda Permite selecionar a

cor da borda do
objeto de Tela a partir
de uma lista de cores
pr-estabelecidas, ou
criar uma nova cor
personalizada

Estilo da Borda Permite escolher o tipo

de borda exibida pelo
objeto de Tela a partir
de uma lista com
estilos pr-
estabelecidos: uma
linha contnua,
diferentes tipos de
pontilhados e
tracejados, ou
simplesmente nenhuma
borda

Espessura da Linha Permite escolher a

espessura da linha da
borda do objeto de
Tela a partir de uma
lista com espessuras
pr-estabelecidas entre
0 e 2,5 milmetros

348 Telas e Objetos de Tela

 CONE OPO DESCRIO
Estilo do Permite escolher o tipo
Preenchimento de preenchimento
exibido pela Tela ou
pelo objeto de Tela,
isto , como se d a
combinao entre as
cores de fundo e de
frente do objeto. Ao
selecionar esta opo,
a janela mostrada na
figura a seguir aberta

Efeitos de preenchimento

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Preenchimento

Telas e Objetos de Tela 349

 OPO DESCRIO
Estilos Mostra todos os estilos de
preenchimento disponveis para o
objeto selecionado

Cor da frente Mostra a cor da frente previamente

selecionada para o objeto. Permite
tambm a seleo de uma nova cor de
frente (o mesmo que clicar em )

Cor do fundo Mostra a cor de fundo previamente

selecionada para o objeto. Permite
tambm a seleo de uma nova cor de
fundo (o mesmo que clicar em )

Amostra Mostra como o efeito escolhido

aplicado com as cores de fundo e de
frente do objeto

Opaco ou Transparente Ao selecionar a opo Transparente,

os preenchimentos com efeito
hachurado no mostram a cor de
fundo do objeto selecionado, somente
a cor de frente, criando um efeito de
transparncia no objeto. Ao selecionar
a opo Opaco, este efeito no
acontece. NOTA: A opo
Transparente est desabilitada para a
Tela

350 Telas e Objetos de Tela

7.3.8 Grade
Conjunto de linhas horizontais e verticais que servem como referncia de
posicionamento para objetos na Tela. Ela visualizada somente no E3 Studio,
e no em tempo de execuo.

No E3 Studio, possvel mostrar ou esconder a grade atravs do menu

Arranjar - Grade, ou clicando em na barra de ferramentas Alinhamento.

As propriedades da Grade podem ser configuradas atravs do menu Arranjar

- Edio da Grade. Ao selecionar esta opo, a janela da figura a seguir
mostrada.

Janela Propriedades da Grade

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Propriedades da Grade

OPO DESCRIO
Pontilhada A grade mostra pontos apenas nas
interseces de linhas

Telas e Objetos de Tela 351

 OPO DESCRIO
Linhas pontilhadas A grade mostra a linha inteira
pontilhada

Alinhar mouse automaticamente Alinha o mouse grade

automaticamente

Comprimento Determina a distncia entre as linhas

horizontais

Largura Determina a distncia entre as linhas

verticais

Cor Determina a cor da grade

352 Telas e Objetos de Tela

7.3.9 Mover
Permite mover o contedo de uma Tela que contenha barras de rolagem no
Studio ou no Viewer, em tempo de execuo. Para utilizar este recurso no
Studio, siga estes procedimentos:

1. Selecione a opo Mover na barra de ferramentas Tela.

2. Clique na Tela desejada para arrast-la. O ponteiro do mouse muda para

o cone .

Para utilizar este recurso no Viewer, siga este procedimento:

1. Clique com o boto direito do mouse no Viewer e selecione a opo

Mover do menu contextual.

NOTAS
Tanto no Studio quanto no Viewer, a opo Mover est sempre disponvel
ao utilizar o boto do meio do mouse.
No Viewer, ou seja, em tempo de execuo, clicar em objetos de Tela
como Botes, Displays e SetPoints, entre outros, impede o uso da opo
Mover, visto que os objetos de Tela capturam o comportamento do
cursor do mouse. Nestes casos, deve-se utilizar as opes disponveis
para a opo Mover (boto do meio do mouse ou menu contextual)
somente nas reas de Tela.

Telas e Objetos de Tela 353

7.3.10 Ordem de Navegao entre os Objetos
Estabelece a ordem de navegao, atravs da tecla TAB, entre dois ou mais
objetos em tempo de execuo (isto , a ordem em que os objetos ganham
foco). Para habilitar esta opo, siga estes procedimentos:

1. Selecione a Tela e clique em Ordem dos Tabs , na barra de

ferramentas Tela.

2. Clique nos objetos conforme a ordenao desejada. O nmero com a

ordem de navegao aparece no canto superior esquerdo do objeto.

3. Quando o Domnio for executado, a navegao entre estes objetos feita

conforme a ordem especificada.

Ordem dos Tabs

Para manter a ordem inicial dos objetos, necessrio seguir estes

procedimentos:

1. Aps ter criado o objeto na Tela, clique em Ordem dos Tabs .

2. Com a tecla CTRL pressionada, clique no penltimo objeto.

3. Solte a tecla CTRL e clique no ltimo objeto (objeto criado anteriormente).

354 Telas e Objetos de Tela

NOTA
A ordem de tabulao equivalente ordem de sobreposio dos objetos,
descrita no tpico Sobreposio de Objetos.

7.3.11 Ponto ncora

Um Ponto ncora definido como as coordenadas que marcam o ponto
inicial do objeto. Inicialmente, o ponto ncora est atrelado s coordenadas
iniciais do objeto.

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

Objeto com ponto ncora

NOTA
Ao utilizar a combinao de teclas CTRL + BARRA DE ESPAO (efeito Snap to
Pixel) em um objeto com a opo Definir Ponto ncora habilitada, o objeto
movido para o pixel mais prximo, sem respeitar a posio do ponto
ncora. Caso seja utilizado o mouse para mover o objeto, o ponto ncora
posicionado exatamente em cima de um pixel. Para corrigir eventuais
discrepncias no posicionamento do objeto, pode-se utilizar a combinao
CTRL + BARRA DE ESPAO aps soltar o boto do mouse.

Telas e Objetos de Tela 355

7.3.12 Rotacionar
Permite rotacionar um objeto de Tela tendo como origem seu centro ou
qualquer outro ponto na Tela. Para utilizar este recurso, siga estes
procedimentos:

1. Selecione um objeto na Tela e clique em Rotacionar na barra de

ferramentas Tela.

2. Clique em um de seus vrtices de rotao (em verde) e arraste o objeto

at a posio desejada.

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

um crculo verde).

NOTA
Para objetos de Tela do tipo Figura que utilizem o formato de arquivo
Bitmap (arquivos com extenso .bmp), o recurso de rotao no est
disponvel.
No caso de alterao no centro de rotao de um objeto de Tela, o menu
contextual do objeto passa a exibir a opo Redefinir Centro de Rotao,
que permite desfazer a alterao e retornar o centro de rotao do objeto
ao seu padro.

7.3.13 Sobreposio de Objetos

Permite editar o modo como dois ou mais objetos esto sobrepostos. As
opes disponveis na barra de ferramentos Tela esto descritas na tabela a
seguir.

Opes disponveis na barra de ferramentas Tela

CONE OPO DESCRIO

Trazer para a Frente O objeto selecionado
enviado para a primeira
posio na ordem de
sobreposio (ALT +
HOME)

356 Telas e Objetos de Tela

 CONE OPO DESCRIO
Enviar para Trs O objeto selecionado
enviado para a ltima
posio na ordem de
sobreposio (ALT +
END)

Avanar O objeto selecionado

avana uma posio na
ordem de sobreposio
dos objetos (ALT +
PAGE UP)

Recuar O objeto selecionado

recua uma posio na
ordem de sobreposio
dos objetos (ALT +
PAGE DOWN)

7.3.14 Sombreamento
Permite aplicar ou editar o efeito de sombra em um objeto de Tela.

Opes da sombra

Para utilizar este recurso, siga estes procedimentos:

1. Insira ou selecione o objeto ao qual deseja aplicar a sombra.

2. Altere suas propriedades atravs da barra de ferramentas Sombra, de

acordo com as opes mostradas na tabela a seguir.

Opes disponveis na barra de ferramentas Sombra

OPO DESCRIO
Habilita ou desabilita o efeito de
sombra no objeto

Telas e Objetos de Tela 357

 OPO DESCRIO

Desloca a sombra abaixo do objeto

Desloca a sombra acima do objeto

Desloca a sombra esquerda do

objeto

Desloca a sombra direita do

objeto

Configura a cor da sombra do

objeto

7.3.15 Travar
Ao selecionar esta opo, o E3 Studio no permite que o objeto seja movido,
evitando movimentos indesejados. Depois de travado, o mouse exibe um
cursor com um cadeado ao ser deslocado sobre a rea do objeto.

Para habilitar esta opo, clique com o boto direito do mouse no objeto
desejado e selecione a opo Travar .

Objeto travado

Para desabilitar esta opo, clique novamente com o boto direito do mouse
no objeto e selecione a opo Destravar .

358 Telas e Objetos de Tela

7.3.16 Zoom
Na edio da Tela, pode-se escolher livremente o nvel de zoom desejado e
mais confortvel para a edio. O zoom est disponvel atravs do menu
contextual Zoom, e possui nveis que vo de 10% a 800%, alm das opes
Toda Largura, Toda Altura, Toda Pgina e Preencher, conforme a figura a
seguir.

Menu Zoom

Alm do menu Zoom, possvel modificar o nvel de zoom atravs do teclado

e mouse, utilizando as seguintes combinaes:

CTRL + SINAL DE MAIS (+): Aumenta o zoom

CTRL + SINAL DE MENOS (-): Diminui o zoom

Telas e Objetos de Tela 359

 CTRL + ASTERISCO (*) ou CTRL + 0 (ZERO): Volta para o zoom padro
(100%)

CTRL + Roda do mouse para cima: Aumenta o zoom

CTRL + Roda do mouse para baixo: Diminui o zoom

NOTA
Ao utilizar as opes de CTRL + Roda do mouse (para cima ou para baixo),
o foco do zoom sempre relativo posio do ponteiro do mouse.

360 Telas e Objetos de Tela

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

Cores

A opo Outra permite que o usurio selecione uma cor de qualquer parte da
tela, dentro ou fora do E3 Studio. Clique em e aps na cor desejada para
que ela seja capturada para a janela de cores.

Para personalizar uma cor, pode-se combinar duas metodologias: RGB

(componentes de vermelho, verde e azul) ou HSL (componentes de matiz,
saturao e luminosidade).

Telas e Objetos de Tela 361

 Cor personalizada

A escala RGB descreve uma cor atravs da mistura de trs cores bsicas, a
saber:

Red (vermelho): Indica a quantidade do componente primrio vermelho

na composio da cor

Green (verde): Indica a quantidade do componente primrio verde na

composio da cor

Blue (azul): Indica a quantidade do componente primrio azul na

composio da cor

Cada um destes elementos de cor podem ter um grau de intensidade que

varia entre 0 (zero) e 255.

A escala HSL descreve uma cor atravs da mistura de trs componentes

bsicos, a saber:

Hue (matiz): Especifica a gradao da cor dentro do espectro de luz

visvel

362 Telas e Objetos de Tela

 Saturation (saturao): Indica a intensidade de um determinado matiz.
Um matiz com alta saturao tem uma cor mais intensa, enquanto um
matiz com baixa saturao produz uma cor mais acinzentada

Lightness (luminosidade): Indica a quantidade de luz aplicada cor.

Quanto maior a luminosidade, mais clara a cor. Do mesmo modo, quanto
menor a luminosidade, mais escura a cor

Estes elementos tambm podem ter seu grau de intensidade configurado

entre 0 (zero) e 255. Assim, basta especificar o valor para cada um dos itens,
conforme a tonalidade da cor desejada, ou selecionar a cor desejada
diretamente com o ponteiro do mouse sobre as escalas da janela.

O valor numrico de cada cor obtido atravs da seguinte frmula:

Red * 256 ^ 0 + Green * 256 ^ 1 + Blue * 256 ^ 2

Ou seja:
Red * 1 + Green * 256 + Blue * 65536

Sendo que as variveis Red, Green e Blue podem assumir valores entre 0
(zero) e 255. Por exemplo:

Preto (0, 0, 0): 0 * 1 + 0 * 256 + 0 * 65536 = 0

Branco (255, 255, 255): 255 * 1 + 255 * 256 + 255 * 65536 = 16777215

Vermelho (255, 0, 0): 255 * 1 + 0 * 256 + 0 * 65536 = 255

Verde (0, 255, 0): 0 * 1 + 255 * 256 + 0 * 65536 = 65280

Azul (0, 0, 255): 0 * 1 + 0 * 256 + 255 * 65536 = 16711680

NOTA
Os valores armazenados nas propriedades dos objetos que se referem a
cores so os valores numricos, calculados atravs da frmula descrita
anteriormente. A ferramenta Procurar e Substituir utiliza este valor
armazenado no processo de pesquisa, e no os valores formatados como
RGB mostrados na Lista de Propriedades.

Telas e Objetos de Tela 363

7.5 Formatao de Valores
O uso de formatadores permite mudar a forma como os dados so
apresentados sem precisar mudar o valor que existe por trs deles. O
formato um texto que pode ser editado manualmente ou configurado
atravs da janela de formatao. Seu uso semelhante aos formatadores
usados nas planilhas eletrnicas, seguindo a mesma sintaxe bsica, mas com
algumas extenses. So suportados os seguintes tipos de dados:

Numrico (sada decimal, cientfica, hexadecimal, binria e octal)

Texto

Booleano

Data e Hora (calendrio Gregoriano)

Os objetos que suportam formatao devem ter o tipo de dados na

propriedade Value alterado de acordo com o tipo de formatao desejada.

Janela de Formatao de Valores

364 Telas e Objetos de Tela

As seguintes formataes esto disponveis:

Geral: No h formatao especfica. realizada automaticamente,

dependendo do tipo de dados

Nmero: Apresenta nmeros com parte inteira e fracionria, permitindo

definir o nmero de casas decimais e uso de separador de milhares. Para
nmeros muito grandes ou muito pequenos, utilize o formato Cientfico.
Os smbolos de casa decimal e separador de milhares so aqueles
definidos no Painel de Controle - Configuraes Regionais

Data/Hora: Apresentam valores numricos (formato Gregoriano) como

datas e horas, quando vlidos

Porcentagem: Multiplica o nmero por 100 e adiciona o smbolo de

percentual, definindo tambm o nmero de casas decimais

Cientfico: Este formato apresenta o nmero em notao de mantissa e

expoente. Ideal para nmeros de magnitude variada, permitindo
selecionar tambm o nmero de casas decimais e formatos

Especial: Permite formatar nmeros inteiros em bases no decimais

(hexadecimal, octal ou binria)

Telas e Objetos de Tela 365

7.5.1 Outros Formatos
Na opo Outro, pode-se criar um formato de dados qualquer, mesmo um
dos j citados, a partir da digitao de um cdigo (texto) de formato.

O texto do formatador composto de at quatro campos separados por um

ponto e vrgula. O primeiro campo sempre aplicado quando no existir um
outro campo mais apropriado para o valor ou tipo de dados. O segundo
campo utilizado para valores numricos negativos. O terceiro campo
utilizado quando o valor numrico for 0 (zero). Finalmente, o quarto campo
utilizado quando o dado for do tipo Texto.

Sempre que mais de um campo for definido, o campo anterior considerado,

mesmo que esteja vazio. No caso de um formatador de campo vazio, o valor
formatado sempre um texto vazio. Note que isto difere do formato Geral,
que apenas um formato vazio, sem o uso dos separadores de campo
(ponto e vrgula).

Para inserir caracteres que so mostrados pelo formatador, pode-se coloc-

los entre aspas duplas ou aps uma barra invertida. A tabela a seguir contm
exemplos de entradas de texto (vlidos para todos os tipos de formatadores).

Entrada de Texto

FORMATADOR SADA FORMATADA

"0#?" 0#?

\m\d\y mdy

Tambm possvel criar formatadores que contenham apenas texto, que

podem ser combinados com o uso de diferentes campos, como no exemplo a
seguir.

Formatador e Sada Formatada

VALOR FORMATADOR SADA FORMATADA

1 "Positivo";"Negativo";"Ze Positivo
ro","Texto"

366 Telas e Objetos de Tela

 VALOR FORMATADOR SADA FORMATADA
-1 "Positivo";"Negativo";"Ze Negativo
ro","Texto"

0 "Positivo";"Negativo";"Ze Zero
ro","Texto"

"Abcd" "Positivo";"Negativo";"Ze Texto

ro","Texto"

Alm disto, os seguintes caracteres podem ser mostrados diretamente sem o

uso de aspas ou barra: $ - + / () : ! ^ & ' (aspas simples esquerda) ' (aspas
simples direita) ~ { } = < >

NOTA
Para mostrar a barra invertida ou aspas duplas no dado formatado, use \"
ou \\. Quando entre aspas, todo o texto copiado diretamente; logo, "\a"
mostrado simplesmente como \a.

Os formatadores numricos aceitam trs tipos bsicos de caracteres para

definir o nmero de dgitos apresentados, conforme a tabela a seguir.

Formatadores Numricos

OPO DESCRIO
0 (zero) Coloca o dgito significativo ou 0
(zero), quando no houver

# Coloca o dgito significativo

? Coloca o dgito significativo ou um

espao, quando no houver

Telas e Objetos de Tela 367

O ponto decimal define que se deseja apresentar tambm a parte fracionria
de um nmero. A vrgula tem como funo indicar que o valor deve ser
dividido por mil (para cada vrgula), aps os dgitos do formatador.

Independente da configurao local do Windows, o ponto e a vrgula sempre

devem ser utilizados no texto do formatador para indicar o separador de
milhar e de decimal, mas a sada formatada de acordo com a configurao
regional do sistema. A tabela a seguir descreve as opes disponveis.

Opes disponveis

DADO FORMATADOR SADA FORMATADA

12000 #, 12

1234567 #,#.0 1,234,567.0

7.5.1.1 Formato Cientfico

Um nmero pode ser apresentado em notao cientfica (mantissa e

expoente) quando aps algum dgito existir E+, E-, e- ou e+, seguido de
dgitos para formatar o expoente. Quando for usado E+ ou e+ o expoente
sempre mostrado com sinal, e quando for usado E- ou e-, o sinal aparece
apenas para expoente negativos. O expoente sempre mostra um dgito,
mesmo que este seja 0 (zero). O nmero de dgitos direita do ponto
decimal afeta o expoente mostrado. A tabela a seguir contm exemplos de
valores formatados usando o formato cientfico.

Formatador Cientfico

DADO FORMATADOR SADA FORMATADA

1000 #E+00 1E+03

1000 ##e-00 10e02

368 Telas e Objetos de Tela

7.5.1.2 Formato de Base No Decimal

Os formatadores para bases no decimais sempre apresentam apenas a

parte inteira do valor numrico formatado, e tambm no so sensveis ao
sinal. Da mesma forma que na base decimal, caso o nmero possua mais
dgitos do que o requisitado no formatador, estes dgitos so apresentados
de qualquer forma.

Atualmente, estes formatadores esto limitados a nmeros de 32 bits. Caso a

parte inteira do valor exceda este limite, a formatao retorna erro. A tabela a
seguir contm exemplos de valores formatados usando um formato de base
no decimal.

Formatadores para bases no decimais

DADO FORMATADOR SADA FORMATADA

255 "0x"XXX 0x0FF

12345 oooo\o 30071o

987 B 1111011011

12 BBBB - BBBB 0000 - 1100

Telas e Objetos de Tela 369

7.5.1.3 Formato de Data e Hora

A sintaxe da formatao de datas e horas difere um pouco do sistema usado

pelas planilhas, seguindo o modo usado pela configurao regional do
Windows. As datas so valores numricos onde a parte inteira uma
contagem de dias desde 31 de dezembro de 1899 e a parte fracionria
representa a hora em fraes de dia.

O ano mnimo suportado 100 e o ano mximo 9999, garantindo uma

resoluo de pelo menos 1 ms em todo o intervalo. Os nomes de meses e
dias da semana, a ordem padro de dia, ms e ano e o separador de datas e
horas so todos utilizados de acordo com a configurao regional do
Windows. A tabela a seguir contm exemplos de valores formatados usando
o formato de data e hora.

Formatadores para Datas e Horas

DADO FORMATADOR SADA FORMATADA

1234.56789 dd/MMMM/yyyy 18/maio/1903

0.56789 hh:mm:ss.000 tt 01:37:45.696 PM

12.345678 hh\hmm\mss.000\s 296h17m46.667s

NOTA
Os valores armazenados nas propriedades dos objetos que se referem a
datas so os valores numricos, calculados atravs da frmula anterior. A
ferramenta Procurar e Substituir utiliza este valor armazenado no processo
de pesquisa, e no os valores formatados como data e hora mostrados na
Lista de Propriedades.

370 Telas e Objetos de Tela

7.5.1.4 Formato Texto

O caractere @ copia o valor do dado na posio onde aparecer. Este

formatador deve aparecer no quarto campo (por exemplo, ;;;@) ou
diretamente quando h apenas um campo. A tabela a seguir contm
exemplos de valores formatados usando o formato texto.

Formatador para Texto

DADO FORMATADOR SADA FORMATADA

Abc @@ Abc Abc

xyZ "Nome: " \ " @ \ " Nome: "xyZ"

Telas e Objetos de Tela 371

 CAPTULO
Associaes
8
Associaes (ou conexes) so ligaes feitas entre propriedades e objetos
ou outras propriedades. As Associaes trazem grande facilidade ao criar
animaes e outros tipos de lgicas comuns, minimizando a utilizao de
scripts.

Pode-se acessar a aba Associaes clicando-se com o boto direito do

mouse no objeto e selecionando a opo Propriedades. Nesta aba, so
mostradas as propriedades do objeto que podem ser associadas, bem como
os tipos de Associaes existentes e suas fontes.

Aba Associaes

As opes disponveis na aba Associaes esto descritas na tabela a seguir.

Opes disponveis na aba Associaes

372 Associaes
 OPO DESCRIO
Propriedades Lista as propriedades do objeto que
podem ser associadas

Conexo Indica o tipo de Associao que a

propriedade possui. Para
propriedades comuns, as Associaes
disponveis so as seguintes: Simples,
Bidirecional, Analgica, Digital, Por
Tabela, Reversa e Mltipla. Existe
ainda a ligao entre propriedades de
ElipseX e objetos, que ainda no
pode ter seu tipo modificado (para
maiores detalhes, consulte o captulo
Bibliotecas)

Fonte No caso mais simples, especifica o

caminho para um objeto ou
propriedade. Este caminho pode ser
preenchido pelo AppBrowser,
clicando-se em , que fica direita
do campo. No caso geral, uma
expresso que permite aplicar
operaes lgicas, aritmticas e
avaliaes de funes propriedades,
objetos e constantes

Associaes 373
Ao especificar a fonte da Associao, o seu texto aparece em azul, caso esta
corresponda a uma expresso vlida. Se a expresso contiver erros, como no
caso de caminhos de objetos que no existam (ou pertenam a projetos que
no estejam carregados), o texto aparece em vermelho. Nestes casos, a
opo de Verificar Domnio informa os locais que necessitam de correo
ou reviso. Os tipos de Associaes disponveis so explicados nos tpicos a
seguir.

O campo Fonte pode conter uma referncia a um objeto de contexto

existente na hierarquia superior do objeto onde se est criando a Associao.
O formato de uma referncia deste tipo @(Contexto)[.Caminho], onde
Contexto o nome do contexto (os valores possveis podem ser vistos na
descrio do mtodo Context, no Manual de Referncia e Scripts do E3) e
Caminho pode ser o caminho de um objeto existente na hierarquia inferior do
objeto de contexto, ou uma propriedade deste mesmo objeto. Os nomes dos
contextos no so sensveis a maisculas e minsculas.

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

Associao Simples

Para utilizar este recurso, siga estes procedimentos:

1. Selecione o objeto para a Associao.

2. Clique com o boto direito do mouse no objeto e selecione a opo

Propriedades.

3. Clique na aba Associaes e selecione a propriedade para criar a

Associao. O Studio indica vrios tipos de Associaes.

4. No campo Fonte, selecione a Associao e clique em para indicar a

propriedade a referenciar, ou escreva a expresso neste campo.

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

Associao Bidirecional

Para utilizar este recurso, siga estes procedimentos:

1. Selecione o objeto para a Associao.

2. Clique com o boto direito do mouse no objeto e selecione a opo

Propriedades.

3. Clique na aba Associaes e selecione a propriedade para criar a

Associao. O Studio indica vrios tipos de Associaes.

4. No campo Fonte, selecione a Associao e clique em para indicar a

propriedade a referenciar, ou escreva a expresso neste campo.

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

Associao Digital

As opes disponveis nesta Associao esto descritas na tabela a seguir.

Opes disponveis para a Associao Digital

OPO DESCRIO
Ligado Especifica o valor assumido pela
propriedade quando a expresso da
fonte Verdadeira

Desligado Especifica o valor assumido pela

propriedade quando a expresso da
fonte resultar em Falso

Associaes 377
 OPO DESCRIO
Pisca Quando este campo estiver
habilitado, a propriedade conectada
alterna entre os valores do campo
Para valor, caso a fonte retorne
Verdadeiro. Caso contrrio, a
propriedade retornada alterna entre
os valores dos campos Valor e Para
valor caso a fonte retorne Falso

Para valor <Campo Ligado> Especifica o valor alternativo a ser

assumido periodicamente pela
propriedade quando a expresso ou
Associao da fonte resultar em
Verdadeiro e o campo Pisca estiver
habilitado

Para valor <Campo Desligado> Especifica o valor alternativo a ser

assumido periodicamente pela
propriedade quando a expresso da
fonte resultar em Falso e o campo
Pisca estiver desabilitado

Para utilizar este recurso, siga estes procedimentos:

1. Selecione o objeto para a Associao.

2. Clique com o boto direito do mouse no objeto e selecione a opo

Propriedades.

3. Clique na aba Associaes e selecione a propriedade para criar a

Associao. O Studio indica vrios tipos de Associaes.

4. No campo Fonte, selecione a Associao e clique em para indicar a

propriedade a referenciar, ou escreva a expresso neste campo.

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

Associao Analgica

As opes disponveis nesta Associao esto descritas na tabela a seguir.

Opes disponveis para a Associao Analgica

OPO DESCRIO
Valor na Fonte Determina os valores mnimo e
mximo atingidos na fonte

Valor na Propriedade Determina os valores mnimo e

mximo atingidos na propriedade

Associaes 379
Para utilizar este recurso, siga estes procedimentos:

1. Selecione o objeto para a Associao.

2. Clique com o boto direito do mouse no objeto, selecione o item

Propriedades e clique na aba Associaes. Selecione a propriedade para
criar a Associao. O Studio indica vrios tipos de Associaes.

3. No campo Fonte, selecione a Associao e clique em para indicar a

propriedade a referenciar, ou escreva a expresso neste campo.

380 Associaes
8.5 Por Tabela
Na Associao por Tabela, possvel especificar um conjunto de intervalos
em funo de valores mximo e mnimo da fonte e, para cada um destes
intervalos, o valor a ser assumido pela propriedade. Alm disto, assim como
na Associao Digital, possvel especificar a opo de Pisca e o valor
alternativo. Para utilizar este recurso, siga estes procedimentos:

1. Abra a janela de propriedades do objeto e selecione a aba Associaes.

2. Selecione a propriedade para criar a Associao e clique no item

Conexo por Tabela.

Associao por Tabela

As opes disponveis nesta Associao esto descritas na tabela a seguir.

Opes disponveis para a Associao por Tabela

OPO DESCRIO
Inserir Insere uma nova linha na tabela

Remover Remove a linha selecionada da

tabela

Mn Especifica o valor mnimo da fonte

para uma linha da tabela

Associaes 381
 OPO DESCRIO
Mx Especifica o valor mximo da fonte
para uma linha da tabela

Valor Especifica o valor da propriedade a

ser assumido quando a fonte estiver
no intervalo especificado na linha

Pisca Determina que quando a fonte

estiver no intervalo desta linha, a
propriedade alterna periodicamente
entre os valores especificados nas
opes Valor e Valor (com o Pisca
habilitado)

Valor <Pisca Habilitado> Especifica o valor alternativo da

propriedade a ser assumido quando
a fonte estiver no intervalo
especificado na linha, isto , quando
a opo Pisca estiver habilitada

Para utilizar este recurso, siga estes procedimentos:

1. Na aba Associaes, selecione a propriedade e associe a opo Conexo

por tabela.

2. Crie as linhas na tabela e configure as colunas Mn, Mx e Valor.

3. Caso seja necessrio alternar periodicamente entre os valores, habilite a

coluna Pisca e configure as opes restantes.

382 Associaes
8.6 Reversa
Na Associao Reversa, toda vez que o valor da propriedade modificado,
este copiado para a fonte, funcionando assim de maneira inversa
Associao Simples. Para utilizar este recurso, siga estes procedimentos:

1. Abra a janela de propriedades do objeto e selecione a opo

Associaes.

2. Selecione a propriedade para criar a Associao e clique no item

Conexo Reversa.

3. No campo Fonte, selecione a Associao e clique em para indicar a

propriedade a referenciar, ou escreva a expresso neste campo.

Associao Reversa

Associaes 383
8.7 Mltipla
Na Associao Mltipla, cada linha da Associao permite buscar o valor de
uma fonte diferente. A fonte ativa selecionada de acordo com o valor fonte
principal da Associao.

Cada linha possui o intervalo (propriedades Min e Max) e a fonte para aquele
intervalo (propriedade Source, que uma Associao normal). Para utilizar
este recurso, siga estes procedimentos:

1. Abra a janela de propriedades do objeto e selecione a aba Associaes.

2. Selecione a propriedade para criar a Associao e clique no item

Conexo Mltipla.

3. Defina a fonte principal da Associao na coluna Fonte.

Associao Mltipla

As opes disponveis nesta Associao esto descritas na tabela a seguir.

Opes disponveis para a Associao Mltipla

OPO DESCRIO
Inserir Insere uma nova linha na tabela

384 Associaes
 OPO DESCRIO
Remover Remove a linha selecionada da
tabela

Mn Especifica o valor mnimo da fonte

para uma linha da tabela

Mx Especifica o valor mximo da fonte

para uma linha da tabela

Fonte Especifica a fonte que associada

com a propriedade quando o valor
da fonte principal estiver entre os
limites Mn e Mx

Manter todas associaes ativas Mantm todas as Associaes da

tabela em modo Advise (ativas).
Esta propriedade corresponde
propriedade AdviseAll

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

Para acessar esta ferramenta, clique com o boto direito do mouse em um ou

mais objetos e selecione a opo Editar Associaes.

Opo Editar Associaes

A caixa de dilogo da figura a seguir mostrada.

386 Associaes
 Edio de Associaes

A caixa de dilogo anterior mostra uma lista das Associaes, propriedades

do tipo Link e eventos do usurio relacionados aos objetos selecionados e
seus filhos. De acordo com o tipo de linha, as informaes mostradas nas
colunas esto descritas na tabela a seguir.

Opes disponveis na janela Editar Associaes

OPO DESCRIO
Nome do Objeto Determina o nome do objeto

Propriedade / Evento Determina a propriedade do objeto

que possui a Associao

Conexo Determina o tipo de Associao

(Simples, Bidirecional, Digital,
Analgica, Por Tabela, Reversa ou
Mltipla)

Fonte Determina a fonte da Associao

Opes para Propriedades do tipo Link

OPO DESCRIO
Nome do Objeto Determina o nome do objeto que
possui a propriedade

Associaes 387
 OPO DESCRIO
Propriedade / Evento Determina o nome da propriedade

Conexo sempre a mesma (Link)

Fonte Determina o valor da propriedade

Opes para Eventos do usurio

OPO DESCRIO
Nome do Objeto Determina o nome do objeto que
possui o evento

Propriedade / Evento Determina o nome do evento do

usurio

Conexo Determina o tipo do evento

(OnEvent, WhileEvent ou
OnValueChangeEvent)

Fonte Expresso relacionada ao evento

388 Associaes
Na caixa de dilogo Editar Associaes, permitido modificar as seguintes
opes:

Associaes: Podem ser modificadas, exceto o nome do objeto

Propriedades do tipo Link: Podem ser modificadas, exceto o nome do

objeto

Eventos do usurio: Podem ser modificados, exceto o nome do objeto e

o nome do evento

Clicar em Remover permite a remoo da Associao selecionada. A

opo Mostrar janela de propriedades das associaes determina se os
minidialogs das Associaes so mostrados quando a linha estiver
selecionada. Se esta janela estiver visvel, permitida a edio das
propriedades das Associaes. Seu valor padro habilitado.

NOTA
Na janela Editar Associaes, o usurio pode manter a Associao com a
fonte vazia. Para isto, selecione a coluna Fonte e pressione a tecla DELETE.

Edio das propriedades da Associao selecionada

Para editar as propriedades dos eventos do usurio, necessrio selecionar a

linha que contm o evento e, na coluna Conexo, clicar na opo Editar.

Associaes 389
 Edio das propriedades dos eventos do usurio

Ao clicar na opo Editar, a caixa de dilogo a seguir mostrada, permitindo

assim que seja editado o evento do usurio selecionado.

Janela Editar Eventos

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Editar Eventos

OPO DESCRIO
Propriedade ou expresso Propriedade ou expresso geradora
do evento

390 Associaes
 OPO DESCRIO
Sempre que a propriedade for uma Indica que o evento do tipo
condio verdadeira etOnEvent ou etWhileEvent

Repetir o evento Indica o ciclo de repetio do evento

em milissegundos, isto , de quanto
em quanto tempo o evento ocorre
enquanto a expresso geradora for
verdadeira

Intervalo de repetio (ms) Valor para o intervalo de repetio,

em milissegundos

Sempre que a propriedade alterar o Indica que o evento do tipo

seu valor etOnValueChangeEvent, isto , o
evento ocorre sempre que a
expresso geradora mudar o valor

Tratar a desconexo como Se houver alguma desconexo, esta

mudana de valor tratada como uma mudana de
valor

Associaes 391
A janela de edio de Associaes permite utilizar o recurso de copiar e colar
entre as Associaes das propriedades. A opo Copiar Associao copia a
Associao da linha selecionada e a opo Colar Associao cola a
Associao na linha selecionada, substituindo a Associao anterior.

Opo de copiar ou colar uma Associao

392 Associaes
 CAPTULO
Bibliotecas
9
O E3 possui ferramentas que permitem transformar qualquer objeto ou
conjunto de objetos da aplicao em uma biblioteca do usurio. As
Bibliotecas podem ser formadas por objetos frequentemente utilizados, e
subsequentemente reaproveitados em outra aplicao.

O E3 fornece dois tipos de bibliotecas para o usurio: a Galeria, uma

biblioteca de smbolos grficos vetoriais, que podem ser livremente utilizados
nas aplicaes; e uma ferramenta de bibliotecas do usurio chamada de
ElipseX. O uso de bibliotecas no E3 altamente recomendvel na maioria dos
casos, devido ao ganho de produtividade que elas trazem s aplicaes.
Algumas das vantagens dos ElipseX so as seguintes:

Reutilizao de cdigos

Minimizao de testes durante o desenvolvimento

Criao de interfaces padro para os objetos desenvolvidos

Diminuio do tempo de desenvolvimento de novos projetos

Proteo do contedo do projeto

Hierarquizao de objetos

Bibliotecas 393
 Bibliotecas no Organizer

394 Bibliotecas
9.1 Galeria
A Galeria pode ser acessada clicando-se em Galeria na barra de
ferramentas Padro. Neste item est disponvel uma srie de elementos
grficos vetoriais, divididos em categorias, que podem ser arrastados para as
Telas ou ento para os ElipseX. Esto disponveis os seguintes tipos de
smbolos: Botes 3-D, Smbolos 3-D ISA, Ar Condicionado, Arquitetura, Setas,
Controles e Equipamentos ASHRAE, Dutos ASHRAE, Canos ASHRAE, Formas
Bsicas, Ventiladores, Aquecedores, Prdios, Processos Qumicos,
Computadores, Teclas de Computadores, Contineres, Controladores,
Esteiras, Dutos, Eltrica, Acabamentos, Tubos Flexveis, Medidores de Vazo,
Alimentos, Aquecimento, HVAC, cones e Bitmaps, Miscelnea Industrial,
Smbolos Internacionais, Smbolos ISA, Laboratrio, Maquinaria, Mapas e
Bandeiras, Manuseio de Materiais, Minerao, Canos, Smbolos 1, Smbolos 2,
Misturadores, Motores, Natureza, Interface de Operao, Painis, Canos,
Acessrios Industriais, Energia, Resfriamento de Processos, Aquecimento de
Processos, Papel e Celulose, Bombas, Segurana, Balanas, Canos
Segmentados, Sensores, Cortes em Tanques, Tanques, Texturas, Vlvulas,
Veculos, gua e Resduos e Fios e Cabos.

Para utilizar este recurso, siga estes procedimentos:

1. Clique em Galeria na barra de ferramentas Padro.

2. Selecionando esta aba, tem-se acesso aos conjuntos de smbolos, que

esto agrupados em categorias. Selecione a categoria atravs da lista na
parte superior da janela.

3. Para inserir um objeto da biblioteca de smbolos em uma Tela, clique no

objeto desejado e arraste-o para a Tela.

4. Depois de inserido, o objeto pode ser livremente editado e trabalhado de

acordo com as caractersticas descritas para os objetos de imagem. Por
exemplo, pode-se mudar a cor de preenchimento diretamente atravs das
propriedades OverrideFillMode, OverrideFillColor e OverrideLineColor,
sem a necessidade de transformar o objeto em um objeto grfico do E3.

Bibliotecas 395
 Galeria

396 Bibliotecas
9.2 Biblioteca do Usurio (ElipseX)
Os ElipseX so as bibliotecas de objetos do E3. Podem conter, alm de um
desenho, variveis internas passveis de serem exportadas para a aplicao,
alm de lgicas de programao (scripts) presentes em todas as cpias do
objeto sendo criado, diminuindo a necessidade de repetio de cdigo em
diversas partes do aplicativo.

Os ElipseX ficam encapsulados em um arquivo com extenso .lib. Pode-se

criar todos os ElipseX que so utilizados em um determinado projeto no
mesmo arquivo de Biblioteca (.lib), ou ento dividir entre vrios arquivos
conforme desejado.

Para criar uma nova biblioteca no E3, siga estes procedimentos:

1. Selecione o menu Arquivo - Novo Projeto e clique em Prximo.

2. Na opo Tipo de Aplicao, selecione a opo Biblioteca de

componentes do E3.

Criao de uma biblioteca do usurio (ElipseX)

Bibliotecas 397
3. Determine o nome da biblioteca e clique em Avanar.

4. Determine as especificaes referentes ao Domnio.

5. Clique em Concluir.

Dentro de uma biblioteca ElipseX, pode-se inserir trs tipos de objetos: os

XControls, os XFolders e os XObjects.

Os seguintes itens podem ser inseridos em um XControl: Primitivas de

Desenho (Retas, Retngulos, Crculos, etc.), Objetos Grficos Vetoriais,
incluindo objetos da biblioteca de smbolos (WMF, EMF, etc.), Objetos
Grficos no-Vetoriais (BMP, JPEG, GIF,etc.), Controles ActiveX do E3 (E3Chart,
E3Browser, E3Alarm, Controles ActiveX de terceiros) e outros XControls.

Um XFolder um objeto que permite inserir objetos filhos em suas instncias.

Desta forma, possvel organizer ou criar hierarquias de objetos em uma
aplicao. Pode-se inserir em um XFolder itens como Pastas de Dados, Tags
de Comunicao, Filtros de Alarmes e instncias de XFolders, entre outros.

J os XObjects podem conter quaisquer tipos de objetos no-grficos,

executados no E3 Server, como Drivers de Comunicao, Servidores de
Dados, Bancos de Dados, Frmulas, Configuraes de Alarmes, Servidores de
Alarmes e Objetos COM, entre outros.

NOTA
A janela de propriedades dos ElipseX no editor de objetos pode ser aberta
utilizando as combinaes de teclas ALT + ENTER, CTRL + ALT + ENTER ou
ALT + duplo-clique do mouse.

Dentro de um mesmo arquivo .lib pode existir qualquer nmero de

componentes ElipseX, sejam eles XControls, XFolders ou XObjects. Pode-se
tambm ter vrias bibliotecas diferentes dentro do mesmo Domnio.

398 Bibliotecas
Note que para cada ElipseX criado em uma biblioteca so criadas
internamente duas interfaces, uma para declarar as propriedades do objeto, e
outra para declarar os eventos do objeto. Estas interfaces tm seus nomes
gerados automaticamente, acrescentando o prefixo "D" a este nome (a
interface de eventos adiciona o sufixo "Events" ao nome automtico). Se, por
exemplo, o objeto se chama "XObject1", sua interface de propriedades tem o
nome "DXObject1" e a interface de eventos, "DXObject1Events". Uma tentativa
de usar estes nomes em outras classes na mesma biblioteca gera um cdigo
de erro 8002802D, que corresponde a Name already exists in the library.

Bibliotecas 399
9.2.1 XControls
O XControl define uma interface grfica com o usurio, que pode ser
composta de quaisquer objetos do E3, e tem o propsito de ser multiplicada
facilmente por um projeto. Pode-se criar um XControl clicando com o boto
direito do mouse no item Bibliotecas de Objetos - XControls no modo
Domnio, selecione a opo Inserir XControl em e logo aps o nome da
biblioteca desejada.

Aba Design de um XControl

400 Bibliotecas
 Aba Propriedades de um XControl

Ao inserir um XControl aberto o Editor deste objeto, composta por trs

abas. Alm da aba Scripts, presente em todos os objetos, existe a aba
Design, que equivale a uma Tela, onde podem ser inseridos os objetos
grficos descritos anteriormente, e a aba Propriedades, onde podem ser
inseridas variveis, que so as propriedades do XControl. Estas propriedades
so exportadas pelo objeto e podem ser associadas a um Tag ou outra
propriedade qualquer quando o objeto estiver sendo usado na aplicao.

As variveis a serem exportadas podem ser inseridas pressionando-se a tecla

INSERT do teclado ou clicando em e excludos atravs da tecla DELETE do
teclado ou clicando em . As opes disponveis na aba Propriedades esto
descritas na tabela a seguir.

Opes disponveis na aba Propriedades

OPO DESCRIO
Nome Determina o nome da varivel do
XControl

Bibliotecas 401
 OPO DESCRIO
Tipo Determina o tipo de dados
suportado pela varivel. Note que
outros objetos de Dados (XFolders e
XObjects) podem ser declarados
como tipos de dados. Desta forma,
pode-se criar um objeto de dados
que possui como propriedade outro
objeto de dados. Os objetos de
dados podem funcionar neste caso
como uma estrutura ou classe, como
utilizado nas linguagens C/C++.
Quando for especificado um tipo de
objeto (por exemplo DemoTag,
IOTag, XObject, etc.), esta
propriedade tem o seguinte
comportamento:

Caso o ElipseX esteja inativo: A

propriedade funciona como uma
String, que especifica o caminho
da instncia de um objeto do tipo
configurado

Caso o ElipseX esteja ativo: Na

escrita, a propriedade funciona
como o caso anterior, porm na
leitura a propriedade retorna o
objeto especificado, caso ele
exista. Se o caminho no aponta
para um objeto existente no
momento, a propriedade retorna
Nothing

Esta opo corresponde

propriedade Type de um objeto
Definio de Propriedade

402 Bibliotecas
 OPO DESCRIO
Pblica Habilita ou desabilita a visibilidade da
varivel fora da biblioteca, isto ,
determina se a varivel ou no
pblica. Esta opo corresponde
propriedade Public de um objeto
Definio de Propriedade

Gravvel Determina se a varivel salva no

projeto ou no. Esta opo
corresponde propriedade
Persistable de um objeto Definio
de Propriedade

Retentiva Determina se a propriedade

retentiva ou no. No caso de
XControls, as propriedades no
podem ser retentivas. Esta opo
corresponde propriedade
Retentive de um objeto Definio de
Propriedade

Valor inicial Determina o valor inicial da varivel.

Esta opo corresponde
propriedade DefaultValue de um
objeto Definio de Propriedade

Texto de ajuda Texto de declarao e documentao

da varivel. Esta opo corresponde
propriedade HelpString de um
objeto Definio de Propriedade

Bibliotecas 403
NOTA
interessante observar que XFolders e XObjects podem ser declarados
como tipos de dados.

A edio do objeto grfico pode ser realizada da mesma forma como a

edio de uma Tela, possuindo os mesmos recursos grficos e opes.

Pode-se inserir os XControls em qualquer Tela, ou ainda dentro de outro

XControl clicando com o boto direito do mouse na Tela ou XControl de
destino, selecionando a opo Inserir, como mostrado a seguir. A partir de
um XControl em desenvolvimento (dentro da biblioteca), possvel inserir
outro XControl dentro dele, clicando com o boto direito do mouse no
XControl de destino e selecionando a opo Inserir.

Inserindo um XControl na Tela

404 Bibliotecas
A partir deste momento, o XControl tem um nome dentro da Tela, e
entendido como uma cpia da definio original. Assim, deve-se definir (se
necessrio) os valores ou as Associaes que esta cpia especfica tem no
contexto que est sendo utilizada. Se o tamanho deste objeto for alterado na
aba Design do Editor da Biblioteca e registrado novamente, necessrio usar
a opo Tamanho Original no seu menu contextual da Tela para que a
alterao aparea.

Se for criado um objeto Bomba, por exemplo, que possui uma propriedade
Estado, que recebe uma informao externa revelando se a bomba est
ligada ou desligada, fazendo com que ela mude sua cor. Ao inserir este
objeto na Tela, o E3 automaticamente renomeia o objeto para "Bomba1".

Pode-se manter este nome ou renome-lo para outro que se desejar. Depois,
deve ser informada qual varivel vai ser associada propriedade Estado.
Suponha que certo Tag de Comunicao representa o estado desta bomba.
Logo, deve ser criada uma Associao entre a propriedade Estado e o
referido Tag. O mesmo trabalho deve ser executado para outras instncias
(cpias) do objeto Bomba que se fizerem necessrias no projeto.

Bibliotecas 405
9.2.2 XFolders
Um XFolder um objeto do servidor que permite organizar ou criar uma
hierarquia de objetos nas instncias criadas. Os objetos que podem ser
inseridos em uma instncia de XFolder so os seguintes:

Pastas de Dados

Tags de Comunicao

Consultas

Filtros de Alarmes

Instncias de XFolders e XObjects

Alarmes

NOTA
No permitido inserir objetos na definio de um XFolder, somente em
suas instncias.

Para criar um XFolder, clique com o boto direito do mouse no item

Bibliotecas de Objetos - XFolders no modo Domnio, selecione a opo
Inserir XFolder em e logo aps o nome da biblioteca desejada.

Aba Propriedades de um XFolder

406 Bibliotecas
Ao inserir um XFolder, aberto o Editor deste objeto, onde podem ser
inseridas variveis. Estas variveis so as propriedades a serem exportadas
pelo objeto, que podem ser associadas a um Tag ou outra propriedade
qualquer de uma aplicao quando o objeto estiver sendo usado em uma
aplicao.

As variveis a serem exportadas podem ser inseridas pressionando-se a tecla

INSERT do teclado ou clicando em e excludas atravs da tecla DELETE ou
clicando em . As opes disponveis na aba Propriedades esto descritas
na tabela a seguir.

Opes disponveis na aba Propriedades

OPO DESCRIO
Nome Determina o nome da varivel do
XFolder

Bibliotecas 407
 OPO DESCRIO
Tipo Determina o tipo de dados
suportado pela varivel. Note que
outros objetos de Dados (XFolders e
XObjects) podem ser declarados
como Tipos. Desta forma, pode-se
criar um objeto de dados que possui
como propriedade outro objeto de
dados. Os objetos de dados podem
funcionar neste caso como uma
estrutura ou classe, como utilizado
nas linguagens C/C++. Quando for
especificado um tipo de objeto (por
exemplo DemoTag, IOTag, XObject,
etc.), esta propriedade tem o
seguinte comportamento:

Caso o ElipseX esteja inativo: A

propriedade funciona como uma
String, que especifica o caminho
da instncia de um objeto do tipo
configurado

Caso o ElipseX esteja ativo: Na

escrita, a propriedade funciona da
mesma maneira de quando o
objeto est desativado. Porm, na
leitura a propriedade retorna o
objeto especificado, caso ele
exista. Se o caminho no aponta
para um objeto existente no
momento, a propriedade retorna
Nothing

Esta opo corresponde

propriedade Type de um objeto
Definio de Propriedade

408 Bibliotecas
 OPO DESCRIO
Pblica Habilita ou desabilita a visibilidade da
varivel fora da biblioteca, isto ,
determina se a varivel ou no
pblica. Esta opo corresponde
propriedade Public de um objeto
Definio de Propriedade

Gravvel Determina se a varivel salva no

projeto ou no. Esta opo
corresponde propriedade
Persistable de um objeto Definio
de Propriedade

Retentiva Determina se a propriedade

retentiva ou no. Esta opo
corresponde propriedade
Retentive de um objeto Definio de
Propriedade

Valor inicial Determina o valor inicial da varivel.

Esta opo corresponde
propriedade DefaultValue de um
objeto Definio de Propriedade

Texto de ajuda Texto de declarao e documentao

da varivel. Esta opo corresponde
propriedade HelpString de um
objeto Definio de Propriedade

Bibliotecas 409
Pode-se inserir XFolders em qualquer Servidor de Dados, clicando com o
boto direito do mouse no Servidor de Dados no modo Domnio,
selecionado a opo Inserir e logo aps o nome do XFolder desejado,
conforme mostrado na figura a seguir. No modo Explorer, clique com o
boto direito do mouse no Servidor de Dados do projeto, selecione a opo
Inserir e logo aps o nome do XFolder desejado.

Inserindo um XFolder no modo Domnio

410 Bibliotecas
9.2.3 XObjects
Alm dos XControls e XFolders, pode-se criar uma biblioteca de dados,
denominada XObject. Com ela, pode-se definir uma estrutura de dados, que
executada no servidor. Tal estrutura pode realizar clculos, Associaes,
comunicaes, verificao de alarmes, registro histrico, etc., que independam
de que alguma interface grfica (Viewer) esteja aberta ou sendo executada
naquele momento. Para criar um XObject, clique com o boto direito do
mouse no item Bibliotecas de Objetos - XObjects no modo Domnio,
selecione a opo Inserir XObject em e logo aps o nome da biblioteca
desejada.

XObjects

Ao inserir um XObject, aberto o Editor deste objeto, onde podem ser

inseridas variveis. Estas variveis so as propriedades a serem exportadas
pelo objeto, que podem ser associadas a um Tag ou outra propriedade
qualquer de uma aplicao quando o objeto estiver sendo usado em uma
aplicao.

As variveis a serem exportadas podem ser inseridas pressionando-se a tecla

INSERT do teclado ou clicando em e excludas atravs da tecla DELETE ou
clicando em . As opes disponveis na aba Propriedades esto descritas
na tabela a seguir.

Opes disponveis na aba Propriedades

OPO DESCRIO
Nome Determina o nome da varivel do
XObject

Bibliotecas 411
 OPO DESCRIO
Tipo Determina o tipo de dados
suportado pela varivel. Note que
outros objetos de Dados (XFolders e
XObjects) podem ser declarados
como Tipos. Desta forma, pode-se
criar um objeto de dados que possui
como propriedade outro objeto de
dados. Os objetos de dados podem
funcionar neste caso como uma
estrutura ou classe, como utilizado
nas linguagens C/C++. Quando for
especificado um tipo de objeto (por
exemplo DemoTag, IOTag, XObject,
etc.), esta propriedade tem o
seguinte comportamento:

Caso o ElipseX esteja inativo: A

propriedade funciona como uma
String, que especifica o caminho
da instncia de um objeto do tipo
configurado

Caso o ElipseX esteja ativo: Na

escrita, a propriedade funciona da
mesma maneira de quando o
objeto est desativado. Porm, na
leitura a propriedade retorna o
objeto especificado, caso ele
exista. Se o caminho no aponta
para um objeto existente no
momento, a propriedade retorna
Nothing

Esta opo corresponde

propriedade Type de um objeto
Definio de Propriedade

412 Bibliotecas
 OPO DESCRIO
Pblica Habilita ou desabilita a visibilidade da
varivel fora da biblioteca, isto ,
determina se a varivel ou no
pblica. Esta opo corresponde
propriedade Public de um objeto
Definio de Propriedade

Gravvel Determina se a varivel salva no

projeto ou no. Esta opo
corresponde propriedade
Persistable de um objeto Definio
de Propriedade

Retentiva Determina se a propriedade

retentiva ou no. Esta opo
corresponde propriedade
Retentive de um objeto Definio de
Propriedade

Valor inicial Determina o valor inicial da varivel.

Esta opo corresponde
propriedade DefaultValue de um
objeto Definio de Propriedade

Texto de ajuda Texto de declarao e documentao

da varivel. Esta opo corresponde
propriedade HelpString de um
objeto Definio de Propriedade

Bibliotecas 413
Apenas propriedades de tipos simples (Variant, String, Date, Double, etc.)
podem ser retentivas (o Editor do objeto desmarca automaticamente a
coluna Retentiva se o tipo de uma propriedade for alterado para um tipo
de objeto), e apenas propriedades de XFolders e de XObjects podem ser
retentivas.

NOTA
O uso de propriedades retentivas nos ElipseX pode aumentar o tempo de
incio do aplicativo, e tambm aumentar o consumo de memria pelo
processo E3Run. Os tempos variam dependendo do nmero de instncias
de XFolders e de XObjects, do nmero de propriedades retentivas em cada
XFolder ou XObject e da quantidade destas propriedades que possuem o
seu valor alterado (se a propriedade nunca alterada, o seu valor retentivo
permanece zerado).

Podem ser inseridos em um XObject quaisquer mdulos do E3 que sejam

executados no servidor, a saber:

Driver de Comunicao e Driver de Comunicao OPC

Servidor de alarmes e alarmes

Servidor de Banco de Dados

Frmulas

Servidor de Dados

Histricos

Isto permite que se possa definir como uma biblioteca um sistema complexo
de gerenciamento, que pode ser facilmente replicado quantas vezes forem
necessrias em um aplicativo.

414 Bibliotecas
IMPORTANTE
Veja que XControls, XFolders e XObjects s podem se relacionar com o
mundo externo atravs das propriedades (ou ainda atravs do mouse e
teclado, no caso dos XControls). Isto significa que no se pode acessar
dados internos de um XControl, XFolder ou XControl seno de dentro do
prprio objeto.

Pode-se inserir XObjects em qualquer Servidor de Dados, clicando com o

boto direito do mouse no Servidor de Dados no modo Domnio,
selecionado a opo Inserir e logo aps o nome do XObject desejado,
conforme mostrado na figura a seguir. No modo Explorer, clique com o
boto direito do mouse no Servidor de Dados do projeto, selecione a opo
Inserir e logo aps o nome do XObject desejado.

Bibliotecas 415
 Inserindo um XObject no modo Domnio

Note que mesmo se os arquivos de biblioteca possurem vrios XControls,

XFolders e XObjects, ao tentar inserir uma instncia (cpia), o E3 Studio exibe
para as Telas somente os XControls, e para os Servidores de Dados somente
os XFolders e XObjects disponveis.

NOTA
Deve-se cuidar para no apagar uma propriedade de um XControl, XFolder
ou XObject que possua uma Associao. Estas propriedades, uma vez
apagadas, no aparecem mais na lista de propriedades do objeto, e por
isto no podem ser editadas. Quando for executada a operao Verificar
Domnio, executada uma procura por estas propriedades e o usurio
consultado se deseja remover esta Associao ou no.

416 Bibliotecas
 Propriedade invlida

Pode-se optar por no remover e ento criar novamente o objeto que foi
apagado com a propriedade que se deseja editar, remover apenas a
propriedade que est sendo mostrada, remover todas as propriedades ou
no remover nenhuma propriedade.

Bibliotecas 417
9.3 Quando Criar um ElipseX
O uso de Bibliotecas altamente recomendvel devido ao ganho de
produtividade que trazem. Algumas das vantagens dos ElipseX so as
seguintes:

Reutilizao de cdigo

Minimizao de testes durante o desenvolvimento

Criao de interface padro para os objetos desenvolvidos

Diminuio do tempo de desenvolvimento de novos projetos

Proteo do contedo do projeto

Hierarquizao de objetos

Logo, o uso de biblioteca recomendado para a maioria das aplicaes.

Entretanto, existem alguns critrios para indicar a necessidade da construo
de objetos no E3:

Repetio no uso: Se um mesmo equipamento ou processo usado

mais de uma vez no mesmo projeto

Procedimentos do conhecimento do usurio: Frequentemente, um

processo criado por determinada empresa deve ser protegido de cpia
ou alterao. Isto comum no caso de integradores de servios ou
fabricantes de mquinas

Uso de controladores: Um controlador de processo, cujo mapeamento

de memria fixo, pode ser implementado com todas as funcionalidades
disponveis. A flexibilidade disponvel para a construo e uso dos
objetos no E3 permite que sejam utilizadas posteriormente apenas as
variveis de interesse, desprezando-se as demais

NOTA
Para exemplos de criao de ElipseX e maiores informaes sobre estes
objetos, consulte o Manual de Referncia e Scripts do E3.

418 Bibliotecas
 CAPTULO
ActiveX
10
Os objetos ActiveX so componentes de software baseados na tecnologia
COM (Component Object Model) que podem ser inseridos em uma aplicao
para realizar diversas tarefas. Estes objetos so desenvolvidos em ambientes
de programao tais como C/C++, Delphi e Visual Basic, entre outros.

Alguns objetos ActiveX so automaticamente registrados quando o E3

instalado: E3Alarm, E3Browser e E3Chart (desenvolvidos pela Elipse Software),
Microsoft Forms (desenvolvidos pela Microsoft) e Relatrio (ActiveReports,
desenvolvido pela Data Dynamics). Os objetos E3Alarm, E3Browser, E3Chart e
Relatrio possuem captulos especficos mais adiante neste Manual. Os
objetos Microsoft Forms so descritos em outro tpico deste captulo.

NOTA
Para objetos ActiveX no instalados previamente pelo E3, necessrio que
estes objetos sejam instalados em todos os computadores onde a aplicao
vai executar, especialmente em Viewers Remotos.

Alm destes, pode-se inserir qualquer outro objeto ActiveX. Para registrar um
objeto ActiveX no E3, siga estes procedimentos:

1. Selecione o menu Ferramentas - Gerenciar ActiveX. A janela da figura a

seguir mostrada.

ActiveX 419
 Janela Gerenciar Controles ActiveX

As opes da janela Gerenciar Controles ActiveX esto descritas na tabela a

seguir.

Opes da janela Gerenciar Controles ActiveX

OPO DESCRIO
Controles registrados no Windows Listagem com todos os controles
ActiveX registrados no Windows e que
podem ser adicionados ao E3

Controles registrados no E3 Listagem com todos os controles

ActiveX j registrados no E3

Registrar Registra o controle selecionado no E3.

Caso o controle seja incompatvel com
o E3, uma caixa de dilogo
mostrada avisando o usurio a
respeito da incompatibilidade

420 ActiveX
 OPO DESCRIO
Remover Remove o controle selecionado da
lista Controles registrados no E3,
movendo-o de volta para a lista
Controles registrados no Windows.
Os controles com o cone no
podem ser removidos, somente os
que tiverem o cone

Procurar Abre uma caixa de dilogo para

localizar um arquivo ActiveX

Atualizar Permite atualizar os controles ActiveX

na listagem Controles registrados no
Windows que tenham sido
registrados aps a abertura da janela
de gerenciamento

Fechar Fecha a janela de gerenciamento dos

ActiveX

2. Clique em Procurar para abrir uma caixa de dilogo e localizar o arquivo

que contm o ActiveX.

ActiveX 421
 Localizao do arquivo ActiveX

3. Selecione o arquivo desejado e clique em Abrir.

Os objetos ActiveX podem ser de dois tipos: Grficos (utilizados nas Telas da
aplicao) e No-Grficos (realizam algum tipo de manipulao de dados).

Os objetos grficos podem ser inseridos na aplicao de trs formas

diferentes:

Atravs da barra de ferramentas Objetos, selecionando o objeto

desejado

Atravs do clique com o boto direito do mouse no objeto Tela, no

Organizer, selecionando a opo Inserir

Atravs do clique com o boto direito do mouse na Tela, selecionando a

opo Inserir

422 ActiveX
 Inserindo um objeto grfico na Tela

Os objetos no-grficos podem ser usados na aplicao atravs de scripts e

so criados pelo mtodo CreateObject, padro do VBScript.

10.1 Objetos Microsoft Forms

Para inserir um dos objetos Microsoft Forms previamente registrados no E3
na aplicao, existem duas opes:

1. Clique com o boto direito do mouse na Tela e selecione a opo Inserir

- MSForms.

2. Selecione o objeto desejado na barra de ferramentas Objetos e clique na

Tela para estabelecer o ponto inicial do desenho do objeto, arrastando o
mouse diagonalmente at o objeto atingir o tamanho e a posio
desejados.

Os objetos da biblioteca Microsoft Forms disponveis no E3 so descritos nos

tpicos seguintes.

ActiveX 423
10.1.1 Barra de Rolagem
Facilita a navegao atravs de uma longa lista de itens ou de uma grande
quantidade de informao tanto horizontalmente quanto verticalmente.
inserido na Tela ao selecionar o cone .

10.1.2 Boto de Comando

Usado para executar aes especficas quando pressionado, tais como abrir
uma janela, imprimir um relatrio, etc. inserido na Tela ao selecionar o
cone .

10.1.3 Boto de Incremento e Decremento

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

10.1.4 Boto de Opo

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

10.1.5 Boto Liga e Desliga

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

10.1.6 Caixa de Seleo

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

10.1.7 Editor de Texto

Possibilita ao usurio inserir e editar textos. inserido na Tela ao selecionar o
cone .

424 ActiveX
10.1.8 Lista
Exibe uma lista de itens dentre os quais o usurio pode escolher um ou mais.
inserido na Tela ao selecionar o cone .

10.1.9 Lista de Seleo

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

10.1.10 Texto
Exibe mensagens de texto que no podem ser editadas pelo usurio, como
descries de controles ou legendas. inserido na Tela ao selecionar o cone
.

ActiveX 425
10.2 Elipse KeyPad
O Elipse KeyPad um controle ActiveX desenvolvido pela Elipse Software, que
permite utilizar um teclado virtual flutuante em aplicaes desenvolvidas com
o E3.

Este controle pode ser ativado no Viewer utilizando a aba Visualizador das
propriedades do objeto Viewer.

Aba Visualizador do Viewer

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis para o Elipse KeyPad na aba Visualizador

426 ActiveX
 OPO DESCRIO
Mostrar quando um SetPoint Esta opo mostra o Elipse KeyPad
recebe o foco sempre que um objeto do tipo
SetPoint recebe o foco

Esconder ao pressionar ENTER Habilita ocultar o Elipse KeyPad ao

pressionar a tecla ENTER. Esta opo
equivale propriedade
AutoHideOnEnter do controle

Esconder ao pressionar ESC Habilita ocultar o Elipse KeyPad ao

pressionar a tecla ESC. Esta opo
equivale propriedade
AutoHideOnEsc do controle

Em scripts, o KeyPad pode ser acionado utilizando-se o mtodo GetKeyPad

do objeto Application. Demais informaes sobre as funcionalidades das
propriedades deste objeto podem ser encontradas no Manual de Referncia
e Scripts do E3, em seu captulo respectivo.

ActiveX 427
 CAPTULO
Servidor de Dados
11
Os Servidores de Dados so os objetos responsveis por abrigar a execuo
das variveis do sistema como Tags Internos, Tags Demo, Tags Timer, e
instncias de XFolders e XObjects. Para utilizar este recurso, siga este
procedimento:

1. Clique com o boto direito do mouse no projeto no Organizer e selecione

a opo Inserir - Servidor de Dados.

Inserindo um Servidor de Dados

428 Servidor de Dados

NOTA
Os objetos do Servidor de Dados (Pasta de Dados, Tag Contador, Tag
Demo, Tag Interno e Tag Timer) podem ser configurados para
funcionarem como reas de Alarme.
Todas as opes do editor de objetos do Servidor de Dados que esto
disponveis via menu contextual (atravs do clique com o boto direito do
mouse) tambm esto disponveis utilizando a combinao de teclas SHIFT
+ F10, que corresponde tecla de aplicao ou de menu .
A janela de propriedades dos objetos do Servidor de Dados no editor de
objetos pode ser aberta utilizando as combinaes de teclas ALT +
ENTER, CTRL + ALT + ENTER ou ALT + duplo-clique do mouse.

Servidor de Dados 429

11.1 Impressora de Linha
A Impressora de Linha um objeto que permite imprimir diretamente para
uma impressora matricial. Para utilizar este recurso, siga estes procedimentos:

1. Clique com o boto direito do mouse no objeto Servidor de Dados e

selecione a opo Inserir - Standard - Impressora de Linha.

Inserindo uma Impressora de Linha

2. Para configurar a Impressora de Linha, clique com o boto direito do

mouse no objeto e selecione a opo Propriedades. A janela da figura a
seguir mostrada.

430 Servidor de Dados

 Aba Geral

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Geral

OPO DESCRIO
Usar impressora padro do Utiliza a impressora padro do
Windows Windows como sada do objeto
Impressora de Linha. Esta opo
corresponde propriedade
UseDefaultPrinter

Escolher uma impressora Permite selecionar uma impressora

disponvel dentre as impressoras instaladas no
sistema operacional como sada do
objeto Impressora de Linha. A
propriedade PrinterName
configurada com o nome da
impressora selecionada nesta opo

Servidor de Dados 431

NOTAS
Caso seja selecionada a opo Escolher uma impressora disponvel, mas
no seja selecionada nenhuma impressora na Lista de Seleo
correspondente, o objeto Impressora de Linha no permite a impresso e
sua propriedade PrinterStatus configurada com o valor 0 (zero,
psUnknown).
A impressora padro do Windows para o usurio atualmente logado
pode ser diferente da impressora padro utilizada pelo E3 Server. Veja o
tpico Impressora para maiores informaes.
O objeto Impressora de Linha pode ser inserido em uma Tela, no Viewer,
em uma Pasta do Viewer ou em uma Pasta de Dados.

Para a impresso, utilize o mtodo Write, passando como argumento a

String desejada. Este objeto possui a propriedade MaxPendingLines, que
controla o nmero mximo de linhas pendentes para impresso. Caso a
chamada do mtodo Write ultrapasse o valor configurado nesta propriedade,
este mtodo retorna um erro de script e a String excedente descartada.

432 Servidor de Dados

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

1. Clique com o boto direito do mouse no Servidor de Dados e selecione a

opo Inserir - Panel - Pasta de Dados.

Inserindo uma Pasta de Dados

Servidor de Dados 433

11.3 Tag Contador
O Tag Contador um objeto que realiza a contagem de tempo (em
segundos) at atingir um valor predeterminado, ou que realiza uma certa
contagem indefinidamente. Para utilizar este recurso, siga estes
procedimentos:

1. Clique com o boto direito do mouse no Servidor de Dados e selecione a

opo Inserir - Panel - Tag Contador.

Inserindo um Tag Contador

2. O Studio abre uma janela perguntando quantos Tags devem ser criados
no servidor, e qual seu nome. Este nome auto-incrementado e, se a
opo for deixada em branco, os Tags so criados com o nome padro.

434 Servidor de Dados

 Inserindo Tags Contador

As propriedades do Tag Contador podem ser configuradas atravs da Lista

de Propriedades, sem a necessidade de criar scripts para isto. Caso necessite
configurar alguma propriedade, localize-a na Lista de Propriedades e faa os
devidos ajustes.

Servidor de Dados 435

11.4 Tag Demo
O Tag Demo um objeto que gera valores de acordo com a forma de onda,
e utilizado para simulao de valores. Permite gerar ondas definidas ou
valores aleatrios. Para utilizar este recurso, siga estes procedimentos:

1. Clique com o boto direito do mouse no Servidor de Dados e selecione a

opo Inserir - Panel - Tag Demo.

Inserindo um Tag Demo

2. O Studio abre uma janela perguntando quantos Tags devem ser criados
no servidor, e qual seu nome. Este nome auto-incrementado e, se a
opo for deixada em branco, os Tags so criados com o nome padro.

436 Servidor de Dados

 Inserindo Tags Demo

As propriedades do Tag Demo podem ser configuradas atravs da Lista de

Propriedades, sem a necessidade de criar scripts para isto. Caso necessite
configurar alguma propriedade, localize-a na Lista de Propriedades e faa os
devidos ajustes.

Servidor de Dados 437

11.5 Tag Interno
O Tag Interno um objeto de propsito genrico, utilizado para guardar
valores de qualquer tipo, incluindo nmeros, textos e at outros objetos. Para
utilizar este objeto, siga estes procedimentos:

1. Clique com o boto direito do mouse no Servidor de Dados e selecione a

opo Inserir - Panel - Tag Interno.

Inserindo um Tag Interno

2. O Studio abre uma janela perguntando quantos Tags devem ser criados
no servidor, e qual seu nome. Este nome auto-incrementado e, se a
opo for deixada em branco, os Tags so criados com o nome padro.

438 Servidor de Dados

 Inserindo Tags Internos

As propriedades do Tag Interno podem ser configuradas atravs da Lista de

Propriedades, sem a necessidade de criar scripts para isto. Caso necessite
configurar alguma propriedade, localize-a na Lista de Propriedades e faa os
devidos ajustes.

Servidor de Dados 439

11.6 Tag Timer
O Tag Timer um objeto para contagem de tempo e agendamento de
atividades. Ele estabelece horrios (com repeties) para executar aes. Para
utilizar este objeto, siga estes procedimentos:

1. Clique com o boto direito do mouse no Servidor de Dados e selecione a

opo Inserir - Panel - Tag Timer.

Inserindo um Tag Timer

2. O Studio abre uma janela perguntando quantos Tags devem ser criados
no servidor, e qual seu nome. Este nome auto-incrementado e, se a
opo for deixada em branco, os Tags so criados com o nome padro.

440 Servidor de Dados

 Inserindo Tags Timer

As propriedades do Tag Timer podem ser configuradas atravs da Lista de

Propriedades, sem a necessidade de criar scripts para isto. Caso necessite
configurar alguma propriedade, localize-a na Lista de Propriedades e faa os
devidos ajustes.

Servidor de Dados 441

CAPTULO
Banco de Dados
12
O Banco de Dados do E3 utilizado para armazenar as informaes do
projeto referentes a Histricos, Frmulas, Alarmes e Storage. Suporta os
formatos Access (.mdb), Oracle e Microsoft SQL Server.

Para utilizar este recurso, clique com o boto direito do mouse no nome do
projeto no Explorer e selecione a opo Inserir - Banco de Dados. No modo
Domnio, clique com o boto direito do mouse no item Objetos de Servidor
- Banco de Dados, selecione a opo Inserir - Banco de Dados em e logo
aps o nome do projeto desejado.

Inserindo um Banco de Dados no modo Domnio

442 Banco de Dados

Ao inserir o Banco de Dados na aplicao, so habilitadas as opes
referentes ao tipo de Servidor de Banco de Dados, atravs da aba
Configurao na Janela de Propriedades, ou da propriedade SourceType, na
Lista de Propriedades.

Algumas das propriedades deste objeto podem ser configuradas atravs da

Lista de Propriedades, sem a necessidade da criao de scripts para isto. Para
isto, localize-as e efetue os devidos ajustes. Demais informaes sobre as
funcionalidades das propriedades deste objeto podem ser encontradas no
Manual de Referncia e Scripts do E3, em seu captulo respectivo.

NOTA
O objeto Banco de Dados pode ser configurado para funcionar como rea
de Alarme.

Banco de Dados 443

12.1 Access
Gera uma base de dados no formato MDB (Microsoft Access Database), padro
para banco de dados no E3. Para utilizar este recurso, siga estes
procedimentos:

1. Clique com o boto direito do mouse no nome do projeto no Explorer e

selecione a opo Inserir - Banco de Dados. No modo Domnio, clique
com o boto direito do mouse no item Objetos de Servidor - Banco de
Dados, selecione a opo Inserir Banco de Dados em e logo aps o
nome do projeto desejado. O objeto criado no projeto, e sua janela de
edio de scripts aberta.

2. Para configur-lo, selecione a aba Configuraes da Janela de

Propriedades.

444 Banco de Dados

 Configuraes para Banco de Dados Access

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Configurao

OPO DESCRIO
Banco de Dados Seleciona o tipo de Banco de Dados
em uso no projeto: 0 - stAccess, 1 -
stOracle ou 2 - stSqlServer

Banco de Dados 445

 OPO DESCRIO
Arquivo MDB Nome do arquivo .mdb utilizado no
projeto. NOTA: Este campo aceita
tanto um caminho absoluto quanto
um caminho relativo pasta do
Domnio atual. O caminho completo
deve existir para que o arquivo .mdb
seja criado ou encontrado
corretamente

Senha do BD Senha do Banco de Dados Access

Usurio Usurio do Banco de Dados

conectado pelo E3

Senha Senha do usurio que realiza o logon

Testar conexo Testa a conexo com o Banco de

Dados

3. No campo Banco de Dados, selecione o item 0 - stAccess.

4. Insira o nome do arquivo desejado (existente ou no) no campo Arquivo

MDB (conforme figura anterior).

5. Caso seja necessrio, configure as opes Usurio, Senha e Senha do BD

de acordo com as definies do Access. Tais itens podem ficar em branco
e, neste caso, a aplicao assume as configuraes padro do E3.

6. Clique em OK para finalizar as configuraes.

446 Banco de Dados

12.2 Oracle
A utilizao do Oracle como servidor de Banco de Dados do E3 s possvel
atravs da instalao de um servidor ou cliente Oracle na mquina onde
executado o E3 Server. Nesta instalao devem estar presentes,
obrigatoriamente, o suporte a OCI (Oracle Call Interface) e o OLEDB Provider
para Oracle, necessrios para a comunicao do E3 com o Oracle. Para
instalar o Oracle, consulte a documentao prpria do produto.

O acesso ao banco de dados Oracle pode ser feito de duas maneiras:

acessando o Banco de Dados Oracle de dentro do E3 ou via scripts. A seguir
so explicados cada um destes procedimentos.

Banco de Dados 447

12.2.1 Acessando o Oracle via E3
Para inserir um novo Banco de Dados Oracle, siga estes procedimentos:

1. Clique com o boto direito do mouse no nome do projeto no Explorer e

selecione a opo Inserir - Banco de Dados. No modo Domnio, clique
com o boto direito do mouse no item Objetos de Servidor - Banco de
Dados, selecione a opo Inserir Banco de Dados em e logo aps o
nome do projeto desejado. O objeto criado no projeto, e sua janela de
edio de scripts aberta.

2. Para configur-lo, selecione a aba Configurao na Janela de

Propriedades.

448 Banco de Dados

 Configuraes para Banco de Dados Oracle

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Configurao

OPO DESCRIO
Banco de Dados Seleciona o tipo de Banco de Dados
em uso no projeto: 0 - stAccess, 1 -
stOracle ou 2 - stSqlServer

Conexo Nome da conexo fornecido pelo

administrador do banco de dados

Banco de Dados 449

 OPO DESCRIO
Usar tipo TIMESTAMP Permite utilizar o tipo de dados
TIMESTAMP do Oracle, com
preciso de milissegundos e
disponvel a partir da verso 9.0.
Caso esta opo esteja desabilitada,
usado o tipo de dados DATE, com
preciso de segundos. NOTA: Para
que o objeto Consulta do E3 seja
compatvel com tabelas que utilizem
o tipo de dados TIMESTAMP, deve
ser habilitada a opo Usar drivers
ADO Oracle

Usar drivers ADO Oracle Permite usar as interfaces ADO

(ActiveX Data Objects) do Oracle para
que o objeto Consulta do E3
reconhea o tipo de dados
TIMESTAMP. Assim possvel ler
registros de tabelas do Oracle que
possuam preciso de milissegundos

Usurio Usurio do Banco de Dados

conectado pelo E3

Senha Senha do usurio que realiza o logon

Testar conexo Testa a conexo com o Banco de

Dados

450 Banco de Dados

3. No campo Banco de Dados, selecione o item 1 - stOracle.

4. Se o servidor Oracle for local, o campo Conexo pode ficar em branco,

pois o E3 recupera os dados automaticamente. Do contrrio, a conexo
criada usando o cliente Oracle instalado na mquina.

5. Caso seja necessrio, configure as opes Usurio e Senha de acordo

com as definies do Oracle. Tais itens podem ficar em branco e, neste
caso, a aplicao assume as configuraes padro do E3.

6. Clique em OK para finalizar as configuraes.

Ao inserir o Banco de Dados na aplicao, so habilitadas as opes

referentes ao tipo de Servidor de Banco de Dados. O Servidor de Banco de
Dados o responsvel pelo gerenciamento e armazenamento das
informaes dos objetos que utilizam este servio.

Banco de Dados 451

12.2.2 Acessando o Oracle via Scripts
Scripts so mdulos de linguagem de programao onde se pode criar linhas
de cdigo, que permitem maior flexibilidade para a associao de aes a
eventos especficos. Cada item de um projeto do E3 possui uma lista de
eventos previamente associados. Assim, o usurio pode criar programas que
so executados na ocorrncia de um evento.

O E3 utiliza o VBScript (Visual Basic Script) em seus scripts, e com ele consegue
instanciar qualquer objeto ActiveX registrado no sistema. Para o acesso ao
Banco de Dados, o ActiveX mais utilizado o ADO, que pode ser facilmente
manipulado nos scripts do E3.

Primeiramente, necessria a criao de uma conexo ADO que pode ser

feita com o script a seguir:
Set DBConnection = CreateObject("ADODB.Connection")
DBConnection.Open "Provider=MSDAORA;_
DataSource=conexaoOracle;User_
ID=UserID;Password=passwd"

Depois da criao da conexo, possvel executar um comando SQL

diretamente na conexo, como mostrado a seguir:
DBConnection.Execute _
"UPDATE Tabela SET nome = 'Joo' WHERE id = 10"

possvel tambm a visualizao de todos os registros desejados, retornados

na forma de um Recordset (consulta), como mostrado a seguir:
Set Recordset = CreateObject("ADODB.Recordset")
Recordset.Source = "Tabela"
Recordset.ActiveConnection = DbConnection
Recordset.CursorType = 1 ' adOpenKeyset
Recordset.LockType = 3 ' adLockOptimistic
Recordset.Open

A partir deste momento, possvel navegar pela tabela utilizando-se os

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

452 Banco de Dados

12.2.3 Tecnologias Utilizadas pelo E3 para Acessar o
Oracle
O E3 utiliza basicamente duas tecnologias para acessar o Banco de Dados
Oracle: ADO (ActiveX Data Object) e OCI (Oracle Call Interface).

ADO a tecnologia utilizada pelo E3Browser e E3Chart para recuperao dos

dados armazenados no Banco de Dados. O ADO tambm amplamente
utilizado nos scripts do E3 para todo tipo de operao junto ao Banco de
Dados. Ele um conjunto de objetos COM (Component Object Model) criado
para acessar informaes de SGBD usando OLE DB (Object Linking and
Embedding). Esta tecnologia est disponvel quando se instala o OLE DB
Provider para Oracle (MSDAORA) e permite o acesso interface nativa do
Oracle, a OCI.

A OCI utilizada pelo Servidor de Banco de Dados do E3 para implementar

os servios de Banco de Dados utilizados pelos Histricos, Frmulas, Alarmes
e Storage. Atravs da OCI se acessa diretamente as funes do Oracle,
tornando este processo o mais otimizado possvel. Ela fornece uma biblioteca
padro de acesso ao Banco de Dados e funes de recuperao de dados na
forma de uma DLL ou LIB, que pode ser conectada a uma aplicao em tempo
de execuo.

Banco de Dados 453

12.2.4 Acessando o Oracle via Servidor BD
O Servidor de Banco de Dados do E3 utiliza a OCI (Oracle Call Interface) para
se comunicar com o servidor Oracle, ou seja, utiliza a forma nativa do Banco
de Dados para ganhar em performance na comunicao com o Banco de
Dados.

Um bom exemplo de como funciona a comunicao do Servidor de Banco de

Dados do E3 com o Oracle o Histrico. Inicialmente feita a aquisio dos
dados pelo Histrico que, de posse destes dados, imediatamente os envia em
forma de requisies para o Banco de Dados. Estas requisies podem ser
para criao de uma tabela, criao de ndices e chaves, adio de dados, etc.
O Servidor de Banco de Dados do E3 possui um processo separado
especialmente para receb-las. Dependendo do tipo de operao a ser
realizada, os dados so formatados e armazenados em arquivos temporrios
ou em memria.

Ao mesmo tempo, o Banco de Dados possui mais um outro processo,

responsvel pela recuperao das aquisies e posterior envio para o banco
de dados em forma de comandos SQL, utilizando a OCI.

454 Banco de Dados

 Comunicao do E3 com o Oracle

12.3 SQL Server

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

Banco de Dados 455

12.3.1 Acessando o SQL Server via E3
Para inserir um novo Banco de Dados SQL Server, siga estes procedimentos:

1. Clique com o boto direito do mouse no projeto e selecione a opo

Inserir - Banco de Dados. O objeto criado e sua janela de edio de
scripts aberta.

2. Para configur-lo, selecione a aba Configurao na Janela de

Propriedades.

Configuraes para o Banco de Dados SQL Server

456 Banco de Dados

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Configurao

OPO DESCRIO
Banco de Dados Seleciona o tipo de Banco de Dados
em uso no projeto: 0 - stAccess, 1 -
stOracle ou 2 - stSqlServer

Servidor Nome do servidor

Banco de Dados Nome do Banco de Dados

Biblioteca de Rede Biblioteca de rede utilizada pelo ADO:

0 - Padro, 1 - Named Pipes, 2 -
Winsock TCP/IP, 3 - SPX/IPX, 4 -
Banyan Vines ou 5 - Multi-Protocol
(RCP)

Banco de Dados 457

 OPO DESCRIO
Alterar string de conexo Esta caixa de seleo permite
modificar a String de conexo a um
banco de dados SQL Server. As
seguintes restries se aplicam a esta
opo:

As alteraes feitas NO SO
validadas pelo E3. Portanto, de
inteira responsabilidade do usurio
a correta configurao da String
customizada

Se esta caixa de seleo estiver

desmarcada, o E3 utiliza o formato
padro para realizar a conexo

A String de conexo aceita duas

macros: {SERVER}, que substituda
pelo nome do servidor configurado
em Servidor e {DB}, que
substituda pelo nome do banco de
dados configurado em Banco de
Dados

Usurio Usurio do Banco de Dados

conectado pelo E3. Dependendo do
tipo de objeto a ser utilizado no
projeto, deve ter diferentes tipos de
permisso

Senha Senha do usurio que realiza o logon

Testar conexo Testa a conexo com o Banco de

Dados

458 Banco de Dados

3. No campo Banco de Dados, selecione o item 2 - stSqlServer.

4. Caso seja necessrio, configure as opes Usurio e Senha de acordo

com as definies do SQL Server. Tais itens podem ficar em branco e,
neste caso, a aplicao assume as configuraes padro do E3.

5. Clique em OK para finalizar as configuraes.

Banco de Dados 459

12.3.2 Exemplo de Utilizao do SQL Server 2000
Para ilustrar o acesso ao SQL Server 2000, faremos a criao de um Histrico
registrando dados por tempo de varredura de um segundo. Os
procedimentos so mostrados a seguir.

1. Crie um Tag Demo. As configuraes deste Tag no necessitam ser

alteradas.

2. Clique duas vezes no Servidor de Banco de Dados para abrir a janela de

configurao do Servidor SQL. Os parmetros devem ser alterados para
se adequarem s configuraes disponveis na instalao do SQL Server.

3. Execute as configuraes necessrias nesta janela, tais como nome do

servidor, usurio, senha e Banco de Dados.

4. Aps executar a configurao do Banco de Dados, deve-se configurar o

Histrico que acessa este banco de dados. Para tanto, primeiramente
deve-se criar um campo no Histrico e inserir o Tag Demo, que utilizado
para o envio de diferentes valores ao Banco de Dados.

Histrico e suas configuraes

5. Abra a janela de propriedades do Histrico clicando em Propriedades do

Histrico e determine o servidor de Banco de Dados e o nome da
tabela. As demais configuraes devem permanecer inalteradas. A tabela
serve para a busca de dados no E3 e tambm para visualizar o uso da
ferramenta SQL Server Analyzer, que o cliente usado para consultas no
SQL Server.

460 Banco de Dados

6. Finalizada a configurao do Histrico, necessria a criao da estrutura
de tabelas no Servidor de Banco de Dados. Para isto, clique em Gerar
estrutura no BD . Uma mensagem de confirmao da criao da
estrutura de tabelas mostrada na tela. Caso haja algum erro, deve-se
localizar o problema.

7. Para visualizar o Histrico em ao (salvando dados no servidor SQL

Server), crie uma Tela, insira um E3Browser e configure-o para acessar o
Servidor de Banco de Dados, como explicado anteriormente no Histrico,
e configure o E3Browser para ser atualizado automaticamente a cada 10
segundos, por exemplo.

8. Aps as configuraes, execute o projeto. Depois de algum tempo, o

E3Browser passa a exibir os dados que esto sendo enviados ao servidor.

9. possvel consolidar os dados que so mostrados no E3 e os que esto

salvos no servidor utilizando o objeto Consulta do E3Browser e o software
SQL Query Analyzer. Para isto, crie diferentes consultas no Banco de
Dados e edite-as na Consulta e tambm no Query Analyzer. Os resultados
devem ser os mesmos, se o Domnio estiver parado, ou semelhantes, se o
Domnio estiver executando. Esta diferena deve-se atualizao
constante do Banco de Dados quando o Domnio est sendo executado.
Para a edio de consultas no objeto Consulta, habilite a opo Habilita
edio direta do SQL.

12.3.3 Uso de ADODB para Acesso via Script

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

O uso deste tipo de acesso deve ser restrito a casos onde no exista outra
soluo. O E3 disponibiliza recursos que visam minimizar o uso destes
acessos via script. Entretanto, eventualmente o uso deste recurso pode ser
necessrio.

Banco de Dados 461

12.4 Objetos do E3 e Permisses
necessrio configurar as permisses no Banco de Dados para a utilizao
dos objetos do E3 em um projeto. Estas permisses esto listadas na tabela a
seguir.

Opes disponveis para permisses

OBJETO PERMISSO
Frmulas Permisso completa

Histrico de usurio Escreve e consulta as tabelas

existentes

Histrico Permisso completa

Servidor de Alarmes Permisso completa

Nas permisses, a expresso Permisso completa significa que o usurio

tem permisses para:

Criar ou remover tabelas existentes

Criar ndices e chaves

Inserir e excluir dados nas tabelas criadas

Realizar consultas sobre as tabelas resultantes

O usurio no precisa ser um Administrador para possuir Permisso completa

em qualquer objeto.

462 Banco de Dados

CAPTULO
Alarmes
13
O E3 dispe de um conjunto de objetos que permite ao usurio monitorar
alarmes em uma aplicao. Com eles possvel especificar e gerenciar
alarmes e eventos de variveis de um processo. As condies de alarme
podem ser gerenciadas em diversas fontes. O sistema composto de um
objeto centralizador de alarmes, chamado Servidor de Alarmes, e de um ou
mais objetos de configurao, chamado Configurao de Alarmes. Os
tpicos a seguir detalham estes objetos.

Alarmes 463
13.1 Configurao de Alarmes
O objeto Configurao de Alarmes o local onde as reas so inseridas e
organizadas. Para inserir este objeto em um projeto, siga este procedimento:

1. Clique com o boto direito do mouse no nome do projeto no modo

Explorer e selecione a opo Inserir - Configurao de Alarmes. No
modo Domnio, clique com o boto direito do mouse no item Objetos de
Servidor - Alarmes, selecione a opo Inserir Configurao de Alarmes
em e logo aps o nome do projeto.

Inserindo o objeto Configurao de Alarmes

464 Alarmes
NOTAS
Todas as opes do editor de objetos da Configurao de Alarmes e das
reas de Alarme que esto disponveis via menu contextual (atravs do
clique com o boto direito do mouse) tambm esto disponveis utilizando
a combinao de teclas SHIFT + F10, que corresponde tecla de aplicao
ou de menu .
A janela de propriedades dos objetos da Configurao de Alarmes e das
reas de Alarme no editor de objetos pode ser aberta utilizando as
combinaes de teclas ALT + ENTER, CTRL + ALT + ENTER ou ALT +
duplo-clique do mouse.

Alarmes 465
13.1.1 reas de Alarme
As reas de Alarme permitem agrupar um conjunto de Fontes de Alarmes,
bem como outras reas. Isto facilita o gerenciamento, a operao e o
monitoramento de um conjunto de Fontes de Alarme relacionadas, como por
exemplo:

Filtrar o conjunto de alarmes visveis no sumrio

Habilitar ou desabilitar um conjunto de Fontes de Alarmes

Reconhecer um conjunto de Fontes de Alarmes

Verificar o total de alarmes ativos ou no reconhecidos de um conjunto

de Fontes de Alarmes

Caso haja necessidade, novas reas podem ser inseridas dentro de outras.
Para inserir este objeto, siga este procedimento:

1. Clique com o boto direito do mouse no objeto Configurao de Alarmes

ou no objeto rea do projeto no modo Explorer e selecione a opo
Inserir - rea. No modo Domnio, clique com o boto direito do mouse
no objeto Configurao de Alarmes e selecione o item Inserir - rea.

466 Alarmes
 Inserindo uma rea de Alarme

Algumas das propriedades deste objeto podem ser configuradas atravs da

Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso
necessite configurar alguma propriedade, localize-a na Lista de Propriedades
e faa os devidos ajustes. Demais informaes sobre as funcionalidades das
propriedades deste objeto podem ser encontradas no Manual de Referncia
e Scripts do E3, em seu captulo respectivo.

Alarmes 467
13.1.1.1 Objetos de Servidor como reas de Alarme

Objetos de Servidor tm a possibilidade de se comportarem como reas de

Alarme. Estes objetos agora possuem uma aba adicional, rea de Alarmes,
onde este comportamento pode ser habilitado e configurado. A figura a
seguir mostra esta aba em um Driver de Comunicao.

Aba rea de Alarmes

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba rea de Alarmes

OPO DESCRIO
Funcionar como rea de alarmes Habilita ou desabilita o
comportamento de rea de Alarme
para o objeto de Servidor. Esta
opo corresponde propriedade
IsAlarmArea

468 Alarmes
 OPO DESCRIO
Verificar alarmes Habilita ou desabilita a verificao de
alarmes no objeto. Esta opo
corresponde propriedade
AlarmVerify

Campos do usurio Veja o tpico Configuraes dos

Campos do Usurio para maiores
informaes

As seguintes propriedades ficam disponveis no objeto de Servidor:

ActiveAlarms

ActiveHighAlarms

ActiveHighNACKAlarms

ActiveLowAlarms

ActiveLowNACKAlarms

ActiveMedAlarms

ActiveMedNACKAlarms

ActiveNACKAlarms

Alarm

AlarmVerify

UserFields

Alarmes 469
13.2 Filtro de Alarmes
O objeto Filtro de Alarmes permite especificar filtros de alarmes da mesma
forma que o E3Alarm, exceto que no possui uma representao grfica que
possa ser mostrada em Tela. Ao invs disto, o resultado da filtragem pode
ser consumido atravs dos diversos contadores de alarmes ou da coleo de
eventos.

NOTAS
O objeto Filtro de Alarmes pode ser inserido em uma Tela, no Viewer, em
uma Pasta do Viewer ou em uma Pasta de Dados.
No possvel reconhecer alarmes utilizando o objeto Filtro de Alarmes.

Para inserir este objeto em uma Tela, por exemplo, siga este procedimento:

1. Clique com o boto direito do mouse em uma Tela e selecione a opo

Inserir - Standard - Filtro de Alarmes.

470 Alarmes
 Opo Inserir - Standard - Filtro de Alarmes

Algumas das propriedades deste objeto podem ser configuradas atravs da

Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso
necessite configurar alguma propriedade, localize-a na Lista de Propriedades
e faa os devidos ajustes.

13.2.1 Configurao
Para configurar um Filtro de Alarmes, clique com o boto direito do mouse no
objeto e selecione a opo Propriedades.

Alarmes 471
13.2.1.1 Aba Conexes

A aba Conexes permite gerenciar as conexes do Filtro de Alarmes com

Servidores de Alarmes locais ou remotos.

Aba Conexes

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Conexes

OPO DESCRIO
Adiciona uma nova Conexo ao Filtro
de Alarmes. Esta opo corresponde
ao mtodo Add da Coleo de
Conexes

472 Alarmes
 OPO DESCRIO

Remove a Conexo selecionada. Esta

opo corresponde ao mtodo
Remove da Coleo de Conexes.
NOTA: A Conexo criada
automaticamente com o objeto no
pode ser removida

Nome conexo Nome desta Conexo. Pressione a

tecla F2 para editar este nome. Esta
opo corresponde propriedade
ConnectionName do objeto
Conexo na Coleo de Conexes

Nome servidor Nome amigvel para identificar o

Domnio do Servidor de Alarmes
selecionado. Esta opo corresponde
propriedade DomainName do
objeto Conexo na Coleo de
Conexes

Servidor de Alarmes Nome do Servidor de Alarmes, que

tanto pode estar em um Domnio
local quanto em um Domnio
Remoto. Esta opo corresponde
propriedade AlarmServer do objeto
Conexo na Coleo de Conexes.
Clique em para selecionar um
Servidor de Alarmes utilizando o
AppBrowser

Filtro conexo Nome de um Filtro que contm a

configurao do filtro de alarmes,
definido na aba Filtros. Esta opo
corresponde propriedade
FilterConnection do objeto Conexo
na Coleo de Conexes

Alarmes 473
13.2.1.2 Aba Filtros

A aba Filtros permite gerenciar os filtros do Filtro de Alarmes.

Aba Filtros

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Filtros

OPO DESCRIO
Filtros Caixa de seleo com os Filtros
atualmente disponveis

Configurar Abre a janela de configurao do

Filtro selecionado, descrita a seguir

Adicionar Adiciona um novo Filtro Coleo de

Filtros. Esta opo corresponde ao
mtodo Add da Coleo de Filtros

474 Alarmes
 OPO DESCRIO
Remover Remove o Filtro selecionado. Esta
opo corresponde ao mtodo
Remove da Coleo de Filtros.
NOTA: O Filtro criado
automaticamente com o objeto no
pode ser removido

Ao clicar em Configurar, a janela da figura a seguir aberta para

configurao do Filtro selecionado.

Propriedades do Filtro selecionado

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela de propriedades de um Filtro

Alarmes 475
 OPO DESCRIO
Nome Nome deste Filtro. Esta opo
corresponde propriedade
FilterName

Filtrar por rea de Alarme Determina o filtro por rea de

Alarme. Caso deseje utilizar algum
filtro, especifique-o neste campo,
seno deixe-o em branco. Esta
opo equivale propriedade
AreaFilter

Filtro de rea Simples Se a opo Filtrar por rea de

Alarme no estiver em branco, esta
opo habilitada e, se estiver
selecionada, a filtragem por rea
baseada apenas na coincidncia da
parte inicial do nome. Caso contrrio,
considera o nome completo da rea.
Esta opo equivale propriedade
SimpleAreaFilter

Utilizar filtro customizado Permite informar um filtro

personalizado para os alarmes. Esta
opo corresponde propriedade
CustomFilter

Filtrar por tipo Habilita o tipo de filtro que

aplicado no alarme (Apenas
alarmes, Apenas eventos ou
Alarmes e Eventos). Esta opo
equivale propriedade FilterType

Filtrar por severidade Habilita ou desabilita a visualizao

do grau da severidade (Alta, Mdia
ou Baixa). Esta opo equivale s
propriedades ShowHightPriority
(Alta), ShowMediumPriority (Mdia)
e ShowLowPriority (Baixa)

476 Alarmes
13.2.1.3 Aba Ordenao

A aba Ordenao permite configurar a ordenao padro dos alarmes.

Quando mais de um campo de ordenao for usado, os campos
subsequentes permitem a ordenao entre alarmes que tenham o(s)
mesmo(s) valor(es) para o(s) campo(s) anterior(es).

Aba Ordenao

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Ordenao

OPO DESCRIO
Pelo campo Ordena os alarmes conforme o
campo especificado. Esta opo
equivale propriedade
PrimarySortField. A ordenao
padro feita atravs do campo
InTime, de maneira descendente

Alarmes 477
 OPO DESCRIO
Depois por Ordena os alarmes a partir do item
especificado na opo Pelo campo.
O prximo item ordenado a partir
da especificao indicada nos
campos Depois por. Estas opes
equivalem s propriedades
SecondarySortField, ThirdSortField
e FourthSortField, respectivamente

Ascendente Ordena os campos do alarme de

forma ascendente. Estas opes
equivalem s propriedades
PrimarySortAscending,
SecondarySortAscending,
ThirdSortAscending e
FourthSortAscending em
Verdadeiro, respectivamente.

Descendente Ordena os campos do alarme de

forma descendente. Estas opes
equivalem s propriedades
PrimarySortAscending,
SecondarySortAscending,
ThirdSortAscending e
FourthSortAscending em Falso,
respectivamente

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

NOTA
O objeto Fonte de Alarme pode ser criado dentro de qualquer objeto do
Servidor.

Para inserir este objeto, siga este procedimento:

1. Clique com o boto direito do mouse no objeto de Servidor no modo

Explorer e selecione a opo Inserir - Alarme (Analgico, Banda Morta,
Taxa de Variao, Digital ou Discreto). No modo Domnio, selecione o
objeto desejado no item Objetos de Servidor e selecione a opo Inserir
- Alarme (Analgico, Banda Morta, Taxa de Variao, Digital ou
Discreto).

Alarmes 479
 Inserindo uma Fonte de Alarme

Algumas das propriedades deste objeto podem ser configuradas atravs da

Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso
necessite configurar alguma propriedade, localize-a na Lista de Propriedades
e faa os devidos ajustes. Demais informaes sobre as funcionalidades das
propriedades deste objeto podem ser encontradas no Manual de Referncia
e Scripts do E3, em seu captulo respectivo.

Em cada sub-condio de alarme so configurados seus limites, a mensagem

relativa ao evento, sua severidade e a necessidade ou no de reconhecimento
deste evento.

480 Alarmes
 Fontes de Alarmes

Ao abrir a janela de Propriedades de qualquer Fonte de Alarme e selecionar a

aba Fonte, a janela mostrada na figura a seguir aberta.

Aba Fonte

Para tratar o alarme como evento, ou para que o alarme possa ser
reconhecido duplamente (tanto quando estiver ativo como quando passar
para inativo), clique na caixa de seleo correspondente. Todas as Fontes de
Alarme possuem as seguintes propriedades gerais:

Alarmes 481
 Texto da Mensagem: Esta mensagem armazenada no campo
Mensagem do evento de alarme enquanto ele estiver ativo, ou seja, pode
ser visualizada no E3Alarm (sumrio de alarmes), armazenada no Banco
de dados, etc. O limite do texto da mensagem de 200 caracteres

Severidade: Indica a gravidade do alarme ocorrido (Baixa, Mdia ou

Alta). O campo Severidade utilizado para realizao de filtros e
ordenao nas mensagens

Pede Ack: Indica se o alarme deve ser reconhecido pelo operador para
ser retirado da lista de alarmes no E3Alarm, ou se reconhecido
automaticamente quando a varivel deixa uma condio de alarme

Volta ao normal: Esta mensagem armazenada no campo Mensagem

do evento de alarme enquanto este estiver inativo, ou seja, pode ser
visualizada no E3Alarm (sumrio de alarmes), armazenada em um Banco
de Dados, etc.

H vrios tipos de Fontes de Alarme que podem ser inseridas em objetos do

Servidor. As opes disponveis esto descritas nos prximos tpicos.

482 Alarmes
13.3.1 Alarme Analgico
Permite monitorar uma varivel analgica pela especificao de at quatro
nveis de alarme, que so LoLo (Muito Baixo), Lo (Baixo), Hi (Alto) e HiHi
(Muito Alto).

Aba Analgico

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Analgico

OPO DESCRIO
Habilitao (LoLo, Lo, Hi, HiHi) Habilita a verificao do tipo de
alarme selecionado

Limite Indica o nvel em que o alarme

disparado

Texto da mensagem Permite especificar o texto que

mostrado para o usurio quando o
alarme estiver em condio ativa

Alarmes 483
 OPO DESCRIO
Severidade Determina a severidade do nvel de
alarme (pode ser Alta, Mdia ou
Baixa)

Pede Ack Habilita ou desabilita o

reconhecimento do alarme

Evento Habilita ou desabilita o tratamento

de cada sub-condio do alarme
como um evento

Espera Especifica o tempo de espera, em

milissegundos. Quando o valor for
igual a 0 (zero, padro), no
aplicada nenhuma espera

Banda morta Habilita a banda morta, que um

recurso utilizado para evitar que uma
varivel, ao manter uma pequena
oscilao em torno de um limite de
alarme, gere uma quantidade
desnecessria de mensagens

Volta ao normal Permite especificar o texto a ser

mostrado para o usurio quando o
alarme no estiver em condio ativa

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

Banda morta

Este tipo de alarme interessante quando a referncia (SetPoint) varivel, e

tambm quando se deseja evitar uma quantidade desnecessria de alarmes
para pequenas oscilaes da varivel monitorada.

Alarmes 485
 Aba Banda Morta

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Banda Morta

OPO DESCRIO
SetPoint Associao para a varivel de
referncia, para que seja monitorada
uma diferena em relao varivel
de monitoramento

BM Habilita a banda morta, que um

recurso utilizado para evitar que uma
varivel, ao manter uma pequena
oscilao em torno de um limite de
alarme, gere uma quantidade
desnecessria de mensagens

486 Alarmes
 OPO DESCRIO
Valor Indica a diferena entre a varivel
monitorada e o SetPoint, a partir do
qual deve ser indicado o alarme.
Deve ser informado em unidades de
engenharia da varivel monitorada

Texto da mensagem Permite especificar o texto que

mostrado para o usurio quando o
alarme estiver em condio ativa

Severidade Determina a severidade do nvel de

alarme (pode ser Alta, Mdia ou
Baixa)

Pede Ack Habilita ou desabilita o

reconhecimento do alarme

Espera (ms) Especifica o tempo de espera, em

milissegundos. Quando o valor for
igual a 0 (zero, padro), no
aplicada nenhuma espera

Volta ao normal Permite especificar o texto a ser

mostrado para o usurio quando o
alarme no estiver em condio ativa

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

Aba Taxa de Variao

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Taxa de Variao

OPO DESCRIO
TDV Habilita a verificao do alarme Taxa
de Variao

488 Alarmes
 OPO DESCRIO
Variao/segundo Indica a porcentagem da varivel
monitorada que pode variar por
segundo. Este valor calculado
tomando como base cada intervalo
de leitura da varivel, pela frmula
TDV = (Valor Atual - Valor
Anterior) / (Instante Atual -
Instante Anterior). Se a taxa de
variao for maior que a taxa
especificada, considerado em
estado de alarme

Texto da mensagem Permite especificar o texto que

mostrado para o usurio quando o
alarme estiver em condio ativa

Severidade Determina a severidade do nvel de

alarme (pode ser Alta, Mdia ou
Baixa)

Pede Ack Habilita ou desabilita o

reconhecimento do alarme

Espera (ms) Especifica o tempo de espera, em

milissegundos. Quando o valor for
igual a 0 (zero, padro), no
aplicada nenhuma espera

Volta ao normal Determina a mensagem de texto que

mostrada ao usurio quando o
alarme voltar ao estado normal

Alarmes 489
13.3.4 Alarme Digital
Permite monitorar uma varivel digital pela especificao de alarme na borda
de subida (em -1 ou Verdadeiro) ou na borda de descida (em 0 ou Falso).

Aba Digital

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Digital

OPO DESCRIO
Alarme Digital Habilita o alarme digital

Valor Determina o valor Booleano do

alarme (Verdadeiro ou Falso)

Texto da mensagem Permite especificar o texto que

mostrado para o usurio quando o
alarme estiver em condio ativa

490 Alarmes
 OPO DESCRIO
Severidade Determina a severidade do nvel de
alarme (pode ser Alta, Mdia ou
Baixa)

Pede Ack Habilita ou desabilita o

reconhecimento do alarme

Espera (ms) Especifica o tempo de espera, em

milissegundos. Quando o valor for
igual a 0 (zero, padro), no
aplicada nenhuma espera

Volta ao normal Permite especificar o texto a ser

mostrado para o usurio quando o
alarme no estiver em condio ativa

Alarmes 491
13.3.5 Alarme Discreto
Permite monitorar uma varivel pela especificao de mltiplas sub-condies.

Aba Discreto

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Discreto

OPO DESCRIO
Adiciona uma nova Sub-condio no
alarme

Remove a Sub-condio selecionada

492 Alarmes
 OPO DESCRIO
Mapear todas as subcondies Permite mapear e sincronizar as Sub-
condies do Alarme a partir de
semnticas presentes no objeto
fonte. Este recurso atualmente s
suportado pelos objetos de servidor
do Elipse Power, portanto este
boto permanece desabilitado por
padro no Elipse E3

Nome Nome da Sub-condio

Habilitado Habilita ou desabilita a Sub-condio

Descrio Descrio da Sub-condio

Valor Valor avaliado para determinar se o

alarme ocorre ou no

Texto da mensagem Mensagem mostrada quando a Sub-

condio est ativa

Tipo Comportamento da Sub-condio.

Pode assumir os valores 0: Alarme,
1: Evento ou 2: Retorno

Severidade O tipo de severidade da Sub-

condio. Pode assumir os valores 0:
Alta, 1: Mdia ou 2: Baixa

Pede Ack? Indica se esta Sub-condio exige

reconhecimento

Espera (ms) Especifica o tempo de espera, em

milissegundos. Quando o valor for
igual a 0 (zero, padro), no
aplicada nenhuma espera

Alarmes 493
 OPO DESCRIO
Volta ao normal Permite especificar o texto a ser
mostrado para o usurio quando o
alarme no estiver em condio ativa

494 Alarmes
13.4 Servidor de Alarmes
O objeto Servidor de Alarmes centraliza todos os alarmes do projeto. Nele
podem ser encontrados todos os alarmes ativos da aplicao, reconhecidos
ou no. Este objeto tambm responsvel por reportar os eventos de alarme
para todos os Viewers conectados, bem como enviar estes eventos para um
banco de dados, se necessrio.

Uma aplicao s pode ter um objeto deste tipo, e sua presena

obrigatria para que a verificao de alarmes ocorra. Para inserir um Servidor
de Alarmes, siga este procedimento:

1. Clique com o boto direito do mouse no projeto no modo Explorer e

selecione a opo Inserir - Servidor de Alarmes. No modo Domnio,
clique com o boto direito do mouse no item Objetos de Servidor -
Alarmes, selecione a opo Inserir Servidor de Alarmes em e logo aps
o nome do projeto desejado.

Inserindo um Servidor de Alarmes no modo Domnio

Alarmes 495
13.4.1 Configuraes para Gerao da Tabela de
Alarmes
Para especificar as configuraes do Servidor de Alarmes, clique com o boto
direito do mouse no objeto e selecione a opo Propriedades.

Na aba Configurao, possvel especificar as configuraes de Banco de

Dados e determinar campos para a gerao da tabela de alarmes.

Aba Configurao

Cada campo da aba Configurao possui uma propriedade correspondente.

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Configurao

496 Alarmes
 OPO DESCRIO
Armazenar alarmes em banco de Habilita ou desabilita o
dados armazenamento dos dados dos
alarmes em um banco de dados.
Este campo equivale propriedade
Logging

Servidor de Banco de Dados Define o servidor de Banco de Dados

que armazena os dados do alarme.
Este campo equivale propriedade
DataSource

Nome da tabela Define o nome da tabela de alarmes.

Este campo equivale propriedade
TableName

Descartar dados da tabela principal Habilita ou desabilita o descarte de

dados da tabela principal. O dado
considerado antigo de acordo com o
que for definido na opo Descartar
dados mais antigos que. Este
campo equivale propriedade
EnableDiscard

Descartar dados mais antigos que Determina o intervalo de tempo

(minutos, horas, dias ou meses)
durante o qual os dados so
mantidos na tabela principal. Se um
dado da tabela for mais antigo que
o intervalo de tempo desta opo,
ele descartado. Este campo
equivale propriedade
DiscardInterval e o campo de
seleo da unidade de tempo do
intervalo equivale propriedade
DiscardTimeUnit

Alarmes 497
 OPO DESCRIO
Realizar o descarte a cada Executa a verificao dos alarmes,
conforme o perodo especificado no
campo (em minutos, horas, dias ou
meses). Este campo equivale
propriedade VerificationInterval e o
campo de seleo da unidade de
tempo do intervalo equivale
propriedade VerificationUnit

Mover para a tabela de backup os Habilita ou desabilita o

dados descartados armazenamento dos dados
descartados na tabela secundria
(tabela de backup). Este campo
equivale propriedade
EnableBackupTable

Descartar do backup dados mais Determina o intervalo mximo de

antigos que tempo (minutos, horas, dias ou
meses) dos dados na tabela de
backup at serem descartados,
independente do tempo que os
dados permanecem na tabela
principal. Por exemplo, para manter
os dados por 24 meses na tabela
principal e mais seis meses na tabela
de backup, o valor desta opo deve
ser de 30 meses. Este intervalo deve
ser sempre maior que o configurado
no item Descartar dados mais
antigos que da tabela principal. Este
campo equivale propriedade
BackupDiscardInterval e o campo
de seleo da unidade de tempo do
intervalo equivale propriedade
BackupDiscardTimeUnit

Campos Determina quais campos dos eventos

de alarme so adicionados tabela
de alarmes, e qual a ordem em que
estas colunas aparecem

498 Alarmes
 OPO DESCRIO
Gerar Tabela Gera a tabela dos alarmes no Banco
de Dados especificado

Os campos disponveis no Servidor de Alarmes para gerao da tabela de

alarmes esto descritos na tabela a seguir.

Campos disponveis para tabelas dos Campos dos alarmes

OPO DESCRIO
Acked Informa se o alarme foi reconhecido
ou no. Este campo pode assumir os
valores 0: No reconhecido ou 1:
Reconhecido

AckRequired Determina o reconhecimento

automtico do alarme. Este campo
apresenta os valores 0:
Reconhecimento automtico ou 1:
Reconhecimento manual

AckTime Registra a data e hora do E3 no

momento em que o alarme
reconhecido, ou zero (30/12/1899)
enquanto o alarme no for
reconhecido. No caso de alarmes que
no pedem reconhecimento, o campo
assume a data e hora do E3 no
momento em que o alarme se torna
ativo

AckTimeDbl Semelhante ao campo anterior.

usado para facilitar a gravao de
dados do tipo Double no caso de
bancos de dados Oracle ou SQL
Server

Alarmes 499
 OPO DESCRIO
ActorID Nome do operador que reconheceu o
alarme. Pode ser:

O usurio logado no Viewer,

quando o reconhecimento feito no
E3Alarm (ou "Sem usurio", se no
h usurio logado)

"System", quando o reconhecimento

automtico, ou seja, para alarmes
que no pedem reconhecimento

Um nome passado por script (por

exemplo, usando AckArea,
AckAllAlarms ou
LogTrackingEvent do Servidor de
Alarmes, ou Ack da Fonte de
Alarmes)

O limite deste campo, quando

armazenado no Banco de Dados, de
50 caracteres

AlarmSourceName Registra o nome da Fonte de Alarme.

O limite deste campo, quando
armazenado no Banco de Dados, de
100 caracteres

Area Para eventos de alarme, o nome da

rea qual a Fonte de Alarmes
pertence. Para outros eventos (por
exemplo, usando o mtodo
LogTrackingEvent do Servidor de
Alarmes), pode ser um texto definido
pelo usurio. O limite deste campo,
quando armazenado no Banco de
Dados, de 100 caracteres

ChangeMask No usado e seu valor sempre 0

(zero)

500 Alarmes
 OPO DESCRIO
ConditionActive Indica se a Fonte de Alarme est em
alarme. Este campo apresenta os
estados 0: Condio no ativa ou 1:
Condio ativa

ConditionName Nome da condio, se for um evento

de alarme. Este campo pode
apresentar os seguintes valores:

Banda Morta: Fonte de Alarme do

tipo Banda Morta

Digital: Fonte de Alarme do tipo

Digital

Nvel: Fonte de Alarme do tipo

Analgico

TaxaDeVariao: Fonte de Alarme

do tipo Taxa de Variao

Se o evento no for um alarme (por

exemplo, usando o mtodo
LogTrackingEvent do Servidor de
Alarmes), este valor sempre uma
String vazia.O limite deste campo,
quando armazenado no Banco de
Dados, de 100 caracteres

Cookie Valor associado Fonte de Alarme,

usado internamente pelo Servidor de
Alarmes

Alarmes 501
 OPO DESCRIO
CurrentValue Determina o valor da Fonte de Alarme
(convertido para Double) no
momento do evento. Para outros
eventos (por exemplo, usando o
mtodo LogTrackingEvent), o valor
sempre 0 (zero). O limite deste
campo, quando armazenado no Banco
de Dados, de 100 caracteres

Deleted Determina se este alarme foi

removido. Um alarme s pode ser
removido se o campo Unbound
estiver configurado como Verdadeiro

Enabled Determina se a verificao do alarme

est habilitada. Este campo apresenta
os estados 0: Verificao da fonte de
alarmes desabilitada ou 1:
Verificao da fonte de alarme
desabilitada

502 Alarmes
 OPO DESCRIO
EventCategory Categoria do evento. Para alarmes,
este campo pode assumir os
seguintes valores:

Banda Morta: Fonte de Alarme do

tipo Banda Morta

Digital: Fonte de Alarme do tipo

Digital

Nvel: Fonte de Alarme do tipo

Analgico

TaxaDeVariao: Fonte de Alarme

do tipo Taxa de Variao

Para outros eventos (por exemplo,

usando o mtodo LogTrackingEvent
do Servidor de Alarmes), o campo
pode assumir valores definidos pelo
usurio. O limite deste campo, quando
armazenado no Banco de Dados, de
100 caracteres

EventCLSID Identificador nico para toda a vida

de um alarme. Quando um alarme
novo ocorre em uma Fonte, gerado
um novo nmero de EventCLSID.
Assim, ele mantm este mesmo CLSID
no banco de dados enquanto no sair
da lista de alarmes ativos e no
reconhecidos

EventTime Data e hora do valor da Fonte de

Alarme no momento do evento

Alarmes 503
 OPO DESCRIO
EventTimeDbl Semelhante ao campo anterior.
usado para facilitar a gravao de
dados do tipo Double no caso de
bancos de dados Oracle ou SQL
Server

EventTimeUTC Data e hora do valor da Fonte de

Alarme no momento do evento, com
relao ao horrio de Greenwich. O
valor o mesmo do campo
EventTime, sendo mantido no E3 por
questes de compatibilidade

EventType Tipo do evento. Para eventos de

alarme, sempre Condition. Para
outros eventos, pode ser um texto
definido pelo usurio, como por
exemplo usando o mtodo
LogTrackingEvent do Servidor de
Alarmes ("Tracking", "Simple", etc.). O
limite deste campo, quando
armazenado no Banco de Dados, de
100 caracteres

FormattedValue Mostra o valor formatado da Fonte de

Alarme que vai para o seu evento. O
limite deste campo, quando
armazenado no Banco de Dados, de
100 caracteres. NOTA: Este campo
somente de leitura

FullAlarmSourceName Registra o caminho completo da Fonte

de Alarme, incluindo reas, nome da
Configurao de Alarmes e de
possveis Pastas onde esta possa
estar inserida. Por exemplo,
Pasta1.ConfigAlarmes1.Area1.Fonte
Alarme1

504 Alarmes
 OPO DESCRIO
InTime Registra a data e hora do valor, no
momento em que ele entra na
condio de alarme

InTimeDbl Semelhante ao campo anterior.

usado para facilitar a gravao de
dados do tipo Double no caso de
bancos de dados Oracle ou SQL
Server

Message o texto configurado na Fonte de

Alarme, ou especificado por um outro
evento (por exemplo, usando o
mtodo LogTrackingEvent do
Servidor de Alarmes). O limite deste
campo, quando armazenado no Banco
de Dados, de 200 caracteres

OutTime Registra a data e hora do valor no

momento em que ele sai da condio
de alarme, ou zero (30/12/1899) caso
o alarme ainda no tenha sado da
condio ativa

OutTimeDbl Semelhante ao campo anterior.

usado para facilitar a gravao de
dados do tipo Double no caso de
bancos de dados Oracle ou SQL
Server

Alarmes 505
 OPO DESCRIO
Quality Qualidade do valor de Fonte de
alarme no momento do evento. Este
campo assume os seguintes valores
numricos:

0 - 63: Qualidade ruim

64 - 127: Qualidade incerta

128 - 191: Valor no definido

192 - 255: Qualidade boa

Se o evento no for um alarme (por

exemplo, ao utilizar o mtodo
LogTrackingEvent do Servidor de
Alarmes), este campo igual a uma
String vazia. Exemplo: Ruim (0);
Incerta (64); ?? (128); Boa (192)

Severity o valor de severidade configurado

na Fonte de Alarme. Este campo pode
assumir os valores 0: Alta, 1: Mdia
ou 2: Baixa. Ele pode tambm assumir
outro valor definido pelo usurio se
for um evento, como por exemplo
quando estiver usando o mtodo
LogTrackingEvent

Source Para eventos de alarme, informa a

expresso utilizada para avaliar as
condies de alarme. O limite deste
campo, quando armazenado no Banco
de Dados, de 100 caracteres

506 Alarmes
 OPO DESCRIO
SubConditionName Nome da sub-condio, se for um
evento de alarme. Este campo pode
assumir os seguintes valores:

BM: Alarme de Banda Morta

DIG: Alarme Digital

TV: Alarme Taxa de Variao

LOLO: Alarme Analgico na faixa

Muito Baixo

LO: Alarme Analgico na faixa Baixo

HI: Alarme Analgico na faixa Alto

HIHI: Alarme Analgico na faixa

Muito Alto

Se o evento no for um alarme (por

exemplo, ao utilizar o mtodo
LogTrackingEvent do Servidor de
Alarmes), este campo igual a uma
String vazia. O limite deste campo,
quando armazenado no Banco de
Dados, de 100 caracteres

Unbound Indica se este alarme no est

vinculado a uma Fonte de Alarme

Campos do Usurio So os campos definidos pelo

usurio. Estes campos so
configurados na aba Campos do
usurio, no Servidor de Alarmes

Alarmes 507
NOTAS
necessrio que haja um Servidor de Alarmes no Domnio para que seja
possvel o monitoramento de alarmes.
Os campos EventTimeMS, InTimeMS, OutTimeMS e AckTimeMS contm
os valores em milissegundos dos campos EventTime, InTime, OutTime e
AckTime, respectivamente. Estes campos so usados quando for
necessrio registrar o tempo, em milissegundos, dos eventos em um
servidor de bancos de dados Oracle. Observe que estes campos no
esto disponveis no E3Alarm, pois neste objeto possvel visualizar os
milissegundos atravs da formatao das colunas de data e hora.

Depois de definidas todas as configuraes, a aplicao inicializa a insero e

gravao das informaes na tabela dos alarmes, conforme as especificaes
dos campos. Ao clicar em Gerar tabela, o Studio gera a tabela de dados dos
alarmes conforme as especificaes, e informa se a tabela foi gerada com
sucesso.

Mensagem do Servidor de Alarmes

A estrutura da tabela dos alarmes semelhante do Histrico, composta por

uma tabela de definies, uma tabela principal de dados e uma tabela de
backup (opcional).

508 Alarmes
 Tabela de campos

Os campos gerados na tabela so explicados no tpico Configuraes da

Tabela do captulo Histrico.

Atravs da janela de configurao do Servidor de Alarmes, pode-se

especificar o Servidor de Banco de Dados utilizado para a gravao dos
alarmes. O Servidor de Banco de Dados (objeto DBServer) um mdulo do
E3 que deve ser inserido na aplicao.

Alarmes 509
13.4.2 Configuraes dos Campos do Usurio
Na aba Campos do usurio pode-se adicionar valores arbitrrios aos
eventos de alarmes.

Aba Campos do usurio

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Campos do usurio

OPO DESCRIO
Nome Determina o nome do Campo

Tipo Determina o tipo do Campo (0:

String, 1: Integer, 2: Double ou 3:
DateTime)

Tamanho Determina o tamanho do Campo

Fonte Determina a fonte de dados do

Alarme

510 Alarmes
 OPO DESCRIO
Propagar? Fora a atualizao imediata de
todos os alarmes que herdam o
valor deste Campo do Usurio,
sempre que este receber um valor
forado ou se a Associao for
alterada

Adiciona um Campo do Usurio ao

final da listagem

Remove o ltimo Campo do Usurio

da listagem

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

Campos do Usurio herdados

NOTA
Para mais informaes sobre o comportamento de um Campo do Usurio
de reas e Fontes de Alarme, tanto em Studio quanto em tempo de
execuo, verifique as propriedades Link, Value e ValueSource no Manual
de Referncia e Scripts do E3.

512 Alarmes
 CAPTULO
E3Alarm
14
O E3Alarm serve para monitoramento dos alarmes ativos ou no
reconhecidos em uma aplicao. Atravs deste objeto, possvel verificar o
estado dos alarmes, bem como reconhec-los manualmente.

E3Alarm

Para utilizar este objeto, siga este procedimento:

1. Clique com o boto direito do mouse em uma Tela ou na rea de

trabalho e selecione a opo Inserir - E3Alarm, ou ento clique em
E3Alarm na barra de ferramentas Objetos.

E3Alarm 513
 Inserindo um E3Alarm na Tela

Algumas das propriedades deste objeto podem ser configuradas atravs da

Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso
necessite configurar alguma propriedade, localize-a na Lista de Propriedades
e faa os devidos ajustes.

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

514 E3Alarm
14.1.1 Aba Conexes
A aba Conexes permite configurar uma ou mais conexes a Servidores de
Alarmes locais ou remotos.

Aba Conexes

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Conexes

OPO DESCRIO
Adiciona uma nova Conexo ao
E3Alarm. Esta opo corresponde ao
mtodo Add da Coleo de
Conexes

E3Alarm 515
 OPO DESCRIO

Remove a Conexo selecionada. Esta

opo corresponde ao mtodo
Remove da Coleo de Conexes.
NOTA: A Conexo criada
automaticamente com o E3Alarm no
pode ser removida

Nome conexo Nome desta Conexo. Pressione a

tecla F2 para editar este nome. Esta
opo corresponde propriedade
ConnectionName do objeto
Conexo na Coleo de Conexes

Domnio Nome amigvel para identificar o

Domnio do Servidor de Alarmes
selecionado. Esta opo corresponde
propriedade DomainName do
objeto Conexo na Coleo de
Conexes

Servidor de Alarmes Nome do Servidor de Alarmes, que

tanto pode estar em um Domnio
local quanto em um Domnio
Remoto. Esta opo corresponde
propriedade AlarmServer do objeto
Conexo na Coleo de Conexes.
Clique em para selecionar um
Servidor de Alarmes utilizando o
AppBrowser

Filtro conexo Nome de um Filtro que contm a

configurao do filtro de alarmes,
definido na aba Filtros. Esta opo
corresponde propriedade
FilterConnection do objeto Conexo
na Coleo de Conexes

516 E3Alarm
 possvel acessar um Servidor de Alarmes remoto simplesmente
preenchendo a propriedade AlarmServer do objeto Conexo na Coleo de
Conexes do E3Alarm com os dados do Domnio e do Servidor de Alarmes
remotos, no formato DOMINIO:SERVIDOR, onde SERVIDOR o nome do
Servidor de Alarmes remoto e DOMINIO o nome do Domnio Remoto que
o contm. Para configurar o Domnio Remoto, veja o tpico Domnios
Remotos no captulo sobre Domnios.

14.1.2 Aba Filtros

A aba Filtros permite gerenciar os filtros do E3Alarm.

Aba Filtros

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Filtros

OPO DESCRIO
Filtros Caixa de seleo com os Filtros
atualmente disponveis

E3Alarm 517
 OPO DESCRIO
Configurar Abre a janela de configurao do
Filtro selecionado, descrita a seguir

Adicionar Adiciona um novo Filtro Coleo de

Filtros. Esta opo corresponde ao
mtodo Add da Coleo de Filtros

Remover Remove o Filtro selecionado. Esta

opo corresponde ao mtodo
Remove da Coleo de Filtros.
NOTA: O Filtro criado
automaticamente com o E3Alarm no
pode ser removido

Ao clicar em Configurar, a janela da figura a seguir aberta para

configurao do Filtro selecionado.

518 E3Alarm
 Propriedades do Filtro selecionado

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela de propriedades de um Filtro

OPO DESCRIO
Nome Nome deste Filtro. Esta opo
corresponde propriedade
FilterName

Filtrar por rea de Alarme Determina o filtro por rea de

Alarme. Caso deseje utilizar algum
filtro, especifique-o neste campo,
seno deixe-o em branco. Esta
opo equivale propriedade
AreaFilter

E3Alarm 519
 OPO DESCRIO
Filtro de rea Simples Se a opo Filtrar por rea de
Alarme no estiver em branco, esta
opo habilitada e, se estiver
selecionada, a filtragem por rea
baseada apenas na coincidncia da
parte inicial do nome. Caso contrrio,
considera o nome completo da rea.
Esta opo equivale propriedade
SimpleAreaFilter

Utilizar filtro customizado Permite informar um filtro

personalizado para os alarmes. Esta
opo corresponde propriedade
CustomFilter

Filtrar por tipo Habilita o tipo de filtro que

aplicado no alarme (Apenas
alarmes, Apenas eventos ou
Alarmes e Eventos). Esta opo
equivale propriedade FilterType

Filtrar por severidade Habilita ou desabilita a visualizao

do grau da severidade (Alta, Mdia
ou Baixa). Esta opo equivale s
propriedades ShowHightPriority
(Alta), ShowMediumPriority (Mdia)
e ShowLowPriority (Baixa)

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

Aba Colunas

A lista Campos disponveis mostra todos os campos da Fonte de Alarme.

Clicando em Adicionar, pode-se acrescentar campos individualmente no
E3Alarm. Clicando em Propriedades, possvel configurar as propriedades
do campo do alarme.

E3Alarm 521
 Propriedades da coluna

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Propriedades da coluna

OPO DESCRIO
Largura (pixels) Determina a largura da coluna, em
pixels. A largura padro das colunas
do E3Alarm de 80 pixels

Formatador Determina o formatador utilizado na

coluna do E3Alarm. O formatador
utilizado o padro do E3 (veja o
tpico Formatao de Valores), com
exceo do campo Severidade e dos
campos Condio Ativa, Pede Ack,
Reconhecido e Habilitado, cujos
exemplos de formatao podem ser
vistos nas tabelas a seguir

Renomear para Renomeia o ttulo da coluna

522 E3Alarm
 OPO DESCRIO
Permite reconhecer Permite configurar o reconhecimento
do alarme quando o usurio clicar na
linha da coluna configurada. As
opes disponveis so:

Nunca: O alarme no reconhecido

(padro)

Com clique: O alarme

reconhecido quando o usurio clica
na linha da coluna

Com clique-duplo: O alarme

reconhecido quando o usurio clica
duas vezes na linha da coluna

NOTA: Se o alarme puder ser

reconhecido, o formato do cursor do
mouse muda para , em tempo de
execuo, quando estiver sobre uma
linha de alarme no reconhecido

Esta coluna nunca pisca Habilita ou desabilita o piscar da

coluna

Formatador para o campo Severidade

DADO FORMATADOR SADA FORMATADA

Severidade Alta ;;; Alta

Severidade Mdia "A";"M";"B" M

Severidade Baixa ;;; Baixa

E3Alarm 523
 Formatador para os campos Condio Ativa, Pede Ack, Reconhecido e
Habilitado

DADO FORMATADOR SADA FORMATADA

Verdadeiro "OK";"No OK" OK

Falso "OK";"No OK" No OK

Verdadeiro "AAA" AAA

Falso "AAA" No

Verdadeiro ; Sim

Falso ; No

Para remover algum campo indesejado, selecione-o e clique em Remover.

524 E3Alarm
14.1.4 Aba Ordenao
A aba Ordenao permite configurar a ordenao padro dos alarmes.
Quando mais de um campo de ordenao for usado, os campos
subsequentes permitem a ordenao entre alarmes que tenham o mesmo
valor para o(s) campo(s) anterior(es).

Aba Ordenao

Cada campo da aba Ordenao possui uma propriedade correspondente. As

propriedades disponveis esto descritas na tabela a seguir.

Opes disponveis na aba Ordenao

OPO DESCRIO
Pelo campo Ordena os alarmes conforme o
campo especificado. Este campo
equivale propriedade
PrimarySortField

E3Alarm 525
 OPO DESCRIO
Depois por Ordena os alarmes a partir do item
especificado na opo Pelo campo.
O prximo item ordenado a partir
da especificao indicada nos
campos Depois por. Estes campos
equivalem s propriedades
SecondarySortField, ThirdSortField
e FourthSortField, respectivamente

Ascendente Ordena os campos do alarme de

forma ascendente. Estes campos
equivalem s propriedades
PrimarySortAscending,
SecondarySortAscending,
ThirdSortAscending e
FourthSortAscending em
Verdadeiro, respectivamente

Descendente Ordena os campos do alarme de

forma descendente. Estes campos
equivalem s propriedades
PrimarySortAscending,
SecondarySortAscending,
ThirdSortAscending e
FourthSortAscending em Falso,
respectivamente

NOTAS
A ordenao padro realizada atravs do campo InTime, de maneira
descendente.
Caso a propriedade BannerMode esteja configurada para Verdadeiro, o
alarme mostrado depende da configurao realizada nesta aba.

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

Aba Cores

Clique em para selecionar a cor do tipo de alarme selecionado. A janela

da figura a seguir mostrada.

E3Alarm 527
 Cores do alarme selecionado

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Cores

OPO DESCRIO
Cor de fundo Determina a cor de fundo do alarme

Cor do texto Determina a cor do texto do alarme

No pisca Quando selecionada, o texto do

alarme no pisca

Pisca fundo e texto Quando selecionada, as cores de

texto e fundo alternam entre si

Pisca apenas texto Quando selecionada, a cor do texto

varia entre as cores escolhidas para
o texto e para o fundo

528 E3Alarm
 possvel tambm selecionar as cores por severidade, para cada tipo de
alarme.

Cores do alarme por severidade

Clique em para redefinir as cores apenas para um tipo de severidade, no

tipo de alarme selecionado. A janela da figura a seguir mostrada.

E3Alarm 529
 Cores por severidade

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Cores por severidade

OPO DESCRIO
Redefinir cor de fundo Determina a cor de fundo do alarme
apenas para a severidade
selecionada. Se esta opo no for
marcada, permanece a cor escolhida
na opo Cor de fundo do tipo de
alarme selecionado

Redefinir cor do texto Determina a cor do texto do alarme

apenas para a severidade
selecionada. Se esta opo no for
marcada, permanece a cor escolhida
na opo Cor do texto do tipo de
alarme selecionado

Redefinir pisca Redefine a opo de pisca para o

texto e para o fundo do alarme na
severidade selecionada. Se esta
opo no for marcada, permanece
a opo escolhida no tipo de alarme
selecionado

530 E3Alarm
14.1.6 Aba Fontes
Atravs da aba Fonte possvel configurar a fonte do cabealho e das linhas
do E3Alarm.

Aba Fonte

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

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

E3Alarm 531
14.2 Caractersticas Especficas de Tempo de
Execuo
O E3Alarm possui uma srie de caractersticas que se aplicam apenas em
tempo de execuo (runtime). Estas caractersticas so descritas nos tpicos a
seguir.

NOTA
Todas as opes do E3Alarm em tempo de execuo que esto disponveis
via menu contextual (atravs do clique com o boto direito do mouse)
tambm esto disponveis utilizando a combinao de teclas SHIFT + F10,
que corresponde tecla de aplicao ou de menu .

532 E3Alarm
14.2.1 Visualizando os Alarmes
Em tempo de execuo, os alarmes do sistema podem ser visualizados no
E3Alarm.

E3Alarm em execuo

Dentre os alarmes que satisfazem os filtros configurados, so mostrados no

E3Alarm aqueles que estiverem em condio ativa ou no estiverem
reconhecidos. De maneira geral, estes alarmes podem ser divididos em dois
casos:

Se a opo Pede Ack da Fonte de Alarme estiver em Falso, o alarme

considerado reconhecido desde a sua ativao, sem a necessidade de
reconhecimento. Neste caso, o alarme permanece visvel at que saia da
condio ativa

Se a opo Pede Ack da Fonte de Alarme estiver em Verdadeiro, o

usurio pode reconhecer o alarme antes ou depois da varivel sair da
condio de alarme. Em ambos os casos, o alarme s sai da lista do
E3Alarm quando as duas condies estiverem satisfeitas

A propriedade BannerMode, quando configurada para Verdadeiro, permite

visualizar apenas uma mensagem de alarme no objeto E3Alarm. A mensagem
que mostrada depende da configurao realizada na aba Ordenao.

E3Alarm 533
14.2.2 Reconhecimento de Alarmes
Na configurao padro, ao clicar com o boto direito do mouse no E3Alarm,
mostrado um menu contextual com as opes Reconhecimento e Deletar
alarmes desvinculados. Ao selecionar a primeira opo, mostrada a caixa
de dilogo da figura a seguir.

Opes da janela Reconhecimento de alarmes

As opes disponveis nesta caixa de dilogo esto descritas na tabela a

seguir.

Opes disponveis na caixa de dilogo Reconhecimento de Alarmes

OPO DESCRIO
Reconhece apenas os alarmes Somente os alarmes selecionados
selecionados so reconhecidos

Reconhece todos os alarmes do Todos os alarmes visveis neste

filtro corrente E3Alarm so reconhecidos

Reconhece globalmente todos os Todos os alarmes do Domnio so

alarmes reconhecidos

534 E3Alarm
 A opo Reconhece apenas os alarmes selecionados s est disponvel
se realmente houver alarmes selecionados no E3Alarm. O usurio pode
reconhecer o alarme (neste caso, inserido um novo registro no Banco
de Dados indicando o reconhecimento), e no E3Alarm a linha
correspondente indica que este alarme foi reconhecido. Esta opo est
desabilitada caso a propriedade AllowAckSelected esteja configurada
para Falso

A opo Reconhece todos os alarmes do filtro corrente s est

disponvel se realmente houver alarmes visveis no E3Alarm. possvel
utilizar esta opo sem clicar em nenhum alarme. Para isto, clique em
qualquer rea do E3Alarm para mostrar a janela de Reconhecimento.
Clicando nesta janela, a caixa de dilogo de reconhecimento mostrada.
Esta opo est desabilitada caso a propriedade AllowAckCurrentFilter
esteja configurada para Falso

A opo Reconhece globalmente todos os alarmes est sempre

disponvel, mesmo que no haja alarmes visveis no E3Alarm. Esta opo
est desabilitada caso a propriedade AllowAckAll esteja configurada
para Falso

Ao selecionar a segunda opo, Deletar alarmes desvinculados, mostrada

a caixa de dilogo da figura a seguir.

Opes da janela Alarmes

E3Alarm 535
Para esta opo, o nico item disponvel Globalmente todos os alarmes,
ou seja, todos os alarmes que no estejam vinculados a uma Fonte de Alarme
so removidos. Esta opo do menu contextual do E3Alarm est desabilitada
caso a propriedade AllowDeleteUnboundAlarms esteja configurada para
Falso.

NOTA
Um alarme considerado desvinculado quando est presente no sumrio de
alarmes mas sua Fonte de Alarme foi desativada. Esta desvinculao pode
ocorrer em algumas situaes, como por exemplo:
Mudar o nome da Fonte de Alarme
Utilizar o mtodo Deactivate na Fonte de Alarme em um script
Remover a Fonte de Alarme

O reconhecimento de alarmes tambm pode ser executado atravs de um

clique ou duplo-clique na linha do alarme. Para isto, especifique nas
propriedades da coluna desejada (janela de propriedades do E3Alarm, aba
Colunas, opo Propriedades) como deve ser executado o reconhecimento
do alarme em tempo de execuo, com um ou dois cliques na coluna.

536 E3Alarm
14.2.3 Ordenao de Colunas
Na configurao padro, possvel ordenar os alarmes clicando-se no
cabealho das colunas do E3Alarm. Ao clicar no cabealho da coluna
desejada, o campo associado a esta coluna configurado como o campo
primrio de ordenao. Ao clicar novamente no cabealho da mesma coluna,
o sentido de ordenao primrio (ascendente ou descendente) invertido.

Clicando no cabealho da coluna desejada com a tecla SHIFT pressionada, o

campo associado a esta coluna configurado como campo secundrio de
ordenao. Ao clicar novamente com a tecla SHIFT pressionada no cabealho
desta coluna, o sentido de ordenao secundrio invertido.

A propriedade EnableSortMarker permite mostrar ou esconder a indicao

de ordenao ascendente ou descendente ao clicar no cabealho de
uma coluna.

Para maiores detalhes sobre este comportamento, consulte as propriedades

EnableSortMarker, PrimarySortAscending, PrimarySortField,
SecondarySortAscending, SecondarySortField, ThirdSortAscending,
ThirdSortField, FourthSortAscending, FourthSortField e BannerMode do
E3Alarm no Manual de Referncia e Scripts do E3.

Exemplo de ordenao

Na figura anterior, os alarmes esto ordenados primeiro por DataHora

(Entrada), de forma descendente, e depois por rea, tambm de forma
descendente.

E3Alarm 537
14.2.4 Status das Conexes
A partir da verso 4.7, o E3Alarm permite visualizar o status das conexes
configuradas na aba Conexes. Para habilitar a barra de status, configure a
propriedade ShowConnectionStatusBar do objeto E3Alarm na Lista de
Propriedades. A figura a seguir mostra a barra de status habilitada.

Barra de status de conexes do E3Alarm

As seguintes propriedades do E3Alarm podem ser configuradas para

controlar o comportamento da barra de status:

ShowConnectionStatusBar: Mostra ou esconde a barra de status

ConnectionStatusBarColor: Especifica a cor de fundo da barra de status

PictureConnected: Caminho para um arquivo de imagem com o cone

representando uma conexo com sucesso. O padro do E3Alarm
mostrar o cone

PictureNotConnected: Caminho para um arquivo de imagem com o

cone representando uma conexo em falha. O padro do E3Alarm
mostrar o cone

PictureUnknown: Caminho para um arquivo de imagem com o cone

representando uma conexo indefinida. O padro do E3Alarm mostrar
o cone

538 E3Alarm
NOTA
O status indefinido indica que o E3Alarm no recebeu uma confirmao do
Servidor de Alarmes de que a conexo teve sucesso. Este o status padro
para verses anteriores 4.7.

E3Alarm 539
 CAPTULO
Storage
15
O Storage um mdulo alternativo de gravao dos dados histricos.
Atravs dele possvel transformar dados de produo, processos e outras
coletas em informaes gerenciais. Este mdulo permite que diversas
informaes sejam coletadas atravs de servidores OPC, Drivers da Elipse,
bancos de dados em geral, ou at mesmo arquivos de texto e
armazenamentos em banco de dados comerciais (Microsoft SQL Server e
Oracle) por objetos histricos definidos pelo usurio em uma forma compacta
e eficiente.

O armazenamento das informaes segue a lgica de que um dado s

gravado quando h uma variao significativa, definida pelo usurio. A anlise
das variaes feita pelo algoritmo BoxCar/BackSlope, que permite,
dependendo das bandas mortas configuradas, uma compactao significativa
dos dados com a recuperao total das informaes teis.

A recuperao dos dados no ambiente do E3 pode ser executada atravs de

uma ferramenta de consulta padronizada, que permite montar sua estrutura
de consulta de forma grfica (similar ferramentas como Microsoft Access ou
SQL Server) ou ainda editar diretamente as consultas SQL. Os dados extrados
podem ser visualizados em formato tabular (E3Browser), grficos (E3Chart),
relatrios que permitem visualizao em tela (usando o mtodo PrintPreview
do Relatrio), impresso direta para o papel, ou mesmo exportao para
vrios formatos como Acrobat PDF, HTML, TXT, CSV, TIFF e GIF, entre outros.

A principal funo do Storage permitir a gravao dos dados de forma

compacta. Atravs desta ferramenta possvel recuperar com grande
exatido todas as mudanas nas variveis de processo, ocupando assim o
mnimo de espao no banco de dados. Alguns exemplos so mostrados nos
tpicos a seguir.

Grfico sem compactao

A informao processada contm vrios pontos.

540 Storage
 Grfico sem compactao

Grfico com compactao

Veja que a informao praticamente a mesma, s que com menos pontos.

Grfico com compactao

A gravao no Storage feita da seguinte maneira:

Storage 541
 Aps a definio da tabela nas propriedades do Storage, esta gerada
clicando em Gerar Tabela e os dados so gravados de acordo com estas
definies. Se houver variao de qualidade no Tag, os dados tambm
so gravados

Os dados s no so gravados se a variao ocorreu em um tempo

menor que o mnimo programado (campo MinRecTime)

Para inserir esta ferramenta no E3, siga este procedimento:

1. Clique com o boto direito do mouse no projeto no modo Explorer e

selecione a opo Inserir - Storage. No modo Domnio, clique com o
boto direito do mouse no item Objetos de Servidor - Banco de Dados,
selecione a opo Inserir Storage em e logo aps o nome do projeto
desejado.

Inserindo um Storage no modo Domnio

542 Storage
Caso necessite, configure as propriedades do objeto. Algumas das
propriedades deste objeto podem ser configuradas atravs da Lista de
Propriedades, sem a necessidades de criar scripts para isto. Para maiores
informaes, consulte o Manual de Referncia e Scripts do E3.

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

15.1 Configuraes
Quando o Storage criado na Tela, mostrada uma lista de definies dos
campos de gravao.

Campos configurados para o Storage

Para adicionar um campo, pode-se arrastar e soltar um Tag ou propriedade a

partir do Organizer, ou ento definir o campo e a fonte manualmente.

NOTA
As licenas de Storage so verificadas apenas quando o aplicativo
executado e levam em conta apenas os campos ativos na aplicao, no a
quantidade de campos existentes no banco de dados.

Storage 543
Para efeitos de posterior consulta nos dados, toda a busca se d atravs do
caminho do Tag ou propriedade que est sendo armazenada, definido
atravs do campo Fonte. A propriedade Nome s utilizada caso o campo
Fonte contenha uma expresso (por exemplo, Driver1.Tag1 + Driver1.Tag2).

Logo, se expresses no estiverem sendo utilizadas no campo Fonte, no h

necessidade de se importar com o nome do campo. As opes disponveis
esto descritas na tabela a seguir.

Opes disponveis no Editor do Storage

OPO DESCRIO
Adiciona campos na tabela do
Storage

Remove o campo selecionado da

tabela do Storage

Determina as configuraes da
tabela do Storage

Gera a estrutura no Banco de Dados

Nome Determina o nome do campo da

tabela do Storage

Fonte Determina a fonte de dados que

associada ao campo

Tipo Determina o tipo do campo da

tabela do Storage. Se este valor for
alterado para Bit, Text ou Integer,
as colunas MinRecTime,
MaxRecTime, Varredura, Banda
Morta e Unidade permanecem
desabilitadas

MinRecTime Tempo mnimo para insero de um

dado na tabela. Este tempo
calculado em milissegundos

544 Storage
 OPO DESCRIO
MaxRecTime Tempo mximo de espera por um
dado, em segundos. Ao passar este
tempo, o dado considerado antigo
e armazenado

Varredura Tempo de varredura do campo. Se

este valor for igual a 0 (zero), esta
coluna permanece desabilitada e
mostra o valor definido em
MaxRecTime, em milissegundos

Banda Morta Banda morta para clculo do

algoritmo

Unidade Valor absoluto ou a porcentagem de

modificao

15.1.1 Criando um Storage Vazio

O objeto Storage pode ser criado sem que tenha seus campos configurados.
Para isto, basta que suas propriedades DBServer e TableName sejam
preenchidas na criao. Esta configurao permite que seja criado um Storage
somente para consulta, o que bastante til para acessar dados gerados por
aplicativos externos. Algumas restries se aplicam nesta situao:

Embora o Storage seja ativado normalmente, no gera tabelas nem altera

ndices

A opo Gerar Tabela na janela de Propriedades, a opo Gerar

Estrutura no DB do menu contextual e a opo da barra de
ferramentas do Storage retornam uma mensagem de erro, indicando que
a estrutura do banco de dados no pode ser criada pois no h campos
definidos

O Storage vazio listado normalmente na caixa de seleo Nome do

Servidor de uma Consulta

No h necessidade de licenas de Storage para consultar dados

externos, somente para escrita de dados

Storage 545
15.2 Configurao da Tabela
Pode-se acessar as configuraes da tabela utilizada no Storage de duas
maneiras:

1. Clicando em Propriedades .

2. Clicando com o boto direito do mouse no objeto no Organizer e

selecionando a opo Propriedades.

Aba Storage

Cada campo da aba Storage possui uma propriedade correspondente. As

opes disponveis nesta aba esto descritas na tabela a seguir.

546 Storage
 Opes disponveis na aba Storage

OPO DESCRIO
Servidor de Banco de Dados Define o servidor de Banco de
Dados. Este campo equivale
propriedade DbServer

Nome da tabela Determina o nome da tabela. Este

campo equivale propriedade
TableName

Descartar dados da tabela principal Habilita ou desabilita o descarte de

dados da tabela principal. O dado
considerado antigo de acordo com o
que for definido na opo Descartar
dados mais antigos que. Este
campo equivale propriedade
EnableDiscard

Descartar dados mais antigos que Determina o intervalo de tempo

(minutos, horas, dias ou meses)
durante o qual os dados so
mantidos na tabela principal. Se um
dado da tabela for mais antigo que
o intervalo de tempo desta opo,
ele descartado. Este campo
equivale propriedade
DiscardInterval e o campo de
seleo da unidade de tempo do
intervalo equivale propriedade
DiscardTimeUnit

Realizar o descarte a cada Determina o intervalo (minutos,

horas, dias ou meses) de descarte de
dados antigos da tabela. Este campo
equivale propriedade
VerificationUnit

Storage 547
 OPO DESCRIO
Mover para a tabela de backup os Habilita ou desabilita o
dados descartados armazenamento dos dados
descartados na tabela secundria
(tabela de backup). Este campo
equivale propriedade
EnableBackupTable

Descartar do backup dados mais Determina o intervalo mximo de

antigos que tempo (minutos, horas, dias ou
meses) dos dados na tabela de
backup at serem descartados,
independente do tempo que os
dados permanecem na tabela
principal. Por exemplo, para manter
os dados por 24 meses na tabela
principal e mais seis meses na tabela
de backup, o valor desta opo deve
ser de 30 meses. Este intervalo deve
ser sempre maior que o configurado
no item Descartar dados mais
antigos que da tabela principal. Este
campo equivale propriedade
BackupDiscardInterval e o campo
de seleo da unidade de tempo do
intervalo equivale propriedade
BackupDiscardTimeUnit

Gerar Tabela Gera a estrutura da tabela no Banco

de Dados. Esta opo tambm est
disponvel clicando com o boto
direito do mouse no objeto Storage
no Organizer e selecionando a
opo Gerar Estrutura no BD

548 Storage
Aps definir as configuraes da tabela, clique em Gerar Tabela. Esta ao
cria a estrutura da tabela no banco de dados.

A estrutura de tabelas do Storage semelhante estrutura do Histrico, com

uma tabela de definies, uma tabela principal de dados e uma tabela de
backup (se selecionada pelo usurio). Para que se possa identificar
externamente que uma tabela compactada, verifique se foi criada a tabela
_Fields.

Tabela de campos

Esta tabela possui os campos descritos a seguir.

Campos da tabela _Fields

CAMPO DESCRIO
FieldDeadBand Banda morta

Storage 549
 CAMPO DESCRIO
FieldDeadBandUnit Unidade da banda morta. Em
porcentagem do valor anterior ou
porcentagem dos limites de
engenharia (valor fixo)

FieldDescription Descrio do campo

FieldEU Unidade de Engenharia

FieldHighEng Limite superior do Tag

FieldID ndice do campo cadastrado no

Storage

FieldLowEng Limite inferior do Tag

FieldMaxRecTime Depois que este tempo expira, o

dado deve ser automaticamente
gravado

FieldMinRecTime Valor mnimo de tempo de variao

para armazenar dados

FieldName Nome do campo

FieldQuality Qualidade do campo

FieldScanTimeMs Tempo de varredura que deve ser

utilizado para reconstruir o grfico
do Tag, em milissegundos

FieldSize Tamanho do campo

FieldSource Associao utilizada para obter

valores deste campo

FieldType Tipo do campo

550 Storage
 CAMPO DESCRIO
FieldVARTYPE Tipo de dado nativo do campo (0:
Indefinido, 3: Integer, 5: Double, 8:
Text ou 11: Bit)

Storage 551
A implementao do Storage permite que o usurio no tenha que se
preocupar em como os dados esto armazenados nas tabelas. Entretanto,
para uma melhor compreenso do funcionamento do mdulo, e tambm para
permitir acesso por outros programas, mostrado a seguir o formato das
tabelas.

As opes de gerenciamento de tabelas especificadas no item anterior se

aplicam na verdade a trs conjuntos de tabelas geradas pelo Storage, de
acordo com o campo Nome de Tabela.

Isto porque, para cada tipo de grandeza armazenada, gerado

automaticamente um conjunto de tabelas, a saber: um conjunto para os Tags
analgicos, outro para os textos e mais outro para os digitais. Desta forma,
cada Storage pode gerenciar at sete tabelas, caso se especifique que os trs
tipos de Tags devam ser armazenados:

<NomeTabela>_Fields

<NomeTabela>

<NomeTabela>_Text

<NomeTabela>_Bit

<NomeTabela>_Backup

<NomeTabela>_Text_Backup

<NomeTabela>_Dig_Backup

A tabela _Fields contm a descrio dos campos que so armazenados, que

de forma geral armazenam as mesmas informaes definidas na configurao
dos campos do Storage, alm de associar um ndice automtico para cada
campo. As demais tabelas possuem um formato fixo:

E3TimeStamp: Campo que armazena a data e hora em que houve a

variao do Tag. Caso o protocolo de comunicao suporte o envio de
informao de tempo, este campo contm o timestamp do equipamento

552 Storage
 Qualidade: Contm a informao de qualidade do ponto (Ruim, Incerto
ou Bom) de acordo com a utilizao dentro do E3 e das normas OPC

ndice: Relaciona o campo gravado com o seu respectivo nome que est
armazenado na tabela _Fields

Valor: Valor armazenado. Para a tabela de analgicos trata-se de um

campo tipo Double (nmero real), j para a tabela de digitais trata-se de
um nmero inteiro e para os textos trata-se de um campo NVARCHAR de
tamanho varivel, especificado pelo usurio no campo StringFieldSize

Storage 553
15.2.1 Execuo
Ao iniciar a execuo do aplicativo e receber a primeira notificao de valor
de cada uma das variveis armazenadas, o Storage armazena este valor
obtido com qualidade Ruim, e logo em seguida com a qualidade enviada, se
esta for Boa. Isto porque ao realizar a consulta, o usurio tem a visualizao
de que houve uma interrupo no armazenamento.

Depois, conforme sejam obtidos novos valores para as variveis, um

algoritmo de verificao de gravao interpreta a sequncia e decide se cada
ponto ou no armazenado. Este algoritmo, conhecido como BoxCar/
BackSlope, cria duas bandas de variao (cuja amplitude dada pela banda
morta da varivel) de um ponto gravado. A banda horizontal (BoxCar) define
uma verificao comum da banda morta. Uma segunda banda diagonal
(BackSlope) define uma variao para cima ou para baixo da banda morta.

Portanto, se a varivel est em uma derivativa contnua descendente ou

ascendente, s necessrio armazenar os pontos iniciais ou finais nesta linha
reta. Assim, uma varivel analgica s gravada se o valor viola tanto a
banda horizontal quanto a vertical, ou se houve uma mudana na qualidade,
ou seja, o equipamento foi ligado ou desligado.

Exemplo do algoritmo BoxCar/BackSlope

554 Storage
Esta verificao, entretanto, s ocorre para os campos analgicos. Para os
campos de texto e digitais, basta que haja uma mudana qualquer de valor ou
qualidade, como por exemplo a perda de comunicao, para que sejam
gravados.

Storage 555
15.2.2 Ferramentas de Consultas Internas
A ferramenta Consulta prev algumas facilidades para realizar consultas nos
dados do Storage.

Ao iniciar a configurao de uma Consulta em uma aplicao que possui um

Storage, este objeto entra na lista de Bancos de Dados disponveis para
consulta. Isto porque o Storage atua como um novo provedor de dados,
criando facilidades para o usurio consultar os dados nas tabelas temporais.

Entretanto, nada impede o usurio de realizar as consultas diretamente no

Banco de Dados de origem, de acordo com os formatos das tabelas j
mencionado. A desvantagem neste caso que o processo de consulta mais
complexo.

Portanto, uma vez escolhido o prprio Storage como provedor de dados

para a Consulta, sua interface de configurao apresenta vrias diferenas,
como pode ser visto na figura a seguir. A primeira delas que ao invs de
exibir as tabelas, mostrada uma rvore com todas as variveis que esto
sendo armazenadas. A outra diferena que o usurio pode selecionar uma
entre sete funes para consolidao dos dados, mostradas a seguir:

LastValue: Retorna o ltimo valor armazenado na Base de Dados

ArchivedValue: Retorna um valor armazenado em relao a um

determinado instante de tempo definido na varivel TimeStamp. O tipo de
relao, definido na propriedade FunctionSubType, pode ser Previous
(valor armazenado imediatamente anterior ao timestamp fornecido), Next
(valor armazenado imediatamente posterior ao timestamp), Interpolated
(valor calculado a partir do valor anterior e posterior) e ExactTime (se for
encontrado um valor armazenado no exato instante que foi fornecido
pelo timestamp). As variveis tambm podem ser definidas em tempo de
execuo a partir da chamada do mtodo SetVariableValue da Consulta

556 Storage
 TagAttribute: Devolve um atributo do Tag, definido em
FunctionSubType, que pode ser FieldDescription (significado ou
descrio do Tag), FieldSource (caminho do Tag que est sendo
armazenado), FieldType (tipo de dado: Double, Bit, String ou Integer),
FieldEU (unidade de engenharia), FieldLowEng (limite inferior),
FieldHighEng (limite superior), FieldDeadBand (banda morta para
gravao), FieldDeadBandUnit (unidade da banda morta, se em valores
absolutos ou em porcentagem), FieldMinRecTime (tempo mnimo para
gravao, variaes menores que este intervalo so desprezadas) e
FieldMaxRecTime (tempo mximo para gravao, a ausncia de variao
nestes intervalos fora uma gravao)

CompressedDataNValues: Retorna, para um nico Tag, N valores

definidos na varivel NumVals, armazenados a partir de um instante
inicial, definido na varivel StartTime. As variveis tambm podem ser
definidas em tempo de execuo a partir da chamada do mtodo
SetVariableValue da Consulta

CompressedDataStartEndTime: Retorna, para um nico Tag, os valores

armazenados que esto entre o intervalo definido pelas variveis
StartTime e EndTime. As variveis tambm podem ser definidas em tempo
de execuo a partir da chamada do mtodo SetVariableValue da
Consulta

SampledData: Retorna, para um ou mais Tags, os valores interpolados,

ou seja, estimados entre os instantes definidos pelas variveis StartTime e
EndTime, a intervalos fixos definidos pela varivel TimeInterval. As variveis
tambm podem ser definidas em tempo de execuo a partir da
chamada do mtodo SetVariableValue da Consulta

CalculatedData: Retorna, para um ou mais Tags, o resultado de

operaes matemticas aplicadas aos dados entre os instantes definidos
pelas variveis StartTime e EndTime, a intervalos fixos definidos pela
varivel TimeInterval. Os tipos de clculos so Total, Mnimo, Mximo,
Desvio Padro, Amplitude, Mdia e Mediana. As variveis tambm
podem ser definidas em tempo de execuo a partir da chamada do
mtodo SetVariableValue da Consulta

Storage 557
Para todas as opes possvel indicar se os dados com qualidade Ruim so
includos ou no no resultado, atravs da caixa de seleo Incluir qualidade
RUIM, correspondente propriedade IgnoreQuality da Consulta associada
ao objeto Storage.

Funes da Consulta

558 Storage
15.2.3 Utilizao
Se a funo selecionada possui algum filtro, ento necessrio informar o
valor dos filtros antes de executar a Consulta, seja na prpria caixa de dilogo
de configurao (na aba Visualizar) ou atravs de script, usando o mtodo
SetVariableValue. Exemplo:
Set Chart = Screen.Item("E3Chart1")
Set Query = Chart.Item("Consulta1")
Query.SetVariableValue "StartTime", Chart.DataIni
Query.SetVariableValue "EndTime", Chart.DataFim
Query.SetVariableValue "TimeInterval",
rs.Fields("SampleInterval").Value
Chart.Queries.UpdateData

15.2.4 Ferramentas de Consultas Externas

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

Opes de consultas disponveis

FUNO CONSULTA STORED PROCEDURE

LastValue E3LastValue

ArchivedValue E3Archive, E3ArchiveInterpolate

CompressedDataNValues E3NCompData

CompressedDataStartEndTime E3CompData

SampledData E3SampledData

CalculatedData E3CalculatedData

Storage 559
As Stored Procedures que utilizam parmetros de tipo Data recebem este
parmetro na chamada como um nmero Float (ponto flutuante), ao invs de
DateTime. Isto permite aumentar a preciso do E3, j que ao utilizar o
formato DateTime a preciso mxima de 3ms, ao invs de 1ms com o tipo
Float.

Para facilitar a passagem de parmetros, pode-se adicionar ao Banco de

Dados uma funo do usurio que transforma um valor DateTime em um
Float, conforme o exemplo a seguir.
CREATE FUNCTION E3GETFLOATVALUE (@dDate datetime)
RETURNS FLOAT AS
BEGIN
RETURN CAST(@dDate AS float)
END

Os tpicos a seguir mostram alguns exemplos da utilizao destas funes.

560 Storage
15.2.4.1 E3Archive

Retorna um valor armazenado em relao a um instante, conforme exposto na

funo ArchivedValue. usada somente para os sub-tipos Prev (0), Next (2)
e ExactTime (3). A descrio formal a seguinte:
E3Archive(
@iSubType int,
@strTableName VARCHAR(100),
@dData float,
@strFieldName VARCHAR(100),
@strFilter VARCHAR(500),
@type int,
@bQuality int)

Onde:

@iSubType: Sub-tipo da funo (0: Prvio, 2: Prximo ou 3: Instante

Exato)

@Data: Instante no tempo para a busca, no formato Float

Retorna uma consulta com apenas uma linha, com os campos E3TimeStamp,
Quality e FieldValue. Exemplo de utilizao:
DECLARE @MyDate FLOAT
SET @MyDate = dbo.E3GETFLOATVALUE('10-10-2005 12:00:00')
EXECUTE E3Archive 0, 'STO22', @MyDate,
'Dados.TagDemo1', '', 2, 0

Storage 561
15.2.4.2 E3ArchiveInterpolate

Retorna os pontos imediatamente anteriores e posteriores a um instante,

conforme exposto para a funo ArchivedValue, porm somente para o Sub-
tipo Interpolado. A descrio formal a seguinte:
E3ArchiveInterpolate(
@strTableName VARCHAR(100),
@dData float,
@strFieldName VARCHAR(100),
@strFilter VARCHAR(500),
@type int,
@bQuality int)

Onde:

@dData: Instante no tempo para a busca, no formato Float

Esta consulta retorna duas linhas, com os campos E3TimeStamp e

FieldValue. Exemplo de utilizao:
DECLARE @MyDate FLOAT
SET @MyDate = dbo.E3GETFLOATVALUE('10-10-2005 12:00:00')
EXECUTE E3ArchiveInterpolate 'STO22',
@MyDate, 'Dados.TagDemo1', '', 2, 0

562 Storage
15.2.4.3 E3CalculatedData

Equivale funo CalculatedData. A descrio formal a seguinte:

E3CalculatedData(
@iSubType int,
@strTableName VARCHAR(100),
@iModMin int,
@dStartDate float,
@dEndDate float,
@strFields VARCHAR(1000),
@strWhere VARCHAR(4000),
@type int,
@bQuality int)

Onde:

@iSubType: Sub-tipo do clculo (0: Total, 1: Mnimo, 2: Mximo, 3:

Desvio Padro, 4: Amplitude, 5: Mdia ou 6: Mediana)

Exemplo de utilizao:
DECLARE @MyStartDate FLOAT
SET @MyStartDate = dbo.E3GETFLOATVALUE('10-10-2004 12:00:00')
DECLARE @MyEndDate FLOAT
SET @MyEndDate = dbo.E3GETFLOATVALUE('10-10-2006 12:00:00')
EXECUTE E3CalculatedData 0, 'STOXX', 10,
@MyStartDate, @MyEndDate, 'Dados.TagDemo1', '', 2, 1

Storage 563
15.2.4.4 E3CompData

Equivale funo CompressedDataStartEndTime. A descrio formal a

seguinte:
E3CompData(
@strTableName VARCHAR(100),
@dStartData float,
@dEndData float,
@strFieldName VARCHAR(100),
@strFilter VARCHAR(500),
@strOrder VARCHAR(100),
@type int,
@bQuality int)

Onde:

@dStartData: A data inicial, em formato Float

@dEndData: A data final, em formato Float

@strOrder: Quando desejar que a consulta seja ordenada por outro

campo que no seja o TimeStamp

Esta funo retorna o nmero de linhas encontradas no intervalo, com os

campos E3TimeStamp, Quality e FieldValue. Exemplo de utilizao:
DECLARE @MyStartDate FLOAT
DECLARE @MyEndDate FLOAT
SET @MyStartDate = dbo.E3GETFLOATVALUE('10-10-2005 12:00:00')
SET @MyEndDate = dbo.E3GETFLOATVALUE('10-10-2006 12:00:00')
EXECUTE E3CompData 'STO22', @MyStartDate,
@MyEndDate, 'Dados.TagDemo1', '', '', 2, 0

564 Storage
15.2.4.5 E3LastValue

Retorna o ltimo valor de um determinado Tag que est armazenado no

Banco de Dados. A descrio formal a seguinte:
E3LastValue(
@strTableName VARCHAR(100),
@strFieldName VARCHAR(100),
@strFilter VARCHAR(500),
@type int,
@bQuality int)

Onde:

@strTableName: Nome da tabela

@strFieldName: Nome do campo

@strFilter: Caso queira inserir opes de filtro para o valor

@type: Tipo de dado (0: String, 1: Bit ou Integer ou 2: Analgico)

@bQuality: Se diferente de 0 (zero), somente inclui Tags com qualidade

Boa

Retorna uma consulta com apenas uma linha, com os campos E3TimeStamp,
Quality e FieldValue. Exemplo de utilizao:
EXECUTE E3LastValue 'TabelaXX',
'Tag234', '', 2, 1

Storage 565
15.2.4.6 E3NCompData

Equivale funo CompressedDataNValues. A descrio formal a seguinte:

E3NCompData(
@strTableName VARCHAR(100),
@dData float,
@strFieldName VARCHAR(100),
@iNValues int,
@strFilter VARCHAR(500),
@strOrder VARCHAR(100),
@type int,
@bQuality int)

Onde:

@iNValues: O nmero de valores desejado

@strOrder: Quando desejar que a consulta seja ordenada por outro

campo que no seja o TimeStamp

Esta funo retorna o nmero de linhas solicitado, se encontrado, com os

campos E3TimeStamp, Quality e FieldValue. Exemplo de utilizao:
DECLARE @MyDate FLOAT
SET @MyDate = dbo.E3GETFLOATVALUE('10-10-2005 12:00:00')
EXECUTE E3NCompData 'STO22', @MyDate,
'Dados.TagDemo1', 20, '', '', 2, 0

566 Storage
15.2.4.7 E3SampledData

Equivale funo SampledData. A descrio formal a seguinte:

E3SampledData(
@strTableName VARCHAR(100),
@iModMin int,
@dStartDate float,
@dEndDate float,
@strFields VARCHAR(1000),
@strWhere VARCHAR(4000),
@type int,
@bQuality int)

Onde:

@iModMin: Intervalo em segundos para a interpolao de cada valor

dentro do intervalo

@dStartData: A data inicial, em formato Float

@dEndData: A data final, em formato Float

@strFields: Lista de campos

Exemplo de utilizao:
DECLARE @MyStartDate FLOAT
SET @MyStartDate = dbo.E3GETFLOATVALUE('10-10-2004 12:00:00')
DECLARE @MyEndDate FLOAT
SET @MyEndDate = dbo.E3GETFLOATVALUE('10-10-2006 12:00:00')
EXECUTE E3SampledData 'STOXX', 10, @MyStartDate,
@MyEndDate, 'Dados.TagDemo1', '', 2, 1

Storage 567
 CAPTULO
Histrico
16
Histricos so mdulos responsveis pelo armazenamento de dados da
aplicao em um Banco de Dados. Permitem armazenar dados de processos
para anlises futuras. Pode-se criar tantos arquivos de Histricos quantos se
desejar, cada um contendo diversos Tags ou expresses. Cada Histrico pode
criar ou utilizar uma tabela independente dentro do Banco de Dados, cujo
armazenamento pode ser definido por Tempo ou por Evento. Atravs da
propriedade CacheSize, define-se o nmero de registros enviados por vez
para o Banco de Dados. Conforme a definio da propriedade DBServer,
define-se o Servidor do Banco de Dados que utilizado pelo Histrico. Para
utilizar este recurso, siga estes procedimentos:

1. Clique com o boto direito do mouse no nome do projeto no modo

Explorer e selecione a opo Inserir - Histrico. No modo Domnio,
clique com o boto direito do mouse no item Objetos de Servidor -
Banco de Dados, selecione a opo Inserir Histrico em e logo aps o
nome do projeto desejado.

568 Histrico
 Inserindo um Histrico no modo Domnio

2. Quando o Histrico for habilitado, as seguintes opes de configurao

so mostradas na figura a seguir.

Opes do Histrico

As opes disponveis neste Editor esto descritas na tabela a seguir.

Histrico 569
 Opes disponveis no Editor do Histrico

OPO DESCRIO
Adiciona campos na tabela do
Histrico

Remove o campo selecionado da

tabela do Histrico

Determina as configuraes da
tabela do Histrico

Gera a estrutura no Banco de Dados

Cria uma chave primria

Configura os ndices que so criados

no Histrico

Mantm o Histrico sem vnculos

diretos com a tabela existente

Busca os campos na tabela original

Vincula o Histrico a uma tabela j

existente

570 Histrico
3. Abra a janela de propriedades do Histrico. Para isto, clique com o boto
direito do mouse no objeto e selecione a opo Propriedades. Algumas
das propriedades deste objeto podem ser configuradas atravs da Lista
de Propriedades, sem a necessidade da criao de scripts para isto. Caso
seja necessrio configurar alguma propriedade, localize-a na Lista de
Propriedades e faa os devidos ajustes. Demais informaes sobre as
funcionalidades das propriedades deste objeto podem ser encontradas
no Manual de Referncia e Scripts do E3, no captulo referente ao objeto
Histrico.

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

16.1 Configuraes
Quando um Histrico inserido no projeto, o campo E3TimeStamp criado
automaticamente na tabela. O campo E3TimeStamp mostra a data e hora em
que o valor foi buscado (diferente do timestamp do Tag). Vale lembrar que
este campo utilizado somente para leitura. possvel associar um Tag ao
campo E3TimeStamp. Se no houver Associao, ele busca a hora atual do
sistema para a gravao.

NOTA
O uso da hora atual do sistema para a gravao do campo E3TimeStamp
s est disponvel quando a tabela criada pelo Histrico. No caso de
utilizar uma tabela j existente, necessrio associar um Tag do tipo Demo
com a propriedade Type configurada como 3 - Current Time para que este
campo registre a data e hora corretamente.

Para criar a tabela no Histrico, importante que seus campos sejam

previamente criados clicando-se em Adicionar campo . Para remover algum
campo indesejado, clique em Remover campo . A mensagem de
confirmao da figura a seguir mostrada.

Histrico 571
 Mensagem para confirmar excluso de campo na tabela

O campo Nome define o nome do campo da tabela, o campo Tipo define o

tipo de campo da tabela e a fonte deste campo definida em Fonte.
Tambm possvel definir se este campo ou no a chave primria da
tabela.

572 Histrico
16.1.1 Chave Primria
A Chave Primria um campo ou um conjunto de campos que identifica de
maneira nica cada registro de uma tabela. Assim como o ndice principal
para a tabela, ela utilizada para associar dados entre tabelas. Alguns
exemplos de chaves primrias so cdigos de clientes, CNPJ, nmero de
matricula, etc. Aps a definio de um campo como sendo a chave primria
da tabela, o prprio Banco de Dados garante que no sejam inseridos dados
duplicados neste campo. Por exemplo, se o usurio tentar cadastrar um
pedido com o mesmo nmero de um pedido j existente, o registro no
cadastrado e uma mensagem de erro mostrada. H dois tipos de chave
primria: Simples ou Composta.

Uma Chave primria simples um campo que identifica de modo nico cada
registro de uma tabela. Uma Chave primria composta pode ser formada
pela combinao de dois ou mais campos da tabela. Podem existir casos em
que um nico campo no capaz de atuar como chave primria porque ele
apresenta valores repetidos. Alm disto, uma tabela pode ter somente uma
chave primria, seja ela simples ou composta. Ou seja, no se pode definir
dois ou mais campos de uma tabela para que cada um seja uma chave
primria separada. No confundir com o caso de uma chave primria
composta, onde a unio de dois ou mais campos que forma a nica chave
primria da tabela.

Ao escolher campos para uma Chave Primria, considere os seguintes

detalhes:

No so permitidos valores duplos ou nulos

Caso no exista um identificador nico para uma determinada tabela,

pode-se usar um campo que numere os registros sequencialmente

A chave primria pode ser configurada de duas formas: verificando na tela do

Histrico qual campo da tabela que se pretende tornar chave primria, e
habilitando-o atravs da opo ou clicando no cone , que abre a janela
de configurao, conforme a figura a seguir.

Histrico 573
 Editando um ndice de Chave Primria

Nesta janela, selecione o campo desejado como chave primria. As opes

disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Edio de ndices

OPO DESCRIO
Nome do ndice Determina o nome da chave primria

Garantir que os valores deste Faz com que os valores

ndice sero nicos especificados para o ndice Chave
Primria sejam nicos. Esta opo
est sempre marcada para Chaves
Primrias, no podendo ser
modificada

Nome do campo Mostra o nome do campo

574 Histrico
 OPO DESCRIO
Ordenao Mostra a ordenao do campo
selecionado

Tipo Mostra o tipo do campo da tabela

Mude a ordem dos campos Muda a posio do campo na tabela,

fazendo com que ele suba ou desa

Clicando em OK, confirma-se que o campo determinado uma chave primria

da tabela. Para cancelar a configurao, clique em Cancelar. Pode-se tambm
atribuir um ndice tabela.

Histrico 575
16.1.2 ndices
Um ndice um campo ou conjunto de campos que so previamente
ordenados pelo Banco de Dados, a fim de melhorar a performance das
consultas que utilizam este ndice. Eles so utilizados para encontrar registros
com um valor especfico em uma coluna rapidamente. Sem um ndice, o Banco
de Dados tem de iniciar com o primeiro registro e depois ler atravs de toda
a tabela at que encontre os registros relevantes. Quanto maior a tabela,
maior o custo desta operao. Se a tabela possuir um ndice para as colunas
em questo, o Banco de Dados pode rapidamente obter uma posio para
procurar no meio do arquivo de dados sem ter que varrer todos os registros.
Por exemplo, se uma tabela possui 1.000 registros, isto pelo menos 100
vezes mais rpido do que ler todos os registros sequencialmente. Note que,
se for preciso acessar quase todos os 1.000 registros, mais rpido acess-
los sequencialmente, pois isto evita acessos ao disco.

Os tipos de ndices disponveis so os seguintes: Primrio, nico e Index.

Todos os tipos de colunas da tabela podem ser indexadas. O uso de ndices

nas colunas relevantes a melhor forma de melhorar a performance da
tabela. O nmero mximo de ndices por tabelas e o tamanho mximo de um
ndice definido pelo mecanismo de armazenamento do Servidor de Banco
de Dados.

Pode-se criar ndices em mltiplas colunas. Um ndice de mltiplas colunas

pode ser considerado um vetor ordenado contendo valores que so criados
concatenando-se valores de colunas indexadas.

Os ndices podem ser configurados atravs do cone , que abre a janela de

configurao, conforme a figura a seguir.

576 Histrico
 Janela Editor de ndices

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Editor de ndices

OPO DESCRIO
Nome Mostra o nome do ndice existente

Campos Mostra o campo ao qual o ndice

est associado na tabela

Adicionar Abre uma caixa de dilogo para a

adio de um ndice

Editar Abre uma caixa de dilogo para a

edio do ndice selecionado

Remover Remove o ndice selecionado

Histrico 577
Ao clicar em Adicionar, a caixa de dilogo da figura a seguir mostrada.

Janela Adio de ndices

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Adio de ndices

OPO DESCRIO
Nome do ndice Determina o nome do ndice

Garantir que os valores deste Se habilitada, faz com que os valores

ndice sero nicos especificados para o ndice sejam
nicos

578 Histrico
 OPO DESCRIO
Nome do campo Mostra os nomes dos campos.
Selecione aqueles que devem
pertencer ao ndice

Ordenao Mostra a ordenao do campo

selecionado (Ascendente ou
Descendente)

Tipo Mostra o tipo do campo da tabela

Mude a ordem dos campos Muda a posio do campo na tabela,

fazendo com que ele suba ou desa

Clicando em OK, os ndices na tabela so confirmados. Para cancelar a

configurao, clique em Cancelar.

Histrico 579
16.1.3 Configuraes da Tabela
Depois de definidas as opes descritas anteriormente, necessrio
configurar as informaes da tabela do Histrico e gerar a estrutura no Banco
de Dados. Para isto, clique com o boto direito do mouse no Histrico,
selecione a opo Propriedades e selecione a aba Histrico, conforme a
figura a seguir.

Aba Histrico

Cada campo da aba Histrico possui uma propriedade correspondente. As

opes disponveis nesta aba esto descritas na tabela a seguir.

580 Histrico
 Opes disponveis na aba Histrico

OPO DESCRIO
Servidor de Banco de Dados Define o servidor de Banco de
Dados. Este campo equivale
propriedade DbServer

Nome da tabela Determina o nome da tabela. Este

campo equivale propriedade
TableName

Intervalo entre registros (ms) Determina a variao do intervalo de

tempo em milissegundos, ou seja, de
quanto em quanto tempo os dados
do Histrico so gravados na tabela.
Este campo equivale propriedade
ScanTime

Descartar dados da tabela principal Habilita ou desabilita o descarte dos

dados da tabela principal. O dado
antigo de acordo com o que for
definido na opo Descartar dados
mais antigos que. Este campo
equivale propriedade
EnableDiscard

Descartar dados mais antigos que Determina o intervalo de tempo

(minutos, horas, dias ou meses)
durante o qual os dados so
mantidos na tabela principal. Se um
dado da tabela for mais antigo que
o intervalo de tempo desta opo,
ele descartado. Este campo
equivale propriedade
DiscardInterval e o campo de
seleo da unidade de tempo do
intervalo equivale propriedade
DiscardTimeUnit

Histrico 581
 OPO DESCRIO
Realizar o descarte a cada Determina o intervalo (minutos,
horas, dias ou meses) de descarte de
dados antigos da tabela. Este campo
equivale propriedade
VerificationUnit

Mover para a tabela de backup os Habilita ou desabilita o

dados descartados armazenamento dos dados
descartados na tabela secundria
(tabela de backup). Este campo
equivale propriedade
EnableBackupTable

Descartar do backup dados mais Determina o intervalo mximo de

antigos que tempo (minutos, horas, dias ou
meses) dos dados na tabela de
backup at serem descartados,
independente do tempo que os
dados permanecem na tabela
principal. Por exemplo, para manter
os dados por 24 meses na tabela
principal e mais seis meses na tabela
de backup, o valor desta opo deve
ser de 30 meses. Este intervalo deve
ser sempre maior que o configurado
no item Descartar dados mais
antigos que da tabela principal. Este
campo equivale propriedade
BackupDiscardInterval e o campo
de seleo da unidade de tempo do
intervalo equivale propriedade
BackupDiscardTimeUnit

Gerar Tabela Gera a estrutura da tabela no Banco

de Dados. Esta opo tambm est
disponvel clicando com o boto
direito do mouse no objeto Histrico
no Organizer e selecionando a
opo Gerar Estrutura no BD

582 Histrico
Ao clicar em Gerar Tabela, o Studio mostra a caixa de dilogo da figura a
seguir.

Mensagem do sistema

Quando a opo Gerar Tabela utilizada, a tabela especificada no Histrico

gerada, alm de uma tabela _Fields. Esta tabela possui as informaes de
cada campo cadastrado no Histrico.

Tabela de campos

Os campos disponveis na tabela _Fields do Histrico esto descritos na

tabela a seguir.

Histrico 583
 Campos da tabela _Fields do Histrico

CAMPO DESCRIO
FieldDeadBand Banda morta

FieldDeadBandUnit Unidade utilizada pela banda morta

(em valores absolutos ou em
porcentagem)

FieldDescription Descrio do campo

FieldEU Unidade de engenharia

FieldHighEng Limite superior do Tag

FieldID ndice do campo cadastrado no

Histrico

FieldLowEng Limite inferior do Tag

FieldMaxRecTime Depois que este tempo expira, o

dado deve ser automaticamente
gravado

FieldMinRecTime Valor mnimo de tempo de variao

para armazenamento de um dado

FieldName Nome do campo do Histrico

FieldQuality Tipo da qualidade do campo. As

opes disponveis so 0: Sem
qualidade, 1: Mtodo anterior
verso 1.21 (onde 0: Valor duvidoso
e 1: Valor bom) ou 2: Qualidade
real do Tag

FieldSize Tamanho do campo

FieldSource Associao utilizada pelo campo

para obter os seus valores

584 Histrico
 CAMPO DESCRIO
FieldType Tipo do campo

Histrico 585
A opo Vincular Histrico vincula o Histrico a tabelas existentes no
Banco de Dados. Quando esta opo habilitada, o Studio abre uma caixa de
dilogo para determinar quais as tabelas so vinculadas ao Histrico
corrente, conforme a figura a seguir.

Seleo de tabela para vincular ao

Histrico

Quando a tabela selecionada e clica-se em OK, o Studio mostra a

mensagem da figura a seguir.

586 Histrico
 Mensagem do sistema

Clicando em Cancel, os campos configurados na tabela permanecem com as

configuraes atuais. J clicando em OK, todos os campos, ndices e chaves
primrias definidas no Histrico so substitudos pelos dados da tabela
selecionada.

Quando este item utilizado, outras duas opes so habilitados: Manter

Histrico sem vnculos diretos com tabela existente e Buscar campos
da tabela original .

Quando a opo Manter Histrico sem vnculos diretos com tabela

existente habilitada, o Studio mostra a mensagem da figura a seguir.

Mensagem quanto configurao do Histrico

Clicando em Cancel, a tabela permanece com as configuraes atuais. J

clicando em OK, a tabela reinicializada com seus campos iniciais, onde h
somente o campo padro habilitado (E3TimeStamp).

Histrico 587
Histrico aps habilitar a opo Manter histricos sem vnculo direto com
a tabela existente

J a opo Buscar campos da tabela original recupera os dados do

Histrico vinculado tabela existente, que haviam sido apagados.

Histrico utilizando a opo Buscar campos da tabela original

588 Histrico
 CAPTULO
Consultas
17
O objeto Consulta (ou Query) auxilia no processo de definio de consultas
no Banco de Dados da aplicao. Toda vez que os objetos E3Browser ou
Relatrio buscam dados de um Banco de Dados, necessrio enviar um
comando, de forma que se saiba quais os dados desejados para aquele
objeto. Logo, toda vez que uma aplicao precisar gravar ou buscar dados
armazenados em um Banco de Dados, so enviados comandos no formato
SQL (Structured Query Language). A Consulta apresenta uma interface amigvel,
que permite a construo das consultas em uma forma grfica e o
acompanhamento imediato da sintaxe SQL que est sendo gerada. A consulta
permite mostrar os dados dos ltimos N dias, horas ou meses, data final ou
inicial e consultas.

O Assistente da consulta responsvel por criar o texto que executa o filtro

ou a consulta, no sendo necessrio para o usurio saber detalhes como
data, etc. Para utilizar este recurso, siga estes procedimentos:

1. Clique com o boto direito do mouse em uma Tela do projeto e selecione

a opo Inserir - Standard - Consulta.

NOTA
Quando criado um objeto Relatrio ou E3Browser, o objeto Consulta
adicionado automaticamente a estes objetos. No entanto, tambm pode-se
inserir este objeto em uma Pasta de Dados, em uma Tela, em um Viewer ou
em uma Pasta do Viewer. Para maiores detalhes, veja os captulos
correspondentes.

2. Antes de definir a Consulta, deve-se informar em qual Servidor de Banco

de Dados a Consulta busca os dados. Para tanto, selecione o servidor na
caixa de listagem Nome do Servidor.

Consultas 589
 Definio do Servidor Banco de Dados

A configurao da Consulta depende do objeto ao qual ela est relacionada.

Configuraes da Consulta

Para verificar quais as configuraes necessrias da Consulta, veja os

captulos Relatrios e E3Browser.

590 Consultas
Algumas das propriedades da Consulta podem ser configuradas atravs da
Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso
necessite configurar alguma propriedade, localize-a na Lista de Propriedades
e faa os devidos ajustes. Para maiores informaes, consulte o Manual de
Referncia e Scripts do E3.

Consultas 591
17.1 Criando uma Consulta
Quando um E3Browser ou um Relatrio criado no projeto, uma Consulta
automaticamente inserida como objeto filho, com o nome "Consulta1". Para
utilizar este recurso, siga estes procedimentos:

1. Ao clicar com o boto direito do mouse na Consulta e selecionar o item

Configurar, uma janela mostrada solicitando a identificao do Servidor
de Banco de Dados da aplicao.

Definio do Servidor Banco de Dados na Consulta

2. Aps ser definido o servidor Banco de Dados, uma nova janela aparece
com tabelas que foram encontradas no Banco de Dados, permitindo a sua
seleo.

592 Consultas
 Adio de tabela

3. Selecione as tabelas que fazem parte da consulta e clique em OK.

4. Depois de definidas as tabelas, a janela de definio da Consulta

mostrada, contendo as quatro abas a seguir:

Campos

Variveis

Visualizar

SQL

Consultas 593
 Configurao da Consulta

Estas abas so descritas nos prximos tpicos.

594 Consultas
17.1.1 Aba Campos
Esta aba mostra todos os campos das tabelas usadas na Consulta. Ao clicar
em , possvel selecionar outras tabelas para a Consulta.

Inserindo uma tabela

Para selecionar todos os campos da tabela para que faam parte da Consulta,
selecione o primeiro item da lista de seleo, correspondente ao smbolo *
(asterisco). Para adicionar um campo especfico, selecione sua caixa de
seleo correspondente.

Consultas 595
 Selecionando campos de
uma tabela

Devido questes de performance, importante adicionar Consulta

somente campos que realmente interessam para a anlise.

Na rea de colunas, os campos escolhidos so mostrados.

rea de colunas

Cada coluna mostra propriedades para cada campo da tabela ou tabelas

selecionadas, conforme a tabela a seguir.

Opes disponveis para a configurao de colunas

596 Consultas
 OPO DESCRIO
Colunas Mostra o nome das colunas
selecionadas. Ao clicar na caixa de
combinao de cada linha, pode-se
redefinir a coluna desejada

Ttulo Permite que um novo nome seja

definido para a coluna (tambm
conhecido como alias)

Tabela Mostra o nome da tabela de origem

do campo

Mostrar Habilita ou desabilita o campo

Ordenao Permite ordenar os valores: Sem

ordenao, Ascendente (valores
menores primeiro) ou Descendente
(valores maiores primeiro)

Ordem Define a prioridade quando mais de

um campo possui ordenao

Agrupado por Permite que os dados sejam

agrupados a cada novo valor do
campo

Funo Permite definir a execuo de uma

funo para o campo

Filtro Define um critrio de consulta, como

por exemplo intervalos de data

Consultas 597
Ao definir um filtro, a janela da figura a seguir mostrada, permitindo que se
defina o tipo de comparao e o valor a ser comparado.

Definindo um filtro

O tipo de dado de comparao pode ser definido ao clicar na caixa de

seleo correspondente e selecionar um dos tipos na lista de opes.

598 Consultas
 Configuraes para a definio do filtro

O valor de comparao pode ser uma constante (por exemplo, 123, 45,
"ABCD", etc.) ou uma varivel definida pelo usurio. Para criar uma varivel,
informe um nome qualquer entre os seguintes smbolos:

<% %> se o valor for numrico

'<% %>' se o valor for uma String

#<% %># se o valor for uma data

O valor da varivel pode ser definido na aba Variveis ou atravs do

mtodo SetVariableValue, via script.

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

Aba Variveis

As colunas desta aba so descritas na tabela a seguir.

Opes disponveis na aba Variveis

OPO DESCRIO
Nome O nome da varivel definida pelo
usurio

600 Consultas
 OPO DESCRIO
Valor Uma caixa de seleo onde o valor
do tipo de dados pode ser
selecionado. As opes so Empty,
NULL, Boolean, Char, Byte, Integer,
Word, Long, Dword, Currency,
Single, Double, Date, Decimal e
String

17.1.3 Aba Visualizar

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

Visualizao da Consulta

Consultas 601
17.1.4 Aba SQL
Nesta aba exibida a sintaxe SQL resultante da configurao realizada. Pode-
se editar diretamente a consulta, selecionando a opo Habilita edio direta
do SQL.

Aba SQL

Ao desmarcar a opo Habilita edio direta do SQL, todas as alteraes

so perdidas e a Consulta retorna s opes selecionadas nas abas Campos,
Variveis e Visualizar.

Aviso ao desabilitar a edio direta do SQL

602 Consultas
17.2 Uso dos Filtros da Consulta atravs de
Scripts
Configurar e confirmar se a Consulta est correta apenas um dos passos no
seu uso. O uso em tempo de execuo e as modificaes de valores dos
filtros definidos para a Consulta podem ser vistos no script a seguir. O
mtodo SetVariableValue o responsvel pela configurao da Consulta,
conforme os valores passados via script.
Set consulta = Screen.Item("E3Browser1").Item("Consulta1")
Consulta.SetVariableValue "DataIni", _
Application.GetObject("DadosFH.TagInterno1").Value
Consulta.SetVariableValue "DataFim", _
Application.GetObject("DadosFH.TagInterno2").Value
Screen.Item("E3Browser1").Requery()

O mtodo Requery possibilita que os novos parmetros de Consulta seja

realmente utilizados, visto que uma nova Consulta executada respeitando
estes novos valores.

17.3 Uso de Recordsets de uma Consulta

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

A varivel RS assume todas as caractersticas de um Recordset. A vantagem

do uso deste recurso que se forem feitas modificaes nas propriedades
do banco de dados, no necessrio ajustar cada um dos scripts que
acessam este banco de dados.

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

E3Browser

Para utilizar este recurso, siga estes procedimentos:

1. Insira um E3Browser no projeto clicando com o boto direito do mouse

na rea de trabalho e selecionando o item Inserir - E3Browser.

604 E3Browser
 Inserindo um E3Browser na Tela

2. O E3Browser utiliza o objeto Consulta para auxiliar o usurio no processo

de definio de consultas no Banco de Dados da aplicao. Para maiores
informaes, consulte o captulo referente.

3. Caso necessite, configure as propriedades do E3Browser. Algumas das

propriedades deste objeto podem ser configuradas atravs da Lista de
Propriedades, sem a necessidade de criar scripts para isto. Caso necessite
configurar alguma propriedade, localize-a na Lista de Propriedades e faa
os devidos ajustes. Demais informaes sobre as funcionalidades das
propriedades deste objeto podem ser encontradas no Manual de
Referncia e Scripts do E3, em seu captulo respectivo.

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

Consulta no objeto E3Browser

A Consulta apresenta uma interface amigvel que permite a construo das

consultas de forma grfica e o acompanhamento imediato da sintaxe SQL que
est sendo gerada.

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

A aba Consulta mostra os campos disponveis na consulta. Tais campos

podem ser acessados clicando-se em Configurar, que abre o assistente de
configurao da consulta.

606 E3Browser
 Aba Consulta

Para maiores informaes sobre a Consulta, veja o captulo Consultas.

18.2 Outras Configuraes

As configuraes disponveis no E3Browser so descritas nas sees
seguintes.

E3Browser 607
18.2.1 Aba Estilo
Atravs da aba Estilo pode-se definir a aparncia das divises (grade) das
clulas e dimenses das linhas e colunas.

Aba Estilo

Cada campo da aba Estilo possui uma propriedade correspondente. As

propriedades disponveis esto descritas na tabela a seguir.

Opes disponveis na aba Estilo

OPO DESCRIO
Estilo da grade Determina o estilo da grade do
E3Browser. Este campo equivale
propriedade GridLinesType do
E3Browser

Altura do cabealho Determina a altura, em pixels, do

cabealho do E3Browser. Este campo
equivale propriedade
FixedRowHeight do E3Browser

608 E3Browser
 OPO DESCRIO
Largura da 1 coluna Determina a largura da primeira
coluna na tabela. Este campo
equivale propriedade
FixedColumnWidth do E3Browser

Altura das Linhas Determina a altura das linhas

restantes na tabela. Este campo
equivale propriedade RowHeight
do E3Browser

Largura das Colunas Determina a largura das colunas da

tabela. Este campo equivale
propriedade ColumnWidth do
E3Browser

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

Aba Opes

Cada campo da aba Opes possui uma propriedade correspondente. As

propriedades disponveis esto descritas na tabela a seguir.

Opes disponveis na aba Opes

OPO
Informe o intervalo de tempo em
que os dados sero atualizados
DESCRIO
Determina o intervalo de tempo em
que os dados so atualizados. Este
valor deve ser superior a 1000 ms.
Este campo equivale propriedade
RefreshTime do E3Browser

610 E3Browser
 OPO DESCRIO
Informe qual ser o tipo de seleo Determina o tipo de seleo na
tabela do E3Browser. Este campo
equivale propriedade SelectRow
do E3Browser

18.2.3 Aba Cores

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

Aba Cor

As opes disponveis deste item esto descritas na tabela a seguir.

Opes disponveis da aba Cor

OPO DESCRIO
Propriedades (Properties) Determina a cor conforme a
propriedade selecionada

E3Browser 611
 OPO DESCRIO
Conjunto de Cores (Color Set) Determina o conjunto de cores a ser
utilizado: Cores padro ou Cores do
Windows

Paleta de Cores (Color Palette) Determina a cor da propriedade

selecionada

Editar Cor Personalizada (Edit Edita uma nova cor personalizada,

Custom Color) diferente das cores padro

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

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

Aba Fonte

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

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

E3Browser 613
 CAPTULO
E3Chart
19
O E3Chart um componente ActiveX criado especialmente para trabalhar em
conjunto com o E3. Com ele, possvel exibir grficos mostrando Tags
variando em tempo real, bem como dados histricos gravados em um Banco
de Dados.

O E3Chart composto por vrias colees. Uma coleo (collection) um

objeto especial que gerencia um conjunto de objetos semelhantes. O E3Chart
possui as seguintes colees:

Coleo de Penas: Gerencia o conjunto de Penas criadas para manipular

a sequncia de dados representada no E3Chart

Coleo de Eixos: Gerencia os Eixos do E3Chart, onde podem ser

configuradas diferentes escalas a serem associadas aos dados das Penas

Coleo de Consultas: Gerencia as consultas com informaes sobre as

Penas (por exemplo, no caso de grficos que mostram dados histricos
que j foram gravados em um Banco de Dados)

Coleo de Legendas: Gerencia as colunas da Legenda do E3Chart, onde

so mostradas as informaes sobre as Penas

Para utilizar os recursos do E3Chart, siga estes procedimentos:

1. Insira um E3Chart no projeto clicando com o boto direito do mouse na

Tela e selecionando a opo Inserir - E3Chart.

614 E3Chart
 Inserindo um E3Chart na Tela

2. Caso seja necessrio, configure as propriedades do E3Chart. Algumas das

propriedades deste objeto podem ser configuradas atravs da Lista de
Propriedades, sem a necessidade da criao de scripts para isto. Caso
necessite configurar alguma propriedade, localize-a na Lista de
Propriedades e faa os devidos ajustes. Demais informaes sobre as
funcionalidades das propriedades deste objeto podem ser encontradas
no Manual de Referncia e Scripts do E3, em seu captulo
correspondente.

19.1 Configuraes
Para configurar um E3Chart, clique com o boto direito do mouse no objeto e
selecione a opo Propriedades.

E3Chart 615
19.1.1 Abas Item, Posio e Geral
Atravs da aba Item, possvel visualizar o nome do objeto e atribuir-lhe uma
descrio.

Aba Item

Cada campo da aba Item possui uma propriedade correspondente. As

opes disponveis esto descritas na tabela a seguir.

Opes disponveis na aba Item

OPO DESCRIO
Nome Determina o nome do objeto. Esta
opo equivale propriedade Name
do E3Chart

Documentao Texto livre que possibilita a

documentao das funcionalidades e
caractersticas do objeto pelo
programador. Esta opo equivale
propriedade DocString do E3Chart

616 E3Chart
A aba Posio determina o posicionamento do E3Chart na Tela.

Aba Posio

Cada campo da aba Posio possui uma propriedade correspondente. As

opes disponveis esto descritas na tabela a seguir.

Opes disponveis na aba Posio

OPO DESCRIO
X Define a coordenada horizontal
esquerda do objeto, em unidades
Himetric. Esta opo equivale
propriedade X do E3Chart

Y Define a coordenada vertical

superior do objeto, em unidades
Himetric. Esta opo equivale
propriedade Y do E3Chart

E3Chart 617
 OPO DESCRIO
Largura Determina a largura do objeto. Esta
opo equivale propriedade Width
do E3Chart

Altura Determina a altura do objeto. Esta

opo equivale propriedade
Height do E3Chart

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

Aba Geral

Cada campo da aba Geral possui uma propriedade correspondente. As

opes disponveis esto descritas na tabela a seguir.

Opes disponveis na aba Geral

OPO DESCRIO
Mostrar ttulo Exibe o ttulo do grfico. Esta opo
equivale propriedade Title do
E3Chart

Mostrar ttulo com a cor Determina a cor do texto do ttulo do

grfico. Esta opo equivale
propriedade TitleColor do E3Chart

E3Chart 619
 OPO DESCRIO
Mostrar borda Habilita ou desabilita uma borda
externa no E3Chart, quando a
visualizao das escalas est
desabilitada. Esta opo equivale
propriedade ShowBorder do
E3Chart

Mostrar o fundo do grfico com a Determina a cor de fundo do grfico.

cor Esta opo equivale propriedade
BackColor do E3Chart

Mostrar o fundo da grade com a Determina a cor de fundo da grade

cor do grfico. Esta opo equivale
propriedade GridBackColor do
E3Chart

Intervalo entre as atualizaes Determina o intervalo entre as

(segundos) atualizaes do desenho no grfico.
Esta opo equivale propriedade
RefreshTime do E3Chart

620 E3Chart
19.1.2 Aba Eixos
O objeto Coleo de Eixos representa o conjunto de Eixos contidos no
E3Chart. Os Eixos so escalas colocadas no contorno da grade do E3Chart.

Atravs da aba Eixos possvel adicionar e remover Eixos da Coleo de

Eixos, bem como configurar suas propriedades individualmente.

Aba Eixos

Quando o E3Chart criado, dois Eixos principais so criados

automaticamente: Eixo Horizontal e Eixo Vertical. Estes so os Eixos padro,
e no podem ser removidos. Ao clicar em Adicionar, criado um novo Eixo
no grfico e aberta uma janela de configurao que permite determinar as
propriedades do objeto Eixo. Esta janela possui as abas Geral, Escala e
Referncia Visual, e tambm pode ser aberta ao clicar em Configurar.

A aba Geral contm a informao que identifica a Pena no sistema.

E3Chart 621
 Aba Geral

Cada campo da aba Geral possui uma propriedade ou mtodo

correspondente. As opes disponveis esto descritas na tabela a seguir.

Opes disponveis na aba Geral

622 E3Chart
 OPO DESCRIO
Nome Determina o nome do Eixo do
grfico. Esta opo equivale
propriedade Name do Eixo

Posio Determina a posio do Eixo no

grfico: Direita ou Esquerda (Eixo
vertical), Base ou Topo (Eixo
horizontal). Esta opo equivale
propriedade Position do Eixo

Espelhar o eixo Mostra o Eixo tambm do lado

oposto ao escolhido, com efeito de
espelho. Esta opo equivale
propriedade Mirror do Eixo

Ttulo do eixo Determina o ttulo do Eixo. Esta

opo equivale propriedade Title
do Eixo

Cor da escala Determina a cor da escala. Esta

opo corresponde propriedade
Color do objeto Eixo

Visvel Determina a visibilidade do Eixo no

grfico. Esta opo equivale
propriedade Visible do Eixo

Texto na cor da escala Determina se a cor do texto do Eixo

tem a mesma cor da escala. Esta
opo equivale propriedade
EnableTextColor do Eixo

Cor das linhas da grade Determina a cor das linhas na grade.

Esta opo equivale propriedade
GridColor do Eixo

Estilo da linha Determina o estilo da linha da grade

do grfico. Esta opo equivale
propriedade GridStyle do Eixo

E3Chart 623
 OPO DESCRIO
Mostrar as linhas na grade Habilita a visualizao das linhas na
grade. Esta opo equivale
propriedade ShowGrid do Eixo

Intervalo entre divises Determina o intervalo entre os

marcadores da escala, caso a opo
Automtico esteja desabilitada. Se a
escala no for numrica, possvel
selecionar a unidade de tempo a que
este intervalo se refere. Esta opo
equivale ao mtodo SetTickSpacing
do Eixo

Automtico Seleciona automaticamente o

intervalo entre os marcadores da
escala. Esta opo equivale ao
mtodo SetTickSpacing do Eixo,
com 0 (zero) no valor do intervalo

Nmero de subdivises Determina o nmero de subdivises

entre os marcadores. Esta opo
equivale propriedade MinorTicks
do Eixo

624 E3Chart
Clique em Aplicar para visualizar as modificaes realizadas nesta aba e em
OK para salv-las.

A aba Escala define as configuraes da escala do Eixo.

Aba Escala

Cada campo da aba Escala possui uma propriedade ou um mtodo

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

OPO DESCRIO
Escala numrica Define o Eixo como sendo uma escala
numrica. Esta opo equivale
propriedade ScaleType do Eixo. As
opes de configurao da escala
numrica so as seguintes:

Mnimo: Determina o valor mnimo

da escala numrica. Este campo
equivale ao mtodo SetMinMax do
Eixo

Mximo: Determina o valor mximo

da escala numrica. Este campo
equivale ao mtodo SetMinMax do
Eixo

Mostrar ltimo perodo (tempo Mostra o intervalo de tempo que o

real) Eixo mostra, sempre em relao
hora atual. Esta opo equivale ao
mtodo SetRealTimePeriod do Eixo

Intervalo de tempo (histrico) Determina um intervalo de tempo fixo.

As opes de configurao so as
seguintes:

Do dia: Data e hora iniciais do

intervalo

At o dia: Data e hora finais do

intervalo

Selecionar: Seleciona o intervalo de

tempo

Esta opo corresponde ao mtodo

SetHistoricPeriod do Eixo

Inverter Escala Inverte os valores da escala

selecionada

626 E3Chart
 OPO DESCRIO
Formatao Determina a formatao dos valores
do Eixo, que pode ser Automtica ou
Personalizada. Esta opo
corresponde propriedade Format
do Eixo. Para mais informaes sobre
formatos, consulte o tpico
Formatao de Valores

E3Chart 627
Clique em Aplicar para visualizar as modificaes realizadas nesta aba e em
OK para salv-las.

A aba Referncia Visual define as informaes visuais para as linhas e

bandas de referncia de um Eixo.

Aba Referncia Visual

628 E3Chart
Cada campo da aba Referncia Visual possui uma propriedade
correspondente. As opes disponveis nesta aba esto descritas na tabela a
seguir.

Opes disponveis na aba Referncia Visual

OPO DESCRIO
Valor de referncia Define o valor usado como
referncia para a linha. Este valor se
refere ao eixo x ou y, dependendo se
a escala vertical ou horizontal. Esta
opo corresponde propriedade
ReferenceLineValue

Cor da linha Define a cor da linha de referncia.

Esta opo corresponde
propriedade ReferenceLineColor

Estilo do trao Define o estilo do trao da linha de

referncia. Os valores possveis para
esta opo so Slida, Tracejada,
Pontilhada, Trao-Ponto e Trao-
Ponto-Ponto. Esta opo
corresponde propriedade
ReferenceLineStyle

Espessura da linha Define a espessura da linha de

referncia. Os valores possveis para
esta opo vo de 0 (zero) a 11
pixels. Esta opo corresponde
propriedade ReferenceLineWidth

Visvel Indica se a linha de referncia est

visvel ou no. Esta opo
corresponde propriedade
ReferenceLineVisible

Valor superior Define o valor superior da banda de

referncia. Esta opo corresponde
propriedade NormalBandHighValue

E3Chart 629
 OPO DESCRIO
Valor inferior Define o valor inferior da banda de
referncia. Esta opo corresponde
propriedade NormalBandLowValue

Cor de fundo Define a cor da banda de referncia.

Esta opo corresponde
propriedade NormalBandColor

Visvel Indica se a banda de referncia est

visvel ou no. Esta opo
corresponde propriedade
NormalBandVisible

Clique em Aplicar para visualizar as modificaes realizadas nesta aba e em

OK para salv-las. A figura a seguir mostra uma referncia visual configurada
no Eixo Vertical, com os seguintes valores:

Valor de referncia: 0 (zero)

Cor da linha: Preto (RGB(0, 0, 0))

Estilo do trao: Slido

Espessura da linha: 2 (dois) pixels

Valor superior: 50

Valor inferior: -50

Cor de fundo: Prata (RGB(192, 192, 192))

630 E3Chart
 Exemplo de uso da referncia visual

E3Chart 631
19.1.3 Aba Penas
O objeto Coleo de Penas representa o conjunto de Penas contidas no
E3Chart. Cada Pena configurada para exibir dados em tempo real ou dados
histricos vindos da Consulta.

Atravs da aba Penas possvel adicionar e remover Penas da Coleo de

Penas, bem como configurar suas propriedades principais, individualmente ou
atravs da mltipla seleo de Penas.

Aba Penas

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Penas

632 E3Chart
 OPO DESCRIO
Adicionar Pena Adiciona uma Pena. Mostra um
menu que permite selecionar o tipo
de Pena a ser criada: Tempo Real,
Histrica ou Tempo Real &
Histrica

Excluir Pena Remove as Penas selecionadas

Propriedades Abre a janela de propriedades da

Pena selecionada (esta operao s
permitida se apenas uma Pena
estiver selecionada)

Mover Pena para cima Move a Pena selecionada uma

posio para cima (esta operao
s permitida se apenas uma Pena
estiver selecionada)

Mover Pena para baixo Move a Pena selecionada uma

posio para baixo (esta operao
s permitida se apenas uma Pena
estiver selecionada)

A listagem de Penas do E3Chart permite copiar e colar Penas, tanto no

mesmo E3Chart quanto entre E3Charts diferentes. Clique com o boto direito
do mouse na Pena desejada (ou nas Penas selecionadas, em caso de mltipla
seleo) e selecione a opo Copiar (CTRL + C). No E3Chart de destino, abra
a janela de Propriedades e, na aba Penas, clique com o boto direito do
mouse na listagem de Penas e selecione a opo Colar (CTRL + V). A opo
de Recortar a Pena (CTRL + X) tambm est presente. No caso de o E3Chart
de destino j possuir uma Pena com o mesmo nome da Pena sendo copiada,
o nome automaticamente incrementado.

E3Chart 633
NOTA
Todas as opes das Penas selecionadas que esto disponveis via menu
contextual (atravs do clique com o boto direito do mouse) tambm esto
disponveis utilizando a combinao de teclas SHIFT + F10, que corresponde
tecla de aplicao ou de menu .

Algumas propriedades da Pena podem ser configuradas diretamente na lista

mostrada na aba Penas. Na coluna Estilo, ao clicar em , a janela da figura
a seguir mostrada.

Estilo da Pena

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Estilo da Pena

OPO DESCRIO
Cor principal Define a cor da linha da Pena.
Equivale propriedade Color

634 E3Chart
 OPO DESCRIO
Cor do fundo Define a cor de fundo usada em uma
Pena do tipo rea. Equivale
propriedade BkColor

Tipo de desenho Define o tipo de desenho da Pena:

Linhas, Pontos, Linhas e Pontos ou
rea. Equivale propriedade
PenType

Estilo do trao Define o tipo de linha: Slida,

Tracejada, Pontilhada, Trao-Ponto,
Trao-Ponto-Ponto ou Sem Linha.
Equivale propriedade PenLineStyle

Espessura da linha Define a espessura da linha. Equivale

propriedade Width

Amostra Mostra um exemplo de como a Pena

desenhada no E3Chart

Ao selecionar uma Pena e clicar em , a janela de Propriedades da Pena

mostrada. Esta janela possui cinco abas: Geral, Dados, Estilo, Modo de
Ligao e Estatsticas.

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

E3Chart 635
 Aba Geral

Cada campo da aba Geral possui uma propriedade correspondente. As

opes disponveis esto descritas na tabela a seguir.

Opes disponveis na aba Geral

636 E3Chart
 OPO DESCRIO
Nome da Pena Indica o nome da Pena. Esta opo
equivale propriedade Name da
Pena

Cor principal Determina a cor da linha da Pena.

Esta opo equivale propriedade
Color da Pena

Visvel Indica o estado de visibilidade da

Pena no grfico. Esta opo equivale
propriedade Visible da Pena

Unidade de Engenharia Indica a unidade de engenharia

utilizada pela Pena. Esta opo
equivale propriedade EU da Pena

E3Chart 637
A aba Dados contm informaes de acordo com o tipo da Pena.

Aba Dados

Cada campo da aba Dados possui uma propriedade correspondente. As

opes disponveis esto descritas na tabela a seguir.

Opes disponveis na aba Dados

638 E3Chart
 OPO DESCRIO
Tipo de pena Determina o tipo de Pena sendo
utilizada. Esta opo equivale
propriedade DataSourceType da
Pena

Link do eixo vertical Nome da Associao usada para

plotar o dado em uma escala
vertical. Esta opo equivale
propriedade YLink da Pena

Link do eixo horizontal Nome da Associao usada para

plotar o dado em uma escala
horizontal. Esta opo equivale
propriedade XLink da Pena

Nmero de amostras mantidas na Determina o nmero de amostras

memria nas Penas de tempo real. Esta opo
equivale propriedade BufferSize
da Pena

Usar a estampa de tempo Habilita ou desabilita a estampa de

tempo. A estampa de tempo o
valor de tempo que acompanha o
valor do Tag, indicando o momento
em que este valor foi alterado. Esta
opo equivale propriedade
UseTimeStamp da Pena. Se esta
opo estiver habilitada, a opo
Link do Eixo Horizontal permanece
inativa

Consulta local Determina a Consulta vinculada ao

E3Chart que utilizada nos dados do
Eixo. Esta opo equivale
propriedade QueryName da Pena

Consulta externa Determina a consulta externa, isto ,

os dados vm de uma consulta fora
do objeto E3Chart

E3Chart 639
 OPO DESCRIO
Campo do eixo vertical Nome do campo da Consulta usado
para plotar o dado em uma escala
vertical. Esta opo equivale
propriedade YField da Pena

Campo do eixo horizontal Nome do campo da Consulta usado

para plotar o dado em uma escala
horizontal. Esta opo equivale
propriedade XField da Pena

Usar consulta automtica Indica se a Pena deve ou no usar

consulta automtica. A consulta
automtica no utilizada se o
E3Chart estiver utilizando um cdigo
SQL personalizado, se estiver usando
um Storage ou se possuir vrias
tabelas. Esta opo equivale
propriedade AutoQuery da Pena

Eixo vertical Especifica o Eixo vertical. Esta opo

equivale propriedade ScaleY da
Pena

Eixo horizontal Especifica o Eixo horizontal. Esta

opo equivale propriedade
ScaleX da Pena

640 E3Chart
A aba Estilo determina o estilo da Pena.

Aba Estilo

Cada campo da aba Estilo possui uma propriedade correspondente. As

opes disponveis esto descritas na tabela a seguir.

Opes disponveis na aba Estilo

E3Chart 641
 OPO DESCRIO
Tipo de desenho Indica o tipo de desenho da Pena.
Esta opo equivale propriedade
PenType da Pena

Estilo do trao Determina o estilo do trao da Pena.

Esta opo equivale propriedade
PenLineStyle da Pena

Espessura da linha Determina a espessura da linha, em

pixels. Esta opo equivale
propriedade Width da Pena

Cor do fundo Determina a cor de fundo da linha.

Esta opo equivale propriedade
BkColor da Pena

Documentao Determina a documentao que

pode ser mostrada na Legenda. Esta
opo equivale propriedade
DocString da Pena

Habilita alarme alto Habilita a verificao do alarme alto.

Esta opo corresponde
propriedade EnableHighLimit da
Pena. A caixa de texto ao lado
possibilita estabelecer o limite deste
alarme, que equivale propriedade
HighLimit

Habilita alarme baixo Habilita a verificao do alarme

baixo. Esta opo corresponde
propriedade EnableLowLimit da
Pena. A caixa de texto ao lado
possibilita estabelecer o limite deste
alarme, que equivale propriedade
LowLimit

Cor de alarme Cor da Pena quando em alarme. Esta

opo equivale propriedade
LimitPenColor

642 E3Chart
 OPO DESCRIO
Cor de fundo do alarme Cor do fundo da Pena quando em
alarme. Esta opo equivale
propriedade LimitPenBkColor

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

Modo analgico de ligao entre os pontos

Modo digital de ligao entre os pontos

644 E3Chart
 O modo como a Pena apresentada quando o scan
considerado representado pela cor verde e quando
este campo est desabilitado representado pelas cores
azul e rosa

A aba Modo de Ligao determina o estilo da ligao entre a parte histrica

e a parte de tempo real de uma Pena mista.

E3Chart 645
 Aba Modo de Ligao

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Modo de Ligao

646 E3Chart
 OPO
Modo de ligao entre os pontos
Valor considerado para o scan (ms) Define o tempo de leitura esperado
Mostrar os pontos de qualidade
ruim
Intervalo mximo para ligar os
dados histricos aos de tempo real
(s)
E3Chart
DESCRIO
Define o modo como os pontos
entre a parte histrica e a parte de
tempo real so ligados. Esta opo
equivale propriedade DigitalData.
As opes possveis so Digital,
onde o traado sempre baseado
em retas somente horizontais e
verticais, sugerindo variao
instantnea, ou Analgico, onde o
traado busca uma reta unindo cada
um dos pontos do grfico
do Tag da Pena de tempo real. Se
este valor for igual a 0 (zero), o
E3Chart desenha apenas os pontos
realmente recebidos da fonte (Tag).
Para valores diferentes de 0 (zero), o
E3Chart pode criar pontos virtuais
enquanto o valor no for recebido
da fonte e o tempo de scan for
excedido. Esta opo equivale
propriedade ScanValue da Pena
Define se mostra ou no os pontos
de qualidade ruim. Equivale
propriedade ShowBadPoints da
Pena
Especifica um tempo limite a ser
considerado para a conexo visual
entre a parte histrica e a parte de
tempo real de uma Pena mista.
Corresponde propriedade
MaxGapTime
647
 OPO DESCRIO
Realar linha quando MaxGapTime Reala a linha de ligao entre a
usado parte histrica e a parte de tempo
real. Corresponde propriedade
HighlightMaxGapTime da Pena

Cor da linha usada com Especifica a cor da linha de ligao.

MaxGapTime Corresponde propriedade
MaxGapTimeColor da Pena

Estilo da linha usada com Especifica o estilo da linha de

MaxGapTime ligao. Corresponde propriedade
MaxGapTimeStyle da Pena

A aba Estatsticas habilita o clculo de dados estatsticos.

648 E3Chart
 Aba Estatsticas

Cada campo da aba Estatsticas possui uma propriedade correspondente. As

opes disponveis esto descritas na tabela a seguir.

Opes disponveis na aba Estatsticas

OPO DESCRIO
Calcular dados estatsticos Habilita o clculo de dados
estatsticos

E3Chart 649
 OPO DESCRIO
Mostrar linha da mdia Exibe a linha da mdia dos dados
estatsticos. Ver NOTA a seguir

Mostrar mnimo e mximo Exibe o mnimo e o mximo dos

dados estatsticos

NOTA
A mdia calculada pela opo Mostrar linha da mdia no uma mdia
aritmtica simples, e sim uma mdia aritmtica ponderada em relao ao
intervalo de tempo dos dados estatsticos.

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

Objeto Legenda em tempo de execuo

Atravs da aba Legenda, possvel configurar as informaes referentes ao

objeto Legenda e suas colunas.

E3Chart 651
 Propriedades do objeto Legenda

Alguns campos da aba Legenda possuem uma propriedade ou mtodo

correspondente. As opes disponveis esto descritas na tabela a seguir.

Opes disponveis na aba Legenda

652 E3Chart
 OPO DESCRIO
Fonte Permite configurar o nome, o estilo e
o tamanho da fonte da Legenda.
Clique em para abrir a janela
padro de seleo de fontes do
Windows. Esta opo corresponde
propriedade Font da Legenda

Mostrar Legenda Habilita a visualizao da Legenda. A

caixa de seleo ao lado desta opo
define o posicionamento da Legenda.
Esta opo equivale propriedade
Visible da Legenda, e a opo de
seleo da posio da Legenda
equivale propriedade LegendPos
da Legenda

Tamanho (pixels) Determina o tamanho da Legenda, em

pixels. Pode ser a altura ou a largura,
dependendo da posio. A outra
dimenso acompanha a do E3Chart.
Esta opo corresponde
propriedade Size da Legenda

Cor do fundo Determina a cor de fundo da

Legenda. Esta opo corresponde
propriedade BackColor da Legenda

Estilo da borda Determina o estilo da borda da

Legenda. Esta opo corresponde
propriedade BorderStyle da Legenda

Mostrar texto utilizando Determina a cor do texto da Legenda.

As opes disponveis so A cor da
pena ou A seguinte cor, onde se
pode selecionar uma cor
personalizada. Esta opo
corresponde propriedade
TextColor da Legenda

E3Chart 653
 OPO DESCRIO
Colunas disponveis Lista as colunas disponveis para
visualizao na Legenda

Colunas selecionadas Mostra as colunas selecionadas para

a Legenda

Adicionar Adiciona uma coluna Legenda. Esta

opo equivale ao mtodo
InsertColumn da Legenda

Remover Remove a coluna selecionada da

Legenda. Esta opo equivale ao
mtodo RemoveColumn da Legenda

Propriedades Abre uma caixa de dilogo para a

configurao das propriedades dos
campos das colunas da Legenda

Sobe e Desce Troca a posio da coluna na

Legenda. Estas opes equivalem ao
mtodo ChangeColumnPos da
Legenda

Mostrar ttulos das colunas Habilita o cabealho da Legenda. Esta

opo equivale propriedade
ShowHeader da Legenda

Cor do fundo das colunas Define a cor de fundo das colunas do

cabealho da Legenda. Esta opo
equivale propriedade
HeaderBackColor da Legenda

Cor do texto das colunas Define a cor do texto das colunas do

cabealho da Legenda. Esta opo
equivale propriedade
HeaderTextColor da Legenda

654 E3Chart
 OPO DESCRIO
Estilo da borda das colunas Define o estilo das bordas das
colunas do cabealho da Legenda.
Esta opo equivale propriedade
HeaderBorderStyle da Legenda

Os campos da listagem Colunas disponveis esto descritos na tabela a

seguir.

Opes disponveis para identificao de colunas

1
Este valor pode ser usado diretamente nos mtodos InsertColumn
(parmetro Col), Item e RemoveColumn

OPO VALOR1 NOME DESCRIO

Cor da Pena 6 Color Mostra a cor da
Pena

Descrio da 5 Description Mostra a

Pena descrio contida
na propriedade
DocString da
Pena

DifX 15 DiffX Mostra a

diferena entre os
cursores inicial e
final

DifY 16 DiffY Mostra a

diferena no Eixo
Y entre os pontos
interpolados
inicial e final

EscalaX 8 ScaleX Mostra o nome

do Eixo X
associado Pena

E3Chart 655
 OPO VALOR1 NOME DESCRIO
EscalaY 9 ScaleY Mostra o nome
do Eixo Y
associado Pena

EscalaYMx 20 ScaleYMax Mostra o valor

mximo da escala
vertical

EscalaYMn 21 ScaleYMin Mostra o valor

mnimo da escala
vertical

Estado 7 Status Mostra o estado

de funcionamento
atual da Pena

FimX 14 XEnd Mostra a posio

final do cursor

FimY 18 YEnd Mostra o ponto

interpolado onde
o cursor final
cruza com a Pena

IncioX 13 XBegin Mostra a posio

inicial do cursor

IncioY 17 YBegin Mostra o ponto

interpolado onde
o cursor inicial
cruza com a Pena

MximoY 12 MaxY Mostra o valor

mximo da Pena
no intervalo

MdiaY 10 AverageY Mostra o valor

mdio da Pena no
intervalo

656 E3Chart
 OPO VALOR1 NOME DESCRIO
MnimoY 11 MinY Mostra o valor
mnimo da Pena
no intervalo

Nome da pena 0 Name Mostra o nome

da Pena

Nome do tag X 1 TagX Mostra o nome

do Tag associado
ao Eixo X

Nome do tag Y 2 TagY Mostra o nome

do Tag associado
ao Eixo Y

Unidade 19 EU Mostra a unidade

de engenharia
utilizada pela Pena

Valor do tag X 3 TagXValue Mostra o valor da

pesquisa no Eixo
X

Valor do tag Y 4 TagYValue Mostra o valor da

pesquisa no Eixo
Y

E3Chart 657
Ao clicar em Propriedades, mostrada uma caixa de dilogo para
configurao do objeto Coluna da Legenda.

Propriedades da coluna

Cada campo da caixa de dilogo Propriedades da coluna possui uma

propriedade correspondente. As opes disponveis esto descritas na tabela
a seguir.

Opes disponveis na janela Propriedades da coluna

OPO DESCRIO
Largura inicial Define a largura inicial da Coluna, em
pixels. Esta opo equivale
propriedade Width da Coluna da
Legenda

Ttulo da coluna Determina o ttulo da Coluna. Esta

opo equivale propriedade
Caption da Coluna da Legenda

Alinhamento do texto Determina o alinhamento do texto na

Coluna da Legenda. Esta opo
equivale propriedade TextAlign da
Coluna da Legenda

658 E3Chart
 OPO DESCRIO
Formatador Determina o formatador da Coluna
selecionada. Esta opo equivale
propriedade Format da Coluna da
Legenda

19.1.5 Aba Consultas

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

Aba Consultas

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Consultas

OPO DESCRIO
Consultas Mostra a Consulta selecionada para
edio

E3Chart 659
 OPO DESCRIO
Configurar Configura a Consulta selecionada

Adicionar Adiciona uma nova Consulta. Para

obter maiores informaes
referentes s Consultas, veja o
captulo Consultas

Remover Remove a Consulta selecionada

NOTA
Ao clicar em Adicionar ou Configurar, uma caixa de dilogo aberta para
especificao do Servidor de Banco de Dados que guarda a Consulta. Os
procedimentos de definio da Consulta podem ser encontrados no
captulo Consultas.

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

Aba Fonte

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

NOTA
O nome da aba aparece sempre no idioma do Windows.

19.2 Exemplos de Utilizao

Os tpicos a seguir mostram alguns exemplos de utilizao do E3Chart.

E3Chart 661
19.2.1 Habilitando e Desabilitando Penas
O exemplo a seguir demonstra como habilitar ou desabilitar a conexo dos
dados de uma Pena no E3Chart. Para tanto, siga estes procedimentos:

1. Crie um E3Chart na Tela.

2. Abra a janela de propriedades do E3Chart e selecione a aba Penas. Crie

uma nova Pena de tempo real e associe-a a um Tag Demo no Eixo
vertical.

3. Crie dois botes de comando na Tela. No primeiro boto de comando,

escreva na propriedade Caption a descrio "Desabilitar Pena".

4. Abra a janela de propriedades deste boto e selecione a aba Scripts. No

evento Click, escreva o script a seguir.
Sub CommandButton1_Click()
Set Pen1= Screen.Item("E3Chart1").Pens.Item("Pena1")
Pen1.Disconnect()
End Sub

5. No segundo boto de comando, escreva na propriedade Caption a

descrio "Habilitar Pena".

6. Abra a janela de propriedades deste boto e selecione a aba Scripts. No

evento Click, escreva o script a seguir.
Sub CommandButton2_Click()
Set Pen1= Screen.Item("E3Chart1").Pens.Item("Pena1")
Pen1.Connect()
End Sub

7. Execute o projeto e verifique o resultado.

662 E3Chart
19.2.2 Atualizando o E3Chart Histrico com os Dados
da ltima Hora
O exemplo a seguir demonstra como atualizar o E3Chart com os dados
histricos da ltima hora. Para este exemplo, necessrio que haja uma
Consulta a uma tabela do Banco de Dados previamente criada.

1. Crie um E3Chart na Tela.

2. Abra a janela de propriedades do E3Chart e selecione a aba Eixos. Clique

na opo Configurar do Eixo horizontal e, na aba Escala, selecione a
opo Intervalo de tempo (Histrico).

3. Selecione a aba Consultas e clique em Adicionar. O Studio mostra uma

caixa de dilogo para que se indique o nome do servidor de Banco de
Dados em que a tabela da consulta est armazenada.

4. Selecione o servidor de Banco de Dados na caixa de dilogo e clique em

OK. O Studio abre a janela de configuraes da Consulta.

5. Selecione na tabela histrica o campo E3TimeStamp e algum outro

campo de dados para mostrar no grfico.

6. No campo E3TimeStamp, crie um filtro conforme as especificaes a

seguir.

E3Chart 663
 Filtro a ser criado no campo E3TimeStamp

7. Aps ter criado o filtro conforme as especificaes anteriores, clique em

OK.

8. Crie uma nova Pena. Abra a janela de propriedades desta Pena e, na aba
Dados, item Tipo de Pena, selecione a opo Histrica usando a
Consulta e indique o campo da Consulta configurada.

9. No item Campo do eixo vertical, indique um campo da tabela. No item

Campo do eixo horizontal, indique o campo E3TimeStamp. Clique em
OK.

10. Crie um novo boto na Tela e, na propriedade Caption, escreva "Atualizar

E3Chart Histrico".

11. Selecione a aba Scripts deste boto e, no evento Click, escreva o script a
seguir.
Sub CommandButton3_Click()
Set Chart = Screen.Item("E3Chart1")
Set Consulta = Chart.Item("Consulta1")
Consulta.SetVariableValue "Ini", Now 1 / 24
Consulta.SetVariableValue "Fim", Now
Chart.HorScaleBegin = Now 1 / 24
Chart.HorScaleEnd = Now
Chart.Queries.UpdateData()
End Sub

664 E3Chart
12. Execute o projeto e verifique o resultado.

19.2.3 Habilitando ou Desabilitando a Visualizao da

Pena
O exemplo a seguir demonstra como habilitar ou desabilitar a visualizao de
uma Pena no E3Chart. Para tanto, siga estes procedimentos:

1. Crie um E3Chart na Tela.

2. Abra a janela de propriedades do E3Chart e selecione a aba Penas. Crie

uma nova Pena de tempo real e associe-a a um Tag Demo, no Eixo
vertical.

3. Crie dois botes na Tela. No primeiro, mude a propriedade Caption para

"Desabilitar Visualizao da Pena".

4. Abra a janela de propriedades deste boto e selecione a aba Scripts. No

evento Click, escreva o script a seguir.
Sub CommandButton1_Click()
Set Pen1= Screen.Item("E3Chart1").Pens.Item("Pena1")
Pen1.Visible = False
End Sub

5. No segundo boto de comando, mude a propriedade Caption para

"Habilitar Visualizao da Pena".

6. Abra a janela de propriedades deste boto e selecione a aba Scripts. No

evento Click, escreva o script a seguir.
Sub CommandButton2_Click()
Set Pen1 = Screen.Item("E3Chart1").Pens.Item("Pena1")
Pen1.Visible = True
End Sub

7. Execute o projeto e verifique o resultado.

E3Chart 665
19.2.4 Criao de uma Pena por Script
O exemplo a seguir demonstra como criar uma Pena por script. Para tanto,
siga estes procedimentos:

1. Crie um E3Chart na Tela.

2. Crie um boto de comando na Tela. Na propriedade Caption, digite o

texto "Criar Pena".

3. Abra a janela de propriedades deste boto de comando e selecione a

aba Scripts. Digite o script a seguir no evento Click.
Sub Texto1_Click()
Set E3Chart1 = Screen.Item("E3Chart1")
MsgBox "Clique em OK para criar a Pena"
Set Pen = E3Chart1.Pens.AddPen("Pen1")
Pen.DataSourceType = 0 ' Tempo real
Pen.VerDataSource = "Dados.TagDemo1"
Pen.UseTimeStamp = True ' No X usa o timestamp
Pen.Color = RGB(255, 0, 0)
Pen.DocString = "teste"
MsgBox "Clique em OK para conectar"
Pen.Connect() ' Comea a receber os dados
MsgBox "Clique em OK para enquadrar"
E3Chart1.FitPen(0)
MsgBox "Clique em OK para desconectar"
Pen.Disconnect() ' Para de receber os dados
MsgBox "Clique em OK para remover a Pena"
E3Chart1.Pens.Remove(Pen.Name)
End Sub

4. Execute o projeto e verifique o resultado.

19.3 Caractersticas Especficas de Runtime

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

19.3.1 Opes do Ponteiro do Mouse

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

666 E3Chart
19.3.2 Opes do Menu Contextual
Clicando com o boto direito do mouse no grfico do E3Chart, abre-se o
menu de opes mostrado na figura a seguir.

Opes do menu do E3Chart em

tempo de execuo

As opes disponveis esto descritas na tabela a seguir.

Opes disponveis do menu contextual do E3Chart em tempo de

execuo

OPO DESCRIO
Caixa de zoom Coloca o ponteiro do mouse no
modo zoom por rea selecionada.
Esta opo est disponvel nos
grficos de escala numrica em XY e
escala fixa

Mover Coloca o ponteiro do mouse em

modo de movimentao das escalas

E3Chart 667
 OPO DESCRIO
Mover horizontalmente Coloca o ponteiro do mouse em
modo de movimentao das escalas
somente na direo horizontal

Pesquisar Coloca o ponteiro do mouse em

modo de pesquisa de valores nos
dados das Penas

Pesquisar Intervalos Habilita a opo de pesquisa de

intervalos de tempo

Menos Zoom Diminui o zoom de todo o Eixo

Mais Zoom Aumenta o zoom de todo o Eixo

Enquadrar tudo Enquadra a Pena selecionada em

ambos os Eixos

Enquadrar verticalmente Enquadra a Pena selecionada

somente no Eixo vertical

Enquadrar horizontalmente Enquadra a Pena selecionada

somente no Eixo horizontal

Enquadrar Pena Enquadra a Pena selecionada ou

todas as Penas existentes

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

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

NOTA
Para obter maiores informaes sobre as colunas Valor do Tag X e Valor
do Tag Y, veja o tpico sobre as configuraes da Aba Legenda.

E3Chart 669
19.3.4 Opo Pesquisar Intervalos
Neste modo so mostrados dois cursores, que definem o intervalo de
clculos estatsticos. Os valores dos cursores so mostrados nas colunas
IncioX, IncioY, FimX e FimY. Para alterar a posio de um cursor, selecione-
o clicando com o boto esquerdo do mouse e arraste-o para a posio
desejada.

Pesquisa de intervalos

670 E3Chart
19.3.5 Coluna Estado da Legenda
A coluna Estado da legenda mostra o estado atual de cada Pena. O contedo
desta mensagem composto por uma informao de erro, se houver, e
informaes sobre a situao atual da Pena, como por exemplo o nmero de
pontos. As tabelas a seguir mostram as possveis mensagens de erro e de
informao para Penas de Tempo Real e Histricas. Se a Pena do tipo
Mista, a mensagem final uma combinao da mensagem da parte de
Tempo Real e Histrica. Caso haja mensagens de erro, a linha da coluna
mostrada em vermelho enquanto o erro persistir.

Mensagens de status da parte de tempo real

MENSAGEM
Erro: Parte de tempo real
desconectada (YLink='Nome do
Tag') (XLink='Nome do Tag')
SIGNIFICADO
No houve conexo da parte de
tempo real da Pena. Verifique o
nome dos Tags nas propriedades
YLink e XLink da Pena

Info: Tempo real n pts Mostra o nmero total de pontos da

parte de tempo real

Mensagens de status da parte histrica

MENSAGEM SIGNIFICADO
Info: Consulta aguardando Aguardando a inicializao da
consulta. Significa que alguma
mudana ou pedido de atualizao
da consulta foi detectado

Info: Consulta inicializando A consulta est iniciando. Nesta fase

so validados os campos informados
na Pena

E3Chart 671
 MENSAGEM SIGNIFICADO
Erro: Consulta: Falha na Antes de carregar os dados da
inicializao consulta, o E3Chart precisa conhecer
os campos que a consulta contm
para realizar a associao entre
estes campos e as propriedades
XField e YField. Ocorreu uma falha
ao buscar estes campos, que pode
ser tanto um erro de rede quanto um
erro de sintaxe SQL

Erro: Campo no encontrado O campo informado na propriedade

(XField = 'Nome do Campo') XField no foi encontrado na
consulta. Verifique se o campo est
selecionado na tela de edio da
consulta ou no cdigo SQL

Erro: Campo no encontrado O campo informado na propriedade

(YField = 'Nome do Campo') YField no foi encontrado na
consulta. Verifique se o campo est
selecionado na tela de edio da
consulta ou no cdigo SQL

Erro: 'Nome da Consulta' Indica que houve um erro na

'Mensagem de Erro' consulta, no sendo possvel
recuperar os dados. As possveis
mensagens mostradas em Mensagem
de Erro so descritas na tabela a
seguir

Info: n pts Mostra o nmero total de pontos da

parte histrica

Info: Carregando Indica que os dados da consulta

ainda esto sendo carregados do
servidor

Erro: Consulta invlida A consulta indicada pela

(QueryName = 'Nome da propriedade QueryName da Pena
Consulta') no foi encontrada pelo E3Chart

672 E3Chart
 Mensagens especficas para falha na consulta

MENSAGEM SIGNIFICADO
Falha ao inserir dados No foi possvel carregar os dados
para a memria

Falha na criao da consulta No foi possvel criar a consulta

Erro ao executar a consulta No foi possvel executar a consulta

Falha ao baixar os dados do No foi possvel trazer do servidor

servidor os resultados da consulta

Falha ao pegar o nmero de No foi possvel trazer do servidor o

registros do servidor total de registros existentes na
consulta

Falha ao posicionar o cursor para o No foi possvel posicionar o cursor

incio no primeiro registro da consulta

Cursor ocupado Os registros da consulta no esto

disponveis para serem trazidos do
servidor

Falha ao pegar os dados do No foi possvel trazer do servidor

servidor os registros da consulta

Erro desconhecido Houve um erro inesperado ao tentar

trazer do servidor os dados da
consulta

E3Chart 673
 CAPTULO
E3Playback
20
Uma ferramenta de playback visa facilitar o ps-operao, sobretudo a anlise
de ocorrncias. Sua necessidade justificada por permitir que o usurio
visualize, atravs das telas de monitoramento em tempo real, as variaes de
eventos e pontos analgicos em tempo passado que, em determinados
casos, pode ser complicado observando apenas relatrios de eventos e
valores analgicos.

Cabe ressaltar que um playback uma ferramenta que permite a um operador

experiente e conhecedor do processo interpretar os acontecimentos de forma
mais clara. No faz parte do escopo de um playback a identificao
automtica de soluo ou de causa de uma ocorrncia.

Um exemplo prtico de uso de um playback pode ser o seguinte:

O usurio, ao chegar em seu horrio de trabalho, recebe a informao de uma

grave ocorrncia acontecida durante a madrugada, por volta das 3h15min. Ele
pode ento abrir na ferramenta de playback uma tela que contm o ponto
gerador do evento e outros pontos relacionados, movendo o relgio para as
03h10min e clicando em Play. Ao observar a tela sendo animada com os dados
histricos, o usurio facilmente acompanha o estado geral do processo,
avanando e retrocedendo livremente no tempo at compreender perfeitamente a
causa da ocorrncia.

20.1 Objeto E3Playback

O E3Playback, a ferramenta de playback da Elipse, um ActiveX que executa
dentro do E3 Viewer ou do E3 WebViewer e que permite visualizar as Telas do
aplicativo utilizando dados histricos armazenados em bancos de dados.

O E3Playback busca no banco de dados os Tags referenciados nas Telas, bem

como os demais links entre Viewer e servidor (tais como os Tags do Viewer
com links para objetos do servidor), e mostra valores, animaes, estados e
grficos de acordo com as informaes existentes no banco de dados e o
perodo de playback definido.

674 E3Playback
20.2 Adicionar Playback ao Demo do E3
Este exemplo mostra como adicionar funcionalidades de playback ao
aplicativo de demonstrao que vem junto com a instalao do E3.

1. Crie uma nova Tela, chamada "TelaPlayback", e insira um ActiveX

E3Playback ocupando toda a rea de fundo da Tela.

Incluso do E3Playback em uma Tela

2. Abra a Lista de Propriedades e configure a propriedade DBServer do

E3Playback para apontar para o objeto Banco de Dados que contm os
dados histricos do aplicativo.

E3Playback 675
 Selecionando um Banco de Dados

3. Abra a Lista de Propriedades e configure a propriedade InitialScreen do

E3Playback para apontar para o Quadro "FrameApp".

Selecionando um Quadro para a propriedade InitialScreen

4. Abra a Tela "UpperMenu" e insira a imagem Stopwatch no canto superior

direito (abra a Galeria e selecione a categoria Misc Symbols 1).

Tela UpperMenu

676 E3Playback
5. Clique duas vezes na imagem Stopwatch, adicione o Pick Abrir Tela no
evento Click para abrir a "TelaPlayback" no Quadro principal e configure-
o conforme as figuras a seguir.

Pick Abrir Tela

E3Playback 677
 Configuraes do estilo da janela

6. Execute o aplicativo, abra o Viewer, clique em Portugus, depois em

Preview de Aplicaes, e finalmente clique no cone Stopwatch. Neste
momento deve aparecer a Tela de playback.

678 E3Playback
 Tela de playback

7. Clique em para entrar no modo Online. Os primeiros dados de

playback so carregados, e o relgio de playback posicionado no centro
dos dados disponveis.

E3Playback 679
 Tela de playback em modo Online

20.3 Interface de Usurio

A interface de usurio do E3Playback dividida em seis partes:

Barra de Ferramentas

Linha de Tempo

Marcadores

rea de Telas

Lista de Eventos

Lista de Tags

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

Barra de ferramentas Playback

Esta barra de ferramentas possui as opes descritas na tabela a seguir.

Opes disponveis na barra de ferramentas Playback

CONE COMANDO AO
Reproduzir para Inicia a reproduo
trs dos dados no
horrio atual de
playback,
retrocedendo o
relgio de acordo
com a velocidade de
reproduo atual

Pausa Congela o relgio

de playback no
tempo atual

Reproduzir Inicia a reproduo

dos dados no
horrio atual de
playback, avanando
o relgio de acordo
com a velocidade de
reproduo atual

E3Playback 681
 CONE COMANDO AO
Parar Interrompe o
playback, os dados
de Tags e alarmes
so removidos das
Telas e nenhuma
nova consulta feita
ao banco de dados

Mais devagar Diminui a velocidade

de playback pela
metade. O valor
mnimo 1/1024x,
isto , avana
aproximadamente
um milissegundo de
dados a cada
segundo

Velocidade normal Deixa a velocidade

de playback no valor
normal (1x)

Mais rpido Dobra a velocidade

de playback. O valor
mximo de 1024x,
isto , a cada
segundo o relgio
de playback avana
1024 segundos
(aproximadamente
17 minutos)

Seletor de Permite selecionar a

velocidade velocidade de
playback

682 E3Playback
 CONE COMANDO AO
Data e hora atual Mostra a data e
hora atual do
relgio de playback,
e permite selecionar
uma nova data

Mostrar ou Mostra ou oculta a

esconder a Linha janela Linha de
de Tempo Tempo do
E3Playback

Mostrar ou Mostra ou oculta a

esconder a Lista de janela Tags do
Tags E3Playback

Mostrar ou Mostra ou oculta a

esconder a Lista de janela Eventos do
Eventos E3Playback

Iniciar ou parar a Permite gerar um

gravao de vdeo vdeo (em formato
AVI) capturando
toda a rea do
ActiveX de playback
durante um
determinado
perodo, ou at que
o usurio mande
parar a gravao

Capturar a tela do Permite capturar a

E3Playback rea de Tela do
ActiveX de playback.
A Tela capturada
pode ser salva em
um arquivo BMP ou
copiada para a rea
de Transferncia

E3Playback 683
Ao selecionar a ferramenta Gravao de Vdeo , a seguinte janela de
configuraes mostrada.

Janela Opes de gravao

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Opes de gravao

OPO DESCRIO
Salvar vdeo como Mostra o local e o nome do arquivo
de vdeo a ser salvo. Pode-se clicar
em para navegar pelas pastas do
computador

684 E3Playback
 OPO DESCRIO
Tempo mximo de gravao Permite definir um tempo total para
gravao. Se o valor estiver em
Indefinido, a gravao apenas para
se o boto de gravao de vdeo do
E3Playback for pressionado. A opo
Tempo permite que seja pr-definido
um tempo mximo de gravao, em
segundos (neste caso a gravao
encerrada automaticamente ao final
do tempo estipulado)

Quadros por segundo Configura o nmero de quadros

(frames) capturados a cada segundo
de gravao

Mostrar cursor na gravao Quando esta opo estiver habilitada,

o cursor do mouse aparece no vdeo
gravado. O padro desta opo
desabilitada. O ponteiro do mouse
gravado no vdeo o que estiver
configurado como padro do
Windows. Ponteiros com animao
no so animados no vdeo. Neste
caso, mostrado sempre o primeiro
quadro da animao

Compressor Compressor de vdeo utilizado na

gravao. So listados todos os
compressores que esto instalados
no computador, desde que sejam
suportados pelo E3Playback

Qualidade de compresso Configura a taxa de compresso, que

afeta a qualidade final do vdeo e,
consequentemente, o tamanho do
arquivo gerado

Intervalo de quadros a cada Configura a quantidade de quadros a

quadro-chave cada quadro-chave (key frame)

E3Playback 685
 OPO DESCRIO
Configurar (compresso de vdeo) Abre uma nova janela que possui
configuraes especficas do
compressor selecionado

Sobre Abre uma nova janela que possui

informaes sobre o compressor
selecionado

Gravar udio Habilita a gravao de udio. O

padro desta opo desabilitada

Dispositivo Lista os dispositivos de udio

instalados e habilitados no sistema, e
que podem ser utilizados na captura
de udio

Formato Mostra informaes sobre o formato

de udio atualmente selecionado

Atributos Mostra informaes sobre os

atributos do formato de udio
atualmente selecionado

Configurar (gravao de udio) Mostra uma janela que permite alterar

o formato de gravao e os atributos
do udio

Mostrar resumo ao concluir Habilita ou desabilita a janela que

gravao mostrada no momento em que a
gravao finalizada

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

Linha de tempo

As opes deste componente esto descritas na tabela a seguir.

Opes disponveis na Linha de Tempo

OPO DESCRIO
Rgua Mostra a linha de tempo. Pode-se
mover a linha de tempo para os lados
clicando e arrastando o mouse. O
zoom controlado pela roda do
mouse. Girando para cima, feito um
zoom in. Girando para baixo, zoom
out. necessrio primeiro clicar no
fundo da linha de tempo antes de
tentar executar o zoom. Se a tecla
CTRL estiver pressionada, o zoom
feito trs vezes mais rpido

Cursor Marca a posio atual do relgio de

playback. Quando o playback est no
modo Pausa pode-se arrastar o
cursor para os lados, alterando o
relgio de playback enquanto arrasta-
se o cursor. Est sempre visvel na
linha de tempo

E3Playback 687
 OPO DESCRIO
Barra de Consultas Mostra os perodos de tempo que j
tm dados carregados:

Uma linha verde clara significa que

naquele perodo os dados j esto
totalmente carregados

Uma linha verde escura indica que

os dados do perodo esto sendo
carregados

Uma linha amarela clara indica que

o perodo contm alguns dados
carregados. Novas consultas ao
banco de dados so necessrias se
o cursor for movido para cima do
perodo

Uma linha cinza clara indica que o

perodo no tem nenhum dado
carregado ainda. Para carregar os
dados do perodo, mova o cursor
de playback para cima do perodo

Barra de Dados Indica com um ponto azul cada

momento em que h um evento de
playback

Barra de Zoom Geral Mostra o perodo de dados que est

sendo mostrado na Linha de Tempo,
comparado com o perodo total de
dados disponvel para playback

688 E3Playback
Caso tenha sido selecionada a opo Mostrar grfico na Linha de Tempo de
um Tag na Lista de Eventos ou na Lista de Tags, mostrada uma
representao visual do Tag esquerda do grfico. Esta representao varia
de acordo com o tipo de dados do Tag:

String: Mostra caixas de texto com o nome do Tag

Booleano ou Digital: Mostra um grfico de estado do Tag, onde o valor

do Tag fica sempre sobre uma linha inferior (Off ou False) ou sobre uma
linha superior (On ou True). A linha do grfico fica pontilhada nos
perodos em que a qualidade do Tag est ruim

Double, Integer ou Analgico: Mostra um grfico de linha com os

valores do Tag. A escala do grfico (inferior e superior) calculada
automaticamente de acordo com os valores do Tag que o E3Playback j
consultou no banco de dados. Assim como no grfico digital, a linha do
grfico fica pontilhada nos perodos em que a qualidade do Tag est
ruim. A linha tambm pode ser interpolada ou em escada, dependendo
se o Tag suporta (Storage) ou no (Histrico) interpolao

Mostrar grfico na Linha de Tempo

Cada Tag adicionado na Linha de Tempo possui uma cor definida

automaticamente, que pode ser alterada usando a opo Alterar a cor do
menu contextual. Esta opo abre a janela de Cores do sistema, permitindo
selecionar uma nova cor ou personalizar a cor selecionada.

E3Playback 689
20.3.3 Marcadores
Os Marcadores so utilizados para sinalizar ocorrncias na linha de tempo do
E3Playback.

Marcadores

Opes disponveis na barra de ferramentas Marcadores

CONE COMANDO AO
Adicionar marcador no Adiciona um nome ao
timestamp marcador na linha de
selecionado tempo, na data e hora
selecionadas

Editar marcador Permite editar o

selecionado marcador selecionado,
podendo alterar data e
hora, nome ou
descrio

Remover o marcador Remove o marcador

selecionado na linha de
tempo

Remover todos os Remove todos os

marcadores marcadores criados na
linha de tempo

Mover para o Seleciona o marcador

marcador anterior imediatamente frente
na linha de tempo e na
lista de eventos,
simultaneamente

690 E3Playback
 CONE COMANDO AO
Mover para o Seleciona o prximo
marcador seguinte marcador na linha de
tempo e na lista de
eventos,
simultaneamente

Clicando em Adicionar ou em Editar , a janela a seguir mostrada.

Adicionar ou editar marcador

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Adicionar ou Editar Marcador

OPO DESCRIO
Data/hora/ms Permite selecionar a data e a hora,
incluindo os milissegundos, do
marcador. Estes campos j vm
preenchidos com a data e a hora
selecionadas na linha de tempo

Nome Permite selecionar o nome do

marcador

Comentrios Permite informar algum comentrio

adicional para o marcador

E3Playback 691
Quando um marcador criado, ele mostrado na Linha de Tempo, como
pode ser observado na figura a seguir, e tambm na Lista de Eventos.

Linha de Tempo com marcadores

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

rea de Telas

A rea de Telas funciona como se fosse um Viewer dentro do E3Playback. As

Telas so sempre abertas no zoom Preencher. possvel navegar livremente
entre as Telas do aplicativo.

Existem algumas restries e comentrios quanto ao funcionamento das Telas

dentro do E3Playback:

As Telas funcionam como se estivessem em um Viewer Somente Leitura,

isto , no permitido o envio de comandos e valores para o servidor
E3. Isto garante que as operaes efetuadas no E3Playback no iro
perturbar o funcionamento do aplicativo em tempo real

No permitido acesso aos objetos do servidor atravs do mtodo

Application.GetObject. Se este mtodo for chamado em algum script,
ele falha abortando o script

E3Playback 693
 Devido s vrias limitaes de acesso ao servidor, erros de script
ocorridos dentro do E3Playback no geram uma mensagem de erro, e os
scripts so abortados silenciosamente

O E3Playback emula um Viewer real. Para isto criada uma nova cpia do
objeto Viewer e seus Tags para uso do E3Playback. Se algum
comportamento especfico do Viewer tiver que ser habilitado ou
desabilitado dentro do E3Playback, pode-se testar a propriedade
IsPlaybackMode, do objeto Viewer

O isolamento entre as Telas que executam dentro do E3Playback e o que

est fora total

O E3Playback trata os novos Quadros criados pelo aplicativo como novas

abas no topo da rea de Telas. O ttulo da aba o nome do Quadro ou
Tela que foi aberto

Quadros abertos em abas no E3Playback

Todas as Associaes que se referem a objetos do servidor so

capturadas pelo E3Playback, e passam a receber os dados histricos de
acordo com o relgio atual de playback. Isto inclui no apenas as
Associaes feitas nas Telas que esto sendo mostradas, mas tambm as
Associaes existentes nos Tags do Viewer

As Associaes feitas entre objetos do Viewer (por exemplo, um Display

mostrando o valor de um Tag Demo interno ao Viewer) funcionam
normalmente, sem nenhuma interferncia do playback
694 E3Playback
 O E3Chart s funciona dentro do E3Playback se estiver configurado com
Penas histricas. Penas de tempo real so desabilitadas dentro do
E3Playback (ficam sem dados)

O E3Alarm mostra o sumrio de alarmes de acordo com o que estiver

registrado na tabela de alarmes no banco de dados

O E3Browser funciona normalmente, j que consultas ao banco de dados

so permitidas dentro do E3Playback

NOTA
Os dados mostrados no E3Browser so sempre os dados ATUAIS do banco
de dados, isto , o E3Playback no tenta emular o estado do banco de
dados em um momento no passado.

E3Playback 695
20.3.5 Lista de Eventos
A Lista de Eventos mostra a sequncia cronolgica de eventos de playback,
permitindo a navegao evento a evento. Um evento de playback pode ser:

Uma alterao no valor de um Tag

Uma alterao no estado de um alarme

Lista de Eventos

As colunas desta janela esto descritas na tabela a seguir.

Colunas da Lista de Eventos

COLUNA DESCRIO
Data/hora Mostra a data e a hora do evento,
conforme est registrado no banco
de dados

Caminho do Tag Mostra o caminho do Tag ou da

fonte de alarmes que gerou este
evento, ou o nome do Marcador

696 E3Playback
 COLUNA DESCRIO
Evento Se o evento for de mudana do valor
de um Tag, mostra o novo valor. Se
a qualidade no for Boa (192), ela
mostrada na frente do valor (por
exemplo, "Ruim(20); 45.433"). Se o
evento for uma alterao no estado
de um alarme, mostra o nome da
sub-condio (HI, HIHI, LO, LOLO,
etc.) e a descrio do alarme. Se o
alarme est (ou foi) reconhecido,
mostra no incio o texto "ACK", com
o nome do operador entre
parnteses. Se for um Marcador,
este campo mostra o comentrio
associado a ele

A barra de ferramentas da Lista de Eventos possui as opes listadas na

tabela a seguir.

Opes da barra de ferramentas da Lista de Eventos

CONE COMANDO AO
Evento Anterior Posiciona o relgio de
playback no evento
anterior ao evento
selecionado na lista,
pulando os eventos
com timestamp igual ao
timestamp atual

Prximo Evento Posiciona o relgio de

playback no prximo
evento com timestamp
maior que o timestamp
atual

E3Playback 697
 CONE COMANDO AO
Filtrar Eventos Liga ou desliga o filtro
de eventos. Ao ligar o
filtro, apenas os
eventos do Tag ou da
fonte de alarme
selecionado atualmente
so mostrados na lista
de eventos. Os
Marcadores so
mostrados sempre,
independente do filtro

Filtrar marcadores Mostra apenas os

Marcadores criados

Ao clicar com o boto direito do mouse em um evento, um menu contextual

mostrado com as opes descritas na tabela a seguir.

Opes do menu contextual dos eventos

OPO DESCRIO
Mostrar ou Remover grfico na Adiciona ou remove uma
Linha de Tempo representao visual do Tag
selecionado na janela Linha de
Tempo

Mostrar apenas os eventos deste Filtra os eventos na Lista de Eventos

tag ou Mostrar todos os eventos para mostrar apenas o Tag
selecionado. Selecionando de novo
esta opo, todos os eventos so
mostrados

698 E3Playback
20.3.6 Lista de Tags
A Lista de Tags mostra os Tags que esto sendo utilizados para playback.

Lista de Tags

As colunas desta janela esto descritas na tabela a seguir.

Colunas da Lista de Tags

COLUNA DESCRIO
Caminho do Tag Mostra o caminho do Tag

Tabela Mostra o nome da tabela do banco

de dados que contm os dados do
Tag

Estado Indica se o Tag foi encontrado ou

no no banco de dados

Valor Mostra o valor do Tag na data e

hora atual de playback

E3Playback 699
 COLUNA DESCRIO
Data/hora Mostra o timestamp atual do Tag. Se
o Tag suportar interpolao (apenas
para pontos analgicos
armazenados no Storage), ento o
timestamp igual ao horrio atual
de playback. Caso contrrio, o
timestamp o do ltimo evento com
timestamp anterior ou igual ao
horrio atual de playback

Qualidade Mostra a qualidade do Tag (padro

OPC) no momento atual de playback.
Quando a qualidade 192,
mostrado apenas o texto "Boa"

Evento Anterior Mostra o timestamp do evento

anterior deste Tag no banco de
dados. Se o Tag no suportar
interpolao, o evento anterior
sempre igual ao timestamp atual do
Tag. Se o Tag suportar interpolao,
o evento anterior o ltimo
timestamp registrado no banco de
dados antes do horrio atual de
playback

Prximo Evento Mostra o timestamp do prximo

evento deste Tag

700 E3Playback
NOTA
A Lista de Tags pode ajudar tambm a determinar quais Tags necessitam ser
gravados no banco de dados para permitir o playback completo de uma
Tela, bastando verificar os Tags com o sinal de proibido .

Ao clicar com o boto direito do mouse em um Tag, um menu contextual

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

20.4 Banco de Dados de Playback

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

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

1. Enumerar todas as tabelas do banco de dados.

2. Verificar quais destas tabelas possuem uma tabela _Fields

correspondente. Por exemplo, quando o E3 gera uma tabela de alarmes
chamada E3Alarms, gera tambm uma tabela com a descrio dos
campos da tabela de alarmes (E3Alarms_Fields).

3. Analisar os campos de cada tabela, bem como o contedo da sua tabela

_Fields correspondente para determinar o tipo de tabela. O E3Playback
reconhece trs tipos de tabela:

Storage: A tabela deve ter os campos E3TimeStamp, FieldID, Quality e

FieldValue

Alarmes: A tabela deve ter os campos EventTime (ou EventTimeDbl),

ConditionActive, Acked, AckRequired e FullAlarmSourceName

Histrico: A tabela deve ter o campo E3TimeStamp, e no pode ter sido

reconhecida como uma tabela de Storage ou de Alarmes

4. Se a tabela for de Storage, a tabela _Fields varrida para determinar

quais so os Tags armazenados na tabela. O caminho do Tag
determinado pelo campo FieldName da tabela _Fields. O campo que
fornece o timestamp dos dados de Storage sempre o E3TimeStamp.
Cada Storage pode ter at trs tabelas de dados, uma para cada tipo de
dado:

Strings: O nome da tabela de dados <Tabela>_String

Bit/Digital: O nome da tabela de dados <Tabela>_Bit

Double/Analgicos: O nome da tabela de dados <Tabela>

702 E3Playback
5. Se a tabela for de Histrico, a tabela _Fields varrida para determinar
quais so os Tags armazenados na tabela. O caminho do Tag neste caso
determinado pelo campo FieldSource. O campo que fornece o
timestamp dos dados desta tabela sempre o E3TimeStamp.

6. Se a tabela for de alarmes, a tabela _Fields varrida para determinar o

nome dos campos de alarme de usurio (se existirem). O campo que
fornece o timestamp na tabela de alarmes o EventTime (opcionalmente
combinado com o campo EventTimeMS, se existir) ou o campo
EventTimeDbl (este ltimo tem prioridade por representar os
milissegundos com mais preciso).

7. Depois que todas as tabelas de dados e os caminhos dos Tags foram

detectados, feita uma consulta simples em cada uma das tabelas para
determinar a data mais antiga e a data mais nova armazenada na tabela.
Isto permite determinar o intervalo de datas em que o playback
permitido.

NOTAS
O intervalo de datas vlidas no atualizado durante um processo de
playback, de forma que os dados novos que forem adicionados ao banco
de dados aps a montagem s esto disponveis se a janela de playback
for fechada e aberta novamente.
Em modo Demo (ou com uma licena de E3 Studio), o perodo permitido
para playback se resume s ltimas seis horas de dados armazenados no
banco de dados.

E3Playback 703
20.4.2 Consultas de Dados de Playback
A quantidade de dados disponvel para playback pode ser enorme,
dependendo do aplicativo. Para tornar a navegao de Telas mais suave, o
E3Playback executa consultas ao banco de dados em perodos de tempo
chamados Fatias.

Cada fatia de dados de playback tem uma largura fixa de um dia. Sempre que
o relgio posicionado em uma determinada data e hora, o E3Playback cria
ou encontra a fatia de tempo que contm a data e hora atual. Cada fatia de
dados possui as seguintes informaes:

Perodo de tempo da fatia (data e hora inicial e final)

Uma lista dos Tags que j tm os seus dados carregados na fatia

Para cada Tag armazenado em uma fatia, so mantidos os seguintes

dados:

O ltimo evento do Tag anterior ao incio da fatia

Todos os eventos do Tag dentro do intervalo da fatia

O prximo evento do Tag aps o final da fatia

O sumrio de alarmes no momento do incio da fatia

Todos os eventos de alarmes que ocorreram durante o intervalo da fatia

O prximo evento de alarme de cada Fonte de Alarme aps o final da

fatia

Quando o relgio de playback movido sobre uma fatia de tempo, o

E3Playback analisa se todos os Tags necessrios j esto carregados na fatia,
e se todas as informaes de alarme tambm j foram carregadas. Se estiver
faltando algum dado, ento gerada uma consulta assncrona para carregar
os dados necessrios do banco de dados. Uma consulta de dados de
playback composta dos seguintes parmetros:

Perodo que vai ser consultado (data e hora inicial e final)

704 E3Playback
 Conjunto de Tags que devem ser consultados (pode estar vazio). Para
cada Tag deve ser retornado:

O ltimo evento anterior ao incio da consulta

Todos os eventos ocorridos durante o perodo da consulta

O prximo evento que ocorreu aps o perodo da consulta

Informaes de alarmes que devem ser consultadas, que podem ser zero
ou mais das seguintes opes:

Sumrio de alarmes anterior (estado de cada Fonte de Alarme na data

e hora inicial da consulta)

Eventos de alarmes no perodo

Sumrio de alarmes posterior (prximo evento de cada Fonte de

Alarme aps a data e hora final do perodo)

Para executar uma consulta a dados de playback, normalmente so

necessrias vrias consultas ao banco de dados. O servidor de dados de
playback efetua estas consultas de forma assncrona e em um thread
separado, coleta os dados e s os retorna quando todas as consultas tiverem
terminado.

Quando uma consulta de playback completada, os dados so imediatamente

adicionados fatia correspondente e o E3Playback automaticamente dispara
consultas para atualizar as fatias vizinhas. Desta forma, medida que o
relgio de playback avana, as consultas de dados vo sendo feitas, e quando
o relgio passa para a prxima fatia bem provvel que ela j tenha todos
os seus dados carregados.

Caso o relgio de playback esteja no modo Reproduzir e entre em uma fatia

sem dados ou com dados incompletos, o E3Playback fica temporariamente
pausado aguardando at que as consultas daquela fatia sejam completadas.

O E3Playback tambm busca minimizar o acesso ao banco de dados,

aproveitando as informaes dos campos ltimo evento anterior, Prximo
evento aps, Sumrio anterior e Sumrio posterior para evitar que estes
dados sejam consultados novamente. Por exemplo:

E3Playback 705
 Se uma consulta a um Tag no retornou o prximo evento aps o
perodo da consulta, sinal de que este Tag no possui nenhum evento
aps a data e hora final da consulta, e portanto este Tag no precisa ser
consultado nas fatias de tempo posteriores

Se uma consulta retornou o sumrio anterior, eventos de alarmes no

perodo e o sumrio posterior para uma fatia, possvel calcular o
sumrio anterior da prxima fatia simplesmente combinando o sumrio
anterior e os eventos ocorridos durante a fatia atual. Desta forma, torna-
se desnecessrio consultar no banco de dados o sumrio anterior da
prxima fatia

20.5 Configurao dos Objetos de Banco de

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

20.5.1 Storage
A nica recomendao para o Storage que a coluna Fonte no deve conter
expresses, pois elas no podem ser utilizadas no playback.

O E3 j cria automaticamente nas tabelas de Storage os ndices necessrios

para otimizar as consultas do E3Playback.

706 E3Playback
20.5.2 Alarmes
Para executar o playback de alarmes, siga estes procedimentos:

1. Habilite ou configure o registro de alarmes em disco.

2. Selecione os seguintes campos para registro (obrigatrios):

EventTime (mais EventTimeMS) ou EventTimeDbl

FullAlarmSourceName

ConditionActive

Acked

AckRequired

3. Ainda recomendada a seleo dos seguintes campos para registro:

InTime (mais InTimeMS) ou InTimeDbl

OutTime (mais OutTimeMS) ou OutTimeDbl

AckTime (mais AckTimeMS) ou AckTimeDbl

Area

ActorID

Enabled

EventCategory

EventType

Message

Severity

Source

SubConditionName

E3Playback 707
 CurrentValue

Seleo dos campos

O E3 j cria automaticamente na tabela de alarmes os ndices necessrios

para otimizar as consultas de playback.

708 E3Playback
20.5.3 Histricos
O formato de arquivo Histrico no o ideal para playback, pois
normalmente muitos dados duplicados esto armazenados. As consultas de
playback tm um trabalho extra para eliminar os valores duplicados de cada
Tag e encontrar apenas os eventos de mudana de valor, o que pode exigir
longas consultas sequenciais na tabela do Histrico. recomendado o uso do
Storage sempre que possvel. Se for indispensvel o uso de dados de
Histrico no playback, deve-se seguir ao mximo as seguintes
recomendaes:

Configurar a propriedade UserTable para Falso (se esta propriedade

estiver em Verdadeiro, a tabela _Fields deste histrico no gerada, e
este histrico no reconhecido pelo playback)

Colocar cada Tag em um campo separado (no utilizar expresses na

fonte do campo, por exemplo)

Criar um ndice para o campo E3TimeStamp. Sem este ndice as

consultas ao Histrico ficam muito lentas, tornando o playback
impraticvel

Utilizar tabelas com poucos campos e, se possvel, adicionar um ndice

individual para cada campo (principalmente para os campos com poucas
variaes)

Configurar a propriedade CompressedTable em Verdadeiro e utilizar a

propriedade DeadBand no Histrico

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

E3TimeStamp:

E3Playback 709
 Definio do ndice para o campo E3TimeStamp

710 E3Playback
20.5.4 Licenciamento
A Elipse Software fornece dois pacotes de playback, de acordo com as suas
ferramentas:

Playback Bsico

Playback Avanado: Consiste no Playback Bsico mais as ferramentas

Gravao de Vdeo e Captura de Tela

Cada um destes pacotes dimensionado conforme o nmero de pontos

(Tags e Fontes de Alarmes) armazenados no banco de dados. Por exemplo,
um Playback Bsico 1000 permite fazer playback de um banco de dados com
at 1000 pontos. Se o banco de dados tem mais pontos que as licenas
disponveis, a montagem do banco de dados falha e mostrada uma
mensagem de erro indicando que no h licenas disponveis para executar o
playback.

A licena de Studio do E3 inclui uma licena de Playback Avanado sem limite

de pontos, porm limitada s ltimas seis horas de dados armazenados no
banco de dados. Isto permite que o desenvolvedor do aplicativo teste o
playback sem precisar adquirir as licenas para isto.

Em modo Demo (quando no h dispositivo de proteo), o playback

tambm funciona no modo Avanado sem limite de pontos, porm limitado a
mostrar apenas as ltimas seis horas de dados armazenados no banco de
dados, em relao hora atual do servidor.

IMPORTANTE
Se o dispositivo de proteo for do tipo Master (Studio + Runtime) ou
apenas de Runtime, o playback s est disponvel se houver licenas
programadas no dispositivo. Para maiores informaes sobre as limitaes
do modo Demo do E3, veja o tpico Limitaes do Modo Demonstrao.

E3Playback 711
 CAPTULO
Frmulas
21
Frmulas so mdulos destinados ao armazenamento e transferncia de
conjuntos de valores para determinados agrupamentos de variveis, de forma
a criar configuraes pr-definidas. So compostas de trs partes:
Templates, Unidades e Conjuntos de Valores.

As Frmulas podem ser utilizadas para facilitar processos industriais. Por

exemplo, uma fbrica de bebidas produz vrios tipos de sucos, cada um
deles com uma receita diferente. Neste caso, os Templates so os sabores
(laranja, uva, tangerina, etc.). As Unidades so os tanques onde os sucos so
produzidos. Os Conjuntos de Valores so o tipo e a quantidade de produtos
colocados em cada suco (por exemplo, 50 g de acar, 1000 l de gua, polpa
de fruta, etc.). Para utilizar este recurso, siga este procedimento:

1. Clique com o boto direito do mouse no nome do projeto no Organizer e

selecione a opo Inserir - Frmula.

712 Frmulas
 Inserindo uma Frmula

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

Frmulas 713
21.1 Configuraes
Quando se cria uma Frmula, mostrada uma janela para a configurao do
Banco de Dados e da tabela a ser utilizados. Sem isto, no possvel a
criao de Unidades e Conjuntos de Valores.

Configurao do Banco de Dados e da tabela

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Configurao do Banco de Dados

OPO DESCRIO
Banco de Dados Determina o servidor de Banco de
Dados que gerencia os dados
configurados na Frmula. Este
campo equivale propriedade
DBServer da Frmula

Tabela Determina o nome da tabela onde

so guardados os dados da
Frmula. Este campo equivale
propriedade TableName da Frmula

714 Frmulas
 OPO DESCRIO
Tamanho mximo dos campos de Determina o tamanho mximo dos
Unidades campos de Unidades na tabela do
Banco de Dados. O valor padro
deste campo 200. Este campo
equivale propriedade
DataSourceSize da Frmula

Tamanho mximo dos campos de Determina o tamanho mximo dos

Valores campos de Valores na tabela do
Banco de Dados. O valor padro
deste campo 200. Este campo
equivale propriedade ValueSize da
Frmula

Frmulas 715
Caso seja necessrio configurar estas opes posteriormente, ou mesmo
reconfigur-las, selecione a opo Configurar Banco de Dados no menu
contextual da Frmula.

Configurando o Banco de Dados

716 Frmulas
21.2 Templates
A primeira aba no Editor de Frmulas chama-se Templates. Os Templates
definem o tipo de dados que pode ser armazenado em cada varivel da
Frmula, alm de suas restries.

Aba Templates

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Templates

OPO DESCRIO
Nome Define o nome do Template

Tipo Define o tipo do Template

Restries Determina as restries do Template

Frmulas 717
A barra de ferramentas da aba Templates contm as opes Adicionar ,
para a criao de um novo Template, e Remover , para a excluso do
Template selecionado.

Ao clicar em Restries , a janela da figura a seguir mostrada.

Edio das restries

As restries permitem habilitar ou desabilitar a alterao dos valores da

Frmula em tempo de execuo, ou ento estipular limites para esta
alterao. As opes disponveis nesta janela esto descritas na tabela a
seguir.

Opes disponveis na janela Edio das Restries

OPO DESCRIO
Limite Irrestrito O usurio pode alterar qualquer
valor no Template. simbolizado
pela letra U na aba Templates

718 Frmulas
 OPO DESCRIO
Limite Restrito O usurio no pode alterar o valor
do Template. simbolizado pela
letra R na aba Templates

Limite Absoluto So definidos valores fixos como

limites, correspondendo ao valor
mnimo e mximo do Template.
simbolizado pela letra A na aba
Templates (e os valores mnimo e
mximo configurados no campo)

Limite Percentual Valor percentual acima ou abaixo do

valor pr-definido. Por exemplo,
colocando os limites entre 20% e
30%, para o valor 100, os valores
permitidos variam entre 80 e 130.
simbolizado pela letra P na aba
Templates (e os valores
configurados no campo)

Limite por diferena Valores fixos acima ou abaixo do

valor pr-definido. Por exemplo,
colocando os limites em 10 e 50 para
o valor 50, os valores permitidos
variam de 40 e 100. simbolizado
pela letra D na aba Templates (e os
valores configurados no campo)

Frmulas 719
21.3 Unidades
A segunda aba no Editor de Frmulas chama-se Unidades. As Unidades
definem os Tags que so associados aos Templates da Frmula. possvel
criar vrias Unidades, ou seja, vrios grupos de Tags que podem receber os
valores da Frmula.

Aba Unidades

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Unidades

OPO DESCRIO
Nome Determina o nome do Template

Unidade Determina o Tag que associado

Unidade

720 Frmulas
A barra de ferramentas da aba Unidades contm as opes Adicionar ,
para a criao de uma nova Unidade, Remover , para a excluso da
Unidade selecionada, e Renomear , para a troca do nome da Unidade
selecionada. Para cada nova Unidade, a janela a seguir mostrada para
definir um nome.

Adio de uma Unidade

21.4 Conjunto de Valores

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

Aba Valores

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Valores

OPO DESCRIO
Nome Determina o nome do Template

Frmulas 721
 OPO DESCRIO
Valor Determina o valor dos campos para
os Conjuntos de Valores

A barra de ferramentas da aba Valores contm as opes Adicionar , para

a criao de um novo Conjunto de Valores, Remover , para a excluso do
Conjunto de Valores selecionado, e Renomear , para a troca do nome do
Conjunto de Valores selecionado.

21.5 Criao de uma Frmula

Instrues

Este exerccio cria um objeto Frmula para armazenar Conjuntos de Valores

para a produo de uma determinada pea. Esta pea tem trs medidas:
Dimetro Externo, Dimetro Interno e Altura. Esta Frmula armazena os
valores para duas mquinas diferentes que produzem estas peas.

722 Frmulas
21.5.1 Procedimentos
1. Insira um objeto Frmula na aplicao.

2. Configure o Banco de Dados e a tabela. Use um Banco de Dados existente

no projeto, e nomeie a tabela como "Produo".

Configuraes do Banco de Dados e da tabela

3. Crie trs Templates na Frmula:

Dimetro Externo: Com restrio de valor absoluta entre 50 e 80

Dimetro Interno: Com restrio por diferena de valor de 10 e 10

Altura: Com limite restrito

Templates

Frmulas 723
4. Na prxima etapa so definidas as Unidades relativas a esta Frmula.
Antes de criar as Unidades, no entanto, deve-se criar os Tags usados
nesta Frmula. Para isto, insira em um Servidor de Dados uma Pasta
chamada "Formula" e dentro dela outras duas Pastas chamadas
"Maquina1" e "Maquina2". Dentro destas Pastas crie trs Tags Internos
para cada uma.

Criando Tags

5. Crie na Frmula duas Unidades chamadas "Maquina1" e "Maquina2".

Associe cada campo destas Unidades aos Tags criados anteriormente.

724 Frmulas
 Associando os Tags s Unidades da Frmula

6. Defina os Conjuntos de Valores a serem carregados posteriormente nos

Tags. Crie quatro Conjuntos de Valores, chamados de "Modelo1" at
"Modelo4", e digite os valores mostrados na figura a seguir.

Configurao do Conjunto de Valores

7. Crie agora uma nova Tela chamada "Frmulas".

8. Crie seis objetos SetPoint nesta Tela, que devem ser associados a cada
um dos Tags da Frmula, e ajuste o tamanho da Tela ao dos objetos. A
Tela deve estar semelhante figura a seguir.

Frmulas 725
 Tela de Frmula

NOTA
s vezes, pode ocorrer um erro na Tela que faz com que as imagens
desapaream. Para solucionar esta questo, deve-se desabilitar a opo
Esconder extenses do MS-DOS para arquivos registrados. Esta opo
est disponvel no Windows Explorer.

9. Crie um boto na Tela com o ttulo "Carregar valores". Este boto mostra
uma caixa de dilogo com os valores existentes e as Unidades para as
quais estes podem ser carregados, podendo ser selecionada qualquer
opo. Para tanto, crie o seguinte script neste boto.
Sub CommandButton1_Click()
Application.LoadFormulaDlg_
"Formula1", "Maquina1, Maquina2",_
"Modelo1, Modelo2, Modelo3, Modelo4"
End Sub

726 Frmulas
Onde Formula1 o nome do objeto Frmula criado e o mtodo
LoadFormulaDlg um mtodo do Viewer. Ao ser executado este mtodo, a
caixa de dilogo da figura a seguir mostrada.

Caixa de dilogo do mtodo LoadFormulaDlg

10. Na diviso da direita so apresentadas as duas Unidades criadas na

Frmula, assim como os Conjuntos de Valores. A opo Modo Silencioso
inibe a possibilidade de o usurio alterar valores gravados em disco, que
so carregados para os Tags.

11. Atravs deste boto, pode-se ver a aplicao funcionando com as

Frmulas e os Tags recebendo os valores do disco. Este um dos
mtodos para carregar valores de uma Frmula, mas tambm existem
mtodos em que o usurio no necessita selecionar os valores ou as
Unidades em uma caixa de dilogo.

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

Alterao do valor

No entanto existe uma alternativa, o mtodo LoadFormulaValuesQuiet, do

objeto Viewer. feita uma opo pelo modo silencioso na Tela, utilizando
para isto, o objeto Caixa de Seleo.

1. Crie um objeto Caixa de Seleo na Tela.

2. Coloque um texto de identificao ao seu lado, com o texto "Silencioso".

3. Volte ao script do boto OK e mude o cdigo para o seguinte:

728 Frmulas
 Sub CommandButton2_Click()
If Screen.Item("CheckBox1").Value = true Then
Application.LoadFormulaValuesQuiet_
"Formula1", "Maquina1", "Modelo1"
Application.LoadFormulaValuesQuiet_
"Formula1", "Maquina1", "Modelo2"
Application.LoadFormulaValuesQuiet_
"Formula1", "Maquina1", "Modelo3"
Application.LoadFormulaValuesQuiet_
"Formula1", "Maquina1", "Modelo4"
Else
Application.LoadFormulaValues_
"Formula1", "Maquina1", "Modelo1"
Application.LoadFormulaValues_
"Formula1", "Maquina1", "Modelo2"
Application.LoadFormulaValues_
"Formula1", "Maquina1", "Modelo3"
Application.LoadFormulaValues_
"Formula1", "Maquina1", "Modelo4"
End If
End Sub

Onde CheckBox1 o nome da Caixa de Seleo criada. Isto faz com que se o
objeto estiver habilitado, seja utilizado o mtodo LoadFormulaValuesQuiet.
Caso contrrio, utilizado o mtodo LoadFormulaValues.

1. Repita os ltimos procedimentos desde a criao do SetPoint para os

itens da Maquina2, modificando os scripts necessrios. Ao final das
alteraes, a Tela deve estar semelhante figura a seguir.

Frmulas 729
 Tela final da Frmula

2. Execute a aplicao e observe os resultados.

730 Frmulas
 CAPTULO
Relatrios
22
O Relatrio um componente ActiveX chamado ActiveReport, que permite a
visualizao e impresso de valores instantneos de variveis do sistema e
dados armazenados em Banco de Dados (Alarmes, Histricos, Consultas e
Frmulas). Estes dados podem ser impressos tanto em formato texto como
em formato grfico, sendo este ltimo feito atravs do objeto E3Chart.

NOTAS
O objeto Relatrio NO est disponvel na verso 64 bits do E3.
Entretanto, o Relatrio pode ser editado na verso 32 bits do Studio,
presente na instalao 64 bits.
Um Viewer 32 bits conectado a um Servidor 64 bits imprime Relatrios
normalmente.

Para utilizar o Relatrio, siga estes procedimentos:

1. Clique com o boto direito no item Relatrios do Organizer e selecione a

opo Inserir Relatrio em.

Relatrios 731
 Inserindo um Relatrio

2. Caso necessite, configure as propriedades do objeto.

22.1 Objeto Consulta

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

732 Relatrios
22.2 Componentes
Um Relatrio contm vrias Sees. Cada Seo do Relatrio contm um
grupo de controles que so processados e impressos ao mesmo tempo,
como uma unidade.

Sees do Relatrio

O Relatrio define tipos de Seo, que so explicados nos tpicos a seguir.

22.2.1 Detail
A Seo Detail o corpo do Relatrio, que imprime uma vez para cada
registro da fonte de dados.

Relatrios 733
22.2.2 Group Header e Group Footer
Um Relatrio pode ter mltiplos grupos aninhados. Cada grupo possui uma
Seo Header e uma Seo Footer. A Seo Header imprime antes de
qualquer Seo Detail no grupo. A Seo Footer imprime depois de todas as
Sees Detail do grupo. Sees de grupo so inseridas imediatamente antes
e depois da Seo Detail.

O nmero de vezes que uma Seo de grupo pode imprimir depende de

como os dados so agrupados. O Relatrio inicia um novo grupo (Header,
Detail e Footer) para cada mudana nos dados que so reunidos no grupo.

22.2.3 Page Footer

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

22.2.4 Page Header

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

22.2.5 Report Footer

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

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

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

Relatrios 735
22.3 Configuraes
O Relatrio possui vrios objetos que podem ser agregados a ele, que so
acessados atravs da barra de ferramentas Relatrios.

Barra de ferramentas Relatrios

Clicando com o boto direito do mouse no Relatrio, mostrado um menu.

As opes deste menu variam de acordo com o local do clique do mouse.

Na rea do Relatrio: Somente as opes Insert e Delete Section esto

habilitadas

Menu da rea do
Relatrio

Em um objeto no Relatrio: Somente as opes Insert, Delete, Cut, Copy,

Paste, Bring to Front, Send to Back, Alignment e Format Border esto
habilitadas

736 Relatrios
 Menu de objeto do
Relatrio

Em mais de um objeto selecionado no Relatrio: Todas as opes do

menu esto habilitadas

Opes disponveis no menu contextual do Relatrio

OPO DESCRIO
Insert Permite inserir um novo componente
do Relatrio. As opes disponveis
so as seguintes:

Insert - Group Header/Footer:

Adiciona um novo par de
cabealhos ou rodaps de grupo
no Relatrio

Insert - Page Header/Footer:

Adiciona um novo par de
cabealhos ou rodaps de pgina

Insert - Report Header/Footer:

Adiciona um novo par de
cabealhos ou rodaps no Relatrio

Relatrios 737
 OPO DESCRIO
Delete / Delete Section Apaga a Seo, objeto ou grupo
selecionado. Esta opo no
aplicada na Seo Detail do Relatrio

Reorder Groups Reorganiza os grupos selecionados.

Esta opo vlida quando vrios
grupos de Seo (pares de cabealho
ou rodap) so adicionados no
Relatrio. Esta opo no aplicada
na Seo Detail do Relatrio

Cut Recorta o objeto, grupo ou Seo

selecionado

Copy Copia o objeto, grupo ou Seo

selecionado

Paste Cola o objeto, grupo ou Seo na

Seo corrente do Relatrio

Bring to Front O objeto, grupo ou Seo selecionado

enviado para a primeira posio na
ordem de sobreposio

Send to Back O objeto, grupo ou Seo selecionado

enviado para a ltima posio na
ordem de sobreposio

738 Relatrios
 OPO DESCRIO
Align Alinha o objeto, grupo ou Seo
selecionado. As opes disponveis
so as seguintes:

Lefts: Alinhamento esquerdo

Centers: Alinhamento centralizado

Rights: Alinhamento direito

Tops: Alinhamento no topo

Middles: Alinhamento central

Bottoms: Alinhamento mesma altura

To grid: Alinhamento conforme a

grade

Center in section: Alinhamento

centralizado na Seo

Size Determina o tamanho do objeto,

grupo ou Seo selecionado. As
opes disponveis so as seguintes:

Make same width: Mesma largura

Make same height: Mesma altura

Make same size: Mesmo tamanho

Relatrios 739
 OPO DESCRIO
Horizontal Spacing Determina o espaamento horizontal
do objeto no Relatrio. As opes
disponveis so as seguintes:

Make Equal: Espaamento igual

entre os objetos

Increase: Incrementa o
espaamento do objeto em um
passo

Decrease: Decrementa o
espaamento do objeto em um
passo

Vertical Spacing Determina o espaamento vertical do

objeto. As opes disponveis so as
seguintes:

Make equal: Espaamento igual

entre os objetos

Increase: Incrementa o
espaamento do objeto em um
passo

Decrease: Decrementa o
espaamento do objeto em um
passo

Format Border Determina o formato da borda do

objeto do Relatrio

740 Relatrios
Quando a opo Format Border selecionada, a caixa de dilogo da figura a
seguir mostrada.

Opes de borda do objeto

As opes disponveis esto descritas na tabela a seguir.

Opes disponveis para a borda do objeto

OPO DESCRIO
Presets Determina o estilo da borda externa
do objeto

Line Styles Determina o estilo da linha da borda

do objeto

Preview Prvia de configurao do objeto

Color Determina a cor da borda do objeto

Shadow Habilita ou desabilita a sombra do

objeto

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

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

Prvia de impresso do Relatrio

As opes disponveis nesta janela esto descritas na tabela a seguir.

Configuraes da Prvia de Impresso

CONE DESCRIO
Tabela de contedo do
Relatrio

Relatrios 743
 CONE DESCRIO

Imprime o Relatrio, abrindo a

Tela de configurao de
impresso

Copia o contedo selecionado

Procura um texto especfico no

Relatrio

Visualizao de uma pgina

simples do Relatrio

Visualizao de mltiplas
pginas do Relatrio

Menos zoom na pgina

Mais zoom na pgina

Porcentagem de zoom na
pgina

Pgina anterior e Prxima

pgina

744 Relatrios
22.3.2 Report Settings
Atravs desta opo, possvel configurar as especificaes do Relatrio, tais
como configuraes de pgina, impresso, grade e estilo do Relatrio.

A aba Page Setup configura as especificaes referentes pgina do

Relatrio.

Configuraes de pgina do Relatrio

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes de configurao Page Setup (pgina)

OPO DESCRIO
Top Margin Determina a margem do topo da
pgina

Bottom Margin Determina a margem do contedo

da pgina

Relatrios 745
 OPO DESCRIO
Left Margin Determina a margem esquerda da
pgina

Right Margin Determina a margem direita da

pgina

Gutter Determina a margem da pgina

Mirror Margins Habilita ou desabilita a margem

espelhada da pgina

746 Relatrios
A aba Printer Settings configura as especificaes referentes impresso do
Relatrio.

Configuraes de impresso do Relatrio

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes de configurao Printer Settings (Impressora)

OPO DESCRIO
Paper Size Determina o tamanho do papel

Width Determina a largura do papel

Height Determina a altura do papel

Relatrios 747
 OPO DESCRIO
Orientation Determina a orientao do papel na
impressora (Printer
Default:Configuraes de acordo
com a impressora padro, Portrait:
Layout da pgina na vertical ou
Landscape: Layout da pgina na
horizontal)

Collate Ordena a impresso

Duplex Duplica a impresso

PaperBin Determina as configuraes e o tipo

de papel para a impresso

748 Relatrios
A aba Grid Settings determina as configuraes referentes s grades do
Relatrio.

Configuraes da grade do Relatrio

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes de configurao Grid Settings (grade)

OPO DESCRIO
Show Grid Habilita ou desabilita a grade

Align Controls to Grid Habilita ou desabilita o alinhamento

dos controles na grade

Grid Columns Determina o nmero de colunas na

grade

Grid Rows Determina o nmero de linhas na

grade

Relatrios 749
 OPO DESCRIO
Ruler Units Determina o tipo de unidade da
rgua (pixels ou centmetros)

A aba Styles determina as configuraes referentes ao estilo do Relatrio.

Configuraes de estilo do Relatrio

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes de configurao Styles (estilos)

OPO DESCRIO
New / Delete / Lista Determina o estilo do Relatrio.
Pode-se inserir um novo estilo
(clicando em New), apagar um estilo
(clicando em Delete) ou utilizar os
estilos existentes na lista

750 Relatrios
 OPO DESCRIO
Font / Colors / Misc Determina as especificaes do estilo
do Relatrio (fontes, cores de fundo
e frente, orientao, etc.)

22.3.3 Script Editor

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

Editor de Scripts

No campo Object necessrio especificar o objeto onde se deseja criar o

script e no item Events, o evento do Relatrio em que ocorre a ao.

22.3.4 Carregar Arquivo RPX

Importa a configurao do Relatrio de um arquivo externo.

Relatrios 751
22.3.5 Salvar Arquivo RPX
Exporta a configurao do Relatrio para um arquivo externo.

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

22.3.6.1 Caixa de Seleo

O objeto Caixa de seleo insere um dado no Relatrio que pode ou no

estar ligado ao Banco de Dados. Seu valor do tipo Booleano.

Caixa de seleo

Aps ser inserido no Relatrio, este objeto chamado de "CheckBox".

22.3.6.2 Campo de Dados

O objeto Campo de Dados utilizado para inserir um dado do Banco de

Dados no Relatrio. Este dado indicado atravs da propriedade DataField.

Campo de Dados

Aps ser inserido no Relatrio, este objeto chamado de "Field".

752 Relatrios
22.3.6.2.1 Exemplo de Utilizao

O exemplo a seguir demonstra como mostrar a mdia por dia de um campo

da consulta no Relatrio. Para tanto, siga estes procedimentos:

1. Insira um novo GroupHeader/Footer no Relatrio.

2. Configure a propriedade DataField do GroupHeader para

"=Day(E3TimeStamp)". Isto determina que o clculo da mdia feito por
dia.

3. Insira um Campo de Dados no GroupHeader com a propriedade

DataField igual a "=Day(E3TimeStamp)".

4. Insira um Campo de Dados no GroupFooter com a propriedade

DataField igual ao nome do campo que calculada a mdia.

5. Configure as seguintes propriedades do Campo de Dados do

GroupHeader:

SummaryFunc: 1 - ddSFAvg

SummaryGroup: GroupHeader1

SummaryRunning: 1 - ddSRGroup

SummaryType: 3 - ddSMSubTotal

Relatrios 753
22.3.6.3 Cdigo de Barras

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

Cdigo de barras

Aps ser inserido no Relatrio, este objeto chamado de "Barcode".

22.3.6.4 E3Chart

O objeto E3Chart um componente ActiveX utilizado para exibir um grfico

mostrando Tags variando em tempo real e tambm mostrar dados histricos
gravados em um Banco de Dados.

E3Chart

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

754 Relatrios
Existem algumas diferenas de funcionamento entre o E3Chart na aplicao e
no Relatrio. Na aplicao, o E3Chart consegue plotar grficos em tempo
real, histrico e misto. J quando este objeto utilizado em um Relatrio, no
permitida sua utilizao com dados em tempo real ou mistos, somente com
dados histricos.

Note que nenhum objeto do Relatrio pode ser acessado externamente, ou

seja, ao se criar o Relatrio pelo aplicativo, no possvel acessar suas
propriedades nem tampouco as de seus objetos via scripts do aplicativo. Por
isto, as alteraes nos objetos, incluindo o E3Chart, devem ser feitas
diretamente no E3 Studio ou em eventos do prprio Relatrio.

Para maiores informaes sobre este objeto, veja o captulo E3Chart.

22.3.6.5 Elipse

O objeto Elipse permite o desenho de crculos e elipses, utilizando toda a

largura ou a altura e definindo o centro do crculo no centro do retngulo.

Elipse

Aps ser inserido no Relatrio, este objeto chamado de "Shape".

Relatrios 755
22.3.6.6 Figura

O objeto Figura permite mostrar imagens que estejam armazenadas em

arquivos, tanto em arquivos externos como em arquivos de recurso do
aplicativo.

Figura

Aps ser inserido no Relatrio, este objeto chamado de "Image".

22.3.6.7 Linha

O objeto Linha liga dois pontos quaisquer. Permite o desenho de retas,

atravs de dois pontos especificados na sua criao ou em polgonos.

Linha

Aps ser inserido no Relatrio, este objeto chamado de "Line".

756 Relatrios
22.3.6.8 Quadro

O objeto Quadro composto de linhas e colunas onde so inseridos textos

ou grficos. Os Quadros dos Relatrios so usados para organizar e
apresentar informaes. Pode-se tambm usar Quadros para criar
disposies de pgina, ou criar textos, grficos e tabelas animadas como em
uma pgina em HTML.

Quadro

Aps ser inserido no Relatrio, este objeto chamado de "Frame".

Relatrios 757
22.3.6.9 Quebra de Pgina

O objeto Quebra de Pgina um ponto em que uma pgina termina e outra

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

Quebra de Pgina

22.3.6.10 Retngulo

O objeto Retngulo permite o desenho de retngulos, utilizando toda a

largura ou altura do objeto. Criado a partir de dois vrtices.

Retngulo

Aps ser inserido no Relatrio, este objeto chamado de "Shape".

758 Relatrios
22.3.6.11 Retngulo Arredondado

O objeto Retngulo Arredondado um retngulo criado a partir de dois

vrtices, com cantos arredondados a partir de um fator de arredondamento.

Ao ser inserido ou editado, exibe um pequeno ponto prximo ao seu canto

superior esquerdo, que permite modificar o fator de arredondamento.

Retngulo arredondado

Aps ser inserido no Relatrio, este objeto chamado de "Shape".

22.3.6.12 Texto

O objeto Texto possibilita a criao de um texto. Ao definir a rea na Tela,

pode-se digitar diretamente o texto desejado, que aceita tambm mltiplas
linhas.

Texto

Aps ser inserido no Relatrio, este objeto chamado de "Label".

22.4 Criando um Relatrio no E3

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

Relatrios 759
22.4.1 Definio de reas
O Relatrio padro, criado quando inserido um novo Relatrio ao projeto,
tem as seguintes reas:

Page Header: rea mostrada em todas as pginas do Relatrio, como

cabealho

Detail Area: rea repetida tantas vezes quantas forem necessrias, o

corpo do Relatrio

Page Footer: Rodap da pgina, trabalha do mesmo modo que o Page

Header

Existem ainda dois tipos de reas:

Report Header/Footer: reas que so impressas uma nica vez, no

importando o tamanho do Relatrio em pginas. Esta rea vem como
abertura ou fechamento do Relatrio

Group Header/Footer: Um grupo utilizado para dividir no Relatrio

conjuntos de valores iguais de uma mesma varivel. Esta rea se repete
sempre que um grupo for apresentado. No exemplo aqui demonstrado
no utilizada nenhuma construo deste tipo. Esta rea sempre envolve
uma rea de detalhes

Estas duas reas podem ser acessadas clicando com o boto direito do
mouse no Relatrio e selecionando a opo Insert.

760 Relatrios
22.4.2 Configurao da Consulta
Para a extrao de dados de um Banco de Dados, necessrio configurar a
consulta do Relatrio. Podem existir vrias consultas diferentes para o mesmo
Relatrio, sendo que apenas uma pode estar ativa em determinado momento.
Para tanto, deve-se seguir estes procedimentos:

1. Configure a propriedade DataSource (nome do Banco de Dados onde

executada a consulta. Neste caso, "ServidorDB").

2. Determine a propriedade Table (tabela de consulta, aqui "Dados").

3. Configure a propriedade Name (mantenha o nome original, "Consulta1").

22.4.3 Configurao dos Campos

Neste exemplo so criadas quatro temperaturas armazenadas em um
Histrico e estas temperaturas so o objeto de interesse do nosso Relatrio.
Sendo assim, os valores lidos do Histrico so impressos atravs do
Relatrio.

Para ler dados de um Banco de Dados, a rea ideal a Detail Area, visto que
esta rea repetida automaticamente quantas vezes se fizerem necessrias.
Desta maneira, devem ser inseridos cinco Campos de Texto nesta rea. Estes
campos podem ser ligados a um Campo de Dados, que configurado
atravs da propriedade DataField. Aqui, so usados os seguintes valores:

Field1: E3Timestamp

Field2: Temperatura1 (como est no Banco de Dados)

Field3: Temperatura2

22.4.4 Visualizao
possvel executar a visualizao do Relatrio criado clicando-se em Preview
, disponvel na rea de edio.

Para tanto, necessrio direcionar o servidor de Banco de Dados do projeto

para o arquivo MDB da pasta onde foi salvo o exemplo.

Relatrios 761
22.5 Exemplos de Utilizao
A seguir so mostrados alguns exemplos de utilizao dos recursos dos
Relatrios.

22.5.1 Configurando o Caminho de um Bitmap na

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

22.5.2 Configurando o Valor de um Cdigo de Barras

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

22.5.3 Capturando uma Tela e Gerando uma Prvia

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

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

Relatrios 763
22.5.5 Como Criar Relatrios Mostrando Pgina N de
M
Para criar um Relatrio que a cada pgina imprime um indicativo de Pgina N
de M onde N a pgina atual e M o total de pginas, crie dois Labels e dois
Campos de Dados.

Os dois Labels correspondem aos textos Pgina e de, que devem ser
inseridos na propriedade Caption. Os dois Campos de Dados correspondem
aos valores N e M, com as seguintes propriedades:

Campo N

Name: txtPageNumber

SummaryGroup: GroupHeader1

SummaryRunning: 1 - ddSRGroup

SummaryType: 4 - ddSMPageCount

Campo M

Name: txtPageCount

SummaryGroup: GroupHeader1

SummaryType: 4 - ddSMPageCount

764 Relatrios
22.5.6 Como Criar Relatrios Imprimindo somente
Mdias de Valores a cada 5 Minutos
Para isto, deve-se criar um novo grupo no Relatrio. O grupo criado tem uma
Seo Header e uma Seo Footer. O layout geral o seguinte:

PageHeader: Contm o titulo das colunas

GroupHeader: Permanece vazio, porm a sua propriedade DataField tem

o valor igual a "CLng(E3TimeStamp*288)", pois E3TimeStamp a data e
hora do dado no formato gregoriano (dias desde 1/1/1900), sendo a
parte inteira o nmero de dias e a parte fracionria as horas e os
minutos. Multiplicando por 288 tem-se um nmero inteiro correspondente
ao total de cinco minutos desde 1/1/1900. A funo CLng converte para
um nmero inteiro de 32 bits eliminando a parte fracionria, de modo
que no apaream os minutos e segundos intermedirios. O grupo
criado vai ser impresso cada vez que este nmero inteiro mudar, ou seja,
a cada cinco minutos. Verifique as propriedades NewColumn e
NewPage, que devem estar configurados para 0 - ddNPNone

Detail: Contm os Campos de Dados para os campos da tabela. A

propriedade Visible est em Falso, de modo que cada uma das
aquisies que compem a mdia de cinco minutos so computadas,
porm no impressas

GroupFooter: Contm os seguintes campos, que representam as mdias

dos Campos de Dados:

DataField: Nomes dos campos da tabela (o mesmo que na Seo

Detail)

SummaryFunc: 1 - ddSFAvg

SummaryRunning: 1 - ddSRGroup

SummaryType: 1 - ddSGrandTotal

A nica exceo para Data/Hora, que um Campo de Dados padro com a

propriedade DataField igual a "=CLng(E3TimeStamp*288)/288".

ReportFooter: Em branco (ou outro valor qualquer)

Relatrios 765
Se a consulta for entre a zero hora de um dia e outro, o resultado
composto por 288 linhas impressas com a mdia dos campos a cada cinco
minutos.

766 Relatrios
 CAPTULO
Segurana
23
Atravs desta opo, possvel controlar o acesso a Domnios, Viewers, Telas
e Alarmes em uma lista de usurios e grupos. Conforme a opo configurada,
a aplicao permite ou no o acesso aos usurios cadastrados.

As permisses de acesso so configuradas por usurio ou por grupos de

usurios. Os grupos podem ser criados contendo apenas usurios ou
tambm outros grupos.

Para acessar as configuraes de usurios, grupos ou permisses, siga este

procedimento:

1. Clique no menu Arquivo - Usurios para mostrar uma caixa de dilogo

para configurao das permisses, dos usurios e dos grupos na
aplicao.

Segurana 767
 Janela Permisses de Usurio

768 Segurana
23.1 Usurios
Atravs da aba Usurios possvel configurar as informaes referentes aos
usurios que tm ou no acesso aplicao. Para utilizar este recurso, clique
no menu Arquivo - Usurios e selecione a aba Usurios.

Aba Usurios

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Usurios

Segurana 769
 OPO DESCRIO
Nome Indica o usurio corrente

Novo Cria um novo usurio

Editar Edita as propriedades do usurio

selecionado

Remover Remove o usurio selecionado

Grupos disponveis Mostra os grupos de usurios

disponveis na aplicao

Pertence a Mostra os grupos aos quais o

usurio pertence

Adicionar Adiciona grupos da lista Grupos

disponveis para a lista Pertence a

Remover Remove grupos da lista Pertence a

770 Segurana
Ao clicar em Novo ou Editar, a caixa de dilogo da figura a seguir
mostrada.

Segurana 771
 Adicionando usurios na aplicao

As opes disponveis nesta janela esto descritas na tabela a seguir.

772 Segurana
 Opes disponveis na janela Adicionar usurios

OPO DESCRIO
Nome Determina o nome do usurio

Autenticao do Windows Esta opo permite adicionar um

usurio existente no domnio de rede
do Windows. O nome do usurio
deve estar no formato DOMNIO
\USURIO. Ao selecionar esta opo,
todas as demais opes da janela
ficam desabilitadas, exceto Este
usurio um administrador e Esta
conta est desabilitada

Autenticao do E3 Esta opo cria o usurio no

Domnio corrente do E3

Senha Determina a senha do usurio. Veja

a nota a seguir

Confirme a senha Confirmao da senha anteriormente

informada. Veja a nota a seguir

Nome completo Determina o nome completo do

usurio

Este usurio um administrador Habilita o usurio como

administrador

O usurio no pode alterar sua O usurio no pode alterar sua

senha senha, pois somente o administrador
pode executar esta tarefa

Segurana 773
 OPO DESCRIO
A senha expira aps ... dias Determina o prazo de validade da
senha do usurio. Quando a data de
expirao estiver prxima,
mostrado um lembrete para renovar
a senha. Caso deseje renov-la, uma
caixa de dilogo aberta para que o
usurio configure a senha. Se a
senha expirar antes do usurio
renov-la, no mais possvel
executar o login, e a opo Esta
conta est bloqueada habilitada
automaticamente. Esta condio
persiste at que um administrador
desbloqueie a senha manualmente

A senha deve conter no mnimo ... Determina um nmero mnimo de

caracteres caracteres para a senha do usurio

A senha deve conter letras e Determina que a senha deve conter

nmeros letras e nmeros

A senha deve conter no mnimo ... Determina um nmero mnimo de

nmeros nmeros para a senha do usurio

A senha deve conter no mnimo ... Determina um nmero mnimo de

letras letras para a senha do usurio

A senha deve conter letras Determina que a senha deve conter

maisculas e minsculas letras maisculas e minsculas

Esta conta est desabilitada Indica que a conta est desabilitada

Esta conta est bloqueada Indica que a conta do usurio est

bloqueada. Esta opo habilitada
automaticamente caso a senha do
usurio expire ou se o usurio digitar
a senha errada vrias vezes

774 Segurana
 OPO DESCRIO
O usurio deve trocar a senha no Indica que o usurio deve trocar sua
prximo login senha quando executar o prximo
login

Validar senhas sem diferenciar Permite a validao de senhas,

maisculas e minsculas independente de seus caracteres
serem digitados em maisculas ou
minsculas. Esta opo no
recomendada

Segurana 775
NOTA
No caso da edio de um usurio existente, modificar o campo Senha
implica em limpar o contedo do campo Confirme a senha e vice-versa,
mas apenas na primeira vez em que se edita qualquer um destes campos.

Ao efetuar o login do usurio (pelo mtodo Login do Viewer ou pelo menu

Arquivo - Login), abre-se a caixa de dilogo da figura a seguir.

Janela de login

Ao selecionar o modo de autenticao Windows, os campos Nome do

usurio e Senha so desabilitados e preenchidos com o nome e a senha do
usurio logado no domnio de rede. Para selecionar outro usurio
pertencente ao domnio de rede, clique em Outro usurio. Selecionando o
modo de autenticao E3, preencha as informaes de usurio e senha de um
usurio do Domnio do E3 nos campos Nome do usurio e Senha,
respectivamente.

Quando a opo Este usurio um administrador habilitada para um

usurio, este usurio pode, em tempo de execuo, alterar todas as
configuraes mostradas na aba Usurios.

776 Segurana
Estes privilgios so acessados via script atravs do mtodo
UserAdministration do Viewer, que habilita a caixa de dilogo dos usurios
em tempo de execuo.

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

Ao clicar em Remover, a aplicao mostra uma caixa de mensagem

questionando se realmente deseja-se remover o usurio.

possvel que um usurio pertena a um grupo, podendo assim compartilhar

as configuraes deste grupo. Para tanto, na lista Grupos disponveis so
mostrados os grupos disponveis na aplicao que podem conter o usurio
selecionado, e na lista Pertence a, a lista dos grupos aos quais o usurio
selecionado j pertence. Para adicionar um usurio a um grupo, siga estes
procedimentos:

1. Selecione o usurio que deseja inserir no grupo especfico.

2. Na lista Grupos disponveis, selecione o grupo ao qual o usurio vai

pertencer.

3. Clique em Adicionar para adicionar o grupo, que aparece na lista

Pertence a.

4. Para remover o grupo, selecione-o na lista Pertence a e clique em

Remover.

Segurana 777
23.2 Grupos
A aba Grupos permite que sejam configuradas as informaes referentes aos
grupos. Cada grupo define caractersticas que so comuns para todos os
seus membros. Um grupo tambm pode pertencer a outros grupos. S no
permitido pertencer a outro grupo que j pertena a ele, ou seja, criar uma
referncia circular.

Para utilizar este recurso, clique no menu Arquivo - Usurios e selecione a

aba Grupos.

778 Segurana
 Aba Grupos

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Grupos

OPO DESCRIO
Nome Indica o grupo corrente

Novo Cria um novo grupo

Segurana 779
 OPO DESCRIO
Editar Edita as propriedades do grupo
selecionado

Remover Remove o grupo selecionado

Grupos disponveis Mostra os grupos disponveis na

aplicao

Pertence a Mostra os grupos aos quais o grupo

selecionado pertence

Adicionar Adiciona grupos da lista Grupos

disponveis na lista Pertence a

Remover Remove grupos da lista Pertence a

780 Segurana
Ao clicar em Novo ou Editar, a caixa de dilogo da figura a seguir
mostrada.

Adicionar grupo

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Adicionar Grupos

OPO DESCRIO
Nome do grupo Determina o nome do grupo

O usurio no pode alterar sua O usurio no pode alterar sua

senha senha, pois somente o administrador
pode executar esta tarefa

Segurana 781
 OPO DESCRIO
A senha expira aps ... dias Determina o prazo de validade da
senha do usurio

A senha deve conter no mnimo ... Determina um nmero mnimo de

caracteres caracteres para a senha do usurio

A senha deve conter letras e Determina que a senha deve conter

nmeros letras e nmeros

A senha deve conter no mnimo ... Determina um nmero mnimo de

nmeros nmeros para a senha do usurio

A senha deve conter no mnimo ... Determina um nmero mnimo de

letras letras para a senha do usurio

A senha deve conter letras Determina que a senha deve conter

maisculas e minsculas letras maisculas e minsculas

Validar senhas sem diferenciar Permite a validao de senhas,

maisculas e minsculas independente de seus caracteres
serem digitados em maisculas ou
minsculas

782 Segurana
Ao clicar em Remover, a aplicao mostra uma caixa de mensagem
perguntando se realmente deseja-se excluir o grupo selecionado.

possvel que um grupo de usurios pertena a outro, podendo assim

compartilhar as configuraes. Para tanto, na lista Grupos disponveis so
mostrados os grupos disponveis na aplicao que podem conter o grupo
selecionado, e no item Pertence a, a lista dos grupos aos quais o grupo
selecionado pertence. Para adicionar um grupo a outro especfico, siga estes
procedimentos:

1. Selecione o grupo que deseja inserir em um grupo especfico.

2. Na lista Grupos disponveis, selecione o grupo ao qual o grupo vai

pertencer.

3. Clique em Adicionar para adicionar o grupo, que aparece na lista

Pertence a.

4. Para remover o grupo, selecione-o na lista Pertence a e clique em

Remover.

NOTA
importante verificar a hierarquia entre usurios e grupos. Se o usurio tem
uma opo desabilitada, mas esta mesma opo est habilitada no grupo,
vale a opo do usurio, que possui este item desabilitado. A opo do
grupo s respeitada se a mesma opo do usurio estiver marcada como
neutra.

Segurana 783
23.3 Permisses
A aba Permisses permite configurar as permisses dos usurios e grupos
para Domnios, Viewers, Telas e Alarmes. Uma verificao de permisso
consiste em uma informao que um membro de um grupo tem sobre um
comando que atua sobre um objeto especfico.

Aba Permisses

As opes disponveis nesta aba esto descritas na tabela a seguir.

784 Segurana
 Opes disponveis na aba Permisses

OPO DESCRIO
Usurios/Grupos Esta opo lista os usurios ou
grupos de usurios configurados na
aplicao

Itens para segurana Os itens para segurana disponveis

so:

Telas: Permite ao usurio habilitar

ou desabilitar o acesso s Telas. Em
uma aplicao, todos os usurios
ou grupos tm acesso Tela de
abertura

Alarmes: Habilita ou desabilita o

reconhecimento de alarmes e a
remoo de alarmes desvinculados
para o usurio ou grupo. Em um
projeto, possvel exibir as
informaes de alarmes para vrios
assinantes das informaes atravs
de um objeto de visualizao em
Tela, como por exemplo o E3Alarm

Domnios: Permite configurar

permisses para executar, parar ou
editar um Domnio e ter acesso
remoto a um Domnio, entre outras
permisses

Viewer: Permite ao usurio utilizar o

Viewer em modo Viewer Full ou
Viewer Only, de acordo com suas
configuraes

Usurios um filtro das opes de

configurao. Habilitando esta opo,
possvel visualizar somente os
usurios cadastrados na aplicao

Segurana 785
 OPO DESCRIO
Grupos um filtro das opes de
configurao. Habilitando esta opo,
possvel visualizar somente os
grupos cadastrados na aplicao

Permisses Mostra as permisses dos usurios

ou grupos quanto aos itens de
segurana (Domnios, Viewers, Telas e
Alarmes)

Desabilitar a verificao de Desabilita qualquer verificao de

permisses permisses. Veja a nota a seguir
sobre o comportamento desta opo

NOTA
A opo Desabilitar a verificao de permisses deve ser utilizada com
cuidado, pois implica nos seguintes comportamentos:
O login sempre funciona, mesmo que a senha esteja errada ou que seja
utilizado um nome de usurio inexistente
As aes sempre so permitidas, mesmo para usurios annimos

Para cada item de segurana existe uma srie de permisses que podem ser
configuradas para cada usurio ou grupo. As opes disponveis esto
descritas nas tabelas a seguir.

Opes disponveis para Telas

OPO DESCRIO
Abrir Tela Habilita a abertura de Telas

Opes disponveis para Alarmes

OPO DESCRIO

786 Segurana
Reconhecer alarme Habilita o reconhecimento de
alarmes

Remover alarmes desvinculados Habilita a remoo de alarmes no

vinculados Fontes de Alarme

Opes disponveis para Domnios

OPO DESCRIO
Executar Domnio Habilita a execuo de um Domnio

Parar Domnio Para o Domnio

Editar Domnio Habilita a edio de um Domnio

Executar como servio Habilita a execuo do Domnio

como um servio

Configurar usurios/grupos Permite configurar usurios e grupos

de usurios

Acesso remoto ao Domnio Habilita o acesso remoto a um

Domnio

Acesso remoto de escrita ao Habilita o acesso remoto de escrita a

Domnio um Domnio

Opes disponveis para Viewers

OPO DESCRIO
Acesso de escrita ao servidor Habilita o acesso de escrita ao
servidor

Segurana 787
Cada item da lista de permisses pode estar configurado com um dos
estados da tabela a seguir.

Opes da lista de permisses

CONE ESTADO DESCRIO

Permitido O comando selecionado
na lista de permisses
permitido para o
usurio ou grupo
selecionado,
independente dos
grupos aos quais ele
pertence

No permitido O comando selecionado

na lista de permisses
no permitido para o
usurio ou grupo
selecionado,
independente dos
grupos aos quais ele
pertence

Permitido pelo grupo O comando selecionado

na lista de permisses
permitido para o
usurio ou grupo
selecionado, se ele for
permitido nos grupos
aos quais o usurio ou
grupo pertence

788 Segurana
 CONE ESTADO DESCRIO
No permitido pelo O comando selecionado
grupo na lista de permisses
no permitido para o
usurio ou grupo
selecionado, se ele no
for permitido em pelo
menos um dos grupos
aos quais o usurio ou
grupo pertence

No informado O usurio ou grupo

selecionado utiliza as
definies dos grupos
aos quais pertence e
no h nada informado
nos grupos. Portanto, o
comando permitido

NOTA
Para configurar os estados possveis para cada item de segurana na lista
de permisses, pode-se utilizar as seguintes opes:
Clique com o boto direito do mouse no item ou use a combinao de
teclas SHIFT + F10, que corresponde tecla de aplicao ou de menu ,
para selecionar uma das opes, Permitir comando, No permitir
comando ou Usar a informao do grupo.
Clique duas vezes no item ou utilize a barra de espao do teclado para
alternar entre os estados Permitido, No permitido ou No informado.

No caso de Telas, possvel que a configurao de permisso seja realizada

por Tela especificamente. No caso de Alarmes, esta configurao pode ser
realizada por rea.

Segurana 789
NOTA
Em uma aplicao, todos os usurios tm acesso Tela de abertura. Caso
deseje que a aplicao sempre inicie com a tela de login do usurio, crie um
usurio sem permisso especfica na Tela inicial. Assim, toda vez que for
iniciada a aplicao, pede-se o login do usurio e aps, mostra-se a Tela de
abertura.

Com relao a permisses para um usurio annimo, devem ser observadas

as seguintes situaes:

Se no h usurio criado, a verificao de permisses no est habilitada

ou no h usurio com restrio para uma determinada operao, ento
no exigida identificao (o usurio logado como annimo)

Se h usurio criado, a verificao est habilitada e h pelo menos um

usurio que no possa executar determinada operao, ento para esta
operao exigida identificao (no permitido o acesso como usurio
annimo)

NOTA
A nomenclatura e descrio das opes de restrio podem ser acessadas
atravs da opo Legenda.

Caso haja alguma restrio para executar, parar, editar um Domnio ou

configurar os usurios ou grupos, necessrio que um usurio esteja logado
no E3. Para tanto, utilizam-se as opes Login ou Logout, disponveis no
menu Arquivo.

790 Segurana
 Login ou Logout do usurio

A opo Login abre uma caixa de dilogo para o login no E3 Studio. O

usurio permanece logado at que seja realizado outro login ou logout.

A opo Logout executa o logout no E3 Studio. Caso no haja um usurio

logado, esta opo est desabilitada.

Segurana 791
23.4 Proteo de Arquivos
Protege o contedo de um arquivo .prj ou .lib contra a edio, visualizao ou
execuo no autorizada. Para utilizar este recurso, siga estes procedimentos:

1. Clique com o boto direito do mouse no nome do projeto ou da

biblioteca no modo Explorer e selecione a opo Proteo. No modo
Domnio, clique com o boto direito do mouse no nome do projeto ou
da biblioteca, no item Configurao - Arquivos, e selecione a opo
Proteo.

2. A caixa de dilogo a seguir mostrada.

792 Segurana
 Proteo de arquivos

Esta janela possui dois tipos de proteo: Proteo de Edio e Proteo de

Execuo.

Proteo de Edio: Protege o arquivo contra alteraes e visualizaes

no autorizadas. Este recurso utilizado para evitar que determinada
biblioteca ou projeto seja alterado acidentalmente, ou que sejam
copiados procedimentos de conhecimento especfico do desenvolvedor

Segurana 793
 A opo Adicionar proteo permite configurar uma senha de
proteo para a aplicao

Adicionar proteo

A opo Alterar senha altera a senha de proteo do E3 Studio para o

arquivo

Alterao de senha de proteo

A opo Remover proteo remove a proteo de edio deste

arquivo. Para isto, clique nesta opo, digite a senha e clique em OK
para que a aplicao abra uma caixa de mensagem informando se a
ao foi executada corretamente

794 Segurana
 Proteo de Execuo: Esta opo utilizada para proteger o arquivo
contra execuo no autorizada. Para isto, necessrio solicitar a
gravao de uma senha no dispositivo de proteo, que realizada pela
Elipse Software. Isto protege o desenvolvedor de cpias no autorizadas
do projeto, por exemplo. Para isto, no momento do pedido de licena do
E3 Server, necessrio fornecer a senha de execuo. Este processo
realizado posteriormente compra do servidor

A opo Adicionar proteo permite configurar uma senha de

proteo para a aplicao

Adicionar proteo

A opo Alterar senha altera a senha de proteo de execuo para o

arquivo

Alterao de senha de proteo

Segurana 795
 A opo Remover proteo permite remover a proteo de execuo
deste arquivo. Para isto, clique na opo, digite a senha e clique em OK
para que a aplicao abra uma caixa de mensagem informando se a
ao foi executada corretamente

Quando um arquivo .lib ou .prj aberto no E3 Studio, este inicializa

mostrando um cone cinza , com um cadeado indicando que est protegido
e seu contedo no pode ser acessado. Para acessar o contedo do arquivo,
clique com o boto direito do mouse no projeto ou biblioteca e selecione a
opo Abrir com senha. Aps informar a senha e a aplicao liberar o
acesso, o cone muda para colorido , indicando a acessibilidade dos
arquivos.

O contedo de arquivos .prj e .lib protegidos criptografado. Quando um

projeto protegido, as propriedades DocString e Domain so bloqueadas.

IMPORTANTE
As protees implementadas no podem ser desfeitas caso as senhas sejam
perdidas. Portanto, ao proteger um arquivo, mantenha as senhas
armazenadas em local seguro. Isto garante que possvel usar o arquivo
sempre que necessrio.

796 Segurana
 CAPTULO
E3 Viewer e E3 WebViewer
24
O E3 Viewer o ambiente de visualizao do E3. Nele, possvel visualizar a
execuo da aplicao feita no E3 Studio.

O E3 WebViewer um componente ActiveX que faz o navegador comportar-

se como o E3 Viewer, o que permite a visualizao e controle de aplicaes
E3 via Internet. Desta forma, possvel visualizar e interagir com um processo
de cho de fbrica atravs de um navegador web comum. O navegador pode
estar em qualquer computador da rede que tenha acesso ao E3 Server.

Depois de instalado, o E3 WebViewer vai funcionar exatamente como o E3

Viewer, executando o download da aplicao (Telas, bitmaps, etc.) para a
mquina local. Todas as funcionalidades do E3 Viewer (E3Chart, E3Alarm, etc.)
so suportadas pelo E3 WebViewer.

E3 WebViewer em execuo (visualizao de uma aplicao)

E3 Viewer e E3 WebViewer 797

NOTA
Tanto o E3 Viewer quanto o E3 WebViewer aceitam as mesmas opes de
zoom descritas no tpico Zoom do captulo Telas e Objetos de Tela. Alm
disto, a qualidade grfica das Telas pode ser modificada, em tempo de
execuo, utilizando-se o menu contextual tanto do E3 Viewer quanto do E3
WebViewer e selecionando uma das opes do menu Qualidade (todas as
telas). Para maiores informaes, veja a propriedade RenderQuality do
Viewer no Manual de Referncia e Scripts do E3.

798 E3 Viewer e E3 WebViewer

24.1 Viewer Only (Modo Somente Leitura)
O modo Viewer Only (modo Somente Leitura, ou de acesso restrito) uma
maneira de controlar o acesso que o Viewer tem ao servidor (Domnio), em
oposio ao modo Viewer Full, que no possui restries de acesso.

Atravs da configurao da permisso de usurios (captulo sobre

Segurana), e de acordo com o tipo de licena de Viewer em uso (captulo
sobre Domnios), o servidor determina se o Viewer est no modo Full
(normal) ou Only (restrito). Quando ele est no modo Only, so aplicadas
diversas restries quanto s aes que podem ser escritas no servidor.
Neste modo esto bloqueados (seja por erro de script ou por gerar
mensagem de erro):

Escritas em geral em propriedades de objetos do servidor atravs do

Viewer por Associaes

Escritas em geral em propriedades de objetos do servidor atravs de

scripts do Viewer

Mtodos SetValue e ToggleValue do Viewer (incluindo-se a os Picks

Carregar e Inverter Valor)

Chamadas de mtodos de objetos do servidor atravs de scripts do

Viewer (excees a seguir)

Administrao de usurios atravs do Viewer (uso do mtodo

UserAdministration do Viewer)

Reconhecimento de alarmes pelo E3Alarm

Uso dos mtodos LoadFormulaDlg, LoadFormulaValues e

LoadFormulaValuesQuiet do Viewer

Permanecem permitidos neste modo:

Leituras de propriedades de objetos do servidor, tanto por Associaes

como por scripts

Chamadas de mtodos considerados no restritos de objetos do

servidor em scripts do Viewer:

E3 Viewer e E3 WebViewer 799

 Item (todos os objetos)

Refresh (Grupo OPC)

FindUnit, FindValue, GetValueData e GetUnitData (Frmula)

GetAlarm (Fonte de Alarmes)

GetE3QueryFields, GetADORecordSet e GetAsyncADORecordSet

(Consulta)

GetObject (Servidor de Aplicaes)

Mudanas do estado de Advise de Tags do servidor

Mudana da prpria senha (mtodo ChangePassword do Viewer)

800 E3 Viewer e E3 WebViewer

24.1.1 Mudanas no Modo do Viewer
Para que o usurio acesse o E3 no modo Somente Leitura, pelo menos uma
destas duas condies deve ser verdadeira:

Licena em uso do tipo Viewer Only

Usurio logado sem permisso para o item Acesso de escrita ao

servidor

importante lembrar que, no caso de no haver usurio logado no Viewer

(usurio annimo), aplicada a restrio de acesso, desde que pelo menos
um ou mais usurios tenham esta restrio.

Desta forma, cada vez que ocorre uma mudana de usurio o modo de
acesso do Viewer pode ser mudado (e consequentemente a propriedade
IsReadOnly), de acordo com a combinao do que permitido pela licena
em uso e a permisso do usurio logado.

A mudana do modo de acesso tambm pode acontecer caso ocorra a

reconexo do Viewer, j que esta pode provocar tanto a mudana de licena
(de Viewer Full para Viewer Only, ou vice-versa) quanto a mudana das
permisses do usurio logado.

Caso haja algum usurio com acesso de escrita ao servidor bloqueado no

momento da abertura do Viewer, este entra automaticamente no modo
Somente Leitura, independente da licena em uso, j que o usurio annimo
sempre assume a restrio mxima configurada.

24.2 Execuo do E3 Viewer

Existem trs formas de se executar o E3 Viewer: atravs de um servidor local,
de um servidor na intranet, ou de um servidor na Internet. Os tpicos a seguir
detalham estas formas.

E3 Viewer e E3 WebViewer 801

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

Barra de Ferramentas Padro

Executar Aplicativo: Salva todas as configuraes do projeto, executa

o Domnio e o E3 Viewer

Rodar/Parar Domnio: Executa ou para a execuo do Domnio

Executar/Parar E3 Viewer: Executa o E3 Viewer ou para a sua

execuo caso ele j esteja aberto

Quando o E3 Viewer executado, a aplicao mostra a janela a seguir,

indicando o estado da conexo.

Mensagem de estado de conexo

Quando a conexo com o servidor perdida, o E3 tenta restabelec-la

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

802 E3 Viewer e E3 WebViewer

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

O argumento nome_do_servidor representa o nome da mquina onde o E3

Server est executando. Se este argumento no for informado, uma caixa de
dilogo mostrada perguntando o caminho do servidor da aplicao, como
ocorre quando o E3 Viewer executado a partir do menu Iniciar (como
mostrado no prximo tpico).

As opes de configurao para a linha de comando so as seguintes:

-screen ou /screen: Permite ao usurio informar uma Tela inicial vlida,

diferente da Tela inicial configurada no Domnio
Viewer [nome_do_servidor] screen <nome_da_tela>

-noping ou /noping: Descarta a necessidade de se executar um

comando ping para o servidor antes da tentativa de conexo (tentativa
de conexo direta)
Viewer [nome_do_servidor] noping

-readonly ou /readonly: Permite ao usurio especificar que o Viewer

deve tentar conectar apenas no modo Somente Leitura. Quando isto for
realizado, o Viewer sempre utiliza uma licena do tipo Viewer Only
Viewer [nome_do_servidor] readonly

-cachepath ou /cachepath: Permite especificar um diretrio para a

gravao do cache do Viewer. Se no for especificado, usado o
diretrio temporrio do sistema (varivel de ambiente TEMP)
Viewer [nome_do_servidor] cachepath <diretorio>

E3 Viewer e E3 WebViewer 803

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

-params: Permite que o usurio especifique parmetros de inicializao

do Viewer. Esta opo no pode vir imediatamente antes da lista de
servidores. Os valores passados nesta opo podem ser recuperados via
script utilizando a propriedade Params do Viewer. Para maiores
informaes sobre a utilizao desta propriedade, veja o captulo Viewer
no Manual de Referncia e Scripts do E3
Viewer -params <Nome1>=<Valor1> [<Nome2>=<Valor2>] ...

-help: Mostra uma caixa de dilogo com exemplos de uso das opes de
linha de comando do Viewer, como na figura a seguir

804 E3 Viewer e E3 WebViewer

 Caixa de dilogo de ajuda do Viewer

E3 Viewer e E3 WebViewer 805

24.2.3 Atravs do Menu Iniciar
Para executar uma aplicao cliente, pode-se utilizar o E3 Viewer, disponvel
no menu Iniciar (Start) - Programas (Programs) - Elipse E3 - Viewer.

O E3 ento mostra a seguinte caixa de dilogo para que o caminho do

servidor da aplicao seja informado.

E3 Viewer

Se o E3 Server estiver na mesma mquina do E3 Viewer, selecione a opo

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

806 E3 Viewer e E3 WebViewer

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

Pelo menu Iniciar - Programas - Elipse Software - Elipse Event Log -

Log Viewer

Pelo menu Ferramentas - Log Viewer do E3 Studio

Pelo item Atalhos - Log Viewer do menu do E3 Admin na rea de

Notificao do Windows

E3 Viewer e E3 WebViewer 807

24.4 Execuo do E3 WebViewer
Durante a instalao do E3 WebViewer, os arquivos e3web.asp, e3web2.asp,
docwrite.asp, docwrite2.asp e e3downloader.cab ficam disponveis para
configurao pelo usurio. Estes arquivos ficam localizados no diretrio onde
o E3 foi instalado, na pasta Web.

e3web.asp e docwrite.asp: Tm a funo de carregar e iniciar o ActiveX

E3Downloader

e3downloader.cab: ActiveX que enviado para a mquina cliente e

executa a instalao do e3webviewer-x86-ptb.exe

e3web2.asp e docwrite2.asp: Tm a funo de carregar e iniciar o

ActiveX do WebViewer que mostra a aplicao sendo executada na
mquina do Internet Explorer

A pgina docwrite2.asp vem configurada considerando-se que o E3 Server

est executando no mesmo computador que o servidor web. Porm,
possvel alterar o cdigo fonte desta pgina para atender configurao
desejada. Para isto, altere a linha a seguir no arquivo docwrite2.asp:
var Domain = getDomain();

Para o seguinte cdigo:

var Domain = "IP externo do servidor IIS";

Caso se queira permitir ao usurio informar uma Tela inicial vlida, diferente
da configurada no Domnio, deve-se alterar o parmetro Screen no arquivo
docwrite2.asp, colocando em Nome_da_Tela um nome de Tela vlido na
aplicao. Exemplo:
<param name="Screen" value="Nome_da_tela">

Caso se queira informar a necessidade de se executar o comando ping para

o servidor antes de tentar a conexo, deve-se alterar o parmetro Ping no
arquivo docwrite2.asp. O valor pode ser "True" ou "False". Exemplo:
<param name="Ping" value="True">

808 E3 Viewer e E3 WebViewer

Se esta linha for omitida, o comando ping executado.

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

alterar o parmetro CachePath no arquivo docwrite2.asp. Se no for
especificado, usado o diretrio temporrio do sistema (varivel de
ambiente TEMP). Exemplo:
<param name="CachePath" value="diretorio_para_cache">

Caso seja preciso que o WebViewer procure por outros servidores na rede se
no conseguir conectar ao servidor especificado no parmetro Domain, deve-
se alterar o parmetro UseServers no arquivo docwrite2.asp. Se o parmetro
no for informado, o WebViewer tenta se conectar apenas ao servidor
especificado no parmetro Domain, que o comportamento padro do
WebViewer (valor "True"). A alterao do valor para "False" s funciona para
servidores e WebViewers que estejam na mesma rede. Exemplo:
<param name="UseServers" value="False">

A configurao do E3 WebViewer para abrir no modo Somente Leitura

realizada atravs do parmetro StartReadOnly, com os valores "True" ou
"False", no arquivo docwrite2.asp. Se este item no existir, o valor assumido
"False" (comportamento compatvel com verses anteriores). Exemplo:
<param name="StartReadOnly" value="False">

Em ambos os casos, esta configurao s tem efeito na abertura do E3

WebViewer. Se o parmetro for mudado durante a execuo, a conexo ou
reconexo do E3 WebViewer no afetada.

Para se navegar para uma pgina diferente do padro aps o carregamento

do E3 WebViewer, deve-se modificar o atributo value do parmetro
URLToLoad do arquivo docwrite.asp para o endereo desejado. Exemplo:
<param name="URLToLoad" value="URL">

Se esta linha for omitida, a pgina e3web2.asp carregada.

E3 Viewer e E3 WebViewer 809

Para especificar se o instalador do E3 WebViewer deve ou no instalar o
ActiveX Control Pad (MS Forms), deve-se modificar o parmetro InstallACP do
arquivo docwrite.asp com os valores "True" ou "False", respectivamente. Se
este item no existir, o valor assumido "True" (o ActiveX Control Pad
instalado). Exemplo:
<param name="InstallACP" value="True">

NOTA
Caso o parmetro InstallACP esteja configurado com o valor "False", as Telas
da aplicao que utilizem MS Forms podem apresentar erros durante o
carregamento, se os objetos MS Forms no tenham sido previamente
instalados por outros aplicativos, como por exemplo o Microsoft Office.

Os servidores e o E3 WebViewer podem tanto executar na mesma mquina

quanto em mquinas diferentes. Os tpicos a seguir mostram como estas
situaes se aplicam.

810 E3 Viewer e E3 WebViewer

24.4.1 Internet Information Services
Tanto para a visualizao na Internet como para visualizao em Intranet ou
mquina local, necessria a instalao e configurao do IIS (Internet
Information Services), ou outro servidor de Internet.

O IIS fornecido juntamente com o Windows. Para instal-lo e configur-lo,

siga estes procedimentos:

1. Abra o menu Iniciar - Painel de Controle (Start - Control Panel) no

Windows Server 2003 SP2, Windows XP SP3, Windows Vista SP2 e
Windows 7 SP1, ou abra o item Aplicativos - Sistema do Windows -
Painel de Controle (Apps - Windows System - Control Panel) na tela Inicial
do Windows 8 e Windows 8.1. No Windows 10, clique com o boto
direito do mouse no menu Iniciar (Start) e selecione o item Painel de
Controle (Control Panel).

2. Clique em Adicionar ou remover programas (Add or remove programs)

no Windows Server 2003 SP2 e Windows XP SP3, ou clique em
Programas e Recursos (Programs and Features) no Windows Vista SP2,
Windows 7 SP1, Windows 8, Windows 8.1 e Windows 10.

3. Clique em Adicionar ou remover componentes do Windows (Add or

remove Windows component) no Windows Server 2003 SP2 e Windows XP
SP3, ou clique em Ativar ou desativar recursos do Windows (Turn
Windows features on or off) no Windows Vista SP2, Windows 7 SP1,
Windows 8, Windows 8.1 e Windows 10.

E3 Viewer e E3 WebViewer 811

 Servios de Informaes da Internet

4. No Windows Server 2003 SP2 e Windows XP SP3, selecione na lista o

item Servios de Informaes da Internet (Internet Information Services) e
clique em Avanar (Next).

5. No Windows Vista SP2, Windows 7 SP1, Windows 8, Windows 8.1 e

Windows 10, localize na lista o item Servios de Informaes da Internet
(Internet Information Services) e clique em para expandir todos os seus
subitens.

6. Selecione, no mnimo, as opes a seguir e clique em OK.

Ferramentas de Gerenciamento da Web (Web Management Tools)

Console de Gerenciamento do IIS (IIS Management Console)

Scripts e Ferramentas de Gerenciamento do IIS (IIS Management Scripts

and Tools)

812 E3 Viewer e E3 WebViewer

 Servio de Gerenciamento do IIS (IIS Management Service)

Servios da World Wide Web (World Wide Web Services)

Recursos de Desenvolvimento de Aplicativos (Application Development

Features)

ASP

Extenses ISAPI (ISAPI Extensions)

Filtros ISAPI (ISAPI Filters)

Recursos Http Comuns (Common Http Features)

Contedo Esttico (Static Content)

Documento Padro (Default Document)

Redirecionamento de HTTP (HTTP Redirection)

Segurana (Security)

Autenticao Bsica (Basic Authentication)

Filtragem de Solicitaes (Request Filtering)

7. O IIS inicia a instalao (para instalar o IIS preciso ter o CD de instalao

no Window Server 2003 SP2 e Windows XP SP3).

8. Aguarde a finalizao do processo para configurar o IIS.

Aps a instalao do IIS, os arquivos e3web.asp, e3web2.asp, docwrite.asp,

docwrite2.asp e e3downloader.cab devem ser copiados para C:\InetPub
\wwwroot. Esta pasta criada na instalao do IIS. Alm dos arquivos .asp, o
instalador do E3 WebViewer tambm deve ser copiado para esta mesma
pasta. Este instalador (e3webviewer-x86-ptb.exe) utilizado quando a
mquina cliente acessar o servidor pela primeira vez, caso o E3 no tenha
sido previamente instalado nesta mquina. Este arquivo pode ser obtido
atravs de download no site da Elipse.

E3 Viewer e E3 WebViewer 813

O IIS ainda necessita ser configurado para seu correto funcionamento. A
configurao diferente caso o IIS e o E3 Server estejam na mesma mquina
ou em mquinas diferentes. Para configur-lo, consulte o Guia de Instalao
do E3, no tpico Instalao do E3 WebViewer.

814 E3 Viewer e E3 WebViewer

24.4.2 Visualizao na Aplicao Cliente
Se o servidor estiver utilizando o servidor web, por exemplo o IIS, digite na
barra de endereos do browser o endereo ou IP do servidor (por exemplo,
http://nomedoservidor/diretorio_virtual ou http://192.0.0.21/diretorio_virtual),
onde diretorio_virtual o diretrio criado na configurao do IIS (conforme o
Guia de Instalao do E3).

No primeiro acesso ao servidor, o navegador inicia a instalao dos

componentes, caso estes no tenham sido previamente instalados, conforme
explicado no comeo deste captulo. O componente assinado pela Elipse
Software e o usurio deve aceitar a instalao para que se iniciem as
configuraes necessrias.

Instalao do WebViewer

Aps a instalao, o E3 WebViewer est aberto no browser, e visualizando a

aplicao do servidor. Nos prximos acessos no mais necessrio instalar
os componentes e o tempo de conexo mais rpido.

NOTA
A verso do cliente tem que ser a mesma do servidor. Para isto, o instalador
(e3-w2kwebviewer.exe) no servidor deve ser sempre o mais atual.

E3 Viewer e E3 WebViewer 815

 CAPTULO
Hot-Standby
25
O Hot-Standby permite a implementao do conceito de fail-over em um
sistema supervisrio. Este conceito consiste na possibilidade de se ter dois
servidores (principal e backup) atuando um como contingncia do outro, ou
seja, se o servidor principal falhar, um servidor de backup entra em ao
imediatamente, sem perda da continuidade do processo. Este servidor em
espera diz-se que est em Standby.

Assim, a ferramenta de Hot-Standby do E3 tem como objetivo permitir que

um servidor permanea em estado de espera (Standby), aguardando uma
possvel falha de um outro servidor (servidor ativo). A troca de servidor ativo
pode ser manual ou automtica.

A troca manual acionada atravs do menu do E3 Admin na rea de

Notificaes do Windows do computador em Standby (opo Servidor -
Ativar). A troca automtica ocorre quando o servidor em Standby detecta que
o servidor principal no est mais executando. Um servidor pode assumir um
dos seguintes estados:

Servidor em Manuteno: Este estado indicado na configurao do

servidor do Domnio. Um servidor em manuteno no toma parte em
nenhum evento do Domnio

Servidor Ativo: Apenas um servidor pode estar ativo em um Domnio em

um determinado momento. O servidor ativo aquele que est
executando o aplicativo (E3Run)

Servidor Standby: Apenas um servidor pode estar em modo Standby em

um Domnio em um determinado momento. O servidor Standby executa o
E3Run em modo Standby, o aplicativo permanece carregado, apenas
esperando um comando para entrar em operao. O servidor Standby
monitora o servidor ativo e, se este no estiver respondendo, o Standby
ativado

816 Hot-Standby
 Servidor Inativo: Um servidor permanece inativo quando est declarado
no Domnio, mas no est selecionado como servidor principal nem
como backup. Mesmo inativo, este servidor monitora mudanas no
arquivo de Domnio, podendo passar para o estado Ativo ou Standby se
o Domnio for reconfigurado

IMPORTANTE
Para executar uma aplicao redundante no E3, necessrio que todos os
servidores executem a mesma verso do software, e tenham uma cpia local
atualizada dos arquivos do Domnio (arquivos .prj, .lib, etc.). O arquivo .dom,
por sua vez, sincronizado automaticamente pelo E3 Server, isto ,
mudanas realizadas no arquivo .dom em um servidor so automaticamente
copiadas para o arquivo .dom dos outros servidores do Domnio. Para isto,
o arquivo .dom deve obrigatoriamente existir no mesmo caminho em todos
os servidores.

O Hot-Standby usa a conexo REC, portanto ele s funciona se o E3 Server

estiver iniciado nas mquinas envolvidas.

Se o usurio de um E3 Studio ou Hot-Standby administrador da mquina

remota onde o E3 Server est executando, ele pode controlar o servio
remotamente usando o aplicativo services.msc, atravs da opo Action -
Connect to another computer.

Hot-Standby 817
25.1 Configurando
As configuraes que devem ser feitas para implementar o Hot-Standby so
as seguintes:

1. Localize o caminho dos arquivos de Domnio (arquivos .dom, .prj, .lib, etc.)
no computador principal e copie esta pasta para o computador Standby.
Caso tenha sido indicado um outro caminho para os arquivos de Domnio
na opo Pasta raiz dos arquivos do Domnio na aba Servidores, deve-
se utilizar este caminho para a cpia.

2. Os arquivos de bancos de dados devem ser tratados de maneira

diferenciada. Para maiores informaes, veja o tpico Utilizando Bancos
de Dados com Hot-Standby.

3. Clique com o boto direito do mouse no cone do E3 Admin na rea

de Notificaes do Windows e selecione a opo Domnio - Opes.

E3 Admin

4. Na aba Servidores, adicione os servidores principal e backup. Configure

as opes Nome do servidor e Identificao do servidor na rede,
conforme descrito no tpico Domnios - Configuraes de Domnio -
Servidores. Por exemplo:

Nome do servidor: Servidor1

Identificao do servidor na rede: \\Computer1

818 Hot-Standby
5. Na aba Opes, selecione o item Hot-Standby - Habilitar. No campo
Servidor principal, selecione o servidor principal do projeto e, no campo
Servidor de backup, selecione o servidor de backup. O E3 busca o
servidor principal por ordem alfabtica.

6. Defina a opo Endereos para PING de integridade de rede, conforme

especificado no item Endereos para PING de integridade da rede do
tpico Domnios - Configuraes de Domnio - Opes.

7. Habilite a opo Ativar backup em caso de falha local, conforme

especificado no item Ativar backup em caso de falha local do tpico
Domnios - Configuraes de Domnio - Opes.

8. Para confirmar as configuraes, clique em OK.

9. Ao iniciar a execuo do E3 mostrado, na rea de Notificaes do

Windows dos computadores configurados no Hot-Standby, um cone
representado por uma barra amarela circulante , indicando que os
Domnios esto sendo carregados. Aps alguns segundos, o E3
reconhece o computador principal e indica este estado, na rea de
Notificaes do Windows, com um cone representado por uma seta
verde . Este cone determina que este computador est em execuo.
No computador standby mostrado um cone representado por duas
barras amarelas , indicando que este computador est em modo
Standby (modo de espera).

25.2 Executando um Domnio Redundante

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

Este servidor inicia os servidores do Domnio e depois automaticamente

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

Hot-Standby 819
25.3 Parando um Domnio Redundante
Um Domnio pode ser parado por qualquer um dos seus servidores, atravs
do cone na rea de Notificaes do Windows. Selecione a opo
Domnio - Parar e o servidor Ativo e o Standby terminam o processo E3Run.
O Domnio pode ser reiniciado selecionando a opo Domnio - Executar. Se
for selecionada a opo Domnio - Fechar, o Domnio parado e fechado,
ficando os E3 Servers disponveis para executar outros Domnios.

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

25.4 Parando um dos Servidores do Domnio

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

25.5 Tempo de Troca entre Servidores

O tempo padro para o servidor de backup assumir, quando ocorre uma
falha do servidor ativo, de 15 segundos. No entanto, possvel configurar
este tempo atravs do item Tempo para ativao do servidor reserva
(conforme explicado no tpico Opes do Domnio do captulo Domnios).

Este tempo permite que o servidor anterior termine a execuo do aplicativo,

caso a falha seja apenas de rede. O tempo configurado afeta diretamente o
timeout do ping entre os servidores. Se estiver muito baixo (troca em um
segundo, timeout de ping igual a 160 ms), podem ocorrer trocas espontneas
de servidor, causadas por pequenas falhas de rede.

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

Hot-Standby 821
25.7 Utilizando Bancos de Dados com
Hot-Standby
Pode-se ter dois servidores executando separadamente em uma mesma
aplicao. Um deles permanece ativo, enquanto o outro permanece em
estado de espera (standby), aguardando uma possvel falha.

O Hot-Standby garante a continuidade da aplicao, mas quando se utiliza

bancos de dados, tambm preciso garantir a continuidade do acesso
base de dados.

H duas maneiras de resolver este problema. Na primeira, ambas as

aplicaes acessam uma mesma base de dados. Habilita-se o acesso ao
banco de dados na aplicao, configurando o objeto DBServer em ambos
servidores (Principal e Standby) com os mesmos parmetros de localizao do
banco de dados na rede. Para garantir a continuidade do sistema,
importante que a base de dados esteja em uma mquina separada, acessvel
aos dois servidores.

Na segunda maneira, a gravao dos dados feita em bases diferentes.

Neste caso, o ideal ter-se os dois bancos de dados executando localmente,
em ambos os servidores. Assim, garante-se que o acesso ao banco de dados
est sempre disponvel, pois a mquina que executa a aplicao tambm
executa o banco de dados.

Uma opo interessante neste caso a sincronizao entre as diferentes

bases de dados da aplicao principal e secundria. A propriedade
EnableSynchronization do objeto DBServer habilita este recurso na aplicao.
Quando ela est ativa, todos os dados gravados na base principal so
atualizados na base em Standby quase instantaneamente.

NOTA
Se a aplicao principal no conseguir enviar os dados para o servidor em
Standby, estes dados permanecem armazenados localmente em disco, para
posterior envio quando a comunicao entre os dois computadores for
restabelecida, assegurando assim a igualdade entre as tabelas geradas pela
aplicao.

822 Hot-Standby
CAPTULO
Configuraes Avanadas
26
Existem configuraes do E3 que podem ser realizadas diretamente no
Registro do Windows, embora esse procedimento no seja aconselhvel. A
Elipse Software possui uma ferramenta, chamada E3 Tweak, que realiza as
configuraes de registro usando uma interface grfica. O Manual do
Usurio do E3 Tweak pode ser aberto pelo menu Iniciar - Programas -
Elipse Software - Elipse E3 - Manuais - Manual do Usurio do E3 Tweak. O
aplicativo E3 Tweak pode ser aberto de trs formas:

Pelo menu Iniciar - Programas - Elipse Software - Elipse E3 - E3 Tweak

Pelo menu Ferramentas - E3 Tweak do E3 Studio

Pelo item Atalhos - E3 Tweak do menu do E3 Admin na rea de

Notificao do Windows

Configuraes Avanadas 823

CAPTULO
Dvidas mais Frequentes
27
Este captulo destina-se ao esclarecimento das dvidas mais frequentes
encontradas no E3. Tambm so mostrados os erros que podem ocorrer e
quais as solues para eles.

824 Dvidas mais Frequentes

27.1 Alarmes
Foi encontrado um erro no nmero de colunas do arquivo CSV na
importao de um Alarme do tipo <nomedotipo>. Deseja
continuar a importao dos demais Alarmes, ignorando os erros?

POSSVEIS CAUSAS

O arquivo CSV para os alarmes que se quer importar possui um erro nas
colunas do Alarme do tipo indicado. Arquivos de alarmes devem ter sempre o
nmero mnimo de colunas esperado, de acordo com cada tipo. Colunas
extras so desprezadas. Para saber a maneira correta de criar um arquivo
CSV para alarmes, veja o tpico Criando um arquivo CSV manualmente no
captulo E3 Studio.

SOLUO

Existem trs possveis respostas pergunta feita na mensagem de erro:

Sim: A importao dos Alarmes contidos no arquivo CSV prossegue,

ignorando apenas este erro de nmero de colunas. O Alarme cujas
colunas esto incorretas no importado

Sim (Todos): A importao dos Alarmes prossegue, ignorando todos os

demais Alarmes com erro no nmero de colunas que possam existir no
arquivo CSV

No: A importao interrompida, mas os Alarmes j importados so

preservados

Para que este erro no ocorra, o arquivo CSV deve ser criado de acordo com
as recomendaes do captulo Alarmes.

IMPORTANTE
Embora os arquivos de Tags e Alarmes tenham a mesma extenso (.csv),
eles so internamente diferentes. Sendo assim, um arquivo de Alarmes no
serve para Tags e vice-versa.

Dvidas mais Frequentes 825

Criei um arquivo CSV manualmente, contendo a configurao dos
Alarmes. Como fao para import-lo?

Verifique as configuraes regionais no Painel de Controle do Windows, e

confirme se o caractere separador o mesmo utilizado no arquivo CSV. DICA:
crie um Alarme no E3 e utilize a ferramenta de exportao, utilizando-o como
modelo para a gerao dos novos Alarmes.

Como mostrar o campo E3TimeStamp com milissegundos no

E3Browser e no E3Alarm?

Use o formato Outros, digitando "dd/MM/yyyy HH:mm:ss.000". Esta

configurao para o E3Browser feita na aba Fontes de Dados, na coluna
Formato de cada campo. Para o E3Alarm, tal configurao feita na aba
Colunas, clicando em Propriedades de cada campo.

Aparece a seguinte mensagem de erro: "Impossvel criar

assinaturas de Alarmes no Servidor de Alarmes com filtro. Error
code: (0x800706F7)". O qu isto significa?

O nome do Servidor de Alarmes no foi especificado no E3Alarm, ou ento

est errado. Para que o E3Alarm consiga capturar e exibir os Alarmes ativos,
necessrio configurar o nome do Servidor de Alarmes a ser acessado. Para
isto, modifique o valor da coluna Servidor de Alarmes da Conexo desejada
na aba Conexes da janela de propriedades do objeto E3Alarm, ou atravs
da Lista de Propriedades, acessando a propriedade AlarmServer.

Como apagar Tags associados a Alarmes e reas do objeto

Configurao de Alarmes?

Para apagar um Tag que est associado a um Alarme: Selecione o Tag

desejado com o mouse e pressione a tecla DELETE

Para apagar um Alarme: Selecione o Alarme desejado com o mouse e

pressione a tecla DELETE

Para apagar uma rea: Selecione a rea desejada com o mouse e

pressione a tecla DELETE

826 Dvidas mais Frequentes

Como exibir as mensagens "Alta", "Mdia" e "Baixa" no campo
Severidade de um Alarme ao invs dos valores 0, 1 e 2 em uma
consulta SQL?

A sintaxe SQL para cada um dos bancos de dados suportados pelo E3 a

seguinte:

Access:
SELECT InTime, OutTime, Message, FormattedValue,
IIF(Severity = "0", "Alta",
IIF(Severity = "1", "Mdia", "Baixa"))
AS Severidade FROM Alarms;

SQL Server:
SELECT InTime, OutTime, Message, FormattedValue,
Severidade = CASE Severity
WHEN 0 THEN 'Alta' WHEN 1 THEN 'Mdia'
WHEN 2 THEN 'Baixa' END FROM Alarms;

Oracle:
SELECT InTime, OutTime, Message, FormattedValue,
DECODE(Severity, 0, 'Alta', 1, 'Mdia', 2, 'Baixa')
Severidade FROM Alarms;

Dvidas mais Frequentes 827

27.2 Associaes
Como criar um Tag Expresso no E3?

Associando a propriedade Value de um Tag Interno expresso desejada. A

expresso pode ser do tipo simples e pode conter operadores aritmticos e
lgicos envolvendo constantes e outros Tags.

Como mudar a cor de um objeto ao passar o mouse sobre ele?

Criando uma Associao Digital entre as propriedades ForegroundColor e

MouseOver de um objeto. A propriedade MouseOver do tipo Booleana, e
assume o valor Verdadeiro quando o mouse estiver sobre objeto e Falso
quando o mouse estiver fora da rea do objeto.

Como criar uma aplicao multilngue?

H duas formas de se fazer isto. Uma delas criar um Tag Interno no Viewer
para cada String e associar estes Tags s propriedades que devem ser
traduzidas (ou utilizar os Tags por script no caso do mtodo Msgbox).
Depois, criar uma tabela com todas as Strings da aplicao, onde a primeira
coluna o nome do Tag Interno criado no Viewer, e cada coluna seguinte
contm a String correspondente a um idioma. Esta tabela pode ser criada no
Access, por exemplo. Ao abrir o Viewer e definir o idioma, carregar os Tags
Internos do Viewer com as Strings da tabela correspondente ao idioma
escolhido. Isto pode ser feito utilizando um objeto Consulta na Tela. Segue um
exemplo de script:
Sub Tela1_OnPreShow(Arg)
Set rs = Item("Query1").GetADORecordset()
rs.MoveFirst
For i = 1 To rs.RecordCount
Application.Item(rs.Fields("NomeTag").Value).Value = _
rs.Fields(Arg).Value
' Arg um parmetro passado para a Tela contendo o nome
' da coluna referente ao idioma selecionado
rs.MoveNext
Next
End Sub

828 Dvidas mais Frequentes

Outra maneira criar uma Associao por Tabela em todas as propriedades
que possuem contedo a ser traduzido, usando para todas as Associaes a
mesma fonte. Em cada faixa de valores da Associao, coloque uma String
referente a um idioma diferente. A fonte pode ser um Tag Interno cujo valor
pode ser definido ao abrir o Viewer. No caso do mtodo MsgBox, use o
mesmo Tag como condio para escolher qual String utilizada.

Dvidas mais Frequentes 829

27.3 Bibliotecas
Ao abrir uma Tela, aparece uma mensagem dizendo que um
objeto no pode ser carregado corretamente

POSSVEL CAUSA

Foi apagado algum XControl da Biblioteca que estava sendo usada dentro
desta Tela ou ento foi removido do Domnio a Biblioteca que contm este
XControl.

SOLUO

No primeiro caso, se foi apagado o XControl, no h mais como recuper-lo.

Para corrigir o erro, apague o objeto ElipseX que ficou dentro da Tela (pelo
Organizer pode-se ver um ponto de interrogao sobre o cone do objeto.
Na Tela aparece um quadrado preto com um "X"). No segundo caso, adicione
a Biblioteca ao Domnio.

Ao abrir uma Tela, aparece uma mensagem de erro dizendo que

no foi possvel abrir uma Biblioteca ActiveX

POSSVEL CAUSA

Alguns ActiveX utilizados nesta Tela no foram registrados e adicionados no

computador.

SOLUO

Registre e adicione o ActiveX atravs da opo Adicionar ActiveX, disponvel

no menu Ferramentas. Para tanto, deve-se ter o arquivo OCX que contm a
Biblioteca.

Ao inserir um ActiveX na minha Tela ocorreu um erro 80040112.

O qu isto significa?

POSSVEL CAUSA

830 Dvidas mais Frequentes

Este erro indica que o ActiveX a ser inserido no est licenciado na mquina.
Durante o instanciamento, o controle procura no Registro do Windows por
sua chave de licena (HKEY_CLASSES_ROOT\Licenses) e, caso no encontre,
retorna este erro. Existem chaves de licena para os objetos ActiveX, tanto
para ambientes de desenvolvimento quanto para tempo de execuo.

SOLUO

Para resolver este problema, preciso adquirir a licena deste ActiveX e

registr-lo no computador.

Tenho duas Bibliotecas em meu Domnio, mas no consigo

utiliz-las ao mesmo tempo. Quando registro uma, a outra deixa
de funcionar. Como posso resolver este problema?

Provavelmente, uma das Bibliotecas foi criada a partir da cpia da outra,

permanecendo as duas com o mesmo identificador. Por isto, necessrio
remover uma delas do Domnio.

Dvidas mais Frequentes 831

27.4 Domnios e Projetos
O qu acontece com os eventos gerados pelo E3 Server enquanto
o Domnio no est executando?

Sempre que o registro de eventos estiver habilitado, o E3 Server coloca os

eventos gerados na lista interna de eventos (em memria). Esta lista
esvaziada em trs situaes:

Se existe um E3Run executando localmente (isto , o E3 Server est em

estado Hot), os eventos da lista so enviados para o E3Run para serem
gravados no Banco de Dados. Se a gravao funcionar, os eventos
gravados so removidos da lista

Se existe outro E3 Server executando em estado Hot no Domnio, as

mensagens so enviadas para este E3 Server

Se o Domnio fechado, todas as mensagens que ainda no foram

gravadas so descartadas

Utilizei o E3 Admin via linha de comando e apareceu um erro. Por

qu isto ocorreu?

Muitas vezes, quando se utiliza o E3 Admin via linha de comando, pode-se

configurar algum parmetro errado, o que acaba provocando uma
mensagem de erro. As mensagens de erro que podem aparecer so as
seguintes:

O Domnio no pode ser aberto porque o arquivo

'nomedoarquivo.dom' somente para leitura

Esta mensagem aparece quando o arquivo de Domnio somente de

leitura (read-only)

As opes no so vlidas ou o nome do Domnio no est correto.

Verifique as opes informadas e se o Domnio existe

Esta mensagem aparece quando for informada uma opo inexistente,

um nome de Domnio inexistente ou quando o arquivo do Domnio no
for localizado, provavelmente por ter sido informado um caminho
invlido para o Domnio

832 Dvidas mais Frequentes

 O nome do Domnio no foi informado

Esta mensagem aparece quando forem usadas as opes -viewer ou -

start sem o nome do Domnio. Para maiores informaes, consulte o
captulo Domnios

Como duas ou mais pessoas podem trabalhar ao mesmo tempo

no mesmo Domnio?

Criando o Domnio pela rede, vrias pessoas podem abri-lo em mquinas

diferentes e trabalhar nele ao mesmo tempo. As alteraes salvas por uma
pessoa so visveis para todas as outras, assim que abrirem o objeto
especfico alterado, ou ento assim que atualizarem o projeto ou a Biblioteca
alterados.

Qual o efeito de clicar na opo Atualizar do menu do projeto?

Todos os objetos do projeto so atualizados. Por exemplo, se vrias pessoas

estiverem trabalhando ao mesmo tempo no mesmo Domnio, as alteraes
salvas por uma pessoa so visveis para todas as outras, assim que abrirem o
objeto especfico alterado ou quando atualizarem o projeto ou a Biblioteca
alterados.

Dvidas mais Frequentes 833

27.5 Domnios Remotos
Como funciona o licenciamento dos Domnios Remotos?

Tanto o E3 Server executando o Domnio Cliente quanto o que executa o

Domnio Servidor devem ter licenas especficas para Domnios Remotos.
Quando esta licena existe, o E3 Server Servidor passa a aceitar um nmero
ilimitado de conexes externas de outros Domnios. Da mesma forma, no
caso do E3 Server Cliente, possvel estabelecer um nmero ilimitado de
conexes. Para maiores informaes sobre as limitaes do modo Demo do
E3, veja o tpico Limitaes do Modo Demonstrao.

O que acontece quando a comunicao entre o Domnio Cliente e

o Domnio Servidor cai?

Quando uma situao de erro ocorrer, todas as Associaes da aplicao

cliente referenciando o Domnio so desconectadas (Displays, por exemplo,
passam a mostrar o texto que indica erro de comunicao, conforme as
configuraes do objeto Viewer), assim como todos os comandos
Application.GetObject referenciando o Domnio Remoto falham, ou seja,
causam erros de script. Quando o problema resolvido, as Associaes
devem reconectar-se automaticamente. J os comandos
Application.GetObject devem ser executados novamente.

Um Domnio Cliente pode visualizar Alarmes de outros Domnios

Remotos?

Sim, a partir da verso 3.1 do E3 pode-se visualizar e reconhecer alarmes em

Domnios Remotos utilizando, na propriedade AlarmServer de um objeto
E3Alarm, a sintaxe DOMINIO_REMOTO:SERVIDOR_ALARME, onde
DOMINIO_REMOTO o apelido (alias) dado ao Domnio Remoto na aba
Domnios Remotos da configurao do Domnio e SERVIDOR_ALARME o
nome do Servidor de Alarmes. Para verses anteriores 3.1, necessrio
duplicar os Alarmes no Domnio Remoto.

Um Domnio Cliente pode abrir Telas de outros Domnios

Remotos?

834 Dvidas mais Frequentes

No.

Um Domnio Cliente pode usar usurios de outros Domnios

Remotos?

No.

Um Domnio pode se conectar a vrios outros Domnios?

Sim, como pode-se ver na figura a seguir.

Dvidas mais Frequentes 835

 Conectar um Domnio a vrios outros Domnios

Um Domnio pode se conectar a um Domnio em Hot-Standby?

Sim. Considere a arquitetura da figura a seguir.

836 Dvidas mais Frequentes

 Conectar um Domnio a um Domnio em Hot-Standby

Atravs dos Domnios Remotos esta arquitetura possvel. Tem-se um

Domnio de Comunicao, em Hot-Standby, comunicando com os dispositivos.
Estes dados so lidos por um outro Domnio, tambm em Hot-Standby, que
o servidor para os computadores clientes (Viewers).

Um E3 Server pode ser configurado como Domnio Remoto

Servidor e Cliente ao mesmo tempo?

Dvidas mais Frequentes 837

No. Isto pode causar o surgimento de Associaes circulares, ou seja, A B
C A, onde o Domnio A tem como Cliente o Domnio B, o Domnio B tem
como Cliente o Domnio C e o Domnio C tem como Cliente o Domnio A.

Mesmo que as Associaes no sejam circulares, as escritas de Associaes

(ou outras operaes sncronas) podem causar travamentos (deadlocks) entre
os E3 Servers. Para contornar esta situao, sugerimos que o aplicativo seja
modificado para que um Domnio funcione apenas como Cliente ou como
Servidor, mas nunca como Cliente e Servidor ao mesmo tempo.

Domnios Remotos podem ser configurados em mquinas que

no pertencem a um domnio de rede Microsoft?

Depende. O arquivo de Domnio sempre aberto pelo E3 Server, que a partir

da verso 3.0 do E3 executa exclusivamente na conta SYSTEM. necessrio
ento abrir o compartilhamento para o usurio SYSTEM, que chega na outra
mquina com a mensagem de Sesso Nula (Null Session). Esta Sesso Nula
pode ser configurada para ser aceita como um usurio annimo. Portanto,
configure o compartilhamento para o usurio annimo conforme os artigos
Configurando Domnios Remotos em mquinas que no pertencem a um domnio
de rede Microsoft e Configurando Domnios Remotos em mquinas que no
pertencem a um domnio de rede Microsoft (Windows XP/Windows XP).

Porm, h uma incompatibilidade identificada no sistema operacional

Windows 7 ou superior. Para contornar esta questo, recomendamos que os
arquivos da aplicao remota sejam copiados e colados na mesma pasta do
computador local. Nas configuraes de Domnio Remoto, configure o
campo Arquivo de Domnio para que aponte para o Domnio copiado, que
est na mesma mquina do Studio. O campo Servidor principal deve ser
configurado com o nome do computador remoto. Deste modo, possvel
utilizar o AppBrowser para criar todas as Associaes via Studio e, quando a
aplicao executada, estes valores so buscados na mquina remota.

O protocolo DCOM do Windows utilizado pelo E3 para a

comunicao entre Domnios Remotos e Viewer?

No, nestas interaes o protocolo utilizado o REC, proprietrio da Elipse

Software.

838 Dvidas mais Frequentes

O que o protocolo REC? Como posso visualizar o trfego de
dados no log do E3?

O REC um protocolo desenvolvido pela Elipse Software para comunicao

entre os diversos mdulos do E3. Os pacotes do REC no tm tamanho fixo. A
quantidade de dados que passa pelo protocolo pode ser vista nos mesmos
logs do E3 e indicada pela quantidade de dados, em KB, enviados e
recebidos.

Quais as configuraes necessrias para o funcionamento do

protocolo REC?

1. O servidor E3 deve estar executando na mquina de destino.

2. Os Firewalls da mquina de destino e da mquina local devem permitir

conexes TCP/IP na porta 6515.

3. Os parmetros da conexo (time-out, ping, heartbeat) devem ser

compatveis com a velocidade, confiabilidade e latncia da rede entre a
mquina local e a mquina de destino.

O que heartbeat? Onde ele configurado? Qual seu impacto no

sistema?

O heartbeat um mecanismo pelo qual o Domnio Cliente envia mensagens

periodicamente para verificar se o Domnio Servidor est com sua conexo
ativa, aguardando uma resposta.

Para configurar o tempo de heartbeat, preciso primeiramente que o Domnio

esteja carregado. Depois de carregar o Domnio, clique com o boto direito
do mouse no cone do E3 Admin na rea de Notificaes do Windows e
selecione a opo Domnio - Opes. Na janela E3 Admin - Configurao do
Domnio, selecione a aba Domnios Remotos. Selecione o servidor desejado,
clique em Avanado e configure o campo Perodo de heartbeat (ms).

Dvidas mais Frequentes 839

Quando o dobro deste perodo atingido sem que o Cliente tenha recebido
nenhuma mensagem do Servidor, o sistema interpreta que o Servidor falhou
ou est fora da rede, e uma desconexo imediata forada. Caso o ping e o
heartbeat sejam desligados simultaneamente, a deteco de queda de
conexo do Domnio Remoto se torna extremamente lenta (quando houver
falha no Servidor). Nestes casos, possvel que 40 segundos ou mais se
passem sem que o Domnio Cliente indique a perda da conexo.
Recomendamos que ambos os Domnios permaneam ligados sempre que
possvel.

O que se deve fazer caso muitos erros de ping estejam ocorrendo

na rede?

Caso isto acontea, verifique a qualidade e performance da rede e siga os

procedimentos do artigo Configuraes de rede do E3 para redes com alta
latncia, banda reduzida e/ou perda de pacotes. Entretanto, relembramos que a
configurao padro dos Domnios Remotos, e do protocolo REC em geral,
no adequada para redes WAN (Wide Area Network), apenas para redes
LAN (Large Area Network).

O que so chamadas sncronas e chamadas assncronas? Qual a

melhor alternativa em relao performance?

Na comunicao sncrona, o emissor e o receptor devem ambos permanecer

em sincronia, e uma solicitao s atendida aps o resultado de uma escrita
ou requisio. Na comunicao assncrona, por outro lado, o envio de dados
intermitente e no depende do resultado de nenhuma requisio para iniciar
a prxima solicitao.

Quando uma chamada sncrona gerada, o processo aguarda

indefinidamente pelo retorno desta chamada. J quando uma chamada
assncrona gerada, nenhum tipo de retorno esperado.

Por exemplo, considere uma arquitetura de Domnios Remotos onde existe

um Centro de Operao que se conecta a diversos Domnios Remotos. Se um
dos Domnios estiver travado e uma chamada sncrona disparada para este
Domnio, todo o Centro de Operao trava.

840 Dvidas mais Frequentes

Para evitar esta situao, configure a opo Tempo limite de chamada (ms),
disponvel no E3 a partir da verso 4.6, de modo individual para cada
conexo de Domnios Remotos. Se uma chamada sncrona demorar mais
tempo que este valor de time-out, o canal fechado e destrava o processo
que originou a chamada.

Dvidas mais Frequentes 841

27.6 Drivers de Comunicao
O que tenho que fazer para usar os bits de um Tag de
Comunicao?

Para usar os bits de um Tag de Comunicao, deve-se habilitar a

propriedade UseBitFields do Tag.

Como so contados os Tags Bloco e os bits dos Tags no E3?

A contagem considera os Tags de Comunicao e o tamanho dos Blocos de

Comunicao. Os bits no entram na contagem.

Qual a maneira mais fcil de fazer piscar a cor de um objeto na

Tela quando houver um erro de comunicao?

Crie uma Associao Digital entre a propriedade ForegroundColor do objeto

e a expresso NomeDoTag.Quality < 192, com a opo de pisca habilitada.
A propriedade Quality representa o estado da qualidade do valor do Tag, no
padro OPC, e pode variar de 0 a 255, sendo que a qualidade boa apenas
acima do valor 192.

Como sinalizar erros de comunicao na Tela?

Habilite a opo Erros de Comunicao do objeto Viewer, na aba Erros de

Comunicao.

Como trocar a cor padro dos erros de comunicao em Setpoints

e Displays?

Abra a janela de propriedades do objeto Viewer e altere a cor desejada na

aba Erros de Comunicao.

842 Dvidas mais Frequentes

27.7 E3Alarm
Os Alarmes no aparecem no E3Alarm. Por qu isto ocorre?

POSSVEIS CAUSAS

Para checar a configurao do E3Alarm, verifique se o nome do Servidor est

configurado corretamente. Outra possibilidade a existncia de mais de um
Servidor de Alarmes no Domnio, o que pode gerar problemas. Mais uma
situao de erro seria um filtro configurado para uma rea de Alarme
inexistente.

SOLUO

Certifique-se de que existe apenas um Servidor de Alarmes no Domnio e que

todos os Alarmes esto configurados corretamente. Confira tambm se a
rea configurada existe.

Como criar um filtro por duas ou mais reas no E3Alarm?

Primeiro, agrupe as reas em uma rea principal. Depois, use nomes com os
mesmos caracteres iniciais. Exemplo: ALM1MEC, ALM1ELE, ALM2MEC,
ALM2ELE, etc.

Como reconhecer Alarmes com duplo-clique?

Habilite a opo Reconhecer Alarme, localizada nas propriedades da coluna

desejada no objeto E3Alarm, na aba Colunas.

27.8 E3Browser
Como limitar o nmero de registros que aparecem no E3Browser?

Este item pode ser configurado na consulta do E3Browser. Habilite a caixa de

seleo Retornar no mximo ... registros, especificando o nmero mximo
de registros a serem retornados. Outra opo otimizar a consulta a ser feita
utilizando os filtros para restringir o perodo, a quantidade de colunas ou
registros envolvidos, etc. Para isto, veja o captulo Consultas.

Dvidas mais Frequentes 843

27.9 E3Chart
possvel no plotar o valor de um Tag quando a qualidade
estiver ruim, em um E3Chart histrico?

Sim. Utilizando scripts possvel configurar o E3Chart da seguinte forma:

Set Pena = Screen.Item("E3Chart1").Pens
Pena.Item("Nome da Pena").ShowBadPoints = False

Observe, no entanto, que esta soluo somente vlida para valores

histricos. Em tempo de execuo, o valor sempre plotado, independente
da qualidade do Tag.

27.10 Histrico
Como no gravar os registros de Histricos por scan?

Configure a opo Intervalo entre registros (ms) na aba Histrico das

propriedades do Histrico com o valor 0 (zero). Se desejar configur-la por
script, a propriedade a ser utilizada ScanTime. Com isto, os valores no so
registrados automaticamente, sendo necessrio executar o registro via script
utilizando o mtodo WriteRecord.

27.11 Impressora de Linha

O objeto Impressora de Linha tem uma impressora configurada
mas, ao imprimir utilizando um Viewer, a impressora no
imprime. Por qu isto ocorre?

POSSVEL CAUSA

O Viewer no tem acesso impressora configurada no objeto Impressora de

Linha.

SOLUO

Certifique-se que o Viewer tenha acesso impressora configurada. Esta

situao geralmente ocorre em Viewers remotos que no tem acesso
impressoras instaladas no servidor.

844 Dvidas mais Frequentes

27.12 Objetos de Tela
No consigo rotacionar uma figura inserida atravs da Galeria.
Por qu isto ocorre?

Deve-se converter o objeto em smbolo. Isto permite que sejam utilizados os

comandos e opes disponveis aos objetos que so nativos do E3, como por
exemplo, o uso da Rotao.

27.13 Ordem dos Tabs

Qual a relao entre a ordem de criao dos objetos na Tela e a
ordem de tabulao em tempo de execuo?

Quando um novo objeto criado na Tela, atribui-se a ele a primeira posio

na ordem de tabulao, e ele ordenado em sequncia decrescente em
relao aos demais objetos da Tela. Para maiores informaes sobre este
assunto, veja o tpico Ordem de Navegao entre os Objetos, do captulo
Telas e Objetos de Tela.

Dvidas mais Frequentes 845

27.14 Relatrios
Como colocar a data e a hora atual em um Relatrio do E3?

Existem pelo menos duas alternativas:

Coloque um objeto Texto na Seo Page Header e, no evento OnFormat

desta Seo, escreva o seguinte script (Label1 o nome do objeto Texto):
Report.Sections("PageHeader").Controls("Label1")._
Caption = Now

Crie um Tag Demo do tipo CurrentTime. No cabealho ou no rodap do

Relatrio, deve-se inserir um objeto SetPoint e, na propriedade
DataField, deve-se digitar o nome completo do Tag (por exemplo,
"Dados.TagDemo1.Value"). Configure o formato da data desejada. Isto
pode ser feito clicando com o boto direito do mouse no objeto e
ajustando as suas propriedades, ou ento digitando diretamente o
formato na propriedade OutputFormat, na Lista de Propriedades (um
exemplo de formato de data "dd/MM/yyyy hh:mm:ss").

Tenho um Relatrio que mostra o resultado de uma Consulta que

possui um filtro por data. Quando o Relatrio gerado, a
Consulta no retorna os valores configurados via script para estas
variveis. Como solucionar este problema?

Verifique, no script que configura ou acessa este Relatrio, se aps os valores

para as variveis da Consulta terem sido configurados no foi acionado o
mtodo LoadReport, j que este mtodo carrega o Relatrio com as
configuraes feitas no E3 Studio. Utilize somente uma vez o mtodo
LoadReport no script, carregando o Relatrio para uma varivel (atravs do
comando Set).

Como executar corretamente um Relatrio que utiliza o mtodo

CopyConfig para copiar para si as configuraes de um E3Chart
em Tela?

846 Dvidas mais Frequentes

O mtodo CopyConfig no copia os valores de variveis de consulta, sendo
necessrio executar este procedimento via script dentro do grfico. As Penas
configuradas no E3Chart em Tela so do tipo Real.

Como criar um filtro por datas no Relatrio?

Crie uma Consulta SQL no Relatrio filtrando por data inicial e final. Na Tela
onde se deseja gerar este Relatrio, deve-se executar a Consulta SQL
configurada passando os valores de data inicial e final. O script do boto na
Tela onde gerado o Relatrio, por exemplo, pode ser implementado da
seguinte forma:
DataInicial = CDate(Screen.Item("TextoDataInicial").Value)
DataFinal = CDate(Screen.Item("TextoDataFinal").Value)
Set Report1 = Application.LoadReport("Report1")
Set Consulta = Report1.Item("Query1")
Consulta.SetVariableValue "DataInicial", (DataInicial)
Consulta.SetVariableValue "DataFinal", (DataFinal)
Report1.PrintPreview()

Como mostrar as datas utilizadas como filtro na Consulta na

Seo Page Header do Relatrio?

Primeiro, adicione dois SetPoints na Seo Page Header (um para mostrar a
data inicial e outro para a data final) e crie um script que passe os valores que
foram carregados nos SetPoints da Tela (e transferidos para a Consulta) para
estes dois SetPoints. O script a ser criado na Seo Page Header, no evento
OnBeforePrint do Relatrio o seguinte:
Set dados = Application.GetFrame().Screen
Report.Sections("PageHeader").Controls("Field5").Text = _
dados.Item("TextoDataInicial").Value
Report.Sections("PageHeader").Controls("Field6").Text = _
dados.Item("TextoDataFinal").Value

Depois, associe dois Tags Internos aos SetPoints da Tela onde so

especificadas as datas. Associe estes Tags aos SetPoints no Relatrio.

Como imprimo dois Relatrios em impressoras diferentes?

Crie o seguinte script no evento OnReportStart do Relatrio:

Dvidas mais Frequentes 847

 Sub OnReportStart
Report.Printer.DeviceName = "Nome da Impressora"
End Sub

Como utilizo o evento de script OnError para mostrar uma

mensagem de erro quando falhar a impresso do Relatrio?

O evento OnError do Relatrio no permite que sejam executados scripts

dentro dele, servindo somente para seu uso interno. Isto significa que no
possvel alterar a mensagem de erro, nem executar algum outro
procedimento a partir deste evento.

848 Dvidas mais Frequentes

27.15 Servidor de Banco de Dados Oracle
A seguir so listados os possveis erros que podem ocorrer ao se testar a
conexo com este Banco de Dados:

Error = ORA-01017: invalid username/password; logon denied

POSSVEL CAUSA

Mensagem gerada em log quando a senha ou o usurio est incorreto.

SOLUO

Verificar se o usurio existe e se a senha utilizada est correta.

Error = ORA-12154: TNS: no foi possvel resolver nome de

servio

POSSVEL CAUSA

A conexo cliente utilizada no foi encontrada.

SOLUO

Verificar se a conexo utilizada est criada no computador e se ela est

funcionando atravs dos utilitrios de rede do Oracle.

Error = ORA-02264: nome j usado por uma restrio existente

POSSVEL CAUSA

J existe um objeto no Banco de Dados com este mesmo nome.

SOLUO

Para evitar este erro, crie e configure diferentes nomes de ndices ou chaves
primrias no E3.

Error = ORA-01403: dados no encontrados

Dvidas mais Frequentes 849

POSSVEL CAUSA

Esta mensagem gerada quando uma pesquisa interna do E3 procura por

objetos no Banco de Dados e no os encontra (por exemplo, a tabela de
Histricos no existe, deve ser criada).

SOLUO

Isto seria considerado um erro apenas se persistisse nos logs da aplicao.

Error = ORA-00001: restrio exclusiva (SYSTEM.E3INDEX)

violada

POSSVEL CAUSA

Sempre que for feita uma tentativa de escrita de um registro onde o campo
definido como chave primria tiver o valor repetido, a escrita recusada e a
mensagem anterior exibida. interessante verificar que o nome da chave
mostrado (neste caso, a chave SYSTEM.E3INDEX) no formato
Usurio.NomeChave. Dependendo do projeto, este erro esperado, mas na
grande maioria das vezes, importante verificar se a chave a mais
adequada. Para ilustrar esta afirmao, veja estes dois casos:

Sistema de Telemedio de Energia: Visando gravar todos os dados de

um dia, as rotinas usadas para coletar dados admitem tolerncias a mais
ou a menos no horrio a ser coletado. Assim, alguns dos registros tm
de ser escritos mais de uma vez. Neste caso, a ocorrncia deste erro
esperada

Manuteno de alarmes: Para este caso, pode haver mais de um erro

por segundo no sistema. Se o campo E3TimeStamp for usado como
chave primria, pode haver a perda de algumas ocorrncias de alarme, o
que prejudica a anlise posterior dos eventos. Neste caso, re-estudar a
chave-primria pode ser a soluo adequada

SOLUO

H duas maneiras de solucionar esta questo:

1. O usurio deve criar um ndice nico para os campos da chave.

850 Dvidas mais Frequentes

2. O usurio deve verificar a aplicao para que ela no envie valores
repetidos de chave para gravao.

Dvidas mais Frequentes 851

27.16 Servidor de Banco de Dados SQL Server
A seguir so listados os possveis erros que podem ocorrer ao se testar a
conexo com este Banco de Dados:

ErrorLocal = Open Connection ErrorError #0x80004005

Description:[DBNETLIB][ConnectionOpen(Connection()).]SQL
Server does not exist or access denied. (Source: Microsoft OLE DB
Provider for SQL Server) (SQL State: 08001)(NativeError:17)

POSSVEL CAUSA

Nome do Servidor errado na configurao do Servidor de Banco de Dados

ou o usurio no tem acesso quele banco de dados.

SOLUO

Verificar o nome do servidor utilizado e se o usurio possui permisso para

conectar-se quele banco de dados.

ErrorLocal = Open Connection ErrorError #0x80040E4D

Description: Login failed for user 'UsuarioErrado'.(Source:
Microsoft OLE DB Provider for SQL Server) (SQL State: 42000)
(NativeError: 18456)

POSSVEL CAUSA

Erro no nome do usurio ou senha.

SOLUO

Utilize um usurio cadastrado no banco de dados ou verifique a senha

utilizada.

ErrorLocal = ExecuteSql ErrorError #0x80040E14 Description:

There is already an object named 'E3Index' in the database.
(Source: Microsoft OLE DB Provider for SQL Server) (SQL State:
42000) (NativeError: 1750)

852 Dvidas mais Frequentes

POSSVEL CAUSA

J existe um objeto (tabela, chave, ndice, etc.) no Banco de Dados com este
mesmo nome.

SOLUO

Mudar o nome do objeto.

Dvidas mais Frequentes 853

27.17 Servidor de Dados
A propriedade Retentive do Tag Interno no est funcionando,
pois ela no guarda o ltimo valor ao parar o Domnio. O qu
pode estar errado?

A propriedade Retentive no tem este objetivo. Ela tem utilidade apenas em

aplicaes Hot-Standby, para manter o valor do Tag Interno quando houver
uma troca de servidor.

Como salvar o valor de um Tag Interno ao parar o Domnio?

Use o mtodo Save do Servidor de Dados.

Como eu mostro a data e a hora atual do sistema em uma Tela da

minha aplicao?

Crie um Tag Demo do tipo CurrentTime e associe-o a um Display na Tela. O

formato de data e hora pode ser configurado na aba Formatao das
propriedades do Display.

Como criar um temporizador no E3?

Com um Tag Demo do tipo Square. O Tag deve ter a propriedade Enabled
igual a False e a propriedade Period igual a duas vezes o tempo limite em
milissegundos. A atribuio do valor Verdadeiro propriedade Enabled inicia
a contagem do tempo. Para executar um script qualquer no trmino do
temporizador, crie um evento associado propriedade Value do Tag Demo,
que seja executado quando a propriedade alterar o seu valor. Neste script
tambm se deve desabilitar o Tag Demo, ou seja, atribuir propriedade
Enabled o valor False, para que ele no continue variando. Recomenda-se
usar o mtodo Reset do Tag Demo antes de atribuir propriedade Enabled
o valor True.

854 Dvidas mais Frequentes

27.18 Sobreposio de Animaes nos Objetos
Criei uma Animao com Rotao ou Translao na Tela, mas
decidi mud-la, criando uma nova Animao. No entanto, quando
fui executar a aplicao, o objeto apareceu com a Animao
inicial, e no com a Animao corrente. Por qu isto ocorre?

POSSVEL CAUSA

A nova Animao foi criada sem que a anterior tenha sido removida.

SOLUO

Para solucionar esta questo, siga estes procedimentos:

1. Selecione o objeto que deseja mudar a Animao.

2. Clique com o boto direito do mouse neste objeto e selecione a opo

Remover animao.

3. Aplique a Animao desejada.

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

Dvidas mais Frequentes 855

27.19 Stored Procedure
Como executo uma Stored Procedure no E3?

A maneira mais fcil criando uma Consulta no E3 com o comando para

executar a Stored Procedure desejada passando, se necessrio, valores para
ela. O comando que deve ser configurado nesta Consulta o seguinte:
Exec NomeDaStoredProcedure <%var1%>, <%var2%>, ...

A sintaxe para as variveis deve ser o caractere "<" (menor que), o caractere
"%" (percentual), o nome da varivel, o caractere "%" novamente e por fim o
caractere ">" (maior que). Os valores var1 e var2 so as variveis que a
Stored Procedure est esperando (por exemplo, a data inicial e final). Caso a
Stored Procedure no esteja esperando nenhuma varivel, crie o comando
SQL sem as variveis. Para executar esta Consulta, utilize o mtodo Execute.

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

856 Dvidas mais Frequentes

27.20 Viewer
No consigo conectar um Viewer remoto ao Servidor. Por qu isto
est acontecendo?

POSSVEL CAUSA

Existe um firewall bloqueando o acesso ao servidor.

SOLUO

Deve-se liberar as portas utilizadas pelo E3. O procedimento para

desbloquear uma porta no Firewall do Windows est descrito a seguir.

NOTA
A porta padro utilizada pelo E3 a 6515, mas este comportamento pode
ser alterado conforme descrito no tpico Execuo do E3 Viewer -
Execuo atravs do Menu Iniciar.

Windows XP SP3

1. V ao menu Iniciar - Painel de Controle (Start - Control Panel).

2. Clique em Central de Segurana (Security Center).

3. Clique em Firewall do Windows (Windows Firewall).

4. Selecione a aba Excees (Exceptions) e clique em Adicionar Porta (Add

Port).

5. Digite um nome e o nmero da porta a ser liberada. Deixe a opo

Protocolo (Protocol) selecionada como TCP.

6. Clique em OK para salvar as alteraes.

Windows Vista SP2

1. V ao menu Iniciar - Painel de Controle (Start - Control Panel).

Dvidas mais Frequentes 857

2. Clique em Firewall do Windows (Windows Firewall).

3. Selecione a aba Excees (Exceptions) e clique em Adicionar Porta (Add

Port).

4. Digite um nome e o nmero da porta a ser liberada. Deixe a opo

Protocolo (Protocol) selecionada como TCP.

5. Clique em OK para salvar as alteraes.

Windows 7 SP1, Windows 8, Windows 8.1 e Windows 10

1. V ao menu Iniciar - Painel de Controle (Start - Control Panel).

2. Clique em Firewall do Windows (Windows Firewall).

3. Clique em Configuraes Avanadas (Advanced Settings).

4. Clique com o boto direito do mouse no item Regras de Sada (Outbound

Rules) e selecione a opo Nova Regra (New Rule).

5. Na janela Tipo de Regra (Rule Type), selecione o item Porta (Port) e clique
em Avanar (Next).

6. Na janela Protocolo e Portas (Protocol and Ports), selecione a opo TCP

e, no item Portas remotas especficas (Specific remote ports), digite o
nmero da porta a ser liberada e clique em Avanar (Next).

7. Na janela Ao (Action), selecione o item Permitir a conexo (Allow the

connection) e clique em Avanar (Next).

8. Na janela Perfil (Profile), deixe selecionadas as opes Domnio (Domain),

Particular (Private) e Pblico (Public) e clique em Avanar (Next).

9. Na janela Nome (Name), digite um nome e uma descrio (opcional) para

a porta e clique em Concluir (Finish) para salvar as alteraes e fechar a
janela.

No consigo abrir um Viewer remoto pelo Internet Explorer. Por

qu isto est acontecendo?

858 Dvidas mais Frequentes

POSSVEIS CAUSAS

O Viewer no foi instalado na mquina remota

Existe um firewall bloqueando o acesso ao servidor

SOLUO

Pode-se instalar o Viewer na mquina remota ou ento colocar o arquivo de

instalao do Viewer na pasta C:\Inetpub\wwwroot do computador servidor.
Assim, toda vez que se tentar abrir um Viewer pelo Internet Explorer em um
computador remoto onde o Viewer no foi previamente instalado, a
instalao iniciada automaticamente.

Dvidas mais Frequentes 859

Matriz Filial SP
Rua 24 de Outubro, 353 - 10 andar Rua dos Pinheiros, 870 - Conj. 141/142
90510-002 Porto Alegre 05422-001 So Paulo - SP
Fone: (+55 51) 3346-4699 Fone: (+55 11) 3061-2828
Fax: (+55 51) 3222-6226 Fax:(+55 11) 3086-2338
E-mail: elipse-rs@elipse.com.br E-mail: elipse-sp@elipse.com.br

Filial PR Filial MG
Av. Sete de Setembro, 4698/1705 Rua Antnio de Albuquerque, 156
80240-000 Curitiba - PR 7 andar Sala 705
Fone: (+55 41) 4062-5824 30112-010 Belo Horizonte - MG
E-mail: elipse-pr@elipse.com.br Fone: (+55 31) 4062-5824
E-mail: elipse-mg@elipse.com.br

Filial RJ Taiwan
Praia de Botafogo, 300/525 9F., No.12, Beiping 2nd St., Sanmin Dist.
22250-044 Rio de Janeiro - RJ 807 Kaohsiung City - Taiwan
Fone: (+55 21) 2158-1015 Fone: (+886 7) 323-8468
Fax: (+55 21) 2158-1099 Fax: (+886 7) 323-9656
E-mail: elipse-rj@elipse.com.br E-mail: evan@elipse.com.br

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

www.elipse.com.br
kb.elipse.com.br
forum.elipse.com.br
www.youtube.com/elipsesoftware
elipse@elipse.com.br

Gartner, Cool Vendors in Brazil 2014, April 2014.

Gartner does not endorse any vendor, product or service depicted in its research
publications, and does not advise technology users to select only those vendors with
the highest ratings. Gartner research publications consist of the opinions of Gartners
research organization and should not be construed as statements of fact. Gartner
disclaims all warranties, expressed or implied, with respect to this research, including
any warranties of merchantability of fitness for a particular purpose.