Apostila Desenvolvedores PDF

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

Verso 4.7.305 (04/07/2016)
Sumrio
1 Apresentao
........................................................................................................................................................................ 1
1.1 A..................................................................................................................................................................
Elipse 1
1.2 Mdulos
..................................................................................................................................................................
do E3 1
1.3 O..................................................................................................................................................................
Treinamento 1
2 Elipse
........................................................................................................................................................................
Knowledgebase 5
2.1 Elipse
..................................................................................................................................................................
Knowledgebase 5
2.2 Busca
..................................................................................................................................................................
no Knowledgebase 5
2.3 Categorias
.................................................................................................................................................................. 6
3 Iniciando
........................................................................................................................................................................
a Aplicao 8
3.1 Criando
..................................................................................................................................................................
a Aplicao 8
3.2 Execuo
..................................................................................................................................................................
de um Domnio 11
3.3 Exerccios
.................................................................................................................................................................. 11
3.4 Exerccios
..................................................................................................................................................................
Complementares 14
4 ........................................................................................................................................................................
Simulao de Valores 15
4.1 Regras
..................................................................................................................................................................
para Nomes de Tags 15
4.2 Exerccios
.................................................................................................................................................................. 15
5 ........................................................................................................................................................................
Estrutura de Telas e Quadros 19
5.1 Viewer
.................................................................................................................................................................. 20
5.2 Exerccios
.................................................................................................................................................................. 22
5.3 Exerccios
..................................................................................................................................................................
Complementares 25
6 ........................................................................................................................................................................
Telas e Objetos de Tela 28
6.1 Tela
.................................................................................................................................................................. 28
6.2 Controles
..................................................................................................................................................................
Microsoft Forms 29
6.3 Galeria
.................................................................................................................................................................. 30
6.4 Exerccios
.................................................................................................................................................................. 30
6.5 Exerccios
..................................................................................................................................................................
Complementares 34
7 ........................................................................................................................................................................
Associaes 35
7.1 Tipos
..................................................................................................................................................................
de Associao 35
7.2 Edio
..................................................................................................................................................................
de Associaes 38
7.3 Valores
..................................................................................................................................................................
Booleanos 39
7.4 Exerccios
.................................................................................................................................................................. 39
8 ........................................................................................................................................................................
Comunicao 43
8.1 Elipse
..................................................................................................................................................................
Modbus Simulator 43
8.2 Driver
..................................................................................................................................................................
de Comunicao 44
8.3 Driver
..................................................................................................................................................................
de Comunicao OPC 44
8.4 Exerccios
.................................................................................................................................................................. 45
8.5 Exerccios
..................................................................................................................................................................
Complementares 53
9 ........................................................................................................................................................................
Introduo aos Scripts 55
9.1 Definindo
..................................................................................................................................................................
Scripts 55
9.2 Eventos
.................................................................................................................................................................. 60
9.3 Mtodos
.................................................................................................................................................................. 61
9.4 Propriedades
.................................................................................................................................................................. 61
9.5 Exerccios
.................................................................................................................................................................. 61
9.6 Exerccios
..................................................................................................................................................................
Complementares 63
10........................................................................................................................................................................
Segurana e Usurios 64
10.1..................................................................................................................................................................
Usurios 64
10.2..................................................................................................................................................................
Grupos 64
10.3..................................................................................................................................................................
Permisses 65
10.4..................................................................................................................................................................
Proteo 66
10.5..................................................................................................................................................................
Exerccios 67
10.6..................................................................................................................................................................
Exerccios Complementares 72
I
11........................................................................................................................................................................
Configurao de Alarmes 74
11.1..................................................................................................................................................................
Servidor de Alarmes 74
11.2..................................................................................................................................................................
11.3..................................................................................................................................................................
E3Alarm 77
11.4..................................................................................................................................................................
Exerccios 78
11.5..................................................................................................................................................................
12........................................................................................................................................................................
Bibliotecas ElipseX: XControls 83
12.1..................................................................................................................................................................
Criao de Bibliotecas do Usurio 83
12.2..................................................................................................................................................................
Exerccios 86
13........................................................................................................................................................................
Bibliotecas ElipseX: XObjects 91
13.1..................................................................................................................................................................
Quando Criar um ElipseX 91
13.2..................................................................................................................................................................
Exerccios 91
14........................................................................................................................................................................
Tela Indexada 96
14.1..................................................................................................................................................................
Arquitetura da Informao 96
14.2..................................................................................................................................................................
Exerccios 97
14.3..................................................................................................................................................................
15........................................................................................................................................................................
Armazenamento de Dados 99
15.1..................................................................................................................................................................
Servidor de Alarmes 99
15.2..................................................................................................................................................................
Histricos 99
15.3..................................................................................................................................................................
Chave Primria 99
15.4
..................................................................................................................................................................
ndices 100
15.5
..................................................................................................................................................................
Exerccios 100
15.6
..................................................................................................................................................................
16
........................................................................................................................................................................
Consultas 108
16.1
..................................................................................................................................................................
Criando uma Consulta 108
16.2
..................................................................................................................................................................
E3Browser 109
16.3
..................................................................................................................................................................
Exerccios 110
17
........................................................................................................................................................................
Filtros na Consulta 113
17.1
..................................................................................................................................................................
Criando e Acessando Variveis 113
17.2
..................................................................................................................................................................
Exemplo de Filtros 113
17.3
..................................................................................................................................................................
Exerccios 114
17.4
..................................................................................................................................................................
18
........................................................................................................................................................................
Grficos e E3Chart 119
18.1
..................................................................................................................................................................
Configuraes das Penas 119
18.2
..................................................................................................................................................................
Exerccios 120
19
........................................................................................................................................................................
Relatrios 125
19.1
..................................................................................................................................................................
Objetos do Relatrio 126
19.2
..................................................................................................................................................................
Exerccios 127
20
........................................................................................................................................................................
Frmulas 133
20.1
..................................................................................................................................................................
Exerccios 133
20.2
..................................................................................................................................................................
21
........................................................................................................................................................................
Hot-Standby 136
21.1
..................................................................................................................................................................
Arquitetura 136
21.2
..................................................................................................................................................................
Configuraes do Hot-Standby 136
21.3
..................................................................................................................................................................
Exerccios 139
21.4
..................................................................................................................................................................
22
........................................................................................................................................................................
Domnios Remotos 141
22.1
..................................................................................................................................................................
Arquitetura 141
22.2
..................................................................................................................................................................
Configurao no Studio 141
22.3
..................................................................................................................................................................
Compartilhamento da Pasta do Domnio Servidor 141
22.4
..................................................................................................................................................................
Licenas 145
22.5
..................................................................................................................................................................
Sintaxe dos Links 145
II
22.6
..................................................................................................................................................................
Alias Local 145
22.7
..................................................................................................................................................................
Permisses de Acesso 146
22.8
..................................................................................................................................................................
Exerccios 146
22.9
..................................................................................................................................................................
23
........................................................................................................................................................................
Elipse Mobile 151
23.1
..................................................................................................................................................................
Servidor 151
23.2
..................................................................................................................................................................
Aplicativo 151
23.3
..................................................................................................................................................................
Exerccios 151
24
........................................................................................................................................................................
Exerccios de Reviso 158
24.1
..................................................................................................................................................................
Exerccio 158
24.2
..................................................................................................................................................................
Resoluo 160
III
CAPTULO
1 Apresentao
Este Tutorial serve como apoio ao mdulo de treinamento para execuo e programao do E3. Com ele, voc acompanhar o
contedo do curso. Durante as aulas, fique vontade para praticar o que voc aprendeu e para resolver suas dvidas com o
instrutor. No treinamento apresentado um estudo de caso que simula uma aplicao real, um sistema de superviso e
controle.
1.1 A Elipse
A Elipse Software uma empresa genuinamente brasileira, com foco na produo de software de superviso para automao
industrial, surgida em Porto Alegre no incio dos anos 1990.
Seu primeiro produto foi o Elipse 21, um software para a plataforma DOS, que era conhecido por sua facilidade de operao e
compatibilidade com diferentes fabricantes.
Em 1996 a Elipse lana a primeira verso do Elipse Windows, que mais tarde se tornaria o Elipse SCADA. Desde esta poca,
foram instaladas milhares de cpias deste software no Brasil.
Em 2000 a Elipse iniciou o desenvolvimento do E3, a terceira gerao de software de superviso da empresa. Desde seu
lanamento comercial em 2001, milhares de licenas deste software j foram instaladas e o E3 vem sendo utilizado em
sistemas diversos, como minerao, Centros de Operao de empresas eltricas, plantas industriais de diversas finalidades,
sistemas de telemedio e controle de energia, automao e controle predial, entre outros.
A Elipse Software trabalha em parceria com distribuidores internacionais localizados em pases estratgicos como Alemanha,
Holanda, Taiwan, ndia, Canad e outros, alm de manter escritrio prprio nos Estados Unidos, na cidade de Raleigh,
Carolina do Norte.
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.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.
Apresentao 1
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!
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.
2 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 3
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
4 Apresentao
CAPTULO
2 Elipse Knowledgebase
O Elipse Knowledgebase tem como finalidade ajudar o usurio dos softwares da Elipse a encontrar respostas rpidas para
dvidas ou problemas que esteja enfrentando durante a sua utilizao, seja no desenvolvimento de aplicaes ou depois de
t-las prontas. Este espao nada mais do que um portal onde muitas informaes tcnicas e dicas esto concentradas. A sua
base de informaes constantemente atualizada e tem uma linguagem simples que visa o rpido entendimento de quem est
utilizando. 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
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.
Elipse Knowledgebase 5
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.
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
6 Elipse Knowledgebase
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 7
CAPTULO
3 Iniciando a Aplicao
Aps instalar o software, tem-se um grupo de programas chamado Elipse E3, com um cone p ara 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 Ini ci a o E3 Studi o, ma s n o a bre nenhum Domni o.
Criar um Domnio novo Cri a um novo Domni o a tra vs do As s i s tente de Apl i ca es do
E3, que pede o nome e o ca mi nho do novo Domni o.
Abrir um Domnio existente Abre um Domni o exi s tente dentre os l ti mos edi ta dos .
Cl i ca ndo em Outros arquivos, pode-s e l oca l i za r um Domni o em
um di retri o es pecfi co.
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.
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.
Iniciando a Aplicao 9
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 ser apresentado em um
captulo posterior.
Configurar um driver de comunicao
7. Responda No pergunta Voc quer guardar dados em disco?. Este tema ser apresentado em captulo posterior.
Configurar um banco de dados

