e3tutorial beginner ptb

150
Copyright © 2014 Elipse Software Ltda. Todos os direitos reservados. Versão 4.5 (23/01/2014) Tutorial do E3 para Iniciantes

Upload: aldair-fontes

Post on 09-Jun-2015

137 views

Category:

Devices & Hardware


1 download

DESCRIPTION

Esta apostila mostra as principais ferramentas do ELIPSE E3

TRANSCRIPT

Page 1: E3tutorial beginner ptb

Copyright © 2014 Elipse Software Ltda. Todos os direitos reservados. Versão 4.5 (23/01/2014)

Tutorial do E3 para Iniciantes

Page 2: E3tutorial beginner ptb
Page 3: E3tutorial beginner ptb

Sumário..................................................................................................................................................................... 51 Apresentação

............................................................................................................................................................... 51.1 A Elipse

............................................................................................................................................................... 51.2 Módulos do E3

............................................................................................................................................................... 51.3 O Treinamento

............................................................................................................................................................... 81.4 Anotações

..................................................................................................................................................................... 92 Elipse Knowledgebase

............................................................................................................................................................... 92.1 Elipse Knowledgebase

............................................................................................................................................................... 92.2 Busca no Knowledgebase

............................................................................................................................................................... 102.3 Categorias

............................................................................................................................................................... 122.4 Anotações

..................................................................................................................................................................... 133 Iniciando a Aplicação

............................................................................................................................................................... 133.1 Criando sua Aplicação

............................................................................................................................................................... 163.2 Execução de um Domínio

............................................................................................................................................................... 163.3 Exercícios

............................................................................................................................................................... 203.4 Exercícios Complementares

............................................................................................................................................................... 213.5 Anotações

..................................................................................................................................................................... 224 Telas e Objetos de Tela

............................................................................................................................................................... 224.1 Tela

............................................................................................................................................................... 234.2 Controles Microsoft Forms

............................................................................................................................................................... 234.3 Galeria

............................................................................................................................................................... 244.4 Exercícios

............................................................................................................................................................... 304.5 Exercícios Complementares

............................................................................................................................................................... 314.6 Anotações

..................................................................................................................................................................... 325 Introdução aos Scripts

............................................................................................................................................................... 325.1 Definindo Scripts

............................................................................................................................................................... 375.2 Eventos

............................................................................................................................................................... 385.3 Métodos

............................................................................................................................................................... 395.4 Propriedades

............................................................................................................................................................... 395.5 Exercícios

............................................................................................................................................................... 415.6 Anotações

..................................................................................................................................................................... 426 Simulação de Valores

............................................................................................................................................................... 426.1 Servidor de Dados

............................................................................................................................................................... 426.2 Regras para Nomes de Tags

............................................................................................................................................................... 426.3 Exercícios

............................................................................................................................................................... 466.4 Anotações

..................................................................................................................................................................... 477 Associações

............................................................................................................................................................... 477.1 Tipos de Associações

............................................................................................................................................................... 507.2 Edição de Associações

............................................................................................................................................................... 517.3 Valores Booleanos

............................................................................................................................................................... 517.4 Exercícios

............................................................................................................................................................... 567.5 Anotações

..................................................................................................................................................................... 578 Gráficos e E3Chart

............................................................................................................................................................... 578.1 Configurações das Penas

............................................................................................................................................................... 588.2 Exercícios

............................................................................................................................................................... 628.3 Exercícios Complementares

............................................................................................................................................................... 638.4 Anotações

..................................................................................................................................................................... 649 Estrutura de Telas e Quadros

............................................................................................................................................................... 649.1 Viewer

............................................................................................................................................................... 669.2 Exercícios

............................................................................................................................................................... 719.3 Anotações

..................................................................................................................................................................... 7210 Segurança

Page 4: E3tutorial beginner ptb

............................................................................................................................................................... 7210.1 Usuários

............................................................................................................................................................... 7210.2 Grupos

............................................................................................................................................................... 7310.3 Permissões

............................................................................................................................................................... 7410.4 Proteção

............................................................................................................................................................... 7510.5 Exercícios

............................................................................................................................................................... 7810.6 Anotações

..................................................................................................................................................................... 7911 Comunicação

............................................................................................................................................................... 7911.1 Elipse Modbus Simulator

............................................................................................................................................................... 8011.2 Driver de Comunicação

............................................................................................................................................................... 8111.3 Driver de Comunicação OPC

............................................................................................................................................................... 8211.4 Exercícios

............................................................................................................................................................... 9011.5 Exercícios Complementares

............................................................................................................................................................... 9111.6 Anotações

..................................................................................................................................................................... 9212 Bibliotecas ElipseX

............................................................................................................................................................... 9212.1 Criação de Bibliotecas do Usuário

............................................................................................................................................................... 9512.2 Quando Criar um ElipseX

............................................................................................................................................................... 9512.3 Exercícios

............................................................................................................................................................... 10712.4 Anotações

..................................................................................................................................................................... 10813 Alarmes

............................................................................................................................................................... 10813.1 Servidor de Alarmes

............................................................................................................................................................... 10813.2 Configuração de Alarmes

............................................................................................................................................................... 11113.3 E3Alarm

............................................................................................................................................................... 11213.4 Exercícios

............................................................................................................................................................... 11613.5 Anotações

..................................................................................................................................................................... 11714 Armazenamento de Dados

............................................................................................................................................................... 11714.1 Banco de Dados

............................................................................................................................................................... 11714.2 Históricos

............................................................................................................................................................... 11814.3 Exercícios

............................................................................................................................................................... 12214.4 Exercícios Complementares

............................................................................................................................................................... 12314.5 Anotações

..................................................................................................................................................................... 12415 Consultas

............................................................................................................................................................... 12415.1 Criando uma Consulta

............................................................................................................................................................... 12515.2 E3Browser

............................................................................................................................................................... 12615.3 Exercícios

............................................................................................................................................................... 13015.4 Anotações

..................................................................................................................................................................... 13116 Relatórios

............................................................................................................................................................... 13216.1 Objetos do Relatório

............................................................................................................................................................... 13316.2 Exercícios

............................................................................................................................................................... 13816.3 Anotações

..................................................................................................................................................................... 13917 Exercícios de Revisão

............................................................................................................................................................... 13917.1 Exercício

............................................................................................................................................................... 14117.2 Resolução

............................................................................................................................................................... 14917.3 Anotações

Page 5: E3tutorial beginner ptb

Apresentação 5

1 ApresentaçãoCAPÍTULO

Este Tutorial serve como apoio ao módulo de treinamento para execução e programação do E3. Com ele, você acompanhará oconteúdo do curso. Durante as aulas, fique à vontade para praticar o que você aprendeu e para resolver suas dúvidas com oinstrutor. No treinamento, é apresentado um estudo de caso que simula uma aplicação real, um sistema de supervisão econtrole.

1.1 A ElipseA Elipse Software é uma empresa genuinamente brasileira, com foco na produção de software de supervisão para automaçãoindustrial, surgida em Porto Alegre no início dos anos 90.

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

Em 1996, a Elipse lançou a primeira versão do Elipse Windows, que mais tarde se tornaria o Elipse SCADA. Desde esta época,foram instaladas milhares de cópias deste software no Brasil.

Em 2000, a Elipse iniciou o desenvolvimento do E3, a terceira geração de software de supervisão da empresa. Desde seulançamento comercial em 2001, milhares de l icenças deste software já foram instaladas e o E3 vem sendo util izado emsistemas diversos, como Centros de Operação de empresas elétricas, plantas industriais de diversas finalidades, sistemas detelemedição e controle de energia, automação e controle predial, mineração, entre outros.

A Elipse Software trabalha em parceria com distribuidores internacionais localizados em países estratégicos como Alemanha,Holanda, Taiwan, Índia, Canadá e outros, além de manter escritório próprio nos Estados Unidos, na cidade de Avon, Carolinado Norte.

1.2 Módulos do E3Inicialmente, será visto que o E3 é composto de quatro módulos, descritos a seguir.

1.2.1 E3 ServerÉ o Servidor de Aplicações, onde os principais processos são executados, incluindo a comunicação em tempo real com osequipamentos de controle. O servidor também é responsável por enviar dados e Telas aos clientes conectados em qualquerparte da rede (Intranet e Internet). O servidor pode executar vários projetos ao mesmo tempo e conversar com outros E3Servers para realizar um failover (standby) ou distribuir cargas de processamento entre as máquinas. Foi desenvolvido paraser executado sobre os sistemas operacionais Windows XP SP3, Windows XP x64 SP2, Windows Server 2003 SP2, WindowsVista SP2, Windows Server 2008 SP2, Windows Server 2008 R2 SP1, Windows 7 SP1, Windows 8, Windows 8.1, WindowsServer 2012 e Windows Server 2012 R2.

1.2.2 E3 StudioFerramenta única de configuração, agindo como plataforma universal de desenvolvimento, que possui um ambiente modernoe amigável, incluindo um completo editor gráfico e de scripts (VBScript). Permite que um projeto seja editado por váriaspessoas ao mesmo tempo ou que vários E3 Studios estejam conectados ao mesmo servidor remoto, com múltiplasconfigurações.

1.2.3 E3 ViewerO Viewer permite operar as aplicações residentes no servidor em qualquer computador com o programa executável Viewer(Windows XP, Windows 2003, Windows Vista, Windows 7, Windows 8 e Windows 8.1) ou com um navegador de Internet. Emambos os casos, não é necessário instalar a aplicação na máquina cliente, pois todos os componentes (Telas, Bibliotecas econtroles ActiveX) serão baixados e registrados automaticamente.

1.2.4 E3 AdminÉ o módulo responsável pela interface do E3 Server e de outros módulos do E3 com o usuário. Através dele o usuário podeenviar comandos ao E3 Server, util izando o ícone na Área de Notificação do Windows, e controlar o Domínio pela l inha decomando.

1.3 O TreinamentoA sequência de aprendizado a ser seguida neste Tutorial reflete o que a Elipse Software considera o conjunto de melhorespráticas no desenvolvimento de aplicativos de supervisão e controle, tanto para o E3 (o objeto de estudo deste Tutorial)quanto para o Elipse SCADA ou outros softwares de supervisão.

Page 6: E3tutorial beginner ptb

6 Apresentação

A base do roteiro deste manual é uma aplicação hipotética, que apresenta os recursos mais importantes do software E3. Essaaplicação hipotética não cobre todas as possibil idades de desenvolvimento oferecidas pela ferramenta. No entanto, aquantidade e qualidade das informações apresentadas neste primeiro contato com o software são suficientes para que vocêaprenda a util izá-lo com autonomia para criar suas próprias aplicações.

1.3.1 Aplicação de TreinamentoNo treinamento é apresentado um estudo de caso que simula uma aplicação real, um sistema de supervisão e controle. Oinstrutor desenvolve a aplicação junto com os alunos passo-a-passo, facil itando o entendimento e aprendizado daferramenta.

O sistema em questão apresenta um sinótico de uma usina de açúcar, exemplificando vários aspectos e recursos disponíveisno Elipse E3. O sistema monitora a pressão, vazão e vapor da caldeira, assim como o nível e três temperaturas do processo. Ooperador do sistema pode visualizar as temperaturas e informações da caldeira e controlar o funcionamento do motor.

Sinótico de uma usina de açúcar

O sistema também mostrará condições de alarme no caso de algum parâmetro ultrapassar os l imites estabelecidos (comopor exemplo, um aumento excessivo de temperatura) além de criar gráficos de tendência das variáveis.

Condições de alarme

Na Tela de cristalização é possível enviar comandos aos equipamentos de campo.

Page 7: E3tutorial beginner ptb

Apresentação 7

Tela de cristalização

Finalmente, um procedimento de consulta dos alarmes, que permite visualização e impressão dos dados de históricos.

Visualização e impressão de dados históricos

Sua participação é muito importante para nós. Ao final do treinamento, será solicitado que você avalie diversos aspectos docurso, como a qualidade e a quantidade das informações transmitidas em aula e pelo Tutorial, além do trabalho do instrutore a qualidade das instalações. Qualquer sugestão ou crítica é bem-vinda pela equipe de desenvolvimento deste Tutorial.

A Elipse Software deseja a você um ótimo treinamento, e uma boa experiência de trabalho com o E3!

Page 8: E3tutorial beginner ptb

8 Apresentação

1.4 Anotações

Page 9: E3tutorial beginner ptb

Elipse Knowledgebase 9

2 Elipse KnowledgebaseCAPÍTULO

O Elipse Knowledgebase tem como finalidade ajudar o usuário dos softwares da Elipse a encontrar respostas rápidas paradúvidas ou problemas que esteja enfrentando durante a sua util ização. Seja no desenvolvimento de aplicações ou depois detê-las prontas. Este espaço nada mais é do que um portal onde muitas informações técnicas e dicas estão concentradas. A suabase de informações é constantemente atualizada e tem uma linguagem simples que visa o rápido entendimento de quem estáutil izando.

Após acessar o endereço kb.elipse.com.br, você estará na página inicial.

Página inicial do KB

2.1 Elipse KnowledgebaseNo cabeçalho da página existem as seguintes opções:

Glossário: permite acessar todo o glossário de palavras que a ferramenta possui

Favoritos: link que mostra todos os artigos da base de dados que estão assinalados como favoritos

Login: serve apenas para uso da Elipse

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

Busca no KB

Ainda existe a possibil idade de util izar a Busca Avançada, que permite refinar a consulta. Basta acessar a opção BuscaAvançada.

Page 10: E3tutorial beginner ptb

10 Elipse Knowledgebase

Busca Avançada

Na opção Busca Avançada o usuário pode digitar a palavra ou palavras que deseja buscar, fi ltrar por categoria específica,autor e ainda pela classificação do artigo. Isto é, se ele ajudou muito, apenas ajudou, não ajudou ou ajudou pouco.

2.3 CategoriasExiste a possibil idade de o usuário acessar todos os artigos escolhendo diretamente a categoria a que ele pertence. Para isto,no campo Categorias, basta selecionar a categoria em que se deseja buscar os artigos e então clicar em Ir.

Escolha de categorias

Todos os artigos desta categoria serão retornados como resultado da busca. É importante ressaltar que toda a base deconhecimento está dividida em duas categorias principais, Inglês e Português. Dentro delas existem as categorias Elipse E3,Elipse SCADA, Elipse 21 DOS, Elipse Drivers OPC, Altus TCP/IP e Drivers. Dentro destas cinco categorias existem diversas outras,cada uma delas tratando de um tema específico. Acessando os artigos pela categoria Português - Elipse E3 tem-se:

Categorias em português

Page 11: E3tutorial beginner ptb

Elipse Knowledgebase 11

Note que dentro de cada uma destas subcategorias aparece um número. Este número indica a quantidade de artigos existentesdentro da categoria.

As demais seções existentes na página principal do Knowledgebase são:

Artigos Em Destaque: Mostra todos os artigos que estão classificados para aparecerem em destaque. Normalmente estaseção é util izada para ressaltar algum artigo que merece uma atenção especial por parte dos usuários dos softwares daElipse

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

Page 12: E3tutorial beginner ptb

12 Elipse Knowledgebase

2.4 Anotações

Page 13: E3tutorial beginner ptb

Iniciando a Aplicação 13

3 Iniciando a AplicaçãoCAPÍTULO

Após instalar o software, você terá em sua máquina um grupo de programas chamado Elipse E3, com um ícone para abrir oE3 Studio. Quando o E3 é iniciado, abre-se uma caixa de diálogo com algumas opções do projeto.

Caixa de diálogo inicial do E3 Studio

As opções disponíveis são:

Opções disponíveis na caixa de diálogo inicial do E3

OPÇÃO DESCRIÇÃO

Iniciar o E3 Studio Inicia o E3 Studio, mas não abre nenhum Domínio.

Criar um Domínio novo Cria um novo Domínio através do Ass is tente de apl icações doE3. Serão requis i tados o nome e caminho do novo Domínio.

Abrir um Domínio existente Abre um Domínio exis tente dentre os úl timos edi tados .Cl icando em Outros arquivos, pode-se loca l i zar um Domínio emum diretório específico.

3.1 Criando sua AplicaçãoPara criar uma nova aplicação, util ize o Assistente de Aplicações. Para abri-lo, cl ique em Novo na barra de ferramentasPadrão.

Page 14: E3tutorial beginner ptb

14 Iniciando a Aplicação

Assistente de Aplicações

O E3 trabalha com três tipos de arquivos de projeto, descritos a seguir.

3.1.1 ProjetosContêm definições de objetos, Tags, Telas e outros componentes de uma aplicação. Os arquivos *.prj são criados através dasopções Aplicação Padrão e Aplicação em Branco. A primeira opção cria um projeto pré-configurado com alguns objetos básicose um assistente de criação de projeto, enquanto que a segunda opção cria um projeto vazio a ser implementado pelo usuário.

3.1.2 BibliotecasContêm definições de objetos criados pelo usuário (ElipseX) para serem util izados em projetos. Estas bibliotecas podem serreutil izadas em diferentes projetos, mas mantêm vínculos com a aplicação. Ou seja, se a biblioteca for alterada, todos osobjetos desta biblioteca serão atualizados nos projetos automaticamente.

