E3tutorial Developer Portugues

Tutorial do E3
Desenvolvedores
Copyright 1999 - 2017 Elipse Software Ltda. Todos os direitos reservados.

Verso 4.8.239 (03/03/2017)
Sumrio
1 Apresentao ............................................................................................................................................... 1
1.1 A Elipse Software .................................................................................................................................... 1
1.2 Mdulos do E3 ....................................................................................................................................... 1
1.3 O Treinamento ....................................................................................................................................... 2
2 Elipse Knowledgebase ................................................................................................................................. 6
2.1 Elipse Knowledgebase ........................................................................................................................... 6
2.2 Busca no Knowledgebase ...................................................................................................................... 7
2.3 Categorias ............................................................................................................................................... 8
3 Iniciando a Aplicao .................................................................................................................................. 9
3.1 Criando a Aplicao ............................................................................................................................. 10
3.2 Execuo de um Domnio ................................................................................................................... 12
3.3 Exerccios .............................................................................................................................................. 12
3.4 Exerccios Complementares ................................................................................................................ 16
4 Simulao de Valores ................................................................................................................................ 17
4.1 Regras para Nomes de Tags ................................................................................................................ 17
4.2 Exerccios .............................................................................................................................................. 18
5 Estrutura de Telas e Quadros .................................................................................................................... 22
5.1 Viewer ................................................................................................................................................... 23
5.2 Exerccios .............................................................................................................................................. 25
6 Telas e Objetos de Tela .............................................................................................................................. 33
6.1 Tela ........................................................................................................................................................ 34
6.2 Controles Microsoft Forms .................................................................................................................. 35
6.3 Galeria ................................................................................................................................................... 36
6.4 Exerccios .............................................................................................................................................. 37
7 Associaes ................................................................................................................................................ 44
7.1 Tipos de Associao ............................................................................................................................. 44
7.2 Edio de Associaes ......................................................................................................................... 48
7.3 Valores Booleanos ............................................................................................................................... 48
7.4 Exerccios .............................................................................................................................................. 49
8 Comunicao ............................................................................................................................................. 53
8.1 Elipse Modbus Simulator ..................................................................................................................... 53
8.2 Driver de Comunicao ....................................................................................................................... 55
8.3 Driver de Comunicao OPC ............................................................................................................... 55
8.4 Exerccios .............................................................................................................................................. 56
9 Introduo aos Scripts ............................................................................................................................... 69
9.1 Definindo Scripts .................................................................................................................................. 69
9.2 Eventos .................................................................................................................................................. 77
I
9.3 Mtodos ................................................................................................................................................ 78
9.4 Propriedades ........................................................................................................................................ 79
9.5 Exerccios .............................................................................................................................................. 79
10 Segurana e Usurios .............................................................................................................................. 81
10.1 Usurios .............................................................................................................................................. 81
10.2 Grupos ................................................................................................................................................. 82
10.3 Permisses .......................................................................................................................................... 83
10.4 Proteo .............................................................................................................................................. 84
10.5 Exerccios ............................................................................................................................................ 85
10.6 Exerccios Complementares .............................................................................................................. 89
11 Configurao de Alarmes ....................................................................................................................... 91
11.1 Servidor de Alarmes .......................................................................................................................... 91
11.2 Configurao de Alarmes .................................................................................................................. 91
11.3 E3Alarm ............................................................................................................................................... 95
11.4 Exerccios ............................................................................................................................................ 95
11.5 Exerccios Complementares .............................................................................................................. 99
12 Bibliotecas ElipseX: XControls ............................................................................................................... 100
12.1 Criao de Bibliotecas do Usurio .................................................................................................. 101
12.2 Exerccios .......................................................................................................................................... 103
13 Bibliotecas ElipseX: XObjects ................................................................................................................ 110
13.1 Quando Criar um ElipseX ................................................................................................................ 110
13.2 Exerccios .......................................................................................................................................... 110
14 Tela Indexada ......................................................................................................................................... 116
14.1 Arquitetura da Informao ............................................................................................................. 117
14.2 Exerccios .......................................................................................................................................... 117
14.3 Exerccios Complementares ............................................................................................................ 119
15 Armazenamento de Dados ................................................................................................................... 120
15.1 Servidor de Alarmes ........................................................................................................................ 120
15.2 Histricos .......................................................................................................................................... 120
15.3 Chave Primria ................................................................................................................................. 121
15.4 ndices ............................................................................................................................................... 121
15.5 Exerccios .......................................................................................................................................... 122
16 Consultas ................................................................................................................................................ 133
16.1 Criando uma Consulta ..................................................................................................................... 134
16.2 E3Browser ......................................................................................................................................... 136
16.3 Exerccios .......................................................................................................................................... 136
17 Filtros na Consulta ................................................................................................................................. 139
17.1 Criando e Acessando Variveis ....................................................................................................... 139
17.2 Exemplo de Filtros ........................................................................................................................... 140
II
17.3 Exerccios .......................................................................................................................................... 141
18 Grficos e E3Chart ................................................................................................................................. 145
18.1 Configuraes das Penas ................................................................................................................. 146
18.2 Exerccios .......................................................................................................................................... 147
19 Relatrios ............................................................................................................................................... 153
19.1 Objetos do Relatrio ........................................................................................................................ 155
19.2 Exerccios .......................................................................................................................................... 156
20 Frmulas ................................................................................................................................................. 165
20.1 Exerccios .......................................................................................................................................... 165
21 Hot-Standby ........................................................................................................................................... 169
21.1 Arquitetura ....................................................................................................................................... 169
21.2 Configuraes do Hot-Standby ...................................................................................................... 169
21.3 Exerccios .......................................................................................................................................... 172
22 Domnios Remotos ................................................................................................................................ 175
22.1 Arquitetura ....................................................................................................................................... 175
22.2 Configurao no Studio .................................................................................................................. 176
22.3 Compartilhamento da Pasta do Domnio Servidor ....................................................................... 176
22.4 Licenas ............................................................................................................................................. 180
22.5 Sintaxe dos Links .............................................................................................................................. 180
22.6 Alias Local ......................................................................................................................................... 181
22.7 Permisses de Acesso ...................................................................................................................... 181
22.8 Exerccios .......................................................................................................................................... 182
23 Elipse Mobile .......................................................................................................................................... 188
23.1 Servidor ............................................................................................................................................ 188
23.2 Aplicativo .......................................................................................................................................... 188
23.3 Exerccios .......................................................................................................................................... 188
24 Exerccios de Reviso ............................................................................................................................ 197
24.1 Exerccio ............................................................................................................................................ 198
24.2 Resoluo .......................................................................................................................................... 201
III
CAPTULO
Apresentao
1
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 Software

Desde sua fundao em 1986, a Elipse Software vem desenvolvendo poderosas ferramentas computacionais voltadas
criao de sistemas industriais e de gerenciamento de energia.
Sediada em Porto Alegre e com filiais em So Paulo, Curitiba, Belo Horizonte, Rio de Janeiro e Taiwan, a Elipse
Software uma empresa brasileira com participao expressiva no mercado externo, atuando em pases como
Alemanha, ndia, Rssia, Sucia, Argentina e Chile, entre outros.
Durante estes anos de experincia, desenvolvemos um grande nmero de solues para as reas de saneamento,
infraestrutura, siderurgia, minerao, sade, alimentos e energia, fornecendo produtos para diversos tipos de
sistemas de automao.
O Elipse E3 um sistema de superviso e controle de processos desenvolvido para atender os atuais requisitos de
conectividade, flexibilidade e confiabilidade, sendo ideal para uso em sistemas crticos. Com uma arquitetura de
operao em rede que compe um verdadeiro sistema multicamadas, o software oferece uma plataforma de rpido
desenvolvimento de aplicaes, alta capacidade de comunicao e garantia de expanso, preservando os
investimentos. A soluo permite a comunicao com inmeros protocolos e equipamentos, podendo acomodar tanto
os sistemas locais quanto os geograficamente distribudos.
1.2 Mdulos do E3
Inicialmente, veremos que o E3 composto de quatro mdulos, descritos nos tpicos a seguir.
1.2.1 E3 Server
o Servidor de Aplicaes, onde os principais processos so executados, incluindo a comunicao em tempo real
com 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 processamento entre as
mquinas. Foi desenvolvido para ser executado sobre os sistemas operacionais Windows XP SP3, Windows XP x64
SP2, Windows Vista SP2, Windows 7 SP1, Windows 8, Windows 8.1, Windows 10, Windows Server 2003 SP2,
Windows Server 2008 SP2, Windows Server 2008 R2 SP1, Windows Server 2012 ou Windows Server 2012 R2.
1.2.2 E3 Studio
Ferramenta nica de configurao, agindo como plataforma universal de desenvolvimento. 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 SP3, Windows XP x64 SP2, Windows Vista SP2, Windows 7 SP1, Windows 8, Windows 8.1,
Windows 10, Windows Server 2003 SP2, Windows Server 2008 SP2, Windows Server 2008 R2 SP1, Windows Server
2012 ou Windows Server 2012 R2) ou com um navegador de Internet. Em ambos os casos, no necessrio instalar a
aplicao na mquina cliente, pois todos os componentes (Telas, Bibliotecas e controles ActiveX) so baixados e
registrados automaticamente.
1 Apresentao
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 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 deste Tutorial uma aplicao hipottica, que apresenta os recursos mais importantes do software
Elipse E3. Esta 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 se aprenda a utiliz-lo com autonomia para criar aplicaes.
Sua participao muito importante para ns. Ao final do treinamento, solicitaremos 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 deste Tutorial.
A Elipse Software deseja a voc um timo treinamento, e uma boa experincia de trabalho com o Elipse E3!
Apresentao 2
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.
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 mostra condies de alarme no caso de algum parmetro ultrapassar os limites estabelecidos
(como por exemplo, um aumento excessivo de temperatura).
Alarmes
Existe um procedimento de consulta dos alarmes, que permite visualizao e impresso dos dados de histricos.
3 Apresentao
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.
Apresentao 4
Domnio Remoto
1.3.2 Arquitetura do Treinamento

A arquitetura do treinamento contm um servidor conectado com CLPs na mesma rede Ethernet. Qualquer
computador na rede pode visualizar a aplicao.
Arquitetura do Treinamento
5 Apresentao
CAPTULO
Elipse Knowledgebase
2
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. Para acessar a pgina inicial do KB, utilize o endereo kb.elipse.com.br,
conforme mostra a figura a seguir.
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
Login: Serve apenas para uso interno da Elipse Software
Elipse Knowledgebase 6
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 clicar em Busca.
Busca no KB
Ainda existe a possibilidade de utilizar a Busca Avanada, que permite refinar a consulta. Para isto, clique em Busca
Avanada.
Busca Avanada
Na opo Busca Avanada o usurio pode digitar a palavra ou palavras que deseja buscar, filtrar por categoria
especfica, por autor e ainda pela classificao do artigo. Isto , se ele ajudou muito, apenas ajudou, ajudou pouco ou
no ajudou.
7 Elipse Knowledgebase
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, selecione a categoria que deseja buscar os artigos e clique em Ir.
Escolha de categorias
Todos os artigos da categoria selecionada so retornados como resultado da busca. importante ressaltar que toda
a base de conhecimento est dividida em duas categorias principais: Ingls e Portugus. Dentro destas categorias
existem vrias sub-categorias, cada uma delas tratando de um tema especfico. Acessando os artigos pela categoria
Portugus - Elipse E3, por exemplo, tem-se a tela da figura a seguir.
Categorias em portugus
Note que dentro de cada uma destas sub-categorias aparece um nmero. Este nmero indica a quantidade de artigos
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 Software
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
Elipse Knowledgebase 8
CAPTULO
Iniciando a Aplicao
3
Aps instalar o software, tem-se um grupo de programas chamado Elipse E3, com um cone para abrir o E3
Studio. Quando o E3 Studio inicia, abre-se uma caixa de dilogo com algumas opes do projeto.
Caixa de dilogo inicial do E3 Studio
As opes disponveis nesta caixa de dilogo esto descritas na tabela a seguir.
Opes disponveis na caixa de dilogo inicial do E3
OPO 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, que pede o nome e o caminho do
novo Domnio.
Abrir um Domnio existente Abre um Domnio existente dentre os ltimos editados.

Clicando em Outros arquivos, pode-se localizar um
Domnio em um diretrio especfico.
9 Iniciando a Aplicao
3.1 Criando a Aplicao
Para criar uma nova aplicao, utilize o Assistente de Aplicaes. Para isto, clique em 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. Estas bibliotecas
podem ser reutilizadas em diferentes projetos, mas mantm vnculos com a aplicao. Ou seja, se a biblioteca for
alterada, todos os objetos desta biblioteca so atualizados nos projetos automaticamente.
3.1.3 Configurao do Domnio

Armazena quatro tipos de informao: Opes de configurao do Domnio, lista de arquivos .prj e .lib, configuraes
dos servidores que rodam o Domnio e configuraes de segurana (usurios e permisses). Sem este arquivo, um
projeto no pode ser executado no E3. Este item visto mais adiante.
Iniciando a Aplicao 10
3.1.4 Organizer
O Organizer permite uma viso simples e organizada de toda a aplicao, ajudando na edio e configurao de
todos os objetos envolvidos na aplicao 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, organizados em
quatro grupos: Configurao, Bibliotecas de Objetos, Visualizao e Objetos de Servidor.
O modo Explorer mostra projetos e bibliotecas abertos no E3 Studio, pertencentes ou no ao Domnio. Os objetos
so mostrados no projeto ou biblioteca ao qual pertencem, ordenados alfabeticamente dentro de cada projeto ou
biblioteca.
3.1.5 Lista de Propriedades
A Lista de Propriedades uma janela que mostra todas as propriedades do objeto em uso, permitindo sua
configurao de forma simples e rpida. A Lista de Propriedades est disponvel no menu Visualizar - Lista de
Propriedades ou clicando em na barra de ferramentas Padro.
Lista de Propriedades
3.2 Execuo de um Domnio

Para executar ou visualizar um projeto no E3, necessrio que o Domnio seja colocado em execuo. Para isto,
existem as seguintes opes no E3 Studio:
Executar aplicativo: Salva todas as configuraes dos projetos e bibliotecas, inicia a execuo do Domnio 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 sua execuo
3.3 Exerccios
3.3.1 Criando uma Aplicao
1. Inicie o E3 Studio selecionando a opo Criar um Domnio novo. O Assistente de Aplicaes aberto.
Selecionar o tipo de aplicao
2. No Assistente de Aplicaes, 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.
Definir o Domnio
5. Selecione a resoluo da tela e clique em Avanar.
Definir a resoluo do Viewer
6. Responda No pergunta Voc deseja comunicar com um dispositivo/equipamento?. Este tema apresentado
em um captulo posterior.
Configurar um driver de comunicao
7. Responda No pergunta Voc quer guardar dados em disco?. Este tema apresentado em captulo posterior.
Configurar um banco de dados
8. Responda No pergunta Voc deseja monitorar alarmes em sua aplicao?. Este tema apresentado em
captulo posterior.
Configurar os alarmes
9. Clique em Concluir para gerar a aplicao.
10. Ao final destes procedimentos, tem-se acesso rea de trabalho do E3 Studio.
3.3.2 E3 Studio
1. Ao criar uma aplicao padro, automaticamente criada uma Tela com o nome "TelaInicial". Selecione esta Tela
e, na sua Lista de propriedades, selecione a cor de sua preferncia na propriedade BackgroundColor.
Propriedade BackgroundColor
2. Execute a aplicao clicando em na barra de ferramentas Padro.
3.4 Exerccios Complementares

3.4.1 KB
KB-28984: Tempo de execuo utilizando apenas licena de Studio
CAPTULO
Simulao de Valores
4
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 XFolders e XObjects, que so os objetos de dados das bibliotecas ElipseX (vistas mais
adiante). Alguns dos objetos que podem ser inseridos no Servidor de Dados esto descritos na tabela a seguir.
Objetos que podem ser inseridos no Servidor de Dados
OBJETO DESCRIO
Tag Contador Objeto que executa uma contagem de tempo (em
segundos) at atingir um valor pr-determinado, ou que
executa uma certa contagem de tempo 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 so executados pelo E3 Server, portanto esto presentes no Servidor.
Esta informao retrata o modo como o E3 trabalha.
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. Estes caracteres so trocados pelo
caractere sublinhado. Assim, o sistema aplica a Regra dos Colchetes, explicada a seguir
17 Simulao de Valores
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
Simulao de Valores 18
4.2.1 Simulao de Valores
Muitas vezes precisamos de valores que simulem os movimentos. Normalmente estes valores so reais e vm de Tags
de Comunicao, mas nos exerccios do Tutorial usaremos Tags do tipo Demo.
1. Para inserir um Tag Demo, localize no Organizer o item Objetos do Servidor e dentro dele o item Objetos de
Dados. Clique com o boto direito do mouse na pasta Dados e selecione o item Inserir - Panel - Tag Demo.
Inserir Tag Demo
2. Na pasta Dados, insira os Tags Demo com as propriedades configuradas conforme a tabela a seguir.
Propriedades dos Tags Demo
NAME DOCSTRING MINIMUM MAXIMUM PERIOD SCAN TYPE

