Você está na página 1de 410

Manual do Usurio do E3

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


Verso 4.8.300 (25/05/2017)
Sumrio
1 Introduo ..................................................................................................................................................... 1
1.1 Descrio Geral ........................................................................................................................................ 1
1.2 Arquitetura .............................................................................................................................................. 2
1.3 Diagrama de Blocos ............................................................................................................................... 3
1.4 Estrutura de Domnio ............................................................................................................................ 4
1.5 Limitaes do Modo Demonstrao ..................................................................................................... 4
2 E3 Studio ...................................................................................................................................................... 6
2.1 Iniciando um Projeto .............................................................................................................................. 7
2.2 rea de Trabalho ................................................................................................................................... 7
2.3 Configurao .......................................................................................................................................... 8
2.4 Barra de Ferramentas .......................................................................................................................... 14
2.5 Organizer .............................................................................................................................................. 28
2.6 Importao e Exportao .................................................................................................................... 32
2.7 Lista de Propriedades .......................................................................................................................... 54
2.8 Galeria ................................................................................................................................................... 56
2.9 AppBrowser .......................................................................................................................................... 57
2.10 Conectar A ........................................................................................................................................... 60
3 Domnios .................................................................................................................................................... 62
3.1 E3 Server ............................................................................................................................................... 62
3.2 E3Run .................................................................................................................................................... 62
3.3 E3 Admin ............................................................................................................................................... 63
3.4 IOServer ................................................................................................................................................ 64
3.5 E3 Studio ............................................................................................................................................... 64
3.6 E3 Viewer .............................................................................................................................................. 64
3.7 Componentes ....................................................................................................................................... 64
3.8 Criando um Domnio ........................................................................................................................... 65
3.9 Configuraes ....................................................................................................................................... 71
3.10 Outras Opes da rea de Notificao ............................................................................................. 91
3.11 Domnios Remotos .............................................................................................................................. 96
3.12 Gerando Logs no E3 .......................................................................................................................... 101
4 Drivers ...................................................................................................................................................... 102
4.1 Driver de Comunicao ...................................................................................................................... 102
4.2 Servidor OPC ....................................................................................................................................... 114
4.3 Driver de Comunicao OPC ............................................................................................................. 115
4.4 Driver de Comunicao OPC UA ...................................................................................................... 127
4.5 Qualidade ........................................................................................................................................... 140
5 Quadros .................................................................................................................................................... 145
6 Viewer ....................................................................................................................................................... 149
6.1 Configurao ....................................................................................................................................... 149
6.2 Variveis no Viewer ............................................................................................................................ 153

I
6.3 Objeto _top ......................................................................................................................................... 154
6.4 Pasta do Viewer .................................................................................................................................. 154
7 Telas e Objetos de Tela ............................................................................................................................ 156
7.1 Tela ....................................................................................................................................................... 156
7.2 Objetos de Tela ................................................................................................................................... 158
7.3 Configuraes Gerais ......................................................................................................................... 162
7.4 Formatao de Cores ......................................................................................................................... 172
7.5 Formatao de Valores ...................................................................................................................... 173
8 Associaes ............................................................................................................................................... 177
8.1 Simples ................................................................................................................................................. 178
8.2 Bidirecional ......................................................................................................................................... 178
8.3 Digital .................................................................................................................................................. 179
8.4 Analgica ............................................................................................................................................ 180
8.5 Por Tabela ........................................................................................................................................... 180
8.6 Reversa ................................................................................................................................................. 181
8.7 Mltipla ............................................................................................................................................... 182
8.8 Edio de Associaes ........................................................................................................................ 183
9 Bibliotecas ................................................................................................................................................. 187
9.1 Galeria .................................................................................................................................................. 187
9.2 Biblioteca do Usurio (ElipseX) ......................................................................................................... 188
9.3 Quando Criar um ElipseX ................................................................................................................... 197
10 ActiveX ..................................................................................................................................................... 198
10.1 Objetos Microsoft Forms .................................................................................................................. 200
10.2 Elipse KeyPad .................................................................................................................................... 201
11 Servidor de Dados .................................................................................................................................. 203
11.1 Impressora de Linha .......................................................................................................................... 203
11.2 Pasta de Dados .................................................................................................................................. 205
11.3 Tag Contador ..................................................................................................................................... 206
11.4 Tag Demo .......................................................................................................................................... 207
11.5 Tag Interno ........................................................................................................................................ 208
11.6 Tag Timer ........................................................................................................................................... 209
12 Banco de Dados ...................................................................................................................................... 211
12.1 Access .................................................................................................................................................. 211
12.2 Oracle ................................................................................................................................................. 212
12.3 SQL Server ......................................................................................................................................... 216
12.4 Objetos do E3 e Permisses ............................................................................................................. 219
13 Alarmes ................................................................................................................................................... 220
13.1 Configurao de Alarmes ................................................................................................................. 220
13.2 Filtro de Alarmes .............................................................................................................................. 222
13.3 Fontes de Alarme .............................................................................................................................. 227
13.4 Servidor de Alarmes ........................................................................................................................ 234

II
14 E3Alarm .................................................................................................................................................. 243
14.1 Configuraes ................................................................................................................................... 243
14.2 Caractersticas Especficas de Tempo de Execuo ........................................................................ 252
15 Storage .................................................................................................................................................... 256
15.1 Configuraes ................................................................................................................................... 258
15.2 Configurao da Tabela ................................................................................................................... 259
16 Histrico .................................................................................................................................................. 269
16.1 Configuraes ................................................................................................................................... 270
17 Consultas ................................................................................................................................................. 278
17.1 Criando uma Consulta ...................................................................................................................... 279
17.2 Uso dos Filtros da Consulta atravs de Scripts ............................................................................... 285
17.3 Uso de Recordsets de uma Consulta atravs de Scripts ................................................................ 285
18 E3Browser ............................................................................................................................................... 286
18.1 Objeto Consulta no E3Browser ........................................................................................................ 286
18.2 Outras Configuraes ....................................................................................................................... 287
19 E3Chart .................................................................................................................................................... 291
19.1 Configuraes .................................................................................................................................... 291
19.2 Exemplos de Utilizao ..................................................................................................................... 313
19.3 Caractersticas Especficas de Runtime ............................................................................................ 315
20 E3Playback ............................................................................................................................................. 320
20.1 Objeto E3Playback ............................................................................................................................ 320
20.2 Adicionar Playback ao Demo do E3 ............................................................................................... 320
20.3 Interface de Usurio ........................................................................................................................ 324
20.4 Banco de Dados de Playback .......................................................................................................... 333
20.5 Configurao dos Objetos de Banco de Dados do E3 ................................................................... 335
21 Frmulas ................................................................................................................................................. 338
21.1 Configuraes ................................................................................................................................... 338
21.2 Templates .......................................................................................................................................... 340
21.3 Unidades ........................................................................................................................................... 342
21.4 Conjunto de Valores ........................................................................................................................ 342
21.5 Criao de uma Frmula ................................................................................................................. 343
22 Relatrios ............................................................................................................................................... 348
22.1 Objeto Consulta ................................................................................................................................ 348
22.2 Componentes ................................................................................................................................... 348
22.3 Configuraes .................................................................................................................................. 350
22.4 Criando um Relatrio no E3 ............................................................................................................ 361
22.5 Exemplos de Utilizao .................................................................................................................... 362
23 Segurana .............................................................................................................................................. 365
23.1 Usurios ............................................................................................................................................. 365
23.2 Grupos ............................................................................................................................................... 369
23.3 Permisses ......................................................................................................................................... 371

III
23.4 Proteo de Arquivos ...................................................................................................................... 375
24 E3 Viewer e E3 WebViewer ................................................................................................................... 379
24.1 Viewer Only (Modo Somente Leitura) ............................................................................................ 379
24.2 Execuo do E3 Viewer ................................................................................................................... 380
24.3 Logs do Viewer ................................................................................................................................. 383
24.4 Execuo do E3 WebViewer ........................................................................................................... 383
25 Hot-Standby ........................................................................................................................................... 387
25.1 Configurando .................................................................................................................................... 387
25.2 Executando um Domnio Redundante ........................................................................................... 388
25.3 Parando um Domnio Redundante ................................................................................................ 388
25.4 Parando um dos Servidores do Domnio ...................................................................................... 389
25.5 Tempo de Troca entre Servidores .................................................................................................. 389
25.6 Reconexo de Viewers ..................................................................................................................... 389
25.7 Utilizando Bancos de Dados com Hot-Standby ............................................................................ 389
26 Configuraes Avanadas ..................................................................................................................... 390
27 Dvidas mais Frequentes ...................................................................................................................... 391
27.1 Alarmes .............................................................................................................................................. 391
27.2 Associaes ....................................................................................................................................... 392
27.3 Bibliotecas ......................................................................................................................................... 393
27.4 Domnios e Projetos ........................................................................................................................ 393
27.5 Domnios Remotos ........................................................................................................................... 394
27.6 Drivers de Comunicao ................................................................................................................. 397
27.7 E3Alarm ............................................................................................................................................. 398
27.8 E3Browser ......................................................................................................................................... 398
27.9 E3Chart .............................................................................................................................................. 398
27.10 Histrico .......................................................................................................................................... 398
27.11 Impressora de Linha ........................................................................................................................ 399
27.12 Objetos de Tela ............................................................................................................................... 399
27.13 Ordem dos Tabs .............................................................................................................................. 399
27.14 Relatrios ........................................................................................................................................ 399
27.15 Servidor de Banco de Dados Oracle ............................................................................................. 400
27.16 Servidor de Banco de Dados SQL Server ...................................................................................... 401
27.17 Servidor de Dados .......................................................................................................................... 402
27.18 Sobreposio de Animaes nos Objetos .................................................................................... 402
27.19 Stored Procedure ........................................................................................................................... 402
27.20 Viewer ............................................................................................................................................. 403

IV
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
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, Windows Server 2012 R2 ou Windows Server 2016, 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.

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.

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

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

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

1.3 Diagrama de Blocos


A arquitetura interna do E3 totalmente escalvel, com cada tarefa principal sendo executada por um servio
separado. O diagrama a seguir mostra uma viso geral dos principais blocos.

Introduo 3
Diagrama dos blocos que compem o E3

1.4 Estrutura de Domnio


Cada grupo de servidores composto por um E3 Server operando isoladamente ou dois E3 Servers em configurao
de Hot-Standby. Cada Viewer, de fato, se conecta a um Domnio ao invs de somente a um servidor.
Depois da conexo, servidor e cliente trocam informaes e verificam a existncia de objetos do sistema registrados e
atualizados na mquina cliente. Caso negativo, o servidor carrega as definies dos objetos, como bibliotecas do
usurio, conforme a necessidade para abrir cada uma das Telas.
Do ponto de vista do cliente, o download comea na primeira Tela (interface grfica), incluindo quaisquer objetos
internos que so salvos em um diretrio de cache. Este processo pode levar alguns segundos, dependendo da
aplicao, mas traz mais benefcios na prxima vez que se abre a mesma Tela, pois o Viewer realiza um cache em
disco e em memria. Se o Viewer no for fechado, a partir da segunda vez que uma Tela for aberta (e no for
reconfigurada) ela j est criada em memria, reduzindo, portanto, o tempo de paginao. Se a Tela for modificada, o
Viewer deve executar um novo download, reiniciando o processo.
Depois de abrir uma Tela, o servidor e o cliente trocam somente dados em tempo real e consultas ao Banco de
Dados em um sistema de mensagens TCP/IP, com um alto desempenho se comparado ao Terminal Services,
dependendo da aplicao. Isto possvel porque enquanto o E3 Viewer recebe e envia apenas valores e dados em
tempo real, um cliente Terminal Services envia mensagens de teclado e mouse e recebe imagens, o que gera um
trfego muito maior de informaes. Um Viewer conectado a um Domnio isolado pode obter informaes residentes
somente dentro do servidor ativo, de acordo com os direitos de acesso do usurio.