8. Responda No pergunta Voc deseja monitorar alarmes em sua aplicao?. Este tema ser 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
4 Simulao de Valores
O Servidor de Dados o mdulo responsvel pela execuo e gerenciamento de Tags e objetos que no estejam envolvidos
diretamente com a comunicao. Atravs do Servidor de Dados pode-se configurar Tags internos e Tags de simulao, alm de
inserir XObjects, que so os objetos de dados das bibliotecas ElipseX (vistas mais adiante). Alguns dos objetos que podem ser
inseridos no Servidor de Dados esto descritos na tabela a seguir.
Objetos que podem ser inseridos no Servidor de Dados
OBJETO DESCRIO
Tag Contador Objeto que executa uma conta gem de tempo (em s egundos )
a t a ti ngi r um va l or pr-determi na do, ou que executa uma
certa conta gem de tempo i ndefi ni da mente.
Tag Demo Objeto que gera va l ores de a cordo com a forma de onda .
uti l i za do pa ra s i mul a o de va l ores . Permi te gera r curva s
defi ni da s ou va l ores a l ea tri os .
Tag Interno Objeto de props i to genri co, uti l i za do pa ra gua rda r va l ores
de qua l quer ti po, i ncl ui ndo nmeros , textos e outros objetos .
Tag Timer Objeto pa ra conta gem de tempo e progra ma o de
a ti vi da des . Es ta bel ece hor ri os , com repeti es , pa ra
executa r a es .
Pasta de Dados Defi ne grupos e s ubdi retri os pa ra a orga ni za o da s
i nforma es . Nova s pa s ta s podem s er i ns eri da s dentro de
outra s , conforme a neces s i da de.
NOTA: Os objetos i ns eri dos no Servi dor de Da dos s o executa dos pel o E3 Server, porta nto es t o pres entes no Servi dor. Es ta
i nforma o retra ta o modo como o E3 tra ba l ha .
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
4.1.1 Regra dos Colchetes

