e3tutorial Developer Ptb

Verso 4.6.162 (03/03/2015)

Tutorial do E3 para Desenvolvedores

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

ISumrio........................................................................................................................................................................ 11 Apresentao

.................................................................................................................................................................. 11.1 A Elipse

.................................................................................................................................................................. 11.2 Mdulos do E3

.................................................................................................................................................................. 11.3 O Treinamento ........................................................................................................................................................................ 52 Elipse Knowledgebase

.................................................................................................................................................................. 52.1 Elipse Knowledgebase

.................................................................................................................................................................. 52.2 Busca no Knowledgebase

.................................................................................................................................................................. 62.3 Categorias ........................................................................................................................................................................ 83 Iniciando a Aplicao

.................................................................................................................................................................. 83.1 Criando a Aplicao .................................................................................................................................................................. 113.2 Execuo de um Domnio .................................................................................................................................................................. 113.3 Exerccios .................................................................................................................................................................. 153.4 Exerccios Complementares

........................................................................................................................................................................ 164 Simulao de Valores .................................................................................................................................................................. 164.1 Regras para Nomes de Tags .................................................................................................................................................................. 164.2 Exerccios

........................................................................................................................................................................ 205 Estrutura de Telas e Quadros .................................................................................................................................................................. 215.1 Viewer .................................................................................................................................................................. 235.2 Exerccios .................................................................................................................................................................. 265.3 Exerccios Complementares

........................................................................................................................................................................ 296 Telas e Objetos de Tela .................................................................................................................................................................. 296.1 Tela .................................................................................................................................................................. 306.2 Controles Microsoft Forms .................................................................................................................................................................. 306.3 Galeria .................................................................................................................................................................. 316.4 Exerccios .................................................................................................................................................................. 356.5 Exerccios Complementares

........................................................................................................................................................................ 367 Associaes .................................................................................................................................................................. 367.1 Tipos de Associao .................................................................................................................................................................. 397.2 Edio de Associaes .................................................................................................................................................................. 407.3 Valores Booleanos .................................................................................................................................................................. 407.4 Exerccios

........................................................................................................................................................................ 448 Comunicao .................................................................................................................................................................. 448.1 Elipse Modbus Simulator .................................................................................................................................................................. 458.2 Driver de Comunicao .................................................................................................................................................................. 458.3 Driver de Comunicao OPC .................................................................................................................................................................. 468.4 Exerccios .................................................................................................................................................................. 548.5 Exerccios Complementares

........................................................................................................................................................................ 569 Introduo aos Scripts .................................................................................................................................................................. 569.1 Definindo Scripts .................................................................................................................................................................. 619.2 Eventos .................................................................................................................................................................. 629.3 Mtodos .................................................................................................................................................................. 629.4 Propriedades .................................................................................................................................................................. 629.5 Exerccios .................................................................................................................................................................. 649.6 Exerccios Complementares

........................................................................................................................................................................ 6510 Segurana e Usurios .................................................................................................................................................................. 6510.1 Usurios .................................................................................................................................................................. 6510.2 Grupos .................................................................................................................................................................. 6610.3 Permisses .................................................................................................................................................................. 6710.4 Proteo .................................................................................................................................................................. 6810.5 Exerccios .................................................................................................................................................................. 7310.6 Exerccios Complementares

II

........................................................................................................................................................................ 7511 Configurao de Alarmes .................................................................................................................................................................. 7511.1 Servidor de Alarmes .................................................................................................................................................................. 7511.2 Configurao de Alarmes .................................................................................................................................................................. 7811.3 E3Alarm .................................................................................................................................................................. 7911.4 Exerccios .................................................................................................................................................................. 8311.5 Exerccios Complementares

........................................................................................................................................................................ 8412 Bibliotecas ElipseX: XControls .................................................................................................................................................................. 8412.1 Criao de Bibliotecas do Usurio .................................................................................................................................................................. 8712.2 Exerccios

........................................................................................................................................................................ 9213 Bibliotecas ElipseX: XObjects .................................................................................................................................................................. 9213.1 Quando Criar um ElipseX .................................................................................................................................................................. 9213.2 Exerccios

........................................................................................................................................................................ 9714 Tela Indexada .................................................................................................................................................................. 9714.1 Arquitetura da Informao .................................................................................................................................................................. 9814.2 Exerccios .................................................................................................................................................................. 9914.3 Exerccios Complementares

........................................................................................................................................................................ 10015 Armazenamento de Dados .................................................................................................................................................................. 10015.1 Servidor de Alarmes .................................................................................................................................................................. 10015.2 Histricos .................................................................................................................................................................. 10015.3 Chave Primria .................................................................................................................................................................. 10115.4 ndices .................................................................................................................................................................. 10115.5 Exerccios .................................................................................................................................................................. 10815.6 Exerccios Complementares

........................................................................................................................................................................ 10916 Consultas .................................................................................................................................................................. 10916.1 Criando uma Consulta .................................................................................................................................................................. 11016.2 E3Browser .................................................................................................................................................................. 11116.3 Exerccios

........................................................................................................................................................................ 11417 Filtros na Consulta .................................................................................................................................................................. 11417.1 Criando e Acessando Variveis .................................................................................................................................................................. 11417.2 Exemplo de Filtros .................................................................................................................................................................. 11517.3 Exerccios .................................................................................................................................................................. 11917.4 Exerccios Complementares

........................................................................................................................................................................ 12018 Grficos e E3Chart .................................................................................................................................................................. 12018.1 Configuraes das Penas .................................................................................................................................................................. 12118.2 Exerccios

........................................................................................................................................................................ 12619 TrendExplorer .................................................................................................................................................................. 12619.1 Exerccios

........................................................................................................................................................................ 12920 Relatrios .................................................................................................................................................................. 13020.1 Objetos do Relatrio .................................................................................................................................................................. 13120.2 Exerccios

........................................................................................................................................................................ 13721 Frmulas .................................................................................................................................................................. 13721.1 Exerccios .................................................................................................................................................................. 13921.2 Exerccios Complementares

........................................................................................................................................................................ 14022 Storage .................................................................................................................................................................. 14022.1 Funcionamento .................................................................................................................................................................. 14022.2 Configurao .................................................................................................................................................................. 14122.3 Consultas Internas .................................................................................................................................................................. 14222.4 Exerccios .................................................................................................................................................................. 14422.5 Exerccios Complementares

........................................................................................................................................................................ 14623 Hot-Standby .................................................................................................................................................................. 14623.1 Arquitetura .................................................................................................................................................................. 14623.2 Configuraes do Hot-Standby

III

.................................................................................................................................................................. 14923.3 Exerccios

.................................................................................................................................................................. 15023.4 Exerccios Complementares ........................................................................................................................................................................ 15124 Domnios Remotos

.................................................................................................................................................................. 15124.1 Arquitetura

.................................................................................................................................................................. 15124.2 Configurao no Studio

.................................................................................................................................................................. 15124.3 Compartilhamento da Pasta do Domnio Servidor

.................................................................................................................................................................. 15524.4 Licenas

.................................................................................................................................................................. 15524.5 Sintaxe dos Links

.................................................................................................................................................................. 15524.6 Alias Local

.................................................................................................................................................................. 15624.7 Permisses de Acesso

.................................................................................................................................................................. 15624.8 Exerccios

.................................................................................................................................................................. 16024.9 Exerccios Complementares ........................................................................................................................................................................ 16125 Elipse Mobile

.................................................................................................................................................................. 16125.1 Servidor

.................................................................................................................................................................. 16125.2 Aplicativo

.................................................................................................................................................................. 16125.3 Exerccios ........................................................................................................................................................................ 16826 Exerccios de Reviso

.................................................................................................................................................................. 16826.1 Exerccio

.................................................................................................................................................................. 17026.2 Resoluo

Apresentao 1

1 ApresentaoCAPTULO

Este Tutorial serve como apoio ao mdulo de treinamento para execuo e programao do E3. Com ele, voc acompanhar ocontedo do curso. Durante as aulas, fique vontade para praticar o que voc aprendeu e para resolver suas dvidas com oinstrutor. No treinamento apresentado um estudo de caso que simula uma aplicao real, um sistema de superviso econtrole.

1.1 A ElipseA Elipse Software uma empresa genuinamente brasileira, com foco na produo de software de superviso para automaoindustrial, surgida em Porto Alegre no incio dos anos 1990.

Seu primeiro produto foi o Elipse 21, um software para a plataforma DOS, que era conhecido por sua facil idade de operao ecompatibil idade com diferentes fabricantes.

Em 1996 a Elipse lana a primeira verso do Elipse Windows, que mais tarde se tornaria o Elipse SCADA. Desde esta poca,foram instaladas milhares de cpias deste software no Brasil.

Em 2000 a Elipse iniciou o desenvolvimento do E3, a terceira gerao de software de superviso da empresa. Desde seulanamento comercial em 2001, milhares de l icenas deste software j foram instaladas e o E3 vem sendo util izado emsistemas diversos, como minerao, Centros de Operao de empresas eltricas, plantas industriais de diversas finalidades,sistemas de telemedio e controle de energia, automao e controle predial, entre outros.

A Elipse Software trabalha em parceria com distribuidores internacionais localizados em pases estratgicos como Alemanha,Holanda, Taiwan, ndia, Canad e outros, alm de manter escritrio prprio nos Estados Unidos, na cidade de Raleigh,Carolina do Norte.

