Você está na página 1de 867

Manual do Usurio do E3

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


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

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

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

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

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

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

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


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

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

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


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

Alarmes e Eventos: Monitoram o acontecimento de situaes especficas

Histricos: Armazenam os dados em bancos de dados relacionais

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

1.1 Descrio Geral


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

As funes bsicas do software esto divididas em mdulos independentes,


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

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


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

O E3 possui quatro programas principais, descritos a seguir.

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

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

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

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

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

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


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

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

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


mesmo tempo

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


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

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


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

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

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

Os projetos da aplicao residem somente no servidor

O navegador Internet Explorer pode ser usado como interface de


operao, sem nenhuma mudana

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


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

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


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

Introduo 5
Arquitetura do E3

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

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

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

Diagrama dos blocos que compem o E3

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

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


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

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


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

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


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

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

Permite salvar projetos com at 20 Tags de Comunicao

No permite trabalhar com servidores em modo Hot-Standby

No permite trabalhar com Domnios Remotos

S permite a comunicao com um Driver de Comunicao de nvel 0


(zero), sem limite de Tags. Drivers com nvel maior do que 0 (zero) no
so permitidos

No permite acesso s configuraes do Domnio (menu contextual


Domnio - Opes do cone do E3 Admin na rea de Notificaes do
Windows)

Somente a primeira imagem de cada categoria da Galeria de Smbolos


est disponvel

S permite a abertura de um Viewer ou WebViewer

O tempo mximo de execuo de um Domnio de duas horas

S permite a gravao de no mximo 20 Tags de Comunicao em um


objeto Storage

Permite acesso como OPC Server

Permite executar o playback das ltimas seis horas de dados, em relao


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

No permite utilizar a ferramenta de Exportao de Usurios do E3


Admin

No permite utilizar a ferramenta de Importao e Exportao do E3


Studio

10 Introduo
CAPTULO
E3 Studio
2
O E3 Studio o ambiente de desenvolvimento do E3. Nele, possvel a
criao e manuteno de Domnios, projetos e bibliotecas.

Caminho indicado pelo sistema quando o E3 instalado

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

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

cone do E3 Studio

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


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

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

Janela Iniciar o E3 Studio

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


seguir.

Opes disponveis na janela Iniciar o E3 Studio

OPO DESCRIO
Iniciar o E3 Studio No abre nenhum Domnio

Criar um Domnio novo Requisita o nome e caminho do novo


Domnio

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

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

rea de trabalho do E3 Studio

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


objeto cujo Editor esteja sendo mostrado na rea de trabalho.

A Barra de Status mostra informaes de ajuda a respeito da rea da tela,


sobre a qual est o ponteiro do mouse.

A Barra de Ferramentas mostra os objetos, componentes e demais recursos


que podem ser utilizados na Tela e no E3.

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

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

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

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

Aba Comandos

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

Opes disponveis na aba Comandos

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

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

Descrio Breve descrio da opo


selecionada

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

Aba Barra de ferramentas

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

Opes disponveis na aba Barra de ferramentas

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

Restaurar Restaura a barra de ferramentas


desejada no E3

Restaurar tudo Restaura todas as barras de


ferramentas no E3

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

Renomear Muda o nome da barra de


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

Remover Remove a barra de ferramentas


selecionada

Mostrar legendas Mostra uma legenda nas opes da


barra de ferramentas selecionada

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

Aba Menus

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

Opes disponveis na aba Menus

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

Restaurar Restaura o menu definido na opo


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

E3 Studio 21
OPO DESCRIO
Animao dos menus Seleciona o tipo de animao usada
nos menus: Nenhuma (padro do
E3), Desdobrar, Deslizar, Fade e
Default (padro do Windows)

Menus com sombra Define se o menu apresenta o efeito


de sombreado ou no

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

Aba Aparncia

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

Opes disponveis na aba Aparncia

OPO DESCRIO
Office XP Configura a aparncia do E3 Studio
como no Office XP

Windows XP Configura a aparncia do E3 Studio


como no Windows XP (no
disponvel no estilo Windows
Clssico)

E3 Studio 23
OPO DESCRIO
Office 2000 Configura a aparncia do E3 Studio
como no Office 2000

Office 2003 Configura a aparncia do E3 Studio


como no Office 2003

VS.Net 2005 Configura a aparncia do E3 Studio


como no Visual Studio .NET 2005

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

Aba Opes

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

Opes disponveis na aba Opes

OPO DESCRIO
Mostrar descries Habilita o E3 a mostrar uma breve
descrio nas opes das barras de
ferramentas e menus quando o
ponteiro do mouse posicionado
sobre um item

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


descrio do boto

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

26 E3 Studio
2.3.2 Outras Configuraes
Pode-se configurar o Editor de Scripts do E3, bem como outras opes dos
arquivos do Domnio, atravs do menu Ferramentas - Opes, onde tem-se
acesso janela de configuraes mostrada nas figuras a seguir.

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


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

Aba Geral

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

Opes disponveis na aba Geral

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

Abrir a Janela de Propriedades Abre a Janela de Propriedades de


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

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


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

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

Aba Editor de Scripts

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

Opes disponveis na aba Editor

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

E3 Studio 29
OPO DESCRIO
Tamanho da margem Tamanho da margem da marcao
do bloco de cdigo

Numerao da linha Habilita a numerao de linha no


editor de scripts

Tamanho da margem Tamanho da margem que contm a


numerao de linha

Tamanho do Tab Determina o nmero de espaos de


tabulao

Fonte Determina o nome da fonte a ser


usada no editor de scripts

Tamanho Determina o tamanho da fonte a ser


usada no editor de scripts

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

Arquivos: Habilita ou desabilita a opo Ignorar verificao de CRC

Aba Arquivos

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

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


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

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


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

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

2.4 Barra de Ferramentas


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

Opes disponveis na barra de ferramentas Padro

CONE COMANDO AO
Novo Projeto Cria um novo projeto

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

Salvar Projeto Salva o projeto

Salvar Tudo Salva todo o Domnio

Recortar Remove a informao


selecionada e a move
para a rea de
Transferncia

Copiar Copia a informao


selecionada e a move
para a rea de
Transferncia

Colar Cola a informao


selecionada da rea de
Transferncia

Desfazer Desfaz a ltima ao


executada

Refazer Refaz a ltima ao


desfeita pelo item
Desfazer

Organizer Mostra ou esconde o


Organizer

Galeria Mostra ou esconde a


Galeria

Lista de Propriedades Mostra ou esconde a


Lista de Propriedades

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

Mostrar no Organizer Mostra o objeto no


Organizer, se este
estiver selecionado no
Editor do objeto

Executar Aplicativo Salva todos os projetos


e bibliotecas, executa o
Domnio e abre o
Viewer

Rodar ou Parar Executa ou para o


Domnio Domnio corrente

Executar ou Parar E3 Executa ou para o E3


Viewer Viewer

Verificar Domnio Verifica se o Domnio


contm erros

Erro Anterior Mostra o erro anterior


encontrado no Domnio

Prximo Erro Mostra o prximo erro


encontrado no Domnio

Desfragmentar Desfragmenta o arquivo


Arquivos especificado

Procurar ou Substituir Procura todas as


ocorrncias de um
determinado texto em
todo o Domnio

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

Documentao de Gera a documentao


Scripts dos scripts

Relatrio de Verses Mostra as verses dos


projetos e bibliotecas

WatchWindow Mostra os valores de


Tags e de propriedades
no E3 Studio em tempo
de execuo

Opes disponveis na barra de ferramentas Sombra

CONE COMANDO AO
Sombra do Objeto Aplica uma sombra no
objeto

Sombra Acima Desloca a sombra para


cima do objeto

Sombra Abaixo Desloca a sombra para


baixo do objeto

Sombra Esquerda Desloca a sombra para


a esquerda do objeto

Sombra Direita Desloca a sombra para


a direita do objeto

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

Opes disponveis na barra de ferramentas Objetos

CONE COMANDO AO
E3Alarm Insere um objeto do
tipo E3Alarm

E3Browser Insere um objeto do


tipo E3Browser

E3Chart Insere um objeto do


tipo E3Chart

Caixa de Seleo Insere um objeto do


tipo Caixa de Seleo
(CheckBox)

Boto de Opo Insere um objeto do


tipo Boto de Opo
(OptionButton)

Lista de Seleo Insere um objeto do


tipo Lista de Seleo
(ComboBox)

Boto de Comando Insere um objeto do


tipo Boto de
Comando
(CommandButton)

Texto Insere um objeto do


tipo Texto (Label)

Lista Insere um objeto do


tipo Lista (ListBox)

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

Boto Incremento- Insere um objeto do


Decremento tipo Boto Incremento-
Decremento
(SpinButton)

Editor de Texto Insere um objeto do


tipo Editor de Texto
(TextBox)

Boto Liga-Desliga Insere um objeto do


tipo Boto Liga-
Desliga (ToggleButton)

Opes disponveis na barra de ferramentas Tela

CONE COMANDO AO
Selecionar Habilita o modo de
seleo

Mover Habilita o recurso de


mover (pan) a Tela

Rotacionar Habilita o modo de


rotao

Ordem dos Tabs Mostra o


identificador de
ordem de navegao
entre os objetos

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

Linha Insere um objeto do


tipo Linha

Conector Insere um objeto do


tipo Conector

Retngulo Insere um objeto do


tipo Retngulo

Retngulo Insere um objeto do


Arredondado tipo Retngulo
Arredondado

Elipse Insere um objeto do


tipo Elipse

Arco de Elipse Insere um objeto do


tipo Arco de Elipse

Desenho Livre Insere uma


ferramenta de
desenho livre

Polgono Insere um objeto do


tipo Polgono

Polgono de Curvas Insere um objeto do


tipo Polgono de
Curvas

Figura Insere um objeto do


tipo Imagem

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

Display Insere um objeto do


tipo Display

SetPoint Insere um objeto do


tipo SetPoint

Escala Insere um objeto do


tipo Escala

Agrupar Agrupa uma seleo


de objetos

Desagrupar Desagrupa uma


seleo de objetos

Animar com Insere uma


Translao ferramenta para
movimentos lineares

Animar com Rotao Insere uma


ferramenta para
rotao

Trazer para a Frente Traz o objeto para a


frente em um
agrupamento (ALT +
HOME)

Enviar para Trs Envia o objeto para


trs em um
agrupamento (ALT +
END)

Avanar Move um objeto uma


posio acima no
agrupamento (ALT +
PAGE UP)

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

Zoom Permite editar o nvel


de zoom da Tela

Camadas Permite editar as


camadas de objetos
na Tela

Opes disponveis na barra de ferramentas Desenho

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

Cor de Frente Define a cor da frente


do objeto

Cor da Borda Define a cor da borda


do objeto

Estilo da Borda Define o estilo da


borda do objeto

Espessura da Borda Define a espessura da


borda do objeto

Estilo de Define o estilo de


Preenchimento preenchimento do
objeto

40 E3 Studio
Opes disponveis na barra de ferramentas Alinhamento

CONE COMANDO AO
Alinhar Esquerda Alinha objetos
esquerda

Alinhar Direita Alinha objetos direita

Alinhamento Superior Alinha objetos pelo


topo

Alinhamento Inferior Alinha objetos pela


base

Mesma Largura Aplica a mesma largura


a todos os objetos

Mesma Altura Aplica a mesma altura a


todos os objetos

Mesmo Tamanho Aplica o mesmo


tamanho aos objetos
selecionados

Centralizar Centraliza os objetos


Horizontalmente horizontalmente

Centralizar Centraliza os objetos


Verticalmente verticalmente

Distribuir Formata o espaamento


Horizontalmente entre objetos na
horizontal

Distribuir Formata o espaamento


Verticalmente entre objetos na vertical

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

Espelhar Verticalmente Aplica uma reflexo


vertical no objeto
selecionado

Grade Mostra ou esconde a


grade

Opes disponveis na barra de ferramentas Formatao

CONE COMANDO AO
Fonte Determina a fonte do
texto

Tamanho da Fonte Determina o


tamanho da fonte

Cor da Fonte Determina a cor da


fonte

Fonte em Negrito Formata o texto em


negrito

Fonte em Itlico Formata o texto em


itlico

Fonte Sublinhada Formata o texto com


sublinhado

Texto Esquerda Alinha o texto


esquerda

Texto Centralizado Centraliza o texto

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

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

Janela Contagem de Objetos do Domnio

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

Opes disponveis na janela Contagem de Objetos do Domnio

CONE OPO DESCRIO


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

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

Atualizar Atualiza a contagem de


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

Contar filhos de Inclui na contagem os


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

Procurar Permite filtrar a


listagem pelo nome ou
parte do nome do
objeto

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

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

Atravs do cone da barra de ferramentas Padro. Utilizando esta


opo, so gravados no arquivo todos os scripts do Domnio

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


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

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

46 E3 Studio
Assistente de Documentao de Scripts

Na janela Arquivo de documentao so definidas as informaes referentes


ao arquivo que guarda os scripts da aplicao.

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


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

E3 Studio 47
Arquivo de documentao de scripts

Clique em Avanar para ir prxima janela.

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


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

48 E3 Studio
Detalhamento do arquivo

Por exemplo, o script a seguir:


Sub TelaInicial_KeyDown(KeyCode, Shift)
If (KeyCode = 27) Then
Application.Exit
End Sub

Se a opo selecionada Apenas os nomes dos scripts, o texto a seguir


gravado no arquivo:
TelaInicial_KeyDown(KeyCode, Shift)

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


com a mesma formatao (identao, linhas em branco, etc.) realizada pelo
usurio no editor de scripts.

Independente do tipo de formatao escolhida, antes do script gravado um


identificador contendo o nome completo do objeto, para evitar conflitos. Por
exemplo, para os seguintes objetos:

E3 Studio 49
TelaInicial
CommandButton1
Tela1
CommandButton1

Ambos os scripts (considerando um mesmo evento, Click) seriam


CommandButton1_Click(). Assim, a gravao no arquivo ficaria desta forma:
<TelaInicial.CommandButton1:CommandButton1_Click()>
Sub CommandButton1_Click()
...
End Sub

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

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


prxima janela.

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


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

50 E3 Studio
Separador de scripts

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


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

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

Algumas observaes relevantes:

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


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

Picks so internamente scripts. Logo, tambm so documentados

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


dentro de cada projeto ou biblioteca

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


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

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

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

A ferramenta Substituir substitui as ocorrncias encontradas por outro texto


especificado.

Janela Procurar/Substituir

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

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


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

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


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

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


procura efetuada em todo o Domnio

As opes disponveis esto descritas na tabela a seguir.

Opes disponveis na ferramenta Procurar/Substituir

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

Procurar Inicia a busca pelo texto

Apenas nos resultados Refaz a pesquisa apenas entre os


resultados da pesquisa anterior

Diferenciar maisculas de Procura pelo texto exatamente como


minsculas foi escrito, diferenciando maisculas
de minsculas

Palavras inteiras Procura o texto especificado como


uma palavra inteira. No considera o
texto como uma substring de outro

Substituir por Contm o texto a ser utilizado na


substituio

Substituir Inicia o processo de substituio

Uma a uma Executa a substituio da linha


selecionada e seleciona a prxima
linha vlida

Todas Substitui, de uma s vez, todas as


ocorrncias do texto

Apenas as selecionadas Substitui, de uma s vez, todas as


ocorrncias selecionadas na lista de
resultados

ou Mostra ou esconde as opes de


pesquisa e substituio

Seleciona na lista de resultados a


ocorrncia anterior

Seleciona na lista de resultados a


ocorrncia seguinte

E3 Studio 55
NOTA
Para selecionar o objeto e mostrar o local exato onde o texto se encontra,
clique duas vezes na lista de resultados, na linha desejada.

A tabela a seguir contm as principais opes de pesquisa, bem como as


limitaes para os principais tipos de dados.

Principais opes de pesquisa

TIPO DE DADOS EXEMPLO OBSERVAO


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

Inteiro 0 Encontra em todas as


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

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

Cor 255,255,0 Encontra apenas em


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

Booleano Verdadeiro Leva em considerao o


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

String Teste Encontra Strings inteiras


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

E3 Studio 57
2.4.4 Relatrio de Verses
A ferramenta Relatrio de verses permite a visualizao das verses e
comentrios dos projetos e das bibliotecas abertos, pertencentes ou no ao
Domnio. Para acessar esta ferramenta, clique em na barra de ferramentas
Padro para mostrar a caixa de dilogo da figura a seguir.

Relatrio de verses

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

Opes disponveis na caixa de dilogo Relatrio de verses

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

58 E3 Studio
OPO DESCRIO
Verso Indica a verso do projeto ou
biblioteca. Esta verso gerada
internamente pelo E3, sendo
incrementada toda vez que o projeto
salvo, manual ou automaticamente.
No caso de projetos ou de
bibliotecas protegidos, se a verso
no puder ser salva, tambm no
possvel increment-la. No entanto,
se o usurio tem permisso para
abrir e alterar o projeto ou a
biblioteca, a verso incrementada
normalmente

Comentrio Mostra o comentrio relacionado ao


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

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

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

Verificao de Erros no Projeto

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


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

Mensagem do Item Verificar Domnio

A opo Verificar Domnio pode ser acessada das seguintes maneiras:

60 E3 Studio
Atravs do cone , disponvel na barra de ferramentas Padro:
Verifica os erros ocorridos em todo o Domnio

Atravs do menu Ferramentas - Verificar Domnio: Mesmo


funcionamento da opo anterior

Clicando com o boto direito do mouse em um item do projeto e


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

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

Caixa de dilogo WatchWindow

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

Opes disponveis na caixa de dilogo WatchWindow

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

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

Atualizar Busca toda a rvore de filhos dos


objetos selecionados atualmente na
janela WatchWindow

Conectar Tenta reativar a conexo perdida


com o Domnio para que a
visualizao seja possvel

Nome Indica o Tag ou a propriedade


visualizada

Qualidade Indica a qualidade do Tag ou da


propriedade

Estampa de Tempo Indica a estampa de tempo do Tag


ou da propriedade

Valor Indica o valor do Tag ou da


propriedade, em tempo de execuo

Status Indica se o Domnio est conectado


ou desconectado

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

Janela Edio de Arrays

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

64 E3 Studio
2.5 Organizer
O Organizer permite uma viso simples e organizada de toda a aplicao,
ajudando na edio e configurao de todos os objetos envolvidos, atravs
de uma rvore hierrquica de opes. Possui dois modos de visualizao,
Domnio e Explorer.

Organizer

O modo Domnio mostra apenas as informaes dos objetos abertos


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

E3 Studio 65
Modo Domnio

O grupo Configurao mostra os servidores configurados, bem como os


nomes dos arquivos de projetos e de bibliotecas pertencentes ao Domnio.

O grupo Bibliotecas de Objetos agrupa os objetos ElipseX de todas as


bibliotecas pertencentes ao Domnio, organizados por tipo de objetos
(XControls, XFolders e XObjects).

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


Servidor. Em Visualizao esto os objetos que executam na mquina cliente.
J os objetos executados na mquina servidor esto em Objetos de Servidor.

O modo Explorer mostra projetos e bibliotecas abertos no E3 Studio,


pertencentes ou no ao Domnio. Os objetos so mostrados no projeto ou na
biblioteca ao qual pertencem, ordenados alfabeticamente dentro de cada um.

66 E3 Studio
Modo Explorer

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


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

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


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

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


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

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


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

4. Em qualquer Editor de objetos, na aba Design, clique com o boto direito


do mouse no objeto e selecione Mostrar no Organizer ou Mostrar no
Explorer para visualiz-lo no Organizer, em seu respectivo modo.

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

Opes disponveis no Organizer

OPO DESCRIO
Fechar Fecha o projeto ou biblioteca corrente

Atualizar Atualiza as configuraes do projeto


ou biblioteca

Registrar Registra a biblioteca para que as


modificaes executadas estejam
disponveis

Salvar Como Abre uma caixa de dilogo para que


o projeto ou a biblioteca sejam salvos
no local indicado

Desfragmentar Desfragmenta arquivos (.lib ou .prj),


isto , faz com que os espaos
criados desnecessariamente (por
excluso de itens, importao de
arquivos, incluso de recursos, etc.)
sejam apagados. Aps a
desfragmentao, uma janela
exibida contendo as seguintes
informaes: tamanho original do
arquivo, tamanho desfragmentado e
percentual de compactao

Proteo Protege o contedo de um arquivo


.prj ou .lib contra a edio,
visualizao ou execuo no
autorizada. Maiores informaes no
captulo Segurana

Nova Pasta Cria uma nova Pasta na aplicao

68 E3 Studio
OPO DESCRIO
Inserir Insere objetos disponveis no E3 no
projeto ou na biblioteca. Mais
informaes sobre esta opo nos
respectivos captulos de cada objeto

Inserir Recurso Insere recursos no projeto ou na


biblioteca

Habilitar/Desabilitar projeto Habilita ou desabilita o projeto


selecionado. Para desabilitar o
projeto, clique com o boto direito do
mouse no projeto e selecione a
opo Desabilitar projeto. Observe
que o cone do projeto muda para
, indicando que o projeto est
desabilitado. Para habilitar o projeto,
clique com o boto direito do mouse
no projeto e selecione a opo
Habilitar projeto. NOTA: O cone de
desabilitado tambm mostrado
para projetos que no fazem parte do
Domnio

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


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

Procurar/Substituir Busca por trechos de texto e os


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

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

Importar/Exportar Auxilia o usurio na importao e na


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

Documentar Scripts Auxilia o usurio com a documentao


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

Verificar Verifica os erros ocorridos na


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

Editar Associaes Muda uma ou mais Associaes,


eventos de usurio e propriedades do
tipo Link feitas na aplicao, de forma
mais rpida do que pela janela
tradicional. Maiores informaes
sobre esta opo no captulo
Associaes

70 E3 Studio
OPO DESCRIO
Copiar/Colar Associaes Copia ou cola Associaes de um
objeto para outro. A segunda opo
s mostrada se o que estiver
copiado na rea de Transferncia do
Windows for uma Associao. Se a
propriedade em questo j possuir
uma Associao, mostrada uma
mensagem ao usurio perguntando
se a Associao deve ser sobrescrita
ou no.

Se as Associaes copiadas na rea


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

Propriedades Abre a janela de propriedades do


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

Carregar Todos os Objetos Carrega todos os objetos do grupo


selecionado

E3 Studio 71
OPO DESCRIO
Fechar Todos os Objetos Fecha todos os objetos do grupo
selecionado

Salvar Todos os Objetos Salva todos os objetos do grupo


selecionado

Novo Arquivo de Aplicao (.prj) Cria um novo arquivo .prj e o inclui no


Domnio

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


Domnio

Registrar bibliotecas carregadas Registra todas as bibliotecas

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


do Domnio. Se algum arquivo
fechado for encontrado, ele aberto.
Se o arquivo estiver protegido com
senha de edio, solicitada a sua
senha. O E3 Studio tenta utilizar a
mesma senha em todos os arquivos
protegidos. Se a senha falhar com
algum arquivo, ela solicitada
novamente

Fechar Todos os Arquivos Fecha todos os arquivos .prj e .lib do


Domnio. Se algum arquivo tem
alteraes no salvas, perguntado
para o usurio se ele deseja salv-las

Editar a Ordem de Ativao Permite editar a ordem de ativao


dos objetos de Servidor no Domnio
(veja a figura a seguir)

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

Ordem de Ativao do Domnio

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

A ferramenta de exportao de objetos do E3 tem como objetivo gravar


informaes sobre os objetos selecionados a partir do ambiente de
configurao (E3 Studio) em um arquivo CSV. Para cada objeto podem ser
gravadas suas propriedades, Associaes e itens de colees. possvel,
portanto:

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


sejam diretamente objetos filhos do projeto ou biblioteca

Importar ou exportar qualquer propriedade de qualquer tipo de objeto


do E3

Importar ou exportar qualquer tipo de Associao de objetos do E3

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


propriedades

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

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


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

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


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

74 E3 Studio
NOTA
A ferramenta de importao e exportao considera apenas as
propriedades e Associaes dos objetos e colees do E3. Informaes que
no estejam descritas em propriedades no so importadas ou exportadas.
Este o caso, por exemplo, de scripts e configuraes internas dos objetos
de Tela.

2.6.1 Arquivo CSV


Um arquivo CSV (Comma Separated Values) um arquivo texto baseado em
colunas separadas por vrgula, ou por outro separador previamente definido.
No E3, eles contm as informaes sobre os objetos que foram exportados, e
so utilizados na importao para que estes objetos sejam criados
corretamente no E3 Studio. Cada coluna do arquivo CSV representa uma ou
mais propriedades de objetos do E3. Cada linha do arquivo representa um
objeto, Associao ou item de coleo. Para que estes arquivos sejam
utilizados corretamente, preciso observar alguns detalhes:

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


as colunas corretamente

O cabealho deve ter obrigatoriamente uma coluna que identifica o tipo


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

O cabealho das demais colunas deve ser o prprio nome da


propriedade em questo

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


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

E3 Studio 75
2.6.1.1 Criando um Arquivo CSV Manualmente

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


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

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


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

importante tambm que o arquivo CSV tenha uma coluna para a


propriedade Name. Sem esta coluna, no possvel determinar exatamente
onde o objeto em questo deve ser criado. Os nomes mostram a hierarquia
correta do objeto, e nomes com caracteres especiais devem ser delimitados
por colchetes. Caso o nome do objeto comece com nmeros, este nome
tambm deve ser delimitado por colchetes.

A seguir, um exemplo de um arquivo CSV que pode ser criado manualmente


no Excel.

1. Abra o Excel e configure o cabealho com os campos, um em cada


coluna, conforme a figura a seguir.

76 E3 Studio
Arquivo CSV visualizado no Excel

2. Salve a planilha com a extenso .csv.

3. Feche o arquivo no Excel.

4. Para importar este arquivo no E3, selecione um objeto IODriver e importe


o arquivo criado atravs da opo Importar, selecionando o modelo
adequado. O E3 cria a estrutura de acordo com o arquivo CSV.

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

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


opo Exportar.

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


Salvar.

Exportao de Objetos

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


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

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

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

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


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

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


opo Exportar.

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

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


Salvar.

Para importar objetos, siga estes procedimentos:

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

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

Importao de Objetos

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


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

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


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

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

Linhas iniciadas por ponto e vrgula so comentrios, desconsiderados na


interpretao do arquivo

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


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

Linhas em branco so ignoradas

Um exemplo de arquivo INI mostrado a seguir:


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

O formato um texto facilmente modificvel pelo usurio, sendo possvel


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

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


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

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


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

E3 Studio 81
Sees definidas para os Modelos

SEO DESCRIO
Header (*) Define os identificadores permitidos
para nomes de colunas e tipos de
dados. Nesta seo devem ser
definidas as variveis header e
types.

(*) Seo obrigatria para a


exportao

Configuration Define configuraes adicionais para


a ferramenta de importao e
exportao. Nesta seo devem ser
definidas as variveis separator,
root, link, collection,
objectduplicated e bindduplicated

Types Relaciona os identificadores de tipos


de dados com as classes de objetos
reais. Cada identificador listado na
varivel types que no for igual a um
nome de classe de objeto deve estar
documentado nesta seo, sendo
criada uma varivel para cada um
dos identificadores

Columns Relaciona os identificadores de


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

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

Variveis definidas para os Modelos

SEO DESCRIO
header (*) Define a ordem das colunas e os
identificadores que so utilizados.
Devem ser listadas todas as colunas
que o arquivo CSV tem, separadas
por vrgulas. Cada identificador que
no for igual a um nome de
propriedade deve ser discriminado na
seo Columns, cada um com uma
varivel.

(*) Varivel obrigatria para a


exportao

types Define os identificadores para os tipos


de dados permitidos no arquivo CSV.
Os identificadores devem ser listados
nesta varivel separados por vrgulas.
S necessrio definir esta varivel se
algum identificador for diferente do
nome da classe do objeto. Neste
caso, para cada um dos
identificadores deve haver tambm
uma varivel na seo Types

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

root Define se o objeto raiz exportado


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

link Define se as Associaes dos objetos


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

collection Define se as colees dos objetos so


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

84 E3 Studio
SEO DESCRIO
objectduplicated Define o que fazer quando um objeto
pr-existente estiver sendo importado.
Os valores possveis para esta varivel
so:

0 - askalways: Sempre questiona o


usurio sobre o que deve ser feito

1 - changealways: Sempre altera as


propriedades do objeto existente

2 - ignorealways: Sempre ignora o


objeto sendo importado

3 - createalways: Sempre cria um


objeto novo, auto-incrementando o
nome

Caso esta varivel no seja definida,


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

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

0 - askalways: Sempre questiona o


usurio sobre o que deve ser feito

1 - changealways: Sempre substitui


a Associao existente pela nova

2 - ignorealways: Sempre ignora a


Associao sendo importada

Caso esta varivel no seja definida,


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

collectionduplicated Define o que fazer quando uma


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

0 - askalways: Sempre questiona o


usurio sobre o que deve ser feito

1 - changealways: Sempre substitui


a coleo existente pela nova

2 - ignorealways: Sempre ignora a


coleo sendo importada

Caso esta varivel no seja definida,


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

86 E3 Studio
SEO DESCRIO
itemduplicated Define o que fazer quando um item de
coleo pr-existente estiver sendo
importado. Os valores possveis para
esta varivel so:

0 - askalways: Sempre questiona o


usurio sobre o que deve ser feito

1 - changealways: Sempre altera as


propriedades do item existente

2 - ignorealways: Sempre ignora o


item sendo importado

3 - createalways: Sempre cria um


item novo, auto-incrementando o
nome

Caso esta varivel no seja definida,


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

include Define quais classes de objetos devem


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

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

88 E3 Studio
NOTA
O caractere de ponto e vrgula no pode ser utilizado como nome ou parte
do nome da coluna, nem tampouco como nome ou parte do nome do
identificador de tipo. Esta limitao se deve ao fato de este caractere definir
um comentrio no arquivo INI. Desta forma, a varivel criada na seo
Columns ou na seo Types para definir o identificador que possui o ponto
e vrgula no pode ser lida corretamente.

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

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

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

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

[Filter]
exclude = IOFolder

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

NOTA
Na importao, as colunas utilizadas so lidas diretamente do arquivo CSV.
Neste caso especfico, no necessria a varivel header no modelo. Porm,
se alguma coluna for nomeada por um identificador, este deve estar
definido na seo Columns ou a coluna ignorada.

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

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


vlidas tanto para a importao quanto para a exportao

E3 Studio 91
Aba Configuraes

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

Opes disponveis na aba Configuraes

92 E3 Studio
OPO DESCRIO
Separador de colunas As opes disponveis so: Usar o
separador de listas do Windows
(escolhe o caractere definido no
Windows como separador de listas
para ser usado como separador de
colunas do arquivo CSV) ou Usar
outro caractere como separador
(escolhe outro caractere definido
pelo usurio como separador de
colunas)

Outras opes Define o que importado ou


exportado: objetos, Associaes ou
colees. As opes disponveis so:
Importar/exportar o objeto raiz,
Importar/exportar associaes ou
Importar/exportar colees

Salvar modelo Quando a opo Salvar as


alteraes deste modelo em um
arquivo INI for marcada, definido
o arquivo INI onde as alteraes do
modelo so salvas, e este arquivo
pode ser reutilizado. Quando for
desmarcada, as configuraes feitas
so salvas temporariamente em um
arquivo na pasta de arquivos
temporrios do Windows. Este
arquivo utilizado para a
importao ou exportao realizada
logo aps a configurao, e
removido posteriormente

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

Aba Importao

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

94 E3 Studio
Opes disponveis na aba Importao

OPO DESCRIO
Importao de objetos duplicados Especifica como o E3 deve lidar com
a ocorrncia de objetos duplicados
na importao. As opes
disponveis so Questionar sobre o
que fazer em cada caso, Sempre
sobrescrever o objeto existente,
Sempre ignorar o objeto duplicado
ou Sempre criar um novo objeto

Importao de associaes Especifica como o E3 deve lidar com


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

Importao de colees duplicadas Especifica como o E3 deve lidar com


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

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


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

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

Aba Filtros

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

Opes disponveis na aba Filtros

OPO DESCRIO
No filtrar objetos Define a importao ou a
exportao de todos os objetos

Incluir apenas estes objetos Define quais classes de objetos so


importadas ou exportadas

Excluir apenas estes objetos Define quais classes de objetos no


so importadas ou exportadas

Alterar Abre uma janela para seleo das


classes de objetos a serem includas
ou excludas

Ajuda Abre uma janela de ajuda para a


opo

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

Janela Classes de Objetos

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


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

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


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

98 E3 Studio
Aba Identificadores

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

Opes disponveis na aba Identificadores

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

Identificador Permite ao usurio alterar o valor a


ser utilizado na coluna ObjectType
do arquivo CSV. O valor inicial nesta
coluna sempre o nome da classe
do objeto. Para cada valor alterado
aqui, criada uma entrada no
arquivo INI na seo Types. Os
valores no so sensveis caixa
(isto , "AAA", "aaa" e "aAa" so o
mesmo valor). Caso o usurio defina
valores iguais para mais de um tipo,
apenas o primeiro tipo
considerado na importao, e algum
objeto pode ser criado com o tipo
errado

Adicionar Adiciona classes de objetos

Remover Remove a classe de objetos


selecionada

Ajuda Apresenta uma janela com texto de


ajuda

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

E3 Studio 101
Aba Propriedades

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

Opes disponveis na aba Propriedades

102 E3 Studio
OPO DESCRIO
Nome da coluna Permite ao usurio alterar o valor a
ser utilizado como nome da coluna
no cabealho do arquivo CSV. O
valor inicial desta coluna sempre o
prprio nome da propriedade do
objeto. Para cada valor alterado
nesta coluna, criada uma entrada
no arquivo INI na seo Columns.
Os nomes das colunas no so
sensveis caixa (isto , "AAA", "aaa"
e "aAa" so o mesmo valor). Caso o
usurio defina nomes de colunas
iguais para mais de uma
propriedade, apenas uma delas
identificada corretamente, e todas as
colunas com o mesmo nome so
relacionadas mesma propriedade.
Neste caso, algum valor pode ser
sobrescrito

Propriedade Indica a propriedade sendo


importada ou exportada

Para cima e Para baixo Redefinem a ordem das colunas ao


alterar a ordem das propriedades
na lista

Adicionar Adiciona propriedades lista

Remover Exclui propriedades da lista, com


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

E3 Studio 103
OPO DESCRIO
Nome da coluna Cria um nome de coluna associado a
mais de uma propriedade. Selecione
as propriedades que deseja agrupar
e clique nesta opo. Os nomes das
propriedades so agrupados em
uma mesma linha, utilizando o nome
da coluna definido para a
propriedade que est no topo da
lista

Ajuda Mostra uma janela com um texto de


ajuda

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

Janela Propriedades

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

Opes disponveis na janela Propriedades

OPO DESCRIO
Classes de objetos Apresenta as classes de objetos que
se enquadram no filtro escolhido a
partir do objeto raiz

Adicionar todas as propriedades Adiciona todas as propriedades do


tipo de objeto selecionado na
opo anterior

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

Propriedades Mostra as propriedades do objeto


selecionado

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

As propriedades do tipo TextFont possuem propriedades internas que


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

Propriedades do Tipo TextFont

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

2.6.5.1 Configurao de Alarmes

A exportao da Configurao de Alarmes feita automaticamente ao


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

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


rea.

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


Importar.

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


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

108 E3 Studio
2.6.5.2 Configurao e Tags de Servidores OPC

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


Driver OPC desejado.

2. Clique em Exportar.

Exportao de Configuraes e Tags de Servidores OPC

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


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

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

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

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

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


Importar.

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


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

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

Os Tags de Comunicao do Elipse SCADA so exportados separadamente


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

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


Driver desejado.

2. Clique em Exportar.

Exportao de Drivers

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


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

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

1. Insira um Driver de Comunicao no Organizer.

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


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

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


selecione o item Importar.

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


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

Importao de Tags

112 E3 Studio
2.6.5.4 Tags RAM e Demo

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

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

2. Clique em Exportar.

Exportao de Tags RAM e Demo

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


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

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

1. Insira um Servidor de Dados no Organizer.

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

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


opo Importar.

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


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

114 E3 Studio
2.6.5.5 Telas

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


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

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


desejada.

2. Clique em Exportar.

Exportao de Telas

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

4. No Organizer, insira uma nova Tela.

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


Importar.

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

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


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

Arquivos de imagens com caminhos relativos na aplicao Elipse


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

Arquivos de imagens com caminhos absolutos: Estes arquivos devem


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

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

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

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


Associaes feita atravs das seguintes palavras-chave:

AgSimple: Associaes Simples, Bidirecionais ou Reversas (estas devem


ser diferenciadas pelas propriedades Reverse e Bidirectional)

AnalogBind: Associaes Analgicas

AnimationBind: Associaes Digitais

TableBind: Associaes por Tabela

As propriedades ou os campos das Associaes so importados ou


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

AgSimple: Reverse, Bidirectional

AnalogBind: SrcHiValue, SrcLoValue, DstHiValue, DstLoValue

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


BlinkOffValue

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


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

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

Importao de uma Associao pr-existente

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


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

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

As colunas de cada coleo dependem das propriedades que esta coleo


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

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


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

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


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

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


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

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

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


final desta

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


informando que o nome no vlido, ou que j existe a coluna e o nome
no pode ser auto-incrementado (as colunas da Legenda tm nomes pr-
definidos e no possvel criar colunas com outros nomes)

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


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

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

IDispChartPen: Penas do E3Chart

E3 Studio 119
ILegendColumn: Legendas do E3Chart

IAxis: Eixos do E3Chart

ITableBindRow: Linhas das Associaes por Tabela

2.6.8 Logs e Relatrios de Falhas


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

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


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

Relatrio de falhas na importao

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

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


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

Lista de Propriedades ordenada


alfabeticamente

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


propriedades ordenadas por categoria.

E3 Studio 121
Lista de Propriedades ordenada por categoria

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

O rodap da Lista de Propriedades mostra uma descrio rpida da


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

Opes disponveis na Lista de Propriedades

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

Ordenar Mostra as
alfabeticamente propriedades do objeto
selecionado
organizadas
alfabeticamente

Procurar Permite filtrar a


listagem pelo nome ou
parte do nome da
propriedade

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


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

Opes disponveis no menu contextual de uma propriedade

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

Copiar Copia o valor da propriedade


selecionada para a rea de
Transferncia

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

Editar Permite editar o valor da


propriedade selecionada

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

2.8 Galeria
Coleo de objetos grficos que podem ser arrastados e inseridos nas Telas
das aplicaes. Estes objetos so arquivos do tipo Metafiles (WMF, Windows
MetaFile).

Galeria

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

AppBrowser

No quadro esquerda so mostrados os objetos do E3 que podem ser


utilizados para compor o texto que o resultado do uso do AppBrowser. De
acordo com seu contexto de utilizao, alguns objetos no podem ser
utilizados e nem so mostrados aqui.

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


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

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


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

E3 Studio 125
NOTAS
Ao selecionar Tags, o AppBrowser sempre aberto na ltima posio, e
no na posio apontada pelo link atual.
O AppBrowser possui a funo Auto Complete: basta digitar o nome do
objeto desejado para selecion-lo automaticamente.

Existem trs maneiras de se utilizar o AppBrowser:

Atravs de scripts

Atravs de Associaes

Atravs de algumas propriedades de objetos que possuem como valor


um outro nome de objeto

Cada uma destas maneiras abordada nos tpicos seguintes.

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

AppBrowser via Scripts

No quadro esquerda:

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


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

O segundo item a Hierarquia completa para se chegar ao objeto


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

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


mostrado o Viewer (objeto Application)

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


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

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

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


para uso em scripts

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


propriedades e seus mtodos.

2.9.2 Acesso via Associao


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

AppBrowser via Associaes

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


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

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

AppBrowser via Propriedade

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

DBServer dos objetos Frmula, Histrico e Storage

DataSource do objeto Servidor de Alarmes

InitialScreen do objeto Viewer

SplitLink do objeto Quadro

E3 Studio 129
2.10 Conectar A
A opo Conectar a utilizada para determinar a conexo do E3 Studio a um
servidor. Esta opo permite configurar em qual servidor de Domnio o E3
Studio deve se conectar, e permite tambm informar se o E3 Studio deve
obter a licena do servidor onde executa o Domnio ou se deve obter a
licena em um outro servidor. Para utilizar este recurso, clique no menu
Arquivo - Conectar a para abrir a caixa de dilogo mostrada na figura a
seguir.

Janela Conectar a

Opes disponveis na janela Conectar a

OPO DESCRIO
Conectar ao servidor local Habilita a conexo com o servidor
local

Conectar a um servidor na rede Habilita a conexo com um servidor


da rede. Para isto, selecione o
servidor usando a caixa de seleo

Pegar licena no servidor de Usa licena do servidor onde o


Domnio atual Domnio executa

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

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

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


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

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


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

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


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

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


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

NOTA
Quando o E3 Studio estiver utilizando uma licena emprestada de outro
servidor, ele deve forosamente permanecer aberto enquanto o aplicativo
estiver em execuo. Se ele for fechado enquanto o aplicativo estiver
executando, a licena de E3 Studio emprestada (que permite a execuo do
aplicativo por seis horas) liberada, e o E3 Server finaliza a execuo do
aplicativo imediatamente (em no mximo 10 segundos).

132 E3 Studio
DICA
Quando o usurio conectar a um servidor, importante que os aplicativos
sejam abertos atravs de um caminho na rede. Ao invs de usar C:\projetos
\projeto.dom, utilize o caminho \\server\projetos\projetos.dom. Desta
forma, o E3 Studio e o E3 Server remoto podem acessar os arquivos
utilizando o mesmo caminho.

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

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


superviso, composto pelos mdulos descritos nas sees a seguir.

3.1 E3 Server
O E3 Server o coordenador de todos os mdulos do E3. Ele sempre
executa como servio, mesmo no modo Demo, seja ele registrado como
servio ou com o parmetro /regserver, e deve estar sempre em execuo.
Pode tambm ser iniciado quando um E3 Studio local for iniciado, ou atravs
de um atalho para executar o Domnio (por exemplo, e3admin -start
app.dom). Ele responsvel por:

Verificar e gerenciar licenas de uso dos diferentes mdulos do E3

Iniciar, parar ou monitorar o processo de tempo de execuo (E3Run) do


Domnio

Abrir, editar ou manipular arquivos DOM

Controlar o acesso de usurios aos objetos do Domnio

Monitorar outros servidores do Domnio e implementar o Hot-Standby

O E3 Server pode trabalhar com apenas um arquivo de Domnio por vez, e


este chamado de Domnio aberto. Os arquivos de Domnio s so
manipulados pelo E3 Server.

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

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


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

Se as novas licenas forem exatamente iguais em limitaes s do


dispositivo anterior, so aplicadas imediatamente

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


anterior, tambm so aplicadas imediatamente

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


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

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

Domnios 135
3.2 E3Run
O E3Run o processo responsvel pela execuo dos objetos do servidor:
Tags, Alarmes, Banco de Dados, Histricos, etc., ou seja, todos os objetos
exceto as Telas e o objeto Viewer.

A execuo do E3Run indicada no cone do E3 Admin na rea de


Notificao do Windows, de acordo com a tabela a seguir.

Opes disponveis para cones da rea de Notificao

OPO DESCRIO
Seta verde: Mostrada quando o
Domnio est carregado e
executando

Quadrado cinza: O Domnio est


carregado, mas no executando

Linha reta amarela (giratria):


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

Barras amarelas: Mostradas quando


o Domnio est em modo de espera

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

136 Domnios
3.3 E3 Admin
O E3 Admin o mdulo responsvel por monitorar e comandar o E3 Server.
simbolizado pelo cone na rea de Notificao do Windows. Este
mdulo iniciado quando o usurio loga no Windows, ou quando o servio
do E3 Server iniciado.

O E3 Admin tambm responsvel por tratar as opes de controle do


Domnio via linha de comando, das seguintes maneiras: e3admin
<nome_do_dominio> [opes] ou e3admin [opes] <nome_do_dominio>.
As opes de linha de comando so listadas a seguir:

-start ou /start: Inicia um Domnio informado pelo usurio. O uso desta


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

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

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


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

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

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


deve ser utilizada sozinha

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

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


para o E3 Admin, como na figura a seguir

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

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


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

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


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

138 Domnios
Mensagem de erro do E3 Admin

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

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


pedem o login do usurio do E3.

3.4 IOServer
O IOServer o processo responsvel pela execuo dos Drivers de
Comunicao. Os IOServers so criados, mantidos e monitorados pelo
processo E3Run.

3.5 E3 Studio
O E3 Studio o ambiente de desenvolvimento e configurao de aplicativos.
Permite abrir e editar arquivos .prj ou .lib. O E3 Studio multi-usurio, isto ,
vrios E3 Studios podem modificar os mesmos arquivos ao mesmo tempo. O
E3 Studio utiliza a conexo REC para se comunicar com o E3 Server.

Domnios 139
3.6 E3 Viewer
O E3 Viewer a interface com o usurio em tempo de execuo, pois mostra
as Telas em execuo e permite a operao do sistema. O E3 Viewer pode ser
executado a partir de qualquer ponto da rede que tenha acesso ao E3 Server,
sem a necessidade de copiar o aplicativo para os outros E3 Viewers, pois as
Telas e os bitmaps so carregados conforme a necessidade, em tempo de
execuo.

3.7 Componentes
Um Domnio constitudo dos arquivos descritos nas sees seguintes.

3.7.1 Arquivo de Configurao


O arquivo .dom armazena quatro tipos de informaes:

Opes de configurao do Domnio

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


objetos, etc.

Configuraes dos servidores (computadores) que executam o Domnio

Configuraes de usurios e permisses de acesso

3.7.2 Arquivo de Projeto


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

3.7.3 Arquivo de Biblioteca


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

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

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


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

Criando um novo Domnio

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


abertos no novo Domnio criado.

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

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


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

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

Clicando em Novo na barra de ferramentas Padro

Atravs do menu Arquivo - Novo Projeto

Uma vez que o Assistente tenha sido acessado, a tela inicial aberta. Para
continuar, clique em Avanar.

Tela inicial do Assistente de Aplicaes

Domnios 143
3.8.1.1 Tipo de Aplicao

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


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

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

NOTA
As telas Driver de Comunicao, Banco de Dados e Alarmes s so
mostradas na criao de uma Aplicao padro.

Uma Biblioteca de componentes do E3 um arquivo utilizado para guardar


diversos componentes que podem ser utilizados em aplicaes.

Uma Aplicao em branco um projeto criado sem nenhum objeto.

No item Nome da aplicao, especifique o nome do arquivo .prj ou .lib que


est sendo criado (de acordo com o que foi selecionado na opo anterior).
O local onde a aplicao salva deve ser especificado no item Salvar a
aplicao na pasta. Caso seja necessrio, clique em Procurar.

144 Domnios
Tela Tipo de Aplicao

Caso a pasta informada no exista, o usurio avisado, e deve decidir se


deseja cri-la.

Aviso de pasta inexistente

Clique em Avanar para prosseguir.

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

3.8.1.2 Domnio

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


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

Tela Domnio

Clique em Avanar para prosseguir.

146 Domnios
3.8.1.3 Resoluo do Viewer

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


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

Tela Resoluo do Viewer

Clique em Avanar para prosseguir.

Domnios 147
3.8.1.4 Driver de Comunicao

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


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

Tela Driver de Comunicao

Clique em Avanar para prosseguir.

148 Domnios
3.8.1.5 Banco de Dados

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


Dados no projeto sendo criado. Caso positivo, possvel configurar o arquivo
.mdb que este Banco de Dados utiliza, na opo Nome do arquivo de banco
de dados Access. Para procurar o arquivo, clique em .

Tela Banco de Dados

Clique em Avanar para prosseguir.

Domnios 149
3.8.1.6 Alarmes

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


Alarmes e de um objeto Configurao de Alarmes no projeto sendo criado. A
opo Desejo guardar os dados dos alarmes em disco habilita o
armazenamento de informaes relativas a alarmes em disco, desde que um
objeto Banco de Dados tenha sido inserido no projeto.

Tela Alarmes

Clique em Avanar para finalizar a criao da aplicao.

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

150 Domnios
Tela final do Assistente de Aplicaes

Finalize o processo clicando em Concluir.

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

Alm disto, o Domnio tambm pode ser configurado para apresentar


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

Opes de configurao via rea de Notificaes do


Windows

NOTA
Os menus Domnio - Opes e Domnio - Exportar usurios no esto
disponveis no modo Demo, e as opes de Executar e Parar no esto
disponveis se o Domnio estiver em modo Hot-Standby ou for aberto em
um computador que no faz parte do Domnio.

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

Aba Opes

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

Opes disponveis na aba Opes

Domnios 153
OPO DESCRIO
Hot-Standby Aciona o modo Hot-Standby. Se a
opo for desabilitada, o Domnio
executado no servidor em que foi
carregado, sem suporte a Hot-
Standby. Se a opo for habilitada,
possvel selecionar um servidor
principal onde o Domnio executado
e, opcionalmente, um servidor em
espera

Servidor principal Seleciona o nome do servidor


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

Servidor de backup Se habilitada, seleciona um servidor


de backup para execuo do Domnio.
Este servidor permanece em espera,
com o aplicativo carregado no E3Run
pronto para ser executado caso o
servidor principal falhe, ou caso o
servidor de backup seja ativado
manualmente

154 Domnios
OPO DESCRIO
Endereos para PING de O algoritmo de Hot-Standby exige
integridade da rede que seja declarada uma terceira
entidade de rede (as outras duas so
os servidores principal e o backup)
para determinar se a rede est
funcionando. Se no for possvel
acessar o endereo de integridade
nem o servidor de backup, o servidor
principal assume que a sua interface
de rede est com problemas e
termina imediatamente a execuo do
Domnio. Este campo permite que
vrios endereos de rede sejam
registrados. As opes para este
campo so as seguintes:

Os separadores permitidos para


cada um dos endereos so o
espao, a vrgula, o ponto e vrgula,
a tabulao e a quebra de linha

Se pelo menos um dos endereos


fornecidos neste campo retornar
sucesso, a rede considerada sem
falhas

Os nomes de servidores no so
sensveis caixa

Nomes repetidos so descartados

Espaos em branco antes ou depois


do endereo so removidos

Domnios 155
OPO DESCRIO
Ativar backup em caso de falha Habilita a troca automtica de
local servidores quando uma falha local
reportada no servidor principal. Falhas
locais so detectadas e reportadas
pelo prprio aplicativo atravs do
mtodo Application.ReportFailure. A
troca de servidores s executada se
o servidor de backup estiver sem
falhas

Tempo para ativao do servidor Permite indicar o tempo de ativao


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

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


reserva ativao disponveis:

Mnimo: Ativa apenas os servios


bsicos

Mximo: O E3 ativa o mximo de


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

Definido pelo usurio: O usurio


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

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

Scripts: O valor padro


desabilitado. Se habilitado, faz com
que todos os scripts de eventos de
objetos e de bibliotecas sejam
compilados e ativados durante a
ativao em espera

Banco de Dados: O valor padro


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

Esta opo habilitada


automaticamente quando o valor da
propriedade EnableSynchronization
for igual a Verdadeiro

Domnios 157
NOTA
Quando o Domnio colocado em execuo, o E3 Server sempre seleciona o
servidor ativo por ordem alfabtica, independente de estar selecionado
como principal ou backup. Este critrio de desempate utilizado sempre que
mais de um servidor se candidata a executar o Domnio. Para maiores
informaes, veja o captulo Hot-Standby.

Quando o Hot-Standby estiver ligado, os seguintes procedimentos so


necessrios:

Definir um diretrio compartilhado na rede para conter a cpia principal


dos arquivos do Domnio. Este diretrio deve residir em um computador
que no faa parte do Domnio E3

Criar em cada servidor do E3 um diretrio onde mantida uma cpia


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

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


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

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


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

NOTA
A REDUNDNCIA NO EST DISPONVEL EM MODO DEMO. Quando o
modo Hot-Standby estiver ligado, necessrio que todos os servidores
tenham uma cpia dos arquivos do Domnio (.dom, .prj e .lib) e a mesma
rvore de diretrios.

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

Aba Segurana

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

Opes disponveis na aba Segurana

Domnios 159
OPO DESCRIO
O usurio no pode alterar a sua Impede que o usurio troque a
senha senha em tempo de execuo

A senha expira aps ... dias Determina o prazo de validade da


senha do usurio. Antes de terminar
o prazo de validade da senha, o
sistema avisa quantos dias restam
para expirar. Aps a senha expirar, o
usurio desabilitado

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


caracteres caracteres para a senha do usurio

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


nmeros deve conter letras e nmeros

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


nmeros nmeros na senha

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


letras letras na senha

A senha deve conter letras Determina que a senha do usurio


maisculas e minsculas deve conter letras maisculas e
minsculas

Bloquear a conta do usurio aps Determina a quantidade mxima de


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

Desbloquear o usurio Desbloqueia a conta do usurio


automaticamente aps ... minutos depois de determinados minutos

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

Validar senhas sem diferenciar Permite que as senhas sejam


maisculas e minsculas validadas sem diferenciar maisculas
de minsculas. Esta opo no
recomendada

Bloqueio de Senha

A conta de um usurio pode ser bloqueada nas seguintes condies:

Se a senha expirar (o tempo de expirao pode ser atributo global, de


grupo ou de usurio)

Se o usurio digitar a senha errada um determinado nmero de vezes


seguidas, isto , falhas de login

Uma vez bloqueada, a conta no permite login. Esta condio persiste at que
um administrador desbloqueie a senha manualmente, ou ento o time-out de
bloqueio expire.

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

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


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

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


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

Aba Grupos de Viewers

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

162 Domnios
Opes disponveis na aba Grupos de Viewers

OPO DESCRIO
Nome Lista os nomes de todos os grupos
de Viewers

Adicionar / Remover Adiciona ou remove grupos de


Viewers

Nome do grupo Habilita a criao ou alterao de


nomes de grupos de Viewers

Lista de IPs Especifica quais endereos de IP


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

Adicionar / Editar / Remover Adiciona, edita ou remove os


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

Permitir conexes de Viewer Full Quando selecionada, permite


conexes do tipo Viewer Full para o
grupo

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

Permitir conexes de Viewer Only Quando selecionada, permite


conexes do tipo Viewer Only para
o grupo

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


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

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

A configurao de Grupos de Viewers deve ser realizada preferencialmente


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

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

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

Eventos Padro do Sistema so os eventos gerados automaticamente pelo


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

Login ou logout de usurio

Troca de senha de usurio

Falha de login de usurio

Alterao na base de dados de usurio

Bloqueio de conta de usurio

Incio ou trmino do Domnio

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


bibliotecas, alterar a configurao do Domnio)

Atualizao do Domnio (quando o usurio aplica as alteraes realizadas


em projetos, atravs do E3 Studio)

Troca manual de servidor Hot-Standby

Criao de usurio

Mudana de usurio

Remoo de usurio

Renomeao de usurio

Mudana em diretivas de usurio

Criao de grupo

Mudana de grupo

Remoo de grupo

166 Domnios
Renomeao de grupo

Mudana em diretivas de grupo

Eventos Manuais so eventos definidos pelo aplicativo. Estes eventos so


gerados em scripts de usurio, atravs da chamada do mtodo
Application.TrackEvent. Estes eventos podem ser gerados tanto no Viewer
quanto no Servidor (E3Run).

O Viewer apenas um gerador de eventos manuais. Basta utilizar o mtodo


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

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


tratam os eventos do sistema.

Diagrama de processos

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

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

Eventos gerados internamente no E3 Server

Domnios 167
Eventos gerados no E3 Server Standby

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


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

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


so passados automaticamente para o novo servidor Hot.

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


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

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


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

168 Domnios
Aba Registro de Eventos

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

Opes disponveis na aba Registro de Eventos

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

Domnios 169
OPO DESCRIO
Nome da tabela Indique o nome da tabela onde so
gravados os eventos. A tabela
informada criada automaticamente
pelo E3Run, e tem os seguintes
campos:

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

EventTime (Data/Hora): O campo


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

EventMessage (String): Mensagem


do evento (mximo de 200
caracteres)

EventComment (String):
Comentrio sobre o evento
(mximo de 200 caracteres)

Selecionar automaticamente um Habilite esta opo para deixar que o


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

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

Marque abaixo os eventos que Lista os eventos disponveis no


devem ser registrados sistema para serem registrados

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

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


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

Edio de eventos

Desmarque a opo Usar mensagem padro para alterar a mensagem do


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

172 Domnios
Visualizao da macro disponvel para o evento

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


ser usadas:

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

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

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


renomeado por este evento

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


se no houver nenhum usurio logado)

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

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


(Viewer, Studio ou E3 Server)

%CAUSE%: Informao adicional sobre o evento

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


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

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

Os eventos padro do sistema so descritos nas sees seguintes.

3.9.4.1 Login de Usurios


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

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


Studio ou no Viewer, onde:

%USER% contm o nome de login do usurio

%SESSION% contm "Viewer" ou "Studio"

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


logado

3.9.4.2 Logout de Usurios


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

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


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

%USER% contm o nome de login do usurio

%SESSION% contm "Viewer" ou "Studio"

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


logado

174 Domnios
3.9.4.3 Troca de Senha
A senha do usurio %USER% foi alterada

Gerado sempre que a senha de um usurio for trocada (utilizando o mtodo


ChangePassword no Viewer), onde:

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

3.9.4.4 Falha de Login


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

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


onde:

%USER% contm o nome de login informado

%SESSION% contm "Viewer" ou "Studio"

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


logar

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


bloqueada, senha expirada ou erro 0xnnnnnnn

3.9.4.5 Base de Usurios Alterada


Usurio %USER% alterou a base de usurios

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


opo Arquivos - Usurio do E3 Studio), onde:

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


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

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

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


errados, onde:

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

3.9.4.7 Domnio Iniciado


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

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

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


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

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


Notificaes do Windows)

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


comando para executar o Domnio

3.9.4.8 Domnio Finalizado


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

Gerado sempre que o Domnio parado, onde:

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


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

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


Notificaes do Windows)

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


comando de parar o Domnio

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

Gerado sempre que o Domnio atualizado ao clicar em Executar aplicativo


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

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


"Annimo", se no h nenhum usurio logado)

%SESSION% contm "Studio"

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


executando

3.9.4.10 Domnio Modificado


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

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

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

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

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


comando de modificar o Domnio

%CAUSE% pode ser:

Aplicadas alteraes na janela do computador de edio do Domnio

Adicionado projeto "nomedoprojeto" (habilitado)

Adicionado projeto "nomedoprojeto" (desabilitado)

Removido projeto "nomedoprojeto"

Desabilitado projeto "nomedoprojeto"

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

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


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

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


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

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


Windows)

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


comando para ativar o servidor de backup

3.9.4.12 Usurio Criado


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

Gerado sempre que um usurio criado, onde:

%NAME%: Nome do usurio criado

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

3.9.4.13 Usurio Modificado


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

Gerado sempre que um usurio modificado, onde:

%NAME%: Nome do usurio que foi modificado

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

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


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

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

Gerado sempre que um usurio removido, onde:

%NAME%: Nome do usurio que foi removido

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

3.9.4.15 Usurio Renomeado


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

Gerado sempre que um usurio renomeado, onde:

%NAME%: Nome do usurio que foi renomeado

%NEWNAME%: Novo nome do usurio que foi renomeado

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

3.9.4.16 Diretivas de Usurio


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

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

%NAME%: Nome do usurio cujos direitos foram modificados

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


usurio

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

Gerado sempre que um grupo criado, onde:

%NAME%: Nome do grupo criado

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

3.9.4.18 Grupo Modificado


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

Gerado sempre que um grupo modificado, onde:

%NAME%: Nome do grupo que foi modificado

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

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


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

3.9.4.19 Grupo Removido


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

Gerado sempre que um grupo removido, onde:

%NAME%: Nome do grupo que foi removido

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

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

Gerado sempre que um grupo renomeado, onde:

%NAME%: Nome do grupo que foi renomeado

%NEWNAME%: Novo nome do grupo que foi renomeado

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

3.9.4.21 Diretivas de Grupo


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

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

%NAME%: Nome do grupo cujos direitos foram modificados

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


grupo

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

Aba Projetos

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

Opes disponveis na aba Projetos

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

182 Domnios
OPO DESCRIO
Adicionar / Remover Atravs destas opes, pode-se
remover ou adicionar projetos no
sistema. Para adicionar um projeto,
clique em Adicionar e especifique o
campo Nome do projeto. Para
remover um projeto, selecione-o e
clique em Remover. O arquivo PRJ
no apagado do disco, apenas
removido da lista de projetos do
Domnio

Nome do projeto Digite o nome do arquivo do projeto,


que deve ser um caminho relativo ao
diretrio do Domnio (o diretrio que
contm o arquivo .dom). Exemplos:
Telas.prj, Hidro\Estacao1.prj

Em manuteno (execuo Esta opo permite desabilitar a


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

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

Aba Servidores

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

Opes disponveis na aba Servidores

184 Domnios
OPO DESCRIO
Nome Lista com os nomes dos servidores
no sistema

Adicionar e Remover Atravs destas opes, pode-se


remover ou adicionar servidores no
sistema. Para adicionar um servidor
em rede, clique em Adicionar e
especifique os campos Nome do
servidor e Identificao do servidor
na rede. Para adicionar um servidor
local, especifique o item Caminho
local de acesso aos arquivos de
Domnio. Para remover um projeto,
selecione-o na lista e clique em
Remover

Nome do servidor Determina o nome do servidor. Este


nome definido pelo usurio

Identificao do servidor na rede Digite o nome do servidor na rede.


Deve ser o nome da mquina com ou
sem as barras duplas invertidas no
incio (por exemplo, \\server ou
server)

Pasta raiz dos arquivos do Indica a pasta onde esto localizados


Domnio os arquivos do Domnio (arquivos
.prj, .lib, etc.) do servidor selecionado.
A opo No especificar (utilizar a
pasta do arquivo .DOM) o padro,
e indica que os arquivos esto na
mesma pasta do arquivo de Domnio
(.dom). Caso seja selecionada a
opo Utilizar a seguinte pasta
local, o caminho digitado no campo
especfico deve conter apenas a
pasta, sem o nome nem a extenso
do arquivo de Domnio (.dom)

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

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

Aba Domnios Remotos

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

Opes disponveis na aba Domnios Remotos

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

Domnios 187
OPO DESCRIO
Adicionar / Remover Atravs destas opes, pode-se
remover ou adicionar Domnios
Remotos no sistema. Para adicionar
um Domnio Remoto em rede, clique
em Adicionar e especifique os
campos Nome e Arquivo de
Domnio. Para remover um Domnio,
selecione-o na lista e clique em
Remover

Nome do Domnio Determina o nome do Domnio


Remoto. Este nome definido pelo
usurio

Arquivo de Domnio Determina o nome ou o caminho na


rede onde est o arquivo .dom do
Domnio Remoto

Servidor Principal Identifica o servidor principal na rede

Servidor de Backup Quando habilitado, identifica o


servidor de backup na rede

Usurio no Domnio Permite reconhecer um usurio com


senha para cada Domnio Remoto.
As opes disponveis so: No
especificar (annimo), e Utilizar a
seguinte conta. Ao selecionar a
segunda opo, os campos Usurio
e Senha so habilitados

Usurio Identifica o usurio

Senha Permite a conexo ao Domnio


atravs de senha

188 Domnios
possvel que uma configurao de Domnio Remoto possibilite a conexo ao
prprio Domnio local. A isto se d o nome de Alias local ou conexo
Loopback.

Este alias criado segundo a configurao normal de Domnios Remotos.


Basta que o nome dos servidores (principal ou backup) seja localhost* ou o
mesmo da mquina onde o Domnio est executando para que tudo funcione
localmente. Neste caso, para que a configurao funcione no E3 Studio, no
campo Arquivo de Domnio, basta digitar diretamente o caminho local do
arquivo DOM (por exemplo, c:\caminho\arquivo.dom).

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

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

Aba Propriedades

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

Opes disponveis na aba Propriedades

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

Drivers por Processo Define o nmero mximo de Drivers


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

Nmero Mximo de Processos Define o nmero mximo de


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

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


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

Ao clicar em Executar Aplicativo no E3 Studio

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


rea de Notificaes do Windows

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

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

3.10 Outras Opes da rea de Notificao


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

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

Janela Exportao de Usurios

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

Domnios 193
3.10.2 Atalhos
Esta opo permite executar aplicativos presentes na instalao do E3
diretamente pelo menu contextual do cone do E3 Admin, na rea de
Notificao do Windows. Os seguintes aplicativos podem ser executados:

Log Viewer

E3 Studio

E3 Tweak

E3 Viewer

O item Log Viewer abre o aplicativo Elipse Event Log Viewer j com o
arquivo correspondente sesso ativa de logs do E3. Para maiores
informaes sobre este aplicativo, consulte o Manual do Usurio do Elipse
Event Log, disponvel no menu Iniciar - Programas - Elipse Software - Elipse
Event Log.

Se j h um Domnio executando localmente, o item E3 Viewer deste menu


abre um Viewer para o Domnio local. Do contrrio, ou se a tecla SHIFT estiver
pressionada, abre-se a janela inicial do Viewer, onde possvel selecionar o
servidor e outras opes, como descrito no tpico E3 Viewer e E3
WebViewer - Execuo do E3 Viewer - Execuo Atrves do Menu Iniciar.

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

Janela E3 Admin - Licenas

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

Opes disponveis na janela E3 Admin - Licenas

Domnios 195
OPO DESCRIO
Nmero da licena Informa o nmero da licena
(dispositivo de proteo): um
nmero hexadecimal de oito dgitos
com prefixo "HL", se o dispositivo for
uma hardkey; ou um nmero
hexadecimal de dezesseis dgitos
com prefixo "SL", se o dispositivo for
uma softkey. Se o dispositivo de
proteo no foi detectado, o
nmero preenchido com zeros

E3 Server Indica o tipo de E3 Server

E3 Studio Indica o nmero de licenas


disponveis e em uso do E3 Studio

E3 Viewer Indica o nmero de licenas


disponveis e em uso do E3 Viewer

E3 Viewer Only Indica o nmero de licenas


disponveis e em uso do E3 Viewer
no modo Somente Leitura

Domnio Remoto (Servidor) Indica o nmero de licenas


disponveis e em uso do Domnio
Remoto (Servidor)

Domnio Remoto (Cliente) Indica o nmero de licenas


disponveis e em uso do Domnio
Remoto (Cliente)

Pontos E/S Indica o nmero de pontos de


comunicao

Tags do Storage Indica o nmero de Tags do Storage

Drivers Indica o nmero de Drivers


disponveis e em uso

196 Domnios
OPO DESCRIO
Servidor OPC Indica o nmero de licenas
disponveis e em uso do Servidor
OPC

Tempo mximo de execuo Indica o tempo mximo permitido de


execuo de um aplicativo

Para maiores informaes sobre as limitaes do modo Demo do E3, veja o


tpico Limitaes do Modo Demonstrao.

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

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

Janela E3 Admin - Estatsticas de Comunicao

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

Opes disponveis na janela E3 Admin - Estatsticas de Comunicao

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

Computador Mostra o nome da mquina


conectada ao E3 Server

Dados enviados Mostra a quantidade de dados


enviados

Compresso no envio Mostra a percentagem de


compresso no envio

Pacotes enviados Mostra a quantidade de pacotes


enviados

198 Domnios
OPO DESCRIO
Dados recebidos Mostra a quantidade de dados
recebidos

Compresso no recebimento Mostra a percentagem de


compresso no recebimento

Pacotes recebidos Mostra a quantidade de pacotes


recebidos

Conectado desde Mostra a data e hora em que o


programa iniciou a conexo

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

Janela E3 Admin - Monitor

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

Opes disponveis na janela E3 Admin - Monitor

OPO DESCRIO
Domnio atual Nome do Domnio ativo

Endereos de ping Lista com os endereos dos


servidores de ping

Nome Nome do servidor

Endereo Endereo de rede do servidor

Ping Mostra o estado do ping de rede


com este servidor

200 Domnios
OPO DESCRIO
Relgio Mostra a hora local do servidor

Estado Mostra o estado do Domnio no


servidor (Parado ou Rodando)

Conexo Mostra o estado da conexo DCOM


com o servidor

Funo Mostra uma lista de funes


reportadas pelo servidor:

Ativo: Este o servidor ativo do


Domnio

Reserva: Este o servidor standby


do Domnio

Falha(n): Servidor possui falhas


locais reportadas

Prioridade: O servidor requisitou


prioridade para executar o Domnio.
Este indicador faz com que o
servidor ativo passe para o modo
Standby

Candidato: O servidor candidato


a executar o Domnio

E/S: O servidor possui IOServers


ativos

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

Janela E3 Admin - Inicializao

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

Opes disponveis na janela E3 Admin - Inicializao

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

O Domnio configurado Ao iniciar, executa automaticamente


o Domnio configurado pelo usurio

Nenhum Domnio No inicia nenhum Domnio

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

Janela E3 Admin - Impressora

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

Opes disponveis na janela E3 Admin - Impressora

OPO DESCRIO
Nome da impressora Lista o nome das impressoras
disponveis

Padro Permite selecionar esta impressora


como padro

Configurar Abre a janela de propriedades da


impressora selecionada

Procurar Permite selecionar outra impressora


na rede e estabelecer uma conexo

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

3.10.9 Iniciar ou Parar o E3 Server


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

3.10.10 Fechar o E3 Admin


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

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


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

3.11 Domnios Remotos


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

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

Aba Domnios Remotos

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


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

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

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


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

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


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

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


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

Janela Opes de Conexo

As opes desta janela esto descritas na tabela a seguir.

206 Domnios
Opes disponveis na janela Opes de Conexo

OPO DESCRIO
Tempo limite de conexo (ms) Esta opo controla o tempo
mximo que o Domnio Remoto
Cliente espera para estabelecer uma
conexo REC com o E3 Server do
Domnio Servidor. Sua finalidade a
mesma da chave
ConnectionTimeout, configurvel
pelo E3 Tweak. O valor padro desta
opo 2000 ms

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


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

Domnios 207
OPO DESCRIO
Verificar PING Esta opo permite que, atravs de
um pedido de echo do protocolo
ICMP, o Domnio Remoto verifique se
o Servidor responde dentro de um
tempo limite (time-out). Se no
houver resposta, por qualquer
motivo, considera-se que o
computador est fora da rede, ou
desligado. Esta verificao, se
habilitada, ocorre antes da conexo
(evitando a tentativa de conectar em
um computador indisponvel) e
enquanto a conexo estiver ativa
(forando a desconexo imediata)

Tempo limite de PING (ms) O valor, em milissegundos, para a


verificao do ping. O valor padro
desta opo 2000 ms

Utilizar heartbeat na conexo Esta opo permite que, atravs de


um mecanismo do protocolo REC, o
Domnio Remoto Cliente verifique se
o Servidor est mantendo a conexo
ativa, esperando que sejam enviadas
mensagens de heartbeat peridicas,
mesmo que no haja nenhuma outra
comunicao a ser feita. Se for
excedido o dobro do tempo de
heartbeat configurado, sem que o
Cliente receba uma mensagem
qualquer do computador Servidor,
considera-se que o Servidor falhou
ou est fora da rede, sendo forada
uma desconexo imediata

Perodo de heartbeat (ms) O valor, em milissegundos, do


perodo de heartbeat. O valor padro
desta opo 2000 ms

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

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

Alm disto, para que a conexo entre os Domnios possa ocorrer, todos os E3
Servers envolvidos devem executar a mesma verso do E3. No possvel,
por exemplo, conectar-se a um Domnio que esteja rodando a verso 2.5 do
E3.

Para que um E3 Server aceite receber conexes de outros Domnios, isto ,


para que ele seja um servidor de Domnios Remotos, no necessria
nenhuma configurao especfica.

Aps a correta configurao destes itens, necessrio apenas executar os E3


Servers para que as conexes remotas sejam estabelecidas.

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

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

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


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

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

O acesso aos objetos de outro Domnio realizado atravs do apelido


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

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


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

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

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

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

Permisses de usurio

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

Alm do acesso em modo Somente Leitura, possvel bloquear


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

NOTA
A permisso Acesso remoto ao Domnio sempre tem precedncia sobre a
permisso Acesso remoto de escrita ao Domnio. Isto significa que, quando
a primeira permisso for negada, a segunda no efetivada mesmo quando
explicitamente permitida. No havendo nenhuma permisso de acesso
configurada, qualquer Domnio pode se conectar remotamente a outro,
utilizando um usurio annimo.

3.11.5 Hot-Standby
A conexo remota ao Domnio suporta Domnios com Hot-Standby
nativamente. Para isto, basta apenas especificar os nomes dos dois servidores
(principal e backup) nos itens respectivos da rea Identificao dos
servidores na rede, na aba Domnios Remotos. importante ressaltar que,
para o correto funcionamento do Hot-Standby, estes nomes devem ser os
mesmos especificados pelo Domnio Remoto acessado. Uma vez que haja
esta configurao em tempo de execuo, o E3 Server sempre tenta conectar-
se aos dois servidores, direcionando o acesso de todos os comandos
Application.GetObject e Links para o primeiro servidor que possa ser
acessado e que indique estar executando o Domnio. Caso os nomes dos
servidores sejam modificados quando o Domnio Cliente estiver em execuo,
este se desconecta e reinicia a conexo com os novos servidores.

Domnios 213
3.11.6 Gerenciamento da Conexo
Mesmo quando no h configurao de Hot-Standby, existe um controle da
conexo de Domnios Remotos entre os E3 Servers Clientes e Servidores. A
conexo utiliza o protocolo REC, o mesmo utilizado entre o E3 Server, E3
Viewer e E3 Studio. Assim, a porta de conexo do REC e as possveis
configuraes de firewall associadas tambm se aplicam aos Domnios
Remotos.

Com a conexo estabelecida, espera-se que haja um Domnio executando.


Neste processo, a conexo refeita sempre que houver algum problema.
Aps ser encontrado o Domnio executando, verifica-se o nome correto do
Domnio, bem como o login do usurio (se necessrio).

Assim como acontece com as conexes REC do E3 Studio e do E3 Viewer, as


estatsticas de comunicao das conexes de Domnios Remotos podem ser
visualizadas na janela de Estatsticas do E3 Server, acessveis atravs do cone
do E3 Admin na rea de Notificaes do Windows.

214 Domnios
3.11.7 Desconexo
O Domnio Cliente pode no conseguir estabelecer a conexo com o Domnio
Servidor por uma srie de motivos. Entre eles esto:

O computador do Cliente ou do Servidor est fora da rede

O Servidor no est executando o E3 Server

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


no foi iniciado

O Domnio Servidor no aceita o usurio especificado pelo Domnio


Cliente

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


Remoto

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

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


Servidor esto usando portas diferentes

O apelido do Domnio no existe na configurao de Domnio Remoto

Quando uma destas situaes ocorrer, todos os Links do Cliente


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

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

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


Log Viewer

Pelo menu Ferramentas - Log Viewer do E3 Studio

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


Notificao do Windows

216 Domnios
CAPTULO
Drivers
4
O E3 permite a comunicao com equipamentos de aquisio de dados,
controladores, CLPs (Controladores Lgicos Programveis), UTRs (Unidades
Terminais Remotas), ou qualquer outro tipo de equipamento, atravs de
Drivers de Comunicao prprios ou Servidores OPC, de acordo com o tipo
do equipamento ou tipo de comunicao necessria.

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

Drivers 217
4.1 Driver de Comunicao
O Driver de Comunicao o mdulo do E3 que possibilita a comunicao
com um determinado equipamento usando arquivos .dll. Estes Drivers so
desenvolvidos pela Elipse Software, bem como por terceiros, a partir de um
DDK (Driver Development Kit) fornecido pela Elipse, em linguagem C/C++.
Cada Driver implementa uma famlia de equipamentos ou protocolos
diferentes, de acordo com o tipo de equipamento ou protocolo de
comunicao. Novos Drivers so costumeiramente desenvolvidos pela Elipse
Software.

Para inserir um Driver de Comunicao no projeto, clique com o boto direito


do mouse no nome do projeto no Explorer e selecione a opo Inserir -
Driver de Comunicao. No modo Domnio, clique com o boto direito do
mouse no item Objetos de Servidor - Drivers e OPC, selecione a opo
Inserir Driver de Comunicao em e logo aps o nome do projeto desejado.

Inserindo um Driver de Comunicao no modo Domnio

A janela a seguir aberta para localizao do Driver.

218 Drivers
Janela Localizar Driver

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


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

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


objeto, conforme a figura a seguir.

Editor do Driver de Comunicao

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

Opes disponveis no Editor do Driver de Comunicao

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

Remover Remove o item


selecionado no Editor

Configurar o driver Abre a janela de


configuraes extras do
Driver

Tag Browser Abre uma janela que


permite importar Tags
diretamente do Driver

Ativar/desativar Ativa ou desativa a


comunicao comunicao do Driver

Contagem de tags Apresenta o nmero


total de Tags de
Comunicao no Driver

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

Selecionando um Driver

Para maiores informaes sobre a configurao individual de cada Driver,


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

Drivers 221
4.1.1.1 Teste de Comunicao

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


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

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


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

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


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

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

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


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

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


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

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


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

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


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

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


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

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


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

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

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

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


do Driver de Comunicao, denominada Gerenciador de Drivers.

Acesso ao Gerenciador de Drivers

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


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

224 Drivers
Gerenciador de Drivers

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

Opes disponveis na janela Gerenciador de Drivers

OPO DESCRIO
Nome Informa o nome do Driver

Objeto(s) Informa o nome do objeto Driver de


Comunicao associado ao Driver

Erros de leitura Mostra o total de leituras do Driver,


a quantidade de erros de leitura e
percentual de erros em relao ao
total de leituras

Erros de escrita Mostra o total de escritas do Driver,


a quantidade de erros de escrita e
percentual de erros em relao ao
total de escritas

Processo Mostra o identificador do processo


do IOServer no sistema operacional

Drivers 225
OPO DESCRIO
Estado Mostra o estado atual do Driver
(configurado, iniciando, executando,
finalizando, finalizado ou em erro).
Se o Driver estiver em erro, mostra
uma descrio do erro

Compartilhado Mostra as palavras SIM ou NO,


informando se o Driver
compartilhado ou no

Log Mostra o status do log (habilitado ou


desabilitado)

Caminho Informa o caminho do Driver no


sistema operacional

Habilitar Log Habilita o log dos Drivers em tempo


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

Atualizar Fora a atualizao dos dados


exibidos

226 Drivers
4.1.2.1 Utilizao de Estampa de Tempo

Alguns equipamentos e protocolos permitem o envio de informaes de


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

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


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

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


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

Para obter mais informaes sobre quais equipamentos possuem esta


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

Drivers 227
4.1.2.2 Tags Reportados por Eventos

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


leitura, ou ento no retornar valor algum.

Os Tags reportados por eventos so destinados leitura de dados sob


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

A documentao do Driver deve especificar quais dos seus Tags disponveis


para a aplicao so reportados a eventos.

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


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

Tabela com trs eventos e apenas um campo de


dados

Tabela com trs eventos e seis campos de dados

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

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


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

Os Tags reportados por eventos tambm permitem configurar um tempo de


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

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

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


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

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


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

A propriedade TimeStamp destes Tags em geral contm um valor fornecido


pelo prprio equipamento.

Drivers 229
NOTA
Os Tags reportados por eventos devem ser configurados com a
propriedade EnableDeadband desabilitada. Isto evita que eventos com
valores muito prximos sejam desprezados pela aplicao.

4.1.2.2.1 Gravao de Eventos em um Histrico

O uso mais comum da leitura de Tags reportados por eventos a gravao


dos eventos retornados em um objeto Histrico. Para isto, siga estes
procedimentos:

1. Crie um objeto Histrico, com varredura desabilitada (propriedade


ScanTime igual a zero) e sem banda morta (propriedade DeadBand igual
a zero).

2. Associe as propriedades TimeStamp e os valores do Tag ao Histrico.


Pode-se tambm associar outras propriedades, caso seja importante
armazen-las.

3. Utilize o mtodo WriteRecord do objeto Histrico no evento OnRead do


Tag.

Desta forma, garante-se que cada valor reportado a evento que chegar seja
gravado sequencialmente no Histrico associado.

230 Drivers
4.1.2.3 Pool de Processos IOServer

Em aplicativos com centenas de Drivers, os recursos necessrios para


executar os processos IOServer para cada Driver podem esgotar a
capacidade do sistema operacional. Nestes casos, pode ser necessrio
habilitar o Pool de Processos IOServer na aba Propriedades da configurao
do Domnio.

Quando este Pool est habilitado, cada processo IOServer pode executar mais
de um Driver, economizando desta forma recursos do sistema operacional e
permitindo que um aplicativo chegue a executar milhares de Drivers.

Apenas Drivers que suportam a criao de novas instncias dinmicas (Drivers


compilados com o IOKit v2.0.6 ou superior) podem ser utilizados no Pool. Se
um Driver que no tem este suporte for adicionado ao Pool, ele no
executado (falha). Para estes casos, basta configurar a propriedade
DisableIOServerPool do IODriver para Falso para que o Driver execute fora
do Pool, em um processo IOServer exclusivo.

Na aba Propriedades da configurao do Domnio, pode-se controlar o


nmero mximo de processos IOServer no Pool, bem como o nmero mximo
de Drivers que executam em cada IOServer.

Opes de comportamento do Pool de Processos IOServer

DRIVERS POR NMERO MXIMO DE COMPORTAMENTO DO


PROCESSO PROCESSOS POOL
0 M medida que os Drivers
do aplicativo forem
ativados, criado um
processo IOServer para
cada Driver, at atingir o
nmero mximo M.
Depois deste ponto,
cada novo Driver que for
ativado adicionado ao
IOServer do Pool que
contm a menor
quantidade de Drivers

Drivers 231
DRIVERS POR NMERO MXIMO DE COMPORTAMENTO DO
PROCESSO PROCESSOS POOL
N 0 medida que os Drivers
do aplicativo forem
ativados, o E3 os
adiciona a um processo
IOServer do Pool que
ainda no tenha atingido
o nmero mximo N de
Drivers executando
dentro dele. Se todos os
processos do Pool
estiverem no limite
mximo, ento um novo
IOServer adicionado
ao Pool

232 Drivers
DRIVERS POR NMERO MXIMO DE COMPORTAMENTO DO
PROCESSO PROCESSOS POOL
N M medida que os Drivers
do aplicativo forem
ativados, o E3 os
adiciona a um processo
IOServer do Pool que
ainda no tenha atingido
o nmero mximo N de
Drivers executando
dentro dele. Se todos os
processos do Pool
estiverem no limite
mximo, o
comportamento
depende da quantidade
de processos no Pool, e
se o nmero de
processos do Pool for
menor que o mximo M,
ento um novo processo
adicionado ao Pool,
caso contrrio o Driver
adicionado no processo
que tiver menos Drivers
executando. NOTA:
Neste modo, o nmero
mximo de Drivers por
processo (N) pode ser
ultrapassado caso o
nmero total de Drivers
do aplicativo exceda N *
M

Drivers 233
NOTAS
Ao agrupar Drivers em um mesmo processo IOServer, perde-se o
isolamento entre estes Drivers. Desta forma, se ocorrer uma falha em um
destes Drivers, o IOServer fechado e todos os Drivers que executavam
naquele IOServer tm que ser reiniciados.
Existe um limite no nmero de Drivers que podem executar em um
processo IOServer. Este limite depende de diversas variveis, tais como o
sistema operacional em uso, a quantidade de memria, threads e recursos
que cada Driver especfico est ocupando. Em linhas gerais, no se deve
adicionar mais do que 100 Drivers em um nico IOServer, sob pena de
exceder os limites do sistema operacional.

234 Drivers
4.1.3 Pasta de Comunicao
A Pasta de Comunicao define grupos e subdiretrios de forma a organizar
as variveis. Cada Pasta pode ser renomeada conforme a necessidade e
novas Pastas podem ser inseridas dentro de outras. Para utilizar este recurso,
siga este procedimento:

1. No Organizer, clique com o boto direito do mouse no objeto Driver e


selecione a opo Inserir - Nova Pasta.

Inserindo uma nova Pasta

Drivers 235
4.1.4 Tag de Comunicao
O Tag de Comunicao possibilita a leitura ou a escrita de um conjunto de
valores utilizando o Driver de Comunicao. utilizado para definir a troca de
informaes com os equipamentos de aquisio, que consistem em uma nica
varivel independente.

O Tag de Comunicao pode ser uma varivel analgica, de entrada, de


sada, contador, ponto digital, etc. Vrios pontos digitais podem ser
agrupados no Tag e serem acessados atravs de suas propriedades, como
bits de dados. Os Tags de Comunicao so configurados atravs de uma
srie de parmetros N (N1 a N4), que variam de acordo com o Driver de
Comunicao a ser utilizado. Para utilizar este recurso, siga estes
procedimentos:

1. Insira o Tag de Comunicao no projeto, clicando com o boto direito do


mouse no Driver e selecionando a opo Inserir - Tag de Comunicao.

236 Drivers
Inserindo um Tag de Comunicao

2. A janela da figura a seguir mostrada, perguntando quantos Tags devem


ser criados no Driver, e qual seu nome. Este nome auto-incrementado e,
se a opo for deixada em branco, os Tags so criados com o nome
padro.

Drivers 237
Inserindo Tags de Comunicao

Caso o equipamento sendo utilizado para coletar os dados informe valores


de Tags que precisam ser convertidos, pode-se utilizar as escalas dos Tags,
que so basicamente uma especificao de uma converso linear entre duas
bases diferentes.

Para isto, deve-se habilitar a propriedade EnableScaling do Tag e informar


os parmetros DeviceLow e DeviceHigh (atravs das respectivas propriedades),
que seriam os limites inferior e superior do dado vindo do equipamento, alm
de informar os parmetros EULow e EUHigh (atravs das respectivas
propriedades) que so os limites inferior e superior do dado, j em unidades
de engenharia.

Algumas das propriedades deste objeto podem ser configuradas diretamente


na Lista de Propriedades, sem a necessidade de criar scripts para isto. Demais
informaes sobre as funcionalidades das propriedades deste objeto podem
ser encontradas no Manual de Referncia e Scripts do E3, em seu captulo
respectivo.

238 Drivers
4.1.5 Bloco de Comunicao
O Bloco de Comunicao utilizado para definir a troca de informaes com
os equipamentos de aquisio, que consistem de uma ou mais variveis,
desde que seja consecutivo no endereamento dentro do dispositivo externo.

Dependendo do mtodo de comunicao utilizado, podem economizar tempo


de comunicao, obtendo um nmero maior de atualizaes em um mesmo
intervalo de tempo se comparado com o Tag de Comunicao. Os Blocos de
Comunicao so configurados atravs de uma srie de parmetros B (B1 a
B4) que variam de acordo com o Driver de Comunicao a ser utilizado, alm
da propriedade Size, que define o nmero de Elementos ou ndices
disponveis no Bloco. Para utilizar este recurso, siga estes procedimentos:

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


Inserir - Bloco de Comunicao.

Drivers 239
Inserindo um Bloco de Comunicao

2. A janela da figura a seguir mostrada, perguntando quantos Blocos


devem ser criados no Driver, e qual seu nome. Este nome auto-
incrementado e, se a opo for deixada em branco, os Blocos so criados
com o nome padro.

240 Drivers
Inserindo Blocos de
Comunicao

3. A caixa de dilogo da figura a seguir mostrada, para determinar o


nmero de Elementos de Bloco neste objeto. Nesta opo possvel
indicar o mapeamento de todos os Elementos de Bloco ou somente em
um determinado intervalo de Elementos.

Configurando o Bloco de Comunicao

4. Informe o tamanho do Bloco e a opo de mapeamento.

5. Clique em OK.

6. Caso necessite, configure as propriedades do objeto.

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

242 Drivers
4.1.6 Elemento de Bloco de Comunicao
Os Elementos de Bloco de Comunicao representam as associaes de
cada uma das posies no Bloco, de forma a serem utilizados como se
fossem Tags de Comunicao. Os Elementos de Bloco podem apontar
livremente para cada ndice dentro de um Bloco. Podem existir dois Elementos
de Bloco apontando para o mesmo ndice do Bloco, e tambm um nmero
menor, igual ou maior de Elementos do que o nmero de variveis declaradas
no Bloco. Para utilizar este recurso, siga este procedimento:

1. Clique com o boto direito do mouse no Bloco de Comunicao e


selecione a opo Inserir - Elemento de Comunicao.

Inserindo um Elemento de Bloco de Comunicao

Drivers 243
Caso o equipamento sendo utilizado para coletar os dados informe valores
de Elementos que precisam ser convertidos, pode-se utilizar as escalas dos
Elementos, que so basicamente uma especificao de uma converso linear
entre duas bases diferentes.

Para isto, deve-se habilitar a propriedade EnableScaling do Elemento e


informar os parmetros DeviceLow e DeviceHigh (atravs das respectivas
propriedades), que so os limites inferior e superior do dado vindo do
equipamento, alm dos parmetros EULow e EUHigh (atravs das respectivas
propriedades) que so os limites inferior e superior do dado j em unidades
de engenharia.

Algumas das propriedades do Elemento de Bloco podem ser configuradas


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

4.2 Servidor OPC


Alm de possuir um cliente OPC (Driver OPC), o E3 funciona tambm como
Servidor OPC DA (Data Access) 2.0x. Isto permite ao E3 expor todos os objetos
existentes no Domnio em execuo (Tags de Comunicao, por exemplo)
para softwares externos ao E3. Como exemplos, pode-se citar o Elipse
SCADA, o E3 (que pode estar executando em outra aplicao como cliente),
ou um cliente OPC de outro fabricante, basta que o cliente implemente o
padro OPC DA 2.0x ou superior.

NOTA
O Servidor OPC no E3 um mdulo adicional a partir da verso 3.0, e
necessita de licena especfica no dispositivo de proteo. Entre em contato
com a Elipse Software para maiores informaes.

244 Drivers
4.2.1 Caractersticas
Para usar o Servidor OPC do E3 no necessria nenhuma configurao
extra, bastando executar o Domnio para que qualquer cliente OPC possa se
comunicar com o E3. Para conectar-se ao servidor OPC do E3 de um cliente
qualquer, basta selecionar o servidor identificado como Elipse.OPCSvr.1.

O Servidor OPC permite que qualquer cliente importe facilmente toda a


definio de Tags existentes no Domnio (funo Browse). Naturalmente, os
Tags fornecidos so apenas os objetos que fazem parte do servidor, ou seja,
itens de Tela (Viewer) no so acessveis pelo Servidor OPC.

Sendo baseado na mesma tecnologia de associaes usada nas associaes


internas entre objetos, o Servidor OPC do E3 permite que clientes usem Tags
que sejam expresses matemticas, e com o recurso de conexo e
desconexo transparente durante a execuo.

4.2.2 Informaes de Status


Atravs da informao de status (funcionalidade padro do OPC), o cliente
OPC pode identificar se o servidor do E3 encontra-se sem Domnio, em
modo Standby ou executando normalmente. Os valores possveis para o
status do OPC so os seguintes:

OPC_STATUS_RUNNING: Domnio executando normalmente

OPC_STATUS_SUSPENDED: Domnio em modo Standby

OPC_STATUS_NOCONFIG: Domnio parado ou sem Domnio

4.2.3 Desconexo
Para os clientes OPC que suportam o mecanismo de desligamento (shutdown),
sempre enviado um aviso quando o Domnio parado ou entra em modo
Standby. Aps o aviso, todos os clientes so desconectados.

Drivers 245
4.3 Driver de Comunicao OPC
O Driver de Comunicao OPC o mdulo responsvel por coletar dados
de equipamentos externos atravs da execuo de um Servidor OPC, que
pode ser fornecido por qualquer empresa. Os Tags podem ser importados
para o Driver OPC dentro do E3 (que neste caso atua como um OPC Client) ou
ainda podem ser criados a partir do E3. Para utilizar um Driver OPC, siga este
procedimento:

1. Clique com o boto direito do mouse no nome do projeto no Explorer e


selecione a opo Inserir - Driver de Comunicao OPC. No modo
Domnio, clique com o boto direito do mouse no item Objetos de
Servidor - Drivers e OPC, selecione a opo Inserir Driver de
Comunicao OPC em e logo aps o nome do projeto desejado.

Inserindo um Driver OPC

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


objeto, conforme a figura a seguir.

246 Drivers
Editor do Driver de Comunicao OPC

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

Opes disponveis no Editor do Driver OPC

CONE OPO DESCRIO


Adicionar Adiciona um Grupo ao
Driver, um Tag, um
Bloco ou uma Pasta ao
Grupo, ou um Elemento
ao Bloco

Remover Remove o item


selecionado no Editor

Selecionar servidor Seleciona o Servidor


OPC

Ativar/desativar Ativa e desativa a


comunicao comunicao do Driver

Importar tags Importa Tags para o


Driver OPC

Informaes sobre o Mostra uma janela com


servidor as configuraes do
Driver

Drivers 247
CONE OPO DESCRIO
Contagem de tags Apresenta o nmero
total de Tags de
Comunicao no Driver

248 Drivers
4.3.1 Configurao
A identificao dos outros objetos pertencentes ao Driver OPC pode ser
inserida manualmente, ou ento ser trazida automaticamente do Servidor
OPC. Para isto, abra a janela de propriedades do Driver, clicando com o
boto direito do mouse no objeto e selecionando a aba OPC Driver.

Aba OPC Driver

Informe o Endereo e ID do Servidor e clique em Selecionar. A janela da


figura a seguir mostrada.

Drivers 249
Seleo do Servidor OPC

As opes disponveis no item Opes de busca dos servidores OPC esto


descritas na tabela a seguir.

Opes disponveis no item Opes de busca dos servidores OPC

OPO DESCRIO
Tentar enumerador padro ou O E3 tenta procurar as
registro (recomendado) especificaes do Driver, tanto pelo
Registro do Windows quanto pelo
enumerador padro OPC
(OPCENUM)

250 Drivers
OPO DESCRIO
Tentar apenas enumerador padro O E3 tenta procurar as
(servio OPCENUM) especificaes do Driver apenas pelo
enumerador padro OPC
(OPCENUM)

Tentar apenas pesquisa no registro O E3 tenta procurar as


especificaes do Driver apenas
pelos registros no Windows

Drivers 251
Clicando em OK, o sistema mostra os dados do Driver, indicando os caminhos
e o nome do servidor. Para ativar a comunicao do Driver OPC, clique em
Ativar Comunicao.

Ativar comunicao do Driver OPC

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

Opes habilitadas quando o Driver OPC est ativo

A opo Informaes sobre o servidor mostra uma janela com as


configuraes do Driver.

Drivers 253
Informaes do Servidor OPC

Atravs da opo Importar tags, possvel importar Tags para o Driver OPC.
Quando esta opo selecionada, a caixa de dilogo da figura a seguir
mostrada.

Mensagem referente importao de Tags OPC

As opes disponveis nesta caixa de dilogo so as seguintes:

254 Drivers
Sim: O E3, ao executar a localizao dos Tags OPC, tenta
automaticamente detectar quais Tags so do tipo Bloco e, neste caso,
qual o nmero de Elementos. Para isto, o E3 precisa ler o valor de cada
um, o que dependendo do servidor e do nmero de Tags, pode ser
demorado

No: O E3 no l os valores dos Tags OPC ao realizar a operao de


busca. Esta operao mais rpida, porm no cria automaticamente
Tags OPC de tipo Bloco e seus Elementos

Cancelar: Cancela a importao

A janela de importao dispe dos recursos mostrados na figura a seguir.

Importao de Tags OPC

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

Opes disponveis na janela Importao de Tags OPC

OPO DESCRIO
Nome dos Itens Filtra os Tags a partir do nome dos
itens especificados. Podem ser
utilizados caracteres curingas, tais
como * (asterisco) ou ? (ponto de
interrogao)

Tipo de dados Filtra os Tags a partir do tipo de


dado especificado no campo, que
pode ser Integer, Long, Single, etc.

Tipo de acesso Filtra os Tags a partir do tipo de


acesso especificado no campo, que
pode ser Leitura, Escrita ou Leitura
e Escrita

Mostrar apenas itens com IDs no Filtra os Tags para que a aplicao
encontrados no projeto mostre apenas os itens com IDs no
encontrados no projeto

Projeto corrente Mostra os objetos que foram


selecionados para adio no projeto
corrente

Servidor OPC Mostra os Tags disponveis no


servidor para importao

256 Drivers
Para executar a importao, selecione o Tag desejado e arraste-o para o
Driver ou Grupo OPC desejado. Para desativar a comunicao do Driver OPC,
clique em Desativar Comunicao.

Algumas das propriedades do Driver OPC podem ser configuradas atravs da


Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso
necessite configurar alguma propriedade, localize-a na Lista de Propriedades
e execute os devidos ajustes. Para maiores informaes, consulte o Manual
de Referncia e Scripts do E3.

4.3.1.1 Funcionamento

A comunicao do cliente OPC do E3 com um servidor OPC feita por um


processo separado. Este processo, quando o Driver OPC ativado pelo
Studio, executa na conta do usurio atual do Windows. Em tempo de
execuo, por outro lado, este processo executado na conta SYSTEM.
Alguns servidores OPC podem ser sensveis conta em que esto executando
e, por este motivo, pode ser necessrio reconfigurar o processo para que
seja executado por um usurio especfico. Para isto, siga estes procedimentos:

1. V ao menu Iniciar - Painel de Controle - Ferramentas Administrativas -


Servios de Componente (Start - Control Panel - Administrative Tools -
Component Services), ou digite dcomcnfg no prompt de comando do
Windows.

2. Expanda o item Config DCOM (DCOM Config) em Servios de


componente - Computadores - Meu computador (Component Services -
Computers - My Computer), clique com o boto direito do mouse no item
E3OpcClient e selecione a opo Propriedades (Properties).

3. Selecione a aba Identidade (Identity), selecione o item Este usurio (This


user) e preencha as informaes da conta.

4. Clique em OK e reinicie o computador para que as modificaes sejam


aplicadas.

Drivers 257
4.3.2 Grupo de Tags OPC
O objeto Grupo de Tags OPC agrupa uma srie de Tags OPC que
compartilham os mesmos parmetros de atualizao (tempo de varredura e
banda morta). sempre necessrio existir um Grupo de Tags OPC para poder
criar Tags OPC. Para inserir um Grupo de Tags OPC, siga este procedimento:

1. Clique com o boto direto do mouse no Driver OPC e selecione a opo


Inserir - Grupo de tags OPC.

Inserindo um Grupo de Tags OPC

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

Drivers 259
4.3.3 Pasta OPC
O objeto Pasta OPC define grupos ou subdiretrios, de forma a melhor
organizar as variveis. Cada Pasta OPC pode ser renomeada conforme a
necessidade, e novas Pastas podem ser inseridas dentro de outras. Em tempo
de execuo, se a Pasta OPC for desabilitada, todo o contedo desativado.
Para utilizar este recurso, siga este procedimento:

1. Clique com o boto direito do mouse no Grupo OPC e selecione a opo


Inserir - Nova Pasta.

Inserindo uma Pasta OPC

260 Drivers
4.3.4 Tag de Comunicao OPC
O Tag de Comunicao OPC um objeto para leitura ou escrita de valores
em um equipamento. A leitura do Tag feita automaticamente pelo Servidor
OPC, com tempo de varredura definido no Grupo OPC no qual ele est
inserido. Para utilizar este recurso, siga estes procedimentos:

1. Clique com o boto direito do mouse no Grupo OPC e selecione a opo


Inserir - Tag de Comunicao OPC.

Inserindo um Tag de Comunicao OPC

Drivers 261
2. Abre-se uma janela perguntando quantos Tags devem ser criados no
Grupo, e qual seu nome. Este nome autoincrementado e, se esta opo
for deixada em branco, os Tags so criados com o nome padro.

Inserindo Tags de Comunicao


OPC

Algumas das propriedades do Tag OPC podem ser configuradas atravs da


Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso
necessite configurar alguma propriedade, localize-a na Lista de Propriedades
e execute os devidos ajustes. Para maiores informaes, consulte o Manual
de Referncia e Scripts do E3.

262 Drivers
4.3.5 Bloco de Comunicao OPC
O objeto Bloco de Comunicao OPC possibilita a leitura ou escrita de um
conjunto de valores. Para executar uma escrita, deve-se apenas atribuir um
novo valor propriedade Value. A leitura do Tag feita automaticamente
pelo Servidor OPC com tempo de varredura definido no Grupo OPC. A
propriedade Size determina o nmero de Elementos do Tag no servidor. Para
utilizar este recurso, siga estes procedimentos:

1. Clique com o boto direito do mouse no Grupo OPC e selecione a opo


Inserir - Bloco de Comunicao OPC.

Drivers 263
Inserindo um Bloco de Comunicao OPC

2. Abre-se uma janela perguntando quantos Blocos devem ser criados no


Grupo, e qual seu nome. Este nome autoincrementado e, se esta opo
for deixada em branco, os Blocos so criados com o nome padro.

264 Drivers
Inserindo Blocos de
Comunicao OPC

3. mostrada uma caixa de dilogo para determinar o nmero de


Elementos de Bloco neste objeto. Nesta opo possvel indicar o
mapeamento de todos os Elementos de Bloco ou somente de um
determinado intervalo de Elementos.

Configurando o Bloco de Comunicao

4. Informe o tamanho do Bloco e a opo de mapeamento.

5. Clique em OK.

6. Caso necessite, configure as propriedades do objeto.

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

4.3.6 Elemento de Bloco OPC


O objeto Elemento de Bloco OPC possibilita a leitura ou escrita de um dos
Elementos do Bloco OPC onde ele est inserido.

O Bloco OPC l uma tabela de dados, e este objeto est sempre associado
posio definida por sua propriedade Index. Por exemplo, um Elemento de
Bloco OPC com Index igual a cinco e inserido em um Bloco OPC com tamanho
10, cujos dados sejam lidos como na tabela a seguir.

Tabel 5 12 77 55 1 3 42 20 8 89
a
ndice 0 1 2 3 4 5 6 7 8 9

266 Drivers
Teria sua propriedade Value igual a trs, segundo a tabela anterior.

NOTA
O E3 pode criar automaticamente os Elementos de Bloco OPC. Para maiores
detalhes, veja a opo Importar Tags, no tpico Configurao.

Para utilizar este recurso, siga este procedimento:

1. Clique com o boto direito do mouse no Bloco OPC e selecione a opo


Inserir - Elemento de Bloco OPC.

Drivers 267
Inserindo um Elemento de Bloco OPC

Algumas das propriedades do Elemento de Bloco OPC podem ser


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

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

Inserindo um Driver de Comunicao OPC UA em modo Domnio

Algumas das propriedades do Driver de Comunicao OPC UA podem ser


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

Drivers 269
4.4.1 Configurao
A configurao do objeto Driver de Comunicao OPC UA semelhante
configurao do Driver de Comunicao OPC. Para configur-lo, clique com
o boto direito do mouse no objeto e selecione o item Selecionar servidor.

Opo Selecionar servidor

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

Servidores OPC UA locais e na rede

Para cada servidor OPC UA, tanto locais quanto em rede, so enumerados os
pontos de conexo (endpoints), que podem utilizar diferentes protocolos e
modos de segurana. Alm disto, para cada ponto de conexo o servidor
tambm pode suportar diferentes formas de identificao e autenticao de
usurios.

Atualmente, o E3 permite a conexo apenas pelo modo TCP Binrio. Para


este modo, o E3 suporta os modos de segurana definidos pelo padro OPC
UA, em diversas combinaes de polticas de segurana. Para a autenticao,
o E3 suporta apenas os modos Annimo e Usurio e Senha.

Drivers 271
NOTA
A janela Servidores OPC UA lista todos os protocolos e modos de
segurana, para informao do usurio. Entretanto, somente os modos
compatveis com o E3 podem ser selecionados.

Ao selecionar um ponto de conexo compatvel com o E3, as propriedades


EndPointURL, SecurityMode e SecurityPolicy do objeto so
automaticamente preenchidas.

Se as propriedades UserName e Password do objeto forem deixadas em


branco, o E3 utiliza uma conexo annima com o servidor. Caso contrrio, o
E3 envia os valores destas propriedades para o servidor, que deve suportar
este tipo de autenticao no ponto de conexo selecionado.

Neste objeto tambm possvel configurar diversos limites de tempo (time-


outs) da conexo OPC UA. Estes valores de limite de tempo (propriedades
TimeoutCall, TimeoutConnection e TimeoutSession) so sempre em
milissegundos e devem ser ajustados de acordo com a performance da
comunicao, que pode ser limitada pelo servidor, pela rede, pelas mquinas
onde executam o cliente e o servidor, e at mesmo pelas operaes feitas
pelo cliente. Este ajuste deve ser feito caso a caso e os valores padro destas
propriedades so apenas sugestes.

No E3 Studio, a comunicao com o Driver pode ser ativada ao selecionar a


opo Ativar Comunicao no menu contextual do objeto. A ativao
executada automaticamente pelos objetos Consulta ao selecionar servidores,
Tags, ou executar a visualizao dos resultados de uma consulta (aba
Visualizar).

Note que para editar as propriedades do Driver pode ser necessrio


desativar a comunicao. Se a comunicao estiver ativa no E3 Studio,
possvel abrir uma janela de informaes sobre o servidor selecionado (ao
selecionar a opo Informaes sobre o servidor no menu contextual do
objeto). Caso a conexo no esteja estabelecida, por qualquer motivo, esta
janela mostra pontos de interrogao no lugar das informaes.

272 Drivers
4.4.2 Assinatura OPC UA
O objeto Assinatura OPC UA agrupa Tags OPC UA que compartilham o
tempo de varredura (a propriedade Scan) e a possibilidade de habilitar ou
desabilitar a leitura de todos os itens de uma vez (a propriedade Enable). A
existncia de um objeto Assinatura OPC UA obrigatria para que se possa
criar Tags OPC UA. Para inserir um objeto Assinatura OPC UA, siga este
procedimento:

1. Clique com o boto direto do mouse no Driver OPC UA e selecione a


opo Inserir - Assinatura OPC UA.

Inserindo uma Assinatura OPC UA

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

274 Drivers
4.4.3 Pasta OPC UA
O objeto Pasta OPC UA define grupos ou subdiretrios, de forma a melhor
organizar as variveis. Cada Pasta OPC UA pode ser renomeada conforme a
necessidade, e novas Pastas podem ser inseridas dentro de outras. Em tempo
de execuo, se a Pasta OPC UA desabilitada, todo seu contedo
desativado. Para utilizar este recurso, siga este procedimento:

1. Clique com o boto direito do mouse no objeto Assinatura OPC UA e


selecione a opo Inserir - Pasta.

Inserindo uma Pasta OPC UA

Drivers 275
4.4.4 Tag de Comunicao OPC UA
O Tag de Comunicao OPC UA um objeto para leitura ou escrita de
valores em um equipamento. A leitura do Tag realizada automaticamente
pelo servidor OPC UA, com tempo de varredura definido na Assinatura OPC
UA na qual est inserido. Para utilizar este recurso, siga estes procedimentos:

1. Clique com o boto direito do mouse no objeto Assinatura OPC UA e


selecione a opo Inserir - Tag de Comunicao OPC UA.

Inserindo um Tag de Comunicao OPC UA

2. Abre-se uma janela perguntando quantos Tags devem ser criados na


Assinatura, e qual seu nome. Este nome autoincrementado e, se esta
opo deixada em branco, os Tags so criados com o nome padro.
276 Drivers
Configurando a quantidade de
Tags

Algumas das propriedades do Tag OPC UA podem ser configuradas atravs


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

4.4.5 Bloco de Comunicao OPC UA


O objeto Bloco de Comunicao OPC UA possibilita a leitura ou escrita de
um conjunto de valores. Para executar uma escrita, deve-se apenas atribuir um
novo valor propriedade Value. A leitura do Tag realizada
automaticamente pelo servidor OPC UA com tempo de varredura definido na
Assinatura OPC UA. A propriedade Size determina o nmero de Elementos do
Tag no servidor.

NOTA
Na verso atual, o E3 s permite que vetores de uma dimenso (arrays)
sejam mapeados para Blocos de Comunicao, embora o padro OPC UA
suporte matrizes n-dimensionais como tipos de dados.

Para utilizar este recurso, siga estes procedimentos:

1. Clique com o boto direito do mouse na Assinatura OPC UA e selecione a


opo Inserir - Bloco de Comunicao OPC UA.

Drivers 277
Inserindo um Bloco de Comunicao OPC UA

2. Abre-se uma caixa de dilogo para indicar quantos Blocos devem ser
criados na Assinatura, e qual seu nome. Este nome autoincrementado e,
se esta opo deixada em branco, os Blocos so criados com o nome
padro.

278 Drivers
Configurando a quantidade de
Blocos

3. Abre-se uma caixa de dilogo para determinar o nmero de Elementos de


Bloco neste objeto. Nesta opo possvel indicar o mapeamento de
todos os Elementos de Bloco ou somente de um determinado intervalo de
Elementos.

Configurando o Bloco de Comunicao OPC


UA

4. Informe o tamanho do Bloco e a opo de mapeamento.

5. Clique em OK.

6. Caso necessite, configure as propriedades do objeto.

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

280 Drivers
4.4.6 Elemento de Bloco OPC UA
O objeto Elemento de Bloco OPC UA possibilita a leitura ou escrita de um
dos Elementos do Bloco OPC UA onde ele est inserido. O Bloco OPC UA l
uma tabela de dados, e este objeto est sempre associado posio definida
por sua propriedade Index. Para utilizar este recurso, siga este procedimento:

1. Clique com o boto direito do mouse no Bloco OPC UA e selecione a


opo Inserir - Elemento de Bloco OPC UA.

Inserindo um Elemento de Bloco OPC UA

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

282 Drivers
4.4.7 Objeto Consulta
Para configurar um objeto Consulta para buscar dados em um servidor OPC
UA utilizando o Driver OPC UA, siga estes procedimentos:

1. Selecione o Driver OPC UA na janela Defina o Servidor de Banco de Dados


da Consulta.

Selecionar Driver OPC UA

2. A janela a seguir mostrada, permitindo configurar a Consulta.

Drivers 283
Aba Campos

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

Opes disponveis na aba Campos

OPO DESCRIO
Dados Brutos A Consulta retorna os dados como
so armazenados no servidor,
semelhante consulta
CompressedDataStartEndTime do
objeto Storage. Neste modo,
apenas um Tag pode ser consultado
por vez, retornando tambm a
qualidade do valor

284 Drivers
OPO DESCRIO
Dados Processados A Consulta retorna dados
agregados dentro de um intervalo
de tempo, semelhante s consultas
SampledData e CalculatedData do
objeto Storage. Neste modo, vrios
Tags podem ser consultados por
vez, mas no retornam a qualidade
do valor. Diversas funes de
agregao podem ser utilizadas,
como por exemplo mdias,
mximos, interpolaes, etc. Funes
diferentes podem ser usadas para
cada Tag e um mesmo Tag pode
aparecer vrias vezes na Consulta,
com funes de agregao
diferentes. O E3 apenas lista as
funes padro, sem buscar funes
especficas do servidor ou filtrar
funes no suportadas pelo
servidor. A Consulta pode falhar
caso seja selecionada uma funo
no suportada pelo servidor OPC
UA

Adiciona um ou mais Tags do


servidor OPC UA

Remove o Tag selecionado da


Consulta

Fora a atualizao dos


Identificadores de Ns OPC UA
(NodeIds)

Id Tipo de Identificador de N OPC UA


(NodeId) no servidor

Colunas Caminho do Tag no servidor OPC


UA

Drivers 285
OPO DESCRIO
Ttulo Nome do Tag no servidor OPC UA

Funo Funo utilizada no Tag. Esta coluna


s est disponvel quando a opo
Dados Processados est
selecionada

Ao clicar em , a janela a seguir mostrada, permitindo selecionar os Tags


existentes no servidor.

Seleo de Tags OPC UA

As abas Variveis e Visualizar tm o mesmo comportamento descrito no


captulo Consultas.

286 Drivers
4.4.8 Certificados
Durante a instalao do E3, instalado um certificado relativo instncia do
cliente OPC UA do E3. Este certificado necessrio sempre que for utilizada
uma conexo com o servidor cujo modo de segurana (propriedade
SecurityMode) no seja igual a None (ou seja, uma conexo OPC UA segura).

Este certificado pode ser encontrado na pasta CertificateStore/certs da


instalao do E3, em um arquivo chamado Elipse E3 UA Client [xxx].der, onde
xxx um cdigo gerado aleatoriamente.

Se este certificado apagado, um novo gerado automaticamente sempre


que o Driver OPC UA tentar estabelecer uma conexo com um servidor.

NOTAS
Apagar o certificado pode significar ter que atualizar os servidores OPC
UA com o novo certificado, ou ento a conexo segura com o cliente do
E3 pode ser negada.
Este certificado corresponde instncia do cliente, e no ao cliente OPC
UA do E3, ou seja, ele NO pode ser copiado de uma mquina para
outra. Cada instalao tem um certificado nico.
O cliente OPC UA do E3 aceita qualquer certificado vlido de servidor, ou
seja, no necessria nenhuma configurao para que o cliente do E3
aceite uma determinada instncia de servidor OPC UA.

Drivers 287
4.4.9 Limitaes na Leitura de Tipos de Dados
O Driver de Comunicao OPC UA do E3 suporta tipos bsicos e vetores de
uma dimenso, bem como alguns tipos de estruturas definidas pelo padro
OPC UA. So suportados valores escalares e vetores dos seguintes tipos:

Tipos suportados plenamente: SByte, Byte, Int16, UInt16, Int32, UInt32,


Int64, UInt64, Float, Double, Boolean, String, DateTime e ByteString

Tipos suportados com limitaes: DataValue (ignora a estampa de


tempo e a qualidade), LocalizedText (ignora a configurao regional),
QualifiedName (ignora o NamespaceIndex), StatusCode (convertido para
SCode ou HRESULT), Guid (convertido para texto), ArrayQualifiedName,
ArrayLocalizedText, Structure, ArrayStructure, ArrayDataValue,
Unknown e ArrayUnknown (no permitem a escrita na verso atual do
E3)

Tipos suportados convertidos para vetores de uma dimenso de


tamanho fixo: Estes tipos de dados so retornados como vetores de
Variants, em que cada um dos campos um item do vetor. Se o campo
for outro objeto, o Variant contm outro vetor, e assim por diante. Os
tipos suportados so ServerDiagnosticsSummaryDataType,
SubscriptionDiagnosticsDataType,
SessionSecurityDiagnosticsDataType, SessionDiagnosticsDataType,
ApplicationDescription, Argument, BuildInfo,
ServiceCounterDataType, ExpandedNodeId, NodeId,
ServerStatusDataType, EUInformation, Range, TimeZoneDataType,
StatusResult, ComplexNumberType, DoubleComplexNumberType,
XVType, RedundantServerDataType,
SamplingIntervalDiagnosticsDataType, EnumValueType,
NetworkGroupDataType e EndpointUrlListDataType

NOTA
Estruturas definidas por servidores especficos, no compatveis com o
padro OPC UA, no so lidas pelo E3.

288 Drivers
Nos campos da consulta, o texto dos caminhos dos Tags do servidor segue o
padro OPC UA de caminhos relativos. Os componentes deste caminho so
os seguintes:

/ (barra): Indica uma referncia hierrquica qualquer

. (ponto): Indica uma referncia de agregao qualquer

[ns:]browse-name: A String que segue uma barra ou ponto especifica o


nome de browse de um item. Este nome pode ser prefixado com seu
ndice de Namespace. Se for omitido, assumido o ndice 0 (zero)

& (e comercial, caractere de escape): Insere um caractere reservado no


local. Por exemplo, a expresso "&/Nome" substituda por "/Nome". Os
caracteres reservados so os seguintes:

/ (barra)

. (ponto)

< (menor que)

> (maior que)

: (dois pontos)

# (sinal numrico)

! (ponto de exclamao)

& (e comercial)

A definio formal de um caminho OPC UA, em notao BNF, a seguinte:

Drivers 289
<caminho-relativo> ::= <tipo-referencia> <nome-browse>
<tipo-referencia> ::= '/' | '.' | '<' ['#'] ['!']
<nome-browse> '>'
<nome-browse> ::= [<indice-namespace> ':'] <nome>
<indice-namespace> ::= <digito> [<digito>]
<digito> ::= '0' | '1' | '2' | '3' | '4' | '5'
| '6' | '7' | '8' | '9'
<nome> ::= (<caractere-nome> | '&' <caractere-reservado>)
[<nome>]
<caractere-reservado> ::= '/' | '.' | '<' | '>' | ':'
| '#' | '!' | '&'
<caractere-nome> ::= Todos os caracteres vlidos
para uma String, exceto caracteres reservados.

O E3 no suporta Identificadores de Ns OPC UA (NodeIds) que no sejam


do servidor onde executado o browse dos Tags (servidores Gateway). Estes
Tags, portanto, no so mostrados na janela de seleo de servidores. Alm
disto, os caminhos so sempre hierrquicos e apenas os tipos de referncia
barra (/) e ponto (.) so suportados (o tipo <browse-name> no
suportado).

4.5 Qualidade
Os campos de qualidade representam o estado da qualidade do valor do
item. formado de uma palavra de 16 bits, sendo que os primeiros oito bits
so definidos na forma de trs campos de bits: Qualidade, Substatus e
Limite.

Os outros oito bits (de maior ordem) esto disponveis para uso de cada
fabricante. Se estes bits forem utilizados, os bits de qualidade padro ainda
so utilizados para indicar quais dedues pode-se fazer sobre os dados
retornados. Assim, de responsabilidade do cliente interpretar o campo de
informaes especficas de qualidade, para garantir que o servidor que est
provendo esta informao usa as mesmas regras do cliente.

Opes disponveis no campo Qualidade

QUALIDADE CAMPO QUALIDADE DESCRIO


0 - 63 Ruim O valor no til pelas
razes indicadas no
campo Substatus

290 Drivers
QUALIDADE CAMPO QUALIDADE DESCRIO
64 - 127 Incerta A qualidade do valor
incerta pelas razes
indicadas no campo
Substatus

128 - 191 (Reservado) No usado pelo


padro OPC

192 - 255 Boa A qualidade do valor


boa

Um servidor que no suporta informao de qualidade retorna 192 (Bom)


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

4.5.1 Campo Substatus


O layout deste campo depende do valor do campo Qualidade.

Substatus para Qualidade RUIM

SUBSTATUS DESCRIO LIMITE


SEM BAIXO ALTO CONSTANT
LIMITE E
No O valor 0 1 2 3
especfico ruim, mas
nenhuma
razo
especifica
conhecida

Drivers 291
SUBSTATUS DESCRIO LIMITE
SEM BAIXO ALTO CONSTANT
LIMITE E
Erro de H algum 4 5 6 7
Configura problema
o de
configura
o especfico
no servidor.
Por
exemplo, o
item em
questo
pode ter
sido
apagado

No A entrada 8 9 10 11
Conectado deveria
estar
logicamente
conectada a
algo, mas
no est.
Esta
qualidade
pode
refletir que
no h
valor
disponvel
neste
momento,
pois o valor
pode no
ter sido
fornecido
pela fonte
de dados

292 Drivers
SUBSTATUS DESCRIO LIMITE
SEM BAIXO ALTO CONSTANT
LIMITE E
Falha de Uma falha 12 13 14 15
Dispositivo de
dispositivo
foi
detectada

Falha de Uma falha 16 17 18 19


Sensor de sensor
foi
detectada
(o campo
Limite
pode
conter
informao
adicional)

ltimo Comunica 20 21 22 23
valor o em falha.
conhecido Entretanto,
o ltimo
valor
conhecido
est
disponvel.
Note que a
idade do
valor pode
ser
determinad
a pela
propriedad
e
TimeStamp

Drivers 293
SUBSTATUS DESCRIO LIMITE
SEM BAIXO ALTO CONSTANT
LIMITE E
Falha de A 24 25 26 27
Comunica comunica
o o falhou.
No h
ltimo valor
conhecido
disponvel

Fora de O Bloco 28 29 30 31
Servio est fora
de scan ou
trancado

N/A No 32 - 63
utilizado

Substatus para Qualidade INCERTA

SUBSTATUS DESCRIO LIMITE


SEM BAIXO ALTO CONSTANT
LIMITE E
No No h 64 65 66 67
especfico razo
especfica

294 Drivers
SUBSTATUS DESCRIO LIMITE
SEM BAIXO ALTO CONSTANT
LIMITE E
ltimo O 68 69 70 71
valor dispositivo
utilizvel que estava
providencia
ndo o valor
parou de
faz-lo. O
valor
retornado
deve ser
considerad
o velho.
Note que
isto difere
de um valor
Ruim com
o
Substatus 5
(ltimo
valor
conhecido).
Aquele
estado
associado
com uma
falha
detectvel
de
comunica
o em um
valor
buscado.
Este erro
associado
com a falha
de alguma
fonte

Drivers 295
SUBSTATUS DESCRIO LIMITE
SEM BAIXO ALTO CONSTANT
LIMITE E
externa que
iria inserir
algo no
valor
dentro de
um perodo
aceitvel.
Note que a
idade do
valor pode
ser
determinad
a na
propriedad
e
TimeStamp

No No 72 - 79
utilizado utilizado

296 Drivers
SUBSTATUS DESCRIO LIMITE
SEM BAIXO ALTO CONSTANT
LIMITE E
Sensor O valor est 80 81 82 83
impreciso colado em
um dos
limites do
sensor
(neste caso
o campo
Limite deve
estar
configurado
para 1 ou
2) ou o
sensor est
de algum
modo
conhecido
fora de
calibrao
via algum
diagnstico
interno
(neste caso
o campo
Limite deve
ser zero)

Drivers 297
SUBSTATUS DESCRIO LIMITE
SEM BAIXO ALTO CONSTANT
LIMITE E
Unidade de O valor 84 85 86 87
engenharia retornado
excedida est fora
dos limites
definidos
para este
parmetro.
Note que
neste caso
o valor do
campo
Limite
indica quais
limites
foram
excedidos,
mas no
necessaria
mente
implica que
o valor no
possa ir
mais alm
da faixa
especificad
a

Subnormal O valor 88 89 90 91
derivado de
mltiplas
fontes e h
um nmero
menor do
que o
requerido
de fontes
boas

298 Drivers
SUBSTATUS DESCRIO LIMITE
SEM BAIXO ALTO CONSTANT
LIMITE E
No No 92 - 127
utilizado utilizado

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

Substatus para Qualidade BOA

SUBSTATUS DESCRIO LIMITE


SEM BAIXO ALTO CONSTANT
LIMITE E
No O valor 192 193 194 195
especfico bom. No
h
condies
especiais

No No 196 - 215
utilizado utilizado

Forado Tipicamente 216 217 218 219


localmente indica que a
entrada foi
desconecta
da e um
valor
manual foi
forado

No No 220 - 255
especfico utilizado

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

4.5.2 Campo Limite


O campo Limite vlido independente dos campos Qualidade e Substatus.
Em alguns casos, como uma falha de sensor, ele pode prover informaes de
diagnstico.

Campo Limite

ESPECIFICAO DESCRIO
No Limitado O valor livre para mover-se acima
ou abaixo

Limite Inferior O valor est limitado em algum valor


inferior

Limite Superior O valor est limitado em algum valor


superior

Constante O valor uma constante e no pode


mover-se

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

300 Drivers
CAPTULO
Quadros
5
O objeto Quadro utilizado para organizar e estruturar a interface do
projeto, criando visualizaes compostas para o usurio dentro da janela
principal do Viewer ou do navegador. Muitas vezes, uma aplicao requer
apenas uma Tela principal, que a porta de entrada para a aplicao. A partir
da, o usurio pode navegar por outras Telas, que ocupam o lugar da
primeira, formando uma nica visualizao do processo. Porm, possvel
suportar mais de uma visualizao em um mesmo documento ou projeto. Isto
se torna til no caso de uma aplicao que utilize uma Tela que nunca muda,
ou que muda pouco (como, por exemplo, um menu), e outra parte que a
navegao das Telas propriamente ditas. Para utilizar este recurso, execute os
procedimentos a seguir.

1. Clique com o boto direito do mouse no nome do projeto no modo


Explorer e selecione a opo Inserir - Quadro. No modo Domnio, clique
com o boto direito do mouse no item Visualizao - Viewer e Quadros,
selecione a opo Inserir Quadro em e logo aps o nome do projeto
desejado.

Quadros 301
Inserindo um Quadro no modo Domnio

O Quadro possui subdivises, chamadas de Divisores, que podem ser


inseridas ou removidas do Quadro atravs de um menu contextual na aba
Design do Editor do objeto. A princpio, o Quadro possui um Divisor inicial,
que pode ser subdividido horizontal ou verticalmente em dois Divisores, que
por sua vez tambm podem ser subdivididos em outros dois Divisores, e
assim sucessivamente.

A cada par de novos Divisores criados pelas opes Dividir


Horizontalmente e Dividir Verticalmente, h sempre um Divisor Principal e
um Divisor Secundrio. Apenas o Divisor Principal tem valores que definem
explicitamente o seu posicionamento, ficando o Divisor Secundrio com o
valor restante.

Assim, quando o Divisor subdividido horizontalmente, sua propriedade


SplitDockPosition recebe o valor dockTop. Do mesmo modo, se a
subdiviso for vertical, esta propriedade recebe o valor dockLeft. A
propriedade do Divisor Secundrio recebe, ento, o valor dockRemaining,
significando que este Divisor ocupa o espao restante.

302 Quadros
Os cones dos objetos no Organizer identificam exatamente o posicionamento
de cada Divisor.

Posicionamento do Divisor

CONE DESCRIO
dockBottom: Este Divisor est
posicionado na parte inferior do
Divisor Pai

dockTop: Este Divisor est


posicionado na parte superior do
Divisor Pai

dockLeft: Este Divisor est


posicionado esquerda do Divisor
Pai

dockRight: Este Divisor est


posicionado direita do Divisor Pai

dockRemaining: Este Divisor ocupa


o espao restante aps o
posicionamento de seu Divisor Irmo

Quadros 303
Cada Divisor corresponde visualizao de uma Tela ou Quadro de seu
processo ou a uma URL (Uniform Resource Locator). Para utilizar este recurso,
execute os procedimentos a seguir.

1. Clique com o boto direito do mouse no Quadro aberto e selecione uma


das opes: Dividir Horizontalmente ou Dividir Verticalmente,
conforme o tipo de Diviso desejada.

Inserindo um Divisor Horizontal ou


Vertical

2. Para remover um Divisor, clique com o boto direito do mouse no


Quadro aberto e selecione a opo Deletar.

304 Quadros
3. possvel inverter a seleo original dos Divisores (transformar o Divisor
Principal em Divisor Secundrio, e vice-versa) atravs deste mesmo menu.
No caso de um Divisor Principal, clique com o boto direito do mouse no
Quadro e selecione a opo Configurar como Divisor Secundrio. No
caso de um Divisor Secundrio, selecione a opo Configurar como
Divisor Principal. A propriedade SplitDockPosition dos Divisores
automaticamente configurada para refletir esta mudana.

4. Com a opo Selecionar Tela ou Quadro, possvel escolher a Tela ou


Quadro que associada propriedade SplitLink do Divisor selecionado,
usando o AppBrowser.

5. Pode-se inserir vrios Divisores no Quadro.

Divisores do Quadro

6. Para configurar os Divisores do Quadro, clique com o boto direito do


mouse no Divisor desejado no Organizer e selecione a opo
Propriedades.

Quadros 305
Configuraes do Quadro

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

Opes disponveis na aba Quadro

OPO DESCRIO
Tela ou Quadro Determina o caminho da Tela ou
Quadro que o Divisor abre. S
habilitado se o Divisor no tiver
nenhum filho. Este campo equivale
propriedade SplitLink

Posicionamento Determina a posio do Divisor no


Quadro. Este campo equivale
propriedade SplitDockPosition

Valor Determina o valor que atribudo ao


Quadro. S tem efeito visual se for
modificada no Divisor Principal. Este
campo equivale propriedade
SplitValue

306 Quadros
NOTAS
Todas as opes do Quadro que esto disponveis via menu contextual
(atravs do clique com o boto direito do mouse) tambm esto
disponveis utilizando a combinao de teclas SHIFT + F10, que
corresponde tecla de aplicao ou de menu .
A janela de propriedades de um Quadro pode ser aberta utilizando as
combinaes de teclas ALT + ENTER, CTRL + ALT + ENTER ou ALT +
duplo-clique do mouse.

Algumas das propriedades do Quadro ou Divisor podem ser configuradas


atravs da Lista de Propriedades, sem a necessidade da criao de scripts
para isto. Caso haja a necessidade de configurar alguma propriedade,
localize-a na Lista de Propriedades e faa os devidos ajustes. Para maiores
informaes, consulte o Manual de Referncia e Scripts do E3.

Quadros 307
CAPTULO
Viewer
6
O objeto Viewer disponibiliza a visualizao da aplicao. Permite visualizar
Telas do projeto em modo de execuo e a operao do sistema. O Viewer
pode ser executado a partir de qualquer ponto da rede que tenha acesso ao
E3 Server. No necessrio copiar o aplicativo para os outros Viewers, pois
as Telas e bitmaps so baixados conforme a necessidade em tempo de
execuo. S pode existir um objeto Viewer em um Domnio.

Viewer no modo Domnio

Para criar um Viewer no projeto, siga este procedimento:

1. Verifique se j existe um Viewer no Domnio, ou insira um novo clicando


com o boto direito do mouse no nome do projeto no modo Explorer e
selecionando a opo Inserir - Viewer. No modo Domnio, clique com o
boto direito do mouse no item Visualizao - Viewer e Quadros,
selecione a opo Inserir Viewer em e logo aps o nome do projeto
desejado.

308 Viewer
NOTA
A qualidade grfica das Telas pode ser modificada, em tempo de execuo,
utilizando-se o menu contextual do Viewer e selecionando uma das opes
do menu Qualidade (todas as telas). Para maiores informaes, veja a
propriedade RenderQuality do Viewer no Manual de Referncia e Scripts
do E3.

6.1 Configurao
Atravs da janela de propriedades do Viewer, possvel especificar
configuraes do Viewer, Erros de comunicao, criar associaes ou scripts.

NOTA
A janela de propriedades do Viewer pode ser aberta utilizando as
combinaes de teclas ALT + ENTER, CTRL + ALT + ENTER ou ALT + duplo-
clique do mouse.

Viewer 309
6.1.1 Aba Visualizador
Atravs da aba Visualizador, so configuradas as opes do Viewer quanto a
ttulo, Tela e zoom, conforme explicado a seguir.

Aba Visualizador

Cada campo da aba Visualizador possui uma propriedade correspondente.


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

Opes disponveis na aba Visualizador

OPO DESCRIO
Ttulo Determina o ttulo do Viewer. Este
campo equivale propriedade
Caption do objeto Viewer

310 Viewer
OPO DESCRIO
Tela ou Quadro Inicial Determina a Tela ou Quadro que o
Viewer inicia. Clicando em ,o
Studio abre uma janela de
configurao, pela qual abre o
AppBrowser, onde especificada a
Tela inicial de visualizao. Este
campo equivale propriedade
InitialScreen do objeto Viewer

Zoom Determina o nvel de zoom para


visualizao no Viewer. Atravs das
suas opes, possvel configurar
como o Viewer inicializado. Este
campo equivale propriedade
InitialScreen do objeto Viewer, e
representado pelas especificaes
aps o caractere de ponto de
interrogao. Por exemplo, se na Tela
inicial o zoom de 100%, na
propriedade InitialScreen aparece a
descrio "TelaInicial?100", onde
TelaInicial o nome da Tela e ?100
a sua percentagem de zoom

Habilitar barra de rolagem na Tela Habilita a barra de rolagem na pgina


Inicial inicial

Exibir o menu do Zoom ao clicar Habilita a exibio do menu Zoom


com o boto direito do mouse com o boto direito do mouse, em
tempo de execuo. Este campo
equivale propriedade
EnableZoomMenu do objeto Viewer

Manter Telas carregadas na Habilita o Viewer a manter as Telas


memria carregadas em memria. Este campo
equivale propriedade CacheEnable
do objeto Viewer

Viewer 311
OPO DESCRIO
Verificar inatividade aps ... Define o tempo mximo de espera,
minutos em minutos, por um evento de mouse
ou de teclado para o perodo de
inatividade. Este campo equivale
propriedade EnableInactivity do
objeto Viewer

Nmero de retentativas para Estabelece o nmero de vezes que a


confirmao de usurio ou senha caixa de dilogo de login exibida
alm da primeira vez. Este campo
equivale propriedade LoginRetries
do objeto Viewer

312 Viewer
6.1.2 Aba Configurao
Atravs da aba Configurao, pode-se editar as opes relativas janela, ao
ttulo e resoluo do Viewer.

Aba Configurao

Cada campo da aba Configurao possui uma propriedade correspondente.


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

Opes disponveis na aba Configurao

Viewer 313
OPO DESCRIO
Iniciar Maximizada / Minimizada / Determina o estilo da janela do
Janelada Viewer. Este campo equivale
propriedade WindowStyle e possui
as seguintes opes:

0 - Maximized: A Tela inicia


maximizada

1 - Windowed: Estilo janelada, isto


, pode ser configurada a altura e a
largura da Tela

2 - Minimized: A Tela inicia


minimizada

Desabilitar troca de janelas Desabilita a troca de janelas. Este


campo equivale propriedade
DisableTaskSwitching do objeto
Viewer. Esta opo pode ser
modificada em tempo de execuo
usando o mtodo
SetDisableTaskSwitching

Barra de ttulo Habilita a barra de ttulo. Este campo


equivale propriedade TitleBar do
objeto Viewer

Boto de fechar Habilita o boto de fechar. Este


campo equivale propriedade
CloseButton do objeto Viewer

Boto de minimizar Habilita o boto de minimizar. Este


campo equivale propriedade
MinimizeButton do objeto Viewer

Boto de maximizar Habilita o boto de maximizar. Este


campo equivale propriedade
MaximizeButton do objeto Viewer

314 Viewer
OPO DESCRIO
Borda Habilita uma borda na janela do
Viewer. Este campo equivale
propriedade WindowBorder do
objeto Viewer

Opo de redimensionar Indica se a janela pode ser


redimensionada. Esta opo s tem
validade se a opo Borda estiver
marcada. Este campo equivale
propriedade WindowResizable do
objeto Viewer

Opo de mover Indica se a janela pode ser movida.


Este campo equivale propriedade
WindowMovable do objeto Viewer

Ficar sempre no topo Indica se a janela deve sempre se


sobrepor s outras janelas. Este
campo equivale propriedade
WindowStayOnTop do objeto Viewer

Barra de ttulo menor Habilita uma barra de ttulos pequena


na janela. Esta opo s tem efeito se
a opo Barra de ttulo estiver
marcada. Este campo equivale
propriedade WindowSmallTitle do
objeto Viewer

Resoluo da Tela Seleciona a resoluo da Tela: 640 x


480, 800 x 600, 1024 x 768, 1280 x
1024, ou 1600 x 1200 pixels

Avanado Abre a janela para configuraes


avanadas

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

Configuraes avanadas

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

Opes disponveis na janela Configuraes avanadas

OPO DESCRIO
Resoluo da Tela em pixels Permite escolher entre a resoluo
atual do computador ou uma
resoluo escolhida pelo usurio, em
pixels

316 Viewer
OPO DESCRIO
Desconto na resoluo da Tela em Permite escolher o desconto
pixels aplicado na resoluo da Tela entre
a configurao atual do computador
ou uma resoluo escolhida pelo
usurio, em pixels

Resoluo do monitor em pontos Permite escolher entre a resoluo


por polegada (DPI) atual do computador ou um
resoluo escolhida pelo usurio, em
pontos por polegada (DPI)

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

Aba Erros de comunicao

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

Opes disponveis na aba Erros de Comunicao

OPO DESCRIO
Visualizar erros de comunicao Habilita ou desabilita a visualizao
dos erros de comunicao

Texto Contm o texto que mostrado no


Setpoint, caso a qualidade do valor
seja ruim

318 Viewer
OPO DESCRIO
Cor da letra Contm a cor que deve ser usada no
texto

Cor de fundo Contm a cor que deve ser usada no


Setpoint. Equivale a uma alterao da
propriedade ForegroundColor do
Setpoint, mas esta alterao no
executada efetivamente. O valor da
propriedade do Setpoint no
alterado

6.2 Variveis no Viewer


No objeto Viewer possvel criar Associaes com objetos a partir de Telas,
bem como us-los via scripts. Tambm possvel inserir Tags Contador,
Demo, Interno e Timer no Viewer, alm de Pastas do Viewer e Consultas.
Atravs do AppBrowser, pode-se executar as seguintes aes:

Acessar o objeto Viewer ou algum de seus filhos a partir de uma Tela ou


controle de Tela (Associaes ou scripts)

Os filhos do objeto Viewer podem acessar outros filhos do Viewer ou o


prprio Viewer (Associaes ou scripts)

O prprio objeto Viewer pode acessar seus filhos (Associaes ou


scripts)

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

Viewer 319
6.3 Objeto _top
Quando um Viewer inserido no projeto, disponibiliza um Quadro filho. Este
Quadro filho chamado de _top. Este objeto possui as mesmas
funcionalidades do objeto Divisor do Quadro. Para utilizar este recurso, siga
estes procedimentos:

1. Clique em no item Visualizao - Viewer e Quadros - Viewer para


mostrar o Quadro _top.

Objeto _top

2. Para configurar as propriedades do objeto _top, clique com o boto


direito do mouse e selecione a opo Propriedades.

3. Este objeto possui as mesmas funcionalidades do objeto Divisor do


Quadro, e tais informaes podem ser encontradas nos captulos Telas e
Quadros.

320 Viewer
6.4 Pasta do Viewer
A Pasta do Viewer define grupos dentro do objeto Viewer de forma a
organizar os Tags do Viewer (Contador, Demo, Interno e Timer) e Consultas.
Caso haja necessidade, novas Pastas podem ser inseridas dentro de outras.
Para utilizar este recurso, siga este procedimento:

1. Clique com o boto direito do mouse no item Visualizao - Viewer e


Quadros - Viewer e selecione a opo Inserir - Panel - Pasta do Viewer.

Inserindo Pasta do Viewer

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

322 Viewer
CAPTULO
Telas e Objetos de Tela
7
Telas so janelas para monitoramento de processos. Em cada Tela so
inseridos objetos que compem a interface do operador com o sistema,
chamados Objetos de Tela. Cada aplicao pode ter um nmero ilimitado de
Telas e de objetos de Tela.

Telas e Objetos de Tela 323


7.1 Tela
A Tela o objeto bsico de interface com o usurio, e pode conter vrios
tipos de objetos. Os grficos inseridos na Tela podem ser apagados,
copiados, movidos, redimensionados, agrupados ou configurados.

Para inserir uma Tela no projeto, clique com o boto direito do mouse no
nome do projeto no modo Explorer e selecione a opo Inserir - Tela. No
modo Domnio, clique com o boto direito do mouse no item Visualizao -
Telas, selecione a opo Inserir Tela em e logo aps o nome do projeto
desejado.

Inserindo uma Tela no modo Domnio

Quando uma nova Tela criada, ou quando selecionada a opo Ajustar ao


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

324 Telas e Objetos de Tela


Configurando o tamanho da Tela

Opes disponveis na janela Configurando o tamanho da Tela

OPO DESCRIO
Escolha o Divisor onde a Tela ser Permite escolher o Divisor onde a
aberta Tela aberta. So listados apenas os
Divisores cuja Tela associada
propriedade SplitLink visvel em
tempo de execuo

Configurar como Tela inicial do Habilita a Tela como Tela Inicial do


Divisor Divisor onde aberta

Nome Determina o nome da Tela

Largura (pixels) Determina a largura da Tela, em


pixels

Altura (pixels) Determina a altura da Tela, em pixels

Telas e Objetos de Tela 325


As opes Largura e Altura esto inicialmente preenchidas com o tamanho
que a Tela deve ter para poder ser exibida no Divisor escolhido, sem que
aparea uma barra de rolagem. Se algum dos valores for negativo, isto indica
que o Divisor no est visvel em tempo de execuo, em funo da
configurao do Viewer e do tamanho dos outros Divisores.

O E3 Studio fornece um editor dos objetos que podem ser inseridos em uma
Tela. Esto disponveis os seguintes objetos: Linha, Retngulo, Retngulo
Arredondado, Elipse, Arco de Elipse, Desenho Livre, Polgono, Polgono de
Curvas, Figura (Imagem), Texto, Display, SetPoint, Escala e MSForms. Os
MSForms so discutidos no captulo ActiveX e os demais objetos citados so
apresentados neste captulo.

Tela

Pode-se configurar as propriedades da Tela para determinar tamanho, cor e


outros aspectos do comportamento e da aparncia, alm de vrios tipos de
eventos. Estes objetos utilizam como padro para o tamanho e coordenadas
as unidades Himetric, dadas em 1/100 mm, e no em pixels.

326 Telas e Objetos de Tela


Todas das propriedades da Tela podem ser configuradas atravs da Lista de
Propriedades, sem a necessidade de se criar scripts para isto. Caso necessite
configurar alguma propriedade, localize-a na Lista de Propriedades e faa os
devidos ajustes.

NOTA
A qualidade grfica de uma Tela pode ser modificada, em tempo de
execuo, utilizando-se o menu contextual do Viewer e selecionando uma
das opes do menu Qualidade (esta tela). Para maiores informaes, veja
a propriedade RenderQuality da Tela no Manual de Referncia e Scripts
do E3.

7.2 Objetos de Tela


Os seguintes objetos podem ser inseridos em uma Tela:

Primitivas do Editor Grfico (Retas, Crculos, Retngulos, Polgonos, etc.)

Controles ActiveX fornecidos pela Elipse (E3Alarm, E3Browser, E3Chart e


E3Playback)

Controles ActiveX fornecidos por terceiros

Imagens no vetoriais (Arquivos BMP, JPG, GIF, etc.)

Imagens vetoriais (Arquivos WMF, EMF, etc.)

Controles Padro do Windows (Lista, Editor de Texto, Lista de Seleo,


etc.)

Objetos ElipseX, compostos de qualquer dos objetos anteriores

Pastas do Viewer, Consultas, Tags Contador, Demo, Interno e Timer

As primitivas do editor grfico disponveis no Studio so listadas nos


prximos tpicos. Elas podem ser rotacionadas ou redimensionadas
livremente, exceto pelo objeto Figura. Aps ter sido criado, cada objeto
permanece selecionado para facilitar a edio de suas propriedades, caso
seja necessrio.

Telas e Objetos de Tela 327


7.2.1 Arco de Elipse
Permite o desenho de objetos do tipo arco, corda ou torta. Para utilizar este
objeto, siga estes procedimentos:

1. Selecione o Arco de Elipse na barra de ferramentas Tela.

2. Clique na Tela para estabelecer o ponto inicial do desenho e arraste o


mouse diagonalmente at o desenho atingir o tamanho e a posio
desejados.

3. Nas duas extremidades do corte, aparecem dois pontos responsveis


pela posio de abertura do desenho. Arraste-os de forma que o
desenho fique mais aberto ou mais fechado.

4. O formato do desenho inicial o de torta. Para alter-lo para arco ou


corda, utilize a propriedade ArcStyle na Lista de Propriedades.

328 Telas e Objetos de Tela


7.2.2 Conector
Este objeto utilizado para conectar dois ou mais objetos de Tela atravs de
uma linha. Os objetos de Tela que podem ser conectados so o Retngulo, o
Retngulo Arredondado, a Elipse, o Arco de Elipse, o Desenho Livre, o
Polgono e o Polgono de Curvas. Ao clicar em na barra de ferramentas
Tela, os objetos anteriormente citados mostram seus pontos de conexo,
como na figura a seguir.

Pontos de conexo de objetos de Tela

Para conectar dois objetos, clique em um dos pontos de conexo do primeiro


objeto e, em seguida, clique em um dos pontos de conexo do segundo
objeto. Sempre que se passa o mouse sobre um ponto de conexo, seu cone
muda de para , indicando qual ponto deve ser conectado.

Aps a criao do Conector, tambm possvel desconectar seus vrtices.


Para isto, arraste o vrtice para longe do ponto de conexo do objeto. Para
reconectar, arraste-o para perto de um ponto de conexo at que seu cone
mude para .

Para criar uma conexo entre mais de dois pontos de conexo, mantenha
pressionada a tecla CTRL enquanto seleciona todos os pontos desejados.

Para excluir um Conector, selecione-o e utilize a tecla DELETE. Se um objeto


que possua um Conector for excludo, o Conector no excludo.

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


seguir.

Telas e Objetos de Tela 329


7.2.2.1 Conectores em XControls

Os Conectores em objetos de Tela criados dentro de XControls devem ter


seus pontos de conexo definidos previamente, clicando-se em na barra
de ferramentas Tela. Ao selecionar esta ferramenta e clicar em um ponto de
conexo, a janela da figura a seguir mostrada.

Janela de edio de pontos de conexo

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

Opes disponveis na janela Novo Ponto de Conexo

OPO DESCRIO
Nome do Ponto de Conexo Permite definir um nome para o
Ponto de Conexo

Conectado a Mostra em qual Ponto de Conexo


do objeto de Tela o Ponto de
Conexo do XControl est conectado

Utilizar como "Ponto ncora" do Marca este Ponto de Conexo como


objeto o ponto ncora do objeto. Este
ponto ncora pode ser alterado
quando o XControl for inserido em
uma Tela. Veja tambm o tpico
Ponto ncora para maiores
informaes

330 Telas e Objetos de Tela


Para editar ou excluir um ponto criado, clique com o boto direito do mouse
no ponto e selecione a opo Excluir Ponto de Conexo ou Editar Ponto de
Conexo, conforme a figura a seguir. Um ponto de conexo tambm pode
ser excludo clicando-se nele com a tecla CTRL pressionada.

Excluir ou editar um ponto de conexo

Caso no seja definido nenhum Ponto de Conexo para os objetos de Tela


includos no XControl, no possvel conectar este XControl a nenhum outro
objeto de Tela, quando ele for includo em uma Tela.

7.2.3 Desenho Livre


Permite a criao de desenhos mo livre. Para utilizar este objeto, siga estes
procedimentos:

1. Selecione o Desenho Livre na barra de ferramentas Tela.

2. Clique na Tela para estabelecer o ponto inicial do desenho e arraste o


mouse em qualquer direo tantas vezes quantas forem necessrias para
completar o desenho desejado.

Telas e Objetos de Tela 331


7.2.4 Display
Permite criar um objeto que utilizado para mostrar os valores dos Tags em
tempo de execuo. Para utilizar este objeto, siga estes procedimentos:

1. Selecione o Display na barra de ferramentas Tela.

2. Clique na Tela para criar o vrtice de origem do objeto e arraste o mouse


diagonalmente at seu vrtice final.

3. Clique com o boto direito do mouse no objeto para abrir a Janela de


Propriedades. Na aba Item, selecione o Tag a ser associado
propriedade Value do Display.

7.2.5 Elipse
Permite o desenho de crculos e elipses. Para utilizar este objeto, siga estes
procedimentos:

1. Selecione a Elipse na barra de ferramentas Tela.

2. Clique na Tela para estabelecer o ponto inicial do desenho e arraste o


mouse diagonalmente at o desenho atingir o tamanho e a posio
desejados.

7.2.6 Escala
Permite a criao de um objeto que desenha rguas ou escalas de valores.
Para utilizar este objeto, siga estes procedimentos:

1. Selecione a Escala na barra de ferramentas Tela.

2. Clique na Tela para criar o vrtice de origem do objeto e arraste o mouse


diagonalmente at seu vrtice final.

332 Telas e Objetos de Tela


7.2.7 Figura
Permite mostrar imagens que estejam armazenadas em arquivos, que podem
ou no pertencer aplicao. A Figura pode ser redimensionada livremente,
porm a rotao e a animao s so efetivas quando esta for um metafile
convertido para smbolo. Os seguintes formatos de arquivo so suportados:
Bitmap (.bmp), Graphics Interchange Format (.gif), Joint Photographic Experts
Group (.jpg), ICO File Format (.ico), Windows Metafile (.wmf), Enhanced Metafile
(.emf), Portable Network Graphics (.png) e Tagged Image File Format (.tif). Para
utilizar este objeto, siga estes procedimentos:

1. Selecione a Figura na barra de ferramentas Tela.

2. Clique na Tela para criar o vrtice de origem do retngulo e arraste o


mouse diagonalmente at seu vrtice final.

3. O Studio abre uma caixa de dilogo para seleo do arquivo de imagem,


conforme a figura a seguir.

Seleo do arquivo de imagem

4. Selecione o arquivo desejado e clique em Abrir para inserir a figura na


Tela.

Telas e Objetos de Tela 333


7.2.8 Linha
Permite o desenho de retas, ligando dois pontos especificados na sua criao.
Para utilizar este objeto, siga estes procedimentos:

1. Selecione a Linha na barra de ferramentas Tela.

2. Clique na Tela para criar o ponto de origem da reta e arraste o mouse at


seu ponto final.

7.2.9 Polgono
Permite o desenho de polgonos com lados retos. Para utilizar este objeto,
siga estes procedimentos:

1. Selecione o Polgono na barra de ferramentas Tela.

2. Clique na Tela para estabelecer o vrtice inicial do desenho e arraste o


mouse em qualquer direo tantas vezes quantas forem necessrias para
completar o desenho desejado.

3. Quando desejar trocar a direo do desenho, clique uma vez com o


mouse. Quando desejar finaliz-lo, clique duas vezes com o mouse.

7.2.10 Polgono de Curvas


Permite o desenho de polgonos com lados curvos. Para utilizar este objeto,
siga estes procedimentos:

1. Selecione o Polgono de Curvas na barra de ferramentas Tela.

2. Clique na Tela para estabelecer o vrtice inicial do desenho e arraste o


mouse em qualquer direo tantas vezes quantas forem necessrias para
completar o desenho desejado.

3. Quando desejar trocar a direo do desenho, clique uma vez com o


mouse. Quando desejar finaliz-lo, clique duas vezes com o mouse.

334 Telas e Objetos de Tela


7.2.11 Retngulo
Permite o desenho de retngulos, criados a partir de dois vrtices. Para
utilizar este objeto, siga estes procedimentos:

1. Selecione o Retngulo na barra de ferramentas Tela.

2. Clique na Tela para criar o vrtice de origem do Retngulo e arraste o


mouse diagonalmente at seu vrtice final, at o desenho atingir o
tamanho e a posio desejados.

7.2.12 Retngulo Arredondado


Permite o desenho de retngulos com cantos arredondados, criados a partir
de dois vrtices. Para utilizar este objeto, siga estes procedimentos:

1. Selecione o Retngulo Arredondado na barra de ferramentas Tela.

2. Clique na Tela para criar o vrtice de origem do retngulo e arraste o


mouse diagonalmente at seu vrtice final, at o desenho atingir o
tamanho e a posio desejados.

3. No canto superior esquerdo do objeto, aparece o ponto responsvel pelo


fator de arredondamento do retngulo. Arraste-o mais para o centro ou
mais para as bordas para determinar a curva de seus vrtices.

7.2.13 SetPoint
Permite criar um objeto que funciona como uma caixa de edio onde so
inseridos contedos a serem atribudos a Tags associados. Para utilizar este
objeto, siga estes procedimentos:

1. Selecione o SetPoint na barra de ferramentas Tela.

2. Clique na Tela para criar o vrtice de origem do objeto e arraste o mouse


diagonalmente at seu vrtice final.

3. Clique com o boto direito do mouse no objeto para abrir a Janela de


Propriedades. Na aba Item, selecione o Tag a ser associado
propriedade Value do SetPoint.

Telas e Objetos de Tela 335


7.2.14 Texto
Permite a criao de um texto a ser exibido na Tela. Para utilizar este objeto,
siga estes procedimentos:

1. Selecione o Texto na barra de ferramentas Tela.

2. Digite o texto desejado e pressione a tecla ENTER.

3. Caso queira alterar ou digitar contedos neste objeto, utilize a


propriedade Value.

7.3 Configuraes Gerais


As configuraes dos tpicos a seguir podem ser aplicadas Tela ou aos
seus objetos.

NOTA
Todas as opes da Tela e dos objetos de Tela que esto disponveis via
menu contextual (atravs do clique com o boto direito do mouse)
tambm esto disponveis utilizando a combinao de teclas SHIFT + F10,
que corresponde tecla de aplicao ou de menu .
A janela de propriedades da Tela e dos objetos de Tela pode ser aberta
utilizando as combinaes de teclas ALT + ENTER, CTRL + ALT + ENTER ou
ALT + duplo-clique do mouse.

336 Telas e Objetos de Tela


7.3.1 Agrupar ou Desagrupar
Permite transformar mais de um objeto em apenas um, com propriedades
especficas. Para utilizar este recurso, siga estes procedimentos:

1. Selecione na Tela os objetos que devem formar o grupo.

2. Clique em Agrupar para criar um novo objeto. Esta operao pode ser
realizada em cascata, e um grupo pode conter qualquer objeto, inclusive
outros grupos.

3. Para desfazer a unio de um grupo de objetos, clique em Desagrupar .

4. Para editar um objeto contido em um grupo, clique com o boto direito


do mouse no objeto e selecione a opo Editar Grupo.

NOTA
possvel ajustar os objetos dentro de um grupo ao pixel mais prximo
(efeito Snap to Pixel), utilizando-se a combinao de teclas CTRL + BARRA
DE ESPAO. Neste caso, o efeito aplicado a cada um dos objetos dentro
do grupo, podendo ser desfeito utilizando-se a combinao de teclas
CTRL + Z.
Para sair do modo de edio de um grupo de objetos de Tela, clique duas
vezes na rea da Tela fora do grupo.

Telas e Objetos de Tela 337


7.3.2 Alinhamento
Permite alinhar os objetos de Tela entre si ou em relao Tela. As opes de
alinhamento disponveis esto descritas na tabela a seguir.

Opes de alinhamento para objetos de Tela

CONE OPO DESCRIO


Alinhar Esquerda Alinha dois ou mais
objetos entre si, tendo
como referncia a
coordenada esquerda
do ltimo objeto
selecionado

Alinhar Direita Alinha dois ou mais


objetos entre si, tendo
como referncia a
coordenada direita
do ltimo objeto
selecionado

Alinhamento Superior Alinha dois ou mais


objetos entre si, tendo
como referncia a
coordenada superior
do ltimo objeto
selecionado

Alinhamento Inferior Alinha dois ou mais


objetos entre si, tendo
como referncia a
coordenada inferior do
ltimo objeto
selecionado

338 Telas e Objetos de Tela


CONE OPO DESCRIO
Alinhamento Central Alinha dois ou mais
Horizontal objetos horizontalmente
entre si, tendo como
referncia o ltimo
objeto selecionado

Alinhamento Central Alinha dois ou mais


Vertical objetos verticalmente
entre si, tendo como
referncia o ltimo
objeto selecionado

Mesma Largura Aplica a largura do


ltimo objeto
selecionado aos demais
objetos selecionados

Mesma Altura Aplica a altura do


ltimo objeto
selecionado aos demais
objetos selecionados

Mesmo Tamanho Aplica a largura e a


altura do ltimo objeto
selecionado aos demais
objetos selecionados

Centralizar Centraliza o objeto na


Horizontalmente Tela, de acordo com
suas coordenadas
horizontais

Centralizar Centraliza o objeto na


Verticalmente Tela, de acordo com
suas coordenadas
verticais

Telas e Objetos de Tela 339


CONE OPO DESCRIO
Distribuir Aplica a mesma
Horizontalmente distncia horizontal
entre si a trs ou mais
objetos

Distribuir Aplica a mesma


Verticalmente distncia vertical entre
si a trs ou mais
objetos

Espelhar Aplica o efeito de


Horizontalmente reflexo horizontal aos
objetos selecionados

Espelhar Verticalmente Aplica o efeito de


reflexo vertical aos
objetos selecionados

NOTAS
As opes Espelhar Horizontalmente e Espelhar Verticalmente tm o
seguinte comportamento:
Para selees mltiplas, cada um dos objetos espelhado
individualmente
O estado dos botes se altera (pressionado ou no) conforme os
objetos tenham sido refletidos verticalmente ou horizontalmente, mas
somente se o estado de reflexo igual para todos os objetos
selecionados
Os botes ficam desabilitados se a Tela estiver selecionada ou se no h
nenhum objeto selecionado
Os objetos de Tela podem ser ajustados ao pixel mais prximo (efeito
Snap to Pixel), utilizando-se a combinao de teclas CTRL + BARRA DE
ESPAO.

340 Telas e Objetos de Tela


7.3.3 Animao
Recurso que aplica movimento a um objeto em tempo de execuo, e que
est disponvel na barra de ferramentas Tela. Os tipos de movimentos
disponveis so os seguintes:

Animao com Translao : O objeto que recebe este recurso faz


movimentos lineares de acordo com as configuraes das propriedades no
objeto. Para habilitar esta opo, siga estes procedimentos:

1. Selecione o objeto na Tela e clique em Animar com Translao .

2. Com o cursor do mouse, habilite as configuraes da orientao do


objeto.

Animao com Translao

Animao com Rotao : O objeto que recebe este recurso faz


movimentos circulares de acordo com o centro de rotao do objeto e seu
ngulo. Para habilitar esta opo, siga estes procedimentos:

1. Selecione o objeto na Tela e clique em Animar com Rotao .

2. Quando o objeto criado, seu centro de rotao padro definido como


o centro do objeto, com uma inclinao de 0 (zero) graus de posio da
horizontal em relao a este centro. Neste momento, os vrtices do
objeto selecionado so indicados por pequenos crculos e seu centro por
dois crculos circunscritos.

3. Ao passar o mouse sobre o centro ou vrtices, possvel modificar o


centro arrastando ou rotacionando o objeto de um de seus vrtices em
relao ao centro.

Telas e Objetos de Tela 341


Animao com Rotao

NOTA
Para objetos de Tela do tipo Figura que utilizem o formato de arquivo
Bitmap (arquivos com extenso .bmp), o recurso de animao no est
disponvel.

7.3.4 Aplicar Estilo


Aplica o estilo configurado como padro na opo Configurar como Padro
a objetos previamente criados. Para utilizar este recurso, siga estes
procedimentos:

1. Selecione o objeto ao qual o padro deve ser aplicado.

2. Clique com o boto direito do mouse e selecione a opo Aplicar Estilo.

342 Telas e Objetos de Tela


7.3.5 Camadas
O E3 oferece uma arquitetura de Telas com at 32 camadas para insero de
objetos. Cada objeto pode pertencer a uma ou mais camadas, e a Tela ativa
tanto em tempo de configurao (no E3 Studio) quanto em tempo de
execuo (no E3 Viewer) pode estar com nenhuma, uma, vrias ou todas as
camadas ativas. Isto permite criar sistemas com vrias formas de
monitoramento, como por exemplo a visualizao de um processo apenas
com o sistema eltrico, apenas o hidrulico ou ambos. possvel tambm
controlar o aparecimento de camadas de acordo com um determinado nvel
de zoom. A configurao das camadas feita clicando-se em Camadas na
barra de ferramentas Tela. As opes disponveis esto descritas na tabela a
seguir.

Opes disponveis para a configurao de Camadas

OPO DESCRIO
Camada Habilita a visualizao da camada
configurada na propriedade Layer
da Tela

Todas as camadas Mostra todas as camadas


disponveis no projeto

Nenhuma camada Nenhuma camada mostrada

Editar camadas Atravs desta opo, pode-se


configurar camadas individuais. Esta
opo abre uma caixa de dilogo
para configurao da camada

Telas e Objetos de Tela 343


Quando a opo Editar camadas selecionada, a janela da figura a seguir
mostrada.

Edio de Camadas

A janela Edio de Camadas tem as seguintes opes: Adicionar Camada ,


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

344 Telas e Objetos de Tela


Adio ou edio de camadas

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

Opes disponveis na Camada

OPO DESCRIO
Nome da Camada Determina o nome da camada

Zoom Baixo Define a porcentagem inicial de


zoom na camada

Zoom Alto Define a porcentagem final de zoom


na camada

Usar condio adicional de Habilita a utilizao de uma


visibilidade condio adicional de visibilidade
de zoom na camada. Esta condio
pode ser uma varivel ou
propriedade qualquer

Telas e Objetos de Tela 345


OPO DESCRIO
Fonte Estabelece uma Associao ou uma
propriedade que, uma vez ativa
(diferente de zero), tambm exibe a
camada (as opes de Zoom e
Fonte no so exclusivas, isto ,
podem ativar a camada estando
uma ou outra condio ativa)

Para maiores informaes, consulte o Manual de Referncia e Scripts do E3.

7.3.6 Configurar como Padro


Configura as opes editadas nas barras de ferramentas Sombra e Desenho
como padro para os demais objetos de Tela que forem criados. Para utilizar
este recurso, siga estes procedimentos:

1. Selecione o objeto que vai servir como modelo para os demais.

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


como Padro.

3. Ao criar um novo objeto de Tela, as configuraes de Sombra e Desenho


deste objeto so utilizadas como configuraes iniciais dos prximos
objetos.

346 Telas e Objetos de Tela


7.3.7 Desenho
Permite aplicar ou editar informaes relativas s cores de fundo e frente da
Tela e objetos de Tela e borda dos objetos de Tela.

Opes de desenho

Para utilizar este recurso, siga estes procedimentos:

1. Insira ou selecione o objeto (Tela ou objeto de Tela) cujas cores ou


bordas deseja editar.

2. Altere suas propriedades de acordo com as opes disponveis na barra


de ferramentas Desenho.

As opes disponveis nesta barra de ferramentas esto descritas na tabela a


seguir.

Opes disponveis na barra de ferramentas Desenho

CONE OPO DESCRIO


Cor do Fundo Permite selecionar a
cor de fundo da Tela
ou do objeto de Tela a
partir de uma lista de
cores pr-
estabelecidas, ou criar
uma nova cor
personalizada

Telas e Objetos de Tela 347


CONE OPO DESCRIO
Cor da Frente Permite selecionar a
cor de frente da Tela
ou do objeto de Tela a
partir de uma lista de
cores pr-
estabelecidas, ou criar
uma nova cor
personalizada

Cor da Borda Permite selecionar a


cor da borda do
objeto de Tela a partir
de uma lista de cores
pr-estabelecidas, ou
criar uma nova cor
personalizada

Estilo da Borda Permite escolher o tipo


de borda exibida pelo
objeto de Tela a partir
de uma lista com
estilos pr-
estabelecidos: uma
linha contnua,
diferentes tipos de
pontilhados e
tracejados, ou
simplesmente nenhuma
borda

Espessura da Linha Permite escolher a


espessura da linha da
borda do objeto de
Tela a partir de uma
lista com espessuras
pr-estabelecidas entre
0 e 2,5 milmetros

348 Telas e Objetos de Tela


CONE OPO DESCRIO
Estilo do Permite escolher o tipo
Preenchimento de preenchimento
exibido pela Tela ou
pelo objeto de Tela,
isto , como se d a
combinao entre as
cores de fundo e de
frente do objeto. Ao
selecionar esta opo,
a janela mostrada na
figura a seguir aberta

Efeitos de preenchimento

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

Opes disponveis na janela Preenchimento

Telas e Objetos de Tela 349


OPO DESCRIO
Estilos Mostra todos os estilos de
preenchimento disponveis para o
objeto selecionado

Cor da frente Mostra a cor da frente previamente


selecionada para o objeto. Permite
tambm a seleo de uma nova cor de
frente (o mesmo que clicar em )

Cor do fundo Mostra a cor de fundo previamente


selecionada para o objeto. Permite
tambm a seleo de uma nova cor de
fundo (o mesmo que clicar em )

Amostra Mostra como o efeito escolhido


aplicado com as cores de fundo e de
frente do objeto

Opaco ou Transparente Ao selecionar a opo Transparente,


os preenchimentos com efeito
hachurado no mostram a cor de
fundo do objeto selecionado, somente
a cor de frente, criando um efeito de
transparncia no objeto. Ao selecionar
a opo Opaco, este efeito no
acontece. NOTA: A opo
Transparente est desabilitada para a
Tela

350 Telas e Objetos de Tela


7.3.8 Grade
Conjunto de linhas horizontais e verticais que servem como referncia de
posicionamento para objetos na Tela. Ela visualizada somente no E3 Studio,
e no em tempo de execuo.

No E3 Studio, possvel mostrar ou esconder a grade atravs do menu


Arranjar - Grade, ou clicando em na barra de ferramentas Alinhamento.

As propriedades da Grade podem ser configuradas atravs do menu Arranjar


- Edio da Grade. Ao selecionar esta opo, a janela da figura a seguir
mostrada.

Janela Propriedades da Grade

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

Opes disponveis na janela Propriedades da Grade

OPO DESCRIO
Pontilhada A grade mostra pontos apenas nas
interseces de linhas

Telas e Objetos de Tela 351


OPO DESCRIO
Linhas pontilhadas A grade mostra a linha inteira
pontilhada

Alinhar mouse automaticamente Alinha o mouse grade


automaticamente

Comprimento Determina a distncia entre as linhas


horizontais

Largura Determina a distncia entre as linhas


verticais

Cor Determina a cor da grade

352 Telas e Objetos de Tela


7.3.9 Mover
Permite mover o contedo de uma Tela que contenha barras de rolagem no
Studio ou no Viewer, em tempo de execuo. Para utilizar este recurso no
Studio, siga estes procedimentos:

1. Selecione a opo Mover na barra de ferramentas Tela.

2. Clique na Tela desejada para arrast-la. O ponteiro do mouse muda para


o cone .

Para utilizar este recurso no Viewer, siga este procedimento:

1. Clique com o boto direito do mouse no Viewer e selecione a opo


Mover do menu contextual.

NOTAS
Tanto no Studio quanto no Viewer, a opo Mover est sempre disponvel
ao utilizar o boto do meio do mouse.
No Viewer, ou seja, em tempo de execuo, clicar em objetos de Tela
como Botes, Displays e SetPoints, entre outros, impede o uso da opo
Mover, visto que os objetos de Tela capturam o comportamento do
cursor do mouse. Nestes casos, deve-se utilizar as opes disponveis
para a opo Mover (boto do meio do mouse ou menu contextual)
somente nas reas de Tela.

Telas e Objetos de Tela 353


7.3.10 Ordem de Navegao entre os Objetos
Estabelece a ordem de navegao, atravs da tecla TAB, entre dois ou mais
objetos em tempo de execuo (isto , a ordem em que os objetos ganham
foco). Para habilitar esta opo, siga estes procedimentos:

1. Selecione a Tela e clique em Ordem dos Tabs , na barra de


ferramentas Tela.

2. Clique nos objetos conforme a ordenao desejada. O nmero com a


ordem de navegao aparece no canto superior esquerdo do objeto.

3. Quando o Domnio for executado, a navegao entre estes objetos feita


conforme a ordem especificada.

Ordem dos Tabs

Para manter a ordem inicial dos objetos, necessrio seguir estes


procedimentos:

1. Aps ter criado o objeto na Tela, clique em Ordem dos Tabs .

2. Com a tecla CTRL pressionada, clique no penltimo objeto.

3. Solte a tecla CTRL e clique no ltimo objeto (objeto criado anteriormente).

354 Telas e Objetos de Tela


NOTA
A ordem de tabulao equivalente ordem de sobreposio dos objetos,
descrita no tpico Sobreposio de Objetos.

7.3.11 Ponto ncora


Um Ponto ncora definido como as coordenadas que marcam o ponto
inicial do objeto. Inicialmente, o ponto ncora est atrelado s coordenadas
iniciais do objeto.

Para habilitar esta opo, clique com o boto direito do mouse no objeto e
selecione a opo Definir Ponto ncora. O objeto aparece com o smbolo ,
de onde pode ser movido para qualquer lugar da Tela. Ao arrastar o objeto
com a nova ncora, o ponto que foi definido o que fica fixado nos pontos
da grade, sendo que o objeto fica deslocado nas mesmas propores em
relao ncora. Isto s visualizado se a opo Alinhar Mouse
Automaticamente (propriedade da Grade) estiver habilitada.

Objeto com ponto ncora

NOTA
Ao utilizar a combinao de teclas CTRL + BARRA DE ESPAO (efeito Snap to
Pixel) em um objeto com a opo Definir Ponto ncora habilitada, o objeto
movido para o pixel mais prximo, sem respeitar a posio do ponto
ncora. Caso seja utilizado o mouse para mover o objeto, o ponto ncora
posicionado exatamente em cima de um pixel. Para corrigir eventuais
discrepncias no posicionamento do objeto, pode-se utilizar a combinao
CTRL + BARRA DE ESPAO aps soltar o boto do mouse.

Telas e Objetos de Tela 355


7.3.12 Rotacionar
Permite rotacionar um objeto de Tela tendo como origem seu centro ou
qualquer outro ponto na Tela. Para utilizar este recurso, siga estes
procedimentos:

1. Selecione um objeto na Tela e clique em Rotacionar na barra de


ferramentas Tela.

2. Clique em um de seus vrtices de rotao (em verde) e arraste o objeto


at a posio desejada.

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


um crculo verde).

NOTA
Para objetos de Tela do tipo Figura que utilizem o formato de arquivo
Bitmap (arquivos com extenso .bmp), o recurso de rotao no est
disponvel.
No caso de alterao no centro de rotao de um objeto de Tela, o menu
contextual do objeto passa a exibir a opo Redefinir Centro de Rotao,
que permite desfazer a alterao e retornar o centro de rotao do objeto
ao seu padro.

7.3.13 Sobreposio de Objetos


Permite editar o modo como dois ou mais objetos esto sobrepostos. As
opes disponveis na barra de ferramentos Tela esto descritas na tabela a
seguir.

Opes disponveis na barra de ferramentas Tela

CONE OPO DESCRIO


Trazer para a Frente O objeto selecionado
enviado para a primeira
posio na ordem de
sobreposio (ALT +
HOME)

356 Telas e Objetos de Tela


CONE OPO DESCRIO
Enviar para Trs O objeto selecionado
enviado para a ltima
posio na ordem de
sobreposio (ALT +
END)

Avanar O objeto selecionado


avana uma posio na
ordem de sobreposio
dos objetos (ALT +
PAGE UP)

Recuar O objeto selecionado


recua uma posio na
ordem de sobreposio
dos objetos (ALT +
PAGE DOWN)

7.3.14 Sombreamento
Permite aplicar ou editar o efeito de sombra em um objeto de Tela.

Opes da sombra

Para utilizar este recurso, siga estes procedimentos:

1. Insira ou selecione o objeto ao qual deseja aplicar a sombra.

2. Altere suas propriedades atravs da barra de ferramentas Sombra, de


acordo com as opes mostradas na tabela a seguir.

Opes disponveis na barra de ferramentas Sombra

OPO DESCRIO
Habilita ou desabilita o efeito de
sombra no objeto

Telas e Objetos de Tela 357


OPO DESCRIO

Desloca a sombra abaixo do objeto

Desloca a sombra acima do objeto

Desloca a sombra esquerda do


objeto

Desloca a sombra direita do


objeto

Configura a cor da sombra do


objeto

7.3.15 Travar
Ao selecionar esta opo, o E3 Studio no permite que o objeto seja movido,
evitando movimentos indesejados. Depois de travado, o mouse exibe um
cursor com um cadeado ao ser deslocado sobre a rea do objeto.

Para habilitar esta opo, clique com o boto direito do mouse no objeto
desejado e selecione a opo Travar .

Objeto travado

Para desabilitar esta opo, clique novamente com o boto direito do mouse
no objeto e selecione a opo Destravar .

358 Telas e Objetos de Tela


7.3.16 Zoom
Na edio da Tela, pode-se escolher livremente o nvel de zoom desejado e
mais confortvel para a edio. O zoom est disponvel atravs do menu
contextual Zoom, e possui nveis que vo de 10% a 800%, alm das opes
Toda Largura, Toda Altura, Toda Pgina e Preencher, conforme a figura a
seguir.

Menu Zoom

Alm do menu Zoom, possvel modificar o nvel de zoom atravs do teclado


e mouse, utilizando as seguintes combinaes:

CTRL + SINAL DE MAIS (+): Aumenta o zoom

CTRL + SINAL DE MENOS (-): Diminui o zoom

Telas e Objetos de Tela 359


CTRL + ASTERISCO (*) ou CTRL + 0 (ZERO): Volta para o zoom padro
(100%)

CTRL + Roda do mouse para cima: Aumenta o zoom

CTRL + Roda do mouse para baixo: Diminui o zoom

NOTA
Ao utilizar as opes de CTRL + Roda do mouse (para cima ou para baixo),
o foco do zoom sempre relativo posio do ponteiro do mouse.

360 Telas e Objetos de Tela


7.4 Formatao de Cores
Em propriedades do tipo Cor, a alterao de valor pode ser realizada por
meio de caixas de dilogo, como mostrado a seguir, disponveis na lista de
Propriedades ao clicar em na janela de Propriedades. Existem dois modos
para se selecionar a cor desejada: atravs da aba Padro, onde possvel
selecion-la dentre cores pr-definidas, ou atravs da aba Personalizado,
onde pode-se informar a cor atravs de seus componentes.

Cores

A opo Outra permite que o usurio selecione uma cor de qualquer parte da
tela, dentro ou fora do E3 Studio. Clique em e aps na cor desejada para
que ela seja capturada para a janela de cores.

Para personalizar uma cor, pode-se combinar duas metodologias: RGB


(componentes de vermelho, verde e azul) ou HSL (componentes de matiz,
saturao e luminosidade).

Telas e Objetos de Tela 361


Cor personalizada

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

Red (vermelho): Indica a quantidade do componente primrio vermelho


na composio da cor

Green (verde): Indica a quantidade do componente primrio verde na


composio da cor

Blue (azul): Indica a quantidade do componente primrio azul na


composio da cor

Cada um destes elementos de cor podem ter um grau de intensidade que


varia entre 0 (zero) e 255.

A escala HSL descreve uma cor atravs da mistura de trs componentes


bsicos, a saber:

Hue (matiz): Especifica a gradao da cor dentro do espectro de luz


visvel

362 Telas e Objetos de Tela


Saturation (saturao): Indica a intensidade de um determinado matiz.
Um matiz com alta saturao tem uma cor mais intensa, enquanto um
matiz com baixa saturao produz uma cor mais acinzentada

Lightness (luminosidade): Indica a quantidade de luz aplicada cor.


Quanto maior a luminosidade, mais clara a cor. Do mesmo modo, quanto
menor a luminosidade, mais escura a cor

Estes elementos tambm podem ter seu grau de intensidade configurado


entre 0 (zero) e 255. Assim, basta especificar o valor para cada um dos itens,
conforme a tonalidade da cor desejada, ou selecionar a cor desejada
diretamente com o ponteiro do mouse sobre as escalas da janela.

O valor numrico de cada cor obtido atravs da seguinte frmula:


Red * 256 ^ 0 + Green * 256 ^ 1 + Blue * 256 ^ 2

Ou seja:
Red * 1 + Green * 256 + Blue * 65536

Sendo que as variveis Red, Green e Blue podem assumir valores entre 0
(zero) e 255. Por exemplo:

Preto (0, 0, 0): 0 * 1 + 0 * 256 + 0 * 65536 = 0

Branco (255, 255, 255): 255 * 1 + 255 * 256 + 255 * 65536 = 16777215

Vermelho (255, 0, 0): 255 * 1 + 0 * 256 + 0 * 65536 = 255

Verde (0, 255, 0): 0 * 1 + 255 * 256 + 0 * 65536 = 65280

Azul (0, 0, 255): 0 * 1 + 0 * 256 + 255 * 65536 = 16711680

NOTA
Os valores armazenados nas propriedades dos objetos que se referem a
cores so os valores numricos, calculados atravs da frmula descrita
anteriormente. A ferramenta Procurar e Substituir utiliza este valor
armazenado no processo de pesquisa, e no os valores formatados como
RGB mostrados na Lista de Propriedades.

Telas e Objetos de Tela 363


7.5 Formatao de Valores
O uso de formatadores permite mudar a forma como os dados so
apresentados sem precisar mudar o valor que existe por trs deles. O
formato um texto que pode ser editado manualmente ou configurado
atravs da janela de formatao. Seu uso semelhante aos formatadores
usados nas planilhas eletrnicas, seguindo a mesma sintaxe bsica, mas com
algumas extenses. So suportados os seguintes tipos de dados:

Numrico (sada decimal, cientfica, hexadecimal, binria e octal)

Texto

Booleano

Data e Hora (calendrio Gregoriano)

Os objetos que suportam formatao devem ter o tipo de dados na


propriedade Value alterado de acordo com o tipo de formatao desejada.

Janela de Formatao de Valores

364 Telas e Objetos de Tela


As seguintes formataes esto disponveis:

Geral: No h formatao especfica. realizada automaticamente,


dependendo do tipo de dados

Nmero: Apresenta nmeros com parte inteira e fracionria, permitindo


definir o nmero de casas decimais e uso de separador de milhares. Para
nmeros muito grandes ou muito pequenos, utilize o formato Cientfico.
Os smbolos de casa decimal e separador de milhares so aqueles
definidos no Painel de Controle - Configuraes Regionais

Data/Hora: Apresentam valores numricos (formato Gregoriano) como


datas e horas, quando vlidos

Porcentagem: Multiplica o nmero por 100 e adiciona o smbolo de


percentual, definindo tambm o nmero de casas decimais

Cientfico: Este formato apresenta o nmero em notao de mantissa e


expoente. Ideal para nmeros de magnitude variada, permitindo
selecionar tambm o nmero de casas decimais e formatos

Especial: Permite formatar nmeros inteiros em bases no decimais


(hexadecimal, octal ou binria)

Telas e Objetos de Tela 365


7.5.1 Outros Formatos
Na opo Outro, pode-se criar um formato de dados qualquer, mesmo um
dos j citados, a partir da digitao de um cdigo (texto) de formato.

O texto do formatador composto de at quatro campos separados por um


ponto e vrgula. O primeiro campo sempre aplicado quando no existir um
outro campo mais apropriado para o valor ou tipo de dados. O segundo
campo utilizado para valores numricos negativos. O terceiro campo
utilizado quando o valor numrico for 0 (zero). Finalmente, o quarto campo
utilizado quando o dado for do tipo Texto.

Sempre que mais de um campo for definido, o campo anterior considerado,


mesmo que esteja vazio. No caso de um formatador de campo vazio, o valor
formatado sempre um texto vazio. Note que isto difere do formato Geral,
que apenas um formato vazio, sem o uso dos separadores de campo
(ponto e vrgula).

Para inserir caracteres que so mostrados pelo formatador, pode-se coloc-


los entre aspas duplas ou aps uma barra invertida. A tabela a seguir contm
exemplos de entradas de texto (vlidos para todos os tipos de formatadores).

Entrada de Texto

FORMATADOR SADA FORMATADA


"0#?" 0#?

\m\d\y mdy

Tambm possvel criar formatadores que contenham apenas texto, que


podem ser combinados com o uso de diferentes campos, como no exemplo a
seguir.

Formatador e Sada Formatada

VALOR FORMATADOR SADA FORMATADA


1 "Positivo";"Negativo";"Ze Positivo
ro","Texto"

366 Telas e Objetos de Tela


VALOR FORMATADOR SADA FORMATADA
-1 "Positivo";"Negativo";"Ze Negativo
ro","Texto"

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

"Abcd" "Positivo";"Negativo";"Ze Texto


ro","Texto"

Alm disto, os seguintes caracteres podem ser mostrados diretamente sem o


uso de aspas ou barra: $ - + / () : ! ^ & ' (aspas simples esquerda) ' (aspas
simples direita) ~ { } = < >

NOTA
Para mostrar a barra invertida ou aspas duplas no dado formatado, use \"
ou \\. Quando entre aspas, todo o texto copiado diretamente; logo, "\a"
mostrado simplesmente como \a.

Os formatadores numricos aceitam trs tipos bsicos de caracteres para


definir o nmero de dgitos apresentados, conforme a tabela a seguir.

Formatadores Numricos

OPO DESCRIO
0 (zero) Coloca o dgito significativo ou 0
(zero), quando no houver

# Coloca o dgito significativo

? Coloca o dgito significativo ou um


espao, quando no houver

Telas e Objetos de Tela 367


O ponto decimal define que se deseja apresentar tambm a parte fracionria
de um nmero. A vrgula tem como funo indicar que o valor deve ser
dividido por mil (para cada vrgula), aps os dgitos do formatador.

Independente da configurao local do Windows, o ponto e a vrgula sempre


devem ser utilizados no texto do formatador para indicar o separador de
milhar e de decimal, mas a sada formatada de acordo com a configurao
regional do sistema. A tabela a seguir descreve as opes disponveis.

Opes disponveis

DADO FORMATADOR SADA FORMATADA


12000 #, 12

1234567 #,#.0 1,234,567.0

7.5.1.1 Formato Cientfico

Um nmero pode ser apresentado em notao cientfica (mantissa e


expoente) quando aps algum dgito existir E+, E-, e- ou e+, seguido de
dgitos para formatar o expoente. Quando for usado E+ ou e+ o expoente
sempre mostrado com sinal, e quando for usado E- ou e-, o sinal aparece
apenas para expoente negativos. O expoente sempre mostra um dgito,
mesmo que este seja 0 (zero). O nmero de dgitos direita do ponto
decimal afeta o expoente mostrado. A tabela a seguir contm exemplos de
valores formatados usando o formato cientfico.

Formatador Cientfico

DADO FORMATADOR SADA FORMATADA


1000 #E+00 1E+03

1000 ##e-00 10e02

368 Telas e Objetos de Tela


7.5.1.2 Formato de Base No Decimal

Os formatadores para bases no decimais sempre apresentam apenas a


parte inteira do valor numrico formatado, e tambm no so sensveis ao
sinal. Da mesma forma que na base decimal, caso o nmero possua mais
dgitos do que o requisitado no formatador, estes dgitos so apresentados
de qualquer forma.

Atualmente, estes formatadores esto limitados a nmeros de 32 bits. Caso a


parte inteira do valor exceda este limite, a formatao retorna erro. A tabela a
seguir contm exemplos de valores formatados usando um formato de base
no decimal.

Formatadores para bases no decimais

DADO FORMATADOR SADA FORMATADA


255 "0x"XXX 0x0FF

12345 oooo\o 30071o

987 B 1111011011

12 BBBB - BBBB 0000 - 1100

Telas e Objetos de Tela 369


7.5.1.3 Formato de Data e Hora

A sintaxe da formatao de datas e horas difere um pouco do sistema usado


pelas planilhas, seguindo o modo usado pela configurao regional do
Windows. As datas so valores numricos onde a parte inteira uma
contagem de dias desde 31 de dezembro de 1899 e a parte fracionria
representa a hora em fraes de dia.

O ano mnimo suportado 100 e o ano mximo 9999, garantindo uma


resoluo de pelo menos 1 ms em todo o intervalo. Os nomes de meses e
dias da semana, a ordem padro de dia, ms e ano e o separador de datas e
horas so todos utilizados de acordo com a configurao regional do
Windows. A tabela a seguir contm exemplos de valores formatados usando
o formato de data e hora.

Formatadores para Datas e Horas

DADO FORMATADOR SADA FORMATADA


1234.56789 dd/MMMM/yyyy 18/maio/1903

0.56789 hh:mm:ss.000 tt 01:37:45.696 PM

12.345678 hh\hmm\mss.000\s 296h17m46.667s

NOTA
Os valores armazenados nas propriedades dos objetos que se referem a
datas so os valores numricos, calculados atravs da frmula anterior. A
ferramenta Procurar e Substituir utiliza este valor armazenado no processo
de pesquisa, e no os valores formatados como data e hora mostrados na
Lista de Propriedades.

370 Telas e Objetos de Tela


7.5.1.4 Formato Texto

O caractere @ copia o valor do dado na posio onde aparecer. Este


formatador deve aparecer no quarto campo (por exemplo, ;;;@) ou
diretamente quando h apenas um campo. A tabela a seguir contm
exemplos de valores formatados usando o formato texto.

Formatador para Texto

DADO FORMATADOR SADA FORMATADA


Abc @@ Abc Abc

xyZ "Nome: " \ " @ \ " Nome: "xyZ"

Telas e Objetos de Tela 371


CAPTULO
Associaes
8
Associaes (ou conexes) so ligaes feitas entre propriedades e objetos
ou outras propriedades. As Associaes trazem grande facilidade ao criar
animaes e outros tipos de lgicas comuns, minimizando a utilizao de
scripts.

Pode-se acessar a aba Associaes clicando-se com o boto direito do


mouse no objeto e selecionando a opo Propriedades. Nesta aba, so
mostradas as propriedades do objeto que podem ser associadas, bem como
os tipos de Associaes existentes e suas fontes.

Aba Associaes

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

Opes disponveis na aba Associaes

372 Associaes
OPO DESCRIO
Propriedades Lista as propriedades do objeto que
podem ser associadas

Conexo Indica o tipo de Associao que a


propriedade possui. Para
propriedades comuns, as Associaes
disponveis so as seguintes: Simples,
Bidirecional, Analgica, Digital, Por
Tabela, Reversa e Mltipla. Existe
ainda a ligao entre propriedades de
ElipseX e objetos, que ainda no
pode ter seu tipo modificado (para
maiores detalhes, consulte o captulo
Bibliotecas)

Fonte No caso mais simples, especifica o


caminho para um objeto ou
propriedade. Este caminho pode ser
preenchido pelo AppBrowser,
clicando-se em , que fica direita
do campo. No caso geral, uma
expresso que permite aplicar
operaes lgicas, aritmticas e
avaliaes de funes propriedades,
objetos e constantes

Associaes 373
Ao especificar a fonte da Associao, o seu texto aparece em azul, caso esta
corresponda a uma expresso vlida. Se a expresso contiver erros, como no
caso de caminhos de objetos que no existam (ou pertenam a projetos que
no estejam carregados), o texto aparece em vermelho. Nestes casos, a
opo de Verificar Domnio informa os locais que necessitam de correo
ou reviso. Os tipos de Associaes disponveis so explicados nos tpicos a
seguir.

O campo Fonte pode conter uma referncia a um objeto de contexto


existente na hierarquia superior do objeto onde se est criando a Associao.
O formato de uma referncia deste tipo @(Contexto)[.Caminho], onde
Contexto o nome do contexto (os valores possveis podem ser vistos na
descrio do mtodo Context, no Manual de Referncia e Scripts do E3) e
Caminho pode ser o caminho de um objeto existente na hierarquia inferior do
objeto de contexto, ou uma propriedade deste mesmo objeto. Os nomes dos
contextos no so sensveis a maisculas e minsculas.

374 Associaes
8.1 Simples
Na Associao Simples, o valor do campo Fonte copiado para a
propriedade toda vez que o primeiro modificado.

Associao Simples

Para utilizar este recurso, siga estes procedimentos:

1. Selecione o objeto para a Associao.

2. Clique com o boto direito do mouse no objeto e selecione a opo


Propriedades.

3. Clique na aba Associaes e selecione a propriedade para criar a


Associao. O Studio indica vrios tipos de Associaes.

4. No campo Fonte, selecione a Associao e clique em para indicar a


propriedade a referenciar, ou escreva a expresso neste campo.

Associaes 375
8.2 Bidirecional
A Associao Bidirecional semelhante Associao Simples. Porm, caso
haja uma variao na propriedade, seu valor copiado para a fonte, gerando
assim uma Associao de duas direes.

Associao Bidirecional

Para utilizar este recurso, siga estes procedimentos:

1. Selecione o objeto para a Associao.

2. Clique com o boto direito do mouse no objeto e selecione a opo


Propriedades.

3. Clique na aba Associaes e selecione a propriedade para criar a


Associao. O Studio indica vrios tipos de Associaes.

4. No campo Fonte, selecione a Associao e clique em para indicar a


propriedade a referenciar, ou escreva a expresso neste campo.

376 Associaes
8.3 Digital
J na Associao Digital podemos estabelecer que, caso a varivel ou
expresso do campo Fonte represente um valor digital (Booleano), seus
estados Verdadeiro e Falso so mapeados para certos valores no destino,
incluindo a opo Pisca (alternncia de valores).

Associao Digital

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

Opes disponveis para a Associao Digital

OPO DESCRIO
Ligado Especifica o valor assumido pela
propriedade quando a expresso da
fonte Verdadeira

Desligado Especifica o valor assumido pela


propriedade quando a expresso da
fonte resultar em Falso

Associaes 377
OPO DESCRIO
Pisca Quando este campo estiver
habilitado, a propriedade conectada
alterna entre os valores do campo
Para valor, caso a fonte retorne
Verdadeiro. Caso contrrio, a
propriedade retornada alterna entre
os valores dos campos Valor e Para
valor caso a fonte retorne Falso

Para valor <Campo Ligado> Especifica o valor alternativo a ser


assumido periodicamente pela
propriedade quando a expresso ou
Associao da fonte resultar em
Verdadeiro e o campo Pisca estiver
habilitado

Para valor <Campo Desligado> Especifica o valor alternativo a ser


assumido periodicamente pela
propriedade quando a expresso da
fonte resultar em Falso e o campo
Pisca estiver desabilitado

Para utilizar este recurso, siga estes procedimentos:

1. Selecione o objeto para a Associao.

2. Clique com o boto direito do mouse no objeto e selecione a opo


Propriedades.

3. Clique na aba Associaes e selecione a propriedade para criar a


Associao. O Studio indica vrios tipos de Associaes.

4. No campo Fonte, selecione a Associao e clique em para indicar a


propriedade a referenciar, ou escreva a expresso neste campo.

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

Associao Analgica

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

Opes disponveis para a Associao Analgica

OPO DESCRIO
Valor na Fonte Determina os valores mnimo e
mximo atingidos na fonte

Valor na Propriedade Determina os valores mnimo e


mximo atingidos na propriedade

Associaes 379
Para utilizar este recurso, siga estes procedimentos:

1. Selecione o objeto para a Associao.

2. Clique com o boto direito do mouse no objeto, selecione o item


Propriedades e clique na aba Associaes. Selecione a propriedade para
criar a Associao. O Studio indica vrios tipos de Associaes.

3. No campo Fonte, selecione a Associao e clique em para indicar a


propriedade a referenciar, ou escreva a expresso neste campo.

380 Associaes
8.5 Por Tabela
Na Associao por Tabela, possvel especificar um conjunto de intervalos
em funo de valores mximo e mnimo da fonte e, para cada um destes
intervalos, o valor a ser assumido pela propriedade. Alm disto, assim como
na Associao Digital, possvel especificar a opo de Pisca e o valor
alternativo. Para utilizar este recurso, siga estes procedimentos:

1. Abra a janela de propriedades do objeto e selecione a aba Associaes.

2. Selecione a propriedade para criar a Associao e clique no item


Conexo por Tabela.

Associao por Tabela

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

Opes disponveis para a Associao por Tabela

OPO DESCRIO
Inserir Insere uma nova linha na tabela

Remover Remove a linha selecionada da


tabela

Mn Especifica o valor mnimo da fonte


para uma linha da tabela

Associaes 381
OPO DESCRIO
Mx Especifica o valor mximo da fonte
para uma linha da tabela

Valor Especifica o valor da propriedade a


ser assumido quando a fonte estiver
no intervalo especificado na linha

Pisca Determina que quando a fonte


estiver no intervalo desta linha, a
propriedade alterna periodicamente
entre os valores especificados nas
opes Valor e Valor (com o Pisca
habilitado)

Valor <Pisca Habilitado> Especifica o valor alternativo da


propriedade a ser assumido quando
a fonte estiver no intervalo
especificado na linha, isto , quando
a opo Pisca estiver habilitada

Para utilizar este recurso, siga estes procedimentos:

1. Na aba Associaes, selecione a propriedade e associe a opo Conexo


por tabela.

2. Crie as linhas na tabela e configure as colunas Mn, Mx e Valor.

3. Caso seja necessrio alternar periodicamente entre os valores, habilite a


coluna Pisca e configure as opes restantes.

382 Associaes
8.6 Reversa
Na Associao Reversa, toda vez que o valor da propriedade modificado,
este copiado para a fonte, funcionando assim de maneira inversa
Associao Simples. Para utilizar este recurso, siga estes procedimentos:

1. Abra a janela de propriedades do objeto e selecione a opo


Associaes.

2. Selecione a propriedade para criar a Associao e clique no item


Conexo Reversa.

3. No campo Fonte, selecione a Associao e clique em para indicar a


propriedade a referenciar, ou escreva a expresso neste campo.

Associao Reversa

Associaes 383
8.7 Mltipla
Na Associao Mltipla, cada linha da Associao permite buscar o valor de
uma fonte diferente. A fonte ativa selecionada de acordo com o valor fonte
principal da Associao.

Cada linha possui o intervalo (propriedades Min e Max) e a fonte para aquele
intervalo (propriedade Source, que uma Associao normal). Para utilizar
este recurso, siga estes procedimentos:

1. Abra a janela de propriedades do objeto e selecione a aba Associaes.

2. Selecione a propriedade para criar a Associao e clique no item


Conexo Mltipla.

3. Defina a fonte principal da Associao na coluna Fonte.

Associao Mltipla

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

Opes disponveis para a Associao Mltipla

OPO DESCRIO
Inserir Insere uma nova linha na tabela

384 Associaes
OPO DESCRIO
Remover Remove a linha selecionada da
tabela

Mn Especifica o valor mnimo da fonte


para uma linha da tabela

Mx Especifica o valor mximo da fonte


para uma linha da tabela

Fonte Especifica a fonte que associada


com a propriedade quando o valor
da fonte principal estiver entre os
limites Mn e Mx

Manter todas associaes ativas Mantm todas as Associaes da


tabela em modo Advise (ativas).
Esta propriedade corresponde
propriedade AdviseAll

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

Para acessar esta ferramenta, clique com o boto direito do mouse em um ou


mais objetos e selecione a opo Editar Associaes.

Opo Editar Associaes

A caixa de dilogo da figura a seguir mostrada.

386 Associaes
Edio de Associaes

A caixa de dilogo anterior mostra uma lista das Associaes, propriedades


do tipo Link e eventos do usurio relacionados aos objetos selecionados e
seus filhos. De acordo com o tipo de linha, as informaes mostradas nas
colunas esto descritas na tabela a seguir.

Opes disponveis na janela Editar Associaes

OPO DESCRIO
Nome do Objeto Determina o nome do objeto

Propriedade / Evento Determina a propriedade do objeto


que possui a Associao

Conexo Determina o tipo de Associao


(Simples, Bidirecional, Digital,
Analgica, Por Tabela, Reversa ou
Mltipla)

Fonte Determina a fonte da Associao

Opes para Propriedades do tipo Link

OPO DESCRIO
Nome do Objeto Determina o nome do objeto que
possui a propriedade

Associaes 387
OPO DESCRIO
Propriedade / Evento Determina o nome da propriedade

Conexo sempre a mesma (Link)

Fonte Determina o valor da propriedade

Opes para Eventos do usurio

OPO DESCRIO
Nome do Objeto Determina o nome do objeto que
possui o evento

Propriedade / Evento Determina o nome do evento do


usurio

Conexo Determina o tipo do evento


(OnEvent, WhileEvent ou
OnValueChangeEvent)

Fonte Expresso relacionada ao evento

388 Associaes
Na caixa de dilogo Editar Associaes, permitido modificar as seguintes
opes:

Associaes: Podem ser modificadas, exceto o nome do objeto

Propriedades do tipo Link: Podem ser modificadas, exceto o nome do


objeto

Eventos do usurio: Podem ser modificados, exceto o nome do objeto e


o nome do evento

Clicar em Remover permite a remoo da Associao selecionada. A


opo Mostrar janela de propriedades das associaes determina se os
minidialogs das Associaes so mostrados quando a linha estiver
selecionada. Se esta janela estiver visvel, permitida a edio das
propriedades das Associaes. Seu valor padro habilitado.

NOTA
Na janela Editar Associaes, o usurio pode manter a Associao com a
fonte vazia. Para isto, selecione a coluna Fonte e pressione a tecla DELETE.

Edio das propriedades da Associao selecionada

Para editar as propriedades dos eventos do usurio, necessrio selecionar a


linha que contm o evento e, na coluna Conexo, clicar na opo Editar.

Associaes 389
Edio das propriedades dos eventos do usurio

Ao clicar na opo Editar, a caixa de dilogo a seguir mostrada, permitindo


assim que seja editado o evento do usurio selecionado.

Janela Editar Eventos

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

Opes disponveis na janela Editar Eventos

OPO DESCRIO
Propriedade ou expresso Propriedade ou expresso geradora
do evento

390 Associaes
OPO DESCRIO
Sempre que a propriedade for uma Indica que o evento do tipo
condio verdadeira etOnEvent ou etWhileEvent

Repetir o evento Indica o ciclo de repetio do evento


em milissegundos, isto , de quanto
em quanto tempo o evento ocorre
enquanto a expresso geradora for
verdadeira

Intervalo de repetio (ms) Valor para o intervalo de repetio,


em milissegundos

Sempre que a propriedade alterar o Indica que o evento do tipo


seu valor etOnValueChangeEvent, isto , o
evento ocorre sempre que a
expresso geradora mudar o valor

Tratar a desconexo como Se houver alguma desconexo, esta


mudana de valor tratada como uma mudana de
valor

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

Opo de copiar ou colar uma Associao

392 Associaes
CAPTULO
Bibliotecas
9
O E3 possui ferramentas que permitem transformar qualquer objeto ou
conjunto de objetos da aplicao em uma biblioteca do usurio. As
Bibliotecas podem ser formadas por objetos frequentemente utilizados, e
subsequentemente reaproveitados em outra aplicao.

O E3 fornece dois tipos de bibliotecas para o usurio: a Galeria, uma


biblioteca de smbolos grficos vetoriais, que podem ser livremente utilizados
nas aplicaes; e uma ferramenta de bibliotecas do usurio chamada de
ElipseX. O uso de bibliotecas no E3 altamente recomendvel na maioria dos
casos, devido ao ganho de produtividade que elas trazem s aplicaes.
Algumas das vantagens dos ElipseX so as seguintes:

Reutilizao de cdigos

Minimizao de testes durante o desenvolvimento

Criao de interfaces padro para os objetos desenvolvidos

Diminuio do tempo de desenvolvimento de novos projetos

Proteo do contedo do projeto

Hierarquizao de objetos

Bibliotecas 393
Bibliotecas no Organizer

394 Bibliotecas
9.1 Galeria
A Galeria pode ser acessada clicando-se em Galeria na barra de
ferramentas Padro. Neste item est disponvel uma srie de elementos
grficos vetoriais, divididos em categorias, que podem ser arrastados para as
Telas ou ento para os ElipseX. Esto disponveis os seguintes tipos de
smbolos: Botes 3-D, Smbolos 3-D ISA, Ar Condicionado, Arquitetura, Setas,
Controles e Equipamentos ASHRAE, Dutos ASHRAE, Canos ASHRAE, Formas
Bsicas, Ventiladores, Aquecedores, Prdios, Processos Qumicos,
Computadores, Teclas de Computadores, Contineres, Controladores,
Esteiras, Dutos, Eltrica, Acabamentos, Tubos Flexveis, Medidores de Vazo,
Alimentos, Aquecimento, HVAC, cones e Bitmaps, Miscelnea Industrial,
Smbolos Internacionais, Smbolos ISA, Laboratrio, Maquinaria, Mapas e
Bandeiras, Manuseio de Materiais, Minerao, Canos, Smbolos 1, Smbolos 2,
Misturadores, Motores, Natureza, Interface de Operao, Painis, Canos,
Acessrios Industriais, Energia, Resfriamento de Processos, Aquecimento de
Processos, Papel e Celulose, Bombas, Segurana, Balanas, Canos
Segmentados, Sensores, Cortes em Tanques, Tanques, Texturas, Vlvulas,
Veculos, gua e Resduos e Fios e Cabos.

Para utilizar este recurso, siga estes procedimentos:

1. Clique em Galeria na barra de ferramentas Padro.

2. Selecionando esta aba, tem-se acesso aos conjuntos de smbolos, que


esto agrupados em categorias. Selecione a categoria atravs da lista na
parte superior da janela.

3. Para inserir um objeto da biblioteca de smbolos em uma Tela, clique no


objeto desejado e arraste-o para a Tela.

4. Depois de inserido, o objeto pode ser livremente editado e trabalhado de


acordo com as caractersticas descritas para os objetos de imagem. Por
exemplo, pode-se mudar a cor de preenchimento diretamente atravs das
propriedades OverrideFillMode, OverrideFillColor e OverrideLineColor,
sem a necessidade de transformar o objeto em um objeto grfico do E3.

Bibliotecas 395
Galeria

396 Bibliotecas
9.2 Biblioteca do Usurio (ElipseX)
Os ElipseX so as bibliotecas de objetos do E3. Podem conter, alm de um
desenho, variveis internas passveis de serem exportadas para a aplicao,
alm de lgicas de programao (scripts) presentes em todas as cpias do
objeto sendo criado, diminuindo a necessidade de repetio de cdigo em
diversas partes do aplicativo.

Os ElipseX ficam encapsulados em um arquivo com extenso .lib. Pode-se


criar todos os ElipseX que so utilizados em um determinado projeto no
mesmo arquivo de Biblioteca (.lib), ou ento dividir entre vrios arquivos
conforme desejado.

Para criar uma nova biblioteca no E3, siga estes procedimentos:

1. Selecione o menu Arquivo - Novo Projeto e clique em Prximo.

2. Na opo Tipo de Aplicao, selecione a opo Biblioteca de


componentes do E3.

Criao de uma biblioteca do usurio (ElipseX)

Bibliotecas 397
3. Determine o nome da biblioteca e clique em Avanar.

4. Determine as especificaes referentes ao Domnio.

5. Clique em Concluir.

Dentro de uma biblioteca ElipseX, pode-se inserir trs tipos de objetos: os


XControls, os XFolders e os XObjects.

Os seguintes itens podem ser inseridos em um XControl: Primitivas de


Desenho (Retas, Retngulos, Crculos, etc.), Objetos Grficos Vetoriais,
incluindo objetos da biblioteca de smbolos (WMF, EMF, etc.), Objetos
Grficos no-Vetoriais (BMP, JPEG, GIF,etc.), Controles ActiveX do E3 (E3Chart,
E3Browser, E3Alarm, Controles ActiveX de terceiros) e outros XControls.

Um XFolder um objeto que permite inserir objetos filhos em suas instncias.


Desta forma, possvel organizer ou criar hierarquias de objetos em uma
aplicao. Pode-se inserir em um XFolder itens como Pastas de Dados, Tags
de Comunicao, Filtros de Alarmes e instncias de XFolders, entre outros.

J os XObjects podem conter quaisquer tipos de objetos no-grficos,


executados no E3 Server, como Drivers de Comunicao, Servidores de
Dados, Bancos de Dados, Frmulas, Configuraes de Alarmes, Servidores de
Alarmes e Objetos COM, entre outros.

NOTA
A janela de propriedades dos ElipseX no editor de objetos pode ser aberta
utilizando as combinaes de teclas ALT + ENTER, CTRL + ALT + ENTER ou
ALT + duplo-clique do mouse.

Dentro de um mesmo arquivo .lib pode existir qualquer nmero de


componentes ElipseX, sejam eles XControls, XFolders ou XObjects. Pode-se
tambm ter vrias bibliotecas diferentes dentro do mesmo Domnio.

398 Bibliotecas
Note que para cada ElipseX criado em uma biblioteca so criadas
internamente duas interfaces, uma para declarar as propriedades do objeto, e
outra para declarar os eventos do objeto. Estas interfaces tm seus nomes
gerados automaticamente, acrescentando o prefixo "D" a este nome (a
interface de eventos adiciona o sufixo "Events" ao nome automtico). Se, por
exemplo, o objeto se chama "XObject1", sua interface de propriedades tem o
nome "DXObject1" e a interface de eventos, "DXObject1Events". Uma tentativa
de usar estes nomes em outras classes na mesma biblioteca gera um cdigo
de erro 8002802D, que corresponde a Name already exists in the library.

Bibliotecas 399
9.2.1 XControls
O XControl define uma interface grfica com o usurio, que pode ser
composta de quaisquer objetos do E3, e tem o propsito de ser multiplicada
facilmente por um projeto. Pode-se criar um XControl clicando com o boto
direito do mouse no item Bibliotecas de Objetos - XControls no modo
Domnio, selecione a opo Inserir XControl em e logo aps o nome da
biblioteca desejada.

Aba Design de um XControl

400 Bibliotecas
Aba Propriedades de um XControl

Ao inserir um XControl aberto o Editor deste objeto, composta por trs


abas. Alm da aba Scripts, presente em todos os objetos, existe a aba
Design, que equivale a uma Tela, onde podem ser inseridos os objetos
grficos descritos anteriormente, e a aba Propriedades, onde podem ser
inseridas variveis, que so as propriedades do XControl. Estas propriedades
so exportadas pelo objeto e podem ser associadas a um Tag ou outra
propriedade qualquer quando o objeto estiver sendo usado na aplicao.

As variveis a serem exportadas podem ser inseridas pressionando-se a tecla


INSERT do teclado ou clicando em e excludos atravs da tecla DELETE do
teclado ou clicando em . As opes disponveis na aba Propriedades esto
descritas na tabela a seguir.

Opes disponveis na aba Propriedades

OPO DESCRIO
Nome Determina o nome da varivel do
XControl

Bibliotecas 401
OPO DESCRIO
Tipo Determina o tipo de dados
suportado pela varivel. Note que
outros objetos de Dados (XFolders e
XObjects) podem ser declarados
como tipos de dados. Desta forma,
pode-se criar um objeto de dados
que possui como propriedade outro
objeto de dados. Os objetos de
dados podem funcionar neste caso
como uma estrutura ou classe, como
utilizado nas linguagens C/C++.
Quando for especificado um tipo de
objeto (por exemplo DemoTag,
IOTag, XObject, etc.), esta
propriedade tem o seguinte
comportamento:

Caso o ElipseX esteja inativo: A


propriedade funciona como uma
String, que especifica o caminho
da instncia de um objeto do tipo
configurado

Caso o ElipseX esteja ativo: Na


escrita, a propriedade funciona
como o caso anterior, porm na
leitura a propriedade retorna o
objeto especificado, caso ele
exista. Se o caminho no aponta
para um objeto existente no
momento, a propriedade retorna
Nothing

Esta opo corresponde


propriedade Type de um objeto
Definio de Propriedade

402 Bibliotecas
OPO DESCRIO
Pblica Habilita ou desabilita a visibilidade da
varivel fora da biblioteca, isto ,
determina se a varivel ou no
pblica. Esta opo corresponde
propriedade Public de um objeto
Definio de Propriedade

Gravvel Determina se a varivel salva no


projeto ou no. Esta opo
corresponde propriedade
Persistable de um objeto Definio
de Propriedade

Retentiva Determina se a propriedade


retentiva ou no. No caso de
XControls, as propriedades no
podem ser retentivas. Esta opo
corresponde propriedade
Retentive de um objeto Definio de
Propriedade

Valor inicial Determina o valor inicial da varivel.


Esta opo corresponde
propriedade DefaultValue de um
objeto Definio de Propriedade

Texto de ajuda Texto de declarao e documentao


da varivel. Esta opo corresponde
propriedade HelpString de um
objeto Definio de Propriedade

Bibliotecas 403
NOTA
interessante observar que XFolders e XObjects podem ser declarados
como tipos de dados.

A edio do objeto grfico pode ser realizada da mesma forma como a


edio de uma Tela, possuindo os mesmos recursos grficos e opes.

Pode-se inserir os XControls em qualquer Tela, ou ainda dentro de outro


XControl clicando com o boto direito do mouse na Tela ou XControl de
destino, selecionando a opo Inserir, como mostrado a seguir. A partir de
um XControl em desenvolvimento (dentro da biblioteca), possvel inserir
outro XControl dentro dele, clicando com o boto direito do mouse no
XControl de destino e selecionando a opo Inserir.

Inserindo um XControl na Tela

404 Bibliotecas
A partir deste momento, o XControl tem um nome dentro da Tela, e
entendido como uma cpia da definio original. Assim, deve-se definir (se
necessrio) os valores ou as Associaes que esta cpia especfica tem no
contexto que est sendo utilizada. Se o tamanho deste objeto for alterado na
aba Design do Editor da Biblioteca e registrado novamente, necessrio usar
a opo Tamanho Original no seu menu contextual da Tela para que a
alterao aparea.

Se for criado um objeto Bomba, por exemplo, que possui uma propriedade
Estado, que recebe uma informao externa revelando se a bomba est
ligada ou desligada, fazendo com que ela mude sua cor. Ao inserir este
objeto na Tela, o E3 automaticamente renomeia o objeto para "Bomba1".

Pode-se manter este nome ou renome-lo para outro que se desejar. Depois,
deve ser informada qual varivel vai ser associada propriedade Estado.
Suponha que certo Tag de Comunicao representa o estado desta bomba.
Logo, deve ser criada uma Associao entre a propriedade Estado e o
referido Tag. O mesmo trabalho deve ser executado para outras instncias
(cpias) do objeto Bomba que se fizerem necessrias no projeto.

Bibliotecas 405
9.2.2 XFolders
Um XFolder um objeto do servidor que permite organizar ou criar uma
hierarquia de objetos nas instncias criadas. Os objetos que podem ser
inseridos em uma instncia de XFolder so os seguintes:

Pastas de Dados

Tags de Comunicao

Consultas

Filtros de Alarmes

Instncias de XFolders e XObjects

Alarmes

NOTA
No permitido inserir objetos na definio de um XFolder, somente em
suas instncias.

Para criar um XFolder, clique com o boto direito do mouse no item


Bibliotecas de Objetos - XFolders no modo Domnio, selecione a opo
Inserir XFolder em e logo aps o nome da biblioteca desejada.

Aba Propriedades de um XFolder

406 Bibliotecas
Ao inserir um XFolder, aberto o Editor deste objeto, onde podem ser
inseridas variveis. Estas variveis so as propriedades a serem exportadas
pelo objeto, que podem ser associadas a um Tag ou outra propriedade
qualquer de uma aplicao quando o objeto estiver sendo usado em uma
aplicao.

As variveis a serem exportadas podem ser inseridas pressionando-se a tecla


INSERT do teclado ou clicando em e excludas atravs da tecla DELETE ou
clicando em . As opes disponveis na aba Propriedades esto descritas
na tabela a seguir.

Opes disponveis na aba Propriedades

OPO DESCRIO
Nome Determina o nome da varivel do
XFolder

Bibliotecas 407
OPO DESCRIO
Tipo Determina o tipo de dados
suportado pela varivel. Note que
outros objetos de Dados (XFolders e
XObjects) podem ser declarados
como Tipos. Desta forma, pode-se
criar um objeto de dados que possui
como propriedade outro objeto de
dados. Os objetos de dados podem
funcionar neste caso como uma
estrutura ou classe, como utilizado
nas linguagens C/C++. Quando for
especificado um tipo de objeto (por
exemplo DemoTag, IOTag, XObject,
etc.), esta propriedade tem o
seguinte comportamento:

Caso o ElipseX esteja inativo: A


propriedade funciona como uma
String, que especifica o caminho
da instncia de um objeto do tipo
configurado

Caso o ElipseX esteja ativo: Na


escrita, a propriedade funciona da
mesma maneira de quando o
objeto est desativado. Porm, na
leitura a propriedade retorna o
objeto especificado, caso ele
exista. Se o caminho no aponta
para um objeto existente no
momento, a propriedade retorna
Nothing

Esta opo corresponde


propriedade Type de um objeto
Definio de Propriedade

408 Bibliotecas
OPO DESCRIO
Pblica Habilita ou desabilita a visibilidade da
varivel fora da biblioteca, isto ,
determina se a varivel ou no
pblica. Esta opo corresponde
propriedade Public de um objeto
Definio de Propriedade

Gravvel Determina se a varivel salva no


projeto ou no. Esta opo
corresponde propriedade
Persistable de um objeto Definio
de Propriedade

Retentiva Determina se a propriedade


retentiva ou no. Esta opo
corresponde propriedade
Retentive de um objeto Definio de
Propriedade

Valor inicial Determina o valor inicial da varivel.


Esta opo corresponde
propriedade DefaultValue de um
objeto Definio de Propriedade

Texto de ajuda Texto de declarao e documentao


da varivel. Esta opo corresponde
propriedade HelpString de um
objeto Definio de Propriedade

Bibliotecas 409
Pode-se inserir XFolders em qualquer Servidor de Dados, clicando com o
boto direito do mouse no Servidor de Dados no modo Domnio,
selecionado a opo Inserir e logo aps o nome do XFolder desejado,
conforme mostrado na figura a seguir. No modo Explorer, clique com o
boto direito do mouse no Servidor de Dados do projeto, selecione a opo
Inserir e logo aps o nome do XFolder desejado.

Inserindo um XFolder no modo Domnio

410 Bibliotecas
9.2.3 XObjects
Alm dos XControls e XFolders, pode-se criar uma biblioteca de dados,
denominada XObject. Com ela, pode-se definir uma estrutura de dados, que
executada no servidor. Tal estrutura pode realizar clculos, Associaes,
comunicaes, verificao de alarmes, registro histrico, etc., que independam
de que alguma interface grfica (Viewer) esteja aberta ou sendo executada
naquele momento. Para criar um XObject, clique com o boto direito do
mouse no item Bibliotecas de Objetos - XObjects no modo Domnio,
selecione a opo Inserir XObject em e logo aps o nome da biblioteca
desejada.

XObjects

Ao inserir um XObject, aberto o Editor deste objeto, onde podem ser


inseridas variveis. Estas variveis so as propriedades a serem exportadas
pelo objeto, que podem ser associadas a um Tag ou outra propriedade
qualquer de uma aplicao quando o objeto estiver sendo usado em uma
aplicao.

As variveis a serem exportadas podem ser inseridas pressionando-se a tecla


INSERT do teclado ou clicando em e excludas atravs da tecla DELETE ou
clicando em . As opes disponveis na aba Propriedades esto descritas
na tabela a seguir.

Opes disponveis na aba Propriedades

OPO DESCRIO
Nome Determina o nome da varivel do
XObject

Bibliotecas 411
OPO DESCRIO
Tipo Determina o tipo de dados
suportado pela varivel. Note que
outros objetos de Dados (XFolders e
XObjects) podem ser declarados
como Tipos. Desta forma, pode-se
criar um objeto de dados que possui
como propriedade outro objeto de
dados. Os objetos de dados podem
funcionar neste caso como uma
estrutura ou classe, como utilizado
nas linguagens C/C++. Quando for
especificado um tipo de objeto (por
exemplo DemoTag, IOTag, XObject,
etc.), esta propriedade tem o
seguinte comportamento:

Caso o ElipseX esteja inativo: A


propriedade funciona como uma
String, que especifica o caminho
da instncia de um objeto do tipo
configurado

Caso o ElipseX esteja ativo: Na


escrita, a propriedade funciona da
mesma maneira de quando o
objeto est desativado. Porm, na
leitura a propriedade retorna o
objeto especificado, caso ele
exista. Se o caminho no aponta
para um objeto existente no
momento, a propriedade retorna
Nothing

Esta opo corresponde


propriedade Type de um objeto
Definio de Propriedade

412 Bibliotecas
OPO DESCRIO
Pblica Habilita ou desabilita a visibilidade da
varivel fora da biblioteca, isto ,
determina se a varivel ou no
pblica. Esta opo corresponde
propriedade Public de um objeto
Definio de Propriedade

Gravvel Determina se a varivel salva no


projeto ou no. Esta opo
corresponde propriedade
Persistable de um objeto Definio
de Propriedade

Retentiva Determina se a propriedade


retentiva ou no. Esta opo
corresponde propriedade
Retentive de um objeto Definio de
Propriedade

Valor inicial Determina o valor inicial da varivel.


Esta opo corresponde
propriedade DefaultValue de um
objeto Definio de Propriedade

Texto de ajuda Texto de declarao e documentao


da varivel. Esta opo corresponde
propriedade HelpString de um
objeto Definio de Propriedade

Bibliotecas 413
Apenas propriedades de tipos simples (Variant, String, Date, Double, etc.)
podem ser retentivas (o Editor do objeto desmarca automaticamente a
coluna Retentiva se o tipo de uma propriedade for alterado para um tipo
de objeto), e apenas propriedades de XFolders e de XObjects podem ser
retentivas.

NOTA
O uso de propriedades retentivas nos ElipseX pode aumentar o tempo de
incio do aplicativo, e tambm aumentar o consumo de memria pelo
processo E3Run. Os tempos variam dependendo do nmero de instncias
de XFolders e de XObjects, do nmero de propriedades retentivas em cada
XFolder ou XObject e da quantidade destas propriedades que possuem o
seu valor alterado (se a propriedade nunca alterada, o seu valor retentivo
permanece zerado).

Podem ser inseridos em um XObject quaisquer mdulos do E3 que sejam


executados no servidor, a saber:

Driver de Comunicao e Driver de Comunicao OPC

Servidor de alarmes e alarmes

Servidor de Banco de Dados

Frmulas

Servidor de Dados

Histricos

Isto permite que se possa definir como uma biblioteca um sistema complexo
de gerenciamento, que pode ser facilmente replicado quantas vezes forem
necessrias em um aplicativo.

414 Bibliotecas
IMPORTANTE
Veja que XControls, XFolders e XObjects s podem se relacionar com o
mundo externo atravs das propriedades (ou ainda atravs do mouse e
teclado, no caso dos XControls). Isto significa que no se pode acessar
dados internos de um XControl, XFolder ou XControl seno de dentro do
prprio objeto.

Pode-se inserir XObjects em qualquer Servidor de Dados, clicando com o


boto direito do mouse no Servidor de Dados no modo Domnio,
selecionado a opo Inserir e logo aps o nome do XObject desejado,
conforme mostrado na figura a seguir. No modo Explorer, clique com o
boto direito do mouse no Servidor de Dados do projeto, selecione a opo
Inserir e logo aps o nome do XObject desejado.

Bibliotecas 415
Inserindo um XObject no modo Domnio

Note que mesmo se os arquivos de biblioteca possurem vrios XControls,


XFolders e XObjects, ao tentar inserir uma instncia (cpia), o E3 Studio exibe
para as Telas somente os XControls, e para os Servidores de Dados somente
os XFolders e XObjects disponveis.

NOTA
Deve-se cuidar para no apagar uma propriedade de um XControl, XFolder
ou XObject que possua uma Associao. Estas propriedades, uma vez
apagadas, no aparecem mais na lista de propriedades do objeto, e por
isto no podem ser editadas. Quando for executada a operao Verificar
Domnio, executada uma procura por estas propriedades e o usurio
consultado se deseja remover esta Associao ou no.

416 Bibliotecas
Propriedade invlida

Pode-se optar por no remover e ento criar novamente o objeto que foi
apagado com a propriedade que se deseja editar, remover apenas a
propriedade que est sendo mostrada, remover todas as propriedades ou
no remover nenhuma propriedade.

Bibliotecas 417
9.3 Quando Criar um ElipseX
O uso de Bibliotecas altamente recomendvel devido ao ganho de
produtividade que trazem. Algumas das vantagens dos ElipseX so as
seguintes:

Reutilizao de cdigo

Minimizao de testes durante o desenvolvimento

Criao de interface padro para os objetos desenvolvidos

Diminuio do tempo de desenvolvimento de novos projetos

Proteo do contedo do projeto

Hierarquizao de objetos

Logo, o uso de biblioteca recomendado para a maioria das aplicaes.


Entretanto, existem alguns critrios para indicar a necessidade da construo
de objetos no E3:

Repetio no uso: Se um mesmo equipamento ou processo usado


mais de uma vez no mesmo projeto

Procedimentos do conhecimento do usurio: Frequentemente, um


processo criado por determinada empresa deve ser protegido de cpia
ou alterao. Isto comum no caso de integradores de servios ou
fabricantes de mquinas

Uso de controladores: Um controlador de processo, cujo mapeamento


de memria fixo, pode ser implementado com todas as funcionalidades
disponveis. A flexibilidade disponvel para a construo e uso dos
objetos no E3 permite que sejam utilizadas posteriormente apenas as
variveis de interesse, desprezando-se as demais

NOTA
Para exemplos de criao de ElipseX e maiores informaes sobre estes
objetos, consulte o Manual de Referncia e Scripts do E3.

418 Bibliotecas
CAPTULO
ActiveX
10
Os objetos ActiveX so componentes de software baseados na tecnologia
COM (Component Object Model) que podem ser inseridos em uma aplicao
para realizar diversas tarefas. Estes objetos so desenvolvidos em ambientes
de programao tais como C/C++, Delphi e Visual Basic, entre outros.

Alguns objetos ActiveX so automaticamente registrados quando o E3


instalado: E3Alarm, E3Browser e E3Chart (desenvolvidos pela Elipse Software),
Microsoft Forms (desenvolvidos pela Microsoft) e Relatrio (ActiveReports,
desenvolvido pela Data Dynamics). Os objetos E3Alarm, E3Browser, E3Chart e
Relatrio possuem captulos especficos mais adiante neste Manual. Os
objetos Microsoft Forms so descritos em outro tpico deste captulo.

NOTA
Para objetos ActiveX no instalados previamente pelo E3, necessrio que
estes objetos sejam instalados em todos os computadores onde a aplicao
vai executar, especialmente em Viewers Remotos.

Alm destes, pode-se inserir qualquer outro objeto ActiveX. Para registrar um
objeto ActiveX no E3, siga estes procedimentos:

1. Selecione o menu Ferramentas - Gerenciar ActiveX. A janela da figura a


seguir mostrada.

ActiveX 419
Janela Gerenciar Controles ActiveX

As opes da janela Gerenciar Controles ActiveX esto descritas na tabela a


seguir.

Opes da janela Gerenciar Controles ActiveX

OPO DESCRIO
Controles registrados no Windows Listagem com todos os controles
ActiveX registrados no Windows e que
podem ser adicionados ao E3

Controles registrados no E3 Listagem com todos os controles


ActiveX j registrados no E3

Registrar Registra o controle selecionado no E3.


Caso o controle seja incompatvel com
o E3, uma caixa de dilogo
mostrada avisando o usurio a
respeito da incompatibilidade

420 ActiveX
OPO DESCRIO
Remover Remove o controle selecionado da
lista Controles registrados no E3,
movendo-o de volta para a lista
Controles registrados no Windows.
Os controles com o cone no
podem ser removidos, somente os
que tiverem o cone

Procurar Abre uma caixa de dilogo para


localizar um arquivo ActiveX

Atualizar Permite atualizar os controles ActiveX


na listagem Controles registrados no
Windows que tenham sido
registrados aps a abertura da janela
de gerenciamento

Fechar Fecha a janela de gerenciamento dos


ActiveX

2. Clique em Procurar para abrir uma caixa de dilogo e localizar o arquivo


que contm o ActiveX.

ActiveX 421
Localizao do arquivo ActiveX

3. Selecione o arquivo desejado e clique em Abrir.

Os objetos ActiveX podem ser de dois tipos: Grficos (utilizados nas Telas da
aplicao) e No-Grficos (realizam algum tipo de manipulao de dados).

Os objetos grficos podem ser inseridos na aplicao de trs formas


diferentes:

Atravs da barra de ferramentas Objetos, selecionando o objeto


desejado

Atravs do clique com o boto direito do mouse no objeto Tela, no


Organizer, selecionando a opo Inserir

Atravs do clique com o boto direito do mouse na Tela, selecionando a


opo Inserir

422 ActiveX
Inserindo um objeto grfico na Tela

Os objetos no-grficos podem ser usados na aplicao atravs de scripts e


so criados pelo mtodo CreateObject, padro do VBScript.

10.1 Objetos Microsoft Forms


Para inserir um dos objetos Microsoft Forms previamente registrados no E3
na aplicao, existem duas opes:

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


- MSForms.

2. Selecione o objeto desejado na barra de ferramentas Objetos e clique na


Tela para estabelecer o ponto inicial do desenho do objeto, arrastando o
mouse diagonalmente at o objeto atingir o tamanho e a posio
desejados.

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


tpicos seguintes.

ActiveX 423
10.1.1 Barra de Rolagem
Facilita a navegao atravs de uma longa lista de itens ou de uma grande
quantidade de informao tanto horizontalmente quanto verticalmente.
inserido na Tela ao selecionar o cone .

10.1.2 Boto de Comando


Usado para executar aes especficas quando pressionado, tais como abrir
uma janela, imprimir um relatrio, etc. inserido na Tela ao selecionar o
cone .

10.1.3 Boto de Incremento e Decremento


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

10.1.4 Boto de Opo


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

10.1.5 Boto Liga e Desliga


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

10.1.6 Caixa de Seleo


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

10.1.7 Editor de Texto


Possibilita ao usurio inserir e editar textos. inserido na Tela ao selecionar o
cone .

424 ActiveX
10.1.8 Lista
Exibe uma lista de itens dentre os quais o usurio pode escolher um ou mais.
inserido na Tela ao selecionar o cone .

10.1.9 Lista de Seleo


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

10.1.10 Texto
Exibe mensagens de texto que no podem ser editadas pelo usurio, como
descries de controles ou legendas. inserido na Tela ao selecionar o cone
.

ActiveX 425
10.2 Elipse KeyPad
O Elipse KeyPad um controle ActiveX desenvolvido pela Elipse Software, que
permite utilizar um teclado virtual flutuante em aplicaes desenvolvidas com
o E3.

Este controle pode ser ativado no Viewer utilizando a aba Visualizador das
propriedades do objeto Viewer.

Aba Visualizador do Viewer

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

Opes disponveis para o Elipse KeyPad na aba Visualizador

426 ActiveX
OPO DESCRIO
Mostrar quando um SetPoint Esta opo mostra o Elipse KeyPad
recebe o foco sempre que um objeto do tipo
SetPoint recebe o foco

Esconder ao pressionar ENTER Habilita ocultar o Elipse KeyPad ao


pressionar a tecla ENTER. Esta opo
equivale propriedade
AutoHideOnEnter do controle

Esconder ao pressionar ESC Habilita ocultar o Elipse KeyPad ao


pressionar a tecla ESC. Esta opo
equivale propriedade
AutoHideOnEsc do controle

Em scripts, o KeyPad pode ser acionado utilizando-se o mtodo GetKeyPad


do objeto Application. Demais informaes sobre as funcionalidades das
propriedades deste objeto podem ser encontradas no Manual de Referncia
e Scripts do E3, em seu captulo respectivo.

ActiveX 427
CAPTULO
Servidor de Dados
11
Os Servidores de Dados so os objetos responsveis por abrigar a execuo
das variveis do sistema como Tags Internos, Tags Demo, Tags Timer, e
instncias de XFolders e XObjects. Para utilizar este recurso, siga este
procedimento:

1. Clique com o boto direito do mouse no projeto no Organizer e selecione


a opo Inserir - Servidor de Dados.

Inserindo um Servidor de Dados

428 Servidor de Dados


NOTA
Os objetos do Servidor de Dados (Pasta de Dados, Tag Contador, Tag
Demo, Tag Interno e Tag Timer) podem ser configurados para
funcionarem como reas de Alarme.
Todas as opes do editor de objetos do Servidor de Dados que esto
disponveis via menu contextual (atravs do clique com o boto direito do
mouse) tambm esto disponveis utilizando a combinao de teclas SHIFT
+ F10, que corresponde tecla de aplicao ou de menu .
A janela de propriedades dos objetos do Servidor de Dados no editor de
objetos pode ser aberta utilizando as combinaes de teclas ALT +
ENTER, CTRL + ALT + ENTER ou ALT + duplo-clique do mouse.

Servidor de Dados 429


11.1 Impressora de Linha
A Impressora de Linha um objeto que permite imprimir diretamente para
uma impressora matricial. Para utilizar este recurso, siga estes procedimentos:

1. Clique com o boto direito do mouse no objeto Servidor de Dados e


selecione a opo Inserir - Standard - Impressora de Linha.

Inserindo uma Impressora de Linha

2. Para configurar a Impressora de Linha, clique com o boto direito do


mouse no objeto e selecione a opo Propriedades. A janela da figura a
seguir mostrada.

430 Servidor de Dados


Aba Geral

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

Opes disponveis na aba Geral

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

Escolher uma impressora Permite selecionar uma impressora


disponvel dentre as impressoras instaladas no
sistema operacional como sada do
objeto Impressora de Linha. A
propriedade PrinterName
configurada com o nome da
impressora selecionada nesta opo

Servidor de Dados 431


NOTAS
Caso seja selecionada a opo Escolher uma impressora disponvel, mas
no seja selecionada nenhuma impressora na Lista de Seleo
correspondente, o objeto Impressora de Linha no permite a impresso e
sua propriedade PrinterStatus configurada com o valor 0 (zero,
psUnknown).
A impressora padro do Windows para o usurio atualmente logado
pode ser diferente da impressora padro utilizada pelo E3 Server. Veja o
tpico Impressora para maiores informaes.
O objeto Impressora de Linha pode ser inserido em uma Tela, no Viewer,
em uma Pasta do Viewer ou em uma Pasta de Dados.

Para a impresso, utilize o mtodo Write, passando como argumento a


String desejada. Este objeto possui a propriedade MaxPendingLines, que
controla o nmero mximo de linhas pendentes para impresso. Caso a
chamada do mtodo Write ultrapasse o valor configurado nesta propriedade,
este mtodo retorna um erro de script e a String excedente descartada.

432 Servidor de Dados


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

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


opo Inserir - Panel - Pasta de Dados.

Inserindo uma Pasta de Dados

Servidor de Dados 433


11.3 Tag Contador
O Tag Contador um objeto que realiza a contagem de tempo (em
segundos) at atingir um valor predeterminado, ou que realiza uma certa
contagem indefinidamente. Para utilizar este recurso, siga estes
procedimentos:

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


opo Inserir - Panel - Tag Contador.

Inserindo um Tag Contador

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

434 Servidor de Dados


Inserindo Tags Contador

As propriedades do Tag Contador podem ser configuradas atravs da Lista


de Propriedades, sem a necessidade de criar scripts para isto. Caso necessite
configurar alguma propriedade, localize-a na Lista de Propriedades e faa os
devidos ajustes.

Servidor de Dados 435


11.4 Tag Demo
O Tag Demo um objeto que gera valores de acordo com a forma de onda,
e utilizado para simulao de valores. Permite gerar ondas definidas ou
valores aleatrios. Para utilizar este recurso, siga estes procedimentos:

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


opo Inserir - Panel - Tag Demo.

Inserindo um Tag Demo

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

436 Servidor de Dados


Inserindo Tags Demo

As propriedades do Tag Demo podem ser configuradas atravs da Lista de


Propriedades, sem a necessidade de criar scripts para isto. Caso necessite
configurar alguma propriedade, localize-a na Lista de Propriedades e faa os
devidos ajustes.

Servidor de Dados 437


11.5 Tag Interno
O Tag Interno um objeto de propsito genrico, utilizado para guardar
valores de qualquer tipo, incluindo nmeros, textos e at outros objetos. Para
utilizar este objeto, siga estes procedimentos:

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


opo Inserir - Panel - Tag Interno.

Inserindo um Tag Interno

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

438 Servidor de Dados


Inserindo Tags Internos

As propriedades do Tag Interno podem ser configuradas atravs da Lista de


Propriedades, sem a necessidade de criar scripts para isto. Caso necessite
configurar alguma propriedade, localize-a na Lista de Propriedades e faa os
devidos ajustes.

Servidor de Dados 439


11.6 Tag Timer
O Tag Timer um objeto para contagem de tempo e agendamento de
atividades. Ele estabelece horrios (com repeties) para executar aes. Para
utilizar este objeto, siga estes procedimentos:

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


opo Inserir - Panel - Tag Timer.

Inserindo um Tag Timer

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

440 Servidor de Dados


Inserindo Tags Timer

As propriedades do Tag Timer podem ser configuradas atravs da Lista de


Propriedades, sem a necessidade de criar scripts para isto. Caso necessite
configurar alguma propriedade, localize-a na Lista de Propriedades e faa os
devidos ajustes.

Servidor de Dados 441


CAPTULO
Banco de Dados
12
O Banco de Dados do E3 utilizado para armazenar as informaes do
projeto referentes a Histricos, Frmulas, Alarmes e Storage. Suporta os
formatos Access (.mdb), Oracle e Microsoft SQL Server.

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

Inserindo um Banco de Dados no modo Domnio

442 Banco de Dados


Ao inserir o Banco de Dados na aplicao, so habilitadas as opes
referentes ao tipo de Servidor de Banco de Dados, atravs da aba
Configurao na Janela de Propriedades, ou da propriedade SourceType, na
Lista de Propriedades.

Algumas das propriedades deste objeto podem ser configuradas atravs da


Lista de Propriedades, sem a necessidade da criao de scripts para isto. Para
isto, localize-as e efetue os devidos ajustes. Demais informaes sobre as
funcionalidades das propriedades deste objeto podem ser encontradas no
Manual de Referncia e Scripts do E3, em seu captulo respectivo.

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

Banco de Dados 443


12.1 Access
Gera uma base de dados no formato MDB (Microsoft Access Database), padro
para banco de dados no E3. Para utilizar este recurso, siga estes
procedimentos:

1. Clique com o boto direito do mouse no nome do projeto no Explorer e


selecione a opo Inserir - Banco de Dados. No modo Domnio, clique
com o boto direito do mouse no item Objetos de Servidor - Banco de
Dados, selecione a opo Inserir Banco de Dados em e logo aps o
nome do projeto desejado. O objeto criado no projeto, e sua janela de
edio de scripts aberta.

2. Para configur-lo, selecione a aba Configuraes da Janela de


Propriedades.

444 Banco de Dados


Configuraes para Banco de Dados Access

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

Opes disponveis na aba Configurao

OPO DESCRIO
Banco de Dados Seleciona o tipo de Banco de Dados
em uso no projeto: 0 - stAccess, 1 -
stOracle ou 2 - stSqlServer

Banco de Dados 445


OPO DESCRIO
Arquivo MDB Nome do arquivo .mdb utilizado no
projeto. NOTA: Este campo aceita
tanto um caminho absoluto quanto
um caminho relativo pasta do
Domnio atual. O caminho completo
deve existir para que o arquivo .mdb
seja criado ou encontrado
corretamente

Senha do BD Senha do Banco de Dados Access

Usurio Usurio do Banco de Dados


conectado pelo E3

Senha Senha do usurio que realiza o logon

Testar conexo Testa a conexo com o Banco de


Dados

3. No campo Banco de Dados, selecione o item 0 - stAccess.

4. Insira o nome do arquivo desejado (existente ou no) no campo Arquivo


MDB (conforme figura anterior).

5. Caso seja necessrio, configure as opes Usurio, Senha e Senha do BD


de acordo com as definies do Access. Tais itens podem ficar em branco
e, neste caso, a aplicao assume as configuraes padro do E3.

6. Clique em OK para finalizar as configuraes.

446 Banco de Dados


12.2 Oracle
A utilizao do Oracle como servidor de Banco de Dados do E3 s possvel
atravs da instalao de um servidor ou cliente Oracle na mquina onde
executado o E3 Server. Nesta instalao devem estar presentes,
obrigatoriamente, o suporte a OCI (Oracle Call Interface) e o OLEDB Provider
para Oracle, necessrios para a comunicao do E3 com o Oracle. Para
instalar o Oracle, consulte a documentao prpria do produto.

O acesso ao banco de dados Oracle pode ser feito de duas maneiras:


acessando o Banco de Dados Oracle de dentro do E3 ou via scripts. A seguir
so explicados cada um destes procedimentos.

Banco de Dados 447


12.2.1 Acessando o Oracle via E3
Para inserir um novo Banco de Dados Oracle, siga estes procedimentos:

1. Clique com o boto direito do mouse no nome do projeto no Explorer e


selecione a opo Inserir - Banco de Dados. No modo Domnio, clique
com o boto direito do mouse no item Objetos de Servidor - Banco de
Dados, selecione a opo Inserir Banco de Dados em e logo aps o
nome do projeto desejado. O objeto criado no projeto, e sua janela de
edio de scripts aberta.

2. Para configur-lo, selecione a aba Configurao na Janela de


Propriedades.

448 Banco de Dados


Configuraes para Banco de Dados Oracle

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

Opes disponveis na aba Configurao

OPO DESCRIO
Banco de Dados Seleciona o tipo de Banco de Dados
em uso no projeto: 0 - stAccess, 1 -
stOracle ou 2 - stSqlServer

Conexo Nome da conexo fornecido pelo


administrador do banco de dados

Banco de Dados 449


OPO DESCRIO
Usar tipo TIMESTAMP Permite utilizar o tipo de dados
TIMESTAMP do Oracle, com
preciso de milissegundos e
disponvel a partir da verso 9.0.
Caso esta opo esteja desabilitada,
usado o tipo de dados DATE, com
preciso de segundos. NOTA: Para
que o objeto Consulta do E3 seja
compatvel com tabelas que utilizem
o tipo de dados TIMESTAMP, deve
ser habilitada a opo Usar drivers
ADO Oracle

Usar drivers ADO Oracle Permite usar as interfaces ADO


(ActiveX Data Objects) do Oracle para
que o objeto Consulta do E3
reconhea o tipo de dados
TIMESTAMP. Assim possvel ler
registros de tabelas do Oracle que
possuam preciso de milissegundos

Usurio Usurio do Banco de Dados


conectado pelo E3

Senha Senha do usurio que realiza o logon

Testar conexo Testa a conexo com o Banco de


Dados

450 Banco de Dados


3. No campo Banco de Dados, selecione o item 1 - stOracle.

4. Se o servidor Oracle for local, o campo Conexo pode ficar em branco,


pois o E3 recupera os dados automaticamente. Do contrrio, a conexo
criada usando o cliente Oracle instalado na mquina.

5. Caso seja necessrio, configure as opes Usurio e Senha de acordo


com as definies do Oracle. Tais itens podem ficar em branco e, neste
caso, a aplicao assume as configuraes padro do E3.

6. Clique em OK para finalizar as configuraes.

Ao inserir o Banco de Dados na aplicao, so habilitadas as opes


referentes ao tipo de Servidor de Banco de Dados. O Servidor de Banco de
Dados o responsvel pelo gerenciamento e armazenamento das
informaes dos objetos que utilizam este servio.

Banco de Dados 451


12.2.2 Acessando o Oracle via Scripts
Scripts so mdulos de linguagem de programao onde se pode criar linhas
de cdigo, que permitem maior flexibilidade para a associao de aes a
eventos especficos. Cada item de um projeto do E3 possui uma lista de
eventos previamente associados. Assim, o usurio pode criar programas que
so executados na ocorrncia de um evento.

O E3 utiliza o VBScript (Visual Basic Script) em seus scripts, e com ele consegue
instanciar qualquer objeto ActiveX registrado no sistema. Para o acesso ao
Banco de Dados, o ActiveX mais utilizado o ADO, que pode ser facilmente
manipulado nos scripts do E3.

Primeiramente, necessria a criao de uma conexo ADO que pode ser


feita com o script a seguir:
Set DBConnection = CreateObject("ADODB.Connection")
DBConnection.Open "Provider=MSDAORA;_
DataSource=conexaoOracle;User_
ID=UserID;Password=passwd"

Depois da criao da conexo, possvel executar um comando SQL


diretamente na conexo, como mostrado a seguir:
DBConnection.Execute _
"UPDATE Tabela SET nome = 'Joo' WHERE id = 10"

possvel tambm a visualizao de todos os registros desejados, retornados


na forma de um Recordset (consulta), como mostrado a seguir:
Set Recordset = CreateObject("ADODB.Recordset")
Recordset.Source = "Tabela"
Recordset.ActiveConnection = DbConnection
Recordset.CursorType = 1 ' adOpenKeyset
Recordset.LockType = 3 ' adLockOptimistic
Recordset.Open

A partir deste momento, possvel navegar pela tabela utilizando-se os


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

452 Banco de Dados


12.2.3 Tecnologias Utilizadas pelo E3 para Acessar o
Oracle
O E3 utiliza basicamente duas tecnologias para acessar o Banco de Dados
Oracle: ADO (ActiveX Data Object) e OCI (Oracle Call Interface).

ADO a tecnologia utilizada pelo E3Browser e E3Chart para recuperao dos


dados armazenados no Banco de Dados. O ADO tambm amplamente
utilizado nos scripts do E3 para todo tipo de operao junto ao Banco de
Dados. Ele um conjunto de objetos COM (Component Object Model) criado
para acessar informaes de SGBD usando OLE DB (Object Linking and
Embedding). Esta tecnologia est disponvel quando se instala o OLE DB
Provider para Oracle (MSDAORA) e permite o acesso interface nativa do
Oracle, a OCI.

A OCI utilizada pelo Servidor de Banco de Dados do E3 para implementar


os servios de Banco de Dados utilizados pelos Histricos, Frmulas, Alarmes
e Storage. Atravs da OCI se acessa diretamente as funes do Oracle,
tornando este processo o mais otimizado possvel. Ela fornece uma biblioteca
padro de acesso ao Banco de Dados e funes de recuperao de dados na
forma de uma DLL ou LIB, que pode ser conectada a uma aplicao em tempo
de execuo.

Banco de Dados 453


12.2.4 Acessando o Oracle via Servidor BD
O Servidor de Banco de Dados do E3 utiliza a OCI (Oracle Call Interface) para
se comunicar com o servidor Oracle, ou seja, utiliza a forma nativa do Banco
de Dados para ganhar em performance na comunicao com o Banco de
Dados.

Um bom exemplo de como funciona a comunicao do Servidor de Banco de


Dados do E3 com o Oracle o Histrico. Inicialmente feita a aquisio dos
dados pelo Histrico que, de posse destes dados, imediatamente os envia em
forma de requisies para o Banco de Dados. Estas requisies podem ser
para criao de uma tabela, criao de ndices e chaves, adio de dados, etc.
O Servidor de Banco de Dados do E3 possui um processo separado
especialmente para receb-las. Dependendo do tipo de operao a ser
realizada, os dados so formatados e armazenados em arquivos temporrios
ou em memria.

Ao mesmo tempo, o Banco de Dados possui mais um outro processo,


responsvel pela recuperao das aquisies e posterior envio para o banco
de dados em forma de comandos SQL, utilizando a OCI.

454 Banco de Dados


Comunicao do E3 com o Oracle

12.3 SQL Server


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

Banco de Dados 455


12.3.1 Acessando o SQL Server via E3
Para inserir um novo Banco de Dados SQL Server, siga estes procedimentos:

1. Clique com o boto direito do mouse no projeto e selecione a opo


Inserir - Banco de Dados. O objeto criado e sua janela de edio de
scripts aberta.

2. Para configur-lo, selecione a aba Configurao na Janela de


Propriedades.

Configuraes para o Banco de Dados SQL Server

456 Banco de Dados


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

Opes disponveis na aba Configurao

OPO DESCRIO
Banco de Dados Seleciona o tipo de Banco de Dados
em uso no projeto: 0 - stAccess, 1 -
stOracle ou 2 - stSqlServer

Servidor Nome do servidor

Banco de Dados Nome do Banco de Dados

Biblioteca de Rede Biblioteca de rede utilizada pelo ADO:


0 - Padro, 1 - Named Pipes, 2 -
Winsock TCP/IP, 3 - SPX/IPX, 4 -
Banyan Vines ou 5 - Multi-Protocol
(RCP)

Banco de Dados 457


OPO DESCRIO
Alterar string de conexo Esta caixa de seleo permite
modificar a String de conexo a um
banco de dados SQL Server. As
seguintes restries se aplicam a esta
opo:

As alteraes feitas NO SO
validadas pelo E3. Portanto, de
inteira responsabilidade do usurio
a correta configurao da String
customizada

Se esta caixa de seleo estiver


desmarcada, o E3 utiliza o formato
padro para realizar a conexo

A String de conexo aceita duas


macros: {SERVER}, que substituda
pelo nome do servidor configurado
em Servidor e {DB}, que
substituda pelo nome do banco de
dados configurado em Banco de
Dados

Usurio Usurio do Banco de Dados


conectado pelo E3. Dependendo do
tipo de objeto a ser utilizado no
projeto, deve ter diferentes tipos de
permisso

Senha Senha do usurio que realiza o logon

Testar conexo Testa a conexo com o Banco de


Dados

458 Banco de Dados


3. No campo Banco de Dados, selecione o item 2 - stSqlServer.

4. Caso seja necessrio, configure as opes Usurio e Senha de acordo


com as definies do SQL Server. Tais itens podem ficar em branco e,
neste caso, a aplicao assume as configuraes padro do E3.

5. Clique em OK para finalizar as configuraes.

Banco de Dados 459


12.3.2 Exemplo de Utilizao do SQL Server 2000
Para ilustrar o acesso ao SQL Server 2000, faremos a criao de um Histrico
registrando dados por tempo de varredura de um segundo. Os
procedimentos so mostrados a seguir.

1. Crie um Tag Demo. As configuraes deste Tag no necessitam ser


alteradas.

2. Clique duas vezes no Servidor de Banco de Dados para abrir a janela de


configurao do Servidor SQL. Os parmetros devem ser alterados para
se adequarem s configuraes disponveis na instalao do SQL Server.

3. Execute as configuraes necessrias nesta janela, tais como nome do


servidor, usurio, senha e Banco de Dados.

4. Aps executar a configurao do Banco de Dados, deve-se configurar o


Histrico que acessa este banco de dados. Para tanto, primeiramente
deve-se criar um campo no Histrico e inserir o Tag Demo, que utilizado
para o envio de diferentes valores ao Banco de Dados.

Histrico e suas configuraes

5. Abra a janela de propriedades do Histrico clicando em Propriedades do


Histrico e determine o servidor de Banco de Dados e o nome da
tabela. As demais configuraes devem permanecer inalteradas. A tabela
serve para a busca de dados no E3 e tambm para visualizar o uso da
ferramenta SQL Server Analyzer, que o cliente usado para consultas no
SQL Server.

460 Banco de Dados


6. Finalizada a configurao do Histrico, necessria a criao da estrutura
de tabelas no Servidor de Banco de Dados. Para isto, clique em Gerar
estrutura no BD . Uma mensagem de confirmao da criao da
estrutura de tabelas mostrada na tela. Caso haja algum erro, deve-se
localizar o problema.

7. Para visualizar o Histrico em ao (salvando dados no servidor SQL


Server), crie uma Tela, insira um E3Browser e configure-o para acessar o
Servidor de Banco de Dados, como explicado anteriormente no Histrico,
e configure o E3Browser para ser atualizado automaticamente a cada 10
segundos, por exemplo.

8. Aps as configuraes, execute o projeto. Depois de algum tempo, o


E3Browser passa a exibir os dados que esto sendo enviados ao servidor.

9. possvel consolidar os dados que so mostrados no E3 e os que esto


salvos no servidor utilizando o objeto Consulta do E3Browser e o software
SQL Query Analyzer. Para isto, crie diferentes consultas no Banco de
Dados e edite-as na Consulta e tambm no Query Analyzer. Os resultados
devem ser os mesmos, se o Domnio estiver parado, ou semelhantes, se o
Domnio estiver executando. Esta diferena deve-se atualizao
constante do Banco de Dados quando o Domnio est sendo executado.
Para a edio de consultas no objeto Consulta, habilite a opo Habilita
edio direta do SQL.

12.3.3 Uso de ADODB para Acesso via Script


Para acesso ao SQL Server atravs de scripts, usa-se uma conexo ADODB. A
String de conexo a este tipo de Banco de Dados deve ser configurada
conforme o modelo a seguir:
DRIVER={SQL Server};SERVER=server;UID=login_id;PWD=password;

O uso deste tipo de acesso deve ser restrito a casos onde no exista outra
soluo. O E3 disponibiliza recursos que visam minimizar o uso destes
acessos via script. Entretanto, eventualmente o uso deste recurso pode ser
necessrio.

Banco de Dados 461


12.4 Objetos do E3 e Permisses
necessrio configurar as permisses no Banco de Dados para a utilizao
dos objetos do E3 em um projeto. Estas permisses esto listadas na tabela a
seguir.

Opes disponveis para permisses

OBJETO PERMISSO
Frmulas Permisso completa

Histrico de usurio Escreve e consulta as tabelas


existentes

Histrico Permisso completa

Servidor de Alarmes Permisso completa

Nas permisses, a expresso Permisso completa significa que o usurio


tem permisses para:

Criar ou remover tabelas existentes

Criar ndices e chaves

Inserir e excluir dados nas tabelas criadas

Realizar consultas sobre as tabelas resultantes

O usurio no precisa ser um Administrador para possuir Permisso completa


em qualquer objeto.

462 Banco de Dados


CAPTULO
Alarmes
13
O E3 dispe de um conjunto de objetos que permite ao usurio monitorar
alarmes em uma aplicao. Com eles possvel especificar e gerenciar
alarmes e eventos de variveis de um processo. As condies de alarme
podem ser gerenciadas em diversas fontes. O sistema composto de um
objeto centralizador de alarmes, chamado Servidor de Alarmes, e de um ou
mais objetos de configurao, chamado Configurao de Alarmes. Os
tpicos a seguir detalham estes objetos.

Alarmes 463
13.1 Configurao de Alarmes
O objeto Configurao de Alarmes o local onde as reas so inseridas e
organizadas. Para inserir este objeto em um projeto, siga este procedimento:

1. Clique com o boto direito do mouse no nome do projeto no modo


Explorer e selecione a opo Inserir - Configurao de Alarmes. No
modo Domnio, clique com o boto direito do mouse no item Objetos de
Servidor - Alarmes, selecione a opo Inserir Configurao de Alarmes
em e logo aps o nome do projeto.

Inserindo o objeto Configurao de Alarmes

464 Alarmes
NOTAS
Todas as opes do editor de objetos da Configurao de Alarmes e das
reas de Alarme que esto disponveis via menu contextual (atravs do
clique com o boto direito do mouse) tambm esto disponveis utilizando
a combinao de teclas SHIFT + F10, que corresponde tecla de aplicao
ou de menu .
A janela de propriedades dos objetos da Configurao de Alarmes e das
reas de Alarme no editor de objetos pode ser aberta utilizando as
combinaes de teclas ALT + ENTER, CTRL + ALT + ENTER ou ALT +
duplo-clique do mouse.

Alarmes 465
13.1.1 reas de Alarme
As reas de Alarme permitem agrupar um conjunto de Fontes de Alarmes,
bem como outras reas. Isto facilita o gerenciamento, a operao e o
monitoramento de um conjunto de Fontes de Alarme relacionadas, como por
exemplo:

Filtrar o conjunto de alarmes visveis no sumrio

Habilitar ou desabilitar um conjunto de Fontes de Alarmes

Reconhecer um conjunto de Fontes de Alarmes

Verificar o total de alarmes ativos ou no reconhecidos de um conjunto


de Fontes de Alarmes

Caso haja necessidade, novas reas podem ser inseridas dentro de outras.
Para inserir este objeto, siga este procedimento:

1. Clique com o boto direito do mouse no objeto Configurao de Alarmes


ou no objeto rea do projeto no modo Explorer e selecione a opo
Inserir - rea. No modo Domnio, clique com o boto direito do mouse
no objeto Configurao de Alarmes e selecione o item Inserir - rea.

466 Alarmes
Inserindo uma rea de Alarme

Algumas das propriedades deste objeto podem ser configuradas atravs da


Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso
necessite configurar alguma propriedade, localize-a na Lista de Propriedades
e faa os devidos ajustes. Demais informaes sobre as funcionalidades das
propriedades deste objeto podem ser encontradas no Manual de Referncia
e Scripts do E3, em seu captulo respectivo.

Alarmes 467
13.1.1.1 Objetos de Servidor como reas de Alarme

Objetos de Servidor tm a possibilidade de se comportarem como reas de


Alarme. Estes objetos agora possuem uma aba adicional, rea de Alarmes,
onde este comportamento pode ser habilitado e configurado. A figura a
seguir mostra esta aba em um Driver de Comunicao.

Aba rea de Alarmes

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

Opes disponveis na aba rea de Alarmes

OPO DESCRIO
Funcionar como rea de alarmes Habilita ou desabilita o
comportamento de rea de Alarme
para o objeto de Servidor. Esta
opo corresponde propriedade
IsAlarmArea

468 Alarmes
OPO DESCRIO
Verificar alarmes Habilita ou desabilita a verificao de
alarmes no objeto. Esta opo
corresponde propriedade
AlarmVerify

Campos do usurio Veja o tpico Configuraes dos


Campos do Usurio para maiores
informaes

As seguintes propriedades ficam disponveis no objeto de Servidor:

ActiveAlarms

ActiveHighAlarms

ActiveHighNACKAlarms

ActiveLowAlarms

ActiveLowNACKAlarms

ActiveMedAlarms

ActiveMedNACKAlarms

ActiveNACKAlarms

Alarm

AlarmVerify

UserFields

Alarmes 469
13.2 Filtro de Alarmes
O objeto Filtro de Alarmes permite especificar filtros de alarmes da mesma
forma que o E3Alarm, exceto que no possui uma representao grfica que
possa ser mostrada em Tela. Ao invs disto, o resultado da filtragem pode
ser consumido atravs dos diversos contadores de alarmes ou da coleo de
eventos.

NOTAS
O objeto Filtro de Alarmes pode ser inserido em uma Tela, no Viewer, em
uma Pasta do Viewer ou em uma Pasta de Dados.
No possvel reconhecer alarmes utilizando o objeto Filtro de Alarmes.

Para inserir este objeto em uma Tela, por exemplo, siga este procedimento:

1. Clique com o boto direito do mouse em uma Tela e selecione a opo


Inserir - Standard - Filtro de Alarmes.

470 Alarmes
Opo Inserir - Standard - Filtro de Alarmes

Algumas das propriedades deste objeto podem ser configuradas atravs da


Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso
necessite configurar alguma propriedade, localize-a na Lista de Propriedades
e faa os devidos ajustes.

13.2.1 Configurao
Para configurar um Filtro de Alarmes, clique com o boto direito do mouse no
objeto e selecione a opo Propriedades.

Alarmes 471
13.2.1.1 Aba Conexes

A aba Conexes permite gerenciar as conexes do Filtro de Alarmes com


Servidores de Alarmes locais ou remotos.

Aba Conexes

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

Opes disponveis na aba Conexes

OPO DESCRIO
Adiciona uma nova Conexo ao Filtro
de Alarmes. Esta opo corresponde
ao mtodo Add da Coleo de
Conexes

472 Alarmes
OPO DESCRIO

Remove a Conexo selecionada. Esta


opo corresponde ao mtodo
Remove da Coleo de Conexes.
NOTA: A Conexo criada
automaticamente com o objeto no
pode ser removida

Nome conexo Nome desta Conexo. Pressione a


tecla F2 para editar este nome. Esta
opo corresponde propriedade
ConnectionName do objeto
Conexo na Coleo de Conexes

Nome servidor Nome amigvel para identificar o


Domnio do Servidor de Alarmes
selecionado. Esta opo corresponde
propriedade DomainName do
objeto Conexo na Coleo de
Conexes

Servidor de Alarmes Nome do Servidor de Alarmes, que


tanto pode estar em um Domnio
local quanto em um Domnio
Remoto. Esta opo corresponde
propriedade AlarmServer do objeto
Conexo na Coleo de Conexes.
Clique em para selecionar um
Servidor de Alarmes utilizando o
AppBrowser

Filtro conexo Nome de um Filtro que contm a


configurao do filtro de alarmes,
definido na aba Filtros. Esta opo
corresponde propriedade
FilterConnection do objeto Conexo
na Coleo de Conexes

Alarmes 473
13.2.1.2 Aba Filtros

A aba Filtros permite gerenciar os filtros do Filtro de Alarmes.

Aba Filtros

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

Opes disponveis na aba Filtros

OPO DESCRIO
Filtros Caixa de seleo com os Filtros
atualmente disponveis

Configurar Abre a janela de configurao do


Filtro selecionado, descrita a seguir

Adicionar Adiciona um novo Filtro Coleo de


Filtros. Esta opo corresponde ao
mtodo Add da Coleo de Filtros

474 Alarmes
OPO DESCRIO
Remover Remove o Filtro selecionado. Esta
opo corresponde ao mtodo
Remove da Coleo de Filtros.
NOTA: O Filtro criado
automaticamente com o objeto no
pode ser removido

Ao clicar em Configurar, a janela da figura a seguir aberta para


configurao do Filtro selecionado.

Propriedades do Filtro selecionado

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

Opes disponveis na janela de propriedades de um Filtro

Alarmes 475
OPO DESCRIO
Nome Nome deste Filtro. Esta opo
corresponde propriedade
FilterName

Filtrar por rea de Alarme Determina o filtro por rea de


Alarme. Caso deseje utilizar algum
filtro, especifique-o neste campo,
seno deixe-o em branco. Esta
opo equivale propriedade
AreaFilter

Filtro de rea Simples Se a opo Filtrar por rea de


Alarme no estiver em branco, esta
opo habilitada e, se estiver
selecionada, a filtragem por rea
baseada apenas na coincidncia da
parte inicial do nome. Caso contrrio,
considera o nome completo da rea.
Esta opo equivale propriedade
SimpleAreaFilter

Utilizar filtro customizado Permite informar um filtro


personalizado para os alarmes. Esta
opo corresponde propriedade
CustomFilter

Filtrar por tipo Habilita o tipo de filtro que


aplicado no alarme (Apenas
alarmes, Apenas eventos ou
Alarmes e Eventos). Esta opo
equivale propriedade FilterType

Filtrar por severidade Habilita ou desabilita a visualizao


do grau da severidade (Alta, Mdia
ou Baixa). Esta opo equivale s
propriedades ShowHightPriority
(Alta), ShowMediumPriority (Mdia)
e ShowLowPriority (Baixa)

476 Alarmes
13.2.1.3 Aba Ordenao

A aba Ordenao permite configurar a ordenao padro dos alarmes.


Quando mais de um campo de ordenao for usado, os campos
subsequentes permitem a ordenao entre alarmes que tenham o(s)
mesmo(s) valor(es) para o(s) campo(s) anterior(es).

Aba Ordenao

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

Opes disponveis na aba Ordenao

OPO DESCRIO
Pelo campo Ordena os alarmes conforme o
campo especificado. Esta opo
equivale propriedade
PrimarySortField. A ordenao
padro feita atravs do campo
InTime, de maneira descendente

Alarmes 477
OPO DESCRIO
Depois por Ordena os alarmes a partir do item
especificado na opo Pelo campo.
O prximo item ordenado a partir
da especificao indicada nos
campos Depois por. Estas opes
equivalem s propriedades
SecondarySortField, ThirdSortField
e FourthSortField, respectivamente

Ascendente Ordena os campos do alarme de


forma ascendente. Estas opes
equivalem s propriedades
PrimarySortAscending,
SecondarySortAscending,
ThirdSortAscending e
FourthSortAscending em
Verdadeiro, respectivamente.

Descendente Ordena os campos do alarme de


forma descendente. Estas opes
equivalem s propriedades
PrimarySortAscending,
SecondarySortAscending,
ThirdSortAscending e
FourthSortAscending em Falso,
respectivamente

478 Alarmes
13.3 Fontes de Alarme
Todas as informaes relativas s condies de alarme so definidas nas
Fontes de Alarmes, bem como os tipos de eventos que devem ser gerados
em cada condio. As Fontes de Alarme sempre contm uma expresso de
alarme (fonte de dados), cujo valor pode ser verificado de acordo com as
diversas condies disponveis. Estas fontes so Alarme Analgico, Alarme
de Banda Morta, Alarme de Taxa de Variao, Alarme Digital e Alarme
Discreto.

NOTA
O objeto Fonte de Alarme pode ser criado dentro de qualquer objeto do
Servidor.

Para inserir este objeto, siga este procedimento:

1. Clique com o boto direito do mouse no objeto de Servidor no modo


Explorer e selecione a opo Inserir - Alarme (Analgico, Banda Morta,
Taxa de Variao, Digital ou Discreto). No modo Domnio, selecione o
objeto desejado no item Objetos de Servidor e selecione a opo Inserir
- Alarme (Analgico, Banda Morta, Taxa de Variao, Digital ou
Discreto).

Alarmes 479
Inserindo uma Fonte de Alarme

Algumas das propriedades deste objeto podem ser configuradas atravs da


Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso
necessite configurar alguma propriedade, localize-a na Lista de Propriedades
e faa os devidos ajustes. Demais informaes sobre as funcionalidades das
propriedades deste objeto podem ser encontradas no Manual de Referncia
e Scripts do E3, em seu captulo respectivo.

Em cada sub-condio de alarme so configurados seus limites, a mensagem


relativa ao evento, sua severidade e a necessidade ou no de reconhecimento
deste evento.

480 Alarmes
Fontes de Alarmes

Ao abrir a janela de Propriedades de qualquer Fonte de Alarme e selecionar a


aba Fonte, a janela mostrada na figura a seguir aberta.

Aba Fonte

Para tratar o alarme como evento, ou para que o alarme possa ser
reconhecido duplamente (tanto quando estiver ativo como quando passar
para inativo), clique na caixa de seleo correspondente. Todas as Fontes de
Alarme possuem as seguintes propriedades gerais:

Alarmes 481
Texto da Mensagem: Esta mensagem armazenada no campo
Mensagem do evento de alarme enquanto ele estiver ativo, ou seja, pode
ser visualizada no E3Alarm (sumrio de alarmes), armazenada no Banco
de dados, etc. O limite do texto da mensagem de 200 caracteres

Severidade: Indica a gravidade do alarme ocorrido (Baixa, Mdia ou


Alta). O campo Severidade utilizado para realizao de filtros e
ordenao nas mensagens

Pede Ack: Indica se o alarme deve ser reconhecido pelo operador para
ser retirado da lista de alarmes no E3Alarm, ou se reconhecido
automaticamente quando a varivel deixa uma condio de alarme

Volta ao normal: Esta mensagem armazenada no campo Mensagem


do evento de alarme enquanto este estiver inativo, ou seja, pode ser
visualizada no E3Alarm (sumrio de alarmes), armazenada em um Banco
de Dados, etc.

H vrios tipos de Fontes de Alarme que podem ser inseridas em objetos do


Servidor. As opes disponveis esto descritas nos prximos tpicos.

482 Alarmes
13.3.1 Alarme Analgico
Permite monitorar uma varivel analgica pela especificao de at quatro
nveis de alarme, que so LoLo (Muito Baixo), Lo (Baixo), Hi (Alto) e HiHi
(Muito Alto).

Aba Analgico

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

Opes disponveis na aba Analgico

OPO DESCRIO
Habilitao (LoLo, Lo, Hi, HiHi) Habilita a verificao do tipo de
alarme selecionado

Limite Indica o nvel em que o alarme


disparado

Texto da mensagem Permite especificar o texto que


mostrado para o usurio quando o
alarme estiver em condio ativa

Alarmes 483
OPO DESCRIO
Severidade Determina a severidade do nvel de
alarme (pode ser Alta, Mdia ou
Baixa)

Pede Ack Habilita ou desabilita o


reconhecimento do alarme

Evento Habilita ou desabilita o tratamento


de cada sub-condio do alarme
como um evento

Espera Especifica o tempo de espera, em


milissegundos. Quando o valor for
igual a 0 (zero, padro), no
aplicada nenhuma espera

Banda morta Habilita a banda morta, que um


recurso utilizado para evitar que uma
varivel, ao manter uma pequena
oscilao em torno de um limite de
alarme, gere uma quantidade
desnecessria de mensagens

Volta ao normal Permite especificar o texto a ser


mostrado para o usurio quando o
alarme no estiver em condio ativa

484 Alarmes
13.3.2 Alarme de Banda Morta
Permite monitorar uma varivel analgica pela especificao de um limite
mximo de diferena (valor de banda morta), em relao a um valor de
referncia (SetPoint).

Banda morta

Este tipo de alarme interessante quando a referncia (SetPoint) varivel, e


tambm quando se deseja evitar uma quantidade desnecessria de alarmes
para pequenas oscilaes da varivel monitorada.

Alarmes 485
Aba Banda Morta

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

Opes disponveis na aba Banda Morta

OPO DESCRIO
SetPoint Associao para a varivel de
referncia, para que seja monitorada
uma diferena em relao varivel
de monitoramento

BM Habilita a banda morta, que um


recurso utilizado para evitar que uma
varivel, ao manter uma pequena
oscilao em torno de um limite de
alarme, gere uma quantidade
desnecessria de mensagens

486 Alarmes
OPO DESCRIO
Valor Indica a diferena entre a varivel
monitorada e o SetPoint, a partir do
qual deve ser indicado o alarme.
Deve ser informado em unidades de
engenharia da varivel monitorada

Texto da mensagem Permite especificar o texto que


mostrado para o usurio quando o
alarme estiver em condio ativa

Severidade Determina a severidade do nvel de


alarme (pode ser Alta, Mdia ou
Baixa)

Pede Ack Habilita ou desabilita o


reconhecimento do alarme

Espera (ms) Especifica o tempo de espera, em


milissegundos. Quando o valor for
igual a 0 (zero, padro), no
aplicada nenhuma espera

Volta ao normal Permite especificar o texto a ser


mostrado para o usurio quando o
alarme no estiver em condio ativa

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

Aba Taxa de Variao

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Taxa de Variao

OPO DESCRIO
TDV Habilita a verificao do alarme Taxa
de Variao

488 Alarmes
OPO DESCRIO
Variao/segundo Indica a porcentagem da varivel
monitorada que pode variar por
segundo. Este valor calculado
tomando como base cada intervalo
de leitura da varivel, pela frmula
TDV = (Valor Atual - Valor
Anterior) / (Instante Atual -
Instante Anterior). Se a taxa de
variao for maior que a taxa
especificada, considerado em
estado de alarme

Texto da mensagem Permite especificar o texto que


mostrado para o usurio quando o
alarme estiver em condio ativa

Severidade Determina a severidade do nvel de


alarme (pode ser Alta, Mdia ou
Baixa)

Pede Ack Habilita ou desabilita o


reconhecimento do alarme

Espera (ms) Especifica o tempo de espera, em


milissegundos. Quando o valor for
igual a 0 (zero, padro), no
aplicada nenhuma espera

Volta ao normal Determina a mensagem de texto que


mostrada ao usurio quando o
alarme voltar ao estado normal

Alarmes 489
13.3.4 Alarme Digital
Permite monitorar uma varivel digital pela especificao de alarme na borda
de subida (em -1 ou Verdadeiro) ou na borda de descida (em 0 ou Falso).

Aba Digital

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Digital

OPO DESCRIO
Alarme Digital Habilita o alarme digital

Valor Determina o valor Booleano do


alarme (Verdadeiro ou Falso)

Texto da mensagem Permite especificar o texto que


mostrado para o usurio quando o
alarme estiver em condio ativa

490 Alarmes
OPO DESCRIO
Severidade Determina a severidade do nvel de
alarme (pode ser Alta, Mdia ou
Baixa)

Pede Ack Habilita ou desabilita o


reconhecimento do alarme

Espera (ms) Especifica o tempo de espera, em


milissegundos. Quando o valor for
igual a 0 (zero, padro), no
aplicada nenhuma espera

Volta ao normal Permite especificar o texto a ser


mostrado para o usurio quando o
alarme no estiver em condio ativa

Alarmes 491
13.3.5 Alarme Discreto
Permite monitorar uma varivel pela especificao de mltiplas sub-condies.

Aba Discreto

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Discreto

OPO DESCRIO
Adiciona uma nova Sub-condio no
alarme

Remove a Sub-condio selecionada

492 Alarmes
OPO DESCRIO
Mapear todas as subcondies Permite mapear e sincronizar as Sub-
condies do Alarme a partir de
semnticas presentes no objeto
fonte. Este recurso atualmente s
suportado pelos objetos de servidor
do Elipse Power, portanto este
boto permanece desabilitado por
padro no Elipse E3

Nome Nome da Sub-condio

Habilitado Habilita ou desabilita a Sub-condio

Descrio Descrio da Sub-condio

Valor Valor avaliado para determinar se o


alarme ocorre ou no

Texto da mensagem Mensagem mostrada quando a Sub-


condio est ativa

Tipo Comportamento da Sub-condio.


Pode assumir os valores 0: Alarme,
1: Evento ou 2: Retorno

Severidade O tipo de severidade da Sub-


condio. Pode assumir os valores 0:
Alta, 1: Mdia ou 2: Baixa

Pede Ack? Indica se esta Sub-condio exige


reconhecimento

Espera (ms) Especifica o tempo de espera, em


milissegundos. Quando o valor for
igual a 0 (zero, padro), no
aplicada nenhuma espera

Alarmes 493
OPO DESCRIO
Volta ao normal Permite especificar o texto a ser
mostrado para o usurio quando o
alarme no estiver em condio ativa

494 Alarmes
13.4 Servidor de Alarmes
O objeto Servidor de Alarmes centraliza todos os alarmes do projeto. Nele
podem ser encontrados todos os alarmes ativos da aplicao, reconhecidos
ou no. Este objeto tambm responsvel por reportar os eventos de alarme
para todos os Viewers conectados, bem como enviar estes eventos para um
banco de dados, se necessrio.

Uma aplicao s pode ter um objeto deste tipo, e sua presena


obrigatria para que a verificao de alarmes ocorra. Para inserir um Servidor
de Alarmes, siga este procedimento:

1. Clique com o boto direito do mouse no projeto no modo Explorer e


selecione a opo Inserir - Servidor de Alarmes. No modo Domnio,
clique com o boto direito do mouse no item Objetos de Servidor -
Alarmes, selecione a opo Inserir Servidor de Alarmes em e logo aps
o nome do projeto desejado.

Inserindo um Servidor de Alarmes no modo Domnio

Alarmes 495
13.4.1 Configuraes para Gerao da Tabela de
Alarmes
Para especificar as configuraes do Servidor de Alarmes, clique com o boto
direito do mouse no objeto e selecione a opo Propriedades.

Na aba Configurao, possvel especificar as configuraes de Banco de


Dados e determinar campos para a gerao da tabela de alarmes.

Aba Configurao

Cada campo da aba Configurao possui uma propriedade correspondente.


As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Configurao

496 Alarmes
OPO DESCRIO
Armazenar alarmes em banco de Habilita ou desabilita o
dados armazenamento dos dados dos
alarmes em um banco de dados.
Este campo equivale propriedade
Logging

Servidor de Banco de Dados Define o servidor de Banco de Dados


que armazena os dados do alarme.
Este campo equivale propriedade
DataSource

Nome da tabela Define o nome da tabela de alarmes.


Este campo equivale propriedade
TableName

Descartar dados da tabela principal Habilita ou desabilita o descarte de


dados da tabela principal. O dado
considerado antigo de acordo com o
que for definido na opo Descartar
dados mais antigos que. Este
campo equivale propriedade
EnableDiscard

Descartar dados mais antigos que Determina o intervalo de tempo


(minutos, horas, dias ou meses)
durante o qual os dados so
mantidos na tabela principal. Se um
dado da tabela for mais antigo que
o intervalo de tempo desta opo,
ele descartado. Este campo
equivale propriedade
DiscardInterval e o campo de
seleo da unidade de tempo do
intervalo equivale propriedade
DiscardTimeUnit

Alarmes 497
OPO DESCRIO
Realizar o descarte a cada Executa a verificao dos alarmes,
conforme o perodo especificado no
campo (em minutos, horas, dias ou
meses). Este campo equivale
propriedade VerificationInterval e o
campo de seleo da unidade de
tempo do intervalo equivale
propriedade VerificationUnit

Mover para a tabela de backup os Habilita ou desabilita o


dados descartados armazenamento dos dados
descartados na tabela secundria
(tabela de backup). Este campo
equivale propriedade
EnableBackupTable

Descartar do backup dados mais Determina o intervalo mximo de


antigos que tempo (minutos, horas, dias ou
meses) dos dados na tabela de
backup at serem descartados,
independente do tempo que os
dados permanecem na tabela
principal. Por exemplo, para manter
os dados por 24 meses na tabela
principal e mais seis meses na tabela
de backup, o valor desta opo deve
ser de 30 meses. Este intervalo deve
ser sempre maior que o configurado
no item Descartar dados mais
antigos que da tabela principal. Este
campo equivale propriedade
BackupDiscardInterval e o campo
de seleo da unidade de tempo do
intervalo equivale propriedade
BackupDiscardTimeUnit

Campos Determina quais campos dos eventos


de alarme so adicionados tabela
de alarmes, e qual a ordem em que
estas colunas aparecem

498 Alarmes
OPO DESCRIO
Gerar Tabela Gera a tabela dos alarmes no Banco
de Dados especificado

Os campos disponveis no Servidor de Alarmes para gerao da tabela de


alarmes esto descritos na tabela a seguir.

Campos disponveis para tabelas dos Campos dos alarmes

OPO DESCRIO
Acked Informa se o alarme foi reconhecido
ou no. Este campo pode assumir os
valores 0: No reconhecido ou 1:
Reconhecido

AckRequired Determina o reconhecimento


automtico do alarme. Este campo
apresenta os valores 0:
Reconhecimento automtico ou 1:
Reconhecimento manual

AckTime Registra a data e hora do E3 no


momento em que o alarme
reconhecido, ou zero (30/12/1899)
enquanto o alarme no for
reconhecido. No caso de alarmes que
no pedem reconhecimento, o campo
assume a data e hora do E3 no
momento em que o alarme se torna
ativo

AckTimeDbl Semelhante ao campo anterior.


usado para facilitar a gravao de
dados do tipo Double no caso de
bancos de dados Oracle ou SQL
Server

Alarmes 499
OPO DESCRIO
ActorID Nome do operador que reconheceu o
alarme. Pode ser:

O usurio logado no Viewer,


quando o reconhecimento feito no
E3Alarm (ou "Sem usurio", se no
h usurio logado)

"System", quando o reconhecimento


automtico, ou seja, para alarmes
que no pedem reconhecimento

Um nome passado por script (por


exemplo, usando AckArea,
AckAllAlarms ou
LogTrackingEvent do Servidor de
Alarmes, ou Ack da Fonte de
Alarmes)

O limite deste campo, quando


armazenado no Banco de Dados, de
50 caracteres

AlarmSourceName Registra o nome da Fonte de Alarme.


O limite deste campo, quando
armazenado no Banco de Dados, de
100 caracteres

Area Para eventos de alarme, o nome da


rea qual a Fonte de Alarmes
pertence. Para outros eventos (por
exemplo, usando o mtodo
LogTrackingEvent do Servidor de
Alarmes), pode ser um texto definido
pelo usurio. O limite deste campo,
quando armazenado no Banco de
Dados, de 100 caracteres

ChangeMask No usado e seu valor sempre 0


(zero)

500 Alarmes
OPO DESCRIO
ConditionActive Indica se a Fonte de Alarme est em
alarme. Este campo apresenta os
estados 0: Condio no ativa ou 1:
Condio ativa

ConditionName Nome da condio, se for um evento


de alarme. Este campo pode
apresentar os seguintes valores:

Banda Morta: Fonte de Alarme do


tipo Banda Morta

Digital: Fonte de Alarme do tipo


Digital

Nvel: Fonte de Alarme do tipo


Analgico

TaxaDeVariao: Fonte de Alarme


do tipo Taxa de Variao

Se o evento no for um alarme (por


exemplo, usando o mtodo
LogTrackingEvent do Servidor de
Alarmes), este valor sempre uma
String vazia.O limite deste campo,
quando armazenado no Banco de
Dados, de 100 caracteres

Cookie Valor associado Fonte de Alarme,


usado internamente pelo Servidor de
Alarmes

Alarmes 501
OPO DESCRIO
CurrentValue Determina o valor da Fonte de Alarme
(convertido para Double) no
momento do evento. Para outros
eventos (por exemplo, usando o
mtodo LogTrackingEvent), o valor
sempre 0 (zero). O limite deste
campo, quando armazenado no Banco
de Dados, de 100 caracteres

Deleted Determina se este alarme foi


removido. Um alarme s pode ser
removido se o campo Unbound
estiver configurado como Verdadeiro

Enabled Determina se a verificao do alarme


est habilitada. Este campo apresenta
os estados 0: Verificao da fonte de
alarmes desabilitada ou 1:
Verificao da fonte de alarme
desabilitada

502 Alarmes
OPO DESCRIO
EventCategory Categoria do evento. Para alarmes,
este campo pode assumir os
seguintes valores:

Banda Morta: Fonte de Alarme do


tipo Banda Morta

Digital: Fonte de Alarme do tipo


Digital

Nvel: Fonte de Alarme do tipo


Analgico

TaxaDeVariao: Fonte de Alarme


do tipo Taxa de Variao

Para outros eventos (por exemplo,


usando o mtodo LogTrackingEvent
do Servidor de Alarmes), o campo
pode assumir valores definidos pelo
usurio. O limite deste campo, quando
armazenado no Banco de Dados, de
100 caracteres

EventCLSID Identificador nico para toda a vida


de um alarme. Quando um alarme
novo ocorre em uma Fonte, gerado
um novo nmero de EventCLSID.
Assim, ele mantm este mesmo CLSID
no banco de dados enquanto no sair
da lista de alarmes ativos e no
reconhecidos

EventTime Data e hora do valor da Fonte de


Alarme no momento do evento

Alarmes 503
OPO DESCRIO
EventTimeDbl Semelhante ao campo anterior.
usado para facilitar a gravao de
dados do tipo Double no caso de
bancos de dados Oracle ou SQL
Server

EventTimeUTC Data e hora do valor da Fonte de


Alarme no momento do evento, com
relao ao horrio de Greenwich. O
valor o mesmo do campo
EventTime, sendo mantido no E3 por
questes de compatibilidade

EventType Tipo do evento. Para eventos de


alarme, sempre Condition. Para
outros eventos, pode ser um texto
definido pelo usurio, como por
exemplo usando o mtodo
LogTrackingEvent do Servidor de
Alarmes ("Tracking", "Simple", etc.). O
limite deste campo, quando
armazenado no Banco de Dados, de
100 caracteres

FormattedValue Mostra o valor formatado da Fonte de


Alarme que vai para o seu evento. O
limite deste campo, quando
armazenado no Banco de Dados, de
100 caracteres. NOTA: Este campo
somente de leitura

FullAlarmSourceName Registra o caminho completo da Fonte


de Alarme, incluindo reas, nome da
Configurao de Alarmes e de
possveis Pastas onde esta possa
estar inserida. Por exemplo,
Pasta1.ConfigAlarmes1.Area1.Fonte
Alarme1

504 Alarmes
OPO DESCRIO
InTime Registra a data e hora do valor, no
momento em que ele entra na
condio de alarme

InTimeDbl Semelhante ao campo anterior.


usado para facilitar a gravao de
dados do tipo Double no caso de
bancos de dados Oracle ou SQL
Server

Message o texto configurado na Fonte de


Alarme, ou especificado por um outro
evento (por exemplo, usando o
mtodo LogTrackingEvent do
Servidor de Alarmes). O limite deste
campo, quando armazenado no Banco
de Dados, de 200 caracteres

OutTime Registra a data e hora do valor no


momento em que ele sai da condio
de alarme, ou zero (30/12/1899) caso
o alarme ainda no tenha sado da
condio ativa

OutTimeDbl Semelhante ao campo anterior.


usado para facilitar a gravao de
dados do tipo Double no caso de
bancos de dados Oracle ou SQL
Server

Alarmes 505
OPO DESCRIO
Quality Qualidade do valor de Fonte de
alarme no momento do evento. Este
campo assume os seguintes valores
numricos:

0 - 63: Qualidade ruim

64 - 127: Qualidade incerta

128 - 191: Valor no definido

192 - 255: Qualidade boa

Se o evento no for um alarme (por


exemplo, ao utilizar o mtodo
LogTrackingEvent do Servidor de
Alarmes), este campo igual a uma
String vazia. Exemplo: Ruim (0);
Incerta (64); ?? (128); Boa (192)

Severity o valor de severidade configurado


na Fonte de Alarme. Este campo pode
assumir os valores 0: Alta, 1: Mdia
ou 2: Baixa. Ele pode tambm assumir
outro valor definido pelo usurio se
for um evento, como por exemplo
quando estiver usando o mtodo
LogTrackingEvent

Source Para eventos de alarme, informa a


expresso utilizada para avaliar as
condies de alarme. O limite deste
campo, quando armazenado no Banco
de Dados, de 100 caracteres

506 Alarmes
OPO DESCRIO
SubConditionName Nome da sub-condio, se for um
evento de alarme. Este campo pode
assumir os seguintes valores:

BM: Alarme de Banda Morta

DIG: Alarme Digital

TV: Alarme Taxa de Variao

LOLO: Alarme Analgico na faixa


Muito Baixo

LO: Alarme Analgico na faixa Baixo

HI: Alarme Analgico na faixa Alto

HIHI: Alarme Analgico na faixa


Muito Alto

Se o evento no for um alarme (por


exemplo, ao utilizar o mtodo
LogTrackingEvent do Servidor de
Alarmes), este campo igual a uma
String vazia. O limite deste campo,
quando armazenado no Banco de
Dados, de 100 caracteres

Unbound Indica se este alarme no est


vinculado a uma Fonte de Alarme

Campos do Usurio So os campos definidos pelo


usurio. Estes campos so
configurados na aba Campos do
usurio, no Servidor de Alarmes

Alarmes 507
NOTAS
necessrio que haja um Servidor de Alarmes no Domnio para que seja
possvel o monitoramento de alarmes.
Os campos EventTimeMS, InTimeMS, OutTimeMS e AckTimeMS contm
os valores em milissegundos dos campos EventTime, InTime, OutTime e
AckTime, respectivamente. Estes campos so usados quando for
necessrio registrar o tempo, em milissegundos, dos eventos em um
servidor de bancos de dados Oracle. Observe que estes campos no
esto disponveis no E3Alarm, pois neste objeto possvel visualizar os
milissegundos atravs da formatao das colunas de data e hora.

Depois de definidas todas as configuraes, a aplicao inicializa a insero e


gravao das informaes na tabela dos alarmes, conforme as especificaes
dos campos. Ao clicar em Gerar tabela, o Studio gera a tabela de dados dos
alarmes conforme as especificaes, e informa se a tabela foi gerada com
sucesso.

Mensagem do Servidor de Alarmes

A estrutura da tabela dos alarmes semelhante do Histrico, composta por


uma tabela de definies, uma tabela principal de dados e uma tabela de
backup (opcional).

508 Alarmes
Tabela de campos

Os campos gerados na tabela so explicados no tpico Configuraes da


Tabela do captulo Histrico.

Atravs da janela de configurao do Servidor de Alarmes, pode-se


especificar o Servidor de Banco de Dados utilizado para a gravao dos
alarmes. O Servidor de Banco de Dados (objeto DBServer) um mdulo do
E3 que deve ser inserido na aplicao.

Alarmes 509
13.4.2 Configuraes dos Campos do Usurio
Na aba Campos do usurio pode-se adicionar valores arbitrrios aos
eventos de alarmes.

Aba Campos do usurio

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Campos do usurio

OPO DESCRIO
Nome Determina o nome do Campo

Tipo Determina o tipo do Campo (0:


String, 1: Integer, 2: Double ou 3:
DateTime)

Tamanho Determina o tamanho do Campo

Fonte Determina a fonte de dados do


Alarme

510 Alarmes
OPO DESCRIO
Propagar? Fora a atualizao imediata de
todos os alarmes que herdam o
valor deste Campo do Usurio,
sempre que este receber um valor
forado ou se a Associao for
alterada

Adiciona um Campo do Usurio ao


final da listagem

Remove o ltimo Campo do Usurio


da listagem

Alarmes 511
Campos do Usurio s podem ser includos ou excludos ao final da listagem.
A excluso de Campos de Usurio nesta listagem se reflete em todas as reas
e Fontes de Alarmes relacionadas a este Servidor de Alarmes, mas apenas se
os Campos removidos no tenham sido configurados com um valor forado
ou uma Associao. Do contrrio, estes Campos continuam aparecendo nas
reas e Fontes de Alarme. A figura a seguir mostra um Alarme Analgico com
os Campos do Usurio herdados do Servidor de Alarmes.

Campos do Usurio herdados

NOTA
Para mais informaes sobre o comportamento de um Campo do Usurio
de reas e Fontes de Alarme, tanto em Studio quanto em tempo de
execuo, verifique as propriedades Link, Value e ValueSource no Manual
de Referncia e Scripts do E3.

512 Alarmes
CAPTULO
E3Alarm
14
O E3Alarm serve para monitoramento dos alarmes ativos ou no
reconhecidos em uma aplicao. Atravs deste objeto, possvel verificar o
estado dos alarmes, bem como reconhec-los manualmente.

E3Alarm

Para utilizar este objeto, siga este procedimento:

1. Clique com o boto direito do mouse em uma Tela ou na rea de


trabalho e selecione a opo Inserir - E3Alarm, ou ento clique em
E3Alarm na barra de ferramentas Objetos.

E3Alarm 513
Inserindo um E3Alarm na Tela

Algumas das propriedades deste objeto podem ser configuradas atravs da


Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso
necessite configurar alguma propriedade, localize-a na Lista de Propriedades
e faa os devidos ajustes.

14.1 Configuraes
Para configurar o E3Alarm, clique com o boto direito do mouse no objeto e
selecione a opo Propriedades.

514 E3Alarm
14.1.1 Aba Conexes
A aba Conexes permite configurar uma ou mais conexes a Servidores de
Alarmes locais ou remotos.

Aba Conexes

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Conexes

OPO DESCRIO
Adiciona uma nova Conexo ao
E3Alarm. Esta opo corresponde ao
mtodo Add da Coleo de
Conexes

E3Alarm 515
OPO DESCRIO

Remove a Conexo selecionada. Esta


opo corresponde ao mtodo
Remove da Coleo de Conexes.
NOTA: A Conexo criada
automaticamente com o E3Alarm no
pode ser removida

Nome conexo Nome desta Conexo. Pressione a


tecla F2 para editar este nome. Esta
opo corresponde propriedade
ConnectionName do objeto
Conexo na Coleo de Conexes

Domnio Nome amigvel para identificar o


Domnio do Servidor de Alarmes
selecionado. Esta opo corresponde
propriedade DomainName do
objeto Conexo na Coleo de
Conexes

Servidor de Alarmes Nome do Servidor de Alarmes, que


tanto pode estar em um Domnio
local quanto em um Domnio
Remoto. Esta opo corresponde
propriedade AlarmServer do objeto
Conexo na Coleo de Conexes.
Clique em para selecionar um
Servidor de Alarmes utilizando o
AppBrowser

Filtro conexo Nome de um Filtro que contm a


configurao do filtro de alarmes,
definido na aba Filtros. Esta opo
corresponde propriedade
FilterConnection do objeto Conexo
na Coleo de Conexes

516 E3Alarm
possvel acessar um Servidor de Alarmes remoto simplesmente
preenchendo a propriedade AlarmServer do objeto Conexo na Coleo de
Conexes do E3Alarm com os dados do Domnio e do Servidor de Alarmes
remotos, no formato DOMINIO:SERVIDOR, onde SERVIDOR o nome do
Servidor de Alarmes remoto e DOMINIO o nome do Domnio Remoto que
o contm. Para configurar o Domnio Remoto, veja o tpico Domnios
Remotos no captulo sobre Domnios.

14.1.2 Aba Filtros


A aba Filtros permite gerenciar os filtros do E3Alarm.

Aba Filtros

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Filtros

OPO DESCRIO
Filtros Caixa de seleo com os Filtros
atualmente disponveis

E3Alarm 517
OPO DESCRIO
Configurar Abre a janela de configurao do
Filtro selecionado, descrita a seguir

Adicionar Adiciona um novo Filtro Coleo de


Filtros. Esta opo corresponde ao
mtodo Add da Coleo de Filtros

Remover Remove o Filtro selecionado. Esta


opo corresponde ao mtodo
Remove da Coleo de Filtros.
NOTA: O Filtro criado
automaticamente com o E3Alarm no
pode ser removido

Ao clicar em Configurar, a janela da figura a seguir aberta para


configurao do Filtro selecionado.

518 E3Alarm
Propriedades do Filtro selecionado

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela de propriedades de um Filtro

OPO DESCRIO
Nome Nome deste Filtro. Esta opo
corresponde propriedade
FilterName

Filtrar por rea de Alarme Determina o filtro por rea de


Alarme. Caso deseje utilizar algum
filtro, especifique-o neste campo,
seno deixe-o em branco. Esta
opo equivale propriedade
AreaFilter

E3Alarm 519
OPO DESCRIO
Filtro de rea Simples Se a opo Filtrar por rea de
Alarme no estiver em branco, esta
opo habilitada e, se estiver
selecionada, a filtragem por rea
baseada apenas na coincidncia da
parte inicial do nome. Caso contrrio,
considera o nome completo da rea.
Esta opo equivale propriedade
SimpleAreaFilter

Utilizar filtro customizado Permite informar um filtro


personalizado para os alarmes. Esta
opo corresponde propriedade
CustomFilter

Filtrar por tipo Habilita o tipo de filtro que


aplicado no alarme (Apenas
alarmes, Apenas eventos ou
Alarmes e Eventos). Esta opo
equivale propriedade FilterType

Filtrar por severidade Habilita ou desabilita a visualizao


do grau da severidade (Alta, Mdia
ou Baixa). Esta opo equivale s
propriedades ShowHightPriority
(Alta), ShowMediumPriority (Mdia)
e ShowLowPriority (Baixa)

520 E3Alarm
14.1.3 Aba Colunas
Atravs da aba Colunas possvel selecionar os campos que so visualizados
no E3Alarm. Os campos mostrados nos itens Campos disponveis e Campos
selecionados so gerados pelo Servidor de Alarmes. Para mais informaes,
consulte a Tabela dos Campos dos Alarmes no tpico Configuraes para
Gerao da Tabela de Alarmes do captulo Alarmes.

Aba Colunas

A lista Campos disponveis mostra todos os campos da Fonte de Alarme.


Clicando em Adicionar, pode-se acrescentar campos individualmente no
E3Alarm. Clicando em Propriedades, possvel configurar as propriedades
do campo do alarme.

E3Alarm 521
Propriedades da coluna

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Propriedades da coluna

OPO DESCRIO
Largura (pixels) Determina a largura da coluna, em
pixels. A largura padro das colunas
do E3Alarm de 80 pixels

Formatador Determina o formatador utilizado na


coluna do E3Alarm. O formatador
utilizado o padro do E3 (veja o
tpico Formatao de Valores), com
exceo do campo Severidade e dos
campos Condio Ativa, Pede Ack,
Reconhecido e Habilitado, cujos
exemplos de formatao podem ser
vistos nas tabelas a seguir

Renomear para Renomeia o ttulo da coluna

522 E3Alarm
OPO DESCRIO
Permite reconhecer Permite configurar o reconhecimento
do alarme quando o usurio clicar na
linha da coluna configurada. As
opes disponveis so:

Nunca: O alarme no reconhecido


(padro)

Com clique: O alarme


reconhecido quando o usurio clica
na linha da coluna

Com clique-duplo: O alarme


reconhecido quando o usurio clica
duas vezes na linha da coluna

NOTA: Se o alarme puder ser


reconhecido, o formato do cursor do
mouse muda para , em tempo de
execuo, quando estiver sobre uma
linha de alarme no reconhecido

Esta coluna nunca pisca Habilita ou desabilita o piscar da


coluna

Formatador para o campo Severidade

DADO FORMATADOR SADA FORMATADA


Severidade Alta ;;; Alta

Severidade Mdia "A";"M";"B" M

Severidade Baixa ;;; Baixa

E3Alarm 523
Formatador para os campos Condio Ativa, Pede Ack, Reconhecido e
Habilitado

DADO FORMATADOR SADA FORMATADA


Verdadeiro "OK";"No OK" OK

Falso "OK";"No OK" No OK

Verdadeiro "AAA" AAA

Falso "AAA" No

Verdadeiro ; Sim

Falso ; No

Para remover algum campo indesejado, selecione-o e clique em Remover.

524 E3Alarm
14.1.4 Aba Ordenao
A aba Ordenao permite configurar a ordenao padro dos alarmes.
Quando mais de um campo de ordenao for usado, os campos
subsequentes permitem a ordenao entre alarmes que tenham o mesmo
valor para o(s) campo(s) anterior(es).

Aba Ordenao

Cada campo da aba Ordenao possui uma propriedade correspondente. As


propriedades disponveis esto descritas na tabela a seguir.

Opes disponveis na aba Ordenao

OPO DESCRIO
Pelo campo Ordena os alarmes conforme o
campo especificado. Este campo
equivale propriedade
PrimarySortField

E3Alarm 525
OPO DESCRIO
Depois por Ordena os alarmes a partir do item
especificado na opo Pelo campo.
O prximo item ordenado a partir
da especificao indicada nos
campos Depois por. Estes campos
equivalem s propriedades
SecondarySortField, ThirdSortField
e FourthSortField, respectivamente

Ascendente Ordena os campos do alarme de


forma ascendente. Estes campos
equivalem s propriedades
PrimarySortAscending,
SecondarySortAscending,
ThirdSortAscending e
FourthSortAscending em
Verdadeiro, respectivamente

Descendente Ordena os campos do alarme de


forma descendente. Estes campos
equivalem s propriedades
PrimarySortAscending,
SecondarySortAscending,
ThirdSortAscending e
FourthSortAscending em Falso,
respectivamente

NOTAS
A ordenao padro realizada atravs do campo InTime, de maneira
descendente.
Caso a propriedade BannerMode esteja configurada para Verdadeiro, o
alarme mostrado depende da configurao realizada nesta aba.

526 E3Alarm
14.1.5 Aba Cores
Na aba Cores so definidas as cores de reconhecimento dos alarmes no
objeto. possvel configurar as cores para cada tipo de alarme ou por
severidade.

Aba Cores

Clique em para selecionar a cor do tipo de alarme selecionado. A janela


da figura a seguir mostrada.

E3Alarm 527
Cores do alarme selecionado

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Cores

OPO DESCRIO
Cor de fundo Determina a cor de fundo do alarme

Cor do texto Determina a cor do texto do alarme

No pisca Quando selecionada, o texto do


alarme no pisca

Pisca fundo e texto Quando selecionada, as cores de


texto e fundo alternam entre si

Pisca apenas texto Quando selecionada, a cor do texto


varia entre as cores escolhidas para
o texto e para o fundo

528 E3Alarm
possvel tambm selecionar as cores por severidade, para cada tipo de
alarme.

Cores do alarme por severidade

Clique em para redefinir as cores apenas para um tipo de severidade, no


tipo de alarme selecionado. A janela da figura a seguir mostrada.

E3Alarm 529
Cores por severidade

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Cores por severidade

OPO DESCRIO
Redefinir cor de fundo Determina a cor de fundo do alarme
apenas para a severidade
selecionada. Se esta opo no for
marcada, permanece a cor escolhida
na opo Cor de fundo do tipo de
alarme selecionado

Redefinir cor do texto Determina a cor do texto do alarme


apenas para a severidade
selecionada. Se esta opo no for
marcada, permanece a cor escolhida
na opo Cor do texto do tipo de
alarme selecionado

Redefinir pisca Redefine a opo de pisca para o


texto e para o fundo do alarme na
severidade selecionada. Se esta
opo no for marcada, permanece
a opo escolhida no tipo de alarme
selecionado

530 E3Alarm
14.1.6 Aba Fontes
Atravs da aba Fonte possvel configurar a fonte do cabealho e das linhas
do E3Alarm.

Aba Fonte

As opes disponveis so referentes a tipo, tamanho e efeitos da fonte.

NOTA
O nome da aba aparece no idioma do Windows, e no necessariamente no
idioma do E3.

E3Alarm 531
14.2 Caractersticas Especficas de Tempo de
Execuo
O E3Alarm possui uma srie de caractersticas que se aplicam apenas em
tempo de execuo (runtime). Estas caractersticas so descritas nos tpicos a
seguir.

NOTA
Todas as opes do E3Alarm em tempo de execuo que esto disponveis
via menu contextual (atravs do clique com o boto direito do mouse)
tambm esto disponveis utilizando a combinao de teclas SHIFT + F10,
que corresponde tecla de aplicao ou de menu .

532 E3Alarm
14.2.1 Visualizando os Alarmes
Em tempo de execuo, os alarmes do sistema podem ser visualizados no
E3Alarm.

E3Alarm em execuo

Dentre os alarmes que satisfazem os filtros configurados, so mostrados no


E3Alarm aqueles que estiverem em condio ativa ou no estiverem
reconhecidos. De maneira geral, estes alarmes podem ser divididos em dois
casos:

Se a opo Pede Ack da Fonte de Alarme estiver em Falso, o alarme


considerado reconhecido desde a sua ativao, sem a necessidade de
reconhecimento. Neste caso, o alarme permanece visvel at que saia da
condio ativa

Se a opo Pede Ack da Fonte de Alarme estiver em Verdadeiro, o


usurio pode reconhecer o alarme antes ou depois da varivel sair da
condio de alarme. Em ambos os casos, o alarme s sai da lista do
E3Alarm quando as duas condies estiverem satisfeitas

A propriedade BannerMode, quando configurada para Verdadeiro, permite


visualizar apenas uma mensagem de alarme no objeto E3Alarm. A mensagem
que mostrada depende da configurao realizada na aba Ordenao.

E3Alarm 533
14.2.2 Reconhecimento de Alarmes
Na configurao padro, ao clicar com o boto direito do mouse no E3Alarm,
mostrado um menu contextual com as opes Reconhecimento e Deletar
alarmes desvinculados. Ao selecionar a primeira opo, mostrada a caixa
de dilogo da figura a seguir.

Opes da janela Reconhecimento de alarmes

As opes disponveis nesta caixa de dilogo esto descritas na tabela a


seguir.

Opes disponveis na caixa de dilogo Reconhecimento de Alarmes

OPO DESCRIO
Reconhece apenas os alarmes Somente os alarmes selecionados
selecionados so reconhecidos

Reconhece todos os alarmes do Todos os alarmes visveis neste


filtro corrente E3Alarm so reconhecidos

Reconhece globalmente todos os Todos os alarmes do Domnio so


alarmes reconhecidos

534 E3Alarm
A opo Reconhece apenas os alarmes selecionados s est disponvel
se realmente houver alarmes selecionados no E3Alarm. O usurio pode
reconhecer o alarme (neste caso, inserido um novo registro no Banco
de Dados indicando o reconhecimento), e no E3Alarm a linha
correspondente indica que este alarme foi reconhecido. Esta opo est
desabilitada caso a propriedade AllowAckSelected esteja configurada
para Falso

A opo Reconhece todos os alarmes do filtro corrente s est


disponvel se realmente houver alarmes visveis no E3Alarm. possvel
utilizar esta opo sem clicar em nenhum alarme. Para isto, clique em
qualquer rea do E3Alarm para mostrar a janela de Reconhecimento.
Clicando nesta janela, a caixa de dilogo de reconhecimento mostrada.
Esta opo est desabilitada caso a propriedade AllowAckCurrentFilter
esteja configurada para Falso

A opo Reconhece globalmente todos os alarmes est sempre


disponvel, mesmo que no haja alarmes visveis no E3Alarm. Esta opo
est desabilitada caso a propriedade AllowAckAll esteja configurada
para Falso

Ao selecionar a segunda opo, Deletar alarmes desvinculados, mostrada


a caixa de dilogo da figura a seguir.

Opes da janela Alarmes

E3Alarm 535
Para esta opo, o nico item disponvel Globalmente todos os alarmes,
ou seja, todos os alarmes que no estejam vinculados a uma Fonte de Alarme
so removidos. Esta opo do menu contextual do E3Alarm est desabilitada
caso a propriedade AllowDeleteUnboundAlarms esteja configurada para
Falso.

NOTA
Um alarme considerado desvinculado quando est presente no sumrio de
alarmes mas sua Fonte de Alarme foi desativada. Esta desvinculao pode
ocorrer em algumas situaes, como por exemplo:
Mudar o nome da Fonte de Alarme
Utilizar o mtodo Deactivate na Fonte de Alarme em um script
Remover a Fonte de Alarme

O reconhecimento de alarmes tambm pode ser executado atravs de um


clique ou duplo-clique na linha do alarme. Para isto, especifique nas
propriedades da coluna desejada (janela de propriedades do E3Alarm, aba
Colunas, opo Propriedades) como deve ser executado o reconhecimento
do alarme em tempo de execuo, com um ou dois cliques na coluna.

536 E3Alarm
14.2.3 Ordenao de Colunas
Na configurao padro, possvel ordenar os alarmes clicando-se no
cabealho das colunas do E3Alarm. Ao clicar no cabealho da coluna
desejada, o campo associado a esta coluna configurado como o campo
primrio de ordenao. Ao clicar novamente no cabealho da mesma coluna,
o sentido de ordenao primrio (ascendente ou descendente) invertido.

Clicando no cabealho da coluna desejada com a tecla SHIFT pressionada, o


campo associado a esta coluna configurado como campo secundrio de
ordenao. Ao clicar novamente com a tecla SHIFT pressionada no cabealho
desta coluna, o sentido de ordenao secundrio invertido.

A propriedade EnableSortMarker permite mostrar ou esconder a indicao


de ordenao ascendente ou descendente ao clicar no cabealho de
uma coluna.

Para maiores detalhes sobre este comportamento, consulte as propriedades


EnableSortMarker, PrimarySortAscending, PrimarySortField,
SecondarySortAscending, SecondarySortField, ThirdSortAscending,
ThirdSortField, FourthSortAscending, FourthSortField e BannerMode do
E3Alarm no Manual de Referncia e Scripts do E3.

Exemplo de ordenao

Na figura anterior, os alarmes esto ordenados primeiro por DataHora


(Entrada), de forma descendente, e depois por rea, tambm de forma
descendente.

E3Alarm 537
14.2.4 Status das Conexes
A partir da verso 4.7, o E3Alarm permite visualizar o status das conexes
configuradas na aba Conexes. Para habilitar a barra de status, configure a
propriedade ShowConnectionStatusBar do objeto E3Alarm na Lista de
Propriedades. A figura a seguir mostra a barra de status habilitada.

Barra de status de conexes do E3Alarm

As seguintes propriedades do E3Alarm podem ser configuradas para


controlar o comportamento da barra de status:

ShowConnectionStatusBar: Mostra ou esconde a barra de status

ConnectionStatusBarColor: Especifica a cor de fundo da barra de status

PictureConnected: Caminho para um arquivo de imagem com o cone


representando uma conexo com sucesso. O padro do E3Alarm
mostrar o cone

PictureNotConnected: Caminho para um arquivo de imagem com o


cone representando uma conexo em falha. O padro do E3Alarm
mostrar o cone

PictureUnknown: Caminho para um arquivo de imagem com o cone


representando uma conexo indefinida. O padro do E3Alarm mostrar
o cone

538 E3Alarm
NOTA
O status indefinido indica que o E3Alarm no recebeu uma confirmao do
Servidor de Alarmes de que a conexo teve sucesso. Este o status padro
para verses anteriores 4.7.

E3Alarm 539
CAPTULO
Storage
15
O Storage um mdulo alternativo de gravao dos dados histricos.
Atravs dele possvel transformar dados de produo, processos e outras
coletas em informaes gerenciais. Este mdulo permite que diversas
informaes sejam coletadas atravs de servidores OPC, Drivers da Elipse,
bancos de dados em geral, ou at mesmo arquivos de texto e
armazenamentos em banco de dados comerciais (Microsoft SQL Server e
Oracle) por objetos histricos definidos pelo usurio em uma forma compacta
e eficiente.

O armazenamento das informaes segue a lgica de que um dado s


gravado quando h uma variao significativa, definida pelo usurio. A anlise
das variaes feita pelo algoritmo BoxCar/BackSlope, que permite,
dependendo das bandas mortas configuradas, uma compactao significativa
dos dados com a recuperao total das informaes teis.

A recuperao dos dados no ambiente do E3 pode ser executada atravs de


uma ferramenta de consulta padronizada, que permite montar sua estrutura
de consulta de forma grfica (similar ferramentas como Microsoft Access ou
SQL Server) ou ainda editar diretamente as consultas SQL. Os dados extrados
podem ser visualizados em formato tabular (E3Browser), grficos (E3Chart),
relatrios que permitem visualizao em tela (usando o mtodo PrintPreview
do Relatrio), impresso direta para o papel, ou mesmo exportao para
vrios formatos como Acrobat PDF, HTML, TXT, CSV, TIFF e GIF, entre outros.

A principal funo do Storage permitir a gravao dos dados de forma


compacta. Atravs desta ferramenta possvel recuperar com grande
exatido todas as mudanas nas variveis de processo, ocupando assim o
mnimo de espao no banco de dados. Alguns exemplos so mostrados nos
tpicos a seguir.

Grfico sem compactao

A informao processada contm vrios pontos.

540 Storage
Grfico sem compactao

Grfico com compactao

Veja que a informao praticamente a mesma, s que com menos pontos.

Grfico com compactao

A gravao no Storage feita da seguinte maneira:

Storage 541
Aps a definio da tabela nas propriedades do Storage, esta gerada
clicando em Gerar Tabela e os dados so gravados de acordo com estas
definies. Se houver variao de qualidade no Tag, os dados tambm
so gravados

Os dados s no so gravados se a variao ocorreu em um tempo


menor que o mnimo programado (campo MinRecTime)

Para inserir esta ferramenta no E3, siga este procedimento:

1. Clique com o boto direito do mouse no projeto no modo Explorer e


selecione a opo Inserir - Storage. No modo Domnio, clique com o
boto direito do mouse no item Objetos de Servidor - Banco de Dados,
selecione a opo Inserir Storage em e logo aps o nome do projeto
desejado.

Inserindo um Storage no modo Domnio

542 Storage
Caso necessite, configure as propriedades do objeto. Algumas das
propriedades deste objeto podem ser configuradas atravs da Lista de
Propriedades, sem a necessidades de criar scripts para isto. Para maiores
informaes, consulte o Manual de Referncia e Scripts do E3.

NOTA
O objeto Storage pode ser configurado para funcionar como rea de
Alarme.

15.1 Configuraes
Quando o Storage criado na Tela, mostrada uma lista de definies dos
campos de gravao.

Campos configurados para o Storage

Para adicionar um campo, pode-se arrastar e soltar um Tag ou propriedade a


partir do Organizer, ou ento definir o campo e a fonte manualmente.

NOTA
As licenas de Storage so verificadas apenas quando o aplicativo
executado e levam em conta apenas os campos ativos na aplicao, no a
quantidade de campos existentes no banco de dados.

Storage 543
Para efeitos de posterior consulta nos dados, toda a busca se d atravs do
caminho do Tag ou propriedade que est sendo armazenada, definido
atravs do campo Fonte. A propriedade Nome s utilizada caso o campo
Fonte contenha uma expresso (por exemplo, Driver1.Tag1 + Driver1.Tag2).

Logo, se expresses no estiverem sendo utilizadas no campo Fonte, no h


necessidade de se importar com o nome do campo. As opes disponveis
esto descritas na tabela a seguir.

Opes disponveis no Editor do Storage

OPO DESCRIO
Adiciona campos na tabela do
Storage

Remove o campo selecionado da


tabela do Storage

Determina as configuraes da
tabela do Storage

Gera a estrutura no Banco de Dados

Nome Determina o nome do campo da


tabela do Storage

Fonte Determina a fonte de dados que


associada ao campo

Tipo Determina o tipo do campo da


tabela do Storage. Se este valor for
alterado para Bit, Text ou Integer,
as colunas MinRecTime,
MaxRecTime, Varredura, Banda
Morta e Unidade permanecem
desabilitadas

MinRecTime Tempo mnimo para insero de um


dado na tabela. Este tempo
calculado em milissegundos

544 Storage
OPO DESCRIO
MaxRecTime Tempo mximo de espera por um
dado, em segundos. Ao passar este
tempo, o dado considerado antigo
e armazenado

Varredura Tempo de varredura do campo. Se


este valor for igual a 0 (zero), esta
coluna permanece desabilitada e
mostra o valor definido em
MaxRecTime, em milissegundos

Banda Morta Banda morta para clculo do


algoritmo

Unidade Valor absoluto ou a porcentagem de


modificao

15.1.1 Criando um Storage Vazio


O objeto Storage pode ser criado sem que tenha seus campos configurados.
Para isto, basta que suas propriedades DBServer e TableName sejam
preenchidas na criao. Esta configurao permite que seja criado um Storage
somente para consulta, o que bastante til para acessar dados gerados por
aplicativos externos. Algumas restries se aplicam nesta situao:

Embora o Storage seja ativado normalmente, no gera tabelas nem altera


ndices

A opo Gerar Tabela na janela de Propriedades, a opo Gerar


Estrutura no DB do menu contextual e a opo da barra de
ferramentas do Storage retornam uma mensagem de erro, indicando que
a estrutura do banco de dados no pode ser criada pois no h campos
definidos

O Storage vazio listado normalmente na caixa de seleo Nome do


Servidor de uma Consulta

No h necessidade de licenas de Storage para consultar dados


externos, somente para escrita de dados

Storage 545
15.2 Configurao da Tabela
Pode-se acessar as configuraes da tabela utilizada no Storage de duas
maneiras:

1. Clicando em Propriedades .

2. Clicando com o boto direito do mouse no objeto no Organizer e


selecionando a opo Propriedades.

Aba Storage

Cada campo da aba Storage possui uma propriedade correspondente. As


opes disponveis nesta aba esto descritas na tabela a seguir.

546 Storage
Opes disponveis na aba Storage

OPO DESCRIO
Servidor de Banco de Dados Define o servidor de Banco de
Dados. Este campo equivale
propriedade DbServer

Nome da tabela Determina o nome da tabela. Este


campo equivale propriedade
TableName

Descartar dados da tabela principal Habilita ou desabilita o descarte de


dados da tabela principal. O dado
considerado antigo de acordo com o
que for definido na opo Descartar
dados mais antigos que. Este
campo equivale propriedade
EnableDiscard

Descartar dados mais antigos que Determina o intervalo de tempo


(minutos, horas, dias ou meses)
durante o qual os dados so
mantidos na tabela principal. Se um
dado da tabela for mais antigo que
o intervalo de tempo desta opo,
ele descartado. Este campo
equivale propriedade
DiscardInterval e o campo de
seleo da unidade de tempo do
intervalo equivale propriedade
DiscardTimeUnit

Realizar o descarte a cada Determina o intervalo (minutos,


horas, dias ou meses) de descarte de
dados antigos da tabela. Este campo
equivale propriedade
VerificationUnit

Storage 547
OPO DESCRIO
Mover para a tabela de backup os Habilita ou desabilita o
dados descartados armazenamento dos dados
descartados na tabela secundria
(tabela de backup). Este campo
equivale propriedade
EnableBackupTable

Descartar do backup dados mais Determina o intervalo mximo de


antigos que tempo (minutos, horas, dias ou
meses) dos dados na tabela de
backup at serem descartados,
independente do tempo que os
dados permanecem na tabela
principal. Por exemplo, para manter
os dados por 24 meses na tabela
principal e mais seis meses na tabela
de backup, o valor desta opo deve
ser de 30 meses. Este intervalo deve
ser sempre maior que o configurado
no item Descartar dados mais
antigos que da tabela principal. Este
campo equivale propriedade
BackupDiscardInterval e o campo
de seleo da unidade de tempo do
intervalo equivale propriedade
BackupDiscardTimeUnit

Gerar Tabela Gera a estrutura da tabela no Banco


de Dados. Esta opo tambm est
disponvel clicando com o boto
direito do mouse no objeto Storage
no Organizer e selecionando a
opo Gerar Estrutura no BD

548 Storage
Aps definir as configuraes da tabela, clique em Gerar Tabela. Esta ao
cria a estrutura da tabela no banco de dados.

A estrutura de tabelas do Storage semelhante estrutura do Histrico, com


uma tabela de definies, uma tabela principal de dados e uma tabela de
backup (se selecionada pelo usurio). Para que se possa identificar
externamente que uma tabela compactada, verifique se foi criada a tabela
_Fields.

Tabela de campos

Esta tabela possui os campos descritos a seguir.

Campos da tabela _Fields

CAMPO DESCRIO
FieldDeadBand Banda morta

Storage 549
CAMPO DESCRIO
FieldDeadBandUnit Unidade da banda morta. Em
porcentagem do valor anterior ou
porcentagem dos limites de
engenharia (valor fixo)

FieldDescription Descrio do campo

FieldEU Unidade de Engenharia

FieldHighEng Limite superior do Tag

FieldID ndice do campo cadastrado no


Storage

FieldLowEng Limite inferior do Tag

FieldMaxRecTime Depois que este tempo expira, o


dado deve ser automaticamente
gravado

FieldMinRecTime Valor mnimo de tempo de variao


para armazenar dados

FieldName Nome do campo

FieldQuality Qualidade do campo

FieldScanTimeMs Tempo de varredura que deve ser


utilizado para reconstruir o grfico
do Tag, em milissegundos

FieldSize Tamanho do campo

FieldSource Associao utilizada para obter


valores deste campo

FieldType Tipo do campo

550 Storage
CAMPO DESCRIO
FieldVARTYPE Tipo de dado nativo do campo (0:
Indefinido, 3: Integer, 5: Double, 8:
Text ou 11: Bit)

Storage 551
A implementao do Storage permite que o usurio no tenha que se
preocupar em como os dados esto armazenados nas tabelas. Entretanto,
para uma melhor compreenso do funcionamento do mdulo, e tambm para
permitir acesso por outros programas, mostrado a seguir o formato das
tabelas.

As opes de gerenciamento de tabelas especificadas no item anterior se


aplicam na verdade a trs conjuntos de tabelas geradas pelo Storage, de
acordo com o campo Nome de Tabela.

Isto porque, para cada tipo de grandeza armazenada, gerado


automaticamente um conjunto de tabelas, a saber: um conjunto para os Tags
analgicos, outro para os textos e mais outro para os digitais. Desta forma,
cada Storage pode gerenciar at sete tabelas, caso se especifique que os trs
tipos de Tags devam ser armazenados:

<NomeTabela>_Fields

<NomeTabela>

<NomeTabela>_Text

<NomeTabela>_Bit

<NomeTabela>_Backup

<NomeTabela>_Text_Backup

<NomeTabela>_Dig_Backup

A tabela _Fields contm a descrio dos campos que so armazenados, que


de forma geral armazenam as mesmas informaes definidas na configurao
dos campos do Storage, alm de associar um ndice automtico para cada
campo. As demais tabelas possuem um formato fixo:

E3TimeStamp: Campo que armazena a data e hora em que houve a


variao do Tag. Caso o protocolo de comunicao suporte o envio de
informao de tempo, este campo contm o timestamp do equipamento

552 Storage
Qualidade: Contm a informao de qualidade do ponto (Ruim, Incerto
ou Bom) de acordo com a utilizao dentro do E3 e das normas OPC

ndice: Relaciona o campo gravado com o seu respectivo nome que est
armazenado na tabela _Fields

Valor: Valor armazenado. Para a tabela de analgicos trata-se de um


campo tipo Double (nmero real), j para a tabela de digitais trata-se de
um nmero inteiro e para os textos trata-se de um campo NVARCHAR de
tamanho varivel, especificado pelo usurio no campo StringFieldSize

Storage 553
15.2.1 Execuo
Ao iniciar a execuo do aplicativo e receber a primeira notificao de valor
de cada uma das variveis armazenadas, o Storage armazena este valor
obtido com qualidade Ruim, e logo em seguida com a qualidade enviada, se
esta for Boa. Isto porque ao realizar a consulta, o usurio tem a visualizao
de que houve uma interrupo no armazenamento.

Depois, conforme sejam obtidos novos valores para as variveis, um


algoritmo de verificao de gravao interpreta a sequncia e decide se cada
ponto ou no armazenado. Este algoritmo, conhecido como BoxCar/
BackSlope, cria duas bandas de variao (cuja amplitude dada pela banda
morta da varivel) de um ponto gravado. A banda horizontal (BoxCar) define
uma verificao comum da banda morta. Uma segunda banda diagonal
(BackSlope) define uma variao para cima ou para baixo da banda morta.

Portanto, se a varivel est em uma derivativa contnua descendente ou


ascendente, s necessrio armazenar os pontos iniciais ou finais nesta linha
reta. Assim, uma varivel analgica s gravada se o valor viola tanto a
banda horizontal quanto a vertical, ou se houve uma mudana na qualidade,
ou seja, o equipamento foi ligado ou desligado.

Exemplo do algoritmo BoxCar/BackSlope

554 Storage
Esta verificao, entretanto, s ocorre para os campos analgicos. Para os
campos de texto e digitais, basta que haja uma mudana qualquer de valor ou
qualidade, como por exemplo a perda de comunicao, para que sejam
gravados.

Storage 555
15.2.2 Ferramentas de Consultas Internas
A ferramenta Consulta prev algumas facilidades para realizar consultas nos
dados do Storage.

Ao iniciar a configurao de uma Consulta em uma aplicao que possui um


Storage, este objeto entra na lista de Bancos de Dados disponveis para
consulta. Isto porque o Storage atua como um novo provedor de dados,
criando facilidades para o usurio consultar os dados nas tabelas temporais.

Entretanto, nada impede o usurio de realizar as consultas diretamente no


Banco de Dados de origem, de acordo com os formatos das tabelas j
mencionado. A desvantagem neste caso que o processo de consulta mais
complexo.

Portanto, uma vez escolhido o prprio Storage como provedor de dados


para a Consulta, sua interface de configurao apresenta vrias diferenas,
como pode ser visto na figura a seguir. A primeira delas que ao invs de
exibir as tabelas, mostrada uma rvore com todas as variveis que esto
sendo armazenadas. A outra diferena que o usurio pode selecionar uma
entre sete funes para consolidao dos dados, mostradas a seguir:

LastValue: Retorna o ltimo valor armazenado na Base de Dados

ArchivedValue: Retorna um valor armazenado em relao a um


determinado instante de tempo definido na varivel TimeStamp. O tipo de
relao, definido na propriedade FunctionSubType, pode ser Previous
(valor armazenado imediatamente anterior ao timestamp fornecido), Next
(valor armazenado imediatamente posterior ao timestamp), Interpolated
(valor calculado a partir do valor anterior e posterior) e ExactTime (se for
encontrado um valor armazenado no exato instante que foi fornecido
pelo timestamp). As variveis tambm podem ser definidas em tempo de
execuo a partir da chamada do mtodo SetVariableValue da Consulta

556 Storage
TagAttribute: Devolve um atributo do Tag, definido em
FunctionSubType, que pode ser FieldDescription (significado ou
descrio do Tag), FieldSource (caminho do Tag que est sendo
armazenado), FieldType (tipo de dado: Double, Bit, String ou Integer),
FieldEU (unidade de engenharia), FieldLowEng (limite inferior),
FieldHighEng (limite superior), FieldDeadBand (banda morta para
gravao), FieldDeadBandUnit (unidade da banda morta, se em valores
absolutos ou em porcentagem), FieldMinRecTime (tempo mnimo para
gravao, variaes menores que este intervalo so desprezadas) e
FieldMaxRecTime (tempo mximo para gravao, a ausncia de variao
nestes intervalos fora uma gravao)

CompressedDataNValues: Retorna, para um nico Tag, N valores


definidos na varivel NumVals, armazenados a partir de um instante
inicial, definido na varivel StartTime. As variveis tambm podem ser
definidas em tempo de execuo a partir da chamada do mtodo
SetVariableValue da Consulta

CompressedDataStartEndTime: Retorna, para um nico Tag, os valores


armazenados que esto entre o intervalo definido pelas variveis
StartTime e EndTime. As variveis tambm podem ser definidas em tempo
de execuo a partir da chamada do mtodo SetVariableValue da
Consulta

SampledData: Retorna, para um ou mais Tags, os valores interpolados,


ou seja, estimados entre os instantes definidos pelas variveis StartTime e
EndTime, a intervalos fixos definidos pela varivel TimeInterval. As variveis
tambm podem ser definidas em tempo de execuo a partir da
chamada do mtodo SetVariableValue da Consulta

CalculatedData: Retorna, para um ou mais Tags, o resultado de


operaes matemticas aplicadas aos dados entre os instantes definidos
pelas variveis StartTime e EndTime, a intervalos fixos definidos pela
varivel TimeInterval. Os tipos de clculos so Total, Mnimo, Mximo,
Desvio Padro, Amplitude, Mdia e Mediana. As variveis tambm
podem ser definidas em tempo de execuo a partir da chamada do
mtodo SetVariableValue da Consulta

Storage 557
Para todas as opes possvel indicar se os dados com qualidade Ruim so
includos ou no no resultado, atravs da caixa de seleo Incluir qualidade
RUIM, correspondente propriedade IgnoreQuality da Consulta associada
ao objeto Storage.

Funes da Consulta

558 Storage
15.2.3 Utilizao
Se a funo selecionada possui algum filtro, ento necessrio informar o
valor dos filtros antes de executar a Consulta, seja na prpria caixa de dilogo
de configurao (na aba Visualizar) ou atravs de script, usando o mtodo
SetVariableValue. Exemplo:
Set Chart = Screen.Item("E3Chart1")
Set Query = Chart.Item("Consulta1")
Query.SetVariableValue "StartTime", Chart.DataIni
Query.SetVariableValue "EndTime", Chart.DataFim
Query.SetVariableValue "TimeInterval",
rs.Fields("SampleInterval").Value
Chart.Queries.UpdateData

15.2.4 Ferramentas de Consultas Externas


Quando se est desenvolvendo um aplicativo externo em linguagens como
Java, Visual Basic ou C++, e se deseja obter os dados armazenados pelo
Storage, possvel realizar chamadas a Stored Procedures, que so criadas
pelo Storage em um Banco de Dados. Existem sete Stored Procedures que
correspondem a algumas das opes de Consulta, mostradas na tabela a
seguir.

Opes de consultas disponveis

FUNO CONSULTA STORED PROCEDURE


LastValue E3LastValue

ArchivedValue E3Archive, E3ArchiveInterpolate

CompressedDataNValues E3NCompData

CompressedDataStartEndTime E3CompData

SampledData E3SampledData

CalculatedData E3CalculatedData

Storage 559
As Stored Procedures que utilizam parmetros de tipo Data recebem este
parmetro na chamada como um nmero Float (ponto flutuante), ao invs de
DateTime. Isto permite aumentar a preciso do E3, j que ao utilizar o
formato DateTime a preciso mxima de 3ms, ao invs de 1ms com o tipo
Float.

Para facilitar a passagem de parmetros, pode-se adicionar ao Banco de


Dados uma funo do usurio que transforma um valor DateTime em um
Float, conforme o exemplo a seguir.
CREATE FUNCTION E3GETFLOATVALUE (@dDate datetime)
RETURNS FLOAT AS
BEGIN
RETURN CAST(@dDate AS float)
END

Os tpicos a seguir mostram alguns exemplos da utilizao destas funes.

560 Storage
15.2.4.1 E3Archive

Retorna um valor armazenado em relao a um instante, conforme exposto na


funo ArchivedValue. usada somente para os sub-tipos Prev (0), Next (2)
e ExactTime (3). A descrio formal a seguinte:
E3Archive(
@iSubType int,
@strTableName VARCHAR(100),
@dData float,
@strFieldName VARCHAR(100),
@strFilter VARCHAR(500),
@type int,
@bQuality int)

Onde:

@iSubType: Sub-tipo da funo (0: Prvio, 2: Prximo ou 3: Instante


Exato)

@Data: Instante no tempo para a busca, no formato Float

Retorna uma consulta com apenas uma linha, com os campos E3TimeStamp,
Quality e FieldValue. Exemplo de utilizao:
DECLARE @MyDate FLOAT
SET @MyDate = dbo.E3GETFLOATVALUE('10-10-2005 12:00:00')
EXECUTE E3Archive 0, 'STO22', @MyDate,
'Dados.TagDemo1', '', 2, 0

Storage 561
15.2.4.2 E3ArchiveInterpolate

Retorna os pontos imediatamente anteriores e posteriores a um instante,


conforme exposto para a funo ArchivedValue, porm somente para o Sub-
tipo Interpolado. A descrio formal a seguinte:
E3ArchiveInterpolate(
@strTableName VARCHAR(100),
@dData float,
@strFieldName VARCHAR(100),
@strFilter VARCHAR(500),
@type int,
@bQuality int)

Onde:

@dData: Instante no tempo para a busca, no formato Float

Esta consulta retorna duas linhas, com os campos E3TimeStamp e


FieldValue. Exemplo de utilizao:
DECLARE @MyDate FLOAT
SET @MyDate = dbo.E3GETFLOATVALUE('10-10-2005 12:00:00')
EXECUTE E3ArchiveInterpolate 'STO22',
@MyDate, 'Dados.TagDemo1', '', 2, 0

562 Storage
15.2.4.3 E3CalculatedData

Equivale funo CalculatedData. A descrio formal a seguinte:


E3CalculatedData(
@iSubType int,
@strTableName VARCHAR(100),
@iModMin int,
@dStartDate float,
@dEndDate float,
@strFields VARCHAR(1000),
@strWhere VARCHAR(4000),
@type int,
@bQuality int)

Onde:

@iSubType: Sub-tipo do clculo (0: Total, 1: Mnimo, 2: Mximo, 3:


Desvio Padro, 4: Amplitude, 5: Mdia ou 6: Mediana)

Exemplo de utilizao:
DECLARE @MyStartDate FLOAT
SET @MyStartDate = dbo.E3GETFLOATVALUE('10-10-2004 12:00:00')
DECLARE @MyEndDate FLOAT
SET @MyEndDate = dbo.E3GETFLOATVALUE('10-10-2006 12:00:00')
EXECUTE E3CalculatedData 0, 'STOXX', 10,
@MyStartDate, @MyEndDate, 'Dados.TagDemo1', '', 2, 1

Storage 563
15.2.4.4 E3CompData

Equivale funo CompressedDataStartEndTime. A descrio formal a


seguinte:
E3CompData(
@strTableName VARCHAR(100),
@dStartData float,
@dEndData float,
@strFieldName VARCHAR(100),
@strFilter VARCHAR(500),
@strOrder VARCHAR(100),
@type int,
@bQuality int)

Onde:

@dStartData: A data inicial, em formato Float

@dEndData: A data final, em formato Float

@strOrder: Quando desejar que a consulta seja ordenada por outro


campo que no seja o TimeStamp

Esta funo retorna o nmero de linhas encontradas no intervalo, com os


campos E3TimeStamp, Quality e FieldValue. Exemplo de utilizao:
DECLARE @MyStartDate FLOAT
DECLARE @MyEndDate FLOAT
SET @MyStartDate = dbo.E3GETFLOATVALUE('10-10-2005 12:00:00')
SET @MyEndDate = dbo.E3GETFLOATVALUE('10-10-2006 12:00:00')
EXECUTE E3CompData 'STO22', @MyStartDate,
@MyEndDate, 'Dados.TagDemo1', '', '', 2, 0

564 Storage
15.2.4.5 E3LastValue

Retorna o ltimo valor de um determinado Tag que est armazenado no


Banco de Dados. A descrio formal a seguinte:
E3LastValue(
@strTableName VARCHAR(100),
@strFieldName VARCHAR(100),
@strFilter VARCHAR(500),
@type int,
@bQuality int)

Onde:

@strTableName: Nome da tabela

@strFieldName: Nome do campo

@strFilter: Caso queira inserir opes de filtro para o valor

@type: Tipo de dado (0: String, 1: Bit ou Integer ou 2: Analgico)

@bQuality: Se diferente de 0 (zero), somente inclui Tags com qualidade


Boa

Retorna uma consulta com apenas uma linha, com os campos E3TimeStamp,
Quality e FieldValue. Exemplo de utilizao:
EXECUTE E3LastValue 'TabelaXX',
'Tag234', '', 2, 1

Storage 565
15.2.4.6 E3NCompData

Equivale funo CompressedDataNValues. A descrio formal a seguinte:


E3NCompData(
@strTableName VARCHAR(100),
@dData float,
@strFieldName VARCHAR(100),
@iNValues int,
@strFilter VARCHAR(500),
@strOrder VARCHAR(100),
@type int,
@bQuality int)

Onde:

@iNValues: O nmero de valores desejado

@strOrder: Quando desejar que a consulta seja ordenada por outro


campo que no seja o TimeStamp

Esta funo retorna o nmero de linhas solicitado, se encontrado, com os


campos E3TimeStamp, Quality e FieldValue. Exemplo de utilizao:
DECLARE @MyDate FLOAT
SET @MyDate = dbo.E3GETFLOATVALUE('10-10-2005 12:00:00')
EXECUTE E3NCompData 'STO22', @MyDate,
'Dados.TagDemo1', 20, '', '', 2, 0

566 Storage
15.2.4.7 E3SampledData

Equivale funo SampledData. A descrio formal a seguinte:


E3SampledData(
@strTableName VARCHAR(100),
@iModMin int,
@dStartDate float,
@dEndDate float,
@strFields VARCHAR(1000),
@strWhere VARCHAR(4000),
@type int,
@bQuality int)

Onde:

@iModMin: Intervalo em segundos para a interpolao de cada valor


dentro do intervalo

@dStartData: A data inicial, em formato Float

@dEndData: A data final, em formato Float

@strFields: Lista de campos

Exemplo de utilizao:
DECLARE @MyStartDate FLOAT
SET @MyStartDate = dbo.E3GETFLOATVALUE('10-10-2004 12:00:00')
DECLARE @MyEndDate FLOAT
SET @MyEndDate = dbo.E3GETFLOATVALUE('10-10-2006 12:00:00')
EXECUTE E3SampledData 'STOXX', 10, @MyStartDate,
@MyEndDate, 'Dados.TagDemo1', '', 2, 1

Storage 567
CAPTULO
Histrico
16
Histricos so mdulos responsveis pelo armazenamento de dados da
aplicao em um Banco de Dados. Permitem armazenar dados de processos
para anlises futuras. Pode-se criar tantos arquivos de Histricos quantos se
desejar, cada um contendo diversos Tags ou expresses. Cada Histrico pode
criar ou utilizar uma tabela independente dentro do Banco de Dados, cujo
armazenamento pode ser definido por Tempo ou por Evento. Atravs da
propriedade CacheSize, define-se o nmero de registros enviados por vez
para o Banco de Dados. Conforme a definio da propriedade DBServer,
define-se o Servidor do Banco de Dados que utilizado pelo Histrico. Para
utilizar este recurso, siga estes procedimentos:

1. Clique com o boto direito do mouse no nome do projeto no modo


Explorer e selecione a opo Inserir - Histrico. No modo Domnio,
clique com o boto direito do mouse no item Objetos de Servidor -
Banco de Dados, selecione a opo Inserir Histrico em e logo aps o
nome do projeto desejado.

568 Histrico
Inserindo um Histrico no modo Domnio

2. Quando o Histrico for habilitado, as seguintes opes de configurao


so mostradas na figura a seguir.

Opes do Histrico

As opes disponveis neste Editor esto descritas na tabela a seguir.

Histrico 569
Opes disponveis no Editor do Histrico

OPO DESCRIO
Adiciona campos na tabela do
Histrico

Remove o campo selecionado da


tabela do Histrico

Determina as configuraes da
tabela do Histrico

Gera a estrutura no Banco de Dados

Cria uma chave primria

Configura os ndices que so criados


no Histrico

Mantm o Histrico sem vnculos


diretos com a tabela existente

Busca os campos na tabela original

Vincula o Histrico a uma tabela j


existente

570 Histrico
3. Abra a janela de propriedades do Histrico. Para isto, clique com o boto
direito do mouse no objeto e selecione a opo Propriedades. Algumas
das propriedades deste objeto podem ser configuradas atravs da Lista
de Propriedades, sem a necessidade da criao de scripts para isto. Caso
seja necessrio configurar alguma propriedade, localize-a na Lista de
Propriedades e faa os devidos ajustes. Demais informaes sobre as
funcionalidades das propriedades deste objeto podem ser encontradas
no Manual de Referncia e Scripts do E3, no captulo referente ao objeto
Histrico.

NOTA
O objeto Histrico pode ser configurado para funcionar como rea de
Alarme.

16.1 Configuraes
Quando um Histrico inserido no projeto, o campo E3TimeStamp criado
automaticamente na tabela. O campo E3TimeStamp mostra a data e hora em
que o valor foi buscado (diferente do timestamp do Tag). Vale lembrar que
este campo utilizado somente para leitura. possvel associar um Tag ao
campo E3TimeStamp. Se no houver Associao, ele busca a hora atual do
sistema para a gravao.

NOTA
O uso da hora atual do sistema para a gravao do campo E3TimeStamp
s est disponvel quando a tabela criada pelo Histrico. No caso de
utilizar uma tabela j existente, necessrio associar um Tag do tipo Demo
com a propriedade Type configurada como 3 - Current Time para que este
campo registre a data e hora corretamente.

Para criar a tabela no Histrico, importante que seus campos sejam


previamente criados clicando-se em Adicionar campo . Para remover algum
campo indesejado, clique em Remover campo . A mensagem de
confirmao da figura a seguir mostrada.

Histrico 571
Mensagem para confirmar excluso de campo na tabela

O campo Nome define o nome do campo da tabela, o campo Tipo define o


tipo de campo da tabela e a fonte deste campo definida em Fonte.
Tambm possvel definir se este campo ou no a chave primria da
tabela.

572 Histrico
16.1.1 Chave Primria
A Chave Primria um campo ou um conjunto de campos que identifica de
maneira nica cada registro de uma tabela. Assim como o ndice principal
para a tabela, ela utilizada para associar dados entre tabelas. Alguns
exemplos de chaves primrias so cdigos de clientes, CNPJ, nmero de
matricula, etc. Aps a definio de um campo como sendo a chave primria
da tabela, o prprio Banco de Dados garante que no sejam inseridos dados
duplicados neste campo. Por exemplo, se o usurio tentar cadastrar um
pedido com o mesmo nmero de um pedido j existente, o registro no
cadastrado e uma mensagem de erro mostrada. H dois tipos de chave
primria: Simples ou Composta.

Uma Chave primria simples um campo que identifica de modo nico cada
registro de uma tabela. Uma Chave primria composta pode ser formada
pela combinao de dois ou mais campos da tabela. Podem existir casos em
que um nico campo no capaz de atuar como chave primria porque ele
apresenta valores repetidos. Alm disto, uma tabela pode ter somente uma
chave primria, seja ela simples ou composta. Ou seja, no se pode definir
dois ou mais campos de uma tabela para que cada um seja uma chave
primria separada. No confundir com o caso de uma chave primria
composta, onde a unio de dois ou mais campos que forma a nica chave
primria da tabela.

Ao escolher campos para uma Chave Primria, considere os seguintes


detalhes:

No so permitidos valores duplos ou nulos

Caso no exista um identificador nico para uma determinada tabela,


pode-se usar um campo que numere os registros sequencialmente

A chave primria pode ser configurada de duas formas: verificando na tela do


Histrico qual campo da tabela que se pretende tornar chave primria, e
habilitando-o atravs da opo ou clicando no cone , que abre a janela
de configurao, conforme a figura a seguir.

Histrico 573
Editando um ndice de Chave Primria

Nesta janela, selecione o campo desejado como chave primria. As opes


disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Edio de ndices

OPO DESCRIO
Nome do ndice Determina o nome da chave primria

Garantir que os valores deste Faz com que os valores


ndice sero nicos especificados para o ndice Chave
Primria sejam nicos. Esta opo
est sempre marcada para Chaves
Primrias, no podendo ser
modificada

Nome do campo Mostra o nome do campo

574 Histrico
OPO DESCRIO
Ordenao Mostra a ordenao do campo
selecionado

Tipo Mostra o tipo do campo da tabela

Mude a ordem dos campos Muda a posio do campo na tabela,


fazendo com que ele suba ou desa

Clicando em OK, confirma-se que o campo determinado uma chave primria


da tabela. Para cancelar a configurao, clique em Cancelar. Pode-se tambm
atribuir um ndice tabela.

Histrico 575
16.1.2 ndices
Um ndice um campo ou conjunto de campos que so previamente
ordenados pelo Banco de Dados, a fim de melhorar a performance das
consultas que utilizam este ndice. Eles so utilizados para encontrar registros
com um valor especfico em uma coluna rapidamente. Sem um ndice, o Banco
de Dados tem de iniciar com o primeiro registro e depois ler atravs de toda
a tabela at que encontre os registros relevantes. Quanto maior a tabela,
maior o custo desta operao. Se a tabela possuir um ndice para as colunas
em questo, o Banco de Dados pode rapidamente obter uma posio para
procurar no meio do arquivo de dados sem ter que varrer todos os registros.
Por exemplo, se uma tabela possui 1.000 registros, isto pelo menos 100
vezes mais rpido do que ler todos os registros sequencialmente. Note que,
se for preciso acessar quase todos os 1.000 registros, mais rpido acess-
los sequencialmente, pois isto evita acessos ao disco.

Os tipos de ndices disponveis so os seguintes: Primrio, nico e Index.

Todos os tipos de colunas da tabela podem ser indexadas. O uso de ndices


nas colunas relevantes a melhor forma de melhorar a performance da
tabela. O nmero mximo de ndices por tabelas e o tamanho mximo de um
ndice definido pelo mecanismo de armazenamento do Servidor de Banco
de Dados.

Pode-se criar ndices em mltiplas colunas. Um ndice de mltiplas colunas


pode ser considerado um vetor ordenado contendo valores que so criados
concatenando-se valores de colunas indexadas.

Os ndices podem ser configurados atravs do cone , que abre a janela de


configurao, conforme a figura a seguir.

576 Histrico
Janela Editor de ndices

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Editor de ndices

OPO DESCRIO
Nome Mostra o nome do ndice existente

Campos Mostra o campo ao qual o ndice


est associado na tabela

Adicionar Abre uma caixa de dilogo para a


adio de um ndice

Editar Abre uma caixa de dilogo para a


edio do ndice selecionado

Remover Remove o ndice selecionado

Histrico 577
Ao clicar em Adicionar, a caixa de dilogo da figura a seguir mostrada.

Janela Adio de ndices

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Adio de ndices

OPO DESCRIO
Nome do ndice Determina o nome do ndice

Garantir que os valores deste Se habilitada, faz com que os valores


ndice sero nicos especificados para o ndice sejam
nicos

578 Histrico
OPO DESCRIO
Nome do campo Mostra os nomes dos campos.
Selecione aqueles que devem
pertencer ao ndice

Ordenao Mostra a ordenao do campo


selecionado (Ascendente ou
Descendente)

Tipo Mostra o tipo do campo da tabela

Mude a ordem dos campos Muda a posio do campo na tabela,


fazendo com que ele suba ou desa

Clicando em OK, os ndices na tabela so confirmados. Para cancelar a


configurao, clique em Cancelar.

Histrico 579
16.1.3 Configuraes da Tabela
Depois de definidas as opes descritas anteriormente, necessrio
configurar as informaes da tabela do Histrico e gerar a estrutura no Banco
de Dados. Para isto, clique com o boto direito do mouse no Histrico,
selecione a opo Propriedades e selecione a aba Histrico, conforme a
figura a seguir.

Aba Histrico

Cada campo da aba Histrico possui uma propriedade correspondente. As


opes disponveis nesta aba esto descritas na tabela a seguir.

580 Histrico
Opes disponveis na aba Histrico

OPO DESCRIO
Servidor de Banco de Dados Define o servidor de Banco de
Dados. Este campo equivale
propriedade DbServer

Nome da tabela Determina o nome da tabela. Este


campo equivale propriedade
TableName

Intervalo entre registros (ms) Determina a variao do intervalo de


tempo em milissegundos, ou seja, de
quanto em quanto tempo os dados
do Histrico so gravados na tabela.
Este campo equivale propriedade
ScanTime

Descartar dados da tabela principal Habilita ou desabilita o descarte dos


dados da tabela principal. O dado
antigo de acordo com o que for
definido na opo Descartar dados
mais antigos que. Este campo
equivale propriedade
EnableDiscard

Descartar dados mais antigos que Determina o intervalo de tempo


(minutos, horas, dias ou meses)
durante o qual os dados so
mantidos na tabela principal. Se um
dado da tabela for mais antigo que
o intervalo de tempo desta opo,
ele descartado. Este campo
equivale propriedade
DiscardInterval e o campo de
seleo da unidade de tempo do
intervalo equivale propriedade
DiscardTimeUnit

Histrico 581
OPO DESCRIO
Realizar o descarte a cada Determina o intervalo (minutos,
horas, dias ou meses) de descarte de
dados antigos da tabela. Este campo
equivale propriedade
VerificationUnit

Mover para a tabela de backup os Habilita ou desabilita o


dados descartados armazenamento dos dados
descartados na tabela secundria
(tabela de backup). Este campo
equivale propriedade
EnableBackupTable

Descartar do backup dados mais Determina o intervalo mximo de


antigos que tempo (minutos, horas, dias ou
meses) dos dados na tabela de
backup at serem descartados,
independente do tempo que os
dados permanecem na tabela
principal. Por exemplo, para manter
os dados por 24 meses na tabela
principal e mais seis meses na tabela
de backup, o valor desta opo deve
ser de 30 meses. Este intervalo deve
ser sempre maior que o configurado
no item Descartar dados mais
antigos que da tabela principal. Este
campo equivale propriedade
BackupDiscardInterval e o campo
de seleo da unidade de tempo do
intervalo equivale propriedade
BackupDiscardTimeUnit

Gerar Tabela Gera a estrutura da tabela no Banco


de Dados. Esta opo tambm est
disponvel clicando com o boto
direito do mouse no objeto Histrico
no Organizer e selecionando a
opo Gerar Estrutura no BD

582 Histrico
Ao clicar em Gerar Tabela, o Studio mostra a caixa de dilogo da figura a
seguir.

Mensagem do sistema

Quando a opo Gerar Tabela utilizada, a tabela especificada no Histrico


gerada, alm de uma tabela _Fields. Esta tabela possui as informaes de
cada campo cadastrado no Histrico.

Tabela de campos

Os campos disponveis na tabela _Fields do Histrico esto descritos na


tabela a seguir.

Histrico 583
Campos da tabela _Fields do Histrico

CAMPO DESCRIO
FieldDeadBand Banda morta

FieldDeadBandUnit Unidade utilizada pela banda morta


(em valores absolutos ou em
porcentagem)

FieldDescription Descrio do campo

FieldEU Unidade de engenharia

FieldHighEng Limite superior do Tag

FieldID ndice do campo cadastrado no


Histrico

FieldLowEng Limite inferior do Tag

FieldMaxRecTime Depois que este tempo expira, o


dado deve ser automaticamente
gravado

FieldMinRecTime Valor mnimo de tempo de variao


para armazenamento de um dado

FieldName Nome do campo do Histrico

FieldQuality Tipo da qualidade do campo. As


opes disponveis so 0: Sem
qualidade, 1: Mtodo anterior
verso 1.21 (onde 0: Valor duvidoso
e 1: Valor bom) ou 2: Qualidade
real do Tag

FieldSize Tamanho do campo

FieldSource Associao utilizada pelo campo


para obter os seus valores

584 Histrico
CAMPO DESCRIO
FieldType Tipo do campo

Histrico 585
A opo Vincular Histrico vincula o Histrico a tabelas existentes no
Banco de Dados. Quando esta opo habilitada, o Studio abre uma caixa de
dilogo para determinar quais as tabelas so vinculadas ao Histrico
corrente, conforme a figura a seguir.

Seleo de tabela para vincular ao


Histrico

Quando a tabela selecionada e clica-se em OK, o Studio mostra a


mensagem da figura a seguir.

586 Histrico
Mensagem do sistema

Clicando em Cancel, os campos configurados na tabela permanecem com as


configuraes atuais. J clicando em OK, todos os campos, ndices e chaves
primrias definidas no Histrico so substitudos pelos dados da tabela
selecionada.

Quando este item utilizado, outras duas opes so habilitados: Manter


Histrico sem vnculos diretos com tabela existente e Buscar campos
da tabela original .

Quando a opo Manter Histrico sem vnculos diretos com tabela


existente habilitada, o Studio mostra a mensagem da figura a seguir.

Mensagem quanto configurao do Histrico

Clicando em Cancel, a tabela permanece com as configuraes atuais. J


clicando em OK, a tabela reinicializada com seus campos iniciais, onde h
somente o campo padro habilitado (E3TimeStamp).

Histrico 587
Histrico aps habilitar a opo Manter histricos sem vnculo direto com
a tabela existente

J a opo Buscar campos da tabela original recupera os dados do


Histrico vinculado tabela existente, que haviam sido apagados.

Histrico utilizando a opo Buscar campos da tabela original

588 Histrico
CAPTULO
Consultas
17
O objeto Consulta (ou Query) auxilia no processo de definio de consultas
no Banco de Dados da aplicao. Toda vez que os objetos E3Browser ou
Relatrio buscam dados de um Banco de Dados, necessrio enviar um
comando, de forma que se saiba quais os dados desejados para aquele
objeto. Logo, toda vez que uma aplicao precisar gravar ou buscar dados
armazenados em um Banco de Dados, so enviados comandos no formato
SQL (Structured Query Language). A Consulta apresenta uma interface amigvel,
que permite a construo das consultas em uma forma grfica e o
acompanhamento imediato da sintaxe SQL que est sendo gerada. A consulta
permite mostrar os dados dos ltimos N dias, horas ou meses, data final ou
inicial e consultas.

O Assistente da consulta responsvel por criar o texto que executa o filtro


ou a consulta, no sendo necessrio para o usurio saber detalhes como
data, etc. Para utilizar este recurso, siga estes procedimentos:

1. Clique com o boto direito do mouse em uma Tela do projeto e selecione


a opo Inserir - Standard - Consulta.

NOTA
Quando criado um objeto Relatrio ou E3Browser, o objeto Consulta
adicionado automaticamente a estes objetos. No entanto, tambm pode-se
inserir este objeto em uma Pasta de Dados, em uma Tela, em um Viewer ou
em uma Pasta do Viewer. Para maiores detalhes, veja os captulos
correspondentes.

2. Antes de definir a Consulta, deve-se informar em qual Servidor de Banco


de Dados a Consulta busca os dados. Para tanto, selecione o servidor na
caixa de listagem Nome do Servidor.

Consultas 589
Definio do Servidor Banco de Dados

A configurao da Consulta depende do objeto ao qual ela est relacionada.

Configuraes da Consulta

Para verificar quais as configuraes necessrias da Consulta, veja os


captulos Relatrios e E3Browser.

590 Consultas
Algumas das propriedades da Consulta podem ser configuradas atravs da
Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso
necessite configurar alguma propriedade, localize-a na Lista de Propriedades
e faa os devidos ajustes. Para maiores informaes, consulte o Manual de
Referncia e Scripts do E3.

Consultas 591
17.1 Criando uma Consulta
Quando um E3Browser ou um Relatrio criado no projeto, uma Consulta
automaticamente inserida como objeto filho, com o nome "Consulta1". Para
utilizar este recurso, siga estes procedimentos:

1. Ao clicar com o boto direito do mouse na Consulta e selecionar o item


Configurar, uma janela mostrada solicitando a identificao do Servidor
de Banco de Dados da aplicao.

Definio do Servidor Banco de Dados na Consulta

2. Aps ser definido o servidor Banco de Dados, uma nova janela aparece
com tabelas que foram encontradas no Banco de Dados, permitindo a sua
seleo.

592 Consultas
Adio de tabela

3. Selecione as tabelas que fazem parte da consulta e clique em OK.

4. Depois de definidas as tabelas, a janela de definio da Consulta


mostrada, contendo as quatro abas a seguir:

Campos

Variveis

Visualizar

SQL

Consultas 593
Configurao da Consulta

Estas abas so descritas nos prximos tpicos.

594 Consultas
17.1.1 Aba Campos
Esta aba mostra todos os campos das tabelas usadas na Consulta. Ao clicar
em , possvel selecionar outras tabelas para a Consulta.

Inserindo uma tabela

Para selecionar todos os campos da tabela para que faam parte da Consulta,
selecione o primeiro item da lista de seleo, correspondente ao smbolo *
(asterisco). Para adicionar um campo especfico, selecione sua caixa de
seleo correspondente.

Consultas 595
Selecionando campos de
uma tabela

Devido questes de performance, importante adicionar Consulta


somente campos que realmente interessam para a anlise.

Na rea de colunas, os campos escolhidos so mostrados.

rea de colunas

Cada coluna mostra propriedades para cada campo da tabela ou tabelas


selecionadas, conforme a tabela a seguir.

Opes disponveis para a configurao de colunas

596 Consultas
OPO DESCRIO
Colunas Mostra o nome das colunas
selecionadas. Ao clicar na caixa de
combinao de cada linha, pode-se
redefinir a coluna desejada

Ttulo Permite que um novo nome seja


definido para a coluna (tambm
conhecido como alias)

Tabela Mostra o nome da tabela de origem


do campo

Mostrar Habilita ou desabilita o campo

Ordenao Permite ordenar os valores: Sem


ordenao, Ascendente (valores
menores primeiro) ou Descendente
(valores maiores primeiro)

Ordem Define a prioridade quando mais de


um campo possui ordenao

Agrupado por Permite que os dados sejam


agrupados a cada novo valor do
campo

Funo Permite definir a execuo de uma


funo para o campo

Filtro Define um critrio de consulta, como


por exemplo intervalos de data

Consultas 597
Ao definir um filtro, a janela da figura a seguir mostrada, permitindo que se
defina o tipo de comparao e o valor a ser comparado.

Definindo um filtro

O tipo de dado de comparao pode ser definido ao clicar na caixa de


seleo correspondente e selecionar um dos tipos na lista de opes.

598 Consultas
Configuraes para a definio do filtro

O valor de comparao pode ser uma constante (por exemplo, 123, 45,
"ABCD", etc.) ou uma varivel definida pelo usurio. Para criar uma varivel,
informe um nome qualquer entre os seguintes smbolos:

<% %> se o valor for numrico

'<% %>' se o valor for uma String

#<% %># se o valor for uma data

O valor da varivel pode ser definido na aba Variveis ou atravs do


mtodo SetVariableValue, via script.

Consultas 599
17.1.2 Aba Variveis
Esta aba permite definir valores padro para variveis definidas pelo usurio.
Estas variveis tambm podem ter seu valor alterado em tempo de execuo
utilizando o mtodo SetVariableValue.

Aba Variveis

As colunas desta aba so descritas na tabela a seguir.

Opes disponveis na aba Variveis

OPO DESCRIO
Nome O nome da varivel definida pelo
usurio

600 Consultas
OPO DESCRIO
Valor Uma caixa de seleo onde o valor
do tipo de dados pode ser
selecionado. As opes so Empty,
NULL, Boolean, Char, Byte, Integer,
Word, Long, Dword, Currency,
Single, Double, Date, Decimal e
String

17.1.3 Aba Visualizar


Esta aba mostra uma prvia dos resultados da Consulta ao clicar em .
Tambm possvel limitar o nmero mximo de registros retornados,
permitindo agilizar a consulta.

Visualizao da Consulta

Consultas 601
17.1.4 Aba SQL
Nesta aba exibida a sintaxe SQL resultante da configurao realizada. Pode-
se editar diretamente a consulta, selecionando a opo Habilita edio direta
do SQL.

Aba SQL

Ao desmarcar a opo Habilita edio direta do SQL, todas as alteraes


so perdidas e a Consulta retorna s opes selecionadas nas abas Campos,
Variveis e Visualizar.

Aviso ao desabilitar a edio direta do SQL

602 Consultas
17.2 Uso dos Filtros da Consulta atravs de
Scripts
Configurar e confirmar se a Consulta est correta apenas um dos passos no
seu uso. O uso em tempo de execuo e as modificaes de valores dos
filtros definidos para a Consulta podem ser vistos no script a seguir. O
mtodo SetVariableValue o responsvel pela configurao da Consulta,
conforme os valores passados via script.
Set consulta = Screen.Item("E3Browser1").Item("Consulta1")
Consulta.SetVariableValue "DataIni", _
Application.GetObject("DadosFH.TagInterno1").Value
Consulta.SetVariableValue "DataFim", _
Application.GetObject("DadosFH.TagInterno2").Value
Screen.Item("E3Browser1").Requery()

O mtodo Requery possibilita que os novos parmetros de Consulta seja


realmente utilizados, visto que uma nova Consulta executada respeitando
estes novos valores.

17.3 Uso de Recordsets de uma Consulta


atravs de Scripts
Um outro uso interessante da Consulta trabalhar com Recordsets. Depois de
executada uma Consulta, possvel capturar o Recordset correspondente e
trabalhar com registros linha a linha, executar novas Consultas, etc. Na linha
de comando a seguir:
RS = TelaInicial.E3Browser1.Consulta1.GetADORecordset()

A varivel RS assume todas as caractersticas de um Recordset. A vantagem


do uso deste recurso que se forem feitas modificaes nas propriedades
do banco de dados, no necessrio ajustar cada um dos scripts que
acessam este banco de dados.

Consultas 603
CAPTULO
E3Browser
18
O E3Browser um controle ActiveX utilizado para visualizar dados
armazenados em Bancos de Dados. Pode-se configurar consultas utilizando
filtros de vrios tipos nos dados e atribuir cores para cada coluna, entre
outras configuraes. Este objeto utilizado para visualizar os Histricos,
alarmes ou qualquer tabela existente no Banco de Dados.

E3Browser

Para utilizar este recurso, siga estes procedimentos:

1. Insira um E3Browser no projeto clicando com o boto direito do mouse


na rea de trabalho e selecionando o item Inserir - E3Browser.

604 E3Browser
Inserindo um E3Browser na Tela

2. O E3Browser utiliza o objeto Consulta para auxiliar o usurio no processo


de definio de consultas no Banco de Dados da aplicao. Para maiores
informaes, consulte o captulo referente.

3. Caso necessite, configure as propriedades do E3Browser. Algumas das


propriedades deste objeto podem ser configuradas atravs da Lista de
Propriedades, sem a necessidade de criar scripts para isto. Caso necessite
configurar alguma propriedade, localize-a na Lista de Propriedades e faa
os devidos ajustes. Demais informaes sobre as funcionalidades das
propriedades deste objeto podem ser encontradas no Manual de
Referncia e Scripts do E3, em seu captulo respectivo.

E3Browser 605
18.1 Objeto Consulta no E3Browser
A Consulta um objeto do E3 que auxilia o usurio no processo de definio
de consultas no Banco de Dados da aplicao. Toda vez que o E3Browser for
buscar dados no Banco de Dados, necessrio enviar um comando, de forma
que se saiba quais os dados desejados para aquele objeto. Logo, toda vez
que uma aplicao E3 precisar gravar ou buscar dados armazenados em um
Banco de Dados, so enviados comandos no formato SQL (Structured Query
Language).

Consulta no objeto E3Browser

A Consulta apresenta uma interface amigvel que permite a construo das


consultas de forma grfica e o acompanhamento imediato da sintaxe SQL que
est sendo gerada.

NOTA
Um E3Browser no pode carregar consultas que se encontrem no servidor.

A aba Consulta mostra os campos disponveis na consulta. Tais campos


podem ser acessados clicando-se em Configurar, que abre o assistente de
configurao da consulta.

606 E3Browser
Aba Consulta

Para maiores informaes sobre a Consulta, veja o captulo Consultas.

18.2 Outras Configuraes


As configuraes disponveis no E3Browser so descritas nas sees
seguintes.

E3Browser 607
18.2.1 Aba Estilo
Atravs da aba Estilo pode-se definir a aparncia das divises (grade) das
clulas e dimenses das linhas e colunas.

Aba Estilo

Cada campo da aba Estilo possui uma propriedade correspondente. As


propriedades disponveis esto descritas na tabela a seguir.

Opes disponveis na aba Estilo

OPO DESCRIO
Estilo da grade Determina o estilo da grade do
E3Browser. Este campo equivale
propriedade GridLinesType do
E3Browser

Altura do cabealho Determina a altura, em pixels, do


cabealho do E3Browser. Este campo
equivale propriedade
FixedRowHeight do E3Browser

608 E3Browser
OPO DESCRIO
Largura da 1 coluna Determina a largura da primeira
coluna na tabela. Este campo
equivale propriedade
FixedColumnWidth do E3Browser

Altura das Linhas Determina a altura das linhas


restantes na tabela. Este campo
equivale propriedade RowHeight
do E3Browser

Largura das Colunas Determina a largura das colunas da


tabela. Este campo equivale
propriedade ColumnWidth do
E3Browser

E3Browser 609
18.2.2 Aba Opes
Na aba Opes, informe o intervalo de tempo em que os dados so
gravados e atualizados no E3Browser. A atualizao ocorre em milissegundos
(ms). Pode-se escolher a opo de no atualizar os dados, fazendo com que
as gravaes permaneam as mesmas. Na opo Tipo de seleo,
informado qual o tipo de seleo feita na tabela.

Aba Opes

Cada campo da aba Opes possui uma propriedade correspondente. As


propriedades disponveis esto descritas na tabela a seguir.

Opes disponveis na aba Opes

OPO DESCRIO
Informe o intervalo de tempo em Determina o intervalo de tempo em
que os dados sero atualizados que os dados so atualizados. Este
valor deve ser superior a 1000 ms.
Este campo equivale propriedade
RefreshTime do E3Browser

610 E3Browser
OPO DESCRIO
Informe qual ser o tipo de seleo Determina o tipo de seleo na
tabela do E3Browser. Este campo
equivale propriedade SelectRow
do E3Browser

18.2.3 Aba Cores


A aba Cor determina as cores do E3Browser, referentes s suas colunas e
clulas. Se a cor desejada no estiver na paleta de cores padro, necessrio
configur-la clicando em Editar Cor Personalizada (Edit Custom Color), que
abre a caixa de dilogo de edio de cor.

Aba Cor

As opes disponveis deste item esto descritas na tabela a seguir.

Opes disponveis da aba Cor

OPO DESCRIO
Propriedades (Properties) Determina a cor conforme a
propriedade selecionada

E3Browser 611
OPO DESCRIO
Conjunto de Cores (Color Set) Determina o conjunto de cores a ser
utilizado: Cores padro ou Cores do
Windows

Paleta de Cores (Color Palette) Determina a cor da propriedade


selecionada

Editar Cor Personalizada (Edit Edita uma nova cor personalizada,


Custom Color) diferente das cores padro

NOTA
O nome da aba aparece no idioma do Windows, e no necessariamente no
idioma do E3.

612 E3Browser
18.2.4 Aba Fonte
Na aba Fonte, definem-se as especificaes de fontes no E3Browser.

Aba Fonte

As opes disponveis so referentes a tipo, tamanho e efeitos da fonte.

NOTA
O nome da aba aparece no idioma do Windows, e no necessariamente no
idioma do E3.

E3Browser 613
CAPTULO
E3Chart
19
O E3Chart um componente ActiveX criado especialmente para trabalhar em
conjunto com o E3. Com ele, possvel exibir grficos mostrando Tags
variando em tempo real, bem como dados histricos gravados em um Banco
de Dados.

O E3Chart composto por vrias colees. Uma coleo (collection) um


objeto especial que gerencia um conjunto de objetos semelhantes. O E3Chart
possui as seguintes colees:

Coleo de Penas: Gerencia o conjunto de Penas criadas para manipular


a sequncia de dados representada no E3Chart

Coleo de Eixos: Gerencia os Eixos do E3Chart, onde podem ser


configuradas diferentes escalas a serem associadas aos dados das Penas

Coleo de Consultas: Gerencia as consultas com informaes sobre as


Penas (por exemplo, no caso de grficos que mostram dados histricos
que j foram gravados em um Banco de Dados)

Coleo de Legendas: Gerencia as colunas da Legenda do E3Chart, onde


so mostradas as informaes sobre as Penas

Para utilizar os recursos do E3Chart, siga estes procedimentos:

1. Insira um E3Chart no projeto clicando com o boto direito do mouse na


Tela e selecionando a opo Inserir - E3Chart.

614 E3Chart
Inserindo um E3Chart na Tela

2. Caso seja necessrio, configure as propriedades do E3Chart. Algumas das


propriedades deste objeto podem ser configuradas atravs da Lista de
Propriedades, sem a necessidade da criao de scripts para isto. Caso
necessite configurar alguma propriedade, localize-a na Lista de
Propriedades e faa os devidos ajustes. Demais informaes sobre as
funcionalidades das propriedades deste objeto podem ser encontradas
no Manual de Referncia e Scripts do E3, em seu captulo
correspondente.

19.1 Configuraes
Para configurar um E3Chart, clique com o boto direito do mouse no objeto e
selecione a opo Propriedades.

E3Chart 615
19.1.1 Abas Item, Posio e Geral
Atravs da aba Item, possvel visualizar o nome do objeto e atribuir-lhe uma
descrio.

Aba Item

Cada campo da aba Item possui uma propriedade correspondente. As


opes disponveis esto descritas na tabela a seguir.

Opes disponveis na aba Item

OPO DESCRIO
Nome Determina o nome do objeto. Esta
opo equivale propriedade Name
do E3Chart

Documentao Texto livre que possibilita a


documentao das funcionalidades e
caractersticas do objeto pelo
programador. Esta opo equivale
propriedade DocString do E3Chart

616 E3Chart
A aba Posio determina o posicionamento do E3Chart na Tela.

Aba Posio

Cada campo da aba Posio possui uma propriedade correspondente. As


opes disponveis esto descritas na tabela a seguir.

Opes disponveis na aba Posio

OPO DESCRIO
X Define a coordenada horizontal
esquerda do objeto, em unidades
Himetric. Esta opo equivale
propriedade X do E3Chart

Y Define a coordenada vertical


superior do objeto, em unidades
Himetric. Esta opo equivale
propriedade Y do E3Chart

E3Chart 617
OPO DESCRIO
Largura Determina a largura do objeto. Esta
opo equivale propriedade Width
do E3Chart

Altura Determina a altura do objeto. Esta


opo equivale propriedade
Height do E3Chart

618 E3Chart
Atravs da aba Geral, possvel especificar o estilo e a aparncia do grfico.

Aba Geral

Cada campo da aba Geral possui uma propriedade correspondente. As


opes disponveis esto descritas na tabela a seguir.

Opes disponveis na aba Geral

OPO DESCRIO
Mostrar ttulo Exibe o ttulo do grfico. Esta opo
equivale propriedade Title do
E3Chart

Mostrar ttulo com a cor Determina a cor do texto do ttulo do


grfico. Esta opo equivale
propriedade TitleColor do E3Chart

E3Chart 619
OPO DESCRIO
Mostrar borda Habilita ou desabilita uma borda
externa no E3Chart, quando a
visualizao das escalas est
desabilitada. Esta opo equivale
propriedade ShowBorder do
E3Chart

Mostrar o fundo do grfico com a Determina a cor de fundo do grfico.


cor Esta opo equivale propriedade
BackColor do E3Chart

Mostrar o fundo da grade com a Determina a cor de fundo da grade


cor do grfico. Esta opo equivale
propriedade GridBackColor do
E3Chart

Intervalo entre as atualizaes Determina o intervalo entre as


(segundos) atualizaes do desenho no grfico.
Esta opo equivale propriedade
RefreshTime do E3Chart

620 E3Chart
19.1.2 Aba Eixos
O objeto Coleo de Eixos representa o conjunto de Eixos contidos no
E3Chart. Os Eixos so escalas colocadas no contorno da grade do E3Chart.

Atravs da aba Eixos possvel adicionar e remover Eixos da Coleo de


Eixos, bem como configurar suas propriedades individualmente.

Aba Eixos

Quando o E3Chart criado, dois Eixos principais so criados


automaticamente: Eixo Horizontal e Eixo Vertical. Estes so os Eixos padro,
e no podem ser removidos. Ao clicar em Adicionar, criado um novo Eixo
no grfico e aberta uma janela de configurao que permite determinar as
propriedades do objeto Eixo. Esta janela possui as abas Geral, Escala e
Referncia Visual, e tambm pode ser aberta ao clicar em Configurar.

A aba Geral contm a informao que identifica a Pena no sistema.

E3Chart 621
Aba Geral

Cada campo da aba Geral possui uma propriedade ou mtodo


correspondente. As opes disponveis esto descritas na tabela a seguir.

Opes disponveis na aba Geral

622 E3Chart
OPO DESCRIO
Nome Determina o nome do Eixo do
grfico. Esta opo equivale
propriedade Name do Eixo

Posio Determina a posio do Eixo no


grfico: Direita ou Esquerda (Eixo
vertical), Base ou Topo (Eixo
horizontal). Esta opo equivale
propriedade Position do Eixo

Espelhar o eixo Mostra o Eixo tambm do lado


oposto ao escolhido, com efeito de
espelho. Esta opo equivale
propriedade Mirror do Eixo

Ttulo do eixo Determina o ttulo do Eixo. Esta


opo equivale propriedade Title
do Eixo

Cor da escala Determina a cor da escala. Esta


opo corresponde propriedade
Color do objeto Eixo

Visvel Determina a visibilidade do Eixo no


grfico. Esta opo equivale
propriedade Visible do Eixo

Texto na cor da escala Determina se a cor do texto do Eixo


tem a mesma cor da escala. Esta
opo equivale propriedade
EnableTextColor do Eixo

Cor das linhas da grade Determina a cor das linhas na grade.


Esta opo equivale propriedade
GridColor do Eixo

Estilo da linha Determina o estilo da linha da grade


do grfico. Esta opo equivale
propriedade GridStyle do Eixo

E3Chart 623
OPO DESCRIO
Mostrar as linhas na grade Habilita a visualizao das linhas na
grade. Esta opo equivale
propriedade ShowGrid do Eixo

Intervalo entre divises Determina o intervalo entre os


marcadores da escala, caso a opo
Automtico esteja desabilitada. Se a
escala no for numrica, possvel
selecionar a unidade de tempo a que
este intervalo se refere. Esta opo
equivale ao mtodo SetTickSpacing
do Eixo

Automtico Seleciona automaticamente o


intervalo entre os marcadores da
escala. Esta opo equivale ao
mtodo SetTickSpacing do Eixo,
com 0 (zero) no valor do intervalo

Nmero de subdivises Determina o nmero de subdivises


entre os marcadores. Esta opo
equivale propriedade MinorTicks
do Eixo

624 E3Chart
Clique em Aplicar para visualizar as modificaes realizadas nesta aba e em
OK para salv-las.

A aba Escala define as configuraes da escala do Eixo.

Aba Escala

Cada campo da aba Escala possui uma propriedade ou um mtodo


correspondente. As opes disponveis esto descritas na tabela a seguir.
E3Chart 625
Opes disponveis na aba Escala

OPO DESCRIO
Escala numrica Define o Eixo como sendo uma escala
numrica. Esta opo equivale
propriedade ScaleType do Eixo. As
opes de configurao da escala
numrica so as seguintes:

Mnimo: Determina o valor mnimo


da escala numrica. Este campo
equivale ao mtodo SetMinMax do
Eixo

Mximo: Determina o valor mximo


da escala numrica. Este campo
equivale ao mtodo SetMinMax do
Eixo

Mostrar ltimo perodo (tempo Mostra o intervalo de tempo que o


real) Eixo mostra, sempre em relao
hora atual. Esta opo equivale ao
mtodo SetRealTimePeriod do Eixo

Intervalo de tempo (histrico) Determina um intervalo de tempo fixo.


As opes de configurao so as
seguintes:

Do dia: Data e hora iniciais do


intervalo

At o dia: Data e hora finais do


intervalo

Selecionar: Seleciona o intervalo de


tempo

Esta opo corresponde ao mtodo


SetHistoricPeriod do Eixo

Inverter Escala Inverte os valores da escala


selecionada

626 E3Chart
OPO DESCRIO
Formatao Determina a formatao dos valores
do Eixo, que pode ser Automtica ou
Personalizada. Esta opo
corresponde propriedade Format
do Eixo. Para mais informaes sobre
formatos, consulte o tpico
Formatao de Valores

E3Chart 627
Clique em Aplicar para visualizar as modificaes realizadas nesta aba e em
OK para salv-las.

A aba Referncia Visual define as informaes visuais para as linhas e


bandas de referncia de um Eixo.

Aba Referncia Visual

628 E3Chart
Cada campo da aba Referncia Visual possui uma propriedade
correspondente. As opes disponveis nesta aba esto descritas na tabela a
seguir.

Opes disponveis na aba Referncia Visual

OPO DESCRIO
Valor de referncia Define o valor usado como
referncia para a linha. Este valor se
refere ao eixo x ou y, dependendo se
a escala vertical ou horizontal. Esta
opo corresponde propriedade
ReferenceLineValue

Cor da linha Define a cor da linha de referncia.


Esta opo corresponde
propriedade ReferenceLineColor

Estilo do trao Define o estilo do trao da linha de


referncia. Os valores possveis para
esta opo so Slida, Tracejada,
Pontilhada, Trao-Ponto e Trao-
Ponto-Ponto. Esta opo
corresponde propriedade
ReferenceLineStyle

Espessura da linha Define a espessura da linha de


referncia. Os valores possveis para
esta opo vo de 0 (zero) a 11
pixels. Esta opo corresponde
propriedade ReferenceLineWidth

Visvel Indica se a linha de referncia est


visvel ou no. Esta opo
corresponde propriedade
ReferenceLineVisible

Valor superior Define o valor superior da banda de


referncia. Esta opo corresponde
propriedade NormalBandHighValue

E3Chart 629
OPO DESCRIO
Valor inferior Define o valor inferior da banda de
referncia. Esta opo corresponde
propriedade NormalBandLowValue

Cor de fundo Define a cor da banda de referncia.


Esta opo corresponde
propriedade NormalBandColor

Visvel Indica se a banda de referncia est


visvel ou no. Esta opo
corresponde propriedade
NormalBandVisible

Clique em Aplicar para visualizar as modificaes realizadas nesta aba e em


OK para salv-las. A figura a seguir mostra uma referncia visual configurada
no Eixo Vertical, com os seguintes valores:

Valor de referncia: 0 (zero)

Cor da linha: Preto (RGB(0, 0, 0))

Estilo do trao: Slido

Espessura da linha: 2 (dois) pixels

Valor superior: 50

Valor inferior: -50

Cor de fundo: Prata (RGB(192, 192, 192))

630 E3Chart
Exemplo de uso da referncia visual

E3Chart 631
19.1.3 Aba Penas
O objeto Coleo de Penas representa o conjunto de Penas contidas no
E3Chart. Cada Pena configurada para exibir dados em tempo real ou dados
histricos vindos da Consulta.

Atravs da aba Penas possvel adicionar e remover Penas da Coleo de


Penas, bem como configurar suas propriedades principais, individualmente ou
atravs da mltipla seleo de Penas.

Aba Penas

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Penas

632 E3Chart
OPO DESCRIO
Adicionar Pena Adiciona uma Pena. Mostra um
menu que permite selecionar o tipo
de Pena a ser criada: Tempo Real,
Histrica ou Tempo Real &
Histrica

Excluir Pena Remove as Penas selecionadas

Propriedades Abre a janela de propriedades da


Pena selecionada (esta operao s
permitida se apenas uma Pena
estiver selecionada)

Mover Pena para cima Move a Pena selecionada uma


posio para cima (esta operao
s permitida se apenas uma Pena
estiver selecionada)

Mover Pena para baixo Move a Pena selecionada uma


posio para baixo (esta operao
s permitida se apenas uma Pena
estiver selecionada)

A listagem de Penas do E3Chart permite copiar e colar Penas, tanto no


mesmo E3Chart quanto entre E3Charts diferentes. Clique com o boto direito
do mouse na Pena desejada (ou nas Penas selecionadas, em caso de mltipla
seleo) e selecione a opo Copiar (CTRL + C). No E3Chart de destino, abra
a janela de Propriedades e, na aba Penas, clique com o boto direito do
mouse na listagem de Penas e selecione a opo Colar (CTRL + V). A opo
de Recortar a Pena (CTRL + X) tambm est presente. No caso de o E3Chart
de destino j possuir uma Pena com o mesmo nome da Pena sendo copiada,
o nome automaticamente incrementado.

E3Chart 633
NOTA
Todas as opes das Penas selecionadas que esto disponveis via menu
contextual (atravs do clique com o boto direito do mouse) tambm esto
disponveis utilizando a combinao de teclas SHIFT + F10, que corresponde
tecla de aplicao ou de menu .

Algumas propriedades da Pena podem ser configuradas diretamente na lista


mostrada na aba Penas. Na coluna Estilo, ao clicar em , a janela da figura
a seguir mostrada.

Estilo da Pena

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Estilo da Pena

OPO DESCRIO
Cor principal Define a cor da linha da Pena.
Equivale propriedade Color

634 E3Chart
OPO DESCRIO
Cor do fundo Define a cor de fundo usada em uma
Pena do tipo rea. Equivale
propriedade BkColor

Tipo de desenho Define o tipo de desenho da Pena:


Linhas, Pontos, Linhas e Pontos ou
rea. Equivale propriedade
PenType

Estilo do trao Define o tipo de linha: Slida,


Tracejada, Pontilhada, Trao-Ponto,
Trao-Ponto-Ponto ou Sem Linha.
Equivale propriedade PenLineStyle

Espessura da linha Define a espessura da linha. Equivale


propriedade Width

Amostra Mostra um exemplo de como a Pena


desenhada no E3Chart

Ao selecionar uma Pena e clicar em , a janela de Propriedades da Pena


mostrada. Esta janela possui cinco abas: Geral, Dados, Estilo, Modo de
Ligao e Estatsticas.

A aba Geral contm as informaes que identificam a Pena no E3Chart.

E3Chart 635
Aba Geral

Cada campo da aba Geral possui uma propriedade correspondente. As


opes disponveis esto descritas na tabela a seguir.

Opes disponveis na aba Geral

636 E3Chart
OPO DESCRIO
Nome da Pena Indica o nome da Pena. Esta opo
equivale propriedade Name da
Pena

Cor principal Determina a cor da linha da Pena.


Esta opo equivale propriedade
Color da Pena

Visvel Indica o estado de visibilidade da


Pena no grfico. Esta opo equivale
propriedade Visible da Pena

Unidade de Engenharia Indica a unidade de engenharia


utilizada pela Pena. Esta opo
equivale propriedade EU da Pena

E3Chart 637
A aba Dados contm informaes de acordo com o tipo da Pena.

Aba Dados

Cada campo da aba Dados possui uma propriedade correspondente. As


opes disponveis esto descritas na tabela a seguir.

Opes disponveis na aba Dados

638 E3Chart
OPO DESCRIO
Tipo de pena Determina o tipo de Pena sendo
utilizada. Esta opo equivale
propriedade DataSourceType da
Pena

Link do eixo vertical Nome da Associao usada para


plotar o dado em uma escala
vertical. Esta opo equivale
propriedade YLink da Pena

Link do eixo horizontal Nome da Associao usada para


plotar o dado em uma escala
horizontal. Esta opo equivale
propriedade XLink da Pena

Nmero de amostras mantidas na Determina o nmero de amostras


memria nas Penas de tempo real. Esta opo
equivale propriedade BufferSize
da Pena

Usar a estampa de tempo Habilita ou desabilita a estampa de


tempo. A estampa de tempo o
valor de tempo que acompanha o
valor do Tag, indicando o momento
em que este valor foi alterado. Esta
opo equivale propriedade
UseTimeStamp da Pena. Se esta
opo estiver habilitada, a opo
Link do Eixo Horizontal permanece
inativa

Consulta local Determina a Consulta vinculada ao


E3Chart que utilizada nos dados do
Eixo. Esta opo equivale
propriedade QueryName da Pena

Consulta externa Determina a consulta externa, isto ,


os dados vm de uma consulta fora
do objeto E3Chart

E3Chart 639
OPO DESCRIO
Campo do eixo vertical Nome do campo da Consulta usado
para plotar o dado em uma escala
vertical. Esta opo equivale
propriedade YField da Pena

Campo do eixo horizontal Nome do campo da Consulta usado


para plotar o dado em uma escala
horizontal. Esta opo equivale
propriedade XField da Pena

Usar consulta automtica Indica se a Pena deve ou no usar


consulta automtica. A consulta
automtica no utilizada se o
E3Chart estiver utilizando um cdigo
SQL personalizado, se estiver usando
um Storage ou se possuir vrias
tabelas. Esta opo equivale
propriedade AutoQuery da Pena

Eixo vertical Especifica o Eixo vertical. Esta opo


equivale propriedade ScaleY da
Pena

Eixo horizontal Especifica o Eixo horizontal. Esta


opo equivale propriedade
ScaleX da Pena

640 E3Chart
A aba Estilo determina o estilo da Pena.

Aba Estilo

Cada campo da aba Estilo possui uma propriedade correspondente. As


opes disponveis esto descritas na tabela a seguir.

Opes disponveis na aba Estilo

E3Chart 641
OPO DESCRIO
Tipo de desenho Indica o tipo de desenho da Pena.
Esta opo equivale propriedade
PenType da Pena

Estilo do trao Determina o estilo do trao da Pena.


Esta opo equivale propriedade
PenLineStyle da Pena

Espessura da linha Determina a espessura da linha, em


pixels. Esta opo equivale
propriedade Width da Pena

Cor do fundo Determina a cor de fundo da linha.


Esta opo equivale propriedade
BkColor da Pena

Documentao Determina a documentao que


pode ser mostrada na Legenda. Esta
opo equivale propriedade
DocString da Pena

Habilita alarme alto Habilita a verificao do alarme alto.


Esta opo corresponde
propriedade EnableHighLimit da
Pena. A caixa de texto ao lado
possibilita estabelecer o limite deste
alarme, que equivale propriedade
HighLimit

Habilita alarme baixo Habilita a verificao do alarme


baixo. Esta opo corresponde
propriedade EnableLowLimit da
Pena. A caixa de texto ao lado
possibilita estabelecer o limite deste
alarme, que equivale propriedade
LowLimit

Cor de alarme Cor da Pena quando em alarme. Esta


opo equivale propriedade
LimitPenColor

642 E3Chart
OPO DESCRIO
Cor de fundo do alarme Cor do fundo da Pena quando em
alarme. Esta opo equivale
propriedade LimitPenBkColor

E3Chart 643
A aparncia da Pena, conforme a opo configurada, pode ser visualizada a
seguir.

Modo analgico de ligao entre os pontos

Modo digital de ligao entre os pontos

644 E3Chart
O modo como a Pena apresentada quando o scan
considerado representado pela cor verde e quando
este campo est desabilitado representado pelas cores
azul e rosa

A aba Modo de Ligao determina o estilo da ligao entre a parte histrica


e a parte de tempo real de uma Pena mista.

E3Chart 645
Aba Modo de Ligao

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Modo de Ligao

646 E3Chart
OPO 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

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 Define se mostra ou no os pontos


ruim de qualidade ruim. Equivale
propriedade ShowBadPoints da
Pena

Intervalo mximo para ligar os Especifica um tempo limite a ser


dados histricos aos de tempo real considerado para a conexo visual
(s) entre a parte histrica e a parte de
tempo real de uma Pena mista.
Corresponde propriedade
MaxGapTime

E3Chart 647
OPO DESCRIO
Realar linha quando MaxGapTime Reala a linha de ligao entre a
usado parte histrica e a parte de tempo
real. Corresponde propriedade
HighlightMaxGapTime da Pena

Cor da linha usada com Especifica a cor da linha de ligao.


MaxGapTime Corresponde propriedade
MaxGapTimeColor da Pena

Estilo da linha usada com Especifica o estilo da linha de


MaxGapTime ligao. Corresponde propriedade
MaxGapTimeStyle da Pena

A aba Estatsticas habilita o clculo de dados estatsticos.

648 E3Chart
Aba Estatsticas

Cada campo da aba Estatsticas possui uma propriedade correspondente. As


opes disponveis esto descritas na tabela a seguir.

Opes disponveis na aba Estatsticas

OPO DESCRIO
Calcular dados estatsticos Habilita o clculo de dados
estatsticos

E3Chart 649
OPO DESCRIO
Mostrar linha da mdia Exibe a linha da mdia dos dados
estatsticos. Ver NOTA a seguir

Mostrar mnimo e mximo Exibe o mnimo e o mximo dos


dados estatsticos

NOTA
A mdia calculada pela opo Mostrar linha da mdia no uma mdia
aritmtica simples, e sim uma mdia aritmtica ponderada em relao ao
intervalo de tempo dos dados estatsticos.

650 E3Chart
19.1.4 Aba Legenda
A Legenda utilizada para exibir as Penas visveis no grfico e informaes
sobre elas, tais como cor, nome da Pena, estado, etc.

Objeto Legenda em tempo de execuo

Atravs da aba Legenda, possvel configurar as informaes referentes ao


objeto Legenda e suas colunas.

E3Chart 651
Propriedades do objeto Legenda

Alguns campos da aba Legenda possuem uma propriedade ou mtodo


correspondente. As opes disponveis esto descritas na tabela a seguir.

Opes disponveis na aba Legenda

652 E3Chart
OPO DESCRIO
Fonte Permite configurar o nome, o estilo e
o tamanho da fonte da Legenda.
Clique em para abrir a janela
padro de seleo de fontes do
Windows. Esta opo corresponde
propriedade Font da Legenda

Mostrar Legenda Habilita a visualizao da Legenda. A


caixa de seleo ao lado desta opo
define o posicionamento da Legenda.
Esta opo equivale propriedade
Visible da Legenda, e a opo de
seleo da posio da Legenda
equivale propriedade LegendPos
da Legenda

Tamanho (pixels) Determina o tamanho da Legenda, em


pixels. Pode ser a altura ou a largura,
dependendo da posio. A outra
dimenso acompanha a do E3Chart.
Esta opo corresponde
propriedade Size da Legenda

Cor do fundo Determina a cor de fundo da


Legenda. Esta opo corresponde
propriedade BackColor da Legenda

Estilo da borda Determina o estilo da borda da


Legenda. Esta opo corresponde
propriedade BorderStyle da Legenda

Mostrar texto utilizando Determina a cor do texto da Legenda.


As opes disponveis so A cor da
pena ou A seguinte cor, onde se
pode selecionar uma cor
personalizada. Esta opo
corresponde propriedade
TextColor da Legenda

E3Chart 653
OPO DESCRIO
Colunas disponveis Lista as colunas disponveis para
visualizao na Legenda

Colunas selecionadas Mostra as colunas selecionadas para


a Legenda

Adicionar Adiciona uma coluna Legenda. Esta


opo equivale ao mtodo
InsertColumn da Legenda

Remover Remove a coluna selecionada da


Legenda. Esta opo equivale ao
mtodo RemoveColumn da Legenda

Propriedades Abre uma caixa de dilogo para a


configurao das propriedades dos
campos das colunas da Legenda

Sobe e Desce Troca a posio da coluna na


Legenda. Estas opes equivalem ao
mtodo ChangeColumnPos da
Legenda

Mostrar ttulos das colunas Habilita o cabealho da Legenda. Esta


opo equivale propriedade
ShowHeader da Legenda

Cor do fundo das colunas Define a cor de fundo das colunas do


cabealho da Legenda. Esta opo
equivale propriedade
HeaderBackColor da Legenda

Cor do texto das colunas Define a cor do texto das colunas do


cabealho da Legenda. Esta opo
equivale propriedade
HeaderTextColor da Legenda

654 E3Chart
OPO DESCRIO
Estilo da borda das colunas Define o estilo das bordas das
colunas do cabealho da Legenda.
Esta opo equivale propriedade
HeaderBorderStyle da Legenda

Os campos da listagem Colunas disponveis esto descritos na tabela a


seguir.

Opes disponveis para identificao de colunas

1
Este valor pode ser usado diretamente nos mtodos InsertColumn
(parmetro Col), Item e RemoveColumn

OPO VALOR1 NOME DESCRIO


Cor da Pena 6 Color Mostra a cor da
Pena

Descrio da 5 Description Mostra a


Pena descrio contida
na propriedade
DocString da
Pena

DifX 15 DiffX Mostra a


diferena entre os
cursores inicial e
final

DifY 16 DiffY Mostra a


diferena no Eixo
Y entre os pontos
interpolados
inicial e final

EscalaX 8 ScaleX Mostra o nome


do Eixo X
associado Pena

E3Chart 655
OPO VALOR1 NOME DESCRIO
EscalaY 9 ScaleY Mostra o nome
do Eixo Y
associado Pena

EscalaYMx 20 ScaleYMax Mostra o valor


mximo da escala
vertical

EscalaYMn 21 ScaleYMin Mostra o valor


mnimo da escala
vertical

Estado 7 Status Mostra o estado


de funcionamento
atual da Pena

FimX 14 XEnd Mostra a posio


final do cursor

FimY 18 YEnd Mostra o ponto


interpolado onde
o cursor final
cruza com a Pena

IncioX 13 XBegin Mostra a posio


inicial do cursor

IncioY 17 YBegin Mostra o ponto


interpolado onde
o cursor inicial
cruza com a Pena

MximoY 12 MaxY Mostra o valor


mximo da Pena
no intervalo

MdiaY 10 AverageY Mostra o valor


mdio da Pena no
intervalo

656 E3Chart
OPO VALOR1 NOME DESCRIO
MnimoY 11 MinY Mostra o valor
mnimo da Pena
no intervalo

Nome da pena 0 Name Mostra o nome


da Pena

Nome do tag X 1 TagX Mostra o nome


do Tag associado
ao Eixo X

Nome do tag Y 2 TagY Mostra o nome


do Tag associado
ao Eixo Y

Unidade 19 EU Mostra a unidade


de engenharia
utilizada pela Pena

Valor do tag X 3 TagXValue Mostra o valor da


pesquisa no Eixo
X

Valor do tag Y 4 TagYValue Mostra o valor da


pesquisa no Eixo
Y

E3Chart 657
Ao clicar em Propriedades, mostrada uma caixa de dilogo para
configurao do objeto Coluna da Legenda.

Propriedades da coluna

Cada campo da caixa de dilogo Propriedades da coluna possui uma


propriedade correspondente. As opes disponveis esto descritas na tabela
a seguir.

Opes disponveis na janela Propriedades da coluna

OPO DESCRIO
Largura inicial Define a largura inicial da Coluna, em
pixels. Esta opo equivale
propriedade Width da Coluna da
Legenda

Ttulo da coluna Determina o ttulo da Coluna. Esta


opo equivale propriedade
Caption da Coluna da Legenda

Alinhamento do texto Determina o alinhamento do texto na


Coluna da Legenda. Esta opo
equivale propriedade TextAlign da
Coluna da Legenda

658 E3Chart
OPO DESCRIO
Formatador Determina o formatador da Coluna
selecionada. Esta opo equivale
propriedade Format da Coluna da
Legenda

19.1.5 Aba Consultas


As Consultas so necessrias para mostrar valores histricos no E3Chart.
Atravs da aba Consultas possvel adicionar ou remover Consultas, bem
como configur-las.

Aba Consultas

As opes disponveis nesta aba esto descritas na tabela a seguir.

Opes disponveis na aba Consultas

OPO DESCRIO
Consultas Mostra a Consulta selecionada para
edio

E3Chart 659
OPO DESCRIO
Configurar Configura a Consulta selecionada

Adicionar Adiciona uma nova Consulta. Para


obter maiores informaes
referentes s Consultas, veja o
captulo Consultas

Remover Remove a Consulta selecionada

NOTA
Ao clicar em Adicionar ou Configurar, uma caixa de dilogo aberta para
especificao do Servidor de Banco de Dados que guarda a Consulta. Os
procedimentos de definio da Consulta podem ser encontrados no
captulo Consultas.

660 E3Chart
19.1.6 Aba Fonte
Atravs da aba Fonte, possvel configurar a fonte do cabealho e das linhas
do E3Chart.

Aba Fonte

As opes disponveis so referentes a tipo, tamanho e efeitos da fonte.

NOTA
O nome da aba aparece sempre no idioma do Windows.

19.2 Exemplos de Utilizao


Os tpicos a seguir mostram alguns exemplos de utilizao do E3Chart.

E3Chart 661
19.2.1 Habilitando e Desabilitando Penas
O exemplo a seguir demonstra como habilitar ou desabilitar a conexo dos
dados de uma Pena no E3Chart. Para tanto, siga estes procedimentos:

1. Crie um E3Chart na Tela.

2. Abra a janela de propriedades do E3Chart e selecione a aba Penas. Crie


uma nova Pena de tempo real e associe-a a um Tag Demo no Eixo
vertical.

3. Crie dois botes de comando na Tela. No primeiro boto de comando,


escreva na propriedade Caption a descrio "Desabilitar Pena".

4. Abra a janela de propriedades deste boto e selecione a aba Scripts. No


evento Click, escreva o script a seguir.
Sub CommandButton1_Click()
Set Pen1= Screen.Item("E3Chart1").Pens.Item("Pena1")
Pen1.Disconnect()
End Sub

5. No segundo boto de comando, escreva na propriedade Caption a


descrio "Habilitar Pena".

6. Abra a janela de propriedades deste boto e selecione a aba Scripts. No


evento Click, escreva o script a seguir.
Sub CommandButton2_Click()
Set Pen1= Screen.Item("E3Chart1").Pens.Item("Pena1")
Pen1.Connect()
End Sub

7. Execute o projeto e verifique o resultado.

662 E3Chart
19.2.2 Atualizando o E3Chart Histrico com os Dados
da ltima Hora
O exemplo a seguir demonstra como atualizar o E3Chart com os dados
histricos da ltima hora. Para este exemplo, necessrio que haja uma
Consulta a uma tabela do Banco de Dados previamente criada.

1. Crie um E3Chart na Tela.

2. Abra a janela de propriedades do E3Chart e selecione a aba Eixos. Clique


na opo Configurar do Eixo horizontal e, na aba Escala, selecione a
opo Intervalo de tempo (Histrico).

3. Selecione a aba Consultas e clique em Adicionar. O Studio mostra uma


caixa de dilogo para que se indique o nome do servidor de Banco de
Dados em que a tabela da consulta est armazenada.

4. Selecione o servidor de Banco de Dados na caixa de dilogo e clique em


OK. O Studio abre a janela de configuraes da Consulta.

5. Selecione na tabela histrica o campo E3TimeStamp e algum outro


campo de dados para mostrar no grfico.

6. No campo E3TimeStamp, crie um filtro conforme as especificaes a


seguir.

E3Chart 663
Filtro a ser criado no campo E3TimeStamp

7. Aps ter criado o filtro conforme as especificaes anteriores, clique em


OK.

8. Crie uma nova Pena. Abra a janela de propriedades desta Pena e, na aba
Dados, item Tipo de Pena, selecione a opo Histrica usando a
Consulta e indique o campo da Consulta configurada.

9. No item Campo do eixo vertical, indique um campo da tabela. No item


Campo do eixo horizontal, indique o campo E3TimeStamp. Clique em
OK.

10. Crie um novo boto na Tela e, na propriedade Caption, escreva "Atualizar


E3Chart Histrico".

11. Selecione a aba Scripts deste boto e, no evento Click, escreva o script a
seguir.
Sub CommandButton3_Click()
Set Chart = Screen.Item("E3Chart1")
Set Consulta = Chart.Item("Consulta1")
Consulta.SetVariableValue "Ini", Now 1 / 24
Consulta.SetVariableValue "Fim", Now
Chart.HorScaleBegin = Now 1 / 24
Chart.HorScaleEnd = Now
Chart.Queries.UpdateData()
End Sub

664 E3Chart
12. Execute o projeto e verifique o resultado.

19.2.3 Habilitando ou Desabilitando a Visualizao da


Pena
O exemplo a seguir demonstra como habilitar ou desabilitar a visualizao de
uma Pena no E3Chart. Para tanto, siga estes procedimentos:

1. Crie um E3Chart na Tela.

2. Abra a janela de propriedades do E3Chart e selecione a aba Penas. Crie


uma nova Pena de tempo real e associe-a a um Tag Demo, no Eixo
vertical.

3. Crie dois botes na Tela. No primeiro, mude a propriedade Caption para


"Desabilitar Visualizao da Pena".

4. Abra a janela de propriedades deste boto e selecione a aba Scripts. No


evento Click, escreva o script a seguir.
Sub CommandButton1_Click()
Set Pen1= Screen.Item("E3Chart1").Pens.Item("Pena1")
Pen1.Visible = False
End Sub

5. No segundo boto de comando, mude a propriedade Caption para


"Habilitar Visualizao da Pena".

6. Abra a janela de propriedades deste boto e selecione a aba Scripts. No


evento Click, escreva o script a seguir.
Sub CommandButton2_Click()
Set Pen1 = Screen.Item("E3Chart1").Pens.Item("Pena1")
Pen1.Visible = True
End Sub

7. Execute o projeto e verifique o resultado.

E3Chart 665
19.2.4 Criao de uma Pena por Script
O exemplo a seguir demonstra como criar uma Pena por script. Para tanto,
siga estes procedimentos:

1. Crie um E3Chart na Tela.

2. Crie um boto de comando na Tela. Na propriedade Caption, digite o


texto "Criar Pena".

3. Abra a janela de propriedades deste boto de comando e selecione a


aba Scripts. Digite o script a seguir no evento Click.
Sub Texto1_Click()
Set E3Chart1 = Screen.Item("E3Chart1")
MsgBox "Clique em OK para criar a Pena"
Set Pen = E3Chart1.Pens.AddPen("Pen1")
Pen.DataSourceType = 0 ' Tempo real
Pen.VerDataSource = "Dados.TagDemo1"
Pen.UseTimeStamp = True ' No X usa o timestamp
Pen.Color = RGB(255, 0, 0)
Pen.DocString = "teste"
MsgBox "Clique em OK para conectar"
Pen.Connect() ' Comea a receber os dados
MsgBox "Clique em OK para enquadrar"
E3Chart1.FitPen(0)
MsgBox "Clique em OK para desconectar"
Pen.Disconnect() ' Para de receber os dados
MsgBox "Clique em OK para remover a Pena"
E3Chart1.Pens.Remove(Pen.Name)
End Sub

4. Execute o projeto e verifique o resultado.

19.3 Caractersticas Especficas de Runtime


O E3Chart possui uma srie de caractersticas que se aplicam apenas em
tempo de execuo. Estas caractersticas so explicadas nos tpicos a seguir.

19.3.1 Opes do Ponteiro do Mouse


Clicando na legenda do grfico, possvel redimensionar suas colunas. Para
tanto, selecione a coluna desejada e arraste-a.

666 E3Chart
19.3.2 Opes do Menu Contextual
Clicando com o boto direito do mouse no grfico do E3Chart, abre-se o
menu de opes mostrado na figura a seguir.

Opes do menu do E3Chart em


tempo de execuo

As opes disponveis esto descritas na tabela a seguir.

Opes disponveis do menu contextual do E3Chart em tempo de


execuo

OPO DESCRIO
Caixa de zoom Coloca o ponteiro do mouse no
modo zoom por rea selecionada.
Esta opo est disponvel nos
grficos de escala numrica em XY e
escala fixa

Mover Coloca o ponteiro do mouse em


modo de movimentao das escalas

E3Chart 667
OPO DESCRIO
Mover horizontalmente Coloca o ponteiro do mouse em
modo de movimentao das escalas
somente na direo horizontal

Pesquisar Coloca o ponteiro do mouse em


modo de pesquisa de valores nos
dados das Penas

Pesquisar Intervalos Habilita a opo de pesquisa de


intervalos de tempo

Menos Zoom Diminui o zoom de todo o Eixo

Mais Zoom Aumenta o zoom de todo o Eixo

Enquadrar tudo Enquadra a Pena selecionada em


ambos os Eixos

Enquadrar verticalmente Enquadra a Pena selecionada


somente no Eixo vertical

Enquadrar horizontalmente Enquadra a Pena selecionada


somente no Eixo horizontal

Enquadrar Pena Enquadra a Pena selecionada ou


todas as Penas existentes

668 E3Chart
19.3.3 Opo Pesquisar
Esta opo permite pesquisar valores dos pontos das Penas. O valor
mostrado na legenda, atravs das colunas Valor do Tag X e Valor do Tag Y.

A pesquisa mostrada nos campos Valor do TagX e Valor do TagY

NOTA
Para obter maiores informaes sobre as colunas Valor do Tag X e Valor
do Tag Y, veja o tpico sobre as configuraes da Aba Legenda.

E3Chart 669
19.3.4 Opo Pesquisar Intervalos
Neste modo so mostrados dois cursores, que definem o intervalo de
clculos estatsticos. Os valores dos cursores so mostrados nas colunas
IncioX, IncioY, FimX e FimY. Para alterar a posio de um cursor, selecione-
o clicando com o boto esquerdo do mouse e arraste-o para a posio
desejada.

Pesquisa de intervalos

670 E3Chart
19.3.5 Coluna Estado da Legenda
A coluna Estado da legenda mostra o estado atual de cada Pena. O contedo
desta mensagem composto por uma informao de erro, se houver, e
informaes sobre a situao atual da Pena, como por exemplo o nmero de
pontos. As tabelas a seguir mostram as possveis mensagens de erro e de
informao para Penas de Tempo Real e Histricas. Se a Pena do tipo
Mista, a mensagem final uma combinao da mensagem da parte de
Tempo Real e Histrica. Caso haja mensagens de erro, a linha da coluna
mostrada em vermelho enquanto o erro persistir.

Mensagens de status da parte de tempo real

MENSAGEM SIGNIFICADO
Erro: Parte de tempo real No houve conexo da parte de
desconectada (YLink='Nome do tempo real da Pena. Verifique o
Tag') (XLink='Nome do Tag') nome dos Tags nas propriedades
YLink e XLink da Pena

Info: Tempo real n pts Mostra o nmero total de pontos da


parte de tempo real

Mensagens de status da parte histrica

MENSAGEM SIGNIFICADO
Info: Consulta aguardando Aguardando a inicializao da
consulta. Significa que alguma
mudana ou pedido de atualizao
da consulta foi detectado

Info: Consulta inicializando A consulta est iniciando. Nesta fase


so validados os campos informados
na Pena

E3Chart 671
MENSAGEM SIGNIFICADO
Erro: Consulta: Falha na Antes de carregar os dados da
inicializao consulta, o E3Chart precisa conhecer
os campos que a consulta contm
para realizar a associao entre
estes campos e as propriedades
XField e YField. Ocorreu uma falha
ao buscar estes campos, que pode
ser tanto um erro de rede quanto um
erro de sintaxe SQL

Erro: Campo no encontrado O campo informado na propriedade


(XField = 'Nome do Campo') XField no foi encontrado na
consulta. Verifique se o campo est
selecionado na tela de edio da
consulta ou no cdigo SQL

Erro: Campo no encontrado O campo informado na propriedade


(YField = 'Nome do Campo') YField no foi encontrado na
consulta. Verifique se o campo est
selecionado na tela de edio da
consulta ou no cdigo SQL

Erro: 'Nome da Consulta' Indica que houve um erro na


'Mensagem de Erro' consulta, no sendo possvel
recuperar os dados. As possveis
mensagens mostradas em Mensagem
de Erro so descritas na tabela a
seguir

Info: n pts Mostra o nmero total de pontos da


parte histrica

Info: Carregando Indica que os dados da consulta


ainda esto sendo carregados do
servidor

Erro: Consulta invlida A consulta indicada pela


(QueryName = 'Nome da propriedade QueryName da Pena
Consulta') no foi encontrada pelo E3Chart

672 E3Chart
Mensagens especficas para falha na consulta

MENSAGEM SIGNIFICADO
Falha ao inserir dados No foi possvel carregar os dados
para a memria

Falha na criao da consulta No foi possvel criar a consulta

Erro ao executar a consulta No foi possvel executar a consulta

Falha ao baixar os dados do No foi possvel trazer do servidor


servidor os resultados da consulta

Falha ao pegar o nmero de No foi possvel trazer do servidor o


registros do servidor total de registros existentes na
consulta

Falha ao posicionar o cursor para o No foi possvel posicionar o cursor


incio no primeiro registro da consulta

Cursor ocupado Os registros da consulta no esto


disponveis para serem trazidos do
servidor

Falha ao pegar os dados do No foi possvel trazer do servidor


servidor os registros da consulta

Erro desconhecido Houve um erro inesperado ao tentar


trazer do servidor os dados da
consulta

E3Chart 673
CAPTULO
E3Playback
20
Uma ferramenta de playback visa facilitar o ps-operao, sobretudo a anlise
de ocorrncias. Sua necessidade justificada por permitir que o usurio
visualize, atravs das telas de monitoramento em tempo real, as variaes de
eventos e pontos analgicos em tempo passado que, em determinados
casos, pode ser complicado observando apenas relatrios de eventos e
valores analgicos.

Cabe ressaltar que um playback uma ferramenta que permite a um operador


experiente e conhecedor do processo interpretar os acontecimentos de forma
mais clara. No faz parte do escopo de um playback a identificao
automtica de soluo ou de causa de uma ocorrncia.

Um exemplo prtico de uso de um playback pode ser o seguinte:

O usurio, ao chegar em seu horrio de trabalho, recebe a informao de uma


grave ocorrncia acontecida durante a madrugada, por volta das 3h15min. Ele
pode ento abrir na ferramenta de playback uma tela que contm o ponto
gerador do evento e outros pontos relacionados, movendo o relgio para as
03h10min e clicando em Play. Ao observar a tela sendo animada com os dados
histricos, o usurio facilmente acompanha o estado geral do processo,
avanando e retrocedendo livremente no tempo at compreender perfeitamente a
causa da ocorrncia.

20.1 Objeto E3Playback


O E3Playback, a ferramenta de playback da Elipse, um ActiveX que executa
dentro do E3 Viewer ou do E3 WebViewer e que permite visualizar as Telas do
aplicativo utilizando dados histricos armazenados em bancos de dados.

O E3Playback busca no banco de dados os Tags referenciados nas Telas, bem


como os demais links entre Viewer e servidor (tais como os Tags do Viewer
com links para objetos do servidor), e mostra valores, animaes, estados e
grficos de acordo com as informaes existentes no banco de dados e o
perodo de playback definido.

674 E3Playback
20.2 Adicionar Playback ao Demo do E3
Este exemplo mostra como adicionar funcionalidades de playback ao
aplicativo de demonstrao que vem junto com a instalao do E3.

1. Crie uma nova Tela, chamada "TelaPlayback", e insira um ActiveX


E3Playback ocupando toda a rea de fundo da Tela.

Incluso do E3Playback em uma Tela

2. Abra a Lista de Propriedades e configure a propriedade DBServer do


E3Playback para apontar para o objeto Banco de Dados que contm os
dados histricos do aplicativo.

E3Playback 675
Selecionando um Banco de Dados

3. Abra a Lista de Propriedades e configure a propriedade InitialScreen do


E3Playback para apontar para o Quadro "FrameApp".

Selecionando um Quadro para a propriedade InitialScreen

4. Abra a Tela "UpperMenu" e insira a imagem Stopwatch no canto superior


direito (abra a Galeria e selecione a categoria Misc Symbols 1).

Tela UpperMenu

676 E3Playback
5. Clique duas vezes na imagem Stopwatch, adicione o Pick Abrir Tela no
evento Click para abrir a "TelaPlayback" no Quadro principal e configure-
o conforme as figuras a seguir.

Pick Abrir Tela

E3Playback 677
Configuraes do estilo da janela

6. Execute o aplicativo, abra o Viewer, clique em Portugus, depois em


Preview de Aplicaes, e finalmente clique no cone Stopwatch. Neste
momento deve aparecer a Tela de playback.

678 E3Playback
Tela de playback

7. Clique em para entrar no modo Online. Os primeiros dados de


playback so carregados, e o relgio de playback posicionado no centro
dos dados disponveis.

E3Playback 679
Tela de playback em modo Online

20.3 Interface de Usurio


A interface de usurio do E3Playback dividida em seis partes:

Barra de Ferramentas

Linha de Tempo

Marcadores

rea de Telas

Lista de Eventos

Lista de Tags

680 E3Playback
20.3.1 Barra de Ferramentas
A Barra de Ferramentas Playback rene os principais comandos para
operao do E3Playback.

Barra de ferramentas Playback

Esta barra de ferramentas possui as opes descritas na tabela a seguir.

Opes disponveis na barra de ferramentas Playback

CONE COMANDO AO
Reproduzir para Inicia a reproduo
trs dos dados no
horrio atual de
playback,
retrocedendo o
relgio de acordo
com a velocidade de
reproduo atual

Pausa Congela o relgio


de playback no
tempo atual

Reproduzir Inicia a reproduo


dos dados no
horrio atual de
playback, avanando
o relgio de acordo
com a velocidade de
reproduo atual

E3Playback 681
CONE COMANDO AO
Parar Interrompe o
playback, os dados
de Tags e alarmes
so removidos das
Telas e nenhuma
nova consulta feita
ao banco de dados

Mais devagar Diminui a velocidade


de playback pela
metade. O valor
mnimo 1/1024x,
isto , avana
aproximadamente
um milissegundo de
dados a cada
segundo

Velocidade normal Deixa a velocidade


de playback no valor
normal (1x)

Mais rpido Dobra a velocidade


de playback. O valor
mximo de 1024x,
isto , a cada
segundo o relgio
de playback avana
1024 segundos
(aproximadamente
17 minutos)

Seletor de Permite selecionar a


velocidade velocidade de
playback

682 E3Playback
CONE COMANDO AO
Data e hora atual Mostra a data e
hora atual do
relgio de playback,
e permite selecionar
uma nova data

Mostrar ou Mostra ou oculta a


esconder a Linha janela Linha de
de Tempo Tempo do
E3Playback

Mostrar ou Mostra ou oculta a


esconder a Lista de janela Tags do
Tags E3Playback

Mostrar ou Mostra ou oculta a


esconder a Lista de janela Eventos do
Eventos E3Playback

Iniciar ou parar a Permite gerar um


gravao de vdeo vdeo (em formato
AVI) capturando
toda a rea do
ActiveX de playback
durante um
determinado
perodo, ou at que
o usurio mande
parar a gravao

Capturar a tela do Permite capturar a


E3Playback rea de Tela do
ActiveX de playback.
A Tela capturada
pode ser salva em
um arquivo BMP ou
copiada para a rea
de Transferncia

E3Playback 683
Ao selecionar a ferramenta Gravao de Vdeo , a seguinte janela de
configuraes mostrada.

Janela Opes de gravao

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Opes de gravao

OPO DESCRIO
Salvar vdeo como Mostra o local e o nome do arquivo
de vdeo a ser salvo. Pode-se clicar
em para navegar pelas pastas do
computador

684 E3Playback
OPO DESCRIO
Tempo mximo de gravao Permite definir um tempo total para
gravao. Se o valor estiver em
Indefinido, a gravao apenas para
se o boto de gravao de vdeo do
E3Playback for pressionado. A opo
Tempo permite que seja pr-definido
um tempo mximo de gravao, em
segundos (neste caso a gravao
encerrada automaticamente ao final
do tempo estipulado)

Quadros por segundo Configura o nmero de quadros


(frames) capturados a cada segundo
de gravao

Mostrar cursor na gravao Quando esta opo estiver habilitada,


o cursor do mouse aparece no vdeo
gravado. O padro desta opo
desabilitada. O ponteiro do mouse
gravado no vdeo o que estiver
configurado como padro do
Windows. Ponteiros com animao
no so animados no vdeo. Neste
caso, mostrado sempre o primeiro
quadro da animao

Compressor Compressor de vdeo utilizado na


gravao. So listados todos os
compressores que esto instalados
no computador, desde que sejam
suportados pelo E3Playback

Qualidade de compresso Configura a taxa de compresso, que


afeta a qualidade final do vdeo e,
consequentemente, o tamanho do
arquivo gerado

Intervalo de quadros a cada Configura a quantidade de quadros a


quadro-chave cada quadro-chave (key frame)

E3Playback 685
OPO DESCRIO
Configurar (compresso de vdeo) Abre uma nova janela que possui
configuraes especficas do
compressor selecionado

Sobre Abre uma nova janela que possui


informaes sobre o compressor
selecionado

Gravar udio Habilita a gravao de udio. O


padro desta opo desabilitada

Dispositivo Lista os dispositivos de udio


instalados e habilitados no sistema, e
que podem ser utilizados na captura
de udio

Formato Mostra informaes sobre o formato


de udio atualmente selecionado

Atributos Mostra informaes sobre os


atributos do formato de udio
atualmente selecionado

Configurar (gravao de udio) Mostra uma janela que permite alterar


o formato de gravao e os atributos
do udio

Mostrar resumo ao concluir Habilita ou desabilita a janela que


gravao mostrada no momento em que a
gravao finalizada

686 E3Playback
20.3.2 Linha de Tempo
A Linha de Tempo permite acompanhar visualmente e controlar o relgio de
playback.

Linha de tempo

As opes deste componente esto descritas na tabela a seguir.

Opes disponveis na Linha de Tempo

OPO DESCRIO
Rgua Mostra a linha de tempo. Pode-se
mover a linha de tempo para os lados
clicando e arrastando o mouse. O
zoom controlado pela roda do
mouse. Girando para cima, feito um
zoom in. Girando para baixo, zoom
out. necessrio primeiro clicar no
fundo da linha de tempo antes de
tentar executar o zoom. Se a tecla
CTRL estiver pressionada, o zoom
feito trs vezes mais rpido

Cursor Marca a posio atual do relgio de


playback. Quando o playback est no
modo Pausa pode-se arrastar o
cursor para os lados, alterando o
relgio de playback enquanto arrasta-
se o cursor. Est sempre visvel na
linha de tempo

E3Playback 687
OPO DESCRIO
Barra de Consultas Mostra os perodos de tempo que j
tm dados carregados:

Uma linha verde clara significa que


naquele perodo os dados j esto
totalmente carregados

Uma linha verde escura indica que


os dados do perodo esto sendo
carregados

Uma linha amarela clara indica que


o perodo contm alguns dados
carregados. Novas consultas ao
banco de dados so necessrias se
o cursor for movido para cima do
perodo

Uma linha cinza clara indica que o


perodo no tem nenhum dado
carregado ainda. Para carregar os
dados do perodo, mova o cursor
de playback para cima do perodo

Barra de Dados Indica com um ponto azul cada


momento em que h um evento de
playback

Barra de Zoom Geral Mostra o perodo de dados que est


sendo mostrado na Linha de Tempo,
comparado com o perodo total de
dados disponvel para playback

688 E3Playback
Caso tenha sido selecionada a opo Mostrar grfico na Linha de Tempo de
um Tag na Lista de Eventos ou na Lista de Tags, mostrada uma
representao visual do Tag esquerda do grfico. Esta representao varia
de acordo com o tipo de dados do Tag:

String: Mostra caixas de texto com o nome do Tag

Booleano ou Digital: Mostra um grfico de estado do Tag, onde o valor


do Tag fica sempre sobre uma linha inferior (Off ou False) ou sobre uma
linha superior (On ou True). A linha do grfico fica pontilhada nos
perodos em que a qualidade do Tag est ruim

Double, Integer ou Analgico: Mostra um grfico de linha com os


valores do Tag. A escala do grfico (inferior e superior) calculada
automaticamente de acordo com os valores do Tag que o E3Playback j
consultou no banco de dados. Assim como no grfico digital, a linha do
grfico fica pontilhada nos perodos em que a qualidade do Tag est
ruim. A linha tambm pode ser interpolada ou em escada, dependendo
se o Tag suporta (Storage) ou no (Histrico) interpolao

Mostrar grfico na Linha de Tempo

Cada Tag adicionado na Linha de Tempo possui uma cor definida


automaticamente, que pode ser alterada usando a opo Alterar a cor do
menu contextual. Esta opo abre a janela de Cores do sistema, permitindo
selecionar uma nova cor ou personalizar a cor selecionada.

E3Playback 689
20.3.3 Marcadores
Os Marcadores so utilizados para sinalizar ocorrncias na linha de tempo do
E3Playback.

Marcadores

Opes disponveis na barra de ferramentas Marcadores

CONE COMANDO AO
Adicionar marcador no Adiciona um nome ao
timestamp marcador na linha de
selecionado tempo, na data e hora
selecionadas

Editar marcador Permite editar o


selecionado marcador selecionado,
podendo alterar data e
hora, nome ou
descrio

Remover o marcador Remove o marcador


selecionado na linha de
tempo

Remover todos os Remove todos os


marcadores marcadores criados na
linha de tempo

Mover para o Seleciona o marcador


marcador anterior imediatamente frente
na linha de tempo e na
lista de eventos,
simultaneamente

690 E3Playback
CONE COMANDO AO
Mover para o Seleciona o prximo
marcador seguinte marcador na linha de
tempo e na lista de
eventos,
simultaneamente

Clicando em Adicionar ou em Editar , a janela a seguir mostrada.

Adicionar ou editar marcador

As opes disponveis nesta janela esto descritas na tabela a seguir.

Opes disponveis na janela Adicionar ou Editar Marcador

OPO DESCRIO
Data/hora/ms Permite selecionar a data e a hora,
incluindo os milissegundos, do
marcador. Estes campos j vm
preenchidos com a data e a hora
selecionadas na linha de tempo

Nome Permite selecionar o nome do


marcador

Comentrios Permite informar algum comentrio


adicional para o marcador

E3Playback 691
Quando um marcador criado, ele mostrado na Linha de Tempo, como
pode ser observado na figura a seguir, e tambm na Lista de Eventos.

Linha de Tempo com marcadores

692 E3Playback
20.3.4 rea de Telas
Esta a rea onde so mostradas as Telas do aplicativo. A Tela inicial
mostrada a configurada na propriedade InitialScreen do E3Playback. Se
esta propriedade for deixada em branco, utilizada a Tela inicial do objeto
Viewer.

rea de Telas

A rea de Telas funciona como se fosse um Viewer dentro do E3Playback. As


Telas so sempre abertas no zoom Preencher. possvel navegar livremente
entre as Telas do aplicativo.

Existem algumas restries e comentrios quanto ao funcionamento das Telas


dentro do E3Playback:

As Telas funcionam como se estivessem em um Viewer Somente Leitura,


isto , no permitido o envio de comandos e valores para o servidor
E3. Isto garante que as operaes efetuadas no E3Playback no iro
perturbar o funcionamento do aplicativo em tempo real

No permitido acesso aos objetos do servidor atravs do mtodo


Application.GetObject. Se este mtodo for chamado em algum script,
ele falha abortando o script

E3Playback 693
Devido s vrias limitaes de acesso ao servidor, erros de script
ocorridos dentro do E3Playback no geram uma mensagem de erro, e os
scripts so abortados silenciosamente

O E3Playback emula um Viewer real. Para isto criada uma nova cpia do
objeto Viewer e seus Tags para uso do E3Playback. Se algum
comportamento especfico do Viewer tiver que ser habilitado ou
desabilitado dentro do E3Playback, pode-se testar a propriedade
IsPlaybackMode, do objeto Viewer

O isolamento entre as Telas que executam dentro do E3Playback e o que


est fora total

O E3Playback trata os novos Quadros criados pelo aplicativo como novas


abas no topo da rea de Telas. O ttulo da aba o nome do Quadro ou
Tela que foi aberto

Quadros abertos em abas no E3Playback

Todas as Associaes que se referem a objetos do servidor so


capturadas pelo E3Playback, e passam a receber os dados histricos de
acordo com o relgio atual de playback. Isto inclui no apenas as
Associaes feitas nas Telas que esto sendo mostradas, mas tambm as
Associaes existentes nos Tags do Viewer

As Associaes feitas entre objetos do Viewer (por exemplo, um Display


mostrando o valor de um Tag Demo interno ao Viewer) funcionam
normalmente, sem nenhuma interferncia do playback
694 E3Playback
O E3Chart s funciona dentro do E3Playback se estiver configurado com
Penas histricas. Penas de tempo real so desabilitadas dentro