E3tutorial Developer PTB PDF

Tutorial do E3 para
Desenvolvedores
2013 Elipse Software Ltda. Todos os direitos reservados.

04/02/2013 - Verso 4.0
Sumrio
1 Apresentao
1.1 A Elipse
1.2 Mdulos do E3
1.3 O Treinamento
2 Elipse Knowledgebase
7
12
2.1 Elipse Knowledgebase
12
2.2 Busca no Knowledgebase
13
2.3 Categorias
13
2.4 Anotaes
15
3 Iniciando a Aplicao
16
3.1 Criando a Aplicao
17
3.2 Execuo de um Domnio
19
3.3 Exerccios
19
3.4 Exerccios Complementares
21
3.5 Anotaes
22
4 Servidor de Dados
23
4.1 Regras para Nomes de Tags
24
4.2 Exerccios
24
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
45
6.5 Anotaes
46
7 Associaes
47
7.1 Tipos de Associao
47
7.2 Valores Booleanos
51
7.3 Exerccios
52
7.4 Anotaes
58
8 Comunicao
59
8.1 Driver de Comunicao
59
8.2 Driver de Comunicao OPC
64
68
8.4 Anotaes
69
9 Scripts
70
9.1 Definindo Scripts
70
9.2 Eventos
75
9.3 Mtodos
76
9.4 Propriedades
77
9.5 Exerccios
77
79
9.7 Anotaes
80
10 Segurana
81
10.1 Usurios
81
10.2 Grupos
82
10.3 Permisses
82
10.4 Proteo
84
10.5 Exerccios
85
87
10.7 Anotaes
90
11 Bibliotecas ElipseX
91
11.1 Criao de Bibliotecas do Usurio
92
11.2 Quando Criar um ElipseX
95
11.3 Exerccios
95
103
11.5 Anotaes
105
12 Banco de Dados
106
12.1 Exerccios
106
110
12.3 Anotaes
111
13 Alarmes
112
13.1 Servidor de Alarmes
112
13.2 Configurao de Alarmes
112
13.3 E3Alarm
116
13.4 Exerccios
117
122
13.6 Anotaes
124
14 Consultas
125
14.1 Criando uma Consulta
125
14.2 E3Browser
127
14.3 Exerccios
128
133
14.5 Anotaes
134
15 Histricos
135
15.1 Chave Primria
135
15.2 ndices
136
15.3 Exerccios
137
138
15.5 Anotaes
139
16 E3Chart
140
16.1 Configuraes das Penas
140
16.2 Exerccios
142
146
16.4 Anotaes
147
17 Relatrios
148
17.1 Objetos do Relatrio
150
17.2 Exerccios
151
17.3 Anotaes
157
18 Frmulas
158
18.1 Exerccios
158
160
18.3 Anotaes
163
19 Storage
164
19.1 Funcionamento
164
19.2 Configurao
165
19.3 Consultas Internas
166
19.4 Exerccios
168
170
19.6 Anotaes
171
20 E3Playback
172
20.1 Interface de Usurio do E3Playback
172
20.2 Restries e Comentrios
174
20.3 Licenciamento
175
20.4 Exerccios
176
177
20.6 Anotaes
178
21 Hot-Standby
179
21.1 Configuraes do Hot-Standby
179
21.2 Exerccios
182
185
21.4 Anotaes
186
22 Domnios Remotos
187
22.1 Configurao no Studio
187
22.2 Compartilhamento da Pasta do Domnio Servidor
187
22.3 Licenas
192
22.4 Sintaxe dos Links
193
22.5 Alias Local
193
22.6 Permisses de Acesso
194
22.7 Exerccios
194
198
22.9 Anotaes
200
23 Exerccios de Reviso
201
23.1 Exerccio
201
23.2 Resoluo
204
23.3 Anotaes
211
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 Elipse E3. Essa aplicao 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 com 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
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 Elipse E3!
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 o aprendizado da ferramenta.
O sistema em questo apresenta um sintico de uma fbrica de tintas, exemplificando vrios
aspectos e recursos disponveis no Elipse E3.
O operador do sistema pode visualizar as temperaturas e o nvel dos tanques, a cor da tinta a
ser produzida e controlar o funcionamento das bombas.
Apresenta o
Tela principal da aplicao

Para garantir a execuo da aplicao, implementaremos o conceito de Hot-Standby. Assim,
se o servidor principal falhar, um servidor de backup entra em ao imediatamente, sem
perda da continuidade do processo.
Menu da aplicao
O sistema tambm mostrar condies de alarme no caso de algum parmetro ultrapassar os
limites estabelecidos (como por exemplo, um aumento excessivo de temperatura).
Alarmes
Existir um procedimento de consulta dos alarmes, que permite visualizao e impresso dos
dados de histricos.
Apresenta o
Tela de consulta de Alarmes

Alm de criar grficos de tendncia das variveis com a opo de imprimir e exportar o grfico
histrico.
Grfico de Tendncia
Finalmente, acessaremos informaes de outro servidor E3 atravs de Domnios Remotos.
10
Apresenta o
Domnio Remoto
Apresenta o
11
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
12
Elipse Know ledgebase
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 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.
2.3 Categorias
Existe a possibilidade de o 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
13
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
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
2.4 Anotaes
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 a 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 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.
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 e configuraes de
segurana (usurios e permisses). Sem esse arquivo, um projeto no pode ser executado no
E3. Esse item ser visto mais adiante.
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.
18
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 mais 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 ou parar o E3 Viewer: Executa o Viewer ou para a sua execuo
3.3 Exerccios
19
3.3.1 Domnio
1. Inicie o E3 Studio selecionando a opo Criar um Domnio novo. O Assistente de Aplicaes
ser aberto.
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.
5. Escolha a resoluo da tela.
20
Resoluo do Viewer
6. Responda No s perguntas sobre comunicao, banco de dados e alarmes.
7. Ao fim destes procedimentos, voc ter acesso rea de trabalho do Studio.
3.4.1 KB
KB-28984: Tempo de execuo utilizando apenas licena de Studio.
21
3.5 Anotaes
22
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 os seguintes:
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.
Servidor de Dados
23
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
4.2.1 Horrio do Sistema

Para obter o horrio corrente do sistema necessrio criar um Tag Demo que acesse essa
informao.
1. Na pasta Dados do TreinamentoE3 insira um Tag Demo com o nome HoraAtual.
Configure a propriedade Type do Tag Demo para 3 - CurrentTime.
24
Servidor de Dados
Inserir Tag Demo
4.2.2 Simulao de Valores

Muitas vezes precisamos de 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:
DOCSTRING MINIMUM
MAXIMUM
Nivel1
NAME
Nivel do
Tanque1
100
2000
200
0 - Random
Nivel2
Nivel do
Tanque2
100
2000
200
0 - Random
Temp1
Temperatu 20
ra do
Tanque1
80
20000
500
1 - Sine
Servidor de Dados
PERIOD
SCAN
TYPE
25
NAME
Temp2
DOCSTRING MINIMUM
MAXIMUM
Temperatu 20
ra do
Tanque2
80
PERIOD
10000
SCAN
500
TYPE
0 - Random
4.2.3 Tanques
A aplicao representa uma fbrica que utiliza como matria-prima as tintas vermelha, verde
e azul, produzindo as demais tintas como uma combinao dessas trs.
1. Na pasta Dados crie uma Pasta de Dados chamada Tanque1 e insira trs Tags Internos,
Vermelho, Verde e Azul.
2. Configure o valor inicial dos trs Tags para Integer.
Selecionar tipo de dado

3. Crie uma cpia da pasta Tanque1 para criar o Tanque2.
26
Servidor de Dados
Pastas de Dados
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, pode-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.
Propriedades do Viewer
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
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 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 10% na propriedade SplitValue.
5. Chame a Diviso criada de Area_Superior. Para trocar o nome de um objeto, existem
trs opes:
Selecione o objeto no Organizer e pressione a tecla F2. Ser habilitada a edio do
nome
Selecione o objeto no Organizer e, na Lista de Propriedades do objeto, altere a
propriedade Name
Clique com o boto direito sobre o objeto no Organizer e selecione a opo Renomear
6. Divida horizontalmente o Quadro inferior a cerca de 10% da Tela, a partir do limite inferior.
Chame as Divises de Area_Central e Area_Inferior, respectivamente.
Divises do Quadro
34
Telas e Quadros
7. Configure o Divisor Area_Inferior como Principal. Isso faz com que o E3 obedea ao
tamanho do Divisor e o restante da Tela ser o tamanho do Divisor Area_Central.
Clique com o boto direito do mouse em Area_Inferior e escolha a opo Configurar
como Divisor Principal.
Configurar Divisor Principal

8. Configure o tamanho do Divisor Area_Inferior como 10% (propriedade SplitValue).
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 Area_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".
Telas e Quadros
35
Tamanho da Tela
3. Crie a TelaAlarmes para ser aberta no Divisor Area_Inferior. Marque a opo
Configurar como Tela inicial do Divisor.
4. Crie a TelaSinotico, para ser aberta no Divisor Area_Central. Marque a opo
Configurar como Tela Inicial do Divisor.
36
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 Microsoft Forms 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 temos a descrio dos objetos Microsoft Forms.
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
de acordo com a posio da
38
Objetos de Tela
CONE
OBJETO
DESCRIO
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
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 a opo Inserir Recurso em TreinamentoE3.prj.
40
Objetos de Tela
Inserir Recurso
2. Escolha todas as figuras da pasta C:\TreinamentoE3\Figuras.
Objetos de Tela
41
6.3.2 Tela Inicial

A Tela Inicial ter o seguinte aspecto:
Tela Inicial
1. Configure a propriedade FillStyle para 12 - bkPicture, para habilitar uma figura de fundo.
2. Para colocar a figura FundoTelaInicial 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. Crie um objeto Texto
com a palavra "Entrar", e outro com a palavra "Sair".
DICA: Para editar um texto j existente na tela, clique com o boto direito do mouse em cima
do objeto e selecione Editar Texto.
4. No centro da tela, posicione o texto "Treinamento E3 Studio".
DICA: Utilize os botes
42
Centralizar Horizontalmente e
Centralizar Verticalmente.
Objetos de Tela
5. Logo abaixo do texto "Treinamento E3 Studio", insira um segundo texto com a mensagem
"Elipse Software Ltda".
6.3.3 TelaMenu
TelaMenu
1. Na TelaMenu, coloque como figura de fundo FundoTelaMenu.
2. Insira um objeto Command Button e na propriedade Caption digite "Inicial".
3. Repita o procedimento para criar um boto para cada tela da aplicao: Eventos, Grafico,
Sinotico, Comunicao, Remoto e Playback.
4. No canto direito da tela, insira um Display
para exibir o nome do usurio logado.
5. Ao lado do Display insira um boto com o texto "Login".

6. Insira um Display no canto da tela para exibir o horrio atual.
7. 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.
8. Para visualizar a configurao feita no exerccio anterior, acesse a propriedade Value do
Display e escolha a opo Date.
Formato de Hora
6.3.4 TelaAlarmes
Esta tela exibir os alarmes ativos da aplicao.
1. Configure a Tela com o fundo que desejar. Utilize o boto Estilo de preenchimento.
Objetos de Tela
43
6.3.5 TelaSinotico
TelaSinotico
1. Na TelaSinotico, coloque como figura de fundo a imagem FundoTelaSinotico.
6.3.6 Setpoint
1. Sobre os tanques de cores, insira Setpoints
componente de cor.
onde ser digitada a quantidade de cada
Habilite os limites do Setpoint, alterando a propriedade EnableLimits para True.

Configure a propriedade MaxLimit para 255 e MinLimit para 0.
Configurando limites
6.3.7 Galeria
Sobre a esteira insira, a partir da biblioteca de objetos grficos (Galeria), a figura
5GallonBucket, que est na pasta Tanks.
44
Objetos de Tela
6.3.8 Retngulo
1. Sobre os tanques direita, desenhe um objeto Retngulo e configure as seguintes
propriedades:
BackgroundStyle: 1 - opaque
BackgroundColor: Preto (RGB(0, 0, 0))
VerticalPercentFill: 20
6.3.9 Display
1. Ao lado de cada tanque insira um Display
2. Configure o valor inicial para exibir um Double.

3. Formate o Display como porcentagem e com uma casa decimal.
6.4.1 KB
KB-36216: Inserindo objetos na Galeria do E3.
Objetos de Tela
45
6.5 Anotaes
46
Objetos de Tela
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.
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 Associao

Esta seo contm informaes sobre os tipos de Associaes.
Assoc ia es
47
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
48
Assoc ia es
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 de destino. Atravs de quatro valores especificados, feita uma escala linear entre
os valores da propriedade e os valores da fonte.
Conexo Analgica
Assoc ia es
49
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
50
Assoc ia es
7.1.7 Edio de Associaes