1.2 Mdulos do E3Inicialmente, veremos que o E3 composto de quatro mdulos, descritos nos tpicos a seguir.

1.2.1 E3 Server o Servidor de Aplicaes, onde os principais processos so executados, incluindo a comunicao em tempo real comequipamentos de controle. O servidor tambm responsvel por enviar dados e Telas aos clientes conectados em qualquerparte da rede (Intranet e Internet). O Servidor pode executar vrios projetos ao mesmo tempo e conversar com outros E3Servers para realizar um failover (standby) ou distribuir cargas de processamento entre as mquinas. Foi desenvolvido paraser executado sobre os sistemas operacionais Windows XP SP3, Windows XP x64 SP2, Windows Vista SP2, Windows 7 SP1,Windows 8, Windows 8.1, Windows Server 2003 SP2, Windows Server 2008 SP2, Windows Server 2008 R2 SP1, WindowsServer 2012 ou Windows Server 2012 R2.

1.2.2 E3 StudioFerramenta nica de configurao, agindo como plataforma universal de desenvolvimento. Possui um ambiente moderno eamigvel, incluindo um completo editor grfico e de scripts (VBScript). Permite que um projeto seja editado por vrias pessoasao mesmo tempo ou que vrios E3 Studios estejam conectados ao mesmo servidor remoto, com mltiplas configuraes.

1.2.3 E3 ViewerO Viewer permite operar as aplicaes residentes no servidor em qualquer computador com o programa executvel Viewer(Windows XP SP3, Windows XP x64 SP2, Windows Vista SP2, Windows 7 SP1, Windows 8, Windows 8.1, Windows Server 2003SP2, Windows Server 2008 SP2, Windows Server 2008 R2 SP1, Windows Server 2012 ou Windows Server 2012 R2) ou com umnavegador de Internet. Em ambos os casos, no necessrio instalar a aplicao na mquina cliente, pois todos oscomponentes (Telas, Bibliotecas e controles ActiveX) so baixados e registrados automaticamente.

1.2.4 E3 Admin o mdulo responsvel pela interface do E3 Server e de outros mdulos do E3 com o usurio. Atravs dele o usurio podeenviar comandos ao E3 Server, util izando o cone na rea de Notificao do Windows, e controlar o Domnio pela l inha decomando.

1.3 O TreinamentoA sequncia de aprendizado a ser seguida neste Tutorial reflete o que a Elipse Software considera o conjunto de melhoresprticas no desenvolvimento de aplicativos de superviso e controle, tanto para o E3 (o objeto de estudo deste Tutorial)quanto para o Elipse SCADA ou outros softwares de superviso.

2 Apresentao

A base do roteiro deste Tutorial uma aplicao hipottica, que apresenta os recursos mais importantes do software ElipseE3. Esta aplicao no cobre todas as possibil idades de desenvolvimento oferecidas pela ferramenta. No entanto, aquantidade e qualidade das informaes apresentadas neste primeiro contato com o software so suficientes para que seaprenda a util iz-lo com autonomia para criar aplicaes.

Sua participao muito importante para ns. Ao final do treinamento, solicitaremos que voc avalie diversos aspectos docurso, como a qualidade e a quantidade das informaes transmitidas em aula e pelo Tutorial, alm do trabalho do instrutore a qualidade das instalaes. Qualquer sugesto ou crtica bem-vinda pela equipe de desenvolvimento deste Tutorial.

A Elipse Software deseja a voc um timo treinamento, e uma boa experincia de trabalho com o Elipse E3!

1.3.1 Aplicao de TreinamentoNo treinamento apresentado um estudo de caso que simula uma aplicao real, um sistema de superviso e controle. Oinstrutor desenvolve a aplicao junto com os alunos passo a passo, facil itando o entendimento e o aprendizado daferramenta.

O sistema em questo apresenta um sintico de uma fbrica de tintas, exemplificando vrios aspectos e recursos disponveisno Elipse E3.

O operador do sistema pode visualizar as temperaturas e o nvel dos tanques, a cor da tinta a ser produzida e controlar ofuncionamento das bombas.

Tela principal da aplicao

Para garantir a execuo da aplicao, implementaremos o conceito de Hot-Standby. Assim, se o servidor principal falhar, umservidor de backup entra em ao imediatamente, sem perda da continuidade do processo.

Menu da aplicao

O sistema tambm mostra condies de alarme no caso de algum parmetro ultrapassar os l imites estabelecidos (como porexemplo, um aumento excessivo de temperatura).

Alarmes

Existe um procedimento de consulta dos alarmes, que permite visualizao e impresso dos dados de histricos.

Apresentao 3

Tela de consulta de Alarmes

Alm de criar grficos de tendncia das variveis com a opo de imprimir e exportar o grfico histrico.

Grfico de Tendncia

Finalmente, acessaremos informaes de outro servidor E3 atravs de Domnios Remotos.

4 Apresentao

Domnio Remoto

1.3.2 Arquitetura do TreinamentoA arquitetura do treinamento contm um servidor conectado com CLPs na mesma rede Ethernet. Qualquer computador na redepode visualizar a aplicao.

Arquitetura do Treinamento

Elipse Knowledgebase 5

2 Elipse KnowledgebaseCAPTULO

O Elipse Knowledgebase tem como finalidade ajudar o usurio dos softwares da Elipse a encontrar respostas rpidas paradvidas ou problemas que esteja enfrentando durante a sua util izao, seja no desenvolvimento de aplicaes ou depois det-las prontas. Este espao nada mais do que um portal onde muitas informaes tcnicas e dicas esto concentradas. A suabase de informaes constantemente atualizada e tem uma linguagem simples que visa o rpido entendimento de quem estutil izando. Para acessar a pgina inicial do KB, util ize o endereo kb.elipse.com.br, conforme mostra a figura a seguir.

Pgina inicial do KB

2.1 Elipse KnowledgebaseNo cabealho da pgina existem as seguintes opes:

Glossrio: Permite acessar todo o glossrio de palavras que a ferramenta possui

Favoritos: Link que mostra todos os artigos da base de dados que esto assinalados como favoritos

Login: Serve apenas para uso interno da Elipse Software

2.2 Busca no KnowledgebaseEste campo busca em toda a base de dados pela palavra ou palavras que o usurio digitar, retornando todos os artigos quepossuem a palavra alvo da busca. Basta digitar a palavra que se deseja buscar e ento clicar em Busca.

Busca no KB

Ainda existe a possibil idade de util izar a Busca Avanada, que permite refinar a consulta. Para isto, cl ique em Busca Avanada.

6 Elipse Knowledgebase

Busca Avanada

Na opo Busca Avanada o usurio pode digitar a palavra ou palavras que deseja buscar, fi ltrar por categoria especfica, porautor e ainda pela classificao do artigo. Isto , se ele ajudou muito, apenas ajudou, ajudou pouco ou no ajudou.

2.3 CategoriasExiste a possibil idade de o usurio acessar todos os artigos escolhendo diretamente a categoria a que ele pertence. Para isto,no campo Categorias, selecione a categoria que deseja buscar os artigos e clique em Ir.

Escolha de categorias

Todos os artigos da categoria selecionada so retornados como resultado da busca. importante ressaltar que toda a base deconhecimento est dividida em duas categorias principais: Ingls e Portugus. Dentro destas categorias existem vrias sub-categorias, cada uma delas tratando de um tema especfico. Acessando os artigos pela categoria Portugus - Elipse E3, porexemplo, tem-se a tela da figura a seguir.

Categorias em portugus

Note que dentro de cada uma destas sub-categorias aparece um nmero. Este nmero indica a quantidade de artigos

Elipse Knowledgebase 7

existentes dentro da categoria.

As demais sees existentes na pgina principal do Knowledgebase so:

Artigos Em Destaque: Mostra todos os artigos que esto classificados para aparecerem em destaque. Normalmente estaseo util izada para ressaltar algum artigo que merece uma ateno especial por parte dos usurios dos softwaresda Elipse Software

Artigos Mais Lidos: Mostra a l ista dos 10 artigos mais l idos no Knowledgebase

ltimos Artigos Adicionados: Mostra a l ista dos ltimos 10 artigos que foram adicionados na base de dados doKnowledgebase

Buscas Mais Utilizadas: Mostra as 10 palavras que mais foram util izadas como busca pela ferramenta de busca doKnowledgebase

8 Iniciando a Aplicao

3 Iniciando a AplicaoCAPTULO

Aps instalar o software, tem-se um grupo de programas chamado Elipse E3, com um cone para abrir o E3 Studio. Quandoo E3 Studio inicia, abre-se uma caixa de dilogo com algumas opes do projeto.

Caixa de dilogo inicial do E3 Studio

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

Opes disponveis na caixa de dilogo inicial do E3

OPO DESCRIOIniciar o E3 Studio Inicia o E3 Studio, mas no abre nenhum Domnio.Criar um Domnio novo Cria um novo Domnio atravs do Ass is tente de Apl icaes do

E3, que pede o nome e o caminho do novo Domnio.Abrir um Domnio existente Abre um Domnio exis tente dentre os l timos edi tados .

Cl icando em Outros arquivos, pode-se loca l i zar um Domnio emum diretrio especfico.

3.1 Criando a AplicaoPara criar uma nova aplicao, util ize o Assistente de Aplicaes. Para isto, cl ique em Novo na barra de ferramentasPadro.

Iniciando a Aplicao 9

Assistente de Aplicaes

O E3 trabalha com trs tipos de arquivos de projeto, descritos a seguir.