3.1.3 Configuração do DomínioArmazena quatro tipos de informações:

Opções de configuração do Domínio

Lista de arquivos *.prj e *.l ib

Configurações dos servidores que irão rodar o Domínio

Configurações de segurança (usuários e permissões)

Sem este arquivo, um projeto não pode ser executado no E3. Este item será visto mais adiante.

3.1.4 OrganizerO Organizer permite uma visão simples e organizada de toda a aplicação, ajudando na edição e configuração de todos osobjetos envolvidos na aplicação através de uma árvore hierárquica de opções. Possui dois modos de visualização, Domínio eExplorer.

Page 15: E3tutorial beginner ptb

Iniciando a Aplicação 15

Janela do Organizer em modo Domínio

O modo Domínio mostra apenas as informações dos objetos abertos pertencentes ao Domínio, organizadas em quatrogrupos, Configuração, Bibliotecas de Objetos, Visualização e Objetos de Servidor.

O modo Explorer mostra projetos e bibliotecas abertos no E3 Studio, pertencentes ou não ao Domínio. Os objetos sãomostrados 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 a sua configuração deforma simples e rápida. Sempre que uma propriedade for configurada na Lista de Propriedades, seu valor não será mudadoautomaticamente, a menos que se crie uma Associação (que será vista adiante). A Lista de Propriedades pode ser aberta pelo

menu Visualizar - Lista de Propriedades ou clicando em na Barra de Ferramentas.

Lista de propriedades

Page 16: E3tutorial beginner ptb

16 Iniciando a Aplicação

3.2 Execução de um DomínioPara executar ou visualizar um projeto no E3, é necessário que o Domínio seja colocado em execução. Para isso, existem asseguintes opções no E3 Studio:

Executar aplicativo: Salva todas as configurações dos projetos e bibliotecas, inicia a execução do Domínio e executa oViewer

Rodar/Parar Domínio: Inicia ou para a execução do Domínio

Executar/Parar o E3 Viewer: Executa ou para a execução do Viewer

3.3 Exercícios

3.3.1 Domínio1. Inicie o E3 Studio selecionando a opção Criar um Domínio novo.

Criar Novo Domínio

2. O Assistente de Aplicações é aberto.

Page 17: E3tutorial beginner ptb

Iniciando a Aplicação 17

Assistente de Aplicações

3. No Assistente de Aplicações, cl ique em Avançar, selecione a opção Aplicação padrão e nomeie o projeto comoTreinamentoE3.

Aplicação Padrão

4. Ajuste o caminho da aplicação para C:\TreinamentoE3 e clique em Avançar.

5. Na próxima janela do Assistente, selecione a opção Criar um novo Domínio e use o mesmo nome do projeto.

Page 18: E3tutorial beginner ptb

18 Iniciando a Aplicação

Criar novo Domínio

6. Selecione a resolução das telas da aplicação e clique em Avançar.

Resolução do Viewer

7. Responda Não à pergunta Você deseja comunicar com um dispositivo/equipamento?. Este tema será trabalhado em umcapítulo posterior.

Page 19: E3tutorial beginner ptb

Iniciando a Aplicação 19

Driver de Comunicação

8. Responda Sim à pergunta Você quer guardar dados em disco?. O nome do arquivo de banco de dados é selecionadoautomaticamente para o mesmo diretório do projeto.

Banco de Dados

9. Responda Sim à pergunta Você deseja monitorar alarmes em sua aplicação?. Selecione a opção Desejo guardar os dadosdos alarmes em disco.

Page 20: E3tutorial beginner ptb

20 Iniciando a Aplicação

Alarmes

10. Clique em Concluir para gerar a aplicação.

Conclusão

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

3.4 Exercícios Complementares

3.4.1 KBKB-28984: Tempo de execução util izando apenas l icença de Studio

Page 21: E3tutorial beginner ptb

Iniciando a Aplicação 21

3.5 Anotações

Page 22: E3tutorial beginner ptb

22 Telas e Objetos de Tela

4 Telas e Objetos de TelaCAPÍTULO

Telas são janelas para monitoramento de processos, onde são inseridos objetos que fazem a interface do operador com osistema. Cada aplicação pode ter um número i l imitado de Telas.

Os Objetos de Tela são elementos gráficos 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 através do menu Objetos.

Uma vez selecionado o objeto que se deseja criar, mantenha o botão esquerdo do mouse pressionado na área da Telaenquanto movimenta o mouse (um retângulo pontilhado mostra o tamanho e a forma do objeto). Ao soltar o botão, o objeto éposicionado dentro da área especificada.

4.1 TelaA Tela é o objeto básico de interface com o usuário. Nela pode-se inserir os seguintes objetos:

Primitivas do editor gráfico (retas, círculos, retângulos, polígonos, etc.)

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

Controles ActiveX fornecidos por terceiros

Imagens não vetoriais (arquivos BMP, JPG, GIF, etc.)

Imagens vetoriais (arquivos WMF, EMF, etc.)

Controles padrão do Windows (Lista, Editor de Texto, Lista de Seleção, etc.)

Bibliotecas gráficas do E3 (XControls), compostas de quaisquer objetos descritos anteriormente

As Telas util izam como padrão para o tamanho e coordenadas as unidades Himetric, dadas em 1/100 mm, não 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, sendo a origem dada pelo canto superior esquerdo da Tela.

As Telas podem ser abertas em modo Full-Screen, ocupando toda a área do Viewer, ou ainda como Telas modais, ocupandosomente o tamanho de suas coordenadas de altura e largura.

Área de edição da Tela

Page 23: E3tutorial beginner ptb

Telas e Objetos de Tela 23

4.2 Controles Microsoft FormsOs objetos ActiveX são componentes de software baseados na tecnologia COM (Component Object Model) da Microsoft. O E3instala e util iza os controles Microsoft Forms, que são objetos ActiveX criados pela Microsoft. Eles podem ser inseridos nasTelas da aplicação para realizar diversas tarefas. A tabela à seguir contém a descrição dos objetos Microsoft Formsdisponíveis no E3.

Controles Microsoft Forms

ÍCONE OBJETO DESCRIÇÃOCaixa de Seleção (Check Box) Uti l i zado para dar ao usuário uma

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

Botão de Opções (Option Button) Uti l i zado para mostrar se um i temindividual de um grupo estáselecionado.

Botão de Comando (Command Button) Uti l i zado para executar uma açãoespecífica ao press ioná-lo.

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

Li s ta (Li s t Box) Exibe uma l i s ta de va lores .

Barra de Rolagem (Scrol l Bar) Retorna ou define o va lor dapropriedade de outro objeto, de acordocom a pos ição da ca ixa de rolagem.

Botão Incremento-Decremento (SpinButton)

Uti l i zado para incrementar edecrementar um va lor.

Edi tor de Texto (Text Box) Uti l i zado para exibi r informaçõesdigi tadas pelo usuário na Tela .

Botão Liga-Des l iga (Toggle Button) Semelhante ao Botão de Comando,porém necess i ta um segundo comandodo usuário para vol tar ao estado normal .

Li s ta de Seleção (Combo Box) Combina os recursos de uma Lis ta e deum Editor de Texto. O usuário podedigi tar um novo va lor ou selecionar umvalor exis tente.

NOTA: Outros objetos ActiveX de tercei ros também podem ser uti l i zados no E3, desde que sejam devidamente regis trados . Elespodem ser adicionados através do menu Ferramentas - Adicionar ActiveX.

4.3 GaleriaA Galeria é uma biblioteca de símbolos vetoriais, divididos em categorias, que podem ser arrastados para as Telas.

Depois de inserido, o objeto pode ser l ivremente editado e trabalhado de acordo com as características descritas para osobjetos de imagem (pode-se, por exemplo, mudar a cor de preenchimento através das propriedades OverrideFillMode,OverrideFillColor e OverrideLineColor, sem a necessidade de transformar o objeto em um objeto gráfico do E3).

Além da biblioteca de símbolos, a Galeria também mostra os XControls pertencentes às bibliotecas do Domínio corrente.

Page 24: E3tutorial beginner ptb

24 Telas e Objetos de Tela

Galeria

NOTA: Ao executar o E3 Studio em modo Demo (sem l icença), apenas o primeiro elemento de cada conjunto de categorias des ímbolos está disponível .

4.4 Exercícios

4.4.1 TelaInicialA TelaInicial será a primeira Tela a ser exibida ao executar o projeto.

TelaInicial

Page 25: E3tutorial beginner ptb

Telas e Objetos de Tela 25

4.4.1.1 Cor de Fundo

1. Na Lista de Propriedades, selecione a cor de sua preferência na propriedade BackgroundColor.

Propriedade BackgroundColor

2. Se preferir aplicar um estilo de preenchimento à Tela, cl ique em Estilo de Preenchimento na barra de ferramentasDesenho.

4.4.1.2 Texto

1. Na barra de ferramentas Objetos, selecione o objeto Texto e clique na posição em que deseja escrever na Tela. Quandoaparecer o cursor, digite o texto "Treinamento Elipse Software" e tecle ENTER.

2. Selecione o objeto Texto e formate-o util izando a barra de ferramentas Formatação.

Formatação

4.4.2 Figuras ExternasTodas as figuras util izadas nesta aplicação serão salvas em uma pasta dentro do projeto principal, para que não sejanecessário preocupar-se com os caminhos das figuras ao executar a aplicação em outro computador.

1. Clique com o botão direito do mouse em Recursos e selecione o item Inserir Recurso em - TreinamentoE3.prj.

Page 26: E3tutorial beginner ptb

26 Telas e Objetos de Tela

Inserir Recurso

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

3. Na Galeria, selecione o grupo Recursos de Projetos. Arraste a imagem E3Logo para a Tela.

4. Para executar a aplicação, cl ique em Executar Aplicativo na barra de ferramentas Padrão.

4.4.3 Inserir Nova Tela1. Clique com o botão direito do mouse na pasta Telas e selecione a opção Inserir Tela em - TreinamentoE3.prj.

Inserir Tela

2. Na janela de configuração da nova Tela, digite "TelaCaldeira" no campo Nome.

Page 27: E3tutorial beginner ptb

Telas e Objetos de Tela 27

Configurar nova Tela

4.4.4 TelaCaldeiraVamos trabalhar a Tela principal da aplicação.

TelaCaldeira

Imagem de fundo

1. Configure a propriedade FillStyle para 12 - Picture, de forma a habil itar uma figura de fundo.

2. Para colocar a figura FundoCaldeira como fundo, arraste o bitmap de Recursos até a propriedade PictureFile da Tela. Istofaz com que o E3 util ize o recurso inserido e não o arquivo da imagem (que é externo à aplicação). Para escolher a melhorposição da figura, pode-se alterar a propriedade PicturePosition.

Imagem da Galeria

1. A partir da biblioteca de objetos gráficos (Galeria), arraste a primeira figura (caminhão) da pasta Vehicles e posicione-ano canto inferior direito da Tela.

Caminhão

Page 28: E3tutorial beginner ptb

28 Telas e Objetos de Tela

2. Na pasta Motors da Galeria, arraste a primeira figura (3DISAMotor1) para o canto direito da Tela.

3. Como a figura é uma imagem da Galeria, para alterar a cor deve-se primeiro alterar a propriedade OverrideFillMode para2 - SolidFill. Escolha a cor que desejar na propriedade OverrideFillColor.

Propriedade OverrideFillColor

4.4.4.1 Retângulo

1. Desenhe um retângulo sobre um dos tanques.

Retângulo

2. Para simular o preenchimento por um líquido, altere a propriedade VerticalPercentFill para 20. O retângulo serápreenchido apenas 20%.

3. A cor de fundo do retângulo é configurada na propriedade BackgroundColor. Altere-a para cinza.

4. A cor de preenchimento é configurada na propriedade ForegroundColor. Altere-a para a cor de sua preferência.

4.4.4.2 Display

1. Crie um objeto Texto com a propriedade Value igual a "Pressão", outro com a propriedade Value igual a "Vapor" e umterceiro com a propriedade Value igual a "Vazão", sobre o tanque da direita.

2. Abaixo de cada objeto Texto, insira um objeto Display . Este objeto exibe o valor real das informações.

Display

3. Para exibir um valor inicial no Display, selecione o objeto e localize a propriedade Value. Clique em e selecione o tipode informação, que neste caso é um número com casas decimais (Double).

Page 29: E3tutorial beginner ptb

Telas e Objetos de Tela 29

Propriedade Value do Display

4. Na propriedade Value aparece o valor 0 (zero). Digite o número que desejar como valor inicial do Display.

5. Para formatar a unidade de engenharia, selecione a propriedade Format. Na janela de formação de dados, selecione acategoria que desejar.

6. Se preferir criar uma formatação, selecione a categoria Outro e digite o formato no campo Tipo. Util ize o número 0 (zero)para representar os algarismos e um texto entre aspas duplas para representar o sufixo ou prefixo.

Page 30: E3tutorial beginner ptb

30 Telas e Objetos de Tela

Formatação do Display

4.4.5 TelaEventos1. Insira uma nova Tela com o nome de "TelaEventos".

2. Configure a Tela com o fundo que desejar, cl icando em Estilo de Preenchimento.

4.5 Exercícios Complementares

4.5.1 KBKB-36216: Inserindo objetos na Galeria do E3

Page 31: E3tutorial beginner ptb

Telas e Objetos de Tela 31

4.6 Anotações

Page 32: E3tutorial beginner ptb

32 Introdução aos Scripts

5 Introdução aos ScriptsCAPÍTULO

Os Scripts são trechos de código (programação) com os quais se podem criar procedimentos associados a eventosespecíficos, permitindo grande flexibil idade no desenvolvimento e no uso de aplicações. Todos os scripts estão associados aeventos, e cada objeto do E3 possui uma lista de eventos previamente definidos, sendo possível também definir novos eventosde usuário.

De acordo com conceitos da programação orientada a objetos, as Propriedades definem atributos de um objeto, como aaparência 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 Associações .

Os Métodos são funções previamente definidas, que executam determinadas ações sobre as propriedades do objeto quechama estas ações. Exemplos disso são funções para realizar a escrita em tags (Write ou WriteEx), entre outras. Emlinguagens de programação orientadas a objeto, para agir sobre uma propriedade é necessária a criação de métodos. No E3,para cada método desejado, é necessário definir a qual evento ele estará associado, pois os scripts do E3 são orientados aeventos.

Os Eventos são ocorrências relacionadas a um objeto, que podem ser tratadas de modo a se realizar uma ação (um método).

5.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 rápido, leve e portável, desenvolvido para o uso em navegadores para aInternet e outras aplicações que usam ActiveX Controls, Automation Servers e Java Applets. Os scripts são sempre associadosa eventos de um determinado objeto. Entretanto, para facil itar e aumentar a velocidade de desenvolvimento, o E3 já incorporaalgumas ações mais comuns que poderiam ser realizadas com scripts através de assistentes (Wizards) chamados Picks. Pode-se definir que um determinado evento executará um script, um Pick ou uma combinação deles, em uma sequência definidadurante a criação do script (no E3 Studio).

5.1.1 Obtendo Referências a ObjetosUma das características mais importantes ao se trabalhar com scripts dentro do E3 é considerar a separação existente entreos processos que são executados no Servidor e aqueles executados na interface do cliente (Viewer). Para se trabalhar comscripts, pode-se manipular:

Objetos do servidor através do Servidor

Objetos do Servidor através do(s) Viewer(s)

Objetos do Viewer através do mesmo Viewer

No entanto, não se pode manipular diretamente:

Objetos do Viewer através do Servidor diretamente (só é possível através da criação de eventos no Viewer, l igados avariáveis que estão no Servidor)

Objetos de um Viewer a partir de outro Viewer (só é possível através da criação de eventos l igados a variáveis que estão noServidor)

Tais l imitações são decorrentes do fato de que, por definição, existe uma independência entre o que cada uma das estaçõesViewer está fazendo ou visualizando com relação ao Servidor e vice-versa. Por isso todas as atividades, tanto no Servidorquanto no Viewer, necessitam ser coordenadas de forma assíncrona ou através de eventos para operarem de formaharmoniosa.

Devido a essa independência, ao se criar um script, primeiro deve-se obter uma referência correta dos objetos que se desejamanipular, ou seja, é necessário que o objeto seja primeiramente encontrado nos vários módulos do E3.

Vale repetir que, ao se editar um script, o usuário deverá util izar o AppBrowser, que permite copiar para o script o caminho deum método ou propriedade de forma completa, auxil iando-o na criação de scripts.

Por exemplo, para se manipular o valor de um Tag de Comunicação, o caminho é Servidor - Driver - Pasta (se houver) - Tag. Jáse o objetivo for manipular um botão na Tela, o caminho é Viewer - Frame (se houver) - Tela - Botão.

Existem basicamente três localizações de origem de scripts, do ponto de vista da metodologia para acesso aos objetos:

Servidor (E3 Server)

Page 33: E3tutorial beginner ptb

Introdução aos Scripts 33

Telas e Quadros (E3 Viewer)

ElipseX (bibliotecas): podem ser XObjects (rodam no servidor) e XControls (rodam no Viewer)

