e3tutorial Beginner Ptb

2011 Elipse Software Ltda. Todos os direitos reservados.16/08/2011 - Verso 3.5

Tutorial do E3 para Iniciantes

Sumrio1 Apresentao 6

61.1 A Elipse

71.2 Mdulos do E3

81.3 O Treinamento

111.4 Anotaes

2 Elipse Knowledgebase 12

132.1 Elipse Knowledgebase

132.2 Busca no Knowledgebase

142.3 Categorias

162.4 Anotaes

3 Iniciando a Aplicao 17

183.1 Criando sua Aplicao

213.2 Execuo de um Domnio

223.3 Exerccios

233.4 Exerccios Complementares

243.5 Anotaes

4 Servidor de Dados 25

264.1 Regras para Nomes de Tags

264.2 Exerccios

294.3 Anotaes

5 Telas e Quadros 30

305.1 Tela

315.2 Quadros

335.3 Viewer

355.4 Exerccios

405.5 Anotaes

6 Objetos de Tela 41

416.1 Controles Microsoft Forms

426.2 Galeria

436.3 Exerccios


486.5 Anotaes

7 Associaes 49

507.1 Tipos de Associaes

567.2 Valores Booleanos

577.3 Exerccios

617.4 Anotaes

8 Comunicao 62

628.1 Driver de Comunicao

658.2 Driver de Comunicao OPC


698.4 Anotaes

9 Bibliotecas ElipseX 70

719.1 Criao de Bibliotecas do Usurio

759.2 Quando Criar um ElipseX

759.3 Exerccios

789.4 Anotaes

10 Scripts 79

7910.1 Definindo Scripts

8810.2 Eventos

9010.3 Mtodos

9110.4 Propriedades

9110.5 Exerccios

9410.6 Anotaes

11 Segurana 95

9611.1 Usurios

9711.2 Grupos

9711.3 Permisses

9911.4 Proteo

10011.5 Exerccios

10311.6 Anotaes

12 Banco de Dados 104

10412.1 Exerccios


10712.3 Anotaes

13 Alarmes 108

10813.1 Servidor de Alarmes

10813.2 Configurao de Alarmes

11413.3 E3Alarm

11513.4 Exerccios

12513.5 Anotaes

14 Histricos 126

12614.1 Chave Primria

12714.2 ndices

12814.3 Exerccios

13114.4 Anotaes

15 Consultas 132

13315.1 Criando uma Consulta

13515.2 E3Browser

13715.3 Exerccios

13915.4 Anotaes

16 E3Chart 140

14116.1 Configuraes das Penas

14216.2 Exerccios


14616.4 Anotaes

17 Relatrios 147

14917.1 Objetos do Relatrio

15017.2 Exerccios

15417.3 Anotaes

18 Exerccios de Reviso 155

15518.1 Exerccio

15818.2 Resoluo

16718.3 Anotaes

6 Apresentao

1ApresentaoCAPTULO

Este tutorial serve como apoio ao mdulo de treinamento para execuo eprogramao do E3. Com ele, voc acompanhar o contedo do curso. Durante asaulas, fique vontade para praticar o que voc aprendeu e para resolver suas dvidascom o instrutor. No treinamento, apresentado um estudo de caso que simula umaaplicao real, um sistema de superviso e controle.

1.1 A Elipse

A Elipse Software uma empresa genuinamente brasileira, com foco na produo desoftware de superviso para automao industrial, surgida em Porto Alegre no inciodos anos 90.

Seu primeiro produto foi o Elipse 21, um software para a plataforma DOS, que eraconhecido por sua facilidade de operao e compatibilidade com diferentesfabricantes.

Em 1996, a Elipse lanou a primeira verso do Elipse Windows, que mais tarde setornaria o Elipse SCADA. Desde essa poca, foram instaladas cerca de 3.500 cpiasdesse software no Brasil.

Em 2000, a Elipse iniciou o desenvolvimento do E3, a terceira gerao de software desuperviso da empresa. Desde seu lanamento comercial em 2001, cerca de 500licenas desse software j foram instaladas e o E3 vem sendo utilizado em sistemasdiversos, como Centros de Operao de empresas eltricas, plantas industriais dediversas finalidades, sistemas de telemedio e controle de energia, automao econtrole predial, minerao, entre outros.

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

Apresentao 7

1.2 Mdulos do E3

Inicialmente, ser visto que o E3 composto de quatro mdulos, descritos a seguir.

1.2.1 E3 Server

o Servidor de Aplicaes, onde os principais processos so executados, incluindo acomunicao em tempo real com os equipamentos de controle. O servidor tambm responsvel por enviar dados e Telas aos clientes conectados em qualquer parte darede (Intranet e Internet). O servidor pode executar vrios projetos ao mesmo tempoe conversar com outros E3 Servers para realizar um failover (standby) ou distribuircargas de processamento entre as mquinas. Foi desenvolvido para ser executadosobre os sistemas operacionais Windows XP, 2003, Vista e Windows 7.

1.2.2 E3 Studio

Ferramenta nica de configurao, agindo como plataforma universal dedesenvolvimento, que possui um ambiente moderno e amigvel, incluindo umcompleto editor grfico e de scripts (VBScript). Permite que um projeto seja editadopor vrias pessoas ao mesmo tempo ou que vrios E3 Studios estejam conectados aomesmo servidor remoto, com mltiplas configuraes.

1.2.3 E3 Viewer

O Viewer permite operar as aplicaes residentes no servidor em qualquercomputador com o programa executvel Viewer (Windows XP, 2003, Vista e Windows7) ou com um navegador de Internet. Em ambos os casos, no necessrio instalar aaplicao na mquina cliente, pois todos os componentes (Telas, Bibliotecas,controles ActiveX) sero baixados e registrados automaticamente.

1.2.4 E3 Admin

o mdulo responsvel pela interface do E3 Server e de outros mdulos do E3 com ousurio. Atravs dele o usurio pode enviar comandos ao E3 Server, utilizando o conena rea de Notificao da Barra de Tarefas do Windows, e controlar o Domnio pelalinha de comando.

8 Apresentao

1.3 O Treinamento

A sequncia de aprendizado a ser seguida neste Tutorial reflete o que a ElipseSoftware considera o conjunto de melhores prticas no desenvolvimento deaplicativos de superviso e controle, tanto para o E3 (o objeto de estudo desteTutorial) quanto para o Elipse SCADA ou outros softwares de superviso.

A base do roteiro desse manual uma aplicao hipottica, que apresenta osrecursos mais importantes do software E3. Essa aplicao hipottica no cobre todasas possibilidades de desenvolvimento oferecidas pela ferramenta. No entanto, aquantidade e qualidade das informaes apresentadas neste primeiro contato com osoftware so suficientes para que voc aprenda a utiliz-lo com autonomia para criarsuas prprias aplicaes.

A sequncia do treinamento a seguinte:

Apresentao da ferramenta.

Telas e Objetos de Tela: como criar interfaces grficas para suas aplicaes.

Uso de Associaes: um modo fcil e efetivo de mostrar informaes ou criaranimaes em Telas.

Comunicao de dados: uso de drivers e uso de OPC.

Uso de Bibliotecas ElipseX: poderosa ferramenta de bibliotecas funcionaisdisponvel apenas no E3.

Integrao a Bancos de Dados: uso de funes e ferramentas para acesso econsulta a Bancos de Dados, com foco em processos.

Alarmes: uso e controle de Alarmes no E3.

Relatrios: poderosa ferramenta incorporada ao E3, traz facilidade e grandequantidade de recursos para a criao de relatrios.

Recursos Avanados: redundncia, acesso ao aplicativo atravs de browser,configuraes de segurana de usurios, entre outros.

Apresentao 9

1.3.1 Aplicao de Treinamento

No treinamento, apresentado um estudo de caso que simula uma aplicao real,um sistema de superviso e controle. O instrutor desenvolve a aplicao junto com osalunos passo-a-passo, facilitando o entendimento e aprendizado da ferramenta.

O sistema em questo apresenta um sintico de uma usina de acar, exemplificandovrios aspectos e recursos disponveis no Elipse E3. O sistema monitora a presso,vazo e vapor da caldeira, assim como o nivel e trs temperaturas do processo. Ooperador do sistema pode visualizar as temperaturas e informaes da caldeira econtrolar o funcionamento do motor.

Sintico de uma usina de acar

O sistema tambm mostrar condies de alarme no caso de algum parmetroultrapassar os limites estabelecidos (como por exemplo, um aumento excessivo detemperatura) alm de criar grficos de tendncia das variveis.

Condies de alarme

Finalmente, um procedimento de consulta dos alarmes, que permite visualizao eimpresso dos dados de histricos.

10 Apresentao

Visualizao e impresso de dados histricos

Sua participao muito importante para ns. Ao final do treinamento, sersolicitado que voc avalie diversos aspectos do curso, como a qualidade e aquantidade das informaes transmitidas em aula e pelo Tutorial, alm do trabalhodo instrutor e a qualidade das instalaes. Qualquer sugesto ou crtica bem-vindapela equipe de desenvolvimento desse Tutorial.

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

Apresentao 11

1.4 Anotaes

12 Elipse Knowledgebase

2Elipse KnowledgebaseCAPTULO

O Elipse Knowledgebase tem como finalidade ajudar o usurio dos softwares da Elipsea encontrar respostas rpidas para dvidas ou problemas que esteja enfrentandodurante a sua utilizao. Seja no desenvolvimento de aplicaes ou depois de t-lasprontas. Este espao nada mais do que um portal onde muitas informaes tcnicase dicas esto concentradas. A sua base de informaes constantemente atualizadae tem uma linguagem simples que visa o rpido entendimento de quem estutilizando. Aps acessar o endereo kb.elipse.com.br, voc estar na pgina inicial.

Pgina inicial do KB

Elipse Knowledgebase 13

2.1 Elipse Knowledgebase

No cabealho da pgina existem as seguintes opes:

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

Favoritos: link que mostra todos os artigos da base de dados que esto assinaladoscomo favoritos.

Login: serve apenas para uso da Elipse.

2.2 Busca no Knowledgebase

Este campo busca em toda a base de dados pela palavra ou palavras que o usuriodigitar, retornando todos os artigos que possuem a palavra alvo da busca. Bastadigitar a palavra que se deseja buscar e ento apertar o boto Busca.

Busca no KB

Ainda existe a possibilidade de utilizar a Busca Avanada, que permite refinar aconsulta. Basta acessar a opo Busca Avanada.

Busca avanada


Na opo de Busca Avanada o usurio pode digitar a palavra ou palavras que desejabuscar, filtrar por categoria especfica, autor e ainda pela classificao do artigo. Isto, se ele ajudou muito, apenas ajudou, no ajudou ou ajudou pouco.

2.3 Categorias