1.5 Limitaes do Modo Demonstrao


Sem a utilizao de uma licena, o E3 pode ser executado em modo Demonstrao (ou Demo), o que til para
avaliao do software. Neste caso, as seguintes limitaes se aplicam:
Permite salvar projetos com at 20 Tags de Comunicao
No permite trabalhar com servidores em modo Hot-Standby
No permite trabalhar com Domnios Remotos
S 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
4 Introduo
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

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

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

2.1 Iniciando um Projeto


Quando o E3 Studio iniciado, abre-se uma caixa de dilogo com algumas opes do projeto, 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

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

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.

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

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

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

Comandos Mostra os itens que compem o menu ou a barra de


ferramentas selecionada

Descrio Breve descrio da opo selecionada

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.

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

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

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

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

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

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

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

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

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


Studio .NET 2005

Aba Opes: Atravs desta aba possvel configurar as especificaes gerais do projeto. 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.

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

cones grandes Habilita cones grandes nas barras de ferramentas

2.3.2 Outras Configuraes


Pode-se configurar o Editor de Scripts do E3, bem como outras opes dos arquivos do Domnio, atravs do menu
Ferramentas - Opes, onde tem-se acesso 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
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 ativa Permite fechar a aba ativa ao clicar no seu respectivo
boto de fechar. Desmarcar esta opo posiciona o
boto de fechar direita do Editor

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

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

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

NOTA
Feche os editores de scripts abertos para que as modificaes sejam aplicadas.

Arquivos: Habilita ou desabilita a opo Ignorar verificao de CRC

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

Abrir Projeto Abre um projeto existente

Salvar Projeto Salva o projeto

Salvar Tudo Salva todo o Domnio

14 E3 Studio
CONE COMANDO AO
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

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 Domnio Executa ou para o Domnio corrente

Executar ou Parar E3 Viewer Executa ou para o E3 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 Arquivos Desfragmenta o arquivo especificado

Procurar ou Substituir Procura todas as ocorrncias de um


determinado texto em todo o
Domnio
Contagem de Objetos no Domnio Mostra uma janela com as
quantidades de objetos disponveis
no Domnio, separados por classes
ordenadas alfabeticamente ou
agrupadas por mdulos
Documentao de Scripts Gera a documentao 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

E3 Studio 15
CONE COMANDO AO
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
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)

Barra de Rolagem Insere um objeto do tipo Barra de


Rolagem (ScrollBar)

Boto Incremento-Decremento Insere um objeto do 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
Editar Ponto de Conexo Permite editar pontos de conexo
entre objetos. Este boto somente
est habilitado em objetos
XControl
Linha Insere um objeto do tipo Linha

16 E3 Studio
CONE COMANDO AO
Conector Insere um objeto do tipo Conector

Retngulo Insere um objeto do tipo


Retngulo
Retngulo Arredondado Insere um objeto do 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

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 Translao Insere uma 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)
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

E3 Studio 17
CONE COMANDO AO
Espessura da Borda Define a espessura da borda do
objeto
Estilo de Preenchimento Define o estilo de preenchimento do
objeto

Opes disponveis na barra de ferramentas Alinhamento


CONE COMANDO AO
Alinhar Esquerda Alinha objetos esquerda

Alinhar Direita Alinha objetos direita

Alinhamento Superior Alinha objetos pelo topo

Alinhamento Inferior Alinha objetos pela base

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 Horizontalmente Centraliza os objetos horizontalmente

Centralizar Verticalmente Centraliza os objetos verticalmente

Distribuir Horizontalmente Formata o espaamento entre


objetos na horizontal

Distribuir Verticalmente Formata o espaamento entre


objetos na vertical

Espelhar Horizontalmente Aplica uma reflexo 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

Texto Direita Alinha o texto direita

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 .
18 E3 Studio
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

Ordenar alfabeticamente Mostra a contagem de 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 instncias de Inclui na contagem os filhos internos


ElipseXs 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.

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

E3 Studio 19
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.

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.

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.

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

E3 Studio 21
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.

Mensagem de finalizao da gerao do arquivo que contm os scripts


Algumas observaes relevantes:

22 E3 Studio
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
Esta ferramenta pode demorar algum tempo para gerar o arquivo de documentao, caso a aplicao seja
grande e a pesquisa envolva muitos tipos de objetos. Para agilizar a pesquisa, interessante gerar um arquivo
para cada tipo de objeto do E3

2.4.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
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 minsculas Procura pelo texto exatamente como foi escrito,
diferenciando maisculas de minsculas
Palavras inteiras Procura o texto especificado como uma palavra inteira.
No considera o texto como uma substring de outro
Substituir por Contm o texto a ser utilizado na substituio

Substituir Inicia o processo de substituio

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

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 propriedades do tipo
00:00:10 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 propriedades
100 numricas. Pesquisando por 10
encontra 10 e 10.0, mas no encontra
10.1 ou 100
Ponto flutuante 10.0 Encontra em todas as propriedades
40,5 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 propriedades do
0,0,234 tipo Cor. Deve necessariamente usar
vrgulas para separar os valores, que
devem estar no sistema RGB
Booleano Verdadeiro Leva em considerao o idioma do
True Windows para entender a pesquisa
como sendo de um valor Booleano
String Teste Encontra Strings inteiras ou partes
Tag 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

24 E3 Studio
2.4.4 Relatrio de Verses
A ferramenta Relatrio de verses permite a visualizao das verses e comentrios dos projetos e das bibliotecas
abertos, pertencentes ou no ao Domnio. Para acessar 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

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.

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.

E3 Studio 25
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:
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

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.

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

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

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.

E3 Studio 27
Janela Edio de Arrays
Nesta janela, se algum dos valores tambm mostrar a indicao Array, seus valores podem ser visualizados repetindo
o procedimento anterior.

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.

28 E3 Studio
Modo Domnio
O grupo Configurao mostra os servidores configurados, bem como os nomes dos arquivos de projetos e de
bibliotecas pertencentes ao Domnio.
O grupo Bibliotecas de Objetos agrupa os objetos ElipseX de todas as bibliotecas pertencentes ao Domnio,
organizados por tipo de objetos (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.

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.

E3 Studio 29
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.

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

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

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

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)

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

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.

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.

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

2.6.1.1 Criando um Arquivo CSV Manualmente


possvel criar um arquivo com extenso .csv a partir do Bloco de Notas, do Excel ou de outro aplicativo do
Windows. O arquivo criado considerando o separador 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.

E3 Studio 33
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.

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.

34 E3 Studio
Exportao de Objetos
Na exportao, todas as propriedades, Associaes, colees e itens de colees do objeto selecionado e de seus
filhos so automaticamente exportadas. gerado um arquivo CSV com uma linha para cada objeto exportado, bem
como para cada Associao, coleo ou item de coleo existente nestes objetos. Para cada propriedade criada
uma coluna no arquivo, onde informado o valor da propriedade para cada objeto.
O objeto selecionado, chamado de objeto raiz, exportado com a coluna da propriedade Name em branco. Nos
demais casos, esta coluna contm a hierarquia com nomes separados por pontos. Exemplo de exportao a partir de
um objeto IODriver:

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.

E3 Studio 35
Para importar objetos, siga estes procedimentos:
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.

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]

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

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

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

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 39
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.

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

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

40 E3 Studio
Opes disponveis na aba Configuraes
OPO DESCRIO
Separador de colunas As opes disponveis so: Usar o separador de listas
do Windows (escolhe o caractere definido no Windows
como separador de listas para ser usado como
separador de colunas do arquivo CSV) 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

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

Aba Importao

E3 Studio 41
As opes disponveis nesta aba esto descritas na tabela a seguir.
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 duplicadas Especifica como o E3 deve lidar com a ocorrncia de


Associaes duplicadas na importao. As opes
disponveis so Questionar sobre o que fazer em cada
caso, Sempre sobrescrever a associao existente 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 duplicados Especifica como o E3 deve lidar com 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

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

42 E3 Studio
Aba Filtros
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

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

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

Aba Identificadores
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Identificadores
OPO DESCRIO
Nome da classe Indica o nome da classe selecionada na opo

44 E3 Studio
OPO DESCRIO
Identificador Permite ao usurio alterar o valor a ser utilizado na
coluna ObjectType do arquivo CSV. O valor inicial nesta
coluna sempre o nome da classe do objeto. Para cada
valor alterado aqui, criada uma entrada no arquivo INI
na seo Types. Os valores no so sensveis caixa
(isto , "AAA", "aaa" e "aAa" so o mesmo valor). Caso o
usurio defina valores iguais para mais de um tipo,
apenas o primeiro tipo 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

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

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

E3 Studio 45
Opes disponveis na aba Propriedades
OPO DESCRIO
Nome da coluna Permite ao usurio alterar o valor a ser utilizado como
nome da coluna no cabealho do arquivo CSV. O valor
inicial desta coluna sempre o prprio nome da
propriedade do objeto. Para cada valor alterado nesta
coluna, criada uma entrada no arquivo INI na seo
Columns. Os nomes das colunas no so 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
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

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.

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

Listar todas as classes de objetos do E3 Se esta opo for selecionada, a 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

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

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.

E3 Studio 47
3. Se a importao foi realizada com sucesso, os alarmes devem aparecer sem nenhuma mensagem de erro. Caso
os Tags correspondentes j tenham sido importados, todas as referncias devem aparecer na cor azul.

2.6.5.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.
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.

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.

48 E3 Studio
Exportao de Drivers
3. Selecione o local e o nome do arquivo a ser gerado. Alm do arquivo com as configuraes dos Tags, gerado
um arquivo com o mesmo nome, seguido do sufixo _Alarms. Este arquivo utilizado posteriormente na
importao da configurao de alarmes no E3.

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


1. Insira um Driver de Comunicao no Organizer.
2. Renomeie o Driver para o mesmo nome do Driver utilizado na aplicao Elipse 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.

E3 Studio 49
Importao de Tags

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.

50 E3 Studio
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.
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.

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.

E3 Studio 51
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.
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.

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

52 E3 Studio
AnimationBind: Associaes Digitais
TableBind: Associaes por Tabela

As propriedades ou os campos das Associaes so importados ou exportados como se fossem propriedades de


objetos, com uma coluna no arquivo CSV para cada uma delas. Todas as Associaes possuem as propriedades
Source e Property e, alm delas, as propriedades existentes para cada Associao so as seguintes:
AgSimple: Reverse, Bidirectional
AnalogBind: SrcHiValue, SrcLoValue, DstHiValue, DstLoValue
AnimationBind: BlinkOn, BlinkOff, OnValue, OffValue, BlinkOnValue, BlinkOffValue

A criao de linhas da tabela respeita o ndice informado pelo usurio. Se o ndice no for um nmero, mostrada
uma mensagem de erro (nome invlido). Se for um ndice inexistente (por exemplo, s existem duas linhas na tabela e
o usurio quer inserir a linha cinco), as linhas que faltam so criadas e ficam com os valores padro.
Todas as Associaes so importadas ou exportadas, independente da seleo de propriedades que o usurio tenha
feito. Se uma Associao para determinada propriedade j existir, o usurio questionado sobre o que fazer. Caso
contrrio, elas so criadas.

Importao de uma Associao pr-existente


No nome do objeto deve ser informado o caminho completo, no formato Objeto.Links.Nome. Exemplo:
'Links indica que uma Associao
'e Value a propriedade que possui a Associao
Texto1.Links.Value

2.6.7 Colees e seus Itens


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

E3 Studio 53
Na coluna de tipo deve aparecer uma das seguintes palavras-chave:
IDispChartPen: Penas do E3Chart
ILegendColumn: Legendas do E3Chart
IAxis: Eixos do E3Chart
ITableBindRow: Linhas das Associaes por Tabela