O E3 possui uma ferramenta para edio das 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, 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:
Assoc ia es
51
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
Mtodo CBool
Outra opo seria trabalhar com a propriedade Bit00 do Tag, que j uma propriedade do
tipo Boolean, em vez de trabalhar com a propriedade Value do Tag.
Propriedade Bit00
7.3 Exerccios
7.3.1 Conexo Simples

Esta seo contm exerccios sobre o tpico Conexo Simples.
7.3.1.1 Horrio do Sistema

1. Na TelaMenu, acesse as propriedades do Display que vai exibir o horrio do sistema, 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
52
Assoc ia es
Colar. A informao vai do Tag para o Display, logo a Associao Simples (Propriedade <Fonte).
Associao Simples
7.3.1.2 Usurio Logado

1. No Display que vai exibir o nome do usurio, associe a propriedade Value do Display com a
propriedade User do Viewer.
Conexo com a propriedade User do Viewer
7.3.1.3 Nvel do Tanque

1. Para simular o movimento do lquido no tanque na TelaSinotico, crie uma Associao
da propriedade VerticalPercentFill do corte do tanque com a propriedade Value do Tag
Nivel1.
Associao com a propriedade VerticalPercentFill

2. Repita o procedimento do item 1 para o Tag Nivel2.
7.3.1.4 Cor de Preenchimento

1. Para poder modificar a cor do lquido, crie a Associao da figura a seguir.
Associao na propriedade ForegroundColor

2. Busque no AppBrowser o mtodo RGB do VBScript.
3. Substitua as palavras "Red", "Green" e "Blue" pelos Tags Vermelho, Verde e Azul,
respectivamente.
DICA: Trabalhe com Copiar (CTRL + C) e Colar (CTRL + V). Para editar uma Associao criada
anteriormente, tecle F2.
4. Repita os procedimentos de 1 a 3 para o segundo tanque.
Assoc ia es
53
7.3.2 Conexo Bidirecional

1. Para cada Setpoint na TelaSinotico, crie uma Associao Bidirecional com o seu Tag
respectivo, Vermelho, Verde e Azul.
Associao Bidirecional
7.3.3 Conexo Analgica

1. O valor do Tag Nivel varia de 0 a 100, enquanto a formatao do tipo Porcentagem exibe
valores de 0 a 1. Para aplicar uma escala ao valor, insira uma Conexo Analgica no Display
que exibe numericamente a varivel Nivel.
Conexo Analgica
7.3.4 Conexo por Tabela

O Display que exibe o nvel deve alterar a cor de fundo conforme a tabela a seguir.
MNIMO
MXIMO
COR
10
Verde
10
30
Azul
30
70
Branco
70
90
Amarelo
90
100
Vermelho
1. Na propriedade ForegroundColor do Display, insira uma Associao por Tabela com o Tag
Nivel1.
54
Assoc ia es
Associao por Tabela
7.3.5 Copiar Associao

Para copiar a Associao para o Display Nivel2, siga estes passos:
1. No Display j configurado com a Associao por Tabela, clique com o boto direito do
mouse e escolha a opo Copiar Associaes.
Opo Copiar Associaes

2. No Display que deseja formatar, clique com o boto direito do mouse e escolha a opo
Colar Associaes.
3. Se j existir alguma Associao nesse objeto, ser aberta uma caixa de mensagem para
escolher se deseja ignorar ou sobrescrever.
Ignorar ou sobrescrever Associao

4. Altere a referncia do Tag Nivel1 para o Nivel2.
Assoc ia es
55
7.3.6 Animao
1. Selecione o objeto Galo e aperte o boto
para inserir uma Animao com Translao.
Uma sombra do objeto aparecer. Mova-a at onde desejar.
Animao com Translao

O incio do movimento representa a posio 0, e o final a posio 100. Para que o movimento
acontea, precisamos de uma varivel que varie de 0 a 100, linearmente. Como usaremos
essa varivel apenas para animar um objeto de Tela, criaremos um Tag Demo (simulao) no
objeto Viewer.
2. Clique com o boto direito do mouse no Viewer e insira um Tag Demo com o nome de
Anima.
Inserir Tag Demo

3. Configure o Tag Anima com os seguintes valores:
Mnimo: 0
Mximo: 100
Period: 5000
Scan: 100
4. Clique com o boto direito do mouse na Animao e acesse suas propriedades. Crie uma
Associao na propriedade Value com o Tag Anima.
Associao na propriedade Value
56
Assoc ia es
5. Altere as propriedades Enabled e EnabledSlider da Animao para False.
Assoc ia es
57
7.4 Anotaes
58
Assoc ia es
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 necessrios. 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 os seguintes:
Objetos disponveis no Driver de Comunicao
OBJETO
Pasta
Tag de Comunicao
Bloco de Comunicao
Elemento de Bloco
Comunic a o
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).
59
8.1.1 Exerccios
8.1.1.1 Driver
1. Clique com o boto direito do mouse sobre a pasta Drivers e OPC e escolha a opo 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.
Configurar Driver
7. A seguinte janela ser aberta.
60
Comunic a o
Janela de configurao do Driver

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.
8.1.1.2 Tag Browser

1. Caso a caixa de dilogo do Tag Browser no abra automaticamente, acesse-a pelo boto
.
2. Na janela Tag Browser, arraste para a esquerda o Bloco de Comunicao IO.
IOKitEvent da pasta General.
Comunic a o
61
Tag Browser
3. Feche a janela quando terminar de selecionar as variveis que desejar.
8.1.1.3 Tags de Comunicao

1. 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

2. Escolha a quantidade de Tags a serem inseridos e seu nome.
62
Comunic a o
Quantidade de Tags
3. Configure as propriedades de N1/B1 a N4/B4 conforme o manual do Driver.
4. 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.
Ativar Comunicao
5. Crie os outros Tags e Blocos e configure suas propriedades de N1/B1 a N4/B4.
6. Ajuste o tempo de varredura para cada Tag conforme a necessidade.
7. Na TelaComunicacao, crie um Setpoint para cada Tag criado e associe-o ao seu
respectivo Tag.
TelaComunicacao
Comunic a o
63
8.1.1.4 TelaComunicacao
1. Insira no projeto uma nova Tela, chamada TelaComunicacao, para ser aberta no
Divisor Area_Central. Marque a opo Tela inicial do divisor.
2. Na TelaComunicacao, crie um Setpoint para cada Tag criado, e associe-o ao seu
respectivo Tag.
TelaComunicacao
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
64
DESCRIO
Pasta OPC
Definem 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
Comunic a o
OBJETO
DESCRIO
para se 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.
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 a opo 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. Clique sobre o boto Selecionar.
Selecionar servidor
3. 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.
Comunic a o
65
Servidores OPC na rede

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

6. O prximo passo para a configurao a importao de Tags. Selecione a opo Importar
Tags.
Importar tags
7. O Assistente de Importao de Tags do E3 ser aberto. Clique no boto Buscar.
66
Comunic a o
Buscar tags
8. 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,
selecione o item e arraste-o at o Grupo OPC de destino.
Grupos OPC
9. Depois de importar alguns Tags ou propriedades, verifique o funcionamento dos Tags
importados.
Comunic a o
67
Tags importados
10.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.1 KB
KB-14918: Contagem de Tags no Driver de Comunicao.
68
Comunic a o
8.4 Anotaes
Comunic a o
69
CAPTULO
Scripts
Os Scripts so trechos de cdigo (programao) com os quais se pode 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).
9.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).
70
Sc ripts
9.1.1 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
atribuio de valores, que so bastante comuns na criao de um projeto.
9.1.1.1 Executar Scripts

Permite a edio de um script personalizado que ser executado na ocorrncia do evento
determinado.
Pick Executar Script
Sc ripts
71
9.1.1.2 Abrir Tela

Abre uma Tela ou um Quadro determinado.
Pick Abrir Tela
9.1.1.3 Abrir Tela Modal

Abre uma Tela em estilo modal.
Pick Abrir Tela Modal
72
Sc ripts
9.1.1.4 Executar Aplicao

Executa um programa especfico.
Pick Executar Aplicao
9.1.1.5 Carregar Valor

Carrega um valor em um Tag.
Pick Carregar Valor
Sc ripts
73
9.1.1.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
9.1.1.7 Imprimir Relatrio

Permite imprimir um Relatrio na Tela ou na impressora.
Pick Imprimir Relatrio
74
Sc ripts
9.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.
Lista de eventos
9.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 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
Sc ripts
75
Criar evento do usurio
9.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.
76
Sc ripts
AppBrowser
9.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.
9.5 Exerccios
9.5.1 Pick Abrir Tela

Vamos implementar a navegao entre as Telas da aplicao. A TelaInicial deve chamar
o Quadro1 e cada boto na TelaMenu deve abrir sua respectiva Tela no Quadro
Area_Central ou em tela cheia.
1. Na TelaInicial, selecione o texto "Entrar" e altere para a aba Scripts.
2. No evento Click, crie um novo script do tipo Abrir tela.
Pick Abrir Tela

Sc ripts
77
3. No campo Abrir a Tela, selecione o Quadro1.

4. Deixe a opo No Quadro em branco.
5. Na TelaMenu, crie um boto para cada Tela, e crie um script para abrir sua respectiva
Tela. A Tela TelaInicial deve abrir no Quadro _top, e as demais no Quadro
Area_Central.
9.5.2 Pick Script

Na TelaInicial podemos fechar a aplicao ao clicar no texto "Sair".
1. Na TelaInicial, crie um novo Pick do tipo Script no texto "Sair".
Pick Script
2. Com o auxlio do AppBrowser
, procure o mtodo Exit do Viewer e aperte o boto Colar.
Application.Exit
3. Execute a aplicao e teste as novas funcionalidades.
78
Sc ripts
9.6.1 KB
KB-25172: Teclas de atalho no E3.
Sc ripts
79
9.7 Anotaes
80
Sc ripts
CAPTULO
10
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.
10.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
Seguran a
81
IMPORTANTE: Aps configurar a segurana, somente os usurios listados tero acesso ao

sistema.
10.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
10.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 ao qual pertence. Dessa forma, ele no vai levar em considerao a informao do
82
Seguran a
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
Seguran a
83
10.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 arquivo
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.
84
Seguran a
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.
10.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.
10.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 Administradores e
Operadores.
3. Atravs da aba Usurio, crie trs usurios. Cuidado que maisculas e minsculas fazem
diferena.
Seguran a
85
Dados do usurio
4. Configure um usurio para pertencer ao grupo Administradores e dois para pertencerem ao
grupo Operadores.
10.5.2 Permisses
1. Na aba Permisses, selecione a opo Grupos. Bloqueie uma Tela para o grupo Operador.
2. Nas permisses de usurios, d permisso para um dos usurios do grupo Operador
acessar a Tela bloqueada para o grupo.
10.5.3 Login
1. Na TelaMenu, boto Login, crie um novo Pick do tipo Script no evento Click.
2. Busque no AppBrowser o mtodo Login do Viewer e aperte o boto Colar.
86
Seguran a
10.6.1 Administrao de Usurios

Desejamos criar, apagar e editar usurios em tempo de execuo. Somente usurios
configurados como administradores ("Este usurio um administrador") tm acesso a esse
recurso.
1. Insira um boto na TelaMenu com o texto "Usurios".
2. No boto crie o seguinte script no evento Click.
'Administrao de usurios
Application.UserAdministration()
3. Com o auxlio do AppBrowser, busque o mtodo UserAdministration do Viewer.
10.6.2 Permisso por Grupo de Usurios para Objetos de Tela

Algumas vezes desejamos que o operador acesse a Tela mas no visualize ou habilite alguns
objetos. Para programarmos essa funcionalidade, primeiro precisamos saber se o usurio
pertence ou no ao grupo com restrio. Essa informao varia conforme o usurio logado,
lembrando que podemos ter mais de uma estao de visualizao e consequentemente mais
de um usurio logado.
1. Clique com o boto direito do mouse no Viewer e insira um Tag Interno com o nome de
TagAdmin.
TagAdmin
2. No evento OnLogin do Viewer, insira o seguinte script.
'Verificar se o usurio pertence ao grupo Administrador
Item("TagAdmin").Value = IsUserMemberOfGroup("Administrador")
3. Na TelaInicial, crie uma Associao na propriedade Visible do texto Entrar com o Tag
TagAdmin. Somente usurios do grupo Administrador podero visualizar esse objeto.
Seguran a
87
10.6.3 Registro de Eventos

1. Clique com o boto direito do mouse no cone do E3 na rea de Notificao do Windows e
acesse a opo Domnio - Opes.
Domnio - Opes
2. Na aba Segurana, configure as opes conforme a figura a seguir.
Aba Segurana
NOTA: Configuraes de segurana no sero aplicadas aos usurios j existentes, apenas