Nivel1 Nvel do 0 100 2000 200 0 - Random
Tanque 1
Nivel2 Nvel do 0 100 2000 200 0 - Random

Tanque 2
Temp1 Temperatura 20 80 20000 500 1 - Sine

do Tanque 1
Temp2 Temperatura 20 80 10000 500 0 - Random

do Tanque 2
4.2.2 Tanques
A aplicao representa uma fbrica que utiliza como matria-prima as tintas vermelha, verde e azul, produzindo as
demais tintas como uma combinao destas trs.
1. Na pasta Dados, crie uma Pasta de Dados chamada "Tanque1" e insira trs Tags Internos: "Vermelho", "Verde" e
"Azul".
2. Configure o valor inicial dos trs Tags para Integer.
Selecionar tipo de dado
3. Crie uma cpia da pasta "Tanque1" para criar a pasta "Tanque2".
Pastas de Dados
Simulao de Valores 20
4.2.3 Tags no Viewer
Quando a informao (Tag) est no servidor, ela nica para todos os usurios da aplicao. Se a informao pode
ser diferente para cada usurio (por exemplo, o nome do usurio logado), esta informao deve ser salva no objeto
Viewer.
Vamos criar um Tag responsvel pelo movimento do balde sobre a esteira. Para que o movimento acontea,
precisamos de uma varivel que varie entre 0 e 100, linearmente. Como usaremos esta varivel apenas para animar
um objeto de Tela, criaremos um Tag Demo (simulao) no objeto Viewer.
1. Clique com o boto direito do mouse no Viewer e insira um Tag Demo com o nome de "Anima".
Criar Tag Demo no Viewer
2. Configure o Tag Anima com os seguintes valores:
Minimum: 0
Maximum: 100
Period: 5000
Scan: 100
Type: 6 - RampUpDown
CAPTULO
Estrutura de Telas e Quadros
5
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 tem valores que
definem explicitamente o seu posicionamento, ficando o Divisor Secundrio com o valor restante. Para utilizar este
recurso, siga estes procedimentos:
1. Clique com o boto direito do mouse no item Visualizao - Viewers e Quadros do Organizer e selecione a
opo Inserir Quadro em.
2. Para criar um Divisor, clique com o boto direito do mouse no Quadro aberto e selecione o tipo de diviso
(Dividir Horizontalmente ou Dividir Verticalmente).
Menu de diviso do Quadro
3. Arraste a barra de diviso com o mouse para a posio desejada e clique com o boto esquerdo do mouse para
fix-la.
Estrutura de Telas e Quadros 22

Quadros divididos horizontalmente e verticalmente
5.1 Viewer
O objeto Viewer configura o modo como o E3 Viewer visualizado.
O E3 Viewer pode rodar a partir de qualquer ponto da rede que tenha acesso ao E3 Server. No necessrio copiar
o aplicativo para as mquinas onde os E3 Viewers so executados, pois as Telas e bitmaps so trazidos do servidor
conforme a necessidade, em tempo de execuo.
NOTA
S pode existir um objeto Viewer em um Domnio.
Na aba Visualizador da Janela de Propriedades so definidas as configuraes de visualizao do Viewer.
23 Estrutura de Telas e Quadros

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

Na aba Erros de comunicao, pode-se configurar um padro para que os Displays e SetPoints de toda a aplicao
indiquem erros de comunicao.
Aba Erros de Comunicao
NOTA
Tambm possvel inserir Tags no Viewer.
5.2 Exerccios
A estrutura de Telas da aplicao dividida em trs partes: Um menu de navegao na parte superior, uma rea de
alarmes na parte inferior e uma rea central.

5.2.1 Quadros
1. Clique com o boto direito do mouse no item Viewer e Quadros e selecione a opo Inserir Quadro em -
TreinamentoE3.prj.
2. Na rea de visualizao do Quadro, clique com o boto direito do mouse e selecione a opo Dividir
Horizontalmente, conforme a figura a seguir.
Dividir Horizontalmente
3. Posicione a barra que aparece a cerca de 10% da Tela, a partir de seu limite superior, e clique com o boto
esquerdo do mouse para fixar a posio da barra.
4. Configure o tamanho do Divisor para "10%" na propriedade SplitValue.
NOTA
A propriedade SplitValue tambm pode ser configurada em pixels, utilizando o prefixo "px". Por exemplo, "100 px".
5. Nomeie a Diviso criada como "Area_Superior". Para trocar o nome de um objeto, existem trs opes:
Selecione o objeto no Organizer e pressione a tecla F2 para habilitar a edio do nome
Selecione o objeto no Organizer e, na Lista de Propriedades do objeto, altere a propriedade Name
Clique com o boto direito do mouse no objeto no Organizer e selecione a opo Renomear
6. Divida horizontalmente o Quadro inferior a cerca de 10% da Tela, a partir do limite inferior. Nomeie as Divises
como "Area_Central" e "Area_Inferior", respectivamente.
Divises do Quadro

7. Configure o Divisor Area_Inferior como Principal. Isto faz com que o E3 obedea ao tamanho do Divisor e o
restante da Tela o tamanho do Divisor Area_Central. Clique com o boto direito do mouse no Divisor
Area_Inferior e selecione a opo Configurar como Divisor Principal.
Configurar como Divisor Principal
8. Configure o tamanho do Divisor Area_Inferior em "10%" (propriedade SplitValue).

5.2.2 Tela Menu
A Tela de menu possibilita a navegao entre as Telas da aplicao, alm de exibir o horrio do sistema e o nome do
usurio logado.
1. Clique com o boto direito do mouse no item Telas e selecione a opo Inserir Tela em - TreinamentoE3.prj.
Inserir Tela
2. Selecione o item Area_Superior na opo Escolha o Divisor onde a Tela ser aberta. Isto faz com que a Tela seja
criada com o tamanho exato deste Divisor. Selecione a opo Configurar como Tela inicial do Divisor e, no
campo Nome, digite "TelaMenu".
Tamanho da Tela
5.2.3 Tela Alarmes

1. Crie a "TelaAlarmes" para ser aberta no Divisor Area_Inferior. Selecione a opo Configurar como Tela inicial do
Divisor.
2. Selecione um estilo de preenchimento para esta Tela.

5.2.4 Tela ou Quadro Inicial da Aplicao
Para testar a configurao do Quadro, vamos configur-lo para que aparea ao iniciar a aplicao.
1. Clique com o boto direito do mouse no item Visualizao - Viewer e Quadros - Viewer no Organizer para abrir
a janela de propriedades.
Propriedades do Viewer
2. Selecione o Quadro1 no campo Tela ou Quadro Inicial.

Opo Tela ou Quadro Inicial

5.3.1 Horrio do Sistema
Para obter o horrio corrente do sistema, necessrio criar um Tag Demo que acesse esta informao.
1. Clique com o boto direito do mouse no item Objetos de servidor - Objetos de Dados - Dados e insira um Tag
Demo com o nome de "Relogio". Configure a propriedade Type deste Tag para 3 - CurrentTime.
Adicionar Tag Demo
2. No canto direito da TelaMenu, insira um objeto Display para exibir o horrio do computador.
3. Abra a janela de propriedades deste objeto e selecione a aba Formatao. Defina o formato como Hora e, na
opo Tipo, selecione o item 13:06:03. Este formato mostra as horas, os minutos e os segundos.
4. Para visualizar a configurao feita no exerccio anterior, selecione a propriedade Value do Display e selecione o
item Date.
5. Abra a janela de propriedades do Display e clique na aba Associaes. Na propriedade Value, selecione na
coluna Fonte, usando o AppBrowser, o Tag Demo Relogio (em Servidor - Dados) e clique em Colar.

Aba Associaes do Display
6. Execute a aplicao e verifique as novas funcionalidades.

CAPTULO
Telas e Objetos de Tela
6
Telas so janelas para monitoramento de processos, onde so inseridos objetos que fazem parte da interface do
operador com o sistema. Cada aplicao pode ter um nmero ilimitado de Telas.
Os Objetos de Tela so elementos grficos que podem ser inseridos nas Telas para criar a interface visual com o
processo. Podem ser criados a partir da barra de ferramentas Objetos ou atravs do menu Objetos.
Uma vez selecionado o objeto que se deseja criar, mantenha o boto esquerdo do mouse pressionado na rea da
Tela enquanto movimenta o mouse (um retngulo pontilhado mostra o tamanho e a forma do objeto). Ao soltar o
boto, o objeto posicionado dentro da rea especificada.
33 Telas e Objetos de Tela

6.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 citados anteriormente
Pastas do Viewer, Consultas, Tags Contador, Demo, Interno e Timer
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, e a origem dada pelo canto superior
esquerdo da Tela.
As Telas podem ser abertas em modo Full Screen (Tela Cheia), ocupando toda a rea do Viewer, ou ainda como telas
modais, ocupando somente o tamanho de suas coordenadas de altura e de largura.
Tela
Telas e Objetos de Tela 34

6.2 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. Eles podem ser inseridos nas Telas da aplicao para
realizar diversas tarefas. A tabela a seguir contm a descrio destes objetos.
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 Utilizado para executar uma ao

Button) especfica ao pression-lo.
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 caixa de
rolagem.
Boto Incremento-Decremento Utilizado para incrementar e

(Spin Button) 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 - Gerenciar ActiveX.

6.3 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.
Galeria
NOTA
Ao executar o E3 Studio em modo Demo (sem licena), apenas o primeiro elemento de cada conjunto de categorias
de smbolos est disponvel.

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

6.4.1 Figuras Externas
Todas as figuras utilizadas nesta aplicao devem ser 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 selecione a opo Inserir Recurso em - TreinamentoE3.prj.
Inserir Recurso
2. Selecione todas as figuras da pasta C:\TreinamentoE3\Figuras.
6.4.2 Imagem de Fundo

1. Configure a propriedade FillStyle da TelaInicial para 12 - bkPicture, para habilitar uma figura de fundo.
2. Para colocar a figura FundoTelaInicial como fundo da Tela, 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.
3. Para escolher a melhor posio da figura, pode-se alterar a propriedade PicturePosition.
6.4.3 Texto
1. 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 no objeto e selecione o item Editar
texto.
2. No centro da Tela, posicione o Texto "Treinamento E3 Studio".
DICA
Utilize as opes Centralizar Horizontalmente e Centralizar Verticalmente.

3. Logo abaixo do Texto "Treinamento E3 Studio", insira um segundo Texto com a mensagem "Elipse Software Ltda".
4. Para executar a aplicao, clique em na barra de ferramentas Padro.
6.4.4 Tela Menu

1. Altere a propriedade FillStyle para 12 - bkPicture.
2. Arraste a imagem FundoTelaMenu para a propriedade Picture. Ajuste a imagem na propriedade PicturePosition.

6.4.5 Tela Sintico
Vamos trabalhar a Tela principal da aplicao.
Ao combinar a quantidade de vermelho, verde e azul, uma nova cor criada no tanque. A tinta depositada em um
balde que desliza pela esteira. As bombas, temperaturas e nveis so monitorados neste processo.
TelaSinotico
1. Clique com o boto direito do mouse na pasta Telas e selecione a opo Inserir Tela em - TreinamentoE3.prj.
Inserir Tela
2. Selecione a opo Configurar como Tela inicial do Divisor e, no campo Nome, digite "TelaSinotico". Configure
esta Tela para que seja aberta no Divisor Area_Central.

Configurar como Tela inicial
3. Responda Sim mensagem Deseja alterar esta configurao para 'TelaSinotico'?.
Mensagem
4. Na TelaSinotico, altere a propriedade FillStyle para 12 - bkPicture.
5. Arraste a imagem FundoTelaSinotico para a propriedade PictureFile.

6.4.6 SetPoint
1. Sobre os tanques de cores, insira SetPoints onde deve ser digitada a quantidade de cada componente de cor.
Habilite os limites do SetPoint, alterando a propriedade EnableLimits para Verdadeiro (True).
Configure a propriedade MaxLimit para "255" e a propriedade MinLimit para "0" (zero).
Configurando limites
6.4.7 Galeria
1. Sobre a esteira insira, a partir da Galeria, a figura 5GallonBucket, que est na pasta Tanks.
Esteira
6.4.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.4.9 Display
1. Ao lado de cada tanque, insira um Display .
2. Configure o valor inicial para exibir um valor Double, alterando a sua propriedade Value.
3. Formate o Display como Porcentagem e com uma casa decimal, alterando a sua propriedade Format.
4. Insira mais um Display ao lado do anterior para exibir a temperatura, formatado como "0.0 C" e uma casa
decimal.
Aba Formatao
5. Para executar a aplicao, clique em na barra de ferramentas Padro.

6.5.1 KB
KB-36216: Inserindo objetos na Galeria do E3

CAPTULO
Associaes
7
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 associaes para estas propriedades.
Aba Associaes
Pode-se associar um objeto ou criar uma expresso. Ao criar uma expresso ou associar um objeto ou propriedade
ao campo Fonte, o texto aparece na cor azul, caso este corresponda a um item existente ou carregado no E3 Studio.
Se o item no existir, ou pertencer a um mdulo no existente no Domnio, o texto aparece em vermelho, e este item
mostrado como um erro, at ser corrigido ou excludo com a opo Verificar Domnio.
7.1 Tipos de Associao

Esta seo contm informaes sobre os tipos de Associaes.
Associaes 44
7.1.1 Associao Simples
Na Associao Simples, o valor do campo Fonte copiado para a propriedade toda vez que a fonte modificada.
Associao Simples
7.1.2 Associao Bidirecional

Na Associao Bidirecional acontece o mesmo que na Associao Simples, porm caso tambm haja uma variao
na propriedade, seu valor copiado para o campo Fonte, gerando assim um caminho de duas direes.
Associao Bidirecional
45 Associaes
7.1.3 Associao Digital
J na Associao Digital possvel estabelecer que, caso a varivel ou expresso do campo Fonte seja uma
propriedade digital, seus estados Verdadeiro e Falso so mapeados para certos valores no destino, incluindo a opo
de Pisca (alternncia de valores).
Associao Digital
7.1.4 Associao Analgica

A Associao Analgica permite estabelecer uma escala de converses entre a varivel fonte e a varivel destino.
Atravs de quatro valores especificados, feita uma escala linear entre os valores da propriedade e os valores da
fonte.
Associao Analgica
Associaes 46
7.1.5 Associao por Tabela
Na Associao por Tabela, pode-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 estas condies.
Associao por Tabela
7.1.6 Associao Reversa

A Associao Reversa uma Associao unidirecional do objeto para a fonte.
Associao Reversa
47 Associaes
7.1.7 Associao Mltipla
Na Associao Mltipla, cada linha da Associao permite buscar o valor de uma fonte diferente. A fonte ativa
selecionada de acordo com o valor da fonte principal da Associao.
Associao Mltipla
7.2 Edio de Associaes

O E3 possui uma ferramenta chamada Editar Associaes, onde possvel mudar uma ou mais Associaes criadas
na aplicao de forma mais rpida do que pela janela tradicional. O acesso a esta ferramenta pode ser feito clicando-
se com o boto direito do mouse em um ou mais objetos e selecionando a opo Editar Associaes.
Janela Editar Associaes
7.3 Valores Booleanos

Em VBScript, 0 (zero) considerado como Falso e qualquer valor diferente de zero considerado Verdadeiro.
Considere, por exemplo, um Tag que representa uma entrada ou sada digital, portanto seus valores so 0 (zero) ou 1
(um). Ao usar o valor do Tag para Associaes com propriedades do tipo Boolean, o E3 considera:
Valor do Tag para tipos Boolean
TAG VBSCRIPT
0 Falso
1 Verdadeiro
Associaes 48
Ao utilizar o comando NOT, o E3 considera:
Valor do Tag com NOT
TAG NOT TAG VBSCRIPT

0 -1 Verdadeiro
1 -2 Verdadeiro
Portanto, NOT de 1 (um) no Falso, pois seu valor no igual a 0 (zero). Caso deseje utilizar o comando NOT,
primeiro converta o valor do Tag para Boolean com o mtodo CBool.
Converso de Tags com CBool
TAG CBOOL(TAG) NOT CBOOL(TAG)

0 Falso Verdadeiro
1 Verdadeiro Falso
Uso do mtodo CBool
Outra opo seria trabalhar com a propriedade Bit00 do Tag, que j uma propriedade do tipo Boolean, ao invs
de trabalhar com a propriedade Value do Tag.
Uso da propriedade Bit00
7.4 Exerccios
7.4.1 Associao Simples
Nvel do Tanque
1. Para simular o movimento do lquido do tanque na TelaSinotico, crie uma Associao entre a propriedade
VerticalPercentFill do corte do tanque e a propriedade Value do Tag Nivel1.
Propriedade VerticalPercentFill
2. Repita o procedimento do item anterior para o Tag Nivel2.
Temperatura do Tanque
3. Crie uma Associao no Display de temperatura de cada tanque com o seu respectivo Tag.
Propriedade Value
49 Associaes
7.4.2 Associao Analgica
1. O valor do Tag Nivel1 varia de 0 a 100, enquanto a formatao do tipo Porcentagem exibe valores de 0 (zero) a
1 (um). Para aplicar uma escala ao valor, insira uma Associao Analgica no Display que exibe numericamente a
varivel Nivel1.
Associao Analgica
7.4.3 Associao por Tabela