3.1.1 ProjetosContm definies de objetos, Tags, Telas e outros componentes de uma aplicao. Os arquivos .prj so criados atravs dasopes Aplicao Padro e Aplicao em Branco. A primeira opo cria um projeto pr-configurado com alguns objetos bsicose um assistente de criao de projeto, enquanto a segunda opo cria um projeto vazio a ser implementado pelo usurio.

3.1.2 BibliotecasContm definies de objetos criados pelo usurio (ElipseX) para serem util izados em projetos. Estas bibliotecas podem serreutil izadas em diferentes projetos, mas mantm vnculos com a aplicao. Ou seja, se a biblioteca for alterada, todos osobjetos desta biblioteca so atualizados nos projetos automaticamente.

3.1.3 Configurao do DomnioArmazena quatro tipos de informao: Opes de configurao do Domnio, l ista de arquivos .prj e .l ib, configuraes dosservidores que rodam o Domnio e configuraes de segurana (usurios e permisses). Sem este arquivo, um projeto nopode ser executado no E3. Este item visto mais adiante.

3.1.4 OrganizerO Organizer permite uma viso simples e organizada de toda a aplicao, ajudando na edio e configurao de todos osobjetos envolvidos na aplicao atravs de uma rvore hierrquica de opes. Possui dois modos de visualizao, Domnio eExplorer.


Janela do Organizer em modo Domnio

O modo Domnio mostra apenas as informaes dos objetos abertos pertencentes ao Domnio, organizados em quatro grupos:Configurao, Bibliotecas de Objetos, Visualizao e Objetos de Servidor.

O modo Explorer mostra projetos e bibliotecas abertos no E3 Studio, pertencentes ou no ao Domnio. Os objetos somostrados no projeto ou biblioteca ao qual pertencem, ordenados alfabeticamente dentro de cada projeto ou biblioteca.

3.1.5 Lista de PropriedadesA Lista de Propriedades uma janela que mostra todas as propriedades do objeto em uso, permitindo sua configurao deforma simples e rpida. A Lista de Propriedades est disponvel no menu Visualizar - Lista de Propriedades ou clicando em na barra de ferramentas Padro.


Lista de Propriedades

3.2 Execuo de um DomnioPara executar ou visualizar um projeto no E3, necessrio que o Domnio seja colocado em execuo. Para isto, existem asseguintes opes no E3 Studio:

Executar aplicativo: Salva todas as configuraes dos projetos e bibliotecas, inicia a execuo do Domnio e executa oViewer

Rodar/Parar Domnio: Inicia ou para a execuo do Domnio

Executar ou parar o E3 Viewer: Executa o Viewer ou para sua execuo

3.3 Exerccios


3.3.1 Criando uma Aplicao1. Inicie o E3 Studio selecionando a opo Criar um Domnio novo. O Assistente de Aplicaes aberto.

Selecionar o tipo de aplicao

2. No Assistente de Aplicaes, cl ique em Avanar, selecione a opo Aplicao Padro e nomeie o projeto como"TreinamentoE3".

3. Ajuste o caminho da aplicao para C:\TreinamentoE3 e clique em Avanar.

4. Na prxima janela do Assistente, selecione a opo Criar um novo Domnio e use o mesmo nome do projeto.

Definir o Domnio

5. Selecione a resoluo da tela e clique em Avanar.


Definir a resoluo do Viewer

6. Responda No pergunta Voc deseja comunicar com um dispositivo/equipamento?. Este tema ser apresentado em umcaptulo posterior.

Configurar um driver de comunicao

7. Responda No pergunta Voc quer guardar dados em disco?. Este tema ser apresentado em captulo posterior.


Configurar um banco de dados

8. Responda No pergunta Voc deseja monitorar alarmes em sua aplicao?. Este tema ser apresentado em captuloposterior.

Configurar os alarmes

9. Clique em Concluir para gerar a aplicao.

10. Ao final destes procedimentos, tem-se acesso rea de trabalho do E3 Studio.

3.3.2 E3 Studio1. Ao criar uma aplicao padro, automaticamente criada uma Tela com o nome "TelaInicial". Selecione esta Tela e, na

sua Lista de propriedades, selecione a cor de sua preferncia na propriedade BackgroundColor.


Propriedade BackgroundColor

2. Execute a aplicao clicando em na barra de ferramentas Padro.

3.4 Exerccios Complementares

3.4.1 KBKB-28984: Tempo de execuo util izando apenas l icena de Studio

16 Simulao de Valores

4 Simulao de ValoresCAPTULO

O Servidor de Dados o mdulo responsvel pela execuo e gerenciamento de Tags e objetos que no estejam envolvidosdiretamente com a comunicao. Atravs do Servidor de Dados pode-se configurar Tags internos e Tags de simulao, alm deinserir XObjects, que so os objetos de dados das bibliotecas ElipseX (vistas mais adiante). Alguns dos objetos que podem serinseridos no Servidor de Dados esto descritos na tabela a seguir.

Objetos que podem ser inseridos no Servidor de Dados

OBJETO DESCRIO Tag Contador Objeto que executa uma contagem de tempo (em segundos)

at atingi r um va lor pr-determinado, ou que executa umacerta contagem de tempo indefinidamente.

Tag Demo Objeto que gera va lores de acordo com a forma de onda. uti l i zado para s imulao de va lores . Permite gerar curvasdefinidas ou va lores a leatrios .

Tag Interno Objeto de props i to genrico, uti l i zado para guardar va loresde qualquer tipo, incluindo nmeros , textos e outros objetos .

Tag Timer Objeto para contagem de tempo e programao deatividades . Es tabelece horrios , com repeties , paraexecutar aes .

Pasta de Dados Define grupos e subdiretrios para a organizao dasinformaes . Novas pastas podem ser inseridas dentro deoutras , conforme a necess idade.

NOTA: Os objetos inseridos no Servidor de Dados so executados pelo E3 Server, portanto esto presentes no Servidor. Es tainformao retrata o modo como o E3 trabalha.

4.1 Regras para Nomes de TagsAo especificar o nome dos Tags, alguns detalhes devem ser levados em conta:

O nome do Tag no pode ser estritamente numrico

O nome do Tag no pode conter operadores lgicos ou aritmticos: (/ * + -)

O nome da varivel no pode conter caracteres reservados: / ? . , { } [ ] - etc. Estes caracteres so trocados pelocaractere sublinhado. Assim, o sistema aplica a Regra dos Colchetes, explicada a seguir

4.1.1 Regra dos ColchetesAo fazer referncia a um objeto por script ou ao us-lo em alguma Associao, deve-se levar em conta as seguintes regras:

Se o primeiro caractere no for uma letra ou um caractere sublinhado, o nome deve estar entre colchetes

Se algum dos demais caracteres (do segundo em diante) no for uma letra, um nmero ou um caractere sublinhado, onome tambm deve estar entre colchetes

Caso existam caracteres especiais (por exemplo, acentos), o nome deve estar entre colchetes

4.2 Exerccios

4.2.1 Simulao de ValoresMuitas vezes precisamos de valores que simulem os movimentos. Normalmente estes valores so reais e vm de Tags deComunicao, mas nos exerccios do Tutorial usaremos Tags do tipo Demo.

1. Para inserir um Tag Demo, localize no Organizer o item Objetos do Servidor e dentro dele o item Objetos de Dados. Cliquecom o boto direito do mouse na pasta Dados e selecione o item Inserir - Panel - Tag Demo.

Simulao de Valores 17

Inserir Tag Demo

2. Na pasta Dados, insira os Tags Demo com as propriedades configuradas conforme a tabela a seguir.

Propriedades dos Tags Demo

NAME DOCSTRING MINIMUM MAXIMUM PERIOD SCAN TYPENivel1 Nvel do Tanque

10 100 2000 200 0 - Random

Nivel2 Nvel do Tanque2

0 100 2000 200 0 - Random

Temp1 Temperatura doTanque 1

20 80 20000 500 1 - Sine

Temp2 Temperatura doTanque 2

20 80 10000 500 0 - Random

4.2.2 TanquesA aplicao representa uma fbrica que util iza como matria-prima as tintas vermelha, verde e azul, produzindo as demaistintas como uma combinao destas trs.

1. Na pasta Dados, crie uma Pasta de Dados chamada "Tanque1" e insira trs Tags Internos: "Vermelho", "Verde" e "Azul".

2. Configure o valor inicial dos trs Tags para Integer.

18 Simulao de Valores

Selecionar tipo de dado

3. Crie uma cpia da pasta "Tanque1" para criar a pasta "Tanque2".

Pastas de Dados

4.2.3 Tags no ViewerQuando a informao (Tag) est no servidor, ela nica para todos os usurios da aplicao. Se a informao pode serdiferente para cada usurio (por exemplo, o nome do usurio logado), esta informao deve ser salva no objeto Viewer.

Vamos criar um Tag responsvel pelo movimento do balde sobre a esteira. Para que o movimento acontea, precisamos deuma varivel que varie entre 0 e 100, l inearmente. Como usaremos esta varivel apenas para animar um objeto de Tela,criaremos um Tag Demo (simulao) no objeto Viewer.

1. Clique com o boto direito do mouse no Viewer e insira um Tag Demo com o nome de "Anima".

Simulao de Valores 19

Criar Tag Demo no Viewer

2. Configure o Tag Anima com os seguintes valores:

Minimum: 0

Maximum: 100

Period: 5000

Scan: 100

Type: 6 - RampUpDown