Ao fazer referncia a um objeto por script ou ao us-lo em alguma Associao, deve-se levar em conta as seguintes regras:
Se o primeiro caractere no for uma letra ou um caractere sublinhado, o nome deve estar entre colchetes
Se algum dos demais caracteres (do segundo em diante) no for uma letra, um nmero ou um caractere sublinhado, o
nome tambm deve estar entre colchetes
Caso existam caracteres especiais (por exemplo, acentos), o nome deve estar entre colchetes
4.2 Exerccios
4.2.1 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 Ta nque 0 100 2000 200 0 - Ra ndom
1
Nivel2 Nvel do Ta nque 0 100 2000 200 0 - Ra ndom
2
Temp1 Tempera tura do 20 80 20000 500 1 - Si ne
Ta nque 1
Temp2 Tempera tura do 20 80 10000 500 0 - Ra ndom
Ta nque 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
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
5 Estrutura de Telas e Quadros
O Quadro o objeto que organiza e estrutura a interface, criando visualizaes compostas para o usurio dentro da janela
principal do Viewer ou do navegador.
No Quadro pode-se criar Divisores para visualizar diferentes Telas ao mesmo tempo. Cada Divisor tambm pode mostrar uma
URL, uma planilha do Excel, um documento do Word ou um arquivo PDF.
A disposio dos Divisores dentro do Quadro pode ser horizontal ou vertical. Dentro de cada Divisor podem ser inseridos
outros Divisores. A cada par de novos Divisores criados pelas opes Dividir Horizontalmente e Dividir Verticalmente, h
sempre um Divisor Principal e um Divisor Secundrio. Apenas o Divisor Principal 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.

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 exi s ti r um objeto Vi ewer em um Domni o.
Na aba Visualizador da Janela de Propriedades so definidas as configuraes de visualizao do Viewer.

Aba Visualizador
Atravs da aba Configurao, pode-se editar as opes relativas janela, ao ttulo e resoluo do Viewer.
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: Ta mbm pos s vel i ns eri r Ta gs no Vi ewer.
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 propri eda de SplitValue ta mbm pode s er confi gura da em pi xel s , uti l i za ndo o prefi xo "px". Por exempl o, "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
6 Telas e Objetos de Tela
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.
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
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) Uti l i za do pa ra da r a o us u ri o uma
es col ha entre doi s va l ores , ta i s como
Si m e N o, True e Fa l s e ou On e Off.
Boto de Opes (Option Button) Uti l i za do pa ra mos tra r s e um i tem
i ndi vi dua l de um grupo es t
s el eci ona do.
Boto de Comando (Command Button) Uti l i za do pa ra executa r uma a o
es pecfi ca a o pres s i on -l o.
Texto (Label) Uti l i za do pa ra exi bi r um texto des cri ti vo,
como ttul os , l egenda s , etc.
Lista (List Box) Exi be uma l i s ta de va l ores .
Barra de Rolagem (Scroll Bar) Retorna ou defi ne o va l or da
propri eda de de outro objeto, de a cordo
com a pos i o da ca i xa de rol a gem.
Boto Incremento-Decremento (Spin Button) Uti l i za do pa ra i ncrementa r e
decrementa r um va l or.
Editor de Texto (Text Box) Uti l i za do pa ra exi bi r i nforma es
di gi ta da s pel o us u ri o na Tel a .
Boto Liga-Desliga (Toggle Button) Semel ha nte a o Bot o de Coma ndo,
porm neces s i ta um s egundo coma ndo
do us u ri o pa ra vol ta r a o es ta do norma l .
Lista de Seleo (Combo Box) Combi na os recurs os de uma Li s ta e de
um Edi tor de Texto. O us u ri o pode
di gi ta r um novo va l or ou s el eci ona r um
va l or exi s tente.
NOTA: Outros objetos Acti veX de tercei ros ta mbm podem s er uti l i za dos no E3, des de que s eja m devi da mente regi s tra dos . El es
podem s er a di ci ona dos a tra vs 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 executa r o E3 Studi o em modo Demo (s em l i cena ), a pena s o pri mei ro el emento de ca da conjunto de ca tegori a s de
s mbol os es t di s ponvel .
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: Pa ra edi ta r um Texto j exi s tente na Tel a , cl i que com o bot o di rei to do mous e no objeto e s el eci one o i tem Editar texto.
2. No centro da Tela, posicione o Texto "Treinamento E3 Studio".
DICA: Uti l i ze a s 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
7 Associaes
Associaes (ou Conexes) so ligaes feitas entre propriedades e objetos ou entre outras propriedades. As Associaes
trazem grande facilidade ao criar animaes e outros tipos de lgicas comuns, minimizando a utilizao de scripts.
Atravs da aba Associaes da janela de Propriedades, tem-se acesso a todas as propriedades disponveis do objeto a ser
tratado e todos os tipos possveis de 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.
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
Associaes 35
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
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.
36 Associaes
Associao Analgica
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
Associaes 37
7.1.6 Associao Reversa
A Associao Reversa uma Associao unidirecional do objeto para a fonte.
Associao Reversa
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.
38 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 Fa l s o
1 Verda dei ro
Ao utilizar o comando NOT, o E3 considera:

Valor do Tag com NOT
TAG NOT TAG VBSCRIPT
0 -1 Verda dei ro
1 -2 Verda dei ro
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 Fa l s o Verda dei ro
1 Verda dei ro Fa l s o
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
Associaes 39
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
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 Bra nco
70 90 Ama rel o
90 100 Vermel ho
1. Na propriedade ForegroundColor do Display, insira uma Associao por Tabela com o Tag Nivel1.
Associao por Tabela
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
40 Associaes
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.
7.4.5 Associao Bidirecional

