Você está na página 1de 147

Tutorial do E3 para Iniciantes

2012 Elipse Software Ltda. Todos os direitos reservados.


30/07/2012 - Verso 4.0

Sumrio
1 Apresentao

1.1 A Elipse

1.2 Mdulos do E3

1.3 O Treinamento
1.4 Anotaes
2 Elipse Knowledgebase

7
10
11

2.1 Elipse Knowledgebase

11

2.2 Busca no Knowledgebase

12

2.3 Categorias

13

2.4 Anotaes

15

3 Iniciando a Aplicao

16

3.1 Criando sua Aplicao

17

3.2 Execuo de um Domnio

20

3.3 Exerccios

20

3.4 Exerccios Complementares

22

3.5 Anotaes

23

4 Servidor de Dados

24

4.1 Regras para Nomes de Tags

25

4.2 Exerccios

25

4.3 Anotaes

28

5 Telas e Quadros

29

5.1 Tela

29

5.2 Quadros

30

5.3 Viewer

31

5.4 Exerccios

34

5.5 Anotaes

37

6 Objetos de Tela

38

6.1 Controles Microsoft Forms

38

6.2 Galeria

39

6.3 Exerccios

40

6.4 Exerccios Complementares

44

6.5 Anotaes

45

7 Associaes

46

7.1 Tipos de Associaes

46

7.2 Valores Booleanos

50

7.3 Exerccios

51

7.4 Anotaes

55

8 Comunicao

56

8.1 Driver de Comunicao

56

8.2 Driver de Comunicao OPC

59

8.3 Exerccios Complementares

61

8.4 Anotaes

62

9 Bibliotecas ElipseX

63

9.1 Criao de Bibliotecas do Usurio

64

9.2 Quando Criar um ElipseX

67

9.3 Exerccios

67

9.4 Anotaes

70

10 Scripts

71

10.1 Definindo Scripts

71

10.2 Eventos

79

10.3 Mtodos

81

10.4 Propriedades

82

10.5 Exerccios

82

10.6 Anotaes

85

11 Segurana

86

11.1 Usurios

86

11.2 Grupos

87

11.3 Permisses

87

11.4 Proteo

89

11.5 Exerccios

90

11.6 Anotaes

92

12 Banco de Dados

93

12.1 Exerccios

93

12.2 Exerccios Complementares

94

12.3 Anotaes

96

13 Alarmes
13.1 Servidor de Alarmes
13.2 Configurao de Alarmes

97
97
97

13.3 E3Alarm

101

13.4 Exerccios

102

13.5 Anotaes

109

14 Histricos

110

14.1 Chave Primria

110

14.2 ndices

111

14.3 Exerccios

112

14.4 Anotaes

115

15 Consultas

116

15.1 Criando uma Consulta

116

15.2 E3Browser

118

15.3 Exerccios

119

15.4 Anotaes

122

16 E3Chart

123

16.1 Configuraes das Penas

123

16.2 Exerccios

125

16.3 Exerccios Complementares

127

16.4 Anotaes

128

17 Relatrios

129

17.1 Objetos do Relatrio

131

17.2 Exerccios

132

17.3 Anotaes

135

18 Exerccios de Reviso

136

18.1 Exerccio

136

18.2 Resoluo

139

18.3 Anotaes

146

CAPTULO

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

1.1 A Elipse
A Elipse Software uma empresa genuinamente brasileira, com foco na produo de software
de superviso para automao industrial, surgida em Porto Alegre no incio dos anos 90.
Seu primeiro produto foi o Elipse 21, um software para a plataforma DOS, que era conhecido
por sua facilidade de operao e compatibilidade com diferentes fabricantes.
Em 1996, a Elipse lanou a primeira verso do Elipse Windows, que mais tarde se tornaria o
Elipse SCADA. Desde essa poca, foram instaladas cerca de 3.500 cpias desse software no
Brasil.
Em 2000, a Elipse iniciou o desenvolvimento do E3, a terceira gerao de software de
superviso da empresa. Desde seu lanamento comercial em 2001, cerca de 500 licenas
desse software j foram instaladas e o E3 vem sendo utilizado em sistemas diversos, como
Centros de Operao de empresas eltricas, plantas industriais de diversas finalidades,
sistemas de telemedio e controle de energia, automao e controle predial, minerao,
entre outros.
A Elipse Software trabalha em parceria com distribuidores internacionais localizados em
pases estratgicos como Alemanha, Holanda, Taiwan, ndia, Canad e outros, alm de
manter escritrio prprio nos Estados Unidos, na cidade de Avon, Carolina do Norte.

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 a
comunicao em tempo real com os equipamentos de controle. O servidor tambm
responsvel por enviar dados e Telas aos clientes conectados em qualquer parte da rede
(Intranet e Internet). O servidor pode executar vrios projetos ao mesmo tempo e conversar
com outros E3 Servers para realizar um failover (standby) ou distribuir cargas de
6

Apresenta o

processamento entre as mquinas. Foi desenvolvido para ser executado sobre os sistemas
operacionais Windows XP SP3, XP x64 SP2, Server 2003 SP2, Vista SP2, Server 2008 SP2, Server
2008 R2 SP1 e Windows 7 SP1.

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

1.2.3 E3 Viewer
O Viewer permite operar as aplicaes residentes no servidor em qualquer computador com
o programa executvel Viewer (Windows XP, 2003, Vista e Windows 7) ou com um navegador
de Internet. Em ambos os casos, no necessrio instalar a aplicao 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 o usurio.
Atravs dele o usurio pode enviar comandos ao E3 Server, utilizando o cone na rea de
Notificao da Barra de Tarefas do Windows, e controlar o Domnio pela linha de comando.

1.3 O Treinamento
A sequncia de aprendizado a ser seguida neste Tutorial reflete o que a Elipse Software
considera o conjunto de melhores prticas no desenvolvimento de aplicativos de superviso
e controle, tanto para o E3 (o objeto de estudo deste Tutorial) quanto para o Elipse SCADA ou
outros softwares de superviso.
A base do roteiro desse manual uma aplicao hipottica, que apresenta os recursos mais
importantes do software E3. Essa aplicao hipottica no cobre todas as possibilidades de
desenvolvimento oferecidas pela ferramenta. No entanto, a quantidade e qualidade das
informaes apresentadas neste primeiro contato com o software so suficientes para que
voc aprenda a utiliz-lo com autonomia para criar suas 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 criar animaes
em Telas
Comunicao de dados: uso de drivers e uso de OPC
Apresenta o

Uso de Bibliotecas ElipseX: poderosa ferramenta de bibliotecas funcionais disponvel


apenas no E3
Integrao a Bancos de Dados: uso de funes e ferramentas para acesso e consulta 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 grande quantidade de
recursos para a criao de relatrios
Recursos Avanados: redundncia, acesso ao aplicativo atravs de browser, configuraes
de segurana de usurios, entre outros

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 os alunos
passo-a-passo, facilitando o entendimento e aprendizado da ferramenta.
O sistema em questo apresenta um sintico de uma usina de acar, exemplificando vrios
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. O operador do sistema pode
visualizar as temperaturas e informaes da caldeira e controlar o funcionamento do motor.

Sintico de uma usina de acar


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

Apresenta o

Condies de alarme
Finalmente, um procedimento de consulta dos alarmes, que permite visualizao e
impresso dos dados de histricos.

Visualizao e impresso de dados histricos


Sua participao muito importante para ns. Ao final do treinamento, ser solicitado que
voc avalie diversos aspectos do curso, como a qualidade e a quantidade das informaes
transmitidas em aula e pelo Tutorial, alm do trabalho do instrutor e a qualidade das
instalaes. Qualquer sugesto ou crtica bem-vinda pela equipe de desenvolvimento desse
Tutorial.
A Elipse Software deseja a voc um timo treinamento, e uma boa experincia de trabalho
com o E3!

Apresenta o

1.4 Anotaes

10

Apresenta o

CAPTULO

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

Pgina inicial do KB

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 assinalados como
favoritos

Elipse Know ledgebase

11

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 usurio digitar,
retornando todos os artigos que possuem a palavra alvo da busca. Basta digitar 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 a consulta.
Basta acessar a opo Busca Avanada.

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

12

Elipse Know ledgebase

2.3 Categorias
Existe a possibilidade do usurio 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 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 duas categorias
principais: Ingls e Portugus.
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
especfico.
Acessando os artigos pela categoria Portugus - Elipse E3 tem-se:

Categorias em portugus

Elipse Know ledgebase

13

Note que dentro de cada uma destas subcategorias aparece um nmero. Este nmero indica
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 para aparecerem em
destaque. Normalmente esta seo utilizada para ressaltar algum artigo que merece
uma ateno especial por parte dos usurios dos softwares 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 foram adicionados
na base de dados do Knowledgebase
Buscas Mais Utilizadas: Mostra as 10 palavras que mais foram utilizadas como busca pela
ferramenta de busca do Knowledgebase

14

Elipse Know ledgebase

2.4 Anotaes

Elipse Know ledgebase

15

CAPTULO

Iniciando a Aplicao
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, o sistema 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.

Criar um Domnio novo

Cria um novo Domnio atravs do Assistente


de aplicaes do E3. Sero requisitados o
nome e caminho do novo Domnio.

Abrir um Domnio existente

Abre um Domnio existente dentre os ltimos


editados. Clicando em Outros arquivos podese localizar um Domnio em um diretrio
especfico.

16

Inic iando a Aplic a o

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 em Branco. A
primeira opo cria um projeto pr-configurado com alguns objetos bsicos e um assistente
de criao de projeto, enquanto que a segunda opo cria um projeto vazio a ser
implementado pelo usurio.

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

Inic iando a Aplic a o

17

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 mais
adiante.

18

Inic iando a Aplic a o

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 atravs de uma rvore
hierrquica de opes. Possui dois modos de visualizao, Domnio e Explorer.

Janela do Organizer em modo Domnio


O modo Domnio mostra apenas as informaes dos objetos abertos pertencentes ao
Domnio, 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 ou no ao
Domnio. Os objetos so mostrados no projeto ou biblioteca ao qual pertencem, ordenados
alfabeticamente dentro de cada projeto ou biblioteca.