O Display que exibe o nvel deve alterar a cor de fundo, conforme a tabela a seguir.
Cor de fundo do Display
MNIMO MXIMO COR

0 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.
Associao por Tabela
Associaes 50
7.4.4 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 selecione a
opo Copiar Associaes.
Opo Copiar Associaes
2. No Display que deseja formatar, clique com o boto direito do mouse e selecione a opo Colar Associaes.
3. Se j existir alguma Associao neste objeto, abre-se uma caixa de dilogo para escolher se deseja ignorar ou
sobrescrever.
Ignorar ou sobrescrever Associao
4. Altere a referncia do Tag Nivel1 para o Tag Nivel2.
51 Associaes
7.4.5 Associao Bidirecional
1. Para cada SetPoint na TelaSinotico, crie uma Associao Bidirecional com o seu Tag respectivo, Vermelho, Verde
e Azul.
7.4.6 Expresso
1. Para poder modificar a cor do lquido, crie a Associao mostrada na figura a seguir no objeto Retngulo do
Tanque 1.
Associao com uma expresso
2. Selecione no AppBrowser o mtodo RGB do VBScript.
3. Substitua as palavras "Red", "Green" e "Blue" pelos Tags Vermelho, Verde e Azul, respectivamente.
DICA
Trabalhe com os comandos Copiar (CTRL + C) e Colar (CTRL + V). Para editar uma Associao criada anteriormente,
use a tecla F2.
4. Repita os procedimentos anteriores para o segundo tanque.
7.4.7 Animao
1. Selecione o objeto Galo e clique em para inserir uma Animao com Translao. Uma sombra do objeto
aparece. Mova-a at onde desejar.
Animao com Translao
O incio do movimento representa a posio 0 (zero), e o final a posio 100.
2. Clique com o boto direito do mouse na Animao e abra sua janela de propriedades. Crie uma Associao na
propriedade Value com o Tag Anima.
Associao na propriedade Value
3. Altere as propriedades Enabled e EnabledSlider da Animao para Falso.
Associaes 52
CAPTULO
Comunicao
8
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 necessrio. Os
Drivers de Comunicao e Servidores OPC funcionam neste 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 Elipse Modbus Simulator

O Elipse Modbus Simulator um gerador de valores aleatrios para aplicaes compatveis com os protocolos
Modbus RTU e Modbus TCP. Alm disto, tambm permite receber mensagens de escrita feitas por estas aplicaes.
O programa pode ser baixado no site da Elipse.
Quando o Simulador iniciado, abre-se a rea de trabalho, mostrada na figura a seguir.
Janela principal do Elipse Modbus Simulator
As opes disponveis na janela principal esto descritas na tabela a seguir.
Opes disponveis na janela principal do Elipse Modbus Simulator
OPO DESCRIO
PLCs Quantity Nmero de PLCs simulados. NOTA: Na verso Demo
este campo tem um limite de 10 PLCs.
Initial Port Porta base utilizada para a comunicao.
Random Values Habilita ou desabilita a gerao aleatria de valores.
Interval (ms) Intervalo de variao dos valores, em milissegundos.
Connection Tipo de conexo a simular (atualmente a nica opo

disponvel TCP/IP).
53 Comunicao
OPO DESCRIO
Protocol Protocolo a simular (Modbus RTU ou Modbus TCP).
COILS Nmero de Coils a ser simulado por PLC (limite mximo

de 255).
REGISTERS Nmero de Registers a ser simulado por PLC (limite

mximo de 255).
Aps selecionar a quantidade de PLCs e a porta inicial, inicie a simulao clicando em Start.
8.1.1 Quantidade de PLCs

O Simulador cria os PLCs nas portas consecutivas ao valor configurado no campo Initial Port. Por exemplo, ao
configurar trs PLCs a partir da porta 502, o primeiro PLC est disponvel na porta 502, o segundo na porta 503 e o
terceiro na porta 504.
Quantidade de PLCs
NOTA
Os PLCs criados consecutivamente ao valor configurado no campo Initial Port utilizam somente portas disponveis.
No exemplo anterior, se a porta 503 estiver em uso por outra aplicao, so criados PLCs nas portas 502, 504 e 505.
8.1.2 Memrias
O Simulador prev 30 registros digitais (Coils) e 20 registros analgicos (Registers). permitida a escrita de valores
diretamente no Simulador, atravs da coluna Value dos grids respectivos, quando a variao de valores para o PLC
estiver desligada.
Com a opo Random Values selecionada, so gerados valores aleatrios em todas as memrias a cada dois
segundos, conforme definido no campo Interval. O endereo de cada PLC sempre 1 (Device ID).
8.1.2.1 Coils
Coils so memrias digitais disponveis para leitura atravs da funo Modbus 01 (Read Coil Status) e escrita atravs
da funo Modbus 05 (Force Single Coil).
Comunicao 54
8.1.2.2 Registers
Registers so memrias analgicas que variam de 0 a 65535 (Word). Esto disponveis para leitura atravs da funo
Modbus 03 (Read Holding Registers) e para escrita atravs da funo Modbus 06 (Preset Single Registers) ou da funo
Modbus 16 (Preset Multiple Registers).
8.2 Driver de 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 respeito da configurao de seus parmetros [P] e outras propriedades. Os tipos de
objetos de Driver disponveis para comunicao so descritos na tabela a seguir.
Objetos disponveis no Driver de Comunicao
OBJETO DESCRIO
Pasta Define grupos e subdiretrios para a organizao de
variveis. No tem relao direta com o equipamento
de campo.
Tag de Comunicao Utilizado para definir a comunicao com uma varivel

(um endereo de memria) do equipamento de
aquisio.
Bloco de Comunicao Utilizado para definir a comunicao com diversas

variveis (vrios endereos de memria em sequncia)
do equipamento de aquisio.
Elemento de Bloco 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).
8.3 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. Neste caso necessrio conhecer o ItemId de cada
Tag.
Objetos disponveis no Servidor OPC
OBJETO DESCRIO
Pasta OPC Define grupos ou subdiretrios para a organizao das
variveis.
Grupo OPC Agrupa uma srie de Tags OPC que compartilham os

mesmos parmetros de atualizao (tempo de
varredura e banda morta). obrigatrio existir um
Grupo OPC para poder criar Tags OPC.
Tag OPC Objeto para leitura ou escrita de valores em um

equipamento. A leitura do Tag feita automaticamente
pelo Servidor OPC, com tempo de varredura definido no
Grupo OPC onde ele est inserido.
55 Comunicao
OBJETO DESCRIO
Bloco OPC Possibilita a leitura ou escrita de um conjunto de valores.
Para realizar 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 este objeto est sempre associado
posio definida por sua propriedade Index,
correspondendo a uma varivel de interesse.
8.4 Exerccios
Comunicao 56
8.4.1 Driver de Comunicao
Para comunicar o Elipse Modbus Simulator com o E3 utilizado o arquivo de Driver Modbus.dll, disponvel para
download em www.elipse.com.br.
1. Clique com o boto direito do mouse no item Objetos de Servidor - Drivers e OPC e selecione a opo Inserir
Driver de Comunicao em TreinamentoE3.prj.
Inserir Driver de Comunicao
2. Selecione o arquivo do Driver (Modbus.dll) na caixa de dilogo para a seleo de arquivos. A janela da figura a
seguir aberta para configurao do Driver.
57 Comunicao
Aba Operations
3. Na aba Setup, configure o tempo que o Driver aguarda uma resposta do equipamento no campo Timeout (por
exemplo, 1000 ms). Selecione, na lista de opes da propriedade Physical Layer, a interface fsica Ethernet.
Aba Setup
Comunicao 58
4. Aps selecionar a interface fsica, todas as outras abas so desabilitadas, sendo necessrio apenas configurar a
interface escolhida. Na aba Ethernet, digite o IP do computador que est executando o Simulador. Se o Simulador
est no mesmo computador do E3, digite "127.0.0.1".
Aba Ethernet
5. No campo Port, digite o nmero da porta de comunicao. Por exemplo, digite "502" para acessar o primeiro CLP
do Simulador.
6. Na aba Modbus, selecione o protocolo Modbus TCP no campo Modbus Mode e, no campo Data Address
Model Offset, selecione o item Data is address from 1, pois o primeiro endereo do Simulador 1 (um).
59 Comunicao
Aba Modbus
7. Na aba Operations, verifique o cdigo das operaes para leitura e escrita que so necessrias para as leituras
dos registros do CLP:
Registers: Leitura de valores analgicos (Word) atravs da funo Modbus 03 (Read Holding Registers) e para
escrita atravs das funes Modbus 06 (Preset Single Registers) ou Modbus 16 (Preset Multiple Registers). A
operao 01 executa a leitura Modbus 03 (Read) e escrita Modbus 16 (Write) de valores do tipo Word (Data).
Coils: Leitura de valores digitais (Bit) atravs da funo Modbus 01 e escrita atravs da funo Modbus 05
(Force Single Coil). No existe na lista padro uma operao com estas configuraes, portanto necessrio
adicionar uma nova.
8. No lado direito da aba Operations, clique em Add para criar a operao 08. Selecione a opo 01 na lista de
opes do campo Read e, no campo Write, a opo 05.
Adicionar operao
9. A lista de operaes disponveis mostrada na figura a seguir.
Comunicao 60
Lista de operaes
10. Estes cdigos de operao so utilizados posteriormente na configurao dos Tags de Comunicao:
Coils: Cdigo de operao 08
Registers: Cdigo de operao 01
11. Aps concluir a configurao, clique em OK.
12. Caso precise configurar novamente o Driver, clique com o boto direito do mouse no objeto Driver e selecione o
item Configurao.
Menu Configurao
61 Comunicao
8.4.2 Tag Browser
1. Caso a caixa de dilogo do Tag Browser no abra automaticamente, abra-a clicando em .
2. Na janela Tag Browser, arraste para a esquerda o Bloco de Comunicao IO.IOKitEvent da pasta General. Este
Bloco retorna informaes de estado da comunicao.
Janela Tag Browser
3. Feche a janela quando terminar de selecionar as variveis desejadas.
Comunicao 62
8.4.3 Tag de Comunicao
1. Clique com o boto direito do mouse no objeto Driver e selecione a opo Inserir - Tag de Comunicao, ou
clique em Adicionar na barra de ferramentas do Driver.
Adicionar Tag de Comunicao
2. A janela de configurao aberta. Informe a quantidade e o nome do Tag de Comunicao (por exemplo,
"Estado1").
Configurao do Tag
3. Para configurar os Tags de Comunicao, necessrio preencher as propriedades N1, N2, N3 e N4, conforme as
instrues do manual do Driver Modbus:
N1: Endereo do equipamento escravo (CLP) na rede. Este endereo pode variar entre 1 e 255
N2: Cdigo da operao. Referencia uma operao de leitura ou escrita adicionada na janela de configuraes
do Driver
N3: Parmetro adicional
N4: Endereo do Registrador ou da varivel no equipamento escravo (CLP) que se deseja ler ou escrever
63 Comunicao
8.4.3.1 Digital
1. Para organizar os Tags, selecione o Driver e insira uma pasta chamada "Digitais".
Adicionar Nova Pasta
2. O primeiro Tag Digital a informao de estado (aberto ou fechado) da Bomba 1. Crie um Tag de Comunicao
com o nome "Estado_B1" na pasta Digitais.
3. Configure os parmetros N conforme as informaes a seguir:
N1: 1 (Endereo do CLP)
N2: 8 (Cdigo da operao, ou Coil)
N3: 0 (Parmetro adicional)
N4: 1 (Endereo do registrador)
4. Clique com o boto direito do mouse no objeto Driver e selecione o item Ativar Comunicao para testar as
configuraes, ou clique em Ativar ou Desativar a Comunicao . Caso as configuraes estejam corretas, a
linha do Tag deve ficar na cor azul.
5. Adicione, na pasta Digitais, os Tags a seguir:
Endereo 2: Estado_B2
Endereo 7: AutoMan_B1
Endereo 13: Defeito_B1
Comunicao 64
6. Aps a criao dos Tags, teste a comunicao.
Ativar a Comunicao
8.4.3.2 Analgico
1. Insira uma nova pasta chamada "Analogicas".
2. Na pasta Analogicas, crie os Tags a seguir:
Endereo 1: Temperatura_T1
Endereo 2: Temperatura_T2
Endereo 3: Nivel_T1
Endereo 4: Nivel_T2
3. Configure os parmetros N conforme as informaes a seguir:
N1: 1 (Endereo do CLP)
N2: 1 (Cdigo da operao, ou Register)
N3: 0 (Parmetro adicional)
N4: 1 a 4 (Endereo do registrador)
4. Clique com o boto direito do mouse no objeto Driver e selecione o item Ativar Comunicao para testar as
configuraes, ou clique em Ativar ou Desativar comunicao . Caso as configuraes estejam corretas, a linha
do Tag deve ficar na cor azul.
65 Comunicao
8.4.3.3 Escala
O Simulador gera valores analgicos entre 0 e 65535. Desejamos valores em outra faixa, por isto vamos habilitar a
funo de escala.
Valores para a funo de escala
ENDEREO NOME MN. UE MX. UE UE MN. E/S MX. E/S

1 Temperatura_T 20 200 C 0 65535
1
2 Temperatura_T 20 200 C 0 65535

2
3 Nivel_T1 0 100 % 0 65535
4 Nivel_T2 0 100 % 0 65535
1. Altere as propriedades dos Tags Analgicos, conforme a figura a seguir.
Configurao da escala
2. Teste a comunicao. A coluna Valor j exibe os valores com a escala aplicada e a coluna Valor (sem escala)
apresenta os valores enviados pelo equipamento.
Testando a comunicao
Comunicao 66
8.5.1 Driver de Comunicao OPC
O E3 funciona tanto como servidor quanto como cliente OPC. Assim como no exerccio anterior, este exerccio serve
para mostrar como funciona a configurao do Driver OPC, j que semelhante para qualquer servidor OPC que
esteja sendo utilizado. O roteiro est descrito nos passos a seguir.
1. Clique com o boto direito do mouse no item Objetos de Servidor - Drivers e OPC e selecione o item Inserir
Driver de Comunicao OPC em - TreinamentoE3.prj.
2. Clique com o boto direito do mouse no Driver OPC inserido, selecione a opo Propriedades e clique na aba
OPC Driver.
3. Clique em Selecionar para abrir uma janela com as opes de servidores OPC na mquina local ou na rede.
Selecione o Elipse OPC Server da mquina do instrutor na opo Servidores na rede e clique em OK.
4. Ao voltar janela de propriedades do Driver OPC, clique em Ativar Comunicao. A partir deste ponto, possvel
verificar a comunicao com o servidor clicando em Informaes.
5. O prximo passo para a configurao a importao de Tags. Feche a janela de propriedades e clique com o
boto direito do mouse no Driver OPC cadastrado e selecione a opo Importar Tags. Com isto, o Assistente de
Importao de Tags do E3 aberto.
Janela Importao de Tags OPC
6. A figura anterior mostra a aparncia da janela de importao. Do lado direito a lista de Tags do servidor e do
lado esquerdo, a rea de importao para o E3. Para importar, primeiro ajuste os filtros, selecione o item e
arraste-o at o Grupo OPC de destino.
7. Depois de importar alguns Tags ou propriedades, verifique o funcionamento dos Tags importados.
8. Assim como no caso da configurao de Drivers da Elipse, o roteiro para trabalhar com o servidor OPC da Elipse
o mesmo para qualquer servidor que seja utilizado.
67 Comunicao
8.5.2 KB
KB-14918: Contagem de Tags no Driver de Comunicao
Comunicao 68
CAPTULO
Introduo aos Scripts
9
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 os 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 disto 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 est 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 podem ser realizadas com scripts atravs de
assistentes (wizards) chamados Picks. Pode-se definir que um determinado evento executa um script, um Pick ou uma
combinao deles, em uma sequncia definida durante a criao do script (no E3 Studio).
69 Introduo aos Scripts

9.1.1 Executar Scripts
Permite a edio de um script personalizado que executado na ocorrncia do evento determinado.
Executar Script
9.1.2 Picks
Os Picks implementam uma forma amigvel de realizar procedimentos comuns em scripts, poupando tempo de
escrita de cdigo. Entre eles esto aes como troca de Tela ou atribuio de valores, que so bastante comuns na
criao de um projeto.
Introduo aos Scripts 70

9.1.2.1 Abrir Tela
Abre uma determinada Tela ou Quadro.
Pick Abrir Tela

9.1.2.2 Abrir Tela Modal
Abre uma Tela em estilo modal.
Pick Abrir Tela Modal

9.1.2.3 Executar Aplicao
Executa um programa especfico.
Pick Executar Aplicao