2.6.8 Logs e Relatrios de Falhas


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

Relatrio de falhas na importao

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.

54 E3 Studio
Lista de Propriedades ordenada
alfabeticamente
A Lista de Propriedades da figura a seguir mostra o objeto anterior com suas propriedades ordenadas por categoria.

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.

E3 Studio 55
O rodap da Lista de Propriedades mostra uma descrio rpida da propriedade selecionada. As opes disponveis
nesta janela esto descritas na tabela a seguir.
Opes disponveis na Lista de Propriedades
CONE OPO DESCRIO
Ordenar por categoria Mostra as propriedades do objeto
selecionado organizadas por
categorias

Ordenar alfabeticamente Mostra as 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

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

56 E3 Studio
Galeria

2.9 AppBrowser
O AppBrowser uma ferramenta que auxilia o usurio a montar a aplicao informando uma expresso lgica, uma
Associao ou um valor para a propriedade sendo manipulada, de acordo com o objeto selecionado. Assim,
possvel minimizar erros durante a criao da aplicao.

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 57
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.

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


O quadro esquerda contm os seguintes itens:
O primeiro item, mostrado isoladamente, o Contexto. O objeto contexto o que originou a chamada do
AppBrowser, ou seja, o dono do script
O prximo 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 item mostrado o Viewer (objeto Application)
O item Servidor lista todos os objetos do servidor que a aplicao possui. Caso este item seja o contexto atual,
ele contm a indicao de Application
O item Tarefas mostra as tarefas mais comuns de serem executadas atravs de um script. So duas: Abrir Tela
(cujo resultado uma expresso para abrir a Tela selecionada, equivalente ao Pick Abrir Tela) e Carregar
Relatrio (cujo resultado uma expresso para carregar um Relatrio). Este item pode ou no ser mostrado,
dependendo se h Relatrios ou Telas no projeto
O item VBScript mostra todas as funes da linguagem VBScript disponveis para uso em scripts
O item E3Globals mostra mtodos de uso global do E3

De acordo com o objeto selecionado, o quadro central mostra suas propriedades e seus mtodos.

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

AppBrowser via Associaes


Neste caso, apenas as propriedades dos objetos so mostradas no quadro central da janela. Seus mtodos no so
mostrados, pois no permitido us-los em Associaes.

2.9.3 Acesso via Propriedade


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

AppBrowser via Propriedade

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

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 Domnio atual Usa licena do servidor onde o Domnio executa

Usar licena de um servidor especfico Usa a licena de outro servidor, que no o servidor que
est executando o Domnio

Se a conexo com qualquer dos dois servidores (Domnio ou licena) cair, o E3 Studio desconectado do outro
servidor. A ltima configurao guardada no Registro do Windows e, da prxima vez em que o E3 Studio for aberto,
ele se 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.

60 E3 Studio
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).

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 61
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.

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.

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

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

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

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.

Domnios 63
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.

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.

64 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.

Confirmao de insero do projeto ou biblioteca no novo


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

3.8.1 Assistente de Aplicaes


O Assistente de Aplicaes do E3 a ferramenta utilizada para criar um novo Domnio com um projeto ou uma
biblioteca. Esta opo pode ser acessada das seguintes maneiras:
Clicando em Novo 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.

Domnios 65
Tela inicial do Assistente de Aplicaes

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.

66 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.

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.

Domnios 67
Tela Domnio
Clique em Avanar para prosseguir.

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.

68 Domnios
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.

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

Domnios 69
Clique em Avanar para prosseguir.

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.

Tela final do Assistente de Aplicaes


Finalize o processo clicando em Concluir.

70 Domnios
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.

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

72 Domnios
OPO DESCRIO
Endereos para PING de integridade da rede O algoritmo de Hot-Standby exige que seja declarada
uma terceira entidade de rede (as outras duas so os
servidores principal e o backup) para determinar se a rede
est funcionando. Se no for possvel acessar o endereo
de integridade nem o servidor de backup, o servidor
principal assume que a sua interface de rede est com
problemas e termina imediatamente a execuo do
Domnio. Este campo permite que vrios endereos de
rede sejam registrados. As opes para este campo so
as seguintes:
Os separadores permitidos para cada um dos
endereos so o espao, a vrgula, o ponto e vrgula, a
tabulao e a quebra de linha
Se pelo menos um dos endereos fornecidos neste
campo retornar sucesso, a rede considerada sem
falhas
Os nomes de servidores no so sensveis caixa
Nomes repetidos so descartados
Espaos em branco antes ou depois do endereo so
removidos
Ativar backup em caso de falha local Habilita a troca automtica de servidores quando uma
falha local reportada no servidor principal. Falhas locais
so detectadas e reportadas pelo prprio aplicativo
atravs do mtodo Application.ReportFailure. A troca de
servidores s executada se o servidor de backup estiver
sem falhas
Tempo para ativao do servidor reserva Permite indicar o tempo de ativao para o servidor de
backup. O valor padro 15 segundos. Este tempo afeta
diretamente o 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 reserva Apresenta os seguintes perfis de pr-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
Pr-ativar os seguintes servios 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

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

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.

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.

74 Domnios
Aba Segurana
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Segurana
OPO DESCRIO
O usurio no pode alterar a sua senha Impede que o usurio troque a senha em tempo de
execuo

A senha expira aps ... dias Determina o prazo de validade da senha do usurio.
Antes de terminar o prazo de validade da senha, o
sistema avisa quantos dias restam para expirar. Aps a
senha expirar, o usurio desabilitado
A senha deve conter no mnimo ... caracteres Determina a quantidade mnima de caracteres para a
senha do usurio
A senha deve conter letras e nmeros Determina que a senha do usurio deve conter letras e
nmeros
A senha deve conter no mnimo ... nmeros Determina a quantidade mnima de nmeros na senha

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

A senha deve conter letras maisculas e minsculas Determina que a senha do usurio deve conter letras
maisculas e minsculas
Bloquear a conta do usurio aps ... falhas de login Determina a quantidade mxima de falhas de login para
que a conta do usurio seja bloqueada
Desbloquear o usurio automaticamente aps ... Desbloqueia a conta do usurio depois de determinados
minutos minutos

Domnios 75
OPO DESCRIO
Avisar o usurio nos ltimos ... dias antes da senha Determina a data em que o sistema comea a enviar
expirar 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 maisculas e Permite que as senhas sejam validadas sem diferenciar
minsculas 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.

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


76 Domnios
As opes disponveis nesta aba esto descritas na tabela a seguir.
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

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

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 77
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
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.

78 Domnios
Diagrama de processos
Cada E3 Server mantm uma lista interna dos eventos que devem ser registrados no Banco de Dados. Estes eventos
podem vir de trs fontes:
Eventos gerados nos Viewers (usando o mtodo Application.TrackEvent)
Eventos gerados internamente no E3 Server
Eventos gerados no E3 Server Standby

O E3 Server Standby, de tempos em tempos, envia a lista de eventos para o E3 Server Hot, pois apenas este tem
condies de gravar eventos no Banco de Dados. Os eventos so colocados na fila de eventos do Hot, juntamente
com os demais eventos do sistema, isto , o servidor Hot centraliza a gravao de eventos.
Se houver uma troca de servidor, os eventos que no haviam sido gravados so passados automaticamente para o
novo servidor Hot.
O E3Run grava no Banco de Dados os registros enviados pelo E3 Server Hot. O E3 Server informa o nome do
Servidor de Dados e da tabela onde os dados so gravados.
Para configurar o registro de eventos do E3, clique com o boto direito do mouse no cone do E3 Admin na rea de
Notificao do Windows, selecione a opo Domnio - Opes, e clique na aba Registro de Eventos. A janela da
figura a seguir mostrada.

Domnios 79
Aba Registro de Eventos
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Registro de Eventos
OPO DESCRIO
Registrar os eventos do sistema em uma tabela no Habilita o registro de eventos no E3. Ao selecionar esta
Banco de Dados do aplicativo opo, a opo Nome da tabela deve ser
obrigatoriamente preenchida
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)

80 Domnios
OPO DESCRIO
Selecionar automaticamente um Banco de Dados no Habilite esta opo para deixar que o E3Run selecione um
aplicativo 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
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 devem ser registrados Lista os eventos disponveis no sistema para serem
registrados

Se o E3Run tiver que escolher entre vrios Servidores de Dados, normalmente utilizado o primeiro Banco de Dados
ativado na execuo do Domnio. Se durante a execuo do Domnio, o usurio desabilitar o projeto que contm o
Servidor de Dados que estava sendo usado para gravar os eventos, o E3Run automaticamente 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.

Domnios 81
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%"

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

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

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

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

Domnios 83
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"

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'"

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

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

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

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

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.

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

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 desabilitada) Esta opo permite desabilitar a execuo do projeto,
evitando a ocorrncia de erros quando o Domnio
executado. Quando a opo habilitada, o cone indica
que o projeto no utilizado. Os projetos com o cone
esto habilitados e so executados

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.

86 Domnios
Aba Servidores
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Servidores
OPO DESCRIO
Nome Lista com os nomes dos servidores no sistema

Adicionar e Remover Atravs destas opes, pode-se remover ou adicionar


servidores no sistema. Para adicionar um servidor em
rede, 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 Domnio Indica a pasta onde esto localizados os arquivos do
Domnio (arquivos .prj, .lib, etc.) do servidor selecionado.
A opo No especificar (utilizar a pasta do arquivo
.DOM) o padro, e indica que os arquivos esto na
mesma pasta do arquivo de Domnio (.dom). Caso seja
selecionada a opo Utilizar a seguinte pasta local, o
caminho digitado no campo especfico deve conter
apenas a pasta, sem o nome nem a extenso do arquivo
de Domnio (.dom)

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

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

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

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

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.

Domnios 89
Aba Propriedades
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Propriedades
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
Ao gerar um evento que force o E3Run a receber a configurao do Domnio

90 Domnios
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.

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.

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.

Domnios 91
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.

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

92 Domnios
OPO DESCRIO
Pontos E/S Indica o nmero de pontos de comunicao

Tags do Storage Indica o nmero de Tags do Storage

Drivers Indica o nmero de Drivers disponveis e em uso

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


Servidor OPC

Tempo mximo de execuo Indica o tempo mximo permitido de execuo de um


aplicativo

Para maiores informaes sobre as limitaes do modo Demo do E3, veja o tpico Limitaes do Modo
Demonstrao.

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.

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

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

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

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

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

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.

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

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

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
Domnios 95
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.

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:

96 Domnios
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.
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
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

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

98 Domnios
Quando esta licena existe, o E3 Server Servidor passa a aceitar um nmero ilimitado de conexes externas de outros
Domnios. Da mesma forma, no caso do E3 Server Cliente, possvel estabelecer um nmero ilimitado de conexes.
Para maiores informaes sobre as limitaes do modo Demo do E3, veja o tpico Limitaes do Modo
Demonstrao.

3.11.3 Sintaxe dos Links


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

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.

Domnios 99
Permisses de usurio
Com isto, pode ser necessrio que a conexo com o Domnio Remoto especifique um determinado usurio para
poder ter acesso completo aos objetos do Domnio. Este usurio deve ser especificado no campo Usurio no
Domnio atravs da opo 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.

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

100 Domnios
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.

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.

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

Domnios 101
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.

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.

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

Drivers 103
CONE OPO DESCRIO
Ativar/desativar comunicao Ativa ou desativa a comunicao do
Driver
Contagem de tags Apresenta o nmero total de Tags de
Comunicao no Driver

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.

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.

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.

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

Drivers 105
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
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

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.

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

4.1.2.2 Tags Reportados por Eventos


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

Tabela com trs eventos e apenas um campo de


dados

Tabela com trs eventos e seis campos de dados


Para o primeiro exemplo, necessrio um Tag de Comunicao para ler o valor A. O campo Tempo 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.