20 Estrutura de Telas e Quadros

5 Estrutura de Telas e QuadrosCAPTULO

O Quadro o objeto que organiza e estrutura a interface, criando visualizaes compostas para o usurio dentro da janelaprincipal do Viewer ou do navegador.

No Quadro pode-se criar Divisores para visualizar diferentes Telas ao mesmo tempo. Cada Divisor tambm pode mostrar umaURL, uma planilha do Excel, um documento do Word ou um arquivo PDF.

A disposio dos Divisores dentro do Quadro pode ser horizontal ou vertical. Dentro de cada Divisor podem ser inseridosoutros Divisores. A cada par de novos Divisores criados pelas opes Dividir Horizontalmente e Dividir Verticalmente, hsempre um Divisor Principal e um Divisor Secundrio. Apenas o Divisor Principal tem valores que definem explicitamente oseu posicionamento, ficando o Divisor Secundrio com o valor restante. Para util izar este recurso, siga estes procedimentos:

1. Clique com o boto direito do mouse no item Visualizao - Viewers e Quadros do Organizer e selecione a opo InserirQuadro em.

2. Para criar um Divisor, cl ique com o boto direito do mouse no Quadro aberto e selecione o tipo de diviso (DividirHorizontalmente ou Dividir Verticalmente).

Menu de diviso do Quadro

3. Arraste a barra de diviso com o mouse para a posio desejada e clique com o boto esquerdo do mouse para fix-la.

Estrutura de Telas e Quadros 21

Quadros divididos horizontalmente e verticalmente

5.1 ViewerO objeto Viewer configura o modo como o E3 Viewer visualizado.

O E3 Viewer pode rodar a partir de qualquer ponto da rede que tenha acesso ao E3 Server. No necessrio copiar oaplicativo para as mquinas onde os E3 Viewers so executados, pois as Telas e bitmaps so trazidos do servidor conforme anecessidade, em tempo de execuo.

NOTA: S pode exis ti r um objeto Viewer em um Domnio.

Na aba Visualizador da Janela de Propriedades so definidas as configuraes de visualizao do Viewer.


Aba Visualizador

Atravs da aba Configurao, pode-se editar as opes relativas janela, ao ttulo e resoluo do Viewer.

Aba Configurao

Na aba Erros de comunicao, pode-se configurar um padro para que os Displays e SetPoints de toda a aplicao indiquemerros de comunicao.


Aba Erros de Comunicao

NOTA: Tambm poss vel inseri r Tags no Viewer.

5.2 ExercciosA estrutura de Telas da aplicao dividida em trs partes: Um menu de navegao na parte superior, uma rea de alarmes naparte inferior e uma rea central.

5.2.1 Quadros1. Clique com o boto direito do mouse no item Viewer e Quadros e selecione a opo Inserir Quadro em -

TreinamentoE3.prj.

2. Na rea de visualizao do Quadro, cl ique com o boto direito do mouse e selecione a opo Dividir Horizontalmente,conforme a figura a seguir.

Dividir Horizontalmente

3. Posicione a barra que aparece a cerca de 10% da Tela, a partir de seu l imite superior, e clique com o boto esquerdo domouse para fixar a posio da barra.

4. Configure o tamanho do Divisor para "10%" na propriedade SplitValue.


NOTA: A propriedade SplitValue tambm pode ser configurada em pixels , uti l i zando o prefixo "px". Por exemplo, "100 px".

5. Nomeie a Diviso criada como "Area_Superior". Para trocar o nome de um objeto, existem trs opes:

Selecione o objeto no Organizer e pressione a tecla F2 para habil itar a edio do nome

Selecione o objeto no Organizer e, na Lista de Propriedades do objeto, altere a propriedade Name

Clique com o boto direito do mouse no objeto no Organizer e selecione a opo Renomear

6. Divida horizontalmente o Quadro inferior a cerca de 10% da Tela, a partir do l imite inferior. Nomeie as Divises como"Area_Central" e "Area_Inferior", respectivamente.

Divises do Quadro

7. Configure o Divisor Area_Inferior como Principal. Isto faz com que o E3 obedea ao tamanho do Divisor e o restante daTela o tamanho do Divisor Area_Central. Clique com o boto direito do mouse no Divisor Area_Inferior e selecionea opo Configurar como Divisor Principal.

Configurar como Divisor Principal

8. Configure o tamanho do Divisor Area_Inferior em "10%" (propriedade SplitValue).

5.2.2 Tela MenuA Tela de menu possibil ita a navegao entre as Telas da aplicao, alm de exibir o horrio do sistema e o nome do usuriologado.

1. Clique com o boto direito do mouse no item Telas e selecione a opo Inserir Tela em - TreinamentoE3.prj.


Inserir Tela

2. Selecione o item Area_Superior na opo Escolha o Divisor onde a Tela ser aberta. Isto faz com que a Tela seja criada como tamanho exato deste Divisor. Selecione a opo Configurar como Tela inicial do Divisor e, no campo Nome, digite"TelaMenu".

Tamanho da Tela

5.2.3 Tela Alarmes1. Crie a "TelaAlarmes" para ser aberta no Divisor Area_Inferior. Selecione a opo Configurar como Tela inicial do Divisor.

2. Selecione um estilo de preenchimento para esta Tela.

5.2.4 Tela ou Quadro Inicial da AplicaoPara testar a configurao do Quadro, vamos configur-lo para que aparea ao iniciar a aplicao.

1. Clique com o boto direito do mouse no item Visualizao - Viewer e Quadros - Viewer no Organizer para abrir a janela depropriedades.


Propriedades do Viewer

2. Selecione o Quadro1 no campo Tela ou Quadro Inicial.

Opo Tela ou Quadro Inicial



5.3.1 Horrio do SistemaPara obter o horrio corrente do sistema, necessrio criar um Tag Demo que acesse esta informao.

1. Clique com o boto direito do mouse no item Objetos de servidor - Objetos de Dados - Dados e insira um Tag Demo com onome de "Relogio". Configure a propriedade Type deste Tag para 3 - CurrentTime.

Adicionar Tag Demo

2. No canto direito da TelaMenu, insira um objeto Display para exibir o horrio do computador.

3. Abra a janela de propriedades deste objeto e selecione a aba Formatao. Defina o formato como Hora e, na opo Tipo,selecione o item 13:06:03. Este formato mostra as horas, os minutos e os segundos.

4. Para visualizar a configurao feita no exerccio anterior, selecione a propriedade Value do Display e selecione o itemDate.

5. Abra a janela de propriedades do Display e clique na aba Associaes. Na propriedade Value, selecione na coluna Fonte,usando o AppBrowser, o Tag Demo Relogio (em Servidor - Dados) e clique em Colar.


Aba Associaes do Display

6. Execute a aplicao e verifique as novas funcionalidades.

Telas e Objetos de Tela 29

6 Telas e Objetos de TelaCAPTULO

Telas so janelas para monitoramento de processos, onde so inseridos objetos que fazem parte da interface do operador como sistema. Cada aplicao pode ter um nmero i l imitado de Telas.

Os Objetos de Tela so elementos grficos que podem ser inseridos nas Telas para criar a interface visual com o processo.Podem ser criados a partir da barra de ferramentas Objetos ou atravs do menu Objetos.

Uma vez selecionado o objeto que se deseja criar, mantenha o boto esquerdo do mouse pressionado na rea da Telaenquanto movimenta o mouse (um retngulo pontilhado mostra o tamanho e a forma do objeto). Ao soltar o boto, o objeto posicionado dentro da rea especificada.

6.1 TelaA Tela o objeto bsico de interface com o usurio. Nela podem-se inserir os seguintes objetos:

Primitivas do editor grfico (retas, crculos, retngulos, polgonos, etc.)

Controles ActiveX fornecidos pela Elipse (E3Alarm, E3Chart, E3Browser)

Controles ActiveX fornecidos por terceiros

Imagens no vetoriais (Arquivos BMP, JPG, GIF, etc.)

Imagens vetoriais (Arquivos WMF, EMF, etc.)

Controles padro do Windows (Lista, Editor de Texto, Lista de Seleo, etc.)

Bibliotecas grficas do E3 (XControl) compostas de quaisquer objetos citados anteriormente

As Telas util izam como padro para o tamanho e coordenadas as unidades Himetric, dadas em 1/100 mm, no em pixels.Neste sistema, ao se adicionar um valor positivo em x, a coordenada x move-se para a direita. Quando se adiciona um valorpositivo em y, a coordenada y move-se para baixo, e a origem dada pelo canto superior esquerdo da Tela.

As Telas podem ser abertas em modo Full Screen (Tela Cheia), ocupando toda a rea do Viewer, ou ainda como telas modais,ocupando somente o tamanho de suas coordenadas de altura e de largura.

Tela

30 Telas e Objetos de Tela

6.2 Controles Microsoft FormsOs objetos Microsoft Forms so componentes de software baseados na tecnologia COM (Component Object Model) daMicrosoft. O E3 instala e util iza os controles Microsoft Forms. Eles podem ser inseridos nas Telas da aplicao para realizardiversas tarefas. A tabela a seguir contm a descrio destes objetos.

Controles Microsoft Forms

CONE OBJETO DESCRIOCaixa de Seleo (Check Box) Uti l i zado para dar ao usurio uma

escolha entre dois va lores , ta is comoSim e No, True e Fa lse ou On e Off.

Boto de Opes (Option Button) Uti l i zado para mostrar se um i temindividual de um grupo estselecionado.