9.1.2.4 Carregar Valor
Carrega um valor em um Tag.
Pick Carregar Valor

9.1.2.5 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.2.6 Imprimir Relatrio
Permite imprimir um Relatrio em uma Tela ou em uma impressora.
Pick Imprimir Relatrio

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 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. Estes eventos so acessados atravs da aba Scripts, disponvel no Editor do objeto para o qual se
deseja criar 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 a 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 ao clicar em Criar evento do usurio .
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 (AddObject) e outro para o seu fechamento (Close). Por estarem encapsulados, isto ,
guardados dentro dos objetos, na chamada de um mtodo sempre deve constar a qual objeto este mtodo se refere.
Muitos mtodos pr-definidos possuem parmetros, que podem (ou devem) ser passados na sua chamada. Para isto,
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 Tutorial servem apenas como
indicativo para diferenci-los das propriedades. Nos scripts, deve-se seguir esta regra.
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 sua largura e altura, respectivamente, entre outras. Para acessar as propriedades, proceda como no tpico
Mtodos, porm selecione a pasta Propriedades no AppBrowser.
9.5 Exerccios
9.5.1 Pick Abrir Tela
Vamos implementar a navegao entre as Telas da aplicao. A TelaInicial deve abrir o Quadro1 e cada boto na
TelaMenu deve abrir sua respectiva Tela no Quadro Area_Central ou em tela cheia.
1. Configure a TelaInicial para ser a primeira Tela da aplicao. Isto pode ser feito de duas formas:
Ajustando a Tela ao Divisor _top e selecionando a opo Configurar como Tela inicial do Divisor
Selecionando a TelaInicial no item Tela ou Quadro inicial da janela de propriedades do Viewer
2. Na TelaInicial, selecione o texto "Entrar" e selecione a aba Scripts.
3. No evento Click, crie um novo Pick do tipo Abrir Tela.
4. No campo Abrir a Tela, selecione o item Quadro1.
5. Deixe a opo No Quadro em branco.
9.5.2 Script
Na TelaInicial pode-se fechar a aplicao ao clicar no texto "Sair".
1. Na TelaInicial, crie um novo script no texto "Sair".
Script
2. Com o auxlio do AppBrowser , selecione o mtodo Exit do Viewer e clique em Colar.

Application.Exit
3. Execute a aplicao e teste as novas funcionalidades.

9.5.3 Tela Menu
1. Insira um objeto Command Button e, na sua propriedade Caption, digite o texto "Inicial".
2. Crie um script no evento Click para abrir a TelaInicial ocupando toda a rea (tela cheia).
Abrir Tela Inicial
3. Crie um segundo boto para abrir a TelaSinotico no Quadro Area_Central.
Abrir Tela Sintico

9.6.1 KB
KB-25172: Teclas de atalho no E3

CAPTULO
Segurana e Usurios
10
O E3 possui um controle de acesso s Telas, aos Alarmes e aos Domnios em uma lista de usurios, onde para cada
nome atribuda uma senha e um login. Conforme a opo configurada, uma aplicao permite acesso aos usurios
cadastrados ou acesso ilimitado s Telas do projeto.
10.1 Usurios
Atravs da opo Usurios possvel configurar as informaes referentes aos usurios que tm ou no acesso
aplicao. Para utilizar este recurso, selecione o menu Arquivo - Usurios e clique na aba Usurios.
Aba Usurios
IMPORTANTE
Aps configurar a segurana, somente os usurios listados tm acesso aplicao.
81 Segurana e Usurios
10.2 Grupos
A opo Grupos permite que sejam criados grupos com caractersticas que so comuns para todos os seus membros
(usurios). Um grupo tambm pode pertencer a outros grupos. S no permitido pertencer a outro grupo que
pertena a ele, ou seja, uma referncia circular. Para utilizar este recurso, selecione o menu Arquivo - Usurios e
clique na aba Grupos.
Aba Grupos
Segurana e Usurios 82
10.3 Permisses
A aba Permisses configura as permisses dos usurios e grupos para Domnios, Viewers, Telas e Alarmes. 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, independente do grupo ao qual pertence. Desta forma, ele no vai
levar em considerao a informao do grupo. Tambm pode-se optar por sempre utilizar a informao definida pelo
grupo. Se as informaes dos grupos forem conflitantes, usada a seguinte ordem de preferncia: Negar Afirmar
Indiferente.
Aba Permisses
10.4 Proteo
O E3 possui uma ferramenta de proteo de projetos ou de bibliotecas. Atravs deste item possvel proteger o
contedo do arquivo contra a edio, a visualizao ou a execuo no autorizada. Para utilizar este recurso, clique
com o boto direito do mouse no nome do projeto no Organizer e selecione a opo Proteo.
Proteo de arquivo
Esta opo possui dois tipos de proteo: Edio e Execuo.
Proteo de Edio: Protege o arquivo contra alteraes e visualizaes no autorizadas. Este 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 destes
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.
Isto protege o desenvolvedor de cpias no autorizadas do projeto, por exemplo.
Quando um arquivo .lib ou .prj aberto no E3 Studio, este inicializa mostrando um cone cinza com um cadeado,
indicando que est protegido e este contedo no pode ser acessado. Para acessar o contedo do arquivo, clique
com o boto direito do mouse neste cone e selecione a opo Abrir com senha. Aps informar a senha e liberar o
acesso, o cone se torna colorido , indicando a acessibilidade dos arquivos.
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. Isto garante o acesso ao arquivo sempre
que necessrio.
10.5 Exerccios
A seguir, veremos como configurar usurios em um Domnio no E3 e como utilizar este 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. Selecione 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.
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 o reconhecimento de alarmes para o grupo Operadores.
Permisses de grupos
2. Nas permisses de usurios, d permisso para um dos usurios do grupo Operadores reconhecer os alarmes
bloqueados para o grupo.
Permisses de usurios
10.5.3 Login
1. Na Tela_Menu, insira um objeto Command Button e modifique a propriedade Caption para "Login". Crie um novo
Pick do tipo Script no evento Click.
2. Selecione no AppBrowser o mtodo Login do Viewer e clique em Colar.
10.5.4 Usurio Logado

1. No Display que exibe o nome do usurio, associe a propriedade Value do Display com a propriedade User do
Viewer.
Usurio logado no Viewer
10.5.5 Administrao de Usurios

Desejamos criar, apagar e editar usurios em tempo de execuo. Somente usurios configurados como
administradores (opo Este usurio um administrador) tm acesso a este recurso.
1. Insira um objeto Command Button na TelaMenu com o texto "Usurios".
2. Neste boto, crie o seguinte script no evento Click:

'Administrao de usurios
Application.UserAdministration()
3. Com o auxlio do AppBrowser, selecione o mtodo UserAdministration do Viewer.
10.5.6 Registro de Eventos
1. Clique com o boto direito do mouse no cone do E3 na rea de Notificao do Windows e selecione a opo
Domnio - Opes.
Menu Domnio - Opes
2. Na aba Segurana, configure as opes conforme a figura a seguir.
Aba Segurana
NOTA
Configuraes de segurana no so aplicadas aos usurios j existentes, apenas ao alterar ou criar um usurio.
3. Selecione a aba Registro de Eventos e configure-a 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.1 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 esta funcionalidade, primeiro precisamos saber se o usurio pertence ou no ao grupo com
restries. Esta 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 item Visualizao - Viewer e Quadros - Viewer e insira um Tag Interno
com o nome de "TagAdmin".
TagAdmin
2. No evento OnLogin do Viewer, insira o seguinte script:

'Verifica se o usurio pertence ao grupo Manuteno
Item("TagAdmin").Value = IsUserMemberOfGroup("Manuteno")
3. Na TelaInicial, crie uma Associao na propriedade Visible do texto Sair com o Tag TagAdmin. Somente
usurios do grupo Manuteno podem visualizar este objeto.
10.6.2 KB
KB-32881: Abrindo a janela de administrao de usurio em tempo de execuo
CAPTULO
Configurao de Alarmes
11
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 so tratados
Configurao de Alarmes: Neste objeto os alarmes a serem tratados so criados e suas fontes configuradas
11.1 Servidor de Alarmes

O objeto Servidor de Alarmes centraliza todos os alarmes do projeto. Neste objeto podem ser encontrados os totais
de alarmes ativos da aplicao (reconhecidos ou no). Tambm responsvel por reportar os eventos de alarmes
para todos os Viewers conectados, bem como, se desejado, enviar estes eventos para um Banco de Dados.
IMPORTANTE
Um Domnio pode ter somente um objeto deste tipo, e sua presena obrigatria para que haja verificao de
alarmes.
Atravs da aba Configurao da Janela de Propriedades deste objeto possvel especificar se os alarmes so
armazenados em um banco de dados. Os alarmes podem ser visualizados em um E3Alarm ou em um E3Browser.
11.2 Configurao de Alarmes

O objeto Configurao de Alarmes onde as Fontes de Alarme so criadas. Para inserir este objeto no projeto,
clique com o boto direito do mouse no Organizer no item Objetos de Servidor - Alarmes, selecione a opo Inserir
Configurao de Alarmes em, e em seguida o nome do projeto desejado.
11.2.1 rea
O objeto rea permite agrupar um conjunto de Fontes de Alarmes, bem como outras reas de Alarme. Isto facilita o
gerenciamento, a operao e o monitoramento de um conjunto de Fontes de Alarmes relacionadas, permitindo, por
exemplo:
Filtrar o conjunto de alarmes visveis no sumrio
Habilitar ou desabilitar um conjunto de Fontes de Alarmes
Reconhecer um conjunto de Fontes de Alarmes
Verificar o total de alarmes ativos ou no reconhecidos de um conjunto de Fontes de Alarmes
Caso haja necessidade, novas reas podem ser inseridas dentro de outras reas.
91 Configurao de Alarmes
11.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 e sua severidade, bem como a necessidade ou no de
reconhecimento deste evento. Todas as Fontes de Alarme possuem as propriedades descritas na tabela a seguir.
Propriedades gerais das Fontes de Alarme
PROPRIEDADE DESCRIO
Texto da Mensagem o texto associado quela condio de alarme, que
aparece 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, esta mensagem exibida nos objetos de
visualizao
H vrios tipos de Fontes de Alarme que podem ser inseridas na rea de Alarme, descritas nos tpicos a seguir.
11.2.2.1 Alarme Analgico

Permite monitorar uma varivel analgica pela especificao de at quatro nveis de alarme: LOLO (muito baixo), LO
(baixo), HI (alto) e HIHI (muito alto).
Fonte de Alarme Analgico
Configurao de Alarmes 92
11.2.2.2 Alarme de 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 de Banda Morta
11.2.2.3 Alarme de Taxa de Variao

Permite monitorar variaes muito rpidas em uma varivel do processo. A Fonte de Alarme do tipo Taxa de
Variao usa seus valores especificados em unidades da varivel por segundo.
Fonte de Alarme de Taxa de Variao
11.2.2.4 Alarme Digital
Permite monitorar uma varivel (ou expresso) digital pela especificao de alarme na borda de subida (em -1 ou
Verdadeiro) ou na borda de descida (em 0 ou Falso).
Fonte de Alarme Digital
11.2.2.5 Alarme Discreto

Permite monitorar uma varivel pela especificao de mltiplas subcondies.
Fonte de Alarme Discreto
11.3 E3Alarm
O E3Alarm serve para o monitoramento dos alarmes ativos ou no reconhecidos em uma aplicao. Atravs deste
objeto possvel verificar o estado dos alarmes, bem como reconhec-los manualmente. Para utilizar este objeto,
clique com o boto direito do mouse na rea de trabalho e selecione a opo Inserir - E3Alarm.
E3Alarm
A aba Conexes da janela de propriedades do E3Alarm especifica as informaes referentes ao Servidor ou

Servidores de Alarmes e a aba Filtros especifica os filtros por rea ou customizados.
Janela de propriedades do E3Alarm
11.4 Exerccios
11.4.1 Servidor de Alarmes
1. Insira um objeto Servidor de Alarmes no projeto TreinamentoE3.
Inserir Servidor de Alarmes
11.4.2 Configurao de Alarmes

1. Se ainda no existir, insira no projeto um objeto Configurao de Alarmes.
Inserir Configurao de Alarmes
11.4.3 Alarme Analgico
1. Crie na Configurao de Alarmes uma nova rea de Alarmes, clicando em Adicionar e modificando seu nome
para "Nivel".
Adicionar rea de Alarme
2. Selecione a rea criada e clique em Adicionar. Insira uma Fonte de Alarme do tipo Analgico.
Adicionar Alarme Analgico
3. Renomeie o Alarme Analgico para "Tanque1".
4. Clique em na coluna Fonte da Fonte de Alarme Tanque1 e, usando o AppBrowser, selecione a propriedade
Value do Tag Nivel1 da pasta Dados.
5. Abra a janela de propriedades do Alarme do Tanque1, aba Analgico.
Selecione o item LoLo, com limite igual a 10 e mensagem "Nvel 1 Muito Baixo"
Selecione o item Lo, com limite igual a 30 e mensagem "Nvel 1 Baixo"
Selecione o item Hi, com limite igual a 70 e mensagem "Nvel 1 Alto"
Selecione 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.
Associao dos Alarmes com os Tags
11.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. Abra a janela de propriedades do Alarme e selecione a aba Banda Morta.
5. Configure as seguintes propriedades:
Setpoint: 50
BM: 10
Texto da mensagem: Temperatura 1 fora da faixa recomendada
Volta ao normal: Temperatura 1 normalizada
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.
Associao dos Alarmes com os Tags
11.4.5 E3Alarm
A visualizao dos Alarmes em tempo real pode ser feita atravs do objeto E3Alarm.
1. Posicione um objeto E3Alarm na TelaAlarmes.
2. Na janela de propriedades do E3Alarm, aba Conexes, informe o nome do Servidor de Alarmes na coluna
Servidor de Alarmes da Conexo padro.
Aba Conexes
3. Abra a janela de propriedades do E3Alarm. Na aba Colunas, selecione os campos DataHora, Operador,
Mensagem, Reconhecido e Valor.
4. Na aba Cores, execute a configurao que desejar.
5. Execute a aplicao e confira a nova funcionalidade.

11.5.1 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
CAPTULO
Bibliotecas ElipseX: XControls
12
O E3 possui ferramentas que permitem transformar qualquer objeto ou conjunto de objetos de uma 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 das Bibliotecas 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
Hierarquizao de objetos
O uso de Bibliotecas recomendado na maioria das aplicaes.
Bibliotecas de objetos
Bibliotecas ElipseX: XControls 100

12.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 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. Abra o menu Arquivo, selecione o item Novo Projeto e clique em Avanar.
2. Na opo Informe o tipo de Aplicao, selecione o item Biblioteca de componentes do E3.
Assistente de Aplicaes
3. Digite o nome da biblioteca e clique em Avanar.
4. Determine as especificaes referentes ao Domnio.
5. Clique em Concluir.
Em uma biblioteca ElipseX podem ser inseridos trs tipos de objetos: os XControls, os XFolders e os XObjects.
Podem ser inseridos nos XControls todos os itens disponveis para as Telas. Entre estes itens esto as primitivas de
desenho, objetos grficos vetoriais, incluindo objetos da biblioteca de smbolos (WMF, EMF, etc.), objetos grficos no
vetoriais (BMP, JPEG, GIF, etc.), controles ActiveX do E3 (E3Chart, E3Browser, E3Alarm), controles ActiveX de terceiros e
outros XControls.
Um XFolder um objeto que permite inserir objetos filhos em suas instncias. Desta forma, possvel organizer ou
criar hierarquias de objetos em uma aplicao. Pode-se inserir em um XFolder itens como Pastas de Dados, Tags de
Comunicao, Filtros de Alarmes e instncias de XFolders, entre outros.
Um XObject 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 e outros XObjects.
Em um mesmo arquivo .lib pode existir qualquer nmero de componentes ElipseX, sejam eles XControls, XFolders ou
XObjects. Pode-se ter tambm vrias bibliotecas diferentes (vrios arquivos .lib) no mesmo Domnio.
101 Bibliotecas ElipseX: XControls

12.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 um projeto. Pode-se criar um XControl clicando com o boto direito do
mouse no arquivo .lib criado no Domnio ou no item Bibliotecas de Objetos - XControl, selecionando a opo Inserir
- XControl.
Aba Design de um XControl
Aba Propriedades de um 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 podem ser associadas a um
Tag ou outra propriedade qualquer quando o objeto estiver em uso 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 clicando
em , e excludas clicando em . As opes disponveis so descritas na tabela a seguir.
Opes disponveis na aba Propriedades de um XControl
OPO DESCRIO
Nome Determina o nome da Propriedade do XControl
Tipo Determina o tipo de dados suportado pela Propriedade

OPO DESCRIO
Pblica Habilita ou desabilita a visibilidade da Propriedade fora
da biblioteca, isto , determina se a Propriedade ou
no pblica
Persistente Determina se a Propriedade salva no projeto ou no
Retentiva Determina se a Propriedade retentiva ou no. No caso