Drivers 107
O tempo de varredura ou scan de Tags reportados por eventos geralmente pode ser configurado com um valor bem
baixo, pois o consumo de CPU, caso no existam valores a retornar, geralmente desprezvel.
A propriedade TimeStamp destes Tags em geral contm um valor fornecido pelo prprio equipamento.

NOTA
Os 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.

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 PROCESSO NMERO MXIMO DE PROCESSOS COMPORTAMENTO DO 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
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

108 Drivers
DRIVERS POR PROCESSO NMERO MXIMO DE PROCESSOS COMPORTAMENTO DO 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

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.

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.

Drivers 109
Inserindo uma nova Pasta

4.1.4 Tag de Comunicao


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

110 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.

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.

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

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

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.

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.

112 Drivers
Configurando o Bloco de Comunicao
4. Informe o tamanho do Bloco e a opo de mapeamento.
5. Clique em OK.
6. Caso necessite, configure as propriedades do objeto.

Algumas das propriedades do Bloco de Comunicao podem ser configuradas atravs da Lista de Propriedades, sem
a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, localize-a na Lista de
Propriedades e execute os devidos ajustes. Para maiores informaes, consulte o Manual de Referncia e Scripts do
E3.

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.

Drivers 113
Inserindo um Elemento de Bloco de Comunicao
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.

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.

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

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.

Drivers 115
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 comunicao Ativa e desativa a comunicao do


Driver
Importar tags Importa Tags para o Driver OPC

Informaes sobre o servidor Mostra uma janela com as


configuraes do Driver
Contagem de tags Apresenta o nmero total de Tags de
Comunicao no Driver

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


116 Drivers
Informe o Endereo e ID do Servidor e clique em Selecionar. A janela da figura a seguir mostrada.

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 DESCRIO
Tentar enumerador padro ou registro (recomendado) O E3 tenta procurar as especificaes do Driver, tanto
pelo Registro do Windows quanto pelo enumerador
padro OPC (OPCENUM)

Tentar apenas enumerador padro (servio OPCENUM) O E3 tenta procurar as 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

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.

Drivers 117
Ativar comunicao do Driver OPC
Quando a comunicao ativada, so habilitadas as opes Informaes sobre o servidor e Importar tags, alm da
opo Desativar Comunicao. Para utilizar estas opes, clique com o boto direito do mouse no Driver OPC e
selecione a opo desejada.

118 Drivers
Opes habilitadas quando o Driver OPC est ativo
A opo Informaes sobre o servidor mostra uma janela com as configuraes do Driver.

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.

Drivers 119
Mensagem referente importao de Tags OPC
As opes disponveis nesta caixa de dilogo so as seguintes:
Sim: O E3, ao executar a localizao dos Tags OPC, tenta automaticamente detectar quais Tags so do tipo Bloco
e, neste caso, qual o nmero de Elementos. Para 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


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.

120 Drivers
OPO DESCRIO
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 encontrados no Filtra os Tags para que a aplicao mostre apenas os
projeto 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

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.

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.

Drivers 121
Inserindo um Grupo de Tags OPC
Algumas das propriedades do Grupo de Tags OPC podem ser configuradas atravs da Lista de Propriedades, sem a
necessidade de criar scripts para isto. Caso 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.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.

122 Drivers
Inserindo uma Pasta OPC

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.

Drivers 123
Inserindo um Tag de Comunicao OPC
2. Abre-se uma janela perguntando quantos Tags devem ser criados no Grupo, e qual seu nome. Este nome
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.

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.

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

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.

Drivers 125
Configurando o Bloco de Comunicao
4. Informe o tamanho do Bloco e a opo de mapeamento.
5. Clique em OK.
6. Caso necessite, configure as propriedades do objeto.

Algumas das propriedades do Bloco de Comunicao OPC podem ser configuradas atravs da Lista de Propriedades,
sem a necessidade de criar scripts para isto. Caso necessite configurar 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.

Tabela 5 12 77 55 1 3 42 20 8 89

ndice 0 1 2 3 4 5 6 7 8 9

Teria sua propriedade Value igual a 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.

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

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.

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

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.

128 Drivers
Opo Selecionar servidor
A janela a seguir mostrada, permitindo selecionar um servidor OPC UA na mquina local ou na rede.

Servidores OPC UA locais e na rede

Drivers 129
Para cada servidor OPC UA, tanto locais quanto em rede, so enumerados os pontos de conexo (endpoints), que
podem utilizar diferentes protocolos e modos de segurana. Alm disto, para cada ponto de conexo o servidor
tambm pode suportar diferentes formas de identificao e autenticao de usurios.
Atualmente, o E3 permite a conexo apenas pelo modo TCP Binrio. Para este modo, o E3 suporta os modos de
segurana definidos pelo padro OPC UA, em diversas combinaes de polticas de segurana. Para a autenticao, o
E3 suporta apenas os modos Annimo e Usurio e Senha.

NOTA
A 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.

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.

130 Drivers
Inserindo uma Assinatura OPC UA
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.

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.

Drivers 131
Inserindo uma Pasta OPC UA

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.

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

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.

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

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.

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.

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

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.

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.

Drivers 135
Inserindo um Elemento de Bloco OPC UA
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.

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.

136 Drivers
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
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)

Drivers 137
OPO DESCRIO
Id Tipo de Identificador de N OPC UA (NodeId) no
servidor
Colunas Caminho do Tag no servidor OPC UA

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.

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.

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:

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

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:


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

Drivers 139
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

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 LIMITE BAIXO ALTO CONSTANTE
No especfico O valor ruim, 0 1 2 3
mas nenhuma
razo especifica
conhecida

Erro de H algum 4 5 6 7
Configurao problema de
configurao
especfico no
servidor. Por
exemplo, o item
em questo pode
ter sido apagado
No Conectado A entrada deveria 8 9 10 11
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
Falha de Uma falha de 12 13 14 15
Dispositivo dispositivo foi
detectada

140 Drivers
SUBSTATUS DESCRIO LIMITE
SEM LIMITE BAIXO ALTO CONSTANTE
Falha de Sensor Uma falha de 16 17 18 19
sensor foi
detectada (o
campo Limite
pode conter
informao
adicional)
ltimo valor Comunicao em 20 21 22 23
conhecido falha. Entretanto, o
ltimo valor
conhecido est
disponvel. Note
que a idade do
valor pode ser
determinada pela
propriedade
TimeStamp
Falha de A comunicao 24 25 26 27
Comunicao falhou. No h
ltimo valor
conhecido
disponvel
Fora de Servio O Bloco est fora 28 29 30 31
de scan ou
trancado
N/A No utilizado 32 - 63

Substatus para Qualidade INCERTA


SUBSTATUS DESCRIO LIMITE
SEM LIMITE BAIXO ALTO CONSTANTE
No especfico No h razo 64 65 66 67
especfica

Drivers 141
SUBSTATUS DESCRIO LIMITE
SEM LIMITE BAIXO ALTO CONSTANTE
ltimo valor O dispositivo que 68 69 70 71
utilizvel estava
providenciando o
valor parou de
faz-lo. O valor
retornado deve
ser considerado
velho. Note que
isto difere de um
valor Ruim com o
Substatus 5
(ltimo valor
conhecido).
Aquele estado
associado com
uma falha
detectvel de
comunicao em
um valor buscado.
Este erro
associado com a
falha de alguma
fonte externa que
iria inserir algo no
valor dentro de
um perodo
aceitvel. Note
que a idade do
valor pode ser
determinada na
propriedade
TimeStamp
No utilizado No utilizado 72 - 79

Sensor impreciso O valor est 80 81 82 83


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)

142 Drivers
SUBSTATUS DESCRIO LIMITE
SEM LIMITE BAIXO ALTO CONSTANTE
Unidade de O valor retornado 84 85 86 87
engenharia est fora dos
excedida limites definidos
para este
parmetro. Note
que neste caso o
valor do campo
Limite indica
quais limites
foram excedidos,
mas no
necessariamente
implica que o
valor no possa ir
mais alm da faixa
especificada
Subnormal O valor derivado 88 89 90 91
de mltiplas
fontes e h um
nmero menor do
que o requerido
de fontes boas
No utilizado No utilizado 92 - 127

NOTA
Servidores que no suportam o Substatus devem retornar 0 (zero).

Substatus para Qualidade BOA


SUBSTATUS DESCRIO LIMITE
SEM LIMITE BAIXO ALTO CONSTANTE
No especfico O valor bom. 192 193 194 195
No h condies
especiais

No utilizado No utilizado 196 - 215

Forado Tipicamente indica 216 217 218 219


localmente que a entrada foi
desconectada e
um valor manual
foi forado

No especfico No utilizado 220 - 255

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

Drivers 143
ESPECIFICAO DESCRIO
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).

144 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.

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

Quadros 145
CONE DESCRIO
dockRemaining: Este Divisor ocupa o espao restante
aps o posicionamento de seu Divisor Irmo

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

146 Quadros
Divisores do Quadro
6. Para configurar os Divisores do Quadro, clique com o boto direito do mouse no Divisor desejado no Organizer e
selecione a opo Propriedades.

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

Quadros 147
OPO DESCRIO
Valor Determina o valor que atribudo ao Quadro. S tem
efeito visual se for modificada no Divisor Principal. Este
campo equivale propriedade SplitValue

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.

148 Quadros
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.

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.

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.

Viewer 149
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
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 Inicial Habilita a barra de rolagem na pgina inicial

Exibir o menu do Zoom ao clicar com o boto direito Habilita a exibio do menu Zoom com o boto direito
do mouse do mouse, em tempo de execuo. Este campo equivale
propriedade EnableZoomMenu do objeto Viewer
Manter Telas carregadas na memria Habilita o Viewer a manter as Telas carregadas em
memria. Este campo equivale propriedade
CacheEnable do objeto Viewer
Verificar inatividade aps ... minutos Define o tempo mximo de espera, em minutos, por um
evento de mouse ou de teclado para o perodo de
inatividade. Este campo equivale propriedade
EnableInactivity do objeto Viewer

150 Viewer
OPO DESCRIO
Nmero de retentativas para confirmao de usurio Estabelece o nmero de vezes que a caixa de dilogo de
ou senha login exibida alm da primeira vez. Este campo equivale
propriedade LoginRetries do objeto 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
OPO DESCRIO
Iniciar Maximizada / Minimizada / Janelada Determina o estilo da janela do 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

Viewer 151
OPO DESCRIO
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
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

Ao clicar em Avanado, a janela da figura a seguir aberta.

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

152 Viewer
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
Desconto na resoluo da Tela em pixels Permite escolher o desconto aplicado na resoluo da
Tela entre a configurao atual do computador ou uma
resoluo escolhida pelo usurio, em pixels

Resoluo do monitor em pontos por polegada (DPI) Permite escolher entre a resoluo atual do computador
ou um resoluo escolhida pelo usurio, em pontos por
polegada (DPI)

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

Viewer 153
O prprio objeto Viewer pode acessar seus filhos (Associaes ou scripts)

importante salientar que a Associao para o Viewer deve levar o nome real do Viewer (por exemplo, "Viewer1") e
no simplesmente "Application". Em scripts, ainda vale o uso de Application, que uma propriedade de todos os
objetos que retornam o Viewer.

6.3 Objeto _top


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

Objeto _top
2. Para configurar as propriedades do objeto _top, clique com o boto direito do mouse e selecione a opo
Propriedades.
3. Este objeto possui as mesmas funcionalidades do objeto Divisor do Quadro, e tais informaes podem ser
encontradas nos captulos Telas e Quadros.

6.4 Pasta do Viewer


A Pasta do Viewer define grupos dentro do objeto Viewer de forma a organizar os Tags do Viewer (Contador, Demo,
Interno e Timer) 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.

154 Viewer
Inserindo Pasta do Viewer
NOTA
Uma aplicao que contenha Pastas do Viewer no pode ser aberta em verses do E3 anteriores verso 3.1.