na alterao ou na criao de um usurio.
88
Seguran a
3. Acesse a aba Registro de Eventos e configure para registrar os eventos na tabela Eventos
em um banco de dados selecionado automaticamente.
Aba Registro de Eventos
NOTA: necessrio ter um banco de dados configurado na aplicao.
10.6.4 KB
KB-32881: Abrindo a janela de administrao de usurio em tempo de execuo.
Seguran a
89
10.7 Anotaes
90
Seguran a
CAPTULO
11
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 cdigo
Minimizao de testes durante o desenvolvimento
Criao de interfaces 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
91
11.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.
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. 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
92
XControls.
J as bibliotecas de dados podem conter quaisquer tipos de objetos no grficos, que so
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 existir qualquer nmero de componentes ElipseX,
sejam eles XControls ou XObjects. Pode-se ter tambm vrias bibliotecas diferentes (vrios
arquivos .lib) dentro do mesmo Domnio.
11.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.
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:
, 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
93
OPO
DESCRIO
propriedade.
Public
Habilita ou desabilita a visibilidade da

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 Tipo. 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.
11.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 Servidores de Dados somente os
XObjects.
94
11.2 Quando Criar um ElipseX

Existem alguns critrios para indicar a necessidade da construo de objetos no 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 Elipse 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
novos arquivos.
11.3 Exerccios
Vamos desenvolver um Display para exibir o valor da temperatura. O Display ser formatado
com uma casa decimal e sufixo "C". A cor de fundo do Display varia conforme o valor da
temperatura.
11.3.1 Biblioteca
1. Clique no boto Novo Projeto
e, no Assistente de Aplicaes, selecione a opo
Biblioteca de componentes do E3. Nomeie-a como BibliotecaTreinamento e
especifique a pasta C:\TreinamentoE3. Clique em Avanar, adicione-a ao Domnio corrente
e conclua o processo.
11.3.2 XControl
1. Insira um XControl e chame-o de DisplayTemp.
DisplayTemp
2. Na aba Design, desenhe um Display.
3. Formate o Display com a expresso "0,0 C".
95
Formato do
Display
4. Para poder receber externamente qualquer valor, precisamos criar propriedades. Altere da
aba Design para a aba Propriedades, na parte inferior da Tela.
Aba Propriedades
5. Crie uma propriedade chamada Temperatura, do tipo Double.
Propriedade Temperatura
6. Retorne aba Design. No Display, crie uma Associao Simples entre a propriedade
Temperatura e a propriedade Value.
Associao Simples
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 por Tabela

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.
96
Registrar bibliotecas carregadas

9. Insira na Tela dois XControls DisplayTemp, um ao lado de cada tanque.
DisplayTemp
10.Para cada DisplayTemp na Tela, crie uma Associao Simples entre a propriedade
Temperatura e um Tag Temp.
11.3.3 TagBomba
1. Na biblioteca LibTreinamento, insira um novo XObject e nomeie-o TagBomba.
2. Crie trs propriedades do tipo Boolean: OnOff, Automatico e Defeito.
Propriedades de TagBomba
3. Salve a biblioteca e registre-a.
97
11.3.4 Servidor de Dados

1. Crie, dentro de Dados, uma Pasta de Dados com o nome Bombas.
2. Na pasta Bombas, crie seis XObjects TagBomba: B01 a B06.
Objetos
TagBomba
11.3.5 Bomba
Bomba
1. Insira um novo XControl e nomeie-o Bomba.
2. Insira o objeto 3DISABlower, da categoria Blowers da Biblioteca de Smbolos. Modifique as
seguintes propriedades:
OverrideFillMode para 3 - ByBrightness
OverrideFillColor para verde (0, 255, 0)
3. Insira a figura Defeito

4. Insira um Display
e Automtico
, que esto no projeto como Recursos.
sob a vlvula, para exibir o nome "Bomba".
5. Crie uma propriedade chamada Fonte, do tipo TagBomba (XObject criado anteriormente).
98
Tipo TagBomba
6. Para facilitar posteriormente, escreva no campo Texto de ajuda a mensagem "Objeto
TagBomba associado. Propriedades: OnOff, Automatico, Defeito".
7. Para que a figura

s aparea quando a vlvula estiver com defeito, crie uma
Associao Simples entre a propriedade Visible do objeto e a propriedade Defeito:
Com o auxlio do AppBrowser, localize a propriedade Fonte
No campo inferior, insira aps a propriedade Fonte a propriedade do objeto
TagBomba desejada, nesse caso, Defeito
AppBrowser
8. Repita o procedimento anterior entre o objeto Automatico

e a propriedade
99
Automatico.
9. No Display abaixo da vlvula, deve aparecer o nome do XObject TagBomba associado. Crie
uma Associao entre a propriedade Value do Display e Bomba.Fonte.Name.
10.Quando a propriedade OnOff estiver em True, a cor da bomba dever ser verde, e quando a
propriedade estiver em False a cor dever ser vermelha.
Na aba Associaes, crie uma Associao Digital entre a propriedade OverrideFillColor
e a propriedade OnOff
Associao Digital
11.Salve a biblioteca e registre-a.
11.3.6 TelaSinotico
1. Na TelaSinotico, insira um objeto Bomba sobre cada bomba do desenho de fundo.
2. Associe a propriedade Fonte dos objetos Bomba da TelaSinotico aos XObjects Bomba
criados no exercicio anterior.
Propriedade Fonte
DICA: Pode-se arrastar o objeto que se deseja associar at a propriedade desejada.
Arrastando um objeto para uma propriedade

100
11.3.7 ComandoBomba
Comando
Criaremos um XControl, que ser utilizado para alterar as propriedades OnOff, Automatico e
Defeito do XObject TagBomba. Haver uma nica Tela com este objeto, que far a
configurao de todas as bombas do aplicativo.
1. Insira um novo XControl na biblioteca LibTreinamento e nomeie-o ComandoBomba.
2. Crie uma propriedade chamada Fonte, do tipo TagBomba.
3. Crie uma Caixa de Seleo
e, na sua propriedade Caption, digite o texto "Defeito".
4. Crie uma Associao Bidirecional entre as propriedades Value da Caixa de Seleo e

Defeito da Fonte.
5. Copie o objeto Caixa de Seleo duas vezes. Altere a propriedade Caption dos objetos para
"Automtico" e "OnOff", respectivamente, e associe-os s propriedades correspondentes.
6. Insira um texto sobre os objetos, onde aparea o nome do XObject DadosValvula
associado.
Criando uma Associao para a propriedade Value

7. Salve a biblioteca e registre-a.
11.3.8 TelaComando
Insira no projeto uma nova Tela, chamada TelaComando, com o tamanho de 200 x 200
pixels.
1. Na TelaComando, insira um objeto ComandoBomba.
2. No evento OnPreShow da TelaComando, insira o seguinte script:
Item("ComandoBomba1").Fonte = Arg
3. Busque, com o auxlio do AppBrowser, o XControl ComandoBomba1 que est dentro da

101
TelaComando, e direita selecione a propriedade Fonte.

4. Digite " = Arg".
11.3.9 Tela Indexada

Ao clicar sobre uma bomba, dever ser aberta a sua tela de comando. Como temos uma nica
tela de comando e vrias bombas, ao abrir a tela devemos informar o nome da bomba que
gostaramos de enviar os comandos.
1. No XControl Bomba, crie um script no evento Click da figura que simboliza a bomba:
'Nome completo da bomba
Arg = Bomba.Fonte.PathName
'Abrir TelaComando
Application.DoModal "TelaComando", "Comando", 0, 0, , , Arg, 1+2+64+2048
2. Digite "Arg = " para criar uma varivel auxiliar de script, que guardar o nome da bomba na
qual clicamos.
3. Busque, com o auxlio do AppBrowser, o XControl Bomba e direita a propriedade Fonte.
Aperte o boto Colar.
4. Termine a linha digitando ".PathName". Esta propriedade retorna o nome completo do
XObject TagBomba que estiver associado.
Arg = Bomba.Fonte.PathName
5. Busque, com o auxlio do AppBrowser, o mtodo DoModal do Viewer e aperte o boto Colar.
Application.DoModal(Screen, Title, Left, Top, Width, Height, Arg, Flags)
6. Altere o parmetro Screen para o nome da Tela que se deseja abrir, TelaComando.
7. Altere o parametro Title para "Comando". Este ser o ttulo, desde que a propriedade
Caption da Tela esteja em branco.
8. Altere os parmetros Left e Top para 0. Foraremos a Tela a abrir no centro em outro
parmetro.
9. Altere os parmetros Width e Height para um espao, assim ser usado o tamanho original
da Tela.
10.Arg a informao que ser passada para a Tela que se abrir. Esse parmetro j foi
definido como o nome completo da bomba.
11.Altere o parmetro Flags para 1+2+64+2048, que significa barra de ttulo (1), boto de
fechar (2), mvel (64) e centralizada (2048).
102
11.4.1 Associao Mltipla

Muitas vezes desejamos alterar a fonte de informao de uma Associao, dependendo de
uma ou mais variveis. Como exemplo, podemos relacionar a cor final do tanque, levando em
conta se a bomba est ligada ou no.
Existem oito combinaes possveis para trs bombas. Para transformarmos os valores
booleanos em decimal, use a seguinte expresso:
4 * Bomba1 + 2 * Bomba2 + Bomba3
Como no VBScript Verdadeiro equivale numericamente a -1, nossa expresso deve ser:
-4 * Bomba1 - 2 * Bomba2 - Bomba3
A cor final deve ser:
VERMELHO
VERDE
AZUL
STATUS
DESCRIO
RGB(0, 0, 0)
RGB(0, 0, Azul)
RGB(0, Verde, 0)
RGB(0, Verde,
Azul)
RGB(Vermelho,
0, 0)
RGB(Vermelho,
0, Azul)
RGB(Vermelho,
Verde, 0)
RGB(Vermelho,
Verde, Azul)
Para aplicarmos essa lgica, podemos utilizar uma Associao Mltipla.
103
1. No retngulo do tanque, altere a Associao da propriedade ForegroundColor, conforme a

tabela anterior.
Propriedade ForegroundColor
11.4.2 KB
KB-28547: Utilizando biblioteca desenvolvida em outro projeto.
104
11.5 Anotaes
105
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
Este banco de dados ser utilizado para armazenar todos os dados de Alarmes e Histricos
dos projetos.
12.1.1 SQL Server Management Studio

1. Acesse o SQL Server Management Studio atravs do menu Iniciar - Programas - Microsoft SQL
Server 2008.
SQL Server Management Studio

2. Para conectar-se ao banco de dados, necessrio informar o nome do servidor, usurio e
senha.
106
Banc o de Dados
Conectar ao Banco de Dados

3. No campo Server name, clique na Caixa de Seleo e selecione o servidor na lista.
Lista de servidores disponveis

4. No campo Authentication, selecione a opo SQL Server Authentication. No campo Login
digite "sa" e em Password informe a senha criada para o usurio sa durante a instalao.
5. Clique em Connect. Se todas as informaes estiverem corretas, o Studio se conectar ao
servidor de banco de dados.
Conectado ao Servidor de Banco de Dados
Banc o de Dados
107
12.1.1.1 Criao de Banco de Dados

1. Clique com o boto direito do mouse no item Databases e escolha a opo New Database.
Adicionar Novo Banco de Dados

2. No campo Database name digite "TreinamentoE3". Clique no boto OK.
Campo Database Name

3. Verifique se o banco de dados criado aparece na lista de Databases.
Banco de Dados TreinamentoE3
108
Banc o de Dados
12.1.2 Banco de Dados

1. Insira um novo Banco de Dados no projeto TreinamentoE3 com o nome de
BancoDados.
Inserir Banco de Dados

2. Escolha o tipo 2 - stSqlServer.
3. Configure os parmetros de conexo.
Banc o de Dados
109
Configurao do Banco de Dados

4. Teste a conexo com o banco de dados.
12.2.1 KB
KB-29527: Bancos de dados suportados pelo E3.
110
Banc o de Dados
12.3 Anotaes
Banc o de Dados
111
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 em 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, escolha a opo
Inserir Configurao de Alarmes em, e em seguida o nome do projeto desejado.
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
112
Alarmes
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 Alarme possuem as seguintes propriedades gerais:
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 de Alarme.
Alarmes
113
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).
Fonte de 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).
Fonte de Alarme Digital
114
Alarmes
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).
Fonte de Alarme Banda Morta
13.2.2.4 Taxa de Variao

Permite monitorar variaes muito rpidas em uma varivel do processo. A Fonte de Alarme
Taxa de Variao usa seus valores especificados em unidades da varivel por segundo.
Fonte de Alarme Taxa de Variao
Alarmes
115
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 Inserir - E3Alarm.
E3Alarm
Na aba Geral das propriedades do E3Alarm so especificadas as informaes referentes ao
Servidor de Alarmes e ao filtro.
Aba Geral
116
Alarmes
13.4 Exerccios
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. Para o correto funcionamento
com o E3PlayBack, insira os campos:
Alarmes
117
EventTimeDbl
FullAlarmSourceName
ConditionActive
Acked
AckRequired
6. Por ltimo, clique no boto Gerar Tabela. Ser exibida uma mensagem de sucesso.
Gerar estrutura da tabela
13.4.2 Configurao de Alarmes