Cada uma delas trata de forma diferente o acesso aos dados que um script deve l idar. A única ferramenta útil para todosestes acessos é o App Browser.

5.1.2 PicksOs Picks implementam uma forma amigável de realizar procedimentos comuns em scripts, poupando tempo de escrita decódigo. Entre eles estão ações como troca de Tela ou atribuições de valores, que são bastante comuns na criação de umprojeto.

5.1.2.1 Executar Scripts

Permite a edição de um script personalizado que é executado na ocorrência do evento determinado.

Pick Executar Scripts

Page 34: E3tutorial beginner ptb

34 Introdução aos Scripts

5.1.2.2 Abrir Tela

Abre uma Tela ou um Quadro determinado.

Pick Abrir Tela

5.1.2.3 Abrir Tela Modal

Abre uma Tela em estilo modal.

Pick Abrir Tela Modal

Page 35: E3tutorial beginner ptb

Introdução aos Scripts 35

5.1.2.4 Executar Aplicação

Executa um programa específico.

Pick Executar Aplicação

5.1.2.5 Carregar Valor

Carrega um valor em um Tag.

Pick Carregar Valor

Page 36: E3tutorial beginner ptb

36 Introdução aos Scripts

5.1.2.6 Inverter Valor

Permite mudar o valor de um Tag. Se o valor do Tag for igual a Valor1, então o Tag recebe Valor2. Se o valor do Tag for iguala Valor2, então o Tag recebe Valor1. Se o valor do Tag não for igual nem a Valor1 nem a Valor2, o Tag recebe Valor1.

Pick Inverter Valor

Page 37: E3tutorial beginner ptb

Introdução aos Scripts 37

5.1.2.7 Imprimir Relatório

Permite imprimir um Relatório na Tela ou na impressora.

Pick Imprimir Relatório

5.2 EventosOs Eventos são ocorrências relacionadas a um objeto, que disparam ações programadas. Basicamente são dois tipos deeventos: Físicos (ou externos) e Internos.

Eventos físicos são, por exemplo, ações no teclado ou no mouse. Neste caso, a informação relevante seria a tecla pressionadaou a posição do cursor e o status dos botões. Eventos internos são, por exemplo, a mudança de uma temperatura de umacâmara de 10 para 11 graus Celsius.

No E3, há uma lista disponível de eventos classificada por objetos, iniciando pelos eventos padrão, presentes em todos osobjetos. Esses eventos são acessados através da aba Scripts, que pode ser consultada através das propriedades do objetopara o qual se deseja fazer o script.

Page 38: E3tutorial beginner ptb

38 Introdução aos Scripts

Eventos disponíveis

5.2.1 Eventos Definidos pelo UsuárioApesar de o E3 vir com uma extensa gama de eventos, muitas vezes o usuário necessita criar um evento específico para suaaplicação. Um exemplo para a util ização de eventos definidos pelo usuário é a realização de um cálculo (ou tarefa maiscomplexa) em um objeto, quando o evento gerador vem de um outro Tag ou propriedade.

É possível a criação de eventos personalizados definidos pelo usuário através da opção Criar novo evento na l ista de eventos,

ou clicando em Criar evento do usuário .

Criar evento do usuário

5.3 MétodosOs Métodos são procedimentos que podem ser executados por objetos. Por exemplo, o objeto Tela tem um método para aadição de objetos (AddItem) e outro para fechá-la (Close). Por estarem encapsulados, isto é, guardados dentro dos objetos, nachamada de um método sempre deve constar a qual objeto está se referindo.

Muitos métodos pré-definidos possuem parâmetros, que podem (ou devem) ser passados na chamada do método. Para isso, oVBScript possui uma regra que deve ser seguida. Se o método for util izado em uma atribuição, seus parâmetros devem estarentre parênteses. Os parênteses usados nas citações de métodos neste manual servem apenas como indicativo paradiferenciá-los das propriedades. Nos scripts, deve-se seguir esta regra.

Page 39: E3tutorial beginner ptb

Introdução aos Scripts 39

Métodos no AppBrowser

5.4 PropriedadesTodo objeto possui Propriedades, que guardam informações a respeito de suas características. Por exemplo, um objeto dotipo Retângulo possui a propriedade Name, que contém seu nome e as propriedades Width e Height, que guardam a sualargura e a sua altura, respectivamente, entre outras. Para acessar as propriedades, util ize os mesmos procedimentos do tópico anterior, porém selecione a pasta Propriedades.

5.5 Exercícios

5.5.1 Pick Abrir TelaA primeira Tela do projeto é a TelaInicial. Para navegar para a TelaCaldeira, é necessário um botão que abra esta Tela.

1. Na TelaInicial insira um objeto CommandButton. Na sua propriedade Caption, digite "Entrar".

2. Selecione o botão e clique na aba Scripts.

Selecionar aba Scripts

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

Script do tipo Abrir Tela

4. Selecione a TelaCaldeira no campo Abrir a Tela.

Page 40: E3tutorial beginner ptb

40 Introdução aos Scripts

Opção Abrir Tela

5.5.2 Pick Script1. Insira um novo objeto CommandButton com o texto "Sair".

2. No evento Click, crie um novo Pick do tipo Script.

Evento do tipo Script

3. Com o auxíl io do AppBrowser , procure o método Exit do Viewer e clique em Colar.

Application.Exit

4. Execute a aplicação e teste as novas funcionalidades.

Page 41: E3tutorial beginner ptb

Introdução aos Scripts 41

5.6 Anotações

Page 42: E3tutorial beginner ptb

42 Simulação de Valores

6 Simulação de ValoresCAPÍTULO

Muitas vezes são necessários valores que simulem os movimentos. Normalmente estes valores são reais e vem de Tags deComunicação, mas nos exercícios deste Tutorial usaremos Tags do tipo Demo. Simularemos os valores de vazão, pressão evapor.

6.1 Servidor de DadosO Servidor de Dados é o módulo responsável pela execução e gerenciamento de Tags e objetos que não estejam envolvidosdiretamente com a comunicação. Através do Servidor de Dados pode-se configurar Tags internos e Tags de simulação, além deinserir XObjects, que são os objetos de dados das bibliotecas ElipseX (vistas mais adiante). Alguns dos objetos que podem serinseridos no Servidor de Dados são descritos na tabela seguinte.

Objetos que podem ser inseridos no Servidor de Dados

OBJETO DESCRIÇÃO

Tag Contador Objeto que faz a contagem de tempo (em segundos) atéatingi r um va lor pré-determinado, ou que faz uma certacontagem indefinidamente.

Tag Demo Objeto que gera va lores de acordo com a forma de onda. Éuti l i zado para s imulação de va lores . Permite gerar curvasdefinidas ou va lores a leatórios .

Tag Interno Objeto de propós i to genérico, uti l i zado para guardar va loresde qualquer tipo, incluindo números , textos e outros objetos .

Tag Timer Objeto para contagem de tempo e programação deatividades . Es tabelece horários (com repetições) paraexecutar ações .

Pasta de Dados Define grupos e subdiretórios para a organização dasinformações . Novas pastas podem ser inseridas dentro deoutras , conforme a necess idade.

NOTA: Os objetos inseridos no Servidor de Dados serão executados pelo E3 Server, portanto estarão presentes no Servidor.Esta informação retrata o modo como o E3 trabalha.

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

O nome do Tag não pode ser estritamente numérico

O nome do Tag não pode conter operadores lógicos ou aritméticos: (/ * + -)

O nome da variável não pode conter caracteres reservados: / ? . , { } [ ] º - etc. Esses caracteres são trocados pelo caracteresublinhado. Assim, o sistema aplica a Regra dos Colchetes, explicada a seguir

6.2.1 Regra dos ColchetesAo fazer referência a um objeto por script ou ao usá-lo em alguma associação, deve-se levar em conta as seguintes regras:

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

Se algum dos demais caracteres (do segundo em diante) não for uma letra, um número ou um caractere sublinhado, o nometambém deve estar entre colchetes

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

6.3 Exercícios

6.3.1 Simulação de ValoresMuitas vezes são necessários valores que simulem os movimentos. Normalmente estes valores são reais e vem de Tags deComunicação, mas nos exercícios do Tutorial usaremos Tags do tipo Demo.

1. No Organizer, localize a pasta Dados (Objetos de Servidor – Objetos de Dados). Clique com o botão direito do mouse eselecione o item Inserir – Panel – Tag Demo.

Page 43: E3tutorial beginner ptb

Simulação de Valores 43

Inserir Tag Demo

2. Na janela de configuração, digite "1" no campo Quantidade e "Pressao" no campo Nome. Evite usar acentos no nome doTag.

Configuração do Tag Demo

3. Insira mais quatro Tags Demo nomeados como "Vapor", "Vazao", "Nivel" e "Caminhao".

Page 44: E3tutorial beginner ptb

44 Simulação de Valores

Tags Demo

4. Na pasta Dados insira os Tags Demo com as seguintes propriedades configuradas:

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 - Sine

Caminhao 0 100 4 - RampUp

6.3.2 Tag InternoQuando se deseja armazenar um valor para util izá-lo futuramente, cria-se um Tag Interno.

1. Na pasta Dados insira um Tag Interno chamado Motor.

Tag Interno

2. Configure a propriedade Value do Tag Motor para Boolean com valor inicial False.

Page 45: E3tutorial beginner ptb

Simulação de Valores 45

Propriedade Value

Page 46: E3tutorial beginner ptb

46 Simulação de Valores

6.4 Anotações

Page 47: E3tutorial beginner ptb

Associações 47

7 AssociaçõesCAPÍTULO

Associações (ou Conexões) são l igações feitas entre propriedades e objetos ou entre outras propriedades. As Associaçõestrazem grande facil idade ao criar animações e outros tipos de lógicas comuns, minimizando a util ização de scripts.

Através da aba Associações da janela de Propriedades, tem-se acesso a todas as propriedades disponíveis do objeto a sertratado e todos os tipos possíveis de Associações para estas propriedades.

Aba Associações

Pode-se associar um objeto ou criar uma expressão. Ao criar uma expressão ou associar um objeto ou propriedade ao campo Fonte, o texto aparecerá na cor azul, caso este corresponda a um item existente ou carregado no E3 Studio. Se o item nãoexistir, ou pertencer a um módulo não existente no Domínio, o texto aparecerá em vermelho, e este item será mostrado comoum erro, até ser corrigido ou excluído com a opção Verificar Domínio.

7.1 Tipos de AssociaçõesEsta seção contém a descrição dos tipos de Associações.

7.1.1 Associação SimplesNa Associação Simples, o valor do campo Fonte é copiado para a propriedade toda vez que a fonte é modificada.

Associação Simples

Page 48: E3tutorial beginner ptb

48 Associações

7.1.2 Associação BidirecionalNa Associação Bidirecional acontece o mesmo que na Associação Simples, porém caso também haja uma variação napropriedade, seu valor é copiado para o campo Fonte, gerando assim um caminho de duas direções.

Associação Bidirecional

7.1.3 Associação DigitalJá na Associação Digital, é possível estabelecer que, caso a variável ou expressão do campo Fonte seja uma propriedadedigital, seus estados Verdadeiro e Falso são mapeados para certos valores no Destino, incluindo a opção de Pisca(alternância de valores).

Associação Digital

7.1.4 Associação AnalógicaA Associação Analógica permite estabelecer uma escala de conversões entre a variável fonte e a variável destino. Através dequatro valores especificados, é feita uma escala l inear entre os valores da propriedade e os valores da fonte.

Page 49: E3tutorial beginner ptb

Associações 49

Associação Analógica

7.1.5 Associação por TabelaNa Associação por Tabela, pode-se estabelecer condições entre a variável, os valores e o destino. Na tabela são especificadosvalores mínimos e máximos, e valores para a propriedade referente a estas condições.

Associação por Tabela

Page 50: E3tutorial beginner ptb

50 Associações

7.1.6 Associação ReversaA Associação Reversa é uma Associação unidirecional do objeto para a fonte.

Associação Reversa

7.1.7 Associação MúltiplaNa Associação Múltipla, cada l inha da Associação permite buscar o valor de uma fonte diferente. A fonte ativa é selecionada deacordo com o valor fonte principal da Associação.

Associação Múltipla

7.2 Edição de AssociaçõesO E3 possui uma ferramenta para editar Associações, chamada Edição de Associações. Assim, é possível mudar uma ou maisAssociações feitas na aplicação de forma mais rápida do que pela janela tradicional. O acesso a esta ferramenta pode serfeito clicando-se com o botão direito do mouse em um ou mais objetos e selecionando a opção Editar Associações.

Page 51: E3tutorial beginner ptb

Associações 51

Edição de Associações

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 saída digital, portanto seus valores são 0 ou 1. Ao usar o valor do Tag paraAssociações com propriedades do tipo Boolean, o E3 considera as seguintes situações:

Valor do Tag para tipos Boolean

TAG VBSCRIPT

0 Falso

1 Verdadeiro

Ao util izar o comando NOT, considera as seguintes situações:

Valor do Tag com NOT

TAG NOT TAG VBSCRIPT

0 -1 Verdadeiro

1 -2 Verdadeiro

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

Conversão de Tags com CBool

TAG CBOOL(TAG) NOT CBOOL(TAG)

0 Falso Verdadeiro

1 Verdadeiro Fa lso

Uso do método CBool

Outra opção seria trabalhar com a propriedade Bit00 do Tag, que já é uma propriedade do tipo Boolean, ao invés de trabalharcom a propriedade Value do Tag.

Uso da propriedade Bit00

7.4 Exercícios

7.4.1 Associação Simples1. Na TelaCaldeira, selecione o Display que representa a pressão. Clique com o botão direito do mouse e abra a janela de

propriedades.

Page 52: E3tutorial beginner ptb

52 Associações

Propriedades do Display

2. Na aba Associações, propriedade Value, cl ique em na coluna Fonte.

Propriedade Value

3. Na janela do AppBrowser, localize na l istagem da esquerda o Tag Pressao (em Servidor - Dados) e clique em Colar.

Page 53: E3tutorial beginner ptb

Associações 53

AppBrowser

4. A informação vai do Tag Pressao para o Display, logo a Associação é do tipo Simples (Propriedade « Fonte).

Associação Simples

5. Associe os Displays de Vazão e Vapor aos seus respectivos Tags.

7.4.2 Associação por Tabela1. No Display que exibe o valor do Tag Vapor na TelaCaldeira, deseja-se indicar que o vapor está fora da faixa permitida

alterando-se a cor de fundo. Crie uma Associação por Tabela na propriedade ForegroundColor, conforme a figura aseguir.

Propriedade ForegroundColor

Page 54: E3tutorial beginner ptb

54 Associações

7.4.3 Associação Analógica1. Deseja-se indicar o nível do tanque com o preenchimento de cor do Retângulo. O Tag Nivel pode variar de 0 a 1000,

enquanto que o preenchimento do Retângulo vai apenas de 0 a 100%. Para fazer a conversão, util iza-se uma AssociaçãoAnalógica.

Associação Analógica

7.4.4 Associação Digital1. Na TelaCaldeira, o motor deve alterar de cor conforme o valor do Tag Motor. Acesse as propriedades da figura Motor,

aba Associações. Na propriedade OverrideFillColor selecione o Tag Interno Motor (em Servidor - Dados - Motor) e à direitaselecione a propriedade Value.

2. No tipo de Associação, selecione Associação Digital. Escolha duas cores para simbolizar Ligado e Desligado. Se desejar,habil ite o pisca.

Propriedade OverrideFillColor

7.4.5 Pick Inverter Valor1. Na TelaCaldeira, ao clicar no motor ele deve l igar ou desligar. Selecione o motor e clique na aba Scripts.

2. Crie um novo Pick do tipo Inverter Valor.

Pick Inverter Valor

3. Selecione a propriedade Value do Tag Motor (em Servidor – Dados – Motor) no campo Nome do tag.

4. Altere os campos Valor 1 e Valor 2 para Boolean. Configure um deles como Verdadeiro e o outro como Falso.

Valores para o Tag Motor

7.4.6 Animação

1. Selecione o objeto Caminhao e cl ique em para inserir uma Animação com Translação.Uma sombra do objetoaparecerá. Mova-a até onde desejar.

Page 55: E3tutorial beginner ptb

Associações 55

Animação com Translação

2. Clique com o botão direito do mouse na Animação e abra suas propriedades. Crie uma Associação Simples napropriedade Value com o Tag Caminhao.

Associação Simples

3. Altere as propriedades Enabled e EnabledSlider da Animação para Falso.

Page 56: E3tutorial beginner ptb

56 Associações

7.5 Anotações

Page 57: E3tutorial beginner ptb

Gráficos e E3Chart 57

8 Gráficos e E3ChartCAPÍTULO

O objeto E3Chart é um componente ActiveX criado especialmente para trabalhar em conjunto com o E3. Com ele, é possívelexibir gráficos com Tags variando em tempo real e também mostrar dados históricos gravados em um banco de dados.

Cada sequência de dados é representada no E3Chart através de Penas. Para cada Pena são associados dados que podem serTags ou campos de consultas. É possível criar vários eixos com escalas diferentes para serem associados aos dados dasPenas.

E3Chart