1. Para cada SetPoint na TelaSinotico, crie uma Associao Bidirecional com o seu Tag respectivo, Vermelho, Verde e Azul.
Associaes 41
7.4.6 Expresso
1. Para poder modificar a cor do lquido, crie a Associao mostrada na figura a seguir.
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: Tra ba l he com os coma ndos Copiar (CTRL + C) e Colar (CTRL + V). Pa ra edi ta r uma As s oci a o cri a da a nteri ormente, us e a
tecl a 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.
42 Associaes
CAPTULO
8 Comunicao
O E3 permite a comunicao com equipamentos de aquisio de dados, controladores, CLPs (Controladores Lgicos
Programveis), UTRs (Unidades Terminais Remotas), ou qualquer outro tipo de equipamento, atravs de Drivers de Comunicao
ou Servidores OPC, de acordo com o tipo do equipamento ou tipo de comunicao 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 s i mul a dos . NOTA: Na vers o Demo es te ca mpo
tem um l i mi te de 10 PLCs .
Initial Port Porta ba s e uti l i za da pa ra a comuni ca o.
Random Values Ha bi l i ta ou des a bi l i ta a gera o a l ea tri a de va l ores .
Interval (ms) Interva l o de va ri a o dos va l ores , em mi l i s s egundos .
Connection Ti po de conex o a s i mul a r (a tua l mente a ni ca op o
di s ponvel TCP/IP).
Protocol Protocol o a s i mul a r (Modbus RTU ou Modbus TCP).
COILS Nmero de Coils a s er s i mul a do por PLC (l i mi te m xi mo de 255).
REGISTERS Nmero de Registers a s er s i mul a do por PLC (l i mi te m xi mo 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.
Comunicao 43
Quantidade de PLCs
NOTA: Os PLCs cri a dos cons ecuti va mente a o va l or confi gura do no ca mpo Initial Port uti l i za m s omente porta s di s ponvei s . No
exempl o a nteri or, s e a porta 503 es ti ver em us o por outra a pl i ca o, s o cri a dos PLCs na s porta s 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).
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 Defi ne grupos e s ubdi retri os pa ra a orga ni za o de
va ri vei s . N o tem rel a o di reta com o equi pa mento de
ca mpo.
Tag de Comunicao Uti l i za do pa ra defi ni r a comuni ca o com uma va ri vel (um
endereo de memri a ) do equi pa mento de a qui s i o.
Bloco de Comunicao Uti l i za do pa ra defi ni r a comuni ca o com di vers a s va ri vei s
(v ri os endereos de memri a em s equnci a ) do
equi pa mento de a qui s i o.
Elemento de Bloco Repres enta m ca da um dos endereos de um Bl oco e s o
uti l i za dos como s e fos s em Ta gs de Comuni ca o. Os
El ementos de Bl oco podem a ponta r pa ra ca da ndi ce dentro
de um Bl oco (corres pondendo a ca da va ri vel de i nteres s e).
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
44 Comunicao
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 Defi ne grupos ou s ubdi retri os pa ra a orga ni za o da s
va ri vei s .
Grupo OPC Agrupa uma s ri e de Ta gs OPC que compa rti l ha m os mes mos
pa r metros de a tua l i za o (tempo de va rredura e ba nda
morta ). obri ga tri o exi s ti r um Grupo OPC pa ra poder cri a r
Ta gs OPC.
Tag OPC Objeto pa ra l ei tura ou es cri ta de va l ores em um
equi pa mento. A l ei tura do Ta g fei ta a utoma ti ca mente pel o
Servi dor OPC, com tempo de va rredura defi ni do no Grupo OPC
onde el e es t i ns eri do.
Bloco OPC Pos s i bi l i ta a l ei tura ou es cri ta de um conjunto de va l ores .
Pa ra rea l i za r uma es cri ta , deve-s e a pena s a tri bui r um novo
va l or propri eda de Value.
Elemento de Bloco OPC Pos s i bi l i ta a l ei tura ou es cri ta de um dos El ementos do Bl oco
OPC onde el e es t i ns eri do. O Bl oco OPC l uma ta bel a de
da dos e es te objeto es t s empre a s s oci a do pos i o
defi ni da por s ua propri eda de Index, corres pondendo a uma
va ri vel de i nteres s e.
8.4 Exerccios
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.
Comunicao 45
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
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".
46 Comunicao
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).
Aba Modbus
7. Na aba Operations, verifique o cdigo das operaes para leitura e escrita que so necessrias para as leituras dos
Comunicao 47
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.
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.
48 Comunicao
Menu Configurao
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.
Comunicao 49
Janela Tag Browser
3. Feche a janela quando terminar de selecionar as variveis desejadas.
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
50 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
6. Aps a criao dos Tags, teste a comunicao.
Comunicao 51
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.
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 Tempera tura _T1 20 200 C 0 65535
2 Tempera tura _T2 20 200 C 0 65535
3 Ni vel _T1 0 100 % 0 65535
4 Ni vel _T2 0 100 % 0 65535
1. Altere as propriedades dos Tags Analgicos, conforme a figura a seguir.

52 Comunicao
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
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.
Comunicao 53
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.
8.5.2 KB
KB-14918: Contagem de Tags no Driver de Comunicao
54 Comunicao
CAPTULO
9 Introduo aos Scripts
Os Scripts so trechos de cdigo (programao) com os quais se pode criar procedimentos associados a eventos especficos,
permitindo grande flexibilidade no desenvolvimento e no uso de aplicaes. Todos os scripts esto associados a eventos, e
cada objeto do E3 possui uma lista de eventos previamente definidos, sendo possvel tambm definir novos eventos de
usurio.
De acordo com 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: Es ta mos tra ba l ha ndo a t a gora a pena s com propri eda des no E3 . J conhecemos a l guma s propri eda des dos objetos do
E3 e vi mos que temos dua s ma nei ra s de a l ter -l a s : na Ja nel a de Propri eda des ou por As s oci a es .
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).
9.1.1 Picks
Os Picks implementam uma forma amigvel de realizar procedimentos comuns em scripts, poupando tempo de escrita de
cdigo. Entre eles esto aes como troca de Tela ou atribuio de valores, que so bastante comuns na criao de um
projeto.