1. Insira no projeto um objeto Configurao de Alarmes.
Inserir Configurao de Alarmes
118
Alarmes
13.4.3 Alarme Analgico

1. Crie dentro da Configurao de Alarmes uma nova rea de Alarmes pressionando o boto
Adicionar e modifique o seu nome para Nivel.
Adicionar rea
de Alarme
2. Selecione a rea criada e clique no boto Adicionar. Insira uma Fonte de Alarme do tipo
Analgico.
Adicionar Alarme Analgico

3. Renomeie o Alarme Analgico para Tanque1.
4. Clique sobre a rea de edio da Fonte de Alarme Tanque1 e, atravs do AppBrowser,
selecione a propriedade Value do Tag Nivel1 da pasta Dados.
5. Acesse as propriedades do Alarme do Tanque1, aba Analgico.
Marque o item LoLo, com limite igual a 10 e mensagem "Nvel 1 Muito Baixo"
Marque o item Lo, com limite igual a 30 e mensagem "Nvel 1 Baixo"
Marque o item Hi, com limite igual a 70 e mensagem "Nvel 1 Alto"
Marque o item HiHi, com limite igual a 90 e mensagem "Nvel 1 Muito Alto"
No item Volta ao normal, digite "Nvel 1 normalizado"
6. Copie o Alarme Tanque1 para criar o Alarme Tanque2.

7. Associe o Alarme Tanque2 ao Tag Nivel2 e altere as mensagens do Alarme.
Alarmes
119
Associao dos Alarmes com os Tags
13.4.4 Alarme Banda Morta

1. Insira uma nova rea com o nome de Temperatura.
2. Na rea Temperatura insira um Alarme de Banda Morta com o nome de Tanque1.
3. Associe esse Alarme ao Tag Temp1 da pasta Dados.
4. Acesse as propriedades do Alarme, aba Banda Morta.
5. Configure as seguintes propriedades:
1. Setpoint:50
2. BM: 10
3. Texto da mensagem: Temperatura fora da faixa recomendada
Alarme Banda Morta

6. Copie o Alarme Tanque1 para criar o Alarme Tanque2.
7. Associe o Alarme Tanque2 ao Tag Temp2 e altere as mensagens do Alarme.
120
Alarmes
Associao dos Alarmes com os Tags
13.4.5 Alarme Digital

1. No objeto DadosBomba, insira uma Configurao de Alarmes.
2. Selecione a Configurao de Alarmes e crie uma nova rea com o nome de Bomba.
3. Na rea Bomba, insira um Alarme Digital com o nome de Defeito.
Alarme Digital Defeito

4. Associe ao Alarme Defeito a propriedade Defeito do objeto.
5. Acesse as propriedades do Alarme Defeito, aba Digital:
Marque a opo Alarme Digital
Escolha a opo True em Valor de Alarme
6. Para que nas mensagens de Alarme e retorno aparea o nome da bomba, crie as
Associaes vistas na prxima figura.
Alarmes Digitais
13.4.6 E3Alarm
A visualizao dos Alarmes em tempo real pode ser feita atravs do objeto E3Alarm.
1. Posicione um objeto E3Alarm
na TelaAlarmes.
2. Nas propriedades do E3Alarm, aba Geral, informe o nome do Servidor de Alarmes.
Alarmes
121
Selecionar Servidor de Alarmes

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.
Propriedade AlarmServer
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.
6. Execute a aplicao e confira as funcionalidades.
122
Alarmes
13.5.1 Reconhecer Todos os Alarmes

Vamos criar um boto onde possvel reconhecer todos os alarmes ativos.
1. Na TelaAlarmes, crie um boto com o texto "Reconhecer".
2. No boto, crie o seguinte script no evento Click.
'Reconhecer todos os alarmes
Screen.Item("E3Alarm1").AckAll(Application.User)
3. Busque, com o auxlio do AppBrowser, na TelaAlarmes o objeto E3Alarms1 e direita

o mtodo AckAll.
Screen.Item("E3Alarm1").AckAll([Operator])
4. Substitua o parmetro Operator pelo nome do usurio logado no Viewer. Com o auxlio do
AppBrowser busque a propriedade User do Viewer.
13.5.2 KB
KB-29110: Gerando um beep no speaker do PC quando alarme for ativado.
KB-17370: Executando um som sempre que existir um alarme ativo.
Alarmes
123
13.6 Anotaes
124
Alarmes
CAPTULO
14
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 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 se cria um objeto Relatrio ou um E3Browser, o objeto Consulta adicionado

a este automaticamente. No entanto, tambm se pode inserir uma Consulta em uma Pasta
de Dados ou em uma Tela e utilizar seus dados atravs de scripts.
14.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.
Consultas
125
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.
Janela de configurao da Consulta

A janela anterior pode ser acessada atravs de um clique com o boto direito do mouse sobre
126
Consultas
o objeto e selecionando a opo Configurar.
14.1.1 Criando e Acessando Variveis

Na janela de configurao da Consulta, pode-se adicionar filtros diretamente nos campos.
Estes filtros podem ser constitudos de variveis que sero definidas por script utilizando o
mtodo SetVariableValue da Consulta. A forma de declarar as variveis depende do tipo de
dado que elas representam, como vemos a seguir:
Nmero: <%Nome_da_Variavel%>
String: '<%Nome_da_Variavel%>'
Data e hora: #<%Nome_da_Variavel%>#
14.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
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.
Consultas
127
Inserir E3Browser
O E3Browser utiliza o objeto Consulta para auxiliar o usurio no processo de definio de
consultas no Banco de Dados da aplicao.
14.3 Exerccios
Vamos visualizar os dados de alarmes armazenados no Banco de Dados em forma de tabela
utilizando o objeto E3Browser.
14.3.1 TelaEventos
1. Insira no projeto uma nova Tela, chamada TelaEventos, a ser aberta no Divisor
Area_Central. Marque a opo Tela inicial do Divisor.
2. Na TelaMenu, insira um boto para abrir a TelaEventos.
14.3.2 E3Browser
1. Insira um E3Browser
na TelaEventos.
2. Para configurar os dados que o E3Browser mostrar, acesse as propriedades do objeto e v

at a aba Consulta.
3. Selecione a Consulta1 e clique no boto Configurar.
128
Consultas
Aba Consulta
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.
Consultas
129
Configurao da Consulta
14.3.3 Filtros na Consulta

Muitas vezes, acessar todo o contedo de uma tabela se torna invivel pela quantidade de
dados armazenados, seja pelo alto nmero de campos, ou pelo grande nmero de registros.
Nesses casos somos obrigados a aplicar filtros nos Histricos.
1. Insira na TelaEventos dois Setpoints chamados de spDataInicial e
spDataFinal e dois textos conforme a figura a seguir.
Setpoints para escolha das

datas
2. Usaremos um mtodo do Viewer que mostra um calendrio para a escolha de uma data
pelo usurio. Crie um novo script no evento Click dos Setpoints.
'Chama a funo Calendrio
If Application.ShowDatePicker(DataHora, 0, 0) Then
'Passa a data escolhida para o SetPoint
Value = DataHora
End If
3. Busque, com o auxlio do AppBrowser

boto Colar.
, o mtodo ShowDatePicker do Viewer e aperte o
Application.ShowDatePicker(DateValue, Left, Top, [DefaultDate])
4. O parmetro DefaultDate opcional e informa a data selecionada no calendrio. Apague-o

pois usaremos o padro, que corresponde data atual.
130
Consultas
5. Substitua os parmetros Left e Top por 0 ou a coordenada que desejar abrir o calendrio.
6. O parmetro DateValue deve ser substitudo por uma varivel interna de script.
Chamaremos essa varivel de DataHora.
7. O mtodo ShowDatePicker retorna verdadeiro se o usurio apertar o boto OK e falso se
apertar o boto Cancelar. Somente se apertar o boto OK que devemos passar o valor do
calendrio para o Setpoint. Digite "If" no comeo da linha do comando ShowDatePicker e
"Then" no final.
If Application.ShowDatePicker(DataHora, 0, 0) Then
8. Para passar a data do calendrio para o Setpoint, digite na prxima linha o texto a seguir.
Value = DataHora
9. Como estamos escrevendo o script no Setpoint e desejamos referenciar a sua propriedade

Value, podemos digitar diretamente o nome da propriedade sem ser obrigatrio o caminho
completo.
10.Finalize o script digitando "End If".
11.Acesse o objeto Consulta do E3Browser. Isso pode ser feito executando um duplo-clique no
objeto pelo Organizer ou pela aba Consulta do E3Browser.
Consulta do
E3Browser
12.Na coluna Filtro do campo E3TimeStamp, clique no boto
13.Para o usurio poder escolher a data inicial e a data final, precisamos criar variveis de
consulta. Configure o filtro conforme a figura a seguir.
Configurando o Filtro
Consultas
131
14.Digite um valor inicial para as variveis criadas na aba Variveis.
Variveis da Consulta
15.Acesse a aba Visualizar e clique no boto Executar Consulta para verificar o resultado da
Consulta. Certifique-se que o filtro foi aplicado e clique no boto OK.
16.Na TelaEventos, embaixo dos Setpoints, crie um boto Consultar, e insira um novo
script no evento Click com as seguintes linhas.
'Referencia os Setpoints
DataIni = Screen.Item("spDataInicial").Value
DataFim = Screen.Item("spDataFinal").Value
Set consulta = Screen.Item("E3Browser1").Item("Consulta1")
'Configura as variveis da Consulta
consulta.SetVariableValue "DataInicial", DataIni
consulta.SetVariableValue "DataFinal", DataFim
17.Digite a varivel interna de script "DataIni = ".

18.Busque, com o auxlio do AppBrowser, o Setpoint spDataInicial e direita sua
propriedade Value.
19.Repita o passo anterior para criar a varivel interna DataFim, referenciando o valor do
Setpoint spDataFinal.
20.Busque, com o auxlio do AppBrowser, a Consulta1 que est dentro do E3Browser1.

direita selecione o mtodo SetVariableValue.
132
Consultas
Screen.Item("E3Browser1").Item("Consulta1").SetVariableValue(VarName, Value)
21.Quebre a linha aps ("Consulta1").

Screen.Item("E3Browser1").Item("Consulta1")_
.SetVariableValue(VarName, Value)
22.Digite no comeo da linha o texto "set consulta = ". Desse modo criamos uma varivel
interna de script que referencia o objeto Consulta.
Set consulta = Screen.Item("E3Browser1").Item("Consulta1")
23.No incio da linha que contm o mtodo SetVariableValue digite "consulta.".

consulta.SetVariableValue(VarName, Value)
24.O parmetro VarName referencia o nome da varivel criada na Consulta. Digite

"DataInicial".
25.No parmetro Value informe o valor que deseja passar para a varivel. No caso, desejamos
passar o valor do Setpoint que referenciamos atravs da varivel interna DataIni.
consulta.SetVariableValue "DataInicial", DataIni
26.Remova os parnteses do mtodo SetVariableValue.

27.Copie a linha para implementar a mesma lgica para a varivel DataFinal.
consulta.SetVariableValue "DataFinal", DataFim
28.Compile o script e teste.
14.4.1 KB
KB-20214: Funo SQL para calcular valores mximo, mnimo e mdia.
Consultas
133
14.5 Anotaes
134
Consultas
CAPTULO
15
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 nome do projeto no Explorer e selecione a opo Inserir - Histrico.
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 os campos).
Histrico
15.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 capaz de atuar como chave primria, pelo fato
deste apresentar valores repetidos. Alm disso, uma tabela pode ter somente uma chave
primria, seja ela simples ou composta. Ou seja, no se pode definir dois ou mais campos de
uma tabela para serem 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
Histric os
135
primria da tabela. Ao escolher campos de 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-a atravs do boto
ou clicando no cone
, que abrir a tela de configurao.
15.2 ndices
Um ndice um campo ou um conjunto de campos que sero previamente ordenados pelo
Banco de Dados a fim de melhorar o desempenho das consultas que utilizam esse ndice. Eles
so utilizados para encontrar rapidamente registros com um valor especfico em uma coluna.
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 ele 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
ilustrada a seguir.
, que abre a tela de configurao,
Editor de ndices
136
Histric os
15.3 Exerccios
15.3.1 Histrico
1. Clique com o boto direito do mouse no item Banco de Dados e insira um novo Histrico
no projeto TreinamentoE3, nomeando-o como HistNivel.
Inserir Histrico
2. No Histrico criado, insira dois novos campos e configure-os conforme a figura a seguir.
Configurao dos campos

3. Clique sobre a opo Propriedades do Histrico
seguintes propriedades:
, e na aba Histrico configure as
Banco de dados: BancoDados

Tabela: Nivel
Histric os
137
Tempo de gravao: 2000 ms
4. Clique sobre o boto Gerar Tabela. Deve aparecer a mensagem "A estrutura de tabelas foi
criada com sucesso".
Mensagem de sucesso ao gerar tabela
15.4.1 KB
KB-24714: Limite de campos de um Histrico.
138
Histric os
15.5 Anotaes
Histric os
139
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.
140
E3Chart
Propriedades da Pena
16.1.1 Tempo Real

