Documente Academic
Documente Profesional
Documente Cultură
Desenvolvedores
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 90.
Seu primeiro produto foi o Elipse 21, um software para a plataforma DOS, que era conhecido
por sua facilidade de operao e compatibilidade com diferentes fabricantes.
Em 1996, a Elipse lanou a primeira verso do Elipse Windows, que mais tarde se tornaria o
Elipse SCADA. Desde essa poca, foram instaladas cerca de 3.500 cpias desse software no
Brasil.
1.2 Mdulos do E3
Inicialmente, ser visto que o E3 composto de quatro mdulos, descritos a seguir.
1.2.1 E3 Server
o Servidor de Aplicaes, onde os principais processos so executados, incluindo a
comunicao em tempo real com os equipamentos de controle. O servidor tambm
responsvel por enviar dados e Telas aos clientes conectados em qualquer parte da rede
(Intranet e Internet). O Servidor pode executar vrios projetos ao mesmo tempo e conversar
com outros E3 Servers para realizar um failover (standby) ou distribuir cargas de
6 Apresenta o
processamento entre as mquinas. Foi desenvolvido para ser executado sobre os sistemas
operacionais Windows XP SP3, XP x64 SP2, Server 2003 SP2, Vista SP2, Server 2008 SP2, Server
2008 R2 SP1 e Windows 7 SP1.
1.2.2 E3 Studio
Ferramenta nica de configurao, agindo como plataforma universal de desenvolvimento,
que possui um ambiente moderno e amigvel, incluindo um completo editor grfico e de
scripts (VBScript). Permite que um projeto seja editado por vrias pessoas ao mesmo tempo
ou que vrios E3 Studios estejam conectados ao mesmo servidor remoto, com mltiplas
configuraes.
1.2.3 E3 Viewer
O Viewer permite operar as aplicaes residentes no servidor em qualquer computador com
o programa executvel Viewer (Windows XP, 2003, Vista e Windows 7) ou com um navegador
de Internet. Em ambos os casos, no necessrio instalar a aplicao na mquina cliente,
pois todos os componentes (Telas, Bibliotecas, controles ActiveX) sero baixados e
registrados automaticamente.
1.2.4 E3 Admin
o mdulo responsvel pela interface do E3 Server e de outros mdulos do E3 com o usurio.
Atravs dele o usurio pode enviar comandos ao E3 Server, utilizando o cone na rea de
Notificao da Barra de Tarefas do Windows, e controlar o Domnio pela linha de comando.
1.3 O Treinamento
A sequncia de aprendizado a ser seguida neste tutorial reflete o que a Elipse Software
considera o conjunto de melhores prticas no desenvolvimento de aplicativos de superviso
e controle, tanto para o E3 (o objeto de estudo deste Tutorial) quanto para o Elipse SCADA ou
outros softwares de superviso.
A base do roteiro desse manual uma aplicao hipottica, que apresenta os recursos mais
importantes do software Elipse E3. Essa aplicao no cobre todas as possibilidades de
desenvolvimento oferecidas pela ferramenta. No entanto, a quantidade e qualidade das
informaes apresentadas neste primeiro contato com o software so suficientes para que
voc aprenda a utiliz-lo com autonomia para criar suas prprias aplicaes.
Apresentao da ferramenta
Telas e Objetos de Tela: como criar interfaces grficas para suas aplicaes
Apresenta o 7
Uso de Bibliotecas ElipseX: poderosa ferramenta de bibliotecas funcionais disponvel
apenas no E3
Integrao com Bancos de Dados: uso de funes e ferramentas para acesso e consulta a
Bancos de Dados, com foco em processos
Sua participao muito importante para ns. Ao final do treinamento, ser solicitado que
voc avalie diversos aspectos do curso, como a qualidade e a quantidade das informaes
transmitidas em aula e pelo tutorial, alm do trabalho do instrutor e a qualidade das
instalaes. Qualquer sugesto ou crtica bem-vinda pela equipe de desenvolvimento desse
tutorial.
A Elipse Software deseja a voc um timo treinamento, e uma boa experincia de trabalho
com o Elipse E3!
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.
8 Apresenta o
Tela principal da aplicao
Menu da aplicao
Alarmes
Existir um procedimento de consulta dos alarmes, que permite visualizao e impresso dos
dados de histricos.
Apresenta o 9
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
10 Apresenta o
Domnio Remoto
Apresenta o 11
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.
Pgina inicial do KB
Favoritos: link que mostra todos os artigos da base de dados que esto assinalados como
favoritos
Busca no KB
Ainda existe a possibilidade de utilizar a Busca Avanada, que permite refinar a consulta.
Basta acessar a opo Busca Avanada.
Busca Avanada
Na opo Busca Avanada o usurio pode digitar a palavra ou palavras que deseja buscar,
filtrar por categoria especfica, autor e ainda pela classificao do artigo. Isto , se ele ajudou
muito, apenas ajudou, no ajudou ou ajudou pouco.
2.3 Categorias
Existe a possibilidade de o usurio acessar todos os artigos escolhendo diretamente a
categoria a que ele pertence. Para isto, no campo Categorias, basta selecionar a categoria em
que se deseja buscar os artigos e ento clicar no boto Ir.
Escolha de categorias
Categorias em portugus
Note que dentro de cada uma destas subcategorias aparece um nmero. Este nmero indica
a quantidade de artigos existentes dentro da categoria.
Artigos Em Destaque: Mostra todos os artigos que esto classificados para aparecerem em
destaque. Normalmente esta seo utilizada para ressaltar algum artigo que merece
uma ateno especial por parte dos usurios dos softwares da Elipse
Artigos Mais Lidos: Mostra a lista dos 10 artigos mais lidos no Knowledgebase
ltimos Artigos Adicionados: Mostra a lista dos ltimos 10 artigos que foram adicionados
na base de dados do Knowledgebase
Buscas Mais Utilizadas: Mostra as 10 palavras que mais foram utilizadas como busca pela
ferramenta de busca do Knowledgebase
3
Iniciando a Aplicao
Aps instalar o software, voc ter em sua mquina um grupo de programas chamado Elipse
E3, com um cone para acessar o E3 Studio. Quando o E3 iniciado, o sistema abre uma
caixa de dilogo com algumas opes do projeto.
OPO DESCRIO
Iniciar o E3 Studio Inicia o E3 Studio, mas no abre nenhum
Domnio.
Assistente de Aplicaes
3.1.1 Projetos
Contm definies de objetos, Tags, Telas e outros componentes de uma aplicao. Os
arquivos .prj so criados atravs das opes Aplicao Padro e Aplicao em Branco. A
primeira opo cria um projeto pr-configurado com alguns objetos bsicos e um assistente
de criao de projeto, enquanto a segunda opo cria um projeto vazio a ser implementado
pelo usurio.
3.1.2 Bibliotecas
Contm definies de objetos criados pelo usurio (ElipseX) para serem utilizados em
projetos. Essas bibliotecas podem ser reutilizadas em diferentes projetos, mas mantm
vnculos com a aplicao. Ou seja, se a biblioteca for alterada, todos os objetos dessa
biblioteca sero atualizados nos projetos automaticamente.
3.1.4 Organizer
O Organizer permite uma viso simples e organizada de toda a sua aplicao, ajudando na
edio e configurao de todos os objetos envolvidos no sistema atravs de uma rvore
hierrquica de opes. Possui dois modos de visualizao, Domnio e Explorer.
Lista de Propriedades
3.3 Exerccios
Assistente de Aplicaes
4. Na prxima janela do assistente, selecione a opo Criar um novo Domnio e use o mesmo
nome do projeto.
3.4.1 KB
KB-28984: Tempo de execuo utilizando apenas licena de Studio.
4
Servidor de Dados
OBJETO DESCRIO
Tag Contador Objeto que faz a contagem de tempo (em
segundos) at atingir um valor pr-
determinado, ou que faz uma certa
contagem indefinidamente.
NOTA: Os objetos inseridos no Servidor de Dados sero executados pelo E3 Server, portanto
estaro presentes no Servidor. Esta informao retrata o modo como o E3 trabalha.
Servidor de Dados 23
4.1 Regras para Nomes de Tags
Ao especificar o nome dos Tags, alguns detalhes devem ser levados em conta:
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
24 Servidor de Dados
Inserir Tag Demo
Servidor de Dados 25
NAME DOCSTRING MINIMUM MAXIMUM PERIOD SCAN TYPE
Temp2 Temperatu 20 80 10000 500 0 - Random
ra do
Tanque2
4.2.3 Tanques
A aplicao representa uma fbrica que utiliza como matria-prima as tintas vermelha, verde
e azul, produzindo as demais tintas como uma combinao dessas trs.
1. Na pasta Dados crie uma Pasta de Dados chamada Tanque1 e insira trs Tags Internos,
Vermelho, Verde e Azul.
26 Servidor de Dados
Pastas de Dados
Servidor de Dados 27
4.3 Anotaes
28 Servidor de Dados
CAPTULO
5
Telas e Quadros
Telas so janelas para monitoramento de processos, onde so inseridos objetos que faro a
interface do operador com o sistema. Cada aplicao pode ter um nmero ilimitado de Telas.
5.1 Tela
A Tela o objeto bsico de interface com o usurio. Nela podem-se inserir os seguintes
objetos:
As Telas utilizam como padro para o tamanho e coordenadas as unidades Himetric, dadas
em 1/100 mm, no em pixels. Neste sistema, ao se adicionar um valor positivo em x, a
coordenada x move-se para a direita. Quando se adiciona um valor positivo em y, a
coordenada y move-se para baixo, sendo a origem dada pelo canto superior esquerdo da Tela.
As Telas podem ser abertas em modo Full-Screen, ocupando toda a rea do Viewer, ou ainda
como telas modais, ocupando somente o tamanho de suas coordenadas de altura e de
largura.
Telas e Quadros 29
Exemplo de Tela
5.2 Quadros
O Quadro o objeto que organiza e estrutura a interface, criando visualizaes compostas
para o usurio dentro da janela principal do Viewer ou do navegador.
No Quadro, pode-se criar Divisores para visualizar diferentes Telas ao mesmo tempo. Cada
Divisor tambm pode mostrar uma URL, uma planilha do Excel, um documento do Word ou um
arquivo PDF.
A disposio dos Divisores dentro do Quadro pode ser horizontal ou vertical. Dentro de cada
Divisor podem ser inseridos outros Divisores. A cada par de novos Divisores criados pelas
opes Dividir Horizontalmente e Dividir Verticalmente, h sempre um Divisor Principal e um
Divisor Secundrio. Apenas o Divisor Principal ter valores que definem explicitamente o seu
posicionamento, ficando o Divisor Secundrio com o valor restante. Para utilizar esse recurso,
siga estes procedimentos:
1. Clique com o boto direito do mouse no nome do projeto em Viewers e Quadros e escolha a
opo Inserir Quadro.
2. Para criar um Divisor, clique com o boto direito do mouse sobre o Quadro aberto e
selecione o tipo de diviso (horizontal ou vertical).
30 Telas e Quadros
Selecionar o tipo de diviso
3. Arraste a barra de diviso com o mouse para a posio desejada e clique com o boto
esquerdo do mouse para fix-la.
Divises
5.3 Viewer
O objeto Viewer configura o modo como o E3 Viewer ser visualizado.
O E3 Viewer pode rodar a partir de qualquer ponto da rede que tenha acesso ao E3 Server. No
necessrio copiar o aplicativo para as mquinas onde os E3 Viewers sero executados, pois
as Telas e bitmaps so trazidos do servidor conforme a necessidade, em tempo de execuo.
Telas e Quadros 31
Na aba Visualizador da Janela de Propriedades so definidas as configuraes de visualizao
do Viewer.
Propriedades do Viewer
32 Telas e Quadros
Aba Configurao
Na aba Erros de comunicao, pode-se configurar um padro para que os Displays e Setpoints
de toda a aplicao indiquem erros de comunicao.
Telas e Quadros 33
NOTA: Tambm possvel inserir Tags no Viewer.
5.4 Exerccios
5.4.1 Quadros
1. Clique com o boto direito do mouse sobre a pasta Viewer e Quadros e escolha a opo
Inserir Quadro em - TreinamentoE3.prj.
Dividir Horizontalmente
3. Posicione a barra que aparece a cerca de 10% da Tela, a partir de seu limite superior, e
pressione o boto esquerdo do mouse para fixar a posio da barra.
Clique com o boto direito sobre o objeto no Organizer e selecione a opo Renomear
6. Divida horizontalmente o Quadro inferior a cerca de 10% da Tela, a partir do limite inferior.
Chame as Divises de Area_Central e Area_Inferior, respectivamente.
Divises do Quadro
34 Telas e Quadros
7. Configure o Divisor Area_Inferior como Principal. Isso faz com que o E3 obedea ao
tamanho do Divisor e o restante da Tela ser o tamanho do Divisor Area_Central.
Clique com o boto direito do mouse em Area_Inferior e escolha a opo Configurar
como Divisor Principal.
5.4.2 Telas
1. Clique com o boto direito do mouse sobre a pasta Telas e escolha a opo Inserir Tela em -
TreinamentoE3.prj.
Inserir Tela
2. Escolha na lista de seleo o Divisor Area_Superior. Isso faz com que a Tela seja criada
com o tamanho exato desse Divisor. Marque a opo Configurar como Tela inicial do Divisor
e no campo Nome digite "TelaMenu".
Telas e Quadros 35
Tamanho da Tela
36 Telas e Quadros
5.5 Anotaes
Telas e Quadros 37
CAPTULO
6
Objetos de Tela
Os Objetos de Tela so elementos grficos que podem ser inseridos nas Telas para criar a
interface visual com o processo. Podem ser criados a partir da barra de ferramentas Objetos
ou atravs do menu Objetos.
Uma vez selecionado o objeto que se deseja criar, mantenha o boto esquerdo do mouse
pressionado na rea da Tela, enquanto movimenta o mouse (um retngulo pontilhado mostra
o tamanho e a forma do objeto). Ao soltar o boto, o objeto ser posicionado dentro da rea
especificada.
38 Objetos de Tela
CONE OBJETO DESCRIO
caixa de rolagem.
NOTA: Outros objetos ActiveX de terceiros tambm podem ser utilizados no E3, desde que
sejam devidamente registrados. Eles podem ser adicionados atravs do menu Ferramentas -
Adicionar ActiveX.
6.2 Galeria
A Galeria uma biblioteca de smbolos vetoriais, divididos em categorias, que podem ser
arrastados para as Telas. Depois de inserido, o objeto pode ser livremente editado e
trabalhado de acordo com as caractersticas descritas para os objetos de imagem (pode-se,
por exemplo, mudar a cor de preenchimento atravs das propriedades OverrideFillMode,
OverrideFillColor e OverrideLineColor, sem a necessidade de transformar o objeto em um
objeto grfico do E3).
Objetos de Tela 39
Galeria
NOTA: Ao executar o E3 Studio em modo Demo (sem licena), apenas o primeiro elemento de
cada conjunto de categorias de smbolos estar disponvel.
6.3 Exerccios
6.3.1 Figuras
Todas as figuras utilizadas nesta aplicao sero salvas em uma pasta dentro do projeto
principal para que no seja necessrio preocupar-se com os caminhos das figuras ao executar
a aplicao em outro computador.
1. Clique com o boto direito do mouse em Recursos e escolha a opo Inserir Recurso em -
TreinamentoE3.prj.
40 Objetos de Tela
Inserir Recurso
Objetos de Tela 41
6.3.2 Tela Inicial
A Tela Inicial ter o seguinte aspecto:
Tela Inicial
1. Configure a propriedade FillStyle para 12 - bkPicture, para habilitar uma figura de fundo.
3. Crie um objeto Texto com a palavra "Entrar", e outro com a palavra "Sair".
DICA: Para editar um texto j existente na tela, clique com o boto direito do mouse em cima
do objeto e selecione Editar Texto.
42 Objetos de Tela
5. Logo abaixo do texto "Treinamento E3 Studio", insira um segundo texto com a mensagem
"Elipse Software Ltda".
6.3.3 TelaMenu
TelaMenu
3. Repita o procedimento para criar um boto para cada tela da aplicao: Eventos, Grafico,
Sinotico, Comunicao, Remoto e Playback.
4. No canto direito da tela, insira um Display para exibir o nome do usurio logado.
Formato de Hora
6.3.4 TelaAlarmes
Esta tela exibir os alarmes ativos da aplicao.
1. Configure a Tela com o fundo que desejar. Utilize o boto Estilo de preenchimento.
Objetos de Tela 43
6.3.5 TelaSinotico
TelaSinotico
1. Na TelaSinotico, coloque como figura de fundo a imagem FundoTelaSinotico.
6.3.6 Setpoint
1. Sobre os tanques de cores, insira Setpoints onde ser digitada a quantidade de cada
componente de cor.
Configurando limites
6.3.7 Galeria
Sobre a esteira insira, a partir da biblioteca de objetos grficos (Galeria), a figura
5GallonBucket, que est na pasta Tanks.
44 Objetos de Tela
6.3.8 Retngulo
1. Sobre os tanques direita, desenhe um objeto Retngulo e configure as seguintes
propriedades:
BackgroundStyle: 1 - opaque
VerticalPercentFill: 20
6.3.9 Display
1. Ao lado de cada tanque insira um Display .
6.4.1 KB
KB-36216: Inserindo objetos na Galeria do E3.
Objetos de Tela 45
6.5 Anotaes
46 Objetos de Tela
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.
Associaes
Pode-se associar um objeto ou criar uma expresso. Ao criar uma expresso ou associar um
objeto ou propriedade ao campo Fonte, o texto aparecer na cor azul, caso esse corresponda
a um item existente ou carregado no E3 Studio. Se o item no existir, ou pertencer a um
mdulo no existente no Domnio, o texto aparecer em vermelho, e esse item ser mostrado
como um erro, at ser corrigido ou excludo com a opo Verificar Domnio.
Assoc ia es 47
7.1.1 Conexo Simples
Na Conexo Simples, o valor do campo Fonte copiado para a propriedade toda vez que a
fonte for modificada.
Conexo Simples
Conexo Bidirecional
48 Assoc ia es
7.1.3 Conexo Digital
J na Conexo Digital, possvel estabelecer que, caso a varivel ou expresso do campo
Fonte seja uma propriedade digital, seus estados verdadeiro e falso sero mapeados para
certos valores no Destino, incluindo a opo de Pisca (alternncia de valores).
Conexo Digital
Conexo Analgica
Assoc ia es 49
7.1.5 Conexo por Tabela
Podem-se estabelecer condies entre a varivel, os valores e o destino. Na tabela so
especificados valores mnimos e mximos, e valores para a propriedade referente a essas
condies.
Conexo Reversa
50 Assoc ia es
7.1.7 Edio de Associaes
O E3 possui uma ferramenta para edio das associaes, chamada Edio de Associaes.
Assim, possvel mudar uma ou mais associaes feitas na aplicao de forma mais rpida
do que pela janela tradicional. O acesso a essa ferramenta pode ser feito clicando com o
boto direito do mouse sobre um ou mais objetos e selecionando a opo Editar Associaes.
Edio de Associaes
TAG VBSCRIPT
0 Falso
1 Verdadeiro
Assoc ia es 51
TAG NOT TAG VBSCRIPT
0 -1 Verdadeiro
1 -2 Verdadeiro
Portanto, NOT de 1 no Falso, pois seu valor no igual a 0. Caso deseje utilizar o comando
NOT, primeiro converta o valor do Tag para um Booleano com o mtodo CBool:
1 Verdadeiro Falso
Mtodo CBool
Outra opo seria trabalhar com a propriedade Bit00 do Tag, que j uma propriedade do
tipo Boolean, em vez de trabalhar com a propriedade Value do Tag.
Propriedade Bit00
7.3 Exerccios
1. Na TelaMenu, acesse as propriedades do Display que vai exibir o horrio do sistema, aba
Associaes.
2. Na propriedade Value, busque na coluna Fonte, com o auxlio do AppBrowser, o Tag Demo
HoraAtual (Servidor - Dados). direita, selecione a propriedade Value e clique no boto
52 Assoc ia es
Colar. A informao vai do Tag para o Display, logo a Associao Simples (Propriedade <-
Fonte).
Associao Simples
3. Substitua as palavras "Red", "Green" e "Blue" pelos Tags Vermelho, Verde e Azul,
respectivamente.
DICA: Trabalhe com Copiar (CTRL + C) e Colar (CTRL + V). Para editar uma Associao criada
anteriormente, tecle F2.
Assoc ia es 53
7.3.2 Conexo Bidirecional
1. Para cada Setpoint na TelaSinotico, crie uma Associao Bidirecional com o seu Tag
respectivo, Vermelho, Verde e Azul.
Associao Bidirecional
Conexo Analgica
10 30 Azul
30 70 Branco
70 90 Amarelo
90 100 Vermelho
1. Na propriedade ForegroundColor do Display, insira uma Associao por Tabela com o Tag
Nivel1.
54 Assoc ia es
Associao por Tabela
1. No Display j configurado com a Associao por Tabela, clique com o boto direito do
mouse e escolha a opo Copiar Associaes.
2. No Display que deseja formatar, clique com o boto direito do mouse e escolha a opo
Colar Associaes.
3. Se j existir alguma Associao nesse objeto, ser aberta uma caixa de mensagem para
escolher se deseja ignorar ou sobrescrever.
Assoc ia es 55
7.3.6 Animao
1. Selecione o objeto Galo e aperte o boto para inserir uma Animao com Translao.
Uma sombra do objeto aparecer. Mova-a at onde desejar.
O incio do movimento representa a posio 0, e o final a posio 100. Para que o movimento
acontea, precisamos de uma varivel que varie de 0 a 100, linearmente. Como usaremos
essa varivel apenas para animar um objeto de Tela, criaremos um Tag Demo (simulao) no
objeto Viewer.
2. Clique com o boto direito do mouse no Viewer e insira um Tag Demo com o nome de
Anima.
Mnimo: 0
Mximo: 100
Period: 5000
Scan: 100
4. Clique com o boto direito do mouse na Animao e acesse suas propriedades. Crie uma
Associao na propriedade Value com o Tag Anima.
56 Assoc ia es
5. Altere as propriedades Enabled e EnabledSlider da Animao para False.
Assoc ia es 57
7.4 Anotaes
58 Assoc ia es
CAPTULO
8
Comunicao
OBJETO DESCRIO
Pasta Define grupos e subdiretrios para a
organizao de variveis. No tem relao
direta com o equipamento de campo.
Comunic a o 59
8.1.1 Exerccios
8.1.1.1 Driver
1. Clique com o boto direito do mouse sobre a pasta Drivers e OPC e escolha a opo Inserir
Driver de Comunicao em - TreinamentoE3.prj.
2. Selecione o arquivo do Driver (.dll) na caixa de dilogo que se abre para a seleo de
arquivos.
5. Nos Drivers mais recentes, todas as configuraes de comunicao devem ser realizadas
nas janelas de configuraes extras do IOKit, que um componente compartilhado
utilizado pelos Drivers de Comunicao do E3.
6. Para os Drivers que utilizam o IOKit, a interface de configurao aberta atravs do boto
Configurar o Driver na barra de ferramentas do Driver.
Configurar Driver
60 Comunic a o
Janela de configurao do Driver
8. Na aba Setup, escolha na lista de opo da propriedade Physical Layer a interface fsica que
ser utilizada. As opes so Serial, Ethernet, Modem e RAS.
10.Aps a escolha da opo Physical Layer, todas as outras abas sero desabilitadas, sendo
necessrio apenas configurar a interface escolhida. A partir deste ponto, o Driver estar
configurado para acessar o meio fsico.
Comunic a o 61
Tag Browser
62 Comunic a o
Quantidade de Tags
4. Clique novamente com o boto direito do mouse no Driver e escolha o item Ativar
Comunicao para testar as configuraes ou aperte o boto Ativar/Desativar comunicao
. Caso as configuraes estejam corretas, a linha do Tag dever ficar na cor azul.
Ativar Comunicao
TelaComunicacao
Comunic a o 63
8.1.1.4 TelaComunicacao
1. Insira no projeto uma nova Tela, chamada TelaComunicacao, para ser aberta no
Divisor Area_Central. Marque a opo Tela inicial do divisor.
TelaComunicacao
OBJETO DESCRIO
Pasta OPC Definem grupos ou subdiretrios para a
organizao das variveis.
64 Comunic a o
OBJETO DESCRIO
para se poder criar Tags OPC.
8.2.1 Exerccios
O E3 funcionar como servidor OPC e tambm como cliente OPC. Assim como no exerccio
anterior, esse exerccio serve para mostrar como funciona a configurao do Driver OPC, j
que o procedimento semelhante para qualquer servidor OPC que esteja sendo utilizado. O
roteiro descrito nos passos a seguir.
1. Clique com o boto direito do mouse sobre a pasta Drivers e OPC e escolha a opo Inserir
Driver de Comunicao OPC em - TreinamentoE3.prj.
2. Clique com o boto direito do mouse sobre o Driver OPC inserido, selecione a opo
Propriedades e v at a aba OPC Driver. Clique sobre o boto Selecionar.
Selecionar servidor
3. Ser aberta uma janela com as opes de OPC Server na sua mquina local ou na rede.
Selecione o Elipse OPC Server da mquina do instrutor na opo Servidores na rede e
pressione o boto OK.
Comunic a o 65
Servidores OPC na rede
Ativar Comunicao
5. A partir deste ponto, possvel verificar a comunicao com o servidor clicando sobre a
opo Informaes.
Importar tags
66 Comunic a o
Buscar tags
Grupos OPC
Comunic a o 67
Tags importados
10.Assim como no caso da configurao de Drivers Elipse, o roteiro para trabalhar com o
servidor OPC da Elipse o mesmo para qualquer servidor que seja utilizado.
8.3.1 KB
KB-14918: Contagem de Tags no Driver de Comunicao.
68 Comunic a o
8.4 Anotaes
Comunic a o 69
CAPTULO
9
Scripts
70 Sc ripts
9.1.1 Picks
Os Picks implementam uma forma amigvel de realizar procedimentos comuns em scripts,
poupando tempo de escrita de cdigo. Entre eles esto aes como troca de Tela ou
atribuio de valores, que so bastante comuns na criao de um projeto.
Sc ripts 71
9.1.1.2 Abrir Tela
72 Sc ripts
9.1.1.4 Executar Aplicao
Sc ripts 73
9.1.1.6 Inverter Valor
Permite mudar o valor de um Tag. Se o valor do Tag for igual a Valor1, ento o Tag recebe
Valor2. Se o valor do Tag for igual a Valor2, ento o Tag recebe Valor1. Se o valor do Tag
no for igual nem a Valor1 nem a Valor2, o Tag recebe Valor1.
74 Sc ripts
9.2 Eventos
Os Eventos so ocorrncias relacionadas a um objeto, que disparam aes programadas.
Basicamente so dois tipos de eventos, Fsicos (ou externos) e Internos.
Eventos fsicos so, por exemplo, aes no teclado ou no mouse. Neste caso, a informao
relevante seria a tecla pressionada ou a posio do cursor e o status dos botes. Eventos
internos so, por exemplo, a mudana de uma temperatura de uma cmara de 10 para 11
graus Celsius.
No E3, h uma lista disponvel de eventos classificada por objetos, iniciando pelos eventos
padro, presentes em todos os objetos. Esses eventos so acessados atravs da aba Scripts,
que pode ser consultada atravs das propriedades do objeto para o qual se deseja fazer o
script.
Lista de eventos
possvel a criao de eventos personalizados definidos pelo usurio atravs da opo Criar
novo evento na lista de eventos ou atravs do boto Criar evento do usurio .
Sc ripts 75
Criar evento do usurio
9.3 Mtodos
Os Mtodos so procedimentos que podem ser executados por objetos. Por exemplo, o objeto
Tela tem um mtodo para a adio de objetos (AddItem) e outro para fech-la (Close). Por
estarem encapsulados, isto , guardados dentro dos objetos, na chamada de um mtodo
sempre deve constar a qual objeto est se referindo.
Muitos mtodos pr-definidos possuem parmetros, que podem (ou devem) ser passados na
chamada do mtodo. Para isso, o VBScript possui uma regra que deve ser seguida. Se o
mtodo for utilizado em uma atribuio, seus parmetros devem estar entre parnteses. Os
parnteses usados nas citaes de mtodos neste manual servem apenas como indicativo
para diferenci-los das propriedades. Nos scripts, deve-se seguir esta regra.
76 Sc ripts
AppBrowser
9.4 Propriedades
Todo objeto possui Propriedades, que guardam informaes a respeito de suas
caractersticas. Por exemplo, um objeto do tipo Retngulo possui a propriedade Name, que
contm seu nome e as propriedades Width e Height, que guardam a sua largura e a sua
altura, respectivamente, entre outras. Para acessar as propriedades, utilize as mesmas
especificaes anteriores, porm selecione a pasta Propriedades.
9.5 Exerccios
Sc ripts 77
3. No campo Abrir a Tela, selecione o Quadro1.
5. Na TelaMenu, crie um boto para cada Tela, e crie um script para abrir sua respectiva
Tela. A Tela TelaInicial deve abrir no Quadro _top, e as demais no Quadro
Area_Central.
Pick Script
2. Com o auxlio do AppBrowser , procure o mtodo Exit do Viewer e aperte o boto Colar.
Application.Exit
78 Sc ripts
9.6 Exerccios Complementares
9.6.1 KB
KB-25172: Teclas de atalho no E3.
Sc ripts 79
9.7 Anotaes
80 Sc ripts
CAPTULO
10Segurana
10.1 Usurios
Atravs da opo Usurios possvel configurar as informaes referentes aos usurios que
tero ou no acesso ao sistema. Para utilizar este recurso, preciso acessar o menu Arquivo -
Usurios e clicar na aba Usurios.
Aba Usurios
Seguran a 81
IMPORTANTE: Aps configurar a segurana, somente os usurios listados tero acesso ao
sistema.
10.2 Grupos
A opo Grupos permite que sejam criados grupos com caractersticas que sero comuns para
todos os seus membros (usurios). Um grupo tambm pode pertencer a outros grupos. S no
permitido pertencer a outro grupo que pertena a ele, ou seja, uma referncia circular. Para
utilizar este recurso, necessrio acessar o menu Arquivo - Usurios e selecionar a aba
Grupos.
Aba Grupos
10.3 Permisses
A aba Permisses configura as permisses dos usurios e grupos para Telas, Alarmes, Domnio
e Viewer. Uma verificao de permisso consiste em uma informao que o membro do grupo
tem sobre um comando que atua sobre um objeto especfico.
Por exemplo, o Usuario1 tem permisso para o comando Abrir sobre o objeto Tela1. Cada
membro do grupo pode negar ou afirmar a permisso de um comando, independentemente
do grupo ao qual pertence. Dessa forma, ele no vai levar em considerao a informao do
82 Seguran a
grupo. Tambm pode-se optar por sempre utilizar a informao definida pelo grupo. Se as
informaes dos grupos forem conflitantes, ser usada a seguinte ordem de preferncia:
Negar > Afirmar > Indiferente.
Aba Permisses
Seguran a 83
10.4 Proteo
O E3 possui uma ferramenta de proteo de projetos ou de bibliotecas. Atravs desse item,
possvel proteger o contedo do arquivo contra a edio, a visualizao ou a execuo no
autorizada. Para utilizar esse recurso, clique com o boto direito do mouse sobre o nome do
projeto no Organizer e selecione a opo Proteger.
Proteo de arquivo
Proteo de Execuo: Esta opo utilizada para proteger um arquivo contra execuo
no autorizada. Para tanto, necessrio solicitar a gravao de uma senha no dispositivo
de proteo, que feita pela Elipse Software. Isso protege o desenvolvedor de cpias no
autorizadas do projeto, por exemplo.
84 Seguran a
Quando um arquivo .lib ou .prj aberto no E3 Studio, este inicializa mostrando um cone cinza
com um cadeado, indicando que est protegido e esse contedo no pode ser acessado.
Para acessar o contedo do arquivo, clique no cone da direita e mude para Abrir com senha.
Aps informar a senha e o sistema liberar o acesso, o cone fica colorido , indicando a
acessibilidade dos arquivos.
10.5 Exerccios
A seguir, ser visto como configurar usurios em um Domnio no E3 e como utilizar esse
recurso para inibir ou permitir acesso a Telas, controles, alarmes, etc.
10.5.1 Usurios
1. No menu Arquivo, selecione a opo Usurios.
3. Atravs da aba Usurio, crie trs usurios. Cuidado que maisculas e minsculas fazem
diferena.
Seguran a 85
Dados do usurio
10.5.2 Permisses
1. Na aba Permisses, selecione a opo Grupos. Bloqueie uma Tela para o grupo Operador.
10.5.3 Login
1. Na TelaMenu, boto Login, crie um novo Pick do tipo Script no evento Click.
86 Seguran a
10.6 Exerccios Complementares
1. Clique com o boto direito do mouse no Viewer e insira um Tag Interno com o nome de
TagAdmin.
TagAdmin
3. Na TelaInicial, crie uma Associao na propriedade Visible do texto Entrar com o Tag
TagAdmin. Somente usurios do grupo Administrador podero visualizar esse objeto.
Seguran a 87
10.6.3 Registro de Eventos
1. Clique com o boto direito do mouse no cone do E3 na rea de Notificao do Windows e
acesse a opo Domnio - Opes.
Domnio - Opes
Aba Segurana
88 Seguran a
3. Acesse a aba Registro de Eventos e configure para registrar os eventos na tabela Eventos
em um banco de dados selecionado automaticamente.
10.6.4 KB
KB-32881: Abrindo a janela de administrao de usurio em tempo de execuo.
Seguran a 89
10.7 Anotaes
90 Seguran a
CAPTULO
11Bibliotecas ElipseX
Reutilizao de cdigo
Bibliotecas de objetos
Bibliotec as ElipseX 91
11.1 Criao de Bibliotecas do Usurio
Os objetos ElipseX podem conter, alm de um desenho, variveis internas que podem ser
exportadas para a aplicao, alm de lgicas de programao (scripts) que vo estar
presentes em todas as cpias do objeto que est sendo criado, diminuindo a necessidade de
repetio de cdigo em diversas partes do aplicativo.
Assistente de Aplicaes
3. Determine o nome da biblioteca e a pasta onde ela ser salva, e clique em Avanar.
5. Clique em Concluir.
Dentro de uma biblioteca ElipseX podem ser inseridos dois tipos de objetos, os objetos
grficos XControls e os objetos de dados XObjects.
Podem ser inseridos nos XControls todos os itens disponveis para as Telas. Entre esses itens
esto as primitivas de desenho, objetos grficos vetoriais, incluindo objetos da biblioteca de
smbolos (WMF, EMF, etc.), objetos grficos no vetoriais (BMP, JPEG, GIF, etc.), controles
ActiveX do E3 (E3Chart, E3Browser, E3Alarm), controles ActiveX de terceiros e outros
92 Bibliotec as ElipseX
XControls.
Dentro de um mesmo arquivo .lib pode existir qualquer nmero de componentes ElipseX,
sejam eles XControls ou XObjects. Pode-se ter tambm vrias bibliotecas diferentes (vrios
arquivos .lib) dentro do mesmo Domnio.
11.1.1 XControl
O XControl define uma interface grfica com o usurio, que pode ser composta de quaisquer
objetos do E3, com o propsito de ser multiplicada facilmente por seu projeto. Pode-se criar
um XControl clicando com o boto direito do mouse sobre o arquivo .lib criado em seu
Domnio (Organizer - Explorer) ou em Bibliotecas de Objetos, XControl, escolhendo a opo
Inserir - XControl.
XControl
Ao inserir um XControl, observe que na parte inferior da tela existem trs abas, Design,
Propriedades e Scripts. Na aba Propriedades, pode-se inserir propriedades a serem
exportadas pelo objeto. Elas podero ser associadas a um Tag ou outra propriedade qualquer
quando o objeto estiver sendo usado em um projeto. Na aba Design, que equivale a uma Tela,
pode-se inserir os objetos grficos descritos anteriormente.
As propriedades a serem exportadas (XProperties) podem ser inseridas atravs da tecla INS
do teclado ou atravs do boto , e excludas atravs do boto . As opes disponveis
so:
OPO DESCRIO
Nome Determina o nome da propriedade do
XControl.
Bibliotec as ElipseX 93
OPO DESCRIO
propriedade.
Note que outros objetos de Dados (XObjects) podem ser declarados como Tipo. Isso permite
que em uma nica propriedade seja controlado o funcionamento de todo um objeto,
tornando mais fcil a manuteno de uma biblioteca.
A edio do objeto grfico possui os mesmos recursos grficos e opes da edio de Telas.
Pode-se inserir os XControls em qualquer Tela, ou ainda dentro de outro XControl clicando
com o boto direito do mouse sobre a Tela ou XControl de destino e escolhendo a opo
Inserir.
A partir desse momento, o XControl ter um nome dentro da Tela, e ser entendido como uma
cpia da definio original. Assim, deve-se definir (se necessrio) os valores ou as
associaes que essa cpia especfica ter no contexto que est sendo utilizada.
11.1.2 XObject
Alm dos objetos grficos, pode-se criar uma biblioteca de dados, chamada XObject. Com ela,
pode-se definir uma estrutura de dados a ser executada no servidor. Tal estrutura poder
realizar clculos, associaes, comunicaes, verificao de alarmes, registro histrico, etc.,
que independam de alguma interface grfica (Viewer) aberta ou em execuo naquele
momento. Para criar um XObject, clique com o boto direito do mouse sobre o arquivo .lib no
Organizer e escolha a opo Inserir - XObject.
Pode-se inserir os XObjects em qualquer Servidor de Dados clicando com o boto direito do
mouse sobre o Servidor de Dados e escolhendo a opo Inserir. Mesmo que o(s) arquivo(s) de
biblioteca possua(m) vrios XControls e XObjects, ao tentar inserir uma biblioteca o E3 Studio
exibir para as Telas somente os XControls, e para os Servidores de Dados somente os
XObjects.
94 Bibliotec as ElipseX
11.2 Quando Criar um ElipseX
Existem alguns critrios para indicar a necessidade da construo de objetos no E3:
Repetio no uso: se um mesmo equipamento ou processo ser usado mais de uma vez no
mesmo projeto
NOTA: No possvel copiar uma Biblioteca e utilizar os dois arquivos (original e cpia) no
mesmo Domnio. Por exemplo, no se pode copiar um arquivo .lib para separ-lo em dois
novos arquivos.
11.3 Exerccios
Vamos desenvolver um Display para exibir o valor da temperatura. O Display ser formatado
com uma casa decimal e sufixo "C". A cor de fundo do Display varia conforme o valor da
temperatura.
11.3.1 Biblioteca
1. Clique no boto Novo Projeto e, no Assistente de Aplicaes, selecione a opo
Biblioteca de componentes do E3. Nomeie-a como BibliotecaTreinamento e
especifique a pasta C:\TreinamentoE3. Clique em Avanar, adicione-a ao Domnio corrente
e conclua o processo.
11.3.2 XControl
1. Insira um XControl e chame-o de DisplayTemp.
DisplayTemp
Bibliotec as ElipseX 95
Formato do
Display
4. Para poder receber externamente qualquer valor, precisamos criar propriedades. Altere da
aba Design para a aba Propriedades, na parte inferior da Tela.
Aba Propriedades
Propriedade Temperatura
6. Retorne aba Design. No Display, crie uma Associao Simples entre a propriedade
Temperatura e a propriedade Value.
Associao Simples
7. Para alterar a cor conforme o valor da temperatura, crie uma Associao por Tabela na
propriedade ForegroundColor, informando os limites e as cores desejadas. Na propriedade
Fonte, busque a propriedade Temperatura criada anteriormente.
8. Para que o novo objeto possa ser utilizado, preciso registr-lo. Salve as modificaes,
clique com o boto direito do mouse em Bibliotecas e escolha a opo Registrar bibliotecas
carregadas.
96 Bibliotec as ElipseX
Registrar bibliotecas carregadas
DisplayTemp
10.Para cada DisplayTemp na Tela, crie uma Associao Simples entre a propriedade
Temperatura e um Tag Temp.
11.3.3 TagBomba
1. Na biblioteca LibTreinamento, insira um novo XObject e nomeie-o TagBomba.
Propriedades de TagBomba
Bibliotec as ElipseX 97
11.3.4 Servidor de Dados
1. Crie, dentro de Dados, uma Pasta de Dados com o nome Bombas.
Objetos
TagBomba
11.3.5 Bomba
Bomba
5. Crie uma propriedade chamada Fonte, do tipo TagBomba (XObject criado anteriormente).
98 Bibliotec as ElipseX
Tipo TagBomba
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:
AppBrowser
Bibliotec as ElipseX 99
Automatico.
9. No Display abaixo da vlvula, deve aparecer o nome do XObject TagBomba associado. Crie
uma Associao entre a propriedade Value do Display e Bomba.Fonte.Name.
10.Quando a propriedade OnOff estiver em True, a cor da bomba dever ser verde, e quando a
propriedade estiver em False a cor dever ser vermelha.
Associao Digital
11.3.6 TelaSinotico
1. Na TelaSinotico, insira um objeto Bomba sobre cada bomba do desenho de fundo.
2. Associe a propriedade Fonte dos objetos Bomba da TelaSinotico aos XObjects Bomba
criados no exercicio anterior.
Propriedade Fonte
Comando
Criaremos um XControl, que ser utilizado para alterar as propriedades OnOff, Automatico e
Defeito do XObject TagBomba. Haver uma nica Tela com este objeto, que far a
configurao de todas as bombas do aplicativo.
3. Crie uma Caixa de Seleo e, na sua propriedade Caption, digite o texto "Defeito".
Associao Bidirecional
5. Copie o objeto Caixa de Seleo duas vezes. Altere a propriedade Caption dos objetos para
"Automtico" e "OnOff", respectivamente, e associe-os s propriedades correspondentes.
11.3.8 TelaComando
Insira no projeto uma nova Tela, chamada TelaComando, com o tamanho de 200 x 200
pixels.
1. No XControl Bomba, crie um script no evento Click da figura que simboliza a bomba:
'Nome completo da bomba
Arg = Bomba.Fonte.PathName
'Abrir TelaComando
Application.DoModal "TelaComando", "Comando", 0, 0, , , Arg, 1+2+64+2048
2. Digite "Arg = " para criar uma varivel auxiliar de script, que guardar o nome da bomba na
qual clicamos.
5. Busque, com o auxlio do AppBrowser, o mtodo DoModal do Viewer e aperte o boto Colar.
Application.DoModal(Screen, Title, Left, Top, Width, Height, Arg, Flags)
6. Altere o parmetro Screen para o nome da Tela que se deseja abrir, TelaComando.
7. Altere o parametro Title para "Comando". Este ser o ttulo, desde que a propriedade
Caption da Tela esteja em branco.
8. Altere os parmetros Left e Top para 0. Foraremos a Tela a abrir no centro em outro
parmetro.
9. Altere os parmetros Width e Height para um espao, assim ser usado o tamanho original
da Tela.
10.Arg a informao que ser passada para a Tela que se abrir. Esse parmetro j foi
definido como o nome completo da bomba.
11.Altere o parmetro Flags para 1+2+64+2048, que significa barra de ttulo (1), boto de
fechar (2), mvel (64) e centralizada (2048).
Existem oito combinaes possveis para trs bombas. Para transformarmos os valores
booleanos em decimal, use a seguinte expresso:
4 * Bomba1 + 2 * Bomba2 + Bomba3
Como no VBScript Verdadeiro equivale numericamente a -1, nossa expresso deve ser:
-4 * Bomba1 - 2 * Bomba2 - Bomba3
0 0 1 1 RGB(0, 0, Azul)
0 1 0 2 RGB(0, Verde, 0)
0 1 1 3 RGB(0, Verde,
Azul)
1 0 0 4 RGB(Vermelho,
0, 0)
1 0 1 5 RGB(Vermelho,
0, Azul)
1 1 0 6 RGB(Vermelho,
Verde, 0)
1 1 1 7 RGB(Vermelho,
Verde, Azul)
Propriedade ForegroundColor
11.4.2 KB
KB-28547: Utilizando biblioteca desenvolvida em outro projeto.
12Banco de Dados
1. Clique com o boto direito do mouse sobre o nome do projeto e depois em Inserir - Banco de
Dados.
2. No caso do banco de dados Access, insira o nome do arquivo desejado (existente ou no) no
campo Arquivo MDB.
12.1 Exerccios
Este banco de dados ser utilizado para armazenar todos os dados de Alarmes e Histricos
dos projetos.
1. Clique com o boto direito do mouse no item Databases e escolha a opo New Database.
12.2.1 KB
KB-29527: Bancos de dados suportados pelo E3.
13Alarmes
IMPORTANTE: Um Domnio pode ter somente um objeto desse tipo, e a sua presena
obrigatria para que haja verificao de alarmes.
13.2.1 rea
O objeto rea permite agrupar um conjunto de Fontes de Alarmes, bem como outras reas de
Alarme. Isso facilita o gerenciamento, a operao e o monitoramento de um conjunto de
Fontes de Alarmes relacionados, permitindo, por exemplo:
112 Alarmes
Reconhecer um conjunto de Fontes de Alarmes
Caso haja necessidade, novas reas podem ser inseridas dentro de outras.
PROPRIEDADE DESCRIO
Texto da Mensagem o texto associado quela condio de
alarme, que aparecer no objeto de
visualizao (E3Alarm), Banco de Dados, etc.
Pode conter at 255 caracteres de texto.
H vrios tipos de Fontes de Alarme que podem ser inseridas na rea de Alarme.
Alarmes 113
13.2.2.1 Analgico
Permite monitorar uma varivel analgica, pela especificao de at quatro nveis de alarme,
que so o LOLO (muito baixo), LO (baixo), HI (alto) e HIHI (muito alto).
13.2.2.2 Digital
Permite monitorar uma varivel (ou expresso) digital, pela especificao de alarme na borda
de subida (em -1 ou True) ou na borda de descida (em 0 ou False).
114 Alarmes
13.2.2.3 Banda Morta
Alarmes 115
13.3 E3Alarm
O E3Alarm serve para o monitoramento dos alarmes ativos ou no reconhecidos no sistema.
Atravs desse objeto, possvel verificar o estado dos alarmes no sistema, bem como
reconhec-los manualmente. Para utilizar esse objeto, clique com o boto direito do mouse
na rea de trabalho, e selecione a opo Inserir - E3Alarm.
E3Alarm
Aba Geral
116 Alarmes
13.4 Exerccios
5. Clique no boto Campos e selecione os campos que desejar. Para o correto funcionamento
com o E3PlayBack, insira os campos:
Alarmes 117
EventTimeDbl
FullAlarmSourceName
ConditionActive
Acked
AckRequired
6. Por ltimo, clique no boto Gerar Tabela. Ser exibida uma mensagem de sucesso.
118 Alarmes
13.4.3 Alarme Analgico
1. Crie dentro da Configurao de Alarmes uma nova rea de Alarmes pressionando o boto
Adicionar e modifique o seu nome para Nivel.
Adicionar rea
de Alarme
2. Selecione a rea criada e clique no boto Adicionar. Insira uma Fonte de Alarme do tipo
Analgico.
Marque o item LoLo, com limite igual a 10 e mensagem "Nvel 1 Muito Baixo"
Marque o item HiHi, com limite igual a 90 e mensagem "Nvel 1 Muito Alto"
Alarmes 119
Associao dos Alarmes com os Tags
1. Setpoint:50
2. BM: 10
120 Alarmes
Associao dos Alarmes com os Tags
2. Selecione a Configurao de Alarmes e crie uma nova rea com o nome de Bomba.
6. Para que nas mensagens de Alarme e retorno aparea o nome da bomba, crie as
Associaes vistas na prxima figura.
Alarmes Digitais
13.4.6 E3Alarm
A visualizao dos Alarmes em tempo real pode ser feita atravs do objeto E3Alarm.
Alarmes 121
Selecionar Servidor de Alarmes
Propriedade AlarmServer
122 Alarmes
13.5.1 Reconhecer Todos os Alarmes
Vamos criar um boto onde possvel reconhecer todos os alarmes ativos.
4. Substitua o parmetro Operator pelo nome do usurio logado no Viewer. Com o auxlio do
AppBrowser busque a propriedade User do Viewer.
13.5.2 KB
KB-29110: Gerando um beep no speaker do PC quando alarme for ativado.
Alarmes 123
13.6 Anotaes
124 Alarmes
CAPTULO
14Consultas
O objeto Consulta (ou Query) auxilia no processo de definio de consultas no Banco de Dados
da aplicao. Toda vez que o E3 necessita buscar dados do Banco de Dados necessrio
enviar um comando, de forma que se saiba quais os dados desejados para aquele objeto.
Para essa busca, toda vez que uma aplicao precisar gravar ou buscar dados armazenados
em um Banco de Dados, so enviados comandos no formato SQL (Structured Query Language).
A Consulta apresenta uma interface amigvel que permite a construo de consultas SQL
usando uma interface grfica e o acompanhamento imediato do cdigo SQL gerado. A
Consulta permite mostrar os dados dos ltimos n dias, horas ou meses, data inicial e final e
consultas, dependendo do filtro a ser implementado.
O Assistente de Configurao da Consulta responsvel por criar o texto que faz o filtro ou a
consulta, no sendo necessrio para o usurio saber detalhes como data, etc. Para utilizar
esse recurso, clique com o boto direito do mouse sobre a Tela do projeto e selecione a
opo Inserir - Consulta.
2. Aps ser definido o Banco de Dados, uma nova janela aparecer com as tabelas que foram
encontradas, permitindo a sua seleo.
Consultas 125
Seleo de tabelas
4. Na aba Campos, sero adicionados os campos a serem retornados pela Consulta, bem
como definidos filtros e ordenaes.
A janela anterior pode ser acessada atravs de um clique com o boto direito do mouse sobre
126 Consultas
o objeto e selecionando a opo Configurar.
Nmero: <%Nome_da_Variavel%>
String: '<%Nome_da_Variavel%>'
14.2 E3Browser
O E3Browser um controle ActiveX (desenvolvido pela Elipse Software) utilizado para
visualizar dados armazenados em Banco de Dados, gerados pelo E3 ou outro software
qualquer. Pode-se configurar Consultas utilizando filtros de vrios tipos nos dados, atribuir
cores para cada coluna, entre outras configuraes. Esse objeto utilizado para visualizar os
Histricos, Alarmes ou qualquer tabela existente no Banco de Dados.
E3Browser
Para utilizar este recurso, insira o E3Browser no projeto atravs do clique com o boto direito
do mouse na Tela, e selecione a opo Inserir - E3Browser.
Consultas 127
Inserir E3Browser
14.3 Exerccios
Vamos visualizar os dados de alarmes armazenados no Banco de Dados em forma de tabela
utilizando o objeto E3Browser.
14.3.1 TelaEventos
1. Insira no projeto uma nova Tela, chamada TelaEventos, a ser aberta no Divisor
Area_Central. Marque a opo Tela inicial do Divisor.
14.3.2 E3Browser
1. Insira um E3Browser na TelaEventos.
128 Consultas
Aba Consulta
Tabela Alarms
7. Acesse a aba Visualizar e clique no boto Executar Consulta para verificar o resultado da
Consulta.
Executar Consulta
8. Clique no boto OK. Ao finalizar esse passo, estaro disponveis no E3Browser todos os
campos listados na Consulta. Configure cada campo com a cor, formatao e tamanho que
desejar.
Consultas 129
Configurao da Consulta
2. Usaremos um mtodo do Viewer que mostra um calendrio para a escolha de uma data
pelo usurio. Crie um novo script no evento Click dos Setpoints.
'Chama a funo Calendrio
If Application.ShowDatePicker(DataHora, 0, 0) Then
'Passa a data escolhida para o SetPoint
Value = DataHora
End If
130 Consultas
5. Substitua os parmetros Left e Top por 0 ou a coordenada que desejar abrir o calendrio.
6. O parmetro DateValue deve ser substitudo por uma varivel interna de script.
Chamaremos essa varivel de DataHora.
8. Para passar a data do calendrio para o Setpoint, digite na prxima linha o texto a seguir.
Value = DataHora
11.Acesse o objeto Consulta do E3Browser. Isso pode ser feito executando um duplo-clique no
objeto pelo Organizer ou pela aba Consulta do E3Browser.
Consulta do
E3Browser
13.Para o usurio poder escolher a data inicial e a data final, precisamos criar variveis de
consulta. Configure o filtro conforme a figura a seguir.
Configurando o Filtro
Consultas 131
14.Digite um valor inicial para as variveis criadas na aba Variveis.
Variveis da Consulta
15.Acesse a aba Visualizar e clique no boto Executar Consulta para verificar o resultado da
Consulta. Certifique-se que o filtro foi aplicado e clique no boto OK.
16.Na TelaEventos, embaixo dos Setpoints, crie um boto Consultar, e insira um novo
script no evento Click com as seguintes linhas.
'Referencia os Setpoints
DataIni = Screen.Item("spDataInicial").Value
DataFim = Screen.Item("spDataFinal").Value
Set consulta = Screen.Item("E3Browser1").Item("Consulta1")
'Configura as variveis da Consulta
consulta.SetVariableValue "DataInicial", DataIni
consulta.SetVariableValue "DataFinal", DataFim
19.Repita o passo anterior para criar a varivel interna DataFim, referenciando o valor do
Setpoint spDataFinal.
DataFim = Screen.Item("spDataFinal").Value
132 Consultas
Screen.Item("E3Browser1").Item("Consulta1").SetVariableValue(VarName, Value)
22.Digite no comeo da linha o texto "set consulta = ". Desse modo criamos uma varivel
interna de script que referencia o objeto Consulta.
Set consulta = Screen.Item("E3Browser1").Item("Consulta1")
25.No parmetro Value informe o valor que deseja passar para a varivel. No caso, desejamos
passar o valor do Setpoint que referenciamos atravs da varivel interna DataIni.
consulta.SetVariableValue "DataInicial", DataIni
14.4.1 KB
KB-20214: Funo SQL para calcular valores mximo, mnimo e mdia.
Consultas 133
14.5 Anotaes
134 Consultas
CAPTULO
15Histricos
Podem-se criar tantos arquivos de Histrico quantos se desejar, cada um contendo diversos
tags ou expresses. Cada Histrico pode criar ou utilizar uma tabela independente dentro do
Banco de Dados, cujo armazenamento pode ser definido por Tempo ou por Evento. possvel
ainda determinar qual Banco de Dados inserido no projeto ser utilizado para o
armazenamento dos dados. Para utilizar esse recurso, clique com o boto direito do mouse
no nome do projeto no Explorer e selecione a opo Inserir - Histrico.
Para criar a tabela no Histrico, importante criar seus campos. Tais campos podem ser
criados atravs do boto (Adicionar um campo). Para remover algum campo indesejado,
clique no boto (Remover os campos).
Histrico
H dois tipos de chave primria, a Simples e a Composta. Uma Chave Primria Simples um
campo que identifica de modo nico cada registro de uma tabela. Uma Chave Primria
Composta pode ser formada pela combinao de dois ou mais campos da tabela. Podem
existir casos em que um nico campo no capaz de atuar como chave primria, pelo fato
deste apresentar valores repetidos. Alm disso, uma tabela pode ter somente uma chave
primria, seja ela simples ou composta. Ou seja, no se pode definir dois ou mais campos de
uma tabela para serem uma chave primria separada cada. No confundir com o caso de uma
chave primria composta, onde a unio de dois ou mais campos que forma a nica chave
Histric os 135
primria da tabela. Ao escolher campos de Chave Primria, considere os seguintes detalhes:
Caso no exista um identificador nico para uma determinada tabela, pode-se usar um
campo que numere os registros sequencialmente
A chave primria pode ser configurada de duas formas. Verificando na Tela do Histrico o
campo da tabela que se deseja tornar Chave Primria e habilitando-a atravs do boto ,
ou clicando no cone , que abrir a tela de configurao.
15.2 ndices
Um ndice um campo ou um conjunto de campos que sero previamente ordenados pelo
Banco de Dados a fim de melhorar o desempenho das consultas que utilizam esse ndice. Eles
so utilizados para encontrar rapidamente registros com um valor especfico em uma coluna.
Sem um ndice, o Banco de Dados tem de iniciar com o primeiro registro e depois ler os
registros atravs de toda a tabela at que ele encontre os registros relevantes. Quanto maior
a tabela, maior ser o custo em termos de tempo de processamento. Se a tabela possui um
ndice para as colunas em questo, o Banco de Dados pode rapidamente obter uma posio
para procurar no meio do arquivo de dados sem ter que varrer todos os registros. Os tipos de
ndices disponveis so Primrio, nico e Index.
Podem-se criar ndices em mltiplas colunas. Um ndice de mltiplas colunas pode ser
considerado um vetor ordenado contendo valores que so criados concatenando valores de
colunas indexadas.
Os ndices podem ser configurados atravs do cone , que abre a tela de configurao,
ilustrada a seguir.
Editor de ndices
136 Histric os
15.3 Exerccios
15.3.1 Histrico
1. Clique com o boto direito do mouse no item Banco de Dados e insira um novo Histrico
no projeto TreinamentoE3, nomeando-o como HistNivel.
Inserir Histrico
2. No Histrico criado, insira dois novos campos e configure-os conforme a figura a seguir.
Tabela: Nivel
Histric os 137
Tempo de gravao: 2000 ms
4. Clique sobre o boto Gerar Tabela. Deve aparecer a mensagem "A estrutura de tabelas foi
criada com sucesso".
15.4.1 KB
KB-24714: Limite de campos de um Histrico.
138 Histric os
15.5 Anotaes
Histric os 139
CAPTULO
16E3Chart
Cada sequncia de dados representada no E3Chart atravs de Penas. Para cada Pena so
associados dados, que podem ser Tags ou campos de Consultas. possvel criar vrios eixos
com escalas diferentes para serem associados aos dados das Penas.
E3Chart
Para inserir esse objeto na Tela, clique com o boto direito do mouse e selecione a opo
Inserir - E3Chart.
140 E3Chart
Propriedades da Pena
16.1.2 Histrica
O objeto Consulta tambm usado para mostrar valores histricos no E3Chart. Atravs da
aba Consultas possvel adicionar, excluir ou configurar as Consultas. Para criar uma Pena
Histrica, necessrio que a Consulta esteja previamente criada. Para tanto, na aba Dados
das propriedades da Pena, selecione a opo Histrica, disponvel no item Tipo de pena e
defina a Consulta. Logo aps, defina os campos da Consulta nos itens Campo do eixo vertical e
Campo do eixo horizontal.
E3Chart 141
16.1.3 Tempo Real e Histrica (Mista)
Para configurar uma Pena como Tempo Real e Histrica, na aba Dados das propriedades da
Pena, selecione na opo Tipo de pena o item Tempo Real & Histrica. Este tipo de Pena
utilizado quando se deseja ter os dados antigos e os valores atuais dos Tags na mesma Pena.
16.2 Exerccios
Vamos fazer um grfico com Penas de Tempo Real e Histricas com as variveis de nvel.
Atravs de um boto, vamos escolher entre o grfico exibir o eixo horizontal como tempo real
ou histrico.
16.2.1 TelaGrafico
1. Insira no projeto uma nova Tela, chamada TelaGrafico, a ser aberta no Divisor
Area_Central. Marque a opo Configurar como Tela inicial do Divisor.
16.2.2 E3Chart
1. Posicione um E3Chart na TelaGrafico.
16.2.3 Escala
Os maiores valores so do Tag Nivel, que varia de 0 a 100, portanto vamos alterar a escala
vertical para exibir os valores nessa faixa.
16.2.4 Consulta
Como desejamos visualizar os dados histricos, precisamos configurar uma Consulta.
142 E3Chart
16.2.5 Penas
1. Na aba Penas, clique no boto Adicionar.
Propriedades da Pena
4. Na aba Dados, deixe a opo Tipo de pena em Tempo Real & Histrica.
5. Na opo Link do eixo vertical, selecione a propriedade Value do Tag Nivel1 da pasta
Dados.
Dados da Pena
E3Chart 143
16.2.6 Legenda
1. Na aba Legenda, selecione a opo Mostrar legenda, tamanho 60, e adicione as colunas
que preferir.
5. Digite " = Value". Como estamos escrevendo o script na Caixa de Seleo, ao digitar "Value"
fazemos referncia ao valor do prprio objeto.
144 E3Chart
16.2.8 Eixo Horizontal Histrico
Para navegarmos pelo grfico consultando dados antigos, o eixo horizontal deve estar
configurado como Histrico.
Intervalo de tempo
4. Escolha um intervalo inicial pequeno (cinco minutos), assim a Tela ser carregada
rapidamente.
2. No Setpoint com a data inicial, crie uma Associao Bidirecional com a propriedade
HorScaleBegin do E3Chart.
Associao Bidirecional
3. No Setpoint com a data final, crie uma Associao Bidirecional com a propriedade
HorScaleEnd do E3Chart.
E3Chart 145
16.3 Exerccios Complementares
16.3.2 KB
KB-18257: Criando um grfico com pontos digitais.
146 E3Chart
16.4 Anotaes
E3Chart 147
CAPTULO
17Relatrios
O Relatrio tambm utiliza o objeto Consulta. Este objeto permite que seja especificada a
origem dos dados do Banco de Dados que sero visualizados no relatrio.
Um Relatrio contm vrias sees. Cada seo do Relatrio contm um grupo de controles
que so processados e impressos ao mesmo tempo, como uma unidade.
Sees do Relatrio
Estrutrura do Relatrio
SEO DESCRIO
Report Header Esta seo impressa no incio do Relatrio.
Utilizada para imprimir ttulos de Relatrios,
tabelas de somas, grficos ou qualquer outra
informao que necessite aparecer somente
uma vez no incio do Relatrio.
148 Relatrios
SEO DESCRIO
Report Footer Esta seo impressa no final do Relatrio.
Utilizada para imprimir uma soma de um
Relatrio, totais gerais ou qualquer outra
informao que necessite ser impressa
somente uma vez no final do Relatrio.
A barra de ferramentas Relatrio contm trs itens de configurao que permitem editar,
visualizar o Relatrio e criar scripts. Estes itens so os seguintes:
Prvia de Impresso (Preview): Atravs desta opo, possvel visualizar uma prvia da
impresso do Relatrio. Assim possvel verificar configuraes de margem, figuras, etc.
Editor de Scripts: Atravs desta opo, possvel editar scripts para o Relatrio. No
campo Object necessrio especificar o objeto onde se deseja criar o script e, no campo
Events, o evento do Relatrio em que ocorrer a ao
Relatrios 149
17.1 Objetos do Relatrio
A ferramenta Relatrio possui vrios objetos especficos que podem ser utilizados, sendo
acessados atravs da barra de ferramentas Relatrio.
Linha: Objeto bsico de reta que liga dois pontos quaisquer. Permite o desenho de
retas, atravs de dois pontos especificados na sua criao ou em polgonos
Retngulo Arredondado: Retngulo criado atravs de dois vrtices com a opo dos
cantos serem arredondados a partir de um fator de arredondamento. Ao ser inserido ou
editado, exibe um pequeno ponto prximo ao canto superior esquerdo do objeto, que
permite modificar o fator de arredondamento
Elipse: Este objeto permite o desenho de crculos e elipses, utilizando toda a largura ou
altura e definindo o centro do crculo no centro do retngulo
Figura: Este objeto permite mostrar imagens que estejam armazenadas em arquivos,
estejam elas dentro ou fora do arquivo do aplicativo
Cdigo de Barras: Permite gerar uma figura que converte uma sequncia de nmeros e
caracteres em um cdigo de barras. Este cdigo uma representao numrica ou
alfanumrica, utilizada para facilitar diferentes processos. Esse cdigo decifrado atravs
de scanners, canetas e equipamentos de leitura ptica
150 Relatrios
E3Chart: Este objeto utilizado para visualizar os dados do Relatrio em formato
grfico. Maiores informaes esto descritas no captulo sobre o E3Chart
/ Enviar para frente / Enviar para trs: Atravs destes botes, possvel enviar um
objeto para frente ou para trs de outro. Ao escolher as opes Enviar para frente ou Enviar
para trs, o objeto selecionado ser colocado na primeira ou na ltima posio na ordem
de sobreposies
NOTA: A opo Impressora do cone do E3 Server na Barra de Tarefas exibe a lista das
impressoras encontradas local ou remotamente, e permite que o usurio escolha uma para
ser usada pelo E3 Server.
17.2 Exerccios
Ser feito um Relatrio onde ser impresso o grfico da Tela e em seguida todos os dados
exibidos no grfico.
Relatrios 151
17.2.2 Imprimir
Antes de exportar o Relatrio, vamos ter a possibilidade de visualizar a impresso.
2. Crie um script no evento Click que utiliza o Pick Imprimir Relatrio. Selecione o
RelatorioGrafico e escolha Tela na opo Sada.
17.2.3 Exportar
Para o usurio escolher o nome e diretrio do arquivo que ser gerado, abriremos uma caixa
de dilogo.
5. O parmetro FileName deve ser uma varivel interna de script que armazenar o nome do
arquivo. Substitua-o por "NomeArquivo".
6. Caso no seja informada a extenso do arquivo, ser considerado como padro o que for
informado no parmetro Extension. Digite "pdf".
7. Para uma mensagem de confirmao aparecer para o usurio caso o arquivo j exista,
altere o parmetro Flags para 128.
8. As caixas de dilogo de arquivos permitem filtros para facilitar a busca por tipos de
arquivos.
Tipos de Arquivos
9. O filtro sempre um par de Strings separadas pelo caractere "|", sendo que o primeiro item
o nome que aparecer para o usurio e o segundo um identificador do Windows.
152 Relatrios
10.Substitua o parmetro Filter por "Arquivos PDF|*pdf | Todos os arquivos| *.*".
11.O arquivo s pode ser gerado se o usurio clicar em Salvar. Se o usurio cancelar a ao,
nada deve acontecer. No incio do comando ShowFilePicker, digite "If" e no final digite
"Then".
12.Para exportar o Relatrio busque, com o auxlio do AppBrowser, o item Tarefas - Carregar o
relatrio - RelatorioGrafico e direita o mtodo Export.
Set Report = Application.LoadReport("RelatorioGrafico")
Report.Export([ExportFilter], [ExportFileName])
Configurar Consulta
Relatrios 153
Configurar Filtro
1. Para cada campo escolhido na Consulta, insira novos objetos Texto na seo PageHeader e
configure-os com o nome dos campos. Estes sero os ttulos das colunas.
17.2.6 Detail
A seo Detail o corpo do Relatrio, impressa uma vez para cada registro da fonte de dados.
Para esta aplicao, sero mostrados os dados de alarmes.
1. Na seo Detail, insira um Campo de Dados para cada campo, alinhando-o com o seu
respectivo texto. Nas propriedades DataField e Text, digite exatamente o nome da coluna
configurada na Consulta.
154 Relatrios
2. Insira dois Textos, "Pgina" e "de".
3. Entre os Textos, insira um Campo de Dados e configure-o para mostrar o nmero da pgina
atual:
SummaryType: 4 - ddSMPageCount
SummaryRunning: 2 - ddSRAll
4. Aps o Texto "de", insira um Campo de Dados e configure-o para mostrar o nmero total de
pginas:
SummaryType: 4 - ddSMPageCount
SummaryRunning: 0 - None
1. Clique com o boto direito do mouse no fundo do Relatrio e escolha Insert - Report
Header/Footer. Essa opo insere uma pgina inicial e final no Relatrio.
Relatrios 155
4. Insira um segundo Campo de Dados e configure-o para exibir o nome do usurio logado no
Viewer.
Propriedade DataField
5. Insira dois objetos Texto, "Relatrio gerado" e "pelo usurio" conforme a figura a seguir.
17.2.9 Imprimir
1. Para visualizar o Relatrio em tempo de execuo, na TelaEventos copie o boto
Consultar para criar um novo boto com o texto "Imprimir".
3. Na linha que referencia o objeto Consulta, com o auxlio do AppBrowser, acesse Tarefas -
Carregar Relatrio - RelatorioAlarmes - Consulta1.
Set Report = Application.LoadReport("RelatorioGrafico")
Set consulta = Report.Item("Consulta1")
156 Relatrios
17.3 Anotaes
Relatrios 157
CAPTULO
18Frmulas
Templates: Definem o tipo de dado que poder ser armazenado em cada varivel da
frmula e suas restries. Estas restries permitem habilitar ou desabilitar a alterao
dos valores da frmula em tempo de execuo, ou ento estipular limites para a alterao
Unidades: Definem os Tags que sero associados ao template da frmula. possvel criar
vrias unidades, ou seja, vrios grupos de Tags que podero receber os valores da frmula
Conjuntos de Valores: So os valores que sero transferidos para os Tags, ou seja, para as
unidades
As Frmulas esto sempre ligadas a um Banco de Dados, pois precisam fazer com que seus
dados (Templates, Unidades e Conjuntos de Valores), configurados em algum momento,
continuem vlidos sempre que necessrio. Para trabalhar com Frmulas possvel utilizar
qualquer tipo de banco de dados, e o prprio E3 Studio ou o E3 Server cuida de criar as tabelas
e relacionamentos necessrios ao uso de Frmulas.
18.1 Exerccios
O objeto Frmula armazenar informaes sobre as cores de tintas, formadas pela
combinao de vermelho, verde e azul.
158 Frmulas
18.1.2 Frmula
Inserir Frmula
4. Na aba Templates, adicione trs novos Templates do tipo Integer: Vermelho, Verde e Azul.
Para todos os Templates, escolha a restrio absoluta de 0 a 255.
Frmulas 159
Templates
5. Na aba Unidades, selecione uma linha qualquer da coluna Unidade1 e clique no boto
Renomear . Troque o nome da Unidade para Tanque1.
7. Busque, nas duas Unidades, o caminho de cada propriedade dos objetos Tanque1 e
Tanque2 em Dados.
18.2.1 KB
KB-28508: Dados carregados de frmulas mostram valores sem casa decimal.
160 Frmulas
18.2.2 Lista de Seleo
Ao invs de utilizar o comando pronto para carregarmos os valores da frmula atravs de uma
caixa de dilogo do Viewer, possvel utilizar os mtodos do prprio objeto Frmula. Uma
lista de seleo ser preenchida com todos os Conjuntos de Valores cadastrados e ao
selecionar um deles, os valores sero carregados. Para buscar no Banco de Dados todos os
Conjuntos de Valores j cadastrados, ser preciso utilizar um objeto Consulta.
3. Selecione apenas a coluna Name e visualize a Consulta. Todas as cores cadastradas devem
aparecer.
4. Agora ser preenchida uma lista de seleo com os dados retornados pela Consulta.
Frmulas 161
7. No evento Click da Lista de Seleo, crie o seguinte script:
Application.GetObject("Formula").LoadFormulaValuesQuiet "Tanque1", Value
162 Frmulas
18.3 Anotaes
Frmulas 163
CAPTULO
19Storage
Existe todo um conjunto de funcionalidades especficas para este mdulo, como consultas
pr-construdas e algoritmos de compactao de dados, entre outros. Atravs desta
ferramenta possvel recuperar com grande exatido todas as mudanas nas variveis de
processo, ocupando assim o mnimo de espao no banco de dados.
O uso do Storage fortemente recomendado para processos onde o objetivo do registro seja
o acompanhamento de tendncias que necessitem manter informaes essenciais ao
processo. Atravs de um algoritmo matemtico bastante difundido, o Storage pode fornecer
informaes relevantes de um determinado processo ocupando menos espao em disco do
que os dados gravados por um Histrico gravado periodicamente.
Em processos onde os dados devem ser precisos, como medies usadas para faturamento
de insumos (gua, energia ou gs), ou processos onde os dados devem ser integralizados em
um perodo, o uso de Histricos convencionais o recomendado.
19.1 Funcionamento
A gravao no Storage feita da seguinte maneira:
Os dados s no sero gravados se a variao ocorreu num tempo menor do que o mnimo
programado
Conforme forem sendo obtidos novos valores para as variveis, um algoritmo de verificao
de gravao vai interpretando a sequncia e decidindo se cada ponto ser ou no
armazenado.
Esta verificao, entretanto, s ocorre para os campos analgicos. Para os campos de texto e
digitais, basta que haja uma mudana qualquer de valor ou de qualidade para que sejam
gravados.
164 Storage
<NomeTabela>_Fields
<NomeTabela>
<NomeTabela>_Text
<NomeTabela>_Bit
<NomeTabela>_Backup
<NomeTabela>_Text_Backup
<NomeTabela>_Dig_Backup
19.2 Configurao
Quando o Storage criado na Tela, mostrada uma lista de definies dos campos de
gravao.
Storage
Para efeitos de posterior consulta nos dados, toda a busca se dar atravs do caminho do Tag
ou da propriedade que est sendo armazenada (campo Fonte). A propriedade Nome s ser
utilizada caso o campo Fonte contenha uma expresso. Logo, se expresses no estiverem
sendo utilizadas no campo Fonte, no h necessidade de se importar com o nome.
Storage 165
19.3 Consultas Internas
A ferramenta Query prev algumas facilidades para realizar consultas nos dados do Storage.
Ao configurar a consulta, ao invs de exibir as tabelas, h uma rvore com todas as variveis
armazenadas.
Configurao da Consulta
O usurio pode escolher uma entre sete funes descritas a seguir para consolidao dos
dados.
19.3.1 LastValue
Retorna o ltimo valor armazenado na Base de Dados.
19.3.2 ArchivedValue
Retorna um valor armazenado em relao a um determinado instante de tempo definido na
varivel TimeStamp. O tipo de relao pode ser:
166 Storage
Interpolated: valor calculado a partir do valor anterior e posterior
ExactTime: valor armazenado no exato instante que foi fornecido pelo timestamp
19.3.3 TagAttribute
Retorna um atributo do Tag, que pode ser:
19.3.4 CompressedDataNValues
Retorna, para um nico Tag, n valores armazenados a partir de um instante inicial.
19.3.5 CompressedDataStartEndTime
Retorna, para um nico Tag, os valores armazenados entre um intervalo inicial e um intervalo
final.
19.3.6 SampledData
Retorna, para um ou mais Tags, os valores interpolados (estimados) a intervalos fixos entre os
instantes definidos pelas variveis StartTime e EndTime.
Storage 167
19.3.7 CalculatedData
Retorna o resultado de operaes matemticas aplicadas aos dados entre os instantes
definidos pelas variveis StartTime e EndTime, a intervalos fixos. Os tipos de clculos
so Total, Mnimo, Mximo, Desvio Padro, Amplitude, Mdia e Mediana.
19.4 Exerccios
Vamos criar dois Storages que sero utilizados nos captulos seguintes. O Storage com os
dados de temperatura ser visualizado graficamente e o Storage com os dados das bombas
ser utilizado pelo PlayBack.
19.4.1 Temperatura
1. Insira um objeto Storage no projeto. Altere o nome para StorageTemp.
Inserir Storage
Tabela: Temperatura
168 Storage
4. Clique sobre o boto Gerar Tabela. Deve aparecer a mensagem da figura a seguir.
19.4.2 DadosBomba
1. No XObject DadosBomba insira um Storage. Chame de StorageBomba.
Inserir Storage
Campos do Storage
Storage 169
3. Clique sobre o boto Propriedades e configure as seguintes opes:
Tabela: Bombas
NOTA: Quando o Storage est inserido em um XObject, a estrutura da tabela ser gerada
quando a aplicao for executada.
19.5.1 KB
KB-31955: Storage funcionando apenas com hardkey de Studio.
170 Storage
19.6 Anotaes
Storage 171
CAPTULO
20E3Playback
O E3Playback busca no banco de dados os tags referenciados nas telas e mostra valores,
animaes, estados e grficos de acordo com as informaes existentes no banco de dados,
no perodo de playback definido.
NOTA: Em modo Demo (ou com uma licena de Studio) o perodo permitido para playback se
resume s ltimas seis horas de dados armazenados no banco.
Linha de Tempo
Lista de Eventos
Lista de Tags
A Lista de Tags pode ajudar tambm a determinar quais Tags necessitam ser gravados no
banco de dados para permitir o playback completo de uma Tela, bastando verificar os Tags
com o sinal de proibido.
O E3Playback trata os novos Quadros criados pelo aplicativo como novas abas no topo da
rea de Telas. O ttulo da aba o nome do Quadro ou Tela que foi aberto
As Associaes feitas entre objetos do Viewer (por exemplo, um Display mostrando o valor
de um Tag Demo interno ao Viewer) funcionam normalmente, sem nenhuma interferncia
do playback
20.2.2 Alarmes
Habilite ou configure o registro de alarmes em disco
FullAlarmSourceName
ConditionActive
Acked
AckRequired
20.2.3 Histricos
O formato de arquivo Histrico no o ideal para playback, pois normalmente muitos dados
duplicados esto armazenados. recomendado o uso do Storage sempre que possvel. Seguir
ao mximo as seguintes recomendaes:
Utilizar tabelas com poucos campos e, se possvel, adicionar um ndice individual para
cada campo (principalmente para os campos com poucas variaes)
20.3 Licenciamento
A Elipse fornece dois pacotes para o E3 Playback:
Playback Bsico
A licena de Studio do E3 inclui uma licena de Playback Avanado sem limite de pontos,
porm limitada s ltimas seis horas de dados armazenados no Banco de Dados. Em modo
Demo (quando no h dispositivo de proteo) o playback tambm funciona no modo
Avanado sem limite de pontos, porm limitado a mostrar apenas as ltimas seis horas de
dados armazenados no Banco de Dados.
20.4 Exerccios
20.4.1 TelaPlayBack
1. Insira no projeto uma nova Tela chamada TelaPlayBack, a ser aberta no Divisor _top.
20.4.2 Configurao
1. Na TelaPlayBack, insira o objeto E3PlayBack ocupando toda a Tela.
Propriedades do E3Playback
3. Execute a aplicao.
2. Uma linha com o intervalo de dados existentes aparecer na Linha do Tempo e a Janela de
Eventos ser preenchida.
Linha de Tempo
21Hot-Standby
Ao iniciar a execuo do E3 que est configurado para o sistema Hot-Standby, ser mostrado
na rea de Notificao nos servidores um cone representado por uma barra amarela
circulante , indicando que os Domnios esto sendo carregados. Aps alguns segundos, o
E3 reconhece o servidor principal e indica a ao com um cone representado por uma seta
verde . Este cone determina que o servidor est em execuo. O servidor Standby vai
permanecer com o cone representado por duas barras amarelas , indicando que ele est
em modo de espera (standby).
21.1.1 Arquivos
Os arquivos do Domnio devem estar na mesma localizao no servidor principal e no servidor
de backup. Por exemplo, se no computador principal o Domnio e os demais arquivos (.lib, .prj,
etc.) estiverem no caminho C:\Projeto1, no servidor Standby o projeto dever ser copiado
para este mesmo caminho, ou seja, C:\Projeto1.
21.1.2 Servidores
Os servidores (principal e backup) devem estar listados na aba Servidores das opes do
Domnio.
Hot-Standby 179
Menu Domnio - Opes
2. Os servidores podem ter o nome que se desejar no campo Nome do servidor. No campo
Identificao do servidor na rede informe o nome do computador na rede. Por exemplo,
Nome do servidor como Servidor1 e Identificao do servidor na rede como \
\servidor1.
Aba Servidores
180 Hot-Standby
21.1.3 Opes de Configurao
Na aba Opes, o item Habilitar deve estar marcado e nos campos Servidor principal e Servidor
de backup selecionados um dos servidores cadastrados previamente na aba Servidores.
Aba Opes
Hot-Standby 181
21.1.5 Falha Local
Falhas locais so detectadas e reportadas pelo prprio aplicativo atravs do mtodo
Application.ReportFailure. possvel habilitar a troca automtica de servidores quando uma
falha local reportada no servidor principal. A troca de servidores s feita se o servidor de
backup estiver sem falhas.
Ambas as aplicaes acessam uma mesma base de dados na rede. O servidor Hot ir
gravar os dados nesse Banco de Dados
21.1.7 Retentive
A propriedade Retentive determina se o valor deve ser armazenado no caso de troca do
servidor ativo. Assim, quando o servidor Standby for executado, o valor ser o mesmo do
servidor Hot que parou. Se esta propriedade estiver em False, o valor ser ajustado para o
valor inicial sempre que o Domnio for executado ou ocorrer troca do servidor ativo.
21.2 Exerccios
21.2.1 Retentive
Para exemplificar a diferena, vamos transformar os Tags de cor do Tanque1 (vermelho,
verde e azul) em retentivos e os Tags do Tanque2 em no-retentivos.
1. Selecione todos os Tags internos da pasta Tanque1 (vermelho, verde e azul) e altere a
propriedade Retentive para True.
182 Hot-Standby
21.2.2 Falha Local
1. Na pasta Dados, insira um Tag Interno chamado FalhaLocal.
3. No Tag FalhaLocal, crie um evento de usurio chamado Falha que s ocorre quando o
valor do Tag verdadeiro.
7. Para o Tag retornar para o estado normal, digite na ultima linha a expresso "Value =
False".
Value = False
Hot-Standby 183
Pick Carregar Valor
2. No servidor Standby, abra a aplicao no E3 Studio e configure o Banco de Dados para o SQL
Server local.
2. Na aba Servidores, adicione dois servidores informando o nome que desejar e o nome do
computador na rede.
3. Na aba Opes, habilite o Hot-Standby e escolha um servidor como principal e outro como
backup.
184 Hot-Standby
21.3 Exerccios Complementares
21.3.1 KB
Hot-Standby: Dvidas Mais Frequentes (FAQ).
Hot-Standby 185
21.4 Anotaes
186 Hot-Standby
CAPTULO
22Domnios Remotos
Outra possibilidade manter uma cpia do Domnio Remoto na mquina cliente, e colocar o
caminho da cpia no campo Arquivo de Domnio. Dessa forma, o E3 Studio vai utilizar a cpia
local para determinar quais objetos existem, permitindo o trabalho offline.
1. Se a mquina utiliza Windows 2000, 2003 ou Vista, acesse o painel de controle Ferramentas
Administrativas (Administrative Tools) - Diretiva de Segurana Local (Local Security Policy).
2. Na janela seguinte, acesse Diretivas Locais (Local Policies) - Opes de Segurana (Security
Options).
Opes de Segurana
Se a mquina do Domnio Servidor utiliza Windows XP, a configurao deve ser feita
diretamente no Registro do Windows. Nesse caso, siga esses procedimentos.
A configurao atravs do Registro do Windows tambm pode ser feita em Windows 2000,
2003 e Vista. Segundo a Microsoft, a chave RestrictNullSessAccess especifica se o
servidor vai limitar o acesso ao sistema por usurios logados sem autenticao de nome de
usurio e senha. Os valores possveis so:
Em qualquer um desses casos, ser necessrio reiniciar a mquina para que as alteraes
tenham efeito. Alm disso, necessrio configurar o compartilhamento e o NTFS para
aceitarem o acesso do usurio annimo (ANONYMOUS LOGON/LOGON ANNIMO) ou do
usurio de rede (NETWORK/REDE). Isso feito da seguinte maneira.
1. Selecione a pasta que contm o Domnio Servidor, e que dever estar compartilhada.
2. Clique com o boto direito do mouse sobre ela e selecione a opo Propriedades.
4. Adicione o usurio REDE ou o usurio LOGON ANNIMO, permitindo acesso para leitura
pasta e clicando aps no boto OK.
22.3 Licenas
Tanto o E3 Server rodando o Domnio Cliente quanto o que roda o Domnio Servidor devem ter
licenas especficas para Domnios Remotos. Quando essa licena existe, o E3 Server Servidor
passa a aceitar um nmero ilimitado de conexes externas de outros Domnios. Da mesma
forma, no caso do E3 Server Cliente, ser possvel estabelecer um nmero ilimitado de
conexes.
Essa ferramenta permite a criao de um Domnio Remoto na aplicao local que aponte para
si mesmo, ou seja, aponte para o prprio Domnio e para a prpria mquina.
Alias local
Assim, os links de todos os objetos de Tela ficam direcionados para os Tags e objetos de dados
da aplicao local, porm via Domnio Remoto.
22.7 Exerccios
22.7.1 TelaRemota
1. Insira no projeto uma nova Tela chamada TelaRemota, a ser aberta no Divisor
Area_Central. Marque a Tela para ser a Tela inicial do divisor.
Configurao do Domnio
Arquivo de Domnio: caminho do arquivo do Domnio Remoto. Este caminho deve ser
um compartilhamento na rede que permita acessar esse arquivo ou uma cpia local
6. Crie um Display ou Setpoint para cada Tag que desejar e associe-os atravs do caminho de
Domnio Remoto.
TelaRemoto
23Exerccios de Reviso
23.1 Exerccio
Uma mineradora deseja monitorar os nveis de alguns tanques. O equipamento ainda no
est decidido, mas deve trazer a informao de quatro nveis.
O gerente do setor gostaria de visualizar os dados de forma amigvel ao usurio, por isso
pediu que fosse desenvolvido um supervisrio com os seguintes requisitos:
Imagem da minerao
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
70 90 Amarelo
30 70 Branco
10 30 Azul
0 10 Verde
ALARME LIMITE
HiHi 90
Hi 70
Lo 30
LoLo 10
Grfico de nveis
Um relatrio com os dados de nvel armazenados no banco de dados deve ser exportado
para PDF
1. Para simular valores, criar Tags do tipo Demo, com os limites mximo e mnimo
conforme especificado.
Exibir o valor do Nivel na Tela formatada com sua unidade de engenharia igual a "%", uma
casa decimal e obedecendo a tabela de cores
5. Desenhe um Display.
7. Crie uma Associao Simples com a propriedade Nivel criada na propriedade Value do
Display.
9. Salve e registre-a.
Em uma segunda tela, deve ser possvel visualizar os quatro nveis em um grfico onde
possvel escolher atravs de botes qual a informao exibir simultaneamente
6. Na aba Dados, manter a Pena como Tempo Real e buscar o Tag no campo Link do eixo
vertical.
3. Crie campos para cada informao que deseja armazenar e associe-os ao Tag
desejado na coluna Fonte.
4. Escolha os campos que deseja buscar e na aba Visualizar, aperte o boto para
verificar os dados.
Um relatrio com os dados de nvel armazenados no banco de dados deve ser exportado
para PDF
5. Utilizar o objeto Label para escrever o ttulo das colunas (propriedade Caption).
Filial SP Filial PR
Rua dos Pinheiros, 870 - Conj. 141/142 Av. Sete de Setembro, 4698/1705
05422-001 So Paulo - SP 80240-000 Curitiba - PR
Fone: (11) 3061-2828 Fone: (41) 3342-0120
Fax: (11) 3061-2828 Fax: (41) 3342-0120
E-mail: elipse-sp@elipse.com.br E-mail: elipse-pr@elipse.com.br
Filial RJ USA
Praia de Botafogo, 300/525 40190 Jarvis Gray Lane
22250-044 Rio de Janeiro - RJ Avon - NC - USA 27915
Fone: (21) 2158-1015 Fone: +1 (252) 995-6885
Fax: (21) 2158-1099 Fax: +1 (252) 995-5686
E-mail: elipse-rj@elipse.com.br E-mail: info@elipse-software.com
Alemanha Taiwan
D-67714 Waldfischbach Deutschland 26F.-10, No.3, Zihciang 3rd Rd., Lingya District
Fone: +49 (0) 6333-4439 802 Kaohsiung City Taiwan
Fax: +49 (0) 6333-2790045 Fone: +886 (7) 566-6587
E-mail: elipse@elipse.de Fax: +886 (7) 566-6582
E-mail: evan@elipse.com.br
w w w .elipse.c om.br
elipse@elipse.c om.br