Boto de Comando (Command Button) Uti l i zado para executar uma aoespecfica ao press ion-lo.

Texto (Label) Uti l i zado para exibi r um texto descri tivo,como ttulos , legendas , etc.

Lista (List Box) Exibe uma l i s ta de va lores .

Barra de Rolagem (Scroll Bar) Retorna ou define o va lor dapropriedade de outro objeto, de acordocom a pos io da ca ixa de rolagem.

Boto Incremento-Decremento (Spin Button) Uti l i zado para incrementar edecrementar um va lor.

Editor de Texto (Text Box) Uti l i zado para exibi r informaesdigi tadas pelo usurio na Tela .

Boto Liga-Desliga (Toggle Button) Semelhante ao Boto de Comando,porm necess i ta um segundo comandodo usurio para vol tar ao estado normal .

Lista de Seleo (Combo Box) Combina os recursos de uma Lis ta e deum Editor de Texto. O usurio podedigi tar um novo va lor ou selecionar umvalor exis tente.

NOTA: Outros objetos ActiveX de tercei ros tambm podem ser uti l i zados no E3, desde que sejam devidamente regis trados . Elespodem ser adicionados atravs do menu Ferramentas - Gerenciar ActiveX.

6.3 GaleriaA Galeria uma biblioteca de smbolos vetoriais, divididos em categorias, que podem ser arrastados para as Telas. Depois deinserido, o objeto pode ser l ivremente editado e trabalhado de acordo com as caractersticas descritas para os objetos deimagem (pode-se, por exemplo, mudar a cor de preenchimento atravs das propriedades OverrideFillMode, OverrideFillColor eOverrideLineColor, sem a necessidade de transformar o objeto em um objeto grfico do E3).

Alm da biblioteca de smbolos, a Galeria tambm mostra os XControls pertencentes s bibliotecas do Domnio corrente.

Galeria


NOTA: Ao executar o E3 Studio em modo Demo (sem l icena), apenas o primeiro elemento de cada conjunto de categorias des mbolos est disponvel .

6.4 ExercciosA Tela Inicial deve ser a primeira a ser exibida ao executar o projeto.

Tela Inicial

6.4.1 Figuras ExternasTodas as figuras util izadas nesta aplicao devem ser salvas em uma pasta dentro do projeto principal para que no sejanecessrio preocupar-se com os caminhos das figuras ao executar a aplicao em outro computador.

1. Clique com o boto direito do mouse em Recursos e selecione a opo Inserir Recurso em - TreinamentoE3.prj.

Inserir Recurso


2. Escolha todas as figuras da pasta C:\TreinamentoE3\Figuras.

6.4.2 Imagem de Fundo1. Configure a propriedade FillStyle da TelaInicial para 12 - bkPicture, para habil itar uma figura de fundo.

2. Para colocar a figura FundoTelaInicial como fundo da Tela, arraste o bitmap de Recursos at a propriedade PictureFile daTela. Isto faz com que o E3 util ize o recurso inserido e no o arquivo da imagem, que externo aplicao.

3. Para escolher a melhor posio da figura, pode-se alterar a propriedade PicturePosition.

6.4.3 Texto1. Crie um objeto Texto com a palavra "Entrar" e outro com a palavra "Sair".

DICA: Para edi tar um Texto j exis tente na Tela , cl ique com o boto di rei to do mouse no objeto e selecione o i tem Editar texto.

2. No centro da Tela, posicione o Texto "Treinamento E3 Studio".

DICA: Uti l i ze as opes Centralizar Horizontalmente e Centralizar Verticalmente.

3. Logo abaixo do Texto "Treinamento E3 Studio", insira um segundo Texto com a mensagem "Elipse Software Ltda".

4. Para executar a aplicao, cl ique em na barra de ferramentas Padro.

6.4.4 Tela Menu1. Altere a propriedade FillStyle para 12 - bkPicture.

2. Arraste a imagem FundoTelaMenu para a propriedade Picture. Ajuste a imagem na propriedade PicturePosition.

6.4.5 Tela SinticoVamos trabalhar a Tela principal da aplicao.

Ao combinar a quantidade de vermelho, verde e azul, uma nova cor criada no tanque. A tinta depositada em um balde quedesliza pela esteira. As bombas, temperaturas e nveis so monitorados neste processo.

TelaSinotico

1. Clique com o boto direito do mouse na pasta Telas e selecione a opo Inserir Tela em - TreinamentoE3.prj.


Inserir Tela

2. Selecione a opo Configurar como Tela inicial do Divisor e, no campo Nome, digite "TelaSinotico". Configure esta Tela paraque seja aberta no Divisor Area_Central.

Configurar como Tela inicial

3. Responda Sim mensagem Deseja alterar esta configurao para 'TelaSinotico'?.

Mensagem

4. Na TelaSinotico, altere a propriedade FillStyle para 12 - bkPicture.

5. Arraste a imagem FundoTelaSinotico para a propriedade PictureFile.


6.4.6 SetPoint1. Sobre os tanques de cores, insira SetPoints onde deve ser digitada a quantidade de cada componente de cor.

Habilite os l imites do SetPoint, alterando a propriedade EnableLimits para Verdadeiro (True).

Configure a propriedade MaxLimit para "255" e a propriedade MinLimit para "0" (zero).

Configurando limites

6.4.7 Galeria1. Sobre a esteira insira, a partir da Galeria, a figura 5GallonBucket, que est na pasta Tanks.

Esteira

6.4.8 Retngulo1. Sobre os tanques direita, desenhe um objeto Retngulo e configure as seguintes propriedades:

BackgroundStyle: 1 - Opaque

BackgroundColor: Preto (RGB(0, 0, 0))

VerticalPercentFill: 20

6.4.9 Display1. Ao lado de cada tanque, insira um Display .

2. Configure o valor inicial para exibir um valor Double, alterando a sua propriedade Value.

3. Formate o Display como Porcentagem e com uma casa decimal, alterando a sua propriedade Format.

4. Insira mais um Display ao lado do anterior para exibir a temperatura, formatado como "0.0 C" e uma casa decimal.


Aba Formatao

5. Para executar a aplicao, cl ique em na barra de ferramentas Padro.


6.5.1 KBKB-36216: Inserindo objetos na Galeria do E3

36 Associaes

7 AssociaesCAPTULO

Associaes (ou Conexes) so l igaes feitas entre propriedades e objetos ou entre outras propriedades. As Associaestrazem grande facil idade ao criar animaes e outros tipos de lgicas comuns, minimizando a util izao de scripts.

Atravs da aba Associaes da janela de Propriedades, tem-se acesso a todas as propriedades disponveis do objeto a sertratado e todos os tipos possveis de associaes para estas propriedades.

Aba Associaes

Pode-se associar um objeto ou criar uma expresso. Ao criar uma expresso ou associar um objeto ou propriedade ao campo Fonte, o texto aparece na cor azul, caso este corresponda a um item existente ou carregado no E3 Studio. Se o item no existir,ou pertencer a um mdulo no existente no Domnio, o texto aparece em vermelho, e este item mostrado como um erro, atser corrigido ou excludo com a opo Verificar Domnio.

7.1 Tipos de AssociaoEsta seo contm informaes sobre os tipos de Associaes.

7.1.1 Associao SimplesNa Associao Simples, o valor do campo Fonte copiado para a propriedade toda vez que a fonte modificada.

Associao Simples

Associaes 37

7.1.2 Associao BidirecionalNa Associao Bidirecional acontece o mesmo que na Associao Simples, porm caso tambm haja uma variao napropriedade, seu valor copiado para o campo Fonte, gerando assim um caminho de duas direes.

Associao Bidirecional

7.1.3 Associao DigitalJ na Associao Digital possvel estabelecer que, caso a varivel ou expresso do campo Fonte seja uma propriedade digital,seus estados Verdadeiro e Falso so mapeados para certos valores no destino, incluindo a opo de Pisca (alternncia devalores).

Associao Digital

7.1.4 Associao AnalgicaA Associao Analgica permite estabelecer uma escala de converses entre a varivel fonte e a varivel destino. Atravs dequatro valores especificados, feita uma escala l inear entre os valores da propriedade e os valores da fonte.

38 Associaes

Associao Analgica

7.1.5 Associao por TabelaNa Associao por Tabela, pode-se estabelecer condies entre a varivel, os valores e o destino. Na tabela so especificadosvalores mnimos e mximos, e valores para a propriedade referente a estas condies.

Associao por Tabela

Associaes 39

7.1.6 Associao ReversaA Associao Reversa uma Associao unidirecional do objeto para a fonte.

Associao Reversa

7.1.7 Associao MltiplaNa Associao Mltipla, cada l inha da Associao permite buscar o valor de uma fonte diferente. A fonte ativa selecionada deacordo com o valor da fonte principal da Associao.

Associao Mltipla

7.2 Edio de AssociaesO E3 possui uma ferramenta para editar Associaes, chamada Edio de Associaes. Assim, possvel mudar uma ou maisAssociaes criadas na aplicao de forma mais rpida do que pela janela tradicional. O acesso a esta ferramenta pode serfeito clicando-se com o boto direito do mouse em um ou mais objetos e selecionando a opo Editar Associaes.

40 Associaes

Edio de Associaes

7.3 Valores BooleanosEm VBScript, 0 (zero) considerado como Falso e qualquer valor diferente de zero considerado Verdadeiro. Considere, porexemplo, um Tag que representa uma entrada ou sada digital, portanto seus valores so 0 ou 1. Ao usar o valor do Tag paraAssociaes com propriedades do tipo Boolean, o E3 considera:

Valor do Tag para tipos Boolean

TAG VBSCRIPT0 Falso1 Verdadeiro

Ao util izar o comando NOT, o E3 considera:

Valor do Tag com NOT

TAG NOT TAG VBSCRIPT0 -1 Verdadeiro1 -2 Verdadeiro

Portanto, NOT de 1 no Falso, pois seu valor no igual a 0 (zero). Caso deseje util izar o comando NOT, primeiro converta ovalor do Tag para Boolean com o mtodo CBool.

Converso de Tags com CBool

TAG CBOOL(TAG) NOT CBOOL(TAG)0 Falso Verdadeiro1 Verdadeiro Fa lso

Uso do mtodo CBool

Outra opo seria trabalhar com a propriedade Bit00 do Tag, que j uma propriedade do tipo Boolean, ao invs de trabalharcom a propriedade Value do Tag.

Uso da propriedade Bit00

7.4 Exerccios

7.4.1 Associao SimplesNvel do Tanque

1. Para simular o movimento do l quido do tanque na TelaSinotico, crie uma Associao entre a propriedadeVerticalPercentFill do corte do tanque e a propriedade Value do Tag Nivel1.

Propriedade VerticalPercentFill

Associaes 41

2. Repita o procedimento do item anterior para o Tag Nivel2.

Temperatura do Tanque

3. Crie uma Associao no Display de temperatura de cada tanque com o seu respectivo Tag.

Propriedade Value

7.4.2 Associao Analgica1. O valor do Tag Nivel1 varia de 0 a 100, enquanto a formatao do tipo Porcentagem exibe valores de 0 a 1. Para aplicar

uma escala ao valor, insira uma Associao Analgica no Display que exibe numericamente a varivel Nivel1.

Associao Analgica

7.4.3 Associao por TabelaO Display que exibe o nvel deve alterar a cor de fundo, conforme a tabela a seguir.

Cor de fundo do Display

MNIMO MXIMO COR0 10 Verde10 30 Azul30 70 Branco70 90 Amarelo90 100 Vermelho

1. Na propriedade ForegroundColor do Display, insira uma Associao por Tabela com o Tag Nivel1.

Associao por Tabela

7.4.4 Copiar AssociaoPara copiar a Associao para o Display Nivel2, siga estes passos:

1. No Display j configurado com a Associao por Tabela, cl ique com o boto direito do mouse e selecione a opo CopiarAssociaes.

42 Associaes

Opo Copiar Associaes

2. No Display que deseja formatar, cl ique com o boto direito do mouse e selecione a opo Colar Associaes.

3. Se j existir alguma Associao neste objeto, abre-se uma caixa de dilogo para escolher se deseja ignorar ousobrescrever.

Ignorar ou sobrescrever Associao

4. Altere a referncia do Tag Nivel1 para Nivel2.

7.4.5 Associao Bidirecional1. Para cada SetPoint na TelaSinotico, crie uma Associao Bidirecional com o seu Tag respectivo, Vermelho, Verde e

Azul.

Associao Bidirecional

Associaes 43

7.4.6 Expresso1. Para poder modificar a cor do l quido, crie a Associao mostrada na figura a seguir.

Associao com uma expresso

2. Selecione no AppBrowser o mtodo RGB do VBScript.

3. Substitua as palavras "Red", "Green" e "Blue" pelos Tags Vermelho, Verde e Azul, respectivamente.

DICA: Trabalhe com os comandos Copiar (CTRL + C) e Colar (CTRL + V). Para edi tar uma Associao criada anteriormente, use atecla F2.

4. Repita os procedimentos anteriores para o segundo tanque.

7.4.7 Animao1. Selecione o objeto Galo e clique em para inserir uma Animao com Translao. Uma sombra do objeto aparece.

Mova-a at onde desejar.

Animao com Translao

O incio do movimento representa a posio 0 (zero), e o final a posio 100.

2. Clique com o boto direito do mouse na Animao e abra sua janela de propriedades. Crie uma Associao napropriedade Value com o Tag Anima.

Associao na propriedade Value

3. Altere as propriedades Enabled e EnabledSlider da Animao para Falso.

44 Comunicao

8 ComunicaoCAPTULO

O E3 permite a comunicao com equipamentos de aquisio de dados, controladores, CLPs (Controladores LgicosProgramveis), UTRs (Unidades Terminais Remotas), ou qualquer outro tipo de equipamento, atravs de Drivers deComunicao ou Servidores OPC, de acordo com o tipo do equipamento ou tipo de comunicao necessrio. Os Drivers deComunicao e Servidores OPC funcionam neste caso como servidores de variveis, ou seja, eles fornecem as informaes domundo externo para o E3 para que a superviso do processo se realize. As variveis envolvidas no processo so conhecidascomo Tags e podem ser de vrios tipos, de acordo com a util izao desejada. No E3 podem ser inseridos dois tipos de Drivers,o Driver de Comunicao (arquivos .dll) e o Driver de Comunicao OPC.

8.1 Elipse Modbus SimulatorO Elipse Modbus Simulator um gerador de valores aleatrios para aplicaes compatveis com o protocolo Modbus RTU eModbus TCP. Alm disto, tambm permite receber mensagens de escrita feitas por estas aplicaes. O programa pode serbaixado no site da Elipse.

Quando o Simulador iniciado, abre-se a rea de trabalho, mostrada na figura a seguir.

Janela principal do Elipse Modbus Simulator

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

Opes disponveis na janela principal do Elipse Modbus Simulator

OPO DESCRIOPLCs Quantity Nmero de PLCs s imulados . NOTA: Na verso Demo es te campo

tem um l imite de 10 PLCs .Initial Port Porta base uti l i zada para a comunicao.Random Values Habi l i ta ou desabi l i ta a gerao a leatria de va lores .Interval (ms) Interva lo de variao dos va lores , em mi l i s segundos .Connection Tipo de conexo a s imular (atua lmente a nica opo

disponvel TCP/IP).Protocol Protocolo a s imular (Modbus RTU ou Modbus TCP).COILS Nmero de Coils a ser s imulado por PLC (l imite mximo de 255).REGISTERS Nmero de Registers a ser s imulado por PLC (l imite mximo de

255).

Aps selecionar a quantidade de PLCs e a porta inicial, inicie a simulao clicando em Start.

8.1.1 Quantidade de PLCsO Simulador cria os PLCs nas portas consecutivas ao valor configurado no campo Initial Port. Por exemplo, ao configurar trsPLCs a partir da porta 502, o primeiro PLC est disponvel na porta 502, o segundo na porta 503 e o terceiro na porta 504.

Comunicao 45

Quantidade de PLCs

NOTA: Os PLCs criados consecutivamente ao va lor configurado no campo Initial Port uti l i zam somente portas disponveis . Noexemplo anterior, se a porta 503 estiver em uso por outra apl icao, so criados PLCs nas portas 502, 504 e 505.

8.1.2 MemriasO Simulador prev 30 registros digitais (Coils) e 20 registros analgicos (Registers). permitida a escrita de valoresdiretamente no Simulador, atravs da coluna Value dos grids respectivos, quando a variao de valores para o PLC estiverdesligada.

Com a opo Random Values selecionada, so gerados valores aleatrios em todas as memrias a cada dois segundos,conforme definido no campo Interval. O endereo de cada PLC sempre 1 (Device ID).

8.1.2.1 CoilsCoils so memrias digitais disponveis para leitura atravs da funo Modbus 01 (Read Coil Status) e escrita atravs dafuno Modbus 05 (Force Single Coil).

8.1.2.2 RegistersRegisters so memrias analgicas que variam de 0 a 65535 (Word). Esto disponveis para leitura atravs da funo Modbus03 (Read Holding Registers) e para escrita atravs da funo Modbus 06 (Preset Single Registers) ou da funo Modbus 16(Preset Multiple Registers).

8.2 Driver de ComunicaoO Driver de Comunicao o mdulo do E3 que possibil ita a comunicao com um determinado equipamento, usando osDrivers .dll fornecidos pela Elipse Software. Um manual fornecido juntamente com cada Driver, contendo informaesimportantes respeito da configurao de seus parmetros [P] e outras propriedades. Os tipos de objetos de Driverdisponveis para comunicao so descritos na tabela a seguir.

Objetos disponveis no Driver de Comunicao

OBJETO DESCRIO Pasta Define grupos e subdiretrios para a organizao de

variveis . No tem relao di reta com o equipamento decampo.

Tag de Comunicao Uti l i zado para defini r a comunicao com uma varivel (umendereo de memria) do equipamento de aquis io.

Bloco de Comunicao Uti l i zado para defini r a comunicao com diversas variveis(vrios endereos de memria em sequncia) doequipamento de aquis io.

Elemento de Bloco Representam cada um dos endereos de um Bloco e souti l i zados como se fossem Tags de Comunicao. OsElementos de Bloco podem apontar para cada ndice dentrode um Bloco (correspondendo a cada varivel de interesse).

8.3 Driver de Comunicao OPCO Driver de Comunicao OPC o mdulo responsvel por coletar dados de equipamentos externos atravs de um ServidorOPC, que pode ser desenvolvido por qualquer empresa com conhecimentos da rede e do protocolo usados por um determinado

46 Comunicao