Viewer 155
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.

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.

Configurando o tamanho da Tela

156 Telas e Objetos de Tela


Opes disponveis na janela Configurando o tamanho da Tela
OPO DESCRIO
Escolha o Divisor onde a Tela ser aberta Permite escolher o Divisor onde a Tela aberta. So
listados apenas os Divisores cuja Tela associada
propriedade SplitLink visvel em tempo de execuo

Configurar como Tela inicial do Divisor Habilita a Tela como Tela Inicial do 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

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

Telas e Objetos de Tela 157


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.

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.

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.

158 Telas e Objetos de Tela


Para informaes sobre Conectores em objetos XControl, veja o tpico a seguir.

7.2.2.1 Conectores em XControls


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

Janela de edio de pontos de conexo


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 objeto Marca este Ponto de Conexo como 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

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.

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:

Telas e Objetos de Tela 159


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.

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.

160 Telas e Objetos de Tela


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.

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.

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.

Telas e Objetos de Tela 161


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.

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.

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
Alinhamento Central Horizontal Alinha dois ou mais objetos
horizontalmente entre si, tendo como
referncia o ltimo objeto
selecionado

162 Telas e Objetos de Tela


CONE OPO DESCRIO
Alinhamento Central Vertical Alinha dois ou mais objetos
verticalmente entre si, tendo como
referncia o ltimo objeto
selecionado
Mesma Largura Aplica a largura do ltimo objeto
selecionado aos demais objetos
selecionados
Mesma Altura Aplica a altura do ltimo objeto
selecionado aos demais objetos
selecionados
Mesmo Tamanho Aplica a largura e a altura do ltimo
objeto selecionado aos demais
objetos selecionados
Centralizar Horizontalmente Centraliza o objeto na Tela, de
acordo com suas coordenadas
horizontais
Centralizar Verticalmente Centraliza o objeto na Tela, de
acordo com suas coordenadas
verticais
Distribuir Horizontalmente Aplica a mesma distncia horizontal
entre si a trs ou mais objetos
Distribuir Verticalmente Aplica a mesma distncia vertical
entre si a trs ou mais objetos
Espelhar Horizontalmente Aplica o efeito de 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.

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.

Telas e Objetos de Tela 163


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.

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.

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

164 Telas e Objetos de Tela


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

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.

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

Telas e Objetos de Tela 165


OPO DESCRIO
Usar condio adicional de visibilidade Habilita a utilizao de uma condio adicional de
visibilidade de zoom na camada. Esta condio pode ser
uma varivel ou propriedade qualquer

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.

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

166 Telas e Objetos de Tela


CONE OPO DESCRIO
Espessura da Linha Permite escolher a espessura da
linha da borda do objeto de Tela a
partir de uma lista com espessuras
pr-estabelecidas entre 0 e 2,5
milmetros
Estilo do Preenchimento Permite escolher o tipo de
preenchimento exibido pela Tela ou
pelo objeto de Tela, isto , como se
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
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

Telas e Objetos de Tela 167


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

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.

168 Telas e Objetos de Tela


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

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

Telas e Objetos de Tela 169


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.

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

170 Telas e Objetos de Tela


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 .

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 171


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.

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

Cor personalizada
A escala RGB descreve uma cor atravs da mistura de trs cores bsicas, a saber:

172 Telas e Objetos de Tela


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

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.

Telas e Objetos de Tela 173


Janela de Formatao de Valores
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)

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.

174 Telas e Objetos de Tela


Formatador e Sada Formatada
VALOR FORMATADOR SADA FORMATADA
1 "Positivo";"Negativo";"Zero","Texto" Positivo

-1 "Positivo";"Negativo";"Zero","Texto" Negativo

0 "Positivo";"Negativo";"Zero","Texto" Zero

"Abcd" "Positivo";"Negativo";"Zero","Texto" Texto

Alm 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

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

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.

Telas e Objetos de Tela 175


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

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.

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"

176 Telas e Objetos de Tela


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

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.
Associaes 177
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.

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.

178 Associaes
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.

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

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.

Associaes 179
4. No campo Fonte, selecione a Associao e clique em para indicar a propriedade a referenciar, ou escreva a
expresso neste campo.

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

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.

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.

180 Associaes
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

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.

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.

Associaes 181
Associao Reversa

8.7 Mltipla
Na Associao Mltipla, cada linha da Associao permite buscar o valor de uma fonte diferente. A fonte ativa
selecionada de acordo com o valor fonte principal da Associao.
Cada linha possui o intervalo (propriedades Min e Max) e a fonte para aquele intervalo (propriedade Source, que
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

Remover Remove a linha selecionada da tabela

Mn Especifica o valor mnimo da fonte para uma linha da


tabela

182 Associaes
OPO DESCRIO
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

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.

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

Associaes 183
OPO DESCRIO
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

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

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

184 Associaes
Para editar as propriedades dos eventos do usurio, necessrio selecionar a linha que contm o evento e, na
coluna Conexo, clicar na opo Editar.

Edio das propriedades dos eventos do usurio


Ao clicar na opo Editar, a caixa de dilogo a seguir mostrada, permitindo assim que seja editado o evento do
usurio selecionado.

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

Sempre que a propriedade for uma condio Indica que o evento do tipo etOnEvent ou
verdadeira 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 seu valor Indica que o evento do tipo etOnValueChangeEvent,
isto , o evento ocorre sempre que a expresso
geradora mudar o valor

Tratar a desconexo como mudana de valor Se houver alguma desconexo, esta tratada como uma
mudana de valor

A janela de edio de Associaes permite utilizar o recurso de copiar e colar entre as Associaes das propriedades.
A opo Copiar Associao copia a Associao da linha selecionada e a opo Colar Associao cola a Associao
na linha selecionada, substituindo a Associao anterior.

Associaes 185
Opo de copiar ou colar uma Associao

186 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 no Organizer

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

Bibliotecas 187
propriedades OverrideFillMode, OverrideFillColor e OverrideLineColor, sem a necessidade de transformar o
objeto em um objeto grfico do E3.

Galeria

9.2 Biblioteca do Usurio (ElipseX)


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

Criao de uma biblioteca do usurio (ElipseX)


3. Determine o nome da biblioteca e clique em Avanar.
4. Determine as especificaes referentes ao Domnio.

188 Bibliotecas
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.
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.

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

Bibliotecas 189
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

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

190 Bibliotecas
OPO DESCRIO
Texto de ajuda Texto de declarao e documentao da varivel. Esta
opo corresponde propriedade HelpString de um
objeto Definio de Propriedade

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


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.

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

Bibliotecas 191
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


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

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

192 Bibliotecas
OPO DESCRIO
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

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

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.

Bibliotecas 193
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

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

194 Bibliotecas
OPO DESCRIO
Texto de ajuda Texto de declarao e documentao da varivel. Esta
opo corresponde propriedade HelpString de um
objeto Definio de Propriedade

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.

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 195
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.

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.

196 Bibliotecas
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.

Bibliotecas 197
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.

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

198 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.

Localizao do arquivo ActiveX


3. Selecione o arquivo desejado e clique em Abrir.

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

ActiveX 199
Inserindo um objeto grfico na Tela
Os objetos no-grficos podem ser usados na aplicao atravs de scripts e so criados pelo mtodo CreateObject,
padro do VBScript.

10.1 Objetos Microsoft Forms


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

Os objetos da biblioteca Microsoft Forms disponveis no E3 so descritos nos tpicos seguintes.

10.1.1 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 .

200 ActiveX
10.1.7 Editor de Texto
Possibilita ao usurio inserir e editar textos. inserido na Tela ao selecionar o cone .

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 .

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
OPO DESCRIO
Mostrar quando um SetPoint recebe o foco Esta opo mostra o Elipse KeyPad 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

ActiveX 201
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.

202 ActiveX
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

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.

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.

Servidor de Dados 203


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.

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

204 Servidor de Dados


Opes disponveis na aba Geral
OPO DESCRIO
Usar impressora padro do Windows Utiliza a impressora padro do Windows como sada do
objeto Impressora de Linha. Esta opo corresponde
propriedade UseDefaultPrinter

Escolher uma impressora disponvel Permite selecionar uma impressora 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

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.

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.

Servidor de Dados 205


Inserindo uma Pasta de Dados

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.

206 Servidor de Dados


Inserindo um Tag Contador
2. O Studio abre uma janela perguntando quantos Tags devem ser criados no servidor, e qual seu nome. Este nome
auto-incrementado e, se a opo for deixada em branco, os Tags so criados com o nome padro.

Inserindo Tags Contador


As propriedades do Tag Contador podem ser configuradas atravs da Lista de 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.

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.

Servidor de Dados 207


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.

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.

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.

208 Servidor de Dados


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.

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.

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.

Servidor de Dados 209


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.

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.

210 Servidor de Dados


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


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.

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.

Banco de Dados 211


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

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.

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.

212 Banco de Dados


O acesso ao banco de dados Oracle pode ser feito de duas maneiras: acessando o Banco de Dados Oracle de dentro
do E3 ou via scripts. A seguir so explicados cada um destes procedimentos.

12.2.1 Acessando o Oracle via E3


Para inserir um novo Banco de Dados Oracle, siga estes procedimentos:
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.

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

Banco de Dados 213


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

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.

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.

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

214 Banco de Dados


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.

12.2.4 Acessando o Oracle via Servidor BD


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

Banco de Dados 215


Comunicao do E3 com o Oracle

12.3 SQL Server


Atravs desta opo possvel armazenar dados no Banco de Dados SQL Server.

12.3.1 Acessando o SQL Server via E3


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

216 Banco de Dados


Configuraes para o Banco de Dados SQL Server
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)
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

Banco de Dados 217


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.

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

218 Banco de Dados


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.

Banco de Dados 219


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.

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


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.

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

220 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.

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.

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.

Alarmes 221
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

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

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.

222 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.

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

224 Alarmes
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

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.

Alarmes 225
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
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)

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

226 Alarmes
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
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

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

Alarmes 227
objeto desejado no item Objetos de Servidor e selecione a opo Inserir - Alarme (Analgico, Banda Morta,
Taxa de Variao, Digital ou Discreto).

Inserindo uma Fonte de Alarme


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.

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.

228 Alarmes
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:
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.

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

Alarmes 229
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
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

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

230 Alarmes
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.

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

Alarmes 231
OPO DESCRIO
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

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

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

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

232 Alarmes
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
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 233
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
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
Volta ao normal Permite especificar o texto a ser mostrado para o
usurio quando o alarme no estiver em condio ativa

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

234 Alarmes
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

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.

Alarmes 235
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
OPO DESCRIO
Armazenar alarmes em banco de dados Habilita ou desabilita o 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
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

236 Alarmes
OPO DESCRIO
Mover para a tabela de backup os dados descartados Habilita ou desabilita o armazenamento dos dados
descartados na tabela secundria (tabela de backup).
Este campo equivale propriedade EnableBackupTable
Descartar do backup dados mais antigos que Determina o intervalo mximo de 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
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
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

Alarmes 237
OPO DESCRIO
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)

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

238 Alarmes
OPO DESCRIO
EventTime Data e hora do valor da Fonte de Alarme no momento do
evento
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.FonteAlarme1
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
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)

Alarmes 239
OPO DESCRIO
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
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

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

240 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.

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

Alarmes 241
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

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.

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

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.

E3Alarm 243
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
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

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.

244 E3Alarm
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

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.

E3Alarm 245
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
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)

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.

246 E3Alarm
Aba Colunas
A lista Campos disponveis mostra todos os campos da Fonte de Alarme. Clicando em Adicionar, pode-se
acrescentar campos individualmente no E3Alarm. Clicando em Propriedades, possvel configurar as propriedades do
campo do alarme.

Propriedades da coluna
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

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

E3Alarm 247
OPO DESCRIO
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

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.

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.