9.1.1.1 Executar Scripts
Permite a edio de um script personalizado que executado na ocorrncia do evento determinado.
Executar Script
9.1.1.2 Abrir Tela

Abre uma determinada Tela ou Quadro.
Pick Abrir Tela

9.1.1.3 Abrir Tela Modal
Abre uma Tela em estilo modal.
Pick Abrir Tela Modal
9.1.1.4 Executar Aplicao

Executa um programa especfico.
Pick Executar Aplicao

9.1.1.5 Carregar Valor
Carrega um valor em um Tag.
Pick Carregar Valor
9.1.1.6 Inverter Valor

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

Pick Inverter Valor
9.1.1.7 Imprimir Relatrio

Permite imprimir um Relatrio 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
10 Segurana e Usurios
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 confi gura r a s egura na , s omente os us u ri os l i s ta dos tm a ces s o a pl i ca o.
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
10.3 Permisses
A aba Permisses configura as permisses dos usurios e grupos para Telas, Alarmes, Domnio e Viewer. Uma verificao de
permisso consiste em uma informao que o membro do grupo tem sobre um comando que atua sobre um objeto especfico.
Por exemplo, o Usuario1 tem permisso para o comando Abrir sobre o objeto Tela1. Cada membro do grupo pode negar ou
afirmar a permisso de um comando, 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 i mpl ementa da s n o podem s er des fei ta s ca s o a s s enha s s eja m perdi da s . Porta nto, a o proteger
determi na do a rqui vo, ma ntenha a s s enha s a rma zena da s de modo s eguro. Is to ga ra nte o a ces s o a o a rqui vo s empre que
neces s ri o.
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: Confi gura es de s egura na n o s o a pl i ca da s a os us u ri os j exi s tentes , a pena s a o a l tera r ou cri a r um us u ri o.
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: neces s ri o ter um ba nco de da dos confi gura do na a pl i ca o.
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
11 Configurao de Alarmes
O mdulo de Alarmes do E3 consiste basicamente em duas unidades, cujo funcionamento interligado logicamente:
Servidor de Alarmes: Organiza o modo como os eventos e alarmes 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 Domni o pode ter s omente um objeto des te ti po, e s ua pres ena obri ga tri a pa ra que ha ja veri fi ca o de
a l a rmes .
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.
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 a s s oci a do quel a condi o de a l a rme, que a pa rece
no objeto de vi s ua l i za o (E3Al a rm), Ba nco de Da dos , etc. Pode
conter a t 255 ca ra cteres de texto.
Severidade Indi ca a gra vi da de do a l a rme ocorri do, podendo s er Baixa,
Mdia ou Alta. A s everi da de uti l i za da pa ra fi l tra gem e
ordena o de mens a gens .
Pede Ack Indi ca que o a l a rme deve s er reconheci do pel o opera dor pa ra
s er reti ra do da l i s ta de a l a rmes no E3Al a rm, ou a i nda s e
reconheci do a utoma ti ca mente qua ndo a va ri vel dei xa uma
condi o de a l a rme.
Mensagem de Retorno Sempre que uma Fonte de Al a rme s a i da condi o de a l a rme,
es ta mens a gem exi bi da nos objetos de vi s ua l i za o.
H vrios tipos de Fontes de Alarme que podem ser inseridas na rea de Alarme, descritas nos tpicos a seguir.
11.2.2.1 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
11.2.2.2 Banda Morta

Permite monitorar uma varivel analgica pela especificao de um limite mximo de diferena (valor de banda morta) em
relao a um valor de referncia (Setpoint).
Fonte de Alarme Banda Morta
11.2.2.3 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 Taxa de Variao
11.2.2.4 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 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
12 Bibliotecas ElipseX: XControls
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
O uso de Bibliotecas recomendado na maioria das aplicaes.
Bibliotecas de objetos
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, a pasta onde ela deve ser salva e clique em Avanar.
4. Determine as especificaes referentes ao Domnio.
5. Clique em Concluir.
Em uma biblioteca ElipseX podem ser inseridos dois tipos de objetos, os objetos grficos XControls e os objetos de dados
XObjects.
Podem ser inseridos nos XControls todos os itens disponveis para as Telas. Entre 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.
J as bibliotecas de dados podem conter quaisquer tipos de objetos no grficos, que so executados no E3 Server. Pode-se
inserir em um XObject os seguintes objetos: Driver de Comunicao, Servidor de Dados, Banco de Dados, Frmulas,
Configurao de Alarmes, Servidor de Alarmes, Objetos COM e outros XObjects.
Em um mesmo arquivo .lib pode existir qualquer nmero de componentes ElipseX, sejam eles XControls ou XObjects. Pode-se
ter tambm vrias bibliotecas diferentes (vrios arquivos .lib) no mesmo Domnio.
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 Determi na o nome da Propri eda de do XControl .
Tipo Determi na o ti po de da do s uporta do pel a Propri eda de.
Pblica Ha bi l i ta ou des a bi l i ta a vi s i bi l i da de da Propri eda de fora da
bi bl i oteca , i s to , determi na s e a Propri eda de ou n o
pbl i ca .