de XControls, as Propriedades no podem ser retentivas
Valor inicial Determina o valor inicial da Propriedade
Texto de Ajuda Texto de declarao e documentao da Propriedade
Note que outros objetos de Dados (XFolders e XObjects) podem ser declarados como Tipos. Isto permite que em
uma nica Propriedade seja controlado o funcionamento de todo um objeto, tornando mais fcil a manuteno de
uma biblioteca.
A edio deste objeto 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 na Tela ou XControl de
destino e selecionando a opo Inserir.
A partir deste momento, o XControl tem um nome dentro da Tela, e entendido como uma cpia da definio
original. Assim, deve-se definir (se necessrio) os valores ou as Associaes que esta cpia especfica tem no contexto
que est sendo utilizada.
12.2 Exerccios
Neste exerccio desenvolvido um XControl para exibir o valor da temperatura e do nvel do tanque. So dois
Displays, um para o nvel e outro para a temperatura. O Display de temperatura deve ser formatado com uma casa
decimal e sufixo " C", e sua cor de fundo varia conforme a temperatura. O nvel deve ser exibido em um Display com
uma casa decimal e sufixo "%", atravs do preenchimento de cor de um retngulo.

12.2.1 XControl
1. No Organizer, clique com o boto direito do mouse no item Bibliotecas de Objetos - XControls e selecione a
opo Inserir XControl em - <Nova Biblioteca>.
Inserir XControl
2. Nomeie a biblioteca como "BibliotecaTreinamento" e especifique a pasta C:\TreinamentoE3.
3. Selecione o objeto XControl1 criado automaticamente e altere a propriedade Name para "Tanque".
Alterar propriedade Name
4. Na aba Design, desenhe os objetos da imagem: Escala, Retngulo e dois Displays.

Aba Design
5. Para poder receber externamente qualquer valor, preciso criar Propriedades. Selecione a aba Propriedades, na
parte inferior da Tela.
6. Crie uma Propriedade chamada "Temperatura" e outra chamada "Nivel", ambas do tipo Double.
Aba Propriedades
7. Retorne aba Design. No Display de temperatura, crie uma Associao Simples entre a propriedade
Temperatura e a propriedade Value.
8. Selecione o objeto Display, abra a janela de propriedades e selecione a aba Associaes. Na propriedade Value,
clique em para abrir o AppBrowser.
9. No AppBrowser, selecione esquerda o XControl Tanque e direita a Propriedade Temperatura criada

anteriormente. Verifique que no campo de ajuda aparece o texto digitado na coluna Texto de ajuda quando a
Propriedade foi criada. Clique em Colar.

AppBrowser
10. Para alterar a cor conforme o valor da temperatura, crie uma Associao por Tabela na propriedade
ForegroundColor, informando os limites e as cores desejados. Na coluna Fonte, selecione a Propriedade
Temperatura criada anteriormente.
Propriedade ForegroundColor
11. No Display de nvel, crie uma Associao Analgica entre a Propriedade Nivel e a propriedade Value.
Propriedade Value
12. No objeto Retngulo, crie uma Associao Simples entre as propriedades Nivel e VerticalPercentFill.

13. Para que o novo objeto possa ser utilizado, preciso registr-lo. Salve as modificaes, clique com o boto
direito do mouse em Bibliotecas de Objetos no Organizer e selecione a opo Registrar bibliotecas carregadas.
Registrar bibliotecas carregadas

12.2.2 Tela Sintico
1. Na TelaSinotico, clique com boto direito do mouse no fundo da Tela e selecione o item Inserir - Tanque.
Menu Inserir - Tanque
2. Posicione o XControl Tanque prximo esteira superior.
XControl Tanque
3. Para testar o objeto, na lista de propriedades digite um valor na propriedade Nivel e outro na propriedade
Temperatura.

Propriedades do Tanque
12.2.3 Associao
1. As propriedades Nivel e Temperatura devem ser associadas aos seus respectivos Tags. Abra a janela de
propriedades do objeto Tanque e selecione a aba Associaes.
2. Na propriedade Temperatura, selecione o item Servidor - Driver1 - Analogicas - Temperatura_T1 - Value no

AppBrowser.
3. Na propriedade Nivel, selecione o item Servidor - Driver1 - Analogicas - Nivel_T1 - Value no AppBrowser.
Aba Associaes
4. Repita os passos anteriores para inserir um XControl Tanque na esteira inferior e associ-lo aos seus respectivos
Tags.

CAPTULO
Bibliotecas ElipseX: XObjects
13
Alm dos XControls e XFolders, 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 pode 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 no arquivo .lib no Organizer
e selecione o item Inserir - XObject.
As opes disponveis para as Propriedades de um XObject so as mesmas de um XControl ou XFolder. Alm das
Propriedades, podem ser inseridos em um XObject quaisquer mdulos do E3 que sejam executados no servidor. Para
saber a lista completa, clique na lista de seleo da coluna Tipo da Propriedade e verifique a lista de objetos
disponveis. Isto permite que se possa definir um sistema complexo de gerenciamento como uma biblioteca, que pode
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 no Servidor de
Dados e selecionando o item Inserir. Mesmo que o arquivo de biblioteca possua vrios XControls, XFolders e
XObjects, o E3 Studio exibe para as Telas somente os XControls, e para os Servidores de Dados os XFolders e os
XObjects.
13.1 Quando Criar um ElipseX

Existem alguns critrios para indicar a necessidade da criao de objetos no E3:
Repetio no uso: Se um mesmo equipamento ou processo 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. Isto comum no caso de integradores de servios ou fabricantes de
mquinas
Uso de controladores: Um controlador de processo, cujo mapeamento de memria fixo, pode ser
implementado com todas as funcionalidades disponveis. A flexibilidade disponvel para a construo e uso dos
objetos no E3 permite que sejam utilizadas posteriormente apenas as variveis de interesse, desprezando-se as
demais
NOTA
No possvel copiar uma Biblioteca e utilizar os dois arquivos (original e cpia) no mesmo Domnio. Por exemplo,
no se pode copiar um arquivo .lib para separ-lo em dois novos arquivos.
13.2 Exerccios
Bibliotecas ElipseX: XObjects 110

13.2.1 Tag Bomba
1. Na biblioteca BibliotecaTreinamento, insira um novo XObject e nomeie-o "TagBomba".
2. Crie trs Propriedades do tipo Boolean: Estado, Automatico e Defeito.
Propriedades do objeto TagBomba
13.2.2 Servidor de Dados

1. Crie uma Pasta de Dados com o nome de "Bombas" em Objetos de Servidor - Objetos de Dados - Dados.
2. Na Pasta Bombas, crie seis XObjects do tipo TagBomba, nomeados de "B01" a "B06".
Objetos TagBomba
111 Bibliotecas ElipseX: XObjects

13.2.3 Associao
As informao das Propriedades Estado, Automatico e Defeito so enviadas pelo CLP. preciso associar os objetos
do tipo TagBomba aos Tags de Comunicao.
1. Na Pasta Bombas, abra a janela de propriedades do objeto B01 e selecione a aba Associaes.
2. Na Propriedade Automatico, selecione o item Servidor - Driver1 - Digitais - AutoMan_B1 - Value, usando o
AppBrowser.
3. Repita o passo anterior para associar as Propriedades Defeito e Estado aos seus respectivos Tags de
Comunicao.
Associaes das Propriedades
4. Crie as Associaes para todas as bombas.

13.2.4 Bomba
As Propriedades de um XObject normalmente so exibidas atravs de um XControl. preciso criar um XControl
chamado "Bomba", que altera a cor para indicar a Propriedade Estado, exibe uma chave de boca vinculada com a
Propriedade Defeito e engrenagens para indicar a Propriedade Automatico.
Bomba
1. Insira um novo XControl no projeto e nomeie-o como "Bomba".
2. Insira o objeto 3DISABlower, disponvel na categoria Blowers da Galeria. Modifique as seguintes propriedades:
OverrideFillMode para 3 - ByBrightness
OverrideFillColor para a cor verde (RGB(0, 255, 0))
3. Insira a figura Defeito e Automtico , que esto no projeto como Recursos.
4. Insira um Display sob a bomba, para exibir o nome "Bomba".
5. Crie uma Propriedade chamada "Fonte", do tipo TagBomba (XObject criado anteriormente).
Propriedade do Tipo TagBomba
6. Para facilitar posteriormente, escreva na coluna Texto de ajuda a mensagem "Objeto TagBomba associado.
Propriedades: Estado, 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, selecione a Propriedade Fonte
No campo inferior, insira aps a Propriedade Fonte a propriedade do objeto TagBomba desejada. Neste
caso, Defeito
AppBrowser
8. Repita o procedimento anterior entre o objeto Automatico e a propriedade 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 a propriedade Bomba.Fonte.Name.
10. Quando a Propriedade Estado estiver em Verdadeiro, a cor da bomba deve ser verde, e quando a propriedade
estiver em Falso a cor deve ser vermelha. Na aba Associaes, crie uma Associao Digital entre a propriedade
OverrideFillColor e a Propriedade Estado.
Propriedade OverrideFillColor
11. Salve a biblioteca e registre-a.

13.2.5 Tela Sintico
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 exerccio
anterior.
Propriedade Fonte
DICA
Pode-se arrastar o objeto que se deseja associar at a propriedade desejada.
Arrastando um objeto para uma

propriedade
3. Execute a aplicao e verifique se o nome e as imagens correspondem s propriedades dos seus respectivos
objetos TagBomba.

CAPTULO
Tela Indexada
14
A Tela Indexada uma Tela que pode receber e enviar informaes a diversos equipamentos individualmente. Ao ser
aberta, a Tela recebe a informao com o nome do objeto a ser associado, e ento cria automaticamente a
Associao.
Por exemplo, em uma Tela com seis bombas, ao clicar em qualquer uma delas, a Tela com informaes mais
detalhadas deve ser aberta.
Tela Indexada
A Tela com as informaes detalhadas da bomba sempre a mesma, o que muda so os valores das variveis
mostradas.
Tela Indexada 116

14.1 Arquitetura da Informao
Na aplicao de treinamento, a estrutura de dados a seguir deve ser criada:
O Driver de Comunicao acessa as informaes do equipamento (CLP)
O XObject TagBomba concentra as informaes de uma nica bomba (Estado, Automtico e Defeito) associando
cada uma destas informaes com seu respectivo Tag de Comunicao e gerando os alarmes
O XControl Bomba exibe de forma grfica para o usurio as informaes de cada bomba
A Tela Indexada acessa as mesmas informaes de Estado, Automtico e Defeito concentradas no TagBomba e
exibe as informaes atravs de botes, que tambm permitem comandos.
Arquitetura
14.2 Exerccios
117 Tela Indexada

14.2.1 Comando Bomba
Este exerccio cria um XControl que utilizado para alterar as propriedades Estado, Automatico e Defeito do
XObject TagBomba. H uma nica Tela com este objeto, que configura todas as bombas do aplicativo.
Tela Comando
1. Insira um novo XControl na biblioteca BibliotecaTreinamento e nomeie-o como "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 propriedade
Fonte.
Propriedade Defeito
5. Copie o objeto Caixa de Seleo duas vezes. Altere a propriedade Caption dos novos objetos para "Automtico"
e "Estado", respectivamente, e associe-os s propriedades correspondentes.
6. Insira um texto sobre os objetos, onde aparea o nome do XObject TagBomba associado.
Propriedade Name
14.2.2 Tela Comando

1. Insira no projeto uma nova Tela, chamada "TelaComando", com o tamanho de 200 x 200 pixels.
2. Na TelaComando, insira um objeto do tipo ComandoBomba.
3. No evento OnPreShow da TelaComando, crie o seguinte script:

Item("ComandoBomba1").Fonte = Arg
4. Selecione, utilizando o AppBrowser, o XControl ComandoBomba1 que est na TelaComando e, direita,

selecione a propriedade Fonte.
5. Digite " = Arg".
Tela Indexada 118

14.2.3 Tela Indexada
Ao clicar em uma bomba, deve ser aberta a sua Tela de comando. Como s h uma nica Tela de comando e vrias
bombas, ao abrir a Tela deve-se informar o nome da bomba para a qual so enviados os comandos.
Bomba
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 guarda o nome da bomba clicada.
3. Selecione, utilizando o AppBrowser, o XControl Bomba e, direita, a propriedade Fonte. Clique em Colar.
4. Termine a linha digitando ".PathName". Esta propriedade retorna o nome completo do XObject TagBomba
associado.
Arg = Bomba.Fonte.PathName
5. Selecione, utilizando o AppBrowser, o mtodo DoModal do Viewer e clique em 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 parmetro Title para "Comando". Este o ttulo da Tela, desde que a propriedade Caption esteja em
branco.
8. Altere os parmetros Left e Top para 0 (zero). A Tela forada a abrir no centro em outro parmetro.
9. Altere os parmetros Width e Height para um espao, assim utilizando o tamanho original da Tela.
10. O parmetro Arg a informao passada para a Tela que se abre. Este 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), Tela
pode ser movida (64) e Tela centralizada (2048).

14.3.1 KB
KB-28547: Utilizando biblioteca desenvolvida em outro projeto
119 Tela Indexada

CAPTULO
Armazenamento de Dados
15
O Armazenamento de Dados no E3 utilizado para guardar as informaes do projeto atravs de Histricos,
Frmulas e Alarmes. Possui suporte a MDB (Microsoft Access), Oracle e Microsoft SQL Server.
15.1 Servidor de Alarmes

Uma aplicao s pode ter um objeto do tipo Servidor de Alarmes, e sua presena obrigatria para que haja
verificao de alarmes. Este objeto responsvel por reportar os eventos de alarmes para todos os Viewers
conectados, bem como, se desejado, enviar estes eventos para um Banco de Dados.
Para salvar os alarmes no banco de dados, abra a janela de propriedades do Servidor de Alarmes e, na aba
Configurao, habilite a opo Armazenar alarmes em banco de dados.
15.2 Histricos
Os Histricos so mdulos responsveis pelo armazenamento de dados da aplicao em um Banco de Dados.
Permitem armazenar dados de processos para anlises futuras, no E3 ou em qualquer outra ferramenta.
Pode-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 utilizado
para o armazenamento dos dados. Para utilizar este 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 clicando em
Adicionar . Para remover algum campo indesejado, clique em Remover .
Histrico
Armazenamento de Dados 120

15.3 Chave Primria
Uma 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 disto, 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 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 ao clicar em , ou clicando em para abrir a tela de configurao.
15.4 ndices
Um ndice um campo ou um conjunto de campos que previamente ordenado pelo Banco de Dados, a fim de
melhorar o desempenho das consultas que utilizam este 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 encontre os registros relevantes. Quanto maior a
tabela, maior 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.
Pode-se criar ndices em mltiplas colunas. Um ndice de mltiplas colunas pode ser considerado um vetor ordenado
contendo valores que so criados concatenando-se valores de colunas indexadas.
Os ndices podem ser configurados clicando em para abrir a tela de configurao, mostrada na figura a seguir.
Editor de ndices
121 Armazenamento de Dados

15.5 Exerccios
Este banco de dados utilizado para armazenar todos os dados de Alarmes e Histricos dos projetos.

15.5.1 SQL Server Management Studio
1. Abra o SQL Server Management Studio utilizando o menu Iniciar - Programas - Microsoft SQL Server.
2. Para conectar-se ao banco de dados, necessrio informar o nome do servidor, usurio e senha.
Conexo ao SQL Server
3. No campo Server name, clique na Caixa de Seleo e selecione o servidor na listagem.
Lista de servidores
4. No campo Authentication, selecione a opo SQL Server Authentication. No campo Login digite "sa" e, no
campo 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 conecta ao servidor de banco de
dados.

Object Explorer

15.5.1.1 Criao do Banco de Dados
1. Clique com o boto direito do mouse no item Databases e selecione a opo New Database.
Opo New Database
2. No campo Database name, digite "TreinamentoE3" e clique em OK.
Campo Database Name
3. Verifique se o banco de dados criado aparece na lista Databases.

Lista de bancos de dados

15.5.2 Banco de Dados
1. Se no existir, insira um novo Banco de Dados no projeto TreinamentoE3, com o nome de "BancoDados".
Adicionar Banco de Dados
2. Selecione o item 2 - stSqlServer no campo Banco de Dados.
3. Configure os parmetros de conexo.

Parmetros da conexo
4. Teste a conexo com o banco de dados.

15.5.3 Servidor de Alarmes
1. Abra a janela de propriedades do Servidor de Alarmes e, na aba Configurao, habilite a opo Armazenar
alarmes em banco de dados.
Aba Configurao
2. Na opo Servidor de Banco de Dados, selecione o item BancoDados.
3. Habilite a opo Descartar dados da tabela principal.
Mantenha os dados dos ltimos 3 meses
A verificao deve ocorrer a cada 1 ms
4. Clique em Campos e selecione os campos que desejar. Para o correto funcionamento com o E3Playback, visto
mais adiante neste Tutorial, insira os seguintes campos:
EventTimeDbl
FullAlarmSourceName
ConditionActive
Acked
AckRequired
5. Por ltimo, clique em Gerar Tabela. Deve ser exibida uma mensagem de sucesso, como a mostrada na figura a
seguir.