Inic iando a Aplic a o

19

3.1.5 Lista de Propriedades


A Lista de Propriedades uma janela que mostra todas as propriedades do objeto em uso,
permitindo a sua configurao de forma simples e rpida. Sempre que uma propriedade for
configurada na Lista de Propriedades, seu valor no ser mudado automaticamente, 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
Ferramentas.

na Barra de

Lista de propriedades

3.2 Execuo de um Domnio


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

Executar aplicativo: Salva todas as configuraes dos projetos e bibliotecas, e executa 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.

20

Inic iando a Aplic a o

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

Assistente de Aplicaes
2. No Assistente de Aplicaes, clique em Avanar, selecione a opo Aplicao Padro e
nomeie o projeto como TreinamentoE3.
3. Ajuste o caminho da aplicao para C:\TreinamentoE3 e clique em Avanar.
4. Na prxima janela do Assistente, selecione a opo Criar um novo Domnio e use o mesmo
nome do projeto.

Inic iando a Aplic a o

21

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

3.4 Exerccios Complementares


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 uma licena
somente Studio?

22

Inic iando a Aplic a o

3.5 Anotaes

Inic iando a Aplic a o

23

CAPTULO

Servidor de Dados
O Servidor de Dados o mdulo responsvel pela execuo e gerenciamento de tags e objetos
que no estejam envolvidos diretamente com a comunicao. Atravs do Servidor de Dados
pode-se configurar tags internos e tags de simulao, alm de inserir XObjects, que so os
objetos de dados das bibliotecas ElipseX (vistas mais adiante). Alguns dos objetos que podem
ser inseridos no servidor de dados so descritos 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 atingir um valor prdeterminado, ou que faz uma certa
contagem indefinidamente.

Tag Demo

Objeto que gera valores de acordo com a


forma de onda. utilizado para simulao de
valores. Permite gerar curvas definidas ou
valores aleatrios.

Tag Interno

Objeto de propsito genrico, utilizado para


guardar valores de qualquer 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 das informaes. Novas pastas
podem ser inseridas dentro de outras,
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 E3 trabalha.

24

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. Esses
caracteres so trocados pelo caractere sublinhado. Assim, o sistema aplica a Regra dos
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-se levar
em conta as seguintes regras:
Se o primeiro caractere no for uma letra ou um caractere sublinhado, o nome deve estar
entre colchetes
Se algum dos demais caracteres (do segundo em diante) no for uma letra, um nmero ou
um caractere sublinhado, o nome tambm deve estar entre colchetes
Caso existam caracteres especiais (por exemplo, acentos), o nome deve estar entre
colchetes

4.2 Exerccios
Esta seo contm exerccios sobre o contedo deste captulo.

Servidor de Dados

25

4.2.1 Horrio do Sistema


1. Para obter o horrio corrente do sistema necessrio criar um Tag Demo que acesse essa
informao. Na pasta Dados do TreinamentoE3 insira um Tag Demo 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. Normalmente esses
valores so reais e vem de Tags de Comunicao, mas nos exerccios do Tutorial usaremos
Tags do tipo Demo.
1. Na pasta Dados insira os Tags Demo com as seguintes propriedades configuradas:

NAME
Pressao

26

MINIMUM
0

MAXIMUM
450

TYPE
0 - Random

Servidor de Dados

NAME

MINIMUM

MAXIMUM

TYPE

Vazao

500

0 - Random

Vapor

100

0 - Random

Nivel

1000

1 - Sine

Caminhao

100

4 - RampUp

Temp1

200

0 - Random

Temp2

200

0 - Random

Temp3

200

0 - Random

4.2.3 Tag Interno


Quando se deseja armazenar um valor para utiliz-lo futuramente, cria-se um Tag Interno.
1. Na pasta Dados insira um Tag Interno chamado Motor.
2. Configure a propriedade Value do Tag Motor para ser um Boolean com valor inicial em
False.

Servidor de Dados

27

4.3 Anotaes

28

Servidor de Dados

CAPTULO

Telas e Quadros
Telas so janelas para monitoramento de processos, onde so inseridos objetos que faro a
interface do operador com o sistema. Cada aplicao pode ter um nmero ilimitado de Telas.
Quadros so objetos para a organizao e a estruturao da interface, criando visualizaes
compostas para o usurio dentro da janela principal do Viewer ou do seu navegador.

5.1 Tela
A Tela o objeto bsico de interface com o usurio. Nela podem-se inserir os seguintes
objetos:
Primitivas do editor grfico (retas, crculos, retngulos, polgonos, etc.)
Controles ActiveX fornecidos pela Elipse (E3Alarm, E3Chart, E3Browser)
Controles ActiveX fornecidos por terceiros
Imagens no vetoriais (Arquivos BMP, JPG, GIF, etc.)
Imagens vetoriais (Arquivos WMF, EMF, etc.)
Controles padro do Windows (Lista, Editor de Texto, Lista de Seleo, etc.)
Bibliotecas grficas do E3 (XControl) compostas de quaisquer objetos 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 positivo em x, a
coordenada x move-se para a direita. Quando se adiciona um valor positivo 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, ocupando somente o tamanho de suas coordenadas de altura e de
largura.

Telas e Quadros

29

Exemplo de Tela

5.2 Quadros
O Quadro o objeto que organiza e estrutura a interface, criando visualizaes compostas
para o usurio dentro da janela principal do Viewer ou do navegador.
No Quadro, podem-se criar Divisores para visualizar diferentes telas ao mesmo tempo. Cada
Divisor tambm pode mostrar uma URL, uma planilha do Excel, um documento do Word ou um
arquivo PDF.
A disposio dos Divisores dentro do Quadro pode ser horizontal ou vertical. Dentro de cada
divisor podem ser inseridos outros divisores. A cada par de novos Divisores criados pelas
opes Dividir Horizontalmente e Dividir Verticalmente, h sempre um Divisor Principal e um
Divisor Secundrio. Apenas o Divisor Principal ter valores que definem explicitamente o seu
posicionamento, ficando o Divisor Secundrio com o valor restante. Para utilizar esse recurso,
siga estes procedimentos:
1. Clique com o boto direito do mouse no nome do projeto em Viewers e Quadros e escolha a
opo Inserir Quadro.
2. Para criar um divisor, clique com o boto direito do mouse sobre o quadro aberto e
selecione o tipo de diviso (horizontal ou vertical).

30

Telas e Quadros

Selecionar o tipo de diviso


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

Divises

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 E3 Server. No
necessrio copiar o aplicativo para as mquinas onde os E3 Viewers sero executados, pois
as Telas e bitmaps so trazidos do servidor conforme a necessidade, em tempo de execuo.

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

Telas e Quadros

31

Na aba Visualizador da janela de Propriedades so definidas as configuraes de visualizao


do Viewer.

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

32

Telas e Quadros

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

Aba Erros de Comunicao


Telas e Quadros

33

NOTA: Tambm possvel inserir Tags no Viewer.

5.4 Exerccios
Esta seo contm exerccios sobre o contedo deste captulo.

5.4.1 Quadros
1. Clique com o boto direito do mouse sobre a pasta Viewer e Quadros e escolha a opo
Inserir Quadro em - TreinamentoE3.prj.
2. Na rea de visualizao do quadro, clique com o boto direito do mouse e selecione a
opo Dividir Horizontalmente, conforme a figura.

Dividir Horizontalmente
3. Posicione a barra que aparece a cerca de 10% da Tela, a partir de seu limite superior, 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.

34

Telas e Quadros

5.4.2 Telas
1. Clique com o boto direito do mouse sobre a pasta Telas e escolha a opo Inserir Tela em TreinamentoE3.prj.

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

Configurar o tamanho da Tela


3. Crie a TelaEventos para ser aberta no Divisor inferior.
4. Altere o nome da TelaInicial para TelaCaldeira.

Telas e Quadros

35

5. Clique com o boto direito do mouse na TelaCaldeira e escolha a opo Ajustar ao


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

5.4.3 Tela Inicial da Aplicao


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

Aba Visualizador
2. Execute a aplicao pressionando o boto

36

na Barra de Ferramentas.

Telas e Quadros

5.5 Anotaes

Telas e Quadros

37

CAPTULO

Objetos de Tela
Os Objetos de Tela so elementos grficos que podem ser inseridos nas Telas para criar a
interface visual com o processo. Podem ser criados a partir da barra de ferramentas Objetos
ou atravs do menu Objetos.
Uma vez selecionado o objeto que se deseja criar, mantenha o boto esquerdo do mouse
pressionado na rea da Tela, enquanto movimenta o mouse (um retngulo pontilhado mostra
o tamanho e a forma do objeto). Ao soltar o boto, o objeto ser posicionado 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 Microsoft Forms, que so
objetos ActiveX criados pela Microsoft. Eles podem ser inseridos nas Telas da aplicao para
realizar diversas tarefas. A seguir uma descrio dos objetos Microsoft Forms disponveis no
E3.
Controles Microsoft Forms
CONE

OBJETO

DESCRIO

Caixa de Seleo (Check Box)

Utilizado para dar ao usurio


uma escolha entre dois
valores, tais como Sim e No,
True e False ou On e Off.

Boto de Opes (Option


Button)

Utilizado para mostrar se um


item individual de um grupo
est selecionado.

Boto de Comando
(Command Button)

Utilizado para executar uma


ao especfica ao pressionlo.

Texto (Label)

Utilizado para exibir um texto


descritivo, como ttulos,
legendas, etc.

Lista (List Box)

Exibe uma lista de valores.

Barra de Rolagem (Scroll Bar) Retorna ou define o valor da


propriedade de outro objeto
38

Objetos de Tela

CONE

OBJETO

DESCRIO
de acordo com a posio da
caixa de rolagem.

Boto IncrementoDecremento (Spin Button)

Utilizado para incrementar e


decrementar um valor.

Editor de Texto (Text Box)

Utilizado para exibir


informaes digitadas pelo
usurio na Tela.

Boto Liga-Desliga (Toggle


Button)

Semelhante ao Boto de
Comando, porm necessita
um segundo comando do
usurio para voltar ao estado
normal.

Lista de Seleo (Combo Box) Combina os recursos de uma