Para inserir este objeto na Tela, cl ique com o botão direito do mouse e selecione a opção Inserir - E3Chart.

8.1 Configurações das PenasO objeto Coleção de Penas representa o conjunto de Penas contidas no E3Chart. Cada Pena é configurada para exibir dadosem tempo real ou dados históricos vindos da Consulta. Através da aba Penas, é possível configurar o número e o tipo dasPenas a serem criadas na Coleção de Penas. Nesta aba, cl ique em Adicionar para criar uma nova Pena no E3Chart.

Page 58: E3tutorial beginner ptb

58 Gráficos e E3Chart

Aba Dados

8.1.1 Pena de Tempo RealPara configurar uma Pena como de Tempo Real, selecione a opção Tempo Real na aba Dados das propriedades da Pena,disponível no item Tipo de pena. Logo após, defina os Tags nas opções Link do eixo vertical e Link do eixo horizontal.

8.1.2 Pena HistóricaO objeto Consulta também é usado para mostrar valores históricos no E3Chart. Através da aba Consultas é possível adicionar,excluir ou configurar as Consultas. Para criar uma Pena Histórica, é necessário que a Consulta esteja previamente criada.Para tanto, na aba Dados das propriedades da Pena, selecione a opção Histórica, disponível no item Tipo de pena e defina aConsulta. Logo após, defina os campos da Consulta nos itens Campo do eixo vertical e Campo do eixo horizontal.

8.1.3 Tempo Real e Histórica (Mista)Para configurar uma pena como de Tempo Real e Histórica na aba Dados das propriedades da Pena, selecione na opção Tipode pena o item Tempo Real & Histórica. Este tipo de Pena é util izado quando se deseja ter os dados antigos e os valores atuaisdos Tags na mesma Pena.

8.2 Exercícios

Page 59: E3tutorial beginner ptb

Gráficos e E3Chart 59

8.2.1 Inserir Nova Tela1. Clique com o botão direito do mouse na pasta Telas e selecione a opção Inserir Tela em - TreinamentoE3.prj.

Inserir Tela

2. Na janela de configuração da nova Tela, digite "TelaGrafico" no campo Nome.

3. Na TelaCaldeira, insira um objeto Command Button. Na propriedade Caption digite "Gráfico". Este botão abre aTelaGrafico.

4. Selecione o botão e clique na aba Scripts. No evento Click, crie um novo script do tipo Abrir Tela.

Pick Abrir Tela

5. Selecione a TelaGrafico no campo Abrir a tela.

8.2.2 E3Chart1. Posicione um objeto E3Chart na TelaGrafico. Selecione o ícone na barra de ferramentas ou clique com o botão

direito do mouse na Tela e selecione a opção Inserir - E3Chart.

8.2.3 Penas1. Abra a janela de propriedades do E3Chart, selecione a aba Penas, cl ique em Adicionar e selecione o tipo Tempo Real.

Inserir Pena de Tempo Real

Page 60: E3tutorial beginner ptb

60 Gráficos e E3Chart

2. Troque o nome da Pena para Pressao.

Pena Pressao

3. Na coluna Estilo, selecione a cor e o tipo da l inha.

Estilo da Pena

4. Na opção Link do Eixo Vertical, selecione o Tag Pressao (em Servidor - Dados).

Page 61: E3tutorial beginner ptb

Gráficos e E3Chart 61

Link com o Tag Pressao

5. Repita os passos anteriores para incluir as Penas Vazao e Vapor.

8.2.4 EscalaOs maiores valores são do Tag Vazao que varia de 0 a 500, então vamos alterar a escala vertical para exibir os valores nestafaixa.

1. Na aba Eixos, selecione o item EixoVertical e cl ique em Configurar.

2. Na aba Escala, configure o campo Mínimo com o valor 0 (zero) e o campo Máximo com o valor 500.

Aba Escala

Page 62: E3tutorial beginner ptb

62 Gráficos e E3Chart

8.2.5 Legenda1. Na aba Legenda, selecione a opção Mostrar legenda, tamanho 60, e adicione as colunas que preferir.

Aba Legenda

2. Configure a coluna Valor do tag X para mostrar o valor no formato "HH:mm:ss".

8.3 Exercícios Complementares

8.3.1 KBKB-18257: Criando um gráfico com pontos digitais

Page 63: E3tutorial beginner ptb

Gráficos e E3Chart 63

8.4 Anotações

Page 64: E3tutorial beginner ptb

64 Estrutura de Telas e Quadros

9 Estrutura de Telas e QuadrosCAPÍTULO

O Quadro é o objeto que organiza e estrutura a interface, criando visualizações compostas para o usuário dentro da janelaprincipal do Viewer ou do navegador.

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

A disposição 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 opções Dividir Horizontalmente e Dividir Verticalmente, hásempre um Divisor Principal e um Divisor Secundário. Apenas o Divisor Principal tem valores que definem explicitamente oseu posicionamento, ficando o Divisor Secundário com o valor restante. Para util izar este recurso, siga estes procedimentos:

1. Clique com o botão direito do mouse no item Visualização - Viewers e Quadros do Organizer e selecione a opção InserirQuadro em.

2. Para criar um Divisor, cl ique com o botão direito do mouse sobre o Quadro aberto e selecione o tipo de divisão (DividirHorizontalmente ou Dividir Verticalmente).

Menu de divisão do Quadro

3. Arraste a barra de divisão com o mouse para a posição desejada e clique com o botão esquerdo do mouse para fixá-la.

Quadros divididos horizontalmente e verticalmente

9.1 ViewerO objeto Viewer configura o modo como o E3 Viewer será visualizado.

O E3 Viewer pode rodar a partir de qualquer ponto da rede que tenha acesso ao E3 Server. Não é necessário copiar oaplicativo para as máquinas onde o E3 Viewer é executado, pois as Telas e bitmaps são trazidos do servidor conforme a

Page 65: E3tutorial beginner ptb

Estrutura de Telas e Quadros 65

necessidade, em tempo de execução.

NOTA: Só pode exis ti r um objeto Viewer em um Domínio.

Na aba Visualizador da janela de Propriedades são definidas as configurações de visualização do Viewer.

Aba Visualizador

Através da aba Configuração pode-se editar as opções relativas à janela, ao título e à resolução do Viewer.

Page 66: E3tutorial beginner ptb

66 Estrutura de Telas e Quadros

Aba Configuração

Na aba Erros de comunicação pode-se configurar um padrão para que os Displays e SetPoints de toda a aplicação indiquemerros de comunicação.

Aba Erros de Comunicação

NOTA: Também é poss ível inseri r Tags no Viewer.

9.2 Exercícios

Page 67: E3tutorial beginner ptb

Estrutura de Telas e Quadros 67

9.2.1 Quadros1. Clique com o botão direito do mouse no item Visualização - Viewer e Quadros do Organizer e selecione a opção Inserir

Quadro em - TreinamentoE3.prj.

Inserir Quadro

2. Na área de visualização do Quadro, cl ique com o botão direito do mouse e selecione a opção 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 botão esquerdo domouse para fixar a posição da barra.

4. O tamanho do Divisor também pode ser alterado diretamente na propriedade SplitValue.

5. Selecione o Divisor superior. Na propriedade SplitValue digite "100 px".

9.2.2 Telas1. Clique com o botão direito do mouse sobre o item Visualização - Telas do Organizer e selecione a opção Inserir Tela em -

TreinamentoE3.prj.

Page 68: E3tutorial beginner ptb

68 Estrutura de Telas e Quadros

Inserir Tela

2. Selecione o item Superior na opção Escolha o Divisor onde a Tela será aberta. Isto faz com que a Tela seja criada com otamanho exato deste Divisor. Selecione a opção Configurar como Tela inicial do Divisor e, no campo Nome, digite"TelaMenu".

TelaMenu

A TelaCaldeira e a TelaGrafico foram inicialmente criadas para ocupar toda a área de visualização. Como agora elasserão abertas na parte inferior, é preciso rever o tamanho destas Telas.

3. Na TelaCaldeira, cl ique com o botão direito do mouse e selecione a opção Ajustar ao Divisor.

Page 69: E3tutorial beginner ptb

Estrutura de Telas e Quadros 69

Ajustar ao Divisor

4. Na janela de configuração, selecione o item Inferior na opção Escolha o Divisor onde a Tela será aberta. Selecione a opçãoConfigurar como Tela inicial do Divisor.

Configurando o tamanho da Tela

5. Ajuste a TelaGrafico para ter o mesmo tamanho do Divisor Inferior.

9.2.3 Navegação em TelasA primeira Tela da aplicação será a TelaInicial. Ao clicar em Entrar, deve ser aberto o Quadro1 criado no exercícioanterior.

1. Na TelaInicial, altere o script do botão Entrar substituindo a TelaCaldeira pelo Quadro1.

Page 70: E3tutorial beginner ptb

70 Estrutura de Telas e Quadros

Script do botão Entrar

2. Na TelaMenu, insira um objeto CommandButton. Na sua propriedade Caption, digite "Caldeira".

3. Selecione o botão e clique na aba Scripts. No evento Click, crie um novo script do tipo Abrir Tela.

Pick Abrir Tela

4. Selecione a TelaCaldeira no campo Abrir a tela e, no campo Quadro, selecione o item Inferior.

Abrir a TelaCaldeira

5. Crie um segundo botão para abrir a TelaGrafico.

9.2.4 TelaMenu1. Na TelaMenu, arraste o logotipo do E3 do grupo Recursos da Galeria.

2. No canto direito da Tela, insira um Display .

3. Abra as propriedades do objeto e selecione a aba Formatação. Defina o formato como Hora e, no item Tipo, selecione"13:06:03". Esta formatação mostra as horas, os minutos e os segundos.

4. Para visualizar a configuração feita no exercício anterior, selecione a propriedade Value do Display e escolha a opçãoDate.

Display

9.2.5 Horário do SistemaPara obter o horário corrente do sistema é necessário criar um Tag Demo que acesse esta informação.

1. Na pasta Dados, insira um Tag Demo com o nome Relogio. Configure a propriedade Type deste Tag para 3 – CurrentTime.

2. Na TelaMenu, abra as propriedades do Display configurado para exibir as horas e selecione a aba Associações.

3. Na propriedade Value, busque na coluna Fonte, com o auxíl io do AppBrowser, o Tag Demo Relogio (Servidor - Dados) eclique em Colar.

4. Execute a aplicação clicando em .

Page 71: E3tutorial beginner ptb

Estrutura de Telas e Quadros 71

9.3 Anotações

Page 72: E3tutorial beginner ptb

72 Segurança

10 SegurançaCAPÍTULO

O E3 possui um controle de acesso a Telas, Alarmes e Domínios em uma lista de usuários, onde para cada nome é atribuídouma senha e um login. Conforme a opção configurada, o sistema permite acesso aos usuários cadastrados ou acessoil imitado às Telas do projeto.

10.1 UsuáriosAtravés da opção Usuários, é possível configurar as informações referentes aos usuários que têm ou não acesso ao sistema.Para util izar este recurso, abra o menu Arquivo - Usuários e cl ique na aba Usuários.

Aba Usuários

IMPORTANTE: Após configurar a segurança, somente os usuários l i s tados têm acesso à apl icação.

10.2 GruposA opção Grupos permite que sejam criados grupos com características que são comuns para todos os seus membros(usuários). Um grupo também pode pertencer a outros grupos. Só não é permitido pertencer a outro grupo que pertença a ele,ou seja, uma referência circular. Para util izar este recurso, abra o menu Arquivo - Usuários e selecione a aba Grupos.

Page 73: E3tutorial beginner ptb

Segurança 73

Aba Grupos

10.3 PermissõesA aba Permissões configura as permissões dos usuários e grupos para Telas, Alarmes, Domínio e Viewer. Uma verificação depermissão consiste em uma informação que o membro do grupo tem sobre um comando que atua sobre um objeto específico.

Por exemplo, o Usuario1 tem permissão para o comando Abrir sobre o objeto Tela1. Cada membro do grupo pode negar ouafirmar a permissão de um comando, independentemente do grupo a qual pertence. Desta forma, não leva em consideração ainformação do grupo. Também pode-se optar por sempre util izar a informação definida pelo grupo. Se as informações dosgrupos forem conflitantes, é usada a seguinte ordem de preferência: Negar » Afirmar » Indiferente.

Page 74: E3tutorial beginner ptb

74 Segurança

Aba Permissões

10.4 ProteçãoO E3 possui uma ferramenta de proteção de projetos ou de bibliotecas. Através deste item, é possível proteger o conteúdo doarquivo contra a edição, a visualização ou a execução não autorizada. Para util izar este recurso, cl ique com o botão direitodo mouse sobre o nome do projeto no Organizer e selecione a opção Proteção.

Page 75: E3tutorial beginner ptb

Segurança 75

Proteção de arquivos

Esta opção possui dois tipos de proteção, de Edição e de Execução.

Proteção de Edição: Protege o arquivo contra alterações e visualizações não autorizadas. Este recurso é util izado paraevitar que determinada biblioteca ou projeto seja alterado acidentalmente, ou que sejam copiados procedimentos deconhecimento específico do desenvolvedor. O E3 fornece um controle sobre a edição destes arquivos, sejam eles projetosou bibliotecas

Proteção de Execução: Esta opção é util izada para proteger um arquivo contra execução não autorizada. Para tanto, énecessário solicitar a gravação de uma senha no dispositivo de proteção, que é feita pela Elipse Software. Isto protege odesenvolvedor de cópias não autorizadas do projeto, por exemplo

Quando um arquivo *.l ib ou *.prj é aberto no E3 Studio, este inicializa mostrando um ícone cinza com um cadeado,indicando que está protegido e este conteúdo não pode ser acessado. Para acessar o conteúdo do arquivo, cl ique no ícone da

direita e mude para Abrir com senha. Após informar a senha e o sistema liberar o acesso, o ícone fica colorido , indicandoa acessibil idade dos arquivos.

IMPORTANTE: As proteções implementadas não podem ser desfei tas caso as senhas sejam perdidas . Portanto, ao protegerdeterminado arquivo, mantenha as senhas armazenadas de modo seguro. Is to garante que será poss ível usar o arquivosempre que necessário.

10.5 ExercíciosA seguir, será visto como configurar usuários em um Domínio no E3 e como util izar este recurso para inibir ou permitir acessoa Telas, controles, alarmes, etc.

Page 76: E3tutorial beginner ptb

76 Segurança

10.5.1 Usuários1. No menu Arquivo, selecione a opção Usuários.

Menu Arquivo - Usuários

2. Selecione a aba Grupos e crie dois grupos de usuários, chamados Administrador e Operador.

3. Através da aba Usuário, crie três usuários. Cuidado que maiúsculas e minúsculas fazem diferença.

Adicionar usuário

4. Configure um usuário para pertencer ao grupo Administrador e dois para pertencerem ao grupo Operador.

10.5.2 Permissões1. Na aba Permissões, selecione a opção Grupos. Bloqueie a TelaGrafico para o grupo Operador.

2. Nas permissões de usuários, dê permissão para um dos usuários do grupo Operador para acessar a TelaGrafico.

10.5.3 Login1. Na TelaMenu, insira um novo CommandButton com o texto "Login". No evento Click, crie um novo Pick do tipo Script.

2. Busque no AppBrowser o método Login do Viewer e clique em Colar.

Application.Login(True)

Page 77: E3tutorial beginner ptb

Segurança 77

10.5.4 Nome do Usuário1. Crie um segundo Display na TelaMenu, para exibir o nome do usuário logado na aplicação.

2. Associe a propriedade Value do Display do usuário com a propriedade User do Viewer.

Associação da propriedade Value com a propriedade User

Page 78: E3tutorial beginner ptb

78 Segurança

10.6 Anotações

Page 79: E3tutorial beginner ptb

Comunicação 79

11 ComunicaçãoCAPÍTULO

O E3 permite a comunicação com equipamentos de aquisição de dados, controladores, CLPs (Controladores LógicosProgramáveis), UTRs (Unidades Terminais Remotas), ou qualquer outro tipo de equipamento através de Drivers deComunicação ou Servidores OPC, de acordo com o tipo do equipamento ou tipo de comunicação necessária. Os Drivers deComunicação e Servidores OPC funcionam neste caso como servidores de variáveis, ou seja, eles fornecem as informações domundo externo para o E3 para que a supervisão do processo se realize. As variáveis envolvidas no processo são conhecidascomo Tags e podem ser de vários tipos, de acordo com a util ização desejada. No E3 podem ser inseridos dois tipos de Drivers,o Driver de Comunicação (arquivos .dll) e o Driver de Comunicação OPC.

11.1 Elipse Modbus SimulatorO Elipse Modbus Simulator é um gerador de valores aleatórios para aplicações compatíveis com o protocolo Modbus RTU.Além disto, também permite receber mensagens de escrita feitas por estas aplicações. O programa pode ser baixado no site daElipse.

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

Janela principal do Elipse Modbus Simulator

As opções disponíveis na janela principal são as seguintes:

Opções disponíveis na janela principal do Elipse Modbus Simulator

OPÇÃO DESCRIÇÃO

PLCs Quantity Número de PLCs que serão s imulados . NOTA: Na versão Demoeste campo tem um l imite de 10 PLCs .