Mensagem de sucesso

15.5.4 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.
Campos do Histrico
3. Clique em Propriedades e, na aba Histrico, configure as seguintes propriedades:
Servidor de Banco de Dados: BancoDados
Nome da tabela: Nivel
Intervalo entre registros (ms): 2000
4. Clique em Gerar Tabela. Deve aparecer a mensagem na figura a seguir.

Mensagem de sucesso

15.6.1 KB
KB-29527: Bancos de dados suportados pelo E3

CAPTULO
Consultas
16
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 esta 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 executa o filtro ou a consulta, no
sendo necessrio para o usurio saber detalhes como data, etc. Para utilizar este recurso, clique com o boto direito
do mouse na 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.
133 Consultas
16.1 Criando uma Consulta
1. A definio da Consulta comea quando o usurio informa o Servidor de Banco de Dados onde a Consulta busca
os dados.
Definir o Servidor de Banco de Dados
2. Aps definido o Banco de Dados, uma nova janela aparece com as tabelas que foram encontradas, permitindo
sua seleo.
Seleo de tabelas
3. Selecione as tabelas que faro parte da Consulta e clique em OK.
4. Na aba Campos so adicionados os campos retornados pela Consulta, bem como definidos filtros e ordenaes.
5. Na aba Variveis so mostradas as variveis criadas para os filtros.
6. Na aba Visualizar pode-se realizar uma prvia da Consulta.
7. Na aba SQL pode-se visualizar e editar o cdigo SQL.
Consultas 134
Janela de configurao da Consulta
8. A janela mostrada na figura anterior pode ser aberta clicando-se com o boto direito do mouse no objeto
Consulta e selecionando a opo Configurar.
135 Consultas
16.2 E3Browser
O E3Browser um controle ActiveX 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 e atribuir cores
para cada coluna, entre outras configuraes. Este objeto utilizado para visualizar Histricos, Alarmes ou qualquer
tabela existente no Banco de Dados.
E3Browser
Para utilizar este recurso, insira o E3Browser no projeto clicando com o boto direito do mouse na Tela e
selecionando a opo Inserir - E3Browser.
Inserir E3Browser
O E3Browser utiliza o objeto Consulta para auxiliar o usurio no processo de definio de consultas no Banco de
Dados da aplicao.
16.3 Exerccios
Vamos visualizar os dados de alarmes armazenados no Banco de Dados em forma de tabela, utilizando o objeto
E3Browser.
Consultas 136
16.3.1 Tela Eventos
1. Insira no projeto uma nova Tela, chamada TelaEventos, a ser aberta no Divisor Area_Central.
2. Na Tela_Menu, insira um boto para abrir a TelaEventos.
3. Insira um E3Browser na TelaEventos.
4. Para configurar os dados que o E3Browser mostra, abra a janela de propriedades do objeto e selecione a aba
Consulta.
5. Selecione a Consulta1 e clique em Configurar.
Aba Consulta
6. Selecione o Banco de Dados que contm a tabela que se deseja consultar.
7. Selecione a tabela Alarms.
8. Selecione todos os campos da tabela Alarms.
Tabela Alarms
9. Selecione a aba Visualizar e clique em Executar Consulta para verificar o resultado da Consulta.
137 Consultas
Executar Consulta
10. Clique em OK. Ao finalizar este passo, esto disponveis no E3Browser todos os campos listados na Consulta.
Configure cada campo com a cor, formatao e tamanho desejados.
Configurao da Consulta
16.3.2 Tela Histrico

1. Insira no projeto uma nova Tela, chamada TelaHistorico, a ser aberta no Divisor AreaCentral.
2. Na TelaMenu, insira um boto para abrir a TelaHistorico.
3. Insira um E3Browser na Tela e configure-o para exibir a tabela Nivel j criada.
4. Execute a aplicao para testar as novas funcionalidades.
Consultas 138
CAPTULO
Filtros na Consulta
17
Muitas vezes, recuperar todo o contedo de uma tabela se torna invivel pela quantidade de dados armazenados,
seja pelo alto nmero de campos, seja pelo grande nmero de registros. Nestes casos, preciso aplicar filtros nos
Histricos. Na sintaxe SQL, o filtro identificado pela clusula WHERE.
Filtro na Consulta
17.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 so definidas por script utilizando o mtodo SetVariableValue da Consulta. A forma de
declarar as variveis depende do tipo de dado que elas representam, como mostrado a seguir:
Nmeros: <%Nome_da_Variavel%>
Strings: '<%Nome_da_Variavel%>'
Data e hora: #<%Nome_da_Variavel%>#
139 Filtros na Consulta

17.2 Exemplo de Filtros
Na Consulta do E3Browser, seleciona-se diversos campos de uma tabela, entre eles o campo E3TimeStamp, que
representa o horrio que o registro foi salvo no banco de dados.
No campo E3TimeStamp, edita-se o filtro onde foram criadas as variveis DataInicial e DataFinal. Como o campo
onde o filtro deve ser aplicado do tipo Data e Hora, as variveis devem ser criadas no formato #<%
Nome_da_Variavel%>#.
Exemplo de filtro
Aps configurada a Consulta, necessrio criar um script para informar o valor de cada varivel (DataInicial e
DataFinal). No evento Click de um boto, selecione, usando o AppBrowser, o mtodo SetVariableValue do objeto
Consulta.
Mtodo SetVariableValue da Consulta
O parmetro VarName deve ser substitudo pelo nome da varivel (por exemplo, "DataInicial") e o parmetro Value
deve ser substitudo pelo valor que deve ser passado para a varivel. Exemplo:
Screen.Item("E3Browser1").Item("Consulta1").SetVariableValue "DataInicial", "01/01/2000"
Como existem duas variveis, esta linha deve ser repetida:

Screen.Item("E3Browser1").Item("Consulta1").SetVariableValue "DataInicial", "01/01/2000"
Screen.Item("E3Browser1").Item("Consulta1").SetVariableValue "DataFinal" , "01/01/2020"
Filtros na Consulta 140

17.3 Exerccios
1. Insira na TelaEventos dois SetPoints, chamados de "spDataInicial" e "spDataFinal", e dois objetos do tipo Texto
conforme a figura a seguir.
SetPoints
2. Neste exerccio, vai ser usado um mtodo do Viewer que mostra um calendrio para a escolha da data pelo
usurio. Crie um novo script no evento Click dos SetPoints.
'Executa a funo Calendrio
If Application.ShowDatePicker(DataHora, 0, 0) Then
'Passa a data escolhida para o SetPoint
Value = DataHora
End If
3. Selecione, utilizando o AppBrowser, o mtodo ShowDatePicker do Viewer e clique em Colar.

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.
5. Substitua os parmetros Left e Top por 0 (zero) ou pela coordenada onde se deseja abrir o calendrio.
6. O parmetro DateValue deve ser substitudo por uma varivel interna de script. Esta varivel deve ser criada com o
nome de "DataHora".
7. O mtodo ShowDatePicker retorna Verdadeiro se o usurio clicar em OK e Falso se clicar em Cancelar. Somente
se o usurio clicar em OK que deve ser passado 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 este script est sendo digitado no SetPoint, e desejamos referenciar a sua propriedade Value, pode-se
digitar diretamente o nome da propriedade sem especificar o caminho completo.
10. Finalize o script digitando "End If".
11. Abra a janela de configurao do objeto Consulta do E3Browser. Isto pode ser feito clicando com o boto direito
do mouse no objeto e selecionando o item Configurar, ou pela aba Consulta da janela de propriedades do
E3Browser.

Configurar Consulta
12. Na coluna Filtro do campo E3TimeStamp, clique em Configurar Filtro .
13. Para que o usurio possa selecionar a data inicial e a data final, preciso criar variveis de consulta. Configure o
filtro conforme a figura a seguir.
Configurao do filtro
14. Digite um valor inicial para as variveis criadas na aba Variveis.

Valores iniciais para o filtro
15. Selecione a aba Visualizar e clique em Executar consulta para verificar o resultado da Consulta. Certifique-se
que o filtro foi aplicado e clique em OK.
16. Na TelaEventos, abaixo dos SetPoints, crie um boto Consultar, e insira um novo script no evento Click com o
cdigo a seguir.
'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. Selecione, utilizando o AppBrowser, o SetPoint spDataInicial e, direita, a propriedade Value.

DataIni = Screen.Item("spDataInicial").Value
19. Repita o passo anterior para criar a varivel interna DataFim, referenciando o valor do SetPoint spDataFinal.
DataFim = Screen.Item("spDataFinal").Value
20. Selecione, utilizando o AppBrowser, a Consulta1 que est no E3Browser1. direita selecione o mtodo
SetVariableValue.
Screen.Item("E3Browser1").Item("Consulta1").SetVariableValue(VarName, Value)
21. Insira uma quebra de linha logo aps o texto "Item('Consulta1')".

Screen.Item("E3Browser1").Item("Consulta1")_
.SetVariableValue(VarName, Value)

22. Digite no comeo da linha o texto "Set consulta = ". Este cdigo cria 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. Neste caso, o valor do SetPoint que foi
referenciado atravs da varivel interna DataIni.
consulta.SetVariableValue "DataInicial", DataIni
26. Remova os parnteses do mtodo SetVariableValue.
27. Copie a linha anterior para implementar a mesma lgica para a varivel DataFinal.
consulta.SetVariableValue "DataFinal", DataFim
28. Compile o script e execute a aplicao.

17.4.1 KB
KB-20214: Funo SQL para calcular valores mximo, mnimo e mdio

CAPTULO
Grficos e E3Chart
18
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 este objeto em uma Tela, clique com o boto direito do mouse e selecione a opo Inserir - E3Chart.
145 Grficos e E3Chart

18.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. Selecione esta aba e clique em Adicionar para criar uma
nova Pena no E3Chart.
Aba Dados
18.1.1 Tempo Real

Para configurar uma Pena como Tempo Real, selecione o item Tempo Real na opo Tipo de pena na aba Dados da
janela de propriedades da Pena. Logo aps, defina os Tags nas opes Link do eixo vertical e Link do eixo
horizontal.
18.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 da janela de propriedades da Pena, selecione o item Histrica na
opo Tipo de pena e defina a Consulta. Logo aps, defina os campos da Consulta nas opes Campo do eixo
vertical e Campo do eixo horizontal.
18.1.3 Tempo Real e Histrica (Mista)

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

18.2 Exerccios
Vamos criar um grfico com Penas de Tempo Real com as variveis de nvel. Posteriormente iremos transformar estas
Penas em Penas Mistas (Tempo Real e Histrica).
18.2.1 Tela Grfico

1. Insira no projeto uma nova Tela, chamada "TelaGrafico", a ser aberta no Divisor Area_Central.
2. Na Tela_Menu, insira um boto para abrir a TelaGrafico.
18.2.2 E3Chart
1. Posicione um objeto E3Chart na TelaGrafico.
18.2.3 Escala
Os maiores valores so do Tag Nivel, que varia entre 0 e 100, portanto vamos alterar a escala vertical para exibir os
valores nesta faixa.
1. Na aba Eixos, selecione o item EixoVertical e clique em Configurar.
2. Na aba Escala, selecione a opo Escala numrica e configure os campos Mnimo e Mximo com os valores 0
(zero) e 100, respectivamente.

18.2.4 Pena de Tempo Real
1. Na aba Penas, clique em Adicionar e selecione o item Tempo Real.
Adicionar Pena de Tempo Real
2. Troque o nome da Pena para "Nivel1".
Pena Nivel1
3. Na coluna Estilo, clique em para abrir a janela Estilo da Pena e selecione a cor e o tipo da linha.

Estilo da Pena
4. Na coluna Link do Eixo Vertical, selecione o Tag Nivel1 (em Servidor - Dados).
Link do Eixo Vertical
5. Repita os passos anteriores para incluir uma Pena para o Tag Nivel2.
6. Execute a aplicao para verificar as novas funcionalidades.
18.2.5 Legenda
1. Na aba Legenda, selecione a opo Mostrar legenda, tamanho 60, e adicione as colunas Cor da Pena, Valor do
tag X, Valor do tag Y, e outras colunas que preferir.
2. Configure a coluna Valor do tag X para mostrar o valor no formato HH:mm:ss.
3. Execute a aplicao e clique sobre uma Pena do grfico para que a legenda exiba os valores do ponto
selecionado.

18.2.6 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 selecione 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. Selecione, usando o AppBrowser, a Pena Nivel1 da coleo de Penas do objeto E3Chart na TelaGrafico e,
direita, selecione a propriedade Visible. Clique em Colar.
5. Digite " = Value". Como este script est sendo escrito no objeto Caixa de Seleo, digitar "Value" faz referncia ao
valor do prprio objeto.
6. Configure o valor inicial (a propriedade Value) da Caixa de Seleo para Verdadeiro.
7. Repita os passos anteriores para a Pena Nivel2.
18.2.7 Grfico Histrico

Vamos criar um grfico com Penas de Tempo Real e Histrica (Mistas) com as variveis de nvel. Atravs de um boto,
ser possvel alternar o eixo horizontal do grfico entre Penas de Tempo Real e Histricas.
18.2.8 Consulta
Como desejamos visualizar os dados histricos, preciso configurar uma Consulta.
1. Abra a janela de propriedades do E3Chart e selecione a aba Consultas.
2. Clique em Adicionar. Selecione "BancoDados" no campo Nome do Servidor e, a seguir, selecione a tabela Nivel.
3. Selecione os campos E3TimeStamp, Nivel1 e Nivel2.
4. Visualize o resultado da Consulta na aba Visualizar e clique em OK.

18.2.9 Pena Mista
1. Selecione a Pena Nivel1 e clique em para abrir a janela de propriedades.
2. Na aba Dados, selecione o item Tempo Real & Histrica na opo Tipo de pena.
3. Na opo Link do eixo vertical, selecione a propriedade Value do Tag Nivel1 na pasta Dados.
4. Na seo Configurao de dados histricos, preencha os campos a seguir:
Consulta local: Consulta1
Campo do eixo vertical: Nivel1
Campo do eixo horizontal: E3TimeStamp
Configurao de dados histricos
5. Repita os passos anteriores para a Pena Nivel2.
6. Execute a aplicao. Ao abrir a TelaGrafico, os dados histricos so carregados.
18.2.10 Eixo Horizontal Histrico

Para navegar pelo grfico consultando dados antigos, o Eixo Horizontal deve estar configurado como Histrico.
1. Abra a janela de propriedades do E3Chart e selecione a aba Eixos.
2. Selecione o item EixoHorizontal e clique em Configurar.
3. Na aba Escala, selecione a opo Intervalo de tempo (histrico) na seo Tipo de Escala.
Intervalo de tempo (histrico)
4. Selecione um intervalo inicial pequeno (cinco minutos, por exemplo), pois assim a Tela carregada rapidamente.

18.2.11 Intervalo do Grfico
1. Para poder selecionar 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.

CAPTULO
Relatrios
19
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, 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 so 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 conforme descrito na tabela a seguir.
Estrutrura do Relatrio
SEO DESCRIO
Report Header Esta Seo impressa no incio do Relatrio. Utilizada
para imprimir ttulos de Relatrios, tabelas de somas,
grficos ou qualquer outra informao que necessite
aparecer somente uma vez no incio do Relatrio.
Report Footer Esta Seo impressa no final do Relatrio. Utilizada

para imprimir uma soma de um Relatrio, totais gerais
ou qualquer outra informao que necessite ser impressa
somente uma vez no final do Relatrio.
153 Relatrios
SEO DESCRIO
Page Header Esta Seo impressa no topo de cada pgina do
Relatrio. a primeira Seo impressa na pgina, exceto
quando esta pgina contm a Seo Report Header.
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 somente uma vez na base de
cada pgina.
Detail Esta Seo o corpo do Relatrio, que imprime uma vez

para cada registro na 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 Relatrios contm trs itens de configurao que permitem editar, visualizar o Relatrio e
criar scripts. Estes itens so descritos na tabela a seguir.
Opes de configurao na barra de ferramentas Relatrios
CONE OPO DESCRIO

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 Nestas configuraes pode-se

Settings) 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 ocorre a ao.
Relatrios 154
19.1 Objetos do Relatrio
A ferramenta Relatrio possui vrios objetos especficos que podem ser utilizados, disponveis na barra de
ferramentas Relatrios.
Barra de ferramentas Relatrios
Os recursos disponveis na barra de ferramentas Relatrios esto descritos na tabela a seguir.
Recursos disponveis na barra de ferramentas Relatrios
CONE OPO DESCRIO

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.
Campo de Dados Atravs deste objeto possvel

associar um campo da tabela no
Banco de Dados. Este campo
especificado na propriedade
DataField.
155 Relatrios
CONE OPO DESCRIO
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. Este 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 onde so inseridos textos ou
grficos. As tabelas nos Relatrios
so usadas para organizar e
apresentar informaes. Pode-se
tambm usar tabelas para criar
layouts de pgina.
E3Chart Este objeto utilizado para visualizar