Para configurar uma Pena como 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 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.
E3Chart
141
16.1.3 Tempo Real e Histrica (Mista)

Para configurar uma Pena como 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
Vamos fazer um grfico com Penas de Tempo Real e Histricas com as variveis de nvel.
Atravs de um boto, vamos escolher entre o grfico exibir o eixo horizontal como tempo real
ou histrico.
16.2.1 TelaGrafico
1. Insira no projeto uma nova Tela, chamada TelaGrafico, a ser aberta no Divisor
Area_Central. Marque a opo Configurar como Tela inicial do Divisor.
2. Na TelaMenu, insira um boto para abrir a TelaGrafico.
16.2.2 E3Chart
1. Posicione um E3Chart
na TelaGrafico.
16.2.3 Escala
Os maiores valores so do Tag Nivel, que varia de 0 a 100, portanto vamos alterar a escala
vertical para exibir os valores nessa faixa.
1. Na aba Eixos, selecione o EixoVertical e clique em Configurar.
2. Na aba Escala, configure os limites da escala numrica entre 0 e 100.
16.2.4 Consulta
Como desejamos visualizar os dados histricos, precisamos configurar uma Consulta.
1. Acesse as propriedades do E3Chart, aba Consultas.
2. Clique no boto Adicionar. Selecione "BancoDados" no campo Nome do Servidor, e a seguir
escolha a tabela Nivel.
3. Selecione os campos E3TimeStamp, Nivel1 e Nivel2.
4. Visualize o resultado da consulta na aba Visualizar e clique em OK.
142
E3Chart
16.2.5 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 Nivel1.
Propriedades da Pena
4. Na aba Dados, deixe a opo Tipo de pena em Tempo Real & Histrica.
5. Na opo Link do eixo vertical, selecione a propriedade Value do Tag Nivel1 da pasta
Dados.
6. No item Parte Histrica, preencha os campos a seguir:
Consulta local: Consulta1
Campo do eixo vertical: Nivel1
Campo do eixo horizontal: E3TimeStamp
Dados da Pena
6. Repita os passos anteriores para a Pena Nivel2.
E3Chart
143
16.2.6 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.7 Visibilidade das Penas

1. Para habilitar ou desabilitar a visibilidade de uma Pena, adicione uma Caixa de Seleo
na TelaGrafico.
2. Na Caixa de Seleo, crie um script no evento Change, e busque no AppBrowser a
propriedade Visible da Pena Nivel1.
Propriedade Visible da Pena

3. Complete a linha do script com o cdigo a seguir.
Screen.Item("E3Chart1").Pens.Item("Nivel1").Visible = Value
4. Busque, com o auxlio do AppBrowser, o E3Chart que est dentro da TelaGrafico,

coleo Pens, Pena Nivel1, e direita selecione a propriedade Visible. Clique em Colar.
5. Digite " = Value". Como estamos escrevendo o script na Caixa de Seleo, ao digitar "Value"
fazemos referncia ao valor do prprio objeto.
6. Configure o valor inicial (Value) da Caixa de Seleo para True.
7. Repita os passos anteriores para a Pena Nivel2.
144
E3Chart
16.2.8 Eixo Horizontal Histrico

Para navegarmos pelo grfico consultando dados antigos, o eixo horizontal deve estar
configurado como Histrico.
1. Acesse as propriedades do E3Chart, aba Eixos.
2. Selecione o EixoHorizontal e clique no boto Configurar.
3. Na aba Escala, escolha a opo Intervalo de tempo (histrico).
Intervalo de tempo
4. Escolha um intervalo inicial pequeno (cinco minutos), assim a Tela ser carregada
rapidamente.
16.2.9 Intervalo do Grfico

1. Para podermos escolher a data inicial e data final visualizada no E3Chart, copie da
TelaEventos os Setpoints com a data inicial e data final para a TelaGrafico.
Data inicial e final

2. No Setpoint com a data inicial, crie uma Associao Bidirecional com a propriedade
HorScaleBegin do E3Chart.
3. No Setpoint com a data final, crie uma Associao Bidirecional com a propriedade
HorScaleEnd do E3Chart.
E3Chart
145
16.3.1 Minutos Recentes

Desejamos iniciar a Tela exibindo no grfico os ltimos 10 minutos. A maneira mais prtica de
se referenciar o horrio atual pelo comando Now do VBScript. Para retornar o dia anterior,
usamos Now - 1. Para uma hora atrs, Now - 1 / 24.
1. No evento OnPreShow da TelaGrafico, insira o seguinte script.
'Grfico exibe os ltimos 10 minutos.
Item("E3Chart1").HorScaleBegin = Now - 10 / 1440
Item("E3Chart1").HorScaleEnd = Now
2. Busque, com o auxlio do AppBrowser, o E3Chart dentro da TelaGrafico e direita a

propriedade HorScaleBegin.
3. Digite " = Now - 10 / 1440".
4. Busque, com o auxlio do AppBrowser, o E3Chart dentro da TelaGrafico e direita a
propriedade HorScaleEnd.
5. Digite " = Now".
16.3.2 KB
KB-18257: Criando um grfico com pontos digitais.
146
E3Chart
16.4 Anotaes
E3Chart
147
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 do Organizer, em modo Domnio, e
selecione a opo Inserir Relatrio em, e em seguida o nome do 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.
Sees do Relatrio
Um Relatrio estruturado da seguinte forma:
Estrutrura do Relatrio
SEO
Report Header
148
DESCRIO
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.
Relatrios
SEO
DESCRIO
Report Footer
Esta seo impressa no final do Relatrio.

Utilizada para imprimir uma soma de um
Relatrio, totais gerais ou qualquer outra
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
Relatrios
149
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 a informao.
Pode-se tambm usar tabelas para criar layouts de pgina
150
Relatrios
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 Server 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
Ser feito um Relatrio onde ser impresso o grfico da Tela e em seguida todos os dados
exibidos no grfico.
17.2.1 Relatrio Grfico

Vamos criar um relatrio grfico que copia as configuraes do grfico da Tela. Esse relatrio
ser impresso e exportado para PDF.
1. Insira no projeto um Relatrio chamado RelatorioGrafico.
2. Na seo PageHeader, insira um objeto E3Chart.
3. Acesse o Editor de Scripts pelo boto
4. No campo Object escolha PageHeader, e no campo Events escolha OnBeforePrint.

5. Entre os textos "Sub OnBeforePrint" e "End Sub", digite o seguinte script:
Set Chart = Report.Sections("PageHeader").Controls("E3Chart1")
Set ChartTela = Application.GetFrame("Area_Central").Screen.Item("E3Chart1")
Chart.CopyConfig(ChartTela)
Chart.LoadData()
Relatrios
151
17.2.2 Imprimir
Antes de exportar o Relatrio, vamos ter a possibilidade de visualizar a impresso.
1. Na TelaGrafico, insira um Boto de Comando com o texto "Imprimir".
2. Crie um script no evento Click que utiliza o Pick Imprimir Relatrio. Selecione o
RelatorioGrafico e escolha Tela na opo Sada.
17.2.3 Exportar
Para o usurio escolher o nome e diretrio do arquivo que ser gerado, abriremos uma caixa
de dilogo.
1. Insira um boto Imprimir na TelaGrafico e altere o texto para "Exportar".
2. Crie o seguinte script no evento Click do boto:
If Application.ShowFilePicker(False, NomeArquivo,"pdf", _
128, "Arquivos PDF|*.pdf|Todos os arquivos|*.*") Then
Set Report = Application.LoadReport("RelatorioGrafico")
Report.Export "PDF", NomeArquivo
End If
3. Com o auxlio do AppBrowser, busque o mtodo ShowFilePicker do Viewer.

Application.ShowFilePicker(Open, FileName, Extension, Flags, Filter)
4. Como desejamos salvar um arquivo, substitua o parmetro Open para False.

5. O parmetro FileName deve ser uma varivel interna de script que armazenar o nome do
arquivo. Substitua-o por "NomeArquivo".
6. Caso no seja informada a extenso do arquivo, ser considerado como padro o que for
informado no parmetro Extension. Digite "pdf".
7. Para uma mensagem de confirmao aparecer para o usurio caso o arquivo j exista,
altere o parmetro Flags para 128.
8. As caixas de dilogo de arquivos permitem filtros para facilitar a busca por tipos de
arquivos.
Tipos de Arquivos
9. O filtro sempre um par de Strings separadas pelo caractere "|", sendo que o primeiro item
o nome que aparecer para o usurio e o segundo um identificador do Windows.
152
Relatrios
10.Substitua o parmetro Filter por "Arquivos PDF|*pdf | Todos os arquivos| *.*".

11.O arquivo s pode ser gerado se o usurio clicar em Salvar. Se o usurio cancelar a ao,
nada deve acontecer. No incio do comando ShowFilePicker, digite "If" e no final digite
"Then".
12.Para exportar o Relatrio busque, com o auxlio do AppBrowser, o item Tarefas - Carregar o
relatrio - RelatorioGrafico e direita o mtodo Export.
Report.Export([ExportFilter], [ExportFileName])
13.Substitua o parmetro ExportFilter por "PDF" e o parmetro ExportFileName pela varivel

NomeArquivo, criada anteriormente.
14.Teste as novas funcionalidades da aplicao.
17.2.4 Relatrio de Alarmes

1. Clique com o boto direito do mouse no projeto e insira um objeto Relatrio. Renomeie
para RelatorioAlarmes.
2. No objeto Consulta1 do Relatrio, clique com o boto direito do mouse e escolha a
opo Configurar.
Configurar Consulta
3. Consulte todos os campos que desejar da tabela Alarms.
4. Crie um filtro para o campo E3TimeStamp, conforme a figura a seguir.
Relatrios
153
Configurar Filtro
5. Teste a Consulta informando valores para as variveis criadas.
17.2.5 Page Header

A seo Page Header impressa no topo de cada pgina do Relatrio. a primeira seo da
pgina a ser impressa, exceto quando esta pgina contm a seo Report Header. Ela
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.
1. 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.
17.2.6 Detail
A seo Detail o corpo do Relatrio, impressa uma vez para cada registro da fonte de dados.
Para esta aplicao, sero mostrados os dados de alarmes.
1. 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 nome da coluna
configurada na Consulta.
2. Para visualizar o Relatrio, pressione o boto Gerar Relatrio
17.2.7 Page Footer

Esta seo impressa uma vez no rodap de cada pgina do Relatrio. Ela utilizada para
imprimir totais de pginas, nmeros de pginas ou qualquer outra informao que necessite
ser impressa uma vez no rodap de cada pgina.
1. O uso dos campos de dados do Relatrio do E3 bastante flexvel, sendo configurado no
prprio campo que a funo dever executar. Por exemplo, ser criada na seo PageFooter
a indicao "Pgina 1 de 12".
154
Relatrios
2. Insira dois Textos, "Pgina" e "de".

3. Entre os Textos, insira um Campo de Dados e configure-o para mostrar o nmero da pgina
atual:
SummaryType: 4 - ddSMPageCount
SummaryRunning: 2 - ddSRAll
4. Aps o Texto "de", insira um Campo de Dados e configure-o para mostrar o nmero total de
pginas:
SummaryType: 4 - ddSMPageCount
SummaryRunning: 0 - None
Seo Page Footer
17.2.8 Report Header e Footer

Estas sees so impressas no incio ou no fim do Relatrio e utilizadas para imprimir ttulos
de Relatrios, tabelas de somas, grficos ou qualquer outra informao que necessite
aparecer somente uma vez no incio ou no fim do Relatrio.
1. Clique com o boto direito do mouse no fundo do Relatrio e escolha Insert - Report
Header/Footer. Essa opo insere uma pgina inicial e final no Relatrio.
Inserir Report Header e Footer

2. Na seo ReportHeader desenhe uma "capa" para o Relatrio.
3. Na seo ReportFooter, insira um objeto Campo de Dados e configure a propriedade
DataField com o caminho de Relogio da pasta Dados, Dados.Relogio.
Relatrios
155
4. Insira um segundo Campo de Dados e configure-o para exibir o nome do usurio logado no
Viewer.
Propriedade DataField
5. Insira dois objetos Texto, "Relatrio gerado" e "pelo usurio" conforme a figura a seguir.
Seo Report Footer
17.2.9 Imprimir
1. Para visualizar o Relatrio em tempo de execuo, na TelaEventos copie o boto
Consultar para criar um novo boto com o texto "Imprimir".
2. No evento Click do boto, crie o script a seguir:
' Imprime o Relatrio
' Referencia os Setpoints
' Referencia a Consulta do Relatrio
Set Consulta = Report.Item("Consulta1")
' Configura as variveis da Consulta
Consulta.SetVariableValue "DataInicial", DataIni
Consulta.SetVariableValue "DataFinal", DataFim
' Visualiza a impresso
Report.PrintPreview()
3. Na linha que referencia o objeto Consulta, com o auxlio do AppBrowser, acesse Tarefas Carregar Relatrio - RelatorioAlarmes - Consulta1.
Set consulta = Report.Item("Consulta1")
4. No final do script, novamente com o auxlio do AppBrowser, acesse Tarefas - Carregar

