E3tutorial PDF

Copyright 2014 Elipse Software Ltda. Todos os direitos reservados. Verso 4.
5 (23/01/2014)
Tutorial do E3 para Iniciantes
Sumrio
..................................................................................................................................................................... 5 1 Apresentao
............................................................................................................................................................... 5 1.1 A Elipse
............................................................................................................................................................... 5 1.2 Mdulos do E3
............................................................................................................................................................... 5 1.3 O Treinamento
............................................................................................................................................................... 8 1.4 Anotaes
..................................................................................................................................................................... 9 2 Elipse Knowledgebase
............................................................................................................................................................... 9 2.1 Elipse Knowledgebase
............................................................................................................................................................... 9 2.2 Busca no Knowledgebase
............................................................................................................................................................... 10 2.3 Categorias
............................................................................................................................................................... 12 2.4 Anotaes
..................................................................................................................................................................... 13 3 Iniciando a Aplicao
............................................................................................................................................................... 13 3.1 Criando sua Aplicao
............................................................................................................................................................... 16 3.2 Execuo de um Domnio
............................................................................................................................................................... 16 3.3 Exerccios
............................................................................................................................................................... 20 3.4 Exerccios Complementares
............................................................................................................................................................... 21 3.5 Anotaes
..................................................................................................................................................................... 22 4 Telas e Objetos de Tela
............................................................................................................................................................... 22 4.1 Tela
............................................................................................................................................................... 23 4.2 Controles Microsoft Forms
............................................................................................................................................................... 23 4.3 Galeria
............................................................................................................................................................... 24 4.4 Exerccios
............................................................................................................................................................... 31 4.6 Anotaes
..................................................................................................................................................................... 32 5 Introduo aos Scripts
............................................................................................................................................................... 32 5.1 Definindo Scripts
............................................................................................................................................................... 37 5.2 Eventos
............................................................................................................................................................... 38 5.3 Mtodos
............................................................................................................................................................... 39 5.4 Propriedades
............................................................................................................................................................... 39 5.5 Exerccios
............................................................................................................................................................... 41 5.6 Anotaes
..................................................................................................................................................................... 42 6 Simulao de Valores
............................................................................................................................................................... 42 6.1 Servidor de Dados
............................................................................................................................................................... 42 6.2 Regras para Nomes de Tags
............................................................................................................................................................... 42 6.3 Exerccios
............................................................................................................................................................... 46 6.4 Anotaes
..................................................................................................................................................................... 47 7 Associaes
............................................................................................................................................................... 47 7.1 Tipos de Associaes
............................................................................................................................................................... 50 7.2 Edio de Associaes
............................................................................................................................................................... 51 7.3 Valores Booleanos
............................................................................................................................................................... 51 7.4 Exerccios
............................................................................................................................................................... 56 7.5 Anotaes
..................................................................................................................................................................... 57 8 Grficos e E3Chart
............................................................................................................................................................... 57 8.1 Configuraes das Penas
............................................................................................................................................................... 58 8.2 Exerccios
............................................................................................................................................................... 63 8.4 Anotaes
..................................................................................................................................................................... 64 9 Estrutura de Telas e Quadros
............................................................................................................................................................... 64 9.1 Viewer
............................................................................................................................................................... 66 9.2 Exerccios
............................................................................................................................................................... 71 9.3 Anotaes
..................................................................................................................................................................... 72 10 Segurana
............................................................................................................................................................... 72 10.1 Usurios
............................................................................................................................................................... 72 10.2 Grupos
............................................................................................................................................................... 73 10.3 Permisses
............................................................................................................................................................... 74 10.4 Proteo
............................................................................................................................................................... 75 10.5 Exerccios
............................................................................................................................................................... 78 10.6 Anotaes
..................................................................................................................................................................... 79 11 Comunicao
............................................................................................................................................................... 79 11.1 Elipse Modbus Simulator
............................................................................................................................................................... 80 11.2 Driver de Comunicao
............................................................................................................................................................... 81 11.3 Driver de Comunicao OPC
............................................................................................................................................................... 82 11.4 Exerccios
............................................................................................................................................................... 91 11.6 Anotaes
..................................................................................................................................................................... 92 12 Bibliotecas ElipseX
............................................................................................................................................................... 92 12.1 Criao de Bibliotecas do Usurio
............................................................................................................................................................... 95 12.2 Quando Criar um ElipseX
............................................................................................................................................................... 95 12.3 Exerccios
............................................................................................................................................................... 107 12.4 Anotaes
..................................................................................................................................................................... 108 13 Alarmes
............................................................................................................................................................... 108 13.1 Servidor de Alarmes
............................................................................................................................................................... 108 13.2 Configurao de Alarmes
............................................................................................................................................................... 111 13.3 E3Alarm
............................................................................................................................................................... 112 13.4 Exerccios
............................................................................................................................................................... 116 13.5 Anotaes
..................................................................................................................................................................... 117 14 Armazenamento de Dados
............................................................................................................................................................... 117 14.1 Banco de Dados
............................................................................................................................................................... 117 14.2 Histricos
............................................................................................................................................................... 118 14.3 Exerccios
............................................................................................................................................................... 123 14.5 Anotaes
..................................................................................................................................................................... 124 15 Consultas
............................................................................................................................................................... 124 15.1 Criando uma Consulta
............................................................................................................................................................... 125 15.2 E3Browser
............................................................................................................................................................... 126 15.3 Exerccios
............................................................................................................................................................... 130 15.4 Anotaes
..................................................................................................................................................................... 131 16 Relatrios
............................................................................................................................................................... 132 16.1 Objetos do Relatrio
............................................................................................................................................................... 133 16.2 Exerccios
............................................................................................................................................................... 138 16.3 Anotaes
..................................................................................................................................................................... 139 17 Exerccios de Reviso
............................................................................................................................................................... 139 17.1 Exerccio
............................................................................................................................................................... 141 17.2 Resoluo
............................................................................................................................................................... 149 17.3 Anotaes
Apresentao 5
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 esta poca,
foram i nstal adas mi l hares de cpi as deste 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, mi l hares de l i cenas deste 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, Wi ndows XP x64 SP2, Wi ndows Server 2003 SP2, Wi ndows
Vi sta SP2, Wi ndows Server 2008 SP2, Wi ndows Server 2008 R2 SP1, Wi ndows 7 SP1, Wi ndows 8, Wi ndows 8.1, Wi ndows
Server 2012 e Wi ndows Server 2012 R2.
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, Wi ndows 2003, Wi ndows Vi sta, Wi ndows 7, Wi ndows 8 e Wi ndows 8.1) 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 e
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 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.
6 Apresentao
A base do rotei ro deste manual uma apl i cao hi potti ca, que apresenta os recursos mai s i mportantes do software E3. Essa
apl i cao hi potti ca 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.
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 aprendi zado da
ferramenta.
O si stema em questo apresenta um si nti co de uma usi na de acar, exempl i fi cando vri os aspectos e recursos di sponvei s
no El i pse E3. O si stema moni tora a presso, vazo e vapor da cal dei ra, assi m como o nvel e trs temperaturas do processo. O
operador do si stema pode vi sual i zar as temperaturas e i nformaes da cal dei ra e control ar o funci onamento do motor.
Sintico de uma usina de acar
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) al m de cri ar grfi cos de tendnci a das vari vei s.
Condies de alarme
Na Tel a de cri stal i zao possvel envi ar comandos aos equi pamentos de campo.
Apresentao 7
Tela de cristalizao
Fi nal mente, 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.
Visualizao e impresso de dados histricos
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 deste 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 E3!
8 Apresentao
1.4 Anotaes
Elipse Knowledgebase 9
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.
10 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 11
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
12 Elipse Knowledgebase
2.4 Anotaes
Iniciando a Aplicao 13
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 abri r o
E3 Studi o. Quando o E3 i ni ci ado, abre-se 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 sua Aplicao
Para cri ar uma nova apl i cao, uti l i ze o Assistente de Aplicaes. Para abri -l o, cl i que em Novo na barra de ferramentas
Padro.
14 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 que 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. Estas 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 desta 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
Li sta de arqui vos *.prj e *.l i b
Confi guraes dos servi dores que i ro rodar o Domni o
Confi guraes de segurana (usuri os e permi sses)
Sem este arqui vo, um projeto no pode ser executado no E3. Este 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 apl i cao, ajudando na edi o e confi gurao de todos os
objetos envol vi dos na apl i cao atravs de uma rvore hi errqui ca de opes. Possui doi s modos de vi sual i zao, Domnio e
Explorer.
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 cri e uma Associ ao (que ser vi sta adi ante). A Li sta de Propri edades pode ser aberta pel o
menu Visualizar - Lista de Propriedades ou cl i cando em na Barra de Ferramentas.
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 as
segui ntes opes 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/Parar o E3 Viewer: Executa ou para a execuo do Vi ewer
3.3 Exerccios
3.3.1 Domnio
1. Ini ci e o E3 Studi o sel eci onando a opo Criar um Domnio novo.
Criar Novo Domnio
2. O Assi stente de Apl i caes aberto.
Assistente de Aplicaes
3. 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.
Aplicao Padro
4. Ajuste o cami nho da apl i cao para C:\Trei namentoE3 e cl i que em Avanar.
5. Na prxi ma janel a do Assi stente, sel eci one a opo Criar um novo Domnio e use o mesmo nome do projeto.
Criar novo Domnio
6. Sel eci one a resol uo das tel as da apl i cao e cl i que em Avanar.
Resoluo do Viewer
7. Responda No pergunta Voc deseja comunicar com um dispositivo/equipamento?. Este tema ser trabal hado em um
captul o posteri or.
Driver de Comunicao
8. Responda Sim pergunta Voc quer guardar dados em disco?. O nome do arqui vo de banco de dados sel eci onado
automati camente para o mesmo di retri o do projeto.
Banco de Dados
9. Responda Sim pergunta Voc deseja monitorar alarmes em sua aplicao?. Sel eci one a opo Desejo guardar os dados
dos alarmes em disco.
Alarmes
10. Cl i que em Concluir para gerar a apl i cao.
Concluso
11. Ao fi nal destes procedi mentos, tem-se acesso rea de trabal ho do E3 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
3.5 Anotaes
22 Telas e Objetos de Tela
4
Telas e Objetos de Tela
CAPTULO
Telas so janel as para moni toramento de processos, onde so i nseri dos objetos que fazem 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.
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
posi ci onado dentro da rea especi fi cada.
4.1 Tela
A Tela o objeto bsi co de i nterface com o usuri o. Nel a pode-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 e 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 s), compostas de quai squer objetos descri tos anteri ormente
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 l argura.
rea de edio da Tela
Telas e Objetos de Tela 23
4.2 Controles Microsoft Forms
Os objetos Acti veX 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 tabel a segui r contm a descri o dos objetos Mi crosoft Forms
di sponvei s no E3.
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.
4.3 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.
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 est di sponvel .
4.4 Exerccios
4.4.1 TelaInicial
A TelaInicial ser a pri mei ra Tel a a ser exi bi da ao executar o projeto.
TelaInicial
4.4.1.1 Cor de Fundo
1. Na Li sta de Propri edades, sel eci one a cor de sua prefernci a na propri edade BackgroundColor.
Propriedade BackgroundColor
2. Se preferi r apl i car um esti l o de preenchi mento Tel a, cl i que em Estilo de Preenchimento na barra de ferramentas
Desenho.
4.4.1.2 Texto
1. Na barra de ferramentas Objetos, sel eci one o objeto Texto e cl i que na posi o em que deseja escrever na Tel a. Quando
aparecer o cursor, di gi te o texto "Trei namento El i pse Software" e tecl e ENTER.
2. Sel eci one o objeto Texto e formate-o uti l i zando a barra de ferramentas Formatao.
Formatao
4.4.2 Figuras Externas
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 sel eci one o i tem Inserir Recurso em - TreinamentoE3.prj.
Inserir Recurso
2. Escol ha todos as fi guras da pasta C:\Trei namentoE3\Fi guras.
3. Na Gal eri a, sel eci one o grupo Recursos de Projetos. Arraste a i magem E3Logo para a Tel a.
4. Para executar a apl i cao, cl i que em Executar Aplicativo na barra de ferramentas Padro.
4.4.3 Inserir Nova Tela
1. Cl i que com o boto di rei to do mouse na pasta Tel as e sel eci one a opo Inserir Tela em - TreinamentoE3.prj.
Inserir Tela
2. Na janel a de confi gurao da nova Tel a, di gi te "Tel aCal dei ra" no campo Nome.
Configurar nova Tela
4.4.4 TelaCaldeira
Vamos trabal har a Tel a pri nci pal da apl i cao.
TelaCaldeira
Imagem de fundo
1. Confi gure a propri edade FillStyle para 12 - Picture, de forma a habi l i tar uma fi gura de fundo.
2. Para col ocar a fi gura FundoCal dei ra 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.
Imagem da Galeria
1. A parti r da bi bl i oteca de objetos grfi cos (Gal eri a), arraste a pri mei ra fi gura (cami nho) da pasta Vehi cl es e posi ci one-a
no canto i nferi or di rei to da Tel a.
Caminho
2. Na pasta Motors da Gal eri a, arraste a pri mei ra fi gura (3DISAMotor1) para o canto di rei to da Tel a.
3. Como a fi gura uma i magem da Gal eri a, para al terar a cor deve-se pri mei ro al terar a propri edade OverrideFillMode para
2 - SolidFill. Escol ha a cor que desejar na propri edade OverrideFillColor.
Propriedade OverrideFillColor
4.4.4.1 Retngulo
1. Desenhe um retngul o sobre um dos tanques.
Retngulo
2. Para si mul ar o preenchi mento por um l qui do, al tere a propri edade VerticalPercentFill para 20. O retngul o ser
preenchi do apenas 20%.
3. A cor de fundo do retngul o confi gurada na propri edade BackgroundColor. Al tere-a para ci nza.
4. A cor de preenchi mento confi gurada na propri edade ForegroundColor. Al tere-a para a cor de sua prefernci a.
4.4.4.2 Display
1. Cri e um objeto Texto com a propri edade Value i gual a "Presso", outro com a propri edade Value i gual a "Vapor" e um
tercei ro com a propri edade Value i gual a "Vazo", sobre o tanque da di rei ta.
2. Abai xo de cada objeto Texto, i nsi ra um objeto Di spl ay . Este objeto exi be o val or real das i nformaes.
Display
3. Para exi bi r um val or i ni ci al no Di spl ay, sel eci one o objeto e l ocal i ze a propri edade Value. Cl i que em e sel eci one o ti po
de i nformao, que neste caso um nmero com casas deci mai s (Double).
Propriedade Value do Display
4. Na propri edade Value aparece o val or 0 (zero). Di gi te o nmero que desejar como val or i ni ci al do Di spl ay.
5. Para formatar a uni dade de engenhari a, sel eci one a propri edade Format. Na janel a de formao de dados, sel eci one a
categori a que desejar.
6. Se preferi r cri ar uma formatao, sel eci one a categori a Outro e di gi te o formato no campo Tipo. Uti l i ze o nmero 0 (zero)
para representar os al gari smos e um texto entre aspas dupl as para representar o sufi xo ou prefi xo.
Formatao do Display
4.4.5 TelaEventos
1. Insi ra uma nova Tel a com o nome de "Tel aEventos".
2. Confi gure a Tel a com o fundo que desejar, cl i cando em Estilo de Preenchimento.
4.5.1 KB
KB-36216: Inseri ndo objetos na Gal eri a do E3
4.6 Anotaes
32 Introduo aos Scripts
5
Introduo aos Scripts
CAPTULO
Os Scripts so trechos de cdi go (programao) com os quai s se podem 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).
5.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 Acti veX Control s, Automati on Servers e Java Appl ets. 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).
5.1.1 Obtendo Referncias a Objetos
Uma das caractersti cas mai s i mportantes ao se trabal har com scri pts dentro do E3 consi derar a separao exi stente entre
os processos que so executados no Servi dor e aquel es executados na i nterface do cl i ente (Vi ewer). Para se trabal har com
scri pts, pode-se mani pul ar:
Objetos do servi dor atravs do Servi dor
Objetos do Servi dor atravs do(s) Vi ewer(s)
Objetos do Vi ewer atravs do mesmo Vi ewer
No entanto, no se pode mani pul ar di retamente:
Objetos do Vi ewer atravs do Servi dor di retamente (s possvel atravs da cri ao de eventos no Vi ewer, l i gados a
vari vei s que esto no Servi dor)
Objetos de um Vi ewer a parti r de outro Vi ewer (s possvel atravs da cri ao de eventos l i gados a vari vei s que esto no
Servi dor)
Tai s l i mi taes so decorrentes do fato de que, por defi ni o, exi ste uma i ndependnci a entre o que cada uma das estaes
Vi ewer est fazendo ou vi sual i zando com rel ao ao Servi dor e vi ce-versa. Por i sso todas as ati vi dades, tanto no Servi dor
quanto no Vi ewer, necessi tam ser coordenadas de forma assncrona ou atravs de eventos para operarem de forma
harmoni osa.
Devi do a essa i ndependnci a, ao se cri ar um scri pt, pri mei ro deve-se obter uma refernci a correta dos objetos que se deseja
mani pul ar, ou seja, necessri o que o objeto seja pri mei ramente encontrado nos vri os mdul os do E3.
Val e repeti r que, ao se edi tar um scri pt, o usuri o dever uti l i zar o AppBrowser, que permi te copi ar para o scri pt o cami nho de
um mtodo ou propri edade de forma compl eta, auxi l i ando-o na cri ao de scri pts.
Por exempl o, para se mani pul ar o val or de um Tag de Comuni cao, o cami nho Servidor - Driver - Pasta (se houver) - Tag. J
se o objeti vo for mani pul ar um boto na Tel a, o cami nho Viewer - Frame (se houver) - Tela - Boto.
Exi stem basi camente trs l ocal i zaes de ori gem de scri pts, do ponto de vi sta da metodol ogi a para acesso aos objetos:
Servi dor (E3 Server)
Introduo aos Scripts 33
Tel as e Quadros (E3 Vi ewer)
El i pseX (bi bl i otecas): podem ser XObjects (rodam no servi dor) e XControl s (rodam no Vi ewer)
Cada uma del as trata de forma di ferente o acesso aos dados que um scri pt deve l i dar. A ni ca ferramenta ti l para todos
estes acessos o App Browser.
5.1.2 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 es de val ores, que so bastante comuns na cri ao de um
projeto.
5.1.2.1 Executar Scripts
Permi te a edi o de um scri pt personal i zado que executado na ocorrnci a do evento determi nado.
Pick Executar Scripts
5.1.2.2 Abrir Tela
Abre uma Tel a ou um Quadro determi nado.
Pick Abrir Tela
5.1.2.3 Abrir Tela Modal
Abre uma Tel a em esti l o modal .
Pick Abrir Tela Modal
5.1.2.4 Executar Aplicao
Executa um programa especfi co.
Pick Executar Aplicao
5.1.2.5 Carregar Valor
Carrega um val or em um Tag.
Pick Carregar Valor
5.1.2.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.
Pick Inverter Valor
5.1.2.7 Imprimir Relatrio
Permi te i mpri mi r um Rel atri o na Tel a ou na i mpressora.
Pick Imprimir Relatrio
5.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.
Eventos disponveis
5.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 um 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 cl i cando em Criar evento do usurio .
Criar evento do usurio
5.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
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.
Mtodos no AppBrowser
5.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 os mesmos procedi mentos do
tpico anterior, porm sel eci one a pasta Propriedades.
5.5 Exerccios
5.5.1 Pick Abrir Tela
A pri mei ra Tel a do projeto a TelaInicial. Para navegar para a TelaCaldeira, necessri o um boto que abra esta Tel a.
1. Na TelaInicial i nsi ra um objeto CommandButton. Na sua propri edade Caption, di gi te "Entrar".
2. Sel eci one o boto e cl i que na aba Scripts.
Selecionar aba Scripts
3. No evento Click, cri e um novo scri pt do ti po Abrir Tela.
Script do tipo Abrir Tela
4. Sel eci one a TelaCaldeira no campo Abrir a Tela.
Opo Abrir Tela
5.5.2 Pick Script
1. Insi ra um novo objeto CommandButton com o texto "Sai r".
2. No evento Click, cri e um novo Pi ck do ti po Script.
Evento do tipo Script
3. Com o auxl i o do AppBrowser , procure o mtodo Exit do Vi ewer e cl i que em Colar.
Application.Exit
4. Execute a apl i cao e teste as novas funci onal i dades.
5.6 Anotaes
42 Simulao de Valores
6
Simulao de Valores
CAPTULO
Mui tas vezes so necessri os val ores que si mul em os movi mentos. Normal mente estes val ores so reai s e vem de Tags de
Comuni cao, mas nos exercci os deste Tutori al usaremos Tags do ti po Demo. Si mul aremos os val ores de vazo, presso e
vapor.
6.1 Servidor de Dados
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 descri tos na tabel a segui nte.
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.
6.2 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
6.2.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
6.3 Exerccios
6.3.1 Simulao de Valores
Mui tas vezes so necessri os val ores que si mul em os movi mentos. Normal mente estes 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. No Organi zer, l ocal i ze a pasta Dados (Objetos de Servidor Objetos de Dados). Cl i que com o boto di rei to do mouse e
sel eci one o i tem Inserir Panel Tag Demo.
Simulao de Valores 43
Inserir Tag Demo
2. Na janel a de confi gurao, di gi te "1" no campo Quantidade e "Pressao" no campo Nome. Evi te usar acentos no nome do
Tag.
Configurao do Tag Demo
3. Insi ra mai s quatro Tags Demo nomeados como "Vapor", "Vazao", "Ni vel " e "Cami nhao".
Tags Demo
4. Na pasta Dados i nsi ra os Tags Demo com as segui ntes propri edades confi guradas:
Propriedades dos Tags Demo
NAME MINIMUM MAXIMUM TYPE
Pressao 0 450 0 - Random
Vazao 0 500 0 - Random
Vapor 0 100 0 - Random
Nivel 0 1000 1 - Si ne
Caminhao 0 100 4 - RampUp
6.3.2 Tag Interno
Quando se deseja armazenar um val or para uti l i z-l o futuramente, cri a-se um Tag Interno.
1. Na pasta Dados i nsi ra um Tag Interno chamado Motor.
Tag Interno
2. Confi gure a propri edade Value do Tag Motor para Boolean com val or i ni ci al False.
Simulao de Valores 45
Propriedade Value
6.4 Anotaes
Associaes 47
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 aes para estas propri edades.
Aba 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 este 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 este i tem ser mostrado como
um erro, at ser corri gi do ou excl udo com a opo Verificar Domnio.
7.1 Tipos de Associaes
Esta seo contm a descri o dos 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 modi fi cada.
Associao Simples
48 Associaes
7.1.2 Associao Bidirecional
Na Associao Bidirecional acontece o mesmo que na Associao Simples, porm caso tambm haja uma vari ao na
propri edade, seu val or 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 so mapeados para certos val ores no Destino, 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 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 49
Associao Analgica
7.1.5 Associao por Tabela
Na Associao por Tabela, pode-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 estas condi es.
Associao por Tabela
50 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
Na Associao Mltipla, cada l i nha da Associ ao permi te buscar o val or de uma fonte di ferente. A fonte ati va sel eci onada de
acordo com o val or fonte pri nci pal da Associ ao.
Associao Mltipla
7.2 Edio de Associaes
O E3 possui uma ferramenta para edi tar 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 esta ferramenta pode ser
fei to cl i cando-se com o boto di rei to do mouse em um ou mai s objetos e sel eci onando a opo Editar Associaes.
Associaes 51
Edio de Associaes
7.3 Valores Booleanos
Em VBScri pt, 0 (zero) consi derado como Fal so e qual quer val or di ferente de zero 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 dera as segui ntes si tuaes:
Valor do Tag para tipos Boolean
TAG VBSCRIPT
0 Fal so
1 Verdadei ro
Ao uti l i zar o comando NOT, consi dera as segui ntes si tuaes:
Valor do Tag com NOT
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 (zero). Caso deseje uti l i zar o comando NOT, pri mei ro converta o
val or do Tag para Boolean com o mtodo CBool.
Converso de Tags com CBool
TAG CBOOL(TAG) NOT CBOOL(TAG)
0 Fal so Verdadei ro
1 Verdadei ro Fal so
Uso do 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.
Uso da propriedade Bit00
7.4 Exerccios
7.4.1 Associao Simples
1. Na TelaCaldeira, sel eci one o Di spl ay que representa a presso. Cl i que com o boto di rei to do mouse e abra a janel a de
propri edades.
52 Associaes
Propriedades do Display
2. Na aba Associaes, propri edade Value, cl i que em na col una Fonte.
Propriedade Value
3. Na janel a do AppBrowser, l ocal i ze na l i stagem da esquerda o Tag Pressao (em Servidor - Dados) e cl i que em Colar.
Associaes 53
AppBrowser
4. A i nformao vai do Tag Pressao para o Di spl ay, l ogo a Associ ao do ti po Simples (Propriedade Fonte).
Associao Simples
5. Associ e os Di spl ays de Vazo e Vapor aos seus respecti vos Tags.
7.4.2 Associao por Tabela
1. No Di spl ay que exi be o val or do Tag Vapor na TelaCaldeira, deseja-se i ndi car que o vapor est fora da fai xa permi ti da
al terando-se a cor de fundo. Cri e uma Associ ao por Tabel a na propri edade ForegroundColor, conforme a fi gura a
segui r.
Propriedade ForegroundColor
54 Associaes
7.4.3 Associao Analgica
1. Deseja-se i ndi car o nvel do tanque com o preenchi mento de cor do Retngul o. O Tag Nivel pode vari ar de 0 a 1000,
enquanto que o preenchi mento do Retngul o vai apenas de 0 a 100%. Para fazer a converso, uti l i za-se uma Associ ao
Anal gi ca.
Associao Analgica
7.4.4 Associao Digital
1. Na TelaCaldeira, o motor deve al terar de cor conforme o val or do Tag Motor. Acesse as propri edades da fi gura Motor,
aba Associaes. Na propri edade OverrideFillColor sel eci one o Tag Interno Motor (em Servidor - Dados - Motor) e di rei ta
sel eci one a propri edade Value.
2. No ti po de Associ ao, sel eci one Associao Digital. Escol ha duas cores para si mbol i zar Li gado e Desl i gado. Se desejar,
habi l i te o pi sca.
Propriedade OverrideFillColor
7.4.5 Pick Inverter Valor
1. Na TelaCaldeira, ao cl i car no motor el e deve l i gar ou desl i gar. Sel eci one o motor e cl i que na aba Scripts.
2. Cri e um novo Pi ck do ti po Inverter Valor.
Pick Inverter Valor
3. Sel eci one a propri edade Value do Tag Motor (em Servidor Dados Motor) no campo Nome do tag.
4. Al tere os campos Valor 1 e Valor 2 para Boolean. Confi gure um del es como Verdadei ro e o outro como Fal so.
Valores para o Tag Motor
7.4.6 Animao
1. Sel eci one o objeto Caminhao 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.
Associaes 55
Animao com Translao
2. Cl i que com o boto di rei to do mouse na Ani mao e abra suas propri edades. Cri e uma Associ ao Si mpl es na
propri edade Value com o Tag Caminhao.
Associao Simples
3. Al tere as propri edades Enabled e EnabledSlider da Ani mao para Fal so.
56 Associaes
7.5 Anotaes
Grficos e E3Chart 57
8
Grficos e 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 este objeto na Tel a, cl i que com o boto di rei to do mouse e sel eci one a opo Inserir - E3Chart.
8.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. Nesta aba, cl i que em Adicionar para cri ar uma nova Pena no E3Chart.
58 Grficos e E3Chart
Aba Dados
8.1.1 Pena de Tempo Real
Para confi gurar uma Pena como de 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.
8.1.2 Pena 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.
8.1.3 Tempo Real e Histrica (Mista)
Para confi gurar uma pena como de 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.
8.2 Exerccios
8.2.1 Inserir Nova Tela
Inserir Tela
2. Na janel a de confi gurao da nova Tel a, di gi te "Tel aGrafi co" no campo Nome.
3. Na TelaCaldeira, i nsi ra um objeto Command Button. Na propri edade Caption di gi te "Grfi co". Este boto abre a
TelaGrafico.
4. Sel eci one o boto e cl i que na aba Scripts. No evento Click, cri e um novo scri pt do ti po Abrir Tela.
Pick Abrir Tela
5. Sel eci one a TelaGrafico no campo Abrir a tela.
8.2.2 E3Chart
1. Posi ci one um objeto E3Chart na TelaGrafico. Sel eci one o cone na barra de ferramentas ou cl i que com o boto
di rei to do mouse na Tel a e sel eci one a opo Inserir - E3Chart.
8.2.3 Penas
1. Abra a janel a de propri edades do E3Chart, sel eci one a aba Penas, cl i que em Adicionar e sel eci one o ti po Tempo Real.
Inserir Pena de Tempo Real
2. Troque o nome da Pena para Pressao.
Pena Pressao
3. Na col una Estilo, sel eci one a cor e o ti po da l i nha.
Estilo da Pena
4. Na opo Link do Eixo Vertical, sel eci one o Tag Pressao (em Servidor - Dados).
Link com o Tag Pressao
5. Repi ta os passos anteri ores para i ncl ui r as Penas Vazao e Vapor.
8.2.4 Escala
Os mai ores val ores so do Tag Vazao que vari a de 0 a 500, ento vamos al terar a escal a verti cal para exi bi r os val ores nesta
fai xa.
1. Na aba Eixos, sel eci one o i tem EixoVertical e cl i que em Configurar.
2. Na aba Escala, confi gure o campo Mnimo com o val or 0 (zero) e o campo Mximo com o val or 500.
Aba Escala
8.2.5 Legenda
1. Na aba Legenda, sel eci one a opo Mostrar legenda, tamanho 60, e adi ci one as col unas que preferi r.
Aba Legenda
2. Confi gure a col una Valor do tag X para mostrar o val or no formato "HH:mm:ss".
8.3.1 KB
KB-18257: Cri ando um grfi co com pontos di gi tai s
8.4 Anotaes
64 Estrutura de Telas e Quadros
9
Estrutura de Telas e Quadros
CAPTULO
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.
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 tem 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 este recurso, si ga estes procedi mentos:
1. Cl i que com o boto di rei to do mouse no i tem Visualizao - Viewers e Quadros do Organi zer e sel eci one a opo Inserir
Quadro em.
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 (Dividir
Horizontalmente ou Dividir Verticalmente).
Menu de diviso do Quadro
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.
Quadros divididos horizontalmente e verticalmente
9.1 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 o E3 Vi ewer executado, poi s as Tel as e bi tmaps so trazi dos do servi dor conforme a
Estrutura de Telas e Quadros 65
necessi dade, em tempo de execuo.
NOTA: S pode 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.
Aba Visualizador
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.
Aba Erros de Comunicao
NOTA: Tambm possvel i nseri r Tags no Vi ewer.
9.2 Exerccios
9.2.1 Quadros
1. Cl i que com o boto di rei to do mouse no i tem Visualizao - Viewer e Quadros do Organi zer e sel eci one a opo Inserir
Quadro em - TreinamentoE3.prj.
Inserir Quadro
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 a fi gura a segui r.
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 cl i que com o boto esquerdo do
mouse para fi xar a posi o da barra.
4. O tamanho do Di vi sor tambm pode ser al terado di retamente na propri edade SplitValue.
5. Sel eci one o Di vi sor superi or. Na propri edade SplitValue di gi te "100 px".
9.2.2 Telas
1. Cl i que com o boto di rei to do mouse sobre o i tem Visualizao - Telas do Organi zer e sel eci one a opo Inserir Tela em -
TreinamentoE3.prj.
Inserir Tela
2. Sel eci one o i tem Superior na opo Escolha o Divisor onde a Tela ser aberta. Isto faz com que a Tel a seja cri ada com o
tamanho exato deste Di vi sor. Sel eci one a opo Configurar como Tela inicial do Divisor e, no campo Nome, di gi te
"Tel aMenu".
TelaMenu
A TelaCaldeira e a TelaGrafico foram i ni ci al mente cri adas para ocupar toda a rea de vi sual i zao. Como agora el as
sero abertas na parte i nferi or, preci so rever o tamanho destas Tel as.
3. Na TelaCaldeira, cl i que com o boto di rei to do mouse e sel eci one a opo Ajustar ao Divisor.
Ajustar ao Divisor
4. Na janel a de confi gurao, sel eci one o i tem Inferior na opo Escolha o Divisor onde a Tela ser aberta. Sel eci one a opo
Configurar como Tela inicial do Divisor.
Configurando o tamanho da Tela
5. Ajuste a TelaGrafico para ter o mesmo tamanho do Di vi sor Inferi or.
9.2.3 Navegao em Telas
A pri mei ra Tel a da apl i cao ser a TelaInicial. Ao cl i car em Entrar, deve ser aberto o Quadro1 cri ado no exercci o
anteri or.
1. Na TelaInicial, al tere o scri pt do boto Entrar substi tui ndo a TelaCaldeira pel o Quadro1.
Script do boto Entrar
2. Na TelaMenu, i nsi ra um objeto CommandButton. Na sua propri edade Caption, di gi te "Cal dei ra".
Pick Abrir Tela
4. Sel eci one a TelaCaldeira no campo Abrir a tela e, no campo Quadro, sel eci one o i tem Inferior.
Abrir a TelaCaldeira
5. Cri e um segundo boto para abri r a TelaGrafico.
9.2.4 TelaMenu
1. Na TelaMenu, arraste o l ogoti po do E3 do grupo Recursos da Gal eri a.
2. No canto di rei to da Tel a, i nsi ra um Di spl ay .
3. Abra as propri edades do objeto e sel eci one a aba Formatao. Defi na o formato como Hora e, no i tem Tipo, sel eci one
"13:06:03". Esta formatao mostra as horas, os mi nutos e os segundos.
4. Para vi sual i zar a confi gurao fei ta no exercci o anteri or, sel eci one a propri edade Value do Di spl ay e escol ha a opo
Date.
Display
9.2.5 Horrio do Sistema
Para obter o horri o corrente do si stema necessri o cri ar um Tag Demo que acesse esta i nformao.
1. Na pasta Dados, i nsi ra um Tag Demo com o nome Relogio. Confi gure a propri edade Type deste Tag para 3 CurrentTime.
2. Na TelaMenu, abra as propri edades do Di spl ay confi gurado para exi bi r as horas e sel eci one a aba Associaes.
3. Na propri edade Value, busque na col una Fonte, com o auxl i o do AppBrowser, o Tag Demo Relogio (Servidor - Dados) e
cl i que em Colar.
4. Execute a apl i cao cl i cando em .
9.3 Anotaes
72 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 te 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 tm ou no acesso ao si stema.
Para uti l i zar este recurso, abra o menu Arquivo - Usurios e cl i que na aba Usurios.
Aba Usurios
IMPORTANTE: Aps confi gurar a segurana, somente os usuri os l i stados tm acesso apl i cao.
10.2 Grupos
A opo Grupos permi te que sejam cri ados grupos com caractersti cas que so 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, abra o menu Arquivo - Usurios e sel eci one a aba Grupos.
Segurana 73
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 a qual pertence. Desta forma, no l eva 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, usada a segui nte ordem de prefernci a: Negar Afi rmar Indi ferente.
74 Segurana
Aba Permisses
10.4 Proteo
O E3 possui uma ferramenta de proteo de projetos ou de bi bl i otecas. Atravs deste 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 este 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 Proteo.
Segurana 75
Proteo de arquivos
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. Este recurso uti l i zado para
evi tar que determi nada bi bl i oteca ou projeto seja al terado aci dental mente, ou que sejam copi ados procedi mentos de
conheci mento especfi co do desenvol vedor. O E3 fornece um control e sobre a edi o destes 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. Isto 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 este 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 sto garante que ser possvel 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 este recurso para i ni bi r ou permi ti r acesso
a Tel as, control es, al armes, etc.
76 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 Administrador e Operador.
3. Atravs da aba Usurio, cri e trs usuri os. Cui dado que mai scul as e mi nscul as fazem di ferena.
Adicionar usurio
4. Confi gure um usuri o para pertencer ao grupo Administrador e doi s para pertencerem ao grupo Operador.
10.5.2 Permisses
1. Na aba Permisses, sel eci one a opo Grupos. Bl oquei e a TelaGrafico para o grupo Operador.
2. Nas permi sses de usuri os, d permi sso para um dos usuri os do grupo Operador para acessar a TelaGrafico.
10.5.3 Login
1. Na TelaMenu, i nsi ra um novo CommandButton com o texto "Logi n". No evento Click, cri e um novo Pi ck do ti po Script.
2. Busque no AppBrowser o mtodo Login do Vi ewer e cl i que em Colar.
Application.Login(True)
Segurana 77
10.5.4 Nome do Usurio
1. Cri e um segundo Di spl ay na TelaMenu, para exi bi r o nome do usuri o l ogado na apl i cao.
2. Associ e a propri edade Value do Di spl ay do usuri o com a propri edade User do Vi ewer.
Associao da propriedade Value com a propriedade User
78 Segurana
10.6 Anotaes
Comunicao 79
11
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 Dri vers de
Comuni cao ou Servi dores OPC, de acordo com o ti po do equi pamento ou ti po de comuni cao necessri a. Os Dri vers de
Comuni cao e Servi dores OPC funci onam neste 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.
11.1 Elipse Modbus Simulator
O Elipse Modbus Simulator um gerador de val ores al eatri os para apl i caes compatvei s com o protocol o Modbus RTU.
Al m di sto, tambm permi te receber mensagens de escri ta fei tas por estas apl i caes. O programa pode ser bai xado no site da
El i pse.
Quando o Si mul ador i ni ci ado, abre-se a rea de trabal ho, mostrada na fi gura a segui r.
Janela principal do Elipse Modbus Simulator
As opes di sponvei s na janel a pri nci pal so as segui ntes:
Opes disponveis na janela principal do Elipse Modbus Simulator
OPO DESCRIO
PLCs Quantity Nmero de PLCs que sero si mul ados. NOTA: Na verso Demo
este campo tem um l i mi te de 10 PLCs.
Initial Port Porta base uti l i zada para a comuni cao.
Random Values Habi l i ta ou desabi l i ta a gerao al eatri a de val ores.
Interval (ms) I nterval o de vari ao dos val ores, em mi l i ssegundos.
Aps sel eci onar a quanti dade de PLCs e a porta i ni ci al , i ni ci e a si mul ao cl i cando em Start.
11.1.1 Quantidade de PLCs
O Si mul ador cri a os PLCs nas portas consecuti vas ao val or confi gurado no campo Initial Port. Por exempl o, ao confi gurar trs
PLCs a parti r da porta 20000, o pri mei ro PLC estar di sponvel na porta 20000, o segundo na porta 20001 e o tercei ro na porta
20002.
80 Comunicao
Quantidade de PLCs
NOTA: Os PLCs cri ados consecuti vamente ao val or confi gurado no campo Initial Port uti l i zam somente portas di sponvei s. No
exempl o anteri or, se a porta 20001 esti ver em uso por outra apl i cao, so cri ados PLCs nas portas 20000, 20002 e 20003.
11.1.2 Memrias
O Si mul ador prev 30 regi stros di gi tai s (Coils) e 20 regi stros anal gi cos (Registers). permi ti da a escri ta de val ores
di retamente no Si mul ador, atravs da col una Value dos grids respecti vos, quando a vari ao de val ores para o PLC esti ver
desl i gada.
Com a opo Random Values sel eci onada, so gerados val ores al eatri os em todas as memri as a cada doi s segundos,
conforme defi ni do no campo Interval. O endereo de cada PLC sempre 1 (Device ID).
11.1.2.1 Coils
Coils so memri as di gi tai s di sponvei s para l ei tura atravs da funo Modbus 01 (Read Coil Status) e escri ta atravs da
funo Modbus 05 (Force Single Coil).
11.1.2.2 Registers
Registers so memri as anal gi cas que vari am de 0 a 65535 (Word). Esto di sponvei s para l ei tura atravs da funo
Modbus 03 (Read Holding Registers) e para escri ta atravs da funo Modbus 06 (Preset Single Registers) ou da funo Modbus
16 (Preset Multiple Registers).
11.2 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 forneci dos pel a El i pse Software. Um manual forneci do juntamente com cada Dri ver, contendo i nformaes
i mportantes respei to da confi gurao de seus parmetros [P] e outras propri edades. Os ti pos de objetos de Dri ver
di sponvei s para comuni cao so descri tos na tabel a a segui r.
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.
Elementos 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).
Comunicao 81
11.3 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. Neste caso necessri o conhecer o ItemId de cada Tag.
Objetos disponveis no Servidor OPC
OBJETO DESCRIO
Pasta OPC
Defi ne 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 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 est sempre associ ado posi o
defi ni da por sua propri edade Index, correspondendo a uma
vari vel de i nteresse.
O E3 funci ona como servi dor OPC e tambm como cl i ente OPC. O procedi mento a segui r serve para mostrar como funci ona a
confi gurao do Dri ver OPC, j que semel hante para qual quer servi dor OPC que esteja sendo uti l i zado. O rotei ro est
descri to nos passos a segui r.
1. Cl i que com o boto di rei to do mouse na pasta Dri vers e OPC e sel eci one o i tem Inserir Driver de Comunicao OPC em -
TreinamentoE3.prj.
2. Cl i que com o boto di rei to do mouse no Dri ver OPC i nseri do, sel eci one a opo Propriedades e cl i que na aba OPC Driver.
3. Cl i que em Selecionar para abri r uma janel a com as opes de servi dores OPC na 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.
4. Ao vol tar janel a de propri edades do Dri ver OPC, cl i que em Ativar Comunicao. A parti r deste ponto, possvel veri fi car
a comuni cao com o servi dor cl i cando em Informaes.
5. O prxi mo passo para a confi gurao a i mportao de Tags. Feche a janel a de propri edades e cl i que com o boto
di rei to do mouse no Dri ver OPC cadastrado. Sel eci one a opo Importar Tags. Com i sto o Assi stente de Importao de Tags
do E3 aberto.
82 Comunicao
Importao de Tags OPC
6. 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, pri mei ro ajuste os fi l tros, sel eci one o i tem e arraste-o at o
Grupo OPC de desti no.
7. Depoi s de i mportar al guns Tags ou propri edades, veri fi que o funci onamento dos Tags i mportados.
8. 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
para qual quer servi dor que seja uti l i zado.
11.4 Exerccios
11.4.1 Driver de Comunicao
Para comuni car o El i pse Modbus Si mul ator com o E3 ser uti l i zado o arqui vo de Dri ver Modbus.dl l , di sponvel para downl oad
em www.elipse.com.br.
1. Cl i que com o boto di rei to do mouse na pasta Dri vers e OPC e sel eci one a opo Inserir Driver de Comunicao em
TreinamentoE3.prj.
Comunicao 83
Inserir Driver de Comunicao
2. Sel eci one o arqui vo do Dri ver (Modbus.dl l ) na cai xa de di l ogo para a sel eo de arqui vos. A janel a da fi gura a segui r
aberta para confi gurao do Dri ver.
Janela de configurao do Driver Modbus
3. Na aba Setup, confi gure o tempo que o Dri ver aguarda uma resposta do equi pamento no campo Timeout (por exempl o,
1000 ms). Sel eci one, na l i sta de opes da propri edade Physical Layer, a i nterface fsi ca Ethernet.
84 Comunicao
Aba Setup
4. Aps sel eci onar a i nterface fsi ca, todas as outras abas so desabi l i tadas, sendo necessri o apenas confi gurar a
i nterface escol hi da. Na aba Ethernet, di gi te o IP do computador que est executando o Si mul ador. Se o Si mul ador est no
mesmo computador do E3, di gi te "127.0.0.1".
Aba Ethernet
5. No campo Port, di gi te o nmero da porta de comuni cao. Por exempl o, di gi te "20002" para acessar o tercei ro CLP do
Si mul ador.
Comunicao 85
6. Na aba Modbus, sel eci one o protocol o RTU Mode no campo Modbus Mode e, no campo Data Address Model Offset,
sel eci one o i tem Data is address from 0, poi s o pri mei ro endereo do Si mul ador 0 (zero).
Aba Modbus
7. Na aba Operations, veri fi que o cdi go das operaes para l ei tura e escri ta que so necessri as para as l ei turas dos
regi stros do CLP:
Registers: Lei tura de val ores anal gi cos (Word) atravs da funo Modbus 03 (Read Holding Registers) e para escri ta
atravs das funes Modbus 06 (Preset Single Registers) ou Modbus 16 (Preset Multiple Registers). A operao 01 executa
a l ei tura Modbus 03 (Read) e escri ta Modbus 16 (Write) de val ores do ti po Word (Data).
Coils: Lei tura de val ores di gi tai s (Bit) atravs da funo Modbus 01 e escri ta atravs da funo Modbus 05 (Force Single
Coil). No exi ste na l i sta padro uma operao com estas confi guraes, portanto necessri o adi ci onar uma nova.
8. No l ado di rei to da aba Operations, cl i que em Add para cri ar a opo 08. Sel eci one a operao 01 na l i sta de opes do
campo Read e, no campo Write, a opo 05.
Adicionar operao
9. A l i sta de operaes di sponvei s a segui nte:
86 Comunicao
Lista de operaes
10. Estes cdi gos de operao so uti l i zados posteri ormente na confi gurao dos Tags de Comuni cao:
Coils: Cdi go de operao 08
Registers: Cdi go de operao 01
11. Aps concl ui r a confi gurao, cl i que em OK.
12. Caso preci se confi gurar novamente o Dri ver, cl i que com o boto di rei to do mouse no objeto Dri ver e sel eci one o i tem
Configurao.
Menu Configurao
11.4.2 Tag de Comunicao
1. Cl i que com o boto di rei to do mouse no objeto Dri ver e sel eci one a opo Inserir - Tag de Comunicao, ou cl i que em
Adicionar na barra de ferramentas do Dri ver.
Adicionar Tag de Comunicao
2. A janel a de confi gurao aberta. Informe a quanti dade e o nome do Tag de Comuni cao (por exempl o, "Estado1").
Comunicao 87
Configurao do Tag
3. Para confi gurar os Tags de Comuni cao, necessri o preencher as propri edades N1, N2, N3 e N4, conforme as
i nstrues do manual do Dri ver Modbus:
N1: Endereo do equi pamento escravo (CLP) na rede. Este endereo pode vari ar entre 1 e 255
N2: Cdi go da operao. Referenci a uma operao de l ei tura ou escri ta adi ci onada na janel a de confi guraes do
Dri ver
N3: Parmetro adi ci onal
N4: Endereo do Regi strador ou da vari vel no equi pamento escravo (CLP) que se deseja l er ou escrever
11.4.2.1 Digital
1. O pri mei ro Tag Di gi tal a i nformao de estado (aberto ou fechado) da Vl vul a 1. Cri e um Tag de Comuni cao com o
nome "Estado_V1".
2. Confi gure os parmetros N conforme as i nformaes a segui r:
N1: 1 (Endereo do CLP)
N2: 8 (Cdi go da operao, ou Coil)
N3: 0 (Parmetro adi ci onal )
N4: 1 (Endereo do regi strador)
3. Cl i que com o boto di rei to do mouse no objeto Dri ver e sel eci one o i tem Ativar Comunicao para testar as confi guraes,
ou cl i que em Ativar ou Desativar a Comunicao . Caso as confi guraes estejam corretas, a l i nha do Tag deve fi car na
cor azul .
4. Para organi zar os Tags, sel eci one o Dri ver e i nsi ra uma pasta chamada "Di gi tai s".
Adicionar Pasta
5. Na pasta Di gi tai s devem exi sti r os segui ntes Tags:
Endereo 1: Estado_V1
Endereo 5: Estado_Motor
Endereo 11: LocRem_V1
Endereo 15: LocRem_Motor
6. Aps a cri ao dos Tags, teste a comuni cao.
88 Comunicao
Ativar a Comunicao
11.4.2.2 Analgico
1. Insi ra uma nova pasta chamada "Anal ogi cas".
2. Na pasta Anal gi cas, cri e os Tags a segui r:
Endereo 1: Temperatura
Endereo 2: Vazao
3. Confi gure os parmetros N conforme as i nformaes a segui r:
N1: 1 (Endereo do CLP)
N2: 1 (Cdi go da operao, ou Register)
N3: 0 (Parmetro adi ci onal )
N4: 1 ou 2 (Endereo do regi strador)
4. Cl i que com o boto di rei to do mouse no objeto Dri ver e sel eci one o i tem Ativar Comunicao para testar as confi guraes,
ou cl i que em Ativar ou Desativar comunicao . Caso as confi guraes estejam corretas, a l i nha do Tag deve fi car na cor
azul .
11.4.2.3 Escala
O Si mul ador gera val ores anal gi cos entre 0 e 65535. Desejamos val ores em outra fai xa, por i sto vamos habi l i tar a funo de
escal a.
Valores para a funo de escala
ENDEREO NOME MNIMO UE MXIMO UE UE MNIMO I/O MXIMO I/O L/E
1 Temperatura 20 200 C 0 65535 L
2 Vazao 0 100 m/s 0 65535 L
1. Al tere as propri edades dos Tags Anal gi cos conforme a fi gura a segui r:
Configurao da escala
2. Teste a comuni cao. A col una Valor j exi be os val ores com a escal a apl i cada e a col una Valor (sem escala) apresenta os
val ores envi ados pel o equi pamento.
Comunicao 89
Testar a comunicao
11.4.3 Tela Cristalizao
Vamos cri ar a Tel a Cri stal i zao para exi bi r os val ores do El i pse Modbus Si mul ator.
TelaCristalizacao
2. Na janel a de confi gurao da nova Tel a, di gi te "Tel aCri stal i zacao" no campo Nome. Sel eci one o Di vi sor Inferior.
3. Na TelaCristalizacao, confi gure a propri edade FillStyle para 12 - Picture, para habi l i tar uma fi gura de fundo.
4. Para col ocar a fi gura FundoCri stal como fundo, arraste o bi tmap de Recursos para a propri edade PictureFile da Tel a.
Confi gure a propri edade PicturePosition para posi ci onar mel hor a i magem.
5. Na TelaMenu, i nsi ra um objeto CommandButton. Na sua propri edade Caption, di gi te "Cri stal i zao".
Pick Abrir Tela
7. Sel eci one a TelaCristalizacao no campo Abrir a tela e, no campo No Quadro, sel eci one o i tem Inferior.
11.4.4 Display
1. Na TelaCristalizacao, i nsi ra um Di spl ay confi gurado com uma casa deci mal e sufi xo "C". Associ e-o ao Tag Anal gi co
Temperatura.
2. Insi ra um Di spl ay confi gurado com uma casa deci mal e sufi xo "m/s" e associ e-o ao Tag Anal gi co Vazao.
90 Comunicao
11.5.1 KB
KB-14918: Contagem de Tags no Dri ver de Comuni cao
KB-25284: Trabal hando com escal as no Tag de Comuni cao
Comunicao 91
11.6 Anotaes
92 Bibliotecas ElipseX
12
Bibliotecas ElipseX
CAPTULO
O E3 possui ferramentas que permi tem transformar qual quer objeto ou conjunto de objetos de uma 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 El i pseX) 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
12.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. Abra o menu Arquivo, sel eci one o i tem Novo Projeto e cl i que em Avanar.
2. Na opo Informe o tipo de Aplicao, sel eci one Biblioteca de componentes do E3.
Bibliotecas ElipseX 93
Selecionar tipo de aplicao
3. Di gi te o nome da bi bl i oteca e a pasta onde 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, descri tos nos respecti vos captul os. Entre estes
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 e 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 haver 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.
12.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 um projeto. Pode-se cri ar um XControl cl i cando com o boto di rei to do mouse no arqui vo
*.l i b cri ado no Domni o (Organizer - Explorer) ou em Bibliotecas de Objetos - XControl, sel eci onando a opo Inserir - XControl.
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 podem ser associ adas a um Tag ou outra
propri edade qual quer quando o objeto esti ver em uso 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 descri tas a segui r.
Opes disponveis na aba Propriedades de um XControl
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.
Pblica 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 pbl i ca ou
no.
OPO DESCRIO
Persistente Determi na se a propri edade sal va no projeto ou no.
Retentiva
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.
Note que outros objetos de Dados (XObjects) podem ser decl arados como Ti pos. Isto 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 na Tel a ou XControl de desti no e
sel eci onando a opo Inserir.
A parti r deste momento, o XControl tem um nome dentro da Tel a, e entendi do como uma cpi a da defi ni o ori gi nal . Assi m,
deve-se defi ni r (se necessri o) os val ores ou as Associ aes que esta cpi a especfi ca tem no contexto que est sendo
uti l i zada.
12.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 no 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 XControls, ci tadas anteri ormente.
Al m das Propri edades, 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 cl i car na l i sta de sel eo Tipo da aba Propriedades e veri fi car a l i sta de ti pos di sponvei s.
Isto permi te que se possa defi ni r como uma bi bl i oteca um si stema compl exo de gerenci amento, que pode 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 no Servi dor de Dados e
sel eci onando a opo Inserir.
Mesmo que o arqui vo de bi bl i oteca possua vri os XControl s e XObjects, ao tentar i nseri r uma bi bl i oteca o E3 Studi o exi be
para as Tel as somente os XControl s, e para os Servi dores de Dados somente os XObjects.
12.2 Quando Criar um ElipseX
Exi stem al guns cri tri os para i ndi car a necessi dade da construo de objetos no El i pse E3:
Repetio no uso: Se um mesmo equi pamento ou processo 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. Isto comum no caso de i ntegradores de servi os ou fabri cantes de mqui nas
Uso de controladores: Um control ador de processo, cujo mapeamento de memri a fi xo, pode ser i mpl ementado com todas
as funci onal i dades di sponvei s. A fl exi bi l i dade di sponvel para a construo e uso dos objetos no E3 permi te que sejam
uti l i zadas posteri ormente apenas as vari vei s de i nteresse, desprezando-se as demai s
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 arqui vos.
12.3 Exerccios
Vamos desenvol ver uma vl vul a que contm as i nformaes de estado aberto ou fechado e l ocal ou remoto. Cada vl vul a
tambm possui o comando para al terar estes estados.
Vlvula
12.3.1 XControl Vlvula
1. No Organi zer, cl i que com o boto di rei to do mouse em XControls e sel eci one o i tem Inserir XControl em - <Nova
Biblioteca>.
2. Na janel a que se abre, sel eci one o mesmo di retri o do projeto TreinamentoE3 e, no campo Nome, di gi te o nome do novo
arqui vo, "Bi bl i otecaTrei namento".
Criar nova biblioteca
3. Local i ze no Organi zer o XControl1 cri ado e al tere seu nome para "Val vul a".
Mudana de nome do XControl
4. Na aba Design, desenhe o objeto Valvula. Insi ra a fi gura val v, adi ci onada como Recurso, textos e crcul os conforme a
i magem a segui r.
Aba Design
12.3.2 Propriedades e Associaes do XControl
Para o objeto Valvula poder receber i nformaes externamente, preci samos cri ar propri edades.
1. Sel eci one a aba Propriedades, na parte i nferi or da Tel a.
2. Cl i que em Adicionar e i nsi ra duas novas propri edades, mostradas na fi gura a segui r.
Adicionar propriedades
3. Sel eci one novamente a aba Design para associ ar as propri edades cri adas com a cor dos crcul os.
4. Abra a janel a de propri edades do pri mei ro crcul o e sel eci one a aba Associaes. Na propri edade ForegroundColor, cl i que
em para abri r o AppBrowser.
Propriedade ForegroundColor
5. Sel eci one o XControl Valvula e a segui r sua propri edade Estado. Cl i que em Colar.
Propriedade Estado da Vlvula
6. Al tere o ti po da conexo para Digital e escol ha duas cores para si mbol i zar Aberto (Li gado) e Fechado (Desl i gado).
Associao do tipo Digital
7. No segundo crcul o, cri e uma Associ ao da propri edade ForegroundColor com a propri edade Remoto do XControl
Valvula. Escol ha as cores para Remoto (Li gado) e Local (Desl i gado).
Associao do tipo Digital
8. Para o nome da vl vul a ser exi bi do no texto, cri e uma Associ ao da propri edade Value com a propri edade Name do
XControl Valvula.
Associao do nome da vlvula
9. Sal ve a bi bl i oteca.
10. Para que o objeto esteja di sponvel para uti l i zao, necessri o regi strar a bi bl i oteca. No Organi zer, cl i que com o boto
di rei to do mouse no i tem Bibliotecas de Objeto e sel eci one a opo Registrar bibliotecas carregadas.
Registrar bibliotecas registradas
12.3.3 Inserindo um XControl na Tela
1. Na TelaCristalizacao, i nsi ra quatro objetos do ti po Valvula. Na rea da Tel a, cl i que com o boto di rei to do mouse e
sel eci one o i tem Inserir - Valvula.
Inserir XControl em uma Tela
2. Outro mtodo de i nseri r um XControl em uma Tel a arrast-l o do grupo Bibliotecas na Gal eri a.
Grupo Bibliotecas da Galeria
NOTA: Aps i nseri r um XControl em uma Tel a, el e se comporta como um objeto de Tel a e pode ser copi ado, arrastado ou
redi mensi onado.
3. Para testar o funci onamento do objeto Valvula, al tere a propri edade Estado e Remoto na l i sta de propri edades. A cor
dos crcul os deve ser al terada conforme confi gurado na bi bl i oteca.
Funcionamento do objeto Valvula
12.3.4 Scripts no XControl
Ao cl i car no pri mei ro crcul o, seu estado deve ser al terado de Aberto para Fechado e vi ce-versa. O mesmo comportamento
deve acontecer com a i nformao de Remoto e Local.
1. No XControl Valvula, sel eci one o pri mei ro crcul o e cl i que na aba Scripts.
Estado da vlvula
2. Adi ci one um scri pt no evento Click. Na pri mei ra l i nha, di gi te um comentri o e, com o cursor posi ci onado na segunda
l i nha, cl i que em AppBrowser .
AppBrowser
3. No AppBrowser, sel eci one o XControl Valvula e di rei ta a propri edade Estado. Cl i que em Colar.
Selecionar propriedade no AppBrowser
4. Compl ete o scri pt di gi tando " = NOT " e busque novamente a propri edade Estado do objeto Valvula.
Completar script da vlvula
5. Repi ta a mesma l gi ca para cri ar um scri pt no evento Click do Circulo2 que i nverta o val or da propri edade Remoto do
objeto Valvula.
6. Sal ve e regi stre a bi bl i oteca.
12.3.5 Associando Tags a um XControl
Cada vl vul a possui as i nformaes de Estado e Remoto que so recebi das do equi pamento (CLP). No capi tul o Comunicao,
cri amos um Tag para cada i nformao das quatro vl vul as. Vamos agora associ ar os Tags de Comuni cao com a
representao grfi ca do XControl .
1. Na TelaCristalizacao, sel eci one o objeto Valvula1, abra suas propri edades e sel eci one a aba Associaes. Na
propri edade Estado, cl i que em e abra o AppBrowser.
Propriedade Estado
2. Local i ze o Tag de Comuni cao que contm a i nformao do estado do objeto Valvula1. O Tag est em Servidor - Driver -
Digitais - Estado_V1.
Tag de estado
3. Para l er e escrever a i nformao de estado, al tere a Associ ao para o ti po Bidirecional.
4. Cri e uma Associ ao Bi di reci onal da propri edade Remoto para o Tag LocRem_V1.
Tag local ou remoto
5. Cri e Associ aes em todas as vl vul as com seus respecti vos Tags de Comuni cao.
12.4 Anotaes
108 Alarmes
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 so tratados
Configurao de Alarmes: neste objeto que os al armes a ser 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 estes eventos para um Banco de Dados.
IMPORTANTE: Um Domni o pode ter somente um objeto deste ti po, e 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 so 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 este objeto no projeto, cl i que com o
boto di rei to do mouse sobre o i tem Objetos de Servidor - Banco de Dados no Organi zer e escol ha a opo Inserir -
Configurao de Alarmes.
13.2.1 rea
O objeto rea permi te agrupar um conjunto de Fontes de Al armes, bem como outras reas de Al arme. Isto 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 e sua severi dade, bem como a necessi dade ou no de
reconheci mento deste evento. Todas as Fontes de Al armes possuem as propri edades gerai s descri tas na tabel a a segui r.
Propriedades gerais das Fontes de Alarme
PROPRIEDADE DESCRIO
Texto da Mensagem o texto associ ado quel a condi o de al arme, que aparece
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,
esta mensagem 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 do Al arme. Os ti pos de Fontes de Al armes esto
descri tos nas sees segui ntes.
Alarmes 109
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: LOLO (mui to bai xo), LO (bai xo),
HI (al to) e HIHI (mui to al to).
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 (Setpoint).
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 taxa de vari ao usa seus val ores especi fi cados
em uni dades da vari vel por segundo.
110 Alarmes
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).
Alarme Digital
Alarmes 111
13.2.2.5 Discreto
Permi te moni torar uma vari vel pel a especi fi cao de ml ti pl as subcondi es.
Alarme Discreto
13.3 E3Alarm
O E3Alarm serve para o moni toramento dos al armes ati vos ou no reconheci dos no si stema. Atravs deste objeto, possvel
veri fi car o estado dos al armes no si stema, bem como reconhec-l os manual mente. Para uti l i zar este objeto, cl i que com o
boto di rei to do mouse na rea de trabal ho, e sel eci one a opo 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.
Aba Geral
112 Alarmes
13.4 Exerccios
13.4.1 Configurao de Alarmes
1. Caso no exi sta, i nsi ra no projeto TreinamentoE3 um objeto Confi gurao de Al armes.
Inserir Configurao de Alarmes
13.4.2 Alarme Analgico
1. Cri e uma nova rea de Al armes no objeto Confi gurao de Al armes, cl i cando em Adicionar e modi fi que seu nome para
Caldeira.
Inserir rea
2. Sel eci one a rea cri ada e cl i que em Adicionar. Insi ra uma Fonte de Al arme do ti po Analgico.
Inserir Fonte de Alarme Analgica
3. Renomei e o Al arme Anal gi co para Nivel.
4. Cl i que sobre a rea de edi o da Fonte de Nivel e, usando o AppBrowser, sel eci one a propri edade Value do Tag Nivel da
pasta Dados.
5. Abra as propri edades do Al arme Nivel, sel eci one a aba Analgico e confi gure-a conforme a fi gura a segui r.
Alarmes 113
Aba Analgico
13.4.3 Alarme Digital
1. Na rea Caldeira, i nsi ra um Al arme Di gi tal chamado Motor.
2. No campo Fonte, sel eci one o Tag Motor.
3. Abra as propri edades do Al arme Motor, sel eci one a aba Digital e di gi te a mensagem que desejar.
Aba Digital
13.4.4 Alarme Banda Morta
1. Na rea Caldeira, i nsi ra um Al arme de Banda Morta chamado Vapor.
2. No campo Fonte, sel eci one a propri edade Value do Tag Vapor.
Propriedade Value do Tag Vapor
3. Abra as propri edades do Al arme Vapor, sel eci one a aba Banda Morta e confi gure-a como mostrado na fi gura a segui r.
114 Alarmes
Propriedades do Alarme Vapor
13.4.5 Alarme Taxa de Variao
1. Na rea Caldeira, i nsi ra um Al arme Taxa de Vari ao chamado Vazao.
2. No campo Fonte, sel eci one a propri edade Value do Tag Vazao.
Propriedade Value do Tag Vazao
3. Abra as propri edades do Al arme Vazao, sel eci one a aba Taxa de Variao e confi gure-a como mostrado na fi gura a segui r.
Propriedades do Alarme Vazao
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 TelaCaldeira.
2. Nas propri edades do E3Al arm, aba Geral, i nforme o nome do Servi dor de Al armes.
Alarmes 115
Aba Geral do E3Alarm
3. A mesma confi gurao pode ser fei ta atravs da Li 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 do E3Alarm
4. Abra as propri edades do E3Al arm e, na aba Colunas, sel eci one os campos DataHora, Operador, Mensagem, Reconhecido e
Valor.
5. Na aba Cores, faa a confi gurao que desejar.
116 Alarmes
13.5 Anotaes
Armazenamento de Dados 117
14
Armazenamento de Dados
CAPTULO
Este captul o contm i nformaes sobre as opes de armazenamento de dados do E3: Bancos de Dados e Histricos.
14.1 Banco de Dados
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 este recurso, si ga estes procedi mentos:
1. Cl i que com o boto di rei to do mouse sobre o nome do projeto e sel eci one a opo Inserir - Banco de Dados.
2. No caso do banco de dados Access, di gi te 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 BD em branco. Conforme especi fi cado anteri ormente, este campo s uti l i zado caso o banco de
dados possua senha.
5. Cl i que em OK para fi nal i zar as confi guraes.
14.2 Histricos
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.
Pode-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 este recurso, cl i que com o boto di rei to do mouse no i tem Objetos do servidor - Banco de dados no modo Domni o
e sel eci one a opo Inserir Histrico em e, em segui da, o nome do projeto desejado.
Para cri ar a tabel a no Hi stri co, i mportante cri ar seus campos. Tai s campos podem ser cri ados ao cl i car em Adicionar .
Para remover al gum campo i ndesejado, cl i que em Remover .
Adicionar ou remover campos do Histrico
14.2.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
118 Armazenamento de Dados
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 seja capaz de atuar como chave pri mri a, pel o fato de
apresentar val ores repeti dos. Al m di sto, uma tabel a pode ter somente uma Chave Pri mri a, seja el a si mpl es ou composta. Ou
seja, no se podem defi ni r doi s ou mai s campos de uma tabel a para ser 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 chave pri mri a ni ca da
tabel a.
Ao escol her campos para uma 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-o ao cl i car em , ou cl i cando em para abri r a janel a de confi gurao.
14.2.1.1 ndices
Um ndice um campo ou um conjunto de campos que so previ amente ordenados pel o Banco de Dados, a fi m de mel horar a
performance das consul tas que uti l i zam este ndi ce. El es so uti l i zados para encontrar regi stros com um val or especfi co em
uma col una rapi damente. Sem um ndi ce, o Banco de Dados tem de i ni ci ar com o pri mei ro regi stro e depoi s l er os regi stros
atravs de toda a tabel a at que se encontre os regi stros rel evantes. Quanto mai or a tabel a, mai or 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.
Editor de ndices
14.3 Exerccios
14.3.1 Banco de Dados
Este banco de dados ser uti l i zado para armazenar todos os dados de Al armes e Hi stri cos dos projetos.
1. Caso no exi sta, i nsi ra um novo Banco de Dados no projeto TreinamentoE3.
Inserir Banco de Dados
2. Renomei e o banco de dados para BancoDados.
3. Sel eci one o ti po de banco de dados como 0 - stAccess.
4. No campo Arquivo MDB di gi te "C:\Trei namentoE3\Dados.mdb".
5. Teste a conexo com o banco de dados.
14.3.2 Servidor de Alarmes
1. Abra a janel a de propri edades do Servi dor de Al armes e, na aba Configurao, habi l i te a opo Guarde alarmes no banco
de dados.
2. Na opo Utilize o servidor de banco de dados, sel eci one BancoDados.
3. Habi l i te a opo Descarta dados da tabela principal e especi fi que os segui ntes val ores:
Mantenha os dados dos l ti mos 3 meses
A veri fi cao deve ocorrer a cada 1 ms
Configurao do Servidor de Alarmes
4. Cl i que em Campos e sel eci one os campos que desejar.
Seleo de campos
5. Por l ti mo, cl i que em Gerar Tabela. A mensagem a segui r exi bi da.
Tabela criada com sucesso
14.3.3 Histrico
1. Cl i que com o boto di rei to do mouse no Banco de Dados, no modo Domnio, e i nsi ra um novo Hi stri co no projeto
TreinamentoE3, nomeando-o como HistCaldeira.
Inserir Histrico
2. No Hi stri co cri ado, i nsi ra trs novos campos e confi gure-os conforme a fi gura a segui r.
Adicionar campos
3. Cl i que em Propriedades e, na aba Histrico, confi gure as segui ntes propri edades:
Banco de dados: BancoDados
Nome da Tabela: Cal dei ra
Gravar um novo registro a cada: 5000 ms
Aba Histrico
4. Cl i que em Gerar Tabela. A mensagem a segui r exi bi da.
Tabela criada com sucesso
14.4.1 KB
KB-29527: Quai s so os bancos de dados suportados pel o E3?
14.5 Anotaes
124 Consultas
15
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 esta 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 sendo 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 este 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 cri ado um objeto Rel atri o ou E3Browser, o objeto Consul ta adi ci onado a este automati camente. No
entanto, tambm pode-se 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.
15.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 busca os
dados.
Definir o Servidor de Banco de Dados
2. Aps ser defi ni do o Banco de Dados, uma nova janel a aparece 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 OK.
4. Na aba Campos so adi ci onados os campos a serem retornados pel a Consul ta, bem como defi ni dos fi l tros e ordenaes.
Consultas 125
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.
Configurao da Consulta
A janel a anteri or pode ser aberta ao cl i car com o boto di rei to do mouse sobre o objeto, sel eci onando a opo Configurar.
15.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 e atri bui r cores para cada col una, entre outras confi guraes. Este objeto uti l i zado para vi sual i zar os Hi stri cos,
Al armes ou qual quer tabel a exi stente no Banco de Dados.
E3Browser
Para uti l i zar este recurso, cl i que com o boto di rei to do mouse na Tel a e sel eci one a opo Inserir - E3Browser.
126 Consultas
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.
15.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.
15.3.1 Tela Eventos
2. Na janel a de confi gurao da nova Tel a, di gi te "Tel aEventos" no campo Nome e sel eci one o Di vi sor Inferior.
3. Insi ra um objeto CommandButton na TelaMenu. Na propri edade Caption, di gi te "Eventos".
Pick Abrir Tela
5. Sel eci one a TelaEventos no campo Abrir a tela e, no campo Quadro, sel eci one o i tem Inferior.
15.3.2 Alarmes Histricos
1. Insi ra um E3Browser na TelaEventos.
2. Para confi gurar os dados que o E3Browser mostra, cl i que duas vezes no E3Browser e sel eci one a aba Consulta.
3. Sel eci one a Consulta1 e cl i que em Configurar.
Consultas 127
Propriedades do E3Browser
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 armes.
6. Sel eci one todos os campos da tabel a Al armes.
Tabela Alarmes
7. Sel eci one 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 este passo, todos os campos l i stados na consul ta esto di sponvei s no E3Browser. Confi gure
cada campo com a cor, formatao e tamanho que desejar.
9. Na aba Opes do E3Browser, confi gure a atual i zao para ser fei ta a cada ci nco segundos.
128 Consultas
Aba Opes
15.3.3 Tela Histrico
2. Na janel a de confi gurao da nova Tel a, di gi te "Tel aHi stori co" no campo Nome e sel eci one o Di vi sor Inferior.
3. Insi ra um objeto CommandButton na TelaMenu. Na propri edade Caption, di gi te "Hi stri co".
Pick Abrir Tela
5. Sel eci one a TelaHistorico no campo Abrir a tela e, no campo Quadro, sel eci one o i tem Inferior.
15.3.4 Dados Histricos
1. Insi ra um E3Browser na TelaHistorico.
2. Para confi gurar os dados que o E3Browser mostra, cl i que duas vezes no E3Browser e sel eci one a aba Consulta.
3. Sel eci one a Consulta1 e cl i que em Configurar.
Propriedades do E3Browser
4. Sel eci one o Banco de Dados que contm a tabel a que se deseja consul tar.
5. Escol ha a tabel a Cal dei ra.
Consultas 129
6. Sel eci one os campos da tabel a que deseja vi sual i zar.
7. Sel eci one 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 este passo, todos os campos l i stados na Consul ta esto di sponvei s no E3Browser. Confi gure
cada campo com a cor, formatao e tamanho que desejar.
9. Na aba Opes do E3Browser, confi gure a atual i zao para ser fei ta a cada ci nco segundos.
Aba Opes
130 Consultas
15.4 Anotaes
Relatrios 131
16
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 no modo Domnio e sel eci one a
opo Inserir Relatrio em e o nome 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 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.
Relatrio
Um Rel atri o estruturado da segui nte forma:
Estrutura de um 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 esta
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.
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.
132 Relatrios
A barra de ferramentas Rel atri os 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 descri tos na tabel a a segui r.
Opes de configurao na barra de ferramentas Relatrios
CONE OPO DESCRIO
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 Confi guraes de Pgi na,
Confi guraes de I mpresso,
Confi guraes da Grade e Esti l o do
Rel atri o.
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
ocorre a ao.
16.1 Objetos do Relatrio
A ferramenta Rel atri o possui vri os objetos especfi cos, que podem ser uti l i zados atravs da barra de ferramentas
Relatrios.
Barra de ferramentas Relatrio
Os recursos di sponvei s na barra de ferramentas Relatrios esto descri tos na tabel a a segui r.
Recursos disponveis na barra de ferramentas Relatrios
CONE OPO DESCRIO
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, 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 deste objeto possvel associ ar
um campo da tabel a no Banco de Dados.
Este campo especi fi cado na
propri edade DataField.
Relatrios 133
CONE OPO DESCRIO
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. Este 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 onde so i nseri dos textos ou
grfi cos. As tabel as nos Rel atri os so
usadas para organi zar e apresentar
i nformaes. Pode-se tambm usar
tabel as para cri ar l ayouts 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 E3Chart.