248 E3Alarm
Opes disponveis na aba Ordenao
OPO DESCRIO
Pelo campo Ordena os alarmes conforme o campo especificado. Este
campo equivale propriedade PrimarySortField

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.

14.1.5 Aba Cores


Na aba Cores so definidas as cores de reconhecimento dos alarmes no E3Alarm. 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 249
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. Esta opo
corresponde propriedade BackgroundColor do objeto
Cor do Alarme

Cor do texto Determina a cor do texto do alarme. Esta opo


corresponde propriedade TextColor do objeto Cor do
Alarme

No pisca Quando selecionada, o texto do alarme no pisca. Esta


opo corresponde propriedade BlinkMode do objeto
Cor do Alarme configurada com o valor 0 (zero)

Pisca fundo e texto Quando selecionada, as cores de texto e fundo alternam


entre si. Esta opo corresponde propriedade
BlinkMode do objeto Cor do Alarme configurada com o
valor 1 (um)

Pisca apenas texto Quando selecionada, a cor do texto varia entre as cores
escolhidas para o texto e para o fundo. Esta opo
corresponde propriedade BlinkMode do objeto Cor
do Alarme configurada com o valor 2 (dois)

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.
250 E3Alarm
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 est
selecionada, permanece a cor escolhida na opo Cor de
fundo do tipo de alarme selecionado. Esta opo
corresponde propriedade OverrideBackgroundColor
do objeto Cor do Alarme

Redefinir cor do texto Determina a cor do texto do alarme apenas para a


severidade selecionada. Se esta opo no est
selecionada, permanece a cor escolhida na opo Cor do
texto do tipo de alarme selecionado. Esta opo
corresponde propriedade OverrideTextColor do
objeto Cor do Alarme

Redefinir pisca Redefine a opo de pisca para o texto e para o fundo


do alarme na severidade selecionada. Se esta opo no
est selecionada, permanece a opo escolhida no tipo
de alarme selecionado. Esta opo corresponde
propriedade OverrideBlinkMode do objeto Cor do
Alarme

Cada um dos itens da listagem Configure as cores dos alarmes corresponde a uma propriedade do E3Alarm que
retorna um objeto Cor do Alarme, conforme a tabela a seguir.
Propriedades correspondentes s configuraes de cores dos alarmes
ITEM PROPRIEDADE
Alarme Ativo ColorActiveAlarm

Alarme Reconhecido ColorAckedAlarm

Alarme No Reconhecido ColorNAckAlarm

Evento Ativo ColorActiveEvent

As propriedades descritas na tabela anterior so indexadas, ou seja, na sua utilizao possvel especificar um ndice
que indica qual severidade pode ser configurada. Os valores possveis para os ndices destas propriedades so os
seguintes:
0: Severidade alta
1: Severidade mdia
2: Severidade baixa
-1: Configurao global do alarme (configura os valores que so utilizados caso a severidade no os
sobrescreva)

E3Alarm 251
NOTA
As propriedades ColorActiveAlarm, ColorAckedAlarm, ColorNAckAlarm e ColorActiveEvent s esto disponveis
via script. O objeto retornado por qualquer uma destas propriedades pode ser configurado utilizando o mtodo
SetConfig.

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.

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 .

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:

252 E3Alarm
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.

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 selecionados Somente os alarmes selecionados so reconhecidos

Reconhece todos os alarmes do filtro corrente Todos os alarmes visveis neste E3Alarm so
reconhecidos

Reconhece globalmente todos os alarmes Todos os alarmes do Domnio so reconhecidos

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.

E3Alarm 253
Opes da janela Alarmes
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.

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.

254 E3Alarm
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

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 255
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.

Grfico sem compactao


Grfico com compactao
Veja que a informao praticamente a mesma, s que com menos pontos.

256 Storage
Grfico com compactao
A gravao no Storage realizada da seguinte maneira:
Aps a definio da tabela nas propriedades do Storage, esta gerada clicando em Gerar Tabela e os dados
so gravados de acordo com estas definies. Se houver variao de qualidade no Tag, os dados tambm so
gravados
Os dados s no so gravados se a variao ocorreu em um tempo menor que o mnimo programado (campo
MinRecTime)

Para inserir esta ferramenta no E3, siga este procedimento:


1. Clique com o boto direito do mouse no projeto no modo Explorer e selecione a opo Inserir - Storage. No
modo Domnio, clique com o boto direito do mouse no item Objetos de Servidor - Banco de Dados, selecione
a opo Inserir Storage em e logo aps o nome do projeto desejado.

Inserindo um Storage no modo Domnio


Caso necessite, configure as propriedades do objeto. Algumas das propriedades deste objeto podem ser
configuradas atravs da Lista de Propriedades, sem a necessidades de criar scripts para isto. 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.

Storage 257
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.

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 da coluna Fonte. A coluna Nome s utilizada caso a coluna Fonte
contenha uma expresso (por exemplo, Driver1.Tag1 + Driver1.Tag2).
Logo, se expresses no estiverem sendo utilizadas na coluna 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
Adicionar Adiciona Campos na tabela do Storage

Remover Remove o Campo selecionado da tabela do Storage

Propriedades Determina as configuraes da tabela do Storage

Gerar Estrutura no BD Gera a estrutura no Banco de Dados

Nome Determina o nome do Campo da tabela do Storage.


Esta opo corresponde propriedade Name do
Campo do Storage
Fonte Determina a fonte de dados que associada ao Campo.
Esta opo somente de leitura e corresponde
propriedade Link do Campo do Storage
Tipo Determina o tipo do Campo na tabela do Storage. Se
este valor alterado para Bit, String ou Integer, as
colunas MinRecTime, MaxRecTime, Varredura, Banda
Morta e Unidade permanecem desabilitadas. Esta
opo corresponde propriedade Type do Campo do
Storage
MinRecTime Diferena mnima, em milissegundos, entre as estampas
de tempo de dois registros quaisquer de mesma
qualidade, isto , o tempo mnimo para que um novo
dado seja gravado. Esta opo corresponde
propriedade MinRecTime do Campo do Storage

258 Storage
OPO DESCRIO
MaxRecTime Diferena mxima, em segundos, entre as estampas de
tempo de dois registros consecutivos, isto , o tempo
mximo sem que nenhum dado seja gravado. Ao passar
este tempo, o dado considerado antigo e
armazenado. Esta opo corresponde propriedade
MaxRecTime do Campo do Storage

Varredura Tempo de varredura do Campo, ou seja, de quanto em


quanto tempo o valor do Tag realimentado no
algoritmo de compactao de dados. Se este valor
igual a 0 (zero), esta coluna permanece desabilitada e
mostra o valor definido em MaxRecTime, em
milissegundos. Esta opo corresponde propriedade
ScanTime do Campo do Storage
Banda Morta Banda morta utilizada para clculo do algoritmo de
compactao de dados. Indica a preciso que o usurio
est disposto a perder em cada Campo a ser
armazenado. Esta opo corresponde propriedade
DeadBand do Campo do Storage
Unidade Unidade do Campo Banda Morta. Este valor pode ser
especificado em unidades absolutas ou como uma
porcentagem do valor atual do Tag. Esta opo
corresponde propriedade DeadBandUnit do Campo
do Storage

15.1.1 Criando um Storage Vazio


O objeto Storage pode ser criado sem que tenha seus campos configurados. Para isto, preencha suas propriedades
DBServer e TableName 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

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.

Storage 259
Aba Storage
Cada campo da aba Storage possui uma propriedade correspondente. As opes disponveis nesta aba esto
descritas na tabela a seguir.
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
Mover para a tabela de backup os dados descartados Habilita ou desabilita o armazenamento dos dados
descartados na tabela secundria (tabela de backup).
Este campo equivale propriedade EnableBackupTable

260 Storage
OPO DESCRIO
Descartar do backup dados mais antigos que Determina o intervalo mximo de 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

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 na tabela a seguir.
Campos da tabela _Fields
CAMPO DESCRIO
FieldDeadBand Banda morta

FieldDeadBandUnit Unidade da banda morta. Em porcentagem do valor


anterior ou porcentagem dos limites de engenharia
(valor fixo)
FieldDescription Descrio do campo

FieldEU Unidade de Engenharia

FieldHighEng Limite superior do Tag

FieldID ndice do campo cadastrado no Storage

FieldLowEng Limite inferior do Tag

Storage 261
CAMPO DESCRIO
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

FieldVARTYPE Tipo de dado nativo do campo (0: Indefinido, 3:


Integer, 5: Double, 8: Text ou 11: Bit)

A implementao do Storage permite que o usurio no tenha que se preocupar em como os dados esto
armazenados nas tabelas. Entretanto, para uma melhor compreenso do funcionamento do mdulo, e tambm para
permitir acesso por outros programas, mostrado a seguir o formato das tabelas.
As opes de gerenciamento de tabelas especificadas no item anterior se aplicam na verdade a trs conjuntos de
tabelas geradas pelo Storage, de acordo com o campo Nome de Tabela.
Isto porque, para cada tipo de grandeza armazenada, gerado automaticamente um conjunto de tabelas, a saber: um
conjunto para os Tags analgicos, outro para os textos e mais outro para os digitais. Desta forma, cada Storage pode
gerenciar at sete tabelas, caso se especifique que os trs tipos de Tags devam ser armazenados:
<NomeTabela>_Fields
<NomeTabela>
<NomeTabela>_Text
<NomeTabela>_Bit
<NomeTabela>_Backup
<NomeTabela>_Text_Backup
<NomeTabela>_Dig_Backup

A tabela _Fields contm a descrio dos campos que so armazenados, que de forma geral armazenam as mesmas
informaes definidas na configurao dos campos do Storage, alm de associar um ndice automtico para cada
campo. As demais tabelas possuem um formato fixo:
E3TimeStamp: Campo que armazena a data e hora em que houve a variao do Tag. Caso o protocolo de
comunicao suporte o envio de informao de tempo, este campo contm o timestamp do equipamento
Qualidade: Contm a informao de qualidade do ponto (Ruim, Incerto ou Bom) de acordo com a utilizao
dentro do E3 e das normas OPC
ndice: Relaciona o campo gravado com o seu respectivo nome que est armazenado na tabela _Fields
Valor: Valor armazenado. Para a tabela de analgicos trata-se de um campo tipo Double (nmero real), j para a
tabela de digitais trata-se de um nmero inteiro e para os textos trata-se de um campo NVARCHAR de tamanho
varivel, especificado pelo usurio no campo StringFieldSize

15.2.1 Execuo
Ao iniciar a execuo do aplicativo e receber a primeira notificao de valor de cada uma das variveis armazenadas,
o Storage armazena este valor obtido com qualidade Ruim, e logo em seguida com a qualidade enviada, se esta for
Boa. Isto porque ao realizar a consulta, o usurio tem a visualizao de que houve uma interrupo no
armazenamento.
Depois, conforme sejam obtidos novos valores para as variveis, um algoritmo de verificao de gravao interpreta
a sequncia e decide se cada ponto ou no armazenado. Este algoritmo, conhecido como BoxCar/BackSlope, cria
duas bandas de variao (cuja amplitude dada pela banda morta da varivel) de um ponto gravado. A banda
horizontal (BoxCar) define uma verificao comum da banda morta. Uma segunda banda diagonal (BackSlope) define
uma variao para cima ou para baixo da banda morta.
262 Storage
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


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.

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
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)
Storage 263
CompressedDataNValues: Retorna, para um nico Tag, N valores definidos na varivel NumVals, armazenados a
partir de um instante inicial, definido na varivel StartTime. As variveis tambm podem ser definidas em tempo de
execuo a partir da chamada do mtodo SetVariableValue da Consulta
CompressedDataStartEndTime: Retorna, para um nico Tag, os valores armazenados que esto entre o intervalo
definido pelas variveis StartTime e EndTime. As variveis tambm podem ser definidas em tempo de execuo a
partir da chamada do mtodo SetVariableValue da Consulta
SampledData: Retorna, para um ou mais Tags, os valores interpolados, ou seja, estimados entre os instantes
definidos pelas variveis StartTime e EndTime, a intervalos fixos definidos pela varivel TimeInterval. As variveis
tambm podem ser definidas em tempo de execuo a partir da chamada do mtodo SetVariableValue da
Consulta
CalculatedData: Retorna, para um ou mais Tags, o resultado de operaes matemticas aplicadas aos dados
entre os instantes definidos pelas variveis StartTime e EndTime, a intervalos fixos definidos pela varivel
TimeInterval. Os tipos de clculos so Total, Mnimo, Mximo, Desvio Padro, Amplitude, Mdia e Mediana. As
variveis tambm podem ser definidas em tempo de execuo a partir da chamada do mtodo SetVariableValue
da Consulta