Relatrio e direita o mtodo PrintPreview.
5. Apague a linha que faz referncia ao Relatrio, pois j o declaramos no incio.
Report.PrintPreview()
6. Teste o mtodo Imprimir(PrintPreview). S podem ser impressos os dados dentro do

intervalo especificado.
156
Relatrios
17.3 Anotaes
Relatrios
157
CAPTULO
18
Frmulas
Frmulas so mdulos destinados a armazenar e transferir conjuntos de valores para

determinados agrupamentos de variveis, de forma a criar configuraes ou setups prdefinidos, sendo basicamente uma implementao de receitas. As Frmulas so
basicamente compostas de trs partes:
Templates: Definem o tipo de dado que poder ser armazenado em cada varivel da
frmula e suas restries. Estas restries permitem habilitar ou desabilitar a alterao
dos valores da frmula em tempo de execuo, ou ento estipular limites para a alterao
Unidades: Definem os Tags que sero associados ao template da frmula. possvel criar
vrias unidades, ou seja, vrios grupos de Tags que podero receber os valores da frmula
Conjuntos de Valores: So os valores que sero transferidos para os Tags, ou seja, para as
unidades
As Frmulas esto sempre ligadas a um Banco de Dados, pois precisam fazer com que seus
dados (Templates, Unidades e Conjuntos de Valores), configurados em algum momento,
continuem vlidos sempre que necessrio. Para trabalhar com Frmulas possvel utilizar
qualquer tipo de banco de dados, e o prprio E3 Studio ou o E3 Server cuida de criar as tabelas
e relacionamentos necessrios ao uso de Frmulas.
NOTA: Ao utilizar um banco de dados MDB (Microsoft Access), interessante criar

separadamente arquivos especficos para as Frmulas e para os Histricos, de forma a
evitar que todos os dados se percam caso haja um problema com algum arquivo.
18.1 Exerccios
O objeto Frmula armazenar informaes sobre as cores de tintas, formadas pela
combinao de vermelho, verde e azul.

1. Insira um novo Banco de Dados no TreinamentoE3 com o nome de FormulaDB.
2. No campo Arquivo MDB, localize a pasta TreinamentoE3 e digite o texto "Formula.mdb",
sem as aspas.
158
Frmulas
18.1.2 Frmula
1. Insira um objeto Frmula
no TreinamentoE3.
Inserir Frmula
2. Digite no campo Banco de Dados o texto "FormulaDB", e no campo Tabela digite
"FormulaTreina".
Configurao do Banco de Dados da Frmula

3. Nomeie o objeto como Formula.
4. Na aba Templates, adicione trs novos Templates do tipo Integer: Vermelho, Verde e Azul.
Para todos os Templates, escolha a restrio absoluta de 0 a 255.
Frmulas
159
Templates
5. Na aba Unidades, selecione uma linha qualquer da coluna Unidade1 e clique no boto
Renomear
. Troque o nome da Unidade para Tanque1.
6. Clique no boto
para adicionar uma nova Unidade, Tanque2.
7. Busque, nas duas Unidades, o caminho de cada propriedade dos objetos Tanque1 e
Tanque2 em Dados.
Configurao das Unidades

8. Na aba Valores, adicione mais Conjuntos de Valores, preenchendo as colunas com os
valores que preferir.
Configurao dos Conjuntos de Valores

9. Para carregar os dados da Frmula, insira um boto na TelaSinotico com a propriedade
Caption igual a "Carrega" e, no evento Click, crie um script com o mtodo LoadFormulaDlg do
Viewer.
Application.LoadFormulaDlg "Formula"
18.2.1 KB
KB-28508: Dados carregados de frmulas mostram valores sem casa decimal.
160
Frmulas
18.2.2 Lista de Seleo

Ao invs de utilizar o comando pronto para carregarmos os valores da frmula atravs de uma
caixa de dilogo do Viewer, possvel utilizar os mtodos do prprio objeto Frmula. Uma
lista de seleo ser preenchida com todos os Conjuntos de Valores cadastrados e ao
selecionar um deles, os valores sero carregados. Para buscar no Banco de Dados todos os
Conjuntos de Valores j cadastrados, ser preciso utilizar um objeto Consulta.
1. Insira na TelaSinotico um objeto Consulta.
2. Configure a Consulta1 para buscar a tabela FormulaTreina_Values no Banco de
Dados FormulaDB.
Selecionando a tabela de valores

3. Selecione apenas a coluna Name e visualize a Consulta. Todas as cores cadastradas devem
aparecer.
4. Agora ser preenchida uma lista de seleo com os dados retornados pela Consulta.
5. Insira uma Lista de Seleo (ComboBox)
, prxima ao Tanque1.
6. No evento OnStartRunning da Lista de Seleo, crie o seguinte script:

' Limpa a Lista de Seleo
Clear()
' Busca os dados da Consulta
Set RS = Screen.Item("Consulta1").GetADORecordset()
' Adiciona todos os registros encontrados na Lista de Seleo
For i = 1 To RS.RecordCount
AddItem RS.Fields("Name").Value
RS.MoveNext
Next
Frmulas
161
7. No evento Click da Lista de Seleo, crie o seguinte script:

Application.GetObject("Formula").LoadFormulaValuesQuiet "Tanque1", Value
162
Frmulas
18.3 Anotaes
Frmulas
163
CAPTULO
19
Storage
O Storage um mdulo historiador do E3 desenvolvido para aperfeioar o uso de bancos de

dados, fazendo com que uma determinada informao seja armazenada ocupando o menor
espao possvel.
Existe todo um conjunto de funcionalidades especficas para este mdulo, como consultas
pr-construdas e algoritmos de compactao de dados, entre outros. Atravs desta
ferramenta possvel recuperar com grande exatido todas as mudanas nas variveis de
processo, ocupando assim o mnimo de espao no banco de dados.
O uso do Storage fortemente recomendado para processos onde o objetivo do registro seja
o acompanhamento de tendncias que necessitem manter informaes essenciais ao
processo. Atravs de um algoritmo matemtico bastante difundido, o Storage pode fornecer
informaes relevantes de um determinado processo ocupando menos espao em disco do
que os dados gravados por um Histrico gravado periodicamente.
Em processos onde os dados devem ser precisos, como medies usadas para faturamento
de insumos (gua, energia ou gs), ou processos onde os dados devem ser integralizados em
um perodo, o uso de Histricos convencionais o recomendado.
19.1 Funcionamento
A gravao no Storage feita da seguinte maneira:
Aps a definio da tabela, os dados so gravados de acordo com as configuraes. Se
houver variao de qualidade no Tag, os dados tambm sero gravados
Os dados s no sero gravados se a variao ocorreu num tempo menor do que o mnimo
programado
Conforme forem sendo obtidos novos valores para as variveis, um algoritmo de verificao
de gravao vai interpretando a sequncia e decidindo se cada ponto ser ou no
armazenado.
Esta verificao, entretanto, s ocorre para os campos analgicos. Para os campos de texto e
digitais, basta que haja uma mudana qualquer de valor ou de qualidade para que sejam
gravados.
Para cada tipo de grandeza armazenada, gerado automaticamente um conjunto de tabelas,
um para os Tags analgicos, outro para os textos e um terceiro para os digitais. Dessa forma,
cada Storage pode gerenciar at sete tabelas (backup), caso se especifique que os trs tipos
de Tags devem ser armazenados:
164
Storage
<NomeTabela>_Fields
<NomeTabela>
<NomeTabela>_Text
<NomeTabela>_Bit
<NomeTabela>_Backup
<NomeTabela>_Text_Backup
<NomeTabela>_Dig_Backup
19.2 Configurao
Quando o Storage criado na Tela, mostrada uma lista de definies dos campos de
gravao.
Storage
Para efeitos de posterior consulta nos dados, toda a busca se dar atravs do caminho do Tag
ou da propriedade que est sendo armazenada (campo Fonte). A propriedade Nome s ser
utilizada caso o campo Fonte contenha uma expresso. Logo, se expresses no estiverem
sendo utilizadas no campo Fonte, no h necessidade de se importar com o nome.
Storage
165
19.3 Consultas Internas

A ferramenta Query prev algumas facilidades para realizar consultas nos dados do Storage.
Ao configurar a consulta, ao invs de exibir as tabelas, h uma rvore com todas as variveis
armazenadas.
Configurao da Consulta
O usurio pode escolher uma entre sete funes descritas a seguir para consolidao dos
dados.
19.3.1 LastValue
Retorna o ltimo valor armazenado na Base de Dados.
19.3.2 ArchivedValue
Retorna um valor armazenado em relao a um determinado instante de tempo definido na
varivel TimeStamp. O tipo de relao pode ser:
Previous: valor armazenado imediatamente anterior ao timestamp fornecido
Next: valor armazenado imediatamente posterior ao timestamp
166
Storage
Interpolated: valor calculado a partir do valor anterior e posterior

ExactTime: valor armazenado no exato instante que foi fornecido pelo timestamp
19.3.3 TagAttribute
Retorna um atributo do Tag, que pode ser:
FieldDescription: significado ou descrio do Tag
FieldSource: caminho do Tag que est sendo armazenado
FieldType: tipo de dado (Double, Bit, String ou Integer)
FieldEU: unidades de engenharia
FieldLowEng: limite inferior
FieldHighEng: limite superior
FieldDeadBand: banda morta para gravao
FieldDeadBandUnit: unidade da banda morta (absoluta ou percentagem)
FieldMinRecTime: tempo mnimo para gravao
FieldMaxRecTime: tempo mximo para gravao
19.3.4 CompressedDataNValues
Retorna, para um nico Tag, n valores armazenados a partir de um instante inicial.
19.3.5 CompressedDataStartEndTime
Retorna, para um nico Tag, os valores armazenados entre um intervalo inicial e um intervalo
final.
19.3.6 SampledData
Retorna, para um ou mais Tags, os valores interpolados (estimados) a intervalos fixos entre os
instantes definidos pelas variveis StartTime e EndTime.
Storage
167
19.3.7 CalculatedData
Retorna o resultado de operaes matemticas aplicadas aos dados entre os instantes
definidos pelas variveis StartTime e EndTime, a intervalos fixos. Os tipos de clculos
so Total, Mnimo, Mximo, Desvio Padro, Amplitude, Mdia e Mediana.
19.4 Exerccios
Vamos criar dois Storages que sero utilizados nos captulos seguintes. O Storage com os
dados de temperatura ser visualizado graficamente e o Storage com os dados das bombas
ser utilizado pelo PlayBack.
19.4.1 Temperatura
1. Insira um objeto Storage no projeto. Altere o nome para StorageTemp.
Inserir Storage
2. No objeto StorageTemp, insira dois campos e configure-os como na figura a seguir.
Configurao dos campos

3. Clique sobre a opo Propriedades
e configure as seguintes opes.

Tabela: Temperatura
168
Storage
4. Clique sobre o boto Gerar Tabela. Deve aparecer a mensagem da figura a seguir.
Estrutura criada com sucesso
19.4.2 DadosBomba
1. No XObject DadosBomba insira um Storage. Chame de StorageBomba.
Inserir Storage
2. Adicione no StorageBomba as propriedades Automatico, Defeito e OnOff do objeto
DadosBomba. Configure-as como na tabela a seguir.
Campos do Storage
Storage
169
3. Clique sobre o boto Propriedades
e configure as seguintes opes:

Tabela: Bombas
NOTA: Quando o Storage est inserido em um XObject, a estrutura da tabela ser gerada
quando a aplicao for executada.
19.5.1 KB
KB-31955: Storage funcionando apenas com hardkey de Studio.
170
Storage
19.6 Anotaes
Storage
171
CAPTULO
20
E3Playback
O E3Playback um ActiveX que roda dentro do E3 Viewer ou do E3 WebViewer e que permite

visualizar as telas do aplicativo utilizando dados histricos armazenados em bancos de
dados.
O E3Playback busca no banco de dados os tags referenciados nas telas e mostra valores,
animaes, estados e grficos de acordo com as informaes existentes no banco de dados,
no perodo de playback definido.
NOTA: Em modo Demo (ou com uma licena de Studio) o perodo permitido para playback se
resume s ltimas seis horas de dados armazenados no banco.
20.1 Interface de Usurio do E3Playback

A interface de usurio do E3Playback dividida em cinco partes, mostradas nas sees
seguintes.
20.1.1 Barra de Ferramentas
Barra de Ferramentas do E3Playback
20.1.2 Linha de Tempo

A Linha de Tempo permite acompanhar visualmente e controlar o relgio de playback.
Linha de Tempo
172
E3Play bac k
20.1.3 rea de Telas