Existe a possibilidade do usurio acessar todos os artigos escolhendo diretamente acategoria a que ele pertence. Para isto, no campo Categorias, basta selecionar acategoria em que se deseja buscar os artigos e ento clicar no boto Ir.

Escolha de categorias

Todos os artigos desta categoria sero retornados como resultado da busca.

importante ressaltar que toda a base de conhecimento est dividida em duascategorias principais: Ingls e Portugus.

Dentro delas existem as categorias Elipse E3, Elipse Scada, Elipse 21 DOS, Elipse DriversOPC, Altus TCP/IP e Drivers.

Dentro destas cinco categorias existem diversas outras, cada uma delas tratando deum tema especfico.

Acessando os artigos pela categoria Portugus - Elipse E3 tem-se:

Elipse Knowledgebase 15

Categorias em portugus

Note que dentro de cada uma destas subcategorias aparece um nmero. Este nmeroindica a quantidade de artigos existentes dentro da categoria.

As demais sees existentes na pgina principal do Knowledgebase so:

Artigos Em Destaque: Mostra todos os artigos que esto classificados paraaparecerem em destaque. Normalmente esta seo utilizada para ressaltaralgum artigo que merece uma ateno especial por parte dos usurios dossoftwares da Elipse.

Artigos Mais Lidos: Mostra a lista dos 10 artigos mais lidos no Knowledgebase.

ltimos Artigos Adicionados: Mostra a lista dos ltimos 10 artigos que foramadicionados na base de dados do Knowledgebase.

Buscas Mais Utilizadas: Mostra as 10 palavras que mais foram utilizadas como buscapela ferramenta de busca do Knowledgebase.


2.4 Anotaes

Inic iando a Aplicao 17

3Iniciando a AplicaoCAPTULO

Aps instalar o software, voc ter em sua mquina um grupo de programas chamado

Elipse E3, com um cone para acessar o E3 Studio. Quando o E3 iniciado, osistema abre uma caixa de dilogo com algumas opes do projeto.

Caixa de dilogo inicial do E3 Studio

As opes disponveis so:

Opes disponveis na caixa de dilogo inicial do E3

OPO DESCRIO

Iniciar o E3 Studio Inicia o E3 Studio, mas no abre nenhum Domnio.

18 Inic iando a Aplicao

Criar um Domnionovo

Cria um novo Domnio atravs do Assistente de aplicaes doE3. Sero requisitados o nome e caminho do novo Domnio.

Abrir um Domnioexistente

Abre um Domnio existente dentre os ltimos editados.Clicando em Outros arquivos pode-se localizar um Domnio emum diretrio especfico.

3.1 Criando sua Aplicao

Para criar uma nova aplicao, utilize o Assistente de Aplicaes. Para acess-lo,

clique no boto Novo na barra de ferramentas Padro.

Assistente de Aplicaes

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


3.1.1 Projetos

Contm definies de objetos, Tags, Telas e outros componentes de uma aplicao.Os arquivos .prj so criados atravs das opes Aplicao Padro e Aplicao emBranco. A primeira opo cria um projeto pr-configurado com alguns objetos bsicose um assistente de criao de projeto, enquanto que a segunda opo cria um projetovazio a ser implementado pelo usurio.

3.1.2 Bibliotecas

Contm definies de objetos criados pelo usurio (ElipseX) para serem utilizados emprojetos. Essas bibliotecas podem ser reutilizadas em diferentes projetos, masmantm vnculos com a aplicao. Ou seja, se a biblioteca for alterada, todos osobjetos dessa biblioteca sero atualizados nos projetos automaticamente.

3.1.3 Configurao do Domnio

Armazena quatro tipos de informaes:

Opes de configurao do Domnio

Lista de arquivos .prj e .lib

Configuraes dos servidores que iro rodar o Domnio

Configuraes de segurana (usurios e permisses)

Sem esse arquivo, um projeto no pode ser executado no E3. Esse item ser visto maisadiante.


3.1.4 Organizer

O Organizer permite uma viso simples e organizada de toda a sua aplicao,ajudando na edio e configurao de todos os objetos envolvidos no sistema atravsde uma rvore hierrquica de opes. Possui dois modos de visualizao, Domnio eExplorer.

Janela do Organizer em modo Domnio

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

O modo Explorer mostra projetos e bibliotecas abertos no E3 Studio, pertencentes ouno ao Domnio. Os objetos so mostrados no projeto ou biblioteca ao qualpertencem, ordenados alfabeticamente dentro de cada projeto ou biblioteca.


3.1.5 Lista de Propriedades

A Lista de Propriedades uma janela que mostra todas as propriedades do objeto emuso, permitindo a sua configurao de forma simples e rpida. Sempre que umapropriedade for configurada na Lista de Propriedades, seu valor no ser mudadoautomaticamente, a menos que se construa uma associao (que ser vista adiante).A Lista de Propriedades pode ser acessada pelo menu Visualizar - Lista de

Propriedades ou pelo boto na Barra de Ferramentas.

Lista de propriedades

3.2 Execuo de um Domnio

Para executar ou visualizar um projeto no E3, necessrio que o Domnio sejacolocado em execuo. Para isso, existem os seguintes botes no E3 Studio:

Executar aplicativo: Salva todas as configuraes dos projetos e bibliotecas, eexecuta o Viewer.


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

Executar/Parar o E3 Viewer: Executa o Viewer ou para a sua execuo.

3.3 Exerccios

Esta seo contm exerccios sobre o contedo deste captulo.

3.3.1 Domnio

1. Inicie o E3 Studio selecionando a opo Criar um Domnio novo. O Assistente deAplicaes ser aberto.

Assistente de Aplicaes

2. No Assistente de Aplicaes, clique em Avanar, selecione a opo AplicaoPadro e nomeie o projeto como TreinamentoE3.

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

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


mesmo nome do projeto.

Resoluo do Viewer

5. Ao fim destes procedimentos, voc ter acesso rea de trabalho do E3 Studio.


Esta seo contm exerccios complementares ao contedo deste captulo.

3.4.1 KB

KB-28984: Qual o tempo de execuo do Domnio e comunicao do E3 com umalicena somente Studio?


3.5 Anotaes

Servidor de Dados 25

4Servidor de DadosCAPTULO

O Servidor de Dados o mdulo responsvel pela execuo e gerenciamento de tags eobjetos que no estejam envolvidos diretamente com a comunicao. Atravs doServidor de Dados pode-se configurar tags internos e tags de simulao, alm deinserir XObjects, que so os objetos de dados das bibliotecas ElipseX (vistas maisadiante). Alguns dos objetos que podem ser inseridos no servidor de dados sodescritos na tabela seguinte.

Objetos que podem ser inseridos no Servidor de Dados

OBJETO DESCRIO

Tag Contador Objeto que faz a contagem de tempo (em segundos) at atingirum valor pr-determinado, ou que faz uma certa contagemindefinidamente.

Tag Demo Objeto que gera valores de acordo com a forma de onda. utilizado para simulao de valores. Permite gerar curvasdefinidas ou valores aleatrios.

Tag Interno Objeto de propsito genrico, utilizado para guardar valores dequalquer tipo, incluindo nmeros, textos e outros objetos.

Tag Timer Objeto para contagem de tempo e programao de atividades.Estabelece horrios (com repeties) para executar aes.

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

NOTA: Os objetos inseridos no Servidor de Dados sero executados pelo E3 Server,portanto estaro presentes no Servidor. Esta informao retrata o modo como o E3trabalha.

26 Servidor de Dados

4.1 Regras para Nomes de Tags

Ao especificar o nome dos Tags, alguns detalhes devem ser levados em conta:

O nome do Tag no pode ser estritamente numrico.

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

O nome da varivel no pode conter caracteres reservados: / ? . , { } [ ] - etc. Essescaracteres so trocados pelo caractere sublinhado. Assim, o sistema aplica a Regrados Colchetes, explicada a seguir.

4.1.1 Regra dos Colchetes

Ao fazer referncia a um objeto por script ou ao us-lo em alguma associao, deve-selevar em conta as seguintes regras:

Se o primeiro caractere no for uma letra ou um caractere sublinhado, o nomedeve estar entre colchetes.

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

Caso existam caracteres especiais (por exemplo, acentos), o nome deve estar entrecolchetes.

4.2 Exerccios



4.2.1 Horrio do Sistema

1. Para obter o horrio corrente do sistema necessrio criar um Tag Demo queacesse essa informao. Na pasta Dados do TreinamentoE3 insira um TagDemo com o nome HoraAtual. Configure a propriedade Type do Tag Demo para 3- CurrentTime.

Inserir Tag Demo

4.2.2 Simulao de Valores

Muitas vezes so necessrios valores que simulem os movimentos. Normalmenteesses valores so reais e vem de Tags de Comunicao, mas nos exerccios do Tutorialusaremos Tags do tipo Demo.

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

28 Servidor de Dados

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

Temp1 0 200 0 - Random



4.2.3 Tag Interno

Quando se deseja armazenar um valor para utiliz-lo futuramente, cria-se um TagInterno.

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

2. Configure a propriedade Value do Tag Motor para ser um Boolean com valor inicialem False.


4.3 Anotaes

30 Telas e Quadros

5Telas e QuadrosCAPTULO

Telas so janelas para monitoramento de processos, onde so inseridos objetos quefaro a interface do operador com o sistema. Cada aplicao pode ter um nmeroilimitado de Telas.

Quadros so objetos para a organizao e a estruturao da interface, criandovisualizaes compostas para o usurio dentro da janela principal do Viewer ou doseu navegador.

5.1 Tela

A Tela o objeto bsico de interface com o usurio. Nela podem-se inserir osseguintes objetos:

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

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

Controles ActiveX fornecidos por terceiros.

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

Imagens vetoriais (Arquivos WMF, EMF, etc.).

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

Bibliotecas grficas do E3 (XControl) compostas de quaisquer objetos acima.

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

As Telas podem ser abertas em modo Full-Screen, ocupando toda a rea do Viewer, ouainda como Telas Modais, ocupando somente o tamanho de suas coordenadas dealtura e de largura.

Telas e Quadros 31

Exemplo de Tela

5.2 Quadros

O Quadro o objeto que organiza e estrutura a interface, criando visualizaescompostas para o usurio dentro da janela principal do Viewer ou do navegador.

No Quadro, podem-se criar Divisores para visualizar diferentes telas ao mesmotempo. Cada Divisor tambm pode mostrar uma URL, uma planilha do Excel, umdocumento do Word ou um arquivo PDF.

A disposio dos Divisores dentro do Quadro pode ser horizontal ou vertical. Dentrode cada divisor podem ser inseridos outros divisores. A cada par de novos Divisorescriados pelas opes Dividir Horizontalmente e Dividir Verticalmente, h sempre umDivisor Principal e um Divisor Secundrio. Apenas o Divisor Principal ter valores quedefinem explicitamente o seu posicionamento, ficando o Divisor Secundrio com ovalor restante. Para utilizar esse recurso, siga estes procedimentos:

1. Clique com o boto direito do mouse no nome do projeto em Viewers e Quadros eescolha a opo Inserir Quadro.

2. Para criar um divisor, clique com o boto direito do mouse sobre o quadro aberto eselecione o tipo de diviso (horizontal ou vertical).

32 Telas e Quadros

Selecionar o tipo de diviso

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

Divises

Telas e Quadros 33

5.3 Viewer

O 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 E3Server. No necessrio copiar o aplicativo para as mquinas onde os E3 Viewerssero executados, pois as Telas e bitmaps so trazidos do servidor conforme anecessidade, em tempo de execuo.

NOTA: S poder existir um objeto Viewer em um Domnio.

Na aba Visualizador da janela de Propriedades so definidas as configuraes devisualizao do Viewer.

Aba Visualizador

34 Telas e Quadros

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

Aba Configurao

Na aba Erros de comunicao, pode-se configurar um padro para que os Displays eSetpoints de toda a aplicao indiquem erros de comunicao.

Telas e Quadros 35

Aba Erros de Comunicao

NOTA: Tambm possvel inserir Tags no Viewer.

5.4 Exerccios


36 Telas e Quadros

5.4.1 Telas

1. Clique com o boto direito do mouse sobre a pasta Telas e escolha a opo InserirTela em - TreinamentoE3.prj.

Inserir Tela

2. Escolha na lista de seleo o Divisor Superior. Isso faz com que a Tela seja criadacom o tamanho exato desse Divisor. Marque a opo Configurar como Tela inicial doDivisor e no campo Nome digite "TelaMenu".

Telas e Quadros 37

Configurar o tamanho da Tela

3. Crie a TelaEventos para ser aberta no Divisor inferior.

4. Altere o nome da TelaInicial para TelaCaldeira.

5. Clique com o boto direito do mouse na TelaCaldeira e escolha a opoAjustar ao Divisor.

6. Ajuste a Tela ao divisor Inferior. Marque a opo Configurar como Tela inicial dodivisor.

5.4.2 Quadros

1. Clique com o boto direito do mouse sobre a pasta Viewer e Quadros e escolha aopo Inserir Quadro em - TreinamentoE3.prj.

2. Na rea de visualizao do quadro, clique com o boto direito do mouse eselecione a opo Dividir Horizontalmente, conforme a figura.

38 Telas e Quadros

Dividir Horizontalmente

3. Posicione a barra que aparece a cerca de 10% da Tela, a partir de seu limitesuperior, e pressione o boto esquerdo do mouse para fixar a posio da barra.

4. Configure o tamanho do divisor para 100 px na propriedade SplitValue.

Telas e Quadros 39

5.4.3 Tela Inicial da Aplicao

1. Clique com o boto direito do mouse no Viewer e escolha a opo Propriedades. Naaba Visualizador, escolha o Quadro1 no campo Tela ou Quadro Inicial.

Aba Visualizador

2. Execute a aplicao pressionando o boto na Barra de Ferramentas.

40 Telas e Quadros

5.5 Anotaes

Objetos de Tela 41

6Objetos de TelaCAPTULO

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

Uma vez selecionado o objeto que se deseja criar, mantenha o boto esquerdo domouse pressionado na rea da Tela, enquanto movimenta o mouse (um retngulopontilhado mostra o tamanho e a forma do objeto). Ao soltar o boto, o objeto serposicionado dentro da rea especificada.

6.1 Controles Microsoft Forms

Os objetos ActiveX so componentes de software baseados na tecnologia COM (Component Object Model) da Microsoft. O E3 instala e utiliza os controles MicrosoftForms, que so objetos ActiveX criados pela Microsoft. Eles podem ser inseridos nasTelas da aplicao para realizar diversas tarefas. A seguir uma descrio dos objetosMicrosoft Forms disponveis no E3.

Controles Microsoft Forms

CONE OBJETO DESCRIO

Caixa de Seleo (Check Box) Utilizado para dar ao usurio umaescolha entre dois valores, tais comoSim e No, True e False ou On e Off.

Boto de Opes (Option Button) Utilizado para mostrar se um itemindividual de um grupo estselecionado.

Boto de Comando (CommandButton)

Utilizado para executar uma aoespecfica ao pression-lo.

Texto (Label) Utilizado para exibir um textodescritivo, como ttulos, legendas, etc.

Lista (List Box) Exibe uma lista de valores.

42 Objetos de Tela

CONE OBJETO DESCRIO

Barra de Rolagem (Scroll Bar) Retorna ou define o valor dapropriedade de outro objeto de acordocom a posio da caixa de rolagem.

Boto Incremento-Decremento(Spin Button)

Utilizado para incrementar edecrementar um valor.

Editor de Texto (Text Box) Utilizado para exibir informaesdigitadas pelo usurio na Tela.

Boto Liga-Desliga (ToggleButton)

Semelhante ao Boto de Comando,porm necessita um segundo comandodo usurio para voltar ao estadonormal.

Lista de Seleo (Combo Box) Combina os recursos de uma Lista e deum Editor de Texto. O usurio podedigitar um novo valor ou selecionar umvalor existente.

NOTA: Outros objetos ActiveX de terceiros tambm podem ser utilizados no E3,desde que sejam devidamente registrados. Eles podem ser adicionados atravs domenu Ferramentas - Adicionar ActiveX.

6.2 Galeria

A Galeria uma biblioteca de smbolos vetoriais, divididos em categorias, que podemser arrastados para as Telas.

Depois de inserido, o objeto pode ser livremente editado e trabalhado de acordo comas caractersticas descritas para os objetos de imagem (pode-se, por exemplo, mudara cor de preenchimento atravs das propriedades OverrideFillMode,OverrideFillColor e OverrideLineColor, sem a necessidade de transformar o objeto emum objeto grfico do E3).

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

Objetos de Tela 43

Galeria

NOTA: Ao executar o E3 Studio em modo Demo (sem licena), apenas o primeiroelemento de cada conjunto de categorias de smbolos estar disponvel.

6.3 Exerccios


6.3.1 Figuras

Todas as figuras utilizadas nesta aplicao sero salvas em uma pasta dentro doprojeto principal, para que no seja necessrio preocupar-se com os caminhos dasfiguras ao executar a aplicao em outro computador.

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

44 Objetos de Tela

Inserir Recurso

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

Objetos de Tela 45

6.3.2 Tela Caldeira

Tela Caldeira

1. Configure a propriedade FillStyle para 12 - Picture, para habilitar uma figura defundo.

2. Para colocar a figura FundoCaldeira como fundo, arraste o bitmap de Recursosat a propriedade PictureFile da Tela. Isto faz com que o E3 utilize o recursoinserido e no o arquivo da imagem (que externo aplicao). Para escolher amelhor posio da figura, pode-se alterar a propriedade PicturePosition.

3. A partir da biblioteca de objetos grficos (Galeria), arraste para a tela a primeirafigura (caminho) da pasta Vehicles. Posicione-o no canto inferior direito da tela.

Figura WheelerTruck

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

5. Como a figura uma imagem da Galeria, para alterar a cor deve-se primeiro alterara propriedade OverrideFillMode para 2 - SolidFill. Escolha a cor que desejar napropriedade OverrideFillColor.

46 Objetos de Tela

Figura3DISAMotor1

6. Desenhe um retngulo sobre um dos tanques. Escolha a cor que preferir.

7. Crie um objeto Texto com a palavra "Presso", outro com a palavra "Vapor" e umterceiro com a palavra "Vazo" sobre o tanque da direita.

8. Abaixo de cada texto, insira um objeto Display .

Textos e Displays

6.3.3 Tela Menu

Tela Menu

1. Na TelaMenu, arraste do grupo Recursos da Galeria do logotipo do E3.

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

3. Acesse as propriedades do objeto e selecione a aba Formatao. Defina o formatocomo Hora, e no item Tipo, escolha 13:06:03. Essa formatao mostrar as horas,os minutos e os segundos.

Objetos de Tela 47

4. Para visualizar a configurao feita no exerccio anterior, acesse a propriedade Value do Display e escolha a opo Date.

Display

6.3.4 Tela Eventos

Tela Eventos

1. Configure a Tela com o fundo que desejar. Utilize o boto Estilo de preenchimento.



6.4.1 KB

KB-27542: Disponibilizando figuras na Galeria do E3.

48 Objetos de Tela

6.5 Anotaes

Assoc iaes 49

7AssociaesCAPTULO

Associaes (ou Conexes) so ligaes feitas entre propriedades e objetos ou entreoutras propriedades. As associaes trazem grande facilidade ao criar animaes eoutros tipos de lgicas comuns, minimizando a utilizao de scripts.

Atravs da aba Associaes da janela de Propriedades, tem-se acesso a todas aspropriedades disponveis do objeto a ser tratado e todos os tipos possveis deassociao para essas propriedades.

Aba Associaes

Pode-se associar um objeto ou criar uma expresso. Ao criar uma expresso ouassociar um objeto ou propriedade ao campo Fonte, o texto aparecer na cor azul,caso esse corresponda a um item existente ou carregado no E3 Studio. Se o item noexistir, ou pertencer a um mdulo no existente no Domnio, o texto aparecer emvermelho, e esse item ser mostrado como um erro, at ser corrigido ou excludo coma opo Verificar Domnio.

50 Assoc iaes

7.1 Tipos de Associaes

Esta seo contm a descrio dos tipos de associaes.

7.1.1 Conexo Simples

Na Conexo Simples, o valor do campo Fonte copiado para a propriedade toda vezque a fonte for modificada.

Conexo Simples

Assoc iaes 51

7.1.2 Conexo Bidirecional

Na Conexo Bidirecional acontece o mesmo que na Conexo Simples, porm casotambm haja uma variao na propriedade, seu valor ser copiado para o campo Fonte, gerando assim um caminho de duas direes.

Conexo Bidirecional

52 Assoc iaes

7.1.3 Conexo Digital

J na Conexo Digital, possvel estabelecer que, caso a varivel ou expresso docampo Fonte seja uma propriedade digital, seus estados Verdadeiro e Falso seromapeados para certos valores no Destino, incluindo a opo de Pisca (alternncia devalores).

Conexo Digital

Assoc iaes 53

7.1.4 Conexo Analgica

A Conexo Analgica permite estabelecer uma escala de converses entre a varivelfonte e a varivel destino. Atravs de quatro valores especificados, feita uma escalalinear entre os valores da propriedade e os valores da fonte.

Conexo Analgica

54 Assoc iaes

7.1.5 Conexo por Tabela