OPO DESCRIO
Persistente Determi na s e a Propri eda de s a l va no projeto ou n o.
Retentiva Determi na s e a Propri eda de retenti va ou n o. No ca s o de
XControl s , a s Propri eda des n o podem s er retenti va s .
Valor inicial Determi na o va l or i ni ci a l da Propri eda de.
Texto de Ajuda Texto de decl a ra o e documenta o da Propri eda de.
Note que outros objetos de Dados (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
13 Bibliotecas ElipseX: XObjects
Alm dos objetos grficos, pode-se criar uma biblioteca de dados, chamada XObject. Com ela, pode-se definir uma estrutura
de dados a ser executada no servidor. Tal estrutura 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. 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 e XObjects, o E3 Studio exibe para as
Telas somente os XControls, e para os Servidores de Dados somente 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: N o pos s vel copi a r uma Bi bl i oteca e uti l i za r os doi s a rqui vos (ori gi na l e cpi a ) no mes mo Domni o. Por exempl o, n o
s e pode copi a r um a rqui vo .l i b pa ra s epa r -l o em doi s novos a rqui vos .
13.2 Exerccios
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
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-s e a rra s ta r o objeto que s e des eja a s s oci a r a t a propri eda de des eja da .
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
14 Tela Indexada
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.
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.
96 Tela Indexada
Arquitetura
14.2 Exerccios
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
Tela Indexada 97
4. Selecione, utilizando o AppBrowser, o XControl ComandoBomba1 que est na TelaComando e, direita, selecione a
propriedade Fonte.
5. Digite " = Arg".
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
98 Tela Indexada
CAPTULO
15 Armazenamento de Dados
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
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
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
16 Consultas
O objeto Consulta (ou Query) auxilia no processo de definio de consultas no Banco de Dados da aplicao. Toda vez que o
E3 necessita buscar dados do Banco de Dados necessrio enviar um comando, de forma que se saiba quais os dados
desejados para aquele objeto. Para 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: Qua ndo s e cri a um objeto Rel a tri o ou um E3Brows er, o objeto Cons ul ta a di ci ona do a es te a utoma ti ca mente. No
enta nto, ta mbm s e pode i ns eri r uma Cons ul ta em uma Pa s ta de Da dos ou em uma Tel a e uti l i za r s eus da dos a tra vs de
s cri pts .
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.
108 Consultas
6. Na aba Visualizar pode-se realizar uma prvia da Consulta.
7. Na aba SQL pode-se visualizar e editar o cdigo SQL.
Janela de configurao da Consulta

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.
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.
Consultas 109
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.
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.
110 Consultas
Tabela Alarms
9. Selecione a aba Visualizar e clique em Executar Consulta para verificar o resultado da Consulta.
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.
Consultas 111
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.
112 Consultas
CAPTULO
17 Filtros na Consulta
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%>#
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"
17.3 Exerccios
1. Insira na TelaEventos dois SetPoints, chamados de spDataInicial e spDataFinal, e dois objetos do tipo Texto

SetPoints
2. Neste exerccio, 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 escolher a data inicial e a data final, preciso criar variveis de consulta. Configure o filtro
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
18 Grficos e E3Chart
O objeto E3Chart um componente ActiveX criado especialmente para trabalhar em conjunto com o E3. Com ele, possvel
exibir grficos com Tags variando em tempo real e tambm mostrar dados histricos gravados em um Banco de Dados.
Cada sequncia de dados representada no E3Chart atravs de Penas. Para cada Pena so associados dados, que podem ser
Tags ou campos de Consultas. possvel criar vrios eixos com escalas diferentes para serem associados aos dados das
Penas.
E3Chart
Para inserir este objeto em uma Tela, clique com o boto direito do mouse e selecione a opo Inserir - 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.
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 TelaMenu, 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 escolher a data inicial e data final visualizada no E3Chart, copie da TelaEventos os SetPoints com a data
inicial e data final para a TelaGrafico.
Data inicial e final

2. No SetPoint com a data inicial, crie uma Associao Bidirecional com a propriedade HorScaleBegin do E3Chart.
3. No SetPoint com a data final, crie uma Associao Bidirecional com a propriedade HorScaleEnd do E3Chart.

CAPTULO
19 Relatrios
O Relatrio um componente ActiveX chamado ActiveReport, que permite a visualizao e impresso de valores instantneos
de variveis do sistema e dados armazenados em Banco de Dados (Alarmes, Histricos, Consultas e Frmulas). Para utilizar o
Relatrio, clique com o boto direito do mouse no item Visualizao - Relatrios do Organizer, em modo Domnio, 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 Es ta Se o i mpres s a no i nci o do Rel a tri o. Uti l i za da pa ra
i mpri mi r ttul os de Rel a tri os , ta bel a s de s oma s , gr fi cos ou
qua l quer outra i nforma o que neces s i te a pa recer s omente
uma vez no i nci o do Rel a tri o.
Report Footer Es ta Se o i mpres s a no fi na l do Rel a tri o. Uti l i za da pa ra
i mpri mi r uma s oma de um Rel a tri o, tota i s gera i s ou qua l quer
outra i nforma o que neces s i te s er i mpres s a s omente uma
vez no fi na l do Rel a tri o.
Page Header Es ta Se o i mpres s a no topo de ca da p gi na do Rel a tri o.
a pri mei ra Se o i mpres s a na p gi na , exceto qua ndo es ta
p gi na contm a Se o Report Header. Uti l i za da pa ra i mpri mi r
ca bea l hos de col una s , nmeros de p gi na s , ttul os de
p gi na s ou qua l quer outra i nforma o que neces s i te s er
i mpres s a no i nci o de ca da p gi na .
Page Footer Es ta Se o i mpres s a uma vez na ba s e de ca da p gi na no
Rel a tri o. Us a da pa ra i mpri mi r tota i s de p gi na s , nmeros de
p gi na s ou qua l quer outra i nforma o que neces s i te s er
i mpres s a s omente uma vez na ba s e de ca da p gi na .
Detail Es ta Se o o corpo do Rel a tri o, que i mpri me uma vez pa ra
ca da regi s tro na fonte de da dos .
Group Header, Group Footer Um Rel a tri o pode ter ml ti pl os grupos a ni nha dos . Ca da
grupo pos s ui uma Se o Header e uma Se o Footer. A Se o
Header i mpres s a a ntes de qua l quer Se o Detail no grupo. A
Se o Footer i mpres s a depoi s da Se o Detail do grupo.
Relatrios 125
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) Atra vs des ta op o pos s vel vi s ua l i za r
uma prvi a da i mpres s o do Rel a tri o.
As s i m, pos s vel veri fi ca r confi gura es
de ma rgem, fi gura s , etc.
Configuraes do Relatrio (Report Settings) Nes ta s confi gura es pode-s e
determi na r Configuraes de Pgina,
Configuraes de Impresso, Configuraes
da Grade e Estilo do Relatrio.
Editor de Scripts Atra vs des ta op o pos s vel edi ta r
s cri pts pa ra o Rel a tri o. No ca mpo Object
neces s ri o es peci fi ca r o objeto onde
s e des eja cri a r o s cri pt e, no ca mpo
Events, o evento do Rel a tri o em que
ocorre a a o.
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 b s i co de reta que l i ga doi s
pontos qua i s quer. Permi te o des enho de
reta s , a tra vs de doi s pontos
es peci fi ca dos na s ua cri a o ou em
pol gonos .
Retngulo Es te objeto permi te o des enho de
ret ngul os , uti l i za ndo toda a l a rgura ou
a l tura do objeto. Cri a do a pa rti r de doi s
vrti ces .
Retngulo Arredondado Ret ngul o cri a do a tra vs de doi s vrti ces
com a op o dos ca ntos s erem
a rredonda dos a pa rti r de um fa tor de
a rredonda mento. Ao s er i ns eri do ou
edi ta do, exi be um pequeno ponto
prxi mo a o ca nto s uperi or es querdo do
objeto, que permi te modi fi ca r o fa tor de
a rredonda mento.
Elipse Es te objeto permi te o des enho de
crcul os e el i ps es , uti l i za ndo toda a
l a rgura ou a l tura e defi ni ndo o centro do
crcul o no centro do ret ngul o.
Figura Es te objeto permi te mos tra r i ma gens que
es teja m a rma zena da s em a rqui vos ,
es teja m el a s dentro ou fora do a rqui vo
do a pl i ca ti vo.
Texto Pos s i bi l i ta a cri a o de um texto. Ao
defi ni r a rea na Tel a , pode-s e di gi ta r
di reta mente o texto des eja do, que a cei ta
ta mbm ml ti pl a s l i nha s .
Campo de Dados Atra vs des te objeto pos s vel a s s oci a r
um ca mpo da ta bel a no Ba nco de Da dos .
Es te ca mpo es peci fi ca do na
propri eda de DataField.
126 Relatrios
CONE OPO DESCRIO
Cdigo de Barras Permi te gera r uma fi gura que converte
uma s equnci a de nmeros e ca ra cteres
em um cdi go de ba rra s . Es te cdi go
uma repres enta o numri ca ou
a l fa numri ca , uti l i za da pa ra fa ci l i ta r
di ferentes proces s os . Es te cdi go
deci fra do a tra vs de scanners, ca neta s e
equi pa mentos de l ei tura pti ca .
Quebra de Pgina um ponto em que uma p gi na termi na
e outra comea no Rel a tri o. Por
exempl o, pode-s e fora r uma quebra de
p gi na pa ra a s s egura r que o ttul o de um
ca ptul o comece s empre em uma nova
p gi na .
Tabela um objeto compos to por l i nha s e
col una s onde s o i ns eri dos textos ou
gr fi cos . As ta bel a s nos Rel a tri os s o
us a da s pa ra orga ni za r e a pres enta r
i nforma es . Pode-s e ta mbm us a r
ta bel a s pa ra cri a r layouts de p gi na .
E3Chart Es te objeto uti l i za do pa ra vi s ua l i za r os
da dos do Rel a tri o em forma to gr fi co.
Ma i ores i nforma es es t o des cri ta s no
ca ptul o Grficos e E3Chart.
Enviar para frente e Enviar para trs Atra vs des tes botes pos s vel envi a r
um objeto pa ra frente ou pa ra tr s de
outro. Ao s el eci ona r a s opes Enviar
para frente ou Enviar para trs, o objeto
s el eci ona do col oca do na pri mei ra ou
na l ti ma pos i o na ordem de
s obrepos i es .
Carregar Arquivo RPX Importa a confi gura o do Rel a tri o de
um a rqui vo externo.
Salvar Arquivo RPX Exporta a confi gura o do Rel a tri o pa ra
um a rqui vo externo.
NOTA: A op o Impressora do cone do E3 Server na rea de Noti fi ca es do Wi ndows exi be a l i s ta da s i mpres s ora s encontra da s
l oca l ou remota mente, e permi te que o us u ri o es col ha uma pa ra s er us a da pel o E3 Server.
19.2 Exerccios
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.
Relatrios 127
Configurar Consulta
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".
128 Relatrios
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.
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
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.
Relatrios 129
4. Na opo Sada, selecione o item Tela.
Pick do tipo Imprimir Relatrio