Initial Port Porta base uti l i zada para a comunicação.

Random Values Habi l i ta ou desabi l i ta a geração a leatória de va lores .

Interval (ms) Interva lo de variação dos va lores , em mi l i s segundos .

Após selecionar a quantidade de PLCs e a porta inicial, inicie a simulação clicando em Start.

11.1.1 Quantidade de PLCsO Simulador cria os PLCs nas portas consecutivas ao valor configurado no campo Initial Port. Por exemplo, ao configurar trêsPLCs a partir da porta 20000, o primeiro PLC estará disponível na porta 20000, o segundo na porta 20001 e o terceiro na porta20002.

Page 80: E3tutorial beginner ptb

80 Comunicação

Quantidade de PLCs

NOTA: Os PLCs criados consecutivamente ao va lor configurado no campo Initial Port uti l i zam somente portas disponíveis . Noexemplo anterior, se a porta 20001 estiver em uso por outra apl icação, são criados PLCs nas portas 20000, 20002 e 20003.

11.1.2 MemóriasO Simulador prevê 30 registros digitais (Coils) e 20 registros analógicos (Registers). É permitida a escrita de valoresdiretamente no Simulador, através da coluna Value dos grids respectivos, quando a variação de valores para o PLC estiverdesligada.

Com a opção Random Values selecionada, são gerados valores aleatórios em todas as memórias a cada dois segundos,conforme definido no campo Interval. O endereço de cada PLC é sempre 1 (Device ID).

11.1.2.1 Coils

Coils são memórias digitais disponíveis para leitura através da função Modbus 01 (Read Coil Status) e escrita através dafunção Modbus 05 (Force Single Coil).

11.1.2.2 Registers

Registers são memórias analógicas que variam de 0 a 65535 (Word). Estão disponíveis para leitura através da funçãoModbus 03 (Read Holding Registers) e para escrita através da função Modbus 06 (Preset Single Registers) ou da função Modbus16 (Preset Multiple Registers).

11.2 Driver de ComunicaçãoO Driver de Comunicação é o módulo do E3 que possibil ita a comunicação com um determinado equipamento usando osDrivers fornecidos pela Elipse Software. Um manual é fornecido juntamente com cada Driver, contendo informaçõesimportantes à respeito da configuração de seus parâmetros [P] e outras propriedades. Os tipos de objetos de Driverdisponíveis para comunicação são descritos na tabela a seguir.

Objetos disponíveis no Driver de Comunicação

OBJETO DESCRIÇÃO

Pasta Define grupos e subdiretórios para a organização devariáveis . Não tem relação di reta com o equipamento decampo.

Tag de Comunicação Uti l i zado para defini r a comunicação com uma variável (umendereço de memória) do equipamento de aquis ição.

Bloco de Comunicação Uti l i zado para defini r a comunicação com diversas variáveis(vários endereços de memória em sequência) doequipamento de aquis ição.

Elementos de Bloco Representam cada um dos endereços de um Bloco e sãouti l i zados como se fossem Tags de Comunicação. OsElementos de Bloco podem apontar para cada índice dentrode um Bloco (correspondendo a cada variável de interesse).

Page 81: E3tutorial beginner ptb

Comunicação 81

11.3 Driver de Comunicação OPCO Driver de Comunicação OPC é o módulo responsável por coletar dados de equipamentos externos através de um ServidorOPC, que pode ser desenvolvido por qualquer empresa com conhecimentos da rede e do protocolo usados por umdeterminado equipamento. Os Tags OPC podem ser importados para o Driver OPC no E3 (o Driver OPC no E3 atua como umcliente OPC), ou ainda podem ser criados no E3. Neste caso é necessário conhecer o ItemId de cada Tag.

Objetos disponíveis no Servidor OPC

OBJETO DESCRIÇÃO

Pasta OPC Define grupos ou subdiretórios para a organização dasvariáveis .

Grupo OPC Agrupa uma série de Tags OPC que comparti lham os mesmosparâmetros de atua l i zação (tempo de varredura e bandamorta). É obrigatório 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 fazer uma escri ta , deve-se apenas atribuir um novo va lorà 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 esse objeto está sempre associado à pos içãodefinida por sua propriedade Index, correspondendo a umavariável de interesse.

O E3 funciona como servidor OPC e também como cliente OPC. O procedimento a seguir serve para mostrar como funciona aconfiguração do Driver OPC, já que é semelhante para qualquer servidor OPC que esteja sendo util izado. O roteiro estádescrito nos passos a seguir.

1. Clique com o botão direito do mouse na pasta Drivers e OPC e selecione o item Inserir Driver de Comunicação OPC em -TreinamentoE3.prj.

2. Clique com o botão direito do mouse no Driver OPC inserido, selecione a opção Propriedades e cl ique na aba OPC Driver.

3. Clique em Selecionar para abrir uma janela com as opções de servidores OPC na máquina local ou na rede. Selecione oElipse OPC Server da máquina do instrutor na opção Servidores na rede e cl ique em OK.

4. Ao voltar à janela de propriedades do Driver OPC, clique em Ativar Comunicação. A partir deste ponto, é possível verificara comunicação com o servidor clicando em Informações.

5. O próximo passo para a configuração é a importação de Tags. Feche a janela de propriedades e clique com o botãodireito do mouse no Driver OPC cadastrado. Selecione a opção Importar Tags. Com isto o Assistente de Importação de Tagsdo E3 é aberto.

Page 82: E3tutorial beginner ptb

82 Comunicação

Importação de Tags OPC

6. A figura anterior mostra a aparência da janela de importação. Do lado direito a l ista de Tags do servidor e do ladoesquerdo, a área de importação 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 configuração de Drivers Elipse, o roteiro para trabalhar com o servidor OPC da Elipse é o mesmopara qualquer servidor que seja util izado.

11.4 Exercícios

11.4.1 Driver de ComunicaçãoPara comunicar o Elipse Modbus Simulator com o E3 será util izado o arquivo de Driver Modbus.dll, disponível para downloadem www.elipse.com.br.

1. Clique com o botão direito do mouse na pasta Drivers e OPC e selecione a opção Inserir Driver de Comunicação em –TreinamentoE3.prj.

Page 83: E3tutorial beginner ptb

Comunicação 83

Inserir Driver de Comunicação

2. Selecione o arquivo do Driver (Modbus.dll) na caixa de diálogo para a seleção de arquivos. A janela da figura a seguir éaberta para configuração do Driver.

Janela de configuração 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 opções da propriedade Physical Layer, a interface física Ethernet.

Page 84: E3tutorial beginner ptb

84 Comunicação

Aba Setup

4. Após selecionar a interface física, todas as outras abas são desabil itadas, sendo necessário 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".

Aba Ethernet

5. No campo Port, digite o número da porta de comunicação. Por exemplo, digite "20002" para acessar o terceiro CLP doSimulador.

Page 85: E3tutorial beginner ptb

Comunicação 85

6. Na aba Modbus, selecione o protocolo RTU Mode no campo Modbus Mode e, no campo Data Address Model Offset,selecione o item Data is address from 0, pois o primeiro endereço do Simulador é 0 (zero).

Aba Modbus

7. Na aba Operations, verifique o código das operações para leitura e escrita que são necessárias para as leituras dosregistros do CLP:

Registers: Leitura de valores analógicos (Word) através da função Modbus 03 (Read Holding Registers) e para escritaatravés das funções Modbus 06 (Preset Single Registers) ou Modbus 16 (Preset Multiple Registers). A operação 01 executaa leitura Modbus 03 (Read) e escrita Modbus 16 (Write) de valores do tipo Word (Data).

Coils: Leitura de valores digitais (Bit) através da função Modbus 01 e escrita através da função Modbus 05 (Force SingleCoil). Não existe na l ista padrão uma operação com estas configurações, portanto é necessário adicionar uma nova.

8. No lado direito da aba Operations, cl ique em Add para criar a opção 08. Selecione a operação 01 na l ista de opções docampo Read e, no campo Write, a opção 05.

Adicionar operação

9. A l ista de operações disponíveis é a seguinte:

Page 86: E3tutorial beginner ptb

86 Comunicação

Lista de operações

10. Estes códigos de operação são util izados posteriormente na configuração dos Tags de Comunicação:

Coils: Código de operação 08

Registers: Código de operação 01

11. Após concluir a configuração, cl ique em OK.

12. Caso precise configurar novamente o Driver, cl ique com o botão direito do mouse no objeto Driver e selecione o item Configuração.

Menu Configuração

11.4.2 Tag de Comunicação1. Clique com o botão direito do mouse no objeto Driver e selecione a opção Inserir - Tag de Comunicação, ou clique em

Adicionar na barra de ferramentas do Driver.

Adicionar Tag de Comunicação

2. A janela de configuração é aberta. Informe a quantidade e o nome do Tag de Comunicação (por exemplo, "Estado1").

Page 87: E3tutorial beginner ptb

Comunicação 87

Configuração do Tag

3. Para configurar os Tags de Comunicação, é necessário preencher as propriedades N1, N2, N3 e N4, conforme asinstruções do manual do Driver Modbus:

N1: Endereço do equipamento escravo (CLP) na rede. Este endereço pode variar entre 1 e 255

N2: Código da operação. Referencia uma operação de leitura ou escrita adicionada na janela de configurações doDriver

N3: Parâmetro adicional

N4: Endereço do Registrador ou da variável no equipamento escravo (CLP) que se deseja ler ou escrever

11.4.2.1 Digital

1. O primeiro Tag Digital é a informação de estado (aberto ou fechado) da Válvula 1. Crie um Tag de Comunicação com onome "Estado_V1".

2. Configure os parâmetros N conforme as informações a seguir:

N1: 1 (Endereço do CLP)

N2: 8 (Código da operação, ou Coil)

N3: 0 (Parâmetro adicional)

N4: 1 (Endereço do registrador)

3. Clique com o botão direito do mouse no objeto Driver e selecione o item Ativar Comunicação para testar as configurações,ou clique em Ativar ou Desativar a Comunicação . Caso as configurações estejam corretas, a l inha do Tag deve ficar nacor azul.

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

Adicionar Pasta

5. Na pasta Digitais devem existir os seguintes Tags:

Endereço 1: Estado_V1

Endereço 2: Estado_V2

Endereço 3: Estado_V3

Endereço 4: Estado_V4

Endereço 5: Estado_Motor

Endereço 11: LocRem_V1

Endereço 12: LocRem_V2

Endereço 13: LocRem_V3

Endereço 14: LocRem_V4

Endereço 15: LocRem_Motor

6. Após a criação dos Tags, teste a comunicação.

Page 88: E3tutorial beginner ptb

88 Comunicação

Ativar a Comunicação

11.4.2.2 Analógico

1. Insira uma nova pasta chamada "Analogicas".

2. Na pasta Analógicas, crie os Tags a seguir:

Endereço 1: Temperatura

Endereço 2: Vazao

3. Configure os parâmetros N conforme as informações a seguir:

N1: 1 (Endereço do CLP)

N2: 1 (Código da operação, ou Register)

N3: 0 (Parâmetro adicional)

N4: 1 ou 2 (Endereço do registrador)

4. Clique com o botão direito do mouse no objeto Driver e selecione o item Ativar Comunicação para testar as configurações,ou clique em Ativar ou Desativar comunicação . Caso as configurações estejam corretas, a l inha do Tag deve ficar na corazul.

11.4.2.3 Escala

O Simulador gera valores analógicos entre 0 e 65535. Desejamos valores em outra faixa, por isto vamos habil itar a função deescala.

Valores para a função de escala

ENDEREÇO NOME MÍNIMO UE MÁXIMO UE UE MÍNIMO I/O MÁXIMO I/O L/E

1 Temperatura 20 200 °C 0 65535 L

2 Vazao 0 100 m³/s 0 65535 L

1. Altere as propriedades dos Tags Analógicos conforme a figura a seguir:

Configuração da escala

2. Teste a comunicação. A coluna Valor já exibe os valores com a escala aplicada e a coluna Valor (sem escala) apresenta osvalores enviados pelo equipamento.

Page 89: E3tutorial beginner ptb

Comunicação 89

Testar a comunicação

11.4.3 Tela CristalizaçãoVamos criar a Tela Cristalização para exibir os valores do Elipse Modbus Simulator.

TelaCristalizacao

1. Clique com o botão direito do mouse na pasta Telas e selecione a opção Inserir Tela em - TreinamentoE3.prj.

2. Na janela de configuração da nova Tela, digite "TelaCristalizacao" no campo Nome. Selecione o Divisor Inferior.

3. Na TelaCristalizacao, configure a propriedade FillStyle para 12 - Picture, para habil itar uma figura de fundo.

4. Para colocar a figura FundoCristal como fundo, arraste o bitmap de Recursos para a propriedade PictureFile da Tela.Configure a propriedade PicturePosition para posicionar melhor a imagem.

5. Na TelaMenu, insira um objeto CommandButton. Na sua propriedade Caption, digite "Cristalização".

6. Selecione o botão e clique na aba Scripts. No evento Click, crie um novo script do tipo Abrir Tela.

Pick Abrir Tela

7. Selecione a TelaCristalizacao no campo Abrir a tela e, no campo No Quadro, selecione o item Inferior.

11.4.4 Display1. Na TelaCristalizacao, insira um Display configurado com uma casa decimal e sufixo "°C". Associe-o ao Tag Analógico

Temperatura.

2. Insira um Display configurado com uma casa decimal e sufixo "m³/s" e associe-o ao Tag Analógico Vazao.

3. Execute a aplicação e teste as novas funcionalidades.

Page 90: E3tutorial beginner ptb

90 Comunicação

11.5 Exercícios Complementares

11.5.1 KBKB-14918: Contagem de Tags no Driver de Comunicação

KB-25284: Trabalhando com escalas no Tag de Comunicação

Page 91: E3tutorial beginner ptb

Comunicação 91

11.6 Anotações

Page 92: E3tutorial beginner ptb

92 Bibliotecas ElipseX

12 Bibliotecas ElipseXCAPÍTULO

O E3 possui ferramentas que permitem transformar qualquer objeto ou conjunto de objetos de uma aplicação em umaBiblioteca do Usuário. A ideia das Bibliotecas de Usuários (chamadas de ElipseX) vem das l inguagens de programaçãoorientadas a objetos, onde diversos componentes podem ser compartilhados entre projetos sem que seja necessáriodesenvolver novamente cada um dos objetos.

O uso de bibliotecas no E3 é altamente recomendável devido ao ganho de produtividade que elas trazem. Algumas dasvantagens dos ElipseX:

Reutil ização de código

Minimização de testes durante o desenvolvimento

Criação de interfaces padrão para os objetos desenvolvidos

Diminuição do tempo de desenvolvimento de novos projetos

Proteção do conteúdo do projeto

O uso de bibliotecas é recomendado na maioria das aplicações.

Bibliotecas de objetos

12.1 Criação de Bibliotecas do UsuárioOs objetos ElipseX podem conter, além de um desenho, variáveis internas que podem ser exportadas para a aplicação, alémde lógicas de programação (scripts) que vão estar presentes em todas as cópias do objeto que está sendo criado, diminuindoa necessidade de repetição de código em diversas partes do aplicativo. Para criar uma nova biblioteca no E3, siga estesprocedimentos:

1. Abra o menu Arquivo, selecione o item Novo Projeto e cl ique em Avançar.

2. Na opção Informe o tipo de Aplicação, selecione Biblioteca de componentes do E3.

Page 93: E3tutorial beginner ptb

Bibliotecas ElipseX 93

Selecionar tipo de aplicação

3. Digite o nome da biblioteca e a pasta onde será salva, e clique em Avançar.

4. Determine as especificações referentes ao Domínio.

5. Clique em Concluir.

Dentro de uma biblioteca ElipseX podem ser inseridos dois tipos de objetos, os objetos gráficos XControls e os objetos dedados XObjects.

Podem ser inseridos nos XControls todos os itens disponíveis para as Telas, descritos nos respectivos capítulos. Entre estesitens estão as primitivas de desenho, objetos gráficos vetoriais, incluindo objetos da biblioteca de símbolos (WMF, EMF, etc.),objetos gráficos não vetoriais (BMP, JPEG, GIF, etc.), controles ActiveX do E3 (E3Chart, E3Browser e E3Alarm), controles ActiveXde terceiros e outros XControls.

Já as bibliotecas de dados podem conter quaisquer tipos de objetos não gráficos, que são executados no E3 Server. Pode-seinserir em um XObject os seguintes objetos: Driver de Comunicação, Servidor de Dados, Banco de Dados, Fórmulas,Configuração de Alarmes, Servidor de Alarmes, Objetos COM, outros XObjects, dentre outros.

Dentro de um mesmo arquivo *.l ib pode haver qualquer número de componentes ElipseX, sejam eles XControls ou XObjects.Pode-se ter também várias bibliotecas diferentes (vários arquivos *.l ib) dentro do mesmo Domínio.

12.1.1 XControlO XControl define uma interface gráfica com o usuário, que pode ser composta de quaisquer objetos do E3, com o propósitode ser multiplicada facilmente por um projeto. Pode-se criar um XControl cl icando com o botão direito do mouse no arquivo*.lib criado no Domínio (Organizer - Explorer) ou em Bibliotecas de Objetos - XControl, selecionando a opção Inserir - XControl.