Lista e de um Editor de Texto.
O usurio pode digitar um
novo valor ou selecionar um
valor existente.

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

6.2 Galeria
A Galeria uma biblioteca de smbolos vetoriais, divididos em categorias, que podem ser
arrastados para as Telas.
Depois de inserido, o objeto pode ser livremente editado e trabalhado de acordo com as
caractersticas descritas para os objetos de imagem (pode-se, por exemplo, mudar a cor de
preenchimento atravs das propriedades OverrideFillMode, OverrideFillColor e
OverrideLineColor, sem a necessidade de transformar o objeto em um objeto grfico do E3).
Alm da biblioteca de smbolos, a Galeria tambm mostra os XControls pertencentes s
bibliotecas do Domnio corrente.

Objetos de Tela

39

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

6.3 Exerccios
Esta seo contm exerccios sobre o contedo deste captulo.

6.3.1 Figuras
Todas as figuras utilizadas nesta aplicao sero salvas em uma pasta dentro do projeto
principal, para que no seja necessrio preocupar-se com os caminhos das figuras ao
executar a aplicao em outro computador.
1. Clique com o boto direito do mouse em Recursos e escolha Inserir Recurso em TreinamentoE3.prj.

40

Objetos de Tela

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

6.3.2 Tela Caldeira

Tela Caldeira
1. Configure a propriedade FillStyle para 12 - Picture, para habilitar uma figura de fundo.

Objetos de Tela

41

2. Para colocar a figura FundoCaldeira como fundo, arraste o bitmap de Recursos at a