equipamento. Os Tags OPC podem ser importados para o Driver OPC no E3 (o Driver OPC no E3 atua como um cliente OPC), ouainda podem ser criados no E3. Neste caso necessrio conhecer o ItemId de cada Tag.

Objetos disponveis no Servidor OPC

OBJETO DESCRIO Pasta OPC Define grupos ou subdiretrios para a organizao das

variveis . Grupo OPC Agrupa uma srie de Tags OPC que comparti lham os mesmos

parmetros de atua l i zao (tempo de varredura e bandamorta). obrigatrio exis ti r um Grupo OPC para poder criarTags OPC.

Tag OPC Objeto para lei tura ou escri ta de va lores em umequipamento. A lei tura do Tag fei ta automaticamente peloServidor OPC, com tempo de varredura definido no Grupo OPConde ele est inserido.

Bloco OPC Poss ibi l i ta a lei tura ou escri ta de um conjunto de va lores .Para rea l i zar uma escri ta , deve-se apenas atribuir um novovalor propriedade Value.

Elemento de Bloco OPC Poss ibi l i ta a lei tura ou escri ta de um dos Elementos do BlocoOPC onde ele est inserido. O Bloco OPC l uma tabela dedados e este objeto est sempre associado pos iodefinida por sua propriedade Index, correspondendo a umavarivel de interesse.

8.4 Exerccios

8.4.1 Driver de ComunicaoPara comunicar o Elipse Modbus Simulator com o E3 util izado o arquivo de Driver Modbus.dll, disponvel para downloadem www.elipse.com.br.

1. Clique com o boto direito do mouse no item Objetos de Servidor - Drivers e OPC e selecione a opo Inserir Driver deComunicao em TreinamentoE3.prj.

Inserir Driver de Comunicao

2. Selecione o arquivo do Driver (Modbus.dll) na caixa de dilogo para a seleo de arquivos. A janela da figura a seguir aberta para configurao do Driver.

Comunicao 47

Janela de configurao do Driver Modbus

3. Na aba Setup, configure o tempo que o Driver aguarda uma resposta do equipamento no campo Timeout (por exemplo,1000 ms). Selecione, na l ista de opes da propriedade Physical Layer, a interface fsica Ethernet.

Aba Setup

4. Aps selecionar a interface fsica, todas as outras abas so desabil itadas, sendo necessrio apenas configurar ainterface escolhida. Na aba Ethernet, digite o IP do computador que est executando o Simulador. Se o Simulador est nomesmo computador do E3, digite "127.0.0.1".

48 Comunicao

Aba Ethernet

5. No campo Port, digite o nmero da porta de comunicao. Por exemplo, digite "502" para acessar o primeiro CLP doSimulador.

6. Na aba Modbus, selecione o protocolo Modbus TCP no campo Modbus Mode e, no campo Data Address Model Offset,selecione o item Data is address from 1, pois o primeiro endereo do Simulador 1 (um).

Aba Modbus

7. Na aba Operations, verifique o cdigo das operaes para leitura e escrita que so necessrias para as leituras dos

Comunicao 49

registros do CLP:

Registers: Leitura de valores analgicos (Word) atravs da funo Modbus 03 (Read Holding Registers) e para escritaatravs das funes Modbus 06 (Preset Single Registers) ou Modbus 16 (Preset Multiple Registers). A operao 01 executaa leitura Modbus 03 (Read) e escrita Modbus 16 (Write) de valores do tipo Word (Data).

Coils: Leitura de valores digitais (Bit) atravs da funo Modbus 01 e escrita atravs da funo Modbus 05 (Force SingleCoil). No existe na l ista padro uma operao com estas configuraes, portanto necessrio adicionar uma nova.

8. No lado direito da aba Operations, cl ique em Add para criar a operao 08. Selecione a opo 01 na l ista de opes docampo Read e, no campo Write, a opo 05.

Adicionar operao

9. A l ista de operaes disponveis mostrada na figura a seguir.

Lista de operaes

10. Estes cdigos de operao so util izados posteriormente na configurao dos Tags de Comunicao:

Coils: Cdigo de operao 08

Registers: Cdigo de operao 01

11. Aps concluir a configurao, cl ique em OK.

12. Caso precise configurar novamente o Driver, cl ique com o boto direito do mouse no objeto Driver e selecione o item Configurao.

50 Comunicao

Menu Configurao

8.4.2 Tag Browser1. Caso a caixa de dilogo do Tag Browser no abra automaticamente, abra-a clicando em .

2. Na janela Tag Browser, arraste para a esquerda o Bloco de Comunicao IO.IOKitEvent da pasta General. Este Blocoretorna informaes de estado da comunicao.

Comunicao 51

Janela Tag Browser

3. Feche a janela quando terminar de selecionar as variveis desejadas.

8.4.3 Tag de Comunicao1. Clique com o boto direito do mouse no objeto Driver e selecione a opo Inserir - Tag de Comunicao, ou clique em

Adicionar na barra de ferramentas do Driver.

Adicionar Tag de Comunicao

2. A janela de configurao aberta. Informe a quantidade e o nome do Tag de Comunicao (por exemplo, "Estado1").

Configurao do Tag

3. Para configurar os Tags de Comunicao, necessrio preencher as propriedades N1, N2, N3 e N4, conforme asinstrues do manual do Driver Modbus:

N1: Endereo do equipamento escravo (CLP) na rede. Este endereo pode variar entre 1 e 255

N2: Cdigo da operao. Referencia uma operao de leitura ou escrita adicionada na janela de configuraes doDriver

N3: Parmetro adicional

N4: Endereo do Registrador ou da varivel no equipamento escravo (CLP) que se deseja ler ou escrever

52 Comunicao

8.4.3.1 Digital1. Para organizar os Tags, selecione o Driver e insira uma pasta chamada "Digitais".

Adicionar Nova Pasta

2. O primeiro Tag Digital a informao de estado (aberto ou fechado) da Bomba 1. Crie um Tag de Comunicao com onome "Estado_B1" na pasta Digitais.

3. Configure os parmetros N conforme as informaes a seguir:

N1: 1 (Endereo do CLP)

N2: 8 (Cdigo da operao, ou Coil)

N3: 0 (Parmetro adicional)

N4: 1 (Endereo do registrador)

4. Clique com o boto direito do mouse no objeto Driver e selecione o item Ativar Comunicao para testar as configuraes,ou clique em Ativar ou Desativar a Comunicao . Caso as configuraes estejam corretas, a l inha do Tag deve ficar na corazul.

5. Adicionar, na pasta Digitais, os Tags a seguir:

Endereo 2: Estado_B2





Endereo 7: AutoMan_B1






Endereo 13: Defeito_B1






6. Aps a criao dos Tags, teste a comunicao.

Comunicao 53

Ativar a Comunicao

8.4.3.2 Analgico1. Insira uma nova pasta chamada "Analogicas".

2. Na pasta Analogicas, crie os Tags a seguir:

Endereo 1: Temperatura_T1

Endereo 2: Temperatura_T2

Endereo 3: Nivel_T1

Endereo 4: Nivel_T2

3. Configure os parmetros N conforme as informaes a seguir:

N1: 1 (Endereo do CLP)

N2: 1 (Cdigo da operao, ou Register)

N3: 0 (Parmetro adicional)

N4: 1 a 4 (Endereo do registrador)

4. Clique com o boto direito do mouse no objeto Driver e selecione o item Ativar Comunicao para testar as configuraes,ou clique em Ativar ou Desativar comunicao . Caso as configuraes estejam corretas, a l inha do Tag deve ficar na corazul.

8.4.3.3 EscalaO Simulador gera valores analgicos entre 0 e 65535. Desejamos valores em outra faixa, por isto vamos habil itar a funo deescala.

Valores para a funo de escala

ENDEREO NOME MN. UE MX. UE UE MN. E/S MX. E/S1 Temperatura_T1 20 200 C 0 655352 Temperatura_T2 20 200 C 0 655353 Nivel_T1 0 100 % 0 655354 Nivel_T2 0 100 % 0 65535

1. Altere as propriedades dos Tags Analgicos, conforme a figura a seguir.

54 Comunicao

Configurao da escala

2. Teste a comunicao. A coluna Valor j exibe os valores com a escala aplicada e a coluna Valor (sem escala) apresenta osvalores enviados pelo equipamento.

Testando a comunicao


8.5.1 Driver de Comunicao OPCO E3 funciona tanto como servidor quanto como cliente OPC. Assim como no exerccio anterior, este exerccio serve paramostrar como funciona a configurao do Driver OPC, j que semelhante para qualquer servidor OPC que esteja sendoutil izado. O roteiro est descrito nos passos a seguir.

1. Clique com o boto direito do mouse no item Objetos de Servidor - Drivers e OPC e selecione o item Inserir Driver deComunicao OPC em - TreinamentoE3.prj.

2. Clique com o boto direito do mouse no Driver OPC inserido, selecione a opo Propriedades e cl ique na aba OPC Driver.

3. Clique em Selecionar para abrir uma janela com as opes de servidores OPC na mquina local ou na rede. Selecione oElipse OPC Server da mquina do instrutor na opo Servidores na rede e cl ique em OK.

4. Ao voltar janela de propriedades do Driver OPC, clique em Ativar Comunicao. A partir deste ponto, possvel verificara comunicao com o servidor clicando em Informaes.

5. O prximo passo para a configurao a importao de Tags. Feche a janela de propriedades e clique com o boto direitodo mouse no Driver OPC cadastrado e selecione a opo Importar Tags. Com isto, o Assistente de Importao de Tags do E3 aberto.