5. Execute a aplicao e teste as novas funcionalidades.
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
130 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
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.
Relatrios 131
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| *.*".
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.
132 Relatrios
CAPTULO
20 Frmulas
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 dado 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 uti l i za r um ba nco de da dos do ti po MDB (Mi cros oft Acces s ), i nteres s a nte cri a r s epa ra da mente a rqui vos es pecfi cos
pa ra a s Frmul a s e pa ra os Hi s tri cos , de forma a evi ta r que todos os da dos s e perca m ca s o ha ja um probl ema com a l gum
a rqui vo.
20.1 Exerccios
O objeto Frmula armazena informaes sobre as cores de tintas, formadas pela combinao de vermelho, verde e azul.
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".
Frmulas 133
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,
escolha a restrio absoluta de 0 a 255.
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.
134 Frmulas
Configurao dos Conjuntos de Valores
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 135
CAPTULO
21 Hot-Standby
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.
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.
136 Hot-Standby
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
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.
Hot-Standby 137
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.
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.
138 Hot-Standby
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.
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.
Hot-Standby 139
Pick Carregar Valor
10. Selecione a propriedade Value do Tag FalhaLocal e selecione o item True no campo Valor.
Valor do Tag FalhaLocal
21.3.3 Sincronismo 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
140 Hot-Standby
CAPTULO
22 Domnios Remotos
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: Domni os Remotos n o es t o di s ponvei s 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 conex o do REC e a s pos s vei s confi gura es de firewall a s s oci a da s ta mbm s e a pl i ca m a os Domni os
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
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 141

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).
142 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 143