Page 94: E3tutorial beginner ptb

94 Bibliotecas ElipseX

Aba Design de um XControl

Aba Propriedades de um XControl

Ao inserir um XControl, observe que na parte inferior da tela existem três abas, Design, Propriedades e Scripts. Na abaPropriedades pode-se inserir propriedades a serem exportadas pelo objeto. Elas podem ser associadas a um Tag ou outrapropriedade qualquer quando o objeto estiver em uso em um projeto. Na aba Design, que equivale a uma Tela, pode-se inseriros objetos gráficos descritos anteriormente.

As propriedades a serem exportadas (XProperties) podem ser inseridas através da tecla INS do teclado ou clicando em , eexcluídas clicando em . As opções disponíveis são descritas a seguir.

Opções disponíveis na aba Propriedades de um XControl

OPÇÃO DESCRIÇÃO

Nome Determina o nome da propriedade do XControl .

Tipo Determina o tipo de dado suportado pela propriedade.

Pública Habi l i ta ou desabi l i ta a vis ibi l idade da propriedade fora dabibl ioteca, i s to, é determina se a propriedade é públ ica ounão.

Page 95: E3tutorial beginner ptb

Bibliotecas ElipseX 95

OPÇÃO DESCRIÇÃO

Persistente Determina se a propriedade é sa lva no projeto ou não.

Retentiva Determina se a propriedade é retentiva ou não. No caso deXControls , as propriedades não podem ser retentivas .

Valor inicial Determina o va lor inicia l da propriedade.

Texto de ajuda Texto de declaração e documentação da propriedade.

Note que outros objetos de Dados (XObjects) podem ser declarados como Tipos. Isto permite que em uma única propriedadeseja controlado o funcionamento de todo um objeto, tornando mais fácil a manutenção de uma biblioteca.

A edição do objeto gráfico possui os mesmos recursos gráficos e opções da edição de Telas. Pode-se inserir os XControls emqualquer Tela, ou ainda dentro de outro XControl cl icando com o botão direito do mouse na Tela ou XControl de destino eselecionando a opção Inserir.

A partir deste momento, o XControl tem um nome dentro da Tela, e é entendido como uma cópia da definição original. Assim,deve-se definir (se necessário) os valores ou as Associações que esta cópia específica tem no contexto que está sendoutil izada.

12.1.2 XObjectAlém dos objetos gráficos, pode-se criar uma biblioteca de dados, chamada XObject. Com ela, pode-se definir uma estruturade dados a ser executada no servidor. Tal estrutura poderá realizar cálculos, Associações, comunicações, verificação dealarmes, registro histórico, etc., que independam de alguma interface gráfica (Viewer) aberta ou em execução naquelemomento. Para criar um XObject, cl ique com o botão direito do mouse no arquivo *.l ib no Organizer e escolha a opção Inserir- XObject.

As opções disponíveis para as propriedades do XObject são as mesmas dos XControls, citadas anteriormente.

Além das Propriedades, podem ser inseridos em um XObject quaisquer módulos do E3 que sejam executados no servidor. Parasaber a l ista completa, basta clicar na l ista de seleção Tipo da aba Propriedades e verificar a l ista de tipos disponíveis.

Isto permite que se possa definir como uma biblioteca um sistema complexo de gerenciamento, que pode ser facilmentereplicado quantas vezes forem necessárias no aplicativo.

Pode-se inserir os XObjects em qualquer Servidor de Dados clicando com o botão direito do mouse no Servidor de Dados eselecionando a opção Inserir.

Mesmo que o arquivo de biblioteca possua vários XControls e XObjects, ao tentar inserir uma biblioteca o E3 Studio exibepara as Telas somente os XControls, e para os Servidores de Dados somente os XObjects.

12.2 Quando Criar um ElipseXExistem alguns critérios para indicar a necessidade da construção de objetos no Elipse E3:

Repetição no uso: Se um mesmo equipamento ou processo é usado mais de uma vez no mesmo projeto

Procedimentos de conhecimento do usuário: Frequentemente um processo criado por determinada empresa deve serprotegido de cópia ou alteração. Isto é comum no caso de integradores de serviços ou fabricantes de máquinas

Uso de controladores: Um controlador de processo, cujo mapeamento de memória é fixo, pode ser implementado com todasas funcionalidades disponíveis. A flexibil idade disponível para a construção e uso dos objetos no E3 permite que sejamutil izadas posteriormente apenas as variáveis de interesse, desprezando-se as demais

NOTA: Não é poss ível copiar uma bibl ioteca e uti l i zar os dois arquivos (origina l e cópia) no mesmo Domínio. Por exemplo, nãose pode copiar um arquivo *.l ib para separá-lo em dois arquivos .

12.3 ExercíciosVamos desenvolver uma válvula que contém as informações de estado aberto ou fechado e local ou remoto. Cada válvulatambém possui o comando para alterar estes estados.

Válvula

Page 96: E3tutorial beginner ptb

96 Bibliotecas ElipseX

12.3.1 XControl Válvula1. No Organizer, cl ique com o botão direito do mouse em XControls e selecione o item Inserir XControl em - <Nova

Biblioteca>.

2. Na janela que se abre, selecione o mesmo diretório do projeto TreinamentoE3 e, no campo Nome, digite o nome do novoarquivo, "BibliotecaTreinamento".

Criar nova biblioteca

3. Localize no Organizer o XControl1 criado e altere seu nome para "Valvula".

Page 97: E3tutorial beginner ptb

Bibliotecas ElipseX 97

Mudança de nome do XControl

4. Na aba Design, desenhe o objeto Valvula. Insira a figura valv, adicionada como Recurso, textos e círculos conforme aimagem a seguir.

Aba Design

12.3.2 Propriedades e Associações do XControlPara o objeto Valvula poder receber informações externamente, precisamos criar propriedades.

1. Selecione a aba Propriedades, na parte inferior da Tela.

2. Clique em Adicionar e insira duas novas propriedades, mostradas na figura a seguir.

Page 98: E3tutorial beginner ptb

98 Bibliotecas ElipseX

Adicionar propriedades

3. Selecione novamente a aba Design para associar as propriedades criadas com a cor dos círculos.

4. Abra a janela de propriedades do primeiro círculo e selecione a aba Associações. Na propriedade ForegroundColor, cl ique

em para abrir o AppBrowser.

Propriedade ForegroundColor

5. Selecione o XControl Valvula e a seguir sua propriedade Estado. Clique em Colar.

Page 99: E3tutorial beginner ptb

Bibliotecas ElipseX 99

Propriedade Estado da Válvula

6. Altere o tipo da conexão para Digital e escolha duas cores para simbolizar Aberto (Ligado) e Fechado (Desligado).

Associação do tipo Digital

7. No segundo círculo, crie uma Associação da propriedade ForegroundColor com a propriedade Remoto do XControlValvula. Escolha as cores para Remoto (Ligado) e Local (Desligado).

Page 100: E3tutorial beginner ptb

100 Bibliotecas ElipseX

Associação do tipo Digital

8. Para o nome da válvula ser exibido no texto, crie uma Associação da propriedade Value com a propriedade Name doXControl Valvula.

Associação do nome da válvula

9. Salve a biblioteca.

10. Para que o objeto esteja disponível para util ização, é necessário registrar a biblioteca. No Organizer, cl ique com o botãodireito do mouse no item Bibliotecas de Objeto e selecione a opção Registrar bibliotecas carregadas.

Page 101: E3tutorial beginner ptb

Bibliotecas ElipseX 101

Registrar bibliotecas registradas

12.3.3 Inserindo um XControl na Tela1. Na TelaCristalizacao, insira quatro objetos do tipo Valvula. Na área da Tela, cl ique com o botão direito do mouse e

selecione o item Inserir - Valvula.

Inserir XControl em uma Tela

2. Outro método de inserir um XControl em uma Tela é arrastá-lo do grupo Bibliotecas na Galeria.

Grupo Bibliotecas da Galeria

NOTA: Após inseri r um XControl em uma Tela , ele se comporta como um objeto de Tela e pode ser copiado, arrastado ouredimens ionado.

3. Para testar o funcionamento do objeto Valvula, altere a propriedade Estado e Remoto na l ista de propriedades. A cor

Page 102: E3tutorial beginner ptb

102 Bibliotecas ElipseX

dos círculos deve ser alterada conforme configurado na biblioteca.

Funcionamento do objeto Valvula

12.3.4 Scripts no XControlAo clicar no primeiro círculo, seu estado deve ser alterado de Aberto para Fechado e vice-versa. O mesmo comportamentodeve acontecer com a informação de Remoto e Local.

1. No XControl Valvula, selecione o primeiro círculo e clique na aba Scripts.

Estado da válvula

2. Adicione um script no evento Click. Na primeira l inha, digite um comentário e, com o cursor posicionado na segunda

linha, cl ique em AppBrowser .

Page 103: E3tutorial beginner ptb

Bibliotecas ElipseX 103

AppBrowser

3. No AppBrowser, selecione o XControl Valvula e à direita a propriedade Estado. Clique em Colar.

Selecionar propriedade no AppBrowser

4. Complete o script digitando " = NOT " e busque novamente a propriedade Estado do objeto Valvula.

Page 104: E3tutorial beginner ptb

104 Bibliotecas ElipseX

Completar script da válvula

5. Repita a mesma lógica para criar um script no evento Click do Circulo2 que inverta o valor da propriedade Remoto doobjeto Valvula.

6. Salve e registre a biblioteca.

7. Execute a aplicação e teste as novas funcionalidades.

12.3.5 Associando Tags a um XControlCada válvula possui as informações de Estado e Remoto que são recebidas do equipamento (CLP). No capitulo Comunicação,criamos um Tag para cada informação das quatro válvulas. Vamos agora associar os Tags de Comunicação com arepresentação gráfica do XControl.

1. Na TelaCristalizacao, selecione o objeto Valvula1, abra suas propriedades e selecione a aba Associações. Na

propriedade Estado, cl ique em e abra o AppBrowser.

Page 105: E3tutorial beginner ptb

Bibliotecas ElipseX 105

Propriedade Estado

2. Localize o Tag de Comunicação que contém a informação do estado do objeto Valvula1. O Tag está em Servidor - Driver -Digitais - Estado_V1.

Tag de estado

3. Para ler e escrever a informação de estado, altere a Associação para o tipo Bidirecional.

4. Crie uma Associação Bidirecional da propriedade Remoto para o Tag LocRem_V1.

Page 106: E3tutorial beginner ptb

106 Bibliotecas ElipseX

Tag local ou remoto

5. Crie Associações em todas as válvulas com seus respectivos Tags de Comunicação.

Page 107: E3tutorial beginner ptb

Bibliotecas ElipseX 107

12.4 Anotações

Page 108: E3tutorial beginner ptb

108 Alarmes

13 AlarmesCAPÍTULO

O módulo de Alarmes do E3 consiste basicamente em duas unidades, cujo funcionamento é interligado logicamente:

Servidor de Alarmes: Organiza o modo como os eventos e alarmes são tratados

Configuração de Alarmes: É neste objeto que os alarmes a ser tratados são criados e suas fontes configuradas

13.1 Servidor de AlarmesO objeto Servidor de Alarmes centraliza todos os alarmes do projeto. Nele podem ser encontrados os totais de alarmes ativosda aplicação (reconhecidos ou não). Ele também é o responsável por reportar os eventos de alarmes para todos os Viewersconectados, bem como, se desejado, enviar estes eventos para um Banco de Dados.

IMPORTANTE: Um Domínio pode ter somente um objeto deste tipo, e sua presença é obrigatória para que haja veri fi cação dealarmes .

Através da aba Configuração é possível especificar se os alarmes são armazenados no Banco de Dados. Os alarmes podem servisualizados em um E3Alarm ou em um E3Browser, objetos de Tela que serão vistos mais adiante.

13.2 Configuração de AlarmesO objeto Configuração de Alarmes é onde as Fontes de Alarme são criadas. Para inserir este objeto no projeto, cl ique com obotão direito do mouse sobre o item Objetos de Servidor - Banco de Dados no Organizer e escolha a opção Inserir -Configuração de Alarmes.

13.2.1 ÁreaO objeto Área permite agrupar um conjunto de Fontes de Alarmes, bem como outras Áreas de Alarme. Isto facil ita ogerenciamento, a operação e o monitoramento de um conjunto de Fontes de Alarmes relacionados, permitindo, por exemplo:

Filtrar o conjunto de alarmes visíveis no sumário

Habilitar ou desabil itar um conjunto de Fontes de Alarmes

Reconhecer um conjunto de Fontes de Alarmes

Verificar o total de alarmes ativos ou não reconhecidos de um conjunto de Fontes de Alarmes

Caso haja necessidade, novas Áreas podem ser inseridas dentro de outras.

13.2.2 Fontes de AlarmeAs Fontes de Alarme definem todas as informações relativas às condições de alarme. Em cada Fonte de Alarme sãoconfigurados seus l imites, a mensagem relativa ao evento e sua severidade, bem como a necessidade ou não dereconhecimento deste evento. Todas as Fontes de Alarmes possuem as propriedades gerais descritas na tabela a seguir.

Propriedades gerais das Fontes de Alarme

PROPRIEDADE DESCRIÇÃO

Texto da Mensagem É o texto associado àquela condição de a larme, que apareceno objeto de visua l i zação (E3Alarm), Banco de Dados , etc.Pode conter até 255 caracteres de texto.

Severidade Indica a gravidade do a larme ocorrido, podendo ser Baixa,Média ou Alta. A severidade é uti l i zada para fi l tragem eordenação de mensagens .

Pede Ack Indica que o a larme deve ser reconhecido pelo operador paraser reti rado da l i s ta de a larmes no E3Alarm, ou a inda se éreconhecido automaticamente quando a variável deixa umacondição de a larme.

Mensagem de Retorno Sempre que uma Fonte de Alarme sa i da condição de a larme,esta mensagem é exibida nos objetos de visua l i zação.

Há vários tipos de Fontes de Alarme que podem ser inseridas na Área do Alarme. Os tipos de Fontes de Alarmes estãodescritos nas seções seguintes.

Page 109: E3tutorial beginner ptb

Alarmes 109

13.2.2.1 Analógico

Permite monitorar uma variável analógica, pela especificação de até quatro níveis de alarme: LOLO (muito baixo), LO (baixo),HI (alto) e HIHI (muito alto).

Alarme Analógico

13.2.2.2 Banda Morta

Permite monitorar uma variável analógica pela especificação de um limite máximo de diferença (valor de banda morta) emrelação a um valor de referência (Setpoint).

Alarme Banda Morta

13.2.2.3 Taxa de Variação

Permite monitorar variações muito rápidas em uma variável do processo. A taxa de variação usa seus valores especificadosem unidades da variável por segundo.

Page 110: E3tutorial beginner ptb

110 Alarmes

Alarme Taxa de Variação

13.2.2.4 Digital

Permite monitorar uma variável (ou expressão) digital, pela especificação de alarme na borda de subida (em -1 ouVerdadeiro) ou na borda de descida (em 0 ou Falso).

Alarme Digital

Page 111: E3tutorial beginner ptb

Alarmes 111

13.2.2.5 Discreto

Permite monitorar uma variável pela especificação de múltiplas subcondições.

Alarme Discreto

13.3 E3AlarmO E3Alarm serve para o monitoramento dos alarmes ativos ou não reconhecidos no sistema. Através deste objeto, é possívelverificar o estado dos alarmes no sistema, bem como reconhecê-los manualmente. Para util izar este objeto, cl ique com obotão direito do mouse na área de trabalho, e selecione a opção E3Alarm.

E3Alarm

Na aba Geral das propriedades do E3Alarm são especificadas as informações referentes ao Servidor de Alarmes e ao fi ltro.

Aba Geral

Page 112: E3tutorial beginner ptb

112 Alarmes

13.4 Exercícios

13.4.1 Configuração de Alarmes1. Caso não exista, insira no projeto TreinamentoE3 um objeto Configuração de Alarmes.

Inserir Configuração de Alarmes

13.4.2 Alarme Analógico1. Crie uma nova Área de Alarmes no objeto Configuração de Alarmes, cl icando em Adicionar e modifique seu nome para

Caldeira.

Inserir Área

2. Selecione a Área criada e clique em Adicionar. Insira uma Fonte de Alarme do tipo Analógico.

Inserir Fonte de Alarme Analógica

3. Renomeie o Alarme Analógico para Nivel.

4. Clique sobre a área de edição da Fonte de Nivel e, usando o AppBrowser, selecione a propriedade Value do Tag Nivel dapasta Dados.

5. Abra as propriedades do Alarme Nivel, selecione a aba Analógico e configure-a conforme a figura a seguir.

Page 113: E3tutorial beginner ptb

Alarmes 113

Aba Analógico

13.4.3 Alarme Digital1. Na Área Caldeira, insira um Alarme Digital chamado Motor.

2. No campo Fonte, selecione o Tag Motor.

3. Abra as propriedades do Alarme Motor, selecione a aba Digital e digite a mensagem que desejar.

Aba Digital