propriedade PictureFile da Tela. Isto faz com que o E3 utilize o recurso inserido e no o
arquivo da imagem (que externo aplicao). Para escolher a melhor posio da figura,
pode-se alterar a propriedade PicturePosition.
3. A partir da biblioteca de objetos grficos (Galeria), arraste para a tela a primeira figura
(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 alterar a
propriedade OverrideFillMode para 2 - SolidFill. Escolha a cor que desejar na propriedade
OverrideFillColor.

Figura
3DISAMotor1
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 um
terceiro com a palavra "Vazo" sobre o tanque da direita.
8. Abaixo de cada texto, insira um objeto Display

Textos e Displays

42

Objetos de Tela

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 formato como


Hora, e no item Tipo, escolha 13:06:03. Essa formatao mostrar as horas, os minutos e os
segundos.
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.

Objetos de Tela

43

6.4 Exerccios Complementares


Esta seo contm exerccios complementares ao contedo deste captulo.

6.4.1 KB
KB-27542: Disponibilizando figuras na Galeria do E3.

44

Objetos de Tela

6.5 Anotaes

Objetos de Tela

45

CAPTULO

Associaes
Associaes (ou Conexes) so ligaes feitas entre propriedades e objetos ou entre outras
propriedades. As associaes trazem grande facilidade ao criar animaes e outros tipos de
lgicas comuns, minimizando a utilizao de scripts.
Atravs da aba Associaes da janela de Propriedades, tem-se acesso a todas as
propriedades disponveis do objeto a ser tratado e todos os tipos possveis de associao
para essas propriedades.

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

7.1 Tipos de Associaes


Esta seo contm a descrio dos tipos de associaes.

46

Assoc ia es

7.1.1 Conexo Simples


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

Conexo Simples

7.1.2 Conexo Bidirecional


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

Conexo Bidirecional

Assoc ia es

47

7.1.3 Conexo Digital


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

Conexo Digital

7.1.4 Conexo Analgica


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

Conexo Analgica
48

Assoc ia es

7.1.5 Conexo por Tabela


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

Conexo por Tabela

7.1.6 Conexo Reversa


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

Conexo Reversa

Assoc ia es

49

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 mais rpida do que
pela janela tradicional. O acesso a essa ferramenta pode ser feito clicando com o boto
direito do mouse sobre um ou mais objetos e selecionando a opo Editar Associaes.

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 uma entrada ou sada digital,
portanto seus valores so 0 ou 1. Ao usar o valor do tag para associaes com propriedades
do tipo Boolean, o E3 considerar:

TAG

VBSCRIPT

Falso

Verdadeiro

Ao utilizar o comando NOT, ficar:

50

Assoc ia es

TAG

NOT TAG

VBSCRIPT

-1

Verdadeiro

-2

Verdadeiro

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

TAG

CBOOL(TAG)

NOT CBOOL(TAG)

Falso

Verdadeiro

Verdadeiro

Falso

Uso do mtodo CBool


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

Uso da propriedade Bit00

7.3 Exerccios
Esta seo contm exerccios sobre o contedo deste captulo.

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 tag Demo
HoraAtual (Servidor - Dados). direita, selecione a propriedade Value e clique no boto
Colar. A informao vai do tag para o Display, logo a associao simples (Propriedade <Fonte).

Assoc ia es

51

Associao Simples
3. Na TelaCaldeira, associe os Displays de Presso, Vazo e Vapor a seus
respectivos 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 propriedade OverrideFillColor busque
o tag interno Motor (Servidor - Dados - Motor) e direita selecione a propriedade Value.
2. No tipo da conexo marque Conexo Digital. Escolha duas cores para simbolizar Ligado e
Desligado. Se desejar, habilite o pisca.

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

Propriedade ForegroundColor

52

Assoc ia es

7.3.3 Conexo por Tabela


1. No Display que exibe o valor do Vapor na TelaCaldeira, deseja-se indicar que o vapor
est fora da faixa permitida alterando a cor de fundo. Crie uma Associao por 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. O tag Nivel
pode variar de 0 a 1000, enquanto que o preenchimento do retngulo vai 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 animao com
translao.Uma sombra do objeto aparecer. Mova-a at onde desejar.

Animao com Translao


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

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

Assoc ia es

53

54

Assoc ia es

7.4 Anotaes

Assoc ia es

55

CAPTULO

Comunicao
O E3 permite a comunicao com equipamentos de aquisio de dados, controladores, CLPs
(Controladores Lgicos Programveis), UTRs (Unidades Terminais Remotas), ou qualquer
outro tipo de equipamento, atravs de Drivers de Comunicao ou Servidores OPC, de acordo
com o tipo do equipamento ou tipo de comunicao necessria. Os Drivers de Comunicao e
Servidores OPC funcionam nesse caso como servidores de variveis, ou seja, eles fornecem as
informaes do mundo externo para o E3 para que a superviso do processo se realize. As
variveis envolvidas no processo so conhecidas como Tags e podem ser de vrios tipos, de
acordo 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 um
determinado equipamento usando os drivers .dll fornecidos pela Elipse Software. Um manual
fornecido juntamente com cada Driver, contendo informaes importantes a respeito da
configurao dos seus parmetros [P] e outras propriedades. Os tipos de objetos de Driver
disponveis para comunicao so descritos na tabela a seguir.
Objetos disponveis no Driver de Comunicao
OBJETO
Pasta

Tag de Comunicao

Bloco de Comunicao

Elementos de Bloco

56

DESCRIO
Define grupos e subdiretrios para a
organizao de variveis. No tem relao
direta com o equipamento de campo.
Utilizado para definir a comunicao com
uma varivel (um endereo de memria) do
equipamento de aquisio.
Utilizado para definir a comunicao com
diversas variveis (vrios endereos de
memria em sequncia) do equipamento de
aquisio.
Representam cada um dos endereos de um
bloco e so utilizados como se fossem tags
de comunicao. Os Elementos de Bloco
podem apontar para cada ndice dentro de
um Bloco (correspondendo a cada varivel
de interesse).

Comunic a o

8.1.1 Exerccios
Os exerccios sobre comunicao sero feitos sob orientao do instrutor, j que cada local
onde o curso ministrado pode contar com diferentes equipamentos para ilustrar esse
captulo. Ainda assim, pode-se citar o procedimento para configurao dos tags de
comunicao utilizando um driver Elipse.
1. Clique com o boto direito do mouse sobre a pasta Drivers e OPC e escolha Inserir Driver de
Comunicao em - TreinamentoE3.prj.
2. Selecione o arquivo do Driver (.dll) na caixa de dilogo que se abre para a seleo de
arquivos.
3. Caso a caixa de dilogo no seja aberta automaticamente, escolha o arquivo de Driver na
propriedade DriverLocation.
4. Verifique se a propriedade DriverName foi preenchida.
5. Nos Drivers mais recentes, todas as configuraes de comunicao devem ser realizadas
nas janelas de configuraes extras do IOKit, que um componente compartilhado
utilizado pelos Drivers de Comunicao do E3.
6. Para os Drivers que utilizam o IOKit, a interface de configurao aberta atravs do boto
Configurar o Driver na barra de ferramentas do Driver.

Configurao do Driver
7. A seguinte janela ser aberta.

Configuraes Extras
Comunic a o

57

8. Na aba Setup, escolha na lista de opo da propriedade Physical Layer a interface fsica que
ser utilizada. As opes so Serial, Ethernet, Modem e RAS.
9. Configure o tempo que o Driver aguardar uma resposta do equipamento no campo
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, o Driver estar
configurado para acessar o meio fsico. Depois dessa etapa, deve-se configurar os Tags de
Comunicao.
11.Clique com o boto direito do mouse no Driver e acesse a opo Inserir - Tag de
Comunicao 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.

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 Ativar
Comunicao para testar as configuraes ou aperte o boto Ativar/Desativar comunicao
. Caso as configuraes estejam corretas, a linha do tag dever ficar 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.

58

Comunic a o

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 de equipamentos
externos atravs de um Servidor OPC, que pode ser desenvolvido por qualquer empresa com
conhecimentos da rede e do protocolo usados por um determinado equipamento. Os tags
OPC podem ser importados para o Driver OPC no E3 (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

Pasta OPC

Define grupos ou subdiretrios para a


organizao das variveis.

Grupo OPC

Agrupa uma srie de tags OPC que


compartilham os mesmos parmetros 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. A leitura do tag feita
automaticamente pelo Servidor OPC, com
tempo de varredura definido no grupo OPC
onde ele est inserido.

Bloco OPC

Possibilita a leitura ou escrita de um


conjunto de valores. Para fazer uma escrita,
deve-se apenas atribuir um novo valor
propriedade Value.

Elemento de Bloco OPC

Possibilita a leitura ou escrita de um dos


elementos do Bloco OPC onde ele est
inserido. O Bloco OPC l uma tabela de dados
e esse objeto estar sempre associado
posio definida por sua propriedade Index,
correspondendo a uma varivel de
interesse.

Comunic a o

59

8.2.1 Exerccios
O E3 funcionar como servidor OPC e tambm como cliente OPC. Assim como no exerccio
anterior, esse exerccio serve para mostrar como funciona a configurao do Driver OPC, j
que o procedimento semelhante para qualquer servidor OPC que esteja 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 Inserir Driver de
Comunicao OPC em - TreinamentoE3.prj.
2. Clique com o boto direito do mouse sobre o driver OPC inserido, selecione a opo
Propriedades e v at a aba OPC Driver.
3. Clique sobre o boto Selecionar. Ser aberta uma janela com as opes de OPC Server na
sua mquina local ou na rede. Selecione o Elipse OPC Server da mquina do instrutor na
opo Servidores na rede e pressione o boto OK.
4. Ao voltar janela de propriedades do Driver OPC, pressione o boto Ativar Comunicao. A
partir deste ponto, possvel verificar a comunicao com o servidor clicando sobre a
opo Informaes.
5. O prximo passo para a configurao a importao de tags. Feche a janela de
propriedades 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 do E3 ser
aberto.

60

Comunic a o

Assistente de Importao de Tags


6. A figura anterior mostra a aparncia da janela de importao. Do lado direito a lista de tags
do servidor e do lado esquerdo, a rea de importao para o E3. Para importar, primeiro
ajuste os filtros, selecione o item e arraste-o at o grupo OPC de destino.
7. Depois de importar alguns tags ou propriedades, verifique o funcionamento dos tags
importados.
8. Assim como no caso da configurao de Drivers Elipse, o roteiro para trabalhar com o
servidor OPC da Elipse o mesmo para qualquer servidor que seja utilizado.

8.3 Exerccios Complementares


Esta seo contm exerccios complementares ao contedo deste captulo.

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?

Comunic a o

61

8.4 Anotaes

62

Comunic a o

CAPTULO

Bibliotecas ElipseX
O E3 possui ferramentas que permitem transformar qualquer objeto ou conjunto de objetos
de sua aplicao em uma biblioteca do usurio. A ideia das Bibliotecas de Usurios
(chamadas de ElipseX) vem das linguagens de programao orientadas a objetos, onde
diversos componentes podem ser compartilhados entre projetos sem que seja necessrio
desenvolver novamente cada um dos objetos.
O uso de bibliotecas no E3 altamente recomendvel devido ao ganho de produtividade 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 de objetos
Bibliotec as ElipseX

63

9.1 Criao de Bibliotecas do Usurio


Os objetos ElipseX podem conter, alm de um desenho, variveis internas que podem ser
exportadas para a aplicao, alm de lgicas de programao (scripts) que vo estar
presentes em todas as cpias do objeto que est sendo criado, diminuindo a necessidade de
repetio de cdigo em diversas partes do aplicativo. Para criar uma nova 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, os objetos
grficos XControls e os objetos de dados XObjects.
Podem ser inseridos nos XControls todos os itens disponveis para as Telas, descritos nos
respectivos captulos. Entre esses itens esto as primitivas de desenho, objetos grficos
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, que so
64

Bibliotec as ElipseX

executados no E3 Server. Pode-se inserir em um XObject os seguintes objetos: Driver de


Comunicao, Servidor de Dados, Banco de Dados, Frmulas, Configurao de Alarmes,
Servidor de Alarmes, Objetos COM, outros XObjects, dentre outros.
Dentro de um mesmo arquivo .lib pode haver qualquer nmero de componentes ElipseX,
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 de quaisquer
objetos do E3, com o propsito de ser multiplicada facilmente por seu projeto. Pode-se criar
um XControl clicando com o boto direito do mouse sobre o arquivo .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 serem
exportadas pelo objeto. Elas podero ser associadas a um tag ou outra propriedade qualquer
quando o objeto estiver sendo usado em um projeto. Na aba Design, que equivale 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
so descritas a seguir.

; e excludas atravs do boto

. As opes disponveis

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

Bibliotec as ElipseX

65

OPO

DESCRIO
propriedade fora da biblioteca, isto,
determina se a propriedade ser ou no
pblica.

Valor Inicial

Determina o valor inicial da propriedade.

Texto de ajuda

Texto de declarao e documentao da


propriedade.

Note que outros objetos de Dados (XObjects) podem ser declarados como Tipos. Isso permite
que em uma nica propriedade seja controlado o funcionamento de todo um objeto,
tornando mais fcil a manuteno de uma biblioteca.
A edio do objeto grfico possui os mesmos recursos grficos e opes da edio de Telas.
Pode-se inserir os XControls em qualquer Tela, ou ainda dentro de outro XControl clicando
com o boto direito do mouse sobre a Tela ou XControl de destino e escolhendo a opo
Inserir.
A partir desse momento, o XControl ter um nome dentro da Tela, e ser entendido como uma
cpia da definio original. Assim, deve-se definir (se necessrio) os valores ou as
associaes que essa cpia especfica ter no contexto que est sendo utilizada.

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. Tal estrutura poder
realizar clculos, associaes, comunicaes, verificao de alarmes, registro histrico, etc.,
que independam de alguma interface grfica (Viewer) aberta ou em execuo naquele
momento. Para criar um XObject, clique com o boto direito 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 E3 que
sejam executados no servidor. Para saber a lista completa, basta pressionar o boto 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 de
gerenciamento, que poder ser facilmente replicado quantas vezes forem necessrias no
aplicativo.
Pode-se inserir os XObjects em qualquer Servidor de Dados clicando com o boto direito 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, ao tentar
inserir uma biblioteca o E3 Studio exibir para as Telas somente os XControls, e para os
66

Bibliotec as ElipseX

Servidores de Dados somente os XObjects.

9.2 Quando Criar um ElipseX


Existem alguns critrios para indicar a necessidade da construo de objetos no Elipse E3:
Repetio no uso: se um mesmo equipamento ou processo ser usado mais de uma vez no
mesmo projeto
Procedimentos de conhecimento do usurio: frequentemente, um processo criado por
determinada empresa deve ser protegido de cpia ou alterao. Isso comum no 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. A flexibilidade
disponvel para a construo e uso dos objetos no E3 permite que sejam utilizadas
posteriormente apenas as variveis de interesse, desprezando-se as demais

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

9.3 Exerccios
Vamos desenvolver um Display para exibir o valor de temperatura. O Display ser formatado
com uma casa decimal e sufixo "C". A cor de fundo do Display varia conforme o valor da
temperatura.

9.3.1 Biblioteca
1. Clique no boto Novo
e, no Assistente de Aplicaes, selecione a opo Biblioteca de
componentes do E3. Nomeie-a como LibCaldeira e especifique a pasta C:
\TreinamentoE3. Avance, adicione-a ao Domnio corrente e conclua o processo.

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".
Bibliotec as ElipseX

67

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 a propriedade
Temperatura criada na propriedade Value.

Associao com a propriedade Temperatura


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

Associao na propriedade ForegroundColor


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

Registrar bibliotecas carregadas

68

Bibliotec as ElipseX

9. Insira na tela trs XControl DisplayTemp.


10.Para cada DisplayTemp na tela, faa uma associao simples na propriedade
Temperatura com um Tag Temp.

Bibliotec as ElipseX

69

9.4 Anotaes

70

Bibliotec as ElipseX

CAPTULO

10
Scripts

Os Scripts so trechos de cdigo (programao) com os quais se podem criar procedimentos


associados a eventos especficos, permitindo grande flexibilidade no desenvolvimento e no
uso de aplicaes. Todos os scripts esto associados a eventos, 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 Propriedades definem
atributos de um objeto, como a aparncia de um controle de Tela ou o valor inicial de um
objeto quando se inicia o aplicativo.

NOTA: Estamos trabalhando at agora apenas com propriedades no E3. J conhecemos


algumas propriedades dos objetos do E3 e vimos que temos duas maneiras de alter-las, na
Janela de Propriedades ou por Associaes.

Os Mtodos so funes previamente definidas, que executam determinadas aes sobre as


propriedades do objeto que chama estas aes. Exemplos disso so funes para realizar a
escrita em tags (Write ou WriteEx), entre outras. Em linguagens de programao orientadas a
objeto, para agir sobre uma propriedade necessria a criao de mtodos. No E3, para cada
mtodo desejado, necessrio definir a qual evento ele estar associado, pois os scripts do
E3 so orientados a eventos.
Os Eventos so ocorrncias relacionadas a um objeto, que podem ser tratadas de modo 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 da linguagem
Visual Basic desenvolvida pela Microsoft. O VBScript possui um interpretador rpido, leve e
portvel, desenvolvido para o uso em navegadores para a Internet e outras aplicaes que
usam ActiveX Controls, Automation Servers e Java Applets. Os scripts so sempre associados
a eventos de um determinado objeto. Entretanto, para facilitar e aumentar a velocidade de
desenvolvimento, o E3 j incorpora algumas aes mais comuns que poderiam ser realizadas
com scripts atravs de assistentes (Wizards) chamados Picks. Pode-se definir que um
determinado evento executar um script, um Pick ou uma combinao deles, em uma
sequncia definida durante a criao do script (no E3 Studio).

Sc ripts

71

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 Servidor e
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 da criao 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 de eventos
ligados a variveis que esto no Servidor)

Tais limitaes so decorrentes do fato de que, por definio, existe uma independncia
entre o que cada uma das estaes Viewer est fazendo ou visualizando com relao ao
Servidor e vice-versa. Por isso todas as atividades, tanto no Servidor quanto no Viewer,
necessitam ser coordenadas de forma assncrona ou atravs de eventos para operarem de
forma harmoniosa.
Devido a essa independncia, ao se criar um script, primeiro deve-se obter uma referncia
correta dos objetos que se deseja manipular, ou seja, necessrio que o objeto seja
primeiramente encontrado nos vrios mdulos do E3.
Vale repetir que, ao se editar um script, o usurio dever utilizar o AppBrowser, que permite
copiar para o script o caminho de um mtodo ou propriedade de forma completa, 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 na Tela, o caminho
Viewer - Frame (se houver) - Tela - Boto.
Existem basicamente trs localizaes de origem de scripts, do ponto de vista da metodologia
para acesso aos objetos:
Servidor (E3 Server)
Telas e Quadros (E3 Viewer)
ElipseX (bibliotecas): podem ser XObjects (rodam no servidor) e XControls (rodam no
Viewer)

72

Sc ripts

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 em scripts,
poupando tempo de escrita de cdigo. Entre eles esto aes como troca de Tela ou
atribuies de valores, que so bastante comuns na criao de um projeto.

10.1.2.1 Executar Scripts


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

Pick Executar Scripts

Sc ripts

73

10.1.2.2 Abrir Tela


Abre uma Tela ou um Quadro determinado.

Pick Abrir Tela

74

Sc ripts

10.1.2.3 Abrir Tela Modal


Abre uma tela em estilo modal.

Pick Abrir Tela Modal

Sc ripts

75

10.1.2.4 Executar Aplicao


Executa um programa especfico.

Pick Executar Aplicao

76

Sc ripts

10.1.2.5 Carregar Valor


Carrega um valor em um Tag.

Pick Carregar Valor

Sc ripts

77

10.1.2.6 Inverter Valor


Permite mudar o valor de um Tag. Se o valor do Tag for igual a Valor1, ento o Tag recebe
Valor2. Se o valor do Tag for 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

78

Sc ripts

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 aes programadas.
Basicamente so dois tipos de eventos, Fsicos (ou externos) e Internos.
Eventos fsicos so, por exemplo, aes no teclado ou no mouse. Neste caso, a informao
relevante seria a tecla pressionada ou a posio do cursor e o status dos botes. Eventos
internos so, por exemplo, a mudana de uma temperatura de uma cmara de 10 para 11
graus Celsius.
No E3, h uma lista disponvel de eventos classificada por objetos, iniciando pelos eventos
padro, presentes em todos os objetos. Esses eventos so acessados atravs da aba Scripts,
que pode ser consultada atravs das propriedades do objeto para o qual se deseja fazer o
script.

Sc ripts

79

Eventos disponveis

10.2.1 Eventos Definidos pelo Usurio


Apesar de o E3 vir com uma extensa gama de eventos, muitas vezes o usurio necessita criar
um evento especfico para sua aplicao. Um exemplo para a utilizao de eventos definidos
pelo usurio a realizao de um clculo (ou tarefa mais complexa) em um objeto, quando o
evento gerador vem de um outro tag ou propriedade.
possvel a criao de eventos personalizados definidos pelo usurio atravs da opo Criar
novo evento na lista de eventos ou atravs do boto Criar evento do usurio

80

Sc ripts

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, na chamada de um mtodo
sempre deve constar a qual objeto est se referindo.
Muitos mtodos pr-definidos possuem parmetros, que podem (ou devem) ser passados na
chamada do mtodo. Para isso, o VBScript possui uma regra que deve ser seguida. Se o
mtodo for utilizado em uma atribuio, seus parmetros devem estar entre parnteses. Os
parnteses usados nas citaes de mtodos neste manual servem apenas como indicativo
para diferenci-los das propriedades. Nos scripts, deve-se seguir esta regra.

Sc ripts

81

Mtodos no AppBrowser

10.4 Propriedades
Todo objeto possui Propriedades, que guardam informaes a respeito de suas
caractersticas. 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 largura e a sua
altura, respectivamente, entre outras. Para acessar as propriedades, utilize as mesmas
especificaes anteriores, porm selecione a pasta Propriedades.

10.5 Exerccios
Esta seo contm exerccios sobre o contedo deste captulo.

10.5.1 Pick Abrir Tela


1. Na TelaMenu insira um Command Button no canto direito da tela. Na propriedade
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

82

Sc ripts

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


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 boto Colar.

Application.Exit

4. Execute a aplicao e teste as novas funcionalidades.

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 M o t o r (Servidor Dados Motor) no campo Nome do
Tag.
4. Nos campos Valor 1 e Valor 2, altere para Boolean. Marque um deles como True e o outro
como False.

Sc ripts

83

Valores 1 e 2 do Tag

84

Sc ripts

10.6 Anotaes

Sc ripts

85

CAPTULO

11

Segurana

O E3 possui um controle de acesso a Telas, Alarmes e Domnios em uma lista de usurios,


onde para cada nome atribudo uma senha e um login. Conforme a opo configurada, o
sistema permitir acesso aos usurios cadastrados ou acesso ilimitado s Telas do projeto.

11.1 Usurios
Atravs da opo Usurios possvel configurar as informaes referentes aos usurios que
tero ou no acesso ao sistema. Para utilizar este recurso, preciso acessar o menu Arquivo Usurios e clicar na aba Usurios.

Aba Usurios

86

Seguran a

IMPORTANTE: Aps configurar a segurana, somente os usurios listados tero acesso ao


sistema.

11.2 Grupos
A opo Grupos permite que sejam criados grupos com caractersticas que sero comuns para
todos os seus membros (usurios). Um grupo tambm pode pertencer a outros 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 o membro 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 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 em considerao a informao do
Seguran a

87

grupo. Tambm pode-se optar por sempre utilizar a informao definida pelo grupo. Se as
informaes dos grupos forem conflitantes, ser usada a seguinte ordem de preferncia,
Negar > Afirmar > Indiferente.

Aba Permisses

88

Seguran a

11.4 Proteo
O E3 possui uma ferramenta de proteo de projetos ou de bibliotecas. Atravs desse item,
possvel proteger o contedo do arquivo contra a edio, a visualizao ou a execuo no
autorizada. Para utilizar esse recurso, clique com o boto direito do mouse 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 no autorizadas.
Esse recurso utilizado para evitar que determinada biblioteca ou projeto seja alterado
acidentalmente, ou que sejam copiados procedimentos de conhecimento especfico do
desenvolvedor. O E3 fornece um controle sobre a edio desses arquivos, sejam eles
projetos ou bibliotecas
Proteo de Execuo: Esta opo utilizada para proteger um arquivo contra execuo
no autorizada. Para tanto, necessrio solicitar a gravao de uma senha no dispositivo
de proteo, que feita pela Elipse Software. Isso protege o desenvolvedor de cpias no
autorizadas do projeto, por exemplo
Seguran a

89

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 no pode ser acessado.
Para acessar o contedo do arquivo, clique no cone da direita e mude para Abrir com senha.
Aps informar a senha e o sistema liberar o acesso, o cone fica colorido
acessibilidade dos arquivos.

, indicando a

IMPORTANTE: As protees implementadas no podem ser desfeitas caso as senhas sejam


perdidas. Portanto, ao proteger determinado arquivo, mantenha as senhas armazenadas de
modo seguro. Isso garante que se conseguir usar o arquivo sempre que necessrio.

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

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 e
Operador.
3. Atravs da aba Usurio, crie trs usurios. Cuidado que maisculas e minsculas fazem
diferena.

90

Seguran a

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

11.5.2 Permisses
1. Na aba Permisses, selecione a opo Grupos. Bloqueie a TelaEventos para o grupo
Operador.
2. Nas permisses de usurios, d permisso para um dos usurios do grupo operador
acessar a TelaEventos.

11.5.3 Login
1. Na TelaMenu, insira um novo Command Button com o texto "Login". No evento Click, 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 na aplicao.
4. Associe a propriedade Value do Display do usurio com a propriedade User do Viewer.

Associao da propriedade User

Seguran a

91

11.6 Anotaes

92

Seguran a

CAPTULO

12

Banco de Dados

O Banco de Dados do E3 utilizado para armazenar as informaes do projeto referentes aos


Histricos, Frmulas e Alarmes. Possui suporte a MDB (Microsoft Access), Oracle e Microsoft
SQL Server. Para utilizar esse recurso, siga estes procedimentos:
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 ou no) no
campo Arquivo MDB.
3. Deixe em branco os campos Usurio e Senha. Estes campos so utilizados somente se 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 campo s
utilizado caso o banco de dados especificado possua senha do DB.
5. Clique no boto OK para finalizar as configuraes.