os dados do Relatrio em formato
grfico. Maiores informaes esto
descritas no captulo Grficos e
E3Chart.
Enviar para frente e Enviar para trs Atravs destes botes possvel
enviar um objeto para frente ou para
trs de outro. Ao selecionar as
opes Enviar para frente ou Enviar
para trs, o objeto selecionado
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 rea de Notificaes do Windows exibe a lista das impressoras
encontradas local ou remotamente, e permite que o usurio escolha uma para ser usada pelo E3 Server.
19.2 Exerccios
Relatrios 156
19.2.1 Relatrio de Alarmes
Relatrio de Alarmes
1. Clique com o boto direito do mouse no projeto e insira um objeto Relatrio. Renomeie para "RelatorioAlarmes".
2. Clique com o boto direito do mouse no objeto Consulta1 do Relatrio e selecione a opo Configurar.
Configurar Consulta
157 Relatrios
3. Consulte todos os campos que desejar da tabela Alarms.
19.2.2 Detail
A Seo Detail o corpo do Relatrio, impressa uma vez para cada registro na fonte de dados. Para esta aplicao,
so 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, clique em Gerar Relatrio .
19.2.3 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 Page Header e configure-os com o
nome dos campos. Estes so os ttulos das colunas.
2. Clique em Gerar Relatrio para verificar a nova configurao.
19.2.4 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 deve executar. Por exemplo, vai ser criada na Seo Page Footer a indicao "Pgina 1 de 12".
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
5. Clique em Gerar Relatrio para verificar a nova configurao.
Relatrios 158
19.2.5 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 selecione o item Insert - Report Header/Footer.
Esta opo insere uma pgina inicial e final no Relatrio.
Inserir Report Header e Footer
2. Na Seo Report Header desenhe uma "capa" para o Relatrio.
3. Na Seo Report Footer, insira um objeto Campo de Dados e configure a propriedade DataField com o caminho
de Relogio da pasta Dados, Dados.Relogio.Value.
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
159 Relatrios
19.2.6 Imprimir Relatrio de Alarmes
1. Para visualizar o Relatrio em tempo de execuo, copie o boto Consultar da TelaEventos para criar um novo
boto com o texto "Imprimir".
2. No evento Click, crie um Pick do tipo Imprimir Relatrio .
3. No campo Imprimir relatrio, selecione o item RelatorioAlarmes.
4. Na opo Sada, selecione o item Tela.
Pick do tipo Imprimir Relatrio
5. Execute a aplicao e teste as novas funcionalidades.
Relatrios 160
19.2.7 Relatrio Grfico
Vamos criar um relatrio grfico que copia as configuraes do grfico da Tela. Este relatrio deve ser impresso e
exportado para o formato PDF.
1. Insira no projeto um Relatrio chamado "RelatorioGrafico".
2. Na Seo Page Header, insira um objeto E3Chart.
3. Abra o Editor de Scripts, clicando em .
4. No campo Object selecione o item PageHeader e, no campo Events, selecione o item 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()
Editor de Scripts
161 Relatrios
19.2.8 Imprimir Relatrio Grfico
Antes de exportar o Relatrio, temos 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 item RelatorioGrafico em
Imprimir relatrio e selecione o item Tela na opo Sada.
Pick do tipo Imprimir Relatrio
Relatrios 162
19.2.9 Exportar
Para que o usurio selecione o nome e diretrio do arquivo que 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, selecione o mtodo ShowFilePicker do Viewer.

Application.ShowFilePicker(Open, FileName, Extension, Flags, Filter)
4. Como desejamos salvar um arquivo, substitua o parmetro Open por "False".
5. O parmetro FileName deve ser uma varivel interna de script que armazena o nome do arquivo. Substitua-o por
"NomeArquivo".
6. Caso no seja informada a extenso do arquivo, considera-se como padro o que informado no parmetro
Extension. Digite "pdf".
7. Para que uma mensagem de confirmao aparea 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
aparece para o usurio e o segundo item um identificador do Windows.
10. Substitua o parmetro Filter por "Arquivos PDF|*pdf | Todos os arquivos| *.*".
163 Relatrios
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 selecione, com o auxlio do AppBrowser, o item Tarefas - Carregar o relatrio -
RelatorioGrafico e, direita, o mtodo Export.
Set Report = Application.LoadReport("RelatorioGrafico")
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.
Relatrios 164
CAPTULO
Frmulas
20
Frmulas so mdulos destinados a armazenar e transferir conjuntos de valores para determinados agrupamentos
de variveis, de forma a criar configuraes pr-definidas, sendo basicamente uma implementao de receitas. As
Frmulas so compostas de trs partes:
Templates: Definem o tipo de dados que pode 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 so associados ao Template da Frmula. possvel criar vrias Unidades, ou
seja, vrios grupos de Tags que podem receber os valores da Frmula
Conjuntos de Valores: So os valores que so transferidos para os Tags, ou seja, para as Unidades
As Frmulas esto sempre ligadas a um Banco de Dados, pois precisam 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 do tipo 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.
20.1 Exerccios
O objeto Frmula armazena informaes sobre as cores de tintas, formadas pela combinao de vermelho, verde e
azul.
165 Frmulas
20.1.1 Frmula
1. Insira um objeto Frmula no projeto TreinamentoE3.
Inserir Frmula
2. Selecione no campo Banco de Dados o objeto Banco de Dados da aplicao e, no campo Tabela, digite
"FormulaTreinamento".
Configurao do Banco de Dados da Frmula
3. Nomeie o objeto como "FormulaCores".
4. Na aba Templates, adicione trs novos Templates do tipo Integer: Vermelho, Verde e Azul. Para todos os
Templates, selecione uma restrio absoluta entre 0 (zero) e 255.
Frmulas 166
Templates
5. Na aba Unidades, selecione uma linha qualquer da coluna Unidade1 e clique em Renomear . Troque o nome da
Unidade para "Tanque1".
6. Clique em para adicionar uma nova Unidade, "Tanque2".
7. Selecione, nas duas Unidades, o caminho de cada propriedade dos objetos Tanque1 e Tanque2 na pasta 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
167 Frmulas
20.1.2 Carregar Dados
1. 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 "FormulaCores"

20.2.1 KB
KB-28508: Dados carregados de frmulas incorretamente arredondados
Frmulas 168
CAPTULO
Hot-Standby
21
O Hot-Standby permite a implementao do conceito de failover em um sistema supervisrio. Este 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 modo Standby.
Ao iniciar a execuo do E3 que est configurado para o sistema Hot-Standby, a rea de Notificaes do Windows
nos servidores mostra um cone representado por uma barra amarela circulante , indicando que os Domnios esto
carregando. Aps alguns segundos, o E3 reconhece o servidor principal e indica esta 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 , indicando que ele est em modo Standby (em
espera).
21.1 Arquitetura
O banco de dados no modo Hot-Standby pode ser local em cada servidor ou em um terceiro computador na rede.
Na opo de um banco de dados em cada servidor, o servidor ativo (Hot) grava os dados no banco de dados local e
tambm no banco de dados do servidor Standby, mantendo os dados sincronizados.
Hot-Standby com servidores locais
Na segunda opo, ambos os servidores (Hot e Standby) acessam o banco de dados na rede (terceiro servidor).
Hot-Standby com servidor na rede
21.2 Configuraes do Hot-Standby

Esta seo contm as configuraes para o funcionamento de servidores E3 em modo Hot-Standby.
21.2.1 Arquivos
Os arquivos do Domnio devem estar no mesmo diretrio no servidor principal e no servidor de backup. Por exemplo,
se no computador principal o Domnio e os demais arquivos (.lib, .prj, etc.) esto no diretrio C:\Projeto1, no
servidor Standby o projeto deve ser copiado para este mesmo diretrio, ou seja, C:\Projeto1.
169 Hot-Standby
21.2.2 Servidores
Os servidores (principal e backup) devem estar listados na aba Servidores das opes do Domnio.
1. Para abrir a janela de configuraes do Domnio, clique no cone do E3 Admin na rea de Notificao do
Windows e selecione o menu Domnio - Opes.
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
Hot-Standby 170
21.2.3 Opes de Configurao
Na aba Opes, o item Habilitar deve estar selecionado e, nos campos Servidor principal e Servidor de backup,
devem ser selecionados um dos servidores cadastrados previamente na aba Servidores.
Aba Opes
Os itens descritos nos prximos tpicos tambm devem ser configurados.
21.2.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 em modo Standby conseguir acessar a integridade e no conseguir acessar o
servidor em modo Hot (principal), ele entende que o servidor Hot est com problemas e assume a execuo do
Domnio.
21.2.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.
171 Hot-Standby
21.2.6 Banco de Dados
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 grava os dados neste Banco
de Dados
Existem dois bancos de dados executando localmente, nos dois servidores (principal e backup). Neste 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 modo Standby
Se a aplicao principal no conseguir enviar dados para o servidor em modo Standby, estes dados ficam
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.2.7 Propriedade Retentive

