You are on page 1of 163

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

5 (05/12/2013)
Tutorial do E3 para Desenvolvedores
Sumrio
............................................................................................................... 7 1 Apresentao
............................................................................................................... 7 1.1 A Elipse
............................................................................................................... 7 1.2 Mdulos do E3
............................................................................................................... 7 1.3 O Treinamento
............................................................................................................... 11 2 Elipse Knowledgebase
............................................................................................................... 11 2.1 Elipse Knowledgebase
............................................................................................................... 11 2.2 Busca no Knowledgebase
............................................................................................................... 12 2.3 Categorias
............................................................................................................... 14 2.4 Anotaes
............................................................................................................... 15 3 Iniciando a Aplicao
............................................................................................................... 15 3.1 Criando a Aplicao
............................................................................................................... 18 3.2 Execuo de um Domnio
............................................................................................................... 18 3.3 Exerccios
............................................................................................................... 19 3.4 Exerccios Complementares
............................................................................................................... 20 3.5 Anotaes
............................................................................................................... 21 4 Servidor de Dados
............................................................................................................... 21 4.1 Regras para Nomes de Tags
............................................................................................................... 21 4.2 Exerccios
............................................................................................................... 24 4.3 Anotaes
............................................................................................................... 25 5 Telas e Quadros
............................................................................................................... 25 5.1 Tela
............................................................................................................... 25 5.2 Quadros
............................................................................................................... 26 5.3 Viewer
............................................................................................................... 28 5.4 Exerccios
............................................................................................................... 30 5.5 Anotaes
............................................................................................................... 31 6 Objetos de Tela
............................................................................................................... 31 6.1 Controles Microsoft Forms
............................................................................................................... 31 6.2 Galeria
............................................................................................................... 32 6.3 Exerccios
............................................................................................................... 35 6.4 Exerccios Complementares
............................................................................................................... 36 6.5 Anotaes
............................................................................................................... 37 7 Associaes
............................................................................................................... 37 7.1 Tipos de Associao
............................................................................................................... 40 7.2 Edio de Associaes
............................................................................................................... 41 7.3 Valores Booleanos
............................................................................................................... 41 7.4 Exerccios
............................................................................................................... 45 7.5 Anotaes
............................................................................................................... 46 8 Comunicao
............................................................................................................... 46 8.1 Driver de Comunicao
............................................................................................................... 49 8.2 Driver de Comunicao OPC
............................................................................................................... 52 8.3 Exerccios Complementares
............................................................................................................... 53 8.4 Anotaes
............................................................................................................... 54 9 Scripts
............................................................................................................... 54 9.1 Definindo Scripts
............................................................................................................... 61 9.2 Eventos
............................................................................................................... 62 9.3 Mtodos
............................................................................................................... 63 9.4 Propriedades
............................................................................................................... 63 9.5 Exerccios
............................................................................................................... 64 9.6 Exerccios Complementares
............................................................................................................... 65 9.7 Anotaes
............................................................................................................... 66 10 Segurana
............................................................................................................... 66 10.1 Usurios
............................................................................................................... 66 10.2 Grupos
............................................................................................................... 67 10.3 Permisses
............................................................................................................... 68 10.4 Proteo
............................................................................................................... 69 10.5 Exerccios
............................................................................................................... 70 10.6 Exerccios Complementares
............................................................................................................... 73 10.7 Anotaes
............................................................................................................... 74 11 Bibliotecas ElipseX
............................................................................................................... 74 11.1 Criao de Bibliotecas do Usurio
............................................................................................................... 77 11.2 Quando Criar um ElipseX
............................................................................................................... 77 11.3 Exerccios
............................................................................................................... 82 11.4 Exerccios Complementares
............................................................................................................... 84 11.5 Anotaes
............................................................................................................... 85 12 Banco de Dados
............................................................................................................... 85 12.1 Exerccios
............................................................................................................... 87 12.2 Exerccios Complementares
............................................................................................................... 88 12.3 Anotaes
............................................................................................................... 89 13 Alarmes
............................................................................................................... 89 13.1 Servidor de Alarmes
............................................................................................................... 89 13.2 Configurao de Alarmes
............................................................................................................... 92 13.3 E3Alarm
............................................................................................................... 93 13.4 Exerccios
............................................................................................................... 97 13.5 Exerccios Complementares
............................................................................................................... 98 13.6 Anotaes
............................................................................................................... 99 14 Consultas
............................................................................................................... 99 14.1 Criando uma Consulta
............................................................................................................... 100 14.2 E3Browser
............................................................................................................... 101 14.3 Exerccios
............................................................................................................... 105 14.4 Exerccios Complementares
............................................................................................................... 106 14.5 Anotaes
............................................................................................................... 107 15 Histricos
............................................................................................................... 107 15.1 Chave Primria
............................................................................................................... 107 15.2 ndices
............................................................................................................... 108 15.3 Exerccios
............................................................................................................... 109 15.4 Exerccios Complementares
............................................................................................................... 110 15.5 Anotaes
............................................................................................................... 111 16 E3Chart
............................................................................................................... 111 16.1 Configuraes das Penas
............................................................................................................... 112 16.2 Exerccios
............................................................................................................... 115 16.3 Exerccios Complementares
............................................................................................................... 116 16.4 Anotaes
............................................................................................................... 117 17 Relatrios
............................................................................................................... 118 17.1 Objetos do Relatrio
............................................................................................................... 119 17.2 Exerccios
............................................................................................................... 123 17.3 Anotaes
............................................................................................................... 124 18 Frmulas
............................................................................................................... 124 18.1 Exerccios
............................................................................................................... 125 18.2 Exerccios Complementares
............................................................................................................... 127 18.3 Anotaes
............................................................................................................... 128 19 Storage
............................................................................................................... 128 19.1 Funcionamento
............................................................................................................... 128 19.2 Configurao
............................................................................................................... 128 19.3 Consultas Internas
............................................................................................................... 130 19.4 Exerccios
............................................................................................................... 131 19.5 Exerccios Complementares
............................................................................................................... 132 19.6 Anotaes
............................................................................................................... 133 20 E3Playback
............................................................................................................... 133 20.1 Interface de Usurio do E3Playback
............................................................................................................... 134 20.2 Restries e Comentrios
............................................................................................................... 135 20.3 Licenciamento
............................................................................................................... 135 20.4 Exerccios
............................................................................................................... 136 20.5 Exerccios Complementares
............................................................................................................... 137 20.6 Anotaes
............................................................................................................... 138 21 Hot-Standby
............................................................................................................... 138 21.1 Configuraes do Hot-Standby
............................................................................................................... 141 21.2 Exerccios
............................................................................................................... 142 21.3 Exerccios Complementares
............................................................................................................... 143 21.4 Anotaes
............................................................................................................... 144 22 Domnios Remotos
............................................................................................................... 144 22.1 Configurao no Studio
............................................................................................................... 144 22.2 Compartilhamento da Pasta do Domnio Servidor
............................................................................................................... 148 22.3 Licenas
............................................................................................................... 148 22.4 Sintaxe dos Links
............................................................................................................... 148 22.5 Alias Local
............................................................................................................... 149 22.6 Permisses de Acesso
............................................................................................................... 149 22.7 Exerccios
............................................................................................................... 153 22.8 Exerccios Complementares
............................................................................................................... 154 22.9 Anotaes
............................................................................................................... 155 23 Exerccios de Reviso
............................................................................................................... 155 23.1 Exerccio
............................................................................................................... 157 23.2 Resoluo
............................................................................................................... 162 23.3 Anotaes
Apresentao 7
1
Apresentao
CAPTULO
Este tutori al serve como apoi o ao mdul o de trei namento para execuo e programao do E3. Com el e, voc acompanhar o
contedo do curso. Durante as aul as, fi que vontade para prati car o que voc aprendeu e para resol ver suas dvi das com o
i nstrutor. No trei namento, apresentado um estudo de caso que si mul a uma apl i cao real , um si stema de supervi so e
control e.
1.1 A Elipse
A El i pse Software uma empresa genui namente brasi l ei ra, com foco na produo de software de supervi so para automao
i ndustri al , surgi da em Porto Al egre no i nci o dos anos 90.
Seu pri mei ro produto foi o El i pse 21, um software para a pl ataforma DOS, que era conheci do por sua faci l i dade de operao e
compati bi l i dade com di ferentes fabri cantes.
Em 1996, a El i pse l anou a pri mei ra verso do El i pse Wi ndows, que mai s tarde se tornari a o El i pse SCADA. Desde essa poca,
foram i nstal adas cerca de 3.500 cpi as desse software no Brasi l .
Em 2000, a El i pse i ni ci ou o desenvol vi mento do E3, a tercei ra gerao de software de supervi so da empresa. Desde seu
l anamento comerci al em 2001, cerca de 500 l i cenas desse software j foram i nstal adas e o E3 vem sendo uti l i zado em
si stemas di versos, como Centros de Operao de empresas el tri cas, pl antas i ndustri ai s de di versas fi nal i dades, si stemas de
tel emedi o e control e de energi a, automao e control e predi al , mi nerao, entre outros.
A El i pse Software trabal ha em parceri a com di stri bui dores i nternaci onai s l ocal i zados em pases estratgi cos como Al emanha,
Hol anda, Tai wan, ndi a, Canad e outros, al m de manter escri tri o prpri o nos Estados Uni dos, na ci dade de Avon, Carol i na
do Norte.
1.2 Mdulos do E3
Ini ci al mente, ser vi sto que o E3 composto de quatro mdul os, descri tos a segui r.
1.2.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 (Intranet e Internet). O Servi dor pode executar vri os projetos ao mesmo tempo e conversar com outros E3
Servers para real i zar um failover (standby) ou di stri bui r cargas de processamento entre as mqui nas. Foi desenvol vi do para
ser executado sobre os si stemas operaci onai s 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.
1.2.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.2.3 E3 Viewer
O Vi ewer permi te operar as apl i caes resi dentes no servi dor em qual quer computador com o programa executvel Vi ewer
(Wi ndows XP, 2003, Vi sta e Wi ndows 7) 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 todos os componentes (Tel as, Bi bl i otecas, control es Acti veX) sero bai xados e regi strados
automati camente.
1.2.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.
1.3 O Treinamento
A sequnci a de aprendi zado a ser segui da neste tutori al refl ete o que a El i pse Software consi dera o conjunto de mel hores
prti cas no desenvol vi mento de apl i cati vos de supervi so e control e, tanto para o E3 (o objeto de estudo deste Tutori al )
quanto para o El i pse SCADA ou outros softwares de supervi so.
A base do rotei ro desse manual uma apl i cao hi potti ca, que apresenta os recursos mai s i mportantes do software El i pse
8 Apresentao
E3. Essa apl i cao no cobre todas as possi bi l i dades de desenvol vi mento ofereci das pel a ferramenta. No entanto, a
quanti dade e qual i dade das i nformaes apresentadas neste pri mei ro contato com o software so sufi ci entes para que voc
aprenda a uti l i z-l o com autonomi a para cri ar suas prpri as apl i caes.
A sequnci a do trei namento a segui nte:
Apresentao da ferramenta
Tel as e Objetos de Tel a: como cri ar i nterfaces grfi cas para suas apl i caes
Uso de Associ aes: um modo fci l e efeti vo de mostrar i nformaes ou cri ar ani maes em Tel as
Comuni cao de dados: uso de Dri vers e uso de OPC
Uso de Bi bl i otecas El i pseX: poderosa ferramenta de bi bl i otecas funci onai s di sponvel apenas no E3
Integrao com Bancos de Dados: uso de funes e ferramentas para acesso e consul ta a Bancos de Dados, com foco em
processos
Al armes: uso e control e de Al armes no E3
Rel atri os: poderosa ferramenta i ncorporada ao E3. Traz faci l i dade e grande quanti dade de recursos para a cri ao de
rel atri os
Recursos Avanados: redundnci a, acesso ao apl i cati vo atravs de browser, confi guraes de segurana de usuri os, entre
outros
Sua parti ci pao mui to i mportante para ns. Ao fi nal do trei namento, ser sol i ci tado que voc aval i e di versos aspectos do
curso, como a qual i dade e a quanti dade das i nformaes transmi ti das em aul a e pel o tutori al , al m do trabal ho do i nstrutor
e a qual i dade das i nstal aes. Qual quer sugesto ou crti ca bem-vi nda pel a equi pe de desenvol vi mento desse tutori al .
A El i pse Software deseja a voc um ti mo trei namento, e uma boa experi nci a de trabal ho com o El i pse E3!
1.3.1 Aplicao de Treinamento
No trei namento, apresentado um estudo de caso que si mul a uma apl i cao real , um si stema de supervi so e control e. O
i nstrutor desenvol ve a apl i cao junto com os al unos passo a passo, faci l i tando o entendi mento e o aprendi zado da
ferramenta.
O si stema em questo apresenta um si nti co de uma fbri ca de ti ntas, exempl i fi cando vri os aspectos e recursos di sponvei s
no El i pse E3.
O operador do si stema pode vi sual i zar as temperaturas e o nvel dos tanques, a cor da ti nta a ser produzi da e control ar o
funci onamento das bombas.
Tela principal da aplicao
Para garanti r a execuo da apl i cao, i mpl ementaremos o concei to de Hot-Standby. Assi m, 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.
Apresentao 9
Menu da aplicao
O si stema tambm mostrar condi es de al arme no caso de al gum parmetro ul trapassar os l i mi tes estabel eci dos (como
por exempl o, um aumento excessi vo de temperatura).
Alarmes
Exi sti r um procedi mento de consul ta dos al armes, que permi te vi sual i zao e i mpresso dos dados de hi stri cos.
Tela de consulta de Alarmes
Al m de cri ar grfi cos de tendnci a das vari vei s com a opo de i mpri mi r e exportar o grfi co hi stri co.
Grfico de Tendncia
10 Apresentao
Fi nal mente, acessaremos i nformaes de outro servi dor E3 atravs de Domni os Remotos.
Domnio Remoto
Elipse Knowledgebase 11
2
Elipse Knowledgebase
CAPTULO
O Elipse Knowledgebase tem como fi nal i dade ajudar o usuri o dos softwares da El i pse a encontrar respostas rpi das para
dvi das ou probl emas que esteja enfrentando durante a sua uti l i zao. Seja no desenvol vi mento de apl i caes ou depoi s de
t-l as prontas. Este espao nada mai s do que um portal onde mui tas i nformaes tcni cas e di cas esto concentradas. A sua
base de i nformaes constantemente atual i zada e tem uma l i nguagem si mpl es que vi sa o rpi do entendi mento de quem est
uti l i zando.
Aps acessar o endereo kb.elipse.com.br, voc estar na pgi na i ni ci al .
Pgina inicial do KB
2.1 Elipse Knowledgebase
No cabeal ho da pgi na exi stem as segui ntes opes:
Glossrio: permi te acessar todo o gl ossri o de pal avras que a ferramenta possui
Favoritos: link que mostra todos os arti gos da base de dados que esto assi nal ados como favori tos
Login: serve apenas para uso da El i pse
2.2 Busca no Knowledgebase
Este campo busca em toda a base de dados pel a pal avra ou pal avras que o usuri o di gi tar, retornando todos os arti gos que
possuem a pal avra al vo da busca. Basta di gi tar a pal avra que se deseja buscar e ento cl i car em Busca.
Busca no KB
Ai nda exi ste a possi bi l i dade de uti l i zar a Busca Avanada, que permi te refi nar a consul ta. Basta acessar a opo Busca
Avanada.
12 Elipse Knowledgebase
Busca Avanada
Na opo Busca Avanada o usuri o pode di gi tar a pal avra ou pal avras que deseja buscar, fi l trar por categori a especfi ca,
autor e ai nda pel a cl assi fi cao do arti go. Isto , se el e ajudou mui to, apenas ajudou, no ajudou ou ajudou pouco.
2.3 Categorias
Exi ste a possi bi l i dade de o usuri o acessar todos os arti gos escol hendo di retamente a categori a a que el e pertence. Para i sto,
no campo Categorias, basta sel eci onar a categori a em que se deseja buscar os arti gos e ento cl i car em Ir.
Escolha de categorias
Todos os arti gos desta categori a sero retornados como resul tado da busca. i mportante ressal tar que toda a base de
conheci mento est di vi di da em duas categori as pri nci pai s, Ingls e Portugus. Dentro del as exi stem as categori as Elipse E3,
Elipse SCADA, Elipse 21 DOS, Elipse Drivers OPC, Altus TCP/IP e Drivers. Dentro destas ci nco categori as exi stem di versas outras,
cada uma del as tratando de um tema especfi co. Acessando os arti gos pel a categori a Portugus - Elipse E3 tem-se:
Categorias em portugus
Elipse Knowledgebase 13
Note que dentro de cada uma destas subcategori as aparece um nmero. Este nmero i ndi ca a quanti dade de arti gos exi stentes
dentro da categori a.
As demai s sees exi stentes na pgi na pri nci pal do Knowl edgebase so:
Artigos Em Destaque: Mostra todos os arti gos que esto cl assi fi cados para aparecerem em destaque. Normal mente esta
seo uti l i zada para ressal tar al gum arti go que merece uma ateno especi al por parte dos usuri os dos softwares da
El i pse
Artigos Mais Lidos: Mostra a l i sta dos 10 arti gos mai s l i dos no Knowl edgebase
ltimos Artigos Adicionados: Mostra a l i sta dos l ti mos 10 arti gos que foram adi ci onados na base de dados do
Knowl edgebase
Buscas Mais Utilizadas: Mostra as 10 pal avras que mai s foram uti l i zadas como busca pel a ferramenta de busca do
Knowl edgebase
14 Elipse Knowledgebase
2.4 Anotaes
Iniciando a Aplicao 15
3
Iniciando a Aplicao
CAPTULO
Aps i nstal ar o software, voc ter em sua mqui na um grupo de programas chamado Elipse E3, com um cone para
acessar o E3 Studi o. Quando o E3 i ni ci ado, o si stema abre uma cai xa de di l ogo com al gumas opes do projeto.
Caixa de dilogo inicial do E3 Studio
As opes di sponvei s so:
Opes disponveis na caixa de dilogo inicial do E3
OPO DESCRIO
Iniciar o E3 Studio I ni ci a o E3 Studi o, mas no abre nenhum Domni o.
Criar um Domnio novo Cri a um novo Domni o atravs do Assi stente de apl i caes do
E3. Sero requi si tados o nome e cami nho do novo Domni o.
Abrir um Domnio existente Abre um Domni o exi stente dentre os l ti mos edi tados.
Cl i cando em Outros arquivos, pode-se l ocal i zar um Domni o em
um di retri o especfi co.
3.1 Criando a Aplicao
Para cri ar uma nova apl i cao, uti l i ze o Assi stente de Apl i caes. Para acess-l o, cl i que em Novo na barra de ferramentas
Padro.
16 Iniciando a Aplicao
Assistente de Aplicaes
O E3 trabal ha com trs ti pos de arqui vos de projeto, descri tos a segui r.
3.1.1 Projetos
Contm defi ni es de objetos, Tags, Tel as e outros componentes de uma apl i cao. Os arqui vos .prj so cri ados atravs das
opes Aplicao Padro e Aplicao em Branco. A pri mei ra opo cri a um projeto pr-confi gurado com al guns objetos bsi cos
e um assi stente de cri ao de projeto, enquanto a segunda opo cri a um projeto vazi o a ser i mpl ementado pel o usuri o.
3.1.2 Bibliotecas
Contm defi ni es de objetos cri ados pel o usuri o (El i pseX) para serem uti l i zados em projetos. Essas bi bl i otecas podem ser
reuti l i zadas em di ferentes projetos, mas mantm vncul os com a apl i cao. Ou seja, se a bi bl i oteca for al terada, todos os
objetos dessa bi bl i oteca sero atual i zados nos projetos automati camente.
3.1.3 Configurao do Domnio
Armazena quatro ti pos de i nformaes: opes de confi gurao do Domni o, l i sta de arqui vos .prj e .l i b, confi guraes dos
servi dores que i ro rodar o Domni o e confi guraes de segurana (usuri os e permi sses). Sem esse arqui vo, um projeto no
pode ser executado no E3. Esse i tem ser vi sto mai s adi ante.
3.1.4 Organizer
O Organizer permi te uma vi so si mpl es e organi zada de toda a sua apl i cao, ajudando na edi o e confi gurao de todos os
objetos envol vi dos no si stema atravs de uma rvore hi errqui ca de opes. Possui doi s modos de vi sual i zao, Domnio e
Explorer.
Iniciando a Aplicao 17
Janela do Organizer em modo Domnio
O modo Domnio mostra apenas as i nformaes dos objetos abertos pertencentes ao Domni o, organi zadas em quatro
grupos, Configurao, Bibliotecas de Objetos, Visualizao e 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 bi bl i oteca ao qual pertencem, ordenados al fabeti camente dentro de cada projeto ou bi bl i oteca.
3.1.5 Lista de Propriedades
A Lista de Propriedades uma janel a que mostra todas as propri edades do objeto em uso, permi ti ndo a sua confi gurao de
forma si mpl es e rpi da. Sempre que uma propri edade for confi gurada na Li sta de Propri edades, seu val or no ser mudado
automati camente, a menos que se construa uma associ ao (que ser vi sta mai s adi ante). A Li sta de Propri edades pode ser
acessada pel o menu Visualizar - Lista de Propriedades ou cl i cando em na Barra de Ferramentas.
18 Iniciando a Aplicao
Lista de Propriedades
3.2 Execuo de um Domnio
Para executar ou vi sual i zar um projeto no E3, necessri o que o Domni o seja col ocado em execuo. Para i sso, exi stem os
segui ntes botes no E3 Studi o:
Executar aplicativo: Sal va todas as confi guraes dos projetos e bi bl i otecas, i ni ci a a execuo do Domni o e executa o
Vi ewer
Rodar/Parar Domnio: Ini ci a ou para a execuo do Domni o
Executar ou parar o E3 Viewer: Executa o Vi ewer ou para a sua execuo
3.3 Exerccios
3.3.1 Domnio
1. Ini ci e o E3 Studi o sel eci onando a opo Criar um Domnio novo. O Assi stente de Apl i caes ser aberto.
Assistente de Aplicaes
Iniciando a Aplicao 19
2. No Assi stente de Apl i caes, cl i que em Avanar, sel eci one a opo Aplicao Padro e nomei e o projeto como
TreinamentoE3.
3. Ajuste o cami nho da apl i cao para C:\Trei namentoE3 e cl i que em Avanar.
4. Na prxi ma janel a do assi stente, sel eci one a opo Criar um novo Domnio e use o mesmo nome do projeto.
5. Escol ha a resol uo da tel a.
Resoluo do Viewer
6. Responda No s perguntas sobre comuni cao, banco de dados e al armes.
7. Ao fi m destes procedi mentos, voc ter acesso rea de trabal ho do Studi o.
3.4 Exerccios Complementares
3.4.1 KB
KB-28984: Tempo de execuo uti l i zando apenas l i cena de Studi o.
20 Iniciando a Aplicao
3.5 Anotaes
Servidor de Dados 21
4
Servidor de Dados
CAPTULO
O Servidor de Dados o mdul o responsvel pel a execuo e gerenci amento de Tags e objetos que no estejam envol vi dos
di retamente com a comuni cao. Atravs do Servi dor de Dados pode-se confi gurar Tags i nternos e Tags de si mul ao, al m de
i nseri r XObjects, que so os objetos de dados das bi bl i otecas El i pseX (vi stas mai s adi ante). Al guns dos objetos que podem ser
i nseri dos no Servi dor de Dados so os segui ntes:
Objetos que podem ser inseridos no Servidor de Dados
OBJETO DESCRIO
Tag Contador Objeto que faz a contagem de tempo (em segundos) at
ati ngi r um val or pr-determi nado, ou que faz uma certa
contagem i ndefi ni damente.
Tag Demo
Objeto que gera val ores de acordo com a forma de onda.
uti l i zado para si mul ao de val ores. Permi te gerar curvas
defi ni das ou val ores al eatri os.
Tag Interno
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 outros objetos.
Tag Timer
Objeto para contagem de tempo e programao de
ati vi dades. Estabel ece horri os, com repeti es, para
executar aes.
Pasta de Dados
Defi ne grupos e subdi retri os para a organi zao das
i nformaes. Novas pastas podem ser i nseri das dentro de
outras, conforme a necessi dade.
NOTA: Os objetos i nseri dos no Servi dor de Dados sero executados pel o E3 Server, portanto estaro presentes no Servi dor.
Esta i nformao retrata o modo como o E3 trabal ha.
4.1 Regras para Nomes de Tags
Ao especi fi car o nome dos Tags, al guns detal hes devem ser l evados em conta:
O nome do Tag no pode ser estri tamente numri co
O nome do Tag no pode conter operadores l gi cos ou ari tmti cos: (/ * + -)
O nome da vari vel no pode conter caracteres reservados: / ? . , { } [ ] - etc. Esses caracteres so trocados pel o caractere
subl i nhado. Assi m, o si stema apl i ca a Regra dos Colchetes, expl i cada a segui r
4.1.1 Regra dos Colchetes
Ao fazer refernci a a um objeto por scri pt ou ao us-l o em al guma Associ ao, deve-se l evar em conta as segui ntes regras:
Se o pri mei ro caractere no for uma l etra ou um caractere subl i nhado, o nome deve estar entre col chetes
Se al gum dos demai s caracteres (do segundo em di ante) no for uma l etra, um nmero ou um caractere subl i nhado, o nome
tambm deve estar entre col chetes
Caso exi stam caracteres especi ai s (por exempl o, acentos), o nome deve estar entre col chetes
4.2 Exerccios
4.2.1 Horrio do Sistema
Para obter o horri o corrente do si stema necessri o cri ar um Tag Demo que acesse essa i nformao.
1. Na pasta Dados do TreinamentoE3 i nsi ra um Tag Demo com o nome HoraAtual. Confi gure a propri edade Type do Tag
Demo para 3 - CurrentTime.
22 Servidor de Dados
Inserir Tag Demo
4.2.2 Simulao de Valores
Mui tas vezes preci samos de val ores que si mul em os movi mentos. Normal mente esses val ores so reai s e vem de Tags de
Comuni cao, mas nos exercci os do Tutori al usaremos Tags do ti po Demo.
1. Na pasta Dados i nsi ra os Tags Demo com as segui ntes propri edades confi guradas:
Propriedades do Tag Demo
NAME DOCSTRING MINIMUM MAXIMUM PERIOD SCAN TYPE
Nivel1 Ni vel do Tanque1 0 100 2000 200 0 - Random
Nivel2 Ni vel do Tanque2 0 100 2000 200 0 - Random
Temp1 Temperatura do
Tanque1
20 80 20000 500 1 - Si ne
Temp2 Temperatura do
Tanque2
20 80 10000 500 0 - Random
4.2.3 Tanques
A apl i cao representa uma fbri ca que uti l i za como matri a-pri ma as ti ntas vermel ha, verde e azul , produzi ndo as demai s
ti ntas como uma combi nao dessas trs.
1. Na pasta Dados cri e uma Pasta de Dados chamada Tanque1 e i nsi ra trs Tags Internos, Vermelho, Verde e Azul.
2. Confi gure o val or i ni ci al dos trs Tags para Integer.
Servidor de Dados 23
Selecionar tipo de dado
3. Cri e uma cpi a da pasta Tanque1 para cri ar o Tanque2.
Pastas de Dados
24 Servidor de Dados
4.3 Anotaes
Telas e Quadros 25
5
Telas e Quadros
CAPTULO
Telas so janel as para moni toramento de processos, onde so i nseri dos objetos que faro a i nterface do operador com o
si stema. Cada apl i cao pode ter um nmero i l i mi tado de Tel as.
Quadros so objetos para a organi zao e a estruturao da i nterface, cri ando vi sual i zaes compostas para o usuri o
dentro da janel a pri nci pal do Vi ewer ou do seu navegador.
5.1 Tela
A Tela o objeto bsi co de i nterface com o usuri o. Nel a podem-se i nseri r os segui ntes objetos:
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.)
Bi bl i otecas grfi cas do E3 (XControl ) compostas de quai squer objetos aci ma
As Tel as uti l i zam como padro para o tamanho e coordenadas as uni dades Hi metri c, dadas em 1/100 mm, no em pi xel s.
Neste si stema, ao se adi ci onar um val or posi ti vo em x, a coordenada x move-se para a di rei ta. Quando se adi ci ona um val or
posi ti vo em y, a coordenada y move-se para bai xo, sendo a ori gem dada pel o canto superi or esquerdo da Tel a.
As Tel as podem ser abertas em modo Full-Screen, ocupando toda a rea do Vi ewer, ou ai nda como tel as modai s, ocupando
somente o tamanho de suas coordenadas de al tura e de l argura.
Exemplo de Tela
5.2 Quadros
O Quadro o objeto que organi za e estrutura a i nterface, cri ando vi sual i zaes compostas para o usuri o dentro da janel a
pri nci pal do Vi ewer ou do navegador.
No Quadro, pode-se cri ar Di vi sores para vi sual i zar di ferentes Tel as ao mesmo tempo. Cada Di vi sor tambm pode mostrar uma
URL, uma pl ani l ha do Excel , um documento do Word ou um arqui vo PDF.
26 Telas e Quadros
A di sposi o dos Di vi sores dentro do Quadro pode ser hori zontal ou verti cal . Dentro de cada Di vi sor podem ser i nseri dos
outros Di vi sores. 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. Para uti l i zar esse recurso, si ga estes procedi mentos:
1. Cl i que com o boto di rei to do mouse no nome do projeto em Viewers e Quadros e escol ha a opo Inserir Quadro.
2. Para cri ar um Di vi sor, cl i que com o boto di rei to do mouse sobre o Quadro aberto e sel eci one o ti po de di vi so
(hori zontal ou verti cal ).
Selecionar o tipo de diviso
3. Arraste a barra de di vi so com o mouse para a posi o desejada e cl i que com o boto esquerdo do mouse para fi x-l a.
Divises
5.3 Viewer
O objeto Viewer confi gura o modo como o E3 Vi ewer ser vi sual i zado.
O E3 Vi ewer pode rodar 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 as mqui nas onde os E3 Vi ewers sero executados, poi s as Tel as e bi tmaps so trazi dos do servi dor conforme
a necessi dade, em tempo de execuo.
NOTA: S poder exi sti r um objeto Vi ewer em um Domni o.
Na aba Visualizador da Janel a de Propri edades so defi ni das as confi guraes de vi sual i zao do Vi ewer.
Telas e Quadros 27
Propriedades do Viewer
Atravs da aba Configurao, pode-se edi tar as opes rel ati vas janel a, ao ttul o e resol uo do Vi ewer.
Aba Configurao
Na aba Erros de comunicao, pode-se confi gurar um padro para que os Di spl ays e Setpoi nts de toda a apl i cao i ndi quem
erros de comuni cao.
28 Telas e Quadros
Aba Erros de Comunicao
NOTA: Tambm possvel i nseri r Tags no Vi ewer.
5.4 Exerccios
5.4.1 Quadros
1. Cl i que com o boto di rei to do mouse sobre a pasta Viewer e Quadros e escol ha a opo Inserir Quadro em -
TreinamentoE3.prj.
2. Na rea de vi sual i zao do Quadro, cl i que com o boto di rei to do mouse e sel eci one a opo Dividir Horizontalmente,
conforme fi gura.
Dividir Horizontalmente
3. Posi ci one a barra que aparece a cerca de 10% da Tel a, a parti r de seu l i mi te superi or, e pressi one o boto esquerdo do
mouse para fi xar a posi o da barra.
4. Confi gure o tamanho do Di vi sor para 10% na propri edade SplitValue.
5. Chame a Di vi so cri ada de Area_Superior. Para trocar o nome de um objeto, exi stem trs opes:
Sel eci one o objeto no Organi zer e pressi one a tecl a F2. Ser habi l i tada a edi o do nome
Sel eci one o objeto no Organi zer e, na Li sta de Propri edades do objeto, al tere a propri edade Name
Cl i que com o boto di rei to sobre o objeto no Organi zer e sel eci one a opo Renomear
6. Di vi da hori zontal mente o Quadro i nferi or a cerca de 10% da Tel a, a parti r do l i mi te i nferi or. Chame as Di vi ses de
Area_Central e Area_Inferior, respecti vamente.
Divises do Quadro
7. Confi gure o Di vi sor Area_Inferior como Pri nci pal . Isso faz com que o E3 obedea ao tamanho do Di vi sor e o restante da
Telas e Quadros 29
Tel a ser o tamanho do Di vi sor Area_Central. Cl i que com o boto di rei to do mouse em Area_Inferior e escol ha a
opo Configurar como Divisor Principal.
Configurar Divisor Principal
8. Confi gure o tamanho do Di vi sor Area_Inferior como 10% (propri edade SplitValue).
5.4.2 Telas
1. Cl i que com o boto di rei to do mouse sobre a pasta Tel as e escol ha a opo Inserir Tela em - TreinamentoE3.prj.
Inserir Tela
2. Escol ha na l i sta de sel eo o Di vi sor Area_Superior. Isso faz com que a Tel a seja cri ada com o tamanho exato desse
Di vi sor. Marque a opo Configurar como Tela inicial do Divisor e no campo Nome di gi te "Tel aMenu".
Tamanho da Tela
3. Cri e a TelaAlarmes para ser aberta no Di vi sor Area_Inferior. Marque a opo Configurar como Tela inicial do Divisor.
4. Cri e a TelaSinotico, para ser aberta no Di vi sor Area_Central. Marque a opo Configurar como Tela Inicial do Divisor.
30 Telas e Quadros
5.5 Anotaes
Objetos de Tela 31
6
Objetos de Tela
CAPTULO
Os Objetos de Tela so el ementos grfi cos que podem ser i nseri dos nas Tel as para cri ar a i nterface vi sual com o processo.
Podem ser cri ados a parti r da barra de ferramentas Objetos ou atravs do menu Objetos.
Uma vez sel eci onado o objeto que se deseja cri ar, mantenha o boto esquerdo do mouse pressi onado na rea da Tel a,
enquanto movi menta o mouse (um retngul o ponti l hado mostra o tamanho e a forma do objeto). Ao sol tar o boto, o objeto
ser posi ci onado dentro da rea especi fi cada.
6.1 Controles Microsoft Forms
Os objetos Microsoft Forms so componentes de software baseados na tecnol ogi a COM (Component Object Model) da
Mi crosoft. O E3 i nstal a e uti l i za os control es Mi crosoft Forms, que so objetos Acti veX cri ados pel a Mi crosoft. El es podem ser
i nseri dos nas Tel as da apl i cao para real i zar di versas tarefas. A segui r temos a descri o dos objetos Mi crosoft Forms.
Controles Microsoft Forms
CONE OBJETO DESCRIO
Cai xa de Sel eo (Check Box) Uti l i zado para dar ao usuri o uma
escol ha entre doi s val ores, tai s como
Si m e No, True e Fal se ou On e Off.
Boto de Opes (Opti on Button) Uti l i zado para mostrar se um i tem
i ndi vi dual de um grupo est
sel eci onado.
Boto de Comando (Command Button) Uti l i zado para executar uma ao
especfi ca ao pressi on-l o.
Texto (Label ) Uti l i zado para exi bi r um texto descri ti vo,
como ttul os, l egendas, etc.
Li sta (Li st Box) Exi be uma l i sta de val ores.
Barra de Rol agem (Scrol l Bar) Retorna ou defi ne o val or da
propri edade de outro objeto de acordo
com a posi o da cai xa de rol agem.
Boto I ncremento-Decremento (Spi n
Button)
Uti l i zado para i ncrementar e
decrementar um val or.
Edi tor de Texto (Text Box) Uti l i zado para exi bi r i nformaes
di gi tadas pel o usuri o na Tel a.
Boto Li ga-Desl i ga (Toggl e Button) Semel hante ao Boto de Comando,
porm necessi ta um segundo comando
do usuri o para vol tar ao estado normal .
Li sta de Sel eo (Combo Box) Combi na os recursos de uma Li sta e de
um Edi tor de Texto. O usuri o pode
di gi tar um novo val or ou sel eci onar um
val or exi stente.
NOTA: Outros objetos Acti veX de tercei ros tambm podem ser uti l i zados no E3, desde que sejam devi damente regi strados. El es
podem ser adi ci onados atravs do menu Ferramentas - Adicionar ActiveX.
6.2 Galeria
A Galeria uma bi bl i oteca de smbol os vetori ai s, di vi di dos em categori as, que podem ser arrastados para as Tel as. 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 (pode-se, por exempl o, mudar a cor de preenchi mento atravs das propri edades OverrideFillMode, OverrideFillColor e
OverrideLineColor, sem a necessi dade de transformar o objeto em um objeto grfi co do E3).
Al m da bi bl i oteca de smbol os, a Gal eri a tambm mostra os XControl s pertencentes s bi bl i otecas do Domni o corrente.
32 Objetos de Tela
Galeria
NOTA: Ao executar o E3 Studi o em modo Demo (sem l i cena), apenas o pri mei ro el emento de cada conjunto de categori as de
smbol os estar di sponvel .
6.3 Exerccios
6.3.1 Figuras
Todas as fi guras uti l i zadas nesta apl i cao sero sal vas em uma pasta dentro do projeto pri nci pal para que no seja
necessri o preocupar-se com os cami nhos das fi guras ao executar a apl i cao em outro computador.
1. Cl i que com o boto di rei to do mouse em Recursos e escol ha a opo Inserir Recurso em - TreinamentoE3.prj.
Inserir Recurso
Objetos de Tela 33
2. Escol ha todas as fi guras da pasta C:\Trei namentoE3\Fi guras.
6.3.2 Tela Inicial
A Tel a Ini ci al ter o segui nte aspecto:
Tela Inicial
1. Confi gure a propri edade FillStyle para 12 - bkPicture, para habi l i tar uma fi gura de fundo.
2. Para col ocar a fi gura FundoTel aIni ci al como fundo, arraste o bi tmap de Recursos at a propri edade PictureFile da Tel a.
Isto faz com que o E3 uti l i ze o recurso i nseri do e no o arqui vo da i magem (que externo apl i cao). Para escol her a
mel hor posi o da fi gura, pode-se al terar a propri edade PicturePosition.
3. Cri e um objeto Texto com a pal avra "Entrar", e outro com a pal avra "Sai r".
DICA: Para edi tar um texto j exi stente na Tel a, cl i que com o boto di rei to do mouse em ci ma do objeto e sel eci one Editar
Texto.
4. No centro da tel a, posi ci one o texto "Trei namento E3 Studi o".
DICA: Uti l i ze os botes Centralizar Horizontalmente e Centralizar Verticalmente.
5. Logo abai xo do texto "Trei namento E3 Studi o", i nsi ra um segundo texto com a mensagem "El i pse Software Ltda".
6.3.3 TelaMenu
TelaMenu
1. Na TelaMenu, col oque como fi gura de fundo FundoTel aMenu.
2. Insi ra um objeto Command Button e na propri edade Caption di gi te "Ini ci al ".
34 Objetos de Tela
3. Repi ta o procedi mento para cri ar um boto para cada Tel a da apl i cao: Eventos, Grafico, Sinotico, Comunicao, Remoto
e Playback.
4. No canto di rei to da tel a, i nsi ra um Di spl ay para exi bi r o nome do usuri o l ogado.
5. Ao l ado do Di spl ay, i nsi ra um boto com o texto "Logi n".
6. Insi ra um Di spl ay no canto da Tel a para exi bi r o horri o atual .
7. Acesse as propri edades do objeto e sel eci one a aba Formatao. Defi na o formato como Hora, e no i tem Tipo, escol ha
"13:06:03". Essa formatao mostrar as horas, os mi nutos e os segundos.
8. Para vi sual i zar a confi gurao fei ta no exercci o anteri or, acesse a propri edade Value do Di spl ay e escol ha a opo Date.
Formato de Hora
6.3.4 TelaAlarmes
Esta Tel a exi bi r os al armes ati vos da apl i cao.
1. Confi gure a Tel a com o fundo que desejar. Uti l i ze o boto Estilo de preenchimento.
6.3.5 TelaSinotico
TelaSinotico
1. Na TelaSinotico, col oque como fi gura de fundo a i magem FundoTel aSi noti co.
6.3.6 Setpoint
1. Sobre os tanques de cores, i nsi ra Setpoi nts onde ser di gi tada a quanti dade de cada componente de cor.
Habi l i te os l i mi tes do Setpoi nt, al terando a propri edade EnableLimits para True.
Confi gure a propri edade MaxLimit para 255 e MinLimit para 0.
Configurando limites
6.3.7 Galeria
Sobre a estei ra i nsi ra, a parti r da bi bl i oteca de objetos grfi cos (Gal eri a), a fi gura 5Gal l onBucket, que est na pasta Tanks.
Objetos de Tela 35
6.3.8 Retngulo
1. Sobre os tanques di rei ta, desenhe um objeto Retngul o e confi gure as segui ntes propri edades:
BackgroundStyle: 1 - opaque
BackgroundColor: Preto (RGB(0, 0, 0))
VerticalPercentFill: 20
6.3.9 Display
1. Ao l ado de cada tanque i nsi ra um Di spl ay .
2. Confi gure o val or i ni ci al para exi bi r um Double.
3. Formate o Di spl ay como porcentagem e com uma casa deci mal .
6.4 Exerccios Complementares
6.4.1 KB
KB-36216: Inseri ndo objetos na Gal eri a do E3.
36 Objetos de Tela
6.5 Anotaes
Associaes 37
7
Associaes
CAPTULO
Associaes (ou Conexes) so l i gaes fei tas entre propri edades e objetos ou entre 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.
Atravs da aba Associaes da janel a de Propri edades, tem-se acesso a todas as propri edades di sponvei s do objeto a ser
tratado e todos os ti pos possvei s de associ ao para essas propri edades.
Associaes
Pode-se associ ar um objeto ou cri ar uma expresso. Ao cri ar uma expresso ou associ ar um objeto ou propri edade ao campo
Fonte, o texto aparecer na cor azul , caso esse corresponda a um i tem exi stente ou carregado no E3 Studi o. Se o i tem no
exi sti r, ou pertencer a um mdul o no exi stente no Domni o, o texto aparecer em vermel ho, e esse i tem ser mostrado como
um erro, at ser corri gi do ou excl udo com a opo Verificar Domnio.
7.1 Tipos de Associao
Esta seo contm i nformaes sobre os ti pos de Associ aes.
7.1.1 Associao Simples
Na Associao Simples, o val or do campo Fonte copi ado para a propri edade toda vez que a fonte for modi fi cada.
Associao Simples
38 Associaes
7.1.2 Associao Bidirecional
Na Associao Bidirecional acontece o mesmo que na Associ ao Si mpl es, porm caso tambm haja uma vari ao na
propri edade, seu val or ser copi ado para o campo Fonte, gerando assi m um cami nho de duas di rees.
Associao Bidirecional
7.1.3 Associao Digital
J na Associao Digital, possvel estabel ecer que, caso a vari vel ou expresso do campo Fonte seja uma propri edade
di gi tal , seus estados Verdadei ro e Fal so sero mapeados para certos val ores no desti no, i ncl ui ndo a opo de Pisca
(al ternnci a de val ores).
Associao Digital
7.1.4 Associao Analgica
A Associao Analgica permi te estabel ecer uma escal a de converses entre a vari vel fonte e a vari vel de desti no. Atravs de
quatro 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.
Associaes 39
Associao Analgica
7.1.5 Associao por Tabela
Podem-se estabel ecer condi es entre a vari vel , os val ores e o desti no. Na tabel a so especi fi cados val ores mni mos e
mxi mos, e val ores para a propri edade referente a essas condi es.
Associao por Tabela
40 Associaes
7.1.6 Associao Reversa
A Associao Reversa uma Associ ao uni di reci onal do objeto para a fonte.
Associao Reversa
7.1.7 Associao Mltipla
Em uma 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 da fonte pri nci pal da Associ ao.
Associao Mltipla
7.2 Edio de Associaes
O E3 possui uma ferramenta para edi o das 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 . O acesso a essa 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.
Associaes 41
Edio de Associaes
7.3 Valores Booleanos
Em VBScri pt, 0 consi derado como Fal so e qual quer val or di ferente de 0 consi derado Verdadei ro. Consi dere, por exempl o,
um Tag que representa uma entrada ou sada di gi tal , portanto seus val ores so 0 ou 1. Ao usar o val or do Tag para
Associ aes com propri edades do ti po Boolean, o E3 consi derar:
TAG VBSCRIPT
0 Fal so
1 Verdadei ro
Ao uti l i zar o comando NOT, consi derar:
TAG NOT TAG VBSCRIPT
0 -1 Verdadei ro
1 -2 Verdadei ro
Portanto, NOT de 1 no Fal so, poi s seu val or no i gual a 0. Caso deseje uti l i zar o comando NOT, pri mei ro converta o val or
do Tag para um Bool eano com o mtodo CBool:
TAG CBOOL(TAG) NOT CBOOL(TAG)
0 Fal so Verdadei ro
1 Verdadei ro Fal so
Mtodo CBool
Outra opo seri a trabal har com a propri edade Bit00 do Tag, que j uma propri edade do ti po Boolean, ao i nvs de trabal har
com a propri edade Value do Tag.
Propriedade Bit00
7.4 Exerccios
42 Associaes
7.4.1 Associao Simples
Esta seo contm exercci os sobre o tpi co Associ ao Si mpl es.
7.4.1.1 Horrio do Sistema
1. Na TelaMenu, acesse as propri edades do Di spl ay que vai exi bi r o horri o do si stema, aba Associaes.
2. Na propri edade Value, busque na col una Fonte, com o auxl i o do AppBrowser, o Tag Demo HoraAtual (Servidor - Dados).
di rei ta, sel eci one a propri edade Value e cl i que em Colar. A i nformao vai do Tag para o Di spl ay, l ogo a Associ ao
Si mpl es (Propri edade Fonte).
Associao Simples
7.4.1.2 Usurio Logado
1. No Di spl ay que vai exi bi r o nome do usuri o, associ e a propri edade Value do Di spl ay com a propri edade User do Vi ewer.
Associao com a propriedade User do Viewer
7.4.1.3 Nvel do Tanque
1. Para si mul ar o movi mento do l qui do do tanque na TelaSinotico, cri e uma Associ ao entre a propri edade
VerticalPercentFill do corte do tanque e a propri edade Value do Tag Nivel1.
Associao com a propriedade VerticalPercentFill
2. Repi ta o procedi mento do i tem 1 para o Tag Nivel2.
7.4.1.4 Cor de Preenchimento
1. Para poder modi fi car a cor do l qui do, cri e a Associ ao da fi gura a segui r.
Associao na propriedade ForegroundColor
2. Busque no AppBrowser o mtodo RGB do VBScri pt.
3. Substi tua as pal avras "Red", "Green" e "Bl ue" pel os Tags Vermelho, Verde e Azul, respecti vamente.
DICA: Trabal he com os comandos Copiar (CTRL + C) e Colar (CTRL + V). Para edi tar uma Associ ao cri ada anteri ormente, use a
tecl a F2.
4. Repi ta os procedi mentos de 1 a 3 para o segundo tanque.
7.4.2 Associao Bidirecional
1. Para cada Setpoi nt na TelaSinotico, cri e uma Associ ao Bi di reci onal com o seu Tag respecti vo, Vermelho, Verde e
Azul.
Associao Bidirecional
7.4.3 Associao Analgica
1. O val or do Tag Nivel vari a de 0 a 100, enquanto a formatao do ti po Porcentagem exi be val ores de 0 a 1. Para apl i car
uma escal a ao val or, i nsi ra uma Associ ao Anal gi ca no Di spl ay que exi be numeri camente a vari vel Nivel.
Associaes 43
Associao Analgica
7.4.4 Associao por Tabela
O Di spl ay que exi be o nvel deve al terar a cor de fundo, conforme a tabel a a segui r.
Cor de fundo do Display
MNIMO MXIMO COR
0 10 Verde
10 30 Azul
30 70 Branco
70 90 Amarel o
90 100 Vermel ho
1. Na propri edade ForegroundColor do Di spl ay, i nsi ra uma Associ ao por Tabel a com o Tag Nivel1.
Associao por Tabela
7.4.5 Copiar Associao
Para copi ar a Associ ao para o Di spl ay Nivel2, si ga estes passos:
1. No Di spl ay j confi gurado com a Associ ao por Tabel a, cl i que com o boto di rei to do mouse e escol ha a opo Copiar
Associaes.
Opo Copiar Associaes
2. No Di spl ay que deseja formatar, cl i que com o boto di rei to do mouse e escol ha a opo Colar Associaes.
3. Se j exi sti r al guma Associ ao nesse objeto, ser aberta uma cai xa de mensagem para escol her se deseja i gnorar ou
sobrescrever.
44 Associaes
Ignorar ou sobrescrever Associao
4. Al tere a refernci a do Tag Nivel1 para o Nivel2.
7.4.6 Animao
1. Sel eci one o objeto Gal o e cl i que em para i nseri r uma Ani mao com Transl ao. Uma sombra do objeto aparecer.
Mova-a at onde desejar.
Animao com Translao
O i nci o do movi mento representa a posi o 0, e o fi nal a posi o 100. Para que o movi mento acontea, preci samos de uma
vari vel que vari e de 0 a 100, l i nearmente. Como usaremos essa vari vel apenas para ani mar um objeto de Tel a, cri aremos
um Tag Demo (si mul ao) no objeto Vi ewer.
2. Cl i que com o boto di rei to do mouse no Vi ewer e i nsi ra um Tag Demo com o nome de Anima.
Inserir Tag Demo
3. Confi gure o Tag Anima com os segui ntes val ores:
Mnimo: 0
Mximo: 100
Period: 5000
Scan: 100
4. Cl i que com o boto di rei to do mouse na Ani mao e abra a sua janel a de propri edades. Cri e uma Associ ao na
propri edade Value com o Tag Anima.
Associao na propriedade Value
5. Al tere as propri edades Enabled e EnabledSlider da Ani mao para Fal so.
Associaes 45
7.5 Anotaes
46 Comunicao
8
Comunicao
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 Drivers de
Comunicao ou Servidores OPC, de acordo com o ti po do equi pamento ou ti po de comuni cao necessri os. Os Dri vers de
Comuni cao e Servi dores OPC funci onam nesse caso como servi dores de vari vei s, ou seja, el es fornecem as i nformaes do
mundo externo para o E3 para que a supervi so do processo se real i ze. As vari vei s envol vi das no processo so conheci das
como Tags e podem ser de vri os ti pos, de acordo com a uti l i zao desejada. No E3 podem ser i nseri dos doi s ti pos de Dri vers,
o Driver de Comunicao (arqui vos .dl l ) e o Driver de Comunicao OPC.
8.1 Driver de Comunicao
O Driver de Comunicao o mdul o do E3 que possi bi l i ta a comuni cao com um determi nado equi pamento, usando os
Dri vers .dl l forneci dos pel a El i pse Software. Um manual forneci do juntamente com cada Dri ver, contendo i nformaes
i mportantes a respei to da confi gurao dos seus parmetros [P] e outras propri edades. Os ti pos de objetos de Dri ver
di sponvei s para comuni cao so os segui ntes:
Objetos disponveis no Driver de Comunicao
OBJETO DESCRIO
Pasta
Defi ne grupos e subdi retri os para a organi zao de
vari vei s. No tem rel ao di reta com o equi pamento de
campo.
Tag de Comunicao Uti l i zado para defi ni r a comuni cao com uma vari vel (um
endereo de memri a) do equi pamento de aqui si o.
Bloco de Comunicao
Uti l i zado para defi ni r a comuni cao com di versas vari vei s
(vri os endereos de memri a em sequnci a) do
equi pamento de aqui si o.
Elemento de Bloco Representam cada um dos endereos de um Bl oco e so
uti l i zados como se fossem Tags de Comuni cao. Os
El ementos de Bl oco podem apontar para cada ndi ce dentro
de um Bl oco (correspondendo a cada vari vel de i nteresse).
8.1.1 Exerccios
8.1.1.1 Driver
1. Cl i que com o boto di rei to do mouse sobre a pasta Drivers e OPC e escol ha a opo Inserir Driver de Comunicao em -
TreinamentoE3.prj.
2. Sel eci one o arqui vo do Dri ver (.dl l ) na cai xa de di l ogo que se abre para a sel eo de arqui vos.
3. Caso a cai xa de di l ogo no seja aberta automati camente, escol ha o arqui vo de Dri ver na propri edade DriverLocation.
4. Veri fi que se a propri edade DriverName foi preenchi da.
5. Nos Dri vers mai s recentes, todas as confi guraes de comuni cao devem ser real i zadas nas janel as de confi guraes
extras do IOKi t, que um componente comparti l hado uti l i zado pel os Dri vers de Comuni cao do E3.
6. Para os Dri vers que uti l i zam o IOKi t, a i nterface de confi gurao aberta cl i cando em Configurar o Driver na barra de
ferramentas do Dri ver.
Configurar Driver
7. A segui nte janel a ser aberta.
Comunicao 47
Janela de configurao do Driver
8. Na aba Setup, escol ha na l i sta de opo da propri edade Physical Layer a i nterface fsi ca que ser uti l i zada. As opes so
Serial, Ethernet, Modem e RAS.
9. Confi gure o tempo que o Dri ver aguardar uma resposta do equi pamento no campo Timeout.
10. Aps a escol ha da opo Physical Layer, todas as outras abas sero desabi l i tadas, sendo necessri o apenas confi gurar a
i nterface escol hi da. A parti r deste ponto, o Dri ver estar confi gurado para acessar o mei o fsi co.
8.1.1.2 Tag Browser
1. Caso a cai xa de di l ogo do Tag Browser no abra automati camente, abra-a cl i cando em .
2. Na janel a Tag Browser, arraste para a esquerda o Bl oco de Comuni cao IO.IOKitEvent da pasta General.
48 Comunicao
Tag Browser
3. Feche a janel a quando termi nar de sel eci onar as vari vei s que desejar.
8.1.1.3 Tags de Comunicao
1. Cl i que com o boto di rei to do mouse no Dri ver e acesse a opo Inserir - Tag de Comunicao, ou cl i que em Adicionar na
barra de ferramentas do Dri ver.
Inserir Tag de Comunicao
2. Escol ha a quanti dade de Tags a serem i nseri dos e seu nome.
Quantidade de Tags
3. Confi gure as propri edades de N1/B1 a N4/B4, conforme o manual do Dri ver.
4. Cl i que novamente com o boto di rei to do mouse no Dri ver e escol ha o i tem Ativar Comunicao para testar as
confi guraes, ou cl i que em Ativar/Desativar comunicao . Caso as confi guraes estejam corretas, a l i nha do Tag
dever fi car na cor azul .
Ativar Comunicao
Comunicao 49
5. Cri e os outros Tags e Bl ocos e confi gure suas propri edades de N1/B1 a N4/B4.
6. Ajuste o tempo de varredura para cada Tag conforme a necessi dade.
8.1.1.4 TelaComunicacao
1. Insi ra no projeto uma nova Tel a, chamada TelaComunicacao, para ser aberta no Di vi sor Area_Central. Marque a
opo Tela inicial do divisor.
2. Na TelaComunicacao, cri e um Setpoi nt para cada Tag cri ado, e associ e-o ao seu respecti vo Tag.
TelaComunicacao
8.2 Driver de Comunicao OPC
O Driver de Comunicao OPC o mdul o responsvel por col etar dados de equi pamentos externos atravs de um Servi dor
OPC, que pode ser desenvol vi do por qual quer empresa com conheci mentos da rede e do protocol o usados por um
determi nado equi pamento. Os Tags OPC podem ser i mportados para o Dri ver OPC no E3 (o Dri ver OPC no E3 atua como um
cl i ente OPC), ou ai nda podem ser cri ados no E3. Nesse caso necessri o conhecer o ItemId de cada Tag.
Objetos disponveis no Servidor OPC
OBJETO DESCRIO
Pasta OPC
Defi nem grupos ou subdi retri os para a organi zao das
vari vei s.
Grupo 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). obri gatri o exi sti r um Grupo OPC para se poder cri ar
Tags OPC.
Tag OPC
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
onde el e est i nseri do.
Bloco 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.
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 esse objeto estar sempre associ ado posi o
defi ni da por sua propri edade Index, correspondendo a uma
vari vel de i nteresse.
8.2.1 Exerccios
O E3 funci onar como servi dor OPC e tambm como cl i ente OPC. Assi m como no exercci o anteri or, esse exercci o serve para
mostrar como funci ona a confi gurao do Dri ver OPC, j que o procedi mento semel hante para qual quer servi dor OPC que
50 Comunicao
esteja sendo uti l i zado. O rotei ro descri to nos passos a segui r.
1. Cl i que com o boto di rei to do mouse sobre a pasta Drivers e OPC e escol ha a opo Inserir Driver de Comunicao OPC
em - TreinamentoE3.prj.
2. Cl i que com o boto di rei to do mouse sobre o Dri ver OPC i nseri do, sel eci one a opo Propriedades e v at a aba OPC
Driver. Cl i que em Selecionar.
Selecionar servidor
3. Ser aberta uma janel a com as opes de OPC Server na sua mqui na l ocal ou na rede. Sel eci one o El i pse OPC Server da
mqui na do i nstrutor na opo Servidores na rede e cl i que em OK.
Servidores OPC na rede
4. Ao vol tar janel a de propri edades do Dri ver OPC, cl i que em Ativar Comunicao.
Ativar Comunicao
5. A parti r deste ponto, possvel veri fi car a comuni cao com o servi dor cl i cando em Informaes.
Informaes sobre o servidor
6. O prxi mo passo para a confi gurao a i mportao de Tags. Sel eci one a opo Importar Tags.
Importar tags
7. O Assi stente de Importao de Tags do E3 ser aberto. Cl i que em Buscar.
Comunicao 51
Buscar tags
8. A fi gura anteri or mostra a aparnci a da janel a de i mportao. Do l ado di rei to a l i sta de Tags do servi dor e do l ado
esquerdo, a rea de i mportao para o E3. Para i mportar, sel eci one o i tem e arraste-o at o Grupo OPC de desti no.
Grupos OPC
9. Depoi s de i mportar al guns Tags ou propri edades, veri fi que o funci onamento dos Tags i mportados.
Tags importados
10. Assi m como no caso da confi gurao de Dri vers El i pse, o rotei ro para trabal har com o servi dor OPC da El i pse o mesmo
52 Comunicao
para qual quer servi dor que seja uti l i zado.
8.3 Exerccios Complementares
8.3.1 KB
KB-14918: Contagem de Tags no Dri ver de Comuni cao.
Comunicao 53
8.4 Anotaes
54 Scripts
9
Scripts
CAPTULO
Os Scripts so trechos de cdi go (programao) com os quai s se pode cri ar procedi mentos associ ados a eventos especfi cos,
permi ti ndo grande fl exi bi l i dade no desenvol vi mento e no uso de apl i caes. Todos os scri pts esto associ ados a eventos, e
cada objeto do E3 possui uma l i sta de eventos previ amente defi ni dos, sendo possvel tambm defi ni r novos eventos de
usuri o.
De acordo com concei tos da programao ori entada a objetos, as Propriedades defi nem atri butos de um objeto, como a
aparnci a de um control e de Tel a ou o val or i ni ci al de um objeto quando se i ni ci a o apl i cati vo.
NOTA: Estamos trabal hando at agora apenas com propri edades no E3. J conhecemos al gumas propri edades dos objetos do
E3 e vi mos que temos duas manei ras de al ter-l as, na Janel a de Propri edades ou por Associ aes.
Os Mtodos so funes previ amente defi ni das, que executam determi nadas aes sobre as propri edades do objeto que
chama estas aes. Exempl os di sso so funes para real i zar a escri ta em Tags (Write ou WriteEx), entre outras. Em
l i nguagens de programao ori entadas a objeto, para agi r sobre uma propri edade necessri a a cri ao de mtodos. No E3,
para cada mtodo desejado, necessri o defi ni r a qual evento el e estar associ ado, poi s os scri pts do E3 so ori entados a
eventos.
Os Eventos so ocorrnci as rel aci onadas a um objeto, que podem ser tratadas de modo a se real i zar uma ao (um mtodo).
9.1 Definindo Scripts
A l i nguagem que o E3 Studi o usa em seus scri pts o VBScri pt, um subconjunto da l i nguagem Vi sual Basi c desenvol vi da pel a
Mi crosoft. O VBScri pt possui um i nterpretador rpi do, l eve e portvel , desenvol vi do para o uso em navegadores para a
Internet e outras apl i caes que usam ActiveX Controls, Automation Servers e Java Applets. Os scri pts so sempre associ ados a
eventos de um determi nado objeto. Entretanto, para faci l i tar e aumentar a vel oci dade de desenvol vi mento, o E3 j i ncorpora
al gumas aes mai s comuns que poderi am ser real i zadas com scri pts atravs de assi stentes (wizards) chamados Picks. Pode-
se defi ni r que um determi nado evento executar um scri pt, um Pi ck ou uma combi nao del es, em uma sequnci a defi ni da
durante a cri ao do scri pt (no E3 Studi o).
9.1.1 Picks
Os Picks i mpl ementam uma forma ami gvel de real i zar procedi mentos comuns em scri pts, poupando tempo de escri ta de
cdi go. Entre el es esto aes como troca de Tel a ou atri bui o de val ores, que so bastante comuns na cri ao de um
projeto.
Scripts 55
9.1.1.1 Executar Scripts
Permi te a edi o de um scri pt personal i zado que ser executado na ocorrnci a do evento determi nado.
Pick Executar Script
56 Scripts
9.1.1.2 Abrir Tela
Abre uma Tel a ou um Quadro determi nado.
Pick Abrir Tela
Scripts 57
9.1.1.3 Abrir Tela Modal
Abre uma Tel a em esti l o modal .
Pick Abrir Tela Modal
58 Scripts
9.1.1.4 Executar Aplicao
Executa um programa especfi co.
Pick Executar Aplicao
Scripts 59
9.1.1.5 Carregar Valor
Carrega um val or em um Tag.
Pick Carregar Valor
9.1.1.6 Inverter Valor
Permi te mudar o val or de um Tag. Se o val or do Tag for i gual a Valor1, ento o Tag recebe Valor2. Se o val or do Tag for i gual
a Valor2, ento o Tag recebe Valor1. Se o val or do Tag no for i gual nem a Valor1 nem a Valor2, o Tag recebe Valor1.
60 Scripts
Pick Inverter Valor
Scripts 61
9.1.1.7 Imprimir Relatrio
Permi te i mpri mi r um Rel atri o na Tel a ou na i mpressora.
Pick Imprimir Relatrio
9.2 Eventos
Os Eventos so ocorrnci as rel aci onadas a um objeto, que di sparam aes programadas. Basi camente so doi s ti pos de
eventos, Fsicos (ou externos) e Internos.
Eventos fsicos so, por exempl o, aes no tecl ado ou no mouse. Neste caso, a i nformao rel evante seri a a tecl a pressi onada
ou a posi o do cursor e o status dos botes. Eventos internos so, por exempl o, a mudana de uma temperatura de uma
cmara de 10 para 11 graus Cel si us.
No E3, h uma l i sta di sponvel de eventos cl assi fi cada por objetos, i ni ci ando pel os eventos padro, presentes em todos os
objetos. Esses eventos so acessados atravs da aba Scripts, que pode ser consul tada atravs das propri edades do objeto
para o qual se deseja fazer o scri pt.
62 Scripts
Lista de eventos
9.2.1 Eventos Definidos pelo Usurio
Apesar de o E3 vi r com uma extensa gama de eventos, mui tas vezes o usuri o necessi ta cri ar um evento especfi co para sua
apl i cao. Um exempl o para a uti l i zao de eventos defi ni dos pel o usuri o a real i zao de um cl cul o (ou tarefa mai s
compl exa) em um objeto, quando o evento gerador vem de outro Tag ou propri edade.
possvel a cri ao de eventos personal i zados defi ni dos pel o usuri o atravs da opo Criar novo evento na l i sta de eventos
ou ao cl i car em Criar evento do usurio .
Criar evento do usurio
9.3 Mtodos
Os Mtodos so procedi mentos que podem ser executados por objetos. Por exempl o, o objeto Tel a tem um mtodo para a
adi o de objetos (AddItem) e outro para fech-l a (Close). Por estarem encapsul ados, i sto , guardados dentro dos objetos, na
Scripts 63
chamada de um mtodo sempre deve constar a qual objeto est se referi ndo.
Mui tos mtodos pr-defi ni dos possuem parmetros, que podem (ou devem) ser passados na chamada do mtodo. Para i sso, o
VBScri pt possui uma regra que deve ser segui da. Se o mtodo for uti l i zado em uma atri bui o, seus parmetros devem estar
entre parnteses. Os parnteses usados nas ci taes de mtodos neste manual servem apenas como i ndi cati vo para
di ferenci -l os das propri edades. Nos scri pts, deve-se segui r esta regra.
AppBrowser
9.4 Propriedades
Todo objeto possui Propriedades, que guardam i nformaes a respei to de suas caractersti cas. Por exempl o, um objeto do
ti po Retngul o possui a propri edade Name, que contm seu nome e as propri edades Width e Height, que guardam a sua
l argura e a sua al tura, respecti vamente, entre outras. Para acessar as propri edades, uti l i ze as mesmas especi fi caes
anteri ores, porm sel eci one a pasta Propriedades.
9.5 Exerccios
9.5.1 Pick Abrir Tela
Vamos i mpl ementar a navegao entre as Tel as da apl i cao. A TelaInicial deve chamar o Quadro1 e cada boto na
TelaMenu deve abri r sua respecti va Tel a no Quadro Area_Central ou em tel a chei a.
1. Na TelaInicial, sel eci one o texto "Entrar" e sel eci one a aba Scripts.
2. No evento Click, cri e um novo scri pt do ti po Abrir tela.
Pick Abrir Tela
3. No campo Abrir a Tela, sel eci one o Quadro1.
4. Dei xe a opo No Quadro em branco.
5. Na TelaMenu, cri e um boto para cada Tel a, e cri e um scri pt para abri r sua respecti va Tel a. A Tel a TelaInicial deve
abri r no Quadro _top, e as demai s no Quadro Area_Central.
9.5.2 Pick Script
Na TelaInicial podemos fechar a apl i cao ao cl i car no texto "Sai r".
1. Na TelaInicial, cri e um novo Pi ck do ti po Script no texto "Sair".
64 Scripts
Pick Script
2. Com o auxl i o do AppBrowser , procure o mtodo Exit do Vi ewer e cl i que em Colar.
Application.Exit
3. Execute a apl i cao e teste as novas funci onal i dades.
9.6 Exerccios Complementares
9.6.1 KB
KB-25172: Tecl as de atal ho no E3.
Scripts 65
9.7 Anotaes
66 Segurana
10
Segurana
CAPTULO
O E3 possui um control e de acesso a Tel as, Al armes e Domni os em uma l i sta de usuri os, onde para cada nome atri budo
uma senha e um l ogi n. Conforme a opo confi gurada, o si stema permi ti r acesso aos usuri os cadastrados ou acesso
i l i mi tado s Tel as do projeto.
10.1 Usurios
Atravs da opo Usurios possvel confi gurar as i nformaes referentes aos usuri os que tero ou no acesso ao si stema.
Para uti l i zar este recurso, preci so acessar o menu Arquivo - Usurios e cl i car na aba Usurios.
Aba Usurios
IMPORTANTE: Aps confi gurar a segurana, somente os usuri os l i stados tero acesso ao si stema.
10.2 Grupos
A opo Grupos permi te que sejam cri ados grupos com caractersti cas que sero comuns para todos os seus membros
(usuri os). Um grupo tambm pode pertencer a outros grupos. S no permi ti do pertencer a outro grupo que pertena a el e,
ou seja, uma refernci a ci rcul ar. Para uti l i zar este recurso, necessri o acessar o menu Arquivo - Usurios e sel eci onar a aba
Grupos.
Segurana 67
Aba Grupos
10.3 Permisses
A aba Permisses confi gura as permi sses dos usuri os e grupos para Tel as, Al armes, Domni o e Vi ewer. Uma veri fi cao de
permi sso consi ste em uma i nformao que o membro do grupo tem sobre um comando que atua sobre um objeto especfi co.
Por exempl o, o Usuario1 tem permi sso para o comando Abrir sobre o objeto Tela1. Cada membro do grupo pode negar ou
afi rmar a permi sso de um comando, i ndependentemente do grupo ao qual pertence. Dessa forma, el e no vai l evar em
consi derao a i nformao do grupo. Tambm pode-se optar por sempre uti l i zar a i nformao defi ni da pel o grupo. Se as
i nformaes dos grupos forem confl i tantes, ser usada a segui nte ordem de prefernci a: Negar Afi rmar Indi ferente.
68 Segurana
Aba Permisses
10.4 Proteo
O E3 possui uma ferramenta de proteo de projetos ou de bi bl i otecas. Atravs desse i tem, possvel proteger o contedo do
arqui vo contra a edi o, a vi sual i zao ou a execuo no autori zada. Para uti l i zar esse recurso, 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 Proteger.
Segurana 69
Proteo de arquivo
Esta opo possui doi s ti pos de proteo, de Edio e de Execuo.
Proteo de Edio: Protege o arqui vo contra al teraes e vi sual i zaes no autori zadas. Esse 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
conheci mento especfi co do desenvol vedor. O E3 fornece um control e sobre a edi o desses arqui vos, sejam el es projetos
ou bi bl i otecas.
Proteo de Execuo: Esta opo uti l i zada para proteger um 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. Isso protege o
desenvol vedor de cpi as no autori zadas do projeto, por exempl o.
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 esse contedo no pode ser acessado. Para acessar o contedo do arqui vo, cl i que no cone da
di rei ta e mude para Abrir com senha. Aps i nformar a senha e o si stema l i berar o acesso, o cone fi ca col ori do , i ndi cando
a acessi bi l i dade dos arqui vos.
IMPORTANTE: As protees i mpl ementadas no podem ser desfei tas caso as senhas sejam perdi das. Portanto, ao proteger
determi nado arqui vo, mantenha as senhas armazenadas de modo seguro. I sso garante que se consegui r usar o arqui vo
sempre que necessri o.
10.5 Exerccios
A segui r, ser vi sto como confi gurar usuri os em um Domni o no E3 e como uti l i zar esse recurso para i ni bi r ou permi ti r
acesso a Tel as, control es, al armes, etc.
70 Segurana
10.5.1 Usurios
1. No menu Arquivo, sel eci one a opo Usurios.
Menu Arquivo - Usurios
2. Sel eci one a aba Grupos e cri e doi s grupos de usuri os, chamados Administradores e Operadores.
3. Atravs da aba Usurio, cri e trs usuri os. Cui dado que mai scul as e mi nscul as fazem di ferena.
Dados do usurio
4. Confi gure um usuri o para pertencer ao grupo Administradores e doi s para pertencerem ao grupo Operadores.
10.5.2 Permisses
1. Na aba Permisses, sel eci one a opo Grupos. Bl oquei e uma Tel a para o grupo Operador.
2. Nas permi sses de usuri os, d permi sso para um dos usuri os do grupo Operador acessar a Tel a bl oqueada para o
grupo.
10.5.3 Login
1. Na TelaMenu, boto Login, cri e um novo Pi ck do ti po Script no evento Click.
2. Busque no AppBrowser o mtodo Login do Vi ewer e cl i que em Colar.
10.6 Exerccios Complementares
10.6.1 Administrao de Usurios
Desejamos cri ar, apagar e edi tar usuri os em tempo de execuo. Somente usuri os confi gurados como admi ni stradores
("Este usuri o um admi ni strador") tm acesso a esse recurso.
1. Insi ra um boto na TelaMenu com o texto "Usuri os".
Segurana 71
2. No boto cri e o segui nte scri pt no evento Click.
'Administrao de usurios
Application.UserAdministration()
3. Com o auxl i o do AppBrowser, busque o mtodo UserAdministration do Vi ewer.
10.6.2 Permisso por Grupo de Usurios para Objetos de Tela
Al gumas vezes desejamos que o operador acesse a Tel a mas no vi sual i ze ou habi l i te al guns objetos. Para programarmos
essa funci onal i dade, pri mei ro preci samos saber se o usuri o pertence ou no ao grupo com restri o. Essa i nformao vari a
conforme o usuri o l ogado, l embrando que podemos ter mai s de uma estao de vi sual i zao e consequentemente mai s de
um usuri o l ogado.
1. Cl i que com o boto di rei to do mouse no Vi ewer e i nsi ra um Tag Interno com o nome de TagAdmin.
TagAdmin
2. No evento OnLogin do Vi ewer, i nsi ra o segui nte scri pt:
'Verificar se o usurio pertence ao grupo Administradores
Item("TagAdmin").Value = IsUserMemberOfGroup("Administradores")
3. Na TelaMenu, cri e uma Associ ao na propri edade Visible do texto Sair com o Tag TagAdmin. Somente usuri os do grupo
Administradores podero vi sual i zar esse objeto.
10.6.3 Registro de Eventos
1. Cl i que com o boto di rei to do mouse no cone do E3 na rea de Noti fi cao do Wi ndows e acesse a opo Domnio -
Opes.
Domnio - Opes
2. Na aba Segurana, confi gure as opes conforme a fi gura a segui r.
72 Segurana
Aba Segurana
NOTA: Confi guraes de segurana no sero apl i cadas aos usuri os j exi stentes, apenas na al terao ou na cri ao de um
usuri o.
3. Acesse a aba Registro de Eventos e confi gure para regi strar os eventos na tabel a Eventos em um banco de dados
sel eci onado automati camente.
Aba Registro de Eventos
NOTA: necessri o ter um banco de dados confi gurado na apl i cao.
Segurana 73
10.6.4 KB
KB-32881: Abri ndo a janel a de admi ni strao de usuri o em tempo de execuo.
10.7 Anotaes
74 Bibliotecas ElipseX
11
Bibliotecas ElipseX
CAPTULO
O E3 possui ferramentas que permi tem transformar qual quer objeto ou conjunto de objetos de sua apl i cao em uma
bi bl i oteca do usuri o. A i dei a das bi bl i otecas de usuri os (chamadas de ElipseX) vem das l i nguagens de programao
ori entadas a objetos, onde di versos componentes podem ser comparti l hados entre projetos sem que seja necessri o
desenvol ver novamente cada um dos objetos. O uso de Bi bl i otecas no E3 al tamente recomendvel , devi do ao ganho de
produti vi dade que el as trazem. Al gumas das vantagens dos El i pseX:
Reuti l i zao de cdi go
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
O uso de Bi bl i otecas recomendado na mai ori a das apl i caes.
Bibliotecas de objetos
11.1 Criao de Bibliotecas do Usurio
Os objetos El i pseX podem conter, al m de um desenho, vari vei s i nternas que podem ser exportadas para a apl i cao, al m
de l gi cas de programao (scri pts) que vo estar presentes em todas as cpi as do objeto que est 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.
Para cri ar uma nova bi bl i oteca no E3, si ga estes procedi mentos:
1. Acesse o menu Arquivo, sel eci one o i tem Novo Projeto e cl i que em Avanar.
2. Na opo Tipo de Aplicao, sel eci one a opo Biblioteca de componentes do E3.
Bibliotecas ElipseX 75
Assistente de Aplicaes
3. Determi ne o nome da bi bl i oteca e a pasta onde el a ser sal va, 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 podem ser i nseri dos doi s ti pos de objetos, os objetos grfi cos XControl s e os objetos de
dados XObjects.
Podem ser i nseri dos nos XControl s todos os i tens di sponvei s para as Tel as. Entre esses i tens esto as pri mi ti vas de desenho,
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 as bi bl i otecas de dados podem conter quai squer ti pos de objetos no grfi cos, que so executados no E3 Server. Pode-se
i nseri r em um XObject os segui ntes objetos: Dri ver de Comuni cao, Servi dor de Dados, Banco de Dados, Frmul as,
Confi gurao de Al armes, Servi dor de Al armes, Objetos COM, outros XObjects, dentre 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 ter tambm vri as bi bl i otecas di ferentes (vri os arqui vos .l i b) dentro do mesmo Domni o.
11.1.1 XControl
O XControl defi ne uma i nterface grfi ca com o usuri o, que pode ser composta de quai squer objetos do E3, com o propsi to
de ser mul ti pl i cada faci l mente por seu projeto. Pode-se cri ar um XControl cl i cando com o boto di rei to do mouse sobre o
arqui vo .l i b cri ado em seu Domni o (Organizer - Explorer) ou em Bi bl i otecas de Objetos, XControl , escol hendo a opo Inserir -
XControl.
76 Bibliotecas ElipseX
Aba Design de um XControl
Aba Propriedades de um XControl
Ao i nseri r um XControl , observe que na parte i nferi or da tel a exi stem trs abas, Design, Propriedades e Scripts. Na aba
Propriedades, pode-se i nseri r propri edades a serem exportadas pel o objeto. El as podero ser associ adas a um Tag ou outra
propri edade qual quer quando o objeto esti ver sendo usado em um projeto. Na aba Design, que equi val e a uma Tel a, pode-se
i nseri r os objetos grfi cos descri tos anteri ormente.
As propri edades a serem exportadas (XProperti es) podem ser i nseri das atravs da tecl a INS do tecl ado ou cl i cando em , e
excl udas cl i cando em . As opes di sponvei s so:
Opes disponveis em XControls
OPO DESCRIO
Nome Determi na o nome da propri edade do XControl .
Tipo Determi na o ti po de dado suportado pel a propri edade.
Public Habi l i ta ou desabi l i ta a vi si bi l i dade da propri edade fora da
bi bl i oteca, i sto, determi na se a propri edade ser ou no
pbl i ca.
Persistable Determi na se a vari vel sal va no projeto ou no.
Retentive
Determi na se a propri edade retenti va ou no. No caso de
XControl s, as propri edades no podem ser retenti vas.
Valor inicial Determi na o val or i ni ci al da propri edade.
Texto de ajuda Texto de decl arao e documentao da propri edade.
Bibliotecas ElipseX 77
Note que outros objetos de Dados (XObjects) podem ser decl arados como Ti po. Isso permi te que em uma ni ca propri edade
seja control ado o funci onamento de todo um objeto, tornando mai s fci l a manuteno de uma bi bl i oteca.
A edi o do objeto grfi co possui os mesmos recursos grfi cos e opes da edi o de Tel as. 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 e
escol hendo a opo Inserir.
A parti r desse 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 essa cpi a especfi ca ter no contexto que est sendo
uti l i zada.
11.1.2 XObject
Al m dos objetos grfi cos, pode-se cri ar uma bi bl i oteca de dados, chamada XObject. Com el a, pode-se defi ni r uma estrutura
de dados a ser 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 al guma i nterface grfi ca (Vi ewer) aberta ou em execuo naquel e
momento. Para cri ar um XObject, cl i que com o boto di rei to do mouse sobre o arqui vo .l i b no Organi zer e escol ha a opo
Inserir - XObject.
As opes di sponvei s para as propri edades do XObject so as mesmas dos XControl , ci tadas anteri ormente. Al m das
XProperti es, podem ser i nseri dos em um XObject quai squer mdul os do E3 que sejam executados no servi dor. Para saber a
l i sta compl eta, basta pressi onar o boto que defi ne o ti po do objeto e veri fi car a l i sta de opes di sponvei s. Isso 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 no apl i cati vo.
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
e escol hendo a opo Inserir. Mesmo que o(s) arqui vo(s) de bi bl i oteca possua(m) vri os XControl s e XObjects, ao tentar
i nseri r uma bi bl i oteca 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.
11.2 Quando Criar um ElipseX
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 de 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 El i pse E3 permi te que
sejam uti l i zadas posteri ormente apenas as vari vei s de i nteresse, desprezando-se as demai s
NOTA: No possvel copi ar uma Bi bl i oteca e uti l i zar os doi s arqui vos (ori gi nal e cpi a) no mesmo Domni o. Por exempl o, no
se pode copi ar um arqui vo .l i b para separ-l o em doi s novos arqui vos.
11.3 Exerccios
Vamos desenvol ver um Di spl ay para exi bi r o val or da temperatura. O Di spl ay ser formatado com uma casa deci mal e sufi xo
"C". A cor de fundo do Di spl ay vari a conforme o val or da temperatura.
11.3.1 Biblioteca
1. Cl i que em Novo Projeto e, no Assi stente de Apl i caes, sel eci one a opo Biblioteca de componentes do E3. Nomei e-a
como BibliotecaTreinamento e especi fi que a pasta C:\Trei namentoE3. Cl i que em Avanar, adi ci one-a ao Domni o
corrente e concl ua o processo.
11.3.2 XControl
1. Insi ra um XControl e chame-o de DisplayTemp.
DisplayTemp
2. Na aba Design, desenhe um Di spl ay.
3. Formate o Di spl ay com a expresso "0,0 C".
78 Bibliotecas ElipseX
Formato do
Display
4. Para poder receber externamente qual quer val or, preci samos cri ar propri edades. Al tere da aba Design para a aba
Propriedades, na parte i nferi or da Tel a.
Aba Propriedades
5. Cri e uma propri edade chamada Temperatura, do ti po Double.
Propriedade Temperatura
6. Retorne aba Design. No Di spl ay, cri e uma Associ ao Si mpl es entre a propri edade Temperatura e a propri edade Value.
Associao Simples
7. Para al terar a cor conforme o val or da temperatura, cri e uma Associ ao por Tabel a na propri edade ForegroundColor,
i nformando os l i mi tes e as cores desejadas. Na propri edade Fonte, busque a propri edade Temperatura cri ada
anteri ormente.
Associao por Tabela
8. Para que o novo objeto possa ser uti l i zado, preci so regi str-l o. Sal ve as modi fi caes, cl i que com o boto di rei to do
mouse em Bibliotecas e escol ha a opo Registrar bibliotecas carregadas.
Registrar bibliotecas carregadas
9. Insi ra na Tel a doi s XControl s Di spl ayTemp, um ao l ado de cada tanque.
Bibliotecas ElipseX 79
DisplayTemp
10. Para cada Di spl ayTemp na Tel a, cri e uma Associ ao Si mpl es entre a propri edade Temperatura e um Tag Temp.
11.3.3 TagBomba
1. Na bi bl i oteca BibliotecaTreinamento, i nsi ra um novo XObject e nomei e-o TagBomba.
2. Cri e trs propri edades do ti po Boolean: OnOff, Automatico e Defeito.
Propriedades de TagBomba
3. Sal ve a bi bl i oteca e regi stre-a.
11.3.4 Servidor de Dados
1. Cri e, dentro de Dados, uma Pasta de Dados com o nome Bombas.
2. Na pasta Bombas, cri e sei s XObjects TagBomba: B01 a B06.
Objetos TagBomba
11.3.5 Bomba
Bomba
1. Insi ra um novo XControl e nomei e-o Bomba.
2. Insi ra o objeto 3DISABl ower, da categori a Blowers da Bi bl i oteca de Smbol os. Modi fi que as segui ntes propri edades:
OverrideFillMode para 3 - ByBrightness
OverrideFillColor para verde (0, 255, 0)
3. Insi ra a fi gura Defei to e Automti co , que esto no projeto como Recursos.
4. Insi ra um Di spl ay sob a vl vul a, para exi bi r o nome "Bomba".
5. Cri e uma propri edade chamada Fonte, do ti po TagBomba (XObject cri ado anteri ormente).
80 Bibliotecas ElipseX
Tipo TagBomba
6. Para faci l i tar posteri ormente, escreva no campo Texto de ajuda a mensagem "Objeto TagBomba associ ado. Propri edades:
OnOff, Automati co, Defei to".
7. Para que a fi gura s aparea quando a vl vul a esti ver com defei to, cri e uma Associ ao Si mpl es entre a
propri edade Visible do objeto e a propri edade Defeito:
Com o auxl i o do AppBrowser, l ocal i ze a propri edade Fonte
No campo i nferi or, i nsi ra aps a propri edade Fonte a propri edade do objeto TagBomba desejada, nesse caso, Defeito
AppBrowser
8. Repi ta o procedi mento anteri or entre o objeto Automati co e a propri edade Automatico.
9. No Di spl ay abai xo da vl vul a, deve aparecer o nome do XObject TagBomba associ ado. Cri e uma Associ ao entre a
propri edade Value do Di spl ay e Bomba.Fonte.Name.
10. Quando a propri edade OnOff esti ver em True, a cor da bomba dever ser verde, e quando a propri edade esti ver em Fal se a
cor dever ser vermel ha.
Na aba Associaes, cri e uma Associ ao Di gi tal entre a propri edade OverrideFillColor e a propri edade OnOff
Bibliotecas ElipseX 81
Associao Digital
11. Sal ve a bi bl i oteca e regi stre-a.
11.3.6 TelaSinotico
1. Na TelaSinotico, i nsi ra um objeto Bomba sobre cada bomba do desenho de fundo.
2. Associ e a propri edade Fonte dos objetos Bomba da TelaSinotico aos XObjects Bomba cri ados no exerci ci o anteri or.
Propriedade Fonte
DICA: Pode-se arrastar o objeto que se deseja associ ar at a propri edade desejada.
Arrastando um objeto para uma propriedade
11.3.7 ComandoBomba
Comando
Cri aremos um XControl , que ser uti l i zado para al terar as propri edades OnOff, Automatico e Defeito do XObject TagBomba.
Haver uma ni ca Tel a com este objeto, que far a confi gurao de todas as bombas do apl i cati vo.
1. Insi ra um novo XControl na bi bl i oteca BibliotecaTreinamento e nomei e-o ComandoBomba.
2. Cri e uma propri edade chamada Fonte, do ti po TagBomba.
3. Cri e uma Cai xa de Sel eo e, na sua propri edade Caption, di gi te o texto "Defei to".
4. Cri e uma Associ ao Bi di reci onal entre as propri edades Value da Cai xa de Sel eo e Defeito da Fonte.
Associao Bidirecional
5. Copi e o objeto Cai xa de Sel eo duas vezes. Al tere a propri edade Caption dos objetos para "Automti co" e "OnOff",
respecti vamente, e associ e-os s propri edades correspondentes.
6. Insi ra um texto sobre os objetos, onde aparea o nome do XObject TagBomba associ ado.
82 Bibliotecas ElipseX
Criando uma Associao para a propriedade Value
7. Sal ve a bi bl i oteca e regi stre-a.
11.3.8 TelaComando
Insi ra no projeto uma nova Tel a, chamada TelaComando, com o tamanho de 200 x 200 pi xel s.
1. Na TelaComando, i nsi ra um objeto ComandoBomba.
2. No evento OnPreShow da TelaComando, i nsi ra o segui nte scri pt:
Item("ComandoBomba1").Fonte = Arg
3. Busque, com o auxl i o do AppBrowser, o XControl ComandoBomba1 que est dentro da TelaComando, e di rei ta sel eci one
a propri edade Fonte.
4. Di gi te " = Arg".
11.3.9 Tela Indexada
Ao cl i car sobre uma bomba, dever ser aberta a sua tel a de comando. Como temos uma ni ca tel a de comando e vri as
bombas, ao abri r a tel a devemos i nformar o nome da bomba que gostaramos de envi ar os comandos.
1. No XControl Bomba, cri e um scri pt no evento Click da fi gura que si mbol i za a bomba:
'Nome completo da bomba
Arg = Bomba.Fonte.PathName
'Abrir TelaComando
Application.DoModal "TelaComando", "Comando", 0, 0, , , Arg, 1+2+64+2048
2. Di gi te "Arg = " para cri ar uma vari vel auxi l i ar de scri pt, que guardar o nome da bomba na qual cl i camos.
3. Busque, com o auxl i o do AppBrowser, o XControl Bomba e di rei ta a propri edade Fonte. Cl i que em Colar.
4. Termi ne a l i nha di gi tando ".PathName". Esta propri edade retorna o nome compl eto do XObject TagBomba que esti ver
associ ado.
Arg = Bomba.Fonte.PathName
5. Busque, com o auxl i o do AppBrowser, o mtodo DoModal do Vi ewer e cl i que em Colar.
Application.DoModal(Screen, Title, Left, Top, Width, Height, Arg, Flags)
6. Al tere o parmetro Screen para o nome da Tel a que se deseja abri r, TelaComando.
7. Al tere o parametro Title para "Comando". Este ser o ttul o, desde que a propri edade Caption da Tel a esteja em branco.
8. Al tere os parmetros Left e Top para 0. Foraremos a Tel a a abri r no centro em outro parmetro.
9. Al tere os parmetros Width e Height para um espao, assi m ser usado o tamanho ori gi nal da Tel a.
10. Arg a i nformao que ser passada para a Tel a que se abri r. Esse parmetro j foi defi ni do como o nome compl eto da
bomba.
11. Al tere o parmetro Flags para 1+2+64+2048, que si gni fi ca barra de ttul o (1), boto de fechar (2), mvel (64) e central i zada
(2048).
11.4 Exerccios Complementares
11.4.1 Associao Mltipla
Mui tas vezes desejamos al terar a fonte de i nformao de uma Associ ao, dependendo de uma ou mai s vari vei s. Como
exempl o, podemos rel aci onar a cor fi nal do tanque, l evando em conta se a bomba est l i gada ou no.
Exi stem oi to combi naes possvei s para trs bombas. Para transformarmos os val ores Bool eanos em deci mal , use a segui nte
expresso:
4 * Bomba1 + 2 * Bomba2 + Bomba3
Como no VBScri pt Verdadei ro equi val e numeri camente a -1, nossa expresso deve ser:
-4 * Bomba1 - 2 * Bomba2 - Bomba3
A cor fi nal deve ser:
Bibliotecas ElipseX 83
Cores para as bombas
VERMELHO VERDE AZUL STATUS DESCRIO
0 0 0 0 RGB(0, 0, 0)
0 0 1 1 RGB(0, 0, Azul )
0 1 0 2 RGB(0, Verde, 0)
0 1 1 3 RGB(0, Verde, Azul )
1 0 0 4 RGB(Vermel ho, 0, 0)
1 0 1 5 RGB(Vermel ho, 0, Azul )
1 1 0 6 RGB(Vermel ho, Verde, 0)
1 1 1 7 RGB(Vermel ho, Verde,
Azul )
Para apl i carmos essa l gi ca, podemos uti l i zar uma Associ ao Ml ti pl a.
1. No retngul o do tanque, al tere a Associ ao da propri edade ForegroundColor, conforme a tabel a anteri or.
Propriedade ForegroundColor
11.4.2 KB
KB-28547: Uti l i zando bi bl i oteca desenvol vi da em outro projeto.
84 Bibliotecas ElipseX
11.5 Anotaes
Banco de Dados 85
12
Banco de Dados
CAPTULO
O Banco de Dados do E3 uti l i zado para armazenar as i nformaes do projeto referentes aos Hi stri cos, Frmul as e Al armes.
Possui suporte a MDB (Mi crosoft Access), Oracl e e Mi crosoft SQL Server. Para uti l i zar esse recurso, si ga estes procedi mentos:
1. Cl i que com o boto di rei to do mouse sobre o nome do projeto e depoi s em Inserir - Banco de Dados.
2. No caso do banco de dados Access, i nsi ra o nome do arqui vo desejado (exi stente ou no) no campo Arquivo MDB.
3. Dei xe em branco os campos Usurio e Senha. Estes campos so uti l i zados somente se o banco de dados especi fi cado para
a conexo j possui r usuri o e senha.
4. Dei xe o campo Senha do DB em branco. Conforme especi fi cado aci ma, este campo s uti l i zado caso o banco de dados
especi fi cado possua senha do DB.
5. Cl i que em OK para fi nal i zar as confi guraes.
12.1 Exerccios
Este banco de dados ser uti l i zado para armazenar todos os dados de Al armes e Hi stri cos dos projetos.
12.1.1 SQL Server Management Studio
1. Acesse o SQL Server Management Studi o atravs do menu Iniciar - Programas - Microsoft SQL Server 2008.
SQL Server Management Studio
2. Para conectar-se ao banco de dados, necessri o i nformar o nome do servi dor, usuri o e senha.
Conectar ao Banco de Dados
3. No campo Server name, cl i que na Cai xa de Sel eo e sel eci one o servi dor na l i sta.
Lista de servidores disponveis
4. No campo Authentication, sel eci one a opo SQL Server Authentication. No campo Login di gi te "sa" e em Password
86 Banco de Dados
i nforme a senha cri ada para o usuri o sa durante a i nstal ao.
5. Cl i que em Connect. Se todas as i nformaes esti verem corretas, o Studi o se conectar ao servi dor de banco de dados.
Conectado ao Servidor de Banco de Dados
12.1.1.1 Criao de Banco de Dados
1. Cl i que com o boto di rei to do mouse no i tem Databases e escol ha a opo New Database.
Adicionar Novo Banco de Dados
2. No campo Database name di gi te "Trei namentoE3". Cl i que em OK.
Campo Database Name
3. Veri fi que se o banco de dados cri ado aparece na l i sta de Databases.
Banco de Dados TreinamentoE3
Banco de Dados 87
12.1.2 Banco de Dados
1. Insi ra um novo Banco de Dados no projeto TreinamentoE3 com o nome de BancoDados.
Inserir Banco de Dados
2. Escol ha o ti po 2 - stSqlServer.
3. Confi gure os parmetros de conexo.
Configurao do Banco de Dados
4. Teste a conexo com o banco de dados.
12.2 Exerccios Complementares
12.2.1 KB
KB-29527: Bancos de dados suportados pel o E3.
88 Banco de Dados
12.3 Anotaes
Alarmes 89
13
Alarmes
CAPTULO
O mdul o de Al armes do E3 consi ste basi camente em duas uni dades cujo funci onamento i nterl i gado l ogi camente:
Servidor de Alarmes: Organi za o modo como os eventos e al armes sero tratados
Configurao de Alarmes: neste objeto que os al armes a serem tratados so cri ados e suas fontes confi guradas
13.1 Servidor de Alarmes
O objeto Servidor de Alarmes central i za todos os al armes do projeto. Nel e podem ser encontrados os totai s de al armes ati vos
da apl i cao (reconheci dos ou no). El e tambm o responsvel por reportar os eventos de al armes para todos os Vi ewers
conectados, bem como, se desejado, envi ar esses eventos para um Banco de Dados.
IMPORTANTE: Um Domni o pode ter somente um objeto desse ti po, e a sua presena obri gatri a para que haja veri fi cao de
al armes.
Atravs da aba Configurao possvel especi fi car se os al armes sero armazenados no Banco de Dados. Os al armes podem
ser vi sual i zados em um E3Al arm ou em um E3Browser, objetos de Tel a que sero vi stos mai s adi ante.
13.2 Configurao de Alarmes
O objeto Configurao de Alarmes onde as Fontes de Al arme so cri adas. Para i nseri r esse objeto no projeto, cl i que com o
boto di rei to do mouse sobre o Organi zer, escol ha a opo Inserir Configurao de Alarmes em, e em segui da o nome do
projeto desejado.
13.2.1 rea
O objeto rea permi te agrupar um conjunto de Fontes de Al armes, bem como outras reas de Al arme. Isso faci l i ta o
gerenci amento, a operao e o moni toramento de um conjunto de Fontes de Al armes rel aci onados, permi ti ndo, 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.
13.2.2 Fontes de Alarme
As Fontes de Alarme defi nem todas as i nformaes rel ati vas s condi es de al arme. Em cada Fonte de Al arme so
confi gurados seus l i mi tes, a mensagem rel ati va ao evento, sua severi dade, bem como a necessi dade ou no de
reconheci mento desse evento. Todas as Fontes de Al arme possuem as segui ntes propri edades gerai s:
Propriedades gerais das Fontes de Alarme
PROPRIEDADE DESCRIO
Texto da Mensagem o texto associ ado quel a condi o de al arme, que aparecer
no objeto de vi sual i zao (E3Al arm), Banco de Dados, etc.
Pode conter at 255 caracteres de texto.
Severidade I ndi ca a gravi dade do al arme ocorri do, podendo ser Baixa,
Mdia ou Alta. A severi dade uti l i zada para fi l tragem e
ordenao de mensagens.
Pede Ack I ndi ca que 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 ai nda se
reconheci do automati camente quando a vari vel dei xa uma
condi o de al arme.
Mensagem de Retorno Sempre que uma Fonte de Al arme sai da condi o de al arme,
essa mensagem ser exi bi da nos objetos de vi sual i zao.
H vri os ti pos de Fontes de Al arme que podem ser i nseri das na rea de Al arme.
90 Alarmes
13.2.2.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).
Fonte de Alarme Analgico
13.2.2.2 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).
Fonte de Alarme Banda Morta
13.2.2.3 Taxa de Variao
Permi te moni torar vari aes mui to rpi das em uma vari vel do processo. A Fonte de Al arme Taxa de Vari ao usa seus
val ores especi fi cados em uni dades da vari vel por segundo.
Alarmes 91
Fonte de Alarme Taxa de Variao
13.2.2.4 Digital
Permi te moni torar uma vari vel (ou expresso) 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).
Fonte de Alarme Digital
92 Alarmes
13.2.2.5 Discreto
Permi te moni torar uma vari vel pel a especi fi cao de ml ti pl as subcondi es.
Fonte de Alarme Discreto
13.3 E3Alarm
O E3Al arm serve para o moni toramento dos al armes ati vos ou no reconheci dos no si stema. Atravs desse objeto, possvel
veri fi car o estado dos al armes no si stema, bem como reconhec-l os manual mente. Para uti l i zar esse objeto, cl i que com o
boto di rei to do mouse na rea de trabal ho, e sel eci one a opo Inserir - E3Alarm.
E3Alarm
Na aba Geral das propri edades do E3Al arm so especi fi cadas as i nformaes referentes ao Servi dor de Al armes e ao fi l tro.
Alarmes 93
Aba Geral
13.4 Exerccios
13.4.1 Servidor de Alarmes
Uma apl i cao s pode ter um objeto desse ti po, e a sua presena obri gatri a para que haja veri fi cao de al armes. El e o
responsvel por reportar os eventos de al armes para todos os Vi ewers conectados, bem como, se desejado, envi ar esses
eventos para um Banco de Dados.
1. Insi ra um objeto Servi dor de Al armes no TreinamentoE3.
Inserir Servidor de Alarmes
2. Acesse as propri edades do Servi dor de Al armes, e na aba Configurao habi l i te a opo Guarde alarmes no banco de
dados.
3. Na opo Utilize o servidor de banco de dados, escol ha BancoDados.
4. Habi l i te a opo Descarta dados da tabela principal.
Mantenha os dados dos l ti mos 3 meses
94 Alarmes
A veri fi cao deve ocorrer a cada 1 ms
5. Cl i que em Campos e sel eci one os campos que desejar. Para o correto funci onamento com o E3Pl ayBack, i nsi ra os campos:
EventTimeDbl
FullAlarmSourceName
ConditionActive
Acked
AckRequired
6. Por l ti mo, cl i que em Gerar Tabela. Ser exi bi da uma mensagem de sucesso.
Gerar estrutura da tabela
13.4.2 Configurao de Alarmes
1. Insi ra no projeto um objeto Confi gurao de Al armes.
Inserir Configurao de Alarmes
13.4.3 Alarme Analgico
1. Cri e dentro da Confi gurao de Al armes uma nova rea de Al armes, cl i cando em Adicionar e modi fi que o seu nome para
Nivel.
Adicionar rea de
Alarme
2. Sel eci one a rea cri ada e cl i que em Adicionar. Insi ra uma Fonte de Al arme do ti po Anal gi co.
Alarmes 95
Adicionar Alarme Analgico
3. Renomei e o Al arme Anal gi co para Tanque1.
4. Cl i que sobre a rea de edi o da Fonte de Al arme Tanque1 e, atravs do AppBrowser, sel eci one a propri edade Value do
Tag Nivel1 da pasta Dados.
5. Acesse as propri edades do Al arme do Tanque1, aba Analgico.
Marque o i tem LoLo, com l i mi te i gual a 10 e mensagem "Nvel 1 Mui to Bai xo"
Marque o i tem Lo, com l i mi te i gual a 30 e mensagem "Nvel 1 Bai xo"
Marque o i tem Hi, com l i mi te i gual a 70 e mensagem "Nvel 1 Al to"
Marque o i tem HiHi, com l i mi te i gual a 90 e mensagem "Nvel 1 Mui to Al to"
No i tem Volta ao normal, di gi te "Nvel 1 normal i zado"
6. Copi e o Al arme Tanque1 para cri ar o Al arme Tanque2.
7. Associ e o Al arme Tanque2 ao Tag Nivel2 e al tere as mensagens do Al arme.
Associao dos Alarmes com os Tags
13.4.4 Alarme Banda Morta
1. Insi ra uma nova rea com o nome de Temperatura.
2. Na rea Temperatura i nsi ra um Al arme de Banda Morta com o nome de Tanque1.
3. Associ e esse Al arme ao Tag Temp1 da pasta Dados.
4. Acesse as propri edades do Al arme, aba Banda Morta.
5. Confi gure as segui ntes propri edades:
Setpoint:50
BM: 10
Texto da mensagem: Temperatura fora da fai xa recomendada
96 Alarmes
Alarme Banda Morta
6. Copi e o Al arme Tanque1 para cri ar o Al arme Tanque2.
7. Associ e o Al arme Tanque2 ao Tag Temp2 e al tere as mensagens do Al arme.
Associao dos Alarmes com os Tags
13.4.5 Alarme Digital
1. No objeto TagBomba, i nsi ra uma Confi gurao de Al armes.
2. Sel eci one a Confi gurao de Al armes e cri e uma nova rea com o nome de Bomba.
3. Na rea Bomba, i nsi ra um Al arme Di gi tal com o nome de Defeito.
Alarme Digital Defeito
4. Associ e ao Al arme Defeito a propri edade Defeito do objeto.
5. Acesse as propri edades do Al arme Defeito, aba Digital:
Marque a opo Alarme Digital
Escol ha a opo True em Valor de Alarme
6. Para que nas mensagens de Al arme e retorno aparea o nome da bomba, cri e as Associ aes vi stas na prxi ma fi gura.
Alarmes Digitais
13.4.6 E3Alarm
A vi sual i zao dos Al armes em tempo real pode ser fei ta atravs do objeto E3Al arm.
1. Posi ci one um objeto E3Al arm na TelaAlarmes.
2. Nas propri edades do E3Al arm, aba Geral, i nforme o nome do Servi dor de Al armes.
Alarmes 97
Selecionar Servidor de Alarmes
3. A mesma confi gurao pode ser fei ta atravs da l i sta de propri edades. Na propri edade AlarmServer, di gi te o nome do
Servi dor de Al armes, ou arraste-o at a propri edade.
Propriedade AlarmServer
4. Acesse as propri edades do E3Al arm. Na aba Colunas, sel eci one os campos DataHora, Operador, Mensagem, Reconhecido e
Valor.
5. Na aba Cores faa a confi gurao que desejar.
6. Execute a apl i cao e confi ra as funci onal i dades.
13.5 Exerccios Complementares
13.5.1 Reconhecer Todos os Alarmes
Vamos cri ar um boto onde possvel reconhecer todos os al armes ati vos.
1. Na TelaAlarmes, cri e um boto com o texto "Reconhecer".
2. No boto, cri e o segui nte scri pt no evento Click.
'Reconhecer todos os alarmes
Screen.Item("E3Alarm1").AckAll(Application.User)
3. Busque, com o auxl i o do AppBrowser, na TelaAlarmes o objeto E3Alarms1 e di rei ta o mtodo AckAll.
Screen.Item("E3Alarm1").AckAll([Operator])
4. Substi tua o parmetro Operator pel o nome do usuri o l ogado no Vi ewer. Com o auxl i o do AppBrowser busque a
propri edade User do Vi ewer.
98 Alarmes
13.5.2 KB
KB-29110: Gerando um beep no speaker do PC quando al arme for ati vado.
KB-17370: Executando um som sempre que exi sti r um al arme ati vo.
13.6 Anotaes
Consultas 99
14
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 o
E3 necessi ta buscar dados do Banco de Dados necessri o envi ar um comando, de forma que se sai ba quai s os dados
desejados para aquel e objeto. Para essa busca, 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 de consul tas SQL usando uma i nterface grfi ca e o
acompanhamento i medi ato do cdi go SQL gerado. A Consul ta permi te mostrar os dados dos l ti mos n di as, horas ou meses,
data i ni ci al e fi nal e consul tas, dependendo do fi l tro a ser i mpl ementado.
O Assi stente de Confi gurao 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 esse recurso, 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 se cri a um objeto Rel atri o ou um E3Browser, o objeto Consul ta adi ci onado a este automati camente. No
entanto, tambm se pode i nseri r uma Consul ta em uma Pasta de Dados ou em uma Tel a e uti l i zar seus dados atravs de
scri pts.
14.1 Criando uma Consulta
1. A defi ni o da Consul ta comea quando o usuri o i nforma o Servi dor de Banco de Dados onde a Consul ta i r buscar os
dados.
Definir o Servidor de Banco de Dados
2. Aps ser defi ni do o Banco de Dados, uma nova janel a aparecer com as tabel as que foram encontradas, permi ti ndo a sua
sel eo.
Seleo de tabelas
3. Sel eci one as tabel as que faro parte da Consul ta e cl i que em Adicionar.
4. Na aba Campos, sero adi ci onados os campos a serem retornados pel a Consul ta, bem como defi ni dos fi l tros e
ordenaes.
100 Consultas
5. Na aba Variveis, so mostradas as vari vei s cri adas para os fi l tros.
6. Na aba Visualizar, pode-se real i zar uma prvi a da Consul ta.
7. Na aba SQL, pode-se vi sual i zar e edi tar o cdi go SQL.
Janela de configurao da Consulta
A janel a anteri or pode ser acessada atravs de um cl i que com o boto di rei to do mouse sobre o objeto e sel eci onando a
opo Configurar.
14.1.1 Criando e Acessando Variveis
Na janel a de confi gurao da Consul ta, pode-se adi ci onar fi l tros di retamente nos campos. Estes fi l tros podem ser
consti tudos de vari vei s que sero defi ni das por scri pt uti l i zando o mtodo SetVariableValue da Consul ta. A forma de
decl arar as vari vei s depende do ti po de dado que el as representam, como vemos a segui r:
Nmero: <%Nome_da_Variavel%>
String: '<%Nome_da_Variavel%>'
Data e hora: #<%Nome_da_Variavel%>#
14.2 E3Browser
O E3Browser um control e Acti veX (desenvol vi do pel a El i pse Software) uti l i zado para vi sual i zar dados armazenados em
Banco de Dados, gerados pel o E3 ou outro software qual quer. 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. Esse 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
Para uti l i zar este recurso, i nsi ra o E3Browser no projeto atravs do cl i que com o boto di rei to do mouse na Tel a, e sel eci one a
opo Inserir - E3Browser.
Consultas 101
Inserir E3Browser
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.
14.3 Exerccios
Vamos vi sual i zar os dados de al armes armazenados no Banco de Dados em forma de tabel a uti l i zando o objeto E3Browser.
14.3.1 TelaEventos
1. Insi ra no projeto uma nova Tel a, chamada TelaEventos, a ser aberta no Di vi sor Area_Central. Marque a opo Tela
inicial do Divisor.
2. Na TelaMenu, i nsi ra um boto para abri r a TelaEventos.
14.3.2 E3Browser
1. Insi ra um E3Browser na TelaEventos.
2. Para confi gurar os dados que o E3Browser mostrar, acesse as propri edades do objeto e v at a aba Consulta.
3. Sel eci one a Consulta1 e cl i que em Configurar.
Aba Consulta
4. Sel eci one o Banco de Dados que contm a tabel a que se deseja consul tar.
5. Escol ha a tabel a Al arms.
6. Sel eci one todos os campos da tabel a Al arms.
102 Consultas
Tabela Alarms
7. Abra a aba Visualizar e cl i que em Executar Consulta para veri fi car o resul tado da Consul ta.
Executar Consulta
8. Cl i que em OK. Ao fi nal i zar esse passo, estaro di sponvei s no E3Browser todos os campos l i stados na Consul ta. Confi gure
cada campo com a cor, formatao e tamanho que desejar.
Configurao da Consulta
14.3.3 Filtros na Consulta
Mui tas vezes, acessar todo o contedo de uma tabel a se torna i nvi vel pel a quanti dade de dados armazenados, seja pel o al to
nmero de campos, ou pel o grande nmero de regi stros. Nesses casos somos obri gados a apl i car fi l tros nos Hi stri cos.
1. Insi ra na TelaEventos doi s Setpoi nts chamados de spDataInicial e spDataFinal e doi s textos conforme a fi gura a
segui r.
Setpoints para escolha das datas
2. Usaremos um mtodo do Vi ewer que mostra um cal endri o para a escol ha de uma data pel o usuri o. Cri e um novo scri pt
no evento Click dos Setpoi nts.
'Chama a funo Calendrio
If Application.ShowDatePicker(DataHora, 0, 0) Then
'Passa a data escolhida para o SetPoint
Value = DataHora
End If
Consultas 103
3. Busque, com o auxl i o do AppBrowser , o mtodo ShowDatePicker do Vi ewer e cl i que em Colar.
Application.ShowDatePicker(DateValue, Left, Top, [DefaultDate])
4. O parmetro DefaultDate opci onal e i nforma a data sel eci onada no cal endri o. Apague-o poi s usaremos o padro, que
corresponde data atual .
5. Substi tua os parmetros Left e Top por 0 ou a coordenada que desejar abri r o cal endri o.
6. O parmetro DateValue deve ser substi tudo por uma vari vel i nterna de scri pt. Chamaremos essa vari vel de DataHora.
7. O mtodo ShowDatePicker retorna Verdadei ro se o usuri o cl i car em OK e Fal so se cl i car em Cancelar. Somente se cl i car
em OK que devemos passar o val or do cal endri o para o Setpoi nt. Di gi te "If" no comeo da l i nha do comando
ShowDatePicker e "Then" no fi nal .
If Application.ShowDatePicker(DataHora, 0, 0) Then
8. Para passar a data do cal endri o para o Setpoi nt, di gi te na prxi ma l i nha o texto a segui r.
Value = DataHora
9. Como estamos escrevendo o scri pt no Setpoi nt e desejamos referenci ar a sua propri edade Value, podemos di gi tar
di retamente o nome da propri edade sem ser obri gatri o o cami nho compl eto.
10. Fi nal i ze o scri pt di gi tando "End If".
11. Acesse o objeto Consul ta do E3Browser. Isso pode ser fei to cl i cando com o boto di rei to do mouse no objeto e
sel eci onando o i tem Configurar, ou pel a aba Consulta das propri edades do E3Browser.
Consulta do E3Browser
12. Na col una Filtro do campo E3TimeStamp, cl i que em Configurar Filtro .
13. Para o usuri o poder escol her a data i ni ci al e a data fi nal , preci samos cri ar vari vei s de consul ta. Confi gure o fi l tro
conforme a fi gura a segui r.
Configurando o Filtro
14. Di gi te um val or i ni ci al para as vari vei s cri adas na aba Variveis.
104 Consultas
Variveis da Consulta
15. Acesse a aba Visualizar e cl i que em Executar Consulta para veri fi car o resul tado da Consul ta. Certi fi que-se que o fi l tro
foi apl i cado e cl i que em OK.
16. Na TelaEventos, embai xo dos Setpoi nts, cri e um boto Consultar, e i nsi ra um novo scri pt no evento Click com as
segui ntes l i nhas.
'Referencia os Setpoints
DataIni = Screen.Item("spDataInicial").Value
DataFim = Screen.Item("spDataFinal").Value
Set consulta = Screen.Item("E3Browser1").Item("Consulta1")
'Configura as variveis da Consulta
consulta.SetVariableValue "DataInicial", DataIni
consulta.SetVariableValue "DataFinal", DataFim
17. Di gi te a vari vel i nterna de scri pt "DataIni = ".
18. Busque, com o auxl i o do AppBrowser, o Setpoi nt spDataInicial e di rei ta sua propri edade Value.
DataIni = Screen.Item("spDataInicial").Value
19. Repi ta o passo anteri or para cri ar a vari vel i nterna DataFim, referenci ando o val or do Setpoi nt spDataFinal.
DataFim = Screen.Item("spDataFinal").Value
20. Busque, com o auxl i o do AppBrowser, a Consulta1 que est dentro do E3Browser1. di rei ta sel eci one o mtodo
SetVariableValue.
Screen.Item("E3Browser1").Item("Consulta1").SetVariableValue(VarName, Value)
21. Quebre a l i nha aps ("Consul ta1").
Screen.Item("E3Browser1").Item("Consulta1")_
.SetVariableValue(VarName, Value)
22. Di gi te no comeo da l i nha o texto "set consul ta = ". Desse modo cri amos uma vari vel i nterna de scri pt que referenci a o
objeto Consul ta.
Set consulta = Screen.Item("E3Browser1").Item("Consulta1")
23. No i nci o da l i nha que contm o mtodo SetVariableValue di gi te "consul ta.".
consulta.SetVariableValue(VarName, Value)
24. O parmetro VarName referenci a o nome da vari vel cri ada na Consul ta. Di gi te "DataIni ci al ".
25. No parmetro Value i nforme o val or que deseja passar para a vari vel . Neste caso, desejamos passar o val or do Setpoi nt
Consultas 105
que referenci amos atravs da vari vel i nterna DataIni.
consulta.SetVariableValue "DataInicial", DataIni
26. Remova os parnteses do mtodo SetVariableValue.
27. Copi e a l i nha anteri or para i mpl ementar a mesma l gi ca para a vari vel DataFinal.
consulta.SetVariableValue "DataFinal", DataFim
28. Compi l e o scri pt e teste.
14.4 Exerccios Complementares
14.4.1 KB
KB-20214: Funo SQL para cal cul ar val ores mxi mo, mni mo e mdi a.
106 Consultas
14.5 Anotaes
Histricos 107
15
Histricos
CAPTULO
Os Histricos so os mdul os responsvei s pel o armazenamento de dados da apl i cao em Banco de Dados. Permi tem
armazenar dados de processos para anl i ses futuras, no E3 ou em qual quer outra ferramenta.
Podem-se cri ar tantos arqui vos de Hi stri co quantos se 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. possvel ai nda determi nar qual Banco de Dados i nseri do no projeto ser uti l i zado para o
armazenamento dos dados. Para uti l i zar esse recurso, 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 - Histrico.
Para cri ar a tabel a no Hi stri co, i mportante cri ar seus campos. Tai s campos podem ser cri ados cl i cando em (Adicionar
um campo). Para remover al gum campo i ndesejado, cl i que em (Remover os campos).
Histrico
15.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. Aps ter defi ni do 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(s) campo
(s) que seja(m) chave(s) pri mri a(s).
H doi s ti pos de chave pri mri a, a Simples e a 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, pel o fato deste
apresentar 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 uma tabel a para serem uma chave pri mri a separada cada. 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 de Chave Pri mri a, consi dere os segui ntes detal hes:
No permi ti da dupl i ci dade de val ores ou val ores 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 o campo da tabel a que se deseja
tornar Chave Pri mri a e habi l i tando-a ao cl i car em , ou cl i cando em , que abri r a tel a de confi gurao.
15.2 ndices
Um ndice um campo ou um conjunto de campos que sero previ amente ordenados pel o Banco de Dados a fi m de mel horar o
desempenho das consul tas que uti l i zam esse ndi ce. El es so uti l i zados para encontrar rapi damente regi stros com um val or
especfi co em uma col una. 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 os regi stros
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 em termos de
tempo de processamento. Se a tabel a possui 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. Os ti pos de ndi ces
di sponvei s so Primrio, nico e Index.
Podem-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 val ores de col unas i ndexadas.
Os ndi ces podem ser confi gurados atravs do cone , que abre a tel a de confi gurao, i l ustrada a segui r.
108 Histricos
Editor de ndices
15.3 Exerccios
15.3.1 Histrico
1. Cl i que com o boto di rei to do mouse no i tem Banco de Dados e i nsi ra um novo Hi stri co no projeto TreinamentoE3,
nomeando-o como HistNivel.
Inserir Histrico
2. No Hi stri co cri ado, i nsi ra doi s novos campos e confi gure-os conforme a fi gura a segui r.
Configurao dos campos
Histricos 109
3. Cl i que sobre a opo Propriedades do Histrico , e na aba Histrico confi gure as segui ntes propri edades:
Banco de dados: BancoDados
Tabela: Nivel
Tempo de gravao: 2000 ms
4. Cl i que em Gerar Tabela. Deve aparecer a mensagem "A estrutura de tabel as foi cri ada com sucesso".
Mensagem de sucesso ao gerar tabela
15.4 Exerccios Complementares
15.4.1 KB
KB-24714: Li mi te de campos de um Hi stri co.
110 Histricos
15.5 Anotaes
E3Chart 111
16
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 com Tags vari ando em tempo real e tambm mostrar dados hi stri cos gravados em um Banco de Dados.
Cada sequnci a de dados representada no E3Chart atravs de Penas. Para cada Pena so associ ados dados, que podem ser
Tags ou campos de Consul tas. possvel cri ar vri os ei xos com escal as di ferentes para serem associ ados aos dados das
Penas.
E3Chart
Para i nseri r esse objeto na Tel a, cl i que com o boto di rei to do mouse e sel eci one a opo Inserir - E3Chart.
16.1 Configuraes das 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 confi gurar o nmero e o ti po das
Penas a serem cri adas na Col eo de Penas. Acessando essa aba e cl i cando em Adicionar, uma nova Pena cri ada no
E3Chart.
112 E3Chart
Propriedades da Pena
16.1.1 Tempo Real
Para confi gurar uma Pena como Tempo Real , sel eci one a opo Tempo Real na aba Dados das propri edades da Pena,
di sponvel no i tem Tipo de pena. Logo aps, defi na os Tags nas opes Link do eixo vertical e Link do eixo horizontal.
16.1.2 Histrica
O objeto Consul ta tambm usado para mostrar val ores hi stri cos no E3Chart. Atravs da aba Consultas possvel adi ci onar,
excl ui r ou confi gurar as Consul tas. Para cri ar uma Pena Hi stri ca, necessri o que a Consul ta esteja previ amente cri ada.
Para tanto, na aba Dados das propri edades da Pena, sel eci one a opo Histrica, di sponvel no i tem Tipo de pena e defi na a
Consul ta. Logo aps, defi na os campos da Consul ta nos i tens Campo do eixo vertical e Campo do eixo horizontal.
16.1.3 Tempo Real e Histrica (Mista)
Para confi gurar uma Pena como Tempo Real e Hi stri ca, na aba Dados das propri edades da Pena, sel eci one na opo Tipo de
pena o i tem Tempo Real & Histrica. Este ti po de Pena uti l i zado quando se deseja ter os dados anti gos e os val ores atuai s
dos Tags na mesma Pena.
16.2 Exerccios
Vamos fazer um grfi co com Penas de Tempo Real e Hi stri cas com as vari vei s de nvel . Atravs de um boto, vamos escol her
entre o grfi co exi bi r o ei xo hori zontal como tempo real ou hi stri co.
16.2.1 TelaGrafico
1. Insi ra no projeto uma nova Tel a, chamada TelaGrafico, a ser aberta no Di vi sor Area_Central. Marque a opo
Configurar como Tela inicial do Divisor.
2. Na TelaMenu, i nsi ra um boto para abri r a TelaGrafico.
E3Chart 113
16.2.2 E3Chart
1. Posi ci one um E3Chart na TelaGrafico.
16.2.3 Escala
Os mai ores val ores so do Tag Nivel, que vari a de 0 a 100, portanto vamos al terar a escal a verti cal para exi bi r os val ores
nessa fai xa.
1. Na aba Eixos, sel eci one o EixoVertical e cl i que em Configurar.
2. Na aba Escala, confi gure os l i mi tes da escal a numri ca entre 0 e 100.
16.2.4 Consulta
Como desejamos vi sual i zar os dados hi stri cos, preci samos confi gurar uma Consul ta.
1. Acesse as propri edades do E3Chart, aba Consultas.
2. Cl i que no boto Adicionar. Sel eci one "BancoDados" no campo Nome do Servidor, e a segui r escol ha a tabel a Ni vel .
3. Sel eci one os campos E3TimeStamp, Nivel1 e Nivel2.
4. Vi sual i ze o resul tado da consul ta na aba Visualizar e cl i que em OK.
16.2.5 Penas
1. Na aba Penas, cl i que em Adicionar.
2. Com um dupl o-cl i que sobre a Pena, acesse suas propri edades.
3. Troque o nome da Pena para Nivel1.
Propriedades da Pena
4. Na aba Dados, dei xe a opo Tipo de pena em Tempo Real & Histrica.
5. Na opo Link do eixo vertical, sel eci one a propri edade Value do Tag Nivel1 da pasta Dados.
6. No i tem Parte Histrica, preencha os campos a segui r:
Consulta local: Consul ta1
Campo do eixo vertical: Ni vel 1
Campo do eixo horizontal: E3Ti meStamp
Dados da Pena
7. Repi ta os passos anteri ores para a Pena Nivel2.
114 E3Chart
16.2.6 Legenda
1. Na aba Legenda, sel eci one a opo Mostrar legenda, tamanho 60, e adi ci one as col unas que preferi r.
2. Confi gure a col una Valor do tag X para mostrar o val or no formato "HH:mm:ss".
16.2.7 Visibilidade das Penas
1. Para habi l i tar ou desabi l i tar a vi si bi l i dade de uma Pena, adi ci one uma Cai xa de Sel eo na TelaGrafico.
2. Na Cai xa de Sel eo, cri e um scri pt no evento Change, e busque no AppBrowser a propri edade Visible da Pena Nivel1.
Propriedade Visible da Pena
3. Compl ete a l i nha do scri pt com o cdi go a segui r.
Screen.Item("E3Chart1").Pens.Item("Nivel1").Visible = Value
4. Busque, com o auxl i o do AppBrowser, o E3Chart que est dentro da TelaGrafico, col eo Pens, Pena Nivel1, e di rei ta
sel eci one a propri edade Visible. Cl i que em Colar.
5. Di gi te " = Val ue". Como estamos escrevendo o scri pt na Cai xa de Sel eo, ao di gi tar "Val ue" fazemos refernci a ao val or
do prpri o objeto.
6. Confi gure o val or i ni ci al (Value) da Cai xa de Sel eo para True.
7. Repi ta os passos anteri ores para a Pena Nivel2.
16.2.8 Eixo Horizontal Histrico
Para navegarmos pel o grfi co consul tando dados anti gos, o ei xo hori zontal deve estar confi gurado como Histrico.
1. Acesse as propri edades do E3Chart, aba Eixos.
2. Sel eci one o Ei xoHori zontal e cl i que em Configurar.
3. Na aba Escala, escol ha a opo Intervalo de tempo (histrico).
Intervalo de tempo
4. Escol ha um i nterval o i ni ci al pequeno (ci nco mi nutos), assi m a Tel a ser carregada rapi damente.
16.2.9 Intervalo do Grfico
1. Para podermos escol her a data i ni ci al e data fi nal vi sual i zada no E3Chart, copi e da TelaEventos os Setpoi nts com a
data i ni ci al e data fi nal para a TelaGrafico.
E3Chart 115
Data inicial e final
2. No Setpoi nt com a data i ni ci al , cri e uma Associ ao Bi di reci onal com a propri edade HorScaleBegin do E3Chart.
Associao Bidirecional
3. No Setpoi nt com a data fi nal , cri e uma Associ ao Bi di reci onal com a propri edade HorScaleEnd do E3Chart.
16.3 Exerccios Complementares
16.3.1 Minutos Recentes
Desejamos i ni ci ar a Tel a exi bi ndo no grfi co os l ti mos 10 mi nutos. A manei ra mai s prti ca de se referenci ar o horri o atual
pel o comando Now do VBScri pt. Para retornar o di a anteri or, usamos Now - 1. Para uma hora atrs, Now - 1 / 24.
1. No evento OnPreShow da TelaGrafico, i nsi ra o segui nte scri pt.
'Grfico exibe os ltimos 10 minutos.
Item("E3Chart1").HorScaleBegin = Now - 10 / 1440
Item("E3Chart1").HorScaleEnd = Now
2. Busque, com o auxl i o do AppBrowser, o E3Chart dentro da TelaGrafico e di rei ta a propri edade HorScaleBegin.
3. Di gi te " = Now - 10 / 1440".
4. Busque, com o auxl i o do AppBrowser, o E3Chart dentro da TelaGrafico e di rei ta a propri edade HorScaleEnd.
5. Di gi te " = Now".
16.3.2 KB
KB-18257: Cri ando um grfi co com pontos di gi tai s.
116 E3Chart
16.4 Anotaes
Relatrios 117
17
Relatrios
CAPTULO
O Relatrio um componente Acti veX chamado Acti veReport, 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). Para uti l i zar o
Rel atri o, cl i que com o boto di rei to do mouse no i tem Visualizao - Relatrios do Organi zer, em modo Domni o, e sel eci one a
opo Inserir Relatrio em, e em segui da o nome do projeto desejado.
O Rel atri o tambm uti l i za o objeto Consul ta. Este objeto permi te que seja especi fi cada a ori gem dos dados do Banco de
Dados que sero vi sual i zados no rel atri o.
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 uni dade.
Sees do Relatrio
Um Rel atri o estruturado da segui nte forma:
Estrutrura do Relatrio
SEO DESCRIO
Report Header Esta seo i mpressa no i nci o do Rel atri o. Uti l i zada para
i mpri mi r ttul os de Rel atri os, 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.
Report Footer Esta seo i mpressa no fi nal do Rel atri o. Uti l i zada 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.
Page Header Esta seo i mpressa no topo de cada pgi na do Rel atri o.
a pri mei ra seo i mpressa na pgi na, exceto quando essa
pgi na contm a seo Report Header. Uti l i zada para i mpri mi r
cabeal hos de col unas, nmeros de pgi nas, ttul os de
pgi nas ou qual quer outra i nformao que necessi te ser
i mpressa no i nci o de cada pgi na.
Page Footer Esta seo i mpressa uma vez na base de cada pgi na no
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.
118 Relatrios
SEO DESCRIO
Detail Esta seo o corpo do Rel atri o que i mpri me uma vez para
cada regi stro da fonte de dados.
Group Header, 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 mpressa antes de qual quer seo Detail no grupo. A
seo Footer i mpressa depoi s da seo Detail do grupo.
A barra de ferramentas Rel atri o contm trs i tens de confi gurao que permi tem edi tar, vi sual i zar o Rel atri o e cri ar scri pts.
Estes i tens so os segui ntes:
Prvia de Impresso (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.
Configuraes do Relatrio (Report Settings): Nestas confi guraes pode-se determi nar Configuraes de Pgina,
Configuraes de Impresso, Configuraes da Grade e Estilo do Relatrio
Editor de Scripts: Atravs desta opo, possvel edi tar scri pts para o Rel atri o. No campo Object necessri o
especi fi car o objeto onde se deseja cri ar o scri pt e, no campo Events, o evento do Rel atri o em que ocorrer a ao
17.1 Objetos do Relatrio
A ferramenta Rel atri o possui vri os objetos especfi cos que podem ser uti l i zados, sendo acessados atravs da barra de
ferramentas Rel atri o.
Barra de Ferramentas Relatrio
Atravs da barra de ferramentas Rel atri o, possvel acessar os recursos di sponvei s desta opo:
Linha: Objeto bsi co de reta que 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
Retngulo: Este objeto 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 Arredondado: Retngul o cri ado atravs de doi s vrti ces com a opo dos cantos serem 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 canto superi or
esquerdo do objeto, que permi te modi fi car o fator de arredondamento
Elipse: Este objeto permi te o desenho de crcul os e el i pses, uti l i zando toda a l argura ou al tura e defi ni ndo o centro do
crcul o no centro do retngul o
Figura: Este objeto permi te mostrar i magens que estejam armazenadas em arqui vos, estejam el as dentro ou fora do
arqui vo do apl i cati vo
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
Campo de Dados: Atravs do objeto Campo de Dados, possvel associ ar um campo da tabel a no Banco de Dados. Este
campo especi fi cado na propri edade DataField
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 uma representao numri ca ou al fanumri ca, uti l i zada para faci l i tar di ferentes processos. Esse
cdi go deci frado atravs de scanners, canetas e equi pamentos de l ei tura pti ca
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
Tabela: um objeto composto por l i nhas e col unas ondes so i nseri dos textos ou grfi cos. As tabel as nos Rel atri os so
usadas para organi zar e apresentar a i nformao. Pode-se tambm usar tabel as para cri ar layouts de pgi na
E3Chart: Este objeto uti l i zado para vi sual i zar os dados do Rel atri o em formato grfi co. Mai ores i nformaes esto
descri tas no captul o sobre o E3Chart
/ Enviar para frente / Enviar para trs: Atravs destes botes, possvel envi ar um objeto para frente ou para trs de
outro. Ao escol her as opes Enviar para frente ou Enviar para trs, o objeto sel eci onado ser col ocado na pri mei ra ou na
l ti ma posi o na ordem de sobreposi es
Carregar Arquivo RPX: Importa a confi gurao do Rel atri o de um arqui vo externo
Relatrios 119
Salvar Arquivo RPX: Exporta a confi gurao do Rel atri o para um arqui vo externo
NOTA: A opo Impressora do cone do E3 Server na Barra de Tarefas exi be 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.
17.2 Exerccios
Ser fei to um Rel atri o onde ser i mpresso o grfi co da Tel a e em segui da todos os dados exi bi dos no grfi co.
17.2.1 Relatrio Grfico
Vamos cri ar um rel atri o grfi co que copi a as confi guraes do grfi co da Tel a. Esse rel atri o ser i mpresso e exportado
para PDF.
1. Insi ra no projeto um Rel atri o chamado RelatorioGrafico.
2. Na seo Page Header, i nsi ra um objeto E3Chart.
3. Acesse o Edi tor de Scri pts, cl i cando em .
4. No campo Object escol ha o i tem Page Header, e no campo Events escol ha o i tem OnBeforePrint.
5. Entre os textos "Sub OnBeforePri nt" e "End Sub", di gi te o segui nte scri pt:
Set Chart = Report.Sections("PageHeader").Controls("E3Chart1")
Set ChartTela = Application.GetFrame("Area_Central").Screen.Item("E3Chart1")
Chart.CopyConfig(ChartTela)
Chart.LoadData()
17.2.2 Imprimir
Antes de exportar o Rel atri o, vamos ter a possi bi l i dade de vi sual i zar a i mpresso.
1. Na TelaGrafico, i nsi ra um Boto de Comando com o texto "Impri mi r".
2. Cri e um scri pt no evento Click que uti l i za o Pi ck Imprimir Relatrio. Sel eci one o RelatorioGrafico e escol ha Tela na
opo Sada.
17.2.3 Exportar
Para o usuri o escol her o nome e di retri o do arqui vo que ser gerado, abri remos uma cai xa de di l ogo.
1. Insi ra um boto Imprimir na TelaGrafico e al tere o texto para "Exportar".
2. Cri e o segui nte scri pt no evento Click do boto:
If Application.ShowFilePicker(False, NomeArquivo,"pdf", _
128, "Arquivos PDF|*.pdf|Todos os arquivos|*.*") Then
Set Report = Application.LoadReport("RelatorioGrafico")
Report.Export "PDF", NomeArquivo
End If
3. Com o auxl i o do AppBrowser, busque o mtodo ShowFilePicker do Vi ewer.
Application.ShowFilePicker(Open, FileName, Extension, Flags, Filter)
4. Como desejamos sal var um arqui vo, substi tua o parmetro Open para Fal se.
5. O parmetro FileName deve ser uma vari vel i nterna de scri pt que armazenar o nome do arqui vo. Substi tua-o por
"NomeArqui vo".
6. Caso no seja i nformada a extenso do arqui vo, ser consi derado como padro o que for i nformado no parmetro
Extension. Di gi te "pdf".
7. Para uma mensagem de confi rmao aparecer para o usuri o caso o arqui vo j exi sta, al tere o parmetro Flags para 128.
8. As cai xas de di l ogo de arqui vos permi tem fi l tros para faci l i tar a busca por ti pos de arqui vos.
Tipos de Arquivos
120 Relatrios
9. O fi l tro sempre um par de Strings separadas pel o caractere "|", sendo que o pri mei ro i tem o nome que aparecer para
o usuri o e o segundo um i denti fi cador do Wi ndows.
10. Substi tua o parmetro Filter por "Arqui vos PDF|*pdf | Todos os arqui vos| *.*".
11. O arqui vo s pode ser gerado se o usuri o cl i car em Salvar. Se o usuri o cancel ar a ao, nada deve acontecer. No i nci o
do comando ShowFilePicker, di gi te "If" e no fi nal di gi te "Then".
12. Para exportar o Rel atri o busque, com o auxl i o do AppBrowser, o i tem Tarefas - Carregar o relatrio - RelatorioGrafico e
di rei ta o mtodo Export.
Set Report = Application.LoadReport("RelatorioGrafico")
Report.Export([ExportFilter], [ExportFileName])
13. Substi tua o parmetro ExportFilter por "PDF" e o parmetro ExportFileName pel a vari vel NomeArquivo, cri ada
anteri ormente.
14. Teste as novas funci onal i dades da apl i cao.
17.2.4 Relatrio de Alarmes
1. Cl i que com o boto di rei to do mouse no projeto e i nsi ra um objeto Rel atri o. Renomei e para RelatorioAlarmes.
2. No objeto Consulta1 do Rel atri o, cl i que com o boto di rei to do mouse e escol ha a opo Configurar.
Configurar Consulta
3. Consul te todos os campos que desejar da tabel a Al arms.
4. Cri e um fi l tro para o campo E3TimeStamp, conforme a fi gura a segui r.
Configurar Filtro
5. Teste a Consul ta i nformando val ores para as vari vei s cri adas.
17.2.5 Page Header
A seo Page Header i mpressa no topo de cada pgi na do Rel atri o. a pri mei ra seo da pgi na a ser i mpressa, exceto
quando esta pgi na contm a seo Report Header. El a uti l i zada para i mpri mi r cabeal hos de col unas, nmeros de pgi nas,
ttul os de pgi nas ou qual quer outra i nformao que necessi te ser i mpressa no i nci o de cada pgi na.
Relatrios 121
1. Para cada campo escol hi do na Consul ta, i nsi ra novos objetos Texto na seo Page Header e confi gure-os com o nome dos
campos. Estes sero os ttul os das col unas.
17.2.6 Detail
A seo Detail o corpo do Rel atri o, i mpressa uma vez para cada regi stro da fonte de dados. Para esta apl i cao, sero
mostrados os dados de al armes.
1. Na seo Detail, i nsi ra um Campo de Dados para cada campo, al i nhando-o com o seu respecti vo texto. Nas
propri edades DataField e Text, di gi te exatamente o nome da col una confi gurada na Consul ta.
2. Para vi sual i zar o Rel atri o, cl i que em Gerar Relatrio .
17.2.7 Page Footer
Esta seo i mpressa uma vez no rodap de cada pgi na do Rel atri o. El a uti l i zada 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 no rodap de cada pgi na.
1. O uso dos campos de dados do Rel atri o do E3 bastante fl exvel , sendo confi gurado no prpri o campo que a funo
dever executar. Por exempl o, ser cri ada na seo Page Footer a i ndi cao "Pgi na 1 de 12".
2. Insi ra doi s Textos, "Pgi na" e "de".
3. Entre os Textos, i nsi ra um Campo de Dados e confi gure-o para mostrar o nmero da pgi na atual :
SummaryType: 4 - ddSMPageCount
SummaryRunning: 2 - ddSRAl l
4. Aps o Texto "de", i nsi ra um Campo de Dados e confi gure-o para mostrar o nmero total de pgi nas:
SummaryType: 4 - ddSMPageCount
SummaryRunning: 0 - None
Seo Page Footer
17.2.8 Report Header e Footer
Estas sees so i mpressas no i nci o ou no fi m do Rel atri o e uti l i zadas para i mpri mi r ttul os de Rel atri os, tabel as de
somas, grfi cos ou qual quer outra i nformao que necessi te aparecer somente uma vez no i nci o ou no fi m do Rel atri o.
1. Cl i que com o boto di rei to do mouse no fundo do Rel atri o e escol ha Insert - Report Header/Footer. Essa opo i nsere
uma pgi na i ni ci al e fi nal no Rel atri o.
Inserir Report Header e Footer
2. Na seo Report Header desenhe uma "capa" para o Rel atri o.
3. Na seo Report Footer, i nsi ra um objeto Campo de Dados e confi gure a propri edade DataField com o cami nho de
Relogio da pasta Dados, Dados.Relogio.
4. Insi ra um segundo Campo de Dados e confi gure-o para exi bi r o nome do usuri o l ogado no Vi ewer.
122 Relatrios
Propriedade DataField
5. Insi ra doi s objetos Texto, "Rel atri o gerado" e "pel o usuri o" conforme a fi gura a segui r.
Seo Report Footer
17.2.9 Imprimir
1. Para vi sual i zar o Rel atri o em tempo de execuo, na TelaEventos copi e o boto Consul tar para cri ar um novo boto
com o texto "Impri mi r".
2. No evento Click do boto, cri e o scri pt a segui r:
' Imprime o Relatrio
' Referencia os Setpoints
DataIni = Screen.Item("spDataInicial").Value
DataFim = Screen.Item("spDataFinal").Value
' Referencia a Consulta do Relatrio
Set Report = Application.LoadReport("RelatorioAlarmes")
Set Consulta = Report.Item("Consulta1")
' Configura as variveis da Consulta
Consulta.SetVariableValue "DataInicial", DataIni
Consulta.SetVariableValue "DataFinal", DataFim
' Visualiza a impresso
Report.PrintPreview()
3. Na l i nha que referenci a o objeto Consul ta, com o auxl i o do AppBrowser, acesse Tarefas - Carregar Relatrio -
RelatorioAlarmes - Consulta1.
Set Report = Application.LoadReport("RelatorioAlarmes")
Set consulta = Report.Item("Consulta1")
4. No fi nal do scri pt, novamente com o auxl i o do AppBrowser, acesse Tarefas - Carregar Relatrio e di rei ta o mtodo
PrintPreview.
5. Apague a l i nha que faz refernci a ao Rel atri o, poi s j o decl aramos no i nci o.
Report.PrintPreview()
6. Teste o mtodo Imprimir. S podem ser i mpressos os dados dentro do i nterval o especi fi cado.
Relatrios 123
17.3 Anotaes
124 Frmulas
18
Frmulas
CAPTULO
Frmulas so mdul os desti nados a armazenar e transferi r conjuntos de val ores para determi nados agrupamentos de
vari vei s, de forma a cri ar confi guraes ou setups pr-defi ni dos, sendo basi camente uma i mpl ementao de recei tas. As
Frmul as so basi camente compostas de trs partes:
Templates: Defi nem o ti po de dado que poder ser armazenado em cada vari vel da frmul a e suas restri es. Estas
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 a al terao
Unidades: Defi nem os Tags que sero associ ados ao template 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
Conjuntos de Valores: So os val ores que sero transferi dos para os Tags, ou seja, para as uni dades
As Frmul as esto sempre l i gadas a um Banco de Dados, poi s preci sam fazer com que seus dados (Templ ates, Uni dades e
Conjuntos de Val ores), confi gurados em al gum momento, conti nuem vl i dos sempre que necessri o. Para trabal har com
Frmul as possvel uti l i zar qual quer ti po de banco de dados, e o prpri o E3 Studi o ou o E3 Server cui da de cri ar as tabel as e
rel aci onamentos necessri os ao uso de Frmul as.
NOTA: Ao uti l i zar um banco de dados MDB (Mi crosoft Access), i nteressante cri ar separadamente arqui vos especfi cos para as
Frmul as e para os Hi stri cos, de forma a evi tar que todos os dados se percam caso haja um probl ema com al gum arqui vo.
18.1 Exerccios
O objeto Frmul a armazenar i nformaes sobre as cores de ti ntas, formadas pel a combi nao de vermel ho, verde e azul .
18.1.1 Banco de Dados
1. Insi ra um novo Banco de Dados no TreinamentoE3 com o nome de FormulaDB.
2. No campo Arquivo MDB, l ocal i ze a pasta Trei namentoE3 e di gi te o texto "Formul a.mdb", sem as aspas.
18.1.2 Frmula
1. Insi ra um objeto Frmul a no TreinamentoE3.
Inserir Frmula
Frmulas 125
2. Di gi te no campo Banco de Dados o texto "Formul aDB", e no campo Tabela di gi te "Formul aTrei na".
Configurao do Banco de Dados da Frmula
3. Nomei e o objeto como Formula.
4. Na aba Templates, adi ci one trs novos Templ ates do ti po Integer: Vermelho, Verde e Azul. Para todos os Templ ates,
escol ha a restri o absol uta de 0 a 255.
Templates
5. Na aba Unidades, sel eci one uma l i nha qual quer da col una Unidade1 e cl i que em Renomear . Troque o nome da Uni dade
para Tanque1.
6. Cl i que em para adi ci onar uma nova Uni dade, Tanque2.
7. Busque, nas duas Uni dades, o cami nho de cada propri edade dos objetos Tanque1 e Tanque2 em Dados.
Configurao das Unidades
8. Na aba Valores, adi ci one mai s Conjuntos de Val ores, preenchendo as col unas com os val ores que preferi r.
Configurao dos Conjuntos de Valores
9. Para carregar os dados da Frmul a, i nsi ra um boto na Tel aSi noti co com a propri edade Caption i gual a "Carrega" e, no
evento Click, cri e um scri pt com o mtodo LoadFormulaDlg do Vi ewer.
Application.LoadFormulaDlg "Formula"
18.2 Exerccios Complementares
18.2.1 KB
KB-28508: Dados carregados de frmul as mostram val ores sem casa deci mal .
18.2.2 Lista de Seleo
Ao i nvs de uti l i zar o comando pronto para carregarmos os val ores da frmul a atravs de uma cai xa de di l ogo do Vi ewer,
possvel uti l i zar os mtodos do prpri o objeto Frmul a. Uma l i sta de sel eo ser preenchi da com todos os Conjuntos de
Val ores cadastrados e ao sel eci onar um del es, os val ores sero carregados. Para buscar no Banco de Dados todos os
Conjuntos de Val ores j cadastrados, ser preci so uti l i zar um objeto Consul ta.
1. Insi ra na TelaSinotico um objeto Consul ta.
2. Confi gure a Consulta1 para buscar a tabel a FormulaTreina_Values no Banco de Dados FormulaDB.
126 Frmulas
Selecionando a tabela de valores
3. Sel eci one apenas a col una Name e vi sual i ze a Consul ta. Todas as cores cadastradas devem aparecer.
4. Agora ser preenchi da uma l i sta de sel eo com os dados retornados pel a Consul ta.
5. Insi ra uma Li sta de Sel eo (Combo Box) , prxi ma ao Tanque1.
6. No evento OnStartRunning da Li sta de Sel eo, cri e o segui nte scri pt:
' Limpa a Lista de Seleo
Clear()
' Busca os dados da Consulta
Set RS = Screen.Item("Consulta1").GetADORecordset()
' Adiciona todos os registros encontrados na Lista de Seleo
For i = 1 To RS.RecordCount
AddItem RS.Fields("Name").Value
RS.MoveNext
Next
7. No evento Click da Li sta de Sel eo, cri e o segui nte scri pt:
Application.GetObject("Formula").LoadFormulaValuesQuiet "Tanque1", Value
Frmulas 127
18.3 Anotaes
128 Storage
19
Storage
CAPTULO
O Storage um mdul o hi stori ador do E3 desenvol vi do para aperfei oar o uso de bancos de dados, fazendo com que uma
determi nada i nformao seja armazenada ocupando o menor espao possvel .
Exi ste todo um conjunto de funci onal i dades especfi cas para este mdul o, como consul tas pr-construdas e al gori tmos de
compactao de dados, entre outros. 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.
O uso do Storage fortemente recomendado para processos onde o objeti vo do regi stro seja o acompanhamento de
tendnci as que necessi tem manter i nformaes essenci ai s ao processo. Atravs de um al gori tmo matemti co bastante
di fundi do, o Storage pode fornecer i nformaes rel evantes de um determi nado processo ocupando menos espao em di sco do
que os dados gravados por um Hi stri co gravado peri odi camente.
Em processos onde os dados devem ser preci sos, como medi es usadas para faturamento de i nsumos (gua, energi a ou gs),
ou processos onde os dados devem ser i ntegral i zados em um perodo, o uso de Hi stri cos convenci onai s o recomendado.
19.1 Funcionamento
A gravao no Storage fei ta da segui nte manei ra:
Aps a defi ni o da tabel a, os dados so gravados de acordo com as confi guraes. 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 num tempo menor do que o mni mo programado
Conforme forem sendo obti dos novos val ores para as vari vei s, um al gori tmo de veri fi cao de gravao vai i nterpretando a
sequnci a e deci di ndo se cada ponto ser ou no armazenado.
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 de qual i dade para que sejam gravados.
Para cada ti po de grandeza armazenada, gerado automati camente um conjunto de tabel as, um para os Tags anal gi cos,
outro para os textos e um tercei ro para os di gi tai s. Dessa forma, cada Storage pode gerenci ar at sete tabel as (backup), caso
se especi fi que que os trs ti pos de Tags devem ser armazenados:
<NomeTabela>_Fields
<NomeTabela>
<NomeTabela>_Text
<NomeTabela>_Bit
<NomeTabela>_Backup
<NomeTabela>_Text_Backup
<NomeTabela>_Dig_Backup
19.2 Configurao
Quando o Storage cri ado na Tel a, mostrada uma l i sta de defi ni es dos campos de gravao.
Storage
Para efei tos de posteri or consul ta nos dados, toda a busca se dar atravs do cami nho do Tag ou da propri edade que est
sendo armazenada (campo Fonte). A propri edade Nome s ser uti l i zada caso o campo Fonte contenha uma expresso. 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.
19.3 Consultas Internas
A ferramenta Query prev al gumas faci l i dades para real i zar consul tas nos dados do Storage. Ao confi gurar a consul ta, ao
i nvs de exi bi r as tabel as, h uma rvore com todas as vari vei s armazenadas.
Storage 129
Configurao da Consulta
O usuri o pode escol her uma entre sete funes descri tas a segui r para consol i dao dos dados.
19.3.1 LastValue
Retorna o l ti mo val or armazenado na Base de Dados.
19.3.2 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 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
ExactTime: val or armazenado no exato i nstante que foi forneci do pel o timestamp
19.3.3 TagAttribute
Retorna um atri buto do Tag, 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: l i mi te i nferi or
FieldHighEng: l i mi te superi or
FieldDeadBand: banda morta para gravao
FieldDeadBandUnit: uni dade da banda morta (absol uta ou percentagem)
FieldMinRecTime: tempo mni mo para gravao
FieldMaxRecTime: tempo mxi mo para gravao
130 Storage
19.3.4 CompressedDataNValues
Retorna, para um ni co Tag, n val ores armazenados a parti r de um i nstante i ni ci al .
19.3.5 CompressedDataStartEndTime
Retorna, para um ni co Tag, os val ores armazenados entre um i nterval o i ni ci al e um i nterval o fi nal .
19.3.6 SampledData
Retorna, para um ou mai s Tags, os val ores i nterpol ados (esti mados) a i nterval os fi xos entre os i nstantes defi ni dos pel as
vari vei s StartTime e EndTime.
19.3.7 CalculatedData
Retorna 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. Os ti pos de cl cul os so Total, Mnimo, Mximo, Desvio Padro, Amplitude, Mdia e Mediana.
19.4 Exerccios
Vamos cri ar doi s Storages que sero uti l i zados nos captul os segui ntes. O Storage com os dados de temperatura ser
vi sual i zado grafi camente e o Storage com os dados das bombas ser uti l i zado pel o Pl ayBack.
19.4.1 Temperatura
1. Insi ra um objeto Storage no projeto. Al tere o nome para StorageTemp.
Inserir Storage
2. No objeto StorageTemp, i nsi ra doi s campos e confi gure-os como na fi gura a segui r.
Configurao dos campos
3. Cl i que na opo Propriedades e confi gure as segui ntes opes.
Banco de dados: BancoDados
Tabela: Temperatura
4. Cl i que em Gerar Tabela. Deve aparecer a mensagem da fi gura a segui r.
Storage 131
Estrutura criada com sucesso
19.4.2 TagBomba
1. No XObject TagBomba i nsi ra um Storage. Chame de StorageBomba.
Inserir Storage
2. Adi ci one no StorageBomba as propri edades Automatico, Defeito e OnOff do objeto TagBomba. Confi gure-as como na
tabel a a segui r.
Campos do Storage
3. Cl i que em Propriedades e confi gure as segui ntes opes:
Banco de dados: BancoDados
Tabela: Bombas
NOTA: Quando o Storage est i nseri do em um XObject, a estrutura da tabel a ser gerada quando a apl i cao for executada.
19.5 Exerccios Complementares
132 Storage
19.5.1 KB
KB-31955: Storage funci onando apenas com hardkey de Studi o.
19.6 Anotaes
E3Playback 133
20
E3Playback
CAPTULO
O E3Playback um Acti veX que roda dentro do E3 Vi ewer ou do E3 WebVi 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 e mostra val ores, ani maes, estados e grfi cos de
acordo com as i nformaes exi stentes no banco de dados, no perodo de playback defi ni do.
NOTA: Em modo Demo (ou com uma l i cena de Studi o) o perodo permi ti do para playback se resume s l ti mas sei s horas de
dados armazenados no banco.
20.1 Interface de Usurio do E3Playback
A i nterface de usuri o do E3Pl ayback di vi di da em ci nco partes, mostradas nas sees segui ntes.
20.1.1 Barra de Ferramentas
Barra de Ferramentas do E3Playback
20.1.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
20.1.3 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. As Tel as so sempre
abertas no zoom Preencher. possvel navegar l i vremente entre as Tel as do apl i cati vo.
20.1.4 Lista de Eventos
A Lista de Eventos mostra a sequnci a cronol gi ca de eventos de playback (al terao no val or de um Tag ou estado de um
al arme), permi ti ndo a navegao evento a evento.
134 E3Playback
Lista de Eventos
20.1.5 Lista de Tags
A Lista de Tags mostra os Tags que esto sendo uti l i zados para playback.
Lista de Tags
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.
20.2 Restries e Comentrios
As Tel as funci onam como se esti vessem em um Vi ewer Read-Only. Isto garante que as operaes efetuadas no E3Pl ayback
no i ro perturbar o funci onamento do apl i cati vo em tempo real
No permi ti do acesso aos objetos do servi dor atravs do mtodo Application.GetObject. Os erros de scri pt ocorri dos
dentro do E3Pl ayback no geram uma mensagem de erro, so abortados si l enci osamente
O E3Pl ayback emul a um Vi ewer real . Pode-se testar a propri edade IsPlaybackMode
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
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
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
E3Playback 135
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
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
20.2.1 Storage
A col una Fonte no deve conter expresses, poi s el as no podero ser uti l i zadas no playback
20.2.2 Alarmes
Habi l i te ou confi gure o regi stro de al armes em di sco
Sel eci one os segui ntes campos para regi stro (obri gatri os):
EventTime (mai s EventTimeMS) ou EventTimeDbl
FullAlarmSourceName
ConditionActive
Acked
AckRequired
20.2.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.
recomendado o uso do Storage sempre que possvel . Segui r ao mxi mo as segui ntes recomendaes:
Confi gurar a propri edade UserTable para Fal se
Col ocar cada Tag em um campo separado (no uti l i zar expresses)
Cri ar um ndi ce para o campo E3TimeStamp
Uti l i zar tabel as com poucos campos e, se possvel , adi ci onar um ndi ce i ndi vi dual para cada campo (pri nci pal mente para
os campos com poucas vari aes)
Confi gurar a propri edade CompressedTable para True e uti l i zar a propri edade DeadBand no Hi stri co
20.3 Licenciamento
A El i pse fornece doi s pacotes para o E3 Pl ayback:
Pl ayback Bsi co
Pl ayback Avanado: Bsi co mai s as ferramentas de Gravao de Vdeo e Captura de Tel a
Os pacotes so di mensi onados conforme o nmero de pontos (Tags e Fontes de Al armes) armazenados no Banco de Dados. 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.
A l i cena de Studi o do E3 i ncl ui uma l i cena de Pl ayback 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. 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.
20.4 Exerccios
20.4.1 TelaPlayBack
1. Insi ra no projeto uma nova Tel a chamada TelaPlayBack, a ser aberta no Di vi sor _top.
2. Na TelaMenu, i nsi ra um boto para chamar a TelaPlayBack. No i tem Quadro, di gi te o nome de um Quadro i nexi stente
(por exempl o, "QuadroPl ayBack"), para que sejam abertas duas Tel as si mul taneamente.
136 E3Playback
20.4.2 Configurao
1. Na TelaPlayBack, i nsi ra o objeto E3Pl ayBack ocupando toda a Tel a.
2. Acesse suas propri edades e confi gure-as conforme a fi gura a segui r.
Propriedades do E3Playback
3. Execute a apl i cao.
20.4.3 Execuo
1. 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.
2. Uma l i nha com o i nterval o de dados exi stentes aparecer na Li nha do Tempo e a Janel a de Eventos ser preenchi da.
Linha de Tempo
3. Escol ha o evento que deseja i ni ci ar a reproduo e cl i que em Play.
20.5 Exerccios Complementares
20.5.1 Dados do Playback
1. Sal ve em Hi stri cos ou Storages todos os Tags que desejar vi sual i zar no E3Pl ayback.
E3Playback 137
20.6 Anotaes
138 Hot-Standby
21
Hot-Standby
CAPTULO
O Hot-Standby permi te a i mpl ementao do concei to de failover 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. Di z-se do
servi dor em espera que est em Standby.
Ao i ni ci ar a execuo do E3 que est confi gurado para o si stema Hot-Standby, ser mostrado na rea de Noti fi cao nos
servi dores 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 servi dor pri nci pal e i ndi ca a ao com um cone representado por uma seta verde
. Este cone determi na que o servi dor est em execuo. O servi dor Standby vai permanecer com o cone representado por duas
barras amarel as , i ndi cando que el e est em modo de espera (standby).
21.1 Configuraes do Hot-Standby
Esta seo contm as confi gurao para o funci onamento de servi dores E3 em modo Hot-Standby.
21.1.1 Arquivos
Os arqui vos do Domni o devem estar na mesma l ocal i zao no servi dor pri nci pal e no servi dor de backup. Por exempl o, se no
computador pri nci pal o Domni o e os demai s arqui vos (.l i b, .prj, etc.) esti verem no cami nho C:\Projeto1, no servi dor Standby o
projeto dever ser copi ado para este mesmo cami nho, ou seja, C:\Projeto1.
21.1.2 Servidores
Os servi dores (pri nci pal e backup) devem estar l i stados na aba Servidores das opes do Domni o.
1. Para acessar as confi guraes do Domni o, cl i que no cone do E3 Admi n na rea de Noti fi cao do Wi ndows e
sel eci one o menu Domnio - Opes.
Menu Domnio - Opes
2. Os servi dores podem ter o nome que se desejar no campo Nome do servidor. No campo Identificao do servidor na rede
i nforme o nome do computador na rede. Por exempl o, Nome do servidor como Servidor1 e Identificao do servidor na
rede como \\servidor1.
Hot-Standby 139
Aba Servidores
21.1.3 Opes de Configurao
Na aba Opes, o i tem Habilitar deve estar marcado e nos campos Servidor principal e Servidor de backup sel eci onados um dos
servi dores cadastrados previ amente na aba Servidores.
140 Hot-Standby
Aba Opes
Os i tens descri tos nas prxi mas sees tambm devem ser confi gurados.
21.1.4 Ping de Integridade
O Ping de Integridade uma tercei ra enti dade de rede (as outras so os servi dores pri nci pal e o de 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. Se o
servi dor Standby consegui r acessar a i ntegri dade e no consegui r acessar o servi dor Hot (pri nci pal ), el e entende que o Hot
est com probl emas e assume a execuo do Domni o.
21.1.5 Falha Local
Fal has l ocai s so detectadas e reportadas pel o prpri o apl i cati vo atravs do mtodo Application.ReportFailure. possvel
habi l i tar a troca automti ca de servi dores quando uma fal ha l ocal reportada no servi dor pri nci pal . A troca de servi dores s
fei ta se o servi dor de backup esti ver sem fal has.
21.1.6 Banco de Dados
Quando se trabal ha com bancos de dados e Hot-standby, tem-se basi camente duas opes de estrutura:
Ambas as apl i caes acessam uma mesma base de dados na rede. O servi dor Hot i r gravar os dados nesse Banco de
Dados
Exi stem doi s bancos de dados rodando l ocal mente, em ambos servi dores (pri nci pal e backup). Nesse caso, habi l i ta-se a
propri edade EnableSynchronization do objeto Banco de Dados, assi m todos os dados gravados na base de dados pri nci pal
so tambm atual i zados na base de dados em Standby
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 em
di sco l ocal mente, 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.
Hot-Standby 141
21.1.7 Retentive
A propri edade Retentive determi na se o val or deve ser armazenado no caso de troca do servi dor ati vo. Assi m, quando o
servi dor Standby for executado, o val or ser o mesmo do servi dor Hot que parou. Se esta propri edade esti ver em Fal se, o val or
ser ajustado para o val or i ni ci al sempre que o Domni o for executado ou ocorrer troca do servi dor ati vo.
21.2 Exerccios
21.2.1 Retentive
Para exempl i fi car a di ferena, vamos transformar os Tags de cor do Tanque1 (vermel ho, verde e azul ) em retenti vos e os Tags
do Tanque2 em no-retenti vos.
1. Sel eci one todos os Tags i nternos da pasta Tanque1 (vermel ho, verde e azul ) e al tere a propri edade Retentive para True.
21.2.2 Falha Local
1. Na pasta Dados, i nsi ra um Tag Interno chamado FalhaLocal.
2. Confi gure a propri edade Value para Fal se (Boolean).
3. No Tag FalhaLocal, cri e um evento de usuri o chamado Falha que s ocorre quando o val or do Tag verdadei ro.
Criar evento de usurio
4. No evento Falha, cri e o segui nte scri pt:
Application.ReportFailure "Falha", "Falha no servidor ativo", 1
Value = False
5. Busque, com o auxl i o do AppBrowser, o evento ReportFailure do Servi dor.
Application.ReportFailure(FailureName, FailureDescription, FailureWeight)
6. Al tere o parmetro FailureName para "Fal ha", FailureDescription para "Fal ha no servi dor ati vo" e FailureWeight para 1.
Application.ReportFailure "Falha", "Falha no servidor ativo", 1
7. Para o Tag retornar para o estado normal , di gi te na ul ti ma l i nha a expresso "Val ue = Fal se".
Value = False
8. Na TelaMenu, i nsi ra um boto com o texto "Fal ha Local ".
9. No boto, cri e um Pi ck Carregar Valor.
Pick Carregar Valor
10. Busque a propri edade Value do Tag FalhaLocal e escol ha o val or Bool eano True.
142 Hot-Standby
Valor do Tag FalhaLocal
21.2.3 Sincronismo do Banco de Dados
1. No objeto BancoDados al tere a propri edade EnableSynchronization para True.
21.2.4 Aplicao Standby
1. Copi e a pasta da apl i cao para o computador que ser o servi dor Standby.
2. No servi dor Standby, abra a apl i cao no E3 Studi o e confi gure o Banco de Dados para o SQL Server l ocal .
21.2.5 Configurao Hot-Standby
1. A parti r do computador Hot ou do Standby, cl i que no cone do E3 Admi n na rea de Noti fi cao do Wi ndows e
sel eci one o menu Domnio - Opes.
2. Na aba Servidores, adi ci one doi s servi dores i nformando o nome que desejar e o nome do computador na rede.
3. Na aba Opes, habi l i te o Hot-Standby e escol ha um servi dor como pri nci pal e outro como backup.
4. Informe como ping de i ntegri dade o IP de um tercei ro computador na rede.
5. Marque a opo Ativar backup em caso de falha local.
6. Execute a apl i cao e teste as funci onal i dades.
21.3 Exerccios Complementares
21.3.1 KB
Hot-Standby: Dvi das Mai s Frequentes (FAQ).
KB-26057: Comportamento do Vi ewer durante troca de servi dores.
Hot-Standby 143
21.4 Anotaes
144 Domnios Remotos
22
Domnios Remotos
CAPTULO
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 se desti na 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.
NOTA: Domni os Remotos no esto di sponvei s em modo Demo.
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 ou de l i nks. Para que a conexo entre os Domni os possa ocorrer, todos os E3 Servers envol vi dos devero
estar rodando a mesma verso do E3.
NOTA: 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.
22.1 Configurao no Studio
No E3 Studi o, para buscar os objetos exi stentes na apl i cao do Domni o Remoto, pode-se usar normal mente o AppBrowser,
desde de que o cami nho compl eto do arqui vo do Domni o tenha si do especi fi cado corretamente no servi dor remoto.
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.
22.2 Compartilhamento da Pasta do Domnio Servidor
No caso de Domni os Remotos, o E3 Server roda sempre como um servi o na conta SYSTEM. Servi os que usam a conta SYSTEM
i ni ci am no contexto do si stema sem credenci ai s, ou seja, sem autenti cao de usuri o e senha. Esses servi os, rodando sem
um domni o de rede Mi crosoft, e que quei ram acessar recursos da rede, tero acesso negado em funo de no terem
credenci ai s e de estarem uti l i zando uma sesso nul a.
22.2.1 Configuraes Gerais
As confi guraes mostradas a segui r devem ser fei tas na mqui na que roda o Domni o Servi dor.
1. Se a mqui na uti l i za Wi ndows 2000, 2003 ou Vi sta, acesse o pai nel de control e Ferramentas Administrativas
(Administrative Tools) - Diretiva de Segurana Local (Local Security Policy).
2. Na janel a segui nte, acesse Diretivas Locais (Local Policies) - Opes de Segurana (Security Options).
3. Desabi l i te a opo Acesso de rede: acesso annimo restrito a pipes nomeados e compartilhamentos (Network Access:
Restrict anonymous Access to Named Pipes and Shares).
Domnios Remotos 145
Opes de Segurana
Se a mqui na do Domni o Servi dor uti l i za Wi ndows XP, a confi gurao deve ser fei ta di retamente no Regi stro do Wi ndows.
Nesse caso, si ga esses procedi mentos.
1. Acesse a chave HKEY_LOCAL_MACHINE \ SYSTEM \ CurrentControlSet \ Services \ Lanmanserver \ parameters.
2. Cri e a vari vel RestrictNullSessAccess, do ti po DWORD, e col oque o val or 0.
Varivel RestrictNullSessAccess
A confi gurao atravs do Regi stro do Wi ndows tambm pode ser fei ta em Wi ndows 2000, 2003 e Vi sta. Segundo a Mi crosoft,
a chave RestrictNullSessAccess especi fi ca se o servi dor vai l i mi tar o acesso ao si stema por usuri os l ogados sem
autenti cao de nome de usuri o e senha. Os val ores possvei s so:
0: Acesso sem autenti cao permi ti do e todos os usuri os podem acessar os recursos comparti l hados
1: No permi te acesso sem autenti cao. Os usuri os sem autenti cao podero acessar apenas os di retri os l i stados na
vari vel NullSessionShares
146 Domnios Remotos
Em qual quer um desses casos, ser necessri o rei ni ci ar a mqui na para que as al teraes tenham efei to. Al m di sso,
necessri o confi gurar o comparti l hamento e o NTFS para acei tarem o acesso do usuri o anni mo (ANONYMOUS LOGON/
LOGON ANNIMO) ou do usuri o de rede (NETWORK/REDE). Isso fei to da segui nte manei ra.
1. Sel eci one a pasta que contm o Domni o Servi dor, e que dever estar comparti l hada.
2. Cl i que com o boto di rei to do mouse sobre el a e sel eci one a opo Propriedades.
3. Na aba Compartilhamento, cl i que em Permisses.
Propriedades da pasta
4. Adi ci one o usuri o REDE ou o usuri o LOGON ANNIMO, permi ti ndo acesso para l ei tura pasta e cl i cando aps em OK.
Domnios Remotos 147
Adicionar usurio
5. Acesse a aba Segurana, e adi ci one novamente o usuri o REDE ou LOGON ANNIMO (o mesmo que foi adi ci onado na aba
Compartilhamento), cl i cando aps em OK.
Aba Segurana
148 Domnios Remotos
NOTA: Para que a comuni cao entre as mqui nas funci one corretamente em tempo de execuo, o firewall deve ser
confi gurado corretamente, ou desabi l i tado.
22.2.2 Aba Segurana
Em al guns casos, tambm pode ocorrer de a aba Segurana no estar vi svel junto com a aba Compartilhamento, nas
propri edades da pasta. Isso ocorre porque em al gumas verses de Wi ndows, como o XP, por exempl o, rodando sem pertencer
a um domni o de rede Mi crosoft, o modo de comparti l hamento si mpl i fi cado habi l i tado por padro. Nesse caso, preci so
trocar o modo de comparti l hamento atravs da vari vel ForceGuest na chave de regi stro, em HKEY_LOCAL_MACHINE \
SYSTEM \ CurrentControlSet \ Control \ LSA. A vari vel deve ser ajustada para 0.
22.3 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.
22.4 Sintaxe dos Links
O acesso aos objetos de outro Domni o fei to atravs do apel i do (Nome do Domni o), que deve preceder o cami nho compl eto
de cada objeto, separado por doi s pontos. Por exempl o, 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. Por exempl o,
Driver1.Tag1 + Remoto:Driver2.Tag1 * 2.
22.5 Alias Local
O Alias Local uma ferramenta do El i pse E3 que garante que a apl i cao que ser servi dora de um Domni o Remoto seja
confi gurada da mel hor manei ra para promover a mi grao fci l , rpi da e confi vel de um projeto para a apl i cao remota.
Essa ferramenta permi te a cri ao de um Domni o Remoto na apl i cao l ocal que aponte para si mesmo, ou seja, aponte para
o prpri o Domni o e para a prpri a mqui na.
Alias local
Ao se confi gurar a apl i cao, deve-se associ ar todos os objetos de Tel a e scri pts atravs do Domni o Remoto adi ci onado.
Domnios Remotos 149
Associao atravs do Domnio Remoto
Assi m, os links de todos os objetos de Tel a fi cam di reci onados para os Tags e objetos de dados da apl i cao l ocal , porm vi a
Domni o Remoto.
22.6 Permisses de Acesso
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. 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. 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.
22.7 Exerccios
22.7.1 TelaRemota
1. Insi ra no projeto uma nova Tel a chamada TelaRemota, a ser aberta no Di vi sor Area_Central. Marque a Tel a para ser a
Tel a i ni ci al do di vi sor.
2. Na TelaMenu, i nsi ra um boto para chamar a TelaRemota.
22.7.2 Compartilhamento
1. Comparti l he a pasta do projeto e faa as confi guraes de permi sso conforme a seo Compartilhamento da Pasta do
Domnio Servidor.
22.7.3 Alias Local
1. Acesse as opes do Domni o atravs do cone do E3 Admi n na rea de Noti fi cao do Wi ndows.
2. Na aba Domnios Remotos, i nsi ra um Domni o e confi gure as segui ntes propri edades:
Nome do Domnio: Domi ni o_Local
Arquivo de Domnio: Arqui vo .dom em desenvol vi mento
Servidor principal: nome do computador atual na rede
150 Domnios Remotos
Configurao do Domnio
3. Cl i que no boto Aplicar e fi nal i ze a confi gurao cl i cando em OK.
4. Veri fi que no Organi zer se aparece o projeto do Domni o confi gurado.
Projetos de Domnios Remotos
5. Na TelaRemoto, cri e um Di spl ay para exi bi r os val ores de um Tag qual quer. Busque, no AppBrowser, o Tag dentro do
Domni o Remoto Dominio_Local.
Domnios Remotos 151
Tag no Domnio Remoto
22.7.4 Domnio Remoto
1. Acesse as opes do Domni o atravs do cone do E3 Admi n na rea de Noti fi cao do Wi ndows.
2. Na aba Domnios Remotos, i nsi ra um Domni o e confi gure as segui ntes propri edades:
Nome do Domnio: Remoto1
Arquivo de Domnio: cami nho do arqui vo do Domni o Remoto. Este cami nho deve ser um comparti l hamento na rede que
permi ta acessar esse arqui vo ou uma cpi a l ocal
Servidor principal: nome do computador remoto na rede
152 Domnios Remotos
Aba Domnios Remotos
3. Cl i que no boto Aplicar (Apply) e fi nal i ze a confi gurao cl i cando em OK.
4. Veri fi que no Organi zer o Domni o Remoto e seus projetos.
Projetos dos Domnios Remotos
5. Na TelaRemoto, cri e um Di spl ay para exi bi r os val ores de um Domni o Remoto. Busque, no AppBrowser, um Tag dentro do
Domni o Remoto Remoto1.
Domnios Remotos 153
Tag no Domnio Remoto
6. Cri e um Di spl ay ou Setpoi nt para cada Tag que desejar e associ e-os atravs do cami nho de Domni o Remoto.
TelaRemoto
7. Cadastre quantos Domni os Remotos desejar.
22.8 Exerccios Complementares
22.8.1 KB
KB-26842: Uni fi cando confi guraes de usuri os em vri os Domni os.
154 Domnios Remotos
22.9 Anotaes
Exerccios de Reviso 155
23
Exerccios de Reviso
CAPTULO
Esta seo contm exercci os de revi so de todo o contedo do Tutori al .
23.1 Exerccio
Uma mi neradora deseja moni torar os nvei s de al guns tanques. O equi pamento ai nda no est deci di do, mas deve trazer a
i nformao de quatro nvei s.
O gerente do setor gostari a de vi sual i zar os dados de forma ami gvel ao usuri o, por i sso pedi u que fosse desenvol vi do um
supervi sri o com os segui ntes requi si tos:
Si mul ar os val ores dos quatro nvei s do equi pamento em fal ta (val ores de 0 a 100)
A Tel a pri nci pal deve ter uma i magem da mi nerao
Imagem da minerao
Sobre cada tanque vi sual i zar o nvel atravs de uma barra
Nvel do tanque
Exi bi r o val or do nvel na tel a formatada com sua uni dade de engenhari a i gual a "%", uma casa deci mal e obedecendo a
tabel a de cores a segui r
156 Exerccios de Reviso
Valores de cores para os nveis
MNIMO MXIMO COR
90 100 Vermel ho
70 90 Amarel o
30 70 Branco
10 30 Azul
0 10 Verde
Si nal i zar na tel a os al armes de todos os nvei s conforme a tabel a a segui r
Limites de alarmes
ALARME LIMITE
HiHi 90
Hi 70
Lo 30
LoLo 10
Na tel a pri nci pal deve ser possvel i denti fi car o usuri o l ogado
Um usuri o pertencente ao grupo Manuteno NO pode reconhecer al armes
Em uma segunda tel a, deve ser possvel vi sual i zar os quatro nvei s em um grfi co onde possvel escol her atravs de botes
qual a i nformao exi bi r si mul taneamente
Grfico de nveis
Armazenar os dados de nvel a cada 2 segundos em um banco de dados
Vi sual i zar os dados armazenados no banco de dados em forma de tabel a na mesma tel a do grfi co
Um rel atri o com os dados de nvel armazenados no banco de dados deve ser exportado para PDF
Exerccios de Reviso 157
23.2 Resoluo
Si mul ar os val ores dos quatro nvei s do equi pamento em fal ta (val ores de 0 a 100)
1. Para si mul ar val ores, cri ar Tags do ti po Demo, com os l i mi tes mxi mo e mni mo conforme especi fi cado.
Tags Demo
A Tel a pri nci pal deve ter uma i magem da mi nerao
1. Inseri r a fi gura como Recurso.
2. Al terar a propri edade FillStyle da Tel a para 12 - bkPicture.
3. Informar o nome da fi gura na propri edade PictureFile da Tel a.
Sobre cada tanque vi sual i zar o nvel atravs de uma barra
1. Inseri r um Retngul o na Tel a sobre o tanque.
2. Acessar as propri edades do Retngul o, aba Associao.
3. Cri ar uma Associ ao na propri edade VerticalPercentFill com o Tag Nivel correspondente.
Propriedade VerticalPercentFill
Exi bi r o val or do Tag Nivel na Tel a formatada com sua uni dade de engenhari a i gual a "%", uma casa deci mal e obedecendo
tabel a de cores
1. Como sero di versos Di spl ays i guai s, a mel hor opo cri ar um XControl .
2. Cri e um arqui vo de bi bl i oteca e i nsi ra-o no Domni o.
3. Insi ra um XControl e chame-o de DisplayNivel.
Objeto DisplayNivel
4. Cri e uma propri edade chamada Nivel do ti po Double.
Propriedade Nivel
5. Desenhe um Di spl ay.
6. Formate o Di spl ay com a expresso '0.0 "%"'.
7. Cri e uma Associ ao Si mpl es com a propri edade Nivel cri ada na propri edade Value do Di spl ay.
Propriedade Value
8. Cri e uma Associ ao por Tabel a na propri edade ForegroundColor i nformando os l i mi tes e as cores desejadas. Na
propri edade Fonte, busque a propri edade Nivel cri ada anteri ormente.
158 Exerccios de Reviso
Propriedade ForegroundColor
9. Sal ve e regi stre-a.
10. Insi ra na Tel a um XControl chamado DisplayNivel.
11. Cri e uma Associ ao Si mpl es na propri edade Nivel com o Tag desejado.
Propriedade Nivel
Si nal i zar na Tel a os al armes de todos os nvei s, conforme a tabel a
1. Se no exi sti r no Domni o, i nsi ra no projeto um Servi dor de Al armes.
2. Se no exi sti r, i nsi ra no projeto uma Confi gurao de Al armes.
Configurao de Alarmes
3. Na Confi gurao de Al armes, i nsi ra uma rea de Al arme.
4. Na rea de Al arme, i nsi ra um Al arme Anal gi co.
Alarme Analgico
5. Acesse as propri edades da Fonte de Al arme, aba Analgico. Informe os l i mi tes e mensagens de al armes conforme a tabel a.
Aba Analgico
6. Na col una Fonte, busque o Tag que deseja moni torar o al arme.
7. Insi ra quantos al armes forem necessri os e confi gure-os segui ndo os passos anteri ores.
Exerccios de Reviso 159
Alarmes
Na Tel a pri nci pal deve ser possvel i denti fi car o usuri o l ogado
1. Cri ar um Di spl ay na Tel a.
2. Cri ar uma Associ ao na propri edade Value do Di spl ay com a propri edade User do Vi ewer.
3. Insi ra um boto ao l ado do Di spl ay.
Boto de Login
4. No boto, cri e o scri pt a segui r.
Application.Login(True)
5. Acessar o menu Arquivo - Usurios e cri ar pel o menos um usuri o.
Menu Usurios
Um usuri o pertencente ao grupo Manuteno NO pode reconhecer al armes
1. Acessar o menu Arquivo - Usurios.
2. Cri ar o grupo Manuteno.
3. Inseri r um usuri o no grupo Manuteno.
4. Na aba Permisses, bl oquear o reconheci mento de al armes para o grupo Manuteno.
Aba Permisses
Em uma segunda Tel a, deve ser possvel vi sual i zar os quatro nvei s em um grfi co onde possvel escol her atravs de
botes qual a i nformao exi bi r si mul taneamente
160 Exerccios de Reviso
1. Cri ar uma nova Tel a.
2. Inseri r um E3Chart na Tel a.
3. Acessar as propri edades do grfi co, aba Penas.
4. Inseri r uma Pena.
5. Escol her um Nome e uma Cor.
6. Na aba Dados, manter a Pena como Tempo Real e buscar o Tag no campo Link do eixo vertical.
7. Repeti r os passos anteri ores para i ncl ui r as demai s Penas.
Incluso de Penas
8. Na Tel a pri nci pal , cri ar um boto para chamar a Tel a do grfi co.
Armazenar os dados de nvel a cada 2 segundos em um banco de dados
1. Se no exi sti r, i nsi ra um objeto Banco de Dados e confi gure-o.
2. Ini sra um objeto Hi stri co no projeto.
3. Cri e campos para cada i nformao que deseja armazenar e associ e-os ao Tag desejado na col una Fonte.
Campos do Histrico
4. Acesse as propri edades do Hi stri co e confi gure o nome do Banco de Dados, nome da tabel a (Tabel aNi vel ) e tempo de
gravao (2000 ms).
Aba Histrico
Vi sual i zar os dados armazenados no banco de dados em forma de tabel a na mesma tel a do grfi co
1. Insi ra na Tel a um objeto E3Browser.
2. Acesse suas propri edades, aba Consulta e cl i que em Configurar.
Aba Consulta
3. Confi gure a Consul ta para buscar no Banco de Dados a tabel a cri ada.
Exerccios de Reviso 161
4. Escol ha os campos que deseja buscar e na aba Visualizar, cl i que em para veri fi car os dados.
Aba Visualizar
Um rel atri o com os dados de nvel armazenados no banco de dados deve ser exportado para PDF
1. Inseri r um Rel atri o no projeto, chamado de RelatorioNivel.
2. Confi gurar a Consul ta do Rel atri o para buscar no Banco de Dados a tabel a desejada.
Configurar Consulta
3. Escol her os campos de Nivel e E3TimeStamp.
4. Inseri r na seo Detail um objeto Campo de Dados para cada col una escol hi da na Consul ta. Preencher a propri edade
DataField com o nome da col una.
Seo Detail
5. Uti l i zar o objeto Label para escrever o ttul o das col unas (propri edade Caption).
6. Inseri r na tel a um boto com o segui nte scri pt:
Set Report = Application.LoadReport("[RelatorioCaldeira]")
Report.Export "PDF", "RelatorioNivel.pdf"
162 Exerccios de Reviso
23.3 Anotaes
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
Av. 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

You might also like