Esta a rea onde so mostradas as Telas do aplicativo. A Tela inicial mostrada a
configurada na propriedade InitialScreen do E3Playback. Se esta propriedade for deixada em
branco, utilizada a Tela inicial do objeto Viewer. As Telas so sempre abertas no zoom
Preencher. possvel navegar livremente entre as Telas do aplicativo.
20.1.4 Lista de Eventos

A Lista de Eventos mostra a sequncia cronolgica de eventos de playback (alterao no valor
de um tag ou estado de um alarme), permitindo a navegao evento a evento.
Lista de Eventos
E3Play bac k
173
20.1.5 Lista de Tags

A Lista de Tags mostra os Tags que esto sendo utilizados para playback.
Lista de Tags
A Lista de Tags pode ajudar tambm a determinar quais Tags necessitam ser gravados no
banco de dados para permitir o playback completo de uma Tela, bastando verificar os Tags
com o sinal de proibido.
20.2 Restries e Comentrios

As Telas funcionam como se estivessem em um Viewer Read-Only. Isto garante que as
operaes efetuadas no E3Playback no iro perturbar o funcionamento do aplicativo em
tempo real
No permitido acesso aos objetos do servidor atravs do mtodo Application.GetObject.
Os erros de script ocorridos dentro do E3Playback no geram uma mensagem de erro, so
abortados silenciosamente
O E3Playback emula um Viewer real. Pode-se testar a propriedade IsPlaybackMode
O E3Playback trata os novos Quadros criados pelo aplicativo como novas abas no topo da
rea de Telas. O ttulo da aba o nome do Quadro ou Tela que foi aberto
Todas as Associaes que se referem a objetos do servidor so capturadas pelo
E3Playback, e passam a receber os dados histricos de acordo com o relgio atual de
playback
As Associaes feitas entre objetos do Viewer (por exemplo, um Display mostrando o valor
de um Tag Demo interno ao Viewer) funcionam normalmente, sem nenhuma interferncia
do playback
O E3Chart s ir funcionar dentro do E3Playback se estiver configurado com Penas
histricas. Penas de tempo real so desabilitadas
O E3Alarm ir mostrar o sumrio de alarmes de acordo com o que estiver registrado na
tabela de alarmes no Banco de Dados
O E3Browser ir funcionar normalmente
174
E3Play bac k
20.2.1 Storage
A coluna Fonte no deve conter expresses, pois elas no podero ser utilizadas no
playback
20.2.2 Alarmes
Habilite ou configure o registro de alarmes em disco
Selecione os seguintes campos para registro (obrigatrios):
EventTime (mais EventTimeMS) ou EventTimeDbl
FullAlarmSourceName
ConditionActive
Acked
AckRequired
20.2.3 Histricos
O formato de arquivo Histrico no o ideal para playback, pois normalmente muitos dados
duplicados esto armazenados. recomendado o uso do Storage sempre que possvel. Seguir
ao mximo as seguintes recomendaes:
Configurar a propriedade UserTable para False
Colocar cada Tag em um campo separado (no utilizar expresses)
Criar um ndice para o campo E3TimeStamp
Utilizar tabelas com poucos campos e, se possvel, adicionar um ndice individual para
cada campo (principalmente para os campos com poucas variaes)
Configurar a propriedade CompressedTable para True e utilizar a propriedade DeadBand no
Histrico
20.3 Licenciamento
A Elipse fornece dois pacotes para o E3 Playback:
Playback Bsico
Playback Avanado: Bsico mais as ferramentas de Gravao de Vdeo e Captura de Tela
E3Play bac k
175
Os pacotes so dimensionados conforme o nmero de pontos (Tags e Fontes de Alarmes)

armazenados no Banco de Dados. Se o Banco de Dados tiver mais pontos que as licenas
disponveis, a montagem do Banco de Dados ir falhar e ser mostrada uma mensagem de
erro.
A licena de Studio do E3 inclui uma licena de Playback Avanado sem limite de pontos,
porm limitada s ltimas seis horas de dados armazenados no Banco de Dados. Em modo
Demo (quando no h dispositivo de proteo) o playback tambm funciona no modo
Avanado sem limite de pontos, porm limitado a mostrar apenas as ltimas seis horas de
dados armazenados no Banco de Dados.
20.4 Exerccios
20.4.1 TelaPlayBack
1. Insira no projeto uma nova Tela chamada TelaPlayBack, a ser aberta no Divisor _top.
2. Na TelaMenu, insira um boto para chamar a TelaPlayBack. No item Quadro, digite o
nome de um Quadro inexistente (por exemplo, "QuadroPlayBack"), para que sejam abertas
duas Telas simultaneamente.
20.4.2 Configurao
1. Na TelaPlayBack, insira o objeto E3PlayBack ocupando toda a Tela.
2. Acesse suas propriedades e configure-as conforme a figura a seguir.
Propriedades do E3Playback
3. Execute a aplicao.
176
E3Play bac k
20.4.3 Execuo
1. Aperte o boto para entrar no modo Online. Os primeiros dados de playback sero
carregados, e o relgio de playback ser posicionado no centro dos dados disponveis.
2. Uma linha com o intervalo de dados existentes aparecer na Linha do Tempo e a Janela de
Eventos ser preenchida.
Linha de Tempo
3. Escolha o evento que deseja iniciar a reproduo e aperte o boto
Play.
20.5.1 Dados do Playback

1. Salve em Histricos ou Storages todos os Tags que desejar visualizar no E3Playback.
E3Play bac k
177
20.6 Anotaes
178
E3Play bac k
CAPTULO
21
Hot-Standby
O Hot-Standby permite a implementao do conceito de failover em um sistema supervisrio.

Esse conceito consiste na possibilidade de se ter dois servidores (principal e backup) atuando
um como contingncia do outro, ou seja, se o servidor principal falhar, um servidor de backup
entra em ao imediatamente, sem perda da continuidade do processo. Diz-se do servidor
em espera que est em Standby.
Ao iniciar a execuo do E3 que est configurado para o sistema Hot-Standby, ser mostrado
na rea de Notificao nos servidores um cone representado por uma barra amarela
circulante
, indicando que os Domnios esto sendo carregados. Aps alguns segundos, o
E3 reconhece o servidor principal e indica a ao com um cone representado por uma seta
verde
. Este cone determina que o servidor est em execuo. O servidor Standby vai
permanecer com o cone representado por duas barras amarelas

em modo de espera (standby).
, indicando que ele est
21.1 Configuraes do Hot-Standby

Esta seo contm as configurao para o funcionamento de servidores E3 em modo HotStandby.
21.1.1 Arquivos
Os arquivos do Domnio devem estar na mesma localizao no servidor principal e no servidor
de backup. Por exemplo, se no computador principal o Domnio e os demais arquivos (.lib, .prj,
etc.) estiverem no caminho C:\Projeto1, no servidor Standby o projeto dever ser copiado
para este mesmo caminho, ou seja, C:\Projeto1.
21.1.2 Servidores
Os servidores (principal e backup) devem estar listados na aba Servidores das opes do
Domnio.
1. Para acessar as configuraes do Domnio, clique no cone do E3 Admin
Notificao do Windows e selecione o menu Domnio - Opes.
Hot-Standby
na rea de
179
Menu Domnio - Opes

2. Os servidores podem ter o nome que se desejar no campo Nome do servidor. No campo
Identificao do servidor na rede informe o nome do computador na rede. Por exemplo,
Nome do servidor como Servidor1 e Identificao do servidor na rede como \
\servidor1.
Aba Servidores
180
Hot-Standby
21.1.3 Opes de Configurao

Na aba Opes, o item Habilitar deve estar marcado e nos campos Servidor principal e Servidor
de backup selecionados um dos servidores cadastrados previamente na aba Servidores.
Aba Opes
Os itens descritos nas prximas sees tambm devem ser configurados.
21.1.4 Ping de Integridade

O Ping de Integridade uma terceira entidade de rede (as outras so os servidores principal e
o de backup) para determinar se a rede est funcionando. Se no for possvel acessar o
endereo de integridade nem o servidor de backup, o servidor principal assume que a sua
interface de rede est com problemas e termina imediatamente a execuo do Domnio. Se o
servidor Standby conseguir acessar a integridade e no conseguir acessar o servidor Hot
(principal), ele entende que o Hot est com problemas e assume a execuo do Domnio.
Hot-Standby
181
21.1.5 Falha Local

Falhas locais so detectadas e reportadas pelo prprio aplicativo atravs do mtodo
Application.ReportFailure. possvel habilitar a troca automtica de servidores quando uma
falha local reportada no servidor principal. A troca de servidores s feita se o servidor de
backup estiver sem falhas.

Quando se trabalha com bancos de dados e Hot-standby, tem-se basicamente duas opes de
estrutura:
Ambas as aplicaes acessam uma mesma base de dados na rede. O servidor Hot ir
gravar os dados nesse Banco de Dados
Existem dois bancos de dados rodando localmente, em ambos servidores (principal e
backup). Nesse caso, habilita-se a propriedade EnableSynchronization do objeto Banco de
Dados, assim todos os dados gravados na base de dados principal so tambm atualizados
na base de dados em Standby
Se a aplicao principal no conseguir enviar os dados para o servidor em Standby, esses

dados ficaro armazenados em disco localmente, para posterior envio (quando a
comunicao entre os dois computadores for restabelecida), assegurando assim a igualdade
entre as tabelas geradas pela aplicao.
21.1.7 Retentive
A propriedade Retentive determina se o valor deve ser armazenado no caso de troca do
servidor ativo. Assim, quando o servidor Standby for executado, o valor ser o mesmo do
servidor Hot que parou. Se esta propriedade estiver em False, o valor ser ajustado para o
valor inicial sempre que o Domnio for executado ou ocorrer troca do servidor ativo.
21.2 Exerccios
21.2.1 Retentive
Para exemplificar a diferena, vamos transformar os Tags de cor do Tanque1 (vermelho,
verde e azul) em retentivos e os Tags do Tanque2 em no-retentivos.
1. Selecione todos os Tags internos da pasta Tanque1 (vermelho, verde e azul) e altere a
propriedade Retentive para True.
182
Hot-Standby
21.2.2 Falha Local

1. Na pasta Dados, insira um Tag Interno chamado FalhaLocal.
2. Configure a propriedade Value para False (Boolean).
3. No Tag FalhaLocal, crie um evento de usurio chamado Falha que s ocorre quando o
valor do Tag verdadeiro.
Criar evento de usurio

4. No evento Falha, crie o seguinte script:
Application.ReportFailure "Falha", "Falha no servidor ativo", 1
Value = False
5. Busque, com o auxlio do AppBrowser, o evento ReportFailure do Servidor.

Application.ReportFailure(FailureName, FailureDescription, FailureWeight)
6. Altere o parmetro FailureName para "Falha", FailureDescription para "Falha no servidor

ativo" e FailureWeight para 1.
Application.ReportFailure "Falha", "Falha no servidor ativo", 1
7. Para o Tag retornar para o estado normal, digite na ultima linha a expresso "Value =
False".
Value = False
8. Na TelaMenu, insira um boto com o texto "Falha Local".

9. No boto, crie um Pick Carregar Valor.
Hot-Standby
183
Pick Carregar Valor

10.Busque a propriedade Value do Tag FalhaLocal e escolha o valor Booleano True.
Valor do Tag FalhaLocal
21.2.3 Sincronismo do Banco de Dados

1. No objeto BancoDados altere a propriedade EnableSynchronization para True.
21.2.4 Aplicao Standby

1. Copie a pasta da aplicao para o computador que ser o servidor Standby.
2. No servidor Standby, abra a aplicao no E3 Studio e configure o Banco de Dados para o SQL
Server local.
21.2.5 Configurao Hot-Standby

1. A partir do computador Hot ou do Standby, clique no cone do E3 Admin
Notificao do Windows e selecione o menu Domnio - Opes.
na rea de
2. Na aba Servidores, adicione dois servidores informando o nome que desejar e o nome do
computador na rede.
3. Na aba Opes, habilite o Hot-Standby e escolha um servidor como principal e outro como
backup.
4. Informe como ping de integridade o IP de um terceiro computador na rede.
5. Marque a opo Ativar backup em caso de falha local.
6. Execute a aplicao e teste as funcionalidades.
184
Hot-Standby
21.3.1 KB
Hot-Standby: Dvidas Mais Frequentes (FAQ).
KB-26057: Comportamento do Viewer durante troca de servidores.
Hot-Standby
185
21.4 Anotaes
186
Hot-Standby
CAPTULO
22
Domnios Remotos
A configurao de Domnios Remotos define que haver comunicao entre diferentes

servidores e Viewers, onde uma aplicao se destina a fornecer dados, e a outra a receb-los.
O Domnio que fornece dados a outro chamado de Domnio Servidor. J o Domnio que utiliza
estes dados chamado de Domnio Cliente. A configurao de um Domnio como Domnio
Cliente no impede que ele seja ao mesmo tempo um Domnio Servidor, e vice-versa.
NOTA: Domnios Remotos no esto disponveis em modo Demo.
Com a configurao de Domnios Remotos, o Domnio Cliente poder acessar objetos do