A propriedade Retentive determina se o valor deve ser armazenado no caso de troca do servidor ativo. Assim,
quando o servidor em modo Standby executado, o valor o mesmo do servidor em modo Hot que foi parado. Se
esta propriedade estiver em Falso, a propriedade ajustada para o valor inicial sempre que o Domnio executado
ou caso ocorra a troca do servidor ativo.
21.3 Exerccios
21.3.1 Propriedade Retentive
Para exemplificar a diferena, vamos transformar os Tags de cor do Tanque1 (vermelho, verde e azul) em Tags
retentivos e os Tags do Tanque2 em Tags no retentivos.
1. Selecione todos os Tags Internos da pasta Tanque1 (Vermelho, Verde e Azul) e altere a propriedade Retentive
para Verdadeiro.
Hot-Standby 172
21.3.2 Falha Local
1. Na pasta Dados, insira um Tag Interno chamado "FalhaLocal".
2. Configure a propriedade Value deste Tag para Falso (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. Selecione, usando o 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 ao estado normal, digite na ltima linha a expresso "Value = False".
Value = False
8. Na TelaMenu, insira um boto com o texto "Falha Local".
9. Neste boto, crie um Pick do tipo Carregar Valor.
Pick Carregar Valor
10. Selecione a propriedade Value do Tag FalhaLocal e selecione o item True no campo Valor.
173 Hot-Standby
Valor do Tag FalhaLocal
21.3.3 Sincronizao do Banco de Dados

1. No objeto BancoDados, altere a propriedade EnableSynchronization para Verdadeiro.
21.3.4 Aplicao em Modo Standby

1. Copie a pasta da aplicao para o computador que vai 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.3.5 Configurao Hot-Standby

1. A partir do computador em modo Hot ou do computador em modo Standby, clique no cone do E3 Admin na
rea de Notificao do Windows e selecione o menu Domnio - Opes.
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 item Hot-Standby e selecione um servidor como principal e outro como backup.
4. Informe, no item Endereos para PING de integridade da rede, o endereo IP de um terceiro computador na
rede.
5. Selecione a opo Ativar backup em caso de falha local.
6. Execute a aplicao e teste a nova funcionalidade.

21.4.1 KB
Hot-Standby: Dvidas Mais Frequentes (FAQ)
KB-26057: Comportamento do Viewer durante troca de servidores
Hot-Standby 174
CAPTULO
Domnios Remotos
22
A configurao de Domnios Remotos define que haja 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 pode acessar objetos do Domnio Servidor de duas
maneiras, atravs de scripts ou de Associaes. Para que a conexo entre os Domnios possa ocorrer, todos os E3
Servers envolvidos devem estar executando 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 Arquitetura
Em uma arquitetura de Domnios Remotos, cada servidor contm uma aplicao completa com banco de dados,
comunicao e visualizao. O Domnio Cliente tem acesso a todos os servidores. Esta estrutura recomendada para
aplicaes que precisam centralizar informaes, assim como para aplicaes que precisam dividir processamento.
Arquitetura de Domnios Remotos
175 Domnios Remotos

22.2 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. Desta forma, o E3 Studio utiliza a cpia local para determinar quais objetos existem,
permitindo o trabalho offline.
22.3 Compartilhamento da Pasta do Domnio Servidor

No caso de Domnios Remotos, o E3 Server executa 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. Estes
servios que executam sem um domnio de rede Microsoft, e que queiram acessar recursos da rede, tm acesso
negado em funo de no terem credenciais e de estarem utilizando uma sesso nula.
Domnios Remotos 176

22.3.1 Configuraes Gerais
As configuraes mostradas a seguir devem ser feitas na mquina que roda o Domnio Servidor.
1. Se a mquina utiliza o Windows Server 2003 SP2 ou Windows Vista SP2, abra o aplicativo Diretiva de Segurana
Local (Local Security Policy) no menu Iniciar - Painel de Controle - Ferramentas Administrativas (Start - Control
Panel - Administrative Tools).
2. Na janela que se abre, selecione o item Diretivas Locais - Opes de Segurana (Local Policies - Security Options).
3. Clique duas vezes no item Acesso de rede: acesso annimo restrito a pipes nomeados e compartilhamentos
(Network access: Restrict anonymous access to Named Pipes and Shares) e, na janela que se abre, selecione o item
Desabilitado (Disabled).
Aba Configurao de Segurana Local
Se a mquina do Domnio Servidor utiliza o Windows XP SP3, a configurao deve ser feita diretamente no Registro
do Windows. Neste caso, siga estes procedimentos:
1. Selecione o item HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Lanmanserver\parameters.
2. Crie a chave RestrictNullSessAccess, do tipo DWORD, e coloque o valor 0 (zero).
177 Domnios Remotos

Varivel RestrictNullSessAccess
A configurao atravs do Registro do Windows tambm pode ser feita no Windows Server 2003 SP2 e Windows
Vista SP2. Segundo a Microsoft, a chave RestrictNullSessAccess especifica se o servidor limita 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 podem acessar apenas os diretrios
listados na chave NullSessionShares
Em qualquer um destes casos, necessrio reiniciar a mquina para que as alteraes tenham efeito. Alm disto,
necessrio configurar o compartilhamento e o NTFS para aceitarem o acesso do usurio annimo (Logon Annimo
ou Anonymous Logon) ou do usurio de rede (Network). Para isto, siga estes procedimentos:
1. Selecione a pasta que contm o Domnio Servidor, e que deve estar compartilhada.
2. Clique com o boto direito do mouse nesta pasta e selecione a opo Propriedades.
3. Na aba Compartilhamento, clique em Permisses.
Domnios Remotos 178

Propriedades da pasta
4. Adicione o usurio REDE ou o usurio LOGON ANNIMO, permitindo acesso para leitura pasta e clique em OK.
Adicionar usurio
179 Domnios Remotos

5. Selecione a aba Segurana e adicione novamente o usurio REDE ou LOGON ANNIMO (o mesmo que foi
adicionado na aba Compartilhamento). Clique em OK.
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.3.2 Aba Segurana

Em alguns casos, tambm pode ocorrer de a aba Segurana no estar visvel junto aba Compartilhamento, nas
propriedades da pasta. Isto ocorre porque em algumas verses do Windows, como o Windows XP rodando sem
pertencer a um domnio de rede Microsoft, o modo de compartilhamento simplificado habilitado por padro. Neste
caso, preciso trocar o modo de compartilhamento atravs da chave ForceGuest no Registro do Windows, em
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\LSA. A varivel deve ser ajustada para 0 (zero).
22.4 Licenas
Tanto o E3 Server executando o Domnio Cliente quanto o que executa o Domnio Servidor devem ter licenas
especficas para Domnios Remotos. Quando esta 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, possvel
estabelecer um nmero ilimitado de conexes.
22.5 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".
Domnios Remotos 180

22.6 Alias Local
O Alias Local uma ferramenta do Elipse E3 que garante que a aplicao que 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.
Esta 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.
Associao atravs do Domnio Remoto
Assim, as Associaes de todos os objetos de Tela ficam direcionadas para os Tags e objetos de dados da aplicao
local, porm via Domnio Remoto.
22.7 Permisses de Acesso

O acesso aos objetos de um Domnio Remoto pode ser limitado ao modo Somente Leitura. Quando isto ocorre, so
aplicadas as mesmas limitaes de acesso que se aplicam ao Viewer Only. Para isto, usa-se a configurao de
usurios na permisso Acesso remoto de escrita ao Domnio, dentro do item de segurana Domnio. Com isto,
pode ser necessrio que a conexo com o Domnio Remoto especifique um determinado usurio para poder ter
acesso completo aos objetos do Domnio.
181 Domnios Remotos

22.8 Exerccios
22.8.1 Tela Remota
1. Insira no projeto uma nova Tela chamada "TelaRemota", a ser aberta no Divisor Area_Central. Selecione a Tela
para ser a Tela inicial do Divisor.
2. Na TelaMenu, insira um boto para abrir a TelaRemota.
22.8.2 Compartilhamento
1. Compartilhe a pasta do projeto e execute as configuraes de permisso listadas no tpico Compartilhamento
da Pasta do Domnio Servidor.
Domnios Remotos 182

22.8.3 Alias Local
1. Abra a janela de opes do Domnio atravs do cone do E3 Admin na rea de Notificaes 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 em Aplicar e finalize a configurao clicando em OK.
4. Verifique no Organizer se aparece o projeto do Domnio configurado.
183 Domnios Remotos

Projetos de Domnios Remotos
5. Na TelaRemoto, crie um Display para exibir os valores de um Tag qualquer. Selecione, no AppBrowser, o Tag no
Domnio Remoto Dominio_Local.
Tag no Domnio Remoto
Domnios Remotos 184

22.8.4 Domnio Remoto
1. Abra a janela de opes do Domnio atravs do cone do E3 Admin na rea de Notificaes 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 este arquivo ou uma cpia local
Servidor principal: Nome do computador remoto na rede
Aba Domnios Remotos
3. Clique em Aplicar e finalize a configurao clicando em OK.
4. Verifique no Organizer o Domnio Remoto e seus projetos.
185 Domnios Remotos

Projetos dos Domnios Remotos
5. Na TelaRemoto, crie um Display para exibir os valores de um Domnio Remoto. Selecione, no AppBrowser, um
Tag no Domnio Remoto Remoto1.
Tag no Domnio Remoto
6. Crie um Display ou SetPoint para cada Tag que desejar e associe-o atravs do caminho do Domnio Remoto.
Domnios Remotos 186

TelaRemoto
7. Adicione quantos Domnios Remotos desejar.

22.9.1 KB
KB-26842: Unificando configuraes de usurios em vrios Domnios
KB-31: Como configurar domnios remotos em mquinas que no pertencem a um domnio de rede Microsoft
187 Domnios Remotos

CAPTULO
Elipse Mobile
23
O Elipse Mobile uma plataforma mvel para integrao com sistemas de automao, possibilitando monitorar
indicadores e comandar equipamentos de um processo.
23.1 Servidor
O Elipse Mobile Server um servidor HTTP que tem a funo de criar uma aplicao mobile. Este servidor pode se
conectar a uma aplicao E3, SCADA, EPM ou a qualquer servidor OPC DA.
23.2 Aplicativo
O Elipse Mobile um aplicativo para aparelhos mveis, disponvel para os sistemas operacionais iOS, Android e
Windows Phone.
Elipse Mobile
23.3 Exerccios
O objetivo deste exerccio realizar a comunicao entre a aplicao E3 desenvolvida no Treinamento e o servidor
Elipse Mobile.
Elipse Mobile 188

23.3.1 Servidor
1. Instale o Elipse Mobile Server na mquina local, verificando com o instrutor em que pasta se encontra o instalador
ou baixe-o diretamente no site da Elipse.
2. Aps a instalao, abre-se o navegador padro para definio do usurio e senha do servidor.
Tela inicial do Elipse Mobile Server
3. Clique em New app para criar uma nova aplicao.
Criar nova aplicao
189 Elipse Mobile

4. Defina um nome para esta aplicao.
5. No canto superior esquerdo, clique em e selecione a opo Connections.
Menu Connections
6. Clique em Add e selecione o item Elipse E3.
Elipse Mobile 190

Conexo E3
7. Nomeie a conexo como "Treinamento" e selecione o item Same machine na opo Server, para indicar que a
aplicao E3 est executando na mquina local.
Configurao da conexo E3
8. Teste a conexo clicando em Test e clique em OK para finalizar a configurao.
191 Elipse Mobile

9. Volte pgina inicial, clicando em Go to home page no alto da pgina.
10. Na pgina inicial, clique em Enter edit mode.
11. Adicione um novo controle do tipo Setpoint.
Adicionar SetPoint
12. Neste controle configurada a quantidade de vermelho do Tanque 1, acessando o Tag Interno Vermelho na
Pasta Tanque1.
Tag Interno
Elipse Mobile 192

13. Clique em Tag para acessar o Tag Interno Vermelho, conforme a figura a seguir.
Configurar o SetPoint
NOTA
Para acessar Tags de uma aplicao E3, o Domnio precisa estar ativo.
14. Configure as demais opes de acordo com sua preferncia e clique em OK.
15. Clique em Exit edit mode e clique no objeto Setpoint para alterar seu valor. Compare com o valor do Tag Interno
na aplicao E3.
193 Elipse Mobile

23.3.2 Aplicativo
1. Baixe e instale o aplicativo Elipse Mobile em seu aparelho mvel.
2. Acesse a rede onde o computador com o Elipse Mobile Server est instalado, utilizando uma conexo Wi-Fi. A
aplicao s est disponvel em uma rede sem fio.
3. Abra o aplicativo Elipse Mobile no celular e digite o endereo IP da mquina onde o Elipse Mobile Server est
executando, seguido da porta TCP/IP "8080", digitando tambm o usurio e a senha criados no servidor.
Dados para a conexo
4. Para descobrir o endereo IP do servidor, digite o comando ipconfig no prompt de comando do Windows,
verificando o item Endereo IPv4 (IPv4 Address).
Elipse Mobile 194

Comando ipconfig
Caso no seja possvel estabelecer a conexo, provavelmente o Firewall do Windows est bloqueando a porta TCP/IP
8080. Para configurar o Firewall do Windows, siga estes procedimentos, de acordo com o sistema operacional.
Windows XP SP3
1. V ao menu Iniciar - Painel de Controle (Start - Control Panel).
2. Clique em Central de Segurana (Security Center).
3. Clique em Firewall do Windows (Windows Firewall).
4. Selecione a aba Excees (Exceptions) e clique em Adicionar Porta (Add Port).
5. Digite um nome e o nmero da porta a ser liberada. Deixe a opo Protocolo (Protocol) selecionada como TCP.
6. Clique em OK para salvar as alteraes.
Windows Vista SP2
3. Selecione a aba Excees (Exceptions) e clique em Adicionar Porta (Add Port).
4. Digite um nome e o nmero da porta a ser liberada. Deixe a opo Protocolo (Protocol) selecionada como TCP.
5. Clique em OK para salvar as alteraes.
Windows 7 SP1, Windows 8, Windows 8.1 e Windows 10
3. Clique em Configuraes Avanadas (Advanced Settings).
4. Clique com o boto direito do mouse no item Regras de Sada (Outbound Rules) e selecione a opo Nova Regra
(New Rule).
195 Elipse Mobile

5. Na janela Tipo de Regra (Rule Type), selecione o item Porta (Port) e clique em Avanar (Next).
6. Na janela Protocolo e Portas (Protocol and Ports), selecione a opo TCP e, no item Portas remotas especficas
(Specific remote ports), digite o nmero da porta a ser liberada e clique em Avanar (Next).
7. Na janela Ao (Action), selecione o item Permitir a conexo (Allow the connection) e clique em Avanar (Next).
8. Na janela Perfil (Profile), deixe selecionadas as opes Domnio (Domain), Particular (Private) e Pblico (Public) e
clique em Avanar (Next).
9. Na janela Nome (Name), digite um nome e uma descrio (opcional) para a porta e clique em Concluir (Finish)
para salvar as alteraes e fechar a janela.
Elipse Mobile 196

CAPTULO
Exerccios de Reviso
24
Esta seo contm exerccios de reviso de todo o contedo do Tutorial.
197 Exerccios de Reviso

24.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 isto pediu que fosse
desenvolvido um supervisrio com os seguintes requisitos:
Simular os valores dos quatro nveis do equipamento em falta (valores entre 0 e 100)
A Tela principal deve ter uma imagem da minerao
Imagem da minerao
Sobre cada tanque, visualizar o nvel atravs de uma barra
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
Cores dos nveis
Exerccios de Reviso 198

MNIMO MXIMO COR
90 100 Vermelho
70 90 Amarelo
30 70 Branco
10 30 Azul
0 10 Verde
Sinalizar na Tela os alarmes de todos os nveis, conforme a tabela a seguir
Limites dos alarmes
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
Em uma segunda Tela, deve ser possvel visualizar os quatro nveis em um grfico, onde possvel escolher atravs
de botes qual informao exibir simultaneamente

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

24.2 Resoluo
Simular os valores dos quatro nveis do equipamento em falta (valores entre 0 e 100)
1. Para simular valores, criar Tags do tipo Demo, com os limites mximo e mnimo conforme especificao.
Tags de tipo Demo
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. Abrir a janela de propriedades do Retngulo e selecionar a aba Associao.
3. Criar uma Associao entre a propriedade VerticalPercentFill e o Tag Nivel correspondente.
Associao com a propriedade VerticalPercentFill
Exibir o valor do nvel na Tela formatada com sua unidade de engenharia igual a "%", uma casa decimal e
obedecendo a tabela de cores
1. Como so 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 mude o nome para "DisplayNivel".
DisplayNivel

4. Crie uma propriedade com o nome "Nivel", do tipo Double.
Propriedade Nivel
5. Desenhe um Display.
6. Formate o Display com a expresso '0.0 "%"'.
7. Crie uma Associao Simples entre a propriedade Nivel e a propriedade Value do Display.
Associao com a propriedade Nivel
8. Crie uma Associao por Tabela na propriedade ForegroundColor, informando os limites e as cores desejadas.
Na propriedade Fonte, selecione a propriedade Nivel criada anteriormente.
Associao por Tabela
10. Insira na Tela um XControl do tipo DisplayNivel.
11. Crie uma Associao Simples entre a propriedade Nivel e o Tag desejado.
Associao Simples
Sinalizar na Tela os alarmes de todos os nveis, conforme tabela
1. Se no existir no Domnio, insira um objeto Servidor de Alarmes.
2. Se no existir no Domnio, insira um objeto Configurao de Alarmes.
Servidor e Configurao de
Alarmes
3. Na Configurao de Alarmes, insira uma rea de Alarme.
4. Na rea de Alarme, insira um Alarme Analgico.

Alarme Analgico
5. Abra a janela de propriedades da Fonte de Alarme e selecione a aba Analgico. Informe os limites e mensagens
de alarmes, conforme a tabela.
Aba Analgico
6. Na coluna Fonte, selecione o Tag que deseja monitorar o alarme.
7. Insira quantos alarmes forem necessrios e configure-os seguindo os passos anteriores.
Alarmes
Na Tela principal deve ser possvel identificar o usurio logado
1. Crie um Display na Tela.
2. Crie uma Associao Simples entre a propriedade Value do Display e a propriedade User do Viewer.
3. Insira um boto ao lado do Display.
Boto Login
4. No boto, crie o script a seguir.

Application.Login(True)
5. Selecione o menu Arquivo - Usurios e crie pelo menos um usurio.

Menu Arquivo - Usurios
Um usurio pertencente ao grupo Manuteno NO pode reconhecer alarmes
1. Selecione o menu Arquivo - Usurios.
2. Crie o grupo Manuteno.
3. Insira um usurio no grupo Manuteno.
4. Na aba Permisses, bloqueie o reconhecimento de alarmes para o grupo Manuteno.

Aba Permisses
Em uma segunda Tela, deve ser possvel visualizar os quatro nveis em um grfico, onde possvel escolher atravs
de botes qual informao exibir simultaneamente
1. Crie uma nova Tela.
2. Insira um objeto E3Chart nesta Tela.
3. Abra a janela de propriedades do E3Chart e selecione a aba Penas.
4. Insira uma Pena.
5. Escolha um nome e uma cor.
6. Na aba Dados, mantenha a Pena como Tempo Real e selecione o Tag no campo Link do Eixo Vertical.
7. Repita os passos anteriores para incluir as demais Penas.
Aba Penas
8. Na Tela principal, crie um boto para abrir a Tela do grfico.
Armazenar os dados de nvel a cada dois segundos em um banco de dados
1. Se no existir, insira um objeto Banco de Dados e configure-o.

2. Insira um objeto Histrico no projeto.
3. Crie campos para cada informao que deseja armazenar e associe-os aos Tags desejados na coluna Fonte.
Coluna Fonte
4. Abra a janela de propriedades do Histrico e configure o nome do Banco de Dados, nome da tabela
(TabelaNivel) e tempo de gravao (2000 ms).
Aba Histrico
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. Abra a janela de propriedades, selecione a aba Consulta e clique em Configurar.

Configurar a Consulta
3. Configure a Consulta para buscar no Banco de Dados a tabela criada.
4. Escolha os campos que deseja buscar e, na aba Visualizar, clique em para verificar os dados.
Aba Visualizar
Um relatrio com os dados de nvel armazenados no banco de dados deve ser exportado para o formato PDF
1. Insira um Relatrio no projeto, com o nome de "RelatorioNivel".
2. Configure a Consulta do Relatrio para buscar no Banco de Dados a tabela desejada.

Configurar Consulta
3. Escolha os campos Nivel e E3TimeStamp.
4. Insira na seo Detail um objeto SetPoint para cada coluna escolhida na Consulta. Preencha a propriedade
DataField com o nome da coluna.
Seo Detail
5. Utilize um objeto Label para escrever o ttulo das colunas (propriedade Caption).
6. Insira na Tela um boto com o seguinte script:

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

Anotaes
A
Anotaes
Anotaes
Matriz Filial SP
Rua 24 de Outubro, 353 - 10 andar Rua dos Pinheiros, 870 - Conj. 141/142
90510-002 Porto Alegre 05422-001 So Paulo - SP
Fone: (+55 51) 3346-4699 Fone: (+55 11) 3061-2828
Fax: (+55 51) 3222-6226 Fax:(+55 11) 3086-2338
E-mail: elipse-rs@elipse.com.br E-mail: elipse-sp@elipse.com.br
Filial PR Filial MG
Av. Sete de Setembro, 4698/1705 Rua Antnio de Albuquerque, 156
80240-000 Curitiba - PR 7 andar Sala 705
Fone: (+55 41) 4062-5824 30112-010 Belo Horizonte - MG
E-mail: elipse-pr@elipse.com.br Fone: (+55 31) 4062-5824
E-mail: elipse-mg@elipse.com.br
Filial RJ Taiwan
Praia de Botafogo, 300/525 9F., No.12, Beiping 2nd St., Sanmin Dist.
22250-044 Rio de Janeiro - RJ 807 Kaohsiung City - Taiwan
Fone: (+55 21) 2158-1015 Fone: (+886 7) 323-8468
Fax: (+55 21) 2158-1099 Fax: (+886 7) 323-9656
E-mail: elipse-rj@elipse.com.br E-mail: evan@elipse.com.br
Consulte nosso website para informaes sobre o representante do seu estado.

www.elipse.com.br
kb.elipse.com.br
forum.elipse.com.br
www.youtube.com/elipsesoftware
elipse@elipse.com.br
Gartner, Cool Vendors in Brazil 2014, April 2014.

Gartner does not endorse any vendor, product or service depicted in its
research publications, and does not advise technology users to select only
those vendors with the highest ratings. Gartner research publications consist
of the opinions of Gartners research organization and should not be
construed as statements of fact. Gartner disclaims all warranties, expressed or
implied, with respect to this research, including any warranties of
merchantability of fitness for a particular purpose.

E3tutorial Developer Portugues

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 Portugues

Enviado por

Direitos autorais:

Formatos disponíveis

Tutorial do E3

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

1.1 A Elipse Software

Tela principal da aplicao

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

1.3.2 Arquitetura do Treinamento

2.1 Elipse Knowledgebase

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

Login: Serve apenas para uso interno da Elipse Software

As demais sees existentes na pgina principal do Knowledgebase so:

Caixa de dilogo inicial do E3 Studio

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

Opes disponveis na caixa de dilogo inicial do E3

Criar um Domnio novo Cria um novo Domnio atravs do Assistente de

Abrir um Domnio existente Abre um Domnio existente dentre os ltimos editados.

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

3.1.3 Configurao do Domnio

Janela do Organizer em modo Domnio

3.2 Execuo de um Domnio

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

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

Selecionar o tipo de aplicao

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

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

Configurar um driver de comunicao

9. Clique em Concluir para gerar a aplicao.

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

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

3.4 Exerccios Complementares

Objetos que podem ser inseridos no Servidor de Dados

Tag Demo Objeto que gera valores de acordo com a forma de

Tag Interno Objeto de propsito genrico, utilizado para guardar

Tag Timer Objeto para contagem de tempo e programao de

Pasta de Dados Define grupos e subdiretrios para a organizao das

4.1 Regras para Nomes de Tags

O nome do Tag no pode ser estritamente numrico

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

Inserir Tag Demo

Propriedades dos Tags Demo

NAME DOCSTRING MINIMUM MAXIMUM PERIOD SCAN TYPE

Nivel2 Nvel do 0 100 2000 200 0 - Random

Temp1 Temperatura 20 80 20000 500 1 - Sine

Temp2 Temperatura 20 80 10000 500 0 - Random

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

Selecionar tipo de dado

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

Criar Tag Demo no Viewer

2. Configure o Tag Anima com os seguintes valores:

Menu de diviso do Quadro

Estrutura de Telas e Quadros 22

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

23 Estrutura de Telas e Quadros

Estrutura de Telas e Quadros 24

Aba Erros de Comunicao

25 Estrutura de Telas e Quadros

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

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

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

Estrutura de Telas e Quadros 26

Configurar como Divisor Principal

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

27 Estrutura de Telas e Quadros

5.2.3 Tela Alarmes