Propriedades da pasta
4. Adicione o usurio REDE ou o usurio LOGON ANNIMO, permitindo acesso para leitura pasta e clique em OK.
Adicionar usurio
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.
144 Domnios Remotos

Aba Segurana
NOTA: Pa ra que a comuni ca o entre a s m qui na s funci one correta mente em tempo de execu o, o firewall deve s er
confi gura do correta mente, ou des a bi l i ta do.
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".
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.
Domnios Remotos 145

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.
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.
146 Domnios Remotos

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.
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.
Domnios Remotos 147

Tag no Domnio Remoto
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
148 Domnios Remotos

Aba Domnios Remotos
3. Clique em Aplicar e finalize a configurao clicando em OK.
4. Verifique no Organizer o Domnio Remoto e seus projetos.
Projetos dos Domnios Remotos

5. Na TelaRemoto, crie um Display para exibir os valores de um Domnio Remoto. Selecione, no AppBrowser, um Tag no
Domnio Remoto Remoto1.
Domnios Remotos 149

Tag no Domnio Remoto
6. Crie um Display ou SetPoint para cada Tag que desejar e associe-o atravs do caminho do Domnio Remoto.
TelaRemoto
7. Adicione quantos Domnios Remotos desejar.
22.9.1 KB
KB-26842: Unificando configuraes de usurios em vrios Domnios
KB: Como configurar domnios remotos em mquinas que no pertencem a um domnio de rede Microsoft
150 Domnios Remotos

CAPTULO
23 Elipse Mobile
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.
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.
Elipse Mobile 151

Tela inicial do Elipse Mobile Server
3. Clique em New app para criar uma nova aplicao.
Criar nova aplicao

4. Defina um nome para esta aplicao.
5. No canto superior esquerdo, clique em e selecione a opo Connections.
152 Elipse Mobile

Menu Connections
6. Clique em Add e selecione o item Elipse E3.
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.
Elipse Mobile 153

Configurao da conexo E3
8. Teste a conexo clicando em Test e clique em OK para finalizar a configurao.
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
154 Elipse Mobile

12. Neste controle configurada a quantidade de vermelho do Tanque 1, acessando o Tag Interno Vermelho na Pasta
Tanque1.
Tag Interno
13. Clique em Tag para acessar o Tag Interno Vermelho, conforme a figura a seguir.
Configurar o SetPoint
NOTA: Pa ra a ces s a r Ta gs de uma a pl i ca o E3, o Domni o preci s a es ta r a ti vo.
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.
Elipse Mobile 155

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).
Comando ipconfig
Caso no seja possvel estabelecer a conexo, provavelmente o Firewall do Windows est bloqueando a porta TCP/IP 8080.
156 Elipse Mobile

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).
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 157

CAPTULO
24 Exerccios de Reviso
Esta seo contm exerccios de reviso de todo o contedo do Tutorial.
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
MNIMO MXIMO COR
90 100 Vermel ho
70 90 Ama rel o
30 70 Bra nco
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"

A Anotaes
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.

Apostila Desenvolvedores PDF

Diunggah oleh

Informasi Dokumen

Judul Asli

Hak Cipta

Format Tersedia

Bagikan dokumen Ini

Bagikan atau Tanam Dokumen

Opsi Berbagi

Apakah menurut Anda dokumen ini bermanfaat?

Apakah konten ini tidak pantas?

Hak Cipta:

Format Tersedia

Apostila Desenvolvedores PDF

Diunggah oleh

Hak Cipta:

Format Tersedia

Tutorial do E3 para Desenvolvedores

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

1.3.1 Aplicao de Treinamento

Tela principal da aplicao

1.3.2 Arquitetura do Treinamento

2.1 Elipse Knowledgebase

2.2 Busca no Knowledgebase

Caixa de dilogo inicial do E3 Studio

3.1 Criando a Aplicao

3.1.3 Configurao do Domnio

3.1.5 Lista de Propriedades

3.3.1 Criando uma Aplicao

Selecionar o tipo de aplicao

Definir a resoluo do Viewer

Configurar um banco de dados

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

3.4 Exerccios Complementares

4.1 Regras para Nomes de Tags

4.1.1 Regra dos Colchetes

4.2.1 Simulao de Valores

4.2.3 Tags no Viewer

5 Estrutura de Telas e Quadros

Menu de diviso do Quadro

Estrutura de Telas e Quadros 19

NOTA: S pode exi s ti r um objeto Vi ewer em um Domni o.

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

20 Estrutura de Telas e Quadros

Estrutura de Telas e Quadros 21

22 Estrutura de Telas e Quadros

Configurar como Divisor Principal

5.2.2 Tela Menu

Estrutura de Telas e Quadros 23

5.2.3 Tela Alarmes

5.2.4 Tela ou Quadro Inicial da Aplicao

24 Estrutura de Telas e Quadros

Opo Tela ou Quadro Inicial

5.3 Exerccios Complementares

Estrutura de Telas e Quadros 25

Adicionar Tag Demo

26 Estrutura de Telas e Quadros

Estrutura de Telas e Quadros 27

6 Telas e Objetos de Tela

28 Telas e Objetos de Tela

6.2 Controles Microsoft Forms

Telas e Objetos de Tela 29

30 Telas e Objetos de Tela

6.4.2 Imagem de Fundo

2. No centro da Tela, posicione o Texto "Treinamento E3 Studio".

DICA: Uti l i ze a s opes Centralizar Horizontalmente e Centralizar Verticalmente.

6.4.4 Tela Menu

6.4.5 Tela Sintico

Telas e Objetos de Tela 31

32 Telas e Objetos de Tela

5. Para executar a aplicao, clique em na barra de ferramentas Padro.

6.5 Exerccios Complementares

34 Telas e Objetos de Tela

7.1 Tipos de Associao

7.1.1 Associao Simples

7.1.3 Associao Digital

7.1.4 Associao Analgica

7.1.5 Associao por Tabela

Associao por Tabela

7.1.7 Associao Mltipla