E3manual PTB

2013 Elipse Software Ltda. Todos os direitos reservados. Verso 4.
5 (05/12/2013)
Manual do Usurio do E3
Sumrio
..................................................................................... 8 1 Introduo
................................................................................ 8 1.1 Descrio Geral
................................................................................ 10 1.2 Arquitetura
................................................................................ 13 1.3 Diagrama de Blocos
................................................................................ 13 1.4 Estrutura de Domnio
................................................................................ 14 1.5 Limitaes do Modo Demonstrao
..................................................................................... 16 2 E3 Studio
................................................................................ 17 2.1 Iniciando um Projeto
................................................................................ 18 2.2 rea de Trabalho
................................................................................ 19 2.3 Configurao
................................................................................ 28 2.4 Barra de Ferramentas
................................................................................ 45 2.5 Organizer
................................................................................ 52 2.6 Importao e Exportao
................................................................................ 84 2.7 Lista de Propriedades
................................................................................ 84 2.8 Galeria
................................................................................ 85 2.9 AppBrowser
................................................................................ 89 2.10 Conectar A
..................................................................................... 92 3 Domnios
................................................................................ 92 3.1 E3 Server
................................................................................ 93 3.2 E3Run
................................................................................ 93 3.3 E3 Admin
................................................................................ 95 3.4 IOServer
................................................................................ 95 3.5 E3 Studio
................................................................................ 95 3.6 E3 Viewer
................................................................................ 95 3.7 Componentes
................................................................................ 96 3.8 Criando um Domnio
................................................................................ 105 3.9 Configuraes
................................................................................ 131 3.10 Outras Opes da rea de Notificao
................................................................................ 138 3.11 Domnios Remotos
................................................................................ 146 3.12 Gerando Logs no E3
..................................................................................... 147 4 Drivers
................................................................................ 147 4.1 Driver de Comunicao
................................................................................ 166 4.2 Servidor OPC
................................................................................ 167 4.3 Driver de Comunicao OPC
................................................................................ 184 4.4 Driver de Comunicao OPC UA
................................................................................ 193 4.5 Qualidade
..................................................................................... 201 5 Quadros
..................................................................................... 206 6 Viewer
................................................................................ 207 6.1 Configurao
................................................................................ 213 6.2 Variveis no Viewer
................................................................................ 213 6.3 Objeto _top
................................................................................ 214 6.4 Pasta do Viewer
..................................................................................... 216 7 Telas e Objetos de Tela
................................................................................ 216 7.1 Tela
................................................................................ 218 7.2 Objetos de Tela
................................................................................ 225 7.3 Configuraes Gerais
................................................................................ 240 7.4 Formatao de Cores
................................................................................ 243 7.5 Formatao de Valores
..................................................................................... 249 8 Associaes
................................................................................ 250 8.1 Simples
................................................................................ 251 8.2 Bidirecional
................................................................................ 252 8.3 Digital
................................................................................ 254 8.4 Analgica
................................................................................ 255 8.5 Por Tabela
................................................................................ 257 8.6 Reversa
................................................................................ 257 8.7 Mltipla
................................................................................ 258 8.8 Edio de Associaes
..................................................................................... 264 9 Bibliotecas
................................................................................ 265 9.1 Galeria
................................................................................ 266 9.2 Biblioteca do Usurio (ElipseX)
................................................................................ 276 9.3 Quando Criar um ElipseX
..................................................................................... 278 10 ActiveX
................................................................................ 281 10.1 Objetos Microsoft Forms
................................................................................ 283 10.2 Elipse KeyPad
..................................................................................... 285 11 Servidor de Dados
................................................................................ 285 11.1 Pasta de Dados
................................................................................ 286 11.2 Tag Contador
................................................................................ 288 11.3 Tag Demo
................................................................................ 289 11.4 Tag Interno
................................................................................ 292 11.5 Tag Timer
..................................................................................... 294 12 Banco de Dados
................................................................................ 295 12.1 Access
................................................................................ 297 12.2 Oracle
................................................................................ 302 12.3 SQL Server
................................................................................ 306 12.4 Objetos do E3 e Permisses
..................................................................................... 307 13 Alarmes
................................................................................ 307 13.1 Configurao de Alarmes
................................................................................ 311 13.2 Servidor de Alarmes
................................................................................ 322 13.3 Fontes de Alarme
..................................................................................... 334 14 E3Alarm
................................................................................ 335 14.1 Configuraes
................................................................................ 344 14.2 Caractersticas Especficas de Tempo de Execuo
..................................................................................... 348 15 Storage
................................................................................ 350 15.1 Configuraes
................................................................................ 352 15.2 Configurao da Tabela
..................................................................................... 366 16 Histrico
................................................................................ 368 16.1 Configuraes
..................................................................................... 379 17 Consultas
................................................................................ 380 17.1 Criando uma Consulta
................................................................................ 389 17.2 Uso dos Filtros da Consulta atravs de Scripts
................................................................................ 390 17.3 Uso de Recordsets de uma Consulta atravs de Scripts
..................................................................................... 391 18 E3Browser
................................................................................ 392 18.1 Objeto Consulta no E3Browser
................................................................................ 394 18.2 Outras Configuraes
..................................................................................... 399 19 E3Chart
................................................................................ 400 19.1 Configuraes
................................................................................ 427 19.2 Exemplos de Utilizao
................................................................................ 431 19.3 Caractersticas Especficas de Runtime
..................................................................................... 437 20 E3Playback
................................................................................ 437 20.1 Objeto E3Playback
................................................................................ 437 20.2 Adicionar Playback ao Demo do E3
................................................................................ 443 20.3 Interface de Usurio
................................................................................ 457 20.4 Banco de Dados de Playback
................................................................................ 461 20.5 Configurao dos Objetos de Banco de Dados do E3
..................................................................................... 465 21 Frmulas
................................................................................ 466 21.1 Configuraes
................................................................................ 468 21.2 Templates
................................................................................ 471 21.3 Unidades
................................................................................ 472 21.4 Conjunto de Valores
................................................................................ 473 21.5 Criao de uma Frmula
..................................................................................... 480 22 Relatrios
................................................................................ 480 22.1 Objeto Consulta
................................................................................ 481 22.2 Componentes
................................................................................ 482 22.3 Configuraes
................................................................................ 498 22.4 Criando um Relatrio no E3
................................................................................ 499 22.5 Exemplos de Utilizao
..................................................................................... 503 23 Segurana
................................................................................ 504 23.1 Usurios
................................................................................ 510 23.2 Grupos
................................................................................ 513 23.3 Permisses
................................................................................ 518 23.4 Proteo de Arquivos
..................................................................................... 523 24 E3 Viewer e E3 WebViewer
................................................................................ 524 24.1 Viewer Only (Modo Somente Leitura)
................................................................................ 525 24.2 Execuo do E3 Viewer
................................................................................ 529 24.3 Logs do Viewer
................................................................................ 530 24.4 Execuo do E3 WebViewer
..................................................................................... 534 25 Hot-Standby
................................................................................ 535 25.1 Configurando
................................................................................ 536 25.2 Executando um Domnio Redundante
................................................................................ 536 25.3 Parando um Domnio Redundante
................................................................................ 537 25.4 Parando um dos Servidores do Domnio
................................................................................ 537 25.5 Tempo de Troca entre Servidores
................................................................................ 537 25.6 Reconexo de Viewers
................................................................................ 537 25.7 Utilizando Bancos de Dados com Hot-Standby
..................................................................................... 539 26 Configuraes Avanadas
..................................................................................... 540 27 Dvidas mais Frequentes
................................................................................ 540 27.1 Ordem dos Tabs
................................................................................ 540 27.2 Sobreposio de Animaes nos Objetos
................................................................................ 540 27.3 Objetos de Tela
................................................................................ 541 27.4 Servidor de Banco de Dados SQL Server
................................................................................ 541 27.5 Servidor de Banco de Dados Oracle
................................................................................ 543 27.6 Servidor de Dados
................................................................................ 544 27.7 Drivers de Comunicao
................................................................................ 544 27.8 Alarmes
................................................................................ 546 27.9 E3Alarm
................................................................................ 547 27.10 E3Browser
................................................................................ 547 27.11 E3Chart
................................................................................ 547 27.12 Histrico
................................................................................ 548 27.13 Associaes
................................................................................ 549 27.14 Viewer
................................................................................ 550 27.15 Bibliotecas
................................................................................ 551 27.16 Relatrios
................................................................................ 553 27.17 Domnios e Projetos
................................................................................ 554 27.18 Stored Procedure
................................................................................ 555 27.19 Domnios Remotos
8 Introduo
1
Introduo
CAPTULO
Desenvol vi do pel a El i pse Software, o E3 uma poderosa pl ataforma para
supervi so e control e de processos total mente vol tada operao em rede e
apl i caes di stri budas. O E3 um si stema SCADA (Supervisory Control and Data
Acquisition) que oferece um avanado model o de objetos, uma poderosa i nterface
grfi ca, al m de uma arqui tetura que permi te o rpi do desenvol vi mento de
apl i caes e mxi ma conecti vi dade com di sposi ti vos e outros apl i cati vos. Sua
concepo i ncorpora as mai s novas tecnol ogi as em desenvol vi mento de software,
maxi mi zando o desempenho, a produti vi dade e a qual i dade de suas apl i caes e
do prpri o processo, mi ni mi zando perdas e custos.
Os si stemas construdos com o E3 geral mente partem da col eta de dados em tempo
real de equi pamentos de aqui si o de dados ou de control e, como os CLPs
(Control adores Lgi cos Programvei s), UTRs (Uni dades Termi nai s Remotas), DAQs
(Data Acquisition Boards, Pl acas de Aqui si o de Dados), control adores Multi-Loop
ou Single-Loop, centrai s de i ncndi o e bal anas, dentre outros di sposi ti vos. Estes
equi pamentos normal mente possuem al guma i nterface que permi tem sua conexo
ao software, como padres seri ai s RS232, RS422 ou RS485; rdi o ou modem (l i nhas
pri vadas ou di scadas), TCP/IP ou UDP/IP, pl acas l i gadas di retamente no
barramento do computador e outros. O E3 l e escreve dados dos equi pamentos
atravs de mdul os (Dri vers de Comuni cao) que i mpl ementam o protocol o (de
domni o pbl i co ou pri vado) di sponvel em cada um desses equi pamentos. Estes
Dri vers podem ai nda estar em um formato prpri o da El i pse Software ou no
formato OPC (OLE for Process Control).
De posse dos dados, possvel cri ar vri as manei ras para exi bi r, anal i sar,
control ar, comandar, gravar ou di vul gar tai s i nformaes, dentre el as:
Telas: permi tem cri ar uma IHM (Interface Homem-Mqui na) l ocal mente, pel a rede
l ocal ou Internet, com o i ntui to de exi bi r o status atual ou passado dos dados em
vri as formas, com o auxl i o de um edi tor grfi co e objetos especfi cos
Alarmes e Eventos: moni toram o aconteci mento de si tuaes especfi cas
Histricos: armazenam os dados em bancos de dados rel aci onai s
Relatrios: permi tem vi sual i zar e i mpri mi r os dados, dentre outros mdul os e
possi bi l i dades
1.1 Descrio Geral
O E3 pode ser executado nas pl ataformas Mi crosoft Wi ndows XP SP3, XP x64 SP2,
Server 2003 SP2, Vi sta SP2, Server 2008 SP2, Server 2008 R2 SP1 e Wi ndows 7 SP1,
uti l i zando al guns recursos di sponvei s nesses si stemas operaci onai s. A i nterface
grfi ca com o usuri o pode tambm ser executada atravs da Internet ou i ntranet
Introduo 9
vi a Internet Expl orer.
As funes bsi cas do software esto di vi di das em mdul os i ndependentes,
capazes de processar ati vi dades especfi cas. O gerenci amento do trfego de
i nformaes entre os mdul os coordenado por um mdul o pri nci pal (E3 Admi n),
uti l i zando a tecnol ogi a de objetos di stri budos, permi ti ndo que os componentes
possam ser executados tanto na mesma mqui na quanto em outros computadores.
Em l i nhas gerai s, o E3 composto de um ncl eo (kernel) responsvel por uni r e
coordenar o trabal ho de vri os outros mdul os, que tambm so servi dores de
i nformaes. A parti r da so geradas as i nterfaces grfi cas com o usuri o,
di sponvei s atravs dos cl i entes, tanto l ocai s como pel a Internet.
O E3 possui quatro programas pri nci pai s, descri tos a segui r.
1.1.1 E3 Server
o Servi dor de Apl i caes, onde os pri nci pai s processos so executados, i ncl ui ndo
a comuni cao em tempo real com os equi pamentos de control e. O servi dor
tambm responsvel por envi ar dados e Tel as aos cl i entes conectados em
qual quer parte da rede (i ntranet e Internet). O servi dor pode executar vri os
projetos ao mesmo tempo e conversar com outros E3 Servers para real i zar um fail-
over (standby) ou di stri bui r cargas de processamento entre as mqui nas.
1.1.2 E3 Studio
Ferramenta ni ca de confi gurao, agi ndo como pl ataforma uni versal de
desenvol vi mento, que possui um ambi ente moderno e ami gvel , i ncl ui ndo um
compl eto edi tor grfi co e de scri pts (VBScri pt). Permi te que um projeto seja edi tado
por vri as pessoas ao mesmo tempo ou que vri os E3 Studi os estejam conectados
ao mesmo servi dor remoto, com ml ti pl as confi guraes.
1.1.3 E3 Viewer
Permi te operar as apl i caes resi dentes no servi dor a parti r de qual quer
computador com o programa executvel Vi ewer ou com um navegador de Internet.
Em ambos os casos, no necessri o i nstal ar a apl i cao na mqui na cl i ente, poi s
ser fei to o download e o regi stro de todos os componentes (Tel as, bi bl i otecas e
control es Acti veX).
1.1.4 E3 Admin
o mdul o responsvel pel a i nterface do E3 Server e de outros mdul os do E3 com
o usuri o. Atravs del e o usuri o pode envi ar comandos ao E3 Server, uti l i zando o
cone na rea de Noti fi cao da Barra de Tarefas do Wi ndows, e control ar o
Domni o pel a l i nha de comando.
10 Introduo
1.2 Arquitetura
Para supervi si onar um determi nado processo com um si stema SCADA, geral mente
construda uma apl i cao que conter a defi ni o das vari vei s envol vi das, com
nomes e endereamentos, Tel as, defi ni es de al armes e outros, a qual se chama
Banco de Dados da Aplicao.
Quando esse processo exi ge o uso de doi s ou mai s computadores, preci so fazer
com que cada apl i cao em cada computador troque dados com as outras. A
mai ori a dos si stemas SCADA tradi ci onai s basei am-se em uma arqui tetura comum
para real i zar essa tarefa:
Cada servi dor SCADA deve ter uma cpi a (parci al ou no) da apl i cao
confi gurada na base de dados l ocal
Cada servi dor SCADA possui e executa somente uma base de dados ao mesmo
tempo
Isso l eva a al guns probl emas de gerenci amento, como apl i car mudanas a todos os
servi dores, control ar verses do apl i cati vo ou ento trabal har com di ferentes
fabri cantes de software e hardware.
O E3 resol ve esse probl ema usando o concei to de Domnio que i ncl ui , em um ni co
ambi ente, a defi ni o dos computadores executando tarefas em tempo real
(servi dores) e as bases de dados de projeto que devem ser executadas nesses
servi dores, com a possi bi l i dade de execuo de vri os projetos em cada servi dor.
Tambm possvel i nseri r, apagar ou modi fi car projetos durante a execuo, sem
afetar as outras partes do Domni o em execuo.
Cada projeto pode conter qual quer ti po de objeto, como Tel as, Dri vers de
Comuni cao, Al armes, Hi stri cos, Rel atri os, Frmul as, Bancos de Dados, dentre
outros. Quando doi s ou mai s projetos esto dentro de um mesmo Domni o, el es
podem acessar as propri edades e objetos entre si como se esti vessem resi dentes
em uma ni ca base de dados. Isso possvel atravs do uso de Associ aes
(conexes) que um objeto pode fazer com qual quer outro. Se ambos os objetos
exi stem e esto rodando, a conexo est ati va e qual quer mudana de val or
envi ada assi ncronamente entre as partes (dependendo do ti po da conexo). Se um
dos objetos destrudo ou parado, a conexo quebrada, ento a apl i cao
noti fi cada e pode i ndi car seu estado em uma forma defi ni da pel o usuri o.
A estrutura do Domni o restri ta aos servi dores e afi ns, como as mqui nas
servi doras, projetos, usuri os e senhas. A i nterface do cl i ente para operao e
vi sual i zao, chamada E3 Vi ewer, pode se conectar di retamente a qual quer
servi dor E3 (com l i cenas sufi ci entes de Vi ewer). O E3 Vi ewer possui trs destaques
especi ai s:
Os projetos da apl i cao resi dem somente no servi dor
O navegador Internet Expl orer pode ser usado como i nterface de operao, sem
Introduo 11
nenhuma mudana
A i nterface do cl i ente capaz de al ternar de um servi dor desl i gado ou com fal ha
para o prxi mo servi dor di sponvel , sem i nterromper o moni toramento do
processo
Como al ternati va ao uso do E3 Vi ewer na mqui na cl i ente, possvel uti l i zar a
tecnol ogi a Terminal Service. Este servi o surgi u no Wi ndows NT 4.0 e sua funo
permi ti r o acesso remoto entre computadores, atravs de um protocol o chamado
RDP (Remote Desktop Protocol). Esse protocol o permi te a i nterao entre uma
estao cl i ente e uma mqui na servi dora (que ser acessada remotamente). O E3
Vi ewer executado em uma nova sesso de usuri o cri ada na mqui na servi dora,
que por sua vez, transfere para a mqui na cl i ente os dados de vdeo e recebe de
vol ta os eventos de mouse e tecl ado.
12 Introduo
Arquitetura do E3
possvel observar que em todos os casos o E3 Vi ewer conti nua sendo a i nterface
de operao e vi sual i zao. A di ferena est no l ocal de execuo, que pode ser na
mqui na cl i ente (operao normal do E3 Vi ewer) ou na mqui na servi dora, com o
operador fi si camente junto mqui na ou atravs dos Termi nal Servi ces. Com o E3
Vi ewer sendo executado di retamente na estao cl i ente, exi ste um trfego i ni ci al
mai or para o download de Tel as e objetos. Esse trfego di mi nui substanci al mente
medi da que somente as mudanas nos dados so reportadas do servi dor para o
Vi ewer, o que traz vantagens em termos de desempenho e qual i dade de
apresentao grfi ca.
Introduo 13
O Termi nal Servi ce, por outro l ado, possui mai or al cance e exi ge menor capaci dade
de processamento da mqui na cl i ente quando exi stem poucos efei tos grfi cos e
vi suai s, al m da possi bi l i dade de operar o E3 em outras pl ataformas de software
que no so suportadas pel o E3 Vi ewer, como o Wi ndows CE e o Li nux ou Uni x.
Entretanto, o RDP possui a l i mi tao de exi bi r somente 256 cores, o que aumenta
consi deravel mente o trfego quando exi stem mui tas ani maes ou efei tos
pi scantes nas Tel as. Para veri fi car qual a mel hor manei ra de i mpl ementar
ml ti pl os acessos a um E3 Server, i mportante estudar caso a caso, para poder
defi ni r a mel hor al ternati va para a apl i cao. Para uti l i zar o RDP com ml ti pl os
usuri os, necessri o uma l i cena de Wi ndows 2003 Server SP2, al m do mesmo
nmero de Vi ewers di sponvei s no Servi dor.
1.3 Diagrama de Blocos
A arqui tetura i nterna do E3 total mente escal vel , com cada tarefa pri nci pal sendo
executada por um servi o separado. O di agrama a segui r mostra uma vi so geral
dos pri nci pai s bl ocos.
Diagrama dos blocos que compem o E3
1.4 Estrutura de Domnio
Cada grupo de servi dores composto por um E3 Server operando i sol adamente ou
doi s E3 Servers em confi gurao de Hot-Standby. Cada Vi ewer, de fato, se conecta a
um Domni o ao i nvs de somente a um servi dor.
Depoi s da conexo, servi dor e cl i ente trocam i nformaes e veri fi cam a exi stnci a
de objetos do si stema regi strados e atual i zados na mqui na cl i ente. Caso negati vo,
14 Introduo
o servi dor carrega as defi ni es dos objetos, como bi bl i otecas do usuri o,
conforme a necessi dade para abri r cada uma das Tel as.
Do ponto de vi sta do cl i ente, o download comea na pri mei ra Tel a (i nterface
grfi ca), i ncl ui ndo quai squer objetos i nternos que sero sal vos em um di retri o de
cache. Esse processo pode l evar al guns segundos, dependendo da apl i cao, mas
traz mai s benefci os na prxi ma vez que se abre a mesma Tel a, poi s o Vi ewer
real i za um cache em di sco e em memri a. Se o Vi ewer no for fechado, a parti r da
segunda vez que uma Tel a for aberta (e no for reconfi gurada) el a j estar cri ada
em memri a, reduzi ndo, portanto, o tempo de pagi nao. Se a Tel a for modi fi cada,
o Vi ewer dever fazer um novo download, rei ni ci ando o processo.
Depoi s de abri r uma Tel a, o servi dor e o cl i ente trocam somente dados em tempo
real e consul tas ao Banco de Dados em um si stema de mensagens TCP/IP, com um
al to desempenho se comparado ao Termi nal Servi ces, dependendo da apl i cao.
Isso possvel porque enquanto o E3 Vi ewer recebe e envi a apenas val ores e dados
em tempo real , um cl i ente Termi nal Servi ces envi a mensagens de tecl ado e mouse e
recebe i magens, o que gera um trfego mui to mai or de i nformaes. Um Vi ewer
conectado a um Domni o i sol ado pode obter i nformaes resi dentes somente
dentro do servi dor ati vo, de acordo com os di rei tos de acesso do usuri o.
1.5 Limitaes do Modo Demonstrao
Sem a uti l i zao de uma l i cena, o E3 pode ser executado em modo Demonstrao
(ou Demo), o que ti l para aval i ao do software. Nesse caso, as segui ntes
l i mi taes se apl i cam:
Permi te sal var projetos com at 20 Tags de Comuni cao
No permi te trabal har com servi dores em modo Hot-Standby
No permi te trabal har com Domni os Remotos
S permi ti da a comuni cao com um Dri ver de Comuni cao de nvel 0 (zero),
sem l i mi te de Tags. Dri vers com nvel mai or do que 0 (zero) no so permi ti dos
No h acesso s confi guraes do Domni o (menu contextual Domnio - Opes
do cone do E3 Admi n na rea de Noti fi caes do Wi ndows)
Somente a pri mei ra i magem de cada categori a da Gal eri a de Smbol os est
di sponvel
S permi ti da a abertura de um Vi ewer ou WebVi ewer
O tempo mxi mo de execuo de um Domni o de duas horas
S permi ti da a gravao de no mxi mo 20 Tags de Comuni cao em um objeto
Storage
Permi te acesso como OPC Server
Permi te executar o playback das l ti mas sei s horas de dados, com um nmero
Introduo 15
i l i mi tado de Tags e com todos os recursos de playback habi l i tados
No permi ti do uti l i zar a ferramenta de Importao e Exportao do E3 Studi o
16 E3 Studio
2
E3 Studio
CAPTULO
O E3 Studio o ambi ente de desenvol vi mento do E3. Nel e, possvel a cri ao e
manuteno de Domni os, projetos e bi bl i otecas.
Caminho indicado pelo sistema quando o E3 instalado
Para i ni ci ar uma apl i cao no E3 Studi o, si ga estes procedi mentos:
1. No momento da i nstal ao, cri ado um grupo de programas no menu Iniciar do
E3 Studio 17
Wi ndows. Para i ni ci ar o E3 Studi o, basta escol her o cone correspondente
nesse menu, como mostra a fi gura anteri or, ou cl i car no cone cri ado na rea
de Trabal ho, conforme fi gura a segui r.
cone do E3 Studio
2. O di sposi ti vo de proteo dever estar conectado na porta de comuni cao
adequada, no caso de uma edi o l ocal , ou a mqui na deve estar na mesma
rede l ocal que outra com o E3 Server j previ amente i nstal ado, e com um
di sposi ti vo de proteo presente.
2.1 Iniciando um Projeto
Quando o E3 Studi o i ni ci ado, abre-se uma cai xa de di l ogo com al gumas opes
do projeto:
18 E3 Studio
Janela Iniciar o Studio
As opes di sponvei s so as segui ntes:
Opes disponveis na janela Iniciar o E3 Studio
OPO DESCRIO
Iniciar o E3 Studio
No ser aberto nenhum Domni o.
Criar um Domnio novo
Sero requi si tados o nome e cami nho do
novo Domni o.
Abrir um Domnio existente
Ao cl i car em Outros Arquivos, tem-se a
opo de l ocal i zar um Domni o em um
di retri o especfi co, ou escol her na l i sta
um dos l ti mos apl i cati vos edi tados.
2.2 rea de Trabalho
O E3 Studi o j vem com uma sri e de menus e de barras de ferramentas
confi gurados, que so mostrados ao execut-l o pel a pri mei ra vez. Ao uti l i zar uma
i nterface grfi ca mai s moderna, si mi l ar a programas como o Mi crosoft Offi ce, os
menus e as barras de ferramentas podem ser modi fi cados pel o usuri o. Quando
no exi ste uma apl i cao aberta, a tel a apresenta menos opes habi l i tadas na
barra de menu e na barra de ferramentas, mas sua aparnci a permanece a mesma.
A fi gura a segui r mostra a aparnci a do E3 Studi o aps a cri ao de um novo
projeto.
E3 Studio 19
rea de trabalho do E3 Studio
A Barra de Ttulo mostra o cami nho e o nome da apl i cao, ou o nome do objeto
cuja view esteja sendo mostrada na rea de trabal ho.
A Barra de Status mostra i nformaes de ajuda a respei to da rea da tel a, sobre a
qual est o pontei ro do mouse.
A Barra de Ferramentas mostra os objetos, componentes e demai s recursos que
podem ser uti l i zados na Tel a e no E3.
A rea de Trabalho onde as views so mostradas.
2.3 Configurao
O E3 permi te personal i zar al guns recursos do E3 Studi o, tai s como barra de
ferramentas, tecl ado, menus, mouse, etc.
2.3.1 Aparncia
Para personal i zar a aparnci a do E3 Studi o, necessri o cl i car no menu Visualizar -
Personalizar. As opes di sponvei s deste i tem so as segui ntes:
Aba Comandos: Atravs desta aba, pode-se defi ni r os cones de cada uma das
barras de ferramentas. Para tanto, basta cl i car sobre o cone na l i sta Comandos
e arrast-l o para dentro da barra de ferramentas desejada
20 E3 Studio
Aba Comandos
Opes disponveis na aba Comandos
OPO DESCRIO
Categorias
Mostra as opes dos menus e barras de
ferramentas di sponvei s no E3 Studi o.
Comandos
Mostra os i tens que compem o menu ou
a barra de ferramentas sel eci onada.
Descrio
Breve descri o da opo sel eci onada.
Aba Barra de ferramentas: Atravs desta aba, pode-se confi gurar, edi tar ou cri ar
novas barras de ferramentas
E3 Studio 21
Aba Barra de ferramentas
Opes disponveis na aba Barra de ferramentas
OPO DESCRIO
Barra de ferramentas
Li sta as opes de barras de ferramentas
di sponvei s.
Restaurar
Restaura a barra de ferramentas
desejada no E3.
Restaurar tudo
Restaura todas as barras de ferramentas
no E3.
Nova
Cri a uma nova barra de ferramentas.
Mudar o nome
Muda o nome da barra de ferramentas.
Esta opo uti l i zada somente na barra
de ferramentas cri ada pel o usuri o
atravs do boto Nova.
Remover
Remove a barra de ferramentas
sel eci onada.
Mostrar legendas
Mostra uma l egenda nas opes da
barra de ferramentas sel eci onada.
Aba Menus: Atravs desta aba, possvel confi gurar os menus do E3
22 E3 Studio
Aba Menus
Opes disponveis na aba Menus
OPO DESCRIO
Mostra menus para
Exi be o menu pr-defi ni do da apl i cao.
Essa opo no tem efei to, e manti da
no E3 por questo de compati bi l i dade.
Restaurar
Restaura o menu defi ni do na opo
anteri or. Essa opo no tem efei to, e
manti da no E3 por questo de
compati bi l i dade.
Animao dos menus
Sel eci ona o ti po de ani mao usada nos
menus: Nenhuma (padro do E3),
Desdobrar, Deslizar, Fade e Default (padro
do Wi ndows).
Menus com sombra
Defi ne se o menu apresentar o efei to
de sombreado ou no.
Aba Aparncia: Atravs desta aba, possvel al terar a aparnci a das janel as e
barras de ferramentas no E3 Studi o
E3 Studio 23
Aba Aparncia
Opes disponveis na aba Aparncia
OPO DESCRIO
Office XP
Confi gura a aparnci a do E3 Studi o como
no Offi ce XP.
Windows XP
no Wi ndows XP (no di sponvel no esti l o
Wi ndows Cl ssi co).
Office 2000
no Offi ce 2000.
Office 2003
no Offi ce 2003.
VS.Net 2005
no Vi sual Studi o .Net 2005.
Aba Opes: Atravs desta aba possvel confi gurar as especi fi caes gerai s do
projeto. Nesse i tem possvel habi l i tar ou desabi l i tar as opes da barra de
ferramentas
24 E3 Studio
Aba Opes
Opes disponveis na aba Opes
OPO DESCRIO
Mostrar descries
Habi l i ta o E3 a mostrar uma breve
descri o nas opes das barras de
ferramentas e menus quando o mouse
posi ci onado sobre o i tem.
Incluir teclas de atalho
Mostra ou no a tecl a de atal ho na
descri o do boto.
cones grandes
Habi l i ta cones grandes nas barras de
ferramentas.
2.3.2 Outras Configuraes
Pode-se confi gurar o Edi tor de Scri pts do E3, bem como outras opes dos arqui vos
do Domni o, atravs do menu Ferramentas - Opes, onde tem-se acesso segui nte
janel a de confi guraes:
Geral: Confi gura o comportamento do dupl o-cl i que de objetos no Organi zer,
quando a view de um objeto j esti ver aberta
E3 Studio 25
Aba Geral
As opes di sponvei s deste i tem so as segui ntes:
Opes disponveis na aba Geral
OPO DESCRIO
Ativar a view de Scripts
Ati va a view de Scri pts na ocorrnci a de
um dupl o-cl i que.
Abrir a Janela de Propriedades
Abre a janel a de Propri edades na
ocorrnci a de um dupl o-cl i que.
Mostrar boto de fechar na aba ativa
Permi te fechar a aba ati va ao cl i car no
seu respecti vo boto de fechar.
Desmarcar esta opo faz com que o
boto de fechar seja posi ci onado
di rei ta da vi ew.
Aba Editor de Scripts: Este i tem desti nado confi gurao do Edi tor de Scri pts
do E3
26 E3 Studio
Aba Editor de Scripts
Opes disponveis na aba Editor
OPO DESCRIO
Abrir-e-Fechar blocos do texto
Permi te ocul tar ou mostrar os bl ocos de
cdi go no scri pt.
Tamanho da margem
Tamanho da margem da marcao do
bl oco de cdi go.
Numerao da linha
Habi l i ta a numerao de l i nha no edi tor
de scri pts.
Tamanho da margem
Tamanho da margem que contm a
numerao de l i nha.
Tamanho do Tab
Determi na o nmero de espaos de
tabul ao.
Fonte
Determi na o nome da fonte a ser usada
no edi tor de scri pts.
E3 Studio 27
OPO DESCRIO
Tamanho
Determi na o tamanho da fonte a ser
usada no edi tor de scri pts.
NOTA: Feche os edi tores de scri pts abertos para que as modi fi caes sejam
apl i cadas.
Arquivos: Habi l i ta ou desabi l i ta a opo Ignorar verificao de CRC
Aba Arquivos
Toda vez que um projeto ou uma bi bl i oteca cri ado, o E3 grava i nternamente um
cdi go CRC (Cyclic Redundancy Check, Veri fi cao de Redundnci a Ccl i ca) dos
dados deste arqui vo. Cada vez que um arqui vo aberto, fei ta uma veri fi cao
desse CRC. Caso essa veri fi cao fal he (ou seja, o CRC no coi nci da com os dados),
a carga do arqui vo abortada, i ndi cando uma corrupo dos dados do arqui vo.
Isso pode ser causado por fal has di versas de hardware: memri a, rede, di sposi ti vo
28 E3 Studio
de armazenamento, etc.
Porm, se um projeto cri ado na verso atual modi fi cado em uma verso i nferi or a
1.00.019 bui l d 203, o CRC no atual i zado. Com i sso, o arqui vo no poder ser
aberto novamente com as verses atuai s, poi s a veri fi cao de CRC i r fal har,
mesmo que o arqui vo no esteja efeti vamente corrompi do. Para sol uci onar essa
questo, necessri o habi l i tar a opo Ignorar verificao de CRC. Assi m, o projeto
poder ser aberto em uma verso atual .
Neste caso, a opo dever permanecer habi l i tada at que todos os objetos
edi tados na verso anti ga tenham si do sal vos com a verso atual , o que i r
atual i zar o CRC.
NOTA: No recomendvel que arqui vos .prj sejam edi tados em verses mai s
anti gas do E3 e depoi s abertos novamente em verses atuai s, poi s no h garanti a
de que com esse procedi mento no sero perdi das as confi guraes desses
arqui vos.
2.4 Barra de Ferramentas
A Barra de Ferramentas do E3 muda conforme a exi stnci a de uma apl i cao aberta
ou no. Os botes da barra de ferramentas permi tem a execuo de determi nadas
tarefas rapi damente, sem uti l i zar os menus. Dessa forma, pode-se cri ar Objetos de
Tel a ou abri r o Organi zer si mpl esmente cl i cando-se em um boto da barra de
ferramentas. A tabel a abai xo mostra as opes di sponvei s nas di versas barras de
ferramentas do E3 Studi o:
Opes disponveis na barra de ferramentas Padro
CONE COMANDO AO
Novo Projeto
Cri a um novo projeto.
Abrir Projeto
Abre um projeto exi stente.
Salvar Projeto
Sal va o projeto.
Salvar Tudo
Sal va todo o Domni o.
Recortar
Remove a i nformao
sel eci onada e a move
para a rea de
Transfernci a.
Copiar
Copi a a i nformao
sel eci onada e a move
para a rea de
Transfernci a.
Colar
Col a a i nformao
sel eci onada da rea de
Transfernci a.
Desfazer
Desfaz a l ti ma ao
executada.
E3 Studio 29
CONE COMANDO AO
Refazer
Refaz a l ti ma ao
desfei ta pel o i tem
Desfazer.
Organizer
Mostra ou esconde o
Organi zer.
Galeria
Mostra ou esconde a
Gal eri a.
Lista de Propriedades
Mostra ou esconde a Li sta
de Propri edades.
Mostrar no Editor
Mostra o objeto na view do
objeto, se este esti ver
sel eci onado no Organi zer.
Mostrar no Organizer
Mostra o objeto no
Organi zer, se este esti ver
sel eci onado na view do
objeto.
Executar Aplicativo
Sal va todos os projetos e
bi bl i otecas, executa o
Domni o e abre o Vi ewer.
Rodar ou Parar Domnio
Executa ou para o Domni o
corrente.
Executar ou Parar E3 Viewer
Executa ou para o E3
Vi ewer.
Verificar Domnio
Veri fi ca se o Domni o
contm erros.
Erro Anterior
Mostra o erro anteri or
encontrado no Domni o.
Prximo Erro
Mostra o prxi mo erro
encontrado no Domni o.
Desfragmentar Arquivos
Desfragmenta o arqui vo
especi fi cado.
Procurar ou Substituir
Procura todas as
ocorrnci as de um
determi nado texto em
todo o Domni o.
Documentao de Scripts
Gera a documentao dos
scri pts.
Relatrio de Verses
Mostra as verses dos
projetos e bi bl i otecas.
WatchWindow
Mostra os val ores de Tags
e de propri edades no E3
Studi o em tempo de
execuo.
Opes disponveis na barra de ferramentas Sombra
CONE COMANDO AO
Sombra do Objeto
Apl i ca uma sombra no
objeto.
30 E3 Studio
CONE COMANDO AO
Sombra Acima
Desl oca a sombra para
ci ma do objeto.
Sombra Abaixo
Desl oca a sombra para
bai xo do objeto.
Sombra Esquerda
Desl oca a sombra para a
esquerda do objeto.
Sombra Direita
Desl oca a sombra para a
di rei ta do objeto.
Cor da Sombra
Sel eci ona a cor da
sombra do objeto.
Opes disponveis na barra de ferramentas Objetos
CONE COMANDO AO
E3Alarm
I nsere um objeto do ti po
E3Alarm.
E3Browser
E3Browser.
E3Chart
E3Chart.
Caixa de Seleo
Caixa de Seleo
(CheckBox).
Boto de Opo
Boto de Opo
(Opti onButton).
Lista de Seleo
Lista de Seleo
(ComboBox).
Boto de Comando
Boto de Comando
(CommandButton).
Texto
Texto (Label ).
Lista
Lista (Li stBox).
Barra de Rolagem
Barra de Rolagem
(Scrol l Bar).
Boto Incremento-
Decremento
Boto Incremento-
Decremento (Spi nButton).
Editor de Texto
Editor de Texto (TextBox).
Boto Liga-Desliga
Boto Liga-Desliga
(Toggl eButton).
E3 Studio 31
Opes disponveis na barra de ferramentas Tela
CONE COMANDO AO
Selecionar
Habi l i ta o modo de
sel eo.
Rotacionar
Habi l i ta o modo de
rotao.
Ordem dos Tabs
Mostra o i denti fi cador
de ordem de navegao
entre os objetos.
Editar Ponto de Conexo
Permi te edi tar pontos de
conexo entre objetos.
Este boto somente est
habi l i tado em objetos
XControl .
Linha
I nsere um objeto do
ti po Linha.
Conector
ti po Conector.
Retngulo
ti po Retngulo.
Retngulo Arredondado
ti po Retngulo
Arredondado.
Elipse
ti po Elipse.
Arco de Elipse
ti po Arco de Elipse.
Desenho Livre
I nsere uma ferramenta
de desenho l i vre.
Polgono
ti po Polgono.
Polgono de Curvas
ti po Polgono de Curvas.
Figura
ti po Imagem.
Texto
ti po Texto.
Display
ti po Display.
SetPoint
ti po SetPoint.
Escala
ti po Escala.
Agrupar
Agrupa uma sel eo de
objetos.
Desagrupar
Desagrupa uma sel eo
de objetos.
32 E3 Studio
CONE COMANDO AO
Animar com Translao
para movi mentos
l i neares.
Animar com Rotao
para rotao.
Trazer para a Frente
Traz o objeto para a
frente em um
agrupamento (ALT +
HOME).
Enviar para Trs
Envi a o objeto para trs
em um agrupamento
(ALT + END).
Avanar
Move um objeto uma
posi o aci ma no
agrupamento (ALT + PAGE
UP).
Recuar
Move um objeto uma
posi o abai xo no
agrupamento (ALT + PAGE
DOWN).
Zoom
Permi te edi tar o nvel de
zoom da Tel a.
Camadas
Permi te edi tar as
camadas de objetos na
Tel a.
Opes disponveis na barra de ferramentas Desenho
CONE COMANDO AO
Cor de Fundo
Defi ne a cor do fundo do
objeto.
Cor de Frente
Defi ne a cor da frente do
objeto.
Cor da Borda
Defi ne a cor da borda do
objeto.
Estilo da Borda
Defi ne o esti l o da borda
do objeto.
Espessura da Borda
Defi ne a espessura da
borda do objeto.
Estilo de Preenchimento
Defi ne o esti l o de
preenchi mento do objeto.
Opes disponveis na barra de ferramentas Alinhamento
CONE COMANDO AO
Alinhar Esquerda
Al i nha objetos
esquerda.
E3 Studio 33
CONE COMANDO AO
Alinhar Direita
Al i nha objetos di rei ta.
Alinhamento Superior
Al i nha objetos pel o topo.
Alinhamento Inferior
Al i nha objetos pel a base.
Mesma Largura
Apl i ca a mesma l argura a
todos os objetos.
Mesma Altura
Apl i ca a mesma al tura a
todos os objetos.
Mesmo Tamanho
Apl i ca o mesmo tamanho
aos objetos sel eci onados.
Centralizar Horizontalmente
Central i za os objetos
hori zontal mente.
Centralizar Verticalmente
Central i za os objetos
verti cal mente.
Distribuir Horizontalmente
Formata o espaamento
entre objetos na
hori zontal .
Distribuir Verticalmente
Formata o espaamento
entre objetos na verti cal .
Espelhar Horizontalmente
Apl i ca uma refl exo
hori zontal no objeto
sel eci onado.
Espelhar Verticalmente
Apl i ca uma refl exo
verti cal no objeto
sel eci onado.
Grade
Mostra ou esconde a
grade.
Opes disponveis na barra de ferramentas Formatao
CONE COMANDO AO
Fonte
Determi na a fonte do
texto.
Tamanho da Fonte
Determi na o tamanho
da fonte.
Cor da Fonte
Determi na a cor da
fonte.
Fonte em Negrito
Formata o texto em
negri to.
Fonte em Itlico
Formata o texto em
i tl i co.
Fonte Sublinhada
Formata o texto com
subl i nhado.
Texto Esquerda
Al i nha o texto
esquerda.
Texto Centralizado
Central i za o texto.
Texto Direita
Al i nha o texto di rei ta.
34 E3 Studio
2.4.1 Verificar Domnio
Veri fi ca erros de confi gurao em todo o Domni o, como objetos com o mesmo
nome, Associ aes i l egai s, etc. Em caso afi rmati vo, o E3 Studi o mostra uma cai xa
de di l ogo com os erros encontrados no Domni o.
Verificao de Erros no Projeto
Enquanto o erro no for sol uci onado, a cai xa de di l ogo conti nuar sendo
mostrada e no ser possvel executar o Vi ewer. Aps a resol uo do probl ema, o
E3 Studi o mostrar uma cai xa de mensagem i ndi cando que no encontrou nenhum
erro no Domni o, e l i berar a execuo do Vi ewer.
Mensagem do Item Verificar Domnio
A opo Verificar Domnio pode ser acessada das segui ntes manei ras:
Atravs do cone , disponvel na barra de ferramentas Padro: Veri fi ca os erros
ocorri dos em todo o Domni o
Atravs do menu Ferramentas - Verificar Domnio: mesmo funci onamento da
E3 Studio 35
opo anteri or
Clicando com o boto direito do mouse sobre um item do projeto e selecionando
a opo Verificar ou Verificar projeto: Veri fi ca os erros ocorri dos somente no
objeto sel eci onado e em seus fi l hos
2.4.2 Procurar e Substituir
A ferramenta Procurar busca no Domni o por ocorrnci as de um determi nado texto,
de forma parci al ou compl eta. No fi nal da busca, apresentado ao usuri o uma
l i sta de resul tados, i ndi cando o objeto onde a ocorrnci a foi encontrada, a
l ocal i zao dentro deste objeto (se uma propri edade, Associ ao, etc.), e o texto
que contm a ocorrnci a.
A ferramenta Substituir substi tui as ocorrnci as encontradas por outro texto
especi fi cado.
Janela Procurar/Substituir
Exi stem trs manei ras de se real i zar a procura e a substi tui o:
Escol her um i tem no Organi zer, cl i car com o boto di rei to do mouse sobre el e, e
sel eci onar a opo Procurar/Substituir. Essa procura fei ta a parti r do i tem,
segui ndo a hi erarqui a (apenas objetos fi l hos sero pesqui sados)
Cl i car no menu pri nci pal do E3 Studi o, em Ferramentas - Procurar/Substituir.
Essa procura fei ta em todos os projetos e bi bl i otecas abertos
Cl i car em Procurar/Substituir , na barra de ferramentas Padro. A procura
ser efetuada em todo o Domni o
Opes disponveis na ferramenta Procurar/Substituir
OPO DESCRIO
Procurar por
Contm o texto a ser procurado.
Procurar
I ni ci a a busca pel o texto.
36 E3 Studio
OPO DESCRIO
Apenas nos resultados
Refaz a pesqui sa apenas entre os
resul tados da pesqui sa anteri or.
Diferenciar maisculas de minsculas
Procura pel o texto exatamente como foi
escri to, di ferenci ando mai scul as de
mi nscul as.
Palavras inteiras
Procura o texto especi fi cado como uma
pal avra i ntei ra. No consi dera o texto
como uma substring de outro.
Substituir por
Contm o texto a ser uti l i zado na
substi tui o.
Substituir
I ni ci a o processo de substi tui o.
Uma a uma
Faz a substi tui o da l i nha sel eci onada
e sel eci ona a prxi ma l i nha vl i da.
Todas
Substi tui , de uma s vez, todas as
ocorrnci as do texto.
Apenas as selecionadas
Substi tui , de uma s vez, todas as
ocorrnci as marcadas na l i sta de
resul tados.
ou
Mostra ou esconde as opes de
pesqui sa e substi tui o.
Sel eci ona na l i sta de resul tados a
ocorrnci a anteri or.
Sel eci ona na l i sta de resul tados a
ocorrnci a segui nte.
NOTA: Para sel eci onar o objeto e mostrar o l ocal exato onde o texto se encontra,
basta um dupl o-cl i que na l i sta de resul tados, na l i nha desejada.
A tabel a a segui r contm as pri nci pai s opes de pesqui sa, bem como as
l i mi taes para os pri nci pai s ti pos de dados.
Principais opes de pesquisa
TIPO DE DADO EXEMPLO OBSERVAO
Data / Hora
10/02/2010
00:00:10
Encontra em propri edades
do ti po Data/Hora. Se for
especi fi cada somente a
data, encontra todas as
ocorrnci as desta data,
i ndependente da hora. Se
for especi fi cada somente a
hora, encontra todas as
ocorrnci as desta hora,
i ndependente da data. Os
mi l i ssegundos so
i gnorados na pesqui sa.
E3 Studio 37
TIPO DE DADO EXEMPLO OBSERVAO
Inteiro
0
100
Encontra em todas as
propri edades numri cas.
Pesqui sando por 10
encontrar 10 e 10.0, mas
no encontrar 10.1 ou 100.
Ponto flutuante
10.0
40,5
Encontra em todas as
propri edades numri cas
de ti po Ponto Flutuante.
Pesqui sando por 10.1 no
encontra 10 (i ntei ro). As
confi guraes regi onai s do
Wi ndows so
consi deradas para val i dar
o smbol o deci mal no
nmero.
Cor
255,255,0
0,0,234
Encontra apenas em
propri edades do ti po Cor.
Deve necessari amente
usar vrgul as para separar
os val ores, que devem
estar no si stema RGB.
Booleano
Verdadei ro
True
Leva em consi derao o
i di oma do Wi ndows para
entender a pesqui sa como
sendo de um val or
Bool eano.
String
Teste
Tag
Encontra Strings i ntei ras ou
partes de Strings (de acordo
com o ti po de pesqui sa,
por pal avra i ntei ra ou no).
Qual quer ti po de dado
pode ser encontrado em
propri edades do ti po
String.
2.4.3 Documentao de Scripts
A ferramenta Documentao de Scripts serve para auxi l i ar o usuri o na
organi zao e documentao dos scri pts da apl i cao. Essa ferramenta pode ser
acessada de duas manei ras:
Atravs do cone da barra de ferramentas Padro. Uti l i zando esta opo,
sero gravados no arqui vo todos os scri pts do Domni o
Cl i cando com o boto di rei to do mouse sobre o nome do projeto ou objeto e
sel eci onando a opo Documentar scripts. Uti l i zando esta opo, apenas os
scri pts do objeto sel eci onado e de seus fi l hos sero gravados no arqui vo
38 E3 Studio
Esta ferramenta gera um arqui vo texto que pode ser edi tado em qual quer programa
de edi o de textos. A formatao do arqui vo de documentao fei ta atravs de
um assi stente chamado Assistente de Documentao de Scripts. Esse assi stente
responsvel por gui ar o usuri o na confi gurao do arqui vo de documentao de
scri pts.
Assistente de Documentao de Scripts
Na janel a Arqui vo de documentao, so defi ni das as i nformaes referentes ao
arqui vo que guardar os scri pts da apl i cao.
No i tem Nome do arquivo, especi fi que o nome do arqui vo onde ser gerada a
documentao dos scri pts. Especi fi que o l ocal onde este arqui vo ser sal vo no
i tem Salvar o arquivo na pasta, e caso haja necessi dade, cl i que em Procurar.
E3 Studio 39
Arquivo de documentao de scripts
Cl i que em Avanar para i r prxi ma janel a.
A janel a Detal hamento do arqui vo permi te que se formate o arqui vo que contm as
i nformaes de scri pts. possvel escol her entre uma documentao si mpl i fi cada,
contendo apenas os nomes dos scri pts, ou uma documentao compl eta, onde todo
o cdi go dos scri pts ser gravado no arqui vo.
40 E3 Studio
Detalhamento do arquivo
Por exempl o, o scri pt a segui r:
Sub TelaInicial_KeyDown(KeyCode, Shift)
If (KeyCode = 27) Then
Application.Exit
End Sub
Se a opo escol hi da for Apenas os nomes dos scripts, ser gravado no arqui vo o
texto segui nte:
TelaInicial_KeyDown(KeyCode, Shift)
Se for escol hi da a opo Todo o script, ento todo o cdi go ser gravado com a
mesma formatao (i dentao, l i nhas em branco, etc.) fei ta pel o usuri o no edi tor
de scri pts.
Independente do ti po de formatao escol hi da, antes do scri pt gravado um
i denti fi cador contendo o nome compl eto do objeto, para evi tar confl i tos. Por
exempl o, para os segui ntes objetos:
TelaInicial
CommandButton1
Tela1
CommandButton1
E3 Studio 41
Ambos os scri pts (consi derando um mesmo evento, Click) seri am
CommandButton1_Click(). Assi m, a gravao no arqui vo fi cari a desta forma:
<TelaInicial.CommandButton1:CommandButton1_Click()>
Sub CommandButton1_Click()
...
End Sub
E:
<Tela1.CommandButton1:CommandButton1_Click()>
...
End Sub
Isto permi te a i denti fi cao correta de cada scri pt. Cl i que em Avanar para i r
prxi ma janel a.
Na janel a Separador de scri pts, possvel defi ni r o texto que ser gravado entre um
scri pt e outro no arqui vo de documentao. possvel escol her entre l i nhas em
branco ou personal i zadas, e ai nda i nformar quantas l i nhas do ti po escol hi do
sero i nseri das no arqui vo.
Separador de scripts
42 E3 Studio
Pode-se optar entre uma Linha em branco ou uma Linha personalizada. Escol hendo a
opo Linha em branco, o arqui vo de documentao ter uma l i nha em branco
entre um scri pt e outro. Escol hendo a opo Linha personalizada, pode-se i nformar
um ou mai s caracteres para compor a l i nha que ser usada como separador. Os
caracteres so i nformados no campo Entre com o texto da linha. Se a opo
sel eci onada Repetir at o final da linha, os caracteres i nformados sero repeti dos
at o l i mi te de tamanho da l i nha, que de 80 caracteres. Pode-se tambm uti l i zar
mai s de uma l i nha como separador, seja el a em branco ou personal i zada. Basta
i nformar um nmero entre 1 e 100, no campo Entre com o nmero de linhas do
separador. Cl i que em Avanar para fi nal i zar a confi gurao. Logo aps, o assi stente
mostrar uma mensagem i ndi cando a fi nal i zao da confi gurao e a gerao do
arqui vo que contm a documentao dos scri pts.
Mensagem de finalizao da gerao do arquivo que contm os scripts
Al gumas observaes rel evantes:
Os scri pts de XControl s e XObjects so gravados apenas uma vez no arqui vo,
poi s so encontrados durante a pesqui sa na bi bl i oteca. Scri pts de i nstnci as
sero gravados quando o objeto pai da i nstnci a for pesqui sado
Pi cks so i nternamente scri pts; l ogo, tambm sero documentados
A gravao no arqui vo fei ta em ordem al fabti ca do nome do objeto, dentro de
cada projeto ou bi bl i oteca
E3 Studio 43
No possvel adi ci onar scri pts a um arqui vo j exi stente, vi a Assi stente. Sempre
que o Assi stente i ni ci ado, um novo arqui vo ser cri ado ou, caso j exi sta, ser
sobrescri to
Esta ferramenta pode demorar al gum tempo para gerar o arqui vo de
documentao, caso a apl i cao seja grande e a pesqui sa envol va mui tos ti pos
de objetos. Para agi l i zar a pesqui sa, i nteressante gerar um arqui vo para cada
ti po de objeto do E3
2.4.4 Relatrio de Verses
A ferramenta Relatrio de verses permi te a vi sual i zao das verses e
comentri os dos projetos e das bi bl i otecas abertos, pertencentes ou no ao
Domni o. Para acessar essa ferramenta, basta cl i car em na barra de
ferramentas Padro, que a cai xa de di l ogo segui nte ser mostrada.
Relatrio de verses
As opes mostradas nesta cai xa de di l ogo so as segui ntes:
Opes disponveis na caixa de dilogo Relatrio de verses
OPO DESCRIO
Projeto/Biblioteca
Nome do projeto ou da bi bl i oteca
abertos.
Verso
I ndi ca a verso do projeto ou bi bl i oteca.
Esta verso gerada i nternamente pel o
E3, sendo i ncrementada toda a vez que o
projeto sal vo, manual ou
automati camente. No caso de projetos
ou de bi bl i otecas protegi dos, se a verso
no puder ser sal va, tambm no ser
possvel seu i ncremento. No entanto, se
o usuri o tem permi sso para abri r e
al terar o projeto ou a bi bl i oteca, a
verso ser i ncrementada normal mente.
44 E3 Studio
OPO DESCRIO
Comentrio
Mostra o comentri o rel aci onado ao
projeto. Esse comentri o pode ser
edi tado atravs da propri edade
DocString. No caso de bi bl i otecas, esse
campo fi ca em branco.
NOTA: Estes campos so apenas para vi sual i zao, no sendo permi ti da sua
edi o.
2.4.5 WatchWindow
A ferramenta WatchWindow permi te a vi sual i zao do val or corrente de qual quer
propri edade ou Tag em tempo de execuo no E3 Studi o. Para uti l i zar essa
ferramenta, deve-se cl i car em na barra de ferramentas Padro ou uti l i zar o
menu Ferramentas - WatchWindow para mostrar a cai xa de di l ogo a segui r:
Caixa de dilogo WatchWindow
E3 Studio 45
A cai xa de di l ogo apresenta as segui ntes opes:
Opes disponveis na caixa de dilogo WatchWindow
OPO DESCRIO
Adicionar
Abre o Domai nBrowser (um AppBrowser
com os objetos cri ados no servi dor) e
sel eci ona o objeto que ser mostrado na
janel a do WatchWi ndow.
Remover
Remove a l i nha sel eci onada da l i sta de
objetos do WatchWi ndow.
Atualizar
Busca toda a rvore de fi l hos dos objetos
sel eci onados atual mente pel o
WatchWi ndow.
Conectar
Tenta reati var a conexo perdi da com o
Domni o para que a vi sual i zao seja
possvel .
Nome
I ndi ca o Tag ou a propri edade sendo
vi sual i zada.
Qualidade
I ndi ca a qual i dade do Tag ou da
propri edade.
Estampa de tempo
I ndi ca a estampa de tempo do Tag ou da
propri edade.
Valor
I ndi ca o val or do Tag ou da propri edade,
em tempo de execuo.
Status
I ndi ca se o Domni o est conectado ou
desconectado.
2.5 Organizer
O Organizer permi te uma vi so si mpl es e organi zada de toda a apl i cao,
ajudando na edi o e confi gurao de todos os objetos envol vi dos, atravs de uma
rvore hi errqui ca de opes. Possui doi s modos de vi sual i zao, Domnio e
Explorer.
46 E3 Studio
Organizer
O modo Domnio mostra apenas as i nformaes dos objetos abertos pertencentes
ao Domni o. Essas i nformaes esto organi zadas em quatro grupos: Configurao,
Bibliotecas de Objetos, Visualizao e Objetos de Servidor. Cada grupo apresenta
seus objetos ordenados al fabeti camente dentro do respecti vo n.
E3 Studio 47
Modo Domnio
O grupo Configurao mostra os servi dores confi gurados, bem como os nomes dos
arqui vos de projetos e de bi bl i otecas pertencentes ao Domni o.
O grupo Bibliotecas de Objetos agrupa os objetos El i pseX de todas as bi bl i otecas
pertencentes ao Domni o, organi zados por ti po de objetos (XObjects e XControls).
Os demai s objetos do E3 esto nos grupos Visualizao e Objetos de Servidor. Em
Visualizao esto os objetos que rodam na mqui na cl i ente; j os objetos
executados na mqui na servi dor esto em Objetos de Servidor.
O modo Explorer mostra projetos e bi bl i otecas abertos no E3 Studi o, pertencentes
ou no ao Domni o. Os objetos so mostrados no projeto ou na bi bl i oteca ao qual
pertencem, ordenados al fabeti camente dentro de cada um.
48 E3 Studio
Modo Explorer
A manuteno da apl i cao pode ser fei ta em qual quer um dos doi s modos. As
operaes real i zadas em um modo sero i medi atamente refl eti das no outro. Para
faci l i tar a l ocal i zao dos objetos, ambos os modos so i ntercambi vei s, tanto
entre si como com a aba Design da view do objeto. Para al ternar o modo de
vi sual i zao, si ga estes procedi mentos:
1. No modo Domnio, cl i que com o boto di rei to do mouse no objeto e sel eci one
Mostrar no Explorer para vi sual i z-l o no modo Explorer.
2. No modo Explorer, cl i que com o boto di rei to do mouse no objeto e sel eci one
Mostrar no Organizer para vi sual i z-l o no modo Domnio.
3. Em qual quer um dos modos, cl i que com o boto di rei to do mouse no objeto e
sel eci one Mostrar no Editor para vi sual i z-l o di retamente na aba Design.
4. Em qual quer view de objetos, na aba Design, cl i que com o boto di rei to do
mouse no objeto e sel eci one Mostrar no Organizer ou Mostrar no Explorer para
vi sual i z-l o no Organi zer, em seu respecti vo modo.
Ao cl i car em um objeto com o boto esquerdo do mouse, suas propri edades
podero ser vi sual i zadas e edi tadas atravs da Li sta de Propri edades, se
habi l i tada. Cl i cando com o boto di rei to do mouse sobre cada i tem do Organi zer,
so mostradas as segui ntes opes:
Opes disponveis no Organizer
OPO DESCRIO
Fechar
Fecha o projeto ou bi bl i oteca corrente.
Atualizar
Atual i za as confi guraes do projeto ou
bi bl i oteca.
Registrar
Regi stra a bi bl i oteca para que as
modi fi caes executadas estejam
di sponvei s.
E3 Studio 49
OPO DESCRIO
Salvar Como
Abre uma cai xa de di l ogo para que o
projeto ou a bi bl i oteca sejam sal vos no
l ocal i ndi cado.
Desfragmentar
Desfragmenta arqui vos (.l i b ou .prj), i sto
, faz com que os espaos cri ados
desnecessari amente (por excl uso de
i tens, i mportao de arqui vos, i ncl uso
de recursos, etc.) sejam apagados. Aps a
desfragmentao, uma janel a ser
exi bi da contendo as segui ntes
i nformaes: tamanho ori gi nal do
arqui vo, tamanho desfragmentado e
percentual de compactao.
Proteo
Protege o contedo de um arqui vo .prj ou
.l i b contra a edi o, vi sual i zao ou
execuo no autori zada. Mai ores
i nformaes no captul o Segurana.
Nova Pasta
Cri a uma nova Pasta na apl i cao.
Inserir
I nsere objetos di sponvei s no E3 no
projeto ou na bi bl i oteca. Mai s
i nformaes sobre essa opo nos
respecti vos captul os de cada objeto.
Inserir Recurso
I nsere recursos no projeto ou na
bi bl i oteca.
Habilitar/Desabilitar projeto
Habi l i ta ou desabi l i ta o projeto
sel eci onado. Para desabi l i tar o projeto,
sel eci one seu nome e escol ha a opo
Desabilitar projeto. Observe que o cone do
projeto muda para , i ndi cando que o
projeto est desabi l i tado. Para habi l i tar o
projeto, sel eci one o projeto e escol ha a
opo Habilitar projeto.
Adicionar/Remover do Domnio
Adi ci ona ou remove o projeto ou a
bi bl i oteca do Domni o. Para remover o
projeto ou a bi bl i oteca, sel eci one seu
nome e escol ha a opo Remover do
Domnio. Para adi ci on-l os ao Domni o,
sel eci one-os e escol ha a opo Adicionar
ao Domnio.
Procurar/Substituir
Busca por trechos de texto e os substi tui
por outros, se for o caso. Mai ores
i nformaes sobre essa opo na seo
Procurar e Substituir deste captul o.
Importar/Exportar
Auxi l i a o usuri o na i mportao e na
exportao de objetos, Associ aes e
col ees. Mai ores i nformaes sobre
essa opo na seo Importao e
Exportao deste captul o.
50 E3 Studio
OPO DESCRIO
Documentar Scripts
Auxi l i a o usuri o com a documentao
dos scri pts da apl i cao. Mai ores
i nformaes sobre essa opo na seo
Documentao de Scripts deste captul o.
Verificar
Veri fi ca os erros ocorri dos na apl i cao.
Mai ores i nformaes sobre essa opo
na seo Verificar Domnio deste captul o.
Editar Associaes
Muda uma ou mai s Associ aes, eventos
de usuri o e propri edades do ti po Link
fei tas na apl i cao, de forma mai s rpi da
do que pel a janel a tradi ci onal . Mai ores
i nformaes sobre essa opo no
captul o Associaes.
Copiar/Colar Associaes
Copi a ou col a Associ aes de um objeto
para outro. A segunda opo s
mostrada se o que esti ver copi ado na
rea de Transfernci a do Wi ndows for
uma Associ ao. Se a propri edade em
questo j possui r uma Associ ao,
mostrada uma mensagem ao usuri o
perguntando se a Associ ao deve ser
sobrescri ta ou no.
Se as Associ aes copi adas na rea de
Transfernci a forem col adas em um
objeto que no possua al guma das
propri edades, estas sero l i stadas para o
usuri o em uma mensagem i nformando o
probl ema. As propri edades que exi sti rem
tero as Associ aes cri adas
corretamente. Associ aes de
propri edades escondi das dos El i pseX no
so copi adas.
Propriedades
Abre a Janel a de Propri edades do objeto.
Quando essa opo aberta pel o menu,
a pri mei ra aba a ser aberta ser a de
confi guraes do objeto. Mai s
i nformaes sobre essa opo nos
respecti vos captul os de cada objeto.
Carregar Todos os Objetos
Carrega todos os objetos do grupo
sel eci onado.
Fechar Todos os Objetos
Fecha todos os objetos do grupo
sel eci onado.
Salvar Todos os Objetos
Sal va todos os objetos do grupo
sel eci onado.
Novo Arquivo de Aplicao (.prj)
Cri a um novo arqui vo .prj e o i ncl ui no
Domni o.
Nova Biblioteca de Objetos (.lib)
Cri a um novo arqui vo .l i b e o i ncl ui no
Domni o.
Registrar bibliotecas carregadas
Regi stra todas as bi bl i otecas.
E3 Studio 51
OPO DESCRIO
Abrir Todos os Arquivos
Percorre todos os arqui vos .prj e .l i b do
Domni o; se al gum arqui vo fechado for
encontrado, el e ser aberto. Se o arqui vo
esti ver protegi do com senha de edi o,
ser sol i ci tada a sua senha. O E3 Studi o
tenta uti l i zar a mesma senha em todos os
arqui vos protegi dos. Se a senha fal har
com al gum arqui vo, el a sol i ci tada
novamente.
Fechar Todos os Arquivos
Fecha todos os arqui vos .prj e .l i b do
Domni o. Se al gum arqui vo tem al teraes
no sal vas, perguntado para o usuri o
se el e deseja sal v-l as.
Editar a Ordem de Ativao
Permi te edi tar a ordem de ati vao dos
objetos de Servi dor no Domni o (ver fi gura
a segui r).
Ordem de Ativao do Domnio
52 E3 Studio
2.6 Importao e Exportao
A ferramenta de i mportao de objetos do E3 tem como objeti vo l er as i nformaes
sobre os objetos de um arqui vo CSV (Comma Separated Values) e recri -l os no
ambi ente de confi gurao (E3 Studi o). Para cada objeto possvel obter
i nformaes sobre propri edades, Associ aes e i tens de col ees.
A ferramenta de exportao de objetos do E3 tem como objeti vo gravar i nformaes
sobre os objetos escol hi dos a parti r do ambi ente de confi gurao (E3 Studi o) em
um arqui vo CSV. Para cada objeto podem ser gravadas suas propri edades,
Associ aes e i tens de col ees. possvel , portanto:
Cri ar novos objetos do E3 a parti r do arqui vo CSV, desde que estes no sejam
di retamente objetos fi l hos do projeto ou bi bl i oteca
Importar ou exportar qual quer propri edade de qual quer ti po de objeto do E3
Importar ou exportar qual quer ti po de Associ ao de objetos do E3
Exportar qual quer ti po de col eo de objetos do E3 e i mportar suas propri edades
Importar ou exportar qual quer ti po de i tem da col eo de objetos do E3
Qual quer objeto do E3 poder ser i mportado ou exportado. O objeto sel eci onado
para a operao chamado de objeto rai z. Com i sso, possvel i mportar ou
exportar, por exempl o, uma Pasta de Dados com XObjects defi ni dos pel o usuri o,
ou mesmo exportar uma Tel a, l i stando todos os objetos fi l hos.
Al m dos objetos, as Associ aes e as col ees tambm podem ser i mportadas e
exportadas. O usuri o tem a opo de i nformar se quer i mportar ou exportar
Associ aes e col ees ou no.
NOTA: A ferramenta de i mportao e exportao consi dera apenas as propri edades
e Associ aes dos objetos e col ees do E3. I nformaes que no estejam
descri tas em propri edades no sero i mportadas ou exportadas. I sso o caso, por
exempl o, de scri pts e confi guraes i nternas dos objetos de Tel a.
2.6.1 Arquivo CSV
Um arqui vo CSV (Comma Separated Values) um arqui vo texto baseado em col unas
separadas por vrgul a, ou por outro separador previ amente defi ni do. No E3, el es
contm as i nformaes sobre os objetos que foram exportados, e so uti l i zados na
i mportao para que esses objetos sejam cri ados corretamente no E3 Studi o. Cada
col una do arqui vo CSV representa uma ou mai s propri edades de objetos do E3.
Cada l i nha do arqui vo representa um objeto, Associ ao ou i tem de col eo. Para
que esses arqui vos sejam uti l i zados corretamente, preci so observar al guns
detal hes:
A pri mei ra l i nha do arqui vo CSV deve conter um cabeal ho que i denti fi ca as
E3 Studio 53
col unas corretamente
O cabeal ho deve ter obri gatori amente uma col una que i denti fi ca o ti po do
objeto que est sendo i mportado ou exportado. Esta col una chama-se
ObjectType. O val or desta col una o nome da cl asse do objeto (XObject1,
DrawRect, InternalTag, AgSimple, etc.), com exceo das col ees, que
apresentam pal avras-chave pr-defi ni das (ITableBindRow, IAxis, etc.)
O cabeal ho das demai s col unas deve ser o prpri o nome da propri edade em
questo
As col unas podem ser col ocadas em qual quer ordem no arqui vo; pode haver
col unas a mai s ou a menos, sem prejuzo da operao de i mportao ou
exportao. A ni ca col una obri gatri a ObjectType, porque sem el a no
possvel i denti fi car o ti po de objeto que deve ser cri ado
2.6.1.1 Criando um Arquivo CSV Manualmente
possvel cri ar um arqui vo com extenso .csv a parti r do Bl oco de Notas, do Excel
ou de outro apl i cati vo do Wi ndows. O arqui vo ser cri ado consi derando o
separador de el ementos confi gurado no Wi ndows (na confi gurao por usuri o,
no do si stema).
A pri mei ra l i nha do arqui vo deve conter um cabeal ho com os nomes das col unas
desejadas. Cada col una dever ser uma propri edade ou um i denti fi cador defi ni do
no model o, conforme ser vi sto a segui r. Nas l i nhas devero ser col ocados os
objetos, e os val ores das propri edades nas col unas correspondentes. No
necessri o que todas as propri edades dos objetos sejam l i stadas no cabeal ho,
bem como podem exi sti r col unas que no estejam associ adas a propri edades de
um determi nado objeto.
i mportante tambm que o arqui vo CSV tenha uma col una para a propri edade
Name. Sem el a, no possvel determi nar exatamente onde o objeto em questo
deve ser cri ado. Os nomes mostram a hi erarqui a correta do objeto, e nomes com
caracteres especi ai s devem ser del i mi tados por col chetes.
A segui r, um exempl o de um arqui vo CSV que pode ser cri ado manual mente no
Excel .
1. Abra o Excel e confi gure o cabeal ho com os campos, um em cada col una,
conforme a fi gura a segui r.
54 E3 Studio
Arquivo CSV Visualizado no Excel
2. Sal ve a pl ani l ha com a extenso .csv.
3. Feche o arqui vo no Excel .
4. Para i mportar este arqui vo no E3, sel eci one um objeto IODri ver e i mporte o
arqui vo cri ado atravs da opo Importar, escol hendo o model o adequado. O
E3 cri ar a estrutura de acordo com o arqui vo CSV.
2.6.2 Objetos
A i mportao ou a exportao de objetos no E3 pode ser fei ta a parti r de qual quer
ti po de objeto, exceto projetos e bi bl i otecas. A operao a parti r do objeto rai z
fei ta sobre suas propri edades e seus objetos fi l hos. Para exportar objetos, si ga
esses procedi mentos:
1. Cl i que com o boto di rei to do mouse sobre o objeto desejado e sel eci one a
opo Exportar.
2. Na cai xa de di l ogo, sel eci one o arqui vo CSV desejado e cl i que em Salvar.
E3 Studio 55
Exportao de Objetos
Na exportao, todas as propri edades, Associ aes, col ees e i tens de col ees
do objeto sel eci onado e de seus fi l hos sero automati camente exportadas.
gerado um arqui vo CSV com uma l i nha para cada objeto exportado, bem como para
cada Associ ao, col eo ou i tem de col eo exi stente nesses objetos. Para cada
propri edade cri ada uma col una no arqui vo, onde i nformado o val or da
propri edade para cada objeto.
O objeto sel eci onado, chamado de objeto rai z, exportado com a col una da
propri edade Name em branco. Nos demai s casos, essa col una contm a hi erarqui a
com nomes separados por pontos. Exempl o de exportao a parti r de um objeto
IODri ver.
Hierarquia do objeto
Driver1
ObjectType;Name;Prop1;Prop2;Prop3
IODriver;;0;True;0
56 E3 Studio
IOBlock;Bloco1;0;False;0
IOBlockElement;Bloco1.Elemento1;0;False;0
IOBlock;Bloco2;0;False;0
IOTag;Tag1,0,True,0
Se desejar, o usuri o pode confi gurar a exportao de objetos atravs do uso de
model os, que so apresentados na seo Modelos. Uti l i zando um model o possvel
confi gurar se as Associ aes, col ees e i tens de col ees sero ou no
exportados, se o objeto rai z ser exportado ou no, quai s as propri edades de cada
objeto devem ser exportadas, entre outras confi guraes. Para i sso, si ga estes
procedi mentos:
opo Exportar.
2. Cl i que em Avanado para confi gurar ou sel eci onar um model o.
3. Na cai xa de di l ogo, sel eci one o arqui vo CSV desejado e cl i que em Salvar.
Para i mportar objetos, si ga esses procedi mentos:
opo Importar.
2. Na cai xa de di l ogo, sel eci one o arqui vo CSV desejado e cl i que em Abrir.
Importao de Objetos
E3 Studio 57
Na i mportao, para cada l i nha l i da do arqui vo CSV i denti fi cado o objeto que
ser cri ado. Apenas o fi l ho mai s ao fi nal da hi erarqui a pode ser cri ado. O restante
do cami nho deve exi sti r. Por exempl o, no objeto Pasta1.Pasta2.Tag, apenas Tag
deve ser cri ado. Pasta1 e Pasta2 devem exi sti r previ amente. Assi m, permi ti do ter
no arqui vo apenas pastas, sem fi l hos. O arqui vo poder ter l i nhas como essas:
ObjectType;Name
IOFolder;Pasta1
As l i nhas em branco, as l i nhas onde no encontrado um i denti fi cador de ti po
vl i do, as col unas em branco e as col unas que tenham nomes i nvl i dos de
propri edades so i gnoradas, sem gerar erro.
2.6.3 Modelos
Os Modelos so arqui vos INI uti l i zados para confi gurar a ferramenta de
i mportao e exportao, i nformando, por exempl o, qual o separador que deve ser
uti l i zado no arqui vo CSV, se as Associ aes dos objetos devem ou no ser
exportadas, etc. Os arqui vos INI tm o segui nte formato:
Li nhas i ni ci adas por ponto e vrgul a so comentri os, desconsi derados na
i nterpretao do arqui vo
O arqui vo organi zado em sees, e cada seo contm uma ou mai s vari vei s.
As sees so i denti fi cadas por nomes entre col chetes. As vari vei s so as
pal avras antes do smbol o de i gual dade. Uma seo no pode conter duas
vari vei s com o mesmo nome
Li nhas em branco so i gnoradas
Um exempl o de arqui vo INI mostrado a segui r:
; Primeira seo
[SECAO1]
Var1 = 0
Var2 = 1
; Segunda seo
[SECAO2]
Var1 = TRUE
Var3 = FALSE
O formato um texto faci l mente modi fi cvel pel o usuri o, sendo possvel gerar um
model o novo uti l i zando um edi tor de textos comum. O mesmo model o pode ser
uti l i zado tanto para a i mportao como para a exportao de objetos.
Os model os uti l i zados no E3 permi tem que o usuri o redefi na val ores para nomes
das col unas do arqui vo CSV, bem como para os ti pos de objetos. Al m di sso,
tambm permi tem que o usuri o agrupe mai s de uma propri edade em uma mesma
col una. Isso tudo fei to atravs da defi ni o de i denti fi cadores, que so pal avras-
58 E3 Studio
chave uti l i zadas no arqui vo CSV e associ adas a propri edades ou cl asses de objetos
no arqui vo INI.
No E3, os model os da ferramenta de i mportao e exportao esto defi ni dos com
as segui ntes sees e vari vei s:
Sees definidas para os Modelos
SEO DESCRIO
Header (*)
Defi ne os i denti fi cadores permi ti dos
para nomes de col unas e ti pos de dados.
Nesta seo devero ser defi ni das as
vari vei s header e types.
(*) Seo obri gatri a para a exportao.
Configuration
Defi ne confi guraes adi ci onai s para a
ferramenta de i mportao e exportao.
Nesta seo devero ser defi ni das as
vari vei s separator, root, link,
collection, objectduplicated e
bindduplicated.
Types
Rel aci ona os i denti fi cadores de ti pos de
dados com as cl asses de objetos reai s.
Cada i denti fi cador l i stado na vari vel
types que no for i gual a um nome de
cl asse de objeto dever estar
documentado nessa seo, sendo cri ada
uma vari vel para cada um dos
i denti fi cadores.
Columns
Rel aci ona os i denti fi cadores de nomes
de col unas com os nomes de
propri edades. Cada i denti fi cador l i stado
na vari vel header que no for i gual a
um nome de propri edade dever estar
documentado nessa seo, sendo cri ada
uma vari vel para cada um dos
i denti fi cadores.
Filter
Defi ne quai s as cl asses de objetos que
devero ou no ser i mportadas ou
exportadas. Nesta seo deve ser
defi ni da uma das duas vari vei s:
include ou exclude. Se ambas forem
defi ni das, apenas include ser
consi derada.
E3 Studio 59
Variveis definidas para os Modelos
SEO DESCRIO
header (*)
Defi ne a ordem das col unas e os
i denti fi cadores que sero uti l i zados.
Devem ser l i stadas todas as col unas que
o arqui vo CSV ter, separadas por
vrgul as. Cada i denti fi cador que no for
i gual a um nome de propri edade dever
ser di scri mi nado na seo Columns, cada
um com uma vari vel .
(*) Vari vel obri gatri a para a
exportao.
types
Defi ne os i denti fi cadores para os ti pos
de dados permi ti dos no arqui vo CSV. Os
i denti fi cadores devero ser l i stados
nessa vari vel separados por vrgul as. S
necessri o defi ni r essa vari vel se
al gum i denti fi cador for di ferente do
nome da cl asse do objeto. Nesse caso,
para cada um dos i denti fi cadores dever
haver tambm uma vari vel na seo
Types.
separator
Defi ne o separador que ser uti l i zado
para del i mi tar as col unas no arqui vo
CSV. Caso essa vari vel no seja
defi ni da, ser uti l i zado o separador de
l i stas confi gurado no Wi ndows.
root
Defi ne se o objeto rai z ser exportado ou
i mportado junto com os objetos fi l hos.
Caso essa vari vel no seja defi ni da, o
objeto rai z ser uti l i zado.
link
Defi ne se as Associ aes dos objetos
sero exportadas ou i mportadas. Caso
essa vari vel no seja defi ni da, as
Associ aes so uti l i zadas.
collection
Defi ne se as col ees dos objetos sero
exportadas ou i mportadas. Caso essa
vari vel no seja defi ni da, as col ees
so uti l i zadas.
60 E3 Studio
SEO DESCRIO
objectduplicated
Defi ne o que fazer quando um objeto
pr-exi stente esti ver sendo i mportado.
Os val ores possvei s para essa vari vel
so: 0 - askalways (sempre questi ona o
usuri o sobre o que deve ser fei to); 1 -
changealways (sempre al tera as
propri edades do objeto exi stente); 2 -
ignorealways (sempre i gnora o objeto
sendo i mportado); e 3 - createalways
(sempre cri a um objeto novo, auto-
i ncrementando o nome). Caso essa
vari vel no seja defi ni da, assumi do o
val or askalways. Essa opo no tem
val or na exportao.
bindduplicated
Defi ne o que fazer quando uma
Associ ao pr-exi stente esti ver sendo
i mportada. Os val ores possvei s para
essa vari vel so: 0 - askalways (sempre
questi ona o usuri o sobre o que deve
ser fei to); 1 - changealways (sempre
substi tui a Associ ao exi stente pel a
nova); e 2 - ignorealways (sempre i gnora a
Associ ao sendo i mportada). Caso essa
val or na exportao, nem tampouco
possui o val or createalways; neste caso,
sempre modi fi cado para askalways.
collectionduplicated
Defi ne o que fazer quando uma col eo
pr-exi stente esti ver sendo i mportada.
Os val ores possvei s para essa vari vel
so: 0 - askalways (sempre questi ona o
usuri o sobre o que deve ser fei to); 1 -
changealways (sempre substi tui a col eo
exi stente pel a nova); e 2 - ignorealways
(sempre i gnora a col eo sendo
i mportada). Caso essa vari vel no seja
defi ni da, assumi do o val or askalways.
Essa opo no tem val or na exportao,
nem tampouco possui o val or
createalways; neste caso, sempre
modi fi cado para askalways.
E3 Studio 61
SEO DESCRIO
itemduplicated
Defi ne o que fazer quando um i tem de
col eo pr-exi stente esti ver sendo
i mportado. Os val ores possvei s para
essa vari vel so: 0 - askalways (sempre
questi ona o usuri o sobre o que deve
ser fei to); 1 - changealways (sempre al tera
as propri edades do i tem exi stente); 2 -
ignorealways (sempre i gnora o i tem
sendo i mportado); e 3 - createalways
(sempre cri a um i tem novo, auto-
i ncrementando o nome). Caso essa
val or na exportao.
include
Defi ne quai s cl asses de objetos devero
ser i mportadas ou exportadas. O fi l tro
no recursi vo, ou seja, se for i ncl uda
uma cl asse de um objeto que possa ter
fi l hos, esses fi l hos no sero i ncl udos
automati camente. No pode ser usada
junto com a vari vel exclude. Apenas o
que esti ver defi ni do nessa vari vel ser
exportado ou i mportado.
exclude
Defi ne quai s cl asses de objetos no
devero ser i mportadas ou exportadas. O
fi l tro no recursi vo, ou seja, se for
excl uda uma cl asse de um objeto que
possa ter fi l hos, esses fi l hos no sero
excl udos automati camente. No pode
ser usada junto com a vari vel include.
Apenas o que esti ver defi ni do nessa
vari vel ser desconsi derado na
i mportao ou na exportao.
NOTA: O caractere de ponto e vrgul a no pode ser uti l i zado como nome ou parte do
nome da col una, nem tampouco como nome ou parte do nome do i denti fi cador de
ti po. Esta l i mi tao se deve ao fato de esse caractere defi ni r um comentri o no
arqui vo I NI . Dessa forma, a vari vel cri ada na seo Columns ou na seo Types para
defi ni r o i denti fi cador que possui o ponto e vrgul a no pode ser l i da corretamente.
Exempl o:
[Header]
header = ObjectType,Name,DocString,N1/B1,N2/B2,N3/B3,N4/
B4,Scan,AllowRead,AllowWrite
types = Tag,Bloco,Elemento
[Configuration]
62 E3 Studio
separator = ','
root = true
link = true
collection = true
objectduplicated = askalways
bindduplicated = askalways
collectionduplicated = askalways
itemduplicated = askalways
[Types]
Tag = IOTag
Bloco = IOBlock
Elemento = IOBlockElement
[Columns]
N1/B1 = N1,B1
N2/B2 = N2,B2
N3/B3 = N3,B3
N4/B4 = N4,B4
[Filter]
exclude = IOFolder
A El i pse Software fornece al guns model os para i mportao e exportao de al guns
ti pos de objetos. Esses model os tambm podem ser uti l i zados como base para a
cri ao de outros. Os model os forneci dos esto na pasta Templ ates da i nstal ao
do E3.
NOTA: Na i mportao, as col unas que sero uti l i zadas so l i das di retamente do
arqui vo CSV. Neste caso especfi co, no necessri a a vari vel header no model o.
Porm, se al guma col una for nomeada por um i denti fi cador, este dever estar
defi ni do na seo Columns ou a col una ser i gnorada.
2.6.4 Gerenciador de Modelos
O Gerenciador de Modelos uma ferramenta para auxi l i ar o usuri o na cri ao de
um arqui vo INI para ser uti l i zado na i mportao ou exportao de objetos do E3.
Para acess-l o, basta cl i car na opo Importar/Exportar e, uma vez aberta a janel a
da opo, cl i car em Avanado. Caso o usuri o j tenha carregado um model o, os
val ores i ni ci ai s das opes nas abas da janel a estaro de acordo com o que foi
previ amente confi gurado. As abas di sponvei s so:
Configuraes: Atravs desta aba, o usuri o pode confi gurar as opes vl i das
tanto para a i mportao quanto para a exportao
E3 Studio 63
Aba Configuraes
64 E3 Studio
Opes disponveis na aba Configuraes
OPO DESCRIO
Separador de colunas
As opes di sponvei s so: Usar o
separador de listas do Windows (escol he o
caractere defi ni do no Wi ndows como
separador de l i stas para ser usado como
separador de col unas do arqui vo CSV) e
Usar outro caractere como separador
(escol he outro caractere defi ni do pel o
usuri o como separador de col unas).
Outras opes
Defi ne o que ser i mportado ou
exportado: objetos, Associ aes ou
col ees. As opes di sponvei s so:
Importar/exportar o objeto raiz, Importar/
exportar associaes e Importar/exportar
colees.
Salvar modelo
Quando a opo Salvar as alteraes deste
modelo em um arquivo INI for marcada,
defi ni do o arqui vo I NI onde as
al teraes do model o sero sal vas, e
esse arqui vo poder ser reuti l i zado.
Quando for desmarcada, as
confi guraes fei tas sero sal vas
temporari amente em um arqui vo na
pasta de arqui vos temporri os do
Wi ndows. Esse arqui vo ser uti l i zado
para a i mportao ou exportao
real i zada l ogo aps a confi gurao, e
ser removi do depoi s di sso.
Importao: Atravs desta aba, o usuri o pode confi gurar as opes vl i das
somente para a i mportao.
E3 Studio 65
Aba Importao
66 E3 Studio
Opes disponveis na aba Importao
OPO DESCRIO
Importao de objetos duplicados
Especi fi ca como o E3 deve l i dar com a
ocorrnci a de objetos dupl i cados na
i mportao. As opes di sponvei s so
Questionar sobre o que fazer em cada caso,
Sempre sobrescrever o objeto existente,
Sempre ignorar o objeto duplicado e Sempre
criar um novo objeto.
Importao de associaes duplicadas
ocorrnci a de Associ aes dupl i cadas na
Sempre sobrescrever a associao existente
e Sempre ignorar a associao duplicada.
Importao de colees duplicadas
ocorrnci a de col ees dupl i cadas na
Sempre sobrescrever a coleo existente e
Sempre ignorar a coleo duplicada.
Importao de itens de coleo duplicados
ocorrnci a de i tens de col eo
dupl i cados na i mportao. As opes
di sponvei s so Questionar sobre o que
fazer em cada caso, Sempre sobrescrever o
item existente, Sempre ignorar o item
duplicado e Sempre criar um novo item.
Filtros: Atravs desta aba, o usuri o pode escol her quai s as cl asses que sero
uti l i zadas na i mportao ou na exportao, ou quai s cl asses no deseja uti l i zar
E3 Studio 67
Aba Filtros
Opes disponveis na aba Filtros
OPO DESCRIO
No filtrar objetos
Defi ne a i mportao ou a exportao de
todos os objetos.
68 E3 Studio
OPO DESCRIO
Incluir apenas estes objetos
Defi ne quai s cl asses de objetos sero
i mportadas ou exportadas.
Excluir apenas estes objetos
Defi ne quai s cl asses de objetos no
sero i mportadas ou exportadas.
Alterar
Abre uma janel a para sel eo das
cl asses de objetos a serem i ncl udas ou
excl udas.
Abre uma janel a de ajuda para a opo.
Cl i cando em Alterar, abre-se a segui nte janel a para a escol ha de cl asses:
Classes de Objetos
As cl asses que preenchem i ni ci al mente a l i sta so as do objeto rai z e seus fi l hos,
caso um novo model o esteja sendo cri ado. O usuri o pode adi ci onar outras,
cl i cando em , ou remover al guma cl asse, cl i cando em .
Identificadores: Atravs desta aba, o usuri o defi ne os i denti fi cadores para as
cl asses de objetos escol hi das. O estado i ni ci al dessa l i sta vazi o
E3 Studio 69
Aba Identificadores
Opes disponveis na aba Identificadores
OPO DESCRIO
Nome da classe
I ndi ca o nome da cl asse sel eci onada
na opo.
70 E3 Studio
OPO DESCRIO
Identificador
Permi te ao usuri o al terar o val or a ser
uti l i zado na col una ObjectType do
arqui vo CSV. O val or i ni ci al nesta col una
sempre o nome da cl asse do objeto.
Para cada val or al terado aqui , cri ada
uma entrada no arqui vo I NI na seo
Types. Os val ores no so sensvei s
cai xa (i sto , "AAA", "aaa" e "aAa" so o
mesmo val or). Caso o usuri o defi na
val ores i guai s para mai s de um ti po,
apenas o pri mei ro ti po ser
consi derado na i mportao, e al gum
objeto poder ser cri ado com o ti po
errado.
Adi ci ona cl asses de objetos.
Remove a cl asse de objetos
sel eci onada.
Apresenta uma janel a com texto de
ajuda.
Propriedades: Atravs desta aba, o usuri o escol he quai s as propri edades dos
objetos que deseja uti l i zar na i mportao ou na exportao. O val or i ni ci al da
l i sta ObjectType; as demai s propri edades devem ser adi ci onadas manual mente
pel o usuri o
E3 Studio 71
Aba Propriedades
72 E3 Studio
Opes disponveis na aba Propriedades
OPO DESCRIO
Nome da coluna
Permi te ao usuri o al terar o val or a ser
uti l i zado como nome da col una no
cabeal ho do arqui vo CSV. O val or i ni ci al
dessa col una sempre o prpri o nome
da propri edade do objeto. Para cada
val or al terado nessa col una, cri ada
uma entrada no arqui vo I NI na seo
Columns. Os nomes das col unas no so
sensvei s cai xa (i sto , "AAA", "aaa" e
"aAa" so o mesmo val or); caso o
usuri o defi na nomes de col unas i guai s
para mai s de uma propri edade, apenas
uma del as ser i denti fi cada
corretamente, e todas as col unas com o
mesmo nome sero rel aci onadas
mesma propri edade; nesse caso, al gum
val or pode ser sobrescri to.
Propriedade
I ndi ca a propri edade sendo i mportada
ou exportada.
e
Redefi nem a ordem das col unas ao
al terar a ordem das propri edades na
l i sta.
Adi ci ona propri edades l i sta.
Excl ui propri edades da l i sta, com
exceo de ObjectType.
Al ternati vamente, pode-se uti l i zar a
tecl a DELETE para excl ui r uma
propri edade.
Cri a um nome de col una associ ado a
mai s de uma propri edade. Sel eci one as
propri edades que deseja agrupar e
cl i que neste boto. Os nomes das
propri edades so agrupados em uma
mesma l i nha, uti l i zando o nome da
col una defi ni do para a propri edade que
est no topo da l i sta.
Mostra uma janel a com texto de ajuda.
Ao cl i car em , a segui nte janel a aberta para a sel eo de propri edades:
E3 Studio 73
Seleo de Propriedades
Opes disponveis na janela Propriedades
OPO DESCRIO
Classes de objetos
Apresenta as cl asses de objetos que se
enquadram no fi l tro escol hi do a parti r
do objeto rai z.
Adi ci ona todas as propri edades do ti po
de objeto sel eci onado na opo
anteri or.
Listar todas as classes de objetos do E3
Se esta opo for sel eci onada, a cai xa
de sel eo de objetos mostrar todas
as cl asses exi stentes no E3,
i ndependente de fi l tro ou objeto rai z.
Propriedades
Mostra as propri edades do objeto
sel eci onado.
As propri edades em negri to nesta l i sta j foram i nseri das na l i sta que defi ne as
col unas do arqui vo CSV. Um dupl o-cl i que sobre uma propri edade faz com que el a
seja adi ci onada ou removi da, dependendo se el a j estava ou no na l i sta. Se a
74 E3 Studio
propri edade havi a si do agrupada com outras, o dupl o-cl i que remove apenas essa
propri edade do agrupamento, mantendo as outras propri edades agrupadas
corretamente.
As propri edades do ti po TextFont possuem propri edades i nternas que confi guram
separadamente ti po, tamanho e outras caractersti cas da fonte. El as so
exportadas com o nome da propri edade pri nci pal (de acordo com o objeto),
segui do do nome da propri edade i nterna, separados por um ponto (por exempl o,
TextFont.Bold). No confi gurador de model os, as propri edades i nternas aparecem
separadas para o usuri o, para que a escol ha possa ser fei ta i sol adamente.
Propriedades do Tipo TextFont
2.6.5 Importao de Objetos do SCADA para o E3
A parti r da verso 2.29 do El i pse SCADA foram desenvol vi das funci onal i dades que
faci l i tam a exportao de Tags, al armes e al guns objetos de Tel a do El i pse SCADA, e
a i mportao destes no E3.
E3 Studio 75
2.6.5.1 Tags de Comunicao (PLC e Bloco)
Os Tags de Comuni cao do El i pse SCADA so exportados separadamente para
cada Dri ver. Para fazer a exportao, abra a apl i cao no El i pse SCADA e si ga estes
procedi mentos:
1. No Organi zer do El i pse SCADA, abra a pasta de Dri vers e cl i que no Dri ver
desejado.
2. Cl i que em Exportar.
Exportao de Drivers
3. Escol ha o l ocal e o nome do arqui vo a ser gerado. Al m do arqui vo com as
confi guraes dos Tags, ser gerado um arqui vo com o mesmo nome, segui do
do sufi xo _Al arms. Esse arqui vo ser uti l i zado posteri ormente na i mportao
da confi gurao de al armes no E3.
Para fazer a i mportao dos Tags no E3, si ga esses passos:
1. Insi ra um Dri ver de Comuni cao no Organi zer.
76 E3 Studio
2. Renomei e o Dri ver para que fi que com o mesmo nome do Dri ver uti l i zado na
apl i cao El i pse SCADA, para que posteri ormente as refernci as para os Tags
desse Dri ver sejam i mportadas corretamente.
3. Cl i que com o boto di rei to do mouse no Dri ver de Comuni cao, e cl i que em
Importar.
4. Na l i sta de ti pos de arqui vos, sel eci one a opo Arquivos do Elipse SCADA
(*.e2f), e a segui r sel eci one o arqui vo exportado anteri ormente, sem o sufi xo
_Al arms. No necessri o sel eci onar um model o.
Importao de Tags
2.6.5.2 Tags RAM e Demo
Para exportar os Tags RAM e Demo, si ga estes passos:
1. No Organi zer do El i pse SCADA, cl i que na pasta Tags.
E3 Studio 77
Exportao de Tags RAM e Demo
confi guraes dos Tags, ser gerado um arqui vo com o mesmo nome segui do
do sufi xo _Al arms. Esse arqui vo ser uti l i zado posteri ormente na i mportao
da confi gurao de al armes no E3.
Para fazer a i mportao dos Tags no E3, si ga esses passos:
1. Insi ra um Servi dor de Dados no Organi zer.
2. Renomei e o Servi dor de Dados para Dados, para que posteri ormente as
Associ aes dos objetos de Tel a sejam i mportadas corretamente.
3. Cl i que com o boto di rei to do mouse no Servi dor de Dados, e cl i que na opo
Importar.
78 E3 Studio
2.6.5.3 Configurao e Tags de Servidores OPC
1. No Organi zer do El i pse SCADA, abra a pasta OPCServers e cl i que no Dri ver OPC
desejado.
Exportao de Configuraes e Tags de Servidores OPC
confi guraes dos Tags OPC, ser gerado um arqui vo com o mesmo nome
segui do do sufi xo _Al arms. Esse arqui vo ser uti l i zado posteri ormente na
i mportao da confi gurao de al armes no E3.
Para fazer a i mportao dos Tags OPC no E3 3.0, si ga esses passos:
1. No Organi zer, i nsi ra um novo Dri ver de Comuni cao OPC.
2. Renomei e o Dri ver de Comuni cao OPC para que fi que com o mesmo nome do
Dri ver OPC uti l i zado na apl i cao El i pse SCADA, para que posteri ormente as
refernci as para os Tags deste Dri ver OPC sejam i mportadas corretamente.
3. Cl i que com o boto di rei to do mouse no Dri ver OPC, e sel eci one a opo
Importar.
E3 Studio 79
2.6.5.4 Configurao de Alarmes
A exportao da Confi gurao de Al armes fei ta automati camente ao exportar os
Tags, segui ndo os passos descri tos anteri ormente. Al m do arqui vo com os Tags
gerado um arqui vo com o mesmo nome acresci do do sufi xo _Al arms. Por exempl o,
se o nome escol hi do foi TagsInternos, so gerados os arqui vos TagsInternos.e2f
e TagsInternos_Al arms.e2f. Este segundo arqui vo com o prefi xo _Al arms contm a
confi gurao dos al armes dos Tags exportados. Para i mportar esses al armes no
E3, si ga esses passos:
1. No Organi zer, i nsi ra uma nova Confi gurao de Al armes, e i nsi ra uma rea.
2. Cl i que com o boto di rei to do mouse na rea e sel eci one a opo Importar.
3. Se a i mportao foi real i zada com sucesso, os al armes devero aparecer sem
nenhuma mensagem de erro. Caso os Tags correspondentes j tenham si do
i mportados, todas as refernci as devero aparecer na cor azul .
2.6.5.5 Telas
A exportao de Tel as do El i pse SCADA parci al e suporta apenas um subconjunto
dos objetos de Tel a. Para exportar uma Tel a, si ga esses passos:
1. No Organi zer do El i pse SCADA, abra a pasta Tel as e cl i que sobre a Tel a
desejada.
80 E3 Studio
Exportao de Telas
3. Escol ha o l ocal e o nome do arqui vo a ser gerado.
4. No Organi zer, i nsi ra uma nova Tel a.
5. Cl i que com o boto di rei to do mouse sobre a Tel a e sel eci one a opo
Importar.
(*.e2f), e a segui r sel eci one o arqui vo exportado anteri ormente. No
necessri o sel eci onar um model o.
Se a i mportao foi real i zada com sucesso, a Tel a ser preenchi da com os objetos,
e nenhuma mensagem de erro ser mostrada. Os arqui vos de i magens uti l i zados
pel a Tel a devem ser tratados conforme um dos casos a segui r:
Arquivos de imagens com caminhos relativos na aplicao Elipse SCADA: estes
arqui vos devem ser i nseri dos manual mente como Recursos no projeto do E3.
possvel i nseri r vri os arqui vos de uma vez, cl i cando com o boto di rei to do
mouse na pasta Recursos do Organi zer, e escol hendo a opo Inserir recurso em
Arquivos de imagens com caminhos absolutos: estes arqui vos devem permanecer
nos seus di retri os ori gi nai s. O E3 i r procur-l os no mesmo di retri o onde so
E3 Studio 81
encontrados pel a apl i cao do El i pse SCADA
NOTA: recomendado i nseri r todos os arqui vos no projeto como Recursos, para que
o E3 Vi ewer possa fazer o download automati camente pel a rede. I sso evi ta a
necessi dade de ter que i nstal ar os arqui vos manual mente nas mqui nas cl i ente.
2.6.6 Associaes
Para a i mportao ou a exportao de Associ aes no E3, deve ser sel eci onada a
opo correspondente no model o. No h como excl ui r apenas um ou outro ti po de
Associ ao: ou todas so i mportadas ou exportadas, ou nenhuma.
Cada Associ ao ocupa uma l i nha no arqui vo CSV. A i denti fi cao das Associ aes
fei ta atravs das segui ntes pal avras-chave:
AgSimple: para Associ aes Si mpl es, Bi di reci onai s ou Reversas (essas devero
ser di ferenci adas pel as propri edades Reverse e Bidirectional)
AnalogBind: para Associ aes Anal gi cas
AnimationBind: para Associ aes Di gi tai s
TableBind: para Associ aes por Tabel a
As propri edades ou os campos das Associ aes so i mportados ou exportados
como se fossem propri edades de objetos, com uma col una no arqui vo CSV para
cada uma del as. Todas as Associ aes possuem as propri edades Source e
Property, e al m del as, as propri edades exi stentes para cada Associ ao so as
segui ntes:
AgSimple: Reverse, Bidirectional
AnalogBind: SrcHiValue, SrcLoValue, DstHiValue, DstLoValue
AnimationBind: BlinkOn, BlinkOff, OnValue, OffValue, BlinkOnValue, BlinkOffValue
A cri ao de l i nhas da tabel a respei ta o ndi ce i nformado pel o usuri o. Se o ndi ce
no for um nmero, mostrada uma mensagem de erro (nome i nvl i do). Se for um
ndi ce i nexi stente (por exempl o, s exi stem duas l i nhas na tabel a e o usuri o quer
i nseri r a l i nha ci nco), as l i nhas que fal tam so cri adas e fi cam com os val ores
padro.
Todas as Associ aes so i mportadas ou exportadas, i ndependente da sel eo de
propri edades que o usuri o tenha fei to. Se uma Associ ao para determi nada
propri edade j exi sti r, o usuri o ser questi onado sobre o que fazer. Caso
contrri o, el as sero cri adas.
82 E3 Studio
Importao de uma Associao pr-existente
No nome do objeto, deve ser i nformado o cami nho compl eto, no formato
Objeto.Links.Nome. Exempl o:
'Links indica que uma Associao
'e Value a propriedade que possui a Associao
Texto1.Links.Value
2.6.7 Colees e seus Itens
Para a i mportao ou a exportao de col ees no E3, deve ser sel eci onada a
opo correspondente no model o. No h como excl ui r apenas uma ou outra
col eo: ou todas so i mportadas ou exportadas, ou nenhuma.
As col unas de cada col eo dependem das propri edades que essa col eo possui .
O tratamento fei to da mesma forma que nas col unas das propri edades dos
objetos.
No caso de col ees e i tens de col eo, as propri edades preci sam ser i ncl udas no
arqui vo INI manual mente. No possvel sel eci onar essas propri edades atravs do
confi gurador de model os.
As col ees podem ser i mportadas e suas propri edades, atual i zadas. Como as
col ees sempre exi stem, e no possvel cri ar outra col eo do mesmo ti po, o
usuri o questi onado se deseja i gnorar ou sobrescrever a col eo exi stente.
Se o i tem de col eo que est sendo i mportado j exi sti r, o usuri o questi onado
se deseja i gnor-l o, sobrescrev-l o ou cri ar um novo. Caso o usuri o sel eci one
essa l ti ma opo:
No caso de Penas e Ei xos, o nome ser auto-i ncrementado corretamente
No caso de l i nhas da Associ ao por Tabel a, el as sero cri adas sempre ao fi nal
desta
E3 Studio 83
No caso de col unas da Legenda, ser mostrada uma mensagem de erro
i nformando que o nome no vl i do, ou que j exi ste a col una e o nome no
pode ser auto-i ncrementado (as col unas da Legenda tm nomes pr-defi ni dos e
no possvel cri ar col unas com outros nomes)
No nome do objeto, deve ser i nformado o cami nho compl eto no formato
Objeto.Collection.Name. Exempl o:
E3Chart1.Pens.Pena1
Na col una de ti po deve aparecer uma das segui ntes pal avras-chave:
IDispChartPen: para Penas do E3Chart
ILegendColumn: para Legendas do E3Chart
IAxis: para Ei xos do E3Chart
ITableBindRow: para l i nhas das Associ aes por Tabel a
2.6.8 Logs e Relatrios de Falhas
Durante o processo de i mportao ou exportao, gerado um arqui vo de l og
contendo os erros ocorri dos e al gumas outras consi deraes rel evantes, caso a
seo de l og ImportExport esteja habi l i tada. Para habi l i tar esta seo, consul te o
captul o Configuraes Avanadas.
Ao fi nal da operao, h uma opo para vi sual i zar um rel atri o de fal has na
i mportao. Neste rel atri o constam fal has que provavel mente so erros no
arqui vo CSV, como objeto i nexi stente, entre outras.
Relatrio de falhas na importao
84 E3 Studio
2.7 Lista de Propriedades
A Lista de Propriedades uma janel a de confi gurao das propri edades do objeto
sel eci onado.
O ttul o da Li sta de Propri edades mostra sempre o nome do objeto sel eci onado no
momento. Para que esta cai xa esteja vi svel no projeto, necessri o que a opo
Lista de Propriedades esteja marcada no menu Visualizar.
Lista de Propriedades
Pode-se confi gurar um val or para uma propri edade di gi tando di retamente no
campo sel eci onado, ou ai nda segui ndo as i nstrues da janel a ao cl i car na col una
Valor.
2.8 Galeria
Col eo de objetos grfi cos que podem ser arrastados e i nseri dos nas Tel as das
apl i caes. Estes objetos so arqui vos do ti po Metafi l es (WMF, Wi ndows
MetaFi l e).
E3 Studio 85
Galeria
2.9 AppBrowser
O AppBrowser uma ferramenta que auxi l i a o usuri o a montar a apl i cao
i nformando uma expresso l gi ca, uma Associ ao ou um val or para a
propri edade sendo mani pul ada, de acordo com o objeto sel eci onado. Assi m,
possvel mi ni mi zar erros durante a cri ao da apl i cao.
86 E3 Studio
AppBrowser
No quadro esquerda so mostrados os objetos do E3 que podem ser uti l i zados
para compor o texto que ser o resul tado do uso do AppBrowser. De acordo com
seu contexto de uti l i zao, al guns objetos no podero ser uti l i zados e nem sero
mostrados aqui .
No quadro central so mostradas as propri edades e os mtodos do objeto
sel eci onado, e no quadro di rei ta o texto de ajuda da propri edade ou do mtodo
sel eci onado.
Mai s abai xo mostrado o texto resul tante do AppBrowser, ao l ado dos botes
Colar e Cancelar. Cl i que em Colar para acei tar o resul tado e copi ar o val or para o
l ocal desejado. Cl i que em Cancelar para i gnor-l o.
NOTAS:
Ao sel eci onar Tags, o AppBrowser sempre aberto na l ti ma posi o, e no na
posi o apontada pel o link atual .
O AppBrowser possui a funo Auto Complete: basta di gi tar o nome do objeto
desejado que el e ser automati camente sel eci onado.
Exi stem trs manei ras de se uti l i zar o AppBrowser:
Atravs de scripts
Atravs de Associaes
Atravs de al gumas propriedades de objetos que possuem como val or um outro
nome de objeto
Cada uma destas manei ras ser abordada nos tpi cos segui ntes.
E3 Studio 87
2.9.1 Acesso via Script
Para uti l i zar o AppBrowser a parti r de um scri pt, basta abri r a view de scri pts
desejada e cl i car em na barra de ferramentas Scripts. Neste modo, os objetos
esto separados conforme a fi gura a segui r.
AppBrowser via Scripts
No quadro esquerda:
O pri mei ro i tem, mostrado i sol adamente, o Contexto. O objeto contexto o que
ori gi nou a chamada do AppBrowser, ou seja, o dono do scri pt
O segundo i tem a Hierarquia compl eta para se chegar ao objeto contexto, caso
o contexto no esteja na rai z do projeto. Esse objeto pode ser expandi do e o
prpri o objeto contexto pode ser vi sto nesta hi erarqui a
Caso o contexto no seja um objeto do servi dor, o tercei ro i tem mostrado ser o
Viewer (objeto Appl i cati on)
O quarto i tem o Servidor. Nel e so l i stados todos os objetos do servi dor que a
apl i cao possui . Caso este i tem seja o contexto atual , el e conter a i ndi cao
de Application
O qui nto i tem chamado de Tarefas. Nel e aparecem as tarefas mai s comuns de
serem executadas atravs de um scri pt. So duas: Carregar relatrio (cujo
resul tado do AppBrowser a expresso para carregar um Rel atri o) e Abrir tela
(cujo resul tado a expresso para abri r a Tel a sel eci onada, equi val ente ao Pi ck
Abrir Tela)
Fi nal mente, o sexto i tem mostra todas as funes do VBScript di sponvei s para
uso em scri pts
88 E3 Studio
De acordo com o objeto sel eci onado, o quadro central mostra suas propri edades e
seus mtodos.
2.9.2 Acesso via Associao
Para acessar o AppBrowser a parti r de uma Associ ao, basta abri r a Janel a de
Propri edades, sel eci onar a aba Associaes, l ogo aps a propri edade desejada, e
fi nal mente cl i car em di rei ta. O AppBrowser aberto e os objetos so
apresentados conforme a fi gura a segui r.
AppBrowser via Associaes
Neste caso, apenas as propri edades dos objetos so mostradas no quadro central
da janel a. Seus mtodos no so mostrados, poi s no permi ti do us-l os em
Associ aes.
2.9.3 Acesso via Propriedade
Al gumas propri edades permi tem o uso do AppBrowser para auxi l i ar no
preenchi mento correto do val or esperado. Estas propri edades, quando
sel eci onadas, mostram um boto di rei ta do campo Valor da Lista de
Propriedades. Ao cl i car nesse boto o AppBrowser aberto, mostrando apenas os
objetos que podem ser usados como val or da propri edade sel eci onada. As
propri edades e mtodos destes objetos so omi ti dos. o caso, por exempl o, da
propri edade DBServer do objeto Frmul a. O AppBrowser mostra apenas os objetos
do ti po Banco de Dados exi stentes na apl i cao.
E3 Studio 89
AppBrowser via Propriedade
As propri edades que permi tem o uso do AppBrowser so:
DBServer dos objetos Frmul a, Histrico e Storage
DataSource, do objeto Servi dor de Al armes
InitialScreen, do objeto Vi ewer
SplitLink, do objeto Quadro
2.10 Conectar A
A opo Conectar a uti l i zada para determi nar a conexo do E3 Studi o a um
servi dor. Esta opo permi te confi gurar em qual servi dor de Domni o o E3 Studi o
deve se conectar, e permi te tambm i nformar se o E3 Studi o deve obter a l i cena do
servi dor onde roda o Domni o ou se deve obter a l i cena em um outro servi dor.
Para uti l i zar este recurso, cl i que no menu Arquivo - Conectar a, e a segui nte cai xa
de di l ogo aberta.
90 E3 Studio
Janela Conectar a
Opes disponveis na janela Conectar a
OPO DESCRIO
Conectar ao servidor local
Habi l i ta a conexo com o servi dor l ocal .
Conectar a um servidor na rede
Habi l i ta a conexo com um servi dor da
rede. Para tanto, basta acess-l o atravs
da cai xa de sel eo.
Pegar licena no servidor de Domnio atual
Usa l i cena do servi dor onde roda o
Domni o.
Usar licena de um servidor especfico
Usa a l i cena de outro servi dor, que no
o servi dor que est rodando o Domni o.
Se a conexo com qual quer dos doi s servi dores (Domni o ou l i cena) cai r, o E3
Studi o desconectado do outro servi dor. A l ti ma confi gurao guardada no
Regi stro do Wi ndows e, da prxi ma vez em que o E3 Studi o for aberto, el e se
conectar aos servi dores de Domni o e de l i cena uti l i zados da l ti ma vez.
Se o servi dor de l i cena no esti ver di sponvel , ou se no houver mai s l i cenas
di sponvei s, ento o E3 Studi o fi car em modo Demo. Um E3 Studi o sem l i cena
(modo Demo) s poder se conectar a um servi dor de Domni o que tambm esteja
em modo Demo.
Se o servi dor de l i cena for di ferente do servi dor de Domni o, o nome do servi dor de
l i cena mostrado no ttul o da janel a do E3 Studi o: (l i cena no servi dor l ocal ) ou
(l i cena em <Nome_Servi dor>).
Se for especi fi cado um servi dor de l i cena, a janel a de l i cenas do E3 Server no
E3 Studio 91
servi dor de Domni o mostra o nome do servi dor que est emprestando a l i cena
para o E3 Studi o: SERVIDOR1 (l i cena emprestada de SERVIDOR2). Neste caso a
l i cena que est l i stada no servi dor de Domni o no entra na contagem de l i cenas
de E3 Studi o em uso naquel e servi dor.
Se o servi dor de Domni o no possui r uma l i cena, e um E3 Studi o se conectar a
este servi dor usando a l i cena de outro, ento o servi dor de Domni o passar
temporari amente de modo Demo para modo Studio, vol tando para modo Demo
assi m que a sesso de E3 Studi o for fechada.
NOTA: Quando o E3 Studi o esti ver uti l i zando uma l i cena emprestada de outro
servi dor, el e deve forosamente permanecer aberto enquanto o apl i cati vo esti ver
em execuo. Se el e for fechado enquanto o apl i cati vo esti ver rodando, a l i cena
de E3 Studi o emprestada (que permi te a execuo do apl i cati vo por sei s horas)
ser l i berada, e o E3 Server fi nal i zar a execuo do apl i cati vo i medi atamente (em
no mxi mo 10 segundos).
DICA: Quando o usuri o conectar a um servi dor, i mportante que os apl i cati vos
sejam abertos atravs de um cami nho na rede. Ao i nvs de usar C:\projetos
\projeto.dom, uti l i ze o cami nho \\server\projetos\projetos.dom. Desta forma, o E3
Studi o e o E3 Server remoto podero acessar os arqui vos uti l i zando o mesmo
cami nho.
92 Domnios
3
Domnios
CAPTULO
Um Domnio um conjunto de objetos e confi guraes que defi nem um si stema de
supervi so. Corresponde ao Aplicativo no El i pse SCADA.
O E3 um ambi ente modul ar de desenvol vi mento e execuo de si stemas de
supervi so, composto pel os mdul os descri tos nas sees a segui r.
3.1 E3 Server
O E3 Server o coordenador de todos os mdul os do E3. El e sempre roda como
servi o, mesmo no modo Demo, seja el e regi strado como servi o ou com o
parmetro /regserver, e deve estar sempre rodando. Pode tambm ser i ni ci ado
quando um E3 Studio l ocal for i ni ci ado, ou atravs de um atal ho para rodar o
Domni o (por exempl o, e3admin start app.dom). El e responsvel por:
Veri fi car e gerenci ar l i cenas de uso dos di ferentes mdul os do E3
Ini ci ar, parar ou moni torar o processo de runtime (E3Run) do Domni o
Abri r, edi tar ou mani pul ar arqui vos DOM
Control ar o acesso de usuri os aos objetos do Domni o
Moni torar outros servi dores do Domni o e i mpl ementar o Hot-Standby
O E3 Server pode trabal har com apenas um arqui vo de Domni o por vez, e este
chamado de Domnio aberto. Os arqui vos de Domni o s so mani pul ados pel o E3
Server.
3.1.1 Licenciamento
O E3 Server suporta doi s modos de l i cenci amento: Licena Ativa e Demo. O modo de
l i cenci amento defi ni do na i ni ci al i zao do servi dor. Se h um di sposi ti vo de
proteo vl i do (do ti po hardkey ou softkey), o E3 Server entra em modo Licena
Ativa. Se nenhum di sposi ti vo for l ocal i zado, entra em modo Demo.
Se houver a troca do di sposi ti vo, o E3 Server i r comparar as l i cenas deste novo
di sposi ti vo com as l i cenas do di sposi ti vo anteri or, e far os segui ntes ajustes:
Se as novas l i cenas forem exatamente iguais em l i mi taes s do di sposi ti vo
anteri or, sero apl i cadas i medi atamente
Se as novas l i cenas forem menos limitadas do que as do di sposi ti vo anteri or,
tambm sero apl i cadas i medi atamente
Domnios 93
Se as novas l i cenas forem mais limitadas do que as do di sposi ti vo anteri or, o E3
Server aguardar por um mi nuto para que o di sposi ti vo anteri or seja
reconectado. Ao fi nal deste perodo, se as l i cenas conti nuarem restri ti vas, o
servi dor ser rei ni ci ado e as novas l i cenas sero apl i cadas
NOTA: Para mai ores i nformaes sobre l i cenci amento no E3, entre em contato com
o setor comercial da El i pse Software.
3.2 E3Run
O E3Run o processo responsvel pel a execuo dos objetos do servi dor: Tags,
Al armes, Banco de Dados, Hi stri cos, etc.; ou seja, todos os objetos exceto as Tel as
e o objeto Vi ewer.
A execuo do E3Run i ndi cada no cone do E3 Admin na rea de Noti fi cao do
Wi ndows, de acordo com a tabel a a segui r:
Opes disponveis para cones da rea de Notificao
OPO DESCRIO
Seta verde: mostrada quando o Domni o
est carregado e rodando.
Quadrado ci nza: o Domni o est
carregado, mas no rodando.
Li nha reta amarel a (gi ratri a): mostrada
quando o Domni o est sendo i ni ci ado
ou parado. Ocorre nos casos em que o
Domni o demora a comear a execuo,
como um si nal de espera.
Barras amarel as: mostradas quando o
Domni o est em espera.
O E3Run sempre roda como servi o, seja el e regi strado como servi o ou com o
parmetro /regserver. Este processo usa o protocol o REC para se conectar fi l a de
banco de dados do E3 Server.
3.3 E3 Admin
O E3 Admin o mdul o responsvel por moni torar e comandar o E3 Server.
si mbol i zado pel o cone na rea de Noti fi cao do Wi ndows. Este mdul o
i ni ci ado quando o usuri o l oga no Wi ndows, ou quando o servi o do E3 Server
i ni ci ado.
O E3 Admi n tambm responsvel por tratar as opes de control e do Domni o vi a
l i nha de comando, das segui ntes manei ras: e3admin <nome_do_dominio> [opes]
ou e3admin [opes] <nome_do_dominio>. As opes de l i nha de comando so
l i stadas a segui r:
94 Domnios
-start ou /start: Ini ci a o Domni o i nformado pel o usuri o. O uso desta opo no
obri gatri o. Mesmo se no for i nformada, o Domni o ser i ni ci ado
-viewer ou /viewer: Executa o Vi ewer para a apl i cao
-load: Semel hante opo -start, porm somente carrega o Domni o, sem execut-
l o. No pode ser usada com a opo -viewer
-stop: Para o Domni o em execuo, quando exi sti r. Esta opo deve ser uti l i zada
sozi nha
-close: Para e fecha o Domni o em execuo, quando exi sti r. Esta opo deve ser
uti l i zada sozi nha
-refresh: Fora a atual i zao do Domni o sem a uti l i zao de um Vi ewer
-help: Mostra uma cai xa de di l ogo com as opes de l i nha de comando para o
E3 Admi n, como na fi gura a segui r:
Caixa de dilogo com as opes de linha de comando do E3 Admin
Se as opes -load, -start ou -viewer forem uti l i zadas, o Wi ndows Vi sta pede
autori zao de Admi ni strador quando o E3 Admi n no foi i ni ci ado por um usuri o
Admi ni strador do si stema (dependendo da confi gurao do Controle de Conta de
Usurio do Wi ndows Vi sta).
Domnios 95
Caso exi stam restri es no Domni o, as opes -load, -stop, -refresh e -close pedem
o l ogi n do usuri o.
3.4 IOServer
O IOServer o processo responsvel pel a execuo dos Drivers de Comunicao.
Cada Dri ver roda em um IOServer separado. Os IOServers so cri ados, manti dos e
moni torados pel o processo E3Run.
3.5 E3 Studio
O E3 Studio o ambi ente de desenvol vi mento e confi gurao de apl i cati vos.
Permi te abri r e edi tar arqui vos .prj ou .l i b. O E3 Studi o mul ti -usuri o, i sto ,
vri os E3 Studi os podem modi fi car os mesmos arqui vos ao mesmo tempo. O E3
Studi o uti l i za a conexo REC para se comuni car com o E3 Server.
3.6 E3 Viewer
O E3 Viewer a i nterface com o usuri o em tempo de execuo, poi s mostra as
Tel as em execuo e permi te a operao do si stema. O E3 Vi ewer pode ser
executado a parti r de qual quer ponto da rede que tenha acesso ao E3 Server, sem a
necessi dade de copi ar o apl i cati vo para os outros E3 Vi ewers, poi s as Tel as e os
bi tmaps so carregados conforme a necessi dade, em tempo de execuo.
3.7 Componentes
Um Domni o consti tudo dos arqui vos descri tos nas sees segui ntes.
3.7.1 Arquivo de Configurao
O arqui vo .dom armazena quatro ti pos de i nformaes:
Opes de confi gurao do Domni o
Li sta de arqui vos .prj e .l i b que contm os Tags, Tel as, defi ni es de objetos, etc.
Confi guraes dos servi dores (computadores) que i ro rodar o Domni o
Confi guraes de usuri os e permi sses de acesso
3.7.2 Arquivo de Projeto
Um Domni o pode ter um ou mai s arqui vos de projeto. Cada arqui vo .prj contm
defi ni es de objetos, Tags, Tel as, Hi stri cos, Al armes, bi tmaps, etc. A organi zao
dos objetos dentro de um arqui vo .prj l i vre; podem ser cri ados di versos nvei s de
Pastas dentro do projeto, e cada Pasta pode conter qual quer ti po de objeto. O
usuri o pode di vi di r os objetos de um si stema de supervi so em um ou mai s
arqui vos .prj, dependendo das suas necessi dades. Em tempo de execuo, cada
96 Domnios
projeto pode ser ati vado, i ndependente dos outros, i ncl usi ve em servi dores
di ferentes.
3.7.3 Arquivo de Biblioteca
Os arqui vos .l i b contm defi ni es de objetos cri ados pel o usuri o (ElipseX), que
podem ser uti l i zados nos arqui vos de projeto.
3.8 Criando um Domnio
Exi stem duas manei ras de se cri ar um Domni o no E3:
Atravs do menu Arquivo - Novo Domnio. Para i sso, necessri o que ao menos
um projeto ou uma bi bl i oteca esteja aberto. Ao sel eci onar esta opo, o E3 abre
uma cai xa de di l ogo para a escol ha do cami nho e do nome do novo Domni o
Criando um novo Domnio
A segui r, o usuri o deve deci di r se deseja i ncl ui r projetos ou bi bl i otecas abertos no
novo Domni o cri ado.
Domnios 97
Confirmao de insero do projeto ou biblioteca no novo Domnio
Atravs do Assi stente de Apl i caes do E3, que permi te a cri ao de um Domni o
novo com um arqui vo de projeto (.prj) ou uma bi bl i oteca (.l i b), conforme a
prxi ma seo
3.8.1 Assistente de Aplicaes
O Assi stente de Apl i caes do E3 a ferramenta uti l i zada para cri ar um novo
Domni o com um projeto ou uma bi bl i oteca. Esta opo pode ser acessada das
segui ntes manei ras:
Cl i cando em Novo , na barra de ferramentas Padro
Atravs do menu Arquivo - Novo Projeto
Uma vez que o Assi stente tenha si do acessado, a tel a i ni ci al aberta. Para
conti nuar, cl i que em Avanar.
98 Domnios
Tela inicial do Assistente de Aplicaes
3.8.1.1 Tipo de Aplicao
Nesta tel a, pode-se escol her entre a cri ao de uma Aplicao padro, uma
Biblioteca de componentes do E3 ou uma Aplicao em branco.
Uma Aplicao padro aquel a cujo projeto possui pel o menos um objeto Vi ewer,
uma Tel a e um Servi dor de Dados, tendo ai nda a opo de i nseri r, com a ajuda do
Assi stente, um Dri ver de Comuni cao, um Banco de Dados, um Servi dor de Al armes
e uma Confi gurao de Al armes.
NOTA: as tel as Dri ver de Comuni cao, Banco de Dados e Al armes s sero
mostradas na cri ao de uma Apl i cao padro.
Uma Biblioteca de componentes do E3 um arqui vo uti l i zado para guardar
di versos componentes que podem ser uti l i zados em apl i caes.
Uma Aplicao em branco um projeto cri ado sem nenhum objeto.
No i tem Nome da aplicao, especi fi que o nome do arqui vo .prj ou .l i b que est
sendo cri ado (de acordo com o que foi escol hi do na opo anteri or). O l ocal onde a
apl i cao ser sal va especi fi cado no i tem Salvar a aplicao na pasta. Caso seja
necessri o, cl i que em Procurar.
Domnios 99
Tela Tipo de Aplicao
Caso a pasta i nformada no exi sta, o usuri o avi sado, e deve deci di r se deseja
cri -l a.
Aviso de pasta inexistente
Cl i que em Avanar para prossegui r.
NOTA: a opo Biblioteca de componentes do E3 ser di scuti da mai s adi ante, no
captul o Bibliotecas.
100 Domnios
3.8.1.2 Domnio
Nesta tel a, possvel deci di r a qual Domni o pertencer o projeto ou a bi bl i oteca
que est sendo cri ado. A habi l i tao da opo Adicionar no Domnio ativo
condi ci onada exi stnci a de Domni os ati vos no si stema; cl i cando nesta opo, o
novo projeto far parte do Domni o atual . A opo Criar um novo Domnio cri a um
novo Domni o, ao qual o projeto ou bi bl i oteca pertencer. O nome deste novo
Domni o i ndi cado na opo Entre com o nome do Domnio. Por fi m, com a opo
No adicionar em nenhum Domnio, o projeto ou bi bl i oteca cri ado conti nuar sem
pertencer a nenhum Domni o.
Tela Domnio
3.8.1.3 Resoluo do Viewer
Nesta tel a, o usuri o pode confi gurar as propri edades do Vi ewer que defi nem a
resol uo de trabal ho para a apl i cao sendo cri ada, ou seja, a resol uo do
computador que i r executar a apl i cao. Assi m, as Tel as que forem cri adas
podero ter seus tamanhos defi ni dos de forma que se ajustem janel a do Vi ewer
sem a necessi dade de barras de rol agem. A opo Resoluo da tela permi te
escol her dentre uma sri e de resol ues pr-defi ni das; j a opo Avanado
permi te i nformar um val or personal i zado.
Domnios 101
Tela Resoluo do Viewer
3.8.1.4 Driver de Comunicao
Nesta tel a, o usuri o pode deci di r pel a i ncl uso de um objeto Dri ver de
Comuni cao no projeto sendo cri ado. Caso posi ti vo, possvel confi gurar o
arqui vo .dl l que este Dri ver uti l i za, na opo Arquivo do driver de comunicao.
Para procurar o arqui vo, cl i que em .
102 Domnios
Tela Driver de Comunicao
3.8.1.5 Banco de Dados
Nesta tel a, o usuri o pode deci di r pel a i ncl uso de um objeto Banco de Dados no
projeto sendo cri ado. Caso posi ti vo, possvel confi gurar o arqui vo .mdb que este
Banco de Dados uti l i za, na opo Nome do arquivo de banco de dados Access. Para
procurar o arqui vo, cl i que em .
Domnios 103
Tela Banco de Dados
3.8.1.6 Alarmes
Nesta tel a, o usuri o pode deci di r pel a i ncl uso de um objeto Servi dor de Al armes e
de um objeto Confi gurao de Al armes no projeto sendo cri ado. A opo Desejo
guardar os dados dos alarmes em disco habi l i ta o armazenamento de i nformaes
rel ati vas a al armes em di sco, desde que um objeto Banco de Dados tenha si do
i nseri do no projeto.
104 Domnios
Tela Alarmes
Cl i que em Avanar para fi nal i zar a cri ao da apl i cao.
Aps, o si stema mostra a tel a fi nal do Assi stente, com uma mensagem que i ndi ca o
fi nal do processo de cri ao da apl i cao.
Domnios 105
Tela final do Assistente de Aplicaes
Fi nal i ze o processo cl i cando em Concluir.
3.9 Configuraes
Atravs do menu do E3 Admi n na rea de Noti fi caes do Wi ndows, possvel
executar, parar, atual i zar ou fechar o Domni o di retamente atravs das opes
Executar, Parar, Atualizar e Fechar, respecti vamente.
Al m di sso, o Domni o tambm pode ser confi gurado para apresentar redundnci a
e uti l i zar Domni os Remotos, entre outras aes. Essas confi guraes so fei tas
atravs da opo Domnio - Opes.
106 Domnios
Opes de configurao via rea de Notificaes do
Windows
NOTA: O menu Domnio - Opes no est di sponvel no modo Demo, e as opes de
Executar e Parar no esto di sponvei s se o Domni o esti ver em modo Hot-Standby ou
for aberto em um computador que no faz parte do Domni o.
Domnios 107
3.9.1 Aba Opes
Na aba Opes possvel habi l i tar a redundnci a de servi dores.
Aba Opes
OPO DESCRIO
Hot-Standby
Aci ona o modo Hot-Standby. Se a opo for
desabi l i tada, o Domni o executado no
servi dor em que foi carregado, sem suporte
a Hot-Standby. Se a opo for habi l i tada,
possvel sel eci onar um servi dor pri nci pal
onde o Domni o ser executado e,
opci onal mente, um servi dor em espera.
Servidor principal
Sel eci ona o nome do servi dor pri nci pal
para execuo do Domni o. Para cadastrar e
confi gurar os servi dores, uti l i ze a aba
Servidores.
108 Domnios
OPO DESCRIO
Servidor de backup
Se habi l i tado, sel eci ona um servi dor de
backup para execuo do Domni o. Este
servi dor fi ca em espera, com o apl i cati vo
carregado no E3Run pronto para ser
executado caso o servi dor pri nci pal fal he,
ou caso o servi dor de backup seja ati vado
manual mente.
Endereos para PING de integridade da
rede
O al gori tmo de Hot-Standby exi ge que seja
decl arada uma tercei ra enti dade de rede
(as outras duas so os servi dores pri nci pal
e o backup) para determi nar se a rede est
funci onando. Se no for possvel acessar o
endereo de i ntegri dade nem o servi dor de
backup, o servi dor pri nci pal assume que a
sua i nterface de rede est com probl emas
e termi na i medi atamente a execuo do
Domni o. Este campo permi te que vri os
endereos de rede sejam regi strados. As
opes para este campo so as segui ntes:
Os separadores permi ti dos para cada um
dos endereos so o espao, a vrgul a, o
ponto e vrgul a, a tabul ao e a quebra
de l i nha
Se pel o menos um dos endereos
forneci dos neste campo retornar
sucesso, a rede ser consi derada sem
fal has
Os nomes de servi dores no so
sensvei s cai xa
Nomes repeti dos so descartados
Espaos em branco antes ou depoi s do
endereo so removi dos
Ativar backup em caso de falha local
Habi l i ta a troca automti ca de servi dores
quando uma fal ha l ocal reportada no
servi dor pri nci pal . Fal has l ocai s so
detectadas e reportadas pel o prpri o
apl i cati vo atravs do mtodo
Application.ReportFailure. A troca de
servi dores s fei ta se o servi dor de backup
esti ver sem fal has.
Tempo para ativao do servidor reserva
Permi te i ndi car o tempo de ati vao para o
servi dor de backup. O val or padro 15
segundos. Este tempo afeta di retamente o
timeout do ping entre os servi dores. Se for
mui to abai xo (troca em um segundo,
timeout de ping em 160 ms), podem ocorrer
trocas espontneas de servi dor, causadas
por pequenas fal has de rede.
Domnios 109
OPO DESCRIO
Perfil de pr-ativao do servidor reserva
Apresenta os segui ntes perfi s de pr-
ati vao di sponvei s:
Mnimo: Ati va apenas os servi os bsi cos
Mximo: Faz com que o E3 ati ve o mxi mo
de objetos quando est em espera
(Associ aes, Dri vers, scri pts e Bancos de
Dados)
Definido pelo usurio: O usuri o pode
defi ni r quai s os servi os deseja ati var.
Cada uma das opes pode ser
habi l i tada ou desabi l i tada
i ndi vi dual mente
Pr-ativar os seguintes servios
Permi te ao usuri o escol her os servi os
que deseja ati var (desde que a opo
anteri or tenha si do habi l i tada como
Definido pelo usurio):
Associaes (Links): O val or padro
desabi l i tado. Se habi l i tado, faz com que
Associ aes e propri edades do ti po Link
de XObjects sejam aval i adas durante a
ati vao em espera
I/O Drivers (sem comunicao): O val or
padro desabi l i tado. Se habi l i tado, os
I OServers sero cri ados durante a
ati vao em espera. NOTA: Esta opo
i mportante em apl i cati vos com vri os
Dri vers de Comuni cao
Scripts: O val or padro desabi l i tado. Se
habi l i tado, faz com que todos os scri pts
de eventos de objetos e de bi bl i otecas
sejam compi l ados e ati vados durante a
ati vao em espera
Banco de Dados: O val or padro
habi l i tado. I sto si gni fi ca que o Banco de
Dados ser conectado durante a ati vao
em espera. Se desabi l i tado, el e apenas
evi ta que a conexo com o Banco de
Dados seja cri ada durante a ati vao em
espera
Esta opo habi l i tada automati camente
quando o val or da propri edade
EnableSynchronization for i gual a True.
NOTA: Quando o Domni o col ocado em execuo, o E3 Server sempre escol he o
servi dor ati vo por ordem al fabti ca, i ndependente de estar sel eci onado como
pri nci pal ou backup. Este cri tri o de desempate uti l i zado sempre que mai s de um
servi dor se candi data a executar o Domni o. Para mai ores i nformaes, veja o
captul o Hot-Standby.
110 Domnios
Quando o Hot-Standby esti ver l i gado, os segui ntes procedi mentos so necessri os:
Defi ni r um di retri o comparti l hado na rede para conter a cpi a pri nci pal dos
arqui vos do Domni o. Este di retri o deve resi di r em um computador que no faa
parte do Domni o E3
Cri ar em cada servi dor do E3 um di retri o onde ser manti da uma cpi a
atual i zada dos arqui vos do Domni o. O E3Run i r uti l i zar esta cpi a l ocal dos
arqui vos PRJ e LIB
Abri r sempre o arqui vo DOM da rede, uti l i zando o cami nho de rede (por exempl o,
\\server\fol der\Domni o.dom)
Quando uti l i zar o E3 Studi o, sempre edi tar os projetos e bi bl i otecas da cpi a
pri nci pal (na rede). Para apl i car as al teraes, copi e os projetos e bi bl i otecas
al terados para o di retri o l ocal dos servi dores do Domni o. Aps a cpi a, cl i que
em Executar Aplicativo no E3 Studi o para que as al teraes sejam apl i cadas no
processo de tempo de execuo (E3Run)
NOTA: A REDUNDNCIA NO EST DISPONVEL EM MODO DEMO. Quando o modo Hot-
Standby esti ver l i gado, necessri o que todos os servi dores tenham uma cpi a dos
arqui vos do Domni o (.dom, .prj e .l i b) e a mesma rvore de di retri os.
3.9.2 Aba Segurana
Atravs da aba Segurana, possvel determi nar as confi guraes de segurana do
Domni o. Esta opo uti l i zada como padro, caso no seja habi l i tada nenhuma
das opes de permi sso de segurana nos usuri os do projeto. Para acessar tal
i tem, cl i que com o boto di rei to do mouse no cone do E3 Admi n na rea de
Noti fi caes do Wi ndows, sel eci one a opo Domnio - Opes e cl i que na aba
Segurana. A segui nte janel a ser mostrada:
Domnios 111
Aba Segurana
Opes disponveis na aba Segurana
OPO DESCRIO
O usurio no pode alterar a sua senha
I mpede que o usuri o troque a senha
em tempo de execuo.
A senha expira aps ... dias
Determi na o prazo de val i dade da senha
do usuri o. Antes de termi nar o prazo de
val i dade da senha, o si stema avi sa
quantos di as restam para expi rar. Aps a
senha expi rar, o usuri o fi ca
desabi l i tado.
A senha deve conter no mnimo ... caracteres
Determi na a quanti dade mni ma de
caracteres para a senha do usuri o.
A senha deve conter letras e nmeros
Determi na que a senha do usuri o deve
conter l etras e nmeros.
A senha deve conter no mnimo ... nmeros
nmeros na senha.
112 Domnios
OPO DESCRIO
A senha deve conter no mnimo ... letras
l etras na senha.
A senha deve conter letras maisculas e
minsculas
Determi na que a senha do usuri o deve
conter l etras mai scul as e mi nscul as.
Bloquear a conta do usurio aps ... falhas de
login
Determi na a quanti dade mxi ma de
fal has de l ogi n para que a conta do
usuri o seja bl oqueada.
Desbloquear o usurio automaticamente
aps ... minutos
Desbl oquei a a conta do usuri o depoi s
de determi nados mi nutos.
Avisar o usurio nos ltimos ... dias antes da
senha expirar
Determi na a data em que o si stema
comea a envi ar mensagens di ri as ao
usuri o, avi sando-o sobre a data de
expi rao de sua senha. Aps esta data,
se o usuri o no trocar sua senha, el e
ser bl oqueado e somente o
admi ni strador poder desbl oque-l o.
Validar senhas sem diferenciar maisculas e
minsculas
Permi te que as senhas sejam val i dadas
sem di ferenci ar mai scul as de
mi nscul as. Esta opo no
recomendada.
Bloqueio de Senha
A conta de um usuri o pode ser bl oqueada nas segui ntes condi es:
Se a senha expi rar (o tempo de expi rao pode ser atri buto gl obal , de grupo ou
de usuri o)
Se o usuri o di gi tar a senha errada um determi nado nmero de vezes segui das,
i sto , fal has de login
Uma vez bl oqueada, a conta no permi te login. Esta condi o persi ste at que um
admi ni strador desbl oquei e a senha manual mente, ou ento o timeout de bl oquei o
expi re.
3.9.3 Aba Grupos de Viewers
possvel especi fi car, de acordo com o IP do Vi ewer, se este pode se conectar, e
com qual ti po de l i cena (Viewer Full ou Viewer Only).
Com este recurso, possvel bl oquear total mente a conexo ou l i mi tar a
quanti dade e o ti po de l i cenas que so usadas si mul taneamente para um
determi nado grupo de IPs.
Para acessar os grupos de Vi ewers, cl i que com o boto di rei to do mouse no cone
do E3 Admi n na rea de Noti fi caes do Wi ndows, sel eci one a opo Domnio -
Opes, e cl i que na aba Grupos de Viewers. A segui nte janel a mostrada:
Domnios 113
Aba Grupos de Viewers
As opes di sponvei s nesta aba so as segui ntes:
Opes disponveis na aba Grupos de Viewers
OPO DESCRIO
Nome
Li sta os nomes de todos os grupos de
Vi ewers.
Adicionar / Remover
Adi ci ona ou remove grupos de Vi ewers.
Nome do grupo
Habi l i ta a cri ao ou al terao de nomes
de grupos de Vi ewers.
Lista de IPs
Especi fi ca quai s I Ps pertencem ao grupo,
e deste modo comparti l ham os mesmos
l i mi tes de conexo. Quando um Vi ewer
tenta se conectar ao E3 Server, seu I P
comparado aos grupos exi stentes. Aps
determi nado o grupo ao qual pertence,
apl i cada a restri o de l i cenas a este
Vi ewer, confi gurada para aquel e grupo.
114 Domnios
OPO DESCRIO
Adicionar / Editar / Remover
Adi ci ona, edi ta ou remove os nmeros
de I P. Quando um grupo cri ado, el e no
tem nenhum I P especi fi cado (exceto o
pri mei ro grupo, que sempre *.*.*.*,
e no pode ser cri ado pel o usuri o).
Caso o usuri o tente sal var a
confi gurao e al gum grupo tenha uma
l i sta de I Ps vazi a, o si stema emi te um
avi so. Caso o grupo seja manti do assi m,
el e no tem uti l i dade.
Permitir conexes de Viewer Full
Quando sel eci onada, permi te conexes
do ti po Viewer Full para o grupo.
Limitar uso de licenas simultneas
Quando sel eci onada, l i mi ta o uso de
l i cenas do ti po Viewer Full si mul tneas
a um determi nado nmero. Se a opo
anteri or esti ver marcada, mas esta
esti ver desmarcada, o uso de l i cenas
si mul tneas i l i mi tado.
Permitir conexes de Viewer Only
Quando sel eci onada, permi te conexes
do ti po Viewer Only para o grupo.
Limitar uso de licenas simultneas
Quando sel eci onado, l i mi ta o uso de
l i cenas do ti po Viewer Only si mul tneas
a um determi nado nmero. Se a opo
anteri or esti ver marcada, mas esta
esti ver desmarcada, o uso de l i cenas
si mul tneas i l i mi tado.
i mportante notar que estes l i mi tes so apl i cados aps o l i mi te do E3 Server, como
confi gurado no di sposi ti vo de proteo. Por exempl o, se o di sposi ti vo de proteo
possui r dez l i cenas de Vi ewer e o grupo especi fi car ci nco conexes no mxi mo,
apenas estas ci nco so usadas. No entanto, se o di sposi ti vo de proteo possui r
ci nco l i cenas de Vi ewer e o grupo especi fi car dez conexes no mxi mo, uti l i zado
o l i mi te de ci nco conexes do di sposi ti vo. Ou seja, o grupo de Vi ewer tem sempre
uma l i mi tao de l i cenas adi ci onal a ser apl i cada na conexo do Vi ewer.
A confi gurao de Grupos de Vi ewers deve ser fei ta preferenci al mente com o
Domni o parado. Caso seja fei ta com o Domni o em execuo, el a no tem efei to at
que todos os Vi ewers sejam desconectados.
Domnios 115
NOTA: No caso de conexes i denti fi cadas como E3AccessLayer e E3DataAccess, que
por padro no consomem l i cenas do E3 Server, o comportamento dos Grupos de
Vi ewers o segui nte:
Se o Grupo de Vi ewers no permi ti r conexes do ti po Viewer Full nem do ti po
Viewer Only, a conexo negada
Se o Grupo de Vi ewers permi ti r conexes do ti po Viewer Full, a conexo
permi ti da e obedece ao ti po de acesso requi si tado. Por exempl o, para acessos
do ti po Viewer Only a conexo apenas de l ei tura, e para acessos do ti po Viewer
Full a conexo de l ei tura e escri ta
Se o Grupo de Vi ewers permi ti r apenas conexes do ti po Viewer Only, a conexo
permi ti da e somente de l ei tura, mesmo para acessos do ti po Viewer Full
3.9.4 Aba Registro de Eventos
Os eventos di vi dem-se em duas categori as: Eventos Padro do Sistema e Eventos
Manuais.
Eventos Padro do Sistema so os eventos gerados automati camente pel o E3, e que
podem ter o regi stro habi l i tado ou desabi l i tado i ndi vi dual mente:
Login ou Logout de usuri o
Troca de senha de usuri o
Fal ha de login de usuri o
Al terao na base de dados de usuri o
Bl oquei o de conta de usuri o
Inci o ou trmi no do Domni o
Al terao no Domni o (i nseri r, remover, habi l i tar ou desabi l i tar projetos e
bi bl i otecas, al terar a confi gurao do Domni o)
Atual i zao do Domni o (quando o usuri o apl i ca as al teraes fei tas em
projetos, atravs do E3 Studi o)
Troca manual de servi dor Hot-Standby
Eventos Manuais so eventos defi ni dos pel o apl i cati vo. Estes eventos so gerados
em scri pts de usuri o, atravs da chamada do mtodo Application.TrackEvent. Estes
eventos podem ser gerados tanto no Vi ewer quanto no Servi dor (E3Run).
O Vi ewer apenas um gerador de eventos manuai s. Basta chamar o mtodo
Application.TrackEvent, e o evento ser envi ado para o E3 Server.
O di agrama a segui r mostra como os di ferentes processos do E3 geram e tratam os
eventos do si stema:
116 Domnios
Diagrama de processos
Cada E3 Server mantm uma l i sta i nterna dos eventos que devem ser regi strados no
Banco de Dados. Estes eventos podem vi r de trs fontes:
Eventos gerados nos Vi ewers (usando o mtodo Application.TrackEvent)
Eventos gerados i nternamente no E3 Server
Eventos gerados no E3 Server Standby
O E3 Server Standby, de tempos em tempos, envi a a l i sta de eventos para o E3
Server Hot, poi s apenas este tem condi es de gravar eventos no Banco de Dados.
Os eventos so col ocados na fi l a de eventos do Hot, juntamente com os demai s
eventos do si stema, i sto , o servi dor Hot central i za a gravao de eventos.
Se houver uma troca de servi dor, os eventos que no havi am si do gravados so
passados automati camente para o novo servi dor Hot.
O E3Run grava no Banco de Dados os regi stros envi ados pel o E3 Server Hot. O E3
Server i nforma o nome do Servi dor de Dados e da tabel a onde os dados sero
gravados.
Para confi gurar o regi stro de eventos do E3, cl i que com o boto di rei to do mouse
no cone do E3 Admi n na rea de Noti fi cao do Wi ndows, sel eci one a opo
Domnio - Opes, e cl i que na aba Registro de Eventos. A segui nte janel a ser
mostrada:
Domnios 117
Aba Registro de Eventos
Opes disponveis na aba Registro de Eventos
OPO DESCRIO
Registrar os eventos do sistema em uma
tabela no Banco de Dados do aplicativo
Habi l i ta o regi stro de eventos no E3.
Selecionar automaticamente um Banco de
Dados no aplicativo
Habi l i te esta opo para dei xar que o
E3Run escol ha um objeto Servi dor de Dados
para gravar os dados. Se o apl i cati vo
possui apenas um Servi dor de Dados, este
objeto ser usado. Se ti ver mai s de um,
recomendado marcar a opo Usar este
Banco de Dados.
118 Domnios
OPO DESCRIO
Usar este Banco de Dados
Habi l i te esta opo para especi fi car o
Servi dor de Dados onde sero gravados os
eventos. Se o nome do Servi dor de Dados
foi i nformado i ncorretamente, os eventos
fi caro armazenados na fi l a de eventos do
E3 Server (em memri a), at que seja
i ndi cado um Servi dor de Dados vl i do.
Nome da tabela
I ndi que o nome da tabel a onde sero
gravados os eventos. A tabel a i nformada
ser cri ada automati camente pel o E3Run, e
ter os segui ntes campos:
E3TimeStamp (Data/Hora): O campo
E3TimeStamp confi gurado pel o E3Run e
contm a data e hora em que o E3Run
consegui u envi ar o evento para o Banco
de Dados
EventTime (Data/Hora): O campo
EventTime a data e hora em que
real mente ocorreu o evento, a data e
hora atual do servi dor (Hot ou Standby)
quando o evento foi cri ado, ou ento o
parmetro dtTimeStamp especi fi cado
para o mtodo Application.TrackEvent
EventMessage (String): mensagem do
evento (mxi mo de 200 caracteres)
EventComment (String): comentri o sobre
o evento (mxi mo de 200 caracteres)
Marque abaixo os eventos que devem ser
registrados
Li sta os eventos di sponvei s no si stema,
para serem regi strados.
Se o E3Run ti ver que escol her entre vri os Servi dores de Dados, normal mente ser
uti l i zado o pri mei ro Banco de Dados ati vado na execuo do Domni o. Se durante a
execuo do Domni o, o usuri o desabi l i tar o projeto que contm o Servi dor de
Dados que estava sendo usado para gravar os eventos, o E3Run automati camente
escol her outro Servi dor de Dados que esteja di sponvel no apl i cati vo, e
conti nuar com este Servi dor de Dados at que outro Servi dor de Dados anteri or
seja reati vado. Isto i mpl i ca que, se houver mai s de um Servi dor de Dados no
projeto, possvel que al guns eventos sejam gravados em um Servi dor de Dados e
outros eventos em outro Servi dor de Dados (por i sto, recomendado i ndi car um
Servi dor de Dados especfi co, quando houver mai s de um Servi dor de Dados no
projeto).
Quando um evento sel eci onado na l i sta e a tecl a F2 pressi onada, abre-se uma
cai xa de di l ogo para edi o do evento. A segui nte janel a mostrada:
Domnios 119
Edio de eventos
Desmarque a opo Usar mensagem padro para al terar a mensagem do evento.
Cl i que em para i nseri r uma macro dentro da mensagem. Apenas as macros
permi ti das para o evento sero mostradas.
Visualizao da macro disponvel para o evento
As macros sempre tm o formato %MACRO%. As segui ntes macros podem ser
usadas:
%%: Insere um si nal de % na mensagem
120 Domnios
%USER%: Insere o nome do usuri o que gerou o evento (ou "Anni mo", se no
houver nenhum usuri o l ogado)
%MACHINE%: Insere o nome do computador onde o evento foi gerado
%SESSION%: Insere o nome do programa onde o usuri o estava l ogado (Vi ewer,
Studi o ou E3 Server)
%CAUSE%: Informao adi ci onal sobre o evento
Por exempl o, se a mensagem do evento Falha de Login for al terada para:
"Falhou login do usurio %USER% no computador %MACHINE% (usando
um %SESSION%): %CAUSE%"
Se o usuri o Admi n escrever uma senha errada enquanto fi zer l ogi n no Vi ewer que
est rodando na mqui na CLIENT004, ser gerado o segui nte evento:
"Falhou login do usurio Admin no computador CLIENT004 (usando
um Viewer): login ou senha incorretos"
Os eventos padro do si stema so descri tos nas sees segui ntes.
3.9.4.1 Login de Usurio
Usurio %User% logou no %SESSION% na mquina %MACHINE%
Gerado sempre que ocorrer um login bem sucedi do de um usuri o no E3 Studi o ou
no Vi ewer, onde:
%USER% contm o nome de login do usuri o
%SESSION% contm "Vi ewer" ou "Studi o"
%MACHINE% contm o nome do computador onde o usuri o est l ogado
3.9.4.2 Logout de Usurio
Usurio %User% terminou a sesso de uso de %SESSION% na mquina %MACHINE%
Gerado sempre que ocorrer o logout de um usuri o no E3 Studi o ou no Vi ewer (ou
quando o programa fechado sem logout. Neste caso, o logout automti co), onde:
%USER% contm o nome de login do usuri o
%MACHINE% contm o nome do computador onde o usuri o estava l ogado
Domnios 121
3.9.4.3 Troca de Senha
A senha do usurio %USER% foi alterada
Gerado sempre que a senha de um usuri o for trocada (chamando o mtodo
ChangePassword no Vi ewer), onde:
%USER% contm o nome de login do usuri o 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 fal har o login de um usuri o no Vi ewer ou no E3 Studi o, onde:
%USER% contm o nome de login i nformado
%MACHINE% contm o nome do computador onde o usuri o tentou l ogar
%CAUSE% pode ser login ou senha i ncorretos, conta desabi l i tada, conta
bl oqueada, senha expi rada ou erro 0xnnnnnnn
3.9.4.5 Base de Usurios Alterada
Usurio %USER% alterou a base de usurios
Gerado sempre que a base de usuri os for al terada (normal mente atravs da
opo Arquivos - Usurio do E3 Studi o), onde:
%USER% contm o nome de login do usuri o que edi tou a base de usuri os (ou
"Anni mo" se no havi a nenhum usuri o l ogado)
3.9.4.6 Conta Bloqueada
A conta do usurio %USER% foi bloqueada
Gerado sempre que a conta de um usuri o bl oqueada por excesso de logins
errados, onde:
%USER% contm o nome de login do usuri o que teve a conta bl oqueada
3.9.4.7 Domnio Iniciado
Domnio iniciado pelo usurio %USER% no %SESSION% na mquina %MACHINE%
Gerado sempre que o Domni o i ni ci ado (col ocado em execuo), onde:
%USER% contm o nome de login do usuri o que col ocou o Domni o em execuo
(ou "Anni mo" se no foi pedi da autenti cao quando o Domni o foi executado)
122 Domnios
%SESSION% contm "Studi o" ou "E3 Server" (menu da rea de Noti fi caes do
Wi ndows)
%MACHINE% contm o nome do computador onde foi gerado o comando para
executar o Domni o
3.9.4.8 Domnio Finalizado
Domnio finalizado pelo usurio %USER% no %SESSION% na mquina %MACHINE%
Gerado sempre que o Domni o parado, onde:
%USER% contm o nome de login do usuri o que parou o Domni o (ou "Anni mo",
se no foi pedi da autenti cao quando o Domni o foi parado)
%SESSION% contm "Studi o" ou "E3 Server" (menu da rea de Noti fi caes do
Wi ndows)
%MACHINE% contm o nome do computador onde foi gerado o comando de parar
o Domni o
3.9.4.9 Domnio Atualizado
Domnio atualizado pelo usurio %USER% no %SESSION% na mquina %MACHINE%
Gerado sempre que o Domni o atual i zado ao cl i car em no E3 Studi o, i sto ,
quando so apl i cadas no E3Run as al teraes fei tas em arqui vos PRJ e LIB, onde:
%USER% contm o nome de login do usuri o l ogado no E3 Studi o (ou "Anni mo",
se no h nenhum usuri o l ogado)
%SESSION% contm "Studi o"
%MACHINE% contm o nome do computador onde o E3 Studi o estava rodando
3.9.4.10 Domnio Modificado
Domnio modificado pelo usurio %USER% no %SESSION% na mquina %MACHINE%:
%CAUSE%
Gerado sempre que o arqui vo do Domni o (.dom) modi fi cado, onde:
%USER% contm o nome do usuri o que al terou o Domni o
%SESSION% contm "Studi o" ou "E3 Server"
%MACHINE% contm o nome do computador onde foi gerado o comando de
modi fi car o Domni o
%CAUSE% pode ser:
Apl i cadas al teraes na janel a do computador de edi o do Domni o
Domnios 123
Adi ci onado projeto "nomedoprojeto" (habi l i tado)
Adi ci onado projeto "nomedoprojeto" (desabi l i tado)
Removi do projeto "nomedoprojeto"
Desabi l i tado projeto "nomedoprojeto"
3.9.4.11 Troca Manual de Servidores
Servidor reserva ativado pelo usurio '%USER%' no '%SESSION%' na mquina '%
MACHINE%'
Gerado sempre que forada a ati vao do servi dor de backup de um Domni o,
atravs da opo Servidor - Ativar do menu do E3 Server, onde:
%USER% contm o nome de login do usuri o que ati vou o servi dor de backup (ou
"Anni mo" se no foi pedi da autenti cao quando o servi dor foi ati vado)
%SESSION% contm "E3 Server" (menu da rea de Noti fi caes do Wi ndows)
%MACHINE% contm o nome do computador onde foi gerado o comando para
ati var o servi dor de backup
3.9.5 Aba Projetos
possvel adi ci onar, remover ou edi tar os projetos (arqui vos .prj) de um Domni o.
Para acessar este i tem, cl i que com o boto di rei to do mouse no cone do E3 Admi n
na rea de Noti fi caes do Wi ndows, sel eci one a opo Domnio - Opes e cl i que
na aba Projetos. A segui nte janel a ser mostrada:
124 Domnios
Aba Projetos
Opes disponveis na aba Projetos
OPO DESCRIO
Nome
Esta opo l i sta os nomes dos projetos
no si stema.
Adicionar / Remover
Atravs destas opes, pode-se remover
ou adi ci onar projetos no si stema. Para
adi ci onar um projeto, basta cl i car em
Adicionar e especi fi car o campo Nome do
projeto. Para remover um projeto, basta
sel eci on-l o e cl i car em Remover. O
arqui vo PRJ no apagado do di sco,
apenas removi do da l i sta de projetos do
Domni o.
Domnios 125
OPO DESCRIO
Nome do projeto
Di gi te o nome do arqui vo do projeto, que
deve ser um cami nho rel ati vo ao
di retri o do Domni o (o di retri o que
contm o arqui vo .dom). Exempl os:
Tel as.prj, Hi dro\Estacao1.prj
Em manuteno (execuo desabilitada)
Esta opo permi te desabi l i tar a
execuo do projeto, evi tando a
ocorrnci a de erros quando o Domni o
executado. Quando a opo habi l i tada,
o cone i ndi ca que o projeto no ser
uti l i zado. Os projetos com o cone esto
habi l i tados e sero executados.
3.9.6 Aba Servidores
possvel adi ci onar, remover ou edi tar os servi dores de um Domni o. Use a l i sta da
esquerda para sel eci onar um ou mai s servi dores a al terar. A l i sta i ndi ca tambm
se o servi dor est habi l i tado , em modo Manuteno ou desabi l i tado . Para
acessar este i tem, cl i que com o boto di rei to do mouse no cone do E3 Admi n na
rea de Noti fi caes do Wi ndows, sel eci one a opo Domnio - Opes e cl i que na
aba Servidores. A segui nte janel a ser mostrada:
126 Domnios
Aba Servidores
As opes di sponvei s neste i tem so as segui ntes:
Opes disponveis na aba Servidores
OPO DESCRIO
Nome
Li sta com os nomes dos servi dores no
si stema.
Adicionar e Remover
ou adi ci onar servi dores no si stema. Para
adi ci onar um servi dor em rede, basta
cl i car em Adicionar e especi fi car os
campos Nome do servidor e Identificao do
servidor na rede; para adi ci onar um
servi dor l ocal , basta especi fi car o i tem
Caminho local de acesso aos arquivos de
Domnio. Para remover um projeto, basta
sel eci on-l o na l i sta e cl i car em Remover.
Nome do servidor
Determi na o nome do servi dor. Este nome
defi ni do pel o usuri o.
Domnios 127
OPO DESCRIO
Identificao do servidor na rede
Di gi te o nome do servi dor na rede. Deve
ser o nome da mqui na com ou sem as
barras dupl as i nverti das no i nci o (por
exempl o, \\server ou server).
Pasta raiz dos arquivos do Domnio
I ndi ca a pasta onde esto l ocal i zados os
arqui vos do Domni o (arqui vos .prj, .l i b,
etc.) do servi dor sel eci onado. A opo No
especificar (utilizar a pasta do arquivo .DOM)
o padro, e i ndi ca que os arqui vos
esto na mesma pasta do arqui vo de
Domni o (.dom). Caso seja sel eci onada a
opo Utilizar a seguinte pasta local, o
cami nho di gi tado no campo especfi co
deve conter apenas a pasta, sem o nome
nem a extenso do arqui vo de Domni o
(.dom).
Em manuteno (execuo desabilitada)
Esta opo permi te desabi l i tar o servi dor
e no uti l i z-l o na execuo do Domni o.
Quando a opo habi l i tada, o cone
i ndi ca que o servi dor no ser uti l i zado.
Do contrri o, o cone i ndi ca que o
servi dor poder ser uti l i zado.
3.9.7 Aba Domnios Remotos
Permi te adi ci onar, remover ou edi tar os Domni os Remotos. Use a l i sta da esquerda
para sel eci onar um ou mai s Domni os Remotos a al terar. Para acessar tal i tem,
cl i que com o boto di rei to do mouse no cone do E3 Admi n na rea de Noti fi caes
do Wi ndows, sel eci one a opo Domnio - Opes e cl i que na aba Domnios
Remotos. A segui nte janel a ser mostrada:
128 Domnios
Aba Domnios Remotos
Opes disponveis na aba Domnios Remotos
OPO DESCRIO
Nome
Esta opo l i sta os nomes dos Domni os
Remotos no si stema.
Adicionar / Remover
ou adi ci onar Domni os Remotos no
si stema. Para adi ci onar um Domni o
Remoto em rede, basta cl i car em
Adicionar e especi fi car os campos Nome e
Arquivo de Domnio. Para remover um
Domni o, basta sel eci on-l o na l i sta e
cl i car em Remover.
Nome do Domnio
Determi na o nome do Domni o Remoto.
Este nome defi ni do pel o usuri o.
Arquivo de Domnio
Determi na o nome ou o cami nho na rede
onde est o arqui vo .dom do Domni o
Remoto.
Domnios 129
OPO DESCRIO
Servidor Principal
I denti fi ca o servi dor pri nci pal na rede.
Servidor de Backup
Quando habi l i tado, i denti fi ca o servi dor
de backup na rede.
Usurio no Domnio
Permi te reconhecer um usuri o com
senha para cada Domni o Remoto. As
opes di sponvei s so: No especificar
(annimo), e Utilizar a seguinte conta. Ao
sel eci onar a segunda opo, os doi s
campos a segui r so habi l i tados.
Usurio
I denti fi ca o usuri o.
Senha
Permi te a conexo ao Domni o atravs de
senha.
possvel que uma confi gurao de Domni o Remoto possi bi l i te a conexo ao
prpri o Domni o l ocal . A i sso se d o nome de Alias local ou conexo Loopback.
Este alias cri ado segundo a confi gurao normal de Domni os Remotos. Basta que
o nome dos servi dores (pri nci pal ou backup) seja localhost* ou o mesmo da
mqui na onde o Domni o est rodando para que tudo funci one l ocal mente. Neste
caso, para que a confi gurao funci one no E3 Studi o, no campo Arquivo de
Domnio, basta col ocar di retamente o cami nho l ocal do arqui vo DOM (por
exempl o, c:\cami nho\arqui vo.dom).
NOTAS:
A mudana dos aliases l ocai s com o Domni o rodando NO suportada. O que
acontecer que, se o Domni o esti ver rodando, Links j resol vi dos como l ocai s
conti nuaro sempre l ocai s, mesmo que o alias seja reconfi gurado para conectar
em uma mqui na remota real mente. Para contornar i sso, basta rei ni ci ar o
Domni o
As conexes do ti po loopback no aparecero na janel a Licenas (ou Estatsticas) do
E3 Admi n e nem i ro necessi tar de l i cena de Domni os Remotos para funci onar
* Para que o nome localhost funci one, necessri o que el e esteja confi gurado
para apontar para o I P 127.0.0.1 (que a confi gurao padro do Wi ndows)
Para mai ores i nformaes sobre as confi guraes da aba Domnios Remotos, veja
o i tem Configurao da Conexo
3.9.8 Aba Propriedades
Permi te control ar confi guraes di versas do Domni o. Para acessar este i tem,
cl i que com o boto di rei to do mouse no cone do E3 Admi n na rea de Noti fi caes
do Wi ndows, sel eci one a opo Domnio - Opes e cl i que na aba Propriedades. A
segui nte janel a ser mostrada:
130 Domnios
Aba Propriedades
As opes di sponvei s nesta aba esto descri tas na tabel a a segui r.
OPO DESCRIO
Pool Habilitado
Habi l i ta ou desabi l i ta o pool de
processos I OServer. NOTA: Certi fi que-se
que os Dri vers em uso na apl i cao
suportam o recurso de pool de processos
(os Dri vers devem ter si do compi l ados
com o IOKit verso 2.0.6 ou superi or). Os
Dri vers que no suportam este recurso
devem ser confi gurados com a
propri edade DisableIOServerPool em
Verdadei ro. O val or padro desta opo
Fal so.
Domnios 131
OPO DESCRIO
Drivers por Processo
Defi ne o nmero mxi mo de Dri vers que
i ro rodar em cada processo do I OServer.
NOTA: Este l i mi te poder ser
ul trapassado caso o nmero de
processos do pool chegue ao mxi mo
confi gurado na opo Nmero Mximo de
Processos. O val or padro desta opo 0
(zero).
Nmero Mximo de Processos
Defi ne o nmero mxi mo de processos
I OServer que sero cri ados pel o pool. O
val or 0 (zero, padro) nesta opo
permi te um nmero i l i mi tado de
processos.
Esta confi gurao pode ser al terada com o Domni o em execuo, porm somente
afetar os Dri vers i ni ci ados aps a al terao, ou nas si tuaes em que o Domni o
atual i zado:
Ao cl i car em no E3 Studi o
Ao sel eci onar a opo Domnio - Atualizar, no menu do E3 Admi n na rea de
Noti fi caes do Wi ndows
Ao gerar um evento que force o E3Run a receber a confi gurao do Domni o
NOTA: Para mai ores i nformaes, veja o tpi co Pool de Processos IOServer no captul o
Drivers.
3.10 Outras Opes da rea de Notificao
Al m das opes l i stadas na seo anteri or, exi stem outras confi guraes
acessadas atravs do menu do E3 Admi n na rea de Noti fi caes do Wi ndows.
3.10.1 Atalhos
Esta opo permi te executar apl i cati vos presentes na i nstal ao do E3 di retamente
pel o menu contextual do cone do E3 Admi n, na rea de Noti fi cao do Wi ndows.
Os segui ntes apl i cati vos podem ser executados:
Log Viewer
E3 Studio
E3 Tweak
E3 Viewer
132 Domnios
O i tem Log Viewer abre o apl i cati vo Elipse Event Log Viewer j com o arqui vo
correspondente sesso ati va de l ogs do E3. Para mai ores i nformaes sobre este
apl i cati vo, consul te o Manual do Usurio do Elipse Event Log, di sponvel no menu
Iniciar - Programas - Elipse Software - Elipse Event Log.
Se j h um Domni o rodando l ocal mente, o i tem E3 Viewer deste menu abre um
Vi ewer para o Domni o l ocal . Do contrri o, ou se a tecl a SHIFT esti ver pressi onada,
abre-se a janel a i ni ci al do Vi ewer, onde possvel escol her o servi dor e outras
opes, como descri to no tpi co E3 Viewer e E3 WebViewer - Execuo do E3
Viewer - Execuo Atrves do Menu Iniciar.
3.10.2 Licenas
possvel vi sual i zar as di versas l i cenas di sponvei s atravs do E3 Admi n. Para
i sto, cl i que com o boto di rei to do mouse no cone do E3 Admi n na rea de
Noti fi caes do Wi ndows e sel eci one a opo Licenas. A segui nte janel a ser
mostrada:
Domnios 133
Janela E3 Admin - Licenas
As opes di sponvei s nesta janel a so as segui ntes:
Opes disponveis na janela E3 Admin - Licenas
OPO DESCRIO
Nmero da licena
I nforma o nmero da l i cena (di sposi ti vo
de proteo): um nmero hexadeci mal
de oi to dgi tos com prefi xo "HL", se o
di sposi ti vo for uma hardkey; ou um
nmero hexadeci mal de dezessei s
dgi tos com prefi xo "SL", se o di sposi ti vo
for uma softkey. Se o di sposi ti vo de
proteo no foi detectado, o nmero
ser preenchi do com zeros.
E3 Server
I ndi ca o ti po de E3 Server.
E3 Studio
I ndi ca o nmero de l i cenas di sponvei s
e em uso do E3 Studi o.
134 Domnios
OPO DESCRIO
E3 Viewer
e em uso do E3 Vi ewer.
E3 Viewer Only
e em uso do E3 Vi ewer no modo Somente
Leitura.
Domnio Remoto (Servidor)
e em uso do Domni o Remoto (Servi dor).
Domnio Remoto (Cliente)
e em uso do Domni o Remoto (Cl i ente).
Pontos E/S
I ndi ca o nmero de pontos de
comuni cao.
Tags do Storage
I ndi ca o nmero de Tags do Storage.
Drivers
I ndi ca o nmero de Dri vers di sponvei s e
em uso.
Servidor OPC
e em uso do Servi dor OPC.
Tempo mximo de execuo
I ndi ca o tempo mxi mo permi ti do de
execuo de um apl i cati vo.
Para mai ores i nformaes sobre as l i mi taes do modo Demo do E3, veja o tpi co
Limitaes do Modo Demonstrao.
NOTA: Os usuri os l ogados e i denti fi cados como E3DataAccess e E3AccessLayer, na
col una Programa da l i sta Usurios Logados, no consomem l i cenas de Vi ewer de um
E3 Server.
3.10.3 Estatsticas
A janel a E3 Admin - Estatsticas de Comunicao mostra os dados em tempo real
sobre o trfego de i nformaes na rede. A l i sta atual i zada automati camente a
cada segundo. Para i sto, cl i que com o boto di rei to do mouse no cone do E3 Admi n
na rea de Noti fi caes do Wi ndows e sel eci one a opo Estatsticas.
Janela E3 Admin - Estatsticas de Comunicao
Domnios 135
Opes disponveis na janela E3 Admin - Estatsticas de Comunicao
OPO DESCRIO
Programa
Mostra o nome da apl i cao conectada
ao E3 Server.
Computador
Mostra o nome da mqui na conectada
ao E3 Server.
Dados enviados
Mostra a quanti dade de dados envi ados.
Compresso no envio
Mostra a percentagem de compresso no
envi o.
Pacotes enviados
Mostra a quanti dade de pacotes
envi ados.
Dados recebidos
Mostra a quanti dade de dados
recebi dos.
Compresso no recebimento
Mostra a percentagem de compresso no
recebi mento.
Pacotes recebidos
Mostra a quanti dade de pacotes
recebi dos.
Conectado desde
Mostra a data e hora em que o programa
i ni ci ou a conexo.
3.10.4 Monitor
A janel a E3 Admin - Monitor mostra i nformaes em tempo real sobre o estado dos
servi dores do Domni o. Para i sto, cl i que com o boto di rei to do mouse no cone do
E3 Admi n na rea de Noti fi caes do Wi ndows e sel eci one a opo Monitor.
Janela E3 Admin - Monitor
136 Domnios
Opes disponveis na janela E3 Admin - Monitor
OPO DESCRIO
Domnio atual
Nome do Domni o ati vo.
Endereos de ping
Li sta com os endereos dos servi dores de
ping.
Nome
Nome do servi dor.
Endereo
Endereo de rede do servi dor.
Ping
Mostra o estado do ping de rede com este
servi dor.
Relgio
Mostra a hora l ocal do servi dor.
Estado
Mostra o estado do Domni o no servi dor
(Parado ou Rodando).
Conexo
Mostra o estado da conexo DCOM com o
servi dor.
Funo
Mostra uma l i sta de funes reportadas
pel o servi dor:
Ativo: Este o servi dor ati vo do Domni o
Reserva: Este o servi dor standby do
Domni o
Falha(n): Servi dor possui fal has l ocai s
reportadas
Prioridade: O servi dor requi si tou
pri ori dade para rodar o Domni o. Este
i ndi cador faz com que o servi dor ati vo
passe para o modo Standby
Candidato: O servi dor candi dato a rodar
o Domni o
E/S: O servi dor possui I OServers ati vos
3.10.5 Inicializao
Esta opo permi te control ar o Domni o a ser i ni ci ado automati camente. O
Domni o confi gurado s ser executado se o E3 Server no esti ver em modo Demo.
Para i sto, cl i que com o boto di rei to do mouse no cone do E3 Admi n na rea de
Noti fi caes do Wi ndows e sel eci one a opo Inicializao. A segui nte janel a ser
mostrada:
Domnios 137
Janela E3 Admin - Inicializao
Opes disponveis na janela E3 Admin - Inicializao
OPO DESCRIO
O Domnio carregado
Ao i ni ci ar, executa automati camente o
Domni o previ amente carregado.
O Domnio configurado
Ao i ni ci ar, executa automati camente o
Domni o confi gurado pel o usuri o.
Nenhum Domnio
No i ni ci a nenhum Domni o.
3.10.6 Impressora
Esta opo mostra a l i sta das i mpressoras encontradas l ocal ou remotamente, e
permi te que o usuri o escol ha uma para ser usada pel o E3 Server. Para i sto, cl i que
com o boto di rei to do mouse no cone do E3 Admi n na rea de Noti fi caes do
Wi ndows e sel eci one a opo Impressora. A segui nte janel a ser mostrada:
Janela E3 Admin - Impressora
138 Domnios
Opes disponveis na janela E3 Admin - Impressora
OPO DESCRIO
Nome da impressora
Li sta o nome das i mpressoras
di sponvei s.
Padro
Permi te sel eci onar esta i mpressora
como padro.
Configurar
Abre a janel a de propri edades da
i mpressora sel eci onada.
Procurar
Permi te escol her outra i mpressora na
rede e estabel ecer uma conexo.
3.10.7 Sobre o E3 Admin
Esta opo mostra a verso do E3 Admi n.
3.10.8 Iniciar ou Parar o E3 Server
Esta opo para ou i ni ci a o E3 Server. Ao ser aci onada a opo Parar E3 Server,
pedi da a confi rmao da operao. Se confi rmada, o Domni o parado e fechado, e
so desconectados todos os E3 Studi os e Vi ewers (caso exi stam). O usuri o ser
noti fi cado que i sto i ndi sponi bi l i zar o uso de E3 Studi os remotos e do Hot-Standby.
Quando o E3 Server esti ver parado, el e pode ser rei ni ci ado pel a opo Iniciar E3
Server.
3.10.9 Fechar o E3 Admin
O E3 Admi n pode ser fechado sem preci sar fechar o E3 Server, atravs da opo
Fechar E3 Admin. Quando i sso acontece, o E3 Server conti nua rodando, mas
nenhum cone aparece na rea de Noti fi caes do Wi ndows. Neste caso, quando o
E3 Admi n no est aberto, as mensagens de erro aparecem como cai xas de
mensagens a todos os usuri os l ogados (e ati vos) na mqui na rodando o E3 Server.
A qual quer momento, o E3 Admi n pode ser rei ni ci ado para control ar o E3 Server em
execuo, bastando para i sto i ni ci ar o E3 Admi n sem nenhum parmetro. O
i nstal ador tambm cri a um atal ho para abri r o E3 Admi n di retamente.
3.11 Domnios Remotos
A confi gurao de Domni os Remotos defi ne que haver comuni cao entre
di ferentes servi dores e Vi ewers, onde uma apl i cao ser desti nada a fornecer
dados, e a outra a receb-l os. O Domni o que fornece dados a outro chamado de
Domnio Servidor; j o Domni o que uti l i za estes dados chamado de Domnio
Cliente. A confi gurao de um Domni o como Domni o Cl i ente no i mpede que el e
seja ao mesmo tempo um Domni o Servi dor, e vi ce-versa. Domni os Remotos no
esto di sponvei s em modo Demo.
Domnios 139
3.11.1 Configurao da Conexo
A confi gurao das conexes com outros Domni os do E3 deve ser fei ta no Domni o
Cl i ente, cl i cando com o boto di rei to do mouse no cone do E3 Admi n na rea de
Noti fi caes do Wi ndows, sel eci onando a opo Domnios - Opes, e ento
sel eci onando a aba Domnios Remotos.
Aba Domnios Remotos
Neste caso, o Domni o referenci ado pel a confi gurao o Domni o Servi dor.
possvel tambm que os Domni os se referenci em entre si , sendo ao mesmo tempo
servi dores e cl i entes de Domni os Remotos. Para confi gurar o uso de um Domni o
Remoto, si ga estes procedi mentos:
1. Informe um apel i do para o Domni o Remoto no campo Nome do Domnio. Este
campo no sensvel a mai scul as ou mi nscul as. Este nome ser usado na
apl i cao para referenci ar os objetos a serem acessados no Domni o Remoto.
2. Especi fi que o cami nho do arqui vo .dom do Domni o Remoto. Este cami nho deve
ser um comparti l hamento na rede que permi ta acessar este arqui vo .dom.
140 Domnios
3. Informe o nome do servi dor pri nci pal , que deve ser o servi dor contendo o
Domni o Remoto especi fi cado no cami nho do arqui vo .dom. Esta confi gurao
uti l i zada para encontrar os objetos do Domni o Remoto em tempo de
execuo.
O i tem Servidores e Opes de Conexo contm a opo Avanado, que permi te
real i zar confi guraes especfi cas da conexo entre os Domni os, atravs da janel a
mostrada na fi gura a segui r.
Opes de conexo
As opes desta janel a so descri tas na tabel a a segui r.
Opes avanadas de conexo
OPO DESCRIO
Tempo limite de conexo (ms)
Esta opo control a o tempo mxi mo que
o Domni o Remoto Cl i ente espera para
estabel ecer uma conexo REC com o E3
Server do Domni o Servi dor. Sua
fi nal i dade a mesma da chave
ConnectionTimeout, confi gurvel pel o E3
Tweak. O val or padro desta opo 2000
ms.
Domnios 141
OPO DESCRIO
Verificar PING
Esta opo permi te que, atravs de um
pedi do de echo do protocol o I CMP, o
Domni o Remoto veri fi que se o Servi dor
responde dentro de um tempo l i mi te
(timeout). Se no houver resposta, por
qual quer moti vo, consi dera-se que o
computador est fora da rede, ou
desl i gado. Essa veri fi cao, se
habi l i tada, ocorre antes da conexo
(evi tando a tentati va de conectar em um
computador i ndi sponvel ) e enquanto a
conexo esti ver ati va (forando a
desconexo i medi ata).
Tempo limite de PING (ms)
O val or, em mi l i ssegundos, para a
veri fi cao do ping. O val or padro desta
opo 2000 ms.
Utilizar heartbeat na conexo
Esta opo permi te que, atravs de um
mecani smo do protocol o REC, o Domni o
Remoto Cl i ente veri fi que se o Servi dor
est mantendo a conexo ati va,
esperando que sejam envi adas
mensagens de heartbeat peri di cas,
mesmo que no haja nenhuma outra
comuni cao a ser fei ta. Se for excedi do
o dobro do tempo de heartbeat
confi gurado, sem que o Cl i ente receba
uma mensagem qual quer do computador
Servi dor, consi dera-se que o Servi dor
fal hou ou est fora da rede, sendo
forada uma desconexo i medi ata.
Perodo de heartbeat (ms)
O val or, em mi l i ssegundos, do perodo
de heartbeat. O val or padro desta opo
2000 ms.
142 Domnios
OPO DESCRIO
Utilizar criao assncrona de links
Se esta opo for marcada, os Links so
cri ados em paral el o entre os di versos
Domni os e o resul tado da operao vem
assi ncronamente, medi da que cada
Servi dor responder. A vantagem desta
opo no trancar o tratamento de Links
geral do E3 Server. Apenas operaes
daquel e mesmo Domni o podem fi car
trancadas, caso a cri ao de Links demore
mui to (o que pode ocorrer em redes
l entas). NOTA: Esta opo no est
di sponvel para verses anteri ores 3.2,
e as apl i caes desenvol vi das em
verses anteri ores fal haro com o cdi go
de erro 8004F108 (verso i ncompatvel do
REC). O val or padro desta opo
desmarcada, que corresponde ao
comportamento das verses anteri ores
verso 3.2.
NOTA: Desmarcar si mul taneamente as opes Verificar PING e Utilizar heartbeat na
conexo torna a deteco de queda da conexo extremamente l enta, caso o Servi dor
fal he. Recomenda-se que as duas opes estejam sempre marcadas.
No E3 Studi o, o cami nho compl eto do comparti l hamento usado para que seja
possvel determi nar os objetos exi stentes no Domni o Remoto. O nome do arqui vo
.dom (sem o cami nho) usado para veri fi car se a conexo remota est sendo fei ta
com o Domni o correto, em tempo de execuo. Assi m, se o nome do Domni o
carregado no E3 Server remoto no for o correto, a conexo no ser compl etada e
os objetos remotos no fi caro acessvei s.
Outra possi bi l i dade manter uma cpi a do Domni o Remoto na mqui na Cl i ente, e
col ocar o cami nho da cpi a no campo Arquivo de Domnio. Dessa forma, o E3
Studi o vai uti l i zar a cpi a l ocal para determi nar quai s objetos exi stem, permi ti ndo
o trabal ho offline. A cpi a deve obri gatori amente ter o mesmo nome do Domni o
Remoto para que a conexo funci one, no sendo necessri o possui r a mesma
hi erarqui a de di retri os.
Al m di sso, para que a conexo entre os Domni os possa ocorrer, todos os E3
Servers envol vi dos devero rodar a mesma verso do E3. No possvel , por
exempl o, conectar-se a um Domni o que esteja rodando a verso 2.5 do E3.
Para que um E3 Server acei te receber conexes de outros Domni os (i sto , para que
el e seja um servi dor de Domni os Remotos), no necessri a nenhuma
confi gurao especfi ca.
Aps a correta confi gurao destes i tens, necessri o apenas rodar os E3 Servers
Domnios 143
para que as conexes remotas sejam estabel eci das.
NOTA: Para mai ores i nformaes sobre a confi gurao de Domni os Remotos, veja o
i tem Configuraes de Domnio - Domnios Remotos.
3.11.2 Licenas
Tanto o E3 Server rodando o Domni o Cl i ente, quanto o que roda o Domni o
Servi dor, devem ter l i cenas especfi cas para Domni os Remotos.
Quando essa l i cena exi ste, o E3 Server Servi dor passa a acei tar um nmero
i l i mi tado de conexes externas de outros Domni os. Da mesma forma, no caso do
E3 Server Cl i ente, ser possvel estabel ecer um nmero i l i mi tado de conexes. Para
mai ores i nformaes sobre as l i mi taes do modo Demo do E3, veja o tpi co
Limitaes do Modo Demonstrao.
3.11.3 Sintaxe dos Links
Com a confi gurao de Domni os Remotos, o Domni o Cl i ente poder acessar
objetos do Domni o Servi dor de duas manei ras: atravs de scri pts, uti l i zando o
mtodo Application.GetObject; ou atravs de Links, ou seja, de qual quer
funci onal i dade que cri e uma conexo com outro objeto (expresses de eventos de
usuri o, propri edades do ti po Objeto de ElipseX, fontes de Associ aes, de Al armes
ou de campos de Hi stri cos e Storages, entre outros). Os objetos acessados desta
forma podem tanto ser objetos do Vi ewer quanto do Servi dor.
O acesso aos objetos de outro Domni o fei to atravs do apel i do (Nome de
Domni o), que deve preceder o cami nho compl eto de cada objeto, separado por
doi s pontos. Ou seja, para que as fontes de Links ou o comando
Application.GetObject referenci em outro Domni o, deve-se usar a si ntaxe
DOMINIO:CAMINHO, onde DOMINIO o apel i do dado quel a conexo com o
Domni o Remoto, e CAMINHO o cami nho compl eto de um objeto ou propri edade
daquel e Domni o. No caso de Links, as fontes podem i ncl ui r expresses com
refernci as a vri os objetos, podendo haver combi naes entre objetos l ocai s e de
Domni os Remotos. Por exempl o, Driver1.Tag1 + Remoto:Driver2.Tag1 * 2.
O nome do Domni o Remoto tambm pode necessi tar de col chetes, fi cando
[DOMINIO]:CAMINHO. Neste caso, apl i cam-se as mesmas regras de nomes de
objetos. Necessi ta de col chetes o nome do Domni o que:
Comea com um caractere que no seja uma l etra (sem acentos nem "")
Possui um caractere qual quer que no seja uma l etra (sem acentos nem ""), um
al gari smo (0-9) ou o caractere de subl i nhado
144 Domnios
3.11.4 Permisses de Usurio
Assi m como ocorre com o Vi ewer, o acesso aos objetos de um Domni o Remoto
pode ser l i mi tado ao modo Somente Leitura. Quando i sso ocorre, so apl i cados os
mesmo ti pos de l i mi taes de acesso que se apl i cam ao Vi ewer Onl y. Porm,
di ferente do Vi ewer, nesse caso o control e fei to apenas por usuri o e no por IP
ou por l i cena. Para i sso, usa-se a confi gurao de usuri os na permi sso Acesso
remoto de escrita ao Domnio, dentro do i tem de segurana Domnio.
Permisses de usurio
Com i sso, pode ser necessri o que a conexo com o Domni o Remoto especi fi que
um determi nado usuri o para poder ter acesso compl eto aos objetos do Domni o.
Esse usuri o dever ser especi fi cado no campo Usurio no Domni o atravs da
Domnios 145
opo Utilizar a seguinte conta, na aba Domnios Remotos da confi gurao do
Domni o Cl i ente. Al i devem ser especi fi cados o login e senha de um usuri o
exi stente no Domni o sendo acessado remotamente.
Al m do acesso em modo Somente Leitura, possvel bl oquear compl etamente o
acesso remoto, o que exi ge que a conexo com o Domni o Remoto especi fi que um
determi nado usuri o para poder ganhar acesso aos objetos remotos. Isso fei to
atravs da permi sso Acesso remoto ao Domnio, tambm do i tem de segurana
Domnio.
NOTA: A permi sso Acesso remoto ao Domnio sempre ter precednci a sobre a
permi sso Acesso remoto de escrita ao Domnio. I sto si gni fi ca que quando a pri mei ra
permi sso for negada, a segunda no ser efeti vada mesmo quando
expl i ci tamente permi ti da. No havendo nenhuma permi sso de acesso
confi gurada, qual quer Domni o pode se conectar remotamente a outro, uti l i zando
um usuri o anni mo.
3.11.5 Hot-Standby
A conexo remota ao Domni o suporta Domni os com Hot-Standby nati vamente.
Para i sso, basta apenas especi fi car os nomes dos doi s servi dores (pri nci pal e
backup) nos i tens respecti vos da rea Identificao dos servidores na rede, na aba
Domnios Remotos. i mportante ressal tar que, para o correto funci onamento do
Hot-Standby, esses nomes devem ser os mesmos especi fi cados pel o Domni o
Remoto acessado. Uma vez que haja essa confi gurao em tempo de execuo, o E3
Server sempre tentar conectar-se aos doi s servi dores, di reci onando o acesso de
todos os comandos Application.GetObject e Links para o pri mei ro servi dor que
possa ser acessado e que i ndi que estar rodando o Domni o. Caso os nomes dos
servi dores sejam modi fi cados quando o Domni o Cl i ente esti ver em execuo, este
i r desconectar-se e rei ni ci ar a conexo com os novos servi dores.
3.11.6 Gerenciamento da Conexo
Mesmo quando no h confi gurao de Hot-Standby, exi ste um control e da
conexo de Domni os Remotos entre os E3 Servers Cl i entes e Servi dores. A conexo
uti l i za o protocol o REC, o mesmo uti l i zado entre o E3 Server, E3 Vi ewer e E3 Studi o.
Assi m, a porta de conexo do REC e as possvei s confi guraes de firewall
associ adas tambm se apl i cam aos Domni os Remotos.
Com a conexo estabel eci da, espera-se que haja um Domni o rodando. Nesse
processo, a conexo refei ta sempre que houver al gum probl ema. Aps ser
encontrado o Domni o rodando, veri fi ca-se o nome correto do Domni o, bem como
o login do usuri o (se necessri o).
Assi m como acontece com as conexes REC do E3 Studi o e do E3 Vi ewer, as
estatsti cas de comuni cao das conexes de Domni os Remotos podem ser
vi sual i zadas na janel a de Estatsti cas do E3 Server, acessvei s atravs do cone do
E3 Admi n na rea de Noti fi caes do Wi ndows.
146 Domnios
3.11.7 Desconexo
O Domni o Cl i ente pode no consegui r estabel ecer a conexo com o Domni o
Servi dor por uma sri e de moti vos. Entre el es esto:
O computador do Cl i ente ou do Servi dor est fora da rede
O Servi dor no est rodando o E3 Server
O E3 Server do Servi dor no est com o Domni o correto, ou o Domni o no foi
i ni ci ado
O Domni o Servi dor no acei ta o usuri o especi fi cado pel o Domni o Cl i ente
O E3 Server do Cl i ente ou do Servi dor no possui l i cena de Domni o Remoto
O E3 Server do Servi dor de uma verso anti ga (2.5 ou i nferi or)
Exi ste um firewall bl oqueando a porta uti l i zada pel o REC, ou o Cl i ente e o Servi dor
esto usando portas di ferentes
O apel i do do Domni o no exi ste na confi gurao de Domni o Remoto
Quando uma dessas si tuaes ocorrer, todos os Links do Cl i ente referenci ando o
Domni o fi caro desconectados, assi m como todos os mtodos
Application.GetObject referenci ando o Domni o Remoto i ro fal har (ou seja,
causaro erros de scri pt). Quando o probl ema for resol vi do, os Links devero
conectar-se automati camente. J os comandos de Application.GetObject devero
ser re-executados.
3.12 Gerando Logs no E3
O E3 gera l ogs no formato ETL (Event Trace Log). Esses arqui vos de l og so
gerenci ados por uma ferramenta da El i pse chamada Elipse Event Log Viewer,
di sponvel com a i nstal ao do E3. Com essa ferramenta possvel vi sual i zar os
arqui vos e gerenci ar o espao que estes ocupam em di sco, entre outras
confi guraes. Para mai s i nformaes sobre a ferramenta Elipse Event Log Viewer,
consul te o Manual do Usurio do Elipse Event Log Viewer, di sponvel no menu Iniciar
- Programas - Elipse Software - Elipse Event Log. O apl i cati vo Elipse Event Log
Viewer pode ser aberto de trs formas:
Pel o menu Iniciar - Programas - Elipse Software - Elipse Event Log - Log Viewer
Pel o menu Ferramentas - Log Viewer do E3 Studi o
Pel o i tem Atalhos - Log Viewer do menu do E3 Admi n na rea de Noti fi cao do
Wi ndows
Drivers 147
4
Drivers
CAPTULO
O E3 permi te a comuni cao com equi pamentos de aqui si o de dados,
control adores, CLPs (Control adores Lgi cos Programvei s), UTRs (Uni dades
Termi nai s Remotas), ou qual quer outro ti po de equi pamento, atravs de Dri vers de
Comuni cao prpri os ou Servi dores OPC, de acordo com o ti po do equi pamento
ou ti po de comuni cao necessri a.
NOTA: Os objetos de Dri vers (Dri ver de Comuni cao, Pasta de Comuni cao, Tag de
Comuni cao, Bl oco de Comuni cao, El emento de Bl oco, Dri ver de Comuni cao
OPC, Grupo de Tags OPC, Pasta OPC, Tag de Comuni cao OPC, Bl oco de Comuni cao
OPC, El emento de Bl oco OPC e Dri ver de Comuni cao OPC UA) podem ser
confi gurados para funci onarem como reas de Alarme.
4.1 Driver de Comunicao
O Dri ver de Comuni cao o mdul o do E3 que possi bi l i ta a comuni cao com um
determi nado equi pamento usando arqui vos .dl l . Estes Dri vers so desenvol vi dos
pel a El i pse Software, bem como por tercei ros, a parti r de um DDK (Driver
Development Kit), forneci do pel a El i pse, em l i nguagem C/C++. Cada Dri ver
i mpl ementa uma faml i a de equi pamentos ou protocol os di ferentes, de acordo com
o ti po de equi pamento ou protocol o de comuni cao. Novos Dri vers so
costumei ramente desenvol vi dos pel a El i pse Software.
Para i nseri r um Dri ver de Comuni cao no projeto, cl i que com o boto di rei to do
mouse no nome do projeto no Expl orer e sel eci one a opo Inserir - Driver de
Comunicao. No modo Domnio, cl i que com o boto di rei to do mouse no i tem
Objetos de Servidor - Drivers e OPC, sel eci one a opo Inserir Driver de
Comunicao em e l ogo aps o nome do projeto desejado.
148 Drivers
Inserindo um Driver de Comunicao no modo Domnio
A janel a a segui r aberta para l ocal i zao do Dri ver.
Localizar Driver
Se for sel eci onado um Dri ver vl i do, o si stema exi bi r sua janel a prpri a de
confi gurao. Logo em segui da, ser aberta a janel a de i mportao de Tags (se
di sponvel ).
Drivers 149
Ao i nseri r um Dri ver em uma apl i cao do E3 Studi o, aberta a view do objeto,
View do Driver de Comunicao
As opes di sponvei s so:
Opes disponveis na view do Driver de Comunicao
CONE OPO DESCRIO
Adicionar
Adi ci ona uma nova pasta,
um novo Tag ou um novo
Bl oco de Comuni cao ao
Dri ver; um novo Tag ou um
novo Bl oco de
Comuni cao a uma Pasta;
ou um novo El emento de
Comuni cao a um Bl oco.
Remover
Remove o i tem
sel eci onado na view.
Configurar o driver
Abre a janel a de
confi guraes extras do
Dri ver.
Tag Browser
Abre uma janel a que
permi te i mportar Tags
di retamente do Dri ver.
Ativar/desativar
comunicao
Ati va ou desati va a
comuni cao do Dri ver.
Contagem de tags
Apresenta o nmero total
de Tags de Comuni cao
no Dri ver.
150 Drivers
4.1.1 Configurao
Para determi nar o Dri ver de Comuni cao a ser usado, cl i que na propri edade
DriverLocation, ou cl i que com o boto di rei to do mouse no Dri ver e sel eci one a
opo Procurar DLL. Uma cai xa de sel eo para a determi nao do arqui vo .dl l que
contm o Dri ver ser exi bi da, conforme a fi gura a segui r:
Selecionando um Driver
Para mai ores i nformaes sobre a confi gurao i ndi vi dual de cada Dri ver,
consul te os respecti vos arqui vos de ajuda que acompanham os Dri vers, onde
constam i nstrues sobre a confi gurao dos parmetros [P] e demai s
propri edades, acessvei s pel a janel a de confi gurao do Dri ver.
4.1.1.1 Teste de Comunicao
Ao confi gurar um Dri ver de Comuni cao, o usuri o pode real i zar um procedi mento
de teste a fi m de veri fi car se os val ores esto corretos e sendo atual i zados sem
probl emas. Ao cl i car no Dri ver de Comuni cao, aberta a opo Ativar
Comunicao.
Desta forma, o Dri ver de Comuni cao especi fi cado ser carregado e os val ores
das vari vei s podero ser vi sual i zados no campo Valor de cada Tag na view de
edi o. Caso al gum dos Tags possua a propri edade AllowRead em Fal so, ou ai nda
se o Tag no possui r um val or a ser reportado, esta l i nha aparecer com a cor
ci nza.
Caso o Tag apresente erro de comuni cao, a l i nha se tornar vermel ha, e caso a
comuni cao esteja sem probl emas, a l i nha ter a cor azul . Para i nterromper o
Drivers 151
moni toramento, cl i que com o boto di rei to do mouse sobre o Dri ver de
Comuni cao novamente e escol ha a opo Desativar Comunicao.
4.1.2 Funcionamento
O IOServer o mdul o do E3 responsvel pel a comuni cao com o equi pamento.
no processo do IOServer que carregada a DLL do Dri ver e efetuada a comuni cao
com o equi pamento.
Os Tags de Comuni cao possi bi l i tam a l ei tura ou escri ta de um conjunto de
val ores, uti l i zando o Dri ver de Comuni cao onde el es esto i nseri dos. Podem ser
uti l i zados tambm os Bl ocos de Comuni cao para a l ei tura si mul tnea de mai s de
uma vari vel . Para acessar cada val or do Bl oco uti l i ze o El emento de Bl oco, que
pode ser i ncl udo dentro do objeto. Estes objetos sero di scuti dos nas sees
segui ntes.
Em tempo de execuo, o E3 cri a um IOServer para cada Dri ver de Comuni cao.
Baseado no tempo de varredura (propri edade Scan) de cada Tag, o Dri ver i r
requi si tar peri odi camente o val or de cada um. Sempre que o val or ou a qual i dade
do Tag for al terado, seu val or ser repassado para o Dri ver de Comuni cao.
A veri fi cao do tempo de ci cl o de cada vari vel fei ta de forma sequenci al . Caso
o ci cl o de uma vari vel esteja venci do, o IOServer prossegui r com o
questi onamento de seu val or, passando para a prxi ma vari vel at que a
veri fi cao de toda a pl ani l ha esteja compl eta, para ento retornar ao topo para
uma nova varredura.
Pode-se reservar um tempo de ci cl o menor para as vari vei s com necessi dade de
atual i zao mai s vel oz, e um tempo de ci cl o mai or para as vari vei s sem tanta
pri ori dade de atual i zao. Deve-se ressal tar, entretanto, que a performance da
comuni cao depende de uma sri e de fatores, i ncl ui ndo o ti po de equi pamento, o
ti po de i nterface da comuni cao uti l i zada, vel oci dade (baud rate), taxa de erros,
etc.
Sempre que o E3 envi ar uma sol i ci tao de atri bui o de val ores para uma ou mai s
vari vei s, esta sol i ci tao ser executada com pri ori dade em rel ao varredura
dos Tags.
No caso de fal ha de um IOServer, o E3 automati camente real i zar uma
rei ni ci al i zao daquel e mdul o, de forma a normal i zar seu funci onamento. Por
outro l ado, o IOServer i r i nterromper seu funci onamento caso no exi sta nenhum
E3 Runti me (Principal ou Standby) para receber seu dados.
Atravs da propri edade ShareServer, possvel comparti l har o mesmo IOServer
entre vri os Dri vers de Comuni cao. O pri mei ro Dri ver a ser executado ser o
responsvel por i ni ci ar os procedi mentos de comuni cao, como abri r uma porta
seri al ou i ni ci ar uma i nterface de comuni cao. Os prxi mos Dri vers de
Comuni cao comparti l hados uti l i zaro o mesmo IOServer aberto pel o pri mei ro, o
que permi te o comparti l hamento das i nterfaces de comuni cao uti l i zadas pel o
Dri ver.
152 Drivers
Isto pode ser vantajoso, j que mui tos dos di sposi ti vos de comuni cao, como
modems, portas seri ai s e outras i nterfaces, permi tem apenas uma conexo, o que
i mpedi ri a a uti l i zao si mul tnea por mai s de um Dri ver. Com o comparti l hamento
pode-se reuti l i zar a mesma conexo para mai s de um objeto. Deve-se ressal tar que
as confi guraes dos Dri vers comparti l hados devem ser as mesmas para que o
comparti l hamento de Dri vers funci one corretamente.
Quando o Domni o est em execuo, temos acesso i nterface de execuo do
Dri ver de Comuni cao denomi nado Gerenciador de Drivers.
Acesso ao Gerenciador de Drivers
O Gerenci ador de Dri vers permi te vi sual i zar todos os Dri vers em execuo,
exi bi ndo suas propri edades.
Drivers 153
Gerenciador de Drivers
Opes disponveis na janela Gerenciador de Drivers
OPO DESCRIO
Nome
I nforma o nome do Dri ver i nseri do no
si stema.
Objeto(s)
I nforma o nome do objeto Dri ver de
Comuni cao associ ado ao Dri ver.
Erros de leitura
Mostra o total de l ei turas do Dri ver, a
quanti dade de erros de l ei tura e
percentual de erros em rel ao ao total
de l ei turas.
Erros de escrita
Mostra o total de escri tas do Dri ver, a
quanti dade de erros de escri ta e
percentual de erros em rel ao ao total
de escri tas.
Processo
Mostra o i denti fi cador do processo do
I OServer no si stema operaci onal .
Estado
Mostra o estado atual do Dri ver
(confi gurado, i ni ci ando, rodando,
fi nal i zando, fi nal i zado ou em erro). Se o
Dri ver esti ver em erro, mostra uma
descri o do erro.
Compartilhado
Mostra as pal avras SIM ou NO,
i nformando se o Dri ver est
comparti l hado ou no.
Log
Mostra o status do l og (habi l i tado ou
desabi l i tado).
Caminho
I nforma o cami nho do Dri ver no si stema.
154 Drivers
OPO DESCRIO
Habilitar Log
Habi l i ta o l og dos Dri vers em tempo de
execuo, sem a necessi dade de
reconfi gurar o apl i cati vo. Atravs da
mesma opo pode-se i nterromper este
procedi mento de gravao.
Atualizar
Fora a atual i zao dos dados exi bi dos.
4.1.2.1 Utilizao de Estampa de Tempo
Al guns equi pamentos e protocol os permi tem o envi o de i nformaes de tempo
juntamente com os val ores das vari vei s. Os Dri vers de Comuni cao para tai s
equi pamentos podem, a cada vari vel consul tada, retornar tambm a i nformao
deste rel gi o que fi ca armazenada na propri edade TimeStamp de cada Tag, com
resol uo de 1ms.
Quando o equi pamento no suporta este ti po de i nformao, ou quando o Dri ver
no est preparado para tal , o Dri ver de Comuni cao i nsere na estampa de tempo
o val or de data e hora atual , a parti r do rel gi o do computador. De posse da
estampa de tempo, o E3 i r uti l i zar esta i nformao tanto para a veri fi cao e
gravao de al armes quanto para a gerao de arqui vos hi stri cos.
No caso dos Tags serem El ementos de Bl oco, i nformada a mesma estampa de
tempo para todos os El ementos do Bl oco, j que foram consul tadas no mesmo
i nstante de tempo. No caso do Dri ver suportar l ei turas de vari vei s tanto como
Bl oco quanto como Tag de Comuni cao, caso os El ementos possam representar
eventos di sti ntos, deve-se preferi r o uso de Tags de Comuni cao.
Para obter mai s i nformaes sobre quai s equi pamentos possuem esta
caractersti ca, entre em contato com o fabri cante. Para saber quai s Dri vers ou
ti pos de vari vei s dentro dos equi pamentos uti l i zam a estampa de tempo, consul te
a ajuda dos Dri vers ou di retamente o suporte tcni co da El i pse Software.
4.1.2.2 Tags Reportados por Eventos
Tags reportados por eventos podem retornar mai s de um val or a cada l ei tura, ou
ento no retornar val or al gum.
Os Tags reportados por eventos so desti nados l ei tura de dados sob demanda,
geral mente armazenados no Dri ver at serem l i dos em uma operao de l ei tura.
So normal mente uti l i zados para a l ei tura de eventos, dados de memri a de massa
e mensagens no sol i ci tadas recebi das do equi pamento.
A documentao do Dri ver dever especi fi car quai s dos seus Tags di sponvei s para
a apl i cao so reportados a eventos.
A uti l i zao mai s comum para a col eta de Sequnci a de Eventos (SOE, ou Sequence
Of Events). Por exempl o, em equi pamentos que armazenem em sua memri a
sequnci as mui to rpi das de vari aes de Tags di gi tai s, ou que armazenem dados
de tel emetri a em tabel as na memri a, os dados podero fi car armazenados na
Drivers 155
memri a em tabel as, como demonstrado nas fi guras a segui r:
Tabela com trs eventos e apenas um campo de dados
Tabela com trs eventos e seis campos de dados
Para o pri mei ro exempl o, necessri o um Tag de Comuni cao para l er o val or A.
O campo Tempo seri a retornado na propri edade TimeStamp do Tag. J para o
segundo exempl o, necessri o um Tag Bl oco de Comuni cao com sei s el ementos
(de A at F), com o campo Tempo mai s uma vez sendo retornado na propri edade
Timestamp do Bl oco de Comuni cao.
Em Tags comuns, no reportados por eventos, pode-se confi gurar um tempo de
varredura (scan), que determi na o perodo em que o val or do Tag ser l i do. A cada
operao de l ei tura, o Tag retornar um val or (Tag de Comuni cao) ou bl oco de
val ores (Tag Bl oco de Comuni cao), ou ento poder retornar erro. Para l er as
tabel as descri tas anteri ormente, neste caso, so necessri as trs operaes de
l ei tura em cada tabel a para poder l er os trs eventos (ou seja, as trs l i nhas da
tabel a).
Os Tags reportados por eventos tambm permi tem confi gurar um tempo de
varredura. Para estes Tags, entretanto, cada operao de l ei tura pode retornar uma
sri e de val ores ou bl ocos de val ores, com qual i dades e timestamps prpri os. Ou
seja, no caso de uti l i zar Tags reportados por eventos para l er as tabel as anteri ores,
seri a possvel obter os trs eventos (os dados das trs l i nhas de cada tabel a) de
uma vez s, em uma ni ca operao de l ei tura (um ni co scan).
A l ei tura dos val ores retornados por Tags reportados por eventos fei ta atravs do
evento OnRead do Tag. A cada operao de l ei tura que retorne val ores, a apl i cao
i r di sparar uma sucesso de eventos OnRead. Para cada val or ou evento
retornado, a apl i cao i r preencher as propri edades do Tag (val or, timestamp e
qual i dade) com os val ores do evento especfi co, e ento di sparar o evento OnRead.
Caso o Dri ver no possua eventos ou val ores a retornar, a operao de l ei tura
reportada a eventos, ao contrri o do que ocorre com os Tags comuns, poder no
retornar dado al gum e nem gerar erros, como se a operao de l ei tura no
156 Drivers
houvesse ocorri do.
O tempo de varredura ou scan de Tags reportados por eventos geral mente pode ser
confi gurado com um val or bem bai xo, poi s o consumo de CPU, caso no exi stam
val ores a retornar, geral mente desprezvel .
A propri edade TimeStamp destes Tags em geral contm um val or forneci do pel o
prpri o equi pamento.
NOTA: Os Tags reportados por eventos devem ser confi gurados com a propri edade
EnableDeadband desabi l i tada. I sto evi ta que eventos com val ores mui to prxi mos
sejam desprezados pel a apl i cao.
4.1.2.2.1 Gravao de Eventos em um Histrico
O uso mai s comum da l ei tura de Tags reportados por eventos a gravao dos
eventos retornados em um objeto Hi stri co. Para i sto, si ga estes procedi mentos:
1. Cri e um objeto Hi stri co, com varredura desabi l i tada (propri edade ScanTime
i gual a zero) e sem banda morta (propri edade DeadBand i gual a zero).
2. Associ e as propri edades TimeStamp e os val ores do Tag ao Hi stri co. Pode-se
tambm associ ar outras propri edades, caso seja i mportante armazen-l as.
3. Uti l i ze o mtodo WriteRecord do objeto Hi stri co no evento OnRead do Tag.
Desta forma, garante-se que cada val or reportado a evento que chegar ser
gravado sequenci al mente no Hi stri co associ ado.
4.1.2.3 Pool de Processos IOServer
Em apl i cati vos com centenas de Dri vers, os recursos necessri os para rodar os
processos IOServer para cada Dri ver podem esgotar a capaci dade do si stema
operaci onal . Nestes casos, pode ser necessri o habi l i tar o Pool de Processos
IOServer na aba Propriedades da confi gurao do Domni o.
Quando este Pool est habi l i tado, cada processo IOServer pode executar mai s de
um Dri ver, economi zando desta forma recursos do si stema operaci onal e
permi ti ndo que um apl i cati vo chegue a rodar mi l hares de Dri vers.
Apenas Dri vers que suportam a cri ao de novas i nstnci as di nmi cas (Dri vers
compi l ados com o IOKit v2.0.6 ou superi or) podem ser uti l i zados no Pool. Se um
Dri ver que no tem este suporte for adi ci onado ao Pool, el e no ser executado
(fal har). Para estes casos, basta confi gurar a propri edade DisableIOServerPool do
IODri ver para Fal so para que o Dri ver rode fora do Pool, em um processo IOServer
excl usi vo.
Na aba Propriedades da confi gurao do Domni o, pode-se control ar o nmero
mxi mo de processos IOServer no Pool, bem como o nmero mxi mo de Dri vers que
Drivers 157
i ro rodar em cada IOServer.
Opes de comportamento do Pool de Processos IOServer
DRIVERS POR PROCESSO NMERO MXIMO DE
PROCESSOS
COMPORTAMENTO DO POOL
0 M
medi da que os Dri vers do
apl i cati vo forem ati vados,
ser cri ado um processo
I OServer para cada Dri ver,
at ati ngi r o nmero
mxi mo M. Depoi s deste
ponto, cada novo Dri ver
que for ati vado ser
adi ci onado ao I OServer do
Pool que contm a menor
quanti dade de Dri vers.
N 0
o E3 i r adi ci on-l os a um
processo I OServer do Pool
que ai nda no tenha
ati ngi do o nmero mxi mo
N de Dri vers rodando
dentro del e. Se todos os
processos do Pool
esti verem no l i mi te
mxi mo, ento um novo
I OServer ser adi ci onado
ao Pool.
158 Drivers
DRIVERS POR PROCESSO NMERO MXIMO DE
PROCESSOS
COMPORTAMENTO DO POOL
M M
o E3 i r adi ci on-l os a um
processo I OServer do Pool
que ai nda no tenha
ati ngi do o nmero mxi mo
N de Dri vers rodando
dentro del e. Se todos os
processos do Pool
esti verem no l i mi te
mxi mo, o comportamento
depender da quanti dade
de processos no Pool, e se
o nmero de processos do
Pool for menor que o
mxi mo M, ento um novo
processo ser adi ci onado
ao Pool, caso contrri o, o
Dri ver ser adi ci onado no
processo que ti ver menos
Dri vers rodando. NOTA:
Neste modo, o nmero
mxi mo de Dri vers por
processo (N) pode ser
ul trapassado caso o
nmero total de Dri vers do
apl i cati vo exceda N * M.
NOTAS:
Ao agrupar Dri vers em um mesmo processo I OServer, perde-se o i sol amento
entre estes Dri vers. Desta forma, se ocorrer uma fal ha em um destes Dri vers, o
I OServer ser fechado e todos os Dri vers que rodavam naquel e I OServer tero
que ser rei ni ci ados.
Exi ste um l i mi te no nmero de Dri vers que podem rodar em um processo
I OServer. Este l i mi te depende de di versas vari vei s, tai s como o si stema
operaci onal em uso, a quanti dade de memri a, threads e recursos que cada
Dri ver especfi co est ocupando. Em l i nhas gerai s, no se deve adi ci onar mai s do
que 100 Dri vers em um ni co I OServer, sob pena de exceder os l i mi tes do si stema
operaci onal .
4.1.3 Pasta de Comunicao
A Pasta de Comunicao defi ne grupos e subdi retri os de forma a organi zar as
vari vei s. Cada Pasta pode ser renomeada conforme a necessi dade e novas Pastas
podem ser i nseri das dentro de outras. Para uti l i zar este recurso, si ga este
procedi mento:
Drivers 159
1. No Organi zer, cl i que com o boto di rei to do mouse sobre o objeto Dri ver e
sel eci one a opo Inserir - Nova Pasta.
Inserindo uma nova Pasta
4.1.4 Tag de Comunicao
O Tag de Comunicao possi bi l i ta a l ei tura ou a escri ta de um conjunto de val ores
uti l i zando o Dri ver de Comuni cao. uti l i zado para defi ni r a troca de i nformaes
com os equi pamentos de aqui si o, que consi stem em uma ni ca vari vel
160 Drivers
i ndependente.
O Tag de Comuni cao pode ser uma vari vel anal gi ca, de entrada, de sada,
contador, ponto di gi tal , etc. Vri os pontos di gi tai s podem ser agrupados no Tag e
serem acessados atravs de suas propri edades, como bi ts de dados. Os Tags de
Comuni cao so confi gurados atravs de uma sri e de parmetros N (N1 a N4),
que vari am de acordo com o Dri ver de Comuni cao a ser uti l i zado. Para uti l i zar
este recurso, si ga estes procedi mentos:
1. Insi ra o Tag de Comuni cao no projeto, cl i cando com o boto di rei to do
mouse no Dri ver e sel eci onando a opo Inserir - Tag de Comunicao.
Drivers 161
Inserindo um Tag de Comunicao
2. O si stema abre uma janel a perguntando quantos Tags sero cri ados no Dri ver,
e qual seu nome. Este nome ser auto-i ncrementado; se a opo for dei xada em
branco, os Tags sero cri ados com o nome padro.
162 Drivers
Inserindo Tags de Comunicao
Caso o equi pamento sendo uti l i zado para col etar os dados i nforme val ores de Tags
que preci sam ser converti dos, pode-se uti l i zar as escal as dos Tags, que so
basi camente uma especi fi cao de uma converso l i near entre duas bases
di ferentes.
Para i sto, deve-se habi l i tar a propri edade EnableScaling do Tag e i nformar os
parmetros DeviceLow e DeviceHigh (atravs das respecti vas propri edades), que
seri am os l i mi tes i nferi or e superi or do dado vi ndo do equi pamento, al m de
i nformar os parmetros EULow e EUHigh (atravs das respecti vas propri edades)
que so os l i mi tes i nferi or e superi or do dado, j em uni dades de engenhari a.
Al gumas das propri edades deste objeto podem ser confi guradas di retamente na
Li sta de Propri edades, sem a necessi dade de cri ar scri pts para i sto. Demai s
i nformaes sobre as funci onal i dades das propri edades deste objeto podem ser
encontradas no Manual de Referncia de Scripts, em seu captul o respecti vo.
4.1.5 Bloco de Comunicao
O Bloco de Comunicao uti l i zado para defi ni r a troca de i nformaes com os
equi pamentos de aqui si o, que consi stem de uma ou mai s vari vei s, desde que
seja consecuti vo no endereamento dentro do di sposi ti vo externo.
Dependendo do mtodo de comuni cao uti l i zado, podem economi zar tempo de
comuni cao, obtendo um nmero mai or de atual i zaes em um mesmo i nterval o
de tempo se comparado com o Tag de Comuni cao. Os Bl ocos de Comuni cao
so confi gurados atravs de uma sri e de parmetros B (B1 a B4) que vari am de
acordo com o Dri ver de Comuni cao a ser uti l i zado, al m da propri edade Size, que
defi ne o nmero de El ementos ou ndi ces di sponvei s no Bl oco. Para uti l i zar este
recurso, si ga estes procedi mentos:
1. Cl i que com o boto di rei to do mouse no Dri ver e escol ha a opo Inserir - Bloco
de Comunicao.
Drivers 163
Inserindo um Bloco de Comunicao
2. O si stema abre uma janel a perguntando quantos Bl ocos sero cri ados no
Dri ver, e qual seu nome. Este nome ser auto-i ncrementado; se a opo for
dei xada em branco, os Bl ocos sero cri ados com o nome padro.
164 Drivers
Inserindo Blocos de Comunicao
3. O si stema mostrar uma cai xa de di l ogo para determi nar o nmero de
El ementos de Bl oco neste objeto. Nesta opo possvel i ndi car o mapeamento
de todos os El ementos de Bl oco ou somente num determi nado i nterval o de
El ementos.
Configurando o Bloco de Comunicao
4. Informe o tamanho do Bl oco e a opo de mapeamento.
5. Cl i que em OK.
6. Caso necessi te, confi gure as propri edades do objeto.
Al gumas das propri edades do Bl oco de Comuni cao podem ser confi guradas
atravs da Li sta de Propri edades, sem a necessi dade de cri ar scri pts para i sto.
Caso necessi te confi gurar al guma propri edade, basta l ocal i z-l a na Li sta de
Propri edades e fazer os devi dos ajustes. Para mai ores i nformaes, consul te o
Manual de Referncia de Scripts.
Drivers 165
4.1.6 Elemento de Bloco
Os Elementos de Bloco representam as associ aes de cada uma das posi es no
Bl oco, de forma a serem uti l i zados como se fossem Tags de Comuni cao. Os
El ementos de Bl oco podem apontar l i vremente para cada ndi ce dentro de um
Bl oco. Podem exi sti r doi s El ementos de Bl oco apontando para o mesmo ndi ce do
Bl oco, e tambm um nmero menor, i gual ou mai or de El ementos do que o nmero
de vari vei s decl aradas no Bl oco. Para uti l i zar este recurso, si ga este
procedi mento:
1. Cl i que com o boto di rei to do mouse no Bl oco de Comuni cao e escol ha a
opo Inserir - Elemento de Comunicao.
Inserindo um Elemento de Bloco
Caso o equi pamento sendo uti l i zado para col etar os dados i nforme val ores de
El ementos que preci sam ser converti dos, pode-se uti l i zar as escal as dos El ementos,
166 Drivers
que so basi camente uma especi fi cao de uma converso l i near entre duas bases
di ferentes.
Para i sto, deve-se habi l i tar a propri edade EnableScaling do El emento e i nformar os
parmetros DeviceLow e DeviceHigh (atravs das respecti vas propri edades), que
seri am os l i mi tes i nferi or e superi or do dado vi ndo do equi pamento, al m dos
parmetros EULow e EUHigh (atravs das respecti vas propri edades) que so os
l i mi tes i nferi or e superi or do dado j em uni dades de engenhari a.
Al gumas das propri edades do El emento de Bl oco podem ser confi guradas atravs
da Li sta de Propri edades, sem a necessi dade de cri ar scri pts para i sto. Caso
necessi te confi gurar al guma propri edade, basta l ocal i z-l a na Li sta de
4.2 Servidor OPC
Al m de possui r um cl i ente OPC (Driver OPC), o E3 funci ona tambm como Servi dor
OPC DA (Data Access) 2.0x. Isso permi te ao E3 expor todos os objetos exi stentes no
Domni o em execuo (Tags de Comuni cao, por exempl o) para softwares externos
ao E3. Como exempl os, pode-se ci tar o El i pse SCADA, o E3 (que pode estar rodando
em outra apl i cao como cl i ente), ou um cl i ente OPC de outro fabri cante, basta que
o cl i ente i mpl emente o padro OPC DA 2.0x ou superi or.
NOTA: O Servi dor OPC no E3 um mdul o adi ci onal a parti r da verso 3.0, e
necessi ta de l i cena especfi ca no di sposi ti vo de proteo. Entre em contato com a
Elipse para mai ores i nformaes.
4.2.1 Caractersticas
Para usar o Servi dor OPC do E3 no necessri a nenhuma confi gurao extra,
bastando executar o Domni o para que qual quer cl i ente OPC possa se comuni car
com o E3. Para conectar-se ao servi dor OPC do E3 de um cl i ente qual quer, basta
sel eci onar o servi dor i denti fi cado como Elipse.OPCSvr.1.
O Servi dor OPC permi te que qual quer cl i ente i mporte faci l mente toda a defi ni o
de Tags exi stentes no Domni o (funo Browse). Natural mente, os Tags forneci dos
so apenas os objetos que fazem parte do servi dor, ou seja, i tens de Tel a (Vi ewer)
no so acessvei s pel o Servi dor OPC.
Sendo baseado na mesma tecnol ogi a de associ aes usada nas associ aes
i nternas entre objetos, o Servi dor OPC do E3 permi te que cl i entes usem Tags que
sejam expresses matemti cas, e com o recurso de conexo e desconexo
transparente durante a execuo.
Drivers 167
4.2.2 Informaes de Status
Atravs da i nformao de status (funci onal i dade padro do OPC), o cl i ente OPC
pode i denti fi car se o servi dor do E3 encontra-se sem Domni o, em standby ou
rodando normal mente. O status do OPC pode ser:
Domnio rodando normalmente: OPC_STATUS_RUNNING
Domnio em standby: OPC_STATUS_SUSPENDED
Domnio parado ou sem Domnio: OPC_STATUS_NOCONFIG
4.2.3 Desconexo
Para os cl i entes OPC que suportam o mecani smo de desl i gamento (shutdown),
sempre envi ado um avi so quando o Domni o parado ou entra em standby. Aps
o avi so, todos os cl i entes so desconectados.
4.3 Driver de Comunicao OPC
O Driver de Comunicao OPC o mdul o responsvel por col etar dados de
equi pamentos externos atravs da execuo de um Servi dor OPC, que pode ser
forneci do por qual quer empresa. Os Tags podem ser i mportados para o Dri ver OPC
dentro do E3 (que neste caso atua como um OPC Cl i ent) ou ai nda podem ser cri ados
a parti r do E3. Para uti l i zar um Dri ver OPC, si ga estes procedi mentos:
1. Cl i que com o boto di rei to do mouse sobre o nome do projeto, e sel eci one a
opo Inserir - Driver de Comunicao OPC.
168 Drivers
Inserindo um Driver OPC
Ao i nseri r um Dri ver OPC em uma apl i cao do E3 Studi o, aberta a view do objeto,
View do Driver de Comunicao OPC
Drivers 169
Opes disponveis na view do Driver OPC
CONE OPO DESCRIO
Adicionar
Adi ci ona um Grupo ao
Dri ver; um Tag, um Bl oco
ou uma Pasta ao Grupo;
ou um El emento ao Bl oco.
Remover
Remove o i tem
sel eci onado na view.
Selecionar servidor
Sel eci ona o Servi dor OPC.
Ativar/desativar
comunicao
Ati va e desati va a
comuni cao do Dri ver.
Importar tags
I mporta Tags para o Dri ver
OPC.
Informaes sobre o servidor
Mostra uma janel a com as
confi guraes do Dri ver.
Contagem de tags
Apresenta o nmero total
de Tags de Comuni cao
no Dri ver.
4.3.1 Configurao
A i denti fi cao dos outros objetos pertencentes ao Dri ver OPC pode ser i nseri da
manual mente, ou ento ser trazi da automati camente do Servi dor OPC. Para i sso,
abra as propri edades do Dri ver, cl i cando com o boto di rei to do mouse e
sel eci onando a aba OPC Driver.
170 Drivers
Aba OPC Driver
Informe o Endereo e ID do Servidor e cl i que em Selecionar. A segui nte janel a ser
mostrada:
Drivers 171
Seleo do Servidor OPC
As opes di sponvei s no i tem Opes de busca dos servidores OPC so as
segui ntes:
Opes disponveis na janela Servidores OPC
OPO DESCRIO
Tentar enumerador padro ou registro
(recomendado)
O E3 i r tentar procurar as especi fi caes
do Dri ver, tanto pel o Regi stro do
Wi ndows quanto pel o enumerador
padro OPC (OPCENUM).
Tentar apenas enumerador padro (servio
OPCENUM)
do Dri ver apenas pel o enumerador
padro OPC (OPCENUM).
Tentar apenas pesquisa no registro
do Dri ver apenas pel os regi stros no
Wi ndows.
172 Drivers
Cl i cando em OK, o si stema mostrar os dados do Dri ver, i ndi cando os cami nhos e
o nome do servi dor. Para ati var a comuni cao do Dri ver OPC, cl i que em Ativar
Comunicao:
Ativar comunicao do Driver OPC
Quando a comuni cao ati vada, so habi l i tadas as opes Informaes sobre o
servidor e Importar tags, al m da opo Desativar Comunicao. Para uti l i zar estas
Drivers 173
opes, basta cl i car com o boto di rei to do mouse sobre o Dri ver OPC e escol her a
opo desejada.
Opes habilitadas quando o Driver OPC est ativo
A opo Informaes sobre o servidor mostra uma janel a com as confi guraes do
Dri ver.
174 Drivers
Informaes do Servidor OPC
Atravs da opo Importar tags, possvel i mportar Tags para o Dri ver OPC.
Quando esta opo sel eci onada, a segui nte mensagem mostrada:
Mensagem referente importao de Tags OPC
As opes so as segui ntes:
Sim: O E3, ao fazer a l ocal i zao dos Tags OPC, i r tentar automati camente
detectar quai s Tags so do ti po Bl oco e, neste caso, qual o nmero de El ementos.
Para fazer i sto, o E3 preci sa l er o val or de cada um, o que dependendo do
servi dor e do nmero de Tags, pode ser demorado
No: O E3 no i r l er os val ores dos Tags OPC ao fazer a operao de procura.
Drivers 175
Essa operao mai s rpi da, porm no i r cri ar automati camente Tags OPC de
ti po Bl oco e seus El ementos
Cancelar: Cancel a a i mportao
A janel a de i mportao di spe dos segui ntes recursos:
Importao de Tags OPC
Opes disponveis na janela Importao de Tags OPC
OPES DESCRIO
Nome dos Itens
Fi l tra os Tags a parti r do nome dos i tens
especi fi cados. Podem ser uti l i zados
caracteres curi ngas, tai s como * ou ?.
Tipo de dados
Fi l tra os Tags a parti r do ti po de dado
especi fi cado no campo, que pode ser
Integer, Long, Single, etc.
176 Drivers
OPES DESCRIO
Tipo de acesso
Fi l tra os Tags a parti r do ti po de acesso
especi fi cado no campo, que pode ser
Leitura, Escrita ou Leitura e Escrita.
Mostrar apenas itens com IDs no
encontrados no projeto
Fi l tra os Tags para que o si stema mostre
apenas os i tens com I Ds no
encontrados no projeto.
Projeto corrente
Mostra os objetos que foram
sel eci onados para adi o no projeto
corrente.
Servidor OPC
Mostra os Tags di sponvei s no servi dor
para a i mportao.
Para fazer a i mportao, basta sel eci onar o Tag desejado e arrast-l o para o Dri ver
ou Grupo OPC desejado. Para desati var a comuni cao do Dri ver OPC, basta cl i car
na opo Desativar Comunicao.
Al gumas das propri edades do Dri ver OPC podem ser confi guradas atravs da Li sta
de Propri edades, sem a necessi dade de cri ar scri pts para i sto. Caso necessi te
confi gurar al guma propri edade, basta l ocal i z-l a na Li sta de Propri edades e fazer
os devi dos ajustes. Para mai ores i nformaes, consul te o Manual de Referncia de
Scripts.
4.3.2 Grupo de Tags OPC
O objeto Grupo de Tags OPC agrupa uma sri e de Tags OPC que comparti l ham os
mesmos parmetros de atual i zao (tempo de varredura e banda morta). sempre
necessri o exi sti r um Grupo de Tags OPC para poder cri ar Tags OPC. Para i nseri r
um Grupo de Tags OPC, si ga este procedi mento:
1. Cl i que com o boto di reto do mouse sobre o Dri ver OPC e sel eci one a opo
Inserir - Grupo de tags OPC.
Drivers 177
Inserindo um Grupo de Tags OPC
Al gumas das propri edades do Grupo de Tags OPC podem ser confi guradas atravs
da Li sta de Propri edades, sem a necessi dade de cri ar scri pts para i sto. Caso
4.3.3 Pasta OPC
O objeto Pasta OPC defi ne grupos ou subdi retri os, de forma a mel hor organi zar as
vari vei s. Cada Pasta OPC pode ser renomeada conforme a necessi dade, e novas
Pastas podem ser i nseri das dentro de outras. Em tempo de execuo, se a Pasta
OPC for desabi l i tada, todo o contedo ser desati vado. Para uti l i zar este recurso,
si ga este procedi mento:
178 Drivers
1. Cl i que com o boto di rei to do mouse sobre o Grupo OPC e sel eci one a opo
Inserir - Nova Pasta.
Inserindo uma Pasta OPC
4.3.4 Tag de Comunicao OPC
O Tag OPC um objeto para l ei tura ou escri ta de val ores em um equi pamento. A
l ei tura do Tag fei ta automati camente pel o Servi dor OPC, com tempo de varredura
defi ni do no Grupo OPC no qual el e est i nseri do. Para uti l i zar este recurso, si ga
estes procedi mentos:
Inserir - Tag de Comunicao OPC.
Drivers 179
Inserindo um Tag de Comunicao OPC
2. O si stema abre uma janel a perguntando quantos Tags sero cri ados no Grupo,
e qual seu nome. Este nome ser auto-i ncrementado; se a opo for dei xada em
branco, os Tags sero cri ados com o nome padro.
180 Drivers
Inserindo Tags de Comunicao OPC
Al gumas das propri edades do Tag OPC podem ser confi guradas atravs da Li sta de
Propri edades, sem a necessi dade de cri ar scri pts para i sto. Caso necessi te
Scripts.
4.3.5 Bloco de Comunicao OPC
O objeto Bloco de Comunicao OPC possi bi l i ta a l ei tura ou escri ta de um conjunto
de val ores. Para fazer uma escri ta, deve-se apenas atri bui r um novo val or
propri edade Value. A l ei tura do Tag fei ta automati camente pel o Servi dor OPC com
tempo de varredura defi ni do no Grupo OPC. A propri edade Size determi na o nmero
de El ementos do Tag no servi dor. Para uti l i zar este recurso, si ga estes
procedi mentos:
Inserir - Bloco de Comunicao OPC.
Drivers 181
Inserindo um Bloco de Comunicao OPC
2. O si stema abre uma janel a perguntando quantos Bl ocos sero cri ados no
Grupo, e qual seu nome. Este nome ser auto-i ncrementado; se a opo for
dei xada em branco, os Bl ocos sero cri ados com o nome padro.
182 Drivers
Inserindo Blocos de Comunicao OPC
3. O si stema mostrar uma cai xa de di l ogo para determi nar o nmero de
El ementos de Bl oco neste objeto. Nesta opo possvel i ndi car o mapeamento
de todos os El ementos de Bl oco ou somente de um determi nado i nterval o de
El ementos.
Configurando o Bloco de Comunicao
4. Informe o tamanho do Bl oco e a opo de mapeamento.
5. Cl i que em OK.
Al gumas das propri edades do Bl oco de Comuni cao OPC podem ser confi guradas
Drivers 183
4.3.6 Elemento de Bloco OPC
O objeto Elemento de Bloco OPC possi bi l i ta a l ei tura ou escri ta de um dos
El ementos do Bl oco OPC onde el e est i nseri do.
O Bl oco OPC l uma tabel a de dados, e este objeto estar sempre associ ado
posi o defi ni da por sua propri edade Index. Por exempl o, um El emento de Bl oco
OPC com Index i gual a ci nco e i nseri do em um Bl oco OPC com tamanho 10, cujos
dados sejam l i dos como na tabel a a segui r:
Tabela
5 12 77 55 1 3 42 20 8 89
ndice
0 1 2 3 4 5 6 7 8 9
Teri a sua propri edade Value i gual a trs, segundo a tabel a aci ma.
NOTA: O E3 pode cri ar automati camente os el ementos de Bl oco OPC. Para mai ores
detal hes, veja a opo Importar Tags, no tpi co Configurao.
Para uti l i zar este recurso, si ga este procedi mento:
1. Cl i que com o boto di rei to do mouse sobre o Bl oco OPC e sel eci one a opo
Inserir - Elemento de Bloco OPC.
184 Drivers
Inserindo um Elemento de Bloco OPC
Al gumas das propri edades do El emento de Bl oco OPC podem ser confi guradas
4.4 Driver de Comunicao OPC UA
O Driver de Comunicao OPC UA i mpl ementa a comuni cao com um servi dor OPC
UA que i mpl emente l ei turas hi stri cas, como por exempl o o EPM. Este objeto pode
ser usado como fonte de dados de um objeto Consulta. Para i nseri r um Dri ver de
Comuni cao OPC UA no projeto, cl i que com o boto di rei to do mouse no nome do
projeto no Expl orer e sel eci one a opo Inserir - Driver de Comunicao OPC UA. No
modo Domnio, cl i que com o boto di rei to do mouse no i tem Objetos de Servidor -
Drivers e OPC, sel eci one a opo Inserir Driver de Comunicao OPC UA em e l ogo
Drivers 185
aps o nome do projeto desejado.
Inserindo um Driver de Comunicao OPC UA em modo Domnio
Al gumas das propri edades do Dri ver de Comuni cao OPC UA podem ser
confi guradas atravs da Li sta de Propri edades, sem a necessi dade de cri ar scri pts
para i sto. Caso necessi te confi gurar al guma propri edade, basta l ocal i z-l a na Li sta
de Propri edades e fazer os devi dos ajustes. Para mai ores i nformaes, consul te o
4.4.1 Configurao
A confi gurao do objeto Dri ver de Comuni cao OPC UA semel hante
confi gurao do Driver de Comunicao OPC. Para confi gur-l o, cl i que com o boto
di rei to do mouse no objeto e sel eci one o i tem Selecionar servidor.
186 Drivers
Opo Selecionar servidor
A janel a a segui r ser mostrada, permi ti ndo sel eci onar um servi dor OPC UA na
mqui na l ocal ou na rede.
Drivers 187
Servidores OPC UA locais e na rede
Para cada servi dor OPC UA, tanto l ocai s quanto em rede, so enumerados os
pontos de conexo (endpoints), que podem uti l i zar di ferentes protocol os e modos
de segurana. Al m di sto, para cada ponto de conexo o servi dor tambm pode
suportar di ferentes formas de i denti fi cao e autenti cao de usuri os.
Atual mente, o E3 permi te a conexo apenas pel o modo TCP Binrio. Para este modo,
o E3 suporta os modos de segurana defi ni dos pel o padro OPC UA, em di versas
combi naes de pol ti cas de segurana. Para a autenti cao, o E3 suporta apenas
os modos Annimo e Usurio e Senha.
NOTA: A janel a Servi dores OPC UA l i sta todos os protocol os e modos de segurana,
para i nformao do usuri o. Entretanto, somente os modos compatvei s com o E3
podero ser sel eci onados.
Ao sel eci onar um ponto de conexo compatvel com o E3, as propri edades
EndPointURL, SecurityMode e SecurityPolicy do objeto sero automati camente
188 Drivers
preenchi das.
Se as propri edades UserName e Password do objeto forem dei xadas em branco, o
E3 uti l i zar uma conexo anni ma com o servi dor. Caso contrri o, o E3 envi ar os
val ores destas propri edades para o servi dor, que dever suportar este ti po de
autenti cao no ponto de conexo sel eci onado.
Neste objeto tambm possvel confi gurar di versos l i mi tes de tempo (timeouts) da
conexo OPC UA. Estes val ores de l i mi te de tempo (propri edades TimeoutCall,
TimeoutConnection e TimeoutSession) so sempre em mi l i ssegundos e devem ser
ajustados de acordo com a performance da comuni cao, que pode ser l i mi tada
pel o servi dor, pel a rede, pel as mqui nas onde rodam o cl i ente e o servi dor, e at
mesmo pel as operaes fei tas pel o cl i ente. Este ajuste deve ser fei to caso a caso e
os val ores padro destas propri edades so apenas sugestes.
No E3 Studi o, a comuni cao com o Dri ver pode ser ati vada ao sel eci onar a opo
Ativar Comunicao no menu contextual do objeto. A ati vao executada
automati camente pel os objetos Consul ta ao sel eci onar servi dores, Tags, ou
executar a vi sual i zao dos resul tados de uma consul ta (aba Visualizar).
Note que para edi tar as propri edades do Dri ver pode ser necessri o desati var a
comuni cao. Se a comuni cao esti ver ati va no E3 Studi o, possvel abri r uma
janel a de i nformaes sobre o servi dor sel eci onado (ao sel eci onar a opo
Informaes sobre o servidor no menu contextual do objeto). Caso a conexo no
esteja estabel eci da, por qual quer moti vo, esta janel a mostra pontos de
i nterrogao no l ugar das i nformaes.
4.4.2 Objeto Consulta
Para confi gurar um objeto Consul ta para buscar dados em um servi dor OPC UA
uti l i zando o Dri ver OPC UA, si ga estes procedi mentos:
1. Sel eci one o Dri ver OPC UA na janel a Defi na o Servi dor de Banco de Dados da
Consul ta.
Selecionar Driver OPC UA
2. A janel a a segui r ser mostrada, permi ti ndo confi gurar a Consul ta.
Drivers 189
Aba Campos
As opes di sponvei s na aba Campos esto descri tas na tabel a a segui r.
Opes disponveis na aba Campos
OPO DESCRIO
Dados Brutos
A Consul ta retorna os dados como so
armazenados no servi dor, semel hante
consul ta CompressedDataStartEndTime do
objeto Storage. Neste modo, apenas um
Tag pode ser consul tado por vez,
retornando tambm a qual i dade do
val or.
190 Drivers
OPO DESCRIO
Dados Processados
A Consul ta retorna dados agregados
dentro de um i nterval o de tempo,
semel hante s consul tas SampledData e
CalculatedData do objeto Storage. Neste
modo, vri os Tags podem ser
consul tados por vez, mas no retornam
a qual i dade do val or. Di versas funes
de agregao podem ser uti l i zadas,
como por exempl o mdi as, mxi mos,
i nterpol aes, etc. Funes di ferentes
podem ser usadas para cada Tag e um
mesmo Tag pode aparecer vri as vezes
na Consul ta, com funes de agregao
di ferentes. O E3 apenas l i sta as funes
padro, sem buscar funes especfi cas
do servi dor ou fi l trar funes no
suportadas pel o servi dor. A Consul ta
pode fal har caso seja sel eci onada uma
funo no suportada pel o servi dor OPC
UA.
Adi ci ona um ou mai s Tags do servi dor
OPC UA.
Remove o Tag sel eci onado da Consul ta.
Fora a atual i zao dos I denti fi cadores
de Ns OPC UA (NodeI ds).
Id
Ti po de I denti fi cador de N OPC UA
(NodeI d) no servi dor.
Colunas
Cami nho do Tag no servi dor OPC UA.
Ttulo
Nome do Tag no servi dor OPC UA.
Funo
Funo uti l i zada no Tag. Esta col una s
est di sponvel quando a opo Dados
Processados est sel eci onada.
Ao cl i car em , a janel a a segui r mostrada, permi ti ndo sel eci onar os Tags
exi stentes no servi dor.
Drivers 191
Seleo de Tags OPC UA
As abas Variveis e Visualizar tm o mesmo comportamento descri to no captul o
Consultas.
4.4.3 Certificados
Durante a i nstal ao do E3, i nstal ado um certi fi cado rel ati vo i nstnci a do
cl i ente OPC UA do E3. Este certi fi cado necessri o sempre que for uti l i zada uma
conexo com o servi dor cujo modo de segurana (propri edade SecurityMode) no
seja i gual a None (ou seja, uma conexo OPC UA segura).
Este certi fi cado pode ser encontrado na pasta Certi fi cateStore/certs da i nstal ao
do E3, em um arqui vo chamado El i pse E3 UA Cl i ent [xxx].der, onde xxx um cdi go
gerado al eatori amente.
Se o certi fi cado for apagado, um novo ser gerado automati camente sempre o
Dri ver OPC UA tentar estabel ecer uma conexo com um servi dor.
192 Drivers
NOTAS:
Apagar o certi fi cado pode si gni fi car ter que atual i zar os servi dores OPC UA com o
novo certi fi cado, ou ento a conexo segura com o cl i ente do E3 pode ser
negada.
Este certi fi cado corresponde i nstnci a do cl i ente, e no ao cl i ente OPC UA do
E3, ou seja, el e NO pode ser copi ado de uma mqui na para outra. Cada
i nstal ao tem um certi fi cado ni co.
O cl i ente OPC UA do E3 acei ta qual quer certi fi cado vl i do de servi dor, ou seja,
no necessri a nenhuma confi gurao para que o cl i ente do E3 acei te uma
determi nada i nstnci a de servi dor OPC UA.
4.4.4 Limitaes na Leitura de Tipos de Dados
O Dri ver de Comuni cao OPC UA do E3 suporta ti pos bsi cos e vetores de uma
di menso, bem como al guns ti pos de estruturas defi ni das pel o padro OPC UA. So
suportados val ores escal ares e vetores dos segui ntes ti pos:
Tipos suportados plenamente: SByte, Byte, Int16, UInt16, Int32, UInt32, Int64,
UInt64, Float, Double, Boolean, String, DateTime e ByteString
Tipos suportados com limitaes: DataValue (i gnora o timestamp e a qual i dade),
LocalizedText (i gnora a confi gurao regi onal ), QualifiedName (i gnora o
NamespaceIndex), StatusCode (converti do para SCode ou HRESULT), Guid
(converti do para texto)
Tipos suportados convertidos para vetores de uma dimenso de tamanho fixo:
Estes ti pos de dados so retornados como vetores de Variants, em que cada um
dos campos um i tem do vetor. Se o campo for outro objeto, o Variant conter
outro vetor, e assi m por di ante. Os ti pos suportados so
ServerDiagnosticsSummaryDataType, SubscriptionDiagnosticsDataType,
SessionSecurityDiagnosticsDataType, SessionDiagnosticsDataType,
ApplicationDescription, Argument, BuildInfo, ServiceCounterDataType,
ExpandedNodeId e NodeId
Nos campos da consul ta, o texto dos cami nhos dos Tags do servi dor segue o
padro OPC UA de cami nhos rel ati vos. Os componentes deste cami nho so os
segui ntes:
/ (barra): Indi ca uma refernci a hi errqui ca qual quer
. (ponto): Indi ca uma refernci a de agregao qual quer
[ns:]browse-name: A String que segue uma barra ou ponto especi fi ca o nome de
browse de um i tem. Este nome pode ser prefi xado com seu ndi ce de Namespace.
Se for omi ti do, assumi do o ndi ce 0 (zero)
& (e comercial, caractere de escape): Insere um caractere reservado no l ocal . Por
exempl o, a expresso "&/Nome" substi tuda por "/Nome". Os caracteres
reservados so os segui ntes:
Drivers 193
/ (barra)
. (ponto)
< (menor que)
> (mai or que)
: (doi s pontos)
# (si nal numri co)
! (ponto de excl amao)
& (e comerci al )
A defi ni o formal de um cami nho OPC UA, em notao BNF, a segui nte:
<caminho-relativo> ::= <tipo-referencia> <nome-browse>
[caminho-relativo]
<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 Identi fi cadores de Ns OPC UA (NodeIds) que no sejam do
servi dor onde executado o browse dos Tags (servi dores Gateway). Estes Tags,
portanto, no sero mostrados na janel a de sel eo de servi dores. Al m di sso, os
cami nhos so sempre hi errqui cos e apenas os ti pos de refernci a barra (/) e
ponto (.) so suportados (o ti po <nome-browse> no suportado).
4.5 Qualidade
Os campos de qual i dade representam o estado da qual i dade do val or do i tem.
formado de uma pal avra de 16 bi ts, sendo que os pri mei ros oi to bi ts so defi ni dos
na forma de trs campos de bi ts: Qualidade, Substatus e Limite.
Os outros oi to bi ts (de mai or ordem) esto di sponvei s para uso de cada
fabri cante. Se esses bi ts forem uti l i zados, os bi ts de qual i dade padro ai nda so
uti l i zados para i ndi car quai s dedues pode-se fazer sobre os dados retornados.
Assi m, de responsabi l i dade do cl i ente i nterpretar o campo de i nformaes
especfi cas de qual i dade, para garanti r que o servi dor que est provendo essa
i nformao usa as mesmas regras que o cl i ente.
194 Drivers
Opes disponveis no campo Qualidade
QUALIDADE CAMPO QUALIDADE DESCRIO
0 - 63
Rui m
O val or no ti l pel as
razes i ndi cadas no
campo Substatus.
64 - 127
I ncerta
A qual i dade do val or
i ncerta pel as razes
i ndi cadas no campo
Substatus.
128 - 191
(Reservado)
No usado pel o padro
OPC.
192 - 255
Boa
A qual i dade do val or
boa.
Um servi dor que no suporta i nformao de qual i dade retorna 192 sempre (Bom).
Tambm acei tvel que um servi dor retorne si mpl esmente Rui m ou Bom (0 ou 192)
e sempre retorne 0 (zero) para o Substatus e para o Limite.
4.5.1 Campo Substatus
O l ayout deste campo depende do val or do campo Qualidade.
Substatus para Qualidade RUIM
SUBSTATUS DESCRIO LIMITE
SEM LIMITE BAIXO ALTO CONSTANTE
No especfico
O val or
rui m, mas
nenhuma
razo
especi fi ca
conheci da.
0 1 2 3
Erro de
Configurao
H al gum
probl ema de
confi gurao
especfi co no
servi dor. Por
exempl o, o
i tem em
questo
pode ter si do
apagado.
4 5 6 7
Drivers 195
No Conectado
A entrada
deveri a estar
l ogi camente
conectada a
al go, mas
no est.
Esta
qual i dade
pode refl eti r
que no h
val or
di sponvel
neste
momento,
por razes
como o val or
pode no ter
si do
forneci do
pel a fonte de
dados.
8 9 10 11
Falha de
Dispositivo
Uma fal ha de
di sposi ti vo
foi
detectada.
12 13 14 15
Falha de
Sensor
Uma fal ha de
sensor foi
detectada (o
campo Limite
pode prover
i nformao
adi ci onal ).
16 17 18 19
ltimo valor
conhecido
Comuni cao
em fal ha.
Entretanto, o
ul ti mo val or
conheci do
est
di sponvel .
Note que a
i dade do
val or pode
ser
determi nada
pel a
propri edade
TimeStamp.
20 21 22 23
196 Drivers
Falha de
Comunicao
Comuni cae
s esto em
fal ha. No h
l ti mo val or
conheci do
di sponvel .
24 25 26 27
Fora de
Servio
O Bl oco est
fora de scan
ou trancado.
28 29 30 31
N/A
No
uti l i zado.
32 - 63
Substatus para Qualidade INCERTA
No especfico
No h razo
especfi ca.
64 65 66 67
Drivers 197
ltimo valor
utilizvel
O di sposi ti vo
que estava
provi denci an
do o val or
parou de
faz-l o. O
val or
retornado
deve ser
consi derado
velho. Note
que i sso
di fere de um
val or Rui m
com o
Substatus 5
(l ti mo val or
conheci do).
Aquel e
estado
associ ado
com uma
fal ha
detectvel de
comuni cao
em um val or
buscado.
Este erro
associ ado
com a fal ha
de al guma
fonte externa
que i ri a
i nseri r al go
no val or
dentro de um
perodo
acei tvel .
Note que a
i dade do
val or pode
ser
determi nada
na
propri edade
TimeStamp.
68 69 70 71
No utilizado
No
uti l i zado.
72 - 79
198 Drivers
Sensor
impreciso
O Val or est
col ado em
um dos
l i mi tes do
sensor
(nesse caso
o campo
Limite deve
estar
confi gurado
para 1 ou 2)
ou o sensor
est de
al gum modo
conheci do
fora de
cal i brao
vi a al gum
di agnsti co
i nterno
(nesse caso
o campo
Limite deve
ser zero).
80 81 82 83
Unidade de
engenharia
excedida
O val or
retornado
est fora dos
l i mi tes
defi ni dos
para esse
parmetro.
Note que
nesse caso o
val or do
campo Limite
i ndi ca quai s
l i mi tes foram
excedi dos,
mas no
necessari am
ente i mpl i ca
que o val or
no possa i r
mai s al m
da fai xa
especi fi cada.
84 85 86 87
Drivers 199
Subnormal
O val or
deri vado de
ml ti pl as
fontes e h
um nmero
menor do
que o
requeri do de
fontes boas.
88 89 90 91
No utilizado
No
uti l i zado.
92 - 127
NOTA: Servi dores que no suportam o Substatus devem retornar zero.
Substatus para Qualidade BOA
No especfico
O val or
bom. No h
condi es
especi ai s.
192 193 194 195
No utilizado
No
uti l i zado.
196 - 215
Forado
localmente
Ti pi camente
i ndi ca que a
entrada foi
desconectad
a e um val or
entrado
manual ment
e foi forado.
216 217 218 219
No especfico
No
uti l i zado.
220 - 255
NOTA: Servi dores que no suportam o Substatus devem retornar zero.
4.5.2 Campo Limite
O campo Limite vl i do i ndependente dos campos Qualidade e Substatus. Em
al guns casos, como uma fal ha de sensor, el e pode prover i nformaes de
di agnsti co.
200 Drivers
Campo Limite
ESPECIFICAO DESCRIO
No Limitado
O val or l i vre para mover-se aci ma ou
abai xo.
Limite Inferior
O val or est l i mi tado em al gum val or
i nferi or.
Limite Superior
O val or est l i mi tado em al gum val or
superi or.
Constante
O val or uma constante e no pode
mover-se.
NOTA: Servi dores que no suportam o campo Limite devem retornar zero.
Quadros 201
5
Quadros
CAPTULO
O objeto Quadro uti l i zado para organi zar e estruturar a i nterface do projeto,
cri ando vi sual i zaes compostas para o usuri o dentro da janel a pri nci pal do
Vi ewer ou do navegador. Mui tas vezes, uma apl i cao requer apenas uma Tel a
pri nci pal , que a porta de entrada para a apl i cao. A parti r da, o usuri o pode
navegar por outras Tel as, que ocuparo o l ugar da pri mei ra, formando uma ni ca
vi sual i zao do processo. Porm, possvel suportar mai s de uma vi sual i zao em
um mesmo documento ou projeto. Isto se torna ti l no caso de uma apl i cao que
uti l i ze uma Tel a que nunca muda, ou que muda pouco (como, por exempl o, um
menu), e outra parte que a navegao das Tel as propri amente di tas. Para uti l i zar
este recurso, execute os procedi mentos a segui r.
1. Cl i que com o boto di rei to do mouse no nome do projeto no Expl orer e
sel eci one a opo Inserir - Quadro. No modo Domnio, cl i que com o boto
di rei to do mouse no i tem Visualizao - Viewer e Quadros, sel eci one a opo
Inserir Quadro em e l ogo aps o nome do projeto desejado.
Inserindo um Quadro no modo Domnio
O Quadro possui subdi vi ses, chamadas de Divisores, que podem ser i nseri das ou
removi das do Quadro atravs de um menu no boto di rei to do mouse na view de
Desi gn. A pri ncpi o, o Quadro possui um Di vi sor i ni ci al , que pode ser subdi vi di do
hori zontal ou verti cal mente em doi s Di vi sores, que por sua vez tambm podem ser
subdi vi di dos em outros doi s Di vi sores, e assi m sucessi vamente.
202 Quadros
A cada par de novos Di vi sores cri ados pel as opes Dividir Horizontalmente e
Dividir Verticalmente, h sempre um Di vi sor Pri nci pal e um Di vi sor Secundri o.
Apenas o Di vi sor Pri nci pal ter val ores que defi nem expl i ci tamente o seu
posi ci onamento, fi cando o Di vi sor Secundri o com o val or restante.
Assi m, quando o Di vi sor subdi vi di do hori zontal mente, sua propri edade
SplitDockPosition recebe o val or dockTop; do mesmo modo, se a subdi vi so for
verti cal , esta propri edade receber o val or dockLeft. A propri edade do Di vi sor
Secundri o receber, ento, o val or dockRemaining, si gni fi cando que este ocupar
o espao que sobra.
Os cones dos objetos no Organi zer i denti fi cam exatamente o posi ci onamento de
cada Di vi sor.
Posicionamento do Divisor
CONE DESCRIO
dockBottom: este Di vi sor est
posi ci onado na parte i nferi or do Di vi sor
Pai .
dockTop: este Di vi sor est posi ci onado
na parte superi or do Di vi sor Pai .
dockLeft: este Di vi sor est posi ci onado
esquerda do Di vi sor Pai .
dockRight: este Di vi sor est posi ci onado
di rei ta do Di vi sor Pai .
dockRemaining: este Di vi sor ocupa o
espao restante aps o posi ci onamento
de seu Di vi sor I rmo.
Cada Di vi sor corresponde vi sual i zao de uma Tel a ou Quadro de seu processo
ou a uma URL (Uniform Resource Locator). Para uti l i zar este recurso, execute os
procedi mentos a segui r.
1. Cl i que com o boto di rei to do mouse sobre o Quadro aberto e sel eci one uma
das opes: Dividir Horizontalmente ou Dividir Verticalmente, conforme o ti po
de di vi so desejada.
Quadros 203
Inserindo um Divisor horizontal
2. Para remover um Di vi sor, cl i que com o boto di rei to do mouse sobre o Quadro
aberto e sel eci one a opo Remover Quadro.
3. possvel i nverter a sel eo ori gi nal dos Di vi sores (transformar o Di vi sor
Pri nci pal em Di vi sor Secundri o, e vi ce-versa) atravs deste mesmo menu. No
caso de um Di vi sor Pri nci pal , cl i que com o boto di rei to do mouse no Quadro e
sel eci one a opo Configurar como Divisor Secundrio; no caso de um Di vi sor
Secundri o, sel eci one a opo Configurar como Divisor Principal. A propri edade
SplitDockPosition dos Di vi sores ser automati camente confi gurada para
refl eti r esta mudana.
4. Com a opo Selecionar Tela ou Quadro, possvel escol her a Tel a ou Quadro
que ser associ ada propri edade SplitLink do Di vi sor sel eci onado, usando o
AppBrowser.
5. Pode-se i nseri r vri os Di vi sores no Quadro.
204 Quadros
Divisores do Quadro
6. Para confi gurar os Di vi sores do Quadro, cl i que com o boto di rei to do mouse
no Organi zer sobre o Di vi sor desejado e sel eci one a opo Propriedades.
Quadros 205
Configuraes do Quadro
Opes disponveis na aba Quadro
OPO DESCRIO
Tela ou Quadro
Determi na o cami nho da Tel a ou Quadro
que o Di vi sor i r abri r. S ser habi l i tado
se o Di vi sor no ti ver nenhum fi l ho. Este
campo equi val e propri edade SplitLink.
Posicionamento
Determi na a posi o do Di vi sor no
Quadro. Este campo equi val e
propri edade SplitDockPosition.
Valor
Determi na o val or que ser atri budo ao
Quadro. S ter efei to vi sual se for
modi fi cada no Di vi sor Pri nci pal . Este
campo equi val e propri edade SplitValue.
Al gumas das propri edades do Quadro ou Di vi sor podem ser confi guradas atravs
da Li sta de Propri edades, sem a necessi dade da cri ao de scri pts para i sto. Caso
haja a necessi dade de confi gurar al guma propri edade, basta l ocal i z-l a na Li sta de
206 Viewer
6
Viewer
CAPTULO
O objeto Viewer di sponi bi l i za a vi sual i zao da apl i cao. Permi te vi sual i zar
Tel as do projeto em modo de execuo e a operao do si stema. O Vi ewer pode ser
rodado a parti r de qual quer ponto da rede que tenha acesso ao E3 Server. No
necessri o copi ar o apl i cati vo para os outros Vi ewers, poi s as Tel as e bi tmaps so
bai xados conforme a necessi dade em tempo de execuo. S poder exi sti r um
objeto Vi ewer em um Domni o.
Viewer no modo Domnio
Para cri ar um Vi ewer no projeto, si ga estes procedi mentos:
1. Veri fi que se j exi ste um Vi ewer em seu Domni o, ou i nsi ra um novo cl i cando
com o boto di rei to do mouse no nome do projeto no Expl orer e sel eci onando a
opo Inserir - Viewer. No modo Domnio, cl i que com o boto di rei to do mouse
no i tem Visualizao - Viewer e Quadros, sel eci one a opo Inserir Viewer em e
l ogo aps o nome do projeto desejado.
NOTA: A qual i dade grfi ca das Tel as pode ser modi fi cada, em tempo de execuo,
uti l i zando-se o menu contextual do Vi ewer e sel eci onando uma das opes do
menu Qualidade (todas as telas). Para mai ores i nformaes, veja a propri edade
RenderQuality do Vi ewer no Manual de Scripts.
Viewer 207
6.1 Configurao
Atravs das propri edades do Vi ewer, possvel especi fi car confi guraes do
Vi ewer, Erros de comuni cao, cri ar associ aes ou scri pts.
6.1.1 Visualizador
Atravs da aba Visualizador, so confi guradas as opes do Vi ewer quanto a ttul o,
Tel a e zoom, conforme expl i cado a segui r.
Aba Visualizador
Cada campo da aba Visualizador possui uma propri edade correspondente. As
opes di sponvei s so as segui ntes:
Opes disponveis na aba Visualizador
OPO DESCRIO
Ttulo
Determi na o ttul o do Vi ewer. Este campo
equi val e propri edade Caption do objeto
Vi ewer.
208 Viewer
OPO DESCRIO
Tela ou Quadro Inicial
Determi na a Tel a ou Quadro que o Vi ewer
i r i ni ci ar. Cl i cando em , o si stema
abre uma janel a de confi gurao, pel a
qual chamar o AppBrowser, onde ser
especi fi cada a Tel a i ni ci al de
vi sual i zao do si stema. Este campo
equi val e propri edade InitialScreen do
objeto Vi ewer.
Zoom
Determi na o nvel de zoom para
vi sual i zao no Vi ewer. Atravs das suas
opes, possvel confi gurar como o
Vi ewer ser i ni ci al i zado. Este campo
equi val e propri edade InitialScreen do
objeto Vi ewer, e representado pel as
especi fi caes aps o caractere "?". Por
exempl o, se na Tel a i ni ci al o zoom de
100%, na propri edade InitialScreen
aparecer descri o TelaInicial?100,
onde TelaInicial o nome da Tel a e ?
100 a sua percentagem de zoom.
Habilitar barra de rolagem na Tela Inicial
Habi l i ta a barra de rol agem na pgi na
i ni ci al .
Exibir o menu do Zoom ao clicar com o
boto direito do mouse
Habi l i ta a exi bi o do menu Zoom com o
boto di rei to do mouse, em tempo de
execuo. Este campo equi val e
propri edade EnableZoomMenu do objeto
Vi ewer.
Manter Telas carregadas na memria
Habi l i ta o Vi ewer a manter as Tel as
carregadas em memri a. Este campo
equi val e propri edade CacheEnable do
objeto Vi ewer.
Verificar inatividade aps ... minutos
Defi ne o tempo mxi mo de espera, em
mi nutos, por um evento de mouse ou de
tecl ado para o perodo de i nati vi dade.
Este campo equi val e propri edade
EnableInactivity do objeto Vi ewer.
Nmero de retentativas para confirmao
de usurio ou senha
Estabel ece o nmero de vezes que a cai xa
de di l ogo de login ser exi bi da al m da
pri mei ra vez. Este campo equi val e
propri edade LoginRetries do objeto Vi ewer.
6.1.2 Configurao
Atravs da aba Configurao, pode-se edi tar as opes rel ati vas janel a, ao ttul o e
resol uo do Vi ewer.
Viewer 209
Aba Configurao
Cada campo da aba Configurao possui uma propri edade correspondente. As
210 Viewer
Opes disponveis na aba Configurao
OPO DESCRIO
Iniciar Maximizada / Minimizada /
Janelada
Determi na o esti l o da janel a do Vi ewer.
WindowStyle e possui as segui ntes opes:
0 - Maximized: A Tel a i ni ci a maxi mi zada
1 - Windowed: Esti l o janel ada, i sto ,
pode ser confi gurada a al tura e a l argura
da Tel a
2 - Minimized: A Tel a i ni ci a mi ni mi zada
Desabilitar troca de janelas
Desabi l i ta a troca de janel as. Este campo
equi val e propri edade
DisableTaskSwitching do objeto Vi ewer. Esta
opo pode ser modi fi cada em tempo de
execuo usando o mtodo
SetDisableTaskSwitching.
Barra de ttulo
Habi l i ta a barra de ttul o. Este campo
equi val e propri edade TitleBar do objeto
Vi ewer.
Boto de fechar
Habi l i ta o boto de fechar. Este campo
equi val e propri edade CloseButton do
objeto Vi ewer.
Boto de minimizar
Habi l i ta o boto de mi ni mi zar. Este campo
equi val e propri edade MinimizeButton do
objeto Vi ewer.
Boto de maximizar
Habi l i ta o boto de maxi mi zar. Este campo
equi val e propri edade MaximizeButton do
objeto Vi ewer.
Borda
Habi l i ta uma borda na janel a do Vi ewer.
WindowBorder do objeto Vi ewer.
Opo de redimensionar
I ndi ca se a janel a pode ser
redi mensi onada. Esta opo s tem
val i dade se a opo Borda esti ver marcada.
WindowResizable do objeto Vi ewer.
Opo de mover
I ndi ca se a janel a pode ser movi da. Este
campo equi val e propri edade
WindowMovable do objeto Vi ewer.
Ficar sempre no topo
I ndi ca se a janel a deve sempre se sobrepor
s outras janel as. Este campo equi val e
propri edade WindowStayOnTop do objeto
Vi ewer.
Barra de ttulo menor
Habi l i ta uma barra de ttul os pequena na
janel a. Esta opo s tem efei to se a
opo Barra de ttulo esti ver marcada. Este
WindowSmallTitle do objeto Vi ewer.
Viewer 211
OPO DESCRIO
Resoluo da Tela
Sel eci ona a resol uo da Tel a: 640 x 480,
800 x 600, 1024 x 768, 1280 x 1024, ou 1600 x
1200 pi xel s.
Avanado
Abre a janel a para confi guraes
avanadas.
Ao cl i car em Avanado, a segui nte janel a aberta:
Configuraes avanadas
Opes disponveis na janela Configuraes avanadas
OPO DESCRIO
Resoluo da Tela em pixels
Permi te escol her entre a resol uo atual
do computador ou uma resol uo
escol hi da pel o usuri o, em pi xel s.
212 Viewer
OPO DESCRIO
Desconto na resoluo da Tela em pixels
Permi te escol her o desconto apl i cado na
resol uo da Tel a entre a confi gurao
atual do computador ou uma resol uo
escol hi da pel o usuri o, em pi xel s.
Resoluo do monitor em pontos por
polegada (DPI)
Permi te escol her entre a resol uo atual
do computador ou um resol uo
escol hi da pel o usuri o, em pontos por
pol egada (DPI ).
6.1.3 Erros de Comunicao
No Vi ewer, possvel vi sual i zar os erros de comuni cao dos Tags quando estes
esti verem associ ados a Di spl ays ou Setpoi nts. Isto possvel confi gurando as
i nformaes conti das na aba Erros de Comunicao, di sponvel nas propri edades
do Vi ewer.
Aba Erros de comunicao
Opes disponveis na aba Erros de Comunicao
OPO DESCRIO
Visualizar erros de comunicao
Habi l i ta ou desabi l i ta a vi sual i zao dos
erros de comuni cao.
Texto
Contm o texto que ser mostrado no
Setpoi nt, caso a qual i dade do val or seja
rui m.
Viewer 213
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
Setpoi nt. Equi val e a uma al terao da
propri edade ForegroundColor do Setpoi nt,
mas essa al terao no fei ta
efeti vamente. O val or da propri edade do
Setpoi nt no al terado.
6.2 Variveis no Viewer
No objeto Vi ewer possvel fazer associ aes com objetos a parti r de Tel as, bem
como us-l os vi a scri pts. Tambm possvel i nseri r Tags Demo ou Internos no
Vi ewer. Atravs do AppBrowser, pode-se executar as segui ntes aes:
Acessar o objeto Vi ewer ou al gum de seus fi l hos a parti r de uma Tel a ou control e
de Tel a (Associ aes ou scri pts)
Os fi l hos do objeto Vi ewer acessarem outros fi l hos do Vi ewer ou o prpri o
Vi ewer (Associ aes ou scri pts)
O prpri o objeto Vi ewer acessar seus fi l hos (Associ aes ou scri pts)
i mportante sal i entar que a associ ao para o Vi ewer deve l evar o nome real do
Vi ewer (por exempl o, Viewer1) e no si mpl esmente Application. Em scri pts,
ai nda val e o uso de Application, que uma propri edade de todos os objetos que
retornam o Vi ewer.
6.3 Objeto _top
Quando um Vi ewer i nseri do no projeto, di sponi bi l i za um Frame fi l ho. Este Frame
fi l ho chamado de _top. Este objeto possui as mesmas funci onal i dades do objeto
Di vi sor do Quadro. Para uti l i zar este recurso, si ga estes procedi mentos:
1. Cl i que no objeto Vi ewer. O Vi ewer mostrar o seu fi l ho nomeado _top.
214 Viewer
Objeto _top
2. Para confi gurar as propri edades do objeto _top, cl i que com o boto di rei to do
mouse sobre el e e sel eci one a opo Propriedades.
3. Este objeto possui as mesmas funci onal i dades do objeto Di vi sor do Quadro, e
tai s i nformaes podem ser encontradas nos captul os Telas e Quadros.
6.4 Pasta do Viewer
A Pasta do Viewer defi ne grupos dentro do objeto Vi ewer de forma a organi zar os
Tags do Vi ewer (Contador, Demo, Interno e Ti mer). Caso haja necessi dade, novas
Pastas podem ser i nseri das dentro de outras. Para uti l i zar este recurso, si ga este
procedi mento:
1. Cl i que com o boto di rei to do mouse sobre o Vi ewer e sel eci one a opo Inserir
- Pasta do Viewer.
Viewer 215
Inserindo Pasta do Viewer
NOTA: Uma apl i cao que contenha Pastas do Vi ewer no poder ser aberta em
verses do E3 anteri ores verso 3.1.
216 Telas e Objetos de Tela
7
Telas e Objetos de Tela
CAPTULO
Telas so janel as para moni toramento de processos. Em cada Tel a so i nseri dos
objetos que faro a i nterface do operador com o si stema, chamados Objetos de
Tela. Cada apl i cao pode ter um nmero i l i mi tado de Tel as e de objetos de Tel a.
7.1 Tela
A Tela o objeto bsi co de i nterface com o usuri o, e pode conter vri os ti pos de
objetos. Os grfi cos i nseri dos na Tel a podem ser apagados, copi ados, movi dos,
redi mensi onados, agrupados ou confi gurados.
Para i nseri r uma Tel a no projeto, cl i que com o boto di rei to do mouse no nome do
projeto no Expl orer e sel eci one a opo Inserir - Tela. No modo Domnio, cl i que com
o boto di rei to do mouse no i tem Visualizao - Telas, sel eci one a opo Inserir Tela
em e l ogo aps o nome do projeto desejado.
Inserindo um Tela no modo Domnio
Quando uma nova Tel a cri ada, ou quando sel eci onada a opo Ajustar ao
Divisor em uma Tel a j exi stente, a segui nte janel a mostrada para confi gurao
do tamanho do objeto:
Telas e Objetos de Tela 217
Configurando o tamanho da Tela
Opes disponveis na janela Configurando o tamanho da Tela
OPO DESCRIO
Escolha o Divisor onde a Tela ser aberta
Permi te escol her o Di vi sor onde a Tel a
ser aberta. So l i stados apenas os
Di vi sores cuja Tel a associ ada
propri edade SplitLink ser vi svel em
tempo de execuo.
Configurar como Tela inicial do Divisor
Habi l i ta a Tel a como Tel a I ni ci al do
Di vi sor onde ser aberta.
Nome
Determi na o nome da Tel a.
Largura
Determi na a l argura da Tel a, em pi xel s.
Altura
Determi na a al tura da Tel a, em pi xel s.
As opes Largura e Altura estaro i ni ci al mente preenchi das com o tamanho que a
Tel a deve ter para poder ser exi bi da no Di vi sor escol hi do, sem que aparea a barra
de rol agem. Se al gum dos val ores for negati vo, i sto i ndi ca que o Di vi sor no estar
vi svel em tempo de execuo, em funo da confi gurao do Vi ewer e do tamanho
dos outros Di vi sores.
O E3 Studi o fornece um edi tor dos objetos que podem ser i nseri dos em uma Tel a.
Esto di sponvei s os segui ntes objetos: Li nha, Retngul o, Retngul o Arredondado,
El i pse, Arco de El i pse, Desenho Li vre, Pol gono, Pol gono de Curvas, Fi gura
(Imagem), Texto, Di spl ay, SetPoi nt, Escal a e MSForms. Os MSForms sero di scuti dos
no prxi mo captul o (ActiveX); os demai s objetos ci tados sero apresentados neste
captul o.
Tela
Pode-se confi gurar as propri edades da Tel a para determi nar tamanho, cor e outros
aspectos do comportamento e da aparnci a, al m de vri os ti pos de eventos. Estes
objetos uti l i zam como padro para o tamanho e coordenadas as uni dades
HIMETRIC, dadas em 1/100 mm, e no em pi xel s.
Todas das propri edades da Tel a podem ser confi guradas atravs da Li sta de
Propri edades, sem a necessi dade de se cri ar scri pts para i sto. Caso necessi te
os devi dos ajustes.
NOTA: A qual i dade grfi ca de uma Tel a pode ser modi fi cada, em tempo de
execuo, uti l i zando-se o menu contextual do Vi ewer e sel eci onando uma das
opes do menu Qualidade (esta tela). Para mai ores i nformaes, veja a propri edade
RenderQuality da Tel a no Manual de Scripts.
7.2 Objetos de Tela
Os segui ntes objetos podem ser i nseri dos em uma Tel a:
Pri mi ti vas do Edi tor Grfi co (Retas, Crcul os, Retngul os, Pol gonos, etc.)
Control es Acti veX forneci dos pel a El i pse (E3Al arm, E3Chart, E3Browser)
Control es Acti veX forneci dos por tercei ros
Imagens no vetori ai s (Arqui vos BMP, JPG, GIF, etc.)
Imagens vetori ai s (Arqui vos WMF, EMF, etc.)
Control es Padro do Wi ndows (Li sta, Edi tor de Texto, Li sta de Sel eo, etc.)
El i pseX, compostos de qual quer dos objetos aci ma
As pri mi ti vas do edi tor grfi co di sponvei s no si stema so l i stadas nas prxi mas
sees. El as podem ser rotaci onadas ou redi mensi onadas l i vremente, exceto pel o
objeto Fi gura. Aps ter si do cri ado, cada objeto permanece sel eci onado para
faci l i tar a edi o de suas propri edades, caso seja necessri o.
7.2.1 Linha
Permi te o desenho de retas, l i gando doi s pontos especi fi cados na sua cri ao. Para
uti l i zar este objeto, si ga estes procedi mentos:
1. Sel eci one a Li nha na barra de ferramentas Tela.
2. Cl i que na Tel a para cri ar o ponto de ori gem da reta e arraste o mouse at seu
ponto fi nal .
7.2.2 Conector
Este objeto uti l i zado para conectar doi s ou mai s objetos de Tel a atravs de uma
l i nha. Os objetos de Tel a que podem ser conectados so o Retngul o, o Retngul o
Arredondado, a El i pse, o Arco de El i pse, o Desenho Li vre, o Pol gono e o Pol gono de
Curvas. Ao cl i car em na barra de ferramentas Tela, os objetos anteri ormente
ci tados mostraro seus pontos de conexo, como na fi gura a segui r.
Pontos de conexo de objetos de Tela
Para conectar doi s objetos, basta cl i car sobre um dos pontos de conexo do
pri mei ro objeto e, em segui da, cl i car sobre um dos pontos de conexo do segundo
objeto. Sempre que se passa o mouse sobre um ponto de conexo, seu cone muda
de para , i ndi cando qual ponto ser conectado.
Aps a cri ao do Conector, tambm possvel desconectar seus vrti ces. Para
i sso, arraste o vrti ce para l onge do ponto de conexo do objeto. Para reconectar,
arraste-o para perto de um ponto de conexo at que seu cone mude para .
Para cri ar uma conexo entre mai s de doi s pontos de conexo, basta manter
pressi onada a tecl a CTRL enquanto se sel eci ona todos os pontos desejados.
Para excl ui r um Conector, basta sel eci on-l o e uti l i zar a tecl a DELETE. Se um objeto
que possua um Conector for excl udo, o Conector no excl udo.
Para i nformaes sobre Conectores em objetos XControl , veja a seo a segui r.
7.2.2.1 Conectores em XControls
Os Conectores em objetos de Tel a cri ados dentro de XControl s devem ter seus
pontos de conexo defi ni dos previ amente, cl i cando-se em na barra de
ferramentas Tela. Ao sel eci onar esta ferramenta e cl i car em um ponto de conexo, a
segui nte janel a aberta:
Janela de edio de pontos de conexo
As opes di sponvei s nesta janel a esto descri tas na tabel a a segui r.
Opes disponveis na janela Novo Ponto de Conexo
OPO DESCRIO
Nome do Ponto de Conexo
Permi te defi ni r um nome para o Ponto de
Conexo.
Conectado a
Mostra em qual Ponto de Conexo do
objeto de Tel a o Ponto de Conexo do
XControl est conectado.
Utilizar como "Ponto ncora" do objeto
Marca este Ponto de Conexo como o
ponto ncora do objeto. Este ponto
ncora pode ser al terado quando o
XControl for i nseri do em uma Tel a. Veja
tambm o tpi co Ponto ncora para
mai ores i nformaes.
Para edi tar ou excl ui r um ponto cri ado, cl i que com o boto di rei to do mouse sobre
o ponto e escol ha a opo Excluir Ponto de Conexo ou Editar Ponto de Conexo,
conforme a fi gura a segui r. Um ponto de conexo tambm pode ser excl udo
cl i cando-se sobre el e com a tecl a CTRL pressi onada.
Excluir ou editar um ponto de conexo
Caso no seja defi ni do nenhum Ponto de Conexo para os objetos de Tel a i ncl udos
no XControl , no ser possvel conectar este XControl a nenhum outro objeto de
Tel a, quando el e for i ncl udo em uma Tel a.
7.2.3 Retngulo
Permi te o desenho de retngul os, cri ados a parti r de doi s vrti ces. Para uti l i zar
este objeto, si ga estes procedi mentos:
1. Sel eci one o Retngul o na barra de ferramentas Tela.
2. Cl i que na Tel a para cri ar o vrti ce de ori gem do Retngul o e arraste o mouse
di agonal mente at seu vrti ce fi nal , at o desenho ati ngi r o tamanho e a
posi o desejados.
7.2.4 Retngulo Arredondado
Permi te o desenho de retngul os com cantos arredondados, cri ados a parti r de
doi s vrti ces. Para uti l i zar este objeto, si ga estes procedi mentos:
1. Sel eci one o Retngul o Arredondado na barra de ferramentas Tela.
2. Cl i que na Tel a para cri ar o vrti ce de ori gem do retngul o e arraste o mouse
di agonal mente at seu vrti ce fi nal , at o desenho ati ngi r o tamanho e a
posi o desejados.
3. No canto superi or esquerdo do objeto, aparecer o ponto responsvel pel o
fator de arredondamento do retngul o. Arraste-o mai s para o centro ou mai s
para as bordas para determi nar a curva de seus vrti ces.
7.2.5 Elipse
Permi te o desenho de crcul os e el i pses. Para uti l i zar este objeto, si ga estes
procedi mentos:
1. Sel eci one a El i pse na barra de ferramentas Tela.
2. Cl i que na Tel a para estabel ecer o ponto i ni ci al do desenho e arraste o mouse
di agonal mente at o desenho ati ngi r o tamanho e a posi o desejados.
7.2.6 Arco de Elipse
Permi te o desenho de objetos do ti po arco, corda ou torta. Para uti l i zar este objeto,
si ga estes procedi mentos:
1. Sel eci one o Arco de El i pse na barra de ferramentas Tela.
di agonal mente at o desenho ati ngi r o tamanho e a posi o desejados.
3. Nas duas extremi dades do corte, aparecero doi s pontos responsvei s pel a
posi o de abertura do desenho. Arraste-os de forma que o desenho fi que mai s
aberto ou mai s fechado.
4. O formato do desenho i ni ci al o de torta. Para al ter-l o para arco ou corda,
acesse a propri edade ArcStyle na Li sta de Propri edades.
7.2.7 Desenho Livre
Permi te a cri ao de desenhos mo l i vre. Para uti l i zar este objeto, si ga estes
procedi mentos:
1. Sel eci one o Desenho Li vre na barra de ferramentas Tela.
em qual quer di reo tantas vezes quantas forem necessri as para compl etar o
desenho desejado.
7.2.8 Polgono
Permi te o desenho de pol gonos com l ados retos. Para uti l i zar este objeto, si ga
1. Sel eci one o Pol gono na barra de ferramentas Tela.
2. Cl i que na Tel a para estabel ecer o vrti ce i ni ci al do desenho e arraste o mouse
desenho desejado.
3. Quando desejar trocar a di reo do desenho, d um cl i que si mpl es no mouse.
Quando desejar fi nal i z-l o, cl i que duas vezes.
7.2.9 Polgono de Curvas
Permi te o desenho de pol gonos com l ados curvos. Para uti l i zar este objeto, si ga
1. Sel eci one o Pol gono de Curvas na barra de ferramentas Tela.
2. Cl i que na Tel a para estabel ecer o vrti ce i ni ci al do desenho e arraste o mouse
desenho desejado.
3. Quando desejar trocar a di reo do desenho, d um cl i que si mpl es no mouse.
Quando desejar fi nal i z-l o, cl i que duas vezes.
7.2.10 Figura
Permi te mostrar i magens que estejam armazenadas em arqui vos, que podem ou
no pertencer apl i cao. A Fi gura pode ser redi mensi onada l i vremente, porm a
rotao s efeti va quando esta for um metafile converti do para smbol o. Os
segui ntes formatos de arqui vo so suportados: .bmp, .gi f, .jpg, .i co, .wmf e .emf.
Para uti l i zar este objeto, si ga estes procedi mentos:
1. Sel eci one a Fi gura na barra de ferramentas Tela.
2. Cl i que na Tel a para cri ar o vrti ce de ori gem do retngul o e arraste o mouse
di agonal mente at seu vrti ce fi nal .
3. O si stema abri r uma cai xa de di l ogo para sel eo do arqui vo de i magem,
conforme fi gura a segui r.
Seleo do arquivo de imagem
4. Sel eci one o arqui vo e cl i que em Abrir para i nseri r a fi gura na Tel a.
7.2.11 Texto
Permi te a cri ao de um texto que ser exi bi do na Tel a. Para uti l i zar este objeto,
1. Sel eci one o Texto na barra de ferramentas Tela.
2. Di gi te o texto desejado e pressi one a tecl a ENTER.
3. Caso quei ra al terar ou di gi tar contedos neste objeto, uti l i ze a propri edade
Value.
7.2.12 Display
Permi te cri ar um objeto que uti l i zado para mostrar os val ores dos Tags em tempo
de execuo. Para uti l i zar este objeto, si ga estes procedi mentos:
1. Sel eci one o Di spl ay na barra de ferramentas Tela.
2. Cl i que na Tel a para cri ar o vrti ce de ori gem do objeto e arraste o mouse
3. Cl i que com o boto di rei to do mouse no objeto para abri r a Janel a de
Propri edades. Na aba Item, escol ha o Tag a ser associ ado propri edade Value
do Di spl ay.
7.2.13 SetPoint
Permi te cri ar um objeto que funci ona como uma cai xa de edi o onde so
i nseri dos contedos a serem atri budos a Tags associ ados. Para uti l i zar este
objeto, si ga estes procedi mentos:
1. Sel eci one o SetPoi nt na barra de ferramentas Tela.
3. Cl i que com o boto di rei to do mouse no objeto para abri r a Janel a de
Propri edades. Na aba Item, escol ha o Tag a ser associ ado propri edade Value
do SetPoi nt.
7.2.14 Escala
Permi te a cri ao de um objeto que desenha rguas ou escal as de val ores. Para
uti l i zar este objeto, si ga estes procedi mentos:
1. Sel eci one a Escal a na barra de ferramentas Tela.
7.3 Configuraes Gerais
As segui ntes confi guraes podem ser apl i cadas Tel a ou aos seus objetos.
7.3.1 Alinhamento
Permi te al i nhar os objetos de Tel a entre si ou em rel ao Tel a. As opes de
al i nhamento di sponvei s so:
Opes de alinhamento para objetos de Tela
CONE OPO DESCRIO
Alinhar Esquerda
Al i nha doi s ou mai s
objetos entre si , tendo
como refernci a a
coordenada esquerda
do l ti mo objeto
sel eci onado.
Alinhar Direita
como refernci a a
coordenada di rei ta do
l ti mo objeto
sel eci onado.
CONE OPO DESCRIO
Alinhamento Superior
como refernci a a
coordenada superi or do
l ti mo objeto
sel eci onado.
Alinhamento Inferior
como refernci a a
coordenada i nferi or do
l ti mo objeto
sel eci onado.
Alinhamento Central
Horizontal
objetos hori zontal mente
entre si , tendo como
refernci a o l ti mo objeto
sel eci onado.
Alinhamento Central Vertical
objetos verti cal mente
entre si , tendo como
refernci a o l ti mo objeto
sel eci onado.
Mesma Largura
Apl i ca a l argura do l ti mo
objeto sel eci onado aos
demai s objetos
sel eci onados.
Mesma Altura
Apl i ca a al tura do l ti mo
objeto sel eci onado aos
demai s objetos
sel eci onados.
Mesmo Tamanho
Apl i ca a l argura e a al tura
do l ti mo objeto
sel eci onado aos demai s
objetos sel eci onados.
Centralizar Horizontalmente
Central i za o objeto na
Tel a, de acordo com suas
coordenadas hori zontai s.
Centralizar Verticalmente
Central i za o objeto na
Tel a, de acordo com suas
coordenadas verti cai s.
Distribuir Horizontalmente
Apl i ca a mesma di stnci a
hori zontal entre si a trs
ou mai s objetos.
Distribuir Verticalmente
Apl i ca a mesma di stnci a
verti cal entre si a trs ou
mai s objetos.
Espelhar Horizontalmente
Apl i ca o efei to de refl exo
hori zontal aos objetos
sel eci onados.
CONE OPO DESCRIO
Espelhar Verticalmente
Apl i ca o efei to de refl exo
verti cal aos objetos
sel eci onados.
NOTAS:
As opes Espelhar Horizontalmente e Espelhar Verticalmente tm o segui nte
comportamento:
Para sel ees ml ti pl as, cada um dos objetos espel hado i ndi vi dual mente
O estado dos botes se al tera (pressi onado ou no) conforme os objetos
tenham si do refl eti dos verti cal mente ou hori zontal mente, mas somente se
o estado de refl exo i gual para todos os objetos sel eci onados
Os botes fi cam desabi l i tados se a Tel a esti ver sel eci onada ou se no h
nenhum objeto sel eci onado
Os objetos de Tel a podem ser ajustados ao pi xel mai s prxi mo (efei to Snap to
Pixel), uti l i zando-se a combi nao de tecl as CTRL + BARRA DE ESPAO.
7.3.2 Grade
Conjunto de l i nhas hori zontai s e verti cai s que servem como refernci a de
posi ci onamento para objetos na Tel a. El a vi sual i zada somente no E3 Studi o, e no
em tempo de execuo.
No E3 Studi o, possvel mostrar ou esconder a grade atravs do menu Arranjar -
Grade, ou cl i cando em na barra de ferramentas Alinhamento.
As propri edades da Grade podem ser confi guradas atravs do menu Arranjar -
Edio da Grade. Ao sel eci onar esta opo, a segui nte janel a mostrada:
Propriedades da Grade
Opes disponveis na janela Propriedades da Grade
OPO DESCRIO
Pontilhada
A grade mostra pontos apenas nas
i nterseces de l i nhas.
Linhas pontilhadas
A grade mostra a l i nha i ntei ra
ponti l hada.
Alinhar mouse automaticamente
Al i nha o mouse grade
automati camente.
Comprimento
Determi na a di stnci a entre as l i nhas
hori zontai s.
Largura
Determi na a di stnci a entre as l i nhas
verti cai s.
Cor
Determi na a cor da grade.
7.3.3 Rotacionar
Permi te rotaci onar um objeto de Tel a tendo como ori gem seu centro ou qual quer
outro ponto na Tel a. Para uti l i zar este recurso, si ga estes procedi mentos:
1. Sel eci one um objeto na Tel a e cl i que em Rotacionar , na barra de
ferramentas Tela.
2. Cl i que em um de seus vrti ces de rotao (em verde) e arraste o objeto at a
posi o desejada.
3. Caso seja necessri o, al tere o centro de rotao do objeto (marcado por um
crcul o verde).
7.3.4 Ordem de Navegao entre os Objetos
Estabel ece a ordem de navegao, atravs da tecl a TAB, entre doi s ou mai s objetos
em tempo de execuo (i sto , a ordem em que os objetos ganham foco). Para
habi l i tar esta opo, si ga estes procedi mentos:
1. Sel eci one a Tel a e cl i que em Ordem dos Tabs , na barra de ferramentas Tela.
2. Cl i que nos objetos conforme a ordenao desejada. O nmero com a ordem de
navegao aparecer no canto superi or esquerdo do objeto.
3. Quando o Domni o for executado, a navegao entre estes objetos ser fei ta
conforme a ordem especi fi cada.
Ordem dos Tabs
Para manter a ordem i ni ci al dos objetos, necessri o segui r estes procedi mentos:
1. Aps ter cri ado o objeto na Tel a, cl i que em Ordem dos Tabs .
2. Com a tecl a CTRL pressi onada, cl i que no penl ti mo objeto.
3. Sol te a tecl a CTRL e cl i que no l ti mo objeto (objeto cri ado anteri ormente).
NOTA: A ordem de tabul ao equi val ente ordem de sobreposi o dos objetos,
descri ta no tpi co Sobreposio de Objetos.
7.3.5 Agrupar ou Desagrupar
Permi te transformar mai s de um objeto em apenas um, com propri edades
especfi cas. Para uti l i zar este recurso, si ga estes procedi mentos:
1. Sel eci one na Tel a os objetos que devem formar o grupo.
2. Cl i que em Agrupar . Um novo objeto cri ado. Esta operao pode ser fei ta
em cascata, e um grupo pode conter qual quer objeto, i ncl usi ve outros grupos.
3. Para desfazer a uni o de um grupo de objetos, cl i que em Desagrupar .
4. Para edi tar um objeto conti do em um grupo, cl i que com o boto di rei to do
mouse no objeto e sel eci one a opo Editar Grupo.
NOTA: possvel ajustar os objetos dentro de um grupo ao pi xel mai s prxi mo
(efei to Snap to Pixel), uti l i zando-se a combi nao de tecl as CTRL + BARRA DE ESPAO.
Neste caso, o efei to ser apl i cado a cada um dos objetos dentro do grupo, podendo
ser desfei to uti l i zando-se a combi nao de tecl as CTRL + Z.
7.3.6 Animao
Recurso que apl i ca movi mento a um objeto em tempo de execuo, e que est
di sponvel na barra de ferramentas Tela. Os ti pos de movi mentos di sponvei s so:
Animao com Translao: O objeto que recebe este recurso faz movi mentos
l i neares de acordo com as confi guraes das propri edades no objeto. Para
1. Sel eci one o objeto na Tel a e cl i que em Animar com Translao.
2. Com o cursor do mouse, habi l i te as confi guraes da ori entao do objeto.
Animao com Translao
Animao com Rotao: O objeto que recebe este recurso faz movi mentos
ci rcul ares de acordo com o centro de rotao do objeto e seu ngul o. Para
1. Sel eci one o objeto na Tel a e cl i que em Animar com Rotao.
2. Quando o objeto cri ado, seu centro de rotao padro defi ni do como o
centro do objeto, com uma i ncl i nao de 0 (zero) graus de posi o da
hori zontal em rel ao a esse centro. Neste momento, os vrti ces do objeto
sel eci onado so i ndi cados por pequenos crcul os e seu centro por doi s
crcul os ci rcunscri tos.
3. Ao passar o mouse sobre o centro ou vrti ces, possvel modi fi car o centro
arrastando ou rotaci onando o objeto de um de seus vrti ces em rel ao ao
centro.
Animao com Rotao
7.3.7 Sobreposio de Objetos
Permi te edi tar o modo como doi s ou mai s objetos estaro sobrepostos. As opes
di sponvei s na barra de ferramentos Tela so:
Opes disponveis na barra de ferramentas Tela
CONE OPO DESCRIO
Trazer para a Frente
O objeto sel eci onado
envi ado para a pri mei ra
posi o na ordem de
sobreposi o (ALT +
HOME).
Enviar para Trs
envi ado para a l ti ma
posi o na ordem de
sobreposi o (ALT + END).
CONE OPO DESCRIO
Avanar
avana uma posi o na
ordem de sobreposi o
dos objetos (ALT + PAGE
UP).
Recuar
recua uma posi o na
ordem de sobreposi o
dos objetos (ALT + PAGE
DOWN).
7.3.8 Zoom
Na edi o da Tel a, pode-se escol her l i vremente o nvel de zoom desejado e mai s
confortvel para a edi o. O zoom est di sponvel atravs do menu contextual
Zoom, e possui nvei s que vo de 10% a 800%, al m das opes Toda Largura, Toda
Altura, Toda Pgina e Preencher, conforme a fi gura a segui r.
Menu Zoom
Al m do menu Zoom, possvel modi fi car o nvel de zoom atravs do tecl ado e
mouse, uti l i zando as segui ntes combi naes:
CTRL + SINAL DE MAIS (+): Aumenta o zoom
CTRL + SINAL DE MENOS (-): Di mi nui o zoom
CTRL + ASTERISCO (*) ou CTRL + 0 (ZERO): Vol ta para o zoom padro (100%)
CTRL + Roda do mouse para cima: Aumenta o zoom
CTRL + Roda do mouse para baixo: Di mi nui o zoom
NOTA: Ao uti l i zar as opes de CTRL + Roda do mouse (para ci ma ou para bai xo), o
foco do zoom sempre rel ati vo posi o do pontei ro do mouse.
7.3.9 Camadas
O E3 oferece uma arqui tetura de Tel as com at 32 camadas para i nsero de
objetos. Cada objeto pode pertencer a uma ou mai s camadas, e a Tel a ati va tanto
em confi gurao (no E3 Studi o) quanto em execuo (no E3 Vi ewer) pode estar com
nenhuma, uma, vri as ou todas as camadas ati vas. Isso permi te cri ar si stemas
com vri as formas de moni toramento como, por exempl o, a vi sual i zao de um
processo apenas com o si stema el tri co, apenas o hi drul i co ou ambos. possvel
tambm control ar o apareci mento de camadas de acordo com um determi nado
nvel de zoom. A confi gurao das camadas fei ta cl i cando-se em Camadas. As
opes di sponvei s so:
Opes disponveis para a configurao de Camadas
OPO DESCRIO
Camada
Habi l i ta a vi sual i zao da camada
confi gurada na propri edade Layer da
Tel a.
Todas as camadas
Mostra todas as camadas di sponvei s no
projeto.
Nenhuma camada
Nenhuma camada mostrada.
Editar camadas
Atravs desta opo, pode-se confi gurar
camadas i ndi vi duai s. Esta opo abre
uma cai xa de di l ogo para confi gurao
da camada.
Quando a opo Editar camadas sel eci onada, a segui nte janel a mostrada.
Edio de Camadas
A janel a Edi o de Camadas tem as segui ntes opes: Adicionar Camada , para a
cri ao de uma nova camada; Remover Camada , para a excl uso da camada
sel eci onada; e Editar Camada , para a edi o da camada sel eci onada. Ao cl i car
em ou , a segui nte janel a aberta:
Adio ou edio de camadas
Opes disponveis na Camada
OPO DESCRIO
Nome da Camada
Determi na o nome da camada.
Zoom Baixo
Defi ne a porcentagem i ni ci al de zoom
na camada.
Zoom Alto
Defi ne a porcentagem fi nal de zoom na
camada.
Usar condio adicional de visibilidade
Habi l i ta a uti l i zao de uma condi o
adi ci onal de vi si bi l i dade de zoom na
camada. Esta condi o pode ser uma
vari vel ou propri edade qual quer.
Fonte
Estabel ece uma Associ ao ou uma
propri edade, que uma vez ati va
(di ferente de zero), tambm exi be a
camada (as opes de Zoom e Fonte no
so excl usi vas, i sto , podem ati var a
camada estando uma ou outra condi o
ati va).
Para mai ores i nformaes, consul te o Manual de Referncia de Scripts.
7.3.10 Travar
Ao escol her esta opo, o E3 Studi o no permi te que o objeto seja movi do, evi tando
movi mentos i ndesejados. Depoi s de travado, o mouse exi be um cursor com um
cadeado ao ser desl ocado sobre a rea do objeto.
Para habi l i tar esta opo, basta cl i car com o boto di rei to do mouse sobre o
objeto desejado e escol her a opo Travar .
Objeto travado
Para desabi l i tar esta opo, basta cl i car novamente com o boto di rei to do mouse
no objeto e sel eci onar a opo Destravar.
7.3.11 Ponto ncora
Um Ponto ncora defi ni do como as coordenadas que marcam o ponto i ni ci al do
objeto. Ini ci al mente, o ponto ncora est atrel ado s coordenadas i ni ci ai s do
objeto.
Para habi l i tar esta opo, cl i que com o boto di rei to do mouse sobre o objeto e
sel eci one a opo Definir Ponto ncora. O objeto aparece com o smbol o , de
onde pode ser movi do para qual quer l ugar da Tel a. Ao arrastar o objeto com a
nova ncora, o ponto que foi defi ni do o que fi car fi xado nos pontos da grade,
sendo que o objeto fi car desl ocado nas mesmas propores em rel ao ncora.
Isto s vi sual i zado se a opo Alinhar Mouse Automaticamente (propri edade da
Grade) esti ver habi l i tada.
Objeto com ponto ncora
NOTA: Ao uti l i zar a combi nao de tecl as CTRL + BARRA DE ESPAO (efei to Snap to
Pixel) em um objeto com a opo Definir Ponto ncora habi l i tada, o objeto ser
movi do para o pi xel mai s prxi mo, sem respei tar a posi o do ponto ncora. Caso
seja uti l i zado o mouse para mover o objeto, o ponto ncora ser posi ci onado
exatamente em ci ma de um pi xel . Para corri gi r eventuai s di screpnci as no
posi ci onamento do objeto, pode-se uti l i zar a combi nao CTRL + BARRA DE ESPAO
aps sol tar o boto do mouse.
7.3.12 Sombreamento
Permi te apl i car ou edi tar o efei to de sombra em um objeto de Tel a.
Opes da sombra
Para uti l i zar este recurso, si ga estes procedi mentos:
1. Insi ra ou sel eci one o objeto ao qual deseja apl i car a sombra.
2. Al tere suas propri edades atravs da barra de ferramentas Sombra, de acordo
com as segui ntes opes:
Opes disponveis na barra de ferramentas Sombra
OPO DESCRIO
Habi l i ta ou desabi l i ta o efei to de
sombra no objeto.
Desl oca a sombra abai xo do objeto.
Desl oca a sombra aci ma do objeto.
Desl oca a sombra esquerda do
objeto.
Desl oca a sombra di rei ta do objeto.
Confi gura a cor da sombra do objeto.
7.3.13 Desenho
Permi te apl i car ou edi tar i nformaes rel ati vas s cores de fundo e frente da Tel a e
objetos de Tel a e borda dos objetos de Tel a.
Opes de desenho
1. Insi ra ou sel eci one o objeto (Tel a ou objeto de Tel a) cujas cores ou bordas
deseja edi tar.
2. Al tere suas propri edades de acordo com as opes di sponvei s na barra de
ferramentas Desenho.
As opes di sponvei s nesta barra de ferramentas so:
Opes disponveis na barra de ferramentas Desenho
CONE OPO DESCRIO
Cor do Fundo
Permi te sel eci onar a cor
de fundo da Tel a ou do
objeto de Tel a a parti r de
uma l i sta de cores pr-
estabel eci das, ou cri ar
uma nova cor
personal i zada.
Cor da Frente
de frente da Tel a ou do
uma l i sta de cores pr-
uma nova cor
personal i zada.
CONE OPO DESCRIO
Cor da Borda
da borda do objeto de
Tel a a parti r de uma l i sta
de cores pr-
uma nova cor
personal i zada.
Estilo da Borda
Permi te escol her o ti po
de borda exi bi da pel o
uma l i sta com esti l os
pr-estabel eci dos: uma
l i nha contnua, di ferentes
ti pos de ponti l hados e
tracejados, ou
si mpl esmente nenhuma
borda.
Espessura da Linha
Permi te escol her a
espessura da l i nha da
borda do objeto de Tel a a
parti r de uma l i sta com
espessuras pr-
estabel eci das entre 0 e
2,5 mi l metros.
Estilo do Preenchimento
Permi te escol her o ti po
de preenchi mento
exi bi do pel a Tel a ou pel o
objeto de Tel a, i sto ,
como se dar a
combi nao entre as
cores de fundo e de
frente do objeto. Ao
sel eci onar esta opo, a
janel a mostrada na fi gura
a segui r aberta.
Efeitos de preenchimento
As opes di sponvei s nesta janel a so:
Opes disponveis na janela Preenchimento
OPO DESCRIO
Estilos
Mostra todos os esti l os de preenchi mento
di sponvei s para o objeto sel eci onado.
Cor da frente
Mostra a cor da frente previ amente
sel eci onada para o objeto. Permi te
tambm a sel eo de uma nova cor de
frente (o mesmo que cl i car em ).
Cor do fundo
Mostra a cor de fundo previ amente
sel eci onada para o objeto. Permi te
tambm a sel eo de uma nova cor de
fundo (o mesmo que cl i car em ).
Amostra
Mostra como o efei to escol hi do apl i cado
com as cores de fundo e de frente do
objeto.
OPO DESCRIO
Opaco ou Transparente
Ao sel eci onar a opo Transparente, os
preenchi mentos com efei to hachurado no
mostram a cor de fundo do objeto
sel eci onado, somente a cor de frente,
cri ando um efei to de transparnci a no
objeto. Ao sel eci onar a opo Opaco, este
efei to no acontece. NOTA: A opo
Transparente est desabi l i tada para a Tel a.
7.3.14 Configurar como Padro
Confi gura as opes edi tadas nas barras de ferramentas Sombra e Desenho como
padro para os demai s objetos de Tel a que forem cri ados. Para uti l i zar este
recurso, si ga estes procedi mentos:
1. Sel eci one o objeto que servi r como model o para os demai s.
2. Cl i que com o boto di rei to do mouse e sel eci one a opo Configurar como
Padro.
3. Ao cri ar um novo objeto de Tel a, as confi guraes de Sombra e Desenho deste
objeto sero uti l i zadas como confi guraes i ni ci ai s dos prxi mos objetos.
7.3.15 Aplicar Estilo
Apl i ca o esti l o confi gurado como padro na opo Configurar como Padro a
objetos previ amente cri ados. Para uti l i zar este recurso, si ga estes procedi mentos:
1. Sel eci one o objeto ao qual o padro deve ser apl i cado.
2. Cl i que com o boto di rei to do mouse e sel eci one a opo Aplicar Estilo.
7.4 Formatao de Cores
Em propri edades do ti po Cor, a al terao de val or pode ser fei ta por mei o de cai xas
de di l ogo, como mostrado a segui r, di sponvei s na l i sta de Propri edades ao cl i car
em na janel a de Propri edades. Exi stem doi s modos para se escol her a cor
desejada: atravs da aba Padro, onde possvel sel eci on-l a dentre cores pr-
defi ni das, ou atravs da aba Personalizado, onde pode-se i nformar a cor atravs de
seus componentes.
Cores
O boto Outra permi te que o usuri o sel eci one uma cor de qual quer parte da tel a,
dentro ou fora do E3 Studi o. Basta cl i car no boto e aps cl i car sobre a cor
desejada, que el a ser capturada para a janel a de cores.
Para personal i zar uma cor, pode-se combi nar duas metodol ogi as: RGB
(componentes de vermel ho, verde e azul ) e HSL (componentes de mati z, saturao e
l umi nosi dade).
Cor personalizada
A escal a RGB descreve uma cor atravs da mi stura de trs cores bsi cas, a saber:
Red (vermel ho): i ndi ca a quanti dade do componente pri mri o vermel ho na
composi o da cor
Green (verde): i ndi ca a quanti dade do componente pri mri o verde na
composi o da cor
Blue (azul ): i ndi ca a quanti dade do componente pri mri o azul na composi o da
cor
Cada um destes el ementos da cor podem ter um grau de i ntensi dade que vai de 0 a
255.
A escal a HSL descreve uma cor atravs da mi stura de trs componentes bsi cos, a
saber:
Hue (mati z): especi fi ca a gradao da cor dentro do espectro de l uz vi svel
Saturation (saturao): i ndi ca a i ntensi dade de um determi nado mati z. Um mati z
com al ta saturao tem uma cor mai s i ntensa, enquanto que um mati z com bai xa
saturao produz uma cor mai s aci nzentada
Lightness (l umi nosi dade): i ndi ca a quanti dade de l uz apl i cada cor. Quanto
mai or a l umi nosi dade, mai s cl ara a cor; do mesmo modo, quanto menor a
l umi nosi dade, mai s escura a cor
Estes el ementos tambm podem ter seu grau de i ntensi dade confi gurado entre 0 e
255. Assi m, basta especi fi car o val or para cada um dos i tens, conforme a
tonal i dade da cor desejada, ou escol her a cor desejada di retamente com o mouse
sobre as escal as da janel a.
O val or numri co de cada cor obti do atravs da segui nte frmul a:
Red * 256^0 + Green * 256^1 + Blue * 256^2
Ou seja:
Red * 1 + Green * 256 + Blue * 65536
Sendo que Red, Green e Blue podem assumi r val ores de 0 a 255. Por exempl o:
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 val ores armazenados nas propri edades dos objetos que se referem a
cores so os val ores numri cos, cal cul ados atravs da frmul a aci ma. A ferramenta
Procurar e Substituir uti l i za esse val or armazenado no processo de pesqui sa, e no
os val ores formatados como RGB mostrados na janel a de Propri edades.
7.5 Formatao de Valores
O uso de formatadores permi te mudar a forma como os dados so apresentados
sem preci sar mudar o val or que exi ste por trs del es. O formato um texto que
pode ser edi tado manual mente ou confi gurado atravs da janel a de formatao.
Seu uso semel hante aos formatadores usados nas pl ani l has el etrni cas,
segui ndo a mesma si ntaxe bsi ca, mas com al gumas extenses. So suportados os
segui ntes ti pos de dados:
Numri cos (sada deci mal , ci entfi ca, hexadeci mal , bi nri a e octal )
Texto
Bool eanos
Datas e Horas (cal endri o Gregori ano)
Os objetos que suportam formatao devem ter o ti po de dado na propri edade
Value al terado de acordo com o ti po de formatao desejada.
Janela de Formatao de Valores
As segui ntes formataes esto di sponvei s:
Geral: No h formatao especfi ca. real i zada automati camente, dependendo
do ti po de dado
Nmero: Apresenta nmeros com parte i ntei ra e fraci onri a, permi ti ndo defi ni r
o nmero de casas deci mai s e uso de separador de mi l hares. Para nmeros
mui to grandes ou mui to pequenos, uti l i ze o formato Cientfico. Os smbol os de
casa deci mal e separador de mi l hares so aquel es defi ni dos no Painel de
Controle - Configuraes Regionais
Data/Hora: Apresentam val ores numri cos (formato Gregori ano) como datas e
horas, quando vl i dos
Porcentagem: Mul ti pl i ca o nmero por 100 e adi ci ona o smbol o de percentual ,
defi ni ndo tambm o nmero de casas deci mai s
Cientfico: Este formato apresenta o nmero em notao de manti ssa e expoente.
Ideal para nmeros de magni tude vari ada, permi ti ndo escol her tambm o
nmero de casas deci mai s e formatos
Especial: Permi te formatar nmeros i ntei ros em bases no deci mai s
(hexadeci mal , octal e bi nri a)
7.5.1 Outros Formatos
Na opo Outro, pode-se cri ar um formato de dados qual quer, mesmo um dos j
ci tados, a parti r da di gi tao de um cdi go (texto) de formato.
O texto do formatador composto de at quatro campos separados por um ponto e
vrgul a. O pri mei ro campo sempre apl i cado quando no exi sti r um outro campo
mai s apropri ado para o val or ou ti po de dado. O segundo campo uti l i zado para
val ores numri cos negati vos. O tercei ro campo uti l i zado quando o val or
numri co for zero. Fi nal mente, o quarto campo uti l i zado quando o dado for do
ti po texto.
Sempre que mai s de um campo for defi ni do, o campo anteri or ser consi derado,
mesmo que esteja vazi o. No caso de um formatador de campo vazi o, o val or
formatado ser sempre um texto vazi o. Note que i sso di fere do formato Geral, que
apenas um formato vazi o, sem o uso dos separadores de campo (ponto e vrgul a).
Para i nseri r caracteres que sero mostrados pel o formatador pode-se col oc-l os
entre aspas dupl as ou aps uma barra i nverti da. Exempl os (vl i dos para todos os
ti pos de formatadores):
Entrada de Texto
FORMATADOR SADA FORMATADA
"0#?"
0#?
\m\d\y
mdy
Tambm possvel cri ar formatadores que contenham apenas texto, que podem ser
combi nados com o uso de di ferentes campos, como no exempl o a segui r:
Formatador e Sada Formatada
VALOR FORMATADOR SADA FORMATADA
1
"Posi ti vo";"Negati vo";"Zero
","Texto"
Posi ti vo
-1
","Texto"
Negati vo
0
","Texto"
Zero
"Abcd"
","Texto"
Texto
Al m di sso, os segui ntes caracteres podem ser mostrados di retamente sem o uso de
aspas ou barra: $ - + / () : ! ^ & ' (aspas si mpl es esquerda) ' (aspas si mpl es
di rei ta) ~ { } = < >
NOTA: Para mostrar a barra i nverti da ou aspas dupl as no dado formatado, use \"
ou \\. Quando entre aspas, todo o texto copi ado di retamente; l ogo, "\a"
mostrado si mpl esmente como \a.
Os formatadores numri cos acei tam trs ti pos bsi cos de caracteres para defi ni r o
nmero de dgi tos apresentados:
Formatadores Numricos
OPO DESCRIO
0 (zero)
Col oca o dgi to si gni fi cati vo ou 0 (zero),
quando no houver.
#
Col oca o dgi to si gni fi cati vo.
?
Col oca o dgi to si gni fi cati vo ou um
espao, quando no houver.
O ponto deci mal defi ne que se deseja apresentar tambm a parte fraci onri a de um
nmero. A vrgul a tem como funo i ndi car que o val or deve ser di vi di do por mi l
(para cada vrgul a), aps os dgi tos do formatador.
Independentemente da confi gurao l ocal do Wi ndows, o ponto e a vrgul a sempre
devem ser uti l i zados no texto do formatador para i ndi car o separador de mi l har e
de deci mal , mas a sada formatada ser de acordo com a confi gurao regi onal do
si stema. Exempl os:
Opes disponveis
DADO FORMATADOR SADA FORMATADA
12000
#, 12
1234567
#,#.0 1,234,567.0
7.5.1.1 Formatos Cientficos
O nmero poder ser apresentado em notao ci entfi ca (manti ssa e expoente)
quando aps al gum dgi to houver E+, E-, e- ou e+, segui dos de dgi tos para formatar
o expoente. Quando for usado E+ ou e+ o expoente ser sempre mostrado com si nal ,
quando for usado E- ou e-, o si nal aparecer apenas para expoente negati vos,
sendo que no expoente sempre ser mostrado um dgi to, mesmo que este seja zero.
O nmero de dgi tos di rei ta do ponto deci mal afeta o expoente mostrado.
Exempl os:
Formatador Cientfico
1000
#E+00 1E+03
1000
##e-00 10e02
7.5.1.2 Formatos de Texto
O caractere @ copi a o val or do dado na posi o onde aparecer. Esse formatador
deve aparecer no quarto campo (exempl o: ;;;@) ou di retamente quando h apenas
um campo. Exempl os:
Formatador para Texto
Abc
@@ Abc Abc
xyZ
"Nome: " \ " @ \ " Nome: "xyZ"
7.5.1.3 Formatos de Bases No Decimais
Os formatadores para bases no-deci mai s sempre apresentam apenas a parte
i ntei ra do val or numri co formatado, e tambm no so sensvei s ao si nal . Da
mesma forma que na base deci mal , caso o nmero possua mai s dgi tos do que o
requi si tado no formatador, estes dgi tos sero apresentados de qual quer forma.
Atual mente, estes formatadores esto l i mi tados em nmeros de 32 bi ts. Caso a
parte i ntei ra do val or exceda esse l i mi te a formatao retornar erro. Exempl os:
Formatadores para Bases No-Decimais
255
"0x"XXX 0x0FF
12345
oooo\o 30071o
987
B 1111011011
12
BBBB - BBBB 0000 - 1100
7.5.1.4 Formatos de Data e Hora
A si ntaxe da formatao de datas e horas di fere um pouco do si stema usado pel as
pl ani l has, segui ndo o modo usado pel a confi gurao regi onal do Wi ndows. As
datas so val ores numri cos onde a parte i ntei ra uma contagem de di as desde 31
de dezembro de 1899 e a parte fraci onri a representa a hora em fraes de di a.
O ano mni mo suportado 100 e o ano mxi mo 9999; i sto garante uma resol uo
de pel o menos 1 ms em todo o i nterval o. Os nomes de meses e di as da semana, a
ordem padro de di a, ms e ano e o separador de datas e horas so todos
uti l i zados de acordo com a confi gurao regi onal do Wi ndows. Atravs do quadro
a segui r, possvel veri fi car o formatador e a sada formatada para os val ores:
Formatadores para Datas e Horas
1234.56789
dd/MMMM/yyyy 18/mai o/1903
0.56789
hh:mm:ss.000 tt 01:37:45.696 PM
12.345678
hh\hmm\mss.000\s 296 h17 m46.667 s
NOTA: Os val ores armazenados nas propri edades dos objetos que se referem a
datas so os val ores numri cos, cal cul ados atravs da frmul a aci ma. A
ferramenta Procurar e Substituir uti l i za esse val or armazenado no processo de
pesqui sa, e no os val ores formatados como data e hora mostrados na l i sta de
propri edades.
Associaes 249
8
Associaes
CAPTULO
Associaes (ou conexes) so l i gaes fei tas entre propri edades e objetos ou
outras propri edades. As Associ aes trazem grande faci l i dade ao cri ar ani maes
e outros ti pos de l gi cas comuns, mi ni mi zando a uti l i zao de scri pts.
Pode-se acessar a aba Associaes cl i cando-se com o boto di rei to do mouse no
objeto e sel eci onando a opo Propriedades. Nesta aba, so mostradas as
propri edades do objeto que podem ser associ adas, bem como os ti pos de
Associ aes exi stentes e suas fontes.
Aba Associaes
As opes di sponvei s na aba Associaes so as segui ntes:
Opes disponveis na aba Associaes
OPO DESCRIO
Propriedades
Li sta as propri edades do objeto que
podem ser associ adas.
250 Associaes
OPO DESCRIO
Conexo
I ndi ca o ti po de Associ ao que a
propri edade possui . Para propri edades
comuns, as Associ aes di sponvei s so
as segui ntes: Simples, Bidirecional,
Analgica, Digital, Por Tabela, Reversa e
Mltipla. Exi ste ai nda a l i gao entre
propri edades de El i pseX e objetos, que
ai nda no pode ter seu ti po modi fi cado
(para mai ores detal hes, consul te o
captul o Bibliotecas).
Fonte
No caso mai s si mpl es, especi fi ca o
cami nho para um objeto ou propri edade.
Este cami nho pode ser preenchi do pel o
AppBrowser, cl i cando-se em , que fi ca
di rei ta do campo. No caso geral , uma
expresso que permi te apl i car operaes
l gi cas, ari tmti cas e aval i aes de
funes propri edades, objetos e
constantes.
Ao especi fi car a fonte da Associ ao, o seu texto aparecer em azul , caso esta
corresponda a uma expresso vl i da. Se a expresso conti ver erros, como no caso
de cami nhos de objetos que no exi stam (ou pertenam a projetos que no estejam
carregados), o texto aparecer em vermel ho. Nestes casos, a opo de Verificar
Domnio i r i nformar os l ocai s que necessi tam de correo ou revi so. Os ti pos de
Associ aes di sponvei s sero expl i cados nos tpi cos a segui r.
8.1 Simples
Na Associao Simples, o val or do campo Fonte copi ado para a propri edade toda
vez que o pri mei ro for modi fi cado.
Associaes 251
Associao Simples
1. Sel eci one o objeto desejado para a Associ ao.
2. Cl i que com o boto di rei to do mouse no objeto e sel eci one a opo
Propriedades.
3. Cl i que na aba Associaes e sel eci one a propri edade para a qual deseja fazer a
Associ ao. O si stema i ndi car vri os ti pos de Associ aes.
4. No campo Fonte, sel eci one a Associ ao desejada e cl i que em para i ndi car
a propri edade que deseja referenci ar, ou escreva a expresso neste campo.
8.2 Bidirecional
A Associao Bidirecional semel hante Associ ao Si mpl es porm, caso haja uma
vari ao na propri edade, seu val or ser copi ado para a fonte, gerando assi m, uma
Associ ao de duas di rees.
252 Associaes
Associao Bidirecional
Propriedades.
8.3 Digital
J na Associao Digital, podemos estabel ecer que caso a vari vel ou expresso do
campo Fonte represente um val or di gi tal (Bool eano), seus estados Verdadei ro e
Fal so sero mapeados para certos val ores no desti no, i ncl ui ndo a opo de Pi sca
(al ternnci a de val ores).
Associaes 253
Associao Digital
As opes di sponvei s nesta Associ ao so as segui ntes:
Opes disponveis para a Associao Digital
OPO DESCRIO
Ligado
Especi fi ca o val or assumi do pel a
propri edade quando a expresso da
fonte for Verdadei ra.
Desligado
Especi fi ca o val or assumi do pel a
fonte resul tar em Fal so.
Pisca
Quando este campo esti ver habi l i tado, a
propri edade conectada i r al ternar entre
os val ores do campo Para valor, caso a
fonte retorne Verdadei ro. Caso contrri o,
a propri edade retornada i r al ternar
entre os val ores dos campos Valor e Para
valor caso a fonte retorne Fal so.
Para valor <Campo Ligado>
Especi fi ca o val or al ternati vo a ser
assumi do peri odi camente pel a
propri edade quando a expresso ou
Associ ao da fonte resul tar em
Verdadei ro e o campo Pisca esti ver
habi l i tado.
254 Associaes
OPO DESCRIO
Para valor <Campo Desligado>
Especi fi ca o val or al ternati vo a ser
assumi do peri odi camente pel a
fonte resul tar em Fal so e o campo Pisca
esti ver desabi l i tado.
Propriedades.
8.4 Analgica
A Associao Analgica permi te estabel ecer uma escal a de converses entre a
vari vel fonte e desti no. Atravs dos val ores especi fi cados, fei ta uma escal a
l i near entre os val ores da propri edade e os val ores da fonte.
Associao Analgica
Associaes 255
Opes disponveis para a Associao Analgica
OPO DESCRIO
Valor na Fonte
Determi na os val ores mni mo e mxi mo
ati ngi dos na fonte.
Valor na Propriedade
Determi na os val ores mni mo e mxi mo
ati ngi dos na propri edade.
2. Cl i que com o boto di rei to do mouse no objeto, sel eci one o i tem Propriedades e
cl i que na aba Associaes. Sel eci one a propri edade para a qual deseja fazer a
8.5 Por Tabela
Na Associao por Tabela, possvel especi fi car um conjunto de i nterval os em
funo de val ores mxi mo e mni mo da fonte e, para cada um destes i nterval os, o
val or a ser assumi do pel a propri edade. Al m di sso, assi m como na Associ ao
Di gi tal , possvel especi fi car a opo de Pisca e o val or al ternati vo. Para uti l i zar
1. Cl i que nas propri edades do objeto e escol ha a opo Associaes.
2. Sel eci one a propri edade para a qual deseja fazer a Associ ao, e cl i que no
i tem Conexo por Tabela.
256 Associaes
Associao por Tabela
Opes disponveis para a Associao por Tabela
OPO DESCRIO
I nsere uma nova l i nha na tabel a.
Remove a l i nha sel eci onada da tabel a.
Min
Especi fi ca o val or mni mo da fonte para
uma l i nha da tabel a.
Max
Especi fi ca o val or mxi mo da fonte para
Valor
Especi fi ca o val or da propri edade a ser
assumi do quando a fonte esti ver no
i nterval o especi fi cado na l i nha.
Pisca
Determi na que quando a fonte esti ver
no i nterval o desta l i nha, a propri edade
i r al ternar peri odi camente entre os
val ores especi fi cados nos campos Valor
e Valor (com o Pisca habilitado).
Valor < Pisca Habilitado>
Especi fi ca o val or al ternati vo da
propri edade a ser assumi do quando a
fonte esti ver no i nterval o especi fi cado
na l i nha, i sto , quando o campo Pisca
esti ver habi l i tado.
1. Na aba Associaes, sel eci one a propri edade e associ e a opo Conexo por
tabela.
Associaes 257
2. Cri e as l i nhas desejadas na tabel a e confi gure os campos Min, Max e Valor.
3. Caso deseje al ternar peri odi camente entre os val ores, habi l i te o campo Pisca e
confi gure as opes restantes.
8.6 Reversa
Na Associao Reversa, toda vez que o val or da propri edade for modi fi cado, este
ser copi ado para a fonte, funci onando assi m de manei ra reversa Associ ao
Si mpl es. Para uti l i zar este recurso, si ga estes procedi mentos:
1. Cl i que nas propri edades do objeto e escol ha a opo Associaes.
i tem Conexo Reversa.
Associao Reversa
8.7 Mltipla
Na Associao Mltipla, cada l i nha da Associ ao permi te buscar o val or de uma
fonte di ferente. A fonte ati va sel eci onada de acordo com o val or fonte pri nci pal
da Associ ao.
Cada l i nha possui o i nterval o (propri edades Min e Max) e a fonte para aquel e
258 Associaes
i nterval o (propri edade Source, que um link normal ).
1. Cl i que nas propri edades do objeto e escol ha a aba Associaes.
i tem Conexo Mltipla.
3. Defi na a fonte pri nci pal da Associ ao na col una Fonte.
Associao Mltipla
Opes disponveis para a Associao Mltipla
OPO DESCRIO
I nsere uma nova l i nha na tabel a.
Remove a l i nha sel eci onada da tabel a.
Min
Especi fi ca o val or mni mo da fonte para
Max
Especi fi ca o val or mxi mo da fonte para
Fonte
Especi fi ca a fonte que ser associ ada
com a propri edade quando o val or da
fonte pri nci pal esti ver entre os l i mi tes
Min e Max.
8.8 Edio de Associaes
O E3 possui uma ferramenta para edi tar as Associ aes, chamada Edio de
Associaes. Assi m, possvel mudar uma ou mai s Associ aes fei tas na apl i cao
de forma mai s rpi da do que pel a janel a tradi ci onal .
Associaes 259
O acesso a esta ferramenta pode ser fei to cl i cando-se com o boto di rei to do
mouse sobre um ou mai s objetos e sel eci onando a opo Editar Associaes.
Acesso opo Editar
Associaes
A segui nte cai xa de di l ogo mostrada:
Edio de Associaes
A cai xa de di l ogo anteri or mostra uma l i sta das Associ aes, propri edades do
ti po Link e eventos do usuri o rel aci onados aos objetos sel eci onados e seus fi l hos.
De acordo com o ti po de l i nha, as segui ntes i nformaes esto di spostas nas
col unas:
260 Associaes
Opes disponveis na janela Editar Associaes
OPES DESCRIO
Nome do Objeto
Determi na o nome do objeto.
Propriedade / Evento
Determi na a propri edade do objeto que
possui a Associ ao.
Conexo
Determi na o ti po de Associ ao (Simples,
Bidirecional, Digital, Analgica, Por Tabela,
Reversa e Mltipla).
Fonte
Determi na a fonte da Associ ao.
Opes para Propriedades do tipo Link
OPO DESCRIO
Nome do Objeto
Determi na o nome do objeto que possui
a propri edade.
Determi na o nome da propri edade.
Conexo
sempre a mesma (Link).
Fonte
Determi na o val or da propri edade.
Opes para Eventos do usurio
OPO DESCRIO
Nome do Objeto
Determi na o nome do objeto que possui
o evento.
Determi na o nome do evento do usuri o.
Conexo
Determi na o ti po do evento (OnEvent,
WhileEvent ou OnValueChanged).
Fonte
Expresso rel aci onada ao evento.
Na cai xa de di l ogo Editar Associaes, permi ti do modi fi car o segui nte:
Associaes: Podem ser modi fi cadas, exceto o nome do objeto
Propriedades do tipo Link: Podem ser modi fi cadas, exceto o nome do objeto
Eventos do usurio: Podem ser modi fi cados, exceto o nome do objeto e o nome do
evento
Cl i car em permi te a remoo da Associ ao sel eci onada. A opo Mostrar
janela de propriedades das associaes determi na se os minidialogs das Associ aes
sero mostrados quando a l i nha esti ver sel eci onada. Se esta janel a esti ver vi svel ,
permi ti da a edi o das propri edades das Associ aes. Seu val or padro
habi l i tado.
Associaes 261
Edio das propriedades da Associao selecionada
Para edi tar as propri edades dos eventos do usuri o, necessri o sel eci onar a
l i nha que contm o evento e na col una Conexo, cl i car na opo Editar.
Edio das propriedades dos eventos do usurio
Ao cl i car na opo Editar, a cai xa de di l ogo a segui r mostrada, permi ti ndo assi m
que seja edi tado o evento do usuri o sel eci onado.
262 Associaes
Edio de eventos
Opes disponveis na janela Editar Eventos
OPO DESCRIO
Propriedade ou expresso
Propri edade ou expresso geradora do
evento.
Sempre que a propriedade for uma condio
verdadeira
I ndi ca que o evento ser do ti po
etOnEvent ou etWhileEvent.
Repetir o evento
I ndi ca o ci cl o de repeti o do evento em
ms, i sto , de quanto em quanto tempo
el e i r ocorrer, enquanto a expresso
geradora for verdadei ra.
Intervalo de repetio (ms)
Val or para o i nterval o de repeti o, em
mi l i ssegundos.
Sempre que a propriedade alterar o seu valor
I ndi ca que o evento ser
etOnValueChanged, i sto , o evento i r
ocorrer sempre que a expresso
geradora mudar o val or.
Tratar a desconexo como mudana de valor
Se houver al guma desconexo, el a ser
tratada como uma mudana de val or.
A janel a de edi o de Associ aes permi te uti l i zar o recurso de copi ar e col ar entre
as Associ aes das propri edades. A opo Copiar Associao copi a a Associ ao da
l i nha sel eci onada e a opo Colar Associao col a a Associ ao na l i nha
sel eci onada, substi tui ndo a Associ ao anteri or.
Associaes 263
Copiar e colar uma Associao
264 Bibliotecas
9
Bibliotecas
CAPTULO
O E3 possui ferramentas que permi tem transformar qual quer objeto ou conjunto de
objetos da apl i cao em uma bi bl i oteca do usuri o. As Bibliotecas podem ser
formadas por objetos frequentemente uti l i zados, e subsequentemente
reaprovei tados em outra apl i cao.
O E3 fornece doi s ti pos de bi bl i otecas para o usuri o: a Galeria, uma bi bl i oteca de
smbol os grfi cos vetori ai s, que podem ser l i vremente uti l i zados nas apl i caes; e
uma ferramenta de bi bl i otecas do usuri o chamada de ElipseX. O uso de
bi bl i otecas no E3 al tamente recomendvel na mai ori a dos casos, devi do ao
ganho de produti vi dade que el as trazem s apl i caes. Al gumas das vantagens dos
El i pseX:
Reuti l i zao de cdi gos
Mi ni mi zao de testes durante o desenvol vi mento
Cri ao de i nterfaces padro para os objetos desenvol vi dos
Di mi nui o do tempo de desenvol vi mento de novos projetos
Proteo do contedo do projeto
Bibliotecas no Organizer
Bibliotecas 265
9.1 Galeria
A Galeria pode ser acessada cl i cando-se em Galeria na barra de ferramentas
Padro. Neste i tem est di sponvel uma sri e de el ementos grfi cos vetori ai s,
di vi di dos em categori as, que podem ser arrastados para as Tel as ou ento para os
El i pseX. Esto di sponvei s os segui ntes ti pos de smbol os: 3D ISA Symbol s, Ar
Condi ci onado, Arqui tetura, Setas, ASHRAE (Control es e Equi pamentos), ASHRAE
(Dutos), ASHRAE (Canos), Formatos Bsi cos, Sopradores e Venti l adores, Prdi os,
Processos Qumi cos, Computadores, Conti neres, Control adores, Estei ras e Li nhas
de Produo, Dutos, El tri ca, Tubos Fl exvei s, Medi dores de Vazo, Smbol os Gerai s,
Aqueci mento, HVAC, cones e Bi tmaps, Mi scel nea Industri al , Smbol os
Internaci onai s, Smbol os ISA, Mapas e Bandei ras, Manusei o de Materi ai s, Canos,
Mi sturadores, Motores, Natureza, Interfaces Homem Mqui na, Pai ni s, Acessri os
Industri ai s, Di sposi ti vos de Potnci a, Resfri amento de Processos, Aqueci mento de
Processos, Bombas, Segurana, Escal as, Canos Segmentados, Sensores, Cortes em
Tanques, Texturas, Vl vul as, Vecul os, gua e Abasteci mento, Fi os e Cabos, Botes
3D, Cal dei ras, Tecl as de Computador, Acabamento, Comi da, Laboratri o,
Maqui nri o, Mi nas, Papel e Pol pa.
1. Cl i que em Galeria na barra de ferramentas Padro.
2. Sel eci onando esta aba, tem-se acesso aos conjuntos de smbol os, que esto
agrupados em categori as. Sel eci one a categori a atravs da l i sta na parte
superi or da janel a.
3. Para i nseri r um objeto da bi bl i oteca de smbol os em uma Tel a, basta cl i car no
objeto desejado e arrast-l o para a Tel a.
4. Depoi s de i nseri do, o objeto pode ser l i vremente edi tado e trabal hado de
acordo com as caractersti cas descri tas para os objetos de i magem. Por
exempl o, pode-se mudar a cor de preenchi mento di retamente atravs das
propri edades OverrideFillMode, OverrideFillColor e OverrideLineColor, sem a
necessi dade de transformar o objeto em um objeto grfi co do E3.
266 Bibliotecas
Galeria
9.2 Biblioteca do Usurio (ElipseX)
Os El i pseX so as bi bl i otecas de objetos do E3. Podem conter, al m de um desenho,
vari vei s i nternas passvei s de serem exportadas para a apl i cao, al m de l gi cas
de programao (scri pts) presentes em todas as cpi as do objeto sendo cri ado,
di mi nui ndo a necessi dade de repeti o de cdi go em di versas partes do apl i cati vo.
Os El i pseX fi cam encapsul ados em um arqui vo com extenso .l i b. Pode-se cri ar
todos os El i pseX que sero uti l i zados em um determi nado projeto no mesmo
arqui vo de Bi bl i oteca (.l i b), ou ento di vi di r entre vri os arqui vos conforme
desejado.
Para cri ar uma nova bi bl i oteca no E3, si ga estes procedi mentos:
1. Sel eci one o menu Novo Projeto e cl i que em Prximo.
2. Na opo Tipo de Aplicao, sel eci one a opo Biblioteca de componentes do
E3.
Bibliotecas 267
Criao de uma biblioteca do usurio (ElipseX)
3. Determi ne o nome da bi bl i oteca e cl i que em Avanar.
4. Determi ne as especi fi caes referentes ao Domni o.
5. Cl i que em Concluir.
Dentro de uma bi bl i oteca El i pseX, pode-se i nseri r doi s ti pos de objetos: os objetos
grfi cos XControl s e os objetos de dados XObjects.
Os segui ntes i tens podem ser i nseri dos em um XControl : Pri mi ti vas de Desenho
(Retas, Retngul os, Crcul os, etc.), Objetos Grfi cos Vetori ai s, i ncl ui ndo objetos da
bi bl i oteca de smbol os (WMF, EMF, etc.), Objetos Grfi cos no-Vetori ai s (BMP,
JPEG, GIF,etc.), Control es Acti veX do E3 (E3Chart, E3Browser, E3Al arm, Control es
Acti veX de tercei ros) e outros XControl s.
J os XObjects podem conter quai squer ti pos de objetos no-grfi cos, executados
no E3 Server, como Dri vers de Comuni cao, Servi dores de Dados, Bancos de
Dados, Frmul as, Confi guraes de Al armes, Servi dores de Al armes, Objetos COM,
entre outros.
Dentro de um mesmo arqui vo .l i b pode exi sti r qual quer nmero de componentes
El i pseX, sejam el es XControl s ou XObjects. Pode-se tambm ter vri as bi bl i otecas
di ferentes dentro do mesmo Domni o.
Note que para cada XObject ou XControl cri ado em uma bi bl i oteca so cri adas
268 Bibliotecas
i nternamente duas i nterfaces, uma para decl arar as propri edades do objeto, e
outra para decl arar os eventos do objeto. Estas i nterfaces tem seus nomes gerados
automati camente, acrescentando o prefi xo D a esse nome (a i nterface de eventos
adi ci ona o sufi xo Events ao nome automti co). Se, por exempl o, o objeto se
chama XObject1, sua i nterface de propri edades tem o nome DXObject1 e a
i nterface de eventos, DXObject1Events. Uma tentati va de usar estes nomes em
outras cl asses na mesma bi bl i oteca gera um cdi go de erro 8002802D, que
corresponde a Name already exists in the library.
9.2.1 XControls
O XControl defi ne uma i nterface grfi ca com o usuri o, que pode ser composta de
quai squer objetos do E3, e ter o propsi to de ser mul ti pl i cada faci l mente por um
projeto. Pode-se cri ar um XControl cl i cando com o boto di rei to do mouse sobre o
arqui vo LIB cri ado no Domni o, escol hendo a opo Inserir - XControl.
Aba Design de um XControl
Bibliotecas 269
Aba Propriedades de um XControl
Ao i nseri r um XControl , aberta a view deste objeto, composta por trs abas. Al m
da aba Scripts, presente em todos os objetos, exi ste a aba Design, que equi val e a
uma Tel a, onde podem ser i nseri dos os objetos grfi cos descri tos anteri ormente, e
a aba Propriedades, onde podem ser i nseri das vari vei s, que so as propri edades
do XControl . Estas propri edades sero exportadas pel o objeto e podero ser
associ adas a um Tag ou outra propri edade qual quer quando o objeto esti ver sendo
usado na apl i cao.
As vari vei s a serem exportadas podem ser i nseri das pressi onando-se a tecl a
INSERT do tecl ado ou cl i cando em e excl udos atravs da tecl a DELETE do tecl ado
ou cl i cando em . As opes di sponvei s deste i tem so as segui ntes:
OPO DESCRIO
Nome
Determi na o nome da vari vel do XControl .
270 Bibliotecas
OPO DESCRIO
Tipo
Determi na o ti po de dado suportado pel a
vari vel . Note que outros objetos de
Dados (XObjects) podem ser decl arados
como Ti pos. Desta forma, pode-se cri ar um
objeto de dados que possui como
propri edade outro objeto de dados. Os
objetos de dados podem funci onar neste
caso como uma struct ou cl asse, como
uti l i zado nas l i nguagens C/C++. Quando
for especi fi cado um ti po de objeto (por
exempl o DemoTag, I OTag, XObject, etc.),
esta propri edade ter o segui nte
comportamento:
Caso o ElipseX esteja inativo: A
propri edade funci ona como uma String,
que especi fi ca o cami nho da i nstnci a
de um objeto do ti po confi gurado
Caso o ElipseX esteja ativo: Na escri ta, a
propri edade funci ona como o caso
anteri or, porm na l ei tura a
propri edade retorna o objeto
especi fi cado, caso el e exi sta. Se o
cami nho no aponta para um objeto
exi stente no momento, a propri edade
retorna Nothing
Habi l i ta ou desabi l i ta a vi si bi l i dade da
vari vel fora da bi bl i oteca, i sto ,
determi na se a vari vel ser ou no
pbl i ca.
Determi na se a vari vel sal va no projeto
ou no.
Determi na se a propri edade retenti va
ou no. No caso de XControl s, as
propri edades no podem ser retenti vas.
Valor
Determi na o val or i ni ci al da vari vel .
Texto de ajuda
Texto de decl arao e documentao da
vari vel .
NOTA: i nteressante observar que podem ser decl arados como Ti pos os objetos de
Dados (XObjects).
A edi o do objeto grfi co pode ser fei ta da mesma forma como fei ta a edi o de
uma Tel a, possui ndo os mesmos recursos grfi cos e opes.
Pode-se i nseri r os XControl s em qual quer Tel a, ou ai nda dentro de outro XControl
cl i cando com o boto di rei to do mouse sobre a Tel a ou XControl de desti no,
escol hendo a opo Inserir, como mostrado a segui r. A parti r de um XControl em
Bibliotecas 271
desenvol vi mento (dentro da bi bl i oteca), possvel i nseri r outro XControl dentro
del e, cl i cando com o boto di rei to do mouse sobre o XControl de desti no, e
escol hendo a opo Inserir.
Inserindo um XControl na Tela
A parti r deste momento, o XControl ter um nome dentro da Tel a, e ser entendi do
como uma cpi a da defi ni o ori gi nal . Assi m, deve-se defi ni r (se necessri o) os
val ores ou as Associ aes que esta cpi a especfi ca ter no contexto que est
sendo uti l i zada. Se o tamanho deste objeto for al terado na view de Desi gn da
Bi bl i oteca e regi strado novamente, ser necessri o acessar a opo Tamanho
Original no seu menu de contexto da Tel a para que a al terao aparea.
Se for cri ado um objeto Bomba, por exempl o, que possui uma propri edade Estado,
que receber uma i nformao externa revel ando se a bomba est l i gada ou
desl i gada, fazendo com que el a mude sua cor. Ao i nseri r este objeto na Tel a, o E3
automati camente renomei a o objeto para Bomba1.
Pode-se manter este nome ou renome-l o para outro que se desejar. Depoi s, dever
ser i nformada qual vari vel ser associ ada propri edade Estado. Suponha que
certo Tag de Comuni cao representa o estado dessa bomba; l ogo, dever ser fei ta
uma Associ ao entre a propri edade Estado e o referi do Tag. O mesmo trabal ho
dever ser fei to para outras i nstnci as (cpi as) do objeto Bomba que se fi zerem
necessri as no projeto.
9.2.2 XObjects
Al m dos Objetos grfi cos XControl s, pode-se cri ar uma bi bl i oteca de dados,
denomi nada XObject. Com el a, pode-se defi ni r uma estrutura de dados, que ser
272 Bibliotecas
executada no servi dor. Tal estrutura poder real i zar cl cul os, Associ aes,
comuni caes, veri fi cao de al armes, regi stro hi stri co, etc., que i ndependam de
que al guma i nterface grfi ca (Vi ewer) esteja aberta ou sendo executada naquel e
momento. Para cri ar um XObject, cl i que com o boto di rei to do mouse no i tem
Bibliotecas de Objetos - XObjects no modo Domnio e escol ha a opo Inserir
XObject em e l ogo aps o nome da bi bl i oteca desejada.
XObjects
Ao i nseri r um XObject, aberta a view deste objeto, onde podem ser i nseri das
vari vei s. Estas vari vei s so as propri edades a serem exportadas pel o objeto, que
podero ser associ adas a um Tag ou outra propri edade qual quer de uma apl i cao
quando o objeto esti ver sendo usado em uma apl i cao.
As vari vei s a serem exportadas podem ser i nseri das pressi onando-se a tecl a
INSERT do tecl ado ou cl i cando em e excl udos atravs da tecl a DELETE ou
cl i cando em . As opes di sponvei s deste i tem so as segui ntes:
Opes disponveis na view dos XObjects
OPO DESCRIO
Nome
Determi na o nome da vari vel do XObject.
Bibliotecas 273
OPO DESCRIO
Tipo
Determi na o ti po de dado suportado pel a
vari vel . Note que outros objetos de
Dados (XObjects) podem ser decl arados
como Ti pos. Desta forma, pode-se cri ar um
objeto de dados que possui como
propri edade outro objeto de dados. Os
objetos de dados podem funci onar neste
caso como uma struct ou cl asse, como
uti l i zado nas l i nguagens C/C++. Quando
for especi fi cado um ti po de objeto (por
exempl o DemoTag, I OTag, XObject, etc.),
esta propri edade ter os segui nte
comportamento:
Caso o ElipseX esteja inativo: A
propri edade funci ona como uma String,
que especi fi ca o cami nho da i nstnci a
de um objeto do ti po confi gurado
Caso o ElipseX esteja ativo: Na escri ta, a
propri edade funci ona da mesma
manei ra de quando o objeto est
desati vado. Porm, na l ei tura a
propri edade retorna o objeto
especi fi cado, caso el e exi sta. Se o
cami nho no aponta para um objeto
exi stente no momento, a propri edade
retorna Nothing
Habi l i ta ou desabi l i ta a vi si bi l i dade da
vari vel fora da bi bl i oteca, i sto ,
determi na se a vari vel ser ou no
pbl i ca.
Determi na se a vari vel sal va no projeto
ou no.
Determi na se a propri edade retenti va
ou no.
Valor
Determi na o val or i ni ci al da vari vel .
Texto de ajuda
Texto de decl arao e documentao da
vari vel .
Apenas propri edades de ti pos si mpl es (Variant, String, Date, Double, etc.) podem
ser retenti vas (a view i r desmarcar automati camente a col una se o ti po de uma
propri edade for al terado para um ti po de objeto), e apenas propri edades de
XObjects podem ser retenti vas.
274 Bibliotecas
NOTA: O uso de propri edades retenti vas nos El i pseX pode aumentar o tempo de
i nci o do apl i cati vo, e tambm aumentar o consumo de memri a pel o processo
E3Run. Os tempos vari am dependendo do nmero de i nstnci as de XObjects,
nmero de propri edades retenti vas em cada XObject, e a quanti dade destas
propri edades que possuem o seu val or al terado (se a propri edade nunca for
al terada, o val or retenti vo del a fi ca zerado).
Podem ser i nseri dos em um XObject quai squer mdul os do E3 que sejam
executados no servi dor, a saber:
Dri ver de Comuni cao e Dri ver de Comuni cao OPC
Servi dor de al armes e al armes
Servi dor de Banco de Dados
Frmul as
Servi dor de Dados
Hi stri cos
Isto permi te que se possa defi ni r como uma bi bl i oteca, um si stema compl exo de
gerenci amento, que poder ser faci l mente repl i cado quantas vezes forem
necessri as em um apl i cati vo.
IMPORTANTE: Veja que tanto os XControl s quanto os XObjects s podero se
rel aci onar com o mundo externo atravs das propri edades (ou ai nda atravs do
mouse e tecl ado, no caso dos XControl s). I sso si gni fi ca que no se pode acessar
dados i nternos de um XObject ou XControl seno de dentro do prpri o objeto.
Pode-se i nseri r os XObjects em qual quer Servi dor de Dados, cl i cando com o boto
di rei to do mouse sobre o Servi dor de Dados no modo Domnio, escol hendo a opo
Inserir e l ogo aps o nome do XObject desejado, conforme mostrado na fi gura a
segui r. No modo Explorer, cl i que com o boto di rei to do mouse sobre o Servi dor de
Dados do projeto, sel eci one a opo Inserir e l ogo aps o nome do XObject
desejado.
Bibliotecas 275
Inserindo um XObject no modo Domnio
Note que mesmo se os arqui vos de bi bl i oteca possurem vri os XControl s e
XObjects, ao tentar i nseri r uma i nstnci a (cpi a), o E3 Studi o exi bi r para as Tel as
somente os XControl s, e para os Servi dores de Dados somente os XObjects
di sponvei s.
NOTA: Deve-se cui dar para no apagar uma propri edade de um XControl ou XObject
que possua uma Associ ao. Essas propri edades, uma vez apagadas, no
aparecem mai s na l i sta de propri edades do objeto, e por i sso no podero ser
edi tadas. Quando for executada a operao Verificar Domnio, ser fei ta uma
procura por essas propri edades e o usuri o consul tado se deseja remover essa
Associ ao ou no.
276 Bibliotecas
Propriedade invlida
Pode-se optar por no remover e ento cri ar novamente o objeto que foi apagado
com a propri edade que se deseja edi tar, remover apenas a propri edade que est
sendo mostrada, remover todas as propri edades ou no remover nenhuma
propri edade.
9.3 Quando Criar um ElipseX
O uso de Bi bl i otecas al tamente recomendvel devi do ao ganho de produti vi dade
que trazem. Al gumas das vantagens dos El i pseX so:
Reuti l i zao de cdi go
Mi ni mi zao de testes durante o desenvol vi mento
Cri ao de i nterface padro para os objetos desenvol vi dos
Di mi nui o do tempo de desenvol vi mento de novos projetos
Proteo do contedo do projeto
Logo, o uso de bi bl i oteca recomendado para a mai ori a das apl i caes.
Entretanto, exi stem al guns cri tri os para i ndi car a necessi dade da construo de
objetos no E3:
Repetio no uso: se um mesmo equi pamento ou processo ser usado mai s de
uma vez no mesmo projeto
Procedimentos do conhecimento do usurio: frequentemente, um processo cri ado
por determi nada empresa deve ser protegi do de cpi a ou al terao. Isso
comum no caso de i ntegradores de servi os ou fabri cantes de mqui nas
Uso de controladores: um control ador de processo, cujo mapeamento de
memri a fi xo, pode ser i mpl ementado com todas as funci onal i dades
di sponvei s. A fl exi bi l i dade di sponvel para a construo e uso dos objetos no E3
permi te que sejam uti l i zadas posteri ormente apenas as vari vei s de i nteresse,
desprezando-se as demai s
Bibliotecas 277
NOTA: Para exempl os de cri ao de El i pseX e mai ores i nformaes sobre estes
objetos, consul te o Manual de Referncia de Scripts.
278 ActiveX
10
ActiveX
CAPTULO
Os objetos ActiveX so componentes de software baseados na tecnol ogi a COM
(Component Object Model) que podem ser i nseri dos em uma apl i cao para
real i zar di versas tarefas. Estes objetos so desenvol vi dos em ambi entes de
programao tai s como C/C++, Del phi e Vi sual Basi c, entre outros.
Al guns objetos Acti veX so automati camente regi strados quando o E3 i nstal ado:
E3Al arm, E3Browser e E3Chart (desenvol vi dos pel a El i pse Software); Mi crosoft
Forms (desenvol vi dos pel a Mi crosoft); e Rel atri o (Acti veReports, desenvol vi do
pel a Data Dynami cs). Os objetos E3Alarm, E3Browser, E3Chart e Relatrio possuem
captul os especfi cos mai s adi ante neste Manual . Os objetos Microsoft Forms so
descri tos em outra seo deste captul o.
NOTA: Para objetos Acti veX no i nstal ados previ amente pel o E3, necessri o que
estes objetos sejam i nstal ados em todos os computadores onde a apl i cao i r
rodar, especi al mente em Vi ewers Remotos.
Al m destes, pode-se i nseri r qual quer outro objeto Acti veX. Para regi strar um
objeto Acti veX no E3, si ga estes procedi mentos:
1. Sel eci one o menu Ferramentas - Gerenciar ActiveX. A cai xa de di l ogo a segui r
ser mostrada.
Janela Gerenciar Controles ActiveX
ActiveX 279
A janel a Gerenci ar Control es Acti veX possui as segui ntes opes:
Opes da janela Gerenciar Controles ActiveX
OPO DESCRIO
Controles registrados no Windows
Li stagem com todos os control es Acti veX
regi strados no Wi ndows e que podem ser
adi ci onados ao E3.
Controles registrados no E3
Li stagem com todos os control es Acti veX j
regi strados no E3.
Registrar
Regi stra o control e sel eci onado no E3.
Caso o control e seja i ncompatvel com o
E3, uma cai xa de di l ogo mostrada
avi sando o usuri o a respei to da
i ncompati bi l i dade.
Remover
Remove o control e sel eci onado da l i sta
Controles registrados no E3, movendo-o de
vol ta para a l i sta Controles registrados no
Windows. Os control es com o cone no
podem ser removi dos, somente os que
ti verem o cone .
Procurar
Abre uma cai xa de di l ogo para l ocal i zar
um arqui vo Acti veX.
Atualizar
Permi te atual i zar os control es Acti veX na
l i stagem Controles registrados no Windows
que tenham si do regi strados aps a
abertura da janel a de gerenci amento.
Fechar
Fecha a janel a de gerenci amento dos
Acti veX.
2. Cl i que em Procurar para abri r uma cai xa de di l ogo e l ocal i zar o arqui vo que
contm o Acti veX.
280 ActiveX
Localizao do arquivo ActiveX
3. Sel eci one o arqui vo desejado e cl i que em Abrir.
Os objetos Acti veX podem ser de doi s ti pos: Grficos (uti l i zados nas Tel as da
apl i cao) e No-Grficos (real i zam al gum ti po de mani pul ao de dados).
Os objetos grfi cos podem ser i nseri dos na apl i cao de trs formas di ferentes:
Atravs da barra de ferramentas Objetos, sel eci onando o objeto desejado
Atravs do cl i que com o boto di rei to do mouse no objeto Tel a, no Organi zer,
sel eci onando a opo Inserir
Atravs do cl i que com o boto di rei to do mouse na Tel a, sel eci onando a opo
Inserir
ActiveX 281
Inserindo um objeto grfico na Tela
Os objetos no-grfi cos podem ser usados na apl i cao atravs de scri pts e so
cri ados pel o mtodo CreateObject, padro do VBScri pt.
10.1 Objetos Microsoft Forms
Para i nseri r um dos objetos Mi crosoft Forms previ amente regi strados no E3 na
apl i cao, exi stem duas opes:
1. Cl i que com o boto di rei to do mouse na Tel a e sel eci one a opo Inserir -
MSForms.
2. Sel eci one o objeto desejado na barra de ferramentas Objetos; aps, cl i que na
Tel a para estabel ecer o ponto i ni ci al do desenho do objeto, arrastando o
mouse di agonal mente at o objeto ati ngi r o tamanho e a posi o desejados.
Os objetos da bi bl i oteca Mi crosoft Forms di sponvei s no E3 so descri tos nas
sees segui ntes.
10.1.1 Caixa de Seleo
Indi ca se uma determi nada opo est sel eci onada ou no, ou ai nda se est
parci al mente sel eci onada. Permi te sel ees ml ti pl as em um grupo. i nseri do na
Tel a ao sel eci onar o cone .
282 ActiveX
10.1.2 Boto de Opo
Indi ca se uma opo est sel eci onada ou no. Ao contrri o da Cai xa de Sel eo, no
entanto, apenas um destes objetos pode ser sel eci onado em um grupo; no E3, este
control e deve ser fei to manual mente, atravs de scri pts que confi gurem a
propri edade Value dos demai s Botes de Opo para 0 (zero) quando um del es for
cl i cado. i nseri do na Tel a ao sel eci onar o cone .
10.1.3 Lista de Seleo
Combi na as funci onal i dades de uma Li sta e de um Edi tor de Texto: neste objeto,
pode-se tanto di gi tar um val or di retamente ou sel eci onar um i tem de uma l i sta pr-
estabel eci da. i nseri do na Tel a ao sel eci onar o cone .
10.1.4 Boto de Comando
Usado para executar aes especfi cas quando pressi onado, tai s como abri r uma
janel a, i mpri mi r um rel atri o, etc. i nseri do na Tel a ao sel eci onar o cone .
10.1.5 Texto
Exi be mensagens de texto que no podem ser edi tadas pel o usuri o, como
descri es de control es ou l egendas. i nseri do na Tel a ao sel eci onar o cone .
10.1.6 Lista
Exi be uma l i sta de i tens dentre os quai s o usuri o pode escol her um ou mai s.
i nseri do na Tel a ao sel eci onar o cone .
10.1.7 Barra de Rolagem
Faci l i ta a navegao atravs de uma l onga l i sta de i tens ou de uma grande
quanti dade de i nformao tanto hori zontal mente quanto verti cal mente. i nseri do
na Tel a ao sel eci onar o cone .
10.1.8 Boto de Incremento e Decremento
Usado para i ncrementar ou decrementar val ores atravs de seu par de setas.
i nseri do na Tel a ao sel eci onar o cone .
10.1.9 Editor de Texto
Possi bi l i ta ao usuri o i nseri r e edi tar textos. i nseri do na Tel a ao sel eci onar o
cone .
ActiveX 283
10.1.10 Boto Liga e Desliga
Permi te atri bui r um de doi s estados a um outro objeto de Tel a. i nseri do na Tel a
ao sel eci onar o cone .
10.2 Elipse KeyPad
O El i pse KeyPad um control e Acti veX desenvol vi do pel a El i pse Software, que
permi te uti l i zar um tecl ado vi rtual fl utuante em apl i caes desenvol vi das com o
E3.
Este control e pode ser ati vado no Vi ewer uti l i zando a aba Visualizador das
propri edades do objeto Vi ewer.
Aba Visualizador do Viewer
As opes di sponvei s desta aba so as segui ntes:
284 ActiveX
Opes disponveis para o Elipse KeyPad na aba Visualizador
OPO DESCRIO
Mostrar quando um SetPoint recebe o foco
Esta opo faz com que o El i pse KeyPad
seja mostrado sempre que um objeto do
ti po SetPoi nt receba o foco.
Esconder ao pressionar ENTER
Habi l i ta ocul tar o El i pse KeyPad ao
pressi onar a tecl a ENTER. Esta opo
equi val e propri edade AutoHideOnEnter
do control e.
Esconder ao pressionar ESC
Habi l i ta ocul tar o El i pse KeyPad ao
pressi onar a tecl a ESC. Esta opo
equi val e propri edade AutoHideOnEsc do
control e.
Em scri pts, o KeyPad pode ser aci onado uti l i zando-se o mtodo GetKeyPad do
objeto Appl i cati on. Demai s i nformaes sobre as funci onal i dades das
propri edades deste objeto podem ser encontradas no Manual de Referncia de
Scripts, em seu captul o respecti vo.
Servidor de Dados 285
11
Servidor de Dados
CAPTULO
Os Servidores de Dados so os objetos responsvei s por abri gar a execuo das
vari vei s do si stema como Tags Internos, Tags Demo, Tags Ti mer, e i nstnci as de
XObjects. Para uti l i zar este recurso, si ga este procedi mento:
1. Cl i que com o boto di rei to do mouse sobre o projeto no Organi zer e sel eci one a
opo Inserir - Servidor de Dados.
Inserindo um Servidor de Dados
NOTA: Os objetos do Servi dor de Dados (Pasta de Dados, Tag Contador, Tag Demo,
Tag I nterno e Tag Ti mer) podem ser confi gurados para funci onarem como reas de
Alarme.
11.1 Pasta de Dados
A Pasta de Dados defi ne grupos, de forma a organi zar as vari vei s. Caso haja
necessi dade, novas Pastas podem ser i nseri das dentro de outras. Para uti l i zar este
recurso, si ga este procedi mento:
1. Cl i que com o boto di rei to do mouse sobre o Servi dor de Dados e sel eci one a
opo Inserir - Panel - Pasta de Dados.
286 Servidor de Dados
Inserindo uma Pasta de Dados
11.2 Tag Contador
O Tag Contador um objeto que faz a contagem de tempo (em segundos) at ati ngi r
um val or predetermi nado, ou que faz uma certa contagem i ndefi ni damente. Para
uti l i zar este recurso, si ga estes procedi mentos:
opo Inserir - Panel - Tag Contador.
Inserindo um Tag Contador
2. O si stema abre uma janel a perguntando quantos Tags sero cri ados no
servi dor, e qual seu nome. Este nome ser auto-i ncrementado; se a opo for
dei xada em branco, os Tags sero cri ados com o nome padro.
Inserindo Tags Contador
As propri edades do Tag Contador podem ser confi guradas atravs da Li sta de
11.3 Tag Demo
O Tag Demo um objeto que gera val ores de acordo com a forma de onda, e
uti l i zado para si mul ao de val ores. Permi te gerar ondas defi ni das ou val ores
al eatri os. Para uti l i zar este recurso, si ga estes procedi mentos:
opo Inserir - Panel - Tag Demo.
Inserindo um Tag Demo
Inserindo Tags Demo
As propri edades do Tag Demo podem ser confi guradas atravs da Li sta de
11.4 Tag Interno
O Tag Interno um objeto de propsi to genri co, uti l i zado para guardar val ores de
qual quer ti po, i ncl ui ndo nmeros, textos e at outros objetos. Para uti l i zar este
objeto, si ga estes procedi mentos:
opo Inserir - Panel - Tag Interno.
Inserindo um Tag Interno
Inserindo um Tag Interno
Inserindo Tags Internos
As propri edades do Tag Interno podem ser confi guradas atravs da Li sta de
11.5 Tag Timer
O Tag Timer um objeto para contagem de tempo e agendamento de ati vi dades. El e
estabel ece horri os (com repeti es) para executar aes. Para uti l i zar este objeto,
opo Inserir - Panel - Tag Timer.
Inserindo um Tag Timer
Inserindo Tags Timer
As propri edades do Tag Ti mer podem ser confi guradas atravs da Li sta de
294 Banco de Dados
12
Banco de Dados
CAPTULO
O Banco de Dados do E3 uti l i zado para armazenar as i nformaes do projeto
referentes a Hi stri cos, Frmul as, Al armes e Storage. Suporta os formatos Access
(.mdb), Oracl e e Mi crosoft SQL Server.
Para uti l i zar este recurso, cl i que com o boto di rei to do mouse sobre o nome do
projeto no Expl orer e sel eci one a opo Inserir - Banco de Dados. No modo Domnio,
cl i que com o boto di rei to do mouse no i tem Objetos de Servidor - Banco de Dados,
sel eci one a opo Inserir - Banco de Dados em e l ogo aps o nome do projeto
desejado.
Inserindo um Banco de Dados no modo Domnio
Ao i nseri r o Banco de Dados na apl i cao, so habi l i tadas as opes referentes ao
ti po de Servi dor de Banco de Dados, atravs da aba Configurao na Janel a de
Propri edades, ou da propri edade SourceType, na Li sta de Propri edades.
Banco de Dados 295
Al gumas das propri edades deste objeto podem ser confi guradas atravs da Li sta de
Propri edades, sem a necessi dade da cri ao de scri pts para i sto. Para i sto, basta
l ocal i z-l a e efetuar os devi dos ajustes. Demai s i nformaes sobre as
funci onal i dades das propri edades deste objeto podem ser encontradas no Manual
de Referncia de Scripts, em seu captul o respecti vo.
NOTA: o objeto Banco de Dados pode ser confi gurado para funci onar como rea de
Alarme.
12.1 Access
Gera uma base de dados no formato .mdb, o formato padro de banco de dados no
E3. Para uti l i zar este recurso, si ga estes procedi mentos:
sel eci one a opo Inserir - Banco de Dados. No modo Domnio, cl i que com o
boto di rei to do mouse no i tem Objetos de Servidor - Banco de Dados, sel eci one
a opo Inserir Banco de Dados em e l ogo aps o nome do projeto desejado. O
objeto cri ado no projeto, e sua janel a de edi o de scri pts aberta.
2. Para confi gur-l o, acesse a aba Configuraes da Janel a de Propri edades.
296 Banco de Dados
Configuraes para Banco de Dados Access
As opes di sponvei s nesta aba so:
OPO DESCRIO
Banco de Dados
Sel eci ona o ti po de Banco de Dados em
uso no projeto: 0 - stAccess, 1 - stOracle ou
2 - stSqlServer.
Arquivo MDB
Nome do arqui vo .mdb uti l i zado no
projeto.
Senha do BD
Senha do Banco de Dados Access.
Usurio
Usuri o do Banco de Dados conectado
pel o E3.
Senha
Senha do usuri o que real i zar o l ogon.
Testar conexo
Testa a conexo com o Banco de Dados.
Banco de Dados 297
3. No campo Banco de Dados, sel eci one a opo 0 - stAccess.
4. Insi ra o nome do arqui vo desejado (exi stente ou no) no campo Arquivo MDB
(conforme fi gura anteri or).
5. Caso seja necessri o, confi gure as opes Usurio, Senha e Senha do BD de
acordo com as defi ni es do Access. Tai s i tens podem fi car em branco; neste
caso, a apl i cao assume as confi guraes padro do E3.
6. Cl i que em OK para fi nal i zar as confi guraes.
12.2 Oracle
A uti l i zao do Oracl e como servi dor de Banco de Dados do E3 s possvel
atravs da i nstal ao de um servi dor ou cl i ente Oracl e na mqui na onde ser
executado o E3 Server. Nesta i nstal ao devem estar presentes, obri gatori amente, o
suporte a OCI (Oracle Call Interface) e o OLEDB Provi der para Oracl e, necessri os
para a comuni cao do E3 com o Oracl e. Para i nstal ar o Oracl e, consul te a
documentao prpri a do produto.
O acesso ao banco de dados Oracl e pode ser fei to de duas manei ras: acessando o
Banco de Dados Oracl e de dentro do E3 ou vi a scri pts. A segui r sero expl i cados
cada um destes procedi mentos.
12.2.1 Acessando o Oracle via E3
Para i nseri r um novo Banco de Dados Oracl e, si ga estes procedi mentos:
sel eci one a opo Inserir - Banco de Dados. No modo Domnio, cl i que com o
boto di rei to do mouse no i tem Objetos de Servidor - Banco de Dados, sel eci one
a opo Inserir Banco de Dados em e l ogo aps o nome do projeto desejado. O
objeto cri ado no projeto, e sua janel a de edi o de scri pts aberta.
298 Banco de Dados
Configuraes para Banco de Dados Oracle
OPO DESCRIO
Banco de Dados
uso no projeto: 0 - stAccess, 1 - stOracle ou
2 - stSqlServer.
Conexo
Nome da conexo forneci do pel o
admi ni strador do banco de dados.
Banco de Dados 299
OPO DESCRIO
Usar tipo TIMESTAMP
Permi te uti l i zar o ti po de dados
TIMESTAMP do Oracl e, com preci so de
mi l i ssegundos e di sponvel a parti r da
verso 9.0. Caso esta opo esteja
desabi l i tada, usado o ti po de dados
DATE, com preci so de segundos. NOTA:
Para que o objeto Consul ta do E3 seja
compatvel com tabel as que uti l i zem o
ti po de dados TIMESTAMP, deve ser
habi l i tada a opo Usar drivers ADO
Oracle.
Usar drivers ADO Oracle
Permi te usar as i nterfaces ADO (ActiveX
Data Objects) do Oracl e para que o objeto
Consul ta do E3 reconhea o ti po de
dados TIMESTAMP. Assi m possvel l er
regi stros de tabel as do Oracl e que
possuam preci so de mi l i ssegundos.
Usurio
Usuri o do Banco de Dados conectado
pel o E3.
Senha
Testar conexo
3. No campo Banco de Dados, sel eci one a opo 1 - stOracle.
4. Se o servi dor Oracl e for l ocal , o campo Conexo pode fi car em branco, poi s o
E3 recupera os dados automati camente. Do contrri o, a conexo ser cri ada
usando o cl i ente Oracl e i nstal ado na mqui na.
5. Caso seja necessri o, confi gure as opes Usurio e Senha de acordo com as
defi ni es do Oracl e. Tai s i tens podem fi car em branco; neste caso, a
apl i cao assume as confi guraes padro do E3.
Ao i nseri r o Banco de Dados na apl i cao, so habi l i tadas as opes referentes ao
ti po de Servi dor de Banco de Dados. O Servi dor de Banco de Dados o responsvel
pel o gerenci amento e armazenamento das i nformaes dos objetos que uti l i zam
esse servi o.
12.2.2 Acessando o Oracle via Scripts
Scripts so mdul os de l i nguagem de programao onde se pode cri ar l i nhas de
cdi go, que permi tem mai or fl exi bi l i dade para a associ ao de aes a eventos
especfi cos. Cada i tem de um projeto do E3 possui uma l i sta de eventos
previ amente associ ados. Assi m, o usuri o poder cri ar programas que sero
executados na ocorrnci a de um evento.
O E3 uti l i za o VBScri pt (Visual Basic Script) em seus scri pts, e com el e consegue
i nstanci ar qual quer objeto Acti veX regi strado no si stema. Para o acesso ao Banco
300 Banco de Dados
de Dados, o Acti veX mai s uti l i zado o ADO, que pode ser faci l mente mani pul ado
nos scri pts do E3.
Pri mei ramente, necessri a a cri ao de uma conexo ADO que pode ser fei ta com
o scri pt a segui r:
Set DBConnection = CreateObject("ADODB.Connection")
DBConnection.Open "Provider=MSDAORA;_
DataSource=conexaoOracle;User_
ID=UserID;Password=passwd"
Depoi s da cri ao da conexo, possvel executar um comando SQL di retamente
sobre a conexo, como mostrado a segui r:
DBConnection.Execute _
"UPDATE Tabela SET nome = 'Joo' WHERE id = 10"
possvel tambm a vi sual i zao de todos os regi stros desejados, retornados na
forma de um Recordset (consul ta), como mostrado a segui r:
Set Recordset = CreateObject("ADODB.Recordset")
Recordset.Source = "Tabela"
Recordset.ActiveConnection = DbConnection
Recordset.CursorType = 1 ' adOpenKeyset
Recordset.LockType = 3 ' adLockOptimistic
Recordset.Open
A parti r deste momento, possvel navegar pel a tabel a uti l i zando-se os comandos
MoveNext e MovePrevious, bem como uma sri e de outros comandos forneci dos
pel o ADO. possvel tambm uti l i zar uma consul ta SQL para mani pul ar partes
especfi cas da tabel a, atravs da propri edade Source.
12.2.3 Tecnologias Utilizadas pelo E3 para Acessar
o Oracle
O E3 uti l i za basi camente duas tecnol ogi as para acessar o Banco de Dados Oracl e:
ADO (ActiveX Data Object) e OCI (Oracle Call Interface).
ADO a tecnol ogi a uti l i zada pel o E3Browser e E3Chart para recuperao dos
dados armazenados no Banco de Dados. O ADO tambm ampl amente uti l i zado
nos scri pts do E3 para todo ti po de operao junto ao Banco de Dados. El e um
conjunto de objetos COM (Component Object Model) cri ado para acessar
i nformaes de SGBD usando OLE DB (Object Linking and Embedding). Essa
tecnol ogi a fi ca di sponvel quando se i nstal a o OLE DB Provi der para Oracl e
(MSDAORA). El a faz o acesso i nterface nati va do Oracl e, a OCI.
A OCI uti l i zada pel o Servi dor de Banco de Dados do E3 para i mpl ementar os
servi os de Banco de Dados uti l i zados pel os Hi stri cos, Frmul as, Al armes e
Storage. Atravs da OCI se acessa di retamente as funes do Oracl e, tornando este
processo o mai s oti mi zado possvel . El a fornece uma bi bl i oteca padro de acesso
Banco de Dados 301
ao Banco de Dados e funes de recuperao de dados na forma de uma DLL ou LIB,
que pode ser conectada a uma apl i cao em tempo de execuo.
12.2.4 Acessando o Oracle via Servidor BD
O Servi dor de Banco de Dados do E3 uti l i za a OCI (Oracle Call Interface) para se
comuni car com o servi dor Oracl e, ou seja, uti l i za a forma nati va do Banco de
Dados para ganhar em performance na comuni cao com o Banco de Dados.
Um bom exempl o de como funci ona a comuni cao do Servi dor de Banco de Dados
do E3 com o Oracl e o Hi stri co. Ini ci al mente fei ta a aqui si o dos dados pel o
Hi stri co, que de posse destes dados, i medi atamente os envi a em forma de
requi si es para o Banco de Dados. Estas requi si es podem ser para cri ao de
uma tabel a, cri ao de ndi ces e chaves, adi o de dados, etc. O Servi dor de Banco
de Dados do E3 possui um processo separado especi al mente para receb-l as.
Dependendo do ti po de operao a ser real i zada, os dados so formatados e
armazenados em arqui vo ou em memri a temporri os.
Ao mesmo tempo, o Banco de Dados possui mai s um outro processo, responsvel
pel a recuperao das aqui si es e posteri or envi o para o banco de dados em
forma de comandos SQL, uti l i zando a OCI.
302 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.
12.3.1 Acessando o SQL Server via E3
Para i nseri r um novo Banco de Dados SQL Server, si ga estes procedi mentos:
1. Cl i que com o boto di rei to do mouse sobre o cone do projeto, e sel eci one a
opo Inserir - Banco de Dados. O objeto cri ado no projeto, e sua janel a de
edi o de scri pts aberta.
Banco de Dados 303
Configuraes para o Banco de Dados SQL Server
OPO DESCRIO
Banco de Dados
uso no projeto: 0 - stAccess, 1 - stOracle ou 2 -
stSqlServer.
Servidor
Nome do servi dor.
Banco de Dados
Nome do Banco de Dados.
Biblioteca de Rede
Bi bl i oteca de rede uti l i zada pel o ADO: 0 -
Padro, 1 - Named Pipes, 2 - Winsock TCP/IP, 3 -
SPX/IPX, 4 - Banyan Vines ou 5 - Multi-Protocol
(RCP).
304 Banco de Dados
OPO DESCRIO
Alterar string de conexo
Esta cai xa de sel eo permi te modi fi car a
String de conexo a um banco de dados SQL
Server. As segui ntes restri es se apl i cam a
esta opo:
As al teraes fei tas NO SO val i dadas
pel o E3. Portanto, de i ntei ra
responsabi l i dade do usuri o a correta
confi gurao da String customi zada.
Se esta cai xa de sel eo esti ver
desmarcada, o E3 uti l i zar o formato
padro para real i zar a conexo.
A String de conexo acei ta duas macros:
{SERVER}, que ser substi tuda pel o
nome do servi dor confi gurado em
Servidor; e {DB}, que ser substi tuda
pel o nome do banco de dados
confi gurado em Banco de Dados.
Usurio
Usuri o do Banco de Dados conectado pel o
E3. Dependendo do ti po de objeto a ser
uti l i zado no projeto, dever ter di ferentes
ti pos de permi sso.
Senha
Testar conexo
3. No campo Banco de Dados, sel eci one a opo 2 - stSqlServer.
4. Caso seja necessri o, confi gure as opes Usurio e Senha de acordo com as
defi ni es do SQL Server. Tai s i tens podem fi car em branco; neste caso, a
apl i cao assume as confi guraes padro do E3.
12.3.2 Exemplo de Utilizao do SQL Server 2000
Para i l ustrar o acesso ao SQL Server 2000, faremos a cri ao de um Hi stri co
regi strando dados por tempo de varredura de um segundo. Os procedi mentos sero
mostrados a segui r.
1. Cri e um Tag Demo. As confi guraes deste Tag no necessi tam ser al teradas.
2. D um dupl o cl i que no Servi dor de Banco de Dados e acesse a janel a de
confi gurao do Servi dor SQL. Os parmetros devero ser al terados para se
adequarem s confi guraes di sponvei s na i nstal ao do SQL Server.
3. Faa as confi guraes necessri as nesta janel a, tai s como nome do servi dor,
usuri o, senha e Banco de Dados.
4. Fei ta a confi gurao do Banco de Dados, deve-se confi gurar o Hi stri co que
acessar esse banco. Para tanto, pri mei ramente devemos cri ar um campo no
Banco de Dados 305
Hi stri co e i nseri r o Tag Demo, que ser uti l i zado para o envi o de di ferentes
val ores ao Banco de Dados.
Histrico e suas configuraes
5. Acesse as propri edades do Hi stri co cl i cando em Propriedades do Histrico
e determi ne o servi dor de Banco de Dados e o nome da tabel a. As demai s
confi guraes devem permanecer i nal teradas. A tabel a servi r para a busca de
dados no E3 e tambm para vi sual i zar o uso da ferramenta SQL Server Anal yzer,
que o cl i ente usado para consul tas no SQL Server.
6. Fi nal i zada a confi gurao do Hi stri co, ser necessri a a cri ao da estrutura
de tabel as no Servi dor de Banco de Dados. Para i sso, cl i que em Gerar
estrutura no BD. Uma mensagem de confi rmao da cri ao da estrutura de
tabel as ser mostrada na tel a. Caso haja al gum erro, deve-se l ocal i zar o
probl ema.
7. Para vi sual i zar o Hi stri co em ao (sal vando dados no servi dor SQL Server),
cri e uma Tel a, i nsi ra um E3Browser e confi gure-o para acessar o Servi dor de
Banco de Dados, como expl i cado anteri ormente no Hi stri co, e confi gure o
E3Browser para ser atual i zado automati camente a cada 10 segundos, por
exempl o.
8. Fei tas as confi guraes, execute o projeto. Depoi s de al gum tempo executando
o projeto, o E3Browser passar a exi bi r os dados que esto sendo envi ados ao
servi dor.
9. possvel consol i dar os dados que sero mostrados no E3 e os que esto
sal vos no servi dor uti l i zando o objeto Consul tas do E3Browser e o software
SQL Query Anal yzer. Para i sso, cri e di ferentes consul tas no Banco de Dados e
edi te-as na Consul ta e tambm no Query Anal yzer. Os resul tados devero ser
os mesmos, se o Domni o esti ver parado, ou semel hantes, se o Domni o esti ver
rodando. Essa di ferena deve-se atual i zao constante do Banco de Dados
quando o Domni o est sendo executado. Para a edi o de consul tas no objeto
Consul ta, habi l i te a opo Habilita edio direta do SQL.
306 Banco de Dados
12.3.3 Uso de ADODB para Acesso via Script
Para acesso ao SQL Server atravs de scri pts, usa-se uma conexo ADODB. A String
de conexo a esse ti po de Banco de Dados deve ser confi gurada conforme o model o
a segui r:
DRIVER={SQL Server};SERVER=server;UID=login_id;PWD=password;
O uso deste ti po de acesso deve ser restri to a casos onde no exi sta outra sol uo.
O E3 di sponi bi l i za recursos que vi sam mi ni mi zar o uso desses acessos vi a scri pt.
Entretanto, eventual mente o uso desse recurso pode ser necessri o.
12.4 Objetos do E3 e Permisses
necessri o confi gurar as permi sses no Banco de Dados para a uti l i zao dos
objetos do E3 em um projeto. Estas permi sses so l i stadas a segui r:
Permisses
OBJETO PERMISSES
Frmulas
Permi sso compl eta.
Histrico de usurio
Escreve e consul ta as tabel as exi stentes.
Histrico
Servidor de Alarmes
Nas permi sses, a expresso Permisso completa si gni fi ca que o usuri o ter
permi sses para:
Cri ar ou remover tabel as exi stentes
Cri ar ndi ces e chaves
Inseri r e excl ui r dados nas tabel as cri adas
Real i zar consul tas sobre as tabel as resul tantes
O usuri o no preci sa ser um Admi ni strador para possui r Permi sso Compl eta em
qual quer objeto.
Alarmes 307
13
Alarmes
CAPTULO
O E3 di spe de um conjunto de objetos que permi te ao usuri o moni torar al armes
em uma apl i cao. Com el es, possvel especi fi car e gerenci ar al armes e eventos
de vari vei s de um processo. As condi es de al arme podem ser gerenci adas em
di versas fontes. O si stema composto de um objeto central i zador de al armes,
chamado Servidor de Alarmes, e de um ou mai s objetos de confi gurao, chamado
Configurao de Alarmes. As sees a segui r detal haro estes objetos.
13.1 Configurao de Alarmes
O objeto Configurao de Alarmes o l ocal onde as reas so i nseri das e
organi zadas. Para i nseri r este objeto em seu projeto, si ga este procedi mento:
1. Cl i que com o boto di rei to do mouse sobre o nome do projeto no Expl orer e
sel eci one a opo Inserir - Configurao de Alarmes. No modo Domnio, cl i que
com o boto di rei to do mouse no i tem Objetos de Servidor - Alarmes, sel eci one
a opo Inserir Configurao de Alarmes em, e l ogo aps o nome do projeto.
Inserindo o objeto Configurao de Alarmes
308 Alarmes
13.1.1 reas de Alarme
As reas de Alarme permi tem agrupar um conjunto de Fontes de Al armes, bem
como outras reas. Isto faci l i ta o gerenci amento, a operao e o moni toramento de
um conjunto de Fontes de Al arme rel aci onadas, como por exempl o:
Fi l trar o conjunto de al armes vi svei s no sumri o
Habi l i tar ou desabi l i tar um conjunto de Fontes de Al armes
Reconhecer um conjunto de Fontes de Al armes
Veri fi car o total de al armes ati vos ou no reconheci dos de um conjunto de
Fontes de Al armes
Caso haja necessi dade, novas reas podem ser i nseri das dentro de outras. Para
i nseri r este objeto, si ga este procedi mento:
1. Cl i que com o boto di rei to do mouse no objeto Confi gurao de Al armes ou no
objeto rea do projeto no Expl orer, e escol ha a opo Inserir - rea. No modo
Domnio, cl i que com o boto di rei to do mouse no objeto Confi gurao de
Al armes e sel eci one o i tem Inserir - rea.
Alarmes 309
Inserindo uma rea de Alarme
os devi dos ajustes. Demai s i nformaes sobre as funci onal i dades das
13.1.1.1 Objetos de Servidor como reas de Alarme
Objetos de Servi dor tm a possi bi l i dade de se comportarem como reas de Al arme.
Estes objetos agora possuem uma aba adi ci onal , rea de Alarmes, onde este
comportamento pode ser habi l i tado e confi gurado. A fi gura a segui r mostra esta
310 Alarmes
aba em um Dri ver de Comuni cao:
Aba rea de Alarmes
Opes disponveis na aba rea de Alarmes
OPO DESCRIO
Funcionar como rea de alarmes
Habi l i ta ou desabi l i ta o comportamento
de rea de Al arme para o objeto de
Servi dor. Esta opo corresponde
propri edade IsAlarmArea.
Verificar alarmes
Habi l i ta ou desabi l i ta a veri fi cao de
al armes no objeto. Esta opo
corresponde propri edade AlarmVerify.
Campos do usurio
Veja o tpi co Configuraes dos Campos do
Usurio para mai ores i nformaes.
As segui ntes propri edades fi cam di sponvei s no objeto de Servi dor:
ActiveAlarms
ActiveHighAlarms
ActiveHighNACKAlarms
ActiveLowAlarms
Alarmes 311
ActiveLowNACKAlarms
ActiveMedAlarms
ActiveMedNACKAlarms
ActiveNACKAlarms
Alarm
AlarmVerify
UserFields
13.2 Servidor de Alarmes
O objeto Servidor de Alarmes central i za todos os al armes do projeto. Nel e podem
ser encontrados todos os al armes ati vos da apl i cao (reconheci dos ou no). El e
tambm o responsvel por reportar os eventos de al arme para todos os Vi ewers
conectados, bem como envi ar esses eventos para um Banco de Dados, se
necessri o.
Uma apl i cao s pode ter um objeto desse ti po, e a sua presena obri gatri a
para que a veri fi cao de al armes ocorra. Para i nseri r um Servi dor de Al armes,
si ga este procedi mento:
sel eci one a opo Inserir - Servidor de Alarmes. No modo Domnio, cl i que com
o boto di rei to do mouse no i tem Objetos de Servidor - Alarmes, sel eci one a
opo Inserir Servidor de Alarmes em e l ogo aps o nome do projeto desejado.
312 Alarmes
Inserindo um Servidor de Alarmes no modo Domnio
13.2.1 Configuraes para Gerao da Tabela de
Alarmes
Para especi fi car as confi guraes do Servi dor de Al armes, necessri o acessar
suas propri edades. Para tanto, basta cl i car com o boto di rei to do mouse sobre o
Servi dor de Al armes e sel eci onar a opo Propriedades.
Na aba Configurao, possvel especi fi car as confi guraes de Banco de Dados e
determi nar campos para a gerao da tabel a de al armes.
Alarmes 313
Configuraes do Servidor de Alarmes
Cada campo da aba Configurao possui uma propri edade correspondente. As
OPO DESCRIO
Guarde alarmes no Banco de Dados
Habi l i ta ou desabi l i ta o armazenamento
dos dados dos al armes no Banco de
Dados. Este campo equi val e
propri edade Logging.
Utilize o servidor de banco de dados
Defi ne o servi dor de Banco de Dados que
armazenar os dados do al arme. Este
DataSource.
Nome da Tabela
Defi ne o nome da tabel a de al armes.
TableName.
314 Alarmes
OPO DESCRIO
Descarta dados da tabela principal
Habi l i ta ou desabi l i ta o descarte de
dados da tabel a pri nci pal . O dado ser
consi derado anti go de acordo com o que
for defi ni do na opo Mantenha os dados
do(s) ltimo(s). Este campo equi val ente
propri edade EnableDiscard.
Mantenha os dados do(s) ltimo(s) ... <
Tabela Principal >
Determi na o i nterval o de tempo
(mi nutos, horas, di as ou meses) durante
o qual os dados sero manti dos na
tabel a pri nci pal . Se um dado da tabel a
for mai s anti go que o i nterval o de tempo
desta opo, el e ser descartado. Este
DiscardInterval, e o campo de sel eo da
uni dade de tempo do i nterval o equi val e
propri edade DiscardTimeUnit.
A verificao deve ocorrer a cada
Faz a veri fi cao dos al armes, conforme
o perodo especi fi cado no campo (em
mi nutos, horas, di as ou meses). Este
VerificationInterval, e o campo de sel eo
da uni dade de tempo do i nterval o
equi val e propri edade VerificationUnit.
Dados descartados devem ser armazenados
dos dados descartados na tabel a
secundri a (tabel a de backup). Este
EnableBackupTable.
Mantenha os dados do(s) ltimo(s) ... <
Tabela de Backup >
tabel a de backup. Este i nterval o deve ser
sempre mai or que o confi gurado no i tem
Mantenha os dados do(s) ltimo(s) da
Tabel a Pri nci pal . Este campo equi val e
propri edade BackupDiscardInterval, e o
campo de sel eo da uni dade de tempo
do i nterval o equi val e propri edade
BackupDiscardTimeUnit.
Campos
Determi na quai s campos dos eventos de
al arme sero adi ci onados tabel a de
al armes, e qual a ordem em que estas
col unas aparecero.
Gerar Tabela
Gera a tabel a dos al armes no Banco de
Dados especi fi cado.
Os campos di sponvei s no Servi dor de Al armes para gerao da tabel a de al armes
so os segui ntes:
Alarmes 315
Opes disponveis para tabelas dos Campos dos alarmes
OPO DESCRIO
Acked
I nforma se o al arme foi reconheci do ou
no. Este campo pode assumi r os
segui ntes val ores: 0 - no reconhecido; 1 -
reconhecido.
AckRequired
Determi na o reconheci mento automti co
do al arme. Este campo apresenta os
segui ntes val ores: 0 - reconhecimento
automtico; 1 - reconhecimento manual.
AckTime
Regi stra a data e hora do E3 no momento
em que o al arme reconheci do, ou zero
(30/12/1899), enquanto o al arme no tenha
si do reconheci do. No caso de al armes que
no pedem reconheci mento, o campo
assume a data e hora do E3 no momento
em que o al arme torna-se ati vo.
AckTimeDbl
Semel hante ao campo anteri or. usado
para faci l i tar a gravao de dados do ti po
Double no caso de bancos de dados Oracl e
ou SQL Server.
ActorID
Nome do operador que reconheceu o
al arme. Pode ser:
O usuri o l ogado no Vi ewer, quando o
reconheci mento fei to no E3Al arm (ou
"Sem usuri o", se no h usuri o
l ogado)
"System", quando o reconheci mento
automti co (ou seja, para al armes que
no pedem reconheci mento)
Um nome passado por scri pt (por
exempl o, usando AckArea, AckAllAlarms
ou LogTrackingEvent do Servi dor de
Al armes, ou Ack da Fonte de Al armes)
O l i mi te deste campo, quando armazenado
no Banco de Dados, de 50 caracteres.
AlarmSourceName
Regi stra o nome da Fonte de Al arme. O
l i mi te deste campo, quando armazenado
no Banco de Dados, de 100 caracteres. Por
exempl o, FonteAlarme1.
Area
Para eventos de al arme, o nome da rea
a qual a Fonte de Al armes pertence. Para
outros eventos (por exempl o, usando o
mtodo LogTrackingEvent do Servi dor de
Al armes), pode ser um texto defi ni do pel o
usuri o. O l i mi te deste campo, quando
armazenado no Banco de Dados, de 100
caracteres.
ChangeMask
No usado (o val or sempre zero).
316 Alarmes
OPO DESCRIO
ConditionActive
I ndi ca se a Fonte de Al arme est em
al arme. Este campo apresenta os segui ntes
estados: 0 - condio no ativa; 1 - condio
ativa.
ConditionName
Nome da condi o, se for um evento de
al arme. Este campo pode apresentar os
segui ntes val ores:
Banda Morta: Fonte de Al arme do ti po
Banda Morta
Digital: Fonte de Al arme do ti po Di gi tal
Nvel: Fonte de Al arme do ti po Anal gi co
TaxaDeVariao: Fonte de Al arme do ti po
Taxa de Vari ao
Se o evento no for um al arme (por
exempl o, usando o mtodo LogTrackingEvent
do Servi dor de Al armes), este val or ser
sempre uma String vazi a.O l i mi te deste
campo, quando armazenado no Banco de
Dados, de 100 caracteres.
Cookie
Val or associ ado Fonte de Al arme, usado
i nternamente pel o Servi dor de Al armes.
CurrentValue
Determi na o val or da Fonte de Al arme
(converti do para Double) no momento do
evento. Para outros eventos (por exempl o,
usando o mtodo LogTrackingEvent), o val or
ser sempre zero (0). O l i mi te deste campo,
quando armazenado no Banco de Dados,
de 100 caracteres.
Enabled
Determi na se a veri fi cao do al arme est
habi l i tada. Este campo apresenta os
segui ntes estados: 0 - verificao da fonte de
alarmes desabilitada; 1 - verificao da fonte de
alarme habilitada.
EventCategory
Categori a do evento. Para al armes, este
campo pode assumi r os segui ntes val ores:
Banda Morta: Fonte de Al arme do ti po
Banda Morta
Digital: Fonte de Al arme do ti po Di gi tal
Nvel: Fonte de Al arme do ti po Anal gi co
TaxaDeVariao: Fonte de Al arme do ti po
Taxa de Vari ao
Para outros eventos (por exempl o, usando
o mtodo LogTrackingEvent do Servi dor de
Al armes), o campo pode assumi r val ores
defi ni dos pel o usuri o. O l i mi te deste
Alarmes 317
OPO DESCRIO
EventCLSID
I denti fi cador ni co para toda a vi da de um
al arme. Quando um al arme novo ocorre em
uma Fonte, gerado um novo nmero de
EventCLSI D; assi m, el e i r manter esse
mesmo CLSI D no banco de dados enquanto
no sai r da l i sta de al armes ati vos e no
reconheci dos.
EventTime
Data e hora do val or da Fonte de Al arme no
momento do evento.
EventTimeDbl
ou SQL Server.
EventTimeUTC
Data e hora do val or da Fonte de Al arme no
momento do evento, com rel ao ao
horri o de Greenwi ch. O val or o mesmo
do campo EventTime, sendo manti do no E3
por questes de compati bi l i dade.
EventType
Ti po do evento. Para eventos de al arme,
sempre Condition. Para outros eventos, pode
ser um texto defi ni do pel o usuri o, como
por exempl o, usando o mtodo
LogTrackingEvent do Servi dor de Al armes
("Tracki ng", "Si mpl e", etc.). O l i mi te deste
FormattedValue
Mostra o val or formatado da Fonte de
Al arme que vai para o seu evento. O l i mi te
deste campo, quando armazenado no
Banco de Dados, de 100 caracteres. NOTA:
Este campo somente de l ei tura.
FullAlarmSourceName
Regi stra o cami nho compl eto da Fonte de
Al arme, i ncl ui ndo reas, nome da
Confi gurao de Al armes e de possvei s
Pastas onde esta possa estar i nseri da. Por
exempl o,
Pasta1.ConfigAlarmes1.Area1.FonteA
larme1.
InTime
Regi stra a data e hora do val or, no
momento em que el e entra na condi o de
al arme.
InTimeDbl
ou SQL Server.
318 Alarmes
OPO DESCRIO
Message
o texto confi gurado na Fonte de Al arme,
ou especi fi cado por um outro evento (por
exempl o, usando o mtodo LogTrackingEvent
do Servi dor de Al armes). O l i mi te deste
OutTime
Regi stra a data e hora do val or no
momento em que el e sai da condi o de
al arme; ou zero (30/12/1899), enquanto o
al arme ai nda no tenha sado da condi o
ati va.
OutTimeDbl
ou SQL Server.
Quality
Qual i dade do val or de Fonte de al arme no
momento do evento. Este campo assume os
segui ntes val ores numri cos:
0 - 63: qual i dade rui m
64 - 127: qual i dade i ncerta
128 - 191: val or no defi ni do
192 - 255: qual i dade boa
exempl o, se el e esti ver usando o mtodo
LogTrackingEvent do Servi dor de Al armes),
este campo ser i gual a uma String vazi a.
Exempl o: Rui m (0); I ncerta (64); ?? (128); Boa
(192).
Severity
o val or de severi dade confi gurado na
Fonte de Al arme. Este campo pode assumi r
os segui ntes val ores: 0 - alta; 1 - mdia; 2 -
baixa. El e pode tambm assumi r outro val or
defi ni do pel o usuri o se for um evento,
como por exempl o quando esti ver usando o
mtodo LogTrackingEvent.
Source
Para eventos de al arme, i nforma a
expresso uti l i zada para aval i ar as
condi es de al arme. O l i mi te deste
Dados, de 100 caracteres. Por exempl o,
Dados.TagDemo1.Value.
Alarmes 319
OPO DESCRIO
SubConditionName
Nome da subcondi o, se for um evento de
al arme. Este campo pode assumi r os
segui ntes val ores:
BM: Al arme de Banda Morta
DIG: Al arme Di gi tal
TV: Al arme Taxa de Vari ao
LOLO: Al arme Anal gi co na fai xa Mui to
Bai xo
LO: Al arme Anal gi co na fai xa Bai xo
HI: Al arme Anal gi co na fai xa Al to
HIHI: Al arme Anal gi co na fai xa Mui to
Al to
exempl o, se el e esti ver usando o mtodo
LogTrackingEvent do Servi dor de Al armes),
este campo ser i gual a uma String vazi a. O
l i mi te deste campo, quando armazenado
no Banco de Dados, de 100 caracteres.
Campos do Usurio
So os campos defi ni dos pel o usuri o.
Estes campos so confi gurados na aba
Campos do usurio, no Servi dor de Al armes.
NOTAS:
necessri o que haja um Servi dor de Al armes no Domni o, para que seja
possvel o moni toramento de al armes
Os campos EventTimeMS, InTimeMS, OutTimeMS e AckTimeMS contm os val ores
em mi l i ssegundos dos campos EventTime, InTime, OutTime e AckTime,
respecti vamente. Estes campos sero usados quando for necessri o regi strar o
tempo (em ms) dos eventos em um servi dor de bancos de dados Oracl e. Observe
que estes campos no esto di sponvei s no E3Al arm, poi s neste objeto
possvel vi sual i zar os mi l i ssegundos atravs da formatao das col unas de Data
e Hora
Depoi s de defi ni das todas as confi guraes, o si stema i ni ci al i za a i nsero e
gravao das i nformaes na tabel a dos al armes, conforme as especi fi caes dos
campos. Ao cl i car em Gerar tabela, o si stema gera a tabel a de dados dos al armes
conforme as especi fi caes, e i nforma se a tabel a foi gerada com sucesso.
320 Alarmes
Mensagem do Servidor de Alarmes
A estrutura da tabel a dos al armes semel hante do Hi stri co: composta por
uma tabel a de defi ni es, uma tabel a pri nci pal de dados e uma tabel a de backup
(opci onal ).
Tabela Fields
Os campos gerados na tabel a so expl i cados no tpi co Configuraes da Tabela do
captul o Histrico.
Atravs da janel a de confi gurao do Servi dor de Al armes, pode-se especi fi car o
Servi dor de Banco de Dados uti l i zado para a gravao dos al armes. O Servi dor de
Banco de Dados (objeto DBServer) um mdul o do E3 que deve ser i nseri do na
apl i cao.
Alarmes 321
13.2.2 Configuraes dos Campos do Usurio
Na aba Campos do usurio pode-se adi ci onar val ores arbi trri os aos eventos de
al armes.
Aba Campos do usurio
Opes disponveis na aba Campos do usurio
OPO DESCRIO
Nome
Determi na o nome do Campo.
Tipo
Determi na o ti po do Campo (0: String, 1:
Integer, 2: Double ou 3: DateTime).
Tamanho
Determi na o tamanho do Campo.
Fonte
Determi na a fonte de dados do Al arme.
Propagar?
Fora a atual i zao i medi ata de todos
os al armes que herdam o val or deste
Campo do Usuri o, sempre que este
receber um val or forado ou se a
Associ ao for al terada.
Adi ci ona um Campo do Usuri o ao fi nal
da l i stagem.
Remove o l ti mo Campo do Usuri o da
l i stagem.
322 Alarmes
Campos do Usuri o s podem ser i ncl udos ou excl udos ao fi nal da l i stagem. A
excl uso de Campos de Usuri o nesta l i stagem i r se refl eti r em todas as reas e
Fontes de Al armes rel aci onadas a este Servi dor de Al armes, mas apenas se os
Campos removi dos no tenham si do confi gurados com um val or forado ou uma
Associ ao. Do contrri o, estes Campos conti nuaro aparecendo nas reas e
Fontes de Al arme. A fi gura a segui r mostra um Al arme Anal gi co com os Campos do
Usuri o herdados do Servi dor de Al armes.
Campos do Usurio herdados
NOTA: Para mai ores i nformaes sobre o comportamento de um Campo do Usuri o
de reas e Fontes de Al arme, tanto em Studi o quanto em tempo de execuo,
veri fi que as propri edades Link, Value e ValueSource no Manual de Scripts.
13.3 Fontes de Alarme
Todas as i nformaes rel ati vas s condi es de al arme so defi ni das nas Fontes
de Alarmes, bem como os ti pos de eventos que devem ser gerados em cada
condi o. As Fontes de Al arme sempre contm uma expresso de al arme (fonte de
dados), cujo val or poder ser veri fi cado de acordo com as di versas condi es
di sponvei s. Estas fontes so Alarme Analgico, Banda Morta, Digital, Taxa de
Variao e Discreto.
NOTA: O objeto Fonte de Al arme pode ser cri ado dentro de qual quer objeto do
Servi dor.
Alarmes 323
Para i nseri r este objeto, si ga este procedi mento:
1. Cl i que com o boto di rei to do mouse no objeto de Servi dor no Expl orer, e
escol ha a opo Inserir - Alarme (Analgico, Banda Morta, Taxa de Variao,
Digital ou Discreto). No modo Domnio, sel eci one o objeto desejado no i tem
Objetos de Servidor e sel eci one a opo Inserir - Alarme (Analgico, Banda
Morta, Taxa de Variao, Digital ou Discreto).
Inserindo uma Fonte de Alarme
324 Alarmes
os devi dos ajustes. Demai s i nformaes sobre as funci onal i dades das
Em cada subcondi o de al arme so confi gurados seus l i mi tes, a mensagem
rel ati va ao evento, sua severi dade e a necessi dade ou no de reconheci mento deste
evento.
Fontes de Alarmes
Ao abri r a janel a de Propri edades de qual quer Fonte de Al arme e escol her a aba
Fonte, a segui nte janel a aberta:
Aba Fonte
Para tratar o al arme como evento, ou para que o al arme possa ser reconheci do
Alarmes 325
dupl amente (tanto quando esti ver ati vo como quando passar para i nati vo), basta
cl i car na cai xa de sel eo correspondente aci ma. Todas as Fontes de Al arme
possuem as segui ntes propri edades gerai s:
Texto da Mensagem: Esta mensagem ser armazenada no campo Mensagem do
evento de al arme enquanto el e esti ver ati vo. Ou seja, poder ser vi sual i zada no
E3Al arm (sumri o de al armes), armazenada no Banco de dados, etc. O l i mi te do
texto da mensagem de 200 caracteres
Severidade: Indi ca a gravi dade do al arme ocorri do (Baixa, Mdia ou Alta). O
campo Severidade uti l i zado para real i zao de fi l tros e ordenao nas
mensagens
Pede Ack: Indi ca se o al arme deve ser reconheci do pel o operador para ser
reti rado da l i sta de al armes no E3Al arm, ou se ser reconheci do
automati camente quando a vari vel dei xa uma condi o de al arme
Volta ao normal: Essa mensagem ser armazenada no campo Mensagem do
evento de al arme enquanto este esti ver i nati vo. Ou seja, poder ser vi sual i zada
no E3Al arm (sumri o de al armes), armazenada em um Banco de Dados, etc.
H vri os ti pos de Fontes de Al arme que podem ser i nseri das em objetos do
Servi dor. As opes di sponvei s so descri tas nas prxi mas sees.
13.3.1 Analgico
Permi te moni torar uma vari vel anal gi ca, pel a especi fi cao de at quatro nvei s
de al arme, que so o LoLo (Mui to Bai xo), Lo (Bai xo), Hi (Al to) e HiHi (Mui to Al to).
326 Alarmes
Aba Analgico
Opes disponveis na aba Analgico
OPO DESCRIO
Habilitao (LoLo, Lo, Hi, HiHi)
Habi l i ta a veri fi cao do ti po de al arme
escol hi do.
Limite
I ndi ca o nvel em que o al arme ser
di sparado.
Texto da mensagem
Permi te especi fi car o texto que ser
mostrado para o usuri o, quando o
al arme esti ver em condi o ati va.
Severidade
Determi na a severi dade do nvel de
al arme (pode ser Alta, Mdia ou Baixa).
Pede Ack
Habi l i ta ou desabi l i ta o reconheci mento
do al arme.
Evento
Habi l i ta ou desabi l i ta o tratamento de
cada subcondi o do al arme como um
evento.
Espera
Especi fi ca o tempo de espera, em ms.
Quando o val or for 0 (zero, padro), no
apl i cada nenhuma espera.
Alarmes 327
OPO DESCRIO
Banda morta
Habi l i ta a banda morta, que um
recurso uti l i zado para evi tar que uma
vari vel , ao manter uma pequena
osci l ao em torno de um l i mi te de
al arme, gere uma quanti dade
desnecessri a de mensagens.
Volta ao normal
Permi te especi fi car o texto a ser
al arme no esti ver em condi o ati va.
13.3.2 Digital
Permi te moni torar uma vari vel di gi tal , pel a especi fi cao de al arme na borda de
subi da (em -1 ou Verdadei ro) ou na borda de desci da (em 0 ou Fal so).
Aba Digital
Opes disponveis na aba Digital
OPO DESCRIO
Alarme Digital
Habi l i ta o al arme di gi tal .
Valor
Determi na o val or Bool eano do al arme
(Verdadei ro ou Fal so).
Texto da mensagem
328 Alarmes
OPO DESCRIO
Severidade
Pede Ack
do al arme.
Espera (ms)
Volta ao normal
13.3.3 Banda Morta
Permi te moni torar uma vari vel anal gi ca pel a especi fi cao de um l i mi te mxi mo
de di ferena (val or de banda morta), em rel ao a um val or de refernci a
(SetPoi nt).
Banda morta
Este ti po de al arme i nteressante quando a refernci a (SetPoi nt) vari vel , e
tambm quando se deseja evi tar uma quanti dade desnecessri a de al armes para
pequenas osci l aes da vari vel moni torada.
Alarmes 329
Aba Banda Morta
Opes disponveis na aba Banda Morta
OPO DESCRIO
SetPoint
Associ ao para a vari vel de refernci a,
para que seja moni torada uma di ferena
em rel ao vari vel de moni toramento.
BM
Habi l i ta a banda morta, que um
recurso uti l i zado para evi tar que uma
vari vel , ao manter uma pequena
osci l ao em torno de um l i mi te de
al arme, gere uma quanti dade
desnecessri a de mensagens.
Valor
I ndi ca a di ferena entre a vari vel
moni torada e o SetPoi nt, a parti r do qual
deve ser i ndi cado o al arme. Deve ser
i nformado em uni dades de engenhari a
da vari vel moni torada.
Texto da mensagem
mostrado para o usuri o quando o
Severidade
Pede Ack
do al arme.
330 Alarmes
OPO DESCRIO
Espera (ms)
Volta ao normal
13.3.4 Taxa de Variao
Usado para moni torar vari aes mui to rpi das em uma vari vel do processo. A
Fonte de Al arme Taxa de Variao usa seus val ores especi fi cados em uni dades da
vari vel por segundo.
Aba Taxa de Variao
Opes disponveis na aba Taxa de Variao
OPO DESCRIO
TDV
Habi l i ta a veri fi cao do al arme Taxa de
Vari ao.
Alarmes 331
OPO DESCRIO
Variao p/seg
I ndi ca a porcentagem da vari vel
moni torada que pode vari ar por
segundo. Este val or cal cul ado tomando
como base cada i nterval o de l ei tura da
vari vel , pel a frmul a: TDV = (Valor
Atual - Valor Anterior) /
(Instante Atual - Instante
Anterior). Se a taxa de vari ao for
mai or que a taxa especi fi cada, ser
consi derado em estado de al arme.
Texto da mensagem
Severidade
Pede Ack
do al arme.
Espera (ms)
Volta ao normal
Determi na a mensagem de texto que
ser mostrada ao usuri o quando o
al arme vol tar ao estado normal .
332 Alarmes
13.3.5 Discreto
Permi te moni torar uma vari vel pel a especi fi cao de ml ti pl as subcondi es.
Aba Discreto
Opes disponveis na aba Discreto
OPO DESCRIO
Adi ci ona uma nova Subcondi o no
al arme.
Remove a Subcondi o sel eci onada.
Mapear todas as subcondies
Permi te mapear e si ncroni zar as
Subcondi es do Al arme a parti r de
semnti cas presentes no objeto fonte.
Este recurso atual mente s suportado
pel os objetos de servi dor do Elipse
Power, portanto este boto permanece
desabi l i tado por padro no El i pse E3.
Nome
Nome da Subcondi o.
Habilitado
Habi l i ta ou desabi l i ta a Subcondi o.
Descrio
Descri o da Subcondi o.
Valor
Val or aval i ado para determi nar se o
al arme ocorre ou no.
Alarmes 333
OPO DESCRIO
Texto da mensagem
Mensagem mostrada quando a
Subcondi o est ati va.
Tipo
Comportamento da Subcondi o. Pode
assumi r os segui ntes val ores: 0 - Alarme;
1 - Evento; 2 - Retorno.
Severidade
O ti po de severi dade da Subcondi o.
Pode assumi r os segui ntes val ores: 0 -
Alta; 1 - Mdia; 2 - Baixa.
Pede Ack?
I ndi ca se esta Subcondi o exi ge
reconheci mento.
Espera (ms)
Volta ao normal
334 E3Alarm
14
E3Alarm
CAPTULO
O E3Alarm serve para moni toramento dos al armes ati vos ou no reconheci dos no
si stema. Atravs deste objeto, possvel veri fi car o estado dos al armes no si stema,
bem como reconhec-l os manual mente.
E3Alarm
Para uti l i zar este objeto, si ga estes procedi mentos:
1. Insi ra este objeto no projeto atravs do cl i que com o boto di rei to do mouse
em uma Tel a ou na rea de trabal ho e sel eci one a opo Inserir - E3Alarm, ou
ento atravs da barra de ferramentas Objeto, cl i cando em E3Alarm.
Inserindo um E3Alarm na Tela
E3Alarm 335
14.1 Configuraes
Para confi gurar o E3Al arm, cl i que com o boto di rei to do mouse no objeto e
sel eci one a opo Propriedades.
14.1.1 Aba Geral
Na aba Geral so especi fi cadas as i nformaes referentes ao Servi dor de Al armes e
ao fi l tro.
Aba Geral
Cada campo da aba Geral possui uma propri edade correspondente. As opes
di sponvei s so as segui ntes:
336 E3Alarm
OPO DESCRIO
Nome do Servidor de Alarmes
Determi na o nome do Servi dor de
Al armes. i mportante i nformar este
campo, caso contrri o o E3Al arm no
mostrar os al armes e i nformar uma
mensagem de erro. Este campo equi val e
propri edade AlarmServer.
Filtrar por rea de Alarme
Determi na o fi l tro por rea de Al arme.
Caso deseje uti l i zar al gum fi l tro,
especi fi que no campo, seno basta
dei x-l o em branco. Pode-se fi l trar reas
com ou sem caracteres cori nga (como *
ou ?), dependendo da confi gurao na
propri edade SimpleAreaFilter. Se a
propri edade SimpleAreaFilter esti ver em
Fal so, ml ti pl os fi l tros de rea podem
ser usados, separados por doi s pontos.
AreaFilter.
Filtrar por tipo
Habi l i ta o ti po de fi l tro que ser
apl i cado no Al arme (Apenas alarmes,
Apenas eventos, e Alarmes e Eventos). Este
campo equi val e propri edade FilterType.
Filtrar por severidade
Habi l i ta ou desabi l i ta a vi sual i zao do
grau da severi dade (Alta, Mdia ou Baixa).
Este campo equi val e s propri edades
ShowHightPriority (Al ta),
ShowMediumPriority (Mdi a) e
ShowLowPriority (Bai xa).
possvel acessar um Servi dor de Al armes remoto, si mpl esmente preenchendo a
propri edade AlarmServer do E3Al arm com os dados do Domni o e do Servi dor de
Al armes remotos, no formato DOMINIO:SERVIDOR, onde SERVIDOR o nome do
Servi dor de Al armes remoto, e DOMINIO o nome do Domni o Remoto que o contm.
Para confi gurar o Domni o Remoto, veja a seo Domnios Remotos, no captul o
sobre Domnios.
14.1.2 Aba Colunas
Atravs da aba Colunas possvel sel eci onar os campos que sero vi sual i zados no
E3Al arm. Os campos mostrados nos i tens Campos disponveis e Campos
selecionados so gerados pel o Servi dor de Al armes. Para mai ores i nformaes,
consul te a Tabel a dos Campos dos Al armes na seo Configuraes para Gerao da
Tabela de Alarmes do captul o Alarmes.
E3Alarm 337
Aba Colunas
A l i sta Campos disponveis mostra todos os campos da Fonte de Al arme. Cl i cando
em Adicionar, pode-se acrescentar campos i ndi vi dual mente no E3Al arm. Cl i cando
em Propriedades, possvel confi gurar as propri edades do campo do al arme.
Propriedades da coluna
338 E3Alarm
Opes disponveis na janela Propriedades da coluna
OPO DESCRIO
Largura (pixels)
Determi na a l argura da col una, em pi xel s. A
l argura padro das col unas do E3Al arm
de 80 pi xel s.
Formatador
Determi na o formatador uti l i zado na
col una do E3Al arm. O formatador uti l i zado
o padro do E3 (ver seo Formatao de
Valores), com exceo do campo Severidade e
dos campos Condio Ativa, Pede Ack,
Reconhecido e Habilitado, cujos exempl os de
formatao podem ser vi stos nas tabel as a
segui r.
Renomear para
Renomei a o ttul o da col una.
Permite reconhecer
Permi te confi gurar o reconheci mento do
al arme quando o usuri o cl i car sobre a
l i nha da col una confi gurada. As opes
di sponvei s so:
Nunca: O al arme no reconheci do
(padro)
Com clique: O al arme reconheci do
quando o usuri o cl i ca sobre a l i nha da
col una
Com clique-duplo: O al arme reconheci do
quando o usuri o d um dupl o-cl i que
sobre a l i nha da col una
(NOTA: Se o al arme puder ser reconheci do,
o formato do cursor do mouse muda para
, em tempo de execuo, quando el e
esti ver sobre uma l i nha de al arme no
reconheci do).
Esta coluna nunca pisca
Habi l i ta ou desabi l i ta o pi scar da col una.
Formatador para o campo Severidade
Severidade Alta
;;; Al ta
Severidade Mdia
"A";"M";"B" M
Severidade Baixa
;;; Bai xa
Formatador para os campos Condio Ativa, Pede Ack, Reconhecido e Habilitado
Verdadeiro
"OK";"No OK" OK
Falso
"OK";"No OK" No OK
Verdadeiro
"AAA" AAA
Falso
"AAA" No
E3Alarm 339
Verdadeiro
; Si m
Falso
; No
Para remover al gum campo i ndesejado, basta sel eci on-l o e cl i car em Remover.
14.1.3 Aba Ordenao
A aba Ordenao permi te confi gurar a ordenao padro dos al armes. Quando
mai s de um campo de ordenao for usado, os campos subsequentes permi tem a
ordenao entre al armes que tenham o mesmo val or para o pri mei ro campo.
Aba Ordenao
Cada campo da aba Ordenao possui uma propri edade correspondente. As
propri edades di sponvei s so as segui ntes:
Opes disponveis na aba Ordenao
OPO DESCRIO
Pelo campo
Ordena os al armes conforme o campo
especi fi cado. Este campo equi val e
propri edade PrimarySortField.
340 E3Alarm
OPO DESCRIO
Depois por
Ordena os al armes a parti r do i tem
especi fi cado na opo Pelo campo. O
prxi mo i tem ser ordenado a parti r da
especi fi cao i ndi cada nos campos
Depois por. Estes campos equi val em s
propri edades SecondarySortField,
ThirdSortField e FourthSortField,
respecti vamente.
Ascendente
Ordena os campos do al arme de forma
ascendente. Estes campos equi val em s
propri edades PrimarySortAscending,
SecondarySortAscending, ThirdSortAscending
e FourthSortAscending em Verdadei ro,
respecti vamente.
Descendente
Ordena os campos do al arme de forma
descendente. Estes campos equi val em
s propri edades PrimarySortAscending,
SecondarySortAscending, ThirdSortAscending
e FourthSortAscending em Fal so,
respecti vamente.
NOTAS:
A ordenao padro fei ta atravs do campo InTime, de manei ra descendente.
Caso a propri edade BannerMode esteja confi gurada para Verdadei ro, o al arme
mostrado depender da confi gurao fei ta nesta aba.
14.1.4 Aba Cores
Na aba Cores so defi ni das as cores de reconheci mento dos al armes no objeto.
possvel confi gurar as cores para cada ti po de al arme ou por severi dade.
E3Alarm 341
Aba Cores
Cl i cando em possvel sel eci onar a cor para o ti po de al arme sel eci onado. A
segui nte janel a mostrada:
Cores do alarme selecionado
Opes disponveis na janela Cores
OPO DESCRIO
Cor de fundo
Determi na a cor de fundo do al arme.
Cor do texto
Determi na a cor do texto do al arme.
342 E3Alarm
OPO DESCRIO
No pisca
Quando sel eci onada, o texto do al arme
no i r pi scar.
Pisca fundo e texto
Quando sel eci onada, as cores de texto e
fundo al ternam entre si .
Pisca apenas texto
Quando sel eci onada, a cor do texto vari a
entre as cores escol hi das para o texto e
para o fundo.
possvel tambm escol her as cores por severi dade, para cada ti po de al arme.
Cores do alarme por severidade
Cl i cando em possvel redefi ni r as cores apenas para um ti po de severi dade, no
ti po de al arme sel eci onado. A segui nte janel a mostrada:
E3Alarm 343
Cores por severidade
Opes disponveis na janela Cores por severidade
OPO DESCRIO
Redefinir cor de fundo
Determi na a cor de fundo do al arme
apenas para a severi dade escol hi da. Se
esta opo no for marcada, permanece
a cor escol hi da na opo Cor de fundo do
ti po de al arme sel eci onado.
Redefinir cor do texto
Determi na a cor do texto do al arme
apenas para a severi dade escol hi da. Se
esta opo no for marcada, permanece
a cor escol hi da na opo Cor do texto do
ti po de al arme sel eci onado.
Redefinir pisca
Redefi ne a opo de pi sca para o texto e
para o fundo do al arme na severi dade
escol hi da. Se esta opo no for
marcada, permanece a opo escol hi da
no ti po de al arme sel eci onado.
14.1.5 Aba Fontes
Atravs da aba Fonte possvel confi gurar a fonte do cabeal ho e das l i nhas do
E3Al arm.
344 E3Alarm
Aba Fonte
As opes di sponvei s so referentes a ti po, tamanho e efei tos da fonte.
NOTA: o nome da aba aparece no i di oma do Wi ndows, e no necessari amente no
i di oma do E3.
14.2 Caractersticas Especficas de Tempo de
Execuo
O E3Al arm possui uma sri e de caractersti cas que se apl i cam apenas em tempo de
execuo (runtime). Estas caractersti cas sero expl i cadas a segui r.
E3Alarm 345
14.2.1 Visualizando os Alarmes
Em tempo de execuo, os al armes do si stema podem ser vi sual i zados no E3Al arm.
E3Alarm em execuo
Dentre os al armes que sati sfazem os fi l tros confi gurados, so mostrados no
E3Al arm aquel es que esti verem em condi o ati va ou no esti verem reconheci dos.
De manei ra geral , i sso pode ser di vi di do em doi s casos:
Se a opo Pede Ack da Fonte de Al arme esti ver em Fal so, o al arme ser
consi derado reconheci do desde a sua ati vao, sem a necessi dade de
reconheci mento. Neste caso, o al arme fi car vi svel at que sai a da condi o
ati va
Se a opo Pede Ack da Fonte de Al arme esti ver em Verdadei ro, o usuri o pode
reconhecer o al arme antes ou depoi s da vari vel sai r da condi o de al arme. Em
ambos os casos, o al arme s sai r da l i sta do E3Al arm quando as duas
condi es forem sati sfei tas
A propri edade BannerMode, quando confi gurada para Verdadei ro, permi te
vi sual i zar apenas uma mensagem de al arme no objeto E3Al arm. A mensagem que
ser mostrada depender da confi gurao fei ta na aba Ordenao.
14.2.2 Reconhecimento de Alarmes
Na confi gurao padro, ao cl i car com o boto di rei to do mouse sobre o E3Al arm,
mostrado um menu contextual com a opo Reconhecimento. Ao sel eci onar esta
opo, mostrada a segui nte cai xa de di l ogo:
346 E3Alarm
Opes de reconhecimento de alarmes
Opes disponveis na janela Reconhecimento de Alarmes
OPO DESCRIO
Reconhece apenas os alarmes selecionados
Somente os al armes sel eci onados sero
reconheci dos.
Reconhece todos os alarmes do filtro
corrente
Todos os al armes vi svei s neste E3Al arm
sero reconheci dos.
Reconhece globalmente todos os alarmes
Todos os al armes do Domni o sero
reconheci dos.
A opo Reconhecer apenas os alarmes selecionados s fi ca di sponvel se
real mente houver al armes sel eci onados no E3Al arm em questo. O usuri o
poder reconhecer o al arme (neste caso, ser i nseri do um novo regi stro no
Banco de Dados i ndi cando o reconheci mento), e no E3Al arm a l i nha
correspondente i ndi car que el e foi reconheci do. Esta opo estar desabi l i tada
caso a propri edade AllowAckSelected esteja confi gurada para Fal so
A opo Reconhecer todos os alarmes do filtro corrente s fi ca di sponvel se
real mente houver al armes vi svei s no E3Al arm. possvel chamar esta opo sem
cl i car em nenhum al arme. Para tanto, basta cl i car em qual quer rea do E3Al arm,
que a janel a de Reconheci mento aparecer. Cl i cando sobre esta janel a, a cai xa
de di l ogo de reconheci mento aparecer. Esta opo estar desabi l i tada caso a
propri edade AllowAckCurrentFilter esteja confi gurada para Fal so
A opo Reconhecer globalmente todos os alarmes fi ca sempre di sponvel ,
mesmo que no haja al armes vi svei s no E3Al arm em questo. Esta opo estar
desabi l i tada caso a propri edade AllowAckAll esteja confi gurada para Fal so
O reconheci mento de al armes tambm pode ser fei to atravs de um cl i que ou
dupl o-cl i que sobre a l i nha do al arme. Para tanto, basta especi fi car nas
propri edades da col una desejada (propri edades do E3Al arm, aba Colunas, opo
Propriedades) como ser fei to o reconheci mento do al arme em tempo de execuo,
com um ou doi s cl i ques sobre a col una.
E3Alarm 347
14.2.3 Ordenao de Colunas
Na confi gurao padro, possvel ordenar os al armes cl i cando-se no cabeal ho
das col unas do E3Al arm. Ao cl i car no cabeal ho da col una desejada, o campo
associ ado a el a ser confi gurado como campo pri mri o de ordenao. Ao cl i car
novamente no cabeal ho da mesma col una, o senti do de ordenao pri mri o
(ascendente ou descendente) ser i nverti do.
Cl i cando no cabeal ho da col una desejada com a tecl a SHIFT pressi onada, o
campo associ ado a el a ser confi gurado como campo secundri o de ordenao. Ao
cl i car novamente com a tecl a SHIFT pressi onada no cabeal ho desta col una, o
senti do de ordenao secundri o ser i nverti do.
Para mai ores detal hes sobre este comportamento, veja as propri edades
PrimarySortAscending, PrimarySortField, SecondarySortAscending,
SecondarySortField, ThirdSortAscending, ThirdSortField, FourthSortAscending,
FourthSortField e BannerMode do E3Al arm no Manual de Referncia de Scripts.
Exemplo de ordenao
Na fi gura anteri or, os al armes esto ordenados pri mei ro por DataHora (Entrada), de
forma descendente, e depoi s por rea, tambm de forma descendente.
348 Storage
15
Storage
CAPTULO
O Storage um mdul o al ternati vo de gravao dos dados hi stri cos. Atravs del e,
possvel transformar dados de produo, processos, outras col etas em
i nformaes gerenci ai s. Este mdul o permi te que di versas i nformaes sejam
col etadas atravs de servi dores OPC, dri vers El i pse, bancos de dados em geral , ou
at mesmo arqui vos de texto e armazenamentos em banco de dados comerci ai s
(Mi crosoft SQL Server e Oracl e), por objetos hi stri cos defi ni dos pel o usuri o em
uma forma compacta e efi ci ente.
O armazenamento das i nformaes segue a l gi ca de que um dado s gravado
quando houver uma vari ao si gni fi cati va, defi ni da pel o usuri o. A veri fi cao das
vari aes anal i sada pel o al gori tmo BoxCar/BackSl ope, que permi te uma
compactao de at 93% nos dados, com uma recuperao total das i nformaes
real mente tei s, dependendo da banda morta defi ni da.
A recuperao dos dados no ambi ente do E3 pode ser fei ta atravs de uma
ferramenta de consul ta padroni zada, que permi te montar sua estrutura de consul ta
de forma grfi ca (si mi l ar ao exi stente nas ferramentas Mi crosoft Access ou SQL
Server) ou ai nda edi tar di retamente as consul tas SQL. Os dados extrados podem
ser vi sual i zados em formato tabul ar (E3Browser), em grfi co (E3Chart), ou ai nda
em rel atri os que permi tem vi sual i zao em tel a (propri edade PrintPreview do
Rel atri o), i mpresso di reta para o papel , ou mesmo exportao para vri os
formatos como Acrobat PDF, HTML, TXT, CSV, TIFF e GIF, entre outros.
A pri nci pal funo do Storage permi ti r a gravao dos dados de forma compacta.
Atravs desta ferramenta possvel recuperar com grande exati do todas as
mudanas nas vari vei s de processo, ocupando assi m o mni mo de espao no
banco de dados. Al guns exempl os so mostrados nas sees a segui r.
Grfico sem compactao
A i nformao processada contm vri os pontos.
Storage 349
Grfico sem compactao
Grfico com compactao
Veja que a i nformao prati camente a mesma, s que com menos pontos.
Grfico com compactao
A gravao no Storage fei ta da segui nte manei ra:
Aps a defi ni o da tabel a nas propri edades do Storage, esta gerada cl i cando
em Gerar Tabela e os dados so gravados de acordo com estas defi ni es. Se
houver vari ao de qual i dade no Tag, os dados tambm sero gravados
Os dados s no sero gravados se a vari ao ocorreu em um tempo menor que
o mni mo programado (campo MinRecTime)
350 Storage
Para i nseri r esta ferramenta no E3, si ga estes procedi mentos:
sel eci one a opo Inserir - Storage. No modo Domnio, cl i que com o boto
di rei to do mouse no i tem Objetos de Servidor - Banco de Dados, sel eci one a
opo Inserir Storage em e l ogo aps o nome do projeto desejado.
Inserindo um Storage no modo Domnio
Caso necessi te, confi gure as propri edades do objeto. Al gumas das propri edades
deste objeto podem ser confi guradas atravs da Li sta de Propri edades, sem a
necessi dades de cri ar scri pts para i sto. Caso necessi te confi gurar al guma
propri edade, basta l ocal i z-l a na Li sta de Propri edades e fazer os devi dos ajustes.
Para mai ores i nformaes, consul te o Manual de Referncia de Scripts.
NOTA: O objeto Storage pode ser confi gurado para funci onar como rea de Alarme.
15.1 Configuraes
Quando o Storage cri ado na Tel a, mostrada uma l i sta de defi ni es dos campos
de gravao.
Storage 351
Campos configurados para o Storage
Para adi ci onar um campo, pode-se arrastar e sol tar um Tag ou propri edade a
parti r do Organi zer, ou ento defi ni r o campo e a fonte manual mente.
Para efei tos de posteri or consul ta nos dados, toda a busca se dar atravs do
cami nho do Tag ou propri edade que est sendo armazenada - defi ni do atravs do
campo Fonte. A propri edade Nome s ser uti l i zada caso o campo Fonte contenha
uma expresso (por exempl o, Driver1.Tag1 + Driver1.Tag2).
Logo, se expresses no esti verem sendo uti l i zadas no campo Fonte, no h
necessi dade de se i mportar com o nome do campo. As opes di sponvei s so as
segui ntes:
Opes disponveis na view do Storage
OPO DESCRIO
Adi ci ona campos na tabel a do Storage.
Remove o campo sel eci onado na tabel a
do Storage.
Determi na as confi guraes da tabel a
do Storage.
Gera a estrutura no Banco de Dados.
Nome
Determi na o nome do campo da tabel a
do Storage.
Fonte
Determi na a fonte de dados que ser
associ ada ao campo.
Tipo
Determi na o ti po do campo da tabel a
do Storage. Se este val or for al terado
para Bit, Text ou Integer, as col unas
MinRecTime, MaxRecTime, Varredura,
Banda Morta e Unidade fi cam
desabi l i tadas.
MinRecTime
Tempo mni mo para i nsero de um
dado na tabel a. Este tempo cal cul ado
em mi l i ssegundos.
352 Storage
OPO DESCRIO
MaxRecTime
Tempo mxi mo de espera por um dado,
em segundos. Se passar esse tempo, o
dado consi derado anti go e ser
armazenado.
Varredura
Tempo de varredura do campo. Se este
val or for i gual a 0 (zero), esta col una
fi ca desabi l i tada e mostra o val or
defi ni do em MaxRecTime, em
mi l i ssegundos.
Banda Morta
Banda morta para cl cul o do al gori tmo.
Unidade
Val or absol uto ou a porcentagem de
modi fi cao.
15.1.1 Criando um Storage Vazio
O objeto Storage pode ser cri ado sem que tenha seus campos confi gurados. Para
i sto, basta que suas propri edades DBServer e TableName sejam preenchi das na
sua cri ao. Esta confi gurao permi te que seja cri ado um Storage somente para
consul ta, o que bastante ti l para acessar dados gerados por apl i cati vos
externos. Al gumas restri es so apl i cadas nesta si tuao:
Embora o Storage seja ati vado normal mente, no i r gerar tabel as nem al terar
ndi ces
O boto Gerar Tabela, na janel a de Propri edades, a opo Gerar Estrutura no DB
do menu contextual e o boto da barra de ferramentas do Storage retornam
uma mensagem de erro, i ndi cando que a estrutura do banco de dados no pode
ser cri ada poi s no h campos defi ni dos
O Storage vazi o l i stado normal mente na cai xa de sel eo Nome do Servidor de
uma Consul ta
No h necessi dade de l i cenas de Storage para consul tar dados externos,
somente para escri ta de dados
15.2 Configurao da Tabela
Pode-se acessar as confi guraes da tabel a uti l i zada no Storage de duas manei ras:
1. Cl i cando em Propriedades.
2. Cl i cando com o boto di rei to do mouse sobre o objeto no Organi zer e
sel eci onando a opo Propriedades.
Storage 353
Campos do Storage
Cada campo da aba Storage possui uma propri edade correspondente. As opes
Opes disponveis na aba Storage
OPO DESCRIO
Defi ne o servi dor de Banco de Dados.
DbServer.
Nome da tabela
Determi na o nome da tabel a. Este campo
equi val e propri edade TableName.
354 Storage
OPO DESCRIO
Habi l i ta ou desabi l i ta o descarte dos
anti go de acordo com o que for defi ni do
na opo Mantenha os dados do(s) ltimo
(s). Este campo equi val e propri edade
EnableDiscard.
Mantenha os dados do(s) ltimo(s)... <Tabela
Principal>
Determi na o i nterval o (mi nutos, horas,
di as ou meses) de descarte de dados
anti gos da tabel a. Este campo equi val e
propri edade VerificationUnit.
EnableBackupTable.
Mantenha os dados do(s) ltimo(s)... <Tabela
de Backup>
Mantenha os dado(s) dos ltimo(s) da
Tabel a Pri nci pal . Este campo equi val e
Gerar Tabela
Gera a estrutura da tabel a no Banco de
Dados. Esta opo est di sponvel
atravs do cl i que com o boto di rei to do
mouse no Organi zer, ou cl i cando em
Gerar Tabela.
Aps defi ni r as confi guraes da tabel a, necessri o cl i car em Gerar Tabela. Esta
ao cri a a estrutura da tabel a no banco de dados.
A estrutura de tabel as do Storage semel hante estrutura do Hi stri co: uma tabel a
de defi ni es, uma tabel a pri nci pal de dados e uma tabel a de backup (se escol hi da
pel o usuri o). Para que se possa i denti fi car externamente que uma tabel a
Storage 355
compactada, s veri fi car se foi cri ada a tabel a _Fi el ds.
Tabela Fields
Esta tabel a possui os segui ntes campos:
Campos da tabela _Fields
CAMPOS DESCRIO
FieldDeadBand
Banda morta.
FieldDeadBandUnit
Uni dade da banda morta. Em
porcentagem do val or anteri or ou
porcentagem dos l i mi tes de engenhari a
(val or fi xo).
FieldDescription
Descri o do campo.
FieldEU
Uni dade de Engenhari a.
FieldHighEng
Li mi te superi or do Tag.
FieldID
ndi ce do campo cadastrado no Storage.
FieldLowEng
Li mi te i nferi or do Tag.
FieldMaxRecTime
Depoi s que esse tempo expi ra, o dado
deve ser automati camente gravado.
FieldMinRecTime
Val or mni mo de tempo de vari ao para
armazenar dados.
FieldName
Nome do campo.
FieldQuality
Qual i dade do campo.
FieldScanTimeMs
Tempo de varredura que deve ser
uti l i zado para reconstrui r o grfi co do
Tag, em mi l i ssegundos.
FieldSize
Tamanho do campo.
356 Storage
CAMPOS DESCRIO
FieldSource
Associ ao uti l i zada para obter val ores
deste campo.
FieldType
Ti po do campo.
FieldVARTYPE
Ti po de dado nati vo do campo (0:
I ndefi ni do, 3: I nteger, 5: Doubl e, 8: Text,
11: Bi t).
A i mpl ementao do Storage permi te que o usuri o no tenha que se preocupar em
como os dados esto armazenados nas tabel as. Entretanto, para uma mel hor
compreenso do funci onamento do mdul o, e tambm para permi ti r acesso por
outros programas, ser mostrado a segui r o formato das tabel as.
As opes de gerenci amento de tabel as especi fi cadas no i tem anteri or se apl i cam
na verdade a trs conjuntos de tabel as geradas pel o Storage, de acordo com o
campo Nome de Tabela.
Isto porque, para cada ti po de grandeza armazenada, gerado automati camente
um conjunto de tabel as, a saber: um conjunto para os Tags anal gi cos, outro para
os textos e mai s outro para os di gi tai s. Dessa forma, cada Storage pode gerenci ar
at sete tabel as, caso se especi fi que que os trs ti pos de Tags devam ser
armazenados:
<NomeTabel a>_Fi el ds
<NomeTabel a>
<NomeTabel a>_Text
<NomeTabel a>_Bi t
<NomeTabel a>_Backup
<NomeTabel a>_Text_Backup
<NomeTabel a>_Di g_Backup
A tabel a _Fi el ds contm a descri o dos campos que sero armazenados, que de
forma geral armazenam as mesmas i nformaes defi ni das na confi gurao dos
campos do Storage, al m de associ ar um ndi ce automti co para cada campo.
As demai s tabel as possuem um formato fi xo:
E3TimeStamp: Campo que armazena a data e hora em que houve a vari ao do
Tag. Caso o protocol o de comuni cao suporte o envi o de i nformao de tempo,
este campo conter o timestamp do equi pamento
Qualidade: Contm a i nformao de qual i dade do ponto (rui m, i ncerto ou bom)
de acordo com a uti l i zao dentro do E3 e das normas OPC
ndice: Rel aci ona o campo gravado com o seu respecti vo nome que est
armazenado na tabel a Fi el ds
Storage 357
Valor: Val or armazenado. Para a tabel a de anal gi cos trata-se de um campo ti po
Double (nmero real ), j para a tabel a de di gi tai s trata-se de um nmero i ntei ro
e para os textos trata-se de um campo NVARCHAR de tamanho vari vel ,
especi fi cado pel o usuri o no campo StringFieldSize
15.2.1 Execuo
Ao i ni ci ar a execuo do apl i cati vo e receber a pri mei ra noti fi cao de val or de
cada uma das vari vei s armazenadas, o Storage armazena esse val or obti do com
qual i dade Ruim, e l ogo em segui da com a qual i dade envi ada, se esta for Boa. Isto
porque ao real i zar a consul ta, o usuri o ter a vi sual i zao de que houve uma
i nterrupo no armazenamento.
Depoi s, conforme sejam obti dos novos val ores para as vari vei s, um al gori tmo de
veri fi cao de gravao i nterpreta a sequnci a e deci de se cada ponto ser ou no
armazenado. Este al gori tmo, conheci do como BoxCar/BackSlope, cri a duas bandas
de vari ao (cuja ampl i tude dada pel a banda morta da vari vel ) de um ponto
gravado. A banda hori zontal (BoxCar) defi ne uma veri fi cao comum da banda
morta. Uma segunda banda di agonal (BackSl ope) defi ne uma vari ao para ci ma
ou para bai xo da banda morta.
Portanto, se a vari vel est em uma deri vati va contnua descendente ou
ascendente, s necessri o armazenar os pontos i ni ci ai s ou fi nai s nesta l i nha
reta. Assi m, uma vari vel anal gi ca s gravada se o val or vi ol a tanto a banda
hori zontal quanto a verti cal , ou se houve uma mudana na qual i dade (ou seja, o
equi pamento foi l i gado ou desl i gado).
358 Storage
Exemplo do algoritmo BoxCar/BackSlope
Esta veri fi cao, entretanto, s ocorre para os campos anal gi cos. Para os campos
de texto e di gi tai s, basta que haja uma mudana qual quer de val or ou qual i dade
(por exempl o, o equi pamento perder a comuni cao) para que sejam gravados.
15.2.2 Ferramentas de Consultas Internas
A ferramenta Consulta prev al gumas faci l i dades para real i zar consul tas nos
dados do Storage.
Ao i ni ci ar a confi gurao de uma Consul ta em uma apl i cao que possui um
Storage, este objeto entra na l i sta de Bancos de Dados di sponvei s para consul ta.
Isto porque o Storage atua como um novo provedor de dados, cri ando faci l i dades
para o usuri o consul tar os dados nas tabel as temporai s.
Entretanto, nada i mpede o usuri o de real i zar as consul tas di retamente no Banco
de Dados de ori gem, de acordo com os formatos das tabel as j menci onado. A
desvantagem neste caso que o processo de consul ta ser mai s compl exo.
Portanto, uma vez escol hi do o prpri o Storage como provedor de dados para a
Consul ta, sua i nterface de confi gurao apresenta vri as di ferenas, como pode
ser vi sto na fi gura a segui r. A pri mei ra del as que ao i nvs de exi bi r as tabel as,
mostrada uma rvore com todas as vari vei s que esto sendo armazenadas. A
outra di ferena que o usuri o pode escol her uma entre sete funes para
consol i dao dos dados, mostradas a segui r:
LastValue: Retorna o l ti mo val or armazenado na Base de Dados
Storage 359
ArchivedValue: Retorna um val or armazenado em rel ao a um determi nado
i nstante de tempo defi ni do na vari vel TimeStamp. O ti po de rel ao, defi ni do
na propri edade FunctionSubType, pode ser Previous (Val or armazenado
i medi atamente anteri or ao timestamp forneci do), Next (Val or armazenado
i medi atamente posteri or ao timestamp), Interpolated (Val or cal cul ado a parti r
do val or anteri or e posteri or) e ExactTime (se for encontrado um val or
armazenado no exato i nstante que foi forneci do pel o timestamp). As vari vei s
tambm podem ser defi ni das em tempo de execuo a parti r da chamada do
mtodo SetVariableValue da Consul ta
TagAttribute: Devol ve um atri buto do Tag, defi ni do em FunctionSubType, que
pode ser FieldDescription (Si gni fi cado ou descri o do Tag), FieldSource
(Cami nho do Tag que est sendo armazenado), FieldType (Ti po de dado: Double,
Bit, String ou Integer), FieldEU (Uni dades de engenhari a), FieldLowEng (Li mi te
i nferi or), FieldHighEng (Li mi te superi or), FieldDeadBand (Banda morta para
gravao), FieldDeadBandUnit (Uni dade da banda morta, se em val ores
absol utos ou em porcentagem), FieldMinRecTime (Tempo mni mo para gravao,
vari aes menores que esse i nterval o so desprezadas) e FieldMaxRecTime
(Tempo mxi mo para gravao, a ausnci a de vari ao nesses i nterval os fora
uma gravao)
CompressedDataNValues: Retorna, para um ni co Tag, N val ores defi ni dos na
vari vel NumVals, armazenados a parti r de um i nstante i ni ci al , defi ni do na
vari vel StartTime. As vari vei s tambm podem ser defi ni das em tempo de
execuo a parti r da chamada do mtodo SetVariableValue da Consul ta
CompressedDataStartEndTime: Retorna, para um ni co Tag, os val ores
armazenados que esto entre o i nterval o defi ni do pel as vari vei s StartTime e
EndTime. As vari vei s tambm podem ser defi ni das em tempo de execuo a
parti r da chamada do mtodo SetVariableValue da Consul ta
SampledData: Retorna, para um ou mai s Tags, os val ores i nterpol ados (ou seja,
esti mados) entre os i nstantes defi ni dos pel as vari vei s StartTime e EndTime, a
i nterval os fi xos defi ni dos pel a vari vel TimeInterval. As vari vei s tambm
podem ser defi ni das em tempo de execuo a parti r da chamada do mtodo
SetVariableValue da Consul ta
CalculatedData: Retorna, para um ou mai s Tags, o resul tado de operaes
matemti cas apl i cadas aos dados entre os i nstantes defi ni dos pel as vari vei s
StartTime e EndTime, a i nterval os fi xos defi ni dos pel a vari vel TimeInterval.
Os ti pos de cl cul os so: Total, Mnimo, Mximo, Desvio Padro, Amplitude,
Mdia e Mediana. As vari vei s tambm podem ser defi ni das em tempo de
execuo a parti r da chamada do mtodo SetVariableValue da Consul ta
Para todas as opes possvel i ndi car se os dados com qual i dade Ruim sero
i ncl udos ou no no resul tado, atravs da cai xa de sel eo Incluir qualidade RUIM
(correspondente propri edade IgnoreQuality da Consul ta associ ada ao objeto
Storage).
360 Storage
Funes da Consulta
15.2.3 Utilizao
Se a funo escol hi da possui al gum fi l tro, ento necessri o i nformar o val or dos
fi l tros antes de executar a Consul ta, seja na prpri a cai xa de di l ogo de
confi gurao (na aba Visualizar) ou atravs de scri pt, usando o mtodo
SetVariableValue. Exempl o:
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 desenvol vendo um programa externo, em l i nguagens como Java,
Vi sual Basi c ou C++, e se deseja obter os dados armazenados pel o Storage,
Storage 361
possvel real i zar chamadas a Stored Procedures, que so cri adas pel o Storage em
seu Banco de Dados. Exi stem sete Stored Procedures, que correspondem a al gumas
das opes de Consul ta exi bi das a segui r:
Opes de consultas disponveis
FUNO CONSULTA STORED PROCEDURE
LastValue
E3LastVal ue
ArchivedValue
E3Archi ve, E3Archi veI nterpol ate
CompressedDataNValues
E3NCompData
CompressedDataStartEndTime
E3CompData
SampledData
E3Sampl edData
CalculatedData
E3Cal cul atedData
As Stored Procedures que uti l i zam parmetros de ti po Data recebem este parmetro
na chamada como um nmero Float (ponto fl utuante), ao i nvs de DateTime. Isto
fei to para aumentar a preci so do E3, j que ao uti l i zar o formato DateTime a
preci so mxi ma de 3ms, ao i nvs de 1ms com o ti po Float.
Para faci l i tar a passagem de parmetros, pode-se adi ci onar ao Banco de Dados
uma funo do usuri o que transforma um val or DateTime em um Float, conforme
o exempl o a segui r:
CREATE FUNCTION E3GETFLOATVALUE (@dDate datetime)
RETURNS FLOAT AS
BEGIN
RETURN CAST(@dDate AS float)
END
A segui r, al guns exempl os da uti l i zao destas funes.
15.2.4.1 E3LastValue
Retorna o l ti mo val or de um determi nado Tag que est armazenado no Banco de
Dados. A descri o formal :
E3LastValue(@strTableName varchar(100),
@strFieldName VARCHAR(100),
@strFilter VARCHAR(500),
@type int,
@bQuality int)
Onde:
@strTableName: nome da tabel a
@strFieldName: nome do campo
@strFilter: caso quei ra i nseri r opes de fi l tro para o val or
362 Storage
@type: ti po de dado (0: String, 1: Bit ou Integer, 2: Analgico)
@bQuality: se di ferente de 0, somente i ncl ui Tags com qual i dade Boa
Retorna uma consul ta com apenas uma l i nha, com os campos E3TimeStamp,
Quality e FieldValue. Exempl o de uti l i zao:
EXECUTE E3LastValue 'TabelaXX', 'Tag234', '', 2, 1
15.2.4.2 E3Archive
Retorna um val or armazenado em rel ao a um i nstante, conforme o exposto na
funo ArchivedValue. usada somente para os subti pos Prev (0), Next (2) e
ExactTime (3). A descri o formal :
E3Archive(@iSubType int,
@strTableName varchar(100),
@dData float,
@type int,
@bQuality int)
Onde:
@iSubType: subti po da funo (0: Prvio, 2: Prximo, 3: Instante Exato)
@Data: i nstante no tempo para a busca, no formato Float
Retorna uma consul ta com apenas uma l i nha, com os campos E3TimeStamp,
Quality e FieldValue. Exempl o de uti l i zao:
DECLARE @MyDate FLOAT
SET @MyDate = dbo.E3GETFLOATVALUE('10-10-2005 12:00:00')
EXECUTE E3Archive 0, 'STO22', @MyDate, 'Dados.TagDemo1', '', 2,
0
15.2.4.3 E3ArchiveInterpolate
Retorna os pontos i medi atamente anteri ores e posteri ores a um i nstante, conforme
exposto para a funo ArchivedValue, porm somente para o Subti po Interpolado. A
descri o formal :
E3ArchiveInterpolate(@strTableName varchar(100),
@dData float,
@type int,
@bQuality int)
Onde:
Storage 363
@dData: i nstante no tempo para a busca, no formato Float
Esta consul ta retorna duas l i nhas, com os campos E3TimeStamp e FieldValue.
Exempl o de uti l i zao:
EXECUTE E3ArchiveInterpolate 'STO22', @MyDate,
'Dados.TagDemo1', '', 2, 0
15.2.4.4 E3NCompData
Equi val e funo CompressedDataNValues. A descri o formal :
E3NCompData(@strTableName varchar(100),
@dData float,
@iNValues int,
@strOrder VARCHAR(100),
@type int,
@bQuality int)
Onde:
@iNValues: o nmero de val ores desejado
@strOrder: quando desejar que a consul ta seja ordenada por outro campo que
no seja o TimeStamp
Esta funo retorna o nmero de l i nhas sol i ci tado, se encontrado, com os campos
E3TimeStamp, Quality e FieldValue. Exempl o de uti l i zao:
EXECUTE E3NCompData 'STO22', @MyDate, 'Dados.TagDemo1', 20, '',
'', 2, 0
15.2.4.5 E3CompData
Equi val e funo CompressedDataStartEndTime. A descri o formal :
E3CompData(@strTableName varchar(100),
@dStartData float,
@dEndData float,
@strOrder VARCHAR(100),
@type int,
@bQuality int)
364 Storage
Onde:
@dStartData: a data i ni ci al , em formato Float
@dEndData: a data fi nal , em formato Float
@strOrder: quando desejar que a consul ta seja ordenada por outro campo que
no seja o TimeStamp
Esta funo retorna o nmero de l i nhas encontrado no i nterval o, com os campos
E3TimeStamp, Quality e FieldValue. Exempl o de uti l i zao:
DECLARE @MyStartDate FLOAT
DECLARE @MyEndDate FLOAT
SET @MyStartDate = dbo.E3GETFLOATVALUE('10-10-2005 12:00:00')
SET @MyEndDate = dbo.E3GETFLOATVALUE('10-10-2006 12:00:00')
EXECUTE E3CompData 'STO22', @MyStartDate, _
@MyEndDate, 'Dados.TagDemo1', '', '', 2, 0
15.2.4.6 E3SampledData
Equi val e funo SampledData. A descri o formal :
E3SampledData(@strTableName varchar(100),
@iModMin int,
@dStartDate float,
@dEndDate float,
@strFields VARCHAR(1000),
@strWhere VARCHAR(4000),
@type int,
@bQuality int)
Onde:
@iModMin: i nterval o em segundos para a i nterpol ao de cada val or dentro do
i nterval o
@dStartData: a data i ni ci al , em formato Float
@dEndData: a data fi nal , em formato Float
@strFields: l i sta de campos
EXECUTE E3SampledData 'STOXX', 10, @MyStartDate, _
@MyEndDate, 'Dados.TagDemo1', '', 2, 1
Storage 365
15.2.4.7 E3CalculatedData
Equi val e funo CalculatedData. A descri o formal :
E3CalculatedData(@iSubType int,
@strTableName varchar(100),
@iModMin int,
@dStartDate float,
@dEndDate float,
@strFields VARCHAR(1000),
@strWhere VARCHAR(4000),
@type int,
@bQuality int)
Onde:
@iSubType: subti po do cl cul o (0: Total, 1: Mnimo, 2: Mximo, 3: Desvio Padro,
4: Amplitude, 5: Mdia e 6: Mediana)
EXECUTE E3CalculatedData 0, 'STOXX', 10, _
@MyStartDate, @MyEndDate, 'Dados.TagDemo1', '', 2, 1
366 Histrico
16
Histrico
CAPTULO
Histricos so mdul os responsvei s pel o armazenamento de dados da apl i cao
em um Banco de Dados. Permi tem armazenar dados de processos para anl i ses
futuras. Voc pode cri ar tantos arqui vos de Hi stri cos quantos desejar, cada um
contendo di versos Tags ou expresses. Cada Hi stri co pode cri ar ou uti l i zar uma
tabel a i ndependente dentro do Banco de Dados, cujo armazenamento pode ser
defi ni do por Tempo ou por Evento. Atravs da propri edade CacheSize, defi ne-se o
nmero de regi stros envi ados por vez para o Banco de Dados. Conforme a defi ni o
da propri edade DBServer, defi ne-se o Servi dor do Banco de Dados que ser
uti l i zado pel o hi stri co. Para uti l i zar este recurso, si ga estes procedi mentos:
sel eci one a opo Inserir - Histrico. No modo Domnio, cl i que com o boto
di rei to do mouse no i tem Objetos de Servidor - Banco de Dados, sel eci one a
opo Inserir Histrico em e l ogo aps o nome do projeto desejado.
Inserindo um Histrico no modo Domnio
2. Quando o Hi stri co for habi l i tado, as segui ntes opes de confi gurao so
Histrico 367
apresentadas:
Opes do Histrico
Opes disponveis na view do Histrico
OPO DESCRIO
Adi ci ona campos na tabel a do
Hi stri co.
Remove o campo sel eci onado da tabel a
do Hi stri co.
Determi na as confi guraes da tabel a
do Hi stri co.
Gera a estrutura no Banco de Dados.
Cri a uma chave pri mri a.
Confi gura os ndi ces que sero cri ados
no Hi stri co.
Mantm o Hi stri co sem vncul os
di retos com a tabel a exi stente.
Busca os campos na tabel a ori gi nal .
Vi ncul a o Hi stri co a uma tabel a j
exi stente.
3. Acesse as propri edades do Hi stri co. Para tanto, cl i que com o boto di rei to do
mouse sobre o objeto e acesse a opo Propriedades. Al gumas das
propri edades deste objeto podem ser confi guradas atravs da Li sta de
Propri edades, sem a necessi dade da cri ao de scri pts para i sto. Caso seja
necessri o confi gurar al guma propri edade, basta l ocal i z-l a na Li sta de
Propri edades e fazer os devi dos ajustes. Demai s i nformaes sobre as
funci onal i dades das propri edades deste objeto podem ser encontradas no
Manual de Referncia de Scripts, no captul o referente ao objeto Hi stri co.
NOTA: O objeto Hi stri co pode ser confi gurado para funci onar como rea de Alarme.
368 Histrico
16.1 Configuraes
Quando um Hi stri co i nseri do no projeto, o campo E3TimeStamp cri ado
automati camente na tabel a. O campo E3TimeStamp mostra a data e hora em que o
val or foi buscado (di ferente do timestamp do Tag). Val e l embrar que este campo
uti l i zado somente para l ei tura. possvel associ ar um Tag ao campo E3TimeStamp.
Se no houver Associ ao, el e busca a hora atual do si stema para a gravao. Para
cri ar a tabel a no Hi stri co, i mportante que seus campos sejam previ amente
cri ados cl i cando-se em (Adicionar campo). Para remover al gum campo
i ndesejado, cl i que em (Remover campo). A segui nte mensagem de confi rmao
aparecer:
Mensagem para confirmar excluso de campo na tabela
O campo Nome defi ne o nome do campo da tabel a. O campo Tipo defi ne o ti po de
campo da tabel a, e a fonte deste campo defi ni da em Fonte. Tambm possvel
defi ni r se este campo ser ou no a chave pri mri a da tabel a.
16.1.1 Chave Primria
A Chave Primria um campo ou um conjunto de campos que i denti fi ca de manei ra
ni ca cada regi stro de uma tabel a. Assi m como o ndi ce pri nci pal para a tabel a, el a
uti l i zada para associ ar dados entre tabel as. Al guns exempl os de chaves
pri mri as so cdi gos de cl i entes, CNPJ, nmero de matri cul a, etc. Aps a defi ni o
de um campo como sendo a chave pri mri a da tabel a, o prpri o Banco de Dados
garante que no sejam i nseri dos dados dupl i cados no campo que a chave
pri mri a. Por exempl o, se o usuri o tentar cadastrar um pedi do com o mesmo
nmero de um pedi do j exi stente, o regi stro no ser cadastrado e uma mensagem
de erro ser mostrada. H doi s ti pos de chave pri mri a: Simples ou Composta.
Uma Chave primria simples um campo que i denti fi ca de modo ni co cada
regi stro de uma tabel a. Uma Chave primria composta pode ser formada pel a
combi nao de doi s ou mai s campos da tabel a. Podem exi sti r casos em que um
ni co campo no capaz de atuar como chave pri mri a porque el e apresenta
val ores repeti dos. Al m di sso, uma tabel a pode ter somente uma chave pri mri a,
seja el a si mpl es ou composta. Ou seja, no se pode defi ni r doi s ou mai s campos de
Histrico 369
uma tabel a para que cada um seja uma chave pri mri a separada. No confundi r
com o caso de uma chave pri mri a composta, onde a uni o de doi s ou mai s
campos que forma a ni ca chave pri mri a da tabel a.
Ao escol her campos da Chave Pri mri a, consi dere os segui ntes detal hes:
No so permi ti dos val ores dupl os ou nul os
Caso no exi sta um i denti fi cador ni co para uma determi nada tabel a, pode-se
usar um campo que numere os regi stros sequenci al mente
A chave pri mri a pode ser confi gurada de duas formas: veri fi cando na tel a do
Hi stri co qual campo da tabel a que se pretende tornar chave pri mri a, e
habi l i tando-o atravs do boto ou cl i cando no cone , que abre a janel a de
confi gurao, conforme a fi gura a segui r:
Editando um ndice Chave Primria
Nesta cai xa de di l ogo, basta sel eci onar o campo desejado como chave pri mri a.
370 Histrico
Opes disponveis na janela Edio de ndices
OPO DESCRIO
Nome do ndice
Determi na o nome da chave pri mri a.
Garantir que os valores deste ndice sero
nicos
Faz com que os val ores especi fi cados
para o ndi ce Chave Pri mri a sejam
ni cos. Esta opo est sempre marcada
para Chaves Pri mri as, no podendo ser
modi fi cada.
Nome do campo
Mostra o nome do campo.
Ordenao
Mostra a ordenao do campo
sel eci onado.
Tipo
Mostra o ti po do campo da tabel a.
Mude a ordem dos campos
Muda a posi o do campo na tabel a,
fazendo com que el e suba ou desa.
Cl i cando em OK, confi rma-se que o campo determi nado uma chave pri mri a da
tabel a. Para cancel ar a confi gurao, cl i que em Cancelar. Pode-se tambm atri bui r
um ndi ce tabel a.
16.1.2 ndices
Um ndice um campo ou conjunto de campos que sero previ amente ordenados
pel o Banco de Dados a fi m de mel horar a performance das consul tas que uti l i zam
este ndi ce. El es so uti l i zados para encontrar regi stros com um val or especfi co em
uma col una rapi damente. Sem um ndi ce, o Banco de Dados tem de i ni ci ar com o
pri mei ro regi stro e depoi s l er atravs de toda a tabel a at que el e encontre os
regi stros rel evantes. Quanto mai or a tabel a, mai or ser o custo dessa operao. Se
a tabel a possui r um ndi ce para as col unas em questo, o Banco de Dados pode
rapi damente obter uma posi o para procurar no mei o do arqui vo de dados sem
ter que varrer todos os regi stros. Por exempl o, se uma tabel a possui 1.000
regi stros, i sto pel o menos 100 vezes mai s rpi do do que l er todos os regi stros
sequenci al mente. Note que se for preci so acessar quase todos os 1.000 regi stros,
no entanto, mai s rpi do acess-l os sequenci al mente, poi s i sto evi tari a acessos
ao di sco.
Os ti pos de ndi ces di sponvei s so os segui ntes: Primrio, nico e Index.
Todos os ti pos de col unas da tabel a podem ser i ndexadas. O uso de ndi ces nas
col unas rel evantes a mel hor forma de mel horar a performance da tabel a. O
nmero mxi mo de ndi ces por tabel as e o tamanho mxi mo de um ndi ce
defi ni do pel o mecani smo de armazenamento do Servi dor de Banco de Dados.
Pode-se cri ar ndi ces em ml ti pl as col unas. Um ndi ce de ml ti pl as col unas pode
ser consi derado um vetor ordenado contendo val ores que so cri ados
concatenando-se val ores de col unas i ndexadas.
Os ndi ces podem ser confi gurados atravs do cone , que abri r a janel a de
confi gurao, conforme fi gura a segui r:
Histrico 371
Janela do Editor de ndices
Opes disponveis na janela Editor de ndices
OPO DESCRIO
Nome
Mostra o nome do ndi ce exi stente.
Campos
Mostra o campo ao qual o ndi ce est
associ ado na tabel a.
Adicionar
Abre uma cai xa de di l ogo para a adi o
de um ndi ce.
Editar
Abre uma cai xa de di l ogo para a edi o
do ndi ce sel eci onado.
Remover
Remove o ndi ce sel eci onado.
Ao cl i car em Adicionar, a segui nte cai xa de di l ogo aberta:
372 Histrico
Adicionando ndices
Opes disponveis na adio de ndices
OPO DESCRIO
Nome do ndice
Determi na o nome do ndi ce.
Garantir que os valores deste ndice sero
nicos
Se habi l i tada, faz com que os val ores
especi fi cados para o ndi ce sejam
ni cos.
Nome do campo
Mostra os nomes dos campos. Marque
aquel es que devem pertencer ao ndi ce.
Ordenao
Mostra a ordenao do campo
sel eci onado (Ascendente ou
Descendente).
Tipo
Mostra o ti po do campo da tabel a.
Mude a ordem dos campos
Muda a posi o do campo na tabel a,
fazendo com que el e suba ou desa.
Cl i cando em OK, os ndi ces na tabel a so confi rmados. Para cancel ar a
confi gurao, cl i que em Cancelar.
Histrico 373
16.1.3 Configuraes da Tabela
Depoi s de defi ni das as opes anteri ores, necessri o confi gurar as i nformaes
da tabel a do Hi stri co e gerar a estrutura no Banco de Dados. Para tanto, cl i que
com o boto di rei to do mouse sobre o Hi stri co e sel eci one a opo Propriedades.
Acesse a aba Histrico e a segui nte janel a ser mostrada:
Aba Histrico
Cada campo da aba Histrico possui uma propri edade correspondente. As opes
374 Histrico
Opes disponveis na aba Histrico
OPO DESCRIO
Defi ne o servi dor de Banco de Dados.
DbServer.
Nome da tabela
Determi na o nome da tabel a. Este campo
equi val e propri edade TableName.
Gravar um novo registro a cada
Determi na a vari ao do i nterval o de
tempo (em ms), ou seja, de quanto em
quanto tempo os dados do Hi stri co
sero gravados na tabel a. Este campo
equi val e propri edade ScanTime.
Habi l i ta ou desabi l i ta o descarte dos
anti go de acordo com o que for defi ni do
na opo Mantenha os dados do(s) ltimo
(s). Este campo equi val e propri edade
EnableDiscard.
Mantenha os dados do(s) ltimo(s) ...
<Tabela Principal>
Determi na o i nterval o (mi nutos, horas,
di as ou meses) de descarte de dados
anti gos da tabel a. Este campo equi val e
propri edade VerificationUnit.
EnableBackupTable.
Mantenha os dados do(s) ltimo(s)...
<Tabela de Backup>
Mantenha os dados do(s) ltimo(s) da Tabela
Principal. Este campo equi val e
Histrico 375
OPO DESCRIO
Gerar Tabela
Gera a estrutura da tabel a no Banco de
Dados. Esta opo est di sponvel
atravs do cl i que com o boto di rei to no
Organi zer, ou atravs do boto Gerar
Tabela.
Ao cl i car em Gerar Tabela, o si stema mostra a segui nte mensagem:
Mensagem do sistema
Quando a opo Gerar Tabela uti l i zada, a tabel a especi fi cada no Hi stri co
gerada, al m de uma tabel a _Fi el ds. Esta tabel a possui as i nformaes de cada
campo cadastrado no Hi stri co.
Campos
Os campos di sponvei s na tabel a do Hi stri co so os segui ntes:
376 Histrico
Campos da tabela do Histrico
CAMPO DESCRIO
FieldDeadBand
Banda morta.
FieldDeadBandUnit
Uni dade uti l i zada pel a banda morta (em
val ores absol utos ou porcentagem).
FieldDescription
Descri o do campo.
FieldEU
Uni dade de Engenhari a.
FieldHighEng
Li mi te superi or do Tag.
FieldID
ndi ce do campo cadastrado no Hi stri co.
FieldLowEng
Li mi te i nferi or do Tag.
FieldMaxRecTime
Depoi s que esse tempo expi ra, o dado
deve ser automati camente gravado.
FieldMinRecTime
Val or mni mo de tempo de vari ao para
armazenamento de um dado.
FieldName
Nome do campo do Hi stri co.
FieldQuality
Ti po da qual i dade do campo. As opes
di sponvei s so: 0 - sem qualidade; 1 -
mtodo anterior verso 1.21 (onde 0 =
valor duvidoso; 1 = valor bom); 2 - qualidade
real do tag.
FieldSize
Tamanho do campo.
FieldSource
Associ ao uti l i zada pel o campo para
obter os seus val ores.
FieldType
Ti po do campo.
A opo Vincular Histrico a uma tabel a j exi stente vi ncul a o Hi stri co a
tabel as exi stentes no Banco de Dados. Quando esta opo habi l i tada, o si stema
abre uma cai xa de di l ogo para determi nar quai s as tabel as sero vi ncul adas ao
Hi stri co corrente, conforme fi gura a segui r:
Histrico 377
Seleo de tabela para vinculo com o Histrico
Quando a tabel a sel eci onada e cl i ca-se em OK, o si stema mostra a segui nte
mensagem:
Mensagem do sistema
Cl i cando em Cancel, os campos confi gurados na tabel a i ro permanecer com as
confi guraes atuai s. J cl i cando em OK, todos os campos, ndi ces e chaves
pri mri as defi ni das no Hi stri co sero substi tudos pel os dados da tabel a
sel eci onada.
Quando este i tem uti l i zado, outros doi s botes so habi l i tados: Manter
Histrico sem vnculos diretos com tabela existente e Buscar campos da tabela
original.
378 Histrico
Quando a opo Manter Histrico sem vnculos diretos com tabela existente
habi l i tada, o si stema mostra a segui nte mensagem:
Mensagem do sistema quanto configurao do Histrico
Cl i cando em Cancel, a tabel a permanecer com as confi guraes atuai s. J
cl i cando em OK, o si stema rei ni ci al i za a tabel a com seus campos i ni ci ai s, onde h
somente o campo padro habi l i tado (E3TimeStamp).
Histrico aps a habilitao da opo Manter histricos sem vnculo direto com a tabela
existente
J a opo Buscar campos da tabela original recupera os dados do Hi stri co
vi ncul ado tabel a exi stente, que havi am si do apagados:
Histrico utilizando a opo Buscar campos da tabela original
Consultas 379
17
Consultas
CAPTULO
O objeto Consulta (ou Query) auxi l i a no processo de defi ni o de consul tas no
Banco de Dados da apl i cao. Toda vez que os objetos E3Browser ou Rel atri o
buscam dados de um Banco de Dados, necessri o envi ar um comando, de forma
que se sai ba quai s os dados desejados para aquel e objeto. Logo, toda vez que uma
apl i cao preci sar gravar ou buscar dados armazenados em um Banco de Dados,
so envi ados comandos no formato SQL (Structured Query Language). A Consul ta
apresenta uma i nterface ami gvel , que permi te a construo das consul tas em uma
forma grfi ca e o acompanhamento i medi ato da si ntaxe SQL que est sendo gerada.
A consul ta permi te mostrar os dados dos l ti mos N di as, horas ou meses, data
fi nal ou i ni ci al e consul tas.
O Assi stente da consul ta responsvel por cri ar o texto que faz o fi l tro ou a
consul ta, no sendo necessri o para o usuri o saber detal hes como data, etc. Para
uti l i zar este recurso, si ga estes procedi mentos:
1. Cl i que com o boto di rei to do mouse sobre a Tel a do projeto e sel eci one a
opo Inserir - Consulta.
NOTA: Quando cri ado um objeto Rel atri o ou E3Browser, o objeto Consul ta
adi ci onado automati camente a estes objetos. No entanto, tambm pode-se i nseri r
este objeto em uma Pasta de Dados ou em uma Tel a. Para mai ores detal hes, veja
os captul os correspondentes.
2. Antes de defi ni r a Consul ta, deve-se i nformar em qual Servi dor de Banco de
Dados a Consul ta i r buscar os dados. Para tanto, sel eci one o servi dor na
cai xa de l i stagem Nome do Servidor.
Definio do Servidor Banco de Dados
A confi gurao da Consul ta depende do objeto ao qual el a est rel aci onada.
380 Consultas
Configuraes da Consulta
Para veri fi car quai s as confi guraes necessri as da Consul ta, veja os captul os
Relatrios e E3Browser.
Al gumas das propri edades da Consul ta podem ser confi guradas atravs da Li sta de
Scripts.
17.1 Criando uma Consulta
Quando um E3Browser ou um Rel atri o cri ado no projeto, uma Consul ta
automati camente i nseri da como objeto fi l ho, com o nome Consulta1. Para uti l i zar
1. Ao cl i car com o boto di rei to do mouse na Consul ta e sel eci onar o i tem
Configurar, uma janel a mostrada sol i ci tando a i denti fi cao do Servi dor de
Banco de Dados da apl i cao.
Consultas 381
Definio do Servidor Banco de Dados na Consulta
2. Aps ser defi ni do o servi dor Banco de Dados, uma nova janel a aparecer com
tabel as que foram encontradas no Banco de Dados, permi ti ndo a sua sel eo.
Adio de tabela
3. Sel eci one as tabel as que faro parte da consul ta e cl i que em OK.
4. Depoi s de defi ni das as tabel as, a janel a de defi ni o da Consul ta mostrada,
contendo quatro abas:
Campos
Variveis
Visualizar
382 Consultas
SQL
Configurao da Consulta
Estas abas so descri tas nas prxi mas sees.
17.1.1 Aba Campos
Esta aba mostra todos os campos das tabel as usadas na Consul ta. Ao cl i car em ,
possvel sel eci onar outras tabel as para a Consul ta.
Consultas 383
Inserindo uma tabela
Para sel eci onar todos os campos da tabel a para que faam parte da Consul ta,
sel eci one o pri mei ro i tem da l i sta de sel eo, correspondente ao smbol o *
(asteri sco). Para adi ci onar um campo especfi co, sel eci one sua cai xa de sel eo
correspondente.
384 Consultas
Selecionando campos de uma tabela
Devi do questes de performance, i mportante adi ci onar Consul ta somente
campos que real mente i nteressam para a anl i se.
Na rea de col unas, os campos escol hi dos so mostrados.
rea de colunas
Cada col una mostra as segui ntes propri edades para cada campo da tabel a ou
tabel as sel eci onadas.
Opes disponveis para a configurao de colunas
OPO DESCRIO
Colunas
Mostra o nome das col unas
sel eci onadas. Ao cl i car na cai xa de
combi nao de cada l i nha, pode-se
redefi ni r a col una desejada.
Ttulo
Permi te que um novo nome seja defi ni do
para a col una (tambm conheci do como
alias).
Consultas 385
OPO DESCRIO
Tabela
Mostra o nome da tabel a de ori gem do
campo.
Mostrar
Habi l i ta ou desabi l i ta o campo.
Ordenao
Permi te ordenar os val ores: Sem
ordenao, Ascendente (val ores menores
pri mei ro) e Descendente (val ores mai ores
pri mei ro).
Ordem
Defi ne a pri ori dade quando mai s de um
campo possui ordenao.
Agrupado por
Permi te que os dados sejam agrupados a
cada novo val or do campo.
Funo
Permi te defi ni r a execuo de uma
funo para o campo.
Filtro
Defi ne um cri tri o de consul ta, como por
exempl o i nterval os de data.
Ao defi ni r um fi l tro, a janel a a segui r ser mostrada, permi ti ndo que se defi na o
ti po de comparao e o val or a ser comparado.
Definindo um filtro
O ti po de dado de comparao pode ser defi ni do ao cl i car na cai xa de sel eo
correspondente e sel eci onar um dos ti pos na l i sta de opes.
386 Consultas
Configuraes para a definio do filtro
O val or de comparao poder ser uma constante (por exempl o, 123, 45, "ABCD",
etc.) ou uma vari vel defi ni da pel o usuri o. Para cri ar uma vari vel , basta
i nformar um nome qual quer entre os smbol os descri tos a segui r:
<% %> se o val or for numri co
'<% %>' se o val or for uma String
#<% %># se o val or for uma data
O val or da vari vel pode ser defi ni do na aba Variveis ou atravs do mtodo
SetVariableValue, vi a scri pt.
17.1.2 Aba Variveis
Esta aba permi te defi ni r val ores padro para vari vei s defi ni das pel o usuri o.
Estas vari vei s tambm podem ter seu val or al terado em tempo de execuo
uti l i zando o mtodo SetVariableValue.
Consultas 387
Aba Variveis
As col unas desta aba so descri tas na tabel a a segui r.
Opes disponveis na aba Variveis
OPO DESCRIO
Nome
O nome da vari vel defi ni da pel o
usuri o.
Valor
Uma cai xa de sel eo onde o val or do
ti po de dados pode ser sel eci onado. 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 prvi a dos resul tados da Consul ta ao cl i car em . Tambm
possvel l i mi tar o nmero mxi mo de regi stros retornados, permi ti ndo agi l i zar a
consul ta.
388 Consultas
Visualizao da Consulta
17.1.4 Aba SQL
Nesta aba exi bi da a si ntaxe SQL resul tante da confi gurao real i zada. Pode-se
edi tar di retamente a consul ta, sel eci onando a opo Habilita edio direta do SQL.
Consultas 389
Aba SQL
Ao desmarcar a opo Habilita edio direta do SQL, todas as al teraes so
perdi das e a Consul ta retorna s opes sel eci onadas nas abas Campos, Variveis
e Visualizar.
Aviso ao desabilitar a edio direta do SQL
17.2 Uso dos Filtros da Consulta atravs de
Scripts
Confi gurar e confi rmar se a Consul ta est correta apenas um dos passos no seu
uso. O uso em tempo de execuo e as modi fi caes de val ores dos fi l tros
defi ni dos para a Consul ta podem ser vi stos no scri pt a segui r. O mtodo
SetVariableValue o responsvel pel a confi gurao da Consul ta, conforme os
val ores passados vi a scri pt.
390 Consultas
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 possi bi l i ta que os novos parmetros de Consul ta seja real mente
uti l i zados, vi sto que uma nova Consul ta executada respei tando estes novos
val ores.
17.3 Uso de Recordsets de uma Consulta
atravs de Scripts
Um outro uso i nteressante da Consul ta trabal har com Recordsets. Depoi s de
executada uma Consul ta, possvel capturar o Recordset correspondente e
trabal har com regi stros l i nha a l i nha, executar novas Consul tas, etc. Na l i nha de
comando a segui r:
RS = TelaInicial.E3Browser1.Consulta1.GetADORecordset()
A vari vel RS assume todas as caractersti cas de um Recordset. A vantagem do uso
deste recurso que se forem fei tas modi fi caes nas propri edades do banco de
dados, no necessri o ajustar cada um dos scri pts que acessam este banco de
dados.
E3Browser 391
18
E3Browser
CAPTULO
O E3Browser um control e Acti veX uti l i zado para vi sual i zar dados armazenados
em Bancos de Dados. Pode-se confi gurar consul tas uti l i zando fi l tros de vri os
ti pos nos dados, atri bui r cores para cada col una, entre outras confi guraes. Este
objeto uti l i zado para vi sual i zar os hi stri cos, al armes ou qual quer tabel a
exi stente no Banco de Dados.
E3Browser
1. Insi ra um E3Browser no projeto atravs do cl i que com o boto di rei to do
mouse na rea de trabal ho, sel eci onando o i tem Inserir - E3Browser.
392 E3Browser
Inserindo um E3Browser na Tela
2. O E3Browser uti l i za o objeto Consul ta para auxi l i ar o usuri o no processo de
defi ni o de consul tas no Banco de Dados da apl i cao. Para mai ores
i nformaes, consul te o captul o referente.
3. Caso necessi te, confi gure as propri edades do E3Browser. Al gumas das
confi gurar al guma propri edade, basta l ocal i z-l a na Li sta de Propri edades e
fazer os devi dos ajustes. Demai s i nformaes sobre as funci onal i dades das
18.1 Objeto Consulta no E3Browser
A Consulta um objeto do E3 que auxi l i a o usuri o no processo de defi ni o de
consul tas no Banco de Dados da apl i cao. Toda vez que o E3Browser for buscar
dados no Banco de Dados, necessri o envi ar um comando, de forma que se sai ba
quai s os dados desejados para aquel e objeto. Logo, toda vez que uma apl i cao E3
preci sar gravar ou buscar dados armazenados em um Banco de Dados, so
envi ados comandos no formato SQL (Structured Query Language).
E3Browser 393
Consulta no objeto E3Browser
A Consul ta apresenta uma i nterface ami gvel que permi te a construo das
consul tas de forma grfi ca e o acompanhamento i medi ato da si ntaxe SQL que est
sendo gerada.
NOTA: Um E3Browser no pode carregar consul tas que se encontrem no servi dor.
A aba Consulta mostra os campos di sponvei s na consul ta. Tai s campos podem ser
acessados cl i cando-se em Configurar, que abre o assi stente de confi gurao da
consul ta.
394 E3Browser
Aba Consulta
Para mai ores i nformaes sobre a Consul ta, veja o captul o Consultas.
18.2 Outras Configuraes
As confi guraes di sponvei s no E3Browser so descri tas nas sees segui ntes.
18.2.1 Aba Estilo
Atravs da aba Estilo pode-se defi ni r a aparnci a das di vi ses (grade) das cl ul as e
di menses das l i nhas e col unas.
E3Browser 395
Aba Estilo
Cada campo da aba Estilo possui uma propri edade correspondente. As
Opes disponveis na aba Estilo
OPO DESCRIO
Estilo da grade
Determi na o esti l o da grade do
E3Browser. Este campo equi val e
propri edade GridLinesType do E3Browser.
Altura do cabealho
Determi na a al tura, em pi xel s, do
cabeal ho do E3Browser. Este campo
equi val e propri edade FixedRowHeight
do E3Browser.
Largura da 1 coluna
Determi na a l argura da pri mei ra col una
na tabel a. Este campo equi val e
propri edade FixedColumnWidth do
E3Browser.
Altura das Linhas
Determi na a al tura das l i nhas restantes
na tabel a. Este campo equi val e
propri edade RowHeight do E3Browser.
Largura das Colunas
Determi na a l argura das col unas da
tabel a. Este campo equi val e
propri edade ColumnWidth do E3Browser.
396 E3Browser
18.2.2 Aba Opes
Na aba Opes, i nforme o i nterval o de tempo em que os dados sero gravados e
atual i zados no E3Browser. A atual i zao ocorrer em mi l i ssegundos (ms). Pode-se
escol her a opo de no atual i zar os dados, fazendo com que as gravaes
permaneam as mesmas. Na opo Tipo de seleo, ser i nformado qual o ti po de
sel eo ser fei ta na tabel a.
Aba Opes
Cada campo da aba Opes possui uma propri edade correspondente. As
OPO DESCRIO
Informe o intervalo de tempo em que os
dados sero atualizados
Determi na o i nterval o de tempo em que
os dados sero atual i zados. Este val or
deve ser superi or a 1000 ms. Este campo
equi val e propri edade RefreshTime do
E3Browser.
Informe qual ser o tipo de seleo
Determi na o ti po de sel eo na tabel a
do E3Browser. Este campo equi val e
propri edade SelectRow do E3Browser.
E3Browser 397
18.2.3 Aba Cores
A aba Cor determi na as cores do E3Browser, referentes s suas col unas e cl ul as.
Se a cor desejada no esti ver na pal eta de cores padro, necessri o confi gur-l a
cl i cando em Editar Cor Personalizada (Edit Custom Color), que abre a cai xa de
di l ogo de edi o da cor.
Aba Cor
Opes disponveis da aba Cor
OPO DESCRIO
Propriedades (Properties)
Determi na a cor conforme a propri edade
sel eci onada.
Conjunto de Cores (Color Set)
Determi na o conjunto de cores a ser
uti l i zado: Cores padro ou Cores do
Windows.
Paleta de Cores (Color Palette)
Determi na a cor da propri edade
sel eci onada.
Editar Cor Personalizada (Edit Custom Color)
Edi ta uma nova cor personal i zada,
di ferente das cores padro.
i di oma do E3.
398 E3Browser
18.2.4 Aba Fonte
Na aba Fonte, defi nem-se as especi fi caes de fontes no E3Browser.
Aba Fonte
i di oma do E3.
E3Chart 399
19
E3Chart
CAPTULO
O objeto E3Chart um componente Acti veX cri ado especi al mente para trabal har em
conjunto com o E3. Com el e, possvel exi bi r grfi cos mostrando Tags vari ando em
tempo real , bem como dados hi stri cos gravados em um Banco de Dados.
O E3Chart composto por vri as col ees. Uma col eo (collection) um objeto
especi al que gerenci a um conjunto de objetos semel hantes. O E3Chart possui as
segui ntes col ees:
Coleo de Penas: gerenci a o conjunto de Penas cri adas para mani pul ar a
sequnci a de dados representada no E3Chart
Coleo de Eixos: gerenci a os Ei xos do E3Chart, onde podem ser confi guradas
di ferentes escal as a serem associ adas aos dados das Penas
Coleo de Consultas: gerenci a as consul tas com i nformaes sobre as Penas
(por exempl o, no caso de grfi cos que mostram dados hi stri cos que j foram
gravados em um Banco de Dados)
Legenda: gerenci a as col unas da Legenda do E3Chart, onde so mostradas as
i nformaes sobre as Penas
Para uti l i zar os recursos do E3Chart, si ga estes procedi mentos:
1. Insi ra o E3Chart no projeto atravs do cl i que com o boto di rei to do mouse na
Tel a, e sel eci one o objeto E3Chart.
400 E3Chart
Inserindo um E3Chart na Tela
2. Caso seja necessri o, confi gure as propri edades do E3Chart. Al gumas das
Propri edades, sem a necessi dade da cri ao de scri pts para i sto. Caso
Propri edades e fazer os devi dos ajustes. Demai s i nformaes sobre as
funci onal i dades das propri edades deste objeto podem ser encontradas no
Manual de Referncia de Scripts, em seu captul o correspondente.
19.1 Configuraes
Para acessar as confi guraes do E3Chart, cl i que com o boto di rei to do mouse
sobre o objeto e sel eci one a opo Propriedades.
19.1.1 Abas Item, Posio e Geral
Atravs da aba Item, possvel vi sual i zar o nome do objeto e atri bui r-l he uma
descri o.
E3Chart 401
Aba Item
Cada campo da aba Item possui uma propri edade correspondente. As opes
di sponvei s so:
Opes disponveis na aba Item
OPO DESCRIO
Nome
Determi na o nome do objeto. Este campo
equi val e propri edade Name do E3Chart.
Documentao
Texto l i vre que possi bi l i ta a
documentao das funci onal i dades e
caractersti cas do objeto pel o
programador. Este campo equi val e
propri edade DocString do E3Chart.
A aba Posio determi na o posi ci onamento do E3Chart na Tel a.
402 E3Chart
Aba Posio
Cada campo da aba Posio possui uma propri edade correspondente. As opes
Opes disponveis na aba Posio
OPO DESCRIO
X
Defi ne a coordenada hori zontal
esquerda do objeto, em uni dades
hi mtri cas. Este campo equi val e
propri edade X do E3Chart.
Y
Defi ne a coordenada verti cal superi or do
objeto, em uni dades hi mtri cas. Este
campo equi val e propri edade Y do
E3Chart.
Largura
Determi na a l argura do objeto. Este
campo equi val e propri edade Width do
E3Chart.
Altura
Determi na a al tura do objeto. Este
campo equi val e propri edade Height do
E3Chart.
Atravs da aba Geral, possvel especi fi car o esti l o e a aparnci a do grfi co.
E3Chart 403
Aba Geral
OPO DESCRIO
Mostrar ttulo
Exi be o ttul o do grfi co. Este campo
equi val e propri edade Title do E3Chart.
Mostrar o fundo do grfico com a cor
Determi na a cor de fundo do grfi co. Este
campo equi val e propri edade BackColor
do E3Chart.
Mostrar o fundo da grade com a cor
Determi na a cor de fundo da grade do
grfi co. Este campo equi val e
propri edade GridBackColor do E3Chart.
Intervalo entre as atualizaes (segundos)
Determi na o i nterval o entre as
atual i zaes do desenho no grfi co. Este
RefreshTime do E3Chart.
19.1.2 Aba Eixos
O objeto Coleo de Eixos representa o conjunto de Ei xos conti dos no E3Chart. Os
Eixos so escal as col ocadas no contorno da grade do E3Chart.
Atravs da aba Eixos, possvel adi ci onar e remover Ei xos da Col eo de Ei xos, bem
como confi gurar suas propri edades i ndi vi dual mente.
404 E3Chart
Aba Eixos
Quando o E3Chart cri ado, doi s Ei xos pri nci pai s so cri ados automati camente:
Eixo Horizontal e Eixo Vertical. Estes so os Ei xos padro, e no podem ser
removi dos. Ao cl i car em Adicionar, cri ado um novo Ei xo no grfi co e aberta uma
janel a de confi gurao que permi te determi nar as propri edades do objeto Ei xo.
Esta janel a possui duas abas, Geral e Escala, e tambm pode ser acessada ao cl i car
em Configurar.
A aba Geral contm a i nformao que i denti fi ca a Pena no si stema.
E3Chart 405
Aba Geral
Cada campo da aba Geral possui uma propri edade ou mtodo correspondente. As
OPO DESCRIO
Nome
Determi na o nome do Ei xo do grfi co.
Name do Ei xo.
406 E3Chart
OPO DESCRIO
Posio
Determi na a posi o do Ei xo no grfi co:
Direita ou Esquerda (Ei xo verti cal ), Base ou
Topo (Ei xo hori zontal ). Este campo
equi val e propri edade Position do Ei xo.
Espelhar o eixo
Mostra o Ei xo tambm do l ado oposto ao
escol hi do, com efei to de espel ho. Este
campo equi val e propri edade Mirror do
Ei xo.
Ttulo do eixo
Determi na o ttul o do Ei xo. Este campo
equi val e propri edade Title do Ei xo.
Cor da escala
Determi na a cor da escal a. Este campo
corresponde propri edade Color do
objeto Ei xo.
Visvel
Determi na a vi si bi l i dade do Ei xo no
propri edade Visible do Ei xo.
Texto na cor da escala
Determi na se a cor do texto do Ei xo ter
a mesma cor da escal a. Este campo
equi val e propri edade EnableTextColor
do Ei xo.
Cor das linhas da grade
Determi na a cor das l i nhas na grade.
GridColor do Ei xo.
Estilo da linha
Determi na o esti l o da l i nha da grade do
propri edade GridStyle do Ei xo.
Mostrar as linhas na grade
Habi l i ta a vi sual i zao das l i nhas na
grade. Este campo equi val e
propri edade ShowGrid do Ei xo.
Intervalo entre divises
Determi na o i nterval o entre os
marcadores da escal a, caso a opo
Automtico esteja desabi l i tada. Se a
escal a no for numri ca, possvel
sel eci onar a uni dade de tempo a que
este i nterval o se refere. Este campo
equi val e ao mtodo SetTickSpacing do
Ei xo.
Automtico
Sel eci ona automati camente o i nterval o
entre os marcadores da escal a. Este
campo equi val e ao mtodo SetTickSpacing
do Ei xo, com 0 (zero) no val or do
i nterval o.
Nmero de subdivises
Determi na o nmero de subdi vi ses
entre os marcadores. Este campo
equi val e propri edade MinorTicks do
Ei xo.
Cl i que em Aplicar para vi sual i zar as modi fi caes fei tas nesta janel a, e em OK para
E3Chart 407
sal v-l as.
A aba Escala defi ne as confi guraes da escal a do Ei xo.
Aba Escala
Cada campo da aba Escala possui uma propri edade ou um mtodo correspondente.
408 E3Chart
Opes disponveis na aba Escala
OPO DESCRIO
Escala numrica
Defi ne o Ei xo como sendo uma escal a
numri ca. Este campo equi val e
propri edade ScaleType do Ei xo. As opes
de confi gurao da escal a numri ca so as
segui ntes:
Mnimo: Determi na o val or mni mo da
escal a numri ca. Este campo equi val e ao
mtodo SetMinMax do Ei xo
Mximo: Determi na o val or mxi mo da
escal a numri ca. Este campo equi val e ao
mtodo SetMinMax do Ei xo
Mostrar ltimo perodo (tempo real)
Mostra o i nterval o de tempo que o Ei xo i r
mostrar, sempre em rel ao hora atual .
Este campo equi val e ao mtodo
SetRealTimePeriod do Ei xo.
Intervalo de tempo (histrico)
Determi na um i nterval o de tempo fi xo. As
opes de confi gurao so as segui ntes:
Do dia: Data e hora i ni ci ai s do i nterval o
At o dia: Data e hora fi nai s do i nterval o
Selecionar: Sel eci ona o i nterval o de
tempo
Este campo corresponde ao mtodo
SetHistoricPeriod do Ei xo.
Inverter Escala
I nverte os val ores da escal a sel eci onada.
Formatao
Determi na a formatao dos val ores do
Ei xo, que pode ser automti ca ou
personal i zada. Este campo corresponde
propri edade Format do Ei xo.
Cl i que em Aplicar para vi sual i zar as modi fi caes fei tas nesta janel a, e em OK para
sal v-l as.
19.1.3 Aba Penas
O objeto Coleo de Penas representa o conjunto de Penas conti das no E3Chart.
Cada Pena confi gurada para exi bi r dados em tempo real ou dados hi stri cos
vi ndos da Consul ta.
Atravs da aba Penas, possvel adi ci onar e remover Penas da Col eo de Penas,
bem como confi gurar suas propri edades pri nci pai s, i ndi vi dual mente ou atravs da
ml ti pl a sel eo de Penas.
E3Chart 409
Aba Penas
Opes disponveis na aba Penas
OPO DESCRIO
Adi ci ona uma Pena. Mostra um menu
que permi te escol her o ti po de Pena
que ser cri ada: Tempo Real, Histrica ou
Tempo Real & Histrica.
Remove as Penas sel eci onadas.
Abre a janel a de propri edades da Pena
sel eci onada (essa operao s
permi ti da se apenas uma Pena esti ver
sel eci onada).
Move a Pena sel eci onada uma posi o
para ci ma (essa operao s
sel eci onada).
Move a Pena sel eci onada uma posi o
para bai xo (essa operao s
sel eci onada).
A l i stagem de Penas do E3Chart permi te copi ar e col ar Penas, tanto no mesmo
410 E3Chart
E3Chart quanto entre E3Charts di ferentes. Basta cl i car com o boto di rei to do
mouse na Pena desejada (ou nas Penas sel eci onadas, em caso de ml ti pl a sel eo)
e sel eci onar a opo Copiar (CTRL + C). No E3Chart de desti no, basta abri r a janel a
de Propri edades e, na aba Penas, cl i car com o boto di rei to do mouse na l i stagem
de Penas e sel eci onar a opo Colar (CTRL + V). A opo de Recortar a Pena (CTRL +
X) tambm est presente. No caso de o E3Chart de desti no j possui r uma Pena com
o mesmo nome da Pena sendo copi ada, o nome automati camente i ncrementado.
Al gumas propri edades da Pena podem ser confi guradas di retamente na l i sta
mostrada na aba Penas. Na col una Estilo, ao cl i car em , a segui nte janel a ser
mostrada.
Estilo da Pena
Opes disponveis na janela Estilo da Pena
OPO DESCRIO
Cor principal
Defi ne a cor da l i nha da Pena. Equi val e
propri edade Color.
Cor do fundo
Defi ne a cor de fundo usada em uma
Pena do ti po rea. Equi val e
propri edade BkColor.
Tipo de desenho
Defi ne o ti po de desenho da Pena:
Linhas, Pontos, Linhas e Pontos ou rea.
Equi val e propri edade PenType.
E3Chart 411
OPO DESCRIO
Estilo do trao
Defi ne o ti po de l i nha: Slida, Tracejada,
Pontilhada, Trao-Ponto, Trao-Ponto-Ponto
ou Sem Linha. Equi val e propri edade
PenStyle.
Espessura da linha
Defi ne a espessura da l i nha. Equi val e
propri edade Width.
Amostra
Mostra um exempl o de como a Pena ser
desenhada no E3Chart.
Ao sel eci onar uma Pena e cl i car em , a janel a de Propri edades da Pena
mostrada. El a possui ci nco abas: Geral, Dados, Estilo, Modo de Ligao e Estatsticas.
A aba Geral contm as i nformaes que i denti fi cam a Pena no si stema.
412 E3Chart
Aba Geral
OPO DESCRIO
Nome da Pena
I ndi ca o nome da Pena. Este campo
equi val e propri edade Name da Pena.
Cor principal
Determi na a cor da l i nha da Pena. Este
campo equi val e propri edade Color da
Pena.
E3Chart 413
OPO DESCRIO
Visvel
I ndi ca o estado de vi si bi l i dade da Pena
no grfi co. Este campo equi val e
propri edade Visible da Pena.
Unidade de Engenharia
I ndi ca a uni dade de engenhari a
uti l i zada pel a Pena. Este campo equi val e
propri edade EU da Pena.
A aba Dados contm i nformaes de acordo com o ti po da Pena.
Aba Dados
414 E3Chart
Cada campo da aba Dados possui uma propri edade correspondente. As opes
Opes disponveis na aba Dados
OPO DESCRIO
Tipo de pena
Determi na o ti po de Pena sendo
uti l i zada. Este campo equi val e
propri edade DataSourceType da Pena.
Link do eixo vertical
Nome da Associ ao usada para pl otar o
dado em uma escal a verti cal . Este campo
equi val e propri edade YLink da Pena.
Link do eixo horizontal
Nome da Associ ao usada para pl otar o
dado em uma escal a hori zontal . Este
campo equi val e propri edade XLink da
Pena.
Nmero de amostras mantidas na memria
Determi na o nmero de amostras nas
Penas de tempo real . Este campo
equi val e propri edade BufferSize da
Pena.
Usar a estampa de tempo
Habi l i ta ou desabi l i ta a estampa de
tempo. A estampa de tempo o val or de
tempo que acompanha o val or do Tag,
i ndi cando o momento em que este val or
foi al terado. Este campo equi val e
propri edade UseTimeStamp da Pena. Se
este campo esti ver habi l i tado, a opo
Link do Eixo Horizontal fi ca i nati va.
Consulta local
Determi na a Consul ta vi ncul ada ao
E3Chart que ser uti l i zada nos dados do
Ei xo. Este campo equi val e propri edade
QueryName da Pena.
Consulta externa
Determi na a consul ta externa, i sto , os
dados vi ro de uma consul ta fora do
objeto E3Chart.
Campo do eixo vertical
Nome do campo da Consul ta usado para
pl otar o dado em uma escal a verti cal .
YField da Pena.
Campo do eixo horizontal
Nome do campo da Consul ta usado para
pl otar o dado em uma escal a hori zontal .
XField da Pena.
Usar consulta automtica
I ndi ca se a Pena deve ou no usar
consul ta automti ca. A consul ta
automti ca no ser uti l i zada se o
E3Chart esti ver uti l i zando um cdi go SQL
personal i zado, se esti ver usando o
Storage, ou se possui r vri as tabel as.
AutoQuery da Pena.
E3Chart 415
OPO DESCRIO
Eixo vertical
Especi fi ca o Ei xo verti cal . Este campo
equi val e propri edade ScaleY da Pena.
Eixo horizontal
Especi fi ca o Ei xo hori zontal . Este campo
equi val e propri edade ScaleX da Pena.
A aba Estilo determi na o esti l o da Pena.
Aba Estilo
Cada campo da aba Estilo possui uma propri edade correspondente. As opes
416 E3Chart
Opes disponveis na aba Estilo
OPO DESCRIO
Tipo de desenho
I ndi ca o ti po de desenho da Pena. Este
campo equi val e propri edade PenType
da Pena.
Estilo do trao
Determi na o esti l o do trao da Pena. Este
campo equi val e propri edade PenStyle
da Pena.
Espessura da linha
Determi na a espessura da l i nha, em
pi xel s. Este campo equi val e
propri edade Width da Pena.
Cor do fundo
Determi na a cor de fundo da l i nha. Este
campo equi val e propri edade BkColor da
Pena.
Documentao
Determi na a documentao que pode ser
mostrada na Legenda. Este campo
equi val e propri edade DocString da
Pena.
Habilita alarme alto
Habi l i ta a veri fi cao do al arme al to.
Este campo corresponde propri edade
EnableHighLimit da Pena. A cai xa de texto
ao l ado possi bi l i ta estabel ecer o l i mi te
deste al arme, equi val e propri edade
HighLimit.
Habilita alarme baixo
Habi l i ta a veri fi cao do al arme bai xo.
EnableLowLimit da Pena. A cai xa de texto
ao l ado possi bi l i ta estabel ecer o l i mi te
deste al arme, equi val e propri edade
LowLimit.
Cor de alarme
Cor da Pena quando em al arme. Este
LimitPenColor.
Cor de fundo do alarme
Cor do fundo da Pena quando em al arme.
LimitPenBkColor.
A aparnci a da Pena, conforme a opo confi gurada, pode ser vi sual i zada a segui r.
E3Chart 417
Modo analgico de ligao entre os pontos
Modo digital de ligao entre os pontos
O modo como a Pena apresentada quando o scan considerado
representado pela cor verde e quando este campo est desabilitado
representado pelas cores azul e rosa
A aba Modo de Ligao determi na o esti l o da l i gao entre a parte hi stri ca e a
parte de tempo real de uma Pena mi sta.
418 E3Chart
Aba Modo de Ligao
As opes di sponvei s nesta aba so l i stadas na tabel a a segui r.
E3Chart 419
Opes disponveis na aba Modo de Ligao
OPO DESCRIO
Modo de ligao entre os pontos
Defi ne o modo como os pontos entre a
parte hi stri ca e a parte de tempo real
sero l i gados. Este campo equi val e
propri edade DigitalData. As opes
possvei s so Digital, onde o traado
sempre baseado em retas somente
hori zontai s e verti cai s, sugeri ndo
vari ao i nstantnea, e Analgico, onde o
traado busca uma reta uni ndo cada um
dos pontos do grfi co.
Valor considerado para o scan (ms)
Defi ne o tempo de l ei tura esperado do
Tag da Pena de tempo real . Este campo
equi val e propri edade ScanValue da
Pena.
Mostrar os pontos de qualidade ruim
Defi ne se i r mostrar ou no os pontos
de qual i dade rui m. Equi val e
propri edade ShowBadPoints da Pena.
Intervalo mximo para ligar os dados
histricos aos de tempo real (s)
Especi fi ca um tempo l i mi te a ser
consi derado para a conexo vi sual entre
a parte hi stri ca e a parte de tempo real
de uma Pena mi sta. Corresponde
propri edade MaxGapTime.
Realar linha quando MaxGapTime usado
Real a a l i nha de l i gao entre a parte
hi stri ca e a parte de tempo real .
Corresponde propri edade
HighlightMaxGapTime da Pena.
Cor da linha usada com MaxGapTime
Especi fi ca a cor da l i gao. Corresponde
propri edade MaxGapTimeColor da Pena.
Estilo da linha usada com MaxGapTime
Especi fi ca o esti l o da l i nha de l i gao.
Corresponde propri edade
MaxGapTimeStyle da Pena.
A aba Estatsticas habi l i ta o cl cul o de dados estatsti cos.
420 E3Chart
Aba Estatsticas
Cada campo da aba Estatsticas possui uma propri edade correspondente. As opes
Opes disponveis na aba Estatsticas
OPO DESCRIO
Calcular dados estatsticos
Habi l i ta o cl cul o de dados estatsti cos.
Mostrar linha da mdia
Exi be a l i nha da mdi a dos dados
estatsti cos.
Mostrar mnimo e mximo
Exi be o mni mo e o mxi mo dos dados
estatsti cos.
E3Chart 421
19.1.4 Aba Legenda
A Legenda uti l i zada para exi bi r as Penas vi svei s no grfi co e i nformaes sobre
el as, tai s como cor, nome da Pena, estado, etc.
Objeto Legenda em tempo de execuo
Atravs da aba Legenda, possvel confi gurar as i nformaes referentes ao objeto
Legenda e suas col unas.
422 E3Chart
Propriedades do objeto Legenda
Al guns campos da aba Legenda possuem uma propri edade ou mtodo
correspondente. As opes di sponvei s so as segui ntes:
Opes disponveis na aba Legenda
OPO DESCRIO
Mostrar Legenda
Habi l i ta a vi sual i zao da Legenda. A
cai xa de sel eo ao l ado deste campo
defi ne o posi ci onamento da Legenda.
Visible da Legenda, e o campo de sel eo
da posi o da Legenda equi val e
propri edade LegendPos da Legenda.
Tamanho
Determi na o tamanho da Legenda, em
pi xel s. Pode ser a al tura ou a l argura,
dependendo da posi o. A outra
di menso acompanha a do E3Chart. Este
campo corresponde propri edade Size
da Legenda.
Cor do fundo
Determi na a cor de fundo da Legenda.
BackColor da Legenda.
Colunas disponveis
Li sta as col unas di sponvei s para
vi sual i zao na Legenda.
Colunas selecionadas
Mostra as col unas sel eci onadas para a
Legenda.
E3Chart 423
OPO DESCRIO
Adicionar
Adi ci ona uma col una Legenda. Este
boto equi val e ao mtodo InsertColumn
da Legenda.
Propriedades
Abre uma cai xa de di l ogo para a
confi gurao das propri edades dos
campos das col unas da Legenda.
Remover
Remove a col una sel eci onada da
Legenda. Este boto equi val e ao mtodo
RemoveColumn da Legenda.
Sobe e Desce
Troca a posi o da col una na Legenda.
Estes botes equi val em ao mtodo
ChangeColumnPos da Legenda.
Mostrar ttulos das colunas
Habi l i ta o cabeal ho da Legenda. Este
ShowHeader da Legenda.
Mostrar texto na cor da pena
Determi na se a cor do texto da Legenda
ser a mesma da Pena. Este campo
equi val e propri edade EnableTextColor
da Legenda.
Os campos da l i stagem Colunas disponveis so os segui ntes:
Opes disponveis para identificao de colunas
1
Este valor pode ser usado diretamente nos mtodos InsertColumn (parmetro Col), Item e
RemoveColumn
OPO
VALOR
1
NOME DESCRIO
Cor da Pena 6 Color
Mostra a cor da
Pena.
Descrio da Pena 5 Description
Mostra a descri o
conti da na
propri edade
DocString da Pena.
DifX 15 DiffX
Mostra a di ferena
entre os cursores
i ni ci al e fi nal .
DifY 16 DiffY
Mostra a di ferena
no Ei xo Y entre os
pontos i nterpol ados
i ni ci al e fi nal .
EscalaX 8 ScaleX
Mostra o nome do
Ei xo X associ ado
Pena.
EscalaY 9 ScaleY
Mostra o nome do
Ei xo Y associ ado
Pena.
424 E3Chart
OPO
VALOR
1
NOME DESCRIO
Estado 7 Status
Mostra o estado de
funci onamento
atual da Pena.
FimX 14 XEnd
Mostra a posi o
fi nal do cursor.
FimY 18 YEnd
Mostra o ponto
i nterpol ado onde o
cursor fi nal cruza
com a Pena.
IncioX 13 XBegin
Mostra a posi o
i ni ci al do cursor.
IncioY 17 YBegin
Mostra o ponto
i nterpol ado onde o
cursor i ni ci al cruza
com a Pena.
MximoY 12 MaxY
Mostra o val or
mxi mo da Pena no
i nterval o.
MdiaY 10 AverageY
Mostra o val or
mdi o da Pena no
i nterval o.
MnimoY 11 MinY
Mostra o val or
mni mo da Pena no
i nterval o.
Nome da pena 0 Name
Mostra o nome da
Pena.
Nome do tag X 1 TagX
Mostra o nome do
Tag associ ado ao
Ei xo X.
Nome do tag Y 2 TagY
Mostra o nome do
Tag associ ado ao
Ei xo Y.
Unidade 19 EU
Mostra a uni dade
de engenhari a
uti l i zada pel a Pena.
Valor do tag X 3 TagXValue
Mostra o val or da
pesqui sa no Ei xo X.
Valor do tag Y 4 TagYValue
Mostra o val or da
pesqui sa no Ei xo Y.
Ao cl i car em Propriedades, mostrada uma cai xa de di l ogo para confi gurao do
objeto Col una da Legenda.
E3Chart 425
Propriedades da coluna
Cada campo da cai xa de di l ogo Propri edades da col una possui uma propri edade
correspondente. As opes di sponvei s so as segui ntes:
Opes disponveis na janela Propriedades da coluna
OPO DESCRIO
Largura inicial
Defi ne a l argura i ni ci al da Col una, em
pi xel s. Este campo equi val e
propri edade Width da Col una da
Legenda.
Ttulo da coluna
Determi na o ttul o da Col una. Este campo
equi val e propri edade Caption da
Col una da Legenda.
Alinhamento do texto
Determi na o al i nhamento do texto na
Col una da Legenda, Este campo equi val e
propri edade TextAlign da Col una da
Legenda.
Formatador
Determi na o formatador da Col una
sel eci onada. Este campo equi val e
propri edade Format da Col una da
Legenda.
19.1.5 Aba Consultas
As Consultas so necessri as para mostrar val ores hi stri cos no E3Chart. Atravs
da aba Consultas possvel adi ci onar ou remover Consul tas, bem como confi gur-
l as.
426 E3Chart
Aba Consultas
Opes disponveis na aba Consultas
OPO DESCRIO
Consultas
Mostra a Consul ta sel eci onada para
edi o.
Configurar
Confi gura a Consul ta sel eci onada.
Adicionar
Adi ci ona uma nova Consul ta. Para obter
mai ores i nformaes referentes s
Consul tas, veja o captul o Consultas.
Remover
Remove a Consul ta sel eci onada.
NOTA: Ao cl i car em Adicionar ou Configurar, uma cai xa de di l ogo aberta para
especi fi cao do Servi dor de Banco de Dados que guarda a Consul ta. Os
procedi mentos de defi ni o da Consul ta podem ser encontrados no captul o
Consultas.
19.1.6 Aba Fonte
Atravs da aba Fonte, possvel confi gurar a fonte do cabeal ho e das l i nhas do
E3Chart.
E3Chart 427
Aba Fonte
NOTA: o nome da aba aparece sempre no i di oma do Wi ndows.
19.2 Exemplos de Utilizao
A segui r sero mostrados al guns exempl os de uti l i zao do E3Chart.
19.2.1 Habilitando e Desabilitando Penas
O exempl o a segui r demonstra como habi l i tar ou desabi l i tar a conexo dos dados
de uma Pena no E3Chart. Para tanto, si ga estes procedi mentos:
1. Cri e um E3Chart na Tel a.
2. Acesse as propri edades do E3Chart e sel eci one a aba Penas. Cri e uma nova
Pena de tempo real e associ e-a a um Tag Demo no Ei xo verti cal .
3. Cri e doi s botes de comando na Tel a. No pri mei ro boto de comando, escreva
na propri edade Caption a descri o "Desabi l i tar Pena".
4. Acesse as propri edades deste boto e sel eci one a aba Scripts. No evento Click
do boto de comando, escreva o segui nte scri pt:
Set Pen1= Screen.Item("E3Chart1").Pens.Item("Pena1")
428 E3Chart
Pen1.Disconnect()
End Sub
5. No segundo boto de comando, escreva na propri edade Caption a descri o
"Habi l i tar Pena".
Pen1.Connect()
End Sub
7. Execute o projeto e veja o resul tado.
19.2.2 Atualizando o E3Chart Histrico com os
Dados da ltima Hora
O exempl o a segui r demonstra como atual i zar o E3Chart com os dados hi stri cos
da l ti ma hora. Para este exempl o, necessri o que voc tenha uma Consul ta a
uma tabel a do Banco de Dados previ amente cri ada.
2. Acesse as propri edades do E3Chart e sel eci one a aba Eixos. Cl i que na opo
Configurar do Ei xo hori zontal e na aba Escala, sel eci one a opo Intervalo de
tempo (Histrico).
3. Acesse a aba Consultas e cl i que em Adicionar. O si stema mostrar uma cai xa de
di l ogo para que se i ndi que o nome do servi dor de Banco de Dados em que a
tabel a da consul ta est armazenada.
4. Sel eci one o servi dor de Banco de Dados na cai xa de di l ogo e cl i que em OK. O
si stema abri r as confi guraes da Consul ta.
5. Sel eci one na tabel a hi stri ca, o campo E3TimeStamp e al gum campo de dados
que se deseja mostrar no grfi co.
6. No campo E3TimeStamp, cri e um fi l tro conforme as especi fi caes a segui r.
E3Chart 429
Filtro a ser criado no campo E3TimeStamp
7. Aps ter cri ado o fi l tro conforme especi fi caes aci ma, cl i que em OK.
8. Cri e uma nova Pena. Acesse as propri edades desta Pena e na aba Dados, i tem
Tipo de Pena, sel eci one a opo Histrica usando a Consul ta e i ndi que o campo
da Consul ta confi gurada.
9. No i tem Campo do eixo vertical, i ndi que um campo da tabel a. No i tem Campo
do eixo horizontal, i ndi que o campo E3TimeStamp. Cl i que em OK.
10. Cri e um novo boto na Tel a e na propri edade Caption, escreva "Atual i zar
E3Chart Hi stri co".
11. Acesse os scri pts deste boto e no evento Click, escreva o segui nte cdi go:
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
430 E3Chart
19.2.3 Habilitando ou Desabilitando a Visualizao
da Pena
O exempl o a segui r demonstra como habi l i tar ou desabi l i tar a vi sual i zao de uma
Pena no E3Chart. Para tanto, si ga estes procedi mentos:
2. Acesse as propri edades do E3Chart e sel eci one a aba Penas. Cri e uma nova
Pena de tempo real e associ e-a a um Tag Demo, no Ei xo verti cal .
3. Cri e doi s botes na Tel a. No pri mei ro, mude a propri edade Caption para
"Desabi l i tar Vi sual i zao da Pena".
Pen1.Visible = False
End Sub
5. No segundo boto de comando, mude a propri edade Caption para "Habi l i tar
Vi sual i zao da Pena".
do boto de comando escreva o segui nte scri pt:
Set Pen1 = Screen.Item("E3Chart1").Pens.Item("Pena1")
Pen1.Visible = True
End Sub
19.2.4 Criao de uma Pena por Script
O exempl o a segui r demonstra como cri ar uma Pena por scri pt. Para tanto, si ga
2. Cri e um boto de comando da Tel a. Na propri edade Caption, di gi te o texto
"Cri ar Pena".
3. Acesse as propri edades deste boto de comando e sel eci one a aba Scripts.
Di gi te o scri pt a segui r no evento Click.
Sub Texto1_Click()
Set E3Chart1 = Screen.Item("E3Chart1")
MsgBox "Clique OK para criar a Pena"
Set Pen = E3Chart1.Pens.AddPen("Pen1")
E3Chart 431
Pen.DataSourceType = 0 ' Tempo real
Pen.VerDataSource = "Dados.TagDemo1"
Pen.UseTimeStamp = True ' No X usa o timestamp
Pen.Color = RGB(255, 0, 0)
Pen.DocString = "teste"
MsgBox "Clique OK para conectar"
Pen.Connect() ' Comea a receber os dados
MsgBox "Clique OK para enquadrar"
E3Chart1.FitPen(0)
MsgBox "Clique OK para desconectar"
Pen.Disconnect() ' Para de receber os dados
MsgBox "Clique OK para remover a Pena"
E3Chart1.Pens.Remove(Pen.Name)
End Sub
19.3 Caractersticas Especficas de Runtime
O E3Chart possui uma sri e de caractersti cas que se apl i cam apenas em tempo de
execuo. Essas caractersti cas sero expl i cadas nas prxi mas sees.
19.3.1 Opes do Ponteiro do Mouse
Cl i cando na l egenda do grfi co, possvel redi mensi onar suas col unas. Para tanto,
basta sel eci onar a col una desejada e arrast-l a.
19.3.2 Opes do Menu Contextual
Cl i cando com o boto di rei to do mouse sobre o grfi co do E3Chart, aberto um
menu de opes.
432 E3Chart
Opes do menu do E3Chart em tempo de
execuo
Opes disponveis do menu contextual do E3Chart em tempo de execuo
OPO DESCRIO
Caixa de zoom
Col oca o mouse no modo zoom por rea
sel eci onada. Esta opo est di sponvel
nos grfi cos de escal a numri ca em XY e
escal a fi xa.
Mover
Col oca o mouse em modo de
movi mentao das escal as.
Mover horizontalmente
Col oca o mouse em modo de
movi mentao das escal as somente na
di reo hori zontal .
Pesquisar
Col oca o mouse em modo de pesqui sa
de val ores nos dados das Penas.
Pesquisar Intervalos
Habi l i ta a opo de pesqui sa de
i nterval os de tempo.
Menos Zoom
Di mi nui o zoom de todo o Ei xo.
Mais Zoom
Aumenta o zoom de todo o Ei xo.
Enquadrar tudo
Enquadra a Pena sel eci onada em ambos
os Ei xos.
Enquadrar verticalmente
Enquadra a Pena sel eci onada somente
no Ei xo verti cal .
Enquadrar horizontalmente
Enquadra a Pena sel eci onada somente
no Ei xo hori zontal .
Enquadrar Pena
Enquadra a Pena sel eci onada ou todas
as Penas exi stentes.
E3Chart 433
19.3.3 Opo Pesquisar
Esta opo permi te pesqui sar val ores dos pontos das Penas. O val or mostrado na
l egenda, atravs das col unas Valor do Tag X e Valor do Tag Y.
A pesquisa mostrada nos campos Valor do TagX e Valor do TagY
NOTA: Para obter mai ores i nformaes sobre as col unas Valor do Tag X e Valor do Tag
Y, veja o tpi co Configuraes da Legenda.
19.3.4 Opo Pesquisar Intervalos
Neste modo so mostrados doi s cursores, que defi nem o i nterval o de cl cul os
estatsti cos. Os val ores dos cursores so mostrados nas col unas IncioX, IncioY,
FimX e FimY. Para al terar a posi o de um cursor, basta sel eci on-l o, cl i cando com
o boto esquerdo do mouse, e arrast-l o para a posi o desejada.
434 E3Chart
Pesquisa de intervalos
19.3.5 Coluna Estado da Legenda
A col una Estado da legenda mostra o estado atual de cada Pena. O contedo desta
mensagem composto por uma i nformao de erro, se houver, e i nformaes sobre
a si tuao atual da Pena, como por exempl o o nmero de pontos. As tabel as a
segui r mostram as possvei s mensagens de erro e de i nformao para Penas de
Tempo Real e Hi stri cas. Se a Pena do ti po Mi sta, a mensagem fi nal ser uma
combi nao da mensagem da parte de Tempo Real e Hi stri ca. Caso haja
mensagens de erro, a l i nha da col una ser mostrada em vermel ho enquanto o erro
persi sti r.
Mensagens de status da parte de tempo real
MENSAGEM SIGNIFICADO
Erro: Parte de tempo real desconectada
(YLink='Nome do Tag') (XLink='Nome do
Tag')
No houve conexo da parte de tempo
real da Pena. Veri fi que o nome dos Tags
nas propri edades YLink e XLink da Pena.
Info: Tempo real n pts
Mostra o nmero total de pontos da
parte de tempo real .
E3Chart 435
Mensagens de status da parte histrica
Info: Consulta aguardando
Aguardando a i ni ci al i zao da consul ta.
Si gni fi ca que al guma mudana ou
pedi do de atual i zao da consul ta foi
detectado.
Info: Consulta inicializando
A consul ta est i ni ci ando. Nesta fase
so val i dados os campos i nformados na
Pena.
Erro: Consulta: Falha na inicializao
Antes de carregar os dados da consul ta,
o E3Chart preci sa conhecer os campos
que a consul ta contm para real i zar a
associ ao entre estes campos e as
propri edades XField e YField. Ocorreu uma
fal ha ao buscar estes campos, que pode
ser tanto um erro de rede quanto um erro
de si ntaxe SQL.
Erro: Campo no encontrado (XField = 'Nome
do Campo')
O campo i nformado na propri edade
XField no foi encontrado na consul ta.
Veri fi que se o campo est sel eci onado
na tel a de edi o da consul ta ou no
cdi go SQL.
Erro: Campo no encontrado (YField = 'Nome
do Campo')
O campo i nformado na propri edade
YField no foi encontrado na consul ta.
Veri fi que se o campo est sel eci onado
na tel a de edi o da consul ta ou no
cdi go SQL.
Erro: 'Nome da Consulta' 'Mensagem de Erro'
I ndi ca que houve um erro na consul ta,
no sendo possvel recuperar os dados.
As possvei s mensagens mostradas em
Mensagem de Erro so descri tas na tabel a
a segui r.
Info: n pts
Mostra o nmero total de pontos da
parte hi stri ca.
Info: Carregando
I ndi ca que os dados da consul ta ai nda
esto sendo carregados do servi dor.
Erro: Consulta invlida (QueryName = 'Nome
da Consulta')
A consul ta i ndi cada pel a propri edade
QueryName da Pena no foi encontrada
pel o E3Chart.
Mensagens especficas para falha na consulta
Falha ao inserir dados
No foi possvel carregar os dados para a
memri a.
Falha na criao da consulta
No foi possvel cri ar a consul ta.
436 E3Chart
Erro ao executar a consulta
No foi possvel executar a consul ta.
Falha ao baixar os dados do servidor
No foi possvel trazer do servi dor os
resul tados da consul ta.
Falha ao pegar o nmero de registros do
servidor
No foi possvel trazer do servi dor o total
de regi stros exi stentes na consul ta.
Falha ao posicionar o cursor para o incio
No foi possvel posi ci onar o cursor no
pri mei ro regi stro da consul ta.
Cursor ocupado
Os regi stros da consul ta no esto
di sponvei s para serem trazi dos do
servi dor.
Falha ao pegar os dados do servidor
No foi possvel trazer do servi dor os
regi stros da consul ta.
Erro desconhecido
Houve um erro i nesperado ao tentar
trazer do servi dor os dados da consul ta.
E3Playback 437
20
E3Playback
CAPTULO
Uma ferramenta de playback vi sa faci l i tar o ps-operao, sobretudo a anl i se de
ocorrnci as. Sua necessi dade justi fi cada por permi ti r que o usuri o vi sual i ze,
atravs das tel as de moni torao em tempo real , as vari aes de eventos e pontos
anal gi cos em tempo passado, o qu, em determi nados casos, pode ser compl i cado
observando apenas rel atri os de eventos e val ores anal gi cos.
Cabe ressal tar que um playback uma ferramenta que permi te a um operador
experi ente e conhecedor do processo i nterpretar os aconteci mentos de forma mai s
cl ara. No faz parte do escopo de um playback a i denti fi cao automti ca de
sol uo ou de causa de uma ocorrnci a.
Um exempl o prti co de uso de um playback pode ser o segui nte:
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 apertando a
tecla 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 El i pse, um Acti veX que roda dentro do
E3 Vi ewer ou do E3WebVi ewer e que permi te vi sual i zar as Tel as do apl i cati vo
uti l i zando dados hi stri cos armazenados em bancos de dados.
O E3Pl ayback busca no banco de dados os Tags referenci ados nas Tel as, bem como
os demai s links entre Vi ewer e servi dor (tai s como os Tags do Vi ewer com links para
objetos do servi dor), e mostra val ores, ani maes, estados e grfi cos de acordo
com as i nformaes exi stentes no banco de dados e o perodo de playback defi ni do.
20.2 Adicionar Playback ao Demo do E3
Este exempl o mostra como adi ci onar funci onal i dades de playback ao apl i cati vo de
demonstrao que vem junto com a i nstal ao do E3.
1. Cri e uma nova Tel a chamada TelaPlayback e i nsi ra o Acti veX E3Pl ayback
ocupando toda a rea de fundo da Tel a.
438 E3Playback
Incluso do E3Playback em uma Tela
2. Acesse a Li sta de Propri edades e confi gure a propri edade DBServer do
E3Pl ayback, fazendo-a apontar para o objeto Banco de Dados que contm os
dados hi stri cos do apl i cati vo.
Selecionando um Banco de Dados
3. Acesse a Li sta de Propri edades e confi gure a propri edade InitialScreen do
E3Pl ayback, fazendo-a apontar para o Quadro FrameApp.
E3Playback 439
Selecionando um Quadro para a propriedade InitialScreen
4. Abra a Tel a UpperMenu e i nsi ra a i magem Stopwatch no canto superi or di rei to
(abra a Gal eri a e sel eci one a categori a Misc Symbols 1).
Tela UpperMenu
5. D um dupl o-cl i que no Stopwatch, adi ci one o Pi ck Abrir Tela no evento Click,
para abri r a TelaPlayback no Quadro pri nci pal e confi gure-o conforme as
fi guras a segui r.
440 E3Playback
Pick Abrir Tela
E3Playback 441
Configuraes do estilo da janela
6. Rode o apl i cati vo, abra o Vi ewer, cl i que em Portugus, depoi s em Preview de
Aplicaes, e fi nal mente cl i que sobre o cone Stopwatch. Neste momento deve
aparecer a Tel a de playback.
442 E3Playback
Tela de playback
7. Cl i que em para entrar no modo Online. Os pri mei ros dados de playback
sero carregados, e o rel gi o de playback ser posi ci onado no centro dos
dados di sponvei s.
E3Playback 443
Tela de playback em modo Online
20.3 Interface de Usurio
A i nterface de usuri o do E3Pl ayback di vi di da em sei s partes:
Barra de Ferramentas
Linha de Tempo
Marcadores
rea de Telas
Lista de Eventos
Lista de Tags
20.3.1 Barra de Ferramentas
A Barra de Ferramentas rene os pri nci pai s comandos para operao do
E3Pl ayback.
Barra de ferramentas de playback
444 E3Playback
Possui as segui ntes opes:
Opes disponveis na Barra de Ferramentas Playback
CONE COMANDO AO
Reproduzi r (para trs) I ni ci a a reproduo
dos dados no horri o
atual de playback,
retrocedendo o rel gi o
de acordo com a
vel oci dade de
reproduo atual .
Pausa Congel a o rel gi o de
playback no tempo
atual .
Reproduzi r I ni ci a a reproduo
dos dados no horri o
atual de playback,
avanando o rel gi o
de acordo com a
vel oci dade de
reproduo atual .
Parar I nterrompe o playback,
os dados de Tags e
al armes so
removi dos das Tel as e
nenhuma nova
consul ta fei ta ao
banco de dados.
Mai s Devagar Di mi nui a vel oci dade
de playback pel a
metade. O val or
mni mo 1/1024x, i sto
, avana
aproxi madamente um
mi l i ssegundo de
dados a cada segundo.
Vel oci dade Normal Dei xa a vel oci dade de
playback no val or
normal (1x).
Mai s Rpi do Dobra a vel oci dade de
playback. O val or
mxi mo de 1024x,
i sto , a cada segundo
o rel gi o de playback
avana 1024 segundos
(aproxi madamente 17
mi nutos).
Sel etor de Vel oci dade Permi te sel eci onar a
vel oci dade de playback.
E3Playback 445
CONE COMANDO AO
Data e Hora Atual Mostra a data e hora
atual do rel gi o de
playback, e permi te
sel eci onar uma nova
data.
Mostrar ou esconder a
Li nha de Tempo
Mostra ou ocul ta a
janel a Li nha de Tempo
do E3Pl ayback.
Li sta de Tags
Mostra ou ocul ta a
janel a Tags do
E3Pl ayback.
Li sta de Eventos
Mostra ou ocul ta a
janel a Eventos do
E3Pl ayback.
I ni ci ar ou parar a
gravao de vdeo
Permi te gerar um vdeo
(em formato AVI )
capturando toda a
rea do Acti veX de
playback durante um
determi nado perodo,
ou at que o usuri o
mande parar a
gravao.
Capturar a tel a do
E3Pl ayback
Permi te capturar a
rea de Tel a do Acti veX
de playback. A Tel a
capturada pode ser
sal va em um arqui vo
BMP ou col ocada na
rea de Transfernci a
do Wi ndows.
Ao sel eci onar a ferramenta Gravao de Vdeo , a segui nte janel a de
confi guraes mostrada.
446 E3Playback
Janela Opes de gravao
Opes disponveis na janela Opes de gravao
OPO DESCRIO
Salvar vdeo como
Mostra o l ocal e o nome do arqui vo de
vdeo que ser sal vo. Pode-se cl i car em
para navegar pel as pastas do
computador.
Tempo mximo de gravao
Permi te defi ni r um tempo total para
gravao. Se o val or esti ver em Indefinido,
a gravao apenas para se o boto de
gravao de vdeo do E3Pl ayback for
pressi onado. A opo Tempo permi te que
seja pr-defi ni do um tempo mxi mo de
gravao, em segundos (neste caso a
gravao encerrada automati camente
ao fi nal do tempo esti pul ado).
E3Playback 447
OPO DESCRIO
Quadros por segundo
Confi gura o nmero de quadros (frames)
capturados a cada segundo de gravao.
Mostrar cursor na gravao
Quando esta opo esti ver habi l i tada, i r
aparecer o cursor do mouse no vdeo
gravado. O padro essa opo
desabi l i tada. O pontei ro do mouse
gravado no vdeo o que esti ver
confi gurado como padro do si stema.
Pontei ros com ani mao no fi caro
ani mados no vdeo. Nesse caso, ser
mostrado sempre o pri mei ro quadro da
ani mao.
Compressor
Compressor de vdeo uti l i zado na
gravao. Sero l i stados todos os
compressores que esto i nstal ados no
computador, desde que sejam suportados
pel o E3Pl ayback.
Qualidade de compresso
Confi gura a taxa de compresso, que i r
afetar a qual i dade fi nal do vdeo e,
consequentemente, o tamanho do
arqui vo gerado.
Intervalo de quadros a cada quadro-chave
Confi gura a quanti dade de quadros a
cada quadro-chave (key frame).
Configurar (compresso de vdeo)
Abre uma nova janel a que possui
confi guraes especfi cas do compressor
sel eci onado.
Sobre
Abre uma nova janel a que possui
i nformaes sobre o compressor
sel eci onado.
Gravar udio
Habi l i ta a gravao de udi o. O padro
dessa opo desabi l i tado.
Dispositivo
Li sta os di sposi ti vos de udi o i nstal ados
e habi l i tados no si stema, e que podem
ser uti l i zados na captura de udi o.
Formato
Mostra i nformaes sobre o formato de
udi o atual mente sel eci onado.
Atributos
Mostra i nformaes sobre os atri butos do
formato de udi o atual mente
sel eci onado.
Configurar (gravao de udio)
Mostra uma janel a que permi te al terar o
formato de gravao e os atri butos do
udi o.
Mostrar resumo ao concluir gravao
Habi l i ta ou desabi l i ta a janel a que
mostrada no momento em que a gravao
fi nal i zada.
448 E3Playback
20.3.2 Linha de Tempo
A Linha de Tempo permi te acompanhar vi sual mente e control ar o rel gi o de
playback.
Linha de tempo
Possui os segui ntes componentes:
Componentes da Linha de Tempo
OPO DESCRIO
Rgua
Mostra a l i nha de tempo. Pode-se mover a
l i nha de tempo para os l ados cl i cando e
arrastando o mouse. O zoom control ado
pel a roda do mouse. Gi rando para ci ma,
fei to um zoom in. Gi rando para bai xo, zoom
out. necessri o pri mei ro cl i car sobre o
fundo da l i nha de tempo antes de tentar
executar o zoom. Se a tecl a CTRL esti ver
pressi onada, o zoom fei to trs vezes mai s
rpi do.
Cursor
Marca a posi o atual do rel gi o de
playback. Quando o playback est no modo
Pausa pode-se arrastar o cursor para os
l ados, al terando o rel gi o de playback
enquanto arrasta-se o cursor. Est sempre
vi svel na l i nha de tempo.
E3Playback 449
OPO DESCRIO
Barra de Consultas
Mostra os perodos de tempo que j tem
dados carregados:
Uma l i nha verde cl ara si gni fi ca que
naquel e perodo os dados j esto
total mente carregados
Uma l i nha verde escura i ndi ca que os
dados do perodo esto sendo
carregados
Uma l i nha amarel a cl ara i ndi ca que o
perodo contm al guns dados
carregados. Novas consul tas ao banco de
dados sero necessri as se o cursor for
movi do para ci ma do perodo
Uma l i nha ci nza cl ara i ndi ca que o
perodo no tem nenhum dado carregado
ai nda. Para carregar os dados do
perodo, mova o cursor de playback para
ci ma do perodo
Barra de Dados
I ndi ca 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 Li nha de Tempo, comparado
com o perodo total de dados di sponvel
para playback.
Caso tenha si do sel eci onada a opo Mostrar grfico na Linha de Tempo de um Tag
na Lista de Eventos ou na Lista de Tags, ser mostrada uma representao vi sual do
Tag esquerda do grfi co. Esta representao vari a de acordo com o ti po de dados
do Tag.
String: Mostra cai xas de texto com o nome do Tag
Booleano ou Digital: Mostra um grfi co de estado do Tag, onde o val or do Tag
fi car sempre sobre uma l i nha i nferi or (Off ou False) ou sobre uma l i nha
superi or (On ou True). A l i nha do grfi co fi ca ponti l hada nos perodos em que a
qual i dade do Tag est rui m
Double, Integer ou Analgico: Mostra um grfi co de l i nha com os val ores do Tag.
A escal a do grfi co (i nferi or e superi or) cal cul ada automati camente de acordo
com os val ores do Tag que o E3Pl ayback j consul tou no banco de dados. Assi m
como no grfi co di gi tal , a l i nha do grfi co fi ca ponti l hada nos perodos em que a
qual i dade do Tag est rui m. A l i nha tambm pode ser i nterpol ada ou em escada,
dependendo se o Tag suporta (Storage) ou no (Hi stri co) i nterpol ao
450 E3Playback
Mostrar grfico na Linha de Tempo
Cada Tag adi ci onado na Li nha de Tempo possui uma cor defi ni da automati camente,
que pode ser al terada usando a opo Alterar a cor do menu contextual . Esta opo
abre a janel a de Cores do si stema, permi ti ndo sel eci onar uma nova cor ou
personal i zar a cor sel eci onada.
20.3.3 Marcadores
Os Marcadores so uti l i zados para si nal i zar ocorrnci as na l i nha de tempo do
E3Pl ayback.
Marcadores
Opes disponveis na barra de ferramentas Marcadores
CONE COMANDO AO
Adi ci onar marcador no
timestamp sel eci onado
Adi ci ona um nome ao
marcador na l i nha de
tempo, na data e hora
sel eci onadas.
Edi tar marcador
sel eci onado
Permi te edi tar o marcador
sel eci onado, podendo
al terar data e hora, nome
ou descri o.
Remover o marcador Remove o marcador
sel eci onado na l i nha de
tempo.
Remover todos os
marcadores
Remove todos os
marcadores cri ados na
l i nha de tempo.
Mover para o marcador
anteri or
Sel eci ona o marcador
i medi atamente frente
na l i nha de tempo e na
l i sta de eventos,
si mul taneamente.
E3Playback 451
CONE COMANDO AO
Mover para o marcador
segui nte
Sel eci ona o prxi mo
marcador na l i nha de
tempo e na l i sta de
eventos,
si mul taneamente.
Cl i cando em Adicionar, ou em Editar, a segui nte janel a mostrada.
Adicionar ou editar marcador
Opes disponveis na janela Adicionar ou Editar Marcador
OPO DESCRIO
Data/hora/ms
Permi te sel eci onar a data e a hora
(i ncl ui ndo os mi l i ssegundos) do
marcador. Estes campos j vm
preenchi dos com a data e a hora
sel eci onadas na l i nha de tempo.
Nome
Permi te sel eci onar o nome do marcador.
Comentrios
Permi te i nformar al gum comentri o
adi ci onal para o marcador.
Quando um marcador cri ado, el e mostrado na Linha de Tempo, como pode ser
observado na fi gura segui nte, e tambm na Lista de Eventos.
452 E3Playback
Linha de Tempo com marcadores
20.3.4 rea de Telas
Esta a rea onde so mostradas as Tel as do apl i cati vo. A Tel a i ni ci al mostrada
a confi gurada na propri edade InitialScreen do E3Pl ayback. Se esta propri edade for
dei xada em branco, uti l i zada a Tel a i ni ci al do objeto Vi ewer.
rea de Telas
A rea de Tel as funci ona como se fosse um Vi ewer dentro do E3Pl ayback. As Tel as
so sempre abertas no zoom Preencher. possvel navegar l i vremente entre as
Tel as do apl i cati vo.
Exi stem al gumas restri es e comentri os quanto ao funci onamento das Tel as
dentro do E3Pl ayback:
As Tel as funci onam como se esti vessem em um Vi ewer Read-Onl y, i sto , no
permi ti do o envi o de comandos e val ores para o servi dor do E3. Isto garante que
as operaes efetuadas no E3Pl ayback no i ro perturbar o funci onamento do
apl i cati vo em tempo real
E3Playback 453
No permi ti do acesso aos objetos do servi dor atravs do mtodo
Application.GetObject. Se este mtodo for chamado em al gum scri pt, el e i r
fal har, abortando o scri pt
Devi do s vri as l i mi taes de acesso ao servi dor, erros de scri pt ocorri dos
dentro do E3Pl ayback no geram uma mensagem de erro, e os scri pts so
abortados si l enci osamente
O E3Pl ayback emul a um Vi ewer real . Para i sto cri ada uma nova cpi a do objeto
Vi ewer e seus Tags para uso do E3Pl ayback. Se al gum comportamento especfi co
do Vi ewer ti ver que ser habi l i tado ou desabi l i tado dentro do E3Pl ayback, pode-se
testar a propri edade IsPlaybackMode, do objeto Vi ewer
O i sol amento entre as Tel as que rodam dentro do E3Pl ayback e o que est fora
total
O E3Pl ayback trata os novos Quadros cri ados pel o apl i cati vo como novas abas
no topo da rea de Tel as. O ttul o da aba o nome do Quadro ou Tel a que foi
aberto
Quadros abertos em abas no E3Playback
Todas as Associ aes que se referem a objetos do servi dor so capturadas pel o
E3Pl ayback, e passam a receber os dados hi stri cos de acordo com o rel gi o
atual de playback. Isto i ncl ui no apenas as Associ aes fei tas nas Tel as que
esto sendo mostradas, mas tambm os links exi stentes nos Tags do Vi ewer
As Associ aes fei tas entre objetos do Vi ewer (por exempl o, um Di spl ay
mostrando o val or de um Tag Demo i nterno ao Vi ewer) funci onam normal mente,
sem nenhuma i nterfernci a do playback
O E3Chart s i r funci onar dentro do E3Pl ayback se esti ver confi gurado com
Penas hi stri cas. Penas de tempo real so desabi l i tadas dentro do E3Pl ayback
(fi cam sem dados)
454 E3Playback
O E3Al arm i r mostrar o sumri o de al armes de acordo com o que esti ver
regi strado na tabel a de al armes no banco de dados
O E3Browser i r funci onar normal mente, j que consul tas ao banco de dados
so permi ti das dentro do E3Pl ayback
NOTA: Os dados mostrados no E3Browser so sempre os dados ATUAIS do banco de
dados, i sto , o E3Pl ayback no tenta emul ar o estado do banco de dados em um
momento no passado.
20.3.5 Lista de Eventos
A Lista de Eventos mostra a sequnci a cronol gi ca de eventos de playback,
permi ti ndo a navegao evento a evento. Um evento de playback pode ser:
Uma al terao no val or de um Tag
Uma al terao no estado de um al arme
Lista de Eventos
A l i sta possui trs col unas:
Colunas da Lista de Eventos
CAMPO DESCRIO
Data/hora
Mostra a data e a hora do evento,
conforme est regi strado no banco de
dados.
Caminho do Tag
Mostra o cami nho do Tag ou da fonte de
al armes que gerou este evento, ou o
nome do marcador.
E3Playback 455
CAMPO DESCRIO
Evento
Se o evento for de mudana do val or de
um Tag, mostra o novo val or. Se a
qual i dade no for Boa (192), el a ser
mostrada na frente do val or (por
exempl o, "Rui m(20); 45.433"). Se o evento
for uma al terao no estado de um
al arme, mostra o nome da sub-condi o
(HI, HIHI, LO, LOLO, etc.) e a descri o do
al arme. Se o al arme est (ou foi )
reconheci do, mostra no i nci o o texto
ACK, com o nome do operador entre
parnteses. Se for um marcador, este
campo mostra o comentri o associ ado a
el e.
A barra de ferramentas da Li sta de Eventos possui as segui ntes operaes:
Opes da barra de ferramentas da Lista de Eventos
CONE COMANDO AO
Evento Anteri or Posi ci ona o rel gi o de
playback no evento anteri or
ao evento sel eci onado na
l i sta, pul ando os eventos
com timestamp i gual ao
timestamp atual .
Prxi mo Evento Posi ci ona o rel gi o de
playback no prxi mo evento
com timestamp mai or que
o timestamp atual .
Fi l trar Eventos Li ga ou desl i ga o fi l tro de
eventos. Ao l i gar o fi l tro,
apenas os eventos do Tag
ou da fonte de al arme
sel eci onado atual mente
sero mostrados na l i sta
de eventos. Os
marcadores so
mostrados sempre,
i ndependente do fi l tro.
Fi l trar marcadores Mostra apenas os
marcadores cri ados.
Ao cl i car com o boto di rei to do mouse sobre um evento, um menu contextual
mostrado com as segui ntes opes.
456 E3Playback
Opes do menu contextual dos eventos
OPO DESCRIO
Mostrar ou Remover grfico na Linha de
Tempo
Adi ci ona ou remove uma representao
vi sual do Tag sel eci onado na janel a
Linha de Tempo.
Mostrar apenas os eventos deste tag ou
Mostrar todos os eventos
Fi l tra os eventos na Li sta de Eventos
para mostrar apenas o Tag sel eci onado.
Sel eci onando de novo esta opo mostra
todos os eventos.
20.3.6 Lista de Tags
A Lista de Tags mostra os Tags que esto sendo uti l i zados para playback.
Lista de Tags
As col unas so as segui ntes:
Colunas da Lista de Tags
COLUNA DESCRIO
Caminho do Tag
Mostra o cami nho do Tag.
Tabela
Mostra o nome da tabel a do banco de
dados que contm os dados do Tag.
Estado
I ndi ca se o Tag foi encontrado ou no no
banco de dados.
Valor
Mostra o val or do Tag na data e hora
atual de playback.
E3Playback 457
COLUNA DESCRIO
Data/hora
Mostra o timestamp atual do Tag. Se o
Tag suportar i nterpol ao (apenas para
pontos anal gi cos armazenados no
Storage), ento o timestamp ser i gual ao
horri o atual de playback. Caso contrri o,
o timestamp ser o do l ti mo evento com
timestamp anteri or ou i gual ao horri o
atual de playback.
Qualidade
Mostra a qual i dade do Tag (padro OPC)
no momento atual de playback. Quando a
qual i dade 192, mostrado apenas o
texto "Boa".
Evento Anterior
Mostra o timestamp do evento anteri or
deste Tag no banco de dados. Se o Tag
no suportar i nterpol ao, o evento
anteri or ser sempre i gual ao timestamp
atual do Tag. Se o Tag suportar
i nterpol ao, o evento anteri or ser o
l ti mo timestamp regi strado no banco de
dados antes do horri o atual de playback.
Prximo Evento
Mostra o timestamp do prxi mo evento
deste Tag.
NOTA: A Li sta de Tags pode ajudar tambm a determi nar quai s Tags necessi tam ser
gravados no banco de dados para permi ti r o playback compl eto de uma Tel a,
bastando veri fi car os Tags com o si nal de proi bi do .
Ao cl i car com o boto di rei to do mouse em um Tag, um menu contextual mostrado
com as mesmas opes descri tas no tpi co Lista de Eventos, exceto no caso de Tags
marcados com o cone , em que o menu contextual aparece desabi l i tado.
20.4 Banco de Dados de Playback
O E3Pl ayback detecta automati camente quai s so os Tags e os al armes que esto
armazenados no banco de dados. A este processo de deteco do banco de dados
chamamos de Montagem. Depoi s que o banco de dados est montado, o
E3Pl ayback uti l i za as i nformaes col etadas para fazer consul tas aos dados
armazenados, de acordo com os Tags que esto sendo mostrados na Tel a e de
acordo com o rel gi o atual de playback.
20.4.1 Montagem do Banco de Dados
A Montagem do Banco de Dados fei ta sempre que o E3Pl ayback ati vado. As
i nformaes de estrutura do banco de dados col etadas durante a montagem so
manti das enquanto a seo de playback esti ver ati va.
458 E3Playback
Os passos da montagem do banco de dados podem ser resumi dos da segui nte
forma:
1. Enumerar todas as tabel as do banco de dados.
2. Veri fi car quai s destas tabel as possuem uma tabel a _Fi el ds correspondente.
Por exempl o, quando o E3 gera uma tabel a de al armes chamada E3Al arms, gera
tambm uma tabel a com a descri o dos campos da tabel a de al armes
(E3Al arms_Fi el ds).
3. Anal i sar os campos de cada tabel a, bem como o contedo da sua tabel a
_Fi el ds correspondente para determi nar o ti po de tabel a. O E3Pl ayback
reconhece trs ti pos de tabel a:
Storage: a tabel a deve ter os campos E3TimeStamp, FieldID, Quality e
FieldValue
Alarmes: a tabel a deve ter os campos EventTime (ou EventTimeDbl),
ConditionActive, Acked, AckRequired e FullAlarmSourceName
Histrico: a tabel a deve ter o campo E3TimeStamp, e no pode ter si do
reconheci da como uma tabel a de Storage ou de Al armes
4. Se a tabel a for de Storage, a tabel a _Fi el ds varri da para determi nar quai s so
os Tags armazenados na tabel a. O cami nho do Tag determi nado pel o campo
FieldName da tabel a _Fi el ds. O campo que fornece o timestamp dos dados de
Storage sempre o E3TimeStamp. Cada Storage pode ter at trs tabel as de
dados, uma para cada ti po de dado:
Strings: o nome da tabel a de dados <Tabel a>_Stri ng
Bit/Digital: o nome da tabel a de dados <Tabel a>_Bi t
Double/Analgicos: o nome da tabel a de dados <Tabel a>
5. Se a tabel a for de Hi stri co, a tabel a _Fi el ds varri da para determi nar quai s
so os Tags armazenados na tabel a. O cami nho do Tag neste caso
determi nado pel o campo FieldSource. O campo que fornece o timestamp dos
dados desta tabel a sempre o E3TimeStamp.
6. Se a tabel a for de al armes, a tabel a _Fi el ds varri da para determi nar o nome
dos campos de al arme de usuri o (se exi sti rem). O campo que fornece o
timestamp na tabel a de al armes o EventTime (opci onal mente combi nado com
o campo EventTimeMS, se exi sti r) ou o campo EventTimeDbl (este l ti mo tem
pri ori dade por representar os mi l i ssegundos com mai s preci so).
7. Depoi s que todas as tabel as de dados e os cami nhos dos Tags foram
detectados, fei ta uma consul ta si mpl es em cada uma das tabel as para
determi nar a data mai s anti ga e a data mai s nova armazenada na tabel a. Isto
permi te determi nar o i nterval o de datas em que o playback ser permi ti do.
E3Playback 459
NOTA 1: o i nterval o de datas vl i das no atual i zado durante um processo de
playback, de forma que os dados novos que forem adi ci onados ao banco aps a
montagem do banco de dados s estaro di sponvei s se a janel a de playback for
fechada e aberta novamente.
NOTA 2: em modo Demo (ou com uma l i cena de E3 Studi o) o perodo permi ti do
para playback se resume s l ti mas sei s horas de dados armazenados no banco de
dados.
20.4.2 Consultas de Dados de Playback
A quanti dade de dados di sponvel para playback pode ser enorme, dependendo do
apl i cati vo. Para tornar a navegao de Tel as mai s suave, o E3Pl ayback faz
consul tas ao banco de dados em perodos de tempo pequenos, chamados Fatias.
Cada fati a de dados de playback tem uma l argura fi xa de 45 mi nutos. Sempre que o
rel gi o posi ci onado em uma determi nada data e hora, o E3Pl ayback cri a ou
encontra a fati a de tempo que contm a data e hora atual .
Cada fati a de dados possui as segui ntes i nformaes:
Perodo de tempo da fati a (data e hora i ni ci al e fi nal )
Uma l i sta dos Tags que j tm os seus dados carregados na fati a
Para cada Tag armazenado em uma fati a, so manti dos os segui ntes dados:
O l ti mo evento do Tag anteri or ao i nci o da fati a
Todos os eventos do Tag dentro do i nterval o da fati a
O prxi mo evento do Tag aps o fi nal da fati a
O sumri o de al armes no momento do i nci o da fati a
Todos os eventos de al armes que ocorreram durante o i nterval o da fati a
O prxi mo evento de al arme de cada Fonte de Al arme aps o fi nal da fati a
Quando o rel gi o de playback movi do sobre uma fati a de tempo, o E3Pl ayback
anal i sa se todos os Tags necessri os j esto carregados na fati a, e se todas as
i nformaes de al arme tambm j foram carregadas. Se esti ver fal tando al gum
dado, ento gerada uma consul ta assncrona para carregar os dados necessri os
do banco de dados.
Uma consul ta de dados de playback composta dos segui ntes parmetros:
Perodo que vai ser consul tado (data e hora i ni ci al e fi nal )
Conjunto de Tags que devem ser consul tados (pode estar vazi o). Para cada Tag
dever ser retornado:
O l ti mo evento anteri or ao i nci o da consul ta
Todos os eventos ocorri dos durante o perodo da consul ta
460 E3Playback
O prxi mo evento que ocorreu aps o perodo da consul ta
Informaes de al armes que devem ser consul tadas (zero ou mai s das segui ntes
opes):
Sumri o de al armes anteri or (estado de cada Fonte de Al arme na data e hora
i ni ci al da consul ta)
Eventos de al armes no perodo
Sumri o de al armes posteri or (prxi mo evento de cada Fonte de Al arme aps
a data e hora fi nal do perodo)
Para executar uma consul ta a dados de playback, normal mente so necessri as
vri as consul tas ao banco de dados. O servi dor de dados de playback efetua estas
consul tas de forma assncrona e em um thread separado, col eta os dados e s os
retorna quando todas as consul tas ti verem termi nado.
Quando uma consul ta de playback compl etada, os dados so i medi atamente
adi ci onados fati a correspondente e o E3Pl ayback automati camente di spara
consul tas para atual i zar as fati as vi zi nhas. Desta forma, medi da que o rel gi o de
playback avana, as consul tas de dados vo sendo fei tas, e quando o rel gi o passa
para a prxi ma fati a bem provvel que el a j tenha todos os seus dados
carregados.
Caso o rel gi o de playback esteja no modo Reproduzir e entre em uma fati a sem
dados ou com dados i ncompl etos, o E3Pl ayback fi ca temporari amente pausado
aguardando at que as consul tas daquel a fati a sejam compl etadas.
O E3Pl ayback tambm busca mi ni mi zar o acesso ao banco de dados, aprovei tando
as i nformaes dos campos ltimo evento anterior, Prximo evento aps, Sumrio
anterior e Sumrio posterior para evi tar que estes dados sejam consul tados
novamente. Por exempl o:
Se uma consul ta a um Tag no retornou o prxi mo evento aps o perodo da
consul ta, si nal de que este Tag no possui nenhum evento aps a data e hora
fi nal da consul ta, e portanto este Tag no preci sa ser consul tado nas fati as de
tempo posteri ores
Se uma consul ta retornou o sumri o anteri or, eventos de al armes no perodo e o
sumri o posteri or para uma fati a, possvel cal cul ar o sumri o anteri or da
prxi ma fati a si mpl esmente combi nando o sumri o anteri or e os eventos
ocorri dos durante a fati a atual . Desta forma, torna-se desnecessri o consul tar
no banco de dados o sumri o anteri or da prxi ma fati a
E3Playback 461
20.5 Configurao dos Objetos de Banco de
Dados do E3
Esta seo expl i ca como os objetos do E3 devem ser confi gurados para que os
dados armazenados no banco de dados possam ser uti l i zados no E3Pl ayback.
20.5.1 Storage
A ni ca recomendao para o Storage que a col una Fonte no deve conter
expresses, poi s el as no podero ser uti l i zadas no playback.
O E3 j cri a automati camente nas tabel as de Storage os ndi ces necessri os para
oti mi zar as consul tas do E3Pl ayback.
20.5.2 Alarmes
Para fazer playback de al armes, si ga estes procedi mentos:
1. Habi l i te ou confi gure o regi stro de al armes em di sco.
2. Sel eci one os segui ntes campos para regi stro (obri gatri o).
EventTime (mai s EventTimeMS) ou EventTimeDbl
FullAlarmSourceName
ConditionActive
Acked
AckRequired
3. Ai nda recomendada a sel eo dos segui ntes campos para regi stro:
InTime (mai s InTimeMS) ou InTimeDbl
OutTime (mai s OutTimeMS) ou OutTimeDbl
AckTime (mai s AckTimeMS) ou AckTimeDbl
Area
ActorID
Enabled
EventCategory
EventType
Message
Severity
462 E3Playback
Source
SubConditionName
CurrentValue
Seleo dos campos
O E3 j cri a automati camente na tabel a de al armes os ndi ces necessri os para
oti mi zar as consul tas do playback.
20.5.3 Histricos
O formato de arqui vo Hi stri co no o i deal para playback, poi s normal mente
mui tos dados dupl i cados esto armazenados. As consul tas de playback tem um
trabal ho extra para el i mi nar os val ores dupl i cados de cada Tag e encontrar apenas
os eventos de mudana de val or, o que pode exi gi r l ongas consul tas sequenci ai s
pel a tabel a do Hi stri co. recomendado o uso do Storage sempre que possvel . Se
for i ndi spensvel o uso de dados de Hi stri co no playback, deve-se segui r ao
mxi mo as segui ntes recomendaes:
Confi gurar a propri edade UserTable para Fal so (se esta propri edade fi car em
Verdadei ro, a tabel a _Fi el ds deste hi stri co no ser gerada, e este hi stri co no
ser reconheci do pel o playback)
Col ocar cada Tag em um campo separado (no uti l i zar expresses na fonte do
campo, por exempl o)
Cri ar um ndi ce para o campo E3TimeStamp. Sem este ndi ce as consul tas ao
Hi stri co fi cam mui to l entas, tornando o playback i mprati cvel
Uti l i zar tabel as com poucos campos e, se possvel , adi ci onar um ndi ce
E3Playback 463
i ndi vi dual para cada campo (pri nci pal mente para os campos com poucas
vari aes)
Confi gurar a propri edade CompressedTable em Verdadei ro e uti l i zar a
propri edade DeadBand no Hi stri co
A fi gura a segui r mostra como deve ser a confi gurao do ndi ce do campo
E3TimeStamp:
Definio do ndice para o campo E3TimeStamp
20.5.4 Licenciamento
A El i pse fornece doi s pacotes de playback de acordo com as suas ferramentas:
Playback Bsico
Playback Avanado: consi ste no Playback Bsico mai s as ferramentas de Gravao
de Vdeo e Captura de Tela
Cada um destes pacotes di mensi onado conforme o nmero de pontos (Tags e
464 E3Playback
Fontes de Al armes) armazenados no banco de dados. Por exempl o, um Playback
Bsico 1000 permi te fazer playback de um banco de dados com at 1000 pontos. Se
o banco de dados ti ver mai s pontos que as l i cenas di sponvei s, a montagem do
banco de dados i r fal har e ser mostrada uma mensagem de erro i ndi cando que
no h l i cenas di sponvei s para rodar o playback.
A l i cena de E3 Studi o do E3 i ncl ui uma l i cena de Playback Avanado sem l i mi te de
pontos, porm l i mi tada s l ti mas sei s horas de dados armazenados no banco de
dados. Isto permi te que o desenvol vedor do apl i cati vo teste o playback sem
preci sar adqui ri r as l i cenas para i sto.
Em modo Demo (quando no h di sposi ti vo de proteo), o playback tambm
funci ona no modo Avanado sem l i mi te de pontos, porm l i mi tado a mostrar
apenas as l ti mas sei s horas de dados armazenados no banco de dados.
IMPORTANTE: Se o di sposi ti vo de proteo for do ti po Master (Studio + Runtime) ou
apenas de Runtime, o playback s estar di sponvel se houver l i cenas programadas
no di sposi ti vo. Para mai ores i nformaes sobre as l i mi taes do modo Demo do E3,
veja o tpi co Limitaes do Modo Demonstrao.
Frmulas 465
21
Frmulas
CAPTULO
Frmulas so mdul os desti nados ao armazenamento e transfernci a de conjuntos
de val ores para determi nados agrupamentos de vari vei s, de forma a cri ar
confi guraes pr-defi ni das. So compostas de trs partes: Templates, Unidades e
Conjuntos de Valores.
As Frmul as podem ser uti l i zadas para faci l i tar processos i ndustri ai s. Por
exempl o, uma fbri ca de bebi das faz vri os ti pos de sucos, cada um del es com uma
recei ta di ferente. Neste caso, os Templ ates so os sabores (l aranja, uva, tangeri na,
etc.). As Uni dades so os tanques onde os sucos so produzi dos. E o ti po e a
quanti dade de produtos col ocados em cada suco (por exempl o, 50g de acar,
1000l de gua, pol pa de fruta, etc.) so os Conjuntos de Val ores. Para uti l i zar este
recurso, si ga este procedi mento:
1. Cl i que com o boto di rei to do mouse sobre o nome do projeto no Organi zer e
sel eci one a opo Inserir - Frmula.
466 Frmulas
Inserindo uma Frmula
NOTA: O objeto Frmul a pode ser confi gurado para funci onar como rea de Alarme.
21.1 Configuraes
Quando se cri a uma Frmul a, mostrada uma janel a para a confi gurao do
Banco de Dados e da tabel a que sero uti l i zados. Sem i sto, no ser possvel a
cri ao de Uni dades e Conjuntos de Val ores.
Frmulas 467
Configurao do Banco de Dados e da tabela
Opes disponveis na janela Configurao do Banco de Dados
OPO DESCRIO
Banco de Dados
Determi na o servi dor de Banco de Dados
que gerenci ar os dados confi gurados na
Frmul a.
Tabela
Determi na o nome da tabel a.
Caso seja necessri o confi gur-l os posteri ormente, ou mesmo reconfi gur-l os,
basta escol her a opo Configurar Banco de Dados no menu contextual da Frmul a.
468 Frmulas
Configurando o Banco de Dados
21.2 Templates
A pri mei ra aba na view de Frmul as chama-se Templates. Os Templ ates defi nem o
ti po de dado que poder ser armazenado em cada vari vel da Frmul a, al m de
suas restri es.
Frmulas 469
Aba Templates
Opes disponveis na aba Templates
OPO DESCRIO
Nome
Defi ne o nome do Templ ate.
Tipo
Defi ne o ti po do Templ ate.
Restries
Determi na as restri es do Templ ate.
A barra de ferramentas da view Templ ates tem os segui ntes botes: Adicionar ,
para a cri ao de um novo Templ ate; e Remover , para a excl uso do Templ ate
sel eci onado.
Ao cl i car em Restries, a segui nte janel a mostrada:
470 Frmulas
Edio das restries
As restri es permi tem habi l i tar ou desabi l i tar a al terao dos val ores da Frmul a
em tempo de execuo, ou ento esti pul ar l i mi tes para esta al terao. As opes
di sponvei s so:
Opes disponveis na janela Edio das Restries
OPO DESCRIO
Limite Irrestrito
O usuri o pode al terar qual quer val or no
Templ ate. si mbol i zado pel a l etra U na
view Templ ates.
Limite Restrito
O usuri o no pode al terar o val or do
Templ ate. si mbol i zado pel a l etra R na
view Templ ates.
Limite Absoluto
So defi ni dos val ores fi xos como l i mi tes,
correspondendo ao val or mni mo e
mxi mo do Templ ate. si mbol i zado pel a
l etra A na view Templ ates (e os val ores
mni mo e mxi mo confi gurados no
campo).
Frmulas 471
OPO DESCRIO
Limite Percentual
Val or percentual aci ma ou abai xo do
val or pr-defi ni do. Por exempl o,
col ocando os l i mi tes entre 20% e 30%,
para o val or 100, os val ores permi ti dos
vari am entre 80 e 130. si mbol i zado pel a
l etra P na view Templ ates (e os val ores
confi gurados no campo).
Limite por diferena
Val ores fi xos aci ma ou abai xo do val or
pr-defi ni do. Por exempl o, col ocando os
l i mi tes em 10 e 50 para o val or 50, os
val ores permi ti dos vari am de 40 e 100.
si mbol i zado pel a l etra D na view
Templ ates (e os val ores confi gurados no
campo).
21.3 Unidades
A segunda aba na view de Frmul as chama-se Unidades. As Uni dades defi nem os
Tags que sero associ ados aos Templ ates da Frmul a. possvel cri ar vri as
Uni dades, ou seja, vri os grupos de Tags que podero receber os val ores da
Frmul a.
Aba Unidades
Opes disponveis na aba Unidades
OPO DESCRIO
Nome
Determi na o nome do Templ ate.
Unidade
Determi na o Tag que ser associ ado
Uni dade.
A barra de ferramentas da view Uni dades tem os segui ntes botes: Adicionar ,
para a cri ao de uma nova Uni dade; Remover , para a excl uso da Uni dade
sel eci onada; e Renomear , para a troca do nome da Uni dade sel eci onada. Para
472 Frmulas
cada nova Uni dade, sol i ci tado um nome:
Adio de uma Unidade
21.4 Conjunto de Valores
A tercei ra aba na view de Frmul as chama-se Valores. Conjuntos de Val ores so os
val ores transferi dos para os Tags, ou seja, para as Uni dades.
Aba Valores
Opes disponveis na aba Valores
OPO DESCRIO
Nome
Determi na o nome do Templ ate.
Valor
Determi na o val or dos campos para os
Conjuntos de Val ores.
A barra de ferramentas da view Val ores tem os segui ntes botes: Adicionar , para
a cri ao de um novo Conjunto de Val ores; Remover , para a excl uso do
Conjunto de Val ores sel eci onado; e Renomear , para a troca do nome do
Conjunto de Val ores sel eci onado.
Frmulas 473
21.5 Criao de uma Frmula
Instrues
Ser cri ado um objeto Frmul a para armazenar Conjuntos de Val ores para a
produo de uma determi nada pea. Esta pea ter trs medi das: Di metro Externo,
Di metro Interno e Al tura. Esta Frmul a armazenar os val ores para duas
mqui nas di ferentes, que produzi ro estas peas.
21.5.1 Procedimentos
1. Insi ra um objeto Frmul a na apl i cao.
2. Confi gure o Banco de Dados e a tabel a. Use um Banco de Dados exi stente no
projeto, e chame a tabel a de Produo.
Configuraes do Banco de Dados e da tabela
3. Cri e trs Templ ates na Frmul a:
Dimetro Externo, com restri o de val or absol uta entre 50 e 80
Dimetro Interno, com restri o por di ferena de val or de 10 e 10
Altura, com l i mi te restri to
Templates
474 Frmulas
4. Na prxi ma etapa, sero defi ni das as Uni dades rel ati vas a esta Frmul a. Antes
de cri ar as Uni dades, no entanto, deve-se cri ar os Tags usados nesta Frmul a.
Para i sto, i nsi ra em seu Servi dor de Dados uma Pasta chamada Formula, e
dentro del a outras duas Pastas chamadas Maquina1 e Maquina2. Dentro del as
cri e trs Tags Internos para cada uma.
Criando Tags
5. Cri e na Frmul a duas Uni dades chamadas Maquina1 e Maquina2. Associ e
cada campo destas Uni dades aos Tags cri ados anteri ormente.
Frmulas 475
Associando os Tags s Unidades da Frmula
6. Defi na os Conjuntos de Val ores a serem carregados posteri ormente nos Tags.
Cri e quatro Conjuntos de Val ores, chamados de Modelo1 at Modelo4, e di gi te
os segui ntes val ores:
Configurao do Conjunto de Valores
7. Cri e agora uma nova Tel a chamada Frmulas.
8. Cri e sei s objetos SetPoi nt nesta Tel a, que sero associ ados a cada um dos Tags
da Frmul a, e ajuste o tamanho da Tel a ao dos objetos. A Tel a deve fi car
pareci da com a fi gura a segui r:
476 Frmulas
Tela de Frmula
NOTA: s vezes, pode ocorrer um erro na Tel a que faz com que as i magens
desapaream. Para sol uci onar esta questo deve-se desabi l i tar a opo Esconder
extenses do MS-DOS para arquivos registrados. Pode-se acessar esta opo a parti r do
Wi ndows Expl orer.
9. Cri e um boto na Tel a com o ttul o "Carregar val ores". Este boto i r mostrar
uma cai xa de di l ogo com os val ores exi stentes e as Uni dades para as quai s
estes podem ser carregados, podendo ser sel eci onada qual quer opo. Para
tanto, cri e o segui nte scri pt neste boto:
Application.LoadFormulaDlg "Formula1", "Maquina1, Maquina2",_
"Modelo1, Modelo2, Modelo3, Modelo4"
End Sub
Onde Formula1 o nome do objeto Frmul a cri ado e o mtodo LoadFormulaDlg
um mtodo do Vi ewer. Ao ser executado este mtodo, a segui nte cai xa de di l ogo
mostrada:
Frmulas 477
Caixa de dilogo do mtodo LoadFormulaDlg
10. Na di vi so da di rei ta so apresentadas as duas Uni dades cri adas na Frmul a,
assi m como os Conjuntos de Val ores de Modelo1 a Modelo4. A opo Modo
Silencioso i ni bi r a possi bi l i dade de o usuri o al terar val ores gravados em
di sco, que sero carregados para os Tags.
11. Atravs deste boto, pode-se ver a apl i cao funci onando com as Frmul as e
os Tags recebendo os val ores do di sco. Este um dos mtodos para carregar
val ores de uma Frmul a, mas tambm exi stem mtodos em que o usuri o no
necessi ta sel eci onar os val ores ou as Uni dades em uma cai xa de di l ogo.
12. Cri e agora um objeto SetPoi nt na Tel a e um boto com o ttul o "OK". Junto com
o SetPoi nt, col oque um texto de i denti fi cao com o ttul o "Model o:". No boto
dever ser cri ado o segui nte scri pt:
Application.LoadFormulaValues "Formula1", "Maquina1",_
"Modelo1"
Screen.Item("Texto16").Value
End Sub
Onde Texto16 o nome do l ti mo SetPoi nt i nseri do na Tel a. Este comando i r
carregar o Conjunto de Val ores especi fi cado no SetPoi nt para a Uni dade Maquina1.
Ao ser executado, este mtodo i r buscar pel o Conjunto de Val ores em di sco. Caso
encontre, i r carreg-l o segui ndo o padro de restri es defi ni do no Templ ate da
Frmul a. Os campos com restri es abertas podero ter seus val ores modi fi cados
pel o usuri o. Para que o usuri o no seja i nterrogado sobre as mudanas de
val ores nos campos carregados, deve-se uti l i zar o modo si l enci oso.
478 Frmulas
Alterao do valor
No entanto exi ste uma al ternati va, o mtodo LoadFormulaValuesQuiet, do objeto
Vi ewer. Ser fei ta uma opo pel o modo si l enci oso na Tel a, uti l i zando para i sto, o
objeto Cai xa de Sel eo.
Cri e um objeto Cai xa de Sel eo na Tel a
Col oque um texto de i denti fi cao ao seu l ado, com o texto "Si l enci oso"
Vol te ao scri pt do boto OK e mude o cdi go para:
If Screen.Item("CheckBox1").Value = true Then
Application.LoadFormulaValuesQuiet "Formula1", "Maquina1",
"Modelo1"
"Modelo2"
"Modelo3"
"Modelo4"
Else
Application.LoadFormulaValues "Formula1", "Maquina1",
"Modelo1"
"Modelo2"
"Modelo3"
"Modelo4"
End If
End Sub
Frmulas 479
Onde CheckBox1 o nome da Cai xa de Sel eo cri ada. Isto far com que se o
objeto esti ver habi l i tado, seja uti l i zado o mtodo LoadFormulaValuesQuiet. Caso
contrri o, ser uti l i zado o mtodo LoadFormulaValues.
1. Repi ta os l ti mos procedi mentos desde a cri ao do SetPoi nt para os i tens da
Maquina2, modi fi cando os scri pts necessri os. Ao fi nal das al teraes, a Tel a
dever fi car pareci da com a fi gura a segui r.
Tela final da Frmula
2. Rode a apl i cao e observe os resul tados.
480 Relatrios
22
Relatrios
CAPTULO
O Relatrio um componente Acti veX chamado ActiveReport, que permi te a
vi sual i zao e i mpresso de val ores i nstantneos de vari vei s do si stema e dados
armazenados em Banco de Dados (Al armes, Hi stri cos, Consul tas e Frmul as).
Estes dados podem ser i mpressos tanto em formato texto como em formato grfi co,
sendo este l ti mo fei to atravs do objeto E3Chart. Para uti l i zar o Rel atri o, si ga
1. Cl i que com o boto di rei to no Organi zer e sel eci one a opo Inserir Relatrio
em.
Inserindo um Relatrio
22.1 Objeto Consulta
Este objeto permi te que seja especi fi cada a ori gem dos dados do Banco de Dados
que ser vi sual i zado no Rel atri o. Aps ter cri ado o Rel atri o no projeto, este cri a
o objeto Consul ta. Para mai ores i nformaes a respei to deste objeto, veja o
captul o Consultas.
Relatrios 481
22.2 Componentes
Um Rel atri o contm vri as Sees. Cada Seo do Rel atri o contm um grupo de
control es que so processados e i mpressos ao mesmo tempo, como uma ni ca
uni dade.
Sees do Relatrio
O Rel atri o defi ne ti pos de Seo, que sero expl i cados nos tpi cos a segui r.
22.2.1 Report Header
Um Rel atri o pode ter uma Seo Report Header que i mpri me no i nci o do
Rel atri o. geral mente uti l i zada para i mpri mi r ttul os de rel atri o, tabel as de
somas, grfi cos ou qual quer outra i nformao que necessi te aparecer somente
uma vez no i nci o do Rel atri o.
NOTA: Um Report Header pode estender-se por ml ti pl as pgi nas. Para i sto, basta
i nseri r um objeto Quebra de Pgi na em seu contedo.
482 Relatrios
22.2.2 Report Footer
A Seo Report Footer i mpri me no fi nal do Rel atri o. usada para i mpri mi r uma
soma de um rel atri o, totai s gerai s ou qual quer outra i nformao que necessi te ser
i mpressa somente uma vez no fi nal do Rel atri o.
22.2.3 Page Header
A Seo Page Header i mpri me uma vez o topo de cada pgi na do Rel atri o. a
pri mei ra Seo que i mpri me na pgi na, exceto quando esta pgi na contm a Seo
Report Header. Usada para i mpri mi r totai s de pgi nas, nmeros de pgi nas, ttul os
de pgi nas ou qual quer outra i nformao que necessi te ser i mpressa uma vez no
topo de cada pgi na.
22.2.4 Page Footer
A Seo Page Footer i mpri me uma vez na base de cada pgi na do Rel atri o. Usada
para i mpri mi r totai s de pgi nas, nmeros de pgi nas ou qual quer outra
i nformao que necessi te ser i mpressa uma vez na base de cada pgi na.
22.2.5 Group Header e Group Footer
Um Rel atri o pode ter ml ti pl os grupos ani nhados. Cada grupo possui uma Seo
Header e uma Seo Footer. A Seo Header i mpri me antes de qual quer Seo
Detail no grupo. A Seo Footer i mpri me depoi s de todas as Sees Detail do grupo.
Sees de grupo so i nseri das i medi atamente antes e depoi s da Seo Detail.
O nmero de vezes que uma Seo de grupo pode i mpri mi r depende de como os
dados so agrupados. O Rel atri o i ni ci ar um novo grupo (Header, Detail e Footer)
para cada mudana nos dados que sero reuni dos no grupo.
22.2.6 Detail
A Seo Detail o corpo do Rel atri o, que i mpri me uma vez para cada regi stro da
fonte de dados.
22.3 Configuraes
O Rel atri o possui vri os objetos que podem ser agregados a el e, que so
acessados atravs da barra de ferramentas Relatrio.
Barra de Ferramentas Relatrio
Cl i cando com o boto di rei to do mouse sobre o Rel atri o, mostrado um menu. As
Relatrios 483
opes deste menu vari am de acordo com o l ocal do cl i que do mouse.
Na rea do Relatrio: Somente as opes Insert e Delete Section esto
habi l i tadas
Menu da rea do Relatrio
Em um objeto no Relatrio: Somente as opes Insert, Delete, Cut, Copy, Paste,
Bring to Front, Send to Back, Alignment e Format Border esto habi l i tadas
Menu de objeto do Relatrio
Em mais de um objeto selecionado no Relatrio: Todas as opes do menu esto
habi l i tadas
484 Relatrios
Opes disponveis no menu contextual do Relatrio
OPO DESCRIO
Insert
Permi te i nseri r um novo componente do
Rel atri o. As opes di sponvei s so as
segui ntes:
Insert - Group Header/Footer: Adi ci ona um
novo par de cabeal hos ou rodaps de
grupo no Rel atri o
Insert - Page Header/Footer: Adi ci ona um
novo par de cabeal hos ou rodaps de
pgi na
Insert - Report Header/Footer: Adi ci ona um
novo par de cabeal hos ou rodaps no
Rel atri o
Delete / Delete Section
Apaga a Seo, objeto ou grupo
sel eci onado. Esta opo no apl i cada na
Seo Detail do Rel atri o.
Reorder Groups
Reorgani za os grupos sel eci onados. Esta
opo vl i da quando vri os grupos de
Seo (pares de cabeal ho ou rodap)
foram adi ci onados no Rel atri o. Esta opo
no apl i cada na Seo Detail do
Rel atri o.
Cut
Recorta o objeto, grupo ou Seo
sel eci onado.
Copy
Copi a o objeto, grupo ou Seo
sel eci onado.
Paste
Col a o objeto, grupo ou Seo na Seo
corrente do Rel atri o.
Bring to Front
O objeto, grupo ou Seo sel eci onado
envi ado para a pri mei ra posi o na ordem
de sobreposi o.
Send to Back
O objeto, grupo ou Seo sel eci onado
envi ado para a l ti ma posi o na ordem de
sobreposi o.
Align
Al i nha o objeto, grupo ou Seo
sel eci onado. As opes di sponvei s so as
segui ntes:
Lefts: Al i nhamento esquerdo
Centers: Al i nhamento central i zado
Rights: Al i nhamento di rei to
Tops: Al i nhamento no topo
Middles: Al i nhamento central
Bottoms: Al i nhamento mesma al tura
To grid: Al i nhamento conforme a grade
Center in section: Al i nhamento
central i zado na Seo
Relatrios 485
OPO DESCRIO
Size
Determi na o tamanho do objeto, grupo ou
Seo sel eci onado. As opes di sponvei s
so as segui ntes:
Make same width: Mesma l argura
Make same height: Mesma al tura
Make same size: Mesmo tamanho
Horizontal Spacing
Determi na o espaamento hori zontal do
objeto no Rel atri o. As opes di sponvei s
so as segui ntes:
Make Equal: Espaamento i gual entre os
objetos
Increase: I ncrementa o espaamento do
objeto em um passo
Decrease: Decrementa o espaamento do
objeto em um passo
Vertical Spacing
Determi na o espaamento verti cal do
objeto. As opes di sponvei s so as
segui ntes:
Make equal: Espaamento i gual entre os
objetos
Increase: I ncrementa o espaamento do
objeto em um passo
Decrease: Decrementa o espaamento do
objeto em um passo
Format Border
Determi na o formato da borda do objeto do
Rel atri o.
Quando a opo Format Border sel eci onada, uma cai xa de di l ogo mostrada.
486 Relatrios
Opes de borda do objeto
Opes disponveis para a borda do objeto
OPO DESCRIO
Presets
Determi na o esti l o da borda externa do
objeto.
Line Styles
Determi na o esti l o da l i nha da borda do
objeto.
Preview
Prvi a de confi gurao do objeto.
Color
Determi na a cor da borda do objeto.
Shadow
Habi l i ta ou desabi l i ta a sombra do
objeto.
Atravs da barra de ferramentas Relatrio, possvel acessar os recursos
di sponvei s no Rel atri o.
22.3.1 Preview
Atravs desta opo, possvel vi sual i zar uma prvi a da i mpresso do Rel atri o.
Assi m possvel veri fi car confi guraes de margem, fi guras, etc.
Relatrios 487
Prvia de impresso do Relatrio
Configuraes da Prvia de Impresso
CONE DESCRIO
Tabel a de contedo do Rel atri o.
I mpri me o Rel atri o, abri ndo a
Tel a de confi gurao de
i mpresso.
Copi a o contedo sel eci onado.
Procura um texto especfi co no
Rel atri o.
Vi sual i zao de uma pgi na
si mpl es do Rel atri o.
Vi sual i zao de ml ti pl as
pgi nas do Rel atri o.
488 Relatrios
CONE DESCRIO
Menos zoom na pgi na.
Mai s zoom na pgi na.
Porcentagem de zoom na pgi na.

Pgi na anteri or e Prxi ma pgi na.
22.3.2 Report Settings
Atravs desta opo, possvel confi gurar as especi fi caes do Rel atri o, tai s
como confi guraes de pgi na, i mpresso, grade e esti l o do Rel atri o.
A opo Page Setup confi gura as especi fi caes referentes pgi na do Rel atri o.
Configuraes de pgina do Relatrio
Opes de configurao de Page Setup (pgina)
OPO DESCRIO
Top Margin
Determi na a margem do topo da pgi na.
Bottom Margin
Determi na a margem do contedo da
pgi na.
Left Margin
Determi na a margem esquerda da
pgi na.
Right Margin
Determi na a margem di rei ta da pgi na.
Relatrios 489
OPO DESCRIO
Gutter
Determi na a margem da pgi na.
Mirror Margins
Habi l i ta ou desabi l i ta a margem
espel hada da pgi na.
A opo Printer Settings confi gura as especi fi caes referentes i mpresso do
Rel atri o.
Configuraes de impresso do Relatrio
Opes de configurao de Printer Settings (Impressora)
OPO DESCRIO
Paper Size
Determi na o tamanho do papel .
Width
Determi na a l argura do papel .
Height
Determi na a al tura do papel .
Orientation
Determi na a ori entao do papel na
i mpressora (Printer Default -
Confi guraes de acordo com a
i mpressora padro; Portrait - Layout da
pgi na na verti cal ; Landscape - Layout da
pgi na na hori zontal ).
Collate
Ordena a i mpresso.
Duplex
Dupl i ca a i mpresso.
PaperBin
Determi na as confi guraes e o ti po de
papel para a i mpresso.
490 Relatrios
A opo Grid Settings determi na as confi guraes referentes s grades do
Rel atri o.
Configuraes da grade do Relatrio
Opes de configurao de Grid Settings (grade)
OPO DESCRIO
Show Grid
Habi l i ta ou desabi l i ta a grade.
Align Controls to Grid
Habi l i ta ou desabi l i ta o al i nhamento
dos control es na grade.
Grid Columns
Determi na o nmero de col unas na
grade.
Grid Rows
Determi na o nmero de l i nhas na grade.
Ruler Units
Determi na o ti po de uni dade da rgua
(pi xel s ou centmetros).
A opo Styles determi na as confi guraes referentes ao esti l o do Rel atri o.
Relatrios 491
Configuraes de estilo do Relatrio
Opes de configurao de Styles (estilos)
OPO DESCRIO
New / Delete / Lista
Determi na o esti l o do Rel atri o. Pode-se
i nseri r um novo esti l o (cl i cando em New),
apagar um esti l o (cl i cando em Delete) ou
uti l i zar os esti l os exi stentes na l i sta.
Font / Colors / Misc
Determi na as especi fi caes do esti l o
do Rel atri o (fontes, cores de fundo e
frente, ori entao, etc.).
22.3.3 Script Editor
O Editor de Scripts (Scri pt Edi tor) uti l i zado para cri ar scri pts nos Rel atri os do E3.
A l i nguagem uti l i zada para cri ar os scri pts no Rel atri o a Acti ve Scri pti ng, que
i nterage com o Vi sual Basi c. Quando o Edi tor de Scri pts est aberto, di sponi bi l i za
os mtodos e eventos dos objetos e componentes do Rel atri o. Para uti l i zar este
recurso, cl i que em Script Editor , di sponvel na barra de ferramentas Relatrio.
492 Relatrios
Editor de Scripts
No campo Object necessri o especi fi car o objeto onde se deseja cri ar o scri pt e
no i tem Events, o evento do Rel atri o em que ocorrer a ao.
22.3.4 Carregar Arquivo RPX
Importa a confi gurao do Rel atri o de um arqui vo externo.
22.3.5 Salvar Arquivo RPX
Exporta a confi gurao do Rel atri o para um arqui vo externo.
22.3.6 Objetos
Esta seo contm i nformaes sobre os objetos que podem ser usados em um
Rel atri o.
22.3.6.1 Linha
O objeto Linha l i ga doi s pontos quai squer. Permi te o desenho de retas, atravs de
doi s pontos especi fi cados na sua cri ao ou em pol gonos.
Linha
Aps ser i nseri do no Rel atri o, este objeto ser chamado de Line.
Relatrios 493
22.3.6.2 Retngulo
O objeto Retngulo permi te o desenho de retngul os, uti l i zando toda a l argura ou
al tura do objeto. Cri ado a parti r de doi s vrti ces.
Retngulo
Aps ser i nseri do no Rel atri o, este objeto ser chamado de Shape.
22.3.6.3 Retngulo Arredondado
O objeto Retngulo Arredondado um retngul o cri ado a parti r de doi s vrti ces,
com cantos arredondados a parti r de um fator de arredondamento.
Ao ser i nseri do ou edi tado, exi be um pequeno ponto prxi mo ao seu canto superi or
esquerdo, que permi te modi fi car o fator de arredondamento.
Retngulo arredondado
22.3.6.4 Elipse
O objeto Elipse permi te o desenho de crcul os e el i pses, uti l i zando toda a l argura ou
a al tura e defi ni ndo o centro do crcul o no centro do retngul o.
Elipse
494 Relatrios
22.3.6.5 Figura
O objeto Figura permi te mostrar i magens que estejam armazenadas em arqui vos,
tanto em arqui vos externos como em arqui vos de recurso do apl i cati vo.
Figura
Aps ser i nseri do no Rel atri o, este objeto ser chamado de Image.
22.3.6.6 Texto
O objeto Texto possi bi l i ta a cri ao de um texto. Ao defi ni r a rea na Tel a, pode-se
di gi tar di retamente o texto desejado, que acei ta tambm ml ti pl as l i nhas.
Texto
Aps ser i nseri do no Rel atri o, este objeto ser chamado de Label.
22.3.6.7 Campo de Dados
O objeto Campo de Dados uti l i zado para i nseri r um dado do Banco de Dados no
Rel atri o. Este dado i ndi cado atravs da propri edade DataField.
Campo de Dados
Aps ser i nseri do no Rel atri o, este objeto ser chamado de Field.
Relatrios 495
22.3.6.7.1 Exemplo de Utilizao
O exempl o a segui r demonstrar como mostrar a mdi a por di a de um campo da
consul ta no Rel atri o. Para tanto, si ga estes procedi mentos:
1. Insi ra um novo GroupHeader/Footer no Rel atri o.
2. Confi gure a propri edade DataField do GroupHeader para "=Day(E3Ti meStamp").
Isto determi na que o cl cul o da mdi a ser fei to por di a.
3. Insi ra um Campo de Dados no GroupHeader com a propri edade DataField i gual
a "=Day(E3Ti meStamp").
4. Insi ra um Campo de Dados no GroupFooter com a propri edade DataField i gual
ao nome do campo que ser cal cul ada a mdi a.
5. Confi gure as segui ntes propri edades do Campo de Dados do GroupHeader:
SummaryFunc: 1 - ddSFAvg
SummaryGroup: GroupHeader1
SummaryRunning: 1 - ddSRGroup
SummaryType: 3 - ddSMSubTotal
22.3.6.8 Caixa de Seleo
O objeto Caixa de seleo i nsere um dado no Rel atri o que pode ou no estar l i gado
ao Banco de Dados. Seu val or ser um Bool eano.
Caixa de seleo
Aps ser i nseri do no Rel atri o, este objeto ser chamado de CheckBox.
22.3.6.9 Cdigo de Barras
O objeto Cdigo de Barras permi te gerar uma fi gura que converte uma sequnci a de
nmeros e caracteres em um cdi go de barras. Este cdi go de barras uma
representao numri ca ou al fanumri ca, uti l i zada para faci l i tar di ferentes
processos. Este cdi go deci frado atravs de scanners, canetas e equi pamentos de
l ei tura pti ca.
496 Relatrios
Cdigo de barras
Aps ser i nseri do no Rel atri o, este objeto ser chamado de Barcode.
22.3.6.10 Quebra de Pgina
O objeto Quebra de pgina um ponto em que uma pgi na termi na e outra comea
no Rel atri o. Por exempl o, pode-se forar uma quebra de pgi na para assegurar
que o ttul o de um captul o comece sempre em uma nova pgi na. Ao trabal har com
documentos que contenham di versas pgi nas e i nseri r quebras de pgi na manuai s,
tal vez seja necessri o rei nseri -l as com frequnci a medi da que se edi ta o
documento. Tambm pode-se i mpedi r que uma quebra de pgi na ocorra em um
pargrafo ou em uma l i nha de tabel a, ou ai nda assegurar que uma quebra de
pgi na no seja i nseri da entre doi s pargrafos, como entre um ttul o e o pargrafo
segui nte.
Quebra de Pgina
22.3.6.11 Quadro
O objeto Quadro composto de l i nhas e col unas onde so i nseri dos textos ou
grfi cos. Os quadros dos Rel atri os so usados para organi zar e apresentar
i nformaes. Pode-se tambm usar quadros para cri ar di sposi es de pgi na, ou
cri ar o texto, grfi cos e tabel as ani madas como em uma pgi na em HTML.
Relatrios 497
Quadro
Aps ser i nseri do no Rel atri o, este objeto ser chamado de Frame.
22.3.6.12 E3Chart
O objeto E3Chart um componente Acti veX uti l i zado para exi bi r um grfi co
mostrando Tags vari ando em tempo real e tambm mostrar dados hi stri cos
gravados em um Banco de Dados.
E3Chart
NOTA: O E3Chart no pode ser adi ci onado na Seo Detail do Rel atri o.
Exi stem al gumas di ferenas de funci onamento entre o E3Chart na apl i cao e no
Rel atri o. Na apl i cao, o E3Chart consegue pl otar grfi cos em tempo real ,
hi stri co e mi sto. J quando este objeto uti l i zado em um Rel atri o, no
permi ti da sua uti l i zao com dados em tempo real ou mi stos, somente com dados
hi stri cos.
Note que nenhum objeto do Rel atri o pode ser acessado externamente, ou seja, ao
se cri ar o Rel atri o pel o apl i cati vo, no possvel acessar suas propri edades nem
498 Relatrios
tampouco as de seus objetos vi a scri pts do apl i cati vo. Por i sso, as al teraes nos
objetos, i ncl ui ndo o E3Chart, devem ser fei tas di retamente no E3 Studi o ou em
eventos do prpri o Rel atri o.
Para mai ores i nformaes sobre este objeto, veja o captul o E3Chart.
22.4 Criando um Relatrio no E3
Esse exempl o contempl a a cri ao de um Rel atri o no E3 para extrao de dados
de um Hi stri co.
22.4.1 Definio de reas
O Rel atri o padro, cri ado quando i nseri do um novo Rel atri o ao projeto, tem as
segui ntes reas:
Page Header: rea mostrada em todas as pgi nas do Rel atri o, como cabeal ho
Detail Area: rea repeti da tantas vezes quantas forem necessri as, o corpo do
Rel atri o
Page Footer: Rodap da pgi na, trabal ha do mesmo modo que o Page Header
Exi stem ai nda doi s ti pos de reas:
Report Header/Footer: reas que so i mpressas uma ni ca vez, no i mportando
o tamanho do Rel atri o em pgi nas. El a vem como abertura ou fechamento do
Rel atri o
Group Header/Footer: Um grupo uti l i zado para di vi di r no Rel atri o conjuntos
de val ores i guai s de uma mesma vari vel . Essa rea se repeti r sempre que um
grupo for apresentado. No exempl o aqui demonstrado no uti l i zada nenhuma
construo desse ti po. Essa rea sempre envol ve uma rea de detal hes
Essas duas reas podem ser acessadas cl i cando com o boto di rei to do mouse no
Rel atri o e sel eci onando a opo Insert.
22.4.2 Configurao da Consulta
Para a extrao de dados de um Banco de Dados, necessri o confi gurar a
consul ta do Rel atri o. Podem exi sti r vri as consul tas di ferentes para o mesmo
Rel atri o, sendo que apenas uma pode estar ati va em determi nado momento. Para
tanto, deve-se segui r estes procedi mentos:
1. Confi gure a propri edade DataSource (nome do Banco de Dados onde ser fei ta
a consul ta. Nesse caso, ServidorDB).
2. Determi ne a propri edade Table (tabel a de consul ta, aqui ser Dados).
Relatrios 499
3. Confi gure a propri edade Name (fi car com o nome ori gi nal , Consulta1).
22.4.3 Configurao dos Campos
Nesse exempl o foram cri adas quatro temperaturas sendo armazenadas em um
Hi stri co e essas temperaturas so o objeto de i nteresse do nosso Rel atri o. Sendo
assi m, os val ores l i dos do Hi stri co sero i mpressos atravs do Rel atri o.
Para l er dados de um Banco de Dados, a rea i deal a Detail Area, vi sto que essa
rea repeti da automati camente quantas vezes se fi zerem necessri as. Dessa
manei ra, devero ser i nseri dos ci nco Campos de Texto nessa rea. Esses campos
podem ser l i gados a um Campo de Dados, que confi gurado atravs da
propri edade DataField. Aqui , sero usados os segui ntes val ores:
Field1: E3Ti mestamp
Field2: Temperatura1 (como est no Banco de Dados)
Field3: Temperatura2
22.4.4 Visualizao
possvel fazer a vi sual i zao do Rel atri o cri ado cl i cando-se em Preview ,
di sponvel na rea de edi o.
Para tanto, necessri o di reci onar o servi dor de Banco de Dados do projeto para o
arqui vo MDB da pasta onde foi sal vo o exempl o.
22.5 Exemplos de Utilizao
A segui r so mostrados al guns exempl os de uti l i zao dos recursos dos Rel atri os.
22.5.1 Configurando o Caminho de um Bitmap na
Impresso
Para uti l i zar este recurso, escreva o segui nte scri pt no evento OnFormat das
Sees PageHeader ou ReportHeader:
Sub OnFormat
Report.Sections("ReportHeader").Controls("Image2").Picture =
_
LoadPicture ("C:\correio\teste.bmp")
End Sub
22.5.2 Configurando o Valor de um Cdigo de
Barras na Seo Detail
Para uti l i zar este recurso, escreva o scri pt a segui r no evento OnFormat da Seo
Detail:
500 Relatrios
Sub OnFormat
Report.Sections("Detail").Controls("BarCode1")
Caption = Right(Report.Field ("E3TimeStamp"), 8)
End Sub
22.5.3 Capturando uma Tela e Gerando uma Prvia
de Impresso
Para uti l i zar este recurso, di gi te o segui nte scri pt:
Sub Rect_Click()
' Esta chamada de mtodo tambm pode ser feita
' utilizando-se Application.CaptureScreen()
Screen.Frame.CaptureScreen("C:\correio\teste.bmp")
Application.LoadReport("[Relatrio3]").PrintPreview()
End Sub
22.5.4 Gerando um Menu Exportar
Para uti l i zar este recurso, escreva o segui nte scri pt:
Sub Retangulo3_Click()
Set report = Application.LoadReport("[Relatrio3]")
Select Case _
Application.SelectMenu("PDF|Excel|HTML|RTF|Texto|_
TIFF|Texto(CSV)")
Case 1
Report.Export "PDF", "C:\correio\reports\report.pdf"
MsgBox "Exportado para PDF!"
Case 2
Report.Export "EXCEL", "C:\correio\reports\report.XLS"
MsgBox "Exportado para XLS!"
Case 3
Report.Export "HTML", "C:\correio\reports\report.html"
MsgBox "Exportado para HTML!"
Case 4
Report.Export "RTF", "C:\correio\reports\report.rtf"
MsgBox "Exportado para RTF!"
Case 5
Report.Export "TEXT", "C:\correio\reports\report.txt"
MsgBox "Exportado para Texto (CSV)!"
Case 6
Report.Export "TIFF", "C:\correio\reports\report.tiff"
MsgBox "Exportado para TIFF!"
Case 7
Set reportFilter = report.GetExportFilter("TEXT")
reportFilter.FileName="C:\correio\reports\_
report2.txt"
reportFilter.TextDelimiter = ","
report.Export reportFilter
MsgBox "Exportado para TXT usando filtro!"
Relatrios 501
End Select
End Sub
22.5.5 Como Criar Relatrios Mostrando Pgina N
de M
Para cri ar um Rel atri o que a cada pgi na i mpri me um i ndi cati vo de Pgina N de M
onde N a pgi na atual e M o total de pgi nas, cri e doi s Label s e doi s Campos de
Dados.
Os doi s Label s correspondem aos textos Pgina e de, que devem ser i nseri dos na
propri edade Caption. Os doi s Campos de Dados correspondem aos val ores N e M,
com as segui ntes propri edades:
Campo N
Name: txtPageNumber
SummaryType: 4 - ddSMPageCount
Campo M
Name: txtPageCount
SummaryType: 4 - ddSMPageCount
22.5.6 Como Criar Relatrios Imprimindo somente
Mdias de Valores a cada 5 Minutos
Para i sso deve-se cri ar um novo grupo no Rel atri o. O grupo cri ado tem uma Seo
Header e uma Seo Footer. O layout geral :
PageHeader: Contm o ti tul o das col unas
GroupHeader: Fi ca vazi o, porm a sua propri edade DataField tem o val or i gual a
"CLng(E3TimeStamp*288)", i sso porque o E3TimeStamp a data e hora do
dado no formato gregori ano (di as desde 1/1/1900), sendo a parte i ntei ra o
nmero de di as e a parte fraci onri a as horas e os mi nutos. Mul ti pl i cando por
288 teremos um nmero i ntei ro correspondente ao total de ci nco mi nutos desde
1/1/1900. A funo CLng converte para um nmero i ntei ro de 32 bi ts el i mi nando
a parte fraci onri a, de modo que no apaream os mi nutos e segundos
i ntermedi ri os. O grupo cri ado vai ser i mpresso cada vez que esse nmero
i ntei ro mudar, ou seja, a cada ci nco mi nutos. Veri fi que as propri edades
NewColumn e NewPage, que devem estar em 0 - ddNPNone
502 Relatrios
Detail: Contm os Campos de Dados para os campos da tabel a. A propri edade
Visible estar em Fal so, de modo que cada uma das aqui si es que comporo a
mdi a de ci nco mi nutos sero computadas, porm no i mpressas
GroupFooter: Contm campos que representam as mdi as dos Campos de Dados.
Para i sso:
DataField: Nomes dos campos da tabel a (o mesmo que na Seo Detail)
SummaryFunc: 1 - ddSFAvg
SummaryType: 1 - ddSGrandTotal
A ni ca exceo para a Data/Hora que ser um Campo de Dados padro com a
propri edade DataField i gual a "=CLng(E3TimeStamp*288)/288".
ReportFooter: Em branco (ou outro val or qual quer)
Se a consul ta for entre 00:00 de um di a e outro, o resul tado sero 288 l i nhas
i mpressas com a mdi a dos campos a cada ci nco mi nutos.
Segurana 503
23
Segurana
CAPTULO
Atravs desta opo, possvel control ar o acesso a Tel as, Al armes, Domni os e
Vi ewer em uma l i sta de usuri os e grupos. Conforme a opo confi gurada, a
apl i cao permi ti r ou no o acesso aos usuri os cadastrados.
As permi sses de acesso so confi guradas por usuri o ou por grupos de usuri os.
Os grupos podem ser cri ados contendo apenas usuri os ou tambm outros grupos.
Para acessar as confi guraes de usuri os, grupos ou permi sses, si ga estes
procedi mentos:
1. Abra o menu Arquivo - Usurios. Ser mostrada uma cai xa de di l ogo para
confi gurao das permi sses, dos usuri os e dos grupos na apl i cao.
504 Segurana
Janela Permisses de usurio
23.1 Usurios
Atravs da aba Usurios possvel confi gurar as i nformaes referentes aos
usuri os que tero ou no acesso apl i cao. Para uti l i zar este recurso, cl i que no
menu Arquivo - Usurios, e sel eci one a aba Usurios.
Segurana 505
Aba Usurios
Opes disponveis na aba Usurios
OPO DESCRIO
Nome
I ndi ca o usuri o corrente.
Novo
Cri a um novo usuri o.
Editar
Edi ta as propri edades do usuri o
sel eci onado.
Remover
Remove o usuri o sel eci onado.
Grupos disponveis
Mostra os grupos de usuri os
di sponvei s na apl i cao.
Pertence a
Mostra os grupos aos quai s o usuri o
pertence.
506 Segurana
OPO DESCRIO
Adicionar
Adi ci ona grupos da l i sta Grupos
disponveis para a l i sta Pertence a.
Remover
Remove grupos da l i sta Pertence a.
Ao cl i car em Novo ou Editar, a segui nte cai xa de di l ogo mostrada:
Segurana 507
Adicionando usurios na aplicao
As opes di sponvei s desta janel a so as segui ntes:
508 Segurana
Opes disponveis na janela Adicionar usurios
OPO DESCRIO
Nome
Determi na o nome do usuri o.
Autenticao do Windows
Esta opo permi te adi ci onar um usuri o
exi stente no domni o de rede do
Wi ndows. O nome do usuri o deve estar
no formato DOM NI O\USURI O. Ao
sel eci onar esta opo, todas as demai s
opes da janel a fi cam desabi l i tadas,
exceto Este usurio um administrador e
Esta conta est desabilitada.
Autenticao do E3
Esta opo cri a o usuri o no Domni o
corrente do E3.
Senha
Determi na a senha do usuri o.
Confirme a senha
Reconfi rmao da senha anteri ormente
i nformada.
Nome completo
Determi na o nome compl eto do usuri o.
Este usurio um administrador
Habi l i ta o usuri o como admi ni strador.
O usurio no pode alterar sua senha
O usuri o no pode al terar a sua senha,
poi s somente o admi ni strador pode
executar esta tarefa.
do usuri o. Quando a data de expi rao
esti ver prxi ma, ser mostrado um
l embrete para renovar a senha. Caso
deseje renov-l a, uma cai xa de di l ogo
ser aberta para que o usuri o faa a
confi gurao da senha. Se a senha
expi rar antes do usuri o renov-l a, no
ser mai s possvel executar o login, e a
opo Esta conta est bloqueada ser
habi l i tada automati camente. Esta
condi o persi ste at que um
admi ni strador desbl oquei e a senha
manual mente.
Determi na um nmero mni mo de
Determi na que a senha deve conter
l etras e nmeros.
nmeros para a senha do usuri o.
Determi na um nmero mni mo de l etras
para a senha do usuri o.
minsculas
l etras mai scul as e mi nscul as.
Esta conta est desabilitada
I ndi ca que a conta est desabi l i tada.
Segurana 509
OPO DESCRIO
Esta conta est bloqueada
I ndi ca que a conta do usuri o est
bl oqueada. Esta opo habi l i tada
automati camente caso a senha do
usuri o expi re ou se o usuri o di gi tar a
senha errada vri as vezes.
O usurio deve trocar a senha no prximo
login
I ndi ca que o usuri o dever trocar sua
senha quando for executar o prxi mo
login.
minsculas
Permi te a val i dao de senhas,
i ndependente de seus caracteres serem
di gi tados em mai scul as ou mi nscul as.
Esta opo no recomendada.
Ao efetuar o l ogi n do usuri o (pel o mtodo Login do Vi ewer ou pel o menu Arquivo -
Login), abre-se a segui nte cai xa de di l ogo:
Janela de login
Ao sel eci onar o modo de autenti cao Windows, os campos Nome do usurio e
Senha so desabi l i tados e preenchi dos com o nome e a senha do usuri o l ogado no
domni o de rede. Para sel eci onar outro usuri o pertencente ao domni o de rede,
cl i que em Outro usurio. Sel eci onando o modo de autenti cao E3, basta preencher
as i nformaes de usuri o e senha de um usuri o do Domni o do E3 nos campos
Nome do usurio e Senha, respecti vamente.
Quando a opo Este usurio um administrador habi l i tada para um usuri o,
este usuri o poder, em tempo de execuo, al terar todas as confi guraes
mostradas na aba Usurios.
Estes pri vi l gi os so acessados vi a scri pt atravs do mtodo UserAdministration
510 Segurana
do Vi ewer, que habi l i ta a cai xa de di l ogo dos usuri os em tempo de execuo.
NOTA: Apenas o admi ni strador tem acesso ao mtodo UserAdministration do Vi ewer.
Ao cl i car em Remover, a apl i cao mostra uma cai xa de mensagem questi onando
se real mente deseja-se remover o usuri o.
possvel que um usuri o pertena a um grupo, podendo assi m comparti l har as
confi guraes deste grupo. Para tanto, na l i sta Grupos disponveis so mostrados
os grupos di sponvei s na apl i cao que podero conter o usuri o sel eci onado, e na
l i sta Pertence a, a l i sta dos grupos aos quai s o usuri o sel eci onado j pertence.
Para adi ci onar um usuri o a um grupo, si ga estes procedi mentos:
1. Sel eci one o usuri o que deseja i nseri r no grupo especfi co.
2. Na l i sta Grupos disponveis, sel eci one o grupo ao qual o usuri o i r pertencer.
3. Cl i que em Adicionar, para adi ci onar o grupo, que aparecer na l i sta Pertence a.
4. Para remover o grupo, basta sel eci on-l o na l i sta Pertence a e cl i car em
Remover.
23.2 Grupos
A aba Grupos permi te que sejam confi guradas as i nformaes referentes aos
grupos. Cada grupo defi ne caractersti cas que sero comuns para todos os seus
membros. Um grupo tambm pode pertencer a outros grupos. S no permi ti do
pertencer a outro grupo que j pertena a el e, ou seja, cri ando uma refernci a
ci rcul ar.
Para uti l i zar este recurso, cl i que no menu Arquivo - Usurios e sel eci one a aba
Grupos.
Segurana 511
Aba Grupos
Opes disponveis na aba Grupos
OPO DESCRIO
Nome
I ndi ca o grupo corrente.
Novo
Cri a um novo grupo.
Editar
Edi ta as propri edades do grupo
sel eci onado.
Remover
Remove o grupo sel eci onado.
Grupos disponveis
Mostra os grupos di sponvei s na
apl i cao.
Pertence a
Mostra os grupos aos quai s o grupo
sel eci onado pertence.
512 Segurana
OPO DESCRIO
Adicionar
Adi ci ona grupos da l i sta Grupos
disponveis na l i sta Pertence a.
Remover
Remove grupos da l i sta Pertence a.
Ao cl i car em Novo ou Editar, a segui nte cai xa de di l ogo mostrada:
Adicionar grupo
Opes disponveis na janela Adicionar Grupos
OPO DESCRIO
Nome do grupo
Determi na o nome do grupo.
O usurio no pode alterar sua senha
O usuri o no pode al terar sua senha,
poi s somente o admi ni strador pode
executar esta tarefa.
do usuri o.
Segurana 513
OPO DESCRIO
l etras e nmeros.
nmeros para a senha do usuri o.
Determi na um nmero mni mo de l etras
para a senha do usuri o.
minsculas
l etras mai scul as e mi nscul as.
minsculas
Permi te a val i dao de senhas,
i ndependente de seus caracteres serem
di gi tados em mai scul as ou mi nscul as.
Ao cl i car em Remover, a apl i cao mostra uma cai xa de mensagem perguntando se
real mente deseja-se excl ui r o grupo sel eci onado.
possvel que um grupo de usuri os pertena a outro, podendo assi m comparti l har
as confi guraes. Para tanto, na l i sta Grupos disponveis so mostrados os grupos
di sponvei s na apl i cao que podero conter o grupo sel eci onado, e no i tem
Pertence a, a l i sta dos grupos aos quai s o grupo sel eci onado pertence. Para
adi ci onar um grupo a outro especfi co, si ga estes procedi mentos:
1. Sel eci one o grupo que deseja i nseri r em um grupo especfi co.
2. Na l i sta Grupos disponveis, sel eci one o grupo ao qual o grupo i r pertencer.
3. Cl i que em Adicionar para adi ci onar o grupo, que aparecer na l i sta Pertence a.
4. Para remover o grupo, basta sel eci on-l o na l i sta Pertence a e cl i car em
Remover.
NOTA: i mportante veri fi car a hi erarqui a entre usuri os e grupos. Se o usuri o tem
uma opo desabi l i tada, mas esta mesma opo est habi l i tada no grupo, val e a
opo do usuri o, que possui este i tem desabi l i tado. A opo do grupo s ser
respei tada se a mesma opo do usuri o esti ver marcada como neutra.
23.3 Permisses
A aba Permisses permi te confi gurar as permi sses dos usuri os e grupos para
Tel as, Al armes, Domni os e Vi ewers. Uma veri fi cao de permi sso consi ste em
uma i nformao que um membro de um grupo tem sobre um comando que atua
sobre um objeto especfi co.
514 Segurana
Aba Permisses
Opes disponveis na aba Permisses
OPO DESCRIO
Usurios/Grupos
Esta opo l i sta os usuri os ou grupos de
usuri os confi gurados na apl i cao.
Segurana 515
OPO DESCRIO
Itens para segurana
Os i tens para segurana di sponvei s so:
Telas: Permi te ao usuri o habi l i tar ou
desabi l i tar o acesso s Tel as. Em uma
apl i cao, todos os usuri os ou grupos
tm acesso Tel a de abertura
Alarmes: Habi l i ta ou desabi l i ta o
reconheci mento de al armes para o
usuri o ou grupo. Em um projeto,
possvel exi bi r as i nformaes de
al armes para vri os assi nantes das
i nformaes atravs de um objeto de
vi sual i zao em Tel a, como por exempl o
o E3Al arm
Domnios: Permi te confi gurar permi sses
para executar, parar ou edi tar um
Domni o, ter acesso remoto a um
Domni o, entre outras permi sses
Viewer: Permi te ao usuri o uti l i zar o
Vi ewer em modo Viewer Full ou Viewer
Only, de acordo com suas confi guraes
Usurios
um fi l tro das opes de confi gurao.
Habi l i tando esta opo, possvel
vi sual i zar somente os usuri os
cadastrados na apl i cao.
Grupos
um fi l tro das opes de confi gurao.
Habi l i tando esta opo, possvel
vi sual i zar somente os grupos cadastrados
na apl i cao.
Permisses
Mostra as permi sses dos usuri os ou
grupos quanto aos i tens de segurana
(Tel as, Al armes, Domni os e Vi ewers).
Desabilitar a verificao de permisses
Desabi l i ta qual quer veri fi cao de
permi sses. Veja a nota a segui r sobre o
comportamento desta opo.
NOTA: A opo Desabilitar a verificao de permisses deve ser uti l i zada com cui dado,
poi s i mpl i ca nos segui ntes comportamentos:
O l ogi n sempre funci onar, mesmo que a senha esteja errada ou que seja
uti l i zado um nome de usuri o i nexi stente
As aes sempre sero permi ti das, mesmo para usuri os anni mos
Para cada i tem de segurana, exi ste uma sri e de permi sses que podem ser
confi guradas para cada usuri o ou grupo. As opes di sponvei s so as segui ntes:
Opes disponveis para Telas
OPO DESCRIO
Abrir Tela
Habi l i ta a abertura de Tel as.
516 Segurana
Opes disponveis para Alarmes
OPO DESCRIO
Reconhecer alarme
Habi l i ta o reconheci mento de al armes.
Opes disponveis para Domnios
OPO DESCRIO
Executar Domnio
Habi l i ta a execuo de um Domni o.
Parar Domnio
Para o Domni o.
Editar Domnio
Habi l i ta a edi o de um Domni o.
Executar como servio
Habi l i ta a execuo do Domni o como um
servi o.
Configurar usurios/grupos
Permi te confi gurar usuri os e grupos de
usuri os.
Acesso remoto ao Domnio
Habi l i ta o acesso remoto a um Domni o.
Acesso remoto de escrita ao Domnio
Habi l i ta o acesso remoto de escri ta a um
Domni o.
Opes disponveis para Viewers
OPO DESCRIO
Acesso de escrita ao servidor
Habi l i ta o acesso de escri ta ao servi dor.
Cada i tem da l i sta de permi sses pode estar confi gurado com um dos estados a
segui r:
Opes da lista de permisses
CONE ESTADO DESCRIO
Permitido (crculo verde
slido)
O comando sel eci onado
na l i sta de permi sses
permi ti do para o usuri o
ou grupo sel eci onado,
i ndependente dos grupos
aos quai s el e pertence.
No permitido (crculo
vermelho slido)
no permi ti do para o
usuri o ou grupo
sel eci onado,
i ndependente dos grupos
aos quai s el e pertence.
Segurana 517
CONE ESTADO DESCRIO
Permitido pelo grupo (crculo
verde vazado)
ser permi ti do para o
usuri o ou grupo
sel eci onado, se el e for
permi ti do nos grupos aos
quai s o usuri o ou grupo
pertence.
No permitido pelo grupo
(crculo vermelho vazado)
no ser permi ti do para o
usuri o ou grupo
sel eci onado, se el e no
for permi ti do em pel o
menos um dos grupos aos
quai s o usuri o ou grupo
pertence.
No informado
O usuri o ou grupo
sel eci onado uti l i zar as
defi ni es dos grupos aos
quai s pertence e no h
nada i nformado nos
grupos. Portanto, o
comando permi ti do.
No caso de Tel as, possvel que a confi gurao de permi sso seja fei ta por Tel a
especi fi camente. No caso de Al armes, essa confi gurao pode ser fei ta por rea.
NOTA: Em uma apl i cao, todos os usuri os tm acesso Tel a de abertura. Caso
deseje que a apl i cao sempre i ni ci e com a tel a de login do usuri o, cri e um
usuri o sem permi sso especfi ca na Tel a i ni ci al . Assi m, toda vez que for i ni ci ada
a apl i cao, o si stema pedi r o login do usuri o e aps, mostrar a Tel a de
abertura.
Com rel ao a permi sses para um usuri o anni mo, devem ser observadas as
segui ntes si tuaes:
Se no h usuri o cri ado, a veri fi cao de permi sses no est habi l i tada ou
no h usuri o com restri o para uma determi nada operao, ento no ser
exi gi da i denti fi cao (o usuri o ser l ogado como anni mo)
Se h usuri o cri ado, a veri fi cao est habi l i tada e h pel o menos um usuri o
que no possa executar determi nada operao, ento para esta operao ser
exi gi da i denti fi cao (no ser permi ti do o acesso como usuri o anni mo)
518 Segurana
NOTA: A nomencl atura e descri o das opes de restri o podem ser acessadas
atravs da opo Legenda.
Caso haja al guma restri o para executar, parar, edi tar um Domni o ou confi gurar
os usuri os ou grupos, necessri o que um usuri o esteja l ogado no E3. Para
tanto, uti l i zam-se as opes Login ou Logout, di sponvei s no menu Arquivo.
Login ou Logout do usurio
A opo Login abre uma cai xa de di l ogo para o login no E3 Studi o. O usuri o
permanece l ogado at que seja fei to outro login ou logout.
A opo Logout executa o logout no E3 Studi o. Caso no haja um usuri o l ogado,
esta opo estar desabi l i tada.
23.4 Proteo de Arquivos
Protege o contedo de um arqui vo .prj ou .l i b contra a edi o, vi sual i zao ou
execuo no autori zada. Para uti l i zar este recurso, si ga estes procedi mentos:
1. Cl i que com o boto di rei to do mouse sobre o nome do projeto ou da bi bl i oteca
no Expl orer e sel eci one a opo Proteo. No modo Domnio, cl i que com o
boto di rei to do mouse no nome do projeto ou da bi bl i oteca, no i tem
Segurana 519
Configurao - Arquivos, e sel eci one a opo Proteo.
2. A apl i cao abre uma cai xa de di l ogo com as opes a segui r:
Proteo de arquivos
Esta opo possui doi s ti pos de proteo: Proteo de Edio e Proteo de
Execuo.
Proteo de Edio: Protege o arqui vo contra al teraes e vi sual i zaes no
autori zadas. Este recurso uti l i zado para evi tar que determi nada bi bl i oteca ou
projeto seja al terado aci dental mente, ou que sejam copi ados procedi mentos de
520 Segurana
conheci mento especfi co do desenvol vedor
A opo Adicionar proteo permi te confi gurar uma senha de proteo para a
apl i cao.
Adicionar proteo
A opo Alterar senha al tera a senha de proteo do E3 Studi o para o arqui vo.
Alterao de senha de proteo
A opo Remover proteo remove a proteo de edi o deste arqui vo. Para tanto,
basta cl i car nesta opo, di gi tar a senha e cl i car em OK, que a apl i cao abri r
uma cai xa de mensagem i nformando se a ao foi executada corretamente.
Proteo de Execuo: Esta opo uti l i zada para proteger o arqui vo contra
execuo no autori zada. Para tanto, necessri o sol i ci tar a gravao de uma
senha no di sposi ti vo de proteo, que fei ta pel a El i pse Software. Isto protege o
desenvol vedor de cpi as no autori zadas do projeto, por exempl o. Para i sso, no
momento do pedi do de l i cena do E3 Server, necessri o fornecer a senha de
execuo. Este processo fei to posteri ormente compra do servi dor
A opo Adicionar proteo permi te confi gurar uma senha de proteo para a
Segurana 521
apl i cao.
Adicionar proteo
A opo Alterar senha al tera a senha de proteo de execuo para o arqui vo.
Alterao de senha de proteo
A opo Remover proteo permi te remover a proteo de execuo deste arqui vo.
Para tanto, basta cl i car na opo, di gi tar a senha e cl i car em OK, que a apl i cao
abri r uma cai xa de mensagem i nformando se a ao foi executada corretamente.
Quando um arqui vo .l i b ou .prj aberto no E3 Studi o, este i ni ci al i za mostrando um
cone ci nza , com um cadeado i ndi cando que est protegi do e este contedo no
pode ser acessado. Para acessar o contedo do arqui vo, cl i que com o boto di rei to
do mouse sobre o projeto ou bi bl i oteca e sel eci one a opo Abrir com senha. Aps
i nformar a senha e a apl i cao l i berar o acesso, o cone fi ca col ori do ,
i ndi cando a acessi bi l i dade dos arqui vos.
O contedo de arqui vos .prj e .l i b protegi dos cri ptografado. Quando um projeto
protegi do, as propri edades DocString e Domain so bl oqueadas.
522 Segurana
IMPORTANTE: As protees i mpl ementadas no podem ser desfei tas caso as
senhas sejam perdi das. Portanto, ao proteger um arqui vo, mantenha as senhas
armazenadas em l ocal seguro. I sso garante que se consegui r usar o arqui vo
sempre que necessri o.
E3 Viewer e E3 WebViewer 523
24
E3 Viewer e E3 WebViewer
CAPTULO
O E3 Viewer o ambi ente de vi sual i zao do E3. Nel e, possvel vi sual i zar a
execuo da apl i cao fei ta no E3 Studi o.
O E3 WebViewer um componente Acti veX que faz o navegador comportar-se como
o E3 Vi ewer, o que permi te a vi sual i zao e control e de apl i caes E3 vi a Internet.
Desta forma, possvel vi sual i zar e i nteragi r com um processo de cho de fbri ca
atravs de um navegador web comum. O navegador pode estar em qual quer
computador da rede que tenha acesso ao E3 Server.
Depoi s de i nstal ado, o E3 WebVi ewer vai funci onar exatamente como o E3 Vi ewer,
executando o download da apl i cao (Tel as, bi tmaps, etc.) para a mqui na l ocal .
Todas as funci onal i dades do E3 Vi ewer (E3Chart, E3Al arm, etc.) so suportadas
pel o E3 WebVi ewer.
E3 WebViewer em execuo (visualizao de uma aplicao)
524 E3 Viewer e E3 WebViewer
NOTA: Tanto o E3 Vi ewer quanto o E3 WebVi ewer acei tam as mesmas opes de
zoom descri tas no tpi co Zoom do captul o Telas e Objetos de Tela. Al m di sso, a
qual i dade grfi ca das Tel as pode ser modi fi cada, em tempo de execuo,
uti l i zando-se o menu contextual tanto do E3 Vi ewer quanto do E3 WebVi ewer e
sel eci onando uma das opes do menu Qualidade (todas as telas). Para mai ores
i nformaes, veja a propri edade RenderQuality do Vi ewer no Manual de Scripts.
24.1 Viewer Only (Modo Somente Leitura)
O modo Viewer Only (modo Somente Leitura, ou de acesso restri to) uma manei ra
de control ar o acesso que o Vi ewer tem ao servi dor (Domni o), em oposi o ao
modo Viewer Full, que no possui restri es de acesso.
Atravs da confi gurao da permi sso de usuri os (captul o sobre Segurana), e de
acordo com o ti po de l i cena de Vi ewer em uso (captul o sobre Domnios), o
servi dor i r determi nar se o Vi ewer est no modo Full (normal ) ou Only (restri to).
Quando el e est no modo Only, so apl i cadas di versas restri es quanto s aes
que podem ser escri tas no servi dor. Neste modo esto bl oqueados (seja por erro de
scri pt ou por gerar mensagem de erro):
Escri tas em geral em propri edades de objetos do servi dor atravs do Vi ewer por
Associ aes
Escri tas em geral em propri edades de objetos do servi dor atravs de scri pts do
Vi ewer
Mtodos SetValue e ToggleValue do Vi ewer (i ncl ui ndo-se a os Pi cks Carregar e
Inverter Valor)
Chamadas de mtodos de objetos do servi dor atravs de scri pts do Vi ewer
(excees a segui r)
Admi ni strao de usuri os atravs do Vi ewer (uso do mtodo
UserAdministration do Vi ewer)
Reconheci mento de al armes pel o E3Al arm
Uso dos mtodos LoadFormulaDlg, LoadFormulaValues e
LoadFormulaValuesQuiet do Vi ewer
Permanecem permi ti dos neste modo:
Lei turas de propri edades de objetos do servi dor, tanto por Associ aes como por
scri pts
Chamadas de mtodos consi derados no restri tos de objetos do servi dor em
scri pts do Vi ewer. So estes: Item (todos os objetos); Refresh (Grupo OPC);
FindUnit, FindValue, GetValueData e GetUnitData (Frmul a); GetAlarm (Fonte de
Al armes); GetE3QueryFields, GetADORecordSet e GetAsyncADORecordSet
(Consul ta); e GetObject (Servi dor de Apl i caes)
Mudanas do estado de Advise de Tags do servi dor
Mudana da prpri a senha (mtodo ChangePassword do Vi ewer)
24.1.1 Mudanas no Modo do Viewer
Para que o usuri o acesse o E3 no modo Somente Leitura, pel o menos uma destas
duas condi es deve ser verdadei ra:
Li cena em uso do ti po Viewer Only
Usuri o l ogado sem permi sso para o i tem Acesso de escrita ao servidor
i mportante l embrar que, no caso de no haver usuri o l ogado no Vi ewer (usuri o
anni mo), ser apl i cada a restri o de acesso, desde que pel o menos um ou mai s
usuri os tenham esta restri o.
Desta forma, cada vez que ocorre uma mudana de usuri o o modo de acesso do
Vi ewer pode ser mudado (e consequentemente a propri edade IsReadOnly), de
acordo com a combi nao do que permi ti do pel a l i cena em uso e a permi sso
do usuri o l ogado.
A mudana do modo de acesso tambm pode acontecer caso ocorra a reconexo do
Vi ewer, j que esta pode provocar tanto a mudana de l i cena (de Viewer Full para
Viewer Only, ou vi ce-versa) quanto a mudana das permi sses do usuri o l ogado.
Caso haja al gum usuri o com acesso de escri ta ao servi dor bl oqueado no
momento da abertura do Vi ewer, este entra automati camente no modo Somente
Leitura, i ndependentemente da l i cena em uso, j que o usuri o anni mo sempre
assume a restri o mxi ma confi gurada.
24.2 Execuo do E3 Viewer
Exi stem trs formas de se executar o E3 Vi ewer: atravs de um servi dor l ocal , de um
servi dor na i ntranet, ou de um servi dor na Internet. Nas sees a segui r, estas
formas sero detal hadas.
24.2.1 Atravs do E3
O E3 Vi ewer pode ser executado atravs da barra de ferramentas Padro:
Barra de Ferramentas Padro
Executar Aplicativo: Sal va todas as confi guraes do projeto, roda o Domni o e
executa o E3 Vi ewer
Rodar/Parar Domnio: Executa ou para a execuo do Domni o
Executar/Parar E3 Viewer: Executa o E3 Vi ewer ou para a sua execuo caso
el e j esteja aberto
Quando o E3 Vi ewer executado, a apl i cao mostra a janel a a segui r, i ndi cando o
estado da conexo:
Mensagem de estado de conexo
Quando a conexo com o servi dor perdi da, o E3 tenta restabel ec-l a
automati camente, respei tando as confi guraes do servi dor. Para determi nar qual
servi dor far a conexo caso o E3 Vi ewer fal he, necessri o confi gurar a opo
Servidores, confi gurado atravs do E3 Admi n, conforme expl i cado no captul o
Domnios.
24.2.2 Atravs da Linha de Comando
O E3 Vi ewer pode ser acessado vi a l i nha de comando da segui nte manei ra:
Viewer [nome_do_servidor] [opes]
O argumento nome_do_servidor representa o nome da mqui na onde o E3 Server
est rodando. Se este argumento no for i nformado, uma cai xa de di l ogo
mostrada perguntando o cami nho do servi dor da apl i cao, como ocorre quando o
E3 Vi ewer executado a parti r do menu Iniciar (como mostrado na prxi ma seo).
As opes de confi gurao para a l i nha de comando so as segui ntes:
-screen ou /screen: Permi te ao usuri o i nformar uma Tel a i ni ci al vl i da,
di ferente da Tel a i ni ci al confi gurada no Domni o
Viewer [nome_do_servidor] screen <nome_da_tela>
-noping ou /noping: Descarta a necessi dade de se executar um comando ping
para o servi dor antes da tentati va de conexo (tentati va de conexo di reta)
Viewer [nome_do_servidor] noping
-readonly ou /readonly: Permi te ao usuri o especi fi car que o Vi ewer deve tentar
conectar apenas no modo Somente Leitura. Quando i sto for fei to, o Vi ewer i r
sempre uti l i zar uma l i cena Viewer Only
Viewer [nome_do_servidor] readonly
-cachepath ou /cachepath: Permi te especi fi car um di retri o para a gravao do
cache do Vi ewer. Se no for especi fi cado, usado o di retri o temporri o do
si stema (vari vel de ambi ente TEMP)
Viewer [nome_do_servidor] cachepath <diretorio>
-useservers ou /useservers: Esta opo faz com que o Vi ewer tente se conectar
somente aos servi dores especi fi cados na l i nha de comando. Se a opo no
esti ver presente (comportamento padro), o Vi ewer pode tentar descobri r
servi dores al ternati vos caso no consi ga se conectar aos servi dores passados
na l i nha de comando. Esta opo funci ona apenas em rede l ocal , portanto deve
ser i nformada caso o servi dor que o Vi ewer deve acessar esteja fora da rede
l ocal
Viewer [nome_do_servidor] useservers
-params: Permi te que o usuri o especi fi que parmetros de i ni ci al i zao do
Vi ewer. Esta opo no pode vi r i medi atamente antes da l i sta de servi dores. Os
val ores passados nessa opo podem ser recuperados vi a scri pt uti l i zando a
propri edade Params do Vi ewer. Para mai ores i nformaes sobre a uti l i zao
dessa propri edade, veja o captul o Viewer, do Manual de Scripts
Viewer -params <Nome1>=<Valor1> [<Nome2>=<Valor2>] ...
-help: Mostra uma cai xa de di l ogo com exempl os de uso das opes de l i nha de
comando do Vi ewer, como na fi gura a segui r
Caixa de dilogo de ajuda do Viewer
24.2.3 Atravs do Menu Iniciar
Para rodar uma apl i cao cl i ente, pode-se uti l i zar o E3 Vi ewer l ocal i zado no
segui nte cami nho: Menu Iniciar (Start) - Programas (Programs) - Elipse E3 - Viewer.
O E3 ento mostra a segui nte cai xa de di l ogo para que o cami nho do servi dor da
apl i cao seja i nformado:
E3 Viewer
Se o E3 Server esti ver na mesma mqui na do E3 Vi ewer, sel eci one a opo Servidor
Local. Caso el es estejam em mqui nas di ferentes, sel eci one a opo Servidor na
rede e i nforme o nome ou o endereo IP da mqui na com o E3 Server. Se o E3 Server
esti ver di sponvel em uma porta di ferente do padro (6515), i nforme o nmero
desta porta no campo Servidor na rede aps o nmero do IP, separados por doi s
pontos. Para se conectar no modo Somente Leitura, sel eci one a opo Iniciar o
Viewer no modo apenas de leitura.
24.3 Logs do Viewer
O E3 gera l ogs no formato ETL (Event Trace Log). Esses arqui vos de l og so
gerenci ados por uma ferramenta da El i pse chamada Elipse Event Log Viewer,
di sponvel com a i nstal ao do E3. Com essa ferramenta possvel vi sual i zar os
arqui vos e gerenci ar o espao que estes ocupam em di sco, entre outros. Para mai s
i nformaes sobre a ferramenta Elipse Event Log Viewer, consul te o Manual do
Usurio do Elipse Event Log, di sponvel no menu Iniciar - Programas - Elipse Software
- Elipse Event Log. O apl i cati vo Elipse Event Log Viewer pode ser aberto de trs
formas:
Pel o menu Iniciar - Programas - Elipse Software - Elipse Event Log - Log Viewer
Pel o menu Ferramentas - Log Viewer do E3 Studi o
Pel o i tem Atalhos - Log Viewer do menu do E3 Admi n na rea de Noti fi cao do
Wi ndows
24.4 Execuo do E3 WebViewer
Durante a i nstal ao do E3 WebVi ewer, os arqui vos e3web.asp, e3web2.asp,
docwri te.asp, docwri te2.asp e e3downl oader.cab fi cam di sponvei s para
confi gurao pel o usuri o. Estes arqui vos fi cam l ocal i zados no di retri o onde o E3
foi i nstal ado, na pasta Web.
e3web.asp e docwrite.asp: tm a funo de carregar e i ni ci ar o Acti veX
E3Downl oader
e3downloader.cab: Acti veX que ser envi ado para a mqui na cl i ente e far a
i nstal ao do e3webvi ewer-x86-ptb.exe
e3web2.asp e docwrite2.asp: tm a funo de carregar e i ni ci ar o Acti veX do
WebVi ewer que mostrar a apl i cao sendo executada na mqui na do Internet
Expl orer
A pgi na docwri te2.asp vem confi gurada consi derando-se que o E3 Server est
rodando no mesmo computador que o servi dor web. Porm, possvel al terar o
cdi go fonte desta pgi na para atender confi gurao desejada. Para tanto, basta
al terar a l i nha a segui r no cdi go fonte da pgi na docwri te2.asp:
var Domain = getDomain();
Para:
var Domain = "IP externo do servidor IIS";
Caso se quei ra permi ti r ao usuri o i nformar uma Tel a i ni ci al vl i da, di ferente da
confi gurada no Domni o, deve-se al terar a l i nha abai xo, col ocando em
Nome_da_tela um nome de Tel a vl i do na apl i cao:
<param name='Screen' value='Nome_da_tela'>
Caso se quei ra i nformar a necessi dade de se executar o comando ping para o
servi dor antes de tentar a conexo, deve-se al terar a l i nha abai xo. O val or pode ser
True ou Fal se.
<param name='Ping' value='TRUE'>
Se esta l i nha for omi ti da, o comando ping ser executado.
Para se navegar para uma pgi na di ferente do padro aps o carregamento do E3
WebVi ewer, deve-se modi fi car o atri buto value do parmetro URLToLoad para o
endereo desejado:
<param name='URLToLoad' value='url'>
Se esta l i nha for omi ti da, a pgi na e3web2.asp ser carregada.
Para especi fi car um di retri o para a gravao do cache do Vi ewer, deve-se al terar a
l i nha a segui r. Se no for especi fi cado, usado o di retri o temporri o do si stema
(vari vel de ambi ente TEMP).
<param name='cachepath' value='diretorio_para_cache'>
Caso seja preci so que o WebVi ewer procure por outros servi dores na rede se no
consegui r conectar-se ao servi dor especi fi cado no parmetro Domain, deve-se
al terar a l i nha a segui r. Se o parmetro no for i nformado, o WebVi ewer tentar se
conectar apenas ao servi dor especi fi cado no parmetro Domain, que o
comportamento padro do WebVi ewer (val or True). A al terao do val or para Fal se
s i r funci onar para servi dores e WebVi ewers que estejam na mesma rede.
<param name= 'useservers' value='FALSE'>
A confi gurao do E3 WebVi ewer para abri r no modo Somente Leitura fei ta
atravs da propri edade StartReadOnly (com os val ores True ou Fal se). Se este i tem
no exi sti r, o val or assumi do Fal se (comportamento compatvel com verses
anteri ores). Exempl o:
var conteudo = "<object classid='clsid:7EB4D157-FACC-45BB-9536-
C14B9DCE3CA7'";
conteudo += " width='100%' height='100%'>";
conteudo += "<PARAM NAME='Domain' VALUE='192.0.0.21'>";
conteudo += "<PARAM NAME='Screen' VALUE=''>";
conteudo += "<PARAM NAME='CachePath' VALUE=''>";
conteudo += "<PARAM NAME='Ping' VALUE='0'>";
conteudo += "<PARAM NAME='StartReadOnly' VALUE='FALSE'>";
conteudo += "</object>";
document.write(conteudo);
Em ambos os casos, esta confi gurao s ter efei to na abertura do E3 WebVi ewer.
Se a propri edade for mudada durante a execuo, a conexo ou reconexo do E3
WebVi ewer no ser afetada.
Os servi dores e o E3 WebVi ewer podem tanto rodar na mesma mqui na quanto em
mqui nas di ferentes. A segui r, veremos como estas si tuaes se apl i cam.
24.4.1 Internet Information Services
Tanto para a vi sual i zao na Internet como para vi sual i zao em i ntranet ou
mqui na l ocal , necessri a a i nstal ao e confi gurao do IIS (Internet Information
Services), ou outro servi dor de i nternet.
O IIS forneci do juntamente com o Wi ndows. Para i nstal -l o e confi gur-l o, si ga
1. Abra o Painel de Controle (Control Panel).
2. Sel eci one a opo Adicionar programas (Add/Remove Programs).
3. Cl i que em Adicionar um componente do Windows (Add/Remove Windows
Component).
Internet Information Services (IIS)
4. Sel eci one na l i sta o i tem Internet Information Services (IIS) e cl i que em Prximo
(Next).
5. O IIS i ni ci a a i nstal ao (para i nstal ar o IIS preci so ter o CD de i nstal ao do
Wi ndows).
6. Aguarde a fi nal i zao do processo para confi gurar o IIS.
Aps a i nstal ao do IIS, os arqui vos e3web.asp, e3web2.asp, docwri te.asp,
docwri te2.asp e e3downl oader.cab devem ser copi ados para c:\InetPub\wwwroot.
Esta pasta cri ada na i nstal ao do IIS. Al m dos arqui vos .asp, o i nstal ador do E3
WebVi ewer tambm deve ser copi ado para esta mesma pasta. Este i nstal ador
(e3webvi ewer-x86-ptb.exe) uti l i zado quando a mqui na cl i ente acessar o servi dor
pel a pri mei ra vez, caso o E3 no tenha si do previ amente i nstal ado nesta mqui na.
Este arqui vo pode ser obti do atravs de download no si te da El i pse.
O IIS ai nda necessi ta ser confi gurado para seu correto funci onamento. A
confi gurao ser di ferente caso o IIS e o E3 Server estejam na mesma mqui na ou
em mqui nas di ferentes. Para confi gur-l o, consul te o Guia de Instalao do E3, na
seo Instalao do E3 WebViewer.
24.4.2 Visualizao na Aplicao Cliente
Se o servi dor esti ver uti l i zando o servi dor web, por exempl o o IIS, basta di gi tar na
barra de endereos do browser o endereo ou IP do servi dor (por exempl o, http://
nomedoservidor/diretorio_virtual ou http://192.0.0.21/diretorio_virtual), onde
diretorio_virtual o di retri o cri ado na confi gurao do IIS (conforme o Guia de
Instalao do E3).
No pri mei ro acesso ao servi dor, o navegador vai i ni ci ar a i nstal ao dos
componentes, caso estes no tenham si do previ amente i nstal ados, conforme
expl i cado no comeo deste captul o. O componente assi nado pel a El i pse Software
e o usuri o dever acei tar a i nstal ao, para que se i ni ci em as confi guraes
necessri as.
Instalao do Web Viewer
Aps a i nstal ao, o E3 WebVi ewer estar aberto no browser, e vi sual i zando a
apl i cao do servi dor. Nos prxi mos acessos no ser mai s necessri o i nstal ar os
componentes e o tempo de conexo ser mai s rpi do.
NOTA: A verso do cl i ente tem que ser a mesma do servi dor. Para i sto, o i nstal ador
(e3-w2kwebvi ewer.exe) que fi ca no servi dor deve ser sempre o mai s atual .
534 Hot-Standby
25
Hot-Standby
CAPTULO
O Hot-Standby permi te a i mpl ementao do concei to de fail-over em um si stema
supervi sri o. Esse concei to consi ste na possi bi l i dade de se ter doi s servi dores
(pri nci pal e backup) atuando um como conti ngnci a do outro, ou seja, se o servi dor
pri nci pal fal har, um servi dor de backup entra em ao i medi atamente, sem perda
da conti nui dade do processo. Este servi dor em espera di z-se que est em Standby.
Assi m, a ferramenta de Hot-Standby do E3 tem como objeti vo permi ti r que um
servi dor fi que em estado de espera (Standby), aguardando uma possvel fal ha de
um outro servi dor (servi dor ati vo). A troca de servi dor ati vo pode ser manual ou
automti ca.
A troca manual aci onada atravs do menu do E3 Admi n na rea de Noti fi caes
do Wi ndows do computador em Standby (opo Servidor - Ativar). A troca
automti ca ocorre quando o servi dor em Standby detecta que o servi dor pri nci pal
no est mai s rodando. Um servi dor pode assumi r um dos segui ntes estados:
Servidor em Manuteno: Este estado i ndi cado na confi gurao do servi dor do
Domni o. Um servi dor em manuteno no toma parte em nenhum evento do
Domni o
Servidor Ativo: Apenas um servi dor pode estar ati vo em um Domni o em um
determi nado momento. O servi dor ati vo aquel e que est rodando o apl i cati vo
(E3Run)
Servidor Standby: Apenas um servi dor pode estar em modo Standby em um
Domni o em um determi nado momento. O servi dor Standby roda o E3Run em
modo Standby, o apl i cati vo fi ca carregado, apenas esperando um comando para
entrar em operao. O servi dor Standby moni tora o servi dor ati vo e, se este no
esti ver respondendo, o Standby ati vado
Servidor Inativo: Um servi dor fi ca i nati vo quando est decl arado no Domni o,
mas no est sel eci onado como servi dor pri nci pal nem como backup. Mesmo
i nati vo, este servi dor moni tora mudanas no arqui vo de Domni o, podendo
passar para o estado Ativo ou Standby se o Domni o for reconfi gurado
IMPORTANTE: Para rodar uma apl i cao redundante no E3, necessri o que todos
os servi dores rodem a mesma verso do software, e tenham uma cpi a l ocal
atual i zada dos arqui vos do Domni o (arqui vos .prj, .l i b, etc.). O arqui vo .dom, por
sua vez, si ncroni zado automati camente pel o E3 Server, i sto , mudanas fei tas no
arqui vo .dom em um servi dor so automati camente copi adas para o arqui vo .dom
dos outros servi dores do Domni o. Para i sto, o arqui vo .dom deve obri gatori amente
exi sti r no mesmo cami nho em todos os servi dores.
Hot-Standby 535
O Hot-Standby usa a conexo REC, portanto el e s funci ona se o E3 Server esti ver
i ni ci ado nas mqui nas envol vi das.
Se o usuri o de um E3 Studi o ou Hot-Standby admi ni strador da mqui na remota
onde o E3 Server est rodando, el e pode control ar o servi o remotamente usando o
apl i cati vo services.msc, atravs da opo Action - Connect to another computer.
25.1 Configurando
As confi guraes que devero ser fei tas para i mpl ementar o Hot-Standby so as
segui ntes:
1. Local i ze o cami nho dos arqui vos de Domni o (arqui vos .dom, .prj, .l i b, etc.) no
computador pri nci pal e copi e esta pasta para o computador Standby. Caso
tenha si do i ndi cado um outro cami nho para os arqui vos de Domni o na opo
Pasta raiz dos arquivos do Domnio, na aba Servidores, deve-se uti l i zar este
cami nho para a cpi a.
2. Os arqui vos de bancos de dados devem ser tratados de manei ra di ferenci ada.
Para mai ores i nformaes, veja o tpi co Utilizando Bancos de Dados com Hot-
Standby.
3. Acesse o cone do E3 Admi n na rea de Noti fi caes do Wi ndows e
sel eci one a opo Domnio - Opes.
E3 Admin
4. Na aba Servidores, adi ci one os servi dores pri nci pal e backup. Confi gure as
opes Nome do servidor e Identificao do servidor na rede, conforme descri to
no tpi co Domnios - Configuraes de Domnio - Servidores. Por exempl o:
Nome do servidor: Servi dor1
Identificao do servidor na rede: \\Computer1
536 Hot-Standby
5. Na aba Opes, marque o i tem Hot-Standby - Habilitar. No campo Servidor
principal, sel eci one o servi dor pri nci pal do seu projeto e no campo Servidor de
backup, sel eci one o servi dor de backup. O E3 i r buscar o servi dor pri nci pal
por ordem al fabti ca.
6. Defi na a opo Endereos para PING de integridade de rede, conforme
especi fi cado no i tem Endereos para PING de integridade da rede do tpi co
Domnios - Configuraes de Domnio - Opes.
7. Habi l i te a opo Ativar backup em caso de falha local, conforme especi fi cado no
i tem Ativar backup em caso de falha local do tpi co Domnios - Configuraes de
Domnio - Opes.
8. Para confi rmar as confi guraes, cl i que em OK.
9. Ao i ni ci ar a execuo do E3 ser mostrado, na rea de Noti fi caes do
Wi ndows dos computadores confi gurados no Hot-Standby, um cone
representado por uma barra amarel a ci rcul ante , i ndi cando que os
Domni os esto sendo carregados. Aps al guns segundos, o E3 reconhece o
computador pri nci pal e i ndi ca esse estado, na rea de Noti fi caes do
Wi ndows, com um cone representado por uma seta verde . Este cone
determi na que el e est em execuo. No computador standby ser mostrado um
cone representado por duas barras amarel as , i ndi cando que el e est em
modo Standby (modo de espera).
25.2 Executando um Domnio Redundante
Para executar um Domni o redundante, necessri o apenas i ni ci ar um dos seus
servi dores; os outros servi dores sero automati camente i ni ci ados por este
pri mei ro servi dor. Para i ni ci ar um Domni o, cri e um atal ho para o E3 Admi n com a
segui nte l i nha de comando:
E3Admin.exe start <Caminho_do_Domnio>
Este servi dor i ni ci ar os servi dores do Domni o e depoi s ser automati camente
fechado. Um Domni o pode ser i ni ci ado tambm atravs do E3 Studi o. Para tanto,
basta abri r o Domni o e cl i car em .
25.3 Parando um Domnio Redundante
Um Domni o pode ser parado por qual quer um dos seus servi dores, atravs do
cone na rea de Noti fi caes do Wi ndows. Escol ha a opo Domnio - Parar e o
servi dor Ati vo e o Standby termi naro o processo E3Run. O Domni o pode ser
rei ni ci ado escol hendo a opo Domnio - Executar. Se for escol hi da a opo
Domnio - Fechar, o Domni o ser parado e fechado, fi cando os E3 Servers
di sponvei s para rodar outros Domni os.
Hot-Standby 537
IMPORTANTE: As opes de parar e fechar um Domni o AFETAM TODOS OS
SERVIDORES DO DOMNIO, e no apenas o servi dor onde o comando executado.
25.4 Parando um dos Servidores do Domnio
A manei ra correta de parar um dos servi dores do Domni o marc-l o como Em
manuteno na confi gurao Domnio - Opes, aba Servidores, do Domni o. Se o
servi dor ati vo for col ocado em manuteno, o servi dor Standby i r passar para o
estado ati vo. Para recol ocar o servi dor no Domni o, desmarque a opo Em
manuteno deste servi dor.
25.5 Tempo de Troca entre Servidores
O tempo padro para o servi dor de backup assumi r, quando ocorre uma fal ha do
servi dor ati vo, de 15 segundos. No entanto, possvel confi gurar este tempo
atravs do i tem Tempo para ativao do servidor reserva (conforme expl i cado no
tpi co Opes do Domnio do captul o Domnios).
Este tempo permi te que o servi dor anteri or termi ne a execuo do apl i cati vo (caso
a fal ha seja apenas de rede). O tempo confi gurado afeta di retamente o timeout do
ping entre os servi dores. Se fi car mui to bai xo (troca em um segundo, timeout de ping
i gual a 160 ms), podem ocorrer trocas espontneas de servi dor, causadas por
pequenas fal has de rede.
25.6 Reconexo de Viewers
Quando h uma troca de servi dores, os Vi ewers entram em processo de reconexo,
tentando al ternadamente conectar com o servi dor backup e com o ati vo. O usuri o
tem a opo de esperar o fi m do processo de reconexo com o Vi ewer atual ,
cancel ar a reconexo (e fechar o Vi ewer) ou abri r uma nova sesso Vi ewer com o
novo servi dor.
25.7 Utilizando Bancos de Dados com
Hot-Standby
Pode-se ter doi s servi dores rodando separadamente em uma mesma apl i cao. Um
del es fi ca ati vo, enquanto o outro fi ca em estado de espera (standby), aguardando
uma possvel fal ha.
O Hot-Standby garante a conti nui dade da apl i cao, mas quando se uti l i za bancos
de dados, tambm tem-se que garanti r a conti nui dade do acesso base de dados.
H duas manei ras de resol ver este probl ema. Na pri mei ra, ambas as apl i caes
acessam uma mesma base de dados. Habi l i ta-se o acesso ao banco de dados na
apl i cao, confi gurando o objeto DBServer em ambos servi dores (Pri nci pal e
Standby) com os mesmos parmetros de l ocal i zao do banco de dados na rede.
Para garanti r a conti nui dade do si stema, i mportante que a base de dados esteja
538 Hot-Standby
em uma mqui na separada, acessvel aos doi s servi dores.
Na segunda manei ra, a gravao dos dados fei ta em bases di ferentes. Neste caso,
o i deal ter-se os doi s bancos de dados rodando l ocal mente, em ambos os
servi dores. Assi m, garante-se que o acesso ao banco de dados estar sempre
di sponvel , poi s a mqui na que roda a apl i cao tambm roda o banco de dados.
Uma opo i nteressante nesse caso o si ncroni smo entre as di ferentes bases de
dados da apl i cao pri nci pal e da secundri a. A propri edade
EnableSynchronization do objeto DBServer habi l i ta esse recurso na apl i cao.
Quando el a est ati va, todos os dados gravados na base pri nci pal so atual i zados
na base em Standby quase i nstantaneamente.
NOTA: Se a apl i cao pri nci pal no consegui r envi ar os dados para o servi dor em
Standby, esses dados fi caro armazenados l ocal mente em di sco, para posteri or
envi o (quando a comuni cao entre os doi s computadores for restabel eci da),
assegurando assi m a i gual dade entre as tabel as geradas pel a apl i cao.
Configuraes Avanadas 539
26
Configuraes Avanadas
CAPTULO
Exi stem confi guraes do E3 que podem ser real i zadas di retamente no Regi stro do
Wi ndows, embora esse procedi mento no seja aconsel hvel . A El i pse Software
possui uma ferramenta, chamada E3 Tweak, que real i za as confi guraes de
regi stro usando uma i nterface grfi ca. O Manual do Usurio do E3 Tweak pode ser
aberto pel o menu Iniciar - Programas - Elipse Software - Elipse E3 - Manuais - Manual
do E3 Tweak. O apl i cati vo E3 Tweak pode ser aberto de trs formas:
Pel o menu Iniciar - Programas - Elipse Software - Elipse E3 - E3 Tweak
Pel o menu Ferramentas - E3 Tweak do E3 Studi o
Pel o i tem Atalhos - E3 Tweak do menu do E3 Admi n na rea de Noti fi cao do
Wi ndows
540 Dvidas mais Frequentes
27
Dvidas mais Frequentes
CAPTULO
Este captul o desti na-se ao escl areci mento das dvi das mai s frequentes
encontradas no E3. Tambm so mostrados os erros que podem ocorrer e quai s as
sol ues para el es.
27.1 Ordem dos Tabs
Qual a relao entre a ordem de criao dos objetos na Tela e a ordem de tabulao
em tempo de execuo?
Quando um novo objeto cri ado na Tel a, atri bui -se a el e a pri mei ra posi o na
ordem de tabul ao, e el e ordenado em sequnci a decrescente em rel ao aos
demai s objetos da Tel a. Para mai ores i nformaes sobre este assunto, veja o
tpi co Ordem de Navegao entre os Objetos, do captul o Telas e Objetos de Tela.
27.2 Sobreposio de Animaes nos Objetos
Criei uma Animao com Rotao ou Translao na Tela, mas decidi mud-la, criando
uma nova Animao. No entanto, quando fui executar a aplicao, o objeto apareceu
com a Animao inicial, e no com a Animao corrente. Por qu isto ocorre?
POSSVEL CAUSA
A nova Ani mao foi cri ada sem que a anteri or tenha si do removi da.
SOLUO
Para sol uci onar esta questo, si ga estes procedi mentos:
1. Sel eci one o objeto que deseja mudar a Ani mao.
2. Cl i que com o boto di rei to do mouse sobre el e e sel eci one a opo Remover
animao.
3. Apl i que a Ani mao desejada.
NOTA: No tente remover a Ani mao do objeto atravs do Organi zer, poi s esta
ao i r remover o objeto.
27.3 Objetos de Tela
No consigo rotacionar uma figura inserida atravs da Galeria. Por qu isto ocorre?
Deve-se converter o objeto em smbol o. Isto permi te que sejam uti l i zados os
comandos e opes di sponvei s aos objetos que so nati vos do E3, como por
exempl o, o uso da Rotao.
Dvidas mais Frequentes 541
27.4 Servidor de Banco de Dados SQL Server
A segui r so l i stados os possvei s erros que podem ocorrer ao se testar a conexo
com este Banco de Dados:
ErrorLocal = Open Connection ErrorError #0x80004005 Description:[DBNETLIB]
[ConnectionOpen(Connection()).]SQL Server does not exist or access denied.
(Source: Microsoft OLE DB Provider for SQL Server) (SQL State: 08001)
(NativeError:17)
POSSVEL CAUSA
Nome do Servi dor errado na confi gurao do Servi dorDB ou o usuri o no tem
acesso quel e banco.
SOLUO
Veri fi car o nome do servi dor uti l i zado e se o usuri o possui permi sso para
conectar-se quel e banco.
ErrorLocal = Open Connection ErrorError #0x80040E4D Description: Login failed for
user 'UsuarioErrado'.(Source: Microsoft OLE DB Provider for SQL Server) (SQL State:
42000)(NativeError: 18456)
POSSVEL CAUSA
Erro no nome do usuri o ou senha.
SOLUO
Uti l i ze um usuri o cadastrado no banco de dados ou veri fi que a senha uti l i zada.
ErrorLocal = ExecuteSql ErrorError #0x80040E14 Description: There is already an
object named 'E3Index' in the database. (Source: Microsoft OLE DB Provider for SQL
Server) (SQL State: 42000) (NativeError: 1750)
POSSVEL CAUSA
J exi ste um objeto (tabel a, chave, ndi ce, etc.) no Banco de Dados com este mesmo
nome.
SOLUO
Mudar o nome do objeto.
27.5 Servidor de Banco de Dados Oracle
A segui r sero l i stados os possvei s erros que podem ocorrer ao se testar a
conexo com este Banco de Dados:
Error = ORA-01017: invalid username/password; logon denied
POSSVEL CAUSA
Mensagem gerada em l og quando a senha ou o usuri o est i ncorreto.
SOLUO
Veri fi car se o usuri o exi ste e se a senha uti l i zada est correta.
Error = ORA-12154: TNS: no foi possvel resolver nome de servio
POSSVEL CAUSA
A conexo cl i ente uti l i zada no foi encontrada.
SOLUO
Veri fi car se a conexo uti l i zada est cri ada no computador e se el a est
funci onando atravs dos softwares uti l i tri os de rede do Oracl e.
Error = ORA-02264: nome j usado por uma restrio existente
POSSVEL CAUSA
J exi ste um objeto no Banco de Dados com este mesmo nome.
SOLUO
Para evi tar esse erro, cri e e confi gure di ferentes nomes de ndi ces ou chaves
pri mri as no E3.
Error = ORA-01403: dados no encontrados
POSSVEL CAUSA
Esta mensagem gerada quando uma pesqui sa i nterna do E3 procura por objetos
no Banco de Dados e no os encontra (por exempl o, a tabel a de Hi stri cos no
exi ste, deve ser cri ada).
SOLUO
Isto seri a consi derado um erro apenas se persi sti sse nos l ogs da apl i cao.
Error = ORA-00001: restrio exclusiva (SYSTEM.E3INDEX) violada
POSSVEL CAUSA
Sempre que for fei ta uma tentati va de escri ta de um regi stro onde o campo defi ni do
como chave pri mri a ti ver o val or repeti do, a escri ta ser recusada e a mensagem
anteri or ser exi bi da. i nteressante veri fi car que o nome da chave mostrado
(neste caso, a chave SYSTEM.E3INDEX) no formato Usuri o.NomeChave.
Dependendo do projeto, esse erro esperado, mas na grande mai ori a das vezes,
i mportante veri fi car se a chave a mai s adequada. Para i l ustrar essa afi rmao,
veja estes doi s casos:
Sistema de Telemedio de Energia: Vi sando gravar todos os dados de um di a, as
roti nas usadas para col etar dados admi tem tol ernci as a mai s ou a menos no
horri o a ser col etado. Assi m, al guns dos regi stros tero de ser escri tos mai s de
uma vez. Neste caso, a ocorrnci a desse erro esperada
Manuteno de alarmes: Para esse caso, pode haver mai s de um erro por
segundo no si stema. Se o campo E3TimeStamp for usado como chave pri mri a,
pode haver a perda de al gumas ocorrnci as de al arme, o que prejudi ca a anl i se
posteri or dos eventos. Neste caso, re-estudar a chave-pri mri a pode ser a
sol uo adequada
SOLUO
H duas manei ras de sol uci onar esta questo:
1. O usuri o deve cri ar um ndi ce ni co para os campos da chave.
2. O usuri o deve veri fi car a apl i cao para que el a no envi e val ores repeti dos
de chave para gravao.
27.6 Servidor de Dados
A propriedade Retentive do Tag Interno no est funcionando, pois ela no guarda o
ltimo valor ao parar o Domnio. O qu pode estar errado?
A propri edade Retentive no tem este objeti vo. El a tem uti l i dade apenas em
apl i caes Hot-Standby, para manter o val or do Tag Interno quando houver uma
troca de servi dor.
Como salvar o valor de um Tag Interno ao parar o Domnio?
Use o mtodo Save do Servi dor de Dados.
Como eu mostro a data e a hora atual do sistema em uma Tela da minha aplicao?
Cri e um Tag Demo do ti po CurrentTime e associ e-o a um Di spl ay na Tel a. O formato
de data e hora pode ser confi gurado na aba Formatao das propri edades do
Di spl ay.
Como criar um temporizador no E3?
Com um Tag Demo do ti po Square. O Tag deve ter a propri edade Enabled i gual a
Fal se e a propri edade Period i gual a duas vezes o tempo l i mi te em mi l i ssegundos. A
atri bui o do val or Verdadei ro propri edade Enabled i ni ci ar a contagem do
tempo. Para executar um scri pt qual quer no trmi no do tempori zador, basta cri ar
um evento associ ado propri edade Value do Tag Demo, que seja executado quando
a propri edade al terar o seu val or. Neste scri pt tambm se deve desabi l i tar o Tag
Demo, ou seja, atri bui r propri edade Enabled o val or Fal se, para que el e no
conti nue vari ando. Recomenda-se usar o mtodo Reset do Tag Demo antes de
atri bui r propri edade Enabled o val or True.
27.7 Drivers de Comunicao
O que tenho que fazer para usar os bits de um Tag de Comunicao?
Para usar os bi ts de um Tag de Comuni cao, deve-se habi l i tar a propri edade
UseBitFields do Tag.
Como so contados os Tags Bloco e os bits dos Tags no E3?
A contagem consi dera os Tags de Comuni cao e o tamanho dos Bl ocos de
Comuni cao. Os bi ts no entram na contagem.
Qual a maneira mais fcil de fazer piscar a cor de um objeto na Tela quando houver
um erro de comunicao?
Cri e uma Associ ao Di gi tal entre a propri edade ForegroundColor do objeto e a
expresso NomeDoTag.Quality < 192, com a opo de pi sca habi l i tada. A
propri edade Quality representa o estado da qual i dade do val or do Tag, no padro
OPC, e pode vari ar de 0 a 255, sendo que a qual i dade boa apenas aci ma de 192.
Como sinalizar erros de comunicao na Tela?
Habi l i te a opo Erros de Comunicao no objeto Vi ewer, na aba Erros de
Comunicao.
Como trocar a cor padro dos erros de comunicao em Setpoints e Displays?
Acesse o objeto Vi ewer e al tere a cor desejada, na aba Erros de Comunicao.
27.8 Alarmes
Foi encontrado um erro no nmero de colunas do arquivo CSV na importao de um
Alarme do tipo <nomedotipo>. Deseja continuar a importao dos demais Alarmes,
ignorando os erros?
POSSVEIS CAUSAS
O arqui vo CSV para os al armes que se quer i mportar possui um erro nas col unas
do Al arme do ti po i ndi cado. Arqui vos de al armes devem ter sempre o nmero
mni mo de col unas esperado, de acordo com cada ti po. Col unas extras so
desprezadas. Para saber a manei ra correta de cri ar um arqui vo CSV para al armes,
veja a seo Criando um arquivo CSV manualmente, no captul o E3 Studio.
SOLUO
Exi stem trs possvei s respostas pergunta fei ta na mensagem de erro:
Sim: A i mportao dos Al armes conti dos no arqui vo CSV i r prossegui r,
i gnorando apenas este erro de nmero de col unas. O Al arme cujas col unas esto
i ncorretas no ser i mportado
Sim (Todos): A i mportao dos Al armes i r prossegui r, i gnorando todos os
demai s Al armes com erro no nmero de col unas que possam exi sti r no arqui vo
CSV
No: A i mportao ser i nterrompi da, mas os Al armes j i mportados so
preservados
Para que este erro no ocorra, o arqui vo CSV deve ser cri ado de acordo com as
recomendaes do captul o Alarmes.
IMPORTANTE: Embora os arqui vos de Tags e Al armes tenham a mesma extenso
(.csv), el es so i nternamente di ferentes. Sendo assi m, um arqui vo de Al armes no
serve para Tags e vi ce-versa.
Criei um arquivo CSV manualmente, contendo a configurao dos Alarmes. Como
fao para import-lo?
Veri fi que as confi guraes regi onai s no Pai nel de Control e do Wi ndows, e confi rme
se o caractere separador o mesmo uti l i zado no arqui vo CSV. DICA: cri e um Al arme
no E3 e uti l i ze a ferramenta de exportao, uti l i zando-o como model o para a
gerao dos novos Al armes.
Como mostrar o campo E3TimeStamp com milissegundos no E3Browser e no
E3Alarm?
Use o formato Outros, di gi tando "dd/MM/yyyy HH:mm:ss.000". Esta
confi gurao para o E3Browser fei ta na aba Fontes de Dados, na col una Formato
de cada campo. Para o E3Al arm, tal confi gurao fei ta na aba Colunas, cl i cando
em Propriedades de cada campo.
Aparece a seguinte mensagem de erro: "Impossvel criar assinaturas de Alarmes no
Servidor de Alarmes com filtro. Error code: (0x800706F7)". O qu isto significa?
O nome do Servi dor de Al armes no foi especi fi cado no E3Al arm, ou ento est com
erro. Para que o E3Al arm consi ga capturar e exi bi r os Al armes ati vos, necessri o
confi gurar o nome do Servi dor de Al armes que ser acessado. Para i sso, modi fi que
o i tem Nome do Servidor de Alarmes, na aba Geral das propri edades do objeto
E3Al arm, ou atravs da Li sta de Propri edades, acessando a propri edade
AlarmServer.
Como apagar Tags associados a Alarmes e reas do objeto Configurao de Alarmes?
Para apagar um Tag que est associado a um Alarme: Sel eci onar o Tag desejado
com o mouse e pressi onar a tecl a DELETE
Para apagar um Alarme: Sel eci onar o Al arme desejado com o mouse e apertar a
tecl a DELETE
Para apagar uma rea: Sel eci onar a rea desejada com o mouse e apertar a tecl a
DELETE
Como exibir as mensagens "Alta", "Mdia" e "Baixa" no campo Severidade de um
Alarme ao invs dos valores 0, 1 e 2 em uma consulta SQL?
A si ntaxe SQL para cada um dos bancos de dados suportados pel o E3 a segui nte:
Access:
SELECT InTime, OutTime, Message, FormattedValue,
IIF(Severity = "0", "Alta", IIF(Severity = "1", "Mdia",
"Baixa"))
AS Severidade FROM Alarms;
SQL Server:
Severidade = CASE Severity WHEN 0 THEN 'Alta' WHEN 1 THEN
'Mdia'
WHEN 2 THEN 'Baixa' END FROM Alarms;
Oracle:
DECODE(Severity, 0, 'Alta', 1, 'Mdia', 2, 'Baixa')
Severidade FROM Alarms;
27.9 E3Alarm
Os Alarmes no aparecem no E3Alarm. Por qu isto ocorre?
POSSVEIS CAUSAS
Para checar a confi gurao do E3Al arm, veri fi que se o nome do Servi dor est
confi gurado corretamente. Outra possi bi l i dade a exi stnci a de mai s de um
Servi dor de Al armes no Domni o, o que pode gerar probl emas. Mai s uma si tuao
de erro seri a um fi l tro confi gurado para uma rea de Al arme i nexi stente.
SOLUO
Certi fi que-se de que exi ste apenas um Servi dor de Al armes no seu Domni o e que
todos os Al armes esto confi gurados corretamente. Confi ra tambm se a rea
confi gurada exi ste.
Como fazer um filtro por duas ou mais reas no E3Alarm?
Pri mei ro, agrupe as reas em uma rea pri nci pal . Depoi s, use nomes com os
mesmos caracteres i ni ci ai s. Exempl o: ALM1MEC, ALM1ELE, ALM2MEC, ALM2ELE, etc.
Como reconhecer Alarmes com duplo-clique?
Habi l i te a opo Reconhecer Alarme, l ocal i zada nas propri edades da col una
desejada no objeto E3Al arm, na aba Colunas.
27.10 E3Browser
Como limitar o nmero de registros que vo aparecer no E3Browser?
Este i tem pode ser confi gurado na consul ta do E3Browser. s habi l i tar a cai xa de
sel eo Retornar no mximo ... registros, especi fi cando o nmero mxi mo de
regi stros a serem retornados. Outra opo oti mi zar a consul ta a ser fei ta
uti l i zando os fi l tros para restri ngi r o perodo, a quanti dade de col unas ou regi stros
envol vi dos, etc. Para i sto, veja o captul o Consultas.
27.11 E3Chart
possvel no plotar o valor de um Tag quando a qualidade estiver ruim, em um
E3Chart histrico?
Si m. Vi a scri pts, possvel confi gurar o E3Chart para i sto.
Set Pena = Screen.Item("E3Chart1").Pens
Pena.Item("Nome da Pena").ShowBadPoints = False
Observe, no entanto, que esta sol uo somente vl i da para val ores hi stri cos. Em
tempo de execuo, o val or ser sempre pl otado, i ndependente da qual i dade do
Tag.
27.12 Histrico
Como no gravar os registros de Histricos por scan?
Confi gure a opo Gravar um novo script a cada, da aba Histrico, nas propri edades
do Hi stri co, com val or 0 (zero). Se desejar faz-l o por scri pt, a propri edade a
ScanTime. Com i sto, os val ores no sero regi strados automati camente, sendo
necessri o fazer o regi stro vi a scri pt uti l i zando o mtodo WriteRecord.
27.13 Associaes
Como criar um Tag Expresso no E3?
Associ ando a propri edade Value de um Tag Interno expresso desejada. A
expresso pode ser do ti po si mpl es e pode conter operadores ari tmti cos e l gi cos
envol vendo constantes e outros Tags.
Como mudar a cor de um objeto ao passar o mouse sobre ele?
Cri ando uma Associ ao Di gi tal entre as propri edades ForegroundColor e
MouseOver de um objeto. A propri edade MouseOver do ti po Bool eana, e assume
o val or Verdadei ro quando o mouse esti ver sobre objeto e Fal so quando o mouse
esti ver fora da rea do objeto.
Como criar uma aplicao multilngue?
H duas formas de se fazer i sto. Uma del as cri ar um Tag Interno no Vi ewer para
cada String e associ ar estes Tags s propri edades que devem ser traduzi das (ou
uti l i zar os Tags por scri pt no caso de usar o mtodo Msgbox). Depoi s, cri ar uma
tabel a com todas as Strings da apl i cao, onde a pri mei ra col una o nome do Tag
Interno cri ado no Vi ewer, e cada col una segui nte contm a String correspondente a
um i di oma. Esta tabel a pode ser no Access, por exempl o. Ao abri r o Vi ewer e defi ni r
o i di oma, carregar os Tags Internos do Vi ewer com as Strings da tabel a
correspondente ao i di oma escol hi do. Isto pode ser fei to uti l i zando um objeto
Consul ta na Tel a. Segue um exempl o de scri pt:
Sub Tela1_OnPreShow(Arg)
Set rs = Item("Query1").GetADORecordset()
rs.MoveFirst
For i = 1 To rs.RecordCount
Application.Item(rs.Fields("NomeTag").Value).Value = _
rs.Fields(Arg).Value
' Arg um parmetro passado para a Tela contendo o nome
' da coluna referente ao idioma selecionado
rs.MoveNext
Next
End Sub
Outra manei ra cri ar uma Associ ao por Tabel a em todas as propri edades que
possurem contedo a ser traduzi do, usando para todas as Associ aes a mesma
fonte. Em cada fai xa de val ores da Associ ao, col oque uma String referente a um
i di oma di ferente. A fonte pode ser um Tag Interno cujo val or pode ser defi ni do ao
abri r o Vi ewer. No caso do mtodo MsgBox, usar o mesmo Tag como condi o para
escol her qual String ser uti l i zada.
27.14 Viewer
No consigo conectar um Viewer remoto ao Servidor. Por qu isso est
acontecendo?
POSSVEL CAUSA
Exi ste um firewall bl oqueando o acesso ao servi dor.
SOLUO
Deve-se l i berar as portas uti l i zadas pel o E3. O procedi mento para desbl oquear
uma porta no firewall do Wi ndows est descri to a segui r.
NOTA: A porta padro uti l i zada pel o E3 a 6515, mas esse comportamento pode ser
al terado conforme descri to no i tem Execuo do E3 Viewer - Execuo atravs do Menu
Iniciar.
Windows XP
1. V ao menu Iniciar - Painel de Controle.
2. Cl i que em Central de Segurana.
3. Cl i que em Firewall do Windows.
4. Sel eci one a aba Excees e cl i que em Adicionar Porta.
5. Di gi te um nome e o nmero da porta a ser l i berada. Dei xe a opo Protocolo
sel eci onada como TCP.
6. Cl i que em OK para sal var as al teraes.
Windows Vista
3. Sel eci one a aba Excees e cl i que em Adicionar Porta.
4. Di gi te um nome e o nmero da porta a ser l i berada. Dei xe a opo Protocolo
sel eci onada como TCP.
5. Cl i que em OK para sal var as al teraes.
Windows 7
3. Cl i que na opo Configuraes Avanadas.
4. Sel eci one a opo Regras de Sada.
5. Cl i que em Nova Regra.
6. Sel eci one o i tem Porta e cl i que em Avanar.
7. Sel eci one a opo TCP e em Portas Remotas Especficas di gi te o nmero da porta
a ser l i berada.
8. Na prxi ma janel a, sel eci one Permitir a Conexo.
9. Di gi te um nome para a porta e cl i que em OK para sal var as al teraes e fechar
a janel a.
No consigo abrir um Viewer remoto pelo Internet Explorer. Por qu isso est
acontecendo?
POSSVEIS CAUSAS
O Vi ewer no foi i nstal ado na mqui na remota
Exi ste um firewall bl oqueando o acesso ao servi dor
SOLUO
Pode-se i nstal ar o Vi ewer na mqui na remota ou ento col ocar o arqui vo de
i nstal ao do Vi ewer na pasta C:\Inetpub\wwwroot do computador servi dor. Assi m,
toda vez que se tentar abri r um Vi ewer pel o Internet Expl orer em um computador
remoto onde o Vi ewer no foi previ amente i nstal ado, a i nstal ao ser i ni ci ada
automati camente.
27.15 Bibliotecas
Ao abrir uma Tela, aparece uma mensagem dizendo que um objeto no pode ser
carregado corretamente
POSSVEL CAUSA
Foi apagado al gum XControl da Bi bl i oteca que estava sendo usada dentro desta
Tel a ou ento foi removi do do Domni o a Bi bl i oteca que contm este XControl .
SOLUO
No pri mei ro caso, se foi apagado o XControl , no h mai s como recuper-l o. Para
corri gi r o erro, s apagar o objeto El i pseX que fi cou dentro da Tel a (pel o
Organi zer pode-se ver um ponto de i nterrogao sobre o cone do objeto. Na Tel a
aparece um quadrado preto com um X). No segundo caso, basta adi ci onar a
Bi bl i oteca ao Domni o.
Ao abrir uma Tela, aparece uma mensagem de erro dizendo que no foi possvel
abrir uma Biblioteca ActiveX
POSSVEL CAUSA
Al guns Acti veX uti l i zados nesta Tel a no foram regi strados e adi ci onados no
computador.
SOLUO
Regi stre e adi ci one o Acti veX atravs da opo Adicionar ActiveX, di sponvel no
menu Ferramentas. Para tanto, deve-se ter o arqui vo OCX que contm a Bi bl i oteca.
Ao inserir um ActiveX na minha Tela ocorreu um erro 80040112. O qu isto
significa?
POSSVEL CAUSA
Este erro i ndi ca que o Acti veX a ser i nseri do no est l i cenci ado na mqui na.
Durante o i nstanci amento, o control e procura no Regi stro do Wi ndows por sua
chave de l i cena (HKEY_CLASSES_ROOT\Licenses) e, caso no encontre, retorna este
erro. Exi stem chaves de l i cena para os objetos Acti veX, tanto para ambi entes de
desenvol vi mento quanto para tempo de execuo.
SOLUO
Para resol ver este probl ema, preci so adqui ri r a l i cena deste Acti veX e regi str-l o
em seu computador.
Tenho duas Bibliotecas em meu Domnio, mas no consigo utiliz-las ao mesmo
tempo. Quando registro uma, a outra deixa de funcionar. Como posso resolver este
problema?
Provavel mente, uma das Bi bl i otecas foi cri ada a parti r da cpi a da outra, fi cando
as duas com o mesmo i denti fi cador. Por i sto, ser necessri o remover uma del as
do Domni o.
27.16 Relatrios
Como colocar a data e a hora atual em um Relatrio do E3?
Exi stem pel o menos duas al ternati vas para sol uci onar i sso:
Col oque um Texto na seo PageHeader e, no evento OnFormat da seo
PageHeader, escreva o segui nte scri pt:
Report.Sections("PageHeader").Controls("Label1")._
Caption = Now
Onde Label1 o nome do rtul o cri ado.
Cri e um Tag Demo do ti po CurrentTime. No cabeal ho ou no rodap do Rel atri o,
deve-se i nseri r um objeto SetPoi nt, e na propri edade DataField, deve-se di gi tar o
nome compl eto do Tag (por exempl o, Dados.TagDemo1.Value). Confi gure o
formato da data desejada. Isto pode ser fei to cl i cando com o boto di rei to do
mouse sobre o objeto e ajustando as suas propri edades, ou ento di gi tando
di retamente o formato na propri edade OutputFormat, na Li sta de Propri edades (um
exempl o de formato de data "dd/MM/yyyy hh:mm:ss").
Tenho um Relatrio que mostra o resultado de uma Consulta que possui um filtro
por data. Quando o Relatrio gerado, a Consulta no retorna os valores
configurados via script para estas variveis. Como solucionar este problema?
Veri fi que, no scri pt que confi gura ou acessa este Rel atri o, se aps os val ores para
as vari vei s da Consul ta terem si do confi gurados no foi aci onado o mtodo
LoadReport, j que este mtodo carrega o Rel atri o com as confi guraes fei tas no
E3 Studi o. Uti l i ze somente uma vez o mtodo LoadReport no scri pt, carregando o
Rel atri o para uma vari vel (atravs do comando Set).
Como executar corretamente um Relatrio que utiliza o mtodo CopyConfig para
copiar para si as configuraes de um E3Chart em Tela?
O mtodo CopyConfig no copi a os val ores de vari vei s de consul ta, sendo
necessri o fazer i sto vi a scri pt dentro do grfi co. As penas confi guradas no
E3Chart em Tel a so do ti po Real.
Como fazer um filtro por datas no Relatrio?
Cri e uma Consul ta SQL no Rel atri o fi l trando por data i ni ci al e fi nal . Na Tel a onde
se deseja gerar este Rel atri o, deve-se executar a Consul ta SQL confi gurada
passando os val ores de data i ni ci al e fi nal . O scri pt do boto na Tel a onde gerado
o Rel atri o, por exempl o, pode ser i mpl ementado assi m:
DataInicial = CDate(Screen.Item("TextoDataInicial").Value)
DataFinal = CDate(Screen.Item("TextoDataFinal").Value)
Set Report1 = Application.LoadReport("Report1")
Set Consulta = Report1.Item("Query1")
Consulta.SetVariableValue "DataInicial", (DataInicial)
Consulta.SetVariableValue "DataFinal", (DataFinal)
Report1.PrintPreview()
Como mostrar as datas utilizadas como filtro na Consulta no Page Header do
Relatrio?
Pri mei ramente, adi ci one doi s Setpoi nts no PageHeader (um para mostrar a data
i ni ci al e outro para a data fi nal ) e cri e um scri pt que passe os val ores que foram
carregados nos Setpoi nts da Tel a (e transferi dos para a Consul ta) para estes doi s
Setpoi nts. O scri pt a ser cri ado no objeto Page Header, no evento OnBeforePrint do
Rel atri o:
Set dados = Application.GetFrame().Screen
Report.Sections("PageHeader").Controls("Field5").Text = _
dados.Item("TextoDataInicial").Value
Report.Sections("PageHeader").Controls("Field6").Text = _
dados.Item("TextoDataFinal").Value
Depoi s, associ e doi s Tags Internos aos Setpoi nts da Tel a onde so especi fi cadas as
datas. Associ e estes Tags aos Setpoi nts no Rel atri o.
Como imprimo dois Relatrios em impressoras diferentes?
Cri e o segui nte scri pt no evento OnReportStart do Rel atri o:
Sub OnReportStart
Report.Printer.DeviceName = "Nome da Impressora"
End Sub
Como utilizo o evento de script OnError para mostrar uma mensagem de erro
quando falhar a impresso do Relatrio?
O evento OnError do Rel atri o no permi te que sejam executados scri pts dentro
del e, servi ndo somente para seu uso i nterno. Isto si gni fi ca que no possvel
al terar a mensagem de erro, nem executar al gum outro procedi mento a parti r deste
evento.
27.17 Domnios e Projetos
O qu acontece com os eventos gerados pelo E3 Server enquanto o Domnio no
est rodando?
Sempre que o regi stro de eventos esti ver habi l i tado, o E3 Server vai col ocar os
eventos gerados na l i sta i nterna de eventos (em memri a). Esta l i sta esvazi ada em
trs si tuaes:
Se exi ste um E3Run rodando l ocal mente (i sto , o E3 Server est em estado Hot),
os eventos da l i sta so envi ados para o E3Run para serem gravados no Banco de
Dados. Se a gravao funci onar, os eventos gravados so removi dos da l i sta
Se exi ste outro E3 Server rodando em estado Hot no Domni o, as mensagens
sero envi adas para este E3 Server
Se o Domni o for fechado, todas as mensagens que ai nda no foram gravadas
so descartadas
Utilizei o E3 Admin via linha de comando e apareceu um erro. Por qu isto ocorreu?
Mui tas vezes, quando se uti l i za o E3 Admi n vi a l i nha de comando, pode-se
confi gurar al gum parmetro errado, o que acaba provocando uma mensagem de
erro. As mensagens de erro que podem aparecer so as segui ntes:
O Domnio no pode ser aberto porque o arquivo 'nomedoarquivo.dom'
somente para leitura
Esta mensagem aparece quando o arqui vo de Domni o somente de l ei tura
(read-only)
As opes no so vlidas ou o nome do Domnio no est correto. Verifique as
opes informadas e se o Domnio existe
Esta mensagem aparece quando for i nformada uma opo i nexi stente, um
nome de Domni o i nexi stente ou quando o arqui vo do Domni o no for
l ocal i zado, provavel mente por ter si do i nformado um cami nho i nvl i do para
o Domni o
O nome do Domnio no foi informado
Esta mensagem aparece quando forem usadas as opes -viewer ou -start
sem o nome de Domni o. Para mai ores i nformaes, consul te o captul o
Domnios
Como duas ou mais pessoas podem trabalhar ao mesmo tempo no mesmo
Domnio?
Cri ando o Domni o pel a rede, vri as pessoas podero abri -l o em mqui nas
di ferentes e trabal har nel e ao mesmo tempo. As al teraes sal vas por uma pessoa
sero vi svei s para todas as outras, assi m que abri rem o objeto especfi co
al terado, ou ento assi m que atual i zarem o projeto ou a Bi bl i oteca al terados.
Qual o efeito de clicar na opo Atualizar do menu do projeto?
Todos os objetos do projeto so atual i zados. Por exempl o, se vri as pessoas
esti verem trabal hando ao mesmo tempo no mesmo Domni o, as al teraes sal vas
por uma pessoa sero vi svei s para todas as outras, assi m que abri rem o objeto
especfi co al terado ou quando atual i zarem o projeto ou a Bi bl i oteca al terados.
27.18 Stored Procedure
Como executo uma Stored Procedure no E3?
A manei ra mai s fci l cri ando uma Consul ta no E3 com o comando para executar a
Stored Procedure desejada passando, se necessri o, val ores para el a. O comando
que deve ser confi gurado nesta Consul ta o segui nte:
Exec NomeDaStoredProcedure <%var1%>, <%var2%>, ...
Onde a si ntaxe das vari vei s o si nal de mai or que, o si nal de percentual entre o
nome da vari vel e o si nal de menor que. var1 e var2 so as vari vei s que a Stored
Procedure est esperando (por exempl o, data i ni ci al e fi nal ). Caso a Stored
Procedure no esteja esperando nenhuma vari vel , basta cri ar o comando SQL sem
as vari vei s. Para executar esta Consul ta, basta uti l i zar o mtodo Execute.
NOTA: A propri edade CursorLocation da Consul ta do E3 dever estar confi gurada
como 1 - clClient.
27.19 Domnios Remotos
Como funciona o licenciamento dos Domnios Remotos?
Tanto o E3 Server rodando o Domni o Cl i ente quanto o que roda o Domni o Servi dor
devem ter l i cenas especfi cas para Domni os Remotos. Quando essa l i cena exi ste,
o E3 Server Servi dor passa a acei tar um nmero i l i mi tado de conexes externas de
outros Domni os. Da mesma forma, no caso do E3 Server Cl i ente, ser possvel
estabel ecer um nmero i l i mi tado de conexes. Para mai ores i nformaes sobre as
l i mi taes do modo Demo do E3, veja o tpi co Limitaes do Modo Demonstrao.
Quando cai a comunicao entre o Domnio Cliente e o Domnio Servidor, o qu
acontece?
Quando uma si tuao de erro ocorrer, todos as Associ aes da apl i cao cl i ente
referenci ando o Domni o fi caro desconectadas (Di spl ays, por exempl o, passaro
a mostrar o texto que i ndi ca erro de comuni cao, conforme as confi guraes do
objeto Vi ewer), assi m como todos os comandos Application.GetObject
referenci ando o Domni o Remoto i ro fal har (ou seja, causaro erros de scri pt).
Quando o probl ema for resol vi do, as Associ aes devero reconectar-se
automati camente. J os comandos Application.GetObject devero ser executados
novamente.
Um Domnio Cliente pode visualizar Alarmes de outros Domnios Remotos?
No, mas i sso uma caractersti ca que poder ser i mpl ementada em verses
futuras. Agora, necessri o dupl i car os Al armes no Domni o Remoto.
Um Domnio Cliente pode abrir Telas de outros Domnios Remotos?
No.
Um Domnio Cliente pode usar usurios de outros Domnios Remotos?
No.
possvel conectar um Domnio a vrios outros Domnios?
Si m, como pode-se ver na fi gura a segui r.
Conectar um Domnio a vrios outros Domnios
possvel conectar um Domnio a um Domnio em Hot-Standby?
Si m. Consi dere a segui nte arqui tetura.
Conectar um Domnio a um Domnio em Hot-Standby
Atravs dos Domni os Remotos essa arqui tetura possvel . Tem-se um Domni o de
Comuni cao, em Hot-Standby, comuni cando com os di sposi ti vos. Esses dados
seri am l i dos por um outro Domni o, tambm em Hot-Standby, que seri am o servi dor
para os computadores cl i entes (Vi ewers).
Matriz
Rua 24 de Outubro, 353 - 10 andar
90510-002 Porto Alegre RS
Fone: (51) 3346-4699
Fax: (51) 3222-6226
E-mail: elipse@elipse.com.br
Filial SP
Rua dos Pinheiros, 870 - Conj. 141/142
05422-001 So Paulo - SP
Fone: (11) 3061-2828
Fax: (11) 3061-2828
E-mail: elipse-sp@elipse.com.br
Filial PR
Av. Sete de Setembro, 4698/1705
80240-000 Curitiba - PR
Fone: (41) 3342-0120
Fax: (41) 3342-0120
E-mail: elipse-pr@elipse.com.br
Consulte nosso website para informaes sobre o representante do seu estado.
www.elipse.com.br
USA
2501 Blue Ridge Road, Suite 250
Raleigh - NC - 27607 USA
Fone: +1 (252) 995-6885
Fax: +1 (252) 995-5686
E-mail: info@elipse-software.com
Filial MG
Rua Antnio de Albuquerque, 156
7 andar Sala 705
30112-010 Belo Horizonte - MG
Fone: (31) 2511-2121
E-mail: elipse-mg@elipse.com.br
Taiwan
9F., No.12, Beiping 2nd St., Sanmin Dist.
807 Kaohsiung City - Taiwan
Telefone: +886 (7) 323-8468
Fax: +886 (7) 323-9656
E-mail: evan@elipse.com.br
Filial RJ
Praia de Botafogo, 300/525
22250-044 Rio de Janeiro - RJ
Fone: (21) 2158-1015
Fax: (21) 2158-1099
E-mail: elipse-rj@elipse.com.br
kb.elipse.com.br
elipse@elipse.com.br

E3manual PTB

Загружено:

Сведения о документе

Оригинальное название

Авторское право

Доступные форматы

Поделиться этим документом

Поделиться или встроить документ

Параметры публикации

Этот документ был вам полезен?

Это неприемлемый материал?

Авторское право:

Доступные форматы

E3manual PTB

Загружено:

Авторское право:

Доступные форматы

2013 Elipse Software Ltda. Todos os direitos reservados. Verso 4.

Вам также может понравиться