13.4.4 Alarme Banda Morta1. Na Área Caldeira, insira um Alarme de Banda Morta chamado Vapor.

2. No campo Fonte, selecione a propriedade Value do Tag Vapor.

Propriedade Value do Tag Vapor

3. Abra as propriedades do Alarme Vapor, selecione a aba Banda Morta e configure-a como mostrado na figura a seguir.

Page 114: E3tutorial beginner ptb

114 Alarmes

Propriedades do Alarme Vapor

13.4.5 Alarme Taxa de Variação1. Na Área Caldeira, insira um Alarme Taxa de Variação chamado Vazao.

2. No campo Fonte, selecione a propriedade Value do Tag Vazao.

Propriedade Value do Tag Vazao

3. Abra as propriedades do Alarme Vazao, selecione a aba Taxa de Variação e configure-a como mostrado na figura a seguir.

Propriedades do Alarme Vazao

13.4.6 E3AlarmA visualização dos alarmes em tempo real pode ser feita através do objeto E3Alarm.

1. Posicione um objeto E3Alarm na TelaCaldeira.

2. Nas propriedades do E3Alarm, aba Geral, informe o nome do Servidor de Alarmes.

Page 115: E3tutorial beginner ptb

Alarmes 115

Aba Geral do E3Alarm

3. A mesma configuração pode ser feita através da Lista de Propriedades. Na propriedade AlarmServer, digite o nome doServidor de Alarmes, ou arraste-o até a propriedade.

Propriedade AlarmServer do E3Alarm

4. Abra as propriedades do E3Alarm e, na aba Colunas, selecione os campos DataHora, Operador, Mensagem, Reconhecido eValor.

5. Na aba Cores, faça a configuração que desejar.

Page 116: E3tutorial beginner ptb

116 Alarmes

13.5 Anotações

Page 117: E3tutorial beginner ptb

Armazenamento de Dados 117

14 Armazenamento de DadosCAPÍTULO

Este capítulo contém informações sobre as opções de armazenamento de dados do E3: Bancos de Dados e Históricos.

14.1 Banco de DadosO Banco de Dados do E3 é util izado para armazenar as informações do projeto referentes aos Históricos, Fórmulas e Alarmes.Possui suporte a MDB (Microsoft Access), Oracle e Microsoft SQL Server. Para util izar este recurso, siga estes procedimentos:

1. Clique com o botão direito do mouse sobre o nome do projeto e selecione a opção Inserir - Banco de Dados.

2. No caso do banco de dados Access, digite o nome do arquivo desejado (existente ou não) no campo Arquivo MDB.

3. Deixe em branco os campos Usuário e Senha. Estes campos são util izados somente se o banco de dados especificado paraa conexão já possuir usuário e senha.

4. Deixe o campo Senha do BD em branco. Conforme especificado anteriormente, este campo só é util izado caso o banco dedados possua senha.

5. Clique em OK para finalizar as configurações.

14.2 HistóricosHistóricos são os módulos responsáveis pelo armazenamento de dados da aplicação em Banco de Dados. Permitem armazenardados de processos para análises futuras, no E3 ou em qualquer outra ferramenta.

Pode-se criar tantos arquivos de Histórico quantos se desejar, cada um contendo diversos Tags ou expressões. Cada Históricopode criar ou util izar uma tabela independente dentro do Banco de Dados, cujo armazenamento pode ser definido por Tempoou por Evento. É possível ainda determinar qual Banco de Dados inserido no projeto será util izado para o armazenamentodos dados.

Para util izar este recurso, cl ique com o botão direito do mouse no item Objetos do servidor - Banco de dados no modo Domínioe selecione a opção Inserir Histórico em e, em seguida, o nome do projeto desejado.

Para criar a tabela no Histórico, é importante criar seus campos. Tais campos podem ser criados ao clicar em Adicionar .Para remover algum campo indesejado, cl ique em Remover .

Adicionar ou remover campos do Histórico

14.2.1 Chave PrimáriaA Chave Primária é um campo ou um conjunto de campos que identifica de maneira única cada registro de uma tabela. Assimcomo o índice principal para a tabela, ela é util izada para associar dados entre tabelas. Após ter definido um campo como

Page 118: E3tutorial beginner ptb

118 Armazenamento de Dados

sendo a chave primária da tabela, o próprio Banco de Dados garante que não sejam inseridos dados duplicados no(s) campo(s) que seja(m) chave(s) primária(s).

Há dois tipos de chave primária, a Simples e a Composta. Uma Chave Primária Simples é um campo que identifica de modoúnico cada registro de uma tabela. Uma Chave Primária Composta pode ser formada pela combinação de dois ou maiscampos da tabela. Podem existir casos em que um único campo não seja capaz de atuar como chave primária, pelo fato deapresentar valores repetidos. Além disto, uma tabela pode ter somente uma Chave Primária, seja ela simples ou composta. Ouseja, não se podem definir dois ou mais campos de uma tabela para ser uma chave primária separada cada. Não confundircom o caso de uma chave primária composta, onde a união de dois ou mais campos é que forma a chave primária única databela.

Ao escolher campos para uma chave primária, considere os seguintes detalhes:

Não é permitida duplicidade de valores ou valores nulos

Caso não exista um identificador único para uma determinada tabela, pode-se usar um campo que numere os registrossequencialmente

A chave primária pode ser configurada de duas formas: Verificando na Tela do Histórico o campo da tabela que se deseja

tornar Chave Primária e habil itando-o ao clicar em , ou clicando em para abrir a janela de configuração.

14.2.1.1 Índices

Um Índice é um campo ou um conjunto de campos que são previamente ordenados pelo Banco de Dados, a fim de melhorar aperformance das consultas que util izam este índice. Eles são util izados para encontrar registros com um valor específico emuma coluna rapidamente. Sem um índice, o Banco de Dados tem de iniciar com o primeiro registro e depois ler os registrosatravés de toda a tabela até que se encontre os registros relevantes. Quanto maior a tabela, maior é o custo em termos detempo de processamento. Se a tabela possui um índice para as colunas em questão, o Banco de Dados pode rapidamenteobter uma posição para procurar no meio do arquivo de dados sem ter que varrer todos os registros. Os tipos de índicesdisponíveis são Primário, Único e Index.

Podem-se criar índices em múltiplas colunas. Um índice de múltiplas colunas pode ser considerado um vetor ordenadocontendo valores que são criados concatenando valores de colunas indexadas. Os índices podem ser configurados através doícone , que abre a tela de configuração i lustrada a seguir.

Editor de Índices

14.3 Exercícios

14.3.1 Banco de DadosEste banco de dados será util izado para armazenar todos os dados de Alarmes e Históricos dos projetos.

1. Caso não exista, insira um novo Banco de Dados no projeto TreinamentoE3.

Page 119: E3tutorial beginner ptb

Armazenamento de Dados 119

Inserir Banco de Dados

2. Renomeie o banco de dados para BancoDados.

3. Selecione o tipo de banco de dados como 0 - stAccess.

4. No campo Arquivo MDB digite "C:\TreinamentoE3\Dados.mdb".

5. Teste a conexão com o banco de dados.

14.3.2 Servidor de Alarmes1. Abra a janela de propriedades do Servidor de Alarmes e, na aba Configuração, habil ite a opção Guarde alarmes no banco

de dados.

2. Na opção Utilize o servidor de banco de dados, selecione BancoDados.

3. Habilite a opção Descarta dados da tabela principal e especifique os seguintes valores:

Mantenha os dados dos últimos 3 meses

A verificação deve ocorrer a cada 1 mês

Page 120: E3tutorial beginner ptb

120 Armazenamento de Dados

Configuração do Servidor de Alarmes

4. Clique em Campos e selecione os campos que desejar.

Seleção de campos

5. Por último, clique em Gerar Tabela. A mensagem a seguir é exibida.

Page 121: E3tutorial beginner ptb

Armazenamento de Dados 121

Tabela criada com sucesso

14.3.3 Histórico

1. Clique com o botão direito do mouse no Banco de Dados, no modo Domínio, e insira um novo Histórico no projetoTreinamentoE3, nomeando-o como HistCaldeira.

Inserir Histórico

2. No Histórico criado, insira três novos campos e configure-os conforme a figura a seguir.

Adicionar campos

3. Clique em Propriedades e, na aba Histórico, configure as seguintes propriedades:

Banco de dados: BancoDados

Nome da Tabela: Caldeira

Gravar um novo registro a cada: 5000 ms

Page 122: E3tutorial beginner ptb

122 Armazenamento de Dados

Aba Histórico

4. Clique em Gerar Tabela. A mensagem a seguir é exibida.

Tabela criada com sucesso

14.4 Exercícios Complementares

14.4.1 KBKB-29527: Quais são os bancos de dados suportados pelo E3?

Page 123: E3tutorial beginner ptb

Armazenamento de Dados 123

14.5 Anotações

Page 124: E3tutorial beginner ptb

124 Consultas

15 ConsultasCAPÍTULO

O objeto Consulta (ou Query) auxil ia no processo de definição de consultas no Banco de Dados da aplicação. Toda vez que oE3 necessita buscar dados do Banco de Dados é necessário enviar um comando, de forma que se saiba quais os dadosdesejados para aquele objeto. Para esta busca, toda vez que uma aplicação precisar gravar ou buscar dados armazenados emum Banco de Dados, são enviados comandos no formato SQL (Structured Query Language).

A Consulta apresenta uma interface amigável, que permite a construção de consultas SQL usando uma interface gráfica e oacompanhamento imediato do código SQL sendo gerado. A Consulta permite mostrar os dados dos últimos n dias, horas oumeses, data inicial e final e consultas, dependendo do fi ltro a ser implementado.

O assistente de configuração da Consulta é responsável por criar o texto que faz o fi ltro ou a consulta, não sendo necessáriopara o usuário saber detalhes como data, etc.

Para util izar este recurso, cl ique com o botão direito do mouse sobre a Tela do projeto e selecione a opção Inserir - Consulta.

NOTA: Quando é criado um objeto Relatório ou E3Browser, o objeto Consul ta é adicionado a este automaticamente. Noentanto, também pode-se inseri r uma Consul ta em uma Pasta de Dados ou em uma Tela e uti l i zar seus dados através descripts .

15.1 Criando uma Consulta1. A definição da Consulta começa quando o usuário informa o Servidor de Banco de Dados onde a Consulta busca os

dados.

Definir o Servidor de Banco de Dados

2. Após ser definido o Banco de Dados, uma nova janela aparece com as tabelas que foram encontradas, permitindo a suaseleção.

Seleção de tabelas

3. Selecione as tabelas que farão parte da Consulta e clique em OK.

4. Na aba Campos são adicionados os campos a serem retornados pela Consulta, bem como definidos fi ltros e ordenações.

Page 125: E3tutorial beginner ptb

Consultas 125

5. Na aba Variáveis são mostradas as variáveis criadas para os fi ltros.

6. Na aba Visualizar pode-se realizar uma prévia da Consulta.

7. Na aba SQL pode-se visualizar e editar o código SQL.

Configuração da Consulta

A janela anterior pode ser aberta ao clicar com o botão direito do mouse sobre o objeto, selecionando a opção Configurar.

15.2 E3BrowserO E3Browser é um controle ActiveX (desenvolvido pela Elipse Software) util izado para visualizar dados armazenados emBanco de Dados, gerados pelo E3 ou outro software qualquer. Pode-se configurar Consultas util izando fi ltros de vários tiposnos dados e atribuir cores para cada coluna, entre outras configurações. Este objeto é util izado para visualizar os Históricos,Alarmes ou qualquer tabela existente no Banco de Dados.

E3Browser

Para util izar este recurso, cl ique com o botão direito do mouse na Tela e selecione a opção Inserir - E3Browser.

Page 126: E3tutorial beginner ptb

126 Consultas

Inserir E3Browser

O E3Browser util iza o objeto Consulta para auxil iar o usuário no processo de definição de consultas no Banco de Dados daaplicação.

15.3 ExercíciosVamos visualizar os dados de Alarmes armazenados no Banco de Dados em forma de tabela util izando o objeto E3Browser.

15.3.1 Tela Eventos1. Clique com o botão direito do mouse na pasta Telas e selecione a opção Inserir Tela em - TreinamentoE3.prj.

2. Na janela de configuração da nova Tela, digite "TelaEventos" no campo Nome e selecione o Divisor Inferior.

3. Insira um objeto CommandButton na TelaMenu. Na propriedade Caption, digite "Eventos".

4. Selecione o botão e clique na aba Scripts. No evento Click, crie um novo script do tipo Abrir Tela.

Pick Abrir Tela

5. Selecione a TelaEventos no campo Abrir a tela e, no campo Quadro, selecione o item Inferior.

15.3.2 Alarmes Históricos

1. Insira um E3Browser na TelaEventos.

2. Para configurar os dados que o E3Browser mostra, cl ique duas vezes no E3Browser e selecione a aba Consulta.

3. Selecione a Consulta1 e cl ique em Configurar.

Page 127: E3tutorial beginner ptb

Consultas 127

Propriedades do E3Browser

4. Selecione o Banco de Dados que contém a tabela que se deseja consultar.

5. Escolha a tabela Alarmes.

6. Selecione todos os campos da tabela Alarmes.

Tabela Alarmes

7. Selecione a aba Visualizar e cl ique em Executar Consulta para verificar o resultado da consulta.

Executar Consulta

8. Clique em OK. Ao finalizar este passo, todos os campos l istados na consulta estão disponíveis no E3Browser. Configurecada campo com a cor, formatação e tamanho que desejar.

9. Na aba Opções do E3Browser, configure a atualização para ser feita a cada cinco segundos.

Page 128: E3tutorial beginner ptb

128 Consultas

Aba Opções

15.3.3 Tela Histórico1. Clique com o botão direito do mouse na pasta Telas e selecione a opção Inserir Tela em - TreinamentoE3.prj.

2. Na janela de configuração da nova Tela, digite "TelaHistorico" no campo Nome e selecione o Divisor Inferior.

3. Insira um objeto CommandButton na TelaMenu. Na propriedade Caption, digite "Histórico".

4. Selecione o botão e clique na aba Scripts. No evento Click, crie um novo script do tipo Abrir Tela.

Pick Abrir Tela

5. Selecione a TelaHistorico no campo Abrir a tela e, no campo Quadro, selecione o item Inferior.

15.3.4 Dados Históricos

1. Insira um E3Browser na TelaHistorico.

2. Para configurar os dados que o E3Browser mostra, cl ique duas vezes no E3Browser e selecione a aba Consulta.

3. Selecione a Consulta1 e cl ique em Configurar.

Propriedades do E3Browser

4. Selecione o Banco de Dados que contém a tabela que se deseja consultar.

5. Escolha a tabela Caldeira.

Page 129: E3tutorial beginner ptb

Consultas 129

6. Selecione os campos da tabela que deseja visualizar.

7. Selecione a aba Visualizar e cl ique em Executar Consulta para verificar o resultado da Consulta.

Executar Consulta

8. Clique em OK. Ao finalizar este passo, todos os campos l istados na Consulta estão disponíveis no E3Browser. Configurecada campo com a cor, formatação e tamanho que desejar.

9. Na aba Opções do E3Browser, configure a atualização para ser feita a cada cinco segundos.

Aba Opções

Page 130: E3tutorial beginner ptb

130 Consultas

15.4 Anotações

Page 131: E3tutorial beginner ptb

Relatórios 131

16 RelatóriosCAPÍTULO

O Relatório é um componente ActiveX chamado ActiveReport, que permite a visualização e impressão de valores instantâneosde variáveis do sistema e dados armazenados em Banco de Dados (Alarmes, Históricos, Consultas e Fórmulas).

Para util izar o Relatório, cl ique com o botão direito do mouse no item Visualização - Relatórios no modo Domínio e selecione aopção Inserir Relatório em e o nome projeto desejado.

O Relatório também util iza o objeto Consulta. Este objeto permite que seja especificada a origem dos dados que serãovisualizados no Relatório.

Um Relatório contém várias seções. Cada seção do Relatório contém um grupo de controles que são processados e impressosao mesmo tempo, como uma unidade.

Relatório

Um Relatório é estruturado da seguinte forma:

Estrutura de um Relatório

SEÇÃO DESCRIÇÃO

Report Header Esta seção é impressa no início do Relatório. Uti l i zada paraimprimir títulos de Relatórios , tabelas de somas , gráficos ouqualquer outra informação que necess i te aparecer somenteuma vez no início do Relatório.

Report Footer Esta seção é impressa no fina l do Relatório. Uti l i zada paraimprimir uma soma de um Relatório, tota is gera is ou qualqueroutra informação que necess i te ser impressa somente umavez no fina l do Relatório.

Page Header Esta seção é impressa no topo de cada página do Relatório. Éa primeira seção impressa na página, exceto quando estapágina contém a seção Report Header. Uti l i zada para imprimircabeçalhos de colunas , números de páginas , títulos depáginas ou qualquer outra informação que necess i te serimpressa no início de cada página.

Page Footer Esta seção é impressa uma vez na base de cada página noRelatório. Usada para imprimir tota is de páginas , números depáginas ou qualquer outra informação que necess i te serimpressa uma vez na base de cada página.