Enviar para frente e 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, respecti vamente.
Carregar Arquivo RPX I mporta a confi gurao do Rel atri o de
um arqui vo externo.
Salvar Arquivo RPX Exporta a confi gurao do Rel atri o para
um arqui vo externo.
16.2 Exerccios
16.2.1 Relatrio
Neste exercci o, vamos construi r um rel atri o de al armes.
Objeto Relatrio
1. Insi ra um novo Rel atri o no projeto TreinamentoE3 chamado RelatorioAlarmes.
134 Relatrios
Inserir Relatrio
16.2.2 Consulta do Relatrio
1. Local i ze o objeto Consul ta que acompanha o Rel atri o. Cl i que com o boto di rei to do mouse no objeto e sel eci one a
opo Configurar.
Configurar Consulta
2. Confi gure a Consul ta do Rel atri o para buscar os campos da tabel a Al armes.
Relatrios 135
3. Aps a confi gurao, cl i que em OK.
16.2.3 Detail
1. Na seo Detail, i nsi ra um Campo de Dados para cada campo escol hi do na Consul ta. Nas propri edades DataField e
Text, di gi te exatamente o ttul o da col una confi gurada na Consul ta.
Seo Detail
2. Di mi nua a al tura da seo Detail para o tamanho prxi mo de uma l i nha de regi stro.
3. Para vi sual i zar o Rel atri o, cl i que em Gerar Relatrio na barra de ferramentas.
136 Relatrios
16.2.4 Page Header
A seo Page Header o cabeal ho da pgi na. El a aparece no topo de todas as pgi nas do Rel atri o. Normal mente contm o
ttul o das col unas e um l ogoti po da empresa.
1. Adi ci one doi s objetos Texto na seo Page Header. Na propri edade Caption do pri mei ro Texto, di gi te "El i pse Software
Ltda - Trei namento E3 Studi o", e na propri edade Caption do segundo Texto, di gi te "Rel atri o de Al armes".
2. 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.
Page Header
16.2.5 Numerao de Pgina
O uso dos campos de dados do Rel atri o do E3 bastante fl exvel , sendo confi gurado no prpri o Campo de Dados que a
funo deve executar. Por exempl o, para cri ar na seo Page Footer a i ndi cao "Pgi na 1 de 12", si ga estes procedi mentos:
1. Insi ra doi s Textos, "Pgi na" e "de".
2. 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
3. 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
16.2.6 Visualizar Relatrio
Para vi sual i zar o Rel atri o em tempo de execuo, si ga estes procedi mentos:
1. Insi ra um Boto de Comando com o texto "Rel atri o" no canto i nferi or da TelaEventos.
2. No evento Click, cri e um Pi ck do ti po Imprimir Relatrio .
3. No campo Imprimir Relatrio, sel eci one o RelatorioAlarmes.
4. Na opo Sada, sel eci one o i tem Tela.
Relatrios 137
Imprimir Relatrio
138 Relatrios
16.3 Anotaes
Exerccios de Reviso 139
17
Exerccios de Reviso
CAPTULO
Esta seo contm exercci os de revi so de todo o contedo do Tutori al .
17.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 sto 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 entre 0 e 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:
140 Exerccios de Reviso
Cores dos 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 dos 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 i nformao exi bi r si mul taneamente
Grfico de nveis
Armazenar os dados de nvel a cada doi s 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 o formato PDF
17.2 Resoluo
Si mul ar os val ores dos quatro nvei s do equi pamento em fal ta (val ores entre 0 e 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 cao.
Tags de tipo 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. Abri r a janel a de propri edades do Retngul o e sel eci onar a aba Associao.
3. Cri ar uma Associ ao entre a propri edade VerticalPercentFill e o Tag Nivel correspondente.
Associao com a propriedade VerticalPercentFill
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
1. Como so 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 mude o nome para "Di spl ayNi vel ".
DisplayNivel
4. Cri e uma propri edade com o nome "Ni vel ", 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 entre a propri edade Nivel e a propri edade Value do Di spl ay.
Associao com a propriedade Nivel
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, sel eci one a propri edade Nivel cri ada anteri ormente.
Associao por Tabela
9. Sal ve a bi bl i oteca e regi stre-a.
10. Insi ra na Tel a um XControl do ti po DisplayNivel.
11. Cri e uma Associ ao Si mpl es entre a propri edade Nivel e o Tag desejado.
Associao Simples
Si nal i zar na Tel a os al armes de todos os nvei s, conforme tabel a
1. Se no exi sti r no Domni o, i nsi ra um objeto Servi dor de Al armes.
2. Se no exi sti r no Domni o, i nsi ra um objeto Confi gurao de Al armes.
Servidor e 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. Abra a janel a de propri edades da Fonte de Al arme e sel eci one a aba Analgico. Informe os l i mi tes e mensagens de
al armes, conforme a tabel a.
Aba Analgico
6. Na col una Fonte, sel eci one 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.
Alarmes
Na Tel a pri nci pal deve ser possvel i denti fi car o usuri o l ogado
1. Cri e um Di spl ay na Tel a.
2. Cri e uma Associ ao Si mpl es entre a propri edade Value do Di spl ay e a propri edade User do Vi ewer.
3. Insi ra um boto ao l ado do Di spl ay.
Boto Login
4. No boto, cri e o scri pt a segui r.
Application.Login(True)
5. Sel eci one o menu Arquivo - Usurios e cri e pel o menos um usuri o.
Menu Arquivo - Usurios
Um usuri o pertencente ao grupo Manuteno NO pode reconhecer al armes
1. Sel eci one o menu Arquivo - Usurios.
2. Cri e o grupo Manuteno.
3. Insi ra um usuri o no grupo Manuteno.
4. Na aba Permisses, bl oquei e 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 i nformao exi bi r si mul taneamente
1. Cri e uma nova Tel a.
2. Insi ra um objeto E3Chart nesta Tel a.
3. Abra a janel a de propri edades do E3Chart e sel eci one a aba Penas.
4. Insi ra uma Pena.
5. Escol ha um nome e uma cor.
6. Na aba Dados, mantenha a Pena como Tempo Real e sel eci one o Tag no campo Link do Eixo Vertical.
7. Repi ta os passos anteri ores para i ncl ui r as demai s Penas.
Aba Penas
8. Na Tel a pri nci pal , cri e um boto para abri r a Tel a do grfi co.
Armazenar os dados de nvel a cada doi s 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. Insi ra um objeto Hi stri co no projeto.
3. Cri e campos para cada i nformao que deseja armazenar e associ e-os aos Tags desejados na col una Fonte.
Coluna Fonte
4. Abra a janel a de 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. Abra a janel a de propri edades, sel eci one a aba Consulta e cl i que em Configurar.
Configurar a Consulta
3. Confi gure a Consul ta para buscar no Banco de Dados a tabel a cri ada.
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 o formato PDF
1. Insi ra um Rel atri o no projeto, com o nome de "Rel atori oNi vel ".
2. Confi gure a Consul ta do Rel atri o para buscar no Banco de Dados a tabel a desejada.
Configurar Consulta
3. Escol ha os campos Nivel e E3TimeStamp.
4. Insi ra na seo Detail um objeto SetPoi nt para cada col una escol hi da na Consul ta. Preencha a propri edade DataField com
o nome da col una.
Seo Detail
5. Uti l i ze um objeto Label para escrever o ttul o das col unas (propri edade Caption).
6. Insi ra na Tel a um boto com o segui nte scri pt:
Set Report = Application.LoadReport("[RelatorioCaldeira]")
Report.Export "PDF", "RelatorioNivel.pdf"
17.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

E3tutorial PDF

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

E3tutorial PDF

Enviado por

Direitos autorais:

Formatos disponíveis

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

Você também pode gostar