Podem-se estabelecer condies entre a varivel, os valores e o destino. Na tabelaso especificados valores mnimos e mximos, e valores para a propriedade referentea essas condies.

Conexo por Tabela

Assoc iaes 55

7.1.6 Conexo Reversa

A Conexo Reversa uma associao unidirecional do objeto para a fonte.

Conexo Reversa

7.1.7 Edio de Associaes

O E3 possui uma ferramenta para editar associaes, chamada Edio de Associaes.Assim, possvel mudar uma ou mais associaes feitas na aplicao de forma maisrpida do que pela janela tradicional. O acesso a essa ferramenta pode ser feitoclicando com o boto direito do mouse sobre um ou mais objetos e selecionando aopo Editar Associaes.

56 Assoc iaes

Edio de Associaes

7.2 Valores Booleanos

Em VBScript, o 0 considerado como Falso e qualquer valor diferente de 0 considerado Verdadeiro. Considere, por exemplo, um tag que representa umaentrada ou sada digital, portanto seus valores so 0 ou 1. Ao usar o valor do tag paraassociaes com propriedades do tipo Boolean, o E3 considerar:

TAG VBSCRIPT

0 Falso

1 Verdadeiro

Ao utilizar o comando NOT, ficar:

TAG NOT TAG VBSCRIPT

0 -1 Verdadeiro

1 -2 Verdadeiro

Assoc iaes 57

Portanto, NOT de 1 no Falso, pois seu valor no igual a 0. Caso deseje utilizar ocomando NOT, primeiro converta o valor do tag para um booleano com o mtodoCBool.

TAG CBOOL(TAG) NOT CBOOL(TAG)

0 Falso Verdadeiro

1 Verdadeiro Falso

Uso do mtodo CBool

Outra opo seria trabalhar com o Bit00 do tag, que j uma propriedade do tipoBoolean, em vez de trabalhar com a propriedade Value do tag.

Uso da propriedade Bit00

7.3 Exerccios


7.3.1 Conexo Simples

1. Na TelaMenu, acesse as propriedades do Display, aba Associaes.