12.1 Exerccios
Esta seo contm exerccios sobre o contedo deste captulo.

Banc o de Dados

93

12.1.1 Banco de Dados


Este banco de dados ser utilizado para armazenar todos os dados de Alarmes e Histricos
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.

12.2 Exerccios Complementares


Esta seo contm exerccios complementares ao contedo deste captulo.

94

Banc o de Dados

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

Banc o de Dados

95

12.3 Anotaes

96

Banc o de Dados

CAPTULO

13

Alarmes

O mdulo de Alarmes do E3 consiste basicamente em duas unidades, cujo funcionamento


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 so criados e
suas fontes configuradas

13.1 Servidor de Alarmes


O objeto Servidor de Alarmes centraliza todos os alarmes do projeto. Nele podem ser
encontrados os totais de alarmes ativos da aplicao (reconhecidos ou no). Ele tambm o
responsvel por reportar os eventos de alarmes para todos os Viewers conectados, 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 armazenados no


Banco de Dados. Os alarmes podem ser visualizados em um E3Alarm ou um E3Browser,
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 inserir esse
objeto no projeto, clique com o boto direito do mouse sobre o Organizer e escolha a opo
Inserir - Configurao de Alarmes.

13.2.1 rea
O objeto rea permite agrupar um conjunto de Fontes de Alarmes, bem como outras reas de
Alarme. Isso facilita o gerenciamento, a operao e o monitoramento de um conjunto 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
Alarmes

97

Reconhecer um conjunto de Fontes de Alarmes


Verificar o total de alarmes ativos ou no reconhecidos de um conjunto de Fontes de
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 ao evento, sua
severidade, bem como a necessidade ou no de reconhecimento desse evento. Todas as
fontes de alarmes possuem as seguintes propriedades gerais.
Propriedades gerais das Fontes de Alarme
PROPRIEDADE

DESCRIO

Texto da Mensagem

o texto associado quela condio de


alarme, que aparecer no objeto de
visualizao (E3Alarm), Banco de Dados, etc.
Pode conter at 255 caracteres de texto.

Severidade