Detail Esta seção é o corpo do Relatório, que imprime uma vez paracada regis tro da fonte de dados .

Group Header, Group Footer Um Relatório pode ter múltiplos grupos aninhados . Cadagrupo possui uma seção Header e uma seção Footer. A seçãoHeader é impressa antes de qualquer seção Detail no grupo. Aseção Footer é impressa depois da seção Detail do grupo.

Page 132: E3tutorial beginner ptb

132 Relatórios

A barra de ferramentas Relatórios contém três itens de configuração que permitem editar, visualizar o Relatório e criarscripts. Estes itens são descritos na tabela a seguir.

Opções de configuração na barra de ferramentas Relatórios

ÍCONE OPÇÃO DESCRIÇÃO

Prévia de Impressão (Preview) Através desta opção, é poss ívelvisua l i zar uma prévia da impressão doRelatório. Ass im é poss ível veri fi carconfigurações de margem, figuras , etc.

Configurações do Relatório (Report Settings) Nestas configurações , pode-sedeterminar Configurações de Página,Configurações de Impressão,Configurações da Grade e Esti lo doRelatório.

Editor de Scripts Através desta opção, é poss ível edi tarscripts para o Relatório. No campo Objecté necessário especi ficar o objeto ondese deseja criar o script e, no campo Events, o evento do Relatório em queocorre a ação.

16.1 Objetos do RelatórioA ferramenta Relatório possui vários objetos específicos, que podem ser util izados através da barra de ferramentas Relatórios.

Barra de ferramentas Relatório

Os recursos disponíveis na barra de ferramentas Relatórios estão descritos na tabela a seguir.

Recursos disponíveis na barra de ferramentas Relatórios

ÍCONE OPÇÃO DESCRIÇÃO

Linha Objeto bás ico de reta que l iga doispontos quaisquer. Permite o desenho deretas , através de dois pontosespeci ficados na sua criação ou empol ígonos .

Retângulo Este objeto permite o desenho deretângulos , uti l i zando toda a largura oual tura do objeto. Criado a parti r de doisvértices .

Retângulo Arredondado Retângulo criado através de dois vérticescom a opção dos cantos seremarredondados a parti r de um fator dearredondamento. Ao ser inserido oueditado, exibe um pequeno pontopróximo ao canto superior esquerdo, quepermite modi ficar o fator dearredondamento.

Elipse Este objeto permite o desenho decírculos e el ipses , uti l i zando toda alargura ou a l tura e definindo o centro docírculo no centro do retângulo.

Figura Este objeto permite mostrar imagensque estejam armazenadas em arquivos ,estejam elas dentro ou fora do arquivodo apl icativo.

Texto Poss ibi l i ta a criação de um texto. Aodefini r a área na Tela , pode-se digi tardi retamente o texto desejado, queacei ta também múltiplas l inhas .

Campo de Dados Através deste objeto é poss ível associarum campo da tabela no Banco de Dados .Este campo é especi ficado napropriedade DataField.

Page 133: E3tutorial beginner ptb

Relatórios 133

ÍCONE OPÇÃO DESCRIÇÃO

Código de Barras Permite gerar uma figura que converteuma sequência de números e caracteresem um código de barras . Es te código éuma representação numérica oual fanumérica , uti l i zada para faci l i tardi ferentes processos . Es te código édeci frado através de scanners , canetas eequipamentos de lei tura óptica .

Quebra de Página É um ponto em que uma página terminae outra começa no Relatório. Porexemplo, pode-se forçar uma quebra depágina para assegurar que o título deum capítulo comece sempre em umanova página.

Tabela É um objeto composto por l inhas ecolunas onde são inseridos textos ougráficos . As tabelas nos Relatórios sãousadas para organizar e apresentarinformações . Pode-se também usartabelas para criar layouts de página.

E3Chart Este objeto é uti l i zado para visua l i zar osdados do Relatório em formato gráfico.Maiores informações estão descri tas nocapítulo E3Chart.

Enviar para frente e Enviar para trás Através destes botões , é poss ível enviarum objeto para frente ou para trás deoutro. Ao escolher as opções Enviar parafrente ou Enviar para trás, o objetoselecionado será colocado na primeiraou na úl tima pos ição na ordem desobrepos ições , respectivamente.

Carregar Arquivo RPX Importa a configuração do Relatório deum arquivo externo.

Salvar Arquivo RPX Exporta a configuração do Relatório paraum arquivo externo.

16.2 Exercícios

16.2.1 RelatórioNeste exercício, vamos construir um relatório de alarmes.

Objeto Relatório

1. Insira um novo Relatório no projeto TreinamentoE3 chamado RelatorioAlarmes.

Page 134: E3tutorial beginner ptb

134 Relatórios

Inserir Relatório

16.2.2 Consulta do Relatório1. Localize o objeto Consulta que acompanha o Relatório. Clique com o botão direito do mouse no objeto e selecione a

opção Configurar.

Configurar Consulta

2. Configure a Consulta do Relatório para buscar os campos da tabela Alarmes.

Page 135: E3tutorial beginner ptb

Relatórios 135

3. Após a configuração, cl ique em OK.

16.2.3 Detail1. Na seção Detail, insira um Campo de Dados para cada campo escolhido na Consulta. Nas propriedades DataField e

Text, digite exatamente o título da coluna configurada na Consulta.

Seção Detail

2. Diminua a altura da seção Detail para o tamanho próximo de uma linha de registro.

3. Para visualizar o Relatório, cl ique em Gerar Relatório na barra de ferramentas.

Page 136: E3tutorial beginner ptb

136 Relatórios

16.2.4 Page HeaderA seção Page Header é o cabeçalho da página. Ela aparece no topo de todas as páginas do Relatório. Normalmente contém otítulo das colunas e um logotipo da empresa.

1. Adicione dois objetos Texto na seção Page Header. Na propriedade Caption do primeiro Texto, digite "Elipse SoftwareLtda - Treinamento E3 Studio", e na propriedade Caption do segundo Texto, digite "Relatório de Alarmes".

2. Para cada campo escolhido na Consulta, insira novos objetos Texto na seção Page Header e configure-os com o nome doscampos. Estes serão os títulos das colunas.

Page Header

16.2.5 Numeração de PáginaO uso dos campos de dados do Relatório do E3 é bastante flexível, sendo configurado no próprio Campo de Dados que afunção deve executar. Por exemplo, para criar na seção Page Footer a indicação "Página 1 de 12", siga estes procedimentos:

1. Insira dois Textos, "Página" e "de".

2. Entre os Textos, insira um Campo de Dados e configure-o para mostrar o número da página atual:

SummaryType: 4 - ddSMPageCount

SummaryRunning: 2 - ddSRAll

3. Após o texto "de", insira um Campo de Dados e configure-o para mostrar o número total de páginas:

SummaryType: 4 - ddSMPageCount

SummaryRunning: 0 - None

16.2.6 Visualizar RelatórioPara visualizar o Relatório em tempo de execução, siga estes procedimentos:

1. Insira um Botão de Comando com o texto "Relatório" no canto inferior da TelaEventos.

2. No evento Click, crie um Pick do tipo Imprimir Relatório .

3. No campo Imprimir Relatório, selecione o RelatorioAlarmes.

4. Na opção Saída, selecione o item Tela.

Page 137: E3tutorial beginner ptb

Relatórios 137

Imprimir Relatório

Page 138: E3tutorial beginner ptb

138 Relatórios

16.3 Anotações

Page 139: E3tutorial beginner ptb

Exercícios de Revisão 139

17 Exercícios de RevisãoCAPÍTULO

Esta seção contém exercícios de revisão de todo o conteúdo do Tutorial.

17.1 ExercícioUma mineradora deseja monitorar os níveis de alguns tanques. O equipamento ainda não está decidido, mas deve trazer ainformação de quatro níveis.

O gerente do setor gostaria de visualizar os dados de forma amigável ao usuário, por isto pediu que fosse desenvolvido umsupervisório com os seguintes requisitos:

Simular os valores dos quatro níveis do equipamento em falta (valores entre 0 e 100)

A Tela principal deve ter uma imagem da mineração

Imagem da mineração

Sobre cada tanque, visualizar o nível através de uma barra

Nível do tanque

Exibir o valor do nível na Tela formatada com sua unidade de engenharia igual a "%", uma casa decimal e obedecendo atabela de cores a seguir:

Page 140: E3tutorial beginner ptb

140 Exercícios de Revisão

Cores dos níveis

MÍNIMO MÁXIMO COR90 100 Vermelho70 90 Amarelo30 70 Branco10 30 Azul0 10 Verde

Sinalizar na Tela os alarmes de todos os níveis, conforme a tabela a seguir:

Limites dos alarmes

ALARME LIMITE

HiHi 90

Hi 70

Lo 30

LoLo 10

Na Tela principal deve ser possível identificar o usuário logado

Um usuário pertencente ao grupo Manutenção NÃO pode reconhecer alarmes

Em uma segunda Tela, deve ser possível visualizar os quatro níveis em um gráfico, onde é possível escolher através debotões qual informação exibir simultaneamente

Gráfico de níveis

Armazenar os dados de nível a cada dois segundos em um banco de dados

Visualizar os dados armazenados no banco de dados em forma de tabela, na mesma Tela do gráfico

Um relatório com os dados de nível armazenados no banco de dados deve ser exportado para o formato PDF

Page 141: E3tutorial beginner ptb

Exercícios de Revisão 141

17.2 ResoluçãoSimular os valores dos quatro níveis do equipamento em falta (valores entre 0 e 100)

1. Para simular valores, criar Tags do tipo Demo, com os l imites máximo e mínimo conforme especificação.

Tags de tipo Demo

A Tela principal deve ter uma imagem da mineração

1. Inserir a figura como Recurso.

2. Alterar a propriedade FillStyle da Tela para 12 - bkPicture.

3. Informar o nome da figura na propriedade PictureFile da Tela.

Sobre cada tanque, visualizar o nível através de uma barra

1. Inserir um Retângulo na Tela sobre o tanque.

2. Abrir a janela de propriedades do Retângulo e selecionar a aba Associação.

3. Criar uma Associação entre a propriedade VerticalPercentFill e o Tag Nivel correspondente.

Associação com a propriedade VerticalPercentFill

Exibir o valor do nível na Tela formatada com sua unidade de engenharia igual a "%", uma casa decimal e obedecendo atabela de cores

1. Como são diversos Displays iguais, a melhor opção é criar um XControl.

2. Crie um arquivo de biblioteca e insira-o no Domínio.

3. Insira um XControl e mude o nome para "DisplayNivel".

DisplayNivel

4. Crie uma propriedade com o nome "Nivel", do tipo Double.

Propriedade Nivel

5. Desenhe um Display.

6. Formate o Display com a expressão '0.0 "%"'.

7. Crie uma Associação Simples entre a propriedade Nivel e a propriedade Value do Display.

Associação com a propriedade Nivel

8. Crie uma Associação por Tabela na propriedade ForegroundColor, informando os l imites e as cores desejadas. Napropriedade Fonte, selecione a propriedade Nivel criada anteriormente.

Page 142: E3tutorial beginner ptb

142 Exercícios de Revisão

Associação por Tabela

9. Salve a biblioteca e registre-a.

10. Insira na Tela um XControl do tipo DisplayNivel.

11. Crie uma Associação Simples entre a propriedade Nivel e o Tag desejado.

Associação Simples

Sinalizar na Tela os alarmes de todos os níveis, conforme tabela

1. Se não existir no Domínio, insira um objeto Servidor de Alarmes.

2. Se não existir no Domínio, insira um objeto Configuração de Alarmes.

Servidor e Configuração de Alarmes

3. Na Configuração de Alarmes, insira uma Área de Alarme.

4. Na Área de Alarme, insira um Alarme Analógico.

Alarme Analógico

5. Abra a janela de propriedades da Fonte de Alarme e selecione a aba Analógico. Informe os l imites e mensagens dealarmes, conforme a tabela.

Page 143: E3tutorial beginner ptb

Exercícios de Revisão 143

Aba Analógico

6. Na coluna Fonte, selecione o Tag que deseja monitorar o alarme.

7. Insira quantos alarmes forem necessários e configure-os seguindo os passos anteriores.

Alarmes

Na Tela principal deve ser possível identificar o usuário logado

1. Crie um Display na Tela.

2. Crie uma Associação Simples entre a propriedade Value do Display e a propriedade User do Viewer.

3. Insira um botão ao lado do Display.

Botão Login

4. No botão, crie o script a seguir.

Application.Login(True)

5. Selecione o menu Arquivo - Usuários e crie pelo menos um usuário.

Page 144: E3tutorial beginner ptb

144 Exercícios de Revisão

Menu Arquivo - Usuários

Um usuário pertencente ao grupo Manutenção NÃO pode reconhecer alarmes

1. Selecione o menu Arquivo - Usuários.

2. Crie o grupo Manutenção.

3. Insira um usuário no grupo Manutenção.

4. Na aba Permissões, bloqueie o reconhecimento de alarmes para o grupo Manutenção.

Aba Permissões

Em uma segunda Tela, deve ser possível visualizar os quatro níveis em um gráfico, onde é possível escolher através de

Page 145: E3tutorial beginner ptb

Exercícios de Revisão 145

botões qual informação exibir simultaneamente

1. Crie uma nova Tela.

2. Insira um objeto E3Chart nesta Tela.

3. Abra a janela de propriedades do E3Chart e selecione a aba Penas.

4. Insira uma Pena.

5. Escolha um nome e uma cor.

6. Na aba Dados, mantenha a Pena como Tempo Real e selecione o Tag no campo Link do Eixo Vertical.

7. Repita os passos anteriores para incluir as demais Penas.

Aba Penas

8. Na Tela principal, crie um botão para abrir a Tela do gráfico.

Armazenar os dados de nível a cada dois segundos em um banco de dados

1. Se não existir, insira um objeto Banco de Dados e configure-o.

2. Insira um objeto Histórico no projeto.

3. Crie campos para cada informação que deseja armazenar e associe-os aos Tags desejados na coluna Fonte.

Coluna Fonte

4. Abra a janela de propriedades do Histórico e configure o nome do Banco de Dados, nome da tabela (TabelaNivel) e tempode gravação (2000 ms).

Page 146: E3tutorial beginner ptb

146 Exercícios de Revisão

Aba Histórico

Visualizar os dados armazenados no banco de dados em forma de tabela, na mesma Tela do gráfico

1. Insira na Tela um objeto E3Browser.

2. Abra a janela de propriedades, selecione a aba Consulta e cl ique em Configurar.

Configurar a Consulta

3. Configure a Consulta para buscar no Banco de Dados a tabela criada.

4. Escolha os campos que deseja buscar e, na aba Visualizar, cl ique em para verificar os dados.

Page 147: E3tutorial beginner ptb

Exercícios de Revisão 147

Aba Visualizar

Um relatório com os dados de nível armazenados no banco de dados deve ser exportado para o formato PDF

1. Insira um Relatório no projeto, com o nome de "RelatorioNivel".

2. Configure a Consulta do Relatório para buscar no Banco de Dados a tabela desejada.

Configurar Consulta

3. Escolha os campos Nivel e E3TimeStamp.

4. Insira na seção Detail um objeto SetPoint para cada coluna escolhida na Consulta. Preencha a propriedade DataField como nome da coluna.

Seção Detail

5. Util ize um objeto Label para escrever o título das colunas (propriedade Caption).

Page 148: E3tutorial beginner ptb

148 Exercícios de Revisão

6. Insira na Tela um botão com o seguinte script:

Set Report = Application.LoadReport("[RelatorioCaldeira]")Report.Export "PDF", "RelatorioNivel.pdf"

Page 149: E3tutorial beginner ptb

Exercícios de Revisão 149

17.3 Anotações

Page 150: E3tutorial beginner ptb

MatrizRua 24 de Outubro, 353 - 10º andar90510-002 Porto Alegre RSFone: (51) 3346-4699Fax: (51) 3222-6226E-mail: [email protected]

Filial SPRua dos Pinheiros, 870 - Conj. 141/14205422-001 São Paulo - SPFone: (11) 3061-2828Fax: (11) 3061-2828E-mail: [email protected]

Filial PRAv. Sete de Setembro, 4698/170580240-000 Curitiba - PRFone: (41) 3342-0120Fax: (41) 3342-0120E-mail: [email protected]

Consulte nosso website para informações sobre o representante do seu estado.

www.elipse.com.br

USA2501 Blue Ridge Road, Suite 250Raleigh - NC - 27607 USAFone: +1 (252) 995-6885Fax: +1 (252) 995-5686E-mail: [email protected]

Filial MGRua Antônio de Albuquerque, 1567° andar Sala 70530112-010 Belo Horizonte - MGFone: (31) 2511-2121E-mail: [email protected]

Taiwan9F., No.12, Beiping 2nd St., Sanmin Dist.807 Kaohsiung City - Taiwan Telefone: +886 (7) 323-8468 Fax: +886 (7) 323-9656 E-mail: [email protected]

Filial RJAv. Praia de Botafogo, 300/52522250-044 Rio de Janeiro - RJFone: (21) 2158-1015Fax: (21) 2158-1099E-mail: [email protected]

kb.elipse.com.br

[email protected]