Para todas as opes possvel indicar se os dados com qualidade Ruim so includos ou no no resultado, atravs
da caixa de seleo Incluir qualidade RUIM, correspondente propriedade IgnoreQuality da Consulta associada ao
objeto Storage.

Funes da Consulta

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",

264 Storage
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

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.

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

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),
Storage 265
@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

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

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

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

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

Storage 267
@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

268 Storage
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.

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.
Opes disponveis no Editor do Histrico
OPO DESCRIO
Adiciona campos na tabela do Histrico

Histrico 269
OPO DESCRIO
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

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.

Mensagem para confirmar excluso de campo na tabela


O campo Nome define o nome do campo da tabela, o campo Tipo define o tipo de campo da tabela e a fonte deste
campo definida em Fonte. Tambm possvel definir se este campo ou no a chave primria da tabela.

16.1.1 Chave Primria


A Chave Primria um campo ou um conjunto de campos que identifica de maneira nica cada registro de uma
tabela. Assim como o ndice principal para a tabela, ela utilizada para associar dados entre tabelas. Alguns exemplos
de chaves primrias so cdigos de clientes, CNPJ, nmero de matricula, etc. Aps a definio de um campo como
sendo a chave primria da tabela, o prprio Banco de Dados garante que no sejam inseridos dados duplicados
270 Histrico
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.

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 ndice sero nicos Faz com que os valores 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

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

Histrico 271
Clicando em OK, confirma-se que o campo determinado uma chave primria da tabela. Para cancelar a
configurao, clique em Cancelar. Pode-se tambm atribuir um ndice tabela.

16.1.2 ndices
Um ndice um campo ou conjunto de campos que so previamente ordenados pelo Banco de Dados, a fim de
melhorar a performance das consultas que utilizam este ndice. Eles so utilizados para encontrar registros com um
valor especfico em uma coluna rapidamente. Sem um ndice, o Banco de Dados tem de iniciar com o primeiro registro
e depois ler atravs de toda a tabela at que encontre os registros relevantes. Quanto maior a tabela, maior o custo
desta operao. Se a tabela possuir um ndice para as colunas em questo, o Banco de Dados pode rapidamente
obter uma posio para procurar no meio do arquivo de dados sem ter que varrer todos os registros. Por exemplo,
se uma tabela possui 1.000 registros, isto pelo menos 100 vezes mais rpido do que ler todos os registros
sequencialmente. Note que, se for preciso acessar quase todos os 1.000 registros, mais rpido acess-los
sequencialmente, pois isto evita acessos ao disco.
Os tipos de ndices disponveis so os seguintes: Primrio, nico e Index.
Todos os tipos de colunas da tabela podem ser indexadas. O uso de ndices nas colunas relevantes a melhor forma
de melhorar a performance da tabela. O nmero mximo de ndices por tabelas e o tamanho mximo de um ndice
definido pelo mecanismo de armazenamento do Servidor de Banco de Dados.
Pode-se criar ndices em mltiplas colunas. Um ndice de mltiplas colunas pode ser considerado um vetor ordenado
contendo valores que so criados concatenando-se valores de colunas indexadas.
Os ndices podem ser configurados atravs do cone , que abre a janela de configurao, conforme a figura a
seguir.

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

Ao clicar em Adicionar, a caixa de dilogo da figura a seguir mostrada.

272 Histrico
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 ndice sero nicos Se habilitada, faz com que os valores especificados para
o ndice sejam nicos

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.

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.

Histrico 273
Aba Histrico
Cada campo da aba Histrico possui uma propriedade correspondente. As opes disponveis nesta aba esto
descritas na tabela a seguir.
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
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

274 Histrico
OPO DESCRIO
Mover para a tabela de backup os dados descartados Habilita ou desabilita o armazenamento dos dados
descartados na tabela secundria (tabela de backup).
Este campo equivale propriedade EnableBackupTable
Descartar do backup dados mais antigos que Determina o intervalo mximo de 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

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.
Campos da tabela _Fields do Histrico
CAMPO DESCRIO
FieldDeadBand Banda morta

Histrico 275
CAMPO DESCRIO
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
FieldType Tipo do campo

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.

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

Histrico 277
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.

Definio do Servidor Banco de Dados


A configurao da Consulta depende do objeto ao qual ela est relacionada.

278 Consultas
Configuraes da Consulta
Para verificar quais as configuraes necessrias da Consulta, veja os captulos Relatrios e E3Browser.
Algumas das propriedades da Consulta podem ser configuradas atravs da Lista de Propriedades, sem a 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.

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.

Consultas 279
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

Configurao da Consulta
Estas abas so descritas nos prximos tpicos.

17.1.1 Aba Campos


Esta aba mostra todos os campos das tabelas usadas na Consulta. Ao clicar em , possvel selecionar outras
tabelas para a Consulta.

280 Consultas
Inserindo uma tabela
Para selecionar todos os campos da tabela para que faam parte da Consulta, selecione o primeiro item da lista de
seleo, correspondente ao smbolo * (asterisco). Para adicionar um campo especfico, selecione sua caixa de seleo
correspondente.

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.

Consultas 281
Opes disponveis para a configurao de colunas
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

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.

282 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.

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.

Consultas 283
Opes disponveis na aba Variveis
OPO DESCRIO
Nome O nome da varivel definida pelo usurio

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

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.

284 Consultas
Aba SQL
Ao desmarcar a opo Habilita edio direta do SQL, todas as alteraes so perdidas e a Consulta retorna s
opes selecionadas nas abas Campos, Variveis e Visualizar.

Aviso ao desabilitar a edio direta do SQL

17.2 Uso dos Filtros da Consulta atravs de Scripts


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

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.

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
286 E3Browser
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.

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

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.

288 E3Browser
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 DESCRIO
Informe o intervalo de tempo em que os dados sero Determina o intervalo de tempo em que os dados so
atualizados atualizados. Este valor deve ser superior a 1000 ms. Este
campo equivale propriedade RefreshTime do
E3Browser
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.

E3Browser 289
Opes disponveis da aba Cor
OPO DESCRIO
Propriedades (Properties) Determina a cor conforme a propriedade selecionada

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 Custom Color) Edita uma nova cor personalizada, diferente das cores
padro

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

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.

290 E3Browser
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.

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

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.

292 E3Chart
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

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

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
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 cor Determina a cor de fundo do grfico. Esta opo
equivale propriedade BackColor do E3Chart
Mostrar o fundo da grade com a cor Determina a cor de fundo da grade do grfico. Esta
opo equivale propriedade GridBackColor do E3Chart
Intervalo entre as atualizaes (segundos) Determina o intervalo entre as atualizaes do desenho
no grfico. Esta opo equivale propriedade
RefreshTime do E3Chart

E3Chart 293
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.

294 E3Chart
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
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 295
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

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.

296 E3Chart
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 real) Mostra o intervalo de tempo que o 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

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

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.

E3Chart 297
Aba Referncia Visual
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

298 E3Chart
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))

Exemplo de uso da referncia visual

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.

E3Chart 299
Aba Penas
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Penas
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.

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.

300 E3Chart
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

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

A aba Dados contm informaes de acordo com o tipo da Pena.

302 E3Chart
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
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 memria Determina o nmero de amostras 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

E3Chart 303
OPO DESCRIO
Consulta externa Determina a consulta externa, isto , os dados vm de
uma consulta fora do objeto E3Chart
Campo do eixo vertical Nome do campo da Consulta usado para plotar o dado
em uma escala vertical. 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

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.

304 E3Chart
Opes disponveis na aba Estilo
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

Cor de fundo do alarme Cor do fundo da Pena quando em alarme. Esta opo
equivale propriedade LimitPenBkColor

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

E3Chart 305
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.

Aba Modo de Ligao


As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Modo de Ligao
OPO DESCRIO
Modo de ligao entre os pontos 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

306 E3Chart
OPO DESCRIO
Valor considerado para o scan (ms) Define o tempo de leitura esperado 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
Mostrar os pontos de qualidade ruim Define se mostra ou no os pontos de qualidade ruim.
Equivale propriedade ShowBadPoints da Pena
Intervalo mximo para ligar os dados histricos aos Especifica um tempo limite a ser considerado para a
de tempo real (s) conexo visual entre a parte histrica e a parte de tempo
real de uma Pena mista. Corresponde propriedade
MaxGapTime
Realar linha quando MaxGapTime usado Reala a linha de ligao entre a parte histrica e a parte
de tempo real. Corresponde propriedade
HighlightMaxGapTime da Pena
Cor da linha usada com MaxGapTime Especifica a cor da linha de ligao. Corresponde
propriedade MaxGapTimeColor da Pena
Estilo da linha usada com MaxGapTime Especifica o estilo da linha de ligao. Corresponde
propriedade MaxGapTimeStyle da Pena

A aba Estatsticas habilita o clculo de dados estatsticos.

Aba Estatsticas
Cada campo da aba Estatsticas possui uma propriedade correspondente. As opes disponveis esto descritas na
tabela a seguir.

E3Chart 307
Opes disponveis na aba Estatsticas
OPO DESCRIO
Calcular dados estatsticos Habilita o clculo de dados estatsticos

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.

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.

308 E3Chart
Propriedades do objeto Legenda
Alguns campos da aba Legenda possuem uma propriedade ou mtodo correspondente. As opes disponveis esto
descritas na tabela a seguir.
Opes disponveis na aba Legenda
OPO 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
Colunas disponveis Lista as colunas disponveis para visualizao na Legenda

E3Chart 309
OPO DESCRIO
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
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 Pena 5 Description Mostra a 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
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

310 E3Chart
OPO VALOR1 NOME DESCRIO
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
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

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
Formatador Determina o formatador da Coluna selecionada. Esta
opo equivale propriedade Format da Coluna da
Legenda

E3Chart 311
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

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.

312 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.

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.

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.
E3Chart 313
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.

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

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".

314 E3Chart
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.

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.

19.3.2 Opes do Menu Contextual


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

E3Chart 315
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
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

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.

316 E3Chart
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.

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

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.