Indica a gravidade do alarme ocorrido,


podendo ser Baixa, Mdia ou Alta. A
severidade utilizada para filtragem e
ordenao de mensagens.

Pede Ack

Indica que o alarme deve ser reconhecido


pelo operador para ser retirado da lista de
alarmes no E3Alarm, ou ainda se
reconhecido automaticamente quando a
varivel deixa uma condio de alarme.

Mensagem de Retorno

Sempre que uma Fonte de Alarme sai da


condio de alarme, essa mensagem ser
exibida nos objetos de visualizao.

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

98

Alarmes

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

Alarme Analgico

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

Alarme Digital

Alarmes

99

13.2.2.3 Banda Morta


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

Alarme Banda Morta

13.2.2.4 Taxa de Variao


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

Alarme Taxa de Variao

100

Alarmes

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

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

Aba Geral do E3Alarm

Alarmes

101

13.4 Exerccios
Esta seo contm exerccios sobre o contedo deste captulo.

13.4.1 Servidor de Alarmes


Uma aplicao s pode ter um objeto desse tipo, e a sua presena obrigatria para que haja
verificao de alarmes. Ele o responsvel por reportar os eventos de alarmes para todos os
Viewers conectados, bem como, se desejado, enviar esses eventos para um Banco de Dados.
1. Insira um objeto Servidor de Alarmes no TreinamentoE3.

Inserir Servidor de Alarmes


2. Acesse as propriedades do Servidor de Alarmes, e na aba Configurao habilite a opo
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.

102

Alarmes

Selecionar campos da tabela


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

Sucesso na gerao da tabela

Alarmes

103

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 do tipo
Analgico.

Inserir Fonte de Alarme Analgica


104

Alarmes

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 Muito Baixa"
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 1 Muito Alta"
No item Volta ao normal, digite "Temperatura 1 normalizada"

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 expresso para
"Dados.Pressao.Value > 300".

Propriedade Value do Tag Pressao


Alarmes

105

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

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 como mostrado na
figura a seguir.

Propriedades do Alarme Vapor

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 como
mostrado na figura a seguir.

106

Alarmes

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.

Aba Geral do E3Alarm


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

Alarmes

107

Propriedade AlarmServer do E3Alarm


4. Acesse as propriedades do E3Alarm. Na aba Colunas, selecione os campos DataHora,
Operador, Mensagem, Reconhecido e Valor.
5. Na aba Cores, faa a configurao que desejar.

108

Alarmes

13.5 Anotaes

Alarmes

109

CAPTULO

14

Histricos

Os Histricos so os mdulos responsveis pelo armazenamento de dados da aplicao em


Banco de Dados. Permitem armazenar dados de processos para anlises futuras, no E3 ou em
qualquer outra ferramenta.
Podem-se criar tantos arquivos de Histrico quantos se desejar, cada um contendo diversos
tags ou expresses. Cada Histrico pode criar ou utilizar uma tabela independente dentro do
Banco de Dados, cujo armazenamento pode ser definido por Tempo ou por Evento. possvel
ainda determinar qual Banco de Dados inserido no projeto ser utilizado para o
armazenamento dos dados.
Para utilizar esse recurso, clique com o boto direito do mouse no item Objetos do servidor 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 podem ser
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 maneira nica 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 sendo a chave primria da
tabela, o prprio Banco de Dados garante que no sejam inseridos dados duplicados no(s)
campo(s) que seja(m) chave(s) primria(s).
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 Chave Primria
Composta pode ser formada pela combinao de dois ou mais campos da tabela. Podem
existir casos em que um nico campo no seja capaz de atuar como chave primria, pelo fato
de apresentar valores repetidos. Alm disso, uma tabela pode ter somente uma Chave
110

Histric os

Primria, seja ela simples ou composta. Ou seja, no se podem definir dois ou mais campos
de uma tabela para ser uma chave primria separada cada. No confundir com o caso de uma
chave primria composta, onde a unio 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 usar um
campo que numere os registros sequencialmente

A chave primria pode ser configurada de duas formas. Verificando na Tela do Histrico 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 ordenados pelo
Banco de Dados a fim de melhorar a performance das consultas que utilizam esse ndice. Eles
so utilizados para encontrar registros com um valor especfico em uma coluna rapidamente.
Sem um ndice, o Banco de Dados tem de iniciar com o primeiro registro e depois ler os
registros atravs de toda a tabela at que se encontre os registros relevantes. Quanto maior
a tabela, maior ser o custo em termos de tempo de processamento. Se a tabela possui um
ndice para as colunas em questo, o Banco de Dados pode rapidamente obter uma posio
para procurar no meio do arquivo de dados sem ter que varrer todos os registros. Os tipos de
ndices disponveis so Primrio, nico e Index.
Podem-se criar ndices em mltiplas colunas. Um ndice de mltiplas colunas pode ser
considerado um vetor ordenado contendo valores que so criados concatenando valores de
colunas indexadas. Os ndices podem ser configurados atravs do cone
de configurao, ilustrada a seguir.

Histric os

, que abre a tela

111

Editor de ndices

14.3 Exerccios
Esta seo contm exerccios sobre o contedo deste captulo.

112

Histric os

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 como HistCaldeira.

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

Campos do Histrico
3. Clique sobre a opo Propriedades do Histrico
seguintes propriedades.

e, na aba Histrico, configure as

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 foi criada
com sucesso.
Histric os

113

Sucesso na criao da tabela

114

Histric os

14.4 Anotaes

Histric os

115

CAPTULO

15

Consultas

O objeto Consulta (ou Query) auxilia no processo de definio de consultas no Banco de 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 para aquele objeto.
Para essa busca, toda vez que uma aplicao precisar gravar ou buscar dados 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 consultas SQL
usando uma interface grfica e o acompanhamento imediato do cdigo SQL sendo gerado. 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 o filtro 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 do projeto 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 uma Consulta em uma Pasta de
Dados ou na Tela e utilizar seus dados atravs de scripts.

15.1 Criando uma Consulta


1. A definio da Consulta comea quando o usurio informa o Servidor de Banco de Dados
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 tabelas que foram
encontradas, permitindo a sua seleo.

116

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, pode-se realizar uma prvia da Consulta.
7. Na aba SQL, pode-se visualizar e editar o cdigo SQL.

Consultas

117

Configurao da Consulta
A janela anterior pode ser acessada atravs de um clique com o boto direito do mouse sobre
o objeto, selecionando a opo Configurar.

15.2 E3Browser
O E3Browser um controle ActiveX (desenvolvido pela Elipse Software) utilizado para
visualizar dados armazenados em Banco de Dados, gerados pelo E3 ou outro software
qualquer. Pode-se configurar consultas utilizando filtros de vrios tipos nos dados, atribuir
cores para cada coluna, entre outras configuraes. Esse objeto utilizado para visualizar os
Histricos, Alarmes ou qualquer tabela existente no Banco de Dados.

E3Browser
118

Consultas

Para utilizar este recurso, insira o E3Browser no projeto atravs do clique com o boto direito
do mouse na Tela, e selecione a opo Inserir - E3Browser.

Inserir E3Browser
O E3Browser utiliza o objeto Consulta para auxiliar o usurio no processo de definio de
consultas no Banco de Dados da aplicao.

15.3 Exerccios
Vamos visualizar os dados de Alarmes armazenados no Banco de Dados em forma de tabela
utilizando o objeto E3Browser.

15.3.1 E3Browser
1. Insira um E3Browser

na TelaEventos.

2. Para configurar os dados que o E3Browser mostrar, d um duplo clique sobre o E3Browser
e v at a aba Consulta.
3. Selecione a Consulta1 e clique no boto Configurar.

Consultas

119

Propriedades do E3Browser
4. Selecione o Banco de Dados que contm a tabela que se deseja consultar.
5. Escolha a tabela Alarms.
6. Selecione todos os campos da tabela Alarms.

Tabela Alarms
7. Acesse a aba Visualizar e clique no boto Executar Consulta
consulta.

para verificar o resultado da

Executar Consulta
8. Clique no boto OK. Ao finalizar esse passo, estaro disponveis no E3Browser todos os
campos listados na consulta. Configure cada campo com a cor, formatao e tamanho que
desejar.
9. Na aba Opes do E3Browser, configure a atualizao para ser feita a cada cinco segundos.

120

Consultas

Aba Opes

Consultas

121

15.4 Anotaes

122

Consultas

CAPTULO

16

E3Chart

O objeto E3Chart um componente ActiveX criado especialmente para trabalhar em conjunto


com o E3. Com ele, possvel exibir grficos com tags variando em tempo real e tambm
mostrar dados histricos gravados em um Banco de Dados.
Cada sequncia de dados representada no E3Chart atravs de Penas. Para cada Pena so
associados dados que podem ser tags ou campos de consultas. possvel criar vrios eixos
com escalas diferentes para serem associados aos dados das Penas.

E3Chart
Para inserir esse objeto na Tela, clique com o boto direito do mouse e selecione a opo
Inserir - E3Chart.

16.1 Configuraes das Penas


O objeto Coleo de Penas representa o conjunto de Penas contidas no E3Chart. Cada Pena
configurada para exibir dados em tempo real ou dados histricos vindos da Consulta. Atravs
da aba Penas, possvel configurar o nmero e o tipo das Penas a serem criadas na Coleo
de Penas. Acessando essa aba e clicando no boto Adicionar, uma nova Pena criada no
E3Chart.

E3Chart

123

Aba Dados

16.1.1 Pena de Tempo Real


Para configurar uma Pena como de Tempo Real, selecione a opo Tempo Real na aba Dados
das propriedades da Pena, disponvel no item Tipo de pena. Logo aps, defina os tags nas
opes Link do eixo vertical e Link do eixo horizontal.

16.1.2 Pena Histrica


O objeto Consulta tambm usado para mostrar valores histricos no E3Chart. Atravs da
aba Consultas possvel adicionar, excluir ou configurar as Consultas. Para criar uma Pena
Histrica, necessrio que a Consulta esteja previamente criada. Para tanto, na aba Dados
das propriedades da Pena, selecione a opo Histrica, disponvel no item Tipo de pena e
defina a Consulta. Logo aps, defina os campos da Consulta nos itens Campo do eixo vertical e
Campo do eixo horizontal.