2. Na propriedade Value, busque na coluna Fonte, com o auxlio do AppBrowser, o tagDemo HoraAtual (Servidor - Dados). direita, selecione a propriedade Value eclique no boto Colar. A informao vai do tag para o Display, logo a associao simples (Propriedade

58 Assoc iaes

Associao Simples

3. Na TelaCaldeira, associe os Displays de Presso, Vazo e Vapor a seusrespectivos tags.

7.3.2 Conexo Digital

1. Na TelaCaldeira, o motor deve alterar de cor conforme o valor do tag Motor.Acesse as propriedades da figura Motor, aba Associaes. Na propriedadeOverrideFillColor busque o tag interno Motor (Servidor - Dados - Motor) e direitaselecione a propriedade Value.

2. No tipo da conexo marque Conexo Digital. Escolha duas cores para simbolizarLigado e Desligado. Se desejar, habilite o pisca.

Propriedade OverrideFillColor

3. No Display que exibe o valor da presso na TelaCaldeira, crie uma AssociaoDigital para alterar a cor do Display caso o valor da presso seja maior do que 300.

Propriedade ForegroundColor

Assoc iaes 59

7.3.3 Conexo por Tabela

1. No Display que exibe o valor do Vapor na TelaCaldeira, deseja-se indicar queo vapor est fora da faixa permitida alterando a cor de fundo. Crie uma Associaopor Tabela na propriedade ForegroundColor conforme a figura a seguir.

Propriedade ForegroundColor

7.3.4 Conexo Analgica

1. Deseja-se indicar o nvel do tanque com o preenchimento de cor do retngulo. Otag Nivel pode variar de 0 a 1000, enquanto que o preenchimento do retngulovai apenas de 0 a 100%. Para fazer a converso, utiliza-se uma Conexo Analgica.

Conexo Analgica

7.3.5 Animao

1. Selecione o objeto Caminhao e aperte o boto para inserir uma animaocom translao.Uma sombra do objeto aparecer. Mova-a at onde desejar.

Animao com Translao

60 Assoc iaes

2. Clique com o boto direito do mouse na Animao e acesse suas propriedades. Crieuma Associao Simples na propriedade Value com o tag Caminhao.

Associao Simples

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

Assoc iaes 61

7.4 Anotaes

62 Comunicao

8ComunicaoCAPTULO

O E3 permite a comunicao com equipamentos de aquisio de dados,controladores, CLPs (Controladores Lgicos Programveis), UTRs (Unidades TerminaisRemotas), ou qualquer outro tipo de equipamento, atravs de Drivers deComunicao ou Servidores OPC, de acordo com o tipo do equipamento ou tipo decomunicao necessria. Os Drivers de Comunicao e Servidores OPC funcionamnesse caso como servidores de variveis, ou seja, eles fornecem as informaes domundo externo para o E3 para que a superviso do processo se realize. As variveisenvolvidas no processo so conhecidas como Tags e podem ser de vrios tipos, deacordo com a utilizao desejada. No E3 podem ser inseridos dois tipos de Drivers, o Driver de Comunicao (arquivos .dll) e o Driver de Comunicao OPC.

8.1 Driver de Comunicao

O Driver de Comunicao o mdulo do E3 que possibilita a comunicao com umdeterminado equipamento usando os drivers .dll fornecidos pela Elipse Software. Ummanual fornecido juntamente com cada Driver, contendo informaes importantesa respeito da configurao dos seus parmetros [P] e outras propriedades. Os tipos deobjetos de Driver disponveis para comunicao so descritos na tabela a seguir.

Objetos disponveis no Driver de Comunicao

OBJETO DESCRIO

Pasta Define grupos e subdiretrios para a organizao de variveis.No tem relao direta com o equipamento de campo.

Tag deComunicao

Utilizado para definir a comunicao com uma varivel (umendereo de memria) do equipamento de aquisio.

Bloco deComunicao

Utilizado para definir a comunicao com diversas variveis(vrios endereos de memria em sequncia) do equipamentode aquisio.

Elementos deBloco

Representam cada um dos endereos de um bloco e soutilizados como se fossem tags de comunicao. Os Elementosde Bloco podem apontar para cada ndice dentro de um Bloco

Comunicao 63

(correspondendo a cada varivel de interesse).

8.1.1 Exerccios

Os exerccios sobre comunicao sero feitos sob orientao do instrutor, j que cadalocal onde o curso ministrado pode contar com diferentes equipamentos parailustrar esse captulo. Ainda assim, pode-se citar o procedimento para configuraodos tags de comunicao utilizando um driver Elipse.

1. Clique com o boto direito do mouse sobre a pasta Drivers e OPC e escolha InserirDriver de Comunicao em - TreinamentoE3.prj.

2. Selecione o arquivo do Driver (.dll) na caixa de dilogo que se abre para a seleode arquivos.

3. Caso a caixa de dilogo no seja aberta automaticamente, escolha o arquivo deDriver na propriedade DriverLocation.

4. Verifique se a propriedade DriverName foi preenchida.

5. Nos Drivers mais recentes, todas as configuraes de comunicao devem serrealizadas nas janelas de configuraes extras do IOKit, que um componentecompartilhado utilizado pelos Drivers de Comunicao do E3.

6. Para os Drivers que utilizam o IOKit, a interface de configurao aberta atravs doboto Configurar o Driver na barra de ferramentas do Driver.

Configurao do Driver

7. A seguinte janela ser aberta.

64 Comunicao

Configuraes Extras

8. Na aba Setup, escolha na lista de opo da propriedade Physical Layer a interfacefsica que ser utilizada. As opes so Serial, Ethernet, Modem e RAS.

9. Configure o tempo que o Driver aguardar uma resposta do equipamento nocampo Timeout.

10.Aps a escolha da opo Physical Layer, todas as outras abas sero desabilitadas,sendo necessrio apenas configurar a interface escolhida. A partir deste ponto, oDriver estar configurado para acessar o meio fsico. Depois dessa etapa, deve-seconfigurar os Tags de Comunicao.

11.Clique com o boto direito do mouse no Driver e acesse a opo Inserir - Tag deComunicao ou clique no boto Adicionar na barra de ferramentas do Driver.

Inserir Tag de Comunicao

12.Escolha a quantidade de tags a serem inseridos e seu nome.

Comunicao 65

Quantidade de Tags

13.Configure as propriedades de N1/B1 a N4/B4 conforme o manual do Driver.

14.Clique novamente com o boto direito do mouse no Driver e escolha o item AtivarComunicao para testar as configuraes ou aperte o boto Ativar/Desativar

comunicao . Caso as configuraes estejam corretas, a linha do tag deverficar na cor azul.

Tag ativado

15.Crie os outros tags e blocos e configure suas propriedades de N1/B1 a N4/B4.

16.Ajuste o tempo de varredura para cada tag conforme a necessidade.

17.Ajuste a escala dos tags, quando necessrio.

18.Na tela, crie um Setpoint para cada tag criado e associe-o ao seu respectivo tag.

8.2 Driver de Comunicao OPC

O Driver de Comunicao OPC o mdulo responsvel por coletar dados deequipamentos externos atravs de um Servidor OPC, que pode ser desenvolvido porqualquer empresa com conhecimentos da rede e do protocolo usados por umdeterminado equipamento. Os tags OPC podem ser importados para o Driver OPC noE3 (o Driver OPC no E3 atua como um cliente OPC), ou ainda podem ser criados no E3.Nesse caso necessrio conhecer o ItemId de cada tag.

Objetos disponveis no Servidor OPC

OBJETO DESCRIO

66 Comunicao

Pasta OPC Define grupos ou subdiretrios para a organizao das variveis.

Grupo OPC Agrupa uma srie de tags OPC que compartilham os mesmosparmetros de atualizao (tempo de varredura e banda morta). obrigatrio existir um grupo OPC para poder criar tags OPC.

Tag OPC Objeto para leitura ou escrita de valores em um equipamento. Aleitura do tag feita automaticamente pelo Servidor OPC, comtempo de varredura definido no grupo OPC onde ele estinserido.

Bloco OPC Possibilita a leitura ou escrita de um conjunto de valores. Parafazer uma escrita, deve-se apenas atribuir um novo valor propriedade Value.

Elemento deBloco OPC

Possibilita a leitura ou escrita de um dos elementos do Bloco OPConde ele est inserido. O Bloco OPC l uma tabela de dados eesse objeto estar sempre associado posio definida por suapropriedade Index, correspondendo a uma varivel de interesse.

8.2.1 Exerccios

O E3 funcionar como servidor OPC e tambm como cliente OPC. Assim como noexerccio anterior, esse exerccio serve para mostrar como funciona a configurao doDriver OPC, j que o procedimento semelhante para qualquer servidor OPC queesteja sendo utilizado. O roteiro descrito nos passos a seguir.

1. Clique com o boto direito do mouse sobre a pasta Drivers e OPC e escolha InserirDriver de Comunicao OPC em - TreinamentoE3.prj.

2. Clique com o boto direito do mouse sobre o driver OPC inserido, selecione aopo Propriedades e v at a aba OPC Driver.

3. Clique sobre o boto Selecionar. Ser aberta uma janela com as opes de OPCServer na sua mquina local ou na rede. Selecione o Elipse OPC Server da mquinado instrutor na opo Servidores na rede e pressione o boto OK.

4. Ao voltar janela de propriedades do Driver OPC, pressione o boto AtivarComunicao. A partir deste ponto, possvel verificar a comunicao com oservidor clicando sobre a opo Informaes.

5. O prximo passo para a configurao a importao de tags. Feche a janela depropriedades e clique com o boto direito do mouse sobre o driver OPC cadastrado.Selecione a opo Importar Tags. Com isso, o assistente de importao de tags doE3 ser aberto.

Comunicao 67

Assistente de Importao de Tags

6. A figura anterior mostra a aparncia da janela de importao. Do lado direito alista de tags do servidor e do lado esquerdo, a rea de importao para o E3. Paraimportar, primeiro ajuste os filtros, selecione o item e arraste-o at o grupo OPC dedestino.

7. Depois de importar alguns tags ou propriedades, verifique o funcionamento dostags importados.

8. Assim como no caso da configurao de Drivers Elipse, o roteiro para trabalhar como servidor OPC da Elipse o mesmo para qualquer servidor que seja utilizado.



68 Comunicao

8.3.1 KB

KB-14918: Como saber quantos tags existem dentro de um Driver de Comunicao?

KB-25284: Como configurar escala em tags de comunicao?

Comunicao 69

8.4 Anotaes

70 Bibliotecas ElipseX

9Bibliotecas ElipseXCAPTULO

O E3 possui ferramentas que permitem transformar qualquer objeto ou conjunto deobjetos de sua aplicao em uma biblioteca do usurio. A ideia das Bibliotecas deUsurios (chamadas de ElipseX) vem das linguagens de programao orientadas aobjetos, onde diversos componentes podem ser compartilhados entre projetos semque seja necessrio desenvolver novamente cada um dos objetos.

O uso de bibliotecas no E3 altamente recomendvel devido ao ganho deprodutividade que elas trazem. Algumas das vantagens dos ElipseX:

Reutilizao de cdigos

Minimizao de testes durante o desenvolvimento

Criao de interface padro para os objetos desenvolvidos

Diminuio do tempo de desenvolvimento de novos projetos

Proteo do contedo do projeto

O uso de bibliotecas recomendado na maioria das aplicaes.

Bibliotecas ElipseX 71

Bibliotecas de objetos

9.1 Criao de Bibliotecas do Usurio

Os objetos ElipseX podem conter, alm de um desenho, variveis internas que podemser exportadas para a aplicao, alm de lgicas de programao (scripts) que voestar presentes em todas as cpias do objeto que est sendo criado, diminuindo anecessidade de repetio de cdigo em diversas partes do aplicativo. Para criar umanova biblioteca no E3, siga estes procedimentos:

1. Acesse o menu Arquivo, selecione o item Novo Projeto e clique em Prximo.

2. Na opo Tipo de Aplicao, selecione a opo Biblioteca de componentes do E3.


Selecionar tipo de aplicao

3. Determine o nome da biblioteca e a pasta onde ela ser salva, e clique em Avanar.

4. Determine as especificaes referentes ao Domnio.

5. Clique em Concluir.

Dentro de uma biblioteca ElipseX podem ser inseridos dois tipos de objetos, osobjetos grficos XControls e os objetos de dados XObjects.

Podem ser inseridos nos XControls todos os itens disponveis para as Telas, descritosnos respectivos captulos. Entre esses itens esto as primitivas de desenho, objetosgrficos vetoriais, incluindo objetos da biblioteca de smbolos (WMF, EMF, etc.),objetos grficos no vetoriais (BMP, JPEG, GIF, etc.), controles ActiveX do E3 (E3Chart,E3Browser, E3Alarm), controles ActiveX de terceiros e outros XControls.

J as bibliotecas de dados podem conter quaisquer tipos de objetos no grficos, queso executados no E3 Server. Pode-se inserir em um XObject os seguintes objetos:Driver de Comunicao, Servidor de Dados, Banco de Dados, Frmulas, Configuraode Alarmes, Servidor de Alarmes, Objetos COM, outros XObjects, dentre outros.

Dentro de um mesmo arquivo .lib pode haver qualquer nmero de componentesElipseX, sejam eles XControls ou XObjects. Pode-se ter tambm vrias bibliotecas


diferentes (vrios arquivos .lib) dentro do mesmo Domnio.

9.1.1 XControl

O XControl define uma interface grfica com o usurio, que pode ser composta dequaisquer objetos do E3, com o propsito de ser multiplicada facilmente por seuprojeto. Pode-se criar um XControl clicando com o boto direito do mouse sobre oarquivo .lib criado em seu Domnio (Organizer - Explorer) ou em Bibliotecas de Objetos -XControl, escolhendo a opo Inserir - XControl.

Inserir XControl

Ao inserir um XControl, observe que na parte inferior da tela existem trs abas, Design, Propriedades e Scripts. Na aba Propriedades, pode-se inserir propriedades a seremexportadas pelo objeto. Elas podero ser associadas a um tag ou outra propriedadequalquer quando o objeto estiver sendo usado em um projeto. Na aba Design, queequivale a uma Tela, pode-se inserir os objetos grficos descritos anteriormente.

As propriedades a serem exportadas (XProperties) podem ser inseridas atravs da

tecla INS do teclado ou atravs do boto ; e excludas atravs do boto . Asopes disponveis so descritas a seguir.

Opes disponveis em XControls

OPO DESCRIO

Nome Determina o nome da propriedade do XControl.

Tipo Determina o tipo de dado suportado pela propriedade.

Public Habilita ou desabilita a visibilidade da propriedade fora dabiblioteca, isto, determina se a propriedade ser ou no pblica.

Valor Inicial Determina o valor inicial da propriedade.


Texto deajuda

Texto de declarao e documentao da propriedade.

Note que outros objetos de Dados (XObjects) podem ser declarados como Tipos. Issopermite que em uma nica propriedade seja controlado o funcionamento de todo umobjeto, tornando mais fcil a manuteno de uma biblioteca.

A edio do objeto grfico possui os mesmos recursos grficos e opes da edio deTelas. Pode-se inserir os XControls em qualquer Tela, ou ainda dentro de outroXControl clicando com o boto direito do mouse sobre a Tela ou XControl de destino eescolhendo a opo Inserir.

A partir desse momento, o XControl ter um nome dentro da Tela, e ser entendidocomo uma cpia da definio original. Assim, deve-se definir (se necessrio) osvalores ou as associaes que essa cpia especfica ter no contexto que est sendoutilizada.

9.1.2 XObject

Alm dos objetos grficos, pode-se criar uma biblioteca de dados, chamada XObject.Com ela, pode-se definir uma estrutura de dados a ser executada no servidor. Talestrutura poder realizar clculos, associaes, comunicaes, verificao dealarmes, registro histrico, etc., que independam de alguma interface grfica (Viewer)aberta ou em execuo naquele momento. Para criar um XObject, clique com o botodireito do mouse sobre o arquivo .lib no Organizer e escolha a opo Inserir - XObject.

As opes disponveis para as propriedades do XObject so as mesmas dos XControl,citadas anteriormente.

Alm das XProperties, podem ser inseridos em um XObject quaisquer mdulos do E3que sejam executados no servidor. Para saber a lista completa, basta pressionar oboto que define o tipo do objeto e verificar a lista de opes disponveis.

Isso permite que se possa definir como uma biblioteca um sistema complexo degerenciamento, que poder ser facilmente replicado quantas vezes foremnecessrias no aplicativo.

Pode-se inserir os XObjects em qualquer Servidor de Dados clicando com o botodireito do mouse sobre o Servidor de Dados e escolhendo a opo Inserir.

Mesmo que o(s) arquivo(s) de biblioteca possua(m) vrios XControls e XObjects, aotentar inserir uma biblioteca o E3 Studio exibir para as Telas somente os XControls, epara os Servidores de Dados somente os XObjects.


9.2 Quando Criar um ElipseX

Existem alguns critrios para indicar a necessidade da construo de objetos noElipse E3:

Repetio no uso: se um mesmo equipamento ou processo ser usado mais de umavez no mesmo projeto.

Procedimentos de conhecimento do usurio: frequentemente, um processo criadopor determinada empresa deve ser protegido de cpia ou alterao. Isso comumno caso de integradores de servios ou fabricantes de mquinas.

Uso de controladores: um controlador de processo, cujo mapeamento de memria fixo, pode ser implementado com todas as funcionalidades disponveis. Aflexibilidade disponvel para a construo e uso dos objetos no E3 permite quesejam utilizadas posteriormente apenas as variveis de interesse, desprezando-seas demais.

NOTA: No possvel copiar uma biblioteca e utilizar os dois arquivos (original ecpia) no mesmo Domnio. Por exemplo, no se pode copiar um arquivo .lib parasepar-lo em dois.

9.3 Exerccios

Vamos desenvolver um Display para exibir o valor de temperatura. O Display serformatado com uma casa decimal e sufixo "C". A cor de fundo do Display variaconforme o valor da temperatura.

9.3.1 Biblioteca

1. Clique no boto Novo e, no Assistente de Aplicaes, selecione a opoBiblioteca de componentes do E3. Nomeie-a como LibCaldeira e especifique apasta C:\TreinamentoE3. Avance, adicione-a ao Domnio corrente e conclua oprocesso.


9.3.2 XControl

1. Insira um XControl e chame-o de DisplayTemp.

XControl DisplayTemp

2. Na aba Design, desenhe um Display.

3. Formate o Display com a expresso 0,0 "C".

Formato do Display

4. Para poder receber externamente qualquer valor precisamos criar propriedades.Mude da aba Design para a aba Propriedades no canto inferior da Tela.

Aba Propriedades

5. Crie uma propriedade chamada Temperatura do tipo Double.

Propriedade Temperatura

6. Retorne para a aba Design. No Display, crie uma associao simples com apropriedade Temperatura criada na propriedade Value.

Associao com a propriedade Temperatura

7. Para alterar a cor conforme o valor da temperatura, crie uma associao por tabelana propriedade ForegroundColor informando os limites e as cores desejadas. Napropriedade Fonte, busque a propriedade Temperatura criada anteriormente.


Associao na propriedade ForegroundColor

8. Para que o novo objeto possa ser utilizado preciso registr-lo. Salve asmodificaes. Clique com o boto direito do mouse em Bibliotecas e escolha aopo Registrar bibliotecas carregadas.

Registrar bibliotecas carregadas

9. Insira na tela trs XControl DisplayTemp.

10.Para cada DisplayTemp na tela, faa uma associao simples na propriedadeTemperatura com um tag Temp.


9.4 Anotaes

Scripts 79

10ScriptsCAPTULO

Os Scripts so trechos de cdigo (programao) com os quais se podem criarprocedimentos associados a eventos especficos, permitindo grande flexibilidade nodesenvolvimento e no uso de aplicaes. Todos os scripts esto associados aeventos, e cada objeto do E3 possui uma lista de eventos previamente definidos,sendo possvel tambm definir novos eventos de usurio.

De acordo com conceitos da programao orientada a objetos, as Propriedadesdefinem atributos de um objeto, como a aparncia de um controle de Tela ou o valorinicial de um objeto quando se inicia o aplicativo.

NOTA: Estamos trabalhando at agora apenas com propriedades no E3. Jconhecemos algumas propriedades dos objetos do E3 e vimos que temos duasmaneiras de alter-las, na Janela de Propriedades ou por Associaes.

Os Mtodos so funes previamente definidas, que executam determinadas aessobre as propriedades do objeto que chama estas aes. Exemplos disso so funespara realizar a escrita em tags (Write ou WriteEx), entre outras. Em linguagens deprogramao orientadas a objeto, para agir sobre uma propriedade necessria acriao de mtodos. No E3, para cada mtodo desejado, necessrio definir a qualevento ele estar associado, pois os scripts do E3 so orientados a eventos.

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

10.1 Definindo Scripts

A linguagem que o E3 Studio usa em seus scripts o VBScript, um subconjunto dalinguagem Visual Basic desenvolvida pela Microsoft. O VBScript possui uminterpretador rpido, leve e portvel, desenvolvido para o uso em navegadores para aInternet e outras aplicaes que usam ActiveX Controls, Automation Servers e JavaApplets. Os scripts so sempre associados a eventos de um determinado objeto.Entretanto, para facilitar e aumentar a velocidade de desenvolvimento, o E3 jincorpora algumas aes mais comuns que poderiam ser realizadas com scriptsatravs de assistentes (Wizards) chamados Picks. Pode-se definir que um

80 Scripts

determinado evento executar um script, um Pick ou uma combinao deles, em umasequncia definida durante a criao do script (no E3 Studio).

10.1.1 Obtendo Referncias a Objetos

Uma das caractersticas mais importantes ao se trabalhar com scripts dentro do E3 considerar a separao existente entre os processos que so executados no Servidore aqueles executados na interface do cliente (Viewer). Para se trabalhar com scripts,pode-se manipular:

Objetos do servidor atravs do Servidor

Objetos do Servidor atravs do(s) Viewer(s)

Objetos do Viewer atravs do mesmo Viewer

No entanto, no se pode manipular diretamente:

Objetos do Viewer atravs do Servidor diretamente (s possvel atravs dacriao de eventos no Viewer, ligados a variveis que esto no Servidor)

Objetos de um Viewer a partir de outro Viewer (s possvel atravs da criao deeventos ligados a variveis que esto no Servidor)

Tais limitaes so decorrentes do fato de que, por definio, existe umaindependncia entre o que cada uma das estaes Viewer est fazendo ouvisualizando com relao ao Servidor e vice-versa. Por isso todas as atividades, tantono Servidor quanto no Viewer, necessitam ser coordenadas de forma assncrona ouatravs de eventos para operarem de forma harmoniosa.

Devido a essa independncia, ao se criar um script, primeiro deve-se obter umareferncia correta dos objetos que se deseja manipular, ou seja, necessrio que oobjeto seja primeiramente encontrado nos vrios mdulos do E3.

Vale repetir que, ao se editar um script, o usurio dever utilizar o AppBrowser, quepermite copiar para o script o caminho de um mtodo ou propriedade de formacompleta, auxiliando-o na criao de scripts.

Por exemplo, para se manipular o valor de um Tag de Comunicao, o caminho Servidor - Driver - Pasta (se houver) - Tag. J se o objetivo for manipular um boto naTela, o caminho Viewer - Frame (se houver) - Tela - Boto.

Existem basicamente trs localizaes de origem de scripts, do ponto de vista da

Scripts 81

metodologia para acesso aos objetos:

Servidor (E3 Server)

Telas e Quadros (E3 Viewer)

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

Cada uma delas trata de forma diferente o acesso aos dados que um script deve lidar.A nica ferramenta til para todos esses acessos o App Browser.

10.1.2 Picks

Os Picks implementam uma forma amigvel de realizar procedimentos comuns emscripts, poupando tempo de escrita de cdigo. Entre eles esto aes como troca deTela ou atribuies de valores, que so bastante comuns na criao de um projeto.

82 Scripts

10.1.2.1 Executar Scripts

Permite a edio de um script personalizado que ser executado na ocorrncia doevento determinado.

Pick Executar Scripts

Scripts 83

10.1.2.2 Abrir Tela

Abre uma Tela ou um Quadro determinado.

Pick Abrir Tela

84 Scripts

10.1.2.3 Abrir Tela Modal

Abre uma tela em estilo modal.

Pick Abrir Tela Modal

Scripts 85

10.1.2.4 Executar Aplicao

Executa um programa especfico.

Pick Executar Aplicao

86 Scripts

10.1.2.5 Carregar Valor

Carrega um valor em um Tag.

Pick Carregar Valor

Scripts 87

10.1.2.6 Inverter Valor

Permite mudar o valor de um Tag. Se o valor do Tag for igual a Valor1, ento o Tagrecebe Valor2. Se o valor do Tag for igual a Valor2, ento o Tag recebe Valor1.Se o valor do Tag no for igual nem a Valor1 nem a Valor2, o Tag recebe Valor1.

Pick Inverter Valor

88 Scripts

10.1.2.7 Imprimir Relatrio

Permite imprimir um relatrio na Tela ou na impressora.

Pick Imprimir Relatrio

10.2 Eventos

Os Eventos so ocorrncias relacionadas a um objeto, que disparam aesprogramadas. Basicamente so dois tipos de eventos, Fsicos (ou externos) e Internos.

Eventos fsicos so, por exemplo, aes no teclado ou no mouse. Neste caso, ainformao relevante seria a tecla pressionada ou a posio do cursor e o status dosbotes. Eventos internos so, por exemplo, a mudana de uma temperatura de umacmara de 10 para 11 graus Celsius.

No E3, h uma lista disponvel de eventos classificada por objetos, iniciando peloseventos padro, presentes em todos os objetos. Esses eventos so acessados atravsda aba Scripts, que pode ser consultada atravs das propriedades do objeto para oqual se deseja fazer o script.

Scripts 89

Eventos disponveis

10.2.1 Eventos Definidos pelo Usurio

Apesar de o E3 vir com uma extensa gama de eventos, muitas vezes o usurionecessita criar um evento especfico para sua aplicao. Um exemplo para autilizao de eventos definidos pelo usurio a realizao de um clculo (ou tarefamais complexa) em um objeto, quando o evento gerador vem de um outro tag oupropriedade.

possvel a criao de eventos personalizados definidos pelo usurio atravs daopo Criar novo evento na lista de eventos ou atravs do boto Criar evento do

usurio .

90 Scripts

Criar evento do usurio

10.3 Mtodos

Os Mtodos so procedimentos que podem ser executados por objetos. Por exemplo,o objeto Tela tem um mtodo para a adio de objetos (AddItem) e outro para fech-la (Close). Por estarem encapsulados, isto , guardados dentro dos objetos, nachamada de um mtodo sempre deve constar a qual objeto est se referindo.

Muitos mtodos pr-definidos possuem parmetros, que podem (ou devem) serpassados na chamada do mtodo. Para isso, o VBScript possui uma regra que deve serseguida. Se o mtodo for utilizado em uma atribuio, seus parmetros devem estarentre parnteses. Os parnteses usados nas citaes de mtodos neste manualservem apenas como indicativo para diferenci-los das propriedades. Nos scripts,deve-se seguir esta regra.

Scripts 91

Mtodos no AppBrowser

10.4 Propriedades

Todo objeto possui Propriedades, que guardam informaes a respeito de suascaractersticas. Por exemplo, um objeto do tipo Retngulo possui a propriedade Name, que contm seu nome e as propriedades Width e Height, que guardam a sua largurae a sua altura, respectivamente, entre outras. Para acessar as propriedades, utilizeas mesmas especificaes anteriores, porm selecione a pasta Propriedades.

10.5 Exerccios


92 Scripts

10.5.1 Pick Abrir Tela

1. Na TelaMenu insira um Command Button no canto direito da tela. Napropriedade Caption digite "Eventos".

2. Selecione o boto e altere para a aba Scripts.

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

Script do tipo Abrir Tela

4. Selecione a TelaEventos no campo Abrir a tela e o divisor Inferior no campoNo Quadro.

Abrir Tela em Quadro

5. Copie o Command Button Eventos para criar o boto Caldeira.

6. Altere o script para navegar para a TelaCaldeira.

10.5.2 Pick Script

1. Insira um novo Command Button com o texto "Sair".

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

Evento do tipo Script

3. Com o auxlio do AppBrowser , procure o mtodo Exit do Viewer e aperte o botoColar.

Application.Exit

4. Execute a aplicao e teste as novas funcionalidades.

Scripts 93

10.5.3 Pick Inverter Valor

1. Na TelaCaldeira, ao clicar em cima do motor ele deve ligar ou desligar.Selecione o motor e acesse a aba Scripts.

2. Crie um novo Pick do tipo Inverter Valor.

Pick Inverter Valor

3. Busque a propriedade Value do tag Motor (Servidor Dados Motor) no campoNome do Tag.

4. Nos campos Valor 1 e Valor 2, altere para Boolean. Marque um deles como True e ooutro como False.

Valores 1 e 2 do Tag

94 Scripts

10.6 Anotaes

Segurana 95

11SeguranaCAPTULO

O E3 possui um controle de acesso a Telas, Alarmes e Domnios em uma lista deusurios, onde para cada nome atribudo uma senha e um login. Conforme a opoconfigurada, o sistema permitir acesso aos usurios cadastrados ou acessoilimitado s Telas do projeto.

96 Segurana

11.1 Usurios

Atravs da opo Usurios possvel configurar as informaes referentes aosusurios que tero ou no acesso ao sistema. Para utilizar este recurso, precisoacessar o menu Arquivo - Usurios e clicar na aba Usurios.

Aba Usurios

IMPORTANTE: Aps configurar a segurana, somente os usurios listados teroacesso ao sistema.

Segurana 97

11.2 Grupos

A opo Grupos permite que sejam criados grupos com caractersticas que serocomuns para todos os seus membros (usurios). Um grupo tambm pode pertencer aoutros grupos. S no permitido pertencer a outro grupo que pertena a ele, ou seja,uma referncia circular. Para utilizar este recurso, necessrio acessar o menu Arquivo - Usurios e selecionar a aba Grupos.

Aba Grupos

11.3 Permisses

A aba Permisses configura as permisses dos usurios e grupos para Telas, Alarmes,Domnio e Viewer. Uma verificao de permisso consiste em uma informao que omembro do grupo tem sobre um comando que atua sobre um objeto especfico.

Por exemplo, o Usuario1 tem permisso para o comando Abrir sobre o objeto

98 Segurana

Tela1. Cada membro do grupo pode negar ou afirmar a permisso de um comando,independentemente do grupo a qual pertence. Dessa forma, ele no vai levar emconsiderao a informao do grupo. Tambm pode-se optar por sempre utilizar ainformao definida pelo grupo. Se as informaes dos grupos forem conflitantes,ser usada a seguinte ordem de preferncia, Negar > Afirmar > Indiferente.

Aba Permisses

Segurana 99

11.4 Proteo

O E3 possui uma ferramenta de proteo de projetos ou de bibliotecas. Atravs desseitem, possvel proteger o contedo do arquivo contra a edio, a visualizao ou aexecuo no autorizada. Para utilizar esse recurso, clique com o boto direito domouse sobre o nome do projeto no Organizer e selecione a opo Proteger.

Proteo de arquivos

Esta opo possui dois tipos de proteo, de Edio e de Execuo.

Proteo de Edio: Protege o arquivo contra alteraes e visualizaes noautorizadas. Esse recurso utilizado para evitar que determinada biblioteca ouprojeto seja alterado acidentalmente, ou que sejam copiados procedimentos deconhecimento especfico do desenvolvedor. O E3 fornece um controle sobre a

100 Segurana

edio desses arquivos, sejam eles projetos ou bibliotecas.

Proteo de Execuo: Esta opo utilizada para proteger um arquivo contraexecuo no autorizada. Para tanto, necessrio solicitar a gravao de umasenha de proteo na hardkey, que feita pela Elipse Software. Isso protege odesenvolvedor de cpias no autorizadas do projeto, por exemplo.

Quando um arquivo .lib ou .prj aberto no E3 Studio, este inicializa mostrando um

cone cinza , com um cadeado indicando que est protegido e esse contedo nopode ser acessado. Para acessar o contedo do arquivo, clique no cone da direita emude para Abrir com senha. Aps informar a senha e o sistema liberar o acesso, o

cone fica colorido , indicando a acessibilidade dos arquivos.

IMPORTANTE: As protees implementadas no podem ser desfeitas caso as senhassejam perdidas. Portanto, ao proteger determinado arquivo, mantenha as senhasarmazenadas de modo seguro. Isso garante que se conseguir usar o arquivo sempreque necessrio.

11.5 Exerccios

A seguir, ser visto como configurar usurios em um Domnio no E3 e como utilizaresse recurso para inibir ou permitir acesso a Telas, controles, alarmes, etc.

Segurana 101

11.5.1 Usurios

1. No menu Arquivo, selecione a opo Usurios.

Menu Arquivo - Usurios

2. Acesse a aba Grupos e crie dois grupos de usurios, chamados Administrador eOperador.

3. Atravs da aba Usurio, crie trs usurios. Cuidado que maisculas e minsculasfazem diferena.

Adicionar usurio

102 Segurana

4. Configure um usurio para pertencer ao grupo Administrador e dois parapertencerem ao grupo Operador.

11.5.2 Permisses

1. Na aba Permisses, selecione a opo Grupos. Bloqueie a TelaEventos para ogrupo Operador.

2. Nas permisses de usurios, d permisso para um dos usurios do grupooperador acessar a TelaEventos.

11.5.3 Login

1. Na TelaMenu, insira um novo Command Button com o texto "Login". No eventoClick, crie um novo Pick do tipo Script.

2. Busque no AppBrowser o mtodo Login do Viewer e aperte o boto Colar.

Application.Login(true)

3. Crie um segundo Display na TelaMenu para exibir o nome do usurio logado naaplicao.

4. Associe a propriedade Value do Display do usurio com a propriedade User doViewer.

Associao da propriedade User

Segurana 103

11.6 Anotaes

104 Banco de Dados

12Banco de DadosCAPTULO

O Banco de Dados do E3 utilizado para armazenar as informaes do projetoreferentes aos Histricos, Frmulas e Alarmes. Possui suporte a MDB (MicrosoftAccess), Oracle e Microsoft SQL Server. Para utilizar esse recurso, siga estesprocedimentos:

1. Clique com o boto direito do mouse sobre o nome do projeto e depois em Inserir -Banco de Dados.

2. No caso do banco de dados Access, insira o nome do arquivo desejado (existente ouno) no campo Arquivo MDB.

3. Deixe em branco os campos Usurio e Senha. Estes campos so utilizados somentese o banco de dados especificado para a conexo j possuir usurio e senha.

4. Deixe o campo Senha do DB em branco. Conforme especificado acima, este campos utilizado caso o banco de dados especificado possua senha do DB.

5. Clique no boto OK para finalizar as configuraes.

12.1 Exerccios


Banco de Dados 105

12.1.1 Banco de Dados

Este banco de dados ser utilizado para armazenar todos os dados de Alarmes eHistricos dos projetos.

1.Insira um novo banco de dados no TreinamentoE3.

Inserir Banco de Dados

2. Renomeie o banco de dados para BancoDados.

3. Escolha o banco de dados Access.

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

5. Teste a conexo com o banco de dados.

106 Banco de Dados



12.2.1 KB

KB-29527: O E3 suporta outro banco exceto Access, SQL Server e Oracle?

Banco de Dados 107

12.3 Anotaes

108 Alarmes

13AlarmesCAPTULO

O mdulo de Alarmes do E3 consiste basicamente em duas unidades, cujofuncionamento interligado logicamente:

Servidor de Alarmes: Organiza o modo como os eventos e alarmes sero tratados.

Configurao de Alarmes: neste objeto que os alarmes a serem tratados socriados e suas fontes configuradas.

13.1 Servidor de Alarmes

O objeto Servidor de Alarmes centraliza todos os alarmes do projeto. Nele podem serencontrados os totais de alarmes ativos da aplicao (reconhecidos ou no). Eletambm o responsvel por reportar os eventos de alarmes para todos os Viewersconectados, bem como, se desejado, enviar esses eventos para um Banco de Dados.

IMPORTANTE: Um Domnio pode ter somente um objeto desse tipo, e a sua presena obrigatria para que haja verificao de alarmes.

Atravs da aba Configurao possvel especificar se os alarmes sero armazenadosno Banco de Dados. Os alarmes podem ser visualizados em um E3Alarm ou umE3Browser, objetos de Tela que sero vistos mais adiante.

13.2 Configurao de Alarmes

O objeto Configurao de Alarmes onde as fontes de alarme so criadas. Para inseriresse objeto no projeto, clique com o boto direito do mouse sobre o Organizer eescolha a opo Inserir - Configurao de Alarmes.

Alarmes 109

13.2.1 rea

O objeto rea permite agrupar um conjunto de Fontes de Alarmes, bem como outrasreas de Alarme. Isso facilita o gerenciamento, a operao e o monitoramento de umconjunto de fontes de alarmes relacionados, permitindo, por exemplo:

Filtrar o conjunto de alarmes visveis no sumrio

Habilitar ou desabilitar um conjunto de Fontes de Alarmes

Reconhecer um conjunto de Fontes de Alarmes

Verificar o total de alarmes ativos ou no reconhecidos de um conjunto de Fontesde Alarmes

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

13.2.2 Fontes de Alarme

As Fontes de Alarme definem todas as informaes relativas s condies de alarme.Em cada fonte de alarme so configurados seus limites, a mensagem relativa aoevento, sua severidade, bem como a necessidade ou no de reconhecimento desseevento. Todas as fontes de alarmes possuem as seguintes propriedades gerais.

Propriedades gerais das Fontes de Alarme

PROPRIEDADE DESCRIO

Texto daMensagem

o texto associado quela condio de alarme, que aparecer noobjeto de visualizao (E3Alarm), Banco de Dados, etc. Pode conterat 255 caracteres de texto.

Severidade Indica a gravidade do alarme ocorrido, podendo ser Baixa, Mdia ouAlta. A severidade utilizada para filtragem e ordenao demensagens.

Pede Ack Indica que o alarme deve ser reconhecido pelo operador para serretirado da lista de alarmes no E3Alarm, ou ainda se reconhecidoautomaticamente quando a varivel deixa uma condio dealarme.

Mensagem deRetorno

Sempre que uma Fonte de Alarme sai da condio de alarme, essamensagem ser exibida nos objetos de visualizao.

110 Alarmes

H vrios tipos de Fontes de Alarme que podem ser inseridas na rea do Alarme. Ostipos de Fontes de Alarmes esto descritos nas sees seguintes.

13.2.2.1 Analgico

Permite monitorar uma varivel analgica, pela especificao de at quatro nveis dealarme, que so o LOLO (muito baixo), LO (baixo), HI (alto) e HIHI (muito alto).

Alarme Analgico

Alarmes 111

13.2.2.2 Digital

Permite monitorar uma varivel (ou expresso) digital, pela especificao de alarmena borda de subida (em -1 ou True) ou na borda de descida (em 0 ou False).

Alarme Digital

112 Alarmes

13.2.2.3 Banda Morta

Permite monitorar uma varivel analgica pela especificao de um limite mximo dediferena (valor de banda morta) em relao a um valor de referncia (Setpoint).

Alarme Banda Morta

Alarmes 113

13.2.2.4 Taxa de Variao

Permite monitorar variaes muito rpidas em uma varivel do processo. A taxa devariao usa seus valores especificados em unidades da varivel por segundo.

Alarme Taxa de Variao

114 Alarmes

13.3 E3Alarm

O E3Alarm serve para o monitoramento dos alarmes ativos ou no reconhecidos nosistema. Atravs desse objeto, possvel verificar o estado dos alarmes no sistema,bem como reconhec-los manualmente. Para utilizar esse objeto, clique com o botodireito do mouse na rea de trabalho, e selecione a opo E3Alarm.

E3Alarm

Na aba Geral das propriedades do E3Alarm so especificadas as informaesreferentes ao Servidor de Alarmes e ao filtro.

Alarmes 115

Aba Geral do E3Alarm

13.4 Exerccios


13.4.1 Servidor de Alarmes

Uma aplicao s pode ter um objeto desse tipo, e a sua presena obrigatria paraque haja verificao de alarmes. Ele o responsvel por reportar os eventos dealarmes para todos os Viewers conectados, bem como, se desejado, enviar esseseventos para um Banco de Dados.

1. Insira um objeto Servidor de Alarmes no TreinamentoE3.

116 Alarmes

Inserir Servidor de Alarmes

2. Acesse as propriedades do Servidor de Alarmes, e na aba Configurao habilite aopo Guarde alarmes no banco de dados.

3. Na opo Utilize o servidor de banco de dados, escolha BancoDados.

4. Habilite a opo Descarta dados da tabela principal.

Mantenha os dados dos ltimos 3 meses

A verificao deve ocorrer a cada 1 ms

5. Clique no boto Campos e selecione os campos que desejar.

Alarmes 117

Selecionar campos da tabela

6. Por ltimo, clique no boto Gerar Tabela. Ser exibida uma mensagem de sucesso.

Sucesso na gerao da tabela

118 Alarmes

13.4.2 Configurao de Alarmes

1. Insira no projeto TreinamentoE3 um objeto Configurao de Alarmes.

Inserir Configurao de Alarmes

13.4.3 Alarme Analgico

1. Crie dentro desse objeto uma nova rea de Alarmes pressionando o boto Adicionar e modifique o seu nome para Temperatura.

Inserir rea

2. Selecione a rea criada e clique no boto Adicionar. Insira uma Fonte de Alarme dotipo Analgico.

Alarmes 119

Inserir Fonte de Alarme Analgica

3. Renomeie o Alarme Analgico para Temp1.

4. Clique sobre a rea de edio da Fonte de Temp1 e, atravs do AppBrowser,selecione a propriedade Value do tag Temp1 da pasta Dados.

5. Acesse as propriedades do Alarme Temp1, aba Analgico.

Marque o item LoLo, com limite igual a 20 e mensagem "Temperatura 1 MuitoBaixa".

Marque o item Lo, com limite igual a 50 e mensagem "Temperatura 1 Baixa".

Marque o item Hi, com limite igual a 150 e mensagem "Temperatura 1 Alta".

Marque o item LoLo, com limite igual a 180 e mensagem "Temperatura 1Muito Alta".

No item Volta ao normal, digite "Temperatura 1 normalizada".

120 Alarmes

Aba Analgico

6. Copie o Alarme Temp1 para criar os Alarmes Temp2 e Temp3.

7. Associe cada Alarme ao seu respectivo tag.

13.4.4 Alarme Digital

1. No objeto ConfigAlarmes1, insira uma nova rea chamada Caldeira.

2. Na rea Caldeira, insira um Alarme Digital chamado Pressao.

3. No campo Fonte, busque a propriedade Value do tag Pressao e edite a expressopara "Dados.Pressao.Value > 300".

Propriedade Value do Tag Pressao

4. Acesse as propriedades do Alarme Pressao, aba Digital e digite a mensagem quedesejar.

Alarmes 121

Aba Digital

13.4.5 Alarme Banda Morta

1. Na rea Caldeira, insira um Alarme de Banda Morta chamado Vapor.

2. No campo Fonte, busque a propriedade Value do tag Vapor.

Propriedade Value do Tag Vapor

3. Acesse as propriedades do Alarme Vapor, aba Banda Morta e configure comomostrado na figura a seguir.

Propriedades do Alarme Vapor

122 Alarmes

13.4.6 Alarme ROC

1. Na rea Caldeira insira um Alarme ROC chamado Vazao.

2. No campo Fonte busque a propriedade Value do tag Vazao.

Propriedade Value do Tag Vazao

3. Acesse as propriedades do Alarme Vazao, aba Taxa de Variao e configure comomostrado na figura a seguir.

Propriedades do Alarme Vazao

13.4.7 E3Alarm

A visualizao dos alarmes em tempo real pode ser feita atravs do objeto E3Alarm.

1. Posicione um objeto E3Alarm na TelaMenu.

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

Alarmes 123

Aba Geral do E3Alarm

3. A mesma configurao pode ser feita atravs da Lista de Propriedades. Napropriedade AlarmServer, digite o nome do Servidor de Alarmes, ou arraste-o at apropriedade.

Propriedade AlarmServer do E3Alarm

4. Acesse as propriedades do E3Alarm. Na aba Colunas, selecione os campos DataHora

124 Alarmes

, Operador, Mensagem, Reconhecido e Valor.

5. Na aba Cores, faa a configurao que desejar.

Alarmes 125

13.5 Anotaes

126 Histricos

14HistricosCAPTULO

Os Histricos so os mdulos responsveis pelo armazenamento de dados daaplicao em Banco de Dados. Permitem armazenar dados de processos paraanlises futuras, no E3 ou em qualquer outra ferramenta.

Podem-se criar tantos arquivos de Histrico quantos se desejar, cada um contendodiversos tags ou expresses. Cada Histrico pode criar ou utilizar uma tabelaindependente dentro do Banco de Dados, cujo armazenamento pode ser definido por Tempo ou por Evento. possvel ainda determinar qual Banco de Dados inserido noprojeto ser utilizado para o armazenamento dos dados.

Para utilizar esse recurso, clique com o boto direito do mouse no item Objetos doservidor - Banco de dados no modo Domnio e selecione a opo Inserir Histrico em e,em seguida, o nome do projeto desejado.

Para criar a tabela no Histrico, importante criar seus campos. Tais campos podemser criados atravs do boto (Adicionar um campo). Para remover algum campo

indesejado, clique no boto (Remover um campo).

Adicionar ou remover campos

14.1 Chave Primria

A Chave Primria um campo ou um conjunto de campos que identifica de maneiranica cada registro de uma tabela. Assim como o ndice principal para a tabela, ela utilizada para associar dados entre tabelas. Aps ter definido um campo como sendoa chave primria da tabela, o prprio Banco de Dados garante que no sejaminseridos dados duplicados no(s) campo(s) que seja(m) chave(s) primria(s).

Histricos 127

H dois tipos de chave primria, a Simples e a Composta. Uma Chave Primria Simples um campo que identifica de modo nico cada registro de uma tabela. Uma ChavePrimria Composta pode ser formada pela combinao de dois ou mais campos databela. Podem existir casos em que um nico campo no seja capaz de atuar comochave primria, pelo fato de apresentar valores repetidos. Alm disso, uma tabelapode ter somente uma Chave Primria, seja ela simples ou composta. Ou seja, no sepodem definir dois ou mais campos de uma tabela para ser uma chave primriaseparada cada. No confundir com o caso de uma chave primria composta, onde aunio de dois ou mais campos que forma a nica chave primria da tabela.

Ao escolher campos para uma chave primria, considere os seguintes detalhes:

No permitida duplicidade de valores ou valores nulos.

Caso no exista um identificador nico para uma determinada tabela, pode-se usarum campo que numere os registros sequencialmente.

A chave primria pode ser configurada de duas formas. Verificando na Tela doHistrico o campo da tabela que se deseja tornar Chave Primria e habilitando-o

atravs do boto , ou clicando no cone , que abrir a Tela de configurao.

14.2 ndices

Um ndice um campo ou um conjunto de campos que sero previamente ordenadospelo Banco de Dados a fim de melhorar a performance das consultas que utilizamesse ndice. Eles so utilizados para encontrar registros com um valor especfico emuma coluna rapidamente. Sem um ndice, o Banco de Dados tem de iniciar com oprimeiro registro e depois ler os registros atravs de toda a tabela at que seencontre os registros relevantes. Quanto maior a tabela, maior ser o custo emtermos de tempo de processamento. Se a tabela possui um ndice para as colunas emquesto, o Banco de Dados pode rapidamente obter uma posio para procurar nomeio do arquivo de dados sem ter que varrer todos os registros. Os tipos de ndicesdisponveis so Primrio, nico e Index.

Podem-se criar ndices em mltiplas colunas. Um ndice de mltiplas colunas podeser considerado um vetor ordenado contendo valores que so criados concatenandovalores de colunas indexadas. Os ndices podem ser configurados atravs do cone

, que abre a tela de configurao, ilustrada a seguir.

128 Histricos

Editor de ndices

14.3 Exerccios


Histricos 129

14.3.1 Histrico

1. Clique com o boto direito do mouse no Banco de Dados, no modo Domnio, e Insira

um novo Histrico no projeto TreinamentoE3, nomeando-o comoHistCaldeira.

Inserir Histrico

2. No Histrico criado, insira trs novos campos e configure-os conforme a figura aseguir.

Campos do Histrico

3. Clique sobre a opo Propriedades do Histrico e, na aba Histrico, configure as

130 Histricos

seguintes propriedades.

Banco de dados: BancoDados

Tabela: Caldeira

Tempo de gravao: 5000 ms

4. Clique no boto Gerar Tabela. Deve aparecer a mensagem A estrutura de tabelas foicriada com sucesso.

Sucesso na criao da tabela

Histricos 131

14.4 Anotaes

132 Consultas

15ConsultasCAPTULO

O objeto Consulta (ou Query) auxilia no processo de definio de consultas no Bancode Dados da aplicao. Toda vez que o E3 necessita buscar dados do Banco de Dados necessrio enviar um comando, de forma que se saiba quais os dados desejados paraaquele objeto. Para essa busca, toda vez que uma aplicao precisar gravar ou buscardados armazenados em um Banco de Dados, so enviados comandos no formato SQL (Structured Query Language).

A Consulta apresenta uma interface amigvel que permite a construo de consultasSQL usando uma interface grfica e o acompanhamento imediato do cdigo SQL sendogerado. A Consulta permite mostrar os dados dos ltimos n dias, horas ou meses,data inicial e final e consultas, dependendo do filtro a ser implementado.

O assistente de configurao da Consulta responsvel por criar o texto que faz ofiltro ou a consulta, no sendo necessrio para o usurio saber detalhes como data,etc.

Para utilizar esse recurso, clique com o boto direito do mouse sobre a Tela doprojeto e selecione a opo Inserir - Consulta.

NOTA: Quando criado um objeto Relatrio ou E3Browser, o objeto Consulta adicionado a este automaticamente. No entanto, tambm pode-se inserir umaConsulta em uma Pasta de Dados ou na Tela e utilizar seus dados atravs de scripts.

Consultas 133

15.1 Criando uma Consulta

1. A definio da Consulta comea quando o usurio informa o Servidor de Banco deDados onde a Consulta ir buscar os dados.

Definir o Servidor de Banco de Dados

2. Aps ser definido o Banco de Dados, uma nova janela aparecer com as tabelasque foram encontradas, permitindo a sua seleo.

134 Consultas

Seleo de tabelas

3. Selecione as tabelas que faro parte da Consulta e clique no boto Adicionar.

4. Na aba Campos, sero adicionados os campos a serem retornados pela Consulta,bem como definidos filtros e ordenaes.

5. Na aba Variveis, so mostradas as variveis criadas para os filtros.

6. Na aba Visualizar

Documents

e3tutorial Beginner Ptb