E3Chart 317
Mensagens de status da parte de tempo real
MENSAGEM SIGNIFICADO
Erro: Parte de tempo real desconectada (YLink='Nome No houve conexo da parte de tempo real da Pena.
do Tag') (XLink='Nome do Tag') 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

Erro: Consulta: Falha na inicializao Antes de carregar os dados da 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 (XField = 'Nome do O campo informado na propriedade XField no foi
Campo') encontrado na consulta. Verifique se o campo est
selecionado na tela de edio da consulta ou no cdigo
SQL

Erro: Campo no encontrado (YField = 'Nome do O campo informado na propriedade YField no foi
Campo') encontrado na consulta. Verifique se o campo est
selecionado na tela de edio da consulta ou no cdigo
SQL

Erro: 'Nome da Consulta' 'Mensagem de Erro' Indica que houve um erro na 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 (QueryName = 'Nome da A consulta indicada pela propriedade QueryName da
Consulta') Pena no foi encontrada pelo 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 servidor No foi possvel trazer do servidor os resultados da


consulta
Falha ao pegar o nmero de registros do servidor No foi possvel trazer do servidor o total de registros
existentes na consulta
Falha ao posicionar o cursor para o incio No foi possvel posicionar o cursor no primeiro registro
da consulta

318 E3Chart
MENSAGEM SIGNIFICADO
Cursor ocupado Os registros da consulta no esto disponveis para
serem trazidos do servidor
Falha ao pegar os dados do servidor No foi possvel trazer do servidor os registros da
consulta
Erro desconhecido Houve um erro inesperado ao tentar trazer do servidor
os dados da consulta

E3Chart 319
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.

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.

320 E3Playback
Incluso do E3Playback em uma Tela
2. Abra a Lista de Propriedades e configure a propriedade DBServer do E3Playback para apontar para o objeto
Banco de Dados que contm os dados histricos do aplicativo.

Selecionando um Banco de Dados


3. Abra a Lista de Propriedades e configure a propriedade InitialScreen do E3Playback para apontar para o Quadro
"FrameApp".

E3Playback 321
Selecionando um Quadro para a propriedade InitialScreen
4. Abra a Tela "UpperMenu" e insira a imagem Stopwatch no canto superior direito (abra a Galeria e selecione a
categoria Misc Symbols 1).

Tela UpperMenu
5. Clique duas vezes na imagem Stopwatch, adicione o Pick Abrir Tela no evento Click para abrir a "TelaPlayback" no
Quadro principal e configure-o conforme as figuras a seguir.

Pick Abrir Tela

322 E3Playback
Configuraes do estilo da janela
6. Execute o aplicativo, abra o Viewer, clique em Portugus, depois em Preview de Aplicaes, e finalmente clique
no cone Stopwatch. Neste momento deve aparecer a Tela de playback.

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 323
Tela de playback em modo Online

20.3 Interface de Usurio


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

20.3.1 Barra de Ferramentas


A Barra de Ferramentas Playback rene os principais comandos para operao do E3Playback.

Barra de ferramentas Playback


Esta barra de ferramentas possui as opes descritas na tabela a seguir.
Opes disponveis na barra de ferramentas Playback
CONE COMANDO AO
Reproduzir para trs Inicia a reproduo 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

324 E3Playback
CONE COMANDO AO
Reproduzir Inicia a reproduo dos dados no
horrio atual de playback,
avanando o relgio de acordo
com a velocidade de reproduo
atual
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 velocidade Permite selecionar a velocidade
de playback
Data e hora atual Mostra a data e hora atual do
relgio de playback, e permite
selecionar uma nova data
Mostrar ou esconder a Linha de Mostra ou oculta a janela Linha
Tempo de Tempo do E3Playback

Mostrar ou esconder a Lista de Mostra ou oculta a janela Tags do


Tags E3Playback

Mostrar ou esconder a Lista de Mostra ou oculta a janela Eventos


Eventos do E3Playback

Iniciar ou parar a gravao de Permite gerar um vdeo (em


vdeo 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 E3Playback Permite capturar a rea de Tela
do ActiveX de playback. A Tela
capturada pode ser salva em um
arquivo BMP ou copiada para a
rea de Transferncia

Ao selecionar a ferramenta Gravao de Vdeo , a seguinte janela de configuraes mostrada.

E3Playback 325
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
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

326 E3Playback
OPO DESCRIO
Intervalo de quadros a cada quadro-chave Configura a quantidade de quadros a cada quadro-chave
(key frame)
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 gravao Habilita ou desabilita a janela que mostrada no
momento em que a gravao finalizada

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

E3Playback 327
OPO DESCRIO
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

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.

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 timestamp Adiciona um nome ao marcador na
selecionado linha de tempo, na data e hora
selecionadas
Editar marcador selecionado Permite editar o marcador
selecionado, podendo alterar data e
hora, nome ou descrio

328 E3Playback
CONE COMANDO AO
Remover o marcador Remove o marcador selecionado na
linha de tempo
Remover todos os marcadores Remove todos os marcadores
criados na linha de tempo
Mover para o marcador anterior Seleciona o marcador imediatamente
frente na linha de tempo e na lista
de eventos, simultaneamente
Mover para o marcador seguinte Seleciona o prximo 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

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

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.

E3Playback 329
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
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
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)

330 E3Playback
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.

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

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

E3Playback 331
CONE COMANDO AO
Prximo Evento Posiciona o relgio de playback no
prximo evento com timestamp maior
que o timestamp atual
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 Linha de Tempo Adiciona ou remove uma representao visual do Tag
selecionado na janela Linha de Tempo
Mostrar apenas os eventos deste tag ou Mostrar todos Filtra os eventos na Lista de Eventos para mostrar apenas
os eventos o Tag selecionado. Selecionando de novo esta opo,
todos os eventos so mostrados

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

332 E3Playback
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

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.

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>

E3Playback 333
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.

20.4.2 Consultas de Dados de Playback


A quantidade de dados disponvel para playback pode ser enorme, dependendo do aplicativo. Para tornar a
navegao de Telas mais suave, o E3Playback executa consultas ao banco de dados em perodos de tempo
chamados Fatias.
Cada fatia de dados de playback tem uma largura fixa de um dia. Sempre que o relgio posicionado em uma
determinada data e hora, o E3Playback cria ou encontra a fatia de tempo que contm a data e hora atual. Cada fatia
de dados possui as seguintes informaes:
Perodo de tempo da fatia (data e hora inicial e final)
Uma lista dos Tags que j tm os seus dados carregados na fatia
Para cada Tag armazenado em uma fatia, so mantidos os seguintes dados:
O ltimo evento do Tag anterior ao incio da fatia
Todos os eventos do Tag dentro do intervalo da fatia
O prximo evento do Tag aps o final da fatia
O sumrio de alarmes no momento do incio da fatia
Todos os eventos de alarmes que ocorreram durante o intervalo da fatia
O prximo evento de alarme de cada Fonte de Alarme aps o final da fatia

Quando o relgio de playback movido sobre uma fatia de tempo, o E3Playback analisa se todos os Tags necessrios
j esto carregados na fatia, e se todas as informaes de alarme tambm j foram carregadas. Se estiver faltando
algum dado, ento gerada uma consulta assncrona para carregar os dados necessrios do banco de dados. Uma
consulta de dados de playback composta dos seguintes parmetros:
Perodo que vai ser consultado (data e hora inicial e final)
Conjunto de Tags que devem ser consultados (pode estar vazio). Para cada Tag deve ser retornado:
O ltimo evento anterior ao incio da consulta
Todos os eventos ocorridos durante o perodo da consulta
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
334 E3Playback
de playback avana, as consultas de dados vo sendo feitas, e quando o relgio passa para a prxima fatia bem
provvel que ela j tenha todos os seus dados carregados.
Caso o relgio de playback esteja no modo Reproduzir e entre em uma fatia sem dados ou com dados incompletos,
o E3Playback fica temporariamente pausado aguardando at que as consultas daquela fatia sejam completadas.
O E3Playback tambm busca minimizar o acesso ao banco de dados, aproveitando as informaes dos campos
ltimo evento anterior, Prximo evento aps, Sumrio anterior e Sumrio posterior para evitar que estes dados
sejam consultados novamente. Por exemplo:
Se uma consulta a um Tag no retornou o prximo evento aps o perodo da consulta, sinal de que este Tag
no possui nenhum evento aps a data e hora final da consulta, e portanto este Tag no precisa ser consultado
nas fatias de tempo posteriores
Se uma consulta retornou o sumrio anterior, eventos de alarmes no perodo e o sumrio posterior para uma
fatia, possvel calcular o sumrio anterior da prxima fatia simplesmente combinando o sumrio anterior e os
eventos ocorridos durante a fatia atual. Desta forma, torna-se desnecessrio consultar no banco de dados o
sumrio anterior da prxima fatia

20.5 Configurao dos Objetos de Banco de Dados do E3


Esta seo explica como os objetos do E3 devem ser configurados para que os dados armazenados no banco de
dados possam ser utilizados no E3Playback.

20.5.1 Storage
A nica recomendao para o Storage que a coluna Fonte no deve conter expresses, pois elas no podem ser
utilizadas no playback.
O E3 j cria automaticamente nas tabelas de Storage os ndices necessrios para otimizar as consultas do E3Playback.

20.5.2 Alarmes
Para executar o playback de alarmes, siga estes procedimentos:
1. Habilite ou configure o registro de alarmes em disco.
2. Selecione os seguintes campos para registro (obrigatrios):
EventTime (mais EventTimeMS) ou EventTimeDbl
FullAlarmSourceName
ConditionActive
Acked
AckRequired
3. Ainda recomendada a seleo dos seguintes campos para registro:
InTime (mais InTimeMS) ou InTimeDbl
OutTime (mais OutTimeMS) ou OutTimeDbl
AckTime (mais AckTimeMS) ou AckTimeDbl
Area
ActorID
Enabled
EventCategory
EventType
Message
Severity
Source
SubConditionName
CurrentValue

E3Playback 335
Seleo dos campos
O E3 j cria automaticamente na tabela de alarmes os ndices necessrios para otimizar as consultas de playback.

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

Definio do ndice para o campo E3TimeStamp

336 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 337
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.

Inserindo uma Frmula

NOTA
O objeto Frmula pode ser configurado para funcionar como rea de Alarme.

21.1 Configuraes
Quando se cria uma Frmula, mostrada uma janela para a configurao do Banco de Dados e da tabela a ser
utilizados. Sem isto, no possvel a criao de Unidades e Conjuntos de Valores.

338 Frmulas
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

Tamanho mximo dos campos de Unidades Determina o tamanho mximo dos 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 Valores Determina o tamanho mximo dos campos de Valores na
tabela do Banco de Dados. O valor padro deste campo
200. Este campo equivale propriedade ValueSize da
Frmula

Caso seja necessrio configurar estas opes posteriormente, ou mesmo reconfigur-las, selecione a opo
Configurar Banco de Dados no menu contextual da Frmula.

Frmulas 339
Configurando o Banco de Dados

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

340 Frmulas
OPO DESCRIO
Tipo Define o tipo do Template

Restries Determina as restries do Template

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

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.

342 Frmulas
Opes disponveis na aba Valores
OPO DESCRIO
Nome Determina o nome do Template

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.

21.5.1 Procedimentos
1. Insira um objeto Frmula na aplicao.
2. Configure o Banco de Dados e a tabela. Use um Banco de Dados existente no projeto, e nomeie a tabela como
"Produo".

Configuraes do Banco de Dados e da tabela


3. Crie trs Templates na Frmula:
Dimetro Externo: Com restrio de valor absoluta entre 50 e 80
Dimetro Interno: Com restrio por diferena de valor de 10 e 10
Altura: Com limite restrito

Templates
4. Na prxima etapa so definidas as Unidades relativas a esta Frmula. Antes de criar as Unidades, no entanto,
deve-se criar os Tags usados nesta Frmula. Para isto, insira em um Servidor de Dados uma Pasta chamada
"Formula" e dentro dela outras duas Pastas chamadas "Maquina1" e "Maquina2". Dentro destas Pastas crie trs
Tags Internos para cada uma.

Frmulas 343
Criando Tags
5. Crie na Frmula duas Unidades chamadas "Maquina1" e "Maquina2". Associe cada campo destas Unidades aos
Tags criados anteriormente.

Associando os Tags s Unidades da Frmula


6. Defina os Conjuntos de Valores a serem carregados posteriormente nos Tags. Crie quatro Conjuntos de Valores,
chamados de "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".

344 Frmulas
8. Crie seis objetos SetPoint nesta Tela, que devem ser associados a cada um dos Tags da Frmula, e ajuste o
tamanho da Tela ao dos objetos. A Tela deve estar semelhante figura a seguir.

Tela de Frmula

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

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.

Frmulas 345
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.Load