124

E3Chart

16.1.3 Tempo Real e Histrica (Mista)


Para configurar uma pena como de Tempo Real e Histrica na aba Dados das propriedades da
Pena, selecione na opo Tipo de pena o item Tempo Real & Histrica. Este tipo de Pena
utilizado quando se deseja ter os dados antigos e os valores atuais dos tags na mesma Pena.

16.2 Exerccios
Esta seo contm exerccios sobre o contedo deste captulo.

16.2.1 E3Chart
1. Posicione um E3Chart

no canto superior esquerdo da TelaCaldeira.

16.2.2 Penas
1. Na aba Penas, clique no boto Adicionar.
2. Com um duplo-clique sobre a Pena, acesse suas propriedades.
3. Troque o nome da Pena para Pressao.

Aba Geral da Pena Pressao


4. Na aba Dados, na opo Link do eixo vertical, selecione a propriedade Value do tag
Pressao (Servidor - Dados).

E3Chart

125

Aba Dados da Pena Pressao


5. Repita esses passos para incluir as Penas de Vazao e Vapor.

16.2.3 Escala
Os maiores valores so do tag Vazao que varia de 0 a 500, ento vamos alterar a escala
vertical para exibir os valores nessa faixa.
1. Na aba Eixos, selecione o Eixo Vertical e aperte o boto Configurar.
2. Na aba Escala, configure os limites de 0 a 500.

Aba Escala do tag Vazao

16.2.4 Legenda
1. Na aba Legenda, selecione a opo Mostrar legenda, tamanho 60, e adicione as colunas
que preferir.
2. Configure a coluna Valor do tag X para mostrar o valor no formato "HH:mm:ss".

16.2.5 E3Chart Histrico


1. Acesse as propriedades do E3Chart, aba Consultas.
2. Clique no boto Adicionar. Selecione o BancoDados no campo Nome do Servidor e a
seguir escolha a tabela Caldeira.
3. Selecione os campos E3TimeStamp, Presso, Vazo e Vapor.
126

E3Chart

4. Visualize o resultado da consulta na aba Visualizar e clique em OK.


5. Na aba Penas, selecione a pena Pressao e acesse suas propriedades com um duplo
clique do mouse.
6. Na aba Dados, modifique a opo Tipo de pena para Tempo Real & Histrica. A parte
histrica ser habilitada.
7. Na Parte Histrica, escolha:
Consulta local: Consulta1
Campo do eixo vertical: Pressao
Campo do eixo horizontal: E3TimeStamp
8. Repita o procedimento para as demais Penas.

16.3 Exerccios Complementares


Esta seo contm exerccios complementares ao contedo deste captulo.

16.3.1 KB
KB-18257: Como fazer um grfico com pontos digitais?

E3Chart

127

16.4 Anotaes

128

E3Chart

CAPTULO

17

Relatrios

O Relatrio um componente ActiveX chamado ActiveReport, que permite a visualizao e


impresso de valores instantneos de variveis do sistema e dados armazenados em Banco
de Dados (Alarmes, Histricos, Consultas e Frmulas).
Para utilizar o Relatrio, clique com o boto direito do mouse no item Visualizao - Relatrios
no modo Domnio e selecione a opo Inserir Relatrio em e o nome projeto desejado.
O Relatrio tambm utiliza o objeto Consulta. Este objeto permite que seja especificada a
origem dos dados do Banco de Dados que sero visualizados no Relatrio.
Um Relatrio contm vrias sees. Cada seo do Relatrio contm um grupo de controles
que so processados e impressos ao mesmo tempo, como uma unidade.

Relatrio
Um Relatrio estruturado da seguinte forma:

SEO

DESCRIO

Report Header

Esta seo impressa no incio do Relatrio.


Utilizada para imprimir ttulos de Relatrios,
tabelas de somas, grficos ou qualquer outra
informao que necessite aparecer somente
uma vez no incio do Relatrio.

Report Footer

Esta seo impressa no final do Relatrio.


Utilizada para imprimir uma soma de um
Relatrio, totais gerais ou qualquer outra

Relatrios

129

SEO

DESCRIO
informao que necessite ser impressa
somente uma vez no final do Relatrio.

Page Header

Esta seo impressa no topo de cada


pgina do Relatrio. a primeira seo
impressa na pgina, exceto quando essa
pgina contm a seo ReportHeader.
Utilizada para imprimir cabealhos de
colunas, nmeros de pginas, ttulos de
pginas ou qualquer outra informao que
necessite ser impressa no incio de cada
pgina.

Page Footer

Esta seo impressa uma vez na base de


cada pgina no Relatrio. Usada para
imprimir totais de pginas, nmeros de
pginas ou qualquer outra informao que
necessite ser impressa uma vez na base de
cada pgina.

Detail

Esta seo o corpo do Relatrio que


imprime uma vez para cada registro da fonte
de dados.

Group Header, Group Footer

Um Relatrio pode ter mltiplos grupos


aninhados. Cada grupo possui uma seo
Header e uma seo Footer. A seo Header
impressa antes de qualquer seo Detail
no grupo. A seo Footer impressa depois
da seo Detail do grupo.

A barra de ferramentas Relatrio contm trs itens de configurao que permitem editar,
visualizar o Relatrio e criar scripts. Estes itens so os seguintes:

Prvia de Impresso (Preview): Atravs desta opo, possvel visualizar uma prvia da
impresso do Relatrio. Assim possvel verificar configuraes de margem, figuras, etc.

Configuraes do Relatrio (Report Settings): Nestas configuraes, pode-se determinar


Configuraes de Pgina, Configuraes de Impresso, Configuraes da Grade e Estilo do
Relatrio

Editor de Scripts: Atravs desta opo, possvel editar scripts para o Relatrio. No
campo Object necessrio especificar o objeto onde se deseja criar o script e, no campo
Events o evento do Relatrio em que ocorrer a ao

130

Relatrios

17.1 Objetos do Relatrio


A ferramenta Relatrio possui vrios objetos especficos que podem ser utilizados, sendo
acessados atravs da barra de ferramentas Relatrio.

Barra de ferramentas Relatrio


Atravs da barra de ferramentas Relatrio, possvel acessar os recursos disponveis desta
opo:

Linha: Objeto bsico de reta que liga dois pontos quaisquer. Permite o desenho de
retas, atravs de dois pontos especificados na sua criao ou em polgonos

Retngulo: Este objeto permite o desenho de retngulos, utilizando toda a largura ou


altura do objeto. Criado a partir de dois vrtices

Retngulo Arredondado: Retngulo criado atravs de dois vrtices com a opo dos
cantos serem arredondados a partir de um fator de arredondamento. Ao ser inserido ou
editado, exibe um pequeno ponto prximo ao canto superior esquerdo do objeto, que
permite modificar o fator de arredondamento

Elipse: Este objeto permite o desenho de crculos e elipses, utilizando toda a largura ou
altura e definindo o centro do crculo no centro do retngulo

Figura: Este objeto permite mostrar imagens que estejam armazenadas em arquivos,
estejam elas dentro ou fora do arquivo do aplicativo

Texto: Possibilita a criao de um texto. Ao definir a rea na Tela, pode-se digitar


diretamente o texto desejado, que aceita tambm mltiplas linhas

Setpoint: Atravs do objeto Setpoint, possvel associar um campo da tabela no Banco


de Dados. Este campo especificado na propriedade DataField

Cdigo de Barras: Permite gerar uma figura que converte uma sequncia de nmeros e
caracteres em um cdigo de barras. Este cdigo uma representao numrica ou
alfanumrica, utilizada para facilitar diferentes processos. Esse cdigo decifrado atravs
de scanners, canetas e equipamentos de leitura ptica

Quebra de Pgina: um ponto em que uma pgina termina e outra comea no


Relatrio. Por exemplo, pode-se forar uma quebra de pgina para assegurar que o ttulo
de um captulo comece sempre em uma nova pgina

Tabela: um objeto composto por linhas e colunas ondes so inseridos textos ou


grficos. As tabelas nos Relatrios so usadas para organizar e apresentar informaes.
Pode-se tambm usar tabelas para criar layouts de pgina

Relatrios

131

E3Chart: Este objeto utilizado para visualizar os dados do Relatrio em formato


grfico. Maiores informaes esto descritas no captulo sobre o E3Chart

/
Enviar para frente / Enviar para trs: Atravs destes botes, possvel enviar um
objeto para frente ou para trs de outro. Ao escolher as opes Enviar para frente ou Enviar
para trs, o objeto selecionado ser colocado na primeira ou na ltima posio na ordem
de sobreposies

Carregar Arquivo RPX: Importa a configurao do Relatrio de um arquivo externo

Salvar Arquivo RPX: Exporta a configurao do Relatrio para um arquivo externo

NOTA: A opo Impressora do cone do E3 na Barra de Tarefas exibe a lista das impressoras
encontradas local ou remotamente, e permite que o usurio escolha uma para ser usada
pelo E3 Server.

17.2 Exerccios
Esta seo contm exerccios sobre o contedo deste captulo.

17.2.1 Relatrio

Objeto Relatrio
1. Insira um novo Relatrio

132

no TreinamentoE3 chamado RelatorioAlarmes.

Relatrios

Inserir Relatrio
2. Configure a Consulta do Relatrio para buscar os campos da tabela de alarmes. Para
facilitar, renomeie os campos na coluna Ttulo.

Consulta do Relatrio
3. Adicione dois objetos Texto
na seo PageHeader. Na propriedade Caption do primeiro
Texto, digite "Elipse Software Ltda - Treinamento E3 Studio", e na propriedade Caption do
segundo Texto, digite "Relatrio de Alarmes".
4. Para cada campo escolhido na consulta, insira novos objetos Texto na seo PageHeader e
configure-os com o nome dos campos. Estes sero os ttulos das colunas.
5. Na seo Detail, insira um Campo de Dados
para cada campo, alinhando-o com o seu
respectivo texto. Nas propriedades DataField e Text, digite exatamente o ttulo da coluna
configurada na Consulta.
6. Para visualizar o Relatrio, pressione o boto Gerar Relatrio

do Relatrio.