Comunicao 55

Janela Importao de Tags OPC

6. A figura anterior mostra a aparncia da janela de importao. Do lado direito a l ista de Tags do servidor e do ladoesquerdo, a rea de importao para o E3. Para importar, primeiro ajuste os fi ltros, selecione o item e arraste-o at oGrupo OPC de destino.

7. Depois de importar alguns Tags ou propriedades, verifique o funcionamento dos Tags importados.

8. Assim como no caso da configurao de Drivers da Elipse, o roteiro para trabalhar com o servidor OPC da Elipse omesmo para qualquer servidor que seja util izado.

8.5.2 KBKB-14918: Contagem de Tags no Driver de Comunicao

56 Introduo aos Scripts

9 Introduo aos ScriptsCAPTULO

Os Scripts so trechos de cdigo (programao) com os quais se pode criar procedimentos associados a eventos especficos,permitindo grande flexibil idade no desenvolvimento e no uso de aplicaes. Todos os scripts esto associados a eventos, ecada objeto do E3 possui uma lista de eventos previamente definidos, sendo possvel tambm definir novos eventos deusurio.

De acordo com os conceitos da programao orientada a objetos, as Propriedades definem atributos de um objeto, como aaparncia de um controle de Tela ou o valor inicial de um objeto quando se inicia o aplicativo.

NOTA: Es tamos trabalhando at agora apenas com propriedades no E3. J conhecemos a lgumas propriedades dos objetos doE3 e vimos que temos duas maneiras de a l ter-las : na Janela de Propriedades ou por Associaes .

Os Mtodos so funes previamente definidas, que executam determinadas aes sobre as propriedades do objeto quechama estas aes. Exemplos disto so funes para realizar a escrita em Tags (Write ou WriteEx), entre outras. Emlinguagens de programao orientadas a objeto, para agir sobre uma propriedade necessria a criao de mtodos. No E3,para cada mtodo desejado, necessrio definir a qual evento ele est associado, pois os scripts do E3 so orientados aeventos.

Os Eventos so ocorrncias relacionadas a um objeto, que podem ser tratadas de modo a se realizar uma ao (um mtodo).

9.1 Definindo ScriptsA linguagem que o E3 Studio usa em seus scripts o VBScript, um subconjunto da l inguagem Visual Basic desenvolvida pelaMicrosoft. O VBScript possui um interpretador rpido, leve e portvel, desenvolvido para o uso em navegadores para aInternet e outras aplicaes que usam ActiveX Controls, Automation Servers e Java Applets. Os scripts so sempre associados aeventos de um determinado objeto. Entretanto, para facil itar e aumentar a velocidade de desenvolvimento, o E3 j incorporaalgumas aes mais comuns que podem ser realizadas com scripts atravs de assistentes (wizards) chamados Picks. Pode-sedefinir que um determinado evento executa um script, um Pick ou uma combinao deles, em uma sequncia definida durantea criao do script (no E3 Studio).

9.1.1 PicksOs Picks implementam uma forma amigvel de realizar procedimentos comuns em scripts, poupando tempo de escrita decdigo. Entre eles esto aes como troca de Tela ou atribuio de valores, que so bastante comuns na criao de umprojeto.

Introduo aos Scripts 57

9.1.1.1 Executar ScriptsPermite a edio de um script personalizado que executado na ocorrncia do evento determinado.

Pick Executar Script

9.1.1.2 Abrir TelaAbre uma determinada Tela ou Quadro.

Pick Abrir Tela


9.1.1.3 Abrir Tela ModalAbre uma Tela em estilo modal.

Pick Abrir Tela Modal

9.1.1.4 Executar AplicaoExecuta um programa especfico.

Pick Executar Aplicao


9.1.1.5 Carregar ValorCarrega um valor em um Tag.

Pick Carregar Valor

9.1.1.6 Inverter ValorPermite mudar o valor de um Tag. Se o valor do Tag for igual a Valor1, ento o Tag recebe Valor2. Se o valor do Tag for iguala Valor2, ento o Tag recebe Valor1. Se o valor do Tag no for igual nem a Valor1 nem a Valor2, o Tag recebe Valor1.


Pick Inverter Valor

9.1.1.7 Imprimir RelatrioPermite imprimir um Relatrio em uma Tela ou em uma impressora.

Pick Imprimir Relatrio


9.2 EventosOs Eventos so ocorrncias relacionadas a um objeto, que disparam aes programadas. Basicamente so dois tipos deeventos: Fsicos (ou externos) e Internos.

Eventos fsicos so, por exemplo, aes no teclado ou no mouse. Neste caso, a informao relevante a tecla pressionada ou aposio do cursor e o status dos botes. Eventos internos so, por exemplo, a mudana de uma temperatura de uma cmarade 10 para 11 graus Celsius.

No E3, h uma lista disponvel de eventos classificada por objetos, iniciando pelos eventos padro, presentes em todos osobjetos. Estes eventos so acessados atravs da aba Scripts, que pode ser consultada atravs das propriedades do objeto parao qual se deseja criar o script.

Lista de eventos

9.2.1 Eventos Definidos pelo UsurioApesar de o E3 vir com uma extensa gama de eventos, muitas vezes o usurio necessita criar um evento especfico para aaplicao. Um exemplo para a util izao de eventos definidos pelo usurio a realizao de um clculo (ou tarefa maiscomplexa) em um objeto, quando o evento gerador vem de outro Tag ou propriedade.

possvel a criao de eventos personalizados definidos pelo usurio atravs da opo Criar novo evento na l ista de eventosou ao clicar em Criar evento do usurio .


Criar evento do usurio

9.3 MtodosOs Mtodos so procedimentos que podem ser executados por objetos. Por exemplo, o objeto Tela tem um mtodo para aadio de objetos (AddItem) e outro para o seu fechamento (Close). Por estarem encapsulados, isto , guardados dentro dosobjetos, na chamada de um mtodo sempre deve constar a qual objeto este mtodo se refere.

Muitos mtodos pr-definidos possuem parmetros, que podem (ou devem) ser passados na sua chamada. Para isto, oVBScript possui uma regra que deve ser seguida. Se o mtodo for util izado em uma atribuio, seus parmetros devem estarentre parnteses. Os parnteses usados nas citaes de mtodos neste Tutorial servem apenas como indicativo paradiferenci-los das propriedades. Nos scripts, deve-se seguir esta regra.

AppBrowser

9.4 PropriedadesTodo objeto possui Propriedades que guardam informaes a respeito de suas caractersticas. Por exemplo, um objeto do tipoRetngulo possui a propriedade Name, que contm seu nome e as propriedades Width e Height, que guardam sua largura ealtura, respectivamente, entre outras. Para acessar as propriedades, proceda como no tpico Mtodos, porm selecione apasta Propriedades no AppBrowser.

9.5 Exerccios


9.5.1 Pick Abrir TelaVamos implementar a navegao entre as Telas da aplicao. A TelaInicial deve abrir o Quadro1 e cada boto naTelaMenu deve abrir sua respectiva Tela no Quadro Area_Central ou em tela cheia.

1. Configure a TelaInicial para ser a primeira Tela da aplicao. Isto pode ser feito de duas formas:

Ajustando a Tela ao Divisor _top e selecionando a opo Configurar como Tela inicial do Divisor

Selecionando a TelaInicial no item Tela ou Quadro inicial da janela de propriedades do Viewer

2. Na TelaInicial, selecione o texto "Entrar" e selecione a aba Scripts.

3. No evento Click, crie um novo script do tipo Abrir Tela.

4. No campo Abrir a Tela, selecione o item Quadro1.

5. Deixe a opo No Quadro em branco.

9.5.2 Pick ScriptNa TelaInicial pode-se fechar a aplicao ao clicar no texto "Sair".

1. Na TelaInicial, crie um novo Pick do tipo Script no texto "Sair".

Pick Script

2. Com o auxl io do AppBrowser , selecione o mtodo Exit do Viewer e clique em Colar.Application.Exit

3. Execute a aplicao e teste as novas funcionalidades.

9.5.3 Tela Menu1. Insira um objeto Command Button e, na sua propriedade Caption, digite o texto "Inicial".

2. Crie um script no evento Click para abrir a TelaInicial ocupando toda a rea (tela cheia).

Abrir Tela Inicial

3. Crie um segundo boto para abrir a TelaSinotico no Quadro Area_Central.


Abrir Tela Sintico


9.6.1 KBKB-25172: Teclas de atalho no E3

Segurana e Usurios 65

10Segurana e UsuriosCAPTULO

O E3 possui um controle de acesso s Telas, aos Alarmes e aos Domnios em uma lista de usurios, onde para cada nome atribuda uma senha e um login. Conforme a opo configurada, uma aplicao permite acesso aos usurios cadastrados ouacesso i l imitado s Telas do projeto.

10.1 UsuriosAtravs da opo Usurios possvel configurar as informaes referentes aos usurios que tm ou no acesso aplicao.Para util izar este recurso, selecione o menu Arquivo - Usurios e cl ique na aba Usurios.

Aba Usurios

IMPORTANTE: Aps configurar a segurana, somente os usurios l i s tados tm acesso apl icao.

10.2 GruposA opo Grupos permite que sejam criados grupos com caractersticas que so comuns para todos os seus membros(usurios). Um grupo tambm pode pertencer a outros grupos. S no permitido pertencer a outro g

e3tutorial Developer Ptb

Documents

Transcript of e3tutorial Developer Ptb