Domnio Servidor de duas maneiras, atravs de scripts ou de links. Para que a conexo entre
os Domnios possa ocorrer, todos os E3 Servers envolvidos devero estar rodando a mesma
verso do E3.
NOTA: a porta de conexo do REC e as possveis configuraes de firewall associadas

tambm se aplicam aos Domnios Remotos.
22.1 Configurao no Studio

No E3 Studio, para buscar os objetos existentes na aplicao do Domnio Remoto, pode-se
usar normalmente o AppBrowser, desde de que o caminho completo do arquivo do Domnio
tenha sido especificado corretamente no servidor remoto.
Outra possibilidade manter uma cpia do Domnio Remoto na mquina cliente, e colocar o
caminho da cpia no campo Arquivo de Domnio. Dessa forma, o E3 Studio vai utilizar a cpia
local para determinar quais objetos existem, permitindo o trabalho offline.
22.2 Compartilhamento da Pasta do Domnio Servidor

A partir da verso 3.0, onde est disponvel a funcionalidade de Domnios Remotos, o E3
Server roda sempre como um servio na conta SYSTEM. Servios que usam a conta SYSTEM
iniciam no contexto do sistema sem credenciais, ou seja, sem autenticao de usurio e
senha. Esses servios, rodando sem um domnio de rede Microsoft, e que queiram acessar
recursos da rede, tero acesso negado em funo de no terem credenciais e de estarem
utilizando uma sesso nula.
Domnios Remotos
187
22.2.1 Configuraes Gerais

As configuraes mostradas a seguir devem ser feitas na mquina que roda o Domnio
Servidor.
1. Se a mquina utiliza Windows 2000, 2003 ou Vista, acesse o painel de controle Ferramentas
Administrativas (Administrative Tools) - Diretiva de Segurana Local (Local Security Policy).
2. Na janela seguinte, acesse Diretivas Locais (Local Policies) - Opes de Segurana (Security
Options).
3. Desabilite a opo Acesso de rede: acesso annimo restrito a pipes nomeados e
compartilhamentos (Network Access: Restrict anonymous Access to Named Pipes and Shares).
Opes de Segurana
Se a mquina do Domnio Servidor utiliza Windows XP, a configurao deve ser feita
diretamente no Registro do Windows. Nesse caso, siga esses procedimentos.
1. Acesse a chave HKEY_LOCAL_MACHINE \ SYSTEM \ CurrentControlSet \ Services \
Lanmanserver \ parameters.
2. Crie a varivel RestrictNullSessAccess, do tipo DWORD, e coloque o valor 0.
188
Domnios Remotos
Varivel RestrictNullSessAccess
A configurao atravs do Registro do Windows tambm pode ser feita em Windows 2000,
2003 e Vista. Segundo a Microsoft, a chave RestrictNullSessAccess especifica se o
servidor vai limitar o acesso ao sistema por usurios logados sem autenticao de nome de
usurio e senha. Os valores possveis so:
0: Acesso sem autenticao permitido e todos os usurios podem acessar os recursos
compartilhados
1: No permite acesso sem autenticao. Os usurios sem autenticao podero acessar
apenas os diretrios listados na varivel NullSessionShares
Em qualquer um desses casos, ser necessrio reiniciar a mquina para que as alteraes
tenham efeito. Alm disso, necessrio configurar o compartilhamento e o NTFS para
aceitarem o acesso do usurio annimo (ANONYMOUS LOGON/LOGON ANNIMO) ou do
usurio de rede (NETWORK/REDE). Isso feito da seguinte maneira.
1. Selecione a pasta que contm o Domnio Servidor, e que dever estar compartilhada.
2. Clique com o boto direito do mouse sobre ela e selecione a opo Propriedades.
3. Na aba Compartilhamento, clique no boto Permisses.
Domnios Remotos
189
Propriedades da pasta
4. Adicione o usurio REDE ou o usurio LOGON ANNIMO, permitindo acesso para leitura
pasta e clicando aps no boto OK.
190
Domnios Remotos
Adicionar usurio
5. Acesse a aba Segurana, e adicione novamente o usurio REDE ou LOGON ANNIMO (o
mesmo que foi adicionado na aba Compartilhamento), clicando aps no boto OK.
Domnios Remotos
191
Aba Segurana
NOTA: Para que a comunicao entre as mquinas funcione corretamente em tempo de
execuo, o firewall deve ser configurado corretamente, ou desabilitado.
22.2.2 Aba Segurana

Em alguns casos, tambm pode ocorrer de a aba Segurana no estar visvel junto com a aba
Compartilhamento, nas propriedades da pasta. Isso ocorre porque em algumas verses de
Windows, como o XP, por exemplo, rodando sem pertencer a um domnio de rede Microsoft, o
modo de compartilhamento simplificado habilitado por padro. Nesse caso, preciso
trocar o modo de compartilhamento atravs da varivel ForceGuest na chave de registro,
em HKEY_LOCAL_MACHINE \ SYSTEM \ CurrentControlSet \ Control \ LSA. A varivel deve ser
ajustada para 0.
22.3 Licenas
Tanto o E3 Server rodando o Domnio Cliente quanto o que roda o Domnio Servidor devem ter
licenas especficas para Domnios Remotos. Quando essa licena existe, o E3 Server Servidor
passa a aceitar um nmero ilimitado de conexes externas de outros Domnios. Da mesma
forma, no caso do E3 Server Cliente, ser possvel estabelecer um nmero ilimitado de
conexes.
192
Domnios Remotos
22.4 Sintaxe dos Links

O acesso aos objetos de outro Domnio feito atravs do apelido (Nome do Domnio), que
deve preceder o caminho completo de cada objeto, separado por dois pontos. Por exemplo,
DOMINIO:CAMINHO, onde DOMINIO o apelido dado quela conexo com o Domnio
Remoto, e CAMINHO o caminho completo de um objeto ou propriedade daquele Domnio.
Por exemplo, Driver1.Tag1 + Remoto:Driver2.Tag1 * 2.
22.5 Alias Local

O Alias Local uma ferramenta do Elipse E3 que garante que a aplicao que ser servidora de
um Domnio Remoto seja configurada da melhor maneira para promover a migrao fcil,
rpida e confivel de um projeto para a aplicao remota.
Essa ferramenta permite a criao de um Domnio Remoto na aplicao local que aponte para
si mesmo, ou seja, aponte para o prprio Domnio e para a prpria mquina.
Alias local
Ao se configurar a aplicao, deve-se associar todos os objetos de Tela e scripts atravs do
Domnio Remoto adicionado.
Domnios Remotos
193
Associao atravs do Domnio Remoto

Assim, os links de todos os objetos de Tela ficam direcionados para os Tags e objetos de dados
da aplicao local, porm via Domnio Remoto.
22.6 Permisses de Acesso

O acesso aos objetos de um Domnio Remoto pode ser limitado ao modo Somente Leitura.
Quando isso ocorre, so aplicados os mesmo tipos de limitaes de acesso que se aplicam ao
Viewer Only. Para isso, usa-se a configurao de usurios na permisso Acesso remoto de
escrita ao Domnio, dentro do item de segurana Domnio. Com isso, pode ser necessrio que
a conexo com o Domnio Remoto especifique um determinado usurio para poder ter acesso
completo aos objetos do Domnio.
22.7 Exerccios
22.7.1 TelaRemota
1. Insira no projeto uma nova Tela chamada TelaRemota, a ser aberta no Divisor
Area_Central. Marque a Tela para ser a Tela inicial do divisor.
2. Na TelaMenu, insira um boto para chamar a TelaRemota.
194
Domnios Remotos
22.7.2 Compartilhamento
1. Compartilhe a pasta do projeto e faa as configuraes de permisso conforme a seo
Compartilhamento da Pasta do Domnio Servidor.
22.7.3 Alias Local

1. Acesse as opes do Domnio atravs do cone do E3 Admin na rea de Notificao do
Windows.
2. Na aba Domnios Remotos, insira um Domnio e configure as seguintes propriedades:
Nome do Domnio: Dominio_Local
Arquivo de Domnio: Arquivo .dom em desenvolvimento
Servidor principal: nome do computador atual na rede
Configurao do Domnio
3. Clique no boto Aplicar e finalize a configurao com o boto OK.
Domnios Remotos
195
4. Verifique no Organizer se aparece o projeto do Domnio configurado.
Projetos de Domnios Remotos

5. Na TelaRemoto, crie um Display para exibir os valores de um Tag qualquer. Busque, no
AppBrowser, o Tag dentro do Domnio Remoto Dominio_Local.
Tag no Domnio Remoto
22.7.4 Domnio Remoto

1. Acesse as opes do Domnio atravs do cone do E3 Admin na rea de Notificao do
Windows.
2. Na aba Domnios Remotos, insira um Domnio e configure as seguintes propriedades:
Nome do Domnio: Remoto1
Arquivo de Domnio: caminho do arquivo do Domnio Remoto. Este caminho deve ser
um compartilhamento na rede que permita acessar esse arquivo ou uma cpia local
Servidor principal: nome do computador remoto na rede
196
Domnios Remotos
Aba Domnios Remotos

3. Clique no boto Aplicar (Apply) e finalize a configurao com o boto OK.
4. Verifique no Organizer o Domnio Remoto e seus projetos.
Projetos dos Domnios

Remotos
5. Na TelaRemoto, crie um Display para exibir os valores de um Domnio Remoto. Busque,
no AppBrowser, um Tag dentro do Domnio Remoto Remoto1.
Domnios Remotos
197
Tag no Domnio Remoto

6. Crie um Display ou Setpoint para cada Tag que desejar e associe-os atravs do caminho de
Domnio Remoto.
TelaRemoto
7. Cadastre quantos Domnios Remotos desejar.
198
Domnios Remotos
22.8.1 KB
KB-26842: Unificando configuraes de usurios em vrios Domnios.
Domnios Remotos
199
22.9 Anotaes
200
Domnios Remotos
CAPTULO
23
Exerccios de Reviso
23.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
Exerc c ios de Reviso
201
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
202
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
203
23.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 especificado.
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.
204
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.
205
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.
206
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.
207
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-os 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).
208
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 nvel 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.
209
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"
210
23.3 Anotaes
211
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
9F., N.12, Beiping 2nd St., Sanmin Dist.
Fone: +49 (0) 6333-4439
807 Kaohsiung City - Taiwan
Fax: +49 (0) 6333-2790045
Fone: +886 (7) 323-8468
E-mail: elipse@elipse.de
Fax: +886 (7) 323-9656

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

E3tutorial Developer PTB PDF

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

E3tutorial Developer PTB PDF

Enviado por

Direitos autorais:

Formatos disponíveis

Tutorial do E3 para

2013 Elipse Software Ltda. Todos os direitos reservados.

2.1 Elipse Knowledgebase

2.2 Busca no Knowledgebase

3.1 Criando a Aplicao

3.2 Execuo de um Domnio

3.4 Exerccios Complementares

4.1 Regras para Nomes de Tags

6.1 Controles Microsoft Forms

6.4 Exerccios Complementares

7.1 Tipos de Associao

7.2 Valores Booleanos

8.1 Driver de Comunicao

8.2 Driver de Comunicao OPC

8.3 Exerccios Complementares

9.1 Definindo Scripts

9.6 Exerccios Complementares

10.6 Exerccios Complementares

11.1 Criao de Bibliotecas do Usurio

11.2 Quando Criar um ElipseX

11.4 Exerccios Complementares

12.2 Exerccios Complementares

13.1 Servidor de Alarmes

13.2 Configurao de Alarmes

13.5 Exerccios Complementares

14.1 Criando uma Consulta

14.4 Exerccios Complementares

15.1 Chave Primria

15.4 Exerccios Complementares

16.1 Configuraes das Penas

16.3 Exerccios Complementares

17.1 Objetos do Relatrio

18.2 Exerccios Complementares

19.3 Consultas Internas

19.5 Exerccios Complementares

20.1 Interface de Usurio do E3Playback

20.2 Restries e Comentrios

20.5 Exerccios Complementares

21.1 Configuraes do Hot-Standby

21.3 Exerccios Complementares

22.1 Configurao no Studio

22.2 Compartilhamento da Pasta do Domnio Servidor

22.4 Sintaxe dos Links

22.5 Alias Local

22.6 Permisses de Acesso

22.8 Exerccios Complementares

Uso de Bibliotecas ElipseX: poderosa ferramenta de bibliotecas funcionais disponvel

1.3.1 Aplicao de Treinamento

Tela principal da aplicao

Tela de consulta de Alarmes

2.1 Elipse Knowledgebase

Elipse Know ledgebase

Login: serve apenas para uso da Elipse

2.2 Busca no Knowledgebase

Elipse Know ledgebase

Elipse Know ledgebase

Elipse Know ledgebase

Caixa de dilogo inicial do E3 Studio

Inicia o E3 Studio, mas no abre nenhum

Criar um Domnio novo

Cria um novo Domnio atravs do Assistente

Abrir um Domnio existente

Abre um Domnio existente dentre os ltimos