17.2.2 Numerao de Pgina


O uso dos campos de dados do Relatrio do E3 bastante flexvel, sendo configurado no
prprio Setpoint que a funo dever executar. Por exemplo, para criar na seo PageFooter a
indicao "Pgina 1 de 12", siga estes procedimentos.
1. Insira dois Textos, "Pgina" e "de".
Relatrios

133

2. Entre os Textos, insira um Setpoint e configure-o para mostrar o nmero da pgina atual.
SummaryType: 4 - ddSMPageCount
SummaryRunning: 2 - ddSRAll
3. Aps o texto "de", insira um Setpoint e configure-o para mostrar o nmero total de pginas.
SummaryType: 4 - ddSMPageCount
SummaryRunning: 0 - None

17.2.3 Visualizar Relatrio


Para visualizar o Relatrio em tempo de execuo, siga estes procedimentos:
1. Insira um Boto de Comando com o texto "Relatrio" no canto inferior da TelaEventos.
2. No evento Click, crie um pick Imprimir Relatrio

3. No campo Imprimir Relatrio, selecione RelatorioAlarmes.


4. Na opo Sada, escolha o item Tela.

Imprimir Relatrio

134

Relatrios

17.3 Anotaes

Relatrios

135

CAPTULO

18

Exerccios de Reviso

Esta seo contem exerccios de reviso de todo o contedo do tutorial.

18.1 Exerccio
Uma mineradora deseja monitorar os nveis de alguns tanques. O equipamento ainda no
est decidido, mas deve trazer a informao de quatro nveis.
O gerente do setor gostaria de visualizar os dados de forma amigvel ao usurio, por isso
pediu que fosse desenvolvido um supervisrio com os seguintes requisitos:
Simular os valores dos quatro nveis do equipamento em falta (valores de 0 a 100)
A Tela principal deve ter uma imagem da minerao

Imagem da minerao
Sobre cada tanque visualizar o nvel atravs de uma barra

136

Exerc c ios de Reviso

Nvel do tanque
Exibir o valor do nvel na tela formatada com sua unidade de engenharia igual a "%", uma
casa decimal e obedecendo a tabela de cores a seguir

MNIMO

MXIMO

COR

90

100

Vermelho

70

90

Amarelo

30

70

Branco

10

30

Azul

10

Verde

Sinalizar na tela os alarmes de todos os nveis conforme a tabela a seguir

ALARME

LIMITE

HiHi

90

Hi

70

Lo

30

LoLo

10

Na tela principal deve ser possvel identificar o usurio logado


Um usurio pertencente ao grupo Manuteno NO pode reconhecer alarmes

Exerc c ios de Reviso

137

Em uma segunda tela, deve ser possvel visualizar os quatro nveis em um grfico onde
possvel escolher atravs de botes qual a informao exibir simultaneamente

Grfico de nveis
Armazenar os dados de nvel a cada 2 segundos em um banco de dados
Visualizar os dados armazenados no banco de dados em forma de tabela na mesma tela do
grfico
Um relatrio com os dados de nvel armazenados no banco de dados deve ser exportado
para PDF

138

Exerc c ios de Reviso

18.2 Resoluo
Simular os valores dos quatro nveis do equipamento em falta (valores de 0 a 100)
1. Para simular valores, criar tags do tipo Demo, com os limites mximo e mnimo
conforme especficado.

A Tela principal deve ter uma imagem da minerao


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 nvel atravs de uma barra


1. Inserir um Retngulo na tela sobre o tanque.
2. Acessar as propriedades do Retngulo, aba Associao.
3. Criar uma Associao na propriedade VerticalPercentFill com o tag Nivel
correspondente.

Exibir o valor do Nivel na Tela formatada com sua unidade de engenharia igual a "%", uma
casa decimal e obedecendo a tabela de cores
1. Como sero diversos Displays iguais, a melhor opo criar um XControl.
2. Crie um arquivo de biblioteca e insira-o no Domnio.
3. Insira um XControl e chame-o de DisplayNivel.

Exerc c ios de Reviso

139

4. Crie uma propriedade chamada Nivel do tipo Double.

5. Desenhe um Display.
6. Formate o Display com a expresso '0.0 "%"'.
7. Crie uma Associao Simples com a propriedade Nivel criada na propriedade Value do
Display.

8. Crie uma Associao por Tabela na propriedade ForegroundColor informando os


limites e as cores desejadas. Na propriedade Fonte, busque a propriedade Nivel
criada anteriormente.

9. Salve e registre-a.
10.Insira na tela um XControl chamado DisplayNivel.
11.Faa uma Associao Simples na propriedade Nivel com o tag desejado.

Sinalizar na tela os alarmes de todos os nveis conforme a tabela


1. Se no existir no Domnio, insira no projeto um Servidor de Alarmes.
2. Se no existir, insira no projeto uma Configurao de Alarmes.
140

Exerc c ios de Reviso

3. Na Configurao de Alarmes, insira uma rea de Alarme.


4. Na rea de Alarme, insira um Alarme Analgico.

5. Acesse as propriedades da Fonte de Alarme, aba Analgico. Informe os limites e


mensagens de alarmes conforme a tabela.

6. Na coluna Fonte, busque o tag que deseja monitorar o alarme.


7. Insira quantos alarmes forem necessrios e configure-os seguindo os passos
anteriores.

Na tela principal deve ser possvel identificar o usurio logado


1. Criar um Display na Tela.
2. Criar uma associao na propriedade Value do Display com a propriedade User do
Viewer.
3. Insira um boto ao lado do Display.

Exerc c ios de Reviso

141

4. No boto, crie o script a seguir.


Application.Login(True)

5. Acessar o menu Arquivo - Usurios e criar pelo menos um usurio.

Um usurio pertencente ao grupo Manuteno NO pode reconhecer alarmes


1. Acessar o menu Arquivo - Usurios.
2. Criar o grupo Manuteno.
3. Inserir um usurio no grupo Manuteno.
4. Na aba Permisses, bloquear o reconhecimento de alarmes para o grupo Manuteno.

Em uma segunda tela, deve ser possvel visualizar os quatro nveis em um grfico onde
possvel escolher atravs de botes qual a informao exibir simultaneamente
1. Criar uma nova Tela.
142

Exerc c ios de Reviso

2. Inserir um E3Chart na Tela.


3. Acessar as propriedades do grfico, aba Penas.
4. Inserir uma Pena.
5. Escolher um Nome e uma Cor.
6. Na aba Dados, manter a pena como Tempo Real e buscar o tag no campo Link do eixo
vertical.
7. Repetir os passos anteriores para incluir as demais Penas.

8. Na tela principal, criar um boto para chamar a tela do grfico.


Armazenar os dados de nvel a cada 2 segundos em um banco de dados
1. Se no existir, insira um objeto Banco de Dados e configure-o.
2. Inisra um objeto Histrico no projeto.
3. Crie campos para cada informao que deseja armazenar e associe-o ao tag desejado
na coluna Fonte.

4. Acesse as propriedades do Histrico e configure o nome do Banco de Dados, nome da


tabela (TabelaNivel) e tempo de gravao (2000 ms).

Exerc c ios de Reviso

143

Visualizar os dados armazenados no banco de dados em forma de tabela na mesma tela do


grfico
1. Insira na Tela um objeto E3Browser.
2. Acesse suas propriedades, aba Consulta e clique no boto Configurar.

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


4. Escolha os campos que deseja buscar e na aba Visualizar, aperte o boto
verificar os dados.

para

Um relatrio com os dados de nivel armazenados no banco de dados deve ser exportado
para PDF
1. Inserir um Relatrio no projeto, chamado de RelatorioNivel.
2. Configurar a Consulta do Relatrio para buscar no Banco de Dados a tabela desejada.

3. Escolher os campos de Nivel e E3TimeStamp.

144

Exerc c ios de Reviso

4. Inserir na seo Detail um objeto Campo de Dados para cada coluna escolhida na
Consulta. Preencher a propriedade DataField com o nome da coluna.

5. Utilizar o objeto Label para escrever o ttulo das colunas (propriedade Caption).
6. Inserir na tela um boto com o seguinte script:
Set Report = Application.LoadReport("[RelatorioCaldeira]")
Report.Export "PDF", "RelatorioNivel.pdf"

Exerc c ios de Reviso

145

18.3 Anotaes

146

Exerc c ios de Reviso

Matriz

Filial MG

Rua 24 de Outubro, 353 - 10 andar

Rua Antnio de Albuquerque, 156

90510-002 Porto Alegre RS

7 andar Sala 705

Fone: (51) 3346-4699

30112-010 Belo Horizonte - MG

Fax: (51) 3222-6226

Fone: (31) 2511-2121

E-mail: elipse@elipse.com.br

E-mail: elipse-mg@elipse.com.br

Filial SP

Filial PR

Rua dos Pinheiros, 870 - Conj. 141/142

Av. Sete de Setembro, 4698/1705

05422-001 So Paulo - SP

80240-000 Curitiba - PR

Fone: (11) 3061-2828

Fone: (41) 3342-0120

Fax: (11) 3061-2828

Fax: (41) 3342-0120

E-mail: elipse-sp@elipse.com.br

E-mail: elipse-pr@elipse.com.br

Filial RJ

USA

Praia de Botafogo, 300/525

40190 Jarvis Gray Lane

22250-044 Rio de Janeiro - RJ

Avon - NC - USA 27915

Fone: (21) 2158-1015

Fone: +1 (252) 995-6885

Fax: (21) 2158-1099

Fax: +1 (252) 995-5686

E-mail: elipse-rj@elipse.com.br

E-mail: info@elipse-software.com

Alemanha

Taiwan

D-67714 Waldfischbach Deutschland

26F.-10, No.3, Zihciang 3rd Rd., Lingya District

Fone: +49 (0) 6333-4439

802 Kaohsiung City Taiwan

Fax: +49 (0) 6333-2790045

Fone: +886 (7) 566-6587

E-mail: elipse@elipse.de

Fax: +886 (7) 566-6582


E-mail: evan@elipse.com.br

Consulte nosso website para informaes


sobre o representante do seu estado.

w w w .elipse.c om.br
elipse@elipse.c om.br

Você também pode gostar